@mengine/medeo-client 2.0.1-alpha.20 → 2.0.1-alpha.21

package/dist/{document-yPiwEmkJ.js → document-BXQcpnOg.js}

@@ -1177,7 +1177,8 @@ function toAuthoritativePartLibrary(partLibrary) {
 		if (typeof part !== "object" || part == null) continue;
 		if (part.video_clip != null) out[partId] = { video_clip: withTrimWindowFromDuration(part.video_clip) };
 		else if (part.speech != null) {
-			const { duration_ms, rest } = splitDurationMs(part.speech);
+			const { origin_asset_system: _originAssetSystem, ...readSpeech } = part.speech;
+			const { duration_ms, rest } = splitDurationMs(readSpeech);
 			out[partId] = { speech: {
 				...rest,
 				media_duration_ms: rest.media_duration_ms ?? duration_ms
@@ -3035,7 +3036,7 @@ function resolveGraphLayout(graph) {
 			if (clip.entityKind !== "clip" || graph.adjacent(clip.entityId, "track-clip").length !== 1) fail(`Clip ${clip.entityId} must belong to exactly one Track`);
 			const marker = graph.one(clip.entityId, "clip-marker", "sequence-marker");
 			const content = graph.one(marker.entityId, "marker-content");
-			if (!(typedRole === "video_clip" ? ["image", "video"] : typedRole === "speech" ? ["voiceover"] : typedRole === "caption" ? ["caption"] : ["audio"]).includes(content.entityKind)) fail(`unsupported compatibility content kind ${content.entityKind} on ${typedRole} Track`);
+			assertTrackContent(graph, typedRole, content);
 			const source = range(marker.payload.sourceRange, "sourceRange");
 			const durationFact = marker.payload.duration;
 			if (!object(durationFact)) fail(`Marker ${marker.entityId} requires duration`);
@@ -3154,6 +3155,32 @@ function resolveGraphLayout(graph) {
 		}))
 	};
 }
+function assertTrackContent(graph, role, content) {
+	if (role === "speech") {
+		assertSpeechContent(graph, content);
+		return;
+	}
+	if (!(role === "video_clip" ? ["image", "video"] : role === "caption" ? ["caption"] : ["audio"]).includes(content.entityKind)) fail(`unsupported compatibility content kind ${content.entityKind} on ${role} Track`);
+}
+function assertSpeechContent(graph, content) {
+	const assetLinks = graph.rows.relations.filter((relation) => relation.relationKind === "from-asset" && (relation.endpoint0EntityId === content.entityId || relation.endpoint1EntityId === content.entityId));
+	if (assetLinks.length !== 1 || assetLinks[0].endpoint0EntityId !== content.entityId) fail("Speech content requires one ordered from-asset binding");
+	const asset = graph.entity(assetLinks[0].endpoint1EntityId, "asset");
+	if (content.entityKind === "voiceover") {
+		const renders = graph.rows.relations.filter((relation) => relation.relationKind === "phonetic-script-render" && (relation.endpoint0EntityId === content.entityId || relation.endpoint1EntityId === content.entityId));
+		if (renders.length !== 1 || renders[0].endpoint0EntityId !== content.entityId || graph.entity(renders[0].endpoint1EntityId).entityKind !== "phonetic-script") fail("Synthesized Speech Voiceover requires one ordered PhoneticScript render");
+		if (asset.payload.system !== "memota-speech") fail("Synthesized Speech Voiceover requires an explicit memota-speech key");
+		return;
+	}
+	if (content.entityKind === "audio") {
+		const sources = graph.rows.relations.filter((relation) => relation.relationKind === "audio-script-source" && (relation.endpoint0EntityId === content.entityId || relation.endpoint1EntityId === content.entityId));
+		if (sources.length > 1) fail("Recorded speech has an ambiguous AudioScript source receipt");
+		if (sources.length === 1 && (sources[0].endpoint1EntityId !== content.entityId || graph.entity(sources[0].endpoint0EntityId).entityKind !== "audio-script")) fail("Recorded Speech AudioScript source must use ordered endpoints");
+		if (asset.payload.system !== "memota") fail("Recorded Speech Audio requires an explicit memota key");
+		return;
+	}
+	fail(`unsupported compatibility content kind ${content.entityKind} on speech Track`);
+}
 //#endregion
 //#region src/document/entity-projection.ts
 /**
@@ -3195,20 +3222,21 @@ function projectEntityTimeline(rows) {
 		} else if (track.role === "speech") {
 			const asset = mediaAssetFacts(graph, content);
 			requireUntrimmedAudio(content, marker, placement);
-			const external = externalLocator(asset, "memota-speech");
-			const renderEdges = graph.adjacent(content.entityId, "phonetic-script-render");
 			const timbreEdges = graph.adjacent(content.entityId, "voice-timbre");
-			const assembled = renderEdges.length > 0 || timbreEdges.length > 0 ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
+			const isSynthesized = content.entityKind === "voiceover";
+			const external = externalLocator(asset, isSynthesized ? "memota-speech" : "memota");
+			const assembled = isSynthesized ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
 			if (timbreEdges.length > 1) fail("A voiceover resolves at most one Voice identity");
 			const voice = timbreEdges.length === 0 ? void 0 : graph.one(content.entityId, "voice-timbre", "voice").payload.voice;
 			if (voice !== void 0 && (!object(voice) || voice.system !== "voice-library" || typeof voice.key !== "string")) fail("Voice must use an explicit voice-library locator");
 			const captionIds = layout.tracks.flatMap((candidate) => candidate.role === "caption" ? candidate.clips.filter((caption) => caption.anchorClipEntityId === clip.entityId).map((caption) => caption.clipEntityId) : []);
-			parts[clip.entityId] = { speech: {
+			const speech = {
 				id: clip.entityId,
 				kind: "speech",
 				media_duration_ms: placement.duration,
 				audio_storage_key: storageKey(asset),
 				origin_speech_id: external.key,
+				origin_asset_system: external.system,
 				audio_script: assembled?.text ?? (graph.adjacent(content.entityId, "audio-script-source").length > 0 ? assembleScriptText(graph.one(content.entityId, "audio-script-source", "audio-script")) : ""),
 				volume: volume.data,
 				voice: object(voice) ? {
@@ -3216,7 +3244,8 @@ function projectEntityTimeline(rows) {
 					name: typeof voice.name === "string" ? voice.name : void 0
 				} : void 0,
 				caption_ids: captionIds
-			} };
+			};
+			parts[clip.entityId] = { speech };
 		} else if (track.role === "caption") {
 			const assembled = assembleCaptionContent(rows, content.entityId);
 			const text = assembled.text;
@@ -3296,7 +3325,10 @@ function storageKey(asset) {
 function externalLocator(asset, system) {
 	const { system: found, key } = asset.payload;
 	if (found !== system || typeof key !== "string" || key.trim() === "") fail("Asset " + asset.entityId + " requires an explicit " + system + " key");
-	return { key };
+	return {
+		key,
+		system
+	};
 }
 function captionStyle(value) {
 	if (value === void 0) return void 0;
@@ -3940,6 +3972,25 @@ var LoroEntityDocument = class LoroEntityDocument {
 		if (id === void 0) return [];
 		return this.snapshot().rows.relations.filter((row) => row.endpoint0EntityId === id || row.endpoint1EntityId === id);
 	}
+	/** Read unlinked Relation records for durable effect receipts; never part of the current semantic graph. */
+	tombstonedRelations() {
+		const result = [];
+		for (const key of section(this.doc, "relations").keys().sort((a, b) => a < b ? -1 : a > b ? 1 : 0)) {
+			const map = section(this.doc, "relations").get(key);
+			if (!(map instanceof LoroMap) || map.get("deleted") !== true) continue;
+			const identity = map.get("identity");
+			if (!identity || identity.endpoints.length !== 2) throw new Error(`Invalid tombstoned Relation ${key}`);
+			result.push({
+				relationId: createRelationId(key),
+				relationKind: identity.kind,
+				endpoint0EntityId: createEntityId(identity.endpoints[0]),
+				endpoint1EntityId: createEntityId(identity.endpoints[1]),
+				metadata: requireMap(map, "metadata").toJSON(),
+				trace: requireMap(map, "trace").toJSON()
+			});
+		}
+		return result;
+	}
 	/** Resolve a queued edit target through its native identity without changing history. */
 	resolveCurrentEntityId(id) {
 		return currentId(this.doc, id);
@@ -4727,4 +4778,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-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 };
+export { validateVideoDocument as $, EntityTimelineProjectionError as A, variantBaseEntityIds as B, equalJson as C, partUnionToDraft as Ct, projectEntityTimeline as D, bytesToBase64 as Dt, resolveFieldPath as E, base64ToBytes as Et, assemblePhoneticScriptContent as F, isMediaAssetVariantKind as G, createEntityId as H, assembleScriptText as I, derivePositionFromAbs as J, buildInitialVideoDocument as K, findComposedAudioScript as L, ScriptCompositionError as M, assembleCaptionContent as N, EntityProjectionGraph as O, assembleEntityContent as P, assertValidVideoDocument as Q, selectAudioScriptSegment as R, canonicalJson as S, speedOf as St, assertFieldChanges as T, videoDocumentMirrorSchema as Tt, createRelationId as U, isJsonObject as V, hasSequence as W, toVideoDocument as X, fromVideoDocument as Y, VideoDocumentValidationError as Z, audioScriptAssetOf as _, isEmptyVideoClip as _t, createMirrorVideoDocument as a, hasResolvedPlacement as at, phoneticScriptAssetOf as b, DEFAULT_UNIT_TIME_MS as bt, DocumentMutationGuard as c, cascadeAfterVideoClipChanges as ct, LoroEntityDraft as d, reassignSpeechesToVideoClipsByTime as dt, partUnionSchema as et, readEntityDocument as f, recalculateTimelineDuration as ft, audioScriptAssetHash as g, TIMELINE_SKELETON_DURATION_MS as gt, audioScriptAssetFields as h, syncAggregatedClipsTimePosition as ht, MirrorVideoDocumentAdapter as i, findLaneTrack as it, decodeEntityRelationRows as j, resolveEntityTimelineLayout as k, LORO_ENTITY_SCHEMA as l, arrangeMainTrackSeamlessly as lt, audioScriptAssetContent as m, resolveSpeechOverlapByShiftingVideos as mt, createPlainMemoryAdapter as n, LANE_KINDS_IN_STACK_ORDER as nt, createMirrorVideoDocumentAdapter as o, laneTrackId as ot, entityOrderGroups as p, resolveAllSpeechOverlaps as pt, buildSpeechHostMap as q, generatePartId as r, ensureLaneTrack as rt, readVideoDocumentFromDraft as s, solveVideoDocument as st, PlainMemoryAdapter as t, videoDocumentSchema as tt, LoroEntityDocument as u, fillMainTrackTimeGaps as ut, phoneticScriptAssetContent as v, partDurationMs as vt, applyFieldChanges as w, recordEntries as wt, scriptSourceAssetOf as x, effectiveVideoClipDurationMs as xt, phoneticScriptAssetHash as y, safeDurationMs as yt, updateEntityFields as z };

package/dist/{index-C0uUWqkz.d.ts → index-CzDNr1Tb.d.ts}

@@ -473,6 +473,8 @@ type VideoClipPart = Omit<VideoClipPart$1, 'duration_ms'>;
 type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
   media_duration_ms?: number | undefined;
 };
+/** Asset namespace exposed only by the legacy read view; never an authoritative Speech fact. */
+type SpeechOriginAssetSystem = 'memota' | 'memota-speech';
 /**
  * Authoritative caption part. The IDL `CaptionPart` carries `duration_ms` (the
  * effective display length, a derived read-view value); the authoritative store
@@ -621,7 +623,8 @@ type VideoDraftPartUnion = {
 } | {
   video_clip?: never;
   speech: SpeechPart & {
-    duration_ms?: number;
+    duration_ms?: number; /** Absent only on historical drafts created before this read-view discriminator. */
+    origin_asset_system?: SpeechOriginAssetSystem;
   };
   caption?: never;
   bgm?: never;
@@ -669,6 +672,7 @@ type VideoDraftContentPartUnion = {
   video_clip?: never;
   speech: SpeechPart & {
     duration_ms: number | undefined;
+    origin_asset_system?: SpeechOriginAssetSystem;
   };
   caption?: never;
   bgm?: never;
@@ -1143,12 +1147,26 @@ declare class EntityTimelineProjectionError extends Error {
 }
 //#endregion
 //#region src/document/entity-projection.d.ts
+type EntityTimelineProjectionPart = Exclude<PartUnion, {
+  speech: SpeechPart;
+}> | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    origin_asset_system: SpeechOriginAssetSystem;
+  };
+  caption?: never;
+  bgm?: never;
+};
+/** Ephemeral compatibility document; the origin discriminator is never stored in Loro. */
+type EntityTimelineProjectionDocument = Omit<VideoDocument, 'part_library'> & {
+  part_library: Record<string, EntityTimelineProjectionPart>;
+};
 /**
  * One-way compatibility view over the Entity graph. A legacy part is never
  * consulted as an editing fact. Peer IDs appear only in this derived read
  * contract, reconstructed from relations; they are not stored in payloads.
  */
-declare function projectEntityTimeline(rows: EntityRelationRows): VideoDocument;
+declare function projectEntityTimeline(rows: EntityRelationRows): EntityTimelineProjectionDocument;
 //#endregion
 //#region src/document/entity-timeline-layout.d.ts
 type EntityTimelineTrackRole = 'video_clip' | 'speech' | 'caption' | 'bgm';
@@ -1870,4 +1888,4 @@ declare const videoDocumentSchema: z.ZodObject<{
   }, z.core.$loose>]>>>;
 }, z.core.$loose>;
 //#endregion
-export { SpeechHostMap as $, assertValidVideoDocument as A, VideoDocumentValidationIssueCode as At, EntityRow as B, SpeedShift as Bt, isImplementedSemanticOpKind as C, Timeline as Ct, PartIdFactory as D, VideoClipPart as Dt, ValidationError as E, TrackItemTimePosition as Et, ResolvedEntityTrack as F, speedOf as Ft, SequenceDuration as G, CaptionSegmentSelection as H, Track$1 as Ht, resolveEntityTimelineLayout as I, Attachment as It, JsonObject as J, SequenceRange as K, projectEntityTimeline as L, CaptionPart$1 as Lt, EntityTimelineTrackRole as M, VideoDraftContent as Mt, ResolvedEntityClipPlacement as N, VideoDraftPartUnion as Nt, generatePartId as O, VideoDocument as Ot, ResolvedEntityTimelineLayout as P, effectiveVideoClipDurationMs as Pt, DerivedItemPosition as Q, EntityTimelineProjectionError as R, CaptionStyle as Rt, SemanticOpKind as S, SpeechPart as St, SnapshotReadable as T, TrackItem as Tt, CaptionStyleFields as U, TrackItem$1 as Ut, RelationRow as V, Timeline$1 as Vt, ScriptTextSegment as W, EntityId as X, JsonValue as Y, buildInitialVideoDocument as Z, SemanticOpName as _, CaptionDisplayCue as _t, PlainMemoryAdapter as a, LaneKind as at, ImplementedSemanticOpKind as b, PartKind as bt, MirrorVideoDocumentAdapter as c, findLaneTrack as ct, createMirrorVideoDocumentAdapter as d, TrackDraft as dt, buildSpeechHostMap as et, CommitOptions as f, TrackItemDraft as ft, SemanticOpInput as g, BgmPart as gt, SemanticEditor as h, videoDocumentMirrorSchema as ht, JournalEntry as i, LANE_KINDS_IN_STACK_ORDER as it, validateVideoDocument as j, VideoDraft as jt, VideoDocumentValidationError as k, VideoDocumentValidationIssue as kt, MirrorVideoDocumentOptions as l, laneTrackId as lt, SemanticDocumentAdapter as m, VideoDocumentMirrorSchema as mt, videoDocumentSchema as n, fromVideoDocument as nt, PlainMemoryAdapterOptions as o, SolvedVideoDocument as ot, OpActor as p, VideoDocumentDraft as pt, VoiceDescriptor as q, readVideoDocumentFromDraft as r, toVideoDocument as rt, createPlainMemoryAdapter as s, ensureLaneTrack as st, partUnionSchema as t, derivePositionFromAbs as tt, createMirrorVideoDocument as u, solveVideoDocument as ut, TransactAudit as v, CaptionPart as vt, SchemaValidator as w, Track as wt, PlannedSemanticOpKind as x, PartUnion as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, DEFAULT_UNIT_TIME_MS as yt, EntityRelationRows as z, PartAggregation as zt };
+export { DerivedItemPosition as $, assertValidVideoDocument as A, VideoDocument as At, EntityRelationRows as B, CaptionStyle as Bt, isImplementedSemanticOpKind as C, SpeechOriginAssetSystem as Ct, PartIdFactory as D, TrackItem as Dt, ValidationError as E, Track as Et, ResolvedEntityTrack as F, VideoDraftPartUnion as Ft, ScriptTextSegment as G, TrackItem$1 as Gt, RelationRow as H, SpeedShift as Ht, resolveEntityTimelineLayout as I, effectiveVideoClipDurationMs as It, VoiceDescriptor as J, SequenceDuration as K, EntityTimelineProjectionDocument as L, speedOf as Lt, EntityTimelineTrackRole as M, VideoDocumentValidationIssueCode as Mt, ResolvedEntityClipPlacement as N, VideoDraft as Nt, generatePartId as O, TrackItemTimePosition as Ot, ResolvedEntityTimelineLayout as P, VideoDraftContent as Pt, buildInitialVideoDocument as Q, projectEntityTimeline as R, Attachment as Rt, SemanticOpKind as S, PartUnion as St, SnapshotReadable as T, Timeline as Tt, CaptionSegmentSelection as U, Timeline$1 as Ut, EntityRow as V, PartAggregation as Vt, CaptionStyleFields as W, Track$1 as Wt, JsonValue as X, JsonObject as Y, EntityId as Z, SemanticOpName as _, BgmPart as _t, PlainMemoryAdapter as a, LANE_KINDS_IN_STACK_ORDER as at, ImplementedSemanticOpKind as b, DEFAULT_UNIT_TIME_MS as bt, MirrorVideoDocumentAdapter as c, ensureLaneTrack as ct, createMirrorVideoDocumentAdapter as d, solveVideoDocument as dt, SpeechHostMap as et, CommitOptions as f, TrackDraft as ft, SemanticOpInput as g, videoDocumentMirrorSchema as gt, SemanticEditor as h, VideoDocumentMirrorSchema as ht, JournalEntry as i, toVideoDocument as it, validateVideoDocument as j, VideoDocumentValidationIssue as jt, VideoDocumentValidationError as k, VideoClipPart as kt, MirrorVideoDocumentOptions as l, findLaneTrack as lt, SemanticDocumentAdapter as m, VideoDocumentDraft as mt, videoDocumentSchema as n, derivePositionFromAbs as nt, PlainMemoryAdapterOptions as o, LaneKind as ot, OpActor as p, TrackItemDraft as pt, SequenceRange as q, readVideoDocumentFromDraft as r, fromVideoDocument as rt, createPlainMemoryAdapter as s, SolvedVideoDocument as st, partUnionSchema as t, buildSpeechHostMap as tt, createMirrorVideoDocument as u, laneTrackId as ut, TransactAudit as v, CaptionDisplayCue as vt, SchemaValidator as w, SpeechPart as wt, PlannedSemanticOpKind as x, PartKind as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, CaptionPart as yt, EntityTimelineProjectionError as z, CaptionPart$1 as zt };