@geolonia/yuuhitsu 0.1.0 → 0.1.2

package/dist/tasks/batch-translate.d.ts

@@ -0,0 +1,46 @@
+import type { AIProvider } from "../provider/index.js";
+export interface BatchProgress {
+    total: number;
+    current: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+}
+export interface BatchTranslateOptions {
+    pattern: string;
+    targetLang: string;
+    provider?: AIProvider;
+    outputDir?: string;
+    inputBase?: string;
+    onProgress?: (progress: BatchProgress) => void;
+    dryRun: boolean;
+    verbose?: boolean;
+}
+export interface BatchResult {
+    total: number;
+    succeeded: number;
+    failed: number;
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Check if a string contains glob pattern characters
+ */
+export declare function isGlobPattern(input: string): boolean;
+/**
+ * Generate output path for a translated file
+ */
+export declare function generateOutputPath(opts: {
+    inputPath: string;
+    targetLang: string;
+    outputDir?: string;
+    inputBase?: string;
+    explicitOutput?: string;
+}): string;
+/**
+ * Execute batch translation
+ */
+export declare function batchTranslate(opts: BatchTranslateOptions): Promise<BatchResult>;
+//# sourceMappingURL=batch-translate.d.ts.map

package/dist/tasks/batch-translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-translate.d.ts","sourceRoot":"","sources":["../../src/tasks/batch-translate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAsCT;AA4CD;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAqHtB"}

package/dist/tasks/batch-translate.js

@@ -0,0 +1,174 @@
+import fg from "fast-glob";
+import { dirname, join, relative, parse, isAbsolute, sep } from "path";
+import { mkdirSync } from "fs";
+import chalk from "chalk";
+import { translateFile } from "./translate.js";
+/**
+ * Check if a string contains glob pattern characters
+ */
+export function isGlobPattern(input) {
+    return /[*?[\]{}]/.test(input);
+}
+/**
+ * Generate output path for a translated file
+ */
+export function generateOutputPath(opts) {
+    const { inputPath, targetLang, outputDir, inputBase, explicitOutput } = opts;
+    // If explicit output is provided, use it
+    if (explicitOutput) {
+        return explicitOutput;
+    }
+    // If outputDir is provided, preserve directory structure
+    if (outputDir && inputBase) {
+        const relativePath = relative(inputBase, inputPath);
+        // Security: Prevent path traversal
+        // Reject paths that are absolute or try to escape via ".."
+        if (isAbsolute(relativePath)) {
+            throw new Error(`Path traversal detected: ${inputPath} is outside ${inputBase} (absolute path)`);
+        }
+        if (relativePath.startsWith(`..${sep}`) || relativePath === "..") {
+            throw new Error(`Path traversal detected: ${inputPath} tries to escape ${inputBase}`);
+        }
+        // Check for ".." in path segments
+        const segments = relativePath.split(sep);
+        if (segments.includes("..")) {
+            throw new Error(`Path traversal detected: ${inputPath} contains ".." segments`);
+        }
+        return join(outputDir, relativePath);
+    }
+    // Default: add language code before extension
+    const parsed = parse(inputPath);
+    const ext = parsed.ext || "";
+    const base = parsed.name;
+    const dir = parsed.dir;
+    return join(dir, `${base}.${targetLang}${ext}`);
+}
+/**
+ * Determine the base path for --input-dir calculation
+ */
+function determineInputBase(pattern, matchedFiles) {
+    // Extract the static prefix from the glob pattern
+    // e.g., "docs/en/**/*.md" -> "docs/en"
+    const staticPrefix = pattern.split(/[*?[\]{}]/)[0];
+    // If there's a static directory prefix, use it
+    if (staticPrefix && staticPrefix.includes("/")) {
+        // Remove trailing slash and return as-is (it's already a directory path)
+        return staticPrefix.replace(/\/$/, "");
+    }
+    // If no static prefix, find common base from matched files
+    if (matchedFiles.length === 0) {
+        return undefined;
+    }
+    // Find the common directory prefix of all matched files
+    const dirs = matchedFiles.map(f => dirname(f));
+    const commonDir = dirs.reduce((acc, dir) => {
+        if (!acc)
+            return dir;
+        const accParts = acc.split("/");
+        const dirParts = dir.split("/");
+        const common = [];
+        for (let i = 0; i < Math.min(accParts.length, dirParts.length); i++) {
+            if (accParts[i] === dirParts[i]) {
+                common.push(accParts[i]);
+            }
+            else {
+                break;
+            }
+        }
+        return common.join("/") || ".";
+    });
+    return commonDir === "." ? undefined : commonDir;
+}
+/**
+ * Execute batch translation
+ */
+export async function batchTranslate(opts) {
+    const { pattern, targetLang, provider, outputDir, onProgress, dryRun, verbose } = opts;
+    // Match files using fast-glob
+    const matchedFiles = await fg(pattern, {
+        onlyFiles: true,
+        absolute: false,
+    });
+    if (matchedFiles.length === 0) {
+        throw new Error(`No files matched pattern: ${pattern}`);
+    }
+    // Determine input base for directory structure preservation
+    const inputBase = outputDir ? determineInputBase(pattern, matchedFiles) : undefined;
+    // Initialize progress
+    const progress = {
+        total: matchedFiles.length,
+        current: 0,
+        succeeded: 0,
+        failed: 0,
+        skipped: 0,
+    };
+    const errors = [];
+    // Process each file
+    for (let i = 0; i < matchedFiles.length; i++) {
+        const inputPath = matchedFiles[i];
+        progress.current = i + 1;
+        const outputPath = generateOutputPath({
+            inputPath,
+            targetLang,
+            outputDir,
+            inputBase,
+        });
+        // Show progress
+        const progressPrefix = chalk.cyan(`[${progress.current}/${progress.total}]`);
+        if (dryRun) {
+            process.stdout.write(`${progressPrefix} Would translate:\n` +
+                `  Input:  ${inputPath}\n` +
+                `  Output: ${outputPath}\n`);
+            progress.succeeded++;
+        }
+        else {
+            if (!provider) {
+                throw new Error("Provider is required when dryRun is false");
+            }
+            try {
+                process.stdout.write(`${progressPrefix} Translating ${inputPath}...\n`);
+                // Ensure output directory exists
+                const outputDirPath = dirname(outputPath);
+                mkdirSync(outputDirPath, { recursive: true });
+                // Translate the file
+                const result = await translateFile({
+                    provider,
+                    inputPath,
+                    outputPath,
+                    targetLang,
+                });
+                process.stdout.write(`${chalk.green("✓")} Translated to ${result.outputPath}\n` +
+                    (verbose ? `  Tokens: ${result.usage.totalTokens} (${result.chunks} chunk${result.chunks > 1 ? "s" : ""})\n` : ""));
+                progress.succeeded++;
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`${chalk.red("✗")} Failed to translate ${inputPath}: ${errorMsg}\n`);
+                errors.push({ file: inputPath, error: errorMsg });
+                progress.failed++;
+            }
+        }
+        // Call progress callback
+        if (onProgress) {
+            onProgress(progress);
+        }
+    }
+    // Print summary
+    const summaryColor = progress.failed > 0 ? chalk.yellow : chalk.green;
+    process.stdout.write(`\n` +
+        summaryColor("Summary:\n") +
+        `  Total:     ${progress.total}\n` +
+        `  Succeeded: ${progress.succeeded}\n` +
+        `  Failed:    ${progress.failed}\n`);
+    if (errors.length > 0) {
+        process.stderr.write(`\n${chalk.red("Errors:")}\n` +
+            errors.map(e => `  ${e.file}: ${e.error}`).join("\n") + "\n");
+    }
+    return {
+        total: progress.total,
+        succeeded: progress.succeeded,
+        failed: progress.failed,
+        errors,
+    };
+}
+//# sourceMappingURL=batch-translate.js.map

package/dist/tasks/batch-translate.js.map

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

package/dist/tasks/glossary.d.ts

@@ -0,0 +1,41 @@
+export interface GlossaryTerm {
+    canonical: string;
+    type: string;
+    translations: Record<string, string>;
+    do_not_use?: Record<string, string[]>;
+}
+export interface GlossaryConfig {
+    version: number;
+    languages: string[];
+    terms: GlossaryTerm[];
+}
+export interface GlossaryIssue {
+    forbidden: string;
+    canonical: string;
+    line: number;
+}
+export interface MissingTranslation {
+    canonical: string;
+    missingLanguages: string[];
+}
+export interface SyncResult {
+    totalTerms: number;
+    termsByLanguage: Record<string, GlossaryTerm[]>;
+    missingTranslations: MissingTranslation[];
+    stubsCreated: number;
+}
+export interface ReviewReport {
+    terms: GlossaryTerm[];
+    summary: {
+        totalTerms: number;
+        languages: string[];
+    };
+    toMarkdown(): string;
+}
+export declare function loadGlossary(glossaryPath: string): GlossaryConfig | null;
+export declare function initGlossary(outputPath: string, force?: boolean): void;
+export declare function checkGlossary(docPath: string, glossaryPath: string, lang: string): GlossaryIssue[];
+export declare function syncGlossary(glossaryPath: string): SyncResult;
+export declare function reviewGlossary(glossaryPath: string): ReviewReport;
+export declare function buildGlossaryPrompt(glossaryConfig: GlossaryConfig, targetLang: string): string;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/tasks/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/tasks/glossary.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAChD,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,UAAU,IAAI,MAAM,CAAC;CACtB;AA+BD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqBxE;AAMD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAQtE;AAMD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAuDjB;AAgED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAoD7D;AAMD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CA6CjE;AAMD,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,GACjB,MAAM,CAyBR"}

package/dist/tasks/glossary.js

@@ -0,0 +1,273 @@
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { parse, stringify } from "yaml";
+import { separateFrontmatter, protectCodeBlocks } from "./translate.js";
+// ---------------------------------------------------------------------------
+// Skeleton template
+// ---------------------------------------------------------------------------
+const SKELETON_TEMPLATE = `version: 1
+languages: [ja, en]
+terms:
+  - canonical: "API"
+    type: noun
+    translations:
+      ja: "API"
+      en: "API"
+    do_not_use:
+      ja: ["ＡＰＩ", "えーぴーあい"]
+  # Add more terms below:
+  # - canonical: "webhook"
+  #   type: noun
+  #   translations:
+  #     ja: "Webhook"
+  #     en: "webhook"
+  #   do_not_use:
+  #     ja: ["ウェブフック"]
+  #     en: ["web hook"]
+`;
+// ---------------------------------------------------------------------------
+// loadGlossary
+// ---------------------------------------------------------------------------
+export function loadGlossary(glossaryPath) {
+    if (!existsSync(glossaryPath)) {
+        return null;
+    }
+    const content = readFileSync(glossaryPath, "utf-8");
+    const raw = parse(content);
+    if (!raw || typeof raw !== "object") {
+        throw new Error(`Invalid glossary file: ${glossaryPath}`);
+    }
+    const schema = raw;
+    if (!Array.isArray(schema.terms)) {
+        throw new Error(`Glossary file must have a "terms" array: ${glossaryPath}`);
+    }
+    if (!Array.isArray(schema.languages)) {
+        throw new Error(`Glossary file must have a "languages" array: ${glossaryPath}`);
+    }
+    return raw;
+}
+// ---------------------------------------------------------------------------
+// initGlossary
+// ---------------------------------------------------------------------------
+export function initGlossary(outputPath, force) {
+    if (existsSync(outputPath) && !force) {
+        throw new Error(`Glossary file already exists: ${outputPath}\nUse --force to overwrite.`);
+    }
+    writeFileSync(outputPath, SKELETON_TEMPLATE, "utf-8");
+}
+// ---------------------------------------------------------------------------
+// checkGlossary
+// ---------------------------------------------------------------------------
+export function checkGlossary(docPath, glossaryPath, lang) {
+    // Load glossary (throws if not found)
+    const glossary = loadGlossary(glossaryPath);
+    if (!glossary) {
+        throw new Error(`Glossary file not found: ${glossaryPath}`);
+    }
+    // Validate lang parameter
+    if (!glossary.languages.includes(lang)) {
+        throw new Error(`Language "${lang}" is not defined in glossary. Available: ${glossary.languages.join(", ")}`);
+    }
+    // Read document (throws if not found)
+    let docContent;
+    try {
+        docContent = readFileSync(docPath, "utf-8");
+    }
+    catch (err) {
+        if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            throw new Error(`Document not found: ${docPath}`);
+        }
+        throw err;
+    }
+    // Separate frontmatter (skip it) and get body
+    const { frontmatter, body } = separateFrontmatter(docContent);
+    const frontmatterLineCount = frontmatter ? frontmatter.split("\n").length - 1 : 0;
+    // Protect code blocks and inline code with placeholders to avoid false positives
+    const { text: protectedBody } = protectCodeBlocks(body);
+    const lines = protectedBody.split("\n");
+    const issues = [];
+    for (const term of glossary.terms) {
+        const forbidden = term.do_not_use?.[lang] ?? [];
+        const canonicalTranslation = term.translations[lang];
+        for (const forbiddenWord of forbidden) {
+            if (forbiddenWord.length === 0)
+                continue;
+            for (let i = 0; i < lines.length; i++) {
+                // Remove URL content before checking to avoid false positives inside URLs
+                const lineWithoutUrls = lines[i].replace(/https?:\/\/\S+/g, "");
+                if (hasUncoveredOccurrence(lineWithoutUrls, forbiddenWord, canonicalTranslation)) {
+                    issues.push({
+                        forbidden: forbiddenWord,
+                        canonical: term.canonical,
+                        line: i + 1 + frontmatterLineCount,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+// ---------------------------------------------------------------------------
+// Substring-match helpers for checkGlossary
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if `canonicalTranslation` appears in `line` at a position
+ * that "covers" the occurrence of `forbiddenWord` starting at `forbiddenIdx`.
+ *
+ * Example: canonicalTranslation = "サブスクリプション", forbiddenWord = "サブスク"
+ * If "サブスクリプション" appears at position 0 in the line, the "サブスク" occurrence
+ * at position 0 is covered and should not be reported as a violation.
+ */
+function isOccurrenceCoveredByCanonical(line, forbiddenIdx, forbiddenWord, canonicalTranslation) {
+    if (!canonicalTranslation)
+        return false;
+    // For each position of forbiddenWord within canonicalTranslation, check
+    // whether canonicalTranslation appears at the corresponding position in line.
+    let posInCanonical = canonicalTranslation.indexOf(forbiddenWord);
+    while (posInCanonical !== -1) {
+        const canonicalStart = forbiddenIdx - posInCanonical;
+        if (canonicalStart >= 0 &&
+            line.slice(canonicalStart, canonicalStart + canonicalTranslation.length) === canonicalTranslation) {
+            return true;
+        }
+        posInCanonical = canonicalTranslation.indexOf(forbiddenWord, posInCanonical + 1);
+    }
+    return false;
+}
+/**
+ * Returns true if `line` contains at least one occurrence of `forbiddenWord`
+ * that is NOT covered by `canonicalTranslation` appearing at the same position.
+ */
+function hasUncoveredOccurrence(line, forbiddenWord, canonicalTranslation) {
+    if (forbiddenWord.length === 0)
+        return false;
+    let searchPos = 0;
+    while (true) {
+        const idx = line.indexOf(forbiddenWord, searchPos);
+        if (idx === -1)
+            break;
+        if (!isOccurrenceCoveredByCanonical(line, idx, forbiddenWord, canonicalTranslation)) {
+            return true;
+        }
+        searchPos = idx + 1;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// syncGlossary
+// ---------------------------------------------------------------------------
+export function syncGlossary(glossaryPath) {
+    const glossary = loadGlossary(glossaryPath);
+    if (!glossary) {
+        throw new Error(`Glossary file not found: ${glossaryPath}`);
+    }
+    const termsByLanguage = {};
+    for (const lang of glossary.languages) {
+        termsByLanguage[lang] = [];
+    }
+    const missingTranslations = [];
+    for (const term of glossary.terms) {
+        const missingLangs = [];
+        for (const lang of glossary.languages) {
+            if (term.translations[lang]) {
+                termsByLanguage[lang].push(term);
+            }
+            else {
+                missingLangs.push(lang);
+            }
+        }
+        if (missingLangs.length > 0) {
+            missingTranslations.push({
+                canonical: term.canonical,
+                missingLanguages: missingLangs,
+            });
+        }
+    }
+    // Write stub placeholders for missing translations
+    let stubsCreated = 0;
+    if (missingTranslations.length > 0) {
+        for (const term of glossary.terms) {
+            for (const lang of glossary.languages) {
+                if (!term.translations[lang]) {
+                    term.translations[lang] = "";
+                    stubsCreated++;
+                }
+            }
+        }
+        writeFileSync(glossaryPath, stringify(glossary), "utf-8");
+    }
+    return {
+        totalTerms: glossary.terms.length,
+        termsByLanguage,
+        missingTranslations,
+        stubsCreated,
+    };
+}
+// ---------------------------------------------------------------------------
+// reviewGlossary
+// ---------------------------------------------------------------------------
+export function reviewGlossary(glossaryPath) {
+    const glossary = loadGlossary(glossaryPath);
+    if (!glossary) {
+        throw new Error(`Glossary file not found: ${glossaryPath}`);
+    }
+    const report = {
+        terms: glossary.terms,
+        summary: {
+            totalTerms: glossary.terms.length,
+            languages: glossary.languages,
+        },
+        toMarkdown() {
+            const lines = [
+                "# Glossary Review Report",
+                "",
+                `**Total Terms:** ${glossary.terms.length}`,
+                `**Languages:** ${glossary.languages.join(", ")}`,
+                "",
+                "## Terms",
+                "",
+            ];
+            for (const term of glossary.terms) {
+                lines.push(`### ${term.canonical}`);
+                lines.push("");
+                lines.push(`- **Type:** ${term.type}`);
+                lines.push("- **Translations:**");
+                for (const [lang, translation] of Object.entries(term.translations)) {
+                    lines.push(`  - \`${lang}\`: ${translation}`);
+                }
+                if (term.do_not_use && Object.keys(term.do_not_use).length > 0) {
+                    lines.push("- **Do not use:**");
+                    for (const [lang, words] of Object.entries(term.do_not_use)) {
+                        lines.push(`  - \`${lang}\`: ${words.join(", ")}`);
+                    }
+                }
+                lines.push("");
+            }
+            return lines.join("\n");
+        },
+    };
+    return report;
+}
+// ---------------------------------------------------------------------------
+// buildGlossaryPrompt — helper for translate integration
+// ---------------------------------------------------------------------------
+export function buildGlossaryPrompt(glossaryConfig, targetLang) {
+    const relevantTerms = glossaryConfig.terms.filter((t) => t.translations[targetLang] || t.do_not_use?.[targetLang]);
+    if (relevantTerms.length === 0) {
+        return "";
+    }
+    const lines = [
+        "",
+        "Glossary — use these canonical translations and avoid forbidden terms:",
+    ];
+    for (const term of relevantTerms) {
+        const canonical = term.translations[targetLang] ?? term.canonical;
+        const forbidden = term.do_not_use?.[targetLang] ?? [];
+        let line = `- "${term.canonical}" → "${canonical}"`;
+        if (forbidden.length > 0) {
+            line += ` (do NOT use: ${forbidden.map((f) => `"${f}"`).join(", ")})`;
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=glossary.js.map

package/dist/tasks/glossary.js.map

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

package/dist/tasks/translate.d.ts

@@ -1,10 +1,36 @@
 import type { AIProvider } from "../provider/interface.js";
+import type { GlossaryConfig } from "./glossary.js";
+interface FrontmatterSeparation {
+    frontmatter: string | null;
+    body: string;
+}
+/**
+ * Separate frontmatter from Markdown content
+ * Handles: LF, CRLF, no trailing newline after closing ---, trailing spaces, empty frontmatter
+ * @param content - Full Markdown content
+ * @returns Object with separated frontmatter and body
+ */
+export declare function separateFrontmatter(content: string): FrontmatterSeparation;
+interface CodeProtection {
+    text: string;
+    map: Map<string, string>;
+}
+/**
+ * Replace fenced code blocks and inline code with placeholders.
+ * Fenced blocks (``` or ````+) take priority over inline code.
+ */
+export declare function protectCodeBlocks(content: string): CodeProtection;
+/**
+ * Restore placeholders back to original code blocks/inline code.
+ */
+export declare function restoreCodeBlocks(content: string, map: Map<string, string>): string;
 export interface TranslateOptions {
     provider: AIProvider;
     inputPath: string;
     outputPath?: string;
     targetLang: string;
     templateContent?: string;
+    glossaryConfig?: GlossaryConfig;
 }
 export interface TranslateResult {
     outputPath: string;
@@ -16,4 +42,5 @@ export interface TranslateResult {
     chunks: number;
 }
 export declare function translateFile(options: TranslateOptions): Promise<TranslateResult>;
+export {};
 //# sourceMappingURL=translate.d.ts.map

package/dist/tasks/translate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/tasks/translate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,0BAA0B,CAAC;AAIxE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB;AAsED,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoD1B"}
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/tasks/translate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,UAAU,qBAAqB;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAmB1E;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAuBjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CASnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB;AA+FD,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkE1B"}