import "./popover.css";
import type * as React from "react";
import { Popover as Base } from "@base-ui/react/popover";
import { useRender } from "@base-ui/react/use-render";
import { type StyleProps } from "./style_props";
export type PopoverSide = "top" | "right" | "bottom" | "left";
export type PopoverAlign = "start" | "center" | "end";
/** A ref to the element a popover MEASURES. `unknown` because a `RefObject` is
 *  invariant in its element type, so the ref carries no claim and
 *  {@link anchorElement} makes the check instead. */
export type PopoverTriggerRef = React.RefObject<unknown>;
export interface PopoverProps {
    open?: boolean;
    onOpenChange?: (open: boolean) => void;
    defaultOpen?: boolean;
    children: React.ReactNode;
    side?: PopoverSide;
    align?: PopoverAlign;
    offset?: number;
    inheritTriggerWidth?: boolean;
    /** Anchor the panel to an element outside the popover — a grid cell being
     *  edited, a row whose ⋯ has already unmounted. */
    triggerRef?: PopoverTriggerRef;
}
export declare function Popover(props: PopoverProps): React.JSX.Element;
export interface PopoverTriggerProps {
    /** The control that opens the panel, rendered AS the trigger, so the layout
     *  gains no box and it must forward its `ref` and the props it is handed. An
     *  element that is only the ANCHOR takes `Popover`'s `triggerRef` instead. */
    children: React.ReactElement;
    /** Whether `children` bottoms out in a real `<button>`. Default true, which is
     *  what a kit control is. Yours to answer because the child is CLONED; pass
     *  `false` and Base UI supplies the role and keyboard the element lacks. */
    nativeButton?: boolean;
}
/**
 * The control that opens the panel: Base UI's trigger, rendered AS the child, so
 * Base UI holds the trigger element itself — the anchor it positions against and
 * the focus it returns to.
 *
 * **The press arrives as `onPress`, which is the kit's press contract.** Passing
 * both would toggle twice on the controls that take both.
 */
export declare function PopoverTrigger({ children, nativeButton }: PopoverTriggerProps): React.JSX.Element;
export interface PopoverHeaderProps extends StyleProps {
    children: React.ReactNode;
    ref?: React.Ref<HTMLElement>;
    render?: useRender.RenderProp;
}
/** The panel's fixed top band, OUTSIDE the scroller. It renders THROUGH Base
 *  UI's `Popover.Title`, which writes `aria-labelledby` on the popup — a
 *  `role="dialog"` is name-required. */
export declare function PopoverHeader({ children, ref, render, ...props }: PopoverHeaderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
export interface PopoverFooterProps extends StyleProps {
    children: React.ReactNode;
    showDivider?: boolean;
    /** Action Layout rules: the closure/commit action sits RIGHT (`end`,
     * the default); utility-left + commit-right → `space-between`;
     * informational/custom-width footers → `start`. */
    align?: "start" | "end" | "space-between";
    ref?: React.Ref<HTMLElement>;
    render?: useRender.RenderProp;
}
export declare function PopoverFooter({ children, showDivider, align, ref, render, ...props }: PopoverFooterProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
export interface PopoverContentProps extends StyleProps {
    testID?: string;
    children: React.ReactNode;
    /** Use when children manage their own scroll. */
    disableBodyScroll?: boolean;
    /** A fixed panel width, in px, covering ALL THREE BANDS — never the body
     *  alone: the panel is `max-content`, so a width on the scroller lets a long
     *  title stretch the panel while the body stays put. */
    width?: number;
    /** How tall the SCROLLING band may grow, in px. The header keeps its own
     *  height, so a wrapped two-line name never scrolls out of view. */
    maxHeight?: number;
    /** Accessible name for the bottom-sheet close button. Defaults to the locale's `overlay.close` ("Close" / "Đóng"). */
    closeLabel?: string;
    /** When true (default), the popover moves focus into its content on open. Set
     *  false for an anchored panel whose trigger must keep focus — a combobox
     *  driving the list via `aria-activedescendant`. Focus RETURN is Base UI's
     *  either way. */
    manageFocus?: boolean;
    ref?: React.Ref<HTMLDivElement>;
    render?: Base.Popup.Props["render"];
}
export declare function PopoverContent(props: PopoverContentProps): React.JSX.Element;