ai-i18n-tools 1.0.0

package/dist/extractors/ui-string-extractor.js

@@ -0,0 +1,146 @@
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+import { Parser } from "i18next-scanner";
+import { segmentTranslationText } from "../core/types.js";
+import { BaseExtractor } from "./base-extractor.js";
+const DEFAULT_EXT = [".js", ".jsx", ".ts", ".tsx"];
+const DEFAULT_FUNCS = ["t", "i18n.t"];
+/**
+ * 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 class UIStringExtractor extends BaseExtractor {
+    constructor(config, options = {}) {
+        super();
+        this.name = "ui-string";
+        const cwd = options.cwd ?? process.cwd();
+        const ext = config?.extensions ?? DEFAULT_EXT;
+        this.extensions = new Set(ext.map((e) => (e.startsWith(".") ? e.toLowerCase() : `.${e.toLowerCase()}`)));
+        this.funcNames = config?.funcNames ?? DEFAULT_FUNCS;
+        this.includePackageDescription = config?.includePackageDescription ?? true;
+        this.packageJsonPath = path.resolve(cwd, config?.packageJsonPath ?? "package.json");
+        this.defaultReassembleLocale = options.defaultReassembleLocale ?? "en";
+    }
+    computeHash(content) {
+        return crypto.createHash("md5").update(content).digest("hex").slice(0, 8);
+    }
+    canHandle(filepath) {
+        const ext = path.extname(filepath).toLowerCase();
+        return this.extensions.has(ext);
+    }
+    extract(content, filepath) {
+        void filepath;
+        const found = new Map();
+        const parser = new Parser({
+            func: { list: this.funcNames, extensions: Array.from(this.extensions) },
+            nsSeparator: false,
+            keySeparator: false,
+        });
+        parser.parseFuncFromString(content, (key) => {
+            const str = key.trim();
+            if (str) {
+                found.set(this.computeHash(str), str);
+            }
+        });
+        const segments = [];
+        let i = 0;
+        for (const [hash, text] of found) {
+            segments.push({
+                id: `ui-${i++}`,
+                type: "ui-string",
+                content: text,
+                hash,
+                translatable: true,
+            });
+        }
+        return segments;
+    }
+    /** Optional `package.json` description as a UI string (About tab pattern). */
+    packageDescriptionSegments() {
+        if (!this.includePackageDescription || !fs.existsSync(this.packageJsonPath)) {
+            return [];
+        }
+        try {
+            const pkg = JSON.parse(fs.readFileSync(this.packageJsonPath, "utf8"));
+            const desc = typeof pkg.description === "string" ? pkg.description.trim() : "";
+            if (!desc) {
+                return [];
+            }
+            return [
+                {
+                    id: "ui-pkg-description",
+                    type: "ui-string",
+                    content: desc,
+                    hash: this.computeHash(desc),
+                    translatable: true,
+                },
+            ];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Merge package description segments into a deduped list (by hash).
+     */
+    mergePackageDescription(fileSegments) {
+        const byHash = new Map();
+        for (const s of fileSegments) {
+            byHash.set(s.hash, s);
+        }
+        for (const s of this.packageDescriptionSegments()) {
+            if (!byHash.has(s.hash)) {
+                byHash.set(s.hash, s);
+            }
+        }
+        return Array.from(byHash.values());
+    }
+    /**
+     * Build `strings.json` body: `{ [hash]: { source, translated: { [locale]: text } } }`.
+     * Existing file is merged when `existingPath` exists.
+     */
+    buildStringsJson(segments, translationsByLocale, existingPath) {
+        let existing = {};
+        if (existingPath && fs.existsSync(existingPath)) {
+            try {
+                existing = JSON.parse(fs.readFileSync(existingPath, "utf8"));
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        const output = {};
+        for (const [h, str] of segments.map((s) => [s.hash, s.content])) {
+            const prev = existing[h];
+            const translated = prev && typeof prev.translated === "object" && prev.translated
+                ? { ...prev.translated }
+                : {};
+            for (const [locale, map] of Object.entries(translationsByLocale)) {
+                const raw = map.get(h);
+                const t = segmentTranslationText(raw);
+                if (t !== undefined && t !== "") {
+                    translated[locale] = t;
+                }
+            }
+            const preservedModels = prev && typeof prev.models === "object" && prev.models ? { ...prev.models } : undefined;
+            const base = prev && typeof prev === "object" && typeof prev.source === "string"
+                ? { source: str, translated: { ...(prev.translated ?? {}), ...translated } }
+                : { source: str, translated };
+            output[h] =
+                preservedModels && Object.keys(preservedModels).length > 0
+                    ? { ...base, models: preservedModels }
+                    : base;
+        }
+        return `${JSON.stringify(output, null, 2)}\n`;
+    }
+    /**
+     * `ContentExtractor` reassemble: emit `strings.json` snapshot with one locale (`defaultReassembleLocale`).
+     */
+    reassemble(segments, translations) {
+        return this.buildStringsJson(segments, { [this.defaultReassembleLocale]: translations });
+    }
+}
+//# sourceMappingURL=ui-string-extractor.js.map

package/dist/extractors/ui-string-extractor.js.map

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

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

@@ -0,0 +1,23 @@
+import type { UIStringExtractorConfig } from "../core/types.js";
+export type UiStringLocation = {
+    file: string;
+    line: number;
+};
+/** MD5 first 8 hex - must match {@link UIStringExtractor} / strings.json keys. */
+export declare function uiStringHash(content: string): string;
+/**
+ * Collect per-hash source locations from one file's content (JS/TS).
+ */
+export declare function collectUiStringLocationsFromSource(content: string, relPath: string, funcNames: string[]): Map<string, UiStringLocation[]>;
+/** Line of `"description"` in package.json, or 1. */
+export declare function packageJsonDescriptionLocation(packageJsonPath: string, cwd: string): UiStringLocation;
+/**
+ * Merge location maps from all scanned files and optional package.json description.
+ */
+export declare function aggregateUiStringLocations(files: string[], readFile: (rel: string) => string, funcNames: string[], options: {
+    packageJsonPath?: string;
+    cwd: string;
+    includePackageDescription?: boolean;
+}): Map<string, UiStringLocation[]>;
+export declare function defaultFuncNamesFromConfig(config?: Partial<UIStringExtractorConfig>): string[];
+//# sourceMappingURL=ui-string-locations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-string-locations.d.ts","sourceRoot":"","sources":["../../src/extractors/ui-string-locations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AA0BD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAsCjC;AAoBD,qDAAqD;AACrD,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,GACV,gBAAgB,CAiBlB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACjC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACA,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAwBjC;AAED,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,MAAM,EAAE,CAE9F"}

package/dist/extractors/ui-string-locations.js

@@ -0,0 +1,138 @@
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+import { Parser } from "i18next-scanner";
+/** MD5 first 8 hex - must match {@link UIStringExtractor} / strings.json keys. */
+export function uiStringHash(content) {
+    return crypto.createHash("md5").update(content).digest("hex").slice(0, 8);
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Same core pattern as i18next-scanner `parseFuncFromString` (lib/parser.js) so
+ * location hashes align with extracted strings.
+ */
+function buildParseFuncRegExp(funcNames) {
+    const matchFuncs = funcNames.map((func) => `(?:${escapeRegExp(func)})`).join("|");
+    const matchSpecialCharacters = "[\\r\\n\\s]*";
+    const stringPart = "`(?:[^`\\\\]|\\\\(?:.|$))*`" +
+        "|" +
+        '"(?:[^"\\\\]|\\\\(?:.|$))*"' +
+        "|" +
+        "'(?:[^'\\\\]|\\\\(?:.|$))*'";
+    const stringGroup = `${matchSpecialCharacters}(${stringPart})${matchSpecialCharacters}`;
+    const stringNoGroup = `${matchSpecialCharacters}(?:${stringPart})${matchSpecialCharacters}`;
+    const keys = `(${stringNoGroup}|\\[${stringNoGroup}(?:[,]${stringNoGroup})?\\])`;
+    const pattern = `(?:(?:^\\s*)|[^a-zA-Z0-9_])(?:${matchFuncs})\\(${keys}(?:[,]${stringGroup})?[,\\)]`;
+    return new RegExp(pattern, "gim");
+}
+/**
+ * Collect per-hash source locations from one file's content (JS/TS).
+ */
+export function collectUiStringLocationsFromSource(content, relPath, funcNames) {
+    const out = new Map();
+    const parser = new Parser({
+        func: { list: funcNames, extensions: [".ts"] },
+        nsSeparator: false,
+        keySeparator: false,
+    });
+    const fixKeys = parser.fixStringAfterRegExpAsArray.bind(parser);
+    const re = buildParseFuncRegExp(funcNames);
+    const relNorm = relPath.replace(/\\/g, "/");
+    let m;
+    const seen = new Set();
+    while ((m = re.exec(content)) !== null) {
+        const idx = m.index;
+        const line = 1 + (content.slice(0, idx).match(/\n/g) ?? []).length;
+        let keyParts;
+        try {
+            keyParts = fixKeys(m[1] ?? "");
+        }
+        catch {
+            continue;
+        }
+        for (const raw of keyParts) {
+            const str = String(raw).trim();
+            if (!str)
+                continue;
+            const h = uiStringHash(str);
+            const loc = { file: relNorm, line };
+            const dedupeKey = `${h}:${relNorm}:${line}`;
+            if (seen.has(dedupeKey))
+                continue;
+            seen.add(dedupeKey);
+            const list = out.get(h) ?? [];
+            list.push(loc);
+            out.set(h, list);
+        }
+    }
+    return out;
+}
+function mergeLocationMaps(into, from) {
+    for (const [h, locs] of from) {
+        const cur = into.get(h) ?? [];
+        const seen = new Set(cur.map((l) => `${l.file}:${l.line}`));
+        for (const l of locs) {
+            const k = `${l.file}:${l.line}`;
+            if (!seen.has(k)) {
+                seen.add(k);
+                cur.push(l);
+            }
+        }
+        into.set(h, cur);
+    }
+}
+/** Line of `"description"` in package.json, or 1. */
+export function packageJsonDescriptionLocation(packageJsonPath, cwd) {
+    const rel = path.relative(cwd, packageJsonPath) || "package.json";
+    const relNorm = rel.replace(/\\/g, "/");
+    let line = 1;
+    try {
+        const text = fs.readFileSync(packageJsonPath, "utf8");
+        const lines = text.split(/\r?\n/);
+        for (let i = 0; i < lines.length; i++) {
+            if (/^\s*"description"\s*:/.test(lines[i])) {
+                line = i + 1;
+                break;
+            }
+        }
+    }
+    catch {
+        /* keep line 1 */
+    }
+    return { file: relNorm, line };
+}
+/**
+ * Merge location maps from all scanned files and optional package.json description.
+ */
+export function aggregateUiStringLocations(files, readFile, funcNames, options) {
+    const merged = new Map();
+    for (const rel of files) {
+        const content = readFile(rel);
+        const map = collectUiStringLocationsFromSource(content, rel, funcNames);
+        mergeLocationMaps(merged, map);
+    }
+    if (options.includePackageDescription !== false && options.packageJsonPath) {
+        const pkgPath = options.packageJsonPath;
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+                const desc = typeof pkg.description === "string" ? pkg.description.trim() : "";
+                if (desc) {
+                    const h = uiStringHash(desc);
+                    const loc = packageJsonDescriptionLocation(pkgPath, options.cwd);
+                    mergeLocationMaps(merged, new Map([[h, [loc]]]));
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    return merged;
+}
+export function defaultFuncNamesFromConfig(config) {
+    return config?.funcNames ?? ["t", "i18n.t"];
+}
+//# sourceMappingURL=ui-string-locations.js.map

package/dist/extractors/ui-string-locations.js.map

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

package/dist/glossary/glossary.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Terminology for doc translation: `strings.json` and/or CSV, with user overrides.
+ */
+export declare class Glossary {
+    private readonly terms;
+    /** Term count after loading UI strings / UI CSV (before user glossary merge). */
+    private readonly _uiStringsTermCount;
+    /** Terms whose key was first added when merging the user glossary CSV. */
+    private readonly _userGlossaryTermCount;
+    constructor(glossaryUiPath: string | undefined, glossaryUserPath: string | undefined, targetLocales?: string[]);
+    /** Terms from `strings.json` / UI glossary file (before user CSV merge). */
+    get uiStringsTermCount(): number;
+    /** Terms first introduced by the user glossary CSV (new keys not present after UI load). */
+    get userGlossaryTermCount(): number;
+    private loadFromStringsJson;
+    private loadUiCsv;
+    /**
+     * User CSV: `Original language string` / `en`, `locale`, `Translation` / `translation`.
+     * `locale` `*` applies to all `targetLocales`. Exact locale wins over `*` (applied first * then overwrite).
+     */
+    private loadUserCsv;
+    findTermsInText(text: string, locale: string): string[];
+    getTranslation(englishTerm: string, locale: string): string | undefined;
+    /**
+     * User-glossary `force` rows for this locale, longest match first (for placeholder protection).
+     */
+    getForcedTermEntriesForLocale(locale: string): Array<{
+        english: string;
+        termLower: string;
+        replacement: string;
+    }>;
+    get size(): number;
+}
+//# sourceMappingURL=glossary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/glossary/glossary.ts"],"names":[],"mappings":"AA+CA;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;gBAG9C,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,aAAa,GAAE,MAAM,EAAO;IAqB9B,4EAA4E;IAC5E,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,4FAA4F;IAC5F,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,SAAS;IAkCjB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA6EnB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAyCvD,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;OAEG;IACH,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QACnD,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAgBF,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/glossary/glossary.js

@@ -0,0 +1,260 @@
+import fs from "fs";
+import { parse } from "csv-parse/sync";
+function looksLikeStringsJson(filepath) {
+    if (filepath.toLowerCase().endsWith(".json")) {
+        return true;
+    }
+    try {
+        const head = fs.readFileSync(filepath, "utf8").trimStart().slice(0, 1);
+        return head === "{";
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeRow(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        out[k.trim().toLowerCase()] = v;
+    }
+    return out;
+}
+function pickEnglish(row) {
+    const n = normalizeRow(row);
+    return (n["original language string"]?.trim() || n["en"]?.trim() || n["english"]?.trim() || undefined);
+}
+function pickLocale(row) {
+    const n = normalizeRow(row);
+    return n["locale"]?.trim();
+}
+function pickTranslation(row) {
+    const n = normalizeRow(row);
+    return n["translation"]?.trim();
+}
+function pickForce(row) {
+    const n = normalizeRow(row);
+    const v = n["force"]?.trim().toLowerCase();
+    return v === "true" || v === "yes" || v === "1";
+}
+/**
+ * Terminology for doc translation: `strings.json` and/or CSV, with user overrides.
+ */
+export class Glossary {
+    constructor(glossaryUiPath, glossaryUserPath, targetLocales = []) {
+        this.terms = new Map();
+        if (glossaryUiPath && fs.existsSync(glossaryUiPath)) {
+            if (looksLikeStringsJson(glossaryUiPath)) {
+                this.loadFromStringsJson(glossaryUiPath);
+            }
+            else {
+                this.loadUiCsv(glossaryUiPath);
+            }
+        }
+        else if (glossaryUiPath) {
+            /* optional: missing file */
+        }
+        this._uiStringsTermCount = this.terms.size;
+        const sizeBeforeUser = this.terms.size;
+        if (glossaryUserPath && fs.existsSync(glossaryUserPath)) {
+            this.loadUserCsv(glossaryUserPath, targetLocales);
+        }
+        this._userGlossaryTermCount = this.terms.size - sizeBeforeUser;
+    }
+    /** Terms from `strings.json` / UI glossary file (before user CSV merge). */
+    get uiStringsTermCount() {
+        return this._uiStringsTermCount;
+    }
+    /** Terms first introduced by the user glossary CSV (new keys not present after UI load). */
+    get userGlossaryTermCount() {
+        return this._userGlossaryTermCount;
+    }
+    loadFromStringsJson(filepath) {
+        const raw = JSON.parse(fs.readFileSync(filepath, "utf8"));
+        let count = 0;
+        for (const value of Object.values(raw)) {
+            if (!value || typeof value !== "object") {
+                continue;
+            }
+            const rec = value;
+            const source = typeof rec.source === "string" ? rec.source.trim() : "";
+            if (!source) {
+                continue;
+            }
+            const translations = {};
+            if (rec.translated && typeof rec.translated === "object") {
+                for (const [loc, text] of Object.entries(rec.translated)) {
+                    if (typeof text === "string" && text.trim()) {
+                        translations[loc] = text.trim();
+                    }
+                }
+            }
+            if (Object.keys(translations).length === 0) {
+                continue;
+            }
+            this.terms.set(source.toLowerCase(), {
+                english: source,
+                translations,
+                partOfSpeech: "unknown",
+            });
+            count++;
+        }
+        console.log(`✓ Loaded ${count} glossary terms from strings.json (UI)`);
+    }
+    loadUiCsv(filepath) {
+        const content = fs.readFileSync(filepath, "utf8");
+        const rows = parse(content, {
+            columns: true,
+            skip_empty_lines: true,
+            trim: true,
+        });
+        for (const row of rows) {
+            const english = row["en"]?.trim() || pickEnglish(row);
+            if (!english) {
+                continue;
+            }
+            const term = {
+                english,
+                translations: {},
+                partOfSpeech: "unknown",
+            };
+            for (const [col, val] of Object.entries(row)) {
+                const c = col.trim();
+                const cl = c.toLowerCase();
+                if (cl === "en" || cl === "original language string" || cl === "english" || !val?.trim()) {
+                    continue;
+                }
+                if (cl === "locale" || cl === "translation") {
+                    continue;
+                }
+                term.translations[c] = val.trim();
+            }
+            this.terms.set(english.toLowerCase(), term);
+        }
+        console.log(`✓ Loaded ${this.terms.size} glossary terms from UI CSV`);
+    }
+    /**
+     * User CSV: `Original language string` / `en`, `locale`, `Translation` / `translation`.
+     * `locale` `*` applies to all `targetLocales`. Exact locale wins over `*` (applied first * then overwrite).
+     */
+    loadUserCsv(filepath, targetLocales) {
+        const content = fs.readFileSync(filepath, "utf8");
+        const rows = parse(content, {
+            columns: true,
+            skip_empty_lines: true,
+            trim: true,
+        });
+        const starRows = [];
+        const exactRows = [];
+        for (const row of rows) {
+            const english = pickEnglish(row);
+            const locale = pickLocale(row);
+            const translation = pickTranslation(row);
+            if (!english || !locale || !translation) {
+                continue;
+            }
+            const force = pickForce(row);
+            if (locale === "*") {
+                starRows.push({ english, translation, force });
+            }
+            else {
+                exactRows.push({ english, locale, translation, force });
+            }
+        }
+        let userOverrideRowCount = 0;
+        const ensureForced = (term) => {
+            if (!term.forcedByLocale) {
+                term.forcedByLocale = {};
+            }
+            return term.forcedByLocale;
+        };
+        for (const { english, translation, force } of starRows) {
+            if (targetLocales.length === 0) {
+                continue;
+            }
+            const key = english.toLowerCase();
+            let term = this.terms.get(key);
+            if (!term) {
+                term = { english, translations: {}, partOfSpeech: "unknown" };
+                this.terms.set(key, term);
+            }
+            const fm = ensureForced(term);
+            for (const loc of targetLocales) {
+                if (!term.translations[loc]) {
+                    term.translations[loc] = translation;
+                    fm[loc] = force;
+                }
+            }
+            userOverrideRowCount++;
+        }
+        for (const { english, locale, translation, force } of exactRows) {
+            const key = english.toLowerCase();
+            let term = this.terms.get(key);
+            if (!term) {
+                term = { english, translations: {}, partOfSpeech: "unknown" };
+                this.terms.set(key, term);
+            }
+            term.translations[locale] = translation;
+            ensureForced(term)[locale] = force;
+            userOverrideRowCount++;
+        }
+        if (userOverrideRowCount > 0) {
+            console.log(`✓ Loaded ${userOverrideRowCount} user glossary overrides`);
+        }
+    }
+    findTermsInText(text, locale) {
+        const hints = [];
+        const textLower = text.toLowerCase();
+        const sortedTerms = Array.from(this.terms.entries()).sort((a, b) => b[0].length - a[0].length);
+        const matchedPositions = new Set();
+        for (const [termLower, term] of sortedTerms) {
+            const translation = term.translations[locale];
+            if (!translation) {
+                continue;
+            }
+            let index = 0;
+            while ((index = textLower.indexOf(termLower, index)) !== -1) {
+                const beforeChar = index > 0 ? textLower[index - 1] : " ";
+                const afterChar = textLower[index + termLower.length] || " ";
+                const isWordBoundary = /[\s\p{P}]/u.test(beforeChar) && /[\s\p{P}]/u.test(afterChar);
+                if (!isWordBoundary) {
+                    index++;
+                    continue;
+                }
+                const positions = Array.from({ length: termLower.length }, (_, i) => index + i);
+                const hasOverlap = positions.some((pos) => matchedPositions.has(pos));
+                if (!hasOverlap) {
+                    hints.push(`- "${term.english}" → "${translation}"`);
+                    positions.forEach((pos) => matchedPositions.add(pos));
+                    break;
+                }
+                index++;
+            }
+        }
+        return hints;
+    }
+    getTranslation(englishTerm, locale) {
+        return this.terms.get(englishTerm.toLowerCase())?.translations[locale];
+    }
+    /**
+     * User-glossary `force` rows for this locale, longest match first (for placeholder protection).
+     */
+    getForcedTermEntriesForLocale(locale) {
+        const out = [];
+        for (const [termLower, term] of this.terms.entries()) {
+            if (!term.forcedByLocale?.[locale]) {
+                continue;
+            }
+            const replacement = term.translations[locale]?.trim();
+            if (!replacement) {
+                continue;
+            }
+            out.push({ english: term.english, termLower, replacement });
+        }
+        out.sort((a, b) => b.termLower.length - a.termLower.length);
+        return out;
+    }
+    get size() {
+        return this.terms.size;
+    }
+}
+//# sourceMappingURL=glossary.js.map

package/dist/glossary/glossary.js.map

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

package/dist/glossary/matcher.d.ts

@@ -0,0 +1,10 @@
+import type { Glossary } from "./glossary.js";
+/**
+ * Thin wrapper for prompt integration (plan §3.3 matching API).
+ */
+export declare class GlossaryMatcher {
+    private readonly glossary;
+    constructor(glossary: Glossary);
+    findTermsInText(text: string, locale: string): string[];
+}
+//# sourceMappingURL=matcher.d.ts.map