/**
 * Dependency-free anchored menu with the Studio part API used by Veryfront.
 * It provides menu ARIA wiring, roving keyboard navigation, typeahead, focus
 * restoration, collision-aware positioning, and outside/Escape dismissal.
 *
 * @module react/components/ui/dropdown-menu
 */
import * as React from "react";
import { type PolymorphicButtonAttributes } from "./slot.js";
import { type AnchoredSlottedTriggerProps, type AnchoredTriggerPublicProps } from "./anchored-surface.js";
/** Props accepted by `<DropdownMenu>`. */
export interface DropdownMenuProps {
    children: React.ReactNode;
    open?: boolean;
    defaultOpen?: boolean;
    onOpenChange?: (open: boolean) => void;
}
/** DropdownMenu root — owns open state and the positioning anchor. */
export declare function DropdownMenu(props: DropdownMenuProps): React.ReactElement;
/**
 * Trigger — toggles the menu; the positioning anchor. `asChild` merges onto
 * the child element, which must forward `ref` to its DOM node.
 */
export interface DropdownMenuTriggerProps extends AnchoredTriggerPublicProps {
}
/** Literal slotted trigger contract with an element-specific ref. */
export type DropdownMenuSlottedTriggerProps<T extends HTMLElement = HTMLElement> = AnchoredSlottedTriggerProps<T>;
export declare function DropdownMenuTrigger<T extends HTMLElement = HTMLElement>(props: DropdownMenuSlottedTriggerProps<T>): React.ReactElement;
export declare function DropdownMenuTrigger(props: DropdownMenuTriggerProps): React.ReactElement;
/** Props accepted by `<DropdownMenuContent>`. */
export interface DropdownMenuContentProps extends React.HTMLAttributes<HTMLDivElement> {
    /** Horizontal alignment relative to the trigger. */
    align?: "start" | "end";
    /** Consumer ref for the rendered menu surface. */
    ref?: React.Ref<HTMLDivElement>;
}
/** Menu surface — rendered below the trigger while open. No border (Studio). */
export declare function DropdownMenuContent({ children, className, align, onKeyDown, ...props }: DropdownMenuContentProps): React.ReactElement | null;
/** Groups related items with a tight inner gap (Studio: `gap-px p-0.5`). */
export declare function DropdownMenuGroup({ children, className }: {
    children: React.ReactNode;
    className?: string;
}): React.ReactElement;
/**
 * Backward-compatible props accepted by `<DropdownMenuItem>`.
 *
 * Keep this as an interface with a broad boolean `asChild` so existing wrapper
 * interfaces, conditional `asChild` values, and prop spreads remain valid.
 * The component overload below adds the element-specific contract for callers
 * that opt into a literal `asChild` value.
 */
export interface DropdownMenuItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect"> {
    /** Called when the item is chosen (also closes the menu). */
    onSelect?: (event: React.MouseEvent<HTMLButtonElement>) => void;
    /** `asChild` merges item styling and behavior onto one child element. */
    asChild?: boolean;
    ref?: React.Ref<HTMLButtonElement>;
}
/** Slotted-element props accepted by `<DropdownMenuItem>`. */
export type DropdownMenuSlottedItemProps<T extends HTMLElement = HTMLElement> = Omit<PolymorphicButtonAttributes<T>, "children" | "ref" | "type"> & {
    /** Called when the item is chosen (also closes the menu). */
    onSelect?: (event: React.MouseEvent<T>) => void;
    /** Merge menu-item behavior and styling onto one custom child element. */
    asChild: true;
    children: React.ReactElement;
    disabled?: boolean;
    /** Applied only when `children` is an intrinsic `<button>`; opaque buttons own `type`. */
    type?: T extends HTMLButtonElement ? React.ButtonHTMLAttributes<HTMLButtonElement>["type"] : never;
    ref?: React.Ref<T>;
};
/** A selectable menu item. Icons render at `size-3.5` (14px). */
export declare function DropdownMenuItem<T extends HTMLElement = HTMLElement>(props: DropdownMenuSlottedItemProps<T>): React.ReactElement;
export declare function DropdownMenuItem(props: DropdownMenuItemProps): React.ReactElement;
/** Trailing metadata text — keyboard shortcuts, counts, badges. */
export declare function DropdownMenuItemMeta({ children, className, }: {
    children: React.ReactNode;
    className?: string;
}): React.ReactElement;
/** Full-width divider between groups (Studio: `-mx-2.5 my-2`). */
export declare function DropdownMenuSeparator({ className }: {
    className?: string;
}): React.ReactElement;
/** Non-interactive section label — full-strength foreground (Studio). */
export declare function DropdownMenuLabel({ children, className, }: {
    children: React.ReactNode;
    className?: string;
}): React.ReactElement;
//# sourceMappingURL=dropdown-menu.d.ts.map