@ng-linguo/extract 0.9.0

package/src/lib/merge.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeCatalog = mergeCatalog;
+// Joins context and key when matching entries (gettext EOT glue).
+const GLUE = String.fromCharCode(4);
+function identity(context, msgid) {
+    return context === '' ? msgid : `${context}${GLUE}${msgid}`;
+}
+/**
+ * Merge freshly extracted messages into an existing catalog.
+ *
+ * The existing `translation` (msgstr) is preserved for entries that still appear
+ * in the source — matched by their (context, key) identity — and `references`
+ * are refreshed to the current locations. Entries no longer
+ * present are dropped; new ones are added with an empty translation. The result
+ * follows the extraction order (order of discovery), so re-extraction keeps the
+ * catalog stable and readable.
+ */
+function mergeCatalog(existing, extracted) {
+    const previous = new Map();
+    for (const entry of existing) {
+        previous.set(identity(entry.context, entry.msgid), entry);
+    }
+    return extracted.map((message) => {
+        const prior = previous.get(identity(message.context, message.keyId));
+        return {
+            context: message.context,
+            msgid: message.keyId,
+            msgstr: prior?.msgstr ?? '',
+            references: message.references,
+        };
+    });
+}
+//# sourceMappingURL=merge.js.map

package/src/lib/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../../../packages/extract/src/lib/merge.ts"],"names":[],"mappings":";;AAoBA,oCAkBC;AAnCD,kEAAkE;AAClE,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAEpC,SAAS,QAAQ,CAAC,OAAe,EAAE,KAAa;IAC9C,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAC1B,QAA4B,EAC5B,SAAsC;IAEtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAW,EAAE;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE;YAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/src/lib/normalize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Normalize a translator-facing source message into its canonical form.
+ *
+ * Leading/trailing whitespace is trimmed and any internal run of whitespace
+ * (including newlines from multi-line templates) is collapsed to a single
+ * space. This is the build-time half of the runtime/extractor parity contract
+ * (CLAUDE.md §5.2): the runtime normalizer must produce identical output for
+ * the same input, verified against the shared fixture.
+ *
+ * @example
+ * ```ts
+ * normalizeMessage('  Hello\n   world  '); // 'Hello world'
+ * ```
+ */
+export declare function normalizeMessage(source: string): string;

package/src/lib/normalize.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMessage = normalizeMessage;
+/**
+ * Normalize a translator-facing source message into its canonical form.
+ *
+ * Leading/trailing whitespace is trimmed and any internal run of whitespace
+ * (including newlines from multi-line templates) is collapsed to a single
+ * space. This is the build-time half of the runtime/extractor parity contract
+ * (CLAUDE.md §5.2): the runtime normalizer must produce identical output for
+ * the same input, verified against the shared fixture.
+ *
+ * @example
+ * ```ts
+ * normalizeMessage('  Hello\n   world  '); // 'Hello world'
+ * ```
+ */
+function normalizeMessage(source) {
+    return source.trim().replace(/\s+/g, ' ');
+}
+//# sourceMappingURL=normalize.js.map

package/src/lib/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../../../packages/extract/src/lib/normalize.ts"],"names":[],"mappings":";;AAcA,4CAEC;AAhBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/src/lib/po.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A single gettext `.po` catalog entry.
+ *
+ * `msgid` is the normalized source string and `msgstr` is the translation
+ * (empty until a translator fills it in). `context` is the `msgctxt` (empty when
+ * none) — it lets the same source text carry different translations and becomes
+ * part of the compiled runtime key. `references` are the `#:` source locations.
+ */
+export interface PoEntry {
+    readonly context: string;
+    readonly msgid: string;
+    readonly msgstr: string;
+    readonly references: readonly string[];
+}
+/**
+ * Serialize catalog entries to gettext `.po` text, including a minimal UTF-8
+ * header so standard translator tooling accepts the file.
+ */
+export declare function serializePo(entries: readonly PoEntry[]): string;
+/**
+ * Parse gettext `.po` text into catalog entries. The header entry (empty
+ * `msgid`) is dropped. Tolerant of multi-line quoted continuations and ignores
+ * comment kinds it does not use (`#`, `#,`).
+ */
+export declare function parsePo(content: string): PoEntry[];

package/src/lib/po.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializePo = serializePo;
+exports.parsePo = parsePo;
+function escapePo(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\t/g, '\\t');
+}
+function unescapePo(value) {
+    return value.replace(/\\([\\"nt])/g, (_match, char) => char === 'n' ? '\n' : char === 't' ? '\t' : char);
+}
+function quoted(value) {
+    const start = value.indexOf('"');
+    const end = value.lastIndexOf('"');
+    if (start < 0 || end <= start) {
+        return '';
+    }
+    return unescapePo(value.slice(start + 1, end));
+}
+const HEADER = ['msgid ""', 'msgstr ""', '"Content-Type: text/plain; charset=UTF-8\\n"'].join('\n');
+/**
+ * Serialize catalog entries to gettext `.po` text, including a minimal UTF-8
+ * header so standard translator tooling accepts the file.
+ */
+function serializePo(entries) {
+    const blocks = [HEADER];
+    for (const entry of entries) {
+        const lines = [];
+        for (const reference of entry.references) {
+            lines.push(`#: ${reference}`);
+        }
+        if (entry.context.length > 0) {
+            lines.push(`msgctxt "${escapePo(entry.context)}"`);
+        }
+        lines.push(`msgid "${escapePo(entry.msgid)}"`);
+        lines.push(`msgstr "${escapePo(entry.msgstr)}"`);
+        blocks.push(lines.join('\n'));
+    }
+    return `${blocks.join('\n\n')}\n`;
+}
+function emptyDraft() {
+    return { context: null, references: [], msgid: null, msgstr: null };
+}
+/**
+ * Parse gettext `.po` text into catalog entries. The header entry (empty
+ * `msgid`) is dropped. Tolerant of multi-line quoted continuations and ignores
+ * comment kinds it does not use (`#`, `#,`).
+ */
+function parsePo(content) {
+    const entries = [];
+    let draft = emptyDraft();
+    let mode = null;
+    const flush = () => {
+        if (draft.msgid !== null && draft.msgid !== '') {
+            entries.push({
+                context: draft.context ?? '',
+                msgid: draft.msgid,
+                msgstr: draft.msgstr ?? '',
+                references: draft.references,
+            });
+        }
+        draft = emptyDraft();
+        mode = null;
+    };
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.trimEnd();
+        if (line.trim() === '') {
+            flush();
+            continue;
+        }
+        if (line.startsWith('#:')) {
+            draft.references.push(line.slice(2).trim());
+            mode = null;
+        }
+        else if (line.startsWith('#')) {
+            // Other comment kinds (`#.`, `#,`, translator comments) are ignored.
+            mode = null;
+        }
+        else if (line.startsWith('msgctxt ')) {
+            draft.context = quoted(line.slice('msgctxt '.length));
+            mode = 'msgctxt';
+        }
+        else if (line.startsWith('msgid ')) {
+            draft.msgid = quoted(line.slice('msgid '.length));
+            mode = 'msgid';
+        }
+        else if (line.startsWith('msgstr ')) {
+            draft.msgstr = quoted(line.slice('msgstr '.length));
+            mode = 'msgstr';
+        }
+        else if (line.startsWith('"')) {
+            const continuation = quoted(line);
+            if (mode === 'msgctxt') {
+                draft.context = (draft.context ?? '') + continuation;
+            }
+            else if (mode === 'msgid') {
+                draft.msgid = (draft.msgid ?? '') + continuation;
+            }
+            else if (mode === 'msgstr') {
+                draft.msgstr = (draft.msgstr ?? '') + continuation;
+            }
+        }
+    }
+    flush();
+    return entries;
+}
+//# sourceMappingURL=po.js.map

package/src/lib/po.js.map

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

package/src/lib/prompt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Build a single, self-contained prompt that instructs an LLM to translate a
+ * whole `.po` catalog. The template explains ng-linguo's concepts (context,
+ * slot tags, MessageFormat 2 plurals/selection) and is filled with the target
+ * language label and the catalog contents.
+ *
+ * @param targetLanguage human-readable label for the language to translate
+ *   into, e.g. `"Polish (pl)"`.
+ * @param poContents the entire `.po` file to translate.
+ * @returns the ready-to-send prompt.
+ */
+export declare function buildTranslationPrompt(targetLanguage: string, poContents: string): string;
+/** A configured locale matched from user input, with a label for the prompt. */
+export interface ResolvedLocale {
+    /** The locale code whose `<locale>.po` catalog should be translated. */
+    readonly locale: string;
+    /** Human-readable label injected into the prompt, e.g. `"Polish (pl)"`. */
+    readonly label: string;
+}
+/**
+ * A human-readable label for a locale, e.g. `"Polish (pl)"`, used in prompts
+ * and menus. Falls back to the bare code when no display name is available.
+ */
+export declare function localeLabel(locale: string): string;
+/**
+ * Resolve a user-supplied language to one of the configured locales. The input
+ * may be the locale code (`pl`), the English name (`Polish`), or the endonym —
+ * the language's own name (`Polski`) — all matched case-insensitively.
+ *
+ * @returns the matched locale and a `"<English name> (<code>)"` label, or
+ *   `undefined` when nothing matches.
+ */
+export declare function resolveTargetLocale(input: string, locales: readonly string[]): ResolvedLocale | undefined;

package/src/lib/prompt.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTranslationPrompt = buildTranslationPrompt;
+exports.localeLabel = localeLabel;
+exports.resolveTargetLocale = resolveTargetLocale;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** Placeholder replaced with the human-readable target language label. */
+const LANGUAGE_SLOT = '{{TARGET_LANGUAGE}}';
+/** Placeholder replaced with the full `.po` catalog contents. */
+const PO_SLOT = '{{PO_FILE}}';
+/**
+ * The translation prompt template, shipped as a sibling `.txt` asset so the
+ * long instructions stay readable (and editable) without escaping. Read once
+ * and cached for the process.
+ */
+let cachedTemplate;
+function loadTemplate() {
+    if (cachedTemplate === undefined) {
+        cachedTemplate = (0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, 'translation-prompt.txt'), 'utf8');
+    }
+    return cachedTemplate;
+}
+/**
+ * Build a single, self-contained prompt that instructs an LLM to translate a
+ * whole `.po` catalog. The template explains ng-linguo's concepts (context,
+ * slot tags, MessageFormat 2 plurals/selection) and is filled with the target
+ * language label and the catalog contents.
+ *
+ * @param targetLanguage human-readable label for the language to translate
+ *   into, e.g. `"Polish (pl)"`.
+ * @param poContents the entire `.po` file to translate.
+ * @returns the ready-to-send prompt.
+ */
+function buildTranslationPrompt(targetLanguage, poContents) {
+    return loadTemplate().split(LANGUAGE_SLOT).join(targetLanguage).split(PO_SLOT).join(poContents);
+}
+function displayName(locale, inLocale) {
+    try {
+        return new Intl.DisplayNames([inLocale], { type: 'language' }).of(locale);
+    }
+    catch {
+        // Unknown locale or no ICU data — fall back to code-only matching.
+        return undefined;
+    }
+}
+/**
+ * A human-readable label for a locale, e.g. `"Polish (pl)"`, used in prompts
+ * and menus. Falls back to the bare code when no display name is available.
+ */
+function localeLabel(locale) {
+    const english = displayName(locale, 'en');
+    return english ? `${english} (${locale})` : locale;
+}
+/**
+ * Resolve a user-supplied language to one of the configured locales. The input
+ * may be the locale code (`pl`), the English name (`Polish`), or the endonym —
+ * the language's own name (`Polski`) — all matched case-insensitively.
+ *
+ * @returns the matched locale and a `"<English name> (<code>)"` label, or
+ *   `undefined` when nothing matches.
+ */
+function resolveTargetLocale(input, locales) {
+    const needle = input.trim().toLowerCase();
+    if (needle === '') {
+        return undefined;
+    }
+    for (const locale of locales) {
+        const english = displayName(locale, 'en');
+        const endonym = displayName(locale, locale);
+        const matches = locale.toLowerCase() === needle ||
+            english?.toLowerCase() === needle ||
+            endonym?.toLowerCase() === needle;
+        if (matches) {
+            return { locale, label: localeLabel(locale) };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=prompt.js.map

package/src/lib/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../packages/extract/src/lib/prompt.ts"],"names":[],"mappings":";;AAiCA,wDAEC;AAuBD,kCAGC;AAUD,kDAuBC;AA9FD,qCAAuC;AACvC,yCAAiC;AAEjC,0EAA0E;AAC1E,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,iEAAiE;AACjE,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B;;;;GAIG;AACH,IAAI,cAAkC,CAAC;AAEvC,SAAS,YAAY;IACnB,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,cAAc,GAAG,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,wBAAwB,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,sBAAsB,CAAC,cAAsB,EAAE,UAAkB;IAC/E,OAAO,YAAY,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAClG,CAAC;AAUD,SAAS,WAAW,CAAC,MAAc,EAAE,QAAgB;IACnD,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,MAAc;IACxC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,KAAa,EACb,OAA0B;IAE1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,OAAO,GACX,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM;YAC/B,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM;YACjC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC;QAEpC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/src/lib/runner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Prefix marking a translation that has not been provided yet. New entries in
+ * non-source locales are seeded with this followed by the source text, so the
+ * string is visible and obviously flagged in the running app until translated.
+ */
+export declare const MISSING_PREFIX = "<MISSING TRANSLATION>";
+/** Per-language summary of an extraction run. */
+export interface LocaleExtractStats {
+    readonly locale: string;
+    /** Total entries in the catalog after the run. */
+    readonly total: number;
+    /** Entries newly added this run. */
+    readonly added: number;
+    /** Entries dropped this run (no longer in the source). */
+    readonly removed: number;
+    /** Entries still untranslated (empty or `<MISSING TRANSLATION>`-prefixed). */
+    readonly missing: number;
+}
+/** Summary of an extraction run across all locales. */
+export interface ExtractStats {
+    readonly files: number;
+    readonly messages: number;
+    readonly locales: readonly LocaleExtractStats[];
+}
+/** Options for {@link extractToCatalogs}. */
+export interface ExtractOptions {
+    /** Directory to scan recursively for translatable strings. */
+    readonly srcDir: string;
+    /** Directory to write `<locale>.po` catalogs into. */
+    readonly outDir: string;
+    /** Locales to create or update, e.g. `['en', 'pl']`. */
+    readonly locales: readonly string[];
+    /** Base used to make `#:` references relative. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+    /**
+     * Locale whose new entries are seeded with the source text itself (the
+     * canonical value) instead of a `<MISSING TRANSLATION>` placeholder. Defaults
+     * to `'en'`.
+     */
+    readonly sourceLocale?: string;
+}
+/**
+ * Scan `srcDir`, then create or update one `.po` catalog per locale in
+ * `outDir`, merging with any existing catalog so translations are preserved.
+ *
+ * Newly discovered entries are seeded: the source locale gets the source text,
+ * other locales get `"<MISSING TRANSLATION> <source>"` so the string renders
+ * visibly flagged until translated. Returns per-language stats.
+ */
+export declare function extractToCatalogs(options: ExtractOptions): ExtractStats;
+/** Options for {@link compileCatalogs}. */
+export interface CompileOptions {
+    /** Directory containing `<locale>.po` catalogs. */
+    readonly poDir: string;
+    /** Directory to write `<locale>.json` runtime dictionaries into. */
+    readonly outDir: string;
+}
+/**
+ * Compile every `.po` catalog in `poDir` into a runtime `<locale>.json`
+ * dictionary in `outDir` (the format the loader consumes).
+ */
+export declare function compileCatalogs(options: CompileOptions): void;

package/src/lib/runner.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISSING_PREFIX = void 0;
+exports.extractToCatalogs = extractToCatalogs;
+exports.compileCatalogs = compileCatalogs;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const compile_1 = require("./compile");
+const merge_1 = require("./merge");
+const po_1 = require("./po");
+const scan_1 = require("./scan");
+const SCANNED_EXTENSIONS = ['.html', '.ts'];
+/**
+ * Prefix marking a translation that has not been provided yet. New entries in
+ * non-source locales are seeded with this followed by the source text, so the
+ * string is visible and obviously flagged in the running app until translated.
+ */
+exports.MISSING_PREFIX = '<MISSING TRANSLATION>';
+function walk(dir, files = []) {
+    for (const name of (0, node_fs_1.readdirSync)(dir)) {
+        if (name === 'node_modules' || name.startsWith('.')) {
+            continue;
+        }
+        const full = (0, node_path_1.join)(dir, name);
+        if ((0, node_fs_1.statSync)(full).isDirectory()) {
+            walk(full, files);
+        }
+        else if (SCANNED_EXTENSIONS.some((ext) => name.endsWith(ext)) && !name.endsWith('.spec.ts')) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+function identity(entry) {
+    return entry.context === ''
+        ? entry.msgid
+        : `${entry.context}${String.fromCharCode(4)}${entry.msgid}`;
+}
+function isMissing(msgstr) {
+    return msgstr === '' || msgstr.startsWith(exports.MISSING_PREFIX);
+}
+/**
+ * Scan `srcDir`, then create or update one `.po` catalog per locale in
+ * `outDir`, merging with any existing catalog so translations are preserved.
+ *
+ * Newly discovered entries are seeded: the source locale gets the source text,
+ * other locales get `"<MISSING TRANSLATION> <source>"` so the string renders
+ * visibly flagged until translated. Returns per-language stats.
+ */
+function extractToCatalogs(options) {
+    const base = options.cwd ?? process.cwd();
+    const sourceLocale = options.sourceLocale ?? 'en';
+    const files = walk(options.srcDir).map((path) => ({
+        path: (0, node_path_1.relative)(base, path).split('\\').join('/'),
+        content: (0, node_fs_1.readFileSync)(path, 'utf8'),
+    }));
+    const messages = (0, scan_1.extractMessages)(files);
+    (0, node_fs_1.mkdirSync)(options.outDir, { recursive: true });
+    const locales = [];
+    for (const locale of options.locales) {
+        const poPath = (0, node_path_1.join)(options.outDir, `${locale}.po`);
+        const existing = (0, node_fs_1.existsSync)(poPath) ? (0, po_1.parsePo)((0, node_fs_1.readFileSync)(poPath, 'utf8')) : [];
+        const existingIds = new Set(existing.map(identity));
+        const merged = (0, merge_1.mergeCatalog)(existing, messages);
+        let added = 0;
+        const seeded = merged.map((entry) => {
+            const isNew = !existingIds.has(identity(entry));
+            if (!isNew) {
+                return entry;
+            }
+            added += 1;
+            const fallback = locale === sourceLocale ? entry.msgid : `${exports.MISSING_PREFIX} ${entry.msgid}`;
+            return entry.msgstr === '' ? { ...entry, msgstr: fallback } : entry;
+        });
+        (0, node_fs_1.writeFileSync)(poPath, (0, po_1.serializePo)(seeded));
+        const mergedIds = new Set(seeded.map(identity));
+        locales.push({
+            locale,
+            total: seeded.length,
+            added,
+            removed: [...existingIds].filter((id) => !mergedIds.has(id)).length,
+            missing: seeded.filter((entry) => isMissing(entry.msgstr)).length,
+        });
+    }
+    return { files: files.length, messages: messages.length, locales };
+}
+/**
+ * Compile every `.po` catalog in `poDir` into a runtime `<locale>.json`
+ * dictionary in `outDir` (the format the loader consumes).
+ */
+function compileCatalogs(options) {
+    (0, node_fs_1.mkdirSync)(options.outDir, { recursive: true });
+    for (const name of (0, node_fs_1.readdirSync)(options.poDir)) {
+        if (!name.endsWith('.po')) {
+            continue;
+        }
+        const locale = name.slice(0, -'.po'.length);
+        const entries = (0, po_1.parsePo)((0, node_fs_1.readFileSync)((0, node_path_1.join)(options.poDir, name), 'utf8'));
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(options.outDir, `${locale}.json`), `${JSON.stringify((0, compile_1.compileEntries)(entries), null, 2)}\n`);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/src/lib/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../packages/extract/src/lib/runner.ts"],"names":[],"mappings":";;;AAwFA,8CA0CC;AAcD,0CAaC;AA7JD,qCAAoG;AACpG,yCAA2C;AAE3C,uCAA2C;AAC3C,mCAAuC;AACvC,6BAA0D;AAC1D,iCAA0D;AAE1D,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAErD;;;;GAIG;AACU,QAAA,cAAc,GAAG,uBAAuB,CAAC;AAEtD,SAAS,IAAI,CAAC,GAAW,EAAE,QAAkB,EAAE;IAC7C,KAAK,MAAM,IAAI,IAAI,IAAA,qBAAW,EAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9F,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyC;IACzD,OAAO,KAAK,CAAC,OAAO,KAAK,EAAE;QACzB,CAAC,CAAC,KAAK,CAAC,KAAK;QACb,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,sBAAc,CAAC,CAAC;AAC5D,CAAC;AAwCD;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,OAAuB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAClD,MAAM,KAAK,GAAiB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,EAAE,IAAA,oBAAQ,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAChD,OAAO,EAAE,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC;KACpC,CAAC,CAAC,CAAC;IACJ,MAAM,QAAQ,GAAG,IAAA,sBAAe,EAAC,KAAK,CAAC,CAAC;IAExC,IAAA,mBAAS,EAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAA,gBAAI,EAAC,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAA,oBAAU,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,YAAO,EAAC,IAAA,sBAAY,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEhD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAW,EAAE;YAC3C,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,sBAAc,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5F,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,IAAA,uBAAa,EAAC,MAAM,EAAE,IAAA,gBAAW,EAAC,MAAM,CAAC,CAAC,CAAC;QAE3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,KAAK;YACL,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM;YACnE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;SAClE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AACrE,CAAC;AAUD;;;GAGG;AACH,SAAgB,eAAe,CAAC,OAAuB;IACrD,IAAA,mBAAS,EAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,IAAA,qBAAW,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAA,YAAO,EAAC,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,IAAA,uBAAa,EACX,IAAA,gBAAI,EAAC,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,EACtC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,wBAAc,EAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACxD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/src/lib/scan.d.ts

@@ -0,0 +1,31 @@
+/** A source file to scan for translatable strings. */
+export interface SourceFile {
+    /** Path used in `#:` references, e.g. `src/app/player.html`. */
+    readonly path: string;
+    readonly content: string;
+}
+/** A translatable string found during scanning, with its source locations. */
+export interface ExtractedMessage {
+    /** Normalized source string — the catalog `msgid`. */
+    readonly keyId: string;
+    /** Disambiguating context (`msgctxt`), or `''` for the default entry. */
+    readonly context: string;
+    /** Sorted, de-duplicated `path:line` references. */
+    readonly references: readonly string[];
+}
+/**
+ * Scan source files for translatable strings used by the `t` pipe
+ * (`'Play' | t: { context }`), the `[t]` directive (`t="message"` with an
+ * optional `tContext`), the `t('...', { context })` helper call, and the
+ * `mark()` marker, returning one {@link ExtractedMessage} per unique
+ * (context, key) pair with all of its source references.
+ *
+ * Pure and DOM-free, so it runs in CI on plain Node (CLAUDE.md §2.1). Entries
+ * are returned in order of discovery — files in the order given, and within a
+ * file by source position — so re-extraction produces a stable, readable order.
+ *
+ * Regions marked with `linguo-ignore` comment directives are skipped, so
+ * documentation samples containing `mark(`, `'…' | t`, or `t="…"` are not
+ * scanned as real messages (see {@link ignoredRanges}).
+ */
+export declare function extractMessages(files: readonly SourceFile[]): ExtractedMessage[];