@mengine/medeo-client 2.0.1-alpha.23 → 2.0.1-alpha.25

package/dist/{index-mGObzOh4.d.ts → index-BYv9FPSS.d.ts}

@@ -738,8 +738,6 @@ type VideoClipPart = Omit<VideoClipPart$1, 'duration_ms'>;
 type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
   media_duration_ms?: number | undefined;
 };
-/** Asset namespace exposed only by the legacy read view; never an authoritative Speech fact. */
-type SpeechOriginAssetSystem = 'memota' | 'memota-speech';
 /**
  * Authoritative caption part. The IDL `CaptionPart` carries `duration_ms` (the
  * effective display length, a derived read-view value); the authoritative store
@@ -888,8 +886,7 @@ type VideoDraftPartUnion = {
 } | {
   video_clip?: never;
   speech: SpeechPart & {
-    duration_ms?: number; /** Absent only on historical drafts created before this read-view discriminator. */
-    origin_asset_system?: SpeechOriginAssetSystem;
+    duration_ms?: number;
   };
   caption?: never;
   bgm?: never;
@@ -937,7 +934,6 @@ type VideoDraftContentPartUnion = {
   video_clip?: never;
   speech: SpeechPart & {
     duration_ms: number | undefined;
-    origin_asset_system?: SpeechOriginAssetSystem;
   };
   caption?: never;
   bgm?: never;
@@ -1288,6 +1284,11 @@ declare function fromVideoDocument(document: VideoDocument, options?: SolveVideo
  */
 declare function buildInitialVideoDocument(): VideoDocument;
 //#endregion
+//#region ../medeo-dsl/src/sandbox.d.ts
+/** Kinds a script can author. */
+type EntityKind = 'timeline' | 'track' | 'clip' | 'sequence-marker' | 'video' | 'audio' | 'voiceover-recording' | 'image' | 'voice' | 'audio-script' | 'phonetic-script' | 'caption';
+type RelationKind = 'contain' | 'marker' | 'clip-anchor' | 'voice-timbre' | 'caption-alignment' | 'derived-from';
+//#endregion
 //#region ../medeo-dsl/src/ids.d.ts
 declare const entityIdBrand: unique symbol;
 declare const relationIdBrand: unique symbol;
@@ -1306,23 +1307,13 @@ type JsonObject = {
 };
 //#endregion
 //#region ../medeo-dsl/src/entities.d.ts
-type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voiceover' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
+type StoredEntityKind = EntityKind | 'asset';
 declare const extensionEntityKindBrand: unique symbol;
 type ExtensionEntityKind = string & {
   readonly [extensionEntityKindBrand]: 'ExtensionEntityKind';
 };
 /** Extensions require explicit branding so removed or reserved domain kinds cannot reappear accidentally. */
-type EntityKind = KnownEntityKind | ExtensionEntityKind;
-interface SequenceRange<Point = unknown> {
-  readonly start: Point;
-  readonly end: Point;
-}
-type SequenceDuration<Span = unknown> = {
-  readonly mode: 'from-source';
-} | {
-  readonly mode: 'fixed';
-  readonly value: Span;
-};
+type AnyEntityKind = StoredEntityKind | ExtensionEntityKind;
 interface ScriptTextSegment {
   readonly segmentId: string;
   readonly text: string;
@@ -1373,8 +1364,8 @@ type CaptionSegmentSelection = JsonObject & {
 };
 //#endregion
 //#region ../medeo-dsl/src/relations.d.ts
-type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'to-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'voice-timbre' | 'audio-script-source' | 'audio-script-marker';
-type RelationKind = KnownRelationKind | (string & {});
+type StoredRelationKind = RelationKind | 'from-asset' | 'to-asset';
+type AnyRelationKind = StoredRelationKind | (string & {});
 type RelationTrace = JsonObject;
 /**
  * Authoritative persisted relation value.
@@ -1383,7 +1374,7 @@ type RelationTrace = JsonObject;
  * storage adapters must preserve the submitted positions; kinds whose
  * semantics are unordered simply do not interpret those positions.
  */
-interface RelationRow<K extends RelationKind = RelationKind, Metadata extends JsonObject = JsonObject> {
+interface RelationRow<K extends AnyRelationKind = AnyRelationKind, Metadata extends JsonObject = JsonObject> {
   readonly relationId: RelationId;
   readonly endpoint0EntityId: EntityId;
   readonly endpoint1EntityId: EntityId;
@@ -1394,7 +1385,7 @@ interface RelationRow<K extends RelationKind = RelationKind, Metadata extends Js
 //#endregion
 //#region ../medeo-dsl/src/rows.d.ts
 /** One persisted first-class entity. Its owned fields live directly in payload. */
-interface EntityRow<K extends EntityKind = EntityKind> {
+interface EntityRow<K extends AnyEntityKind = AnyEntityKind> {
   readonly entityId: EntityId;
   readonly entityKind: K;
   readonly payload: JsonObject;
@@ -1412,26 +1403,12 @@ declare class EntityTimelineProjectionError extends Error {
 }
 //#endregion
 //#region src/document/entity-projection.d.ts
-type EntityTimelineProjectionPart = Exclude<PartUnion, {
-  speech: SpeechPart;
-}> | {
-  video_clip?: never;
-  speech: SpeechPart & {
-    origin_asset_system: SpeechOriginAssetSystem;
-  };
-  caption?: never;
-  bgm?: never;
-};
-/** Ephemeral compatibility document; the origin discriminator is never stored in Loro. */
-type EntityTimelineProjectionDocument = Omit<VideoDocument, 'part_library'> & {
-  part_library: Record<string, EntityTimelineProjectionPart>;
-};
 /**
  * One-way compatibility view over the Entity graph. A legacy part is never
  * consulted as an editing fact. Peer IDs appear only in this derived read
  * contract, reconstructed from relations; they are not stored in payloads.
  */
-declare function projectEntityTimeline(rows: EntityRelationRows): EntityTimelineProjectionDocument;
+declare function projectEntityTimeline(rows: EntityRelationRows): VideoDocument;
 //#endregion
 //#region src/document/entity-timeline-layout.d.ts
 type EntityTimelineTrackRole = 'video_clip' | 'speech' | 'caption' | 'bgm';
@@ -2153,4 +2130,4 @@ declare const videoDocumentSchema: z.ZodObject<{
   }, z.core.$loose>]>>>;
 }, z.core.$loose>;
 //#endregion
-export { DerivedItemPosition as $, assertValidVideoDocument as A, VideoDocument as At, EntityRelationRows as B, CaptionStyle as Bt, isImplementedSemanticOpKind as C, SpeechOriginAssetSystem as Ct, PartIdFactory as D, TrackItem as Dt, ValidationError as E, Track as Et, ResolvedEntityTrack as F, VideoDraftPartUnion as Ft, ScriptTextSegment as G, TrackItem$1 as Gt, RelationRow as H, SpeedShift as Ht, resolveEntityTimelineLayout as I, effectiveVideoClipDurationMs as It, VoiceDescriptor as J, SequenceDuration as K, EntityTimelineProjectionDocument as L, speedOf as Lt, EntityTimelineTrackRole as M, VideoDocumentValidationIssueCode as Mt, ResolvedEntityClipPlacement as N, VideoDraft as Nt, generatePartId as O, TrackItemTimePosition as Ot, ResolvedEntityTimelineLayout as P, VideoDraftContent as Pt, buildInitialVideoDocument as Q, projectEntityTimeline as R, Attachment as Rt, SemanticOpKind as S, PartUnion as St, SnapshotReadable as T, Timeline as Tt, CaptionSegmentSelection as U, Timeline$1 as Ut, EntityRow as V, PartAggregation as Vt, CaptionStyleFields as W, Track$1 as Wt, JsonValue as X, JsonObject as Y, EntityId as Z, SemanticOpName as _, BgmPart as _t, PlainMemoryAdapter as a, LANE_KINDS_IN_STACK_ORDER as at, ImplementedSemanticOpKind as b, DEFAULT_UNIT_TIME_MS as bt, MirrorVideoDocumentAdapter as c, ensureLaneTrack as ct, createMirrorVideoDocumentAdapter as d, solveVideoDocument as dt, SpeechHostMap as et, CommitOptions as f, TrackDraft as ft, SemanticOpInput as g, videoDocumentMirrorSchema as gt, SemanticEditor as h, VideoDocumentMirrorSchema as ht, JournalEntry as i, toVideoDocument as it, validateVideoDocument as j, VideoDocumentValidationIssue as jt, VideoDocumentValidationError as k, VideoClipPart as kt, MirrorVideoDocumentOptions as l, findLaneTrack as lt, SemanticDocumentAdapter as m, VideoDocumentDraft as mt, videoDocumentSchema as n, derivePositionFromAbs as nt, PlainMemoryAdapterOptions as o, LaneKind as ot, OpActor as p, TrackItemDraft as pt, SequenceRange as q, readVideoDocumentFromDraft as r, fromVideoDocument as rt, createPlainMemoryAdapter as s, SolvedVideoDocument as st, partUnionSchema as t, buildSpeechHostMap as tt, createMirrorVideoDocument as u, laneTrackId as ut, TransactAudit as v, CaptionDisplayCue as vt, SchemaValidator as w, SpeechPart as wt, PlannedSemanticOpKind as x, PartKind as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, CaptionPart as yt, EntityTimelineProjectionError as z, CaptionPart$1 as zt };
+export { derivePositionFromAbs as $, assertValidVideoDocument as A, VideoDraftContent as At, EntityRow as B, Track$1 as Bt, isImplementedSemanticOpKind as C, TrackItem as Ct, PartIdFactory as D, VideoDocumentValidationIssue as Dt, ValidationError as E, VideoDocument as Et, ResolvedEntityTrack as F, CaptionPart$1 as Ft, VoiceDescriptor as G, CaptionSegmentSelection as H, resolveEntityTimelineLayout as I, CaptionStyle as It, EntityId as J, JsonObject as K, projectEntityTimeline as L, PartAggregation as Lt, EntityTimelineTrackRole as M, effectiveVideoClipDurationMs as Mt, ResolvedEntityClipPlacement as N, speedOf as Nt, generatePartId as O, VideoDocumentValidationIssueCode as Ot, ResolvedEntityTimelineLayout as P, Attachment as Pt, buildSpeechHostMap as Q, EntityTimelineProjectionError as R, SpeedShift as Rt, SemanticOpKind as S, Track as St, SnapshotReadable as T, VideoClipPart as Tt, CaptionStyleFields as U, RelationRow as V, TrackItem$1 as Vt, ScriptTextSegment as W, DerivedItemPosition as X, buildInitialVideoDocument as Y, SpeechHostMap as Z, SemanticOpName as _, DEFAULT_UNIT_TIME_MS as _t, PlainMemoryAdapter as a, ensureLaneTrack as at, ImplementedSemanticOpKind as b, SpeechPart as bt, MirrorVideoDocumentAdapter as c, solveVideoDocument as ct, createMirrorVideoDocumentAdapter as d, VideoDocumentDraft as dt, fromVideoDocument as et, CommitOptions as f, VideoDocumentMirrorSchema as ft, SemanticOpInput as g, CaptionPart as gt, SemanticEditor as h, CaptionDisplayCue as ht, JournalEntry as i, SolvedVideoDocument as it, validateVideoDocument as j, VideoDraftPartUnion as jt, VideoDocumentValidationError as k, VideoDraft as kt, MirrorVideoDocumentOptions as l, TrackDraft as lt, SemanticDocumentAdapter as m, BgmPart as mt, videoDocumentSchema as n, LANE_KINDS_IN_STACK_ORDER as nt, PlainMemoryAdapterOptions as o, findLaneTrack as ot, OpActor as p, videoDocumentMirrorSchema as pt, JsonValue as q, readVideoDocumentFromDraft as r, LaneKind as rt, createPlainMemoryAdapter as s, laneTrackId as st, partUnionSchema as t, toVideoDocument as tt, createMirrorVideoDocument as u, TrackItemDraft as ut, TransactAudit as v, PartKind as vt, SchemaValidator as w, TrackItemTimePosition as wt, PlannedSemanticOpKind as x, Timeline as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, PartUnion as yt, EntityRelationRows as z, Timeline$1 as zt };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as index_d_exports } from "./index-CMa6ZCtX.js";
-import { $ as DerivedItemPosition, A as assertValidVideoDocument, At as VideoDocument, B as EntityRelationRows, Bt as CaptionStyle, C as isImplementedSemanticOpKind, Ct as SpeechOriginAssetSystem, D as PartIdFactory, Dt as TrackItem, E as ValidationError, Et as Track, F as ResolvedEntityTrack, Ft as VideoDraftPartUnion, G as ScriptTextSegment, Gt as TrackItem$1, H as RelationRow, Ht as SpeedShift, I as resolveEntityTimelineLayout, It as effectiveVideoClipDurationMs, J as VoiceDescriptor, K as SequenceDuration, L as EntityTimelineProjectionDocument, Lt as speedOf, M as EntityTimelineTrackRole, Mt as VideoDocumentValidationIssueCode, N as ResolvedEntityClipPlacement, Nt as VideoDraft, O as generatePartId, Ot as TrackItemTimePosition, P as ResolvedEntityTimelineLayout, Pt as VideoDraftContent, Q as buildInitialVideoDocument, R as projectEntityTimeline, Rt as Attachment, S as SemanticOpKind, St as PartUnion, T as SnapshotReadable, Tt as Timeline, U as CaptionSegmentSelection, Ut as Timeline$1, V as EntityRow, Vt as PartAggregation, W as CaptionStyleFields, Wt as Track$1, X as JsonValue, Y as JsonObject, Z as EntityId, _ as SemanticOpName, _t as BgmPart, a as PlainMemoryAdapter, at as LANE_KINDS_IN_STACK_ORDER, b as ImplementedSemanticOpKind, bt as DEFAULT_UNIT_TIME_MS, c as MirrorVideoDocumentAdapter, ct as ensureLaneTrack, d as createMirrorVideoDocumentAdapter, dt as solveVideoDocument, et as SpeechHostMap, f as CommitOptions, ft as TrackDraft, g as SemanticOpInput, gt as videoDocumentMirrorSchema, h as SemanticEditor, ht as VideoDocumentMirrorSchema, i as JournalEntry, it as toVideoDocument, j as validateVideoDocument, jt as VideoDocumentValidationIssue, k as VideoDocumentValidationError, kt as VideoClipPart, l as MirrorVideoDocumentOptions, lt as findLaneTrack, m as SemanticDocumentAdapter, mt as VideoDocumentDraft, n as videoDocumentSchema, nt as derivePositionFromAbs, o as PlainMemoryAdapterOptions, ot as LaneKind, p as OpActor, pt as TrackItemDraft, q as SequenceRange, r as readVideoDocumentFromDraft, rt as fromVideoDocument, s as createPlainMemoryAdapter, st as SolvedVideoDocument, t as partUnionSchema, tt as buildSpeechHostMap, u as createMirrorVideoDocument, ut as laneTrackId, v as TransactAudit, vt as CaptionDisplayCue, w as SchemaValidator, wt as SpeechPart, x as PlannedSemanticOpKind, xt as PartKind, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as CaptionPart, z as EntityTimelineProjectionError, zt as CaptionPart$1 } from "./index-mGObzOh4.js";
+import { $ as derivePositionFromAbs, A as assertValidVideoDocument, At as VideoDraftContent, B as EntityRow, Bt as Track$1, C as isImplementedSemanticOpKind, Ct as TrackItem, D as PartIdFactory, Dt as VideoDocumentValidationIssue, E as ValidationError, Et as VideoDocument, F as ResolvedEntityTrack, Ft as CaptionPart$1, G as VoiceDescriptor, H as CaptionSegmentSelection, I as resolveEntityTimelineLayout, It as CaptionStyle, J as EntityId, K as JsonObject, L as projectEntityTimeline, Lt as PartAggregation, M as EntityTimelineTrackRole, Mt as effectiveVideoClipDurationMs, N as ResolvedEntityClipPlacement, Nt as speedOf, O as generatePartId, Ot as VideoDocumentValidationIssueCode, P as ResolvedEntityTimelineLayout, Pt as Attachment, Q as buildSpeechHostMap, R as EntityTimelineProjectionError, Rt as SpeedShift, S as SemanticOpKind, St as Track, T as SnapshotReadable, Tt as VideoClipPart, U as CaptionStyleFields, V as RelationRow, Vt as TrackItem$1, W as ScriptTextSegment, X as DerivedItemPosition, Y as buildInitialVideoDocument, Z as SpeechHostMap, _ as SemanticOpName, _t as DEFAULT_UNIT_TIME_MS, a as PlainMemoryAdapter, at as ensureLaneTrack, b as ImplementedSemanticOpKind, bt as SpeechPart, c as MirrorVideoDocumentAdapter, ct as solveVideoDocument, d as createMirrorVideoDocumentAdapter, dt as VideoDocumentDraft, et as fromVideoDocument, f as CommitOptions, ft as VideoDocumentMirrorSchema, g as SemanticOpInput, gt as CaptionPart, h as SemanticEditor, ht as CaptionDisplayCue, i as JournalEntry, it as SolvedVideoDocument, j as validateVideoDocument, jt as VideoDraftPartUnion, k as VideoDocumentValidationError, kt as VideoDraft, l as MirrorVideoDocumentOptions, lt as TrackDraft, m as SemanticDocumentAdapter, mt as BgmPart, n as videoDocumentSchema, nt as LANE_KINDS_IN_STACK_ORDER, o as PlainMemoryAdapterOptions, ot as findLaneTrack, p as OpActor, pt as videoDocumentMirrorSchema, q as JsonValue, r as readVideoDocumentFromDraft, rt as LaneKind, s as createPlainMemoryAdapter, st as laneTrackId, t as partUnionSchema, tt as toVideoDocument, u as createMirrorVideoDocument, ut as TrackItemDraft, v as TransactAudit, vt as PartKind, w as SchemaValidator, wt as TrackItemTimePosition, x as PlannedSemanticOpKind, xt as Timeline, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as PartUnion, z as EntityRelationRows, zt as Timeline$1 } from "./index-BYv9FPSS.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -242,6 +242,19 @@ interface EntityGraphCommitOptions {
   /** Server version vector proving the explicit legacy-to-Entity migration baseline. */
   readonly migrationBaseVv?: string;
 }
+interface EntityGraphRevisionConflictPayload {
+  readonly error: {
+    readonly code: 'revision_conflict';
+    readonly message: string;
+    readonly expected_revision: number;
+    readonly current_revision: number;
+  };
+}
+declare class EntityGraphRevisionConflictError extends MengineHttpRequestError {
+  readonly expectedRevision: number;
+  readonly currentRevision: number;
+  constructor(expectedRevision: number, currentRevision: number, payload: EntityGraphRevisionConflictPayload);
+}
 /** Browser-safe authenticated Loro client for a document's Entity graph. */
 declare class EntityGraphHttpClient {
   private readonly options;
@@ -251,14 +264,16 @@ declare class EntityGraphHttpClient {
   fetchState(): Promise<EntityGraphState>;
   /**
    * Compile edits against the original causal snapshot and publish native Loro operations.
+   * The base revision is sent as an optimistic precondition, so a stale adoption
+   * fails loudly instead of letting Loro choose between concurrent selections.
    *
    * Deletion intent is derived from baseline IDs omitted from `nextRows`, so a
    * transient create-then-remove never becomes a request to delete unknown
    * persisted data.
    */
   commit(baseState: Pick<EntityGraphState, 'revision' | 'rows' | 'loroSnapshot'>, nextRows: EntityRelationRows, options?: EntityGraphCommitOptions): Promise<EntityGraphState>;
-  /** Send the same prepared bytes on retry; never recompile an unconfirmed edit. */
-  commitUpdate(update: string): Promise<EntityGraphState>;
+  /** Send prepared bytes directly; omit `expectedRevision` for immutable fact publication. */
+  commitUpdate(update: string, expectedRevision?: number): Promise<EntityGraphState>;
   private request;
 }
 //#endregion
@@ -282,16 +297,11 @@ interface AudioMediaAssetFact {
   readonly durationMs: number;
   readonly storageKey: string;
 }
-/**
- * Speech. It materializes as a `voiceover` entity — its own kind, because only
- * speech answers which words it said; `voice` names the timbre identity it was
- * synthesized with, which becomes its own Voice entity linked by a
- * `voice-timbre` Relation.
- */
+/** A synthesized speech result. Uploaded recordings remain raw `audio`. */
 interface VoiceoverMediaAssetFact {
   /** Stable external speech result id, independent of the placed Clip id. */
   readonly assetId: string;
-  readonly kind: 'voiceover';
+  readonly kind: 'voiceover-recording';
   readonly durationMs: number;
   readonly storageKey: string;
   /**
@@ -300,27 +310,28 @@ interface VoiceoverMediaAssetFact {
    * way a take that never names one is refused when a plan is built.
    */
   readonly phoneticScriptEntityId?: string;
-  /** Present for synthesized speech, absent for original recorded audio. */
+  /** Timbre identity used for synthesis, when the caller has it. */
   readonly voice?: VoiceDescriptor;
 }
 /** Facts resolved from media storage. A trim window never substitutes for intrinsic duration. */
 type MediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact | AudioMediaAssetFact | VoiceoverMediaAssetFact;
+/** Where a Clip starts: in flow by order, or at a stated start on its Track or inside its host. */
 type ClipPlacement = {
   readonly kind: 'sequential';
   readonly order: number;
 } | {
   readonly kind: 'absolute';
-  readonly targetRange: SequenceRange<number>;
+  readonly startMs: number;
 } | {
   readonly kind: 'anchored';
   readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
+  readonly startMs: number;
 };
 interface InsertPlacedClipInput {
   readonly trackEntityId: string;
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
+  readonly inMs: number;
+  readonly outMs: number;
   readonly placement: ClipPlacement;
   readonly clipPayload?: JsonObject;
   /** Stable caller-owned placement identity, when one already exists outside the graph. */
@@ -374,31 +385,34 @@ type VoiceoverTakeInput = {
 } & ({
   readonly placement: ClipPlacement;
   readonly hostClipEntityId?: never;
-  readonly anchorOffset?: never;
+  readonly startMs?: never;
 } | {
   readonly placement?: never;
   readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
+  readonly startMs: number;
 });
 type VisualMediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact;
 interface InsertMediaClipInput {
   readonly timelineEntityId: string;
   readonly clipEntityId?: string;
   readonly media: VisualMediaAssetFact;
-  /** Source/display window in whole milliseconds. Images use this as their finite display span. */
-  readonly sourceRange: SequenceRange<number>;
+  /** Window on the source, whole milliseconds. An Image uses it as its finite display span. */
+  readonly inMs: number;
+  readonly outMs: number;
   readonly placement: ClipPlacement;
   readonly volume?: number;
 }
 interface ReplaceMediaClipInput {
   readonly clipEntityId: string;
   readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
 }
 interface ReplacementMediaClipInput {
   readonly clipEntityId?: string;
   readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
   readonly volume?: number;
 }
 type MediaClipInsertion = {
@@ -435,11 +449,13 @@ interface LinearClipSpeed {
 }
 interface SetClipSpeedInput {
   readonly clipEntityId: string;
-  readonly timeRemapping: LinearClipSpeed | null;
+  /** Linear speed; null restores the source's own pace. */
+  readonly rate: number | null;
 }
 interface TrimClipInput {
   readonly clipEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
 }
 interface VoiceoverTakeResult {
   readonly voiceoverClipEntityId: string;
@@ -497,19 +513,21 @@ interface InsertClipInput {
   readonly trackEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
+  readonly startMs?: number;
+  /** Where among its Track's Clips it lands; appended when omitted. */
+  readonly order?: number;
   readonly clipPayload?: JsonObject;
 }
 interface UpdateClipMarkerInput {
   readonly clipEntityId: string;
-  readonly sourceRange?: SequenceRange<number>;
-  /** Passing `undefined` explicitly removes the optional target range. */
-  readonly targetRange?: SequenceRange<number> | undefined;
-  readonly duration?: SequenceDuration<number>;
-  /** Passing `undefined` explicitly removes the optional remapping value. */
-  readonly timeRemapping?: JsonValue | undefined;
+  readonly inMs?: number;
+  readonly outMs?: number;
+  /** Passing `undefined` explicitly removes the optional start. */
+  readonly startMs?: number | undefined;
+  /** Passing `undefined` explicitly removes the optional rate. */
+  readonly rate?: number | undefined;
 }
 interface MoveClipInput {
   readonly clipEntityId: string;
@@ -519,10 +537,10 @@ interface ReplaceClipContentInput {
   readonly clipEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
-  readonly timeRemapping?: JsonValue;
+  readonly inMs: number;
+  readonly outMs: number;
+  readonly startMs?: number;
+  readonly rate?: number;
 }
 interface DeleteClipInput {
   readonly clipEntityId: string;
@@ -773,6 +791,7 @@ declare const LORO_ENTITY_SCHEMA = "medeo.entities.loro.v1";
 interface EntityDocumentState {
   readonly rows: EntityRelationRows;
   readonly project: Readonly<Record<string, string>>;
+  readonly phoneticScriptSelections?: Readonly<Record<string, string>>;
 }
 /** One stable native relation root, including records tombstoned from the active projection. */
 interface EntityRelationRecord extends RelationRow {
@@ -830,6 +849,14 @@ type Command = {
 } | {
   type: 'unlink';
   root: string;
+} | {
+  type: 'select-clip-content';
+  clipRoot: string;
+  relationRoot: string;
+} | {
+  type: 'select-phonetic-script';
+  clipRoot: string;
+  phoneticScriptRoot: string;
 } | {
   type: 'attach';
   slot: string;
@@ -884,20 +911,12 @@ declare class LoroEntityDraft {
   delete(entityId: string): void;
   attach(slot: string, entityId: string): void;
   link(row: RelationRow): void;
-  linkGenerated(input: {
-    relationId: RelationRow['relationId'];
-    outputEntityId: RelationRow['endpoint0EntityId'];
-    inputEntityId: RelationRow['endpoint1EntityId'];
-    trace?: JsonObject;
-  }): void;
-  linkClipAnchor(input: {
-    relationId: RelationRow['relationId'];
-    childClipEntityId: RelationRow['endpoint0EntityId'];
-    hostClipEntityId: RelationRow['endpoint1EntityId'];
-    trace?: JsonObject;
-  }): void;
   patchRelationTrace(relationId: string, trace: JsonObject): void;
   unlink(relationId: string): void;
+  /** Select the one content membership projected for this stable Clip identity. */
+  selectClipContent(relationId: string): void;
+  /** Select the pending immutable pronunciation variant for one stable Speech Clip. */
+  selectPhoneticScript(clipEntityId: string, phoneticScriptEntityId: string): void;
   private relationRoot;
   update(entityId: string, fields: JsonObject): void;
   declare(entityId: string, fields: JsonObject): void;
@@ -911,13 +930,22 @@ declare class LoroEntityDraft {
 }
 //#endregion
 //#region src/entity-crdt/compile-rows.d.ts
+interface ApplyEntityRowsOptions {
+  readonly projectAttachments?: Readonly<Record<string, string>>;
+  readonly phoneticScriptSelections?: Readonly<Record<string, string>>;
+}
 /** Lower a detached ordinary-object edit against its actual causal Loro baseline. */
-declare function compileEntityRows(snapshot: Uint8Array, rows: EntityRelationRows, validate?: (state: EntityDocumentState) => void): {
+declare function compileEntityRows(snapshot: Uint8Array, rows: EntityRelationRows, validate?: (state: EntityDocumentState) => void, options?: ApplyEntityRowsOptions): {
+  update: Uint8Array;
+  state: EntityDocumentState;
+};
+/** Publish final rows as imported causal operations, outside the caller's local undo history. */
+declare function publishEntityRows(editor: LoroEntityDocument, rows: EntityRelationRows, options?: ApplyEntityRowsOptions): {
   update: Uint8Array;
   state: EntityDocumentState;
 };
 /** Compile an edit on an existing peer, retaining its native local undo history. */
-declare function applyEntityRows(editor: LoroEntityDocument, rows: EntityRelationRows): {
+declare function applyEntityRows(editor: LoroEntityDocument, rows: EntityRelationRows, options?: ApplyEntityRowsOptions): {
   update: Uint8Array;
   state: EntityDocumentState;
 };
@@ -1818,4 +1846,4 @@ declare function phoneticScriptAssetHash(rows: EntityRelationRows, entityId: str
 /** The Asset a PhoneticScript was written out to, read from the graph. */
 declare function phoneticScriptAssetOf(rows: EntityRelationRows, entityId: string): EntityRow | undefined;
 //#endregion
-export { type Aggregation, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityRelationRecord, EntityTimelineEditor, type EntityTimelineIdFactory, type EntityTimelineProjectionDocument, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ReviseAudioScriptInput, type ReviseAudioScriptResult, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechOriginAssetSystem, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { type Aggregation, ApplyEntityRowsOptions, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, EntityGraphRevisionConflictError, type EntityGraphRevisionConflictPayload, type EntityGraphState, EntityRelationRecord, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ReviseAudioScriptInput, type ReviseAudioScriptResult, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, publishEntityRows, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };