ai-i18n-tools 1.0.0

package/dist/extractors/classify-segment.js

@@ -0,0 +1,20 @@
+/**
+ * Lightweight line/block classifier (plan §2.3 reference). For full markdown splitting use {@link MarkdownExtractor}.
+ */
+export function classifySegmentType(text) {
+    const t = text.trim();
+    if (/^#{1,6}\s/.test(t)) {
+        return "heading";
+    }
+    if (/^!\[.*\]\(.*\)/.test(t)) {
+        return "other";
+    }
+    if (/^import /.test(t)) {
+        return "other";
+    }
+    if (/^</.test(t)) {
+        return "other";
+    }
+    return "paragraph";
+}
+//# sourceMappingURL=classify-segment.js.map

package/dist/extractors/classify-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-segment.js","sourceRoot":"","sources":["../../src/extractors/classify-segment.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/extractors/json-extractor.d.ts

@@ -0,0 +1,16 @@
+import type { Segment, SegmentTranslationMapValue } from "../core/types.js";
+import { BaseExtractor } from "./base-extractor.js";
+/**
+ * Docusaurus-style JSON: `{ "key": { "message": "...", "description": "..." } }`.
+ * `reassemble` uses the content from the last `extract` call on this instance (one file per instance per pipeline).
+ */
+export declare class JsonExtractor extends BaseExtractor {
+    readonly name = "json";
+    /** Last `extract` input; used by {@link reassemble}. */
+    private lastOriginalContent;
+    canHandle(filepath: string): boolean;
+    extract(content: string, filepath: string): Segment[];
+    reassemble(segments: Segment[], translations: Map<string, SegmentTranslationMapValue>): string;
+    private escapeRegex;
+}
+//# sourceMappingURL=json-extractor.d.ts.map

package/dist/extractors/json-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/json-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,UAAU;IAEvB,wDAAwD;IACxD,OAAO,CAAC,mBAAmB,CAAM;IAEjC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAqErD,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,GAAG,MAAM;IAoD9F,OAAO,CAAC,WAAW;CAGpB"}

package/dist/extractors/json-extractor.js

@@ -0,0 +1,128 @@
+import { BaseExtractor } from "./base-extractor.js";
+/**
+ * Docusaurus-style JSON: `{ "key": { "message": "...", "description": "..." } }`.
+ * `reassemble` uses the content from the last `extract` call on this instance (one file per instance per pipeline).
+ */
+export class JsonExtractor extends BaseExtractor {
+    constructor() {
+        super(...arguments);
+        this.name = "json";
+        /** Last `extract` input; used by {@link reassemble}. */
+        this.lastOriginalContent = "";
+    }
+    canHandle(filepath) {
+        return filepath.toLowerCase().endsWith(".json");
+    }
+    extract(content, filepath) {
+        this.lastOriginalContent = content;
+        const segments = [];
+        let segmentIndex = 0;
+        const lines = content.split("\n");
+        let json;
+        try {
+            json = JSON.parse(content);
+        }
+        catch (e) {
+            throw new Error(`Failed to parse JSON file ${filepath}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const findLineNumber = (message, key) => {
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i] ?? "";
+                const keyPattern = new RegExp(`"${this.escapeRegex(key)}"\\s*:`);
+                if (keyPattern.test(line)) {
+                    return i + 1;
+                }
+            }
+            for (let i = 0; i < lines.length; i++) {
+                if ((lines[i] ?? "").includes(`"${message}"`)) {
+                    return i + 1;
+                }
+            }
+            return 1;
+        };
+        const walk = (obj, keyPrefix) => {
+            if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
+                return;
+            }
+            for (const [key, value] of Object.entries(obj)) {
+                const fullKey = keyPrefix ? `${keyPrefix}.${key}` : key;
+                if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+                    const entry = value;
+                    if (Object.prototype.hasOwnProperty.call(entry, "message")) {
+                        const message = entry.message;
+                        const description = entry.description;
+                        if (typeof message === "string") {
+                            const hash = this.computeHash(message);
+                            const startLine = findLineNumber(message, key);
+                            segments.push({
+                                id: `json-${segmentIndex++}`,
+                                type: "json",
+                                content: message,
+                                hash,
+                                translatable: true,
+                                startLine,
+                                jsonKey: fullKey,
+                                jsonDescription: description,
+                            });
+                        }
+                    }
+                    else {
+                        walk(value, fullKey);
+                    }
+                }
+            }
+        };
+        walk(json, "");
+        return segments;
+    }
+    reassemble(segments, translations) {
+        const originalContent = this.lastOriginalContent;
+        if (!originalContent) {
+            throw new Error("JsonExtractor.reassemble: call extract() first");
+        }
+        const originalJson = JSON.parse(originalContent);
+        const segmentMap = new Map();
+        const merged = this.mergeTranslations(segments, translations);
+        for (const seg of merged) {
+            if (seg.jsonKey) {
+                segmentMap.set(seg.jsonKey, seg);
+            }
+        }
+        const walk = (src, keyPrefix) => {
+            if (typeof src !== "object" || src === null) {
+                return src;
+            }
+            if (Array.isArray(src)) {
+                return src.map((item) => walk(item, keyPrefix));
+            }
+            const result = {};
+            for (const [key, value] of Object.entries(src)) {
+                const fullKey = keyPrefix ? `${keyPrefix}.${key}` : key;
+                if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+                    const entry = value;
+                    if (Object.prototype.hasOwnProperty.call(entry, "message")) {
+                        const seg = segmentMap.get(fullKey);
+                        const translatedMessage = seg ? seg.content : entry.message;
+                        const next = { message: translatedMessage };
+                        if (Object.prototype.hasOwnProperty.call(entry, "description")) {
+                            next.description = entry.description;
+                        }
+                        result[key] = next;
+                    }
+                    else {
+                        result[key] = walk(value, fullKey);
+                    }
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            return result;
+        };
+        return JSON.stringify(walk(originalJson, ""), null, 2) + "\n";
+    }
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+}
+//# sourceMappingURL=json-extractor.js.map

package/dist/extractors/json-extractor.js.map

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

package/dist/extractors/markdown-extractor.d.ts

@@ -0,0 +1,15 @@
+import type { LanguageListBlockConfig, Segment, SegmentTranslationMapValue } from "../core/types.js";
+import { BaseExtractor } from "./base-extractor.js";
+/** Optional extraction behavior for markdown docs (e.g. skip language-list blocks from translation). */
+export type MarkdownExtractOptions = {
+    languageListBlock?: LanguageListBlockConfig;
+};
+export declare class MarkdownExtractor extends BaseExtractor {
+    readonly name = "markdown";
+    canHandle(filepath: string): boolean;
+    extract(content: string, filepath: string, options?: MarkdownExtractOptions): Segment[];
+    reassemble(segments: Segment[], translations: Map<string, SegmentTranslationMapValue>): string;
+    private splitBody;
+    private classifySegment;
+}
+//# sourceMappingURL=markdown-extractor.d.ts.map

package/dist/extractors/markdown-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/markdown-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,OAAO,EACP,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wGAAwG;AACxG,MAAM,MAAM,sBAAsB,GAAG;IACnC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C,CAAC;AAKF,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,IAAI,cAAc;IAE3B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,EAAE;IAkCvF,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,GAAG,MAAM;IAoB9F,OAAO,CAAC,SAAS;IAkIjB,OAAO,CAAC,eAAe;CAyCxB"}

package/dist/extractors/markdown-extractor.js

@@ -0,0 +1,205 @@
+import { matter, stringify as matterStringify } from "gray-matter-es";
+import { extractLanguageListBlock } from "../processors/doc-postprocess.js";
+import { BaseExtractor } from "./base-extractor.js";
+/** CommonMark fenced code: line starts (after optional indent) with 3+ ``` or 3+ ~~~. */
+const MD_CODE_FENCE_LINE_RE = /^\s*(?:`{3,}|~{3,})/;
+export class MarkdownExtractor extends BaseExtractor {
+    constructor() {
+        super(...arguments);
+        this.name = "markdown";
+    }
+    canHandle(filepath) {
+        return /\.mdx?$/i.test(filepath);
+    }
+    extract(content, filepath, options) {
+        void filepath;
+        const segments = [];
+        let segmentIndex = 0;
+        const { data: frontMatter, content: body } = matter(content);
+        if (Object.keys(frontMatter).length > 0) {
+            const frontMatterStr = matterStringify("", frontMatter).trim();
+            segments.push({
+                id: `seg-${segmentIndex++}`,
+                type: "frontmatter",
+                content: frontMatterStr,
+                hash: this.computeHash(frontMatterStr),
+                translatable: true,
+                startLine: 1,
+            });
+        }
+        const bodyStartLine = 1 + (content.substring(0, content.indexOf(body)).match(/\n/g) || []).length;
+        const bodySegments = this.splitBody(body, bodyStartLine, options?.languageListBlock);
+        for (const seg of bodySegments) {
+            segments.push({
+                id: `seg-${segmentIndex++}`,
+                ...seg,
+                hash: this.computeHash(seg.content),
+            });
+        }
+        return segments;
+    }
+    reassemble(segments, translations) {
+        const merged = this.mergeTranslations(segments, translations);
+        const parts = [];
+        for (let i = 0; i < merged.length; i++) {
+            const segment = merged[i];
+            if (!segment) {
+                continue;
+            }
+            if (segment.type === "frontmatter") {
+                parts.push(segment.content);
+                parts.push("");
+            }
+            else {
+                parts.push(segment.content);
+            }
+        }
+        return parts.join("\n\n").trim() + "\n";
+    }
+    splitBody(body, bodyStartLine, languageListBlock) {
+        const segments = [];
+        const lines = body.split("\n");
+        const langListExt = languageListBlock !== undefined ? extractLanguageListBlock(body, languageListBlock) : null;
+        const langListStart = langListExt?.startLine ?? -1;
+        const langListEnd = langListExt?.endLine ?? -1;
+        let currentSegment = [];
+        let currentSegmentStartLine = 0;
+        let inCodeBlock = false;
+        let inAdmonition = false;
+        let codeBlockContent = [];
+        let codeBlockStartLine = 0;
+        let admonitionContent = [];
+        let admonitionStartLine = 0;
+        const flushCurrentSegment = () => {
+            if (currentSegment.length > 0) {
+                const segContent = currentSegment.join("\n").trim();
+                if (segContent) {
+                    segments.push(this.classifySegment(segContent, bodyStartLine + currentSegmentStartLine));
+                }
+                currentSegment = [];
+            }
+        };
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex] ?? "";
+            if (MD_CODE_FENCE_LINE_RE.test(line)) {
+                if (inCodeBlock) {
+                    codeBlockContent.push(line);
+                    segments.push({
+                        type: "code",
+                        content: codeBlockContent.join("\n"),
+                        translatable: false,
+                        startLine: bodyStartLine + codeBlockStartLine,
+                    });
+                    codeBlockContent = [];
+                    inCodeBlock = false;
+                }
+                else {
+                    flushCurrentSegment();
+                    codeBlockContent.push(line);
+                    codeBlockStartLine = lineIndex;
+                    inCodeBlock = true;
+                }
+                continue;
+            }
+            if (inCodeBlock) {
+                codeBlockContent.push(line);
+                continue;
+            }
+            if (langListStart !== -1 && lineIndex === langListStart && !inAdmonition) {
+                flushCurrentSegment();
+                const blockLines = lines.slice(langListStart, langListEnd + 1);
+                segments.push({
+                    type: "other",
+                    content: blockLines.join("\n"),
+                    translatable: false,
+                    startLine: bodyStartLine + langListStart,
+                });
+                lineIndex = langListEnd;
+                continue;
+            }
+            if (line.match(/^:::\w+/)) {
+                flushCurrentSegment();
+                admonitionContent.push(line);
+                admonitionStartLine = lineIndex;
+                inAdmonition = true;
+                continue;
+            }
+            if (line === ":::" && inAdmonition) {
+                admonitionContent.push(line);
+                segments.push({
+                    type: "admonition",
+                    content: admonitionContent.join("\n"),
+                    translatable: true,
+                    startLine: bodyStartLine + admonitionStartLine,
+                });
+                admonitionContent = [];
+                inAdmonition = false;
+                continue;
+            }
+            if (inAdmonition) {
+                admonitionContent.push(line);
+                continue;
+            }
+            if (line.trim() === "") {
+                flushCurrentSegment();
+                continue;
+            }
+            if (currentSegment.length === 0) {
+                currentSegmentStartLine = lineIndex;
+            }
+            currentSegment.push(line);
+        }
+        flushCurrentSegment();
+        if (codeBlockContent.length > 0) {
+            segments.push({
+                type: "code",
+                content: codeBlockContent.join("\n"),
+                translatable: false,
+                startLine: bodyStartLine + codeBlockStartLine,
+            });
+        }
+        if (admonitionContent.length > 0) {
+            segments.push({
+                type: "admonition",
+                content: admonitionContent.join("\n"),
+                translatable: true,
+                startLine: bodyStartLine + admonitionStartLine,
+            });
+        }
+        return segments;
+    }
+    classifySegment(content, startLine) {
+        const trimmed = content.trim();
+        const isSingleLine = !trimmed.includes("\n");
+        if (/^<br\s*\/?>$/i.test(trimmed)) {
+            return { type: "other", content, translatable: false, startLine };
+        }
+        if (/^---+$/.test(trimmed)) {
+            return { type: "other", content, translatable: false, startLine };
+        }
+        if (isSingleLine) {
+            const textOnly = trimmed
+                .replace(/`[^`]*`/g, "")
+                .replace(/!\[[^\]]*\]\([^)]*\)/g, "")
+                .replace(/\[[^\]]*\]\([^)]*\)/g, "")
+                .replace(/[*_#>-]/g, "")
+                .replace(/[()[\]{}<>]/g, "")
+                .replace(/<[^>]+>/g, "")
+                .trim();
+            if (!/[A-Za-z0-9]/.test(textOnly)) {
+                return { type: "other", content, translatable: false, startLine };
+            }
+        }
+        if (content.match(/^#{1,6}\s/)) {
+            return { type: "heading", content, translatable: true, startLine };
+        }
+        if (content.match(/^!\[.*\]\(.*\)$/)) {
+            return { type: "other", content, translatable: false, startLine };
+        }
+        if (content.startsWith("import ") || /^<[A-Z]/.test(trimmed) || /^<\/\w+>$/.test(trimmed)) {
+            return { type: "other", content, translatable: false, startLine };
+        }
+        return { type: "paragraph", content, translatable: true, startLine };
+    }
+}
+//# sourceMappingURL=markdown-extractor.js.map

package/dist/extractors/markdown-extractor.js.map

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

package/dist/extractors/svg-extractor.d.ts

@@ -0,0 +1,19 @@
+import type { Segment, SegmentTranslationMapValue } from "../core/types.js";
+import { BaseExtractor } from "./base-extractor.js";
+export interface SvgExtractorOptions {
+    forceLowercase?: boolean;
+}
+/**
+ * SVG `<text>` / `<title>` / `<desc>` extraction (regex-based).
+ * `reassemble` uses the SVG from the last `extract` call on this instance.
+ */
+export declare class SvgExtractor extends BaseExtractor {
+    private readonly options;
+    readonly name = "svg";
+    private lastSvg;
+    constructor(options?: SvgExtractorOptions);
+    canHandle(filepath: string): boolean;
+    extract(content: string, filepath: string): Segment[];
+    reassemble(segments: Segment[], translations: Map<string, SegmentTranslationMapValue>): string;
+}
+//# sourceMappingURL=svg-extractor.d.ts.map

package/dist/extractors/svg-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/svg-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsBpD,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAKjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,OAAO,CAAM;gBAEQ,OAAO,GAAE,mBAAwB;IAI9D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAsErD,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,GAAG,MAAM;CAiC/F"}

package/dist/extractors/svg-extractor.js

@@ -0,0 +1,132 @@
+import { BaseExtractor } from "./base-extractor.js";
+const TEXT_TAG_RE = /<text([\s\S]*?)>([\s\S]*?)<\/text>/gi;
+const TITLE_TAG_RE = /<title([\s\S]*?)>([\s\S]*?)<\/title>/gi;
+const DESC_TAG_RE = /<desc([\s\S]*?)>([\s\S]*?)<\/desc>/gi;
+function extractTextFromXml(xml) {
+    return xml
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/**
+ * SVG `<text>` / `<title>` / `<desc>` extraction (regex-based).
+ * `reassemble` uses the SVG from the last `extract` call on this instance.
+ */
+export class SvgExtractor extends BaseExtractor {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this.name = "svg";
+        this.lastSvg = "";
+    }
+    canHandle(filepath) {
+        return filepath.toLowerCase().endsWith(".svg");
+    }
+    extract(content, filepath) {
+        void filepath;
+        this.lastSvg = content;
+        const segments = [];
+        let i = 0;
+        let match;
+        TEXT_TAG_RE.lastIndex = 0;
+        while ((match = TEXT_TAG_RE.exec(content)) !== null) {
+            const attrs = match[1] ?? "";
+            const innerContent = match[2] ?? "";
+            const text = extractTextFromXml(innerContent);
+            if (!text) {
+                continue;
+            }
+            const fullMatch = match[0];
+            const openingTag = `<text${attrs}>`;
+            segments.push({
+                id: `svg-${i++}`,
+                type: "svg-text",
+                content: text,
+                hash: this.computeHash(text),
+                translatable: true,
+                svg: { element: "text", fullMatch, openingTag },
+            });
+        }
+        TITLE_TAG_RE.lastIndex = 0;
+        while ((match = TITLE_TAG_RE.exec(content)) !== null) {
+            const attrs = match[1] ?? "";
+            const innerContent = match[2] ?? "";
+            const text = extractTextFromXml(innerContent);
+            if (!text) {
+                continue;
+            }
+            const fullMatch = match[0];
+            const openingTag = (attrs || "").trim();
+            segments.push({
+                id: `svg-${i++}`,
+                type: "svg-text",
+                content: text,
+                hash: this.computeHash(text),
+                translatable: true,
+                svg: { element: "title", fullMatch, openingTag },
+            });
+        }
+        DESC_TAG_RE.lastIndex = 0;
+        while ((match = DESC_TAG_RE.exec(content)) !== null) {
+            const attrs = match[1] ?? "";
+            const innerContent = match[2] ?? "";
+            const text = extractTextFromXml(innerContent);
+            if (!text) {
+                continue;
+            }
+            const fullMatch = match[0];
+            const openingTag = (attrs || "").trim();
+            segments.push({
+                id: `svg-${i++}`,
+                type: "svg-text",
+                content: text,
+                hash: this.computeHash(text),
+                translatable: true,
+                svg: { element: "desc", fullMatch, openingTag },
+            });
+        }
+        return segments;
+    }
+    reassemble(segments, translations) {
+        if (!this.lastSvg) {
+            throw new Error("SvgExtractor.reassemble: call extract() first");
+        }
+        let result = this.lastSvg;
+        const merged = this.mergeTranslations(segments, translations);
+        for (const segment of merged) {
+            const meta = segment.svg;
+            if (!meta) {
+                continue;
+            }
+            let out = segment.content;
+            if (this.options.forceLowercase) {
+                out = out.toLowerCase();
+            }
+            const escaped = escapeXml(out);
+            if (meta.element === "text") {
+                const newContent = `${meta.openingTag}<tspan>${escaped}</tspan></text>`;
+                result = result.replace(meta.fullMatch, newContent);
+            }
+            else if (meta.element === "title") {
+                const attrs = meta.openingTag ? ` ${meta.openingTag}` : "";
+                const newContent = `<title${attrs}>${escaped}</title>`;
+                result = result.replace(meta.fullMatch, newContent);
+            }
+            else {
+                const attrs = meta.openingTag ? ` ${meta.openingTag}` : "";
+                const newContent = `<desc${attrs}>${escaped}</desc>`;
+                result = result.replace(meta.fullMatch, newContent);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=svg-extractor.js.map

package/dist/extractors/svg-extractor.js.map

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

package/dist/extractors/ui-string-extractor.d.ts

@@ -0,0 +1,40 @@
+import type { Segment, SegmentTranslationMapValue, UIStringExtractorConfig } from "../core/types.js";
+import { BaseExtractor } from "./base-extractor.js";
+/**
+ * UI string extraction via `i18next-scanner`. Scans any JS/TS source files for
+ * `t("literal")` / `i18n.t("literal")` calls (configurable via `funcNames`).
+ * Works in React, Next.js, Node.js, and any other JS/TS codebase using i18next.
+ * Segment hashes are MD5 first 8 hex (keys in `strings.json`).
+ */
+export declare class UIStringExtractor extends BaseExtractor {
+    readonly name = "ui-string";
+    private readonly extensions;
+    private readonly funcNames;
+    private readonly includePackageDescription;
+    private readonly packageJsonPath;
+    /** Locale key used when {@link reassemble} writes `translated` (single-locale snapshot). */
+    private readonly defaultReassembleLocale;
+    constructor(config?: Partial<UIStringExtractorConfig>, options?: {
+        cwd?: string;
+        defaultReassembleLocale?: string;
+    });
+    protected computeHash(content: string): string;
+    canHandle(filepath: string): boolean;
+    extract(content: string, filepath: string): Segment[];
+    /** Optional `package.json` description as a UI string (About tab pattern). */
+    packageDescriptionSegments(): Segment[];
+    /**
+     * Merge package description segments into a deduped list (by hash).
+     */
+    mergePackageDescription(fileSegments: Segment[]): Segment[];
+    /**
+     * Build `strings.json` body: `{ [hash]: { source, translated: { [locale]: text } } }`.
+     * Existing file is merged when `existingPath` exists.
+     */
+    buildStringsJson(segments: Segment[], translationsByLocale: Record<string, Map<string, SegmentTranslationMapValue>>, existingPath?: string): string;
+    /**
+     * `ContentExtractor` reassemble: emit `strings.json` snapshot with one locale (`defaultReassembleLocale`).
+     */
+    reassemble(segments: Segment[], translations: Map<string, SegmentTranslationMapValue>): string;
+}
+//# sourceMappingURL=ui-string-extractor.d.ts.map

package/dist/extractors/ui-string-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-string-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/ui-string-extractor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EACP,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;gBAG/C,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,EACzC,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAAO;IAclE,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI9C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IA8BrD,8EAA8E;IAC9E,0BAA0B,IAAI,OAAO,EAAE;IA0BvC;;OAEG;IACH,uBAAuB,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAa3D;;;OAGG;IACH,gBAAgB,CACd,QAAQ,EAAE,OAAO,EAAE,EACnB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,EAC7E,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM;IA8CT;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,GAAG,MAAM;CAG/F"}