ai-localize-config 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ai-localize-config
 
+## 3.1.0
+
+### Minor Changes
+
+- **`copyDefaultValues` config field** — Added `copyDefaultValues: boolean` (default `false`) to `LocalizationConfigSchema`. 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.
+
 ## 3.0.0
 
 ### Major Changes

package/dist/index.d.mts

@@ -133,6 +133,23 @@ declare const LocalizationConfigSchema: z.ZodObject<{
      *   "ignoreTextPatterns": ["^MyBrand", "^theme-", "^data-"]
      */
     ignoreTextPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 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: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     framework: "react" | "react-cra" | "react-vite" | "react-nextjs" | "angular" | "angular-ngx" | "angular-i18n" | "vue" | "vue-i18n" | "jquery" | "vanilla-js" | "jsp" | "unknown";
     defaultLanguage: string;
@@ -146,6 +163,7 @@ declare const LocalizationConfigSchema: z.ZodObject<{
     localeStructure: "flat" | "nested";
     keyStyle: "path" | "screaming_snake";
     ignoreTextPatterns: string[];
+    copyDefaultValues: boolean;
     keyPrefix?: string | undefined;
     namespaces?: string[] | undefined;
     includePatterns?: string[] | undefined;
@@ -199,6 +217,7 @@ declare const LocalizationConfigSchema: z.ZodObject<{
     keyStyle?: "path" | "screaming_snake" | undefined;
     staticKeys?: Record<string, string> | undefined;
     ignoreTextPatterns?: string[] | undefined;
+    copyDefaultValues?: boolean | undefined;
 }>;
 type LocalizationConfigInput = z.input<typeof LocalizationConfigSchema>;
 type LocalizationConfigOutput = z.output<typeof LocalizationConfigSchema>;

package/dist/index.d.ts

@@ -133,6 +133,23 @@ declare const LocalizationConfigSchema: z.ZodObject<{
      *   "ignoreTextPatterns": ["^MyBrand", "^theme-", "^data-"]
      */
     ignoreTextPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 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: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     framework: "react" | "react-cra" | "react-vite" | "react-nextjs" | "angular" | "angular-ngx" | "angular-i18n" | "vue" | "vue-i18n" | "jquery" | "vanilla-js" | "jsp" | "unknown";
     defaultLanguage: string;
@@ -146,6 +163,7 @@ declare const LocalizationConfigSchema: z.ZodObject<{
     localeStructure: "flat" | "nested";
     keyStyle: "path" | "screaming_snake";
     ignoreTextPatterns: string[];
+    copyDefaultValues: boolean;
     keyPrefix?: string | undefined;
     namespaces?: string[] | undefined;
     includePatterns?: string[] | undefined;
@@ -199,6 +217,7 @@ declare const LocalizationConfigSchema: z.ZodObject<{
     keyStyle?: "path" | "screaming_snake" | undefined;
     staticKeys?: Record<string, string> | undefined;
     ignoreTextPatterns?: string[] | undefined;
+    copyDefaultValues?: boolean | undefined;
 }>;
 type LocalizationConfigInput = z.input<typeof LocalizationConfigSchema>;
 type LocalizationConfigOutput = z.output<typeof LocalizationConfigSchema>;

package/dist/index.js

@@ -159,7 +159,24 @@ var LocalizationConfigSchema = import_zod.z.object({
    * Example:
    *   "ignoreTextPatterns": ["^MyBrand", "^theme-", "^data-"]
    */
-  ignoreTextPatterns: import_zod.z.array(import_zod.z.string()).default([])
+  ignoreTextPatterns: import_zod.z.array(import_zod.z.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: import_zod.z.boolean().default(false)
 });
 
 // src/loader.ts

package/dist/index.mjs

@@ -120,7 +120,24 @@ var LocalizationConfigSchema = z.object({
    * Example:
    *   "ignoreTextPatterns": ["^MyBrand", "^theme-", "^data-"]
    */
-  ignoreTextPatterns: z.array(z.string()).default([])
+  ignoreTextPatterns: z.array(z.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: z.boolean().default(false)
 });
 
 // src/loader.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-localize-config",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Configuration loader and schema validator for ai-localize-core",
   "author": "ai-localize-core contributors",
   "license": "MIT",