@mengine/medeo-client 2.0.1-alpha.11 → 2.0.1-alpha.13

package/dist/{document-D631gqZV.js → document-CAZ_A9R8.js}

@@ -1462,8 +1462,9 @@ function emptyLaneTracks() {
 * `Voice` declares no `Sequence` — it is a timbre identity, not playable
 * content; a rendered voiceover is an `audio` entity.
 *
-* No declaration says anything about resources: whether an entity has one, and
-* which, is the `from-asset` Relation's answer alone.
+* `Asset` says only that an entity of that kind may be bound to stored bytes,
+* and asks nothing of its payload. Which bytes, and which way the content
+* flowed, is the `from-asset` / `to-asset` Relation's answer alone.
 */
 const ENTITY_KINDS = Object.freeze({
 	axvideo: Object.freeze([
@@ -1480,27 +1481,27 @@ const ENTITY_KINDS = Object.freeze({
 		"Sequence",
 		"Visual",
 		"Audible",
-		"FromAsset"
+		"Asset"
 	]),
 	audio: Object.freeze([
 		"Sequence",
 		"Audible",
-		"FromAsset"
+		"Asset"
 	]),
 	image: Object.freeze([
 		"Sequence",
 		"Visual",
-		"FromAsset"
+		"Asset"
 	]),
 	voice: Object.freeze(["Container", "IPBound"]),
 	"sequence-marker": Object.freeze([]),
 	viewport: Object.freeze([]),
-	"audio-script": Object.freeze(["SegmentText", "FromAsset"]),
-	"phonetic-script": Object.freeze(["SegmentText"]),
+	"audio-script": Object.freeze(["SegmentText", "Asset"]),
+	"phonetic-script": Object.freeze(["SegmentText", "Asset"]),
 	caption: Object.freeze([
 		"SegmentText",
 		"Sequence",
-		"FromAsset"
+		"Asset"
 	])
 });
 /** What a known kind declares; extension kinds declare nothing through this table. */
@@ -1798,15 +1799,6 @@ function entityToRow(entity) {
 //#endregion
 //#region ../medeo-dsl/src/invariants.ts
 /** An entity is made from at most one Asset; two would leave its bytes ambiguous. */
-function validateAssetSource(entity, index) {
-	if (entity.current().entityKind === "asset") return [];
-	if ([...index.relationsOf(entity)].filter((relation) => relation.kind === "from-asset").length <= 1) return [];
-	return [{
-		code: "asset_source_cardinality",
-		entityId: entity.entityId,
-		message: `Entity "${entity.entityId}" is made from more than one Asset`
-	}];
-}
 /** Validates one complete set of entities and its authoritative Relation rows. */
 function validateEntityRelationSet(entityRefs, index, options) {
 	const { entities, issues } = collectRelatedEntities(entityRefs, index);
@@ -1828,7 +1820,6 @@ function validateEntityRelationSet(entityRefs, index, options) {
 		const current = entity.current();
 		const entityIssues = validateEntity(entity, entityIds);
 		issues.push(...entityIssues);
-		issues.push(...validateAssetSource(entity, index));
 		if (entityIssues.some((issue) => issue.code === "invalid_entity_payload")) continue;
 		if (current.entityKind === "sequence-marker") {
 			const marker = entity;
@@ -2472,10 +2463,10 @@ const markerContentRelationSpec = Object.freeze({
 /**
 * `from-asset(entity, asset)` — the entity was made from that stored resource.
 *
-* Eligibility is declared: the non-Asset endpoint must carry the `FromAsset`
-* kind, which says an entity of that kind can be made from stored bytes and
-* asks nothing of its payload. The bytes stay named in exactly one place, so
-* no entity copies the locator into its own row and one Asset can back several
+* Eligibility is declared: the non-Asset endpoint must carry the `Asset` kind,
+* which says an entity of that kind can be bound to stored bytes and asks
+* nothing of its payload. The bytes stay named in exactly one place, so no
+* entity copies the locator into its own row and one Asset can back several
 * entities.
 */
 const fromAssetRelationSpec = Object.freeze({
@@ -2483,6 +2474,26 @@ const fromAssetRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => hasExactlyOneAsset(endpoints),
 	validateMetadata: isAssetBinding
 });
+/**
+* `to-asset(entity, asset)` — the entity's content was written out to that
+* stored resource.
+*
+* The mirror of `from-asset`, and deliberately a separate relation kind rather
+* than a second declared kind: eligibility is the same either way, but which
+* way the content flowed is what says whether an entity may still be edited.
+* An entity reached by `from-asset` was produced from bytes it does not own,
+* so changing it would contradict them. An entity with a `to-asset` owns its
+* content and the resource is a snapshot of it, which is what goes stale and
+* gets written again. A transcript that is later edited carries both at once,
+* and only the distinct relation kinds keep them apart.
+*
+* Writing a snapshot is host assembly; nothing a script authors creates one.
+*/
+const toAssetRelationSpec = Object.freeze({
+	kind: "to-asset",
+	validateEndpoints: (endpoints) => hasExactlyOneAsset(endpoints),
+	validateMetadata: isAssetBinding
+});
 /** `generated(output, input)` means endpoint 0 was generated from endpoint 1. */
 const generatedRelationSpec = Object.freeze({
 	kind: "generated",
@@ -2545,6 +2556,7 @@ const builtInRelationSpecs = Object.freeze([
 	axVideoMarkerRelationSpec,
 	markerTimelineRelationSpec,
 	fromAssetRelationSpec,
+	toAssetRelationSpec,
 	generatedRelationSpec,
 	captionAlignmentRelationSpec,
 	clipAnchorRelationSpec,
@@ -2573,12 +2585,12 @@ function hasMarkerAndSequence(endpoints) {
 	const second = endpoints[1].current();
 	return first.entityKind === "sequence-marker" && hasSequence(second) || second.entityKind === "sequence-marker" && hasSequence(first);
 }
-/** Exactly one end is the Asset, so the other end is unambiguously the maker. */
+/** Exactly one end is the Asset, so the other end is unambiguously the bound entity. */
 function hasExactlyOneAsset(endpoints) {
 	const kinds = endpoints.map((endpoint) => endpoint.current().entityKind);
 	const assets = kinds.map((kind) => kind === "asset");
 	if (assets[0] === assets[1]) return false;
-	return declaresKind(assets[0] ? kinds[1] : kinds[0], "FromAsset");
+	return declaresKind(assets[0] ? kinds[1] : kinds[0], "Asset");
 }
 function isGeneratedMedia(entity) {
 	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio";
@@ -3608,12 +3620,23 @@ function audioScriptAssetHash(payload) {
 	return bytesToHex(sha256(new TextEncoder().encode(canonicalJson(audioScriptAssetContent(payload)))));
 }
 /**
-* The Asset a script was written out to, read from the graph rather than the
-* script's own row: like every other entity, a script names its bytes through
-* a `from-asset` Relation and stores no locator itself.
+* The Asset a script was written out to. It is a snapshot the script owns, so
+* it is reached by `to-asset` — not `from-asset`, which would say the script
+* was produced from bytes it cannot change.
 */
 function audioScriptAssetOf(rows, entityId) {
-	const link = rows.relations.find((relation) => relation.relationKind === "from-asset" && (String(relation.endpoint0EntityId) === entityId || String(relation.endpoint1EntityId) === entityId));
+	return boundAsset(rows, entityId, "to-asset");
+}
+/**
+* The Asset a script was made from — a transcript it does not own. A script
+* that has one never writes a snapshot of its own: the bytes it would describe
+* are already named, and rewriting them would contradict their source.
+*/
+function scriptSourceAssetOf(rows, entityId) {
+	return boundAsset(rows, entityId, "from-asset");
+}
+function boundAsset(rows, entityId, relationKind) {
+	const link = rows.relations.find((relation) => relation.relationKind === relationKind && (String(relation.endpoint0EntityId) === entityId || String(relation.endpoint1EntityId) === entityId));
 	if (link === void 0) return void 0;
 	const otherId = String(link.endpoint0EntityId) === entityId ? link.endpoint1EntityId : link.endpoint0EntityId;
 	return rows.entities.find((row) => String(row.entityId) === String(otherId) && row.entityKind === "asset");
@@ -3622,6 +3645,33 @@ function audioScriptAssetOf(rows, entityId) {
 function audioScriptAssetFields(payload) {
 	return { assetContentHash: audioScriptAssetHash(payload) };
 }
+/**
+* What a PhoneticScript hands to synthesis: the base AudioScript's text as the
+* variant pronounces it, plus the variant's own phoneme and prosody control.
+*
+* The variant's content is written by a model — deciding how words are said is
+* text work, not a mechanical copy — but the bytes a synthesizer reads have to
+* leave the entity graph to reach it, because synthesis does not handle
+* entities. Writing this resource down is that crossing, and it is why speech
+* can only come from a PhoneticScript.
+*/
+function phoneticScriptAssetContent(rows, entityId) {
+	const assembled = assemblePhoneticScriptContent(rows, createEntityId(entityId));
+	const own = assembled.phoneticScript.payload;
+	return {
+		text: assembled.text,
+		segments: structuredClone(assembled.segments),
+		...typeof own.phonemeScript === "string" ? { phonemeScript: own.phonemeScript } : {},
+		...isJsonObject(own.prosody) ? { prosody: structuredClone(own.prosody) } : {}
+	};
+}
+function phoneticScriptAssetHash(rows, entityId) {
+	return bytesToHex(sha256(new TextEncoder().encode(canonicalJson(phoneticScriptAssetContent(rows, entityId)))));
+}
+/** The Asset a PhoneticScript was written out to, read from the graph. */
+function phoneticScriptAssetOf(rows, entityId) {
+	return audioScriptAssetOf(rows, entityId);
+}
 //#endregion
 //#region src/entity-crdt/ordering.ts
 /** Domain order is scoped by membership; relation storage has no global order. */
@@ -3925,8 +3975,10 @@ var LoroEntityDocument = class LoroEntityDocument {
 	/**
 	* Bind a saved snapshot without rewriting text operations or resolving
 	* selection conflicts. The script names the bytes the same way everything
-	* else does — an Asset entity plus a `from-asset` Relation — and keeps only
-	* the fingerprint that tells a stale snapshot from a current one.
+	* else does — an Asset entity plus a Relation — and keeps only the
+	* fingerprint that tells a stale snapshot from a current one. The Relation is
+	* `to-asset`: these bytes are the script's own content written out, not a
+	* source it was made from.
 	*/
 	bindAudioScriptAsset(entityId, assetId, expectedContentHash) {
 		const key = family(this.doc, entityId);
@@ -3949,10 +4001,10 @@ var LoroEntityDocument = class LoroEntityDocument {
 		this.transact((draft) => {
 			const current = readEntityDocument(this.doc, true).rows;
 			if (audioScriptAssetOf(current, entityId)?.entityId !== assetEntityId) {
-				for (const relation of current.relations) if (relation.relationKind === "from-asset" && (String(relation.endpoint0EntityId) === String(entityId) || String(relation.endpoint1EntityId) === String(entityId))) draft.unlink(String(relation.relationId));
+				for (const relation of current.relations) if (relation.relationKind === "to-asset" && (String(relation.endpoint0EntityId) === String(entityId) || String(relation.endpoint1EntityId) === String(entityId))) draft.unlink(String(relation.relationId));
 				draft.link({
-					relationId: createRelationId(`relation_from-asset_${entityId}_${assetId}`),
-					relationKind: "from-asset",
+					relationId: createRelationId(`relation_to-asset_${entityId}_${assetId}`),
+					relationKind: "to-asset",
 					endpoint0EntityId: createEntityId(entityId),
 					endpoint1EntityId: assetEntityId,
 					metadata: {},
@@ -4663,4 +4715,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { findLaneTrack as $, assemblePhoneticScriptContent as A, isMediaAssetVariantKind as B, EntityProjectionGraph as C, ScriptCompositionError as D, decodeEntityRelationRows as E, variantBaseEntityIds as F, toVideoDocument as G, buildSpeechHostMap as H, isJsonObject as I, validateVideoDocument as J, VideoDocumentValidationError as K, createEntityId as L, findComposedAudioScript as M, selectAudioScriptSegment as N, assembleCaptionContent as O, updateEntityFields as P, ensureLaneTrack as Q, createRelationId as R, projectEntityTimeline as S, bytesToBase64 as St, EntityTimelineProjectionError as T, derivePositionFromAbs as U, buildInitialVideoDocument as V, fromVideoDocument as W, videoDocumentSchema as X, partUnionSchema as Y, LANE_KINDS_IN_STACK_ORDER as Z, audioScriptAssetOf as _, speedOf as _t, createMirrorVideoDocument as a, fillMainTrackTimeGaps as at, assertFieldChanges as b, videoDocumentMirrorSchema as bt, DocumentMutationGuard as c, resolveAllSpeechOverlaps as ct, LoroEntityDraft as d, TIMELINE_SKELETON_DURATION_MS as dt, hasResolvedPlacement as et, readEntityDocument as f, isEmptyVideoClip as ft, audioScriptAssetHash as g, effectiveVideoClipDurationMs as gt, audioScriptAssetFields as h, DEFAULT_UNIT_TIME_MS as ht, MirrorVideoDocumentAdapter as i, arrangeMainTrackSeamlessly as it, assembleScriptText as j, assembleEntityContent as k, LORO_ENTITY_SCHEMA as l, resolveSpeechOverlapByShiftingVideos as lt, audioScriptAssetContent as m, safeDurationMs as mt, createPlainMemoryAdapter as n, solveVideoDocument as nt, createMirrorVideoDocumentAdapter as o, reassignSpeechesToVideoClipsByTime as ot, entityOrderGroups as p, partDurationMs as pt, assertValidVideoDocument as q, generatePartId as r, cascadeAfterVideoClipChanges as rt, readVideoDocumentFromDraft as s, recalculateTimelineDuration as st, PlainMemoryAdapter as t, laneTrackId as tt, LoroEntityDocument as u, syncAggregatedClipsTimePosition as ut, equalJson as v, partUnionToDraft as vt, resolveEntityTimelineLayout as w, resolveFieldPath as x, base64ToBytes as xt, applyFieldChanges as y, recordEntries as yt, hasSequence as z };
+export { partUnionSchema as $, decodeEntityRelationRows as A, isJsonObject as B, applyFieldChanges as C, recordEntries as Ct, EntityProjectionGraph as D, projectEntityTimeline as E, bytesToBase64 as Et, assembleScriptText as F, buildInitialVideoDocument as G, createRelationId as H, findComposedAudioScript as I, fromVideoDocument as J, buildSpeechHostMap as K, selectAudioScriptSegment as L, assembleCaptionContent as M, assembleEntityContent as N, resolveEntityTimelineLayout as O, assemblePhoneticScriptContent as P, validateVideoDocument as Q, updateEntityFields as R, equalJson as S, partUnionToDraft as St, resolveFieldPath as T, base64ToBytes as Tt, hasSequence as U, createEntityId as V, isMediaAssetVariantKind as W, VideoDocumentValidationError as X, toVideoDocument as Y, assertValidVideoDocument as Z, audioScriptAssetOf as _, partDurationMs as _t, createMirrorVideoDocument as a, laneTrackId as at, phoneticScriptAssetOf as b, effectiveVideoClipDurationMs as bt, DocumentMutationGuard as c, arrangeMainTrackSeamlessly as ct, LoroEntityDraft as d, recalculateTimelineDuration as dt, videoDocumentSchema as et, readEntityDocument as f, resolveAllSpeechOverlaps as ft, audioScriptAssetHash as g, isEmptyVideoClip as gt, audioScriptAssetFields as h, TIMELINE_SKELETON_DURATION_MS as ht, MirrorVideoDocumentAdapter as i, hasResolvedPlacement as it, ScriptCompositionError as j, EntityTimelineProjectionError as k, LORO_ENTITY_SCHEMA as l, fillMainTrackTimeGaps as lt, audioScriptAssetContent as m, syncAggregatedClipsTimePosition as mt, createPlainMemoryAdapter as n, ensureLaneTrack as nt, createMirrorVideoDocumentAdapter as o, solveVideoDocument as ot, entityOrderGroups as p, resolveSpeechOverlapByShiftingVideos as pt, derivePositionFromAbs as q, generatePartId as r, findLaneTrack as rt, readVideoDocumentFromDraft as s, cascadeAfterVideoClipChanges as st, PlainMemoryAdapter as t, LANE_KINDS_IN_STACK_ORDER as tt, LoroEntityDocument as u, reassignSpeechesToVideoClipsByTime as ut, phoneticScriptAssetContent as v, safeDurationMs as vt, assertFieldChanges as w, videoDocumentMirrorSchema as wt, scriptSourceAssetOf as x, speedOf as xt, phoneticScriptAssetHash as y, DEFAULT_UNIT_TIME_MS as yt, variantBaseEntityIds as z };

package/dist/{index-qAoWdqvp.d.ts → index-BZtSciyB.d.ts}

@@ -1104,7 +1104,7 @@ type CaptionSegmentSelection = JsonObject & {
 };
 //#endregion
 //#region ../medeo-dsl/src/relations.d.ts
-type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'to-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
 type RelationKind = KnownRelationKind | (string & {});
 type RelationTrace = JsonObject;
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as index_d_exports } from "./index-CMa6ZCtX.js";
-import { $ as SpeechHostMap, A as assertValidVideoDocument, At as VideoDocumentValidationIssueCode, B as EntityRow, Bt as SpeedShift, C as isImplementedSemanticOpKind, Ct as Timeline, D as PartIdFactory, Dt as VideoClipPart, E as ValidationError, Et as TrackItemTimePosition, F as ResolvedEntityTrack, Ft as speedOf, G as SequenceDuration, H as CaptionSegmentSelection, Ht as Track$1, I as resolveEntityTimelineLayout, It as Attachment, J as JsonObject, K as SequenceRange, L as projectEntityTimeline, Lt as CaptionPart$1, M as EntityTimelineTrackRole, Mt as VideoDraftContent, N as ResolvedEntityClipPlacement, Nt as VideoDraftPartUnion, O as generatePartId, Ot as VideoDocument, P as ResolvedEntityTimelineLayout, Pt as effectiveVideoClipDurationMs, Q as DerivedItemPosition, R as EntityTimelineProjectionError, Rt as CaptionStyle, S as SemanticOpKind, St as SpeechPart, T as SnapshotReadable, Tt as TrackItem, U as CaptionStyleFields, Ut as TrackItem$1, V as RelationRow, Vt as Timeline$1, W as ScriptTextSegment, X as EntityId, Y as JsonValue, Z as buildInitialVideoDocument, _ as SemanticOpName, _t as CaptionDisplayCue, a as PlainMemoryAdapter, at as LaneKind, b as ImplementedSemanticOpKind, bt as PartKind, c as MirrorVideoDocumentAdapter, ct as findLaneTrack, d as createMirrorVideoDocumentAdapter, dt as TrackDraft, et as buildSpeechHostMap, f as CommitOptions, ft as TrackItemDraft, g as SemanticOpInput, gt as BgmPart, h as SemanticEditor, ht as videoDocumentMirrorSchema, i as JournalEntry, it as LANE_KINDS_IN_STACK_ORDER, j as validateVideoDocument, jt as VideoDraft, k as VideoDocumentValidationError, kt as VideoDocumentValidationIssue, l as MirrorVideoDocumentOptions, lt as laneTrackId, m as SemanticDocumentAdapter, mt as VideoDocumentMirrorSchema, n as videoDocumentSchema, nt as fromVideoDocument, o as PlainMemoryAdapterOptions, ot as SolvedVideoDocument, p as OpActor, pt as VideoDocumentDraft, q as VoiceDescriptor, r as readVideoDocumentFromDraft, rt as toVideoDocument, s as createPlainMemoryAdapter, st as ensureLaneTrack, t as partUnionSchema, tt as derivePositionFromAbs, u as createMirrorVideoDocument, ut as solveVideoDocument, v as TransactAudit, vt as CaptionPart, w as SchemaValidator, wt as Track, x as PlannedSemanticOpKind, xt as PartUnion, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as DEFAULT_UNIT_TIME_MS, z as EntityRelationRows, zt as PartAggregation } from "./index-qAoWdqvp.js";
+import { $ as SpeechHostMap, A as assertValidVideoDocument, At as VideoDocumentValidationIssueCode, B as EntityRow, Bt as SpeedShift, C as isImplementedSemanticOpKind, Ct as Timeline, D as PartIdFactory, Dt as VideoClipPart, E as ValidationError, Et as TrackItemTimePosition, F as ResolvedEntityTrack, Ft as speedOf, G as SequenceDuration, H as CaptionSegmentSelection, Ht as Track$1, I as resolveEntityTimelineLayout, It as Attachment, J as JsonObject, K as SequenceRange, L as projectEntityTimeline, Lt as CaptionPart$1, M as EntityTimelineTrackRole, Mt as VideoDraftContent, N as ResolvedEntityClipPlacement, Nt as VideoDraftPartUnion, O as generatePartId, Ot as VideoDocument, P as ResolvedEntityTimelineLayout, Pt as effectiveVideoClipDurationMs, Q as DerivedItemPosition, R as EntityTimelineProjectionError, Rt as CaptionStyle, S as SemanticOpKind, St as SpeechPart, T as SnapshotReadable, Tt as TrackItem, U as CaptionStyleFields, Ut as TrackItem$1, V as RelationRow, Vt as Timeline$1, W as ScriptTextSegment, X as EntityId, Y as JsonValue, Z as buildInitialVideoDocument, _ as SemanticOpName, _t as CaptionDisplayCue, a as PlainMemoryAdapter, at as LaneKind, b as ImplementedSemanticOpKind, bt as PartKind, c as MirrorVideoDocumentAdapter, ct as findLaneTrack, d as createMirrorVideoDocumentAdapter, dt as TrackDraft, et as buildSpeechHostMap, f as CommitOptions, ft as TrackItemDraft, g as SemanticOpInput, gt as BgmPart, h as SemanticEditor, ht as videoDocumentMirrorSchema, i as JournalEntry, it as LANE_KINDS_IN_STACK_ORDER, j as validateVideoDocument, jt as VideoDraft, k as VideoDocumentValidationError, kt as VideoDocumentValidationIssue, l as MirrorVideoDocumentOptions, lt as laneTrackId, m as SemanticDocumentAdapter, mt as VideoDocumentMirrorSchema, n as videoDocumentSchema, nt as fromVideoDocument, o as PlainMemoryAdapterOptions, ot as SolvedVideoDocument, p as OpActor, pt as VideoDocumentDraft, q as VoiceDescriptor, r as readVideoDocumentFromDraft, rt as toVideoDocument, s as createPlainMemoryAdapter, st as ensureLaneTrack, t as partUnionSchema, tt as derivePositionFromAbs, u as createMirrorVideoDocument, ut as solveVideoDocument, v as TransactAudit, vt as CaptionPart, w as SchemaValidator, wt as Track, x as PlannedSemanticOpKind, xt as PartUnion, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as DEFAULT_UNIT_TIME_MS, z as EntityRelationRows, zt as PartAggregation } from "./index-BZtSciyB.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -232,8 +232,8 @@ declare function selectAudioScriptSegment(script: EntityRow<'audio-script'>, sel
 //#region src/entity-editor/entity-graph-http-client.d.ts
 /** One authenticated revision of the authoritative Medeo Entity graph. */
 interface EntityGraphState {
-  /** Current AudioScript content version attached to the project. */
-  readonly audioScriptEntityId: string;
+  /** Current AudioScript attached to the project, or null until one is written. */
+  readonly audioScriptEntityId: string | null;
   readonly revision: number;
   readonly loroSnapshot: string;
   readonly rows: EntityRelationRows;
@@ -614,7 +614,7 @@ interface EditorFoundation {
   readonly timelineEntityId: string;
   readonly trackEntityIds: Readonly<Record<EditorTrackRole, string>>;
   /** Initial or current AudioScript content ID selected by the foundation. */
-  readonly audioScriptEntityId: string;
+  readonly audioScriptEntityId: string | null;
 }
 /**
  * MEngine editor policy, not a cardinality restriction on the general-purpose DSL.
@@ -688,7 +688,7 @@ interface DocumentAudioScript {
 /** State exposing the current AudioScript content version attached to the project. */
 interface DocumentAudioScriptState {
   readonly rows: EntityRelationRows;
-  /** Current attachment; initialized projects point to a real script, including an empty one. */
+  /** Current attachment, or null until a script is transcribed or written. */
   readonly audioScriptEntityId: string | null;
 }
 /** Read only the attached version and preserve every segment; never aggregate other scripts. */
@@ -817,8 +817,10 @@ declare class LoroEntityDocument {
   /**
    * Bind a saved snapshot without rewriting text operations or resolving
    * selection conflicts. The script names the bytes the same way everything
-   * else does — an Asset entity plus a `from-asset` Relation — and keeps only
-   * the fingerprint that tells a stale snapshot from a current one.
+   * else does — an Asset entity plus a Relation — and keeps only the
+   * fingerprint that tells a stale snapshot from a current one. The Relation is
+   * `to-asset`: these bytes are the script's own content written out, not a
+   * source it was made from.
    */
   bindAudioScriptAsset(entityId: string, assetId: string, expectedContentHash: string): Uint8Array;
   canUndo(): boolean;
@@ -1735,12 +1737,32 @@ declare function relativePositionForAbs(ranges: MainClipRange[], absMs: number):
 declare function audioScriptAssetContent(payload: JsonObject): JsonObject;
 declare function audioScriptAssetHash(payload: JsonObject): string;
 /**
- * The Asset a script was written out to, read from the graph rather than the
- * script's own row: like every other entity, a script names its bytes through
- * a `from-asset` Relation and stores no locator itself.
+ * The Asset a script was written out to. It is a snapshot the script owns, so
+ * it is reached by `to-asset` — not `from-asset`, which would say the script
+ * was produced from bytes it cannot change.
  */
 declare function audioScriptAssetOf(rows: EntityRelationRows, entityId: string): EntityRow | undefined;
+/**
+ * The Asset a script was made from — a transcript it does not own. A script
+ * that has one never writes a snapshot of its own: the bytes it would describe
+ * are already named, and rewriting them would contradict their source.
+ */
+declare function scriptSourceAssetOf(rows: EntityRelationRows, entityId: string): EntityRow | undefined;
 /** Internal fingerprint prevents a resource from silently describing an older text revision. */
 declare function audioScriptAssetFields(payload: JsonObject): JsonObject;
+/**
+ * What a PhoneticScript hands to synthesis: the base AudioScript's text as the
+ * variant pronounces it, plus the variant's own phoneme and prosody control.
+ *
+ * The variant's content is written by a model — deciding how words are said is
+ * text work, not a mechanical copy — but the bytes a synthesizer reads have to
+ * leave the entity graph to reach it, because synthesis does not handle
+ * entities. Writing this resource down is that crossing, and it is why speech
+ * can only come from a PhoneticScript.
+ */
+declare function phoneticScriptAssetContent(rows: EntityRelationRows, entityId: string): JsonObject;
+declare function phoneticScriptAssetHash(rows: EntityRelationRows, entityId: string): string;
+/** The Asset a PhoneticScript was written out to, read from the graph. */
+declare function phoneticScriptAssetOf(rows: EntityRelationRows, entityId: string): EntityRow | undefined;
 //#endregion
-export { type Aggregation, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { type Aggregation, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as findLaneTrack, A as assemblePhoneticScriptContent, B as isMediaAssetVariantKind, C as EntityProjectionGraph, D as ScriptCompositionError, E as decodeEntityRelationRows, F as variantBaseEntityIds, G as toVideoDocument, H as buildSpeechHostMap, I as isJsonObject, J as validateVideoDocument, K as VideoDocumentValidationError, L as createEntityId, M as findComposedAudioScript, N as selectAudioScriptSegment, O as assembleCaptionContent, P as updateEntityFields, Q as ensureLaneTrack, R as createRelationId, S as projectEntityTimeline, St as bytesToBase64, T as EntityTimelineProjectionError, U as derivePositionFromAbs, V as buildInitialVideoDocument, W as fromVideoDocument, X as videoDocumentSchema, Y as partUnionSchema, Z as LANE_KINDS_IN_STACK_ORDER, _ as audioScriptAssetOf, _t as speedOf, a as createMirrorVideoDocument, at as fillMainTrackTimeGaps, b as assertFieldChanges, bt as videoDocumentMirrorSchema, c as DocumentMutationGuard, ct as resolveAllSpeechOverlaps, d as LoroEntityDraft, dt as TIMELINE_SKELETON_DURATION_MS, et as hasResolvedPlacement, f as readEntityDocument, ft as isEmptyVideoClip, g as audioScriptAssetHash, gt as effectiveVideoClipDurationMs, h as audioScriptAssetFields, ht as DEFAULT_UNIT_TIME_MS, i as MirrorVideoDocumentAdapter, it as arrangeMainTrackSeamlessly, j as assembleScriptText, k as assembleEntityContent, l as LORO_ENTITY_SCHEMA, lt as resolveSpeechOverlapByShiftingVideos, m as audioScriptAssetContent, mt as safeDurationMs, n as createPlainMemoryAdapter, nt as solveVideoDocument, o as createMirrorVideoDocumentAdapter, ot as reassignSpeechesToVideoClipsByTime, p as entityOrderGroups, pt as partDurationMs, q as assertValidVideoDocument, r as generatePartId, rt as cascadeAfterVideoClipChanges, s as readVideoDocumentFromDraft, st as recalculateTimelineDuration, t as PlainMemoryAdapter, tt as laneTrackId, u as LoroEntityDocument, ut as syncAggregatedClipsTimePosition, v as equalJson, vt as partUnionToDraft, w as resolveEntityTimelineLayout, x as resolveFieldPath, xt as base64ToBytes, y as applyFieldChanges, yt as recordEntries, z as hasSequence } from "./document-D631gqZV.js";
+import { $ as partUnionSchema, A as decodeEntityRelationRows, B as isJsonObject, C as applyFieldChanges, Ct as recordEntries, D as EntityProjectionGraph, E as projectEntityTimeline, Et as bytesToBase64, F as assembleScriptText, G as buildInitialVideoDocument, H as createRelationId, I as findComposedAudioScript, J as fromVideoDocument, K as buildSpeechHostMap, L as selectAudioScriptSegment, M as assembleCaptionContent, N as assembleEntityContent, O as resolveEntityTimelineLayout, P as assemblePhoneticScriptContent, Q as validateVideoDocument, R as updateEntityFields, S as equalJson, St as partUnionToDraft, T as resolveFieldPath, Tt as base64ToBytes, U as hasSequence, V as createEntityId, W as isMediaAssetVariantKind, X as VideoDocumentValidationError, Y as toVideoDocument, Z as assertValidVideoDocument, _ as audioScriptAssetOf, _t as partDurationMs, a as createMirrorVideoDocument, at as laneTrackId, b as phoneticScriptAssetOf, bt as effectiveVideoClipDurationMs, c as DocumentMutationGuard, ct as arrangeMainTrackSeamlessly, d as LoroEntityDraft, dt as recalculateTimelineDuration, et as videoDocumentSchema, f as readEntityDocument, ft as resolveAllSpeechOverlaps, g as audioScriptAssetHash, gt as isEmptyVideoClip, h as audioScriptAssetFields, ht as TIMELINE_SKELETON_DURATION_MS, i as MirrorVideoDocumentAdapter, it as hasResolvedPlacement, j as ScriptCompositionError, k as EntityTimelineProjectionError, l as LORO_ENTITY_SCHEMA, lt as fillMainTrackTimeGaps, m as audioScriptAssetContent, mt as syncAggregatedClipsTimePosition, n as createPlainMemoryAdapter, nt as ensureLaneTrack, o as createMirrorVideoDocumentAdapter, ot as solveVideoDocument, p as entityOrderGroups, pt as resolveSpeechOverlapByShiftingVideos, q as derivePositionFromAbs, r as generatePartId, rt as findLaneTrack, s as readVideoDocumentFromDraft, st as cascadeAfterVideoClipChanges, t as PlainMemoryAdapter, tt as LANE_KINDS_IN_STACK_ORDER, u as LoroEntityDocument, ut as reassignSpeechesToVideoClipsByTime, v as phoneticScriptAssetContent, vt as safeDurationMs, w as assertFieldChanges, wt as videoDocumentMirrorSchema, x as scriptSourceAssetOf, xt as speedOf, y as phoneticScriptAssetHash, yt as DEFAULT_UNIT_TIME_MS, z as variantBaseEntityIds } from "./document-CAZ_A9R8.js";
 import { addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, t as schemas_exports } from "./schemas.js";
 import { LoroDoc, UndoManager, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -221,7 +221,8 @@ function compileEntityRows(snapshot, rows, validate) {
 }
 /** Compile an edit on an existing peer, retaining its native local undo history. */
 function applyEntityRows(editor, rows) {
-	const before = editor.snapshot().rows;
+	const baseline = editor.snapshot();
+	const before = baseline.rows;
 	const oldEntities = new Map(before.entities.map((row) => [row.entityId, row]));
 	const newEntities = new Map(rows.entities.map((row) => [row.entityId, row]));
 	const oldRelations = new Map(before.relations.map((row) => [row.relationId, row]));
@@ -237,10 +238,16 @@ function applyEntityRows(editor, rows) {
 					if (!equalJson(row.metadata, next.metadata) || !equalJson(row.trace, next.trace)) draft.patchRelation(row.relationId, next.metadata, next.trace);
 				}
 			}
+			let attached = baseline.project.audioScriptEntityId !== void 0;
 			for (const row of rows.entities) {
 				const previous = oldEntities.get(row.entityId);
-				if (!previous) draft.create(row);
-				else {
+				if (!previous) {
+					draft.create(row);
+					if (!attached && row.entityKind === "audio-script") {
+						draft.attach("audioScriptEntityId", String(row.entityId));
+						attached = true;
+					}
+				} else {
 					if (previous.entityKind !== row.entityKind) throw new Error("Entity kind cannot change");
 					if (!equalJson(previous.payload, row.payload)) draft.replaceOwned(row.entityId, row.payload);
 				}
@@ -350,23 +357,14 @@ function memotaLocator(value) {
 * explicit project attachment, multiple candidates are ambiguous. Existing
 * content IDs are reused here; Loro editing advances their immutable versions.
 */
-function ensureDocumentAudioScript(entities, idFactory, selectedEntityId) {
+function ensureDocumentAudioScript(entities, selectedEntityId) {
 	if (selectedEntityId != null) {
 		if (!entities.some((row) => row.entityKind === "audio-script" && row.entityId === selectedEntityId)) throw new EntityTimelineProjectionError(`Selected AudioScript ${selectedEntityId} does not exist`);
 		return selectedEntityId;
 	}
 	const scripts = entities.filter((row) => row.entityKind === "audio-script");
 	if (scripts.length > 1) throw new EntityTimelineProjectionError("Select an AudioScript for the editor panel when multiple scripts exist");
-	const existing = scripts[0];
-	if (existing !== void 0) return existing.entityId;
-	const id = createEntityId(idFactory("entity"));
-	if (entities.some((row) => row.entityId === id)) throw new Error(`Duplicate entity id ${id}`);
-	entities.push({
-		entityId: id,
-		entityKind: "audio-script",
-		payload: { segments: [] }
-	});
-	return id;
+	return scripts[0]?.entityId ?? null;
 }
 /** Add only missing editor structure; existing identities and owned settings are never replaced. */
 function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${globalThis.crypto.randomUUID()}`, timelinePayload = {}, selectedAudioScriptEntityId) {
@@ -420,7 +418,7 @@ function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${gl
 		}
 		trackEntityIds[role] = track.entityId;
 	}
-	const audioScriptEntityId = ensureDocumentAudioScript(entities, idFactory, selectedAudioScriptEntityId);
+	const audioScriptEntityId = ensureDocumentAudioScript(entities, selectedAudioScriptEntityId);
 	return {
 		rows: {
 			entities,
@@ -488,15 +486,16 @@ function parseWireState(value, expectedDocId) {
 	if (value.doc_id !== expectedDocId) throw new Error(`Entity-state response doc_id mismatch: expected "${expectedDocId}"`);
 	const rows = parseWireRows(value.rows);
 	decodeEntityRelationRows(rows, numericMarkerValidation$1);
-	if (typeof value.audio_script_entity_id !== "string") throw new Error("Document AudioScript is not initialized");
+	const attached = value.audio_script_entity_id;
+	if (attached !== null && typeof attached !== "string") throw new Error("Invalid document AudioScript identity");
 	if (typeof value.loro_snapshot !== "string") throw new Error("Missing causal Loro snapshot");
 	const state = {
 		revision: value.revision,
 		loroSnapshot: value.loro_snapshot,
 		rows,
-		audioScriptEntityId: value.audio_script_entity_id
+		audioScriptEntityId: attached
 	};
-	readDocumentAudioScript(state);
+	if (attached !== null) readDocumentAudioScript(state);
 	return state;
 }
 function parseWireRows(value) {
@@ -2035,7 +2034,15 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 	const normalizedMainRanges = overlapNormalizedMainRanges(legacy);
 	let entities = structuredClone([...initial.entities]);
 	let relations = structuredClone([...initial.relations]);
-	const documentAudioScriptEntityId = ensureDocumentAudioScript(entities, idFactory);
+	const documentAudioScriptEntityId = ensureDocumentAudioScript(entities) ?? (() => {
+		const id = createEntityId(idFactory("entity"));
+		entities.push({
+			entityId: id,
+			entityKind: "audio-script",
+			payload: { segments: [] }
+		});
+		return String(id);
+	})();
 	const addEntity = (kind, payload, existingId) => {
 		const entityId = createEntityId(existingId ?? idFactory("entity"));
 		if (entities.some((row) => row.entityId === entityId)) fail(`Migration entity identity collision: ${entityId}`);
@@ -5138,4 +5145,4 @@ function serverCovers(serverVV, target) {
 	return covers(server, target);
 }
 //#endregion
-export { DEFAULT_UNIT_TIME_MS, EntityGraphHttpClient, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, LoroEntityDocument, LoroEntityDraft, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, ValidationError, VideoDocumentValidationError, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, schemas_exports as schemas, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { DEFAULT_UNIT_TIME_MS, EntityGraphHttpClient, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, LoroEntityDocument, LoroEntityDraft, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, ValidationError, VideoDocumentValidationError, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, schemas_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };

package/dist/testing.d.ts

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

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { St as bytesToBase64, o as createMirrorVideoDocumentAdapter, xt as base64ToBytes } from "./document-D631gqZV.js";
+import { Et as bytesToBase64, Tt as base64ToBytes, o as createMirrorVideoDocumentAdapter } from "./document-CAZ_A9R8.js";
 import { t as classifyUpdate } from "./loro-relay-doc-cJSY-uau.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "2.0.1-alpha.11",
+  "version": "2.0.1-alpha.13",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.3.3",
     "zod": "^4.4.3",
-    "@mengine/storage": "2.0.1-alpha.11",
-    "@mengine/sync": "2.0.1-alpha.11",
-    "@mengine/utils": "2.0.1-alpha.11"
+    "@mengine/utils": "2.0.1-alpha.13",
+    "@mengine/storage": "2.0.1-alpha.13",
+    "@mengine/sync": "2.0.1-alpha.13"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",