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

package/dist/{index-yifEtZSP.d.ts → index-CHiPztZr.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-C5wDKYqC.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-B7fC7q7P.d.ts → index-DAfOkcnZ.d.ts}

@@ -1,6 +1,6 @@
-import { M as DslDiagnostic, o as VideoDraftContent, p as CommitOptions } from "./video-draft-types-c_shaRyq.js";
+import { j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions } from "./video-draft-types-GqXnsOzA.js";
 import { LoroDoc, PeerID, VersionVector } from "loro-crdt";
-import { DocState } from "@mengine/sync";
+import { DocState, LocalSaveState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
 
 //#region src/client/base64.d.ts
@@ -532,13 +532,18 @@ declare class MengineAckFailedError extends Error {
   readonly cause: Error | undefined;
   constructor(reason: 'timeout' | 'rejected' | 'failed', code: string | undefined, cause: Error | undefined, message: string);
 }
+type MengineLocalSaveState = LocalSaveState;
+interface WaitForLocalSaveOptions {
+  /** Only limits waiting, never cancels persistence. */
+  timeoutMs?: number;
+}
 interface WaitForServerAckOptions {
   /** Deadline in ms. Rejects with reason `timeout` when it elapses. */
   timeoutMs?: number;
 }
 /** Document-level confirmation is independent of local operation completion. */
 interface MengineDocSyncState {
-  /** Remote-only imports do not create a new local confirmation obligation. */
+  /** Server-originated imports do not create a new local confirmation obligation. */
   readonly confirmation: 'unknown' | 'pending' | 'confirmed';
   /** Transport/activity phase. Idle does not imply confirmation; failure details
    * remain available through push outcomes and confirmation wait errors. */
@@ -553,6 +558,9 @@ interface MengineDocSessionOptions {
    * Browsers should pass an `IndexedDBDocStorage` for refresh/cross-tab support.
    */
   localStorage?: DocStorageLike;
+  /** A freshly fetched remote snapshot to merge into storage before loading.
+   * Existing local changes are retained; the host owns any online startup gate. */
+  initialSnapshot?: Uint8Array;
   sseReconnectDelayMs?: number;
   /**
    * Keep remote synchronization read-only: pull snapshot/diffs and subscribe to
@@ -587,6 +595,7 @@ declare class DocumentSession<Snapshot, Editor, Document> {
   private started;
   private startTask;
   private destroyed;
+  private closeTask;
   private lifetime;
   private hasConnected;
   private initialVersionValue;
@@ -687,7 +696,17 @@ declare class DocumentSession<Snapshot, Editor, Document> {
    */
   start(): Promise<Snapshot>;
   private open;
+  getLocalSaveState(): MengineLocalSaveState;
+  /** Immediately reports local transaction state; independent of server confirmation. */
+  subscribeLocalSaveState(cb: (state: MengineLocalSaveState) => void): () => void;
+  /** Waits until all local saves finish, including edits made while waiting. Does not wait for the network. */
+  waitForLocalSave(options?: WaitForLocalSaveOptions): Promise<void>;
+  /** 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(): Promise<void>;
   getSyncState(): MengineDocSyncState;
+  private trackLocalVersion;
   private confirmationTarget;
   /** Immediately supplies current state; unsubscribe when the host changes docs. */
   subscribeSyncState(cb: (state: MengineDocSyncState) => void): () => void;
@@ -725,4 +744,4 @@ declare class MemoryDocStorage extends BaseDocStorage {
   private now;
 }
 //#endregion
-export { MengineAuditResponse as A, base64ToBytes as B, MengineEventStreamOptions as C, MengineHttpRequestError as D, MengineHttpClientOptions as E, MengineRejectedResponse as F, MengineSnapshotResponse as I, MengineSseUpdateEvent as L, MengineDraftResponse as M, MenginePushResponse as N, MenginePushRejectedError as O, MenginePushUpdateResponse as P, MengineSyncResponse as R, PushResultKind as S, MengineHttpClient as T, bytesToBase64 as V, encodeDocVersionMark as _, MengineDocSessionOptions as a, PullResult as b, DocStorageLike as c, MedeoHttpDocStorageOptions as d, PushOutcome as f, decodeDocVersionMark as g, ManualSyncTransport as h, MengineAckFailedError as i, MengineDocumentVersion as j, MengineAuditEntry as k, MengineUndoState as l, ManualSyncDocOptions as m, DocumentSession as n, MengineDocSyncState as o, PushOutcomeKind as p, DocumentSessionUpdateEvent as r, WaitForServerAckOptions as s, MemoryDocStorage as t, MedeoHttpDocStorage as u, DocVersionMark as v, readMengineEventStream as w, PushResult as x, PullFailureReason as y, MengineUpdateMeta as z };
+export { MenginePushRejectedError as A, MengineSyncResponse as B, PushResult as C, MengineHttpClient as D, readMengineEventStream as E, MenginePushResponse as F, base64ToBytes as H, MenginePushUpdateResponse as I, MengineRejectedResponse as L, MengineAuditResponse as M, MengineDocumentVersion as N, MengineHttpClientOptions as O, MengineDraftResponse as P, MengineSnapshotResponse as R, PullResult as S, MengineEventStreamOptions as T, bytesToBase64 as U, MengineUpdateMeta as V, ManualSyncTransport as _, MengineDocSessionOptions as a, DocVersionMark as b, WaitForLocalSaveOptions as c, MengineUndoState as d, MedeoHttpDocStorage as f, ManualSyncDocOptions as g, PushOutcomeKind as h, MengineAckFailedError as i, MengineAuditEntry as j, MengineHttpRequestError as k, WaitForServerAckOptions as l, PushOutcome as m, DocumentSession as n, MengineDocSyncState as o, MedeoHttpDocStorageOptions as p, DocumentSessionUpdateEvent as r, MengineLocalSaveState as s, MemoryDocStorage as t, DocStorageLike as u, decodeDocVersionMark as v, PushResultKind as w, PullFailureReason as x, encodeDocVersionMark as y, MengineSseUpdateEvent as z };

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-C5wDKYqC.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-CHiPztZr.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 DslEditor, c as DslProjectionError, i as createInitialMedeoDsl, n as toVideoDraft, o as MedeoDsl, r as toAudioScriptViews, s as resolveDslLayout, t as fromVideoDraft } from "./dsl-COyzz7Fp.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-C5wDKYqC.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 { a as DslEditor, i as createInitialMedeoDsl, n as toVideoDraft, o as MedeoDsl } from "./dsl-COyzz7Fp.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: {}
 		}]
 	});