[ { "path": ".all-contributorsrc", "content": "{\n \"projectName\": \"react-i18next\",\n \"projectOwner\": \"i18next\",\n \"repoType\": \"github\",\n \"repoHost\": \"https://github.com\",\n \"files\": [\"README.md\"],\n \"imageSize\": 100,\n \"commit\": false,\n \"contributors\": [\n {\n \"login\": \"jamuhl\",\n \"name\": \"Jan Mühlemann\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/977772?v=4\",\n \"profile\": \"http://twitter.com/jamuhl\",\n \"contributions\": [\"code\", \"example\", \"doc\", \"question\"]\n },\n {\n \"login\": \"adrai\",\n \"name\": \"Adriano Raiano\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1086194?v=4\",\n \"profile\": \"http://twitter.com/#!/adrirai\",\n \"contributions\": [\"code\", \"example\", \"doc\", \"question\"]\n },\n {\n \"login\": \"tigerabrodi\",\n \"name\": \"Tiger Abrodi\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/49603590?v=4\",\n \"profile\": \"https://tigerabrodi.dev/\",\n \"contributions\": [\"question\", \"code\", \"review\"]\n },\n {\n \"login\": \"pedrodurek\",\n \"name\": \"Pedro Durek\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/12190482?v=4\",\n \"profile\": \"https://github.com/pedrodurek\",\n \"contributions\": [\"code\", \"example\"]\n }\n ],\n \"commitConvention\": \"none\"\n}\n" }, { "path": ".babelrc", "content": "{\n \"env\": {\n \"development\": {\n \"presets\": [\n [\n \"@babel/env\",\n {\n \"targets\": { \"browsers\": [\"defaults\"] }\n }\n ],\n \"@babel/react\"\n ],\n \"plugins\": [\"@babel/plugin-transform-runtime\"]\n },\n \"jsnext\": {\n \"presets\": [\n [\n \"@babel/env\",\n {\n \"targets\": { \"browsers\": [\"defaults\"] },\n \"modules\": false,\n \"useBuiltIns\": false\n }\n ],\n \"@babel/react\"\n ],\n \"plugins\": [\"@babel/plugin-transform-runtime\"]\n }\n },\n \"comments\": false\n}\n" }, { "path": ".codeclimate.yml", "content": "engines:\n duplication:\n enabled: true\n config:\n languages:\n - ruby\n - javascript:\n mass_threshold: 58\n - python\n - php\n eslint:\n # Disabled since this engine used a different set of version of\n # `@typescript/eslint` and `typescript`\n #\n # @see https://github.com/i18next/i18next/pull/2098\n enabled: false\n channel: 'eslint-8'\n fixme:\n enabled: true\nratings:\n paths:\n - 'src/**/*'\nexclude_paths:\n - test/\n - coverage/\n - dist/\n - example/\n - 'react-i18next.js'\n - 'react-i18next.min.js'\n - 'rollup.config.js'\n - 'src/shallowEqual.js'\n" }, { "path": ".coveralls.yml", "content": "repo_token: a7NPPsDW6jNJ3x23jBgWuO6KxV3Eq0mF2\n" }, { "path": ".editorconfig", "content": "# EditorConfig is awesome: http://EditorConfig.org\nroot = true\n\n[*]\ncharset = utf-8\nend_of_line = lf\nindent_size = 2\nindent_style = space\ninsert_final_newline = true\ntrim_trailing_whitespace = true\n" }, { "path": ".eslintignore", "content": "**/dist/\n**/node_modules/\nexample/**/*\n**/react-i18next.js\n**/react-i18next.min.js\n" }, { "path": ".eslintrc.json", "content": "{\n \"extends\": [\"airbnb\", \"prettier\"],\n \"parser\": \"@babel/eslint-parser\",\n \"parserOptions\": {\n \"ecmaVersion\": 8,\n \"ecmaFeatures\": {\n \"experimentalObjectRestSpread\": true,\n \"impliedStrict\": true,\n \"classes\": true\n }\n },\n \"env\": {\n \"browser\": true,\n \"node\": true\n },\n \"reportUnusedDisableDirectives\": true,\n \"rules\": {\n \"no-debugger\": 0,\n \"no-alert\": 0,\n \"no-unused-vars\": [1, { \"argsIgnorePattern\": \"res|next|^err\" }],\n \"prefer-arrow-callback\": [\"error\", { \"allowNamedFunctions\": true }],\n \"prefer-const\": [\"error\", { \"destructuring\": \"all\" }],\n \"arrow-body-style\": [2, \"as-needed\"],\n \"no-unused-expressions\": [2, { \"allowTaggedTemplates\": true }],\n \"no-param-reassign\": [2, { \"props\": false }],\n \"no-console\": 0,\n \"no-use-before-define\": 0,\n \"no-nested-ternary\": 0,\n \"import/prefer-default-export\": 0,\n \"import/no-extraneous-dependencies\": 1,\n \"import/no-named-as-default-member\": 1,\n \"import\": 0,\n \"func-names\": 0,\n \"space-before-function-paren\": 0,\n \"comma-dangle\": 0,\n \"max-len\": 0,\n \"import/extensions\": 0,\n \"no-underscore-dangle\": 0,\n \"consistent-return\": 0,\n \"react/display-name\": 1,\n \"react/no-array-index-key\": 0,\n \"react/jsx-no-useless-fragment\": [\"error\", { \"allowExpressions\": true }],\n \"react/react-in-jsx-scope\": 0,\n \"react/prefer-stateless-function\": 0,\n \"react/forbid-prop-types\": 0,\n \"react/no-unescaped-entities\": 0,\n \"react/prop-types\": 0,\n \"jsx-a11y/accessible-emoji\": 0,\n \"react/jsx-filename-extension\": [1, { \"extensions\": [\".js\", \".jsx\"] }],\n \"react/no-unknown-property\": [\"error\", { \"ignore\": [\"i18nIsDynamicList\"] }],\n \"radix\": 0,\n \"no-shadow\": [\n 2,\n { \"hoist\": \"all\", \"allow\": [\"resolve\", \"reject\", \"done\", \"next\", \"err\", \"error\"] }\n ],\n \"quotes\": [2, \"single\", { \"avoidEscape\": true, \"allowTemplateLiterals\": true }],\n \"jsx-a11y/href-no-hash\": \"off\",\n \"jsx-a11y/anchor-is-valid\": [\"warn\", { \"aspects\": [\"invalidHref\"] }],\n \"react/jsx-props-no-spreading\": 0\n },\n \"overrides\": [\n {\n \"files\": [\"test/*\"],\n \"extends\": [\"plugin:testing-library/react\", \"plugin:jest-dom/recommended\"],\n \"globals\": {\n \"globalThis\": false\n },\n \"rules\": {\n \"testing-library/no-node-access\": [\"error\", { \"allowContainerFirstChild\": true }],\n \"testing-library/no-manual-cleanup\": \"off\"\n }\n }\n ]\n}\n" }, { "path": ".github/stale.yml", "content": "# Number of days of inactivity before an issue becomes stale\ndaysUntilStale: 7\n# Number of days of inactivity before a stale issue is closed\ndaysUntilClose: 7\n# Issues with these labels will never be considered stale\nexemptLabels:\n - 'discussion'\n - 'feature request'\n - 'bug'\n - 'breaking change'\n - 'doc'\n - 'issue'\n - 'help wanted'\n - 'good first issue'\n - 'pr hold'\n# Label to use when marking an issue as stale\nstaleLabel: stale\n# Comment to post when marking an issue as stale. Set to `false` to disable\nmarkComment: >\n This issue has been automatically marked as stale because it has not had\n recent activity. It will be closed if no further activity occurs. Thank you\n for your contributions.\n# Comment to post when closing a stale issue. Set to `false` to disable\ncloseComment: false\n" }, { "path": ".github/workflows/CI.yml", "content": "name: CI\n\non:\n push:\n branches:\n - master\n pull_request:\n # types: [opened, synchronize, reopened, ready_for_review]\n branches:\n - '**'\n\njobs:\n codeQuality:\n name: Check code quality (lint and format)\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n\n - name: Setup Node.js\n uses: actions/setup-node@v4\n with:\n node-version: 20\n cache: 'npm'\n\n - name: Install dependencies\n run: npm install\n\n - name: Format check\n run: npm run format\n\n - name: Lint\n run: npm run lint\n\n build:\n name: Build\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n\n - name: Setup Node.js\n uses: actions/setup-node@v4\n with:\n node-version: 20\n cache: 'npm'\n\n - name: Install dependencies\n run: npm install\n\n - name: Build\n run: npm run build\n\n test:\n name: Test on node ${{ matrix.node }} and ${{ matrix.os }}\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n node: ['22.x', '20.x', '18.x']\n os: [ubuntu-latest]\n # Collect coverage only for node 20 and ubuntu-latest, no need to run it twice\n # @see https://docs.github.com/en/actions/using-jobs/using-a-matrix-for-your-jobs#expanding-or-adding-matrix-configurations\n include:\n - collectCoverage: true\n node: '20.x'\n os: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n\n - name: Setup Node.js\n uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node }}\n cache: 'npm'\n\n - name: Install dependencies\n run: npm install\n\n - name: Test\n if: ${{ !matrix.collectCoverage }}\n run: npm test\n\n - name: Test with coverage\n if: ${{ matrix.collectCoverage }}\n run: npm run test:coverage\n\n - name: Coveralls\n if: ${{ matrix.collectCoverage }}\n uses: coverallsapp/github-action@v2\n\n testTypescript:\n name: Test typescript\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n\n - name: Setup Node.js\n uses: actions/setup-node@v4\n with:\n node-version: 20\n cache: 'npm'\n\n - name: Install dependencies\n run: npm install\n\n - name: Test\n run: npm run test:typescript\n" }, { "path": ".gitignore", "content": "# Ignore specific files\n.settings.xml\n.monitor\n.DS_Store\n*.orig\nnpm-debug.log\nnpm-debug.log.*\n*.dat\n.idea\n.vscode\n.eslintcache\n\n# Ignore various temporary files\n*~\n*.swp\n\n\n# Ignore various Node.js related directories and files\nnode_modules\nnode_modules/**/*\ncoverage/**/*\nexample/build/**/*\ndist/**/*\n.next\nyarn.lock\nout\n\n# ignore packaged releases\n*.tgz\n\n# vitest temp / cache files\ntsconfig.vitest-temp.json\n" }, { "path": ".husky/pre-commit", "content": "npm exec lint-staged\n" }, { "path": ".npmignore", "content": "test/\ncoverage/\nexample/\nbin/\n.babelrc\n.editorconfig\n.eslintignore\n.eslintrc\n.gitignore\nbower.json\n.github\n.circleci\n.vscode\nrollup.config.js\nrollup.config.mjs\n.all-contributorsrc\n.codeclimate.yml\n.coveralls.yml\ntsconfig*.json\n.prettierrc.json\nvitest.config.mts\nvitest.workspace.mts" }, { "path": ".prettierignore", "content": "**/dist/\n**/react-i18next.js\n**/react-i18next.min.js\n**/example/\n" }, { "path": ".prettierrc.json", "content": "{\n \"$schema\": \"https://json.schemastore.org/prettierrc.json\",\n \"bracketSpacing\": true,\n \"bracketSameLine\": false,\n \"printWidth\": 100,\n \"semi\": true,\n \"singleQuote\": true,\n \"trailingComma\": \"all\"\n}\n" }, { "path": "CHANGELOG.md", "content": "### 16.5.8\n\n- A selector function cannot be resolved without an i18n instance... returning empty string is safer than leaking the raw function reference. [1907](https://github.com/i18next/react-i18next/issues/1907)\n\n### 16.5.7\n\n- fix: `` component with `enableSelector: true` does not support multiple selectors for fallbacks [1907](https://github.com/i18next/react-i18next/issues/1907)\n\n### 16.5.6\n\n- fix: prevent crash in `useSSR` when `init()` hasn't been called before `useSSR` — now logs a warning instead of throwing [1604](https://github.com/i18next/react-i18next/discussions/1604)\n\n### 16.5.5\n\n- fix: prevent crash in `useSSR`, `getInitialProps` and `Translation` when no i18next instance is available (e.g. in monorepo setups with duplicate `react-i18next` copies) — now logs a clear warning instead of throwing [1604](https://github.com/i18next/react-i18next/discussions/1604)\n\n### 16.5.4\n\n- fix: Overriding React component props not working [1902](https://github.com/i18next/react-i18next/pull/1902)\n\n### 16.5.3\n\n- fix: Trans named tags with underscore [1901](https://github.com/i18next/react-i18next/pull/1901)\n\n### 16.5.2\n\n- fix: Type errors when you've declared a resources type [1899](https://github.com/i18next/react-i18next/issues/1899) via [1900](https://github.com/i18next/react-i18next/pull/1900)\n\n### 16.5.1\n\n- fix: export `nodesToString` (runtime + TypeScript typings) to support `i18next-cli` ([i18next/i18next-cli#155](https://github.com/i18next/i18next-cli/pull/155))\n\n### 16.5.0\n\n- Add configuration option `transDefaultProps` to set default props for the Trans component (e.g. `tOptions`, `shouldUnescape`, `values`) [1895](https://github.com/i18next/react-i18next/issues/1895)\n\n### 16.4.1\n\n- fix(Trans): prevent double-escaping of interpolated values in component props (e.g. title). Unescape HTML entities before passing prop values to React to avoid rendered output like `&quot;` / `&#39;`. [1893](https://github.com/i18next/react-i18next/issues/1893)\n\n### 16.4.0\n\n- `` prop: optional - infer count from children [1891](https://github.com/i18next/react-i18next/issues/1891)\n\n### 16.3.5\n\n- fix runaway effect in useTranslation [1888](https://github.com/i18next/react-i18next/issues/1888) by [1889](https://github.com/i18next/react-i18next/pull/1889)\n\n### 16.3.4\n\n- Fix: avoid the \"ref is not a prop\" warning when a user ref is placed on an element inside `` [1887](https://github.com/i18next/react-i18next/issues/1887), by still trying to fix element.ref access issue with react 19 [1846](https://github.com/i18next/react-i18next/pull/1846)\n\n### 16.3.3\n\n- improve useTranslation to fix \"Maximum update depth exceeded\" but still support new react-compiler [1885](https://github.com/i18next/react-i18next/issues/1885) [1863](https://github.com/i18next/react-i18next/issues/1863#issuecomment-3491246391)\n\n### 16.3.2\n\n- fix: avoid \"Uncaught TypeError: Cannot redefine property: \\_\\_original\"\n\n### 16.3.1\n\n- revert fix: Incosistent behaviour of Trans and t. Trans set defaultValue when t call doesn't set the field. [1876](https://github.com/i18next/react-i18next/issues/1876) [f22d478](https://github.com/i18next/react-i18next/commit/f22d4787187e6cfc54d57f5fbede1c816ea19565)\n\n### 16.3.0\n\n- fix: add i18n wrapper for React Compiler and React.memo compatibility [1884](https://github.com/i18next/react-i18next/pull/1884)\n\n### 16.2.4\n\n- try to fix \"Trans component do not render anymore children as default value in test environment\" [1883](https://github.com/i18next/react-i18next/issues/1883) by also respecting [1876](https://github.com/i18next/react-i18next/issues/1876)\n\n### 16.2.3\n\n- fix hyphened component break issue [1882](https://github.com/i18next/react-i18next/pull/1882)\n\n### 16.2.2\n\n- fix trans component break with less than sign [1880](https://github.com/i18next/react-i18next/pull/1880), closes [1734](https://github.com/i18next/react-i18next/issues/1734)\n\n### 16.2.1\n\n- fix regression in v16.2.0: bindI18nStore does not work correctly [1879](https://github.com/i18next/react-i18next/issues/1879)\n\n### 16.2.0\n\n- try to address: useTranslation hook violates React's rules of hooks by conditionally calling inner hooks [1863](https://github.com/i18next/react-i18next/issues/1863)\n\n### 16.1.6\n\n- fix: fix: handle spread props for inner components in Trans (icu) [1877](https://github.com/i18next/react-i18next/pull/1877)\n\n### 16.1.5\n\n- fix: Incosistent behaviour of Trans and t. Trans set defaultValue when t call doesn't set the field. [1876](https://github.com/i18next/react-i18next/issues/1876)\n- Trans: use also defaultValue via tOptions as fallback\n\n### 16.1.4\n\n- fix: detect pre-transformation use of interpolation like number/date/etc. [1875](https://github.com/i18next/react-i18next/pull/1875)\n\n### 16.1.3\n\n- fix: ensure invalid identifiers are quoted in the props object [1874](https://github.com/i18next/react-i18next/pull/1874)\n\n### 16.1.2\n\n- missing.js extensions for Icu imports\n\n### 16.1.1\n\n- exports for `IcuTrans` component [1873](https://github.com/i18next/react-i18next/pull/1873)\n\n### 16.1.0\n\n- Introduce `IcuTrans` component [1869](https://github.com/i18next/react-i18next/issues/1869)\n\n### 16.0.1\n\n- fix: Using component with named tags throws error when Selector API is enabled [1867](https://github.com/i18next/react-i18next/issues/1867) with [1868](https://github.com/i18next/react-i18next/pull/1868)\n\n### 16.0.0\n\n- major upgrade i18next dep to address [1865](https://github.com/i18next/react-i18next/issues/1865)\n\n### 15.7.4\n\n- downgrade i18next dep to address [1865](https://github.com/i18next/react-i18next/issues/1865)\n\n### 15.7.3\n\n- exports TransSelectorProps [1862](https://github.com/i18next/react-i18next/pull/1862) to address [1861](https://github.com/i18next/react-i18next/issues/1861)\n\n### 15.7.2\n\n- update i18next dependency\n\n### 15.7.1\n\n- Fix: \\_EnableSelector type (for compatibility, enableSelector does not exist in TypeOptions) [1858](https://github.com/i18next/react-i18next/pull/1858)\n\n### 15.7.0\n\n- add new selector API to improve TypeScript IDE performance [1852](https://github.com/i18next/react-i18next/pull/1852)\n - read more about it [here](https://github.com/i18next/i18next/blob/master/CHANGELOG.md#2540)\n\n### 15.6.1\n\navoid exception when passing bindI18n: false [1856](https://github.com/i18next/react-i18next/pull/1856)\n\n### 15.6.0\n\nfix: passing components as object should still allow for indexed matching of children [1854](https://github.com/i18next/react-i18next/pull/1854)\n\n### 15.5.3\n\nchore: update `@babel/runtime` [1851](https://github.com/i18next/react-i18next/pull/1851)\n\n### 15.5.2\n\nfix element.ref access issue with react 19 [1846](https://github.com/i18next/react-i18next/pull/1846)\n\n### 15.5.1\n\nadd typescript as optional peer dependency [1843](https://github.com/i18next/react-i18next/pull/1843)\n\n### 15.5.0\n\nfeat: use const type parameters for useTranslation() [1842](https://github.com/i18next/react-i18next/pull/1842)\n\n### 15.4.1\n\nfix: unique key warning on componentized element [1835](https://github.com/i18next/react-i18next/pull/1835)\n\n### 15.4.0\n\nfeat: add meta with codes on warnings to allow conditional logging [1826](https://github.com/i18next/react-i18next/pull/1826)\n\n### 15.3.0\n\nUses the i18next logger instead of the default console logger, if there is a valid i18next instance. Now the debug i18next option is respected, and you can also inject your own logger module: https://www.i18next.com/misc/creating-own-plugins#logger\n\n### 15.2.0\n\nThis version may be breaking if you still use React < v18 with TypeScript.\nFor JS users this version is equal to v15.1.4\n\n- fix: Global JSX namespace is deprecated [1823](https://github.com/i18next/react-i18next/issues/1823) with [1822](https://github.com/i18next/react-i18next/pull/1822)\n\n### 15.1.4\n\n- Fix: warning each child should have a unique key [1820](https://github.com/i18next/react-i18next/pull/1820)\n\n### 15.1.3\n\n- fix: Self-closing REACT components in translation strings should not attempt to replace the component's children [1815](https://github.com/i18next/react-i18next/issues/1815) [1816](https://github.com/i18next/react-i18next/pull/1816)\n\n### 15.1.2\n\n- fix: Attempted to assign to readonly property [1813](https://github.com/i18next/react-i18next/pull/1813)\n\n### 15.1.1\n\n- fix: Not all namespaces are loaded when passing the lng option to useTranslate [1809](https://github.com/i18next/react-i18next/issues/1809)\n\n### 15.1.0\n\n- fix: `` warns 'Each child in a list should have a unique \"key\" prop.' for react 19 [1806](https://github.com/i18next/react-i18next/pull/1806)\n\n### 15.0.3\n\n- try to fix [unexpected token issue](https://github.com/i18next/next-i18next/issues/2302)\n\n### 15.0.2\n\n- try to fix Trans handling with alwaysFormat set to true [1801](https://github.com/i18next/react-i18next/issues/1801)\n\n### 15.0.1\n\n- revert arrow function in class property to address [this](https://github.com/i18next/react-i18next/commit/46e8ea5ff69325b73087811a2ce6a2b1faffa971#r145061161)\n\n### 15.0.0\n\n- use optional chaining, nullish coalescing and nullish coalescing assignment [1774](https://github.com/i18next/react-i18next/pull/1774)\n- Build config and optimizations [1769](https://github.com/i18next/react-i18next/pull/1769)\n- some dependency updates [1768](https://github.com/i18next/react-i18next/pull/1768)\n- use modern hasLoadedNamespace code (now requires at least i18next > v19.4.5 (introduced in june 2020))\n\n### 14.1.3\n\n- create a isObject helper function [1766](https://github.com/i18next/react-i18next/pull/1766)\n- optimize nodesToString [1765](https://github.com/i18next/react-i18next/pull/1765)\n- Simplifies hasValidReactChildren [1764](https://github.com/i18next/react-i18next/pull/1764)\n- create a isString helper to avoid code duplication [1763](https://github.com/i18next/react-i18next/pull/1763)\n- use arrow functions where possible [1762](https://github.com/i18next/react-i18next/pull/1762)\n- use the commented out async code [1761](https://github.com/i18next/react-i18next/pull/1761)\n\n### 14.1.2\n\n- bring back internal interpolationOverride handling for Trans component (if there are childrens), fixes [1754](https://github.com/i18next/react-i18next/issues/1754)\n\n### 14.1.1\n\n- do not modify passed tOptions context property to address [1745](https://github.com/i18next/react-i18next/issues/1745)\n\n### 14.1.0\n\n- types(`Trans`): add typechecking on context prop [1732](https://github.com/i18next/react-i18next/pull/1732) (might break if using \"internal\" `Trans` or `TransProps`)\n\n### 14.0.8\n\n- fix: issue [1728](https://github.com/i18next/react-i18next/issues/1728) when useSuspense is false and default ns [1731](https://github.com/i18next/react-i18next/pull/1731)\n\n### 14.0.7\n\n- try to get rid of internal interpolationOverride handling for Trans component, fixes [1729](https://github.com/i18next/react-i18next/issues/1729)\n\n### 14.0.6\n\n- align context handling of Trans component with t function, fixes [1729](https://github.com/i18next/react-i18next/issues/1729)\n\n### 14.0.5\n\n- Fix [1691](https://github.com/i18next/react-i18next/issues/1691) for strict mode, by preserving change language binding [1720](https://github.com/i18next/react-i18next/pull/1720)\n\n### 14.0.4\n\n- fix interpolation of the count prop [1719](https://github.com/i18next/react-i18next/issues/1719)\n\n### 14.0.3\n\n- revert changes done in v14.0.2 since it breaks normal language change render updates\n\n### 14.0.2\n\n- Fix/bug [1691](https://github.com/i18next/react-i18next/issues/1691) make returned t function identical upon second effect run in strict mode [1716](https://github.com/i18next/react-i18next/pull/1716)\n\n### 14.0.1\n\n- types: fix typo in `CustomInstanceExtensions` [1713](https://github.com/i18next/react-i18next/pull/1713)\n\n### 14.0.0\n\n- types: reportNamespaces is now optional, should fix [1693](https://github.com/i18next/react-i18next/issues/1693)\n\n### 13.5.0\n\n- self-closing components in translation strings should not attempt to replace the component's children [1695](https://github.com/i18next/react-i18next/issues/1695)\n\n### 13.4.1\n\n- types: use CustomInstanceExtenstions to extend reportNamespaces\n\n### 13.4.0\n\n- fix: separate cjs and mjs typings\n\n### 13.3.2\n\n- types: fix consider importing '\\*.js'\n\n### 13.3.1\n\n- optimize defaultVariables feature introduced in last release\n\n### 13.3.0\n\n- Respect defaultVariables in the interpolation options [1685](https://github.com/i18next/react-i18next/issues/1685)\n\n### 13.2.2\n\n- Fix missing TransWithoutContext type [1672](https://github.com/i18next/react-i18next/pull/1672)\n\n### 13.2.1\n\n- types: Allow iterable ReactI18NextChildren as children [1669](https://github.com/i18next/react-i18next/pull/1669)\n\n### 13.2.0\n\n- Don't use defaults prop as default key [1664](https://github.com/i18next/react-i18next/pull/1664)\n\n### 13.1.2\n\n- postpone usage of newer ES syntax\n\n### 13.1.1\n\n- Render all children regardless of type when using i18nIsDynamicList prop [1661](https://github.com/i18next/react-i18next/pull/1661)\n\n### 13.1.0\n\n- Fix non-list dynamic content in Trans component [1660](https://github.com/i18next/react-i18next/pull/1660)\n\n### 13.0.3\n\n- fix unescape is not consistently called for all values [1657](https://github.com/i18next/react-i18next/issues/1657)\n\n### 13.0.2\n\n- export icu.macro [1652](https://github.com/i18next/react-i18next/issues/1652)\n\n### 13.0.1\n\n- types: Fix performance issue in Trans component [1646](https://github.com/i18next/react-i18next/pull/1646)\n\n### 13.0.0\n\n- Update types to support t function redesign [1615](https://github.com/i18next/react-i18next/pull/1615)\n- requires i18next >= v23.0.1\n\n### 12.3.1\n\n- optimization for optional lng prop for useTranslation, should now prevent missings when lazy loading translations [1637](https://github.com/i18next/react-i18next/issues/1637)\n\n### 12.3.0\n\n- optional lng prop for useTranslation (helping on server side [1637](https://github.com/i18next/react-i18next/issues/1637))\n\n### 12.2.2\n\n- try to fix conditional exports in package.json\n\n### 12.2.1\n\n- type fix: the type of defaultNS in I18nextProvider should support string[] [1633](https://github.com/i18next/react-i18next/pull/1633)\n\n### 12.2.0\n\n- if defaultValue is passed in not ready t functio (via useTranslation) return that instead of the key, even though the user-land could should be fixed [1618](https://github.com/i18next/react-i18next/issues/1618)\n\n### 12.1.5\n\n- fix react merged types [1606](https://github.com/i18next/react-i18next/pull/1606) originally introduced with #1531 to address #1506\n\n### 12.1.4\n\n- fix crash in gatsby [1594](https://github.com/i18next/react-i18next/issues/1594)\n\n### 12.1.3\n\n- fix fallback of t function in Trans component\n\n### 12.1.2\n\n- fix crash in gatsby [1594](https://github.com/i18next/react-i18next/issues/1594)\n\n### 12.1.1\n\n- fix for node resolution [1589](https://github.com/i18next/react-i18next/issues/1589)\n\n### 12.1.0\n\n- context-less version of Trans component to be used for environments without react context [1588](https://github.com/i18next/react-i18next/pull/1588)\n\n### 12.0.0\n\n- Update t function types to rely on types coming from i18next [1501](https://github.com/i18next/react-i18next/pull/1501)\n\n### 11.18.6\n\n- types: nsMode [1554](https://github.com/i18next/react-i18next/issues/1554)\n\n### 11.18.5\n\n- support unescaping forward slash [1548](https://github.com/i18next/react-i18next/pull/1548)\n\n### 11.18.4\n\n- fix: reset t when keyPrefix is updated [1544](https://github.com/i18next/react-i18next/pull/1544)\n\n### 11.18.3\n\n- types: bindI18n option for UseTranslationOptions\n\n### 11.18.2\n\n- more html entities to unescape by default [1538](https://github.com/i18next/react-i18next/pull/1538)\n\n### 11.18.1\n\n- types: allow iterable with objects as children [1531](https://github.com/i18next/react-i18next/pull/1531)\n\n### 11.18.0\n\n- ability to add custom unescape function [1529](https://github.com/i18next/react-i18next/pull/1529)\n\n### 11.17.4\n\n- fix: UMD build [1527](https://github.com/i18next/react-i18next/issues/1527)\n\n### 11.17.3\n\n- style: explicit React imports [1525](https://github.com/i18next/react-i18next/pull/1525)\n\n### 11.17.2\n\n- reset t if ns changes in useTranslation [1518](https://github.com/i18next/react-i18next/pull/1518)\n\n### 11.17.1\n\n- Stricter typescript type for Trans components prop [1516](https://github.com/i18next/react-i18next/pull/1516)\n\n### 11.17.0\n\n- Add support for keyPrefix in withTranslation [1512](https://github.com/i18next/react-i18next/pull/1512)\n\n### 11.16.11\n\n- types: fix Translation component types regression [1511](https://github.com/i18next/react-i18next/pull/1511)\n\n### 11.16.10\n\n- types: translation component types [1509](https://github.com/i18next/react-i18next/pull/1509)\n\n### 11.16.9\n\n- types: fix missing generic type for HTMLAttributes [1499](https://github.com/i18next/react-i18next/pull/1499)\n\n### 11.16.8\n\n- types: fix Trans component to support react 18 types, by introducing allowObjectInHTMLChildren TS option [1492](https://github.com/i18next/react-i18next/pull/1492)\n\n### 11.16.7\n\n- types: Added objects explicitly to Trans children [1486](https://github.com/i18next/react-i18next/pull/1486)\n\n### 11.16.6\n\n- fix: warn just once 'i18n.languages were undefined or empty' and return true, like before\n\n### 11.16.5\n\n- types: ReactNode should be prefixed with React [1481](https://github.com/i18next/react-i18next/pull/1481)\n\n### 11.16.4\n\n- fix type 'TFunctionResult' is not assignable to type 'ReactNode' on React 18 [1480](https://github.com/i18next/react-i18next/pull/1480)\n\n### 11.16.3\n\n- types: children fix for React v18 [1478](https://github.com/i18next/react-i18next/pull/1478)\n- fix: apply [same fix](https://github.com/i18next/i18next/commit/0dcf7fdede9d58e16f82179b41b09f10eda5aeea) for local hasLoadedNamespace function\n\n### 11.16.2\n\n- update macro to wrap defaults in brackets when necessary [1472](https://github.com/i18next/react-i18next/pull/1472)\n\n### 11.16.1\n\n- types: for context prop of Trans component\n\n### 11.16.0\n\n- fix: transSupportBasicHtmlNodes for keepArray check [1470](https://github.com/i18next/react-i18next/pull/1470)\n- feat: add context prop to Trans component [1464](https://github.com/i18next/react-i18next/issues/1464)\n\n### 11.15.7\n\n- types: add nsSeparator to CustomTypeOptions [1471](https://github.com/i18next/react-i18next/pull/1471)\n\n### 11.15.6\n\n- fix error for typescript 4.6 [1453](https://github.com/i18next/react-i18next/pull/1463)\n\n### 11.15.5\n\n- types: fix never return type when using plurals [1453](https://github.com/i18next/react-i18next/pull/1453)\n\n### 11.15.4\n\n- types: add values field to Plural component in macros [1446](https://github.com/i18next/react-i18next/pull/1446)\n\n### 11.15.3\n\n- types: fix for issue introduced with type extension for react-native [1436](https://github.com/i18next/react-i18next/pull/1436)\n\n### 11.15.2\n\n- types: TypeScript interface for the Trans component does now accept react-native props [1418](https://github.com/i18next/react-i18next/pull/1418)\n\n### 11.15.1\n\n- add missing types for shouldUnescape and useTranslation [1429](https://github.com/i18next/react-i18next/pull/1429)\n\n### 11.15.0\n\n- option to unescape html in Trans [1426](https://github.com/i18next/react-i18next/pull/1426)\n\n### 11.14.3\n\n- types: remove undefined from conditional type [1410](https://github.com/i18next/react-i18next/pull/1410)\n\n### 11.14.2\n\n- Add type-safe support to deep keyPrefix [1403](https://github.com/i18next/react-i18next/pull/1403)\n\n### 11.14.1\n\n- Rollback [1402](https://github.com/i18next/react-i18next/pull/1402): Remove generics from Trans component to suppress warning issue [1400](https://github.com/i18next/react-i18next/pull/1400)\n\n### 11.14.0\n\n- Remove generics from Trans component to suppress warning issue [1400](https://github.com/i18next/react-i18next/pull/1400)\n- Add type support to plurals [1399](https://github.com/i18next/react-i18next/pull/1399)\n\n### 11.13.0\n\n- feat(types): add type-safe support to keyPrefix option [1390](https://github.com/i18next/react-i18next/pull/1390)\n- feat(types): allow key separator augmentation [1367](https://github.com/i18next/react-i18next/pull/1367)\n\n### 11.12.0\n\n- feature: add key prefix support to useTranslation hook [1371](https://github.com/i18next/react-i18next/pull/1371)\n\n### 11.11.4\n\n- typescript: add returnNull and returnEptyString options to TypeOptions interface [1341](https://github.com/i18next/react-i18next/pull/1341)\n\n### 11.11.3\n\n- Trans: parse first, then interpolate [1345](https://github.com/i18next/react-i18next/pull/1345)\n\n### 11.11.2\n\n- feat(typings): support readonly namespaces in TFuncKey [1340](https://github.com/i18next/react-i18next/pull/1340)\n\n### 11.11.1\n\n- feat(types): allow readonly namespaces in useTranslation [1339](https://github.com/i18next/react-i18next/pull/1339)\n\n### 11.11.0\n\n- introduce `CustomTypeOptions` type definition and deprecate the `Resources` type definition [1328](https://github.com/i18next/react-i18next/pull/1328)\n\n### 11.10.0\n\n- add transWrapTextNodes option [1324](https://github.com/i18next/react-i18next/pull/1324) to prevent a well-known Google Translate issue with React apps [1323](https://github.com/i18next/react-i18next/issues/1323), thanks to [feross](https://github.com/feross)\n\n### 11.9.0\n\n- typescript/icu macro: add new syntax for interpolation of complex types [1316](https://github.com/i18next/react-i18next/pull/1316) -> [docs for template usage](https://react.i18next.com/misc/using-with-icu-format#tagged-template-for-icu)\n\n### 11.8.15\n\n- ignore null children in Trans component [1307](https://github.com/i18next/react-i18next/issues/1307)\n\n### 11.8.14\n\n- update html-parse-stringify to fix uppercase elements in Trans component [1304](https://github.com/i18next/react-i18next/issues/1304)\n\n### 11.8.13\n\n- Replace html-parse-stringify2 with html-parse-stringify [1283](https://github.com/i18next/react-i18next/pull/1283) to prevent [CVE-2021-23346](https://github.com/i18next/react-i18next/issues/1275)\n\n### 11.8.12\n\n- refactor: remove unneeded object [1286](https://github.com/i18next/react-i18next/pull/1286)\n\n### 11.8.11\n\n- typescript: Bug fixes [1284](https://github.com/i18next/react-i18next/pull/1284)\n\n### 11.8.10\n\n- typescript: Move type definition files [1276](https://github.com/i18next/react-i18next/pull/1276)\n\n### 11.8.9\n\n- Fix allow to replace i18n in provider with useTranslation hook [1273](https://github.com/i18next/react-i18next/pull/1273)\n\n### 11.8.8\n\n- typescript: Allow `TFuncKey` to be used without specifying the namespace, in the same way TFunction and useTranslation work [1262](https://github.com/i18next/react-i18next/pull/1262)\n\n### 11.8.7\n\n- warning for old wait usage\n\n### 11.8.6\n\n- typescript: Updated TS definitions (adding useSuspense option in TranslationProps) [1247](https://github.com/i18next/react-i18next/pull/1247)\n\n### 11.8.5\n\n- typescript: fix: Inference for specific keys ts 4.1 [1230](https://github.com/i18next/react-i18next/pull/1230)\n\n### 11.8.4\n\n- typescript: Add workaround to suppress infinite instantiation warning [1227](https://github.com/i18next/react-i18next/pull/1227)\n- typescript: withTranslation() typing fix for defaultProps [1226](https://github.com/i18next/react-i18next/pull/1226)\n- typescript: Accept const components prop for Trans [1224](https://github.com/i18next/react-i18next/pull/1224)\n\n### 11.8.3\n\n- Fix: Return type inference for t function (typescript 4.1) [1221](https://github.com/i18next/react-i18next/pull/1221)\n\n### 11.8.2\n\n- fix: type definitions for typescript 4.1 [1220](https://github.com/i18next/react-i18next/pull/1220)\n\n### 11.8.1\n\n- fix: typescript definitions for t function without namespaces [1214](https://github.com/i18next/react-i18next/pull/1214)\n\n### 11.8.0\n\n- typescript: Make the translation function fully type-safe [1193](https://github.com/i18next/react-i18next/pull/1193)\n- trans should work with misleading overloaded empty elements in components [1206](https://github.com/i18next/react-i18next/pull/1206)\n\n### 11.7.4\n\n- fixes passing interpolations options via Trans components tOptions prop [1204](https://github.com/i18next/react-i18next/pull/1204)\n\n### 11.7.3\n\n- Avoid redundant re-rendering in I18nextProvider [1174](https://github.com/i18next/react-i18next/pull/1174)\n\n### 11.7.2\n\n- Avoid setState while react is rendering [1165](https://github.com/i18next/react-i18next/pull/1165)\n\n### 11.7.1\n\n- typescript: fix: typescript definition of context object [1160](https://github.com/i18next/react-i18next/pull/1160)\n\n### 11.7.0\n\n- Trans interpolating self-closing tags in components prop(object) [1140](https://github.com/i18next/react-i18next/pull/1140)\n\n### 11.6.0\n\n- Trans allow components props to be an object containing named interpolation elements\n\n### 11.5.1\n\n- providing filename when running babel.parse in icu.macro [1133](https://github.com/i18next/react-i18next/pull/1133)\n\n### 11.5.0\n\n- Trans: merge option in mapAST [1120](https://github.com/i18next/react-i18next/pull/1120)\n\n### 11.4.0\n\n- Add sideEffects false to package json to allow tree shaking [1097](https://github.com/i18next/react-i18next/pull/1097)\n\n### 11.3.5\n\n- fix returning defaultValue for Trans component [1092](https://github.com/i18next/react-i18next/pull/1092)\n\n### 11.3.4\n\n- [useTranslation] Avoid setting the new `t` function if the component is unmounted. (1051)[https://github.com/i18next/react-i18next/pull/1051]\n\n### 11.3.3\n\n- fixes copying ns in useSSR\n\n### 11.3.2\n\n- typescript: Add optional defaultN [1050](https://github.com/i18next/react-i18next/pull/1050)\n\n### 11.3.1\n\n- typescript: Translation component's ready parameter is missing in TypeScript definition [1044](https://github.com/i18next/react-i18next/pull/1044)\n- change hook condition in Trans to equal useTranslations implementation\n\n### 11.3.0\n\n- useSSR: add namespaces to init options options.ns [1031](https://github.com/i18next/react-i18next/issues/1031)\n- typescript: Fix the type of the components props of Trans [1036](https://github.com/i18next/react-i18next/pull/1036)\n\n### 11.2.7\n\n- typescript: Allow ComponentType for Trans' `parent` type [1021](https://github.com/i18next/react-i18next/pull/1021)\n\n### 11.2.6\n\n- typescript: Allow html props on Trans, fix `parent` prop type [1019](https://github.com/i18next/react-i18next/pull/1019)\n\n### 11.2.5\n\n- handle array fallback on wrongly configured app ;) [1010](https://github.com/i18next/react-i18next/pull/1010)\n\n### 11.2.4\n\n- typescript: Extend withTranslation tests to include optional props [1009](https://github.com/i18next/react-i18next/pull/1009)\n\n### 11.2.3\n\n- Store should be initialized after useSSR [1008](https://github.com/i18next/react-i18next/pull/1008)\n\n### 11.2.2\n\n- Only pass forwardedRef to children if options.withRef is false [999](https://github.com/i18next/react-i18next/pull/999)\n\n### 11.2.1\n\n- remove used jsx in withTranslation to avoid issues while compiling [994](https://github.com/i18next/react-i18next/pull/994)\n\n### 11.2.0\n\n- withTranslation allow not only passing a ref with option withRef but also passing a forwardedRef from outside as props (before forwardedRef was only added to wrapped component if the withRef option was set) [992](https://github.com/i18next/react-i18next/pull/992)\n\n### 11.1.0\n\n- Update `rollup.config.js` for IE11 Transpilations [988](https://github.com/i18next/react-i18next/pull/988)\n\n### 11.0.1\n\n- typescript: Use updated ts export default from i18next [984](https://github.com/i18next/react-i18next/pull/984)\n\n### 11.0.0\n\n- **Breaking** based on i18next changes made in [v18.0.0](https://github.com/i18next/i18next/blob/master/CHANGELOG.md#1800) changing the language should not trigger a Suspense anylonger. The state will be ready and `t` bound to the previous language until `languageChanged` get triggered -> this results in a nicer experience for users (no flickering Suspense while changing the language). Based on issue \"Suspence is fired during lang change when useTranslation called in between\" [975](https://github.com/i18next/react-i18next/issues/975)\n- the default bindI18n is now `languageChanged` and `languageChanging` was removed from that default\n- Adding `languageChanging` to bindI18n will bring back old behaviour where a language change will trigger a Suspense / ready: false while loading those new translations\n- You can now override the defaults in i18next.options.react for `bindI18n`, `bindI18nStore` and `useSuspense` in the hook by `useTranslation(ns, { bindI18n, bindI18nStore, useSuspense})` or in the HOC by passing those as props.\n\n### 10.13.2\n\n- typescript: Add t function to TransProps types [969](https://github.com/i18next/react-i18next/pull/969)\n- lint: Fix linter errors [966](https://github.com/i18next/react-i18next/pull/966)\n\n### 10.13.1\n\n- avoid conditional hook call in edge case (was only issue in wrong setup useContext outside I18nextProvider) [951](https://github.com/i18next/react-i18next/pull/951)\n\n### 10.13.0\n\n- also use count from `values` object passed to Trans if passed - else use the one on props [947](https://github.com/i18next/react-i18next/pull/947)\n\n### 10.12.5\n\n- typescript: Update types for reportNamespaces [945](https://github.com/i18next/react-i18next/pull/945)\n- typescript: Improve withSSR type definition [943](https://github.com/i18next/react-i18next/pull/943)\n\n### 10.12.4\n\n- ICU: Fixes macro to support count prop and expressions better [939](https://github.com/i18next/react-i18next/pull/939)\n\n### 10.12.3\n\n- avoid conditional hook call in edge case (wrong setup) [935](https://github.com/i18next/react-i18next/pull/935)\n\n### 10.12.2\n\n- Trans: do not replace html tags in translation strings that are not in the transKeepBasicHtmlNodesFor array [919](https://github.com/i18next/react-i18next/issues/919)\n\n### 10.12.1\n\n- Set ready flag to false when i18n instance has not been initialised [918](https://github.com/i18next/react-i18next/pull/918)\n\n### 10.12.0\n\n- fix / extend icu.macro: ICU: Trans macro will parse defaults as alternate to children [917](https://github.com/i18next/react-i18next/pull/917)\n\n### 10.11.5\n\n- typescript: fix types for use() [912](https://github.com/i18next/react-i18next/pull/912)\n\n### 10.11.4\n\n- assert edge case trans component get set a key\n- assert context get destructed of empty object if context gets used falsely on a component got pulled out of main tree from react-portal or similar\n\n### 10.11.3\n\n- only apply initial values in useSSR, withSSR on i18next instances not being a clone (eg. created by express middleware on server) ==> don't apply on serverside\n\n### 10.11.2\n\n- Reload translations whenever namespaces passed to useTranslation() change [878](https://github.com/i18next/react-i18next/pull/878)\n\n### 10.11.1\n\n- fixes a regression in Trans component taking namespace from passed t function [867](https://github.com/i18next/react-i18next/issues/867#issuecomment-502395958)\n\n### 10.11.0\n\n- Restore support passing the defaultNS via I18nextProvider prop [860](https://github.com/i18next/react-i18next/pull/860)\n\n### 10.10.0\n\n- HOC: expose wrapped component as WrappedComponent property [853](https://github.com/i18next/react-i18next/pull/853)\n\n### 10.9.1\n\n- Fix useEffect mount/unmount usage [852](https://github.com/i18next/react-i18next/pull/852)\n\n### 10.9.0\n\n- trigger suspense on languageChanging by add listening to that event too (new in i18next@15.1.0) - if you do not like this behaviour of suspending during languageChange - remove it from bindI18n\n\n### 10.8.1\n\n- expose context [829](https://github.com/i18next/react-i18next/pull/829)\n\n### 10.8.0\n\n- Support taking values for interpolation not only from content but the props count, values too: Replace count prop from in translation string automatically [826](https://github.com/i18next/react-i18next/issues/826)\n\n### 10.7.0\n\n- brings back nsMode=default|fallback [822](https://github.com/i18next/react-i18next/pull/822)\n- typescript: Add missing type definition for withTranslation options [821](https://github.com/i18next/react-i18next/pull/821)\n\n### 10.6.2\n\n- Fix Trans component ignore default options [818](https://github.com/i18next/react-i18next/pull/818)\n\n### 10.6.1\n\n- useTranslation useEffect also guard against unmounted for bound events...seems unmount and actual call to useEffect cleanup are not in correct order (component is first unmounted and then unbound - should be vice versa)\n\n### 10.6.0\n\n- use forwardRef for withTranslation [802](https://github.com/i18next/react-i18next/pull/802)\n- fixes Translation reset after component is unmounted with useTranslation [801](https://github.com/i18next/react-i18next/issues/801)\n\n### 10.5.3\n\n- Fix the displayName of HOC components [798](https://github.com/i18next/react-i18next/pull/798)\n\n### 10.5.2\n\n- fixes: transSupportBasicHtmlNodes doesn't work with self-closing Trans [790](https://github.com/i18next/react-i18next/issues/790)\n\n### 10.5.1\n\n- ReferenceError: setImmediate is not defined [787](https://github.com/i18next/react-i18next/issues/787)\n\n### 10.5.0\n\n- Adding support for nested component inside Trans that are a list.map like `
    {['a', 'b'].map(item => (
  • {item}
    • ))}
` [784](https://github.com/i18next/react-i18next/pull/784) (Adding `