import type { AlertNode } from '../../core/index.js';
import type { AlertProps } from './type.js';
/**
 * Creates and manages an Alert modal.
 *
 * @typeParam BackgroundValue - Type of background data passed to BackgroundComponent
 * @param args - Alert modal configuration options
 * @returns Object containing modalNode and promiseHandler
 *
 * @remarks
 * - modalNode: live getter for the modal node; undefined while the modal is
 *   queued before the ModalProvider mounts, then set once the queue flushes
 * - promiseHandler: Promise that resolves when the modal is closed
 *
 * @example
 * ```tsx
 * const { modalNode, promiseHandler } = alertHandler({
 *   title: 'Success',
 *   content: 'Operation completed successfully!',
 * });
 *
 * await promiseHandler; // Wait until modal is closed
 * ```
 */
export declare const alertHandler: <BackgroundValue = any>(args: AlertProps<BackgroundValue>) => {
    readonly modalNode: AlertNode<BackgroundValue> | undefined;
    promiseHandler: Promise<void>;
    cancel: import("../../@aileron/declare").Fn<[], void>;
};