npm - @_linked/translation - Versions diffs - 0.7.0 → 0.8.0 - Mend

@_linked/translation 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (60) hide show

package/README.md +15 -16
package/lib/esm/archive.d.ts +2 -2
package/lib/esm/archive.js +2 -2
package/lib/esm/archive.js.map +1 -1
package/lib/esm/authorization.d.ts +1 -1
package/lib/esm/authorization.js +1 -1
package/lib/esm/authorization.js.map +1 -1
package/lib/esm/cdn-loader.d.ts +1 -1
package/lib/esm/cdn-loader.js.map +1 -1
package/lib/esm/core/messages.d.ts +14 -1
package/lib/esm/core/messages.js +33 -2
package/lib/esm/core/messages.js.map +1 -1
package/lib/esm/exchange.d.ts +1 -1
package/lib/esm/exchange.js +1 -1
package/lib/esm/exchange.js.map +1 -1
package/lib/esm/export.js +4 -1
package/lib/esm/export.js.map +1 -1
package/lib/esm/formats/xliff.js +1 -1
package/lib/esm/formats/xliff.js.map +1 -1
package/lib/esm/key-sync.d.ts +12 -0
package/lib/esm/key-sync.js +32 -7
package/lib/esm/key-sync.js.map +1 -1
package/lib/esm/mt.js +1 -1
package/lib/esm/mt.js.map +1 -1
package/lib/esm/ontologies/translation.d.ts +3 -1
package/lib/esm/ontologies/translation.js +4 -2
package/lib/esm/ontologies/translation.js.map +1 -1
package/lib/esm/react.d.ts +38 -2
package/lib/esm/react.js +98 -15
package/lib/esm/react.js.map +1 -1
package/lib/esm/records.d.ts +2 -1
package/lib/esm/records.js.map +1 -1
package/lib/esm/release.d.ts +3 -1
package/lib/esm/release.js +21 -4
package/lib/esm/release.js.map +1 -1
package/lib/esm/shape-catalog.d.ts +1 -1
package/lib/esm/shape-catalog.js.map +1 -1
package/lib/esm/shapes/TranslationKey.d.ts +10 -5
package/lib/esm/shapes/TranslationKey.js +16 -5
package/lib/esm/shapes/TranslationKey.js.map +1 -1
package/lib/esm/shapes/TranslationProvider.d.ts +25 -8
package/lib/esm/shapes/TranslationProvider.js +50 -19
package/lib/esm/shapes/TranslationProvider.js.map +1 -1
package/package.json +3 -3
package/src/archive.ts +2 -2
package/src/authorization.ts +1 -1
package/src/cdn-loader.ts +1 -1
package/src/core/messages.ts +35 -2
package/src/exchange.ts +1 -1
package/src/export.ts +4 -1
package/src/formats/xliff.ts +1 -1
package/src/key-sync.ts +46 -6
package/src/mt.ts +1 -1
package/src/ontologies/translation.ts +4 -2
package/src/react.tsx +158 -35
package/src/records.ts +2 -1
package/src/release.ts +31 -3
package/src/shape-catalog.ts +1 -1
package/src/shapes/TranslationKey.ts +14 -5
package/src/shapes/TranslationProvider.ts +73 -13

package/lib/esm/release.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { runChecks } from './checks.js';
 import { compileLanguage } from './compile.js';
-import { classifyKeyVersion, sha256Hex } from './key-version.js';
+import { classifyKeyVersion, createArgumentSignature, sha256Hex, } from './key-version.js';
 import { isConfirmedBuildDeclaration, } from './exchange.js';
 export const DEFAULT_TRANSLATION_MAX_PATCHES = 8;
 export const DEFAULT_TRANSLATION_PATCH_TO_BASE_RATIO = 0.25;
@@ -37,10 +37,12 @@ export async function translationContractSetHash(entries) {
 }
 /**
  * Resolve keys extracted from one immutable build workspace to graph versions.
- * Any missing/orphaned/conflicting/default-drifted key fails before publication.
+ * Missing/orphaned/conflicting/default-drifted keys fail before publication.
+ * Explicit app-owned declaration overrides may change wording, never the
+ * exact workspace's declared format or runtime-argument contract.
  */
 export async function buildSnapshotContractSetHash(entries, extracted) {
-    var _a, _b;
+    var _a, _b, _c;
     const declarations = extracted.filter(isConfirmedBuildDeclaration);
     const declarationsByKey = new Map();
     for (const item of declarations) {
@@ -85,7 +87,22 @@ export async function buildSnapshotContractSetHash(entries, extracted) {
         }
         const extractedContract = [...distinct.values()][0];
         const decision = classifyKeyVersion(current, extractedContract);
-        if (decision.action !== 'unchanged') {
+        const explicitDeclarationOverride = entry.overridden === true &&
+            !!(entry.ofShape ||
+                entry.ofProperty ||
+                entry.ofResource ||
+                entry.fromPackage);
+        // source-changed is reached only AFTER the existing classifier has checked
+        // identical format and argument signature. Do not infer the missing format
+        // of a legacy extraction from the very app override being verified.
+        const compatibleAppWording = explicitDeclarationOverride &&
+            decision.reason === 'source-changed' &&
+            ((_c = declarationsByKey.get(entry.key)) !== null && _c !== void 0 ? _c : []).every((item) => item.format !== undefined && item.namespace === entry.namespace) &&
+            entry.sourceText === current.sourceText &&
+            entry.format === current.format &&
+            createArgumentSignature(current.sourceText, current.format) ===
+                current.argumentSignature;
+        if (decision.action !== 'unchanged' && !compatibleAppWording) {
             throw new Error(`Build translation source for "${entry.key}" does not match its current key version (${decision.reason}).`);
         }
     }

package/lib/esm/release.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TranslationLanguageDefinition } from './languages.js';\nimport { runChecks, type CheckFinding } from './checks.js';\nimport { compileLanguage } from './compile.js';\nimport type { TranslationMessages } from './core/messages.js';\nimport { classifyKeyVersion, sha256Hex } from './key-version.js';\nimport {\n isConfirmedBuildDeclaration,\n type TranslationBuildDeclaration,\n} from './exchange.js';\nimport type { GlossaryTermRecord, TranslationEntryRecord } from './records.js';\nimport type { ExtractedTranslationKey } from './key-sync.js';\n\nexport interface TranslationBuildDescriptor {\n schemaVersion: 2;\n appId: string;\n releaseId: string;\n contractSetHash: string;\n manifestUrl: string;\n}\n\n/** Serializable handoff from translation publication to an exact app build. /\nexport interface TranslationBuildPin {\n schemaVersion: 1;\n appId: string;\n branchId: string;\n buildId: string;\n channel: 'preview' \| 'production';\n releaseId: string;\n contractSetHash: string;\n manifestHash: string;\n manifestUrl: string;\n /* Sequence baked into the fallback catalogs at build time. /\n hotfixSequence: number;\n catalogs: Record<string, TranslationCatalogObject>;\n pinnedAt: string;\n /* Which declaration source supplied the contract verifier for this build. /\n inventorySource?: 'confirmed-inventory' \| 'static-fallback';\n}\n\nexport interface TranslationCatalogObject {\n hash: string;\n url: string;\n bytes: number;\n encoding?: 'gzip';\n}\n\nexport interface TranslationCatalogPatchObject\n extends TranslationCatalogObject {\n sequence: number;\n}\n\nexport interface TranslationQualitySummary {\n errors: number;\n warnings: number;\n rules: Record<string, number>;\n}\n\nexport interface TranslationReleaseManifest {\n languageResources?: TranslationLanguageDefinition[];\n schemaVersion: 2;\n releaseId: string;\n contractSetHash: string;\n hotfixSequence: number;\n revisionWatermark?: string;\n /* Compact release selection index: logical key → exact key-version IRI. /\n keyVersions: Record<string, string>;\n quality: Record<string, TranslationQualitySummary>;\n languages: Record<\n string,\n {\n base: TranslationCatalogObject;\n patches: TranslationCatalogPatchObject[];\n }\n >;\n}\n\nexport interface TranslationCatalogPatch {\n set: TranslationMessages;\n remove?: string[];\n}\n\nexport interface CompileReleaseInput {\n languageResources?: TranslationLanguageDefinition[];\n appId: string;\n branchId: string;\n buildId?: string;\n releaseId?: string;\n publicBase?: string;\n channel?: 'preview' \| 'production';\n languages: string[];\n defaultLanguage: string;\n reviewedOnlyLanguages?: Iterable<string>;\n previousRelease?: TranslationReleaseManifest;\n revisionWatermark?: string;\n glossary?: GlossaryTermRecord[];\n allowQualityErrors?: boolean;\n}\n\nexport interface CompiledTranslationRelease {\n descriptor: TranslationBuildDescriptor;\n manifest: TranslationReleaseManifest;\n manifestHash: string;\n immutableObjects: Array<{\n kind: 'base' \| 'patch';\n hash: string;\n body: Uint8Array;\n }>;\n}\n\nexport interface TranslationReleaseReuseCandidate {\n releaseId: string;\n manifestHash: string;\n}\n\nexport interface CompiledTranslationHotfix {\n key: string;\n language: string;\n sequence: number;\n patch: TranslationCatalogPatch;\n immutableObject: {\n kind: 'patch';\n hash: string;\n body: Uint8Array;\n };\n manifest: TranslationReleaseManifest;\n}\n\nexport interface CompiledTranslationCompaction {\n language: string;\n immutableObject: {\n kind: 'base';\n hash: string;\n body: Uint8Array;\n };\n manifest: TranslationReleaseManifest;\n}\n\nexport interface TranslationObjectInventoryEntry {\n /* App-relative object name, for example `objects/catalog/<hash>.json`. /\n name: string;\n lastModified?: Date \| string;\n}\n\nexport interface TranslationCompactionThresholds {\n maxPatches?: number;\n maxPatchToBaseRatio?: number;\n}\n\nexport const DEFAULT_TRANSLATION_MAX_PATCHES = 8;\nexport const DEFAULT_TRANSLATION_PATCH_TO_BASE_RATIO = 0.25;\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\n/* Recursive canonical JSON used for every content-addressed release object. /\nexport function canonicalJson(value: unknown): string {\n if (value === null \|\| typeof value !== 'object') return JSON.stringify(value);\n if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;\n const record = value as Record<string, unknown>;\n return `{${Object.keys(record)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`)\n .join(',')}}`;\n}\n\nfunction translationContracts(entries: TranslationEntryRecord[]) {\n return entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key))\n .map((entry) => ({\n key: entry.key,\n versionId: entry.currentVersion?.id ?? null,\n contractHash: entry.currentVersion?.contractHash ?? null,\n }));\n}\n\n/* The one canonical contract-set hash used by release compile and build pinning. /\nexport async function translationContractSetHash(\n entries: TranslationEntryRecord[]\n): Promise<string> {\n return sha256Hex(canonicalJson(translationContracts(entries)));\n}\n\n/\n Resolve keys extracted from one immutable build workspace to graph versions.\n * Any missing/orphaned/conflicting/default-drifted key fails before publication.\n /\nexport async function buildSnapshotContractSetHash(\n entries: TranslationEntryRecord[],\n extracted: Array<ExtractedTranslationKey \| TranslationBuildDeclaration>\n): Promise<string> {\n const declarations = extracted.filter(isConfirmedBuildDeclaration);\n const declarationsByKey = new Map<string, TranslationBuildDeclaration[]>();\n for (const item of declarations) {\n const values = declarationsByKey.get(item.key) ?? [];\n values.push(item);\n declarationsByKey.set(item.key, values);\n }\n const selected = entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key));\n const graphKeys = new Set(selected.map(({ key }) => key));\n const missing = [...declarationsByKey.keys()]\n .filter((key) => !graphKeys.has(key))\n .sort();\n const orphaned = selected\n .map(({ key }) => key)\n .filter((key) => !declarationsByKey.has(key))\n .sort();\n if (missing.length \|\| orphaned.length) {\n throw new Error(\n `Build translation contract differs from the release: ${\n missing.length ? `missing in graph [${missing.join(', ')}]` : ''\n }${missing.length && orphaned.length ? '; ' : ''}${\n orphaned.length ? `missing in build [${orphaned.join(', ')}]` : ''\n }.`\n );\n }\n\n for (const entry of selected) {\n const current = entry.currentVersion;\n if (!current?.id) {\n throw new Error(\n `Translation key \"${entry.key}\" has no current contract version.`\n );\n }\n const contracts = (declarationsByKey.get(entry.key) ?? []).map(\n (declaration) => ({\n sourceText: declaration.sourceText,\n // Legacy static extraction has no format. Preserve its shipped behavior\n // by resolving against the current graph contract.\n format: declaration.format ?? current.format ?? entry.format,\n })\n );\n const distinct = new Map(\n contracts.map((contract) => [\n canonicalJson([contract.sourceText, contract.format]),\n contract,\n ])\n );\n if (distinct.size > 1) {\n throw new Error(\n `Build translation key \"${entry.key}\" has conflicting source defaults or formats.`\n );\n }\n const extractedContract = [...distinct.values()][0];\n const decision = classifyKeyVersion(current, extractedContract);\n if (decision.action !== 'unchanged') {\n throw new Error(\n `Build translation source for \"${entry.key}\" does not match its current key version (${decision.reason}).`\n );\n }\n }\n return translationContractSetHash(selected);\n}\n\nexport function assertTranslationContractSet(\n buildContractSetHash: string,\n releaseContractSetHash: string\n): void {\n if (buildContractSetHash !== releaseContractSetHash) {\n throw new Error(\n `Build translation contract ${buildContractSetHash} does not match release contract ${releaseContractSetHash}.`\n );\n }\n}\n\n/* Verify immutable catalog bytes before a build adapter writes them. /\nexport async function assertTranslationObjectHash(\n value: string \| Uint8Array,\n expectedHash: string\n): Promise<void> {\n const text = typeof value === 'string' ? value : decoder.decode(value);\n const actual = await sha256Hex(text);\n if (actual !== expectedHash) {\n throw new Error(\n `Translation object hash mismatch: expected ${expectedHash}, received ${actual}.`\n );\n }\n}\n\nexport function createTranslationBuildPin(input: {\n descriptor: TranslationBuildDescriptor;\n manifest: TranslationReleaseManifest;\n manifestHash: string;\n branchId: string;\n buildId: string;\n channel: 'preview' \| 'production';\n pinnedAt?: string;\n inventorySource?: 'confirmed-inventory' \| 'static-fallback';\n}): TranslationBuildPin {\n if (\n input.manifest.releaseId !== input.descriptor.releaseId \|\|\n input.manifest.contractSetHash !== input.descriptor.contractSetHash\n ) {\n throw new Error(\n 'Translation release descriptor and manifest are incompatible.'\n );\n }\n return {\n schemaVersion: 1,\n appId: input.descriptor.appId,\n branchId: input.branchId,\n buildId: input.buildId,\n channel: input.channel,\n releaseId: input.descriptor.releaseId,\n contractSetHash: input.descriptor.contractSetHash,\n manifestHash: input.manifestHash,\n manifestUrl: input.descriptor.manifestUrl,\n hotfixSequence: input.manifest.hotfixSequence,\n catalogs: Object.fromEntries(\n Object.entries(input.manifest.languages).map(([language, lane]) => [\n language,\n lane.base,\n ])\n ),\n pinnedAt: input.pinnedAt ?? new Date().toISOString(),\n ...(input.inventorySource\n ? { inventorySource: input.inventorySource }\n : {}),\n };\n}\n\nexport function decodeReleaseObject(body: Uint8Array): unknown {\n return JSON.parse(decoder.decode(body));\n}\n\nexport function applyCatalogPatches(\n base: TranslationMessages,\n patches: TranslationCatalogPatch[]\n): TranslationMessages {\n const result: TranslationMessages = { ...base };\n for (const patch of patches) {\n for (const key of patch.remove ?? []) delete result[key];\n Object.assign(result, patch.set);\n }\n return result;\n}\n\nexport function releaseReferencesKeyVersion(\n manifest: TranslationReleaseManifest,\n keyVersionId: string\n): boolean {\n return Object.values(manifest.keyVersions).includes(keyVersionId);\n}\n\nexport function keyForVersion(\n manifest: TranslationReleaseManifest,\n keyVersionId: string\n): string \| undefined {\n return Object.entries(manifest.keyVersions).find(\n ([, version]) => version === keyVersionId\n )?.[0];\n}\n\nexport function shouldCompactTranslationLanguage(\n lane: TranslationReleaseManifest['languages'][string],\n thresholds: TranslationCompactionThresholds = {}\n): boolean {\n const maxPatches = thresholds.maxPatches ?? DEFAULT_TRANSLATION_MAX_PATCHES;\n const maxPatchToBaseRatio =\n thresholds.maxPatchToBaseRatio ?? DEFAULT_TRANSLATION_PATCH_TO_BASE_RATIO;\n if (lane.patches.length > maxPatches) return true;\n if (lane.base.bytes <= 0) return lane.patches.length > 0;\n const patchBytes = lane.patches.reduce(\n (total, patch) => total + patch.bytes,\n 0\n );\n return patchBytes > lane.base.bytes maxPatchToBaseRatio;\n}\n\nfunction publicBaseFromObjectUrl(url: string): string \| undefined {\n const marker = '/objects/';\n const index = url.indexOf(marker);\n return index < 0 ? undefined : url.slice(0, index);\n}\n\n/*\n Replace one eligible patch chain with an equivalent immutable base. The\n * release identity, contract set, and hotfix sequence deliberately do not\n * change because compaction changes representation, not translation content.\n /\nexport async function compileTranslationCompaction(input: {\n manifest: TranslationReleaseManifest;\n language: string;\n currentMessages: TranslationMessages;\n force?: boolean;\n thresholds?: TranslationCompactionThresholds;\n}): Promise<CompiledTranslationCompaction \| null> {\n const lane = input.manifest.languages[input.language];\n if (!lane) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not publish ${input.language}.`\n );\n }\n if (\n !input.force &&\n !shouldCompactTranslationLanguage(lane, input.thresholds)\n ) {\n return null;\n }\n if (lane.patches.length === 0) return null;\n\n const body = encoder.encode(canonicalJson(input.currentMessages));\n const hash = await sha256Hex(decoder.decode(body));\n const base: TranslationCatalogObject = {\n hash,\n url: objectUrl(\n publicBaseFromObjectUrl(lane.base.url),\n `objects/catalog/${hash}.json`\n ),\n bytes: body.byteLength,\n };\n return {\n language: input.language,\n immutableObject: { kind: 'base', hash, body },\n manifest: {\n ...input.manifest,\n languages: {\n ...input.manifest.languages,\n [input.language]: {\n base,\n patches: [],\n },\n },\n },\n };\n}\n\nfunction objectNameFromUrl(url: string, fallback: string): string {\n const clean = url.split(/[?#]/, 1)[0].replace(/^\\/+/, '');\n const marker = 'objects/';\n const index = clean.indexOf(marker);\n return index >= 0 ? clean.slice(index) : fallback;\n}\n\n/* Every immutable object directly reachable from the supplied manifests. /\nexport function collectReferencedTranslationObjects(\n manifests: Iterable<TranslationReleaseManifest>\n): Set<string> {\n const referenced = new Set<string>();\n for (const manifest of manifests) {\n for (const lane of Object.values(manifest.languages)) {\n referenced.add(\n objectNameFromUrl(\n lane.base.url,\n `objects/catalog/${lane.base.hash}.json${\n lane.base.encoding === 'gzip' ? '.gz' : ''\n }`\n )\n );\n for (const patch of lane.patches) {\n referenced.add(\n objectNameFromUrl(\n patch.url,\n `objects/patch/${patch.hash}.json${\n patch.encoding === 'gzip' ? '.gz' : ''\n }`\n )\n );\n }\n }\n }\n return referenced;\n}\n\n/\n Mark only old, content-addressed objects that are absent from every retained\n * manifest. Unknown timestamps fail closed and remain retained.\n /\nexport function selectPrunableTranslationObjects(input: {\n objects: Iterable<TranslationObjectInventoryEntry>;\n manifests: Iterable<TranslationReleaseManifest>;\n now?: Date \| number;\n gracePeriodMs: number;\n}): string[] {\n if (!Number.isFinite(input.gracePeriodMs) \|\| input.gracePeriodMs < 0) {\n throw new Error('gracePeriodMs must be a non-negative finite number.');\n }\n const now =\n input.now instanceof Date ? input.now.getTime() : input.now ?? Date.now();\n const referenced = collectReferencedTranslationObjects(input.manifests);\n const candidates = new Set<string>();\n for (const object of input.objects) {\n const name = object.name.replace(/^\\/+/, '');\n if (\n !/^objects\\/(?:catalog\|patch)\\/[^/]+\\.json(?:\\.gz)?$/.test(name) \|\|\n referenced.has(name) \|\|\n !object.lastModified\n ) {\n continue;\n }\n const modifiedAt =\n object.lastModified instanceof Date\n ? object.lastModified.getTime()\n : new Date(object.lastModified).getTime();\n if (\n Number.isFinite(modifiedAt) &&\n now - modifiedAt >= input.gracePeriodMs\n ) {\n candidates.add(name);\n }\n }\n return [...candidates].sort();\n}\n\n/\n Create one content-addressed language patch and advance a compatible\n * manifest. Returns null for an idempotent re-approval of the current value.\n /\nexport async function compileTranslationHotfix(input: {\n manifest: TranslationReleaseManifest;\n keyVersionId: string;\n language: string;\n text: string;\n currentMessages: TranslationMessages;\n}): Promise<CompiledTranslationHotfix \| null> {\n const key = keyForVersion(input.manifest, input.keyVersionId);\n if (!key) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not reference key version ${input.keyVersionId}.`\n );\n }\n const lane = input.manifest.languages[input.language];\n if (!lane) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not publish ${input.language}.`\n );\n }\n const current = input.currentMessages[key];\n const next =\n typeof current === 'object' && current?.format === 'icu'\n ? { message: input.text, format: 'icu' as const }\n : input.text;\n if (canonicalJson(current) === canonicalJson(next)) return null;\n\n const patch: TranslationCatalogPatch = { set: { [key]: next } };\n const body = encoder.encode(canonicalJson(patch));\n const hash = await sha256Hex(decoder.decode(body));\n const sequence = input.manifest.hotfixSequence + 1;\n const publicBase = publicBaseFromObjectUrl(lane.base.url);\n const patchObject: TranslationCatalogPatchObject = {\n hash,\n url: objectUrl(publicBase, `objects/patch/${hash}.json`),\n bytes: body.byteLength,\n sequence,\n };\n return {\n key,\n language: input.language,\n sequence,\n patch,\n immutableObject: { kind: 'patch', hash, body },\n manifest: {\n ...input.manifest,\n hotfixSequence: sequence,\n languages: {\n ...input.manifest.languages,\n [input.language]: {\n ...lane,\n patches: [...lane.patches, patchObject],\n },\n },\n },\n };\n}\n\nfunction qualitySummary(findings: CheckFinding[]): TranslationQualitySummary {\n const rules: Record<string, number> = {};\n let errors = 0;\n let warnings = 0;\n for (const finding of findings) {\n finding.severity === 'error' ? errors++ : warnings++;\n rules[finding.rule] = (rules[finding.rule] ?? 0) + 1;\n }\n return { errors, warnings, rules };\n}\n\nfunction objectUrl(publicBase: string \| undefined, path: string): string {\n const base = publicBase?.replace(/\\/+$/, '');\n return base ? `${base}/${path}` : path;\n}\n\n/\n Compile one immutable schema-v2 release. The input entries are the captured\n * graph snapshot; callers are responsible for supplying its revision watermark.\n /\nexport async function compileRelease(\n entries: TranslationEntryRecord[],\n input: CompileReleaseInput\n): Promise<CompiledTranslationRelease> {\n const reviewedOnly = new Set(input.reviewedOnlyLanguages ?? []);\n const selected = entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key));\n const missingVersion = selected.find((entry) => !entry.currentVersion?.id);\n if (missingVersion) {\n throw new Error(\n `Translation key \"${missingVersion.key}\" has no current contract version.`\n );\n }\n const keyVersions = Object.fromEntries(\n selected.map((entry) => [entry.key, entry.currentVersion!.id])\n );\n const contractSetHash = await translationContractSetHash(selected);\n const releaseSeed = canonicalJson([\n input.appId,\n input.branchId,\n input.buildId ?? '',\n contractSetHash,\n ]);\n const releaseId =\n input.releaseId?.trim() \|\|\n `release-${(await sha256Hex(releaseSeed)).slice(0, 24)}`;\n const immutableObjects: CompiledTranslationRelease['immutableObjects'] = [];\n const languages: TranslationReleaseManifest['languages'] = {};\n const quality: TranslationReleaseManifest['quality'] = {};\n\n for (const language of [...new Set(input.languages)].sort()) {\n const payload = compileLanguage(selected, language, {\n defaultLanguage: input.defaultLanguage,\n reviewedOnly: reviewedOnly.has(language),\n languageResources: input.languageResources,\n });\n const body = encoder.encode(canonicalJson(payload));\n const hash = await sha256Hex(decoder.decode(body));\n immutableObjects.push({ kind: 'base', hash, body });\n languages[language] = {\n base: {\n hash,\n url: objectUrl(input.publicBase, `objects/catalog/${hash}.json`),\n bytes: body.byteLength,\n },\n patches: [],\n };\n const checkedEntries = selected.map((entry) => {\n const message = payload[entry.key];\n const text =\n typeof message === 'string' ? message : message?.message ?? '';\n return {\n ...entry,\n units: {\n ...entry.units,\n [language]: {\n language,\n text,\n state: entry.units[language]?.state ?? 'untranslated',\n },\n },\n };\n });\n quality[language] = qualitySummary(\n language === input.defaultLanguage\n ? []\n : runChecks(checkedEntries, language, input.glossary ?? [])\n );\n }\n\n const errorCount = Object.values(quality).reduce(\n (total, summary) => total + summary.errors,\n 0\n );\n if (\n input.channel === 'production' &&\n errorCount > 0 &&\n !input.allowQualityErrors\n ) {\n throw new Error(\n `Production translation release blocked by ${errorCount} quality error${\n errorCount === 1 ? '' : 's'\n }.`\n );\n }\n\n const manifest: TranslationReleaseManifest = {\n schemaVersion: 2,\n releaseId,\n contractSetHash,\n hotfixSequence: 0,\n ...(input.revisionWatermark\n ? { revisionWatermark: input.revisionWatermark }\n : {}),\n keyVersions,\n quality,\n languages,\n ...(input.languageResources\n ? { languageResources: input.languageResources }\n : {}),\n };\n const manifestHash = await sha256Hex(canonicalJson(manifest));\n return {\n descriptor: {\n schemaVersion: 2,\n appId: input.appId,\n releaseId,\n contractSetHash,\n manifestUrl: objectUrl(\n input.publicBase,\n `releases/${releaseId}/manifest.json`\n ),\n },\n manifest,\n manifestHash,\n immutableObjects,\n };\n}\n\n/\n Recompile content beneath existing release identities and reuse only an\n * exact manifest match. Contract equality alone is insufficient because\n * selected translations, language policy, quality, or delivery URLs may differ.\n */\nexport async function findReusableCompiledRelease(\n entries: TranslationEntryRecord[],\n input: Omit<CompileReleaseInput, 'releaseId' \| 'buildId'>,\n candidates: TranslationReleaseReuseCandidate[]\n): Promise<CompiledTranslationRelease \| null> {\n for (const candidate of candidates) {\n const compiled = await compileRelease(entries, {\n ...input,\n releaseId: candidate.releaseId,\n });\n if (compiled.manifestHash === candidate.manifestHash) return compiled;\n }\n return null;\n}\n"]}
1	+ {"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TranslationLanguageDefinition } from './languages.js';\nimport { runChecks, type CheckFinding } from './checks.js';\nimport { compileLanguage } from './compile.js';\nimport type { TranslationMessages } from './core/messages.js';\nimport {\n classifyKeyVersion,\n createArgumentSignature,\n sha256Hex,\n} from './key-version.js';\nimport {\n isConfirmedBuildDeclaration,\n type TranslationBuildDeclaration,\n} from './exchange.js';\nimport type { GlossaryTermRecord, TranslationEntryRecord } from './records.js';\nimport type { ExtractedTranslationKey } from './key-sync.js';\n\nexport interface TranslationBuildDescriptor {\n schemaVersion: 2;\n appId: string;\n releaseId: string;\n contractSetHash: string;\n manifestUrl: string;\n}\n\n/** Serializable handoff from translation publication to an exact app build. /\nexport interface TranslationBuildPin {\n schemaVersion: 1;\n appId: string;\n branchId: string;\n buildId: string;\n channel: 'preview' \| 'production';\n releaseId: string;\n contractSetHash: string;\n manifestHash: string;\n manifestUrl: string;\n /* Sequence baked into the fallback catalogs at build time. /\n hotfixSequence: number;\n catalogs: Record<string, TranslationCatalogObject>;\n pinnedAt: string;\n /* Which declaration source supplied the contract verifier for this build. /\n inventorySource?: 'confirmed-inventory' \| 'static-fallback';\n}\n\nexport interface TranslationCatalogObject {\n hash: string;\n url: string;\n bytes: number;\n encoding?: 'gzip';\n}\n\nexport interface TranslationCatalogPatchObject\n extends TranslationCatalogObject {\n sequence: number;\n}\n\nexport interface TranslationQualitySummary {\n errors: number;\n warnings: number;\n rules: Record<string, number>;\n}\n\nexport interface TranslationReleaseManifest {\n languageResources?: TranslationLanguageDefinition[];\n schemaVersion: 2;\n releaseId: string;\n contractSetHash: string;\n hotfixSequence: number;\n revisionWatermark?: string;\n /* Compact release selection index: logical key → exact key-version IRI. /\n keyVersions: Record<string, string>;\n quality: Record<string, TranslationQualitySummary>;\n languages: Record<\n string,\n {\n base: TranslationCatalogObject;\n patches: TranslationCatalogPatchObject[];\n }\n >;\n}\n\nexport interface TranslationCatalogPatch {\n set: TranslationMessages;\n remove?: string[];\n}\n\nexport interface CompileReleaseInput {\n languageResources?: TranslationLanguageDefinition[];\n appId: string;\n branchId: string;\n buildId?: string;\n releaseId?: string;\n publicBase?: string;\n channel?: 'preview' \| 'production';\n languages: string[];\n defaultLanguage: string;\n reviewedOnlyLanguages?: Iterable<string>;\n previousRelease?: TranslationReleaseManifest;\n revisionWatermark?: string;\n glossary?: GlossaryTermRecord[];\n allowQualityErrors?: boolean;\n}\n\nexport interface CompiledTranslationRelease {\n descriptor: TranslationBuildDescriptor;\n manifest: TranslationReleaseManifest;\n manifestHash: string;\n immutableObjects: Array<{\n kind: 'base' \| 'patch';\n hash: string;\n body: Uint8Array;\n }>;\n}\n\nexport interface TranslationReleaseReuseCandidate {\n releaseId: string;\n manifestHash: string;\n}\n\nexport interface CompiledTranslationHotfix {\n key: string;\n language: string;\n sequence: number;\n patch: TranslationCatalogPatch;\n immutableObject: {\n kind: 'patch';\n hash: string;\n body: Uint8Array;\n };\n manifest: TranslationReleaseManifest;\n}\n\nexport interface CompiledTranslationCompaction {\n language: string;\n immutableObject: {\n kind: 'base';\n hash: string;\n body: Uint8Array;\n };\n manifest: TranslationReleaseManifest;\n}\n\nexport interface TranslationObjectInventoryEntry {\n /* App-relative object name, for example `objects/catalog/<hash>.json`. /\n name: string;\n lastModified?: Date \| string;\n}\n\nexport interface TranslationCompactionThresholds {\n maxPatches?: number;\n maxPatchToBaseRatio?: number;\n}\n\nexport const DEFAULT_TRANSLATION_MAX_PATCHES = 8;\nexport const DEFAULT_TRANSLATION_PATCH_TO_BASE_RATIO = 0.25;\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\n/* Recursive canonical JSON used for every content-addressed release object. /\nexport function canonicalJson(value: unknown): string {\n if (value === null \|\| typeof value !== 'object') return JSON.stringify(value);\n if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;\n const record = value as Record<string, unknown>;\n return `{${Object.keys(record)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`)\n .join(',')}}`;\n}\n\nfunction translationContracts(entries: TranslationEntryRecord[]) {\n return entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key))\n .map((entry) => ({\n key: entry.key,\n versionId: entry.currentVersion?.id ?? null,\n contractHash: entry.currentVersion?.contractHash ?? null,\n }));\n}\n\n/* The one canonical contract-set hash used by release compile and build pinning. /\nexport async function translationContractSetHash(\n entries: TranslationEntryRecord[]\n): Promise<string> {\n return sha256Hex(canonicalJson(translationContracts(entries)));\n}\n\n/\n Resolve keys extracted from one immutable build workspace to graph versions.\n * Missing/orphaned/conflicting/default-drifted keys fail before publication.\n * Explicit app-owned declaration overrides may change wording, never the\n * exact workspace's declared format or runtime-argument contract.\n /\nexport async function buildSnapshotContractSetHash(\n entries: TranslationEntryRecord[],\n extracted: Array<ExtractedTranslationKey \| TranslationBuildDeclaration>\n): Promise<string> {\n const declarations = extracted.filter(isConfirmedBuildDeclaration);\n const declarationsByKey = new Map<string, TranslationBuildDeclaration[]>();\n for (const item of declarations) {\n const values = declarationsByKey.get(item.key) ?? [];\n values.push(item);\n declarationsByKey.set(item.key, values);\n }\n const selected = entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key));\n const graphKeys = new Set(selected.map(({ key }) => key));\n const missing = [...declarationsByKey.keys()]\n .filter((key) => !graphKeys.has(key))\n .sort();\n const orphaned = selected\n .map(({ key }) => key)\n .filter((key) => !declarationsByKey.has(key))\n .sort();\n if (missing.length \|\| orphaned.length) {\n throw new Error(\n `Build translation contract differs from the release: ${\n missing.length ? `missing in graph [${missing.join(', ')}]` : ''\n }${missing.length && orphaned.length ? '; ' : ''}${\n orphaned.length ? `missing in build [${orphaned.join(', ')}]` : ''\n }.`\n );\n }\n\n for (const entry of selected) {\n const current = entry.currentVersion;\n if (!current?.id) {\n throw new Error(\n `Translation key \"${entry.key}\" has no current contract version.`\n );\n }\n const contracts = (declarationsByKey.get(entry.key) ?? []).map(\n (declaration) => ({\n sourceText: declaration.sourceText,\n // Legacy static extraction has no format. Preserve its shipped behavior\n // by resolving against the current graph contract.\n format: declaration.format ?? current.format ?? entry.format,\n })\n );\n const distinct = new Map(\n contracts.map((contract) => [\n canonicalJson([contract.sourceText, contract.format]),\n contract,\n ])\n );\n if (distinct.size > 1) {\n throw new Error(\n `Build translation key \"${entry.key}\" has conflicting source defaults or formats.`\n );\n }\n const extractedContract = [...distinct.values()][0];\n const decision = classifyKeyVersion(current, extractedContract);\n const explicitDeclarationOverride =\n entry.overridden === true &&\n !!(\n entry.ofShape \|\|\n entry.ofProperty \|\|\n entry.ofResource \|\|\n entry.fromPackage\n );\n // source-changed is reached only AFTER the existing classifier has checked\n // identical format and argument signature. Do not infer the missing format\n // of a legacy extraction from the very app override being verified.\n const compatibleAppWording =\n explicitDeclarationOverride &&\n decision.reason === 'source-changed' &&\n (declarationsByKey.get(entry.key) ?? []).every(\n (item) =>\n item.format !== undefined && item.namespace === entry.namespace\n ) &&\n entry.sourceText === current.sourceText &&\n entry.format === current.format &&\n createArgumentSignature(current.sourceText, current.format) ===\n current.argumentSignature;\n if (decision.action !== 'unchanged' && !compatibleAppWording) {\n throw new Error(\n `Build translation source for \"${entry.key}\" does not match its current key version (${decision.reason}).`\n );\n }\n }\n return translationContractSetHash(selected);\n}\n\nexport function assertTranslationContractSet(\n buildContractSetHash: string,\n releaseContractSetHash: string\n): void {\n if (buildContractSetHash !== releaseContractSetHash) {\n throw new Error(\n `Build translation contract ${buildContractSetHash} does not match release contract ${releaseContractSetHash}.`\n );\n }\n}\n\n/* Verify immutable catalog bytes before a build adapter writes them. /\nexport async function assertTranslationObjectHash(\n value: string \| Uint8Array,\n expectedHash: string\n): Promise<void> {\n const text = typeof value === 'string' ? value : decoder.decode(value);\n const actual = await sha256Hex(text);\n if (actual !== expectedHash) {\n throw new Error(\n `Translation object hash mismatch: expected ${expectedHash}, received ${actual}.`\n );\n }\n}\n\nexport function createTranslationBuildPin(input: {\n descriptor: TranslationBuildDescriptor;\n manifest: TranslationReleaseManifest;\n manifestHash: string;\n branchId: string;\n buildId: string;\n channel: 'preview' \| 'production';\n pinnedAt?: string;\n inventorySource?: 'confirmed-inventory' \| 'static-fallback';\n}): TranslationBuildPin {\n if (\n input.manifest.releaseId !== input.descriptor.releaseId \|\|\n input.manifest.contractSetHash !== input.descriptor.contractSetHash\n ) {\n throw new Error(\n 'Translation release descriptor and manifest are incompatible.'\n );\n }\n return {\n schemaVersion: 1,\n appId: input.descriptor.appId,\n branchId: input.branchId,\n buildId: input.buildId,\n channel: input.channel,\n releaseId: input.descriptor.releaseId,\n contractSetHash: input.descriptor.contractSetHash,\n manifestHash: input.manifestHash,\n manifestUrl: input.descriptor.manifestUrl,\n hotfixSequence: input.manifest.hotfixSequence,\n catalogs: Object.fromEntries(\n Object.entries(input.manifest.languages).map(([language, lane]) => [\n language,\n lane.base,\n ])\n ),\n pinnedAt: input.pinnedAt ?? new Date().toISOString(),\n ...(input.inventorySource\n ? { inventorySource: input.inventorySource }\n : {}),\n };\n}\n\nexport function decodeReleaseObject(body: Uint8Array): unknown {\n return JSON.parse(decoder.decode(body));\n}\n\nexport function applyCatalogPatches(\n base: TranslationMessages,\n patches: TranslationCatalogPatch[]\n): TranslationMessages {\n const result: TranslationMessages = { ...base };\n for (const patch of patches) {\n for (const key of patch.remove ?? []) delete result[key];\n Object.assign(result, patch.set);\n }\n return result;\n}\n\nexport function releaseReferencesKeyVersion(\n manifest: TranslationReleaseManifest,\n keyVersionId: string\n): boolean {\n return Object.values(manifest.keyVersions).includes(keyVersionId);\n}\n\nexport function keyForVersion(\n manifest: TranslationReleaseManifest,\n keyVersionId: string\n): string \| undefined {\n return Object.entries(manifest.keyVersions).find(\n ([, version]) => version === keyVersionId\n )?.[0];\n}\n\nexport function shouldCompactTranslationLanguage(\n lane: TranslationReleaseManifest['languages'][string],\n thresholds: TranslationCompactionThresholds = {}\n): boolean {\n const maxPatches = thresholds.maxPatches ?? DEFAULT_TRANSLATION_MAX_PATCHES;\n const maxPatchToBaseRatio =\n thresholds.maxPatchToBaseRatio ?? DEFAULT_TRANSLATION_PATCH_TO_BASE_RATIO;\n if (lane.patches.length > maxPatches) return true;\n if (lane.base.bytes <= 0) return lane.patches.length > 0;\n const patchBytes = lane.patches.reduce(\n (total, patch) => total + patch.bytes,\n 0\n );\n return patchBytes > lane.base.bytes maxPatchToBaseRatio;\n}\n\nfunction publicBaseFromObjectUrl(url: string): string \| undefined {\n const marker = '/objects/';\n const index = url.indexOf(marker);\n return index < 0 ? undefined : url.slice(0, index);\n}\n\n/*\n Replace one eligible patch chain with an equivalent immutable base. The\n * release identity, contract set, and hotfix sequence deliberately do not\n * change because compaction changes representation, not translation content.\n /\nexport async function compileTranslationCompaction(input: {\n manifest: TranslationReleaseManifest;\n language: string;\n currentMessages: TranslationMessages;\n force?: boolean;\n thresholds?: TranslationCompactionThresholds;\n}): Promise<CompiledTranslationCompaction \| null> {\n const lane = input.manifest.languages[input.language];\n if (!lane) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not publish ${input.language}.`\n );\n }\n if (\n !input.force &&\n !shouldCompactTranslationLanguage(lane, input.thresholds)\n ) {\n return null;\n }\n if (lane.patches.length === 0) return null;\n\n const body = encoder.encode(canonicalJson(input.currentMessages));\n const hash = await sha256Hex(decoder.decode(body));\n const base: TranslationCatalogObject = {\n hash,\n url: objectUrl(\n publicBaseFromObjectUrl(lane.base.url),\n `objects/catalog/${hash}.json`\n ),\n bytes: body.byteLength,\n };\n return {\n language: input.language,\n immutableObject: { kind: 'base', hash, body },\n manifest: {\n ...input.manifest,\n languages: {\n ...input.manifest.languages,\n [input.language]: {\n base,\n patches: [],\n },\n },\n },\n };\n}\n\nfunction objectNameFromUrl(url: string, fallback: string): string {\n const clean = url.split(/[?#]/, 1)[0].replace(/^\\/+/, '');\n const marker = 'objects/';\n const index = clean.indexOf(marker);\n return index >= 0 ? clean.slice(index) : fallback;\n}\n\n/* Every immutable object directly reachable from the supplied manifests. /\nexport function collectReferencedTranslationObjects(\n manifests: Iterable<TranslationReleaseManifest>\n): Set<string> {\n const referenced = new Set<string>();\n for (const manifest of manifests) {\n for (const lane of Object.values(manifest.languages)) {\n referenced.add(\n objectNameFromUrl(\n lane.base.url,\n `objects/catalog/${lane.base.hash}.json${\n lane.base.encoding === 'gzip' ? '.gz' : ''\n }`\n )\n );\n for (const patch of lane.patches) {\n referenced.add(\n objectNameFromUrl(\n patch.url,\n `objects/patch/${patch.hash}.json${\n patch.encoding === 'gzip' ? '.gz' : ''\n }`\n )\n );\n }\n }\n }\n return referenced;\n}\n\n/\n Mark only old, content-addressed objects that are absent from every retained\n * manifest. Unknown timestamps fail closed and remain retained.\n /\nexport function selectPrunableTranslationObjects(input: {\n objects: Iterable<TranslationObjectInventoryEntry>;\n manifests: Iterable<TranslationReleaseManifest>;\n now?: Date \| number;\n gracePeriodMs: number;\n}): string[] {\n if (!Number.isFinite(input.gracePeriodMs) \|\| input.gracePeriodMs < 0) {\n throw new Error('gracePeriodMs must be a non-negative finite number.');\n }\n const now =\n input.now instanceof Date ? input.now.getTime() : input.now ?? Date.now();\n const referenced = collectReferencedTranslationObjects(input.manifests);\n const candidates = new Set<string>();\n for (const object of input.objects) {\n const name = object.name.replace(/^\\/+/, '');\n if (\n !/^objects\\/(?:catalog\|patch)\\/[^/]+\\.json(?:\\.gz)?$/.test(name) \|\|\n referenced.has(name) \|\|\n !object.lastModified\n ) {\n continue;\n }\n const modifiedAt =\n object.lastModified instanceof Date\n ? object.lastModified.getTime()\n : new Date(object.lastModified).getTime();\n if (\n Number.isFinite(modifiedAt) &&\n now - modifiedAt >= input.gracePeriodMs\n ) {\n candidates.add(name);\n }\n }\n return [...candidates].sort();\n}\n\n/\n Create one content-addressed language patch and advance a compatible\n * manifest. Returns null for an idempotent re-approval of the current value.\n /\nexport async function compileTranslationHotfix(input: {\n manifest: TranslationReleaseManifest;\n keyVersionId: string;\n language: string;\n text: string;\n currentMessages: TranslationMessages;\n}): Promise<CompiledTranslationHotfix \| null> {\n const key = keyForVersion(input.manifest, input.keyVersionId);\n if (!key) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not reference key version ${input.keyVersionId}.`\n );\n }\n const lane = input.manifest.languages[input.language];\n if (!lane) {\n throw new Error(\n `Release ${input.manifest.releaseId} does not publish ${input.language}.`\n );\n }\n const current = input.currentMessages[key];\n const next =\n typeof current === 'object' && current?.format === 'icu'\n ? { message: input.text, format: 'icu' as const }\n : input.text;\n if (canonicalJson(current) === canonicalJson(next)) return null;\n\n const patch: TranslationCatalogPatch = { set: { [key]: next } };\n const body = encoder.encode(canonicalJson(patch));\n const hash = await sha256Hex(decoder.decode(body));\n const sequence = input.manifest.hotfixSequence + 1;\n const publicBase = publicBaseFromObjectUrl(lane.base.url);\n const patchObject: TranslationCatalogPatchObject = {\n hash,\n url: objectUrl(publicBase, `objects/patch/${hash}.json`),\n bytes: body.byteLength,\n sequence,\n };\n return {\n key,\n language: input.language,\n sequence,\n patch,\n immutableObject: { kind: 'patch', hash, body },\n manifest: {\n ...input.manifest,\n hotfixSequence: sequence,\n languages: {\n ...input.manifest.languages,\n [input.language]: {\n ...lane,\n patches: [...lane.patches, patchObject],\n },\n },\n },\n };\n}\n\nfunction qualitySummary(findings: CheckFinding[]): TranslationQualitySummary {\n const rules: Record<string, number> = {};\n let errors = 0;\n let warnings = 0;\n for (const finding of findings) {\n finding.severity === 'error' ? errors++ : warnings++;\n rules[finding.rule] = (rules[finding.rule] ?? 0) + 1;\n }\n return { errors, warnings, rules };\n}\n\nfunction objectUrl(publicBase: string \| undefined, path: string): string {\n const base = publicBase?.replace(/\\/+$/, '');\n return base ? `${base}/${path}` : path;\n}\n\n/\n Compile one immutable schema-v2 release. The input entries are the captured\n * graph snapshot; callers are responsible for supplying its revision watermark.\n /\nexport async function compileRelease(\n entries: TranslationEntryRecord[],\n input: CompileReleaseInput\n): Promise<CompiledTranslationRelease> {\n const reviewedOnly = new Set(input.reviewedOnlyLanguages ?? []);\n const selected = entries\n .filter((entry) => entry.kind === 'ui')\n .sort((left, right) => left.key.localeCompare(right.key));\n const missingVersion = selected.find((entry) => !entry.currentVersion?.id);\n if (missingVersion) {\n throw new Error(\n `Translation key \"${missingVersion.key}\" has no current contract version.`\n );\n }\n const keyVersions = Object.fromEntries(\n selected.map((entry) => [entry.key, entry.currentVersion!.id])\n );\n const contractSetHash = await translationContractSetHash(selected);\n const releaseSeed = canonicalJson([\n input.appId,\n input.branchId,\n input.buildId ?? '',\n contractSetHash,\n ]);\n const releaseId =\n input.releaseId?.trim() \|\|\n `release-${(await sha256Hex(releaseSeed)).slice(0, 24)}`;\n const immutableObjects: CompiledTranslationRelease['immutableObjects'] = [];\n const languages: TranslationReleaseManifest['languages'] = {};\n const quality: TranslationReleaseManifest['quality'] = {};\n\n for (const language of [...new Set(input.languages)].sort()) {\n const payload = compileLanguage(selected, language, {\n defaultLanguage: input.defaultLanguage,\n reviewedOnly: reviewedOnly.has(language),\n languageResources: input.languageResources,\n });\n const body = encoder.encode(canonicalJson(payload));\n const hash = await sha256Hex(decoder.decode(body));\n immutableObjects.push({ kind: 'base', hash, body });\n languages[language] = {\n base: {\n hash,\n url: objectUrl(input.publicBase, `objects/catalog/${hash}.json`),\n bytes: body.byteLength,\n },\n patches: [],\n };\n const checkedEntries = selected.map((entry) => {\n const message = payload[entry.key];\n const text =\n typeof message === 'string' ? message : message?.message ?? '';\n return {\n ...entry,\n units: {\n ...entry.units,\n [language]: {\n language,\n text,\n state: entry.units[language]?.state ?? 'untranslated',\n },\n },\n };\n });\n quality[language] = qualitySummary(\n language === input.defaultLanguage\n ? []\n : runChecks(checkedEntries, language, input.glossary ?? [])\n );\n }\n\n const errorCount = Object.values(quality).reduce(\n (total, summary) => total + summary.errors,\n 0\n );\n if (\n input.channel === 'production' &&\n errorCount > 0 &&\n !input.allowQualityErrors\n ) {\n throw new Error(\n `Production translation release blocked by ${errorCount} quality error${\n errorCount === 1 ? '' : 's'\n }.`\n );\n }\n\n const manifest: TranslationReleaseManifest = {\n schemaVersion: 2,\n releaseId,\n contractSetHash,\n hotfixSequence: 0,\n ...(input.revisionWatermark\n ? { revisionWatermark: input.revisionWatermark }\n : {}),\n keyVersions,\n quality,\n languages,\n ...(input.languageResources\n ? { languageResources: input.languageResources }\n : {}),\n };\n const manifestHash = await sha256Hex(canonicalJson(manifest));\n return {\n descriptor: {\n schemaVersion: 2,\n appId: input.appId,\n releaseId,\n contractSetHash,\n manifestUrl: objectUrl(\n input.publicBase,\n `releases/${releaseId}/manifest.json`\n ),\n },\n manifest,\n manifestHash,\n immutableObjects,\n };\n}\n\n/\n Recompile content beneath existing release identities and reuse only an\n * exact manifest match. Contract equality alone is insufficient because\n * selected translations, language policy, quality, or delivery URLs may differ.\n */\nexport async function findReusableCompiledRelease(\n entries: TranslationEntryRecord[],\n input: Omit<CompileReleaseInput, 'releaseId' \| 'buildId'>,\n candidates: TranslationReleaseReuseCandidate[]\n): Promise<CompiledTranslationRelease \| null> {\n for (const candidate of candidates) {\n const compiled = await compileRelease(entries, {\n ...input,\n releaseId: candidate.releaseId,\n });\n if (compiled.manifestHash === candidate.manifestHash) return compiled;\n }\n return null;\n}\n"]}

package/lib/esm/shape-catalog.d.ts CHANGED Viewed

@@ -3,7 +3,7 @@ import type { TranslationDiscoverySource } from './discovery.js';
 /**
  * Code-canonical translations shipped beside one reusable LINKED shape.
  * Packages may expose this object from code or serialize the same contract as
- * JSON for Host Agent discovery without executing package code.
+ * JSON for a host's discovery tooling without executing package code.
  */
 export interface ShapeTranslationCatalog {
     schemaVersion: 1;

package/lib/esm/shape-catalog.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"shape-catalog.js","sourceRoot":"","sources":["../../src/shape-catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n TranslationEntryRecord,\n TranslationState,\n} from './records.js';\nimport type { TranslationDiscoverySource } from './discovery.js';\n\n/*\n Code-canonical translations shipped beside one reusable LINKED shape.\n * Packages may expose this object from code or serialize the same contract as\n * JSON for Host Agent discovery without executing package code.\n /\nexport interface ShapeTranslationCatalog {\n schemaVersion: 1;\n packageName: string;\n /* Canonical SHACL node-shape IRI, not a display label or filesystem path. /\n shapeIri: string;\n /* Optional stable domain-class IRI used for semantic browsing. /\n targetClass?: string;\n entries: ShapeTranslationCatalogEntry[];\n}\n\nexport interface ShapeTranslationCatalogEntry {\n key: string;\n sourceText: string;\n description?: string;\n namespace?: string;\n /* Stable predicate IRI when this message describes a shape property. /\n propertyIri?: string;\n format?: 'simple' \| 'icu';\n /* Curated BCP-47 language values supplied by the package. /\n translations?: Record<\n string,\n string \| { text: string; state?: TranslationState }\n >;\n}\n\nexport interface ShapeTranslationCatalogTarget {\n listEntries(data: { appId: string }): Promise<TranslationEntryRecord[]>;\n upsertKey(data: {\n appId: string;\n key: string;\n sourceText: string;\n namespace?: string;\n description?: string;\n kind: 'ui';\n format?: 'simple' \| 'icu';\n ofShape: string;\n ofProperty?: string;\n fromPackage: string;\n }): Promise<unknown>;\n upsertUnit(data: {\n appId: string;\n key: string;\n language: string;\n text: string;\n state: TranslationState;\n }): Promise<unknown>;\n}\n\nexport interface ShapeTranslationInstallReport {\n createdKeys: string[];\n createdUnits: Array<{ key: string; language: string }>;\n skippedExistingKeys: string[];\n skippedExistingUnits: Array<{ key: string; language: string }>;\n}\n\nfunction requireString(value: unknown, label: string): string {\n if (typeof value !== 'string' \|\| !value.trim()) {\n throw new Error(`${label} is required.`);\n }\n return value.trim();\n}\n\n/* Validate and freeze the package-owned declaration at module load time. /\nexport function defineShapeTranslationCatalog(\n catalog: ShapeTranslationCatalog,\n): Readonly<ShapeTranslationCatalog> {\n if (catalog?.schemaVersion !== 1) {\n throw new Error('Shape translation catalog schemaVersion must be 1.');\n }\n requireString(catalog.packageName, 'packageName');\n requireString(catalog.shapeIri, 'shapeIri');\n if (!Array.isArray(catalog.entries)) {\n throw new Error('Shape translation catalog entries must be an array.');\n }\n const keys = new Set<string>();\n for (const entry of catalog.entries) {\n const key = requireString(entry?.key, 'entry.key');\n requireString(entry?.sourceText, `sourceText for ${key}`);\n if (keys.has(key)) throw new Error(`Duplicate shape translation key \"${key}\".`);\n keys.add(key);\n }\n return Object.freeze(catalog);\n}\n\n/* Adapt the existing schema-v1 catalog without changing its install contract. /\nexport function shapeCatalogTranslationDiscoverySource(\n input: ShapeTranslationCatalog,\n): TranslationDiscoverySource {\n const catalog = defineShapeTranslationCatalog(input);\n return {\n name: `shape-catalog:${catalog.packageName}:${catalog.shapeIri}`,\n async discover() {\n for (const entry of catalog.entries) {\n yield {\n schemaVersion: 1,\n key: entry.key,\n sourceText: entry.sourceText,\n kind: 'ui',\n format: entry.format ?? 'simple',\n ...(entry.namespace ? { namespace: entry.namespace } : {}),\n ...(entry.description ? { description: entry.description } : {}),\n provenance: {\n source: 'package',\n sourceId: `${catalog.packageName}:${catalog.shapeIri}`,\n authoritative: true,\n ownerIri: catalog.shapeIri,\n shapeIri: catalog.shapeIri,\n fromPackage: catalog.packageName,\n ...(catalog.targetClass\n ? { targetClass: catalog.targetClass }\n : {}),\n ...(entry.propertyIri\n ? { propertyIri: entry.propertyIri }\n : {}),\n },\n };\n }\n },\n };\n}\n\n/*\n Seed only missing app values for the currently activated languages.\n * Existing project-authored keys and units always win over package defaults.\n */\nexport async function installShapeTranslationCatalog(\n target: ShapeTranslationCatalogTarget,\n input: {\n appId: string;\n catalog: ShapeTranslationCatalog;\n activeLanguages: Iterable<string>;\n },\n): Promise<ShapeTranslationInstallReport> {\n const appId = requireString(input.appId, 'appId');\n const catalog = defineShapeTranslationCatalog(input.catalog);\n const activeLanguages = new Set(\n [...input.activeLanguages].map((language) => language.trim()).filter(Boolean),\n );\n const existing = new Map(\n (await target.listEntries({ appId })).map((entry) => [entry.key, entry]),\n );\n const report: ShapeTranslationInstallReport = {\n createdKeys: [],\n createdUnits: [],\n skippedExistingKeys: [],\n skippedExistingUnits: [],\n };\n\n for (const entry of catalog.entries) {\n const current = existing.get(entry.key);\n if (current) report.skippedExistingKeys.push(entry.key);\n else {\n await target.upsertKey({\n appId,\n key: entry.key,\n sourceText: entry.sourceText,\n namespace: entry.namespace,\n description: entry.description,\n kind: 'ui',\n format: entry.format,\n ofShape: catalog.shapeIri,\n ofProperty: entry.propertyIri,\n fromPackage: catalog.packageName,\n });\n report.createdKeys.push(entry.key);\n }\n\n for (const language of [...activeLanguages].sort()) {\n const value = entry.translations?.[language];\n if (value === undefined) continue;\n if (current?.units[language]) {\n report.skippedExistingUnits.push({ key: entry.key, language });\n continue;\n }\n const unit = typeof value === 'string' ? { text: value } : value;\n await target.upsertUnit({\n appId,\n key: entry.key,\n language,\n text: unit.text,\n state: unit.state ?? 'reviewed',\n });\n report.createdUnits.push({ key: entry.key, language });\n }\n }\n return report;\n}\n"]}
1	+ {"version":3,"file":"shape-catalog.js","sourceRoot":"","sources":["../../src/shape-catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n TranslationEntryRecord,\n TranslationState,\n} from './records.js';\nimport type { TranslationDiscoverySource } from './discovery.js';\n\n/*\n Code-canonical translations shipped beside one reusable LINKED shape.\n * Packages may expose this object from code or serialize the same contract as\n * JSON for a host's discovery tooling without executing package code.\n /\nexport interface ShapeTranslationCatalog {\n schemaVersion: 1;\n packageName: string;\n /* Canonical SHACL node-shape IRI, not a display label or filesystem path. /\n shapeIri: string;\n /* Optional stable domain-class IRI used for semantic browsing. /\n targetClass?: string;\n entries: ShapeTranslationCatalogEntry[];\n}\n\nexport interface ShapeTranslationCatalogEntry {\n key: string;\n sourceText: string;\n description?: string;\n namespace?: string;\n /* Stable predicate IRI when this message describes a shape property. /\n propertyIri?: string;\n format?: 'simple' \| 'icu';\n /* Curated BCP-47 language values supplied by the package. /\n translations?: Record<\n string,\n string \| { text: string; state?: TranslationState }\n >;\n}\n\nexport interface ShapeTranslationCatalogTarget {\n listEntries(data: { appId: string }): Promise<TranslationEntryRecord[]>;\n upsertKey(data: {\n appId: string;\n key: string;\n sourceText: string;\n namespace?: string;\n description?: string;\n kind: 'ui';\n format?: 'simple' \| 'icu';\n ofShape: string;\n ofProperty?: string;\n fromPackage: string;\n }): Promise<unknown>;\n upsertUnit(data: {\n appId: string;\n key: string;\n language: string;\n text: string;\n state: TranslationState;\n }): Promise<unknown>;\n}\n\nexport interface ShapeTranslationInstallReport {\n createdKeys: string[];\n createdUnits: Array<{ key: string; language: string }>;\n skippedExistingKeys: string[];\n skippedExistingUnits: Array<{ key: string; language: string }>;\n}\n\nfunction requireString(value: unknown, label: string): string {\n if (typeof value !== 'string' \|\| !value.trim()) {\n throw new Error(`${label} is required.`);\n }\n return value.trim();\n}\n\n/* Validate and freeze the package-owned declaration at module load time. /\nexport function defineShapeTranslationCatalog(\n catalog: ShapeTranslationCatalog,\n): Readonly<ShapeTranslationCatalog> {\n if (catalog?.schemaVersion !== 1) {\n throw new Error('Shape translation catalog schemaVersion must be 1.');\n }\n requireString(catalog.packageName, 'packageName');\n requireString(catalog.shapeIri, 'shapeIri');\n if (!Array.isArray(catalog.entries)) {\n throw new Error('Shape translation catalog entries must be an array.');\n }\n const keys = new Set<string>();\n for (const entry of catalog.entries) {\n const key = requireString(entry?.key, 'entry.key');\n requireString(entry?.sourceText, `sourceText for ${key}`);\n if (keys.has(key)) throw new Error(`Duplicate shape translation key \"${key}\".`);\n keys.add(key);\n }\n return Object.freeze(catalog);\n}\n\n/* Adapt the existing schema-v1 catalog without changing its install contract. /\nexport function shapeCatalogTranslationDiscoverySource(\n input: ShapeTranslationCatalog,\n): TranslationDiscoverySource {\n const catalog = defineShapeTranslationCatalog(input);\n return {\n name: `shape-catalog:${catalog.packageName}:${catalog.shapeIri}`,\n async discover() {\n for (const entry of catalog.entries) {\n yield {\n schemaVersion: 1,\n key: entry.key,\n sourceText: entry.sourceText,\n kind: 'ui',\n format: entry.format ?? 'simple',\n ...(entry.namespace ? { namespace: entry.namespace } : {}),\n ...(entry.description ? { description: entry.description } : {}),\n provenance: {\n source: 'package',\n sourceId: `${catalog.packageName}:${catalog.shapeIri}`,\n authoritative: true,\n ownerIri: catalog.shapeIri,\n shapeIri: catalog.shapeIri,\n fromPackage: catalog.packageName,\n ...(catalog.targetClass\n ? { targetClass: catalog.targetClass }\n : {}),\n ...(entry.propertyIri\n ? { propertyIri: entry.propertyIri }\n : {}),\n },\n };\n }\n },\n };\n}\n\n/*\n Seed only missing app values for the currently activated languages.\n * Existing project-authored keys and units always win over package defaults.\n */\nexport async function installShapeTranslationCatalog(\n target: ShapeTranslationCatalogTarget,\n input: {\n appId: string;\n catalog: ShapeTranslationCatalog;\n activeLanguages: Iterable<string>;\n },\n): Promise<ShapeTranslationInstallReport> {\n const appId = requireString(input.appId, 'appId');\n const catalog = defineShapeTranslationCatalog(input.catalog);\n const activeLanguages = new Set(\n [...input.activeLanguages].map((language) => language.trim()).filter(Boolean),\n );\n const existing = new Map(\n (await target.listEntries({ appId })).map((entry) => [entry.key, entry]),\n );\n const report: ShapeTranslationInstallReport = {\n createdKeys: [],\n createdUnits: [],\n skippedExistingKeys: [],\n skippedExistingUnits: [],\n };\n\n for (const entry of catalog.entries) {\n const current = existing.get(entry.key);\n if (current) report.skippedExistingKeys.push(entry.key);\n else {\n await target.upsertKey({\n appId,\n key: entry.key,\n sourceText: entry.sourceText,\n namespace: entry.namespace,\n description: entry.description,\n kind: 'ui',\n format: entry.format,\n ofShape: catalog.shapeIri,\n ofProperty: entry.propertyIri,\n fromPackage: catalog.packageName,\n });\n report.createdKeys.push(entry.key);\n }\n\n for (const language of [...activeLanguages].sort()) {\n const value = entry.translations?.[language];\n if (value === undefined) continue;\n if (current?.units[language]) {\n report.skippedExistingUnits.push({ key: entry.key, language });\n continue;\n }\n const unit = typeof value === 'string' ? { text: value } : value;\n await target.upsertUnit({\n appId,\n key: entry.key,\n language,\n text: unit.text,\n state: unit.state ?? 'reviewed',\n });\n report.createdUnits.push({ key: entry.key, language });\n }\n }\n return report;\n}\n"]}

package/lib/esm/shapes/TranslationKey.d.ts CHANGED Viewed

@@ -31,19 +31,23 @@ export declare class TranslationKey extends Shape {
     get ofShape(): string;
     /** Stable predicate IRI when this key describes one shape property. */
     get ofProperty(): string;
+    /** Arbitrary declared semantic resource, such as an action or condition. */
+    get ofResource(): string;
     /** Reusable package that supplied the seed value. */
     get fromPackage(): string;
     /**
-     * True when this app copy of a shape-owned key has been edited locally and
-     * should NOT be overwritten by shape-route propagation (AD-N: "never
+     * True when this app copy of a declaration-owned key has been edited locally
+     * (shape, property or named package resource, including help) and should NOT
+     * be overwritten by declaration refresh or shape-route propagation (AD-N: "never
      * overwrites an app's own override"). Set when the per-app editor changes the
-     * source of a key that carries `ofShape`.
+     * source of a key with declared ownership.
      */
     get overridden(): boolean;
     /**
-     * The shape's canonical source captured the moment this app first overrode the
+     * The declaration's canonical source captured when this app first overrode the
      * key — what "clear override" reverts to when no non-overridden sibling copy is
-     * available to read the current canonical from (AD-N).
+     * available to read the current canonical from (AD-N). The historic predicate
+     * name stays compatible; resource-owned help does not invent a second carrier.
      */
     get shapeSource(): string;
     /** Message syntax: 'simple' (FormatSimple) | 'icu'. */
@@ -72,6 +76,7 @@ export declare class TranslationKey extends Shape {
         ofField?: string;
         ofShape?: string;
         ofProperty?: string;
+        ofResource?: string;
         fromPackage?: string;
         format?: 'simple' | 'icu';
     }): Promise<{

package/lib/esm/shapes/TranslationKey.js CHANGED Viewed

@@ -60,23 +60,29 @@ let TranslationKey = class TranslationKey extends Shape {
     get ofProperty() {
         return '';
     }
+    /** Arbitrary declared semantic resource, such as an action or condition. */
+    get ofResource() {
+        return '';
+    }
     /** Reusable package that supplied the seed value. */
     get fromPackage() {
         return '';
     }
     /**
-     * True when this app copy of a shape-owned key has been edited locally and
-     * should NOT be overwritten by shape-route propagation (AD-N: "never
+     * True when this app copy of a declaration-owned key has been edited locally
+     * (shape, property or named package resource, including help) and should NOT
+     * be overwritten by declaration refresh or shape-route propagation (AD-N: "never
      * overwrites an app's own override"). Set when the per-app editor changes the
-     * source of a key that carries `ofShape`.
+     * source of a key with declared ownership.
      */
     get overridden() {
         return false;
     }
     /**
-     * The shape's canonical source captured the moment this app first overrode the
+     * The declaration's canonical source captured when this app first overrode the
      * key — what "clear override" reverts to when no non-overridden sibling copy is
-     * available to read the current canonical from (AD-N).
+     * available to read the current canonical from (AD-N). The historic predicate
+     * name stays compatible; resource-owned help does not invent a second carrier.
      */
     get shapeSource() {
         return '';
@@ -162,6 +168,11 @@ __decorate([
     __metadata("design:type", String),
     __metadata("design:paramtypes", [])
 ], TranslationKey.prototype, "ofProperty", null);
+__decorate([
+    objectProperty({ path: tr.ofResource, maxCount: 1 }),
+    __metadata("design:type", String),
+    __metadata("design:paramtypes", [])
+], TranslationKey.prototype, "ofResource", null);
 __decorate([
     literalProperty({ path: tr.fromPackage, maxCount: 1 }),
     __metadata("design:type", String),

package/lib/esm/shapes/TranslationKey.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"TranslationKey.js","sourceRoot":"","sources":["../../../src/shapes/TranslationKey.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C;;;;;;;GAOG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,KAAK;IAGvC,iDAAiD;IACjD,IACI,SAAS;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0CAA0C;IAC1C,IACI,GAAG;QACL,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,uCAAuC;IACvC,IACI,UAAU;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IACI,WAAW;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sDAAsD;IACtD,IACI,IAAI;QACN,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,IACI,aAAa;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mEAAmE;IACnE,IACI,MAAM;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,iEAAiE;IACjE,IACI,OAAO;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0DAA0D;IAC1D,IACI,OAAO;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,uEAAuE;IACvE,IACI,UAAU;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,qDAAqD;IACrD,IACI,WAAW;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED~~;;;;;OAKG~~;IACH,IACI,UAAU;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED~~;;;;OAIG~~;IACH,IACI,WAAW;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,uDAAuD;IACvD,IACI,MAAM;QACR,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mFAAmF;IACnF,IACI,cAAc;QAChB,OAAO,SAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAuB;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,WAAW,CAAC,IAAuB;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAE3C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAqC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAE/C,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,+DAA+D;IAC/D,MAAM,CAAC,SAAS,CAAC,~~IAahB~~;QACC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,IAOjB;QACC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAyC;QAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAiC,CAAC;IAChF,CAAC;;~~AArJM~~,0BAAW,GAAG,EAAE,CAAC,cAAc,AAApB,CAAqB;AAGvC;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;+CAGpD;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;yCAG9C;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;gDAGrD;AAED;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;iDAGtD;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;0CAG/C;AAGD;IAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;mDAGvD;AAGD;IAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;4CAGhD;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;6CAGlD;AAGD;IAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;6CAGjD;AAGD;IAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;gDAGpD;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;iDAGtD;~~AAQD~~;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;gDAGrD;~~AAOD~~;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;iDAGtD;AAGD;IAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;4CAGjD;AAGD;IAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;;;oDAGxD;~~AAnGU~~,cAAc;IAD1B,WAAW;GACC,cAAc,~~CAuJ1B~~","sourcesContent":["import { Shape } from '@_linked/core/shapes/Shape';\nimport { literalProperty, objectProperty } from '@_linked/core/shapes/SHACL';\nimport { Server } from '@_linked/server-utils/utils/Server';\nimport { tr } from '../ontologies/translation.js';\nimport { linkedShape } from '../package.js';\nimport type {\n TranslationEntryRecord,\n TranslationKeyVersionRecord,\n TranslationState,\n} from '../records.js';\nimport type { TranslationMessages } from '../core/messages.js';\nimport type { TranslationKeyVersion } from './TranslationKeyVersion.js';\n\n/*\n A translatable key (Plan 014 AD-H). Covers both UI-string keys (`kind:'ui'`)\n * and graph-content translations (`kind:'content'` + `ofNode`/`ofField`), unified\n * in one scheme. `sourceText` is the canonical English (R7); `format` pins the\n * message syntax so imported FormatSimple strings aren't reinterpreted as ICU\n * (R8). Named `TranslationKey` (its per-language values are {@link TranslationUnit}s,\n * not `Translation` — avoids collision with serve's legacy shape, R13).\n /\n@linkedShape\nexport class TranslationKey extends Shape {\n static targetClass = tr.TranslationKey;\n\n /* Dotted namespace grouping, e.g. \"account\". /\n @literalProperty({ path: tr.namespace, maxCount: 1 })\n get namespace(): string {\n return '';\n }\n\n /* The key path, e.g. \"account.title\". /\n @literalProperty({ path: tr.key, maxCount: 1 })\n get key(): string {\n return '';\n }\n\n /* Canonical English source string. /\n @literalProperty({ path: tr.sourceText, maxCount: 1 })\n get sourceText(): string {\n return '';\n }\n\n @literalProperty({ path: tr.description, maxCount: 1 })\n get description(): string {\n return '';\n }\n\n /* 'ui' (chrome string) \| 'content' (graph field). /\n @literalProperty({ path: tr.kind, maxCount: 1 })\n get kind(): string {\n return 'ui';\n }\n\n /* IRI of the owning Application (translation content is app-scoped, AD-I). /\n @objectProperty({ path: tr.ofApplication, maxCount: 1 })\n get ofApplication(): string {\n return '';\n }\n\n /* For kind:'content' — the IRI of the translated subject node. /\n @objectProperty({ path: tr.ofNode, maxCount: 1 })\n get ofNode(): string {\n return '';\n }\n\n /* For kind:'content' — the field/predicate being translated. /\n @literalProperty({ path: tr.ofField, maxCount: 1 })\n get ofField(): string {\n return '';\n }\n\n /* SHACL node-shape IRI this packaged key accompanies. /\n @objectProperty({ path: tr.ofShape, maxCount: 1 })\n get ofShape(): string {\n return '';\n }\n\n /* Stable predicate IRI when this key describes one shape property. /\n @objectProperty({ path: tr.ofProperty, maxCount: 1 })\n get ofProperty(): string {\n return '';\n }\n\n /* Reusable package that supplied the seed value. /\n @literalProperty({ path: tr.fromPackage, maxCount: 1 })\n get fromPackage(): string {\n return '';\n }\n\n /\n True when this app copy of a ~~shape~~-owned key has been edited locally ~~and~~\n * should NOT be overwritten by shape-route propagation (AD-N: \"never\n * overwrites an app's own override\"). Set when the per-app editor changes the\n * source of a key ~~that~~ ~~carries~~ ~~`ofShape`.\~~n /\n @literalProperty({ path: tr.overridden, maxCount: 1 })\n get overridden(): boolean {\n return false;\n }\n\n /\n The ~~shape~~'s canonical source captured ~~the~~ ~~moment~~ this app first overrode the\n * key — what \"clear override\" reverts to when no non-overridden sibling copy is\n * available to read the current canonical from (AD-N).\n /\n @literalProperty({ path: tr.shapeSource, maxCount: 1 })\n get shapeSource(): string {\n return '';\n }\n\n /* Message syntax: 'simple' (FormatSimple) \| 'icu'. /\n @literalProperty({ path: tr.format, maxCount: 1 })\n get format(): string {\n return 'simple';\n }\n\n /* Current immutable source/argument contract. Populated by Plan 018 migration. /\n @objectProperty({ path: tr.currentVersion, maxCount: 1 })\n get currentVersion(): TranslationKeyVersion {\n return undefined as any;\n }\n\n static list(data: { appId: string }) {\n return Server.call(this, 'listKeys', data);\n }\n\n /* Plain app-scoped records for authoring UIs; no live Shape crosses RPC. */\n static listEntries(data: { appId: string }) {\n return Server.call(this, 'listEntries', data) as Promise<\n TranslationEntryRecord[]\n >;\n }\n\n static listVersions(data: { appId: string; key?: string }) {\n return Server.call(this, 'listKeyVersions', data) as Promise<\n TranslationKeyVersionRecord[]\n >;\n }\n\n // Shape.upsert is the framework's typed graph-update builder. Keep the\n // app-scoped translation RPC separate from that inherited API.\n static upsertKey(data: {\n appId: string;\n key: string;\n sourceText: string;\n namespace?: string;\n description?: string;\n kind?: 'ui' \| 'content';\n ofNode?: string;\n ofField?: string;\n ofShape?: string;\n ofProperty?: string;\n fromPackage?: string;\n format?: 'simple' \| 'icu';\n }): Promise<{ id: string }> {\n return Server.call(this, 'upsertKey', data);\n }\n\n static upsertUnit(data: {\n appId: string;\n key: string;\n language: string;\n text: string;\n state?: TranslationState;\n updatedBy?: string;\n }) {\n return Server.call(this, 'upsertUnit', data);\n }\n\n static getMessages(data: { appId: string; language: string }) {\n return Server.call(this, 'getMessages', data) as Promise<TranslationMessages>;\n }\n}\n"]}
1	+ {"version":3,"file":"TranslationKey.js","sourceRoot":"","sources":["../../../src/shapes/TranslationKey.ts"],"names":[],"mappings":"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","sourcesContent":["import { Shape } from '@_linked/core/shapes/Shape';\nimport { literalProperty, objectProperty } from '@_linked/core/shapes/SHACL';\nimport { Server } from '@_linked/server-utils/utils/Server';\nimport { tr } from '../ontologies/translation.js';\nimport { linkedShape } from '../package.js';\nimport type {\n TranslationEntryRecord,\n TranslationKeyVersionRecord,\n TranslationState,\n} from '../records.js';\nimport type { TranslationMessages } from '../core/messages.js';\nimport type { TranslationKeyVersion } from './TranslationKeyVersion.js';\n\n/*\n A translatable key (Plan 014 AD-H). Covers both UI-string keys (`kind:'ui'`)\n * and graph-content translations (`kind:'content'` + `ofNode`/`ofField`), unified\n * in one scheme. `sourceText` is the canonical English (R7); `format` pins the\n * message syntax so imported FormatSimple strings aren't reinterpreted as ICU\n * (R8). Named `TranslationKey` (its per-language values are {@link TranslationUnit}s,\n * not `Translation` — avoids collision with serve's legacy shape, R13).\n /\n@linkedShape\nexport class TranslationKey extends Shape {\n static targetClass = tr.TranslationKey;\n\n /* Dotted namespace grouping, e.g. \"account\". /\n @literalProperty({ path: tr.namespace, maxCount: 1 })\n get namespace(): string {\n return '';\n }\n\n /* The key path, e.g. \"account.title\". /\n @literalProperty({ path: tr.key, maxCount: 1 })\n get key(): string {\n return '';\n }\n\n /* Canonical English source string. /\n @literalProperty({ path: tr.sourceText, maxCount: 1 })\n get sourceText(): string {\n return '';\n }\n\n @literalProperty({ path: tr.description, maxCount: 1 })\n get description(): string {\n return '';\n }\n\n /* 'ui' (chrome string) \| 'content' (graph field). /\n @literalProperty({ path: tr.kind, maxCount: 1 })\n get kind(): string {\n return 'ui';\n }\n\n /* IRI of the owning Application (translation content is app-scoped, AD-I). /\n @objectProperty({ path: tr.ofApplication, maxCount: 1 })\n get ofApplication(): string {\n return '';\n }\n\n /* For kind:'content' — the IRI of the translated subject node. /\n @objectProperty({ path: tr.ofNode, maxCount: 1 })\n get ofNode(): string {\n return '';\n }\n\n /* For kind:'content' — the field/predicate being translated. /\n @literalProperty({ path: tr.ofField, maxCount: 1 })\n get ofField(): string {\n return '';\n }\n\n /* SHACL node-shape IRI this packaged key accompanies. /\n @objectProperty({ path: tr.ofShape, maxCount: 1 })\n get ofShape(): string {\n return '';\n }\n\n /* Stable predicate IRI when this key describes one shape property. /\n @objectProperty({ path: tr.ofProperty, maxCount: 1 })\n get ofProperty(): string {\n return '';\n }\n\n /* Arbitrary declared semantic resource, such as an action or condition. /\n @objectProperty({ path: tr.ofResource, maxCount: 1 })\n get ofResource(): string {\n return '';\n }\n\n /* Reusable package that supplied the seed value. /\n @literalProperty({ path: tr.fromPackage, maxCount: 1 })\n get fromPackage(): string {\n return '';\n }\n\n /\n True when this app copy of a declaration-owned key has been edited locally\n * (shape, property or named package resource, including help) and should NOT\n * be overwritten by declaration refresh or shape-route propagation (AD-N: \"never\n * overwrites an app's own override\"). Set when the per-app editor changes the\n * source of a key with declared ownership.\n /\n @literalProperty({ path: tr.overridden, maxCount: 1 })\n get overridden(): boolean {\n return false;\n }\n\n /\n The declaration's canonical source captured when this app first overrode the\n * key — what \"clear override\" reverts to when no non-overridden sibling copy is\n * available to read the current canonical from (AD-N). The historic predicate\n * name stays compatible; resource-owned help does not invent a second carrier.\n /\n @literalProperty({ path: tr.shapeSource, maxCount: 1 })\n get shapeSource(): string {\n return '';\n }\n\n /* Message syntax: 'simple' (FormatSimple) \| 'icu'. /\n @literalProperty({ path: tr.format, maxCount: 1 })\n get format(): string {\n return 'simple';\n }\n\n /* Current immutable source/argument contract. Populated by Plan 018 migration. /\n @objectProperty({ path: tr.currentVersion, maxCount: 1 })\n get currentVersion(): TranslationKeyVersion {\n return undefined as any;\n }\n\n static list(data: { appId: string }) {\n return Server.call(this, 'listKeys', data);\n }\n\n /* Plain app-scoped records for authoring UIs; no live Shape crosses RPC. */\n static listEntries(data: { appId: string }) {\n return Server.call(this, 'listEntries', data) as Promise<\n TranslationEntryRecord[]\n >;\n }\n\n static listVersions(data: { appId: string; key?: string }) {\n return Server.call(this, 'listKeyVersions', data) as Promise<\n TranslationKeyVersionRecord[]\n >;\n }\n\n // Shape.upsert is the framework's typed graph-update builder. Keep the\n // app-scoped translation RPC separate from that inherited API.\n static upsertKey(data: {\n appId: string;\n key: string;\n sourceText: string;\n namespace?: string;\n description?: string;\n kind?: 'ui' \| 'content';\n ofNode?: string;\n ofField?: string;\n ofShape?: string;\n ofProperty?: string;\n ofResource?: string;\n fromPackage?: string;\n format?: 'simple' \| 'icu';\n }): Promise<{ id: string }> {\n return Server.call(this, 'upsertKey', data);\n }\n\n static upsertUnit(data: {\n appId: string;\n key: string;\n language: string;\n text: string;\n state?: TranslationState;\n updatedBy?: string;\n }) {\n return Server.call(this, 'upsertUnit', data);\n }\n\n static getMessages(data: { appId: string; language: string }) {\n return Server.call(this, 'getMessages', data) as Promise<TranslationMessages>;\n }\n}\n"]}

package/lib/esm/shapes/TranslationProvider.d.ts CHANGED Viewed

@@ -13,12 +13,31 @@ export interface TranslationKeyInput {
     ofField?: string;
     ofShape?: string;
     ofProperty?: string;
+    ofResource?: string;
     fromPackage?: string;
     /** Force the override flag; when omitted it is derived (see upsertTranslationKey). */
     overridden?: boolean;
     format?: 'simple' | 'icu';
     sourceLanguage?: string;
 }
+/** Trusted caller context, not a client payload flag. Package discovery and
+ * explicit app authoring have different ownership semantics. */
+export interface TranslationKeyWriteContext {
+    createdBy?: string;
+    /**
+     * `'declaration-sync'` is a refresh from code/package declarations: it never
+     * marks a key overridden, and it leaves an existing app override untouched
+     * (answering `preservedOverride: true`). Anything else is an app edit.
+     */
+    source?: 'app-edit' | 'declaration-sync';
+}
+export interface TranslationKeyWriteResult {
+    id: string;
+    versionId: string;
+    versionCreated: boolean;
+    /** Present when a declaration refresh kept the app's override and wrote nothing. */
+    preservedOverride?: true;
+}
 export interface TranslationUnitInput {
     appId: string;
     key: string;
@@ -118,6 +137,8 @@ export declare function listTranslationKeys(data: {
     ofShape: string;
 } & {
     ofProperty: string;
+} & {
+    ofResource: string;
 } & {
     fromPackage: string;
 } & {
@@ -181,13 +202,7 @@ export declare function decideTranslationProposal(data: {
  * Idempotent key write shared by the RPC provider and managed key-sync flows.
  * Source drift marks every existing language unit stale before returning.
  */
-export declare function upsertTranslationKey(data: TranslationKeyInput, authorship?: {
-    createdBy?: string;
-}): Promise<{
-    id: string;
-    versionId: string;
-    versionCreated: boolean;
-}>;
+export declare function upsertTranslationKey(data: TranslationKeyInput, authorship?: TranslationKeyWriteContext): Promise<TranslationKeyWriteResult>;
 /**
  * Append one revision WITHOUT touching the unit (Plan 017 AD-P) — the write
  * path for MT SUGGESTIONS (Slice B) and translator PROPOSALS (Slice C): a
@@ -259,7 +274,7 @@ export declare class TranslationProvider extends ShapeProvider {
     shape: typeof TranslationKey;
     /**
      * Authoring gate. Reads `linkedAuth` off the request the LINKED server already
-     * populates, so this stays portable (no Create Now import, AD-G).
+     * populates, so this stays portable (no host-application import, AD-G).
      *
      * Every method except `getMessages` resolves the caller once, synchronously,
      * before its first `await`, and uses that value for both the permission check
@@ -298,6 +313,8 @@ export declare class TranslationProvider extends ShapeProvider {
         ofShape: string;
     } & {
         ofProperty: string;
+    } & {
+        ofResource: string;
     } & {
         fromPackage: string;
     } & {