@mengine/medeo-client 2.0.1-alpha.15 → 2.0.1-alpha.17

package/dist/{document-CAZ_A9R8.js → document-DSvLp3Z3.js}

@@ -3183,10 +3183,11 @@ function projectEntityTimeline(rows) {
 		} else if (track.role === "speech") {
 			const asset = mediaAssetFacts(graph, content);
 			requireUntrimmedAudio(content, marker, placement);
-			const external = externalLocator(asset, "memota-speech");
 			const renderEdges = graph.adjacent(content.entityId, "phonetic-script-render");
 			const timbreEdges = graph.adjacent(content.entityId, "voice-timbre");
-			const assembled = renderEdges.length > 0 || timbreEdges.length > 0 ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
+			const isSynthesized = renderEdges.length > 0 || timbreEdges.length > 0;
+			const external = externalLocator(asset, isSynthesized ? "memota-speech" : "memota");
+			const assembled = isSynthesized ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
 			if (timbreEdges.length > 1) fail("A voiceover resolves at most one Voice identity");
 			const voice = timbreEdges.length === 0 ? void 0 : graph.one(content.entityId, "voice-timbre", "voice").payload.voice;
 			if (voice !== void 0 && (!object(voice) || voice.system !== "voice-library" || typeof voice.key !== "string")) fail("Voice must use an explicit voice-library locator");
@@ -4715,4 +4716,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { partUnionSchema as $, decodeEntityRelationRows as A, isJsonObject as B, applyFieldChanges as C, recordEntries as Ct, EntityProjectionGraph as D, projectEntityTimeline as E, bytesToBase64 as Et, assembleScriptText as F, buildInitialVideoDocument as G, createRelationId as H, findComposedAudioScript as I, fromVideoDocument as J, buildSpeechHostMap as K, selectAudioScriptSegment as L, assembleCaptionContent as M, assembleEntityContent as N, resolveEntityTimelineLayout as O, assemblePhoneticScriptContent as P, validateVideoDocument as Q, updateEntityFields as R, equalJson as S, partUnionToDraft as St, resolveFieldPath as T, base64ToBytes as Tt, hasSequence as U, createEntityId as V, isMediaAssetVariantKind as W, VideoDocumentValidationError as X, toVideoDocument as Y, assertValidVideoDocument as Z, audioScriptAssetOf as _, partDurationMs as _t, createMirrorVideoDocument as a, laneTrackId as at, phoneticScriptAssetOf as b, effectiveVideoClipDurationMs as bt, DocumentMutationGuard as c, arrangeMainTrackSeamlessly as ct, LoroEntityDraft as d, recalculateTimelineDuration as dt, videoDocumentSchema as et, readEntityDocument as f, resolveAllSpeechOverlaps as ft, audioScriptAssetHash as g, isEmptyVideoClip as gt, audioScriptAssetFields as h, TIMELINE_SKELETON_DURATION_MS as ht, MirrorVideoDocumentAdapter as i, hasResolvedPlacement as it, ScriptCompositionError as j, EntityTimelineProjectionError as k, LORO_ENTITY_SCHEMA as l, fillMainTrackTimeGaps as lt, audioScriptAssetContent as m, syncAggregatedClipsTimePosition as mt, createPlainMemoryAdapter as n, ensureLaneTrack as nt, createMirrorVideoDocumentAdapter as o, solveVideoDocument as ot, entityOrderGroups as p, resolveSpeechOverlapByShiftingVideos as pt, derivePositionFromAbs as q, generatePartId as r, findLaneTrack as rt, readVideoDocumentFromDraft as s, cascadeAfterVideoClipChanges as st, PlainMemoryAdapter as t, LANE_KINDS_IN_STACK_ORDER as tt, LoroEntityDocument as u, reassignSpeechesToVideoClipsByTime as ut, phoneticScriptAssetContent as v, safeDurationMs as vt, assertFieldChanges as w, videoDocumentMirrorSchema as wt, scriptSourceAssetOf as x, speedOf as xt, phoneticScriptAssetHash as y, DEFAULT_UNIT_TIME_MS as yt, variantBaseEntityIds as z };
+export { validateVideoDocument as $, EntityTimelineProjectionError as A, variantBaseEntityIds as B, equalJson as C, partUnionToDraft as Ct, projectEntityTimeline as D, bytesToBase64 as Dt, resolveFieldPath as E, base64ToBytes as Et, assemblePhoneticScriptContent as F, isMediaAssetVariantKind as G, createEntityId as H, assembleScriptText as I, derivePositionFromAbs as J, buildInitialVideoDocument as K, findComposedAudioScript as L, ScriptCompositionError as M, assembleCaptionContent as N, EntityProjectionGraph as O, assembleEntityContent as P, assertValidVideoDocument as Q, selectAudioScriptSegment as R, canonicalJson as S, speedOf as St, assertFieldChanges as T, videoDocumentMirrorSchema as Tt, createRelationId as U, isJsonObject as V, hasSequence as W, toVideoDocument as X, fromVideoDocument as Y, VideoDocumentValidationError as Z, audioScriptAssetOf as _, isEmptyVideoClip as _t, createMirrorVideoDocument as a, hasResolvedPlacement as at, phoneticScriptAssetOf as b, DEFAULT_UNIT_TIME_MS as bt, DocumentMutationGuard as c, cascadeAfterVideoClipChanges as ct, LoroEntityDraft as d, reassignSpeechesToVideoClipsByTime as dt, partUnionSchema as et, readEntityDocument as f, recalculateTimelineDuration as ft, audioScriptAssetHash as g, TIMELINE_SKELETON_DURATION_MS as gt, audioScriptAssetFields as h, syncAggregatedClipsTimePosition as ht, MirrorVideoDocumentAdapter as i, findLaneTrack as it, decodeEntityRelationRows as j, resolveEntityTimelineLayout as k, LORO_ENTITY_SCHEMA as l, arrangeMainTrackSeamlessly as lt, audioScriptAssetContent as m, resolveSpeechOverlapByShiftingVideos as mt, createPlainMemoryAdapter as n, LANE_KINDS_IN_STACK_ORDER as nt, createMirrorVideoDocumentAdapter as o, laneTrackId as ot, entityOrderGroups as p, resolveAllSpeechOverlaps as pt, buildSpeechHostMap as q, generatePartId as r, ensureLaneTrack as rt, readVideoDocumentFromDraft as s, solveVideoDocument as st, PlainMemoryAdapter as t, videoDocumentSchema as tt, LoroEntityDocument as u, fillMainTrackTimeGaps as ut, phoneticScriptAssetContent as v, partDurationMs as vt, applyFieldChanges as w, recordEntries as wt, scriptSourceAssetOf as x, effectiveVideoClipDurationMs as xt, phoneticScriptAssetHash as y, safeDurationMs as yt, updateEntityFields as z };

package/dist/index.d.ts

@@ -262,6 +262,169 @@ declare class EntityGraphHttpClient {
   private request;
 }
 //#endregion
+//#region src/entity-crdt/field-changes.d.ts
+/** List members are addressed by identity, never a transient array offset. */
+type FieldPath = readonly (string | {
+  elementId: string;
+})[];
+type FieldChange = {
+  op: 'set';
+  path: FieldPath;
+  value: JsonValue;
+} | {
+  op: 'unset';
+  path: FieldPath;
+} | {
+  op: 'text.splice';
+  path: FieldPath;
+  index: number;
+  deleteCount: number;
+  text: string;
+} | {
+  op: 'list.insert';
+  path: FieldPath;
+  value: JsonValue;
+  beforeElementId: string | null;
+} | {
+  op: 'list.move';
+  path: FieldPath;
+  elementId: string;
+  beforeElementId: string | null;
+} | {
+  op: 'list.remove';
+  path: FieldPath;
+  elementId: string;
+};
+declare function assertFieldChanges(changes: readonly FieldChange[]): void;
+/** Resolve against the sequential causal view; the numeric path never crosses the API boundary. */
+declare function resolveFieldPath(payload: JsonObject, path: FieldPath): (string | number)[];
+/** Detached plan evaluation. Native compilation replays the original operations, not this snapshot. */
+declare function applyFieldChanges(payload: JsonObject, changes: readonly FieldChange[]): JsonObject;
+//#endregion
+//#region src/entity-crdt/entity-document.d.ts
+declare const LORO_ENTITY_SCHEMA = "medeo.entities.loro.v1";
+interface EntityDocumentState {
+  readonly rows: EntityRelationRows;
+  readonly project: Readonly<Record<string, string>>;
+}
+type Command = {
+  type: 'create';
+  row: EntityRow;
+} | {
+  type: 'selection-baseline';
+  root: string;
+  fingerprint: string;
+} | {
+  type: 'order';
+  group: string;
+  roots: string[];
+  token: string;
+} | {
+  type: 'write';
+  root: string;
+  payload: JsonObject;
+  token: string;
+} | {
+  type: 'text';
+  root: string;
+  path: readonly (string | number)[];
+  start: number;
+  deleteCount: number;
+  text: string;
+  token: string;
+} | {
+  type: 'field';
+  root: string;
+  path: (string | number)[];
+  change: FieldChange;
+  token: string;
+} | {
+  type: 'relation-field';
+  root: string;
+  path: (string | number)[];
+  change: FieldChange;
+} | {
+  type: 'delete';
+  root: string;
+} | {
+  type: 'relation';
+  row: RelationRow;
+} | {
+  type: 'relation-fields';
+  root: string;
+  metadata: JsonObject;
+  trace: JsonObject;
+} | {
+  type: 'unlink';
+  root: string;
+} | {
+  type: 'attach';
+  slot: string;
+  entityId: string;
+};
+/** Plain domain objects assembled from native Loro state, never a second writable authority. */
+declare function readEntityDocument(doc: LoroDoc, allowSelectionConflicts?: boolean): EntityDocumentState;
+/** Native editing containers survive domain version changes and merge independently. */
+declare class LoroEntityDocument {
+  readonly doc: LoroDoc;
+  private readonly validate?;
+  private readonly undoManager;
+  constructor(doc: LoroDoc, validate?: ((state: EntityDocumentState) => void) | undefined);
+  /** Open a causal snapshot using the same Loro runtime as the compiler. */
+  static fromSnapshot(snapshot: Uint8Array, validate?: (state: EntityDocumentState) => void): LoroEntityDocument;
+  static create(rows: EntityRelationRows, project?: Readonly<Record<string, string>>, peerId?: PeerID): LoroEntityDocument;
+  snapshot(): EntityDocumentState;
+  relationsOf(entityId: string): readonly RelationRow[];
+  /** Resolve a queued edit target through its native identity without changing history. */
+  resolveCurrentEntityId(id: string): string;
+  getVersion(id: string): EntityRow | undefined;
+  /** The callback and every domain validation execute on a causally complete fork first. */
+  transact(edit: (draft: LoroEntityDraft) => void): Uint8Array;
+  /** Import preserves native operation identities; projection errors never discard remote operations. */
+  import(update: Uint8Array): void;
+  /**
+   * Bind a saved snapshot without rewriting text operations or resolving
+   * selection conflicts. The script names the bytes the same way everything
+   * else does — an Asset entity plus a Relation — and keeps only the
+   * fingerprint that tells a stale snapshot from a current one. The Relation is
+   * `to-asset`: these bytes are the script's own content written out, not a
+   * source it was made from.
+   */
+  bindAudioScriptAsset(entityId: string, assetId: string, expectedContentHash: string): Uint8Array;
+  canUndo(): boolean;
+  canRedo(): boolean;
+  undo(): boolean;
+  redo(): boolean;
+  private historyEdit;
+}
+declare class LoroEntityDraft {
+  private readonly doc;
+  readonly commands: Command[];
+  private readonly selectedRoots;
+  private readonly relationAliases;
+  constructor(doc: LoroDoc);
+  snapshot(): EntityDocumentState;
+  order(groupId: string, entityIds: readonly string[]): void;
+  /** Project the final scalar placement intents onto the existing native ordering containers. */
+  reconcileOrder(rows: EntityRelationRows): void;
+  create(row: EntityRow): void;
+  delete(entityId: string): void;
+  attach(slot: string, entityId: string): void;
+  link(row: RelationRow): void;
+  patchRelation(relationId: string, metadata: JsonObject, trace: JsonObject): void;
+  unlink(relationId: string): void;
+  private relationRoot;
+  update(entityId: string, fields: JsonObject): void;
+  declare(entityId: string, fields: JsonObject): void;
+  replaceOwned(entityId: string, payload: JsonObject): void;
+  editText(entityId: string, path: readonly (string | number)[], start: number, deleteCount: number, text: string): void;
+  /** Generic assembled-field edit compiled at the author's causal position. */
+  change(entityId: string, changes: readonly FieldChange[]): void;
+  changeRelation(relationId: string, changes: readonly FieldChange[]): void;
+  captureSelectionBaselines(): void;
+  private record;
+}
+//#endregion
 //#region src/entity-editor/types.d.ts
 /** Injectable domain-id mint shared by Entity and Relation authoring surfaces. */
 type EntityTimelineIdFactory = (prefix: 'entity' | 'relation') => string;
@@ -298,6 +461,71 @@ interface VoiceoverMediaAssetFact {
 }
 /** Facts resolved from media storage. A trim window never substitutes for intrinsic duration. */
 type MediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact | AudioMediaAssetFact | VoiceoverMediaAssetFact;
+/** Host-resolved ASR artifact. The SDK treats its storage fields as opaque facts. */
+interface CaptionAssetFact {
+  readonly assetId: string;
+  readonly storageKey?: string;
+}
+interface AsrCaptionSegment extends ScriptTextSegment {
+  readonly startMs: number;
+  readonly endMs: number;
+}
+/** One closed host command for materializing an ASR result into the Entity graph. */
+interface ApplyCaptionAssetsInput {
+  readonly effectId: string;
+  readonly timelineEntityId: string;
+  readonly trackEntityId: string;
+  readonly source: {
+    readonly entityId: string;
+    readonly entityKind: 'audio' | 'video';
+  };
+  /** The exact placed use whose source-relative ASR timing is being materialized. */
+  readonly sourceOccurrence: {
+    readonly clipEntityId: string;
+    readonly markerEntityId: string;
+  };
+  readonly captionAsset: CaptionAssetFact;
+  readonly segments: readonly AsrCaptionSegment[];
+}
+interface ApplyCaptionAssetsResult {
+  readonly audioScriptEntityId: string;
+  readonly audioScriptMarkerEntityId: string;
+  readonly captionAssetEntityId: string;
+  readonly captionEntityIds: readonly string[];
+  readonly captionClipEntityIds: readonly string[];
+}
+interface CaptionAssetsEffectEnvelope {
+  readonly version: 1;
+  readonly baselineFingerprint: string;
+  readonly effectId: string;
+  readonly signature: string;
+  readonly input: ApplyCaptionAssetsInput;
+  readonly decisions: {
+    readonly sourceOccurrence: {
+      readonly sourceStartMs: number;
+      readonly sourceEndMs: number;
+      readonly timelineStartMs: number;
+      readonly rate: number;
+    };
+    readonly targetRanges: readonly {
+      readonly segmentId: string;
+      readonly start: number;
+      readonly end: number;
+    }[];
+    readonly captionAsset: {
+      readonly mode: 'create' | 'reuse' | 'replace';
+      readonly priorAssetEntityId?: string;
+      readonly resultAssetEntityId: string;
+      readonly reboundRelationIds: readonly string[];
+    };
+  };
+}
+interface CompiledCaptionAssetsEffect {
+  readonly result: ApplyCaptionAssetsResult;
+  readonly replayed: boolean;
+  readonly update?: Uint8Array;
+  readonly rows: EntityRelationRows;
+}
 type ClipPlacement = {
   readonly kind: 'sequential';
   readonly order: number;
@@ -430,6 +658,139 @@ interface SetClipSpeedInput {
   readonly clipEntityId: string;
   readonly timeRemapping: LinearClipSpeed | null;
 }
+type VideoClipSpeedMode = '0.5x' | '0.75x' | '1.0x' | '1.5x' | '2.0x';
+interface SetVideoClipSpeedEffectInput {
+  readonly clips: readonly {
+    readonly videoClipEntityId: string;
+    readonly mode: VideoClipSpeedMode;
+  }[];
+}
+interface GeneratedVisualClipFact {
+  readonly media: VisualMediaAssetFact;
+  /** Finite timeline use duration. Required for still images and bounded for video. */
+  readonly durationMs: number;
+  readonly generationJobId: string;
+  readonly sourceMediaEntityIds: readonly string[];
+  readonly volume?: number;
+}
+interface GeneratedVisualsInputBase {
+  readonly effectId: string;
+  readonly timelineEntityId: string;
+  readonly clips: readonly GeneratedVisualClipFact[];
+}
+/** Exactly one explicit occurrence anchor; the SDK never guesses a track edge. */
+type AddGeneratedVisualsInput = GeneratedVisualsInputBase & ({
+  readonly beforeClipEntityId: string;
+  readonly afterClipEntityId?: never;
+} | {
+  readonly beforeClipEntityId?: never;
+  readonly afterClipEntityId: string;
+});
+interface ContinueVideoInput {
+  readonly effectId: string;
+  readonly timelineEntityId: string;
+  readonly afterClipEntityId: string;
+  readonly tailFrameEntityId: string;
+  readonly sourceMediaEntityId: string;
+  readonly media: VideoMediaAssetFact;
+}
+interface GeneratedVisualEffectEnvelope {
+  readonly version: 1;
+  readonly baselineFingerprint: string;
+  readonly effectId: string;
+  readonly signature: string;
+  readonly input: AddGeneratedVisualsInput;
+  readonly decisions: {
+    readonly trackEntityId: string;
+    readonly anchorOrder: number;
+    readonly anchorPosition: 'before' | 'after';
+    readonly insertionOrders: readonly number[];
+  };
+}
+interface GeneratedVisualEffectResult {
+  readonly clipEntityIds: readonly string[];
+  readonly mediaEntityIds: readonly string[];
+}
+interface CompiledGeneratedVisualEffect {
+  readonly result: GeneratedVisualEffectResult;
+  readonly replayed: boolean;
+  readonly update?: Uint8Array;
+  readonly rows: EntityRelationRows;
+}
+interface GeneratedSpeechCaptionFact {
+  readonly startMs: number;
+  readonly endMs: number;
+  readonly selection: CaptionSegmentSelection;
+}
+/** Host-resolved current Loro segment; arbitrary immutable JSON fields remain owned by the script. */
+type ResolvedSpeechScriptSegment = ScriptTextSegment & JsonObject;
+type ResolvedAsrSpeechSegment = AsrCaptionSegment & JsonObject;
+type GeneratedSpeechSourceFact = {
+  readonly kind: 'phonetic-script';
+  readonly audioScriptEntityId: string;
+  readonly phoneticScriptEntityId: string;
+  readonly segments: readonly ResolvedSpeechScriptSegment[];
+  readonly phonemeScript?: string;
+} | {
+  readonly kind: 'audio-script';
+  readonly audioScriptEntityId?: string;
+  readonly segments: readonly ResolvedAsrSpeechSegment[];
+  readonly sourceMediaEntityIds: readonly string[];
+  readonly sourceStartMs: number;
+};
+interface GeneratedSpeechFact {
+  readonly media: VoiceoverMediaAssetFact;
+  readonly source: GeneratedSpeechSourceFact;
+  readonly captions: readonly GeneratedSpeechCaptionFact[];
+  readonly volume?: number;
+}
+interface AddSpeechAssetsInput {
+  readonly effectId: string;
+  readonly timelineEntityId: string;
+  readonly items: readonly (GeneratedSpeechFact & {
+    readonly placementStartMs: number;
+  })[];
+}
+interface ReplaceVoiceSpeechAssetsInput {
+  readonly effectId: string;
+  readonly timelineEntityId: string;
+  readonly items: readonly (GeneratedSpeechFact & {
+    readonly targetSpeechClipEntityId: string; /** Explicit current Caption uses replaced with this selected speech use. */
+    readonly targetCaptionClipEntityIds: readonly string[];
+  })[];
+}
+type SpeechAssetsEffectInput = {
+  readonly mode: 'add';
+  readonly value: AddSpeechAssetsInput;
+} | {
+  readonly mode: 'replace-voice';
+  readonly value: ReplaceVoiceSpeechAssetsInput;
+};
+interface SpeechAssetsEffectEnvelope {
+  readonly version: 1;
+  readonly baselineFingerprint: string;
+  readonly effectId: string;
+  readonly signature: string;
+  readonly input: SpeechAssetsEffectInput;
+  readonly decisions: {
+    readonly speechTrackEntityId: string;
+    readonly captionTrackEntityId?: string;
+    readonly targetStartsMs: readonly number[];
+  };
+}
+interface SpeechAssetsEffectResult {
+  readonly speechClipEntityIds: readonly string[];
+  readonly speechAudioEntityIds: readonly string[];
+  readonly audioScriptEntityIds: readonly string[];
+  readonly phoneticScriptEntityIds: readonly string[];
+  readonly captionClipEntityIds: readonly (readonly string[])[];
+}
+interface CompiledSpeechAssetsEffect {
+  readonly result: SpeechAssetsEffectResult;
+  readonly replayed: boolean;
+  readonly update?: Uint8Array;
+  readonly rows: EntityRelationRows;
+}
 interface TrimClipInput {
   readonly clipEntityId: string;
   readonly sourceRange: SequenceRange<number>;
@@ -535,6 +896,7 @@ type ClipEntityId = EntityId;
  * and committed only after validation succeeds.
  */
 declare class EntityTimelineEditor {
+  #private;
   private readonly idFactory;
   private state;
   constructor(initialRows: EntityRelationRows, idFactory?: EntityTimelineIdFactory);
@@ -552,6 +914,9 @@ declare class EntityTimelineEditor {
   replaceMediaClip(input: ReplaceMediaClipInput): void;
   setClipVolume(input: SetClipVolumeInput): void;
   setClipSpeed(input: SetClipSpeedInput): void;
+  /** Apply one typed Director speed effect as a single graph transaction. */
+  setVideoClipSpeeds(input: SetVideoClipSpeedEffectInput): void;
+  private setClipSpeedIntoDraft;
   trimClip(input: TrimClipInput): void;
   replaceSequentialClips(input: ReplaceSequentialClipsInput): readonly ClipEntityId[];
   deleteClip(input: DeleteClipInput): void;
@@ -572,6 +937,9 @@ declare class EntityTimelineEditor {
    * never the Caption entity or the AudioScript.
    */
   insertCaptionClip(input: InsertCaptionClipInput): ClipEntityId;
+  static compileCaptionAssetsEffect(base: LoroEntityDocument, envelope: CaptionAssetsEffectEnvelope): CompiledCaptionAssetsEffect;
+  static compileGeneratedVisualEffect(base: LoroEntityDocument, envelope: GeneratedVisualEffectEnvelope): CompiledGeneratedVisualEffect;
+  static compileSpeechAssetsEffect(base: LoroEntityDocument, envelope: SpeechAssetsEffectEnvelope): CompiledSpeechAssetsEffect;
   private insertPlacedClipIntoDraft;
   private ensureRoleTrack;
   /** The existing pronunciation variant a voiceover consumes; composition is required. */
@@ -600,6 +968,21 @@ declare class EntityTimelineEditor {
   private relinkRelation;
   private mintRelationId;
 }
+/** Freeze every state-dependent choice once in the sole FE tool-effect handler. */
+declare function prepareCaptionAssetsEffect(base: LoroEntityDocument, rawInput: ApplyCaptionAssetsInput): CaptionAssetsEffectEnvelope;
+/**
+ * Compile only a frozen envelope on its exact causal baseline. Collaborators
+ * receive the resulting Loro update, never the raw effect.
+ */
+declare function compileCaptionAssetsEffect(base: LoroEntityDocument, envelope: CaptionAssetsEffectEnvelope): CompiledCaptionAssetsEffect;
+/** Freeze the explicit insertion anchor and lineage on one causal baseline. */
+declare function prepareGeneratedVisualEffect(base: LoroEntityDocument, rawInput: AddGeneratedVisualsInput): GeneratedVisualEffectEnvelope;
+declare function prepareContinueVideoEffect(base: LoroEntityDocument, input: ContinueVideoInput): GeneratedVisualEffectEnvelope;
+/** Compile once at the FE authority; retain the returned update bytes for retry and collaborators. */
+declare function compileGeneratedVisualEffect(base: LoroEntityDocument, envelope: GeneratedVisualEffectEnvelope): CompiledGeneratedVisualEffect;
+declare function prepareSpeechAssetsEffect(base: LoroEntityDocument, rawInput: SpeechAssetsEffectInput): SpeechAssetsEffectEnvelope;
+/** Compile once at the FE authority; retain the returned update bytes for retry and collaborators. */
+declare function compileSpeechAssetsEffect(base: LoroEntityDocument, envelope: SpeechAssetsEffectEnvelope): CompiledSpeechAssetsEffect;
 //#endregion
 //#region src/entity-editor/editor-resources.d.ts
 declare const roleOrder: {
@@ -652,6 +1035,12 @@ interface ImportedMediaAsset {
   /** The timbre identity of a synthesized voiceover; absent for recorded media. */
   readonly voiceEntityId?: string;
 }
+interface ImportedCaptionAsset {
+  readonly rows: EntityRelationRows;
+  readonly assetEntityId: string;
+}
+/** Import only the fixed ASR artifact; Caption entities are authored separately. */
+declare function importCaptionAsset(initial: EntityRelationRows, fact: CaptionAssetFact, idFactory?: EntityTimelineIdFactory): ImportedCaptionAsset;
 /**
  * Import at the editor boundary, not at asset generation time. Existing
  * provenance is retained.
@@ -694,169 +1083,6 @@ interface DocumentAudioScriptState {
 /** Read only the attached version and preserve every segment; never aggregate other scripts. */
 declare function readDocumentAudioScript(state: DocumentAudioScriptState): DocumentAudioScript;
 //#endregion
-//#region src/entity-crdt/field-changes.d.ts
-/** List members are addressed by identity, never a transient array offset. */
-type FieldPath = readonly (string | {
-  elementId: string;
-})[];
-type FieldChange = {
-  op: 'set';
-  path: FieldPath;
-  value: JsonValue;
-} | {
-  op: 'unset';
-  path: FieldPath;
-} | {
-  op: 'text.splice';
-  path: FieldPath;
-  index: number;
-  deleteCount: number;
-  text: string;
-} | {
-  op: 'list.insert';
-  path: FieldPath;
-  value: JsonValue;
-  beforeElementId: string | null;
-} | {
-  op: 'list.move';
-  path: FieldPath;
-  elementId: string;
-  beforeElementId: string | null;
-} | {
-  op: 'list.remove';
-  path: FieldPath;
-  elementId: string;
-};
-declare function assertFieldChanges(changes: readonly FieldChange[]): void;
-/** Resolve against the sequential causal view; the numeric path never crosses the API boundary. */
-declare function resolveFieldPath(payload: JsonObject, path: FieldPath): (string | number)[];
-/** Detached plan evaluation. Native compilation replays the original operations, not this snapshot. */
-declare function applyFieldChanges(payload: JsonObject, changes: readonly FieldChange[]): JsonObject;
-//#endregion
-//#region src/entity-crdt/entity-document.d.ts
-declare const LORO_ENTITY_SCHEMA = "medeo.entities.loro.v1";
-interface EntityDocumentState {
-  readonly rows: EntityRelationRows;
-  readonly project: Readonly<Record<string, string>>;
-}
-type Command = {
-  type: 'create';
-  row: EntityRow;
-} | {
-  type: 'selection-baseline';
-  root: string;
-  fingerprint: string;
-} | {
-  type: 'order';
-  group: string;
-  roots: string[];
-  token: string;
-} | {
-  type: 'write';
-  root: string;
-  payload: JsonObject;
-  token: string;
-} | {
-  type: 'text';
-  root: string;
-  path: readonly (string | number)[];
-  start: number;
-  deleteCount: number;
-  text: string;
-  token: string;
-} | {
-  type: 'field';
-  root: string;
-  path: (string | number)[];
-  change: FieldChange;
-  token: string;
-} | {
-  type: 'relation-field';
-  root: string;
-  path: (string | number)[];
-  change: FieldChange;
-} | {
-  type: 'delete';
-  root: string;
-} | {
-  type: 'relation';
-  row: RelationRow;
-} | {
-  type: 'relation-fields';
-  root: string;
-  metadata: JsonObject;
-  trace: JsonObject;
-} | {
-  type: 'unlink';
-  root: string;
-} | {
-  type: 'attach';
-  slot: string;
-  entityId: string;
-};
-/** Plain domain objects assembled from native Loro state, never a second writable authority. */
-declare function readEntityDocument(doc: LoroDoc, allowSelectionConflicts?: boolean): EntityDocumentState;
-/** Native editing containers survive domain version changes and merge independently. */
-declare class LoroEntityDocument {
-  readonly doc: LoroDoc;
-  private readonly validate?;
-  private readonly undoManager;
-  constructor(doc: LoroDoc, validate?: ((state: EntityDocumentState) => void) | undefined);
-  /** Open a causal snapshot using the same Loro runtime as the compiler. */
-  static fromSnapshot(snapshot: Uint8Array, validate?: (state: EntityDocumentState) => void): LoroEntityDocument;
-  static create(rows: EntityRelationRows, project?: Readonly<Record<string, string>>, peerId?: PeerID): LoroEntityDocument;
-  snapshot(): EntityDocumentState;
-  relationsOf(entityId: string): readonly RelationRow[];
-  /** Resolve a queued edit target through its native identity without changing history. */
-  resolveCurrentEntityId(id: string): string;
-  getVersion(id: string): EntityRow | undefined;
-  /** The callback and every domain validation execute on a causally complete fork first. */
-  transact(edit: (draft: LoroEntityDraft) => void): Uint8Array;
-  /** Import preserves native operation identities; projection errors never discard remote operations. */
-  import(update: Uint8Array): void;
-  /**
-   * Bind a saved snapshot without rewriting text operations or resolving
-   * selection conflicts. The script names the bytes the same way everything
-   * else does — an Asset entity plus a Relation — and keeps only the
-   * fingerprint that tells a stale snapshot from a current one. The Relation is
-   * `to-asset`: these bytes are the script's own content written out, not a
-   * source it was made from.
-   */
-  bindAudioScriptAsset(entityId: string, assetId: string, expectedContentHash: string): Uint8Array;
-  canUndo(): boolean;
-  canRedo(): boolean;
-  undo(): boolean;
-  redo(): boolean;
-  private historyEdit;
-}
-declare class LoroEntityDraft {
-  private readonly doc;
-  readonly commands: Command[];
-  private readonly selectedRoots;
-  private readonly relationAliases;
-  constructor(doc: LoroDoc);
-  snapshot(): EntityDocumentState;
-  order(groupId: string, entityIds: readonly string[]): void;
-  /** Project the final scalar placement intents onto the existing native ordering containers. */
-  reconcileOrder(rows: EntityRelationRows): void;
-  create(row: EntityRow): void;
-  delete(entityId: string): void;
-  attach(slot: string, entityId: string): void;
-  link(row: RelationRow): void;
-  patchRelation(relationId: string, metadata: JsonObject, trace: JsonObject): void;
-  unlink(relationId: string): void;
-  private relationRoot;
-  update(entityId: string, fields: JsonObject): void;
-  declare(entityId: string, fields: JsonObject): void;
-  replaceOwned(entityId: string, payload: JsonObject): void;
-  editText(entityId: string, path: readonly (string | number)[], start: number, deleteCount: number, text: string): void;
-  /** Generic assembled-field edit compiled at the author's causal position. */
-  change(entityId: string, changes: readonly FieldChange[]): void;
-  changeRelation(relationId: string, changes: readonly FieldChange[]): void;
-  captureSelectionBaselines(): void;
-  private record;
-}
-//#endregion
 //#region src/entity-crdt/compile-rows.d.ts
 /** Lower a detached ordinary-object edit against its actual causal Loro baseline. */
 declare function compileEntityRows(snapshot: Uint8Array, rows: EntityRelationRows, validate?: (state: EntityDocumentState) => void): {
@@ -1765,4 +1991,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, 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, 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, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { type AddGeneratedVisualsInput, type AddSpeechAssetsInput, type Aggregation, type ApplyCaptionAssetsInput, type ApplyCaptionAssetsResult, type AsrCaptionSegment, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionAssetFact, type CaptionAssetsEffectEnvelope, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, type CompiledCaptionAssetsEffect, type CompiledGeneratedVisualEffect, type CompiledSpeechAssetsEffect, type ContinueVideoInput, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, type GeneratedSpeechCaptionFact, type GeneratedSpeechFact, type GeneratedSpeechSourceFact, type GeneratedVisualClipFact, type GeneratedVisualEffectEnvelope, type GeneratedVisualEffectResult, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedCaptionAsset, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplaceVoiceSpeechAssetsInput, type ReplacementMediaClipInput, type ResolvedAsrSpeechSegment, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ResolvedSpeechScriptSegment, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SetVideoClipSpeedEffectInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechAssetsEffectEnvelope, type SpeechAssetsEffectInput, type SpeechAssetsEffectResult, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoClipSpeedMode, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileCaptionAssetsEffect, compileEntityRows, compileGeneratedVisualEffect, compileSpeechAssetsEffect, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importCaptionAsset, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionAssetsEffect, prepareCaptionContent, prepareContinueVideoEffect, prepareGeneratedVisualEffect, prepareSpeechAssetsEffect, projectEntityTimeline, readDocumentAudioScript, readEntityDocument, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };