@mengine/medeo-client 3.0.1-dsl.4 → 3.1.0

package/dist/{dsl-DgUxcAg3.js → dsl-C0-G8JVT.js}

@@ -145,12 +145,8 @@ function assertCaptionContent(value) {
 }
 const phonemeFields = {
 	...selectionFields,
-	phonemeScript: optional$1(nonempty)
+	phonemeScript: optional$1(string)
 };
-/** D190: omitted pronunciation uses the selected source words; an authored pronunciation is never empty. */
-function assertPhonemeScript(value) {
-	if (value !== void 0 && !nonempty(value)) throw new Error("phonemeScript must be nonempty when provided");
-}
 function assertPhoneme(value) {
 	if (!segmentSelection(phonemeFields)(value)) throw new Error("Invalid phoneme");
 }
@@ -173,9 +169,39 @@ function assertScriptSegment(value) {
 /** A script's segments: each with its own id, unique within the script. */
 const segments = (v) => Array.isArray(v) && v.every(segment) && new Set(v.map((s) => s.id)).size === v.length;
 const locator = {
-	system: required(oneOf("memota", "memota-speech")),
+	system: required(oneOf("memota", "memota-speech", "placeholder")),
 	key: required(nonempty)
 };
+/**
+* A placeholder medium is an Image with no file, standing in where a legacy VideoDraft placed a
+* visual clip the old editor drew as a blank (D196). The blank one stands in for a clip placed
+* without media (`origin_media_id: ''`); one keyed by a memota media id stands in for media the
+* clip named but Director found missing, so the id survives. Importing keeps the clips' time on
+* them instead of dropping them. Only migration authors them.
+*/
+const BLANK_PLACEHOLDER = {
+	system: "placeholder",
+	key: "blank",
+	kind: "image"
+};
+/**
+* Only a memota media id may key a missing-media placeholder: visual parts name media and nothing
+* else, and a key of this shape can never be mistaken for a file.
+*/
+const MISSING_MEDIA_KEY = /^media_[0-9A-Za-z]+$/;
+/** The placeholder for a memota media id Director found missing. */
+function missingMediaPlaceholder(mediaId) {
+	return {
+		system: "placeholder",
+		key: mediaId,
+		kind: "image"
+	};
+}
+function assertPlaceholder(media) {
+	if (media.system !== "placeholder") return;
+	if (media.kind !== "image" || media.key !== BLANK_PLACEHOLDER.key && !(typeof media.key === "string" && MISSING_MEDIA_KEY.test(media.key))) throw new Error("A placeholder is the blank Image or one standing in for a missing memota media id");
+	if (media.storageKey !== void 0 || media.digest !== void 0) throw new Error("A placeholder has no file");
+}
 const entityFields = {
 	"timeline-entities": {},
 	"track-entities": {
@@ -271,6 +297,7 @@ function assertEntity(table, value) {
 	checkFields(value, entityFields[table]);
 	if (table === "audio-script-entities") assertTranscriptFile(value);
 	if (table === "media-entities") {
+		assertPlaceholder(value);
 		if (value.kind === "image" && value.durationMs !== void 0) throw new Error("Image has no intrinsic duration");
 		if (value.kind !== "image" && !positive(value.durationMs)) throw new Error("Finite media requires durationMs");
 		if (["audio", "voiceover-recording"].includes(value.kind) && !nonempty(value.storageKey)) throw new Error("Audio requires storageKey");
@@ -299,6 +326,7 @@ function assertEntityPatch(table, patch, current) {
 		]) if (Object.hasOwn(patch, key) && patch[key] !== current[key]) throw new Error(`Resource identity field is immutable: ${key}`);
 	}
 	if (table === "media-entities") {
+		assertPlaceholder(next);
 		if (Object.hasOwn(patch, "durationMs")) {
 			if (next.kind === "image" ? next.durationMs !== void 0 : !positive(next.durationMs)) throw new Error("durationMs must match the media kind");
 		}
@@ -642,63 +670,6 @@ function assertContainTree(rows, tree) {
 	}
 }
 //#endregion
-//#region ../medeo-dsl/src/clip-playback.ts
-const playable = {
-	video_clip: ["video", "image"],
-	speech: ["audio", "voiceover-recording"],
-	caption: ["caption"],
-	bgm: ["audio"]
-};
-function supportsClipSpeed(source) {
-	return isRecord(source) && [
-		"video",
-		"audio",
-		"voiceover-recording"
-	].includes(String(source.kind));
-}
-/** Content-kind admission is shared by Actions, script compilation and the final transaction. */
-function assertClipSourceRole(role, kind) {
-	if (!playable[role]?.includes(kind)) throw new Error(`A ${role} Track does not play ${kind}`);
-}
-function assertClipWindow(window, duration) {
-	if (!Number.isSafeInteger(window.inMs) || !Number.isSafeInteger(window.outMs) || window.inMs < 0 || window.outMs <= window.inMs) throw new Error("Invalid Clip window");
-	if (duration !== void 0 && window.outMs > duration) throw new Error(`Invalid Clip window: ${window.outMs}ms is past its content's ${duration}ms`);
-}
-/** Check authored playback facts; a remote merge is still read by projection with diagnostics. */
-function assertClipPlayback(clip, source, role) {
-	if (!isRecord(source)) throw new Error("Invalid Clip source");
-	const kind = source.kind ?? "caption";
-	const marker = clip.seqMarker;
-	assertSeqMarker(marker);
-	if (marker.outMs <= marker.inMs) throw new Error("Clip window must be nonempty");
-	if (role !== void 0) assertClipSourceRole(role, kind);
-	if (marker.rate !== void 0 && !supportsClipSpeed(source)) throw new Error("Only video and sound change speed");
-	const duration = typeof source.durationMs === "number" ? source.durationMs : void 0;
-	if (marker.fillTimeline) {
-		if (kind !== "audio") throw new Error("Only BGM audio fills the Timeline");
-		if (marker.inMs !== 0 || marker.rate !== void 0 && marker.rate !== 1 || marker.outMs !== duration) throw new Error(`A Clip that fills the Timeline plays its whole source at 1×: inMs 0, outMs ${duration ?? "its length"}, no rate; the Timeline's end cuts it`);
-	}
-	assertClipWindow(marker);
-}
-function clipParents(tree) {
-	const result = /* @__PURE__ */ new Map();
-	for (const track of tree) for (const clip of track.children ?? []) result.set(clip.entityId, track.entityId);
-	return result;
-}
-/** A new parent or Track role revalidates that binding, without blocking unrelated merged rows. */
-function assertClipPlacements(before, after, previousTree, nextTree) {
-	const previous = clipParents(previousTree);
-	for (const [id, parent] of clipParents(nextTree)) {
-		const track = after["track-entities"][parent];
-		const previousTrack = before["track-entities"][parent];
-		if (previous.get(id) === parent && (track === void 0 || isRecord(track) && isRecord(previousTrack) && previousTrack.role === track.role)) continue;
-		const role = requireEntity(after, "track-entities", parent).role;
-		const clip = after["clip-entities"][id];
-		if (!clip) continue;
-		assertClipPlayback(clip, after["media-entities"][clip.source] ?? after["caption-entities"][clip.source], role);
-	}
-}
-//#endregion
 //#region ../medeo-dsl/src/plan.ts
 /** Include removed nested keys: a partial merge alone would conceal a deleted required field. */
 function replacementPatch(before, after) {
@@ -714,7 +685,6 @@ function replacementPatch(before, after) {
 */
 function assertChangeAdmitted(change) {
 	const { before, after } = change;
-	const parents = change.containment ? clipParents(change.containment.after) : void 0;
 	for (const [table, rows] of change.entities) for (const [id, fields] of rows) {
 		const value = after[table][id];
 		if (value === void 0) continue;
@@ -729,17 +699,25 @@ function assertChangeAdmitted(change) {
 		}
 		const row = value;
 		for (const field of referenceFields[table] ?? []) if (!old || fields.has(field)) assertReferenceAdmitted(after, table, id, field, row[field]);
-		if (table === "clip-entities" && (!old || fields.has("seqMarker") || fields.has("source"))) {
-			const parent = parents?.get(id);
-			assertClipPlayback(row, after["media-entities"][row.source] ?? after["caption-entities"][row.source], parent === void 0 ? void 0 : requireEntity(after, "track-entities", parent).role);
-		}
+		const marker = row.seqMarker;
+		if (table === "clip-entities" && (!old || fields.has("seqMarker")) && marker?.outMs <= marker?.inMs) throw new Error("Clip window must be nonempty");
+		if (table === "clip-entities" && (!old || fields.has("seqMarker") || fields.has("source"))) assertFillsWithWholeSource(after, marker, row.source);
 	}
 	if (change.entities.has("timeline-entities") && Object.keys(after["timeline-entities"]).length > 1) throw new Error("Document already has a Timeline");
 	for (const [table, ids] of change.relations) for (const id of ids) {
 		const value = after[table][id];
 		if (value !== void 0) assertRelationAdmitted(after, table, id, value);
 	}
-	if (change.containment) assertClipPlacements(before, after, change.containment.before, change.containment.after);
+}
+/**
+* A Clip that fills the Timeline plays its whole source at 1×: the player loops a short source and
+* cuts a long one at the Timeline's end (RFC 02 §3.3), so a window or speed of its own has no meaning.
+*/
+function assertFillsWithWholeSource(rows, marker, source) {
+	if (marker?.fillTimeline !== true) return;
+	const media = typeof source === "string" ? rows["media-entities"][source] : void 0;
+	const durationMs = typeof media?.durationMs === "number" ? media.durationMs : void 0;
+	if (marker.inMs !== 0 || marker.rate !== void 0 && marker.rate !== 1 || durationMs !== void 0 && marker.outMs !== durationMs) throw new Error(`A Clip that fills the Timeline plays its whole source at 1×: inMs 0, outMs ${durationMs ?? "its length"}, no rate; the Timeline's end cuts it`);
 }
 //#endregion
 //#region src/dsl/projection/types.ts
@@ -975,11 +953,15 @@ function requireSource(s, id, role) {
 	return media;
 }
 function assertMediaRole(media, role) {
-	if (!media) throw new Error(`Missing source for ${role} Track`);
-	assertClipSourceRole(role, media.kind);
+	if (!media || !{
+		video_clip: ["video", "image"],
+		speech: ["audio", "voiceover-recording"],
+		bgm: ["audio"],
+		caption: []
+	}[role].includes(media.kind)) throw new Error(`Source is not allowed on ${role} Track`);
 }
 function validateWindow(window, duration) {
-	assertClipWindow(window, duration);
+	if (!Number.isSafeInteger(window.inMs) || !Number.isSafeInteger(window.outMs) || window.inMs < 0 || window.outMs <= window.inMs || duration !== void 0 && window.outMs > duration) throw new Error("Invalid Clip window");
 }
 function trackOf(s, id) {
 	requireClip(s, id);
@@ -1267,15 +1249,14 @@ function replaceSourcePlan(s, clipId, input) {
 		patch: {
 			seqMarker: {
 				inMs: input.inMs,
-				outMs: input.outMs,
-				...supportsClipSpeed(source.source) ? {} : { rate: void 0 }
+				outMs: input.outMs
 			},
 			source: source.id
 		}
 	}];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/schema/resolver.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/schema/resolver.js
 function getMapFieldSchema(schema, key) {
 	if (!schema) return void 0;
 	if (Object.prototype.hasOwnProperty.call(schema.definition, key)) return schema.definition[key];
@@ -1305,10 +1286,10 @@ function getChildContainerSchema(schema, childKey) {
 	}
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/constants.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/constants.js
 const CID_KEY = "$cid";
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/container-inference.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/container-inference.js
 function isPlainObjectValue(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date) && !(value instanceof RegExp) && typeof value !== "function";
 }
@@ -1347,7 +1328,7 @@ function getContainerValueKind(value) {
 	return "other";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/utils.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/utils.js
 /**
 * Utility functions for Loro Mirror core
 */
@@ -1771,7 +1752,7 @@ function safeStringify(value, indent = 2) {
 	return JSON.stringify(replacer(value), null, indent);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/schema/validators.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/schema/validators.js
 const schemaValidationCache = /* @__PURE__ */ new WeakMap();
 function isCacheableValue(value) {
 	return typeof value === "object" && value !== null;
@@ -2051,7 +2032,7 @@ function getDefaultValue(schema) {
 	}
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/schema/index.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/schema/index.js
 /**
 * Create a schema definition
 */
@@ -2816,7 +2797,7 @@ const produce = new Immer2({
 	useStrictShallowCopy: true
 }).produce;
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/debounce-timer.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/debounce-timer.js
 /**
 * Deadline-based debounce timer.
 *
@@ -2874,7 +2855,7 @@ var DebounceTimer = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/ephemeral.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/ephemeral.js
 /**
 * Manages ephemeral patches: storage, composition, path resolution, and finalization.
 */
@@ -3149,7 +3130,7 @@ var EphemeralPatchManager = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/tree-utils.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/tree-utils.js
 function normalizeTreeJson(input, options) {
 	if (!Array.isArray(input)) return [];
 	return input.map((node) => normalizeTreeNode(node, options));
@@ -3172,7 +3153,7 @@ function isPlainRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/loroEventApply.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/loroEventApply.js
 function isJSONObject(v) {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -3594,7 +3575,7 @@ function isIgnoredByAncestor(id, ignoreSet, getContainerById) {
 	return false;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/diff.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/diff.js
 /**
 * Finds the longest increasing subsequence of a sequence of numbers
 * @param sequence The sequence of numbers
@@ -4325,7 +4306,7 @@ function diffMap(doc, oldState, newState, containerId, schema, inferOptions) {
 	return changes;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/core/mirror.js
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/core/mirror.js
 /**
 * Mirror core functionality for bidirectional sync between app state and Loro CRDT
 */
@@ -5896,30 +5877,6 @@ const phonemeCodec = codec((v) => {
 	assertPhoneme(value);
 	return value;
 });
-/** A row-owned binding couples the selection, pronunciation and its immutable file in one LWW value. */
-const phoneticBindingCodec = codec((value) => {
-	assertEntity("phonetic-script-entities", value);
-	assertPhoneticScript(void 0, { ...value });
-	return JSON.stringify({
-		phoneme: JSON.parse(phonemeCodec.encode(value.phoneme)),
-		system: value.system,
-		key: value.key,
-		storageKey: value.storageKey,
-		digest: value.digest
-	});
-}, (raw) => {
-	const value = JSON.parse(raw);
-	if (!isRecord(value)) throw new Error("Expected a PhoneticScript binding");
-	const phoneme = phonemeCodec.decode(JSON.stringify(value.phoneme));
-	if (isInvalidAtomic(phoneme)) throw new Error(phoneme.reason);
-	const binding = {
-		...value,
-		phoneme
-	};
-	assertEntity("phonetic-script-entities", binding);
-	assertPhoneticScript(void 0, binding);
-	return binding;
-});
 /** A Clip's sequence marker is stored as one string, so it is taken or replaced whole. */
 const seqMarkerCodec = codec((v) => {
 	assertSeqMarker(v);
@@ -5986,7 +5943,13 @@ const medeoDslLoroShape = schema({
 		storageKey: schema.String(optional),
 		digest: schema.String(optional)
 	})),
-	"phonetic-script-entities": schema.LoroMapRecord(schema.LoroMap({ binding: atomicValue(phoneticBindingCodec) })),
+	"phonetic-script-entities": schema.LoroMapRecord(schema.LoroMap({
+		phoneme: atomicValue(phonemeCodec),
+		system: schema.String(optional),
+		key: schema.String(optional),
+		storageKey: schema.String(optional),
+		digest: schema.String(optional)
+	})),
 	"caption-entities": schema.LoroMapRecord(schema.LoroMap({
 		selection: optionalAtomicValue(captionContentCodec),
 		text: schema.LoroText(optional),
@@ -6038,78 +6001,20 @@ function documentFormat(doc) {
 }
 var UnsupportedDocumentFormatError = class extends Error {
 	code = "unsupported_document_format";
-	constructor(message = "Expected a new DSL document; legacy, mixed or uninitialized content is not supported") {
-		super(message);
+	constructor() {
+		super("Expected a new DSL document; legacy, mixed or uninitialized content is not supported");
 		this.name = "UnsupportedDocumentFormatError";
 	}
 };
 /** Run after initial import, before opening an editable handle. Empty new documents still have one Timeline. */
 function assertDslDocument(doc) {
 	if (documentFormat(doc) !== "dsl" || doc.getMap("timeline-entities").keys().length !== 1) throw new UnsupportedDocumentFormatError();
-	assertPhoneticBindingFormat(doc);
-}
-/** This storage cutover has no field-per-fact reader or mixed-version write path. */
-function assertPhoneticBindingFormat(doc) {
-	if (!Object.hasOwn(doc.getShallowValue(), "phonetic-script-entities")) return;
-	const table = doc.getMap("phonetic-script-entities");
-	for (const id of table.keys()) {
-		const row = table.get(id);
-		if (!isContainer(row) || row.kind() !== "Map" || row.keys().some((key) => key !== "binding") || typeof row.get("binding") !== "string") throw new UnsupportedDocumentFormatError("PhoneticScript storage requires one atomic binding; old DSL documents need explicit migration");
-	}
 }
 //#endregion
 //#region ../medeo-dsl/src/schema/text-styles.ts
 /** How rich-text marks extend at their edges: a language runs on into text typed after it. */
 const textStyles = { language: { expand: "after" } };
 //#endregion
-//#region src/dsl/document/phonetic-binding.ts
-/**
-* Actions and the transaction guard keep their domain-shaped rows. The native schema stores
-* a PhoneticScript's facts under one binding; this lens applies draft edits to that single value.
-* It never reads the retired field-per-fact representation.
-*/
-function logicalDslState(native) {
-	const phonetics = new Proxy({}, {
-		get: (_target, key) => typeof key === "string" ? native["phonetic-script-entities"]?.[key]?.binding : void 0,
-		set: (_target, key, value) => {
-			if (typeof key !== "string") throw new Error("Invalid PhoneticScript key");
-			native["phonetic-script-entities"] ??= {};
-			const existing = native["phonetic-script-entities"][key];
-			if (existing) existing.binding = value;
-			else native["phonetic-script-entities"][key] = { binding: value };
-			return true;
-		},
-		deleteProperty: (_target, key) => {
-			if (typeof key === "string") delete native["phonetic-script-entities"][key];
-			return true;
-		},
-		ownKeys: () => Object.keys(native["phonetic-script-entities"] ?? {}),
-		has: (_target, key) => typeof key === "string" && Object.hasOwn(native["phonetic-script-entities"] ?? {}, key),
-		getOwnPropertyDescriptor: (_target, key) => typeof key === "string" && Object.hasOwn(native["phonetic-script-entities"] ?? {}, key) ? {
-			configurable: true,
-			enumerable: true,
-			writable: true,
-			value: native["phonetic-script-entities"][key].binding
-		} : void 0
-	});
-	const view = {};
-	for (const key of new Set([
-		...Object.keys(native),
-		...entityTables,
-		...relationTables,
-		"contain-relations"
-	])) Object.defineProperty(view, key, {
-		configurable: true,
-		enumerable: true,
-		get: () => key === "phonetic-script-entities" ? phonetics : Reflect.get(native, key),
-		set: (value) => {
-			if (key === "phonetic-script-entities") throw new Error("Cannot replace the PhoneticScript table");
-			Reflect.set(native, key, value);
-		}
-	});
-	return view;
-}
-//#endregion
 //#region src/dsl/document/read.ts
 /** Looking up a missing root must not create it. */
 function rootMap(doc, name) {
@@ -6193,7 +6098,6 @@ function referenceTargets(table, row) {
 	}
 }
 function readMedeoDsl(doc, state) {
-	const logical = logicalDslState(state);
 	const diagnostics = [];
 	const diagnostic = (code, path, error) => diagnostics.push({
 		code,
@@ -6203,7 +6107,7 @@ function readMedeoDsl(doc, state) {
 	const entities = Object.fromEntries(entityTables.map((t) => [t, {}]));
 	const relations = Object.fromEntries(relationTables.map((t) => [t, {}]));
 	const richText = {};
-	for (const table of entityTables) for (const [id, raw] of Object.entries(logical[table] ?? {})) try {
+	for (const table of entityTables) for (const [id, raw] of Object.entries(state[table] ?? {})) try {
 		assertId(id);
 		let v = raw;
 		for (const field of optionalReferences[table] ?? []) {
@@ -6709,11 +6613,7 @@ function validateDraft(tracked) {
 		before,
 		after: state,
 		entities: tracked.entities,
-		relations: tracked.relations,
-		containment: {
-			before: plainTree(before["contain-relations"] ?? []),
-			after: plainTree(state["contain-relations"] ?? [])
-		}
+		relations: tracked.relations
 	});
 	if (!tracked.treeChanged) return;
 	const oldNodes = nodeIndex(before["contain-relations"] ?? []);
@@ -6790,11 +6690,8 @@ function runTransaction(doc, mirror, edit, options, setReject) {
 	const steps = [];
 	const newCaptionTexts = /* @__PURE__ */ new Map();
 	const bodies = /* @__PURE__ */ new Map();
-	const nativeBefore = mirror.getState();
-	const before = logicalDslState(nativeBefore);
-	const phoneticRows = /* @__PURE__ */ new Map();
-	mirror.setState((native) => {
-		const raw = logicalDslState(native);
+	const before = mirror.getState();
+	mirror.setState((raw) => {
 		const tracked = new TransactionDraft(raw, before);
 		setReject((error) => tracked.fail(error));
 		/** The current text of a Caption's own Text or a script segment, as this transaction leaves it so far. */
@@ -6986,15 +6883,6 @@ function runTransaction(doc, mirror, edit, options, setReject) {
 				for (const step of steps) if (step.type === "text") if ("captionId" in step.target) requireEntity(raw, "caption-entities", step.target.captionId);
 				else requireSegment(raw, step.target.audioScriptId, step.target.segmentId);
 				assertSelectionsAfter(raw, before, tracked, steps);
-				const changedPhonetics = new Set([...tracked.entities.get("phonetic-script-entities")?.keys() ?? [], ...steps.flatMap((step) => step.type !== "text" && step.table === "phonetic-script-entities" ? [step.id] : [])]);
-				for (const id of changedPhonetics) {
-					const row = raw["phonetic-script-entities"][id];
-					phoneticRows.set(id, row ? copyInput(row) : void 0);
-					if (!row) continue;
-					const old = nativeBefore["phonetic-script-entities"][id];
-					if (old) native["phonetic-script-entities"][id] = old;
-					else delete native["phonetic-script-entities"][id];
-				}
 				for (const [id, fields] of tracked.entities.get("caption-entities") ?? []) {
 					const row = raw["caption-entities"][id];
 					if (fields.has("text") && row?.text !== void 0 && before["caption-entities"][id]?.text === void 0) {
@@ -7003,7 +6891,6 @@ function runTransaction(doc, mirror, edit, options, setReject) {
 					}
 				}
 				for (const table of Object.keys(selectionField)) {
-					if (table === "phonetic-script-entities") continue;
 					const field = selectionField[table];
 					for (const [id, fields] of tracked.entities.get(table) ?? []) {
 						const row = raw[table][id];
@@ -7043,8 +6930,6 @@ function runTransaction(doc, mirror, edit, options, setReject) {
 					applyTextEdits(text, step.edits);
 					continue;
 				}
-				const phonetic = step.table === "phonetic-script-entities" ? phoneticRows.get(step.id) : void 0;
-				if (step.table === "phonetic-script-entities" && !phonetic) continue;
 				const row = entityRow(doc, step.table, step.id);
 				const field = selectionField[step.table];
 				if (step.type === "range") {
@@ -7063,21 +6948,12 @@ function runTransaction(doc, mirror, edit, options, setReject) {
 						if (!value.start || !value.end) throw new Error("Unable to construct prepared range");
 					}
 					if (step.phonemeScript !== void 0) value.phonemeScript = step.phonemeScript;
-					if (phonetic) phonetic.phoneme = value;
-					else {
-						if (!row) throw new Error("Unable to construct prepared range");
-						row.set(field, codecs[step.table].encode(value));
-					}
-				} else if (step.value !== void 0) if (phonetic) phonetic.phoneme = step.value;
-				else {
+					if (!row) throw new Error("Unable to construct prepared range");
+					row.set(field, codecs[step.table].encode(value));
+				} else if (step.value !== void 0) {
 					if (!row) throw new Error("Prepared selection owner is missing");
 					row.set(field, codecs[step.table].encode(step.value));
-				}
-				else if (row?.get(field) !== void 0) row.delete(field);
-			}
-			for (const [id, binding] of phoneticRows) {
-				if (!binding) continue;
-				(entityRow(doc, "phonetic-script-entities", id) ?? doc.getMap("phonetic-script-entities").setContainer(id, new LoroMap())).set("binding", phoneticBindingCodec.encode(binding));
+				} else if (row?.get(field) !== void 0) row.delete(field);
 			}
 		}
 	});
@@ -7124,7 +7000,7 @@ function assertSelectionsAfter(raw, before, tracked, steps) {
 		if (!row) continue;
 		const phoneme = phonemes.has(id) ? phonemes.get(id) : row.phoneme;
 		const old = before["phonetic-script-entities"][id];
-		assertPhoneticScript(old ? { ...old } : void 0, {
+		assertPhoneticScript(old, {
 			...row,
 			phoneme: isRecord(phoneme) ? phoneme : void 0
 		});
@@ -7163,7 +7039,6 @@ var MedeoDsl = class MedeoDsl {
 			"tracks",
 			"part_library"
 		].some((key) => Object.hasOwn(roots, key))) throw new Error("Expected a new DSL document, not a legacy content model");
-		assertPhoneticBindingFormat(doc);
 		doc.configTextStyle(textStyles);
 		this.mirror = new Mirror({
 			doc,
@@ -7227,11 +7102,6 @@ var MedeoDsl = class MedeoDsl {
 	editCaptionText(captionId, expectedBodyId, edits, audit) {
 		this.transact((tx) => tx.editCaptionText(captionId, edits, expectedBodyId), audit);
 	}
-	/** Check the session's write capability before an Action starts host-owned resource I/O. */
-	assertWritable() {
-		this.assertReadyToWrite();
-		this.options.mutationGuard?.run(() => {});
-	}
 	/**
 	* A run inside one segment as native Cursors. Local ranges exclude insertions at their start and
 	* include insertions at their end. K01 remains deferred.
@@ -7264,7 +7134,13 @@ var MedeoDsl = class MedeoDsl {
 		if (this.ownsDoc) this.doc.free();
 	}
 	mutate(run) {
-		this.assertReadyToWrite();
+		this.assertActive();
+		if (this.writing || this.notifying) {
+			const error = /* @__PURE__ */ new Error("A DSL mutation is already running");
+			this.rejectTransaction?.(error);
+			throw error;
+		}
+		if (this.doc.getPendingTxnLength() !== 0) throw new Error("Commit external native edits before a DSL mutation");
 		const apply = () => {
 			this.writing = true;
 			try {
@@ -7279,15 +7155,6 @@ var MedeoDsl = class MedeoDsl {
 		if (this.options.mutationGuard) this.options.mutationGuard.run(apply);
 		else apply();
 	}
-	assertReadyToWrite() {
-		this.assertActive();
-		if (this.writing || this.notifying) {
-			const error = /* @__PURE__ */ new Error("A DSL mutation is already running");
-			this.rejectTransaction?.(error);
-			throw error;
-		}
-		if (this.doc.getPendingTxnLength() !== 0) throw new Error("Commit external native edits before a DSL mutation");
-	}
 	notify() {
 		if (this.disposed || !this.dirty) return;
 		this.dirty = false;
@@ -7314,13 +7181,12 @@ function spokenScripts(snapshot, recordingId) {
 	const found = /* @__PURE__ */ new Map();
 	const seen = /* @__PURE__ */ new Set();
 	const visit = (id, phoneticScriptId) => {
+		if (seen.has(id)) return;
+		seen.add(id);
 		if (snapshot["audio-script-entities"][id]) {
-			if (!found.has(id)) found.set(id, /* @__PURE__ */ new Set());
-			if (phoneticScriptId !== void 0) found.get(id).add(phoneticScriptId);
+			if (!found.has(id)) found.set(id, phoneticScriptId);
 			return;
 		}
-		if (seen.has(id)) return;
-		seen.add(id);
 		const phonetic = snapshot["phonetic-script-entities"][id];
 		if (phonetic) {
 			visit(phonetic.phoneme.audioScriptId, id);
@@ -7330,18 +7196,11 @@ function spokenScripts(snapshot, recordingId) {
 	};
 	visit(recordingId);
 	if (!found.size) {
-		for (const r of relations) if (r.sourceId === recordingId && snapshot["audio-script-entities"][r.entityId]) found.set(r.entityId, /* @__PURE__ */ new Set());
+		for (const r of relations) if (r.sourceId === recordingId && snapshot["audio-script-entities"][r.entityId]) found.set(r.entityId, void 0);
 	}
-	return [...found].map(([audioScriptId, ids]) => {
-		const phoneticScriptIds = [...ids];
-		if (phoneticScriptIds.length === 1) return {
-			audioScriptId,
-			phoneticScriptId: phoneticScriptIds[0]
-		};
-		return phoneticScriptIds.length ? {
-			audioScriptId,
-			phoneticScriptIds
-		} : { audioScriptId };
+	return [...found].map(([audioScriptId, phoneticScriptId]) => phoneticScriptId === void 0 ? { audioScriptId } : {
+		audioScriptId,
+		phoneticScriptId
 	});
 }
 /** Every AudioScript in the document with its PhoneticScripts, the Speech Clips saying it and the Caption Clips showing it. */
@@ -7386,6 +7245,7 @@ function toAudioScriptViews(snapshot) {
 		});
 	}
 	const layout = resolveDslLayout(snapshot);
+	for (const view of views.values()) placeTranscript(snapshot, layout, view);
 	const timbres = Object.values(snapshot["voice-timbre-relations"]);
 	for (const track of layout.tracks) for (const { clipId } of track.clips) {
 		const source = snapshot["clip-entities"][clipId]?.source;
@@ -7409,7 +7269,6 @@ function toAudioScriptViews(snapshot) {
 					clipId,
 					recordingId: source,
 					...spoken.phoneticScriptId === void 0 ? {} : { phoneticScriptId: spoken.phoneticScriptId },
-					...spoken.phoneticScriptIds === void 0 ? {} : { phoneticScriptIds: spoken.phoneticScriptIds },
 					voices,
 					...applied === void 0 ? {} : { applied }
 				});
@@ -7426,23 +7285,19 @@ function toAudioScriptViews(snapshot) {
 			segment
 		});
 	}
-	for (const view of views.values()) placeTranscript(snapshot, layout, view);
 	return [...views.values()];
 }
 /**
 * A transcript's segments on the Timeline: a segment's time is in the medium the script was read
-* off. An authored Caption anchor identifies its use of that medium; otherwise the earliest
-* Clip holding that source moment is used. The source time is never taken from the Caption.
+* off, so it lands where the earliest Clip playing that medium holds that moment in its window.
 */
 function placeTranscript(snapshot, layout, view) {
 	if (!view.sourceMediaIds.length) return;
 	const plays = layout.tracks.flatMap((track) => track.clips).filter((clip) => view.sourceMediaIds.includes(snapshot["clip-entities"][clip.clipId]?.source ?? "")).sort((a, b) => a.startMs - b.startMs);
-	for (const [index, segment] of view.segments.entries()) {
+	for (const segment of view.segments) {
 		const at = segment.startMs;
 		if (at === void 0) continue;
-		const anchoredUses = new Set(view.captions.filter((caption) => caption.segment === index).map((caption) => layout.clips[caption.clipId]?.anchorClipId));
-		const candidates = plays.filter((c) => c.inMs <= at && at < c.outMs);
-		const clip = candidates.find((c) => anchoredUses.has(c.clipId)) ?? candidates[0];
+		const clip = plays.find((c) => c.inMs <= at && at < c.outMs);
 		if (clip) segment.timelineMs = Math.round(clip.startMs + (at - clip.inMs) / clip.rate);
 	}
 }
@@ -7453,26 +7308,14 @@ function placeTranscript(snapshot, layout, view) {
 * not what a take was synthesized from (D190).
 */
 function appliedSpeech(snapshot, recordingId, spoken) {
-	const ids = spoken.phoneticScriptIds ?? (spoken.phoneticScriptId === void 0 ? [] : [spoken.phoneticScriptId]);
-	if (!ids.length) return void 0;
-	let unknown = false;
-	for (const sourceId of ids) {
-		const recorded = Object.values(snapshot["derived-from-relations"]).find((r) => r.entityId === recordingId && r.sourceId === sourceId)?.sourceDigest;
-		const current = snapshot["phonetic-script-entities"][sourceId]?.digest;
-		if (recorded === void 0 || current === void 0) unknown = true;
-		else if (recorded !== current) return false;
-	}
-	return unknown ? void 0 : true;
+	const sourceId = spoken.phoneticScriptId ?? spoken.audioScriptId;
+	const recorded = Object.values(snapshot["derived-from-relations"]).find((r) => r.entityId === recordingId && r.sourceId === sourceId)?.sourceDigest;
+	const current = spoken.phoneticScriptId === void 0 ? void 0 : snapshot["phonetic-script-entities"][sourceId]?.digest;
+	return recorded === void 0 || current === void 0 ? void 0 : recorded === current;
 }
 //#endregion
 //#region src/dsl/voiceover-actions.ts
-function matchesPlainPhoneticOrigin(s, id, scriptId, segmentId) {
-	const phonetic = s["phonetic-script-entities"][id];
-	const run = s.phoneticText[id];
-	const segment = s["audio-script-entities"][scriptId]?.segments.find((item) => item.id === segmentId);
-	return phonetic?.phoneme.audioScriptId === scriptId && phonetic.phoneme.segmentId === segmentId && phonetic.phoneme.phonemeScript === void 0 && run?.start === 0 && run.end === segment?.text.length;
-}
-function voiceoverPlan(s, input, result, plainPhoneticIds) {
+function voiceoverPlan(s, input, result) {
 	if (requireTrack(s, input.trackId).role !== "speech" || input.media.kind !== "voiceover-recording") throw new Error("Voiceover requires a speech Track and a recording");
 	if (input.captions.length && (!input.captionTrackId || requireTrack(s, input.captionTrackId).role !== "caption")) throw new Error("Caption Track is required");
 	const existing = s["clip-entities"][result.clipId];
@@ -7511,44 +7354,15 @@ function voiceoverPlan(s, input, result, plainPhoneticIds) {
 		inMs: 0,
 		outMs: input.media.durationMs
 	}, input.media.durationMs);
-	if (phoneticScriptId !== void 0) {
-		const recorded = Object.values(s["derived-from-relations"]).find((origin) => origin.entityId === result.mediaId && origin.sourceId === phoneticScriptId);
-		if (recorded?.sourceDigest !== void 0 && input.sourceDigest !== void 0 && recorded.sourceDigest !== input.sourceDigest) throw new Error("A recording already has a different synthesis digest");
-		if (!recorded || recorded.sourceDigest === void 0 && input.sourceDigest !== void 0) mutations.push({
-			type: "set-relation",
-			table: "derived-from-relations",
-			value: {
-				entityId: result.mediaId,
-				sourceId: phoneticScriptId,
-				...input.sourceDigest === void 0 ? {} : { sourceDigest: input.sourceDigest }
-			}
-		});
-	} else {
-		if (input.sourceDigest !== void 0) throw new Error("A synthesis digest requires its PhoneticScript");
-		if (plainPhoneticIds.length !== segmentIds.length) throw new Error("Expected one PhoneticScript id per plain segment");
-		segmentIds.forEach((segmentId, i) => {
-			const id = plainPhoneticIds[i];
-			if (s["phonetic-script-entities"][id]) {
-				if (!matchesPlainPhoneticOrigin(s, id, result.audioScriptId, segmentId)) throw new Error("PhoneticScript id already names another synthesis origin");
-			} else mutations.push({
-				type: "create-entity",
-				table: "phonetic-script-entities",
-				id,
-				value: { phoneme: {
-					audioScriptId: result.audioScriptId,
-					segmentId
-				} }
-			});
-			if (!Object.values(s["derived-from-relations"]).some((origin) => origin.entityId === result.mediaId && origin.sourceId === id)) mutations.push({
-				type: "set-relation",
-				table: "derived-from-relations",
-				value: {
-					entityId: result.mediaId,
-					sourceId: id
-				}
-			});
-		});
-	}
+	mutations.push({
+		type: "set-relation",
+		table: "derived-from-relations",
+		value: {
+			entityId: result.mediaId,
+			sourceId: phoneticScriptId ?? result.audioScriptId,
+			...input.sourceDigest === void 0 ? {} : { sourceDigest: input.sourceDigest }
+		}
+	});
 	if (input.voice) {
 		const id = resourceId("voice", input.voice.system, input.voice.key);
 		mutations.push({
@@ -8045,20 +7859,10 @@ var DslEditor = class {
 			captionClipIds: input.captions.map((c) => c.clipId ?? this.idFactory("clip")),
 			captionIds: input.captions.map(() => this.idFactory("caption"))
 		};
-		const state = this.dsl.getSnapshot();
-		const plainSegments = input.script.segments === void 0 ? state["audio-script-entities"][result.audioScriptId]?.segments.map((segment) => segment.id) ?? [] : result.segmentIds;
-		const plainPhoneticIds = input.script.phoneticScriptId === void 0 ? plainSegments.map((segmentId) => {
-			const origins = Object.values(state["derived-from-relations"]).filter((origin) => {
-				if (origin.entityId !== result.mediaId) return false;
-				return matchesPlainPhoneticOrigin(state, origin.sourceId, result.audioScriptId, segmentId);
-			});
-			if (origins.length > 1) throw new Error("Ambiguous plain recording origin");
-			return origins[0]?.sourceId ?? this.idFactory("phonetic-script");
-		}) : [];
 		this.write("applyVoiceover", {
 			input,
 			result
-		}, voiceoverPlan(state, input, result, plainPhoneticIds), options);
+		}, voiceoverPlan(this.dsl.getSnapshot(), input, result), options);
 		return result;
 	}
 	voiceoverScriptId(script) {
@@ -8075,12 +7879,8 @@ var DslEditor = class {
 	* it; an unchanged one keeps its file. Recordings already spoken from it keep their derived-from.
 	*/
 	async setPhoneticScript(input, options) {
-		this.dsl.assertWritable();
 		const id = input.phoneticScriptId ?? this.idFactory("phonetic-script");
 		const range = segmentRange(input);
-		assertId(id);
-		assertSegmentRange(range, requireSegment(this.dsl.getSnapshot(), range.audioScriptId, range.segmentId).text);
-		assertPhonemeScript(input.phonemeScript);
 		const file = input.phonemeScript === void 0 ? {} : await this.fileFor(id, input.phonemeScript);
 		const exists = Object.hasOwn(this.dsl.getSnapshot()["phonetic-script-entities"], id);
 		const cleared = {
@@ -8289,13 +8089,14 @@ function toVideoDraft(snapshot) {
 				duration_ms: clip.durationMs
 			};
 			if (track.role === "video_clip") {
-				if (!source || !["image", "video"].includes(source.kind) || source.system !== "memota") fail("Visual playback requires a memota Image or Video");
+				const placeholder = source?.system === "placeholder";
+				if (!source || !["image", "video"].includes(source.kind) || !(source.system === "memota" || placeholder)) fail("Visual playback requires a memota Image or Video, or a placeholder Image");
 				if (clip.fillTimeline) fail("VideoDraft cannot express timeline-filling visual content");
 				parts[clip.clipId] = { video_clip: {
 					...common,
 					play_in: clip.inMs,
 					play_out: clip.outMs,
-					origin_media_id: source.key,
+					origin_media_id: placeholder && source.key === BLANK_PLACEHOLDER.key ? "" : source.key,
 					volume: clip.volume,
 					...snapshot["clip-entities"][clip.clipId].seqMarker.rate === void 0 ? {} : { speed_shift: {
 						category: "linear",
@@ -8304,8 +8105,7 @@ function toVideoDraft(snapshot) {
 					} }
 				} };
 			} else if (track.role === "speech") {
-				if (!source || source.kind !== "audio" && source.kind !== "voiceover-recording") fail("Speech playback requires an Audio or VoiceoverRecording");
-				if (source.system !== "memota" && !(source.kind === "voiceover-recording" && source.system === "memota-speech")) fail("Speech playback requires a Memota audio file");
+				if (!source || source.kind !== "voiceover-recording" || source.system !== "memota-speech") fail("Legacy Speech requires a memota-speech VoiceoverRecording");
 				requireWholeAudio(source, clip, fail);
 				if (clip.fillTimeline) fail("Legacy Speech cannot express timeline fill");
 				const voices = Object.values(snapshot["voice-timbre-relations"]).filter((r) => r.recordingId === sourceId).flatMap((r) => snapshot["voice-entities"][r.voiceId] ? [snapshot["voice-entities"][r.voiceId]] : []);
@@ -8322,7 +8122,7 @@ function toVideoDraft(snapshot) {
 					audio_storage_key: source.storageKey,
 					origin_speech_id: source.key,
 					volume: clip.volume,
-					audio_script: source.kind === "voiceover-recording" ? spokenText(snapshot, sourceId) : "",
+					audio_script: spokenText(snapshot, sourceId),
 					voice: voice ? {
 						id: voice.key,
 						name: voice.name
@@ -8418,15 +8218,6 @@ function spokenText(snapshot, recordingId) {
 	if (!first) return "";
 	if (first.phoneticScriptId !== void 0) return snapshot.phoneticText[first.phoneticScriptId]?.text ?? "";
 	const script = snapshot["audio-script-entities"][first.audioScriptId];
-	if (first.phoneticScriptIds !== void 0 && script) {
-		const ids = first.phoneticScriptIds;
-		const selections = ids.map((id) => snapshot["phonetic-script-entities"][id]);
-		if (!(ids.length === script.segments.length && script.segments.every((segment) => {
-			const matching = ids.filter((id) => snapshot["phonetic-script-entities"][id]?.phoneme.segmentId === segment.id);
-			const run = matching.length === 1 ? snapshot.phoneticText[matching[0]] : void 0;
-			return run?.start === 0 && run.end === segment.text.length;
-		})) || selections.some((selection) => selection.phoneme.phonemeScript !== void 0)) projectionError("ambiguous-script", `media-entities/${recordingId}`, "Multiple phonetic sources require complete plain selections of one script");
-	}
 	return script ? script.segments.map((segment) => segment.text).join("\n") : "";
 }
 //#endregion
@@ -8517,6 +8308,7 @@ function prepare(input, options) {
 		if (facts.has(id)) fail("mediaFacts", `Duplicate facts for ${fact.system}/${fact.key}`);
 		facts.set(id, fact);
 	}
+	for (const fact of facts.values()) if (fact.system === "placeholder" && facts.has(resourceId("media", "memota", fact.key))) fail("mediaFacts", `Media cannot be both present and missing: ${fact.key}`);
 	const register = (media) => {
 		const id = resourceId("media", media.system, media.key), old = imported.get(id);
 		if (old) {
@@ -8542,6 +8334,15 @@ function prepare(input, options) {
 	const mediaByPart = /* @__PURE__ */ new Map(), scriptByRecording = /* @__PURE__ */ new Map(), scriptsByPart = /* @__PURE__ */ new Map();
 	const voices = /* @__PURE__ */ new Set();
 	for (const [id, p] of Object.entries(library)) if (p.video_clip) {
+		if (p.video_clip.origin_media_id === "") {
+			mediaByPart.set(id, register(BLANK_PLACEHOLDER));
+			continue;
+		}
+		const missing = p.video_clip.origin_media_id && facts.get(resourceId("media", "placeholder", p.video_clip.origin_media_id));
+		if (missing) {
+			mediaByPart.set(id, register(missing));
+			continue;
+		}
 		const fact = factFor("memota", p.video_clip.origin_media_id);
 		if (fact.kind !== "image" && fact.kind !== "video") fail(`part_library/${id}`, "Expected Image or Video facts");
 		mediaByPart.set(id, register(fact));
@@ -8765,5 +8566,122 @@ function importedScript(id, text, mintSegment) {
 		segments
 	};
 }
+function normalizeLegacyVideoDraft(input, mediaFacts = []) {
+	const draft = structuredClone(input);
+	const diagnostics = [];
+	const note = (code, path, message) => diagnostics.push({
+		code,
+		path,
+		message
+	});
+	const library = draft.part_library ?? {};
+	const tracks = [
+		...draft.above_main_tracks ?? [],
+		...draft.main_track ? [draft.main_track] : [],
+		...draft.below_main_tracks ?? []
+	];
+	const facts = new Map(mediaFacts.map((fact) => [resourceId("media", fact.system, fact.key), fact]));
+	const round = (owner, field, path) => {
+		const fields = owner;
+		const value = fields[field];
+		if (typeof value !== "number" || !Number.isFinite(value) || Number.isSafeInteger(value)) return;
+		const rounded = Math.round(value);
+		fields[field] = rounded;
+		note("legacy-time-rounded", `${path}/${field}`, `${value} → ${rounded}`);
+	};
+	for (const track of tracks) for (const item of track.items ?? []) round(item, "abs_time_position", `tracks/${track.id}/${item.part_id}`);
+	for (const [id, part] of Object.entries(library)) {
+		const path = `part_library/${id}`;
+		if (part.video_clip) for (const f of [
+			"play_in",
+			"play_out",
+			"duration_ms"
+		]) round(part.video_clip, f, path);
+		if (part.speech) for (const f of ["duration_ms", "media_duration_ms"]) round(part.speech, f, path);
+		if (part.caption) for (const f of [
+			"duration_ms",
+			"initial_duration_ms",
+			"start_ms"
+		]) round(part.caption, f, path);
+		if (part.bgm) round(part.bgm, "duration_ms", path);
+	}
+	for (const aggregation of draft.part_aggregations ?? []) for (const attachment of aggregation.attachments ?? []) round(attachment, "relative_time_position", `part_aggregations/${aggregation.body_part_id}/${attachment.part_id}`);
+	const dropped = /* @__PURE__ */ new Set();
+	const drop = (id, why) => {
+		dropped.add(id);
+		note("legacy-part-dropped", `part_library/${id}`, why);
+	};
+	for (const [id, part] of Object.entries(library)) {
+		const path = `part_library/${id}`;
+		const clip = part.video_clip;
+		const sound = part.bgm ?? part.speech;
+		const fact = part.bgm ? facts.get(resourceId("media", "memota", part.bgm.origin_media_id ?? "")) : part.speech && facts.get(resourceId("media", "memota-speech", part.speech.origin_speech_id ?? ""));
+		if (sound && fact && "storageKey" in fact && fact.storageKey && fact.storageKey !== sound.audio_storage_key) {
+			note("legacy-storage-key-current", `${path}/audio_storage_key`, `${sound.audio_storage_key} → ${fact.storageKey}`);
+			sound.audio_storage_key = fact.storageKey;
+		}
+		if (!clip) continue;
+		const rate = clip.speed_shift?.config?.linear?.speed ?? 1;
+		const inMs = clip.play_in ?? 0;
+		const outMs = clip.play_out ?? (clip.duration_ms === void 0 ? void 0 : inMs + Math.round(clip.duration_ms * rate));
+		const source = facts.get(resourceId("media", "memota", clip.origin_media_id ?? ""));
+		let windowEnd = outMs;
+		if (source?.kind === "video" && outMs !== void 0 && outMs > source.durationMs) {
+			windowEnd = source.durationMs;
+			if (windowEnd > inMs) {
+				note("legacy-window-cut", `${path}/play_out`, `${outMs} → ${windowEnd} (source length)`);
+				clip.play_out = windowEnd;
+				if (clip.duration_ms !== void 0) clip.duration_ms = Math.max(0, Math.round((windowEnd - inMs) / rate));
+			}
+		}
+		if (windowEnd === void 0) continue;
+		const length = windowEnd - inMs;
+		if (length <= 0) drop(id, `Empty window ${inMs}–${windowEnd}`);
+		else if (clip.origin_media_id === "" && length / rate < 40) drop(id, `Placeholder sliver of ${length / rate}ms`);
+	}
+	for (const id of dropped) delete library[id];
+	for (const track of tracks) track.items = track.items?.filter((item) => !dropped.has(item.part_id ?? ""));
+	const abs = /* @__PURE__ */ new Map();
+	for (const track of tracks) for (const item of track.items ?? []) abs.set(item.part_id ?? "", item.abs_time_position ?? 0);
+	const mainOrder = new Map((draft.main_track?.items ?? []).map((item, index) => [item.part_id ?? "", index]));
+	const candidates = /* @__PURE__ */ new Map();
+	for (const aggregation of draft.part_aggregations ?? []) {
+		const host = aggregation.body_part_id ?? "";
+		for (const attachment of aggregation.attachments ?? []) {
+			const speech = attachment.part_id ?? "";
+			const path = `part_aggregations/${host}/${speech}`;
+			if (!library[speech]?.speech) note("legacy-attachment-dropped", path, "Not a placed Speech");
+			else if (!library[host]?.video_clip || !mainOrder.has(host)) note("legacy-attachment-dropped", path, "Host is not a placed visual clip");
+			else candidates.set(speech, [...candidates.get(speech) ?? [], {
+				host,
+				offset: attachment.relative_time_position ?? 0
+			}]);
+		}
+	}
+	const chosen = /* @__PURE__ */ new Map();
+	for (const [speech, list] of candidates) {
+		if (list.length === 1) {
+			chosen.set(speech, list[0]);
+			continue;
+		}
+		const playing = list.filter((c) => (abs.get(c.host) ?? 0) + c.offset === abs.get(speech)).sort((a, b) => mainOrder.get(a.host) - mainOrder.get(b.host));
+		const pick = playing[0] ?? list[0];
+		chosen.set(speech, pick);
+		note(playing.length ? "legacy-speech-host-chosen" : "legacy-speech-host-unmatched", `part_aggregations/${pick.host}/${speech}`, `${list.length} hosts: ${list.map((c) => c.host).join(", ")}`);
+	}
+	const byHost = /* @__PURE__ */ new Map();
+	for (const [speech, { host, offset }] of chosen) byHost.set(host, [...byHost.get(host) ?? [], {
+		part_id: speech,
+		relative_time_position: offset
+	}]);
+	if (draft.part_aggregations) draft.part_aggregations = [...new Set(draft.part_aggregations.map((a) => a.body_part_id ?? ""))].filter((host) => byHost.has(host)).map((host) => ({
+		body_part_id: host,
+		attachments: byHost.get(host)
+	}));
+	return {
+		draft,
+		diagnostics
+	};
+}
 //#endregion
-export { tupleHash as S, resolveDslLayout as _, DslEditor as a, relationId as b, MedeoDsl as c, assertPhoneticBindingFormat as d, documentFormat as f, timeAnchorCodec as g, isInvalidAtomic as h, createInitialMedeoDsl as i, UnsupportedDocumentFormatError as l, captionContentCodec as m, toVideoDraft as n, spokenScripts as o, medeoDslLoroShape as p, DEFAULT_UNIT_TIME_MS as r, toAudioScriptViews as s, fromVideoDraft as t, assertDslDocument as u, DslProjectionError as v, resourceId as x, defaultIdFactory as y };
+export { tupleHash as C, resourceId as S, DslProjectionError as _, createInitialMedeoDsl as a, defaultIdFactory as b, MedeoDsl as c, documentFormat as d, medeoDslLoroShape as f, resolveDslLayout as g, timeAnchorCodec as h, DEFAULT_UNIT_TIME_MS as i, UnsupportedDocumentFormatError as l, isInvalidAtomic as m, fromVideoDraft as n, DslEditor as o, captionContentCodec as p, toVideoDraft as r, toAudioScriptViews as s, normalizeLegacyVideoDraft as t, assertDslDocument as u, BLANK_PLACEHOLDER as v, relationId as x, missingMediaPlaceholder as y };