i18next-cli 1.71.2 → 1.71.3

package/README.md

@@ -921,6 +921,11 @@ export default defineConfig({
     // Namespaces to ignore during extraction, status, and sync operations.
     // Useful for monorepos where shared namespaces are managed elsewhere.
     // Keys using these namespaces will be excluded from processing.
+    // An ignored namespace can still act as a `fallbackNS` source: its
+    // translations are read (never written) for fallback accounting. If it
+    // lives in its own file outside a merged output (`mergeNamespaces: true`),
+    // use an `output` function that maps that namespace to its path, e.g.
+    // output: (lng, ns) => ns === 'shared' ? `locales/${lng}/${ns}.json` : `locales/${lng}.json`
     ignoreNamespaces: ['shared', 'common'], // Optional
 
     // When true (default), the extractor also scans code comments for t(...) / Trans examples and will extract keys found there.

package/dist/cjs/cli.js

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

@@ -1017,8 +1017,9 @@ async function reattributeFallbackNsKeys(keysByNS, noNsToken, config, primaryLan
     const pluralSeparator = config.extract.pluralSeparator ?? '_';
     // Same merged-output detection as the per-locale loop in getTranslations.
     const shouldMerge = config.extract.mergeNamespaces || (typeof config.extract.output === 'string' ? !config.extract.output.includes('{{namespace}}') : false);
+    const mergedPrimaryPath = node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, primaryLanguage));
     const mergedPrimaryFile = shouldMerge
-        ? (await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, primaryLanguage))) || {})
+        ? (await fileUtils.loadTranslationFile(mergedPrimaryPath) || {})
         : null;
     const catalogCache = new Map();
     const loadPrimaryCatalog = async (ns, isFallback) => {
@@ -1026,9 +1027,19 @@ async function reattributeFallbackNsKeys(keysByNS, noNsToken, config, primaryLan
         let catalog = catalogCache.get(cacheKey);
         if (!catalog) {
             if (mergedPrimaryFile) {
+                catalog = mergedPrimaryFile[ns];
+                if (catalog === undefined) {
+                    // The namespace may live in its own file outside the merged one
+                    // (split out and hidden via `ignoreNamespaces`, #287). Only
+                    // reachable when `output` resolves it to a separate path.
+                    const nsPath = node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, primaryLanguage, ns));
+                    if (nsPath !== mergedPrimaryPath) {
+                        catalog = (await fileUtils.loadTranslationFile(nsPath)) ?? undefined;
+                    }
+                }
                 // In merged mode the fallback keys may live at the top level when the
                 // file is not namespaced (same resolution as the status command).
-                catalog = mergedPrimaryFile[ns] ?? (isFallback ? mergedPrimaryFile : {});
+                catalog ??= (isFallback ? mergedPrimaryFile : {});
             }
             else {
                 catalog = await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, primaryLanguage, ns))) || {};

package/dist/cjs/status.js

@@ -238,8 +238,16 @@ async function generateStatusReport(config) {
     }
     const contextVariantsByNs = new Map();
     const nestedReferenceKeysByNs = new Map();
+    // Absolute path of the merged translation file for a locale. A function
+    // `output` is called WITHOUT a namespace — the same way `extract` resolves
+    // the merged file it writes — so hybrid layouts (one merged file plus a few
+    // split-out namespace files) resolve correctly (#287). String templates keep
+    // the historical defaultNS substitution for the {{namespace}} placeholder.
+    const getMergedPath = (locale) => node_path.resolve(process.cwd(), typeof config.extract.output === 'function'
+        ? fileUtils.getOutputPath(config.extract.output, locale)
+        : fileUtils.getOutputPath(config.extract.output, locale, (defaultNS === false ? 'translation' : (defaultNS || 'translation'))));
     const primaryMergedForScan = mergeNamespaces
-        ? ((await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, primaryLanguage, (defaultNS === false ? 'translation' : (defaultNS || 'translation')))))) || {})
+        ? ((await fileUtils.loadTranslationFile(getMergedPath(primaryLanguage))) || {})
         : null;
     const collectNestedRefsFromValue = (value, refNs, bucket, seen) => {
         if (typeof value === 'string') {
@@ -322,28 +330,53 @@ async function generateStatusReport(config) {
         const namespaces = new Map();
         const mergedTranslations = mergeNamespaces
             // When merging namespaces we need to load the combined translation file.
-            // The combined file lives under the regular output pattern and must include a namespace.
-            // If defaultNS is explicitly false, fall back to the conventional "translation" file name.
-            ? await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, (defaultNS === false ? 'translation' : (defaultNS || 'translation'))))) || {}
+            ? await fileUtils.loadTranslationFile(getMergedPath(locale)) || {}
             : null;
+        // Load fallbackNS catalogs once per locale (looked up in order, like the
+        // i18next runtime). The per-namespace loop below skips a namespace's own
+        // entry.
+        const fallbackCatalogs = new Map();
+        for (const fallbackNs of fallbackNamespaces) {
+            if (mergeNamespaces) {
+                // In merged mode the fallback keys normally live in the merged file
+                // under the fallback namespace.
+                let catalog = mergedTranslations?.[fallbackNs];
+                if (catalog === undefined) {
+                    // The fallback namespace may live in its own file outside the merged
+                    // one (split out and hidden via `ignoreNamespaces`, #287). Only
+                    // reachable when `output` resolves it to a separate path.
+                    const nsPath = node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, fallbackNs));
+                    if (nsPath !== getMergedPath(locale)) {
+                        catalog = (await fileUtils.loadTranslationFile(nsPath)) ?? undefined;
+                    }
+                }
+                if (catalog === undefined && isPrimary && ignoreNamespaces.has(fallbackNs)) {
+                    console.warn(`⚠️  fallbackNS "${fallbackNs}" is listed in ignoreNamespaces, but no translations for it were found — keys resolving through it will be reported as absent. If the namespace lives in its own file, use an \`output\` function that maps it to that path.`);
+                }
+                // If it's still not found, fall back to the top level of the merged
+                // file (flat, non-namespaced merged files).
+                fallbackCatalogs.set(fallbackNs, catalog ?? mergedTranslations ?? {});
+            }
+            else {
+                const nsPath = node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, fallbackNs));
+                const catalog = await fileUtils.loadTranslationFile(nsPath);
+                if (!catalog && isPrimary && ignoreNamespaces.has(fallbackNs)) {
+                    console.warn(`⚠️  fallbackNS "${fallbackNs}" is listed in ignoreNamespaces, but no translations for it were found at "${nsPath}" — keys resolving through it will be reported as absent.`);
+                }
+                fallbackCatalogs.set(fallbackNs, catalog || {});
+            }
+        }
         for (const [ns, keysInNs] of keysByNs.entries()) {
             const translationsForNs = mergeNamespaces
                 // If mergedTranslations is a flat object (no nested namespace) prefer the root object
                 // when mergedTranslations[ns] is missing.
                 ? (mergedTranslations?.[ns] ?? mergedTranslations ?? {})
                 : await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, ns))) || {};
-            // Load fallbackNS translations if configured (looked up in order, like the i18next runtime)
             const fallbackTranslationsList = [];
             for (const fallbackNs of fallbackNamespaces) {
                 if (ns === fallbackNs)
                     continue;
-                if (mergeNamespaces) {
-                    // In merged mode, fallbackNS keys are in mergedTranslations under the fallback namespace
-                    fallbackTranslationsList.push(mergedTranslations?.[fallbackNs] ?? mergedTranslations ?? {});
-                }
-                else {
-                    fallbackTranslationsList.push(await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, fallbackNs))) || {});
-                }
+                fallbackTranslationsList.push(fallbackCatalogs.get(fallbackNs));
             }
             let translatedInNs = 0;
             let emptyInNs = 0;

package/dist/esm/cli.js

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

@@ -1015,8 +1015,9 @@ async function reattributeFallbackNsKeys(keysByNS, noNsToken, config, primaryLan
     const pluralSeparator = config.extract.pluralSeparator ?? '_';
     // Same merged-output detection as the per-locale loop in getTranslations.
     const shouldMerge = config.extract.mergeNamespaces || (typeof config.extract.output === 'string' ? !config.extract.output.includes('{{namespace}}') : false);
+    const mergedPrimaryPath = resolve(process.cwd(), getOutputPath(config.extract.output, primaryLanguage));
     const mergedPrimaryFile = shouldMerge
-        ? (await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, primaryLanguage))) || {})
+        ? (await loadTranslationFile(mergedPrimaryPath) || {})
         : null;
     const catalogCache = new Map();
     const loadPrimaryCatalog = async (ns, isFallback) => {
@@ -1024,9 +1025,19 @@ async function reattributeFallbackNsKeys(keysByNS, noNsToken, config, primaryLan
         let catalog = catalogCache.get(cacheKey);
         if (!catalog) {
             if (mergedPrimaryFile) {
+                catalog = mergedPrimaryFile[ns];
+                if (catalog === undefined) {
+                    // The namespace may live in its own file outside the merged one
+                    // (split out and hidden via `ignoreNamespaces`, #287). Only
+                    // reachable when `output` resolves it to a separate path.
+                    const nsPath = resolve(process.cwd(), getOutputPath(config.extract.output, primaryLanguage, ns));
+                    if (nsPath !== mergedPrimaryPath) {
+                        catalog = (await loadTranslationFile(nsPath)) ?? undefined;
+                    }
+                }
                 // In merged mode the fallback keys may live at the top level when the
                 // file is not namespaced (same resolution as the status command).
-                catalog = mergedPrimaryFile[ns] ?? (isFallback ? mergedPrimaryFile : {});
+                catalog ??= (isFallback ? mergedPrimaryFile : {});
             }
             else {
                 catalog = await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, primaryLanguage, ns))) || {};

package/dist/esm/status.js

@@ -232,8 +232,16 @@ async function generateStatusReport(config) {
     }
     const contextVariantsByNs = new Map();
     const nestedReferenceKeysByNs = new Map();
+    // Absolute path of the merged translation file for a locale. A function
+    // `output` is called WITHOUT a namespace — the same way `extract` resolves
+    // the merged file it writes — so hybrid layouts (one merged file plus a few
+    // split-out namespace files) resolve correctly (#287). String templates keep
+    // the historical defaultNS substitution for the {{namespace}} placeholder.
+    const getMergedPath = (locale) => resolve(process.cwd(), typeof config.extract.output === 'function'
+        ? getOutputPath(config.extract.output, locale)
+        : getOutputPath(config.extract.output, locale, (defaultNS === false ? 'translation' : (defaultNS || 'translation'))));
     const primaryMergedForScan = mergeNamespaces
-        ? ((await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, primaryLanguage, (defaultNS === false ? 'translation' : (defaultNS || 'translation')))))) || {})
+        ? ((await loadTranslationFile(getMergedPath(primaryLanguage))) || {})
         : null;
     const collectNestedRefsFromValue = (value, refNs, bucket, seen) => {
         if (typeof value === 'string') {
@@ -316,28 +324,53 @@ async function generateStatusReport(config) {
         const namespaces = new Map();
         const mergedTranslations = mergeNamespaces
             // When merging namespaces we need to load the combined translation file.
-            // The combined file lives under the regular output pattern and must include a namespace.
-            // If defaultNS is explicitly false, fall back to the conventional "translation" file name.
-            ? await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, locale, (defaultNS === false ? 'translation' : (defaultNS || 'translation'))))) || {}
+            ? await loadTranslationFile(getMergedPath(locale)) || {}
             : null;
+        // Load fallbackNS catalogs once per locale (looked up in order, like the
+        // i18next runtime). The per-namespace loop below skips a namespace's own
+        // entry.
+        const fallbackCatalogs = new Map();
+        for (const fallbackNs of fallbackNamespaces) {
+            if (mergeNamespaces) {
+                // In merged mode the fallback keys normally live in the merged file
+                // under the fallback namespace.
+                let catalog = mergedTranslations?.[fallbackNs];
+                if (catalog === undefined) {
+                    // The fallback namespace may live in its own file outside the merged
+                    // one (split out and hidden via `ignoreNamespaces`, #287). Only
+                    // reachable when `output` resolves it to a separate path.
+                    const nsPath = resolve(process.cwd(), getOutputPath(config.extract.output, locale, fallbackNs));
+                    if (nsPath !== getMergedPath(locale)) {
+                        catalog = (await loadTranslationFile(nsPath)) ?? undefined;
+                    }
+                }
+                if (catalog === undefined && isPrimary && ignoreNamespaces.has(fallbackNs)) {
+                    console.warn(`⚠️  fallbackNS "${fallbackNs}" is listed in ignoreNamespaces, but no translations for it were found — keys resolving through it will be reported as absent. If the namespace lives in its own file, use an \`output\` function that maps it to that path.`);
+                }
+                // If it's still not found, fall back to the top level of the merged
+                // file (flat, non-namespaced merged files).
+                fallbackCatalogs.set(fallbackNs, catalog ?? mergedTranslations ?? {});
+            }
+            else {
+                const nsPath = resolve(process.cwd(), getOutputPath(config.extract.output, locale, fallbackNs));
+                const catalog = await loadTranslationFile(nsPath);
+                if (!catalog && isPrimary && ignoreNamespaces.has(fallbackNs)) {
+                    console.warn(`⚠️  fallbackNS "${fallbackNs}" is listed in ignoreNamespaces, but no translations for it were found at "${nsPath}" — keys resolving through it will be reported as absent.`);
+                }
+                fallbackCatalogs.set(fallbackNs, catalog || {});
+            }
+        }
         for (const [ns, keysInNs] of keysByNs.entries()) {
             const translationsForNs = mergeNamespaces
                 // If mergedTranslations is a flat object (no nested namespace) prefer the root object
                 // when mergedTranslations[ns] is missing.
                 ? (mergedTranslations?.[ns] ?? mergedTranslations ?? {})
                 : await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, locale, ns))) || {};
-            // Load fallbackNS translations if configured (looked up in order, like the i18next runtime)
             const fallbackTranslationsList = [];
             for (const fallbackNs of fallbackNamespaces) {
                 if (ns === fallbackNs)
                     continue;
-                if (mergeNamespaces) {
-                    // In merged mode, fallbackNS keys are in mergedTranslations under the fallback namespace
-                    fallbackTranslationsList.push(mergedTranslations?.[fallbackNs] ?? mergedTranslations ?? {});
-                }
-                else {
-                    fallbackTranslationsList.push(await loadTranslationFile(resolve(process.cwd(), getOutputPath(config.extract.output, locale, fallbackNs))) || {});
-                }
+                fallbackTranslationsList.push(fallbackCatalogs.get(fallbackNs));
             }
             let translatedInNs = 0;
             let emptyInNs = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.71.2",
+  "version": "1.71.3",
   "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;AA8tC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CA6K9B"}
+{"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;AAyuC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CA6K9B"}

package/types/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAmC,MAAM,YAAY,CAAA;AAYvF;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAoDzF;AAsoBD;;GAEG;AACH,UAAU,aAAa;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuE/F"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAmC,MAAM,YAAY,CAAA;AAYvF;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAoDzF;AA4pBD;;GAEG;AACH,UAAU,aAAa;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuE/F"}