import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
import * as RadixDropdownMenu from '@radix-ui/react-dropdown-menu';
import { type VariantProps } from 'class-variance-authority';
import { type KbdNamedKey } from '../kbd/kbd';
declare const contentVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
/** A named settings row (a ChoiceSub or SwitchItem given a `name`) and
 *  its current state, as an agent reads it. Values only, never labels. */
export interface DropdownMenuSetting {
    setting: string;
    kind: 'choice' | 'switch';
    /** ChoiceSub: the selected value and every option's value. */
    value?: string;
    options?: string[];
    /** SwitchItem: whether it is on. */
    checked?: boolean;
    disabled: boolean;
}
export interface DropdownMenuHandle {
    getIsOpen: () => boolean;
    open: () => void;
    close: () => void;
    /** The named settings rows, while the menu is open (closed: none). */
    getSettings: () => DropdownMenuSetting[];
    /** Pick `value` on the named ChoiceSub. A closed menu opens for the
     *  moment and closes again. Rejects on an unknown row, value or a
     *  disabled one. */
    setValue: (setting: string, value: string) => Promise<void>;
    /** Turn the named SwitchItem on or off, as `setValue` does. */
    setChecked: (setting: string, checked: boolean) => Promise<void>;
}
export interface DropdownMenuRootProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Root> {
    /** Opaque instance id — forwarded to DropdownMenu.Content as `data-component-id`. */
    id?: string;
}
export interface DropdownMenuContentProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Content>, VariantProps<typeof contentVariants> {
}
export interface DropdownMenuItemProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Item> {
    startIcon?: ReactNode;
    endIcon?: ReactNode;
    description?: ReactNode;
    /** Convenience — renders a DS <Kbd keys={…}> on the inline-end. */
    shortcut?: Array<KbdNamedKey | string>;
}
export type DropdownMenuCheckboxItemProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.CheckboxItem>;
export interface DropdownMenuSwitchItemProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.CheckboxItem> {
    /** Names the row for agents (the menu's `set_checked` action and
     *  `settings` state) and emits `data-setting`. */
    name?: string;
}
export type DropdownMenuRadioItemProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.RadioItem>;
export type DropdownMenuLabelProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.Label>;
export type DropdownMenuSeparatorProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.Separator>;
export interface DropdownMenuShortcutProps {
    keys: Array<KbdNamedKey | string>;
    separator?: 'none' | 'plus' | 'then';
}
export interface DropdownMenuSubTriggerProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.SubTrigger> {
    startIcon?: ReactNode;
}
export type DropdownMenuSubContentProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.SubContent>;
export interface DropdownMenuChoiceOption<T extends string = string> {
    value: T;
    label: ReactNode;
    disabled?: boolean;
}
export interface DropdownMenuChoiceSubProps<T extends string = string> {
    /** The setting's name, shown at the start of the row. */
    label: ReactNode;
    /** The selected option's value; its label shows at the end of the row. */
    value: T;
    onValueChange: (value: T) => void;
    options: ReadonlyArray<DropdownMenuChoiceOption<T>>;
    startIcon?: ReactNode;
    disabled?: boolean;
    /** Close the whole menu after a pick. @default false */
    closeOnSelect?: boolean;
    /** Names the row for agents (the menu's `set_value` action and
     *  `settings` state) and emits `data-setting`. */
    name?: string;
    className?: string;
}
declare function ChoiceSub<T extends string>({ label, value, onValueChange, options, startIcon, disabled, closeOnSelect, name, className, }: DropdownMenuChoiceSubProps<T>): import("react/jsx-runtime").JSX.Element;
declare namespace ChoiceSub {
    var displayName: string;
}
export declare const DropdownMenu: {
    Root: {
        ({ dir, id, open: openProp, defaultOpen, onOpenChange, ...props }: DropdownMenuRootProps): import("react/jsx-runtime").JSX.Element;
        displayName: string;
    };
    Trigger: import("react").ForwardRefExoticComponent<RadixDropdownMenu.DropdownMenuTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
    Portal: import("react").FC<RadixDropdownMenu.DropdownMenuPortalProps>;
    Content: import("react").ForwardRefExoticComponent<DropdownMenuContentProps & import("react").RefAttributes<HTMLDivElement>>;
    Group: import("react").ForwardRefExoticComponent<RadixDropdownMenu.DropdownMenuGroupProps & import("react").RefAttributes<HTMLDivElement>>;
    Item: import("react").ForwardRefExoticComponent<DropdownMenuItemProps & import("react").RefAttributes<HTMLDivElement>>;
    CheckboxItem: import("react").ForwardRefExoticComponent<Omit<RadixDropdownMenu.DropdownMenuCheckboxItemProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    SwitchItem: import("react").ForwardRefExoticComponent<DropdownMenuSwitchItemProps & import("react").RefAttributes<HTMLDivElement>>;
    RadioGroup: import("react").ForwardRefExoticComponent<RadixDropdownMenu.DropdownMenuRadioGroupProps & import("react").RefAttributes<HTMLDivElement>>;
    RadioItem: import("react").ForwardRefExoticComponent<Omit<RadixDropdownMenu.DropdownMenuRadioItemProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Label: import("react").ForwardRefExoticComponent<Omit<RadixDropdownMenu.DropdownMenuLabelProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Separator: import("react").ForwardRefExoticComponent<Omit<RadixDropdownMenu.DropdownMenuSeparatorProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Shortcut: import("react").ForwardRefExoticComponent<DropdownMenuShortcutProps & import("react").RefAttributes<HTMLSpanElement>>;
    Sub: import("react").FC<RadixDropdownMenu.DropdownMenuSubProps>;
    SubTrigger: import("react").ForwardRefExoticComponent<DropdownMenuSubTriggerProps & import("react").RefAttributes<HTMLDivElement>>;
    SubContent: import("react").ForwardRefExoticComponent<Omit<RadixDropdownMenu.DropdownMenuSubContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    ChoiceSub: typeof ChoiceSub;
};
export {};
//# sourceMappingURL=dropdown-menu.d.ts.map