@_linked/translation 0.2.2

package/lib/esm/discovery.js

@@ -0,0 +1,365 @@
+const KIND_ORDER = {
+    ui: 0,
+    semantic: 1,
+    content: 2,
+};
+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 declarationKind(value, label, fallback = 'ui') {
+    const candidate = value !== null && value !== void 0 ? value : fallback;
+    if (candidate !== 'ui' &&
+        candidate !== 'semantic' &&
+        candidate !== 'content') {
+        throw new Error(`${label} must be "ui", "semantic", or "content".`);
+    }
+    return candidate;
+}
+function messageFormat(value, label, fallback = 'simple') {
+    const candidate = value !== null && value !== void 0 ? value : fallback;
+    if (candidate !== 'simple' && candidate !== 'icu') {
+        throw new Error(`${label} must be "simple" or "icu".`);
+    }
+    return candidate;
+}
+function object(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return value;
+}
+function normalizeManifestEntry(value, index) {
+    const entry = object(value, `declarations[${index}]`);
+    const kind = declarationKind(entry.kind, `declarations[${index}].kind`);
+    const nodeIri = optionalString(entry.nodeIri, `declarations[${index}].nodeIri`);
+    const propertyIri = optionalString(entry.propertyIri, `declarations[${index}].propertyIri`);
+    if (kind === 'content' && (!nodeIri || !propertyIri)) {
+        throw new Error(`declarations[${index}] content entries require nodeIri and propertyIri.`);
+    }
+    if (typeof entry.sourceText !== 'string') {
+        throw new Error(`declarations[${index}].sourceText must be a string.`);
+    }
+    return {
+        key: requiredString(entry.key, `declarations[${index}].key`),
+        sourceText: entry.sourceText,
+        kind,
+        format: messageFormat(entry.format, `declarations[${index}].format`),
+        ...(optionalString(entry.namespace, `declarations[${index}].namespace`)
+            ? {
+                namespace: optionalString(entry.namespace, `declarations[${index}].namespace`),
+            }
+            : {}),
+        ...(optionalString(entry.description, `declarations[${index}].description`)
+            ? {
+                description: optionalString(entry.description, `declarations[${index}].description`),
+            }
+            : {}),
+        ...(optionalString(entry.ownerIri, `declarations[${index}].ownerIri`)
+            ? {
+                ownerIri: optionalString(entry.ownerIri, `declarations[${index}].ownerIri`),
+            }
+            : {}),
+        ...(optionalString(entry.shapeIri, `declarations[${index}].shapeIri`)
+            ? {
+                shapeIri: optionalString(entry.shapeIri, `declarations[${index}].shapeIri`),
+            }
+            : {}),
+        ...(propertyIri ? { propertyIri } : {}),
+        ...(nodeIri ? { nodeIri } : {}),
+    };
+}
+/** Parse the portable v1 manifest used to declare dynamic translation keys. */
+export function parseTranslationDiscoveryManifest(value) {
+    const manifest = object(value, 'manifest');
+    if (manifest.schemaVersion !== 1) {
+        throw new Error('Translation discovery manifest schemaVersion must be 1.');
+    }
+    if (!Array.isArray(manifest.declarations)) {
+        throw new Error('Translation discovery manifest declarations must be an array.');
+    }
+    return {
+        schemaVersion: 1,
+        sourceId: requiredString(manifest.sourceId, 'manifest.sourceId'),
+        declarations: manifest.declarations.map(normalizeManifestEntry),
+    };
+}
+/** Turn a portable manifest into an authoritative discovery source. */
+export function manifestTranslationDiscoverySource(value) {
+    const manifest = parseTranslationDiscoveryManifest(value);
+    return {
+        name: `manifest:${manifest.sourceId}`,
+        async *discover() {
+            var _a, _b;
+            for (const entry of manifest.declarations) {
+                yield {
+                    schemaVersion: 1,
+                    key: entry.key,
+                    sourceText: entry.sourceText,
+                    kind: (_a = entry.kind) !== null && _a !== void 0 ? _a : 'ui',
+                    format: (_b = entry.format) !== null && _b !== void 0 ? _b : 'simple',
+                    ...(entry.namespace ? { namespace: entry.namespace } : {}),
+                    ...(entry.description ? { description: entry.description } : {}),
+                    provenance: {
+                        source: 'manifest',
+                        sourceId: manifest.sourceId,
+                        authoritative: true,
+                        ...(entry.ownerIri ? { ownerIri: entry.ownerIri } : {}),
+                        ...(entry.shapeIri ? { shapeIri: entry.shapeIri } : {}),
+                        ...(entry.propertyIri ? { propertyIri: entry.propertyIri } : {}),
+                        ...(entry.nodeIri ? { nodeIri: entry.nodeIri } : {}),
+                    },
+                };
+            }
+        },
+    };
+}
+function normalizeDeclaration(declaration) {
+    if ((declaration === null || declaration === void 0 ? void 0 : declaration.schemaVersion) !== 1) {
+        throw new Error('Translation declaration schemaVersion must be 1.');
+    }
+    const kind = declarationKind(declaration.kind, 'declaration.kind');
+    const provenance = object(declaration.provenance, 'declaration.provenance');
+    const nodeIri = optionalString(provenance.nodeIri, 'provenance.nodeIri');
+    const propertyIri = optionalString(provenance.propertyIri, 'provenance.propertyIri');
+    if (kind === 'content' && (!nodeIri || !propertyIri)) {
+        throw new Error('Content translation declarations require provenance.nodeIri and provenance.propertyIri.');
+    }
+    if (typeof declaration.sourceText !== 'string') {
+        throw new Error('declaration.sourceText must be a string.');
+    }
+    const source = provenance.source;
+    if (source !== 'code' &&
+        source !== 'manifest' &&
+        source !== 'package' &&
+        source !== 'linked' &&
+        source !== 'import' &&
+        source !== 'runtime') {
+        throw new Error('declaration.provenance.source is invalid.');
+    }
+    if (typeof provenance.authoritative !== 'boolean') {
+        throw new Error('declaration.provenance.authoritative must be boolean.');
+    }
+    return {
+        schemaVersion: 1,
+        key: requiredString(declaration.key, 'declaration.key'),
+        sourceText: declaration.sourceText,
+        kind,
+        format: messageFormat(declaration.format, 'declaration.format'),
+        ...(optionalString(declaration.namespace, 'declaration.namespace')
+            ? { namespace: declaration.namespace.trim() }
+            : {}),
+        ...(optionalString(declaration.description, 'declaration.description')
+            ? { description: declaration.description.trim() }
+            : {}),
+        provenance: {
+            source,
+            sourceId: requiredString(provenance.sourceId, 'provenance.sourceId'),
+            authoritative: provenance.authoritative,
+            ...(optionalString(provenance.file, 'provenance.file')
+                ? { file: provenance.file.trim() }
+                : {}),
+            ...(provenance.line === undefined
+                ? {}
+                : Number.isSafeInteger(provenance.line) && provenance.line > 0
+                    ? { line: provenance.line }
+                    : (() => {
+                        throw new Error('provenance.line must be a positive integer.');
+                    })()),
+            ...(optionalString(provenance.ownerIri, 'provenance.ownerIri')
+                ? { ownerIri: provenance.ownerIri.trim() }
+                : {}),
+            ...(optionalString(provenance.shapeIri, 'provenance.shapeIri')
+                ? { shapeIri: provenance.shapeIri.trim() }
+                : {}),
+            ...(propertyIri ? { propertyIri } : {}),
+            ...(nodeIri ? { nodeIri } : {}),
+            ...(optionalString(provenance.fromPackage, 'provenance.fromPackage')
+                ? { fromPackage: provenance.fromPackage.trim() }
+                : {}),
+            ...(optionalString(provenance.targetClass, 'provenance.targetClass')
+                ? { targetClass: provenance.targetClass.trim() }
+                : {}),
+        },
+    };
+}
+/** Stable identity: UI/semantic by namespace+key; content by node+field IRI. */
+export function translationDeclarationIdentity(appId, declaration) {
+    var _a;
+    const normalizedAppId = requiredString(appId, 'appId');
+    if (declaration.kind === 'content') {
+        return `content:${JSON.stringify([
+            normalizedAppId,
+            declaration.provenance.nodeIri,
+            declaration.provenance.propertyIri,
+        ])}`;
+    }
+    return `message:${JSON.stringify([
+        normalizedAppId,
+        (_a = declaration.namespace) !== null && _a !== void 0 ? _a : '',
+        declaration.key,
+    ])}`;
+}
+function canonicalProvenance(provenance) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return JSON.stringify([
+        provenance.source,
+        provenance.sourceId,
+        provenance.authoritative,
+        (_a = provenance.file) !== null && _a !== void 0 ? _a : '',
+        (_b = provenance.line) !== null && _b !== void 0 ? _b : 0,
+        (_c = provenance.ownerIri) !== null && _c !== void 0 ? _c : '',
+        (_d = provenance.shapeIri) !== null && _d !== void 0 ? _d : '',
+        (_e = provenance.propertyIri) !== null && _e !== void 0 ? _e : '',
+        (_f = provenance.nodeIri) !== null && _f !== void 0 ? _f : '',
+        (_g = provenance.fromPackage) !== null && _g !== void 0 ? _g : '',
+        (_h = provenance.targetClass) !== null && _h !== void 0 ? _h : '',
+    ]);
+}
+function sortDeclarations(declarations) {
+    return [...declarations].sort((left, right) => {
+        const source = canonicalProvenance(left.provenance).localeCompare(canonicalProvenance(right.provenance));
+        if (source !== 0)
+            return source;
+        return JSON.stringify([
+            left.sourceText,
+            left.format,
+            left.kind,
+            left.key,
+        ]).localeCompare(JSON.stringify([
+            right.sourceText,
+            right.format,
+            right.kind,
+            right.key,
+        ]));
+    });
+}
+function uniqueOrigins(declarations) {
+    return [
+        ...new Map(sortDeclarations(declarations).map(({ provenance }) => [
+            canonicalProvenance(provenance),
+            provenance,
+        ])).values(),
+    ];
+}
+function itemFromDeclarations(appId, identity, declarations) {
+    var _a;
+    const ordered = sortDeclarations(declarations);
+    const authoritative = ordered.filter(({ provenance }) => provenance.authoritative);
+    const contracts = new Set(authoritative.map(({ sourceText, format }) => JSON.stringify([sourceText, format])));
+    const preferred = (_a = authoritative[0]) !== null && _a !== void 0 ? _a : ordered[0];
+    const conflict = contracts.size > 1;
+    const status = conflict
+        ? 'conflict'
+        : authoritative.length
+            ? 'confirmed'
+            : 'pending';
+    const kind = ordered.reduce((current, declaration) => KIND_ORDER[declaration.kind] > KIND_ORDER[current]
+        ? declaration.kind
+        : current, preferred.kind);
+    const item = {
+        identity,
+        appId,
+        key: preferred.key,
+        sourceText: preferred.sourceText,
+        kind,
+        format: preferred.format,
+        status,
+        authoritative: authoritative.length > 0,
+        exchangeEligible: status === 'confirmed' && kind !== 'content',
+        buildEligible: status === 'confirmed' && kind !== 'content',
+        origins: uniqueOrigins(ordered),
+        ...(preferred.namespace ? { namespace: preferred.namespace } : {}),
+        ...(preferred.description ? { description: preferred.description } : {}),
+    };
+    return {
+        item,
+        ...(conflict ? { conflict: { identity, declarations: ordered } } : {}),
+    };
+}
+function buildDeclaration(item) {
+    const first = item.origins[0];
+    return {
+        key: item.key,
+        sourceText: item.sourceText,
+        format: item.format,
+        kind: item.kind,
+        status: 'confirmed',
+        authoritative: true,
+        ...(item.namespace ? { namespace: item.namespace } : {}),
+        ...((first === null || first === void 0 ? void 0 : first.file) ? { file: first.file } : {}),
+        ...((first === null || first === void 0 ? void 0 : first.line) ? { line: first.line } : {}),
+    };
+}
+/** Build-facing confirmed subset of a persisted or freshly discovered inventory. */
+export function translationBuildDeclarationsFromInventory(items) {
+    return [...items]
+        .filter(({ buildEligible, status }) => buildEligible && status === 'confirmed')
+        .map(buildDeclaration)
+        .sort((left, right) => {
+        var _a, _b;
+        return JSON.stringify([(_a = left.namespace) !== null && _a !== void 0 ? _a : '', left.key]).localeCompare(JSON.stringify([(_b = right.namespace) !== null && _b !== void 0 ? _b : '', right.key]));
+    });
+}
+/**
+ * Discover and deterministically merge every source. This function is pure
+ * with respect to storage: hosts decide how snapshots and lifecycle changes
+ * are persisted.
+ */
+export async function discoverTranslationInventory(sources, context, options = {}) {
+    var _a, _b, _c;
+    const appId = requiredString(context.appId, 'context.appId');
+    const byIdentity = new Map();
+    const orderedSources = [...sources].sort((left, right) => left.name.localeCompare(right.name));
+    for (const source of orderedSources) {
+        for await (const raw of source.discover({ ...context, appId })) {
+            const declaration = normalizeDeclaration(raw);
+            const identity = translationDeclarationIdentity(appId, declaration);
+            const values = (_a = byIdentity.get(identity)) !== null && _a !== void 0 ? _a : [];
+            values.push(declaration);
+            byIdentity.set(identity, values);
+        }
+    }
+    const items = [];
+    const conflicts = [];
+    for (const identity of [...byIdentity.keys()].sort()) {
+        const merged = itemFromDeclarations(appId, identity, byIdentity.get(identity));
+        items.push(merged.item);
+        if (merged.conflict)
+            conflicts.push(merged.conflict);
+    }
+    const currentIdentities = new Set(byIdentity.keys());
+    for (const previous of (_c = (_b = options.previous) === null || _b === void 0 ? void 0 : _b.items) !== null && _c !== void 0 ? _c : []) {
+        if (previous.appId !== appId ||
+            currentIdentities.has(previous.identity) ||
+            previous.status === 'pending') {
+            continue;
+        }
+        items.push({
+            ...previous,
+            status: 'orphaned',
+            buildEligible: false,
+            exchangeEligible: false,
+        });
+    }
+    items.sort((left, right) => left.identity.localeCompare(right.identity));
+    return {
+        schemaVersion: 1,
+        appId,
+        ...(context.branchId ? { branchId: context.branchId } : {}),
+        items,
+        conflicts,
+        buildDeclarations: translationBuildDeclarationsFromInventory(items),
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/lib/esm/discovery.js.map

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

package/lib/esm/exchange.d.ts

@@ -0,0 +1,100 @@
+import type { MessageFormat } from './core/messages.js';
+import type { TranslationState } from './records.js';
+export type TranslationExchangeKind = 'ui' | 'semantic';
+export type TranslationDeclarationKind = TranslationExchangeKind | 'content';
+export type TranslationDeclarationStatus = 'confirmed' | 'pending';
+/**
+ * The build-facing subset of the later multi-source discovery contract.
+ * Static extraction omits the optional fields and retains its existing
+ * confirmed/simple behavior.
+ */
+export interface TranslationBuildDeclaration {
+    key: string;
+    sourceText: string;
+    format?: MessageFormat;
+    kind?: TranslationDeclarationKind;
+    status?: TranslationDeclarationStatus;
+    authoritative?: boolean;
+    namespace?: string;
+    file?: string;
+    line?: number;
+}
+export interface TranslationExchangeValue {
+    text: string;
+    state?: TranslationState;
+    note?: string;
+}
+export interface TranslationExchangeEntry {
+    key: string;
+    namespace?: string;
+    kind: TranslationExchangeKind;
+    sourceText: string;
+    keyVersionId: string;
+    sourceHash: string;
+    contractHash: string;
+    argumentSignature: string;
+    description?: string;
+    format: MessageFormat;
+    translations: Record<string, TranslationExchangeValue>;
+}
+export interface TranslationExchangeDocument {
+    schemaVersion: 1;
+    appId?: string;
+    branchId?: string;
+    sourceLanguage: string;
+    targetLanguages: string[];
+    exportedAt?: string;
+    revisionWatermark?: string;
+    contractSetHash?: string;
+    entries: TranslationExchangeEntry[];
+}
+export type ParsedTranslationExchangeEntry = Omit<TranslationExchangeEntry, 'sourceText' | 'keyVersionId' | 'sourceHash' | 'contractHash' | 'argumentSignature'> & {
+    sourceText?: string;
+    keyVersionId?: string;
+    sourceHash?: string;
+    contractHash?: string;
+    argumentSignature?: string;
+};
+export interface ParsedTranslationExchangeDocument extends Omit<TranslationExchangeDocument, 'entries'> {
+    entries: ParsedTranslationExchangeEntry[];
+}
+export type TranslationFormat = 'xliff-1.2' | 'xliff-2.0' | 'csv' | 'json';
+export interface SerializedTranslationDocument {
+    fileName: string;
+    mediaType: string;
+    body: Uint8Array;
+}
+export interface TranslationFormatAdapter {
+    readonly format: TranslationFormat;
+    sniff(input: Uint8Array, fileName?: string): boolean;
+    parse(input: Uint8Array, options?: unknown): Promise<ParsedTranslationExchangeDocument>;
+    serialize(document: TranslationExchangeDocument, options?: unknown): Promise<SerializedTranslationDocument>;
+}
+export type TranslationImportDisposition = 'import' | 'carry-forward' | 'unverified-source' | 'conflict' | 'skip';
+export interface TranslationImportDryRunEntry {
+    key: string;
+    language: string;
+    disposition: TranslationImportDisposition;
+    expectedKeyVersionId?: string;
+    expectedUnitContentHash?: string;
+}
+export interface TranslationImportDryRun {
+    sessionId: string;
+    documentHash: string;
+    revisionWatermark: string;
+    expiresAt: string;
+    entries: TranslationImportDryRunEntry[];
+}
+/**
+ * Normalize adapter output without inventing evidence missing from a foreign
+ * file. Import disposition handles those entries as unverified later.
+ */
+export declare function normalizeParsedTranslationExchangeDocument(value: unknown): ParsedTranslationExchangeDocument;
+/** Validate the stronger, version-evidenced document required for CN exports. */
+export declare function validateTranslationExchangeDocument(value: unknown): TranslationExchangeDocument;
+export declare function isConfirmedBuildDeclaration(declaration: TranslationBuildDeclaration): boolean;
+export declare function registerTranslationFormatAdapter(adapter: TranslationFormatAdapter): void;
+export declare function getTranslationFormatAdapter(format: TranslationFormat): TranslationFormatAdapter | undefined;
+export declare function listTranslationFormatAdapters(): TranslationFormatAdapter[];
+/** Test/host reset hook; adapters are registered explicitly by the host. */
+export declare function clearTranslationFormatAdapters(): void;