@ccgp/i18n-ai 0.1.2 → 0.1.4

package/README.md

@@ -5,8 +5,10 @@ AI-powered internationalization (i18n) translation and synchronization library.
 ## Features
 
 - 🤖 **AI-Powered**: Uses Google Gemini (via OpenRouter) to generate context-aware translations.
-- 🔄 **Smart Synchronization**: Detects new, modified, and obsolete keys.
-- 🔒 **Lock File System**: Prevents unnecessary re-translations of already translated content.
+- � **Parallel Processing**: Translations run concurrently for maximum speed (5x faster).
+- �🔄 **Smart Synchronization**: Detects new, modified, and obsolete keys.
+- �️ **Variable Protection**: Automatically preserves variables like `{name}` or `{count}`.
+- �🔒 **Lock File System**: Prevents unnecessary re-translations of already translated content.
 - 🧩 **Framework Agnostic**: Works with any i18n library that uses JSON files (next-intl, react-i18next, etc.).
 
 ## Installation
@@ -23,32 +25,7 @@ npm install @ccgp/i18n-ai
 
 The easiest way to use `i18n-ai` is via the CLI.
 
-Add a script to your `package.json`:
-
-```json
-{
-  "scripts": {
-    "i18n:sync": "i18n-ai sync"
-  }
-}
-```
-
-Or run it directly:
-
-```bash
-bun x i18n-ai sync
-```
-
-#### Configuration
-
-The CLI attempts to auto-detect your configuration from `i18n/routing.ts` if you are using `next-intl`. Otherwise, you can specify options:
-
-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:
+1. **Initialize configuration:**
 
 ```bash
 bun x i18n-ai init
@@ -64,7 +41,7 @@ This will create an `i18n-ai.config.json` file:
 }
 ```
 
-Then you can simply run:
+2. **Run synchronization:**
 
 ```bash
 bun x i18n-ai sync
@@ -80,12 +57,48 @@ Create a `.env` file:
 OPENROUTER_API_KEY=your_api_key
 ```
 
+### Automate with GitHub Actions
+
+You can automate translations whenever you push changes to your default locale.
+
+Create `.github/workflows/i18n-translate.yml`:
+
+```yaml
+name: AI Translation Sync
+
+on:
+  push:
+    paths:
+      - 'public/messages/en.json' # Monitor ONLY source locale
+
+jobs:
+  translate:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+      - run: bun install
+      - run: bun x i18n-ai sync
+        env:
+          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
+      - run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          if [[ -n $(git status -s) ]]; then
+            git add public/messages/*.json translation-lock.json
+            git commit -m "chore(i18n): update translations [skip ci]"
+            git push
+          fi
+```
+
 ## Programmatic Usage
 
 You can also use the library programmatically:
 
 ```typescript
-import { TranslationService } from 'i18n-ai';
+import { TranslationService } from '@ccgp/i18n-ai';
 import { resolve } from 'path';
 
 const service = new TranslationService({

package/dist/cli.js

@@ -415,23 +415,6 @@ program.command("sync").description("Synchronize translations using AI").option(
     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 {
-        }
-      }
       if (!messagesDir) messagesDir = (0, import_path2.resolve)(cwd, "messages");
       if (!defaultLocale) defaultLocale = "en";
     }

package/dist/cli.mjs

@@ -79,23 +79,6 @@ program.command("sync").description("Synchronize translations using AI").option(
     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 {
-        }
-      }
       if (!messagesDir) messagesDir = resolve(cwd, "messages");
       if (!defaultLocale) defaultLocale = "en";
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "AI-powered i18n translation and synchronization library",
   "main": "dist/index.js",
   "module": "dist/index.mjs",