/**
 * Popover — headless primitive wrapping Radix Popover.
 *
 * Radix's Popover owns focus management, collision detection, portal,
 * ESC-to-close, and click-outside behavior (ARCHITECTURE §6). We wrap
 * thinly:
 *   - Permission gating on <Root> (denied → null + permission:denied
 *     audit; any mode collapses to null for a popover that has no useful
 *     visible-but-inert state)
 *   - Audit events on open / close
 *   - `data-oshon-primitive="popover-*"` styling hooks
 *
 * "use client" mandatory — Radix uses hooks + DOM APIs internally.
 */
import * as RadixPopover from '@radix-ui/react-popover';
import type { ComponentPropsWithoutRef, ReactNode } from 'react';
import { type PermissionContext } from '../context.js';
export interface PopoverRootProps extends Omit<RadixPopover.PopoverProps, 'onOpenChange'> {
    /**
     * Fires whenever the popover's open state changes. The primitive fires
     * `popover:open` / `popover:close` audit events automatically before
     * this callback runs.
     */
    onOpenChange?: (open: boolean) => void;
    /**
     * Per-instance permission override. Merges over the ambient
     * `PermissionContext`. Denied + any mode returns `null` (popovers, like
     * dialogs, have no useful visible-but-inert state) and emits a
     * `permission:denied` audit.
     */
    permissions?: Partial<PermissionContext>;
    /**
     * Resource name for `permissions.can('view', resource, attrs)`.
     * Default `'popover'`. Override for specific semantics, e.g.
     * `resource="record:quick-actions"`.
     */
    resource?: string;
    /** Attribute bag for attribute-based access control. */
    permissionAttrs?: Record<string, unknown>;
    children: ReactNode;
}
/**
 * Popover root. Controls open state, gates on permissions, fires audit
 * events. Must wrap every other `Popover.*` sub-component.
 */
declare function Root({ children, open, defaultOpen, onOpenChange, permissions, resource, permissionAttrs, modal, }: PopoverRootProps): import("react/jsx-runtime").JSX.Element | null;
declare namespace Root {
    var displayName: string;
}
export type PopoverTriggerProps = ComponentPropsWithoutRef<typeof RadixPopover.Trigger>;
export type PopoverAnchorProps = ComponentPropsWithoutRef<typeof RadixPopover.Anchor>;
export type PopoverPortalProps = RadixPopover.PopoverPortalProps;
declare function Portal(props: PopoverPortalProps): import("react/jsx-runtime").JSX.Element;
declare namespace Portal {
    var displayName: string;
}
export type PopoverContentProps = ComponentPropsWithoutRef<typeof RadixPopover.Content>;
export type PopoverCloseProps = ComponentPropsWithoutRef<typeof RadixPopover.Close>;
export type PopoverArrowProps = ComponentPropsWithoutRef<typeof RadixPopover.Arrow>;
/**
 * Compound Popover primitive. Use as:
 *
 *   <Popover.Root>
 *     <Popover.Trigger>Open</Popover.Trigger>
 *     <Popover.Portal>
 *       <Popover.Content>
 *         <p>Popover content</p>
 *         <Popover.Close>Close</Popover.Close>
 *       </Popover.Content>
 *     </Popover.Portal>
 *   </Popover.Root>
 */
export declare const Popover: {
    Root: typeof Root;
    Trigger: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
    Anchor: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverAnchorProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Portal: typeof Portal;
    Content: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Close: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverCloseProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
    Arrow: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverArrowProps & import("react").RefAttributes<SVGSVGElement>, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
};
export type PopoverProps = PopoverRootProps;
export {};
//# sourceMappingURL=popover.d.cts.map