import { type FC, type PropsWithChildren } from 'react';
import { type UseComboboxOptions } from '../hooks/useCombobox';
/**
 * Root props for the compound Combobox component.
 */
export type ComboboxRootProps<T extends string = string> = PropsWithChildren<UseComboboxOptions<T> & {
    /**
     * Optional selected value used for item highlighting when it differs from
     * the controlled value.
     */
    currentValue?: string;
}>;
declare function ComboboxRoot<T extends string = string>({ value, onChange, currentValue, disabled, children, }: ComboboxRootProps<T>): import("react/jsx-runtime").JSX.Element;
/**
 * Props for the button that opens the combobox popover.
 */
export interface ComboboxTriggerProps {
    className?: string;
    ariaLabel?: string;
}
/**
 * Props for the popover content that contains combobox options.
 */
export interface ComboboxContentProps {
    searchable?: boolean;
    searchPlaceholder?: string;
    emptyMessage?: string;
}
/**
 * Props for an individual selectable combobox item.
 */
export interface ComboboxItemProps {
    /**
     * Stable item value committed through the Combobox onChange handler.
     */
    value: string;
    /**
     * Optional display text or aliases used to match this item during search.
     */
    keywords?: string[];
    isSelected?: boolean;
}
/**
 * Compound component for Popover-based combobox selectors.
 *
 * @example
 * ```tsx
 * <Combobox value={value} onChange={setValue}>
 *   <Combobox.Trigger>
 *     <span>{selectedLabel}</span>
 *   </Combobox.Trigger>
 *   <Combobox.Content searchable searchPlaceholder="Search...">
 *     {options.map((option) => (
 *       <Combobox.Item key={option.value} value={option.value}>
 *         <span>{option.label}</span>
 *       </Combobox.Item>
 *     ))}
 *   </Combobox.Content>
 * </Combobox>
 * ```
 */
export declare const Combobox: typeof ComboboxRoot & {
    Trigger: FC<PropsWithChildren<ComboboxTriggerProps>>;
    Content: FC<PropsWithChildren<ComboboxContentProps>>;
    Item: FC<PropsWithChildren<ComboboxItemProps>>;
};
export {};
//# sourceMappingURL=combobox.d.ts.map