VideoUltra API
    Preparing search index...

    Class EditorController

    Index
    addAssetToTimeline addCaptionHere addLaneItem addLibrarySound addMarkerHere addRecording addRegion addTemplate align alignReason allowMediaAccess applyFilter applyFilterToAll applyTransition applyTransitionToAll arrangeReason arrangeSelected askAssistant attachCanvas autoCaptions cancelAssistant cancelBackgroundRemoval cancelCaptions cancelSceneDetection cancelSpeech captionCues checkBackgroundRemoval checkCaptions closeCombined closeMenu combineReason combineSelected copySelected cutSelected deleteSelected deleteVideo dismissImport dismissMediaProblems dismissToast distribute distributeReason downloadSubtitles duckReason duplicateSelected duplicateVideo exportAudio exportVideo extractAudio flipItem freezeSelected groupReason groupSelected hasClipboard hasVoiceFor hearCaptionAgain importFiles importLut importSubtitles isCombined isLocked jumpToHistory listVideos markCaptionChecked markerNear mergeCaption moveInStack newVideo nextCaptionToCheck notify on onCut onPreview onPreviewDrawn openCanvasSettings openCombined openMenu openPanel openTool openVideo paste pause pickFiles pickKeyColour play playRange preview previewSeek redo relinkMedia removeBackground renameItem restoreBackground run saveFrame seek select selectAll selectedGroup selectedItem selectedItems separateSelected setCameraOpen setCaptionLook setCaptionText setExportIn setExportOut setExportRange setFilePicker setItemHidden setItemLocked setLayout setPreviewMode setRoot setZoomHandler speak split splitAtScenes start startPicking step stickerHasBackground stop takeOver takePickPlace targets toast toggleDuckSelected toggleHideSelected toggleLockSelected togglePlay toggleSidePanel toggleTrack toggleTrackLock turnItem undo undoAssistantTurn ungroupSelected view whenMedia zoom parse
    • Parameters

      • options: ControllerOptions
      • Optionalproject: {
            assets: z.ZodMiniRecord<
                z.ZodMiniString<string>,
                z.ZodMiniObject<
                    {
                        audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                        credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                        duration: z.ZodMiniInt;
                        fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                        hasAudio: z.ZodMiniBoolean<boolean>;
                        hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        height: z.ZodMiniOptional<z.ZodMiniInt>;
                        id: z.ZodMiniString<string>;
                        kind: z.ZodMiniEnum<
                            {
                                audio: "audio";
                                compound: "compound";
                                image: "image";
                                lut: "lut";
                                video: "video";
                            },
                        >;
                        mimeType: z.ZodMiniString<string>;
                        name: z.ZodMiniString<string>;
                        rotation: z.ZodMiniOptional<
                            z.ZodMiniUnion<
                                readonly [
                                    z.ZodMiniLiteral<0>,
                                    z.ZodMiniLiteral<90>,
                                    z.ZodMiniLiteral<180>,
                                    z.ZodMiniLiteral<270>,
                                ],
                            >,
                        >;
                        size: z.ZodMiniInt;
                        source: z.ZodMiniDiscriminatedUnion<
                            [
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                            ],
                            "type",
                        >;
                        tracks: z.ZodMiniOptional<
                            z.ZodMiniArray<
                                z.ZodMiniObject<
                                    {
                                        caption: z.ZodMiniOptional<z.ZodMiniObject<(...), (...)>>;
                                        hidden: z.ZodMiniBoolean<boolean>;
                                        id: z.ZodMiniString<string>;
                                        items: z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<(...), (...)>>;
                                        kind: z.ZodMiniEnum<
                                            { audio: ...; caption: ...; main: ...; overlay: ...; text: ... },
                                        >;
                                        locked: z.ZodMiniBoolean<boolean>;
                                        muted: z.ZodMiniBoolean<boolean>;
                                    },
                                    z.core.$strip,
                                >,
                            >,
                        >;
                        vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        width: z.ZodMiniOptional<z.ZodMiniInt>;
                    },
                    z.core.$strip,
                >,
            >;
            createdAt: string;
            id: string;
            markers?: { id: string; label?: string; time: number }[];
            name: string;
            settings: {
                background:
                    | { color: string; type: "color" }
                    | { amount: number; type: "blur" };
                exportRange?: { end: number; start: number };
                frameRate: { den: number; num: number };
                height: number;
                width: number;
            };
            tracks: {
                caption?: {
                    highlight: "fill"
                    | "none"
                    | "type"
                    | "word"
                    | "box"
                    | "reveal";
                    highlightColor: string;
                    preset: string;
                };
                hidden: boolean;
                id: string;
                items: (
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: ...; type: ... };
                            loop?: { speed?: ...; type: ... };
                            out?: { duration: ...; type: ... };
                        };
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: ...; low: ...; mid: ... };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "video";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: ...; type: ... };
                            loop?: { speed?: ...; type: ... };
                            out?: { duration: ...; type: ... };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        cutout?: { assetId: string };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "image";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: ...; type: ... };
                            loop?: { speed?: ...; type: ... };
                            out?: { duration: ...; type: ... };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "freeze";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        sourceTime: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: ...; low: ...; mid: ... };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        kind: "audio";
                        locked?: boolean;
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: ...; type: ... };
                            loop?: { speed?: ...; type: ... };
                            out?: { duration: ...; type: ... };
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        duration: number;
                        filter: { id: string; intensity: number }
                        | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "text";
                        locked?: boolean;
                        maxWidth?: number;
                        name?: string;
                        start: number;
                        style: {
                            align: "left"
                            | "right"
                            | "center";
                            background: { color: string; padding: number; radius: number } | null;
                            color: string;
                            fontFamily: string;
                            fontWeight: number;
                            italic: boolean;
                            letterSpacing: number;
                            lineHeight: number;
                            outline: { color: string; width: number } | null;
                            shadow: { blur: number; color: string; x: number; y: number } | null;
                            size: number;
                        };
                        text: string;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        unsure?: boolean;
                        words?: { end: number; start: number; text: string }[];
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: ...; type: ... };
                            loop?: { speed?: ...; type: ... };
                            out?: { duration: ...; type: ... };
                        };
                        assetId: string
                        | null;
                        blend?:
                            | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                        cutout?: { assetId: string };
                        duration: number;
                        emoji: string | null;
                        filter: { id: string; intensity: number } | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "sticker";
                        locked?: boolean;
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                    }
                    | {
                        amount: number;
                        duration: number;
                        effect: "blur"
                        | "pixelate";
                        groupId?: string;
                        height: number;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: (...)[];
                            rotation?: (...)[];
                            scale?: (...)[];
                            shift?: number;
                            x?: (...)[];
                            y?: (...)[];
                        };
                        kind: "region";
                        locked?: boolean;
                        name?: string;
                        shape: "rectangle"
                        | "ellipse";
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        width: number;
                    }
                )[];
                kind: "audio"
                | "text"
                | "overlay"
                | "caption"
                | "main";
                locked: boolean;
                muted: boolean;
            }[];
            updatedAt: string;
            version: 6;
        }

      Returns EditorController

    analyzer: MediaAnalyzer | null = null
    caps: Capabilities | null = null
    editor: Editor
    engine: Engine | null = null
    fanOut: readonly string[] | null = null

    While set (a call through fanOutController), edits also reach these selected items.

    labels: Labels
    levels: Levels = ...

    Sound levels while playing (meters).

    media: Map<string, Blob> = ...

    Bytes of every asset, for the engine and analyzer (Files/Blobs: no copies in memory).

    playhead: Playhead = ...
    proxies: Map<string, File> = ...

    Lighter copies in use for previews, by asset id (device-local, not in the project).

    storage: ProjectStorage | null = null
    ui: StoreApi<UiState> = ...
    • get project(): {
          assets: z.ZodMiniRecord<
              z.ZodMiniString<string>,
              z.ZodMiniObject<
                  {
                      audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                      credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                      duration: z.ZodMiniInt;
                      fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                      hasAudio: z.ZodMiniBoolean<boolean>;
                      hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      height: z.ZodMiniOptional<z.ZodMiniInt>;
                      id: z.ZodMiniString<string>;
                      kind: z.ZodMiniEnum<
                          {
                              audio: "audio";
                              compound: "compound";
                              image: "image";
                              lut: "lut";
                              video: "video";
                          },
                      >;
                      mimeType: z.ZodMiniString<string>;
                      name: z.ZodMiniString<string>;
                      rotation: z.ZodMiniOptional<
                          z.ZodMiniUnion<
                              readonly [
                                  z.ZodMiniLiteral<0>,
                                  z.ZodMiniLiteral<90>,
                                  z.ZodMiniLiteral<180>,
                                  z.ZodMiniLiteral<270>,
                              ],
                          >,
                      >;
                      size: z.ZodMiniInt;
                      source: z.ZodMiniDiscriminatedUnion<
                          [
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                          ],
                          "type",
                      >;
                      tracks: z.ZodMiniOptional<
                          z.ZodMiniArray<
                              z.ZodMiniObject<
                                  {
                                      caption: z.ZodMiniOptional<
                                          z.ZodMiniObject<
                                              { highlight: ...; highlightColor: ...; preset: ... },
                                              z.core.$strip,
                                          >,
                                      >;
                                      hidden: z.ZodMiniBoolean<boolean>;
                                      id: z.ZodMiniString<string>;
                                      items: z.ZodMiniArray<
                                          z.ZodMiniDiscriminatedUnion<
                                              [(...), (...), (...), (...), (...), (...), (...)],
                                              "kind",
                                          >,
                                      >;
                                      kind: z.ZodMiniEnum<
                                          {
                                              audio: "audio";
                                              caption: "caption";
                                              main: "main";
                                              overlay: "overlay";
                                              text: "text";
                                          },
                                      >;
                                      locked: z.ZodMiniBoolean<boolean>;
                                      muted: z.ZodMiniBoolean<boolean>;
                                  },
                                  z.core.$strip,
                              >,
                          >,
                      >;
                      vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      width: z.ZodMiniOptional<z.ZodMiniInt>;
                  },
                  z.core.$strip,
              >,
          >;
          createdAt: string;
          id: string;
          markers?: { id: string; label?: string; time: number }[];
          name: string;
          settings: {
              background:
                  | { color: string; type: "color" }
                  | { amount: number; type: "blur" };
              exportRange?: { end: number; start: number };
              frameRate: { den: number; num: number };
              height: number;
              width: number;
          };
          tracks: {
              caption?: {
                  highlight: "fill"
                  | "none"
                  | "type"
                  | "word"
                  | "box"
                  | "reveal";
                  highlightColor: string;
                  preset: string;
              };
              hidden: boolean;
              id: string;
              items: (
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "video";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      cutout?: { assetId: string };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "image";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "freeze";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      sourceTime: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      kind: "audio";
                      locked?: boolean;
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      duration: number;
                      filter: { id: string; intensity: number }
                      | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "text";
                      locked?: boolean;
                      maxWidth?: number;
                      name?: string;
                      start: number;
                      style: {
                          align: "left"
                          | "right"
                          | "center";
                          background: { color: string; padding: number; radius: number } | null;
                          color: string;
                          fontFamily: string;
                          fontWeight: number;
                          italic: boolean;
                          letterSpacing: number;
                          lineHeight: number;
                          outline: { color: string; width: number } | null;
                          shadow: { blur: number; color: string; x: number; y: number } | null;
                          size: number;
                      };
                      text: string;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      unsure?: boolean;
                      words?: { end: number; start: number; text: string }[];
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string
                      | null;
                      blend?:
                          | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                      cutout?: { assetId: string };
                      duration: number;
                      emoji: string | null;
                      filter: { id: string; intensity: number } | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "sticker";
                      locked?: boolean;
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                  }
                  | {
                      amount: number;
                      duration: number;
                      effect: "blur"
                      | "pixelate";
                      groupId?: string;
                      height: number;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "region";
                      locked?: boolean;
                      name?: string;
                      shape: "rectangle"
                      | "ellipse";
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      width: number;
                  }
              )[];
              kind: "audio"
              | "text"
              | "overlay"
              | "caption"
              | "main";
              locked: boolean;
              muted: boolean;
          }[];
          updatedAt: string;
          version: 6;
      }

      The project as the editor shows it: inside the open combined clip, if one is open.

      Returns {
          assets: z.ZodMiniRecord<
              z.ZodMiniString<string>,
              z.ZodMiniObject<
                  {
                      audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                      credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                      duration: z.ZodMiniInt;
                      fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                      hasAudio: z.ZodMiniBoolean<boolean>;
                      hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      height: z.ZodMiniOptional<z.ZodMiniInt>;
                      id: z.ZodMiniString<string>;
                      kind: z.ZodMiniEnum<
                          {
                              audio: "audio";
                              compound: "compound";
                              image: "image";
                              lut: "lut";
                              video: "video";
                          },
                      >;
                      mimeType: z.ZodMiniString<string>;
                      name: z.ZodMiniString<string>;
                      rotation: z.ZodMiniOptional<
                          z.ZodMiniUnion<
                              readonly [
                                  z.ZodMiniLiteral<0>,
                                  z.ZodMiniLiteral<90>,
                                  z.ZodMiniLiteral<180>,
                                  z.ZodMiniLiteral<270>,
                              ],
                          >,
                      >;
                      size: z.ZodMiniInt;
                      source: z.ZodMiniDiscriminatedUnion<
                          [
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                          ],
                          "type",
                      >;
                      tracks: z.ZodMiniOptional<
                          z.ZodMiniArray<
                              z.ZodMiniObject<
                                  {
                                      caption: z.ZodMiniOptional<
                                          z.ZodMiniObject<
                                              { highlight: ...; highlightColor: ...; preset: ... },
                                              z.core.$strip,
                                          >,
                                      >;
                                      hidden: z.ZodMiniBoolean<boolean>;
                                      id: z.ZodMiniString<string>;
                                      items: z.ZodMiniArray<
                                          z.ZodMiniDiscriminatedUnion<
                                              [(...), (...), (...), (...), (...), (...), (...)],
                                              "kind",
                                          >,
                                      >;
                                      kind: z.ZodMiniEnum<
                                          {
                                              audio: "audio";
                                              caption: "caption";
                                              main: "main";
                                              overlay: "overlay";
                                              text: "text";
                                          },
                                      >;
                                      locked: z.ZodMiniBoolean<boolean>;
                                      muted: z.ZodMiniBoolean<boolean>;
                                  },
                                  z.core.$strip,
                              >,
                          >,
                      >;
                      vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      width: z.ZodMiniOptional<z.ZodMiniInt>;
                  },
                  z.core.$strip,
              >,
          >;
          createdAt: string;
          id: string;
          markers?: { id: string; label?: string; time: number }[];
          name: string;
          settings: {
              background:
                  | { color: string; type: "color" }
                  | { amount: number; type: "blur" };
              exportRange?: { end: number; start: number };
              frameRate: { den: number; num: number };
              height: number;
              width: number;
          };
          tracks: {
              caption?: {
                  highlight: "fill"
                  | "none"
                  | "type"
                  | "word"
                  | "box"
                  | "reveal";
                  highlightColor: string;
                  preset: string;
              };
              hidden: boolean;
              id: string;
              items: (
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "video";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      cutout?: { assetId: string };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "image";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "freeze";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      sourceTime: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      kind: "audio";
                      locked?: boolean;
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      duration: number;
                      filter: { id: string; intensity: number }
                      | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "text";
                      locked?: boolean;
                      maxWidth?: number;
                      name?: string;
                      start: number;
                      style: {
                          align: "left"
                          | "right"
                          | "center";
                          background: { color: string; padding: number; radius: number } | null;
                          color: string;
                          fontFamily: string;
                          fontWeight: number;
                          italic: boolean;
                          letterSpacing: number;
                          lineHeight: number;
                          outline: { color: string; width: number } | null;
                          shadow: { blur: number; color: string; x: number; y: number } | null;
                          size: number;
                      };
                      text: string;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      unsure?: boolean;
                      words?: { end: number; start: number; text: string }[];
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string
                      | null;
                      blend?:
                          | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                      cutout?: { assetId: string };
                      duration: number;
                      emoji: string | null;
                      filter: { id: string; intensity: number } | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "sticker";
                      locked?: boolean;
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                  }
                  | {
                      amount: number;
                      duration: number;
                      effect: "blur"
                      | "pixelate";
                      groupId?: string;
                      height: number;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "region";
                      locked?: boolean;
                      name?: string;
                      shape: "rectangle"
                      | "ellipse";
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      width: number;
                  }
              )[];
              kind: "audio"
              | "text"
              | "overlay"
              | "caption"
              | "main";
              locked: boolean;
              muted: boolean;
          }[];
          updatedAt: string;
          version: 6;
      }

    • Adds an already-imported asset to the timeline (media panel).

      Parameters

      • assetId: string

      Returns void

    • Adds a caption to type at the playhead (2 s, or up to the next one).

      Returns void

    • Parameters

      • label: string
      • make: (
            id: string,
            start: number,
        ) =>
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "video";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                cutout?: { assetId: string };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "image";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "freeze";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                sourceTime: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                groupId?: string;
                hidden?: boolean;
                id: string;
                kind: "audio";
                locked?: boolean;
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                duration: number;
                filter: { id: string; intensity: number }
                | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "text";
                locked?: boolean;
                maxWidth?: number;
                name?: string;
                start: number;
                style: {
                    align: "left"
                    | "right"
                    | "center";
                    background: { color: string; padding: number; radius: number } | null;
                    color: string;
                    fontFamily: string;
                    fontWeight: number;
                    italic: boolean;
                    letterSpacing: number;
                    lineHeight: number;
                    outline: { color: string; width: number } | null;
                    shadow: { blur: number; color: string; x: number; y: number } | null;
                    size: number;
                };
                text: string;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                unsure?: boolean;
                words?: { end: number; start: number; text: string }[];
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string
                | null;
                blend?:
                    | "add"
                    | "normal"
                    | "multiply"
                    | "screen"
                    | "overlay"
                    | "soft-light"
                    | "lighten"
                    | "darken"
                    | "difference";
                cutout?: { assetId: string };
                duration: number;
                emoji: string | null;
                filter: { id: string; intensity: number } | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "sticker";
                locked?: boolean;
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
            }
            | {
                amount: number;
                duration: number;
                effect: "blur"
                | "pixelate";
                groupId?: string;
                height: number;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "region";
                locked?: boolean;
                name?: string;
                shape: "rectangle"
                | "ellipse";
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                width: number;
            }

      Returns void

    • Adds a sound from the host's library at the playhead (on a sound lane) and selects it. The file is stored in the project like an import; its licence line goes on the asset.

      Parameters

      Returns Promise<boolean>

    • Adds a marker at the playhead (key M) — or removes the one that's there.

      Returns void

    • Adds a finished camera recording (already streamed into storage as assetId): probed like an import, then placed in the main video at the playhead or as a layer over it. Returns false (after saying why) when the file can't be used.

      Parameters

      • file: File
      • assetId: string
      • source:
            | { key: string; type: "opfs" }
            | { key: string; type: "handle" }
            | { type: "url"; url: string }
            | { type: "compound" }
      • place: "main" | "layer"

      Returns Promise<boolean>

    • Adds a blurred or pixelated box / oval at the playhead, selected (it can be dragged at once).

      Parameters

      • effect: "blur" | "pixelate"
      • shape: "rectangle" | "ellipse"

      Returns void

    • Adds a template at the playhead (one group) and selects it.

      Parameters

      • template: TemplatePreset
      • values: Readonly<Record<string, string>>

      Returns void

    • Lines up the selection: one element against the frame, several against each other.

      Parameters

      Returns void

    • Returns string | null

    • "Allow": asks the browser again for every kept file waiting for the person's OK. Call it straight from a tap (browsers only ask inside one). Files still refused move on to "Find".

      Returns Promise<void>

    • Sets (or clears) a clip's filter; keeps the intensity the user chose.

      Parameters

      • item:
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "video";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                cutout?: { assetId: string };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "image";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "freeze";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                sourceTime: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                groupId?: string;
                hidden?: boolean;
                id: string;
                kind: "audio";
                locked?: boolean;
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                duration: number;
                filter: { id: string; intensity: number }
                | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "text";
                locked?: boolean;
                maxWidth?: number;
                name?: string;
                start: number;
                style: {
                    align: "left"
                    | "right"
                    | "center";
                    background: { color: string; padding: number; radius: number } | null;
                    color: string;
                    fontFamily: string;
                    fontWeight: number;
                    italic: boolean;
                    letterSpacing: number;
                    lineHeight: number;
                    outline: { color: string; width: number } | null;
                    shadow: { blur: number; color: string; x: number; y: number } | null;
                    size: number;
                };
                text: string;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                unsure?: boolean;
                words?: { end: number; start: number; text: string }[];
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string
                | null;
                blend?:
                    | "add"
                    | "normal"
                    | "multiply"
                    | "screen"
                    | "overlay"
                    | "soft-light"
                    | "lighten"
                    | "darken"
                    | "difference";
                cutout?: { assetId: string };
                duration: number;
                emoji: string | null;
                filter: { id: string; intensity: number } | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "sticker";
                locked?: boolean;
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
            }
            | {
                amount: number;
                duration: number;
                effect: "blur"
                | "pixelate";
                groupId?: string;
                height: number;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "region";
                locked?: boolean;
                name?: string;
                shape: "rectangle"
                | "ellipse";
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                width: number;
            }
      • filterId: string | null

      Returns void

    • Gives every video and photo (main track and layers) the look of from: its filter at its strength, and its LUT look. Locked ones are left alone. Returns how many changed.

      Parameters

      • from:
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "video";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                cutout?: { assetId: string };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "image";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "freeze";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                sourceTime: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                groupId?: string;
                hidden?: boolean;
                id: string;
                kind: "audio";
                locked?: boolean;
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                duration: number;
                filter: { id: string; intensity: number }
                | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "text";
                locked?: boolean;
                maxWidth?: number;
                name?: string;
                start: number;
                style: {
                    align: "left"
                    | "right"
                    | "center";
                    background: { color: string; padding: number; radius: number } | null;
                    color: string;
                    fontFamily: string;
                    fontWeight: number;
                    italic: boolean;
                    letterSpacing: number;
                    lineHeight: number;
                    outline: { color: string; width: number } | null;
                    shadow: { blur: number; color: string; x: number; y: number } | null;
                    size: number;
                };
                text: string;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                unsure?: boolean;
                words?: { end: number; start: number; text: string }[];
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string
                | null;
                blend?:
                    | "add"
                    | "normal"
                    | "multiply"
                    | "screen"
                    | "overlay"
                    | "soft-light"
                    | "lighten"
                    | "darken"
                    | "difference";
                cutout?: { assetId: string };
                duration: number;
                emoji: string | null;
                filter: { id: string; intensity: number } | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "sticker";
                locked?: boolean;
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
            }
            | {
                amount: number;
                duration: number;
                effect: "blur"
                | "pixelate";
                groupId?: string;
                height: number;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "region";
                locked?: boolean;
                name?: string;
                shape: "rectangle"
                | "ellipse";
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                width: number;
            }

      Returns number

    • Sets (or clears) the transition into a main-track clip.

      Parameters

      • item:
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "video";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                cutout?: { assetId: string };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "image";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "freeze";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                sourceTime: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                groupId?: string;
                hidden?: boolean;
                id: string;
                kind: "audio";
                locked?: boolean;
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                duration: number;
                filter: { id: string; intensity: number }
                | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "text";
                locked?: boolean;
                maxWidth?: number;
                name?: string;
                start: number;
                style: {
                    align: "left"
                    | "right"
                    | "center";
                    background: { color: string; padding: number; radius: number } | null;
                    color: string;
                    fontFamily: string;
                    fontWeight: number;
                    italic: boolean;
                    letterSpacing: number;
                    lineHeight: number;
                    outline: { color: string; width: number } | null;
                    shadow: { blur: number; color: string; x: number; y: number } | null;
                    size: number;
                };
                text: string;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                unsure?: boolean;
                words?: { end: number; start: number; text: string }[];
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string
                | null;
                blend?:
                    | "add"
                    | "normal"
                    | "multiply"
                    | "screen"
                    | "overlay"
                    | "soft-light"
                    | "lighten"
                    | "darken"
                    | "difference";
                cutout?: { assetId: string };
                duration: number;
                emoji: string | null;
                filter: { id: string; intensity: number } | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "sticker";
                locked?: boolean;
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
            }
            | {
                amount: number;
                duration: number;
                effect: "blur"
                | "pixelate";
                groupId?: string;
                height: number;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "region";
                locked?: boolean;
                name?: string;
                shape: "rectangle"
                | "ellipse";
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                width: number;
            }
      • type: string | null
      • duration: number

      Returns void

    • The same transition between every pair of main-track clips.

      Parameters

      • type: string
      • duration: number

      Returns void

    • Why the selection can't move in the stack (null = it can).

      Parameters

      • to: ArrangeTo

      Returns string | null

    • Parameters

      • to: ArrangeTo

      Returns void

    • Sends instruction to the host's assistant with a description of the project, then applies the edits it answers with as one undo step — all of them or, if one is invalid, none (the reason shows in the conversation). Returns the turn.

      Parameters

      • instruction: string

      Returns Promise<AssistantTurn | null>

    • Hands the preview canvas to a new engine worker. Returns a disposer.

      Parameters

      • canvas: HTMLCanvasElement

      Returns Promise<() => void>

    • Auto captions: the video's speech (music lowered under voice is left out, so the words come through) goes to the transcriber piece by piece; the words become captions that replace any there were — only those in options.range when it's given (a part heard again). One undo step. Progress is in ui.captionJob; cancelCaptions() stops it.

      Parameters

      • language: string
      • options: CaptionOptions = {}

      Returns Promise<void>

    • Stops a request to the assistant.

      Returns void

    • Returns void

    • Returns void

    • Stops a running splitAtScenes.

      Returns void

    • Stops a running speak.

      Returns void

    • The captions as subtitle cues (for .srt / .vtt).

      Returns SubtitleCue[]

    • Whether background removal can run here (null: the host gave no remover).

      Returns Promise<BackgroundRemoverCheck | null>

    • Whether auto captions can run, and what they'd take, for language.

      Parameters

      • language: string

      Returns Promise<TranscriberCheck | null>

    • Back out of the open combined clip (all: back to the timeline itself).

      Parameters

      • all: boolean = false

      Returns void

    • Returns void

    • Why the selection can't be combined (null = it can).

      Returns string | null

    • Combines the selection into one clip and selects it.

      Returns void

    • Copies the selection (and the media it uses) for paste.

      Returns number

    • Copies the selection, then deletes it.

      Returns void

    • Returns void

    • Deletes a saved video other than the open one, and media only it used.

      Parameters

      • id: string

      Returns Promise<void>

    • Parameters

      • rowId: string

      Returns void

    • Hides the media banner (the files stay missing; their clips show without a picture).

      Returns void

    • Parameters

      • id: number

      Returns void

    • Parameters

      • axis: "x" | "y"

      Returns void

    • Returns string | null

    • Downloads the captions as a subtitle file.

      Parameters

      • format: "srt" | "vtt"

      Returns void

    • Why "Lower under voice" can't act on the selection now (null: it can).

      Returns string | null

    • Returns void

    • Makes a copy of this video and opens it: the same media files (nothing is copied but the project), a new name, its own history. The original stays as it was saved.

      Returns Promise<void>

    • Exports only the sound (the same mix as the video export).

      Parameters

      • options: AudioExportOptions
      • onProgress: (p: ExportProgress) => void
      • signal: AbortSignal

      Returns Promise<AudioExportResult>

    • Copies a video's sound to an audio lane and mutes the video, so it can be edited alone.

      Returns void

    • Mirrors an item (to has the new flip) with a short ease on the video: it eases a little smaller, flips at the midpoint, and eases back (the transform has no in-between for a mirror). Previews only, then one edit; reduced motion: at once.

      Parameters

      • label: string
      • itemId: string
      • time: number
      • from: {
            flipX: boolean;
            flipY: boolean;
            opacity: number;
            rotation: number;
            scale: number;
            x: number;
            y: number;
        }
      • to: {
            flipX: boolean;
            flipY: boolean;
            opacity: number;
            rotation: number;
            scale: number;
            x: number;
            y: number;
        }

      Returns void

    • Returns void

    • Why the selection can't be grouped (null = it can).

      Returns string | null

    • Returns void

    • Whether paste has something to paste.

      Returns boolean

    • Whether anything in the project can be heard for ducked items to lower under: a sounding item (not exceptId, not itself ducked, not muted) whose media has sound.

      Parameters

      • exceptId: string
      • project: {
            assets: z.ZodMiniRecord<
                z.ZodMiniString<string>,
                z.ZodMiniObject<
                    {
                        audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                        credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                        duration: z.ZodMiniInt;
                        fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                        hasAudio: z.ZodMiniBoolean<boolean>;
                        hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        height: z.ZodMiniOptional<z.ZodMiniInt>;
                        id: z.ZodMiniString<string>;
                        kind: z.ZodMiniEnum<
                            {
                                audio: "audio";
                                compound: "compound";
                                image: "image";
                                lut: "lut";
                                video: "video";
                            },
                        >;
                        mimeType: z.ZodMiniString<string>;
                        name: z.ZodMiniString<string>;
                        rotation: z.ZodMiniOptional<
                            z.ZodMiniUnion<
                                readonly [
                                    z.ZodMiniLiteral<0>,
                                    z.ZodMiniLiteral<90>,
                                    z.ZodMiniLiteral<180>,
                                    z.ZodMiniLiteral<270>,
                                ],
                            >,
                        >;
                        size: z.ZodMiniInt;
                        source: z.ZodMiniDiscriminatedUnion<
                            [
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                            ],
                            "type",
                        >;
                        tracks: z.ZodMiniOptional<
                            z.ZodMiniArray<
                                z.ZodMiniObject<
                                    {
                                        caption: z.ZodMiniOptional<
                                            z.ZodMiniObject<
                                                { highlight: ...; highlightColor: ...; preset: ... },
                                                z.core.$strip,
                                            >,
                                        >;
                                        hidden: z.ZodMiniBoolean<boolean>;
                                        id: z.ZodMiniString<string>;
                                        items: z.ZodMiniArray<
                                            z.ZodMiniDiscriminatedUnion<
                                                [(...), (...), (...), (...), (...), (...), (...)],
                                                "kind",
                                            >,
                                        >;
                                        kind: z.ZodMiniEnum<
                                            {
                                                audio: "audio";
                                                caption: "caption";
                                                main: "main";
                                                overlay: "overlay";
                                                text: "text";
                                            },
                                        >;
                                        locked: z.ZodMiniBoolean<boolean>;
                                        muted: z.ZodMiniBoolean<boolean>;
                                    },
                                    z.core.$strip,
                                >,
                            >,
                        >;
                        vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        width: z.ZodMiniOptional<z.ZodMiniInt>;
                    },
                    z.core.$strip,
                >,
            >;
            createdAt: string;
            id: string;
            markers?: { id: string; label?: string; time: number }[];
            name: string;
            settings: {
                background:
                    | { color: string; type: "color" }
                    | { amount: number; type: "blur" };
                exportRange?: { end: number; start: number };
                frameRate: { den: number; num: number };
                height: number;
                width: number;
            };
            tracks: {
                caption?: {
                    highlight: "fill"
                    | "none"
                    | "type"
                    | "word"
                    | "box"
                    | "reveal";
                    highlightColor: string;
                    preset: string;
                };
                hidden: boolean;
                id: string;
                items: (
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: number; low: number; mid: number };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "video";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        cutout?: { assetId: string };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "image";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "freeze";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        sourceTime: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: number; low: number; mid: number };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        kind: "audio";
                        locked?: boolean;
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        duration: number;
                        filter: { id: string; intensity: number }
                        | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "text";
                        locked?: boolean;
                        maxWidth?: number;
                        name?: string;
                        start: number;
                        style: {
                            align: "left"
                            | "right"
                            | "center";
                            background: { color: string; padding: number; radius: number } | null;
                            color: string;
                            fontFamily: string;
                            fontWeight: number;
                            italic: boolean;
                            letterSpacing: number;
                            lineHeight: number;
                            outline: { color: string; width: number } | null;
                            shadow: { blur: number; color: string; x: number; y: number } | null;
                            size: number;
                        };
                        text: string;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        unsure?: boolean;
                        words?: { end: number; start: number; text: string }[];
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string
                        | null;
                        blend?:
                            | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                        cutout?: { assetId: string };
                        duration: number;
                        emoji: string | null;
                        filter: { id: string; intensity: number } | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "sticker";
                        locked?: boolean;
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                    }
                    | {
                        amount: number;
                        duration: number;
                        effect: "blur"
                        | "pixelate";
                        groupId?: string;
                        height: number;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "region";
                        locked?: boolean;
                        name?: string;
                        shape: "rectangle"
                        | "ellipse";
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        width: number;
                    }
                )[];
                kind: "audio"
                | "text"
                | "overlay"
                | "caption"
                | "main";
                locked: boolean;
                muted: boolean;
            }[];
            updatedAt: string;
            version: 6;
        } = ...

      Returns boolean

    • Hears one caption's part of the video again (half a second either side), the way the last auto captions were made, and replaces the captions there.

      Parameters

      • itemId: string

      Returns void

    • Imports files: probe (in a worker), store, register, and add to the timeline — videos and photos after the clip under the playhead, audio on a lane at the playhead. Each file fails on its own with a clear message.

      Parameters

      • files: readonly File[]
      • options: {
            addToTimeline?: boolean;
            asSticker?: boolean;
            at?: number;
            atStart?: boolean;
            credit?: string;
            name?: string;
            selectSound?: boolean;
            speed?: number;
        } = {}
        • OptionaladdToTimeline?: boolean
        • OptionalasSticker?: boolean
        • Optionalat?: number

          Sounds go here instead of the playhead (a voiceover: where its recording started).

        • OptionalatStart?: boolean

          Videos and photos go before the first clip (in the order given), not at the playhead.

        • Optionalcredit?: string

          Licence / attribution line kept on the asset (library sounds).

        • Optionalname?: string

          Display name instead of the file name (library sounds: their title).

        • OptionalselectSound?: boolean

          Select the added sound clip (library sounds: its settings show next).

        • Optionalspeed?: number

          Added sounds play at this speed with their pitch kept (text to speech from a service that can't change its pace). Default 1.

      Returns Promise<void>

    • Imports a .cube LUT: checked in the engine worker (clear message when it can't be used), stored like media (never inlined in the project), added as a lut asset (to the LUT looks list) and applied to itemId when that is an unlocked picture; the toast says which.

      Parameters

      • file: File
      • itemId: string | null

      Returns Promise<void>

    • Reads an .srt / .vtt file into captions (replacing any).

      Parameters

      • file: File

      Returns Promise<void>

    • Whether item plays a combined clip.

      Parameters

      • item:
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "video";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                cutout?: { assetId: string };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "image";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string;
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                crop: { bottom: number; left: number; right: number; top: number };
                duration: number;
                filter: { id: string; intensity: number } | null;
                fit: "fit" | "fill";
                groupId?: string;
                hidden?: boolean;
                id: string;
                key?: {
                    color: string;
                    softness: number;
                    spill: number;
                    tolerance: number;
                };
                keyframes?: {
                    opacity?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "freeze";
                locked?: boolean;
                lut?: { assetId: string; intensity: number };
                mask?: { feather: number; invert?: boolean; shape: string };
                name?: string;
                sourceTime: number;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                transitionIn: | {
                    direction?: "left"
                    | "right"
                    | "up"
                    | "down";
                    duration: number;
                    ease?:
                        | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps";
                    type: string;
                }
                | null;
            }
            | {
                assetId: string;
                audioFx?: {
                    compress?: number;
                    denoise?: number;
                    eq?: { high: number; low: number; mid: number };
                    keepPitch?: boolean;
                    pitch?: number;
                };
                duck?: number;
                duration: number;
                fadeIn: number;
                fadeOut: number;
                groupId?: string;
                hidden?: boolean;
                id: string;
                kind: "audio";
                locked?: boolean;
                muted: boolean;
                name?: string;
                sourceIn: number;
                speed: number;
                start: number;
                volume: number;
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                blend?: | "add"
                | "normal"
                | "multiply"
                | "screen"
                | "overlay"
                | "soft-light"
                | "lighten"
                | "darken"
                | "difference";
                duration: number;
                filter: { id: string; intensity: number }
                | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "text";
                locked?: boolean;
                maxWidth?: number;
                name?: string;
                start: number;
                style: {
                    align: "left"
                    | "right"
                    | "center";
                    background: { color: string; padding: number; radius: number } | null;
                    color: string;
                    fontFamily: string;
                    fontWeight: number;
                    italic: boolean;
                    letterSpacing: number;
                    lineHeight: number;
                    outline: { color: string; width: number } | null;
                    shadow: { blur: number; color: string; x: number; y: number } | null;
                    size: number;
                };
                text: string;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                unsure?: boolean;
                words?: { end: number; start: number; text: string }[];
            }
            | {
                adjust: {
                    brightness?: number;
                    contrast?: number;
                    highlights?: number;
                    saturation?: number;
                    shadows?: number;
                    sharpen?: number;
                    tint?: number;
                    vignette?: number;
                    warmth?: number;
                };
                animation?: {
                    in?: { duration: number; type: string };
                    loop?: { speed?: number; type: string };
                    out?: { duration: number; type: string };
                };
                assetId: string
                | null;
                blend?:
                    | "add"
                    | "normal"
                    | "multiply"
                    | "screen"
                    | "overlay"
                    | "soft-light"
                    | "lighten"
                    | "darken"
                    | "difference";
                cutout?: { assetId: string };
                duration: number;
                emoji: string | null;
                filter: { id: string; intensity: number } | null;
                groupId?: string;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "sticker";
                locked?: boolean;
                name?: string;
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
            }
            | {
                amount: number;
                duration: number;
                effect: "blur"
                | "pixelate";
                groupId?: string;
                height: number;
                hidden?: boolean;
                id: string;
                keyframes?: {
                    opacity?: {
                        ease?:
                            | "back"
                            | "linear"
                            | "smooth"
                            | "ease-in"
                            | "ease-out"
                            | "snappy"
                            | "expo"
                            | "anticipate"
                            | "bounce"
                            | "elastic"
                            | "ball"
                            | "slow-mo"
                            | "steps"
                            | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    rotation?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    scale?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    shift?: number;
                    x?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                    y?: {
                        ease?: | "back"
                        | "linear"
                        | "smooth"
                        | "ease-in"
                        | "ease-out"
                        | "snappy"
                        | "expo"
                        | "anticipate"
                        | "bounce"
                        | "elastic"
                        | "ball"
                        | "slow-mo"
                        | "steps"
                        | [number, number, number, number];
                        t: number;
                        v: number;
                    }[];
                };
                kind: "region";
                locked?: boolean;
                name?: string;
                shape: "rectangle"
                | "ellipse";
                start: number;
                transform: {
                    flipX: boolean;
                    flipY: boolean;
                    opacity: number;
                    rotation: number;
                    scale: number;
                    x: number;
                    y: number;
                };
                width: number;
            }
            | null
            | undefined

      Returns boolean

    • Whether an item can't be changed: locked itself, or on a locked row.

      Parameters

      • itemId: string

      Returns boolean

    • History panel: undoes or redoes until position steps are applied (0 = as opened).

      Parameters

      • position: number

      Returns void

    • The videos saved on this device, newest first (empty when the editor doesn't save here).

      Returns Promise<StoredProjectInfo[]>

    • The "check this" mark goes: a person read the caption and it's right.

      Parameters

      • itemId: string

      Returns void

    • The nearest marker after (1) or before (−1) the playhead, or null.

      Parameters

      • direction: -1 | 1

      Returns number | null

    • Parameters

      • itemId: string

      Returns void

    • Layers panel drag: puts an element at toIndex in the on-screen stack (0 = front), one step at a time so lanes stay tidy. One undo step.

      Parameters

      • itemId: string
      • toIndex: number

      Returns void

    • Starts a new, empty video (the current one is saved first and stays in the list).

      Returns Promise<void>

    • Selects and plays to the next caption marked to check (after the selected one).

      Returns void

    • Tells the listeners (a host's listener throwing never breaks the editor).

      Parameters

      Returns void

    • Listens to what happens in the editor (edits, selection, playback, …); returns an unsubscribe.

      Parameters

      Returns () => void

    • Parameters

      • listener: (t: number) => void

      Returns () => void

    • Called (at most once a frame) with each preview shown, and with null when it ends. For views that follow the picture while a slider or drag is in progress; returns an unsubscribe.

      Parameters

      • fn: (
            project:
                | {
                    assets: z.ZodMiniRecord<
                        z.ZodMiniString<string>,
                        z.ZodMiniObject<
                            {
                                audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                                credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                                duration: z.ZodMiniInt;
                                fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                                hasAudio: z.ZodMiniBoolean<boolean>;
                                hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                                height: z.ZodMiniOptional<z.ZodMiniInt>;
                                id: z.ZodMiniString<string>;
                                kind: z.ZodMiniEnum<
                                    {
                                        audio: "audio";
                                        compound: "compound";
                                        image: "image";
                                        lut: "lut";
                                        video: "video";
                                    },
                                >;
                                mimeType: z.ZodMiniString<string>;
                                name: z.ZodMiniString<string>;
                                rotation: z.ZodMiniOptional<
                                    z.ZodMiniUnion<
                                        readonly [
                                            z.ZodMiniLiteral<(...)>,
                                            z.ZodMiniLiteral<(...)>,
                                            z.ZodMiniLiteral<(...)>,
                                            z.ZodMiniLiteral<(...)>,
                                        ],
                                    >,
                                >;
                                size: z.ZodMiniInt;
                                source: z.ZodMiniDiscriminatedUnion<
                                    [
                                        z.ZodMiniObject<
                                            { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                            z.core.$strip,
                                        >,
                                        z.ZodMiniObject<
                                            { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                            z.core.$strip,
                                        >,
                                        z.ZodMiniObject<
                                            { type: z.ZodMiniLiteral<(...)>; url: z.ZodMiniString<(...)> },
                                            z.core.$strip,
                                        >,
                                        z.ZodMiniObject<{ type: z.ZodMiniLiteral<(...)> }, z.core.$strip>,
                                    ],
                                    "type",
                                >;
                                tracks: z.ZodMiniOptional<
                                    z.ZodMiniArray<
                                        z.ZodMiniObject<
                                            {
                                                caption: z.ZodMiniOptional<(...)>;
                                                hidden: z.ZodMiniBoolean<(...)>;
                                                id: z.ZodMiniString<(...)>;
                                                items: z.ZodMiniArray<(...)>;
                                                kind: z.ZodMiniEnum<(...)>;
                                                locked: z.ZodMiniBoolean<(...)>;
                                                muted: z.ZodMiniBoolean<(...)>;
                                            },
                                            z.core.$strip,
                                        >,
                                    >,
                                >;
                                vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                                width: z.ZodMiniOptional<z.ZodMiniInt>;
                            },
                            z.core.$strip,
                        >,
                    >;
                    createdAt: string;
                    id: string;
                    markers?: { id: string; label?: string; time: number }[];
                    name: string;
                    settings: {
                        background:
                            | { color: string; type: "color" }
                            | { amount: number; type: "blur" };
                        exportRange?: { end: number; start: number };
                        frameRate: { den: number; num: number };
                        height: number;
                        width: number;
                    };
                    tracks: {
                        caption?: {
                            highlight: "fill"
                            | "none"
                            | "type"
                            | "word"
                            | "box"
                            | "reveal";
                            highlightColor: string;
                            preset: string;
                        };
                        hidden: boolean;
                        id: string;
                        items: (
                            | {
                                adjust: {
                                    brightness?: number;
                                    contrast?: number;
                                    highlights?: number;
                                    saturation?: number;
                                    shadows?: number;
                                    sharpen?: number;
                                    tint?: number;
                                    vignette?: number;
                                    warmth?: number;
                                };
                                animation?: {
                                    in?: (...)
                                    | (...);
                                    loop?: (...) | (...);
                                    out?: (...) | (...);
                                };
                                assetId: string;
                                audioFx?: {
                                    compress?: (...)
                                    | (...);
                                    denoise?: (...) | (...);
                                    eq?: (...) | (...);
                                    keepPitch?: (...) | (...) | (...);
                                    pitch?: (...) | (...);
                                };
                                blend?: | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                                crop: { bottom: number; left: number; right: number; top: number };
                                duck?: number;
                                duration: number;
                                fadeIn: number;
                                fadeOut: number;
                                filter: { id: string; intensity: number } | null;
                                fit: "fit" | "fill";
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                key?: {
                                    color: string;
                                    softness: number;
                                    spill: number;
                                    tolerance: number;
                                };
                                keyframes?: {
                                    opacity?: (...)
                                    | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "video";
                                locked?: boolean;
                                lut?: { assetId: string; intensity: number };
                                mask?: {
                                    feather: number;
                                    invert?: (...) | (...) | (...);
                                    shape: string;
                                };
                                muted: boolean;
                                name?: string;
                                sourceIn: number;
                                speed: number;
                                start: number;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                                transitionIn: | {
                                    direction?: (...)
                                    | (...)
                                    | (...)
                                    | (...)
                                    | (...);
                                    duration: number;
                                    ease?:
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                    type: string;
                                }
                                | null;
                                volume: number;
                            }
                            | {
                                adjust: {
                                    brightness?: number;
                                    contrast?: number;
                                    highlights?: number;
                                    saturation?: number;
                                    shadows?: number;
                                    sharpen?: number;
                                    tint?: number;
                                    vignette?: number;
                                    warmth?: number;
                                };
                                animation?: {
                                    in?: (...)
                                    | (...);
                                    loop?: (...) | (...);
                                    out?: (...) | (...);
                                };
                                assetId: string;
                                blend?: | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                                crop: { bottom: number; left: number; right: number; top: number };
                                cutout?: { assetId: string };
                                duration: number;
                                filter: { id: string; intensity: number } | null;
                                fit: "fit" | "fill";
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                key?: {
                                    color: string;
                                    softness: number;
                                    spill: number;
                                    tolerance: number;
                                };
                                keyframes?: {
                                    opacity?: (...)
                                    | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "image";
                                locked?: boolean;
                                lut?: { assetId: string; intensity: number };
                                mask?: {
                                    feather: number;
                                    invert?: (...) | (...) | (...);
                                    shape: string;
                                };
                                name?: string;
                                start: number;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                                transitionIn: | {
                                    direction?: (...)
                                    | (...)
                                    | (...)
                                    | (...)
                                    | (...);
                                    duration: number;
                                    ease?:
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                    type: string;
                                }
                                | null;
                            }
                            | {
                                adjust: {
                                    brightness?: number;
                                    contrast?: number;
                                    highlights?: number;
                                    saturation?: number;
                                    shadows?: number;
                                    sharpen?: number;
                                    tint?: number;
                                    vignette?: number;
                                    warmth?: number;
                                };
                                animation?: {
                                    in?: (...)
                                    | (...);
                                    loop?: (...) | (...);
                                    out?: (...) | (...);
                                };
                                assetId: string;
                                blend?: | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                                crop: { bottom: number; left: number; right: number; top: number };
                                duration: number;
                                filter: { id: string; intensity: number } | null;
                                fit: "fit" | "fill";
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                key?: {
                                    color: string;
                                    softness: number;
                                    spill: number;
                                    tolerance: number;
                                };
                                keyframes?: {
                                    opacity?: (...)
                                    | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "freeze";
                                locked?: boolean;
                                lut?: { assetId: string; intensity: number };
                                mask?: {
                                    feather: number;
                                    invert?: (...) | (...) | (...);
                                    shape: string;
                                };
                                name?: string;
                                sourceTime: number;
                                start: number;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                                transitionIn: | {
                                    direction?: (...)
                                    | (...)
                                    | (...)
                                    | (...)
                                    | (...);
                                    duration: number;
                                    ease?:
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                    type: string;
                                }
                                | null;
                            }
                            | {
                                assetId: string;
                                audioFx?: {
                                    compress?: (...)
                                    | (...);
                                    denoise?: (...) | (...);
                                    eq?: (...) | (...);
                                    keepPitch?: (...) | (...) | (...);
                                    pitch?: (...) | (...);
                                };
                                duck?: number;
                                duration: number;
                                fadeIn: number;
                                fadeOut: number;
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                kind: "audio";
                                locked?: boolean;
                                muted: boolean;
                                name?: string;
                                sourceIn: number;
                                speed: number;
                                start: number;
                                volume: number;
                            }
                            | {
                                adjust: {
                                    brightness?: number;
                                    contrast?: number;
                                    highlights?: number;
                                    saturation?: number;
                                    shadows?: number;
                                    sharpen?: number;
                                    tint?: number;
                                    vignette?: number;
                                    warmth?: number;
                                };
                                animation?: {
                                    in?: (...)
                                    | (...);
                                    loop?: (...) | (...);
                                    out?: (...) | (...);
                                };
                                blend?: | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                                duration: number;
                                filter: { id: string; intensity: number }
                                | null;
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                keyframes?: {
                                    opacity?: (...) | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "text";
                                locked?: boolean;
                                maxWidth?: number;
                                name?: string;
                                start: number;
                                style: {
                                    align: "left"
                                    | "right"
                                    | "center";
                                    background: { color: ...; padding: ...; radius: ... } | null;
                                    color: string;
                                    fontFamily: string;
                                    fontWeight: number;
                                    italic: boolean;
                                    letterSpacing: number;
                                    lineHeight: number;
                                    outline: { color: ...; width: ... } | null;
                                    shadow: { blur: ...; color: ...; x: ...; y: ... } | null;
                                    size: number;
                                };
                                text: string;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                                unsure?: boolean;
                                words?: { end: ...; start: ...; text: ... }[];
                            }
                            | {
                                adjust: {
                                    brightness?: number;
                                    contrast?: number;
                                    highlights?: number;
                                    saturation?: number;
                                    shadows?: number;
                                    sharpen?: number;
                                    tint?: number;
                                    vignette?: number;
                                    warmth?: number;
                                };
                                animation?: {
                                    in?: (...)
                                    | (...);
                                    loop?: (...) | (...);
                                    out?: (...) | (...);
                                };
                                assetId: string
                                | null;
                                blend?:
                                    | "add"
                                    | "normal"
                                    | "multiply"
                                    | "screen"
                                    | "overlay"
                                    | "soft-light"
                                    | "lighten"
                                    | "darken"
                                    | "difference";
                                cutout?: { assetId: string };
                                duration: number;
                                emoji: string | null;
                                filter: { id: string; intensity: number } | null;
                                groupId?: string;
                                hidden?: boolean;
                                id: string;
                                keyframes?: {
                                    opacity?: (...) | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "sticker";
                                locked?: boolean;
                                name?: string;
                                start: number;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                            }
                            | {
                                amount: number;
                                duration: number;
                                effect: "blur"
                                | "pixelate";
                                groupId?: string;
                                height: number;
                                hidden?: boolean;
                                id: string;
                                keyframes?: {
                                    opacity?: (...) | (...);
                                    rotation?: (...) | (...);
                                    scale?: (...) | (...);
                                    shift?: (...) | (...);
                                    x?: (...) | (...);
                                    y?: (...) | (...);
                                };
                                kind: "region";
                                locked?: boolean;
                                name?: string;
                                shape: "rectangle"
                                | "ellipse";
                                start: number;
                                transform: {
                                    flipX: boolean;
                                    flipY: boolean;
                                    opacity: number;
                                    rotation: number;
                                    scale: number;
                                    x: number;
                                    y: number;
                                };
                                width: number;
                            }
                        )[];
                        kind: "audio"
                        | "text"
                        | "overlay"
                        | "caption"
                        | "main";
                        locked: boolean;
                        muted: boolean;
                    }[];
                    updatedAt: string;
                    version: 6;
                }
                | null,
        ) => void

      Returns () => void

    • A preview is on screen: the engine has drawn a frame with it (the stage moves its own selection frame then on touch, so frame and picture move together).

      Parameters

      • fn: (
            project: {
                assets: z.ZodMiniRecord<
                    z.ZodMiniString<string>,
                    z.ZodMiniObject<
                        {
                            audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                            credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                            duration: z.ZodMiniInt;
                            fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                            hasAudio: z.ZodMiniBoolean<boolean>;
                            hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            height: z.ZodMiniOptional<z.ZodMiniInt>;
                            id: z.ZodMiniString<string>;
                            kind: z.ZodMiniEnum<
                                {
                                    audio: "audio";
                                    compound: "compound";
                                    image: "image";
                                    lut: "lut";
                                    video: "video";
                                },
                            >;
                            mimeType: z.ZodMiniString<string>;
                            name: z.ZodMiniString<string>;
                            rotation: z.ZodMiniOptional<
                                z.ZodMiniUnion<
                                    readonly [
                                        z.ZodMiniLiteral<0>,
                                        z.ZodMiniLiteral<90>,
                                        z.ZodMiniLiteral<180>,
                                        z.ZodMiniLiteral<270>,
                                    ],
                                >,
                            >;
                            size: z.ZodMiniInt;
                            source: z.ZodMiniDiscriminatedUnion<
                                [
                                    z.ZodMiniObject<
                                        { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        {
                                            key: z.ZodMiniString<string>;
                                            type: z.ZodMiniLiteral<"handle">;
                                        },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"compound"> },
                                        z.core.$strip,
                                    >,
                                ],
                                "type",
                            >;
                            tracks: z.ZodMiniOptional<
                                z.ZodMiniArray<
                                    z.ZodMiniObject<
                                        {
                                            caption: z.ZodMiniOptional<z.ZodMiniObject<(...), (...)>>;
                                            hidden: z.ZodMiniBoolean<boolean>;
                                            id: z.ZodMiniString<string>;
                                            items: z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<(...), (...)>>;
                                            kind: z.ZodMiniEnum<
                                                {
                                                    audio: ...;
                                                    caption: ...;
                                                    main: ...;
                                                    overlay: ...;
                                                    text: ...;
                                                },
                                            >;
                                            locked: z.ZodMiniBoolean<boolean>;
                                            muted: z.ZodMiniBoolean<boolean>;
                                        },
                                        z.core.$strip,
                                    >,
                                >,
                            >;
                            vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            width: z.ZodMiniOptional<z.ZodMiniInt>;
                        },
                        z.core.$strip,
                    >,
                >;
                createdAt: string;
                id: string;
                markers?: { id: string; label?: string; time: number }[];
                name: string;
                settings: {
                    background:
                        | { color: string; type: "color" }
                        | { amount: number; type: "blur" };
                    exportRange?: { end: number; start: number };
                    frameRate: { den: number; num: number };
                    height: number;
                    width: number;
                };
                tracks: {
                    caption?: {
                        highlight: "fill"
                        | "none"
                        | "type"
                        | "word"
                        | "box"
                        | "reveal";
                        highlightColor: string;
                        preset: string;
                    };
                    hidden: boolean;
                    id: string;
                    items: (
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "video";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            cutout?: { assetId: string };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "image";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "freeze";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            sourceTime: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            kind: "audio";
                            locked?: boolean;
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            duration: number;
                            filter: { id: string; intensity: number }
                            | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "text";
                            locked?: boolean;
                            maxWidth?: number;
                            name?: string;
                            start: number;
                            style: {
                                align: "left"
                                | "right"
                                | "center";
                                background: { color: string; padding: number; radius: number } | null;
                                color: string;
                                fontFamily: string;
                                fontWeight: number;
                                italic: boolean;
                                letterSpacing: number;
                                lineHeight: number;
                                outline: { color: string; width: number } | null;
                                shadow: { blur: number; color: string; x: number; y: number } | null;
                                size: number;
                            };
                            text: string;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            unsure?: boolean;
                            words?: { end: number; start: number; text: string }[];
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string
                            | null;
                            blend?:
                                | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                            cutout?: { assetId: string };
                            duration: number;
                            emoji: string | null;
                            filter: { id: string; intensity: number } | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "sticker";
                            locked?: boolean;
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                        }
                        | {
                            amount: number;
                            duration: number;
                            effect: "blur"
                            | "pixelate";
                            groupId?: string;
                            height: number;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "region";
                            locked?: boolean;
                            name?: string;
                            shape: "rectangle"
                            | "ellipse";
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            width: number;
                        }
                    )[];
                    kind: "audio"
                    | "text"
                    | "overlay"
                    | "caption"
                    | "main";
                    locked: boolean;
                    muted: boolean;
                }[];
                updatedAt: string;
                version: 6;
            },
        ) => void

      Returns () => void

    • The ratio button: video settings live in the inspector (desktop) or the dock (phone/tablet).

      Returns void

    • Opens a combined clip to edit its inside (the selected one, or itemId): the timeline shows what's in it, the playhead at the same moment of it. Edits change every place that plays it.

      Parameters

      • OptionalitemId: string

      Returns void

    • Opens the context menu for the selection at a point in the editor root (px).

      Parameters

      • x: number
      • y: number

      Returns void

    • Parameters

      Returns void

    • Parameters

      Returns void

    • Opens another saved video (the current one is saved first).

      Parameters

      • id: string

      Returns Promise<void>

    • Pastes what was copied at the playhead, and selects it.

      Returns void

    • Returns void

    • Opens the file picker; start: what's picked goes before the first clip.

      Parameters

      • place: "start" | "playhead" = 'playhead'

      Returns void

    • Picks the key colour of the item being picked for, at canvas point x, y (fractions): the picture's own colour there (without its green screen), from the engine.

      Parameters

      • x: number
      • y: number

      Returns Promise<void>

    • Returns void

    • Plays from…to once and pauses (a preview after picking a transition or an animation). Any user play/pause/seek in between cancels the auto-stop.

      Parameters

      • from: number
      • to: number

      Returns void

    • Shows a not-yet-committed version of the project in the preview (stage drags, sliders before release). Nothing is written to the store or the undo history. Coalesced per frame.

      Parameters

      • recipe:
            | (
                (
                    draft: {
                        assets: z.ZodMiniRecord<
                            z.ZodMiniString<string>,
                            z.ZodMiniObject<
                                {
                                    audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                                    credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                                    duration: z.ZodMiniInt;
                                    fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                                    hasAudio: z.ZodMiniBoolean<boolean>;
                                    hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                                    height: z.ZodMiniOptional<z.ZodMiniInt>;
                                    id: z.ZodMiniString<string>;
                                    kind: z.ZodMiniEnum<
                                        {
                                            audio: "audio";
                                            compound: "compound";
                                            image: "image";
                                            lut: "lut";
                                            video: "video";
                                        },
                                    >;
                                    mimeType: z.ZodMiniString<string>;
                                    name: z.ZodMiniString<string>;
                                    rotation: z.ZodMiniOptional<
                                        z.ZodMiniUnion<
                                            readonly [
                                                z.ZodMiniLiteral<(...)>,
                                                z.ZodMiniLiteral<(...)>,
                                                z.ZodMiniLiteral<(...)>,
                                                z.ZodMiniLiteral<(...)>,
                                            ],
                                        >,
                                    >;
                                    size: z.ZodMiniInt;
                                    source: z.ZodMiniDiscriminatedUnion<
                                        [
                                            z.ZodMiniObject<
                                                { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                                z.core.$strip,
                                            >,
                                            z.ZodMiniObject<
                                                { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                                z.core.$strip,
                                            >,
                                            z.ZodMiniObject<
                                                { type: z.ZodMiniLiteral<(...)>; url: z.ZodMiniString<(...)> },
                                                z.core.$strip,
                                            >,
                                            z.ZodMiniObject<{ type: z.ZodMiniLiteral<(...)> }, z.core.$strip>,
                                        ],
                                        "type",
                                    >;
                                    tracks: z.ZodMiniOptional<
                                        z.ZodMiniArray<
                                            z.ZodMiniObject<
                                                {
                                                    caption: z.ZodMiniOptional<(...)>;
                                                    hidden: z.ZodMiniBoolean<(...)>;
                                                    id: z.ZodMiniString<(...)>;
                                                    items: z.ZodMiniArray<(...)>;
                                                    kind: z.ZodMiniEnum<(...)>;
                                                    locked: z.ZodMiniBoolean<(...)>;
                                                    muted: z.ZodMiniBoolean<(...)>;
                                                },
                                                z.core.$strip,
                                            >,
                                        >,
                                    >;
                                    vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                                    width: z.ZodMiniOptional<z.ZodMiniInt>;
                                },
                                z.core.$strip,
                            >,
                        >;
                        createdAt: string;
                        id: string;
                        markers?: { id: string; label?: string; time: number }[];
                        name: string;
                        settings: {
                            background:
                                | { color: string; type: "color" }
                                | { amount: number; type: "blur" };
                            exportRange?: { end: number; start: number };
                            frameRate: { den: number; num: number };
                            height: number;
                            width: number;
                        };
                        tracks: {
                            caption?: {
                                highlight: "fill"
                                | "none"
                                | "type"
                                | "word"
                                | "box"
                                | "reveal";
                                highlightColor: string;
                                preset: string;
                            };
                            hidden: boolean;
                            id: string;
                            items: (
                                | {
                                    adjust: {
                                        brightness?: number;
                                        contrast?: number;
                                        highlights?: number;
                                        saturation?: number;
                                        shadows?: number;
                                        sharpen?: number;
                                        tint?: number;
                                        vignette?: number;
                                        warmth?: number;
                                    };
                                    animation?: {
                                        in?: (...)
                                        | (...);
                                        loop?: (...) | (...);
                                        out?: (...) | (...);
                                    };
                                    assetId: string;
                                    audioFx?: {
                                        compress?: (...)
                                        | (...);
                                        denoise?: (...) | (...);
                                        eq?: (...) | (...);
                                        keepPitch?: (...) | (...) | (...);
                                        pitch?: (...) | (...);
                                    };
                                    blend?: | "add"
                                    | "normal"
                                    | "multiply"
                                    | "screen"
                                    | "overlay"
                                    | "soft-light"
                                    | "lighten"
                                    | "darken"
                                    | "difference";
                                    crop: { bottom: number; left: number; right: number; top: number };
                                    duck?: number;
                                    duration: number;
                                    fadeIn: number;
                                    fadeOut: number;
                                    filter: { id: string; intensity: number } | null;
                                    fit: "fit" | "fill";
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    key?: {
                                        color: string;
                                        softness: number;
                                        spill: number;
                                        tolerance: number;
                                    };
                                    keyframes?: {
                                        opacity?: (...)
                                        | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "video";
                                    locked?: boolean;
                                    lut?: { assetId: string; intensity: number };
                                    mask?: {
                                        feather: number;
                                        invert?: (...) | (...) | (...);
                                        shape: string;
                                    };
                                    muted: boolean;
                                    name?: string;
                                    sourceIn: number;
                                    speed: number;
                                    start: number;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                    transitionIn: | {
                                        direction?: (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                        duration: number;
                                        ease?:
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...);
                                        type: string;
                                    }
                                    | null;
                                    volume: number;
                                }
                                | {
                                    adjust: {
                                        brightness?: number;
                                        contrast?: number;
                                        highlights?: number;
                                        saturation?: number;
                                        shadows?: number;
                                        sharpen?: number;
                                        tint?: number;
                                        vignette?: number;
                                        warmth?: number;
                                    };
                                    animation?: {
                                        in?: (...)
                                        | (...);
                                        loop?: (...) | (...);
                                        out?: (...) | (...);
                                    };
                                    assetId: string;
                                    blend?: | "add"
                                    | "normal"
                                    | "multiply"
                                    | "screen"
                                    | "overlay"
                                    | "soft-light"
                                    | "lighten"
                                    | "darken"
                                    | "difference";
                                    crop: { bottom: number; left: number; right: number; top: number };
                                    cutout?: { assetId: string };
                                    duration: number;
                                    filter: { id: string; intensity: number } | null;
                                    fit: "fit" | "fill";
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    key?: {
                                        color: string;
                                        softness: number;
                                        spill: number;
                                        tolerance: number;
                                    };
                                    keyframes?: {
                                        opacity?: (...)
                                        | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "image";
                                    locked?: boolean;
                                    lut?: { assetId: string; intensity: number };
                                    mask?: {
                                        feather: number;
                                        invert?: (...) | (...) | (...);
                                        shape: string;
                                    };
                                    name?: string;
                                    start: number;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                    transitionIn: | {
                                        direction?: (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                        duration: number;
                                        ease?:
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...);
                                        type: string;
                                    }
                                    | null;
                                }
                                | {
                                    adjust: {
                                        brightness?: number;
                                        contrast?: number;
                                        highlights?: number;
                                        saturation?: number;
                                        shadows?: number;
                                        sharpen?: number;
                                        tint?: number;
                                        vignette?: number;
                                        warmth?: number;
                                    };
                                    animation?: {
                                        in?: (...)
                                        | (...);
                                        loop?: (...) | (...);
                                        out?: (...) | (...);
                                    };
                                    assetId: string;
                                    blend?: | "add"
                                    | "normal"
                                    | "multiply"
                                    | "screen"
                                    | "overlay"
                                    | "soft-light"
                                    | "lighten"
                                    | "darken"
                                    | "difference";
                                    crop: { bottom: number; left: number; right: number; top: number };
                                    duration: number;
                                    filter: { id: string; intensity: number } | null;
                                    fit: "fit" | "fill";
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    key?: {
                                        color: string;
                                        softness: number;
                                        spill: number;
                                        tolerance: number;
                                    };
                                    keyframes?: {
                                        opacity?: (...)
                                        | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "freeze";
                                    locked?: boolean;
                                    lut?: { assetId: string; intensity: number };
                                    mask?: {
                                        feather: number;
                                        invert?: (...) | (...) | (...);
                                        shape: string;
                                    };
                                    name?: string;
                                    sourceTime: number;
                                    start: number;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                    transitionIn: | {
                                        direction?: (...)
                                        | (...)
                                        | (...)
                                        | (...)
                                        | (...);
                                        duration: number;
                                        ease?:
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...)
                                            | (...);
                                        type: string;
                                    }
                                    | null;
                                }
                                | {
                                    assetId: string;
                                    audioFx?: {
                                        compress?: (...)
                                        | (...);
                                        denoise?: (...) | (...);
                                        eq?: (...) | (...);
                                        keepPitch?: (...) | (...) | (...);
                                        pitch?: (...) | (...);
                                    };
                                    duck?: number;
                                    duration: number;
                                    fadeIn: number;
                                    fadeOut: number;
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    kind: "audio";
                                    locked?: boolean;
                                    muted: boolean;
                                    name?: string;
                                    sourceIn: number;
                                    speed: number;
                                    start: number;
                                    volume: number;
                                }
                                | {
                                    adjust: {
                                        brightness?: number;
                                        contrast?: number;
                                        highlights?: number;
                                        saturation?: number;
                                        shadows?: number;
                                        sharpen?: number;
                                        tint?: number;
                                        vignette?: number;
                                        warmth?: number;
                                    };
                                    animation?: {
                                        in?: (...)
                                        | (...);
                                        loop?: (...) | (...);
                                        out?: (...) | (...);
                                    };
                                    blend?: | "add"
                                    | "normal"
                                    | "multiply"
                                    | "screen"
                                    | "overlay"
                                    | "soft-light"
                                    | "lighten"
                                    | "darken"
                                    | "difference";
                                    duration: number;
                                    filter: { id: string; intensity: number }
                                    | null;
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    keyframes?: {
                                        opacity?: (...) | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "text";
                                    locked?: boolean;
                                    maxWidth?: number;
                                    name?: string;
                                    start: number;
                                    style: {
                                        align: "left"
                                        | "right"
                                        | "center";
                                        background: { color: ...; padding: ...; radius: ... } | null;
                                        color: string;
                                        fontFamily: string;
                                        fontWeight: number;
                                        italic: boolean;
                                        letterSpacing: number;
                                        lineHeight: number;
                                        outline: { color: ...; width: ... } | null;
                                        shadow: { blur: ...; color: ...; x: ...; y: ... } | null;
                                        size: number;
                                    };
                                    text: string;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                    unsure?: boolean;
                                    words?: { end: ...; start: ...; text: ... }[];
                                }
                                | {
                                    adjust: {
                                        brightness?: number;
                                        contrast?: number;
                                        highlights?: number;
                                        saturation?: number;
                                        shadows?: number;
                                        sharpen?: number;
                                        tint?: number;
                                        vignette?: number;
                                        warmth?: number;
                                    };
                                    animation?: {
                                        in?: (...)
                                        | (...);
                                        loop?: (...) | (...);
                                        out?: (...) | (...);
                                    };
                                    assetId: string
                                    | null;
                                    blend?:
                                        | "add"
                                        | "normal"
                                        | "multiply"
                                        | "screen"
                                        | "overlay"
                                        | "soft-light"
                                        | "lighten"
                                        | "darken"
                                        | "difference";
                                    cutout?: { assetId: string };
                                    duration: number;
                                    emoji: string | null;
                                    filter: { id: string; intensity: number } | null;
                                    groupId?: string;
                                    hidden?: boolean;
                                    id: string;
                                    keyframes?: {
                                        opacity?: (...) | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "sticker";
                                    locked?: boolean;
                                    name?: string;
                                    start: number;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                }
                                | {
                                    amount: number;
                                    duration: number;
                                    effect: "blur"
                                    | "pixelate";
                                    groupId?: string;
                                    height: number;
                                    hidden?: boolean;
                                    id: string;
                                    keyframes?: {
                                        opacity?: (...) | (...);
                                        rotation?: (...) | (...);
                                        scale?: (...) | (...);
                                        shift?: (...) | (...);
                                        x?: (...) | (...);
                                        y?: (...) | (...);
                                    };
                                    kind: "region";
                                    locked?: boolean;
                                    name?: string;
                                    shape: "rectangle"
                                    | "ellipse";
                                    start: number;
                                    transform: {
                                        flipX: boolean;
                                        flipY: boolean;
                                        opacity: number;
                                        rotation: number;
                                        scale: number;
                                        x: number;
                                        y: number;
                                    };
                                    width: number;
                                }
                            )[];
                            kind: "audio"
                            | "text"
                            | "overlay"
                            | "caption"
                            | "main";
                            locked: boolean;
                            muted: boolean;
                        }[];
                        updatedAt: string;
                        version: 6;
                    },
                    ctx: EditContext,
                ) => void
            )
            | null

      Returns
          | {
              assets: z.ZodMiniRecord<
                  z.ZodMiniString<string>,
                  z.ZodMiniObject<
                      {
                          audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                          credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                          duration: z.ZodMiniInt;
                          fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                          hasAudio: z.ZodMiniBoolean<boolean>;
                          hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                          height: z.ZodMiniOptional<z.ZodMiniInt>;
                          id: z.ZodMiniString<string>;
                          kind: z.ZodMiniEnum<
                              {
                                  audio: "audio";
                                  compound: "compound";
                                  image: "image";
                                  lut: "lut";
                                  video: "video";
                              },
                          >;
                          mimeType: z.ZodMiniString<string>;
                          name: z.ZodMiniString<string>;
                          rotation: z.ZodMiniOptional<
                              z.ZodMiniUnion<
                                  readonly [
                                      z.ZodMiniLiteral<0>,
                                      z.ZodMiniLiteral<90>,
                                      z.ZodMiniLiteral<180>,
                                      z.ZodMiniLiteral<270>,
                                  ],
                              >,
                          >;
                          size: z.ZodMiniInt;
                          source: z.ZodMiniDiscriminatedUnion<
                              [
                                  z.ZodMiniObject<
                                      { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                      z.core.$strip,
                                  >,
                                  z.ZodMiniObject<
                                      {
                                          key: z.ZodMiniString<string>;
                                          type: z.ZodMiniLiteral<"handle">;
                                      },
                                      z.core.$strip,
                                  >,
                                  z.ZodMiniObject<
                                      { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                      z.core.$strip,
                                  >,
                                  z.ZodMiniObject<
                                      { type: z.ZodMiniLiteral<"compound"> },
                                      z.core.$strip,
                                  >,
                              ],
                              "type",
                          >;
                          tracks: z.ZodMiniOptional<
                              z.ZodMiniArray<
                                  z.ZodMiniObject<
                                      {
                                          caption: z.ZodMiniOptional<z.ZodMiniObject<(...), (...)>>;
                                          hidden: z.ZodMiniBoolean<boolean>;
                                          id: z.ZodMiniString<string>;
                                          items: z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<(...), (...)>>;
                                          kind: z.ZodMiniEnum<
                                              {
                                                  audio: ...;
                                                  caption: ...;
                                                  main: ...;
                                                  overlay: ...;
                                                  text: ...;
                                              },
                                          >;
                                          locked: z.ZodMiniBoolean<boolean>;
                                          muted: z.ZodMiniBoolean<boolean>;
                                      },
                                      z.core.$strip,
                                  >,
                              >,
                          >;
                          vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                          width: z.ZodMiniOptional<z.ZodMiniInt>;
                      },
                      z.core.$strip,
                  >,
              >;
              createdAt: string;
              id: string;
              markers?: { id: string; label?: string; time: number }[];
              name: string;
              settings: {
                  background:
                      | { color: string; type: "color" }
                      | { amount: number; type: "blur" };
                  exportRange?: { end: number; start: number };
                  frameRate: { den: number; num: number };
                  height: number;
                  width: number;
              };
              tracks: {
                  caption?: {
                      highlight: "fill"
                      | "none"
                      | "type"
                      | "word"
                      | "box"
                      | "reveal";
                      highlightColor: string;
                      preset: string;
                  };
                  hidden: boolean;
                  id: string;
                  items: (
                      | {
                          adjust: {
                              brightness?: number;
                              contrast?: number;
                              highlights?: number;
                              saturation?: number;
                              shadows?: number;
                              sharpen?: number;
                              tint?: number;
                              vignette?: number;
                              warmth?: number;
                          };
                          animation?: {
                              in?: { duration: ...; type: ... };
                              loop?: { speed?: ...; type: ... };
                              out?: { duration: ...; type: ... };
                          };
                          assetId: string;
                          audioFx?: {
                              compress?: number;
                              denoise?: number;
                              eq?: { high: ...; low: ...; mid: ... };
                              keepPitch?: boolean;
                              pitch?: number;
                          };
                          blend?: | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                          crop: { bottom: number; left: number; right: number; top: number };
                          duck?: number;
                          duration: number;
                          fadeIn: number;
                          fadeOut: number;
                          filter: { id: string; intensity: number } | null;
                          fit: "fit" | "fill";
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          key?: {
                              color: string;
                              softness: number;
                              spill: number;
                              tolerance: number;
                          };
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "video";
                          locked?: boolean;
                          lut?: { assetId: string; intensity: number };
                          mask?: { feather: number; invert?: boolean; shape: string };
                          muted: boolean;
                          name?: string;
                          sourceIn: number;
                          speed: number;
                          start: number;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                          transitionIn: | {
                              direction?: "left"
                              | "right"
                              | "up"
                              | "down";
                              duration: number;
                              ease?:
                                  | "back"
                                  | "linear"
                                  | "smooth"
                                  | "ease-in"
                                  | "ease-out"
                                  | "snappy"
                                  | "expo"
                                  | "anticipate"
                                  | "bounce"
                                  | "elastic"
                                  | "ball"
                                  | "slow-mo"
                                  | "steps";
                              type: string;
                          }
                          | null;
                          volume: number;
                      }
                      | {
                          adjust: {
                              brightness?: number;
                              contrast?: number;
                              highlights?: number;
                              saturation?: number;
                              shadows?: number;
                              sharpen?: number;
                              tint?: number;
                              vignette?: number;
                              warmth?: number;
                          };
                          animation?: {
                              in?: { duration: ...; type: ... };
                              loop?: { speed?: ...; type: ... };
                              out?: { duration: ...; type: ... };
                          };
                          assetId: string;
                          blend?: | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                          crop: { bottom: number; left: number; right: number; top: number };
                          cutout?: { assetId: string };
                          duration: number;
                          filter: { id: string; intensity: number } | null;
                          fit: "fit" | "fill";
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          key?: {
                              color: string;
                              softness: number;
                              spill: number;
                              tolerance: number;
                          };
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "image";
                          locked?: boolean;
                          lut?: { assetId: string; intensity: number };
                          mask?: { feather: number; invert?: boolean; shape: string };
                          name?: string;
                          start: number;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                          transitionIn: | {
                              direction?: "left"
                              | "right"
                              | "up"
                              | "down";
                              duration: number;
                              ease?:
                                  | "back"
                                  | "linear"
                                  | "smooth"
                                  | "ease-in"
                                  | "ease-out"
                                  | "snappy"
                                  | "expo"
                                  | "anticipate"
                                  | "bounce"
                                  | "elastic"
                                  | "ball"
                                  | "slow-mo"
                                  | "steps";
                              type: string;
                          }
                          | null;
                      }
                      | {
                          adjust: {
                              brightness?: number;
                              contrast?: number;
                              highlights?: number;
                              saturation?: number;
                              shadows?: number;
                              sharpen?: number;
                              tint?: number;
                              vignette?: number;
                              warmth?: number;
                          };
                          animation?: {
                              in?: { duration: ...; type: ... };
                              loop?: { speed?: ...; type: ... };
                              out?: { duration: ...; type: ... };
                          };
                          assetId: string;
                          blend?: | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                          crop: { bottom: number; left: number; right: number; top: number };
                          duration: number;
                          filter: { id: string; intensity: number } | null;
                          fit: "fit" | "fill";
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          key?: {
                              color: string;
                              softness: number;
                              spill: number;
                              tolerance: number;
                          };
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "freeze";
                          locked?: boolean;
                          lut?: { assetId: string; intensity: number };
                          mask?: { feather: number; invert?: boolean; shape: string };
                          name?: string;
                          sourceTime: number;
                          start: number;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                          transitionIn: | {
                              direction?: "left"
                              | "right"
                              | "up"
                              | "down";
                              duration: number;
                              ease?:
                                  | "back"
                                  | "linear"
                                  | "smooth"
                                  | "ease-in"
                                  | "ease-out"
                                  | "snappy"
                                  | "expo"
                                  | "anticipate"
                                  | "bounce"
                                  | "elastic"
                                  | "ball"
                                  | "slow-mo"
                                  | "steps";
                              type: string;
                          }
                          | null;
                      }
                      | {
                          assetId: string;
                          audioFx?: {
                              compress?: number;
                              denoise?: number;
                              eq?: { high: ...; low: ...; mid: ... };
                              keepPitch?: boolean;
                              pitch?: number;
                          };
                          duck?: number;
                          duration: number;
                          fadeIn: number;
                          fadeOut: number;
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          kind: "audio";
                          locked?: boolean;
                          muted: boolean;
                          name?: string;
                          sourceIn: number;
                          speed: number;
                          start: number;
                          volume: number;
                      }
                      | {
                          adjust: {
                              brightness?: number;
                              contrast?: number;
                              highlights?: number;
                              saturation?: number;
                              shadows?: number;
                              sharpen?: number;
                              tint?: number;
                              vignette?: number;
                              warmth?: number;
                          };
                          animation?: {
                              in?: { duration: ...; type: ... };
                              loop?: { speed?: ...; type: ... };
                              out?: { duration: ...; type: ... };
                          };
                          blend?: | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                          duration: number;
                          filter: { id: string; intensity: number }
                          | null;
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "text";
                          locked?: boolean;
                          maxWidth?: number;
                          name?: string;
                          start: number;
                          style: {
                              align: "left"
                              | "right"
                              | "center";
                              background: { color: string; padding: number; radius: number } | null;
                              color: string;
                              fontFamily: string;
                              fontWeight: number;
                              italic: boolean;
                              letterSpacing: number;
                              lineHeight: number;
                              outline: { color: string; width: number } | null;
                              shadow: { blur: number; color: string; x: number; y: number } | null;
                              size: number;
                          };
                          text: string;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                          unsure?: boolean;
                          words?: { end: number; start: number; text: string }[];
                      }
                      | {
                          adjust: {
                              brightness?: number;
                              contrast?: number;
                              highlights?: number;
                              saturation?: number;
                              shadows?: number;
                              sharpen?: number;
                              tint?: number;
                              vignette?: number;
                              warmth?: number;
                          };
                          animation?: {
                              in?: { duration: ...; type: ... };
                              loop?: { speed?: ...; type: ... };
                              out?: { duration: ...; type: ... };
                          };
                          assetId: string
                          | null;
                          blend?:
                              | "add"
                              | "normal"
                              | "multiply"
                              | "screen"
                              | "overlay"
                              | "soft-light"
                              | "lighten"
                              | "darken"
                              | "difference";
                          cutout?: { assetId: string };
                          duration: number;
                          emoji: string | null;
                          filter: { id: string; intensity: number } | null;
                          groupId?: string;
                          hidden?: boolean;
                          id: string;
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "sticker";
                          locked?: boolean;
                          name?: string;
                          start: number;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                      }
                      | {
                          amount: number;
                          duration: number;
                          effect: "blur"
                          | "pixelate";
                          groupId?: string;
                          height: number;
                          hidden?: boolean;
                          id: string;
                          keyframes?: {
                              opacity?: (...)[];
                              rotation?: (...)[];
                              scale?: (...)[];
                              shift?: number;
                              x?: (...)[];
                              y?: (...)[];
                          };
                          kind: "region";
                          locked?: boolean;
                          name?: string;
                          shape: "rectangle"
                          | "ellipse";
                          start: number;
                          transform: {
                              flipX: boolean;
                              flipY: boolean;
                              opacity: number;
                              rotation: number;
                              scale: number;
                              x: number;
                              y: number;
                          };
                          width: number;
                      }
                  )[];
                  kind: "audio"
                  | "text"
                  | "overlay"
                  | "caption"
                  | "main";
                  locked: boolean;
                  muted: boolean;
              }[];
              updatedAt: string;
              version: 6;
          }
          | null

    • Shows the frame at time in the preview without moving the playhead (trimming shows the new edge); null returns the preview to the playhead. Coalesced per frame.

      Parameters

      • time: number | null

      Returns void

    • Returns void

    • "Find": the person picked a missing file again. It must be the same kind of media (a video for a video…); it's stored like an import and the asset points at it — one undo step, items keep their times. Returns false (with a message) when the file doesn't fit.

      Parameters

      • assetId: string
      • file: File

      Returns Promise<boolean>

    • Parameters

      • itemId: string

      Returns Promise<void>

    • Parameters

      • itemId: string
      • name: string

      Returns void

    • Shows the photo's own background again.

      Parameters

      • itemId: string

      Returns void

    • Runs an edit; refused edits show their reason instead of throwing.

      Type Parameters

      • R

      Parameters

      • label: string
      • recipe: (
            draft: {
                assets: z.ZodMiniRecord<
                    z.ZodMiniString<string>,
                    z.ZodMiniObject<
                        {
                            audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                            credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                            duration: z.ZodMiniInt;
                            fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                            hasAudio: z.ZodMiniBoolean<boolean>;
                            hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            height: z.ZodMiniOptional<z.ZodMiniInt>;
                            id: z.ZodMiniString<string>;
                            kind: z.ZodMiniEnum<
                                {
                                    audio: "audio";
                                    compound: "compound";
                                    image: "image";
                                    lut: "lut";
                                    video: "video";
                                },
                            >;
                            mimeType: z.ZodMiniString<string>;
                            name: z.ZodMiniString<string>;
                            rotation: z.ZodMiniOptional<
                                z.ZodMiniUnion<
                                    readonly [
                                        z.ZodMiniLiteral<0>,
                                        z.ZodMiniLiteral<90>,
                                        z.ZodMiniLiteral<180>,
                                        z.ZodMiniLiteral<270>,
                                    ],
                                >,
                            >;
                            size: z.ZodMiniInt;
                            source: z.ZodMiniDiscriminatedUnion<
                                [
                                    z.ZodMiniObject<
                                        { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        {
                                            key: z.ZodMiniString<string>;
                                            type: z.ZodMiniLiteral<"handle">;
                                        },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"compound"> },
                                        z.core.$strip,
                                    >,
                                ],
                                "type",
                            >;
                            tracks: z.ZodMiniOptional<
                                z.ZodMiniArray<
                                    z.ZodMiniObject<
                                        {
                                            caption: z.ZodMiniOptional<z.ZodMiniObject<(...), (...)>>;
                                            hidden: z.ZodMiniBoolean<boolean>;
                                            id: z.ZodMiniString<string>;
                                            items: z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<(...), (...)>>;
                                            kind: z.ZodMiniEnum<
                                                {
                                                    audio: ...;
                                                    caption: ...;
                                                    main: ...;
                                                    overlay: ...;
                                                    text: ...;
                                                },
                                            >;
                                            locked: z.ZodMiniBoolean<boolean>;
                                            muted: z.ZodMiniBoolean<boolean>;
                                        },
                                        z.core.$strip,
                                    >,
                                >,
                            >;
                            vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            width: z.ZodMiniOptional<z.ZodMiniInt>;
                        },
                        z.core.$strip,
                    >,
                >;
                createdAt: string;
                id: string;
                markers?: { id: string; label?: string; time: number }[];
                name: string;
                settings: {
                    background:
                        | { color: string; type: "color" }
                        | { amount: number; type: "blur" };
                    exportRange?: { end: number; start: number };
                    frameRate: { den: number; num: number };
                    height: number;
                    width: number;
                };
                tracks: {
                    caption?: {
                        highlight: "fill"
                        | "none"
                        | "type"
                        | "word"
                        | "box"
                        | "reveal";
                        highlightColor: string;
                        preset: string;
                    };
                    hidden: boolean;
                    id: string;
                    items: (
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "video";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            cutout?: { assetId: string };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "image";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "freeze";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            sourceTime: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            kind: "audio";
                            locked?: boolean;
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            duration: number;
                            filter: { id: string; intensity: number }
                            | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "text";
                            locked?: boolean;
                            maxWidth?: number;
                            name?: string;
                            start: number;
                            style: {
                                align: "left"
                                | "right"
                                | "center";
                                background: { color: string; padding: number; radius: number } | null;
                                color: string;
                                fontFamily: string;
                                fontWeight: number;
                                italic: boolean;
                                letterSpacing: number;
                                lineHeight: number;
                                outline: { color: string; width: number } | null;
                                shadow: { blur: number; color: string; x: number; y: number } | null;
                                size: number;
                            };
                            text: string;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            unsure?: boolean;
                            words?: { end: number; start: number; text: string }[];
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string
                            | null;
                            blend?:
                                | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                            cutout?: { assetId: string };
                            duration: number;
                            emoji: string | null;
                            filter: { id: string; intensity: number } | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "sticker";
                            locked?: boolean;
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                        }
                        | {
                            amount: number;
                            duration: number;
                            effect: "blur"
                            | "pixelate";
                            groupId?: string;
                            height: number;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "region";
                            locked?: boolean;
                            name?: string;
                            shape: "rectangle"
                            | "ellipse";
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            width: number;
                        }
                    )[];
                    kind: "audio"
                    | "text"
                    | "overlay"
                    | "caption"
                    | "main";
                    locked: boolean;
                    muted: boolean;
                }[];
                updatedAt: string;
                version: 6;
            },
            ctx: EditContext,
        ) => R
      • Optionaloptions: { coalesceKey?: string }

      Returns R | undefined

    • Saves the frame under the playhead as a picture at the project's size.

      Parameters

      • options: FrameImageOptions

      Returns Promise<FrameImage>

    • Moves the playhead. Engine seeks are coalesced to one per animation frame (latest wins).

      Parameters

      • time: number

      Returns void

    • Selects an item (closing any open tool, since tools belong to the selection). keepPanel keeps the open panel/tool — used when a panel selects the clip it is about to act on. Picking a group member selects the whole group (only picks just that member); add toggles the item (and its group) in a multi-selection (Shift-click, Layers "Select several").

      Parameters

      • itemId: string | null
      • options: { add?: boolean; keepPanel?: boolean; only?: boolean } = {}

      Returns void

    • ⌘A: every element on screen at the playhead (not the main video, not hidden ones).

      Returns void

    • The group the selection is (null when it isn't exactly one group).

      Returns string | null

    • Returns
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              audioFx?: {
                  compress?: number;
                  denoise?: number;
                  eq?: { high: number; low: number; mid: number };
                  keepPitch?: boolean;
                  pitch?: number;
              };
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              duck?: number;
              duration: number;
              fadeIn: number;
              fadeOut: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "video";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              muted: boolean;
              name?: string;
              sourceIn: number;
              speed: number;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
              volume: number;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              cutout?: { assetId: string };
              duration: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "image";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              name?: string;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              duration: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "freeze";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              name?: string;
              sourceTime: number;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
          }
          | {
              assetId: string;
              audioFx?: {
                  compress?: number;
                  denoise?: number;
                  eq?: { high: number; low: number; mid: number };
                  keepPitch?: boolean;
                  pitch?: number;
              };
              duck?: number;
              duration: number;
              fadeIn: number;
              fadeOut: number;
              groupId?: string;
              hidden?: boolean;
              id: string;
              kind: "audio";
              locked?: boolean;
              muted: boolean;
              name?: string;
              sourceIn: number;
              speed: number;
              start: number;
              volume: number;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              duration: number;
              filter: { id: string; intensity: number }
              | null;
              groupId?: string;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "text";
              locked?: boolean;
              maxWidth?: number;
              name?: string;
              start: number;
              style: {
                  align: "left"
                  | "right"
                  | "center";
                  background: { color: string; padding: number; radius: number } | null;
                  color: string;
                  fontFamily: string;
                  fontWeight: number;
                  italic: boolean;
                  letterSpacing: number;
                  lineHeight: number;
                  outline: { color: string; width: number } | null;
                  shadow: { blur: number; color: string; x: number; y: number } | null;
                  size: number;
              };
              text: string;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              unsure?: boolean;
              words?: { end: number; start: number; text: string }[];
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string
              | null;
              blend?:
                  | "add"
                  | "normal"
                  | "multiply"
                  | "screen"
                  | "overlay"
                  | "soft-light"
                  | "lighten"
                  | "darken"
                  | "difference";
              cutout?: { assetId: string };
              duration: number;
              emoji: string | null;
              filter: { id: string; intensity: number } | null;
              groupId?: string;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "sticker";
              locked?: boolean;
              name?: string;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
          }
          | {
              amount: number;
              duration: number;
              effect: "blur"
              | "pixelate";
              groupId?: string;
              height: number;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "region";
              locked?: boolean;
              name?: string;
              shape: "rectangle"
              | "ellipse";
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              width: number;
          }
          | null

    • Everything selected (one item, a group, or a multi-selection).

      Returns (
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              audioFx?: {
                  compress?: number;
                  denoise?: number;
                  eq?: { high: number; low: number; mid: number };
                  keepPitch?: boolean;
                  pitch?: number;
              };
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              duck?: number;
              duration: number;
              fadeIn: number;
              fadeOut: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "video";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              muted: boolean;
              name?: string;
              sourceIn: number;
              speed: number;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
              volume: number;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              cutout?: { assetId: string };
              duration: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "image";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              name?: string;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string;
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              crop: { bottom: number; left: number; right: number; top: number };
              duration: number;
              filter: { id: string; intensity: number } | null;
              fit: "fit" | "fill";
              groupId?: string;
              hidden?: boolean;
              id: string;
              key?: {
                  color: string;
                  softness: number;
                  spill: number;
                  tolerance: number;
              };
              keyframes?: {
                  opacity?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "freeze";
              locked?: boolean;
              lut?: { assetId: string; intensity: number };
              mask?: { feather: number; invert?: boolean; shape: string };
              name?: string;
              sourceTime: number;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              transitionIn: | {
                  direction?: "left"
                  | "right"
                  | "up"
                  | "down";
                  duration: number;
                  ease?:
                      | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps";
                  type: string;
              }
              | null;
          }
          | {
              assetId: string;
              audioFx?: {
                  compress?: number;
                  denoise?: number;
                  eq?: { high: number; low: number; mid: number };
                  keepPitch?: boolean;
                  pitch?: number;
              };
              duck?: number;
              duration: number;
              fadeIn: number;
              fadeOut: number;
              groupId?: string;
              hidden?: boolean;
              id: string;
              kind: "audio";
              locked?: boolean;
              muted: boolean;
              name?: string;
              sourceIn: number;
              speed: number;
              start: number;
              volume: number;
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              blend?: | "add"
              | "normal"
              | "multiply"
              | "screen"
              | "overlay"
              | "soft-light"
              | "lighten"
              | "darken"
              | "difference";
              duration: number;
              filter: { id: string; intensity: number }
              | null;
              groupId?: string;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "text";
              locked?: boolean;
              maxWidth?: number;
              name?: string;
              start: number;
              style: {
                  align: "left"
                  | "right"
                  | "center";
                  background: { color: string; padding: number; radius: number } | null;
                  color: string;
                  fontFamily: string;
                  fontWeight: number;
                  italic: boolean;
                  letterSpacing: number;
                  lineHeight: number;
                  outline: { color: string; width: number } | null;
                  shadow: { blur: number; color: string; x: number; y: number } | null;
                  size: number;
              };
              text: string;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              unsure?: boolean;
              words?: { end: number; start: number; text: string }[];
          }
          | {
              adjust: {
                  brightness?: number;
                  contrast?: number;
                  highlights?: number;
                  saturation?: number;
                  shadows?: number;
                  sharpen?: number;
                  tint?: number;
                  vignette?: number;
                  warmth?: number;
              };
              animation?: {
                  in?: { duration: number; type: string };
                  loop?: { speed?: number; type: string };
                  out?: { duration: number; type: string };
              };
              assetId: string
              | null;
              blend?:
                  | "add"
                  | "normal"
                  | "multiply"
                  | "screen"
                  | "overlay"
                  | "soft-light"
                  | "lighten"
                  | "darken"
                  | "difference";
              cutout?: { assetId: string };
              duration: number;
              emoji: string | null;
              filter: { id: string; intensity: number } | null;
              groupId?: string;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "sticker";
              locked?: boolean;
              name?: string;
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
          }
          | {
              amount: number;
              duration: number;
              effect: "blur"
              | "pixelate";
              groupId?: string;
              height: number;
              hidden?: boolean;
              id: string;
              keyframes?: {
                  opacity?: {
                      ease?:
                          | "back"
                          | "linear"
                          | "smooth"
                          | "ease-in"
                          | "ease-out"
                          | "snappy"
                          | "expo"
                          | "anticipate"
                          | "bounce"
                          | "elastic"
                          | "ball"
                          | "slow-mo"
                          | "steps"
                          | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  rotation?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  scale?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  shift?: number;
                  x?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
                  y?: {
                      ease?: | "back"
                      | "linear"
                      | "smooth"
                      | "ease-in"
                      | "ease-out"
                      | "snappy"
                      | "expo"
                      | "anticipate"
                      | "bounce"
                      | "elastic"
                      | "ball"
                      | "slow-mo"
                      | "steps"
                      | [number, number, number, number];
                      t: number;
                      v: number;
                  }[];
              };
              kind: "region";
              locked?: boolean;
              name?: string;
              shape: "rectangle"
              | "ellipse";
              start: number;
              transform: {
                  flipX: boolean;
                  flipY: boolean;
                  opacity: number;
                  rotation: number;
                  scale: number;
                  x: number;
                  y: number;
              };
              width: number;
          }
      )[]

    • Puts the selected combined clip's pieces back on the timeline.

      Returns void

    • Opens / closes the camera recorder (it covers the editor while open).

      Parameters

      • open: boolean

      Returns void

    • Restyles every caption (one undo step per change; a slider drag is one).

      Parameters

      • patch: CaptionLookPatch
      • OptionalcoalesceKey: string

      Returns void

    • Parameters

      • itemId: string
      • text: string

      Returns void

    • The part to export starts at the playhead (key I). Its end stays where it was, or is the end of the video when there was none (or it came before the new start).

      Returns void

    • The part to export ends at the playhead (key O); its start stays, or is the video's start.

      Returns void

    • Sets (or clears, null) the part to export as one undoable edit.

      Parameters

      • range: { end: number; start: number } | null

      Returns void

    • Registers the shell's file picker; returns an unregister function.

      Parameters

      • open: (() => void) | null

      Returns () => void

    • Parameters

      • itemId: string
      • hidden: boolean

      Returns void

    • One row of the Layers panel: lock / hide / rename a single item.

      Parameters

      • itemId: string
      • locked: boolean

      Returns void

    • Parameters

      Returns void

    • Parameters

      • on: boolean

      Returns void

    • The editor's root element (preview mode's fullscreen target).

      Parameters

      • root: HTMLElement | null

      Returns void

    • The timeline registers how to zoom around the playhead.

      Parameters

      • handler: ((factor: number) => void) | null

      Returns () => void

    • Speaks text with the host's voice service and adds it as a sound clip at at (default: the playhead). Progress: ui.speechBusy. Returns false when it failed or was stopped.

      Parameters

      • text: string
      • options: { at?: number; speed?: number; voice?: string } = {}

      Returns Promise<boolean>

    • Splits the selection (or the main clip under the playhead) at the playhead.

      Returns void

    • Finds where the scenes change in a video clip (in the analyzer worker, frame by frame) and splits the clip there — one undo step. Progress is in ui.sceneJob. Returns the number of parts (1 = no scene changes), or null when stopped or the video couldn't be read.

      Parameters

      • itemId: string
      • sensitivity: SceneSensitivity = 'normal'

      Returns Promise<number | null>

    • Storage, analyzer, autosave, and media for the opening project.

      Parameters

      • caps: Capabilities
      • initial:
            | {
                assets: z.ZodMiniRecord<
                    z.ZodMiniString<string>,
                    z.ZodMiniObject<
                        {
                            audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                            credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                            duration: z.ZodMiniInt;
                            fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                            hasAudio: z.ZodMiniBoolean<boolean>;
                            hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            height: z.ZodMiniOptional<z.ZodMiniInt>;
                            id: z.ZodMiniString<string>;
                            kind: z.ZodMiniEnum<
                                {
                                    audio: "audio";
                                    compound: "compound";
                                    image: "image";
                                    lut: "lut";
                                    video: "video";
                                },
                            >;
                            mimeType: z.ZodMiniString<string>;
                            name: z.ZodMiniString<string>;
                            rotation: z.ZodMiniOptional<
                                z.ZodMiniUnion<
                                    readonly [
                                        z.ZodMiniLiteral<0>,
                                        z.ZodMiniLiteral<90>,
                                        z.ZodMiniLiteral<180>,
                                        z.ZodMiniLiteral<270>,
                                    ],
                                >,
                            >;
                            size: z.ZodMiniInt;
                            source: z.ZodMiniDiscriminatedUnion<
                                [
                                    z.ZodMiniObject<
                                        { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        {
                                            key: z.ZodMiniString<string>;
                                            type: z.ZodMiniLiteral<"handle">;
                                        },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                        z.core.$strip,
                                    >,
                                    z.ZodMiniObject<
                                        { type: z.ZodMiniLiteral<"compound"> },
                                        z.core.$strip,
                                    >,
                                ],
                                "type",
                            >;
                            tracks: z.ZodMiniOptional<
                                z.ZodMiniArray<
                                    z.ZodMiniObject<
                                        {
                                            caption: z.ZodMiniOptional<z.ZodMiniObject<(...), (...)>>;
                                            hidden: z.ZodMiniBoolean<boolean>;
                                            id: z.ZodMiniString<string>;
                                            items: z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<(...), (...)>>;
                                            kind: z.ZodMiniEnum<
                                                {
                                                    audio: ...;
                                                    caption: ...;
                                                    main: ...;
                                                    overlay: ...;
                                                    text: ...;
                                                },
                                            >;
                                            locked: z.ZodMiniBoolean<boolean>;
                                            muted: z.ZodMiniBoolean<boolean>;
                                        },
                                        z.core.$strip,
                                    >,
                                >,
                            >;
                            vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                            width: z.ZodMiniOptional<z.ZodMiniInt>;
                        },
                        z.core.$strip,
                    >,
                >;
                createdAt: string;
                id: string;
                markers?: { id: string; label?: string; time: number }[];
                name: string;
                settings: {
                    background:
                        | { color: string; type: "color" }
                        | { amount: number; type: "blur" };
                    exportRange?: { end: number; start: number };
                    frameRate: { den: number; num: number };
                    height: number;
                    width: number;
                };
                tracks: {
                    caption?: {
                        highlight: "fill"
                        | "none"
                        | "type"
                        | "word"
                        | "box"
                        | "reveal";
                        highlightColor: string;
                        preset: string;
                    };
                    hidden: boolean;
                    id: string;
                    items: (
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "video";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            cutout?: { assetId: string };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "image";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string;
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            crop: { bottom: number; left: number; right: number; top: number };
                            duration: number;
                            filter: { id: string; intensity: number } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: {
                                color: string;
                                softness: number;
                                spill: number;
                                tolerance: number;
                            };
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "freeze";
                            locked?: boolean;
                            lut?: { assetId: string; intensity: number };
                            mask?: { feather: number; invert?: boolean; shape: string };
                            name?: string;
                            sourceTime: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: "left"
                                | "right"
                                | "up"
                                | "down";
                                duration: number;
                                ease?:
                                    | "back"
                                    | "linear"
                                    | "smooth"
                                    | "ease-in"
                                    | "ease-out"
                                    | "snappy"
                                    | "expo"
                                    | "anticipate"
                                    | "bounce"
                                    | "elastic"
                                    | "ball"
                                    | "slow-mo"
                                    | "steps";
                                type: string;
                            }
                            | null;
                        }
                        | {
                            assetId: string;
                            audioFx?: {
                                compress?: number;
                                denoise?: number;
                                eq?: { high: ...; low: ...; mid: ... };
                                keepPitch?: boolean;
                                pitch?: number;
                            };
                            duck?: number;
                            duration: number;
                            fadeIn: number;
                            fadeOut: number;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            kind: "audio";
                            locked?: boolean;
                            muted: boolean;
                            name?: string;
                            sourceIn: number;
                            speed: number;
                            start: number;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            blend?: | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                            duration: number;
                            filter: { id: string; intensity: number }
                            | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "text";
                            locked?: boolean;
                            maxWidth?: number;
                            name?: string;
                            start: number;
                            style: {
                                align: "left"
                                | "right"
                                | "center";
                                background: { color: string; padding: number; radius: number } | null;
                                color: string;
                                fontFamily: string;
                                fontWeight: number;
                                italic: boolean;
                                letterSpacing: number;
                                lineHeight: number;
                                outline: { color: string; width: number } | null;
                                shadow: { blur: number; color: string; x: number; y: number } | null;
                                size: number;
                            };
                            text: string;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            unsure?: boolean;
                            words?: { end: number; start: number; text: string }[];
                        }
                        | {
                            adjust: {
                                brightness?: number;
                                contrast?: number;
                                highlights?: number;
                                saturation?: number;
                                shadows?: number;
                                sharpen?: number;
                                tint?: number;
                                vignette?: number;
                                warmth?: number;
                            };
                            animation?: {
                                in?: { duration: ...; type: ... };
                                loop?: { speed?: ...; type: ... };
                                out?: { duration: ...; type: ... };
                            };
                            assetId: string
                            | null;
                            blend?:
                                | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                            cutout?: { assetId: string };
                            duration: number;
                            emoji: string | null;
                            filter: { id: string; intensity: number } | null;
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "sticker";
                            locked?: boolean;
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                        }
                        | {
                            amount: number;
                            duration: number;
                            effect: "blur"
                            | "pixelate";
                            groupId?: string;
                            height: number;
                            hidden?: boolean;
                            id: string;
                            keyframes?: {
                                opacity?: (...)[];
                                rotation?: (...)[];
                                scale?: (...)[];
                                shift?: number;
                                x?: (...)[];
                                y?: (...)[];
                            };
                            kind: "region";
                            locked?: boolean;
                            name?: string;
                            shape: "rectangle"
                            | "ellipse";
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            width: number;
                        }
                    )[];
                    kind: "audio"
                    | "text"
                    | "overlay"
                    | "caption"
                    | "main";
                    locked: boolean;
                    muted: boolean;
                }[];
                updatedAt: string;
                version: 6;
            }
            | null

      Returns Promise<void>

    • Green screen "pick from video": the next tap on the stage picks itemId's key colour (null stops picking).

      Parameters

      • itemId: string | null

      Returns void

    • Steps by whole frames (arrow keys).

      Parameters

      • frames: number

      Returns void

    • Whether a sticker image has a background to remove: not when it's animated (a cut-out is one still picture — the animation would stop) or already see-through at its edges (library stickers, cut-out logos). null while not known yet: the check runs once per asset, off the main thread's way (header bytes, a 48 px decode), and bumps stickerChecks when done.

      Parameters

      • assetId: string

      Returns boolean | null

    • Stops everything start() and attachCanvas() began (autosave, analyzer, engine). The controller can be started again — React strict mode unmounts and remounts once in development.

      Returns void

    • "Use it here": takes the project over from the other tab, reloads what that tab saved, and saves from this tab from now on.

      Returns Promise<void>

    • Where the files from the last pickFiles go (read once by the picker's change handler).

      Returns "start" | "playhead"

    • What each action would act on now (shared with the buttons, see targets.ts).

      Returns Targets

    • Parameters

      • message: string
      • tone: "error" | "success" | "info" = 'info'
      • Optionalaction: { label: string; run: () => void }

      Returns void

    • Turns "Lower under voice" on (default amount) or off for the selected music, sounds, clips.

      Returns void

    • Hides or shows the selection (all hidden → show all).

      Returns void

    • Locks or unlocks the selection (all locked → unlock all).

      Returns void

    • Returns void

    • Opens or closes Layers or History (top bar): the left panel on desktop / tablet, the sheet on phones.

      Parameters

      • id: "history" | "layers"

      Returns void

    • Lane header toggle: mutes the main track and audio lanes, hides visual lanes.

      Parameters

      • trackId: string

      Returns void

    • Lane header: locks or unlocks a whole row.

      Parameters

      • trackId: string

      Returns void

    • Parameters

      • label: string
      • itemId: string
      • time: number
      • from: {
            flipX: boolean;
            flipY: boolean;
            opacity: number;
            rotation: number;
            scale: number;
            x: number;
            y: number;
        }
      • to: {
            flipX: boolean;
            flipY: boolean;
            opacity: number;
            rotation: number;
            scale: number;
            x: number;
            y: number;
        }

      Returns void

    • Returns void

    • Undoes an assistant turn's changes — only while they're still the latest step (otherwise undo would take back something else). Returns whether it did.

      Parameters

      • id: number

      Returns boolean

    • Returns void

    • project as the editor shows it (DECISIONS #155): with a combined clip open, a project whose tracks are its inside, drawn at its size (no markers or export range — those are the whole video's). Cached per project object, so selectors stay stable.

      Parameters

      • project: {
            assets: z.ZodMiniRecord<
                z.ZodMiniString<string>,
                z.ZodMiniObject<
                    {
                        audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                        credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                        duration: z.ZodMiniInt;
                        fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                        hasAudio: z.ZodMiniBoolean<boolean>;
                        hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        height: z.ZodMiniOptional<z.ZodMiniInt>;
                        id: z.ZodMiniString<string>;
                        kind: z.ZodMiniEnum<
                            {
                                audio: "audio";
                                compound: "compound";
                                image: "image";
                                lut: "lut";
                                video: "video";
                            },
                        >;
                        mimeType: z.ZodMiniString<string>;
                        name: z.ZodMiniString<string>;
                        rotation: z.ZodMiniOptional<
                            z.ZodMiniUnion<
                                readonly [
                                    z.ZodMiniLiteral<0>,
                                    z.ZodMiniLiteral<90>,
                                    z.ZodMiniLiteral<180>,
                                    z.ZodMiniLiteral<270>,
                                ],
                            >,
                        >;
                        size: z.ZodMiniInt;
                        source: z.ZodMiniDiscriminatedUnion<
                            [
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<
                                    { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                    z.core.$strip,
                                >,
                                z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                            ],
                            "type",
                        >;
                        tracks: z.ZodMiniOptional<
                            z.ZodMiniArray<
                                z.ZodMiniObject<
                                    {
                                        caption: z.ZodMiniOptional<
                                            z.ZodMiniObject<
                                                { highlight: ...; highlightColor: ...; preset: ... },
                                                z.core.$strip,
                                            >,
                                        >;
                                        hidden: z.ZodMiniBoolean<boolean>;
                                        id: z.ZodMiniString<string>;
                                        items: z.ZodMiniArray<
                                            z.ZodMiniDiscriminatedUnion<
                                                [(...), (...), (...), (...), (...), (...), (...)],
                                                "kind",
                                            >,
                                        >;
                                        kind: z.ZodMiniEnum<
                                            {
                                                audio: "audio";
                                                caption: "caption";
                                                main: "main";
                                                overlay: "overlay";
                                                text: "text";
                                            },
                                        >;
                                        locked: z.ZodMiniBoolean<boolean>;
                                        muted: z.ZodMiniBoolean<boolean>;
                                    },
                                    z.core.$strip,
                                >,
                            >,
                        >;
                        vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                        width: z.ZodMiniOptional<z.ZodMiniInt>;
                    },
                    z.core.$strip,
                >,
            >;
            createdAt: string;
            id: string;
            markers?: { id: string; label?: string; time: number }[];
            name: string;
            settings: {
                background:
                    | { color: string; type: "color" }
                    | { amount: number; type: "blur" };
                exportRange?: { end: number; start: number };
                frameRate: { den: number; num: number };
                height: number;
                width: number;
            };
            tracks: {
                caption?: {
                    highlight: "fill"
                    | "none"
                    | "type"
                    | "word"
                    | "box"
                    | "reveal";
                    highlightColor: string;
                    preset: string;
                };
                hidden: boolean;
                id: string;
                items: (
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: number; low: number; mid: number };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "video";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        cutout?: { assetId: string };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "image";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string;
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        crop: { bottom: number; left: number; right: number; top: number };
                        duration: number;
                        filter: { id: string; intensity: number } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: {
                            color: string;
                            softness: number;
                            spill: number;
                            tolerance: number;
                        };
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "freeze";
                        locked?: boolean;
                        lut?: { assetId: string; intensity: number };
                        mask?: { feather: number; invert?: boolean; shape: string };
                        name?: string;
                        sourceTime: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: "left"
                            | "right"
                            | "up"
                            | "down";
                            duration: number;
                            ease?:
                                | "back"
                                | "linear"
                                | "smooth"
                                | "ease-in"
                                | "ease-out"
                                | "snappy"
                                | "expo"
                                | "anticipate"
                                | "bounce"
                                | "elastic"
                                | "ball"
                                | "slow-mo"
                                | "steps";
                            type: string;
                        }
                        | null;
                    }
                    | {
                        assetId: string;
                        audioFx?: {
                            compress?: number;
                            denoise?: number;
                            eq?: { high: number; low: number; mid: number };
                            keepPitch?: boolean;
                            pitch?: number;
                        };
                        duck?: number;
                        duration: number;
                        fadeIn: number;
                        fadeOut: number;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        kind: "audio";
                        locked?: boolean;
                        muted: boolean;
                        name?: string;
                        sourceIn: number;
                        speed: number;
                        start: number;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        blend?: | "add"
                        | "normal"
                        | "multiply"
                        | "screen"
                        | "overlay"
                        | "soft-light"
                        | "lighten"
                        | "darken"
                        | "difference";
                        duration: number;
                        filter: { id: string; intensity: number }
                        | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "text";
                        locked?: boolean;
                        maxWidth?: number;
                        name?: string;
                        start: number;
                        style: {
                            align: "left"
                            | "right"
                            | "center";
                            background: { color: string; padding: number; radius: number } | null;
                            color: string;
                            fontFamily: string;
                            fontWeight: number;
                            italic: boolean;
                            letterSpacing: number;
                            lineHeight: number;
                            outline: { color: string; width: number } | null;
                            shadow: { blur: number; color: string; x: number; y: number } | null;
                            size: number;
                        };
                        text: string;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        unsure?: boolean;
                        words?: { end: number; start: number; text: string }[];
                    }
                    | {
                        adjust: {
                            brightness?: number;
                            contrast?: number;
                            highlights?: number;
                            saturation?: number;
                            shadows?: number;
                            sharpen?: number;
                            tint?: number;
                            vignette?: number;
                            warmth?: number;
                        };
                        animation?: {
                            in?: { duration: number; type: string };
                            loop?: { speed?: (...) | (...); type: string };
                            out?: { duration: number; type: string };
                        };
                        assetId: string
                        | null;
                        blend?:
                            | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                        cutout?: { assetId: string };
                        duration: number;
                        emoji: string | null;
                        filter: { id: string; intensity: number } | null;
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "sticker";
                        locked?: boolean;
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                    }
                    | {
                        amount: number;
                        duration: number;
                        effect: "blur"
                        | "pixelate";
                        groupId?: string;
                        height: number;
                        hidden?: boolean;
                        id: string;
                        keyframes?: {
                            opacity?: { ease?: ...; t: ...; v: ... }[];
                            rotation?: { ease?: ...; t: ...; v: ... }[];
                            scale?: { ease?: ...; t: ...; v: ... }[];
                            shift?: number;
                            x?: { ease?: ...; t: ...; v: ... }[];
                            y?: { ease?: ...; t: ...; v: ... }[];
                        };
                        kind: "region";
                        locked?: boolean;
                        name?: string;
                        shape: "rectangle"
                        | "ellipse";
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        width: number;
                    }
                )[];
                kind: "audio"
                | "text"
                | "overlay"
                | "caption"
                | "main";
                locked: boolean;
                muted: boolean;
            }[];
            updatedAt: string;
            version: 6;
        }

      Returns {
          assets: z.ZodMiniRecord<
              z.ZodMiniString<string>,
              z.ZodMiniObject<
                  {
                      audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                      credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                      duration: z.ZodMiniInt;
                      fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                      hasAudio: z.ZodMiniBoolean<boolean>;
                      hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      height: z.ZodMiniOptional<z.ZodMiniInt>;
                      id: z.ZodMiniString<string>;
                      kind: z.ZodMiniEnum<
                          {
                              audio: "audio";
                              compound: "compound";
                              image: "image";
                              lut: "lut";
                              video: "video";
                          },
                      >;
                      mimeType: z.ZodMiniString<string>;
                      name: z.ZodMiniString<string>;
                      rotation: z.ZodMiniOptional<
                          z.ZodMiniUnion<
                              readonly [
                                  z.ZodMiniLiteral<0>,
                                  z.ZodMiniLiteral<90>,
                                  z.ZodMiniLiteral<180>,
                                  z.ZodMiniLiteral<270>,
                              ],
                          >,
                      >;
                      size: z.ZodMiniInt;
                      source: z.ZodMiniDiscriminatedUnion<
                          [
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"opfs"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { key: z.ZodMiniString<string>; type: z.ZodMiniLiteral<"handle"> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<
                                  { type: z.ZodMiniLiteral<"url">; url: z.ZodMiniString<string> },
                                  z.core.$strip,
                              >,
                              z.ZodMiniObject<{ type: z.ZodMiniLiteral<"compound"> }, z.core.$strip>,
                          ],
                          "type",
                      >;
                      tracks: z.ZodMiniOptional<
                          z.ZodMiniArray<
                              z.ZodMiniObject<
                                  {
                                      caption: z.ZodMiniOptional<
                                          z.ZodMiniObject<
                                              { highlight: ...; highlightColor: ...; preset: ... },
                                              z.core.$strip,
                                          >,
                                      >;
                                      hidden: z.ZodMiniBoolean<boolean>;
                                      id: z.ZodMiniString<string>;
                                      items: z.ZodMiniArray<
                                          z.ZodMiniDiscriminatedUnion<
                                              [(...), (...), (...), (...), (...), (...), (...)],
                                              "kind",
                                          >,
                                      >;
                                      kind: z.ZodMiniEnum<
                                          {
                                              audio: "audio";
                                              caption: "caption";
                                              main: "main";
                                              overlay: "overlay";
                                              text: "text";
                                          },
                                      >;
                                      locked: z.ZodMiniBoolean<boolean>;
                                      muted: z.ZodMiniBoolean<boolean>;
                                  },
                                  z.core.$strip,
                              >,
                          >,
                      >;
                      vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                      width: z.ZodMiniOptional<z.ZodMiniInt>;
                  },
                  z.core.$strip,
              >,
          >;
          createdAt: string;
          id: string;
          markers?: { id: string; label?: string; time: number }[];
          name: string;
          settings: {
              background:
                  | { color: string; type: "color" }
                  | { amount: number; type: "blur" };
              exportRange?: { end: number; start: number };
              frameRate: { den: number; num: number };
              height: number;
              width: number;
          };
          tracks: {
              caption?: {
                  highlight: "fill"
                  | "none"
                  | "type"
                  | "word"
                  | "box"
                  | "reveal";
                  highlightColor: string;
                  preset: string;
              };
              hidden: boolean;
              id: string;
              items: (
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "video";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      cutout?: { assetId: string };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "image";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string;
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      crop: { bottom: number; left: number; right: number; top: number };
                      duration: number;
                      filter: { id: string; intensity: number } | null;
                      fit: "fit" | "fill";
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      key?: {
                          color: string;
                          softness: number;
                          spill: number;
                          tolerance: number;
                      };
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "freeze";
                      locked?: boolean;
                      lut?: { assetId: string; intensity: number };
                      mask?: { feather: number; invert?: boolean; shape: string };
                      name?: string;
                      sourceTime: number;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      transitionIn: | {
                          direction?: "left"
                          | "right"
                          | "up"
                          | "down";
                          duration: number;
                          ease?:
                              | "back"
                              | "linear"
                              | "smooth"
                              | "ease-in"
                              | "ease-out"
                              | "snappy"
                              | "expo"
                              | "anticipate"
                              | "bounce"
                              | "elastic"
                              | "ball"
                              | "slow-mo"
                              | "steps";
                          type: string;
                      }
                      | null;
                  }
                  | {
                      assetId: string;
                      audioFx?: {
                          compress?: number;
                          denoise?: number;
                          eq?: { high: number; low: number; mid: number };
                          keepPitch?: boolean;
                          pitch?: number;
                      };
                      duck?: number;
                      duration: number;
                      fadeIn: number;
                      fadeOut: number;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      kind: "audio";
                      locked?: boolean;
                      muted: boolean;
                      name?: string;
                      sourceIn: number;
                      speed: number;
                      start: number;
                      volume: number;
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      blend?: | "add"
                      | "normal"
                      | "multiply"
                      | "screen"
                      | "overlay"
                      | "soft-light"
                      | "lighten"
                      | "darken"
                      | "difference";
                      duration: number;
                      filter: { id: string; intensity: number }
                      | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "text";
                      locked?: boolean;
                      maxWidth?: number;
                      name?: string;
                      start: number;
                      style: {
                          align: "left"
                          | "right"
                          | "center";
                          background: { color: string; padding: number; radius: number } | null;
                          color: string;
                          fontFamily: string;
                          fontWeight: number;
                          italic: boolean;
                          letterSpacing: number;
                          lineHeight: number;
                          outline: { color: string; width: number } | null;
                          shadow: { blur: number; color: string; x: number; y: number } | null;
                          size: number;
                      };
                      text: string;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      unsure?: boolean;
                      words?: { end: number; start: number; text: string }[];
                  }
                  | {
                      adjust: {
                          brightness?: number;
                          contrast?: number;
                          highlights?: number;
                          saturation?: number;
                          shadows?: number;
                          sharpen?: number;
                          tint?: number;
                          vignette?: number;
                          warmth?: number;
                      };
                      animation?: {
                          in?: { duration: number; type: string };
                          loop?: { speed?: (...) | (...); type: string };
                          out?: { duration: number; type: string };
                      };
                      assetId: string
                      | null;
                      blend?:
                          | "add"
                          | "normal"
                          | "multiply"
                          | "screen"
                          | "overlay"
                          | "soft-light"
                          | "lighten"
                          | "darken"
                          | "difference";
                      cutout?: { assetId: string };
                      duration: number;
                      emoji: string | null;
                      filter: { id: string; intensity: number } | null;
                      groupId?: string;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "sticker";
                      locked?: boolean;
                      name?: string;
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                  }
                  | {
                      amount: number;
                      duration: number;
                      effect: "blur"
                      | "pixelate";
                      groupId?: string;
                      height: number;
                      hidden?: boolean;
                      id: string;
                      keyframes?: {
                          opacity?: { ease?: ...; t: ...; v: ... }[];
                          rotation?: { ease?: ...; t: ...; v: ... }[];
                          scale?: { ease?: ...; t: ...; v: ... }[];
                          shift?: number;
                          x?: { ease?: ...; t: ...; v: ... }[];
                          y?: { ease?: ...; t: ...; v: ... }[];
                      };
                      kind: "region";
                      locked?: boolean;
                      name?: string;
                      shape: "rectangle"
                      | "ellipse";
                      start: number;
                      transform: {
                          flipX: boolean;
                          flipY: boolean;
                          opacity: number;
                          rotation: number;
                          scale: number;
                          x: number;
                          y: number;
                      };
                      width: number;
                  }
              )[];
              kind: "audio"
              | "text"
              | "overlay"
              | "caption"
              | "main";
              locked: boolean;
              muted: boolean;
          }[];
          updatedAt: string;
          version: 6;
      }

    • Resolves once an asset's file is attached (the analyzer and engine have it): at once if it is, else when it arrives. A project opens before its media is read back from storage, so thumbnails wait for this instead of asking too early. Resolves (no wait) if signal aborts.

      Parameters

      • assetId: string
      • Optionalsignal: AbortSignal

      Returns Promise<void>

    • Parameters

      • factor: number

      Returns void

    • Validates a host-provided project (JSON or object).

      Parameters

      • input: unknown

      Returns {
          error: string | null;
          project:
              | {
                  assets: z.ZodMiniRecord<
                      z.ZodMiniString<string>,
                      z.ZodMiniObject<
                          {
                              audioTrack: z.ZodMiniOptional<z.ZodMiniInt>;
                              credit: z.ZodMiniOptional<z.ZodMiniString<string>>;
                              duration: z.ZodMiniInt;
                              fps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
                              hasAudio: z.ZodMiniBoolean<boolean>;
                              hdr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                              height: z.ZodMiniOptional<z.ZodMiniInt>;
                              id: z.ZodMiniString<string>;
                              kind: z.ZodMiniEnum<
                                  {
                                      audio: "audio";
                                      compound: "compound";
                                      image: "image";
                                      lut: "lut";
                                      video: "video";
                                  },
                              >;
                              mimeType: z.ZodMiniString<string>;
                              name: z.ZodMiniString<string>;
                              rotation: z.ZodMiniOptional<
                                  z.ZodMiniUnion<
                                      readonly [
                                          z.ZodMiniLiteral<(...)>,
                                          z.ZodMiniLiteral<(...)>,
                                          z.ZodMiniLiteral<(...)>,
                                          z.ZodMiniLiteral<(...)>,
                                      ],
                                  >,
                              >;
                              size: z.ZodMiniInt;
                              source: z.ZodMiniDiscriminatedUnion<
                                  [
                                      z.ZodMiniObject<
                                          { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                          z.core.$strip,
                                      >,
                                      z.ZodMiniObject<
                                          { key: z.ZodMiniString<(...)>; type: z.ZodMiniLiteral<(...)> },
                                          z.core.$strip,
                                      >,
                                      z.ZodMiniObject<
                                          { type: z.ZodMiniLiteral<(...)>; url: z.ZodMiniString<(...)> },
                                          z.core.$strip,
                                      >,
                                      z.ZodMiniObject<{ type: z.ZodMiniLiteral<(...)> }, z.core.$strip>,
                                  ],
                                  "type",
                              >;
                              tracks: z.ZodMiniOptional<
                                  z.ZodMiniArray<
                                      z.ZodMiniObject<
                                          {
                                              caption: z.ZodMiniOptional<(...)>;
                                              hidden: z.ZodMiniBoolean<(...)>;
                                              id: z.ZodMiniString<(...)>;
                                              items: z.ZodMiniArray<(...)>;
                                              kind: z.ZodMiniEnum<(...)>;
                                              locked: z.ZodMiniBoolean<(...)>;
                                              muted: z.ZodMiniBoolean<(...)>;
                                          },
                                          z.core.$strip,
                                      >,
                                  >,
                              >;
                              vfr: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                              width: z.ZodMiniOptional<z.ZodMiniInt>;
                          },
                          z.core.$strip,
                      >,
                  >;
                  createdAt: string;
                  id: string;
                  markers?: { id: string; label?: string; time: number }[];
                  name: string;
                  settings: {
                      background:
                          | { color: string; type: "color" }
                          | { amount: number; type: "blur" };
                      exportRange?: { end: number; start: number };
                      frameRate: { den: number; num: number };
                      height: number;
                      width: number;
                  };
                  tracks: {
                      caption?: {
                          highlight: "fill"
                          | "none"
                          | "type"
                          | "word"
                          | "box"
                          | "reveal";
                          highlightColor: string;
                          preset: string;
                      };
                      hidden: boolean;
                      id: string;
                      items: (
                          | {
                              adjust: {
                                  brightness?: number;
                                  contrast?: number;
                                  highlights?: number;
                                  saturation?: number;
                                  shadows?: number;
                                  sharpen?: number;
                                  tint?: number;
                                  vignette?: number;
                                  warmth?: number;
                              };
                              animation?: {
                                  in?: (...)
                                  | (...);
                                  loop?: (...) | (...);
                                  out?: (...) | (...);
                              };
                              assetId: string;
                              audioFx?: {
                                  compress?: (...)
                                  | (...);
                                  denoise?: (...) | (...);
                                  eq?: (...) | (...);
                                  keepPitch?: (...) | (...) | (...);
                                  pitch?: (...) | (...);
                              };
                              blend?: | "add"
                              | "normal"
                              | "multiply"
                              | "screen"
                              | "overlay"
                              | "soft-light"
                              | "lighten"
                              | "darken"
                              | "difference";
                              crop: { bottom: number; left: number; right: number; top: number };
                              duck?: number;
                              duration: number;
                              fadeIn: number;
                              fadeOut: number;
                              filter: { id: string; intensity: number } | null;
                              fit: "fit" | "fill";
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              key?: {
                                  color: string;
                                  softness: number;
                                  spill: number;
                                  tolerance: number;
                              };
                              keyframes?: {
                                  opacity?: (...)
                                  | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "video";
                              locked?: boolean;
                              lut?: { assetId: string; intensity: number };
                              mask?: {
                                  feather: number;
                                  invert?: (...) | (...) | (...);
                                  shape: string;
                              };
                              muted: boolean;
                              name?: string;
                              sourceIn: number;
                              speed: number;
                              start: number;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                              transitionIn: | {
                                  direction?: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                                  duration: number;
                                  ease?:
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...);
                                  type: string;
                              }
                              | null;
                              volume: number;
                          }
                          | {
                              adjust: {
                                  brightness?: number;
                                  contrast?: number;
                                  highlights?: number;
                                  saturation?: number;
                                  shadows?: number;
                                  sharpen?: number;
                                  tint?: number;
                                  vignette?: number;
                                  warmth?: number;
                              };
                              animation?: {
                                  in?: (...)
                                  | (...);
                                  loop?: (...) | (...);
                                  out?: (...) | (...);
                              };
                              assetId: string;
                              blend?: | "add"
                              | "normal"
                              | "multiply"
                              | "screen"
                              | "overlay"
                              | "soft-light"
                              | "lighten"
                              | "darken"
                              | "difference";
                              crop: { bottom: number; left: number; right: number; top: number };
                              cutout?: { assetId: string };
                              duration: number;
                              filter: { id: string; intensity: number } | null;
                              fit: "fit" | "fill";
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              key?: {
                                  color: string;
                                  softness: number;
                                  spill: number;
                                  tolerance: number;
                              };
                              keyframes?: {
                                  opacity?: (...)
                                  | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "image";
                              locked?: boolean;
                              lut?: { assetId: string; intensity: number };
                              mask?: {
                                  feather: number;
                                  invert?: (...) | (...) | (...);
                                  shape: string;
                              };
                              name?: string;
                              start: number;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                              transitionIn: | {
                                  direction?: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                                  duration: number;
                                  ease?:
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...);
                                  type: string;
                              }
                              | null;
                          }
                          | {
                              adjust: {
                                  brightness?: number;
                                  contrast?: number;
                                  highlights?: number;
                                  saturation?: number;
                                  shadows?: number;
                                  sharpen?: number;
                                  tint?: number;
                                  vignette?: number;
                                  warmth?: number;
                              };
                              animation?: {
                                  in?: (...)
                                  | (...);
                                  loop?: (...) | (...);
                                  out?: (...) | (...);
                              };
                              assetId: string;
                              blend?: | "add"
                              | "normal"
                              | "multiply"
                              | "screen"
                              | "overlay"
                              | "soft-light"
                              | "lighten"
                              | "darken"
                              | "difference";
                              crop: { bottom: number; left: number; right: number; top: number };
                              duration: number;
                              filter: { id: string; intensity: number } | null;
                              fit: "fit" | "fill";
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              key?: {
                                  color: string;
                                  softness: number;
                                  spill: number;
                                  tolerance: number;
                              };
                              keyframes?: {
                                  opacity?: (...)
                                  | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "freeze";
                              locked?: boolean;
                              lut?: { assetId: string; intensity: number };
                              mask?: {
                                  feather: number;
                                  invert?: (...) | (...) | (...);
                                  shape: string;
                              };
                              name?: string;
                              sourceTime: number;
                              start: number;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                              transitionIn: | {
                                  direction?: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                                  duration: number;
                                  ease?:
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...)
                                      | (...);
                                  type: string;
                              }
                              | null;
                          }
                          | {
                              assetId: string;
                              audioFx?: {
                                  compress?: (...)
                                  | (...);
                                  denoise?: (...) | (...);
                                  eq?: (...) | (...);
                                  keepPitch?: (...) | (...) | (...);
                                  pitch?: (...) | (...);
                              };
                              duck?: number;
                              duration: number;
                              fadeIn: number;
                              fadeOut: number;
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              kind: "audio";
                              locked?: boolean;
                              muted: boolean;
                              name?: string;
                              sourceIn: number;
                              speed: number;
                              start: number;
                              volume: number;
                          }
                          | {
                              adjust: {
                                  brightness?: number;
                                  contrast?: number;
                                  highlights?: number;
                                  saturation?: number;
                                  shadows?: number;
                                  sharpen?: number;
                                  tint?: number;
                                  vignette?: number;
                                  warmth?: number;
                              };
                              animation?: {
                                  in?: (...)
                                  | (...);
                                  loop?: (...) | (...);
                                  out?: (...) | (...);
                              };
                              blend?: | "add"
                              | "normal"
                              | "multiply"
                              | "screen"
                              | "overlay"
                              | "soft-light"
                              | "lighten"
                              | "darken"
                              | "difference";
                              duration: number;
                              filter: { id: string; intensity: number }
                              | null;
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              keyframes?: {
                                  opacity?: (...) | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "text";
                              locked?: boolean;
                              maxWidth?: number;
                              name?: string;
                              start: number;
                              style: {
                                  align: "left"
                                  | "right"
                                  | "center";
                                  background: { color: ...; padding: ...; radius: ... } | null;
                                  color: string;
                                  fontFamily: string;
                                  fontWeight: number;
                                  italic: boolean;
                                  letterSpacing: number;
                                  lineHeight: number;
                                  outline: { color: ...; width: ... } | null;
                                  shadow: { blur: ...; color: ...; x: ...; y: ... } | null;
                                  size: number;
                              };
                              text: string;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                              unsure?: boolean;
                              words?: { end: ...; start: ...; text: ... }[];
                          }
                          | {
                              adjust: {
                                  brightness?: number;
                                  contrast?: number;
                                  highlights?: number;
                                  saturation?: number;
                                  shadows?: number;
                                  sharpen?: number;
                                  tint?: number;
                                  vignette?: number;
                                  warmth?: number;
                              };
                              animation?: {
                                  in?: (...)
                                  | (...);
                                  loop?: (...) | (...);
                                  out?: (...) | (...);
                              };
                              assetId: string
                              | null;
                              blend?:
                                  | "add"
                                  | "normal"
                                  | "multiply"
                                  | "screen"
                                  | "overlay"
                                  | "soft-light"
                                  | "lighten"
                                  | "darken"
                                  | "difference";
                              cutout?: { assetId: string };
                              duration: number;
                              emoji: string | null;
                              filter: { id: string; intensity: number } | null;
                              groupId?: string;
                              hidden?: boolean;
                              id: string;
                              keyframes?: {
                                  opacity?: (...) | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "sticker";
                              locked?: boolean;
                              name?: string;
                              start: number;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                          }
                          | {
                              amount: number;
                              duration: number;
                              effect: "blur"
                              | "pixelate";
                              groupId?: string;
                              height: number;
                              hidden?: boolean;
                              id: string;
                              keyframes?: {
                                  opacity?: (...) | (...);
                                  rotation?: (...) | (...);
                                  scale?: (...) | (...);
                                  shift?: (...) | (...);
                                  x?: (...) | (...);
                                  y?: (...) | (...);
                              };
                              kind: "region";
                              locked?: boolean;
                              name?: string;
                              shape: "rectangle"
                              | "ellipse";
                              start: number;
                              transform: {
                                  flipX: boolean;
                                  flipY: boolean;
                                  opacity: number;
                                  rotation: number;
                                  scale: number;
                                  x: number;
                                  y: number;
                              };
                              width: number;
                          }
                      )[];
                      kind: "audio"
                      | "text"
                      | "overlay"
                      | "caption"
                      | "main";
                      locked: boolean;
                      muted: boolean;
                  }[];
                  updatedAt: string;
                  version: 6;
              }
              | null;
      }