/**
 * AlertDialog - a confirmation modal. Semantically a {@link Dialog} with
 * `role="alertdialog"`, a REQUIRED title + description, and explicit
 * Action / Cancel buttons. Unlike `Dialog` it does NOT dismiss on outside-click
 * or `Escape`: the user must choose an option.
 *
 * It reuses the Dialog primitive's open-state context (`dialog.Root` /
 * `dialog.Trigger` / `dialog.useDialog` resolved from the active adapter) so
 * trigger + open state behave identically, but renders its own alert-specific
 * overlay + panel - the panel carries `role="alertdialog"` and its
 * `aria-labelledby` / `aria-describedby` are wired to the Title / Description
 * ids, and neither the overlay nor a key listener dismisses it.
 *
 * @example
 * ```tsx
 * import {
 *   AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent,
 *   AlertDialogDescription, AlertDialogFooter, AlertDialogTitle, AlertDialogTrigger,
 * } from "veryfront/ui";
 *
 * <AlertDialog>
 *   <AlertDialogTrigger>Delete account</AlertDialogTrigger>
 *   <AlertDialogContent>
 *     <AlertDialogTitle>Delete account?</AlertDialogTitle>
 *     <AlertDialogDescription>This permanently removes your account.</AlertDialogDescription>
 *     <AlertDialogFooter>
 *       <AlertDialogCancel>Cancel</AlertDialogCancel>
 *       <AlertDialogAction variant="destructive" onClick={remove}>Delete</AlertDialogAction>
 *     </AlertDialogFooter>
 *   </AlertDialogContent>
 * </AlertDialog>;
 * ```
 *
 * @module react/components/ui/alert-dialog
 */
import * as React from "react";
import { type ButtonProps } from "./button.js";
/** Props accepted by `<AlertDialog>`. */
export interface AlertDialogProps {
    /** The trigger and content parts to compose. */
    children: React.ReactNode;
    /** Controlled open state (pair with `onOpenChange`). @default undefined */
    open?: boolean;
    /** Initial open state when uncontrolled. @default false */
    defaultOpen?: boolean;
    /** Fires when the open state changes. @default undefined */
    onOpenChange?: (open: boolean) => void;
}
/** AlertDialog root - owns open state (shares the Dialog adapter slot). */
export declare function AlertDialog(props: AlertDialogProps): React.ReactElement;
/** Props accepted by `<AlertDialogTrigger>`. */
export interface AlertDialogTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
    /** Merge trigger behaviour onto the child element instead of a `<button>`. @default false */
    asChild?: boolean;
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLButtonElement>;
}
/** Trigger - opens the alert dialog. `asChild` merges onto the child element. */
export declare function AlertDialogTrigger({ ref, ...props }: AlertDialogTriggerProps): React.ReactElement;
/** Props accepted by `<AlertDialogContent>`. */
export interface AlertDialogContentProps extends React.HTMLAttributes<HTMLDivElement> {
    /** React 19: ref is a regular prop (forwarded to the panel node). */
    ref?: React.Ref<HTMLDivElement>;
}
/**
 * Alert surface - non-dismissing overlay + centered `role="alertdialog"` panel,
 * rendered only while open. Generates the title / description ids, wires them to
 * `aria-labelledby` / `aria-describedby`, traps focus, restores it on close,
 * and portals outside clipping ancestors while retaining the token scope.
 */
export declare function AlertDialogContent({ className, children, id, ref, ...props }: AlertDialogContentProps): React.ReactElement | null;
/** Props accepted by `<AlertDialogTitle>`. */
export interface AlertDialogTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLHeadingElement>;
}
/** Required accessible name - adopts the Content-generated `aria-labelledby` id. */
export declare function AlertDialogTitle({ className, id, ref, ...props }: AlertDialogTitleProps): React.ReactElement;
/** Props accepted by `<AlertDialogDescription>`. */
export interface AlertDialogDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLParagraphElement>;
}
/** Required supporting copy - adopts the Content-generated `aria-describedby` id. */
export declare function AlertDialogDescription({ className, id, ref, ...props }: AlertDialogDescriptionProps): React.ReactElement;
/** Props accepted by `<AlertDialogFooter>`. */
export interface AlertDialogFooterProps extends React.HTMLAttributes<HTMLDivElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLDivElement>;
}
/** Right-aligned action row - Cancel first, then the Action. */
export declare function AlertDialogFooter({ className, ref, ...props }: AlertDialogFooterProps): React.ReactElement;
/** Props accepted by `<AlertDialogAction>`. */
export type AlertDialogActionProps = ButtonProps;
/** Confirming action - runs `onClick`, then closes unless it calls `preventDefault()`. */
export declare function AlertDialogAction({ variant, size, type, onClick, ...props }: AlertDialogActionProps): React.ReactElement;
/** Props accepted by `<AlertDialogCancel>`. */
export type AlertDialogCancelProps = ButtonProps;
/** Dismissing action - runs `onClick`, then closes unless it calls `preventDefault()`. */
export declare function AlertDialogCancel({ variant, size, type, onClick, ...props }: AlertDialogCancelProps): React.ReactElement;
//# sourceMappingURL=alert-dialog.d.ts.map