i18next-cli 1.56.5 → 1.56.7

package/dist/cjs/cli.js

@@ -32,7 +32,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.56.5'); // This string is replaced with the actual version at build time by rollup
+    .version('1.56.7'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/cjs/extractor/core/translation-manager.js

@@ -224,6 +224,11 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
     const cardinalCategories = cardinalRules.resolvedOptions().pluralCategories;
     cardinalCategories.forEach(cat => targetLanguagePluralCategories.add(cat));
     ordinalRules.resolvedOptions().pluralCategories.forEach(cat => targetLanguagePluralCategories.add(`ordinal_${cat}`));
+    // Plural categories of the primary language — used to recognise locale-specific
+    // plural variants (e.g. French `_many` when primary is English) so we don't
+    // treat their absence from the primary file as a "divergence" during --sync-all.
+    const primaryCardinalCategoriesSet = new Set(pluralRules.safePluralRules(primaryLanguage, { type: 'cardinal' }).resolvedOptions().pluralCategories);
+    const primaryOrdinalCategoriesSet = new Set(pluralRules.safePluralRules(primaryLanguage, { type: 'ordinal' }).resolvedOptions().pluralCategories);
     // When allPluralForms is enabled, compute the union of cardinal categories across all configured locales.
     // This ensures every locale gets the same set of plural keys — but only the forms actually needed by at least one locale.
     const allLocalesCardinalCategories = config.extract.allPluralForms
@@ -762,8 +767,26 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             else {
                 // Non-primary locale behavior
                 const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
+                // A plural variant whose category exists in the current locale but not in the
+                // primary language (e.g. French `_many` vs English `one`/`other`) will always be
+                // absent from the primary file by CLDR design. Treat that absence as expected —
+                // not as the primary "diverging" from the default — so --sync-all preserves the
+                // locale-specific translation instead of clearing it on every run. (issue #248)
+                const isLocaleSpecificPluralVariant = (() => {
+                    if (!hasCount)
+                        return false;
+                    const parts = String(key).split(pluralSeparator);
+                    if (parts.length < 2)
+                        return false;
+                    const lastPart = parts[parts.length - 1];
+                    if (isOrdinal && parts.length >= 3 && parts[parts.length - 2] === 'ordinal') {
+                        return !primaryOrdinalCategoriesSet.has(lastPart);
+                    }
+                    return !primaryCardinalCategoriesSet.has(lastPart);
+                })();
                 const primaryDivergedFromDefault = Boolean(defaultValue$1 &&
                     !primaryShouldPreserveObject &&
+                    !isLocaleSpecificPluralVariant &&
                     (primaryExistingValue === undefined ||
                         primaryIsStaleObject ||
                         ((!isVariantKey || explicitDefault) &&

package/dist/cjs/extractor/parsers/call-expression-handler.js

@@ -68,21 +68,6 @@ class CallExpressionHandler {
             return;
         // The scope lookup will only work for simple identifiers, which is okay for this fix.
         let scopeInfo = getScopeInfo(functionName);
-        // For member expressions like `emailError.t`, also try the object part(s) as a
-        // fallback. This lets custom hooks that return an object with a `t` method
-        // (e.g. `const emailError = useTranslateKeyState('auth')`) propagate their
-        // namespace/keyPrefix to the inner `t` call.
-        if (!scopeInfo && functionName.includes('.')) {
-            const parts = functionName.split('.');
-            for (let i = parts.length - 1; i > 0; i--) {
-                const candidate = parts.slice(0, i).join('.');
-                const candidateScope = getScopeInfo(candidate);
-                if (candidateScope) {
-                    scopeInfo = candidateScope;
-                    break;
-                }
-            }
-        }
         const configuredFunctions = this.config.extract.functions || ['t', '*.t'];
         let isFunctionToParse = scopeInfo !== undefined; // A scoped variable (from useTranslation, etc.) is always parsed.
         if (!isFunctionToParse) {
@@ -105,6 +90,23 @@ class CallExpressionHandler {
         }
         if (!isFunctionToParse || node.arguments.length === 0)
             return;
+        // For member expressions like `emailError.t`, also try the object part(s) as a
+        // fallback. This lets custom hooks that return an object with a `t` method
+        // (e.g. `const emailError = useTranslateKeyState('auth')`) propagate their
+        // namespace/keyPrefix to the inner `t` call. This runs AFTER the pattern
+        // check so an in-scope prefix cannot by itself promote an arbitrary method
+        // call (e.g. `i18n.language.substring(...)`) into a translation call.
+        if (!scopeInfo && functionName.includes('.')) {
+            const parts = functionName.split('.');
+            for (let i = parts.length - 1; i > 0; i--) {
+                const candidate = parts.slice(0, i).join('.');
+                const candidateScope = getScopeInfo(candidate);
+                if (candidateScope) {
+                    scopeInfo = candidateScope;
+                    break;
+                }
+            }
+        }
         const { keysToProcess, isSelectorAPI } = this.handleCallExpressionArgument(node, 0);
         if (keysToProcess.length === 0)
             return;

package/dist/esm/cli.js

@@ -30,7 +30,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.56.5'); // This string is replaced with the actual version at build time by rollup
+    .version('1.56.7'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/esm/extractor/core/translation-manager.js

@@ -222,6 +222,11 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
     const cardinalCategories = cardinalRules.resolvedOptions().pluralCategories;
     cardinalCategories.forEach(cat => targetLanguagePluralCategories.add(cat));
     ordinalRules.resolvedOptions().pluralCategories.forEach(cat => targetLanguagePluralCategories.add(`ordinal_${cat}`));
+    // Plural categories of the primary language — used to recognise locale-specific
+    // plural variants (e.g. French `_many` when primary is English) so we don't
+    // treat their absence from the primary file as a "divergence" during --sync-all.
+    const primaryCardinalCategoriesSet = new Set(safePluralRules(primaryLanguage, { type: 'cardinal' }).resolvedOptions().pluralCategories);
+    const primaryOrdinalCategoriesSet = new Set(safePluralRules(primaryLanguage, { type: 'ordinal' }).resolvedOptions().pluralCategories);
     // When allPluralForms is enabled, compute the union of cardinal categories across all configured locales.
     // This ensures every locale gets the same set of plural keys — but only the forms actually needed by at least one locale.
     const allLocalesCardinalCategories = config.extract.allPluralForms
@@ -760,8 +765,26 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             else {
                 // Non-primary locale behavior
                 const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
+                // A plural variant whose category exists in the current locale but not in the
+                // primary language (e.g. French `_many` vs English `one`/`other`) will always be
+                // absent from the primary file by CLDR design. Treat that absence as expected —
+                // not as the primary "diverging" from the default — so --sync-all preserves the
+                // locale-specific translation instead of clearing it on every run. (issue #248)
+                const isLocaleSpecificPluralVariant = (() => {
+                    if (!hasCount)
+                        return false;
+                    const parts = String(key).split(pluralSeparator);
+                    if (parts.length < 2)
+                        return false;
+                    const lastPart = parts[parts.length - 1];
+                    if (isOrdinal && parts.length >= 3 && parts[parts.length - 2] === 'ordinal') {
+                        return !primaryOrdinalCategoriesSet.has(lastPart);
+                    }
+                    return !primaryCardinalCategoriesSet.has(lastPart);
+                })();
                 const primaryDivergedFromDefault = Boolean(defaultValue &&
                     !primaryShouldPreserveObject &&
+                    !isLocaleSpecificPluralVariant &&
                     (primaryExistingValue === undefined ||
                         primaryIsStaleObject ||
                         ((!isVariantKey || explicitDefault) &&

package/dist/esm/extractor/parsers/call-expression-handler.js

@@ -66,21 +66,6 @@ class CallExpressionHandler {
             return;
         // The scope lookup will only work for simple identifiers, which is okay for this fix.
         let scopeInfo = getScopeInfo(functionName);
-        // For member expressions like `emailError.t`, also try the object part(s) as a
-        // fallback. This lets custom hooks that return an object with a `t` method
-        // (e.g. `const emailError = useTranslateKeyState('auth')`) propagate their
-        // namespace/keyPrefix to the inner `t` call.
-        if (!scopeInfo && functionName.includes('.')) {
-            const parts = functionName.split('.');
-            for (let i = parts.length - 1; i > 0; i--) {
-                const candidate = parts.slice(0, i).join('.');
-                const candidateScope = getScopeInfo(candidate);
-                if (candidateScope) {
-                    scopeInfo = candidateScope;
-                    break;
-                }
-            }
-        }
         const configuredFunctions = this.config.extract.functions || ['t', '*.t'];
         let isFunctionToParse = scopeInfo !== undefined; // A scoped variable (from useTranslation, etc.) is always parsed.
         if (!isFunctionToParse) {
@@ -103,6 +88,23 @@ class CallExpressionHandler {
         }
         if (!isFunctionToParse || node.arguments.length === 0)
             return;
+        // For member expressions like `emailError.t`, also try the object part(s) as a
+        // fallback. This lets custom hooks that return an object with a `t` method
+        // (e.g. `const emailError = useTranslateKeyState('auth')`) propagate their
+        // namespace/keyPrefix to the inner `t` call. This runs AFTER the pattern
+        // check so an in-scope prefix cannot by itself promote an arbitrary method
+        // call (e.g. `i18n.language.substring(...)`) into a translation call.
+        if (!scopeInfo && functionName.includes('.')) {
+            const parts = functionName.split('.');
+            for (let i = parts.length - 1; i > 0; i--) {
+                const candidate = parts.slice(0, i).join('.');
+                const candidateScope = getScopeInfo(candidate);
+                if (candidateScope) {
+                    scopeInfo = candidateScope;
+                    break;
+                }
+            }
+        }
         const { keysToProcess, isSelectorAPI } = this.handleCallExpressionArgument(node, 0);
         if (keysToProcess.length === 0)
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.56.5",
+  "version": "1.56.7",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {

package/types/extractor/core/translation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAohC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}
+{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AA8iC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}

package/types/extractor/parsers/call-expression-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-expression-handler.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/call-expression-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,WAAW,CAAA;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAa7D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,kBAAkB,CAAoB;IACvC,UAAU,cAAoB;IACrC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,iBAAiB,CAAsC;gBAG7D,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,MAAM,MAAM,EAC5B,cAAc,EAAE,MAAM,MAAM,EAC5B,iBAAiB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAA2B;IAW3E;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI;IA0ZxG;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,wBAAwB;IAyEhC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;IAwFzC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyMxB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;CA2BxB"}
+{"version":3,"file":"call-expression-handler.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/call-expression-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,WAAW,CAAA;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAa7D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,kBAAkB,CAAoB;IACvC,UAAU,cAAoB;IACrC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,iBAAiB,CAAsC;gBAG7D,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,MAAM,MAAM,EAC5B,cAAc,EAAE,MAAM,MAAM,EAC5B,iBAAiB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAA2B;IAW3E;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI;IA4ZxG;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,wBAAwB;IAyEhC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;IAwFzC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyMxB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;CA2BxB"}