i18next-cli 1.71.1 → 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.1'); // 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

@@ -342,13 +342,31 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         : nsKeys;
     // Prepare namespace pattern checking helpers
     const rawPreserve = config.extract.preservePatterns || [];
+    // Fast equivalent of matching a `${objectKey}.*` glob per object key: instead of
+    // testing O(objectKeys) regexes per key, walk the key's '.' boundaries and look
+    // each ancestor prefix up in the Set — O(key depth). See issue #286.
+    const isUnderObjectKey = (key) => {
+        if (objectKeys.size === 0)
+            return false;
+        let i = key.indexOf('.');
+        while (i !== -1) {
+            if (objectKeys.has(key.slice(0, i)))
+                return true;
+            i = key.indexOf('.', i + 1);
+        }
+        return false;
+    };
     // Helper to check if a key should be filtered out during extraction
     const shouldFilterKey = (key) => {
-        // 1) regex based patterns (existing behavior)
+        // 1) keys nested under a returnObjects / selector-API base key
+        if (isUnderObjectKey(key)) {
+            return true;
+        }
+        // 2) regex based patterns (existing behavior)
         if (preservePatterns.some(re => re.test(key))) {
             return true;
         }
-        // 2) namespace:* style patterns (respect nsSeparator)
+        // 3) namespace:* style patterns (respect nsSeparator)
         for (const rp of rawPreserve) {
             if (typeof rp !== 'string')
                 continue;
@@ -365,11 +383,15 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
     };
     // Helper to check if an existing key should be preserved
     const shouldPreserveExistingKey = (key) => {
-        // 1) regex-style patterns
+        // 1) keys nested under a returnObjects / selector-API base key
+        if (isUnderObjectKey(key)) {
+            return true;
+        }
+        // 2) regex-style patterns
         if (preservePatterns.some(re => re.test(key))) {
             return true;
         }
-        // 2) namespace:key patterns - check if pattern matches this namespace:key combination
+        // 3) namespace:key patterns - check if pattern matches this namespace:key combination
         for (const rp of rawPreserve) {
             if (typeof rp !== 'string')
                 continue;
@@ -575,6 +597,19 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
         }
     }
+    // Precompute every proper ancestor prefix (up to each keySeparator boundary) of the
+    // extracted keys, so the per-key "is this a leaf?" check below is a single Set lookup
+    // instead of an O(keys) scan per key. See issue #286.
+    const parentPrefixesInNewKeys = new Set();
+    if (typeof keySeparator === 'string') {
+        for (const { key } of filteredKeys) {
+            let i = key.indexOf(keySeparator);
+            while (i !== -1 && i < key.length) {
+                parentPrefixesInNewKeys.add(key.slice(0, i));
+                i = key.indexOf(keySeparator, i + 1);
+            }
+        }
+    }
     // 1. Build the object first, without any sorting.
     for (const { key, defaultValue: defaultValue$1, explicitDefault, hasCount, isExpandedPlural, isOrdinal } of filteredKeys) {
         // If this is a base plural key (hasCount true but not an already-expanded variant)
@@ -717,7 +752,7 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         // For flat keys there cannot be nested children, so treat them as leaves.
         const isLeafInNewKeys = keySeparator === false
             ? true
-            : !filteredKeys.some(otherKey => otherKey.key !== key && otherKey.key.startsWith(`${key}${keySeparator}`));
+            : !parentPrefixesInNewKeys.has(key);
         const isDerivedDefault = isDerivedFromKey(key, defaultValue$1, explicitDefault);
         // Determine if we should preserve an existing object
         const shouldPreserveObject = typeof existingValue === 'object' && existingValue !== null && (objectKeys.has(key) || // Explicit returnObjects
@@ -982,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) => {
@@ -991,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))) || {};
@@ -1099,8 +1145,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
     const patternsToPreserve = [...(config.extract.preservePatterns || [])];
     const indentation = config.extract.indentation ?? 2;
     for (const key of objectKeys) {
-        // Convert the object key to a glob pattern to preserve all its children
-        patternsToPreserve.push(`${key}.*`);
+        // Object keys are matched directly (and cheaply) against the objectKeys Set in
+        // buildNewTranslationsForNs (see isUnderObjectKey). Only a key that itself
+        // contains a wildcard still needs the glob-to-regex path.
+        if (key.includes('*')) {
+            patternsToPreserve.push(`${key}.*`);
+        }
     }
     const preservePatterns = patternsToPreserve.map(globToRegex);
     // Group keys by namespace. If the plugin recorded the namespace as implicit

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.1'); // 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

@@ -340,13 +340,31 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         : nsKeys;
     // Prepare namespace pattern checking helpers
     const rawPreserve = config.extract.preservePatterns || [];
+    // Fast equivalent of matching a `${objectKey}.*` glob per object key: instead of
+    // testing O(objectKeys) regexes per key, walk the key's '.' boundaries and look
+    // each ancestor prefix up in the Set — O(key depth). See issue #286.
+    const isUnderObjectKey = (key) => {
+        if (objectKeys.size === 0)
+            return false;
+        let i = key.indexOf('.');
+        while (i !== -1) {
+            if (objectKeys.has(key.slice(0, i)))
+                return true;
+            i = key.indexOf('.', i + 1);
+        }
+        return false;
+    };
     // Helper to check if a key should be filtered out during extraction
     const shouldFilterKey = (key) => {
-        // 1) regex based patterns (existing behavior)
+        // 1) keys nested under a returnObjects / selector-API base key
+        if (isUnderObjectKey(key)) {
+            return true;
+        }
+        // 2) regex based patterns (existing behavior)
         if (preservePatterns.some(re => re.test(key))) {
             return true;
         }
-        // 2) namespace:* style patterns (respect nsSeparator)
+        // 3) namespace:* style patterns (respect nsSeparator)
         for (const rp of rawPreserve) {
             if (typeof rp !== 'string')
                 continue;
@@ -363,11 +381,15 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
     };
     // Helper to check if an existing key should be preserved
     const shouldPreserveExistingKey = (key) => {
-        // 1) regex-style patterns
+        // 1) keys nested under a returnObjects / selector-API base key
+        if (isUnderObjectKey(key)) {
+            return true;
+        }
+        // 2) regex-style patterns
         if (preservePatterns.some(re => re.test(key))) {
             return true;
         }
-        // 2) namespace:key patterns - check if pattern matches this namespace:key combination
+        // 3) namespace:key patterns - check if pattern matches this namespace:key combination
         for (const rp of rawPreserve) {
             if (typeof rp !== 'string')
                 continue;
@@ -573,6 +595,19 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
         }
     }
+    // Precompute every proper ancestor prefix (up to each keySeparator boundary) of the
+    // extracted keys, so the per-key "is this a leaf?" check below is a single Set lookup
+    // instead of an O(keys) scan per key. See issue #286.
+    const parentPrefixesInNewKeys = new Set();
+    if (typeof keySeparator === 'string') {
+        for (const { key } of filteredKeys) {
+            let i = key.indexOf(keySeparator);
+            while (i !== -1 && i < key.length) {
+                parentPrefixesInNewKeys.add(key.slice(0, i));
+                i = key.indexOf(keySeparator, i + 1);
+            }
+        }
+    }
     // 1. Build the object first, without any sorting.
     for (const { key, defaultValue, explicitDefault, hasCount, isExpandedPlural, isOrdinal } of filteredKeys) {
         // If this is a base plural key (hasCount true but not an already-expanded variant)
@@ -715,7 +750,7 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         // For flat keys there cannot be nested children, so treat them as leaves.
         const isLeafInNewKeys = keySeparator === false
             ? true
-            : !filteredKeys.some(otherKey => otherKey.key !== key && otherKey.key.startsWith(`${key}${keySeparator}`));
+            : !parentPrefixesInNewKeys.has(key);
         const isDerivedDefault = isDerivedFromKey(key, defaultValue, explicitDefault);
         // Determine if we should preserve an existing object
         const shouldPreserveObject = typeof existingValue === 'object' && existingValue !== null && (objectKeys.has(key) || // Explicit returnObjects
@@ -980,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) => {
@@ -989,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))) || {};
@@ -1097,8 +1143,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
     const patternsToPreserve = [...(config.extract.preservePatterns || [])];
     const indentation = config.extract.indentation ?? 2;
     for (const key of objectKeys) {
-        // Convert the object key to a glob pattern to preserve all its children
-        patternsToPreserve.push(`${key}.*`);
+        // Object keys are matched directly (and cheaply) against the objectKeys Set in
+        // buildNewTranslationsForNs (see isUnderObjectKey). Only a key that itself
+        // contains a wildcard still needs the glob-to-regex path.
+        if (key.includes('*')) {
+            patternsToPreserve.push(`${key}.*`);
+        }
     }
     const preservePatterns = patternsToPreserve.map(globToRegex);
     // Group keys by namespace. If the plugin recorded the namespace as implicit

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.1",
+  "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;AA2rC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CAyK9B"}
+{"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"}