i18next-cli 1.42.2 → 1.42.4

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

@@ -9,6 +9,7 @@ var keyFinder = require('./key-finder.js');
 var translationManager = require('./translation-manager.js');
 var validation = require('../../utils/validation.js');
 var commentParser = require('../parsers/comment-parser.js');
+var astUtils = require('../parsers/ast-utils.js');
 var logger = require('../../utils/logger.js');
 var fileUtils = require('../../utils/file-utils.js');
 var funnelMsgTracker = require('../../utils/funnel-msg-tracker.js');
@@ -182,6 +183,10 @@ async function processFile(file, plugins, astVisitors, pluginContext, config, lo
                 throw new validation.ExtractorError('Failed to process file', file, err);
             }
         }
+        // Normalize SWC span offsets so every span is file-relative.
+        // SWC accumulates byte offsets across successive parse() calls,
+        // so without this, plugins would see positions beyond the file length.
+        astUtils.normalizeASTSpans(ast, ast.span.start);
         // "Wire up" the visitor's scope method to the context.
         // This avoids a circular dependency while giving plugins access to the scope.
         pluginContext.getVarFromScope = astVisitors.getVarFromScope.bind(astVisitors);

package/dist/cjs/extractor/parsers/ast-utils.js

@@ -1,5 +1,43 @@
 'use strict';
 
+/**
+ * Recursively normalizes all SWC span offsets in an AST by subtracting a base
+ * offset. SWC's `parse()` accumulates byte offsets across successive calls in
+ * the same process, so `span.start`/`span.end` values can exceed the length of
+ * the source file. Call this once on the root `Module` node right after parsing
+ * to make every span file-relative.
+ *
+ * @param node  - Any AST node (or the root Module)
+ * @param base  - The base offset to subtract (`ast.span.start`)
+ */
+function normalizeASTSpans(node, base) {
+    if (!node || typeof node !== 'object' || base === 0)
+        return;
+    // Normalize this node's own span
+    if (node.span && typeof node.span.start === 'number') {
+        node.span = {
+            ...node.span,
+            start: node.span.start - base,
+            end: node.span.end - base
+        };
+    }
+    // Recurse into every property (skip span itself to avoid double-processing)
+    for (const key of Object.keys(node)) {
+        if (key === 'span')
+            continue;
+        const child = node[key];
+        if (Array.isArray(child)) {
+            for (const item of child) {
+                if (item && typeof item === 'object') {
+                    normalizeASTSpans(item, base);
+                }
+            }
+        }
+        else if (child && typeof child === 'object') {
+            normalizeASTSpans(child, base);
+        }
+    }
+}
 /**
  * Finds and returns the full property node (KeyValueProperty) for the given
  * property name from an ObjectExpression.
@@ -83,3 +121,4 @@ exports.getObjectPropValue = getObjectPropValue;
 exports.getObjectPropValueExpression = getObjectPropValueExpression;
 exports.getObjectProperty = getObjectProperty;
 exports.isSimpleTemplateLiteral = isSimpleTemplateLiteral;
+exports.normalizeASTSpans = normalizeASTSpans;

package/dist/cjs/linter.js

@@ -119,8 +119,11 @@ function lintInterpolationParams(ast, code, config) {
                 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) {
-                        if (!paramKeys.includes(k)) {
+                        const root = k.split('.')[0];
+                        if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
                             issues.push({
                                 text: `Interpolation parameter "${k}" was not provided`,
                                 line: issueLineNumber,
@@ -128,8 +131,10 @@ function lintInterpolationParams(ast, code, config) {
                             });
                         }
                     }
+                    // For each provided param, check if it is used either directly or as the root of a dotted key.
                     for (const pk of paramKeys) {
-                        if (!keys.includes(pk)) {
+                        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,

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

@@ -7,6 +7,7 @@ import { findKeys } from './key-finder.js';
 import { getTranslations } from './translation-manager.js';
 import { validateExtractorConfig, ExtractorError } from '../../utils/validation.js';
 import { extractKeysFromComments } from '../parsers/comment-parser.js';
+import { normalizeASTSpans } from '../parsers/ast-utils.js';
 import { ConsoleLogger } from '../../utils/logger.js';
 import { inferFormatFromPath, loadRawJson5Content, serializeTranslationFile } from '../../utils/file-utils.js';
 import { shouldShowFunnel, recordFunnelShown } from '../../utils/funnel-msg-tracker.js';
@@ -180,6 +181,10 @@ async function processFile(file, plugins, astVisitors, pluginContext, config, lo
                 throw new ExtractorError('Failed to process file', file, err);
             }
         }
+        // Normalize SWC span offsets so every span is file-relative.
+        // SWC accumulates byte offsets across successive parse() calls,
+        // so without this, plugins would see positions beyond the file length.
+        normalizeASTSpans(ast, ast.span.start);
         // "Wire up" the visitor's scope method to the context.
         // This avoids a circular dependency while giving plugins access to the scope.
         pluginContext.getVarFromScope = astVisitors.getVarFromScope.bind(astVisitors);

package/dist/esm/extractor/parsers/ast-utils.js

@@ -1,3 +1,41 @@
+/**
+ * Recursively normalizes all SWC span offsets in an AST by subtracting a base
+ * offset. SWC's `parse()` accumulates byte offsets across successive calls in
+ * the same process, so `span.start`/`span.end` values can exceed the length of
+ * the source file. Call this once on the root `Module` node right after parsing
+ * to make every span file-relative.
+ *
+ * @param node  - Any AST node (or the root Module)
+ * @param base  - The base offset to subtract (`ast.span.start`)
+ */
+function normalizeASTSpans(node, base) {
+    if (!node || typeof node !== 'object' || base === 0)
+        return;
+    // Normalize this node's own span
+    if (node.span && typeof node.span.start === 'number') {
+        node.span = {
+            ...node.span,
+            start: node.span.start - base,
+            end: node.span.end - base
+        };
+    }
+    // Recurse into every property (skip span itself to avoid double-processing)
+    for (const key of Object.keys(node)) {
+        if (key === 'span')
+            continue;
+        const child = node[key];
+        if (Array.isArray(child)) {
+            for (const item of child) {
+                if (item && typeof item === 'object') {
+                    normalizeASTSpans(item, base);
+                }
+            }
+        }
+        else if (child && typeof child === 'object') {
+            normalizeASTSpans(child, base);
+        }
+    }
+}
 /**
  * Finds and returns the full property node (KeyValueProperty) for the given
  * property name from an ObjectExpression.
@@ -77,4 +115,4 @@ function getObjectPropValue(object, propName) {
     return undefined;
 }
 
-export { getObjectPropValue, getObjectPropValueExpression, getObjectProperty, isSimpleTemplateLiteral };
+export { getObjectPropValue, getObjectPropValueExpression, getObjectProperty, isSimpleTemplateLiteral, normalizeASTSpans };

package/dist/esm/linter.js

@@ -117,8 +117,11 @@ function lintInterpolationParams(ast, code, config) {
                 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) {
-                        if (!paramKeys.includes(k)) {
+                        const root = k.split('.')[0];
+                        if (!paramKeys.includes(k) && !paramKeys.includes(root)) {
                             issues.push({
                                 text: `Interpolation parameter "${k}" was not provided`,
                                 line: issueLineNumber,
@@ -126,8 +129,10 @@ function lintInterpolationParams(ast, code, config) {
                             });
                         }
                     }
+                    // For each provided param, check if it is used either directly or as the root of a dotted key.
                     for (const pk of paramKeys) {
-                        if (!keys.includes(pk)) {
+                        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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.42.2",
+  "version": "1.42.4",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {

package/types/extractor/core/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAKtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiGf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,sDAO3I"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAsGf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,sDAO3I"}

package/types/extractor/parsers/ast-utils.d.ts

@@ -1,4 +1,15 @@
 import type { Expression, ObjectExpression, TemplateLiteral } from '@swc/core';
+/**
+ * Recursively normalizes all SWC span offsets in an AST by subtracting a base
+ * offset. SWC's `parse()` accumulates byte offsets across successive calls in
+ * the same process, so `span.start`/`span.end` values can exceed the length of
+ * the source file. Call this once on the root `Module` node right after parsing
+ * to make every span file-relative.
+ *
+ * @param node  - Any AST node (or the root Module)
+ * @param base  - The base offset to subtract (`ast.span.start`)
+ */
+export declare function normalizeASTSpans(node: any, base: number): void;
 /**
  * Finds and returns the full property node (KeyValueProperty) for the given
  * property name from an ObjectExpression.

package/types/extractor/parsers/ast-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE1F;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qDAU5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKhH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAYrH"}
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qDAU5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKhH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAYrH"}

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;AAwI3D,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;AA6I3D,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE;QAAC;YACT,OAAO,EAAE,MAAM,CAAC;SACjB;KAAC,CAAC;IACH,IAAI,EAAE;QAAC;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;SAC1C;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,UAET,CAAA;AAC3B,eAAO,MAAM,6BAA6B,UAAgN,CAAA;AAK1P,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;gBAEvB,MAAM,EAAE,oBAAoB;IAKzC,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;CA6FV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB;;;;;;GAE5D;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,iBAkCnD;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;CACtC"}