import { UIEvent } from 'react';
import { UseMultipleSelectionProps as UseDownshiftMultipleSelectionProps } from 'downshift';
import { ComboboxProps } from './Combobox';
/**
 * Props for the useInfiniteCombobox hook
 */
export type UseInfiniteComboboxProps<Item> = {
    /** Function to fetch items for the current page */
    query: (params: {
        page: number;
        inputValue: string;
        selectedItem: Item | null;
        selectedItems: Item[];
    }) => Promise<Item[]>;
    /** Initial page number to start from */
    initialPage?: number;
    /** Initial loading state */
    initialLoading?: boolean;
    /** Initial input value */
    initialInputValue?: ComboboxProps["initialInputValue"];
    /** Default input value */
    defaultInputValue?: ComboboxProps["defaultInputValue"];
    /** Initial selected item */
    initialSelectedItem?: ComboboxProps<Item>["initialSelectedItem"];
    /** Default selected item */
    defaultSelectedItem?: ComboboxProps<Item>["defaultSelectedItem"];
    /** Initial selected items for multiple selection */
    initialSelectedItems?: UseDownshiftMultipleSelectionProps<Item>["initialSelectedItems"];
    /** Default selected items for multiple selection */
    defaultSelectedItems?: UseDownshiftMultipleSelectionProps<Item>["defaultSelectedItems"];
    /** Whether to trigger query on input value change */
    updateOnInputValueChange?: boolean;
    /** Whether to trigger query on selected item change */
    updateOnSelectedItemChange?: boolean;
    /** Whether to trigger query on selected items change */
    updateOnSelectedItemsChange?: boolean;
    /** Whether to trigger query on first render */
    queryOnFirstRender?: boolean;
    /** Custom function to determine when to trigger query */
    shouldTriggerQuery?: (element: EventTarget & HTMLElement) => boolean;
} & ({
    queryInitialItems?: never;
    /** Initial items array (mutually exclusive with queryInitialItems) */
    initialItems?: Item[];
} | {
    /** Function to get initial items (mutually exclusive with initialItems) */
    queryInitialItems?: () => Item[];
    initialItems?: never;
});
/**
 * Hook for implementing infinite scroll functionality in combobox components.
 *
 * Features:
 * - Automatic pagination with scroll-based loading
 * - Configurable query triggers (input change, selection change, scroll)
 * - Debounced query execution to prevent excessive API calls
 * - Automatic retry logic with exponential backoff
 * - Support for both single and multiple selection modes
 * - Customizable scroll threshold for triggering new queries
 * - Loading state management with deferred updates
 * - Automatic detection of pagination end
 * - Support for initial items or query-based initialization
 *
 * @param options Configuration options for the infinite combobox
 * @returns Object containing comboboxProps and contentProps for use with Combobox component
 *
 * @example
 * const { comboboxProps, contentProps } = useInfiniteCombobox({
 *   initialItems: [],
 *   initialPage: 0,
 *   initialLoading: true,
 *   query: async ({ page, inputValue, selectedItems }) => {
 *     return await fetchItems({
 *       page,
 *       pageSize: 25,
 *       searchTerm: inputValue,
 *       excludeIds: selectedItems.map(item => item.id),
 *     });
 *   },
 * });
 *
 * return (
 *   <Combobox {...comboboxProps}>
 *     <Combobox.SearchField label="Search items" />
 *     <Combobox.Content {...contentProps}>
 *       {({ 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>
 * );
 */
export declare function useInfiniteCombobox<Item = any>({ query, queryInitialItems, initialItems, initialPage, initialLoading, initialInputValue, defaultInputValue, initialSelectedItem, defaultSelectedItem, initialSelectedItems, defaultSelectedItems, updateOnInputValueChange, updateOnSelectedItemChange, updateOnSelectedItemsChange, queryOnFirstRender, shouldTriggerQuery: shouldTriggerQueryProp, }: UseInfiniteComboboxProps<Item>): {
    comboboxProps: {
        items: Item[];
        loading: boolean;
        initialInputValue: string | undefined;
        defaultInputValue: string | undefined;
        initialSelectedItem: Item | null | undefined;
        defaultSelectedItem: Item | null | undefined;
        initialSelectedItems: Item[] | undefined;
        defaultSelectedItems: Item[] | undefined;
        disableFilter: boolean;
        onStateChange: (changes: Parameters<NonNullable<ComboboxProps["onStateChange"]>>[0]) => void;
    };
    contentProps: {
        onScroll: (e: UIEvent<HTMLElement>) => void;
        scrollerRef: import('react').RefObject<HTMLDivElement>;
    };
};