i18next-cli 1.42.7 → 1.42.8

package/dist/cjs/cli.js

@@ -28,7 +28,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.42.7'); // This string is replaced with the actual version at build time by rollup
+    .version('1.42.8'); // 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

@@ -796,6 +796,10 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
             const namespacesToProcess = existingIsNamespaced
                 ? new Set([...keysByNS.keys(), ...existingKeys])
                 : new Set([...keysByNS.keys(), NO_NS_TOKEN]);
+            // Remove ignored namespaces so their section is never modified
+            for (const ns of ignoreNamespaces) {
+                namespacesToProcess.delete(ns);
+            }
             for (const nsKey of namespacesToProcess) {
                 const nsKeys = keysByNS.get(nsKey) || [];
                 if (nsKey === NO_NS_TOKEN) {
@@ -808,6 +812,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                     newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults);
                 }
             }
+            // Preserve ignored namespaces as-is from the existing merged file
+            for (const ns of ignoreNamespaces) {
+                if (ns in existingMergedFile) {
+                    newMergedTranslations[ns] = existingMergedFile[ns];
+                }
+            }
             const oldContent = JSON.stringify(existingMergedFile, null, indentation);
             const newContent = JSON.stringify(newMergedTranslations, null, indentation);
             // Push a single result for the merged file
@@ -833,6 +843,10 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                     namespacesToProcess.add(ns);
                 }
             }
+            // Remove ignored namespaces so their files are never modified
+            for (const ns of ignoreNamespaces) {
+                namespacesToProcess.delete(ns);
+            }
             // Process each namespace individually and create a result for each one
             for (const ns of namespacesToProcess) {
                 const nsKeys = keysByNS.get(ns) || [];

package/dist/cjs/linter.js

@@ -23,6 +23,22 @@ function extractInterpolationKeys(str, config) {
     }
     return keys;
 }
+// Known i18next t() option keys that are NOT interpolation parameters.
+// These should not be flagged as "unused" in the translation string.
+const i18nextOptionKeys = new Set([
+    'defaultValue', 'count', 'context', 'ns', 'lng', 'lngs',
+    'fallbackLng', 'returnDetails', 'returnObjects', 'joinArrays',
+    'postProcess', 'interpolation', 'skipInterpolation', 'replace',
+    'ordinal', 'keySeparator', 'nsSeparator', 'tDescription',
+]);
+function isI18nextOptionKey(key) {
+    if (i18nextOptionKeys.has(key))
+        return true;
+    // defaultValue_one, defaultValue_other, defaultValue_many, etc.
+    if (key.startsWith('defaultValue_'))
+        return true;
+    return false;
+}
 // Helper to lint interpolation parameter errors in t() calls
 function lintInterpolationParams(ast, code, config) {
     const issues = [];
@@ -132,7 +148,10 @@ function lintInterpolationParams(ast, code, config) {
                         }
                     }
                     // For each provided param, check if it is used either directly or as the root of a dotted key.
+                    // Skip known i18next t() option keys that are not interpolation parameters.
                     for (const pk of paramKeys) {
+                        if (isI18nextOptionKey(pk))
+                            continue;
                         const isUsed = keys.some(k => k === pk || k.split('.')[0] === pk);
                         if (!isUsed) {
                             issues.push({

package/dist/esm/cli.js

@@ -26,7 +26,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.42.7'); // This string is replaced with the actual version at build time by rollup
+    .version('1.42.8'); // 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

@@ -794,6 +794,10 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
             const namespacesToProcess = existingIsNamespaced
                 ? new Set([...keysByNS.keys(), ...existingKeys])
                 : new Set([...keysByNS.keys(), NO_NS_TOKEN]);
+            // Remove ignored namespaces so their section is never modified
+            for (const ns of ignoreNamespaces) {
+                namespacesToProcess.delete(ns);
+            }
             for (const nsKey of namespacesToProcess) {
                 const nsKeys = keysByNS.get(nsKey) || [];
                 if (nsKey === NO_NS_TOKEN) {
@@ -806,6 +810,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                     newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults);
                 }
             }
+            // Preserve ignored namespaces as-is from the existing merged file
+            for (const ns of ignoreNamespaces) {
+                if (ns in existingMergedFile) {
+                    newMergedTranslations[ns] = existingMergedFile[ns];
+                }
+            }
             const oldContent = JSON.stringify(existingMergedFile, null, indentation);
             const newContent = JSON.stringify(newMergedTranslations, null, indentation);
             // Push a single result for the merged file
@@ -831,6 +841,10 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                     namespacesToProcess.add(ns);
                 }
             }
+            // Remove ignored namespaces so their files are never modified
+            for (const ns of ignoreNamespaces) {
+                namespacesToProcess.delete(ns);
+            }
             // Process each namespace individually and create a result for each one
             for (const ns of namespacesToProcess) {
                 const nsKeys = keysByNS.get(ns) || [];

package/dist/esm/linter.js

@@ -21,6 +21,22 @@ function extractInterpolationKeys(str, config) {
     }
     return keys;
 }
+// Known i18next t() option keys that are NOT interpolation parameters.
+// These should not be flagged as "unused" in the translation string.
+const i18nextOptionKeys = new Set([
+    'defaultValue', 'count', 'context', 'ns', 'lng', 'lngs',
+    'fallbackLng', 'returnDetails', 'returnObjects', 'joinArrays',
+    'postProcess', 'interpolation', 'skipInterpolation', 'replace',
+    'ordinal', 'keySeparator', 'nsSeparator', 'tDescription',
+]);
+function isI18nextOptionKey(key) {
+    if (i18nextOptionKeys.has(key))
+        return true;
+    // defaultValue_one, defaultValue_other, defaultValue_many, etc.
+    if (key.startsWith('defaultValue_'))
+        return true;
+    return false;
+}
 // Helper to lint interpolation parameter errors in t() calls
 function lintInterpolationParams(ast, code, config) {
     const issues = [];
@@ -130,7 +146,10 @@ function lintInterpolationParams(ast, code, config) {
                         }
                     }
                     // For each provided param, check if it is used either directly or as the root of a dotted key.
+                    // Skip known i18next t() option keys that are not interpolation parameters.
                     for (const pk of paramKeys) {
+                        if (isI18nextOptionKey(pk))
+                            continue;
                         const isUsed = keys.some(k => k === pk || k.split('.')[0] === pk);
                         if (!isUsed) {
                             issues.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.42.7",
+  "version": "1.42.8",
   "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,aAAa,CAAA;AAgyBnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,EAChB,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;CACb,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmJ9B"}
+{"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,aAAa,CAAA;AAgyBnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,EAChB,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;CACb,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoK9B"}

package/types/linter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AA6I3D,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE;QAAC;YACT,OAAO,EAAE,MAAM,CAAC;SACjB;KAAC,CAAC;IACH,IAAI,EAAE;QAAC;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;SAC1C;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,UAET,CAAA;AAC3B,eAAO,MAAM,6BAA6B,UAAgN,CAAA;AAK1P,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;gBAEvB,MAAM,EAAE,oBAAoB;IAKzC,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;CA6FV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB;;;;;;GAE5D;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,iBAkCnD;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;CACtC"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AA8J3D,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE;QAAC;YACT,OAAO,EAAE,MAAM,CAAC;SACjB;KAAC,CAAC;IACH,IAAI,EAAE;QAAC;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;SAC1C;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,UAET,CAAA;AAC3B,eAAO,MAAM,6BAA6B,UAAgN,CAAA;AAK1P,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;gBAEvB,MAAM,EAAE,oBAAoB;IAKzC,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;CA6FV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB;;;;;;GAE5D;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,iBAkCnD;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;CACtC"}