@mengine/medeo-client 1.3.1-alpha.1 → 1.3.1-alpha.10

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, A as VideoDocumentValidationError, B as cascadeAfterVideoClipChanges, C as hasSequence, D as derivePositionFromAbs, E as buildSpeechHostMap, F as LANE_KINDS_IN_STACK_ORDER, G as resolveAllSpeechOverlaps, H as fillMainTrackTimeGaps, I as ensureLaneTrack, J as TIMELINE_SKELETON_DURATION_MS, K as resolveSpeechOverlapByShiftingVideos, L as findLaneTrack, M as validateVideoDocument, N as partUnionSchema, O as fromVideoDocument, P as videoDocumentSchema, Q as DEFAULT_UNIT_TIME_MS, R as laneTrackId, S as selectAudioScriptSegments, T as buildInitialVideoDocument, U as reassignSpeechesToVideoClipsByTime, V as arrangeMainTrackSeamlessly, W as recalculateTimelineDuration, X as partDurationMs, Y as isEmptyVideoClip, Z as safeDurationMs, _ as ScriptCompositionError, a as applyEntityTimelineProjection, at as videoDocumentMirrorSchema, b as assembleScriptText, c as writeVideoDocumentToDraft, d as resolveEntityTimelineLayout, et as VIDEO_DOCUMENT_SCHEMA_VERSION, f as EntityTimelineProjectionError, g as createRelationId, h as createEntityId, i as MirrorVideoDocumentAdapter, it as recordEntries, j as assertValidVideoDocument, k as toVideoDocument, l as readVideoDocumentFromDraft, m as isJsonObject, n as createPlainMemoryAdapter, nt as speedOf, o as createMirrorVideoDocument, ot as base64ToBytes, p as decodeEntityRelationRows, q as syncAggregatedClipsTimePosition, r as generatePartId, rt as partUnionToDraft, s as createMirrorVideoDocumentAdapter, st as bytesToBase64, t as PlainMemoryAdapter, tt as effectiveVideoClipDurationMs, u as projectEntityTimeline, v as assembleCaptionContent, w as isMediaAssetVariantKind, x as findComposedAudioScript, y as assemblePhoneticScriptContent, z as solveVideoDocument } from "./document-Bf200CmD.js";
+import { $ as reassignSpeechesToVideoClipsByTime, A as isJsonObject, B as VideoDocumentValidationError, C as assembleEntityContent, D as selectAudioScriptSegments, E as findComposedAudioScript, F as buildInitialVideoDocument, G as LANE_KINDS_IN_STACK_ORDER, H as validateVideoDocument, I as buildSpeechHostMap, J as laneTrackId, K as ensureLaneTrack, L as derivePositionFromAbs, M as createRelationId, N as hasSequence, O as updateEntityFields, P as isMediaAssetVariantKind, Q as fillMainTrackTimeGaps, R as fromVideoDocument, S as assembleCaptionContent, T as assembleScriptText, U as partUnionSchema, V as assertValidVideoDocument, W as videoDocumentSchema, X as cascadeAfterVideoClipChanges, Y as solveVideoDocument, Z as arrangeMainTrackSeamlessly, _ as EntityProjectionGraph, _t as bytesToBase64, a as applyEntityTimelineProjection, at as isEmptyVideoClip, b as decodeEntityRelationRows, c as writeVideoDocumentToDraft, ct as DEFAULT_UNIT_TIME_MS, d as LoroEntityDocument, dt as effectiveVideoClipDurationMs, et as recalculateTimelineDuration, f as LoroEntityDraft, ft as speedOf, g as projectEntityTimeline, gt as base64ToBytes, h as equalJson, ht as videoDocumentMirrorSchema, i as MirrorVideoDocumentAdapter, it as TIMELINE_SKELETON_DURATION_MS, j as createEntityId, k as variantBaseEntityIds, l as readVideoDocumentFromDraft, lt as ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, m as entityOrderGroups, mt as recordEntries, n as createPlainMemoryAdapter, nt as resolveSpeechOverlapByShiftingVideos, o as createMirrorVideoDocument, ot as partDurationMs, p as readEntityDocument, pt as partUnionToDraft, q as findLaneTrack, r as generatePartId, rt as syncAggregatedClipsTimePosition, s as createMirrorVideoDocumentAdapter, st as safeDurationMs, t as PlainMemoryAdapter, tt as resolveAllSpeechOverlaps, u as LORO_ENTITY_SCHEMA, ut as VIDEO_DOCUMENT_SCHEMA_VERSION, v as resolveEntityTimelineLayout, w as assemblePhoneticScriptContent, x as ScriptCompositionError, y as EntityTimelineProjectionError, z as toVideoDocument } from "./document-BxWxPFTj.js";
 import { addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, t as schemas_exports } from "./schemas.js";
 import { LoroDoc, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -217,6 +217,67 @@ function findSseFrameBoundary(buffer) {
 	return Math.min(lf, crlf);
 }
 //#endregion
+//#region src/entity-crdt/compile-rows.ts
+/** Lower a detached ordinary-object edit against its actual causal Loro baseline. */
+function compileEntityRows(snapshot, rows, validate) {
+	const doc = new LoroDoc();
+	doc.import(snapshot);
+	return applyEntityRows(new LoroEntityDocument(doc, validate), rows);
+}
+/** Compile an edit on an existing peer, retaining its native local undo history. */
+function applyEntityRows(editor, rows) {
+	const before = editor.snapshot().rows;
+	const oldEntities = new Map(before.entities.map((row) => [row.entityId, row]));
+	const newEntities = new Map(rows.entities.map((row) => [row.entityId, row]));
+	const oldRelations = new Map(before.relations.map((row) => [row.relationId, row]));
+	const newRelations = new Map(rows.relations.map((row) => [row.relationId, row]));
+	if (newEntities.size !== rows.entities.length || newRelations.size !== rows.relations.length) throw new Error("Duplicate domain identity");
+	return {
+		update: editor.transact((draft) => {
+			for (const row of before.relations) {
+				const next = newRelations.get(row.relationId);
+				if (!next) draft.unlink(row.relationId);
+				else {
+					if (next.relationKind !== row.relationKind || next.endpoint0EntityId !== row.endpoint0EntityId || next.endpoint1EntityId !== row.endpoint1EntityId) throw new Error("Relation identity cannot change kind or endpoint positions");
+					if (!equalJson(row.metadata, next.metadata) || !equalJson(row.trace, next.trace)) draft.patchRelation(row.relationId, next.metadata, next.trace);
+				}
+			}
+			for (const row of rows.entities) {
+				const previous = oldEntities.get(row.entityId);
+				if (!previous) draft.create(row);
+				else {
+					if (previous.entityKind !== row.entityKind) throw new Error("Entity kind cannot change");
+					if (!equalJson(previous.payload, row.payload)) draft.replaceOwned(row.entityId, row.payload);
+				}
+			}
+			for (const row of rows.relations) if (!oldRelations.has(row.relationId)) draft.link(row);
+			const beforeOrder = entityOrderGroups(before), afterOrder = entityOrderGroups(rows);
+			for (const group of new Set([...beforeOrder.keys(), ...afterOrder.keys()])) {
+				const next = afterOrder.get(group) ?? [];
+				if (!equalJson(beforeOrder.get(group) ?? [], next)) draft.order(group, next);
+			}
+			for (const row of before.entities) if (!newEntities.has(row.entityId)) draft.delete(row.entityId);
+		}),
+		state: editor.snapshot()
+	};
+}
+//#endregion
+//#region src/entity-editor/document-audio-script.ts
+/** Read only the attached version and preserve every segment; never aggregate other scripts. */
+function readDocumentAudioScript(state) {
+	const id = state.audioScriptEntityId;
+	if (id === null) throw new EntityTimelineProjectionError("Document AudioScript is not initialized");
+	if (typeof id !== "string" || id.trim() !== id || !id) throw new EntityTimelineProjectionError("Invalid document AudioScript identity");
+	const entity = state.rows.entities.find((row) => row.entityId === id);
+	if (!entity || entity.entityKind !== "audio-script") throw new EntityTimelineProjectionError(`Document AudioScript ${id} must name the project AudioScript`);
+	const content = assembleEntityContent(state.rows, createEntityId(id));
+	assembleScriptText(content);
+	return {
+		entityId: id,
+		segments: structuredClone(content.payload.segments)
+	};
+}
+//#endregion
 //#region src/entity-editor/editor-resources.ts
 const roleOrder$1 = {
 	caption: 0,
@@ -296,6 +357,26 @@ function memotaLocator(value) {
 		key: value.key
 	};
 }
+/**
+* The project AudioScript is a fixed structure identity, like the Timeline: at
+* most one may exist, and a missing one is minted atomically with empty
+* segments. Project initialization and legacy migration share this single
+* path, so both produce the same canonical structure.
+*/
+function ensureDocumentAudioScript(entities, idFactory) {
+	const scripts = entities.filter((row) => row.entityKind === "audio-script");
+	if (scripts.length > 1) throw new EntityTimelineProjectionError("Editor requires exactly one AudioScript");
+	const existing = scripts[0];
+	if (existing !== void 0) return existing.entityId;
+	const id = createEntityId(idFactory("entity"));
+	if (entities.some((row) => row.entityId === id)) throw new Error(`Duplicate entity id ${id}`);
+	entities.push({
+		entityId: id,
+		entityKind: "audio-script",
+		payload: { segments: [] }
+	});
+	return id;
+}
 /** Add only missing editor structure; existing identities and owned settings are never replaced. */
 function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${globalThis.crypto.randomUUID()}`, timelinePayload = {}) {
 	const entities = structuredClone([...initial.entities]);
@@ -348,13 +429,15 @@ function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${gl
 		}
 		trackEntityIds[role] = track.entityId;
 	}
+	const audioScriptEntityId = ensureDocumentAudioScript(entities, idFactory);
 	return {
 		rows: {
 			entities,
 			relations
 		},
 		timelineEntityId: timeline.entityId,
-		trackEntityIds
+		trackEntityIds,
+		audioScriptEntityId
 	};
 }
 //#endregion
@@ -364,7 +447,7 @@ const numericMarkerValidation$1 = { compareMarkerPoints: (_marker, _range, left,
 	if (typeof left !== "number" || !Number.isFinite(left) || typeof right !== "number" || !Number.isFinite(right)) throw new Error("entity-state requires finite numeric Marker coordinates");
 	return left < right ? -1 : left > right ? 1 : 0;
 } };
-/** Browser-safe authenticated CAS client for a document's Entity graph. */
+/** Browser-safe authenticated Loro client for a document's Entity graph. */
 var EntityGraphHttpClient = class {
 	options;
 	transport;
@@ -379,30 +462,24 @@ var EntityGraphHttpClient = class {
 		return this.request({ method: "GET" });
 	}
 	/**
-	* Replace the complete Entity graph under the baseline revision.
+	* Compile edits against the original causal snapshot and publish native Loro operations.
 	*
 	* Deletion intent is derived from baseline IDs omitted from `nextRows`, so a
 	* transient create-then-remove never becomes a request to delete unknown
 	* persisted data.
 	*/
 	async commit(baseState, nextRows, options = {}) {
-		if (!isNonNegativeSafeInteger(baseState.revision)) throw new Error("Entity graph revision must be a non-negative safe integer");
-		const baseRows = cloneAndValidateRows(baseState.rows);
+		if (options.migrationBaseVv !== void 0) throw new Error("Legacy entity migration is not supported by the Loro contract");
 		const next = cloneAndValidateRows(nextRows);
-		assertMediaAssetWritePolicy(baseRows, next);
-		const nextEntityIds = new Set(next.entities.map((row) => row.entityId));
-		const nextRelationIds = new Set(next.relations.map((row) => row.relationId));
-		const deletedEntityIds = baseRows.entities.map((row) => row.entityId).filter((entityId) => !nextEntityIds.has(entityId)).sort();
-		const deletedRelationIds = baseRows.relations.map((row) => row.relationId).filter((relationId) => !nextRelationIds.has(relationId)).sort();
+		assertMediaAssetWritePolicy(baseState.rows, next);
+		const compiled = compileEntityRows(base64ToBytes(baseState.loroSnapshot), next);
+		return this.commitUpdate(bytesToBase64(compiled.update));
+	}
+	/** Send the same prepared bytes on retry; never recompile an unconfirmed edit. */
+	async commitUpdate(update) {
 		return this.request({
 			method: "POST",
-			body: JSON.stringify({
-				expected_revision: baseState.revision,
-				rows: toWireRows(next),
-				deleted_entity_ids: deletedEntityIds,
-				deleted_relation_ids: deletedRelationIds,
-				...options.migrationBaseVv === void 0 ? {} : { migration_base_vv: options.migrationBaseVv }
-			})
+			body: JSON.stringify({ update })
 		});
 	}
 	async request(init) {
@@ -420,10 +497,16 @@ function parseWireState(value, expectedDocId) {
 	if (value.doc_id !== expectedDocId) throw new Error(`Entity-state response doc_id mismatch: expected "${expectedDocId}"`);
 	const rows = parseWireRows(value.rows);
 	decodeEntityRelationRows(rows, numericMarkerValidation$1);
-	return {
+	if (typeof value.audio_script_entity_id !== "string") throw new Error("Document AudioScript is not initialized");
+	if (typeof value.loro_snapshot !== "string") throw new Error("Missing causal Loro snapshot");
+	const state = {
 		revision: value.revision,
-		rows
+		loroSnapshot: value.loro_snapshot,
+		rows,
+		audioScriptEntityId: value.audio_script_entity_id
 	};
+	readDocumentAudioScript(state);
+	return state;
 }
 function parseWireRows(value) {
 	if (!isRecord(value) || !Array.isArray(value.entities) || !Array.isArray(value.relations)) throw new Error("Invalid entity-state response rows");
@@ -456,23 +539,6 @@ function cloneAndValidateRows(rows) {
 	decodeEntityRelationRows(clone, numericMarkerValidation$1);
 	return clone;
 }
-function toWireRows(rows) {
-	return {
-		entities: rows.entities.map((row) => ({
-			entity_id: row.entityId,
-			entity_kind: row.entityKind,
-			payload: row.payload
-		})),
-		relations: rows.relations.map((row) => ({
-			relation_id: row.relationId,
-			relation_kind: row.relationKind,
-			endpoint_0_entity_id: row.endpoint0EntityId,
-			endpoint_1_entity_id: row.endpoint1EntityId,
-			metadata: row.metadata,
-			trace: row.trace
-		}))
-	};
-}
 function requiredString(value, field) {
 	if (typeof value !== "string" || value.length === 0 || value.trim() !== value) throw new Error(`Invalid ${field} in entity-state response`);
 	return value;
@@ -616,8 +682,12 @@ function requireComposedAudioScript(rows, phoneticScriptEntityId) {
 function captionSelections(selections) {
 	return structuredClone(selections);
 }
-function assertSelectionNamesScriptSegments(rows, audioScriptEntityId, selections) {
-	selectAudioScriptSegments(requireEntityKind(rows, audioScriptEntityId, "audio-script"), selections);
+function captionBaseIds(ids) {
+	if (!Array.isArray(ids) || ids.length === 0) throw new Error("Caption requires non-empty baseEntityIds");
+	return ids.map(createEntityId);
+}
+function assertCaptionScript(rows, captionId, scriptId) {
+	if (assembleCaptionContent(rows, captionId).audioScript.entityId !== scriptId) throw new Error("Voiceover Caption must compose the same AudioScript as the PhoneticScript");
 }
 const roleOrder = {
 	caption: 0,
@@ -1281,28 +1351,23 @@ var EntityTimelineEditor = class {
 			const track = findRoleTrack(draft, input.timelineEntityId, "caption");
 			if (track === void 0) return;
 			const patch = cloneJsonObject(input.style, "Caption style");
+			const assembled = new EntityProjectionGraph(draft);
 			for (const clip of clipsOnTrack(draft, track.entityId)) {
 				const topology = requireClipTopology(draft, clip.entityId);
 				const caption = requireEntityKind(draft, otherEndpoint(topology.markerContentRelation, topology.marker.entityId), "caption");
-				const prior = caption.payload.style;
+				const prior = assembled.entity(caption.entityId).payload.style;
 				const style = isJsonObject(prior) ? prior : {};
-				replaceEntity(draft, caption.entityId, {
-					...caption,
-					payload: {
-						...caption.payload,
-						style: {
-							...style,
-							...patch
-						}
-					}
-				});
+				for (const updated of updateEntityFields(draft, caption.entityId, { style: {
+					...style,
+					...patch
+				} })) replaceEntity(draft, updated.entityId, updated);
 			}
 		});
 	}
 	/**
 	* Place a Caption as a composed variant of an existing AudioScript: the
-	* entity stores only its selection, style, and inherent cue-bounded
-	* Sequence — never text. The Clip and its display Marker describe this use;
+	* entity stores baseEntityIds, selection, optional style, and inherent cue-bounded
+	* Sequence. This helper does not copy base text. The Clip and its display Marker describe this use;
 	* moving or stretching the returned Clip later changes the Clip/Marker,
 	* never the Caption entity or the AudioScript.
 	*/
@@ -1310,8 +1375,6 @@ var EntityTimelineEditor = class {
 		return this.transact((draft) => {
 			const durationMs = finitePositive(input.durationMs, "Caption durationMs");
 			const selections = captionSelections(input.selections);
-			const script = requireEntityKind(draft, input.audioScriptEntityId, "audio-script");
-			assertSelectionNamesScriptSegments(draft, script.entityId, selections);
 			const track = this.ensureRoleTrack(draft, input.timelineEntityId, "caption");
 			const content = {
 				entityId: this.mintEntityId(draft),
@@ -1324,12 +1387,13 @@ var EntityTimelineEditor = class {
 					},
 					sampling: "native",
 					coordinateSpace: "milliseconds",
+					baseEntityIds: captionBaseIds(input.baseEntityIds),
 					selections,
 					...input.style === void 0 ? {} : { style: cloneJsonObject(input.style, "Caption style") }
 				}
 			};
 			draft.entities.push(content);
-			draft.relations.push(this.createRelation(draft, "caption-composition", content.entityId, script.entityId, { segmentAlignment: [] }));
+			assembleCaptionContent(draft, content.entityId);
 			return this.insertPlacedClipIntoDraft(draft, {
 				trackEntityId: track.entityId,
 				contentEntityId: content.entityId,
@@ -1434,7 +1498,7 @@ var EntityTimelineEditor = class {
 			const startMs = finiteNonNegative(caption.startMs, "Caption startMs");
 			const durationMs = finitePositive(caption.durationMs, "Caption durationMs");
 			const selections = captionSelections(caption.selections);
-			assertSelectionNamesScriptSegments(draft, audioScriptEntityId, selections);
+			const baseEntityIds = captionBaseIds(caption.baseEntityIds);
 			if (draft.entities.find((entity) => entity.entityId === caption.captionClipEntityId) === void 0) {
 				const content = {
 					entityId: this.mintEntityId(draft),
@@ -1447,12 +1511,14 @@ var EntityTimelineEditor = class {
 						},
 						sampling: "native",
 						coordinateSpace: "milliseconds",
+						baseEntityIds,
 						selections,
 						...caption.style === void 0 ? {} : { style: cloneJsonObject(caption.style, "Caption style") }
 					}
 				};
 				draft.entities.push(content);
-				draft.relations.push(this.createRelation(draft, "caption-composition", content.entityId, audioScriptEntityId, { segmentAlignment: [] }), this.createRelation(draft, "caption-alignment", content.entityId, voiceEntityId, { alignment: {
+				assertCaptionScript(draft, content.entityId, audioScriptEntityId);
+				draft.relations.push(this.createRelation(draft, "caption-alignment", content.entityId, voiceEntityId, { alignment: {
 					start: startMs,
 					end: startMs + durationMs
 				} }));
@@ -1487,10 +1553,12 @@ var EntityTimelineEditor = class {
 				...content,
 				payload: {
 					...content.payload,
+					baseEntityIds,
 					selections,
 					...Object.keys(style).length === 0 ? {} : { style }
 				}
 			});
+			assertCaptionScript(draft, content.entityId, audioScriptEntityId);
 			this.applyClipPlacement(draft, topology.clip.entityId, {
 				kind: "anchored",
 				hostClipEntityId: voiceoverClipEntityId,
@@ -1507,7 +1575,7 @@ var EntityTimelineEditor = class {
 					}
 				}
 			});
-			this.replaceCaptionSemanticRelations(draft, content.entityId, voiceEntityId, audioScriptEntityId, startMs, durationMs);
+			this.replaceCaptionAlignment(draft, content.entityId, voiceEntityId, startMs, durationMs);
 		}
 	}
 	ensureRoleTrackForClip(draft, clipEntityId, role) {
@@ -1516,13 +1584,13 @@ var EntityTimelineEditor = class {
 		const timeline = requireEntityKind(draft, otherEndpoint(requireOneRelation(draft, track.entityId, "timeline-track"), track.entityId), "timeline");
 		return this.ensureRoleTrack(draft, timeline.entityId, role);
 	}
-	replaceCaptionSemanticRelations(draft, captionEntityId, voiceEntityId, scriptEntityId, startMs, durationMs) {
-		const removed = new Set(incidentRelations(draft, captionEntityId).filter((relation) => relation.relationKind === "caption-alignment" || relation.relationKind === "caption-composition").map((relation) => relation.relationId));
+	replaceCaptionAlignment(draft, captionEntityId, voiceEntityId, startMs, durationMs) {
+		const removed = new Set(incidentRelations(draft, captionEntityId).filter((relation) => relation.relationKind === "caption-alignment").map((relation) => relation.relationId));
 		draft.relations = draft.relations.filter((relation) => !removed.has(relation.relationId));
 		draft.relations.push(this.createRelation(draft, "caption-alignment", captionEntityId, voiceEntityId, { alignment: {
 			start: startMs,
 			end: startMs + durationMs
-		} }), this.createRelation(draft, "caption-composition", captionEntityId, scriptEntityId, { segmentAlignment: [] }));
+		} }));
 	}
 	/**
 	* Remove one placed Caption use. The composed AudioScript outlives the
@@ -1532,11 +1600,7 @@ var EntityTimelineEditor = class {
 		const topology = requireClipOnRole(draft, clipEntityId, "caption");
 		const caption = requireEntityKind(draft, otherEndpoint(topology.markerContentRelation, topology.marker.entityId), "caption");
 		const contentRelations = incidentRelations(draft, caption.entityId);
-		const allowed = new Set([
-			"caption-composition",
-			"caption-alignment",
-			"marker-content"
-		]);
+		const allowed = new Set(["caption-alignment", "marker-content"]);
 		const unsupported = contentRelations.filter((relation) => !allowed.has(relation.relationKind));
 		if (unsupported.length > 0) throw new Error(`Cannot delete Caption with unsupported Relation ${unsupported[0].relationId}`);
 		this.removeClipGraph(draft, clipEntityId);
@@ -1936,6 +2000,7 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 	const normalizedMainRanges = overlapNormalizedMainRanges(legacy);
 	let entities = structuredClone([...initial.entities]);
 	let relations = structuredClone([...initial.relations]);
+	const documentAudioScriptEntityId = ensureDocumentAudioScript(entities, idFactory);
 	const addEntity = (kind, payload, existingId) => {
 		const entityId = createEntityId(existingId ?? idFactory("entity"));
 		if (entities.some((row) => row.entityId === entityId)) fail(`Migration entity identity collision: ${entityId}`);
@@ -1998,7 +2063,7 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 			relations = [...imported.rows.relations];
 			contentByPartId.set(item.part_id, imported.contentEntityId);
 			const phonemeScript = speech.phoneme_script;
-			ensureSpeechPhoneticChain(imported.contentEntityId, speech.audio_script, typeof phonemeScript === "string" ? phonemeScript : void 0, entities, relations, addEntity, link);
+			ensureSpeechPhoneticChain(imported.contentEntityId, speech.audio_script, typeof phonemeScript === "string" ? phonemeScript : void 0, entities, relations, addEntity, link, documentAudioScriptEntityId);
 		} else if (part.bgm !== void 0) {
 			const bgm = part.bgm;
 			const fact = facts.get(bgm.origin_media_id);
@@ -2076,7 +2141,7 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 				const voice = contentByPartId.get(caption.speech_part_id);
 				const render = relations.find((relation) => relation.relationKind === "phonetic-script-render" && relation.endpoint0EntityId === voice);
 				const phonetic = entities.find((entity) => entity.entityId === render?.endpoint1EntityId);
-				const script = phonetic === void 0 ? void 0 : composedAudioScript(phonetic, entities, relations);
+				const script = phonetic === void 0 ? void 0 : composedAudioScript(phonetic, entities);
 				if (script === void 0) fail("Legacy Caption has no composed AudioScript");
 				const sourceText = scriptText(script);
 				const captionText = caption.text;
@@ -2097,10 +2162,10 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 					},
 					sampling: "native",
 					coordinateSpace: "milliseconds",
+					baseEntityIds: [script.entityId],
 					selections,
 					...caption.style === void 0 ? {} : { style: toEntityCaptionStyle(caption.style) }
 				});
-				link("caption-composition", content, script.entityId, { segmentAlignment: [] });
 				link("caption-alignment", content, voice, { alignment: {
 					start: caption.start_ms,
 					end: caption.start_ms + duration
@@ -2444,31 +2509,43 @@ function requirePart(document, partId) {
 	if (part === void 0) fail(`Placed Clip ${partId} has no part payload`);
 	return part;
 }
-function ensureSpeechPhoneticChain(voiceEntityId, audioScriptText, phonemeScript, entities, relations, addEntity, link) {
+function ensureSpeechPhoneticChain(voiceEntityId, audioScriptText, phonemeScript, entities, relations, addEntity, link, documentAudioScriptEntityId) {
 	const renders = relations.filter((relation) => relation.relationKind === "phonetic-script-render" && relation.endpoint0EntityId === voiceEntityId);
 	if (renders.length > 1) fail(`Voice ${voiceEntityId} has ambiguous PhoneticScript provenance`);
 	if (renders.length === 1) {
 		const phonetic = entities.find((entity) => entity.entityId === renders[0].endpoint1EntityId && entity.entityKind === "phonetic-script");
 		if (phonetic === void 0) fail(`Voice ${voiceEntityId} has a dangling PhoneticScript render`);
-		const script = composedAudioScript(phonetic, entities, relations);
+		const script = composedAudioScript(phonetic, entities);
 		if (script === void 0 || scriptText(script) !== audioScriptText) fail(`Voice ${voiceEntityId} conflicts with the legacy Speech script`);
 		return phonetic.entityId;
 	}
-	const script = addEntity("audio-script", { segments: [{
-		segmentId: "segment-0",
-		text: audioScriptText
-	}] });
-	const phonetic = addEntity("phonetic-script", phonemeScript === void 0 ? {} : { phonemeScript });
-	link("phonetic-script-composition", phonetic, script, { segmentAlignment: [] });
+	const script = entities.find((entity) => entity.entityId === documentAudioScriptEntityId);
+	if (script === void 0 || script.entityKind !== "audio-script") fail("Migration must carry the fixed document AudioScript");
+	const segments = script.payload.segments;
+	if (Array.isArray(segments) && segments.length > 0) {
+		if (scriptText(script) !== audioScriptText) fail(`Voice ${voiceEntityId} conflicts with the project AudioScript text`);
+	} else {
+		const scriptIndex = entities.findIndex((row) => row.entityId === script.entityId);
+		entities[scriptIndex] = {
+			...script,
+			payload: { segments: [{
+				segmentId: "segment-0",
+				text: audioScriptText
+			}] }
+		};
+	}
+	const phonetic = addEntity("phonetic-script", {
+		baseEntityIds: [script.entityId],
+		...phonemeScript === void 0 ? {} : { phonemeScript }
+	});
 	link("phonetic-script-render", voiceEntityId, phonetic);
 	return phonetic;
 }
-function composedAudioScript(phonetic, entities, relations) {
-	const edges = relations.filter((relation) => relation.relationKind === "phonetic-script-composition" && (relation.endpoint0EntityId === phonetic.entityId || relation.endpoint1EntityId === phonetic.entityId));
-	if (edges.length !== 1) return void 0;
-	const edge = edges[0];
-	const otherId = edge.endpoint0EntityId === phonetic.entityId ? edge.endpoint1EntityId : edge.endpoint0EntityId;
-	return entities.find((entity) => entity.entityId === otherId);
+function composedAudioScript(phonetic, entities) {
+	return findComposedAudioScript({
+		entities,
+		relations: []
+	}, phonetic.entityId, "phonetic-script");
 }
 function scriptText(script) {
 	const segments = script.payload.segments;
@@ -2558,6 +2635,82 @@ function fail(message) {
 	throw new EntityTimelineProjectionError(message);
 }
 //#endregion
+//#region src/entity-editor/caption-content.ts
+/** Author Caption content from semantic intent; callers never reconcile variant bases or assembled fields. */
+function prepareCaptionContent(rows, input) {
+	const entityId = createEntityId(input.contentEntityId);
+	const scriptId = createEntityId(input.audioScriptEntityId);
+	if (!Number.isFinite(input.durationMs) || input.durationMs <= 0) throw new Error("Caption duration must be positive");
+	const previous = rows.entities.find((row) => row.entityId === entityId);
+	if (previous !== void 0 && previous.entityKind !== "caption") throw new Error("Caption content identity has a different kind");
+	let baseEntityIds = [scriptId];
+	if (previous !== void 0) {
+		const source = assembleCaptionContent(rows, entityId).audioScript.entityId;
+		const bases = variantBaseEntityIds(previous);
+		if (source !== scriptId && !bases.includes(source)) throw new Error("Replacing an indirectly composed AudioScript requires an explicit composition change");
+		baseEntityIds = bases.map((id) => id === source ? scriptId : id);
+	}
+	const candidate = {
+		entityId,
+		entityKind: "caption",
+		payload: {
+			...previous?.payload,
+			baseEntityIds,
+			extent: previous?.payload.extent ?? {
+				kind: "bounded",
+				start: 0,
+				end: input.durationMs
+			},
+			sampling: previous?.payload.sampling ?? "native",
+			coordinateSpace: previous?.payload.coordinateSpace ?? "milliseconds"
+		}
+	};
+	const graph = {
+		...rows,
+		entities: [...rows.entities.filter((row) => row.entityId !== entityId), candidate]
+	};
+	const textSource = {
+		...assembleEntityContent(graph, entityId),
+		entityKind: "audio-script"
+	};
+	const selected = {
+		...candidate,
+		payload: {
+			...candidate.payload,
+			selections: structuredClone(input.selections ?? selectCaptionText(textSource, input.text))
+		}
+	};
+	if (assembleCaptionContent({
+		...graph,
+		entities: graph.entities.map((row) => row.entityId === entityId ? selected : row)
+	}, entityId).text !== input.text) throw new Error("Caption review text differs from its assembled variant content");
+	return selected;
+}
+function selectCaptionText(script, text) {
+	if (!text.trim()) throw new Error("Caption text selection must not be blank");
+	const source = script;
+	const fullText = assembleScriptText(source);
+	const segments = source.payload.segments;
+	if (text === fullText) return segments.map((segment) => ({ segmentId: segment.segmentId }));
+	const matches = [];
+	for (const segment of segments) {
+		let offset = segment.text.indexOf(text);
+		while (offset !== -1) {
+			const start = Array.from(segment.text.slice(0, offset)).length;
+			matches.push({
+				segmentId: segment.segmentId,
+				textRange: {
+					start,
+					end: start + Array.from(text).length
+				}
+			});
+			offset = segment.text.indexOf(text, offset + 1);
+		}
+	}
+	if (matches.length !== 1) throw new Error("Caption text must select a unique AudioScript range; provide explicit selections");
+	return matches;
+}
+//#endregion
 //#region src/editor/snapshot-utils.ts
 function isMap(value) {
 	return value instanceof Map;
@@ -4696,4 +4849,4 @@ function serverCovers(serverVV, target) {
 	return covers(server, target);
 }
 //#endregion
-export { DEFAULT_UNIT_TIME_MS, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, EntityGraphHttpClient, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, VideoDocumentValidationError, applyEntityTimelineProjection, arrangeMainTrackSeamlessly, assembleCaptionContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertMediaAssetWritePolicy, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, projectEntityTimeline, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveSpeechOverlapByShiftingVideos, safeDurationMs, schemas_exports as schemas, selectAudioScriptSegments, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema, writeVideoDocumentToDraft };
+export { DEFAULT_UNIT_TIME_MS, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, EntityGraphHttpClient, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, LoroEntityDocument, LoroEntityDraft, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, VideoDocumentValidationError, applyEntityRows, applyEntityTimelineProjection, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertMediaAssetWritePolicy, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveSpeechOverlapByShiftingVideos, safeDurationMs, schemas_exports as schemas, selectAudioScriptSegments, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema, writeVideoDocumentToDraft };

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { Ot as VideoDraft, c as MirrorVideoDocumentAdapter } from "./index-PYtGeXNk.js";
+import { c as MirrorVideoDocumentAdapter, kt as VideoDraft } from "./index-Bs60N9Hl.js";
 
 //#region src/testing/in-memory-mengine-server.d.ts
 /**

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { et as VIDEO_DOCUMENT_SCHEMA_VERSION, ot as base64ToBytes, s as createMirrorVideoDocumentAdapter, st as bytesToBase64 } from "./document-Bf200CmD.js";
+import { _t as bytesToBase64, gt as base64ToBytes, s as createMirrorVideoDocumentAdapter, ut as VIDEO_DOCUMENT_SCHEMA_VERSION } from "./document-BxWxPFTj.js";
 import { t as classifyUpdate } from "./loro-relay-doc-ssdYpuef.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "1.3.1-alpha.1",
+  "version": "1.3.1-alpha.10",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -24,12 +24,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@noble/hashes": "^2.4.0",
     "immer": "^10.2.0",
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/utils": "1.3.1-alpha.1",
-    "@mengine/storage": "1.3.1-alpha.1",
-    "@mengine/sync": "1.3.1-alpha.1"
+    "@mengine/storage": "1.3.1-alpha.10",
+    "@mengine/sync": "1.3.1-alpha.10",
+    "@mengine/utils": "1.3.1-alpha.10"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -39,8 +40,8 @@
     "typescript": "^6.0.3",
     "vite-plugin-wasm": "^3.6.0",
     "vite-plus": "^0.1.23",
-    "@mengine/medeo-dsl": "0.0.0",
-    "@mengine/idl-codegen": "0.0.0"
+    "@mengine/idl-codegen": "0.0.0",
+    "@mengine/medeo-dsl": "0.0.0"
   },
   "peerDependencies": {
     "loro-crdt": "^1.13.6"