{"id":15010493,"url":"https://github.com/nodejs/full-icu-npm","last_synced_at":"2025-05-14T19:09:23.836Z","repository":{"id":42447861,"uuid":"43978545","full_name":"nodejs/full-icu-npm","owner":"nodejs","description":"convenience loader for 'small-icu' node builds","archived":false,"fork":false,"pushed_at":"2024-12-21T09:33:46.000Z","size":109,"stargazers_count":155,"open_issues_count":9,"forks_count":28,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-04-26T09:48:38.877Z","etag":null,"topics":["icu","nodejs"],"latest_commit_sha":null,"homepage":"https://nodejs.org/api/intl.html#intl_providing_icu_data_at_runtime","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nodejs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-10-09T20:27:24.000Z","updated_at":"2025-04-02T08:11:32.000Z","dependencies_parsed_at":"2024-04-12T11:21:12.135Z","dependency_job_id":"0d3ada65-38b7-4041-8414-f0db56381aaa","html_url":"https://github.com/nodejs/full-icu-npm","commit_stats":{"total_commits":80,"total_committers":17,"mean_commits":4.705882352941177,"dds":0.5375,"last_synced_commit":"37c484885c93edd74dafb4daa47882402850887a"},"previous_names":["icu-project/full-icu-npm"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodejs%2Ffull-icu-npm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodejs%2Ffull-icu-npm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodejs%2Ffull-icu-npm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodejs%2Ffull-icu-npm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nodejs","download_url":"https://codeload.github.com/nodejs/full-icu-npm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251527325,"owners_count":21603613,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["icu","nodejs"],"created_at":"2024-09-24T19:34:30.296Z","updated_at":"2025-05-14T19:09:22.745Z","avatar_url":"https://github.com/nodejs.png","language":"JavaScript","readme":"# full-icu\n\nInstall full ICU (Internationalization) data from GitHub or npm for Node.js.\n\n### What is this and why would I use it?\n\nImporting this package does not have any useful effect, see below.\n\nOriginally, Node.js did not come with information for all of the world’s languages.\nThe default build mode was “small-icu” which means English-only, saving about 50% of\nthe total Node.js download footprint.\n\nSince Node.js 13, full ICU data has been the default for Node.js.\nSo this module is only helpful for older Node.js versions, or custom\nbuilds which specify small-icu.\n\nThis module does not add any internationalization capabilities to Node.js,\nbut it can provide a convenient way of loading the data.\n\nPlease see [“providing ICU data at runtime”](https://nodejs.org/api/intl.html#providing-icu-data-at-runtime) in the Node.js docs for more information.\n\n### Am I using `small-icu`?\n\nLet's find out:\n\n```shell\n$ node -p 'process.config.variables.icu_small'\ntrue\n```\n\nIf you see `false` here, you aren't using small ICU and **this package won’t do\nanything useful for you,** although it is harmless.\n\n### To use\n\nFirst, you must have a Node.js that is configured for `small-icu`.\nSee above.\n\n`npm install full-icu`\n\nNote: Set env var `FULL_ICU_PREFER_NPM=true` to prefer using the `icu4c-data` npm module,\notherwise the default is now to load from ICU4C’s GitHub release.\n\n### To install globally\n\n`npm install -g full-icu`\n\n### After Installation\n\nInstructions will be printed out on how to activate this data for your version of node.\n\nThis work gets done in a `postinstall` script which copies the `icudt*.dat` file up to this module's level.\n\n## API\n\nNote that this is only packaging and build metadata.\nFor Internationalization API, see [Intl](https://nodejs.org/api/intl.html).\n\n`require('full-icu')` returns a few properties:\n\n* `nodever` - the full Node version (ex: `14.2.0`)\n\n* `node_maj` - the major part of the node version (ex: `14`)\n\n* `node_min` - the minor part of the node version (ex `2`)\n\n* `icu_small` - if truthy, means that node was built with\n**small-icu** (English only). If falsy, means that the `full-icu`\npackage is not relevant.\n\n* `icuver` - the full ICU version, if available, such as 55.1. Sometimes only the major version is available.\n\n* `icumaj` - ICU major ver, such as `55`. May be === `icuver`.\n\n* `icumin` - ICU minor version, such as `1` if available.\n\n* `icuend` - ICU endianness - *l*ittle, *b*ig or *e*bcdic.\n\n* `icupkg` - the `npm` package needed to get full ICU data, if any.\n\n* `icudat` - the raw data file ICU expects to find for full data, if any.\n\n* `noi18n` - if truthy, no ICU / Intl build was enabled for your node version. Sorry.\n\n* `oldNode` - The node version is older than this package can really think about.\n\n## BIN\n\n`node-full-icu-path` will print the full `icudt*.dat` path, if available.\n\n## CONTRIBUTING\n\nPlease see our [`CONTRIBUTING`](./CONTRIBUTING.md) guide if you'd like to help with this initiative!\n\n## LICENSE\n\nThis repository is subject to the terms under the [Node.js license](https://github.com/nodejs/node/blob/HEAD/LICENSE). Some usage of this data is governed by the [Unicode Terms of Use](http://www.unicode.org/copyright.html), which is included in the [unicode-license.txt](./unicode-license.txt)\n\n## COPYRIGHT\n\nCopyright \u0026copy; 1991-2021 Unicode, Inc. and Node.js contributors. All rights reserved.\n\n[Unicode terms of use](http://www.unicode.org/copyright.html)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnodejs%2Ffull-icu-npm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnodejs%2Ffull-icu-npm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnodejs%2Ffull-icu-npm/lists"}