ai-i18n-tools 1.0.0

package/dist/core/config.js

@@ -0,0 +1,392 @@
+import fs from "fs";
+import path from "path";
+import { ConfigValidationError } from "./errors.js";
+import { coerceTargetLocalesField, englishLanguageNameForLocale, normalizeLocale, parseLocaleList, } from "./locale-utils.js";
+import { augmentConfigWithUiLanguagesFile, expandDocumentationTargetLocalesInRawInput, expandTargetLocalesFileReferenceInRawInput, getDocumentationTargetLocaleCodes, resolveLocalesForUI, } from "./ui-languages.js";
+import { i18nConfigSchema, } from "./types.js";
+export { coerceTargetLocalesField, englishLanguageNameForLocale, normalizeLocale, parseLocaleList };
+const DEFAULT_OPENROUTER_MODELS = [
+    "openai/gpt-4o-mini",
+    "deepseek/deepseek-v3.2",
+    "google/gemini-3.1-flash-lite-preview",
+    "qwen/qwen3.6-plus",
+    "moonshotai/kimi-k2.5",
+    "anthropic/claude-sonnet-4.6",
+];
+/**
+ * Ordered OpenRouter models: non-empty `translationModels`, else legacy default + fallback.
+ */
+export function resolveTranslationModels(o) {
+    if (Array.isArray(o.translationModels) && o.translationModels.length > 0) {
+        const list = o.translationModels
+            .filter((m) => typeof m === "string" && m.trim().length > 0)
+            .map((m) => m.trim());
+        if (list.length > 0) {
+            return list;
+        }
+    }
+    const out = [];
+    if (o.defaultModel?.trim()) {
+        out.push(o.defaultModel.trim());
+    }
+    const fb = o.fallbackModel?.trim();
+    if (fb && fb !== out[0]) {
+        out.push(fb);
+    }
+    return out;
+}
+/**
+ * Ordered OpenRouter models for UI translation: optional `ui.preferredModel` first, then
+ * {@link resolveTranslationModels} for `openrouter`, with the preferred id deduplicated from the tail.
+ */
+export function resolveUITranslationModels(config) {
+    const base = resolveTranslationModels(config.openrouter);
+    const pref = config.ui.preferredModel?.trim();
+    if (!pref) {
+        return base;
+    }
+    const out = [pref];
+    for (const m of base) {
+        if (m !== pref) {
+            out.push(m);
+        }
+    }
+    return out;
+}
+function deepMergeDefaults(base, override) {
+    if (override === null ||
+        override === undefined ||
+        typeof override !== "object" ||
+        Array.isArray(override)) {
+        return base;
+    }
+    const o = override;
+    const next = { ...base };
+    for (const key of Object.keys(o)) {
+        const bv = next[key];
+        const ov = o[key];
+        if (ov !== undefined &&
+            typeof ov === "object" &&
+            ov !== null &&
+            !Array.isArray(ov) &&
+            typeof bv === "object" &&
+            bv !== null &&
+            !Array.isArray(bv)) {
+            next[key] = deepMergeDefaults(bv, ov);
+        }
+        else if (ov !== undefined) {
+            next[key] = ov;
+        }
+    }
+    return next;
+}
+/** Merge each block's `sourceFiles` into `contentPaths` (unique). */
+function mergeDocumentationSourceFiles(raw) {
+    const docs = raw.documentations;
+    if (!Array.isArray(docs)) {
+        return;
+    }
+    for (const item of docs) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            continue;
+        }
+        const d = item;
+        const cp = d.contentPaths;
+        const sf = d.sourceFiles;
+        const list = Array.isArray(cp) ? [...cp] : [];
+        if (Array.isArray(sf)) {
+            for (const p of sf) {
+                if (typeof p === "string" && p.trim() && !list.includes(p)) {
+                    list.push(p);
+                }
+            }
+        }
+        d.contentPaths = list;
+    }
+}
+/**
+ * Single-documentation view for translate-docs: one block plus root `cacheDir` and shared settings.
+ */
+export function toDocTranslateConfig(root, block) {
+    const { documentations: _, ...rest } = root;
+    return { ...rest, documentation: block };
+}
+export const defaultI18nConfigPartial = {
+    sourceLocale: "en",
+    targetLocales: [],
+    openrouter: {
+        baseUrl: "https://openrouter.ai/api/v1",
+        translationModels: [...DEFAULT_OPENROUTER_MODELS],
+        maxTokens: 8192,
+        temperature: 0.2,
+    },
+    features: {
+        extractUIStrings: false,
+        translateUIStrings: false,
+        translateMarkdown: false,
+        translateJSON: false,
+        translateSVG: false,
+    },
+    glossary: {},
+    ui: {
+        sourceRoots: [],
+        stringsJson: "strings.json",
+        flatOutputDir: "./locales",
+    },
+    cacheDir: ".translation-cache",
+    documentations: [
+        {
+            contentPaths: [],
+            outputDir: "./i18n",
+            markdownOutput: {},
+        },
+    ],
+};
+/**
+ * Merge user JSON (partial) with package defaults, then validate with Zod.
+ */
+export function mergeWithDefaults(raw) {
+    const asObj = raw !== null && typeof raw === "object" && !Array.isArray(raw)
+        ? raw
+        : {};
+    mergeDocumentationSourceFiles(asObj);
+    return deepMergeDefaults(defaultI18nConfigPartial, asObj);
+}
+export function validateI18nBusinessRules(config) {
+    const models = resolveTranslationModels(config.openrouter);
+    const needsDocTranslation = config.features.translateMarkdown || config.features.translateJSON;
+    const needsExtract = config.features.extractUIStrings;
+    const needsUITranslation = config.features.translateUIStrings;
+    const src = normalizeLocale(config.sourceLocale);
+    const needsSvgTranslation = config.features.translateSVG && Boolean(config.svg);
+    const needsSvgApi = needsSvgTranslation &&
+        getDocumentationTargetLocaleCodes(config).some((l) => normalizeLocale(l) !== src);
+    if (config.features.translateSVG && !config.svg) {
+        throw new ConfigValidationError("translateSVG is enabled but no svg block is configured (sourcePath, outputDir, style)");
+    }
+    if ((needsDocTranslation || needsUITranslation || needsSvgApi) && models.length === 0) {
+        throw new ConfigValidationError("openrouter.translationModels (non-empty array), or legacy defaultModel, is required when translateUIStrings, translateSVG (with non-source locales), or doc translate features are enabled");
+    }
+    const uiTargetsFromFileOnly = needsUITranslation && !needsDocTranslation && Boolean(config.uiLanguagesPath?.trim());
+    if (needsDocTranslation && getDocumentationTargetLocaleCodes(config).length === 0) {
+        throw new ConfigValidationError("When translateMarkdown / translateJSON is enabled, set non-empty targetLocales " +
+            "and/or documentations[].targetLocales (documentation-only locale list).");
+    }
+    if (needsUITranslation && config.targetLocales.length === 0 && !uiTargetsFromFileOnly) {
+        throw new ConfigValidationError("targetLocales must be non-empty when translateUIStrings is enabled (unless only UI translation is on and uiLanguagesPath points at your ui-languages.json), " +
+            'or use a single manifest path in targetLocales (e.g. ["src/renderer/locales/ui-languages.json"])');
+    }
+    if (needsExtract && config.ui.sourceRoots.length === 0) {
+        throw new ConfigValidationError("ui.sourceRoots must be non-empty when extractUIStrings is enabled");
+    }
+    if (needsDocTranslation) {
+        const hasPaths = config.documentations.some((d) => d.contentPaths.length > 0);
+        if (!hasPaths) {
+            throw new ConfigValidationError("documentations[].contentPaths must be non-empty in at least one block when translateMarkdown / translateJSON is enabled");
+        }
+    }
+}
+/** Validate config for the `translate-svg` command (call after normal load). */
+export function assertSvgCommandConfig(config) {
+    if (!config.svg) {
+        throw new ConfigValidationError("translate-svg requires an svg block in config: sourcePath, outputDir, style (flat | nested)");
+    }
+    const src = normalizeLocale(config.sourceLocale);
+    const needsApi = getDocumentationTargetLocaleCodes(config).some((l) => normalizeLocale(l) !== src);
+    if (needsApi) {
+        const models = resolveTranslationModels(config.openrouter);
+        if (models.length === 0) {
+            throw new ConfigValidationError("translate-svg requires openrouter.translationModels (or legacy defaultModel) when translating to non-source locales");
+        }
+    }
+}
+/**
+ * Parse and validate unified config (after optional merge with {@link mergeWithDefaults}).
+ */
+export function parseI18nConfig(input) {
+    const parsed = i18nConfigSchema.safeParse(input);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((e) => ({
+            path: e.path.join(".") || "(root)",
+            message: e.message,
+        }));
+        throw new ConfigValidationError(`Invalid ai-i18n-tools config: ${issues.map((i) => `${i.path}: ${i.message}`).join("; ")}`, issues);
+    }
+    validateI18nBusinessRules(parsed.data);
+    return parsed.data;
+}
+/**
+ * Apply environment overrides (OpenRouter and optional locale hints).
+ * Does not re-validate; call {@link parseI18nConfig} after merge if shape may have changed.
+ */
+export function applyEnvOverrides(config) {
+    const baseUrl = process.env.OPENROUTER_BASE_URL?.trim();
+    const next = {
+        ...config,
+        openrouter: {
+            ...config.openrouter,
+            ...(baseUrl ? { baseUrl } : {}),
+        },
+    };
+    const targetsEnv = process.env.I18N_TARGET_LOCALES?.trim();
+    if (targetsEnv) {
+        next.targetLocales = parseLocaleList(targetsEnv);
+    }
+    const sourceEnv = process.env.I18N_SOURCE_LOCALE?.trim();
+    if (sourceEnv) {
+        next.sourceLocale = normalizeLocale(sourceEnv);
+    }
+    return next;
+}
+/**
+ * Load `ai-i18n-tools.config.json` or a given path; merge defaults; validate.
+ */
+export function loadI18nConfigFromFile(configPath, cwd = process.cwd()) {
+    const resolved = path.isAbsolute(configPath) ? configPath : path.join(cwd, configPath);
+    if (!fs.existsSync(resolved)) {
+        throw new ConfigValidationError(`Config file not found: ${resolved}`);
+    }
+    const text = fs.readFileSync(resolved, "utf8");
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch (e) {
+        throw new ConfigValidationError(`Invalid JSON in config file: ${resolved}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const merged = mergeWithDefaults(json);
+    expandTargetLocalesFileReferenceInRawInput(merged, cwd);
+    expandDocumentationTargetLocalesInRawInput(merged, cwd);
+    const parsed = parseI18nConfig(merged);
+    const withEnv = applyEnvOverrides(parsed);
+    validateI18nBusinessRules(withEnv);
+    const augmented = augmentConfigWithUiLanguagesFile(withEnv, cwd);
+    if (augmented.features.translateUIStrings && resolveLocalesForUI(augmented, cwd).length === 0) {
+        throw new ConfigValidationError("translateUIStrings is enabled but no UI target locales resolved: set targetLocales to a locale array, " +
+            "a string path to ui-languages.json, and/or uiLanguagesPath (see docs/GETTING_STARTED.md)");
+    }
+    return augmented;
+}
+/** Default filename for `init` / CLI (Phase 4). */
+export const DEFAULT_CONFIG_FILENAME = "ai-i18n-tools.config.json";
+/**
+ * Template objects for `init`.
+ *
+ * `ui-markdown` - Workflow 1 (UI string extraction/translation) for a React/Next.js app.
+ * `ui-docusaurus` - Workflow 2 (markdown/JSON document translation) for Docusaurus sites.
+ *
+ * Both templates include all top-level fields so the generated file is self-documenting.
+ * See docs/GETTING_STARTED.md for a full annotated explanation of every field.
+ */
+export const initConfigTemplates = {
+    uiMarkdown: () => ({
+        ...defaultI18nConfigPartial,
+        sourceLocale: "en-GB",
+        // Must match sourceLocale - path to ui-languages.json OR an array of BCP-47 codes
+        targetLocales: "src/locales/ui-languages.json",
+        openrouter: {
+            baseUrl: "https://openrouter.ai/api/v1",
+            translationModels: [...DEFAULT_OPENROUTER_MODELS],
+            maxTokens: 8192,
+            temperature: 0.2,
+        },
+        features: {
+            // Workflow 1: UI string extraction and translation
+            extractUIStrings: true,
+            translateUIStrings: true,
+            // Workflow 2: document translation (enable when you have markdown to translate)
+            translateMarkdown: false,
+            translateJSON: false,
+            translateSVG: false,
+        },
+        glossary: {
+            uiGlossary: "src/locales/strings.json",
+            userGlossary: "glossary-user.csv",
+        },
+        ui: {
+            sourceRoots: ["src/"],
+            stringsJson: "src/locales/strings.json",
+            flatOutputDir: "src/locales/",
+        },
+        // Parallelism: translate-ui effective default 4; translate-docs effective default 3 when omitted.
+        concurrency: 4,
+        // translate-docs: max parallel OpenRouter batch requests per file.
+        batchConcurrency: 4,
+        batchSize: 20,
+        maxBatchChars: 4096,
+        cacheDir: ".translation-cache",
+        documentations: [
+            {
+                contentPaths: [],
+                outputDir: "./i18n",
+                markdownOutput: {
+                    style: "flat",
+                },
+                // Merged into translated markdown front matter (translation_*, source_*); omit or false to skip.
+                addFrontmatter: true,
+            },
+        ],
+    }),
+    uiDocusaurus: () => ({
+        ...defaultI18nConfigPartial,
+        sourceLocale: "en",
+        // Must match Docusaurus defaultLocale - path to ui-languages.json OR array of BCP-47 codes
+        targetLocales: "i18n/ui-languages.json",
+        openrouter: {
+            baseUrl: "https://openrouter.ai/api/v1",
+            translationModels: [...DEFAULT_OPENROUTER_MODELS],
+            maxTokens: 8192,
+            temperature: 0.2,
+        },
+        features: {
+            // Workflow 1: enable if you also have a React UI with t() calls to extract
+            extractUIStrings: false,
+            translateUIStrings: false,
+            // Workflow 2: Docusaurus document translation
+            translateMarkdown: true,
+            translateJSON: true,
+            translateSVG: false,
+        },
+        glossary: {
+            uiGlossary: "src/locales/strings.json",
+            userGlossary: "glossary-user.csv",
+        },
+        ui: {
+            sourceRoots: ["src/"],
+            stringsJson: "src/locales/strings.json",
+            flatOutputDir: "src/locales/",
+        },
+        // Docs-focused template: match translate-docs default (3) for parallel locales.
+        concurrency: 3,
+        batchConcurrency: 4,
+        batchSize: 20,
+        maxBatchChars: 4096,
+        cacheDir: ".translation-cache",
+        documentations: [
+            {
+                contentPaths: ["docs/"],
+                outputDir: "i18n/",
+                jsonSource: "i18n/en",
+                markdownOutput: {
+                    // 'docusaurus' places translated files under i18n/<locale>/docusaurus-plugin-content-docs/current/
+                    style: "docusaurus",
+                    docsRoot: "docs",
+                },
+                addFrontmatter: true,
+            },
+        ],
+    }),
+};
+/**
+ * Write a starter config JSON for `ai-i18n-tools init`.
+ * See docs/GETTING_STARTED.md for a full annotated explanation of every field.
+ */
+export function writeInitConfigFile(outPath, template, cwd = process.cwd()) {
+    const resolved = path.isAbsolute(outPath) ? outPath : path.join(cwd, outPath);
+    const raw = initConfigTemplates[template]();
+    const merged = mergeWithDefaults(raw);
+    parseI18nConfig(merged);
+    fs.mkdirSync(path.dirname(resolved), { recursive: true });
+    fs.writeFileSync(resolved, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/doc-file-tracking.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param relPath - Path segment after the block id: project-root-relative posix (e.g. markdown under
+ *   `contentPaths`, or JSON sources as cwd-relative paths so cleanup can resolve them next to `jsonSource`).
+ */
+export declare function documentationFileTrackingKey(blockIndex: number, relPath: string): string;
+/** Resolve a stored filepath key to an absolute path under project root for existence checks. */
+export declare function resolveDocTrackingKeyToAbs(projectRoot: string, filepath: string): string;
+//# sourceMappingURL=doc-file-tracking.d.ts.map

package/dist/core/doc-file-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-tracking.d.ts","sourceRoot":"","sources":["../../src/core/doc-file-tracking.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,iGAAiG;AACjG,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUxF"}

package/dist/core/doc-file-tracking.js

@@ -0,0 +1,27 @@
+import path from "path";
+/**
+ * Namespaces documentation file-tracking keys in the shared SQLite cache when multiple
+ * `documentations` blocks exist, so the same relative path in different blocks does not collide.
+ */
+const PREFIX = "doc-block:";
+/**
+ * @param relPath - Path segment after the block id: project-root-relative posix (e.g. markdown under
+ *   `contentPaths`, or JSON sources as cwd-relative paths so cleanup can resolve them next to `jsonSource`).
+ */
+export function documentationFileTrackingKey(blockIndex, relPath) {
+    const p = relPath.split("\\").join("/");
+    return `${PREFIX}${blockIndex}:${p}`;
+}
+/** Resolve a stored filepath key to an absolute path under project root for existence checks. */
+export function resolveDocTrackingKeyToAbs(projectRoot, filepath) {
+    if (filepath.startsWith(PREFIX)) {
+        const rest = filepath.slice(PREFIX.length);
+        const idx = rest.indexOf(":");
+        if (idx >= 0) {
+            const rel = rest.slice(idx + 1);
+            return path.resolve(projectRoot, rel);
+        }
+    }
+    return path.resolve(projectRoot, filepath);
+}
+//# sourceMappingURL=doc-file-tracking.js.map

package/dist/core/doc-file-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-tracking.js","sourceRoot":"","sources":["../../src/core/doc-file-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,GAAG,YAAY,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAkB,EAAE,OAAe;IAC9E,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,GAAG,MAAM,GAAG,UAAU,IAAI,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,QAAgB;IAC9E,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,19 @@
+/** Base class for package errors with an optional machine-readable code. */
+export declare class I18nToolsError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare class ConfigValidationError extends I18nToolsError {
+    readonly issues?: readonly {
+        path: string;
+        message: string;
+    }[] | undefined;
+    constructor(message: string, issues?: readonly {
+        path: string;
+        message: string;
+    }[] | undefined);
+}
+export declare class CacheError extends I18nToolsError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAMhC;AAED,qBAAa,qBAAsB,SAAQ,cAAc;aAGrC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;gBADrE,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,YAAA;CAKxE;AAED,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/errors.js

@@ -0,0 +1,23 @@
+/** Base class for package errors with an optional machine-readable code. */
+export class I18nToolsError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "I18nToolsError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ConfigValidationError extends I18nToolsError {
+    constructor(message, issues) {
+        super(message, "CONFIG_VALIDATION");
+        this.issues = issues;
+        this.name = "ConfigValidationError";
+    }
+}
+export class CacheError extends I18nToolsError {
+    constructor(message) {
+        super(message, "CACHE");
+        this.name = "CacheError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,YACE,OAAe,EACC,MAAqD;QAErE,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAFpB,WAAM,GAAN,MAAM,CAA+C;QAGrE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/core/locale-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared locale normalization and list parsing (used by config, ui-languages, CLI).
+ */
+export declare function normalizeLocale(locale: string): string;
+/**
+ * English language name for a BCP-47 tag (e.g. `ko` → `"Korean"`, `en-GB` → `"British English"`).
+ * Used for LLM prompts when `localeDisplayNames` is unset. Returns `undefined` if `Intl` cannot resolve a useful label.
+ */
+export declare function englishLanguageNameForLocale(localeCode: string): string | undefined;
+/** Split CLI/config locale lists (commas and/or ASCII whitespace). Dedupes, preserves order. */
+export declare function parseLocaleList(raw: string): string[];
+/**
+ * Normalize JSON config `targetLocales`: either a single manifest path string or an array of locale codes.
+ */
+export declare function coerceTargetLocalesField(value: unknown): string[];
+/** Mutate raw config input so `targetLocales` is always `string[]` (string → one-element array). */
+export declare function assignCoercedTargetLocales(raw: {
+    targetLocales?: unknown;
+}): void;
+//# sourceMappingURL=locale-utils.d.ts.map

package/dist/core/locale-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-utils.d.ts","sourceRoot":"","sources":["../../src/core/locale-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBnF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAerD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAWjE;AAED,oGAAoG;AACpG,wBAAgB,0BAA0B,CAAC,GAAG,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAEjF"}

package/dist/core/locale-utils.js

@@ -0,0 +1,75 @@
+/**
+ * Shared locale normalization and list parsing (used by config, ui-languages, CLI).
+ */
+export function normalizeLocale(locale) {
+    const normalized = locale.trim();
+    if (normalized.includes("-")) {
+        const parts = normalized.split("-");
+        if (parts.length === 2) {
+            return `${parts[0].toLowerCase()}-${parts[1].toUpperCase()}`;
+        }
+    }
+    return normalized.toLowerCase();
+}
+/**
+ * English language name for a BCP-47 tag (e.g. `ko` → `"Korean"`, `en-GB` → `"British English"`).
+ * Used for LLM prompts when `localeDisplayNames` is unset. Returns `undefined` if `Intl` cannot resolve a useful label.
+ */
+export function englishLanguageNameForLocale(localeCode) {
+    const tag = normalizeLocale(localeCode);
+    if (!tag) {
+        return undefined;
+    }
+    try {
+        const dn = new Intl.DisplayNames(["en"], { type: "language" });
+        const name = dn.of(tag);
+        if (typeof name !== "string" || !name.trim()) {
+            return undefined;
+        }
+        const t = name.trim();
+        if (t.toLowerCase() === tag.toLowerCase()) {
+            return undefined;
+        }
+        return t;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Split CLI/config locale lists (commas and/or ASCII whitespace). Dedupes, preserves order. */
+export function parseLocaleList(raw) {
+    const seen = new Set();
+    const out = [];
+    const parts = raw
+        .split(/[\s,]+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    for (const part of parts) {
+        const n = normalizeLocale(part);
+        if (!seen.has(n)) {
+            seen.add(n);
+            out.push(n);
+        }
+    }
+    return out;
+}
+/**
+ * Normalize JSON config `targetLocales`: either a single manifest path string or an array of locale codes.
+ */
+export function coerceTargetLocalesField(value) {
+    if (typeof value === "string") {
+        const t = value.trim();
+        return t ? [t] : [];
+    }
+    if (Array.isArray(value)) {
+        return value
+            .filter((x) => typeof x === "string" && x.trim().length > 0)
+            .map((x) => x.trim());
+    }
+    return [];
+}
+/** Mutate raw config input so `targetLocales` is always `string[]` (string → one-element array). */
+export function assignCoercedTargetLocales(raw) {
+    Object.assign(raw, { targetLocales: coerceTargetLocalesField(raw.targetLocales) });
+}
+//# sourceMappingURL=locale-utils.js.map

package/dist/core/locale-utils.js.map

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

package/dist/core/output-paths.d.ts

@@ -0,0 +1,22 @@
+import type { I18nDocTranslateConfig } from "./types.js";
+export type DocArtifactKind = "markdown" | "json";
+/** Normalize to forward slashes for template keys and comparisons. */
+export declare function toPosix(p: string): string;
+export interface PathTemplateContext {
+    outputDir: string;
+    locale: string;
+    relPath: string;
+    docsRoot: string;
+}
+/**
+ * Expand `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`,
+ * `{docsRoot}`, `{relativeToDocsRoot}`.
+ */
+export declare function expandPathTemplate(template: string, ctx: PathTemplateContext): string;
+/**
+ * Resolve absolute output path for a translated documentation artifact.
+ */
+export declare function resolveDocumentationOutputPath(config: I18nDocTranslateConfig, cwd: string, locale: string, relPath: string, kind: DocArtifactKind): string;
+/** Whether to run relative link rewriting for flat markdown outputs. */
+export declare function shouldRewriteFlatMarkdownLinks(config: I18nDocTranslateConfig): boolean;
+//# sourceMappingURL=output-paths.d.ts.map

package/dist/core/output-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-paths.d.ts","sourceRoot":"","sources":["../../src/core/output-paths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAIlD,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAaD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,MAAM,CA4BrF;AA8DD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,GACpB,MAAM,CAuBR;AAED,wEAAwE;AACxE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAStF"}