lingo.dev 0.92.7 → 0.92.9

package/build/cli.mjs

@@ -1,8 +1,8 @@
 // src/cli/index.ts
 import dotenv from "dotenv";
 import { InteractiveCommand as InteractiveCommand2 } from "interactive-commander";
-import figlet2 from "figlet";
-import { vice as vice2 } from "gradient-string";
+import figlet3 from "figlet";
+import { vice as vice3 } from "gradient-string";
 
 // src/cli/cmd/auth.ts
 import { Command } from "interactive-commander";
@@ -850,46 +850,67 @@ import Ora4 from "ora";
 import _5 from "lodash";
 import path9 from "path";
 import { glob as glob2 } from "glob";
-import { resolveOverriddenLocale } from "@lingo.dev/_spec";
+import {
+  resolveOverriddenLocale
+} from "@lingo.dev/_spec";
 function getBuckets(i18nConfig) {
-  const result = Object.entries(i18nConfig.buckets).map(([bucketType, bucketEntry]) => {
-    const includeItems = bucketEntry.include.map((item) => resolveBucketItem(item));
-    const excludeItems = bucketEntry.exclude?.map((item) => resolveBucketItem(item));
-    const config = {
-      type: bucketType,
-      paths: extractPathPatterns(i18nConfig.locale.source, includeItems, excludeItems)
-    };
-    if (bucketEntry.injectLocale) {
-      config.injectLocale = bucketEntry.injectLocale;
-    }
-    if (bucketEntry.lockedKeys) {
-      config.lockedKeys = bucketEntry.lockedKeys;
-    }
-    if (bucketEntry.lockedPatterns) {
-      config.lockedPatterns = bucketEntry.lockedPatterns;
+  const result = Object.entries(i18nConfig.buckets).map(
+    ([bucketType, bucketEntry]) => {
+      const includeItems = bucketEntry.include.map(
+        (item) => resolveBucketItem(item)
+      );
+      const excludeItems = bucketEntry.exclude?.map(
+        (item) => resolveBucketItem(item)
+      );
+      const config = {
+        type: bucketType,
+        paths: extractPathPatterns(
+          i18nConfig.locale.source,
+          includeItems,
+          excludeItems
+        )
+      };
+      if (bucketEntry.injectLocale) {
+        config.injectLocale = bucketEntry.injectLocale;
+      }
+      if (bucketEntry.lockedKeys) {
+        config.lockedKeys = bucketEntry.lockedKeys;
+      }
+      if (bucketEntry.lockedPatterns) {
+        config.lockedPatterns = bucketEntry.lockedPatterns;
+      }
+      if (bucketEntry.ignoredKeys) {
+        config.ignoredKeys = bucketEntry.ignoredKeys;
+      }
+      return config;
     }
-    return config;
-  });
+  );
   return result;
 }
 function extractPathPatterns(sourceLocale, include, exclude) {
   const includedPatterns = include.flatMap(
-    (pattern) => expandPlaceholderedGlob(pattern.path, resolveOverriddenLocale(sourceLocale, pattern.delimiter)).map(
-      (pathPattern) => ({
-        pathPattern,
-        delimiter: pattern.delimiter
-      })
-    )
+    (pattern) => expandPlaceholderedGlob(
+      pattern.path,
+      resolveOverriddenLocale(sourceLocale, pattern.delimiter)
+    ).map((pathPattern) => ({
+      pathPattern,
+      delimiter: pattern.delimiter
+    }))
   );
   const excludedPatterns = exclude?.flatMap(
-    (pattern) => expandPlaceholderedGlob(pattern.path, resolveOverriddenLocale(sourceLocale, pattern.delimiter)).map(
-      (pathPattern) => ({
-        pathPattern,
-        delimiter: pattern.delimiter
-      })
-    )
+    (pattern) => expandPlaceholderedGlob(
+      pattern.path,
+      resolveOverriddenLocale(sourceLocale, pattern.delimiter)
+    ).map((pathPattern) => ({
+      pathPattern,
+      delimiter: pattern.delimiter
+    }))
+  );
+  const result = _5.differenceBy(
+    includedPatterns,
+    excludedPatterns ?? [],
+    (item) => item.pathPattern
   );
-  const result = _5.differenceBy(includedPatterns, excludedPatterns ?? [], (item) => item.pathPattern);
   return result;
 }
 function expandPlaceholderedGlob(_pathPattern, sourceLocale) {
@@ -908,12 +929,15 @@ function expandPlaceholderedGlob(_pathPattern, sourceLocale) {
     });
   }
   const pathPatternChunks = pathPattern.split(path9.sep);
-  const localeSegmentIndexes = pathPatternChunks.reduce((indexes, segment, index) => {
-    if (segment.includes("[locale]")) {
-      indexes.push(index);
-    }
-    return indexes;
-  }, []);
+  const localeSegmentIndexes = pathPatternChunks.reduce(
+    (indexes, segment, index) => {
+      if (segment.includes("[locale]")) {
+        indexes.push(index);
+      }
+      return indexes;
+    },
+    []
+  );
   const sourcePathPattern = pathPattern.replaceAll(/\[locale\]/g, sourceLocale);
   const sourcePaths = glob2.sync(sourcePathPattern, { follow: true, withFileTypes: true }).filter((file) => file.isFile() || file.isSymbolicLink()).map((file) => file.fullpath()).map((fullpath) => path9.relative(process.cwd(), fullpath));
   const placeholderedPaths = sourcePaths.map((sourcePath) => {
@@ -1001,7 +1025,7 @@ import {
 } from "@lingo.dev/_spec";
 import { Command as Command6 } from "interactive-commander";
 import Z3 from "zod";
-import _24 from "lodash";
+import _25 from "lodash";
 import * as path14 from "path";
 import Ora5 from "ora";
 
@@ -1226,7 +1250,7 @@ function createTextFileLoader(pathPattern) {
       const trimmedResult = result.trim();
       return trimmedResult;
     },
-    async push(locale, data, _27, originalLocale) {
+    async push(locale, data, _29, originalLocale) {
       const draftPath = pathPattern.replaceAll("[locale]", locale);
       const finalPath = path10.resolve(draftPath);
       const dirPath = path10.dirname(finalPath);
@@ -1540,6 +1564,9 @@ function createCsvLoader() {
         skip_empty_lines: true
       });
       const columns = input2.length > 0 ? Object.keys(input2[0]) : ["id", locale];
+      if (!columns.includes(locale)) {
+        columns.push(locale);
+      }
       const updatedRows = input2.map((row) => ({
         ...row,
         [locale]: data[row.id] || row[locale] || ""
@@ -1752,7 +1779,7 @@ function createPropertiesLoader() {
       return result;
     },
     async push(locale, payload) {
-      const result = Object.entries(payload).filter(([_27, value]) => value != null).map(([key, value]) => `${key}=${value}`).join("\n");
+      const result = Object.entries(payload).filter(([_29, value]) => value != null).map(([key, value]) => `${key}=${value}`).join("\n");
       return result;
     }
   });
@@ -2019,10 +2046,10 @@ function createUnlocalizableLoader(isCacheRestore = false, returnUnlocalizedKeys
           }
         }
         return false;
-      }).map(([key, _27]) => key);
-      const result = _10.omitBy(input2, (_27, key) => passthroughKeys.includes(key));
+      }).map(([key, _29]) => key);
+      const result = _10.omitBy(input2, (_29, key) => passthroughKeys.includes(key));
       if (returnUnlocalizedKeys) {
-        result.unlocalizable = _10.omitBy(input2, (_27, key) => !passthroughKeys.includes(key));
+        result.unlocalizable = _10.omitBy(input2, (_29, key) => !passthroughKeys.includes(key));
       }
       return result;
     },
@@ -3653,8 +3680,23 @@ function createMdxLockedPatternsLoader(defaultPatterns) {
   });
 }
 
+// src/cli/loaders/ignored-keys.ts
+import _23 from "lodash";
+function createIgnoredKeysLoader(ignoredKeys) {
+  return createLoader({
+    pull: async (locale, data) => {
+      const result = _23.chain(data).omit(ignoredKeys).value();
+      return result;
+    },
+    push: async (locale, data, originalInput, originalLocale, pullInput) => {
+      const result = _23.merge({}, data, _23.pick(pullInput, ignoredKeys));
+      return result;
+    }
+  });
+}
+
 // src/cli/loaders/index.ts
-function createBucketLoader(bucketType, bucketPathPattern, options, lockedKeys, lockedPatterns) {
+function createBucketLoader(bucketType, bucketPathPattern, options, lockedKeys, lockedPatterns, ignoredKeys) {
   switch (bucketType) {
     default:
       throw new Error(`Unsupported bucket type: ${bucketType}`);
@@ -3913,6 +3955,8 @@ function createBucketLoader(bucketType, bucketPathPattern, options, lockedKeys,
         createTypescriptLoader(),
         createFlatLoader(),
         createSyncLoader(),
+        createLockedKeysLoader(lockedKeys || [], options.isCacheRestore),
+        createIgnoredKeysLoader(ignoredKeys || []),
         createUnlocalizableLoader(
           options.isCacheRestore,
           options.returnUnlocalizedKeys
@@ -3922,11 +3966,15 @@ function createBucketLoader(bucketType, bucketPathPattern, options, lockedKeys,
 }
 
 // src/cli/cmd/i18n.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 import { createTwoFilesPatch } from "diff";
 import inquirer2 from "inquirer";
 import externalEditor from "external-editor";
 
+// src/cli/processor/index.ts
+import chalk from "chalk";
+import dedent from "dedent";
+
 // src/cli/processor/lingo.ts
 import { LingoDotDevEngine } from "@lingo.dev/_sdk";
 function createLingoLocalizer(params) {
@@ -3961,9 +4009,6 @@ function createBasicTranslator(model, systemPrompt) {
     if (!Object.keys(input2.processableData).length) {
       return input2.processableData;
     }
-    if (!process.env.OPENAI_API_KEY) {
-      throw new Error("OPENAI_API_KEY is not set");
-    }
     const response = await generateText({
       model,
       messages: [
@@ -4011,9 +4056,21 @@ function createBasicTranslator(model, systemPrompt) {
 
 // src/cli/processor/index.ts
 import { createOpenAI } from "@ai-sdk/openai";
+
+// src/cli/constants.ts
+var colors = {
+  orange: "#ff6600",
+  green: "#6ae300",
+  blue: "#0090ff",
+  yellow: "#ffcc00",
+  grey: "#808080",
+  red: "#ff0000"
+};
+
+// src/cli/processor/index.ts
 import { createAnthropic } from "@ai-sdk/anthropic";
 function createProcessor(provider, params) {
-  if (!provider || provider.id === "lingo") {
+  if (!provider) {
     const result = createLingoLocalizer(params);
     return result;
   } else {
@@ -4023,10 +4080,30 @@ function createProcessor(provider, params) {
   }
 }
 function getPureModelProvider(provider) {
+  const createMissingKeyErrorMessage = (providerId, envVar) => dedent`
+  You're trying to use raw ${chalk.dim(providerId)} API for translation, however, ${chalk.dim(envVar)} environment variable is not set.
+
+  To fix this issue:
+  1. Set ${chalk.dim(envVar)} in your environment variables, or
+  2. Remove the ${chalk.italic("provider")} node from your i18n.json configuration to switch to ${chalk.hex(colors.green)("Lingo.dev")}
+
+  ${chalk.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
+`;
+  const createUnsupportedProviderErrorMessage = (providerId) => dedent`
+  You're trying to use unsupported provider: ${chalk.dim(providerId)}.
+
+  To fix this issue:
+  1. Switch to one of the supported providers, or
+  2. Remove the ${chalk.italic("provider")} node from your i18n.json configuration to switch to ${chalk.hex(colors.green)("Lingo.dev")}
+
+  ${chalk.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
+  `;
   switch (provider?.id) {
     case "openai":
       if (!process.env.OPENAI_API_KEY) {
-        throw new Error("OPENAI_API_KEY is not set.");
+        throw new Error(
+          createMissingKeyErrorMessage("OpenAI", "OPENAI_API_KEY")
+        );
       }
       return createOpenAI({
         apiKey: process.env.OPENAI_API_KEY,
@@ -4034,13 +4111,15 @@ function getPureModelProvider(provider) {
       })(provider.model);
     case "anthropic":
       if (!process.env.ANTHROPIC_API_KEY) {
-        throw new Error("ANTHROPIC_API_KEY is not set.");
+        throw new Error(
+          createMissingKeyErrorMessage("Anthropic", "ANTHROPIC_API_KEY")
+        );
       }
       return createAnthropic({
         apiKey: process.env.ANTHROPIC_API_KEY
       })(provider.model);
     default:
-      throw new Error(`Unsupported provider: ${provider?.id}`);
+      throw new Error(createUnsupportedProviderErrorMessage(provider?.id));
   }
 }
 
@@ -4098,7 +4177,7 @@ async function trackEvent(distinctId, event, properties) {
 }
 
 // src/cli/utils/delta.ts
-import _23 from "lodash";
+import _24 from "lodash";
 import z from "zod";
 
 // src/cli/utils/fs.ts
@@ -4147,9 +4226,9 @@ function createDeltaProcessor(fileKey) {
       return checkIfFileExists(lockfilePath);
     },
     async calculateDelta(params) {
-      let added = _23.difference(Object.keys(params.sourceData), Object.keys(params.targetData));
-      let removed = _23.difference(Object.keys(params.targetData), Object.keys(params.sourceData));
-      const updated = _23.filter(Object.keys(params.sourceData), (key) => {
+      let added = _24.difference(Object.keys(params.sourceData), Object.keys(params.targetData));
+      let removed = _24.difference(Object.keys(params.targetData), Object.keys(params.sourceData));
+      const updated = _24.filter(Object.keys(params.sourceData), (key) => {
         return md5(params.sourceData[key]) !== params.checksums[key] && params.checksums[key];
       });
       const renamed = [];
@@ -4198,7 +4277,7 @@ function createDeltaProcessor(fileKey) {
       await this.saveLock(lockfileData);
     },
     async createChecksums(sourceData) {
-      const checksums = _23.mapValues(sourceData, (value) => md5(value));
+      const checksums = _24.mapValues(sourceData, (value) => md5(value));
       return checksums;
     }
   };
@@ -4265,7 +4344,7 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
     validateParams(i18nConfig, flags);
     ora.succeed("Localization configuration is valid");
     ora.start("Connecting to Lingo.dev Localization Engine...");
-    const isByokMode = i18nConfig?.provider && i18nConfig.provider.id !== "lingo";
+    const isByokMode = !!i18nConfig?.provider;
     if (isByokMode) {
       authId = null;
       ora.succeed("Using external provider (BYOK mode)");
@@ -4328,7 +4407,8 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
               injectLocale: bucket.injectLocale
             },
             bucket.lockedKeys,
-            bucket.lockedPatterns
+            bucket.lockedPatterns,
+            bucket.ignoredKeys
           );
           bucketLoader.setDefaultLocale(sourceLocale);
           await bucketLoader.init();
@@ -4437,7 +4517,7 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
           const deltaProcessor = createDeltaProcessor(bucketPath.pathPattern);
           const sourceChecksums = await deltaProcessor.createChecksums(sourceData);
           const savedChecksums = await deltaProcessor.loadChecksums();
-          const updatedSourceData = _24.pickBy(
+          const updatedSourceData = _25.pickBy(
             sourceData,
             (value, key) => sourceChecksums[key] !== savedChecksums[key]
           );
@@ -4451,15 +4531,15 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
               bucketPath.delimiter
             );
             const { unlocalizable: targetUnlocalizable, ...targetData } = await bucketLoader.pull(targetLocale);
-            const missingKeys = _24.difference(
+            const missingKeys = _25.difference(
               Object.keys(sourceData),
               Object.keys(targetData)
             );
-            const extraKeys = _24.difference(
+            const extraKeys = _25.difference(
               Object.keys(targetData),
               Object.keys(sourceData)
             );
-            const unlocalizableDataDiff = !_24.isEqual(
+            const unlocalizableDataDiff = !_25.isEqual(
               sourceUnlocalizable,
               targetUnlocalizable
             );
@@ -4515,7 +4595,8 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
               injectLocale: bucket.injectLocale
             },
             bucket.lockedKeys,
-            bucket.lockedPatterns
+            bucket.lockedPatterns,
+            bucket.ignoredKeys
           );
           bucketLoader.setDefaultLocale(sourceLocale);
           await bucketLoader.init();
@@ -4540,13 +4621,13 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
                 targetData,
                 checksums: checksums2
               });
-              let processableData = _24.chain(sourceData).entries().filter(
+              let processableData = _25.chain(sourceData).entries().filter(
                 ([key, value]) => delta.added.includes(key) || delta.updated.includes(key) || !!flags.force
               ).fromPairs().value();
               if (flags.key) {
-                processableData = _24.pickBy(
+                processableData = _25.pickBy(
                   processableData,
-                  (_27, key) => key === flags.key
+                  (_29, key) => key === flags.key
                 );
               }
               if (flags.verbose) {
@@ -4573,21 +4654,13 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
                   targetData
                 },
                 (progress, sourceChunk, processedChunk) => {
-                  const progressLog = `[${sourceLocale} -> ${targetLocale}] [${Object.keys(processableData).length} entries] (${progress}%) AI localization in progress...`;
-                  if (flags.verbose) {
-                    bucketOra.info(progressLog);
-                    bucketOra.info(
-                      `(${progress}%) Caching chunk ${JSON.stringify(sourceChunk, null, 2)} -> ${JSON.stringify(processedChunk, null, 2)}`
-                    );
-                  } else {
-                    bucketOra.text = progressLog;
-                  }
+                  bucketOra.text = `[${sourceLocale} -> ${targetLocale}] [${Object.keys(processableData).length} entries] (${progress}%) AI localization in progress...`;
                 }
               );
               if (flags.verbose) {
                 bucketOra.info(JSON.stringify(processedTargetData, null, 2));
               }
-              let finalTargetData = _24.merge(
+              let finalTargetData = _25.merge(
                 {},
                 sourceData,
                 targetData,
@@ -4608,7 +4681,7 @@ var i18n_default = new Command6().command("i18n").description("Run Localization
                   `Applying changes to ${bucketPath} (${targetLocale})`
                 );
               }
-              const finalDiffSize = _24.chain(finalTargetData).omitBy((value, key) => value === targetData[key]).size().value();
+              const finalDiffSize = _25.chain(finalTargetData).omitBy((value, key) => value === targetData[key]).size().value();
               await bucketLoader.push(targetLocale, finalTargetData);
               if (finalDiffSize > 0 || flags.force) {
                 bucketOra.succeed(
@@ -4735,7 +4808,7 @@ async function reviewChanges(args) {
   if (currentStr === proposedStr && !args.force) {
     console.log(
       `
-${chalk.blue(args.pathPattern)} (${chalk.yellow(args.targetLocale)}): ${chalk.gray("No changes to review")}`
+${chalk2.blue(args.pathPattern)} (${chalk2.yellow(args.targetLocale)}): ${chalk2.gray("No changes to review")}`
     );
     return args.proposedData;
   }
@@ -4749,14 +4822,14 @@ ${chalk.blue(args.pathPattern)} (${chalk.yellow(args.targetLocale)}): ${chalk.gr
     { context: 3 }
   );
   const coloredDiff = patch.split("\n").map((line) => {
-    if (line.startsWith("+")) return chalk.green(line);
-    if (line.startsWith("-")) return chalk.red(line);
-    if (line.startsWith("@")) return chalk.cyan(line);
+    if (line.startsWith("+")) return chalk2.green(line);
+    if (line.startsWith("-")) return chalk2.red(line);
+    if (line.startsWith("@")) return chalk2.cyan(line);
     return line;
   }).join("\n");
   console.log(
     `
-Reviewing changes for ${chalk.blue(args.pathPattern)} (${chalk.yellow(args.targetLocale)}):`
+Reviewing changes for ${chalk2.blue(args.pathPattern)} (${chalk2.yellow(args.targetLocale)}):`
   );
   console.log(coloredDiff);
   const { action } = await inquirer2.prompt([
@@ -4779,7 +4852,7 @@ Reviewing changes for ${chalk.blue(args.pathPattern)} (${chalk.yellow(args.targe
     return args.currentData;
   }
   const customData = { ...args.currentData };
-  const changes = _24.reduce(
+  const changes = _25.reduce(
     args.proposedData,
     (result, value, key) => {
       if (args.currentData[key] !== value) {
@@ -4791,32 +4864,32 @@ Reviewing changes for ${chalk.blue(args.pathPattern)} (${chalk.yellow(args.targe
   );
   for (const key of changes) {
     console.log(`
-Editing value for: ${chalk.cyan(key)}`);
-    console.log(chalk.gray("Source text:"), chalk.blue(args.sourceData[key]));
+Editing value for: ${chalk2.cyan(key)}`);
+    console.log(chalk2.gray("Source text:"), chalk2.blue(args.sourceData[key]));
     console.log(
-      chalk.gray("Current value:"),
-      chalk.red(args.currentData[key] || "(empty)")
+      chalk2.gray("Current value:"),
+      chalk2.red(args.currentData[key] || "(empty)")
     );
     console.log(
-      chalk.gray("Suggested value:"),
-      chalk.green(args.proposedData[key])
+      chalk2.gray("Suggested value:"),
+      chalk2.green(args.proposedData[key])
     );
     console.log(
-      chalk.gray(
+      chalk2.gray(
         "\nYour editor will open. Edit the text and save to continue."
       )
     );
-    console.log(chalk.gray("------------"));
+    console.log(chalk2.gray("------------"));
     try {
       const editorContent = [
         "# Edit the translation below.",
         "# Lines starting with # will be ignored.",
         "# Save and exit the editor to continue.",
         "#",
-        `# Source text (${chalk.blue("English")}):`,
+        `# Source text (${chalk2.blue("English")}):`,
         `# ${args.sourceData[key]}`,
         "#",
-        `# Current value (${chalk.red(args.targetLocale)}):`,
+        `# Current value (${chalk2.red(args.targetLocale)}):`,
         `# ${args.currentData[key] || "(empty)"}`,
         "#",
         args.proposedData[key]
@@ -4827,13 +4900,13 @@ Editing value for: ${chalk.cyan(key)}`);
         customData[key] = customValue;
       } else {
         console.log(
-          chalk.yellow("Empty value provided, keeping the current value.")
+          chalk2.yellow("Empty value provided, keeping the current value.")
         );
         customData[key] = args.currentData[key] || args.proposedData[key];
       }
     } catch (error) {
       console.log(
-        chalk.red("Error while editing, keeping the suggested value.")
+        chalk2.red("Error while editing, keeping the suggested value.")
       );
       customData[key] = args.proposedData[key];
     }
@@ -4852,7 +4925,7 @@ import path15 from "path";
 import Z4 from "zod";
 import YAML5 from "yaml";
 import { MD5 as MD52 } from "object-hash";
-import _25 from "lodash";
+import _26 from "lodash";
 function createLockfileHelper() {
   return {
     isLockfileExists: () => {
@@ -4862,23 +4935,23 @@ function createLockfileHelper() {
     registerSourceData: (pathPattern, sourceData) => {
       const lockfile = _loadLockfile();
       const sectionKey = MD52(pathPattern);
-      const sectionChecksums = _25.mapValues(sourceData, (value) => MD52(value));
+      const sectionChecksums = _26.mapValues(sourceData, (value) => MD52(value));
       lockfile.checksums[sectionKey] = sectionChecksums;
       _saveLockfile(lockfile);
     },
     registerPartialSourceData: (pathPattern, partialSourceData) => {
       const lockfile = _loadLockfile();
       const sectionKey = MD52(pathPattern);
-      const sectionChecksums = _25.mapValues(partialSourceData, (value) => MD52(value));
-      lockfile.checksums[sectionKey] = _25.merge({}, lockfile.checksums[sectionKey] ?? {}, sectionChecksums);
+      const sectionChecksums = _26.mapValues(partialSourceData, (value) => MD52(value));
+      lockfile.checksums[sectionKey] = _26.merge({}, lockfile.checksums[sectionKey] ?? {}, sectionChecksums);
       _saveLockfile(lockfile);
     },
     extractUpdatedData: (pathPattern, sourceData) => {
       const lockfile = _loadLockfile();
       const sectionKey = MD52(pathPattern);
-      const currentChecksums = _25.mapValues(sourceData, (value) => MD52(value));
+      const currentChecksums = _26.mapValues(sourceData, (value) => MD52(value));
       const savedChecksums = lockfile.checksums[sectionKey] || {};
-      const updatedData = _25.pickBy(sourceData, (value, key) => savedChecksums[key] !== currentChecksums[key]);
+      const updatedData = _26.pickBy(sourceData, (value, key) => savedChecksums[key] !== currentChecksums[key]);
       return updatedData;
     }
   };
@@ -4948,7 +5021,7 @@ var flagsSchema = Z5.object({
 // src/cli/cmd/cleanup.ts
 import { resolveOverriddenLocale as resolveOverriddenLocale5 } from "@lingo.dev/_spec";
 import { Command as Command8 } from "interactive-commander";
-import _26 from "lodash";
+import _27 from "lodash";
 import Ora7 from "ora";
 var cleanup_default = new Command8().command("cleanup").description("Remove keys from target files that do not exist in the source file").helpOption("-h, --help", "Show help").option("--locale <locale>", "Specific locale to cleanup").option("--bucket <bucket>", "Specific bucket to cleanup").option("--dry-run", "Show what would be removed without making changes").option(
   "--verbose",
@@ -4984,7 +5057,7 @@ var cleanup_default = new Command8().command("cleanup").description("Remove keys
           try {
             const targetData = await bucketLoader.pull(targetLocale);
             const targetKeys = Object.keys(targetData);
-            const keysToRemove = _26.difference(targetKeys, sourceKeys);
+            const keysToRemove = _27.difference(targetKeys, sourceKeys);
             if (keysToRemove.length === 0) {
               bucketOra.succeed(`[${targetLocale}] No keys to remove`);
               continue;
@@ -4993,7 +5066,7 @@ var cleanup_default = new Command8().command("cleanup").description("Remove keys
               bucketOra.info(`[${targetLocale}] Keys to remove: ${JSON.stringify(keysToRemove, null, 2)}`);
             }
             if (!options.dryRun) {
-              const cleanedData = _26.pick(targetData, sourceKeys);
+              const cleanedData = _27.pick(targetData, sourceKeys);
               await bucketLoader.push(targetLocale, cleanedData);
               bucketOra.succeed(`[${targetLocale}] Removed ${keysToRemove.length} keys`);
             } else {
@@ -5048,7 +5121,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import Z6 from "zod";
 import { ReplexicaEngine } from "@lingo.dev/_sdk";
-var mcp_default = new Command9().command("mcp").description("Use Lingo.dev model context provider with your AI agent").helpOption("-h, --help", "Show help").action(async (_27, program) => {
+var mcp_default = new Command9().command("mcp").description("Use Lingo.dev model context provider with your AI agent").helpOption("-h, --help", "Show help").action(async (_29, program) => {
   const apiKey = program.args[0];
   const settings = getSettings(apiKey);
   if (!settings.auth.apiKey) {
@@ -5815,7 +5888,7 @@ import { bucketTypeSchema as bucketTypeSchema3, localeCodeSchema as localeCodeSc
 import { Command as Command11 } from "interactive-commander";
 import Z11 from "zod";
 import Ora8 from "ora";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 import Table from "cli-table3";
 var status_default = new Command11().command("status").description("Show the status of the localization process").helpOption("-h, --help", "Show help").option("--locale <locale>", "Locale to process", (val, prev) => prev ? [...prev, val] : [val]).option("--bucket <bucket>", "Bucket to process", (val, prev) => prev ? [...prev, val] : [val]).option(
   "--file [files...]",
@@ -5958,7 +6031,7 @@ var status_default = new Command11().command("status").description("Show the sta
               languageStats[targetLocale].words += sourceWordCount;
               totalWordCount.set(targetLocale, (totalWordCount.get(targetLocale) || 0) + sourceWordCount);
               bucketOra.succeed(
-                `[${sourceLocale} -> ${targetLocale}] ${chalk2.red(`0% complete`)} (0/${sourceKeys.length} keys) - file not found`
+                `[${sourceLocale} -> ${targetLocale}] ${chalk3.red(`0% complete`)} (0/${sourceKeys.length} keys) - file not found`
               );
               continue;
             }
@@ -5994,20 +6067,20 @@ var status_default = new Command11().command("status").description("Show the sta
             const completionPercent = (completeKeys.length / totalKeysInFile * 100).toFixed(1);
             if (missingKeys.length === 0 && updatedKeys.length === 0) {
               bucketOra.succeed(
-                `[${sourceLocale} -> ${targetLocale}] ${chalk2.green(`100% complete`)} (${completeKeys.length}/${totalKeysInFile} keys)`
+                `[${sourceLocale} -> ${targetLocale}] ${chalk3.green(`100% complete`)} (${completeKeys.length}/${totalKeysInFile} keys)`
               );
             } else {
-              const message = `[${sourceLocale} -> ${targetLocale}] ${parseFloat(completionPercent) > 50 ? chalk2.yellow(`${completionPercent}% complete`) : chalk2.red(`${completionPercent}% complete`)} (${completeKeys.length}/${totalKeysInFile} keys)`;
+              const message = `[${sourceLocale} -> ${targetLocale}] ${parseFloat(completionPercent) > 50 ? chalk3.yellow(`${completionPercent}% complete`) : chalk3.red(`${completionPercent}% complete`)} (${completeKeys.length}/${totalKeysInFile} keys)`;
               bucketOra.succeed(message);
               if (flags.verbose) {
                 if (missingKeys.length > 0) {
-                  console.log(`    ${chalk2.red(`Missing:`)} ${missingKeys.length} keys, ~${wordsToTranslate} words`);
+                  console.log(`    ${chalk3.red(`Missing:`)} ${missingKeys.length} keys, ~${wordsToTranslate} words`);
                   console.log(
-                    `    ${chalk2.dim(`Example missing: ${missingKeys.slice(0, 2).join(", ")}${missingKeys.length > 2 ? "..." : ""}`)}`
+                    `    ${chalk3.dim(`Example missing: ${missingKeys.slice(0, 2).join(", ")}${missingKeys.length > 2 ? "..." : ""}`)}`
                   );
                 }
                 if (updatedKeys.length > 0) {
-                  console.log(`    ${chalk2.yellow(`Updated:`)} ${updatedKeys.length} keys that changed in source`);
+                  console.log(`    ${chalk3.yellow(`Updated:`)} ${updatedKeys.length} keys that changed in source`);
                 }
               }
             }
@@ -6022,16 +6095,16 @@ var status_default = new Command11().command("status").description("Show the sta
     }, 0);
     const totalCompletedKeys = totalSourceKeyCount - totalKeysNeedingTranslation / targetLocales.length;
     console.log();
-    ora.succeed(chalk2.green(`Localization status completed.`));
-    console.log(chalk2.bold.cyan(`
+    ora.succeed(chalk3.green(`Localization status completed.`));
+    console.log(chalk3.bold.cyan(`
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557`));
-    console.log(chalk2.bold.cyan(`\u2551   LOCALIZATION STATUS REPORT       \u2551`));
-    console.log(chalk2.bold.cyan(`\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`));
-    console.log(chalk2.bold(`
+    console.log(chalk3.bold.cyan(`\u2551   LOCALIZATION STATUS REPORT       \u2551`));
+    console.log(chalk3.bold.cyan(`\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`));
+    console.log(chalk3.bold(`
 \u{1F4DD} SOURCE CONTENT:`));
-    console.log(`\u2022 Source language: ${chalk2.green(i18nConfig.locale.source)}`);
-    console.log(`\u2022 Source keys: ${chalk2.yellow(totalSourceKeyCount.toString())} keys across all files`);
-    console.log(chalk2.bold(`
+    console.log(`\u2022 Source language: ${chalk3.green(i18nConfig.locale.source)}`);
+    console.log(`\u2022 Source keys: ${chalk3.yellow(totalSourceKeyCount.toString())} keys across all files`);
+    console.log(chalk3.bold(`
 \u{1F310} LANGUAGE BY LANGUAGE BREAKDOWN:`));
     const table = new Table({
       head: ["Language", "Status", "Complete", "Missing", "Updated", "Total Keys", "Words to Translate"],
@@ -6053,19 +6126,19 @@ var status_default = new Command11().command("status").description("Show the sta
       let statusColor;
       if (stats.missing === totalSourceKeyCount) {
         statusText = "\u{1F534} Not started";
-        statusColor = chalk2.red;
+        statusColor = chalk3.red;
       } else if (stats.missing === 0 && stats.updated === 0) {
         statusText = "\u2705 Complete";
-        statusColor = chalk2.green;
+        statusColor = chalk3.green;
       } else if (parseFloat(percentComplete) > 80) {
         statusText = "\u{1F7E1} Almost done";
-        statusColor = chalk2.yellow;
+        statusColor = chalk3.yellow;
       } else if (parseFloat(percentComplete) > 0) {
         statusText = "\u{1F7E0} In progress";
-        statusColor = chalk2.yellow;
+        statusColor = chalk3.yellow;
       } else {
         statusText = "\u{1F534} Not started";
-        statusColor = chalk2.red;
+        statusColor = chalk3.red;
       }
       const words = totalWordCount.get(locale) || 0;
       totalWordsToTranslate += words;
@@ -6073,17 +6146,17 @@ var status_default = new Command11().command("status").description("Show the sta
         locale,
         statusColor(statusText),
         `${stats.complete}/${totalSourceKeyCount} (${percentComplete}%)`,
-        stats.missing > 0 ? chalk2.red(stats.missing.toString()) : "0",
-        stats.updated > 0 ? chalk2.yellow(stats.updated.toString()) : "0",
-        totalNeeded > 0 ? chalk2.magenta(totalNeeded.toString()) : "0",
+        stats.missing > 0 ? chalk3.red(stats.missing.toString()) : "0",
+        stats.updated > 0 ? chalk3.yellow(stats.updated.toString()) : "0",
+        totalNeeded > 0 ? chalk3.magenta(totalNeeded.toString()) : "0",
         words > 0 ? `~${words.toLocaleString()}` : "0"
       ]);
     }
     console.log(table.toString());
-    console.log(chalk2.bold(`
+    console.log(chalk3.bold(`
 \u{1F4CA} USAGE ESTIMATE:`));
     console.log(
-      `\u2022 WORDS TO BE CONSUMED: ~${chalk2.yellow.bold(totalWordsToTranslate.toLocaleString())} words across all languages`
+      `\u2022 WORDS TO BE CONSUMED: ~${chalk3.yellow.bold(totalWordsToTranslate.toLocaleString())} words across all languages`
     );
     console.log(`  (Words are counted from source language for keys that need translation in target languages)`);
     if (targetLocales.length > 1) {
@@ -6095,11 +6168,11 @@ var status_default = new Command11().command("status").description("Show the sta
       }
     }
     if (flags.confirm && Object.keys(fileStats).length > 0) {
-      console.log(chalk2.bold(`
+      console.log(chalk3.bold(`
 \u{1F4D1} BREAKDOWN BY FILE:`));
       Object.entries(fileStats).sort((a, b) => b[1].wordCount - a[1].wordCount).forEach(([path17, stats]) => {
         if (stats.sourceKeys === 0) return;
-        console.log(chalk2.bold(`
+        console.log(chalk3.bold(`
 \u2022 ${path17}:`));
         console.log(`  ${stats.sourceKeys} source keys, ~${stats.wordCount.toLocaleString()} source words`);
         const fileTable = new Table({
@@ -6117,13 +6190,13 @@ var status_default = new Command11().command("status").description("Show the sta
           const total = stats.sourceKeys;
           const completion = (complete / total * 100).toFixed(1);
           let status = "\u2705 Complete";
-          let statusColor = chalk2.green;
+          let statusColor = chalk3.green;
           if (langStats.missing === total) {
             status = "\u274C Not started";
-            statusColor = chalk2.red;
+            statusColor = chalk3.red;
           } else if (langStats.missing > 0 || langStats.updated > 0) {
             status = `\u26A0\uFE0F ${completion}% complete`;
-            statusColor = chalk2.yellow;
+            statusColor = chalk3.yellow;
           }
           let details = "";
           if (langStats.missing > 0 || langStats.updated > 0) {
@@ -6143,16 +6216,16 @@ var status_default = new Command11().command("status").description("Show the sta
       (locale) => languageStats[locale].missing === 0 && languageStats[locale].updated === 0
     );
     const missingLanguages = targetLocales.filter((locale) => languageStats[locale].complete === 0);
-    console.log(chalk2.bold.green(`
+    console.log(chalk3.bold.green(`
 \u{1F4A1} OPTIMIZATION TIPS:`));
     if (missingLanguages.length > 0) {
       console.log(
-        `\u2022 ${chalk2.yellow(missingLanguages.join(", "))} ${missingLanguages.length === 1 ? "has" : "have"} no translations yet`
+        `\u2022 ${chalk3.yellow(missingLanguages.join(", "))} ${missingLanguages.length === 1 ? "has" : "have"} no translations yet`
       );
     }
     if (completeLanguages.length > 0) {
       console.log(
-        `\u2022 ${chalk2.green(completeLanguages.join(", "))} ${completeLanguages.length === 1 ? "is" : "are"} completely translated`
+        `\u2022 ${chalk3.green(completeLanguages.join(", "))} ${completeLanguages.length === 1 ? "is" : "are"} completely translated`
       );
     }
     if (targetLocales.length > 1) {
@@ -6231,9 +6304,9 @@ function validateParams2(i18nConfig, flags) {
 import { Command as Command12 } from "interactive-commander";
 import * as cp from "node:child_process";
 import figlet from "figlet";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import { vice } from "gradient-string";
-var colors = {
+var colors2 = {
   orange: "#ff6600",
   green: "#6ae300",
   blue: "#0090ff",
@@ -6245,7 +6318,7 @@ var may_the_fourth_default = new Command12().command("may-the-fourth").descripti
   await renderClear();
   await renderBanner();
   await renderSpacer();
-  console.log(chalk3.hex(colors.yellow)("Loading the Star Wars movie..."));
+  console.log(chalk4.hex(colors2.yellow)("Loading the Star Wars movie..."));
   await renderSpacer();
   await new Promise((resolve, reject) => {
     const ssh = cp.spawn("ssh", ["starwarstel.net"], {
@@ -6264,10 +6337,10 @@ var may_the_fourth_default = new Command12().command("may-the-fourth").descripti
   });
   await renderSpacer();
   console.log(
-    `${chalk3.hex(colors.green)("We hope you enjoyed it! :)")} ${chalk3.hex(colors.blue)("May the Fourth be with you! \u{1F680}")}`
+    `${chalk4.hex(colors2.green)("We hope you enjoyed it! :)")} ${chalk4.hex(colors2.blue)("May the Fourth be with you! \u{1F680}")}`
   );
   await renderSpacer();
-  console.log(chalk3.dim(`---`));
+  console.log(chalk4.dim(`---`));
   await renderSpacer();
   await renderHero();
 });
@@ -6290,19 +6363,19 @@ async function renderBanner() {
 }
 async function renderHero() {
   console.log(
-    `\u26A1\uFE0F ${chalk3.hex(colors.green)("Lingo.dev")} - open-source, AI-powered i18n CLI for web & mobile localization.`
+    `\u26A1\uFE0F ${chalk4.hex(colors2.green)("Lingo.dev")} - open-source, AI-powered i18n CLI for web & mobile localization.`
   );
   console.log(" ");
   console.log(
-    chalk3.hex(colors.blue)("\u2B50 GitHub Repo: https://lingo.dev/go/gh")
+    chalk4.hex(colors2.blue)("\u2B50 GitHub Repo: https://lingo.dev/go/gh")
   );
-  console.log(chalk3.hex(colors.blue)("\u{1F4AC} 24/7 Support: hi@lingo.dev"));
+  console.log(chalk4.hex(colors2.blue)("\u{1F4AC} 24/7 Support: hi@lingo.dev"));
 }
 
 // package.json
 var package_default = {
   name: "lingo.dev",
-  version: "0.92.7",
+  version: "0.92.9",
   description: "Lingo.dev CLI",
   private: false,
   publishConfig: {
@@ -6359,22 +6432,24 @@ var package_default = {
   author: "",
   license: "Apache-2.0",
   dependencies: {
-    "@ai-sdk/anthropic": "^1.2.6",
-    "@ai-sdk/openai": "^1.3.7",
+    "@ai-sdk/anthropic": "^1.2.11",
+    "@ai-sdk/openai": "^1.3.22",
     "@babel/generator": "^7.27.1",
     "@babel/parser": "^7.27.1",
     "@babel/traverse": "^7.27.1",
     "@babel/types": "^7.27.1",
     "@datocms/cma-client-node": "^4.0.1",
     "@gitbeaker/rest": "^39.34.3",
+    "@inkjs/ui": "^2.0.0",
     "@inquirer/prompts": "^7.4.1",
     "@lingo.dev/_sdk": "workspace:*",
     "@lingo.dev/_spec": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.5.0",
     "@paralleldrive/cuid2": "^2.2.2",
-    ai: "^4.3.2",
+    ai: "^4.3.15",
     bitbucket: "^2.12.0",
     chalk: "^5.4.1",
+    "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
     cors: "^2.8.5",
     "csv-parse": "^5.6.0",
@@ -6392,12 +6467,16 @@ var package_default = {
     "gradient-string": "^3.0.0",
     "gray-matter": "^4.0.3",
     ini: "^5.0.0",
+    ink: "^4.2.0",
+    "ink-progress-bar": "^3.0.0",
+    "ink-spinner": "^5.0.0",
     inquirer: "^12.6.0",
     "interactive-commander": "^0.5.194",
     "is-url": "^1.2.4",
     jsdom: "^25.0.1",
     json5: "^2.2.3",
     jsonrepair: "^3.11.2",
+    listr2: "^8.3.2",
     lodash: "^4.17.21",
     marked: "^15.0.6",
     "mdast-util-from-markdown": "^2.0.2",
@@ -6414,6 +6493,7 @@ var package_default = {
     plist: "^3.1.0",
     "posthog-node": "^4.17.0",
     prettier: "^3.4.2",
+    react: "^18.3.1",
     "rehype-stringify": "^10.0.1",
     "remark-disable-tokenizers": "^1.1.1",
     "remark-frontmatter": "^5.0.0",
@@ -6435,6 +6515,7 @@ var package_default = {
   },
   devDependencies: {
     "@types/babel__generator": "^7.27.0",
+    "@types/cli-progress": "^3.11.6",
     "@types/cors": "^2.8.17",
     "@types/diff": "^7.0.0",
     "@types/express": "^5.0.1",
@@ -6450,6 +6531,7 @@ var package_default = {
     "@types/node-gettext": "^3.0.6",
     "@types/object-hash": "^3.0.6",
     "@types/plist": "^3.0.5",
+    "@types/react": "^18.3.20",
     "@types/xml2js": "^0.4.14",
     tsup: "^8.3.5",
     typescript: "^5.8.3",
@@ -6460,13 +6542,746 @@ var package_default = {
   }
 };
 
+// src/cli/cmd/run/index.ts
+import { Command as Command13 } from "interactive-commander";
+
+// src/cli/cmd/run/setup.ts
+import chalk8 from "chalk";
+import { Listr } from "listr2";
+
+// src/cli/cmd/run/_const.ts
+import chalk5 from "chalk";
+import { ListrDefaultRendererLogLevels } from "listr2";
+var commonTaskRendererOptions = {
+  color: {
+    [ListrDefaultRendererLogLevels.COMPLETED]: (msg) => msg ? chalk5.hex(colors.green)(msg) : chalk5.hex(colors.green)("")
+  },
+  icon: {
+    [ListrDefaultRendererLogLevels.COMPLETED]: chalk5.hex(colors.green)("\u2713")
+  }
+};
+
+// src/cli/localizer/lingodotdev.ts
+import dedent2 from "dedent";
+import chalk6 from "chalk";
+import { LingoDotDevEngine as LingoDotDevEngine2 } from "@lingo.dev/_sdk";
+function createLingoDotDevLocalizer(explicitApiKey) {
+  const { auth } = getSettings(explicitApiKey);
+  if (!auth) {
+    throw new Error(
+      dedent2`
+        You're trying to use ${chalk6.hex(colors.green)("Lingo.dev")} provider, however, you are not authenticated.
+
+        To fix this issue:
+        1. Run ${chalk6.dim("lingo.dev login")} to authenticate, or
+        2. Use the ${chalk6.dim("--api-key")} flag to provide an API key.
+        3. Set ${chalk6.dim("LINGODOTDEV_API_KEY")} environment variable.
+      `
+    );
+  }
+  const engine = new LingoDotDevEngine2({
+    apiKey: auth.apiKey,
+    apiUrl: auth.apiUrl
+  });
+  return {
+    id: "Lingo.dev",
+    checkAuth: async () => {
+      try {
+        const response = await engine.whoami();
+        return {
+          authenticated: !!response,
+          username: response?.email
+        };
+      } catch {
+        return { authenticated: false };
+      }
+    },
+    localize: async (input2, onProgress) => {
+      if (!Object.keys(input2.processableData).length) {
+        return input2;
+      }
+      const processedData = await engine.localizeObject(
+        input2.processableData,
+        {
+          sourceLocale: input2.sourceLocale,
+          targetLocale: input2.targetLocale,
+          reference: {
+            [input2.sourceLocale]: input2.sourceData,
+            [input2.targetLocale]: input2.targetData
+          }
+        },
+        onProgress
+      );
+      return processedData;
+    }
+  };
+}
+
+// src/cli/localizer/explicit.ts
+import { createAnthropic as createAnthropic2 } from "@ai-sdk/anthropic";
+import { createOpenAI as createOpenAI2 } from "@ai-sdk/openai";
+import chalk7 from "chalk";
+import dedent3 from "dedent";
+import { generateText as generateText2 } from "ai";
+function createExplicitLocalizer(provider) {
+  switch (provider.id) {
+    default:
+      throw new Error(
+        dedent3`
+          You're trying to use unsupported provider: ${chalk7.dim(provider.id)}.
+        
+          To fix this issue:
+          1. Switch to one of the supported providers, or
+          2. Remove the ${chalk7.italic("provider")} node from your i18n.json configuration to switch to ${chalk7.hex(colors.green)("Lingo.dev")}
+        
+          ${chalk7.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
+        `
+      );
+    case "openai":
+      return createAiSdkLocalizer({
+        factory: (params) => createOpenAI2(params).languageModel(provider.model),
+        id: provider.id,
+        prompt: provider.prompt,
+        apiKeyName: "OPENAI_API_KEY",
+        baseUrl: provider.baseUrl
+      });
+    case "anthropic":
+      return createAiSdkLocalizer({
+        factory: (params) => createAnthropic2(params).languageModel(provider.model),
+        id: provider.id,
+        prompt: provider.prompt,
+        apiKeyName: "ANTHROPIC_API_KEY",
+        baseUrl: provider.baseUrl
+      });
+  }
+}
+function createAiSdkLocalizer(params) {
+  const apiKey = process.env[params.apiKeyName];
+  if (!apiKey) {
+    throw new Error(
+      dedent3`
+        You're trying to use raw ${chalk7.dim(params.id)} API for translation, however, ${chalk7.dim(params.apiKeyName)} environment variable is not set.
+
+        To fix this issue:
+        1. Set ${chalk7.dim(params.apiKeyName)} in your environment variables, or
+        2. Remove the ${chalk7.italic("provider")} node from your i18n.json configuration to switch to ${chalk7.hex(colors.green)("Lingo.dev")}
+
+        ${chalk7.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
+      `
+    );
+  }
+  const model = params.factory({
+    apiKey,
+    baseUrl: params.baseUrl
+  });
+  return {
+    id: params.id,
+    checkAuth: async () => {
+      try {
+        await generateText2({
+          model,
+          messages: [
+            { role: "system", content: "You are an echo server" },
+            { role: "user", content: "OK" },
+            { role: "assistant", content: "OK" },
+            { role: "user", content: "OK" }
+          ]
+        });
+        return { authenticated: true, username: "anonymous" };
+      } catch (error) {
+        return { authenticated: false };
+      }
+    },
+    localize: async (input2) => {
+      const systemPrompt = params.prompt.replaceAll("{source}", input2.sourceLocale).replaceAll("{target}", input2.targetLocale);
+      const shots = [
+        [
+          {
+            sourceLocale: "en",
+            targetLocale: "es",
+            data: {
+              message: "Hello, world!"
+            }
+          },
+          {
+            sourceLocale: "en",
+            targetLocale: "es",
+            data: {
+              message: "Hola, mundo!"
+            }
+          }
+        ]
+      ];
+      const payload = {
+        sourceLocale: input2.sourceLocale,
+        targetLocale: input2.targetLocale,
+        data: input2.processableData
+      };
+      const response = await generateText2({
+        model,
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: "OK" },
+          ...shots.flatMap(
+            ([userShot, assistantShot]) => [
+              { role: "user", content: JSON.stringify(userShot) },
+              { role: "assistant", content: JSON.stringify(assistantShot) }
+            ]
+          ),
+          { role: "user", content: JSON.stringify(payload) }
+        ]
+      });
+      const result = JSON.parse(response.text);
+      return result.data;
+    }
+  };
+}
+
+// src/cli/localizer/index.ts
+function createLocalizer(provider) {
+  if (!provider) {
+    return createLingoDotDevLocalizer();
+  } else {
+    return createExplicitLocalizer(provider);
+  }
+}
+
+// src/cli/cmd/run/setup.ts
+async function setup(input2) {
+  console.log(chalk8.hex(colors.orange)("[Setup]"));
+  return new Listr(
+    [
+      {
+        title: "Setting up the environment",
+        task: async (ctx, task) => {
+          task.title = `Environment setup completed`;
+        }
+      },
+      {
+        title: "Loading i18n configuration",
+        task: async (ctx, task) => {
+          ctx.config = getConfig(true);
+          if (!ctx.config) {
+            throw new Error(
+              "i18n.json not found. Please run `lingo.dev init` to initialize the project."
+            );
+          } else if (!ctx.config.buckets || !Object.keys(ctx.config.buckets).length) {
+            throw new Error(
+              "No buckets found in i18n.json. Please add at least one bucket containing i18n content."
+            );
+          } else if (ctx.flags.locale?.some(
+            (locale) => !ctx.config?.locale.targets.includes(locale)
+          )) {
+            throw new Error(
+              `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list first and try again.`
+            );
+          } else if (ctx.flags.bucket?.some(
+            (bucket) => !ctx.config?.buckets[bucket]
+          )) {
+            throw new Error(
+              `One or more specified buckets do not exist in i18n.json. Please add them to the list first and try again.`
+            );
+          }
+          task.title = `Loaded i18n configuration`;
+        }
+      },
+      {
+        title: "Selecting localization provider",
+        task: async (ctx, task) => {
+          ctx.localizer = createLocalizer(ctx.config?.provider);
+          if (!ctx.localizer) {
+            throw new Error(
+              "Could not create localization provider. Please check your i18n.json configuration."
+            );
+          }
+          task.title = ctx.localizer.id === "Lingo.dev" ? `Using ${chalk8.hex(colors.green)(ctx.localizer.id)} provider` : `Using raw ${chalk8.hex(colors.yellow)(ctx.localizer.id)} API`;
+        }
+      },
+      {
+        title: "Checking authentication",
+        task: async (ctx, task) => {
+          const authStatus = await ctx.localizer.checkAuth();
+          if (!authStatus.authenticated) {
+            throw new Error(
+              `Failed to authenticate with ${chalk8.hex(colors.yellow)(ctx.localizer.id)} provider. Please check your API key and try again.`
+            );
+          }
+          task.title = `Authenticated as ${chalk8.hex(colors.yellow)(authStatus.username)}`;
+        }
+      },
+      {
+        title: "Initializing localization provider",
+        async task(ctx, task) {
+          const isLingoDotDev = ctx.localizer.id === "Lingo.dev";
+          const subTasks = isLingoDotDev ? [
+            "Brand voice enabled",
+            "Translation memory connected",
+            "Glossary enabled",
+            "Quality assurance enabled"
+          ].map((title) => ({ title, task: () => {
+          } })) : [
+            "Skipping brand voice",
+            "Skipping glossary",
+            "Skipping translation memory",
+            "Skipping quality assurance"
+          ].map((title) => ({ title, task: () => {
+          }, skip: true }));
+          return task.newListr(subTasks, {
+            concurrent: true,
+            rendererOptions: { collapseSubtasks: false }
+          });
+        }
+      }
+    ],
+    {
+      rendererOptions: commonTaskRendererOptions
+    }
+  ).run(input2);
+}
+
+// src/cli/cmd/run/plan.ts
+import chalk9 from "chalk";
+import { Listr as Listr2 } from "listr2";
+import { resolveOverriddenLocale as resolveOverriddenLocale7 } from "@lingo.dev/_spec";
+async function plan(input2) {
+  console.log(chalk9.hex(colors.orange)("[Planning]"));
+  let buckets = getBuckets(input2.config);
+  if (input2.flags.bucket) {
+    buckets = buckets.filter((b) => input2.flags.bucket.includes(b.type));
+  }
+  let locales = input2.config.locale.targets;
+  if (input2.flags.locale) {
+    locales = locales.filter((l) => input2.flags.locale.includes(l));
+  }
+  return new Listr2(
+    [
+      {
+        title: "Locating content buckets",
+        task: async (ctx, task) => {
+          const bucketCount = buckets.length;
+          const bucketFilter = input2.flags.bucket ? ` ${chalk9.dim(`(filtered by: ${chalk9.hex(colors.yellow)(input2.flags.bucket.join(", "))})`)}` : "";
+          task.title = `Found ${chalk9.hex(colors.yellow)(bucketCount.toString())} bucket(s)${bucketFilter}`;
+        }
+      },
+      {
+        title: "Detecting locales",
+        task: async (ctx, task) => {
+          if (!locales.length) {
+            throw new Error(
+              `No target locales found in config. Please add locales to your i18n.json config file.`
+            );
+          }
+          const localeFilter = input2.flags.locale ? ` ${chalk9.dim(`(filtered by: ${chalk9.hex(colors.yellow)(input2.flags.locale.join(", "))})`)}` : "";
+          task.title = `Found ${chalk9.hex(colors.yellow)(locales.length.toString())} target locale(s)${localeFilter}`;
+        }
+      },
+      {
+        title: "Locating localizable files",
+        task: async (ctx, task) => {
+          const patterns = [];
+          for (const bucket of buckets) {
+            for (const bucketPath of bucket.paths) {
+              if (input2.flags.file) {
+                if (!input2.flags.file.some(
+                  (f) => bucketPath.pathPattern.includes(f)
+                )) {
+                  continue;
+                }
+              }
+              patterns.push(bucketPath.pathPattern);
+            }
+          }
+          const fileFilter = input2.flags.file ? ` ${chalk9.dim(`(filtered by: ${chalk9.hex(colors.yellow)(input2.flags.file.join(", "))})`)}` : "";
+          task.title = `Found ${chalk9.hex(colors.yellow)(patterns.length.toString())} path pattern(s)${fileFilter}`;
+        }
+      },
+      {
+        title: "Computing translation tasks",
+        task: async (ctx, task) => {
+          for (const bucket of buckets) {
+            for (const bucketPath of bucket.paths) {
+              if (input2.flags.file) {
+                if (!input2.flags.file.some(
+                  (f) => bucketPath.pathPattern.includes(f)
+                )) {
+                  continue;
+                }
+              }
+              const sourceLocale = resolveOverriddenLocale7(
+                ctx.config.locale.source,
+                bucketPath.delimiter
+              );
+              for (const _targetLocale of locales) {
+                const targetLocale = resolveOverriddenLocale7(
+                  _targetLocale,
+                  bucketPath.delimiter
+                );
+                if (sourceLocale === targetLocale) continue;
+                ctx.tasks.push({
+                  sourceLocale,
+                  targetLocale,
+                  bucketType: bucket.type,
+                  bucketPathPattern: bucketPath.pathPattern,
+                  injectLocale: bucket.injectLocale || [],
+                  lockedKeys: bucket.lockedKeys || [],
+                  lockedPatterns: bucket.lockedPatterns || []
+                });
+              }
+            }
+          }
+          task.title = `Prepared ${chalk9.hex(colors.green)(ctx.tasks.length.toString())} translation task(s)`;
+        }
+      }
+    ],
+    {
+      rendererOptions: commonTaskRendererOptions
+    }
+  ).run(input2);
+}
+
+// src/cli/cmd/run/execute.ts
+import chalk10 from "chalk";
+import { Listr as Listr3 } from "listr2";
+import pLimit from "p-limit";
+import _28 from "lodash";
+var MAX_WORKER_COUNT = 10;
+async function execute(input2) {
+  const effectiveConcurrency = Math.min(
+    input2.flags.concurrency,
+    input2.tasks.length,
+    MAX_WORKER_COUNT
+  );
+  console.log(chalk10.hex(colors.orange)(`[Localization]`));
+  return new Listr3(
+    [
+      {
+        title: "Initializing localization engine",
+        task: async (ctx, task) => {
+          task.title = `Localization engine ${chalk10.hex(colors.green)("ready")} (${ctx.localizer.id})`;
+        }
+      },
+      {
+        title: `Processing localization tasks ${chalk10.dim(`(tasks: ${input2.tasks.length}, concurrency: ${effectiveConcurrency})`)}`,
+        task: (ctx, task) => {
+          if (input2.tasks.length < 1) {
+            task.title = `Skipping, nothing to localize.`;
+            task.skip();
+            return;
+          }
+          const i18nLimiter = pLimit(effectiveConcurrency);
+          const lockfileLimiter = pLimit(1);
+          const workersCount = effectiveConcurrency;
+          const workerTasks = [];
+          for (let i = 0; i < workersCount; i++) {
+            const assignedTasks = ctx.tasks.filter(
+              (_29, idx) => idx % workersCount === i
+            );
+            workerTasks.push(
+              createWorkerTask({
+                ctx,
+                assignedTasks,
+                lockfileLimiter,
+                i18nLimiter,
+                onDone() {
+                  task.title = createExecutionProgressMessage(ctx);
+                }
+              })
+            );
+          }
+          return task.newListr(workerTasks, {
+            concurrent: true,
+            exitOnError: false,
+            rendererOptions: {
+              ...commonTaskRendererOptions,
+              collapseSubtasks: true
+            }
+          });
+        }
+      }
+    ],
+    {
+      exitOnError: false,
+      rendererOptions: commonTaskRendererOptions
+    }
+  ).run(input2);
+}
+function createWorkerStatusMessage(args) {
+  const displayPath = args.assignedTask.bucketPathPattern.replace(
+    "[locale]",
+    args.assignedTask.targetLocale
+  );
+  return `[${chalk10.hex(colors.yellow)(`${args.percentage}%`)}] Processing: ${chalk10.dim(
+    displayPath
+  )} (${chalk10.hex(colors.yellow)(args.assignedTask.sourceLocale)} -> ${chalk10.hex(
+    colors.yellow
+  )(args.assignedTask.targetLocale)})`;
+}
+function createExecutionProgressMessage(ctx) {
+  const succeededTasksCount = countTasks(
+    ctx,
+    (_t, result) => result.status === "success"
+  );
+  const failedTasksCount = countTasks(
+    ctx,
+    (_t, result) => result.status === "error"
+  );
+  const skippedTasksCount = countTasks(
+    ctx,
+    (_t, result) => result.status === "skipped"
+  );
+  return `Processed ${chalk10.green(succeededTasksCount)}/${ctx.tasks.length}, Failed ${chalk10.red(failedTasksCount)}, Skipped ${chalk10.dim(skippedTasksCount)}`;
+}
+function createLoaderForTask(assignedTask) {
+  const bucketLoader = createBucketLoader(
+    assignedTask.bucketType,
+    assignedTask.bucketPathPattern,
+    {
+      defaultLocale: assignedTask.sourceLocale,
+      isCacheRestore: false,
+      injectLocale: assignedTask.injectLocale
+    },
+    assignedTask.lockedKeys,
+    assignedTask.lockedPatterns
+  );
+  bucketLoader.setDefaultLocale(assignedTask.sourceLocale);
+  return bucketLoader;
+}
+function createWorkerTask(args) {
+  return {
+    title: "Initializing...",
+    task: async (_subCtx, subTask) => {
+      for (const assignedTask of args.assignedTasks) {
+        subTask.title = createWorkerStatusMessage({
+          assignedTask,
+          percentage: 0
+        });
+        const bucketLoader = createLoaderForTask(assignedTask);
+        const deltaProcessor = createDeltaProcessor(
+          assignedTask.bucketPathPattern
+        );
+        const taskResult = await args.i18nLimiter(async () => {
+          try {
+            const sourceData = await bucketLoader.pull(
+              assignedTask.sourceLocale
+            );
+            const targetData = await bucketLoader.pull(
+              assignedTask.targetLocale
+            );
+            const checksums = await deltaProcessor.loadChecksums();
+            const delta = await deltaProcessor.calculateDelta({
+              sourceData,
+              targetData,
+              checksums
+            });
+            const processableData = _28.chain(sourceData).entries().filter(
+              ([key, value]) => delta.added.includes(key) || delta.updated.includes(key) || !!args.ctx.flags.force
+            ).fromPairs().value();
+            if (!Object.keys(processableData).length) {
+              return { status: "skipped" };
+            }
+            const processedTargetData = await args.ctx.localizer.localize(
+              {
+                sourceLocale: assignedTask.sourceLocale,
+                targetLocale: assignedTask.targetLocale,
+                sourceData,
+                targetData,
+                processableData
+              },
+              (progress) => {
+                subTask.title = createWorkerStatusMessage({
+                  assignedTask,
+                  percentage: progress
+                });
+              }
+            );
+            const finalTargetData = _28.merge(
+              {},
+              sourceData,
+              targetData,
+              processedTargetData
+            );
+            await bucketLoader.push(assignedTask.targetLocale, finalTargetData);
+            await args.lockfileLimiter(async () => {
+              const checksums2 = await deltaProcessor.createChecksums(sourceData);
+              await deltaProcessor.saveChecksums(checksums2);
+            });
+            return { status: "success" };
+          } catch (error) {
+            return {
+              status: "error",
+              error
+            };
+          }
+        });
+        args.ctx.results.set(assignedTask, taskResult);
+      }
+      subTask.title = "Done";
+    }
+  };
+}
+function countTasks(ctx, predicate) {
+  return Array.from(ctx.results.entries()).filter(
+    ([task, result]) => predicate(task, result)
+  ).length;
+}
+
+// src/cli/cmd/run/_types.ts
+import {
+  bucketTypeSchema as bucketTypeSchema4,
+  localeCodeSchema as localeCodeSchema3
+} from "@lingo.dev/_spec";
+import { z as z2 } from "zod";
+var flagsSchema2 = z2.object({
+  locale: z2.array(localeCodeSchema3).optional(),
+  bucket: z2.array(bucketTypeSchema4).optional(),
+  key: z2.array(z2.string()).optional(),
+  file: z2.array(z2.string()).optional(),
+  apiKey: z2.string().optional(),
+  force: z2.boolean().optional(),
+  frozen: z2.boolean().optional(),
+  verbose: z2.boolean().optional(),
+  strict: z2.boolean().optional(),
+  interactive: z2.boolean().default(false),
+  concurrency: z2.number().positive().default(10),
+  debug: z2.boolean().default(false)
+});
+
+// src/cli/cmd/run/_render.ts
+import chalk11 from "chalk";
+import figlet2 from "figlet";
+import { vice as vice2 } from "gradient-string";
+import readline2 from "readline";
+async function renderClear2() {
+  console.log("\x1Bc");
+}
+async function renderSpacer2() {
+  console.log(" ");
+}
+async function renderBanner2() {
+  console.log(
+    vice2(
+      figlet2.textSync("LINGO.DEV", {
+        font: "ANSI Shadow",
+        horizontalLayout: "default",
+        verticalLayout: "default"
+      })
+    )
+  );
+}
+async function renderHero2() {
+  console.log(
+    `\u26A1\uFE0F ${chalk11.hex(colors.green)("Lingo.dev")} - open-source, AI-powered i18n CLI for web & mobile localization.`
+  );
+  console.log("");
+  const label1 = "\u2B50 GitHub Repo:";
+  const label2 = "\u{1F4DA} Docs:";
+  const label3 = "\u{1F4AC} 24/7 Support:";
+  const maxLabelWidth = 17;
+  console.log(
+    `${chalk11.hex(colors.blue)(label1.padEnd(maxLabelWidth))} ${chalk11.hex(colors.blue)("https://lingo.dev/go/gh")}`
+  );
+  console.log(
+    `${chalk11.hex(colors.blue)(label2.padEnd(maxLabelWidth + 1))} ${chalk11.hex(colors.blue)("https://lingo.dev/go/docs")}`
+  );
+  console.log(
+    `${chalk11.hex(colors.blue)(label3.padEnd(maxLabelWidth + 1))} ${chalk11.hex(colors.blue)("hi@lingo.dev")}`
+  );
+}
+async function pauseIfDebug(debug) {
+  if (debug) {
+    await waitForUserPrompt("Press Enter to continue...");
+  }
+}
+async function waitForUserPrompt(message) {
+  const rl = readline2.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(chalk11.dim(`[${message}]
+`), () => {
+      rl.close();
+      resolve();
+    });
+  });
+}
+async function renderSummary(ctx) {
+  console.log(chalk11.hex(colors.green)("[Done]"));
+  const skippedTasksCount = ctx.results.values().filter((r) => r.status === "skipped").toArray().length;
+  console.log(
+    `\u2022 ${chalk11.hex(colors.yellow)(skippedTasksCount)} restored from cache`
+  );
+  const succeededTasksCount = ctx.results.values().filter((r) => r.status === "success").toArray().length;
+  console.log(`\u2022 ${chalk11.hex(colors.yellow)(succeededTasksCount)} processed`);
+  const failedTasksCount = ctx.results.values().filter((r) => r.status === "error").toArray().length;
+  console.log(`\u2022 ${chalk11.hex(colors.yellow)(failedTasksCount)} failed`);
+}
+
+// src/cli/cmd/run/index.ts
+var run_default = new Command13().command("run").description("Run Lingo.dev localization engine").helpOption("-h, --help", "Show help").option(
+  "--locale <locale>",
+  "Locale to process",
+  (val, prev) => prev ? [...prev, val] : [val]
+).option(
+  "--bucket <bucket>",
+  "Bucket to process",
+  (val, prev) => prev ? [...prev, val] : [val]
+).option(
+  "--file <file>",
+  "File to process. Process only files that include this string in their path. Useful if you have a lot of files and want to focus on a specific one. Specify more files separated by commas or spaces.",
+  (val, prev) => prev ? [...prev, val] : [val]
+).option(
+  "--key <key>",
+  "Key to process. Process only a specific translation key, useful for updating a single entry",
+  (val, prev) => prev ? [...prev, val] : [val]
+).option(
+  "--force",
+  "Ignore lockfile and process all keys, useful for full re-translation"
+).option(
+  "--api-key <api-key>",
+  "Explicitly set the API key to use, override the default API key from settings"
+).option(
+  "--debug",
+  "Pause execution at start for debugging purposes, waits for user confirmation before proceeding"
+).option(
+  "--concurrency <concurrency>",
+  "Number of concurrent tasks to run",
+  (val) => parseInt(val)
+).action(async (args) => {
+  try {
+    const ctx = {
+      flags: flagsSchema2.parse(args),
+      config: null,
+      results: /* @__PURE__ */ new Map(),
+      tasks: [],
+      localizer: null
+    };
+    await pauseIfDebug(ctx.flags.debug);
+    await renderClear2();
+    await renderSpacer2();
+    await renderBanner2();
+    await renderHero2();
+    await renderSpacer2();
+    await setup(ctx);
+    await renderSpacer2();
+    await plan(ctx);
+    await renderSpacer2();
+    await execute(ctx);
+    await renderSpacer2();
+    await renderSummary(ctx);
+    await renderSpacer2();
+  } catch (error) {
+    process.exit(1);
+  }
+});
+
 // src/cli/index.ts
 dotenv.config();
 var cli_default = new InteractiveCommand2().name("lingo.dev").description("Lingo.dev CLI").helpOption("-h, --help", "Show help").addHelpText(
   "beforeAll",
   `
-${vice2(
-    figlet2.textSync("LINGO.DEV", {
+${vice3(
+    figlet3.textSync("LINGO.DEV", {
       font: "ANSI Shadow",
       horizontalLayout: "default",
       verticalLayout: "default"
@@ -6477,11 +7292,11 @@ ${vice2(
 
 Star the the repo :) https://github.com/LingoDotDev/lingo.dev
 `
-).version(`v${package_default.version}`, "-v, --version", "Show version").addCommand(init_default).interactive("-y, --no-interactive", "Disable interactive mode").addCommand(i18n_default).addCommand(auth_default).addCommand(show_default).addCommand(lockfile_default).addCommand(cleanup_default).addCommand(mcp_default).addCommand(ci_default).addCommand(status_default).addCommand(may_the_fourth_default, { hidden: true }).exitOverride((err) => {
+).version(`v${package_default.version}`, "-v, --version", "Show version").addCommand(init_default).interactive("-y, --no-interactive", "Disable interactive mode").addCommand(i18n_default).addCommand(auth_default).addCommand(show_default).addCommand(lockfile_default).addCommand(cleanup_default).addCommand(mcp_default).addCommand(ci_default).addCommand(status_default).addCommand(may_the_fourth_default, { hidden: true }).addCommand(run_default, { hidden: true }).exitOverride((err) => {
   if (err.code === "commander.helpDisplayed" || err.code === "commander.version" || err.code === "commander.help") {
     process.exit(0);
   }
-  throw err;
+  process.exit(1);
 });
 export {
   cli_default as default