i18ntk 2.6.0 → 3.0.0

package/main/manage/commands/CommandRouter.js

@@ -23,6 +23,7 @@ const BackupCommand = require('./BackupCommand');
 const DoctorCommand = require('./DoctorCommand');
 const FixerCommand = require('./FixerCommand');
 const ScannerCommand = require('./ScannerCommand');
+const TranslateCommand = require('./TranslateCommand');
 
 class CommandRouter {
     constructor(config = {}, ui = null, adminAuth = null) {
@@ -45,7 +46,8 @@ class CommandRouter {
             'backup': new BackupCommand(config, ui),
             'doctor': new DoctorCommand(config, ui),
             'fix': new FixerCommand(config, ui),
-            'scanner': new ScannerCommand(config, ui)
+            'scanner': new ScannerCommand(config, ui),
+            'translate': new TranslateCommand(config, ui)
         };
     }
 
@@ -232,6 +234,9 @@ class CommandRouter {
             case 'scanner':
                 return await this.commandHandlers.scanner.execute(options);
 
+            case 'translate':
+                return await this.commandHandlers.translate.execute(options);
+
             case 'debug':
                 console.log('Debug functionality is not available in this version.');
                 return { success: false, message: 'Debug not available' };
@@ -278,6 +283,7 @@ class CommandRouter {
         console.log(t('help.summaryCommand'));
         console.log(t('help.debugCommand'));
         console.log(t('help.scannerCommand'));
+        console.log(t('help.translateCommand'));
     }
 
     /**

package/main/manage/commands/TranslateCommand.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+/**
+ * I18NTK TRANSLATE COMMAND
+ *
+ * Interactive menu-driven auto-translation using Google Translate.
+ * Wraps i18ntk-translate.js behind a user-friendly menu flow.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { getUnifiedConfig } = require('../../../utils/config-helper');
+const { loadTranslations } = require('../../../utils/i18n-helper');
+const SetupEnforcer = require('../../../utils/setup-enforcer');
+
+class TranslateCommand {
+    constructor(config = {}, ui = null) {
+        this.config = config;
+        this.ui = ui;
+        this.prompt = null;
+        this.isNonInteractiveMode = false;
+        this.safeClose = null;
+        this.sourceDir = null;
+        this.sourceLang = null;
+        this.targetLang = null;
+    }
+
+    setRuntimeDependencies(prompt, isNonInteractiveMode, safeClose) {
+        this.prompt = prompt;
+        this.isNonInteractiveMode = isNonInteractiveMode;
+        this.safeClose = safeClose;
+    }
+
+    async execute(options = {}) {
+        try {
+            await SetupEnforcer.checkSetupCompleteAsync();
+        } catch (error) {
+            console.error('Setup check failed:', error.message);
+            return { success: false, error: 'Setup required' };
+        }
+
+        loadTranslations('en', path.resolve(__dirname, '..', '..', '..', 'ui-locales'));
+
+        const config = this.config || {};
+        const unified = getUnifiedConfig(config);
+
+        const defaultSourceDir = unified.sourceDir || unified.i18nDir || path.resolve(process.cwd(), 'locales', 'en');
+        this.sourceLang = unified.sourceLanguage || 'en';
+
+        console.log('\n============================================================');
+        console.log('  \u{1F310} AUTO TRANSLATE (BETA)');
+        console.log('============================================================');
+
+        if (this.isNonInteractiveMode) {
+            this.sourceDir = defaultSourceDir;
+            if (!fs.existsSync(this.sourceDir)) {
+                console.error(`Source locale directory not found: ${this.sourceDir}`);
+                return { success: false, error: 'Source directory not found' };
+            }
+            const jsonFiles = fs.readdirSync(this.sourceDir).filter(f => f.endsWith('.json')).sort();
+            return await this.nonInteractiveFlow(jsonFiles);
+        }
+
+        const { ask } = require('../../../utils/cli');
+
+        // Step 1: Choose source directory
+        this.sourceDir = await this.promptSourceDir(ask, defaultSourceDir);
+        if (!this.sourceDir) return { success: false, error: 'No source directory selected' };
+
+        // Step 2: Choose source language
+        this.sourceLang = await this.promptSourceLang(ask);
+        if (!this.sourceLang) return { success: false, error: 'No source language selected' };
+
+        const jsonFiles = fs.readdirSync(this.sourceDir)
+            .filter(f => f.endsWith('.json'))
+            .sort();
+
+        if (jsonFiles.length === 0) {
+            console.error(`No JSON files found in: ${this.sourceDir}`);
+            return { success: false, error: 'No source files found' };
+        }
+
+        return await this.interactiveFlow(jsonFiles, ask);
+    }
+
+    async promptSourceDir(ask, defaultDir) {
+        while (true) {
+            console.log(`\n  Source directory [default: ${defaultDir}]`);
+            console.log('  Press Enter for default, or type a custom path.');
+            const input = await ask('  > ');
+
+            if (!input.trim()) {
+                if (!fs.existsSync(defaultDir)) {
+                    console.log(`  Default directory not found: ${defaultDir}`);
+                    console.log('  Please enter an existing directory with JSON locale files.');
+                    continue;
+                }
+                console.log(`  Using default: ${defaultDir}`);
+                return defaultDir;
+            }
+
+            const resolved = path.resolve(process.cwd(), input.trim());
+            if (!fs.existsSync(resolved)) {
+                console.log(`  Directory not found: ${resolved}`);
+                continue;
+            }
+            if (!fs.statSync(resolved).isDirectory()) {
+                console.log(`  Not a directory: ${resolved}`);
+                continue;
+            }
+            return resolved;
+        }
+    }
+
+    async promptSourceLang(ask) {
+        while (true) {
+            console.log(`\n  Source language code [default: ${this.sourceLang}]`);
+            const input = await ask('  > ');
+
+            if (!input.trim()) {
+                return this.sourceLang;
+            }
+
+            const lang = input.trim().toLowerCase();
+            if (lang.length >= 2) {
+                return lang;
+            }
+            console.log('  Invalid language code. Use 2+ characters (e.g. en, de, fr).');
+        }
+    }
+
+    async interactiveFlow(jsonFiles, ask) {
+
+        console.log('\n  Target language code(s)');
+        console.log('  Enter one or more comma/space-separated codes');
+        console.log('  (e.g. de, es, fr  or  de es fr  or  de):');
+        const langInput = await ask('  > ');
+
+        const targetLangs = langInput
+            .trim()
+            .split(/[,;\s]+/)
+            .map(s => s.toLowerCase().trim())
+            .filter(s => s.length >= 2);
+
+        if (targetLangs.length === 0) {
+            console.log('  No valid language codes entered. Aborting.');
+            return { success: false, error: 'Invalid language code' };
+        }
+
+        console.log(`\n  Target languages: ${targetLangs.join(', ')}`);
+
+        console.log(`\n  Which file(s) to translate?`);
+        console.log(`    a) All files (${jsonFiles.join(', ')})`);
+        jsonFiles.forEach((f, i) => {
+            console.log(`    ${i + 1}) ${f}`);
+        });
+
+        const fileChoice = await ask('\n  Choice [a/1-9]: ');
+        let sourceFiles;
+
+        if (fileChoice.toLowerCase() === 'a') {
+            sourceFiles = jsonFiles.map(f => path.join(this.sourceDir, f));
+        } else {
+            const idx = parseInt(fileChoice, 10) - 1;
+            if (isNaN(idx) || idx < 0 || idx >= jsonFiles.length) {
+                console.log('  Invalid choice. Aborting.');
+                return { success: false, error: 'Invalid file choice' };
+            }
+            sourceFiles = [path.join(this.sourceDir, jsonFiles[idx])];
+        }
+
+        // Dry-run for first language only (all languages use same source so same keys)
+        const firstLang = targetLangs[0];
+        console.log(`\n  Dry-run preview for "${firstLang}"...\n`);
+        await this.runTranslate(sourceFiles, firstLang, { dryRun: true });
+
+        console.log('\n  Proceed with actual translation?');
+        const answer = await ask('  [y]es / [n]o: ');
+        if (!/^y|yes$/i.test(answer.trim())) {
+            console.log('  Translation cancelled.');
+            return { success: true, cancelled: true };
+        }
+
+        let results = [];
+        for (const lang of targetLangs) {
+            console.log(`\n  Translating to "${lang}"...\n`);
+            try {
+                await this.runTranslate(sourceFiles, lang, { dryRun: false });
+                results.push({ lang, ok: true });
+            } catch (e) {
+                console.error(`  Failed for "${lang}": ${e.message}`);
+                results.push({ lang, ok: false, error: e.message });
+            }
+        }
+
+        console.log('\n  Summary:');
+        for (const r of results) {
+            console.log(`    ${r.ok ? '\u{2705}' : '\u{274C}'} ${r.lang}${r.error ? ' (' + r.error + ')' : ''}`);
+        }
+        console.log('\n  Translation complete!');
+        return { success: true, results };
+    }
+
+    async nonInteractiveFlow(jsonFiles) {
+        console.log('\n  Non-interactive mode. Use direct CLI instead:');
+        console.log('    i18ntk-translate <source> <lang> [options]');
+        return { success: false, error: 'Non-interactive mode not supported from menu' };
+    }
+
+    async runTranslate(sourceFiles, targetLang, opts = {}) {
+        const { spawn } = require('child_process');
+
+        for (const src of sourceFiles) {
+            const args = [
+                path.resolve(__dirname, '..', '..', 'i18ntk-translate.js'),
+                src,
+                targetLang,
+                '--no-confirm',
+                '--skip-placeholders',
+                '--report-stdout'
+            ];
+
+            if (opts.dryRun) {
+                args.push('--dry-run');
+            }
+
+            await new Promise((resolve, reject) => {
+                const proc = spawn('node', args, {
+                    stdio: 'inherit',
+                    cwd: process.cwd()
+                });
+                proc.on('close', (code) => {
+                    if (code === 0) resolve();
+                    else reject(new Error(`Exit code ${code}`));
+                });
+                proc.on('error', reject);
+            });
+        }
+    }
+}
+
+module.exports = TranslateCommand;

package/main/manage/index.js

@@ -878,6 +878,7 @@ class I18nManager {
             console.log(`11. ${t('menu.options.help')}`);
             console.log(`12. ${t('menu.options.language')}`);
             console.log(`13. ${t('menu.options.scanner')}`);
+            console.log(`14. ${t('menu.options.translate')}`);
             console.log(`0. ${t('menu.options.exit')}`);
 
             console.log('\n' + t('menu.nonInteractiveModeWarning'));
@@ -903,6 +904,7 @@ class I18nManager {
         console.log(`11. ${t('menu.options.help')}`);
         console.log(`12. ${t('menu.options.language')}`);
         console.log(`13. ${t('menu.options.scanner')}`);
+        console.log(`14. ${t('menu.options.translate')}`);
         console.log(`0. ${t('menu.options.exit')}`);
 
         const choice = await this.prompt('\n' + t('menu.selectOptionPrompt'));
@@ -1007,11 +1009,15 @@ class I18nManager {
             case '12':
                 await this.showLanguageMenu();
                 break;
-            case '13':
-                await this.executeCommand('scanner', {fromMenu: true});
-                await this.showInteractiveMenu();
-                return;
-            case '0':
+            case '13':
+                await this.executeCommand('scanner', {fromMenu: true});
+                await this.showInteractiveMenu();
+                return;
+            case '14':
+                await this.executeCommand('translate', {fromMenu: true});
+                await this.showInteractiveMenu();
+                return;
+            case '0':
                 console.log(t('menu.goodbye'));
                 this.safeClose();
                 process.exit(0);

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "i18ntk",
-  "version": "2.6.0",
-  "description": "Zero-dependency internationalization toolkit for setup, scanning, analysis, validation, usage tracking, fixing, reporting, and runtime translation loading.",
+  "version": "3.0.0",
+  "description": "Zero-dependency internationalization toolkit for setup, scanning, analysis, validation, auto translation, fixing, reporting, and runtime translation loading.",
   "keywords": [
     "i18n",
     "internationalization",
     "localization",
     "translation",
+    "auto-translation",
+    "google-translate",
     "l10n",
     "multilingual",
     "i18next",
@@ -76,12 +78,14 @@
     "i18ntk-doctor": "main/i18ntk-doctor.js",
     "i18ntk-fixer": "main/i18ntk-fixer.js",
     "i18ntk-scanner": "main/i18ntk-scanner.js",
-    "i18ntk-backup": "main/i18ntk-backup.js"
+    "i18ntk-backup": "main/i18ntk-backup.js",
+    "i18ntk-translate": "main/i18ntk-translate.js"
   },
   "files": [
     "main/i18ntk-analyze.js",
     "main/i18ntk-backup-class.js",
     "main/i18ntk-backup.js",
+    "main/i18ntk-translate.js",
     "main/i18ntk-complete.js",
     "main/i18ntk-doctor.js",
     "main/i18ntk-fixer.js",
@@ -114,6 +118,11 @@
     "utils/extractors/regex.js",
     "utils/format-manager.js",
     "utils/formats/json.js",
+    "utils/translate/placeholder.js",
+    "utils/translate/api.js",
+    "utils/translate/traverse.js",
+    "utils/translate/report.js",
+    "utils/translate/cli.js",
     "utils/framework-detector.js",
     "utils/i18n-helper.js",
     "utils/init-helper.js",

package/ui-locales/de.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - Projektstatus anzeigen",
     "debugCommand": "debug     - Übersetzungsfehler debuggen",
     "scannerCommand": "scanner   - Projekt für i18n-Schlüssel scannen",
+    "translateCommand": "translate - Auto-Übersetzung (Beta)",
     "menu": {
       "pressEnterToContinue": "Drücken Sie die Eingabetaste, um fortzufahren...",
       "title": "🌐 I18NTK VERWALTUNGSMENÜ",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 Größenanalyse",
       "fix": "🛠️  Platzhalterübersetzungen reparieren",
       "scanner": "🔍 i18n-Probleme scannen",
+      "translate": "🌐 Auto-Übersetzung (Beta)",
       "workflow": "🔄 Gesamten Workflow ausführen",
       "status": "📋 Projektstatus anzeigen",
       "delete": "🗑️  Alle Berichte löschen",
@@ -2111,6 +2113,7 @@
       "completeCommand": "complete  - Übersetzungen vervollständigen (100% Abdeckung)",
       "summaryCommand": "summary   - Projektstatus anzeigen",
       "scannerCommand": "scanner   - i18n-Probleme scannen",
+      "translateCommand": "translate - Auto-Übersetzung (Beta)",
       "debugCommand": "debug     - Übersetzungsprobleme debuggen"
     },
     "test_complete_system": {

package/ui-locales/en.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - Show project status",
     "debugCommand": "debug     - Debug translation issues",
     "scannerCommand": "scanner   - Scan for keys",
+    "translateCommand": "translate - Auto-translate locale files (Beta)",
     "menu": {
       "pressEnterToContinue": "Press Enter to continue...",
       "title": "🌐 I18NTK MANAGEMENT MENU",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 Analyze sizing",
       "fix": "🛠️  Fix placeholder translations",
       "scanner": "🔍 Scan for i18n issues",
+      "translate": "🌐 Auto Translate (Beta)",
       "workflow": "🔄 Run full workflow",
       "status": "📋 Show project status",
       "delete": "🗑️  Delete all reports",
@@ -2109,6 +2111,7 @@
       "completeCommand": "complete  - Complete translations (100% coverage)",
       "summaryCommand": "summary   - Show project status",
       "scannerCommand": "scanner   - Scan for i18n issues",
+      "translateCommand": "translate - Auto-translate locale files (Beta)",
       "debugCommand": "debug     - Debug translation issues"
     },
     "test_complete_system": {

package/ui-locales/es.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - Mostrar estado del proyecto",
     "debugCommand": "debug     - Depurar problemas de traducción",
     "scannerCommand": "scanner   - Escanear proyecto para claves i18n",
+    "translateCommand": "translate - Traducción automática (Beta)",
     "menu": {
       "pressEnterToContinue": "Presiona Enter para continuar...",
       "title": "🌐 MENÚ DE GESTIÓN I18NTK",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 Analizar dimensionamiento",
       "fix": "🛠️  Corregir traducciones provisionales",
       "scanner": "🔍 Buscar problemas de i18n",
+      "translate": "🌐 Traducción Automática (Beta)",
       "workflow": "🔄 Ejecutar flujo completo",
       "status": "📋 Mostrar estado del proyecto",
       "delete": "🗑️  Eliminar todos los informes",
@@ -2111,6 +2113,7 @@
       "completeCommand": "complete  - Completar traducciones (100% cobertura)",
       "summaryCommand": "summary   - Mostrar estado del proyecto",
       "scannerCommand": "scanner   - Escanear problemas i18n",
+      "translateCommand": "translate - Traducción automática (Beta)",
       "debugCommand": "debug     - Depurar problemas de traducción"
     },
     "test_complete_system": {

package/ui-locales/fr.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - Afficher le statut du projet",
     "debugCommand": "debug     - Déboguer les problèmes de traduction",
     "scannerCommand": "scanner - Rechercher des clés",
+    "translateCommand": "translate - Traduction automatique (Bêta)",
     "menu": {
       "pressEnterToContinue": "Appuyez sur Entrée pour continuer...",
       "title": "🌐 MENU DE GESTION I18NTK",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 Analyser le dimensionnement",
       "fix": "🛠️  Corriger les traductions de remplacement",
       "scanner": "🔍 Analyser les problèmes i18n",
+      "translate": "🌐 Traduction Automatique (Bêta)",
       "workflow": "🔄 Exécuter le flux complet",
       "status": "📋 Afficher le statut du projet",
       "delete": "🗑️ Supprimer tous les rapports",
@@ -2111,6 +2113,7 @@
       "completeCommand": "complete  - Compléter les traductions (couverture 100%)",
       "summaryCommand": "summary   - Afficher l'état du projet",
       "scannerCommand": "scanner   - Scanner le projet pour les clés i18n",
+      "translateCommand": "translate - Traduction automatique (Bêta)",
       "debugCommand": "debug     - Déboguer les problèmes de traduction"
     },
     "test_complete_system": {

package/ui-locales/ja.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - プロジェクトのステータスを表示",
     "debugCommand": "debug     - 翻訳の問題をデバッグ",
     "scannerCommand": "scanner   - プロジェクトをスキャン",
+    "translateCommand": "translate - 自動翻訳 (ベータ版)",
     "menu": {
       "pressEnterToContinue": "Enterキーを押して続行してください…",
       "title": "🌐 I18NTK 管理メニュー",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 サイズを分析",
       "fix": "🛠️  プレースホルダー翻訳を修正",
       "scanner": "🔍 i18n問題をスキャン",
+      "translate": "🌐 自動翻訳 (ベータ版)",
       "workflow": "🔄 フルワークフローを実行",
       "status": "📋 プロジェクトステータスを表示",
       "delete": "🗑️  すべてのレポートを削除",
@@ -2111,6 +2113,7 @@
       "completeCommand": "complete  - 翻訳を完了 (100% カバレッジ)",
       "summaryCommand": "summary   - プロジェクトステータスを表示",
       "scannerCommand": "scanner   - 🔍 i18nの問題をスキャン",
+      "translateCommand": "translate - 自動翻訳 (ベータ版)",
       "debugCommand": "debug     - 翻訳の問題をデバッグ"
     },
     "test_complete_system": {

package/ui-locales/ru.json

@@ -1146,6 +1146,7 @@
       "sizing": "📏 Анализ размеров",
       "fix": "🛠️  Исправить переводы-заглушки",
       "scanner": "🔍 Сканировать проблемы i18n",
+      "translate": "🌐 Автоперевод (Бета)",
       "workflow": "🔄 Запустить полный рабочий процесс",
       "status": "📋 Показать статус проекта",
       "delete": "🗑️ Удалить все отчёты",
@@ -2110,7 +2111,8 @@
       "sizingCommand": "Оценка команды",
       "completeCommand": "Завершение команды",
       "summaryCommand": "Сводка команды",
-      "scannerCommand": "scanner   - 🔍 Сканирование проблем i18n",
+    "scannerCommand": "scanner   - 🔍 Сканирование проблем i18n",
+    "translateCommand": "translate - Автоперевод (Бета)",
       "debugCommand": "Отладка команды"
     },
     "test_complete_system": {

package/ui-locales/zh.json

@@ -922,6 +922,7 @@
     "summaryCommand": "summary   - 显示项目状态",
     "debugCommand": "debug     - 调试翻译问题",
     "scannerCommand": "scanner   - 扫描项目中的 i18n 键",
+    "translateCommand": "translate - 自动翻译 (测试版)",
     "menu": {
       "pressEnterToContinue": "按 Enter 继续...",
       "title": "🌐 国际化管理菜单",
@@ -1146,6 +1147,7 @@
       "sizing": "📏 分析大小差异",
       "fix": "🛠️  修复占位翻译",
       "scanner": "🔍 扫描i18n问题",
+      "translate": "🌐 自动翻译 (测试版)",
       "workflow": "🔄 运行完整工作流",
       "status": "📋 显示项目状态",
       "delete": "🗑️  删除全部报告",
@@ -2111,6 +2113,7 @@
       "completeCommand": "complete  - 完成翻译（100% 覆盖）",
       "summaryCommand": "summary   - 显示项目状态",
       "scannerCommand": "scanner   - 🔍 扫描i18n问题",
+      "translateCommand": "translate - 自动翻译 (测试版)",
       "debugCommand": "debug     - 调试翻译问题"
     },
     "test_complete_system": {