glotto 3.0.0 → 3.1.0

package/esm/src/types.d.ts

@@ -12,6 +12,9 @@ export type TranslateArgs = {
     from?: string;
     to?: string;
     url?: string;
+    config?: string;
+    stats?: boolean;
+    incremental?: boolean;
     'no-limit'?: boolean;
     'no-timeout'?: boolean;
     'max-batch-size'?: string;
@@ -21,13 +24,30 @@ export type ValidatedTranslateArgs = {
     provider: Provider;
     model?: string;
     input: string;
-    output: string;
+    output: string[];
     from: string;
-    to: string;
+    to: string[];
     url?: string;
     noLimit: boolean;
     noTimeout: boolean;
     maxBatchBytes: number;
+    stats: boolean;
+    incremental: boolean;
+};
+export type GlottoConfig = {
+    key?: string;
+    provider?: Provider;
+    model?: string;
+    input?: string;
+    output?: string | string[];
+    from?: string;
+    to?: string | string[];
+    url?: string;
+    noLimit?: boolean;
+    noTimeout?: boolean;
+    maxBatchSize?: number;
+    stats?: boolean;
+    incremental?: boolean;
 };
 export type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
 export interface JsonObject {
@@ -47,7 +67,15 @@ export type Batch = {
     leaves: Leaf[];
     byteSize: number;
 };
+export type TranslateUsage = {
+    inputTokens: number;
+    outputTokens: number;
+};
+export type TranslateResult = {
+    text: string;
+    usage?: TranslateUsage;
+};
 export interface TextTranslator {
-    translate(prompt: string): Promise<string>;
+    translate(prompt: string): Promise<TranslateResult>;
 }
 //# sourceMappingURL=types.d.ts.map

package/esm/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;AAClF,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AACD,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;AAEjC,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/src/types.ts"],"names":[],"mappings":"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"}

package/esm/src/utilites.d.ts

@@ -1,6 +1,5 @@
 import type { TranslateArgs, ValidatedTranslateArgs } from './types.js';
-import type { Args } from '../deps/jsr.io/@std/cli/1.0.29/mod.js';
-export declare const validateArgs: (args: Args<TranslateArgs>) => ValidatedTranslateArgs;
-export declare const formatBytes: (bytes: number) => string;
-export declare const delay: (ms: number) => Promise<void>;
+export declare function validateArgs(args: TranslateArgs): ValidatedTranslateArgs;
+export declare function formatBytes(bytes: number): string;
+export declare function delay(ms: number): Promise<void>;
 //# sourceMappingURL=utilites.d.ts.map

package/esm/src/utilites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilites.d.ts","sourceRoot":"","sources":["../../src/src/utilites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAGlE,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,CAAC,aAAa,CAAC,KAAG,sBA+BxD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAI3C,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAE9C,CAAC"}
+{"version":3,"file":"utilites.d.ts","sourceRoot":"","sources":["../../src/src/utilites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOlF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,CA0DxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/esm/src/utilites.js

@@ -1,17 +1,37 @@
 import { DEFAULT_MAX_BATCH_BYTES } from './contants.js';
-export const validateArgs = (args) => {
-    if (!args.key)
+function splitCsv(value) {
+    return value.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+}
+export function validateArgs(args) {
+    if (!args.key) {
         throw new Error('AI Key is required');
-    if (!args.provider)
+    }
+    if (!args.provider) {
         throw new Error('Provider parameter is required');
-    if (!args.input)
+    }
+    if (!args.input) {
         throw new Error('Input parameter is required');
-    if (!args.output)
+    }
+    if (!args.output) {
         throw new Error('Output parameter is required');
-    if (!args.from)
+    }
+    if (!args.from) {
         throw new Error('Source language (from) parameter is required');
-    if (!args.to)
+    }
+    if (!args.to) {
         throw new Error('Target language (to) parameter is required');
+    }
+    const toList = splitCsv(args.to);
+    const outputList = splitCsv(args.output);
+    if (toList.length === 0) {
+        throw new Error('Target language (to) must contain at least one value');
+    }
+    if (outputList.length === 0) {
+        throw new Error('Output must contain at least one value');
+    }
+    if (toList.length !== outputList.length) {
+        throw new Error(`--to (${toList.length}) and --output (${outputList.length}) must have the same number of values`);
+    }
     let maxBatchBytes = DEFAULT_MAX_BATCH_BYTES;
     const rawMaxBatchSize = args['max-batch-size'];
     if (rawMaxBatchSize !== undefined) {
@@ -26,22 +46,26 @@ export const validateArgs = (args) => {
         provider: args.provider,
         model: args.model,
         input: args.input,
-        output: args.output,
+        output: outputList,
         from: args.from,
-        to: args.to,
+        to: toList,
         url: args.url,
         noLimit: args['no-limit'] ?? false,
         noTimeout: args['no-timeout'] ?? false,
         maxBatchBytes,
+        stats: args.stats ?? false,
+        incremental: args.incremental ?? false,
     };
-};
-export const formatBytes = (bytes) => {
-    if (bytes < 1024)
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024) {
         return `${bytes} B`;
-    if (bytes < 1024 * 1024)
+    }
+    if (bytes < 1024 * 1024) {
         return `${(bytes / 1024).toFixed(1)} KB`;
+    }
     return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-};
-export const delay = (ms) => {
+}
+export function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
-};
+}

package/package.json

@@ -1,8 +1,22 @@
 {
   "name": "glotto",
-  "version": "3.0.0",
-  "description": "A tool for translating i18n JSON files using AI services.",
+  "version": "3.1.0",
+  "description": "AI-powered i18n JSON translator. Multi-target, incremental, provider-agnostic (OpenAI, Anthropic, Gemini).",
+  "keywords": [
+    "i18n",
+    "translation",
+    "translator",
+    "ai",
+    "openai",
+    "anthropic",
+    "gemini",
+    "localization",
+    "l10n",
+    "json",
+    "cli"
+  ],
   "author": "Ibrahim Odev <me@ibrahimo.dev>",
+  "homepage": "https://github.com/ibodev1/glotto#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ibodev1/glotto.git"
@@ -19,13 +33,13 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.10.0"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.95.0",
-    "@google/genai": "^1.52.0",
+    "@anthropic-ai/sdk": "^0.95.1",
+    "@google/genai": "^2.0.0",
     "consola": "^3.4.2",
-    "openai": "^6.36.0",
+    "openai": "^6.37.0",
     "@deno/shim-deno": "~0.18.0"
   },
   "devDependencies": {

package/schema/glotto.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/ibodev1/glotto/main/schema/glotto.schema.json",
+  "title": "Glotto config",
+  "description": "Configuration for the Glotto AI translator. CLI flags override values defined here.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for editor autocomplete."
+    },
+    "key": {
+      "type": "string",
+      "description": "API key for the AI provider."
+    },
+    "provider": {
+      "type": "string",
+      "enum": ["openai", "gemini", "anthropic"],
+      "description": "AI translation provider."
+    },
+    "model": {
+      "type": "string",
+      "description": "Model name for the selected provider."
+    },
+    "input": {
+      "type": "string",
+      "description": "Path to source JSON file."
+    },
+    "output": {
+      "description": "Single target file path or array of paths (one per target language).",
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        }
+      ]
+    },
+    "from": {
+      "type": "string",
+      "description": "Source language name."
+    },
+    "to": {
+      "description": "Target language name or array of names. Length must match output array.",
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        }
+      ]
+    },
+    "url": {
+      "type": "string",
+      "description": "Custom base URL for OpenAI/Anthropic providers."
+    },
+    "noLimit": {
+      "type": "boolean",
+      "description": "Disable inter-batch rate-limit delay.",
+      "default": false
+    },
+    "noTimeout": {
+      "type": "boolean",
+      "description": "Disable request timeout.",
+      "default": false
+    },
+    "maxBatchSize": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum source size per batch in KB.",
+      "default": 12
+    },
+    "stats": {
+      "type": "boolean",
+      "description": "Print AI usage statistics at the end of the run.",
+      "default": false
+    },
+    "incremental": {
+      "type": "boolean",
+      "description": "Translate only missing or empty keys when target file already exists.",
+      "default": false
+    }
+  }
+}

package/script/cli.js

@@ -43,6 +43,8 @@ const unstable_spinner_js_1 = require("./deps/jsr.io/@std/cli/1.0.29/unstable_sp
 const mod_js_1 = require("./deps/jsr.io/@std/cli/1.0.29/mod.js");
 const file_js_1 = require("./src/file.js");
 const translator_js_1 = require("./src/translator.js");
+const diff_js_1 = require("./src/diff.js");
+const config_js_1 = require("./src/config.js");
 const contants_js_1 = require("./src/contants.js");
 const utilites_js_1 = require("./src/utilites.js");
 const logger_js_1 = require("./src/logger.js");
@@ -51,7 +53,7 @@ const gemini_js_1 = __importDefault(require("./src/providers/gemini.js"));
 const openai_js_1 = __importDefault(require("./src/providers/openai.js"));
 const anthropic_js_1 = __importDefault(require("./src/providers/anthropic.js"));
 const spinner = new unstable_spinner_js_1.Spinner({ message: 'AI Thinks...', color: 'cyan' });
-const createTranslator = (args, options) => {
+function createTranslator(args, options) {
     switch (args.provider) {
         case 'gemini':
             return new gemini_js_1.default(args.key, args.model, options);
@@ -62,12 +64,99 @@ const createTranslator = (args, options) => {
         default:
             throw new Error(`Unknown provider: ${args.provider}`);
     }
-};
+}
+function printBanner() {
+    logger_js_1.logger.box(`Glotto AI Translator v${deno_js_1.default.version}\n${contants_js_1.GITHUB_REPO_URL}`);
+}
+function printStats(args, perTarget) {
+    const totalInput = perTarget.reduce((sum, t) => sum + t.usage.inputTokens, 0);
+    const totalOutput = perTarget.reduce((sum, t) => sum + t.usage.outputTokens, 0);
+    const totalCalls = perTarget.reduce((sum, t) => sum + t.calls, 0);
+    const totalBytes = perTarget.reduce((sum, t) => sum + t.bytes, 0);
+    const totalTranslated = perTarget.reduce((sum, t) => sum + t.translatedCount, 0);
+    const lines = [];
+    lines.push(`Provider: ${args.provider}${args.model ? ` (${args.model})` : ''}`);
+    lines.push(`Targets: ${perTarget.length}`);
+    lines.push('');
+    for (const t of perTarget) {
+        const mode = t.incrementalApplied ? ' [incremental]' : '';
+        lines.push(`→ ${t.to} (${t.output})${mode}: ${t.translatedCount}/${t.fullCount} entries, ${t.batchCount} batch(es), ${(0, utilites_js_1.formatBytes)(t.bytes)}, ${t.calls} call(s)`);
+        lines.push(`   tokens — in: ${t.usage.inputTokens}, out: ${t.usage.outputTokens}`);
+    }
+    lines.push('');
+    lines.push(`Total: ${totalTranslated} entries translated, ${totalCalls} call(s), ${(0, utilites_js_1.formatBytes)(totalBytes)}`);
+    lines.push(`Total tokens — in: ${totalInput}, out: ${totalOutput}, sum: ${totalInput + totalOutput}`);
+    logger_js_1.logger.box(lines.join('\n'));
+}
+async function translateForTarget(validatedArgs, fileContent, allLeaves, to, outputRel, translator, translateOptions, targetIndex, totalTargets) {
+    const outputPath = (0, file_js_1.resolvePath)(outputRel);
+    const targetLabel = `[Target ${targetIndex + 1}/${totalTargets}: ${to}]`;
+    logger_js_1.logger.info(`${targetLabel} → ${outputRel}`);
+    const translatableLeaves = allLeaves.filter((leaf) => leaf.translatable);
+    let leavesToTranslate = translatableLeaves;
+    let existingTarget = null;
+    let incrementalApplied = false;
+    if (validatedArgs.incremental) {
+        existingTarget = await (0, file_js_1.readJsonIfExists)(outputPath);
+        if (existingTarget !== null) {
+            leavesToTranslate = (0, diff_js_1.findMissingLeaves)(allLeaves, existingTarget);
+            incrementalApplied = true;
+            logger_js_1.logger.info(`${targetLabel} Incremental: ${leavesToTranslate.length}/${translatableLeaves.length} entries missing in existing target`);
+        }
+        else {
+            logger_js_1.logger.info(`${targetLabel} Incremental: target file not found, doing full translation`);
+        }
+    }
+    if (leavesToTranslate.length === 0) {
+        logger_js_1.logger.info(`${targetLabel} Nothing to translate, writing existing/source content`);
+        const content = existingTarget !== null ? existingTarget : fileContent;
+        await (0, file_js_1.writeOutput)(outputPath, JSON.stringify(content, null, 2));
+        return {
+            to,
+            output: outputRel,
+            fullCount: translatableLeaves.length,
+            translatedCount: 0,
+            batchCount: 0,
+            bytes: 0,
+            calls: 0,
+            usage: { inputTokens: 0, outputTokens: 0 },
+            incrementalApplied,
+        };
+    }
+    const batches = (0, translator_js_1.groupIntoBatches)(leavesToTranslate, validatedArgs.maxBatchBytes);
+    const totalBytes = batches.reduce((sum, b) => sum + b.byteSize, 0);
+    logger_js_1.logger.info(`${targetLabel} ${leavesToTranslate.length} translatable entries, ${(0, utilites_js_1.formatBytes)(totalBytes)}, split into ${batches.length} batch(es)`);
+    for (const batch of batches) {
+        logger_js_1.logger.info(`  Batch ${batch.index + 1}: ${batch.leaves.length} entries, ${(0, utilites_js_1.formatBytes)(batch.byteSize)}`);
+    }
+    spinner.start();
+    const result = await (0, translator_js_1.runBatches)(batches, translator, validatedArgs.from, to, translateOptions);
+    spinner.stop();
+    let finalContent;
+    if (incrementalApplied && existingTarget !== null) {
+        finalContent = (0, diff_js_1.mergeTranslations)(existingTarget, allLeaves, result.translations);
+    }
+    else {
+        finalContent = (0, translator_js_1.reconstruct)(allLeaves, result.translations);
+    }
+    await (0, file_js_1.writeOutput)(outputPath, JSON.stringify(finalContent, null, 2));
+    return {
+        to,
+        output: outputRel,
+        fullCount: translatableLeaves.length,
+        translatedCount: result.translations.size,
+        batchCount: batches.length,
+        bytes: totalBytes,
+        calls: result.calls,
+        usage: result.usage,
+        incrementalApplied,
+    };
+}
 async function main() {
     try {
         const args = (0, mod_js_1.parseArgs)(dntShim.Deno.args, {
-            string: ['key', 'provider', 'model', 'input', 'output', 'from', 'to', 'url', 'max-batch-size'],
-            boolean: ['help', 'version', 'no-limit', 'no-timeout'],
+            string: ['key', 'provider', 'model', 'input', 'output', 'from', 'to', 'url', 'max-batch-size', 'config'],
+            boolean: ['help', 'version', 'no-limit', 'no-timeout', 'stats', 'incremental'],
             alias: {
                 provider: 'p',
                 model: 'm',
@@ -79,7 +168,6 @@ async function main() {
                 help: 'h',
                 version: 'v',
             },
-            default: { provider: contants_js_1.DEFAULT_PROVIDER },
         });
         const help = args.help || dntShim.Deno.args.length === 0;
         const version = args.version;
@@ -88,38 +176,53 @@ async function main() {
             dntShim.Deno.exit(0);
         }
         if (help) {
+            printBanner();
             logger_js_1.logger.box(contants_js_1.HELP_TEXT);
             dntShim.Deno.exit(0);
         }
-        const validatedArgs = (0, utilites_js_1.validateArgs)(args);
+        printBanner();
+        const config = await (0, config_js_1.loadConfig)(args.config);
+        const merged = (0, config_js_1.applyConfig)(args, config, dntShim.Deno.args);
+        if (!merged.provider) {
+            merged.provider = contants_js_1.DEFAULT_PROVIDER;
+        }
+        const validatedArgs = (0, utilites_js_1.validateArgs)(merged);
         const fileContent = await (0, file_js_1.getImportJson)(validatedArgs.input);
         const allLeaves = (0, translator_js_1.extractLeaves)(fileContent);
         const translatableLeaves = allLeaves.filter((leaf) => leaf.translatable);
-        const batches = (0, translator_js_1.groupIntoBatches)(allLeaves, validatedArgs.maxBatchBytes);
-        const totalBytes = batches.reduce((sum, b) => sum + b.byteSize, 0);
         logger_js_1.logger.info('Provider: ', validatedArgs.provider);
         logger_js_1.logger.info('Input: ', validatedArgs.input);
-        logger_js_1.logger.info('Output: ', validatedArgs.output);
+        logger_js_1.logger.info('Targets: ', validatedArgs.to.map((to, i) => `${to} → ${validatedArgs.output[i]}`).join(', '));
         logger_js_1.logger.info('From: ', validatedArgs.from);
-        logger_js_1.logger.info('To: ', validatedArgs.to);
-        if (validatedArgs.model)
+        if (validatedArgs.model) {
             logger_js_1.logger.info('Model: ', validatedArgs.model);
-        if (validatedArgs.url)
+        }
+        if (validatedArgs.url) {
             logger_js_1.logger.info('URL: ', validatedArgs.url);
-        if (validatedArgs.noLimit)
+        }
+        if (validatedArgs.noLimit) {
             logger_js_1.logger.info('Rate limit protection: disabled (--no-limit)');
-        if (validatedArgs.noTimeout)
+        }
+        if (validatedArgs.noTimeout) {
             logger_js_1.logger.info('Request timeout: disabled (--no-timeout)');
+        }
+        if (validatedArgs.incremental) {
+            logger_js_1.logger.info('Incremental mode: enabled (--incremental)');
+        }
+        if (validatedArgs.stats) {
+            logger_js_1.logger.info('Stats: enabled (--stats)');
+        }
         if (validatedArgs.maxBatchBytes !== contants_js_1.DEFAULT_MAX_BATCH_BYTES) {
             logger_js_1.logger.info(`Max batch size: ${(0, utilites_js_1.formatBytes)(validatedArgs.maxBatchBytes)}`);
         }
-        logger_js_1.logger.info(`Total: ${translatableLeaves.length} translatable entries (of ${allLeaves.length} leaves), ${(0, utilites_js_1.formatBytes)(totalBytes)}, split into ${batches.length} batch(es)`);
-        for (const batch of batches) {
-            logger_js_1.logger.info(`  Batch ${batch.index + 1}: ${batch.leaves.length} entries, ${(0, utilites_js_1.formatBytes)(batch.byteSize)}`);
-        }
-        if (batches.length === 0) {
-            logger_js_1.logger.warn('No translatable entries found, copying input to output');
-            await (0, file_js_1.writeOutput)((0, file_js_1.resolvePath)(validatedArgs.output), JSON.stringify(fileContent, null, 2));
+        logger_js_1.logger.info(`Source: ${translatableLeaves.length} translatable entries (of ${allLeaves.length} leaves)`);
+        if (translatableLeaves.length === 0 && !validatedArgs.incremental) {
+            logger_js_1.logger.warn('No translatable entries found, copying input to output(s)');
+            for (const outputRel of validatedArgs.output) {
+                await (0, file_js_1.writeOutput)((0, file_js_1.resolvePath)(outputRel), JSON.stringify(fileContent, null, 2));
+            }
+            logger_js_1.logger.success('Translation completed');
+            logger_js_1.logger.info(`★ Glotto faydalı olduysa GitHub'da yıldızlamayı unutma: ${contants_js_1.GITHUB_REPO_URL}`);
             dntShim.Deno.exit(0);
         }
         const translateOptions = {
@@ -127,22 +230,23 @@ async function main() {
             noTimeout: validatedArgs.noTimeout,
         };
         const translator = createTranslator(validatedArgs, translateOptions);
-        spinner.start();
-        const translations = await (0, translator_js_1.runBatches)(batches, translator, validatedArgs.from, validatedArgs.to, translateOptions);
-        const result = (0, translator_js_1.reconstruct)(allLeaves, translations);
-        const outputPath = (0, file_js_1.resolvePath)(validatedArgs.output);
-        await (0, file_js_1.writeOutput)(outputPath, JSON.stringify(result, null, 2));
+        const perTarget = [];
+        for (let i = 0; i < validatedArgs.to.length; i++) {
+            const stat = await translateForTarget(validatedArgs, fileContent, allLeaves, validatedArgs.to[i], validatedArgs.output[i], translator, translateOptions, i, validatedArgs.to.length);
+            perTarget.push(stat);
+        }
         spinner.stop();
         logger_js_1.logger.success('Translation completed');
+        if (validatedArgs.stats) {
+            printStats(validatedArgs, perTarget);
+        }
+        logger_js_1.logger.info(`★ Glotto faydalı olduysa GitHub'da yıldızlamayı unutma: ${contants_js_1.GITHUB_REPO_URL}`);
+        dntShim.Deno.exit(0);
     }
     catch (error) {
         spinner.stop();
         logger_js_1.logger.error(error);
         dntShim.Deno.exit(1);
     }
-    finally {
-        spinner.stop();
-        dntShim.Deno.exit(0);
-    }
 }
 main();

package/script/deno.d.ts

@@ -11,17 +11,22 @@ declare namespace _default {
         publish: string;
         "publish:npm": string;
         check: string;
+        test: string;
     };
     namespace fmt {
         let semiColons: boolean;
         let singleQuote: boolean;
         let lineWidth: number;
     }
+    namespace publish {
+        let exclude: string[];
+    }
     let imports: {
         "@anthropic-ai/sdk": string;
         "@deno/dnt": string;
         "@google/genai": string;
         "@openai/openai": string;
+        "@std/assert": string;
         "@std/cli": string;
         "@std/path": string;
         consola: string;

package/script/deno.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = {
     "name": "@ibodev/glotto",
-    "version": "3.0.0",
+    "version": "3.1.0",
     "exports": "./cli.ts",
     "lock": false,
     "nodeModulesDir": "auto",
@@ -12,21 +12,33 @@ exports.default = {
         "build:npm": "deno run -A scripts/build_npm.ts",
         "publish": "deno publish",
         "publish:npm": "cd ./npm && npm publish",
-        "check": "deno check **/*.ts"
+        "check": "deno check **/*.ts",
+        "test": "deno test -A --no-check tests/"
     },
     "fmt": {
         "semiColons": true,
         "singleQuote": true,
         "lineWidth": 160
     },
+    "publish": {
+        "exclude": [
+            "tests/",
+            "scripts/",
+            "npm/",
+            "assets/",
+            "glotto.exe",
+            "CLAUDE.md"
+        ]
+    },
     "imports": {
-        "@anthropic-ai/sdk": "npm:@anthropic-ai/sdk@^0.95.0",
+        "@anthropic-ai/sdk": "npm:@anthropic-ai/sdk@^0.95.1",
         "@deno/dnt": "jsr:@deno/dnt@^0.42.3",
-        "@google/genai": "npm:@google/genai@^1.52.0",
-        "@openai/openai": "npm:openai@^6.36.0",
+        "@google/genai": "npm:@google/genai@^2.0.0",
+        "@openai/openai": "npm:openai@^6.37.0",
+        "@std/assert": "jsr:@std/assert@^1.0.19",
         "@std/cli": "jsr:@std/cli@^1.0.29",
         "@std/path": "jsr:@std/path@^1.1.4",
         "consola": "npm:consola@^3.4.2"
     },
-    "allowScripts": ["npm:@google/genai@1.52.0", "npm:protobufjs@7.5.6"]
+    "allowScripts": ["npm:@google/genai@1.52.0", "npm:@google/genai@2.0.0", "npm:protobufjs@7.5.6"]
 };

package/script/src/config.d.ts

@@ -0,0 +1,4 @@
+import type { GlottoConfig, TranslateArgs } from './types.js';
+export declare function loadConfig(explicitPath?: string): Promise<GlottoConfig>;
+export declare function applyConfig(cli: TranslateArgs, config: GlottoConfig, rawArgs: string[]): TranslateArgs;
+//# sourceMappingURL=config.d.ts.map

package/script/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuB9D,wBAAsB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAc7E;AAkBD,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,CA0CtG"}