@kitsra/kavio-builder 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,863 @@
+import { type CompositionTiming, type KavioDocument, type ValidationResult } from "@kitsra/kavio-schema";
+export type { KavioError, ValidationResult } from "@kitsra/kavio-schema";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type AuthorValue = JsonValue | PropReference | AssetReference | TimingDefinition | TransitionDefinition | AuthorValue[] | {
+    [key: string]: AuthorValue | undefined;
+} | undefined;
+export type AssetType = "video" | "image" | "audio" | "font";
+export type LayerType = "video" | "image" | "text" | "shape" | "caption";
+export type Fit = "cover" | "contain" | "fill" | "none";
+export type Anchor = "top-left" | "top" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom" | "bottom-right" | {
+    x: number;
+    y: number;
+};
+export type EasingName = "linear" | "inQuad" | "outQuad" | "inOutQuad" | "inCubic" | "outCubic" | "inOutCubic" | "inCirc" | "outCirc" | "inOutCirc" | "inExpo" | "outExpo" | "inOutExpo" | "anticipate" | "back" | "inBack" | "outBack" | "inOutBack" | "inElastic" | "outElastic" | "inOutElastic" | "inBounce" | "outBounce" | "inOutBounce" | `cubic-bezier(${number},${number},${number},${number})`;
+export type AnimatableProperty = "opacity" | "x" | "y" | "scale" | "rotation";
+export type TransitionType = "fade" | "slide" | "wipe" | "crossfade" | "zoom" | "push" | "spin" | "rotate" | "flip" | "blurDissolve" | "colorDissolve" | "dip" | "iris" | "stretch" | "squeeze" | "clockWipe" | "barWipe" | "gridWipe" | "tileReveal" | "radialBlur" | "zoomBlur" | "bookFlip" | "pageCurlLite" | "skewSlide" | "expandMask" | "letterboxReveal" | "filmFlash" | "cameraWhip";
+export type TransitionDirection = "up" | "down" | "left" | "right";
+export type TransitionAxis = "x" | "y";
+export type TransitionShape = "circle" | "diamond";
+export type CameraMotionDirection = "up" | "down" | "left" | "right" | "center";
+export type TextMotionType = "typeOn" | "cascade" | "scramble" | "highlightSweep" | "trackingIn";
+export type TextMotionSplitMode = "none" | "word" | "char" | "line";
+export type TextMotionOrigin = "start" | "center" | "end";
+export type CameraSafeArea = number | {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+};
+export type PropType = "string" | "number" | "boolean" | "color" | "url" | "enum" | "asset";
+export type ExportFormat = "mp4" | "webm" | "mov" | "gif" | "png-sequence";
+export type VideoCropMode = "center" | "subject";
+export interface PropMetadata {
+    type: PropType;
+    required?: boolean;
+    default?: JsonValue;
+    maxLength?: number;
+    options?: JsonPrimitive[];
+    description?: string;
+    [key: string]: AuthorValue;
+}
+export interface AssetOptions {
+    trimStartFrames?: number;
+    trimEndFrames?: number | null;
+    loop?: boolean;
+    checksum?: string;
+    family?: string;
+    weight?: number;
+    style?: string;
+    [key: string]: AuthorValue;
+}
+export interface CommonLayerOptions {
+    startFrame: number;
+    durationFrames: number;
+    x?: AuthorValue;
+    y?: AuthorValue;
+    width?: AuthorValue;
+    height?: AuthorValue;
+    position?: AuthorValue;
+    anchor?: AuthorValue;
+    size?: AuthorValue;
+    opacity?: AuthorValue;
+    rotation?: AuthorValue;
+    scale?: AuthorValue;
+    z?: AuthorValue;
+    track?: AuthorValue;
+    keyframes?: AuthorValue;
+    effects?: AuthorValue;
+    transitionIn?: TransitionDefinition | AuthorValue;
+    transitionOut?: TransitionDefinition | AuthorValue;
+    [key: string]: AuthorValue;
+}
+export interface VideoLayerOptions extends CommonLayerOptions {
+    asset: AssetReference | string;
+    fit?: Fit;
+    crop?: AuthorValue;
+    muted?: boolean;
+    volume?: number;
+    playbackRate?: number;
+}
+export interface ImageLayerOptions extends CommonLayerOptions {
+    asset: AssetReference | string;
+    fit?: Fit;
+}
+export interface TextLayerOptions extends CommonLayerOptions {
+    text: AuthorValue;
+    style?: AuthorValue;
+    textMotion?: AuthorValue;
+}
+export interface ShapeLayerOptions extends CommonLayerOptions {
+    shape?: "rect";
+    fill?: AuthorValue;
+    stroke?: AuthorValue;
+    radius?: AuthorValue;
+}
+export interface CaptionLayerOptions extends CommonLayerOptions {
+    source: AuthorValue;
+    style?: AuthorValue;
+    safeArea?: AuthorValue;
+}
+export interface AudioOptions {
+    id?: string;
+    asset: AssetReference | string;
+    role?: "music" | "voiceover" | "sfx" | "source";
+    startFrame?: number;
+    durationFrames?: number;
+    volume?: number;
+    fadeInFrames?: number;
+    fadeOutFrames?: number;
+    [key: string]: AuthorValue;
+}
+export interface ExportOptions {
+    name?: string;
+    format?: ExportFormat;
+    codec?: string;
+    width?: number;
+    height?: number;
+    fps?: number;
+    bitrate?: string;
+    crf?: number;
+    audioCodec?: string;
+    audioBitrate?: string;
+    loudnessLufs?: number;
+    background?: string | null;
+    layerOverrides?: AuthorValue;
+    [key: string]: AuthorValue;
+}
+export interface CustomExportOptions extends ExportOptions {
+    name: string;
+    width: number;
+    height: number;
+}
+export interface SocialExportOptions {
+    instagramReels?: ExportOptions | false;
+    tiktok?: ExportOptions | false;
+    youtubeShorts?: ExportOptions | false;
+    facebookReels?: ExportOptions | false;
+    reels?: ExportOptions | false;
+    square?: ExportOptions | false;
+    portrait?: ExportOptions | false;
+    landscape?: ExportOptions | false;
+}
+export interface SocialMediaPresetDefinition {
+    id: string;
+    label: string;
+    platform: string;
+    aspectRatio: string;
+    width: number;
+    height: number;
+    fps?: number;
+    defaultName: string;
+    preset: ExportOptions;
+}
+export interface SubjectCropKeyframe {
+    frame: number;
+    x: number;
+    y: number;
+    easing?: EasingName;
+}
+export interface SubjectCropOptions {
+    x?: number;
+    y?: number;
+    keyframes?: readonly SubjectCropKeyframe[];
+    smoothingFrames?: number;
+    source?: string;
+}
+export interface Keyframe {
+    frame: number;
+    value: AuthorValue;
+    easing?: EasingName;
+    timing?: TimingDefinition;
+}
+export interface TransitionDefinition {
+    type: TransitionType;
+    durationFrames?: number | undefined;
+    direction?: TransitionDirection | undefined;
+    axis?: TransitionAxis | undefined;
+    shape?: TransitionShape | undefined;
+    color?: string | undefined;
+    amount?: number | undefined;
+    intensity?: number | undefined;
+    rows?: number | undefined;
+    columns?: number | undefined;
+    easing?: EasingName | undefined;
+    timing?: TimingDefinition | undefined;
+    [key: string]: AuthorValue;
+}
+export type TransitionOptions = Omit<TransitionDefinition, "type">;
+export interface TweenTimingDefinition {
+    type: "tween";
+    durationFrames?: number;
+    easing?: EasingName;
+}
+export interface SpringTimingDefinition {
+    type: "spring";
+    durationFrames?: number;
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    restSpeed?: number;
+    bounce?: number;
+}
+export interface StepsTimingDefinition {
+    type: "steps";
+    durationFrames?: number;
+    steps: number;
+    direction?: "start" | "end";
+}
+export interface SequenceTimingSegment {
+    durationFrames: number;
+    timing?: TimingDefinition;
+    from?: number;
+    to?: number;
+}
+export interface SequenceTimingDefinition {
+    type: "sequence";
+    segments: SequenceTimingSegment[];
+}
+export interface StaggerTimingDefinition {
+    type: "stagger";
+    timing: TimingDefinition;
+    childCount: number;
+    eachFrames: number;
+    childIndex?: number;
+    from?: "start" | "center" | "end";
+}
+export type TimingDefinition = TweenTimingDefinition | SpringTimingDefinition | StepsTimingDefinition | SequenceTimingDefinition | StaggerTimingDefinition;
+export interface TransitionSeriesDefinition {
+    presentation: {
+        type: TransitionType;
+        direction?: TransitionDirection;
+        axis?: TransitionAxis;
+        shape?: TransitionShape;
+        color?: string;
+        amount?: number;
+        intensity?: number;
+        rows?: number;
+        columns?: number;
+    };
+    timing: {
+        type: "tween";
+        durationFrames: number;
+        easing?: EasingName;
+    };
+}
+export interface TrackClipOptions {
+    layerId: string | LayerBuilder;
+    startFrame: number;
+    durationFrames: number;
+    transitionFromPrevious?: TransitionSeriesDefinition | TransitionDefinition;
+}
+export interface TrackClipDefinition {
+    id: string;
+    layerId: string;
+    startFrame: number;
+    durationFrames: number;
+    transitionFromPrevious?: TransitionSeriesDefinition;
+}
+export interface TrackDefinition {
+    id: string;
+    clips: TrackClipDefinition[];
+}
+export interface CameraMotionOptions {
+    durationFrames: number;
+    easing?: EasingName;
+    intensity?: number;
+    safeArea?: CameraSafeArea;
+    subjectAnchor?: Anchor;
+}
+export interface CameraZoomOptions extends CameraMotionOptions {
+    fromScale?: number;
+    toScale?: number;
+}
+export interface CameraKenBurnsOptions extends CameraZoomOptions {
+    direction?: CameraMotionDirection;
+    amount?: number;
+    restingX?: number;
+    restingY?: number;
+}
+export interface CameraPanOptions extends CameraMotionOptions {
+    direction?: "left" | "right";
+    amount?: number;
+    restingX?: number;
+    fromX?: number;
+    toX?: number;
+    scale?: number;
+}
+export interface CameraTiltOptions extends CameraMotionOptions {
+    direction?: "up" | "down";
+    amount?: number;
+    restingY?: number;
+    fromY?: number;
+    toY?: number;
+    scale?: number;
+}
+export interface CameraParallaxOptions extends CameraMotionOptions {
+    direction?: CameraMotionDirection;
+    amount?: number;
+    restingX?: number;
+    restingY?: number;
+    fromX?: number;
+    toX?: number;
+    fromY?: number;
+    toY?: number;
+    fromScale?: number;
+    toScale?: number;
+}
+export interface CameraOrbitLiteOptions extends CameraMotionOptions {
+    direction?: "left" | "right";
+    amount?: number;
+    verticalAmount?: number;
+    rotationAmount?: number;
+    restingX?: number;
+    restingY?: number;
+    restingRotation?: number;
+    fromScale?: number;
+    toScale?: number;
+}
+export interface CameraHandheldOptions extends CameraMotionOptions {
+    seed?: number;
+    amount?: number;
+    rotationAmount?: number;
+    restingX?: number;
+    restingY?: number;
+    restingRotation?: number;
+    intervalFrames?: number;
+    scale?: number;
+}
+export interface CameraCrashZoomOptions extends CameraMotionOptions {
+    direction?: "in" | "out";
+    fromScale?: number;
+    toScale?: number;
+    overshootScale?: number;
+    impactFrame?: number;
+}
+export interface CameraDollyZoomLiteOptions extends CameraMotionOptions {
+    direction?: "in" | "out";
+    fromScale?: number;
+    toScale?: number;
+    amount?: number;
+    restingX?: number;
+    restingY?: number;
+    fromX?: number;
+    toX?: number;
+    fromY?: number;
+    toY?: number;
+}
+export interface CinematicPresetOptions {
+    durationFrames?: number;
+    easing?: EasingName;
+    intensity?: number;
+}
+export interface CinematicDirectionalPresetOptions extends CinematicPresetOptions {
+    direction?: TransitionDirection;
+}
+export interface CinematicColorPresetOptions extends CinematicPresetOptions {
+    color?: string;
+}
+export interface CinematicIrisPresetOptions extends CinematicPresetOptions {
+    shape?: TransitionShape;
+}
+export interface CinematicFlipPresetOptions extends CinematicDirectionalPresetOptions {
+    axis?: TransitionAxis;
+}
+export interface CinematicGlitchCutOptions extends CinematicDirectionalPresetOptions {
+    seed?: number;
+}
+export interface CinematicKenBurnsOptions {
+    durationFrames?: number;
+    fromScale?: number;
+    toScale?: number;
+    fromX?: number;
+    toX?: number;
+    fromY?: number;
+    toY?: number;
+    easing?: EasingName;
+    subject?: {
+        fromX: number;
+        fromY: number;
+        toX: number;
+        toY: number;
+        smoothingFrames?: number;
+        source?: string;
+    };
+}
+export interface CinematicLogoStingOptions extends CinematicPresetOptions {
+    direction?: TransitionDirection;
+}
+export interface CinematicProductRevealOptions extends CinematicPresetOptions {
+    direction?: TransitionDirection;
+}
+export interface CinematicSocialHookOptions extends CinematicDirectionalPresetOptions {
+    color?: string;
+}
+export interface CinematicTitleSequenceOptions extends CinematicDirectionalPresetOptions {
+    exitDirection?: TransitionDirection;
+}
+export interface CinematicEndCardOptions extends CinematicColorPresetOptions {
+    direction?: TransitionDirection;
+}
+export interface CinematicLayerPreset {
+    transitionIn?: TransitionDefinition;
+    transitionOut?: TransitionDefinition;
+    keyframes?: AuthorValue;
+    crop?: AuthorValue;
+}
+export interface TextMotionDefinition {
+    transitionIn?: TransitionDefinition;
+    keyframes?: KeyframeMap;
+    textMotion?: TextMotionPresetDefinition;
+}
+export interface TextMotionOptions {
+    durationFrames?: number;
+    easing?: EasingName;
+}
+export interface TextMotionPresetDefinition {
+    type: TextMotionType;
+    split?: TextMotionSplitMode;
+    durationFrames?: number;
+    easing?: EasingName;
+    staggerFrames?: number;
+    origin?: TextMotionOrigin;
+    seed?: number;
+    preserveLayout?: boolean;
+    restingBox?: {
+        width?: number;
+        height?: number;
+    };
+    direction?: Extract<TransitionDirection, "up" | "down" | "left" | "right">;
+    amount?: number;
+    intensity?: number;
+    color?: string;
+}
+export interface TextMotionSplitOptions extends TextMotionOptions {
+    split?: TextMotionSplitMode;
+    staggerFrames?: number;
+    origin?: TextMotionOrigin;
+    seed?: number;
+    preserveLayout?: boolean;
+    restingBox?: {
+        width?: number;
+        height?: number;
+    };
+}
+export interface TextMotionRiseOptions extends TextMotionOptions {
+    direction?: Extract<TransitionDirection, "up" | "down">;
+}
+export interface TextMotionBlurInOptions extends TextMotionOptions {
+    amount?: number;
+    intensity?: number;
+}
+export interface TextMotionCascadeOptions extends TextMotionSplitOptions {
+    direction?: Extract<TransitionDirection, "up" | "down" | "left" | "right">;
+    amount?: number;
+    intensity?: number;
+}
+export interface TextMotionScrambleOptions extends TextMotionSplitOptions {
+}
+export interface TextMotionHighlightSweepOptions extends TextMotionSplitOptions {
+    color?: string;
+    intensity?: number;
+}
+export interface TextMotionTrackingInOptions extends TextMotionSplitOptions {
+    amount?: number;
+    intensity?: number;
+}
+export type KeyframeTuple = readonly [frame: number, value: AuthorValue, easing?: EasingName];
+export type KeyframeInput = Keyframe | KeyframeTuple;
+export type KeyframeMap = Partial<Record<AnimatableProperty, readonly Keyframe[]>>;
+export declare class PropReference {
+    readonly name: string;
+    readonly metadata?: PropMetadata;
+    constructor(name: string, metadata?: PropMetadata);
+    toString(): string;
+    toJSON(): string;
+}
+export declare class AssetReference {
+    readonly id: string;
+    readonly type: AssetType;
+    private readonly definition;
+    constructor(id: string, type: AssetType, src: AuthorValue, options?: AssetOptions);
+    toDefinition(): Record<string, AuthorValue>;
+    toString(): string;
+    toJSON(): string;
+}
+export declare class LayerBuilder {
+    private readonly layer;
+    constructor(layer: Record<string, AuthorValue>);
+    animate(property: AnimatableProperty, frames: readonly Keyframe[]): this;
+    motion(frames: KeyframeMap): this;
+    transitionIn(definition: TransitionDefinition): this;
+    transitionOut(definition: TransitionDefinition): this;
+    enter(definition: TransitionDefinition): this;
+    exit(definition: TransitionDefinition): this;
+    toInput(): Record<string, AuthorValue>;
+    toJSON(): Record<string, unknown>;
+    get id(): string;
+}
+export declare class TrackBuilder {
+    private readonly definition;
+    constructor(id: string, clips?: readonly TrackClipDefinition[]);
+    clip(id: string, options: TrackClipOptions): this;
+    toInput(): TrackDefinition;
+    toJSON(): Record<string, unknown>;
+}
+export declare class VideoBuilder {
+    private readonly composition;
+    private readonly metadata?;
+    private readonly propDefinitions;
+    private readonly assetDefinitions;
+    private readonly layers;
+    private readonly trackDefinitions;
+    private readonly audioTracks;
+    private readonly exportDefinitions;
+    constructor(composition: CompositionTiming, options?: {
+        metadata?: Record<string, AuthorValue>;
+    });
+    prop(reference: PropReference): this;
+    props(...references: readonly PropReference[]): this;
+    asset(reference: AssetReference): this;
+    assets(...references: readonly AssetReference[]): this;
+    add(...layers: readonly LayerBuilder[]): this;
+    addTrack(...tracks: readonly (TrackBuilder | TrackDefinition)[]): this;
+    tracks(...tracks: readonly (TrackBuilder | TrackDefinition)[]): this;
+    audio(options: AudioOptions): this;
+    addExport(definition: ExportOptions): this;
+    exports(...definitions: readonly ExportOptions[]): this;
+    toJSON(): KavioDocument;
+    validate(): ValidationResult;
+    private registerAsset;
+    private registerProp;
+    private normalizeProps;
+    private normalizeAssets;
+    private normalize;
+}
+export declare function video(composition: CompositionTiming, options?: {
+    metadata?: Record<string, AuthorValue>;
+}): VideoBuilder;
+export declare function prop(name: string, metadata?: PropMetadata): PropReference;
+export declare function validate(input: VideoBuilder | KavioDocument): ValidationResult;
+export declare function validate(input: unknown): ValidationResult;
+export declare const asset: {
+    readonly video: (id: string, src: AuthorValue, options?: AssetOptions) => AssetReference;
+    readonly image: (id: string, src: AuthorValue, options?: AssetOptions) => AssetReference;
+    readonly audio: (id: string, src: AuthorValue, options?: AssetOptions) => AssetReference;
+    readonly font: (id: string, src: AuthorValue, options: AssetOptions & {
+        family: string;
+    }) => AssetReference;
+};
+export declare function clip(id: string, options: VideoLayerOptions): LayerBuilder;
+export declare function videoLayer(id: string, options: VideoLayerOptions): LayerBuilder;
+export declare function image(id: string, options: ImageLayerOptions): LayerBuilder;
+export declare function text(id: string, options: TextLayerOptions): LayerBuilder;
+export declare function shape(id: string, options: ShapeLayerOptions): LayerBuilder;
+export declare function caption(id: string, options: CaptionLayerOptions): LayerBuilder;
+export declare function trackClip(id: string, options: TrackClipOptions): TrackClipDefinition;
+export declare function track(id: string, clips?: readonly TrackClipDefinition[]): TrackBuilder;
+export declare const layers: {
+    readonly video: typeof videoLayer;
+    readonly clip: typeof clip;
+    readonly image: typeof image;
+    readonly text: typeof text;
+    readonly shape: typeof shape;
+    readonly caption: typeof caption;
+};
+export declare const transition: {
+    readonly fade: (options: TransitionOptions) => TransitionDefinition;
+    readonly slide: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly wipe: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly crossfade: (options: TransitionOptions) => TransitionDefinition;
+    readonly zoom: (options?: TransitionOptions) => TransitionDefinition;
+    readonly push: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly spin: (options?: TransitionOptions) => TransitionDefinition;
+    readonly rotate: (options?: TransitionOptions) => TransitionDefinition;
+    readonly flip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly blurDissolve: (options?: TransitionOptions) => TransitionDefinition;
+    readonly colorDissolve: (options?: TransitionOptions) => TransitionDefinition;
+    readonly dip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly iris: (options?: TransitionOptions) => TransitionDefinition;
+    readonly stretch: (options?: TransitionOptions) => TransitionDefinition;
+    readonly squeeze: (options?: TransitionOptions) => TransitionDefinition;
+    readonly clockWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly barWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly gridWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly tileReveal: (options?: TransitionOptions) => TransitionDefinition;
+    readonly radialBlur: (options?: TransitionOptions) => TransitionDefinition;
+    readonly zoomBlur: (options?: TransitionOptions) => TransitionDefinition;
+    readonly bookFlip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly pageCurlLite: (options?: TransitionOptions) => TransitionDefinition;
+    readonly skewSlide: (options?: TransitionOptions) => TransitionDefinition;
+    readonly expandMask: (options?: TransitionOptions) => TransitionDefinition;
+    readonly letterboxReveal: (options?: TransitionOptions) => TransitionDefinition;
+    readonly filmFlash: (options?: TransitionOptions) => TransitionDefinition;
+    readonly cameraWhip: (options?: TransitionOptions) => TransitionDefinition;
+};
+export declare const transitions: {
+    readonly fade: (options: TransitionOptions) => TransitionDefinition;
+    readonly slide: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly wipe: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly crossfade: (options: TransitionOptions) => TransitionDefinition;
+    readonly zoom: (options?: TransitionOptions) => TransitionDefinition;
+    readonly push: (options: TransitionOptions & {
+        direction: TransitionDirection;
+    }) => TransitionDefinition;
+    readonly spin: (options?: TransitionOptions) => TransitionDefinition;
+    readonly rotate: (options?: TransitionOptions) => TransitionDefinition;
+    readonly flip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly blurDissolve: (options?: TransitionOptions) => TransitionDefinition;
+    readonly colorDissolve: (options?: TransitionOptions) => TransitionDefinition;
+    readonly dip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly iris: (options?: TransitionOptions) => TransitionDefinition;
+    readonly stretch: (options?: TransitionOptions) => TransitionDefinition;
+    readonly squeeze: (options?: TransitionOptions) => TransitionDefinition;
+    readonly clockWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly barWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly gridWipe: (options?: TransitionOptions) => TransitionDefinition;
+    readonly tileReveal: (options?: TransitionOptions) => TransitionDefinition;
+    readonly radialBlur: (options?: TransitionOptions) => TransitionDefinition;
+    readonly zoomBlur: (options?: TransitionOptions) => TransitionDefinition;
+    readonly bookFlip: (options?: TransitionOptions) => TransitionDefinition;
+    readonly pageCurlLite: (options?: TransitionOptions) => TransitionDefinition;
+    readonly skewSlide: (options?: TransitionOptions) => TransitionDefinition;
+    readonly expandMask: (options?: TransitionOptions) => TransitionDefinition;
+    readonly letterboxReveal: (options?: TransitionOptions) => TransitionDefinition;
+    readonly filmFlash: (options?: TransitionOptions) => TransitionDefinition;
+    readonly cameraWhip: (options?: TransitionOptions) => TransitionDefinition;
+};
+export declare const transitionSeries: {
+    readonly fromPrevious: (definition: TransitionDefinition | TransitionSeriesDefinition) => TransitionSeriesDefinition;
+};
+export declare const camera: {
+    readonly kenBurns: (options: CameraKenBurnsOptions) => KeyframeMap;
+    readonly pushIn: (options: CameraZoomOptions) => KeyframeMap;
+    readonly pullBack: (options: CameraZoomOptions) => KeyframeMap;
+    readonly pan: (options: CameraPanOptions) => KeyframeMap;
+    readonly tilt: (options: CameraTiltOptions) => KeyframeMap;
+    readonly parallax: (options: CameraParallaxOptions) => KeyframeMap;
+    readonly orbitLite: (options: CameraOrbitLiteOptions) => KeyframeMap;
+    readonly handheld: (options: CameraHandheldOptions) => KeyframeMap;
+    readonly crashZoom: (options: CameraCrashZoomOptions) => KeyframeMap;
+    readonly dollyZoomLite: (options: CameraDollyZoomLiteOptions) => KeyframeMap;
+};
+export declare const cinematic: {
+    readonly zoomPush: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+    readonly whipPan: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+    readonly filmFlash: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly dreamyBlur: (options?: CinematicPresetOptions) => CinematicLayerPreset;
+    readonly broadcastDip: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly irisOpen: (options?: CinematicIrisPresetOptions) => CinematicLayerPreset;
+    readonly flipCard: (options?: CinematicFlipPresetOptions) => CinematicLayerPreset;
+    readonly glitchCut: (options?: CinematicGlitchCutOptions) => CinematicLayerPreset;
+    readonly lightLeak: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly kenBurns: (options?: CinematicKenBurnsOptions) => CinematicLayerPreset;
+    readonly logoSting: (options?: CinematicLogoStingOptions) => CinematicLayerPreset;
+    readonly productReveal: (options?: CinematicProductRevealOptions) => CinematicLayerPreset;
+    readonly socialHook: (options?: CinematicSocialHookOptions) => CinematicLayerPreset;
+    readonly titleSequence: (options?: CinematicTitleSequenceOptions) => CinematicLayerPreset;
+    readonly endCard: (options?: CinematicEndCardOptions) => CinematicLayerPreset;
+};
+export declare const cinematicPresets: {
+    readonly zoomPush: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+    readonly whipPan: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+    readonly filmFlash: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly dreamyBlur: (options?: CinematicPresetOptions) => CinematicLayerPreset;
+    readonly broadcastDip: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly irisOpen: (options?: CinematicIrisPresetOptions) => CinematicLayerPreset;
+    readonly flipCard: (options?: CinematicFlipPresetOptions) => CinematicLayerPreset;
+    readonly glitchCut: (options?: CinematicGlitchCutOptions) => CinematicLayerPreset;
+    readonly lightLeak: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+    readonly kenBurns: (options?: CinematicKenBurnsOptions) => CinematicLayerPreset;
+    readonly logoSting: (options?: CinematicLogoStingOptions) => CinematicLayerPreset;
+    readonly productReveal: (options?: CinematicProductRevealOptions) => CinematicLayerPreset;
+    readonly socialHook: (options?: CinematicSocialHookOptions) => CinematicLayerPreset;
+    readonly titleSequence: (options?: CinematicTitleSequenceOptions) => CinematicLayerPreset;
+    readonly endCard: (options?: CinematicEndCardOptions) => CinematicLayerPreset;
+};
+export declare const textMotion: {
+    readonly rise: (options?: TextMotionRiseOptions) => TextMotionDefinition;
+    readonly blurIn: (options?: TextMotionBlurInOptions) => TextMotionDefinition;
+    readonly typeOn: (options?: TextMotionSplitOptions) => TextMotionDefinition;
+    readonly cascade: (options?: TextMotionCascadeOptions) => TextMotionDefinition;
+    readonly scramble: (options?: TextMotionScrambleOptions) => TextMotionDefinition;
+    readonly highlightSweep: (options?: TextMotionHighlightSweepOptions) => TextMotionDefinition;
+    readonly trackingIn: (options?: TextMotionTrackingInOptions) => TextMotionDefinition;
+};
+export declare const textMotions: {
+    readonly rise: (options?: TextMotionRiseOptions) => TextMotionDefinition;
+    readonly blurIn: (options?: TextMotionBlurInOptions) => TextMotionDefinition;
+    readonly typeOn: (options?: TextMotionSplitOptions) => TextMotionDefinition;
+    readonly cascade: (options?: TextMotionCascadeOptions) => TextMotionDefinition;
+    readonly scramble: (options?: TextMotionScrambleOptions) => TextMotionDefinition;
+    readonly highlightSweep: (options?: TextMotionHighlightSweepOptions) => TextMotionDefinition;
+    readonly trackingIn: (options?: TextMotionTrackingInOptions) => TextMotionDefinition;
+};
+export declare const effect: {};
+export declare const presetNamespaces: {
+    readonly transition: {
+        readonly fade: (options: TransitionOptions) => TransitionDefinition;
+        readonly slide: (options: TransitionOptions & {
+            direction: TransitionDirection;
+        }) => TransitionDefinition;
+        readonly wipe: (options: TransitionOptions & {
+            direction: TransitionDirection;
+        }) => TransitionDefinition;
+        readonly crossfade: (options: TransitionOptions) => TransitionDefinition;
+        readonly zoom: (options?: TransitionOptions) => TransitionDefinition;
+        readonly push: (options: TransitionOptions & {
+            direction: TransitionDirection;
+        }) => TransitionDefinition;
+        readonly spin: (options?: TransitionOptions) => TransitionDefinition;
+        readonly rotate: (options?: TransitionOptions) => TransitionDefinition;
+        readonly flip: (options?: TransitionOptions) => TransitionDefinition;
+        readonly blurDissolve: (options?: TransitionOptions) => TransitionDefinition;
+        readonly colorDissolve: (options?: TransitionOptions) => TransitionDefinition;
+        readonly dip: (options?: TransitionOptions) => TransitionDefinition;
+        readonly iris: (options?: TransitionOptions) => TransitionDefinition;
+        readonly stretch: (options?: TransitionOptions) => TransitionDefinition;
+        readonly squeeze: (options?: TransitionOptions) => TransitionDefinition;
+        readonly clockWipe: (options?: TransitionOptions) => TransitionDefinition;
+        readonly barWipe: (options?: TransitionOptions) => TransitionDefinition;
+        readonly gridWipe: (options?: TransitionOptions) => TransitionDefinition;
+        readonly tileReveal: (options?: TransitionOptions) => TransitionDefinition;
+        readonly radialBlur: (options?: TransitionOptions) => TransitionDefinition;
+        readonly zoomBlur: (options?: TransitionOptions) => TransitionDefinition;
+        readonly bookFlip: (options?: TransitionOptions) => TransitionDefinition;
+        readonly pageCurlLite: (options?: TransitionOptions) => TransitionDefinition;
+        readonly skewSlide: (options?: TransitionOptions) => TransitionDefinition;
+        readonly expandMask: (options?: TransitionOptions) => TransitionDefinition;
+        readonly letterboxReveal: (options?: TransitionOptions) => TransitionDefinition;
+        readonly filmFlash: (options?: TransitionOptions) => TransitionDefinition;
+        readonly cameraWhip: (options?: TransitionOptions) => TransitionDefinition;
+    };
+    readonly cinematic: {
+        readonly zoomPush: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+        readonly whipPan: (options?: CinematicDirectionalPresetOptions) => CinematicLayerPreset;
+        readonly filmFlash: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+        readonly dreamyBlur: (options?: CinematicPresetOptions) => CinematicLayerPreset;
+        readonly broadcastDip: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+        readonly irisOpen: (options?: CinematicIrisPresetOptions) => CinematicLayerPreset;
+        readonly flipCard: (options?: CinematicFlipPresetOptions) => CinematicLayerPreset;
+        readonly glitchCut: (options?: CinematicGlitchCutOptions) => CinematicLayerPreset;
+        readonly lightLeak: (options?: CinematicColorPresetOptions) => CinematicLayerPreset;
+        readonly kenBurns: (options?: CinematicKenBurnsOptions) => CinematicLayerPreset;
+        readonly logoSting: (options?: CinematicLogoStingOptions) => CinematicLayerPreset;
+        readonly productReveal: (options?: CinematicProductRevealOptions) => CinematicLayerPreset;
+        readonly socialHook: (options?: CinematicSocialHookOptions) => CinematicLayerPreset;
+        readonly titleSequence: (options?: CinematicTitleSequenceOptions) => CinematicLayerPreset;
+        readonly endCard: (options?: CinematicEndCardOptions) => CinematicLayerPreset;
+    };
+    readonly textMotion: {
+        readonly rise: (options?: TextMotionRiseOptions) => TextMotionDefinition;
+        readonly blurIn: (options?: TextMotionBlurInOptions) => TextMotionDefinition;
+        readonly typeOn: (options?: TextMotionSplitOptions) => TextMotionDefinition;
+        readonly cascade: (options?: TextMotionCascadeOptions) => TextMotionDefinition;
+        readonly scramble: (options?: TextMotionScrambleOptions) => TextMotionDefinition;
+        readonly highlightSweep: (options?: TextMotionHighlightSweepOptions) => TextMotionDefinition;
+        readonly trackingIn: (options?: TextMotionTrackingInOptions) => TextMotionDefinition;
+    };
+    readonly camera: {
+        readonly kenBurns: (options: CameraKenBurnsOptions) => KeyframeMap;
+        readonly pushIn: (options: CameraZoomOptions) => KeyframeMap;
+        readonly pullBack: (options: CameraZoomOptions) => KeyframeMap;
+        readonly pan: (options: CameraPanOptions) => KeyframeMap;
+        readonly tilt: (options: CameraTiltOptions) => KeyframeMap;
+        readonly parallax: (options: CameraParallaxOptions) => KeyframeMap;
+        readonly orbitLite: (options: CameraOrbitLiteOptions) => KeyframeMap;
+        readonly handheld: (options: CameraHandheldOptions) => KeyframeMap;
+        readonly crashZoom: (options: CameraCrashZoomOptions) => KeyframeMap;
+        readonly dollyZoomLite: (options: CameraDollyZoomLiteOptions) => KeyframeMap;
+    };
+    readonly effect: {};
+};
+export declare function keyframes(frames: readonly KeyframeInput[]): Keyframe[];
+export declare const easing: {
+    readonly linear: "linear";
+    readonly inQuad: "inQuad";
+    readonly outQuad: "outQuad";
+    readonly inOutQuad: "inOutQuad";
+    readonly inCubic: "inCubic";
+    readonly outCubic: "outCubic";
+    readonly inOutCubic: "inOutCubic";
+    readonly inCirc: "inCirc";
+    readonly outCirc: "outCirc";
+    readonly inOutCirc: "inOutCirc";
+    readonly inExpo: "inExpo";
+    readonly outExpo: "outExpo";
+    readonly inOutExpo: "inOutExpo";
+    readonly anticipate: "anticipate";
+    readonly back: "back";
+    readonly inBack: "inBack";
+    readonly outBack: "outBack";
+    readonly inOutBack: "inOutBack";
+    readonly inElastic: "inElastic";
+    readonly outElastic: "outElastic";
+    readonly inOutElastic: "inOutElastic";
+    readonly inBounce: "inBounce";
+    readonly outBounce: "outBounce";
+    readonly inOutBounce: "inOutBounce";
+    readonly cubicBezier: (x1: number, y1: number, x2: number, y2: number) => EasingName;
+};
+export declare const timing: {
+    readonly tween: (options?: Omit<TweenTimingDefinition, "type">) => TweenTimingDefinition;
+    readonly spring: (options?: Omit<SpringTimingDefinition, "type">) => SpringTimingDefinition;
+    readonly steps: (options: Omit<StepsTimingDefinition, "type">) => StepsTimingDefinition;
+    readonly sequence: (segments: readonly SequenceTimingSegment[]) => SequenceTimingDefinition;
+    readonly stagger: (options: Omit<StaggerTimingDefinition, "type">) => StaggerTimingDefinition;
+};
+export declare const exportPreset: {
+    readonly vertical: (options?: ExportOptions) => ExportOptions;
+    readonly reels: (options?: ExportOptions) => ExportOptions;
+    readonly instagramReels: (options?: ExportOptions) => ExportOptions;
+    readonly tiktok: (options?: ExportOptions) => ExportOptions;
+    readonly youtubeShorts: (options?: ExportOptions) => ExportOptions;
+    readonly facebookReels: (options?: ExportOptions) => ExportOptions;
+    readonly square: (options?: ExportOptions) => ExportOptions;
+    readonly portrait: (options?: ExportOptions) => ExportOptions;
+    readonly landscape: (options?: ExportOptions) => ExportOptions;
+    readonly social: (options?: SocialExportOptions) => ExportOptions[];
+    readonly custom: (options: CustomExportOptions) => ExportOptions;
+};
+export declare const exportPresets: {
+    readonly vertical: (options?: ExportOptions) => ExportOptions;
+    readonly reels: (options?: ExportOptions) => ExportOptions;
+    readonly instagramReels: (options?: ExportOptions) => ExportOptions;
+    readonly tiktok: (options?: ExportOptions) => ExportOptions;
+    readonly youtubeShorts: (options?: ExportOptions) => ExportOptions;
+    readonly facebookReels: (options?: ExportOptions) => ExportOptions;
+    readonly square: (options?: ExportOptions) => ExportOptions;
+    readonly portrait: (options?: ExportOptions) => ExportOptions;
+    readonly landscape: (options?: ExportOptions) => ExportOptions;
+    readonly social: (options?: SocialExportOptions) => ExportOptions[];
+    readonly custom: (options: CustomExportOptions) => ExportOptions;
+};
+export declare const vertical: (options?: ExportOptions) => ExportOptions;
+export declare const reels: (options?: ExportOptions) => ExportOptions;
+export declare const instagramReels: (options?: ExportOptions) => ExportOptions;
+export declare const tiktok: (options?: ExportOptions) => ExportOptions;
+export declare const youtubeShorts: (options?: ExportOptions) => ExportOptions;
+export declare const facebookReels: (options?: ExportOptions) => ExportOptions;
+export declare const square: (options?: ExportOptions) => ExportOptions;
+export declare const portrait: (options?: ExportOptions) => ExportOptions;
+export declare const landscape: (options?: ExportOptions) => ExportOptions;
+export declare const social: (options?: SocialExportOptions) => ExportOptions[];
+export declare const customExport: (options: CustomExportOptions) => ExportOptions;
+export declare const socialMediaPresets: readonly [SocialMediaPresetDefinition, SocialMediaPresetDefinition, SocialMediaPresetDefinition, SocialMediaPresetDefinition, SocialMediaPresetDefinition, SocialMediaPresetDefinition, SocialMediaPresetDefinition];
+export declare const crop: {
+    readonly center: () => AuthorValue;
+    readonly subject: (options: SubjectCropOptions) => AuthorValue;
+};
+//# sourceMappingURL=index.d.ts.map