@mengine/medeo-client 2.1.1-dsl.4 → 2.1.1-dsl.6

package/dist/{dsl-BCcld0Ca.js → dsl-DbYqFFOb.js}

@@ -1,4 +1,4 @@
-import { $ as assertId, A as hardenCidDescriptors, B as safeStringify, C as applySchemaToInferOptions, D as deepEqual, E as decodeNestedJsonValues, F as isObject, G as valuesEqual, H as stripUndefined, I as isObjectLike, J as getChildSchema, K as CID_KEY, L as isStateAndSchemaOfType, M as inferContainerTypeFromValue, N as insertChildToMap, O as defineCidProperty, P as isArrayLike, Q as assertEntityPatch, R as isTreeID, S as applyEncode, T as containerIdToContainerType, U as tryInferContainerType, V as schemaToContainerType, W as tryUpdateToContainer, X as assertCaptionContent, Y as getMapFieldSchema, Z as assertEntity, _ as isLoroTreeSchema, at as isRecord, b as validateSchema, c as isInvalidAtomic, ct as relationTables, d as getDefaultValue, dt as assertResourceIdentity, et as assertPhoneme, f as isContainerSchema, ft as defaultIdFactory, g as isLoroMovableListSchema, h as isLoroMapSchema, it as entityTables, j as hasTransform, k as getRootContainerByType, lt as validLanguage, m as isLoroListSchema, mt as resourceId, n as textStyles, nt as assertTimeAnchor, o as medeoDslLoroShape, ot as mergeFields, p as isListLikeSchema, pt as relationId, q as getChildContainerSchema, rt as atomicFields, s as captionContentCodec, st as patchRow, t as DEFAULT_UNIT_TIME_MS, tt as assertRelation, u as schema, ut as assertRelationIdentity, v as isRootSchemaType, w as cidsEqual, x as applyDecode, y as schemaContainsIgnoreField, z as isValueOfContainerType } from "./video-draft-types-DvPeam87.js";
+import { $ as assertId, A as hardenCidDescriptors, B as safeStringify, C as applySchemaToInferOptions, D as deepEqual, E as decodeNestedJsonValues, F as isObject, G as valuesEqual, H as stripUndefined, I as isObjectLike, J as getChildSchema, K as CID_KEY, L as isStateAndSchemaOfType, M as inferContainerTypeFromValue, N as insertChildToMap, O as defineCidProperty, P as isArrayLike, Q as assertEntityPatch, R as isTreeID, S as applyEncode, T as containerIdToContainerType, U as tryInferContainerType, V as schemaToContainerType, W as tryUpdateToContainer, X as assertCaptionContent, Y as getMapFieldSchema, Z as assertEntity, _ as isLoroTreeSchema, at as isRecord, b as validateSchema, c as isInvalidAtomic, ct as relationTables, d as getDefaultValue, dt as assertResourceIdentity, et as assertPhoneme, f as isContainerSchema, ft as defaultIdFactory, g as isLoroMovableListSchema, h as isLoroMapSchema, it as entityTables, j as hasTransform, k as getRootContainerByType, lt as validLanguage, m as isLoroListSchema, mt as resourceId, n as textStyles, nt as assertTimeAnchor, o as medeoDslLoroShape, ot as mergeFields, p as isListLikeSchema, pt as relationId, q as getChildContainerSchema, rt as atomicFields, s as captionContentCodec, st as patchRow, t as DEFAULT_UNIT_TIME_MS, tt as assertRelation, u as schema, ut as assertRelationIdentity, v as isRootSchemaType, w as cidsEqual, x as applyDecode, y as schemaContainsIgnoreField, z as isValueOfContainerType } from "./video-draft-types-Ce8NDenQ.js";
 import { Cursor, LoroDoc, LoroList, LoroMap, LoroMovableList, LoroText, LoroTree, isContainer, isContainerId } from "loro-crdt";
 import { Immer, setAutoFreeze } from "immer";
 //#region ../medeo-dsl/src/text.ts
@@ -107,6 +107,42 @@ function prepareTextEdits(text, edits) {
 		body: text
 	};
 }
+/** An empty body has no segments; otherwise each line, including a trailing empty one, is a segment. */
+function lines(body) {
+	if (body === "") return [];
+	const result = [];
+	let start = 0;
+	for (const text of body.split("\n")) {
+		result.push({
+			text,
+			start,
+			end: start + text.length
+		});
+		start += text.length + 1;
+	}
+	return result;
+}
+/** The language a whole line carries: one shared mark on every unit, else none. */
+function lineLanguage(text, line) {
+	if (line.start === line.end) return void 0;
+	const first = text.langs[line.start];
+	for (let i = line.start + 1; i < line.end; i++) if (text.langs[i] !== first) return void 0;
+	return first;
+}
+/** Read language marks off a rich-text delta. */
+function langsFromDelta(delta) {
+	let body = "";
+	const langs = [];
+	for (const run of delta) {
+		body += run.insert;
+		const language = typeof run.attributes?.language === "string" ? run.attributes.language : void 0;
+		for (let i = 0; i < run.insert.length; i++) langs.push(language);
+	}
+	return {
+		body,
+		langs
+	};
+}
 //#endregion
 //#region ../medeo-dsl/src/relations.ts
 /** The row an endpoint names; refused when it is missing. */
@@ -291,6 +327,7 @@ function assertChangeAdmitted(change) {
 		for (const field of referenceFields[table] ?? []) if (!old || fields.has(field)) assertReferenceAdmitted(after, table, id, field, row[field]);
 		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) {
@@ -298,6 +335,16 @@ function assertChangeAdmitted(change) {
 		if (value !== void 0) assertRelationAdmitted(after, table, id, value);
 	}
 }
+/**
+* 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
 /** Unsupported legacy representations fail explicitly; recoverable CRDT state is returned as diagnostics. */
@@ -4261,7 +4308,7 @@ function applyMutations(tx, mutations) {
 				assertRelation(m.table, m.value);
 				const id = relationId(m.table, m.value);
 				rows[m.table][id] ??= {};
-				applyPatch(rows[m.table][id], m.value);
+				applyPatch(rows[m.table][id], withSourceDigest(rows, m.table, m.value));
 				break;
 			}
 			case "delete-relation":
@@ -4280,6 +4327,25 @@ function applyMutations(tx, mutations) {
 		}
 	}
 }
+/**
+* A derived-from records its source's digest (D177): the one the writer names, otherwise the
+* source's digest as this transaction leaves it. A source with no digest records none.
+*/
+function withSourceDigest(rows, table, value) {
+	if (table !== "derived-from-relations") return value;
+	const relation = value;
+	if (relation.sourceDigest !== void 0) return value;
+	const sourceDigest = digestOf(rows, relation.sourceId);
+	return sourceDigest === void 0 ? value : {
+		...relation,
+		sourceDigest
+	};
+}
+/** A source's digest is its file's: a PhoneticScript's or a medium's Media File `digest`. */
+function digestOf(rows, entityId) {
+	const digest = (rows["phonetic-script-entities"][entityId] ?? rows["media-entities"][entityId])?.digest;
+	return typeof digest === "string" ? digest : void 0;
+}
 //#endregion
 //#region src/dsl/document/native-text.ts
 function applyTextEdits(text, edits) {
@@ -4764,6 +4830,8 @@ function voiceoverPlan(s, input, result) {
 		}
 	});
 	else if (!s["audio-script-entities"][result.audioScriptId]) throw new Error("Missing AudioScript");
+	const phoneticScriptId = input.script.phoneticScriptId;
+	if (phoneticScriptId !== void 0 && s["phonetic-script-entities"][phoneticScriptId]?.phoneme.audioScriptId !== result.audioScriptId) throw new Error("The PhoneticScript must name this AudioScript as its base");
 	validateWindow({
 		inMs: 0,
 		outMs: input.media.durationMs
@@ -4773,7 +4841,8 @@ function voiceoverPlan(s, input, result) {
 		table: "derived-from-relations",
 		value: {
 			entityId: result.mediaId,
-			sourceId: result.audioScriptId
+			sourceId: phoneticScriptId ?? result.audioScriptId,
+			...input.sourceDigest === void 0 ? {} : { sourceDigest: input.sourceDigest }
 		}
 	});
 	if (input.voice) {
@@ -4899,9 +4968,11 @@ function voiceoverPlan(s, input, result) {
 var DslEditor = class {
 	dsl;
 	idFactory;
-	constructor(dsl, idFactory = defaultIdFactory) {
+	uploadText;
+	constructor(dsl, idFactory = defaultIdFactory, uploadText) {
 		this.dsl = dsl;
 		this.idFactory = idFactory;
+		this.uploadText = uploadText;
 	}
 	createTrack(role, options) {
 		const id = this.idFactory("track");
@@ -5191,7 +5262,7 @@ var DslEditor = class {
 		const result = {
 			clipId: input.clipId ?? this.idFactory("clip"),
 			mediaId: resourceId("media", input.media.system, input.media.key),
-			audioScriptId: input.script.audioScriptId ?? this.idFactory("audio-script"),
+			audioScriptId: this.voiceoverScriptId(input.script),
 			captionClipIds: input.captions.map((c) => c.clipId ?? this.idFactory("clip")),
 			captionIds: input.captions.map(() => this.idFactory("caption"))
 		};
@@ -5201,6 +5272,71 @@ var DslEditor = class {
 		}, voiceoverPlan(this.dsl.getSnapshot(), input, result), options);
 		return result;
 	}
+	voiceoverScriptId(script) {
+		if (script.audioScriptId !== void 0) return script.audioScriptId;
+		if (script.phoneticScriptId === void 0) return this.idFactory("audio-script");
+		const phonetic = this.dsl.getSnapshot()["phonetic-script-entities"][script.phoneticScriptId];
+		if (!phonetic) throw new Error("Missing PhoneticScript");
+		return phonetic.phoneme.audioScriptId;
+	}
+	/**
+	* Write a PhoneticScript: create one for `audioScriptId`, or, given `phoneticScriptId`, replace its
+	* base and pronunciation together. A `phonemeScript` is stored as a Memota text file first, and
+	* the file's facts are written with it; an unchanged one keeps its file. Recordings already spoken
+	* from it keep their derived-from.
+	*/
+	async setPhoneticScript(input, options) {
+		const id = input.phoneticScriptId ?? this.idFactory("phonetic-script");
+		const phoneme = {
+			audioScriptId: input.audioScriptId,
+			...input.phonemeScript === void 0 ? {} : { phonemeScript: 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 = {
+			system: void 0,
+			key: void 0,
+			storageKey: void 0,
+			digest: void 0
+		};
+		this.write("setPhoneticScript", {
+			id,
+			phoneme,
+			...cleared,
+			...file
+		}, [exists ? {
+			type: "patch-entity",
+			table: "phonetic-script-entities",
+			id,
+			patch: {
+				phoneme: {
+					...phoneme,
+					phonemeScript: input.phonemeScript
+				},
+				...cleared,
+				...file
+			}
+		} : {
+			type: "create-entity",
+			table: "phonetic-script-entities",
+			id,
+			value: {
+				phoneme,
+				...file
+			}
+		}], options);
+		return id;
+	}
+	/** The file holding `text`: the one the PhoneticScript keeps while its text is unchanged, else a new upload. */
+	async fileFor(id, text) {
+		const current = this.dsl.getSnapshot()["phonetic-script-entities"][id];
+		if (current?.phoneme.phonemeScript === text) {
+			const { phoneme: _, ...file } = current;
+			return file;
+		}
+		if (!this.uploadText) throw new Error("This editor stores no files");
+		return this.uploadText(text);
+	}
 	setBgm(input, options) {
 		const s = this.dsl.getSnapshot();
 		if (requireTrack(s, input.trackId).role !== "bgm") throw new Error("Expected a BGM Track");
@@ -5295,6 +5431,131 @@ function createInitialMedeoDsl(options = {}) {
 	}
 }
 //#endregion
+//#region src/dsl/projection/audio-scripts.ts
+/**
+* The scripts a recording says. It follows derived-from from the recording; a PhoneticScript is a
+* variant, so its words are the base its phoneme names, and derived-from is not followed past it.
+* When nothing is found that way, a script read off the recording itself is what it says.
+*/
+function spokenScripts(snapshot, recordingId) {
+	const relations = Object.values(snapshot["derived-from-relations"]);
+	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, phoneticScriptId);
+			return;
+		}
+		const phonetic = snapshot["phonetic-script-entities"][id];
+		if (phonetic) {
+			visit(phonetic.phoneme.audioScriptId, id);
+			return;
+		}
+		for (const r of relations) if (r.entityId === id) visit(r.sourceId, phoneticScriptId);
+	};
+	visit(recordingId);
+	if (!found.size) {
+		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, 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. */
+function toAudioScriptViews(snapshot) {
+	const views = /* @__PURE__ */ new Map();
+	const bodies = /* @__PURE__ */ new Map();
+	for (const [id, script] of Object.entries(snapshot["audio-script-entities"])) {
+		const rich = snapshot.richText[id];
+		const text = rich ? langsFromDelta(rich.delta) : {
+			body: script.body,
+			langs: []
+		};
+		bodies.set(id, text.body);
+		views.set(id, {
+			id,
+			segments: lines(text.body).map((line) => {
+				const language = lineLanguage(text, line);
+				return language === void 0 ? { text: line.text } : {
+					text: line.text,
+					language
+				};
+			}),
+			sourceMediaIds: [],
+			phoneticScripts: [],
+			speeches: [],
+			captions: []
+		});
+	}
+	for (const r of Object.values(snapshot["derived-from-relations"])) if (snapshot["media-entities"][r.sourceId]) views.get(r.entityId)?.sourceMediaIds.push(r.sourceId);
+	for (const [id, phonetic] of Object.entries(snapshot["phonetic-script-entities"])) {
+		const { phonemeScript } = phonetic.phoneme;
+		const { digest } = phonetic;
+		views.get(phonetic.phoneme.audioScriptId)?.phoneticScripts.push({
+			id,
+			...phonemeScript === void 0 ? {} : { phonemeScript },
+			...digest === void 0 ? {} : { digest }
+		});
+	}
+	const timbres = Object.values(snapshot["voice-timbre-relations"]);
+	for (const track of resolveDslLayout(snapshot).tracks) for (const { clipId } of track.clips) {
+		const source = snapshot["clip-entities"][clipId]?.source;
+		if (!source) continue;
+		if (snapshot["media-entities"][source]?.kind === "voiceover-recording") {
+			const voices = timbres.filter((r) => r.recordingId === source).flatMap((r) => {
+				const voice = snapshot["voice-entities"][r.voiceId];
+				if (!voice) return [];
+				return [voice.name === void 0 ? {
+					voiceId: r.voiceId,
+					key: voice.key
+				} : {
+					voiceId: r.voiceId,
+					key: voice.key,
+					name: voice.name
+				}];
+			});
+			for (const spoken of spokenScripts(snapshot, source)) {
+				const applied = appliedSpeech(snapshot, source, spoken);
+				views.get(spoken.audioScriptId)?.speeches.push({
+					clipId,
+					recordingId: source,
+					...spoken.phoneticScriptId === void 0 ? {} : { phoneticScriptId: spoken.phoneticScriptId },
+					voices,
+					...applied === void 0 ? {} : { applied }
+				});
+			}
+			continue;
+		}
+		const caption = snapshot["caption-entities"][source];
+		const shown = snapshot.captionText[source];
+		if (!caption?.selection || caption.text !== void 0 || !shown) continue;
+		const scriptId = caption.selection.audioScriptId;
+		const body = bodies.get(scriptId);
+		if (body === void 0) continue;
+		const segment = lines(body).findIndex((line) => shown.start >= line.start && shown.end <= line.end);
+		if (segment >= 0) views.get(scriptId)?.captions.push({
+			clipId,
+			captionId: source,
+			segment
+		});
+	}
+	return [...views.values()];
+}
+/**
+* Whether a recording still matches what it was synthesized from: the digest its derived-from
+* records against the source's file digest now. An AudioScript has no file, so a recording
+* derived from a script directly is not judged.
+*/
+function appliedSpeech(snapshot, recordingId, spoken) {
+	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/projection/caption-style.ts
 const fields = {
 	fontSize: "font_size",
@@ -5383,7 +5644,7 @@ function toVideoDraft(snapshot) {
 					audio_storage_key: source.storageKey,
 					origin_speech_id: source.key,
 					volume: clip.volume,
-					audio_script: spokenText(snapshot, sourceId),
+					audio_script: spokenText(snapshot, sourceId, captionIds),
 					voice: voice ? {
 						id: voice.key,
 						name: voice.name
@@ -5468,30 +5729,30 @@ function toVideoDraft(snapshot) {
 function requireWholeAudio(media, clip, fail) {
 	if (media.kind === "image" || clip.inMs !== 0 || clip.outMs !== media.durationMs || clip.rate !== 1) fail("VideoDraft audio has no trim or speed fields");
 }
-function spokenText(snapshot, recordingId) {
-	const relations = Object.values(snapshot["derived-from-relations"]);
-	const scripts = /* @__PURE__ */ new Set(), seen = /* @__PURE__ */ new Set();
-	const visit = (id) => {
-		if (seen.has(id)) return;
-		seen.add(id);
-		if (snapshot["audio-script-entities"][id]) {
-			scripts.add(id);
-			return;
-		}
-		const phonetic = snapshot["phonetic-script-entities"][id];
-		if (phonetic) {
-			visit(phonetic.phoneme.audioScriptId);
-			return;
-		}
-		for (const r of relations) if (r.entityId === id) visit(r.sourceId);
-	};
-	visit(recordingId);
-	if (!scripts.size) {
-		for (const r of relations) if (r.sourceId === recordingId && snapshot["audio-script-entities"][r.entityId]) scripts.add(r.entityId);
-	}
+/**
+* The words a speech Clip says. A script voiced in several takes is said one part per take, and
+* the Captions following the Clip select that part: its words are the segments they select, in
+* script order. A Clip no Caption of its script follows says the whole script.
+*/
+function spokenText(snapshot, recordingId, captionClipIds) {
+	const scripts = new Set(spokenScripts(snapshot, recordingId).map((spoken) => spoken.audioScriptId));
 	if (scripts.size > 1) projectionError("ambiguous-script", `media-entities/${recordingId}`, "Multiple scripts cannot be silently concatenated into audio_script");
 	const id = [...scripts][0];
-	return id ? snapshot.richText[id]?.plainText ?? "" : "";
+	if (!id) return "";
+	const body = snapshot.richText[id]?.plainText ?? "";
+	const segments = lines(body);
+	const said = /* @__PURE__ */ new Set();
+	for (const clipId of captionClipIds) {
+		const captionId = snapshot["clip-entities"][clipId]?.source;
+		const caption = captionId === void 0 ? void 0 : snapshot["caption-entities"][captionId];
+		const shown = captionId === void 0 ? void 0 : snapshot.captionText[captionId];
+		if (caption?.selection?.audioScriptId !== id || caption.text !== void 0 || !shown) continue;
+		segments.forEach((line, index) => {
+			if (shown.start < Math.max(line.end, line.start + 1) && shown.end > line.start) said.add(index);
+		});
+	}
+	if (!said.size) return body;
+	return [...said].sort((a, b) => a - b).map((index) => segments[index].text).join("\n");
 }
 //#endregion
 //#region src/dsl/projection/from-video-draft.ts
@@ -5807,4 +6068,4 @@ function milliseconds(value, path, positive = false, signed = false) {
 	return value;
 }
 //#endregion
-export { MedeoDsl as a, DslEditor as i, toVideoDraft as n, resolveDslLayout as o, createInitialMedeoDsl as r, DslProjectionError as s, fromVideoDraft as t };
+export { DslEditor as a, DslProjectionError as c, createInitialMedeoDsl as i, toVideoDraft as n, MedeoDsl as o, toAudioScriptViews as r, resolveDslLayout as s, fromVideoDraft as t };

package/dist/dsl.d.ts

@@ -1,3 +1,3 @@
-import { $ as TrackRole, A as DeepReadonly, B as RelationMutation, C as CaptionContent, D as Clip, E as CaptionText, F as EntityTables, G as RichTextSnapshot, H as RelationTables, I as EntityValues, J as TextMark, K as TextDelta, L as FieldPatch, M as DslMutation, N as EntityMutation, O as ContainMutation, P as EntityTable, Q as Track, R as MedeoDslSnapshot, S as Caption, T as CaptionStyle, U as RelationValues, V as RelationTable, W as ResourceSystem, X as TextRun, Y as TextMutation, Z as TimeAnchor, _ as defaultIdFactory, a as VideoDraftCaptionStyle, b as tupleHash, c as VideoDraftInput, d as VideoDraftTrack, et as Voice, f as VideoDraftTrackItem, g as EntityIdKind, h as DslIdFactory, i as VideoDraft, j as DslDiagnostic, k as ContainNode, l as VideoDraftPartUnion, m as OpActor, n as DEFAULT_UNIT_TIME_MS, o as VideoDraftContent, p as CommitOptions, q as TextEdit, r as VideoCreationSettings, s as VideoDraftContentPartUnion, t as CaptionDisplayCue, u as VideoDraftTimeline, v as relationId, w as CaptionSelection, x as AudioScript, y as resourceId, z as Media } from "./video-draft-types-BfkIuW5f.js";
-import { A as AddDslClip, C as InvalidAtomic, D as MedeoDslDraft, E as timeAnchorCodec, F as ReplaceDslClipsInput, I as ClipPlacement, M as ClipSource, N as DslClipUpdate, O as MedeoDslLoroState, P as MoveDslClipsInput, S as documentFormat, T as isInvalidAtomic, _ as MedeoDsl, a as toVideoDraft, b as UnsupportedDocumentFormatError, c as DslLayout, d as createInitialMedeoDsl, f as DslEditor, g as CreateMedeoDslOptions, h as VoiceoverResult, i as VideoDraftProjection, j as AddDslClipsInput, k as medeoDslLoroShape, l as DslProjectionError, m as VoiceoverCaptionInput, n as ImportedVideoDraft, o as resolveDslLayout, p as ApplyVoiceoverInput, r as fromVideoDraft, s as DslClipLayout, t as FromVideoDraftOptions, u as DslTrackLayout, v as DslAudit, w as captionContentCodec, x as assertDslDocument, y as DslTransaction } from "./index-DP9FG0z_.js";
-export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, type Media, type MoveDslClipsInput, type OpActor, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+import { $ as Track, A as DeepReadonly, B as RelationMutation, C as CaptionContent, D as Clip, E as CaptionText, F as EntityTables, G as RichTextSnapshot, H as RelationTables, I as EntityValues, J as TextEdit, K as StoredFile, L as FieldPatch, M as DslMutation, N as EntityMutation, O as ContainMutation, P as EntityTable, Q as TimeAnchor, R as MedeoDslSnapshot, S as Caption, T as CaptionStyle, U as RelationValues, V as RelationTable, W as ResourceSystem, X as TextMutation, Y as TextMark, Z as TextRun, _ as defaultIdFactory, a as VideoDraftCaptionStyle, b as tupleHash, c as VideoDraftInput, d as VideoDraftTrack, et as TrackRole, f as VideoDraftTrackItem, g as EntityIdKind, h as DslIdFactory, i as VideoDraft, j as DslDiagnostic, k as ContainNode, l as VideoDraftPartUnion, m as OpActor, n as DEFAULT_UNIT_TIME_MS, o as VideoDraftContent, p as CommitOptions, q as TextDelta, r as VideoCreationSettings, s as VideoDraftContentPartUnion, t as CaptionDisplayCue, tt as Voice, u as VideoDraftTimeline, v as relationId, w as CaptionSelection, x as AudioScript, y as resourceId, z as Media } from "./video-draft-types-Bq15tPBP.js";
+import { A as MedeoDslDraft, C as UnsupportedDocumentFormatError, D as captionContentCodec, E as InvalidAtomic, F as ClipSource, I as DslClipUpdate, L as MoveDslClipsInput, M as medeoDslLoroShape, N as AddDslClip, O as isInvalidAtomic, P as AddDslClipsInput, R as ReplaceDslClipsInput, S as DslTransaction, T as documentFormat, _ as VoiceoverCaptionInput, a as toAudioScriptViews, b as MedeoDsl, c as resolveDslLayout, d as DslProjectionError, f as DslTrackLayout, g as ApplyVoiceoverInput, h as UploadText, i as AudioScriptView, j as MedeoDslLoroState, k as timeAnchorCodec, l as DslClipLayout, m as DslEditor, n as ImportedVideoDraft, o as VideoDraftProjection, p as createInitialMedeoDsl, r as fromVideoDraft, s as toVideoDraft, t as FromVideoDraftOptions, u as DslLayout, v as VoiceoverResult, w as assertDslDocument, x as DslAudit, y as CreateMedeoDslOptions, z as ClipPlacement } from "./index-DHcMMn2M.js";
+export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, type Media, type MoveDslClipsInput, type OpActor, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type StoredFile, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type UploadText, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/dsl.js

@@ -1,3 +1,3 @@
-import { a as documentFormat, c as isInvalidAtomic, ft as defaultIdFactory, ht as tupleHash, i as assertDslDocument, l as timeAnchorCodec, mt as resourceId, o as medeoDslLoroShape, pt as relationId, r as UnsupportedDocumentFormatError, s as captionContentCodec, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-DvPeam87.js";
-import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, o as resolveDslLayout, r as createInitialMedeoDsl, s as DslProjectionError, t as fromVideoDraft } from "./dsl-BCcld0Ca.js";
-export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, MedeoDsl, UnsupportedDocumentFormatError, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+import { a as documentFormat, c as isInvalidAtomic, ft as defaultIdFactory, ht as tupleHash, i as assertDslDocument, l as timeAnchorCodec, mt as resourceId, o as medeoDslLoroShape, pt as relationId, r as UnsupportedDocumentFormatError, s as captionContentCodec, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-Ce8NDenQ.js";
+import { a as DslEditor, c as DslProjectionError, i as createInitialMedeoDsl, n as toVideoDraft, o as MedeoDsl, r as toAudioScriptViews, s as resolveDslLayout, t as fromVideoDraft } from "./dsl-DbYqFFOb.js";
+export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, MedeoDsl, UnsupportedDocumentFormatError, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/{index-W1eHhVus.d.ts → index-Cx5DojM1.d.ts}

@@ -1,6 +1,6 @@
-import { $ as TrackRole, R as MedeoDslSnapshot, W as ResourceSystem } from "./video-draft-types-BfkIuW5f.js";
-import { _ as MedeoDsl, f as DslEditor, i as VideoDraftProjection } from "./index-DP9FG0z_.js";
-import { _ as ManualSyncTransport, a as MengineDocSessionOptions, g as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-CwG4lYKp.js";
+import { R as MedeoDslSnapshot, W as ResourceSystem, et as TrackRole } from "./video-draft-types-Bq15tPBP.js";
+import { b as MedeoDsl, h as UploadText, i as AudioScriptView, m as DslEditor, o as VideoDraftProjection } from "./index-DHcMMn2M.js";
+import { _ as ManualSyncTransport, a as MengineDocSessionOptions, g as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-Dpl4bT94.js";
 
 //#region src/manual-sync/manual-sync-doc.d.ts
 /** Explicit synchronization over the same DSL/editor used by the live Session. */
@@ -8,7 +8,10 @@ declare class ManualSyncDoc extends ManualSyncTransport {
   readonly dsl: MedeoDsl;
   readonly editor: DslEditor;
   private constructor();
-  static open(options: ManualSyncDocOptions): Promise<ManualSyncDoc>;
+  /** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
+  static open(options: ManualSyncDocOptions & {
+    uploadText?: UploadText;
+  }): Promise<ManualSyncDoc>;
   snapshot(): {
     readonly "timeline-entities": {
       readonly [x: string]: {
@@ -73,6 +76,10 @@ declare class ManualSyncDoc extends ManualSyncTransport {
           readonly audioScriptId: string;
           readonly phonemeScript?: string | undefined;
         };
+        readonly system?: "memota" | undefined;
+        readonly key?: string | undefined;
+        readonly storageKey?: string | undefined;
+        readonly digest?: string | undefined;
       };
     };
     readonly "caption-entities": {
@@ -117,6 +124,7 @@ declare class ManualSyncDoc extends ManualSyncTransport {
       readonly [x: string]: {
         readonly entityId: string;
         readonly sourceId: string;
+        readonly sourceDigest?: string | undefined;
       };
     };
     readonly 'contain-relations': readonly {
@@ -158,9 +166,14 @@ declare class ManualSyncDoc extends ManualSyncTransport {
 type MengineDocSessionUpdateEvent = DocumentSessionUpdateEvent<MedeoDslSnapshot>;
 /** Default collaborative session: one DSL handle and one editor over the synchronized LoroDoc. */
 declare class MengineDocSession extends DocumentSession<MedeoDslSnapshot, DslEditor, MedeoDsl> {
-  constructor(options: MengineDocSessionOptions);
+  /** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
+  constructor(options: MengineDocSessionOptions & {
+    uploadText?: UploadText;
+  });
   get dsl(): MedeoDsl;
   projectVideoDraft(): VideoDraftProjection;
+  /** The document's AudioScripts with what says and shows them; read from the same snapshot as the VideoDraft. */
+  projectAudioScripts(): AudioScriptView[];
 }
 //#endregion
 export { MengineDocSessionUpdateEvent as n, ManualSyncDoc as r, MengineDocSession as t };

package/dist/{index-DP9FG0z_.d.ts → index-DHcMMn2M.d.ts}

@@ -1,4 +1,4 @@
-import { $ as TrackRole, C as CaptionContent, L as FieldPatch, M as DslMutation, R as MedeoDslSnapshot, T as CaptionStyle, Z as TimeAnchor, c as VideoDraftInput, et as Voice, h as DslIdFactory, j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions, q as TextEdit, w as CaptionSelection, z as Media } from "./video-draft-types-BfkIuW5f.js";
+import { C as CaptionContent, J as TextEdit, K as StoredFile, L as FieldPatch, M as DslMutation, Q as TimeAnchor, R as MedeoDslSnapshot, T as CaptionStyle, c as VideoDraftInput, et as TrackRole, h as DslIdFactory, j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions, tt as Voice, w as CaptionSelection, z as Media } from "./video-draft-types-Bq15tPBP.js";
 import { ContainerType, Cursor, LoroDoc, PeerID, TreeID } from "loro-crdt";
 
 //#region src/dsl/action-context.d.ts
@@ -476,11 +476,19 @@ declare const medeoDslLoroShape: RootSchemaType<{
   };
   'phonetic-script-entities': LoroMapSchemaWithCatchall<{}, LoroMapSchema<{
     phoneme: /*elided*/any;
+    system: /*elided*/any;
+    key: /*elided*/any;
+    storageKey: /*elided*/any;
+    digest: /*elided*/any;
   }> & {
     options: {};
   } & {
     catchall: <C extends SchemaType>(catchallSchema: C) => LoroMapSchemaWithCatchall<{
       phoneme: /*elided*/any;
+      system: /*elided*/any;
+      key: /*elided*/any;
+      storageKey: /*elided*/any;
+      digest: /*elided*/any;
     }, C>;
   }> & {
     options: {};
@@ -545,24 +553,18 @@ declare const medeoDslLoroShape: RootSchemaType<{
       readonly mergeableMapChildContainers: true;
     };
   };
-  'derived-from-relations': LoroMapSchemaWithCatchall<{}, LoroMapSchema<Record<string, StringSchemaType<string> & {
-    options: {};
-  } & {
-    transform: <D>(def: TransformDefinition<string, D>) => StringSchemaType<string> & {
-      options: {};
-      transform: TransformDefinition<string, D>;
-    };
-  }>> & {
+  'derived-from-relations': LoroMapSchemaWithCatchall<{}, LoroMapSchema<{
+    entityId: /*elided*/any;
+    sourceId: /*elided*/any;
+    sourceDigest: /*elided*/any;
+  }> & {
     options: {};
   } & {
-    catchall: <C extends SchemaType>(catchallSchema: C) => LoroMapSchemaWithCatchall<Record<string, StringSchemaType<string> & {
-      options: {};
-    } & {
-      transform: <D>(def: TransformDefinition<string, D>) => StringSchemaType<string> & {
-        options: {};
-        transform: TransformDefinition<string, D>;
-      };
-    }>, C>;
+    catchall: <C extends SchemaType>(catchallSchema: C) => LoroMapSchemaWithCatchall<{
+      entityId: /*elided*/any;
+      sourceId: /*elided*/any;
+      sourceDigest: /*elided*/any;
+    }, C>;
   }> & {
     options: {
       readonly mergeableMapChildContainers: true;
@@ -697,15 +699,31 @@ interface ApplyVoiceoverInput {
   }> & {
     kind: 'voiceover-recording';
   };
+  /**
+   * What the recording says: an existing AudioScript, a new one from `body`, or a PhoneticScript it
+   * was spoken from. A recording spoken from a PhoneticScript is derived-from it, and its captions
+   * select that variant's base script.
+   */
   script: {
     audioScriptId: string;
     body?: never;
+    phoneticScriptId?: never;
   } | {
     body: string;
     audioScriptId?: never;
+    phoneticScriptId?: never;
     defaultLanguage?: string;
+  } | {
+    phoneticScriptId: string;
+    audioScriptId?: never;
+    body?: never;
   };
   placement: ClipPlacement;
+  /**
+   * The digest of what the recording was synthesized from (D177): the PhoneticScript as it was
+   * read for synthesis. Absent, the source's digest as this voiceover leaves it is recorded.
+   */
+  sourceDigest?: string;
   volume?: number;
   voice?: Voice;
   /** Complete generated caption set for this use. Other uses of the recording are untouched. */
@@ -720,11 +738,17 @@ interface VoiceoverResult {
 }
 //#endregion
 //#region src/dsl/dsl-editor.d.ts
+/**
+ * Stores raw content in Memota as a text file and returns the file's facts. The host owns the
+ * store; an entity with the Media File trait keeps the facts beside the content (D178).
+ */
+type UploadText = (text: string) => Promise<StoredFile>;
 /** Business edits write DSL facts in one audited transaction; layout is derived on read. */
 declare class DslEditor {
   readonly dsl: MedeoDsl;
   private readonly idFactory;
-  constructor(dsl: MedeoDsl, idFactory?: DslIdFactory);
+  private readonly uploadText?;
+  constructor(dsl: MedeoDsl, idFactory?: DslIdFactory, uploadText?: UploadText | undefined);
   createTrack(role: TrackRole, options?: CommitOptions): string;
   registerMedia(media: Media, options?: CommitOptions): string;
   addClips(input: AddDslClipsInput, options?: CommitOptions): string[];
@@ -770,6 +794,20 @@ declare class DslEditor {
   updateClips(updates: readonly DslClipUpdate[], options?: CommitOptions): void;
   patchCaptionStyle(captionIds: readonly string[], patch: FieldPatch<CaptionStyle>, options?: CommitOptions): void;
   applyVoiceover(input: ApplyVoiceoverInput, options?: CommitOptions): VoiceoverResult;
+  private voiceoverScriptId;
+  /**
+   * Write a PhoneticScript: create one for `audioScriptId`, or, given `phoneticScriptId`, replace its
+   * base and pronunciation together. A `phonemeScript` is stored as a Memota text file first, and
+   * the file's facts are written with it; an unchanged one keeps its file. Recordings already spoken
+   * from it keep their derived-from.
+   */
+  setPhoneticScript(input: {
+    phoneticScriptId?: string;
+    audioScriptId: string;
+    phonemeScript?: string;
+  }, options?: CommitOptions): Promise<string>;
+  /** The file holding `text`: the one the PhoneticScript keeps while its text is unchanged, else a new upload. */
+  private fileFor;
   setBgm(input: ClipSource & {
     trackId: string;
     clipId?: string;
@@ -828,6 +866,52 @@ interface VideoDraftProjection {
 /** A content read view, not an archive of authoring identities, rich-text marks or provenance. */
 declare function toVideoDraft(snapshot: MedeoDslSnapshot): VideoDraftProjection;
 //#endregion
+//#region src/dsl/projection/audio-scripts.d.ts
+/**
+ * An AudioScript with everything that says or shows it, read from the same snapshot as the
+ * VideoDraft. Speeches and captions come in playback order.
+ */
+interface AudioScriptView {
+  id: string;
+  /** Its text, one segment per line. */
+  segments: {
+    text: string;
+    language?: string;
+  }[];
+  /** Media the script was read off (a transcript), through derived-from. */
+  sourceMediaIds: string[];
+  /** Its variants written for synthesis: the pronunciation the plain text cannot state, and its file's digest. */
+  phoneticScripts: {
+    id: string;
+    phonemeScript?: string;
+    digest?: string;
+  }[];
+  /** Speech Clips playing a recording of these words. */
+  speeches: {
+    clipId: string;
+    recordingId: string; /** The PhoneticScript the recording was spoken from; absent when it derives from the script directly. */
+    phoneticScriptId?: string;
+    voices: {
+      voiceId: string;
+      key: string;
+      name?: string;
+    }[];
+    /**
+     * Whether the recording was synthesized from its source as it is now: the digest its
+     * derived-from records equals the source's digest (D177). Absent when either has none.
+     */
+    applied?: boolean;
+  }[];
+  /** Caption Clips showing one of its segments. A Caption with its own text shows none. */
+  captions: {
+    clipId: string;
+    captionId: string;
+    segment: number;
+  }[];
+}
+/** Every AudioScript in the document with its PhoneticScripts, the Speech Clips saying it and the Caption Clips showing it. */
+declare function toAudioScriptViews(snapshot: MedeoDslSnapshot): AudioScriptView[];
+//#endregion
 //#region src/dsl/projection/from-video-draft.d.ts
 interface FromVideoDraftOptions extends CreateMedeoDslOptions {
   /** Complete physical media facts, keyed by their external system/key; no IO runs in the converter. */
@@ -841,4 +925,4 @@ interface ImportedVideoDraft {
 /** One-time import into a newly owned document; never reverse-diff a live collaborative document. */
 declare function fromVideoDraft(input: VideoDraftInput, options: FromVideoDraftOptions): ImportedVideoDraft;
 //#endregion
-export { AddDslClip as A, InvalidAtomic as C, MedeoDslDraft as D, timeAnchorCodec as E, ReplaceDslClipsInput as F, ClipPlacement as I, ClipSource as M, DslClipUpdate as N, MedeoDslLoroState as O, MoveDslClipsInput as P, documentFormat as S, isInvalidAtomic as T, MedeoDsl as _, toVideoDraft as a, UnsupportedDocumentFormatError as b, DslLayout as c, createInitialMedeoDsl as d, DslEditor as f, CreateMedeoDslOptions as g, VoiceoverResult as h, VideoDraftProjection as i, AddDslClipsInput as j, medeoDslLoroShape as k, DslProjectionError as l, VoiceoverCaptionInput as m, ImportedVideoDraft as n, resolveDslLayout as o, ApplyVoiceoverInput as p, fromVideoDraft as r, DslClipLayout as s, FromVideoDraftOptions as t, DslTrackLayout as u, DslAudit as v, captionContentCodec as w, assertDslDocument as x, DslTransaction as y };
+export { MedeoDslDraft as A, UnsupportedDocumentFormatError as C, captionContentCodec as D, InvalidAtomic as E, ClipSource as F, DslClipUpdate as I, MoveDslClipsInput as L, medeoDslLoroShape as M, AddDslClip as N, isInvalidAtomic as O, AddDslClipsInput as P, ReplaceDslClipsInput as R, DslTransaction as S, documentFormat as T, VoiceoverCaptionInput as _, toAudioScriptViews as a, MedeoDsl as b, resolveDslLayout as c, DslProjectionError as d, DslTrackLayout as f, ApplyVoiceoverInput as g, UploadText as h, AudioScriptView as i, MedeoDslLoroState as j, timeAnchorCodec as k, DslClipLayout as l, DslEditor as m, ImportedVideoDraft as n, VideoDraftProjection as o, createInitialMedeoDsl as p, fromVideoDraft as r, toVideoDraft as s, FromVideoDraftOptions as t, DslLayout as u, VoiceoverResult as v, assertDslDocument as w, DslAudit as x, CreateMedeoDslOptions as y, ClipPlacement as z };

package/dist/{index-CwG4lYKp.d.ts → index-Dpl4bT94.d.ts}

@@ -1,4 +1,4 @@
-import { j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions } from "./video-draft-types-BfkIuW5f.js";
+import { j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions } from "./video-draft-types-Bq15tPBP.js";
 import { LoroDoc, PeerID, VersionVector } from "loro-crdt";
 import { DocState, LocalSaveState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as TrackRole, A as DeepReadonly, B as RelationMutation, C as CaptionContent, D as Clip, E as CaptionText, F as EntityTables, G as RichTextSnapshot, H as RelationTables, I as EntityValues, J as TextMark, K as TextDelta, L as FieldPatch, M as DslMutation, N as EntityMutation, O as ContainMutation, P as EntityTable, Q as Track, R as MedeoDslSnapshot, S as Caption, T as CaptionStyle, U as RelationValues, V as RelationTable, W as ResourceSystem, X as TextRun, Y as TextMutation, Z as TimeAnchor, _ as defaultIdFactory, a as VideoDraftCaptionStyle, b as tupleHash, c as VideoDraftInput, d as VideoDraftTrack, et as Voice, f as VideoDraftTrackItem, g as EntityIdKind, h as DslIdFactory, i as VideoDraft, j as DslDiagnostic, k as ContainNode, l as VideoDraftPartUnion, m as OpActor, n as DEFAULT_UNIT_TIME_MS, o as VideoDraftContent, p as CommitOptions, q as TextEdit, r as VideoCreationSettings, s as VideoDraftContentPartUnion, t as CaptionDisplayCue, u as VideoDraftTimeline, v as relationId, w as CaptionSelection, x as AudioScript, y as resourceId, z as Media } from "./video-draft-types-BfkIuW5f.js";
-import { A as AddDslClip, C as InvalidAtomic, D as MedeoDslDraft, E as timeAnchorCodec, F as ReplaceDslClipsInput, I as ClipPlacement, M as ClipSource, N as DslClipUpdate, O as MedeoDslLoroState, P as MoveDslClipsInput, S as documentFormat, T as isInvalidAtomic, _ as MedeoDsl, a as toVideoDraft, b as UnsupportedDocumentFormatError, c as DslLayout, d as createInitialMedeoDsl, f as DslEditor, g as CreateMedeoDslOptions, h as VoiceoverResult, i as VideoDraftProjection, j as AddDslClipsInput, k as medeoDslLoroShape, l as DslProjectionError, m as VoiceoverCaptionInput, n as ImportedVideoDraft, o as resolveDslLayout, p as ApplyVoiceoverInput, r as fromVideoDraft, s as DslClipLayout, t as FromVideoDraftOptions, u as DslTrackLayout, v as DslAudit, w as captionContentCodec, x as assertDslDocument, y as DslTransaction } from "./index-DP9FG0z_.js";
-import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, a as MengineDocSessionOptions, b as DocVersionMark, c as WaitForLocalSaveOptions, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, i as MengineAckFailedError, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, s as MengineLocalSaveState, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-CwG4lYKp.js";
-import { n as MengineDocSessionUpdateEvent, r as ManualSyncDoc, t as MengineDocSession } from "./index-W1eHhVus.js";
-export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DocStorageLike, type DocVersionMark, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, ManualSyncDoc, type ManualSyncDocOptions, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type Media, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineDraftResponse, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, type MengineLocalSaveState, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, type MoveDslClipsInput, type OpActor, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, type WaitForLocalSaveOptions, type WaitForServerAckOptions, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+import { $ as Track, A as DeepReadonly, B as RelationMutation, C as CaptionContent, D as Clip, E as CaptionText, F as EntityTables, G as RichTextSnapshot, H as RelationTables, I as EntityValues, J as TextEdit, K as StoredFile, L as FieldPatch, M as DslMutation, N as EntityMutation, O as ContainMutation, P as EntityTable, Q as TimeAnchor, R as MedeoDslSnapshot, S as Caption, T as CaptionStyle, U as RelationValues, V as RelationTable, W as ResourceSystem, X as TextMutation, Y as TextMark, Z as TextRun, _ as defaultIdFactory, a as VideoDraftCaptionStyle, b as tupleHash, c as VideoDraftInput, d as VideoDraftTrack, et as TrackRole, f as VideoDraftTrackItem, g as EntityIdKind, h as DslIdFactory, i as VideoDraft, j as DslDiagnostic, k as ContainNode, l as VideoDraftPartUnion, m as OpActor, n as DEFAULT_UNIT_TIME_MS, o as VideoDraftContent, p as CommitOptions, q as TextDelta, r as VideoCreationSettings, s as VideoDraftContentPartUnion, t as CaptionDisplayCue, tt as Voice, u as VideoDraftTimeline, v as relationId, w as CaptionSelection, x as AudioScript, y as resourceId, z as Media } from "./video-draft-types-Bq15tPBP.js";
+import { A as MedeoDslDraft, C as UnsupportedDocumentFormatError, D as captionContentCodec, E as InvalidAtomic, F as ClipSource, I as DslClipUpdate, L as MoveDslClipsInput, M as medeoDslLoroShape, N as AddDslClip, O as isInvalidAtomic, P as AddDslClipsInput, R as ReplaceDslClipsInput, S as DslTransaction, T as documentFormat, _ as VoiceoverCaptionInput, a as toAudioScriptViews, b as MedeoDsl, c as resolveDslLayout, d as DslProjectionError, f as DslTrackLayout, g as ApplyVoiceoverInput, h as UploadText, i as AudioScriptView, j as MedeoDslLoroState, k as timeAnchorCodec, l as DslClipLayout, m as DslEditor, n as ImportedVideoDraft, o as VideoDraftProjection, p as createInitialMedeoDsl, r as fromVideoDraft, s as toVideoDraft, t as FromVideoDraftOptions, u as DslLayout, v as VoiceoverResult, w as assertDslDocument, x as DslAudit, y as CreateMedeoDslOptions, z as ClipPlacement } from "./index-DHcMMn2M.js";
+import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, a as MengineDocSessionOptions, b as DocVersionMark, c as WaitForLocalSaveOptions, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, i as MengineAckFailedError, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, s as MengineLocalSaveState, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-Dpl4bT94.js";
+import { n as MengineDocSessionUpdateEvent, r as ManualSyncDoc, t as MengineDocSession } from "./index-Cx5DojM1.js";
+export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DocStorageLike, type DocVersionMark, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, ManualSyncDoc, type ManualSyncDocOptions, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type Media, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineDraftResponse, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, type MengineLocalSaveState, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, type MoveDslClipsInput, type OpActor, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type StoredFile, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type UploadText, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, type WaitForLocalSaveOptions, type WaitForServerAckOptions, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
 import { a as covers, c as readMengineEventStream, d as MenginePushRejectedError, i as openManualDocument, l as MengineHttpClient, n as MedeoHttpDocStorage, o as decodeDocVersionMark, r as ManualSyncTransport, s as encodeDocVersionMark, t as MemoryDocStorage, u as MengineHttpRequestError } from "./storage-BW3tI_ER.js";
-import { a as documentFormat, c as isInvalidAtomic, ft as defaultIdFactory, ht as tupleHash, i as assertDslDocument, l as timeAnchorCodec, mt as resourceId, o as medeoDslLoroShape, pt as relationId, r as UnsupportedDocumentFormatError, s as captionContentCodec, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-DvPeam87.js";
-import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, o as resolveDslLayout, r as createInitialMedeoDsl, s as DslProjectionError, t as fromVideoDraft } from "./dsl-BCcld0Ca.js";
+import { a as documentFormat, c as isInvalidAtomic, ft as defaultIdFactory, ht as tupleHash, i as assertDslDocument, l as timeAnchorCodec, mt as resourceId, o as medeoDslLoroShape, pt as relationId, r as UnsupportedDocumentFormatError, s as captionContentCodec, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-Ce8NDenQ.js";
+import { a as DslEditor, c as DslProjectionError, i as createInitialMedeoDsl, n as toVideoDraft, o as MedeoDsl, r as toAudioScriptViews, s as resolveDslLayout, t as fromVideoDraft } from "./dsl-DbYqFFOb.js";
 import { UndoManager, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
 import { DisposableSet, EventBus } from "@mengine/utils";
@@ -10,14 +10,15 @@ import { DisposableSet, EventBus } from "@mengine/utils";
 var ManualSyncDoc = class ManualSyncDoc extends ManualSyncTransport {
 	dsl;
 	editor;
-	constructor(client, doc, watermark) {
+	constructor(client, doc, watermark, uploadText) {
 		super(client, doc, watermark);
 		assertDslDocument(doc);
 		this.dsl = new MedeoDsl(doc);
-		this.editor = new DslEditor(this.dsl);
+		this.editor = new DslEditor(this.dsl, void 0, uploadText);
 	}
+	/** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
 	static open(options) {
-		return openManualDocument(options, (doc, watermark) => new ManualSyncDoc(options.client, doc, watermark));
+		return openManualDocument(options, (doc, watermark) => new ManualSyncDoc(options.client, doc, watermark, options.uploadText));
 	}
 	snapshot() {
 		this.assertActive();
@@ -623,6 +624,7 @@ function serverCovers(serverVV, target) {
 //#region src/session/mengine-doc-session.ts
 /** Default collaborative session: one DSL handle and one editor over the synchronized LoroDoc. */
 var MengineDocSession = class extends DocumentSession {
+	/** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
 	constructor(options) {
 		super(options, (doc, guard) => {
 			assertDslDocument(doc);
@@ -630,7 +632,7 @@ var MengineDocSession = class extends DocumentSession {
 			return {
 				doc,
 				document: dsl,
-				editor: new DslEditor(dsl),
+				editor: new DslEditor(dsl, void 0, options.uploadText),
 				snapshot: () => dsl.getSnapshot(),
 				subscribe: (listener) => dsl.subscribe(listener),
 				dispose: () => dsl.dispose()
@@ -643,6 +645,10 @@ var MengineDocSession = class extends DocumentSession {
 	projectVideoDraft() {
 		return toVideoDraft(this.snapshot());
 	}
+	/** The document's AudioScripts with what says and shows them; read from the same snapshot as the VideoDraft. */
+	projectAudioScripts() {
+		return toAudioScriptViews(this.snapshot());
+	}
 };
 //#endregion
-export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, ManualSyncDoc, MedeoDsl, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, UnsupportedDocumentFormatError, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, ManualSyncDoc, MedeoDsl, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, UnsupportedDocumentFormatError, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/legacy.d.ts

@@ -1,5 +1,5 @@
-import { i as VideoDraft, l as VideoDraftPartUnion, o as VideoDraftContent, p as CommitOptions, t as CaptionDisplayCue } from "./video-draft-types-BfkIuW5f.js";
-import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, _ as ManualSyncTransport, a as MengineDocSessionOptions, b as DocVersionMark, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-CwG4lYKp.js";
+import { i as VideoDraft, l as VideoDraftPartUnion, o as VideoDraftContent, p as CommitOptions, t as CaptionDisplayCue } from "./video-draft-types-Bq15tPBP.js";
+import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, _ as ManualSyncTransport, a as MengineDocSessionOptions, b as DocVersionMark, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-Dpl4bT94.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 
 //#region ../medeo-dsl/depreacted/sandbox.d.ts

package/dist/legacy.js

@@ -1,6 +1,6 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
 import { c as readMengineEventStream, d as MenginePushRejectedError, i as openManualDocument, l as MengineHttpClient, n as MedeoHttpDocStorage, o as decodeDocVersionMark, r as ManualSyncTransport, s as encodeDocVersionMark, t as MemoryDocStorage, u as MengineHttpRequestError } from "./storage-BW3tI_ER.js";
-import { a as documentFormat, r as UnsupportedDocumentFormatError, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-DvPeam87.js";
+import { a as documentFormat, r as UnsupportedDocumentFormatError, t as DEFAULT_UNIT_TIME_MS } from "./video-draft-types-Ce8NDenQ.js";
 import { u as volumeSchema } from "./shared-iWnU2osE.js";
 import { sha256 } from "@noble/hashes/sha2.js";
 import { LoroDoc, LoroMap, LoroMovableList, LoroText, UndoManager } from "loro-crdt";

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import { i as VideoDraft } from "./video-draft-types-BfkIuW5f.js";
-import { _ as MedeoDsl } from "./index-DP9FG0z_.js";
+import { i as VideoDraft } from "./video-draft-types-Bq15tPBP.js";
+import { b as MedeoDsl } from "./index-DHcMMn2M.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/testing/in-memory-mengine-server.d.ts

package/dist/testing.js

@@ -1,6 +1,6 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
-import { a as documentFormat, i as assertDslDocument } from "./video-draft-types-DvPeam87.js";
-import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, r as createInitialMedeoDsl } from "./dsl-BCcld0Ca.js";
+import { a as documentFormat, i as assertDslDocument } from "./video-draft-types-Ce8NDenQ.js";
+import { a as DslEditor, i as createInitialMedeoDsl, n as toVideoDraft, o as MedeoDsl } from "./dsl-DbYqFFOb.js";
 import { t as classifyUpdate } from "./loro-relay-doc-Bi6JKqtQ.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/dist/{video-draft-types-BfkIuW5f.d.ts → video-draft-types-Bq15tPBP.d.ts}

@@ -90,8 +90,19 @@ interface Phoneme {
   /** One whole script in the target TTS vocabulary, such as a `<speak>` document. */
   phonemeScript?: string;
 }
-/** A variant of an AudioScript: the script it reads, plus how to pronounce it. */
-interface PhoneticScript {
+/** A file Memota stored from raw content: how a Media File entity names it, and its digest. */
+interface StoredFile {
+  system: 'memota';
+  key: string;
+  storageKey?: string;
+  digest: string;
+}
+/**
+ * A variant of an AudioScript: the script it reads, plus how to pronounce it. It has the Media File
+ * trait (D178): its `phonemeScript` is raw content, stored in Memota as a text file whenever it is
+ * written, and the file's facts are kept beside it. Without a `phonemeScript` it has no file.
+ */
+interface PhoneticScript extends Partial<StoredFile> {
   phoneme: Phoneme;
 }
 interface Voice {
@@ -116,9 +127,14 @@ interface RelationValues {
     recordingId: string;
     voiceId: string;
   };
+  /**
+   * `sourceDigest`: the source's digest when the product was made from it (D177). A product whose
+   * source's digest differs now was made from content the source no longer has.
+   */
   'derived-from-relations': {
     entityId: string;
     sourceId: string;
+    sourceDigest?: string;
   };
 }
 type EntityTable = keyof EntityValues;
@@ -802,4 +818,4 @@ type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_mai
 type VideoDraftInput = Pick<VideoDraft, keyof VideoDraftContent>;
 declare const DEFAULT_UNIT_TIME_MS = 33.333;
 //#endregion
-export { TrackRole as $, DeepReadonly as A, RelationMutation as B, CaptionContent as C, Clip as D, CaptionText as E, EntityTables as F, RichTextSnapshot as G, RelationTables as H, EntityValues as I, TextMark as J, TextDelta as K, FieldPatch as L, DslMutation as M, EntityMutation as N, ContainMutation as O, EntityTable as P, Track$1 as Q, MedeoDslSnapshot as R, Caption as S, CaptionStyle$1 as T, RelationValues as U, RelationTable as V, ResourceSystem as W, TextRun as X, TextMutation as Y, TimeAnchor as Z, defaultIdFactory as _, VideoDraftCaptionStyle as a, tupleHash as b, VideoDraftInput as c, VideoDraftTrack as d, Voice as et, VideoDraftTrackItem as f, EntityIdKind as g, DslIdFactory as h, VideoDraft as i, DslDiagnostic as j, ContainNode as k, VideoDraftPartUnion as l, OpActor as m, DEFAULT_UNIT_TIME_MS as n, VideoDraftContent as o, CommitOptions as p, TextEdit as q, VideoCreationSettings as r, VideoDraftContentPartUnion as s, CaptionDisplayCue as t, VideoDraftTimeline as u, relationId as v, CaptionSelection as w, AudioScript as x, resourceId as y, Media as z };
+export { Track$1 as $, DeepReadonly as A, RelationMutation as B, CaptionContent as C, Clip as D, CaptionText as E, EntityTables as F, RichTextSnapshot as G, RelationTables as H, EntityValues as I, TextEdit as J, StoredFile as K, FieldPatch as L, DslMutation as M, EntityMutation as N, ContainMutation as O, EntityTable as P, TimeAnchor as Q, MedeoDslSnapshot as R, Caption as S, CaptionStyle$1 as T, RelationValues as U, RelationTable as V, ResourceSystem as W, TextMutation as X, TextMark as Y, TextRun as Z, defaultIdFactory as _, VideoDraftCaptionStyle as a, tupleHash as b, VideoDraftInput as c, VideoDraftTrack as d, TrackRole as et, VideoDraftTrackItem as f, EntityIdKind as g, DslIdFactory as h, VideoDraft as i, DslDiagnostic as j, ContainNode as k, VideoDraftPartUnion as l, OpActor as m, DEFAULT_UNIT_TIME_MS as n, VideoDraftContent as o, CommitOptions as p, TextDelta as q, VideoCreationSettings as r, VideoDraftContentPartUnion as s, CaptionDisplayCue as t, Voice as tt, VideoDraftTimeline as u, relationId as v, CaptionSelection as w, AudioScript as x, resourceId as y, Media as z };

package/dist/{video-draft-types-DvPeam87.js → video-draft-types-Ce8NDenQ.js}

@@ -173,7 +173,13 @@ const entityFields = {
 		body: required(string),
 		defaultLanguage: optional$1(validLanguage)
 	},
-	"phonetic-script-entities": { phoneme: required(object(phonemeFields)) },
+	"phonetic-script-entities": {
+		phoneme: required(object(phonemeFields)),
+		system: optional$1(oneOf("memota")),
+		key: optional$1(nonempty),
+		storageKey: optional$1(nonempty),
+		digest: optional$1(nonempty)
+	},
 	"caption-entities": {
 		selection: optional$1(object(captionContentFields)),
 		text: optional$1(string),
@@ -202,12 +208,30 @@ const relationFields = {
 	},
 	"derived-from-relations": {
 		entityId: required(id),
-		sourceId: required(id)
+		sourceId: required(id),
+		sourceDigest: optional$1(nonempty)
 	}
 };
 const relationTables = Object.keys(relationFields);
+const fileFields = [
+	"system",
+	"key",
+	"storageKey",
+	"digest"
+];
+const phonemeScriptOf = (row) => isRecord(row.phoneme) ? row.phoneme.phonemeScript : void 0;
+/**
+* A PhoneticScript's phonemeScript is raw content stored as its file when written (D178): with one,
+* the row names that file by system and key and states its digest; without one it has no file.
+*/
+function assertPhoneticFile(row) {
+	if (phonemeScriptOf(row) === void 0) {
+		if (fileFields.some((field) => row[field] !== void 0)) throw new Error("A PhoneticScript without text has no file");
+	} else if (row.system === void 0 || row.key === void 0 || row.digest === void 0) throw new Error("A PhoneticScript stores its phonemeScript as a file: name it by system and key with its digest");
+}
 function assertEntity(table, value) {
 	checkFields(value, entityFields[table]);
+	if (table === "phonetic-script-entities") assertPhoneticFile(value);
 	if (table === "media-entities") {
 		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");
@@ -225,6 +249,10 @@ function assertEntityPatch(table, patch, current) {
 		const field = entityFields[table][key];
 		if (!field || !field.optional && next[key] === void 0 || next[key] !== void 0 && !field.check(next[key])) throw new Error(`Invalid patch field: ${key}`);
 	}
+	if (table === "phonetic-script-entities" && ["phoneme", ...fileFields].some((field) => Object.hasOwn(patch, field))) {
+		assertPhoneticFile(next);
+		if (phonemeScriptOf(next) !== phonemeScriptOf(current) && next.digest !== void 0 && next.digest === current.digest) throw new Error("A rewritten phonemeScript is stored again: write its new file");
+	}
 	if (table === "media-entities" || table === "voice-entities") {
 		for (const key of [
 			"system",
@@ -1358,7 +1386,13 @@ const medeoDslLoroShape = schema({
 		body: schema.LoroText(),
 		defaultLanguage: schema.String(optional)
 	})),
-	"phonetic-script-entities": schema.LoroMapRecord(schema.LoroMap({ phoneme: atomicValue(phonemeCodec) })),
+	"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),
@@ -1388,7 +1422,11 @@ const medeoDslLoroShape = schema({
 	}), mergeable),
 	"contain-relations": schema.LoroTree(schema.LoroMap({ entityId: schema.String() })),
 	"voice-timbre-relations": relation(["recordingId", "voiceId"]),
-	"derived-from-relations": relation(["entityId", "sourceId"])
+	"derived-from-relations": schema.LoroMapRecord(schema.LoroMap({
+		entityId: schema.String(),
+		sourceId: schema.String(),
+		sourceDigest: schema.String(optional)
+	}), mergeable)
 });
 //#endregion
 //#region ../medeo-dsl/src/schema/document-format.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "2.1.1-dsl.4",
+  "version": "2.1.1-dsl.6",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -29,9 +29,9 @@
     "@noble/hashes": "^2.4.0",
     "immer": "^10.2.0",
     "zod": "^4.4.3",
-    "@mengine/storage": "2.1.1-dsl.4",
-    "@mengine/sync": "2.1.1-dsl.4",
-    "@mengine/utils": "2.1.1-dsl.4"
+    "@mengine/storage": "2.1.1-dsl.6",
+    "@mengine/utils": "2.1.1-dsl.6",
+    "@mengine/sync": "2.1.1-dsl.6"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -42,8 +42,8 @@
     "typescript": "^6.0.3",
     "vite-plugin-wasm": "^3.6.0",
     "vite-plus": "^0.1.23",
-    "@mengine/idl-codegen": "0.0.0",
-    "@mengine/medeo-dsl": "0.0.0"
+    "@mengine/medeo-dsl": "0.0.0",
+    "@mengine/idl-codegen": "0.0.0"
   },
   "peerDependencies": {
     "loro-crdt": "^1.16.1"