ai-localize-cli 2.0.7 → 3.1.0

package/CHANGELOG.md

@@ -1,7 +1,42 @@
 # ai-localize-cli
 
+## 3.1.0
+
+### Minor Changes
+
+- **`copyDefaultValues` config option** — `extract` command now passes `copyDefaultValues` from `ai-localize.config.json` to `LocaleExtractor`. When `true`, target language locale files are pre-populated with the default language's source text values instead of empty strings, ensuring the app always has a visible fallback while translators fill in proper translations.
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-localize-config@3.1.0
+  - ai-localize-locale-engine@3.1.0
+
+## 3.0.0
+
+### Major Changes
+
+- bug fixes
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-localize-aws-cloudfront@3.0.0
+  - ai-localize-codemods@3.0.0
+  - ai-localize-config@3.0.0
+  - ai-localize-framework-detectors@3.0.0
+  - ai-localize-locale-engine@3.0.0
+  - ai-localize-reporting@3.0.0
+  - ai-localize-scanner@3.0.0
+  - ai-localize-shared@3.0.0
+  - ai-localize-validators@3.0.0
+
 ## 2.0.7
 
+### Fixed
+
+- **`ai-localize scan` no longer crashes with `(0 , import_traverse.default) is not a function`** — Fixed `@babel/traverse` and `@babel/generator` CJS/ESM interop in the bundled CLI. The scanner and React codemod now work correctly when installed from npm.
+
 ### Minor Changes
 
 - **Scanner now correctly skips CSS class names, font-family values, camelCase identifiers,
@@ -39,7 +74,7 @@
 - **Bug fix — `full-migrate` pipeline appeared to do nothing**: Three issues fixed:
   1. `staticKeys` from `ai-localize.config.json` are now correctly passed to `LocaleExtractor`
      in the `full-migrate` command (the standalone `extract` command already did this).
-  2. `--dry-run` mode now prints a clear yellow banner, lists every locale file that *would*
+  2. `--dry-run` mode now prints a clear yellow banner, lists every locale file that _would_
      be written, and skips validation/report with an explanatory message — previously it
      produced no output for the write step, making the pipeline look inactive.
   3. Validation and report phases now run only in non-dry-run mode; error/warning details

package/dist/cli.js

@@ -247274,7 +247274,7 @@ var require_lib5 = __commonJS({
     Object.defineProperty(exports2, "traverse", {
       enumerable: true,
       get: function() {
-        return _traverse.default;
+        return _traverse3.default;
       }
     });
     Object.defineProperty(exports2, "traverseFast", {
@@ -247405,15 +247405,15 @@ var require_lib5 = __commonJS({
     var _getBindingIdentifiers = require_getBindingIdentifiers();
     var _getOuterBindingIdentifiers = require_getOuterBindingIdentifiers();
     var _getFunctionName = require_getFunctionName();
-    var _traverse = require_traverse();
-    Object.keys(_traverse).forEach(function(key) {
+    var _traverse3 = require_traverse();
+    Object.keys(_traverse3).forEach(function(key) {
       if (key === "default" || key === "__esModule") return;
       if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-      if (key in exports2 && exports2[key] === _traverse[key]) return;
+      if (key in exports2 && exports2[key] === _traverse3[key]) return;
       Object.defineProperty(exports2, key, {
         enumerable: true,
         get: function() {
-          return _traverse[key];
+          return _traverse3[key];
         }
       });
     });
@@ -248038,8 +248038,8 @@ var require_traverseForScope = __commonJS({
       if (exploded.enter || exploded.exit) {
         throw new Error("Should not be used with enter/exit visitors.");
       }
-      _traverse(path19.parentPath, path19.parent, path19.node, path19.container, path19.key, path19.listKey, path19.hub, path19);
-      function _traverse(parentPath, parent, node, container, key, listKey, hub, inPath) {
+      _traverse3(path19.parentPath, path19.parent, path19.node, path19.container, path19.key, path19.listKey, path19.hub, path19);
+      function _traverse3(parentPath, parent, node, container, key, listKey, hub, inPath) {
         if (!node) {
           return;
         }
@@ -248071,10 +248071,10 @@ var require_traverseForScope = __commonJS({
           if (Array.isArray(prop)) {
             for (let i7 = 0; i7 < prop.length; i7++) {
               const value = prop[i7];
-              _traverse(path20, node, value, prop, i7, key2);
+              _traverse3(path20, node, value, prop, i7, key2);
             }
           } else {
-            _traverse(path20, node, prop, node, key2, null);
+            _traverse3(path20, node, prop, node, key2, null);
           }
         }
         if (visitor != null && visitor.exit) {
@@ -294057,7 +294057,7 @@ async function batchReplaceCdnUrls(fileUrlMap, assets, dryRun = false) {
   }
   return results;
 }
-var fs10, nodePath2, parser3, import_traverse2, import_generator, t9, fs24, fs33, fs43, path11, path24, DEFAULT_IMPORT_PACKAGE, DEFAULT_HOOK_NAME, DEFAULT_TRANSLATION_FN, DEFAULT_ACCESSOR_STYLE, ReactCodemod, DEFAULT_TRANSLATION_FN2, VueCodemod, DEFAULT_TS_SERVICE, DEFAULT_TEMPLATE_PIPE, AngularCodemod, CdnReplacer, CodemodRunner;
+var fs10, nodePath2, parser3, import_traverse2, import_generator, t9, fs24, fs33, fs43, path11, path24, traverse2, generate, DEFAULT_IMPORT_PACKAGE, DEFAULT_HOOK_NAME, DEFAULT_TRANSLATION_FN, DEFAULT_ACCESSOR_STYLE, ReactCodemod, DEFAULT_TRANSLATION_FN2, VueCodemod, DEFAULT_TS_SERVICE, DEFAULT_TEMPLATE_PIPE, AngularCodemod, CdnReplacer, CodemodRunner;
 var init_dist = __esm({
   "../../packages/codemods/dist/index.mjs"() {
     "use strict";
@@ -294072,6 +294072,8 @@ var init_dist = __esm({
     fs43 = __toESM(require("fs"), 1);
     path11 = __toESM(require("path"), 1);
     path24 = __toESM(require("path"), 1);
+    traverse2 = import_traverse2.default.default ?? import_traverse2.default;
+    generate = import_generator.default.default ?? import_generator.default;
     DEFAULT_IMPORT_PACKAGE = "react-i18next";
     DEFAULT_HOOK_NAME = "useTranslation";
     DEFAULT_TRANSLATION_FN = "t";
@@ -294158,7 +294160,7 @@ var init_dist = __esm({
           }
           return t9.callExpression(t9.identifier(translationFn), [t9.stringLiteral(key)]);
         };
-        (0, import_traverse2.default)(ast, {
+        traverse2(ast, {
           ImportDeclaration(nodePath22) {
             if (nodePath22.node.source.value === importSpecifier2) {
               hasImport = true;
@@ -294173,7 +294175,7 @@ var init_dist = __esm({
             }
           }
         });
-        (0, import_traverse2.default)(ast, {
+        traverse2(ast, {
           JSXText(nodePath22) {
             const text = nodePath22.node.value.trim();
             if (!text) return;
@@ -294225,7 +294227,7 @@ var init_dist = __esm({
           this.injectHook(ast);
           injectedHook = true;
         }
-        const output = (0, import_generator.default)(
+        const output = generate(
           ast,
           { retainLines: false, comments: true, compact: false },
           this.content
@@ -294244,7 +294246,7 @@ var init_dist = __esm({
         const hookName = this.hookName;
         const translationFn = this.translationFn;
         const namespace = this.namespace;
-        (0, import_traverse2.default)(ast, {
+        traverse2(ast, {
           FunctionDeclaration(nodePath22) {
             if (!isReactComponent(nodePath22.node.id?.name)) return;
             injectHookIntoBody(nodePath22.node.body, hookName, translationFn, namespace);
@@ -298929,7 +298931,24 @@ var LocalizationConfigSchema = external_exports.object({
    * Example:
    *   "ignoreTextPatterns": ["^MyBrand", "^theme-", "^data-"]
    */
-  ignoreTextPatterns: external_exports.array(external_exports.string()).default([])
+  ignoreTextPatterns: external_exports.array(external_exports.string()).default([]),
+  /**
+   * When `true`, target language locale files are pre-populated with the same
+   * source text values as the default language instead of empty strings.
+   *
+   * This ensures the app always has a visible fallback value while translators
+   * work on proper translations. Empty-string values cause the UI to show
+   * nothing at all for untranslated keys.
+   *
+   * Applies to both `extract` (new files) and `sync` (adding missing keys to
+   * existing files).
+   *
+   * Defaults to `false`.
+   *
+   * Example:
+   *   "copyDefaultValues": true
+   */
+  copyDefaultValues: external_exports.boolean().default(false)
 });
 async function loadConfig(cwd = process.cwd(), overrides = {}) {
   dotenv.config({ path: path2.join(cwd, ".env") });
@@ -299339,6 +299358,7 @@ var os = __toESM(require("os"), 1);
 var crypto22 = __toESM(require("crypto"), 1);
 var import_child_process = require("child_process");
 var path42 = __toESM(require("path"), 1);
+var traverse = import_traverse.default.default ?? import_traverse.default;
 var BUILTIN_TRANSLATION_IMPORT_SOURCES = /* @__PURE__ */ new Set([
   "react-i18next",
   "i18next",
@@ -299634,7 +299654,7 @@ var AstScanner = class {
       return this.regexFallbackScan();
     }
     this.collectTranslationImports(ast);
-    (0, import_traverse.default)(ast, {
+    traverse(ast, {
       // ── JSX text nodes: <h1>Welcome</h1> ───────────────────────────────────
       JSXText: (nodePath3) => {
         const text = normalizeText(nodePath3.node.value);
@@ -300271,7 +300291,8 @@ var LocaleExtractor = class {
       defaultLanguage: options.defaultLanguage || "en",
       targetLanguages: options.targetLanguages || [],
       namespaceSplitting: options.namespaceSplitting ?? true,
-      staticKeys: options.staticKeys ?? {}
+      staticKeys: options.staticKeys ?? {},
+      copyDefaultValues: options.copyDefaultValues ?? false
     };
   }
   extract(detectedTexts) {
@@ -300314,7 +300335,7 @@ var LocaleExtractor = class {
     for (const lang of allLanguages) {
       for (const [namespace, entries] of namespaceMap) {
         const isDefault = lang === this.options.defaultLanguage;
-        const langEntries = isDefault ? { ...entries } : Object.fromEntries(Object.keys(entries).map((k7) => [k7, ""]));
+        const langEntries = isDefault || this.options.copyDefaultValues ? { ...entries } : Object.fromEntries(Object.keys(entries).map((k7) => [k7, ""]));
         localeFiles.push({ language: lang, namespace, entries: langEntries, filePath: "" });
       }
     }
@@ -300469,7 +300490,8 @@ function extractCommand() {
         targetLanguages: config2.targetLanguages,
         namespaceSplitting: structure === "nested",
         // flat mode does not need namespace splitting
-        staticKeys
+        staticKeys,
+        copyDefaultValues: config2.copyDefaultValues
       });
       const { localeFiles, keyCount, namespaces } = extractor.extract(uniqueTexts);
       logger.info(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-localize-cli",
-  "version": "2.0.7",
+  "version": "3.1.0",
   "description": "CLI for ai-localize-core: scan, extract, validate, codemod and migrate CDN",
   "author": "ai-localize-core contributors",
   "license": "MIT",
@@ -46,15 +46,15 @@
     "chalk": "^5.3.0",
     "ora": "^8.0.1",
     "inquirer": "^9.2.12",
-    "ai-localize-config": "2.0.7",
-    "ai-localize-framework-detectors": "2.0.7",
-    "ai-localize-scanner": "2.0.7",
-    "ai-localize-shared": "2.0.7",
-    "ai-localize-codemods": "2.0.7",
-    "ai-localize-locale-engine": "2.0.7",
-    "ai-localize-validators": "2.0.7",
-    "ai-localize-aws-cloudfront": "2.0.7",
-    "ai-localize-reporting": "2.0.7"
+    "ai-localize-shared": "3.0.0",
+    "ai-localize-config": "3.1.0",
+    "ai-localize-codemods": "3.0.0",
+    "ai-localize-scanner": "3.0.0",
+    "ai-localize-framework-detectors": "3.0.0",
+    "ai-localize-validators": "3.0.0",
+    "ai-localize-locale-engine": "3.1.0",
+    "ai-localize-aws-cloudfront": "3.0.0",
+    "ai-localize-reporting": "3.0.0"
   },
   "devDependencies": {
     "@types/inquirer": "^9.0.7",