@mengine/medeo-client 2.0.1-alpha.14 → 2.0.1-alpha.16

package/dist/{document-BHHbS_17.js → document-ecRldQY4.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 { ensureLaneTrack as $, assembleEntityContent as A, hasSequence as B, projectEntityTimeline as C, bytesToBase64 as Ct, decodeEntityRelationRows as D, EntityTimelineProjectionError as E, updateEntityFields as F, fromVideoDocument as G, buildInitialVideoDocument as H, variantBaseEntityIds as I, assertValidVideoDocument as J, toVideoDocument as K, isJsonObject as L, assembleScriptText as M, findComposedAudioScript as N, ScriptCompositionError as O, selectAudioScriptSegment as P, LANE_KINDS_IN_STACK_ORDER as Q, createEntityId as R, resolveFieldPath as S, base64ToBytes as St, resolveEntityTimelineLayout as T, buildSpeechHostMap as U, isMediaAssetVariantKind as V, derivePositionFromAbs as W, partUnionSchema as X, validateVideoDocument as Y, videoDocumentSchema as Z, audioScriptAssetOf as _, effectiveVideoClipDurationMs as _t, createMirrorVideoDocument as a, arrangeMainTrackSeamlessly as at, applyFieldChanges as b, recordEntries as bt, DocumentMutationGuard as c, recalculateTimelineDuration as ct, LoroEntityDraft as d, syncAggregatedClipsTimePosition as dt, findLaneTrack as et, readEntityDocument as f, TIMELINE_SKELETON_DURATION_MS as ft, audioScriptAssetHash as g, DEFAULT_UNIT_TIME_MS as gt, audioScriptAssetFields as h, safeDurationMs as ht, MirrorVideoDocumentAdapter as i, cascadeAfterVideoClipChanges as it, assemblePhoneticScriptContent as j, assembleCaptionContent as k, LORO_ENTITY_SCHEMA as l, resolveAllSpeechOverlaps as lt, audioScriptAssetContent as m, partDurationMs as mt, createPlainMemoryAdapter as n, laneTrackId as nt, createMirrorVideoDocumentAdapter as o, fillMainTrackTimeGaps as ot, entityOrderGroups as p, isEmptyVideoClip as pt, VideoDocumentValidationError as q, generatePartId as r, solveVideoDocument as rt, readVideoDocumentFromDraft as s, reassignSpeechesToVideoClipsByTime as st, PlainMemoryAdapter as t, hasResolvedPlacement as tt, LoroEntityDocument as u, resolveSpeechOverlapByShiftingVideos as ut, canonicalJson as v, speedOf as vt, EntityProjectionGraph as w, assertFieldChanges as x, videoDocumentMirrorSchema as xt, equalJson as y, partUnionToDraft as yt, createRelationId as z };
+export { validateVideoDocument as $, EntityTimelineProjectionError as A, variantBaseEntityIds as B, equalJson as C, partUnionToDraft as Ct, projectEntityTimeline as D, bytesToBase64 as Dt, resolveFieldPath as E, base64ToBytes as Et, assemblePhoneticScriptContent as F, isMediaAssetVariantKind as G, createEntityId as H, assembleScriptText as I, derivePositionFromAbs as J, buildInitialVideoDocument as K, findComposedAudioScript as L, ScriptCompositionError as M, assembleCaptionContent as N, EntityProjectionGraph as O, assembleEntityContent as P, assertValidVideoDocument as Q, selectAudioScriptSegment as R, canonicalJson as S, speedOf as St, assertFieldChanges as T, videoDocumentMirrorSchema as Tt, createRelationId as U, isJsonObject as V, hasSequence as W, toVideoDocument as X, fromVideoDocument as Y, VideoDocumentValidationError as Z, audioScriptAssetOf as _, isEmptyVideoClip as _t, createMirrorVideoDocument as a, hasResolvedPlacement as at, phoneticScriptAssetOf as b, DEFAULT_UNIT_TIME_MS as bt, DocumentMutationGuard as c, cascadeAfterVideoClipChanges as ct, LoroEntityDraft as d, reassignSpeechesToVideoClipsByTime as dt, partUnionSchema as et, readEntityDocument as f, recalculateTimelineDuration as ft, audioScriptAssetHash as g, TIMELINE_SKELETON_DURATION_MS as gt, audioScriptAssetFields as h, syncAggregatedClipsTimePosition as ht, MirrorVideoDocumentAdapter as i, findLaneTrack as it, decodeEntityRelationRows as j, resolveEntityTimelineLayout as k, LORO_ENTITY_SCHEMA as l, arrangeMainTrackSeamlessly as lt, audioScriptAssetContent as m, resolveSpeechOverlapByShiftingVideos as mt, createPlainMemoryAdapter as n, LANE_KINDS_IN_STACK_ORDER as nt, createMirrorVideoDocumentAdapter as o, laneTrackId as ot, entityOrderGroups as p, resolveAllSpeechOverlaps as pt, buildSpeechHostMap as q, generatePartId as r, ensureLaneTrack as rt, readVideoDocumentFromDraft as s, solveVideoDocument as st, PlainMemoryAdapter as t, videoDocumentSchema as tt, LoroEntityDocument as u, fillMainTrackTimeGaps as ut, phoneticScriptAssetContent as v, partDurationMs as vt, applyFieldChanges as w, recordEntries as wt, scriptSourceAssetOf as x, effectiveVideoClipDurationMs as xt, phoneticScriptAssetHash as y, safeDurationMs as yt, updateEntityFields as z };

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;
@@ -385,8 +385,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;
@@ -995,7 +997,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.
@@ -1075,7 +1077,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. */
@@ -1961,12 +1963,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 AddGeneratedVisualsInput, type AddSpeechAssetsInput, type Aggregation, type ApplyCaptionAssetsInput, type ApplyCaptionAssetsResult, type AsrCaptionSegment, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionAssetFact, type CaptionAssetsEffectEnvelope, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, type CompiledCaptionAssetsEffect, type CompiledGeneratedVisualEffect, type CompiledSpeechAssetsEffect, type ContinueVideoInput, 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, type GeneratedSpeechCaptionFact, type GeneratedSpeechFact, type GeneratedSpeechSourceFact, type GeneratedVisualClipFact, type GeneratedVisualEffectEnvelope, type GeneratedVisualEffectResult, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedCaptionAsset, 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 ReplaceVoiceSpeechAssetsInput, type ReplacementMediaClipInput, type ResolvedAsrSpeechSegment, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ResolvedSpeechScriptSegment, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SetVideoClipSpeedEffectInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechAssetsEffectEnvelope, type SpeechAssetsEffectInput, type SpeechAssetsEffectResult, 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 VideoClipSpeedMode, 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, compileCaptionAssetsEffect, compileEntityRows, compileGeneratedVisualEffect, compileSpeechAssetsEffect, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importCaptionAsset, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionAssetsEffect, prepareCaptionContent, prepareContinueVideoEffect, prepareGeneratedVisualEffect, prepareSpeechAssetsEffect, 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 AddGeneratedVisualsInput, type AddSpeechAssetsInput, type Aggregation, type ApplyCaptionAssetsInput, type ApplyCaptionAssetsResult, type AsrCaptionSegment, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionAssetFact, type CaptionAssetsEffectEnvelope, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, type CompiledCaptionAssetsEffect, type CompiledGeneratedVisualEffect, type CompiledSpeechAssetsEffect, type ContinueVideoInput, 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, type GeneratedSpeechCaptionFact, type GeneratedSpeechFact, type GeneratedSpeechSourceFact, type GeneratedVisualClipFact, type GeneratedVisualEffectEnvelope, type GeneratedVisualEffectResult, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedCaptionAsset, 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 ReplaceVoiceSpeechAssetsInput, type ReplacementMediaClipInput, type ResolvedAsrSpeechSegment, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ResolvedSpeechScriptSegment, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SetVideoClipSpeedEffectInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechAssetsEffectEnvelope, type SpeechAssetsEffectInput, type SpeechAssetsEffectResult, 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 VideoClipSpeedMode, 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, compileCaptionAssetsEffect, compileEntityRows, compileGeneratedVisualEffect, compileSpeechAssetsEffect, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importCaptionAsset, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionAssetsEffect, prepareCaptionContent, prepareContinueVideoEffect, prepareGeneratedVisualEffect, prepareSpeechAssetsEffect, 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 ensureLaneTrack, A as assembleEntityContent, B as hasSequence, C as projectEntityTimeline, Ct as bytesToBase64, D as decodeEntityRelationRows, E as EntityTimelineProjectionError, F as updateEntityFields, G as fromVideoDocument, H as buildInitialVideoDocument, I as variantBaseEntityIds, J as assertValidVideoDocument, K as toVideoDocument, L as isJsonObject, M as assembleScriptText, N as findComposedAudioScript, O as ScriptCompositionError, P as selectAudioScriptSegment, Q as LANE_KINDS_IN_STACK_ORDER, R as createEntityId, S as resolveFieldPath, St as base64ToBytes, T as resolveEntityTimelineLayout, U as buildSpeechHostMap, V as isMediaAssetVariantKind, W as derivePositionFromAbs, X as partUnionSchema, Y as validateVideoDocument, Z as videoDocumentSchema, _ as audioScriptAssetOf, _t as effectiveVideoClipDurationMs, a as createMirrorVideoDocument, at as arrangeMainTrackSeamlessly, b as applyFieldChanges, bt as recordEntries, c as DocumentMutationGuard, ct as recalculateTimelineDuration, d as LoroEntityDraft, dt as syncAggregatedClipsTimePosition, et as findLaneTrack, f as readEntityDocument, ft as TIMELINE_SKELETON_DURATION_MS, g as audioScriptAssetHash, gt as DEFAULT_UNIT_TIME_MS, h as audioScriptAssetFields, ht as safeDurationMs, i as MirrorVideoDocumentAdapter, it as cascadeAfterVideoClipChanges, j as assemblePhoneticScriptContent, k as assembleCaptionContent, l as LORO_ENTITY_SCHEMA, lt as resolveAllSpeechOverlaps, m as audioScriptAssetContent, mt as partDurationMs, n as createPlainMemoryAdapter, nt as laneTrackId, o as createMirrorVideoDocumentAdapter, ot as fillMainTrackTimeGaps, p as entityOrderGroups, pt as isEmptyVideoClip, q as VideoDocumentValidationError, r as generatePartId, rt as solveVideoDocument, s as readVideoDocumentFromDraft, st as reassignSpeechesToVideoClipsByTime, t as PlainMemoryAdapter, tt as hasResolvedPlacement, u as LoroEntityDocument, ut as resolveSpeechOverlapByShiftingVideos, v as canonicalJson, vt as speedOf, w as EntityProjectionGraph, x as assertFieldChanges, xt as videoDocumentMirrorSchema, y as equalJson, yt as partUnionToDraft, z as createRelationId } from "./document-BHHbS_17.js";
+import { $ as validateVideoDocument, A as EntityTimelineProjectionError, B as variantBaseEntityIds, C as equalJson, Ct as partUnionToDraft, D as projectEntityTimeline, Dt as bytesToBase64, E as resolveFieldPath, Et as base64ToBytes, F as assemblePhoneticScriptContent, G as isMediaAssetVariantKind, H as createEntityId, I as assembleScriptText, J as derivePositionFromAbs, K as buildInitialVideoDocument, L as findComposedAudioScript, M as ScriptCompositionError, N as assembleCaptionContent, O as EntityProjectionGraph, P as assembleEntityContent, Q as assertValidVideoDocument, R as selectAudioScriptSegment, S as canonicalJson, St as speedOf, T as assertFieldChanges, Tt as videoDocumentMirrorSchema, U as createRelationId, V as isJsonObject, W as hasSequence, X as toVideoDocument, Y as fromVideoDocument, Z as VideoDocumentValidationError, _ as audioScriptAssetOf, _t as isEmptyVideoClip, a as createMirrorVideoDocument, at as hasResolvedPlacement, b as phoneticScriptAssetOf, bt as DEFAULT_UNIT_TIME_MS, c as DocumentMutationGuard, ct as cascadeAfterVideoClipChanges, d as LoroEntityDraft, dt as reassignSpeechesToVideoClipsByTime, et as partUnionSchema, f as readEntityDocument, ft as recalculateTimelineDuration, g as audioScriptAssetHash, gt as TIMELINE_SKELETON_DURATION_MS, h as audioScriptAssetFields, ht as syncAggregatedClipsTimePosition, i as MirrorVideoDocumentAdapter, it as findLaneTrack, j as decodeEntityRelationRows, k as resolveEntityTimelineLayout, l as LORO_ENTITY_SCHEMA, lt as arrangeMainTrackSeamlessly, m as audioScriptAssetContent, mt as resolveSpeechOverlapByShiftingVideos, n as createPlainMemoryAdapter, nt as LANE_KINDS_IN_STACK_ORDER, o as createMirrorVideoDocumentAdapter, ot as laneTrackId, p as entityOrderGroups, pt as resolveAllSpeechOverlaps, q as buildSpeechHostMap, r as generatePartId, rt as ensureLaneTrack, s as readVideoDocumentFromDraft, st as solveVideoDocument, t as PlainMemoryAdapter, tt as videoDocumentSchema, u as LoroEntityDocument, ut as fillMainTrackTimeGaps, v as phoneticScriptAssetContent, vt as partDurationMs, w as applyFieldChanges, wt as recordEntries, x as scriptSourceAssetOf, xt as effectiveVideoClipDurationMs, y as phoneticScriptAssetHash, yt as safeDurationMs, z as updateEntityFields } from "./document-ecRldQY4.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 { sha256 } from "@noble/hashes/sha2.js";
@@ -223,7 +223,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]));
@@ -239,10 +240,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);
 				}
@@ -352,23 +359,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) {
@@ -422,7 +420,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,
@@ -490,15 +488,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) {
@@ -2722,13 +2721,13 @@ function requireAssetlessAsrSourceScript(rows, source) {
 	return audioScript;
 }
 function requireNoAudioScriptAsset(rows, audioScriptEntityId, label) {
-	if (incidentRelations(rows, audioScriptEntityId).filter((relation) => relation.relationKind === "from-asset").length > 0) throw new Error(`${label} AudioScript "${audioScriptEntityId}" must not have an Asset binding`);
+	if (incidentRelations(rows, audioScriptEntityId).filter((relation) => relation.relationKind === "to-asset").length > 0) throw new Error(`${label} AudioScript "${audioScriptEntityId}" must not have an authored Asset snapshot`);
 }
 function requireCanonicalAudioScriptAsset(rows, audioScriptEntityId) {
-	const bindings = incidentRelations(rows, audioScriptEntityId).filter((relation) => relation.relationKind === "from-asset");
+	const bindings = incidentRelations(rows, audioScriptEntityId).filter((relation) => relation.relationKind === "to-asset");
 	if (bindings.length !== 1) throw new Error(`AudioScript "${audioScriptEntityId}" requires exactly one Asset binding`);
 	const binding = bindings[0];
-	if (binding.endpoint0EntityId !== audioScriptEntityId) throw new Error("from-asset must use ordered endpoints [AudioScript, Asset]");
+	if (binding.endpoint0EntityId !== audioScriptEntityId) throw new Error("to-asset must use ordered endpoints [AudioScript, Asset]");
 	const asset = requireEntityKind(rows, binding.endpoint1EntityId, "asset");
 	if (asset.payload.system !== "memota" || typeof asset.payload.key !== "string" || asset.payload.key.length === 0 || asset.payload.key.trim() !== asset.payload.key) throw new Error(`AudioScript Asset "${asset.entityId}" must state a canonical memota locator`);
 	return asset;
@@ -3400,7 +3399,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}`);
@@ -6503,4 +6510,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, compileCaptionAssetsEffect, compileEntityRows, compileGeneratedVisualEffect, compileSpeechAssetsEffect, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importCaptionAsset, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionAssetsEffect, prepareCaptionContent, prepareContinueVideoEffect, prepareGeneratedVisualEffect, prepareSpeechAssetsEffect, 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, compileCaptionAssetsEffect, compileEntityRows, compileGeneratedVisualEffect, compileSpeechAssetsEffect, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importCaptionAsset, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionAssetsEffect, prepareCaptionContent, prepareContinueVideoEffect, prepareGeneratedVisualEffect, prepareSpeechAssetsEffect, 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 { Ct as bytesToBase64, St as base64ToBytes, o as createMirrorVideoDocumentAdapter } from "./document-BHHbS_17.js";
+import { Dt as bytesToBase64, Et as base64ToBytes, o as createMirrorVideoDocumentAdapter } from "./document-ecRldQY4.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.14",
+  "version": "2.0.1-alpha.16",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.3.3",
     "zod": "^4.4.3",
-    "@mengine/sync": "2.0.1-alpha.14",
-    "@mengine/utils": "2.0.1-alpha.14",
-    "@mengine/storage": "2.0.1-alpha.14"
+    "@mengine/sync": "2.0.1-alpha.16",
+    "@mengine/utils": "2.0.1-alpha.16",
+    "@mengine/storage": "2.0.1-alpha.16"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",