i18next-cli 1.56.8 → 1.56.10

package/README.md

@@ -44,7 +44,7 @@ A unified, high-performance i18next CLI toolchain, powered by SWC.
 - **Translation Status**: Get a high-level overview or a detailed, key-by-key report of your project's translation completeness.
 - **Plugin System**: Extensible architecture for custom extraction patterns and file types (e.g., HTML, Handlebars).
 - **Legacy Migration**: Automatic migration from `i18next-parser` configurations.
-- **Cloud Integration**: Seamless integration with the [Locize](https://locize.com) translation management platform.
+- **Cloud Integration**: Seamless integration with the [Locize](https://www.locize.com?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme) translation management platform.
 
 ## Installation
 
@@ -253,7 +253,7 @@ npx i18next-cli lint
 
 ### `instrument`
 
-Scans your source code for hardcoded user-facing strings and instruments them with i18next translation calls. This is useful for adding i18next instrumentation to an existing codebase that wasn't built with internationalization in mind. You can see this in action in [this video](https://youtu.be/aWZnZXwGg34) or in [this blog post](https://www.locize.com/blog/i18next-cli-instrument).
+Scans your source code for hardcoded user-facing strings and instruments them with i18next translation calls. This is useful for adding i18next instrumentation to an existing codebase that wasn't built with internationalization in mind. You can see this in action in [this video](https://youtu.be/aWZnZXwGg34) or in [this blog post](https://www.locize.com/blog/i18next-cli-instrument?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme).
 
 > **⚠️ First-Step Tool:** The `instrument` command uses heuristic-based detection and is designed as a **first pass** to identify and suggest transformation candidates. It will **not catch 100% of cases**, and you should expect both false positives and false negatives. Always review the suggested transformations carefully before committing them to your codebase. Think of it as an intelligent code assistant, not an automated compiler.
 
@@ -1507,21 +1507,21 @@ This programmatic API gives you the same power as the CLI but with full control
 <h3 align="center">Gold Sponsors</h3>
 
 <p align="center">
-  <a href="https://www.locize.com/" target="_blank">
+  <a href="https://www.locize.com/?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme" target="_blank">
     <img src="https://raw.githubusercontent.com/i18next/i18next/master/assets/locize_sponsor_240.gif" width="240px">
   </a>
 </p>
 
 ---
 
-**From the creators of i18next: localization as a service - [Locize](https://www.locize.com)**
+**From the creators of i18next: localization as a service - [Locize](https://www.locize.com?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme)**
 
-A translation management system built around the i18next ecosystem - [Locize](https://locize.com).
+A translation management system built around the i18next ecosystem - [Locize](https://www.locize.com?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme).
 
-**Now with a [Free plan](https://locize.com/pricing) for small projects!** Perfect for hobbyists or getting started.
+**Now with a [Free plan](https://www.locize.com/pricing?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme) for small projects!** Perfect for hobbyists or getting started.
 
 ![Locize](https://www.locize.com/img/ads/github_locize.png)
 
-With using [Locize](https://www.locize.com/?utm_source=i18next_cli_readme&utm_medium=github) you directly support the future of i18next.
+With using [Locize](https://www.locize.com/?utm_source=i18next_cli_readme&utm_medium=github&utm_campaign=readme) you directly support the future of i18next.
 
 ---

package/dist/cjs/cli.js

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

@@ -165,7 +165,37 @@ class ASTVisitors {
         if (!node)
             return;
         let isNewScope = false;
+        let isNewClassScope = false;
         let paramTemporaries;
+        // 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.
+        if (node.type === 'ClassDeclaration' ||
+            node.type === 'ClassExpression' ||
+            node.type === 'ClassDecl' ||
+            node.type === 'ClassExpr') {
+            this.scopeManager.enterClassScope();
+            isNewClassScope = true;
+            const classBody = Array.isArray(node.body) ? node.body : (node.body?.body ?? []);
+            for (const member of classBody) {
+                if (!member || typeof member !== 'object')
+                    continue;
+                if (member.type === 'ClassProperty' ||
+                    member.type === 'PrivateProperty' ||
+                    member.type === 'PropertyDefinition' ||
+                    member.type === 'ClassPrivateProperty') {
+                    let fieldName;
+                    const key = member.key;
+                    if (key?.type === 'Identifier')
+                        fieldName = key.value ?? key.name;
+                    else if (key?.type === 'PrivateName')
+                        fieldName = '#' + (key.value ?? key.name ?? key.id?.value ?? key.id?.name);
+                    if (!fieldName)
+                        continue;
+                    this.scopeManager.registerClassField(fieldName, member.value);
+                }
+            }
+        }
         // ENTER SCOPE for functions
         // Accept many SWC/TS AST variants for function-like nodes (declarations, expressions, arrow functions)
         if (node.type === 'Function' ||
@@ -540,6 +570,10 @@ class ASTVisitors {
             }
             this.scopeManager.exitScope();
         }
+        // LEAVE CLASS SCOPE for classes
+        if (isNewClassScope) {
+            this.scopeManager.exitClassScope();
+        }
     }
     /**
      * If `node` is a call like `ARRAY.map(param => ...)` where ARRAY is a known

package/dist/cjs/extractor/parsers/scope-manager.js

@@ -6,6 +6,11 @@ class ScopeManager {
     scopeStack = [];
     config;
     scope = new Map();
+    // Stack of class scopes; each entry maps a class field name (e.g. `myField`
+    // or `#privateField`) to the ScopeInfo derived from its initializer. Used to
+    // resolve `const { t } = this.field` and `const { t } = this.field()` patterns
+    // inside class methods.
+    thisFieldStack = [];
     // Track simple local constants with string literal values to resolve identifier args
     simpleConstants = new Map();
     // Track simple local constant objects with string literal property values
@@ -63,6 +68,49 @@ class ScopeManager {
         this.scope = new Map();
         this.simpleConstants.clear();
         this.simpleConstantObjects.clear();
+        this.thisFieldStack = [];
+    }
+    /**
+     * Pushes a new class scope used for tracking class field → ScopeInfo
+     * mappings. Should be called when entering a ClassDeclaration or
+     * ClassExpression.
+     */
+    enterClassScope() {
+        this.thisFieldStack.push(new Map());
+    }
+    /**
+     * Pops the current class scope. Should be called when leaving a
+     * ClassDeclaration or ClassExpression.
+     */
+    exitClassScope() {
+        this.thisFieldStack.pop();
+    }
+    /**
+     * Records a class field's ScopeInfo so that later `this.<field>` or
+     * `this.<field>()` accesses inside the class can inherit the namespace
+     * and keyPrefix from its initializer.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param info - Scope information derived from the field's initializer
+     */
+    setThisField(fieldName, info) {
+        if (this.thisFieldStack.length > 0) {
+            this.thisFieldStack[this.thisFieldStack.length - 1].set(fieldName, info);
+        }
+    }
+    /**
+     * Looks up a class field's ScopeInfo from the innermost class scope outward.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @returns Scope information if found, undefined otherwise
+     */
+    getThisField(fieldName) {
+        for (let i = this.thisFieldStack.length - 1; i >= 0; i--) {
+            if (this.thisFieldStack[i].has(fieldName)) {
+                return this.thisFieldStack[i].get(fieldName);
+            }
+        }
+        return undefined;
     }
     /**
      * Enters a new variable scope by pushing a new scope map onto the stack.
@@ -219,6 +267,17 @@ class ScopeManager {
             }
             // continue processing; still may be a useTranslation/getFixedT call below
         }
+        // Handle: const { t } = this.#field  OR  const { t } = this.#field()
+        // Resolve the source `this.<field>` to its previously-registered ScopeInfo
+        // and propagate it onto the destructured variables.
+        const thisFieldName = ScopeManager.extractThisFieldName(init);
+        if (thisFieldName !== undefined) {
+            const sourceScope = this.getThisField(thisFieldName);
+            if (sourceScope) {
+                this.attachScopeToDestructuredVars(node, sourceScope);
+                return;
+            }
+        }
         // Determine the actual call expression, looking inside AwaitExpressions.
         const callExpr = init.type === 'AwaitExpression' && init.argument.type === 'CallExpression'
             ? init.argument
@@ -545,6 +604,165 @@ class ScopeManager {
             this.setVarInScope(targetVarName, { defaultNs: finalNs, keyPrefix: finalKeyPrefix });
         }
     }
+    /**
+     * Returns the field name being referenced when an expression takes the form
+     * `this.<field>` or `this.<field>()`. Strips the call wrapper if present and
+     * prefixes private fields with `#`.
+     *
+     * Returns undefined if the expression is not such an access.
+     */
+    static extractThisFieldName(init) {
+        let memberExpr;
+        if (init.type === 'MemberExpression') {
+            memberExpr = init;
+        }
+        else if (init.type === 'CallExpression' && init.callee.type === 'MemberExpression') {
+            memberExpr = init.callee;
+        }
+        if (!memberExpr)
+            return undefined;
+        if (memberExpr.object.type !== 'ThisExpression')
+            return undefined;
+        const prop = memberExpr.property;
+        if (prop?.type === 'Identifier')
+            return prop.value;
+        if (prop?.type === 'PrivateName')
+            return '#' + prop.value;
+        return undefined;
+    }
+    /**
+     * Attaches the given ScopeInfo to all destructured variables of a variable
+     * declarator (`const { t } = ...`, `const [t] = ...`, or `const t = ...`).
+     */
+    attachScopeToDestructuredVars(node, info) {
+        if (node.id.type === 'ObjectPattern') {
+            for (const prop of node.id.properties) {
+                if (prop.type === 'AssignmentPatternProperty' && prop.key.type === 'Identifier') {
+                    this.setVarInScope(prop.key.value, info);
+                }
+                if (prop.type === 'KeyValuePatternProperty' && prop.value.type === 'Identifier') {
+                    this.setVarInScope(prop.value.value, info);
+                    // Also store under the pattern key name so legacy comment-scope
+                    // lookups by the original property name continue to work.
+                    if (prop.key.type === 'Identifier' && (prop.key.value === 't' || prop.key.value === 'getFixedT')) {
+                        this.scope.set(prop.value.value, { defaultNs: info.defaultNs, keyPrefix: info.keyPrefix });
+                    }
+                }
+            }
+        }
+        else if (node.id.type === 'Identifier') {
+            this.setVarInScope(node.id.value, info);
+        }
+        else if (node.id.type === 'ArrayPattern') {
+            const firstElement = node.id.elements[0];
+            if (firstElement?.type === 'Identifier') {
+                this.setVarInScope(firstElement.value, info);
+            }
+        }
+    }
+    /**
+     * Registers a class field's initializer with the current class scope so that
+     * later `const { t } = this.<field>` or `const { t } = this.<field>()` calls
+     * inside the class body inherit the namespace and keyPrefix from the field
+     * initializer.
+     *
+     * Recognizes the same useTranslation-like patterns supported on regular
+     * variable declarations (configured via `useTranslationNames`).
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param value - The field initializer expression
+     */
+    registerClassField(fieldName, value) {
+        if (!value)
+            return;
+        if (this.thisFieldStack.length === 0)
+            return;
+        const callExpr = value.type === 'AwaitExpression' && value.argument.type === 'CallExpression'
+            ? value.argument
+            : value.type === 'CallExpression'
+                ? value
+                : null;
+        if (!callExpr)
+            return;
+        const callee = callExpr.callee;
+        if (callee.type !== 'Identifier')
+            return;
+        const hookConfig = this.getUseTranslationConfig(callee.value);
+        if (!hookConfig)
+            return;
+        const info = this.computeScopeInfoFromHookCall(callExpr, hookConfig);
+        if (info.defaultNs || info.keyPrefix) {
+            this.setThisField(fieldName, info);
+        }
+    }
+    /**
+     * Computes ScopeInfo (defaultNs, keyPrefix) for a useTranslation-style call
+     * given a hook configuration that describes argument positions. Mirrors the
+     * extraction performed by handleUseTranslationDeclarator without attaching
+     * the result to any variable.
+     */
+    computeScopeInfoFromHookCall(callExpr, hookConfig) {
+        const nsArgIndex = hookConfig.nsArg ?? 0;
+        const kpArgIndex = hookConfig.keyPrefixArg ?? 1;
+        let defaultNs;
+        let keyPrefix;
+        const first = callExpr.arguments?.[0]?.expression;
+        const second = callExpr.arguments?.[1]?.expression;
+        const third = callExpr.arguments?.[2]?.expression;
+        const looksLikeLanguage = (s) => /^[a-z]{2,3}([-_][A-Za-z0-9-]+)?$/i.test(s);
+        const isBuiltInLngNsForm = hookConfig.name === 'useTranslation' &&
+            first?.type === 'StringLiteral' &&
+            second?.type === 'StringLiteral' &&
+            looksLikeLanguage(first.value);
+        let kpArg;
+        if (isBuiltInLngNsForm) {
+            defaultNs = second.value;
+            kpArg = third;
+        }
+        else {
+            if (nsArgIndex !== -1) {
+                const nsNode = callExpr.arguments?.[nsArgIndex]?.expression;
+                if (nsNode?.type === 'StringLiteral') {
+                    defaultNs = nsNode.value;
+                }
+                else if (nsNode?.type === 'Identifier') {
+                    defaultNs = this.resolveSimpleStringIdentifier(nsNode.value);
+                }
+                else if (nsNode?.type === 'MemberExpression') {
+                    defaultNs = this.resolveSimpleMemberExpression(nsNode);
+                }
+                else if (nsNode?.type === 'ArrayExpression') {
+                    const firstEl = nsNode.elements[0]?.expression;
+                    if (firstEl?.type === 'StringLiteral') {
+                        defaultNs = firstEl.value;
+                    }
+                    else if (firstEl?.type === 'Identifier') {
+                        defaultNs = this.resolveSimpleStringIdentifier(firstEl.value);
+                    }
+                }
+            }
+            kpArg = kpArgIndex === -1 ? undefined : callExpr.arguments?.[kpArgIndex]?.expression;
+        }
+        if (kpArg?.type === 'ObjectExpression') {
+            const kp = astUtils.getObjectPropValue(kpArg, 'keyPrefix', this.resolveSimpleStringIdentifier.bind(this));
+            if (typeof kp === 'string') {
+                keyPrefix = kp;
+            }
+        }
+        else if (kpArg?.type === 'StringLiteral') {
+            keyPrefix = kpArg.value;
+        }
+        else if (kpArg?.type === 'Identifier') {
+            keyPrefix = this.resolveSimpleStringIdentifier(kpArg.value);
+        }
+        else if (kpArg?.type === 'TemplateLiteral') {
+            const tpl = kpArg;
+            if ((tpl.expressions || []).length === 0) {
+                keyPrefix = tpl.quasis?.[0]?.cooked ?? undefined;
+            }
+        }
+        return { defaultNs, keyPrefix };
+    }
 }
 
 exports.ScopeManager = ScopeManager;

package/dist/cjs/linter.js

@@ -835,6 +835,7 @@ function findHardcodedStrings(ast, code, config) {
             issues.push({
                 text: node.value.trim(),
                 line: getLineNumber(position),
+                type: 'hardcoded',
             });
             lastSearchIndex = position + searchText.length;
         }

package/dist/esm/cli.js

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

@@ -163,7 +163,37 @@ class ASTVisitors {
         if (!node)
             return;
         let isNewScope = false;
+        let isNewClassScope = false;
         let paramTemporaries;
+        // 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.
+        if (node.type === 'ClassDeclaration' ||
+            node.type === 'ClassExpression' ||
+            node.type === 'ClassDecl' ||
+            node.type === 'ClassExpr') {
+            this.scopeManager.enterClassScope();
+            isNewClassScope = true;
+            const classBody = Array.isArray(node.body) ? node.body : (node.body?.body ?? []);
+            for (const member of classBody) {
+                if (!member || typeof member !== 'object')
+                    continue;
+                if (member.type === 'ClassProperty' ||
+                    member.type === 'PrivateProperty' ||
+                    member.type === 'PropertyDefinition' ||
+                    member.type === 'ClassPrivateProperty') {
+                    let fieldName;
+                    const key = member.key;
+                    if (key?.type === 'Identifier')
+                        fieldName = key.value ?? key.name;
+                    else if (key?.type === 'PrivateName')
+                        fieldName = '#' + (key.value ?? key.name ?? key.id?.value ?? key.id?.name);
+                    if (!fieldName)
+                        continue;
+                    this.scopeManager.registerClassField(fieldName, member.value);
+                }
+            }
+        }
         // ENTER SCOPE for functions
         // Accept many SWC/TS AST variants for function-like nodes (declarations, expressions, arrow functions)
         if (node.type === 'Function' ||
@@ -538,6 +568,10 @@ class ASTVisitors {
             }
             this.scopeManager.exitScope();
         }
+        // LEAVE CLASS SCOPE for classes
+        if (isNewClassScope) {
+            this.scopeManager.exitClassScope();
+        }
     }
     /**
      * If `node` is a call like `ARRAY.map(param => ...)` where ARRAY is a known

package/dist/esm/extractor/parsers/scope-manager.js

@@ -4,6 +4,11 @@ class ScopeManager {
     scopeStack = [];
     config;
     scope = new Map();
+    // Stack of class scopes; each entry maps a class field name (e.g. `myField`
+    // or `#privateField`) to the ScopeInfo derived from its initializer. Used to
+    // resolve `const { t } = this.field` and `const { t } = this.field()` patterns
+    // inside class methods.
+    thisFieldStack = [];
     // Track simple local constants with string literal values to resolve identifier args
     simpleConstants = new Map();
     // Track simple local constant objects with string literal property values
@@ -61,6 +66,49 @@ class ScopeManager {
         this.scope = new Map();
         this.simpleConstants.clear();
         this.simpleConstantObjects.clear();
+        this.thisFieldStack = [];
+    }
+    /**
+     * Pushes a new class scope used for tracking class field → ScopeInfo
+     * mappings. Should be called when entering a ClassDeclaration or
+     * ClassExpression.
+     */
+    enterClassScope() {
+        this.thisFieldStack.push(new Map());
+    }
+    /**
+     * Pops the current class scope. Should be called when leaving a
+     * ClassDeclaration or ClassExpression.
+     */
+    exitClassScope() {
+        this.thisFieldStack.pop();
+    }
+    /**
+     * Records a class field's ScopeInfo so that later `this.<field>` or
+     * `this.<field>()` accesses inside the class can inherit the namespace
+     * and keyPrefix from its initializer.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param info - Scope information derived from the field's initializer
+     */
+    setThisField(fieldName, info) {
+        if (this.thisFieldStack.length > 0) {
+            this.thisFieldStack[this.thisFieldStack.length - 1].set(fieldName, info);
+        }
+    }
+    /**
+     * Looks up a class field's ScopeInfo from the innermost class scope outward.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @returns Scope information if found, undefined otherwise
+     */
+    getThisField(fieldName) {
+        for (let i = this.thisFieldStack.length - 1; i >= 0; i--) {
+            if (this.thisFieldStack[i].has(fieldName)) {
+                return this.thisFieldStack[i].get(fieldName);
+            }
+        }
+        return undefined;
     }
     /**
      * Enters a new variable scope by pushing a new scope map onto the stack.
@@ -217,6 +265,17 @@ class ScopeManager {
             }
             // continue processing; still may be a useTranslation/getFixedT call below
         }
+        // Handle: const { t } = this.#field  OR  const { t } = this.#field()
+        // Resolve the source `this.<field>` to its previously-registered ScopeInfo
+        // and propagate it onto the destructured variables.
+        const thisFieldName = ScopeManager.extractThisFieldName(init);
+        if (thisFieldName !== undefined) {
+            const sourceScope = this.getThisField(thisFieldName);
+            if (sourceScope) {
+                this.attachScopeToDestructuredVars(node, sourceScope);
+                return;
+            }
+        }
         // Determine the actual call expression, looking inside AwaitExpressions.
         const callExpr = init.type === 'AwaitExpression' && init.argument.type === 'CallExpression'
             ? init.argument
@@ -543,6 +602,165 @@ class ScopeManager {
             this.setVarInScope(targetVarName, { defaultNs: finalNs, keyPrefix: finalKeyPrefix });
         }
     }
+    /**
+     * Returns the field name being referenced when an expression takes the form
+     * `this.<field>` or `this.<field>()`. Strips the call wrapper if present and
+     * prefixes private fields with `#`.
+     *
+     * Returns undefined if the expression is not such an access.
+     */
+    static extractThisFieldName(init) {
+        let memberExpr;
+        if (init.type === 'MemberExpression') {
+            memberExpr = init;
+        }
+        else if (init.type === 'CallExpression' && init.callee.type === 'MemberExpression') {
+            memberExpr = init.callee;
+        }
+        if (!memberExpr)
+            return undefined;
+        if (memberExpr.object.type !== 'ThisExpression')
+            return undefined;
+        const prop = memberExpr.property;
+        if (prop?.type === 'Identifier')
+            return prop.value;
+        if (prop?.type === 'PrivateName')
+            return '#' + prop.value;
+        return undefined;
+    }
+    /**
+     * Attaches the given ScopeInfo to all destructured variables of a variable
+     * declarator (`const { t } = ...`, `const [t] = ...`, or `const t = ...`).
+     */
+    attachScopeToDestructuredVars(node, info) {
+        if (node.id.type === 'ObjectPattern') {
+            for (const prop of node.id.properties) {
+                if (prop.type === 'AssignmentPatternProperty' && prop.key.type === 'Identifier') {
+                    this.setVarInScope(prop.key.value, info);
+                }
+                if (prop.type === 'KeyValuePatternProperty' && prop.value.type === 'Identifier') {
+                    this.setVarInScope(prop.value.value, info);
+                    // Also store under the pattern key name so legacy comment-scope
+                    // lookups by the original property name continue to work.
+                    if (prop.key.type === 'Identifier' && (prop.key.value === 't' || prop.key.value === 'getFixedT')) {
+                        this.scope.set(prop.value.value, { defaultNs: info.defaultNs, keyPrefix: info.keyPrefix });
+                    }
+                }
+            }
+        }
+        else if (node.id.type === 'Identifier') {
+            this.setVarInScope(node.id.value, info);
+        }
+        else if (node.id.type === 'ArrayPattern') {
+            const firstElement = node.id.elements[0];
+            if (firstElement?.type === 'Identifier') {
+                this.setVarInScope(firstElement.value, info);
+            }
+        }
+    }
+    /**
+     * Registers a class field's initializer with the current class scope so that
+     * later `const { t } = this.<field>` or `const { t } = this.<field>()` calls
+     * inside the class body inherit the namespace and keyPrefix from the field
+     * initializer.
+     *
+     * Recognizes the same useTranslation-like patterns supported on regular
+     * variable declarations (configured via `useTranslationNames`).
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param value - The field initializer expression
+     */
+    registerClassField(fieldName, value) {
+        if (!value)
+            return;
+        if (this.thisFieldStack.length === 0)
+            return;
+        const callExpr = value.type === 'AwaitExpression' && value.argument.type === 'CallExpression'
+            ? value.argument
+            : value.type === 'CallExpression'
+                ? value
+                : null;
+        if (!callExpr)
+            return;
+        const callee = callExpr.callee;
+        if (callee.type !== 'Identifier')
+            return;
+        const hookConfig = this.getUseTranslationConfig(callee.value);
+        if (!hookConfig)
+            return;
+        const info = this.computeScopeInfoFromHookCall(callExpr, hookConfig);
+        if (info.defaultNs || info.keyPrefix) {
+            this.setThisField(fieldName, info);
+        }
+    }
+    /**
+     * Computes ScopeInfo (defaultNs, keyPrefix) for a useTranslation-style call
+     * given a hook configuration that describes argument positions. Mirrors the
+     * extraction performed by handleUseTranslationDeclarator without attaching
+     * the result to any variable.
+     */
+    computeScopeInfoFromHookCall(callExpr, hookConfig) {
+        const nsArgIndex = hookConfig.nsArg ?? 0;
+        const kpArgIndex = hookConfig.keyPrefixArg ?? 1;
+        let defaultNs;
+        let keyPrefix;
+        const first = callExpr.arguments?.[0]?.expression;
+        const second = callExpr.arguments?.[1]?.expression;
+        const third = callExpr.arguments?.[2]?.expression;
+        const looksLikeLanguage = (s) => /^[a-z]{2,3}([-_][A-Za-z0-9-]+)?$/i.test(s);
+        const isBuiltInLngNsForm = hookConfig.name === 'useTranslation' &&
+            first?.type === 'StringLiteral' &&
+            second?.type === 'StringLiteral' &&
+            looksLikeLanguage(first.value);
+        let kpArg;
+        if (isBuiltInLngNsForm) {
+            defaultNs = second.value;
+            kpArg = third;
+        }
+        else {
+            if (nsArgIndex !== -1) {
+                const nsNode = callExpr.arguments?.[nsArgIndex]?.expression;
+                if (nsNode?.type === 'StringLiteral') {
+                    defaultNs = nsNode.value;
+                }
+                else if (nsNode?.type === 'Identifier') {
+                    defaultNs = this.resolveSimpleStringIdentifier(nsNode.value);
+                }
+                else if (nsNode?.type === 'MemberExpression') {
+                    defaultNs = this.resolveSimpleMemberExpression(nsNode);
+                }
+                else if (nsNode?.type === 'ArrayExpression') {
+                    const firstEl = nsNode.elements[0]?.expression;
+                    if (firstEl?.type === 'StringLiteral') {
+                        defaultNs = firstEl.value;
+                    }
+                    else if (firstEl?.type === 'Identifier') {
+                        defaultNs = this.resolveSimpleStringIdentifier(firstEl.value);
+                    }
+                }
+            }
+            kpArg = kpArgIndex === -1 ? undefined : callExpr.arguments?.[kpArgIndex]?.expression;
+        }
+        if (kpArg?.type === 'ObjectExpression') {
+            const kp = getObjectPropValue(kpArg, 'keyPrefix', this.resolveSimpleStringIdentifier.bind(this));
+            if (typeof kp === 'string') {
+                keyPrefix = kp;
+            }
+        }
+        else if (kpArg?.type === 'StringLiteral') {
+            keyPrefix = kpArg.value;
+        }
+        else if (kpArg?.type === 'Identifier') {
+            keyPrefix = this.resolveSimpleStringIdentifier(kpArg.value);
+        }
+        else if (kpArg?.type === 'TemplateLiteral') {
+            const tpl = kpArg;
+            if ((tpl.expressions || []).length === 0) {
+                keyPrefix = tpl.quasis?.[0]?.cooked ?? undefined;
+            }
+        }
+        return { defaultNs, keyPrefix };
+    }
 }
 
 export { ScopeManager };

package/dist/esm/linter.js

@@ -833,6 +833,7 @@ function findHardcodedStrings(ast, code, config) {
             issues.push({
                 text: node.value.trim(),
                 line: getLineNumber(position),
+                type: 'hardcoded',
             });
             lastSearchIndex = position + searchText.length;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.56.8",
+  "version": "1.56.10",
   "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;IAoXZ;;;;;;;;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;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"}

package/types/extractor/parsers/scope-manager.d.ts

@@ -1,9 +1,10 @@
-import type { VariableDeclarator } from '@swc/core';
+import type { Expression, VariableDeclarator } from '@swc/core';
 import type { ScopeInfo, I18nextToolkitConfig } from '../../types.js';
 export declare class ScopeManager {
     private scopeStack;
     private config;
     private scope;
+    private thisFieldStack;
     private simpleConstants;
     private simpleConstantObjects;
     private sharedConstants;
@@ -27,6 +28,33 @@ export declare class ScopeManager {
      * leak between files.
      */
     reset(): void;
+    /**
+     * Pushes a new class scope used for tracking class field → ScopeInfo
+     * mappings. Should be called when entering a ClassDeclaration or
+     * ClassExpression.
+     */
+    enterClassScope(): void;
+    /**
+     * Pops the current class scope. Should be called when leaving a
+     * ClassDeclaration or ClassExpression.
+     */
+    exitClassScope(): void;
+    /**
+     * Records a class field's ScopeInfo so that later `this.<field>` or
+     * `this.<field>()` accesses inside the class can inherit the namespace
+     * and keyPrefix from its initializer.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param info - Scope information derived from the field's initializer
+     */
+    setThisField(fieldName: string, info: ScopeInfo): void;
+    /**
+     * Looks up a class field's ScopeInfo from the innermost class scope outward.
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @returns Scope information if found, undefined otherwise
+     */
+    getThisField(fieldName: string): ScopeInfo | undefined;
     /**
      * Enters a new variable scope by pushing a new scope map onto the stack.
      * Used when entering functions to isolate variable declarations.
@@ -131,5 +159,38 @@ export declare class ScopeManager {
      * resulting scope to the newly declared variable.
      */
     private handleGetFixedTFromVariableDeclarator;
+    /**
+     * Returns the field name being referenced when an expression takes the form
+     * `this.<field>` or `this.<field>()`. Strips the call wrapper if present and
+     * prefixes private fields with `#`.
+     *
+     * Returns undefined if the expression is not such an access.
+     */
+    private static extractThisFieldName;
+    /**
+     * Attaches the given ScopeInfo to all destructured variables of a variable
+     * declarator (`const { t } = ...`, `const [t] = ...`, or `const t = ...`).
+     */
+    private attachScopeToDestructuredVars;
+    /**
+     * Registers a class field's initializer with the current class scope so that
+     * later `const { t } = this.<field>` or `const { t } = this.<field>()` calls
+     * inside the class body inherit the namespace and keyPrefix from the field
+     * initializer.
+     *
+     * Recognizes the same useTranslation-like patterns supported on regular
+     * variable declarations (configured via `useTranslationNames`).
+     *
+     * @param fieldName - Field name (private fields are prefixed with `#`)
+     * @param value - The field initializer expression
+     */
+    registerClassField(fieldName: string, value: Expression | null | undefined): void;
+    /**
+     * Computes ScopeInfo (defaultNs, keyPrefix) for a useTranslation-style call
+     * given a hook configuration that describes argument positions. Mirrors the
+     * extraction performed by handleUseTranslationDeclarator without attaching
+     * the result to any variable.
+     */
+    private computeScopeInfoFromHookCall;
 }
 //# sourceMappingURL=scope-manager.d.ts.map

package/types/extractor/parsers/scope-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/scope-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAMnB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,SAAS,EAA4B,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAG/F,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,KAAK,CAAqE;IAGlF,OAAO,CAAC,eAAe,CAAiC;IAGxD,OAAO,CAAC,qBAAqB,CAAiD;IAI9E,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,qBAAqB,CAAiD;gBAEjE,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAI1D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAgB9C;;;;;;OAMG;IACI,KAAK,IAAK,IAAI;IAOrB;;;OAGG;IACH,UAAU,IAAK,IAAI;IAInB;;;OAGG;IACH,SAAS,IAAK,IAAI;IAIlB;;;;;;OAMG;IACH,aAAa,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUnD;;;;;;OAMG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAkBrD,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACI,6BAA6B,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;;;;;;;;;OAUG;IACH,wBAAwB,CAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IA0FzD;;;;;;;;OAQG;IACH,OAAO,CAAC,+BAA+B;IA0GvC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,8BAA8B;IAmFtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;OASG;IACH,OAAO,CAAC,qCAAqC;CAoB9C"}
+{"version":3,"file":"scope-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/scope-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EAMnB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,SAAS,EAA4B,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAG/F,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,KAAK,CAAqE;IAMlF,OAAO,CAAC,cAAc,CAAoC;IAG1D,OAAO,CAAC,eAAe,CAAiC;IAGxD,OAAO,CAAC,qBAAqB,CAAiD;IAI9E,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,qBAAqB,CAAiD;gBAEjE,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAI1D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAgB9C;;;;;;OAMG;IACI,KAAK,IAAK,IAAI;IAQrB;;;;OAIG;IACH,eAAe,IAAK,IAAI;IAIxB;;;OAGG;IACH,cAAc,IAAK,IAAI;IAIvB;;;;;;;OAOG;IACH,YAAY,CAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAMvD;;;;;OAKG;IACH,YAAY,CAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IASvD;;;OAGG;IACH,UAAU,IAAK,IAAI;IAInB;;;OAGG;IACH,SAAS,IAAK,IAAI;IAIlB;;;;;;OAMG;IACH,aAAa,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUnD;;;;;;OAMG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAkBrD,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACI,6BAA6B,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;;;;;;;;;OAUG;IACH,wBAAwB,CAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAsGzD;;;;;;;;OAQG;IACH,OAAO,CAAC,+BAA+B;IA0GvC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,8BAA8B;IAmFtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;OASG;IACH,OAAO,CAAC,qCAAqC;IAqB7C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAgBnC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAyBrC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAwBlF;;;;;OAKG;IACH,OAAO,CAAC,4BAA4B;CA+DrC"}