@mengine/medeo-client 2.1.1-dsl.9 → 3.0.0

package/dist/{index-C5wDKYqC.d.ts → index-DuM7I4Ku.d.ts}

@@ -1,6 +1,340 @@
-import { B as PhonemeSelection, J as SegmentSelection, L as FieldPatch, M as DslMutation, R as MedeoDslSnapshot, T as CaptionStyle, Y as StoredFile, Z as TextEdit, c as VideoDraftInput, h as DslIdFactory, it as Voice, j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions, q as SegmentRange, rt as TrackRole, tt as TimeAnchor, w as CaptionSelection, z as Media } from "./video-draft-types-GqXnsOzA.js";
 import { ContainerType, Cursor, LoroDoc, PeerID, TreeID } from "loro-crdt";
 
+//#region ../medeo-dsl/src/types.d.ts
+type TrackRole = 'video_clip' | 'speech' | 'caption' | 'bgm';
+type ResourceSystem = 'memota' | 'memota-speech';
+interface Track$1 {
+  role: TrackRole;
+  hidden?: boolean;
+}
+/**
+ * How a Clip plays its content: the window it takes from the source, its pace, and whether it
+ * fills the Timeline. One value: concurrent edits of the same marker keep one whole marker.
+ */
+interface SeqMarker {
+  inMs: number;
+  outMs: number;
+  rate?: number;
+  fillTimeline?: true;
+}
+/**
+ * Where a Clip starts: at an absolute time on the Timeline, or following another Clip. No anchor
+ * means it plays in Tree order. One value, so concurrent placements keep one whole placement.
+ */
+interface TimeAnchor {
+  /** The Timeline (absolute) or another Clip (following). */
+  to: string;
+  offsetMs: number;
+  /** The absolute start recorded by the placement edit; used when the anchor cannot be solved. */
+  fallback_abs_ms: number;
+}
+/** A Clip's single-valued relations are fields of its own row: its content and its time anchor. */
+interface Clip {
+  seqMarker: SeqMarker;
+  volume?: number;
+  /** The media or Caption this use plays. */
+  source: string;
+  anchor?: TimeAnchor;
+}
+interface MediaLocator {
+  system: ResourceSystem;
+  key: string;
+  digest?: string;
+}
+type Media = MediaLocator & ({
+  kind: 'video';
+  durationMs: number;
+  storageKey?: string;
+} | {
+  kind: 'audio' | 'voiceover-recording';
+  durationMs: number;
+  storageKey: string;
+} | {
+  kind: 'image';
+  storageKey?: string;
+});
+/** One segment of a script: its own text, and the id a Caption or PhoneticScript names it by. */
+interface AudioScriptSegment {
+  id: string;
+  text: string;
+  /**
+   * Where these words were spoken in the medium the script was read off, as the transcription
+   * file it names gave them (D186). Only a transcript's segments state it, both ends together.
+   */
+  startMs?: number;
+  endMs?: number;
+}
+/**
+ * A script is segmented text: its segments in order (D181). A transcript names the transcription
+ * file its words and times were read from (D186); a written script names none.
+ */
+interface AudioScript extends Partial<StoredFile> {
+  segments: AudioScriptSegment[];
+  defaultLanguage?: string;
+}
+interface CaptionStyle$1 {
+  font?: {
+    system: 'font-library';
+    key: string;
+  };
+  fontSize?: number;
+  fontColor?: string;
+  fontWeight?: number;
+  entranceAnimation?: string;
+  entranceAnimationDurationMs?: number;
+  strokeColor?: string;
+  strokeWidth?: number;
+  /** The caption's center across the frame, from 0 at the left edge to 1 at the right. */
+  positionX?: number;
+  /** The caption's center down the frame, from 0 at the top edge to 1 at the bottom. */
+  positionY?: number;
+}
+/**
+ * What a Caption shows or a PhoneticScript is written for: one segment of a script, or a run inside
+ * it (D181). The run's ends are Cursors on that segment's Text, so they follow its edits; without
+ * them the whole segment is meant, whatever it comes to say. One value: taken or replaced whole.
+ */
+interface SegmentSelection {
+  audioScriptId: string;
+  segmentId: string;
+  start?: Cursor;
+  end?: Cursor;
+}
+type CaptionContent = SegmentSelection;
+/** Words come from a selected run of a script or from the Caption's own text, never both. */
+interface Caption {
+  selection?: CaptionContent;
+  text?: string;
+  style?: CaptionStyle$1;
+}
+/** The segment a PhoneticScript is written for, selected as a Caption selects one, and its pronunciation. */
+interface Phoneme extends SegmentSelection {
+  /** What the voice synthesizes for that selection, written in what the voice accepts. */
+  phonemeScript?: string;
+}
+/** A file Memota stored from raw content: how a Media File entity names it, and its digest. */
+interface StoredFile {
+  system: 'memota';
+  key: string;
+  storageKey?: string;
+  digest: string;
+}
+/**
+ * A variant of an AudioScript: the segment it is written for, plus what to synthesize. It has the Media File
+ * trait (D178): its `phonemeScript` is raw content, stored in Memota as a text file whenever it is
+ * written, and the file's facts are kept beside it. Without a `phonemeScript` it has no file.
+ */
+interface PhoneticScript extends Partial<StoredFile> {
+  phoneme: Phoneme;
+}
+interface Voice {
+  system: 'voice-library';
+  key: string;
+  name?: string;
+}
+/** Table keys carry entity identity; values never duplicate an id or a single-table kind. */
+interface EntityValues {
+  'timeline-entities': Record<string, never>;
+  'track-entities': Track$1;
+  'clip-entities': Clip;
+  'media-entities': Media;
+  'audio-script-entities': AudioScript;
+  'phonetic-script-entities': PhoneticScript;
+  'caption-entities': Caption;
+  'voice-entities': Voice;
+}
+/** Only relations an entity may hold many of have tables; single-valued ones are fields of their owner. */
+interface RelationValues {
+  'voice-timbre-relations': {
+    recordingId: string;
+    voiceId: string;
+  };
+  /**
+   * `sourceDigest`: the source's digest when the product was made from it (D177). A product whose
+   * source's digest differs now was made from content the source no longer has.
+   */
+  'derived-from-relations': {
+    entityId: string;
+    sourceId: string;
+    sourceDigest?: string;
+  };
+}
+/** What a create states: a PhoneticScript's phoneme may follow by set-phoneme in the same write. */
+type EntityInput = Omit<EntityValues, 'phonetic-script-entities'> & {
+  'phonetic-script-entities': Omit<PhoneticScript, 'phoneme'> & {
+    phoneme?: Phoneme;
+  };
+};
+type EntityTable = keyof EntityValues;
+type RelationTable = keyof RelationValues;
+type EntityTables = { [K in EntityTable]: Record<string, EntityValues[K]> };
+type RelationTables = { [K in RelationTable]: Record<string, RelationValues[K]> };
+type FieldPatch<T> = { [K in keyof T]?: NonNullable<T[K]> extends object ? FieldPatch<NonNullable<T[K]>> : T[K] | undefined };
+type EntityMutation = { [K in EntityTable]: {
+  type: 'create-entity';
+  table: K;
+  id: string;
+  value: EntityInput[K];
+} | {
+  type: 'patch-entity';
+  table: K;
+  id: string;
+  patch: FieldPatch<EntityValues[K]>;
+} | {
+  type: 'delete-entity';
+  table: K;
+  id: string;
+} }[EntityTable];
+type RelationMutation = { [K in RelationTable]: {
+  type: 'set-relation';
+  table: K;
+  value: RelationValues[K];
+} | {
+  type: 'delete-relation';
+  table: K;
+  id: string;
+} }[RelationTable];
+type ContainMutation = {
+  type: 'insert-node';
+  entityId: string;
+  parentId?: string;
+  index?: number;
+} | {
+  type: 'move-node';
+  entityId: string;
+  parentId?: string;
+  index?: number;
+} | {
+  type: 'delete-node';
+  entityId: string;
+};
+/** A segment, or a run of it in UTF-16 offsets of its current text, as a write states it. */
+interface SegmentRange {
+  audioScriptId: string;
+  segmentId: string;
+  start?: number;
+  end?: number;
+}
+interface CaptionSelection extends SegmentRange {
+  captionId: string;
+}
+interface PhonemeSelection extends SegmentRange {
+  phoneticScriptId: string;
+  phonemeScript?: string;
+}
+/** A script's segments are added, moved and removed by id; their text is edited in place. */
+type SegmentMutation = {
+  type: 'insert-segment';
+  audioScriptId: string;
+  segmentId: string;
+  index?: number;
+  text: string;
+  startMs?: number;
+  endMs?: number;
+} | {
+  type: 'move-segment';
+  audioScriptId: string;
+  segmentId: string;
+  index: number;
+} | {
+  type: 'delete-segment';
+  audioScriptId: string;
+  segmentId: string;
+};
+type TextMutation = {
+  type: 'edit-caption-text';
+  captionId: string;
+  expectedBodyId?: string;
+  edits: readonly TextEdit[];
+} | {
+  type: 'edit-text';
+  audioScriptId: string;
+  segmentId: string;
+  expectedBodyId?: string;
+  edits: readonly TextEdit[];
+} | ({
+  type: 'set-caption-content';
+} & CaptionSelection) | ({
+  type: 'set-phoneme';
+} & PhonemeSelection);
+type DslMutation = EntityMutation | RelationMutation | ContainMutation | SegmentMutation | TextMutation;
+interface ContainNode {
+  treeId: TreeID;
+  entityId: string;
+  children: ContainNode[];
+}
+interface DslDiagnostic {
+  code: string;
+  path: string;
+  message: string;
+}
+interface TextRun {
+  insert: string;
+  attributes?: Record<string, unknown>;
+}
+interface RichTextSnapshot {
+  bodyId: string;
+  plainText: string;
+  delta: TextRun[];
+}
+/** Selected text, with its UTF-16 range in the Text it lies in: the segment's, or a Caption's own. */
+interface CaptionText {
+  text: string;
+  start: number;
+  end: number;
+  bodyId: string;
+}
+type DeepReadonly<T> = T extends Cursor ? T : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
+type MedeoDslSnapshot = DeepReadonly<EntityTables & RelationTables & {
+  'contain-relations': ContainNode[]; /** A Caption's own text by the Caption's id, and each script segment's text by the segment's id. */
+  richText: Record<string, RichTextSnapshot>;
+  captionText: Record<string, CaptionText>; /** What each PhoneticScript's selection holds now, resolved as a Caption's is. */
+  phoneticText: Record<string, CaptionText>;
+  diagnostics: DslDiagnostic[];
+}>;
+type TextMark = 'language';
+type TextEdit = {
+  type: 'insert';
+  at: number;
+  text: string;
+} | {
+  type: 'delete';
+  at: number;
+  length: number;
+} | {
+  type: 'mark';
+  start: number;
+  end: number;
+  key: TextMark;
+  value: string;
+} | {
+  type: 'unmark';
+  start: number;
+  end: number;
+  key: TextMark;
+} | {
+  type: 'delta';
+  delta: TextDelta[];
+};
+type TextDelta = {
+  insert: string;
+  attributes?: Record<string, string | number | null>;
+} | {
+  retain: number;
+  attributes?: Record<string, string | number | null>;
+} | {
+  delete: number;
+};
+//#endregion
+//#region ../medeo-dsl/src/ids.d.ts
+declare function tupleHash(tuple: readonly string[]): string;
+declare function resourceId(kind: 'media' | 'voice', system: string, key: string): string;
+declare function relationId<K extends RelationTable>(table: K, value: RelationValues[K]): string;
+/** Kinds of id a document mints: its entities', and a script segment's. */
+type EntityIdKind = 'timeline' | 'track' | 'clip' | 'audio-script' | 'segment' | 'phonetic-script' | 'caption';
+type DslIdFactory = (kind: EntityIdKind) => string;
+declare const defaultIdFactory: DslIdFactory;
+//#endregion
 //#region src/dsl/action-context.d.ts
 type ClipPlacement = {
   kind: 'sequential';
@@ -58,7 +392,19 @@ interface DslClipUpdate {
   placement?: ClipPlacement;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.1/node_modules/loro-mirror/dist/schema/types.d.ts
+//#region src/dsl/commit-options.d.ts
+/** Self-reported audit author; authorization remains the server's responsibility. */
+interface OpActor {
+  user_id: string;
+  role: 'user' | 'agent';
+}
+interface CommitOptions {
+  /** The server audit view exposes string intents; other JSON values remain in the native message. */
+  intent?: unknown;
+  actor?: OpActor;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/loro-mirror@2.3.3_patch_hash=a551a0e4aa4f61ec88b0d9e970a183b5ee2955107a2e0bb03b378bc510c2f395_loro-crdt@1.16.4/node_modules/loro-mirror/dist/schema/types.d.ts
 /**
  * Options for schema definitions
  */
@@ -464,12 +810,20 @@ declare const medeoDslLoroShape: RootSchemaType<{
   'audio-script-entities': LoroMapSchemaWithCatchall<{}, LoroMapSchema<{
     segments: /*elided*/any;
     defaultLanguage: /*elided*/any;
+    system: /*elided*/any;
+    key: /*elided*/any;
+    storageKey: /*elided*/any;
+    digest: /*elided*/any;
   }> & {
     options: {};
   } & {
     catchall: <C extends SchemaType>(catchallSchema: C) => LoroMapSchemaWithCatchall<{
       segments: /*elided*/any;
       defaultLanguage: /*elided*/any;
+      system: /*elided*/any;
+      key: /*elided*/any;
+      storageKey: /*elided*/any;
+      digest: /*elided*/any;
     }, C>;
   }> & {
     options: {};
@@ -629,8 +983,14 @@ interface DslTransaction {
   /** Offsets use the preview after preceding edits. Existing Text identities are checked when supplied. */
   editText(audioScriptId: string, segmentId: string, edits: readonly TextEdit[], expectedBodyId?: string): void;
   editCaptionText(captionId: string, edits: readonly TextEdit[], expectedBodyId?: string): void;
-  /** Adds a segment at `index` (the end by default); its id must be new to the script. */
-  insertSegment(audioScriptId: string, segmentId: string, text: string, index?: number): void;
+  /**
+   * Adds a segment at `index` (the end by default); its id must be new to the script. A transcript's
+   * segment states where its words were spoken in the medium, as its transcription file gave them.
+   */
+  insertSegment(audioScriptId: string, segmentId: string, text: string, index?: number, time?: {
+    startMs: number;
+    endMs: number;
+  }): void;
   /** `index` is measured after removing the segment. */
   moveSegment(audioScriptId: string, segmentId: string, index: number): void;
   deleteSegment(audioScriptId: string, segmentId: string): void;
@@ -700,7 +1060,7 @@ interface VoiceoverCaptionInput {
     start: number;
     end: number;
   };
-  style?: CaptionStyle;
+  style?: CaptionStyle$1;
 }
 interface ApplyVoiceoverInput {
   clipId?: string;
@@ -738,7 +1098,10 @@ interface ApplyVoiceoverInput {
   sourceDigest?: string;
   volume?: number;
   voice?: Voice;
-  /** Complete generated caption set for this use. Other uses of the recording are untouched. */
+  /**
+   * Complete generated caption set for this use. It replaces the Caption Clips showing what the
+   * use's current take says: those whose Caption selects it (D183).
+   */
   captions: readonly VoiceoverCaptionInput[];
 }
 interface VoiceoverResult {
@@ -794,7 +1157,7 @@ declare class DslEditor {
     start?: never;
     end?: never;
   }) & {
-    style?: CaptionStyle;
+    style?: CaptionStyle$1;
   }, options?: CommitOptions): string;
   /** Show a segment of a script, or a run of it, in place of the Caption's own text. */
   setCaptionContent(captionId: string, selection: SegmentRange, options?: CommitOptions): void;
@@ -812,7 +1175,7 @@ declare class DslEditor {
   }, options?: CommitOptions): void;
   replaceClips(input: ReplaceDslClipsInput, options?: CommitOptions): string[];
   updateClips(updates: readonly DslClipUpdate[], options?: CommitOptions): void;
-  patchCaptionStyle(captionIds: readonly string[], patch: FieldPatch<CaptionStyle>, options?: CommitOptions): void;
+  patchCaptionStyle(captionIds: readonly string[], patch: FieldPatch<CaptionStyle$1>, options?: CommitOptions): void;
   applyVoiceover(input: ApplyVoiceoverInput, options?: CommitOptions): VoiceoverResult;
   private voiceoverScriptId;
   /**
@@ -877,6 +1240,538 @@ declare class DslProjectionError extends Error {
 /** Pure deterministic solve. Constraints only move sequential roots; anchors retain their exact offsets. */
 declare function resolveDslLayout(snapshot: MedeoDslSnapshot): DslLayout;
 //#endregion
+//#region src/dsl/projection/generated/video-draft-idl.d.ts
+/**
+ * @generated by @mengine/idl-codegen — DO NOT EDIT MANUALLY.
+ *
+ * VideoDraft read-view types extracted from the Smithy IDL
+ * (medeo-v2-design-materials). Re-run `vp run @mengine/idl-codegen#sync`.
+ * Source IDL commit: 902e82e3fec1e94b36e14ef671de91abd210dc86
+ *
+ * WHY EVERY FIELD IS `T | undefined`:
+ * AWS `smithy-typescript-codegen` widens every structure member to
+ * `T | undefined` regardless of the Smithy `@required` trait — it favours
+ * deserialization robustness (a peer may omit a field on the wire) over
+ * encoding requiredness in the static type. So these generated types are NOT
+ * the source of truth for which fields are required: the Smithy `.smithy`
+ * model is. Many fields here (e.g. `VideoClipPart.play_in` / `play_out` /
+ * `volume` / `origin_media_id`) are `@required` in the contract.
+ *
+ * Requiredness is restored by import and write-time validation, not here.
+ * DSL content constraints are owned by medeo-dsl and enforced at the medeo-client
+ * transaction and import boundaries.
+ * Do not assume a
+ * field is optional just because its type is `| undefined`.
+ */
+/**
+ * @public
+ * @enum
+ */
+declare const PartKind: {
+  readonly BGM: "bgm";
+  readonly CAPTION: "caption";
+  readonly SPEECH: "speech";
+  readonly VIDEO_CLIP: "video_clip";
+};
+/**
+ * @public
+ */
+type PartKind = (typeof PartKind)[keyof typeof PartKind];
+/**
+ * @public
+ */
+interface VoiceSummary {
+  name: string | undefined;
+  id: string | undefined;
+}
+/**
+ * @public
+ */
+interface SpeechPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  audio_script: string | undefined;
+  volume: number | undefined;
+  audio_storage_key: string | undefined;
+  origin_speech_id: string | undefined;
+  voice: VoiceSummary | undefined;
+  caption_ids: string[] | undefined;
+}
+/**
+ * Caption visual style configuration
+ * @public
+ */
+interface CaptionStyle {
+  /**
+   * Font ID referencing a font from the font library. Defaults to system font if not provided
+   * @public
+   */
+  font_id?: string | undefined;
+  /**
+   * Font size in points
+   * @public
+   */
+  font_size?: number | undefined;
+  /**
+   * Font color as hex string (e.g. "#FFFFFF")
+   * @public
+   */
+  font_color?: string | undefined;
+  /**
+   * Numeric font weight, e.g. 400 for regular or 700 for bold
+   * @public
+   */
+  font_weight?: number | undefined;
+  /**
+   * Caption entrance animation preset ID, e.g. "fade", "slideUp", or "none"
+   * @public
+   */
+  entrance_animation?: string | undefined;
+  /**
+   * Caption entrance animation duration in milliseconds
+   * @public
+   */
+  entrance_animation_duration_ms?: number | undefined;
+  /**
+   * Caption outline/stroke color as hex string (e.g. "#000000")
+   * @public
+   */
+  stroke_color?: string | undefined;
+  /**
+   * Caption outline/stroke width in pixels
+   * @public
+   */
+  stroke_width?: number | undefined;
+  /**
+   * Caption center X position as a percentage (0.0 to 1.0)
+   * @public
+   */
+  position_x?: number | undefined;
+  /**
+   * Caption center Y position as a percentage (0.0 to 1.0)
+   * @public
+   */
+  position_y?: number | undefined;
+}
+/**
+ * @public
+ */
+interface CaptionPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  speech_part_id: string | undefined;
+  text: string | undefined;
+  start_ms: number | undefined;
+  /**
+   * Caption visual style (font, size, color, weight, animation, outline). Uses default style if not provided
+   * @public
+   */
+  style?: CaptionStyle | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+declare const AspectRatio: {
+  readonly RATIO_16_9: "16:9";
+  readonly RATIO_9_16: "9:16";
+};
+/**
+ * @public
+ */
+type AspectRatio = (typeof AspectRatio)[keyof typeof AspectRatio];
+/**
+ * @public
+ * @enum
+ */
+declare const AssetSource: {
+  readonly AI_IMAGES: "ai_images";
+  readonly AI_VIDEOS: "ai_videos";
+  readonly MY_UPLOADED_ASSETS: "my_uploaded_assets";
+  readonly STOCK_VIDEOS: "stock_videos";
+};
+/**
+ * @public
+ */
+type AssetSource = (typeof AssetSource)[keyof typeof AssetSource];
+/**
+ * An extra aspect ratio variant with independent storage keys for thumbnail,
+ * preview video, and highlight video. Stored inside video_settings JSONB.
+ * @public
+ */
+interface RatioVariant {
+  aspect_ratio: string | undefined;
+  thumb_storage_key: string | undefined;
+  video_storage_key: string | undefined;
+  highlight_video_storage_key?: string | undefined;
+}
+/**
+ * @public
+ */
+interface VideoCreationSettings$1 {
+  voice_id?: string | undefined;
+  duration_ms?: number | undefined;
+  aspect_ratio?: AspectRatio | undefined;
+  video_style_id?: string | undefined;
+  asset_sources?: AssetSource[] | undefined;
+  recipe_id?: string | undefined;
+  enable_high_cost_confirm?: boolean | undefined;
+  user_confirm_cost_threshold?: number | undefined;
+  /**
+   * Extra aspect ratio variants with independent storage keys.
+   * Each variant carries its own thumbnail, preview video, and optional highlight video.
+   * Used when a recipe supports multiple aspect ratios (e.g. both 16:9 and 9:16).
+   * @public
+   */
+  extra_ratios?: RatioVariant[] | undefined;
+}
+/**
+ * @public
+ */
+interface TrackItem {
+  abs_time_position: number | undefined;
+  part_id: string | undefined;
+}
+/**
+ * @public
+ */
+interface Track {
+  id: string | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  parts_kind: PartKind | undefined;
+  is_hidden: boolean | undefined;
+  items: TrackItem[] | undefined;
+}
+/**
+ * @public
+ */
+interface Attachment {
+  part_id: string | undefined;
+  relative_time_position: number | undefined;
+}
+/**
+ * @public
+ */
+interface PartAggregation {
+  body_part_id: string | undefined;
+  attachments: Attachment[] | undefined;
+}
+/**
+ * @public
+ */
+interface BgmPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  audio_storage_key: string | undefined;
+  volume: number | undefined;
+  origin_media_id: string | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+declare const SpeedShiftCategory: {
+  /**
+   * Variable speed controlled by Bezier keyframes
+   */
+  readonly CURVE: "curve";
+  /**
+   * Constant speed multiplier across the entire clip
+   */
+  readonly LINEAR: "linear";
+};
+/**
+ * @public
+ */
+type SpeedShiftCategory = (typeof SpeedShiftCategory)[keyof typeof SpeedShiftCategory];
+/**
+ * @public
+ */
+interface TangentHandle {
+  x: number | undefined;
+  y: number | undefined;
+}
+/**
+ * @public
+ */
+interface SpeedKeyframe {
+  position: number | undefined;
+  rate: number | undefined;
+  in_tangent?: TangentHandle | undefined;
+  out_tangent?: TangentHandle | undefined;
+}
+/**
+ * @public
+ */
+interface CurveConfig {
+  keyframes: SpeedKeyframe[] | undefined;
+}
+/**
+ * @public
+ */
+interface LinearConfig {
+  speed: number | undefined;
+}
+/**
+ * @public
+ */
+type SpeedShiftConfigUnion = SpeedShiftConfigUnion.CurveMember | SpeedShiftConfigUnion.LinearMember | SpeedShiftConfigUnion.$UnknownMember;
+/**
+ * @public
+ */
+declare namespace SpeedShiftConfigUnion {
+  interface LinearMember {
+    linear: LinearConfig;
+    curve?: never;
+    $unknown?: never;
+  }
+  interface CurveMember {
+    linear?: never;
+    curve: CurveConfig;
+    $unknown?: never;
+  }
+  /**
+   * @public
+   */
+  interface $UnknownMember {
+    linear?: never;
+    curve?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    linear: (value: LinearConfig) => T;
+    curve: (value: CurveConfig) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: SpeedShiftConfigUnion, visitor: Visitor<T>) => T;
+}
+/**
+ * @public
+ */
+interface SpeedShift {
+  category: SpeedShiftCategory | undefined;
+  mode: string | undefined;
+  config: SpeedShiftConfigUnion | undefined;
+}
+/**
+ * @public
+ */
+interface VideoClipPart {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  play_in: number | undefined;
+  play_out: number | undefined;
+  volume: number | undefined;
+  origin_media_id: string | undefined;
+  speed_shift?: SpeedShift | undefined;
+}
+/**
+ * @public
+ */
+type PartUnion = PartUnion.BgmMember | PartUnion.CaptionMember | PartUnion.SpeechMember | PartUnion.Video_clipMember | PartUnion.$UnknownMember;
+/**
+ * @public
+ */
+declare namespace PartUnion {
+  interface Video_clipMember {
+    video_clip: VideoClipPart;
+    bgm?: never;
+    speech?: never;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface BgmMember {
+    video_clip?: never;
+    bgm: BgmPart$1;
+    speech?: never;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface SpeechMember {
+    video_clip?: never;
+    bgm?: never;
+    speech: SpeechPart$1;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface CaptionMember {
+    video_clip?: never;
+    bgm?: never;
+    speech?: never;
+    caption: CaptionPart$1;
+    $unknown?: never;
+  }
+  /**
+   * @public
+   */
+  interface $UnknownMember {
+    video_clip?: never;
+    bgm?: never;
+    speech?: never;
+    caption?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    video_clip: (value: VideoClipPart) => T;
+    bgm: (value: BgmPart$1) => T;
+    speech: (value: SpeechPart$1) => T;
+    caption: (value: CaptionPart$1) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: PartUnion, visitor: Visitor<T>) => T;
+}
+/**
+ * Timeline configuration for video editing
+ * @public
+ */
+interface Timeline {
+  duration_ms: number | undefined;
+  unit_time_ms: number | undefined;
+}
+/**
+ * Complete video draft information with timeline and tracks
+ * @public
+ */
+interface VideoDraft$1 {
+  id?: string | undefined;
+  project_id: string | undefined;
+  owner_id: string | undefined;
+  /**
+   * for-code-gen: property value may be empty string ("")
+   * @public
+   */
+  thumbnail_storage_key: string | undefined;
+  /**
+   * Timeline configuration for video editing
+   * @public
+   */
+  timeline?: Timeline | undefined;
+  video_creation_settings?: VideoCreationSettings$1 | undefined;
+  chat_session_id: string | undefined;
+  main_track?: Track | undefined;
+  above_main_tracks: Track[] | undefined;
+  below_main_tracks: Track[] | undefined;
+  part_aggregations: PartAggregation[] | undefined;
+  part_library: Record<string, PartUnion> | undefined;
+  version: number | undefined;
+}
+//#endregion
+//#region src/dsl/projection/video-draft-types.d.ts
+type VideoDraftTrack = Track;
+type VideoDraftTrackItem = TrackItem;
+type VideoDraftTimeline = Timeline;
+type VideoDraftCaptionStyle = CaptionStyle;
+interface CaptionDisplayCue {
+  segmentId: string;
+  text: string;
+  startMs: number;
+  durationMs: number;
+}
+type VideoCreationSettings = Omit<VideoCreationSettings$1, 'video_style_id' | 'duration_ms'> & {
+  video_style_id?: string | null;
+  duration_ms?: number | null;
+};
+type VideoPart = Omit<VideoClipPart, 'duration_ms'>;
+type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
+  media_duration_ms?: number;
+};
+type CaptionPart = Omit<CaptionPart$1, 'duration_ms'> & {
+  initial_duration_ms?: number;
+  display_cues?: CaptionDisplayCue[];
+};
+type BgmPart = Omit<BgmPart$1, 'duration_ms'>;
+/** Legacy inputs may omit derived durations; output always states the field. */
+type VideoDraftPartUnion = {
+  video_clip: VideoPart & {
+    duration_ms?: number;
+  };
+  speech?: never;
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    duration_ms?: number;
+  };
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption: CaptionPart & {
+    duration_ms?: number;
+  };
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption?: never;
+  bgm: BgmPart & {
+    duration_ms?: number;
+  };
+};
+type VideoDraftContentPartUnion = {
+  video_clip: VideoPart & {
+    duration_ms: number | undefined;
+  };
+  speech?: never;
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    duration_ms: number | undefined;
+  };
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption: CaptionPart & {
+    duration_ms: number | undefined;
+  };
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption?: never;
+  bgm: BgmPart & {
+    duration_ms: number | undefined;
+  };
+};
+type VideoDraft = Omit<VideoDraft$1, 'part_library' | 'video_creation_settings'> & {
+  part_library: Record<string, VideoDraftPartUnion> | undefined;
+  video_creation_settings?: VideoCreationSettings;
+};
+type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_main_tracks' | 'below_main_tracks' | 'part_aggregations'> & {
+  part_library: Record<string, VideoDraftContentPartUnion> | undefined;
+};
+type VideoDraftInput = Pick<VideoDraft, keyof VideoDraftContent>;
+declare const DEFAULT_UNIT_TIME_MS = 33.333;
+//#endregion
 //#region src/dsl/projection/to-video-draft.d.ts
 interface VideoDraftProjection {
   content: VideoDraftContent;
@@ -896,7 +1791,14 @@ interface AudioScriptView {
   segments: {
     id: string;
     text: string;
-    language?: string;
+    language?: string; /** A transcript's segment: where its words were spoken in the medium, as its transcription file gave them. */
+    startMs?: number;
+    endMs?: number;
+    /**
+     * Where that falls on the Timeline (D186): through the Clip playing the medium the script was
+     * read off whose window holds `startMs`. Absent when no Clip plays that moment.
+     */
+    timelineMs?: number;
   }[];
   /** Media the script was read off (a transcript), through derived-from. */
   sourceMediaIds: string[];
@@ -950,4 +1852,4 @@ interface ImportedVideoDraft {
 /** One-time import into a newly owned document; never reverse-diff a live collaborative document. */
 declare function fromVideoDraft(input: VideoDraftInput, options: FromVideoDraftOptions): ImportedVideoDraft;
 //#endregion
-export { MedeoDslDraft as A, UnsupportedDocumentFormatError as C, captionContentCodec as D, InvalidAtomic as E, ClipSource as F, DslClipUpdate as I, MoveDslClipsInput as L, medeoDslLoroShape as M, AddDslClip as N, isInvalidAtomic as O, AddDslClipsInput as P, ReplaceDslClipsInput as R, DslTransaction as S, documentFormat as T, VoiceoverCaptionInput as _, toAudioScriptViews as a, MedeoDsl as b, resolveDslLayout as c, DslProjectionError as d, DslTrackLayout as f, ApplyVoiceoverInput as g, UploadText as h, AudioScriptView as i, MedeoDslLoroState as j, timeAnchorCodec as k, DslClipLayout as l, DslEditor as m, ImportedVideoDraft as n, VideoDraftProjection as o, createInitialMedeoDsl as p, fromVideoDraft as r, toVideoDraft as s, FromVideoDraftOptions as t, DslLayout as u, VoiceoverResult as v, assertDslDocument as w, DslAudit as x, CreateMedeoDslOptions as y, ClipPlacement as z };
+export { ClipPlacement as $, VoiceoverResult as A, RichTextSnapshot as At, isInvalidAtomic as B, Voice as Bt, DslProjectionError as C, MedeoDslSnapshot as Ct, UploadText as D, RelationTables as Dt, DslEditor as E, RelationTable as Et, UnsupportedDocumentFormatError as F, TextMutation as Ft, CommitOptions as G, MedeoDslDraft as H, assertDslDocument as I, TextRun as It, AddDslClipsInput as J, OpActor as K, documentFormat as L, TimeAnchor as Lt, MedeoDsl as M, TextDelta as Mt, DslAudit as N, TextEdit as Nt, ApplyVoiceoverInput as O, RelationValues as Ot, DslTransaction as P, TextMark as Pt, ReplaceDslClipsInput as Q, InvalidAtomic as R, Track$1 as Rt, DslLayout as S, FieldPatch as St, createInitialMedeoDsl as T, RelationMutation as Tt, MedeoDslLoroState as U, timeAnchorCodec as V, medeoDslLoroShape as W, DslClipUpdate as X, ClipSource as Y, MoveDslClipsInput as Z, VideoDraftTimeline as _, DslMutation as _t, toAudioScriptViews as a, tupleHash as at, resolveDslLayout as b, EntityTables as bt, CaptionDisplayCue as c, CaptionContent as ct, VideoDraft as d, CaptionText as dt, DslIdFactory as et, VideoDraftCaptionStyle as f, Clip as ft, VideoDraftPartUnion as g, DslDiagnostic as gt, VideoDraftInput as h, DeepReadonly as ht, AudioScriptView as i, resourceId as it, CreateMedeoDslOptions as j, StoredFile as jt, VoiceoverCaptionInput as k, ResourceSystem as kt, DEFAULT_UNIT_TIME_MS as l, CaptionSelection as lt, VideoDraftContentPartUnion as m, ContainNode as mt, ImportedVideoDraft as n, defaultIdFactory as nt, VideoDraftProjection as o, AudioScript as ot, VideoDraftContent as p, ContainMutation as pt, AddDslClip as q, fromVideoDraft as r, relationId as rt, toVideoDraft as s, Caption as st, FromVideoDraftOptions as t, EntityIdKind as tt, VideoCreationSettings as u, CaptionStyle$1 as ut, VideoDraftTrack as v, EntityMutation as vt, DslTrackLayout as w, Media as wt, DslClipLayout as x, EntityValues as xt, VideoDraftTrackItem as y, EntityTable as yt, captionContentCodec as z, TrackRole as zt };