@mengine/medeo-client 2.0.1-alpha.14 → 2.0.1-alpha.15

package/dist/{document-BHHbS_17.js → document-CAZ_A9R8.js}

@@ -1462,8 +1462,9 @@ function emptyLaneTracks() {
 * `Voice` declares no `Sequence` — it is a timbre identity, not playable
 * content; a rendered voiceover is an `audio` entity.
 *
-* No declaration says anything about resources: whether an entity has one, and
-* which, is the `from-asset` Relation's answer alone.
+* `Asset` says only that an entity of that kind may be bound to stored bytes,
+* and asks nothing of its payload. Which bytes, and which way the content
+* flowed, is the `from-asset` / `to-asset` Relation's answer alone.
 */
 const ENTITY_KINDS = Object.freeze({
 	axvideo: Object.freeze([
@@ -1480,27 +1481,27 @@ const ENTITY_KINDS = Object.freeze({
 		"Sequence",
 		"Visual",
 		"Audible",
-		"FromAsset"
+		"Asset"
 	]),
 	audio: Object.freeze([
 		"Sequence",
 		"Audible",
-		"FromAsset"
+		"Asset"
 	]),
 	image: Object.freeze([
 		"Sequence",
 		"Visual",
-		"FromAsset"
+		"Asset"
 	]),
 	voice: Object.freeze(["Container", "IPBound"]),
 	"sequence-marker": Object.freeze([]),
 	viewport: Object.freeze([]),
-	"audio-script": Object.freeze(["SegmentText", "FromAsset"]),
-	"phonetic-script": Object.freeze(["SegmentText"]),
+	"audio-script": Object.freeze(["SegmentText", "Asset"]),
+	"phonetic-script": Object.freeze(["SegmentText", "Asset"]),
 	caption: Object.freeze([
 		"SegmentText",
 		"Sequence",
-		"FromAsset"
+		"Asset"
 	])
 });
 /** What a known kind declares; extension kinds declare nothing through this table. */
@@ -1798,15 +1799,6 @@ function entityToRow(entity) {
 //#endregion
 //#region ../medeo-dsl/src/invariants.ts
 /** An entity is made from at most one Asset; two would leave its bytes ambiguous. */
-function validateAssetSource(entity, index) {
-	if (entity.current().entityKind === "asset") return [];
-	if ([...index.relationsOf(entity)].filter((relation) => relation.kind === "from-asset").length <= 1) return [];
-	return [{
-		code: "asset_source_cardinality",
-		entityId: entity.entityId,
-		message: `Entity "${entity.entityId}" is made from more than one Asset`
-	}];
-}
 /** Validates one complete set of entities and its authoritative Relation rows. */
 function validateEntityRelationSet(entityRefs, index, options) {
 	const { entities, issues } = collectRelatedEntities(entityRefs, index);
@@ -1828,7 +1820,6 @@ function validateEntityRelationSet(entityRefs, index, options) {
 		const current = entity.current();
 		const entityIssues = validateEntity(entity, entityIds);
 		issues.push(...entityIssues);
-		issues.push(...validateAssetSource(entity, index));
 		if (entityIssues.some((issue) => issue.code === "invalid_entity_payload")) continue;
 		if (current.entityKind === "sequence-marker") {
 			const marker = entity;
@@ -2472,10 +2463,10 @@ const markerContentRelationSpec = Object.freeze({
 /**
 * `from-asset(entity, asset)` — the entity was made from that stored resource.
 *
-* Eligibility is declared: the non-Asset endpoint must carry the `FromAsset`
-* kind, which says an entity of that kind can be made from stored bytes and
-* asks nothing of its payload. The bytes stay named in exactly one place, so
-* no entity copies the locator into its own row and one Asset can back several
+* Eligibility is declared: the non-Asset endpoint must carry the `Asset` kind,
+* which says an entity of that kind can be bound to stored bytes and asks
+* nothing of its payload. The bytes stay named in exactly one place, so no
+* entity copies the locator into its own row and one Asset can back several
 * entities.
 */
 const fromAssetRelationSpec = Object.freeze({
@@ -2483,6 +2474,26 @@ const fromAssetRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => hasExactlyOneAsset(endpoints),
 	validateMetadata: isAssetBinding
 });
+/**
+* `to-asset(entity, asset)` — the entity's content was written out to that
+* stored resource.
+*
+* The mirror of `from-asset`, and deliberately a separate relation kind rather
+* than a second declared kind: eligibility is the same either way, but which
+* way the content flowed is what says whether an entity may still be edited.
+* An entity reached by `from-asset` was produced from bytes it does not own,
+* so changing it would contradict them. An entity with a `to-asset` owns its
+* content and the resource is a snapshot of it, which is what goes stale and
+* gets written again. A transcript that is later edited carries both at once,
+* and only the distinct relation kinds keep them apart.
+*
+* Writing a snapshot is host assembly; nothing a script authors creates one.
+*/
+const toAssetRelationSpec = Object.freeze({
+	kind: "to-asset",
+	validateEndpoints: (endpoints) => hasExactlyOneAsset(endpoints),
+	validateMetadata: isAssetBinding
+});
 /** `generated(output, input)` means endpoint 0 was generated from endpoint 1. */
 const generatedRelationSpec = Object.freeze({
 	kind: "generated",
@@ -2545,6 +2556,7 @@ const builtInRelationSpecs = Object.freeze([
 	axVideoMarkerRelationSpec,
 	markerTimelineRelationSpec,
 	fromAssetRelationSpec,
+	toAssetRelationSpec,
 	generatedRelationSpec,
 	captionAlignmentRelationSpec,
 	clipAnchorRelationSpec,
@@ -2573,12 +2585,12 @@ function hasMarkerAndSequence(endpoints) {
 	const second = endpoints[1].current();
 	return first.entityKind === "sequence-marker" && hasSequence(second) || second.entityKind === "sequence-marker" && hasSequence(first);
 }
-/** Exactly one end is the Asset, so the other end is unambiguously the maker. */
+/** Exactly one end is the Asset, so the other end is unambiguously the bound entity. */
 function hasExactlyOneAsset(endpoints) {
 	const kinds = endpoints.map((endpoint) => endpoint.current().entityKind);
 	const assets = kinds.map((kind) => kind === "asset");
 	if (assets[0] === assets[1]) return false;
-	return declaresKind(assets[0] ? kinds[1] : kinds[0], "FromAsset");
+	return declaresKind(assets[0] ? kinds[1] : kinds[0], "Asset");
 }
 function isGeneratedMedia(entity) {
 	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio";
@@ -3608,12 +3620,23 @@ function audioScriptAssetHash(payload) {
 	return bytesToHex(sha256(new TextEncoder().encode(canonicalJson(audioScriptAssetContent(payload)))));
 }
 /**
-* The Asset a script was written out to, read from the graph rather than the
-* script's own row: like every other entity, a script names its bytes through
-* a `from-asset` Relation and stores no locator itself.
+* The Asset a script was written out to. It is a snapshot the script owns, so
+* it is reached by `to-asset` — not `from-asset`, which would say the script
+* was produced from bytes it cannot change.
 */
 function audioScriptAssetOf(rows, entityId) {
-	const link = rows.relations.find((relation) => relation.relationKind === "from-asset" && (String(relation.endpoint0EntityId) === entityId || String(relation.endpoint1EntityId) === entityId));
+	return boundAsset(rows, entityId, "to-asset");
+}
+/**
+* The Asset a script was made from — a transcript it does not own. A script
+* that has one never writes a snapshot of its own: the bytes it would describe
+* are already named, and rewriting them would contradict their source.
+*/
+function scriptSourceAssetOf(rows, entityId) {
+	return boundAsset(rows, entityId, "from-asset");
+}
+function boundAsset(rows, entityId, relationKind) {
+	const link = rows.relations.find((relation) => relation.relationKind === relationKind && (String(relation.endpoint0EntityId) === entityId || String(relation.endpoint1EntityId) === entityId));
 	if (link === void 0) return void 0;
 	const otherId = String(link.endpoint0EntityId) === entityId ? link.endpoint1EntityId : link.endpoint0EntityId;
 	return rows.entities.find((row) => String(row.entityId) === String(otherId) && row.entityKind === "asset");
@@ -3622,6 +3645,33 @@ function audioScriptAssetOf(rows, entityId) {
 function audioScriptAssetFields(payload) {
 	return { assetContentHash: audioScriptAssetHash(payload) };
 }
+/**
+* What a PhoneticScript hands to synthesis: the base AudioScript's text as the
+* variant pronounces it, plus the variant's own phoneme and prosody control.
+*
+* The variant's content is written by a model — deciding how words are said is
+* text work, not a mechanical copy — but the bytes a synthesizer reads have to
+* leave the entity graph to reach it, because synthesis does not handle
+* entities. Writing this resource down is that crossing, and it is why speech
+* can only come from a PhoneticScript.
+*/
+function phoneticScriptAssetContent(rows, entityId) {
+	const assembled = assemblePhoneticScriptContent(rows, createEntityId(entityId));
+	const own = assembled.phoneticScript.payload;
+	return {
+		text: assembled.text,
+		segments: structuredClone(assembled.segments),
+		...typeof own.phonemeScript === "string" ? { phonemeScript: own.phonemeScript } : {},
+		...isJsonObject(own.prosody) ? { prosody: structuredClone(own.prosody) } : {}
+	};
+}
+function phoneticScriptAssetHash(rows, entityId) {
+	return bytesToHex(sha256(new TextEncoder().encode(canonicalJson(phoneticScriptAssetContent(rows, entityId)))));
+}
+/** The Asset a PhoneticScript was written out to, read from the graph. */
+function phoneticScriptAssetOf(rows, entityId) {
+	return audioScriptAssetOf(rows, entityId);
+}
 //#endregion
 //#region src/entity-crdt/ordering.ts
 /** Domain order is scoped by membership; relation storage has no global order. */
@@ -3925,8 +3975,10 @@ var LoroEntityDocument = class LoroEntityDocument {
 	/**
 	* Bind a saved snapshot without rewriting text operations or resolving
 	* selection conflicts. The script names the bytes the same way everything
-	* else does — an Asset entity plus a `from-asset` Relation — and keeps only
-	* the fingerprint that tells a stale snapshot from a current one.
+	* else does — an Asset entity plus a Relation — and keeps only the
+	* fingerprint that tells a stale snapshot from a current one. The Relation is
+	* `to-asset`: these bytes are the script's own content written out, not a
+	* source it was made from.
 	*/
 	bindAudioScriptAsset(entityId, assetId, expectedContentHash) {
 		const key = family(this.doc, entityId);
@@ -3949,10 +4001,10 @@ var LoroEntityDocument = class LoroEntityDocument {
 		this.transact((draft) => {
 			const current = readEntityDocument(this.doc, true).rows;
 			if (audioScriptAssetOf(current, entityId)?.entityId !== assetEntityId) {
-				for (const relation of current.relations) if (relation.relationKind === "from-asset" && (String(relation.endpoint0EntityId) === String(entityId) || String(relation.endpoint1EntityId) === String(entityId))) draft.unlink(String(relation.relationId));
+				for (const relation of current.relations) if (relation.relationKind === "to-asset" && (String(relation.endpoint0EntityId) === String(entityId) || String(relation.endpoint1EntityId) === String(entityId))) draft.unlink(String(relation.relationId));
 				draft.link({
-					relationId: createRelationId(`relation_from-asset_${entityId}_${assetId}`),
-					relationKind: "from-asset",
+					relationId: createRelationId(`relation_to-asset_${entityId}_${assetId}`),
+					relationKind: "to-asset",
 					endpoint0EntityId: createEntityId(entityId),
 					endpoint1EntityId: assetEntityId,
 					metadata: {},
@@ -4663,4 +4715,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { ensureLaneTrack as $, assembleEntityContent as A, hasSequence as B, projectEntityTimeline as C, bytesToBase64 as Ct, decodeEntityRelationRows as D, EntityTimelineProjectionError as E, updateEntityFields as F, fromVideoDocument as G, buildInitialVideoDocument as H, variantBaseEntityIds as I, assertValidVideoDocument as J, toVideoDocument as K, isJsonObject as L, assembleScriptText as M, findComposedAudioScript as N, ScriptCompositionError as O, selectAudioScriptSegment as P, LANE_KINDS_IN_STACK_ORDER as Q, createEntityId as R, resolveFieldPath as S, base64ToBytes as St, resolveEntityTimelineLayout as T, buildSpeechHostMap as U, isMediaAssetVariantKind as V, derivePositionFromAbs as W, partUnionSchema as X, validateVideoDocument as Y, videoDocumentSchema as Z, audioScriptAssetOf as _, effectiveVideoClipDurationMs as _t, createMirrorVideoDocument as a, arrangeMainTrackSeamlessly as at, applyFieldChanges as b, recordEntries as bt, DocumentMutationGuard as c, recalculateTimelineDuration as ct, LoroEntityDraft as d, syncAggregatedClipsTimePosition as dt, findLaneTrack as et, readEntityDocument as f, TIMELINE_SKELETON_DURATION_MS as ft, audioScriptAssetHash as g, DEFAULT_UNIT_TIME_MS as gt, audioScriptAssetFields as h, safeDurationMs as ht, MirrorVideoDocumentAdapter as i, cascadeAfterVideoClipChanges as it, assemblePhoneticScriptContent as j, assembleCaptionContent as k, LORO_ENTITY_SCHEMA as l, resolveAllSpeechOverlaps as lt, audioScriptAssetContent as m, partDurationMs as mt, createPlainMemoryAdapter as n, laneTrackId as nt, createMirrorVideoDocumentAdapter as o, fillMainTrackTimeGaps as ot, entityOrderGroups as p, isEmptyVideoClip as pt, VideoDocumentValidationError as q, generatePartId as r, solveVideoDocument as rt, readVideoDocumentFromDraft as s, reassignSpeechesToVideoClipsByTime as st, PlainMemoryAdapter as t, hasResolvedPlacement as tt, LoroEntityDocument as u, resolveSpeechOverlapByShiftingVideos as ut, canonicalJson as v, speedOf as vt, EntityProjectionGraph as w, assertFieldChanges as x, videoDocumentMirrorSchema as xt, equalJson as y, partUnionToDraft as yt, createRelationId as z };
+export { partUnionSchema as $, decodeEntityRelationRows as A, isJsonObject as B, applyFieldChanges as C, recordEntries as Ct, EntityProjectionGraph as D, projectEntityTimeline as E, bytesToBase64 as Et, assembleScriptText as F, buildInitialVideoDocument as G, createRelationId as H, findComposedAudioScript as I, fromVideoDocument as J, buildSpeechHostMap as K, selectAudioScriptSegment as L, assembleCaptionContent as M, assembleEntityContent as N, resolveEntityTimelineLayout as O, assemblePhoneticScriptContent as P, validateVideoDocument as Q, updateEntityFields as R, equalJson as S, partUnionToDraft as St, resolveFieldPath as T, base64ToBytes as Tt, hasSequence as U, createEntityId as V, isMediaAssetVariantKind as W, VideoDocumentValidationError as X, toVideoDocument as Y, assertValidVideoDocument as Z, audioScriptAssetOf as _, partDurationMs as _t, createMirrorVideoDocument as a, laneTrackId as at, phoneticScriptAssetOf as b, effectiveVideoClipDurationMs as bt, DocumentMutationGuard as c, arrangeMainTrackSeamlessly as ct, LoroEntityDraft as d, recalculateTimelineDuration as dt, videoDocumentSchema as et, readEntityDocument as f, resolveAllSpeechOverlaps as ft, audioScriptAssetHash as g, isEmptyVideoClip as gt, audioScriptAssetFields as h, TIMELINE_SKELETON_DURATION_MS as ht, MirrorVideoDocumentAdapter as i, hasResolvedPlacement as it, ScriptCompositionError as j, EntityTimelineProjectionError as k, LORO_ENTITY_SCHEMA as l, fillMainTrackTimeGaps as lt, audioScriptAssetContent as m, syncAggregatedClipsTimePosition as mt, createPlainMemoryAdapter as n, ensureLaneTrack as nt, createMirrorVideoDocumentAdapter as o, solveVideoDocument as ot, entityOrderGroups as p, resolveSpeechOverlapByShiftingVideos as pt, derivePositionFromAbs as q, generatePartId as r, findLaneTrack as rt, readVideoDocumentFromDraft as s, cascadeAfterVideoClipChanges as st, PlainMemoryAdapter as t, LANE_KINDS_IN_STACK_ORDER as tt, LoroEntityDocument as u, reassignSpeechesToVideoClipsByTime as ut, phoneticScriptAssetContent as v, safeDurationMs as vt, assertFieldChanges as w, videoDocumentMirrorSchema as wt, scriptSourceAssetOf as x, speedOf as xt, phoneticScriptAssetHash as y, DEFAULT_UNIT_TIME_MS as yt, variantBaseEntityIds as z };

package/dist/{index-qAoWdqvp.d.ts → index-BZtSciyB.d.ts}

@@ -1104,7 +1104,7 @@ type CaptionSegmentSelection = JsonObject & {
 };
 //#endregion
 //#region ../medeo-dsl/src/relations.d.ts
-type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'to-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
 type RelationKind = KnownRelationKind | (string & {});
 type RelationTrace = JsonObject;
 /**