import type { Style } from "../../core/types.js";
import type { TVideoFrame, TVideoFrameEvent, TVideoFrameFormat } from "../video/types.js";
import type { ExtractPublicPropTypes, PropType } from "vue";
/** Motion state supplied to every {@link T3DRenderer.render} call. */
export type T3DViewportMotion = Readonly<{
    yaw: number;
    pitch: number;
    yawVelocity: number;
    pitchVelocity: number;
    pointerX: number;
    pointerY: number;
    pointerSpeed: number;
    hovering: boolean;
    zoom: number;
    zoomVelocity: number;
    hoveredObjectId: number | null;
    selectedObjectId: number | null;
}>;
/** Object metadata returned by an optional {@link T3DRenderer.hitTest}. */
export type T3DHitResult = Readonly<{
    objectId: number;
    label?: string;
    href?: string;
}>;
/** Synchronous pointer context supplied to an optional {@link T3DRenderer.hitTest}. */
export type T3DHitTestContext = Readonly<{
    pointerX: number;
    pointerY: number;
    pixelWidth: number;
    pixelHeight: number;
    cellWidth: number;
    cellHeight: number;
    motion: T3DViewportMotion;
}>;
/** Pull-render context for a single terminal 3D frame. */
export type T3DRenderContext = Readonly<{
    timeMs: number;
    deltaMs: number;
    frame: number;
    pixelWidth: number;
    pixelHeight: number;
    format: TVideoFrameFormat;
    signal: AbortSignal;
    motion: T3DViewportMotion;
}>;
/** Renderer contract used by {@link T3DViewport}. */
export type T3DRenderer = Readonly<{
    render: (context: T3DRenderContext) => TVideoFrame | Promise<TVideoFrame>;
    /** Optional synchronous object picking for hover and click selection. */
    hitTest?: (context: T3DHitTestContext) => T3DHitResult | null;
    dispose?: () => void;
}>;
/** Public methods exposed by {@link T3DViewport}. */
export type T3DViewportHandle = Readonly<{
    resetMotion: () => void;
}>;
export declare const t3DViewportProps: {
    /** Horizontal position in terminal cells. */
    readonly x: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Vertical position in terminal cells. */
    readonly y: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Width in terminal cells. */
    readonly w: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Height in terminal cells. */
    readonly h: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Paint and pointer hit-test stacking order. */
    readonly zIndex: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Pull renderer captured at mount; remount the component to replace it. */
    readonly renderer: {
        readonly type: PropType<T3DRenderer>;
        readonly required: true;
    };
    /** Stops frame pulling while true. */
    readonly paused: {
        readonly type: BooleanConstructor;
        readonly default: false;
    };
    /** Maximum requested frames per second. */
    readonly maxFps: {
        readonly type: NumberConstructor;
        readonly default: 24;
    };
    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelWidth: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelHeight: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Text displayed before a frame is available or after rendering fails. */
    readonly fallback: {
        readonly type: StringConstructor;
        readonly default: "[3D viewport]";
    };
    /** Terminal style applied to fallback and ASCII output. */
    readonly style: {
        readonly type: PropType<Style>;
        readonly default: undefined;
    };
    /** Clears cells underneath each video frame. */
    readonly clear: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
    readonly interactive: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Initial yaw angle in radians, also restored by resetMotion(). */
    readonly initialYaw: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Initial pitch angle in radians, also restored by resetMotion(). */
    readonly initialPitch: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Enables continuous yaw rotation when not dragging. */
    readonly autoRotate: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Automatic yaw rotation speed in radians per second. */
    readonly autoRotateSpeed: {
        readonly type: NumberConstructor;
        readonly default: 0.35;
    };
    /** Drag sensitivity in radians per terminal cell. */
    readonly pointerSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.055;
    };
    /** Initial camera zoom, also restored by resetMotion(). */
    readonly initialZoom: {
        readonly type: NumberConstructor;
        readonly default: 1;
    };
    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
    readonly minZoom: {
        readonly type: NumberConstructor;
        readonly default: 0.65;
    };
    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
    readonly maxZoom: {
        readonly type: NumberConstructor;
        readonly default: 1.65;
    };
    /** Zoom impulse per normalized wheel or trackpad unit. */
    readonly zoomSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.1;
    };
};
export type T3DViewportProps = ExtractPublicPropTypes<typeof t3DViewportProps>;
/**
 * Browser-safe interactive 3D viewport. Frames are pulled from a renderer and
 * delegated directly to TVideo, which owns frame coalescing and terminal output.
 *
 * @event frame Emitted after TVideo commits a rendered frame.
 * @event error Emitted when the renderer or TVideo frame handling fails.
 */
export declare const T3DViewport: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
    /** Horizontal position in terminal cells. */
    readonly x: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Vertical position in terminal cells. */
    readonly y: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Width in terminal cells. */
    readonly w: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Height in terminal cells. */
    readonly h: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Paint and pointer hit-test stacking order. */
    readonly zIndex: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Pull renderer captured at mount; remount the component to replace it. */
    readonly renderer: {
        readonly type: PropType<T3DRenderer>;
        readonly required: true;
    };
    /** Stops frame pulling while true. */
    readonly paused: {
        readonly type: BooleanConstructor;
        readonly default: false;
    };
    /** Maximum requested frames per second. */
    readonly maxFps: {
        readonly type: NumberConstructor;
        readonly default: 24;
    };
    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelWidth: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelHeight: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Text displayed before a frame is available or after rendering fails. */
    readonly fallback: {
        readonly type: StringConstructor;
        readonly default: "[3D viewport]";
    };
    /** Terminal style applied to fallback and ASCII output. */
    readonly style: {
        readonly type: PropType<Style>;
        readonly default: undefined;
    };
    /** Clears cells underneath each video frame. */
    readonly clear: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
    readonly interactive: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Initial yaw angle in radians, also restored by resetMotion(). */
    readonly initialYaw: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Initial pitch angle in radians, also restored by resetMotion(). */
    readonly initialPitch: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Enables continuous yaw rotation when not dragging. */
    readonly autoRotate: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Automatic yaw rotation speed in radians per second. */
    readonly autoRotateSpeed: {
        readonly type: NumberConstructor;
        readonly default: 0.35;
    };
    /** Drag sensitivity in radians per terminal cell. */
    readonly pointerSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.055;
    };
    /** Initial camera zoom, also restored by resetMotion(). */
    readonly initialZoom: {
        readonly type: NumberConstructor;
        readonly default: 1;
    };
    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
    readonly minZoom: {
        readonly type: NumberConstructor;
        readonly default: 0.65;
    };
    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
    readonly maxZoom: {
        readonly type: NumberConstructor;
        readonly default: 1.65;
    };
    /** Zoom impulse per normalized wheel or trackpad unit. */
    readonly zoomSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.1;
    };
}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
    [key: string]: any;
}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
    /** A frame was committed by TVideo. */
    frame: (_event: TVideoFrameEvent) => true;
    /** Rendering or frame processing failed. */
    error: (_error: unknown) => true;
    /** Hovered renderer object changed, or cleared to null. */
    objecthover: (_hit: T3DHitResult | null) => true;
    /** Click-locked renderer object changed, or cleared to null. */
    objectselect: (_hit: T3DHitResult | null) => true;
}, string, (import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps), Readonly<import("vue").ExtractPropTypes<{
    /** Horizontal position in terminal cells. */
    readonly x: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Vertical position in terminal cells. */
    readonly y: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Width in terminal cells. */
    readonly w: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Height in terminal cells. */
    readonly h: {
        readonly type: NumberConstructor;
        readonly required: true;
    };
    /** Paint and pointer hit-test stacking order. */
    readonly zIndex: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Pull renderer captured at mount; remount the component to replace it. */
    readonly renderer: {
        readonly type: PropType<T3DRenderer>;
        readonly required: true;
    };
    /** Stops frame pulling while true. */
    readonly paused: {
        readonly type: BooleanConstructor;
        readonly default: false;
    };
    /** Maximum requested frames per second. */
    readonly maxFps: {
        readonly type: NumberConstructor;
        readonly default: 24;
    };
    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelWidth: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
    readonly pixelHeight: {
        readonly type: NumberConstructor;
        readonly default: undefined;
    };
    /** Text displayed before a frame is available or after rendering fails. */
    readonly fallback: {
        readonly type: StringConstructor;
        readonly default: "[3D viewport]";
    };
    /** Terminal style applied to fallback and ASCII output. */
    readonly style: {
        readonly type: PropType<Style>;
        readonly default: undefined;
    };
    /** Clears cells underneath each video frame. */
    readonly clear: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
    readonly interactive: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Initial yaw angle in radians, also restored by resetMotion(). */
    readonly initialYaw: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Initial pitch angle in radians, also restored by resetMotion(). */
    readonly initialPitch: {
        readonly type: NumberConstructor;
        readonly default: 0;
    };
    /** Enables continuous yaw rotation when not dragging. */
    readonly autoRotate: {
        readonly type: BooleanConstructor;
        readonly default: true;
    };
    /** Automatic yaw rotation speed in radians per second. */
    readonly autoRotateSpeed: {
        readonly type: NumberConstructor;
        readonly default: 0.35;
    };
    /** Drag sensitivity in radians per terminal cell. */
    readonly pointerSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.055;
    };
    /** Initial camera zoom, also restored by resetMotion(). */
    readonly initialZoom: {
        readonly type: NumberConstructor;
        readonly default: 1;
    };
    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
    readonly minZoom: {
        readonly type: NumberConstructor;
        readonly default: 0.65;
    };
    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
    readonly maxZoom: {
        readonly type: NumberConstructor;
        readonly default: 1.65;
    };
    /** Zoom impulse per normalized wheel or trackpad unit. */
    readonly zoomSensitivity: {
        readonly type: NumberConstructor;
        readonly default: 0.1;
    };
}>> & Readonly<{
    onError?: ((_error: unknown) => any) | undefined;
    onFrame?: ((_event: Readonly<{
        timestampMs: number;
        pixelWidth: number;
        pixelHeight: number;
        droppedFrames: number;
        durationMs?: number;
        playbackRate?: import("../video/types.js").TVideoPlaybackRate;
    }>) => any) | undefined;
    onObjecthover?: ((_hit: Readonly<{
        objectId: number;
        label?: string;
        href?: string;
    }> | null) => any) | undefined;
    onObjectselect?: ((_hit: Readonly<{
        objectId: number;
        label?: string;
        href?: string;
    }> | null) => any) | undefined;
}>, {
    readonly style: Readonly<{
        fg?: string;
        bg?: string;
        bold?: boolean;
        dim?: boolean;
        italic?: boolean;
        underline?: boolean;
        inverse?: boolean;
        href?: string;
    }>;
    readonly zIndex: number;
    readonly clear: boolean;
    readonly fallback: string;
    readonly maxFps: number;
    readonly pixelWidth: number;
    readonly pixelHeight: number;
    readonly paused: boolean;
    readonly interactive: boolean;
    readonly initialYaw: number;
    readonly initialPitch: number;
    readonly autoRotate: boolean;
    readonly autoRotateSpeed: number;
    readonly pointerSensitivity: number;
    readonly initialZoom: number;
    readonly minZoom: number;
    readonly maxZoom: number;
    readonly zoomSensitivity: number;
}, {}>;