VideoUltra API
    Preparing search index...

    Interface VideoEditorProps

    Props of VideoEditor.

    interface VideoEditorProps {
        animatedStickerLibrary?: string | false;
        assistant?: EditingAssistant;
        audioLibrary?: AudioLibrary;
        autosave?: boolean;
        backend?: "auto" | "webgpu" | "webgl2";
        backgroundRemover?: BackgroundRemover;
        className?: string;
        contrast?: "normal" | "high" | "auto";
        customize?: EditorCustomization;
        density?: "touch" | "auto" | "compact";
        dir?: "ltr" | "rtl";
        initialProject?:
            | string
            | {
                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;
            };
        labels?: Partial<Labels>;
        onClose?: () => void;
        onEvent?: (event: EditorEvent) => void;
        onExport?: (result: ExportResult) => void;
        onExportAudio?: (result: AudioExportResult) => void;
        onReady?: (controller: EditorController) => void;
        onSave?: (
            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;
            },
        ) => void
        | Promise<void>;
        onSaveFrame?: (image: FrameImage) => void;
        onUnsupported?: (capabilities: Capabilities) => void;
        proxies?: "off" | "auto" | "always";
        resolveMedia?: (
            asset: {
                audioTrack?: number;
                credit?: string;
                duration: number;
                fps?: number;
                hasAudio: boolean;
                hdr?: boolean;
                height?: number;
                id: string;
                kind: "video" | "image" | "audio" | "lut" | "compound";
                mimeType: string;
                name: string;
                rotation?: 0 | 90 | 180 | 270;
                size: number;
                source:
                    | { key: string; type: "opfs" }
                    | { key: string; type: "handle" }
                    | { type: "url"; url: string }
                    | { type: "compound" };
                tracks?: {
                    caption?: {
                        highlight: "fill" | "none" | "type" | "word" | "box" | "reveal";
                        highlightColor: string;
                        preset: string;
                    };
                    hidden: boolean;
                    id: string;
                    items: (
                        | {
                            adjust: {
                                brightness?: (...)
                                | (...);
                                contrast?: (...) | (...);
                                highlights?: (...) | (...);
                                saturation?: (...) | (...);
                                shadows?: (...) | (...);
                                sharpen?: (...) | (...);
                                tint?: (...) | (...);
                                vignette?: (...) | (...);
                                warmth?: (...) | (...);
                            };
                            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: ...; intensity: ... } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                            keyframes?: {
                                opacity?: ...;
                                rotation?: ...;
                                scale?: ...;
                                shift?: ...;
                                x?: ...;
                                y?: ...;
                            };
                            kind: "video";
                            locked?: boolean;
                            lut?: { assetId: ...; intensity: ... };
                            mask?: { feather: ...; invert?: ...; shape: ... };
                            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: ...;
                                ease?: ...;
                                type: ...;
                            }
                            | null;
                            volume: number;
                        }
                        | {
                            adjust: {
                                brightness?: (...)
                                | (...);
                                contrast?: (...) | (...);
                                highlights?: (...) | (...);
                                saturation?: (...) | (...);
                                shadows?: (...) | (...);
                                sharpen?: (...) | (...);
                                tint?: (...) | (...);
                                vignette?: (...) | (...);
                                warmth?: (...) | (...);
                            };
                            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: ... };
                            duration: number;
                            filter: { id: ...; intensity: ... } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                            keyframes?: {
                                opacity?: ...;
                                rotation?: ...;
                                scale?: ...;
                                shift?: ...;
                                x?: ...;
                                y?: ...;
                            };
                            kind: "image";
                            locked?: boolean;
                            lut?: { assetId: ...; intensity: ... };
                            mask?: { feather: ...; invert?: ...; shape: ... };
                            name?: string;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: ...;
                                duration: ...;
                                ease?: ...;
                                type: ...;
                            }
                            | null;
                        }
                        | {
                            adjust: {
                                brightness?: (...)
                                | (...);
                                contrast?: (...) | (...);
                                highlights?: (...) | (...);
                                saturation?: (...) | (...);
                                shadows?: (...) | (...);
                                sharpen?: (...) | (...);
                                tint?: (...) | (...);
                                vignette?: (...) | (...);
                                warmth?: (...) | (...);
                            };
                            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: ...; intensity: ... } | null;
                            fit: "fit" | "fill";
                            groupId?: string;
                            hidden?: boolean;
                            id: string;
                            key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                            keyframes?: {
                                opacity?: ...;
                                rotation?: ...;
                                scale?: ...;
                                shift?: ...;
                                x?: ...;
                                y?: ...;
                            };
                            kind: "freeze";
                            locked?: boolean;
                            lut?: { assetId: ...; intensity: ... };
                            mask?: { feather: ...; invert?: ...; shape: ... };
                            name?: string;
                            sourceTime: number;
                            start: number;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            transitionIn: | {
                                direction?: ...;
                                duration: ...;
                                ease?: ...;
                                type: ...;
                            }
                            | 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?: (...)
                                | (...);
                                contrast?: (...) | (...);
                                highlights?: (...) | (...);
                                saturation?: (...) | (...);
                                shadows?: (...) | (...);
                                sharpen?: (...) | (...);
                                tint?: (...) | (...);
                                vignette?: (...) | (...);
                                warmth?: (...) | (...);
                            };
                            animation?: { in?: ...; loop?: ...; out?: ... };
                            blend?:
                                | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                            duration: number;
                            filter: { id: ...; intensity: ... }
                            | 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: (...)
                                | (...)
                                | (...);
                                background: (...) | (...);
                                color: string;
                                fontFamily: string;
                                fontWeight: number;
                                italic: boolean;
                                letterSpacing: number;
                                lineHeight: number;
                                outline: (...) | (...);
                                shadow: (...) | (...);
                                size: number;
                            };
                            text: string;
                            transform: {
                                flipX: boolean;
                                flipY: boolean;
                                opacity: number;
                                rotation: number;
                                scale: number;
                                x: number;
                                y: number;
                            };
                            unsure?: boolean;
                            words?: (...)[];
                        }
                        | {
                            adjust: {
                                brightness?: (...)
                                | (...);
                                contrast?: (...) | (...);
                                highlights?: (...) | (...);
                                saturation?: (...) | (...);
                                shadows?: (...) | (...);
                                sharpen?: (...) | (...);
                                tint?: (...) | (...);
                                vignette?: (...) | (...);
                                warmth?: (...) | (...);
                            };
                            animation?: { in?: ...; loop?: ...; out?: ... };
                            assetId: string | null;
                            blend?:
                                | "add"
                                | "normal"
                                | "multiply"
                                | "screen"
                                | "overlay"
                                | "soft-light"
                                | "lighten"
                                | "darken"
                                | "difference";
                            cutout?: { assetId: ... };
                            duration: number;
                            emoji: string | null;
                            filter: { id: ...; intensity: ... } | 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;
                }[];
                vfr?: boolean;
                width?: number;
            },
        ) => Promise<Blob | null>;
        speech?: SpeechGenerator;
        stickerLibrary?: string | false;
        style?: CSSProperties;
        theme?: ThemeMode;
        themeOverrides?: ThemeOverrides;
        transcriber?: Transcriber;
    }
    Index
    animatedStickerLibrary?: string | false

    Where animated emoji stickers come from (Noto Emoji Animation, CC BY 4.0): a base URL whose <code>/512.webp files are the animations (and <code>/emoji.svg stills for the panel's tiles, optional), or false to hide the Animated tab. Default: Google's public copy. Placed stickers are stored in the project.

    assistant?: EditingAssistant

    AI editing (v0.4): an Assistant panel where people type what they want ("make it warmer", "add a title at the start") and your model's answer is applied as one undo step. Use createChatAssistant({ endpoint }) from @video-ultra/ai with your own server, or implement EditingAssistant. A description of the project (no media) is sent to it. Without it the panel isn't shown.

    audioLibrary?: AudioLibrary

    A music & sound-effects source for the Audio panel: search, categories, a ▶ preview and the licence line per sound, and Add (at the playhead). The picked file is stored in the project like an import (its licence line on the asset as credit), so exports never depend on the source. Without it the Audio panel offers the user's own files and voiceover only — the editor ships no catalogue. createStarterSounds() is a small built-in set of synthesised, CC0 sound effects. Read once, like initialProject.

    autosave?: boolean

    Keep a local autosave and crash-recovery copy in the browser (default true).

    backend?: "auto" | "webgpu" | "webgl2"

    Force a renderer (testing). Default: WebGPU when available, else WebGL2.

    backgroundRemover?: BackgroundRemover

    Removes photo backgrounds: createBackgroundRemover() from the optional @video-ultra/ai package (runs on the device, nothing uploaded), or your own service. Without it the option isn't shown.

    className?: string
    contrast?: "normal" | "high" | "auto"

    normal (default), high (stronger text, borders and focus rings — for low vision or bright sunlight), or auto (high when the OS asks for more contrast).

    Embedding API: hide or reorder built-in tools, add your own panels, top-bar buttons and media sources (see EditorCustomization).

    density?: "touch" | "auto" | "compact"

    Control sizes: auto (default — thumb-sized on touch screens), touch (thumb-sized everywhere) or compact (mouse sizes, also on touch screens).

    dir?: "ltr" | "rtl"

    Text direction of the editor chrome. The timeline always runs left to right.

    initialProject?:
        | string
        | {
            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;
        }

    Project to open (object or JSON string). Without it the last autosaved project reopens, or a new one starts.

    labels?: Partial<Labels>

    Replace any of the editor's text (translation).

    onClose?: () => void

    Shows a close button that calls this.

    onEvent?: (event: EditorEvent) => void

    Everything that happens in the editor (edits, selection, playback, commands, export…).

    onExport?: (result: ExportResult) => void

    Called when an export finishes, with the video file.

    onExportAudio?: (result: AudioExportResult) => void

    Called when a sound-only export finishes, with the sound file.

    onReady?: (controller: EditorController) => void

    Called once the editor is ready, with its controller (programmatic control: play, seek, edits).

    onSave?: (
        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;
        },
    ) => void
    | Promise<void>

    Called about a second after each edit with the current project. This is the durable save — store it.

    onSaveFrame?: (image: FrameImage) => void

    Called when a frame is saved as a picture, with the image file.

    onUnsupported?: (capabilities: Capabilities) => void

    Called when the device can't run the editor (instead of, or as well as, the built-in message).

    proxies?: "off" | "auto" | "always"

    Lighter copies of heavy videos for smooth editing, kept on this device: auto (default) for videos this device would struggle with (4K; 1080p on budget phones), always for every video over 540p, off never. Previews use the copy; exports always use the original.

    resolveMedia?: (
        asset: {
            audioTrack?: number;
            credit?: string;
            duration: number;
            fps?: number;
            hasAudio: boolean;
            hdr?: boolean;
            height?: number;
            id: string;
            kind: "video" | "image" | "audio" | "lut" | "compound";
            mimeType: string;
            name: string;
            rotation?: 0 | 90 | 180 | 270;
            size: number;
            source:
                | { key: string; type: "opfs" }
                | { key: string; type: "handle" }
                | { type: "url"; url: string }
                | { type: "compound" };
            tracks?: {
                caption?: {
                    highlight: "fill" | "none" | "type" | "word" | "box" | "reveal";
                    highlightColor: string;
                    preset: string;
                };
                hidden: boolean;
                id: string;
                items: (
                    | {
                        adjust: {
                            brightness?: (...)
                            | (...);
                            contrast?: (...) | (...);
                            highlights?: (...) | (...);
                            saturation?: (...) | (...);
                            shadows?: (...) | (...);
                            sharpen?: (...) | (...);
                            tint?: (...) | (...);
                            vignette?: (...) | (...);
                            warmth?: (...) | (...);
                        };
                        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: ...; intensity: ... } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                        keyframes?: {
                            opacity?: ...;
                            rotation?: ...;
                            scale?: ...;
                            shift?: ...;
                            x?: ...;
                            y?: ...;
                        };
                        kind: "video";
                        locked?: boolean;
                        lut?: { assetId: ...; intensity: ... };
                        mask?: { feather: ...; invert?: ...; shape: ... };
                        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: ...;
                            ease?: ...;
                            type: ...;
                        }
                        | null;
                        volume: number;
                    }
                    | {
                        adjust: {
                            brightness?: (...)
                            | (...);
                            contrast?: (...) | (...);
                            highlights?: (...) | (...);
                            saturation?: (...) | (...);
                            shadows?: (...) | (...);
                            sharpen?: (...) | (...);
                            tint?: (...) | (...);
                            vignette?: (...) | (...);
                            warmth?: (...) | (...);
                        };
                        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: ... };
                        duration: number;
                        filter: { id: ...; intensity: ... } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                        keyframes?: {
                            opacity?: ...;
                            rotation?: ...;
                            scale?: ...;
                            shift?: ...;
                            x?: ...;
                            y?: ...;
                        };
                        kind: "image";
                        locked?: boolean;
                        lut?: { assetId: ...; intensity: ... };
                        mask?: { feather: ...; invert?: ...; shape: ... };
                        name?: string;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: ...;
                            duration: ...;
                            ease?: ...;
                            type: ...;
                        }
                        | null;
                    }
                    | {
                        adjust: {
                            brightness?: (...)
                            | (...);
                            contrast?: (...) | (...);
                            highlights?: (...) | (...);
                            saturation?: (...) | (...);
                            shadows?: (...) | (...);
                            sharpen?: (...) | (...);
                            tint?: (...) | (...);
                            vignette?: (...) | (...);
                            warmth?: (...) | (...);
                        };
                        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: ...; intensity: ... } | null;
                        fit: "fit" | "fill";
                        groupId?: string;
                        hidden?: boolean;
                        id: string;
                        key?: { color: ...; softness: ...; spill: ...; tolerance: ... };
                        keyframes?: {
                            opacity?: ...;
                            rotation?: ...;
                            scale?: ...;
                            shift?: ...;
                            x?: ...;
                            y?: ...;
                        };
                        kind: "freeze";
                        locked?: boolean;
                        lut?: { assetId: ...; intensity: ... };
                        mask?: { feather: ...; invert?: ...; shape: ... };
                        name?: string;
                        sourceTime: number;
                        start: number;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        transitionIn: | {
                            direction?: ...;
                            duration: ...;
                            ease?: ...;
                            type: ...;
                        }
                        | 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?: (...)
                            | (...);
                            contrast?: (...) | (...);
                            highlights?: (...) | (...);
                            saturation?: (...) | (...);
                            shadows?: (...) | (...);
                            sharpen?: (...) | (...);
                            tint?: (...) | (...);
                            vignette?: (...) | (...);
                            warmth?: (...) | (...);
                        };
                        animation?: { in?: ...; loop?: ...; out?: ... };
                        blend?:
                            | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                        duration: number;
                        filter: { id: ...; intensity: ... }
                        | 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: (...)
                            | (...)
                            | (...);
                            background: (...) | (...);
                            color: string;
                            fontFamily: string;
                            fontWeight: number;
                            italic: boolean;
                            letterSpacing: number;
                            lineHeight: number;
                            outline: (...) | (...);
                            shadow: (...) | (...);
                            size: number;
                        };
                        text: string;
                        transform: {
                            flipX: boolean;
                            flipY: boolean;
                            opacity: number;
                            rotation: number;
                            scale: number;
                            x: number;
                            y: number;
                        };
                        unsure?: boolean;
                        words?: (...)[];
                    }
                    | {
                        adjust: {
                            brightness?: (...)
                            | (...);
                            contrast?: (...) | (...);
                            highlights?: (...) | (...);
                            saturation?: (...) | (...);
                            shadows?: (...) | (...);
                            sharpen?: (...) | (...);
                            tint?: (...) | (...);
                            vignette?: (...) | (...);
                            warmth?: (...) | (...);
                        };
                        animation?: { in?: ...; loop?: ...; out?: ... };
                        assetId: string | null;
                        blend?:
                            | "add"
                            | "normal"
                            | "multiply"
                            | "screen"
                            | "overlay"
                            | "soft-light"
                            | "lighten"
                            | "darken"
                            | "difference";
                        cutout?: { assetId: ... };
                        duration: number;
                        emoji: string | null;
                        filter: { id: ...; intensity: ... } | 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;
            }[];
            vfr?: boolean;
            width?: number;
        },
    ) => Promise<Blob | null>

    Gets bytes for media the host stores itself (assets with url sources).

    Text to speech (v0.4): "Text to speech" in the Audio panel and "Read aloud" on texts add a spoken sound clip. Use createSpeechEndpoint({ endpoint }) from @video-ultra/ai with your own server, or implement SpeechGenerator. Without it these aren't shown.

    stickerLibrary?: string | false

    Where the 3D sticker images come from: a base URL (self-host the MIT-licensed set), or false to offer only emoji, shapes and uploads. Default: a pinned public CDN. Placed stickers are stored in the project, so exports never depend on it.

    style?: CSSProperties
    theme?: ThemeMode

    dark (default), light or auto (follow the OS).

    themeOverrides?: ThemeOverrides

    Typed overrides for the common theme tokens.

    transcriber?: Transcriber

    Turns speech into timed words for Auto captions: createOnDeviceTranscriber() from the optional @video-ultra/captions package (English, on the device, nothing uploaded), or your own service for any language. Without it, captions can still be imported (.srt / .vtt) or typed.