ai-i18n-tools 1.4.1 → 1.4.2

package/dist/build-info.generated.d.ts

@@ -1,3 +1,3 @@
 /** Auto-generated by scripts/write-build-info.mjs — do not edit */
-export declare const BUILD_TIMESTAMP_ISO = "2026-05-06T22:24:28.496Z";
+export declare const BUILD_TIMESTAMP_ISO = "2026-05-12T22:28:46.898Z";
 //# sourceMappingURL=build-info.generated.d.ts.map

package/dist/build-info.generated.js

@@ -1,3 +1,3 @@
 /** Auto-generated by scripts/write-build-info.mjs — do not edit */
-export const BUILD_TIMESTAMP_ISO = "2026-05-06T22:24:28.496Z";
+export const BUILD_TIMESTAMP_ISO = "2026-05-12T22:28:46.898Z";
 //# sourceMappingURL=build-info.generated.js.map

package/dist/cli/doc-translate.d.ts

@@ -7,6 +7,7 @@ import { Glossary } from "../glossary/glossary.js";
 import { OpenRouterClient } from "../api/openrouter.js";
 import type { DocumentBatchResponseFormat } from "../core/prompt-builder.js";
 import { AsyncMutex } from "../utils/concurrency.js";
+import { FileContentCache } from "./file-content-cache.js";
 /** Same segment-extraction options as `translate-docs` for one documentation block. */
 export declare function buildMarkdownExtractOpts(documentation: DocumentationBlock): MarkdownExtractOptions | undefined;
 /** Batch segment prompt/response shape for `translate-docs --prompt-format`. */
@@ -60,6 +61,12 @@ export interface TranslateRunOptions {
      * Default: off.
      */
     debugFailed?: boolean;
+    /**
+     * Max concurrent files processed within a single locale.
+     * When > 1, files within the same locale are processed in parallel using AsyncSemaphore.
+     * Default: 1 (sequential processing).
+     */
+    fileConcurrency?: number;
 }
 export interface TranslateTotals {
     filesWritten: number;
@@ -132,15 +139,15 @@ export declare function augmentMarkdownFilesFromPathFilter(projectRoot: string,
  * per-locale work so diagnostics are not repeated for every locale.
  */
 export declare function scanAndRecordMarkdownSourceIssuesForTranslate(absSource: string, relPath: string, config: I18nDocTranslateConfig, cache: TranslationCache, opts: TranslateRunOptions): Promise<void>;
-export declare function translateMarkdownFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>, translatedMarkdownRelPaths: ReadonlySet<string>): Promise<{
+export declare function translateMarkdownFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>, translatedMarkdownRelPaths: ReadonlySet<string>, fileContentCache?: FileContentCache): Promise<{
     skipped: boolean;
     totals: TranslateTotals;
 }>;
-export declare function translateJsonFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>): Promise<{
+export declare function translateJsonFile(absSource: string, relPath: string, locale: string, config: I18nDocTranslateConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>, fileContentCache?: FileContentCache): Promise<{
     skipped: boolean;
     totals: TranslateTotals;
 }>;
-/** Translate one SVG asset (`translate-svg`); uses `config.svg` for paths and optional `svg.svgExtractor`. */
+/** Translate one SVG asset (`translate-svg`); uses `config.svg` for paths and optional `svg.forceLowercase`. */
 export declare function translateSvgAssetFile(absSource: string, relPathFromCwd: string, relPathFromSourceRoot: string, locale: string, config: I18nConfig, cache: TranslationCache | null, client: OpenRouterClient | null, glossary: Glossary, opts: TranslateRunOptions, hitKeys: Set<string>): Promise<{
     skipped: boolean;
     totals: TranslateTotals;

package/dist/cli/doc-translate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-translate.d.ts","sourceRoot":"","sources":["../../src/cli/doc-translate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doc-translate.d.ts","sourceRoot":"","sources":["../../src/cli/doc-translate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EAGvB,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAStC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAM1E,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA+BxD,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAyC,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAS3D,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,kBAAkB,GAChC,sBAAsB,GAAG,SAAS,CAUpC;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzE,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,qBAAqB,GAAG,SAAS,GACrC,2BAA2B,CAW7B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8FAA8F;IAC9F,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;OAEG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+HAA+H;IAC/H,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,8HAA8H;IAC9H,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,KAAK,YAAY,GAAG,UAAU,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,GAAG;IAC5E,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC,CAAC;AAsBF,gIAAgI;AAChI,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,uBAAuB,EAAE,OAAO,EAChC,oBAAoB,UAAQ,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA8BvC;AAgLD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAWT;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAWhG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAOtF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,GAAG,SAAS,CAoBpB;AAID;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAChC,OAAO,CAeT;AAED,wBAAgB,4CAA4C,CAC1D,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAChD,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,EAAE,CAoBV;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,uBAAuB,EAAE,MAAM,EAC/B,cAAc,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACjD,kBAAkB,EAAE,MAAM,EAAE,GAC3B,mCAAmC,CAyDrC;AAm0BD;;;;GAIG;AACH,wBAAsB,6CAA6C,CACjE,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/C,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAqTxD;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAkNxD;AAED,gHAAgH;AAChH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,qBAAqB,EAAE,MAAM,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAmOxD;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,mBAAmB,EACzB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAmCR;AAyDD,uDAAuD;AACvD,wBAAsB,YAAY,CAChC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,EACD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAiZ1B"}

package/dist/cli/doc-translate.js

@@ -27,6 +27,7 @@ import { ensureDirForFile, hashFileContent, resolveTranslatedOutputPath, writeAt
 import { normalizeLocale } from "../core/config.js";
 import { collectFilesByExtension } from "./file-utils.js";
 import { runMapWithConcurrency, AsyncSemaphore, AsyncMutex } from "../utils/concurrency.js";
+import { FileContentCache } from "./file-content-cache.js";
 import { describeEmphasisPlaceholdersPolicy, resolveMarkdownEmphasisPlaceholders, usesAutomaticEmphasisPlaceholdersForLocale, } from "../core/markdown-emphasis-defaults.js";
 import { collectMarkdownIssuesForSegment } from "../processors/markdown-source-diagnostics.js";
 /** Same segment-extraction options as `translate-docs` for one documentation block. */
@@ -981,7 +982,7 @@ export async function scanAndRecordMarkdownSourceIssuesForTranslate(absSource, r
         }
     }
 }
-export async function translateMarkdownFile(absSource, relPath, locale, config, cache, client, glossary, opts, hitKeys, translatedMarkdownRelPaths) {
+export async function translateMarkdownFile(absSource, relPath, locale, config, cache, client, glossary, opts, hitKeys, translatedMarkdownRelPaths, fileContentCache) {
     const totals = {
         filesWritten: 0,
         filesSkipped: 0,
@@ -989,9 +990,17 @@ export async function translateMarkdownFile(absSource, relPath, locale, config,
         outputTokens: 0,
         costUsd: 0,
     };
-    const content = fs.readFileSync(absSource, "utf8");
-    const fileHash = hashFileContent(content);
-    const sourceFileMtime = fs.statSync(absSource).mtime.toISOString();
+    // Use file content cache if provided, otherwise fall back to direct reads
+    const fileData = fileContentCache
+        ? fileContentCache.readFile(absSource)
+        : {
+            content: fs.readFileSync(absSource, "utf8"),
+            hash: hashFileContent(fs.readFileSync(absSource, "utf8")),
+            mtime: fs.statSync(absSource).mtime.toISOString(),
+        };
+    const content = fileData.content;
+    const fileHash = fileData.hash;
+    const sourceFileMtime = fileData.mtime;
     /** Cwd-relative posix path for `translations.filepath` metadata (aligned with JSON/SVG). */
     const translationFilepathMeta = relPath.split(path.sep).join("/");
     const outPath = resolveTranslatedOutputPath(config, opts.cwd, locale, relPath, "markdown");
@@ -1043,30 +1052,40 @@ export async function translateMarkdownFile(absSource, relPath, locale, config,
         : undefined;
     const emphasisOn = resolveMarkdownEmphasisPlaceholders(locale, config.documentation, config, opts);
     let segmentsCached = 0;
+    // Collect translatable segment hashes for batch cache lookup
+    const translatableSegments = [];
     for (let docIdx = 0; docIdx < segments.length; docIdx++) {
         const s = segments[docIdx];
-        if (!s.translatable) {
-            continue;
+        if (s.translatable) {
+            translatableSegments.push({ s, docIdx });
         }
-        if (!opts.force && cache && !opts.noCache) {
-            const hit = await withCacheMutex(opts.cacheMutex, () => cache.getSegmentDetails(s.hash, locale, translationFilepathMeta, s.startLine));
-            if (hit) {
-                const quality = await validateDocTranslatePair(s, hit.text);
-                if (quality.ok) {
-                    const modelUsed = hit.model?.trim();
-                    translations.set(s.hash, {
-                        text: hit.text,
-                        ...(modelUsed ? { modelUsed } : {}),
-                    });
-                    hitKeys.add(`${s.hash}|${locale}`);
-                    segmentsCached++;
-                    continue;
-                }
-                if (opts.verbose) {
-                    console.warn(chalk.yellow(`  ⚠️  ${relPath} (${locale}): cache rejected for segment (hash ${s.hash}): ${quality.errors.join("; ")}`));
-                }
+    }
+    // Batch cache lookup: fetch all cached segments in one query
+    let batchCacheHits;
+    if (!opts.force && cache && !opts.noCache && translatableSegments.length > 0) {
+        const hashes = translatableSegments.map(({ s }) => s.hash);
+        batchCacheHits = await withCacheMutex(opts.cacheMutex, () => cache.getSegmentsBatch(hashes, locale));
+    }
+    // Process segments: use batch cache results and validate
+    for (const { s, docIdx } of translatableSegments) {
+        const cached = batchCacheHits?.get(s.hash);
+        if (cached) {
+            const quality = await validateDocTranslatePair(s, cached.text);
+            if (quality.ok) {
+                const modelUsed = cached.model?.trim();
+                translations.set(s.hash, {
+                    text: cached.text,
+                    ...(modelUsed ? { modelUsed } : {}),
+                });
+                hitKeys.add(`${s.hash}|${locale}`);
+                segmentsCached++;
+                continue;
+            }
+            else if (opts.verbose) {
+                console.warn(chalk.yellow(`  ⚠️  ${relPath} (${locale}): cache rejected for segment (hash ${s.hash}): ${quality.errors.join("; ")}`));
             }
         }
+        // Cache miss or validation failed: prepare for translation
         if (failureTracker && !clearedFailureHashes.has(s.hash)) {
             await failureTracker.clearSegmentFailures(s.hash, locale);
             clearedFailureHashes.add(s.hash);
@@ -1171,7 +1190,7 @@ export async function translateMarkdownFile(absSource, relPath, locale, config,
     logTranslateFileComplete(relPath, outPath, segmentsCached, segmentsNew, Date.now() - fileStartTime, totals.costUsd ?? 0);
     return { skipped: false, totals };
 }
-export async function translateJsonFile(absSource, relPath, locale, config, cache, client, glossary, opts, hitKeys) {
+export async function translateJsonFile(absSource, relPath, locale, config, cache, client, glossary, opts, hitKeys, fileContentCache) {
     const totals = {
         filesWritten: 0,
         filesSkipped: 0,
@@ -1179,8 +1198,16 @@ export async function translateJsonFile(absSource, relPath, locale, config, cach
         outputTokens: 0,
         costUsd: 0,
     };
-    const content = fs.readFileSync(absSource, "utf8");
-    const fileHash = hashFileContent(content);
+    // Use file content cache if provided, otherwise fall back to direct reads
+    const fileData = fileContentCache
+        ? fileContentCache.readFile(absSource)
+        : {
+            content: fs.readFileSync(absSource, "utf8"),
+            hash: hashFileContent(fs.readFileSync(absSource, "utf8")),
+            mtime: fs.statSync(absSource).mtime.toISOString(),
+        };
+    const content = fileData.content;
+    const fileHash = fileData.hash;
     /** Cwd-relative path for cache/UI and `file_tracking` (must match `resolveDocTrackingKeyToAbs` under project root). */
     const relPathFromCwd = path.relative(opts.cwd, absSource).split(path.sep).join("/");
     const outPath = resolveTranslatedOutputPath(config, opts.cwd, locale, relPath, "json");
@@ -1301,7 +1328,7 @@ export async function translateJsonFile(absSource, relPath, locale, config, cach
     logTranslateFileComplete(relPath, outPath, segmentsCached, segmentsNew, Date.now() - fileStartTime, totals.costUsd ?? 0);
     return { skipped: false, totals };
 }
-/** Translate one SVG asset (`translate-svg`); uses `config.svg` for paths and optional `svg.svgExtractor`. */
+/** Translate one SVG asset (`translate-svg`); uses `config.svg` for paths and optional `svg.forceLowercase`. */
 export async function translateSvgAssetFile(absSource, relPathFromCwd, relPathFromSourceRoot, locale, config, cache, client, glossary, opts, hitKeys) {
     const totals = {
         filesWritten: 0,
@@ -1313,7 +1340,7 @@ export async function translateSvgAssetFile(absSource, relPathFromCwd, relPathFr
     const cacheKey = svgAssetCacheFilepath(relPathFromCwd);
     const translationSvgFilepathMeta = svgTranslationFilepathMetadata(relPathFromCwd);
     const outPath = resolveSvgAssetOutputPath(config, opts.cwd, locale, relPathFromCwd, relPathFromSourceRoot);
-    const forceLc = config.svg?.svgExtractor?.forceLowercase ?? false;
+    const forceLc = config.svg?.forceLowercase ?? false;
     const content = fs.readFileSync(absSource, "utf8");
     const fileHash = hashFileContent(content);
     if (opts.force && cache && !opts.noCache) {
@@ -1588,7 +1615,9 @@ export async function runTranslate(config, opts, files, jsonAbsRoot) {
     console.log("");
     const localeConcurrency = Math.max(1, Math.floor(opts.concurrency ?? config.concurrency ?? 3));
     const batchConcurrencyEffective = Math.max(1, Math.floor(opts.batchConcurrency ?? config.batchConcurrency ?? 4));
+    const fileConcurrencyEffective = Math.max(1, Math.floor(opts.fileConcurrency ?? config.fileConcurrency ?? 1));
     console.log(chalk.cyan(`Locale concurrency: `) + chalk.magenta(`${localeConcurrency}`));
+    console.log(chalk.cyan(`File concurrency per locale: `) + chalk.magenta(`${fileConcurrencyEffective}`));
     console.log(chalk.cyan(`Parallel API calls per file: `) + chalk.magenta(`${batchConcurrencyEffective}`));
     console.log(chalk.cyan(`Batch prompt format: `) + chalk.magenta(`${opts.promptFormat ?? "json-array"}`));
     console.log(chalk.cyan(`Markdown emphasis placeholders: `) +
@@ -1597,9 +1626,11 @@ export async function runTranslate(config, opts, files, jsonAbsRoot) {
     const wallStart = Date.now();
     const localeTimes = [];
     const cacheMutex = cache && locales.length > 1 ? new AsyncMutex() : undefined;
+    const fileContentCache = new FileContentCache();
     const runOpts = {
         ...opts,
         batchConcurrency: batchConcurrencyEffective,
+        fileConcurrency: fileConcurrencyEffective,
         cacheMutex,
     };
     if (shouldRunMarkdown(opts, config) && cache && !opts.noCache && !opts.dryRun) {
@@ -1632,62 +1663,124 @@ export async function runTranslate(config, opts, files, jsonAbsRoot) {
                 if (usesAutomaticEmphasisPlaceholdersForLocale(locale, config.documentation, config, runOpts)) {
                     console.log(chalk.gray(`   ${locale}: Markdown emphasis placeholders is "on". Override with documentations[].emphasisPlaceholders or CLI flags)`));
                 }
-                for (const rel of files.markdown) {
-                    if (!matchesPathFilter(rel, opts.pathFilter)) {
-                        continue;
-                    }
+                const markdownFilesToProcess = files.markdown.filter((rel) => matchesPathFilter(rel, opts.pathFilter));
+                const processMarkdownFile = async (rel) => {
                     const abs = path.join(opts.cwd, rel);
-                    const { skipped, totals } = await translateMarkdownFile(abs, rel, locale, config, cache, client, glossary, runOpts, markdownHitKeysLocal, translatedMarkdownRelPaths);
-                    if (skipped) {
-                        partial.filesSkipped += totals.filesSkipped;
-                        partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                    const { skipped, totals } = await translateMarkdownFile(abs, rel, locale, config, cache, client, glossary, runOpts, markdownHitKeysLocal, translatedMarkdownRelPaths, fileContentCache);
+                    return { skipped, totals };
+                };
+                if (fileConcurrencyEffective > 1) {
+                    const results = await runMapWithConcurrency(markdownFilesToProcess, fileConcurrencyEffective, processMarkdownFile);
+                    for (const { skipped, totals } of results) {
+                        if (skipped) {
+                            partial.filesSkipped += totals.filesSkipped;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                        }
+                        else {
+                            partial.filesWritten += totals.filesWritten;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                            partial.inputTokens += totals.inputTokens;
+                            partial.outputTokens += totals.outputTokens;
+                            partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
+                            partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
+                            partial.segmentsTranslated =
+                                (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
+                            partial.segmentValidationFailures =
+                                (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
+                            partial.individualSegmentTranslations =
+                                (partial.individualSegmentTranslations ?? 0) +
+                                    (totals.individualSegmentTranslations ?? 0);
+                        }
                     }
-                    else {
-                        partial.filesWritten += totals.filesWritten;
-                        partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
-                        partial.inputTokens += totals.inputTokens;
-                        partial.outputTokens += totals.outputTokens;
-                        partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
-                        partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
-                        partial.segmentsTranslated =
-                            (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
-                        partial.segmentValidationFailures =
-                            (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
-                        partial.individualSegmentTranslations =
-                            (partial.individualSegmentTranslations ?? 0) +
-                                (totals.individualSegmentTranslations ?? 0);
+                }
+                else {
+                    for (const rel of markdownFilesToProcess) {
+                        const { skipped, totals } = await processMarkdownFile(rel);
+                        if (skipped) {
+                            partial.filesSkipped += totals.filesSkipped;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                        }
+                        else {
+                            partial.filesWritten += totals.filesWritten;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                            partial.inputTokens += totals.inputTokens;
+                            partial.outputTokens += totals.outputTokens;
+                            partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
+                            partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
+                            partial.segmentsTranslated =
+                                (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
+                            partial.segmentValidationFailures =
+                                (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
+                            partial.individualSegmentTranslations =
+                                (partial.individualSegmentTranslations ?? 0) +
+                                    (totals.individualSegmentTranslations ?? 0);
+                        }
                     }
                 }
             }
             if (shouldRunJson(opts, config)) {
-                for (const rel of files.json) {
+                const jsonFilesToProcess = files.json.filter((rel) => {
                     const jsonRelFromProjectRoot = jsonFileProjectRelativePath(opts.cwd, jsonAbsRoot, rel);
-                    if (!matchesPathFilter(jsonRelFromProjectRoot, opts.pathFilter)) {
-                        continue;
-                    }
+                    return matchesPathFilter(jsonRelFromProjectRoot, opts.pathFilter);
+                });
+                const processJsonFile = async (rel) => {
                     const abs = path.join(jsonAbsRoot, rel);
-                    const { skipped, totals } = await translateJsonFile(abs, rel, locale, config, cache, client, glossary, runOpts, hitKeys);
-                    if (skipped) {
-                        partial.filesSkipped += totals.filesSkipped;
-                        partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                    const { skipped, totals } = await translateJsonFile(abs, rel, locale, config, cache, client, glossary, runOpts, hitKeys, fileContentCache);
+                    return { skipped, totals };
+                };
+                if (fileConcurrencyEffective > 1) {
+                    const results = await runMapWithConcurrency(jsonFilesToProcess, fileConcurrencyEffective, processJsonFile);
+                    for (const { skipped, totals } of results) {
+                        if (skipped) {
+                            partial.filesSkipped += totals.filesSkipped;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                        }
+                        else {
+                            partial.filesWritten += totals.filesWritten;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                            partial.inputTokens += totals.inputTokens;
+                            partial.outputTokens += totals.outputTokens;
+                            partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
+                            partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
+                            partial.segmentsTranslated =
+                                (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
+                            partial.segmentValidationFailures =
+                                (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
+                            partial.individualSegmentTranslations =
+                                (partial.individualSegmentTranslations ?? 0) +
+                                    (totals.individualSegmentTranslations ?? 0);
+                        }
                     }
-                    else {
-                        partial.filesWritten += totals.filesWritten;
-                        partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
-                        partial.inputTokens += totals.inputTokens;
-                        partial.outputTokens += totals.outputTokens;
-                        partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
-                        partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
-                        partial.segmentsTranslated =
-                            (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
-                        partial.segmentValidationFailures =
-                            (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
-                        partial.individualSegmentTranslations =
-                            (partial.individualSegmentTranslations ?? 0) +
-                                (totals.individualSegmentTranslations ?? 0);
+                }
+                else {
+                    for (const rel of jsonFilesToProcess) {
+                        const { skipped, totals } = await processJsonFile(rel);
+                        if (skipped) {
+                            partial.filesSkipped += totals.filesSkipped;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                        }
+                        else {
+                            partial.filesWritten += totals.filesWritten;
+                            partial.filesProcessed = (partial.filesProcessed ?? 0) + (totals.filesProcessed ?? 0);
+                            partial.inputTokens += totals.inputTokens;
+                            partial.outputTokens += totals.outputTokens;
+                            partial.costUsd = (partial.costUsd ?? 0) + (totals.costUsd ?? 0);
+                            partial.segmentsCached = (partial.segmentsCached ?? 0) + (totals.segmentsCached ?? 0);
+                            partial.segmentsTranslated =
+                                (partial.segmentsTranslated ?? 0) + (totals.segmentsTranslated ?? 0);
+                            partial.segmentValidationFailures =
+                                (partial.segmentValidationFailures ?? 0) + (totals.segmentValidationFailures ?? 0);
+                            partial.individualSegmentTranslations =
+                                (partial.individualSegmentTranslations ?? 0) +
+                                    (totals.individualSegmentTranslations ?? 0);
+                        }
                     }
                 }
             }
+            // Batch update last_hit_at for all cached segments in this locale
+            if (cache && !opts.noCache && markdownHitKeysLocal.size > 0) {
+                await withCacheMutex(opts.cacheMutex, () => cache.batchUpdateLastHitAt(Array.from(markdownHitKeysLocal)));
+            }
         }
         catch (e) {
             error = e;