i18next-cli 1.56.5 → 1.56.6

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.6'); // 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/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.6'); // 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.56.5",
+  "version": "1.56.6",
   "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"}