{"id":16923340,"url":"https://github.com/sanichkotikov/solid-i18n","last_synced_at":"2025-03-22T11:30:59.376Z","repository":{"id":57365864,"uuid":"418479873","full_name":"SanichKotikov/solid-i18n","owner":"SanichKotikov","description":"Tiny internationalization library for SolidJS.","archived":false,"fork":false,"pushed_at":"2023-08-17T06:14:24.000Z","size":340,"stargazers_count":37,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T21:40:27.762Z","etag":null,"topics":["npm-module","npm-package","solid-js"],"latest_commit_sha":null,"homepage":"https://sanichkotikov.github.io/solid-i18n-example/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SanichKotikov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://money.yandex.ru/to/410013821917728/","https://www.paypal.me/cdrpro/"]}},"created_at":"2021-10-18T11:57:20.000Z","updated_at":"2025-02-03T12:49:51.000Z","dependencies_parsed_at":"2024-10-28T13:17:11.427Z","dependency_job_id":"ba565034-fdc2-4747-9c09-dcd1bd1b18c2","html_url":"https://github.com/SanichKotikov/solid-i18n","commit_stats":{"total_commits":11,"total_committers":1,"mean_commits":11.0,"dds":0.0,"last_synced_commit":"10cb2191e45efeb45c72f687c640845f282fefd8"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SanichKotikov%2Fsolid-i18n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SanichKotikov%2Fsolid-i18n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SanichKotikov%2Fsolid-i18n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SanichKotikov%2Fsolid-i18n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SanichKotikov","download_url":"https://codeload.github.com/SanichKotikov/solid-i18n/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244951219,"owners_count":20537338,"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":["npm-module","npm-package","solid-js"],"created_at":"2024-10-13T19:58:46.561Z","updated_at":"2025-03-22T11:30:59.073Z","avatar_url":"https://github.com/SanichKotikov.png","language":"TypeScript","funding_links":["https://money.yandex.ru/to/410013821917728/","https://www.paypal.me/cdrpro/"],"categories":[],"sub_categories":[],"readme":"# solid-i18n\n\nTiny internationalization library for SolidJS.\n\nThere is no goal to cover every possible cases. The library supports only basic functionality:\n\n- String formatting with variables and markup\n- Number formatting, including strings with plurals\n- Date formatting\n- Customization of number and date formatting presets (including defaults)\n\n## Usage\n\nThis library uses Intl APIs (`NumberFormat`, `DateTimeFormat` and `PluralRules`), so you have to\nuse [polyfills](https://formatjs.io/docs/polyfills) for some outdated browsers.\n\n```bash\nnpm i solid-i18n\n```\n\n### Displaying Messages\n\n```typescript jsx\nimport { createI18n, I18nProvider, Text } from 'solid-i18n';\n\nconst i18n = createI18n({ language: 'en' });\n\nfunction App() {\n  return (\n    \u003cI18nProvider i18n={i18n}\u003e\n      \u003cText\n        message=\"Read the \u003clink\u003edocumentation\u003c/link\u003e for more info.\"\n        link={(text) =\u003e \u003ca href=\"https://github.com/SanichKotikov/solid-i18n\"\u003e{text}\u003c/a\u003e}\n      /\u003e\n    \u003c/I18nProvider\u003e\n  )\n}\n```\n\n### Plural Formatting\n\n```typescript jsx\n\u003cText\n  message=\"{count, plural, =0 {No items} one {One item} other {{count} items}}.\"\n  count={19999}\n/\u003e\n```\n\n### Date Formatting\n\n```typescript jsx\n\u003cText\n  message=\"Last login {datetime}\"\n  datetime={new Date()}\n/\u003e\n\n\u003cDateTime\n  date={new Date()}\n  day=\"numeric\"\n  month=\"long\"\n  weekday=\"long\"\n  year=\"numeric\"\n/\u003e\n```\n\nNote: use `{datetime, date}` for number or string values.\n\n### Number Formatting\n\n```typescript jsx\n\u003cNumeric\n  value={9.99}\n  numberStyle=\"currency\"\n  currency=\"EUR\"\n/\u003e\n```\n\n### useI18n\n\n```typescript jsx\nimport { useI18n } from 'solid-i18n';\n\nfunction SomeComp() {\n  const i18n = useI18n();\n\n  return (\n    \u003cdiv\u003e\n      \u003ch1\u003e{i18n.t('Page title')}\u003c/h1\u003e\n      \u003cdiv\u003e{i18n.formatNumber(99999.9, { minimumFractionDigits: 2, maximumFractionDigits: 2 })}\u003c/div\u003e\n      \u003cdiv\u003e{i18n.formatDateTime(new Date(), { day: '2-digit', month: 'short' })}\u003c/div\u003e\n    \u003c/div\u003e\n  );\n}\n```\n\n### Define Messages\n\n```typescript jsx\nimport { useI18n, defineMessages } from 'solid-i18n';\n\nconst messages = defineMessages({\n  title: { message: 'Page title' },\n});\n\nfunction SomeComp() {\n  const i18n = useI18n();\n  return \u003ch1\u003e{i18n.t(messages.title)}\u003c/h1\u003e;\n}\n```\n\n### Using Presets\n\n```typescript jsx\nimport { createI18n, I18nProvider, Text } from 'solid-i18n';\n\nconst i18n = createI18n({\n  language: 'en',\n  presets: {\n    number: {\n      default: { minimumFractionDigits: 0, maximumFractionDigits: 0 },\n      fraction: { minimumFractionDigits: 2, maximumFractionDigits: 2 },\n    },\n    dateTime: {\n      default: { day: 'numeric', month: 'short', year: 'numeric' },\n      full: { day: 'numeric', month: 'long', year: 'numeric' },\n      simple: { day: 'numeric', month: 'short' },\n    },\n  },\n});\n\nfunction App() {\n  return (\n    \u003cI18nProvider i18n={i18n}\u003e\n      \u003cText\n        message=\"Some value: {count, number, fraction}\"\n        count={999}\n      /\u003e\n    \u003c/I18nProvider\u003e\n  )\n}\n```\n\n```typescript jsx\n\u003cdiv\u003e{i18n.formatNumber(9999, 'fraction')}\u003c/div\u003e\n\u003cDateTime date={new Date()} preset=\"simple\" /\u003e\n```\n\n## Extracting messages\n\nUse [react-i18n-mini-parser](https://www.npmjs.com/package/react-i18n-mini-parser) for extracting default messages.\n\n## Contributing\n\nPlease read [this documentation](https://github.com/SanichKotikov/contributing) before contributing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanichkotikov%2Fsolid-i18n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanichkotikov%2Fsolid-i18n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanichkotikov%2Fsolid-i18n/lists"}