@forumulate/cli 0.4.0 → 0.8.0

package/dist/translations/files.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stubHash = void 0;
+exports.writeTranslationFile = writeTranslationFile;
+exports.readTranslationFile = readTranslationFile;
+exports.fileStem = fileStem;
+/**
+ * One translation as one file: Markdown with front matter.
+ *
+ * `translations pull` writes `<out>/<locale>/<slug>.md` per piece per
+ * language, and `push` reads them back. The front matter says what the file
+ * IS (space, piece, language) so a file renamed or moved by a TMS still lands
+ * on the right piece, and carries the non-body fields (title, a post's
+ * summary, an incident's update texts). `source` is a hash of what was
+ * written out for a piece nobody had translated yet: a file still carrying
+ * those exact words is a stub, and pushing it would publish English under a
+ * Spanish address — so it is skipped, not sent.
+ */
+const node_crypto_1 = require("node:crypto");
+const yaml_1 = require("yaml");
+const frontmatter_1 = require("../publish/frontmatter");
+const stubHash = (title, markdown) => (0, node_crypto_1.createHash)('sha256').update(`${title}\n${markdown.trim()}`).digest('hex').slice(0, 16);
+exports.stubHash = stubHash;
+function writeTranslationFile(f) {
+    const front = {
+        forumulate: 'translation',
+        space: f.space,
+        piece: f.piece,
+        door: f.door,
+        locale: f.locale,
+        title: f.title,
+    };
+    if (f.excerpt !== undefined && f.excerpt !== null)
+        front.excerpt = f.excerpt;
+    if (f.updates && Object.keys(f.updates).length)
+        front.updates = f.updates;
+    if (f.published !== undefined)
+        front.published = f.published;
+    if (f.state)
+        front.state = f.state;
+    if (f.source)
+        front.source = f.source;
+    return `---\n${(0, yaml_1.stringify)(front).trimEnd()}\n---\n\n${f.markdown.trim()}\n`;
+}
+/** A pulled file, or null when it is not one of ours (any other Markdown in the folder). */
+function readTranslationFile(text) {
+    const { data, body } = (0, frontmatter_1.splitFront)(text);
+    if (data.forumulate !== 'translation')
+        return null;
+    const s = (k) => (typeof data[k] === 'string' ? data[k] : '');
+    if (!s('piece') || !s('locale'))
+        throw new Error('front matter needs `piece` and `locale`.');
+    const updates = data.updates && typeof data.updates === 'object' && !Array.isArray(data.updates)
+        ? Object.fromEntries(Object.entries(data.updates).map(([k, v]) => [k, String(v ?? '')]))
+        : undefined;
+    return {
+        space: s('space'),
+        piece: s('piece'),
+        locale: s('locale'),
+        door: s('door'),
+        title: s('title'),
+        markdown: body.trim(),
+        excerpt: typeof data.excerpt === 'string' ? data.excerpt : undefined,
+        updates,
+        published: typeof data.published === 'boolean' ? data.published : undefined,
+        state: s('state') || undefined,
+        source: s('source') || undefined,
+    };
+}
+/** A file name a TMS and a filesystem both accept. */
+function fileStem(slug, id) {
+    const clean = (slug ?? '').replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+    return clean || id;
+}
+//# sourceMappingURL=files.js.map

package/dist/translations/files.js.map

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

package/dist/translations/sync.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `translations pull | push`, `labels pull | push`, `overrides pull | push`:
+ * the file round trips a TMS (or a person with an editor) sits in the middle of.
+ *
+ * Every push is a diff first: each file is compared with what the API holds
+ * now, and only what differs is written — so a second push of the same files
+ * writes nothing (idempotent), and `--dry-run` prints exactly what a real push
+ * would send.
+ */
+import { type ForumulateClient, type LabelScope, type TranslationCoverage } from '@forumulate/sdk';
+export interface SyncFiles {
+    read(path: string): string;
+    write(path: string, text: string): void;
+    exists(path: string): boolean;
+    /** Every file under a folder, recursively, as paths joinable with it. */
+    list(dir: string): string[];
+}
+export interface SyncDeps {
+    client: ForumulateClient;
+    out: (line: string) => void;
+    err: (line: string) => void;
+    files: SyncFiles;
+}
+/** Write one file per piece per language under `<out>/<locale>/`. */
+export declare function pullPieces(deps: SyncDeps, at: {
+    orgId: string;
+    spaceId: string;
+}, coverage: TranslationCoverage, opts: {
+    out: string;
+    locales: string[];
+    only?: string[];
+    includeMissing: boolean;
+}): Promise<{
+    written: string[];
+    skipped: number;
+}>;
+export interface PushPlan {
+    path: string;
+    piece: string;
+    locale: string;
+    action: 'write' | 'unchanged' | 'stub' | 'other-space';
+    fields: string[];
+}
+/** Compare every pulled file under `dir` with the API, then (unless dry) write what differs. */
+export declare function pushPieces(deps: SyncDeps, at: {
+    orgId: string;
+    spaceId: string;
+}, opts: {
+    dir: string;
+    locales?: string[];
+    dryRun: boolean;
+}): Promise<PushPlan[]>;
+export type TableFormat = 'json' | 'xliff';
+export declare function tableFormat(value: string | undefined, file?: string): TableFormat;
+/** The chrome dictionary, as JSON (`{labels}`) or XLIFF over every owner string. */
+export declare function pullLabels(deps: SyncDeps, orgId: string, scope: LabelScope, opts: {
+    format: TableFormat;
+    locales?: string[];
+}): Promise<string>;
+/** The words that differ from the dictionary now, as a PATCH body; unchanged words are not sent. */
+export declare function pushLabels(deps: SyncDeps, orgId: string, scope: LabelScope, text: string, opts: {
+    format: TableFormat;
+    dryRun: boolean;
+}): Promise<{
+    changes: {
+        locale: string;
+        text: string;
+        to: unknown;
+    }[];
+}>;
+export declare function pullOverrides(deps: SyncDeps, orgId: string, opts: {
+    format: TableFormat;
+    locales?: string[];
+}): Promise<string>;
+export declare function pushOverrides(deps: SyncDeps, orgId: string, text: string, opts: {
+    format: TableFormat;
+    dryRun: boolean;
+    prune: boolean;
+}): Promise<{
+    set: {
+        locale: string;
+        key: string;
+    }[];
+    removed: {
+        locale: string;
+        key: string;
+    }[];
+}>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/translations/sync.d.ts.map

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

package/dist/translations/sync.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullPieces = pullPieces;
+exports.pushPieces = pushPieces;
+exports.tableFormat = tableFormat;
+exports.pullLabels = pullLabels;
+exports.pushLabels = pushLabels;
+exports.pullOverrides = pullOverrides;
+exports.pushOverrides = pushOverrides;
+/**
+ * `translations pull | push`, `labels pull | push`, `overrides pull | push`:
+ * the file round trips a TMS (or a person with an editor) sits in the middle of.
+ *
+ * Every push is a diff first: each file is compared with what the API holds
+ * now, and only what differs is written — so a second push of the same files
+ * writes nothing (idempotent), and `--dry-run` prints exactly what a real push
+ * would send.
+ */
+const sdk_1 = require("@forumulate/sdk");
+const files_1 = require("./files");
+const xliff_1 = require("./xliff");
+const join = (a, b) => `${a.replace(/\/+$/, '')}/${b}`;
+/** Write one file per piece per language under `<out>/<locale>/`. */
+async function pullPieces(deps, at, coverage, opts) {
+    const t = deps.client.translations;
+    const knownDoor = (0, sdk_1.translationDoorOf)(coverage.spaceType);
+    const written = [];
+    let skipped = 0;
+    const used = new Set();
+    for (const item of coverage.items) {
+        if (opts.only && !opts.only.some((o) => o === item.id || o === item.slug))
+            continue;
+        let stem = (0, files_1.fileStem)(item.slug, item.id);
+        if (used.has(stem))
+            stem = `${stem}-${item.id.slice(0, 8)}`;
+        used.add(stem);
+        for (const locale of opts.locales) {
+            const cell = item.locales[locale];
+            if (!cell)
+                continue;
+            const path = join(join(opts.out, locale), `${stem}.md`);
+            let file;
+            if (cell.state === 'missing' || (knownDoor === 'page' && !cell.id)) {
+                if (!opts.includeMissing) {
+                    skipped += 1;
+                    continue;
+                }
+                // A stub carrying the original, for a translator to replace.
+                const { item: src } = await deps.client.request('GET', `/orgs/${at.orgId}/spaces/${at.spaceId}/items/${item.id}`);
+                file = {
+                    space: at.spaceId,
+                    piece: item.id,
+                    locale,
+                    door: knownDoor,
+                    title: src.title,
+                    markdown: src.markdown ?? '',
+                    state: 'missing',
+                    source: (0, files_1.stubHash)(src.title, src.markdown ?? ''),
+                };
+            }
+            else {
+                const tr = await t.get(at.orgId, at.spaceId, item.id, locale, { door: knownDoor });
+                file = {
+                    space: at.spaceId,
+                    piece: item.id,
+                    locale,
+                    door: tr.door,
+                    title: tr.title ?? item.title,
+                    markdown: tr.markdown ?? '',
+                    excerpt: tr.excerpt ?? undefined,
+                    updates: tr.updates,
+                    published: tr.state === 'draft' ? false : tr.door === 'incident' ? undefined : true,
+                    state: tr.state,
+                };
+            }
+            deps.files.write(path, (0, files_1.writeTranslationFile)(file));
+            written.push(path);
+        }
+    }
+    return { written, skipped };
+}
+/** Compare every pulled file under `dir` with the API, then (unless dry) write what differs. */
+async function pushPieces(deps, at, opts) {
+    const t = deps.client.translations;
+    const plans = [];
+    for (const path of deps.files.list(opts.dir).filter((p) => p.endsWith('.md')).sort()) {
+        const f = (0, files_1.readTranslationFile)(deps.files.read(path));
+        if (!f)
+            continue;
+        if (opts.locales && !opts.locales.includes(f.locale))
+            continue;
+        const plan = { path, piece: f.piece, locale: f.locale, action: 'unchanged', fields: [] };
+        plans.push(plan);
+        if (f.space && f.space !== at.spaceId) {
+            plan.action = 'other-space';
+            continue;
+        }
+        if (f.source && f.source === (0, files_1.stubHash)(f.title, f.markdown)) {
+            plan.action = 'stub';
+            continue;
+        }
+        const door = (f.door || undefined);
+        const now = await t.get(at.orgId, at.spaceId, f.piece, f.locale, { door });
+        if ((now.title ?? '') !== f.title)
+            plan.fields.push('title');
+        if ((now.markdown ?? '').trim() !== f.markdown.trim())
+            plan.fields.push('markdown');
+        if (f.excerpt !== undefined && (now.excerpt ?? '') !== f.excerpt)
+            plan.fields.push('excerpt');
+        if (f.updates && JSON.stringify(now.updates ?? {}) !== JSON.stringify({ ...(now.updates ?? {}), ...f.updates }))
+            plan.fields.push('updates');
+        if (f.published === true && now.state === 'draft')
+            plan.fields.push('published');
+        if (!plan.fields.length)
+            continue;
+        plan.action = 'write';
+        if (opts.dryRun)
+            continue;
+        await t.put(at.orgId, at.spaceId, f.piece, f.locale, {
+            // A topic's PUT replaces the translation (title required); a page's
+            // title is its own PATCH, sent only when it changed.
+            title: now.door === 'page' && !plan.fields.includes('title') ? undefined : f.title,
+            markdown: plan.fields.includes('markdown') || now.door !== 'page' ? f.markdown : undefined,
+            excerpt: f.excerpt,
+            updates: f.updates,
+            published: f.published,
+        }, { door: now.door });
+    }
+    return plans;
+}
+function tableFormat(value, file) {
+    if (value === 'json' || value === 'xliff')
+        return value;
+    if (value !== undefined)
+        throw new Error(`--format is json or xliff, not "${value}".`);
+    return file && /\.(xlf|xliff)$/i.test(file) ? 'xliff' : 'json';
+}
+/** The chrome dictionary, as JSON (`{labels}`) or XLIFF over every owner string. */
+async function pullLabels(deps, orgId, scope, opts) {
+    const listing = await deps.client.translations.labels.strings(orgId, scope);
+    const locales = opts.locales ?? listing.languages;
+    if (opts.format === 'json') {
+        const labels = Object.fromEntries(Object.entries(listing.labels).filter(([l]) => locales.includes(l)));
+        return `${JSON.stringify({ labels }, null, 2)}\n`;
+    }
+    const rows = listing.strings;
+    const files = locales.map((locale) => ({
+        locale,
+        units: rows.map((r) => ({ id: r.text, source: r.text, target: typeof r.dictionary[locale] === 'string' ? r.dictionary[locale] : '' })),
+    }));
+    return (0, xliff_1.toXliff)(files, { original: 'labels' });
+}
+/** The words that differ from the dictionary now, as a PATCH body; unchanged words are not sent. */
+async function pushLabels(deps, orgId, scope, text, opts) {
+    const listing = await deps.client.translations.labels.strings(orgId, scope);
+    const incoming = opts.format === 'json'
+        ? (JSON.parse(text).labels ?? {})
+        : Object.fromEntries((0, xliff_1.fromXliff)(text).map((f) => [f.locale, Object.fromEntries(f.units.filter((u) => u.target.trim()).map((u) => [u.id, u.target]))]));
+    const changes = [];
+    const patch = {};
+    for (const [locale, words] of Object.entries(incoming)) {
+        for (const [original, to] of Object.entries(words ?? {})) {
+            const now = listing.labels[locale]?.[original];
+            if (JSON.stringify(now) === JSON.stringify(to))
+                continue;
+            changes.push({ locale, text: original, to });
+            (patch[locale] ??= {})[original] = to;
+        }
+    }
+    if (changes.length && !opts.dryRun)
+        await deps.client.translations.labels.merge(orgId, scope, patch);
+    return { changes };
+}
+async function pullOverrides(deps, orgId, opts) {
+    const { overrides } = await deps.client.translations.overrides.list(orgId);
+    const byLocale = {};
+    for (const o of overrides)
+        if (!opts.locales || opts.locales.includes(o.locale))
+            (byLocale[o.locale] ??= {})[o.key] = o.value;
+    if (opts.format === 'json')
+        return `${JSON.stringify({ overrides: byLocale }, null, 2)}\n`;
+    // The English each key replaces, so the TMS shows the translator the source.
+    const { catalog } = await deps.client.translations.overrides.catalog(orgId).catch(() => ({ catalog: {} }));
+    const locales = opts.locales ?? Object.keys(byLocale);
+    return (0, xliff_1.toXliff)(locales.map((locale) => ({
+        locale,
+        units: Object.entries(byLocale[locale] ?? {}).map(([key, value]) => ({ id: key, source: catalog[key] ?? key, target: value })),
+    })), { original: 'translation-overrides' });
+}
+async function pushOverrides(deps, orgId, text, opts) {
+    const { overrides } = await deps.client.translations.overrides.list(orgId);
+    const incoming = opts.format === 'json'
+        ? (JSON.parse(text).overrides ?? {})
+        : Object.fromEntries((0, xliff_1.fromXliff)(text).map((f) => [f.locale, Object.fromEntries(f.units.filter((u) => u.target.trim()).map((u) => [u.id, u.target]))]));
+    const set = [];
+    const removed = [];
+    for (const [locale, keys] of Object.entries(incoming))
+        for (const [key, value] of Object.entries(keys ?? {})) {
+            if (overrides.some((o) => o.locale === locale && o.key === key && o.value === value))
+                continue;
+            set.push({ locale, key });
+            if (!opts.dryRun)
+                await deps.client.translations.overrides.set(orgId, { locale, key, value: String(value) });
+        }
+    if (opts.prune)
+        for (const o of overrides) {
+            if (incoming[o.locale]?.[o.key] !== undefined)
+                continue;
+            removed.push({ locale: o.locale, key: o.key });
+            if (!opts.dryRun)
+                await deps.client.translations.overrides.remove(orgId, { locale: o.locale, key: o.key });
+        }
+    return { set, removed };
+}
+//# sourceMappingURL=sync.js.map

package/dist/translations/sync.js.map

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

package/dist/translations/target.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Which space, library or site a `forumulate translations` command means.
+ *
+ * A person types a slug (`--space docs`); the API wants ids. Like the content
+ * commands' library rule (`content/library.ts`): the org is optional, an
+ * ambiguous slug is refused with the orgs named, never guessed.
+ */
+import type { ForumulateClient, LocaleTarget } from '@forumulate/sdk';
+import { TargetError } from '../content/library';
+export { TargetError };
+export interface SpaceTarget {
+    orgId: string;
+    spaceId: string;
+    name: string;
+    type: string;
+}
+export declare function resolveSpace(client: ForumulateClient, want: {
+    org?: string;
+    space?: string;
+}): Promise<SpaceTarget>;
+/** `--space` or `--library` — the two things that declare languages. */
+export declare function resolveLocaleTarget(client: ForumulateClient, want: {
+    org?: string;
+    space?: string;
+    library?: string;
+}): Promise<{
+    orgId: string;
+    target: LocaleTarget;
+    name: string;
+}>;
+/** The org alone (`overrides`), from --org or the only one the caller has. */
+export declare function resolveOrg(client: ForumulateClient, org?: string): Promise<string>;
+//# sourceMappingURL=target.d.ts.map

package/dist/translations/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/translations/target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAS,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAA2B,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,CAAC;AAIvB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAED,wEAAwE;AACxE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhE;AAED,8EAA8E;AAC9E,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKxF"}

package/dist/translations/target.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TargetError = void 0;
+exports.resolveSpace = resolveSpace;
+exports.resolveLocaleTarget = resolveLocaleTarget;
+exports.resolveOrg = resolveOrg;
+const library_1 = require("../content/library");
+Object.defineProperty(exports, "TargetError", { enumerable: true, get: function () { return library_1.TargetError; } });
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+async function resolveSpace(client, want) {
+    if (!want.space)
+        throw new library_1.TargetError('Say which space: --space <id|slug> (or FORUMULATE_SPACE).');
+    const space = want.space;
+    const orgIds = want.org
+        ? [await (0, library_1.orgIdOf)(client, want.org)]
+        : (await client.orgs.list()).orgs.map((o) => o.id);
+    const hits = [];
+    for (const orgId of orgIds) {
+        const listed = await client.spaces.list(orgId).catch(() => ({ spaces: [] }));
+        for (const s of listed.spaces)
+            if (s.id === space || s.slug === space)
+                hits.push({ orgId, spaceId: s.id, name: s.name, type: s.type });
+    }
+    if (hits.length === 1)
+        return hits[0];
+    if (!hits.length) {
+        // An id in an org the listing could not reach (a confined token) is still addressable.
+        if (UUID.test(space) && want.org)
+            return { orgId: await (0, library_1.orgIdOf)(client, want.org), spaceId: space, name: space, type: '' };
+        throw new library_1.TargetError(`No space "${space}"${want.org ? ` in ${want.org}` : ' in any of your organizations'}.`);
+    }
+    throw new library_1.TargetError(`"${space}" names a space in ${hits.length} organizations (${hits.map((h) => h.orgId).join(', ')}); add --org.`);
+}
+/** `--space` or `--library` — the two things that declare languages. */
+async function resolveLocaleTarget(client, want) {
+    if (want.library && !want.space) {
+        const lib = await (0, library_1.resolveLibrary)(client, { org: want.org, library: want.library });
+        return { orgId: lib.orgId, target: { libraryId: lib.libraryId }, name: lib.name };
+    }
+    if (!want.space)
+        throw new library_1.TargetError('Say which space or library: --space <id|slug> or --library <id|slug>.');
+    const s = await resolveSpace(client, want);
+    return { orgId: s.orgId, target: { spaceId: s.spaceId }, name: s.name };
+}
+/** The org alone (`overrides`), from --org or the only one the caller has. */
+async function resolveOrg(client, org) {
+    if (org)
+        return (0, library_1.orgIdOf)(client, org);
+    const { orgs } = await client.orgs.list();
+    if (orgs.length === 1)
+        return orgs[0].id;
+    throw new library_1.TargetError(`Say which organization: --org <id|slug> (you have ${orgs.length}).`);
+}
+//# sourceMappingURL=target.js.map

package/dist/translations/target.js.map

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

package/dist/translations/xliff.d.ts

@@ -0,0 +1,29 @@
+/**
+ * XLIFF 1.2 for the two string tables (chrome labels, UI overrides).
+ *
+ * Every translation management system a customer already pays for (Crowdin,
+ * Lokalise, Phrase, Smartling) imports and exports XLIFF; none of them reads
+ * our label dictionary's JSON. One `<file>` per target language, one
+ * `<trans-unit>` per string: `id` is the key (the original words for a label,
+ * the catalog key for an override), `<source>` what it replaces, `<target>`
+ * the language's words — empty when nobody has translated it yet, so the TMS
+ * shows it as work to do. Small and dependency-free on purpose: the CLI ships
+ * with two dependencies and a parser for one well-known dialect is not a third.
+ */
+export interface XliffUnit {
+    id: string;
+    source: string;
+    target: string;
+}
+export interface XliffFile {
+    /** The target language code (`es`, `pt-BR`). */
+    locale: string;
+    units: XliffUnit[];
+}
+export declare function toXliff(files: XliffFile[], opts: {
+    original: string;
+    sourceLanguage?: string;
+}): string;
+/** Every `<file>` and its units. An empty `<target>` is kept as `''` (untranslated). */
+export declare function fromXliff(xml: string): XliffFile[];
+//# sourceMappingURL=xliff.d.ts.map

package/dist/translations/xliff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xliff.d.ts","sourceRoot":"","sources":["../../src/translations/xliff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAcD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAmBvG;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAmBlD"}

package/dist/translations/xliff.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * XLIFF 1.2 for the two string tables (chrome labels, UI overrides).
+ *
+ * Every translation management system a customer already pays for (Crowdin,
+ * Lokalise, Phrase, Smartling) imports and exports XLIFF; none of them reads
+ * our label dictionary's JSON. One `<file>` per target language, one
+ * `<trans-unit>` per string: `id` is the key (the original words for a label,
+ * the catalog key for an override), `<source>` what it replaces, `<target>`
+ * the language's words — empty when nobody has translated it yet, so the TMS
+ * shows it as work to do. Small and dependency-free on purpose: the CLI ships
+ * with two dependencies and a parser for one well-known dialect is not a third.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toXliff = toXliff;
+exports.fromXliff = fromXliff;
+const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const unesc = (s) => s
+    .replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, '$1')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
+    .replace(/&amp;/g, '&');
+function toXliff(files, opts) {
+    const out = ['<?xml version="1.0" encoding="UTF-8"?>', '<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">'];
+    for (const f of files) {
+        out.push(`  <file original="${esc(opts.original)}" source-language="${esc(opts.sourceLanguage ?? 'en')}" target-language="${esc(f.locale)}" datatype="plaintext">`, '    <body>');
+        for (const u of f.units) {
+            out.push(`      <trans-unit id="${esc(u.id)}">`, `        <source>${esc(u.source)}</source>`, `        <target>${esc(u.target)}</target>`, '      </trans-unit>');
+        }
+        out.push('    </body>', '  </file>');
+    }
+    out.push('</xliff>', '');
+    return out.join('\n');
+}
+/** Every `<file>` and its units. An empty `<target>` is kept as `''` (untranslated). */
+function fromXliff(xml) {
+    const files = [];
+    for (const f of xml.matchAll(/<file\b([^>]*)>([\s\S]*?)<\/file>/g)) {
+        const attrs = f[1] ?? '';
+        const locale = /target-language="([^"]*)"/.exec(attrs)?.[1];
+        if (!locale)
+            throw new Error('An XLIFF <file> has no target-language.');
+        const units = [];
+        for (const u of (f[2] ?? '').matchAll(/<trans-unit\b([^>]*)>([\s\S]*?)<\/trans-unit>/g)) {
+            const id = /\bid="([^"]*)"/.exec(u[1] ?? '')?.[1];
+            if (id === undefined)
+                continue;
+            const inner = u[2] ?? '';
+            const source = /<source\b[^>]*>([\s\S]*?)<\/source>/.exec(inner)?.[1] ?? '';
+            const target = /<target\b[^>]*>([\s\S]*?)<\/target>/.exec(inner)?.[1] ?? '';
+            units.push({ id: unesc(id), source: unesc(source), target: unesc(target) });
+        }
+        files.push({ locale: unesc(locale), units });
+    }
+    if (!files.length)
+        throw new Error('No XLIFF <file> elements found.');
+    return files;
+}
+//# sourceMappingURL=xliff.js.map

package/dist/translations/xliff.js.map

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