import * as React from "react";
import { type MenuItemRenderProps, type PopoverProps, type PopoverRenderProps } from "react-aria-components";
import type { DropdownMenuPlacementProp, DropdownMenuTriggerActionProp } from "../../props/components/navigation.prop.js";
export type { DropdownMenuPlacementProp, DropdownMenuTriggerActionProp, } from "../../props/components/navigation.prop.js";
/**
 * Dịch trạng thái item của RAC sang bộ `data-*` mà Radix phát ra và CSS của kho đang bám.
 *
 * `data-highlighted` là móc tô sáng bàn phím (`.ui-dropdown-menu-item[data-highlighted]`);
 * `data-state` mang cả hai nghĩa của Radix — "open" cho sub-trigger, "checked" cho hàng có chọn.
 */
export declare function radixItemState(state: MenuItemRenderProps): Record<string, string | undefined>;
/**
 * Dịch trạng thái popover của RAC sang `data-state` / `data-side` của Radix.
 *
 * ĐI KÈM: hai chỗ gọi nó đều bỏ `role` khỏi DOM (`role={undefined}`). RAC tự gắn `role="dialog"`
 * cho MỌI popover modal — "Automatically render Popover with role=dialog except when isNonModal is
 * true" — kể cả khi ruột của nó là một `role="menu"`. Radix không làm thế, và hợp đồng của tệp này
 * là giữ hình dạng Radix ở CẢ cây a11y chứ không chỉ ở tên prop.
 *
 * Cái giá, đo được ở consumer chuột bạch (godx-chat, 08/09/2026): mở một hộp thoại TỪ một mục menu
 * để lại HAI phần tử `role="dialog"` trong DOM suốt ~300ms — popover của menu đang chạy animation
 * thoát (`data-exiting`), cộng chính hộp thoại vừa mở. 12 phép kiểm Playwright đỏ bằng "strict mode
 * violation" trên `getByRole('dialog')`, thứ Playwright KHÔNG thử lại. Và với trình đọc màn hình,
 * một menu vẫn tự xưng là "dialog".
 *
 * Bỏ đúng THUỘC TÍNH, không đụng hành vi: state `isDialog` bên trong RAC không đổi, nên việc đưa
 * tiêu điểm vào popover lúc mở vẫn chạy nguyên như cũ.
 */
export declare function radixSurfaceState(state: PopoverRenderProps): Record<string, string | undefined>;
/** Radix `side` + `align` → `placement` của RAC. `align="center"` là placement trần. */
export declare function toPlacement(side?: "top" | "right" | "bottom" | "left", align?: "start" | "center" | "end"): PopoverProps["placement"];
/**
 * Radix trao cho `onSelect` một `Event` huỷ được. RAC's `onAction` không có sự kiện nào, nên ta
 * dựng một cái tương đương để consumer gọi `preventDefault()` không nổ — nhưng nó KHÔNG còn giữ
 * menu mở được nữa (xem báo cáo di trú).
 */
export declare function selectEvent(name: string): Event;
interface DropdownMenuPropsOwn {
    /** Trạng thái mở có kiểm soát (Radix). Bên trong là `isOpen` của RAC. */
    open?: boolean;
    defaultOpen?: boolean;
    onOpenChange?: (open: boolean) => void;
    /** `modal={false}` → `isNonModal` của RAC: nền không bị khoá cuộn, không bị `inert`. */
    modal?: boolean;
    /**
     * Radix đọc `dir` để đảo mũi tên trái/phải. RAC lấy hướng từ locale (`I18nProvider` /
     * `useLocale`), nên prop này còn trong API vì hợp đồng, nhưng không tự đảo hướng.
     */
    dir?: "ltr" | "rtl";
    /** Ant Design `trigger`. @see DropdownMenuTriggerActionProp. Default `['click']`. */
    trigger?: readonly DropdownMenuTriggerActionProp[];
    /** Ant Design `disabled` — no gesture opens the menu (antd empties the trigger list). */
    disabled?: boolean;
    /** Ant Design `mouseEnterDelay`, in SECONDS, for `trigger={['hover']}`. Default 0.15. */
    mouseEnterDelay?: number;
    /** Ant Design `mouseLeaveDelay`, in SECONDS. Default 0.1 — long enough to cross the gap. */
    mouseLeaveDelay?: number;
}
type DropdownMenuProps = React.PropsWithChildren<DropdownMenuPropsOwn>;
export declare function DropdownMenu({ children, open, defaultOpen, onOpenChange, modal, dir, trigger, disabled, mouseEnterDelay, mouseLeaveDelay, }: DropdownMenuProps): React.JSX.Element;
interface DropdownMenuTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
    /** Giao hành vi mở cho phần tử con thay vì `<button>` mặc định — như Radix. */
    asChild?: boolean;
}
/**
 * RAC không nhận một `<button>` trần làm trigger: hành vi nhấn đi qua `PressResponder`, và chỉ
 * `Pressable` (hoặc một component gọi `usePress`) mới nhận được nó. `asChild` vì vậy trở thành
 * "bọc con trong `Pressable`" thay vì "hợp nhất props vào con" — kết quả với consumer là như nhau:
 * chính phần tử của họ mang `aria-haspopup` / `aria-expanded` và nhận cú nhấn.
 */
export declare function DropdownMenuTrigger({ asChild, children, ...props }: DropdownMenuTriggerProps): React.JSX.Element;
interface DropdownMenuPortalPropsOwn {
    /** Giữ tên vì hợp đồng: RAC `Popover` tự cổng ra `document.body`, không có bản dựng cưỡng bức. */
    forceMount?: true;
}
type DropdownMenuPortalProps = React.PropsWithChildren<DropdownMenuPortalPropsOwn>;
/** RAC `Popover` đã tự cổng, nên Portal chỉ còn là chỗ giữ hình dạng cây của Radix. */
export declare function DropdownMenuPortal({ children }: DropdownMenuPortalProps): React.JSX.Element;
interface DropdownMenuGroupPropsOwn {
    className?: string;
}
type DropdownMenuGroupProps = React.PropsWithChildren<DropdownMenuGroupPropsOwn>;
/** Radix dựng `<div role="group">`; RAC `MenuSection` dựng `<section role="group">`. */
export declare function DropdownMenuGroup({ children, className }: DropdownMenuGroupProps): React.JSX.Element;
interface DropdownMenuRadioGroupPropsOwn {
    className?: string;
    value?: string;
    onValueChange?: (value: string) => void;
}
type DropdownMenuRadioGroupProps = React.PropsWithChildren<DropdownMenuRadioGroupPropsOwn>;
/**
 * Radix giữ trạng thái chọn ở chính RadioGroup; RAC giữ ở collection, khoá theo `id` của item.
 * Nên `value` của consumer trở thành `selectedKeys` và `value` của RadioItem trở thành khoá.
 */
export declare function DropdownMenuRadioGroup({ children, className, value, onValueChange, }: DropdownMenuRadioGroupProps): React.JSX.Element;
interface DropdownMenuSubPropsOwn {
    /**
     * RAC `SubmenuTrigger` tự giữ trạng thái mở của submenu và không phơi ra chỗ nào để điều khiển
     * nó. Ba prop này còn trong API vì hợp đồng, nhưng không còn tác dụng.
     */
    open?: boolean;
    defaultOpen?: boolean;
    onOpenChange?: (open: boolean) => void;
}
type DropdownMenuSubProps = React.PropsWithChildren<DropdownMenuSubPropsOwn>;
/**
 * `SubmenuTrigger` đọc children THEO VỊ TRÍ — `children[0]` là item mở submenu, `children[1]` là
 * popover — nên thứ tự `<SubTrigger/>` rồi `<SubContent/>` của Radix ánh xạ thẳng.
 */
export declare function DropdownMenuSub({ children }: DropdownMenuSubProps): React.JSX.Element;
/**
 * Width axis of the menu surface (gh#396) — the vocabulary `Select` already publishes, extended to
 * the one member of the family that never got it. `"trigger"` matches the anchor, `"auto"` releases
 * the floor and shrinks to the content, and `sm | md | lg` select the `--menu-content-width-*`
 * ladder. Unset = today's `--dropdown-content-min-width`, so nothing moves.
 */
type DropdownMenuContentWidth = "trigger" | "auto" | "sm" | "md" | "lg";
interface DropdownMenuContentPropsOwn {
    placement?: DropdownMenuPlacementProp;
    arrow?: boolean;
    width?: DropdownMenuContentWidth;
    className?: string;
    side?: "top" | "right" | "bottom" | "left";
    align?: "start" | "center" | "end";
    sideOffset?: number;
    alignOffset?: number;
    avoidCollisions?: boolean;
    collisionPadding?: number;
    /** Radix `loop` cho điều hướng bàn phím → `shouldFocusWrap` của RAC. */
    loop?: boolean;
    /** Giữ tên vì hợp đồng; RAC không có bản dựng cưỡng bức và không tự tháo khi trigger rời màn. */
    forceMount?: true;
    hideWhenDetached?: boolean;
    sticky?: "partial" | "always";
}
type DropdownMenuContentProps = React.PropsWithChildren<DropdownMenuContentPropsOwn>;
/**
 * Một phần tử của Radix (`Content`) tách thành HAI ở RAC: `Popover` là hộp được định vị, `Menu` là
 * phần tử mang `role="menu"`. `data-slot` và lớp `ui-dropdown-menu-content` ở lại trên HỘP, cùng
 * chỗ với `data-state` / `data-side` mà các utility animate đang đọc.
 *
 * `useInertHiddenBackground` đã được gỡ ở đây, và nay đã rời hẳn `src/` sang
 * `data-entry/__tests__/inert-background.fixture.ts` (gh#643): RAC gọi `ariaHideOutside(..., {shouldUseInert:
 * true})` — nền thành `inert` thật chứ không chỉ `aria-hidden`, nên axe `aria-hidden-focus` không
 * còn cửa để nổ. Và hiệu ứng đó khoá theo `state.isOpen`, không theo unmount, nên `inert` được nhả
 * NGAY ở ý định đóng: đúng lớp lỗi gh#385, đã sửa ở thượng nguồn. Phép đo là
 * `src/components/__tests__/overlay-inert-release-385.test.tsx`.
 */
export declare function DropdownMenuContent({ children, className, side, align, sideOffset, placement, arrow, width, alignOffset, avoidCollisions, collisionPadding, loop, hideWhenDetached, sticky, forceMount, }: DropdownMenuContentProps): React.JSX.Element;
interface DropdownMenuItemPropsOwn {
    className?: string;
    inset?: boolean;
    variant?: "default" | "destructive";
    disabled?: boolean;
    onSelect?: (event: Event) => void;
    textValue?: string;
    /** Mượn thẻ của con thay vì dựng `<div>` riêng — chỗ để nhét một `<Link>` vào một mục menu. */
    asChild?: boolean;
    /**
     * `id` và mọi `data-*` ĐI XUỐNG phần tử gốc của item (gh#631).
     *
     * Trigger của chính cụm này đã nhận cách xử lý ấy ở 20.0.0, với đúng lý do CHANGELOG ghi:
     * "trước đó bị nuốt, nên selector e2e của consumer rời ra trong im lặng". Phần item thì chưa,
     * nên hai nửa của cùng một component hành xử ngược nhau.
     *
     * TypeScript không bắt được: JSX luôn cho qua mọi thuộc tính có gạch nối, nên `data-testid`
     * biên dịch sạch và chỉ hỏng lúc chạy. Với `id` còn tệ hơn — nó là thứ `aria-activedescendant`
     * trỏ vào, và nó biến mất không một lời.
     */
    id?: string;
}
type DropdownMenuItemProps = React.PropsWithChildren<DropdownMenuItemPropsOwn> & Record<`data-${string}`, unknown>;
export declare function DropdownMenuItem({ children, className, inset, variant, disabled, onSelect, textValue, asChild, ...forwarded }: DropdownMenuItemProps): React.JSX.Element;
interface DropdownMenuLabelPropsOwn {
    className?: string;
    inset?: boolean;
    /** Mượn thẻ của con thay vì dựng `<header>` riêng. */
    asChild?: boolean;
}
type DropdownMenuLabelProps = React.PropsWithChildren<DropdownMenuLabelPropsOwn>;
/**
 * Radix dựng `<div>`; nút nhãn của một collection RAC là `Header`, tức `<header>`.
 *
 * `Header` không đi qua `useRenderProps`, nên `props.children` trong `render` CHÍNH là children của
 * consumer — không có `Provider` chen vào như ở `MenuItem`. `Slot` vì thế nhận thẳng gói props.
 *
 * NHƯNG PHẢI RENDER RA `<div>`, KHÔNG PHẢI `<header>`. `<header>` mang vai trò ngầm `banner`, và
 * `banner` không nằm trong danh sách con hợp lệ của `role="menu"` (axe: aria-required-children,
 * ARIA 1.2 — menu chỉ nhận menuitem / menuitemcheckbox / menuitemradio / group / separator). Radix
 * dựng `<div>`, vai trò `generic`, nên nó không bao giờ vấp lỗi này.
 *
 * `Header` vẫn được dùng chứ không thay bằng `<div>` trần: bộ dựng collection của RAC chỉ nhận các
 * nút nó biết, một phần tử lạ đặt thẳng trong `Menu` sẽ bị nó bỏ. Nên giữ nút, đổi thẻ.
 *
 * Lỗi này ẩn suốt vì helper a11y dùng chung soi container của lần render, còn menu thì portal ra
 * `document.body` — phép kiểm mang tên "open, fully-composed menu" thực chất soi một hộp rỗng.
 */
export declare function DropdownMenuLabel({ children, className, inset, asChild }: DropdownMenuLabelProps): React.JSX.Element;
interface DropdownMenuSeparatorProps {
    className?: string;
}
export declare function DropdownMenuSeparator({ className }: DropdownMenuSeparatorProps): React.JSX.Element;
interface DropdownMenuCheckboxItemPropsOwn {
    className?: string;
    checked?: boolean;
    onCheckedChange?: (checked: boolean) => void;
    disabled?: boolean;
    textValue?: string;
    /** Mượn thẻ của con thay vì dựng `<div>` riêng; ô đánh dấu vẫn nằm bên trong thẻ mượn. */
    asChild?: boolean;
}
type DropdownMenuCheckboxItemProps = React.PropsWithChildren<DropdownMenuCheckboxItemPropsOwn>;
/**
 * Ở Radix mỗi CheckboxItem tự giữ `checked`. Ở RAC không có `isSelected` trên item: `aria-checked`
 * và `role="menuitemcheckbox"` chỉ xuất hiện khi collection BAO QUANH khai báo `selectionMode`.
 * Nên mỗi hàng độc lập được bọc trong một `MenuSection` một-phần-tử — đó là cái giá để giữ đúng
 * vai trò ARIA mà consumer đang test.
 */
export declare function DropdownMenuCheckboxItem({ children, className, checked, onCheckedChange, disabled, textValue, asChild, }: DropdownMenuCheckboxItemProps): React.JSX.Element;
interface DropdownMenuRadioItemPropsOwn {
    className?: string;
    value: string;
    disabled?: boolean;
    textValue?: string;
    /** Mượn thẻ của con thay vì dựng `<div>` riêng. */
    asChild?: boolean;
}
type DropdownMenuRadioItemProps = React.PropsWithChildren<DropdownMenuRadioItemPropsOwn>;
export declare function DropdownMenuRadioItem({ children, className, value, disabled, textValue, asChild, }: DropdownMenuRadioItemProps): React.JSX.Element;
interface DropdownMenuSubTriggerPropsOwn {
    className?: string;
    inset?: boolean;
    disabled?: boolean;
    textValue?: string;
    /** Mượn thẻ của con thay vì dựng `<div>` riêng; mũi tên submenu vẫn nằm bên trong thẻ mượn. */
    asChild?: boolean;
}
type DropdownMenuSubTriggerProps = React.PropsWithChildren<DropdownMenuSubTriggerPropsOwn>;
export declare function DropdownMenuSubTrigger({ children, className, inset, disabled, textValue, asChild, }: DropdownMenuSubTriggerProps): React.JSX.Element;
interface DropdownMenuSubContentPropsOwn {
    className?: string;
    align?: "start" | "center" | "end";
    alignOffset?: number;
    sideOffset?: number;
    avoidCollisions?: boolean;
    collisionPadding?: number;
    loop?: boolean;
    forceMount?: true;
    hideWhenDetached?: boolean;
    sticky?: "partial" | "always";
}
type DropdownMenuSubContentProps = React.PropsWithChildren<DropdownMenuSubContentPropsOwn>;
export declare function DropdownMenuSubContent({ children, className, align, alignOffset, sideOffset, avoidCollisions, collisionPadding, loop, forceMount, hideWhenDetached, sticky, }: DropdownMenuSubContentProps): React.JSX.Element;
export declare const DropdownMenuShortcut: ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>) => React.JSX.Element;