@_linked/translation 0.2.2

package/lib/esm/exchange.js

@@ -0,0 +1,223 @@
+import { canonicalLanguageTag } from './key-version.js';
+const EXCHANGE_STATES = new Set([
+    'untranslated',
+    'machine',
+    'reviewed',
+    'stale',
+]);
+const adapters = new Map();
+function record(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return value;
+}
+function requiredString(value, label) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`${label} is required.`);
+    }
+    return value.trim();
+}
+function optionalString(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`${label} must be a non-empty string when supplied.`);
+    }
+    return value.trim();
+}
+function messageFormat(value, label) {
+    if (value !== 'simple' && value !== 'icu') {
+        throw new Error(`${label} must be "simple" or "icu".`);
+    }
+    return value;
+}
+function exchangeKind(value, label) {
+    if (value !== 'ui' && value !== 'semantic') {
+        throw new Error(`${label} must be "ui" or "semantic".`);
+    }
+    return value;
+}
+function canonicalLanguages(value, label) {
+    if (!Array.isArray(value))
+        throw new Error(`${label} must be an array.`);
+    const canonical = [];
+    const seen = new Set();
+    for (const item of value) {
+        if (typeof item !== 'string') {
+            throw new Error(`${label} must contain only BCP-47 strings.`);
+        }
+        const language = canonicalLanguageTag(item);
+        if (!seen.has(language)) {
+            seen.add(language);
+            canonical.push(language);
+        }
+    }
+    return canonical;
+}
+function normalizeTranslations(value, label) {
+    const input = record(value, label);
+    const translations = {};
+    for (const [rawLanguage, rawValue] of Object.entries(input)) {
+        const language = canonicalLanguageTag(rawLanguage);
+        if (translations[language]) {
+            throw new Error(`${label} contains duplicate canonical language "${language}".`);
+        }
+        const item = record(rawValue, `${label}.${rawLanguage}`);
+        if (typeof item.text !== 'string') {
+            throw new Error(`${label}.${rawLanguage}.text must be a string.`);
+        }
+        const state = item.state;
+        if (state !== undefined && !EXCHANGE_STATES.has(state)) {
+            throw new Error(`${label}.${rawLanguage}.state is invalid.`);
+        }
+        translations[language] = {
+            text: item.text,
+            ...(state ? { state: state } : {}),
+            ...(item.note === undefined
+                ? {}
+                : {
+                    note: requiredString(item.note, `${label}.${rawLanguage}.note`),
+                }),
+        };
+    }
+    return translations;
+}
+function normalizeEntry(value, index) {
+    const item = record(value, `entries[${index}]`);
+    const key = requiredString(item.key, `entries[${index}].key`);
+    return {
+        key,
+        ...(item.namespace === undefined
+            ? {}
+            : {
+                namespace: requiredString(item.namespace, `entries[${index}].namespace`),
+            }),
+        kind: exchangeKind(item.kind, `entries[${index}].kind`),
+        format: messageFormat(item.format, `entries[${index}].format`),
+        ...(item.sourceText === undefined
+            ? {}
+            : {
+                sourceText: typeof item.sourceText === 'string'
+                    ? item.sourceText
+                    : requiredString(item.sourceText, `entries[${index}].sourceText`),
+            }),
+        ...(item.keyVersionId === undefined
+            ? {}
+            : {
+                keyVersionId: requiredString(item.keyVersionId, `entries[${index}].keyVersionId`),
+            }),
+        ...(item.sourceHash === undefined
+            ? {}
+            : {
+                sourceHash: requiredString(item.sourceHash, `entries[${index}].sourceHash`),
+            }),
+        ...(item.contractHash === undefined
+            ? {}
+            : {
+                contractHash: requiredString(item.contractHash, `entries[${index}].contractHash`),
+            }),
+        ...(item.argumentSignature === undefined
+            ? {}
+            : {
+                argumentSignature: requiredString(item.argumentSignature, `entries[${index}].argumentSignature`),
+            }),
+        ...(item.description === undefined
+            ? {}
+            : {
+                description: requiredString(item.description, `entries[${index}].description`),
+            }),
+        translations: normalizeTranslations(item.translations, `entries[${index}].translations`),
+    };
+}
+/**
+ * Normalize adapter output without inventing evidence missing from a foreign
+ * file. Import disposition handles those entries as unverified later.
+ */
+export function normalizeParsedTranslationExchangeDocument(value) {
+    var _a;
+    const input = record(value, 'Translation exchange document');
+    if (input.schemaVersion !== 1) {
+        throw new Error('Translation exchange schemaVersion must be 1.');
+    }
+    const sourceLanguage = canonicalLanguageTag(requiredString(input.sourceLanguage, 'sourceLanguage'));
+    const targetLanguages = canonicalLanguages(input.targetLanguages, 'targetLanguages');
+    if (!Array.isArray(input.entries)) {
+        throw new Error('entries must be an array.');
+    }
+    const entries = input.entries.map(normalizeEntry);
+    const identities = new Set();
+    for (const entry of entries) {
+        for (const language of Object.keys(entry.translations)) {
+            const identity = `${(_a = entry.namespace) !== null && _a !== void 0 ? _a : ''}\u0000${entry.key}\u0000${language}`;
+            if (identities.has(identity)) {
+                throw new Error(`Duplicate translation entry for "${entry.key}" in ${language}.`);
+            }
+            identities.add(identity);
+        }
+    }
+    return {
+        schemaVersion: 1,
+        ...(input.appId === undefined
+            ? {}
+            : { appId: requiredString(input.appId, 'appId') }),
+        ...(input.branchId === undefined
+            ? {}
+            : { branchId: requiredString(input.branchId, 'branchId') }),
+        sourceLanguage,
+        targetLanguages,
+        ...(input.exportedAt === undefined
+            ? {}
+            : { exportedAt: requiredString(input.exportedAt, 'exportedAt') }),
+        ...(input.revisionWatermark === undefined
+            ? {}
+            : {
+                revisionWatermark: requiredString(input.revisionWatermark, 'revisionWatermark'),
+            }),
+        ...(input.contractSetHash === undefined
+            ? {}
+            : {
+                contractSetHash: requiredString(input.contractSetHash, 'contractSetHash'),
+            }),
+        entries,
+    };
+}
+/** Validate the stronger, version-evidenced document required for CN exports. */
+export function validateTranslationExchangeDocument(value) {
+    const parsed = normalizeParsedTranslationExchangeDocument(value);
+    const entries = parsed.entries.map((entry, index) => {
+        var _a, _b, _c, _d, _e;
+        return ({
+            ...entry,
+            sourceText: (_a = entry.sourceText) !== null && _a !== void 0 ? _a : requiredString(undefined, `entries[${index}].sourceText`),
+            keyVersionId: (_b = entry.keyVersionId) !== null && _b !== void 0 ? _b : requiredString(undefined, `entries[${index}].keyVersionId`),
+            sourceHash: (_c = entry.sourceHash) !== null && _c !== void 0 ? _c : requiredString(undefined, `entries[${index}].sourceHash`),
+            contractHash: (_d = entry.contractHash) !== null && _d !== void 0 ? _d : requiredString(undefined, `entries[${index}].contractHash`),
+            argumentSignature: (_e = entry.argumentSignature) !== null && _e !== void 0 ? _e : requiredString(undefined, `entries[${index}].argumentSignature`),
+        });
+    });
+    return { ...parsed, entries };
+}
+export function isConfirmedBuildDeclaration(declaration) {
+    var _a, _b;
+    return (((_a = declaration.kind) !== null && _a !== void 0 ? _a : 'ui') !== 'content' &&
+        ((_b = declaration.status) !== null && _b !== void 0 ? _b : 'confirmed') === 'confirmed' &&
+        declaration.authoritative !== false);
+}
+export function registerTranslationFormatAdapter(adapter) {
+    if (adapters.has(adapter.format)) {
+        throw new Error(`Translation format adapter "${adapter.format}" is already registered.`);
+    }
+    adapters.set(adapter.format, adapter);
+}
+export function getTranslationFormatAdapter(format) {
+    return adapters.get(format);
+}
+export function listTranslationFormatAdapters() {
+    return [...adapters.values()].sort((left, right) => left.format.localeCompare(right.format));
+}
+/** Test/host reset hook; adapters are registered explicitly by the host. */
+export function clearTranslationFormatAdapters() {
+    adapters.clear();
+}
+//# sourceMappingURL=exchange.js.map

package/lib/esm/exchange.js.map

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

package/lib/esm/export.d.ts

@@ -0,0 +1,28 @@
+import { type TranslationExchangeDocument } from './exchange.js';
+import type { TranslationEntryRecord, TranslationState } from './records.js';
+export interface TranslationExportOptions {
+    appId?: string;
+    branchId?: string;
+    sourceLanguage: string;
+    revisionWatermark: string;
+    exportedAt?: string;
+    languages?: readonly string[];
+    namespaces?: readonly string[];
+    keys?: readonly string[];
+    states?: readonly TranslationState[];
+}
+export interface TranslationExportFinding {
+    key: string;
+    code: 'content-key-unsupported' | 'missing-current-version';
+    message: string;
+}
+export interface TranslationExportResult {
+    document: TranslationExchangeDocument;
+    documentHash: string;
+    findings: TranslationExportFinding[];
+}
+/**
+ * Build one deterministic, version-evidenced exchange snapshot. Content keys
+ * and versionless keys are reported rather than silently losing metadata.
+ */
+export declare function createTranslationExchangeDocument(entries: readonly TranslationEntryRecord[], options: TranslationExportOptions): Promise<TranslationExportResult>;

package/lib/esm/export.js

@@ -0,0 +1,92 @@
+import { validateTranslationExchangeDocument, } from './exchange.js';
+import { canonicalLanguageTag, sha256Hex } from './key-version.js';
+import { canonicalJson, translationContractSetHash } from './release.js';
+/**
+ * Build one deterministic, version-evidenced exchange snapshot. Content keys
+ * and versionless keys are reported rather than silently losing metadata.
+ */
+export async function createTranslationExchangeDocument(entries, options) {
+    const sourceLanguage = canonicalLanguageTag(options.sourceLanguage);
+    const languageFilter = options.languages
+        ? new Set(options.languages.map(canonicalLanguageTag))
+        : undefined;
+    const namespaceFilter = options.namespaces
+        ? new Set(options.namespaces)
+        : undefined;
+    const keyFilter = options.keys ? new Set(options.keys) : undefined;
+    const stateFilter = options.states ? new Set(options.states) : undefined;
+    const findings = [];
+    const exportEntries = [];
+    for (const entry of [...entries].sort((left, right) => `${left.namespace}\u0000${left.key}`.localeCompare(`${right.namespace}\u0000${right.key}`))) {
+        if (namespaceFilter && !namespaceFilter.has(entry.namespace))
+            continue;
+        if (keyFilter && !keyFilter.has(entry.key))
+            continue;
+        if (entry.kind === 'content') {
+            findings.push({
+                key: entry.key,
+                code: 'content-key-unsupported',
+                message: 'Content translations are not part of the UI exchange format.',
+            });
+            continue;
+        }
+        const version = entry.currentVersion;
+        if (!version) {
+            findings.push({
+                key: entry.key,
+                code: 'missing-current-version',
+                message: 'The key has no current immutable version.',
+            });
+            continue;
+        }
+        const translations = {};
+        for (const [rawLanguage, unit] of Object.entries(entry.units).sort(([left], [right]) => left.localeCompare(right))) {
+            const language = canonicalLanguageTag(rawLanguage);
+            if (language === sourceLanguage)
+                continue;
+            if (languageFilter && !languageFilter.has(language))
+                continue;
+            if (stateFilter && !stateFilter.has(unit.state))
+                continue;
+            translations[language] = {
+                text: unit.text,
+                state: unit.state,
+            };
+        }
+        exportEntries.push({
+            key: entry.key,
+            namespace: entry.namespace,
+            kind: entry.ofShape || entry.ofProperty || entry.fromPackage
+                ? 'semantic'
+                : 'ui',
+            sourceText: version.sourceText,
+            keyVersionId: version.id,
+            sourceHash: version.sourceHash,
+            contractHash: version.contractHash,
+            argumentSignature: version.argumentSignature,
+            description: entry.description,
+            format: version.format,
+            translations,
+        });
+    }
+    const targetLanguages = [
+        ...new Set(exportEntries.flatMap((entry) => Object.keys(entry.translations))),
+    ].sort();
+    const document = validateTranslationExchangeDocument({
+        schemaVersion: 1,
+        appId: options.appId,
+        branchId: options.branchId,
+        sourceLanguage,
+        targetLanguages,
+        exportedAt: options.exportedAt,
+        revisionWatermark: options.revisionWatermark,
+        contractSetHash: await translationContractSetHash(entries.filter((entry) => entry.kind === 'ui')),
+        entries: exportEntries,
+    });
+    return {
+        document,
+        documentHash: await sha256Hex(canonicalJson(document)),
+        findings,
+    };
+}
+//# sourceMappingURL=export.js.map

package/lib/esm/export.js.map

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

package/lib/esm/formats/csv.d.ts

@@ -0,0 +1,8 @@
+import { type TranslationFormatAdapter } from '../exchange.js';
+/**
+ * One row represents one key/language pair. Document and key-version metadata
+ * are repeated deliberately so a CSV remains useful after spreadsheet tools
+ * reorder or filter its rows.
+ */
+export declare const TRANSLATION_CSV_COLUMNS: readonly ["schemaVersion", "appId", "branchId", "sourceLanguage", "targetLanguage", "key", "namespace", "kind", "sourceText", "targetText", "state", "note", "description", "format", "keyVersionId", "sourceHash", "contractHash", "argumentSignature", "exportedAt", "revisionWatermark", "contractSetHash", "createNowEscaping"];
+export declare const translationCsvAdapter: TranslationFormatAdapter;