import { Popover as PopoverPrimitive } from '@base-ui/react/popover';
import * as React from "react";
type PopoverProps = PopoverPrimitive.Root.Props;
/**
 * Popover root component. Groups all parts of the popover and manages open state.
 * Use with `open`/`onOpenChange` for controlled state, or `defaultOpen` for uncontrolled.
 */
declare function Popover({ ...props }: PopoverProps): import("react/jsx-runtime").JSX.Element;
type PopoverTriggerProps = PopoverPrimitive.Trigger.Props;
/**
 * Button that opens the popover. Use `render` prop to customize the trigger element.
 */
declare function PopoverTrigger({ ...props }: PopoverTriggerProps): import("react/jsx-runtime").JSX.Element;
type PopoverContentProps = PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">;
/**
 * Popover content with automatic portal and positioning.
 * Animates in/out with fade and zoom effects. Default width is w-72 (18rem).
 *
 * @param align - Horizontal alignment relative to trigger. @default "center"
 * @param alignOffset - Offset in pixels along alignment axis. @default 0
 * @param side - Which side of trigger to display on. @default "bottom"
 * @param sideOffset - Distance in pixels from trigger. @default 4
 */
declare function PopoverContent({ className, align, alignOffset, side, sideOffset, ...props }: PopoverContentProps): import("react/jsx-runtime").JSX.Element;
type PopoverHeaderProps = React.ComponentProps<"div">;
/**
 * Optional header wrapper for PopoverTitle and PopoverDescription.
 * Provides consistent spacing between title and description.
 */
declare function PopoverHeader({ className, ...props }: PopoverHeaderProps): import("react/jsx-runtime").JSX.Element;
type PopoverTitleProps = PopoverPrimitive.Title.Props;
/**
 * Heading that labels the popover. Renders an h2 element with proper ARIA attributes.
 */
declare function PopoverTitle({ className, ...props }: PopoverTitleProps): import("react/jsx-runtime").JSX.Element;
type PopoverDescriptionProps = PopoverPrimitive.Description.Props;
/**
 * Optional description text for the popover. Styled with muted foreground color.
 */
declare function PopoverDescription({ className, ...props }: PopoverDescriptionProps): import("react/jsx-runtime").JSX.Element;
export { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, type PopoverProps, type PopoverContentProps, type PopoverDescriptionProps, type PopoverHeaderProps, type PopoverTitleProps, type PopoverTriggerProps, };
//# sourceMappingURL=popover.d.ts.map