t9n-cli 0.1.0 → 0.1.1

package/dictionaries/zh-TW.json

@@ -0,0 +1,244 @@
+{
+  "home": {
+    "badge": "t9n - MVP",
+    "title": "尊重程式碼的 i18n 翻譯。",
+    "subtitle": "零語法錯誤。變數保護。上下文感知。",
+    "button": "開始翻譯"
+  },
+  "editor": {
+    "run": "執行翻譯",
+    "translating": "正在翻譯",
+    "source": {
+      "label": "來源語言",
+      "upload": "上傳 JSON",
+      "upload_multiple": "點擊上傳 JSON 檔案",
+      "context": "上下文",
+      "context_placeholder": "加入上下文以提升翻譯準確度...",
+      "pro_feature": "專業版功能",
+      "pro_context_msg": "升級以提供上下文，獲取更高準確度。",
+      "info": "來源",
+      "lines": "行數",
+      "clear_context": "清除",
+      "large_file_title": "已載入大檔案 ({size})",
+      "large_file_desc": "為提升效能已停用預覽。完整內容將送出翻譯。"
+    },
+    "diff_dialog": {
+      "title": "增量更新 (Diff)",
+      "files_preview": "檔案預覽",
+      "base_tag": "基準",
+      "start_diff": "開始比對"
+    },
+    "target": {
+      "label": "目標語言",
+      "copy": "複製",
+      "download": "下載",
+      "no_selection": "未選擇語言",
+      "placeholder": "選擇語言並執行翻譯後在此查看結果",
+      "stale_warning": "來源已更改 - 翻譯已過期",
+      "max_select": "最多 {n}",
+      "more_suffix": "(+{n})"
+    },
+    "mobile": {
+      "view_result": "查看結果",
+      "back_to_code": "返回代碼"
+    },
+    "features": {
+      "diff_title": "增量更新",
+      "diff_msg": "增量更新功能即將推出！",
+      "soon": "即將推出"
+    },
+    "messages": {
+      "pro_feature_title": "專業版功能 (即將推出)",
+      "upload_pro_msg": "上傳是專業版功能。\n\n我們正在開發進階功能，敬請期待！\n\n需要協助？請聯繫：{email}",
+      "download_pro_msg": "下載是專業版功能。\n\n我們正在開發進階功能，敬請期待！\n\n需要協助？請聯繫：{email}",
+      "diff_upload_hint": "上傳所有翻譯檔案。最完整的一個將被用作基準。",
+      "file_too_large_title": "檔案過大",
+      "file_too_large_msg": "檔案過大 ({size})。上限為 {limit}。\n\n檔案切割功能即將推出！",
+      "copied": "已複製到剪貼簿！",
+      "copy_failed": "複製失敗",
+      "invalid_json": "來源 JSON 無效",
+      "translation_complete": "翻譯完成！",
+      "translation_failed": "翻譯失敗",
+      "daily_limit_reached": "已達每日上限",
+      "daily_limit_desc": "您今日的免費翻譯額度已用完。",
+      "pro_plan_coming_soon": "專業版方案與無限存取即將推出！",
+      "building_premium": "我們正在開發進階功能，敬請期待！",
+      "contact_us": "需要更多？請聯繫我們：{email}",
+      "error_details": "錯誤詳情：",
+      "limit_exceeded": "超過限制",
+      "limit_exceeded_desc": "{tier} 方案每次請求最多支援 {max} 個鍵。您的檔案有 {keys} 個鍵。",
+      "insufficient_credits": "額度不足",
+      "insufficient_credits_desc": "此翻譯需要 {cost} 點數，但您剩餘 {available} 點。",
+      "free_plan_limit_exceeded": "超過免費版限制",
+      "upgrade_to_pro": "升級至專業版 (即將推出)",
+      "pro_benefits_1": "檔案鍵數無限制",
+      "pro_benefits_2": "上下文長度無限制",
+      "pro_benefits_3": "批次翻譯",
+      "reduce_size": "目前請縮減檔案大小或上下文內容。",
+      "select_target_lang": "請至少選擇一個目標語言。",
+      "up_to_date": "所有選擇的語言皆為最新。",
+      "translating_placeholder": "// 翻譯中...",
+      "error_no_data": "// 錯誤：未回傳資料。",
+      "error_failed_generic": "// 錯誤：翻譯失敗。請重試。",
+      "max_langs_reached": "免費版最多支援 {n} 種目標語言。",
+      "credits_needed": "所需點數",
+      "credits_remaining": "剩餘",
+      "invalid_base_json": "基準 JSON 無效",
+      "invalid_base_content": "基準檔案內容無效"
+    }
+  },
+  "common": {
+    "contact": "聯繫我們",
+    "email": "z17682341097@gmail.com",
+    "pro": "專業版",
+    "coming_soon": "即將推出",
+    "pricing": "價格方案",
+    "docs": "文件與 CLI",
+    "cli": "CLI",
+    "i18n_note": "本網站的所有翻譯皆由 t9n 生成。",
+    "upgrade": "升級",
+    "auto_detect": "自動偵測",
+    "soon": "即將推出",
+    "pro_only": "(僅限 {pro})",
+    "contact_support": "聯繫支援",
+    "pricing_limits": "價格與限制",
+    "back_to_home": "返回首頁",
+    "back_to_editor": "返回編輯器",
+    "mail_to": "發送郵件至",
+    "cancel": "取消",
+    "close": "關閉",
+    "confirm": "確認",
+    "notification": "通知"
+  },
+  "auth": {
+    "login": "登入",
+    "logout": "登出",
+    "welcome_back": "歡迎回來",
+    "login_desc": "登入以使用專業版功能與更高限制",
+    "cli_login_required": "請先使用此命令登入：t9n auth <your-api-key>",
+    "continue_google": "使用 Google 帳號繼續",
+    "continue_github": "使用 GitHub 帳號繼續",
+    "terms": "繼續操作即表示您同意我們的服務條款與隱私權政策。"
+  },
+  "settings": {
+    "title": "設定",
+    "apikeys": {
+      "title": "API 金鑰",
+      "desc": "管理您的 API 金鑰，用於 CLI 工具或 CI/CD 流程。",
+      "create": "建立新金鑰",
+      "name_label": "金鑰名稱",
+      "name_placeholder": "例如：我的筆電 CLI",
+      "key_secret_warning": "請立即複製您的 API 金鑰。為了安全，金鑰將不再顯示。",
+      "copy_key": "複製金鑰",
+      "list_empty": "尚未建立 API 金鑰。",
+      "revoke": "撤銷",
+      "revoke_confirm": "確定要撤銷此 API 金鑰嗎？使用此金鑰的工具將停止運作。",
+      "last_used": "上次使用",
+      "never_used": "未使用過",
+      "created": "建立日期"
+    }
+  },
+  "pricing": {
+    "title": "簡單透明的價格",
+    "subtitle": "選擇最符合您翻譯需求的方案。",
+    "monthly": "每月",
+    "daily": "每日",
+    "per_request": "按次計費",
+    "get_started": "立即開始",
+    "upgrade": "立即升級",
+    "contact_sales": "聯繫業務",
+    "features": {
+      "credits": "{n} 點數",
+      "keys": "最多 {n} 個鍵",
+      "langs": "最多 {n} 種語言",
+      "upload_download": "上傳 / 下載",
+      "diff": "增量更新 (Diff)",
+      "context": "上下文感知"
+    },
+    "most_popular": "最熱門",
+    "custom": "客製化"
+  },
+  "metadata": {
+    "title": "t9n - 工程師專用的 JSON 翻譯器 | i18n AI 翻譯工具",
+    "description": "開發者優先的 i18n JSON 檔案 AI 翻譯器。零語法錯誤、變數保護 (React Intl, i18next) 與智慧上下文感知。翻譯的是軟體，不只是文字。",
+    "og_title": "t9n - 工程師專用的 JSON 翻譯器",
+    "og_description": "在不破壞代碼變數的情況下翻譯 i18n JSON 檔案。支援 React Intl、i18next 等。"
+  },
+  "docs": {
+    "title": "說明文件",
+    "subtitle": "深入了解 t9n 的功能，從基礎用法到進階增量更新與 AI 上下文優化。",
+    "sections": {
+      "basic": {
+        "title": "基礎功能：即時翻譯",
+        "content": "t9n 專為 i18n JSON 格式設計。我們優化了 Prompt 策略，確保所有程式碼變數 (如 {name} 或 {{count}}) 在翻譯過程中受到嚴格保護。",
+        "item1": "支援批次選擇目標語言，一次生成多份翻譯。",
+        "item2": "即時預覽：來源內容與目標內容並排對比。"
+      },
+      "context": {
+        "title": "上下文感知",
+        "content": "翻譯不僅僅是字對字。透過提供應用程式背景，AI 可以更準確地選擇詞彙。",
+        "example": "例如，同一個詞 \"Menu\"，在餐廳 App 中是「菜單」，在設計軟體中則是「功能表」。提供上下文可消除歧義。"
+      },
+      "diff": {
+        "title": "智慧增量更新 (Diff 模式)",
+        "content": "當您的來源語言檔案 (例如 en.json) 有新內容時，您無需重新翻譯整個檔案。t9n 的增量更新模式現已支援全自動化。",
+        "new_feature": "新功能：全自動多檔案識別",
+        "step1_title": "1. 多選上傳",
+        "step1_desc": "在上傳對話框中同時選擇英文 (基準) 和現有的翻譯檔案 (例如中文、日文)。不再需要手動比對。",
+        "step2_title": "2. 智慧基準偵測",
+        "step2_desc": "系統會自動統計每個檔案中的鍵數，並將最完整的一個視為「翻譯基準」，自動填補其他檔案中缺失的部分。",
+        "step3_title": "3. 精準翻譯",
+        "step3_desc": "缺失的鍵會被標記為 🚧 [MISSING]。AI 僅翻譯這些標記，為您節省超過 90% 的點數。",
+        "quote": "「保留 100% 現有翻譯，僅處理新需求。」"
+      },
+      "cli": {
+        "tag": "現已推出",
+        "title": "t9n CLI",
+        "content": "從終端機進行專業的 i18n 管理。使用我們強大的命令列介面自動化您的翻譯工作流程。",
+        "install": "npm install -g @t9n/cli",
+        "command_auth": "t9n auth <key>",
+        "command_init": "t9n init",
+        "command_scan": "t9n scan ./src",
+        "command_translate": "t9n translate ./en.json -t zh-TW,ja",
+        "command_diff": "t9n diff ./dictionaries",
+        "desc_auth": "將您的本地環境與 t9n 帳戶連結。",
+        "desc_init": "建立 t9n.config.json 以儲存您的專案偏好設定。",
+        "desc_scan": "在原始碼中尋找尚未出現在 JSON 中的缺失鍵。",
+        "desc_translate": "直接翻譯本地檔案並自動儲存結果。",
+        "desc_diff": "針對資料夾中的所有語言進行智慧增量更新。",
+        "progress": "準備進入生產環境"
+      }
+    },
+    "example_correct": "Portfolio\" → \"投資組合\"",
+    "example_incorrect": "Portfolio\" → \"作品集\""
+  },
+  "cli": {
+    "diff": {
+      "title": "🛰️ T9N CLI - 增量更新",
+      "analyzing": "🔍 正在分析差異...",
+      "comparing": "正在與現有檔案比對...",
+      "new_lang": "偵測到新語言。",
+      "success": "翻譯接收成功！",
+      "updated": "已更新：",
+      "all_up_to_date": "✨ 所有翻譯皆為最新！"
+    },
+    "scan": {
+      "title": "🔍 T9N CLI - 代碼掃描器",
+      "scanning": "正在掃描檔案...",
+      "scanned": "已掃描 {n} 個檔案。",
+      "missing_found": "找到 {n} 個缺失鍵 (在代碼中但不在字典中)：",
+      "all_present": "✨ 代碼中的所有鍵皆已存在於字典中。",
+      "orphaned": "找到 {n} 個可能未使用的鍵 (在字典中但不在代碼中)："
+    },
+    "auth": {
+      "verifying": "正在驗證 API 金鑰...",
+      "success": "認證成功！({target} 配置)",
+      "key_missing": "請提供 API 金鑰。用法：t9n auth <key>"
+    },
+    "init": {
+      "title": "🎬 T9N - 專案初始化",
+      "created": "已建立專案配置：{path}",
+      "already_exists": "配置檔案已存在於：{path}"
+    }
+  }
+}

package/dist/api.d.ts

@@ -0,0 +1 @@
+export declare function request(path: string, options?: RequestInit): Promise<any>;

package/dist/api.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.request = request;
+const config_1 = require("./config");
+const chalk_1 = __importDefault(require("chalk"));
+const i18n_1 = require("./i18n");
+async function request(path, options = {}) {
+    const apiKey = (0, config_1.getApiKey)();
+    const baseUrl = (0, config_1.getApiUrl)();
+    if (!apiKey && !path.includes('/auth/')) {
+        throw new Error((0, i18n_1.t)('auth.cli_login_required'));
+    }
+    const response = await fetch(`${baseUrl}${path}`, {
+        ...options,
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'Accept-Language': (0, i18n_1.getCLILocale)(),
+            ...options.headers,
+        },
+    });
+    let text = '';
+    try {
+        text = await response.text();
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch (e) {
+            if (!response.ok) {
+                throw new Error(`Request failed (${response.status}): ${text || response.statusText}`);
+            }
+            throw new Error(`Failed to parse JSON response. Raw: ${text.substring(0, 100)}`);
+        }
+        if (!response.ok) {
+            const errorTitle = chalk_1.default.bold.red(data.error || 'Error');
+            const details = data.details ? `\n${chalk_1.default.white(data.details)}` : '';
+            const pricingUrl = `${baseUrl}/pricing`.replace('api.', ''); // fallback logic if URL structure differs
+            const upgradeTip = data.upgrade
+                ? `\n${chalk_1.default.yellow(`💡 Tip: Visit ${pricingUrl} to upgrade your plan.`)}`
+                : '';
+            throw new Error(`${errorTitle}${details}${upgradeTip}`);
+        }
+        return data;
+    }
+    catch (e) {
+        throw e;
+    }
+}

package/dist/commands/auth.d.ts

@@ -0,0 +1 @@
+export declare function auth(key: string, options: any): Promise<void>;

package/dist/commands/auth.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auth = auth;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+const i18n_1 = require("../i18n");
+async function auth(key, options) {
+    if (!key) {
+        console.error(chalk_1.default.red(`\n ${(0, i18n_1.t)('cli.auth.key_missing')}\n`));
+        return;
+    }
+    const spinner = (0, ora_1.default)({
+        text: chalk_1.default.blue((0, i18n_1.t)('cli.auth.verifying')),
+        color: 'blue'
+    }).start();
+    try {
+        const target = options.local ? 'local' : 'global';
+        // Temporarily set the key for the verification request
+        (0, config_1.writeConfig)({ apiKey: key }, target);
+        if (options.url) {
+            (0, config_1.writeConfig)({ apiUrl: options.url }, target);
+        }
+        const data = await (0, api_1.request)('/api/usage');
+        spinner.succeed(chalk_1.default.green((0, i18n_1.t)('cli.auth.success', { target })));
+        console.log(chalk_1.default.gray('\n ----------------------------------------'));
+        console.log(`${chalk_1.default.cyan(' 👤 Plan:   ')} ${chalk_1.default.bold(data.tierLabel)}`);
+        console.log(`${chalk_1.default.cyan(' 💎 Credits:')} ${chalk_1.default.bold(data.credits)} / ${data.creditsTotal}`);
+        console.log(chalk_1.default.gray(' ----------------------------------------\n'));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Authentication failed.'));
+        console.error(`\n ${chalk_1.default.red('Error:')} ${error.message}\n`);
+        // Cleanup if failed
+        (0, config_1.writeConfig)({ apiKey: '' });
+    }
+}

package/dist/commands/diff.d.ts

@@ -0,0 +1 @@
+export declare function diff(folderPath: string, options: any): Promise<void>;

package/dist/commands/diff.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diff = diff;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../api");
+const config_1 = require("../config");
+const jsonUtils_1 = require("../lib/jsonUtils");
+const i18n_1 = require("../i18n");
+async function diff(folderPath, options) {
+    const config = (0, config_1.readConfig)();
+    if (options.url) {
+        (0, config_1.writeConfig)({ apiUrl: options.url });
+    }
+    const dir = path_1.default.resolve(folderPath);
+    if (!fs_1.default.existsSync(dir) || !fs_1.default.statSync(dir).isDirectory()) {
+        console.error(chalk_1.default.red(`\n ❌ Error: [${folderPath}] is not a valid directory.`));
+        return;
+    }
+    const sourceLang = options.source || config.sourceLang || 'en';
+    const sourceFile = path_1.default.join(dir, `${sourceLang}.json`);
+    if (!fs_1.default.existsSync(sourceFile)) {
+        console.error(chalk_1.default.red(`\n ❌ Error: Source file [${sourceLang}.json] not found in directory.`));
+        return;
+    }
+    console.log(chalk_1.default.bold.cyan(`\n ${(0, i18n_1.t)('cli.diff.title')}`));
+    console.log(chalk_1.default.gray(' ----------------------------------------'));
+    console.log(`${chalk_1.default.yellow(' 📁 Folder:')}  ${dir}`);
+    console.log(`${chalk_1.default.yellow(' 📖 Source:')}  ${sourceLang}.json`);
+    const sourceJson = JSON.parse(fs_1.default.readFileSync(sourceFile, 'utf-8'));
+    const files = fs_1.default.readdirSync(dir);
+    const jsonFiles = files.filter(f => f.endsWith('.json') && f !== `${sourceLang}.json`);
+    const targetLangsFromOptions = options.target ? options.target.split(',').map((l) => l.trim()) : [];
+    const activeLangs = Array.from(new Set([...targetLangsFromOptions, ...jsonFiles.map(f => f.replace('.json', ''))]));
+    if (activeLangs.length === 0) {
+        console.log(chalk_1.default.yellow('\n ⚠️  No target languages detected. Use -t <langs> to add new ones.'));
+        return;
+    }
+    const targetJsonMap = {};
+    console.log(chalk_1.default.gray(`\n ${(0, i18n_1.t)('cli.diff.analyzing')}`));
+    for (const lang of activeLangs) {
+        const targetFile = path_1.default.join(dir, `${lang}.json`);
+        let existingJson = null;
+        if (fs_1.default.existsSync(targetFile)) {
+            try {
+                existingJson = JSON.parse(fs_1.default.readFileSync(targetFile, 'utf-8'));
+                console.log(`   ${chalk_1.default.blue('•')} ${lang.padEnd(6)} ${chalk_1.default.gray((0, i18n_1.t)('cli.diff.comparing'))}`);
+            }
+            catch (e) {
+                console.warn(`   ${chalk_1.default.yellow('•')} ${lang.padEnd(6)} ${chalk_1.default.red('Parse error, translating from scratch.')}`);
+            }
+        }
+        else {
+            console.log(`   ${chalk_1.default.green('•')} ${lang.padEnd(6)} ${chalk_1.default.gray((0, i18n_1.t)('cli.diff.new_lang'))}`);
+        }
+        targetJsonMap[lang] = (0, jsonUtils_1.fillMissingKeys)(sourceJson, existingJson);
+    }
+    const spinner = (0, ora_1.default)({
+        text: chalk_1.default.cyan('Requesting AI translation...'),
+        color: 'cyan'
+    }).start();
+    try {
+        const response = await (0, api_1.request)('/api/translate', {
+            method: 'POST',
+            body: JSON.stringify({
+                sourceJson,
+                sourceLang,
+                targetLang: activeLangs,
+                targetJson: targetJsonMap,
+                userContext: options.context || '',
+            }),
+        });
+        spinner.succeed(chalk_1.default.green((0, i18n_1.t)('cli.diff.success')));
+        console.log(chalk_1.default.gray(' ----------------------------------------'));
+        for (const lang of activeLangs) {
+            if (response[lang]) {
+                const outPath = path_1.default.join(dir, `${lang}.json`);
+                fs_1.default.writeFileSync(outPath, JSON.stringify(response[lang], null, 2));
+                console.log(`   ${chalk_1.default.green('✓')} ${chalk_1.default.bold(lang.padEnd(6))} ${chalk_1.default.gray('Updated:')} ${chalk_1.default.white(outPath)}`);
+            }
+            else {
+                console.error(`   ${chalk_1.default.red('✗')} ${chalk_1.default.bold(lang.padEnd(6))} ${chalk_1.default.red('Failed to update.')}`);
+            }
+        }
+        console.log(chalk_1.default.bold.green(`\n ${(0, i18n_1.t)('cli.diff.all_up_to_date')}\n`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Translation request failed.'));
+        console.error(`\n ${chalk_1.default.red('Details:')} ${error.message}\n`);
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = init;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const i18n_1 = require("../i18n");
+async function init() {
+    const localConfigFile = path_1.default.join(process.cwd(), 't9n.config.json');
+    console.log(chalk_1.default.bold.cyan(`\n ${(0, i18n_1.t)('cli.init.title')}`));
+    console.log(chalk_1.default.gray(' ----------------------------------------'));
+    if (fs_1.default.existsSync(localConfigFile)) {
+        console.log(`${chalk_1.default.yellow(' ⚠️ ')} ${(0, i18n_1.t)('cli.init.already_exists', { path: 't9n.config.json' })}`);
+        return;
+    }
+    const defaultConfig = {
+        sourceLang: 'en',
+        dictionary: './dictionaries/en.json',
+    };
+    try {
+        fs_1.default.writeFileSync(localConfigFile, JSON.stringify(defaultConfig, null, 2));
+        console.log(`${chalk_1.default.green(' ✓ ')} ${(0, i18n_1.t)('cli.init.created', { path: chalk_1.default.bold('t9n.config.json') })}`);
+        console.log(chalk_1.default.gray('\n Tip: Edit this file to match your project structure.'));
+        console.log(chalk_1.default.gray(' You can then run "t9n scan" or "t9n diff" without extra flags.'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\n ❌ Failed to create config: ${error.message}`));
+    }
+}

package/dist/commands/scan.d.ts

@@ -0,0 +1 @@
+export declare function scan(folder: string, options: any): Promise<void>;

package/dist/commands/scan.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scan = scan;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../config");
+const i18n_1 = require("../i18n");
+const DEFAULT_EXCLUDES = ['node_modules', '.next', '.git', 'dist', 'build', 'public'];
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.vue', '.svelte'];
+// JS methods commonly chained after translation keys
+const EXCLUDED_METHODS = ['replace', 'split', 'toUpperCase', 'toLowerCase', 'trim', 'map', 'filter', 'join', 'toString'];
+async function scan(folder, options) {
+    const config = (0, config_1.readConfig)();
+    const rootDir = path_1.default.resolve(folder);
+    const dictionaryPath = path_1.default.resolve(options.dictionary || config.dictionary || './dictionaries/en.json');
+    console.log(chalk_1.default.bold.cyan(`\n ${(0, i18n_1.t)('cli.scan.title')}`));
+    console.log(chalk_1.default.gray(' ----------------------------------------'));
+    console.log(`${chalk_1.default.yellow(' 📁 Scanning:')}     ${rootDir}`);
+    console.log(`${chalk_1.default.yellow(' 📖 Dictionary:')}   ${dictionaryPath}`);
+    if (!fs_1.default.existsSync(dictionaryPath)) {
+        console.error(chalk_1.default.red(`\n ❌ Dictionary file not found at: ${dictionaryPath}`));
+        return;
+    }
+    const spinner = (0, ora_1.default)({
+        text: chalk_1.default.cyan((0, i18n_1.t)('cli.scan.scanning')),
+        color: 'cyan'
+    }).start();
+    const foundKeys = new Set();
+    let fileCount = 0;
+    function walk(currentDir) {
+        const files = fs_1.default.readdirSync(currentDir);
+        for (const file of files) {
+            const fullPath = path_1.default.join(currentDir, file);
+            const stat = fs_1.default.statSync(fullPath);
+            if (stat.isDirectory()) {
+                if (!DEFAULT_EXCLUDES.includes(file)) {
+                    walk(fullPath);
+                }
+            }
+            else {
+                const ext = path_1.default.extname(file);
+                if (DEFAULT_EXTENSIONS.includes(ext)) {
+                    // Skip scanning the scanner itself to avoid false positives from regex definitions
+                    if (file === 'scan.ts')
+                        continue;
+                    fileCount++;
+                    const content = fs_1.default.readFileSync(fullPath, 'utf8');
+                    // --- Namespace detection ---
+                    // Use string splitting to avoid self-matching during scan
+                    // Supports both useTranslations('...') and getTranslations({ namespace: '...' })
+                    // and also getTranslations({ locale: '...', namespace: '...' })
+                    const nsRegex = new RegExp('(?:use|get)' + 'Translations\\((?:[\'"`](.+?)[\'"`]|\\{[^}]*?namespace:\\s*[\'"`](.+?)[\'"`])', 'g');
+                    let nsMatch;
+                    let namespace = null;
+                    if ((nsMatch = nsRegex.exec(content)) !== null) {
+                        namespace = nsMatch[1] || nsMatch[2];
+                    }
+                    // Rule 1: t('...') or i18n.t('...')
+                    // Use string splitting to avoid self-matching during scan
+                    const tRegex = new RegExp('\\b(?:t|i18n\\.t)\\(\\s*[\'"`](.+?)[\'"`]\\s*[\\),]', 'g');
+                    let match;
+                    while ((match = tRegex.exec(content)) !== null) {
+                        // Avoid capturing variables like ${id} and internal scanner strings
+                        if (match[1] && !match[1].includes('${') && !match[1].includes('(.+?)')) {
+                            const fullKey = namespace ? `${namespace}.${match[1]}` : match[1];
+                            foundKeys.add(fullKey);
+                        }
+                    }
+                    // Rule 2: dict.a.b.c
+                    const dRegex = new RegExp('\\b' + 'dict(?:\\.[a-zA-Z0-9_$]+){1,}', 'g');
+                    while ((match = dRegex.exec(content)) !== null) {
+                        let fullKey = match[0].replace('dict.', '');
+                        const parts = fullKey.split('.');
+                        // If the last part is a common JS method, remove it
+                        if (parts.length > 1 && EXCLUDED_METHODS.includes(parts[parts.length - 1])) {
+                            parts.pop();
+                            fullKey = parts.join('.');
+                        }
+                        if (fullKey !== 'dict' && fullKey !== '') {
+                            foundKeys.add(fullKey);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    try {
+        walk(rootDir);
+        spinner.succeed((0, i18n_1.t)('cli.scan.scanned', { n: fileCount.toString() }));
+        // Load existing keys from dictionary
+        const dictContent = fs_1.default.readFileSync(dictionaryPath, 'utf8');
+        const dictJson = JSON.parse(dictContent);
+        const existingKeys = new Set();
+        function collectKeys(obj, prefix = '') {
+            if (typeof obj !== 'object' || obj === null)
+                return;
+            for (const key in obj) {
+                const fullKey = prefix ? `${prefix}.${key}` : key;
+                existingKeys.add(fullKey);
+                if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
+                    collectKeys(obj[key], fullKey);
+                }
+            }
+        }
+        collectKeys(dictJson);
+        const missingKeys = Array.from(foundKeys).filter(k => !existingKeys.has(k));
+        const orphanedKeys = Array.from(existingKeys).filter(k => !foundKeys.has(k));
+        console.log(chalk_1.default.gray(' ----------------------------------------'));
+        console.log(`${chalk_1.default.blue(' 🔑 Total unique keys in code:')} ${foundKeys.size}`);
+        console.log(`${chalk_1.default.blue(' 📖 Total unique keys in dict:')} ${existingKeys.size}`);
+        if (missingKeys.length > 0) {
+            // Filter out obvious false positives
+            const filteredMissing = missingKeys.filter(k => {
+                if (k.length <= 1)
+                    return false;
+                if (/^[0-9]+$/.test(k))
+                    return false;
+                if (['props', 'state', 'params', 'query', 'data', 'a.b.c'].includes(k))
+                    return false;
+                if (k.includes('(.+?)'))
+                    return false; // Regex artifacts
+                return true;
+            });
+            if (filteredMissing.length > 0) {
+                console.log(chalk_1.default.bold.yellow(`\n ⚠️  ${(0, i18n_1.t)('cli.scan.missing_found', { n: filteredMissing.length.toString() })}`));
+                filteredMissing.sort().forEach(k => console.log(`   ${chalk_1.default.red('+')} ${k}`));
+                console.log(chalk_1.default.gray(`\n Total missing: ${filteredMissing.length}`));
+            }
+            else {
+                console.log(chalk_1.default.bold.green(`\n ${(0, i18n_1.t)('cli.scan.all_present')}`));
+            }
+        }
+        else {
+            console.log(chalk_1.default.bold.green(`\n ${(0, i18n_1.t)('cli.scan.all_present')}`));
+        }
+        if (options.unused && orphanedKeys.length > 0) {
+            console.log(chalk_1.default.bold.magenta(`\n 🗑️  Found ${orphanedKeys.length} potentially unused keys (in dict but NOT in code):`));
+            orphanedKeys.sort().forEach(k => console.log(`   ${chalk_1.default.gray('-')} ${k}`));
+        }
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Scan failed.'));
+        console.error(`\n ${chalk_1.default.red('Error:')} ${error.message}\n`);
+    }
+}

package/dist/commands/status.d.ts

@@ -0,0 +1 @@
+export declare function status(options: any): Promise<void>;