@mengine/medeo-client 3.1.0 → 3.1.1-dsl.0

package/dist/dsl.d.ts

@@ -1,2 +1,2 @@
-import { $ as MoveDslClipsInput, A as ApplyVoiceoverInput, At as RelationTable, B as InvalidAtomic, Bt as TextRun, C as DslClipLayout, Ct as EntityTable, D as createInitialMedeoDsl, Dt as MedeoDslSnapshot, E as DslTrackLayout, Et as FieldPatch, F as DslAudit, Ft as StoredFile, G as MedeoDslLoroState, H as isInvalidAtomic, Ht as Track, I as DslTransaction, It as TextDelta, J as OpActor, K as medeoDslLoroShape, L as UnsupportedDocumentFormatError, Lt as TextEdit, M as VoiceoverResult, Mt as RelationValues, N as CreateMedeoDslOptions, Nt as ResourceSystem, O as DslEditor, Ot as Media, P as MedeoDsl, Pt as RichTextSnapshot, Q as DslClipUpdate, R as assertDslDocument, Rt as TextMark, S as resolveDslLayout, St as EntityMutation, T as DslProjectionError, Tt as EntityValues, U as timeAnchorCodec, Ut as TrackRole, V as captionContentCodec, Vt as TimeAnchor, W as MedeoDslDraft, Wt as Voice, X as AddDslClipsInput, Y as AddDslClip, Z as ClipSource, _ as VideoDraftInput, _t as ContainMutation, a as fromVideoDraft, at as EntityIdKind, b as VideoDraftTrack, bt as DslDiagnostic, c as VideoDraftProjection, ct as resourceId, d as DEFAULT_UNIT_TIME_MS, dt as Caption, et as ReplaceDslClipsInput, f as VideoCreationSettings, ft as CaptionContent, g as VideoDraftContentPartUnion, gt as Clip, h as VideoDraftContent, ht as CaptionText, i as ImportedVideoDraft, it as DslIdFactory, j as VoiceoverCaptionInput, jt as RelationTables, k as UploadText, kt as RelationMutation, l as toVideoDraft, lt as tupleHash, m as VideoDraftCaptionStyle, mt as CaptionStyle, n as normalizeLegacyVideoDraft, nt as BLANK_PLACEHOLDER, o as AudioScriptView, ot as defaultIdFactory, p as VideoDraft, pt as CaptionSelection, q as CommitOptions, r as FromVideoDraftOptions, rt as missingMediaPlaceholder, s as toAudioScriptViews, st as relationId, t as NormalizedLegacyVideoDraft, tt as ClipPlacement, u as CaptionDisplayCue, ut as AudioScript, v as VideoDraftPartUnion, vt as ContainNode, w as DslLayout, wt as EntityTables, x as VideoDraftTrackItem, xt as DslMutation, y as VideoDraftTimeline, yt as DeepReadonly, z as documentFormat, zt as TextMutation } from "./index-BOPcHqIj.js";
-export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, BLANK_PLACEHOLDER, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, type Media, type MoveDslClipsInput, type NormalizedLegacyVideoDraft, type OpActor, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type StoredFile, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type UploadText, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, missingMediaPlaceholder, normalizeLegacyVideoDraft, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };
+import { $ as ClipSource, A as DslEditor, At as Media, B as assertDslDocument, Bt as TextMark, C as VideoDraftTrackItem, Ct as DslMutation, D as DslProjectionError, Dt as EntityValues, E as DslLayout, Et as EntityTables, F as CreateMedeoDslOptions, Ft as ResourceSystem, G as timeAnchorCodec, Gt as TrackRole, H as InvalidAtomic, Ht as TextRun, I as MedeoDsl, It as RichTextSnapshot, J as medeoDslLoroShape, K as MedeoDslDraft, Kt as Voice, L as DslAudit, Lt as StoredFile, M as ApplyVoiceoverInput, Mt as RelationTable, N as VoiceoverCaptionInput, Nt as RelationTables, O as DslTrackLayout, Ot as FieldPatch, P as VoiceoverResult, Pt as RelationValues, Q as AddDslClipsInput, R as DslTransaction, Rt as TextDelta, S as VideoDraftTrack, St as DslDiagnostic, T as DslClipLayout, Tt as EntityTable, U as captionContentCodec, Ut as TimeAnchor, V as documentFormat, Vt as TextMutation, W as isInvalidAtomic, Wt as Track, X as OpActor, Y as CommitOptions, Z as AddDslClip, _ as VideoDraftContent, _t as CaptionText, a as fromVideoDraft, at as missingMediaPlaceholder, b as VideoDraftPartUnion, bt as ContainNode, c as spokenScripts, ct as defaultIdFactory, d as toVideoDraft, dt as tupleHash, et as DslClipUpdate, f as CaptionDisplayCue, ft as AudioScript, g as VideoDraftCaptionStyle, gt as CaptionStyle, h as VideoDraft, ht as CaptionSelection, i as ImportedVideoDraft, it as BLANK_PLACEHOLDER, j as UploadText, jt as RelationMutation, k as createInitialMedeoDsl, kt as MedeoDslSnapshot, l as toAudioScriptViews, lt as relationId, m as VideoCreationSettings, mt as CaptionContent, n as normalizeLegacyVideoDraft, nt as ReplaceDslClipsInput, o as AudioScriptView, ot as DslIdFactory, p as DEFAULT_UNIT_TIME_MS, pt as Caption, q as MedeoDslLoroState, r as FromVideoDraftOptions, rt as ClipPlacement, s as SpokenScript, st as EntityIdKind, t as NormalizedLegacyVideoDraft, tt as MoveDslClipsInput, u as VideoDraftProjection, ut as resourceId, v as VideoDraftContentPartUnion, vt as Clip, w as resolveDslLayout, wt as EntityMutation, x as VideoDraftTimeline, xt as DeepReadonly, y as VideoDraftInput, yt as ContainMutation, z as UnsupportedDocumentFormatError, zt as TextEdit } from "./index-CQ8h3u9S.js";
+export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, BLANK_PLACEHOLDER, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, type Media, type MoveDslClipsInput, type NormalizedLegacyVideoDraft, type OpActor, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type SpokenScript, type StoredFile, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type UploadText, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, missingMediaPlaceholder, normalizeLegacyVideoDraft, relationId, resolveDslLayout, resourceId, spokenScripts, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/dsl.js

@@ -1,2 +1,2 @@
-import { C as tupleHash, S as resourceId, _ as DslProjectionError, a as createInitialMedeoDsl, b as defaultIdFactory, c as MedeoDsl, d as documentFormat, f as medeoDslLoroShape, g as resolveDslLayout, h as timeAnchorCodec, i as DEFAULT_UNIT_TIME_MS, l as UnsupportedDocumentFormatError, m as isInvalidAtomic, n as fromVideoDraft, o as DslEditor, p as captionContentCodec, r as toVideoDraft, s as toAudioScriptViews, t as normalizeLegacyVideoDraft, u as assertDslDocument, v as BLANK_PLACEHOLDER, x as relationId, y as missingMediaPlaceholder } from "./dsl-C0-G8JVT.js";
-export { BLANK_PLACEHOLDER, DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, MedeoDsl, UnsupportedDocumentFormatError, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, missingMediaPlaceholder, normalizeLegacyVideoDraft, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };
+import { C as relationId, S as defaultIdFactory, T as tupleHash, _ as timeAnchorCodec, a as createInitialMedeoDsl, b as BLANK_PLACEHOLDER, c as toAudioScriptViews, d as assertDslDocument, g as isInvalidAtomic, h as captionContentCodec, i as DEFAULT_UNIT_TIME_MS, l as MedeoDsl, m as medeoDslLoroShape, n as fromVideoDraft, o as DslEditor, p as documentFormat, r as toVideoDraft, s as spokenScripts, t as normalizeLegacyVideoDraft, u as UnsupportedDocumentFormatError, v as resolveDslLayout, w as resourceId, x as missingMediaPlaceholder, y as DslProjectionError } from "./dsl-Xm5NW58k.js";
+export { BLANK_PLACEHOLDER, DEFAULT_UNIT_TIME_MS, DslEditor, DslProjectionError, MedeoDsl, UnsupportedDocumentFormatError, assertDslDocument, captionContentCodec, createInitialMedeoDsl, defaultIdFactory, documentFormat, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, missingMediaPlaceholder, normalizeLegacyVideoDraft, relationId, resolveDslLayout, resourceId, spokenScripts, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/{index-BOPcHqIj.d.ts → index-CQ8h3u9S.d.ts}

@@ -342,7 +342,7 @@ declare const defaultIdFactory: DslIdFactory;
 //#region ../medeo-dsl/src/fields.d.ts
 /**
  * A placeholder medium is an Image with no file, standing in where a legacy VideoDraft placed a
- * visual clip the old editor drew as a blank (D196). The blank one stands in for a clip placed
+ * visual clip the old editor drew as a blank (D205). The blank one stands in for a clip placed
  * without media (`origin_media_id: ''`); one keyed by a memota media id stands in for media the
  * clip named but Director found missing, so the id survives. Importing keeps the clips' time on
  * them instead of dropping them. Only migration authors them.
@@ -849,20 +849,12 @@ declare const medeoDslLoroShape: RootSchemaType<{
     options: {};
   };
   'phonetic-script-entities': LoroMapSchemaWithCatchall<{}, LoroMapSchema<{
-    phoneme: /*elided*/any;
-    system: /*elided*/any;
-    key: /*elided*/any;
-    storageKey: /*elided*/any;
-    digest: /*elided*/any;
+    binding: /*elided*/any;
   }> & {
     options: {};
   } & {
     catchall: <C extends SchemaType>(catchallSchema: C) => LoroMapSchemaWithCatchall<{
-      phoneme: /*elided*/any;
-      system: /*elided*/any;
-      key: /*elided*/any;
-      storageKey: /*elided*/any;
-      digest: /*elided*/any;
+      binding: /*elided*/any;
     }, C>;
   }> & {
     options: {};
@@ -955,8 +947,9 @@ type ContainDraftNode = Omit<Input['contain-relations'][number], 'id' | 'childre
   children: ContainDraftNode[];
 };
 type DraftFields<T> = T extends Cursor ? T : T extends (infer Item)[] ? DraftFields<Item>[] : T extends object ? { [K in keyof T as undefined extends T[K] ? never : K]: DraftFields<T[K]> } & { [K in keyof T as undefined extends T[K] ? K : never]?: DraftFields<T[K]> } : T;
-type MedeoDslDraft = DraftFields<Omit<Input, 'contain-relations'>> & {
+type MedeoDslDraft = DraftFields<Omit<Input, 'contain-relations' | 'phonetic-script-entities'>> & {
   'contain-relations': ContainDraftNode[];
+  'phonetic-script-entities': Record<string, PhoneticScript>;
 };
 //#endregion
 //#region ../medeo-dsl/src/schema/codec.d.ts
@@ -980,7 +973,7 @@ declare const captionContentCodec: AtomicCodec<SegmentSelection>;
 declare function documentFormat(doc: LoroDoc): 'dsl' | 'legacy' | 'mixed' | 'unknown';
 declare class UnsupportedDocumentFormatError extends Error {
   readonly code = "unsupported_document_format";
-  constructor();
+  constructor(message?: string);
 }
 /** Run after initial import, before opening an editable handle. Empty new documents still have one Timeline. */
 declare function assertDslDocument(doc: LoroDoc): void;
@@ -1057,6 +1050,8 @@ declare class MedeoDsl {
   applyMutations(mutations: readonly DslMutation[], audit: DslAudit): void;
   editText(scriptId: string, segmentId: string, expectedBodyId: string, edits: readonly TextEdit[], audit: DslAudit): void;
   editCaptionText(captionId: string, expectedBodyId: string, edits: readonly TextEdit[], audit: DslAudit): void;
+  /** Check the session's write capability before an Action starts host-owned resource I/O. */
+  assertWritable(): void;
   /**
    * A run inside one segment as native Cursors. Local ranges exclude insertions at their start and
    * include insertions at their end. K01 remains deferred.
@@ -1064,6 +1059,7 @@ declare class MedeoDsl {
   textRange(scriptId: string, segmentId: string, start: number, end: number): SegmentSelection;
   dispose(): void;
   private mutate;
+  private assertReadyToWrite;
   private notify;
   private assertActive;
 }
@@ -1092,9 +1088,9 @@ interface ApplyVoiceoverInput {
     kind: 'voiceover-recording';
   };
   /**
-   * What the recording says: an existing AudioScript, a new one of these `segments`, or a
-   * PhoneticScript it was spoken from. A recording spoken from a PhoneticScript is derived-from it,
-   * and its captions select segments of that variant's base script.
+   * What the recording says: a PhoneticScript it was spoken from, or plain words from an existing
+   * or new AudioScript. Plain words get selection-only PhoneticScripts (D190), one per segment;
+   * no control content, file or digest is invented. Captions keep selecting the base script.
    */
   script: {
     audioScriptId: string;
@@ -1801,6 +1797,13 @@ interface VideoDraftProjection {
 declare function toVideoDraft(snapshot: MedeoDslSnapshot): VideoDraftProjection;
 //#endregion
 //#region src/dsl/projection/audio-scripts.d.ts
+/** The script a recording says and its phonetic origins; old direct script origins remain readable. */
+interface SpokenScript {
+  audioScriptId: string;
+  phoneticScriptId?: string;
+  /** Several plain selections of the same script; the singular summary is omitted. */
+  phoneticScriptIds?: string[];
+}
 /**
  * An AudioScript with everything that says or shows it, read from the same snapshot as the
  * VideoDraft. Speeches and captions come in playback order.
@@ -1836,8 +1839,9 @@ interface AudioScriptView {
   /** Speech Clips playing a recording of these words. */
   speeches: {
     clipId: string;
-    recordingId: string; /** The PhoneticScript the recording was spoken from; absent when it derives from the script directly. */
-    phoneticScriptId?: string;
+    recordingId: string; /** Its single phonetic origin; omitted for multiple origins or an old direct script origin. */
+    phoneticScriptId?: string; /** Multiple segment selections used by one recording, without duplicating its Clip. */
+    phoneticScriptIds?: string[];
     voices: {
       voiceId: string;
       key: string;
@@ -1856,6 +1860,12 @@ interface AudioScriptView {
     segment: number;
   }[];
 }
+/**
+ * The scripts a recording says. It follows derived-from from the recording; a PhoneticScript is a
+ * variant, so its words are the base its phoneme names, and derived-from is not followed past it.
+ * When nothing is found that way, a script read off the recording itself is what it says.
+ */
+declare function spokenScripts(snapshot: MedeoDslSnapshot, recordingId: string): SpokenScript[];
 /** Every AudioScript in the document with its PhoneticScripts, the Speech Clips saying it and the Caption Clips showing it. */
 declare function toAudioScriptViews(snapshot: MedeoDslSnapshot): AudioScriptView[];
 //#endregion
@@ -1880,4 +1890,4 @@ interface NormalizedLegacyVideoDraft {
 }
 declare function normalizeLegacyVideoDraft(input: VideoDraftInput, mediaFacts?: readonly Media[]): NormalizedLegacyVideoDraft;
 //#endregion
-export { MoveDslClipsInput as $, ApplyVoiceoverInput as A, RelationTable as At, InvalidAtomic as B, TextRun as Bt, DslClipLayout as C, EntityTable as Ct, createInitialMedeoDsl as D, MedeoDslSnapshot as Dt, DslTrackLayout as E, FieldPatch as Et, DslAudit as F, StoredFile as Ft, MedeoDslLoroState as G, isInvalidAtomic as H, Track$1 as Ht, DslTransaction as I, TextDelta as It, OpActor as J, medeoDslLoroShape as K, UnsupportedDocumentFormatError as L, TextEdit as Lt, VoiceoverResult as M, RelationValues as Mt, CreateMedeoDslOptions as N, ResourceSystem as Nt, DslEditor as O, Media as Ot, MedeoDsl as P, RichTextSnapshot as Pt, DslClipUpdate as Q, assertDslDocument as R, TextMark as Rt, resolveDslLayout as S, EntityMutation as St, DslProjectionError as T, EntityValues as Tt, timeAnchorCodec as U, TrackRole as Ut, captionContentCodec as V, TimeAnchor as Vt, MedeoDslDraft as W, Voice as Wt, AddDslClipsInput as X, AddDslClip as Y, ClipSource as Z, VideoDraftInput as _, ContainMutation as _t, fromVideoDraft as a, EntityIdKind as at, VideoDraftTrack as b, DslDiagnostic as bt, VideoDraftProjection as c, resourceId as ct, DEFAULT_UNIT_TIME_MS as d, Caption as dt, ReplaceDslClipsInput as et, VideoCreationSettings as f, CaptionContent as ft, VideoDraftContentPartUnion as g, Clip as gt, VideoDraftContent as h, CaptionText as ht, ImportedVideoDraft as i, DslIdFactory as it, VoiceoverCaptionInput as j, RelationTables as jt, UploadText as k, RelationMutation as kt, toVideoDraft as l, tupleHash as lt, VideoDraftCaptionStyle as m, CaptionStyle$1 as mt, normalizeLegacyVideoDraft as n, BLANK_PLACEHOLDER as nt, AudioScriptView as o, defaultIdFactory as ot, VideoDraft as p, CaptionSelection as pt, CommitOptions as q, FromVideoDraftOptions as r, missingMediaPlaceholder as rt, toAudioScriptViews as s, relationId as st, NormalizedLegacyVideoDraft as t, ClipPlacement as tt, CaptionDisplayCue as u, AudioScript as ut, VideoDraftPartUnion as v, ContainNode as vt, DslLayout as w, EntityTables as wt, VideoDraftTrackItem as x, DslMutation as xt, VideoDraftTimeline as y, DeepReadonly as yt, documentFormat as z, TextMutation as zt };
+export { ClipSource as $, DslEditor as A, Media as At, assertDslDocument as B, TextMark as Bt, VideoDraftTrackItem as C, DslMutation as Ct, DslProjectionError as D, EntityValues as Dt, DslLayout as E, EntityTables as Et, CreateMedeoDslOptions as F, ResourceSystem as Ft, timeAnchorCodec as G, TrackRole as Gt, InvalidAtomic as H, TextRun as Ht, MedeoDsl as I, RichTextSnapshot as It, medeoDslLoroShape as J, MedeoDslDraft as K, Voice as Kt, DslAudit as L, StoredFile as Lt, ApplyVoiceoverInput as M, RelationTable as Mt, VoiceoverCaptionInput as N, RelationTables as Nt, DslTrackLayout as O, FieldPatch as Ot, VoiceoverResult as P, RelationValues as Pt, AddDslClipsInput as Q, DslTransaction as R, TextDelta as Rt, VideoDraftTrack as S, DslDiagnostic as St, DslClipLayout as T, EntityTable as Tt, captionContentCodec as U, TimeAnchor as Ut, documentFormat as V, TextMutation as Vt, isInvalidAtomic as W, Track$1 as Wt, OpActor as X, CommitOptions as Y, AddDslClip as Z, VideoDraftContent as _, CaptionText as _t, fromVideoDraft as a, missingMediaPlaceholder as at, VideoDraftPartUnion as b, ContainNode as bt, spokenScripts as c, defaultIdFactory as ct, toVideoDraft as d, tupleHash as dt, DslClipUpdate as et, CaptionDisplayCue as f, AudioScript as ft, VideoDraftCaptionStyle as g, CaptionStyle$1 as gt, VideoDraft as h, CaptionSelection as ht, ImportedVideoDraft as i, BLANK_PLACEHOLDER as it, UploadText as j, RelationMutation as jt, createInitialMedeoDsl as k, MedeoDslSnapshot as kt, toAudioScriptViews as l, relationId as lt, VideoCreationSettings as m, CaptionContent as mt, normalizeLegacyVideoDraft as n, ReplaceDslClipsInput as nt, AudioScriptView as o, DslIdFactory as ot, DEFAULT_UNIT_TIME_MS as p, Caption as pt, MedeoDslLoroState as q, FromVideoDraftOptions as r, ClipPlacement as rt, SpokenScript as s, EntityIdKind as st, NormalizedLegacyVideoDraft as t, MoveDslClipsInput as tt, VideoDraftProjection as u, resourceId as ut, VideoDraftContentPartUnion as v, Clip as vt, resolveDslLayout as w, EntityMutation as wt, VideoDraftTimeline as x, DeepReadonly as xt, VideoDraftInput as y, ContainMutation as yt, UnsupportedDocumentFormatError as z, TextEdit as zt };

package/dist/{index-C_wwGt5k.d.ts → index-D48u9I25.d.ts}

@@ -1,4 +1,4 @@
-import { Dt as MedeoDslSnapshot, Nt as ResourceSystem, O as DslEditor, P as MedeoDsl, Ut as TrackRole, bt as DslDiagnostic, c as VideoDraftProjection, h as VideoDraftContent, k as UploadText, o as AudioScriptView, q as CommitOptions } from "./index-BOPcHqIj.js";
+import { A as DslEditor, Ft as ResourceSystem, Gt as TrackRole, I as MedeoDsl, St as DslDiagnostic, Y as CommitOptions, _ as VideoDraftContent, j as UploadText, kt as MedeoDslSnapshot, o as AudioScriptView, u as VideoDraftProjection } from "./index-CQ8h3u9S.js";
 import { LoroDoc, PeerID, VersionVector } from "loro-crdt";
 import { DocState, LocalSaveState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -255,7 +255,7 @@ type PushResultKind = 'ack' | 'duplicate' | 'rejected' | 'failed' | 'nothing_to_
  */
 interface PushResult {
   kind: PushResultKind;
-  /** Server document sequence observed after a successful `ack` or `duplicate`. */
+  /** Server sequence from an `ack`/`duplicate`, retained on an idle retry so its revision can be verified. */
   mengineUpdateSeq?: number | undefined;
   /** @deprecated Ack-only sequence retained until consumers adopt `mengineUpdateSeq`. */
   updateSeq?: number | undefined;
@@ -301,10 +301,12 @@ interface ManualSyncDocOptions {
 }
 /** Shared explicit pull/push lifecycle; model-specific editors never implement transport. */
 declare class ManualSyncTransport {
-  private readonly client;
+  protected readonly client: MengineHttpClient;
   protected readonly doc: LoroDoc;
   private watermark;
   private disposed;
+  /** A retry with no new bytes still verifies the revision from its last durable receipt. */
+  private confirmedSequence?;
   protected constructor(client: MengineHttpClient, doc: LoroDoc, watermark: VersionVector);
   editorPeerId(): PeerID;
   protected assertActive(): void;
@@ -538,6 +540,8 @@ declare class ManualSyncDoc extends ManualSyncTransport {
     }[];
   };
   projectVideoDraft(): VideoDraftProjection;
+  /** Read the acknowledged server revision; without a new push, confirm against the current server view. */
+  readPersistedDraft(updateSeq?: number): Promise<MengineDraftResponse>;
   dispose(): void;
 }
 //#endregion

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-import { $ as MoveDslClipsInput, A as ApplyVoiceoverInput, At as RelationTable, B as InvalidAtomic, Bt as TextRun, C as DslClipLayout, Ct as EntityTable, D as createInitialMedeoDsl, Dt as MedeoDslSnapshot, E as DslTrackLayout, Et as FieldPatch, F as DslAudit, Ft as StoredFile, G as MedeoDslLoroState, H as isInvalidAtomic, Ht as Track, I as DslTransaction, It as TextDelta, J as OpActor, K as medeoDslLoroShape, L as UnsupportedDocumentFormatError, Lt as TextEdit, M as VoiceoverResult, Mt as RelationValues, N as CreateMedeoDslOptions, Nt as ResourceSystem, O as DslEditor, Ot as Media, P as MedeoDsl, Pt as RichTextSnapshot, Q as DslClipUpdate, R as assertDslDocument, Rt as TextMark, S as resolveDslLayout, St as EntityMutation, T as DslProjectionError, Tt as EntityValues, U as timeAnchorCodec, Ut as TrackRole, V as captionContentCodec, Vt as TimeAnchor, W as MedeoDslDraft, Wt as Voice, X as AddDslClipsInput, Y as AddDslClip, Z as ClipSource, _ as VideoDraftInput, _t as ContainMutation, a as fromVideoDraft, at as EntityIdKind, b as VideoDraftTrack, bt as DslDiagnostic, c as VideoDraftProjection, ct as resourceId, d as DEFAULT_UNIT_TIME_MS, dt as Caption, et as ReplaceDslClipsInput, f as VideoCreationSettings, ft as CaptionContent, g as VideoDraftContentPartUnion, gt as Clip, h as VideoDraftContent, ht as CaptionText, i as ImportedVideoDraft, it as DslIdFactory, j as VoiceoverCaptionInput, jt as RelationTables, k as UploadText, kt as RelationMutation, l as toVideoDraft, lt as tupleHash, m as VideoDraftCaptionStyle, mt as CaptionStyle, n as normalizeLegacyVideoDraft, nt as BLANK_PLACEHOLDER, o as AudioScriptView, ot as defaultIdFactory, p as VideoDraft, pt as CaptionSelection, q as CommitOptions, r as FromVideoDraftOptions, rt as missingMediaPlaceholder, s as toAudioScriptViews, st as relationId, t as NormalizedLegacyVideoDraft, tt as ClipPlacement, u as CaptionDisplayCue, ut as AudioScript, v as VideoDraftPartUnion, vt as ContainNode, w as DslLayout, wt as EntityTables, x as VideoDraftTrackItem, xt as DslMutation, y as VideoDraftTimeline, yt as DeepReadonly, z as documentFormat, zt as TextMutation } from "./index-BOPcHqIj.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 ManualSyncDocOptions, a as MengineDocSessionOptions, b as DocVersionMark, c as WaitForLocalSaveOptions, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDoc, h as PushOutcomeKind, i as MengineAckFailedError, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, n as MengineDocSession, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, r as MengineDocSessionUpdateEvent, 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-C_wwGt5k.js";
-export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, BLANK_PLACEHOLDER, 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 NormalizedLegacyVideoDraft, 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, missingMediaPlaceholder, normalizeLegacyVideoDraft, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };
+import { $ as ClipSource, A as DslEditor, At as Media, B as assertDslDocument, Bt as TextMark, C as VideoDraftTrackItem, Ct as DslMutation, D as DslProjectionError, Dt as EntityValues, E as DslLayout, Et as EntityTables, F as CreateMedeoDslOptions, Ft as ResourceSystem, G as timeAnchorCodec, Gt as TrackRole, H as InvalidAtomic, Ht as TextRun, I as MedeoDsl, It as RichTextSnapshot, J as medeoDslLoroShape, K as MedeoDslDraft, Kt as Voice, L as DslAudit, Lt as StoredFile, M as ApplyVoiceoverInput, Mt as RelationTable, N as VoiceoverCaptionInput, Nt as RelationTables, O as DslTrackLayout, Ot as FieldPatch, P as VoiceoverResult, Pt as RelationValues, Q as AddDslClipsInput, R as DslTransaction, Rt as TextDelta, S as VideoDraftTrack, St as DslDiagnostic, T as DslClipLayout, Tt as EntityTable, U as captionContentCodec, Ut as TimeAnchor, V as documentFormat, Vt as TextMutation, W as isInvalidAtomic, Wt as Track, X as OpActor, Y as CommitOptions, Z as AddDslClip, _ as VideoDraftContent, _t as CaptionText, a as fromVideoDraft, at as missingMediaPlaceholder, b as VideoDraftPartUnion, bt as ContainNode, c as spokenScripts, ct as defaultIdFactory, d as toVideoDraft, dt as tupleHash, et as DslClipUpdate, f as CaptionDisplayCue, ft as AudioScript, g as VideoDraftCaptionStyle, gt as CaptionStyle, h as VideoDraft, ht as CaptionSelection, i as ImportedVideoDraft, it as BLANK_PLACEHOLDER, j as UploadText, jt as RelationMutation, k as createInitialMedeoDsl, kt as MedeoDslSnapshot, l as toAudioScriptViews, lt as relationId, m as VideoCreationSettings, mt as CaptionContent, n as normalizeLegacyVideoDraft, nt as ReplaceDslClipsInput, o as AudioScriptView, ot as DslIdFactory, p as DEFAULT_UNIT_TIME_MS, pt as Caption, q as MedeoDslLoroState, r as FromVideoDraftOptions, rt as ClipPlacement, s as SpokenScript, st as EntityIdKind, t as NormalizedLegacyVideoDraft, tt as MoveDslClipsInput, u as VideoDraftProjection, ut as resourceId, v as VideoDraftContentPartUnion, vt as Clip, w as resolveDslLayout, wt as EntityMutation, x as VideoDraftTimeline, xt as DeepReadonly, y as VideoDraftInput, yt as ContainMutation, z as UnsupportedDocumentFormatError, zt as TextEdit } from "./index-CQ8h3u9S.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 ManualSyncDocOptions, a as MengineDocSessionOptions, b as DocVersionMark, c as WaitForLocalSaveOptions, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDoc, h as PushOutcomeKind, i as MengineAckFailedError, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, n as MengineDocSession, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, r as MengineDocSessionUpdateEvent, 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-D48u9I25.js";
+export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type AudioScript, type AudioScriptView, BLANK_PLACEHOLDER, 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 NormalizedLegacyVideoDraft, 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 SpokenScript, 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, missingMediaPlaceholder, normalizeLegacyVideoDraft, readMengineEventStream, relationId, resolveDslLayout, resourceId, spokenScripts, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
-import { C as tupleHash, S as resourceId, _ as DslProjectionError, a as createInitialMedeoDsl, b as defaultIdFactory, c as MedeoDsl, d as documentFormat, f as medeoDslLoroShape, g as resolveDslLayout, h as timeAnchorCodec, i as DEFAULT_UNIT_TIME_MS, l as UnsupportedDocumentFormatError, m as isInvalidAtomic, n as fromVideoDraft, o as DslEditor, p as captionContentCodec, r as toVideoDraft, s as toAudioScriptViews, t as normalizeLegacyVideoDraft, u as assertDslDocument, v as BLANK_PLACEHOLDER, x as relationId, y as missingMediaPlaceholder } from "./dsl-C0-G8JVT.js";
+import { C as relationId, S as defaultIdFactory, T as tupleHash, _ as timeAnchorCodec, a as createInitialMedeoDsl, b as BLANK_PLACEHOLDER, c as toAudioScriptViews, d as assertDslDocument, g as isInvalidAtomic, h as captionContentCodec, i as DEFAULT_UNIT_TIME_MS, l as MedeoDsl, m as medeoDslLoroShape, n as fromVideoDraft, o as DslEditor, p as documentFormat, r as toVideoDraft, s as spokenScripts, t as normalizeLegacyVideoDraft, u as UnsupportedDocumentFormatError, v as resolveDslLayout, w as resourceId, x as missingMediaPlaceholder, y as DslProjectionError } from "./dsl-Xm5NW58k.js";
 import { LoroDoc, UndoManager, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
 import { DisposableSet, EventBus, Task } from "@mengine/utils";
@@ -295,6 +295,8 @@ var ManualSyncTransport = class {
 	doc;
 	watermark;
 	disposed = false;
+	/** A retry with no new bytes still verifies the revision from its last durable receipt. */
+	confirmedSequence;
 	constructor(client, doc, watermark) {
 		this.client = client;
 		this.doc = doc;
@@ -397,7 +399,8 @@ var ManualSyncTransport = class {
 		const localVersion = this.doc.oplogVersion();
 		if (covers(this.watermark, localVersion)) return {
 			kind: "nothing_to_push",
-			collaborated: false
+			collaborated: false,
+			...this.confirmedSequence === void 0 ? {} : { mengineUpdateSeq: this.confirmedSequence }
 		};
 		const update = this.doc.export({
 			mode: "update",
@@ -407,6 +410,7 @@ var ManualSyncTransport = class {
 			const response = await this.client.pushUpdate(update);
 			const serverVV = this.serverVVFrom(response.version?.server_vv);
 			if (serverVV != null) this.watermark = serverVV;
+			this.confirmedSequence = response.version?.update_seq ?? response.update_seq ?? void 0;
 			return {
 				kind: response.kind,
 				mengineUpdateSeq: response.version?.update_seq ?? response.update_seq ?? void 0,
@@ -473,6 +477,15 @@ var ManualSyncDoc = class ManualSyncDoc extends ManualSyncTransport {
 	projectVideoDraft() {
 		return toVideoDraft(this.snapshot());
 	}
+	/** Read the acknowledged server revision; without a new push, confirm against the current server view. */
+	async readPersistedDraft(updateSeq) {
+		this.assertActive();
+		const result = updateSeq === void 0 ? await this.client.fetchDraft() : await this.client.fetchDraftAt(updateSeq);
+		this.assertActive();
+		if (updateSeq !== void 0 && result.version.update_seq !== updateSeq) throw new Error("The projected revision does not match the push receipt");
+		if (!covers(VersionVector.decode(base64ToBytes(result.version.server_vv)), this.doc.oplogVersion())) throw new Error("The projected server revision does not hold the local update");
+		return result;
+	}
 	dispose() {
 		this.dsl.dispose();
 		super.dispose();
@@ -1459,4 +1472,4 @@ var MengineDocSession = class extends DocumentSession {
 	}
 };
 //#endregion
-export { BLANK_PLACEHOLDER, 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, missingMediaPlaceholder, normalizeLegacyVideoDraft, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };
+export { BLANK_PLACEHOLDER, 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, missingMediaPlaceholder, normalizeLegacyVideoDraft, readMengineEventStream, relationId, resolveDslLayout, resourceId, spokenScripts, timeAnchorCodec, toAudioScriptViews, toVideoDraft, tupleHash };