i18next-cli 1.10.0 → 1.10.2

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

@@ -1,352 +0,0 @@
-import type { Module, Node, Expression } from '@swc/core';
-import type { PluginContext, I18nextToolkitConfig, Logger, ScopeInfo } from '../../types';
-export interface ASTVisitorHooks {
-    onBeforeVisitNode?: (node: Node) => void;
-    onAfterVisitNode?: (node: Node) => void;
-    resolvePossibleContextStringValues?: (expression: Expression, returnEmptyStrings?: boolean) => string[];
-    resolvePossibleKeyStringValues?: (expression: Expression, returnEmptyStrings?: boolean) => string[];
-}
-/**
- * AST visitor class that traverses JavaScript/TypeScript syntax trees to extract translation keys.
- *
- * This class implements a manual recursive walker that:
- * - Maintains scope information for tracking useTranslation and getFixedT calls
- * - Extracts keys from t() function calls with various argument patterns
- * - Handles JSX Trans components with complex children serialization
- * - Supports both string literals and selector API for type-safe keys
- * - Processes pluralization and context variants
- * - Manages namespace resolution from multiple sources
- *
- * The visitor respects configuration options for separators, function names,
- * component names, and other extraction settings.
- *
- * @example
- * ```typescript
- * const visitors = new ASTVisitors(config, pluginContext, logger)
- * visitors.visit(parsedAST)
- *
- * // The pluginContext will now contain all extracted keys
- * ```
- */
-export declare class ASTVisitors {
-    private readonly pluginContext;
-    private readonly config;
-    private readonly logger;
-    private scopeStack;
-    private hooks;
-    objectKeys: Set<string>;
-    private scope;
-    /**
-     * Creates a new AST visitor instance.
-     *
-     * @param config - Toolkit configuration with extraction settings
-     * @param pluginContext - Context for adding discovered translation keys
-     * @param logger - Logger for warnings and debug information
-     */
-    constructor(config: Omit<I18nextToolkitConfig, 'plugins'>, pluginContext: PluginContext, logger: Logger, hooks?: ASTVisitorHooks);
-    /**
-     * Main entry point for AST traversal.
-     * Creates a root scope and begins the recursive walk through the syntax tree.
-     *
-     * @param node - The root module node to traverse
-     */
-    visit(node: Module): void;
-    /**
-     * Recursively walks through AST nodes, handling scoping and visiting logic.
-     *
-     * This is the core traversal method that:
-     * 1. Manages function scopes (enter/exit)
-     * 2. Dispatches to specific handlers based on node type
-     * 3. Recursively processes child nodes
-     * 4. Maintains proper scope cleanup
-     *
-     * @param node - The current AST node to process
-     *
-     * @private
-     */
-    private walk;
-    /**
-     * Enters a new variable scope by pushing a new scope map onto the stack.
-     * Used when entering functions to isolate variable declarations.
-     *
-     * @private
-     */
-    private enterScope;
-    /**
-     * Exits the current variable scope by popping the top scope map.
-     * Used when leaving functions to clean up variable tracking.
-     *
-     * @private
-     */
-    private exitScope;
-    /**
-     * Stores variable information in the current scope.
-     * Used to track translation functions and their configuration.
-     *
-     * @param name - Variable name to store
-     * @param info - Scope information about the variable
-     *
-     * @private
-     */
-    private setVarInScope;
-    /**
-     * Retrieves variable information from the scope chain.
-     * Searches from innermost to outermost scope.
-     *
-     * @param name - Variable name to look up
-     * @returns Scope information if found, undefined otherwise
-     *
-     * @private
-     */
-    getVarFromScope(name: string): ScopeInfo | undefined;
-    /**
-     * Handles variable declarations that might define translation functions.
-     *
-     * Processes two patterns:
-     * 1. `const { t } = useTranslation(...)` - React i18next pattern
-     * 2. `const t = i18next.getFixedT(...)` - Core i18next pattern
-     *
-     * Extracts namespace and key prefix information for later use.
-     *
-     * @param node - Variable declarator node to process
-     *
-     * @private
-     */
-    private handleVariableDeclarator;
-    /**
-     * Handles useTranslation calls for comment scope resolution.
-     * This is a separate method to store scope info in the legacy scope map
-     * that the comment parser can access.
-     *
-     * @param node - Variable declarator with useTranslation call
-     * @param callExpr - The CallExpression node representing the useTranslation invocation
-     * @param hookConfig - Configuration describing argument positions for namespace and keyPrefix
-     *
-     * @private
-     */
-    private handleUseTranslationForComments;
-    /**
-     * Processes useTranslation hook declarations to extract scope information.
-     *
-     * Handles various destructuring patterns:
-     * - `const [t] = useTranslation('ns')` - Array destructuring
-     * - `const { t } = useTranslation('ns')` - Object destructuring
-     * - `const { t: myT } = useTranslation('ns')` - Aliased destructuring
-     *
-     * Extracts namespace from the first argument and keyPrefix from options.
-     *
-     * @param node - Variable declarator with useTranslation call
-     * @param callExpr - The CallExpression node representing the useTranslation invocation
-     * @param hookConfig - Configuration describing argument positions for namespace and keyPrefix
-     *
-     * @private
-     */
-    private handleUseTranslationDeclarator;
-    /**
-     * Processes getFixedT function declarations to extract scope information.
-     *
-     * Handles the pattern: `const t = i18next.getFixedT(lng, ns, keyPrefix)`
-     * - Ignores the first argument (language)
-     * - Extracts namespace from the second argument
-     * - Extracts key prefix from the third argument
-     *
-     * @param node - Variable declarator with getFixedT call
-     * @param callExpr - The CallExpression node representing the getFixedT invocation
-     *
-     * @private
-     */
-    private handleGetFixedTDeclarator;
-    /**
-     * Processes function call expressions to extract translation keys.
-     *
-     * This is the core extraction method that handles:
-     * - Standard t() calls with string literals
-     * - Selector API calls with arrow functions: `t($ => $.path.to.key)`
-     * - Namespace resolution from multiple sources
-     * - Default value extraction from various argument patterns
-     * - Pluralization and context handling
-     * - Key prefix application from scope
-     *
-     * @param node - Call expression node to process
-     *
-     * @private
-     */
-    private handleCallExpression;
-    /**
-     * Processed a call expression to extract keys from the specified argument.
-     *
-     * @param node - The call expression node
-     * @param argIndex - The index of the argument to process
-     * @returns An object containing the keys to process and a flag indicating if the selector API is used
-     */
-    private handleCallExpressionArgument;
-    /**
-     * Generates plural form keys based on the primary language's plural rules.
-     *
-     * Uses Intl.PluralRules to determine the correct plural categories
-     * for the configured primary language and generates suffixed keys
-     * for each category (e.g., 'item_one', 'item_other').
-     *
-     * @param key - Base key name for pluralization
-     * @param ns - Namespace for the keys
-     * @param options - object expression options
-     * @param isOrdinal - isOrdinal flag
-     *
-     * @private
-     */
-    private handlePluralKeys;
-    /**
-     * Processes JSX elements to extract translation keys from Trans components.
-     *
-     * Identifies configured Trans components and delegates to the JSX parser
-     * for complex children serialization and attribute extraction.
-     *
-     * @param node - JSX element node to process
-     *
-     * @private
-     */
-    private handleJSXElement;
-    /**
-     * Generates plural keys for Trans components, with support for tOptions plural defaults.
-     *
-     * @param key - Base key name for pluralization
-     * @param defaultValue - Default value for the keys
-     * @param ns - Namespace for the keys
-     * @param isOrdinal - Whether to generate ordinal plural forms
-     * @param optionsNode - Optional tOptions object expression for plural-specific defaults
-     *
-     * @private
-     */
-    private generatePluralKeysForTrans;
-    /**
-     * Extracts element name from JSX opening tag.
-     *
-     * Handles both simple identifiers and member expressions:
-     * - `<Trans>` → 'Trans'
-     * - `<React.Trans>` → 'React.Trans'
-     *
-     * @param node - JSX element node
-     * @returns Element name or undefined if not extractable
-     *
-     * @private
-     */
-    private getElementName;
-    /**
-     * Extracts translation key from selector API arrow function.
-     *
-     * Processes selector expressions like:
-     * - `$ => $.path.to.key` → 'path.to.key'
-     * - `$ => $.app['title'].main` → 'app.title.main'
-     * - `$ => { return $.nested.key; }` → 'nested.key'
-     *
-     * Handles both dot notation and bracket notation, respecting
-     * the configured key separator or flat key structure.
-     *
-     * @param node - Arrow function expression from selector call
-     * @returns Extracted key path or null if not statically analyzable
-     *
-     * @private
-     */
-    private extractKeyFromSelector;
-    /**
-     * Resolves an expression to one or more possible context string values that can be
-     * determined statically from the AST. This is a wrapper around the plugin hook
-     * `extractContextFromExpression` and {@link resolvePossibleStringValuesFromExpression}.
-     *
-     * @param expression - The SWC AST expression node to resolve
-     * @returns An array of possible context string values that the expression may produce.
-     *
-     * @private
-     */
-    private resolvePossibleContextStringValues;
-    /**
-     * Resolves an expression to one or more possible key string values that can be
-     * determined statically from the AST. This is a wrapper around the plugin hook
-     * `extractKeysFromExpression` and {@link resolvePossibleStringValuesFromExpression}.
-     *
-     * @param expression - The SWC AST expression node to resolve
-     * @returns An array of possible key string values that the expression may produce.
-     *
-     * @private
-     */
-    private resolvePossibleKeyStringValues;
-    /**
-     * Resolves an expression to one or more possible string values that can be
-     * determined statically from the AST.
-     *
-     * Supports:
-     * - StringLiteral -> single value (filtered to exclude empty strings for context)
-     * - NumericLiteral -> single value
-     * - BooleanLiteral -> single value
-     * - ConditionalExpression (ternary) -> union of consequent and alternate resolved values
-     * - TemplateLiteral -> union of all possible string values
-     * - The identifier `undefined` -> empty array
-     *
-     * For any other expression types (identifiers, function calls, member expressions,
-     * etc.) the value cannot be determined statically and an empty array is returned.
-     *
-     * @private
-     * @param expression - The SWC AST expression node to resolve
-     * @param returnEmptyStrings - Whether to include empty strings in the result
-     * @returns An array of possible string values that the expression may produce.
-     */
-    private resolvePossibleStringValuesFromExpression;
-    private resolvePossibleStringValuesFromType;
-    /**
-     * Resolves a template literal string to one or more possible strings that can be
-     * determined statically from the AST.
-     *
-     * @private
-     * @param templateString - The SWC AST template literal string to resolve
-     * @returns An array of possible string values that the template may produce.
-     */
-    private resolvePossibleStringValuesFromTemplateString;
-    /**
-     * Resolves a template literal type to one or more possible strings that can be
-     * determined statically from the AST.
-     *
-     * @private
-     * @param templateLiteralType - The SWC AST template literal type to resolve
-     * @returns An array of possible string values that the template may produce.
-     */
-    private resolvePossibleStringValuesFromTemplateLiteralType;
-    /**
-     * Finds the configuration for a given useTranslation function name.
-     * Applies default argument positions if none are specified.
-     *
-     * @param name - The identifier name to look up in the configured useTranslationNames
-     * @returns The resolved UseTranslationHookConfig when a match is found, otherwise undefined
-     */
-    private getUseTranslationConfig;
-    /**
-     * Serializes a callee node (Identifier or MemberExpression) into a string.
-     *
-     * Produces a dotted name for simple callees that can be used for scope lookups
-     * or configuration matching.
-     *
-     * Supported inputs:
-     * - Identifier: returns the identifier name (e.g., `t` -> "t")
-     * - MemberExpression with Identifier parts: returns a dotted path of identifiers
-     *   (e.g., `i18n.t` -> "i18n.t", `i18n.getFixedT` -> "i18n.getFixedT")
-     *
-     * Behavior notes:
-     * - Computed properties are not supported and cause this function to return null
-     *   (e.g., `i18n['t']` -> null).
-     * - The base of a MemberExpression must be a simple Identifier. More complex bases
-     *   (other expressions, `this`, etc.) will result in null.
-     * - This function does not attempt to resolve or evaluate expressions — it only
-     *   serializes static identifier/member chains.
-     *
-     * Examples:
-     * - Identifier callee: { type: 'Identifier', value: 't' } -> "t"
-     * - Member callee: { type: 'MemberExpression', object: { type: 'Identifier', value: 'i18n' }, property: { type: 'Identifier', value: 't' } } -> "i18n.t"
-     *
-     * @param callee - The CallExpression callee node to serialize
-     * @returns A dotted string name for supported callees, or null when the callee
-     *          is a computed/unsupported expression.
-     *
-     * @private
-     */
-    private getFunctionName;
-}
-//# sourceMappingURL=ast-visitors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ast-visitors.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/ast-visitors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAA6F,UAAU,EAAkD,MAAM,WAAW,CAAA;AACpM,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAA;AAUvG,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IACxC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IACvC,kCAAkC,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,MAAM,EAAE,CAAA;IACvG,8BAA8B,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,kBAAkB,CAAC,EAAE,OAAO,KAAK,MAAM,EAAE,CAAA;CACpG;AAED;;;;;;;;;;;;;;;;;;;;;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,UAAU,CAAoC;IACtD,OAAO,CAAC,KAAK,CAAiB;IAEvB,UAAU,cAAoB;IAErC,OAAO,CAAC,KAAK,CAAqE;IAElF;;;;;;OAMG;gBAED,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,eAAe;IAazB;;;;;OAKG;IACI,KAAK,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI;IA2DZ;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;;;;;OAQG;IACI,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAkB5D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,wBAAwB;IAsChC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,+BAA+B;IAmEvC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,8BAA8B;IAwDtC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IAoBjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,oBAAoB;IAsM5B;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;IA+HxB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAyOxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,0BAA0B;IA6DlC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;;;;;;;;OASG;IACH,OAAO,CAAC,kCAAkC;IAM1C;;;;;;;;;OASG;IACH,OAAO,CAAC,8BAA8B;IAMtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,yCAAyC;IAoCjD,OAAO,CAAC,mCAAmC;IAwB3C;;;;;;;OAOG;IACH,OAAO,CAAC,6CAA6C;IAyBrD;;;;;;;OAOG;IACH,OAAO,CAAC,kDAAkD;IAyB1D;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,eAAe;CA2BxB"}