ai-localize-scanner 2.0.1 → 2.0.3

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # ai-localize-scanner
 
+## 2.0.3
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-localize-shared@2.0.3
+  - ai-localize-config@2.0.3
+
+## 2.0.2
+
+### Minor Changes
+
+- **AST scanner seeds translation-fn names from codemods config** — translation function names configured under `codemods.translationFunction` are now automatically recognised by the AST scanner so already-translated strings are correctly skipped
+
+### Patch Changes
+
+- **Bug fix — locale key prefix with absolute sourceRoot** — `normalizePath()` now calls `path.relative()` when `sourceRoot` is an absolute path; `ProjectScanner` passes the resolved absolute `sourceRoot` to `AstScanner`, preventing ancestor path segments leaking into generated locale keys
+- Updated dependencies
+  - ai-localize-config@2.0.2
+  - ai-localize-shared@2.0.2
+
 ## 2.0.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,9 +1,20 @@
-import { CodemodConfig, DetectedText, AssetReference, LegacyCdnUrl, LocalizationConfig, ScanResult } from 'ai-localize-shared';
+import { KeyStyle, CodemodConfig, DetectedText, AssetReference, LegacyCdnUrl, LocalizationConfig, ScanResult } from 'ai-localize-shared';
 
 interface AstScanOptions {
     filePath: string;
     content: string;
     sourceRoot?: string;
+    /**
+     * Controls the format of the generated locale key for each detected text.
+   *
+     * - `"path"` (default) — hierarchical dot-notation key derived from file path + text:
+     *     `settings.settings_page.save_changes`
+     *
+     * - `"screaming_snake"` — UPPER_SNAKE_CASE key derived solely from the text value:
+     *     "Save Changes" → `SAVE_CHANGES`
+     *     "Max Count"  → `MAX_COUNT`
+     */
+    keyStyle?: KeyStyle;
     /**
      * Optional codemod config from ai-localize.config.json.
      *
@@ -13,7 +24,7 @@ interface AstScanOptions {
      *   importPackage — matched against import source strings. Supports:
      *     - npm package names:    "react-i18next", "my-i18n-lib"
      *     - path aliases:    "@/hooks/useTranslation", "@/i18n"
-     *     - relative paths:       "../../hooks/useTranslation"
+     *  - relative paths:       "../../hooks/useTranslation"
      *     Matching is done by checking whether the import source equals the value
      *     OR ends with the last path segment(s) of the value (normalised).
      *
@@ -37,10 +48,10 @@ declare class AstScanner {
     /** Identifiers whose call/bracket expressions contain already-translated strings. */
     private translationFunctionNames;
     /**
-       * Import source matchers.
-       * Each entry is either an exact string (npm package) or a path-suffix matcher
-       * function built from a relative/alias path.
-       */
+     * Import source matchers.
+     * Each entry is either an exact string (npm package) or a path-suffix matcher
+     * function built from a relative/alias path.
+     */
     private importSourceMatchers;
     constructor(options: AstScanOptions);
     scan(): DetectedText[];

package/dist/index.d.ts

@@ -1,9 +1,20 @@
-import { CodemodConfig, DetectedText, AssetReference, LegacyCdnUrl, LocalizationConfig, ScanResult } from 'ai-localize-shared';
+import { KeyStyle, CodemodConfig, DetectedText, AssetReference, LegacyCdnUrl, LocalizationConfig, ScanResult } from 'ai-localize-shared';
 
 interface AstScanOptions {
     filePath: string;
     content: string;
     sourceRoot?: string;
+    /**
+     * Controls the format of the generated locale key for each detected text.
+   *
+     * - `"path"` (default) — hierarchical dot-notation key derived from file path + text:
+     *     `settings.settings_page.save_changes`
+     *
+     * - `"screaming_snake"` — UPPER_SNAKE_CASE key derived solely from the text value:
+     *     "Save Changes" → `SAVE_CHANGES`
+     *     "Max Count"  → `MAX_COUNT`
+     */
+    keyStyle?: KeyStyle;
     /**
      * Optional codemod config from ai-localize.config.json.
      *
@@ -13,7 +24,7 @@ interface AstScanOptions {
      *   importPackage — matched against import source strings. Supports:
      *     - npm package names:    "react-i18next", "my-i18n-lib"
      *     - path aliases:    "@/hooks/useTranslation", "@/i18n"
-     *     - relative paths:       "../../hooks/useTranslation"
+     *  - relative paths:       "../../hooks/useTranslation"
      *     Matching is done by checking whether the import source equals the value
      *     OR ends with the last path segment(s) of the value (normalised).
      *
@@ -37,10 +48,10 @@ declare class AstScanner {
     /** Identifiers whose call/bracket expressions contain already-translated strings. */
     private translationFunctionNames;
     /**
-       * Import source matchers.
-       * Each entry is either an exact string (npm package) or a path-suffix matcher
-       * function built from a relative/alias path.
-       */
+     * Import source matchers.
+     * Each entry is either an exact string (npm package) or a path-suffix matcher
+     * function built from a relative/alias path.
+     */
     private importSourceMatchers;
     constructor(options: AstScanOptions);
     scan(): DetectedText[];

package/dist/index.js

@@ -55,10 +55,10 @@ var AstScanner = class {
   /** Identifiers whose call/bracket expressions contain already-translated strings. */
   translationFunctionNames;
   /**
-     * Import source matchers.
-     * Each entry is either an exact string (npm package) or a path-suffix matcher
-     * function built from a relative/alias path.
-     */
+   * Import source matchers.
+   * Each entry is either an exact string (npm package) or a path-suffix matcher
+   * function built from a relative/alias path.
+   */
   importSourceMatchers;
   constructor(options) {
     this.options = options;
@@ -221,10 +221,11 @@ var AstScanner = class {
     return false;
   }
   addDetected(text, line, column, context, nodeType) {
-    const key = (0, import_ai_localize_shared.generateLocaleKey)(
+    const key = (0, import_ai_localize_shared.generateKeyByStyle)(
       this.options.filePath,
       text,
-      this.options.sourceRoot || "src"
+      this.options.sourceRoot || "src",
+      this.options.keyStyle || "path"
     );
     this.detectedTexts.push({
       filePath: this.options.filePath,
@@ -255,10 +256,11 @@ var AstScanner = class {
       while ((m = jsxTextRegex.exec(line)) !== null) {
         const text = (0, import_ai_localize_shared.normalizeText)(m[1]);
         if (!(0, import_ai_localize_shared.isHumanReadableText)(text)) continue;
-        const key = (0, import_ai_localize_shared.generateLocaleKey)(
+        const key = (0, import_ai_localize_shared.generateKeyByStyle)(
           this.options.filePath,
           text,
-          this.options.sourceRoot || "src"
+          this.options.sourceRoot || "src",
+          this.options.keyStyle || "path"
         );
         results.push({
           filePath: this.options.filePath,
@@ -525,7 +527,8 @@ var ProjectScanner = class {
       filePath,
       content,
       sourceRoot: this.sourceRoot,
-      codemodConfig: this.config.codemods
+      codemodConfig: this.config.codemods,
+      keyStyle: this.config.keyStyle ?? "path"
     });
     const texts = scanner.scan();
     const { assets, legacyCdnUrls } = this.assetScanner.scanFile(filePath);

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   isHumanReadableText,
   normalizeText,
   TEXT_ATTRIBUTE_NAMES,
-  generateLocaleKey
+  generateKeyByStyle
 } from "ai-localize-shared";
 var BUILTIN_TRANSLATION_IMPORT_SOURCES = /* @__PURE__ */ new Set([
   "react-i18next",
@@ -20,10 +20,10 @@ var AstScanner = class {
   /** Identifiers whose call/bracket expressions contain already-translated strings. */
   translationFunctionNames;
   /**
-     * Import source matchers.
-     * Each entry is either an exact string (npm package) or a path-suffix matcher
-     * function built from a relative/alias path.
-     */
+   * Import source matchers.
+   * Each entry is either an exact string (npm package) or a path-suffix matcher
+   * function built from a relative/alias path.
+   */
   importSourceMatchers;
   constructor(options) {
     this.options = options;
@@ -186,10 +186,11 @@ var AstScanner = class {
     return false;
   }
   addDetected(text, line, column, context, nodeType) {
-    const key = generateLocaleKey(
+    const key = generateKeyByStyle(
       this.options.filePath,
       text,
-      this.options.sourceRoot || "src"
+      this.options.sourceRoot || "src",
+      this.options.keyStyle || "path"
     );
     this.detectedTexts.push({
       filePath: this.options.filePath,
@@ -220,10 +221,11 @@ var AstScanner = class {
       while ((m = jsxTextRegex.exec(line)) !== null) {
         const text = normalizeText(m[1]);
         if (!isHumanReadableText(text)) continue;
-        const key = generateLocaleKey(
+        const key = generateKeyByStyle(
           this.options.filePath,
           text,
-          this.options.sourceRoot || "src"
+          this.options.sourceRoot || "src",
+          this.options.keyStyle || "path"
         );
         results.push({
           filePath: this.options.filePath,
@@ -490,7 +492,8 @@ var ProjectScanner = class {
       filePath,
       content,
       sourceRoot: this.sourceRoot,
-      codemodConfig: this.config.codemods
+      codemodConfig: this.config.codemods,
+      keyStyle: this.config.keyStyle ?? "path"
     });
     const texts = scanner.scan();
     const { assets, legacyCdnUrls } = this.assetScanner.scanFile(filePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-localize-scanner",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "AST-based hardcoded text scanner for frontend applications",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -17,8 +17,8 @@
     "@babel/traverse": "^7.23.9",
     "@babel/types": "^7.23.9",
     "glob": "^10.3.10",
-    "ai-localize-shared": "2.0.1",
-    "ai-localize-config": "2.0.1"
+    "ai-localize-shared": "2.0.3",
+    "ai-localize-config": "2.0.3"
   },
   "devDependencies": {
     "@types/babel__traverse": "^7.20.5",

package/src/ast-scanner.ts

@@ -2,18 +2,29 @@ import * as parser from '@babel/parser';
 import traverse from '@babel/traverse';
 import * as t from '@babel/types';
 
-import type { DetectedText, TextContext, CodemodConfig } from 'ai-localize-shared';
+import type { DetectedText, TextContext, CodemodConfig, KeyStyle } from 'ai-localize-shared';
 import {
   isHumanReadableText,
   normalizeText,
   TEXT_ATTRIBUTE_NAMES,
-  generateLocaleKey,
+  generateKeyByStyle,
 } from 'ai-localize-shared';
 
 export interface AstScanOptions {
   filePath: string;
   content: string;
   sourceRoot?: string;
+  /**
+   * Controls the format of the generated locale key for each detected text.
+ *
+   * - `"path"` (default) — hierarchical dot-notation key derived from file path + text:
+   *     `settings.settings_page.save_changes`
+   *
+   * - `"screaming_snake"` — UPPER_SNAKE_CASE key derived solely from the text value:
+   *     "Save Changes" → `SAVE_CHANGES`
+   *     "Max Count"  → `MAX_COUNT`
+   */
+  keyStyle?: KeyStyle;
   /**
    * Optional codemod config from ai-localize.config.json.
    *
@@ -23,7 +34,7 @@ export interface AstScanOptions {
    *   importPackage — matched against import source strings. Supports:
    *     - npm package names:    "react-i18next", "my-i18n-lib"
    *     - path aliases:    "@/hooks/useTranslation", "@/i18n"
-   *     - relative paths:       "../../hooks/useTranslation"
+   *  - relative paths:       "../../hooks/useTranslation"
    *     Matching is done by checking whether the import source equals the value
    *     OR ends with the last path segment(s) of the value (normalised).
    *
@@ -44,7 +55,7 @@ const BUILTIN_TRANSLATION_IMPORT_SOURCES = new Set([
   'react-i18next',
   'i18next',
   'vue-i18n',
-'@ngx-translate/core',
+  '@ngx-translate/core',
 ]);
 
 /**
@@ -57,7 +68,7 @@ export class AstScanner {
   /** Identifiers whose call/bracket expressions contain already-translated strings. */
   private translationFunctionNames: Set<string>;
 
-/**
+  /**
    * Import source matchers.
    * Each entry is either an exact string (npm package) or a path-suffix matcher
    * function built from a relative/alias path.
@@ -84,13 +95,13 @@ export class AstScanner {
 
       // hookName — seed directly so the hook identifier is always recognised
       // regardless of how it is imported (named, default, aliased, re-exported).
-      if (cc.hookName) {
+   if (cc.hookName) {
         this.translationFunctionNames.add(cc.hookName);
       }
 
       // importPackage — build a matcher that handles:
       //   1. exact npm package name  "react-i18next"
-      //   2. path alias      "@/hooks/useTranslation"
+      //   2. path alias"@/hooks/useTranslation"
       //   3. relative path      "../../hooks/useTranslation"
       if (cc.importPackage) {
         this.importSourceMatchers.push(buildImportMatcher(cc.importPackage));
@@ -101,23 +112,23 @@ export class AstScanner {
   scan(): DetectedText[] {
     const { content } = this.options;
 
- let ast: t.File;
+    let ast: t.File;
     try {
       ast = parser.parse(content, {
-        sourceType: 'module',
+  sourceType: 'module',
         plugins: [
           'jsx',
-          'typescript',
- 'decorators-legacy',
-  'classProperties',
-        'optionalChaining',
-          'nullishCoalescingOperator',
-          'dynamicImport',
-      'exportDefaultFrom',
+ 'typescript',
+      'decorators-legacy',
+          'classProperties',
+     'optionalChaining',
+     'nullishCoalescingOperator',
+       'dynamicImport',
+    'exportDefaultFrom',
         ],
         errorRecovery: true,
       });
-    } catch {
+ } catch {
       return this.regexFallbackScan();
     }
 
@@ -126,89 +137,89 @@ export class AstScanner {
 
     traverse(ast, {
       JSXText: (nodePath) => {
-      const text = normalizeText(nodePath.node.value);
+        const text = normalizeText(nodePath.node.value);
         if (!isHumanReadableText(text)) return;
         if (this.isInsideTranslationCall(nodePath)) return;
-     this.addDetected(
-  text,
-       nodePath.node.loc?.start.line ?? 0,
-          nodePath.node.loc?.start.column ?? 0,
-  'jsx-text',
- 'JSXText'
-  );
+        this.addDetected(
+    text,
+   nodePath.node.loc?.start.line ?? 0,
+    nodePath.node.loc?.start.column ?? 0,
+          'jsx-text',
+          'JSXText'
+    );
       },
 
- JSXAttribute: (nodePath) => {
+      JSXAttribute: (nodePath) => {
         const attrName = t.isJSXIdentifier(nodePath.node.name)
-    ? nodePath.node.name.name
+          ? nodePath.node.name.name
           : '';
         if (!TEXT_ATTRIBUTE_NAMES.has(attrName.toLowerCase())) return;
-        const valueNode = nodePath.node.value;
-   if (!t.isStringLiteral(valueNode)) return;
-const text = normalizeText(valueNode.value);
+   const valueNode = nodePath.node.value;
+        if (!t.isStringLiteral(valueNode)) return;
+     const text = normalizeText(valueNode.value);
         if (!isHumanReadableText(text)) return;
         if (this.isInsideTranslationCall(nodePath)) return;
         const context = this.mapAttrToContext(attrName);
-        this.addDetected(
-          text,
+     this.addDetected(
+   text,
           valueNode.loc?.start.line ?? 0,
-          valueNode.loc?.start.column ?? 0,
-          context,
+  valueNode.loc?.start.column ?? 0,
+      context,
           'JSXAttribute'
         );
       },
 
       StringLiteral: (nodePath) => {
-if (t.isImportDeclaration(nodePath.parent)) return;
+        if (t.isImportDeclaration(nodePath.parent)) return;
         if (t.isObjectProperty(nodePath.parent) && nodePath.parent.key === nodePath.node) return;
 
         // Ignore className and similar CSS-class attributes
         if (t.isJSXAttribute(nodePath.parent)) {
           const attrName = t.isJSXIdentifier(nodePath.parent.name)
-  ? nodePath.parent.name.name.toLowerCase()
+        ? nodePath.parent.name.name.toLowerCase()
             : '';
-          if (attrName === 'classname' || attrName === 'class') return;
-   return;
+      if (attrName === 'classname' || attrName === 'class') return;
+          return;
         }
 
         if (this.isInsideTranslationCall(nodePath)) return;
 
         const val = nodePath.node.value;
         if (
-  /^[a-z][a-z0-9_.-]*$/.test(val) ||
+    /^[a-z][a-z0-9_.-]*$/.test(val) ||
           /^#?[0-9a-fA-F]+$/.test(val) ||
           (/^[\w-]+\s[\w- ]+$/.test(val) && !val.includes(','))
-  ) {
-     return; // Likely a CSS class, ID, hex colour, or plain word pair
+        ) {
+          return; // Likely a CSS class, ID, hex colour, or plain word pair
   }
 
         const text = normalizeText(nodePath.node.value);
-     if (!isHumanReadableText(text)) return;
+  if (!isHumanReadableText(text)) return;
         this.addDetected(
-       text,
-     nodePath.node.loc?.start.line ?? 0,
-   nodePath.node.loc?.start.column ?? 0,
-    'string-literal',
-     'StringLiteral'
+          text,
+  nodePath.node.loc?.start.line ?? 0,
+       nodePath.node.loc?.start.column ?? 0,
+          'string-literal',
+   'StringLiteral'
         );
       },
 
       TemplateLiteral: (nodePath) => {
-    if (nodePath.node.expressions.length > 0) return;
-if (this.isInsideTranslationCall(nodePath)) return;
+        if (nodePath.node.expressions.length > 0) return;
+        if (this.isInsideTranslationCall(nodePath)) return;
         const text = normalizeText(nodePath.node.quasis[0]?.value.cooked ?? '');
         if (!isHumanReadableText(text)) return;
         this.addDetected(
           text,
-nodePath.node.loc?.start.line ?? 0,
-    nodePath.node.loc?.start.column ?? 0,
+          nodePath.node.loc?.start.line ?? 0,
+          nodePath.node.loc?.start.column ?? 0,
           'template-literal',
-        'TemplateLiteral'
-        );
-      },
+          'TemplateLiteral'
+     );
+  },
     });
 
-    return this.detectedTexts;
+  return this.detectedTexts;
   }
 
   /**
@@ -218,55 +229,55 @@ nodePath.node.loc?.start.line ?? 0,
   private collectTranslationImports(ast: t.File): void {
     for (const node of ast.program.body) {
       if (!t.isImportDeclaration(node)) continue;
- const source = node.source.value;
+      const source = node.source.value;
       if (!this.isTranslationImportSource(source)) continue;
    for (const specifier of node.specifiers) {
         if (t.isImportSpecifier(specifier) && t.isIdentifier(specifier.local)) {
           this.translationFunctionNames.add(specifier.local.name);
-}
-     // Default import: import useT from '../../hooks/useT'
+ }
+        // Default import: import useT from '../../hooks/useT'
         if (t.isImportDefaultSpecifier(specifier) && t.isIdentifier(specifier.local)) {
           this.translationFunctionNames.add(specifier.local.name);
-      }
-// Namespace import: import * as i18n from '...'
-        if (t.isImportNamespaceSpecifier(specifier) && t.isIdentifier(specifier.local)) {
- this.translationFunctionNames.add(specifier.local.name);
         }
+        // Namespace import: import * as i18n from '...'
+        if (t.isImportNamespaceSpecifier(specifier) && t.isIdentifier(specifier.local)) {
+       this.translationFunctionNames.add(specifier.local.name);
+   }
       }
     }
   }
 
   /** Returns true if the import source string should be treated as a translation library. */
-private isTranslationImportSource(source: string): boolean {
+  private isTranslationImportSource(source: string): boolean {
     return this.importSourceMatchers.some((match) => match(source));
-  }
+}
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   private isInsideTranslationCall(nodePath: any): boolean {
     let current = nodePath.parentPath;
     while (current) {
       const node = current.node;
 
       // Function-call style: t('key')
-      if (t.isCallExpression(node)) {
+    if (t.isCallExpression(node)) {
         const callee = node.callee;
-        if (t.isIdentifier(callee) && this.translationFunctionNames.has(callee.name)) {
-    return true;
-      }
-  if (
-   t.isMemberExpression(callee) &&
-      t.isIdentifier(callee.property) &&
-          this.translationFunctionNames.has(callee.property.name)
-        ) {
-    return true;
+    if (t.isIdentifier(callee) && this.translationFunctionNames.has(callee.name)) {
+     return true;
         }
-      }
+        if (
+    t.isMemberExpression(callee) &&
+          t.isIdentifier(callee.property) &&
+        this.translationFunctionNames.has(callee.property.name)
+     ) {
+          return true;
+        }
+  }
 
-   // Bracket-notation accessor: t['key']  (MemberExpression, computed=true)
-   if (t.isMemberExpression(node) && node.computed) {
-        const obj = node.object;
+      // Bracket-notation accessor: t['key']  (MemberExpression, computed=true)
+      if (t.isMemberExpression(node) && node.computed) {
+   const obj = node.object;
         if (t.isIdentifier(obj) && this.translationFunctionNames.has(obj.name)) {
-          return true;
+    return true;
         }
       }
 
@@ -282,22 +293,23 @@ private isTranslationImportSource(source: string): boolean {
     context: TextContext,
     nodeType: string
   ): void {
-    const key = generateLocaleKey(
-    this.options.filePath,
+    const key = generateKeyByStyle(
+  this.options.filePath,
       text,
-   this.options.sourceRoot || 'src'
+      this.options.sourceRoot || 'src',
+      this.options.keyStyle || 'path'
     );
     this.detectedTexts.push({
       filePath: this.options.filePath,
       line,
       column,
-  text,
+      text,
     suggestedKey: key,
       context,
       nodeType,
-  alreadyTranslated: false,
-  });
-}
+ alreadyTranslated: false,
+    });
+  }
 
   private mapAttrToContext(attrName: string): TextContext {
     const lower = attrName.toLowerCase();
@@ -313,27 +325,28 @@ private isTranslationImportSource(source: string): boolean {
     const jsxTextRegex = />([^<>{}\n]+)</g;
     const lines = this.options.content.split('\n');
     lines.forEach((line, idx) => {
-      let m: RegExpExecArray | null;
-   jsxTextRegex.lastIndex = 0;
+    let m: RegExpExecArray | null;
+  jsxTextRegex.lastIndex = 0;
       while ((m = jsxTextRegex.exec(line)) !== null) {
         const text = normalizeText(m[1]);
         if (!isHumanReadableText(text)) continue;
-        const key = generateLocaleKey(
+        const key = generateKeyByStyle(
           this.options.filePath,
-          text,
-      this.options.sourceRoot || 'src'
-        );
+    text,
+          this.options.sourceRoot || 'src',
+          this.options.keyStyle || 'path'
+ );
         results.push({
       filePath: this.options.filePath,
-          line: idx + 1,
+    line: idx + 1,
           column: m.index,
-          text,
-          suggestedKey: key,
-       context: 'jsx-text',
+        text,
+ suggestedKey: key,
+   context: 'jsx-text',
           nodeType: 'regex-fallback',
-   alreadyTranslated: false,
-  });
-      }
+ alreadyTranslated: false,
+        });
+ }
     });
     return results;
   }
@@ -356,7 +369,7 @@ private isTranslationImportSource(source: string): boolean {
  *    comparing the **last N segments** of the import source with the
  *    last N segments of the configured value (case-insensitive, stripping
  *    leading dots and slashes).  This is intentionally lenient so that
- *  `hooks/useTranslation` matches both `../../hooks/useTranslation` and
+ *    `hooks/useTranslation` matches both `../../hooks/useTranslation` and
  *    `./hooks/useTranslation`.
  *
  * Examples:
@@ -365,8 +378,8 @@ private isTranslationImportSource(source: string): boolean {
  *     matches  "./hooks/useTranslation"     ✓  (same tail segments)
  *     matches  "../hooks/useTranslation"      ✓
  *   importPackage="@/i18n/hook"
- *     matches  "@/i18n/hook"     ✓
- * matches  "i18n/hook"       ✓
+ *     matches  "@/i18n/hook"✓
+ *     matches  "i18n/hook"       ✓
  */
 function buildImportMatcher(importPackage: string): (source: string) => boolean {
   // Normalise: strip leading ./ ../ @ and collapse slashes
@@ -374,20 +387,20 @@ function buildImportMatcher(importPackage: string): (source: string) => boolean
   const pkgSegments = normalisedPkg.split('/').filter(Boolean);
 
   return (source: string): boolean => {
-    // 1. Exact match (covers plain npm package names and exact alias paths)
-  if (source === importPackage) return true;
+  // 1. Exact match (covers plain npm package names and exact alias paths)
+    if (source === importPackage) return true;
 
     // 2. Suffix / tail-segment match
     const normSource = normalisePath(source);
-    const srcSegments = normSource.split('/').filter(Boolean);
+ const srcSegments = normSource.split('/').filter(Boolean);
 
     if (pkgSegments.length === 0) return false;
 
-    // Check if the source ends with the same N tail segments as the package
+// Check if the source ends with the same N tail segments as the package
     const n = pkgSegments.length;
-    if (srcSegments.length < n) return false;
+ if (srcSegments.length < n) return false;
     const tail = srcSegments.slice(-n);
-    return tail.every((seg, i) => seg.toLowerCase() === pkgSegments[i].toLowerCase());
+ return tail.every((seg, i) => seg.toLowerCase() === pkgSegments[i].toLowerCase());
   };
 }
 
@@ -396,5 +409,5 @@ function normalisePath(p: string): string {
   return p
     .replace(/\\/g, '/')
     .replace(/^(@\/|\.{1,2}\/)+/, '') // strip leading ./ ../ @/
-    .replace(/^@/, ''); // strip bare @ prefix
+ .replace(/^@/, ''); // strip bare @ prefix
 }

package/src/project-scanner.ts

@@ -29,10 +29,10 @@ export class ProjectScanner {
     this.config = config;
     // Resolve to absolute path so key-generator can use path.relative()
     // and never produce keys that include ancestor directory segments.
- this.sourceRoot = path.resolve(process.cwd(), config.sourceDir);
+    this.sourceRoot = path.resolve(process.cwd(), config.sourceDir);
     this.assetScanner = new AssetScanner(config.aws?.legacyCdnPattern);
     if (config.incrementalCache) {
-      this.cache = new IncrementalScanCache(
+    this.cache = new IncrementalScanCache(
         path.join(process.cwd(), config.cacheDir || '.ai-localize-cache')
       );
     }
@@ -43,51 +43,51 @@ export class ProjectScanner {
     let filesToScan: string[] = [];
 
     if (options.files?.length) {
-  filesToScan = options.files;
-  } else {
+      filesToScan = options.files;
+    } else {
       const allFiles = collectFiles(this.sourceRoot, SOURCE_EXTENSIONS, [
-  ...DEFAULT_IGNORE_DIRS,
-        ...(this.config.ignorePatterns || []),
-   ]);
-
-      if (this.config.includePatterns && this.config.includePatterns.length > 0) {
-    filesToScan = allFiles.filter(file => {
-return this.config.includePatterns!.some(pattern => {
-            const regexPattern = pattern.replace(/\*/g, '.*').replace(/\?/g, '.');
-  return new RegExp(regexPattern).test(file);
-   });
-      });
+        ...DEFAULT_IGNORE_DIRS,
+     ...(this.config.ignorePatterns || []),
+      ]);
+
+   if (this.config.includePatterns && this.config.includePatterns.length > 0) {
+      filesToScan = allFiles.filter(file => {
+      return this.config.includePatterns!.some(pattern => {
+   const regexPattern = pattern.replace(/\*/g, '.*').replace(/\?/g, '.');
+       return new RegExp(regexPattern).test(file);
+          });
+        });
       } else {
-        filesToScan = allFiles;
+  filesToScan = allFiles;
       }
     }
 
     const allTexts: DetectedText[] = [];
- const allAssets: AssetReference[] = [];
+    const allAssets: AssetReference[] = [];
     const allLegacyUrls: LegacyCdnUrl[] = [];
 
     const chunkSize = Math.max(
-      1,
-  Math.min(50, Math.ceil(filesToScan.length / (os.cpus().length || 4)))
+ 1,
+      Math.min(50, Math.ceil(filesToScan.length / (os.cpus().length || 4)))
     );
     const chunks = this.chunkArray(filesToScan, chunkSize);
 
     for (const chunk of chunks) {
-    const results = await Promise.all(chunk.map((f) => this.scanFile(f)));
- for (const r of results) {
+      const results = await Promise.all(chunk.map((f) => this.scanFile(f)));
+      for (const r of results) {
         allTexts.push(...r.texts);
         allAssets.push(...r.assets);
         allLegacyUrls.push(...r.legacyUrls);
       }
     }
 
- this.cache?.persist();
+    this.cache?.persist();
 
     return {
-framework: this.config.framework,
-      scannedFiles: filesToScan.length,
+      framework: this.config.framework,
+   scannedFiles: filesToScan.length,
       detectedTexts: allTexts,
-    assets: allAssets,
+      assets: allAssets,
       legacyCdnUrls: allLegacyUrls,
       duration: Date.now() - startTime,
       timestamp: new Date().toISOString(),
@@ -106,8 +106,8 @@ framework: this.config.framework,
 
     let content: string;
     try {
-      const { readFileSync } = await import('fs');
-      content = readFileSync(filePath, 'utf-8');
+   const { readFileSync } = await import('fs');
+   content = readFileSync(filePath, 'utf-8');
     } catch {
       return { texts: [], assets: [], legacyUrls: [] };
     }
@@ -116,13 +116,15 @@ framework: this.config.framework,
     // and strips only the project source directory — not ancestor segments.
     // Also pass codemods config so the scanner recognises user-defined
     // translation functions/hooks and skips already-translated strings.
+    // keyStyle controls whether keys are path-based (default) or SCREAMING_SNAKE.
     const scanner = new AstScanner({
       filePath,
       content,
       sourceRoot: this.sourceRoot,
       codemodConfig: this.config.codemods,
+      keyStyle: this.config.keyStyle ?? 'path',
     });
-    const texts = scanner.scan();
+  const texts = scanner.scan();
     const { assets, legacyCdnUrls } = this.assetScanner.scanFile(filePath);
 
     this.cache?.setCachedResult(filePath, texts);
@@ -133,7 +135,7 @@ framework: this.config.framework,
   private chunkArray<T>(array: T[], size: number): T[][] {
     const chunks: T[][] = [];
     for (let i = 0; i < array.length; i += size) {
-   chunks.push(array.slice(i, i + size));
+      chunks.push(array.slice(i, i + size));
     }
     return chunks;
   }