/**
 * @fileoverview Click-to-play video modal with poster thumbnail.
 * @author Saasflare™
 * Renders a poster image with a play button overlay. On click, opens a
 * dialog with the video playing. Supports YouTube, Vimeo, and direct URLs.
 * @module packages/ui/components/ui/hero-video-dialog
 * @package ui
 *
 * @component
 * @example
 * import { HeroVideoDialog } from '@saasflare/ui';
 * <HeroVideoDialog
 *   videoSrc="https://www.youtube.com/embed/dQw4w9WgXcQ"
 *   thumbnailSrc="/product-demo-poster.jpg"
 *   thumbnailAlt="Product demo video"
 * />
 *
 * @example
 * // With custom aspect ratio
 * <HeroVideoDialog
 *   videoSrc="https://player.vimeo.com/video/123456789"
 *   thumbnailSrc="/poster.jpg"
 *   thumbnailAlt="Demo"
 *   aspectRatio="4/3"
 * />
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the HeroVideoDialog component. */
export interface HeroVideoDialogProps extends Omit<React.ComponentProps<"button">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Video embed URL (YouTube/Vimeo embed or direct video URL). */
    videoSrc: string;
    /** Poster thumbnail image URL. */
    thumbnailSrc: string;
    /** Alt text for the thumbnail image. */
    thumbnailAlt: string;
    /** CSS aspect-ratio for the thumbnail. Default: `"16/9"` */
    aspectRatio?: string;
}
/**
 * Hero video section with click-to-play dialog.
 *
 * - Shows a thumbnail with a centered play button
 * - Opens a modal dialog with the embedded video on click
 * - Animated with spring physics (scale + fade), gated on the `animated` axis
 * - Accessible: focus trap + restoration, body-scroll lock, keyboard close, aria labels
 *
 * @component
 * @package ui
 */
export declare function HeroVideoDialog({ videoSrc, thumbnailSrc, thumbnailAlt, aspectRatio, className, surface, radius, animated, iconWeight, ...props }: HeroVideoDialogProps): import("react/jsx-runtime").JSX.Element;