i18next 26.1.0 → 26.2.0

package/.claude/settings.local.json

@@ -0,0 +1,27 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh pr *)",
+      "Read(//Users/adrai/Projects/i18next/react-i18next/**)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Read(//Users/adrai/Projects/i18next/**)",
+      "Bash(gh issue *)",
+      "Read(//tmp/**)",
+      "WebFetch(domain:github.com)",
+      "Bash(grep -n '$PreservedValue\\\\b' /Users/adrai/Projects/i18next/i18next/typescript/helpers.d.ts)",
+      "Bash(npm run *)",
+      "Bash(cat > *)",
+      "Bash(python3 -c \"import json,sys; print\\(json.load\\(sys.stdin\\)['version']\\)\")",
+      "Bash(npm test *)",
+      "Bash(git pull *)",
+      "Bash(git push *)"
+    ],
+    "additionalDirectories": [
+      "/Users/adrai/Projects/i18next/react-i18next",
+      "/tmp",
+      "/Users/adrai/Projects/i18next/i18next-gitbook/overview",
+      "/Users/adrai/Projects/i18next/i18next-icu"
+    ]
+  }
+}

package/README.md

@@ -23,7 +23,7 @@ i18next provides:
 - Extensibility: eg. [sprintf](https://www.i18next.com/overview/plugins-and-utils#post-processors)
 - ...
 
-> **Pro Tip:** Looking for a way to manage your translations? Locize is the official service by i18next's creators and now offers a **[Free plan](https://www.locize.com/pricing?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme)** for small projects.
+> **Pro Tip:** Looking for a way to manage your translations? [Locize](https://www.locize.com?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme) is the official service by i18next's creators — drop in [`i18next-locize-backend`](https://github.com/locize/i18next-locize-backend) for CDN delivery, AI translation, and no redeploys for copy changes. **[Free plan](https://www.locize.com/pricing?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme)** available for small projects.
 
 For more information visit the website:
 

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"26.1.0"}
+{"type":"module","version":"26.2.0"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next",
-  "version": "26.1.0",
+  "version": "26.2.0",
   "description": "i18next internationalization framework",
   "main": "./dist/cjs/i18next.js",
   "module": "./dist/esm/i18next.js",

package/typescript/options.d.ts

@@ -96,6 +96,27 @@ export type TypeOptions = $MergeBy<
     /** @see {InterpolationOptions.unescapeSuffix} */
     unescapeSuffix: '';
 
+    /**
+     * Whether to extract interpolation variables from translation strings at
+     * the type level. When `true` (default), the type system parses each
+     * resource value for `{{variable}}` patterns and types the `t()` options
+     * accordingly.
+     *
+     * Set to `false` when your translation strings use a different
+     * interpolation syntax that the i18next type extractor cannot understand
+     * — e.g. ICU MessageFormat plurals like `{count, plural, one {{count} row}
+     * other {{count} rows}}` would otherwise produce phantom variable names
+     * because the default extractor naively matches the outermost `{{` …
+     * `}}`. This flag is type-only; runtime interpolation is governed by
+     * `InterpolationOptions` and is unaffected.
+     *
+     * Required by `i18next-icu` users — see that package's docs for the
+     * recommended `CustomTypeOptions` augmentation.
+     *
+     * @default true
+     */
+    parseInterpolation: true;
+
     /**
      * Use a proxy-based selector to select a translation.
      *
@@ -641,6 +662,19 @@ export interface InitOptions<T = object> extends PluginOptions<T> {
    */
   nsSeparator?: false | string;
 
+  /**
+   * Selector-API mode. Mirrors `CustomTypeOptions['enableSelector']`.
+   *
+   * - `false` (default): selector API disabled.
+   * - `true` / `'optimize'`: selector resolution enabled.
+   * - `'strict'`: require an explicit namespace as the first selector
+   *   path segment in every call. The resolver always rewrites a leading
+   *   namespace-matching segment as a namespace prefix.
+   *
+   * @default false
+   */
+  enableSelector?: false | true | 'optimize' | 'strict';
+
   /**
    * Char to split plural from key
    * @default '_'

package/typescript/t.d.ts

@@ -36,6 +36,7 @@ type _UnescapePrefix = TypeOptions['unescapePrefix'];
 type _UnescapeSuffix = TypeOptions['unescapeSuffix'];
 type _StrictKeyChecks = TypeOptions['strictKeyChecks'];
 type _EnableSelector = TypeOptions['enableSelector'];
+type _ParseInterpolation = TypeOptions['parseInterpolation'];
 type _InterpolationFormatTypeMap = TypeOptions['interpolationFormatTypeMap'];
 
 type $IsResourcesDefined = [keyof _Resources] extends [never] ? false : true;
@@ -168,8 +169,9 @@ type ParseActualValue<Ret> = Ret extends `${_UnescapePrefix}${infer ActualValue}
   : Ret;
 
 /** Parses interpolation entries as `[variableName, formatSpecifier | never]` tuples. */
-type ParseInterpolationEntries<Ret> =
-  Ret extends `${string}${_InterpolationPrefix}${infer Value}${_InterpolationSuffix}${infer Rest}`
+type ParseInterpolationEntries<Ret> = [_ParseInterpolation] extends [false]
+  ? never
+  : Ret extends `${string}${_InterpolationPrefix}${infer Value}${_InterpolationSuffix}${infer Rest}`
     ?
         | (Value extends `${infer ActualValue},${infer Format}`
             ? [ParseActualValue<ActualValue>, TrimSpaces<Format>]