ai-localize-cli 2.0.1 → 2.0.3

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # ai-localize-cli
 
+## 2.0.3
+
+### Minor Changes
+
+- **`keyStyle` config option** — `extract` and `full-migrate` commands now respect `keyStyle: "screaming_snake"` in `ai-localize.config.json`; all scanned hardcoded strings are extracted with UPPER_SNAKE_CASE keys matching the text value (e.g. `"Save Changes"` -> key `SAVE_CHANGES`, value `"Save Changes"`) instead of the default hierarchical path-based key style
+- **`staticKeys` config option** — `extract` and `full-migrate` commands now inject `staticKeys` entries from config into every generated locale file regardless of scanning results; useful for enum labels, status codes, and other constant strings not present as literals in source files
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-localize-scanner@2.0.3
+  - ai-localize-config@2.0.3
+  - ai-localize-shared@2.0.3
+  - ai-localize-aws-cloudfront@2.0.3
+  - ai-localize-codemods@2.0.3
+  - ai-localize-framework-detectors@2.0.3
+  - ai-localize-locale-engine@2.0.3
+  - ai-localize-reporting@2.0.3
+  - ai-localize-validators@2.0.3
+
+## 2.0.2
+
+### Minor Changes
+
+- **Flat locale layout in `extract` and `full-migrate` commands** — `--locale-structure flat` flag (or `localeStructure: "flat"` in config) now writes one `<lang>.json` per language with all namespace keys merged
+- **Rich CLI report output** — `report` command now renders a structured terminal dashboard with coverage bars, top-file charts, missing-translation rankings, AST-context distribution, AI Insights, and actionable recommended next steps
+- **HTML analytics dashboard** — `report --format html` now generates a fully self-contained interactive dashboard (light/dark theme, sortable tables, SVG donut chart, CSV/JSON export, print/PDF)
+
+### Patch Changes
+
+- **Bug fix — locale key prefix** — resolved an issue where locale keys included ancestor path segments when `sourceRoot` was an absolute path
+- **Bug fix — codemods config wired through** — `codemods` block in `ai-localize.config.json` is now applied by all codemod commands instead of being silently ignored
+- Updated dependencies
+  - ai-localize-scanner@2.0.2
+  - ai-localize-config@2.0.2
+  - ai-localize-shared@2.0.2
+  - ai-localize-aws-cloudfront@2.0.2
+  - ai-localize-codemods@2.0.2
+  - ai-localize-framework-detectors@2.0.2
+  - ai-localize-locale-engine@2.0.2
+  - ai-localize-reporting@2.0.2
+  - ai-localize-validators@2.0.2
+
 ## 2.0.1
 
 ### Patch Changes

package/dist/cli.js

@@ -167,6 +167,13 @@ function extractCommand() {
       spinner.succeed("Configuration loaded");
       const structure = config.localeStructure ?? "nested";
       logger.info("Locale structure: " + import_chalk4.default.cyan(structure));
+      const staticKeys = config.staticKeys ?? {};
+      const staticKeyCount = Object.keys(staticKeys).length;
+      if (staticKeyCount > 0) {
+        logger.info(
+          "Static keys: " + import_chalk4.default.cyan(String(staticKeyCount)) + " (" + Object.keys(staticKeys).join(", ") + ")"
+        );
+      }
       const ss = createSpinner("Scanning for hardcoded text...").start();
       const scanner = new import_ai_localize_scanner2.ProjectScanner(config);
       const scanResult = await scanner.scan();
@@ -176,11 +183,14 @@ function extractCommand() {
       const extractor = new import_ai_localize_locale_engine.LocaleExtractor({
         defaultLanguage: config.defaultLanguage,
         targetLanguages: config.targetLanguages,
-        namespaceSplitting: structure === "nested"
+        namespaceSplitting: structure === "nested",
         // flat mode does not need namespace splitting
+        staticKeys
       });
       const { localeFiles, keyCount, namespaces } = extractor.extract(uniqueTexts);
-      logger.info("Keys generated: " + import_chalk4.default.green(String(keyCount)));
+      logger.info(
+        "Keys generated: " + import_chalk4.default.green(String(keyCount)) + (staticKeyCount > 0 ? import_chalk4.default.dim(" (+ " + staticKeyCount + " static)") : "")
+      );
       if (structure === "nested") {
         logger.info("Namespaces: " + import_chalk4.default.cyan(namespaces.join(", ")));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-localize-cli",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "CLI for ai-localize-core: scan, extract, validate, migrate CDN",
   "bin": {
     "ai-localize": "./dist/cli.js"
@@ -11,15 +11,15 @@
     "chalk": "^5.3.0",
     "ora": "^8.0.1",
     "inquirer": "^9.2.12",
-    "ai-localize-shared": "2.0.1",
-    "ai-localize-framework-detectors": "2.0.1",
-    "ai-localize-config": "2.0.1",
-    "ai-localize-scanner": "2.0.1",
-    "ai-localize-codemods": "2.0.1",
-    "ai-localize-locale-engine": "2.0.1",
-    "ai-localize-aws-cloudfront": "2.0.1",
-    "ai-localize-validators": "2.0.1",
-    "ai-localize-reporting": "2.0.1"
+    "ai-localize-framework-detectors": "2.0.3",
+    "ai-localize-shared": "2.0.3",
+    "ai-localize-config": "2.0.3",
+    "ai-localize-scanner": "2.0.3",
+    "ai-localize-aws-cloudfront": "2.0.3",
+    "ai-localize-validators": "2.0.3",
+    "ai-localize-locale-engine": "2.0.3",
+    "ai-localize-reporting": "2.0.3",
+    "ai-localize-codemods": "2.0.3"
   },
   "devDependencies": {
     "@types/inquirer": "^9.0.7",

package/src/commands/extract.ts

@@ -17,56 +17,76 @@ export function extractCommand(): Command {
       logger.header('ai-localize extract');
       const cwd = opts.cwd as string;
       const spinner = createSpinner('Loading configuration...').start();
-   try {
+      try {
         const { config } = await loadConfig(cwd);
         spinner.succeed('Configuration loaded');
 
         // Log locale structure in use
-        const structure = config.localeStructure ?? 'nested';
+      const structure = config.localeStructure ?? 'nested';
         logger.info('Locale structure: ' + chalk.cyan(structure));
 
-   const ss = createSpinner('Scanning for hardcoded text...').start();
-        const scanner = new ProjectScanner(config);
+        // Log static keys if configured
+        const staticKeys = config.staticKeys ?? {};
+      const staticKeyCount = Object.keys(staticKeys).length;
+        if (staticKeyCount > 0) {
+     logger.info(
+          'Static keys: ' +
+         chalk.cyan(String(staticKeyCount)) +
+  ' (' +
+     Object.keys(staticKeys).join(', ') +
+    ')'
+ );
+        }
+
+        const ss = createSpinner('Scanning for hardcoded text...').start();
+ const scanner = new ProjectScanner(config);
         const scanResult = await scanner.scan();
-     ss.succeed('Found ' + chalk.cyan(String(scanResult.detectedTexts.length)) + ' texts in ' + scanResult.scannedFiles + ' files');
+      ss.succeed('Found ' + chalk.cyan(String(scanResult.detectedTexts.length)) + ' texts in ' + scanResult.scannedFiles + ' files');
 
- const uniqueTexts = deduplicateTexts(scanResult.detectedTexts);
-     logger.info('Unique texts: ' + chalk.cyan(String(uniqueTexts.length)));
+      const uniqueTexts = deduplicateTexts(scanResult.detectedTexts);
+   logger.info('Unique texts: ' + chalk.cyan(String(uniqueTexts.length)));
 
-      const extractor = new LocaleExtractor({
-   defaultLanguage: config.defaultLanguage,
-      targetLanguages: config.targetLanguages,
-          namespaceSplitting: structure === 'nested', // flat mode does not need namespace splitting
-    });
+        const extractor = new LocaleExtractor({
+    defaultLanguage: config.defaultLanguage,
+          targetLanguages: config.targetLanguages,
+    namespaceSplitting: structure === 'nested', // flat mode does not need namespace splitting
+          staticKeys,
+        });
         const { localeFiles, keyCount, namespaces } = extractor.extract(uniqueTexts);
-        logger.info('Keys generated: ' + chalk.green(String(keyCount)));
-        if (structure === 'nested') {
-          logger.info('Namespaces: ' + chalk.cyan(namespaces.join(', ')));
+        logger.info(
+  'Keys generated: ' +
+            chalk.green(String(keyCount)) +
+   (staticKeyCount > 0
+         ? chalk.dim(' (+ ' + staticKeyCount + ' static)')
+              : '')
+ );
+ if (structure === 'nested') {
+   logger.info('Namespaces: ' + chalk.cyan(namespaces.join(', ')));
         }
 
-     if (!opts.dryRun) {
+        if (!opts.dryRun) {
           const localesDir = path.resolve(cwd, config.localesDir);
-    const writer = new LocaleWriter({
-      localesDir,
-            merge: opts.merge !== false,
-        localeStructure: structure,
+          const writer = new LocaleWriter({
+            localesDir,
+       merge: opts.merge !== false,
+    localeStructure: structure,
           });
-     const { written, created, merged } = writer.write(localeFiles);
+ const { written, created, merged } = writer.write(localeFiles);
           logger.success(
-            'Wrote ' + written.length + ' locale files (' + created.length + ' new, ' + merged.length + ' merged)'
-  );
+     'Wrote ' + written.length + ' locale files (' + created.length + ' new, ' + merged.length + ' merged)'
+          );
           written.forEach((f) => logger.info('  ' + chalk.gray(f)));
         } else {
           logger.info('Dry run — no files written');
           localeFiles.forEach((lf) => {
-        const label = structure === 'flat'
-              ? `${lf.language}.json`
-              : `${lf.language}/${lf.namespace}.json`;
-  logger.info('  ' + chalk.gray(label) + ' — ' + Object.keys(lf.entries).length + ' keys');
+const label = structure === 'flat'
+           ? `${lf.language}.json`
+           : `${lf.language}/${lf.namespace}.json`;
+            logger.info('  ' + chalk.gray(label) + ' — ' + Object.keys(lf.entries).length + ' keys');
      });
         }
       } catch (err) {
- spinner.fail('Extraction failed');
+        spinner.fail('Extraction failed');
         logger.error(String(err));
         process.exit(1);
       }