@mengine/medeo-client 2.1.1-dsl.1 → 2.1.1-dsl.11

package/dist/{index-yifEtZSP.d.ts → index-JWERGMrC.d.ts}

@@ -1,6 +1,6 @@
-import { G as ResourceSystem, et as TrackRole, z as MedeoDslSnapshot } from "./video-draft-types-c_shaRyq.js";
-import { _ as MedeoDsl, f as DslEditor, i as VideoDraftProjection } from "./index-Cu7SdKN5.js";
-import { a as MengineDocSessionOptions, h as ManualSyncTransport, m as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-B7fC7q7P.js";
+import { G as ResourceSystem, R as MedeoDslSnapshot, rt as TrackRole } from "./video-draft-types-GqXnsOzA.js";
+import { b as MedeoDsl, h as UploadText, i as AudioScriptView, m as DslEditor, o as VideoDraftProjection } from "./index-DSpKN_ta.js";
+import { _ as ManualSyncTransport, a as MengineDocSessionOptions, g as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-DAfOkcnZ.js";
 
 //#region src/manual-sync/manual-sync-doc.d.ts
 /** Explicit synchronization over the same DSL/editor used by the live Session. */
@@ -8,7 +8,10 @@ declare class ManualSyncDoc extends ManualSyncTransport {
   readonly dsl: MedeoDsl;
   readonly editor: DslEditor;
   private constructor();
-  static open(options: ManualSyncDocOptions): Promise<ManualSyncDoc>;
+  /** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
+  static open(options: ManualSyncDocOptions & {
+    uploadText?: UploadText;
+  }): Promise<ManualSyncDoc>;
   snapshot(): {
     readonly "timeline-entities": {
       readonly [x: string]: {
@@ -30,6 +33,12 @@ declare class ManualSyncDoc extends ManualSyncTransport {
           readonly fillTimeline?: true | undefined;
         };
         readonly volume?: number | undefined;
+        readonly source: string;
+        readonly anchor?: {
+          readonly to: string;
+          readonly offsetMs: number;
+          readonly fallback_abs_ms: number;
+        } | undefined;
       };
     };
     readonly "media-entities": {
@@ -57,12 +66,36 @@ declare class ManualSyncDoc extends ManualSyncTransport {
     };
     readonly "audio-script-entities": {
       readonly [x: string]: {
-        readonly body: string;
+        readonly segments: readonly {
+          readonly id: string;
+          readonly text: string;
+        }[];
         readonly defaultLanguage?: string | undefined;
       };
     };
+    readonly "phonetic-script-entities": {
+      readonly [x: string]: {
+        readonly phoneme: {
+          readonly phonemeScript?: string | undefined;
+          readonly audioScriptId: string;
+          readonly segmentId: string;
+          readonly start?: import("loro-crdt").Cursor | undefined;
+          readonly end?: import("loro-crdt").Cursor | undefined;
+        };
+        readonly system?: "memota" | undefined;
+        readonly key?: string | undefined;
+        readonly storageKey?: string | undefined;
+        readonly digest?: string | undefined;
+      };
+    };
     readonly "caption-entities": {
       readonly [x: string]: {
+        readonly selection?: {
+          readonly audioScriptId: string;
+          readonly segmentId: string;
+          readonly start?: import("loro-crdt").Cursor | undefined;
+          readonly end?: import("loro-crdt").Cursor | undefined;
+        } | undefined;
         readonly text?: string | undefined;
         readonly style?: {
           readonly font?: {
@@ -88,44 +121,6 @@ declare class ManualSyncDoc extends ManualSyncTransport {
         readonly name?: string | undefined;
       };
     };
-    readonly "asset-entities": {
-      readonly [x: string]: {
-        readonly system: ResourceSystem;
-        readonly key: string;
-        readonly storageKey?: string | undefined;
-        readonly digest?: string | undefined;
-      };
-    };
-    readonly "clip-source-relations": {
-      readonly [x: string]: {
-        readonly clipId: string;
-        readonly sourceId: string;
-      };
-    };
-    readonly "time-anchor-relations": {
-      readonly [x: string]: {
-        readonly from: string;
-        readonly to: string;
-        readonly offsetMs: number;
-        readonly fallback_abs_ms: number;
-      };
-    };
-    readonly "caption-content-relations": {
-      readonly [x: string]: {
-        readonly captionId: string;
-        readonly audioScriptId: string;
-        readonly start: import("loro-crdt").Cursor;
-        readonly end: import("loro-crdt").Cursor;
-      };
-    };
-    readonly "caption-alignment-relations": {
-      readonly [x: string]: {
-        readonly captionId: string;
-        readonly mediaId: string;
-        readonly startMs: number;
-        readonly endMs: number;
-      };
-    };
     readonly "voice-timbre-relations": {
       readonly [x: string]: {
         readonly recordingId: string;
@@ -136,18 +131,7 @@ declare class ManualSyncDoc extends ManualSyncTransport {
       readonly [x: string]: {
         readonly entityId: string;
         readonly sourceId: string;
-      };
-    };
-    readonly "from-asset-relations": {
-      readonly [x: string]: {
-        readonly audioScriptId: string;
-        readonly assetId: string;
-      };
-    };
-    readonly "to-asset-relations": {
-      readonly [x: string]: {
-        readonly audioScriptId: string;
-        readonly assetId: string;
+        readonly sourceDigest?: string | undefined;
       };
     };
     readonly 'contain-relations': readonly {
@@ -175,6 +159,14 @@ declare class ManualSyncDoc extends ManualSyncTransport {
         readonly bodyId: string;
       };
     };
+    readonly phoneticText: {
+      readonly [x: string]: {
+        readonly text: string;
+        readonly start: number;
+        readonly end: number;
+        readonly bodyId: string;
+      };
+    };
     readonly diagnostics: readonly {
       readonly code: string;
       readonly path: string;
@@ -189,9 +181,14 @@ declare class ManualSyncDoc extends ManualSyncTransport {
 type MengineDocSessionUpdateEvent = DocumentSessionUpdateEvent<MedeoDslSnapshot>;
 /** Default collaborative session: one DSL handle and one editor over the synchronized LoroDoc. */
 declare class MengineDocSession extends DocumentSession<MedeoDslSnapshot, DslEditor, MedeoDsl> {
-  constructor(options: MengineDocSessionOptions);
+  /** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
+  constructor(options: MengineDocSessionOptions & {
+    uploadText?: UploadText;
+  });
   get dsl(): MedeoDsl;
   projectVideoDraft(): VideoDraftProjection;
+  /** The document's AudioScripts with what says and shows them; read from the same snapshot as the VideoDraft. */
+  projectAudioScripts(): AudioScriptView[];
 }
 //#endregion
 export { MengineDocSessionUpdateEvent as n, ManualSyncDoc as r, MengineDocSession as t };

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,8 +1,8 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
 import { a as covers, c as readMengineEventStream, d as MenginePushRejectedError, i as openManualDocument, l as MengineHttpClient, n as MedeoHttpDocStorage, o as decodeDocVersionMark, r as ManualSyncTransport, s as encodeDocVersionMark, t as MemoryDocStorage, u as MengineHttpRequestError } from "./storage-BW3tI_ER.js";
-import { a as documentFormat, c as isInvalidAtomic, ct as relationId, i as assertDslDocument, l as timeAnchorCodec, lt as resourceId, o as medeoDslLoroShape, r as UnsupportedDocumentFormatError, s as captionContentCodec, st as defaultIdFactory, t as DEFAULT_UNIT_TIME_MS, ut as tupleHash } from "./video-draft-types-TXRv3wS6.js";
-import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, o as resolveDslLayout, r as createInitialMedeoDsl, s as DslProjectionError, t as fromVideoDraft } from "./dsl-EV6kCdr6.js";
-import { UndoManager, VersionVector } from "loro-crdt";
+import { _t as tupleHash, a as documentFormat, c as isInvalidAtomic, gt as resourceId, ht as relationId, i as assertDslDocument, mt as defaultIdFactory, o as medeoDslLoroShape, r as UnsupportedDocumentFormatError, s as captionContentCodec, t as DEFAULT_UNIT_TIME_MS, u as timeAnchorCodec } from "./video-draft-types-BnbfWrBx.js";
+import { a as toAudioScriptViews, c as DslProjectionError, i as DslEditor, n as toVideoDraft, o as MedeoDsl, r as createInitialMedeoDsl, s as resolveDslLayout, t as fromVideoDraft } from "./dsl-Co3RI5F1.js";
+import { UndoManager, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
 import { DisposableSet, EventBus } from "@mengine/utils";
 //#region src/manual-sync/manual-sync-doc.ts
@@ -10,14 +10,15 @@ import { DisposableSet, EventBus } from "@mengine/utils";
 var ManualSyncDoc = class ManualSyncDoc extends ManualSyncTransport {
 	dsl;
 	editor;
-	constructor(client, doc, watermark) {
+	constructor(client, doc, watermark, uploadText) {
 		super(client, doc, watermark);
 		assertDslDocument(doc);
 		this.dsl = new MedeoDsl(doc);
-		this.editor = new DslEditor(this.dsl);
+		this.editor = new DslEditor(this.dsl, void 0, uploadText);
 	}
+	/** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
 	static open(options) {
-		return openManualDocument(options, (doc, watermark) => new ManualSyncDoc(options.client, doc, watermark));
+		return openManualDocument(options, (doc, watermark) => new ManualSyncDoc(options.client, doc, watermark, options.uploadText));
 	}
 	snapshot() {
 		this.assertActive();
@@ -222,6 +223,7 @@ var DocumentSession = class {
 	started = false;
 	startTask = null;
 	destroyed = false;
+	closeTask = null;
 	lifetime = null;
 	hasConnected = false;
 	initialVersionValue = null;
@@ -438,6 +440,13 @@ var DocumentSession = class {
 		this.local.connection.connect();
 		await this.local.connection.waitForConnected().abortOn(this.lifetime.signal);
 		if (this.destroyed) throw new Error("mengine doc session destroyed");
+		if (this.options.initialSnapshot) {
+			await this.local.pushDocUpdate({
+				docId: this.docId,
+				data: this.options.initialSnapshot
+			}, "initial-snapshot");
+			if (this.destroyed) throw new Error("mengine doc session destroyed");
+		}
 		this.server.connection.connect();
 		this.synchronizer.start();
 		this.manager.start();
@@ -446,6 +455,10 @@ var DocumentSession = class {
 		const doc = this.manager.connectDoc(this.docId);
 		this.disposables.add(() => this.manager.disconnectDoc(this.docId));
 		if (this.options.peerId != null) doc.setPeerId(this.options.peerId);
+		this.disposables.add(this.manager.onLocalUpdateReceived(this.docId, (update) => {
+			this.trackLocalVersion(decodeImportBlobMeta(update, true).partialEndVersionVector);
+			this.emitSyncState();
+		}));
 		this.disposables.add(this.manager.onDocStateChange(this.docId, (state) => {
 			this.events.emit("state", state);
 			this.emitSyncState();
@@ -455,7 +468,7 @@ var DocumentSession = class {
 		this.adapterValue = this.model(doc, this.mutationGuard);
 		this.disposables.add(this.adapterValue.subscribe((source) => {
 			if (!this.adapterValue) return;
-			if (source === "local") this.localVersionValue = doc.version();
+			if (source === "local") this.trackLocalVersion(doc.version());
 			this.emitSyncState();
 			this.events.emit("update", {
 				source,
@@ -470,9 +483,39 @@ var DocumentSession = class {
 		this.undoManagerValue = new DocumentUndoManager(doc, this.mutationGuard, () => this.events.emit("undoState"));
 		this.editorValue = this.adapterValue.editor;
 		this.initialVersionValue = doc.version();
+		if (this.localVersionValue) this.trackLocalVersion(this.initialVersionValue);
 		this.emitSyncState();
 		return this.snapshot();
 	}
+	getLocalSaveState() {
+		return this.getState().localSave;
+	}
+	/** Immediately reports local transaction state; independent of server confirmation. */
+	subscribeLocalSaveState(cb) {
+		const off = this.events.on("state", () => cb(this.getLocalSaveState()));
+		cb(this.getLocalSaveState());
+		return off;
+	}
+	/** Waits until all local saves finish, including edits made while waiting. Does not wait for the network. */
+	async waitForLocalSave(options = {}) {
+		if (!this.editorValue || this.destroyed) throw new Error("mengine doc session is not started");
+		await this.manager.waitForLocalSave(this.docId).timeout(options.timeoutMs ?? 15e3);
+	}
+	/** Stop accepting edits and drain local persistence before releasing resources.
+	* A failed local write keeps retrying, even after the host has unmounted.
+	* Hosts should use this for normal teardown; destroy() is immediate cancellation. */
+	close() {
+		if (this.closeTask) return this.closeTask;
+		if (this.destroyed || !this.editorValue) {
+			this.destroy();
+			return Promise.resolve();
+		}
+		this.mutationGuard.close();
+		this.synchronizer.stop();
+		this.server.connection.disconnect();
+		this.closeTask = this.manager.waitForLocalSave(this.docId).then(() => this.destroy());
+		return this.closeTask;
+	}
 	getSyncState() {
 		const state = this.getState();
 		const target = this.confirmationTarget();
@@ -483,6 +526,14 @@ var DocumentSession = class {
 			phase: connection === "disconnected" ? "offline" : this.pushErrorValue != null || state.error != null ? "failed" : connection === "connecting" ? "connecting" : state.syncing ? "syncing" : "idle"
 		};
 	}
+	trackLocalVersion(version) {
+		const target = VersionVector.parseJSON(this.confirmationTarget()?.toJSON() ?? /* @__PURE__ */ new Map());
+		for (const [peer, counter] of version.toJSON()) if ((target.get(peer) ?? 0) < counter) target.setEnd({
+			peer,
+			counter
+		});
+		this.localVersionValue = target;
+	}
 	confirmationTarget() {
 		return this.localVersionValue ?? this.initialVersionValue;
 	}
@@ -573,6 +624,7 @@ function serverCovers(serverVV, target) {
 //#region src/session/mengine-doc-session.ts
 /** Default collaborative session: one DSL handle and one editor over the synchronized LoroDoc. */
 var MengineDocSession = class extends DocumentSession {
+	/** `uploadText` stores raw content the editor writes, such as a PhoneticScript's text, in Memota. */
 	constructor(options) {
 		super(options, (doc, guard) => {
 			assertDslDocument(doc);
@@ -580,7 +632,7 @@ var MengineDocSession = class extends DocumentSession {
 			return {
 				doc,
 				document: dsl,
-				editor: new DslEditor(dsl),
+				editor: new DslEditor(dsl, void 0, options.uploadText),
 				snapshot: () => dsl.getSnapshot(),
 				subscribe: (listener) => dsl.subscribe(listener),
 				dispose: () => dsl.dispose()
@@ -593,6 +645,10 @@ var MengineDocSession = class extends DocumentSession {
 	projectVideoDraft() {
 		return toVideoDraft(this.snapshot());
 	}
+	/** The document's AudioScripts with what says and shows them; read from the same snapshot as the VideoDraft. */
+	projectAudioScripts() {
+		return toAudioScriptViews(this.snapshot());
+	}
 };
 //#endregion
-export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, ManualSyncDoc, MedeoDsl, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, UnsupportedDocumentFormatError, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+export { DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, ManualSyncDoc, MedeoDsl, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, UnsupportedDocumentFormatError, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/legacy.d.ts

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

package/dist/legacy.js

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

package/dist/testing.d.ts

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

package/dist/testing.js

@@ -1,6 +1,6 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
-import { a as documentFormat, i as assertDslDocument } from "./video-draft-types-TXRv3wS6.js";
-import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, r as createInitialMedeoDsl } from "./dsl-EV6kCdr6.js";
+import { a as documentFormat, i as assertDslDocument } from "./video-draft-types-BnbfWrBx.js";
+import { i as DslEditor, n as toVideoDraft, o as MedeoDsl, r as createInitialMedeoDsl } from "./dsl-Co3RI5F1.js";
 import { t as classifyUpdate } from "./loro-relay-doc-Bi6JKqtQ.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts
@@ -450,7 +450,7 @@ function createTestDsl(options = {}) {
 			durationMs: 1e3,
 			storageKey: "speech.mp3"
 		},
-		script: { body: "hello" },
+		script: { segments: ["hello"] },
 		volume: 1,
 		voice: {
 			system: "voice-library",
@@ -466,10 +466,7 @@ function createTestDsl(options = {}) {
 			clipId: "caption",
 			startMs: 0,
 			durationMs: 1e3,
-			range: {
-				start: 0,
-				end: 5
-			},
+			segment: 0,
 			style: {}
 		}]
 	});