import * as React from "react";
import type { FlushProp } from "../../props/vocabulary/index.js";
type Side = "top" | "right" | "bottom" | "left";
type Align = "start" | "center" | "end";
interface PopoverProps {
    /** Trạng thái mở, có kiểm soát. */
    open?: boolean;
    /** Trạng thái mở ban đầu khi không kiểm soát. */
    defaultOpen?: boolean;
    /** Gọi khi trạng thái mở/đóng đổi. */
    onOpenChange?: (open: boolean) => void;
    /** Khoá tương tác ngoài panel và giam tiêu điểm, đúng như `modal` của Radix. */
    modal?: boolean;
    /**
     * What opens the panel. `"click"` (default): the trigger toggles a dialog panel. `"hover"`: a
     * HOVER CARD — rich, non-modal preview content that opens when the pointer rests on the trigger
     * for `openDelay` and closes `closeDelay` after it leaves (moving onto the card cancels the
     * close); keyboard focus opens it and blur closes it immediately; touch never opens it. The
     * panel is then not a dialog and takes no focus. This is what `HoverCard` was (v32 #1223).
     */
    openOn?: "click" | "hover";
    /** `openOn="hover"` only: pointer rest before opening, in ms. Default 200. */
    openDelay?: number;
    /** `openOn="hover"` only: delay after the pointer leaves before closing, in ms. Default 100. */
    closeDelay?: number;
}
export declare function Popover({ open, defaultOpen, onOpenChange, modal, openOn, openDelay, closeDelay, children, }: React.PropsWithChildren<PopoverProps>): React.JSX.Element;
interface PopoverTriggerProps extends React.ComponentPropsWithRef<"button"> {
    /** Mượn thẻ của con thay vì dựng `<button>` riêng. */
    asChild?: boolean;
}
export declare function PopoverTrigger(props: PopoverTriggerProps): React.JSX.Element;
interface PopoverAnchorProps extends React.ComponentPropsWithRef<"span"> {
    /** Mượn thẻ của con thay vì dựng `<span>` riêng. */
    asChild?: boolean;
}
export declare function PopoverAnchor({ asChild, ref, ...props }: PopoverAnchorProps): React.JSX.Element;
/**
 * The panel's CONTENT owns its inset — a Command list, a menu or a table that must run edge to
 * edge and draw its own separators across the full width. The popover drops its own padding by
 * zeroing `--popover-space-inset` ON THE PANEL, so the inset stays one token (a service that
 * retunes `--popover-space-inset` still owns every padded popover) and no consumer has to reach
 * for a zero-padding utility, which no service theme can reach.
 */
type PopoverContentFlush = {
    flush?: FlushProp;
};
/**
 * How the panel is MEASURED across the inline axis.
 *
 * `"panel"` (default) is the popover's own measure, `--popover-width` (18rem) — right for prose and
 * for a list the panel itself sizes. `"auto"` lets the CONTENT decide, which is the only correct
 * answer for something that already has a width of its own: a two-month `Calendar` is far wider
 * than 18rem and was being clipped by it. `"trigger"` matches the anchor, the shape every
 * select-like control in this library wants.
 *
 * The axis exists because `flush` had no counterpart. The catalog's own rule says a panel must
 * never zero its padding with a `p-0` utility, "that is a per-call-site constant no service theme
 * can retune" — and until now the only way to get a content-width panel was exactly such a
 * constant, `className="w-auto"`. The library's internal `.ui-control-panel-flush` has always set
 * both knobs; this is the public half of it.
 */
type PopoverContentWidth = "panel" | "auto" | "trigger";
interface PopoverContentProps extends React.ComponentPropsWithRef<"div">, PopoverContentFlush {
    /** Inline measure of the panel — `panel` (default) · `auto` (content decides) · `trigger`. */
    width?: PopoverContentWidth;
    /**
     * Render THIS panel somewhere other than the default. Almost always unnecessary: mounting the
     * whole tree in a shadow root is what `OverlayPortalProvider` is for, and it moves every overlay
     * at once. Reach for this only to place one panel differently from the rest.
     */
    portalContainer?: Element;
    /** Cạnh của trigger mà panel bám vào. */
    side?: Side;
    /** Canh panel theo cạnh của trigger. */
    align?: Align;
    /** Khoảng cách theo trục chính, tính bằng px. */
    sideOffset?: number;
    /** Khoảng cách theo trục phụ, tính bằng px. */
    alignOffset?: number;
    /** Lật panel sang cạnh đối diện khi hết chỗ. */
    avoidCollisions?: boolean;
    /** Khoảng chừa với mép khung nhìn. RAC chỉ nhận một số; object lấy cạnh lớn nhất. */
    collisionPadding?: number | Partial<Record<Side, number>>;
    /** Không còn tác dụng trên nền RAC — giữ trong kiểu vì là API công khai. */
    sticky?: "partial" | "always";
    /** Không còn tác dụng trên nền RAC — giữ trong kiểu vì là API công khai. */
    hideWhenDetached?: boolean;
    /** Không còn tác dụng trên nền RAC — giữ trong kiểu vì là API công khai. */
    forceMount?: true;
    /**
     * Chặn việc panel tự lấy tiêu điểm khi mở, bằng `event.preventDefault()`.
     *
     * Năm picker trong kho dựa vào đúng điều này để giữ tiêu điểm ở ô nhập, nên hành vi được chép
     * tay từ Radix chứ không bỏ.
     */
    onOpenAutoFocus?: (event: Event) => void;
    /**
     * Chặn việc trả tiêu điểm về nơi nó đứng trước khi panel mở, bằng `event.preventDefault()`.
     *
     * Phát ở MỌI đường đóng (chọn một mục, Escape, bấm ra ngoài, Tab ra ngoài), nên consumer đưa
     * được tiêu điểm tới đúng chỗ người dùng cần gõ tiếp thay vì để nó quay về trigger.
     */
    onCloseAutoFocus?: (event: Event) => void;
}
export declare function PopoverContent(props: PopoverContentProps): React.JSX.Element;
export declare const PopoverHeader: ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) => React.JSX.Element;
export declare const PopoverTitle: ({ className, id, ...props }: React.HTMLAttributes<HTMLDivElement>) => React.JSX.Element;
export declare const PopoverDescription: ({ className, id, ...props }: React.HTMLAttributes<HTMLParagraphElement>) => React.JSX.Element;
export {};