@ccgp/i18n-ai 0.0.4 → 0.1.1

package/README.md

@@ -43,10 +43,33 @@ bun x i18n-ai sync
 
 The CLI attempts to auto-detect your configuration from `i18n/routing.ts` if you are using `next-intl`. Otherwise, you can specify options:
 
-```bash
 i18n-ai sync --locales en,es,fr --default en --dir messages
 ```
 
+### Configuration File (Recommended)
+
+You can run `i18n-ai init` to generate a configuration file interactively:
+
+```bash
+bun x i18n-ai init
+```
+
+This will create an `i18n-ai.config.json` file:
+
+```json
+{
+  "defaultLocale": "en",
+  "locales": ["en", "es", "fr"],
+  "messagesDir": "messages"
+}
+```
+
+Then you can simply run:
+
+```bash
+bun x i18n-ai sync
+```
+
 ### Environment Variables
 
 You need to provide an API key for the AI provider.

package/dist/{chunk-NY2C35K2.mjs → chunk-X4OG3I7N.mjs}

@@ -236,9 +236,30 @@ var TranslationService = class {
     }
     let translatedCount = 0;
     if (toTranslate.length > 0) {
-      for (const change of toTranslate) {
+      const limit = (concurrency) => {
+        let active = 0;
+        const queue = [];
+        const run = async (fn) => {
+          if (active >= concurrency) {
+            await new Promise((resolve) => queue.push(resolve));
+          }
+          active++;
+          try {
+            return await fn();
+          } finally {
+            active--;
+            if (queue.length > 0) {
+              queue.shift()();
+            }
+          }
+        };
+        return run;
+      };
+      const runTask = limit(5);
+      await Promise.all(toTranslate.map((change) => runTask(async () => {
         try {
-          const translatedValue = await translate({
+          const _translate = this.config.translator || translate;
+          const translatedValue = await _translate({
             text: change.sourceText,
             lang: this.config.defaultLocale,
             targetLang: targetLocale,
@@ -258,7 +279,7 @@ var TranslationService = class {
             targetFlat.set(change.key, change.currentTranslation);
           }
         }
-      }
+      })));
     }
     for (const change of changes.unchanged) {
       if (change.currentTranslation) {

package/dist/cli.js

@@ -268,9 +268,30 @@ var TranslationService = class {
     }
     let translatedCount = 0;
     if (toTranslate.length > 0) {
-      for (const change of toTranslate) {
+      const limit = (concurrency) => {
+        let active = 0;
+        const queue = [];
+        const run = async (fn) => {
+          if (active >= concurrency) {
+            await new Promise((resolve2) => queue.push(resolve2));
+          }
+          active++;
+          try {
+            return await fn();
+          } finally {
+            active--;
+            if (queue.length > 0) {
+              queue.shift()();
+            }
+          }
+        };
+        return run;
+      };
+      const runTask = limit(5);
+      await Promise.all(toTranslate.map((change) => runTask(async () => {
         try {
-          const translatedValue = await translate({
+          const _translate = this.config.translator || translate;
+          const translatedValue = await _translate({
             text: change.sourceText,
             lang: this.config.defaultLocale,
             targetLang: targetLocale,
@@ -290,7 +311,7 @@ var TranslationService = class {
             targetFlat.set(change.key, change.currentTranslation);
           }
         }
-      }
+      })));
     }
     for (const change of changes.unchanged) {
       if (change.currentTranslation) {
@@ -311,36 +332,102 @@ var TranslationService = class {
 
 // src/cli.ts
 var import_dotenv = __toESM(require("dotenv"));
+var import_prompts = __toESM(require("prompts"));
+var import_chalk2 = __toESM(require("chalk"));
 import_dotenv.default.config();
 var program = new import_commander.Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version("0.0.1");
-program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory", "messages").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale", "en").option("--lock <path>", "Lock file path", "translation-lock.json").action(async (options) => {
+var CONFIG_FILE = "i18n-ai.config.json";
+async function loadConfig() {
+  try {
+    const configPath = (0, import_path2.join)(process.cwd(), CONFIG_FILE);
+    const content = await (0, import_promises3.readFile)(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+program.command("init").description("Initialize i18n-ai configuration").action(async () => {
+  console.log(import_chalk2.default.bold("\u{1F680} Initializing i18n-ai configuration\n"));
+  const response = await (0, import_prompts.default)([
+    {
+      type: "text",
+      name: "messagesDir",
+      message: "Where are your messages located?",
+      initial: "messages",
+      validate: (value) => value.length > 0 ? true : "Directory cannot be empty"
+    },
+    {
+      type: "text",
+      name: "defaultLocale",
+      message: "What is your default locale?",
+      initial: "en"
+    },
+    {
+      type: "list",
+      name: "locales",
+      message: "Which other locales do you support? (comma separated)",
+      initial: "es, fr",
+      separator: ","
+    }
+  ]);
+  if (!response.messagesDir || !response.defaultLocale) {
+    console.log(import_chalk2.default.red("\n\u274C Initialization canceled"));
+    return;
+  }
+  const allLocales = [response.defaultLocale, ...response.locales.filter((l) => l !== response.defaultLocale)];
+  const config = {
+    defaultLocale: response.defaultLocale,
+    locales: allLocales,
+    messagesDir: response.messagesDir
+  };
+  await (0, import_promises3.writeFile)((0, import_path2.join)(process.cwd(), CONFIG_FILE), JSON.stringify(config, null, 2));
+  console.log(import_chalk2.default.green(`
+\u2705 Created ${CONFIG_FILE}`));
+  const absMessagesDir = (0, import_path2.resolve)(process.cwd(), response.messagesDir);
+  await (0, import_promises3.mkdir)(absMessagesDir, { recursive: true });
+  const baseFilePath = (0, import_path2.join)(absMessagesDir, `${response.defaultLocale}.json`);
+  try {
+    await (0, import_promises3.readFile)(baseFilePath);
+  } catch {
+    await (0, import_promises3.writeFile)(baseFilePath, JSON.stringify({ welcome: "Hello World" }, null, 2));
+    console.log(import_chalk2.default.green(`\u2705 Created base file ${response.messagesDir}/${response.defaultLocale}.json`));
+  }
+  console.log(import_chalk2.default.blue('\n\u{1F389} Setup complete! You can now run "i18n-ai sync"'));
+});
+program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale").option("--lock <path>", "Lock file path", "translation-lock.json").action(async (options) => {
   try {
     const cwd = process.cwd();
-    const messagesDir = (0, import_path2.resolve)(cwd, options.dir);
-    let locales = options.locales ? options.locales.split(",") : [];
-    let defaultLocale = options.default;
-    if (locales.length === 0) {
-      try {
-        const routingPath = (0, import_path2.join)(cwd, "i18n", "routing.ts");
-        const routingContent = await (0, import_promises3.readFile)(routingPath, "utf-8").catch(() => "");
-        if (routingContent) {
-          const localesMatch = routingContent.match(/locales:\s*\[([\s\S]*?)\]/);
-          const defaultMatch = routingContent.match(/defaultLocale:\s*["'](\w+)["']/);
-          if (localesMatch) {
-            locales = localesMatch[1].split(",").map((l) => l.trim().replace(/['"]/g, "")).filter(Boolean);
-          }
-          if (defaultMatch && !defaultLocale) {
-            defaultLocale = defaultMatch[1];
+    const config = await loadConfig();
+    let messagesDir = options.dir ? (0, import_path2.resolve)(cwd, options.dir) : config ? (0, import_path2.resolve)(cwd, config.messagesDir) : null;
+    let locales = options.locales ? options.locales.split(",") : config ? config.locales : [];
+    let defaultLocale = options.default || (config ? config.defaultLocale : null);
+    if (!messagesDir || locales.length === 0 || !defaultLocale) {
+      if (!config) {
+        try {
+          const routingPath = (0, import_path2.join)(cwd, "i18n", "routing.ts");
+          const routingContent = await (0, import_promises3.readFile)(routingPath, "utf-8").catch(() => "");
+          if (routingContent) {
+            const localesMatch = routingContent.match(/locales:\s*\[([\s\S]*?)\]/);
+            const defaultMatch = routingContent.match(/defaultLocale:\s*["'](\w+)["']/);
+            if (localesMatch && locales.length === 0) {
+              locales = localesMatch[1].split(",").map((l) => l.trim().replace(/['"]/g, "")).filter(Boolean);
+            }
+            if (defaultMatch && !defaultLocale) {
+              defaultLocale = defaultMatch[1];
+            }
           }
+        } catch {
         }
-      } catch (e) {
       }
+      if (!messagesDir) messagesDir = (0, import_path2.resolve)(cwd, "messages");
+      if (!defaultLocale) defaultLocale = "en";
     }
     if (locales.length === 0) {
-      console.error("\u274C No locales found. Please specify --locales or ensure i18n/routing.ts exists.");
+      console.error(import_chalk2.default.red('\u274C No locales found. Run "i18n-ai init" or specify --locales.'));
       process.exit(1);
     }
+    console.log(import_chalk2.default.dim(`Using Config: Default=${defaultLocale}, Locales=${locales.join(",")}, Dir=${messagesDir}`));
     const service = new TranslationService({
       locales,
       defaultLocale,
@@ -349,7 +436,7 @@ program.command("sync").description("Synchronize translations using AI").option(
     });
     await service.sync();
   } catch (error) {
-    console.error("Fatal error:", error);
+    console.error(import_chalk2.default.red("Fatal error:"), error);
     process.exit(1);
   }
 });

package/dist/cli.mjs

@@ -1,43 +1,109 @@
 #!/usr/bin/env node
 import {
   TranslationService
-} from "./chunk-NY2C35K2.mjs";
+} from "./chunk-X4OG3I7N.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
 import { resolve, join } from "path";
-import { readFile } from "fs/promises";
+import { readFile, writeFile, mkdir } from "fs/promises";
 import dotenv from "dotenv";
+import prompts from "prompts";
+import chalk from "chalk";
 dotenv.config();
 var program = new Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version("0.0.1");
-program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory", "messages").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale", "en").option("--lock <path>", "Lock file path", "translation-lock.json").action(async (options) => {
+var CONFIG_FILE = "i18n-ai.config.json";
+async function loadConfig() {
+  try {
+    const configPath = join(process.cwd(), CONFIG_FILE);
+    const content = await readFile(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+program.command("init").description("Initialize i18n-ai configuration").action(async () => {
+  console.log(chalk.bold("\u{1F680} Initializing i18n-ai configuration\n"));
+  const response = await prompts([
+    {
+      type: "text",
+      name: "messagesDir",
+      message: "Where are your messages located?",
+      initial: "messages",
+      validate: (value) => value.length > 0 ? true : "Directory cannot be empty"
+    },
+    {
+      type: "text",
+      name: "defaultLocale",
+      message: "What is your default locale?",
+      initial: "en"
+    },
+    {
+      type: "list",
+      name: "locales",
+      message: "Which other locales do you support? (comma separated)",
+      initial: "es, fr",
+      separator: ","
+    }
+  ]);
+  if (!response.messagesDir || !response.defaultLocale) {
+    console.log(chalk.red("\n\u274C Initialization canceled"));
+    return;
+  }
+  const allLocales = [response.defaultLocale, ...response.locales.filter((l) => l !== response.defaultLocale)];
+  const config = {
+    defaultLocale: response.defaultLocale,
+    locales: allLocales,
+    messagesDir: response.messagesDir
+  };
+  await writeFile(join(process.cwd(), CONFIG_FILE), JSON.stringify(config, null, 2));
+  console.log(chalk.green(`
+\u2705 Created ${CONFIG_FILE}`));
+  const absMessagesDir = resolve(process.cwd(), response.messagesDir);
+  await mkdir(absMessagesDir, { recursive: true });
+  const baseFilePath = join(absMessagesDir, `${response.defaultLocale}.json`);
+  try {
+    await readFile(baseFilePath);
+  } catch {
+    await writeFile(baseFilePath, JSON.stringify({ welcome: "Hello World" }, null, 2));
+    console.log(chalk.green(`\u2705 Created base file ${response.messagesDir}/${response.defaultLocale}.json`));
+  }
+  console.log(chalk.blue('\n\u{1F389} Setup complete! You can now run "i18n-ai sync"'));
+});
+program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale").option("--lock <path>", "Lock file path", "translation-lock.json").action(async (options) => {
   try {
     const cwd = process.cwd();
-    const messagesDir = resolve(cwd, options.dir);
-    let locales = options.locales ? options.locales.split(",") : [];
-    let defaultLocale = options.default;
-    if (locales.length === 0) {
-      try {
-        const routingPath = join(cwd, "i18n", "routing.ts");
-        const routingContent = await readFile(routingPath, "utf-8").catch(() => "");
-        if (routingContent) {
-          const localesMatch = routingContent.match(/locales:\s*\[([\s\S]*?)\]/);
-          const defaultMatch = routingContent.match(/defaultLocale:\s*["'](\w+)["']/);
-          if (localesMatch) {
-            locales = localesMatch[1].split(",").map((l) => l.trim().replace(/['"]/g, "")).filter(Boolean);
-          }
-          if (defaultMatch && !defaultLocale) {
-            defaultLocale = defaultMatch[1];
+    const config = await loadConfig();
+    let messagesDir = options.dir ? resolve(cwd, options.dir) : config ? resolve(cwd, config.messagesDir) : null;
+    let locales = options.locales ? options.locales.split(",") : config ? config.locales : [];
+    let defaultLocale = options.default || (config ? config.defaultLocale : null);
+    if (!messagesDir || locales.length === 0 || !defaultLocale) {
+      if (!config) {
+        try {
+          const routingPath = join(cwd, "i18n", "routing.ts");
+          const routingContent = await readFile(routingPath, "utf-8").catch(() => "");
+          if (routingContent) {
+            const localesMatch = routingContent.match(/locales:\s*\[([\s\S]*?)\]/);
+            const defaultMatch = routingContent.match(/defaultLocale:\s*["'](\w+)["']/);
+            if (localesMatch && locales.length === 0) {
+              locales = localesMatch[1].split(",").map((l) => l.trim().replace(/['"]/g, "")).filter(Boolean);
+            }
+            if (defaultMatch && !defaultLocale) {
+              defaultLocale = defaultMatch[1];
+            }
           }
+        } catch {
         }
-      } catch (e) {
       }
+      if (!messagesDir) messagesDir = resolve(cwd, "messages");
+      if (!defaultLocale) defaultLocale = "en";
     }
     if (locales.length === 0) {
-      console.error("\u274C No locales found. Please specify --locales or ensure i18n/routing.ts exists.");
+      console.error(chalk.red('\u274C No locales found. Run "i18n-ai init" or specify --locales.'));
       process.exit(1);
     }
+    console.log(chalk.dim(`Using Config: Default=${defaultLocale}, Locales=${locales.join(",")}, Dir=${messagesDir}`));
     const service = new TranslationService({
       locales,
       defaultLocale,
@@ -46,7 +112,7 @@ program.command("sync").description("Synchronize translations using AI").option(
     });
     await service.sync();
   } catch (error) {
-    console.error("Fatal error:", error);
+    console.error(chalk.red("Fatal error:"), error);
     process.exit(1);
   }
 });

package/dist/index.d.mts

@@ -75,6 +75,13 @@ interface SyncConfig {
     lockFilePath: string;
     apiKey?: string;
     model?: string;
+    translator?: (params: {
+        text: string;
+        lang: string;
+        targetLang: string;
+        apiKey?: string;
+        model?: string;
+    }) => Promise<string>;
 }
 /**
  * Flattens a nested object to a map of flat paths

package/dist/index.d.ts

@@ -75,6 +75,13 @@ interface SyncConfig {
     lockFilePath: string;
     apiKey?: string;
     model?: string;
+    translator?: (params: {
+        text: string;
+        lang: string;
+        targetLang: string;
+        apiKey?: string;
+        model?: string;
+    }) => Promise<string>;
 }
 /**
  * Flattens a nested object to a map of flat paths

package/dist/index.js

@@ -282,9 +282,30 @@ var TranslationService = class {
     }
     let translatedCount = 0;
     if (toTranslate.length > 0) {
-      for (const change of toTranslate) {
+      const limit = (concurrency) => {
+        let active = 0;
+        const queue = [];
+        const run = async (fn) => {
+          if (active >= concurrency) {
+            await new Promise((resolve) => queue.push(resolve));
+          }
+          active++;
+          try {
+            return await fn();
+          } finally {
+            active--;
+            if (queue.length > 0) {
+              queue.shift()();
+            }
+          }
+        };
+        return run;
+      };
+      const runTask = limit(5);
+      await Promise.all(toTranslate.map((change) => runTask(async () => {
         try {
-          const translatedValue = await translate({
+          const _translate = this.config.translator || translate;
+          const translatedValue = await _translate({
             text: change.sourceText,
             lang: this.config.defaultLocale,
             targetLang: targetLocale,
@@ -304,7 +325,7 @@ var TranslationService = class {
             targetFlat.set(change.key, change.currentTranslation);
           }
         }
-      }
+      })));
     }
     for (const change of changes.unchanged) {
       if (change.currentTranslation) {

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
   translate,
   unflattenObject,
   updateLockEntry
-} from "./chunk-NY2C35K2.mjs";
+} from "./chunk-X4OG3I7N.mjs";
 export {
   TranslationService,
   analyzeChanges,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "description": "AI-powered i18n translation and synchronization library",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,8 +19,7 @@
     "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts --clean",
     "dev": "tsup --watch",
     "start": "node dist/cli.js",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
+    "lint": "tsc --noEmit"
   },
   "repository": {
     "type": "git",
@@ -40,10 +39,12 @@
     "chalk": "^5.4.1",
     "commander": "^12.0.0",
     "dotenv": "^16.4.5",
+    "prompts": "^2.4.2",
     "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
+    "@types/prompts": "^2.4.9",
     "tsup": "^8.3.5",
     "tsx": "^4.7.1",
     "typescript": "^5.3.3"