ai-i18n-tools 1.0.0

package/dist/utils/concurrency.js

@@ -0,0 +1,103 @@
+/**
+ * Limited parallelism helpers (aligned with reference-transrewrt/scripts/translate/concurrency.ts).
+ */
+/**
+ * Run async `fn(item, index)` for each item with at most `limit` concurrent executions.
+ * Results are in the same order as `items`.
+ */
+export async function runMapWithConcurrency(items, limit, fn) {
+    if (items.length === 0)
+        return [];
+    const cap = Math.max(1, Math.min(Math.floor(limit), items.length));
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function worker() {
+        for (;;) {
+            const i = nextIndex++;
+            if (i >= items.length)
+                return;
+            results[i] = await fn(items[i], i);
+        }
+    }
+    await Promise.all(Array.from({ length: cap }, () => worker()));
+    return results;
+}
+/**
+ * Limit how many async tasks run at once (e.g. parallel OpenRouter calls per file).
+ */
+export class AsyncSemaphore {
+    constructor(max) {
+        this.max = max;
+        this.active = 0;
+        this.wait = [];
+        if (!Number.isFinite(max) || max < 1) {
+            throw new Error("AsyncSemaphore: max must be a finite number >= 1");
+        }
+    }
+    async use(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    acquire() {
+        if (this.active < this.max) {
+            this.active++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.wait.push(() => {
+                this.active++;
+                resolve();
+            });
+        });
+    }
+    release() {
+        this.active--;
+        const next = this.wait.shift();
+        if (next)
+            next();
+    }
+}
+/**
+ * Serialize async critical sections (e.g. SQLite cache access from parallel locale workers).
+ */
+export class AsyncMutex {
+    constructor() {
+        this.locked = false;
+        this.wait = [];
+    }
+    async runExclusive(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.wait.push(() => {
+                resolve();
+            });
+        });
+    }
+    release() {
+        const next = this.wait.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

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

package/dist/utils/hash.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Segment hash for cache lookup: normalize whitespace, SHA-256, first 16 hex chars.
+ */
+export declare function computeSegmentHash(content: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/utils/hash.js

@@ -0,0 +1,9 @@
+import crypto from "crypto";
+/**
+ * Segment hash for cache lookup: normalize whitespace, SHA-256, first 16 hex chars.
+ */
+export function computeSegmentHash(content) {
+    const normalized = content.replace(/\s+/g, " ").trim();
+    return crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/utils/ignore-parser.d.ts

@@ -0,0 +1,7 @@
+import ignore from "ignore";
+/**
+ * Load gitignore-style patterns from `.translate-ignore` (or custom path).
+ */
+export declare function loadTranslateIgnore(ignoreFilePath: string, cwd?: string): ReturnType<typeof ignore>;
+export declare function isIgnored(ig: ReturnType<typeof ignore>, filepath: string, cwd?: string): boolean;
+//# sourceMappingURL=ignore-parser.d.ts.map

package/dist/utils/ignore-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-parser.d.ts","sourceRoot":"","sources":["../../src/utils/ignore-parser.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,GAAG,SAAgB,GAClB,UAAU,CAAC,OAAO,MAAM,CAAC,CAW3B;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAgB,GAClB,OAAO,CAMT"}

package/dist/utils/ignore-parser.js

@@ -0,0 +1,26 @@
+import fs from "fs";
+import path from "path";
+import ignore from "ignore";
+/**
+ * Load gitignore-style patterns from `.translate-ignore` (or custom path).
+ */
+export function loadTranslateIgnore(ignoreFilePath, cwd = process.cwd()) {
+    const ig = ignore();
+    const resolved = path.isAbsolute(ignoreFilePath)
+        ? ignoreFilePath
+        : path.join(cwd, ignoreFilePath);
+    if (!fs.existsSync(resolved)) {
+        return ig;
+    }
+    const raw = fs.readFileSync(resolved, "utf8");
+    ig.add(raw.split(/\r?\n/).filter((l) => l.trim() && !l.startsWith("#")));
+    return ig;
+}
+export function isIgnored(ig, filepath, cwd = process.cwd()) {
+    const rel = path.relative(cwd, filepath).split(path.sep).join("/");
+    if (rel.startsWith("..")) {
+        return false;
+    }
+    return ig.ignores(rel);
+}
+//# sourceMappingURL=ignore-parser.js.map

package/dist/utils/ignore-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-parser.js","sourceRoot":"","sources":["../../src/utils/ignore-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAAsB,EACtB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAC9C,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,EAA6B,EAC7B,QAAgB,EAChB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,45 @@
+export type LogLevelName = "debug" | "info" | "warn" | "error";
+export interface LoggerOptions {
+    /** Minimum level to emit (console and file). */
+    level?: LogLevelName;
+    /** When set, append structured lines to this file (no rotation in Phase 1 - use logrotate externally). */
+    filePath?: string;
+    /** Label prefix for this logger instance. */
+    context?: string;
+    /** When true, skip ANSI colors (e.g. CI or file-only). */
+    noColor?: boolean;
+}
+/**
+ * Structured logger: leveled console output with optional file tee and a simple session buffer.
+ */
+export declare class Logger {
+    private readonly options;
+    private readonly level;
+    private readonly context?;
+    private readonly noColor;
+    private fileStream;
+    private readonly sessionLines;
+    private readonly maxSessionLines;
+    constructor(options?: LoggerOptions);
+    child(ctx: string): Logger;
+    /** Last N formatted log lines for this process (debug / support). */
+    getSessionLog(): readonly string[];
+    private shouldEmit;
+    private formatLine;
+    private pushSession;
+    private write;
+    debug(message: string, extra?: Record<string, unknown>): void;
+    info(message: string, extra?: Record<string, unknown>): void;
+    warn(message: string, extra?: Record<string, unknown>): void;
+    error(message: string, extra?: Record<string, unknown>): void;
+    /** OpenRouter / HTTP traffic (respects log level; always plain JSON-ish). */
+    logApiTraffic(direction: "request" | "response", summary: string, detail?: Record<string, unknown>): void;
+    close(done?: (err?: Error) => void): void;
+}
+/**
+ * Truncate a log file by keeping the last `keepBytes` bytes (best-effort rotation helper).
+ */
+export declare function truncateLogFile(filePath: string, keepBytes: number): Promise<void>;
+/** Strip ANSI codes from a string (for exporting session logs). */
+export declare function stripAnsi(s: string): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAqB/D,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,MAAM;IAQL,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAEZ,OAAO,GAAE,aAAkB;IAcxD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAS1B,qEAAqE;IACrE,aAAa,IAAI,SAAS,MAAM,EAAE;IAIlC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,KAAK;IAgCb,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,6EAA6E;IAC7E,aAAa,CACX,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI;IAQP,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAS1C;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxF;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C"}

package/dist/utils/logger.js

@@ -0,0 +1,158 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+const LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+function parseLevel(raw) {
+    const n = (raw ?? "info").toLowerCase();
+    if (n === "debug" || n === "info" || n === "warn" || n === "error") {
+        return n;
+    }
+    return "info";
+}
+function timestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Structured logger: leveled console output with optional file tee and a simple session buffer.
+ */
+export class Logger {
+    constructor(options = {}) {
+        this.options = options;
+        this.fileStream = null;
+        this.sessionLines = [];
+        this.level = options.level ?? parseLevel(process.env.I18N_LOG_LEVEL);
+        this.context = options.context;
+        this.noColor = options.noColor ?? (process.env.NO_COLOR === "1" || !process.stdout.isTTY);
+        this.maxSessionLines = Number(process.env.I18N_LOG_SESSION_MAX ?? "5000");
+        if (!Number.isFinite(this.maxSessionLines) || this.maxSessionLines < 1) {
+            this.maxSessionLines = 5000;
+        }
+        if (options.filePath) {
+            fs.mkdirSync(path.dirname(path.resolve(options.filePath)), { recursive: true });
+            this.fileStream = fs.createWriteStream(options.filePath, { flags: "a" });
+        }
+    }
+    child(ctx) {
+        const nextCtx = this.context ? `${this.context}:${ctx}` : ctx;
+        return new Logger({
+            ...this.options,
+            context: nextCtx,
+            filePath: undefined,
+        });
+    }
+    /** Last N formatted log lines for this process (debug / support). */
+    getSessionLog() {
+        return [...this.sessionLines];
+    }
+    shouldEmit(level) {
+        return LEVEL_ORDER[level] >= LEVEL_ORDER[this.level];
+    }
+    formatLine(level, message, extra) {
+        const ctx = this.context ? `[${this.context}] ` : "";
+        const base = `${timestamp()} ${level.toUpperCase()} ${ctx}${message}`;
+        if (extra && Object.keys(extra).length > 0) {
+            return `${base} ${JSON.stringify(extra)}`;
+        }
+        return base;
+    }
+    pushSession(line) {
+        this.sessionLines.push(line);
+        if (this.sessionLines.length > this.maxSessionLines) {
+            this.sessionLines.splice(0, this.sessionLines.length - this.maxSessionLines);
+        }
+    }
+    write(level, message, extra) {
+        if (!this.shouldEmit(level)) {
+            return;
+        }
+        const plain = this.formatLine(level, message, extra);
+        this.pushSession(plain);
+        let consoleLine = plain;
+        if (!this.noColor) {
+            const color = level === "error"
+                ? chalk.red
+                : level === "warn"
+                    ? chalk.yellow
+                    : level === "debug"
+                        ? chalk.gray
+                        : chalk.white;
+            consoleLine = color(plain);
+        }
+        if (level === "error") {
+            console.error(consoleLine);
+        }
+        else if (level === "warn") {
+            console.warn(consoleLine);
+        }
+        else {
+            console.log(consoleLine);
+        }
+        if (this.fileStream) {
+            this.fileStream.write(`${plain}\n`);
+        }
+    }
+    debug(message, extra) {
+        this.write("debug", message, extra);
+    }
+    info(message, extra) {
+        this.write("info", message, extra);
+    }
+    warn(message, extra) {
+        this.write("warn", message, extra);
+    }
+    error(message, extra) {
+        this.write("error", message, extra);
+    }
+    /** OpenRouter / HTTP traffic (respects log level; always plain JSON-ish). */
+    logApiTraffic(direction, summary, detail) {
+        if (!this.shouldEmit("debug")) {
+            return;
+        }
+        const msg = `API ${direction}: ${summary}`;
+        this.write("debug", msg, detail);
+    }
+    close(done) {
+        if (this.fileStream) {
+            const s = this.fileStream;
+            this.fileStream = null;
+            s.end(() => done?.());
+        }
+        else {
+            done?.();
+        }
+    }
+}
+/**
+ * Truncate a log file by keeping the last `keepBytes` bytes (best-effort rotation helper).
+ */
+export async function truncateLogFile(filePath, keepBytes) {
+    const resolved = path.resolve(filePath);
+    if (!fs.existsSync(resolved)) {
+        return;
+    }
+    const stat = fs.statSync(resolved);
+    if (stat.size <= keepBytes) {
+        return;
+    }
+    const stream = fs.createReadStream(resolved, {
+        start: stat.size - keepBytes,
+        end: stat.size - 1,
+    });
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+    }
+    const tail = Buffer.concat(chunks);
+    await fs.promises.writeFile(resolved, tail);
+}
+/** Strip ANSI codes from a string (for exporting session logs). */
+export function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\u001b\[[0-9;]*m/g, "");
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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