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

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

@@ -1,5 +1,5 @@
 import { u as volumeSchema } from "./shared-iWnU2osE.js";
-import { Mirror, schema } from "loro-mirror";
+import { Mirror, schema, validateSchema } from "loro-mirror";
 import { z } from "zod";
 import { LoroDoc, LoroMap, LoroMovableList, LoroText, UndoManager } from "loro-crdt";
 import { sha256 } from "@noble/hashes/sha2.js";
@@ -7,9 +7,11 @@ import { bytesToHex } from "@noble/hashes/utils.js";
 import { produce } from "immer";
 //#region src/client/base64.ts
 function bytesToBase64(bytes) {
-	let binary = "";
-	for (const byte of bytes) binary += String.fromCharCode(byte);
-	return btoa(binary);
+	const native = bytes.toBase64;
+	if (typeof native === "function") return native.call(bytes);
+	const chunks = [];
+	for (let offset = 0; offset < bytes.length; offset += 8192) chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + 8192)));
+	return btoa(chunks.join(""));
 }
 function base64ToBytes(base64) {
 	const binary = atob(base64);
@@ -47,10 +49,6 @@ function base64ToBytes(base64) {
 *   value, last-writer-wins). The derived `fallback_abs_ms` snapshot sits beside
 *   it as its own number field — a separate LWW unit so a projection refresh
 *   never clobbers a `time_position` edit.
-* - meta lives in a `meta` LoroMap: the mirror root only accepts container
-*   schemas, so meta scalars can't sit at the root as bare values. The domain
-*   `VideoDocument` keeps the same `meta` wrapper, so the shapes are isomorphic
-*   and the read/seed mapping is a near-identity.
 * - `part_library` values are nested `LoroMap`s: the value is a `LoroMap` with
 *   four mutually-exclusive optional part sub-maps (`video_clip` / `speech` /
 *   `caption` / `bgm`), each a `LoroMap` whose fields are stored as real Loro
@@ -64,16 +62,10 @@ function base64ToBytes(base64) {
 *   as opaque JSON-blob sub-keys via `transform`. The four sub-keys are optional,
 *   so the "exactly one part kind" union invariant is not enforced by the schema
 *   type; it is rebuilt by `draftToPartUnion` on read and gated by zod on write.
-* - a caption's `style` is the one lazily-created optional child container, so
-*   `captionPart` sets `mergeableMapChildContainers: true` — two peers can
-*   concurrently first-create the same caption's `style` (one attribute each), and
-*   only a mergeable child converges instead of last-writer-wins dropping one. All
-*   other nested maps are keyed by a unique id (`part_library`) or created
-*   atomically with their parent (`partValue`'s part sub-map), so they never hit
-*   that concurrent-first-create fork and stay on plain `setContainer`. See the
-*   note on `captionPart` below.
-* - `video_creation_settings` is an opaque JSON blob carried in a string via
-*   `transform`: a whole value, last-writer-wins (no field-level concurrent edits).
+* - a caption's `style` is a mergeable child map for independent style fields.
+*   Creation paths materialize it with the caption, even when empty, so undoing
+*   a later style edit never removes the parent reference. Other nested maps
+*   keep their regular container identities from creation.
 */
 /**
 * JSON-blob transform for an opaque, last-writer-wins value carried in a Loro
@@ -154,16 +146,6 @@ const partValue = schema.LoroMap({
 	bgm: bgmPart
 });
 const videoDocumentMirrorSchema = schema({
-	meta: schema.LoroMap({
-		schema_version: schema.String({ required: false }),
-		draft_id: schema.String({ required: false }),
-		project_id: schema.String({ required: false }),
-		owner_id: schema.String({ required: false }),
-		thumbnail_storage_key: schema.String({ required: false }),
-		chat_session_id: schema.String({ required: false }),
-		video_creation_settings: schema.String({ required: false }).transform(jsonTransform()),
-		version: schema.Number({ required: false })
-	}),
 	timeline: schema.LoroMap({ unit_time_ms: schema.Number({ required: false }) }),
 	tracks: schema.LoroMovableList(track, (t) => t.id),
 	part_library: schema.LoroMapRecord(partValue)
@@ -213,9 +195,6 @@ function recordEntries(record) {
 }
 //#endregion
 //#region src/document/types.ts
-const VIDEO_DOCUMENT_SCHEMA_VERSION = "video-document/v0";
-/** A server-derived compatibility view, never an editor write authority. */
-const ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION = "video-document/entity-projection-v1";
 /** The linear speed multiplier of a `speed_shift`, defaulting to 1 (original). */
 function speedOf(speedShift) {
 	const speed = speedShift?.config?.linear?.speed;
@@ -549,12 +528,12 @@ function cascadeAfterVideoClipChanges(doc, makeEmptyPart) {
 * read-view: absolute time per item, `part_aggregations`, and total duration.
 * This is the read side of the single-directional flow — never written back.
 */
-function solveVideoDocument(document) {
+function solveVideoDocument(document, options = {}) {
 	const doc = videoDocumentToTimelineDoc(document);
 	let counter = 0;
 	const derivedFillerPartIds = /* @__PURE__ */ new Set();
-	if (document.meta.schema_version === "video-document/entity-projection-v1") {
-		for (const track of document.tracks ?? []) if (track.items?.some((item) => item.time_position.mode === "sequential" || item.time_position.mode === "anchored" && !Number.isSafeInteger(item.fallback_abs_ms))) throw new Error("An entity timeline projection must contain resolved placement facts");
+	if (options.placementResolved === true) {
+		assertResolvedPlacement(document);
 		recalculateTimelineDuration(doc);
 	} else cascadeAfterVideoClipChanges(doc, () => {
 		const partId = `empty_${counter++}`;
@@ -759,6 +738,19 @@ function ensureLaneTrack(draft, kind) {
 function findLaneTrack(draft, kind) {
 	return (draft.tracks ?? []).find((t) => t?.parts_kind === kind);
 }
+/**
+* Whether every item already states a position that can be read without running
+* the cascade: nothing `sequential`, and every `anchored` item carrying the
+* absolute landing its writer stamped. This is a verification predicate, not a
+* provenance test — see `SolveVideoDocumentOptions.placementResolved`.
+*/
+function hasResolvedPlacement(document) {
+	return (document.tracks ?? []).every((track) => (track.items ?? []).every((item) => item.time_position.mode !== "sequential" && (item.time_position.mode !== "anchored" || Number.isSafeInteger(item.fallback_abs_ms))));
+}
+/** A producer that claims resolved placement must actually have resolved it. */
+function assertResolvedPlacement(document) {
+	if (!hasResolvedPlacement(document)) throw new Error("An entity timeline projection must contain resolved placement facts");
+}
 //#endregion
 //#region src/document/zod-schema.ts
 const partKindSchema = z.enum([
@@ -859,18 +851,7 @@ const partUnionSchema = z.union([
 		"bgm"
 	].filter((k) => p[k] != null).length === 1;
 }, { message: "A part_library value must have exactly one of video_clip / speech / caption / bgm" });
-const videoDocumentMetaSchema = z.object({
-	schema_version: z.enum([VIDEO_DOCUMENT_SCHEMA_VERSION, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION]),
-	draft_id: z.string().optional(),
-	project_id: z.string().optional(),
-	owner_id: z.string().optional(),
-	thumbnail_storage_key: z.string().optional(),
-	chat_session_id: z.string().optional(),
-	video_creation_settings: z.unknown().optional(),
-	version: finiteNumber.optional()
-}).passthrough();
 const videoDocumentSchema = z.object({
-	meta: videoDocumentMetaSchema,
 	timeline: z.object({ unit_time_ms: finiteNumber.optional() }).passthrough().optional(),
 	tracks: z.array(trackSchema).optional(),
 	part_library: z.record(z.string(), partUnionSchema).optional()
@@ -1140,13 +1121,13 @@ function zodPath(path) {
 //#endregion
 //#region src/document/projection.ts
 /**
-* Projection between the authoritative `VideoDocument` and the legacy
-* `VideoDraft` read-view (RFC 02 §5/§7). Both directions live here:
+* Projection between authoritative `VideoDocument` and compatible content
+* layouts (RFC 02 §5/§7). Both directions live here:
 *
 * - `toVideoDocument` ingests a `VideoDraft`, deriving each item's `position`
 *   from the legacy absolute layout + aggregations; derived values (abs time,
 *   `part_aggregations`, total duration) are dropped.
-* - `fromVideoDocument` solves a `VideoDocument` back into a `VideoDraft` via the
+* - `fromVideoDocument` solves a `VideoDocument` into `VideoDraftContent` via the
 *   timeline-core cascade, re-deriving exactly those values.
 *
 * Business validation lives in `validation.ts`; `fromVideoDocument` asserts a
@@ -1177,16 +1158,6 @@ function toVideoDocument(draft) {
 		...(draft.below_main_tracks ?? []).map((t) => toTrack(t, false))
 	];
 	return {
-		meta: {
-			schema_version: VIDEO_DOCUMENT_SCHEMA_VERSION,
-			draft_id: draft.id,
-			project_id: draft.project_id,
-			owner_id: draft.owner_id,
-			thumbnail_storage_key: draft.thumbnail_storage_key,
-			chat_session_id: draft.chat_session_id,
-			video_creation_settings: clone$1(draft.video_creation_settings),
-			version: draft.version
-		},
 		timeline: draft.timeline == null ? void 0 : { unit_time_ms: draft.timeline.unit_time_ms },
 		tracks,
 		part_library: toAuthoritativePartLibrary(draft.part_library)
@@ -1206,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
@@ -1296,8 +1268,8 @@ function deriveItem(item, isMain, speechHost, partLibrary) {
 	};
 }
 /**
-* Project the authoritative `VideoDocument` back into the legacy `VideoDraft`
-* read-view, solving each item's absolute position, the `part_aggregations`, and
+* Project `VideoDocument` into `VideoDraftContent`, solving each item's
+* absolute position, the `part_aggregations`, and
 * the total duration via the timeline-core cascade.
 *
 * The read-view is a compatibility contract, and the IDL declares
@@ -1311,33 +1283,26 @@ function deriveItem(item, isMain, speechHost, partLibrary) {
 * These two are defaultable because the projection knows their values on its own:
 * absent `unit_time_ms` means "no display granularity was ever stated" and absent
 * `is_hidden` means "this track was never hidden". `version` is NOT defaultable
-* here — its only honest value is server state (`update_seq`) that a
-* `VideoDocument` cannot see, so it stays absent and the HTTP layer fills it.
+* here — it belongs to Director assembly using the server envelope update_seq.
+* Neither business metadata nor a revision counter belongs in content projection.
 */
-function fromVideoDocument(document) {
+function fromVideoDocument(document, options = {}) {
 	assertValidVideoDocument(document);
-	const view = solveVideoDocument(document);
+	const view = solveVideoDocument(document, options);
 	const tracks = document.tracks ?? [];
 	const mainTrack = tracks.find((t) => t.parts_kind === "video_clip");
 	const aboveTracks = tracks.filter((t) => t.parts_kind === "caption");
 	const belowTracks = tracks.filter((t) => t.parts_kind === "speech" || t.parts_kind === "bgm");
 	return {
-		id: document.meta.draft_id,
-		project_id: document.meta.project_id,
-		owner_id: document.meta.owner_id,
-		thumbnail_storage_key: document.meta.thumbnail_storage_key,
 		timeline: {
 			duration_ms: view.durationMs,
 			unit_time_ms: document.timeline?.unit_time_ms ?? 33.333
 		},
-		video_creation_settings: clone$1(document.meta.video_creation_settings),
-		chat_session_id: document.meta.chat_session_id,
 		main_track: draftTrack(mainTrack, view.absByPartId),
 		above_main_tracks: aboveTracks.map((t) => draftTrack(t, view.absByPartId)),
 		below_main_tracks: belowTracks.map((t) => draftTrack(t, view.absByPartId)),
 		part_aggregations: view.aggregations,
-		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds),
-		version: document.meta.version
+		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds)
 	};
 }
 /**
@@ -1444,7 +1409,7 @@ function clone$1(value) {
 //#region src/document/initial-document.ts
 /**
 * Build the `VideoDocument` a newly created project starts from: the caller's
-* project facts, no parts, and one empty track per lane.
+* no parts and one empty track per lane. Business facts remain in Director.
 *
 * The empty lane tracks are the reason this function exists rather than callers
 * assembling a document inline. Lane tracks are otherwise minted lazily by the
@@ -1465,18 +1430,8 @@ function clone$1(value) {
 * supplies, and total duration is derived on read (RFC 02 §6), so a new document
 * has no timeline fact to state.
 */
-function buildInitialVideoDocument(facts) {
+function buildInitialVideoDocument() {
 	return {
-		meta: {
-			schema_version: VIDEO_DOCUMENT_SCHEMA_VERSION,
-			draft_id: facts.draftId,
-			project_id: facts.projectId,
-			owner_id: facts.ownerId,
-			thumbnail_storage_key: void 0,
-			chat_session_id: facts.chatSessionId,
-			video_creation_settings: facts.videoCreationSettings,
-			version: void 0
-		},
 		timeline: void 0,
 		tracks: emptyLaneTracks(),
 		part_library: {}
@@ -1493,36 +1448,101 @@ function emptyLaneTracks() {
 }
 //#endregion
 //#region ../medeo-dsl/src/entities.ts
+/**
+* What every known entity kind declares.
+*
+* `kinds` is a multi-declaration: every entry holds at the same time, and each
+* is a property shared with other entity kinds — what the object *is* comes
+* from `entityKind` and is never repeated here. The order carries no priority,
+* endpoint role, or edit sequence — an operation asks whether the entity
+* declares the kind it needs, never what its "main type" is. An entity kind
+* that shares nothing declares nothing.
+*
+* `Caption` declares `Sequence` on purpose: it owns the display timing of the
+* one AudioScript segment it shows, which is what admits it into a Clip.
+* `Voice` declares no `Sequence` — it is a timbre identity, not playable
+* content; rendered speech is a `voiceover` entity.
+*
+* `MediaFile` 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([
+		"Container",
+		"Sequence",
+		"Visual",
+		"Audible"
+	]),
+	timeline: Object.freeze(["Container"]),
+	track: Object.freeze(["Container"]),
+	clip: Object.freeze(["Container"]),
+	asset: Object.freeze([]),
+	video: Object.freeze([
+		"Sequence",
+		"Visual",
+		"Audible",
+		"MediaFile"
+	]),
+	audio: Object.freeze([
+		"Sequence",
+		"Audible",
+		"MediaFile"
+	]),
+	voiceover: Object.freeze([
+		"Sequence",
+		"Audible",
+		"MediaFile"
+	]),
+	image: Object.freeze([
+		"Sequence",
+		"Visual",
+		"MediaFile"
+	]),
+	voice: Object.freeze(["Container", "IPBound"]),
+	"sequence-marker": Object.freeze([]),
+	viewport: Object.freeze([]),
+	"audio-script": Object.freeze(["SegmentText", "MediaFile"]),
+	"phonetic-script": Object.freeze(["SegmentText", "MediaFile"]),
+	caption: Object.freeze([
+		"SegmentText",
+		"Sequence",
+		"MediaFile"
+	])
+});
+/** What a known kind declares; extension kinds declare nothing through this table. */
+function kindsOf(entityKind) {
+	return isKnownEntityKind(entityKind) ? ENTITY_KINDS[entityKind] : [];
+}
+function declaresKind(entityKind, kind) {
+	return kindsOf(entityKind).includes(kind);
+}
+/**
+* Sequence admission is a declaration, not a shape: a known kind is admitted
+* because its `kinds` say so, and a malformed payload is a separate, louder
+* failure than a silently non-Sequence entity. Extension kinds declare nothing
+* through the table and stay structurally detected.
+*/
 function hasSequence(entity) {
-	if (isKnownNonSequenceKind(entity.entityKind) || isReservedEntityKind(entity.entityKind)) return false;
+	if (isReservedEntityKind(entity.entityKind)) return false;
+	if (isKnownEntityKind(entity.entityKind)) return declaresKind(entity.entityKind, "Sequence");
 	return isSequenceFields(entity);
 }
 function isSequenceFields(value) {
 	if (!isRecord$1(value)) return false;
-	const extent = value.extent;
-	if (!isRecord$1(extent) || !("start" in extent) || extent.start === void 0) return false;
-	if (extent.kind === "bounded" && (!("end" in extent) || extent.end === void 0)) return false;
-	if (extent.kind === "unbounded" && "end" in extent) return false;
-	if (extent.kind !== "bounded" && extent.kind !== "unbounded") return false;
-	if (value.sampling !== "native" && value.sampling !== "constant" && value.sampling !== "derived") return false;
-	return "coordinateSpace" in value && value.coordinateSpace !== void 0;
-}
-function isKnownSequenceKind(kind) {
-	return isMediaAssetVariantKind(kind) || kind === "caption" || kind === "axvideo";
+	const duration = value.durationMs;
+	return duration === null || typeof duration === "number" && Number.isSafeInteger(duration) && duration > 0;
 }
 function isMediaAssetVariantKind(kind) {
-	return kind === "video" || kind === "image" || kind === "audio" || kind === "voice";
+	return kind === "video" || kind === "image" || kind === "audio" || kind === "voiceover";
 }
 function isKnownEntityKind(kind) {
-	return isKnownSequenceKind(kind) || isKnownNonSequenceKind(kind);
+	return Object.hasOwn(ENTITY_KINDS, kind);
 }
 function isReservedEntityKind(kind) {
 	const normalized = kind.toLowerCase().replaceAll("-", "").replaceAll("_", "");
 	return normalized === "speech" || normalized === "videodocument";
 }
-function isKnownNonSequenceKind(kind) {
-	return kind === "timeline" || kind === "track" || kind === "clip" || kind === "asset" || kind === "sequence-marker" || kind === "viewport" || kind === "audio-script" || kind === "phonetic-script";
-}
 function isRecord$1(value) {
 	return typeof value === "object" && value != null && !Array.isArray(value);
 }
@@ -1706,14 +1726,17 @@ function assembleCaptionContent(rows, captionEntityId) {
 	requireEntityKind(rows, captionEntityId, "caption");
 	const caption = assembleEntityContent(rows, captionEntityId);
 	const script = findComposedAudioScript(rows, captionEntityId, "caption");
-	const segment = selectAudioScriptSegment({
+	const selection = captionSelection(caption);
+	const composed = {
 		...script,
 		payload: caption.payload
-	}, captionSelection(caption));
+	};
+	const segment = selectAudioScriptSegment(composed, selection);
 	return {
 		caption,
 		audioScript: script,
 		segments: [segment],
+		segmentIndex: scriptSegments(composed).findIndex((entry) => entry.segmentId === selection.segmentId),
 		text: segment.text
 	};
 }
@@ -1781,18 +1804,7 @@ function entityToRow(entity) {
 }
 //#endregion
 //#region ../medeo-dsl/src/invariants.ts
-/**
-* Media variants own their Asset identity directly: a `physical-asset`
-* Relation may not bind them. Caption may associate with a physical text Asset
-* independently of its AudioScript composition.
-*/
-function validateMediaAssetIdentity(entity, index) {
-	return [...index.relationsOf(entity)].filter((relation) => relation.kind === "physical-asset").map(() => ({
-		code: "media_physical_asset_forbidden",
-		entityId: entity.entityId,
-		message: `Media entity "${entity.entityId}" owns its Asset identity; remove its physical-asset Relation`
-	}));
-}
+/** An entity is made from at most one Asset; two would leave its bytes ambiguous. */
 /** Validates one complete set of entities and its authoritative Relation rows. */
 function validateEntityRelationSet(entityRefs, index, options) {
 	const { entities, issues } = collectRelatedEntities(entityRefs, index);
@@ -1814,7 +1826,6 @@ function validateEntityRelationSet(entityRefs, index, options) {
 		const current = entity.current();
 		const entityIssues = validateEntity(entity, entityIds);
 		issues.push(...entityIssues);
-		if (isMediaAssetVariantKind(current.entityKind)) issues.push(...validateMediaAssetIdentity(entity, index));
 		if (entityIssues.some((issue) => issue.code === "invalid_entity_payload")) continue;
 		if (current.entityKind === "sequence-marker") {
 			const marker = entity;
@@ -2039,24 +2050,25 @@ function validateMarkerSourceBounds(marker, index, compare) {
 	const content = contentEdges[0]?.other(marker)?.deref()?.current();
 	if (content == null || !hasSequence(content)) return [];
 	const sourceRange = marker.current().sourceRange;
-	const startVsExtent = compare(sourceRange.start, content.extent.start);
-	const endVsExtent = content.extent.kind === "bounded" ? compare(sourceRange.end, content.extent.end) : void 0;
-	if (!Number.isNaN(startVsExtent) && startVsExtent >= 0 && (endVsExtent == null || !Number.isNaN(endVsExtent) && endVsExtent <= 0)) return [];
+	const startVsOrigin = compare(sourceRange.start, 0);
+	const endVsDuration = content.durationMs == null ? void 0 : compare(sourceRange.end, content.durationMs);
+	if (!Number.isNaN(startVsOrigin) && startVsOrigin >= 0 && (endVsDuration == null || !Number.isNaN(endVsDuration) && endVsDuration <= 0)) return [];
 	return [{
 		code: "marker_source_out_of_bounds",
 		entityId: marker.entityId,
-		message: `Sequence Marker sourceRange must stay within content "${content.entityId}" extent`
+		message: `Sequence Marker sourceRange must stay within content "${content.entityId}" duration`
 	}];
 }
 function validateSequenceComposition(entity) {
 	const current = entity.current();
-	const expected = expectedSequenceShape(current.entityKind);
-	if (expected == null) return [];
-	if (hasSequence(current) && current.extent.kind === expected.extent && current.sampling === expected.sampling) return [];
+	const expected = expectedDurationShape(current.entityKind);
+	if (expected === void 0) return [];
+	const duration = current.durationMs;
+	if ((duration === null ? "none" : isPositiveInteger(duration) ? "own" : "invalid") === expected) return [];
 	return [{
 		code: "invalid_sequence_composition",
 		entityId: current.entityId,
-		message: `${current.entityKind} must compose ${expected.extent} / ${expected.sampling} Sequence semantics`
+		message: expected === "own" ? `${current.entityKind} must state its own durationMs in whole milliseconds` : `${current.entityKind} has no intrinsic length; durationMs must be null`
 	}];
 }
 function validateEntity(entity, entityIds = /* @__PURE__ */ new Set()) {
@@ -2087,6 +2099,7 @@ function validateKnownEntityPayload(entity) {
 	if (value.lifecycle !== void 0 && !isRecord(value.lifecycle)) problems.push("lifecycle must be an object when present");
 	if (entity.entityKind === "audio-script" || entity.entityKind === "phonetic-script") {
 		for (const key of [
+			"durationMs",
 			"extent",
 			"sampling",
 			"coordinateSpace",
@@ -2095,7 +2108,7 @@ function validateKnownEntityPayload(entity) {
 			"duration",
 			"startMs",
 			"endMs"
-		]) if (Object.hasOwn(value, key)) problems.push(`${key} is not intrinsic script data; assign an external annotation Marker`);
+		]) if (Object.hasOwn(value, key)) problems.push(`${key} is not intrinsic script data; assign an annotation Marker instead`);
 	}
 	switch (entity.entityKind) {
 		case "track":
@@ -2105,19 +2118,25 @@ function validateKnownEntityPayload(entity) {
 			break;
 		case "video":
 		case "audio":
-		case "voice":
+			validateDurationPayload(value, "own", problems);
+			break;
 		case "caption":
-			validateSequencePayload(value, "bounded", "native", problems);
-			if (entity.entityKind !== "caption") validateMediaAssetFields(value, problems);
-			if (entity.entityKind === "voice") validateVoicePayload(value, problems);
-			if (entity.entityKind === "caption") validateCaptionPayload(value, problems);
+			validateDurationPayload(value, "own", problems);
+			validateCaptionPayload(value, problems);
+			break;
+		case "voice":
+			validateVoicePayload(value, problems);
 			break;
 		case "image":
-			validateSequencePayload(value, "unbounded", "constant", problems);
-			validateMediaAssetFields(value, problems);
+			validateDurationPayload(value, "none", problems);
 			break;
 		case "axvideo":
-			validateSequencePayload(value, "bounded", "derived", problems);
+			for (const retired of [
+				"extent",
+				"sampling",
+				"coordinateSpace",
+				"durationMs"
+			]) if (Object.hasOwn(value, retired)) problems.push(`${retired} is derived from the Timeline, not stored`);
 			break;
 		case "sequence-marker":
 			validateMarkerPayload(value, problems);
@@ -2142,17 +2161,27 @@ function validateKnownEntityPayload(entity) {
 	}
 	return problems;
 }
-function validateSequencePayload(value, expectedExtent, expectedSampling, problems) {
-	const extent = value.extent;
-	if (!isRecord(extent)) problems.push("extent must be an object");
-	else {
-		if (extent.kind !== expectedExtent) problems.push(`extent.kind must be "${expectedExtent}"`);
-		if (!Object.hasOwn(extent, "start") || extent.start === void 0) problems.push("extent.start is required");
-		if (expectedExtent === "bounded" && (!Object.hasOwn(extent, "end") || extent.end === void 0)) problems.push("extent.end is required for bounded sequences");
-		if (expectedExtent === "unbounded" && Object.hasOwn(extent, "end")) problems.push("extent.end is forbidden for unbounded sequences");
+/**
+* Content states its own length and nothing else. The retired `extent` carried
+* a start as well, which had no meaning of its own and drifted into holding a
+* position; rejecting it keeps that mistake unwritable.
+*/
+function validateDurationPayload(value, expected, problems) {
+	for (const retired of [
+		"extent",
+		"sampling",
+		"coordinateSpace"
+	]) if (Object.hasOwn(value, retired)) problems.push(`${retired} is retired; state durationMs instead`);
+	if (!Object.hasOwn(value, "durationMs")) {
+		problems.push("durationMs is required");
+		return;
 	}
-	if (value.sampling !== expectedSampling) problems.push(`sampling must be "${expectedSampling}"`);
-	if (!Object.hasOwn(value, "coordinateSpace") || value.coordinateSpace === void 0) problems.push("coordinateSpace is required");
+	const duration = value.durationMs;
+	if (expected === "none") {
+		if (duration !== null) problems.push("durationMs must be null; this content has no intrinsic length");
+		return;
+	}
+	if (!isPositiveInteger(duration)) problems.push("durationMs must be positive whole milliseconds");
 }
 function validateMarkerPayload(value, problems) {
 	validateRange(value.sourceRange, "sourceRange", true, problems);
@@ -2188,40 +2217,38 @@ function validateSegmentRanges(value, problems) {
 		if (typeof entry.startMs === "number" && Number.isFinite(entry.startMs) && typeof entry.endMs === "number" && Number.isFinite(entry.endMs) && entry.startMs > entry.endMs) problems.push(`segmentRanges[${index}].startMs must not exceed segmentRanges[${index}].endMs`);
 	}
 }
+/** The Asset entity is the locator; it states where the bytes live and nothing else. */
 function validateAssetPayload(value, problems) {
-	validateExternalLocator(value, problems);
-	validateStorageKey(value, problems);
+	if (value.system !== "memota" && value.system !== "memota-speech") problems.push("system must be \"memota\" or \"memota-speech\"");
+	if (typeof value.key !== "string" || value.key.trim() === "") problems.push("key must be a non-empty string");
 	if (value.inline !== void 0) problems.push("inline is not a physical location; text is domain content owned by its AudioScript");
-}
-/**
-* Media variants own their Asset locator directly: `external` is required and
-* textual domain content is owned by AudioScript; the physical-location
-* vocabularies cannot mix.
-*/
-function validateMediaAssetFields(value, problems) {
-	if (value.external === void 0) problems.push("external is required; media variants own their Asset identity");
-	else validateExternalLocator(value, problems);
 	validateStorageKey(value, problems);
-	if (value.inline !== void 0) problems.push("media variants use external locators, not inline domain text");
-}
-function validateExternalLocator(value, problems) {
-	const external = value.external;
-	if (external === void 0) return;
-	if (!isRecord(external)) {
-		problems.push("external must be an object when present");
-		return;
-	}
-	if (external.system !== "memota" && external.system !== "memota-speech") problems.push("external.system must be \"memota\" or \"memota-speech\"");
-	if (typeof external.key !== "string" || external.key.trim() === "") problems.push("external.key must be a non-empty string");
 }
 function validateStorageKey(value, problems) {
 	if (value.storageKey !== void 0 && (typeof value.storageKey !== "string" || value.storageKey.trim() === "")) problems.push("storageKey must be a non-empty string when present");
 }
+/**
+* Voice is a timbre identity, not playable content: it owns the voice-library
+* descriptor and nothing that would make it look like media or a Sequence. The
+* rendered voiceover is an `audio` entity bound by a `voice-timbre` Relation.
+*/
 function validateVoicePayload(value, problems) {
+	for (const key of [
+		"durationMs",
+		"extent",
+		"sampling",
+		"coordinateSpace",
+		"system",
+		"key",
+		"storageKey"
+	]) if (Object.hasOwn(value, key)) problems.push(`${key} belongs to the rendered Audio, not to the Voice identity`);
 	const voice = value.voice;
-	if (voice === void 0) return;
+	if (voice === void 0) {
+		problems.push("voice is required; a Voice entity is its voice-library identity");
+		return;
+	}
 	if (!isRecord(voice)) {
-		problems.push("voice must be an object when present");
+		problems.push("voice must be an object");
 		return;
 	}
 	if (voice.system !== "voice-library") problems.push("voice.system must be \"voice-library\"");
@@ -2229,7 +2256,6 @@ function validateVoicePayload(value, problems) {
 	if (voice.name !== void 0 && typeof voice.name !== "string") problems.push("voice.name must be a string when present");
 }
 function validateCaptionPayload(value, problems) {
-	validateExternalLocator(value, problems);
 	if (value.segmentRanges !== void 0) validateSegmentRanges(value.segmentRanges, problems);
 	if (Object.hasOwn(value, "selections")) problems.push("selections is forbidden; Caption requires one selection object");
 	const selection = value.selection;
@@ -2353,15 +2379,13 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 	if ([
 		"video",
 		"audio",
-		"voice",
 		"image",
 		"caption",
 		"axvideo"
-	].includes(entityKind) && /^(?:sampling|coordinateSpace|coordinateSpace\.unit|extent\.kind)$/.test(path)) return true;
+	].includes(entityKind) && /^durationMs$/.test(path)) return true;
 	if (entityKind === "sequence-marker" && /^(?:durationPolicy|duration\.mode|timeRemapping\.(?:kind|mode))$/.test(path)) return true;
 	if ((entityKind === "sequence-marker" || entityKind === "caption") && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
-	if (entityKind === "asset" && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
-	if (isMediaAssetVariantKind(entityKind) && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
+	if (entityKind === "asset" && /^(?:system|key|storageKey)$/.test(path)) return true;
 	if (entityKind === "voice" && /^voice\.(?:system|key|name)$/.test(path)) return true;
 	if (entityKind === "caption" && (path.startsWith("style.") || path === "selection.segmentId")) return true;
 	if ([
@@ -2416,19 +2440,16 @@ function collectRelatedEntities(entityRefs, index) {
 		issues
 	};
 }
-function expectedSequenceShape(kind) {
-	if (kind === "video" || kind === "audio" || kind === "voice" || kind === "caption") return {
-		extent: "bounded",
-		sampling: "native"
-	};
-	if (kind === "image") return {
-		extent: "unbounded",
-		sampling: "constant"
-	};
-	if (kind === "axvideo") return {
-		extent: "bounded",
-		sampling: "derived"
-	};
+/**
+* What a kind must state about its own length. An AXVideo is absent here on
+* purpose: its Timeline decides its length, so it stores none.
+*/
+function expectedDurationShape(kind) {
+	if (kind === "video" || kind === "audio" || kind === "caption") return "own";
+	if (kind === "image") return "none";
+}
+function isPositiveInteger(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
 }
 function ofKind(relations, kind) {
 	return relations.filter((relation) => relation.kind === kind);
@@ -2445,9 +2466,38 @@ const markerContentRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => hasMarkerAndSequence(endpoints),
 	validateMetadata: isEmptyMetadata
 });
-const physicalAssetRelationSpec = Object.freeze({
-	kind: "physical-asset",
-	validateEndpoints: (endpoints) => hasAssetAndSequence(endpoints),
+/**
+* `from-asset(entity, asset)` — the entity was made from that stored resource.
+*
+* Eligibility is declared: the non-Asset endpoint must carry the `MediaFile` 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({
+	kind: "from-asset",
+	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. */
@@ -2458,7 +2508,7 @@ const generatedRelationSpec = Object.freeze({
 });
 const captionAlignmentRelationSpec = Object.freeze({
 	kind: "caption-alignment",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["audio", "voice"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["voiceover"])),
 	validateMetadata: isCaptionAlignmentMetadata
 });
 /** `clip-anchor(child, host)` means endpoint 0 follows endpoint 1. */
@@ -2467,10 +2517,27 @@ const clipAnchorRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => endpoints[0].current().entityKind === "clip" && endpoints[1].current().entityKind === "clip",
 	validateMetadata: isEmptyMetadata
 });
-/** Voice is generated from PhoneticScript; kinds determine roles regardless of endpoint positions. */
+/**
+* The Voiceover and the PhoneticScript it was spoken from; kinds determine
+* roles regardless of endpoint positions.
+*
+* Every Voiceover must carry one: which words were said, and how, is the only
+* thing that makes speech reproducible, and a Voiceover that cannot answer it
+* is refused when its plan is built.
+*/
 const phoneticScriptRenderRelationSpec = Object.freeze({
 	kind: "phonetic-script-render",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voice"]), new Set(["phonetic-script"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voiceover"]), new Set(["phonetic-script"])),
+	validateMetadata: isEmptyMetadata
+});
+/**
+* The timbre identity a Voiceover was synthesized with. Voice stays an
+* identity: it never carries the audio itself, so the link between the two is a
+* Relation rather than one shared entity, and several takes can name one voice.
+*/
+const voiceTimbreRelationSpec = Object.freeze({
+	kind: "voice-timbre",
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voiceover"]), new Set(["voice"])),
 	validateMetadata: isEmptyMetadata
 });
 /** AudioScript was transcribed from Audio, Video, or recorded Voice; kinds determine roles. */
@@ -2478,8 +2545,8 @@ const audioScriptSourceRelationSpec = Object.freeze({
 	kind: "audio-script-source",
 	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["audio-script"]), new Set([
 		"audio",
-		"video",
-		"voice"
+		"voiceover",
+		"video"
 	])),
 	validateMetadata: isEmptyMetadata
 });
@@ -2502,11 +2569,13 @@ const builtInRelationSpecs = Object.freeze([
 	markerContentRelationSpec,
 	axVideoMarkerRelationSpec,
 	markerTimelineRelationSpec,
-	physicalAssetRelationSpec,
+	fromAssetRelationSpec,
+	toAssetRelationSpec,
 	generatedRelationSpec,
 	captionAlignmentRelationSpec,
 	clipAnchorRelationSpec,
 	phoneticScriptRenderRelationSpec,
+	voiceTimbreRelationSpec,
 	audioScriptSourceRelationSpec,
 	audioScriptMarkerRelationSpec
 ]);
@@ -2530,13 +2599,15 @@ function hasMarkerAndSequence(endpoints) {
 	const second = endpoints[1].current();
 	return first.entityKind === "sequence-marker" && hasSequence(second) || second.entityKind === "sequence-marker" && hasSequence(first);
 }
-function hasAssetAndSequence(endpoints) {
-	const first = endpoints[0].current();
-	const second = endpoints[1].current();
-	return first.entityKind === "asset" && hasSequence(second) || second.entityKind === "asset" && hasSequence(first);
+/** 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], "MediaFile");
 }
 function isGeneratedMedia(entity) {
-	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio" || entity.entityKind === "voice";
+	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio" || entity.entityKind === "voiceover";
 }
 function isEmptyMetadata(value) {
 	return isJsonObject(value) && Object.keys(value).length === 0;
@@ -2725,7 +2796,6 @@ var InvalidEntityRelationRowsError = class extends Error {
 		this.name = "InvalidEntityRelationRowsError";
 	}
 };
-/** Decodes database rows into flat entities and validates the complete relation set. */
 function decodeEntityRelationRows(rows, options) {
 	const issues = [];
 	const entitiesById = /* @__PURE__ */ new Map();
@@ -2966,9 +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" ? ["voice"] : typedRole === "caption" ? ["caption"] : ["audio"]).includes(content.entityKind)) fail(`unsupported compatibility content kind ${content.entityKind} on ${typedRole} Track`);
-			const space = content.payload.coordinateSpace;
-			if (space !== "ms" && space !== "milliseconds" && (!object(space) || space.unit !== "ms" && space.unit !== "milliseconds")) fail(`media ${content.entityId} must state millisecond coordinates for this reader`);
+			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`);
@@ -3045,7 +3113,7 @@ function resolveGraphLayout(graph) {
 		let start = fact.absoluteStart ?? 0;
 		if (fact.mode === "anchored") {
 			const host = resolve(fact.anchorId);
-			if (fact.role === "speech" && !["video_clip", "bgm"].includes(facts.get(host.clipEntityId).role)) fail("An anchored Voice must use a visual or BGM Clip as its host");
+			if (fact.role === "speech" && !["video_clip", "bgm"].includes(facts.get(host.clipEntityId).role)) fail("An anchored voiceover must use a visual or BGM Clip as its host");
 			start = host.start + fact.anchorOffset;
 		} else if (fact.predecessor !== void 0) {
 			const prior = resolve(fact.predecessor);
@@ -3087,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
 /**
@@ -3094,7 +3188,7 @@ function resolveGraphLayout(graph) {
 * consulted as an editing fact. Peer IDs appear only in this derived read
 * contract, reconstructed from relations; they are not stored in payloads.
 */
-function projectEntityTimeline(rows, meta) {
+function projectEntityTimeline(rows) {
 	const graph = new EntityProjectionGraph(rows);
 	const layout = resolveGraphLayout(graph);
 	for (const track of layout.tracks) {
@@ -3128,17 +3222,21 @@ function projectEntityTimeline(rows, meta) {
 		} else if (track.role === "speech") {
 			const asset = mediaAssetFacts(graph, content);
 			requireUntrimmedAudio(content, marker, placement);
-			const external = externalLocator(asset, "memota-speech");
-			const assembled = graph.adjacent(content.entityId, "phonetic-script-render").length > 0 || content.payload.voice !== void 0 ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
-			const voice = content.payload.voice;
+			const timbreEdges = graph.adjacent(content.entityId, "voice-timbre");
+			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) ? {
@@ -3146,7 +3244,8 @@ function projectEntityTimeline(rows, meta) {
 					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;
@@ -3171,8 +3270,7 @@ function projectEntityTimeline(rows, meta) {
 			if (marker.payload.durationPolicy !== "timeline") fail("Background Audio requires an explicit timeline-fill durationPolicy");
 			if (marker.payload.timeRemapping !== void 0) fail("BGM timeRemapping is not supported by this reader");
 			const source = range(marker.payload.sourceRange, "sourceRange");
-			const extent = content.payload.extent;
-			if (!object(extent) || extent.start !== source.start || extent.end !== source.end) fail("Background Audio compatibility requires the complete source");
+			if (source.start !== 0 || content.payload.durationMs !== source.end) fail("Background Audio compatibility requires the complete source");
 			parts[clip.entityId] = { bgm: {
 				id: clip.entityId,
 				kind: "bgm",
@@ -3183,10 +3281,6 @@ function projectEntityTimeline(rows, meta) {
 		}
 	}
 	const document = {
-		meta: {
-			...structuredClone(meta),
-			schema_version: ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION
-		},
 		timeline: graph.timeline.payload.unit_time_ms === void 0 ? void 0 : { unit_time_ms: positive(graph.timeline.payload.unit_time_ms, "unit_time_ms") },
 		tracks: layout.tracks.map((track) => ({
 			id: track.entityId,
@@ -3216,29 +3310,26 @@ function projectEntityTimeline(rows, meta) {
 function trackRoleOf(layout, trackEntityId) {
 	return layout.tracks.find((track) => track.entityId === trackEntityId)?.role;
 }
-/**
-* Media facts are read from the variant itself: a media variant owns its
-* Asset identity and carries `external`/`storageKey` directly. Dual-entity
-* media graphs are rejected instead of being resolved through a legacy
-* `physical-asset` binding.
-*/
+/** The Asset a media entity was made from; the bytes are named there alone. */
 function mediaAssetFacts(graph, content) {
-	if (graph.adjacent(content.entityId, "physical-asset").length > 0) fail("Media " + content.entityId + " owns its Asset identity; remove its physical-asset Relation");
-	if (!object(content.payload.external)) fail("Media " + content.entityId + " must carry its own Asset external identity");
+	const asset = graph.one(content.entityId, "from-asset", "asset");
 	return {
-		entityId: String(content.entityId),
-		payload: content.payload
+		entityId: String(asset.entityId),
+		payload: asset.payload
 	};
 }
-function externalLocator(asset, system) {
-	const value = asset.payload.external;
-	if (!object(value) || value.system !== system || typeof value.key !== "string" || value.key.trim() === "") fail("Asset " + asset.entityId + " requires an explicit " + system + " external key");
-	return { key: value.key };
-}
 function storageKey(asset) {
 	if (typeof asset.payload.storageKey !== "string" || asset.payload.storageKey.trim() === "") fail("Asset " + asset.entityId + " requires its factual storageKey");
 	return asset.payload.storageKey;
 }
+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,
+		system
+	};
+}
 function captionStyle(value) {
 	if (value === void 0) return void 0;
 	if (!object(value)) fail("Caption style must be an object");
@@ -3270,8 +3361,7 @@ function captionStyle(value) {
 }
 function requireUntrimmedAudio(content, marker, placement) {
 	const source = range(marker.payload.sourceRange, "sourceRange");
-	const extent = content.payload.extent;
-	if (!object(extent) || extent.start !== source.start || extent.end !== source.end || placement.duration !== source.end - source.start || marker.payload.timeRemapping !== void 0) fail("Voice compatibility requires the complete, unremapped take");
+	if (source.start !== 0 || content.payload.durationMs !== source.end || placement.duration !== source.end || marker.payload.timeRemapping !== void 0) fail("Voiceover compatibility requires the complete, unremapped take");
 }
 function videoSpeed(content, marker, placement) {
 	const remapping = marker.payload.timeRemapping;
@@ -3329,12 +3419,11 @@ const atomicFields = new Set([
 	"sourceRange",
 	"targetRange",
 	"duration",
-	"extent",
+	"durationMs",
 	"timeRemapping",
 	"textRange",
 	"selection",
-	"external",
-	"coordinateSpace"
+	"external"
 ]);
 const textFields = new Set(["text", "phonemeScript"]);
 const orderedFields = new Set([
@@ -3561,6 +3650,73 @@ function applyNativeListChange(list, change) {
 	}
 }
 //#endregion
+//#region src/entity-crdt/audio-script-assets.ts
+/** A resource is a snapshot of text; the native Loro text remains the editing authority. */
+function audioScriptAssetContent(payload) {
+	assembleScriptText({
+		entityId: createEntityId("script-validation"),
+		entityKind: "audio-script",
+		payload
+	});
+	return { segments: structuredClone(payload.segments) };
+}
+function audioScriptAssetHash(payload) {
+	return bytesToHex(sha256(new TextEncoder().encode(canonicalJson(audioScriptAssetContent(payload)))));
+}
+/**
+* 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) {
+	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");
+}
+/** Internal fingerprint prevents a resource from silently describing an older text revision. */
+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. */
 function entityOrderGroups(rows) {
@@ -3816,6 +3972,29 @@ 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);
+	}
 	getVersion(id) {
 		const entity = section(this.doc, "entities").get(id);
 		if (!isJsonObject(entity)) return void 0;
@@ -3856,6 +4035,52 @@ var LoroEntityDocument = class LoroEntityDocument {
 		materialize(this.doc);
 		this.doc.commit({ origin: MATERIALIZE_ORIGIN });
 	}
+	/**
+	* 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 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);
+		const map = workspace(this.doc, key);
+		if (map.get("kind") !== "audio-script" || map.get("deleted") === true) throw new Error("Resource binding requires an active AudioScript");
+		const payload = entityContent(this.doc, key);
+		if (audioScriptAssetHash(payload) !== expectedContentHash) throw new Error("AudioScript changed while saving its resource");
+		if (!assetId.trim()) throw new Error("AudioScript resource writer returned an empty asset ID");
+		const before = this.doc.oplogVersion();
+		const existing = readEntityDocument(this.doc, true).rows.entities.find((row) => row.entityKind === "asset" && row.payload.system === "memota" && row.payload.key === assetId);
+		const assetEntityId = existing?.entityId ?? createEntityId(`asset_${assetId}`);
+		if (existing === void 0) this.transact((draft) => draft.create({
+			entityId: assetEntityId,
+			entityKind: "asset",
+			payload: {
+				system: "memota",
+				key: assetId
+			}
+		}));
+		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 === "to-asset" && (String(relation.endpoint0EntityId) === String(entityId) || String(relation.endpoint1EntityId) === String(entityId))) draft.unlink(String(relation.relationId));
+				draft.link({
+					relationId: createRelationId(`relation_to-asset_${entityId}_${assetId}`),
+					relationKind: "to-asset",
+					endpoint0EntityId: createEntityId(entityId),
+					endpoint1EntityId: assetEntityId,
+					metadata: {},
+					trace: {}
+				});
+			}
+			draft.declare(entityId, audioScriptAssetFields(payload));
+		});
+		return this.doc.export({
+			mode: "update",
+			from: before
+		});
+	}
 	canUndo() {
 		return this.undoManager.canUndo();
 	}
@@ -3869,12 +4094,12 @@ var LoroEntityDocument = class LoroEntityDocument {
 		return this.historyEdit(() => this.undoManager.redo());
 	}
 	historyEdit(run) {
-		const before = this.snapshot();
+		const before = new Map(this.snapshot().rows.entities.map((row) => [family(this.doc, row.entityId), row]));
 		if (!run()) return false;
 		const after = this.snapshot();
 		for (const row of after.rows.entities) {
 			const id = family(this.doc, row.entityId);
-			const previous = before.rows.entities.find((item) => family(this.doc, item.entityId) === id);
+			const previous = before.get(id);
 			if (previous && !equalJson(owned(previous.payload), owned(row.payload))) workspace(this.doc, id).ensureMergeableMap("changes").set(globalThis.crypto.randomUUID(), true);
 		}
 		materialize(this.doc);
@@ -4197,8 +4422,8 @@ function assertState(state) {
 	const ids = new Set(state.rows.entities.map((row) => String(row.entityId)));
 	for (const row of state.rows.relations) if (!ids.has(row.endpoint0EntityId) || !ids.has(row.endpoint1EntityId)) throw new Error("Relation has a missing endpoint");
 }
-function materialize(doc) {
-	const state = readEntityDocument(doc);
+function materialize(doc, allowSelectionConflicts = false) {
+	const state = readEntityDocument(doc, allowSelectionConflicts);
 	const byId = section(doc, "entities");
 	const ids = currentIds(doc);
 	for (const [source, id] of ids) {
@@ -4219,13 +4444,37 @@ function materialize(doc) {
 	for (const [slot, id] of Object.entries(state.project)) if (project.get(slot) !== id) project.set(slot, id);
 }
 //#endregion
+//#region src/document/document-mutation-guard.ts
+/**
+* @internal
+* Shared by synchronous mutation entry points for one document. The session
+* closes it before teardown callbacks can attempt another write.
+*/
+var DocumentMutationGuard = class {
+	running = false;
+	closed = false;
+	run(mutation) {
+		if (this.closed) throw new Error("mengine document is disposed");
+		if (this.running) throw new Error("mengine document mutation is already running");
+		this.running = true;
+		try {
+			return mutation();
+		} finally {
+			this.running = false;
+		}
+	}
+	close() {
+		this.closed = true;
+	}
+};
+//#endregion
 //#region src/document/mirror-read.ts
 /**
 * Project the mirror state (`VideoDocumentDraft`) into the authoritative
 * `VideoDocument`. The storage shape is isomorphic to the domain shape (RFC 03
-* §4, reference/17 §4: meta map + a single `tracks` list + part_library), so this
+* §4, reference/17 §4: timeline + a single `tracks` list + part_library), so this
 * is a near-identity — it reads `time_position` / `fallback_abs_ms` JSON blobs
-* back into structured values and trims empty strings, nothing more.
+* back into structured values and selects content fields. Legacy meta is ignored.
 *
 * It maps only authoritative facts (RFC 02 §6): `part_id` + `time_position`. The
 * projection-derived `VideoDraft` read-view (absolute time, `part_aggregations`,
@@ -4242,20 +4491,8 @@ function readVideoDocumentFromDraft(draft) {
 		if (part != null) partLibrary[partId] = part;
 	}
 	const timeline = draft.timeline;
-	const hasTimeline = timeline?.unit_time_ms != null;
-	const meta = draft.meta;
 	return {
-		meta: {
-			schema_version: meta?.schema_version === "video-document/entity-projection-v1" ? ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION : VIDEO_DOCUMENT_SCHEMA_VERSION,
-			draft_id: emptyToUndefined(meta?.draft_id),
-			project_id: emptyToUndefined(meta?.project_id),
-			owner_id: emptyToUndefined(meta?.owner_id),
-			thumbnail_storage_key: emptyToUndefined(meta?.thumbnail_storage_key),
-			chat_session_id: emptyToUndefined(meta?.chat_session_id),
-			video_creation_settings: meta?.video_creation_settings ?? void 0,
-			version: meta?.version ?? void 0
-		},
-		timeline: hasTimeline ? { unit_time_ms: timeline.unit_time_ms } : void 0,
+		timeline: timeline?.unit_time_ms != null ? { unit_time_ms: timeline.unit_time_ms } : void 0,
 		tracks: rowsToTracks(draft.tracks),
 		part_library: partLibrary
 	};
@@ -4279,9 +4516,6 @@ function rowToTrack(row) {
 		})
 	};
 }
-function emptyToUndefined(value) {
-	return value == null || value === "" ? void 0 : value;
-}
 //#endregion
 //#region src/document/mirror-adapter.ts
 /**
@@ -4294,33 +4528,50 @@ function emptyToUndefined(value) {
 * - `transact(edit, audit)` runs the whole op in one `mirror.setState` callback:
 *   one diff, one `doc.commit` carrying the audit message. The callback edits an
 *   immer draft, so a throw inside it discards the draft and never touches Loro
-*   (natural rollback) — no `guard` / `rollback` / `openTransaction` machinery.
+*   (natural rollback) without a document checkout or compensating commit.
 * - mirror's `idSelector` (track items keyed by `part_id`) diffs reorders to
 *   real Loro `move` ops on every lane, so per-item CRDT identity survives on
 *   main and secondary tracks alike.
 */
 var MirrorVideoDocumentAdapter = class {
 	doc;
+	mutationGuard;
 	mirror;
-	constructor(doc) {
+	disposed = false;
+	constructor(doc, mutationGuard = new DocumentMutationGuard()) {
 		this.doc = doc;
+		this.mutationGuard = mutationGuard;
 		this.mirror = new Mirror({
 			doc,
-			schema: videoDocumentMirrorSchema
+			schema: videoDocumentMirrorSchema,
+			validateUpdates: false
 		});
 	}
 	snapshot() {
-		const document = readVideoDocumentFromDraft(this.mirror.getState());
-		if (this.doc.getMap("medeo").get("schema") === "medeo.entities.loro.v1") return projectEntityTimeline(readEntityDocument(this.doc).rows, document.meta);
-		return document;
+		this.assertActive();
+		if (this.isEntityDocument()) return projectEntityTimeline(readEntityDocument(this.doc).rows);
+		return readVideoDocumentFromDraft(this.mirror.getState());
 	}
 	/**
-	* True once the doc holds real document content. A fresh mirror over an empty
-	* doc still reports defaulted root maps, so probe the stored `schema_version`
-	* (empty until a snapshot is bootstrapped or synced in).
+	* Native Entity authority: placement is already solved by the Entity graph.
+	*
+	* The root check goes through `getShallowValue` first because `getMap` creates
+	* the container on access — probing a legacy document for `medeo` would
+	* otherwise mutate it, which a read must never do.
 	*/
-	hasContent() {
-		return (this.mirror.getState().meta?.schema_version ?? "") !== "";
+	isEntityDocument() {
+		const roots = this.doc.getShallowValue();
+		if (!Object.hasOwn(roots, "medeo")) return false;
+		return this.doc.getMap("medeo").get("schema") === LORO_ENTITY_SCHEMA;
+	}
+	/**
+	* Release mirror subscriptions; do not reuse this adapter afterwards.
+	* The caller still owns the borrowed LoroDoc.
+	*/
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.mirror.dispose();
 	}
 	/**
 	* Apply one op as a single transaction. `edit` mutates the immer draft; mirror
@@ -4329,80 +4580,71 @@ var MirrorVideoDocumentAdapter = class {
 	* skips the commit — matching the prior "empty op leaves no audit" behavior.
 	*/
 	transact(edit, audit) {
-		if (this.snapshot().meta.schema_version === "video-document/entity-projection-v1") throw new Error("Entity timeline projections are read-only; edit the Medeo entities instead");
-		this.mirror.setState((draft) => {
-			edit(draft);
-		}, {
-			origin: "mengine.semantic_editor",
-			message: JSON.stringify({
-				semantic_op: audit.kind,
-				payload: audit.payload,
-				intent: audit.intent ?? null,
-				actor: audit.actor ?? null
-			})
+		this.assertActive();
+		if (this.isEntityDocument()) throw new Error("Entity documents are read-only through this adapter; edit the Medeo entities instead");
+		this.mutationGuard.run(() => {
+			this.mirror.setState((draft) => {
+				edit(draft);
+				const result = validateSchema(videoDocumentMirrorSchema, {
+					timeline: draft.timeline,
+					tracks: draft.tracks,
+					part_library: draft.part_library
+				});
+				if (!result.valid) throw new Error(`Invalid content update: ${result.errors?.join("; ")}`);
+			}, {
+				origin: "mengine.semantic_editor",
+				message: JSON.stringify({
+					semantic_op: audit.kind,
+					payload: audit.payload,
+					intent: audit.intent ?? null,
+					actor: audit.actor ?? null
+				})
+			});
 		});
 	}
+	assertActive() {
+		if (this.disposed) throw new Error("mengine document adapter is disposed");
+	}
 };
 /** Build a fresh Loro doc seeded with `document` through the mirror. */
 function createMirrorVideoDocument(document, options = {}) {
 	assertValidVideoDocument(document);
 	const doc = new LoroDoc();
-	if (options.peerId != null) doc.setPeerId(options.peerId);
-	new Mirror({
-		doc,
-		schema: videoDocumentMirrorSchema
-	}).setState((draft) => {
-		writeVideoDocumentToDraft(draft, document);
-	}, { origin: options.origin ?? "mengine.bootstrap" });
-	return doc;
+	try {
+		if (options.peerId != null) doc.setPeerId(options.peerId);
+		const mirror = new Mirror({
+			doc,
+			schema: videoDocumentMirrorSchema
+		});
+		try {
+			mirror.setState((draft) => {
+				seedDraft(draft, document);
+			}, { origin: options.origin ?? "mengine.bootstrap" });
+			return doc;
+		} finally {
+			mirror.dispose();
+		}
+	} catch (error) {
+		doc.free();
+		throw error;
+	}
 }
 /** Build a `MirrorVideoDocumentAdapter` over a fresh doc seeded with `document`. */
 function createMirrorVideoDocumentAdapter(document, options) {
 	return new MirrorVideoDocumentAdapter(createMirrorVideoDocument(document, options));
 }
-/** Host-only replacement of a derived view, retaining the existing Loro history. */
-function applyEntityTimelineProjection(doc, projection, entityRevision) {
-	if (projection.meta.schema_version !== "video-document/entity-projection-v1") throw new Error("Expected an entity timeline projection");
-	if (!Number.isSafeInteger(entityRevision) || entityRevision < 1) throw new Error("Expected a positive entity revision");
-	assertValidVideoDocument(projection);
-	const from = doc.oplogVersion();
-	new Mirror({
-		doc,
-		schema: videoDocumentMirrorSchema
-	}).setState((draft) => writeVideoDocumentToDraft(draft, {
-		...projection,
-		meta: {
-			...projection.meta,
-			version: entityRevision
-		}
-	}), {
-		origin: "mengine.entity_projection",
-		message: JSON.stringify({
-			semantic_op: "EntityTimelineProjection",
-			entity_revision: entityRevision
-		})
-	});
-	return doc.export({
-		mode: "update",
-		from
-	});
-}
-/** Write a whole `VideoDocument` into a draft (seed a fresh doc / plain-memory state). */
-function writeVideoDocumentToDraft(draft, document) {
-	draft.meta = {
-		schema_version: document.meta.schema_version,
-		draft_id: document.meta.draft_id ?? void 0,
-		project_id: document.meta.project_id ?? void 0,
-		owner_id: document.meta.owner_id ?? void 0,
-		thumbnail_storage_key: document.meta.thumbnail_storage_key ?? void 0,
-		chat_session_id: document.meta.chat_session_id ?? void 0,
-		video_creation_settings: document.meta.video_creation_settings ?? void 0,
-		version: document.meta.version ?? void 0
-	};
+/** Write a whole `VideoDocument` into the mirror draft (seed a fresh doc / plain-memory state). */
+function seedDraft(draft, document) {
 	draft.timeline = { unit_time_ms: document.timeline?.unit_time_ms ?? void 0 };
 	draft.tracks = (document.tracks ?? []).map(toTrackRow);
 	draft.part_library = {};
-	for (const [partId, part] of Object.entries(document.part_library ?? {})) draft.part_library[partId] = partUnionToDraft(part);
+	for (const [partId, part] of Object.entries(document.part_library ?? {})) {
+		const createdPart = part.caption != null ? { caption: {
+			...part.caption,
+			style: part.caption.style ?? {}
+		} } : part;
+		draft.part_library[partId] = partUnionToDraft(createdPart);
+	}
 }
 /** Map a domain `Track` to a draft track row (no lane/lane_order — see schema). */
 function toTrackRow(track) {
@@ -4486,10 +4728,12 @@ var PlainMemoryAdapter = class {
 	* use this so every minted id is appended to the current transact's list.
 	*/
 	idFactory;
+	readOnly;
 	constructor(document, options) {
 		assertValidVideoDocument(document);
+		this.readOnly = options?.readOnly === true;
 		const draft = {};
-		writeVideoDocumentToDraft(draft, document);
+		seedDraft(draft, document);
 		this.state = draft;
 		this.baseIdFactory = options?.idFactory ?? generatePartId;
 		this.idFactory = (prefix) => {
@@ -4502,7 +4746,7 @@ var PlainMemoryAdapter = class {
 		return this._journal;
 	}
 	hasContent() {
-		return (this.state.meta?.schema_version ?? "") !== "";
+		return this.state.tracks !== void 0 || this.state.timeline !== void 0;
 	}
 	snapshot() {
 		return readVideoDocumentFromDraft(this.state);
@@ -4513,7 +4757,7 @@ var PlainMemoryAdapter = class {
 	* no structural change — skip journal, matching mirror "no change, no commit".
 	*/
 	transact(edit, audit) {
-		if (this.state.meta?.schema_version === "video-document/entity-projection-v1") throw new Error("Entity timeline projections are read-only; edit the Medeo entities instead");
+		if (this.readOnly) throw new Error("Entity documents are read-only here; edit the Medeo entities instead");
 		this.pendingIds = [];
 		try {
 			const next = produce(this.state, edit);
@@ -4534,4 +4778,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { cascadeAfterVideoClipChanges as $, selectAudioScriptSegment as A, derivePositionFromAbs as B, decodeEntityRelationRows as C, assemblePhoneticScriptContent as D, assembleEntityContent as E, createRelationId as F, validateVideoDocument as G, toVideoDocument as H, hasSequence as I, LANE_KINDS_IN_STACK_ORDER as J, partUnionSchema as K, isMediaAssetVariantKind as L, variantBaseEntityIds as M, isJsonObject as N, assembleScriptText as O, createEntityId as P, solveVideoDocument as Q, buildInitialVideoDocument as R, EntityTimelineProjectionError as S, assembleCaptionContent as T, VideoDocumentValidationError as U, fromVideoDocument as V, assertValidVideoDocument as W, findLaneTrack as X, ensureLaneTrack as Y, laneTrackId as Z, assertFieldChanges as _, recordEntries as _t, applyEntityTimelineProjection as a, resolveSpeechOverlapByShiftingVideos as at, EntityProjectionGraph as b, bytesToBase64 as bt, writeVideoDocumentToDraft as c, isEmptyVideoClip as ct, LoroEntityDocument as d, DEFAULT_UNIT_TIME_MS as dt, arrangeMainTrackSeamlessly as et, LoroEntityDraft as f, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION as ft, applyFieldChanges as g, partUnionToDraft as gt, equalJson as h, speedOf as ht, MirrorVideoDocumentAdapter as i, resolveAllSpeechOverlaps as it, updateEntityFields as j, findComposedAudioScript as k, readVideoDocumentFromDraft as l, partDurationMs as lt, entityOrderGroups as m, effectiveVideoClipDurationMs as mt, createPlainMemoryAdapter as n, reassignSpeechesToVideoClipsByTime as nt, createMirrorVideoDocument as o, syncAggregatedClipsTimePosition as ot, readEntityDocument as p, VIDEO_DOCUMENT_SCHEMA_VERSION as pt, videoDocumentSchema as q, generatePartId as r, recalculateTimelineDuration as rt, createMirrorVideoDocumentAdapter as s, TIMELINE_SKELETON_DURATION_MS as st, PlainMemoryAdapter as t, fillMainTrackTimeGaps as tt, LORO_ENTITY_SCHEMA as u, safeDurationMs as ut, resolveFieldPath as v, videoDocumentMirrorSchema as vt, ScriptCompositionError as w, resolveEntityTimelineLayout as x, projectEntityTimeline as y, base64ToBytes as yt, buildSpeechHostMap 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 };