@_linked/translation 0.2.2

package/lib/esm/compile.d.ts

@@ -0,0 +1,64 @@
+import { type TranslationLanguageDefinition } from './languages.js';
+/**
+ * Compile app translations into publishable per-language payloads + a manifest
+ * (Plan 016 P2.2, AD-K/AD-I). Pure and I/O-free: it takes the same
+ * `TranslationEntryRecord[]` that `TranslationProvider.listEntries` already
+ * produces and emits the `{lang}.json` maps + a content-hashed `manifest.json`.
+ * The R2 publish route (P2.3) and the eject-honest CLI (R11) are thin wrappers
+ * that read the entries, call this, and write the result.
+ *
+ * Only `kind:'ui'` keys are published; `kind:'content'` resolves query-time from
+ * the app's own dataset (AD-I). Per-language publish policy (AD-K/R9): a
+ * `reviewedOnly` language ships the reviewed value else falls back to the English
+ * `sourceText` — never a machine/stale draft. Every payload is a COMPLETE
+ * catalog (English fallback for anything missing), so it stands alone without the
+ * app's inline defaults.
+ */
+import { type TranslationMessages } from './core/messages.js';
+import type { TranslationEntryRecord } from './records.js';
+export type TranslationPayload = TranslationMessages;
+export interface TranslationManifestEntry {
+    hash: string;
+    dir: 'ltr' | 'rtl';
+    count: number;
+}
+export interface TranslationManifest {
+    schemaVersion: 1;
+    defaultLanguage: string;
+    generatedAt?: string;
+    languageResources?: TranslationLanguageDefinition[];
+    languages: Record<string, TranslationManifestEntry>;
+}
+export interface CompileOptions {
+    languageResources?: TranslationLanguageDefinition[];
+    languages: string[];
+    defaultLanguage: string;
+    /** BCP-47 tags published reviewed-only (absence ⇒ machine-ok). */
+    reviewedOnlyLanguages?: Iterable<string>;
+    /** Stamp the manifest; omit for deterministic output (tests). */
+    generatedAt?: string;
+}
+/** Deterministic FNV-1a (32-bit) hex over a string — dep-free, browser-safe. */
+export declare function hashString(input: string): string;
+/** Canonical JSON with sorted keys, so the hash is stable across runs. */
+export declare function stableStringify(payload: TranslationPayload): string;
+/** Content hash of a payload (drives the `{lang}.{hash}.json` filename). */
+export declare function hashPayload(payload: TranslationPayload): string;
+/**
+ * Compile one language's complete catalog from the app's UI entries, honoring
+ * publish policy. The default/source language emits `sourceText` for every key.
+ */
+export declare function compileLanguage(entries: TranslationEntryRecord[], language: string, options: {
+    defaultLanguage: string;
+    reviewedOnly?: boolean;
+    languageResources?: TranslationLanguageDefinition[];
+}): TranslationPayload;
+/** Compile every requested language + a content-hashed manifest. */
+export declare function compileCatalogs(entries: TranslationEntryRecord[], options: CompileOptions): {
+    payloads: Record<string, TranslationPayload>;
+    manifest: TranslationManifest;
+};
+/** Filename for a compiled payload: `{lang}.json` (simple) or `{lang}.{hash}.json`. */
+export declare function payloadFileName(language: string, hash: string, opts?: {
+    hashed?: boolean;
+}): string;

package/lib/esm/compile.js

@@ -0,0 +1,99 @@
+import { languageFallbacks, } from './languages.js';
+/**
+ * Compile app translations into publishable per-language payloads + a manifest
+ * (Plan 016 P2.2, AD-K/AD-I). Pure and I/O-free: it takes the same
+ * `TranslationEntryRecord[]` that `TranslationProvider.listEntries` already
+ * produces and emits the `{lang}.json` maps + a content-hashed `manifest.json`.
+ * The R2 publish route (P2.3) and the eject-honest CLI (R11) are thin wrappers
+ * that read the entries, call this, and write the result.
+ *
+ * Only `kind:'ui'` keys are published; `kind:'content'` resolves query-time from
+ * the app's own dataset (AD-I). Per-language publish policy (AD-K/R9): a
+ * `reviewedOnly` language ships the reviewed value else falls back to the English
+ * `sourceText` — never a machine/stale draft. Every payload is a COMPLETE
+ * catalog (English fallback for anything missing), so it stands alone without the
+ * app's inline defaults.
+ */
+import { directionFor, } from './core/messages.js';
+/** Deterministic FNV-1a (32-bit) hex over a string — dep-free, browser-safe. */
+export function hashString(input) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        h ^= input.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16).padStart(8, '0');
+}
+/** Canonical JSON with sorted keys, so the hash is stable across runs. */
+export function stableStringify(payload) {
+    const keys = Object.keys(payload).sort();
+    return JSON.stringify(Object.fromEntries(keys.map((k) => [k, payload[k]])));
+}
+/** Content hash of a payload (drives the `{lang}.{hash}.json` filename). */
+export function hashPayload(payload) {
+    return hashString(stableStringify(payload));
+}
+/**
+ * Compile one language's complete catalog from the app's UI entries, honoring
+ * publish policy. The default/source language emits `sourceText` for every key.
+ */
+export function compileLanguage(entries, language, options) {
+    var _a, _b;
+    const isSource = language === options.defaultLanguage;
+    const payload = {};
+    const valueFor = (entry, message) => entry.format === 'icu' ? { message, format: 'icu' } : message;
+    for (const entry of entries) {
+        if (entry.kind !== 'ui')
+            continue; // AD-I: content is query-time, not published.
+        const source = (_a = entry.sourceText) !== null && _a !== void 0 ? _a : '';
+        if (isSource) {
+            payload[entry.key] = valueFor(entry, source);
+            continue;
+        }
+        const candidates = languageFallbacks(language, options.defaultLanguage, options.languageResources);
+        const unit = candidates
+            .filter((code) => code !== options.defaultLanguage)
+            .map((code) => { var _a; return (_a = entry.units) === null || _a === void 0 ? void 0 : _a[code]; })
+            .find((candidate) => (candidate === null || candidate === void 0 ? void 0 : candidate.text) &&
+            (!options.reviewedOnly || candidate.state === 'reviewed'));
+        payload[entry.key] = valueFor(entry, (_b = unit === null || unit === void 0 ? void 0 : unit.text) !== null && _b !== void 0 ? _b : source);
+    }
+    return payload;
+}
+/** Compile every requested language + a content-hashed manifest. */
+export function compileCatalogs(entries, options) {
+    var _a, _b, _c, _d;
+    const reviewedOnly = new Set((_a = options.reviewedOnlyLanguages) !== null && _a !== void 0 ? _a : []);
+    const payloads = {};
+    const languages = {};
+    for (const language of options.languages) {
+        const payload = compileLanguage(entries, language, {
+            defaultLanguage: options.defaultLanguage,
+            reviewedOnly: reviewedOnly.has(language),
+            languageResources: options.languageResources,
+        });
+        payloads[language] = payload;
+        languages[language] = {
+            hash: hashPayload(payload),
+            dir: (_d = (_c = (_b = options.languageResources) === null || _b === void 0 ? void 0 : _b.find((item) => item.code === language)) === null || _c === void 0 ? void 0 : _c.direction) !== null && _d !== void 0 ? _d : directionFor(language),
+            count: Object.keys(payload).length,
+        };
+    }
+    return {
+        payloads,
+        manifest: {
+            schemaVersion: 1,
+            defaultLanguage: options.defaultLanguage,
+            ...(options.languageResources
+                ? { languageResources: options.languageResources }
+                : {}),
+            ...(options.generatedAt ? { generatedAt: options.generatedAt } : {}),
+            languages,
+        },
+    };
+}
+/** Filename for a compiled payload: `{lang}.json` (simple) or `{lang}.{hash}.json`. */
+export function payloadFileName(language, hash, opts = {}) {
+    return opts.hashed ? `${language}.${hash}.json` : `${language}.json`;
+}
+//# sourceMappingURL=compile.js.map

package/lib/esm/compile.js.map

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

package/lib/esm/core/messages.d.ts

@@ -0,0 +1,25 @@
+export type MessageFormat = 'simple' | 'icu';
+/** ICU keys retain their format beside the string in mixed-format catalogs. */
+export interface FormattedTranslationMessage {
+    message: string;
+    format: MessageFormat;
+}
+export type TranslationMessage = string | FormattedTranslationMessage;
+/** key → message template, for a single language. */
+export type TranslationMessages = Record<string, TranslationMessage>;
+/** FormatSimple: replace `{name}` placeholders with `params.name`. Unknown → left as-is. */
+export declare function interpolate(template: string, params?: Record<string, unknown>): string;
+/**
+ * Full ICU MessageFormat using the active locale's CLDR plural rules. Invalid
+ * authoring data never crashes the host app: the unformatted template remains
+ * visible and Translation Studio reports the syntax error for repair.
+ */
+export declare function formatIcu(template: string, params?: Record<string, unknown>, locale?: string): string;
+/**
+ * Resolve `key` against a message map, falling back to the inline default (then
+ * the key itself), and format with params. This is what the client `t()` calls.
+ */
+export declare function translate(messages: TranslationMessages, key: string, defaultValue?: string, params?: Record<string, unknown>, format?: MessageFormat, locale?: string): string;
+/** @deprecated Use directionFor; this historical set is not a support boundary. */
+export declare const RTL_LANGUAGES: Set<string>;
+export declare function directionFor(language: string): 'ltr' | 'rtl';

package/lib/esm/core/messages.js

@@ -0,0 +1,76 @@
+/**
+ * Framework-light translation core (Plan 014, P1.5). Pure TS, dependency-free —
+ * the portable heart shared by the React subpath and any non-React consumer, so
+ * a hosted app can use it without pulling React.
+ *
+ * Preserves Tolgee's `t(key, defaultValue?, params?)` semantics so serve's
+ * ~1,302 call sites (with inline English defaults) are a drop-in swap:
+ *   - default formatting is FormatSimple-style `{named}` interpolation (exactly
+ *     what serve uses today), so imported strings render identically;
+ *   - keys marked `format:'icu'` use standards-based ICU MessageFormat with
+ *     the active BCP-47 locale, including plural/select/selectordinal.
+ */
+import { localeDirection } from '../languages.js';
+import IntlMessageFormat from 'intl-messageformat';
+/** FormatSimple: replace `{name}` placeholders with `params.name`. Unknown → left as-is. */
+export function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{\s*([\p{L}\p{N}_][\p{L}\p{N}\p{M}_.-]*)\s*\}/gu, (whole, name) => { var _a; return name in params ? String((_a = params[name]) !== null && _a !== void 0 ? _a : '') : whole; });
+}
+const ICU_CACHE_LIMIT = 500;
+const icuCache = new Map();
+function compiledIcu(template, locale) {
+    const key = `${locale}\u0000${template}`;
+    const cached = icuCache.get(key);
+    if (cached)
+        return cached;
+    const compiled = new IntlMessageFormat(template, locale, undefined, {
+        ignoreTag: true,
+    });
+    if (icuCache.size >= ICU_CACHE_LIMIT) {
+        icuCache.delete(icuCache.keys().next().value);
+    }
+    icuCache.set(key, compiled);
+    return compiled;
+}
+/**
+ * Full ICU MessageFormat using the active locale's CLDR plural rules. Invalid
+ * authoring data never crashes the host app: the unformatted template remains
+ * visible and Translation Studio reports the syntax error for repair.
+ */
+export function formatIcu(template, params, locale = 'en') {
+    try {
+        const result = compiledIcu(template, locale).format(params);
+        return Array.isArray(result) ? result.join('') : String(result);
+    }
+    catch (_a) {
+        return interpolate(template, params);
+    }
+}
+/**
+ * Resolve `key` against a message map, falling back to the inline default (then
+ * the key itself), and format with params. This is what the client `t()` calls.
+ */
+export function translate(messages, key, defaultValue, params, format = 'simple', locale = 'en') {
+    var _a, _b;
+    const stored = messages[key];
+    const template = typeof stored === 'string'
+        ? stored
+        : (_b = (_a = stored === null || stored === void 0 ? void 0 : stored.message) !== null && _a !== void 0 ? _a : defaultValue) !== null && _b !== void 0 ? _b : key;
+    const resolvedFormat = typeof stored === 'object' ? stored.format : format;
+    return resolvedFormat === 'icu'
+        ? formatIcu(template, params, locale)
+        : interpolate(template, params);
+}
+/** @deprecated Use directionFor; this historical set is not a support boundary. */
+export const RTL_LANGUAGES = new Set(['ar', 'ur']);
+export function directionFor(language) {
+    try {
+        return localeDirection(language);
+    }
+    catch (_a) {
+        return 'ltr';
+    }
+}
+//# sourceMappingURL=messages.js.map

package/lib/esm/core/messages.js.map

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

package/lib/esm/data/translation.json

@@ -0,0 +1,8 @@
+{
+  "@context": {
+    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
+    "tr": "https://id.linked.cm/translation/vocab#"
+  },
+  "@graph": []
+}

package/lib/esm/discovery.d.ts

@@ -0,0 +1,97 @@
+import type { MessageFormat } from './core/messages.js';
+import type { TranslationBuildDeclaration, TranslationDeclarationKind } from './exchange.js';
+export type TranslationDeclarationSource = 'code' | 'manifest' | 'package' | 'linked' | 'import' | 'runtime';
+export interface TranslationDeclarationProvenance {
+    source: TranslationDeclarationSource;
+    sourceId: string;
+    authoritative: boolean;
+    file?: string;
+    line?: number;
+    ownerIri?: string;
+    shapeIri?: string;
+    propertyIri?: string;
+    nodeIri?: string;
+    fromPackage?: string;
+    targetClass?: string;
+}
+export interface TranslationDeclaration {
+    schemaVersion: 1;
+    key: string;
+    sourceText: string;
+    namespace?: string;
+    kind: TranslationDeclarationKind;
+    format: MessageFormat;
+    description?: string;
+    provenance: TranslationDeclarationProvenance;
+}
+export interface TranslationDiscoveryContext {
+    appId: string;
+    branchId?: string;
+    sourceRoot?: string;
+}
+export interface TranslationDiscoverySource {
+    readonly name: string;
+    discover(context: TranslationDiscoveryContext): AsyncIterable<TranslationDeclaration>;
+}
+export type TranslationInventoryStatus = 'confirmed' | 'pending' | 'conflict' | 'orphaned';
+export interface TranslationInventoryItem {
+    identity: string;
+    appId: string;
+    key: string;
+    sourceText: string;
+    namespace?: string;
+    kind: TranslationDeclarationKind;
+    format: MessageFormat;
+    description?: string;
+    status: TranslationInventoryStatus;
+    authoritative: boolean;
+    exchangeEligible: boolean;
+    buildEligible: boolean;
+    origins: TranslationDeclarationProvenance[];
+}
+export interface TranslationInventoryConflict {
+    identity: string;
+    declarations: TranslationDeclaration[];
+}
+export interface TranslationInventorySnapshot {
+    schemaVersion: 1;
+    appId: string;
+    branchId?: string;
+    items: TranslationInventoryItem[];
+    conflicts: TranslationInventoryConflict[];
+    buildDeclarations: TranslationBuildDeclaration[];
+}
+export interface TranslationDiscoveryManifestEntry {
+    key: string;
+    sourceText: string;
+    namespace?: string;
+    kind?: TranslationDeclarationKind;
+    format?: MessageFormat;
+    description?: string;
+    ownerIri?: string;
+    shapeIri?: string;
+    propertyIri?: string;
+    nodeIri?: string;
+}
+export interface TranslationDiscoveryManifest {
+    schemaVersion: 1;
+    sourceId: string;
+    declarations: TranslationDiscoveryManifestEntry[];
+}
+export interface DiscoverTranslationInventoryOptions {
+    previous?: TranslationInventorySnapshot;
+}
+/** Parse the portable v1 manifest used to declare dynamic translation keys. */
+export declare function parseTranslationDiscoveryManifest(value: unknown): TranslationDiscoveryManifest;
+/** Turn a portable manifest into an authoritative discovery source. */
+export declare function manifestTranslationDiscoverySource(value: unknown): TranslationDiscoverySource;
+/** Stable identity: UI/semantic by namespace+key; content by node+field IRI. */
+export declare function translationDeclarationIdentity(appId: string, declaration: TranslationDeclaration): string;
+/** Build-facing confirmed subset of a persisted or freshly discovered inventory. */
+export declare function translationBuildDeclarationsFromInventory(items: Iterable<TranslationInventoryItem>): TranslationBuildDeclaration[];
+/**
+ * Discover and deterministically merge every source. This function is pure
+ * with respect to storage: hosts decide how snapshots and lifecycle changes
+ * are persisted.
+ */
+export declare function discoverTranslationInventory(sources: Iterable<TranslationDiscoverySource>, context: TranslationDiscoveryContext, options?: DiscoverTranslationInventoryOptions): Promise<TranslationInventorySnapshot>;