import { ComponentPropsWithoutRef, Dispatch, SetStateAction, ReactNode, MutableRefObject } from 'react';
import { UseComboboxProps as UseDownshiftComboboxProps, UseMultipleSelectionProps as UseDownshiftMultipleSelectionProps, UseComboboxReturnValue as UseDownshiftComboboxReturnValue, UseMultipleSelectionReturnValue as UseDownshiftMultipleSelectionReturnValue, UseComboboxState as UseDownshiftComboboxState, UseMultipleSelectionState as UseDownshiftMultipleSelectionState, UseSelectProps as UseDownshiftSelectProps, UseSelectReturnValue as UseDownshiftSelectReturnValue, UseSelectState as UseDownshiftSelectState } from 'downshift';
import { MatchSorterOptions } from 'match-sorter';
import { LayoutUtilProps } from '../../types';
import { ComboboxGroupByValue } from './internal/ComboboxGroupContext';
/**
 * Props for the ComboboxContext component
 * @extends Required<Pick<UseDownshiftComboboxProps<Item> | UseDownshiftSelectProps<Item>, "items" | "itemToString" | "itemToKey" | "selectedItem">>
 * @extends Pick<UseDownshiftComboboxReturnValue<Item> | UseDownshiftSelectReturnValue<Item>, "getToggleButtonProps" | "getItemProps" | "getLabelProps" | "getMenuProps" | "closeMenu" | "selectItem" | "highlightedIndex" | "isOpen" | "inputValue">
 * @extends Partial<Pick<UseDownshiftComboboxReturnValue<Item>, "getInputProps">>
 * @extends Partial<Pick<UseDownshiftMultipleSelectionReturnValue<Item>, "getSelectedItemProps" | "getDropdownProps" | "addSelectedItem" | "removeSelectedItem" | "setSelectedItems" | "reset">>
 * @extends Partial<Pick<UseDownshiftComboboxReturnValue<Item> | UseDownshiftSelectReturnValue<Item>, "reset">>
 * @extends LayoutUtilProps
 */
export type ComboboxContextProps<Item = any> = Required<Pick<UseDownshiftComboboxProps<Item> | UseDownshiftSelectProps<Item>, "items" | "itemToString" | "itemToKey" | "selectedItem">> & Pick<UseDownshiftComboboxReturnValue<Item> | UseDownshiftSelectReturnValue<Item>, "getToggleButtonProps" | "getItemProps" | "getLabelProps" | "getMenuProps" | "closeMenu" | "selectItem" | "highlightedIndex" | "isOpen" | "inputValue"> & Partial<Pick<UseDownshiftComboboxReturnValue<Item>, "getInputProps">> & Partial<Pick<UseDownshiftMultipleSelectionReturnValue<Item>, "getSelectedItemProps" | "getDropdownProps" | "addSelectedItem" | "removeSelectedItem" | "setSelectedItems" | "reset">> & Partial<Pick<UseDownshiftComboboxReturnValue<Item> | UseDownshiftSelectReturnValue<Item>, "reset">> & LayoutUtilProps & {
    disableClearSelection?: boolean;
    isReadOnly?: boolean;
    isDisabled?: boolean;
    /** @deprecated to be removed on next major - this is replaced by Combobox's disabled and readOnly props */
    setIsReadOnly: Dispatch<SetStateAction<undefined | boolean>>;
    /** @deprecated to be removed on next major - this is replaced by Combobox's disabled and readOnly props */
    setIsDisabled: Dispatch<SetStateAction<undefined | boolean>>;
    hasDisabledPopover: boolean;
    setHasDisabledPopover: Dispatch<SetStateAction<boolean>>;
    hasEmpty: boolean;
    setHasEmpty: Dispatch<SetStateAction<boolean>>;
    multiple: boolean;
    select: boolean;
    selectedItems: Item[];
    disabledItems: Item[];
    setDisabledItems: Dispatch<SetStateAction<Item[]>>;
    setForceCloseOnSelectItems: Dispatch<SetStateAction<Item[]>>;
    setForceClearInputValueOnSelectItems: Dispatch<SetStateAction<Item[]>>;
    loading: boolean;
    referenceRef: MutableRefObject<HTMLDivElement | null>;
    contentRef: MutableRefObject<HTMLDivElement | null>;
    hasAddNew?: boolean;
    setHasAddNew?: Dispatch<SetStateAction<boolean>>;
    onSelectItemAddNew?: (inputValue: UseDownshiftComboboxReturnValue<Item>["inputValue"]) => void;
    setOnSelectItemAddNew?: Dispatch<SetStateAction<((inputValue: UseDownshiftComboboxReturnValue<Item>["inputValue"]) => void) | undefined>>;
    hasExactMatch?: boolean;
    setHasExactMatch?: Dispatch<SetStateAction<boolean>>;
    groupBy?: string;
    groupToString?: (groupByValue: ComboboxGroupByValue) => string | null;
    groups: {
        key: ComboboxGroupByValue;
        label: string | null;
        items: Item[];
    }[];
};
export declare const ComboboxContext: import('react').Context<ComboboxContextProps<any> | null>;
/**
 * Hook to access the Combobox context
 * @returns The Combobox context value
 * @throws Error if used outside of a Combobox component
 */
export declare const useCombobox: <Item = any>() => ComboboxContextProps<Item>;
/**
 * Props for shared functionality across all combobox variants
 * @extends LayoutUtilProps
 * @extends Pick<ComponentPropsWithoutRef<"div">, "className" | "style">
 */
type SharedProps<Item> = LayoutUtilProps & Pick<ComponentPropsWithoutRef<"div">, "className" | "style"> & {
    children?: ReactNode;
    /**
     * @default false
     */
    disabled?: boolean;
    /**
     * @default false
     */
    readOnly?: boolean;
    /**
     * @default false
     */
    loading?: boolean;
    /**
     * @default false
     */
    disableCloseOnClickOutside?: boolean;
    /**
     * @default false
     */
    disableMatchReferenceWidth?: boolean;
    /**
     * @deprecated to be removed on next major
     * This is not needed anymore as the Popover API is used.
     * Popover API uses top-layer for its popover content.
     */
    root?: HTMLElement | React.MutableRefObject<HTMLElement | null> | null;
    /**
     * @default false
     */
    open?: boolean;
    /**
     * @default false
     */
    disableCloseOnSelectItem?: boolean;
    onStateChange?: (changes: {
        type: string;
    } & Partial<UseDownshiftComboboxState<Item>> & Partial<UseDownshiftMultipleSelectionState<Item>> & Partial<UseDownshiftSelectState<Item>>) => void;
    minPopoverHeight?: string | number;
    groupBy?: string;
    groupToString?: (groupByValue: ComboboxGroupByValue) => string | null;
    /** Accepts groupBy values `a` and `b` -- must return a negative if `a` before `b` and a positive if `b` before `a`.
     * @default {func} (a, b) => `${a}`.localeCompare(`${b}`)
     */
    groupSorter?: (a: ComboboxGroupByValue, b: ComboboxGroupByValue) => number;
};
/**
 * Props for combobox-specific functionality
 * @extends Omit<UseDownshiftComboboxProps<Item>, "onStateChange" | "onInputValueChange">
 */
type SharedComboboxProps<Item> = Omit<UseDownshiftComboboxProps<Item>, "onStateChange" | "onInputValueChange"> & {
    filterOptions?: MatchSorterOptions<Item>;
    disableFilter?: boolean;
    /**
     * @deprecated Please use `Combobox.SearchField`'s `onChange` method instead
     */
    onInputValueChange?: UseDownshiftComboboxProps<Item>["onInputValueChange"];
};
/**
 * Props for select-specific functionality
 * @extends Omit<UseDownshiftSelectProps<Item>, "onStateChange" | "onInputValueChange">
 */
type SharedSelectProps<Item> = Omit<UseDownshiftSelectProps<Item>, "onStateChange" | "onInputValueChange">;
/**
 * Props for single selection functionality
 */
type SharedSingleProps<Item> = {
    multiple?: never;
    onChange?: Dispatch<SetStateAction<Item | null>> | ((arg: Item | null) => void);
};
/**
 * Props for multiple selection functionality
 * @extends Partial<Pick<UseDownshiftMultipleSelectionProps<Item>, "onSelectedItemsChange" | "initialSelectedItems" | "initialActiveIndex" | "defaultSelectedItems" | "defaultActiveIndex" | "activeIndex" | "selectedItems">>
 */
type SharedMultipleProps<Item> = {
    multiple: true;
    onChange?: Dispatch<SetStateAction<Item[] | null>> | ((arg: Item[] | null) => void);
} & Partial<Pick<UseDownshiftMultipleSelectionProps<Item>, "onSelectedItemsChange" | "initialSelectedItems" | "initialActiveIndex" | "defaultSelectedItems" | "defaultActiveIndex" | "activeIndex" | "selectedItems">>;
/**
 * Props for single select functionality
 * @extends SharedProps<Item>
 * @extends SharedSelectProps<Item>
 * @extends SharedSingleProps<Item>
 */
type SelectSingleProps<Item> = SharedProps<Item> & SharedSelectProps<Item> & SharedSingleProps<Item> & {
    disableClearSelection?: boolean;
};
/**
 * Props for multiple select functionality
 * @extends SharedProps<Item>
 * @extends SharedSelectProps<Item>
 * @extends SharedMultipleProps<Item>
 */
type SelectMultipleProps<Item> = SharedProps<Item> & SharedSelectProps<Item> & SharedMultipleProps<Item>;
/**
 * Props for single combobox functionality
 * @extends SharedProps<Item>
 * @extends SharedComboboxProps<Item>
 * @extends SharedSingleProps<Item>
 */
type ComboboxSingleProps<Item> = SharedProps<Item> & SharedComboboxProps<Item> & SharedSingleProps<Item>;
/**
 * Props for multiple combobox functionality
 * @extends Omit<SharedProps<Item>, "open" | "disableCloseOnSelectItem">
 * @extends SharedComboboxProps<Item>
 * @extends SharedMultipleProps<Item>
 */
type ComboboxMultipleProps<Item> = Omit<SharedProps<Item>, "open" | "disableCloseOnSelectItem"> & SharedComboboxProps<Item> & SharedMultipleProps<Item> & ({
    disableClearInputValueOnSelectItem: true;
    disableCloseOnSelectItem: true;
    open?: boolean;
} | {
    disableClearInputValueOnSelectItem: true;
    open: true;
    disableCloseOnSelectItem?: boolean;
} | {
    disableClearInputValueOnSelectItem?: never;
    disableCloseOnSelectItem?: boolean;
    open?: boolean;
});
/**
 * Props for the Combobox component
 * @extends ComboboxSingleProps<Item> | ComboboxMultipleProps<Item>
 */
export type ComboboxProps<Item = any> = ComboboxSingleProps<Item> | ComboboxMultipleProps<Item>;
type SelectProps<Item = any> = SelectSingleProps<Item> | SelectMultipleProps<Item>;
export type ComboboxSelectProps<Item> = SelectProps<Item>;
/**
 * ComboboxSingle component for single-item selection with search functionality.
 *
 * Features:
 * - Single item selection with search and filtering
 * - Configurable filtering options with match-sorter
 * - Optional "Add New" item functionality
 * - Grouping support with custom group labels and sorting
 * - Loading states with spinner indicators
 * - Disabled and read-only states
 * - Customizable popover behavior and positioning
 * - Full accessibility support with ARIA attributes
 * - Keyboard navigation support
 * - Layout utility props for positioning and spacing
 *
 * @example
 * <Combobox.Select
 *   items={items}
 *   itemToString={(item) => item.name}
 *   onChange={setSelectedItem}
 *   filterOptions={{ keys: ["name"] }}
 * >
 *   <Combobox.SearchField label="Select an item" />
 *   <Combobox.Content>
 *     {({ items }) => (
 *       <Combobox.List>
 *         {items.map((item, i) => (
 *           <Combobox.Item key={item.id} item={item} index={i}>
 *             {item.name}
 *           </Combobox.Item>
 *         ))}
 *       </Combobox.List>
 *     )}
 *   </Combobox.Content>
 * </Combobox.Select>
 */
export declare const ComboboxSingle: <Item>(props: ComboboxSingleProps<Item>) => import("react/jsx-runtime").JSX.Element;
export declare const ComboboxMultiple: <Item>(props: ComboboxMultipleProps<Item>) => import("react/jsx-runtime").JSX.Element;
/**
 * NOTE: There is a lot of duplicated code here! Here's a list of the /actual/
 *       differences between select-only and regular combobox to help with
 *       refactoring this later!
 *
 *       1) Using Downshift's `useSelect` hook instead of `useCombobox`
 *          - Swapping out the stateChangeTypes for their equivalents
 *       2) Since there's no input, we don't need to passthrough `getInputProps`
 *       3) Since we don't do any sorting or filtering, we can remove:
 *          - onInputValueChange function and prop
 *            - setInputValue function
 *          - onIsOpenChange function
 *          - filterOptions prop
 *          - internal `items` state and useEffect to keep it in sync
 *            - useEffect to track first render
 *       4) Multiple-specific
 *          - Remove `disableClearInputValueOnSelectItem` prop
 *          - No need to store `setInputValue` function
 *          - Remove all state reducer references to `inputValue`
 *          - Remove `onStateChange` function from `useMultipleSelection`
 */
export declare const SelectSingle: <Item>(props: SelectSingleProps<Item>) => import("react/jsx-runtime").JSX.Element;
export declare const SelectMultiple: <Item>(props: SelectMultipleProps<Item>) => import("react/jsx-runtime").JSX.Element;
export declare const ComboboxElement: <Item>(props: ComboboxProps<Item>) => import("react/jsx-runtime").JSX.Element;
export declare const ComboboxSelect: <Item>(props: SelectProps<Item>) => import("react/jsx-runtime").JSX.Element;
export declare const Combobox: (<Item>(props: ComboboxProps<Item>) => import("react/jsx-runtime").JSX.Element) & {
    Select: <Item>(props: SelectProps<Item>) => import("react/jsx-runtime").JSX.Element;
    SearchField: <Item>(props: Omit<import('..').TextFieldProps, "disabled" | "readOnly" | "showCounter"> & Pick<import('..').LabelProps, "required" | "moreInfo" | "openMoreInfo"> & LayoutUtilProps & {
        maxRows?: number;
        selectedItemProps?: ((item: Item) => Partial<import('..').ChipProps>) | undefined;
    } & {
        disabled?: boolean;
        readOnly?: boolean;
    }) => import("react/jsx-runtime").JSX.Element;
    SelectTrigger: <Item>(props: Omit<import('..').TextFieldProps, "disabled" | "readOnly" | "showCounter"> & Pick<import('..').LabelProps, "required" | "moreInfo" | "openMoreInfo"> & LayoutUtilProps & {
        maxRows?: number;
        selectedItemProps?: ((item: Item) => Partial<import('..').ChipProps>) | undefined;
    } & {
        disabled?: boolean;
        readOnly?: boolean;
    }) => import("react/jsx-runtime").JSX.Element;
    Content: <Item = any>({ children, className, disablePopover, ...rest }: import('./ComboboxContent').ComboboxContentProps<Item>) => import("react/jsx-runtime").JSX.Element;
    List: <Item = any>({ children, className, ...rest }: import('./ComboboxList').ComboboxListProps) => import("react/jsx-runtime").JSX.Element;
    Item: <Item = any>(props: import('./ComboboxItem').ComboboxItemProps<Item>) => import("react/jsx-runtime").JSX.Element;
    ItemAddNew: <Item = any>(props: import('./ComboboxItem').ComboboxItemAddNewProps<Item>) => import("react/jsx-runtime").JSX.Element;
    Empty: <Item = any>({ children, }: import('./ComboboxEmpty').ComboboxEmptyProps) => import("react/jsx-runtime").JSX.Element;
};
export {};