VideoUltra API
    Preparing search index...

    Interface UiState

    UI-only state (selection, panels, playback flag). The project lives in the core editor store.

    interface UiState {
        announcement: string;
        assistantBusy: boolean;
        assistantTurns: AssistantTurn[];
        cameraOpen: boolean;
        captionEditing: string | null;
        captionJob:
            | {
                fraction: number;
                loaded?: number;
                stage: "download"
                | "listen"
                | "transcribe";
                total?: number;
            }
            | null;
        countdown: number
        | null;
        cutoutJob:
            | { fraction: number; itemId: string; stage: "download"
            | "work" }
            | null;
        exportOpen: boolean;
        helpOpen: boolean;
        imports: ImportRow[];
        inside: readonly {
            assetId: string;
            itemId: string;
            name: string;
            outerTime: number;
        }[];
        layersSelecting: boolean;
        layout: LayoutMode;
        mediaProblems: MediaProblem[];
        menu: { x: number; y: number }
        | null;
        panel: PanelId | null;
        persistent: boolean | null;
        picking: string | null;
        playing: boolean;
        previewMode: boolean;
        proxyJobs: Record<string, number>;
        pxPerSecond: number;
        readOnly: boolean;
        recording: boolean;
        save: "saved" | "saving" | "idle";
        sceneJob: { fraction: number; itemId: string } | null;
        selectedId: string | null;
        selectedIds: readonly string[];
        sheetPanel: boolean;
        speechBusy: boolean;
        status: "error" | "loading" | "ready" | "unsupported" | "stopped";
        statusMessage: string | null;
        stickerChecks: number;
        toasts: Toast[];
        tool: ToolId | null;
        videosOpen: boolean;
    }
    Index
    announcement: string

    Last screen-reader announcement (a polite live region reads it).

    assistantBusy: boolean
    assistantTurns: AssistantTurn[]

    AI editing (v0.4): this session's conversation, and whether a request is out.

    cameraOpen: boolean

    The camera recorder covers the editor (v0.2 D. Capture & export).

    captionEditing: string | null

    A caption whose text box should take focus in the Captions panel.

    captionJob:
        | {
            fraction: number;
            loaded?: number;
            stage: "download"
            | "listen"
            | "transcribe";
            total?: number;
        }
        | null

    Auto captions running: what it's doing and how far (null = not running).

    countdown: number | null

    Voiceover: 3, 2, 1 shown on the video before recording starts; null otherwise.

    cutoutJob:
        | { fraction: number; itemId: string; stage: "download"
        | "work" }
        | null

    Background removal running (v0.3): for which item, what it's doing, how far.

    exportOpen: boolean
    helpOpen: boolean
    imports: ImportRow[]
    inside: readonly {
        assetId: string;
        itemId: string;
        name: string;
        outerTime: number;
    }[]

    Combined clips opened for editing, outermost first (DECISIONS #155): the timeline, stage and inspector show the innermost one's inside. outerTime: the playhead before it opened.

    layersSelecting: boolean

    Layers panel: tapping rows adds to the selection (phones have no Shift key).

    layout: LayoutMode
    mediaProblems: MediaProblem[]

    Media files that couldn't be opened, in project order: the banner asks or re-links them.

    menu: { x: number; y: number } | null

    The context menu, at a point in the editor root (px).

    panel: PanelId | null
    persistent: boolean | null
    picking: string | null

    Green screen "pick from video": the next tap on the stage picks this item's key colour.

    playing: boolean
    previewMode: boolean

    Only the video and play controls (works everywhere, incl. iPhone).

    proxyJobs: Record<string, number>

    Proxies being made (v0.4): asset id → 0…1.

    pxPerSecond: number

    Timeline zoom: pixels per second.

    readOnly: boolean

    This project is open (and saving) in another tab: this one doesn't save until it takes over.

    recording: boolean
    save: "saved" | "saving" | "idle"
    sceneJob: { fraction: number; itemId: string } | null

    Scene detection running (v0.4): on which clip, how far.

    selectedId: string | null

    The selected item the tools act on (the last one picked).

    selectedIds: readonly string[]

    Everything selected, selectedId included (several after Shift-click, Select all, or picking a group). Empty when nothing is selected.

    sheetPanel: boolean

    Phone/tablet: the add panel is open in the sheet.

    speechBusy: boolean

    Text to speech (v0.4) is generating.

    status: "error" | "loading" | "ready" | "unsupported" | "stopped"

    stopped: the engine died mid-session (the project is safe; reload to continue).

    statusMessage: string | null
    stickerChecks: number

    Bumped when a sticker's "has a background to remove" check finishes (re-shows the tools).

    toasts: Toast[]
    tool: ToolId | null
    videosOpen: boolean

    "Your videos" popover (top bar).