i18next-cli 1.10.1 → 1.10.3

package/src/extractor/parsers/ast-visitors.ts

@@ -1,1510 +0,0 @@
-import type { Module, Node, CallExpression, VariableDeclarator, JSXElement, ArrowFunctionExpression, ObjectExpression, Expression, TemplateLiteral, TsType, TsTemplateLiteralType } from '@swc/core'
-import type { PluginContext, I18nextToolkitConfig, Logger, ExtractedKey, ScopeInfo } from '../../types'
-import { extractFromTransComponent } from './jsx-parser'
-import { getObjectProperty, getObjectPropValue } from './ast-utils'
-
-interface UseTranslationHookConfig {
-  name: string;
-  nsArg: number;
-  keyPrefixArg: number;
-}
-
-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 class ASTVisitors {
-  private readonly pluginContext: PluginContext
-  private readonly config: Omit<I18nextToolkitConfig, 'plugins'>
-  private readonly logger: Logger
-  private scopeStack: Array<Map<string, ScopeInfo>> = []
-  private hooks: ASTVisitorHooks
-
-  public objectKeys = new Set<string>()
-
-  private scope: Map<string, { defaultNs?: string; keyPrefix?: string }> = new Map()
-
-  /**
-   * 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
-  ) {
-    this.pluginContext = pluginContext
-    this.config = config
-    this.logger = logger
-    this.hooks = {
-      onBeforeVisitNode: hooks?.onBeforeVisitNode,
-      onAfterVisitNode: hooks?.onAfterVisitNode,
-      resolvePossibleKeyStringValues: hooks?.resolvePossibleKeyStringValues,
-      resolvePossibleContextStringValues: hooks?.resolvePossibleContextStringValues
-    }
-  }
-
-  /**
-   * 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
-   */
-  public visit (node: Module): void {
-    this.enterScope() // Create the root scope for the file
-    this.walk(node)
-    this.exitScope()  // Clean up the root scope
-  }
-
-  /**
-   * 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 (node: Node | any): void {
-    if (!node) return
-
-    let isNewScope = false
-    // ENTER SCOPE for functions
-    if (node.type === 'Function' || node.type === 'ArrowFunctionExpression' || node.type === 'FunctionExpression') {
-      this.enterScope()
-      isNewScope = true
-    }
-
-    this.hooks.onBeforeVisitNode?.(node)
-
-    // --- VISIT LOGIC ---
-    // Handle specific node types
-    switch (node.type) {
-      case 'VariableDeclarator':
-        this.handleVariableDeclarator(node)
-        break
-      case 'CallExpression':
-        this.handleCallExpression(node)
-        break
-      case 'JSXElement':
-        this.handleJSXElement(node)
-        break
-    }
-
-    this.hooks.onAfterVisitNode?.(node)
-
-    // --- END VISIT LOGIC ---
-
-    // --- RECURSION ---
-    // Recurse into the children of the current node
-    for (const key in node) {
-      if (key === 'span') continue
-
-      const child = node[key]
-      if (Array.isArray(child)) {
-        for (const item of child) {
-          // Be less strict: if it's a non-null object, walk it.
-          // This allows traversal into nodes that might not have a `.type` property
-          // but still contain other valid AST nodes.
-          if (item && typeof item === 'object') {
-            this.walk(item)
-          }
-        }
-      } else if (child && typeof child === 'object') {
-        // The condition for single objects should be the same as for array items.
-        // Do not require `child.type`. This allows traversal into class method bodies.
-        this.walk(child)
-      }
-    }
-    // --- END RECURSION ---
-
-    // LEAVE SCOPE for functions
-    if (isNewScope) {
-      this.exitScope()
-    }
-  }
-
-  /**
-   * 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 (): void {
-    this.scopeStack.push(new Map())
-  }
-
-  /**
-   * Exits the current variable scope by popping the top scope map.
-   * Used when leaving functions to clean up variable tracking.
-   *
-   * @private
-   */
-  private exitScope (): void {
-    this.scopeStack.pop()
-  }
-
-  /**
-   * 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 (name: string, info: ScopeInfo): void {
-    if (this.scopeStack.length > 0) {
-      this.scopeStack[this.scopeStack.length - 1].set(name, info)
-    }
-  }
-
-  /**
-   * 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
-   */
-  public getVarFromScope (name: string): ScopeInfo | undefined {
-    // First check the proper scope stack (this is the primary source of truth)
-    for (let i = this.scopeStack.length - 1; i >= 0; i--) {
-      if (this.scopeStack[i].has(name)) {
-        const scopeInfo = this.scopeStack[i].get(name)
-        return scopeInfo
-      }
-    }
-
-    // Then check the legacy scope tracking for useTranslation calls (for comment parsing)
-    const legacyScope = this.scope.get(name)
-    if (legacyScope) {
-      return legacyScope
-    }
-
-    return 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 (node: VariableDeclarator): void {
-    const init = node.init
-    if (!init) return
-
-    // Determine the actual call expression, looking inside AwaitExpressions.
-    const callExpr =
-      init.type === 'AwaitExpression' && init.argument.type === 'CallExpression'
-        ? init.argument
-        : init.type === 'CallExpression'
-          ? init
-          : null
-
-    if (!callExpr) return
-
-    const callee = callExpr.callee
-
-    // Handle: const { t } = useTranslation(...)
-    if (callee.type === 'Identifier') {
-      const hookConfig = this.getUseTranslationConfig(callee.value)
-      if (hookConfig) {
-        this.handleUseTranslationDeclarator(node, callExpr, hookConfig)
-
-        // ALSO store in the legacy scope for comment parsing compatibility
-        this.handleUseTranslationForComments(node, callExpr, hookConfig)
-        return
-      }
-    }
-
-    // Handle: const t = i18next.getFixedT(...)
-    if (
-      callee.type === 'MemberExpression' &&
-      callee.property.type === 'Identifier' &&
-      callee.property.value === 'getFixedT'
-    ) {
-      this.handleGetFixedTDeclarator(node, callExpr)
-    }
-  }
-
-  /**
-   * 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 (node: VariableDeclarator, callExpr: CallExpression, hookConfig: UseTranslationHookConfig): void {
-    let variableName: string | undefined
-
-    // Handle simple assignment: let t = useTranslation()
-    if (node.id.type === 'Identifier') {
-      variableName = node.id.value
-    }
-
-    // Handle array destructuring: const [t, i18n] = useTranslation()
-    if (node.id.type === 'ArrayPattern') {
-      const firstElement = node.id.elements[0]
-      if (firstElement?.type === 'Identifier') {
-        variableName = firstElement.value
-      }
-    }
-
-    // Handle object destructuring: const { t } or { t: t1 } = useTranslation()
-    if (node.id.type === 'ObjectPattern') {
-      for (const prop of node.id.properties) {
-        if (prop.type === 'AssignmentPatternProperty' && prop.key.type === 'Identifier' && prop.key.value === 't') {
-          // This handles { t = defaultT }
-          variableName = 't'
-          break
-        }
-        if (prop.type === 'KeyValuePatternProperty' && prop.key.type === 'Identifier' && prop.key.value === 't' && prop.value.type === 'Identifier') {
-          // This handles { t: myT }
-          variableName = prop.value.value
-          break
-        }
-      }
-    }
-
-    // If we couldn't find a `t` function being declared, exit
-    if (!variableName) return
-
-    // Extract namespace from useTranslation arguments
-    const nsArg = callExpr.arguments?.[hookConfig.nsArg]?.expression
-    const optionsArg = callExpr.arguments?.[hookConfig.keyPrefixArg]?.expression
-
-    let defaultNs: string | undefined
-    let keyPrefix: string | undefined
-
-    // Parse namespace argument
-    if (nsArg?.type === 'StringLiteral') {
-      defaultNs = nsArg.value
-    } else if (nsArg?.type === 'ArrayExpression' && nsArg.elements[0]?.expression.type === 'StringLiteral') {
-      defaultNs = nsArg.elements[0].expression.value
-    }
-
-    // Parse keyPrefix from options object
-    if (optionsArg?.type === 'ObjectExpression') {
-      const keyPrefixProp = optionsArg.properties.find(
-        prop => prop.type === 'KeyValueProperty' &&
-                prop.key.type === 'Identifier' &&
-                prop.key.value === 'keyPrefix'
-      )
-      if (keyPrefixProp?.type === 'KeyValueProperty' && keyPrefixProp.value.type === 'StringLiteral') {
-        keyPrefix = keyPrefixProp.value.value
-      }
-    }
-
-    // Store in the legacy scope map for comment parsing
-    if (defaultNs || keyPrefix) {
-      this.scope.set(variableName, { defaultNs, keyPrefix })
-    }
-  }
-
-  /**
-   * 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 (node: VariableDeclarator, callExpr: CallExpression, hookConfig: UseTranslationHookConfig): void {
-    let variableName: string | undefined
-
-    // Handle simple assignment: let t = useTranslation()
-    if (node.id.type === 'Identifier') {
-      variableName = node.id.value
-    }
-
-    // Handle array destructuring: const [t, i18n] = useTranslation()
-    if (node.id.type === 'ArrayPattern') {
-      const firstElement = node.id.elements[0]
-      if (firstElement?.type === 'Identifier') {
-        variableName = firstElement.value
-      }
-    }
-
-    // Handle object destructuring: const { t } or { t: t1 } = useTranslation()
-    if (node.id.type === 'ObjectPattern') {
-      for (const prop of node.id.properties) {
-        if (prop.type === 'AssignmentPatternProperty' && prop.key.type === 'Identifier' && prop.key.value === 't') {
-          // This handles { t = defaultT }
-          variableName = 't'
-          break
-        }
-        if (prop.type === 'KeyValuePatternProperty' && prop.key.type === 'Identifier' && prop.key.value === 't' && prop.value.type === 'Identifier') {
-          // This handles { t: myT }
-          variableName = prop.value.value
-          break
-        }
-      }
-    }
-
-    // If we couldn't find a `t` function being declared, exit
-    if (!variableName) return
-
-    // Use the configured argument indices from hookConfig
-    const nsArg = callExpr.arguments?.[hookConfig.nsArg]?.expression
-
-    let defaultNs: string | undefined
-    if (nsArg?.type === 'StringLiteral') {
-      defaultNs = nsArg.value
-    } else if (nsArg?.type === 'ArrayExpression' && nsArg.elements[0]?.expression.type === 'StringLiteral') {
-      defaultNs = nsArg.elements[0].expression.value
-    }
-
-    const optionsArg = callExpr.arguments?.[hookConfig.keyPrefixArg]?.expression
-    let keyPrefix: string | undefined
-    if (optionsArg?.type === 'ObjectExpression') {
-      const kp = getObjectPropValue(optionsArg, 'keyPrefix')
-      keyPrefix = typeof kp === 'string' ? kp : undefined
-    }
-
-    // Store the scope info for the declared variable
-    this.setVarInScope(variableName, { defaultNs, keyPrefix })
-  }
-
-  /**
-   * 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 (node: VariableDeclarator, callExpr: CallExpression): void {
-  // Ensure we are assigning to a simple variable, e.g., const t = ...
-    if (node.id.type !== 'Identifier' || !node.init || node.init.type !== 'CallExpression') return
-
-    const variableName = node.id.value
-    const args = callExpr.arguments
-
-    // getFixedT(lng, ns, keyPrefix)
-    // We ignore the first argument (lng) for key extraction.
-    const nsArg = args[1]?.expression
-    const keyPrefixArg = args[2]?.expression
-
-    const defaultNs = (nsArg?.type === 'StringLiteral') ? nsArg.value : undefined
-    const keyPrefix = (keyPrefixArg?.type === 'StringLiteral') ? keyPrefixArg.value : undefined
-
-    if (defaultNs || keyPrefix) {
-      this.setVarInScope(variableName, { defaultNs, keyPrefix })
-    }
-  }
-
-  /**
-   * 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 (node: CallExpression): void {
-    const functionName = this.getFunctionName(node.callee)
-    if (!functionName) return
-
-    // The scope lookup will only work for simple identifiers, which is okay for this fix.
-    const scopeInfo = this.getVarFromScope(functionName)
-    const configuredFunctions = this.config.extract.functions || ['t', '*.t']
-    let isFunctionToParse = scopeInfo !== undefined // A scoped variable (from useTranslation, etc.) is always parsed.
-    if (!isFunctionToParse) {
-      for (const pattern of configuredFunctions) {
-        if (pattern.startsWith('*.')) {
-        // Handle wildcard suffix (e.g., '*.t' matches 'i18n.t')
-          if (functionName.endsWith(pattern.substring(1))) {
-            isFunctionToParse = true
-            break
-          }
-        } else {
-        // Handle exact match
-          if (pattern === functionName) {
-            isFunctionToParse = true
-            break
-          }
-        }
-      }
-    }
-    if (!isFunctionToParse || node.arguments.length === 0) return
-
-    const { keysToProcess, isSelectorAPI } = this.handleCallExpressionArgument(node, 0)
-
-    if (keysToProcess.length === 0) return
-
-    let isOrdinalByKey = false
-    const pluralSeparator = this.config.extract.pluralSeparator ?? '_'
-
-    for (let i = 0; i < keysToProcess.length; i++) {
-      if (keysToProcess[i].endsWith(`${pluralSeparator}ordinal`)) {
-        isOrdinalByKey = true
-        // Normalize the key by stripping the suffix
-        keysToProcess[i] = keysToProcess[i].slice(0, -8)
-      }
-    }
-
-    let defaultValue: string | undefined
-    let options: ObjectExpression | undefined
-
-    if (node.arguments.length > 1) {
-      const arg2 = node.arguments[1].expression
-      if (arg2.type === 'ObjectExpression') {
-        options = arg2
-      } else if (arg2.type === 'StringLiteral') {
-        defaultValue = arg2.value
-      }
-    }
-    if (node.arguments.length > 2) {
-      const arg3 = node.arguments[2].expression
-      if (arg3.type === 'ObjectExpression') {
-        options = arg3
-      }
-    }
-    const defaultValueFromOptions = options ? getObjectPropValue(options, 'defaultValue') : undefined
-    const finalDefaultValue = (typeof defaultValueFromOptions === 'string' ? defaultValueFromOptions : defaultValue)
-
-    // Loop through each key found (could be one or more) and process it
-    for (let i = 0; i < keysToProcess.length; i++) {
-      let key = keysToProcess[i]
-      let ns: string | undefined
-
-      // Determine namespace (explicit ns > ns:key > scope ns > default)
-      // See https://www.i18next.com/overview/api#getfixedt
-      if (options) {
-        const nsVal = getObjectPropValue(options, 'ns')
-        if (typeof nsVal === 'string') ns = nsVal
-      }
-
-      const nsSeparator = this.config.extract.nsSeparator ?? ':'
-      if (!ns && nsSeparator && key.includes(nsSeparator)) {
-        const parts = key.split(nsSeparator)
-        ns = parts.shift()
-        key = parts.join(nsSeparator)
-
-        if (!key || key.trim() === '') {
-          this.logger.warn(`Skipping key that became empty after namespace removal: '${ns}${nsSeparator}'`)
-          continue
-        }
-      }
-
-      if (!ns && scopeInfo?.defaultNs) ns = scopeInfo.defaultNs
-      if (!ns) ns = this.config.extract.defaultNS
-
-      let finalKey = key
-
-      // Apply keyPrefix AFTER namespace extraction
-      if (scopeInfo?.keyPrefix) {
-        const keySeparator = this.config.extract.keySeparator ?? '.'
-
-        // Apply keyPrefix - handle case where keyPrefix already ends with separator
-        if (keySeparator !== false) {
-          if (scopeInfo.keyPrefix.endsWith(keySeparator)) {
-            finalKey = `${scopeInfo.keyPrefix}${key}`
-          } else {
-            finalKey = `${scopeInfo.keyPrefix}${keySeparator}${key}`
-          }
-        } else {
-          finalKey = `${scopeInfo.keyPrefix}${key}`
-        }
-
-        // Validate keyPrefix combinations that create problematic keys
-        if (keySeparator !== false) {
-          // Check for patterns that would create empty segments in the nested key structure
-          const segments = finalKey.split(keySeparator)
-          const hasEmptySegment = segments.some(segment => segment.trim() === '')
-
-          if (hasEmptySegment) {
-            this.logger.warn(`Skipping key with empty segments: '${finalKey}' (keyPrefix: '${scopeInfo.keyPrefix}', key: '${key}')`)
-            continue
-          }
-        }
-      }
-
-      const isLastKey = i === keysToProcess.length - 1
-      const dv = isLastKey ? (finalDefaultValue || key) : key
-
-      // Handle plurals, context, and returnObjects
-      if (options) {
-        const contextProp = getObjectProperty(options, 'context')
-
-        const keysWithContext: ExtractedKey[] = []
-
-        // 1. Handle Context
-        if (contextProp?.value?.type === 'StringLiteral' || contextProp?.value.type === 'NumericLiteral' || contextProp?.value.type === 'BooleanLiteral') {
-          // If the context is static, we don't need to add the base key
-          const contextValue = `${contextProp.value.value}`
-
-          const contextSeparator = this.config.extract.contextSeparator ?? '_'
-          // Ignore context: ''
-          if (contextValue !== '') {
-            keysWithContext.push({ key: `${finalKey}${contextSeparator}${contextValue}`, ns, defaultValue: dv })
-          }
-        } else if (contextProp?.value) {
-          const contextValues = this.resolvePossibleContextStringValues(contextProp.value)
-          const contextSeparator = this.config.extract.contextSeparator ?? '_'
-
-          if (contextValues.length > 0) {
-            contextValues.forEach(context => {
-              keysWithContext.push({ key: `${finalKey}${contextSeparator}${context}`, ns, defaultValue: dv })
-            })
-            // For dynamic context, also add the base key as a fallback
-            keysWithContext.push({ key: finalKey, ns, defaultValue: dv })
-          }
-        }
-
-        // 2. Handle Plurals
-        const hasCount = getObjectPropValue(options, 'count') !== undefined
-        const isOrdinalByOption = getObjectPropValue(options, 'ordinal') === true
-        if (hasCount || isOrdinalByKey) {
-          // Check if plurals are disabled
-          if (this.config.extract.disablePlurals) {
-            // When plurals are disabled, treat count as a regular option (for interpolation only)
-            // Still handle context normally
-            if (keysWithContext.length > 0) {
-              keysWithContext.forEach(this.pluginContext.addKey)
-            } else {
-              // No context, just add the base key (no plurals even if count is present)
-              this.pluginContext.addKey({ key: finalKey, ns, defaultValue: dv })
-            }
-          } else {
-            // Original plural handling logic when plurals are enabled
-            // Always pass the base key to handlePluralKeys - it will handle context internally
-            this.handlePluralKeys(finalKey, ns, options, isOrdinalByOption || isOrdinalByKey, finalDefaultValue)
-          }
-
-          continue // This key is fully handled
-        }
-
-        if (keysWithContext.length > 0) {
-          keysWithContext.forEach(this.pluginContext.addKey)
-
-          continue // This key is now fully handled
-        }
-
-        // 3. Handle returnObjects
-        if (getObjectPropValue(options, 'returnObjects') === true) {
-          this.objectKeys.add(finalKey)
-          // Fall through to add the base key itself
-        }
-      }
-
-      // 4. Handle selector API as implicit returnObjects
-      if (isSelectorAPI) {
-        this.objectKeys.add(finalKey)
-        // Fall through to add the base key itself
-      }
-
-      // 5. Default case: Add the simple key
-      this.pluginContext.addKey({ key: finalKey, ns, defaultValue: dv })
-    }
-  }
-
-  /**
-   * 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 (
-    node: CallExpression,
-    argIndex: number
-  ): { keysToProcess: string[]; isSelectorAPI: boolean } {
-    const firstArg = node.arguments[argIndex].expression
-    const keysToProcess: string[] = []
-    let isSelectorAPI = false
-
-    if (firstArg.type === 'ArrowFunctionExpression') {
-      const key = this.extractKeyFromSelector(firstArg)
-      if (key) {
-        keysToProcess.push(key)
-        isSelectorAPI = true
-      }
-    } else if (firstArg.type === 'ArrayExpression') {
-      for (const element of firstArg.elements) {
-        if (element?.expression) {
-          keysToProcess.push(...this.resolvePossibleKeyStringValues(element.expression))
-        }
-      }
-    } else {
-      keysToProcess.push(...this.resolvePossibleKeyStringValues(firstArg))
-    }
-
-    return {
-      keysToProcess: keysToProcess.filter((key) => !!key),
-      isSelectorAPI,
-    }
-  }
-
-  /**
-   * 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 (key: string, ns: string | undefined, options: ObjectExpression, isOrdinal: boolean, defaultValueFromCall?: string): void {
-    try {
-      const type = isOrdinal ? 'ordinal' : 'cardinal'
-
-      // Generate plural forms for ALL target languages to ensure we have all necessary keys
-      const allPluralCategories = new Set<string>()
-
-      for (const locale of this.config.locales) {
-        try {
-          const pluralRules = new Intl.PluralRules(locale, { type })
-          const categories = pluralRules.resolvedOptions().pluralCategories
-          categories.forEach(cat => allPluralCategories.add(cat))
-        } catch (e) {
-          // If a locale is invalid, fall back to English rules
-          const englishRules = new Intl.PluralRules('en', { type })
-          const categories = englishRules.resolvedOptions().pluralCategories
-          categories.forEach(cat => allPluralCategories.add(cat))
-        }
-      }
-
-      const pluralCategories = Array.from(allPluralCategories).sort()
-      const pluralSeparator = this.config.extract.pluralSeparator ?? '_'
-
-      // Get all possible default values once at the start
-      const defaultValue = getObjectPropValue(options, 'defaultValue')
-      const otherDefault = getObjectPropValue(options, `defaultValue${pluralSeparator}other`)
-      const ordinalOtherDefault = getObjectPropValue(options, `defaultValue${pluralSeparator}ordinal${pluralSeparator}other`)
-
-      // Get the count value and determine target category if available
-      const countValue = getObjectPropValue(options, 'count')
-      let targetCategory: string | undefined
-
-      if (typeof countValue === 'number') {
-        try {
-          const primaryLanguage = this.config.extract?.primaryLanguage || this.config.locales[0] || 'en'
-          const pluralRules = new Intl.PluralRules(primaryLanguage, { type })
-          targetCategory = pluralRules.select(countValue)
-        } catch (e) {
-          // If we can't determine the category, continue with normal logic
-        }
-      }
-
-      // Handle context - both static and dynamic
-      const contextProp = getObjectProperty(options, 'context')
-      const keysToGenerate: Array<{ key: string, context?: string }> = []
-
-      if (contextProp?.value) {
-        // Handle dynamic context by resolving all possible values
-        const contextValues = this.resolvePossibleContextStringValues(contextProp.value)
-
-        if (contextValues.length > 0) {
-          // Generate keys for each context value
-          for (const contextValue of contextValues) {
-            if (contextValue.length > 0) { // Skip empty contexts
-              keysToGenerate.push({ key, context: contextValue })
-            }
-          }
-
-          // For dynamic context, also generate base plural forms if generateBasePluralForms is not disabled
-          const shouldGenerateBaseForms = this.config.extract?.generateBasePluralForms !== false
-          if (shouldGenerateBaseForms) {
-            keysToGenerate.push({ key })
-          }
-        } else {
-          // Couldn't resolve context, fall back to base key only
-          keysToGenerate.push({ key })
-        }
-      } else {
-        // No context, always generate base plural forms
-        keysToGenerate.push({ key })
-      }
-
-      // Generate plural forms for each key variant
-      for (const { key: baseKey, context } of keysToGenerate) {
-        for (const category of pluralCategories) {
-          // 1. Look for the most specific default value
-          const specificDefaultKey = isOrdinal ? `defaultValue${pluralSeparator}ordinal${pluralSeparator}${category}` : `defaultValue${pluralSeparator}${category}`
-          const specificDefault = getObjectPropValue(options, specificDefaultKey)
-
-          // 2. Determine the final default value using a clear fallback chain
-          let finalDefaultValue: string | undefined
-          if (typeof specificDefault === 'string') {
-            finalDefaultValue = specificDefault
-          } else if (category === 'one' && typeof defaultValue === 'string') {
-            finalDefaultValue = defaultValue
-          } else if (isOrdinal && typeof ordinalOtherDefault === 'string') {
-            finalDefaultValue = ordinalOtherDefault
-          } else if (!isOrdinal && typeof otherDefault === 'string') {
-            finalDefaultValue = otherDefault
-          } else if (typeof defaultValue === 'string') {
-            finalDefaultValue = defaultValue
-          } else if (defaultValueFromCall && targetCategory === category) {
-            finalDefaultValue = defaultValueFromCall
-          } else {
-            finalDefaultValue = baseKey
-          }
-
-          // 3. Construct the final plural key
-          let finalKey: string
-          if (context) {
-            const contextSeparator = this.config.extract.contextSeparator ?? '_'
-            finalKey = isOrdinal
-              ? `${baseKey}${contextSeparator}${context}${pluralSeparator}ordinal${pluralSeparator}${category}`
-              : `${baseKey}${contextSeparator}${context}${pluralSeparator}${category}`
-          } else {
-            finalKey = isOrdinal
-              ? `${baseKey}${pluralSeparator}ordinal${pluralSeparator}${category}`
-              : `${baseKey}${pluralSeparator}${category}`
-          }
-
-          this.pluginContext.addKey({
-            key: finalKey,
-            ns,
-            defaultValue: finalDefaultValue,
-            hasCount: true,
-            isOrdinal
-          })
-        }
-      }
-    } catch (e) {
-      this.logger.warn(`Could not determine plural rules for language "${this.config.extract?.primaryLanguage}". Falling back to simple key extraction.`)
-      // Fallback to a simple key if Intl API fails
-      const defaultValue = defaultValueFromCall || getObjectPropValue(options, 'defaultValue')
-      this.pluginContext.addKey({ key, ns, defaultValue: typeof defaultValue === 'string' ? defaultValue : key })
-    }
-  }
-
-  /**
-   * 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 (node: JSXElement): void {
-    const elementName = this.getElementName(node)
-
-    if (elementName && (this.config.extract.transComponents || ['Trans']).includes(elementName)) {
-      const extractedAttributes = extractFromTransComponent(node, this.config)
-
-      const keysToProcess: string[] = []
-
-      if (extractedAttributes) {
-        if (extractedAttributes.keyExpression) {
-          const keyValues = this.resolvePossibleKeyStringValues(extractedAttributes.keyExpression)
-          keysToProcess.push(...keyValues)
-        } else {
-          keysToProcess.push(extractedAttributes.serializedChildren)
-        }
-
-        let extractedKeys: ExtractedKey[]
-
-        const { contextExpression, optionsNode, defaultValue, hasCount, isOrdinal, serializedChildren } = extractedAttributes
-
-        // If ns is not explicitly set on the component, try to find it from the key
-        // or the `t` prop
-        if (!extractedAttributes.ns) {
-          extractedKeys = keysToProcess.map(key => {
-            const nsSeparator = this.config.extract.nsSeparator ?? ':'
-            let ns: string | undefined
-
-            // If the key contains a namespace separator, it takes precedence
-            // over the default t ns value
-            if (nsSeparator && key.includes(nsSeparator)) {
-              let parts: string[]
-              ([ns, ...parts] = key.split(nsSeparator))
-
-              key = parts.join(nsSeparator)
-            }
-
-            return {
-              key,
-              ns,
-              defaultValue: defaultValue || serializedChildren,
-              hasCount,
-              isOrdinal,
-            }
-          })
-
-          const tProp = node.opening.attributes?.find(
-            attr =>
-              attr.type === 'JSXAttribute' &&
-              attr.name.type === 'Identifier' &&
-              attr.name.value === 't'
-          )
-
-          // Check if the prop value is an identifier (e.g., t={t})
-          if (
-            tProp?.type === 'JSXAttribute' &&
-            tProp.value?.type === 'JSXExpressionContainer' &&
-            tProp.value.expression.type === 'Identifier'
-          ) {
-            const tIdentifier = tProp.value.expression.value
-            const scopeInfo = this.getVarFromScope(tIdentifier)
-            if (scopeInfo?.defaultNs) {
-              extractedKeys.forEach(key => {
-                if (!key.ns) {
-                  key.ns = scopeInfo.defaultNs
-                }
-              })
-            }
-          }
-        } else {
-          const { ns } = extractedAttributes
-          extractedKeys = keysToProcess.map(key => {
-            return {
-              key,
-              ns,
-              defaultValue: defaultValue || serializedChildren,
-              hasCount,
-              isOrdinal,
-            }
-          })
-        }
-
-        extractedKeys.forEach(key => {
-          // Apply defaultNS from config if no namespace was found on the component and
-          // the key does not contain a namespace prefix
-          if (!key.ns) {
-            key.ns = this.config.extract.defaultNS
-          }
-        })
-
-        // Handle the combination of context and count
-        if (contextExpression && hasCount) {
-          // Check if plurals are disabled
-          if (this.config.extract.disablePlurals) {
-            // When plurals are disabled, treat count as a regular option
-            // Still handle context normally
-            const contextValues = this.resolvePossibleContextStringValues(contextExpression)
-            const contextSeparator = this.config.extract.contextSeparator ?? '_'
-
-            if (contextValues.length > 0) {
-              // For static context (string literal), only add context variants
-              if (contextExpression.type === 'StringLiteral') {
-                for (const context of contextValues) {
-                  for (const extractedKey of extractedKeys) {
-                    const contextKey = `${extractedKey.key}${contextSeparator}${context}`
-                    this.pluginContext.addKey({ key: contextKey, ns: extractedKey.ns, defaultValue: extractedKey.defaultValue })
-                  }
-                }
-              } else {
-                // For dynamic context, add both base and context variants
-                extractedKeys.forEach(extractedKey => {
-                  this.pluginContext.addKey({
-                    key: extractedKey.key,
-                    ns: extractedKey.ns,
-                    defaultValue: extractedKey.defaultValue
-                  })
-                })
-                for (const context of contextValues) {
-                  for (const extractedKey of extractedKeys) {
-                    const contextKey = `${extractedKey.key}${contextSeparator}${context}`
-                    this.pluginContext.addKey({ key: contextKey, ns: extractedKey.ns, defaultValue: extractedKey.defaultValue })
-                  }
-                }
-              }
-            } else {
-              // Fallback to just base keys if context resolution fails
-              extractedKeys.forEach(extractedKey => {
-                this.pluginContext.addKey({
-                  key: extractedKey.key,
-                  ns: extractedKey.ns,
-                  defaultValue: extractedKey.defaultValue
-                })
-              })
-            }
-          } else {
-            // Original plural handling logic when plurals are enabled
-            // Find isOrdinal prop on the <Trans> component
-            const ordinalAttr = node.opening.attributes?.find(
-              (attr) =>
-                attr.type === 'JSXAttribute' &&
-                attr.name.type === 'Identifier' &&
-                attr.name.value === 'ordinal'
-            )
-            const isOrdinal = !!ordinalAttr
-
-            const contextValues = this.resolvePossibleContextStringValues(contextExpression)
-            const contextSeparator = this.config.extract.contextSeparator ?? '_'
-
-            // Generate all combinations of context and plural forms
-            if (contextValues.length > 0) {
-              // Generate base plural forms (no context)
-              extractedKeys.forEach(extractedKey => this.generatePluralKeysForTrans(extractedKey.key, extractedKey.defaultValue, extractedKey.ns, isOrdinal, optionsNode))
-
-              // Generate context + plural combinations
-              for (const context of contextValues) {
-                for (const extractedKey of extractedKeys) {
-                  const contextKey = `${extractedKey.key}${contextSeparator}${context}`
-                  this.generatePluralKeysForTrans(contextKey, extractedKey.defaultValue, extractedKey.ns, isOrdinal, optionsNode)
-                }
-              }
-            } else {
-              // Fallback to just plural forms if context resolution fails
-              extractedKeys.forEach(extractedKey => this.generatePluralKeysForTrans(extractedKey.key, extractedKey.defaultValue, extractedKey.ns, isOrdinal, optionsNode))
-            }
-          }
-        } else if (contextExpression) {
-          const contextValues = this.resolvePossibleContextStringValues(contextExpression)
-          const contextSeparator = this.config.extract.contextSeparator ?? '_'
-
-          if (contextValues.length > 0) {
-            // Add context variants
-            for (const context of contextValues) {
-              for (const { key, ns, defaultValue } of extractedKeys) {
-                this.pluginContext.addKey({ key: `${key}${contextSeparator}${context}`, ns, defaultValue })
-              }
-            }
-            // Only add the base key as a fallback if the context is dynamic (i.e., not a simple string).
-            if (contextExpression.type !== 'StringLiteral') {
-              extractedKeys.forEach(extractedKey => {
-                this.pluginContext.addKey({
-                  key: extractedKey.key,
-                  ns: extractedKey.ns,
-                  defaultValue: extractedKey.defaultValue
-                })
-              })
-            }
-          } else {
-            // If no context values were resolved, just add base keys
-            extractedKeys.forEach(extractedKey => {
-              this.pluginContext.addKey({
-                key: extractedKey.key,
-                ns: extractedKey.ns,
-                defaultValue: extractedKey.defaultValue
-              })
-            })
-          }
-        } else if (hasCount) {
-          // Check if plurals are disabled
-          if (this.config.extract.disablePlurals) {
-            // When plurals are disabled, just add the base keys (no plural forms)
-            extractedKeys.forEach(extractedKey => {
-              this.pluginContext.addKey({
-                key: extractedKey.key,
-                ns: extractedKey.ns,
-                defaultValue: extractedKey.defaultValue
-              })
-            })
-          } else {
-            // Original plural handling logic when plurals are enabled
-            // Find isOrdinal prop on the <Trans> component
-            const ordinalAttr = node.opening.attributes?.find(
-              (attr) =>
-                attr.type === 'JSXAttribute' &&
-                attr.name.type === 'Identifier' &&
-                attr.name.value === 'ordinal'
-            )
-            const isOrdinal = !!ordinalAttr
-
-            extractedKeys.forEach(extractedKey => this.generatePluralKeysForTrans(extractedKey.key, extractedKey.defaultValue, extractedKey.ns, isOrdinal, optionsNode))
-          }
-        } else {
-          // No count or context - just add the base keys
-          extractedKeys.forEach(extractedKey => {
-            this.pluginContext.addKey({
-              key: extractedKey.key,
-              ns: extractedKey.ns,
-              defaultValue: extractedKey.defaultValue
-            })
-          })
-        }
-      }
-    }
-  }
-
-  /**
-   * 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 (key: string, defaultValue: string | undefined, ns: string | undefined, isOrdinal: boolean, optionsNode?: ObjectExpression): void {
-    try {
-      const type = isOrdinal ? 'ordinal' : 'cardinal'
-      const pluralCategories = new Intl.PluralRules(this.config.extract?.primaryLanguage, { type }).resolvedOptions().pluralCategories
-      const pluralSeparator = this.config.extract.pluralSeparator ?? '_'
-
-      // Get plural-specific default values from tOptions if available
-      let otherDefault: string | undefined
-      let ordinalOtherDefault: string | undefined
-
-      if (optionsNode) {
-        otherDefault = getObjectPropValue(optionsNode, `defaultValue${pluralSeparator}other`) as string | undefined
-        ordinalOtherDefault = getObjectPropValue(optionsNode, `defaultValue${pluralSeparator}ordinal${pluralSeparator}other`) as string | undefined
-      }
-
-      for (const category of pluralCategories) {
-        // Look for the most specific default value (e.g., defaultValue_ordinal_one)
-        const specificDefaultKey = isOrdinal ? `defaultValue${pluralSeparator}ordinal${pluralSeparator}${category}` : `defaultValue${pluralSeparator}${category}`
-        const specificDefault = optionsNode ? getObjectPropValue(optionsNode, specificDefaultKey) as string | undefined : undefined
-
-        // Determine the final default value using a clear fallback chain
-        let finalDefaultValue: string | undefined
-        if (typeof specificDefault === 'string') {
-          // 1. Use the most specific default if it exists (e.g., defaultValue_one)
-          finalDefaultValue = specificDefault
-        } else if (category === 'one' && typeof defaultValue === 'string') {
-          // 2. SPECIAL CASE: The 'one' category falls back to the main default value (children content)
-          finalDefaultValue = defaultValue
-        } else if (isOrdinal && typeof ordinalOtherDefault === 'string') {
-          // 3a. Other ordinal categories fall back to 'defaultValue_ordinal_other'
-          finalDefaultValue = ordinalOtherDefault
-        } else if (!isOrdinal && typeof otherDefault === 'string') {
-          // 3b. Other cardinal categories fall back to 'defaultValue_other'
-          finalDefaultValue = otherDefault
-        } else if (typeof defaultValue === 'string') {
-          // 4. If no '_other' is found, all categories can fall back to the main default value
-          finalDefaultValue = defaultValue
-        } else {
-          // 5. Final fallback to the base key itself
-          finalDefaultValue = key
-        }
-
-        const finalKey = isOrdinal
-          ? `${key}${pluralSeparator}ordinal${pluralSeparator}${category}`
-          : `${key}${pluralSeparator}${category}`
-
-        this.pluginContext.addKey({
-          key: finalKey,
-          ns,
-          defaultValue: finalDefaultValue,
-          hasCount: true,
-          isOrdinal
-        })
-      }
-    } catch (e) {
-      this.logger.warn(`Could not determine plural rules for language "${this.config.extract?.primaryLanguage}". Falling back to simple key extraction.`)
-      // Fallback to a simple key if Intl API fails
-      this.pluginContext.addKey({ key, ns, defaultValue })
-    }
-  }
-
-  /**
-   * 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 (node: JSXElement): string | undefined {
-    if (node.opening.name.type === 'Identifier') {
-      return node.opening.name.value
-    } else if (node.opening.name.type === 'JSXMemberExpression') {
-      let curr: any = node.opening.name
-      const names: string[] = []
-      while (curr.type === 'JSXMemberExpression') {
-        if (curr.property.type === 'Identifier') names.unshift(curr.property.value)
-        curr = curr.object
-      }
-      if (curr.type === 'Identifier') names.unshift(curr.value)
-      return names.join('.')
-    }
-    return undefined
-  }
-
-  /**
-   * 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 (node: ArrowFunctionExpression): string | null {
-    let body = node.body
-
-    // Handle block bodies, e.g., $ => { return $.key; }
-    if (body.type === 'BlockStatement') {
-      const returnStmt = body.stmts.find(s => s.type === 'ReturnStatement')
-      if (returnStmt?.type === 'ReturnStatement' && returnStmt.argument) {
-        body = returnStmt.argument
-      } else {
-        return null
-      }
-    }
-
-    let current = body
-    const parts: string[] = []
-
-    // Recursively walk down MemberExpressions
-    while (current.type === 'MemberExpression') {
-      const prop = current.property
-
-      if (prop.type === 'Identifier') {
-      // This handles dot notation: .key
-        parts.unshift(prop.value)
-      } else if (prop.type === 'Computed' && prop.expression.type === 'StringLiteral') {
-      // This handles bracket notation: ['key']
-        parts.unshift(prop.expression.value)
-      } else {
-      // This is a dynamic property like [myVar] or a private name, which we cannot resolve.
-        return null
-      }
-
-      current = current.object
-    }
-
-    if (parts.length > 0) {
-      const keySeparator = this.config.extract.keySeparator
-      const joiner = typeof keySeparator === 'string' ? keySeparator : '.'
-      return parts.join(joiner)
-    }
-
-    return null
-  }
-
-  /**
-   * 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 (expression: Expression) {
-    const strings = this.hooks.resolvePossibleContextStringValues?.(expression) ?? []
-
-    return [...strings, ...this.resolvePossibleStringValuesFromExpression(expression)]
-  }
-
-  /**
-   * 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 (expression: Expression) {
-    const strings = this.hooks.resolvePossibleKeyStringValues?.(expression) ?? []
-
-    return [...strings, ...this.resolvePossibleStringValuesFromExpression(expression)]
-  }
-
-  /**
-   * 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 (expression: Expression, returnEmptyStrings = false): string[] {
-    if (expression.type === 'StringLiteral') {
-      // Filter out empty strings as they should be treated as "no context" like i18next does
-      return expression.value || returnEmptyStrings ? [expression.value] : []
-    }
-
-    if (expression.type === 'ConditionalExpression') { // This is a ternary operator
-      const consequentValues = this.resolvePossibleStringValuesFromExpression(expression.consequent, returnEmptyStrings)
-      const alternateValues = this.resolvePossibleStringValuesFromExpression(expression.alternate, returnEmptyStrings)
-      return [...consequentValues, ...alternateValues]
-    }
-
-    if (expression.type === 'Identifier' && expression.value === 'undefined') {
-      return [] // Handle the `undefined` case
-    }
-
-    if (expression.type === 'TemplateLiteral') {
-      return this.resolvePossibleStringValuesFromTemplateString(expression)
-    }
-
-    if (expression.type === 'NumericLiteral' || expression.type === 'BooleanLiteral') {
-      return [`${expression.value}`] // Handle literals like 5 or true
-    }
-
-    // Support building translation keys for
-    // `variable satisfies 'coaching' | 'therapy'`
-    if (expression.type === 'TsSatisfiesExpression' || expression.type === 'TsAsExpression') {
-      const annotation = expression.typeAnnotation
-
-      return this.resolvePossibleStringValuesFromType(annotation, returnEmptyStrings)
-    }
-
-    // We can't statically determine the value of other expressions (e.g., variables, function calls)
-    return []
-  }
-
-  private resolvePossibleStringValuesFromType (type: TsType, returnEmptyStrings = false): string[] {
-    if (type.type === 'TsUnionType') {
-      return type.types.flatMap((t) => this.resolvePossibleStringValuesFromType(t, returnEmptyStrings))
-    }
-
-    if (type.type === 'TsLiteralType') {
-      if (type.literal.type === 'StringLiteral') {
-        // Filter out empty strings as they should be treated as "no context" like i18next does
-        return type.literal.value || returnEmptyStrings ? [type.literal.value] : []
-      }
-
-      if (type.literal.type === 'TemplateLiteral') {
-        return this.resolvePossibleStringValuesFromTemplateLiteralType(type.literal)
-      }
-
-      if (type.literal.type === 'NumericLiteral' || type.literal.type === 'BooleanLiteral') {
-        return [`${type.literal.value}`] // Handle literals like 5 or true
-      }
-    }
-
-    // We can't statically determine the value of other expressions (e.g., variables, function calls)
-    return []
-  }
-
-  /**
-   * 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 (templateString: TemplateLiteral): string[] {
-    // If there are no expressions, we can just return the cooked value
-    if (templateString.quasis.length === 1 && templateString.expressions.length === 0) {
-      // Ex. `translation.key.no.substitution`
-      return [templateString.quasis[0].cooked || '']
-    }
-
-    // Ex. `translation.key.with.expression.${x ? 'title' : 'description'}`
-    const [firstQuasis, ...tails] = templateString.quasis
-
-    const stringValues = templateString.expressions.reduce(
-      (heads, expression, i) => {
-        return heads.flatMap((head) => {
-          const tail = tails[i]?.cooked ?? ''
-          return this.resolvePossibleStringValuesFromExpression(expression, true).map(
-            (expressionValue) => `${head}${expressionValue}${tail}`
-          )
-        })
-      },
-      [firstQuasis.cooked ?? '']
-    )
-
-    return stringValues
-  }
-
-  /**
-   * 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 (templateLiteralType: TsTemplateLiteralType): string[] {
-    // If there are no types, we can just return the cooked value
-    if (templateLiteralType.quasis.length === 1 && templateLiteralType.types.length === 0) {
-      // Ex. `translation.key.no.substitution`
-      return [templateLiteralType.quasis[0].cooked || '']
-    }
-
-    // Ex. `translation.key.with.expression.${'title' | 'description'}`
-    const [firstQuasis, ...tails] = templateLiteralType.quasis
-
-    const stringValues = templateLiteralType.types.reduce(
-      (heads, type, i) => {
-        return heads.flatMap((head) => {
-          const tail = tails[i]?.cooked ?? ''
-          return this.resolvePossibleStringValuesFromType(type, true).map(
-            (expressionValue) => `${head}${expressionValue}${tail}`
-          )
-        })
-      },
-      [firstQuasis.cooked ?? '']
-    )
-
-    return stringValues
-  }
-
-  /**
-   * 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 (name: string): UseTranslationHookConfig | undefined {
-    const useTranslationNames = this.config.extract.useTranslationNames || ['useTranslation']
-
-    for (const item of useTranslationNames) {
-      if (typeof item === 'string' && item === name) {
-        // Default behavior for simple string entries
-        return { name, nsArg: 0, keyPrefixArg: 1 }
-      }
-      if (typeof item === 'object' && item.name === name) {
-        // Custom configuration with specified or default argument positions
-        return {
-          name: item.name,
-          nsArg: item.nsArg ?? 0,
-          keyPrefixArg: item.keyPrefixArg ?? 1,
-        }
-      }
-    }
-    return undefined
-  }
-
-  /**
-   * 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 (callee: CallExpression['callee']): string | null {
-    if (callee.type === 'Identifier') {
-      return callee.value
-    }
-    if (callee.type === 'MemberExpression') {
-      const parts: string[] = []
-      let current: any = callee
-      while (current.type === 'MemberExpression') {
-        if (current.property.type === 'Identifier') {
-          parts.unshift(current.property.value)
-        } else {
-          return null // Cannot handle computed properties like i18n['t']
-        }
-        current = current.object
-      }
-      // Handle `this` as the base of the expression (e.g., this._i18n.t)
-      if (current.type === 'ThisExpression') {
-        parts.unshift('this')
-      } else if (current.type === 'Identifier') {
-        parts.unshift(current.value)
-      } else {
-        return null // Base of the expression is not a simple identifier
-      }
-      return parts.join('.')
-    }
-    return null
-  }
-}