@mengine/medeo-tool 1.0.1-alpha.0

package/dist/sandbox-api.d.mts

@@ -0,0 +1,669 @@
+//#region src/sandbox/generated/edit-sandbox-api.d.ts
+/**
+ * @generated by gen:sandbox-dts — DO NOT EDIT MANUALLY
+ *
+ * Schema version: video-document/v0
+ * Semantic ops: 18
+ *
+ * Boundary: zod `superRefine` / custom refine rules are NOT introspectable and
+ * do not appear here. Business mutual-exclusion rules surface via runtime
+ * validation errors (L3 feedback channel).
+ *
+ * @example 读取→计算→批量写
+ * ```ts
+ * const clips = timeline.clipsInRange(0, 10_000);
+ * await edit.setVideoClipSpeedShift({
+ *   clips: clips.map((c) => ({ clip_id: c.id, speed_shift: { category: 'linear', mode: 'constant', config: { linear: { speed: 1.5 } } } })),
+ * });
+ * ```
+ *
+ * @example anchored 删除
+ * ```ts
+ * await edit.deleteVideoClips({ clip_ids: ['clip_a'], on_anchored: 'detach' });
+ * ```
+ */
+/**
+ * A clip's playback-speed fact, the only thing `SetVideoClipSpeedShift` writes.
+ */
+interface SpeedShift {
+  category: 'linear' | 'curve';
+  mode: string;
+  config: {
+    linear: {
+      /**
+       * @constraint positive
+       */
+      speed: number;
+    };
+  } | {
+    curve: {
+      /**
+       * @constraint minLength(2)
+       */
+      keyframes: {
+        /**
+         * @constraint min(0)
+         * @constraint max(1)
+         */
+        position: number;
+        /**
+         * @constraint min(0)
+         */
+        rate: number;
+        /**
+         * Bezier tangent handle (x, y)
+         */
+        in_tangent?: {
+          x: number;
+          y: number;
+        };
+        /**
+         * Bezier tangent handle (x, y)
+         */
+        out_tangent?: {
+          x: number;
+          y: number;
+        };
+      }[];
+    };
+  };
+}
+/**
+ * TTS voice summary attached to a speech
+ */
+interface Voice {
+  /**
+   * @constraint minLength(1)
+   */
+  id: string;
+  name: string;
+}
+/**
+ * A materialized speech-subtree write (speeches + their captions).
+ */
+interface SpeechAssets {
+  /**
+   * Materialized speech parts to write
+   * @constraint minLength(1)
+   */
+  speeches: {
+    /**
+     * The speech part ID (= side-effect speech_parts[].id)
+     * @constraint minLength(1)
+     */
+    speech_id: string;
+    /**
+     * Host video clip part ID the speech anchors to (RFC 02 §4)
+     * @constraint minLength(1)
+     */
+    anchor_part_id: string;
+    /**
+     * Offset within the host clip (speech.abs = host.abs + offset_ms)
+     * @constraint int
+     * @constraint min(0)
+     */
+    offset_ms: number;
+    /**
+     * @constraint minLength(1)
+     */
+    audio_storage_key: string;
+    /**
+     * Duration in milliseconds (> 0)
+     * @constraint int
+     * @constraint positive
+     */
+    duration_ms: number;
+    audio_script: string;
+    /**
+     * Volume in decibels (-60.0 to 20.0; 0.0 = original, -60 = mute, +20 = max)
+     * @constraint min(-60)
+     * @constraint max(20)
+     */
+    volume: number;
+    /**
+     * TTS voice summary attached to a speech
+     */
+    voice: {
+      /**
+       * @constraint minLength(1)
+       */
+      id: string;
+      name: string;
+    };
+    /**
+     * @constraint minLength(1)
+     */
+    origin_speech_id: string;
+    /**
+     * Caption part IDs owned by this speech
+     */
+    caption_ids: string[];
+  }[];
+  /**
+   * Materialized caption parts owned by the speeches
+   */
+  captions: {
+    /**
+     * The caption part ID (= side-effect created_caption_parts[].id)
+     * @constraint minLength(1)
+     */
+    caption_id: string;
+    /**
+     * The owning speech part ID
+     * @constraint minLength(1)
+     */
+    speech_part_id: string;
+    text: string;
+    /**
+     * Offset within the host speech (caption.abs = speech.abs + start_ms)
+     * @constraint int
+     * @constraint min(0)
+     */
+    start_ms: number;
+    /**
+     * Duration in milliseconds (> 0)
+     * @constraint int
+     * @constraint positive
+     */
+    duration_ms: number;
+  }[];
+}
+interface MoveVideoClipsInput {
+  /**
+   * List of video clips to move to new positions
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * The video clip part ID to move
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+    /**
+     * New absolute start time in milliseconds on the timeline
+     * @constraint int
+     * @constraint min(0)
+     */
+    new_start_ms: number;
+    /**
+     * Target track ID to move the clip to (optional)
+     * @constraint minLength(1)
+     */
+    new_track_id?: string;
+  }[];
+}
+interface DeleteVideoClipsInput {
+  /**
+   * List of video clip part IDs to delete from the main track
+   * @constraint minLength(1)
+   */
+  clip_ids: string[];
+  /**
+   * How to treat anchored children (default cascade)
+   */
+  on_anchored?: 'cascade' | 'detach';
+}
+/**
+ * Add video clips to a track.
+ */
+interface AddVideoClipsInput {
+  /**
+   * List of video clips to create
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * The media asset ID for the video clip
+     * @constraint minLength(1)
+     */
+    media_id: string;
+    /**
+     * Absolute start time in milliseconds on the timeline
+     * @constraint int
+     * @constraint min(0)
+     */
+    start_ms?: number;
+    /**
+     * The source media's intrinsic full length in ms
+     * @constraint int
+     * @constraint positive
+     */
+    media_duration_ms: number;
+    /**
+     * Trim window start in the media (default 0)
+     * @constraint int
+     * @constraint min(0)
+     */
+    play_in?: number;
+    /**
+     * Trim window end in the media (default media_duration_ms)
+     * @constraint int
+     * @constraint positive
+     */
+    play_out?: number;
+    /**
+     * Target track ID (optional, defaults to main track)
+     * @constraint minLength(1)
+     */
+    track_id?: string;
+  }[];
+  /**
+   * Insert new clips before this clip ID
+   * @constraint minLength(1)
+   */
+  before_clip_id?: string;
+  /**
+   * Insert new clips after this clip ID
+   * @constraint minLength(1)
+   */
+  after_clip_id?: string;
+}
+interface AdjustVideoClipVolumeInput {
+  /**
+   * List of video clips with their new volume settings
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * The video clip part ID to adjust volume for
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+    /**
+     * Volume in decibels (-60.0 to 20.0; 0.0 = original)
+     * @constraint min(-60)
+     * @constraint max(20)
+     */
+    volume: number;
+  }[];
+}
+/**
+ * Set the playback speed of existing video clips.
+ */
+interface SetVideoClipSpeedShiftInput {
+  /**
+   * Video clips with their new speed settings
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * The video clip part ID to set speed for
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+    /**
+     * The new speed setting, or null to reset to 1×
+     */
+    speed_shift: {
+      category: 'linear' | 'curve';
+      mode: string;
+      config: {
+        linear: {
+          /**
+           * @constraint positive
+           */
+          speed: number;
+        };
+      } | {
+        curve: {
+          /**
+           * @constraint minLength(2)
+           */
+          keyframes: {
+            /**
+             * @constraint min(0)
+             * @constraint max(1)
+             */
+            position: number;
+            /**
+             * @constraint min(0)
+             */
+            rate: number;
+            /**
+             * Bezier tangent handle (x, y)
+             */
+            in_tangent?: {
+              x: number;
+              y: number;
+            };
+            /**
+             * Bezier tangent handle (x, y)
+             */
+            out_tangent?: {
+              x: number;
+              y: number;
+            };
+          }[];
+        };
+      };
+    } | null;
+  }[];
+}
+/**
+ * Replace the media backing existing video clips.
+ */
+interface ReplaceVideoClipContentInput {
+  /**
+   * Video clips whose media is being replaced
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * Existing video clip part ID to re-point
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+    /**
+     * The new media asset ID
+     * @constraint minLength(1)
+     */
+    origin_media_id: string;
+    /**
+     * The new media's intrinsic full length
+     * @constraint int
+     * @constraint positive
+     */
+    media_duration_ms: number;
+    /**
+     * Trim window start in the new media (usually 0)
+     * @constraint int
+     * @constraint min(0)
+     */
+    play_in: number;
+    /**
+     * Trim window end in the new media (usually = media_duration_ms)
+     * @constraint int
+     * @constraint positive
+     */
+    play_out: number;
+    /**
+     * Volume in decibels (-60.0 to 20.0; 0.0 = original, -60 = mute, +20 = max)
+     * @constraint min(-60)
+     * @constraint max(20)
+     */
+    volume: number;
+  }[];
+}
+/**
+ * Re-trim existing video clips (the user-facing "adjust duration" gesture is a trim of the source window).
+ */
+interface AdjustVideoClipDurationInput {
+  /**
+   * Video clips with their new trim windows
+   * @constraint minLength(1)
+   */
+  clips: {
+    /**
+     * The video clip part ID to re-trim
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+    /**
+     * New trim window start in the source media
+     * @constraint int
+     * @constraint min(0)
+     */
+    play_in: number;
+    /**
+     * New trim window end in the source media
+     * @constraint int
+     * @constraint positive
+     */
+    play_out: number;
+  }[];
+}
+/**
+ * Add speeches (and their captions).
+ */
+interface AddSpeechesInput extends SpeechAssets {}
+/**
+ * Delete speeches with their captions.
+ */
+interface DeleteSpeechesInput {
+  /**
+   * Speech part IDs to delete (their captions cascade-delete)
+   * @constraint minLength(1)
+   */
+  speech_ids: string[];
+}
+/**
+ * Move speeches in time.
+ */
+interface MoveSpeechesInput {
+  /**
+   * Speeches to move to new positions
+   * @constraint minLength(1)
+   */
+  speeches: {
+    /**
+     * The speech part ID to move
+     * @constraint minLength(1)
+     */
+    speech_id: string;
+    /**
+     * New absolute start time on the timeline
+     * @constraint int
+     * @constraint min(0)
+     */
+    new_start_ms: number;
+  }[];
+}
+/**
+ * Change a speech's script or voice.
+ */
+interface ChangeSpeechScriptInput extends SpeechAssets {}
+interface ChangeSpeechVoiceInput extends SpeechAssets {}
+interface AdjustSpeechVolumeInput {
+  /**
+   * List of speeches with their new volume settings
+   * @constraint minLength(1)
+   */
+  speeches: {
+    /**
+     * The speech part ID to adjust volume for
+     * @constraint minLength(1)
+     */
+    speech_id: string;
+    /**
+     * Volume in decibels (-60.0 to 20.0; 0.0 = original)
+     * @constraint min(-60)
+     * @constraint max(20)
+     */
+    volume: number;
+  }[];
+}
+/**
+ * Toggle caption visibility (the caption track's `is_hidden` flag).
+ */
+interface SetCaptionVisibilityInput {
+  /**
+   * Whether the caption track is hidden
+   */
+  is_hidden: boolean;
+}
+/**
+ * Set the caption visual style.
+ */
+interface SetCaptionStyleInput {
+  /**
+   * Font ID referencing a font from the font library
+   * @constraint minLength(1)
+   */
+  font_id?: string;
+  /**
+   * Font size in points
+   * @constraint positive
+   */
+  font_size?: number;
+  /**
+   * Font color as hex string, e.g. "#FFFFFF"
+   * @constraint minLength(1)
+   */
+  font_color?: string;
+  /**
+   * Numeric font weight, e.g. 400 or 700
+   * @constraint int
+   */
+  font_weight?: number;
+  /**
+   * Entrance animation preset ID, e.g. "fade" or "none"
+   */
+  entrance_animation?: string;
+  /**
+   * Entrance animation duration in ms
+   * @constraint min(0)
+   */
+  entrance_animation_duration_ms?: number;
+  /**
+   * Outline/stroke color as hex string, e.g. "#000000"
+   * @constraint minLength(1)
+   */
+  stroke_color?: string;
+  /**
+   * Outline/stroke width in pixels
+   * @constraint min(0)
+   */
+  stroke_width?: number;
+  /**
+   * Caption center X as a fraction (0.0 to 1.0)
+   */
+  position_x?: number;
+  /**
+   * Caption center Y as a fraction (0.0 to 1.0)
+   */
+  position_y?: number;
+}
+/**
+ * Set the document BGM.
+ */
+interface SetBgmInput {
+  /**
+   * The bgm part ID to write
+   * @constraint minLength(1)
+   */
+  bgm_id: string;
+  /**
+   * @constraint minLength(1)
+   */
+  audio_storage_key: string;
+  /**
+   * The media asset ID
+   * @constraint minLength(1)
+   */
+  origin_media_id: string;
+  /**
+   * Volume in decibels (-60.0 to 20.0; 0.0 = original, -60 = mute, +20 = max)
+   * @constraint min(-60)
+   * @constraint max(20)
+   */
+  volume: number;
+}
+/**
+ * Remove the document BGM.
+ */
+interface DeleteBgmInput {
+  [key: string]: never;
+}
+interface AdjustBgmVolumeInput {
+  /**
+   * List of bgm parts with their new volume settings
+   * @constraint minLength(1)
+   */
+  bgm: {
+    /**
+     * The bgm part ID to adjust volume for
+     * @constraint minLength(1)
+     */
+    bgm_id: string;
+    /**
+     * Volume in decibels (-60.0 to 20.0; 0.0 = original)
+     * @constraint min(-60)
+     * @constraint max(20)
+     */
+    volume: number;
+  }[];
+}
+/** Agent write surface — one method per SemanticOp kind. */
+interface EditApi {
+  moveVideoClips(input: MoveVideoClipsInput): Promise<void>;
+  deleteVideoClips(input: DeleteVideoClipsInput): Promise<void>;
+  /** Add video clips to a track. */
+  addVideoClips(input: AddVideoClipsInput): Promise<void>;
+  adjustVideoClipVolume(input: AdjustVideoClipVolumeInput): Promise<void>;
+  /** Set the playback speed of existing video clips. */
+  setVideoClipSpeedShift(input: SetVideoClipSpeedShiftInput): Promise<void>;
+  /** Replace the media backing existing video clips. */
+  replaceVideoClipContent(input: ReplaceVideoClipContentInput): Promise<void>;
+  /** Re-trim existing video clips (the user-facing "adjust duration" gesture is a trim of the source window). */
+  adjustVideoClipDuration(input: AdjustVideoClipDurationInput): Promise<void>;
+  /** Add speeches (and their captions). */
+  addSpeeches(input: AddSpeechesInput): Promise<void>;
+  /** Delete speeches with their captions. */
+  deleteSpeeches(input: DeleteSpeechesInput): Promise<void>;
+  /** Move speeches in time. */
+  moveSpeeches(input: MoveSpeechesInput): Promise<void>;
+  /** Change a speech's script or voice. */
+  changeSpeechScript(input: ChangeSpeechScriptInput): Promise<void>;
+  changeSpeechVoice(input: ChangeSpeechVoiceInput): Promise<void>;
+  adjustSpeechVolume(input: AdjustSpeechVolumeInput): Promise<void>;
+  /** Toggle caption visibility (the caption track's `is_hidden` flag). */
+  setCaptionVisibility(input: SetCaptionVisibilityInput): Promise<void>;
+  /** Set the caption visual style. */
+  setCaptionStyle(input: SetCaptionStyleInput): Promise<void>;
+  /** Set the document BGM. */
+  setBgm(input: SetBgmInput): Promise<void>;
+  /** Remove the document BGM. */
+  deleteBgm(input: DeleteBgmInput): Promise<void>;
+  adjustBgmVolume(input: AdjustBgmVolumeInput): Promise<void>;
+}
+/** Clip hit from `clipsInRange`. */
+interface TimelineClipDescriptor {
+  id: string;
+  start_ms: number;
+  end_ms: number;
+  duration_ms: number;
+  speed_shift: unknown;
+  volume: number | undefined;
+  media_id: string | undefined;
+}
+/** Part descriptor from `part(id)`. */
+interface TimelinePartDescriptor {
+  id: string;
+  kind: string;
+  lane: string;
+  start_ms: number;
+  end_ms: number;
+  duration_ms: number;
+  part: unknown;
+}
+/** Opaque VideoDraft projection (full IDL lives in host document types). */
+type VideoDraftProjection = {
+  readonly timeline?: {
+    readonly duration_ms?: number;
+  };
+  readonly [key: string]: unknown;
+};
+/** Agent read surface over the forked document. */
+interface TimelineApi {
+  /** Snapshot the current VideoDraft projection. */
+  snapshot(): VideoDraftProjection;
+  /** Clips whose midpoint falls in `[startMs, endMs)`. */
+  clipsInRange(startMs: number, endMs: number): TimelineClipDescriptor[];
+  /** Look up a part by id, or null if missing. */
+  part(id: string): TimelinePartDescriptor | null;
+}
+/** Opaque checkpoint handle for rollback. */
+interface SandboxCheckpoint {
+  readonly index: number;
+}
+declare const edit: EditApi;
+declare const timeline: TimelineApi;
+/** Capture a rollback point. */
+declare function checkpoint(): SandboxCheckpoint;
+/** Roll the sandbox document back to a prior checkpoint. */
+declare function rollbackTo(cp: SandboxCheckpoint): void;
+/** Host-injected script arguments (opaque). */
+declare const inputs: unknown;
+//#endregion
+export type { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, EditApi, MoveSpeechesInput, MoveVideoClipsInput, ReplaceVideoClipContentInput, SandboxCheckpoint, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAssets, SpeedShift, TimelineApi, TimelineClipDescriptor, TimelinePartDescriptor, VideoDraftProjection, Voice, checkpoint, edit, inputs, rollbackTo, timeline };
+//# sourceMappingURL=sandbox-api.d.mts.map

package/dist/sandbox-api.mjs

@@ -0,0 +1 @@
+export {};