translomatic-cli 1.0.0

package/dist/scanner/extractor.d.ts

@@ -0,0 +1,43 @@
+import type { FlatMap } from "../types.js";
+/**
+ * Flatten a nested JSON object into dotted-key format.
+ *
+ * Example:
+ *   { common: { save: "Save", buttons: { ok: "OK" } } }
+ *   → { "common.save": "Save", "common.buttons.ok": "OK" }
+ */
+export declare function flattenJson(obj: Record<string, unknown>, prefix?: string): FlatMap;
+/**
+ * Unflatten a dotted-key map back into nested JSON.
+ *
+ * Example:
+ *   { "common.save": "Save", "common.buttons.ok": "OK" }
+ *   → { common: { save: "Save", buttons: { ok: "OK" } } }
+ */
+export declare function unflattenJson(flat: FlatMap): Record<string, unknown>;
+/**
+ * Read a JSON locale file and return flattened key-value pairs.
+ */
+export declare function readLocaleFile(filePath: string): Promise<FlatMap>;
+/**
+ * Write a flattened key-value map back to a JSON file.
+ * Preserves nested structure.
+ */
+export declare function writeLocaleFile(filePath: string, flatData: FlatMap, nested?: boolean): Promise<void>;
+/**
+ * Resolve locale file path from pattern.
+ *
+ * Patterns:
+ *   "{lang}.json"                → "locales/vi.json"
+ *   "{lang}/{namespace}.json"    → "locales/vi/common.json"
+ */
+export declare function resolveLocalePath(localesDir: string, pattern: string, lang: string, namespace?: string): string;
+/**
+ * Find missing keys: keys in source that are not in target.
+ */
+export declare function findMissingKeys(source: FlatMap, target: FlatMap): FlatMap;
+/**
+ * Merge translations into existing target, preserving existing entries.
+ */
+export declare function mergeTranslations(existing: FlatMap, newTranslations: FlatMap): FlatMap;
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/scanner/extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,SAAK,GACV,OAAO,CAmBT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBpE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAavE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,MAAM,GAAE,OAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAQzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,OAAO,GACvB,OAAO,CAET"}

package/dist/scanner/extractor.js

@@ -0,0 +1,107 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+/**
+ * Flatten a nested JSON object into dotted-key format.
+ *
+ * Example:
+ *   { common: { save: "Save", buttons: { ok: "OK" } } }
+ *   → { "common.save": "Save", "common.buttons.ok": "OK" }
+ */
+export function flattenJson(obj, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "string") {
+            result[fullKey] = value;
+        }
+        else if (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value)) {
+            Object.assign(result, flattenJson(value, fullKey));
+        }
+        // Skip arrays, numbers, booleans, null
+    }
+    return result;
+}
+/**
+ * Unflatten a dotted-key map back into nested JSON.
+ *
+ * Example:
+ *   { "common.save": "Save", "common.buttons.ok": "OK" }
+ *   → { common: { save: "Save", buttons: { ok: "OK" } } }
+ */
+export function unflattenJson(flat) {
+    const result = {};
+    for (const [dottedKey, value] of Object.entries(flat)) {
+        const parts = dottedKey.split(".");
+        let current = result;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (!(part in current) || typeof current[part] !== "object") {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+        current[parts[parts.length - 1]] = value;
+    }
+    return result;
+}
+/**
+ * Read a JSON locale file and return flattened key-value pairs.
+ */
+export async function readLocaleFile(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        return flattenJson(parsed);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write a flattened key-value map back to a JSON file.
+ * Preserves nested structure.
+ */
+export async function writeLocaleFile(filePath, flatData, nested = true) {
+    // Ensure directory exists
+    await mkdir(dirname(filePath), { recursive: true });
+    const data = nested ? unflattenJson(flatData) : flatData;
+    const content = JSON.stringify(data, null, 2) + "\n";
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Resolve locale file path from pattern.
+ *
+ * Patterns:
+ *   "{lang}.json"                → "locales/vi.json"
+ *   "{lang}/{namespace}.json"    → "locales/vi/common.json"
+ */
+export function resolveLocalePath(localesDir, pattern, lang, namespace) {
+    let path = pattern
+        .replace("{lang}", lang)
+        .replace("{namespace}", namespace || "translation");
+    return join(localesDir, path);
+}
+/**
+ * Find missing keys: keys in source that are not in target.
+ */
+export function findMissingKeys(source, target) {
+    const missing = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (!(key in target) || target[key] === "") {
+            missing[key] = value;
+        }
+    }
+    return missing;
+}
+/**
+ * Merge translations into existing target, preserving existing entries.
+ */
+export function mergeTranslations(existing, newTranslations) {
+    return { ...existing, ...newTranslations };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/scanner/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/scanner/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,MAAM,GAAG,EAAE;IAEX,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAElD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;aAAM,IACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACrB,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAgC,EAAE,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,uCAAuC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,GAA4B,MAAM,CAAC;QAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;QACrD,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,WAAW,CAAC,MAAiC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,QAAiB,EACjB,SAAkB,IAAI;IAEtB,0BAA0B;IAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,OAAe,EACf,IAAY,EACZ,SAAkB;IAElB,IAAI,IAAI,GAAG,OAAO;SACf,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,OAAO,CAAC,aAAa,EAAE,SAAS,IAAI,aAAa,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,MAAe;IAC9D,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB,EACjB,eAAwB;IAExB,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,eAAe,EAAE,CAAC;AAC7C,CAAC"}

package/dist/translator.d.ts

@@ -0,0 +1,34 @@
+import type { CLIConfig } from "./types.js";
+import { Logger } from "./logger.js";
+export interface TranslateOptions {
+    /** Force re-translate all strings (ignore existing) */
+    force?: boolean;
+    /** Only translate specific languages */
+    langs?: string[];
+    /** Only translate specific namespaces */
+    namespaces?: string[];
+    /** Dry run - show what would be translated without doing it */
+    dryRun?: boolean;
+}
+export interface TranslateResult {
+    totalLangs: number;
+    totalTranslated: number;
+    totalSkipped: number;
+    totalFailed: number;
+    totalTimeMs: number;
+    langResults: LangResult[];
+}
+interface LangResult {
+    lang: string;
+    translated: number;
+    skipped: number;
+    failed: number;
+    timeMs: number;
+}
+/**
+ * Main translation orchestrator.
+ * Reads source locale files, translates missing strings, writes target files.
+ */
+export declare function translateProject(projectDir: string, config: CLIConfig, options: TranslateOptions, logger: Logger): Promise<TranslateResult>;
+export {};
+//# sourceMappingURL=translator.d.ts.map

package/dist/translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../src/translator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAgC,MAAM,YAAY,CAAC;AAS1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAqK1B"}

package/dist/translator.js

@@ -0,0 +1,138 @@
+import { Translomatic } from "translomatic";
+import { resolveApiKey } from "./config.js";
+import { readLocaleFile, writeLocaleFile, resolveLocalePath, findMissingKeys, mergeTranslations, } from "./scanner/extractor.js";
+const BATCH_SIZE = 50; // Max batch size for Translomatic API
+/**
+ * Main translation orchestrator.
+ * Reads source locale files, translates missing strings, writes target files.
+ */
+export async function translateProject(projectDir, config, options, logger) {
+    let client = null;
+    if (!options.dryRun) {
+        const apiKey = resolveApiKey(config);
+        client = new Translomatic({
+            apiKey,
+            defaultModel: config.model || undefined,
+            defaultContext: config.context || undefined,
+        });
+    }
+    const targetLangs = options.langs || config.targetLangs;
+    if (targetLangs.length === 0) {
+        throw new Error("No target languages configured. Update .translomaticrc.json targetLangs.");
+    }
+    const namespaces = options.namespaces || config.namespaces || [undefined];
+    const hasNamespaces = config.filePattern.includes("{namespace}");
+    const overallStart = Date.now();
+    const langResults = [];
+    let totalTranslated = 0;
+    let totalSkipped = 0;
+    let totalFailed = 0;
+    for (const lang of targetLangs) {
+        if (lang === config.sourceLang)
+            continue;
+        const langStart = Date.now();
+        let langTranslated = 0;
+        let langSkipped = 0;
+        let langFailed = 0;
+        // Count total strings for this language
+        let totalStringsForLang = 0;
+        const nsFiles = [];
+        const nsToProcess = hasNamespaces ? namespaces.filter(Boolean) : [undefined];
+        for (const ns of nsToProcess) {
+            const sourcePath = resolveLocalePath(`${projectDir}/${config.localesDir}`, config.filePattern, config.sourceLang, ns);
+            const targetPath = resolveLocalePath(`${projectDir}/${config.localesDir}`, config.filePattern, lang, ns);
+            const sourceMap = await readLocaleFile(sourcePath);
+            totalStringsForLang += Object.keys(sourceMap).length;
+            nsFiles.push({ ns, sourcePath, targetPath });
+        }
+        logger.langStart(lang, totalStringsForLang);
+        for (const { ns, sourcePath, targetPath } of nsFiles) {
+            const sourceMap = await readLocaleFile(sourcePath);
+            if (Object.keys(sourceMap).length === 0) {
+                logger.debug(`Skipping empty source: ${sourcePath}`);
+                continue;
+            }
+            const existingTarget = options.force ? {} : await readLocaleFile(targetPath);
+            const missing = options.force ? sourceMap : findMissingKeys(sourceMap, existingTarget);
+            const skipped = Object.keys(sourceMap).length - Object.keys(missing).length;
+            langSkipped += skipped;
+            if (Object.keys(missing).length === 0) {
+                logger.debug(`${ns ? `[${ns}] ` : ""}All strings already translated`);
+                continue;
+            }
+            if (options.dryRun) {
+                logger.info(`${ns ? `[${ns}] ` : ""}Would translate ${Object.keys(missing).length} strings → ${lang}`);
+                langTranslated += Object.keys(missing).length;
+                continue;
+            }
+            // Translate in batches
+            const keys = Object.keys(missing);
+            const values = Object.values(missing);
+            const totalBatches = Math.ceil(values.length / BATCH_SIZE);
+            const translatedMap = {};
+            for (let i = 0; i < values.length; i += BATCH_SIZE) {
+                const batchKeys = keys.slice(i, i + BATCH_SIZE);
+                const batchValues = values.slice(i, i + BATCH_SIZE);
+                const batchNum = Math.floor(i / BATCH_SIZE) + 1;
+                const progress = {
+                    lang,
+                    namespace: ns,
+                    translated: langTranslated + Object.keys(translatedMap).length,
+                    total: totalStringsForLang,
+                    skipped: langSkipped,
+                    failed: langFailed,
+                    currentBatch: batchNum,
+                    totalBatches,
+                };
+                logger.batchProgress(progress);
+                try {
+                    const glossary = config.glossary?.[lang] || undefined;
+                    const result = await client.translateBatch({
+                        texts: batchValues,
+                        targetLang: lang,
+                        sourceLang: config.sourceLang,
+                        glossary,
+                    });
+                    for (let j = 0; j < batchKeys.length; j++) {
+                        translatedMap[batchKeys[j]] = result.translations[j];
+                    }
+                }
+                catch (err) {
+                    langFailed += batchKeys.length;
+                    logger.clearLine();
+                    logger.error(`${ns ? `[${ns}] ` : ""}Batch ${batchNum} failed: ${err.message}`);
+                }
+            }
+            logger.clearLine();
+            // Merge and write
+            if (Object.keys(translatedMap).length > 0) {
+                const merged = mergeTranslations(existingTarget, translatedMap);
+                const isNested = config.fileFormat === "nested-json";
+                await writeLocaleFile(targetPath, merged, isNested);
+                langTranslated += Object.keys(translatedMap).length;
+            }
+        }
+        const langTimeMs = Date.now() - langStart;
+        logger.langComplete(lang, langTranslated, langSkipped, langFailed, langTimeMs);
+        langResults.push({
+            lang,
+            translated: langTranslated,
+            skipped: langSkipped,
+            failed: langFailed,
+            timeMs: langTimeMs,
+        });
+        totalTranslated += langTranslated;
+        totalSkipped += langSkipped;
+        totalFailed += langFailed;
+    }
+    const totalTimeMs = Date.now() - overallStart;
+    return {
+        totalLangs: langResults.length,
+        totalTranslated,
+        totalSkipped,
+        totalFailed,
+        totalTimeMs,
+        langResults,
+    };
+}
+//# sourceMappingURL=translator.js.map

package/dist/translator.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * CLI configuration file (.translomaticrc.json)
+ */
+export interface CLIConfig {
+    /** API key (or use env TRANSLOMATIC_API_KEY) */
+    apiKey?: string;
+    /** Source language code (default: "en") */
+    sourceLang: string;
+    /** Target language codes to translate to */
+    targetLangs: string[];
+    /** Path to locales directory (relative to project root) */
+    localesDir: string;
+    /** File format: "json" or "nested-json" */
+    fileFormat: "json" | "nested-json";
+    /** i18n framework detected (informational) */
+    framework?: string;
+    /** File naming pattern: "{lang}.json" or "{lang}/{namespace}.json" */
+    filePattern: string;
+    /** Namespaces (for multi-file setups like react-i18next) */
+    namespaces?: string[];
+    /** Translation model to use */
+    model?: string;
+    /** Context description for AI translation */
+    context?: string;
+    /** Per-language glossaries: { "vi": { "Free": "Miễn phí" } } */
+    glossary?: Record<string, Record<string, string>>;
+}
+/**
+ * Detected i18n framework information
+ */
+export interface FrameworkInfo {
+    /** Framework name */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** Detected locales directory */
+    localesDir: string;
+    /** File pattern */
+    filePattern: string;
+    /** Source language detected */
+    sourceLang: string;
+    /** Existing languages found */
+    existingLangs: string[];
+    /** Namespaces found (if applicable) */
+    namespaces?: string[];
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Translation progress event
+ */
+export interface TranslationProgress {
+    /** Current language being translated */
+    lang: string;
+    /** Current namespace (if applicable) */
+    namespace?: string;
+    /** Number of strings translated so far */
+    translated: number;
+    /** Total strings to translate */
+    total: number;
+    /** Number of strings skipped (already translated) */
+    skipped: number;
+    /** Number of strings that failed */
+    failed: number;
+    /** Current batch being processed */
+    currentBatch: number;
+    /** Total batches */
+    totalBatches: number;
+}
+/**
+ * Translation status for a language
+ */
+export interface LangStatus {
+    lang: string;
+    totalKeys: number;
+    translatedKeys: number;
+    missingKeys: number;
+    coverage: number;
+    namespaces?: NamespaceStatus[];
+}
+export interface NamespaceStatus {
+    namespace: string;
+    totalKeys: number;
+    translatedKeys: number;
+    missingKeys: number;
+    coverage: number;
+}
+/**
+ * Flat key-value map (dotted keys for nested JSON)
+ */
+export type FlatMap = Record<string, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "translomatic-cli",
+  "version": "1.0.0",
+  "description": "CLI tool to auto-scan and translate entire projects using Translomatic API",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "translomatic": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "translation",
+    "i18n",
+    "internationalization",
+    "cli",
+    "translomatic",
+    "translate",
+    "localization",
+    "l10n",
+    "react-i18next",
+    "vue-i18n",
+    "next-intl"
+  ],
+  "author": "Translomatic",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "translomatic": "^1.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/node": "^20.0.0"
+  }
+}