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

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

@@ -1,6 +1,340 @@
-import { C as CaptionContent, J as TextEdit, K as StoredFile, L as FieldPatch, M as DslMutation, Q as TimeAnchor, R as MedeoDslSnapshot, T as CaptionStyle, c as VideoDraftInput, et as TrackRole, h as DslIdFactory, j as DslDiagnostic, o as VideoDraftContent, p as CommitOptions, tt as Voice, w as CaptionSelection, z as Media } from "./video-draft-types-Bq15tPBP.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
  */
@@ -396,7 +742,7 @@ type InferBooleanType<S extends SchemaType> = S extends {
 //#endregion
 //#region ../medeo-dsl/src/schema/loro-shape.d.ts
 /**
- * Only direct children inherit mergeable identity. Body and ordinary entity rows keep normal
+ * Only direct children inherit mergeable identity. Text and ordinary entity rows keep normal
  * identities, so deleting a row also drops what a peer wrote into it concurrently: a relation an
  * entity holds at most one of is a field of that row and never outlives it.
  */
@@ -462,14 +808,22 @@ declare const medeoDslLoroShape: RootSchemaType<{
     };
   };
   'audio-script-entities': LoroMapSchemaWithCatchall<{}, LoroMapSchema<{
-    body: /*elided*/any;
+    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<{
-      body: /*elided*/any;
+      segments: /*elided*/any;
       defaultLanguage: /*elided*/any;
+      system: /*elided*/any;
+      key: /*elided*/any;
+      storageKey: /*elided*/any;
+      digest: /*elided*/any;
     }, C>;
   }> & {
     options: {};
@@ -598,8 +952,8 @@ interface AtomicCodec<T> {
 }
 /** A Clip's time anchor; the Clip holding it is the anchored end. */
 declare const timeAnchorCodec: AtomicCodec<TimeAnchor>;
-/** A Caption's selection; Cursors are stored as their native bytes in unpadded base64url. */
-declare const captionContentCodec: AtomicCodec<CaptionContent>;
+/** A Caption's selection. */
+declare const captionContentCodec: AtomicCodec<SegmentSelection>;
 //#endregion
 //#region ../medeo-dsl/src/schema/document-format.d.ts
 /** Format discrimination does not register containers or alter the document. */
@@ -627,10 +981,23 @@ interface DslTransaction {
   readonly draft: MedeoDslDraft;
   applyMutations(mutations: readonly DslMutation[]): void;
   /** Offsets use the preview after preceding edits. Existing Text identities are checked when supplied. */
-  editText(audioScriptId: string, edits: readonly TextEdit[], expectedBodyId?: string): void;
-  /** Creates real Cursors during application; pending ranges are not exposed as draft Cursor objects. */
+  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. 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;
+  /** Creates real Cursors during application; pending ranges are not exposed as draft Cursor objects. */
   setCaptionContent(selection: CaptionSelection): void;
+  /** Writes a PhoneticScript's phoneme, its run turned into Cursors like a Caption's. */
+  setPhoneme(selection: PhonemeSelection): void;
 }
 //#endregion
 //#region src/dsl/document/medeo-dsl.d.ts
@@ -668,10 +1035,13 @@ declare class MedeoDsl {
   transact(edit: (tx: DslTransaction) => void, audit: DslAudit): void;
   /** Preferred vocabulary for ordinary entity/relation/Tree edits and serializable native commands. */
   applyMutations(mutations: readonly DslMutation[], audit: DslAudit): void;
-  editText(scriptId: string, expectedBodyId: string, edits: readonly TextEdit[], audit: DslAudit): void;
+  editText(scriptId: string, segmentId: string, expectedBodyId: string, edits: readonly TextEdit[], audit: DslAudit): void;
   editCaptionText(captionId: string, expectedBodyId: string, edits: readonly TextEdit[], audit: DslAudit): void;
-  /** Local ranges exclude insertions at their start and include insertions at their end. K01 remains deferred. */
-  textRange(scriptId: string, start: number, end: number): CaptionContent;
+  /**
+   * A run inside one segment as native Cursors. Local ranges exclude insertions at their start and
+   * include insertions at their end. K01 remains deferred.
+   */
+  textRange(scriptId: string, segmentId: string, start: number, end: number): SegmentSelection;
   dispose(): void;
   private mutate;
   private notify;
@@ -683,12 +1053,14 @@ interface VoiceoverCaptionInput {
   clipId?: string;
   startMs: number;
   durationMs: number;
-  /** UTF-16 selection in the supplied AudioScript; timing remains a separate fact. */
-  range: {
+  /** The segment of the voiceover's script it shows, by index; timing remains a separate fact. */
+  segment: number;
+  /** A UTF-16 run inside that segment; without one the whole segment shows. */
+  range?: {
     start: number;
     end: number;
   };
-  style?: CaptionStyle;
+  style?: CaptionStyle$1;
 }
 interface ApplyVoiceoverInput {
   clipId?: string;
@@ -700,23 +1072,23 @@ interface ApplyVoiceoverInput {
     kind: 'voiceover-recording';
   };
   /**
-   * What the recording says: an existing AudioScript, a new one from `body`, or a PhoneticScript it
-   * was spoken from. A recording spoken from a PhoneticScript is derived-from it, and its captions
-   * select that variant's base script.
+   * What the recording says: an existing AudioScript, a new one of these `segments`, or a
+   * PhoneticScript it was spoken from. A recording spoken from a PhoneticScript is derived-from it,
+   * and its captions select segments of that variant's base script.
    */
   script: {
     audioScriptId: string;
-    body?: never;
+    segments?: never;
     phoneticScriptId?: never;
   } | {
-    body: string;
+    segments: string[];
     audioScriptId?: never;
     phoneticScriptId?: never;
     defaultLanguage?: string;
   } | {
     phoneticScriptId: string;
     audioScriptId?: never;
-    body?: never;
+    segments?: never;
   };
   placement: ClipPlacement;
   /**
@@ -726,13 +1098,18 @@ 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 {
   clipId: string;
   mediaId: string;
   audioScriptId: string;
+  /** Ids of a new script's segments, in order; empty when the script already exists. */
+  segmentIds: string[];
   captionClipIds: string[];
   captionIds: string[];
 }
@@ -762,22 +1139,28 @@ declare class DslEditor {
     rate: number;
   } | undefined, options?: CommitOptions): void;
   setClipVolume(clipId: string, volume: number | undefined, options?: CommitOptions): void;
-  createAudioScript(body: string, defaultLanguage?: string, options?: CommitOptions): string;
-  editAudioScript(scriptId: string, expectedBodyId: string, edits: readonly TextEdit[], options?: CommitOptions): void;
-  createCaption(input: ({
-    audioScriptId: string;
-    start: number;
-    end: number;
+  /** A script of these segments, in order; each segment gets its own id. */
+  createAudioScript(segments: readonly string[], defaultLanguage?: string, options?: CommitOptions): string;
+  editAudioScript(scriptId: string, segmentId: string, expectedBodyId: string, edits: readonly TextEdit[], options?: CommitOptions): void;
+  /** Adds a segment at `index`, the end by default, and returns its id. */
+  insertScriptSegment(scriptId: string, text: string, index?: number, options?: CommitOptions): string;
+  /** `index` is measured after removing the segment. */
+  moveScriptSegment(scriptId: string, segmentId: string, index: number, options?: CommitOptions): void;
+  /** Captions and PhoneticScripts selecting the segment keep their selection, which then shows nothing (D72). */
+  deleteScriptSegment(scriptId: string, segmentId: string, options?: CommitOptions): void;
+  createCaption(input: ((SegmentRange & {
     text?: never;
-  } | {
+  }) | {
     text: string;
     audioScriptId?: never;
+    segmentId?: never;
     start?: never;
     end?: never;
   }) & {
-    style?: CaptionStyle;
+    style?: CaptionStyle$1;
   }, options?: CommitOptions): string;
-  setCaptionContent(captionId: string, audioScriptId: string, start: number, end: number, options?: CommitOptions): void;
+  /** 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;
   setCaptionText(captionId: string, text: string, options?: CommitOptions): void;
   editCaptionText(captionId: string, expectedBodyId: string, edits: readonly TextEdit[], options?: CommitOptions): void;
   moveTrack(trackId: string, index: number, options?: CommitOptions): void;
@@ -792,18 +1175,17 @@ 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;
   /**
-   * Write a PhoneticScript: create one for `audioScriptId`, or, given `phoneticScriptId`, replace its
-   * base and pronunciation together. A `phonemeScript` is stored as a Memota text file first, and
-   * the file's facts are written with it; an unchanged one keeps its file. Recordings already spoken
-   * from it keep their derived-from.
+   * Write a PhoneticScript: create one for a segment of a script, or a run of it, or, given
+   * `phoneticScriptId`, replace its selection and what to synthesize together (D181). A
+   * `phonemeScript` is stored as a Memota text file first, and the file's facts are written with
+   * it; an unchanged one keeps its file. Recordings already spoken from it keep their derived-from.
    */
-  setPhoneticScript(input: {
+  setPhoneticScript(input: SegmentRange & {
     phoneticScriptId?: string;
-    audioScriptId: string;
     phonemeScript?: string;
   }, options?: CommitOptions): Promise<string>;
   /** The file holding `text`: the one the PhoneticScript keeps while its text is unchanged, else a new upload. */
@@ -858,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;
@@ -873,16 +1787,29 @@ declare function toVideoDraft(snapshot: MedeoDslSnapshot): VideoDraftProjection;
  */
 interface AudioScriptView {
   id: string;
-  /** Its text, one segment per line. */
+  /** Its segments, in order. */
   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[];
-  /** Its variants written for synthesis: the pronunciation the plain text cannot state, and its file's digest. */
+  /**
+   * Its variants written for synthesis: the segment each is for (by index, absent once that
+   * segment is gone), what its selection holds, what to synthesize, and its file's digest.
+   */
   phoneticScripts: {
     id: string;
+    segment?: number;
+    text?: string;
     phonemeScript?: string;
     digest?: string;
   }[];
@@ -925,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 };