ai-i18n-tools 1.0.0

package/dist/core/svg-asset-paths.js

@@ -0,0 +1,107 @@
+import path from "path";
+import { toPosix } from "./output-paths.js";
+function assertSvgOutputWithinRoot(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 SVG output path escapes svg.outputDir: ${absFile} (root: ${root})`);
+    }
+}
+/**
+ * Expand `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`,
+ * `{relativeToSourceRoot}` (same as path under `svg.sourcePath`).
+ */
+export function expandSvgPathTemplate(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;
+    const relSrc = toPosix(ctx.relativeToSourceRoot);
+    let out = template;
+    const pairs = [
+        ["{outputDir}", ctx.outputDir],
+        ["{locale}", ctx.locale],
+        ["{LOCALE}", ctx.locale.toUpperCase()],
+        ["{relPath}", posixRel],
+        ["{stem}", stem],
+        ["{basename}", basename],
+        ["{extension}", extension],
+        ["{relativeToSourceRoot}", relSrc],
+    ];
+    for (const [key, val] of pairs) {
+        out = out.split(key).join(val);
+    }
+    return out;
+}
+/**
+ * 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 function resolveSvgAssetOutputPath(config, cwd, locale, 
+/** Path relative to cwd (posix), e.g. `images/foo.svg` */
+relPathFromCwd, 
+/** Path relative to the `sourcePath` root that contained this file (posix), e.g. `foo.svg` or `icons/a.svg` */
+relPathFromSourceRoot) {
+    const svg = config.svg;
+    if (!svg) {
+        throw new Error("resolveSvgAssetOutputPath: config.svg is required");
+    }
+    const outRoot = path.resolve(cwd, svg.outputDir);
+    const posixRel = toPosix(relPathFromCwd);
+    const parsed = path.posix.parse(posixRel);
+    const stem = parsed.name;
+    const tmpl = svg.pathTemplate?.trim();
+    let abs;
+    if (tmpl && tmpl.length > 0) {
+        const expanded = expandSvgPathTemplate(tmpl, {
+            outputDir: outRoot,
+            locale,
+            relPath: relPathFromCwd,
+            relativeToSourceRoot: relPathFromSourceRoot,
+        });
+        abs = path.isAbsolute(expanded) ? path.normalize(expanded) : path.resolve(cwd, expanded);
+    }
+    else if (svg.style === "flat") {
+        abs = path.join(outRoot, `${stem}.${locale}.svg`);
+    }
+    else {
+        abs = path.join(outRoot, locale, relPathFromSourceRoot);
+    }
+    assertSvgOutputWithinRoot(abs, outRoot);
+    return abs;
+}
+/**
+ * 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 function svgAssetCacheFilepath(relPathFromCwdPosix) {
+    return `svg-assets:${toPosix(relPathFromCwdPosix)}`;
+}
+/** Cwd-relative posix path for `translations.filepath` metadata (no `svg-assets:` prefix). */
+export function svgTranslationFilepathMetadata(relPathFromCwd) {
+    return toPosix(relPathFromCwd.replace(/\\/g, "/"));
+}
+/**
+ * Path under a configured `svg.sourcePath` root (posix), for nested output layout.
+ * Returns `null` if `fileRelCwd` is not under any root.
+ */
+export function relPathUnderSvgSource(fileRelCwd, sourceRoots) {
+    const posix = toPosix(fileRelCwd.replace(/\\/g, "/"));
+    const sorted = [...sourceRoots].sort((a, b) => b.length - a.length);
+    for (const root of sorted) {
+        const r = toPosix(root.replace(/\\/g, "/")).replace(/\/$/, "");
+        if (posix === r) {
+            return path.posix.basename(posix);
+        }
+        if (posix.startsWith(`${r}/`)) {
+            return posix.slice(r.length + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=svg-asset-paths.js.map

package/dist/core/svg-asset-paths.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,388 @@
+import { z } from "zod";
+/** Markdown / JSON / UI / SVG segment classification. */
+export type SegmentType = "ui-string" | "frontmatter" | "heading" | "paragraph" | "code" | "admonition" | "json" | "svg-text" | "other";
+/** SVG reassembly metadata (regex-extracted elements). */
+export interface SvgSegmentMeta {
+    element: "text" | "title" | "desc";
+    fullMatch: string;
+    openingTag: string;
+}
+export interface Segment {
+    id: string;
+    type: SegmentType;
+    content: string;
+    hash: string;
+    translatable: boolean;
+    startLine?: number;
+    jsonKey?: string;
+    jsonDescription?: string;
+    svg?: SvgSegmentMeta;
+}
+/**
+ * Per-segment translation with optional model metadata. `modelUsed` is set when the text was produced by the API this run
+ * (the model that actually succeeded). Omitted for cache hits so callers do not overwrite a stored model.
+ * Plain `string` remains supported for tests and simple pipelines.
+ */
+export type DocSegmentTranslation = {
+    text: string;
+    modelUsed?: string;
+};
+/** Values accepted by {@link ContentExtractor.reassemble}. */
+export type SegmentTranslationMapValue = string | DocSegmentTranslation;
+export declare function segmentTranslationText(v: SegmentTranslationMapValue | undefined): string | undefined;
+/** Coerce a map to plain `Map<string, string>` (e.g. legacy callers or JSON serialization). */
+export declare function translationTextMap(m: Map<string, SegmentTranslationMapValue>): Map<string, string>;
+export interface TranslationResult {
+    content: string;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    cost?: number;
+    /** When the API succeeded; used for translation failure debug logs. */
+    debugPrompt?: {
+        systemPrompt: string;
+        userContent: string;
+    };
+    /** Raw assistant text before `<translate>` stripping (single-segment). */
+    rawAssistantContent?: string;
+}
+/** Row shape for file_tracking and status queries. */
+export interface FileTracking {
+    filepath: string;
+    locale: string;
+    sourceHash: string;
+    lastTranslated: string | null;
+}
+/** Arguments for {@link import("./cache.js").TranslationCache.setSegment}. */
+export interface CacheEntry {
+    sourceHash: string;
+    locale: string;
+    sourceText: string;
+    translatedText: string;
+    model: string;
+    filepath?: string;
+    startLine?: number | null;
+}
+export interface TranslationRow {
+    source_hash: string;
+    locale: string;
+    source_text: string;
+    translated_text: string;
+    model: string | null;
+    filepath: string | null;
+    created_at: string | null;
+    last_hit_at: string | null;
+    start_line: number | null;
+}
+export interface CleanupStats {
+    staleTranslationsRemoved: number;
+    deletedRows: Array<{
+        source_hash: string;
+        locale: string;
+        filepath: string | null;
+    }>;
+}
+export interface ContentExtractor {
+    readonly name: string;
+    canHandle(filepath: string): boolean;
+    extract(content: string, filepath: string): Segment[];
+    reassemble(segments: Segment[], translations: Map<string, SegmentTranslationMapValue>): string;
+}
+export interface GlossaryTerm {
+    english: string;
+    translations: Record<string, string>;
+    partOfSpeech: string;
+    /** From user glossary CSV `force` column (per locale after * / exact merge). */
+    forcedByLocale?: Record<string, boolean>;
+}
+/** Result from batch translation (index → translated text). */
+export interface BatchTranslationResult {
+    translations: Map<number, string>;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    cost?: number;
+    /** When the API succeeded; used for translation failure debug logs. */
+    debugPrompt?: {
+        systemPrompt: string;
+        userContent: string;
+    };
+    rawAssistantContent?: string;
+}
+export declare class BatchTranslationError extends Error {
+    readonly expected: number;
+    readonly received: number;
+    readonly rawResponse: string;
+    constructor(expected: number, received: number, rawResponse: string);
+}
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ChatResponse {
+    content: string;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    cost?: number;
+}
+declare const openRouterConfigSchema: z.ZodObject<{
+    baseUrl: z.ZodDefault<z.ZodString>;
+    translationModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+    fallbackModel: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+    temperature: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const featuresSchema: z.ZodObject<{
+    extractUIStrings: z.ZodDefault<z.ZodBoolean>;
+    translateUIStrings: z.ZodDefault<z.ZodBoolean>;
+    translateMarkdown: z.ZodDefault<z.ZodBoolean>;
+    translateJSON: z.ZodDefault<z.ZodBoolean>;
+    translateSVG: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const glossarySchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    uiGlossary: z.ZodOptional<z.ZodString>;
+    userGlossary: z.ZodOptional<z.ZodString>;
+    autoAddUserEditedToGlossary: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>>;
+declare const reactExtractorSchema: z.ZodObject<{
+    extensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    funcNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    includePackageDescription: z.ZodDefault<z.ZodBoolean>;
+    packageJsonPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const svgExtractorSchema: z.ZodObject<{
+    forceLowercase: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const languageListBlockSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    separator: z.ZodString;
+}, z.core.$strict>;
+declare const regexAdjustmentSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    search: z.ZodString;
+    replace: z.ZodString;
+}, z.core.$strict>;
+declare const markdownPostProcessingSchema: z.ZodObject<{
+    languageListBlock: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        separator: z.ZodString;
+    }, z.core.$strict>>;
+    regexAdjustments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        search: z.ZodString;
+        replace: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const markdownOutputSchema: z.ZodObject<{
+    style: z.ZodDefault<z.ZodEnum<{
+        flat: "flat";
+        nested: "nested";
+        docusaurus: "docusaurus";
+    }>>;
+    docsRoot: z.ZodOptional<z.ZodString>;
+    pathTemplate: z.ZodOptional<z.ZodString>;
+    jsonPathTemplate: z.ZodOptional<z.ZodString>;
+    flatPreserveRelativeDir: z.ZodDefault<z.ZodBoolean>;
+    rewriteRelativeLinks: z.ZodOptional<z.ZodBoolean>;
+    linkRewriteDocsRoot: z.ZodOptional<z.ZodString>;
+    postProcessing: z.ZodOptional<z.ZodObject<{
+        languageListBlock: z.ZodOptional<z.ZodObject<{
+            start: z.ZodString;
+            end: z.ZodString;
+            separator: z.ZodString;
+        }, z.core.$strict>>;
+        regexAdjustments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            search: z.ZodString;
+            replace: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const uiConfigSchema: z.ZodObject<{
+    sourceRoots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    stringsJson: z.ZodDefault<z.ZodString>;
+    flatOutputDir: z.ZodDefault<z.ZodString>;
+    preferredModel: z.ZodOptional<z.ZodString>;
+    reactExtractor: z.ZodOptional<z.ZodObject<{
+        extensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        funcNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        includePackageDescription: z.ZodDefault<z.ZodBoolean>;
+        packageJsonPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const svgAssetsConfigSchema: z.ZodObject<{
+    sourcePath: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<z.ZodString>>;
+    outputDir: z.ZodString;
+    pathTemplate: z.ZodOptional<z.ZodString>;
+    style: z.ZodEnum<{
+        flat: "flat";
+        nested: "nested";
+    }>;
+    svgExtractor: z.ZodOptional<z.ZodObject<{
+        forceLowercase: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** One documentation pipeline (markdown/JSON layout under `outputDir`, optional Docusaurus `jsonSource`). */
+declare const documentationBlockSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    contentPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    targetLocales: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[] | undefined, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>>;
+    outputDir: z.ZodDefault<z.ZodString>;
+    jsonSource: z.ZodOptional<z.ZodString>;
+    markdownOutput: z.ZodDefault<z.ZodObject<{
+        style: z.ZodDefault<z.ZodEnum<{
+            flat: "flat";
+            nested: "nested";
+            docusaurus: "docusaurus";
+        }>>;
+        docsRoot: z.ZodOptional<z.ZodString>;
+        pathTemplate: z.ZodOptional<z.ZodString>;
+        jsonPathTemplate: z.ZodOptional<z.ZodString>;
+        flatPreserveRelativeDir: z.ZodDefault<z.ZodBoolean>;
+        rewriteRelativeLinks: z.ZodOptional<z.ZodBoolean>;
+        linkRewriteDocsRoot: z.ZodOptional<z.ZodString>;
+        postProcessing: z.ZodOptional<z.ZodObject<{
+            languageListBlock: z.ZodOptional<z.ZodObject<{
+                start: z.ZodString;
+                end: z.ZodString;
+                separator: z.ZodString;
+            }, z.core.$strict>>;
+            regexAdjustments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                search: z.ZodString;
+                replace: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    addFrontmatter: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** Unified package config: shared root + `ui` + `documentations` pipelines. */
+export declare const i18nConfigSchema: z.ZodObject<{
+    sourceLocale: z.ZodString;
+    cacheDir: z.ZodDefault<z.ZodString>;
+    targetLocales: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    openrouter: z.ZodObject<{
+        baseUrl: z.ZodDefault<z.ZodString>;
+        translationModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        defaultModel: z.ZodOptional<z.ZodString>;
+        fallbackModel: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    features: z.ZodDefault<z.ZodObject<{
+        extractUIStrings: z.ZodDefault<z.ZodBoolean>;
+        translateUIStrings: z.ZodDefault<z.ZodBoolean>;
+        translateMarkdown: z.ZodDefault<z.ZodBoolean>;
+        translateJSON: z.ZodDefault<z.ZodBoolean>;
+        translateSVG: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    glossary: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+        uiGlossary: z.ZodOptional<z.ZodString>;
+        userGlossary: z.ZodOptional<z.ZodString>;
+        autoAddUserEditedToGlossary: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    ui: z.ZodDefault<z.ZodObject<{
+        sourceRoots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        stringsJson: z.ZodDefault<z.ZodString>;
+        flatOutputDir: z.ZodDefault<z.ZodString>;
+        preferredModel: z.ZodOptional<z.ZodString>;
+        reactExtractor: z.ZodOptional<z.ZodObject<{
+            extensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            funcNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            includePackageDescription: z.ZodDefault<z.ZodBoolean>;
+            packageJsonPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    documentations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        contentPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sourceFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        targetLocales: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[] | undefined, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>>;
+        outputDir: z.ZodDefault<z.ZodString>;
+        jsonSource: z.ZodOptional<z.ZodString>;
+        markdownOutput: z.ZodDefault<z.ZodObject<{
+            style: z.ZodDefault<z.ZodEnum<{
+                flat: "flat";
+                nested: "nested";
+                docusaurus: "docusaurus";
+            }>>;
+            docsRoot: z.ZodOptional<z.ZodString>;
+            pathTemplate: z.ZodOptional<z.ZodString>;
+            jsonPathTemplate: z.ZodOptional<z.ZodString>;
+            flatPreserveRelativeDir: z.ZodDefault<z.ZodBoolean>;
+            rewriteRelativeLinks: z.ZodOptional<z.ZodBoolean>;
+            linkRewriteDocsRoot: z.ZodOptional<z.ZodString>;
+            postProcessing: z.ZodOptional<z.ZodObject<{
+                languageListBlock: z.ZodOptional<z.ZodObject<{
+                    start: z.ZodString;
+                    end: z.ZodString;
+                    separator: z.ZodString;
+                }, z.core.$strict>>;
+                regexAdjustments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    search: z.ZodString;
+                    replace: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        addFrontmatter: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    rtlLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    localeDisplayNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    uiLanguagesPath: z.ZodOptional<z.ZodString>;
+    svg: z.ZodOptional<z.ZodObject<{
+        sourcePath: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<z.ZodString>>;
+        outputDir: z.ZodString;
+        pathTemplate: z.ZodOptional<z.ZodString>;
+        style: z.ZodEnum<{
+            flat: "flat";
+            nested: "nested";
+        }>;
+        svgExtractor: z.ZodOptional<z.ZodObject<{
+            forceLowercase: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    batchSize: z.ZodOptional<z.ZodNumber>;
+    maxBatchChars: z.ZodOptional<z.ZodNumber>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
+    batchConcurrency: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type I18nConfig = z.infer<typeof i18nConfigSchema>;
+export type OpenRouterConfig = z.infer<typeof openRouterConfigSchema>;
+export type FeaturesConfig = z.infer<typeof featuresSchema>;
+export type GlossaryConfig = z.infer<typeof glossarySchema>;
+export type UIStringExtractorConfig = z.infer<typeof reactExtractorSchema>;
+/** @deprecated Use {@link UIStringExtractorConfig} */
+export type ReactExtractorConfig = UIStringExtractorConfig;
+export type SvgExtractorConfig = z.infer<typeof svgExtractorSchema>;
+export type LanguageListBlockConfig = z.infer<typeof languageListBlockSchema>;
+export type RegexAdjustmentConfig = z.infer<typeof regexAdjustmentSchema>;
+export type MarkdownPostProcessingConfig = z.infer<typeof markdownPostProcessingSchema>;
+export type MarkdownOutputConfig = z.infer<typeof markdownOutputSchema>;
+export type UiConfig = z.infer<typeof uiConfigSchema>;
+export type DocumentationBlock = z.infer<typeof documentationBlockSchema>;
+export type SvgAssetsConfig = z.infer<typeof svgAssetsConfigSchema>;
+/**
+ * View passed to translate-docs internals: one active `documentation` block plus root fields.
+ * Built from root config via {@link toDocTranslateConfig}.
+ */
+export type I18nDocTranslateConfig = Omit<I18nConfig, "documentations"> & {
+    documentation: DocumentationBlock;
+};
+export type RawI18nConfigInput = z.input<typeof i18nConfigSchema>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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