/**
 * @usevyre/react — Modal / Dialog
 *
 * AI CONTEXT:
 * ┌─────────────────────────────────────────────────────────┐
 * │ Components: Modal + ModalHeader + ModalBody + ModalFooter│
 * │ Import:     import { Modal, ModalHeader, ModalBody,     │
 * │             ModalFooter } from "@usevyre/react"            │
 * │                                                         │
 * │ Modal props:                                            │
 * │   open             = boolean (controlled)               │
 * │   onClose          = () => void                         │
 * │   size             = "sm"|"md"(default)|"lg"|"full"     │
 * │   closeOnBackdrop  = boolean (default: true)            │
 * │   closeOnEsc       = boolean (default: true)            │
 * │   initialFocus     = RefObject<HTMLElement>             │
 * └─────────────────────────────────────────────────────────┘
 *
 * @example
 * // Confirmation dialog
 * <Modal open={isOpen} onClose={() => setIsOpen(false)} size="sm">
 *   <ModalHeader>
 *     <h2>Confirm deletion</h2>
 *   </ModalHeader>
 *   <ModalBody>
 *     <p>This action cannot be undone.</p>
 *   </ModalBody>
 *   <ModalFooter>
 *     <Button variant="ghost" onClick={() => setIsOpen(false)}>Cancel</Button>
 *     <Button variant="danger" onClick={handleDelete}>Delete</Button>
 *   </ModalFooter>
 * </Modal>
 */
import React from "react";
import type { BaseProps } from "../../types";
export type ModalSize = "sm" | "md" | "lg" | "full";
export interface ModalProps extends BaseProps {
    open: boolean;
    onClose: () => void;
    size?: ModalSize;
    /** Close modal when clicking the backdrop. Default: true */
    closeOnBackdrop?: boolean;
    /** Close modal when pressing Escape. Default: true */
    closeOnEsc?: boolean;
    /** Element to focus on open. Defaults to the modal container. */
    initialFocus?: React.RefObject<HTMLElement>;
    children?: React.ReactNode;
    /** Accessible label for the dialog (if no visible title) */
    "aria-label"?: string;
    /** ID of the element that labels the dialog */
    "aria-labelledby"?: string;
}
export declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
export interface ModalSectionProps extends BaseProps {
    children?: React.ReactNode;
}
export declare const ModalHeader: React.ForwardRefExoticComponent<ModalSectionProps & React.RefAttributes<HTMLDivElement>>;
export declare const ModalBody: React.ForwardRefExoticComponent<ModalSectionProps & React.RefAttributes<HTMLDivElement>>;
export declare const ModalFooter: React.ForwardRefExoticComponent<ModalSectionProps & React.RefAttributes<HTMLDivElement>>;