/**
 * Dialog — headless primitive wrapping Radix Dialog.
 *
 * Radix's Dialog is best-in-class for focus trap, portal, scroll lock,
 * and `aria-modal` semantics (ARCHITECTURE §6). We wrap thinly:
 *   - Permission gating on <Root> (canView=false → primitive returns null)
 *   - Audit events on open / close
 *   - `data-oshon-primitive="dialog-*"` styling hooks for Phase 4
 *   - i18n-ready `messages` prop on <Close> (for the "Close" aria-label)
 *
 * "use client" is mandatory here — Radix primitives use hooks + DOM APIs
 * internally, so our wrapper inherits the client boundary. See
 * `docs/adr/primitives/002-dialog-radix-wrap.md`.
 */
import * as RadixDialog from '@radix-ui/react-dialog';
import type { ComponentPropsWithoutRef, ReactNode } from 'react';
import { type PermissionContext } from '../context.js';
import { type MessageBag } from '../i18n.js';
export interface DialogRootProps extends Omit<RadixDialog.DialogProps, 'onOpenChange'> {
    /**
     * Called whenever the dialog's open state changes. The primitive fires
     * `dialog:open` / `dialog:close` audit events automatically before
     * this callback runs — consumers receive the same notification either
     * way.
     */
    onOpenChange?: (open: boolean) => void;
    /**
     * Per-instance permission override. Merges over the ambient
     * `PermissionContext` (ARCHITECTURE §10). The primitive queries
     * `can('view', resource, attrs)` on mount; denied + `mode='hidden'`
     * returns `null`. Denied + `'disabled'` or `'readOnly'` still returns
     * `null` for a dialog (there is no useful visible-but-non-interactive
     * state for a modal) and emits a `permission:denied` audit.
     */
    permissions?: Partial<PermissionContext>;
    /**
     * Resource name passed to `permissions.can('view', resource, attrs)`.
     * Default `'dialog'`. Override for specific semantics like
     * `resource="record:delete-confirmation"`.
     */
    resource?: string;
    /** Attribute bag for attribute-based access control. */
    permissionAttrs?: Record<string, unknown>;
    children: ReactNode;
}
/**
 * Dialog root. Controls open state, gates on permissions, and fires
 * audit events. Must wrap every other `Dialog.*` sub-component.
 */
declare function Root({ children, open, defaultOpen, onOpenChange, permissions, resource, permissionAttrs, modal, }: DialogRootProps): import("react/jsx-runtime").JSX.Element | null;
declare namespace Root {
    var displayName: string;
}
export type DialogTriggerProps = ComponentPropsWithoutRef<typeof RadixDialog.Trigger>;
export type DialogPortalProps = RadixDialog.DialogPortalProps;
/**
 * Portal. Radix handles the portal container itself; we pass through.
 */
declare function Portal(props: DialogPortalProps): import("react/jsx-runtime").JSX.Element;
declare namespace Portal {
    var displayName: string;
}
export type DialogOverlayProps = ComponentPropsWithoutRef<typeof RadixDialog.Overlay>;
export type DialogContentProps = ComponentPropsWithoutRef<typeof RadixDialog.Content>;
export type DialogTitleProps = ComponentPropsWithoutRef<typeof RadixDialog.Title>;
export type DialogDescriptionProps = ComponentPropsWithoutRef<typeof RadixDialog.Description>;
export interface DialogCloseProps extends ComponentPropsWithoutRef<typeof RadixDialog.Close> {
    /**
     * i18n message bag. Reads `close` key for the default aria-label when
     * the consumer renders an icon-only close button.
     */
    messages?: MessageBag;
}
/**
 * Compound Dialog primitive. Use as:
 *
 *   <Dialog.Root>
 *     <Dialog.Trigger>Open</Dialog.Trigger>
 *     <Dialog.Portal>
 *       <Dialog.Overlay />
 *       <Dialog.Content>
 *         <Dialog.Title>Confirm</Dialog.Title>
 *         <Dialog.Description>Are you sure?</Dialog.Description>
 *         <Dialog.Close>Cancel</Dialog.Close>
 *       </Dialog.Content>
 *     </Dialog.Portal>
 *   </Dialog.Root>
 */
export declare const Dialog: {
    Root: typeof Root;
    Trigger: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
    Portal: typeof Portal;
    Overlay: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogOverlayProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Content: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Title: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>, "ref"> & import("react").RefAttributes<HTMLHeadingElement>>;
    Description: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogDescriptionProps & import("react").RefAttributes<HTMLParagraphElement>, "ref"> & import("react").RefAttributes<HTMLParagraphElement>>;
    Close: import("react").ForwardRefExoticComponent<DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
};
export type DialogProps = DialogRootProps;
export {};
//# sourceMappingURL=dialog.d.ts.map