/**
 * Popover - BASIC fork of @radix-ui/react-popover with the same API shape
 * (Root / Trigger / Content + Title / Body / Footer / Actions section parts).
 * Classes are ported 1:1 from Studio's `Popover` (tokens remapped to
 * veryfront's `[var(--token)]` vocabulary). Anchored below the trigger;
 * dismisses on outside-click and `Escape`. A11y work tracked in
 * anchored-surface.tsx.
 *
 * @example
 * ```tsx
 * import { Button, Popover, PopoverContent, PopoverTitle, PopoverTrigger } from "veryfront/ui";
 *
 * <Popover>
 *   <PopoverTrigger asChild><Button>Filters</Button></PopoverTrigger>
 *   <PopoverContent><PopoverTitle>Filters</PopoverTitle></PopoverContent>
 * </Popover>;
 * ```
 *
 * @module react/components/ui/popover
 */
import * as React from "react";
/** Props accepted by `<Popover>`. */
export interface PopoverProps {
    /** The trigger and content parts to compose. */
    children: React.ReactNode;
    /** Controlled open state (pair with `onOpenChange`). */
    open?: boolean;
    /** Initial open state when uncontrolled. */
    defaultOpen?: boolean;
    /** Fires when the open state changes. */
    onOpenChange?: (open: boolean) => void;
}
/** Popover root - owns open state and the positioning anchor. */
export declare function Popover(props: PopoverProps): React.ReactElement;
/** Props accepted by `<PopoverTrigger>`. */
export interface PopoverTriggerProps 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>;
}
/**
 * Literal slotted trigger contract with an element-specific `ref` - for
 * `asChild` triggers whose child is not a `<button>` (e.g. an `<a>`), so the
 * consumer's ref keeps its precise element type.
 */
export type PopoverSlottedTriggerProps<T extends HTMLElement = HTMLElement> = Omit<PopoverTriggerProps, "ref"> & {
    ref?: React.Ref<T>;
};
/**
 * Trigger - toggles the popover; the positioning anchor. `asChild` merges onto
 * the child element, which must forward `ref` to its DOM node. The generic
 * overload lets an `asChild` trigger carry an element-specific ref (e.g. an
 * `<a>`); `aria-haspopup` is supplied by the adapter's trigger.
 */
export declare function PopoverTrigger<T extends HTMLElement = HTMLElement>(props: PopoverSlottedTriggerProps<T>): React.ReactElement;
export declare function PopoverTrigger(props: PopoverTriggerProps): React.ReactElement;
/** Props accepted by `<PopoverContent>`. */
export interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {
    /** Horizontal alignment relative to the trigger. */
    align?: "start" | "end";
    /** Consumer ref for the surface node (forwarded through the adapter). */
    ref?: React.Ref<HTMLDivElement>;
}
/** Popover surface - rendered below the trigger while open. */
export declare function PopoverContent({ children, className, align, ...props }: PopoverContentProps): React.ReactElement | null;
/** Primary heading slot at the top of a popover (Studio: Heading level 4). */
export declare function PopoverTitle({ className, children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): React.ReactElement;
/** Small section label inside a popover (Studio: Heading level 5). */
export declare function PopoverHeader({ className, children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): React.ReactElement;
/** Body content region (Studio: `px-5 last:pb-5 flex flex-col gap-4`). */
export declare function PopoverBody({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.ReactElement;
/** Footer region; pass `bordered` for a top divider (Studio). */
export declare function PopoverFooter({ className, bordered, ...props }: React.HTMLAttributes<HTMLDivElement> & {
    bordered?: boolean;
}): React.ReactElement;
/** Right-aligned button row, for use inside a footer. */
export declare function PopoverActions({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.ReactElement;
//# sourceMappingURL=popover.d.ts.map