import { type BasedAdditionalProps, type SelectBoxOption } from '../SelectBox.types';
/**
 * Custom hook to handle search functionality within a SelectBox component.
 *
 * @param options - Array of SelectBox options (can include nested group options).
 *
 * @param enableSearchOptions - Indicates if the SelectBox component is searchable.
 *
 * @param onSearchOptions - Handler executed when the search text changes. When
 * provided, client-side filtering is disabled as it's assumed that the caller
 * will handle the filtering.
 *
 * @returns Object containing the filtered options, search text, and handler to update search text.
 */
export declare const useSearchBox: <T extends string | number | undefined = string, AdditionalProps extends BasedAdditionalProps = BasedAdditionalProps>(options: (SelectBoxOption<T, AdditionalProps> | null | undefined)[], enableSearchOptions: boolean, onSearchOptions?: (text: string) => void) => {
    /**
     * Handler for search input change events.
     */
    onSearchTextChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
    /**
     * Filtered options based on search text (client-side filtering only when onSearchOptions is not provided).
     */
    filteredOptions: (SelectBoxOption<T, AdditionalProps> | null | undefined)[];
    /**
     * Current search text value.
     */
    searchText: string;
};