ai-i18n-tools 1.0.0

package/dist/processors/glossary-force-placeholders.d.ts

@@ -0,0 +1,12 @@
+import type { Glossary } from "../glossary/glossary.js";
+export declare function glossaryForcePlaceholderToken(index: number): string;
+/**
+ * Replace forced glossary source terms with opaque placeholders before translation; restore injects target wording.
+ * Uses the same word-boundary and longest-first non-overlap rules as glossary hints.
+ */
+export declare function protectGlossaryForcedTerms(text: string, glossary: Glossary, locale: string): {
+    text: string;
+    replacements: string[];
+};
+export declare function restoreGlossaryForcedTerms(text: string, replacements: string[]): string;
+//# sourceMappingURL=glossary-force-placeholders.d.ts.map

package/dist/processors/glossary-force-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary-force-placeholders.d.ts","sourceRoot":"","sources":["../../src/processors/glossary-force-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAKxD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CA4C1C;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAUvF"}

package/dist/processors/glossary-force-placeholders.js

@@ -0,0 +1,58 @@
+const PLACEHOLDER_PREFIX = "{{GLS_";
+const PLACEHOLDER_SUFFIX = "}}";
+export function glossaryForcePlaceholderToken(index) {
+    return `${PLACEHOLDER_PREFIX}${index}${PLACEHOLDER_SUFFIX}`;
+}
+/**
+ * Replace forced glossary source terms with opaque placeholders before translation; restore injects target wording.
+ * Uses the same word-boundary and longest-first non-overlap rules as glossary hints.
+ */
+export function protectGlossaryForcedTerms(text, glossary, locale) {
+    const entries = glossary.getForcedTermEntriesForLocale(locale);
+    if (entries.length === 0) {
+        return { text, replacements: [] };
+    }
+    const textLower = text.toLowerCase();
+    const matches = [];
+    const matchedPositions = new Set();
+    for (const { termLower, replacement } of entries) {
+        let index = 0;
+        while ((index = textLower.indexOf(termLower, index)) !== -1) {
+            const beforeChar = index > 0 ? textLower[index - 1] : " ";
+            const afterChar = textLower[index + termLower.length] || " ";
+            const isWordBoundary = /[\s\p{P}]/u.test(beforeChar) && /[\s\p{P}]/u.test(afterChar);
+            if (!isWordBoundary) {
+                index++;
+                continue;
+            }
+            const positions = Array.from({ length: termLower.length }, (_, i) => index + i);
+            const hasOverlap = positions.some((pos) => matchedPositions.has(pos));
+            if (!hasOverlap) {
+                matches.push({ start: index, end: index + termLower.length, replacement });
+                positions.forEach((pos) => matchedPositions.add(pos));
+            }
+            index++;
+        }
+    }
+    matches.sort((a, b) => a.start - b.start);
+    const replacements = matches.map((m) => m.replacement);
+    let out = text;
+    for (let j = matches.length - 1; j >= 0; j--) {
+        const m = matches[j];
+        const ph = glossaryForcePlaceholderToken(j);
+        out = out.slice(0, m.start) + ph + out.slice(m.end);
+    }
+    return { text: out, replacements };
+}
+export function restoreGlossaryForcedTerms(text, replacements) {
+    if (replacements.length === 0) {
+        return text;
+    }
+    let out = text;
+    for (let j = 0; j < replacements.length; j++) {
+        const token = glossaryForcePlaceholderToken(j);
+        out = out.split(token).join(replacements[j]);
+    }
+    return out;
+}
+//# sourceMappingURL=glossary-force-placeholders.js.map

package/dist/processors/glossary-force-placeholders.js.map

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

package/dist/processors/inline-code-placeholders.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Replace each inline code span `` `...` `` with {{ILC_N}} before translation; restore injects the original span.
+ * Runs after bold-wrapped code (`**`...`**` → {{BLD_N}}) so remaining backticks are standalone code only.
+ */
+export interface ProtectedInlineCodeResult {
+    protected: string;
+    ilcMap: string[];
+}
+export declare function protectInlineCodeSpans(text: string): ProtectedInlineCodeResult;
+export declare function restoreInlineCodeSpans(text: string, ilcMap: string[]): string;
+//# sourceMappingURL=inline-code-placeholders.d.ts.map

package/dist/processors/inline-code-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-code-placeholders.d.ts","sourceRoot":"","sources":["../../src/processors/inline-code-placeholders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2CH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAoC9E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAU7E"}

package/dist/processors/inline-code-placeholders.js

@@ -0,0 +1,87 @@
+/**
+ * Replace each inline code span `` `...` `` with {{ILC_N}} before translation; restore injects the original span.
+ * Runs after bold-wrapped code (`**`...`**` → {{BLD_N}}) so remaining backticks are standalone code only.
+ */
+const PLACEHOLDER_PREFIX = "{{ILC_";
+const PLACEHOLDER_SUFFIX = "}}";
+function readRun(text, start, marker) {
+    let i = start;
+    while (i < text.length && text[i] === marker) {
+        i++;
+    }
+    return i - start;
+}
+function findPlaceholderEnd(text, start) {
+    if (text[start] !== "{" || text[start + 1] !== "{") {
+        return -1;
+    }
+    let i = start + 2;
+    while (i < text.length - 1) {
+        if (text[i] === "}" && text[i + 1] === "}") {
+            return i + 2;
+        }
+        i++;
+    }
+    return -1;
+}
+function findCodeSpanEnd(text, tickStart, tickCount) {
+    let i = tickStart + tickCount;
+    while (i < text.length) {
+        if (text[i] !== "`") {
+            i++;
+            continue;
+        }
+        const run = readRun(text, i, "`");
+        if (run === tickCount) {
+            return i + tickCount;
+        }
+        i += run;
+    }
+    return -1;
+}
+export function protectInlineCodeSpans(text) {
+    const ilcMap = [];
+    const out = [];
+    let i = 0;
+    while (i < text.length) {
+        if (text[i] === "{" && text[i + 1] === "{") {
+            const end = findPlaceholderEnd(text, i);
+            if (end !== -1) {
+                out.push(text.slice(i, end));
+                i = end;
+                continue;
+            }
+        }
+        if (text[i] === "`") {
+            const tickCount = readRun(text, i, "`");
+            const end = findCodeSpanEnd(text, i, tickCount);
+            if (end !== -1) {
+                const original = text.slice(i, end);
+                const ph = `${PLACEHOLDER_PREFIX}${ilcMap.length}${PLACEHOLDER_SUFFIX}`;
+                ilcMap.push(original);
+                out.push(ph);
+                i = end;
+            }
+            else {
+                out.push(text.slice(i, i + tickCount));
+                i += tickCount;
+            }
+            continue;
+        }
+        out.push(text[i]);
+        i++;
+    }
+    return { protected: out.join(""), ilcMap };
+}
+export function restoreInlineCodeSpans(text, ilcMap) {
+    if (ilcMap.length === 0) {
+        return text;
+    }
+    let restored = text;
+    for (let j = 0; j < ilcMap.length; j++) {
+        const placeholder = `${PLACEHOLDER_PREFIX}${j}${PLACEHOLDER_SUFFIX}`;
+        restored = restored.split(placeholder).join(ilcMap[j]);
+    }
+    return restored;
+}
+//# sourceMappingURL=inline-code-placeholders.js.map

package/dist/processors/inline-code-placeholders.js.map

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

package/dist/processors/placeholder-handler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Chains placeholder protection for document translation:
+ * admonitions → doc anchors → markdown URLs → **`inline`** (whole span) → remaining `` `code` `` → emphasis.
+ * Restore is the inverse order.
+ */
+export declare class PlaceholderHandler {
+    protectForTranslation(text: string): {
+        text: string;
+        openMap: string[];
+        endMap: string[];
+        htmlAnchors: string[];
+        docusaurusHeadingIds: string[];
+        urlMap: string[];
+        boldCodeMap: string[];
+        ilcMap: string[];
+    };
+    restoreAfterTranslation(text: string, state: {
+        openMap: string[];
+        endMap: string[];
+        htmlAnchors: string[];
+        docusaurusHeadingIds: string[];
+        urlMap: string[];
+        boldCodeMap: string[];
+        ilcMap: string[];
+    }): string;
+    protectUrls(text: string): {
+        text: string;
+        urlMap: string[];
+    };
+    restoreUrls(text: string, urlMap: string[]): string;
+    protectAdmonitions(text: string): {
+        text: string;
+        openMap: string[];
+        endMap: string[];
+    };
+    restoreAdmonitions(text: string, openMap: string[], endMap: string[]): string;
+}
+//# sourceMappingURL=placeholder-handler.d.ts.map

package/dist/processors/placeholder-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-handler.d.ts","sourceRoot":"","sources":["../../src/processors/placeholder-handler.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;QACnC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAmBD,uBAAuB,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,GACA,MAAM;IAUT,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAK7D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;IAInD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAKvF,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;CAG9E"}

package/dist/processors/placeholder-handler.js

@@ -0,0 +1,55 @@
+import { protectAdmonitionSyntax, restoreAdmonitionSyntax } from "./admonition-placeholders.js";
+import { protectDocAnchors, restoreDocAnchors } from "./anchor-placeholders.js";
+import { protectBoldWrappedInlineCode, restoreBoldWrappedInlineCode, } from "./bold-code-placeholders.js";
+import { protectInlineCodeSpans, restoreInlineCodeSpans } from "./inline-code-placeholders.js";
+import { protectMarkdownEmphasis, restoreMarkdownEmphasis } from "./emphasis-placeholders.js";
+import { protectMarkdownUrls, restoreMarkdownUrls } from "./url-placeholders.js";
+/**
+ * Chains placeholder protection for document translation:
+ * admonitions → doc anchors → markdown URLs → **`inline`** (whole span) → remaining `` `code` `` → emphasis.
+ * Restore is the inverse order.
+ */
+export class PlaceholderHandler {
+    protectForTranslation(text) {
+        const ad = protectAdmonitionSyntax(text);
+        const doc = protectDocAnchors(ad.protected);
+        const urls = protectMarkdownUrls(doc.protected);
+        const boldCode = protectBoldWrappedInlineCode(urls.protected);
+        const ilc = protectInlineCodeSpans(boldCode.protected);
+        const emphasis = protectMarkdownEmphasis(ilc.protected);
+        return {
+            text: emphasis.protected,
+            openMap: ad.openMap,
+            endMap: ad.endMap,
+            htmlAnchors: doc.htmlAnchors,
+            docusaurusHeadingIds: doc.docusaurusHeadingIds,
+            urlMap: urls.urlMap,
+            boldCodeMap: boldCode.boldCodeMap,
+            ilcMap: ilc.ilcMap,
+        };
+    }
+    restoreAfterTranslation(text, state) {
+        let s = restoreMarkdownEmphasis(text);
+        s = restoreInlineCodeSpans(s, state.ilcMap);
+        s = restoreBoldWrappedInlineCode(s, state.boldCodeMap);
+        s = restoreMarkdownUrls(s, state.urlMap);
+        s = restoreDocAnchors(s, state.htmlAnchors, state.docusaurusHeadingIds);
+        s = restoreAdmonitionSyntax(s, state.openMap, state.endMap);
+        return s;
+    }
+    protectUrls(text) {
+        const r = protectMarkdownUrls(text);
+        return { text: r.protected, urlMap: r.urlMap };
+    }
+    restoreUrls(text, urlMap) {
+        return restoreMarkdownUrls(text, urlMap);
+    }
+    protectAdmonitions(text) {
+        const r = protectAdmonitionSyntax(text);
+        return { text: r.protected, openMap: r.openMap, endMap: r.endMap };
+    }
+    restoreAdmonitions(text, openMap, endMap) {
+        return restoreAdmonitionSyntax(text, openMap, endMap);
+    }
+}
+//# sourceMappingURL=placeholder-handler.js.map

package/dist/processors/placeholder-handler.js.map

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

package/dist/processors/translation-placeholder-leaks.d.ts

@@ -0,0 +1,2 @@
+export declare function hasInternalPlaceholderLeak(text: string): boolean;
+//# sourceMappingURL=translation-placeholder-leaks.d.ts.map

package/dist/processors/translation-placeholder-leaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-placeholder-leaks.d.ts","sourceRoot":"","sources":["../../src/processors/translation-placeholder-leaks.ts"],"names":[],"mappings":"AAOA,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/dist/processors/translation-placeholder-leaks.js

@@ -0,0 +1,9 @@
+/**
+ * After {@link PlaceholderHandler.restoreAfterTranslation}, these substrings must not remain
+ * in markdown output (they indicate the model corrupted or omitted an internal token).
+ */
+const LEAK_PATTERN = /\{\{\s*(?:HDG[-_]?\d+|ANC[-_]?\d+|URL[-_]?\d+|BLD[-_]?\d+|ILC[-_]?\d+|ADM_(?:OPEN|END)_\d+|GLS[-_]?\d+|IT|IU|SE|SU|ST)\s*\}\}/i;
+export function hasInternalPlaceholderLeak(text) {
+    return LEAK_PATTERN.test(text);
+}
+//# sourceMappingURL=translation-placeholder-leaks.js.map

package/dist/processors/translation-placeholder-leaks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-placeholder-leaks.js","sourceRoot":"","sources":["../../src/processors/translation-placeholder-leaks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,YAAY,GAChB,gIAAgI,CAAC;AAEnI,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/processors/url-placeholders.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Protect markdown link destinations from translation (`](url)` → placeholder).
+ */
+export interface ProtectedUrlResult {
+    protected: string;
+    urlMap: string[];
+}
+export declare function protectMarkdownUrls(text: string): ProtectedUrlResult;
+export declare function restoreMarkdownUrls(text: string, urlMap: string[]): string;
+//# sourceMappingURL=url-placeholders.d.ts.map

package/dist/processors/url-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-placeholders.d.ts","sourceRoot":"","sources":["../../src/processors/url-placeholders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAYpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAU1E"}

package/dist/processors/url-placeholders.js

@@ -0,0 +1,29 @@
+/**
+ * Protect markdown link destinations from translation (`](url)` → placeholder).
+ */
+const PLACEHOLDER_PREFIX = "{{URL_";
+const PLACEHOLDER_SUFFIX = "}}";
+const MARKDOWN_URL_REGEX = /\]\(([^)]*)\)/g;
+export function protectMarkdownUrls(text) {
+    const urlMap = [];
+    let placeholderIndex = 0;
+    const protectedText = text.replace(MARKDOWN_URL_REGEX, (match, url) => {
+        const placeholder = `${PLACEHOLDER_PREFIX}${placeholderIndex}${PLACEHOLDER_SUFFIX}`;
+        urlMap.push(url);
+        placeholderIndex++;
+        return `](${placeholder})`;
+    });
+    return { protected: protectedText, urlMap };
+}
+export function restoreMarkdownUrls(text, urlMap) {
+    if (urlMap.length === 0) {
+        return text;
+    }
+    let restored = text;
+    for (let i = 0; i < urlMap.length; i++) {
+        const placeholder = `${PLACEHOLDER_PREFIX}${i}${PLACEHOLDER_SUFFIX}`;
+        restored = restored.split(placeholder).join(urlMap[i]);
+    }
+    return restored;
+}
+//# sourceMappingURL=url-placeholders.js.map

package/dist/processors/url-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-placeholders.js","sourceRoot":"","sources":["../../src/processors/url-placeholders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AACpC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAO5C,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC5E,MAAM,WAAW,GAAG,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,EAAE,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,gBAAgB,EAAE,CAAC;QACnB,OAAO,KAAK,WAAW,GAAG,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAgB;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,GAAG,kBAAkB,GAAG,CAAC,GAAG,kBAAkB,EAAE,CAAC;QACrE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/processors/validator.d.ts

@@ -0,0 +1,23 @@
+import type { Segment } from "../core/types.js";
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Compare mdast structure between two Markdown strings (GFM). Returns human-readable error messages.
+ */
+export declare function compareMarkdownAST(sourceMd: string, translatedMd: string): Promise<string[]>;
+/**
+ * Compare translated segments to source: count, code-block integrity, mdast structure, length ratio.
+ */
+export declare function validateTranslation(sourceSegments: Segment[], translatedSegments: Segment[]): Promise<ValidationResult>;
+/**
+ * Strict checks for markdown doc translation after placeholder restore: mdast structure matches source,
+ * length ratio, frontmatter keys, and no leaked internal `{{...}}` markers.
+ */
+export declare function validateDocTranslatePair(source: Segment, translatedText: string): Promise<{
+    ok: boolean;
+    errors: string[];
+}>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/processors/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/processors/validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoHD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,OAAO,EAAE,EACzB,kBAAkB,EAAE,OAAO,EAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAkD3B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IACT,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAgCD"}

package/dist/processors/validator.js

@@ -0,0 +1,186 @@
+import { visit } from "unist-util-visit";
+import { hasInternalPlaceholderLeak } from "./translation-placeholder-leaks.js";
+let parserPromise = null;
+function loadMarkdownParser() {
+    if (!parserPromise) {
+        parserPromise = Promise.all([
+            import("mdast-util-from-markdown"),
+            import("micromark-extension-gfm"),
+            import("mdast-util-gfm"),
+        ]).then(([fromMarkdownMod, gfmMod, gfmMdMod]) => ({
+            fromMarkdown: fromMarkdownMod.fromMarkdown,
+            gfm: gfmMod.gfm,
+            gfmFromMarkdown: gfmMdMod.gfmFromMarkdown,
+        }));
+    }
+    return parserPromise;
+}
+function emptyStats() {
+    return {
+        link: 0,
+        image: 0,
+        code: 0,
+        inlineCode: 0,
+        strong: 0,
+        emphasis: 0,
+        list: 0,
+        listItem: 0,
+        table: 0,
+        headingDepths: [],
+    };
+}
+async function collectMarkdownStructure(md) {
+    const { fromMarkdown, gfm, gfmFromMarkdown } = await loadMarkdownParser();
+    const tree = fromMarkdown(md, {
+        extensions: [gfm()],
+        mdastExtensions: gfmFromMarkdown(),
+    });
+    const stats = emptyStats();
+    visit(tree, (node) => {
+        switch (node.type) {
+            case "link":
+                stats.link++;
+                break;
+            case "image":
+                stats.image++;
+                break;
+            case "code":
+                stats.code++;
+                break;
+            case "inlineCode":
+                stats.inlineCode++;
+                break;
+            case "strong":
+                stats.strong++;
+                break;
+            case "emphasis":
+                stats.emphasis++;
+                break;
+            case "list":
+                stats.list++;
+                break;
+            case "listItem":
+                stats.listItem++;
+                break;
+            case "table":
+                stats.table++;
+                break;
+            case "heading":
+                stats.headingDepths.push(node.depth);
+                break;
+            default:
+                break;
+        }
+    });
+    return stats;
+}
+const STRUCT_KEYS = [
+    "link",
+    "image",
+    "code",
+    "inlineCode",
+    "strong",
+    "emphasis",
+    "list",
+    "listItem",
+    "table",
+];
+/**
+ * Compare mdast structure between two Markdown strings (GFM). Returns human-readable error messages.
+ */
+export async function compareMarkdownAST(sourceMd, translatedMd) {
+    const a = await collectMarkdownStructure(sourceMd);
+    const b = await collectMarkdownStructure(translatedMd);
+    const errors = [];
+    for (const k of STRUCT_KEYS) {
+        if (a[k] !== b[k]) {
+            errors.push(`AST mismatch: ${k} ${a[k]} → ${b[k]}`);
+        }
+    }
+    const aHead = a.headingDepths.join(",");
+    const bHead = b.headingDepths.join(",");
+    if (aHead !== bHead) {
+        errors.push(`Heading depth sequence changed: [${aHead}] → [${bHead}]`);
+    }
+    return errors;
+}
+function shouldCompareMarkdownStructure(source) {
+    return source.type === "paragraph" || source.type === "heading" || source.type === "admonition";
+}
+/**
+ * Compare translated segments to source: count, code-block integrity, mdast structure, length ratio.
+ */
+export async function validateTranslation(sourceSegments, translatedSegments) {
+    const errors = [];
+    const warnings = [];
+    if (sourceSegments.length !== translatedSegments.length) {
+        errors.push(`Segment count mismatch: ${sourceSegments.length} vs ${translatedSegments.length}`);
+        return { valid: false, warnings, errors };
+    }
+    for (let i = 0; i < sourceSegments.length; i++) {
+        const source = sourceSegments[i];
+        const translated = translatedSegments[i];
+        if (!source || !translated) {
+            continue;
+        }
+        if (source.type === "code" && source.content !== translated.content) {
+            errors.push(`Code block modified at segment ${i} (hash ${source.hash})`);
+        }
+        if (shouldCompareMarkdownStructure(source)) {
+            const astErrors = await compareMarkdownAST(source.content, translated.content);
+            for (const msg of astErrors) {
+                warnings.push(`${msg} at segment ${i} (hash ${source.hash})`);
+            }
+        }
+        if (source.translatable && translated.content.length > 0) {
+            const ratio = translated.content.length / Math.max(1, source.content.length);
+            if (ratio > 3 || ratio < 0.2) {
+                warnings.push(`Unusual length ratio (${ratio.toFixed(2)}) at segment ${i} (hash ${source.hash})`);
+            }
+        }
+        if (source.type === "frontmatter") {
+            const sourceFmKeys = source.content.match(/^[a-z_]+:/gm) || [];
+            const translatedFmKeys = translated.content.match(/^[a-z_]+:/gm) || [];
+            if (sourceFmKeys.length !== translatedFmKeys.length) {
+                errors.push(`Front matter structure changed at segment ${i} (hash ${source.hash})`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        warnings,
+        errors,
+    };
+}
+/**
+ * Strict checks for markdown doc translation after placeholder restore: mdast structure matches source,
+ * length ratio, frontmatter keys, and no leaked internal `{{...}}` markers.
+ */
+export async function validateDocTranslatePair(source, translatedText) {
+    const errors = [];
+    if (source.type === "code" && source.content !== translatedText) {
+        errors.push(`Code block modified (hash ${source.hash})`);
+    }
+    if (shouldCompareMarkdownStructure(source)) {
+        const astErrors = await compareMarkdownAST(source.content, translatedText);
+        errors.push(...astErrors.map((e) => `${e} (hash ${source.hash})`));
+    }
+    if (source.translatable && translatedText.length > 0) {
+        const ratio = translatedText.length / Math.max(1, source.content.length);
+        if (ratio > 3 || ratio < 0.2) {
+            errors.push(`Unusual length ratio (${ratio.toFixed(2)}) (hash ${source.hash})`);
+        }
+    }
+    if (source.type === "frontmatter") {
+        const sourceFmKeys = source.content.match(/^[a-z_]+:/gm) || [];
+        const translatedFmKeys = translatedText.match(/^[a-z_]+:/gm) || [];
+        if (sourceFmKeys.length !== translatedFmKeys.length) {
+            errors.push(`Front matter structure changed (hash ${source.hash})`);
+        }
+    }
+    if (hasInternalPlaceholderLeak(translatedText)) {
+        errors.push(`Internal translation placeholder leaked in output (hash ${source.hash})`);
+    }
+    return { ok: errors.length === 0, errors };
+}
+//# sourceMappingURL=validator.js.map

package/dist/processors/validator.js.map

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