i18next-cli 1.42.8 → 1.42.10

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.8'); // This string is replaced with the actual version at build time by rollup
+    .version('1.42.10'); // 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/config.js

@@ -114,7 +114,8 @@ async function loadConfig(configPath, logger$1 = new logger.ConsoleLogger()) {
     catch (error) {
         logger$1.error(`Error loading configuration from ${configPathFound}`);
         logger$1.error(error);
-        return null;
+        // Returning null causes ensureConfig to prompt "would you like to create one?"
+        throw new Error(`Error loading configuration from ${configPathFound}: ${error?.message || error?.name}`);
     }
 }
 /**

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

@@ -826,19 +826,13 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
         }
         else {
             // Find all namespaces that exist on disk for this locale.
-            // Use '**' so the glob crosses directory boundaries — namespaces
-            // can contain '/' and span multiple directory levels.
             const namespacesToProcess = new Set(keysByNS.keys());
-            const existingNsPattern = fileUtils.getOutputPath(config.extract.output, locale, '**');
+            const existingNsPattern = fileUtils.getOutputPath(config.extract.output, locale, '*');
             // Ensure glob receives POSIX-style separators so pattern matching works cross-platform (Windows -> backslashes)
             const existingNsGlobPattern = existingNsPattern.replace(/\\/g, '/');
             const existingNsFiles = await glob.glob(existingNsGlobPattern, { ignore: userIgnore });
             for (const file of existingNsFiles) {
-                // Recover the full (possibly multi-segment) namespace from the file path
-                // by matching it against the output template.
-                const ns = typeof config.extract.output === 'string'
-                    ? fileUtils.extractNamespaceFromPath(config.extract.output, locale, file)
-                    : undefined;
+                const ns = node_path.basename(file, node_path.extname(file));
                 if (ns) {
                     namespacesToProcess.add(ns);
                 }

package/dist/cjs/linter.js

@@ -9,6 +9,67 @@ var node_util = require('node:util');
 var logger = require('./utils/logger.js');
 var wrapOra = require('./utils/wrap-ora.js');
 
+/**
+ * Loads all translation values from the primary locale's JSON files and returns
+ * a flat Map of key -> translated string. Used by the interpolation linter so it
+ * can resolve a lookup key (e.g. "ABC") to its actual value ("hello {{name}}")
+ * and check interpolation parameters against the real string, not the key.
+ */
+async function loadPrimaryTranslationValues(config) {
+    const result = new Map();
+    const output = config.extract?.output;
+    if (!output || typeof output !== 'string')
+        return result;
+    const primaryLang = config.extract?.primaryLanguage ?? config.locales?.[0] ?? 'en';
+    // Candidate paths: substitute language + try common namespace names (including no namespace).
+    // This covers patterns like:
+    //   locales/{{language}}.json              -> no namespace token
+    //   locales/{{language}}/{{namespace}}.json -> substitute 'translation' (i18next default)
+    // Deliberately uses readFile directly (not glob) so it works correctly in test
+    // environments that mock fs/promises via memfs.
+    const candidatePaths = [];
+    if (!output.includes('{{namespace}}')) {
+        candidatePaths.push(output.replace(/\{\{language\}\}/g, primaryLang));
+    }
+    else {
+        for (const ns of ['translation', 'common', 'default']) {
+            candidatePaths.push(output
+                .replace(/\{\{language\}\}/g, primaryLang)
+                .replace(/\{\{namespace\}\}/g, ns));
+        }
+    }
+    // For each candidate, try: (1) the path as-is resolved from cwd, and
+    // (2) an absolute path with a leading '/' — the latter ensures we hit
+    // memfs in test environments where vol.fromJSON uses absolute paths like
+    // '/locales/en.json' but the output template is relative ('locales/...').
+    const seen = new Set();
+    const resolvedPaths = [];
+    for (const p of candidatePaths) {
+        const abs = node_path.resolve(p);
+        const leadingSlash = '/' + p.replace(/^\//, '');
+        for (const candidate of [abs, leadingSlash]) {
+            if (!seen.has(candidate)) {
+                seen.add(candidate);
+                resolvedPaths.push(candidate);
+            }
+        }
+    }
+    for (const filePath of resolvedPaths) {
+        try {
+            const raw = await promises.readFile(filePath, 'utf-8');
+            const json = JSON.parse(raw);
+            for (const [k, v] of Object.entries(json)) {
+                if (typeof v === 'string')
+                    result.set(k, v);
+            }
+            break; // stop after first successful read
+        }
+        catch {
+            // file doesn't exist or is malformed — try next candidate
+        }
+    }
+    return result;
+}
 // Helper to extract interpolation keys from a translation string
 function extractInterpolationKeys(str, config) {
     const prefix = config.extract.interpolationPrefix ?? '{{';
@@ -40,12 +101,17 @@ function isI18nextOptionKey(key) {
     return false;
 }
 // Helper to lint interpolation parameter errors in t() calls
-function lintInterpolationParams(ast, code, config) {
+function lintInterpolationParams(ast, code, config, translationValues) {
     const issues = [];
     // Only run if enabled (default true)
     const enabled = config.lint?.checkInterpolationParams !== false;
     if (!enabled)
         return issues;
+    // Helper for line number
+    const getLineNumber = (pos) => {
+        return code.substring(0, pos).split('\n').length;
+    };
+    const callSites = [];
     // Traverse AST for CallExpressions matching t() or i18n.t()
     function walk(node, ancestors) {
         if (!node || typeof node !== 'object')
@@ -103,10 +169,9 @@ function lintInterpolationParams(ast, code, config) {
             const arg1raw = node.arguments?.[1];
             const arg0 = arg0raw?.expression ?? arg0raw;
             const arg1 = arg1raw?.expression ?? arg1raw;
-            // Only check interpolation params if the first argument is a string literal (translation string)
+            // Only check interpolation params if the first argument is a string literal (translation key or string)
             if (arg0?.type === 'StringLiteral') {
-                const str = arg0.value;
-                const keys = extractInterpolationKeys(str, config);
+                const keyOrStr = arg0.value;
                 let paramKeys = [];
                 if (arg1?.type === 'ObjectExpression') {
                     paramKeys = arg1.properties
@@ -129,47 +194,56 @@ function lintInterpolationParams(ast, code, config) {
                 }
                 if (!Array.isArray(paramKeys))
                     paramKeys = [];
-                // Use text search for accurate line numbers (SWC spans use global byte offsets, not per-file)
+                // Resolve the actual translation string to check against:
+                // fix — if the first arg is a lookup key (no interpolation markers of its own)
+                // and we have a loaded translation map, use the translated value instead.
+                const resolvedStr = translationValues?.get(keyOrStr) ?? keyOrStr;
                 const searchText = arg0.raw ?? `"${arg0.value}"`;
-                const position = code.indexOf(searchText);
-                const issueLineNumber = position > -1 ? getLineNumber(position) : 1;
-                // Only check for unused parameters if there is at least one interpolation key in the string
-                if (keys.length > 0) {
-                    // i18next supports nested object access via dot notation (e.g. {{author.name}} with { author }).
-                    // For each interpolation key, check if the root (part before the first dot) matches a provided param.
-                    for (const k of keys) {
-                        const root = k.split('.')[0];
-                        if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
-                            issues.push({
-                                text: `Interpolation parameter "${k}" was not provided`,
-                                line: issueLineNumber,
-                                type: 'interpolation',
-                            });
-                        }
-                    }
-                    // 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({
-                                text: `Parameter "${pk}" is not used in translation string`,
-                                line: issueLineNumber,
-                                type: 'interpolation',
-                            });
-                        }
-                    }
-                }
+                callSites.push({ translationStr: resolvedStr, searchText, paramKeys });
             }
         }
     }
-    // Helper for line number
-    const getLineNumber = (pos) => {
-        return code.substring(0, pos).split('\n').length;
-    };
     walk(ast, []);
+    // 187 fix — process call sites in source order, advancing lastSearchIndex so that
+    // each occurrence of the same string literal finds its own line, not always the first.
+    let lastSearchIndex = 0;
+    for (const { translationStr, searchText, paramKeys } of callSites) {
+        const position = code.indexOf(searchText, lastSearchIndex);
+        if (position === -1)
+            continue;
+        lastSearchIndex = position + searchText.length;
+        const issueLineNumber = getLineNumber(position);
+        const keys = extractInterpolationKeys(translationStr, config);
+        // Only check for unused parameters if there is at least one interpolation key in the string
+        if (keys.length > 0) {
+            // i18next supports nested object access via dot notation (e.g. {{author.name}} with { author }).
+            // For each interpolation key, check if the root (part before the first dot) matches a provided param.
+            for (const k of keys) {
+                const root = k.split('.')[0];
+                if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
+                    issues.push({
+                        text: `Interpolation parameter "${k}" was not provided`,
+                        line: issueLineNumber,
+                        type: 'interpolation',
+                    });
+                }
+            }
+            // 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({
+                        text: `Parameter "${pk}" is not used in translation string`,
+                        line: issueLineNumber,
+                        type: 'interpolation',
+                    });
+                }
+            }
+        }
+    }
     return issues;
 }
 const recommendedAcceptedTags = [
@@ -211,6 +285,9 @@ class Linter extends node_events.EventEmitter {
                 ignore: [...defaultIgnore, ...extractIgnore, ...lintIgnore]
             });
             this.emit('progress', { message: `Analyzing ${sourceFiles.length} source files...` });
+            // Load translation values once so the interpolation linter can resolve lookup keys
+            // to their translated strings (fixes: key != value interpolation not detected)
+            const translationValues = await loadPrimaryTranslationValues(config);
             let totalIssues = 0;
             const issuesByFile = new Map();
             for (const file of sourceFiles) {
@@ -271,7 +348,7 @@ class Linter extends node_events.EventEmitter {
                 // Collect hardcoded string issues
                 const hardcodedStrings = findHardcodedStrings(ast, code, config);
                 // Collect interpolation parameter issues
-                const interpolationIssues = lintInterpolationParams(ast, code, config);
+                const interpolationIssues = lintInterpolationParams(ast, code, config, translationValues);
                 const allIssues = [...hardcodedStrings, ...interpolationIssues];
                 if (allIssues.length > 0) {
                     totalIssues += allIssues.length;

package/dist/cjs/utils/file-utils.js

@@ -45,43 +45,6 @@ function getOutputPath(outputTemplate, language, namespace) {
     out = out.replace(/\/\/+/g, '/');
     return node_path.normalize(out);
 }
-/**
- * Extracts the namespace value from a concrete file path by matching it against
- * the output template.
- *
- * Given a template like `src/{{namespace}}/locales/{{language}}.json` and a file
- * path like `src/widgets/component/locales/en.json`, this returns `widgets/component`.
- *
- * This handles multi-segment namespaces (namespaces containing `/`) which
- * `basename()` cannot recover.
- *
- * @param outputTemplate - The output path template string (must contain `{{namespace}}`)
- * @param language - The language value used when the file was generated
- * @param filePath - The concrete file path to extract the namespace from
- * @returns The namespace string, or `undefined` if the path doesn't match the template
- */
-function extractNamespaceFromPath(outputTemplate, language, filePath) {
-    // Build a regex from the template by escaping everything except the placeholders.
-    // Replace {{language}}/{{lng}} with the literal language value and
-    // {{namespace}} with a named capture group that matches one or more path segments.
-    const pattern = outputTemplate
-        // Normalise to forward slashes for matching
-        .replace(/\\/g, '/');
-    // Escape regex-special characters (but keep our placeholders intact first)
-    const nsPlaceholder = '{{namespace}}';
-    const parts = pattern.split(nsPlaceholder);
-    // Escape each part individually then rejoin with the capture group
-    const escaped = parts.map(p => p
-        .replace(/\{\{language\}\}|\{\{lng\}\}/g, () => escapeForRegex(language))
-        .replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-    // Don't anchor the start — the glob may return absolute or prefixed paths.
-    // Anchor only the end so that the namespace capture is unambiguous.
-    const regexStr = escaped.join('(.+)') + '$';
-    const normalized = filePath.replace(/\\/g, '/');
-    const m = new RegExp(regexStr).exec(normalized);
-    return m?.[1];
-}
-const escapeForRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 /**
  * Dynamically loads a translation file, supporting .json, .js, and .ts formats.
  * @param filePath - The path to the translation file.
@@ -193,7 +156,6 @@ function inferFormatFromPath(filePath, defaultFormat = 'json') {
     return defaultFormat || 'json';
 }
 
-exports.extractNamespaceFromPath = extractNamespaceFromPath;
 exports.getOutputPath = getOutputPath;
 exports.inferFormatFromPath = inferFormatFromPath;
 exports.loadRawJson5Content = loadRawJson5Content;

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.8'); // This string is replaced with the actual version at build time by rollup
+    .version('1.42.10'); // 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/config.js

@@ -112,7 +112,8 @@ async function loadConfig(configPath, logger = new ConsoleLogger()) {
     catch (error) {
         logger.error(`Error loading configuration from ${configPathFound}`);
         logger.error(error);
-        return null;
+        // Returning null causes ensureConfig to prompt "would you like to create one?"
+        throw new Error(`Error loading configuration from ${configPathFound}: ${error?.message || error?.name}`);
     }
 }
 /**

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

@@ -1,7 +1,7 @@
-import { resolve } from 'node:path';
+import { resolve, basename, extname } from 'node:path';
 import { glob } from 'glob';
 import { getNestedKeys, getNestedValue, setNestedValue } from '../../utils/nested-object.js';
-import { getOutputPath, loadTranslationFile, extractNamespaceFromPath } from '../../utils/file-utils.js';
+import { getOutputPath, loadTranslationFile } from '../../utils/file-utils.js';
 import { resolveDefaultValue } from '../../utils/default-value.js';
 
 // used for natural language check
@@ -824,19 +824,13 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
         }
         else {
             // Find all namespaces that exist on disk for this locale.
-            // Use '**' so the glob crosses directory boundaries — namespaces
-            // can contain '/' and span multiple directory levels.
             const namespacesToProcess = new Set(keysByNS.keys());
-            const existingNsPattern = getOutputPath(config.extract.output, locale, '**');
+            const existingNsPattern = getOutputPath(config.extract.output, locale, '*');
             // Ensure glob receives POSIX-style separators so pattern matching works cross-platform (Windows -> backslashes)
             const existingNsGlobPattern = existingNsPattern.replace(/\\/g, '/');
             const existingNsFiles = await glob(existingNsGlobPattern, { ignore: userIgnore });
             for (const file of existingNsFiles) {
-                // Recover the full (possibly multi-segment) namespace from the file path
-                // by matching it against the output template.
-                const ns = typeof config.extract.output === 'string'
-                    ? extractNamespaceFromPath(config.extract.output, locale, file)
-                    : undefined;
+                const ns = basename(file, extname(file));
                 if (ns) {
                     namespacesToProcess.add(ns);
                 }

package/dist/esm/linter.js

@@ -1,12 +1,73 @@
 import { glob } from 'glob';
 import { readFile } from 'node:fs/promises';
 import { parse } from '@swc/core';
-import { extname } from 'node:path';
+import { extname, resolve } from 'node:path';
 import { EventEmitter } from 'node:events';
 import { styleText } from 'node:util';
 import { ConsoleLogger } from './utils/logger.js';
 import { createSpinnerLike } from './utils/wrap-ora.js';
 
+/**
+ * Loads all translation values from the primary locale's JSON files and returns
+ * a flat Map of key -> translated string. Used by the interpolation linter so it
+ * can resolve a lookup key (e.g. "ABC") to its actual value ("hello {{name}}")
+ * and check interpolation parameters against the real string, not the key.
+ */
+async function loadPrimaryTranslationValues(config) {
+    const result = new Map();
+    const output = config.extract?.output;
+    if (!output || typeof output !== 'string')
+        return result;
+    const primaryLang = config.extract?.primaryLanguage ?? config.locales?.[0] ?? 'en';
+    // Candidate paths: substitute language + try common namespace names (including no namespace).
+    // This covers patterns like:
+    //   locales/{{language}}.json              -> no namespace token
+    //   locales/{{language}}/{{namespace}}.json -> substitute 'translation' (i18next default)
+    // Deliberately uses readFile directly (not glob) so it works correctly in test
+    // environments that mock fs/promises via memfs.
+    const candidatePaths = [];
+    if (!output.includes('{{namespace}}')) {
+        candidatePaths.push(output.replace(/\{\{language\}\}/g, primaryLang));
+    }
+    else {
+        for (const ns of ['translation', 'common', 'default']) {
+            candidatePaths.push(output
+                .replace(/\{\{language\}\}/g, primaryLang)
+                .replace(/\{\{namespace\}\}/g, ns));
+        }
+    }
+    // For each candidate, try: (1) the path as-is resolved from cwd, and
+    // (2) an absolute path with a leading '/' — the latter ensures we hit
+    // memfs in test environments where vol.fromJSON uses absolute paths like
+    // '/locales/en.json' but the output template is relative ('locales/...').
+    const seen = new Set();
+    const resolvedPaths = [];
+    for (const p of candidatePaths) {
+        const abs = resolve(p);
+        const leadingSlash = '/' + p.replace(/^\//, '');
+        for (const candidate of [abs, leadingSlash]) {
+            if (!seen.has(candidate)) {
+                seen.add(candidate);
+                resolvedPaths.push(candidate);
+            }
+        }
+    }
+    for (const filePath of resolvedPaths) {
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const json = JSON.parse(raw);
+            for (const [k, v] of Object.entries(json)) {
+                if (typeof v === 'string')
+                    result.set(k, v);
+            }
+            break; // stop after first successful read
+        }
+        catch {
+            // file doesn't exist or is malformed — try next candidate
+        }
+    }
+    return result;
+}
 // Helper to extract interpolation keys from a translation string
 function extractInterpolationKeys(str, config) {
     const prefix = config.extract.interpolationPrefix ?? '{{';
@@ -38,12 +99,17 @@ function isI18nextOptionKey(key) {
     return false;
 }
 // Helper to lint interpolation parameter errors in t() calls
-function lintInterpolationParams(ast, code, config) {
+function lintInterpolationParams(ast, code, config, translationValues) {
     const issues = [];
     // Only run if enabled (default true)
     const enabled = config.lint?.checkInterpolationParams !== false;
     if (!enabled)
         return issues;
+    // Helper for line number
+    const getLineNumber = (pos) => {
+        return code.substring(0, pos).split('\n').length;
+    };
+    const callSites = [];
     // Traverse AST for CallExpressions matching t() or i18n.t()
     function walk(node, ancestors) {
         if (!node || typeof node !== 'object')
@@ -101,10 +167,9 @@ function lintInterpolationParams(ast, code, config) {
             const arg1raw = node.arguments?.[1];
             const arg0 = arg0raw?.expression ?? arg0raw;
             const arg1 = arg1raw?.expression ?? arg1raw;
-            // Only check interpolation params if the first argument is a string literal (translation string)
+            // Only check interpolation params if the first argument is a string literal (translation key or string)
             if (arg0?.type === 'StringLiteral') {
-                const str = arg0.value;
-                const keys = extractInterpolationKeys(str, config);
+                const keyOrStr = arg0.value;
                 let paramKeys = [];
                 if (arg1?.type === 'ObjectExpression') {
                     paramKeys = arg1.properties
@@ -127,47 +192,56 @@ function lintInterpolationParams(ast, code, config) {
                 }
                 if (!Array.isArray(paramKeys))
                     paramKeys = [];
-                // Use text search for accurate line numbers (SWC spans use global byte offsets, not per-file)
+                // Resolve the actual translation string to check against:
+                // fix — if the first arg is a lookup key (no interpolation markers of its own)
+                // and we have a loaded translation map, use the translated value instead.
+                const resolvedStr = translationValues?.get(keyOrStr) ?? keyOrStr;
                 const searchText = arg0.raw ?? `"${arg0.value}"`;
-                const position = code.indexOf(searchText);
-                const issueLineNumber = position > -1 ? getLineNumber(position) : 1;
-                // Only check for unused parameters if there is at least one interpolation key in the string
-                if (keys.length > 0) {
-                    // i18next supports nested object access via dot notation (e.g. {{author.name}} with { author }).
-                    // For each interpolation key, check if the root (part before the first dot) matches a provided param.
-                    for (const k of keys) {
-                        const root = k.split('.')[0];
-                        if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
-                            issues.push({
-                                text: `Interpolation parameter "${k}" was not provided`,
-                                line: issueLineNumber,
-                                type: 'interpolation',
-                            });
-                        }
-                    }
-                    // 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({
-                                text: `Parameter "${pk}" is not used in translation string`,
-                                line: issueLineNumber,
-                                type: 'interpolation',
-                            });
-                        }
-                    }
-                }
+                callSites.push({ translationStr: resolvedStr, searchText, paramKeys });
             }
         }
     }
-    // Helper for line number
-    const getLineNumber = (pos) => {
-        return code.substring(0, pos).split('\n').length;
-    };
     walk(ast, []);
+    // 187 fix — process call sites in source order, advancing lastSearchIndex so that
+    // each occurrence of the same string literal finds its own line, not always the first.
+    let lastSearchIndex = 0;
+    for (const { translationStr, searchText, paramKeys } of callSites) {
+        const position = code.indexOf(searchText, lastSearchIndex);
+        if (position === -1)
+            continue;
+        lastSearchIndex = position + searchText.length;
+        const issueLineNumber = getLineNumber(position);
+        const keys = extractInterpolationKeys(translationStr, config);
+        // Only check for unused parameters if there is at least one interpolation key in the string
+        if (keys.length > 0) {
+            // i18next supports nested object access via dot notation (e.g. {{author.name}} with { author }).
+            // For each interpolation key, check if the root (part before the first dot) matches a provided param.
+            for (const k of keys) {
+                const root = k.split('.')[0];
+                if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
+                    issues.push({
+                        text: `Interpolation parameter "${k}" was not provided`,
+                        line: issueLineNumber,
+                        type: 'interpolation',
+                    });
+                }
+            }
+            // 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({
+                        text: `Parameter "${pk}" is not used in translation string`,
+                        line: issueLineNumber,
+                        type: 'interpolation',
+                    });
+                }
+            }
+        }
+    }
     return issues;
 }
 const recommendedAcceptedTags = [
@@ -209,6 +283,9 @@ class Linter extends EventEmitter {
                 ignore: [...defaultIgnore, ...extractIgnore, ...lintIgnore]
             });
             this.emit('progress', { message: `Analyzing ${sourceFiles.length} source files...` });
+            // Load translation values once so the interpolation linter can resolve lookup keys
+            // to their translated strings (fixes: key != value interpolation not detected)
+            const translationValues = await loadPrimaryTranslationValues(config);
             let totalIssues = 0;
             const issuesByFile = new Map();
             for (const file of sourceFiles) {
@@ -269,7 +346,7 @@ class Linter extends EventEmitter {
                 // Collect hardcoded string issues
                 const hardcodedStrings = findHardcodedStrings(ast, code, config);
                 // Collect interpolation parameter issues
-                const interpolationIssues = lintInterpolationParams(ast, code, config);
+                const interpolationIssues = lintInterpolationParams(ast, code, config, translationValues);
                 const allIssues = [...hardcodedStrings, ...interpolationIssues];
                 if (allIssues.length > 0) {
                     totalIssues += allIssues.length;

package/dist/esm/utils/file-utils.js

@@ -43,43 +43,6 @@ function getOutputPath(outputTemplate, language, namespace) {
     out = out.replace(/\/\/+/g, '/');
     return normalize(out);
 }
-/**
- * Extracts the namespace value from a concrete file path by matching it against
- * the output template.
- *
- * Given a template like `src/{{namespace}}/locales/{{language}}.json` and a file
- * path like `src/widgets/component/locales/en.json`, this returns `widgets/component`.
- *
- * This handles multi-segment namespaces (namespaces containing `/`) which
- * `basename()` cannot recover.
- *
- * @param outputTemplate - The output path template string (must contain `{{namespace}}`)
- * @param language - The language value used when the file was generated
- * @param filePath - The concrete file path to extract the namespace from
- * @returns The namespace string, or `undefined` if the path doesn't match the template
- */
-function extractNamespaceFromPath(outputTemplate, language, filePath) {
-    // Build a regex from the template by escaping everything except the placeholders.
-    // Replace {{language}}/{{lng}} with the literal language value and
-    // {{namespace}} with a named capture group that matches one or more path segments.
-    const pattern = outputTemplate
-        // Normalise to forward slashes for matching
-        .replace(/\\/g, '/');
-    // Escape regex-special characters (but keep our placeholders intact first)
-    const nsPlaceholder = '{{namespace}}';
-    const parts = pattern.split(nsPlaceholder);
-    // Escape each part individually then rejoin with the capture group
-    const escaped = parts.map(p => p
-        .replace(/\{\{language\}\}|\{\{lng\}\}/g, () => escapeForRegex(language))
-        .replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-    // Don't anchor the start — the glob may return absolute or prefixed paths.
-    // Anchor only the end so that the namespace capture is unambiguous.
-    const regexStr = escaped.join('(.+)') + '$';
-    const normalized = filePath.replace(/\\/g, '/');
-    const m = new RegExp(regexStr).exec(normalized);
-    return m?.[1];
-}
-const escapeForRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 /**
  * Dynamically loads a translation file, supporting .json, .js, and .ts formats.
  * @param filePath - The path to the translation file.
@@ -191,4 +154,4 @@ function inferFormatFromPath(filePath, defaultFormat = 'json') {
     return defaultFormat || 'json';
 }
 
-export { extractNamespaceFromPath, getOutputPath, inferFormatFromPath, loadRawJson5Content, loadTranslationFile, serializeTranslationFile };
+export { getOutputPath, inferFormatFromPath, loadRawJson5Content, loadTranslationFile, serializeTranslationFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.42.8",
+  "version": "1.42.10",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {
@@ -55,8 +55,8 @@
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-terser": "0.4.4",
     "@types/inquirer": "9.0.9",
-    "@types/node": "25.2.1",
-    "@types/react": "19.2.13",
+    "@types/node": "25.3.0",
+    "@types/react": "19.2.14",
     "@vitest/coverage-v8": "4.0.18",
     "eslint": "9.39.2",
     "eslint-plugin-import": "2.32.0",
@@ -74,12 +74,12 @@
     "chokidar": "5.0.0",
     "commander": "14.0.3",
     "execa": "9.6.1",
-    "glob": "13.0.1",
+    "glob": "13.0.6",
     "i18next-resources-for-ts": "2.0.0",
-    "inquirer": "13.2.2",
+    "inquirer": "13.2.5",
     "jiti": "2.6.1",
     "jsonc-parser": "3.3.1",
-    "minimatch": "10.1.2",
+    "minimatch": "10.2.2",
     "ora": "9.3.0",
     "react": "^19.2.4",
     "react-i18next": "^16.5.4"

package/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAc3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAE,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAEhF;AAgCD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA8CjI;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8B5H;AAyBD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB3E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAc3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAE,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAEhF;AAgCD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA+CjI;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8B5H;AAyBD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB3E"}

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,CAoK9B"}
+{"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,CA8J9B"}

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;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"}
+{"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;AAwP3D,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;;;;;;;CAgGV;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"}

package/types/utils/file-utils.d.ts

@@ -48,22 +48,6 @@ export declare function writeFileAsync(filePath: string, data: string): Promise<
  * - Normalizes duplicate slashes and returns a platform-correct path.
  */
 export declare function getOutputPath(outputTemplate: string | ((language: string, namespace?: string) => string) | undefined, language: string, namespace?: string): string;
-/**
- * Extracts the namespace value from a concrete file path by matching it against
- * the output template.
- *
- * Given a template like `src/{{namespace}}/locales/{{language}}.json` and a file
- * path like `src/widgets/component/locales/en.json`, this returns `widgets/component`.
- *
- * This handles multi-segment namespaces (namespaces containing `/`) which
- * `basename()` cannot recover.
- *
- * @param outputTemplate - The output path template string (must contain `{{namespace}}`)
- * @param language - The language value used when the file was generated
- * @param filePath - The concrete file path to extract the namespace from
- * @returns The namespace string, or `undefined` if the path doesn't match the template
- */
-export declare function extractNamespaceFromPath(outputTemplate: string, language: string, filePath: string): string | undefined;
 /**
  * Dynamically loads a translation file, supporting .json, .js, and .ts formats.
  * @param filePath - The path to the translation file.

package/types/utils/file-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAKpD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EACvF,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CA8BR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAwBpB;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAwChG;AAGD,wBAAsB,mBAAmB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,MAAM,GAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAU,EAChE,WAAW,GAAE,MAAM,GAAG,MAAU,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA6BR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAU,GACtE,WAAW,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC,CAO9D"}
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAKpD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EACvF,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CA8BR;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAwChG;AAGD,wBAAsB,mBAAmB,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,MAAM,GAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAU,EAChE,WAAW,GAAE,MAAM,GAAG,MAAU,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA6BR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAU,GACtE,WAAW,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC,CAO9D"}