/**
 * <VideoHoverPreviewSurface> — THE shared hover-preview media zone.
 *
 * Extracted verbatim from <VideoBiteCard>'s media stack so the bite strip and
 * the floating walkthrough card share ONE implementation of: poster layer
 * (cover-fallback chain) → first-frame facade fallback → center play badge →
 * controlled muted/sound hover playback, plus the two-way near-viewport player
 * mount gate. The <Video> Mux SSoT is the only player primitive used.
 *
 * Ownership split (do not regress):
 *   - This surface renders `absolute inset-0` content only. The HOST keeps the
 *     sized wrapper (aspect-ratio / height / max-width) so strip geometry can't
 *     regress, and keeps its own card-root concerns (data-strip-card-key,
 *     engine rootRef registration, hover/touch handlers, the bottom overlay).
 *   - Hover activation is CONTROLLED via `active` (the host owns hover state).
 *   - Player mount is controlled via `playerMounted` (the strip's shared gate)
 *     OR self-managed here via a two-way near-viewport observer (standalone
 *     editor cards). Exactly one path is ever active.
 */
import React from 'react';
import { type VideoPlayerHandle, type VideoMutedFallbackState } from './video';
export interface VideoHoverPreviewSurfaceProps {
    /** Source URL (Mux HLS / Supabase mp4). Rendition-capped internally. */
    url: string;
    /** Poster / thumbnail; resolved through the shared cover-fallback chain. */
    posterUrl?: string | null;
    /** CONTROLLED hover activation — the ONLY playback driver (maps to
     *  <Video playWhenHovered={active}>). The host owns hover state. */
    active: boolean;
    /** Controlled player mount (strip budget gate). Omit → surface runs its own
     *  two-way near-viewport observer. */
    playerMounted?: boolean;
    /** Marquee clone: applies `inert` to the media subtree (axe aria-hidden-focus). */
    isClone?: boolean;
    /** Center play badge when inactive. Default 'play'. */
    badge?: 'play' | 'none';
    /** Object-fit for the hover player. */
    fit?: 'contain' | 'cover';
    /** next/image sizes for the poster. Default '234px' (strip cell). */
    posterSizes?: string;
    /** Preview-player preload override. When 'none' AND the poster resolves null,
     *  the network-fetching first-frame facade is SKIPPED (flat surface + badge)
     *  so a fixed always-near widget card fetches nothing until first hover. */
    preload?: 'none' | 'metadata' | 'auto';
    /** Suppress the hover player's internal unmute glyph (host renders its own). */
    hideMutedBadge?: boolean;
    /** Muted-fallback state reporter, forwarded to the hover player. */
    onMutedFallbackChange?: (state: VideoMutedFallbackState) => void;
    /** Imperative handle for the hover player (host-driven unmute/pause). */
    previewHandleRef?: React.Ref<VideoPlayerHandle>;
    /** Standing mute intent from the host, applied when hover playback starts.
     *  Without it an explicit mute was audibly undone by the next hover. */
    mutedIntent?: boolean;
    /** CONTINUATION mode (mini-player resume): mount the player immediately and
     *  play from `startTime`, independent of `active`/hover. Exists so hosts do
     *  NOT hand-roll a second player component — one surface, one behaviour. */
    continuation?: boolean;
    startTime?: number;
    /** Play on mount. False resumes PAUSED at `startTime` (theater closed while
     *  paused) — kept separate from `continuation` so a paused resume still
     *  mounts and seeks instead of falling back to a poster. */
    autoPlay?: boolean;
    startMuted?: boolean;
    onEnded?: () => void;
    className?: string;
}
export declare function VideoHoverPreviewSurface({ url, posterUrl, active, playerMounted, isClone, badge, fit, posterSizes, preload, hideMutedBadge, onMutedFallbackChange, previewHandleRef, mutedIntent, continuation, startTime, autoPlay, startMuted, onEnded, className, }: VideoHoverPreviewSurfaceProps): React.ReactElement;
//# sourceMappingURL=video-hover-preview.d.ts.map