i18next-cli 1.56.7 → 1.56.9

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

@@ -749,11 +749,23 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
         }
         else {
+            // A key is a synthesized plural variant only when the extractor flagged it
+            // with `hasCount` AND its suffix matches a CLDR plural form. Relying purely
+            // on the presence of the separator misclassifies regular keys that happen to
+            // contain `_` (e.g. `abc_123`) — see issue #250. Context variants are caught
+            // by `isDerivedDefault` below (their synthesized default mirrors the base key).
+            const isVariantKey = (() => {
+                if (!hasCount)
+                    return false;
+                const parts = key.split(pluralSeparator);
+                if (parts.length < 2)
+                    return false;
+                return pluralForms.includes(parts[parts.length - 1]);
+            })();
             // Existing value exists - decide whether to preserve, sync primary, or clear other locales when requested
             if (locale === primaryLanguage && syncPrimaryWithDefaults) {
-                // If this key looks like a plural/context variant and the default
-                // wasn't explicitly provided in source code, preserve the existing value.
-                const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
+                // If this key is a plural/context variant and the default wasn't explicitly
+                // provided in source code, preserve the existing value.
                 if (isVariantKey && !explicitDefault) {
                     valueToSet = existingValue;
                 }
@@ -766,7 +778,6 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
             else {
                 // Non-primary locale behavior
-                const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
                 // A plural variant whose category exists in the current locale but not in the
                 // primary language (e.g. French `_many` vs English `one`/`other`) will always be
                 // absent from the primary file by CLDR design. Treat that absence as expected —

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

@@ -747,11 +747,23 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
         }
         else {
+            // A key is a synthesized plural variant only when the extractor flagged it
+            // with `hasCount` AND its suffix matches a CLDR plural form. Relying purely
+            // on the presence of the separator misclassifies regular keys that happen to
+            // contain `_` (e.g. `abc_123`) — see issue #250. Context variants are caught
+            // by `isDerivedDefault` below (their synthesized default mirrors the base key).
+            const isVariantKey = (() => {
+                if (!hasCount)
+                    return false;
+                const parts = key.split(pluralSeparator);
+                if (parts.length < 2)
+                    return false;
+                return pluralForms.includes(parts[parts.length - 1]);
+            })();
             // Existing value exists - decide whether to preserve, sync primary, or clear other locales when requested
             if (locale === primaryLanguage && syncPrimaryWithDefaults) {
-                // If this key looks like a plural/context variant and the default
-                // wasn't explicitly provided in source code, preserve the existing value.
-                const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
+                // If this key is a plural/context variant and the default wasn't explicitly
+                // provided in source code, preserve the existing value.
                 if (isVariantKey && !explicitDefault) {
                     valueToSet = existingValue;
                 }
@@ -764,7 +776,6 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
             }
             else {
                 // Non-primary locale behavior
-                const isVariantKey = key.includes(pluralSeparator) || key.includes(contextSeparator);
                 // A plural variant whose category exists in the current locale but not in the
                 // primary language (e.g. French `_many` vs English `one`/`other`) will always be
                 // absent from the primary file by CLDR design. Treat that absence as expected —

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.56.7",
+  "version": "1.56.9",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {
@@ -85,7 +85,7 @@
     "minimatch": "^10.2.5",
     "ora": "^9.3.0",
     "react": "^19.2.5",
-    "react-i18next": "^17.0.4",
+    "react-i18next": "^17.0.6",
     "yaml": "^2.8.3"
   }
 }

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/core/translation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AA8iC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}
+{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAujC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}

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"}