@ccgp/i18n-ai 0.1.0 → 0.1.2

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-KVP2GFHU.mjs}

@@ -10,11 +10,23 @@ var translate = async ({ text, lang, targetLang, apiKey, model }) => {
   const openrouter = createOpenRouter({
     apiKey: token
   });
+  const system = `
+    You are a professional translator. Your main task is to translate text from "${lang}" to "${targetLang}".
+    
+    IMPORTANT RULES:
+    1. Return ONLY the translated text. No explanations, no quotes around the output.
+    2. Do NOT translate text inside curly braces, e.g., "{name}", "{count}". These are variables and must remain exactly as they are.
+    3. Maintain the original tone and context.
+    4. If the text is a single word or short phrase, translate it directly.
+    
+    Examples:
+    - Input: "Hello {name}, welcome back!" -> Output (ES): "Hola {name}, \xA1bienvenido de nuevo!"
+    - Input: "Contact us calling to {number}" -> Output (FR): "Contactez-nous en appelant le {number}"
+  `;
   const { output } = await generateText({
     model: openrouter.languageModel(model || "google/gemini-2.5-flash"),
-    prompt: `Translate the following text from ${lang} to ${targetLang}. Return ONLY the translated text, no explanations or additional text.
-
-Text to translate: ${text}`,
+    system,
+    prompt: `Text to translate: "${text}"`,
     output: Output.object({
       schema: z.object({
         translatedText: z.string()
@@ -236,9 +248,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 +291,7 @@ var TranslationService = class {
             targetFlat.set(change.key, change.currentTranslation);
           }
         }
-      }
+      })));
     }
     for (const change of changes.unchanged) {
       if (change.currentTranslation) {

package/dist/cli.js

@@ -44,11 +44,23 @@ var translate = async ({ text, lang, targetLang, apiKey, model }) => {
   const openrouter = (0, import_ai_sdk_provider.createOpenRouter)({
     apiKey: token
   });
+  const system = `
+    You are a professional translator. Your main task is to translate text from "${lang}" to "${targetLang}".
+    
+    IMPORTANT RULES:
+    1. Return ONLY the translated text. No explanations, no quotes around the output.
+    2. Do NOT translate text inside curly braces, e.g., "{name}", "{count}". These are variables and must remain exactly as they are.
+    3. Maintain the original tone and context.
+    4. If the text is a single word or short phrase, translate it directly.
+    
+    Examples:
+    - Input: "Hello {name}, welcome back!" -> Output (ES): "Hola {name}, \xA1bienvenido de nuevo!"
+    - Input: "Contact us calling to {number}" -> Output (FR): "Contactez-nous en appelant le {number}"
+  `;
   const { output } = await (0, import_ai.generateText)({
     model: openrouter.languageModel(model || "google/gemini-2.5-flash"),
-    prompt: `Translate the following text from ${lang} to ${targetLang}. Return ONLY the translated text, no explanations or additional text.
-
-Text to translate: ${text}`,
+    system,
+    prompt: `Text to translate: "${text}"`,
     output: import_ai.Output.object({
       schema: import_zod.default.object({
         translatedText: import_zod.default.string()
@@ -268,9 +280,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 +323,7 @@ var TranslationService = class {
             targetFlat.set(change.key, change.currentTranslation);
           }
         }
-      }
+      })));
     }
     for (const change of changes.unchanged) {
       if (change.currentTranslation) {

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TranslationService
-} from "./chunk-NY2C35K2.mjs";
+} from "./chunk-KVP2GFHU.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

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

@@ -146,11 +146,23 @@ var translate = async ({ text, lang, targetLang, apiKey, model }) => {
   const openrouter = (0, import_ai_sdk_provider.createOpenRouter)({
     apiKey: token
   });
+  const system = `
+    You are a professional translator. Your main task is to translate text from "${lang}" to "${targetLang}".
+    
+    IMPORTANT RULES:
+    1. Return ONLY the translated text. No explanations, no quotes around the output.
+    2. Do NOT translate text inside curly braces, e.g., "{name}", "{count}". These are variables and must remain exactly as they are.
+    3. Maintain the original tone and context.
+    4. If the text is a single word or short phrase, translate it directly.
+    
+    Examples:
+    - Input: "Hello {name}, welcome back!" -> Output (ES): "Hola {name}, \xA1bienvenido de nuevo!"
+    - Input: "Contact us calling to {number}" -> Output (FR): "Contactez-nous en appelant le {number}"
+  `;
   const { output } = await (0, import_ai.generateText)({
     model: openrouter.languageModel(model || "google/gemini-2.5-flash"),
-    prompt: `Translate the following text from ${lang} to ${targetLang}. Return ONLY the translated text, no explanations or additional text.
-
-Text to translate: ${text}`,
+    system,
+    prompt: `Text to translate: "${text}"`,
     output: import_ai.Output.object({
       schema: import_zod.default.object({
         translatedText: import_zod.default.string()
@@ -282,9 +294,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 +337,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-KVP2GFHU.mjs";
 export {
   TranslationService,
   analyzeChanges,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",