@katerynakhar/i18n-keeper 0.16.0

package/dist/formats/po.js

@@ -0,0 +1,202 @@
+import { readFileSync } from 'node:fs';
+import { FormatError } from './error.js';
+/**
+ * gettext .po / .pot.
+ *
+ * Two things make this format different from the others: the msgid *is* the
+ * source text, so a .pot with empty translations is a usable source locale; and
+ * the format already has a notion of an outdated translation — the fuzzy flag —
+ * which maps onto the same rule the translation memory feeds.
+ */
+export class PoParseError extends FormatError {
+    constructor(file, line, message) {
+        super(file, message, line);
+    }
+}
+const SIMPLE_ESCAPES = {
+    n: '\n',
+    t: '\t',
+    r: '\r',
+    a: '\x07',
+    b: '\b',
+    f: '\f',
+    v: '\v',
+    '"': '"',
+    '\\': '\\',
+};
+function unescape(raw) {
+    let out = '';
+    for (let i = 0; i < raw.length; i++) {
+        const ch = raw[i];
+        if (ch !== '\\') {
+            out += ch;
+            continue;
+        }
+        const next = raw[i + 1];
+        if (next === undefined) {
+            out += ch;
+            continue;
+        }
+        if (next in SIMPLE_ESCAPES) {
+            out += SIMPLE_ESCAPES[next];
+            i++;
+            continue;
+        }
+        if (next === 'x') {
+            const hex = /^[0-9A-Fa-f]{1,2}/.exec(raw.slice(i + 2));
+            if (hex) {
+                out += String.fromCharCode(Number.parseInt(hex[0], 16));
+                i += 1 + hex[0].length;
+                continue;
+            }
+        }
+        const octal = /^[0-7]{1,3}/.exec(raw.slice(i + 1));
+        if (octal) {
+            out += String.fromCharCode(Number.parseInt(octal[0], 8) & 0xff);
+            i += octal[0].length;
+            continue;
+        }
+        out += next;
+        i++;
+    }
+    return out;
+}
+/** A quoted chunk, as it appears after a keyword or on a continuation line. */
+function readQuoted(file, line, text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('"') || !trimmed.endsWith('"') || trimmed.length < 2) {
+        throw new PoParseError(file, line, 'Expected a quoted string');
+    }
+    return unescape(trimmed.slice(1, -1));
+}
+const KEYWORD = /^(msgctxt|msgid_plural|msgid|msgstr)(\[(\d+)\])?\s*(.*)$/;
+export function parsePo(text, file) {
+    const entries = [];
+    const lines = text.split(/\r?\n/);
+    // Assignments stay in the loop body rather than in closures, so the compiler
+    // can follow whether an entry is open.
+    let current = null;
+    let field = null;
+    let msgstrIndex = null;
+    let fuzzy = false;
+    let seenKeyword = false;
+    for (const [index, rawLine] of lines.entries()) {
+        const lineNo = index + 1;
+        const line = rawLine.trim();
+        // A blank line ends an entry; #~ marks one already removed from the
+        // catalogue, so its block is dropped rather than parsed.
+        if (line === '' || line.startsWith('#~')) {
+            if (current && seenKeyword)
+                entries.push(current);
+            current = null;
+            field = null;
+            msgstrIndex = null;
+            fuzzy = false;
+            seenKeyword = false;
+            continue;
+        }
+        if (line.startsWith('#')) {
+            if (line.startsWith('#,')) {
+                const flags = line
+                    .slice(2)
+                    .split(',')
+                    .map((f) => f.trim());
+                if (flags.includes('fuzzy')) {
+                    fuzzy = true;
+                    if (current)
+                        current.fuzzy = true;
+                }
+            }
+            continue;
+        }
+        const match = KEYWORD.exec(line);
+        if (match) {
+            if (!current) {
+                current = { context: null, msgid: '', msgidPlural: null, msgstr: [], fuzzy, line: lineNo };
+            }
+            const entry = current;
+            const keyword = match[1];
+            seenKeyword = true;
+            const value = readQuoted(file, lineNo, match[4] || '""');
+            if (keyword === 'msgstr') {
+                const at = match[3] === undefined ? 0 : Number.parseInt(match[3], 10);
+                entry.msgstr[at] = value;
+                msgstrIndex = at;
+                field = null;
+            }
+            else if (keyword === 'msgctxt') {
+                entry.context = value;
+                field = 'msgctxt';
+                msgstrIndex = null;
+            }
+            else if (keyword === 'msgid') {
+                entry.msgid = value;
+                field = 'msgid';
+                msgstrIndex = null;
+            }
+            else {
+                entry.msgidPlural = value;
+                field = 'msgid_plural';
+                msgstrIndex = null;
+            }
+            continue;
+        }
+        if (line.startsWith('"')) {
+            if (!current)
+                throw new PoParseError(file, lineNo, 'Continuation without a preceding keyword');
+            const entry = current;
+            const value = readQuoted(file, lineNo, line);
+            if (msgstrIndex !== null)
+                entry.msgstr[msgstrIndex] = (entry.msgstr[msgstrIndex] ?? '') + value;
+            else if (field === 'msgctxt')
+                entry.context = (entry.context ?? '') + value;
+            else if (field === 'msgid')
+                entry.msgid += value;
+            else if (field === 'msgid_plural')
+                entry.msgidPlural = (entry.msgidPlural ?? '') + value;
+            else
+                throw new PoParseError(file, lineNo, 'Continuation without a preceding keyword');
+            continue;
+        }
+        throw new PoParseError(file, lineNo, `Unexpected line: ${line.slice(0, 40)}`);
+    }
+    if (current && seenKeyword)
+        entries.push(current);
+    let nplurals = null;
+    const header = entries.find((e) => e.msgid === '' && e.context === null);
+    if (header) {
+        const declared = /nplurals\s*=\s*(\d+)/.exec(header.msgstr[0] ?? '');
+        if (declared)
+            nplurals = Number.parseInt(declared[1], 10);
+    }
+    return { entries: entries.filter((e) => e.msgid !== '' || e.context !== null), nplurals };
+}
+/** msgctxt disambiguates an otherwise identical msgid. */
+export function poKey(entry) {
+    return entry.context === null ? entry.msgid : `${entry.context}|${entry.msgid}`;
+}
+export function readPoLocale(file, namespace, _locale, isSource, target) {
+    const parsed = parsePo(readFileSync(file, 'utf8'), file);
+    if (parsed.nplurals !== null)
+        target.nplurals = parsed.nplurals;
+    for (const entry of parsed.entries) {
+        const base = namespace ? `${namespace}.${poKey(entry)}` : poKey(entry);
+        if (entry.msgidPlural === null) {
+            // The msgid is the source text by definition, whatever this catalogue
+            // has translated it to.
+            const value = isSource ? entry.msgid : (entry.msgstr[0] ?? '');
+            target.leaves.set(base, { value, kind: 'string', file, fuzzy: entry.fuzzy });
+            continue;
+        }
+        const sourceForms = [entry.msgid, entry.msgidPlural];
+        const count = Math.max(entry.msgstr.length, isSource ? sourceForms.length : 1);
+        target.plurals.set(base, entry.msgstr.length);
+        target.containers.add(base);
+        for (let i = 0; i < count; i++) {
+            const translated = entry.msgstr[i] ?? '';
+            const value = isSource ? sourceForms[Math.min(i, 1)] : translated;
+            target.leaves.set(`${base}.${i}`, { value, kind: 'string', file, fuzzy: entry.fuzzy });
+        }
+    }
+}
+//# sourceMappingURL=po.js.map

package/dist/formats/po.js.map

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

package/dist/formats/write.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Writing back into a locale file.
+ *
+ * Reading throws away everything that is not a key or a value: comments,
+ * quote styles, blank lines, anchors, translator notes. Writing must not, so
+ * none of these writers re-serialise a parsed tree. They edit the text in
+ * place — replacing the exact span of one value, or inserting one entry —
+ * and leave every byte they did not have a reason to touch.
+ */
+export interface Edit {
+    /** Key relative to this file, with any file-level namespace already removed. */
+    key: string;
+    value: string;
+}
+export interface WriteOutcome {
+    content: string;
+    /** Edits the format could not take, and why. */
+    skipped: Array<{
+        key: string;
+        reason: string;
+    }>;
+}
+export type LocaleWriter = (content: string, file: string, locale: string, edits: Edit[]) => WriteOutcome;
+/** Applies text edits from the end backwards, so earlier offsets stay valid. */
+export declare function spliceAll(content: string, edits: Array<{
+    start: number;
+    end: number;
+    text: string;
+}>): string;

package/dist/formats/write.js

@@ -0,0 +1,19 @@
+/**
+ * Writing back into a locale file.
+ *
+ * Reading throws away everything that is not a key or a value: comments,
+ * quote styles, blank lines, anchors, translator notes. Writing must not, so
+ * none of these writers re-serialise a parsed tree. They edit the text in
+ * place — replacing the exact span of one value, or inserting one entry —
+ * and leave every byte they did not have a reason to touch.
+ */
+/** Applies text edits from the end backwards, so earlier offsets stay valid. */
+export function spliceAll(content, edits) {
+    const ordered = [...edits].sort((a, b) => b.start - a.start);
+    let out = content;
+    for (const edit of ordered) {
+        out = out.slice(0, edit.start) + edit.text + out.slice(edit.end);
+    }
+    return out;
+}
+//# sourceMappingURL=write.js.map

package/dist/formats/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/formats/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,gFAAgF;AAChF,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,KAA0D;IAE1D,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/formats/yaml-write.d.ts

@@ -0,0 +1,12 @@
+import type { Edit, WriteOutcome } from './write.js';
+/**
+ * YAML is the one format edited through a document model rather than by
+ * splicing text, because the library keeps comments, anchors and node styles
+ * across a round trip and a hand-rolled splicer would not.
+ *
+ * Two things are still done by hand. An existing scalar is mutated in place
+ * instead of replaced, so a block scalar stays a block scalar and keeps its
+ * comments. And an alias is refused outright: writing through `*shared` would
+ * silently break every other key that shares the anchor.
+ */
+export declare function writeYamlLocale(content: string, file: string, locale: string, edits: Edit[]): WriteOutcome;

package/dist/formats/yaml-write.js

@@ -0,0 +1,42 @@
+import { isAlias, isScalar, parseDocument } from 'yaml';
+import { FormatError } from './error.js';
+import { localeRootKey } from './yaml.js';
+/**
+ * YAML is the one format edited through a document model rather than by
+ * splicing text, because the library keeps comments, anchors and node styles
+ * across a round trip and a hand-rolled splicer would not.
+ *
+ * Two things are still done by hand. An existing scalar is mutated in place
+ * instead of replaced, so a block scalar stays a block scalar and keeps its
+ * comments. And an alias is refused outright: writing through `*shared` would
+ * silently break every other key that shares the anchor.
+ */
+export function writeYamlLocale(content, file, locale, edits) {
+    const doc = parseDocument(content);
+    if (doc.errors.length > 0) {
+        throw new FormatError(file, doc.errors[0].message);
+    }
+    const root = localeRootKey(doc.toJS(), locale);
+    const skipped = [];
+    for (const edit of edits) {
+        const path = (root ? [root] : []).concat(edit.key.split('.'));
+        const existing = doc.getIn(path, true);
+        if (isAlias(existing)) {
+            skipped.push({ key: edit.key, reason: 'the value is a YAML alias, shared with other keys' });
+            continue;
+        }
+        if (isScalar(existing)) {
+            // Keeps the node's style — block scalars stay block scalars.
+            existing.value = edit.value;
+            continue;
+        }
+        if (existing !== undefined && existing !== null) {
+            skipped.push({ key: edit.key, reason: 'the key holds a collection, not a string' });
+            continue;
+        }
+        doc.setIn(path, edit.value);
+    }
+    // lineWidth 0 disables re-wrapping, so untouched long lines stay as written.
+    return { content: doc.toString({ lineWidth: 0 }), skipped };
+}
+//# sourceMappingURL=yaml-write.js.map

package/dist/formats/yaml-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-write.js","sourceRoot":"","sources":["../../src/formats/yaml-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,OAAO,GAA2C,EAAE,CAAC;IAE3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,mDAAmD,EAAE,CAAC,CAAC;YAC7F,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,6DAA6D;YAC7D,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAC7E,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/dist/formats/yaml.d.ts

@@ -0,0 +1,18 @@
+import type { ReadTarget } from '../types.js';
+import { FormatError } from './error.js';
+/**
+ * Rails and Symfony locale files.
+ *
+ * Unlike the PHP parser, this one delegates: reading YAML is not a security
+ * question, and the spec is deep enough — anchors, block scalars, implicit
+ * typing — that a hand-rolled subset would quietly misread real files.
+ */
+export declare class YamlParseError extends FormatError {
+}
+/**
+ * Rails nests the whole file under its locale code. Left in place, every key in
+ * en.yml would differ from every key in fr.yml.
+ */
+export declare function localeRootKey(parsed: unknown, locale: string): string | null;
+export declare function stripLocaleRoot(parsed: unknown, locale: string): unknown;
+export declare function readYamlLocale(file: string, namespace: string, locale: string, _isSource: boolean, target: ReadTarget): void;

package/dist/formats/yaml.js

@@ -0,0 +1,51 @@
+import { readFileSync } from 'node:fs';
+import { parse } from 'yaml';
+import { FormatError } from './error.js';
+import { flattenValue } from './flatten.js';
+/**
+ * Rails and Symfony locale files.
+ *
+ * Unlike the PHP parser, this one delegates: reading YAML is not a security
+ * question, and the spec is deep enough — anchors, block scalars, implicit
+ * typing — that a hand-rolled subset would quietly misread real files.
+ */
+export class YamlParseError extends FormatError {
+}
+function normaliseLocale(value) {
+    return value.toLowerCase().replace(/_/g, '-');
+}
+/**
+ * Rails nests the whole file under its locale code. Left in place, every key in
+ * en.yml would differ from every key in fr.yml.
+ */
+export function localeRootKey(parsed, locale) {
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    const keys = Object.keys(parsed);
+    if (keys.length !== 1)
+        return null;
+    const root = keys[0];
+    return normaliseLocale(root) === normaliseLocale(locale) ? root : null;
+}
+export function stripLocaleRoot(parsed, locale) {
+    const root = localeRootKey(parsed, locale);
+    return root === null ? parsed : parsed[root];
+}
+export function readYamlLocale(file, namespace, locale, _isSource, target) {
+    let parsed;
+    try {
+        parsed = parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        throw new YamlParseError(file, err instanceof Error ? err.message : String(err));
+    }
+    if (parsed === null || parsed === undefined)
+        return; // an empty document
+    const inner = stripLocaleRoot(parsed, locale);
+    if (Array.isArray(inner)) {
+        target.skipped.push({ file, reason: 'the file holds a list, not keyed translations' });
+        return;
+    }
+    flattenValue(inner, namespace, file, target.leaves, target.containers);
+}
+//# sourceMappingURL=yaml.js.map

package/dist/formats/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/formats/yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AAEH,MAAM,OAAO,cAAe,SAAQ,WAAW;CAAG;AAElD,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,MAAc;IAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAExF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IACtB,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,MAAc;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,SAAiB,EACjB,MAAc,EACd,SAAkB,EAClB,MAAkB;IAElB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,oBAAoB;IAEzE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IACD,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC"}

package/dist/glossary.d.ts

@@ -0,0 +1,38 @@
+export declare const GLOSSARY_FILE = ".i18n/glossary.json";
+export type MatchMode = 'prefix' | 'exact' | 'substring';
+export interface GlossaryTerm {
+    /** The word as it appears in the source locale. */
+    source: string;
+    /** Accepted renderings per locale. Locales left out are not checked. */
+    targets: Record<string, string[]>;
+    /** Default `prefix`, which tolerates suffix inflection: panier → paniers. */
+    match: MatchMode;
+    caseSensitive: boolean;
+}
+export interface Glossary {
+    version: 1;
+    /** Tokens that must survive verbatim: brand and product names, protocols. */
+    doNotTranslate: string[];
+    terms: GlossaryTerm[];
+}
+export declare class GlossaryError extends Error {
+}
+export declare function glossaryPath(root: string, explicit?: string): string;
+export declare function loadGlossary(file: string): Glossary | null;
+export declare function usesWordBoundaries(term: string): boolean;
+/**
+ * Whether `term` occurs in `text`.
+ *
+ * `prefix` is the default because suffix inflection is the common case: a
+ * glossary saying "panier" should accept "paniers", and one saying "корзин"
+ * should accept every case ending.
+ */
+export declare function containsTerm(text: string, term: string, match?: MatchMode, caseSensitive?: boolean): boolean;
+export interface TermExpectation {
+    term: GlossaryTerm;
+    accepted: string[];
+}
+/** Terms that apply to this source string for this locale, with their forms. */
+export declare function expectationsFor(glossary: Glossary, locale: string, sourceValue: string): TermExpectation[];
+/** Do-not-translate tokens present in the source but missing from the target. */
+export declare function missingVerbatim(glossary: Glossary, sourceValue: string, targetValue: string): string[];

package/dist/glossary.js

@@ -0,0 +1,140 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+export const GLOSSARY_FILE = '.i18n/glossary.json';
+export class GlossaryError extends Error {
+}
+export function glossaryPath(root, explicit) {
+    return resolve(root, explicit ?? GLOSSARY_FILE);
+}
+function fail(file, message) {
+    throw new GlossaryError(`Invalid glossary ${file}\n  ${message}`);
+}
+function asStringArray(file, value, where) {
+    if (!Array.isArray(value) || value.some((v) => typeof v !== 'string')) {
+        fail(file, `${where} must be an array of strings`);
+    }
+    return value;
+}
+export function loadGlossary(file) {
+    if (!existsSync(file))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        fail(file, err instanceof Error ? err.message : String(err));
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        fail(file, 'expected an object');
+    const raw = parsed;
+    if (raw['version'] !== 1)
+        fail(file, 'expected "version": 1');
+    const doNotTranslate = raw['doNotTranslate'] === undefined
+        ? []
+        : asStringArray(file, raw['doNotTranslate'], 'doNotTranslate');
+    const termsRaw = raw['terms'] === undefined ? [] : raw['terms'];
+    if (!Array.isArray(termsRaw))
+        fail(file, 'terms must be an array');
+    const terms = termsRaw.map((entry, index) => {
+        const where = `terms[${index}]`;
+        if (typeof entry !== 'object' || entry === null)
+            fail(file, `${where} must be an object`);
+        const term = entry;
+        const source = term['source'];
+        if (typeof source !== 'string' || source === '') {
+            fail(file, `${where}.source must be a non-empty string`);
+        }
+        const targetsRaw = term['targets'];
+        if (typeof targetsRaw !== 'object' || targetsRaw === null || Array.isArray(targetsRaw)) {
+            fail(file, `${where}.targets must be an object keyed by locale`);
+        }
+        const targets = {};
+        for (const [locale, value] of Object.entries(targetsRaw)) {
+            const forms = asStringArray(file, value, `${where}.targets.${locale}`);
+            if (forms.length === 0)
+                fail(file, `${where}.targets.${locale} must list at least one form`);
+            targets[locale] = forms;
+        }
+        const match = term['match'] ?? 'prefix';
+        if (match !== 'prefix' && match !== 'exact' && match !== 'substring') {
+            fail(file, `${where}.match must be "prefix", "exact" or "substring"`);
+        }
+        const caseSensitive = term['caseSensitive'] ?? false;
+        if (typeof caseSensitive !== 'boolean')
+            fail(file, `${where}.caseSensitive must be a boolean`);
+        return { source, targets, match, caseSensitive };
+    });
+    return { version: 1, doNotTranslate, terms };
+}
+// ---------------------------------------------------------------------------
+// Matching
+// ---------------------------------------------------------------------------
+const WORDLIKE = /[\p{L}\p{N}]/u;
+/**
+ * Scripts written without spaces, where a term is normally surrounded by other
+ * letters and boundary checks would never match.
+ */
+const NO_WORD_BREAKS = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}]/u;
+export function usesWordBoundaries(term) {
+    return !NO_WORD_BREAKS.test(term);
+}
+/**
+ * Whether `term` occurs in `text`.
+ *
+ * `prefix` is the default because suffix inflection is the common case: a
+ * glossary saying "panier" should accept "paniers", and one saying "корзин"
+ * should accept every case ending.
+ */
+export function containsTerm(text, term, match = 'prefix', caseSensitive = false) {
+    if (term === '')
+        return false;
+    const haystack = caseSensitive ? text : text.toLowerCase();
+    const needle = caseSensitive ? term : term.toLowerCase();
+    if (match === 'substring' || !usesWordBoundaries(term)) {
+        return haystack.includes(needle);
+    }
+    let from = 0;
+    for (;;) {
+        const at = haystack.indexOf(needle, from);
+        if (at === -1)
+            return false;
+        const before = at === 0 ? '' : haystack[at - 1];
+        const startsWord = before === '' || !WORDLIKE.test(before);
+        if (startsWord) {
+            if (match === 'prefix')
+                return true;
+            const afterIndex = at + needle.length;
+            const after = afterIndex >= haystack.length ? '' : haystack[afterIndex];
+            if (after === '' || !WORDLIKE.test(after))
+                return true;
+        }
+        from = at + 1;
+    }
+}
+/** Terms that apply to this source string for this locale, with their forms. */
+export function expectationsFor(glossary, locale, sourceValue) {
+    const out = [];
+    for (const term of glossary.terms) {
+        const accepted = term.targets[locale];
+        if (!accepted)
+            continue;
+        if (!containsTerm(sourceValue, term.source, term.match, term.caseSensitive))
+            continue;
+        out.push({ term, accepted });
+    }
+    return out;
+}
+/** Do-not-translate tokens present in the source but missing from the target. */
+export function missingVerbatim(glossary, sourceValue, targetValue) {
+    const missing = [];
+    for (const token of glossary.doNotTranslate) {
+        // Brand names carry their capitalisation, so this comparison is exact.
+        if (!containsTerm(sourceValue, token, 'exact', true))
+            continue;
+        if (!containsTerm(targetValue, token, 'exact', true))
+            missing.push(token);
+    }
+    return missing;
+}
+//# sourceMappingURL=glossary.js.map

package/dist/glossary.js.map

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

package/dist/lengths.d.ts

@@ -0,0 +1,37 @@
+export declare const LIMITS_FILE = ".i18n/limits.json";
+export interface LimitPattern {
+    match: string;
+    max: number;
+}
+export interface Limits {
+    version: 1;
+    /** Applied to every measurable key when set. */
+    default: number | null;
+    keys: Record<string, number>;
+    patterns: LimitPattern[];
+}
+export declare class LimitsError extends Error {
+}
+export declare function limitsPath(root: string, explicit?: string): string;
+export declare function loadLimits(file: string): Limits | null;
+/** Exact keys win over patterns, and the first matching pattern wins over the default. */
+export declare function limitFor(limits: Limits, key: string): number | null;
+/**
+ * Width in display columns rather than UTF-16 units: a CJK character occupies
+ * two columns, combining marks none. Counting `.length` would report Japanese
+ * as half its real size and any emoji as double.
+ */
+export declare function displayWidth(text: string): number;
+/**
+ * An ICU plural carries every branch in one string but shows one at a time, and
+ * its selectors are not displayed at all, so measuring it would be meaningless.
+ */
+export declare function measurable(text: string): boolean;
+/** The widest thing the user can actually end up seeing. */
+export declare function renderedWidth(text: string, laravel: boolean): number;
+/**
+ * Conventional translation-expansion allowances: short strings grow much more
+ * in relative terms than long ones, so a single ratio would either miss real
+ * overflow or flag every button. These are rules of thumb, not a standard.
+ */
+export declare function allowanceFor(sourceWidth: number): number;