ai-i18n-tools 1.0.0

package/dist/core/output-paths.js

@@ -0,0 +1,130 @@
+import path from "path";
+const DOCUSAURUS_PLUGIN = "docusaurus-plugin-content-docs/current";
+/** Normalize to forward slashes for template keys and comparisons. */
+export function toPosix(p) {
+    return p.split(path.sep).join("/");
+}
+function templateForKind(config, kind) {
+    const mo = config.documentation.markdownOutput;
+    if (kind === "markdown") {
+        return mo.pathTemplate?.trim();
+    }
+    return mo.jsonPathTemplate?.trim();
+}
+/**
+ * Expand `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`,
+ * `{docsRoot}`, `{relativeToDocsRoot}`.
+ */
+export function expandPathTemplate(template, ctx) {
+    const posixRel = toPosix(ctx.relPath);
+    const parsed = path.posix.parse(posixRel);
+    const stem = parsed.name;
+    const extension = parsed.ext;
+    const basename = parsed.base;
+    let relativeToDocsRoot = posixRel;
+    const dr = toPosix(ctx.docsRoot).replace(/\/$/, "");
+    if (dr && (posixRel === dr || posixRel.startsWith(`${dr}/`))) {
+        relativeToDocsRoot = posixRel.slice(dr.length).replace(/^\//, "");
+    }
+    let out = template;
+    const pairs = [
+        ["{outputDir}", ctx.outputDir],
+        ["{locale}", ctx.locale],
+        ["{LOCALE}", ctx.locale.toUpperCase()],
+        ["{relPath}", posixRel],
+        ["{stem}", stem],
+        ["{basename}", basename],
+        ["{extension}", extension],
+        ["{docsRoot}", ctx.docsRoot],
+        ["{relativeToDocsRoot}", relativeToDocsRoot],
+    ];
+    for (const [key, val] of pairs) {
+        out = out.split(key).join(val);
+    }
+    return out;
+}
+function assertOutputWithinRoot(absFile, rootDir) {
+    const abs = path.resolve(absFile);
+    const root = path.resolve(rootDir);
+    const rel = path.relative(root, abs);
+    if (rel.startsWith("..") || path.isAbsolute(rel)) {
+        throw new Error(`Resolved output path escapes the documentation block outputDir: ${absFile} (root: ${root})`);
+    }
+}
+function resolveByStyle(config, cwd, locale, relPath, kind) {
+    const doc = config.documentation;
+    const outBase = path.resolve(cwd, doc.outputDir);
+    const mo = doc.markdownOutput;
+    const posixRel = toPosix(relPath);
+    const docsRootRaw = mo.docsRoot?.trim() || "docs";
+    const docsRootPosix = toPosix(path.normalize(docsRootRaw)).replace(/\/$/, "");
+    if (kind !== "markdown") {
+        return path.join(outBase, locale, relPath);
+    }
+    switch (mo.style) {
+        case "nested":
+            return path.join(outBase, locale, relPath);
+        case "docusaurus": {
+            const under = posixRel === docsRootPosix ||
+                posixRel.startsWith(`${docsRootPosix}/`) ||
+                posixRel.startsWith(`${docsRootPosix}\\`);
+            if (!under) {
+                return path.join(outBase, locale, relPath);
+            }
+            const rest = posixRel === docsRootPosix ? "" : posixRel.slice(docsRootPosix.length + 1);
+            return path.join(outBase, locale, DOCUSAURUS_PLUGIN, rest);
+        }
+        case "flat": {
+            const parsed = path.posix.parse(posixRel);
+            const stem = parsed.name;
+            const ext = parsed.ext;
+            if (mo.flatPreserveRelativeDir) {
+                const dir = parsed.dir;
+                if (dir && dir !== ".") {
+                    return path.join(outBase, dir, `${stem}.${locale}${ext}`);
+                }
+            }
+            return path.join(outBase, `${stem}.${locale}${ext}`);
+        }
+        default:
+            return path.join(outBase, locale, relPath);
+    }
+}
+/**
+ * Resolve absolute output path for a translated documentation artifact.
+ */
+export function resolveDocumentationOutputPath(config, cwd, locale, relPath, kind) {
+    const doc = config.documentation;
+    const outBaseResolved = path.resolve(cwd, doc.outputDir);
+    const mo = doc.markdownOutput;
+    const docsRootRaw = mo.docsRoot?.trim() || "docs";
+    const docsRootResolved = path.resolve(cwd, docsRootRaw);
+    const tmpl = templateForKind(config, kind);
+    let abs;
+    if (tmpl && tmpl.length > 0) {
+        const expanded = expandPathTemplate(tmpl, {
+            outputDir: outBaseResolved,
+            locale,
+            relPath,
+            docsRoot: docsRootResolved,
+        });
+        abs = path.isAbsolute(expanded) ? path.normalize(expanded) : path.resolve(cwd, expanded);
+    }
+    else {
+        abs = resolveByStyle(config, cwd, locale, relPath, kind);
+    }
+    assertOutputWithinRoot(abs, outBaseResolved);
+    return abs;
+}
+/** Whether to run relative link rewriting for flat markdown outputs. */
+export function shouldRewriteFlatMarkdownLinks(config) {
+    const mo = config.documentation.markdownOutput;
+    if (mo.rewriteRelativeLinks !== undefined) {
+        return mo.rewriteRelativeLinks;
+    }
+    if (mo.pathTemplate?.trim()) {
+        return false;
+    }
+    return mo.style === "flat";
+}
+//# sourceMappingURL=output-paths.js.map

package/dist/core/output-paths.js.map

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

package/dist/core/prompt-builder.d.ts

@@ -0,0 +1,62 @@
+import type { Segment } from "./types.js";
+import { PROMPTS, type PromptStrings, type DocumentPromptStrings, type UIPromptStrings } from "./prompts.js";
+/**
+ * Document translation prompts follow common OpenRouter-style doc-translation patterns
+ * (`buildBatchPrompt`, `buildPrompt`, `MARKDOWN_PRESERVATION_RULES`). Adjust here when prompt strategy changes.
+ *
+ * For **JSON** (Docusaurus locale files) and **SVG** text segments, we append context addenda so the same
+ * `<t id="N">` / `<translate>` response shape stays robust outside pure markdown.
+ *
+ * Prompt **content** lives in `prompts.ts`; this module handles assembly and parsing only.
+ */
+export type DocumentPromptContentType = "markdown" | "json" | "svg";
+export type DocumentBatchResponseFormat = "xml-tags" | "json-array" | "json-object";
+export type { PromptStrings, DocumentPromptStrings, UIPromptStrings };
+export { PROMPTS };
+/**
+ * Extra system-prompt guidance so models do not break CommonMark / GFM structure.
+ * Fenced ``` / ~~~ blocks are not sent to the model (`DocumentSplitter` marks them non-translatable).
+ * @see docs/OVERVIEW.md (document translation)
+ */
+export declare const MARKDOWN_PRESERVATION_RULES: string;
+/** Appended for locale JSON message segments (batch `<t id="N">` response format). */
+export declare const JSON_SEGMENT_CONTEXT_ADDENDUM: string;
+/** Appended for SVG <text>/<tspan>/<title> extracted segments. */
+export declare const SVG_SEGMENT_CONTEXT_ADDENDUM: string;
+export interface PromptBuilderOptions {
+    sourceLanguageLabel: string;
+    targetLanguageLabel: string;
+    glossaryHints: string[];
+}
+export declare function buildDocumentBatchPrompt(segments: Segment[], opts: PromptBuilderOptions, contentType?: DocumentPromptContentType, responseFormat?: DocumentBatchResponseFormat): {
+    systemPrompt: string;
+    userContent: string;
+};
+export declare function buildDocumentSinglePrompt(content: string, opts: PromptBuilderOptions, contentType?: DocumentPromptContentType): {
+    systemPrompt: string;
+    userContent: string;
+};
+export declare function buildUIPromptMessages(texts: string[], opts: {
+    sourceLanguageLabel: string;
+    targetLanguageLabel: string;
+    glossaryHints?: string[];
+}): {
+    systemPrompt: string;
+    userContent: string;
+};
+/** Base class for prompt/response parse errors that carry the raw model output. */
+export declare class PromptParseError extends Error {
+    readonly rawResponse: string;
+    constructor(message: string, rawResponse: string);
+}
+export declare class DocumentBatchJsonParseError extends PromptParseError {
+    constructor(message: string, rawResponse: string);
+}
+export declare class UIJsonArrayParseError extends PromptParseError {
+    constructor(message: string, rawResponse: string);
+}
+export declare function parseBatchTranslationResponse(response: string, segmentCount: number, rawResponse: string): Map<number, string>;
+export declare function parseBatchJsonArrayResponse(content: string, expectedLength: number): Map<number, string>;
+export declare function parseBatchJsonObjectResponse(content: string, expectedLength: number): Map<number, string>;
+export declare function parseUIJsonArrayResponse(content: string, expectedLength: number): string[];
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/core/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/core/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EACL,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AACpE,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAEpF,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,CAAC;AAInB;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAA8C,CAAC;AAEzF,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,EAAE,MAA6C,CAAC;AAE1F,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,EAAE,MAA4C,CAAC;AAIxF,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA4CD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,oBAAoB,EAC1B,WAAW,GAAE,yBAAsC,EACnD,cAAc,GAAE,2BAAwC,GACvD;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAuC/C;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,oBAAoB,EAC1B,WAAW,GAAE,yBAAsC,GAClD;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA8B/C;AAID,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE;IACJ,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,GACA;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAW/C;AAID,mFAAmF;AACnF,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM;CAKtC;AAED,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAIjD;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAIjD;AAYD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBrB;AAID,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BrB;AAID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB1F"}

package/dist/core/prompt-builder.js

@@ -0,0 +1,232 @@
+import { BatchTranslationError } from "./types.js";
+import { PROMPTS, } from "./prompts.js";
+export { PROMPTS };
+// ── Backward-compatible exported constants (derived from JSON) ────────────
+/**
+ * Extra system-prompt guidance so models do not break CommonMark / GFM structure.
+ * Fenced ``` / ~~~ blocks are not sent to the model (`DocumentSplitter` marks them non-translatable).
+ * @see docs/OVERVIEW.md (document translation)
+ */
+export const MARKDOWN_PRESERVATION_RULES = PROMPTS.document.markdownPreservation;
+/** Appended for locale JSON message segments (batch `<t id="N">` response format). */
+export const JSON_SEGMENT_CONTEXT_ADDENDUM = PROMPTS.document.jsonSegmentAddendum;
+/** Appended for SVG <text>/<tspan>/<title> extracted segments. */
+export const SVG_SEGMENT_CONTEXT_ADDENDUM = PROMPTS.document.svgSegmentAddendum;
+// ── Shared helpers ────────────────────────────────────────────────────────
+function buildGlossaryBlock(hints, preamble) {
+    const filtered = hints.filter((h) => h.trim().length > 0);
+    if (filtered.length === 0)
+        return "";
+    const prefix = preamble ? `\n\n${preamble}` : "";
+    return `${prefix}\n<glossary>\n${filtered.join("\n")}\n</glossary>\n`;
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function unescapeXml(text) {
+    return text
+        .replace(/&quot;/g, '"')
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
+/** Shared rules block for document batch/single prompts (all document types). */
+function documentCoreRulesBlock(opts) {
+    return `Translate from ${opts.sourceLanguageLabel} to ${opts.targetLanguageLabel}.
+
+${PROMPTS.document.coreRules}
+
+${PROMPTS.document.markdownPreservation}`;
+}
+function contentTypeAddendum(contentType) {
+    if (contentType === "json")
+        return PROMPTS.document.jsonSegmentAddendum;
+    if (contentType === "svg")
+        return PROMPTS.document.svgSegmentAddendum;
+    return "";
+}
+// ── Document prompt builders ──────────────────────────────────────────────
+export function buildDocumentBatchPrompt(segments, opts, contentType = "markdown", responseFormat = "xml-tags") {
+    const glossary = buildGlossaryBlock(opts.glossaryHints);
+    const addendum = contentTypeAddendum(contentType);
+    if (responseFormat === "json-array") {
+        const userContent = JSON.stringify(segments.map((s) => s.content), null, 2);
+        const systemPrompt = `${documentCoreRulesBlock(opts)}${addendum}
+
+${PROMPTS.document.batchJsonArrayInstruction}${glossary}`;
+        return { systemPrompt, userContent };
+    }
+    if (responseFormat === "json-object") {
+        const payload = {};
+        for (let i = 0; i < segments.length; i++) {
+            payload[String(i)] = segments[i]?.content ?? "";
+        }
+        const userContent = JSON.stringify(payload, null, 2);
+        const systemPrompt = `${documentCoreRulesBlock(opts)}${addendum}
+
+${PROMPTS.document.batchJsonObjectInstruction}${glossary}`;
+        return { systemPrompt, userContent };
+    }
+    const segBlocks = segments
+        .map((s, i) => `<seg id="${i}">${escapeXml(s.content)}</seg>`)
+        .join("\n");
+    const systemPrompt = `${documentCoreRulesBlock(opts)}${addendum}
+
+${PROMPTS.document.batchXmlInstruction}${glossary}`;
+    const userContent = `<segments>
+${segBlocks}
+</segments>`;
+    return { systemPrompt, userContent };
+}
+export function buildDocumentSinglePrompt(content, opts, contentType = "markdown") {
+    const glossary = buildGlossaryBlock(opts.glossaryHints);
+    const addendum = contentTypeAddendum(contentType);
+    const footer = PROMPTS.document.translateFooter;
+    let systemPrompt;
+    if (contentType === "markdown") {
+        const example = PROMPTS.document.markdownExample.replace(/\{\{targetLang\}\}/g, opts.targetLanguageLabel);
+        systemPrompt = `${documentCoreRulesBlock(opts)}
+
+${example}
+
+---
+${footer}${glossary}`;
+    }
+    else {
+        systemPrompt = `${documentCoreRulesBlock(opts)}${addendum}
+
+---
+${footer}${glossary}`;
+    }
+    const userContent = `<translate>
+${content}
+</translate>`;
+    return { systemPrompt, userContent };
+}
+// ── UI prompt builder ─────────────────────────────────────────────────────
+export function buildUIPromptMessages(texts, opts) {
+    const systemBase = PROMPTS.ui.systemPrompt.join("\n");
+    const glossaryBlock = buildGlossaryBlock(opts.glossaryHints ?? [], PROMPTS.ui.glossaryPreamble);
+    const userContent = `Translate these ${texts.length} UI strings from ${opts.sourceLanguageLabel} to ${opts.targetLanguageLabel} and return a JSON array:
+
+${JSON.stringify(texts, null, 2)}
+
+Respond with ONLY the JSON array. No other text.`;
+    return { systemPrompt: systemBase + glossaryBlock, userContent };
+}
+// ── Response parsing: shared helpers ──────────────────────────────────────
+/** Base class for prompt/response parse errors that carry the raw model output. */
+export class PromptParseError extends Error {
+    constructor(message, rawResponse) {
+        super(message);
+        this.rawResponse = rawResponse;
+        this.name = "PromptParseError";
+    }
+}
+export class DocumentBatchJsonParseError extends PromptParseError {
+    constructor(message, rawResponse) {
+        super(message, rawResponse);
+        this.name = "DocumentBatchJsonParseError";
+    }
+}
+export class UIJsonArrayParseError extends PromptParseError {
+    constructor(message, rawResponse) {
+        super(message, rawResponse);
+        this.name = "UIJsonArrayParseError";
+    }
+}
+function cleanJsonResponse(content) {
+    return content
+        .trim()
+        .replace(/^```(?:json)?\s*/i, "")
+        .replace(/\s*```$/i, "")
+        .trim();
+}
+// ── XML batch parser ──────────────────────────────────────────────────────
+export function parseBatchTranslationResponse(response, segmentCount, rawResponse) {
+    const regex = /<t\s+id="(\d+)"[^>]*>\s*([\s\S]*?)\s*<\/t>/g;
+    const byIndex = new Map();
+    let match;
+    while ((match = regex.exec(response)) !== null) {
+        const id = parseInt(match[1], 10);
+        const rawContent = match[2].trim();
+        byIndex.set(id, unescapeXml(rawContent));
+    }
+    if (byIndex.size !== segmentCount) {
+        throw new BatchTranslationError(segmentCount, byIndex.size, rawResponse);
+    }
+    for (let i = 0; i < segmentCount; i++) {
+        if (byIndex.get(i) === undefined) {
+            throw new BatchTranslationError(segmentCount, byIndex.size, rawResponse);
+        }
+    }
+    return byIndex;
+}
+// ── JSON batch parsers (unified) ──────────────────────────────────────────
+export function parseBatchJsonArrayResponse(content, expectedLength) {
+    const cleaned = cleanJsonResponse(content);
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (e) {
+        throw new DocumentBatchJsonParseError(`Document batch (json-array): invalid JSON (${e instanceof Error ? e.message : String(e)})`, content);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new DocumentBatchJsonParseError("Document batch (json-array): response is not a JSON array", content);
+    }
+    if (parsed.length !== expectedLength) {
+        throw new BatchTranslationError(expectedLength, parsed.length, content);
+    }
+    const out = new Map();
+    for (let i = 0; i < expectedLength; i++) {
+        out.set(i, String(parsed[i]));
+    }
+    return out;
+}
+export function parseBatchJsonObjectResponse(content, expectedLength) {
+    const cleaned = cleanJsonResponse(content);
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (e) {
+        throw new DocumentBatchJsonParseError(`Document batch (json-object): invalid JSON (${e instanceof Error ? e.message : String(e)})`, content);
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new DocumentBatchJsonParseError("Document batch (json-object): response is not a JSON object", content);
+    }
+    const record = parsed;
+    const out = new Map();
+    for (let i = 0; i < expectedLength; i++) {
+        const key = String(i);
+        if (!(key in record)) {
+            throw new BatchTranslationError(expectedLength, out.size, content);
+        }
+        out.set(i, String(record[key]));
+    }
+    return out;
+}
+// ── UI JSON array parser ──────────────────────────────────────────────────
+export function parseUIJsonArrayResponse(content, expectedLength) {
+    const cleaned = cleanJsonResponse(content);
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (e) {
+        throw new UIJsonArrayParseError(`UI batch: invalid JSON (${e instanceof Error ? e.message : String(e)})`, content);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new UIJsonArrayParseError("UI batch: response is not a JSON array", content);
+    }
+    if (parsed.length !== expectedLength) {
+        throw new UIJsonArrayParseError(`UI batch: expected ${expectedLength} strings, got ${parsed.length}`, content);
+    }
+    return parsed.map((x) => String(x));
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/core/prompt-builder.js.map

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

package/dist/core/prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Centralized prompt strings for all translation modes.
+ *
+ * Edit prompt **content** here; assembly logic lives in `prompt-builder.ts`.
+ * Follows the same separation pattern as transrewrt `prompts.json`.
+ */
+export interface DocumentPromptStrings {
+    coreRules: string;
+    markdownPreservation: string;
+    jsonSegmentAddendum: string;
+    svgSegmentAddendum: string;
+    markdownExample: string;
+    translateFooter: string;
+    batchXmlInstruction: string;
+    batchJsonArrayInstruction: string;
+    batchJsonObjectInstruction: string;
+}
+export interface UIPromptStrings {
+    systemPrompt: string[];
+    glossaryPreamble: string;
+}
+export interface PromptStrings {
+    document: DocumentPromptStrings;
+    ui: UIPromptStrings;
+}
+export declare const PROMPTS: PromptStrings;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/core/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,EAAE,EAAE,eAAe,CAAC;CACrB;AAID,eAAO,MAAM,OAAO,EAAE,aA+DrB,CAAC"}

package/dist/core/prompts.js

@@ -0,0 +1,57 @@
+/**
+ * Centralized prompt strings for all translation modes.
+ *
+ * Edit prompt **content** here; assembly logic lives in `prompt-builder.ts`.
+ * Follows the same separation pattern as transrewrt `prompts.json`.
+ */
+// ── Prompt content ────────────────────────────────────────────────────────
+export const PROMPTS = {
+    document: {
+        coreRules: "Rules: Keep headers (###), variables, URLs, line breaks, markdown formatting, placeholders {{X}} unchanged. Preserve exactly (do not translate or alter): {{ADM_OPEN_N}}, {{ADM_END_N}}, {{URL_N}}, {{BLD_N}}, {{ILC_N}}, {{ANC_N}}, {{HDG_N}}, {{GLS_N}}, {{IT}}, {{IU}}, {{SE}}, {{SU}}, {{ST}} (for GLS and similar tokens, N is any non-negative integer; copy the full token character-for-character). Copy each placeholder character-for-character; do not change underscores, hyphens, or digits inside {{...}} tokens. Translate only title/description in front matter. If a <glossary> block appears below, you must preserve each suggested target wording when the source matches or contains that term (use that wording exactly; do not paraphrase or substitute synonyms). Maintain coherence for all other phrasing.",
+        markdownPreservation: "Markdown structure: Preserve heading levels (#\u2013######), list markers and indentation, blockquotes (>), horizontal rules, and meaningful line breaks. Inline `` `code` `` is sent as {{ILC_N}}; bold+code **`code`** as {{BLD_N}} \u2014 copy those tokens exactly. Keep **bold** and *italic* intact with balanced delimiters. Every **bold** span in the source must have a corresponding **bold** span in the translation \u2014 even when the bolded word translates to a short conjunction, particle, suffix, or single word in the target language; never remove bold to simplify the sentence. In [visible text](url), ![alt](path), and HTML like <img \u2026> / <a \u2026>, translate only the visible link text or alt; keep URLs, paths, angle-bracket links, and attribute names unchanged. Preserve GFM pipe tables (| cells |).",
+        jsonSegmentAddendum: `
+Context: Segments are end-user-visible strings from Docusaurus or app locale JSON (messages, labels, descriptions, sidebar titles).
+- Preserve interpolation and markup exactly: {name}, {{var}}, ICU/plural patterns, HTML inside strings, Markdown fragments if present, %s / %d style placeholders.
+- Do not add or remove braces, brackets, or escape sequences; output only the translated human text inside each <t id="N"> block - never a full JSON object.`,
+        svgSegmentAddendum: `
+Context: Segments are human-readable text from SVG (text elements, titles).
+- Preserve entities and characters needed for correct display (&amp;, &#\u2026;, etc.) when they appear in the source.
+- Keep short labels short when the source is short (layout).
+- Translate only readable words; do not emit SVG/XML wrapper tags unless they were part of the segment source.`,
+        markdownExample: `Example (same structure in {{targetLang}}):
+Input:
+### Section title
+Body line with \`CODE\` and {{PLACEHOLDER}}.
+
+Output:
+### [Translated section title]
+[Translated body line with \`CODE\` and {{PLACEHOLDER}}.]`,
+        translateFooter: "Translate the content inside the <translate> tags below. Output ONLY the translated text - do NOT include <translate> or </translate> tags in your response. No explanations or extra markup.",
+        batchXmlInstruction: 'Each <seg id="N"> element contains one source segment. Reply with ONLY <t id="N">translation</t> blocks, one per segment, preserving the same N id. No other text.',
+        batchJsonArrayInstruction: `Each item in the JSON array is one source segment in order (index 0..N-1).
+Reply with ONLY a valid JSON array of translated strings, preserving array length and index order exactly.
+Do not return XML tags, markdown, code fences, comments, or any extra text.`,
+        batchJsonObjectInstruction: `The JSON object maps segment index to source text (keys "0".."N-1").
+Reply with ONLY a valid JSON object with the exact same keys, each value translated.
+Do not change keys, add keys, remove keys, or return XML tags/markdown/code fences/extra text.`,
+    },
+    ui: {
+        systemPrompt: [
+            "You are a professional UI/UX translator specializing in software interfaces.",
+            "",
+            "RULES:",
+            "- Translate UI labels, buttons, tooltips, menu items, and status messages",
+            "- Preserve capitalization style (Title Case stays Title Case, ALL CAPS stays ALL CAPS)",
+            "- Preserve leading/trailing whitespace exactly",
+            "- Keep placeholders unchanged: {{variable}}, {0}, %s, %d, :value, and {{GLS_N}} (any non-negative integer N; copy exactly)",
+            "- Keep HTML tags unchanged: <strong>, <br/>, etc.",
+            "- Use informal/familiar tone where natural for the target language",
+            "- Short strings (1-3 words) must stay short - do not expand them",
+            "- You MUST respond with ONLY a valid JSON array, nothing else",
+            "- No markdown, no code fences, no explanation, no preamble, no postamble",
+            "- First character of your response must be [ and last character must be ]",
+        ],
+        glossaryPreamble: "Glossary - when a string matches or contains a term below, you must use the suggested target wording exactly (preserve brand names and terminology; do not paraphrase, translate around, or substitute synonyms). Do not output glossary lines; respond with only the JSON array as required above.",
+    },
+};
+//# sourceMappingURL=prompts.js.map

package/dist/core/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,6EAA6E;AAE7E,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,QAAQ,EAAE;QACR,SAAS,EACP,uyBAAuyB;QAEzyB,oBAAoB,EAClB,mzBAAmzB;QAErzB,mBAAmB,EAAE;;;6JAGoI;QAEzJ,kBAAkB,EAAE;;;;+GAIuF;QAE3G,eAAe,EAAE;;;;;;;0DAOqC;QAEtD,eAAe,EACb,+LAA+L;QAEjM,mBAAmB,EACjB,oKAAoK;QAEtK,yBAAyB,EAAE;;4EAE6C;QAExE,0BAA0B,EAAE;;+FAE+D;KAC5F;IAED,EAAE,EAAE;QACF,YAAY,EAAE;YACZ,8EAA8E;YAC9E,EAAE;YACF,QAAQ;YACR,2EAA2E;YAC3E,wFAAwF;YACxF,gDAAgD;YAChD,4HAA4H;YAC5H,mDAAmD;YACnD,oEAAoE;YACpE,kEAAkE;YAClE,+DAA+D;YAC/D,0EAA0E;YAC1E,2EAA2E;SAC5E;QAED,gBAAgB,EACd,qSAAqS;KACxS;CACF,CAAC"}

package/dist/core/svg-asset-paths.d.ts

@@ -0,0 +1,40 @@
+import type { I18nConfig } from "./types.js";
+export interface SvgPathTemplateContext {
+    /** Resolved absolute path of `svg.outputDir`. */
+    outputDir: string;
+    locale: string;
+    /** Path of the source file relative to cwd (posix). */
+    relPath: string;
+    /** Path under the configured `sourcePath` root (posix), e.g. `icons/a.svg`. */
+    relativeToSourceRoot: string;
+}
+/**
+ * Expand `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`,
+ * `{relativeToSourceRoot}` (same as path under `svg.sourcePath`).
+ */
+export declare function expandSvgPathTemplate(template: string, ctx: SvgPathTemplateContext): string;
+/**
+ * Absolute path for a translated SVG asset (`translate-svg` command).
+ *
+ * - With `svg.pathTemplate`: expanded path (relative to cwd or absolute), constrained under `svg.outputDir`.
+ * - Else `flat`: `{outputDir}/{stem}.{locale}.svg`
+ * - Else `nested`: `{outputDir}/{locale}/{relPathFromSourceRoot}`
+ */
+export declare function resolveSvgAssetOutputPath(config: I18nConfig, cwd: string, locale: string, 
+/** Path relative to cwd (posix), e.g. `images/foo.svg` */
+relPathFromCwd: string, 
+/** Path relative to the `sourcePath` root that contained this file (posix), e.g. `foo.svg` or `icons/a.svg` */
+relPathFromSourceRoot: string): string;
+/**
+ * Namespaced key for `file_tracking` (and file-level cache skip) for standalone SVG assets.
+ * Do not use for `translations.filepath` — use {@link svgTranslationFilepathMetadata} instead.
+ */
+export declare function svgAssetCacheFilepath(relPathFromCwdPosix: string): string;
+/** Cwd-relative posix path for `translations.filepath` metadata (no `svg-assets:` prefix). */
+export declare function svgTranslationFilepathMetadata(relPathFromCwd: string): string;
+/**
+ * Path under a configured `svg.sourcePath` root (posix), for nested output layout.
+ * Returns `null` if `fileRelCwd` is not under any root.
+ */
+export declare function relPathUnderSvgSource(fileRelCwd: string, sourceRoots: string[]): string | null;
+//# sourceMappingURL=svg-asset-paths.d.ts.map

package/dist/core/svg-asset-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-asset-paths.d.ts","sourceRoot":"","sources":["../../src/core/svg-asset-paths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAY7C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAuB3F;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM;AACd,0DAA0D;AAC1D,cAAc,EAAE,MAAM;AACtB,+GAA+G;AAC/G,qBAAqB,EAAE,MAAM,GAC5B,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAa9F"}