translomatic-cli 1.0.0

package/dist/commands/translate.js

@@ -0,0 +1,58 @@
+import { loadConfig } from "../config.js";
+import { translateProject } from "../translator.js";
+import { Logger } from "../logger.js";
+/**
+ * `translomatic translate` command
+ *
+ * Translates all missing strings in the project.
+ * Reads source language file, finds missing keys in each target language,
+ * and batch-translates them using the Translomatic API.
+ */
+export async function translateCommand(projectDir, options) {
+    const logger = new Logger(options.verbose);
+    logger.banner();
+    logger.section("Translating Project");
+    // Load config
+    const config = await loadConfig(projectDir);
+    logger.info(`Source language: ${config.sourceLang}`);
+    const targetLangs = options.lang
+        ? options.lang.split(",").map((l) => l.trim())
+        : config.targetLangs;
+    logger.info(`Target languages: ${targetLangs.join(", ")}`);
+    if (config.model) {
+        logger.info(`Model: ${config.model}`);
+    }
+    if (config.context) {
+        logger.info(`Context: ${config.context.slice(0, 60)}${config.context.length > 60 ? "..." : ""}`);
+    }
+    if (options.force) {
+        logger.warn("Force mode: re-translating all strings");
+    }
+    if (options.dryRun) {
+        logger.warn("Dry run: no files will be written");
+    }
+    const translateOpts = {
+        force: options.force,
+        langs: targetLangs,
+        namespaces: options.namespace
+            ? options.namespace.split(",").map((n) => n.trim())
+            : undefined,
+        dryRun: options.dryRun,
+    };
+    try {
+        const result = await translateProject(projectDir, config, translateOpts, logger);
+        if (result.totalTranslated > 0 || result.totalSkipped > 0) {
+            logger.summary(result.totalLangs, result.totalTranslated + result.totalSkipped, result.totalTranslated, result.totalTimeMs);
+        }
+        else {
+            logger.section("Result");
+            logger.success("All strings are already translated!");
+            console.log();
+        }
+    }
+    catch (err) {
+        logger.error(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=translate.js.map

package/dist/commands/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../src/commands/translate.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+import type { CLIConfig } from "./types.js";
+/**
+ * Load config from .translomaticrc.json in the given directory.
+ * Falls back to defaults if not found.
+ */
+export declare function loadConfig(dir: string): Promise<CLIConfig>;
+/**
+ * Save config to .translomaticrc.json.
+ */
+export declare function saveConfig(dir: string, config: CLIConfig): Promise<string>;
+/**
+ * Check if config file exists.
+ */
+export declare function configExists(dir: string): Promise<boolean>;
+/**
+ * Resolve API key from config or environment variable.
+ */
+export declare function resolveApiKey(config: CLIConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAY5C;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAchE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAKhF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAQvD"}

package/dist/config.js

@@ -0,0 +1,59 @@
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+const CONFIG_FILENAME = ".translomaticrc.json";
+const DEFAULT_CONFIG = {
+    sourceLang: "en",
+    targetLangs: [],
+    localesDir: "./locales",
+    fileFormat: "nested-json",
+    filePattern: "{lang}.json",
+};
+/**
+ * Load config from .translomaticrc.json in the given directory.
+ * Falls back to defaults if not found.
+ */
+export async function loadConfig(dir) {
+    const configPath = join(dir, CONFIG_FILENAME);
+    try {
+        await access(configPath);
+        const raw = await readFile(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        throw new Error(`Config file not found: ${configPath}\n` +
+            `Run "translomatic init" to create one.`);
+    }
+}
+/**
+ * Save config to .translomaticrc.json.
+ */
+export async function saveConfig(dir, config) {
+    const configPath = join(dir, CONFIG_FILENAME);
+    const content = JSON.stringify(config, null, 2) + "\n";
+    await writeFile(configPath, content, "utf-8");
+    return configPath;
+}
+/**
+ * Check if config file exists.
+ */
+export async function configExists(dir) {
+    try {
+        await access(join(dir, CONFIG_FILENAME));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve API key from config or environment variable.
+ */
+export function resolveApiKey(config) {
+    const key = config.apiKey || process.env.TRANSLOMATIC_API_KEY;
+    if (!key) {
+        throw new Error("API key not found. Set it in .translomaticrc.json or TRANSLOMATIC_API_KEY env var.");
+    }
+    return key;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,MAAM,cAAc,GAAc;IAChC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,IAAI;YACtC,wCAAwC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,MAAiB;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC9D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { initCommand } from "./commands/init.js";
+import { translateCommand } from "./commands/translate.js";
+import { analyzeCommand } from "./commands/analyze.js";
+import { statusCommand } from "./commands/status.js";
+const program = new Command();
+program
+    .name("translomatic")
+    .description("Auto-scan and translate your entire project using Translomatic API")
+    .version("1.0.0");
+// ─── init ──────────────────────────────────────────────
+program
+    .command("init")
+    .description("Scan project and create .translomaticrc.json config")
+    .option("-f, --force", "Overwrite existing config file")
+    .action(async (options) => {
+    await initCommand(process.cwd(), options);
+});
+// ─── translate ─────────────────────────────────────────
+program
+    .command("translate")
+    .description("Translate all missing strings in the project")
+    .option("--force", "Re-translate all strings (ignore existing translations)")
+    .option("-l, --lang <langs>", "Only translate specific languages (comma-separated)")
+    .option("-n, --namespace <ns>", "Only translate specific namespaces (comma-separated)")
+    .option("--dry-run", "Show what would be translated without making changes")
+    .option("-v, --verbose", "Show detailed output")
+    .action(async (options) => {
+    await translateCommand(process.cwd(), options);
+});
+// ─── analyze ───────────────────────────────────────────
+program
+    .command("analyze")
+    .description("Auto-analyze project context for smarter translations")
+    .option("-v, --verbose", "Show detailed output")
+    .action(async (options) => {
+    await analyzeCommand(process.cwd(), options);
+});
+// ─── status ────────────────────────────────────────────
+program
+    .command("status")
+    .description("Show translation coverage for all target languages")
+    .option("-v, --verbose", "Show namespace-level details")
+    .action(async (options) => {
+    await statusCommand(process.cwd(), options);
+});
+// ─── Run ───────────────────────────────────────────────
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,0DAA0D;AAE1D,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEL,0DAA0D;AAE1D,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,SAAS,EAAE,yDAAyD,CAAC;KAC5E,MAAM,CAAC,oBAAoB,EAAE,qDAAqD,CAAC;KACnF,MAAM,CAAC,sBAAsB,EAAE,sDAAsD,CAAC;KACtF,MAAM,CAAC,WAAW,EAAE,sDAAsD,CAAC;KAC3E,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEL,0DAA0D;AAE1D,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,0DAA0D;AAE1D,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,eAAe,EAAE,8BAA8B,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEL,0DAA0D;AAE1D,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,25 @@
+import type { TranslationProgress } from "./types.js";
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    banner(): void;
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+    section(title: string): void;
+    langStart(lang: string, total: number): void;
+    langComplete(lang: string, translated: number, skipped: number, failed: number, timeMs: number): void;
+    batchProgress(progress: TranslationProgress): void;
+    clearLine(): void;
+    private progressBar;
+    statusTable(rows: Array<{
+        lang: string;
+        coverage: number;
+        translated: number;
+        total: number;
+    }>): void;
+    summary(totalLangs: number, totalStrings: number, totalTranslated: number, totalTimeMs: number): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAM3B,MAAM,IAAI,IAAI;IAwBd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQxB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAerG,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAYlD,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,WAAW;IAUnB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAmCrG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAiBtG"}

package/dist/logger.js

@@ -0,0 +1,122 @@
+import chalk from "chalk";
+const LOGO = "translomatic";
+export class Logger {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    // ─── Branding ────────────────────────────────────────────
+    banner() {
+        console.log();
+        console.log(chalk.bold.cyan("  ╔══════════════════════════════════════╗"));
+        console.log(chalk.bold.cyan("  ║") +
+            chalk.bold.white("   Translomatic CLI  ") +
+            chalk.dim("v1.0.0") +
+            chalk.bold.cyan("        ║"));
+        console.log(chalk.bold.cyan("  ║") +
+            chalk.dim("   Auto-translate your entire project ") +
+            chalk.bold.cyan("║"));
+        console.log(chalk.bold.cyan("  ╚══════════════════════════════════════╝"));
+        console.log();
+    }
+    // ─── Status Messages ────────────────────────────────────
+    info(msg) {
+        console.log(chalk.blue("  ℹ ") + msg);
+    }
+    success(msg) {
+        console.log(chalk.green("  ✓ ") + msg);
+    }
+    warn(msg) {
+        console.log(chalk.yellow("  ⚠ ") + msg);
+    }
+    error(msg) {
+        console.log(chalk.red("  ✗ ") + msg);
+    }
+    debug(msg) {
+        if (this.verbose) {
+            console.log(chalk.gray("  · ") + chalk.gray(msg));
+        }
+    }
+    // ─── Section Headers ────────────────────────────────────
+    section(title) {
+        console.log();
+        console.log(chalk.bold.white(`  ${title}`));
+        console.log(chalk.dim("  " + "─".repeat(40)));
+    }
+    // ─── Translation Progress ──────────────────────────────
+    langStart(lang, total) {
+        console.log();
+        console.log(chalk.bold.cyan(`  ▸ `) +
+            chalk.bold(`Translating → ${lang}`) +
+            chalk.dim(` (${total} strings)`));
+    }
+    langComplete(lang, translated, skipped, failed, timeMs) {
+        const parts = [];
+        if (translated > 0)
+            parts.push(chalk.green(`${translated} translated`));
+        if (skipped > 0)
+            parts.push(chalk.dim(`${skipped} skipped`));
+        if (failed > 0)
+            parts.push(chalk.red(`${failed} failed`));
+        const time = timeMs < 1000 ? `${timeMs}ms` : `${(timeMs / 1000).toFixed(1)}s`;
+        console.log(chalk.green("  ✓ ") +
+            chalk.bold(lang) +
+            chalk.dim(" — ") +
+            parts.join(chalk.dim(", ")) +
+            chalk.dim(` (${time})`));
+    }
+    batchProgress(progress) {
+        const pct = Math.round((progress.translated / progress.total) * 100);
+        const bar = this.progressBar(pct, 20);
+        process.stdout.write(`\r  ${bar} ${chalk.bold(`${pct}%`)} ` +
+            chalk.dim(`(${progress.translated}/${progress.total}) ` +
+                `batch ${progress.currentBatch}/${progress.totalBatches}`));
+    }
+    clearLine() {
+        process.stdout.write("\r" + " ".repeat(80) + "\r");
+    }
+    progressBar(pct, width) {
+        const filled = Math.round((pct / 100) * width);
+        const empty = width - filled;
+        return (chalk.cyan("█".repeat(filled)) + chalk.gray("░".repeat(empty)));
+    }
+    // ─── Status Table ──────────────────────────────────────
+    statusTable(rows) {
+        const maxLang = Math.max(4, ...rows.map((r) => r.lang.length));
+        console.log(chalk.dim("  ") +
+            chalk.bold("Lang".padEnd(maxLang + 2)) +
+            chalk.bold("Coverage".padEnd(12)) +
+            chalk.bold("Translated".padEnd(14)) +
+            chalk.bold("Missing"));
+        console.log(chalk.dim("  " + "─".repeat(maxLang + 2 + 12 + 14 + 10)));
+        for (const row of rows) {
+            const missing = row.total - row.translated;
+            const coverageStr = `${row.coverage}%`;
+            const coverageColor = row.coverage === 100
+                ? chalk.green
+                : row.coverage >= 80
+                    ? chalk.yellow
+                    : chalk.red;
+            const bar = this.progressBar(row.coverage, 10);
+            console.log(chalk.dim("  ") +
+                chalk.bold(row.lang.padEnd(maxLang + 2)) +
+                `${bar} ${coverageColor(coverageStr.padEnd(5))}  ` +
+                chalk.dim(`${row.translated}/${row.total}`).padEnd(22) +
+                (missing > 0 ? chalk.red(`${missing}`) : chalk.green("0")));
+        }
+    }
+    // ─── Summary ───────────────────────────────────────────
+    summary(totalLangs, totalStrings, totalTranslated, totalTimeMs) {
+        console.log();
+        console.log(chalk.dim("  " + "═".repeat(40)));
+        const time = totalTimeMs < 1000
+            ? `${totalTimeMs}ms`
+            : `${(totalTimeMs / 1000).toFixed(1)}s`;
+        console.log(chalk.bold.green("  ✓ Translation complete!") +
+            chalk.dim(` (${time})`));
+        console.log(chalk.dim("    ") +
+            `${totalLangs} languages, ${totalTranslated} strings translated`);
+        console.log();
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/scanner/detector.d.ts

@@ -0,0 +1,6 @@
+import type { FrameworkInfo } from "../types.js";
+/**
+ * Scan a project directory to detect i18n framework and locale files.
+ */
+export declare function detectFramework(projectDir: string): Promise<FrameworkInfo | null>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/scanner/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/scanner/detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwIjD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsBvF"}

package/dist/scanner/detector.js

@@ -0,0 +1,236 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+const FRAMEWORKS = [
+    {
+        name: "react-i18next",
+        displayName: "react-i18next",
+        deps: ["react-i18next", "i18next"],
+        localeDirs: ["locales", "src/locales", "public/locales", "src/i18n/locales"],
+        filePattern: "{lang}/{namespace}.json",
+        usesNamespaces: true,
+    },
+    {
+        name: "next-intl",
+        displayName: "next-intl",
+        deps: ["next-intl"],
+        localeDirs: ["messages", "src/messages", "locales", "src/locales"],
+        filePattern: "{lang}.json",
+        usesNamespaces: false,
+    },
+    {
+        name: "vue-i18n",
+        displayName: "vue-i18n",
+        deps: ["vue-i18n", "@intlify/vue-i18n"],
+        localeDirs: ["locales", "src/locales", "src/i18n", "src/lang"],
+        filePattern: "{lang}.json",
+        usesNamespaces: false,
+    },
+    {
+        name: "angular-i18n",
+        displayName: "Angular i18n",
+        deps: ["@angular/localize", "@ngx-translate/core"],
+        localeDirs: ["src/assets/i18n", "src/locale", "src/i18n"],
+        filePattern: "{lang}.json",
+        usesNamespaces: false,
+    },
+    {
+        name: "svelte-i18n",
+        displayName: "svelte-i18n",
+        deps: ["svelte-i18n", "svelte-intl-precompile"],
+        localeDirs: ["src/lib/i18n", "src/locales", "locales", "messages"],
+        filePattern: "{lang}.json",
+        usesNamespaces: false,
+    },
+    {
+        name: "i18next",
+        displayName: "i18next (generic)",
+        deps: ["i18next"],
+        localeDirs: ["locales", "src/locales", "public/locales", "i18n", "lang"],
+        filePattern: "{lang}.json",
+        usesNamespaces: false,
+    },
+];
+/**
+ * Common locale directory names to scan when no framework is detected.
+ */
+const COMMON_LOCALE_DIRS = [
+    "locales",
+    "locale",
+    "lang",
+    "languages",
+    "i18n",
+    "translations",
+    "messages",
+    "src/locales",
+    "src/locale",
+    "src/lang",
+    "src/i18n",
+    "src/translations",
+    "src/messages",
+    "public/locales",
+    "public/lang",
+    "assets/i18n",
+    "src/assets/i18n",
+];
+/**
+ * ISO 639-1 language codes (common ones for quick detection).
+ */
+const LANG_CODES = new Set([
+    "aa", "ab", "af", "ak", "am", "an", "ar", "as", "av", "ay", "az",
+    "ba", "be", "bg", "bh", "bi", "bm", "bn", "bo", "br", "bs",
+    "ca", "ce", "ch", "co", "cr", "cs", "cu", "cv", "cy",
+    "da", "de", "dv", "dz",
+    "ee", "el", "en", "eo", "es", "et", "eu",
+    "fa", "ff", "fi", "fj", "fo", "fr", "fy",
+    "ga", "gd", "gl", "gn", "gu", "gv",
+    "ha", "he", "hi", "ho", "hr", "ht", "hu", "hy", "hz",
+    "ia", "id", "ie", "ig", "ii", "ik", "io", "is", "it", "iu",
+    "ja", "jv",
+    "ka", "kg", "ki", "kj", "kk", "kl", "km", "kn", "ko", "kr", "ks", "ku", "kv", "kw", "ky",
+    "la", "lb", "lg", "li", "ln", "lo", "lt", "lu", "lv",
+    "mg", "mh", "mi", "mk", "ml", "mn", "mr", "ms", "mt", "my",
+    "na", "nb", "nd", "ne", "ng", "nl", "nn", "no", "nr", "nv", "ny",
+    "oc", "oj", "om", "or", "os",
+    "pa", "pi", "pl", "ps", "pt",
+    "qu",
+    "rm", "rn", "ro", "ru", "rw",
+    "sa", "sc", "sd", "se", "sg", "si", "sk", "sl", "sm", "sn", "so", "sq", "sr", "ss", "st", "su", "sv", "sw",
+    "ta", "te", "tg", "th", "ti", "tk", "tl", "tn", "to", "tr", "ts", "tt", "tw", "ty",
+    "ug", "uk", "ur", "uz",
+    "ve", "vi", "vo",
+    "wa", "wo",
+    "xh",
+    "yi", "yo",
+    "za", "zh", "zu",
+]);
+/**
+ * Also support locale codes like "en-US", "zh-CN", "pt-BR"
+ */
+function isLangCode(name) {
+    const lower = name.toLowerCase();
+    if (LANG_CODES.has(lower))
+        return true;
+    // Match patterns like en-US, zh-CN, pt-BR
+    const match = lower.match(/^([a-z]{2})[-_]([a-z]{2,4})$/);
+    if (match && LANG_CODES.has(match[1]))
+        return true;
+    return false;
+}
+/**
+ * Scan a project directory to detect i18n framework and locale files.
+ */
+export async function detectFramework(projectDir) {
+    // Step 1: Read package.json to find framework deps
+    const detectedFramework = await detectFromPackageJson(projectDir);
+    // Step 2: Scan for locale directories
+    const localeDir = await findLocaleDir(projectDir, detectedFramework);
+    if (!localeDir)
+        return null;
+    // Step 3: Analyze locale directory structure
+    const analysis = await analyzeLocaleDir(join(projectDir, localeDir));
+    if (!analysis)
+        return null;
+    return {
+        name: detectedFramework?.name || "generic",
+        displayName: detectedFramework?.displayName || "Generic JSON i18n",
+        localesDir: localeDir,
+        filePattern: analysis.filePattern,
+        sourceLang: analysis.sourceLang,
+        existingLangs: analysis.langs,
+        namespaces: analysis.namespaces,
+        confidence: detectedFramework ? 0.9 : 0.6,
+    };
+}
+async function detectFromPackageJson(projectDir) {
+    try {
+        const pkgPath = join(projectDir, "package.json");
+        const pkgRaw = await readFile(pkgPath, "utf-8");
+        const pkg = JSON.parse(pkgRaw);
+        const allDeps = {
+            ...(pkg.dependencies || {}),
+            ...(pkg.devDependencies || {}),
+        };
+        for (const fw of FRAMEWORKS) {
+            if (fw.deps.some((dep) => dep in allDeps)) {
+                return fw;
+            }
+        }
+    }
+    catch {
+        // No package.json or invalid
+    }
+    return null;
+}
+async function findLocaleDir(projectDir, framework) {
+    // Check framework-specific dirs first
+    const dirsToCheck = framework
+        ? [...framework.localeDirs, ...COMMON_LOCALE_DIRS]
+        : COMMON_LOCALE_DIRS;
+    // Deduplicate
+    const unique = [...new Set(dirsToCheck)];
+    for (const dir of unique) {
+        const fullPath = join(projectDir, dir);
+        try {
+            const s = await stat(fullPath);
+            if (s.isDirectory()) {
+                // Verify it contains lang files or lang subdirectories
+                const entries = await readdir(fullPath, { withFileTypes: true });
+                const hasLangFiles = entries.some((e) => (e.isFile() && e.name.endsWith(".json") && isLangCode(e.name.replace(".json", ""))) ||
+                    (e.isDirectory() && isLangCode(e.name)));
+                if (hasLangFiles)
+                    return dir;
+            }
+        }
+        catch {
+            // Dir doesn't exist
+        }
+    }
+    return null;
+}
+async function analyzeLocaleDir(localeFullPath) {
+    const entries = await readdir(localeFullPath, { withFileTypes: true });
+    // Pattern 1: {lang}.json files (e.g., en.json, vi.json)
+    const jsonFiles = entries.filter((e) => e.isFile() && e.name.endsWith(".json"));
+    const langFiles = jsonFiles.filter((e) => isLangCode(e.name.replace(".json", "")));
+    if (langFiles.length > 0) {
+        const langs = langFiles.map((e) => e.name.replace(".json", ""));
+        const sourceLang = langs.includes("en") ? "en" : langs[0];
+        return {
+            filePattern: "{lang}.json",
+            sourceLang,
+            langs,
+        };
+    }
+    // Pattern 2: {lang}/ subdirectories with namespace files
+    const langDirs = entries.filter((e) => e.isDirectory() && isLangCode(e.name));
+    if (langDirs.length > 0) {
+        const langs = langDirs.map((e) => e.name);
+        const sourceLang = langs.includes("en") ? "en" : langs[0];
+        // Check first lang dir for namespace files
+        const firstLangDir = join(localeFullPath, sourceLang || langs[0]);
+        try {
+            const nsEntries = await readdir(firstLangDir, { withFileTypes: true });
+            const nsFiles = nsEntries.filter((e) => e.isFile() && e.name.endsWith(".json"));
+            if (nsFiles.length > 0) {
+                const namespaces = nsFiles.map((e) => e.name.replace(".json", ""));
+                return {
+                    filePattern: "{lang}/{namespace}.json",
+                    sourceLang,
+                    langs,
+                    namespaces,
+                };
+            }
+        }
+        catch {
+            // Can't read lang subdirectory
+        }
+        return {
+            filePattern: "{lang}/{namespace}.json",
+            sourceLang,
+            langs,
+            namespaces: ["translation"],
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=detector.js.map

package/dist/scanner/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/scanner/detector.ts"],"names":[],"mappings":"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"}