i18next-cli 1.67.3 → 1.67.5

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

@@ -112,6 +112,13 @@ class ASTVisitors {
                 // Type aliases → ExpressionResolver.sharedTypeAliasTable
                 this.expressionResolver.captureTypeAliasDeclaration(node);
                 break;
+            case 'TsInterfaceDeclaration':
+            case 'TSInterfaceDeclaration':
+            case 'TsInterfaceDecl':
+                // Interfaces → ExpressionResolver.objectTypeTable, so params typed by
+                // them (`{ size }: IProps`) resolve to their string-literal unions.
+                this.expressionResolver.captureInterfaceDeclaration(node);
+                break;
             case 'FunctionDeclaration':
             case 'FnDecl':
                 // Return-type annotations or inferred return values for t(fn()) patterns
@@ -167,6 +174,7 @@ class ASTVisitors {
         let isNewScope = false;
         let isNewClassScope = false;
         let paramTemporaries;
+        let paramObjectTemporaries;
         // ENTER CLASS SCOPE for class declarations / expressions and pre-register
         // class field initializers so that later `this.<field>` references inside
         // method bodies can inherit the namespace/keyPrefix from the field.
@@ -215,6 +223,31 @@ class ASTVisitors {
                 let ident;
                 if (!p)
                     continue;
+                // Destructured object param: `function f({ size }: IProps)`.
+                // Bind each destructured local name to its interface member's values.
+                const pat = p.pat ?? p.pattern ?? p;
+                if (pat.type === 'ObjectPattern') {
+                    const patType = pat.typeAnnotation?.typeAnnotation ?? pat.typeAnnotation;
+                    const members = this.expressionResolver.resolveTypeMembers(patType);
+                    if (members) {
+                        for (const prop of (pat.properties ?? [])) {
+                            // `{ size }` / `{ size = 'all' }` → AssignmentPatternProperty (local name is the key)
+                            // `{ size: s }` / `{ size: s = 'all' }` → KeyValuePatternProperty
+                            const memberName = prop?.key?.value;
+                            let localNode = prop?.type === 'KeyValuePatternProperty' ? prop.value : prop?.key;
+                            if (localNode?.type === 'AssignmentPattern')
+                                localNode = localNode.left;
+                            const localName = localNode?.type === 'Identifier' ? localNode.value : undefined;
+                            if (!memberName || !localName || !members[memberName])
+                                continue;
+                            this.expressionResolver.setTemporaryVariable(localName, members[memberName]);
+                            if (!paramTemporaries)
+                                paramTemporaries = [];
+                            paramTemporaries.push(localName);
+                        }
+                    }
+                    continue;
+                }
                 // direct identifier (arrow fn params etc)
                 if (p.type === 'Identifier')
                     ident = p;
@@ -367,6 +400,16 @@ class ASTVisitors {
                             paramTemporaries = [];
                         paramTemporaries.push(paramKey);
                     }
+                    else {
+                        // Object-shaped param (`props: IProps`) so `props.size` resolves.
+                        const members = this.expressionResolver.resolveTypeMembers(typeAnn);
+                        if (members) {
+                            this.expressionResolver.setTemporaryObjectVariable(paramKey, members);
+                            if (!paramObjectTemporaries)
+                                paramObjectTemporaries = [];
+                            paramObjectTemporaries.push(paramKey);
+                        }
+                    }
                 }
             }
         }
@@ -392,6 +435,11 @@ class ASTVisitors {
             case 'TsTypeAliasDecl':
                 this.expressionResolver.captureTypeAliasDeclaration(node);
                 break;
+            case 'TsInterfaceDeclaration':
+            case 'TSInterfaceDeclaration':
+            case 'TsInterfaceDecl':
+                this.expressionResolver.captureInterfaceDeclaration(node);
+                break;
             // pattern 3: capture function return types so `t(fn())` can be resolved
             case 'FunctionDeclaration':
             case 'FnDecl':
@@ -568,6 +616,11 @@ class ASTVisitors {
                     this.expressionResolver.deleteTemporaryVariable(name);
                 }
             }
+            if (paramObjectTemporaries) {
+                for (const name of paramObjectTemporaries) {
+                    this.expressionResolver.deleteTemporaryObjectVariable(name);
+                }
+            }
             this.scopeManager.exitScope();
         }
         // LEAVE CLASS SCOPE for classes

package/dist/cjs/extractor/core/extractor.js

@@ -241,14 +241,11 @@ 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 (0-based).
-        // SWC accumulates byte offsets across successive parse() calls and uses
-        // 1-based positions, so Module.span.start points to the first token,
-        // NOT to byte 0 of the source.  We derive the true base by subtracting
-        // the 0-based index of that first token in the source string.
-        const firstTokenIdx = astUtils.findFirstTokenIndex(code);
-        const spanBase = ast.span.start - firstTokenIdx;
-        astUtils.normalizeASTSpans(ast, spanBase);
+        // Normalize SWC span offsets so every span is a file-relative (0-based)
+        // character index.  SWC accumulates byte offsets across successive parse()
+        // calls and Module.span.start points to the first token, NOT to byte 0 of
+        // the source.
+        astUtils.normalizeSpansToCharIndices(ast, code);
         // "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);
@@ -348,8 +345,7 @@ async function preScanFile(file, astVisitors, config, logger$1 = new logger.Cons
                 throw new validation.ExtractorError('Failed to pre-scan file', file, err);
             }
         }
-        const firstTokenIdx = astUtils.findFirstTokenIndex(code);
-        astUtils.normalizeASTSpans(ast, ast.span.start - firstTokenIdx);
+        astUtils.normalizeSpansToCharIndices(ast, code);
         astVisitors.setCurrentFile(file, code);
         astVisitors.preScanForConstants(ast);
     }

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

@@ -168,6 +168,23 @@ function convertSpansToCharIndices(node, byteToChar) {
         }
     }
 }
+/**
+ * Normalises every span in a freshly parsed SWC AST to a file-relative UTF-16
+ * character index — the unit JavaScript strings, MagicString and
+ * `lineColumnFromOffset` all use.
+ *
+ * Combines the two steps that must always happen together: subtracting SWC's
+ * accumulated base (which is expressed in UTF-8 *bytes*, hence the
+ * `Buffer.byteLength` of the leading trivia) and converting the remaining byte
+ * offsets to char indices.
+ */
+function normalizeSpansToCharIndices(ast, code) {
+    const firstTokenByteIdx = Buffer.byteLength(code.slice(0, findFirstTokenIndex(code)), 'utf8');
+    normalizeASTSpans(ast, ast.span.start - firstTokenByteIdx);
+    const byteToChar = buildByteToCharMap(code);
+    if (byteToChar)
+        convertSpansToCharIndices(ast, byteToChar);
+}
 // ─── Ignore-comment helpers ──────────────────────────────────────────────────
 /**
  * Matches the shared ignore directive used by both the instrumenter and the
@@ -365,3 +382,4 @@ exports.getObjectProperty = getObjectProperty;
 exports.isSimpleTemplateLiteral = isSimpleTemplateLiteral;
 exports.lineColumnFromOffset = lineColumnFromOffset;
 exports.normalizeASTSpans = normalizeASTSpans;
+exports.normalizeSpansToCharIndices = normalizeSpansToCharIndices;

package/dist/cjs/extractor/parsers/expression-resolver.js

@@ -26,6 +26,13 @@ class ExpressionResolver {
     // Temporary per-scope variable overrides, used to inject .map() / .forEach()
     // callback parameters while the callback body is being walked.
     temporaryVariables = new Map();
+    // Shared (cross-file) table for object-shaped types: interfaces and object
+    // type aliases. Maps typeName -> { memberName: possible string values }.
+    // e.g. `interface IProps { size: ChangeType }` -> { IProps: { size: ['all','next'] } }
+    objectTypeTable = new Map();
+    // Temporary per-scope bindings for identifiers holding an object-shaped type,
+    // e.g. `function f(props: IProps)` -> { props: { size: ['all','next'] } }.
+    temporaryObjectVariables = new Map();
     constructor(hooks) {
         this.hooks = hooks;
     }
@@ -214,6 +221,13 @@ class ExpressionResolver {
             const tsType = node.typeAnnotation ?? node.typeAnn;
             if (!tsType)
                 return;
+            // `type IProps = { size: ChangeType }` — object shape, not a string union.
+            if (tsType.type === 'TsTypeLiteral') {
+                const members = this.collectObjectTypeMembers(tsType.members);
+                if (members)
+                    this.objectTypeTable.set(name, members);
+                return;
+            }
             const vals = this.resolvePossibleStringValuesFromType(tsType);
             if (vals.length > 0) {
                 this.typeAliasTable.set(name, vals);
@@ -225,6 +239,78 @@ class ExpressionResolver {
             // noop
         }
     }
+    /**
+     * Capture a TypeScript interface so that parameters typed by it
+     * (`function f({ size }: IProps)` / `f(props: IProps)`) can resolve their
+     * members to string-literal unions.
+     *
+     * SWC node shape: `TsInterfaceDeclaration` with `body.body` members.
+     */
+    captureInterfaceDeclaration(node) {
+        try {
+            const name = node?.id?.type === 'Identifier' ? node.id.value : undefined;
+            if (!name)
+                return;
+            const members = this.collectObjectTypeMembers(node?.body?.body);
+            if (members)
+                this.objectTypeTable.set(name, members);
+        }
+        catch {
+            // noop
+        }
+    }
+    /**
+     * Build `{ memberName: possibleStringValues }` for an object-shaped type
+     * (interface body or object type-literal members). Only members whose type
+     * resolves to a finite string set are kept; returns undefined when none do.
+     */
+    collectObjectTypeMembers(members) {
+        if (!Array.isArray(members))
+            return undefined;
+        const map = {};
+        for (const m of members) {
+            if (!m || m.type !== 'TsPropertySignature')
+                continue;
+            const memberName = m.key?.type === 'Identifier' ? m.key.value : m.key?.type === 'StringLiteral' ? m.key.value : undefined;
+            if (!memberName)
+                continue;
+            const tsType = m.typeAnnotation?.typeAnnotation ?? m.typeAnnotation;
+            if (!tsType)
+                continue;
+            const vals = this.resolvePossibleStringValuesFromType(tsType);
+            if (vals.length > 0)
+                map[memberName] = vals;
+        }
+        return Object.keys(map).length > 0 ? map : undefined;
+    }
+    /**
+     * Resolve a type annotation that refers to an object shape (interface, object
+     * type alias, or inline type literal) to its member → string values map.
+     */
+    resolveTypeMembers(tsType) {
+        try {
+            if (!tsType)
+                return undefined;
+            if (tsType.type === 'TsTypeLiteral') {
+                return this.collectObjectTypeMembers(tsType.members);
+            }
+            if (tsType.type === 'TsTypeReference' && tsType.typeName?.type === 'Identifier') {
+                return this.objectTypeTable.get(tsType.typeName.value);
+            }
+        }
+        catch { }
+        return undefined;
+    }
+    /**
+     * Temporarily bind an identifier to an object-shaped type's members, so that
+     * `props.size` inside the function body resolves to the member's values.
+     */
+    setTemporaryObjectVariable(name, members) {
+        this.temporaryObjectVariables.set(name, members);
+    }
+    deleteTemporaryObjectVariable(name) {
+        this.temporaryObjectVariables.delete(name);
+    }
     /**
      * Capture the return-type annotation of a function declaration so that
      * `t(fn())` calls can be expanded to all union members.
@@ -552,6 +638,17 @@ class ExpressionResolver {
                 const prop = expression.property;
                 // only handle simple identifier base + simple property (Identifier or computed StringLiteral)
                 if (obj.type === 'Identifier') {
+                    // Parameter typed by an interface / object type: `props.size`
+                    const objMembers = this.temporaryObjectVariables.get(obj.value);
+                    if (objMembers) {
+                        const propName = prop.type === 'Identifier'
+                            ? prop.value
+                            : prop.type === 'Computed' && prop.expression?.type === 'StringLiteral'
+                                ? prop.expression.value
+                                : undefined;
+                        if (propName && objMembers[propName])
+                            return objMembers[propName];
+                    }
                     const baseVar = this.variableTable.get(obj.value);
                     const baseShared = this.sharedEnumTable.get(obj.value);
                     const base = baseVar ?? baseShared;

package/dist/cjs/instrumenter/core/instrumenter.js

@@ -258,18 +258,11 @@ async function scanFileForCandidates(content, file, config) {
                 throw err;
             }
         }
-        // Normalize spans
-        const firstTokenIdx = astUtils.findFirstTokenIndex(content);
-        const spanBase = ast.span.start - firstTokenIdx;
-        astUtils.normalizeASTSpans(ast, spanBase);
-        // Convert byte offsets → char indices for files with multi-byte characters.
-        // SWC reports spans as UTF-8 byte offsets, but JavaScript strings and
-        // MagicString use UTF-16 code-unit indices. Without this conversion,
-        // every emoji / accented char / CJK char shifts all subsequent offsets.
-        const byteToChar = astUtils.buildByteToCharMap(content);
-        if (byteToChar) {
-            astUtils.convertSpansToCharIndices(ast, byteToChar);
-        }
+        // Normalize spans to file-relative char indices. SWC reports spans as UTF-8
+        // byte offsets, but JavaScript strings and MagicString use UTF-16 code-unit
+        // indices — without the conversion every emoji / accented char / CJK char
+        // shifts all subsequent offsets.
+        astUtils.normalizeSpansToCharIndices(ast, content);
         // Detect React function component boundaries
         detectComponentBoundaries(ast, content, components);
         // Visit AST to find string literals

package/dist/cjs/linter.js

@@ -601,11 +601,7 @@ class Linter extends node_events.EventEmitter {
                 // (findHardcodedStrings/lintInterpolationParams locate issues via text
                 // search and don't read spans, so this only affects ignore handling.)
                 try {
-                    const spanBase = ast.span.start - astUtils.findFirstTokenIndex(code);
-                    astUtils.normalizeASTSpans(ast, spanBase);
-                    const byteToChar = astUtils.buildByteToCharMap(code);
-                    if (byteToChar)
-                        astUtils.convertSpansToCharIndices(ast, byteToChar);
+                    astUtils.normalizeSpansToCharIndices(ast, code);
                 }
                 catch {
                     // If span normalisation fails for any reason, fall back to text-based

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

@@ -110,6 +110,13 @@ class ASTVisitors {
                 // Type aliases → ExpressionResolver.sharedTypeAliasTable
                 this.expressionResolver.captureTypeAliasDeclaration(node);
                 break;
+            case 'TsInterfaceDeclaration':
+            case 'TSInterfaceDeclaration':
+            case 'TsInterfaceDecl':
+                // Interfaces → ExpressionResolver.objectTypeTable, so params typed by
+                // them (`{ size }: IProps`) resolve to their string-literal unions.
+                this.expressionResolver.captureInterfaceDeclaration(node);
+                break;
             case 'FunctionDeclaration':
             case 'FnDecl':
                 // Return-type annotations or inferred return values for t(fn()) patterns
@@ -165,6 +172,7 @@ class ASTVisitors {
         let isNewScope = false;
         let isNewClassScope = false;
         let paramTemporaries;
+        let paramObjectTemporaries;
         // ENTER CLASS SCOPE for class declarations / expressions and pre-register
         // class field initializers so that later `this.<field>` references inside
         // method bodies can inherit the namespace/keyPrefix from the field.
@@ -213,6 +221,31 @@ class ASTVisitors {
                 let ident;
                 if (!p)
                     continue;
+                // Destructured object param: `function f({ size }: IProps)`.
+                // Bind each destructured local name to its interface member's values.
+                const pat = p.pat ?? p.pattern ?? p;
+                if (pat.type === 'ObjectPattern') {
+                    const patType = pat.typeAnnotation?.typeAnnotation ?? pat.typeAnnotation;
+                    const members = this.expressionResolver.resolveTypeMembers(patType);
+                    if (members) {
+                        for (const prop of (pat.properties ?? [])) {
+                            // `{ size }` / `{ size = 'all' }` → AssignmentPatternProperty (local name is the key)
+                            // `{ size: s }` / `{ size: s = 'all' }` → KeyValuePatternProperty
+                            const memberName = prop?.key?.value;
+                            let localNode = prop?.type === 'KeyValuePatternProperty' ? prop.value : prop?.key;
+                            if (localNode?.type === 'AssignmentPattern')
+                                localNode = localNode.left;
+                            const localName = localNode?.type === 'Identifier' ? localNode.value : undefined;
+                            if (!memberName || !localName || !members[memberName])
+                                continue;
+                            this.expressionResolver.setTemporaryVariable(localName, members[memberName]);
+                            if (!paramTemporaries)
+                                paramTemporaries = [];
+                            paramTemporaries.push(localName);
+                        }
+                    }
+                    continue;
+                }
                 // direct identifier (arrow fn params etc)
                 if (p.type === 'Identifier')
                     ident = p;
@@ -365,6 +398,16 @@ class ASTVisitors {
                             paramTemporaries = [];
                         paramTemporaries.push(paramKey);
                     }
+                    else {
+                        // Object-shaped param (`props: IProps`) so `props.size` resolves.
+                        const members = this.expressionResolver.resolveTypeMembers(typeAnn);
+                        if (members) {
+                            this.expressionResolver.setTemporaryObjectVariable(paramKey, members);
+                            if (!paramObjectTemporaries)
+                                paramObjectTemporaries = [];
+                            paramObjectTemporaries.push(paramKey);
+                        }
+                    }
                 }
             }
         }
@@ -390,6 +433,11 @@ class ASTVisitors {
             case 'TsTypeAliasDecl':
                 this.expressionResolver.captureTypeAliasDeclaration(node);
                 break;
+            case 'TsInterfaceDeclaration':
+            case 'TSInterfaceDeclaration':
+            case 'TsInterfaceDecl':
+                this.expressionResolver.captureInterfaceDeclaration(node);
+                break;
             // pattern 3: capture function return types so `t(fn())` can be resolved
             case 'FunctionDeclaration':
             case 'FnDecl':
@@ -566,6 +614,11 @@ class ASTVisitors {
                     this.expressionResolver.deleteTemporaryVariable(name);
                 }
             }
+            if (paramObjectTemporaries) {
+                for (const name of paramObjectTemporaries) {
+                    this.expressionResolver.deleteTemporaryObjectVariable(name);
+                }
+            }
             this.scopeManager.exitScope();
         }
         // LEAVE CLASS SCOPE for classes

package/dist/esm/extractor/core/extractor.js

@@ -8,7 +8,7 @@ import { getTranslations } from './translation-manager.js';
 import { validateExtractorConfig, ExtractorError } from '../../utils/validation.js';
 import { ConflictError } from '../plugin-manager.js';
 import { extractKeysFromComments } from '../parsers/comment-parser.js';
-import { findFirstTokenIndex, normalizeASTSpans } from '../parsers/ast-utils.js';
+import { normalizeSpansToCharIndices } 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';
@@ -239,14 +239,11 @@ 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 (0-based).
-        // SWC accumulates byte offsets across successive parse() calls and uses
-        // 1-based positions, so Module.span.start points to the first token,
-        // NOT to byte 0 of the source.  We derive the true base by subtracting
-        // the 0-based index of that first token in the source string.
-        const firstTokenIdx = findFirstTokenIndex(code);
-        const spanBase = ast.span.start - firstTokenIdx;
-        normalizeASTSpans(ast, spanBase);
+        // Normalize SWC span offsets so every span is a file-relative (0-based)
+        // character index.  SWC accumulates byte offsets across successive parse()
+        // calls and Module.span.start points to the first token, NOT to byte 0 of
+        // the source.
+        normalizeSpansToCharIndices(ast, code);
         // "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);
@@ -346,8 +343,7 @@ async function preScanFile(file, astVisitors, config, logger = new ConsoleLogger
                 throw new ExtractorError('Failed to pre-scan file', file, err);
             }
         }
-        const firstTokenIdx = findFirstTokenIndex(code);
-        normalizeASTSpans(ast, ast.span.start - firstTokenIdx);
+        normalizeSpansToCharIndices(ast, code);
         astVisitors.setCurrentFile(file, code);
         astVisitors.preScanForConstants(ast);
     }

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

@@ -166,6 +166,23 @@ function convertSpansToCharIndices(node, byteToChar) {
         }
     }
 }
+/**
+ * Normalises every span in a freshly parsed SWC AST to a file-relative UTF-16
+ * character index — the unit JavaScript strings, MagicString and
+ * `lineColumnFromOffset` all use.
+ *
+ * Combines the two steps that must always happen together: subtracting SWC's
+ * accumulated base (which is expressed in UTF-8 *bytes*, hence the
+ * `Buffer.byteLength` of the leading trivia) and converting the remaining byte
+ * offsets to char indices.
+ */
+function normalizeSpansToCharIndices(ast, code) {
+    const firstTokenByteIdx = Buffer.byteLength(code.slice(0, findFirstTokenIndex(code)), 'utf8');
+    normalizeASTSpans(ast, ast.span.start - firstTokenByteIdx);
+    const byteToChar = buildByteToCharMap(code);
+    if (byteToChar)
+        convertSpansToCharIndices(ast, byteToChar);
+}
 // ─── Ignore-comment helpers ──────────────────────────────────────────────────
 /**
  * Matches the shared ignore directive used by both the instrumenter and the
@@ -353,4 +370,4 @@ function getObjectPropValue(object, propName, identifierResolver) {
     return undefined;
 }
 
-export { buildByteToCharMap, collectIgnoredLineRanges, convertSpansToCharIndices, findFirstTokenIndex, getObjectPropValue, getObjectPropValueExpression, getObjectProperty, isSimpleTemplateLiteral, lineColumnFromOffset, normalizeASTSpans };
+export { buildByteToCharMap, collectIgnoredLineRanges, convertSpansToCharIndices, findFirstTokenIndex, getObjectPropValue, getObjectPropValueExpression, getObjectProperty, isSimpleTemplateLiteral, lineColumnFromOffset, normalizeASTSpans, normalizeSpansToCharIndices };

package/dist/esm/extractor/parsers/expression-resolver.js

@@ -24,6 +24,13 @@ class ExpressionResolver {
     // Temporary per-scope variable overrides, used to inject .map() / .forEach()
     // callback parameters while the callback body is being walked.
     temporaryVariables = new Map();
+    // Shared (cross-file) table for object-shaped types: interfaces and object
+    // type aliases. Maps typeName -> { memberName: possible string values }.
+    // e.g. `interface IProps { size: ChangeType }` -> { IProps: { size: ['all','next'] } }
+    objectTypeTable = new Map();
+    // Temporary per-scope bindings for identifiers holding an object-shaped type,
+    // e.g. `function f(props: IProps)` -> { props: { size: ['all','next'] } }.
+    temporaryObjectVariables = new Map();
     constructor(hooks) {
         this.hooks = hooks;
     }
@@ -212,6 +219,13 @@ class ExpressionResolver {
             const tsType = node.typeAnnotation ?? node.typeAnn;
             if (!tsType)
                 return;
+            // `type IProps = { size: ChangeType }` — object shape, not a string union.
+            if (tsType.type === 'TsTypeLiteral') {
+                const members = this.collectObjectTypeMembers(tsType.members);
+                if (members)
+                    this.objectTypeTable.set(name, members);
+                return;
+            }
             const vals = this.resolvePossibleStringValuesFromType(tsType);
             if (vals.length > 0) {
                 this.typeAliasTable.set(name, vals);
@@ -223,6 +237,78 @@ class ExpressionResolver {
             // noop
         }
     }
+    /**
+     * Capture a TypeScript interface so that parameters typed by it
+     * (`function f({ size }: IProps)` / `f(props: IProps)`) can resolve their
+     * members to string-literal unions.
+     *
+     * SWC node shape: `TsInterfaceDeclaration` with `body.body` members.
+     */
+    captureInterfaceDeclaration(node) {
+        try {
+            const name = node?.id?.type === 'Identifier' ? node.id.value : undefined;
+            if (!name)
+                return;
+            const members = this.collectObjectTypeMembers(node?.body?.body);
+            if (members)
+                this.objectTypeTable.set(name, members);
+        }
+        catch {
+            // noop
+        }
+    }
+    /**
+     * Build `{ memberName: possibleStringValues }` for an object-shaped type
+     * (interface body or object type-literal members). Only members whose type
+     * resolves to a finite string set are kept; returns undefined when none do.
+     */
+    collectObjectTypeMembers(members) {
+        if (!Array.isArray(members))
+            return undefined;
+        const map = {};
+        for (const m of members) {
+            if (!m || m.type !== 'TsPropertySignature')
+                continue;
+            const memberName = m.key?.type === 'Identifier' ? m.key.value : m.key?.type === 'StringLiteral' ? m.key.value : undefined;
+            if (!memberName)
+                continue;
+            const tsType = m.typeAnnotation?.typeAnnotation ?? m.typeAnnotation;
+            if (!tsType)
+                continue;
+            const vals = this.resolvePossibleStringValuesFromType(tsType);
+            if (vals.length > 0)
+                map[memberName] = vals;
+        }
+        return Object.keys(map).length > 0 ? map : undefined;
+    }
+    /**
+     * Resolve a type annotation that refers to an object shape (interface, object
+     * type alias, or inline type literal) to its member → string values map.
+     */
+    resolveTypeMembers(tsType) {
+        try {
+            if (!tsType)
+                return undefined;
+            if (tsType.type === 'TsTypeLiteral') {
+                return this.collectObjectTypeMembers(tsType.members);
+            }
+            if (tsType.type === 'TsTypeReference' && tsType.typeName?.type === 'Identifier') {
+                return this.objectTypeTable.get(tsType.typeName.value);
+            }
+        }
+        catch { }
+        return undefined;
+    }
+    /**
+     * Temporarily bind an identifier to an object-shaped type's members, so that
+     * `props.size` inside the function body resolves to the member's values.
+     */
+    setTemporaryObjectVariable(name, members) {
+        this.temporaryObjectVariables.set(name, members);
+    }
+    deleteTemporaryObjectVariable(name) {
+        this.temporaryObjectVariables.delete(name);
+    }
     /**
      * Capture the return-type annotation of a function declaration so that
      * `t(fn())` calls can be expanded to all union members.
@@ -550,6 +636,17 @@ class ExpressionResolver {
                 const prop = expression.property;
                 // only handle simple identifier base + simple property (Identifier or computed StringLiteral)
                 if (obj.type === 'Identifier') {
+                    // Parameter typed by an interface / object type: `props.size`
+                    const objMembers = this.temporaryObjectVariables.get(obj.value);
+                    if (objMembers) {
+                        const propName = prop.type === 'Identifier'
+                            ? prop.value
+                            : prop.type === 'Computed' && prop.expression?.type === 'StringLiteral'
+                                ? prop.expression.value
+                                : undefined;
+                        if (propName && objMembers[propName])
+                            return objMembers[propName];
+                    }
                     const baseVar = this.variableTable.get(obj.value);
                     const baseShared = this.sharedEnumTable.get(obj.value);
                     const base = baseVar ?? baseShared;

package/dist/esm/instrumenter/core/instrumenter.js

@@ -10,7 +10,7 @@ import { createKeyRegistry, generateKeyFromContent } from './key-generator.js';
 import { createSpinnerLike } from '../../utils/wrap-ora.js';
 import { ConsoleLogger } from '../../utils/logger.js';
 import { ignoredAttributeSet } from '../../utils/jsx-attributes.js';
-import { findFirstTokenIndex, normalizeASTSpans, buildByteToCharMap, convertSpansToCharIndices, collectIgnoredLineRanges } from '../../extractor/parsers/ast-utils.js';
+import { normalizeSpansToCharIndices, collectIgnoredLineRanges } from '../../extractor/parsers/ast-utils.js';
 import { getOutputPath } from '../../utils/file-utils.js';
 
 /**
@@ -252,18 +252,11 @@ async function scanFileForCandidates(content, file, config) {
                 throw err;
             }
         }
-        // Normalize spans
-        const firstTokenIdx = findFirstTokenIndex(content);
-        const spanBase = ast.span.start - firstTokenIdx;
-        normalizeASTSpans(ast, spanBase);
-        // Convert byte offsets → char indices for files with multi-byte characters.
-        // SWC reports spans as UTF-8 byte offsets, but JavaScript strings and
-        // MagicString use UTF-16 code-unit indices. Without this conversion,
-        // every emoji / accented char / CJK char shifts all subsequent offsets.
-        const byteToChar = buildByteToCharMap(content);
-        if (byteToChar) {
-            convertSpansToCharIndices(ast, byteToChar);
-        }
+        // Normalize spans to file-relative char indices. SWC reports spans as UTF-8
+        // byte offsets, but JavaScript strings and MagicString use UTF-16 code-unit
+        // indices — without the conversion every emoji / accented char / CJK char
+        // shifts all subsequent offsets.
+        normalizeSpansToCharIndices(ast, content);
         // Detect React function component boundaries
         detectComponentBoundaries(ast, content, components);
         // Visit AST to find string literals

package/dist/esm/linter.js

@@ -7,7 +7,7 @@ import { styleText } from 'node:util';
 import { ConsoleLogger } from './utils/logger.js';
 import { createSpinnerLike } from './utils/wrap-ora.js';
 import { acceptedTags, translatableAttributes, ignoredTags, ignoredAttributeLowerSet } from './utils/jsx-attributes.js';
-import { findFirstTokenIndex, normalizeASTSpans, buildByteToCharMap, convertSpansToCharIndices, collectIgnoredLineRanges, lineColumnFromOffset } from './extractor/parsers/ast-utils.js';
+import { normalizeSpansToCharIndices, collectIgnoredLineRanges, lineColumnFromOffset } from './extractor/parsers/ast-utils.js';
 import { matchesFunctionPattern } from './extractor/utils/function-matcher.js';
 
 /**
@@ -599,11 +599,7 @@ class Linter extends EventEmitter {
                 // (findHardcodedStrings/lintInterpolationParams locate issues via text
                 // search and don't read spans, so this only affects ignore handling.)
                 try {
-                    const spanBase = ast.span.start - findFirstTokenIndex(code);
-                    normalizeASTSpans(ast, spanBase);
-                    const byteToChar = buildByteToCharMap(code);
-                    if (byteToChar)
-                        convertSpansToCharIndices(ast, byteToChar);
+                    normalizeSpansToCharIndices(ast, code);
                 }
                 catch {
                     // If span normalisation fails for any reason, fall back to text-based

package/package.json

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

package/types/extractor/core/ast-visitors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-visitors.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/ast-visitors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAQ,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAItE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAAiB;IAE9B,IAAW,UAAU,gBAEpB;IAED,SAAgB,YAAY,EAAE,YAAY,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAuB;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;IAEhC;;;;;;OAMG;gBAED,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,eAAe,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAiCzC;;;;;;;;;;;;;OAaG;IACI,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;;;;OAKG;IACI,KAAK,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI;IAyZZ;;;;;;;;OAQG;IACH,OAAO,CAAC,gCAAgC;IAqDxC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;;;;;;;OAQG;IACI,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5D;;OAEG;IACI,cAAc,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxD;;;;;;OAMG;IACI,cAAc,IAAK,MAAM;IAIhC;;OAEG;IACI,cAAc,IAAK,MAAM;CAGjC"}
+{"version":3,"file":"ast-visitors.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/ast-visitors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAQ,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAItE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAAiB;IAE9B,IAAW,UAAU,gBAEpB;IAED,SAAgB,YAAY,EAAE,YAAY,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAuB;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;IAEhC;;;;;;OAMG;gBAED,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,eAAe,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAiCzC;;;;;;;;;;;;;OAaG;IACI,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;;OAKG;IACI,KAAK,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI;IAocZ;;;;;;;;OAQG;IACH,OAAO,CAAC,gCAAgC;IAqDxC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;;;;;;;OAQG;IACI,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5D;;OAEG;IACI,cAAc,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxD;;;;;;OAMG;IACI,cAAc,IAAK,MAAM;IAIhC;;OAEG;IACI,cAAc,IAAK,MAAM;CAGjC"}

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,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAO5G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK/C;;;;;;;;;;;;;;;;;;;;;;;;;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,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAwExF;AAwBD;;;;;;;;;;;;;;;;;;;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,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAoJf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO1K"}
+{"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,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAO5G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK/C;;;;;;;;;;;;;;;;;;;;;;;;;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,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAwExF;AAwBD;;;;;;;;;;;;;;;;;;;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,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAiJf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO1K"}

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

@@ -54,6 +54,17 @@ export declare function buildByteToCharMap(content: string): number[] | null;
  * pre-built lookup table.
  */
 export declare function convertSpansToCharIndices(node: any, byteToChar: number[]): void;
+/**
+ * Normalises every span in a freshly parsed SWC AST to a file-relative UTF-16
+ * character index — the unit JavaScript strings, MagicString and
+ * `lineColumnFromOffset` all use.
+ *
+ * Combines the two steps that must always happen together: subtracting SWC's
+ * accumulated base (which is expressed in UTF-8 *bytes*, hence the
+ * `Buffer.byteLength` of the leading trivia) and converting the remaining byte
+ * offsets to char indices.
+ */
+export declare function normalizeSpansToCharIndices(ast: any, code: string): void;
 /**
  * Scans `code` for ignore-directive comments and returns a Set of 1-based line
  * numbers whose issues/strings should be suppressed.

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;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQhH;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA0BpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAwBhF;AAgBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CA4D7E;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,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAkB9J"}
+{"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,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQhH;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA0BpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAwBhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKzE;AAgBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CA4D7E;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,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAkB9J"}

package/types/extractor/parsers/expression-resolver.d.ts

@@ -9,6 +9,8 @@ export declare class ExpressionResolver {
     private sharedTypeAliasTable;
     private sharedFunctionReturnTable;
     private temporaryVariables;
+    private objectTypeTable;
+    private temporaryObjectVariables;
     constructor(hooks: ASTVisitorHooks);
     /**
      * Clear per-file captured variables. Enums / shared maps are kept.
@@ -34,6 +36,31 @@ export declare class ExpressionResolver {
      * SWC node shapes: `TsTypeAliasDeclaration` / `TsTypeAliasDecl`
      */
     captureTypeAliasDeclaration(node: any): void;
+    /**
+     * Capture a TypeScript interface so that parameters typed by it
+     * (`function f({ size }: IProps)` / `f(props: IProps)`) can resolve their
+     * members to string-literal unions.
+     *
+     * SWC node shape: `TsInterfaceDeclaration` with `body.body` members.
+     */
+    captureInterfaceDeclaration(node: any): void;
+    /**
+     * Build `{ memberName: possibleStringValues }` for an object-shaped type
+     * (interface body or object type-literal members). Only members whose type
+     * resolves to a finite string set are kept; returns undefined when none do.
+     */
+    private collectObjectTypeMembers;
+    /**
+     * Resolve a type annotation that refers to an object shape (interface, object
+     * type alias, or inline type literal) to its member → string values map.
+     */
+    resolveTypeMembers(tsType: any): Record<string, string[]> | undefined;
+    /**
+     * Temporarily bind an identifier to an object-shaped type's members, so that
+     * `props.size` inside the function body resolves to the member's values.
+     */
+    setTemporaryObjectVariable(name: string, members: Record<string, string[]>): void;
+    deleteTemporaryObjectVariable(name: string): void;
     /**
      * Capture the return-type annotation of a function declaration so that
      * `t(fn())` calls can be expanded to all union members.

package/types/extractor/parsers/expression-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression-resolver.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/expression-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,WAAW,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAK9B,OAAO,CAAC,aAAa,CAA4D;IAGjF,OAAO,CAAC,eAAe,CAAiD;IAIxE,OAAO,CAAC,cAAc,CAAmC;IAIzD,OAAO,CAAC,mBAAmB,CAAmC;IAI9D,OAAO,CAAC,oBAAoB,CAAmC;IAM/D,OAAO,CAAC,yBAAyB,CAAmC;IAIpE,OAAO,CAAC,kBAAkB,CAAmC;gBAEhD,KAAK,EAAE,eAAe;IAInC;;OAEG;IACI,gBAAgB,IAAK,IAAI;IAMhC;;;;;;;;;OASG;IACH,yBAAyB,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IA2J3C;;;;;;;OAOG;IACH,2BAA2B,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAkB7C;;;;;;;;;OASG;IACH,0BAA0B,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAqC5C;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;IA6CzC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;OAIG;IACI,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlE;;OAEG;IACI,uBAAuB,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAInD;;;;OAIG;IACI,yBAAyB,CAAE,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE;IAQxD;;;OAGG;IACI,iBAAiB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAQ7D;;;;OAIG;IACI,YAAY,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAQtE;;;;;OAKG;IACH,sBAAsB,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAwBxC;;;;;;;OAOG;IACH,kCAAkC,CAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE;IAKrE;;;;;;;OAOG;IACH,8BAA8B,CAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE;IAKjE;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,yCAAyC;IA2NjD,OAAO,CAAC,mCAAmC;IAiH3C;;;;;;OAMG;IACH,OAAO,CAAC,6CAA6C;IAyBrD;;;;;;OAMG;IACH,OAAO,CAAC,kDAAkD;CAwB3D"}
+{"version":3,"file":"expression-resolver.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/expression-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,WAAW,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAK9B,OAAO,CAAC,aAAa,CAA4D;IAGjF,OAAO,CAAC,eAAe,CAAiD;IAIxE,OAAO,CAAC,cAAc,CAAmC;IAIzD,OAAO,CAAC,mBAAmB,CAAmC;IAI9D,OAAO,CAAC,oBAAoB,CAAmC;IAM/D,OAAO,CAAC,yBAAyB,CAAmC;IAIpE,OAAO,CAAC,kBAAkB,CAAmC;IAK7D,OAAO,CAAC,eAAe,CAAmD;IAI1E,OAAO,CAAC,wBAAwB,CAAmD;gBAEtE,KAAK,EAAE,eAAe;IAInC;;OAEG;IACI,gBAAgB,IAAK,IAAI;IAMhC;;;;;;;;;OASG;IACH,yBAAyB,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IA2J3C;;;;;;;OAOG;IACH,2BAA2B,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAwB7C;;;;;;OAMG;IACH,2BAA2B,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAW7C;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAehC;;;OAGG;IACI,kBAAkB,CAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS;IAa7E;;;OAGG;IACI,0BAA0B,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAIlF,6BAA6B,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzD;;;;;;;;;OASG;IACH,0BAA0B,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAqC5C;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;IA6CzC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;OAIG;IACI,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlE;;OAEG;IACI,uBAAuB,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAInD;;;;OAIG;IACI,yBAAyB,CAAE,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE;IAQxD;;;OAGG;IACI,iBAAiB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAQ7D;;;;OAIG;IACI,YAAY,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAQtE;;;;;OAKG;IACH,sBAAsB,CAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAwBxC;;;;;;;OAOG;IACH,kCAAkC,CAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE;IAKrE;;;;;;;OAOG;IACH,8BAA8B,CAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE;IAKjE;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,yCAAyC;IAqOjD,OAAO,CAAC,mCAAmC;IAiH3C;;;;;;OAMG;IACH,OAAO,CAAC,6CAA6C;IAyBrD;;;;;;OAMG;IACH,OAAO,CAAC,kDAAkD;CAwB3D"}

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

@@ -1 +1 @@
-{"version":3,"file":"instrumenter.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/core/instrumenter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAA6B,sBAAsB,EAAiE,MAAM,gBAAgB,CAAA;AAU1N;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAoNjC;AAivCD;;GAEG;AACH,wBAAsB,mBAAmB,IAAK,OAAO,CAAC,OAAO,CAAC,CAU7D;AAID,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAA;AA6B/E;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,kBAAkB,CAAC,CA8B7E;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,OAAO,CAAC,CAOlE;AAwBD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxE;AAmYD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAAE,EAC7B,MAAM,EAAE,oBAAoB,EAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAoDf"}
+{"version":3,"file":"instrumenter.d.ts","sourceRoot":"","sources":["../../../src/instrumenter/core/instrumenter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAA6B,sBAAsB,EAAiE,MAAM,gBAAgB,CAAA;AAU1N;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAoNjC;AAyuCD;;GAEG;AACH,wBAAsB,mBAAmB,IAAK,OAAO,CAAC,OAAO,CAAC,CAU7D;AAID,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAA;AA6B/E;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,kBAAkB,CAAC,CA8B7E;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,OAAO,CAAC,CAOlE;AAwBD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,IAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxE;AAmYD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAAE,EAC7B,MAAM,EAAE,oBAAoB,EAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAoDf"}

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;AAO1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAA6B,MAAM,YAAY,CAAA;AA0epG,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,SAAS,EAAE,CAAC,CAAC;SACpC;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,EAAiD,CAAA;AAC7F,eAAO,MAAM,6BAA6B,EAAE,MAAM,EAAqD,CAAA;AAKvG,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAQ;gBAET,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,MAA4B;IAM/E,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;IAuIT,OAAO,CAAC,uBAAuB;YAOjB,qBAAqB;IAWnC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,0BAA0B;YAUpB,qBAAqB;YAgBrB,uBAAuB;CAgBtC;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,iBA0CnD"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAA6B,MAAM,YAAY,CAAA;AA0epG,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,SAAS,EAAE,CAAC,CAAC;SACpC;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,EAAiD,CAAA;AAC7F,eAAO,MAAM,6BAA6B,EAAE,MAAM,EAAqD,CAAA;AAKvG,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAQ;gBAET,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,MAA4B;IAM/E,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;IAoIT,OAAO,CAAC,uBAAuB;YAOjB,qBAAqB;IAWnC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,0BAA0B;YAUpB,qBAAqB;YAgBrB,uBAAuB;CAgBtC;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,iBA0CnD"}