super-select-react 0.9.0

package/dist/super-select-react.d.ts

@@ -0,0 +1,1429 @@
+import { default as default_2 } from 'react';
+import { JSX } from 'react';
+
+declare type AnyHTMLElement = any;
+
+/**
+ * The default button used to close a modal.
+ */
+export declare function CloseButton({ className, style, disabled, tabIndex, title, onClick, customization }: CloseButtonProps): default_2.JSX.Element;
+
+/**
+ * Props for a `CloseButton` component.
+ */
+export declare interface CloseButtonProps extends Pick<default_2.ButtonHTMLAttributes<HTMLButtonElement>, "className" | "style" | "disabled" | "tabIndex" | "title"> {
+    /**
+     * Called when the button is clicked.
+     */
+    onClick?: () => void;
+    /**
+     * Customization options for the button.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        content?: default_2.ReactNode;
+    };
+}
+
+/**
+ * Converts an error-like value into an OptionSourceError or other supported error type (like an AbortError).
+ * This may just return the original error if it is already an OptionSourceError or similar error.
+ */
+export declare function convertToOptionSourceError(error?: unknown): OptionSourceErrorLike & Error;
+
+/**
+ * Creates an option source from a fetcher, configuration object, or existing option source.
+ */
+export declare function createOptionSource<TData = unknown>(init: OptionSourceLike<TData> | OptionSourceInit<TData> | OptionSourceFetcher<TData>): OptionSourceLike<TData>;
+
+/**
+ * The default indicator shown when an option list is empty.
+ */
+export declare function EmptyIndicator({ className, style, onRetry, customization }: EmptyIndicatorProps): default_2.JSX.Element;
+
+/**
+ * Props for an `EmptyIndicator` component.
+ */
+export declare interface EmptyIndicatorProps {
+    /**
+     * A class name applied to the indicator.
+     */
+    className?: string;
+    /**
+     * Inline styles applied to the indicator.
+     */
+    style?: default_2.CSSProperties;
+    /**
+     * Called when the retry button is clicked.
+     */
+    onRetry?: () => void;
+    /**
+     * Customization options for the indicator.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        content?: default_2.ReactNode;
+        retryButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+    };
+}
+
+/**
+ * The default error indicator.
+ */
+export declare function ErrorIndicator({ className, style, message, inline, onRetry, customization }: ErrorIndicatorProps): default_2.JSX.Element;
+
+/**
+ * Props for an error indicator component.
+ */
+export declare interface ErrorIndicatorProps {
+    className?: string;
+    style?: default_2.CSSProperties;
+    error?: OptionSourceErrorLike;
+    message?: default_2.ReactNode;
+    inline?: boolean;
+    onRetry?: () => void;
+    customization?: {
+        classNamePrefix?: string;
+        icon?: default_2.ReactNode;
+        retryButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+    };
+}
+
+/**
+ * The default fallback container shown while the real SuperSelect component is loading.
+ */
+export declare function Fallback({ "aria-busy": ariaBusy, "aria-describedby": ariaDescribedBy, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, accessKey, children, className, dir, hidden, id, lang, style, tabIndex, title, customization, }: FallbackProps): default_2.JSX.Element;
+
+/**
+ * Props for a fallback component shown before a display mode can render.
+ */
+export declare interface FallbackProps {
+    "aria-busy"?: boolean;
+    "aria-describedby"?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    accessKey?: string;
+    children?: default_2.ReactNode;
+    className?: string;
+    dir?: string;
+    hidden?: boolean;
+    id?: string;
+    lang?: string;
+    style?: default_2.CSSProperties;
+    tabIndex?: number;
+    title?: string;
+    customization?: {
+        classNamePrefix?: string;
+    };
+}
+
+/**
+ * A subset of `HTMLOptionElement` used in select-compatible event targets.
+ */
+export declare interface HTMLOptionElementSubset extends Partial<HTMLOptionElement> {
+    /**
+     * The value to be submitted with the form, should this option be selected.
+     */
+    value: string;
+    /**
+     * A label for the option.
+     */
+    label: string;
+    /**
+     * Indicates whether the option is currently selected.
+     */
+    selected: boolean;
+    /**
+     * Indicates whether the option is unavailable to be selected.
+     */
+    disabled: boolean;
+}
+
+/**
+ * A collection of `<option>` HTML elements.
+ */
+export declare interface HTMLOptionsCollectionSubset {
+    /**
+     * The number of options in the collection.
+     */
+    length: number;
+    /**
+     * The index number of the first selected <option> element. The value -1 indicates no element is selected.
+     */
+    selectedIndex?: number;
+    /**
+     * Returns the specific element at the given zero-based index into the list. Returns null if the index is out of range.
+     */
+    item(index: number): HTMLOptionElementSubset | null;
+    /**
+     * Returns the specific node whose ID or name matches the specified string.
+     * Returns null if no node exists by the given name or if this method is not supported.
+     */
+    namedItem(name: string): HTMLOptionElementSubset | null;
+    [index: number]: HTMLOptionElementSubset | undefined;
+    [Symbol.iterator](): IterableIterator<HTMLOptionElementSubset>;
+}
+
+/**
+ * A subset of `HTMLSelectElement` used as the target of select-compatible events.
+ */
+export declare interface HTMLSelectElementSubset extends Omit<Partial<HTMLSelectElement>, "value" | "selectedOptions"> {
+    /**
+     * The value of the first selected `<option>` element associated with this `<select>` element.
+     */
+    value: string;
+    /**
+     * A list of the `<option>` elements contained within the `<select>` element that are currently selected.
+     */
+    selectedOptions: HTMLOptionsCollectionSubset;
+}
+
+/**
+ * Returns true if the given value has the properties of an OptionSourceErrorLike object, false otherwise.
+ */
+export declare function isOptionSourceErrorLike(error: unknown): error is OptionSourceErrorLike;
+
+/**
+ * The default modal dialog that is shown when the select button is clicked.
+ */
+export declare function Modal({ customization, headerContent, footerContent, children, open, className, ref, ...dialogProps }: ModalProps): default_2.JSX.Element;
+
+/**
+ * Props for a `Modal` component.
+ */
+export declare interface ModalProps<TElement extends HTMLElement = HTMLDialogElement> extends Pick<default_2.ComponentProps<"dialog">, "open" | "children" | "className" | "style" | "dir" | "lang" | "aria-label" | "aria-labelledby" | "aria-busy"> {
+    /**
+     * Content displayed in the modal header before the close button.
+     */
+    headerContent?: default_2.ReactNode;
+    /**
+     * Content displayed in the modal footer.
+     */
+    footerContent?: default_2.ReactNode;
+    /**
+     * Called when the modal is closed.
+     */
+    onClose?: () => void;
+    /**
+     * Called when the modal is canceled, such as by pressing Escape or clicking outside the dialog.
+     */
+    onCancel?: () => void;
+    /**
+     * Called when the modal is clicked.
+     */
+    onClick?: default_2.MouseEventHandler<TElement>;
+    /**
+     * A ref to the underlying `<dialog>` equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Customization options for the modal.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        dialog?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        content?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        header?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        body?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        footer?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        closeButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            component?: default_2.ComponentType<CloseButtonProps>;
+            content?: default_2.ReactNode;
+        };
+    };
+}
+
+/**
+ * A select-compatible component that displays its options in a modal dialog.
+ */
+export declare function ModalSelect<Multiple extends boolean = false>({ optionSource, children, customization, ref, multiple, disabled, required, value, defaultValue, name, id, form, autoFocus, autoComplete, onInput, onInvalid, onChange, onValueChange, className, style, ...nativeSelectProps }: ModalSelectProps<Multiple>): default_2.JSX.Element;
+
+/**
+ * The default trigger button for a modal select.
+ */
+export declare function ModalSelectButton({ ref, customization, children, className, ...buttonProps }: ModalSelectButtonProps<AnyHTMLElement>): default_2.JSX.Element;
+
+/**
+ * Props for a `ModalSelectButton` component.
+ */
+export declare interface ModalSelectButtonProps<TElement extends HTMLElement = HTMLButtonElement> extends Omit<default_2.HTMLAttributes<TElement>, "children"> {
+    /**
+     * Whether the button is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * The content displayed by the button.
+     */
+    children?: default_2.ReactNode;
+    /**
+     * A ref to the underlying button equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Customization options for the button.
+     */
+    customization?: {
+        classNamePrefix?: string;
+    };
+}
+
+/**
+ * Props for a `ModalSelect` component.
+ */
+export declare interface ModalSelectProps<Multiple extends boolean = boolean> extends SelectProps {
+    /**
+     * Whether more than one option can be selected.
+     */
+    multiple?: Multiple;
+    /**
+     * A source that loads options and supports searching, pagination, and selected-value resolution.
+     */
+    optionSource?: OptionSourceLike;
+    /**
+     * Called with the selected value whenever the selection changes.
+     * Receives a string for a single select and a string array for a multiple select.
+     */
+    onValueChange?: (value: SelectChangeValue<Multiple>) => void;
+    /**
+     * Customization options for the select.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        searchMatcher?: (option: Option_2, search: string) => boolean;
+        modalSelectButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            component?: default_2.ComponentType<ModalSelectButtonProps<AnyHTMLElement>>;
+            selectedContent?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                placeholder?: string;
+                component?: default_2.ComponentType<SelectedContentProps>;
+            };
+        };
+        modal?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            component?: default_2.ComponentType<ModalProps>;
+            dialog?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            content?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            header?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            body?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            footer?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            okButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+                component?: default_2.ComponentType<OkButtonProps>;
+            };
+            closeButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                component?: default_2.ComponentType<CloseButtonProps>;
+                content?: default_2.ReactNode;
+            };
+        };
+        optionListInput?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            component?: default_2.ComponentType<OptionListInputProps<AnyHTMLElement, AnyHTMLElement>>;
+            optionItem?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            groupHeader?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+        };
+        searchInput?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            placeholder?: string;
+            title?: string;
+            component?: default_2.ComponentType<SearchInputProps>;
+        };
+        errorIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            icon?: default_2.ReactNode;
+            defaultMessage?: default_2.ReactNode;
+            retryButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<ErrorIndicatorProps>;
+        };
+        pendingIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+            component?: default_2.ComponentType<PendingIndicatorProps>;
+        };
+        emptyIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            content?: default_2.ReactNode;
+            retryButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<EmptyIndicatorProps>;
+        };
+        maxAdditionalPages?: number;
+        moreIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            loadMoreButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            overflowIndicator?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<MoreIndicatorProps>;
+        };
+    };
+}
+
+/**
+ * The default indicator shown when an option list has more options.
+ */
+export declare function MoreIndicator({ className, style, disabled, onLoadMore, customization }: MoreIndicatorProps): default_2.JSX.Element;
+
+/**
+ * Props for a `MoreIndicator` component.
+ */
+export declare interface MoreIndicatorProps {
+    /**
+     * Called when the load-more button is clicked.
+     */
+    onLoadMore?: () => void;
+    /**
+     * A class name applied to the indicator.
+     */
+    className?: string;
+    /**
+     * Inline styles applied to the indicator.
+     */
+    style?: default_2.CSSProperties;
+    /**
+     * Whether the load-more button is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Customization options for the indicator.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        loadMoreButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+        overflowIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+    };
+}
+
+/**
+ * The default button used to confirm a multiple selection.
+ */
+export declare function OkButton({ className, style, disabled, title, onClick, customization }: OkButtonProps): default_2.JSX.Element;
+
+/**
+ * Props for an `OkButton` component.
+ */
+export declare interface OkButtonProps extends Pick<default_2.ButtonHTMLAttributes<HTMLButtonElement>, "className" | "style" | "disabled" | "title"> {
+    /**
+     * Called when the button is clicked.
+     */
+    onClick?: () => void;
+    /**
+     * Customization options for the button.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        content?: default_2.ReactNode;
+    };
+}
+
+/**
+ * A group of options.
+ */
+export declare interface Optgroup<TData = unknown> {
+    /**
+     * Human-readable text shown to users to describe the group.
+     */
+    label: string;
+    /**
+     * Options that are part of this group.
+     */
+    options: Option_2<TData>[];
+}
+
+/**
+ * An option in a Select input, radio button, or checkbox.
+ */
+declare interface Option_2<TData = unknown> {
+    /**
+     * An internal value that would be submitted with a form when this option is selected.
+     */
+    value: string;
+    /**
+     * Human-readable text shown to users to describe the option.
+     */
+    label: string;
+    /**
+     * An alternative rich content version of the label shown when Super Select renders the option.
+     */
+    children?: default_2.ReactNode;
+    /**
+     * When grouping options, a human-readable label of the group this option belongs to.
+     * This can be used to group related options together into Optgroups.
+     */
+    groupLabel?: string;
+    /**
+     * If true, this option is not selectable and is typically displayed in a greyed-out style.
+     */
+    disabled?: boolean;
+    /**
+     * If true, this option will not be rendered in the list of options.
+     */
+    hidden?: boolean;
+    /**
+     * Any additional data associated with this option.
+     * This won't be used directly by this library, but will be preserved on options passed to things like an option source or customization components.
+     */
+    data?: TData;
+}
+export { Option_2 as Option }
+
+/**
+ * The default container for an option list select.
+ */
+export declare function OptionList({ searchInput, optionList, className, customization, ref, children, ...divProps }: OptionListProps): default_2.JSX.Element;
+
+/**
+ * The default radio or checkbox list used by an option list select.
+ */
+export declare function OptionListInput({ autoComplete, autoFocus, className, disabled, form, id, multiple, name, required, style, tabIndex, title, options, value, onValueChange, onOptionClick, onOptionKeyDown, indicator, customization, ref, ...fieldsetProps }: OptionListInputProps<HTMLFieldSetElement>): default_2.JSX.Element;
+
+/**
+ * Props for an `OptionListInput` component.
+ */
+export declare interface OptionListInputProps<TElement extends HTMLElement = HTMLFieldSetElement, TOptionElement extends HTMLInputElement | HTMLOptionElement | HTMLOptionElementSubset = HTMLInputElement> extends Omit<SelectProps, "children" | "ref" | "value" | "defaultValue" | "onChange" | "onInput" | keyof default_2.DOMAttributes<HTMLSelectElementSubset>>, Omit<default_2.DOMAttributes<TElement>, "onChange" | "onInput"> {
+    /**
+     * The options displayed in the list.
+     */
+    options: Option_2[];
+    /**
+     * The selected option values.
+     */
+    value: string[];
+    /**
+     * Called with the selected values when the selection changes.
+     */
+    onValueChange: (nextValues: string[]) => void;
+    /**
+     * Called when an option input is clicked.
+     */
+    onOptionClick?: default_2.MouseEventHandler<TOptionElement>;
+    /**
+     * Called when a key is pressed on an option input.
+     */
+    onOptionKeyDown?: default_2.KeyboardEventHandler<TOptionElement>;
+    /**
+     * Content displayed after the options.
+     */
+    indicator?: default_2.ReactNode;
+    /**
+     * A ref to the underlying option list equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Customization options for the option list input.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        optionItem?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        groupHeader?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+    };
+}
+
+/**
+ * Props for an `OptionList` component.
+ */
+export declare interface OptionListProps<TElement extends HTMLElement = HTMLDivElement> extends Pick<default_2.ComponentProps<"div">, "id" | "className" | "style" | "title" | "tabIndex" | "dir" | "lang" | "aria-label" | "aria-busy"> {
+    /**
+     * The search input displayed before the options.
+     */
+    searchInput?: default_2.ReactNode;
+    /**
+     * The option list input.
+     */
+    optionList?: default_2.ReactNode;
+    /**
+     * Additional content displayed after the option list.
+     */
+    children?: default_2.ReactNode;
+    /**
+     * A ref to the underlying container equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Customization options for the option list.
+     */
+    customization?: {
+        classNamePrefix?: string;
+    };
+}
+
+/**
+ * A select-compatible component that displays its options inline.
+ */
+export declare function OptionListSelect<Multiple extends boolean = false>({ optionSource, children, customization, ref, onBlur, onFocus, onClick, onMouseDown, onMouseUp, onPointerDown, onPointerUp, onContextMenu, onKeyDown, onKeyUp, onBeforeInput, onSelect, onCompositionStart, onCompositionUpdate, onCompositionEnd, onChange, onInput, onInvalid, onValueChange, className, style, ...selectProps }: OptionListSelectProps<Multiple>): default_2.JSX.Element;
+
+/**
+ * Props for an `OptionListSelect` component.
+ */
+export declare interface OptionListSelectProps<Multiple extends boolean = boolean> extends SelectProps {
+    /**
+     * Whether more than one option can be selected.
+     */
+    multiple?: Multiple;
+    /**
+     * A source that loads options and supports searching, pagination, and selected-value resolution.
+     */
+    optionSource?: OptionSourceLike;
+    /**
+     * Called with the selected value whenever the selection changes.
+     * Receives a string for a single select and a string array for a multiple select.
+     */
+    onValueChange?: (value: SelectChangeValue<Multiple>) => void;
+    /**
+     * Customization options for the select.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        searchMatcher?: (option: Option_2, search: string) => boolean;
+        optionListInput?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            component?: default_2.ComponentType<OptionListInputProps<AnyHTMLElement, AnyHTMLElement>>;
+            optionItem?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+            groupHeader?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+            };
+        };
+        optionList?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            component?: default_2.ComponentType<OptionListProps<AnyHTMLElement>>;
+        };
+        errorIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            defaultMessage?: default_2.ReactNode;
+            icon?: default_2.ReactNode;
+            retryButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<ErrorIndicatorProps>;
+        };
+        pendingIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+            component?: default_2.ComponentType<PendingIndicatorProps>;
+        };
+        emptyIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            content?: default_2.ReactNode;
+            retryButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<EmptyIndicatorProps>;
+        };
+        maxAdditionalPages?: number;
+        moreIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            loadMoreButton?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            overflowIndicator?: {
+                className?: string;
+                style?: default_2.CSSProperties;
+                title?: string;
+                content?: default_2.ReactNode;
+            };
+            component?: default_2.ComponentType<MoreIndicatorProps>;
+        };
+        searchInput?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            placeholder?: string;
+            title?: string;
+            component?: default_2.ComponentType<SearchInputProps>;
+        };
+    };
+}
+
+/**
+ * A source of asynchronously fetched options.
+ */
+export declare class OptionSource<TData = unknown> implements OptionSourceLike<TData> {
+    private readonly innerFetcher;
+    private readonly fetcher;
+    private readonly cache?;
+    /**
+     * Constructs a new OptionSource from a config object.
+     */
+    constructor(init: OptionSourceInit<TData>);
+    /**
+     * Gets a page of options for the specified query.
+     */
+    getOptionPage(query?: OptionSourcePageQuery<TData>): Promise<OptionSourceResult<TData>>;
+    private createFetchNextPage;
+    /**
+     * Resolves options for the specified values.
+     */
+    resolveValues(values: readonly string[], signal?: AbortSignal): Promise<Option_2<TData>[]>;
+    /**
+     * Returns all currently cached options.
+     */
+    getCachedOptions(): Option_2<TData>[] | undefined;
+    /**
+     * Clears all cached options.
+     */
+    clearCache(): void;
+    /**
+     * Returns an equivalent option source that does not use caching.
+     */
+    withNoCache(): OptionSource<TData>;
+}
+
+/**
+ * An error thrown when an option source request fails.
+ */
+export declare class OptionSourceError extends Error implements OptionSourceErrorLike {
+    /**
+     * A message that can be shown to end users.
+     */
+    readonly userMessage?: string;
+    /**
+     * The type of error that occurred.
+     */
+    readonly code?: OptionSourceErrorCode;
+    /**
+     * An HTTP status code associated with the error.
+     */
+    readonly httpStatus?: number;
+    /**
+     * Constructs an option source error.
+     */
+    constructor(message: string, init?: Omit<OptionSourceErrorLike, "message">);
+}
+
+/**
+ * A code that indicates the type of error that occurred when fetching options from an OptionSource.
+ */
+export declare type OptionSourceErrorCode = "network" | "timeout" | "unauthorized" | "forbidden" | "not-found" | "rate-limited" | "server";
+
+/**
+ * The properties describing an option source error.
+ */
+export declare interface OptionSourceErrorLike {
+    /**
+     * The internal message that describes the error.
+     * This should not be shown to end users, but can be used for debugging or logging purposes.
+     */
+    message?: string;
+    /**
+     * A message that describes the error in a way that can be shown to an end-user.
+     */
+    userMessage?: string;
+    /**
+     * Indicates the type of error that occurred, if applicable.
+     */
+    code?: OptionSourceErrorCode;
+    /**
+     * An HTTP status code associated with the error, if applicable.
+     */
+    httpStatus?: number;
+    /**
+     * The original error or value that caused this error to be thrown, if available.
+     */
+    cause?: unknown;
+}
+
+/**
+ * A function that asynchronously fetches options based on a request.
+ */
+export declare type OptionSourceFetcher<TData = unknown> = (request: OptionSourceFetchRequest<TData>) => Promise<OptionSourceFetchResponse<TData>>;
+
+/**
+ * A request to fetch options.
+ */
+export declare interface OptionSourceFetchRequest<TData = unknown> {
+    /**
+     * The values of the options to fetch.
+     * This is used to resolve the labels of options when only their values are known.
+     */
+    values?: readonly string[];
+    /**
+     * A free-text search query for filtering options.
+     */
+    search?: string;
+    /**
+     * The requested maximum number of options to return in the response.
+     */
+    limit?: number;
+    /**
+     * For offset-based pagination: the number of options to skip before starting to collect the result set.
+     * This is only used for a subsequent request if the initial request returned a response with a "hasMore" value of true.
+     */
+    offset?: number;
+    /**
+     * For cursor-based pagination: the last option from the previous page of results.
+     * This is only used for a subsequent request if the initial request returned a response with a "hasMore" value of true.
+     */
+    after?: Option_2<TData>;
+    /**
+     * A signal that can be used to indicate that the request is no longer needed.
+     * For example, if a search query has been superseded by a new query as the user typed more characters.
+     */
+    signal?: AbortSignal;
+}
+
+/**
+ * The response from fetching options.
+ */
+export declare interface OptionSourceFetchResponse<TData = unknown> {
+    /**
+     * The options matching the request query.
+     */
+    options: Option_2<TData>[];
+    /**
+     * True if there are more options matching the request query that were not included in this response.
+     * If true, a subsequent request could be made to fetch the next page of results using offset-based or cursor-based pagination.
+     */
+    hasMore?: boolean;
+}
+
+/**
+ * Parameters for constructing an OptionSource.
+ */
+export declare interface OptionSourceInit<TData = unknown> {
+    /**
+     * The function used to asynchronously fetch options.
+     */
+    fetch: OptionSourceFetcher<TData>;
+    /**
+     * If true, this will not use or populate a cache of options.
+     * This is most useful if your fetch function has its own cache system or if the fetch is fast and efficient enough that caching is not needed.
+     */
+    noCache?: boolean;
+}
+
+/**
+ * Fetches options asynchronously from some source, such as an API or local storage.
+ */
+export declare interface OptionSourceLike<TData = unknown> {
+    /**
+     * Gets a page of options based on the specified query.
+     */
+    getOptionPage: (query?: OptionSourcePageQuery<TData>) => Promise<OptionSourceResult<TData>>;
+    /**
+     * Resolves options for the specified values.
+     */
+    resolveValues: (values: readonly string[], signal?: AbortSignal) => Promise<Option_2<TData>[]>;
+    /**
+     * If the source supports caching, returns all of the cached options.
+     */
+    getCachedOptions?: () => Option_2<TData>[] | undefined;
+    /**
+     * If the source supports caching, clears any cached options.
+     */
+    clearCache?: () => void;
+    /**
+     * Returns a copy of this source that does not use caching.
+     * If the original source does not use caching, this may simply return itself.
+     */
+    withNoCache?: () => OptionSourceLike<TData>;
+}
+
+/**
+ * A query for fetching a page of options.
+ */
+export declare interface OptionSourcePageQuery<TData = unknown> {
+    /**
+     * A free-text search query for filtering options.
+     */
+    search?: string;
+    /**
+     * The requested maximum number of options to return in the response.
+     */
+    limit?: number;
+    /**
+     * For offset-based pagination: the number of options to skip before starting to collect the result set.
+     * This is only used for a subsequent request if the initial request returned a response with a "hasMore" value of true.
+     */
+    offset?: number;
+    /**
+     * For cursor-based pagination: the last option from the previous page of results.
+     * This is only used for a subsequent request if the initial request returned a response with a "hasMore" value of true.
+     */
+    after?: Option_2<TData>;
+    /**
+     * A signal that can be used to indicate that the request is no longer needed.
+     */
+    signal?: AbortSignal;
+}
+
+/**
+ * A page of options.
+ */
+export declare interface OptionSourceResult<TData = unknown> {
+    /**
+     * The options.
+     */
+    options: Option_2<TData>[];
+    /**
+     * True if there are more options for the query that were not included in this page,
+     * false if there are no more options,
+     * or undefined if we don't know whether there are more options.
+     */
+    hasMore?: boolean;
+    /**
+     * Fetches the next page of options for the same query.
+     */
+    nextPage?: (options?: {
+        limit?: number;
+        signal?: AbortSignal;
+    }) => Promise<OptionSourceResult<TData>>;
+}
+
+/**
+ * The default pending indicator component shown while something is loading.
+ */
+export declare function PendingIndicator({ className, style, title, inline, content, customization }: PendingIndicatorProps): default_2.JSX.Element;
+
+/**
+ * Props for a pending indicator.
+ */
+export declare interface PendingIndicatorProps {
+    className?: string;
+    style?: default_2.CSSProperties;
+    title?: string;
+    inline?: boolean;
+    content?: default_2.ReactNode;
+    customization?: {
+        classNamePrefix?: string;
+    };
+}
+
+/**
+ * The default search input for an option list.
+ */
+export declare function SearchInput({ className, style, search, onSearchChange, isSearching, disabled, ref, onKeyDown, customization, }: SearchInputProps): default_2.JSX.Element;
+
+/**
+ * Props for a `SearchInput` component.
+ */
+export declare interface SearchInputProps<TElement extends HTMLElement = HTMLInputElement> {
+    /**
+     * The current search text.
+     */
+    search: string | undefined;
+    /**
+     * Called when the search text changes.
+     */
+    onSearchChange: (search: string | undefined) => void;
+    /**
+     * Whether options are being loaded for the current search.
+     */
+    isSearching?: boolean;
+    /**
+     * A class name applied to the search input container.
+     */
+    className?: string;
+    /**
+     * Inline styles applied to the search input container.
+     */
+    style?: default_2.CSSProperties;
+    /**
+     * Whether the search input is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * A ref to the underlying search input equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Called when a key is pressed in the search input.
+     */
+    onKeyDown?: default_2.KeyboardEventHandler<TElement>;
+    /**
+     * Customization options for the search input.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        placeholder?: string;
+        title?: string;
+        pendingIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+            component?: default_2.ComponentType<PendingIndicatorProps>;
+        };
+    };
+}
+
+/**
+ * The selected value type based on whether multiple selection is enabled.
+ */
+export declare type SelectChangeValue<Multiple extends boolean = boolean> = Multiple extends true ? string[] : string;
+
+/**
+ * Displays the selected options in a modal select button.
+ */
+export declare function SelectedContent({ customization, selectedOptions, className, style }: SelectedContentProps): default_2.JSX.Element;
+
+/**
+ * Props for a `SelectedContent` component.
+ */
+export declare interface SelectedContentProps {
+    /**
+     * The currently selected options.
+     */
+    selectedOptions: Option_2[];
+    /**
+     * A class name applied to the rendered content.
+     */
+    className?: string;
+    /**
+     * Inline styles applied to the rendered content.
+     */
+    style?: default_2.CSSProperties;
+    /**
+     * Customization options for the selected content.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        placeholder?: string;
+    };
+}
+
+/**
+ * Props shared by select-compatible components.
+ * Event targets use `HTMLSelectElementSubset` instead of a full HTML select element.
+ */
+export declare interface SelectProps extends Omit<default_2.SelectHTMLAttributes<HTMLSelectElementSubset>, "onKeyPress"> {
+    /**
+     * Called when the selection changes.
+     */
+    onChange?: default_2.ChangeEventHandler<HTMLSelectElementSubset, HTMLSelectElementSubset>;
+    /**
+     * A ref to the visible control equivalent element.
+     */
+    ref?: default_2.Ref<AnyHTMLElement>;
+}
+
+/**
+ * Renders a select using the configured display mode while preserving the standard select API.
+ */
+export declare function SuperSelect<Multiple extends boolean = false>({ mode, optionSource, customization, ref, children, multiple, disabled, required, value, defaultValue, onChange, onInvalid, onValueChange, className, style, ...selectProps }: SuperSelectProps<Multiple>): default_2.JSX.Element;
+
+/**
+ * Customization options for a `SuperSelect` component.
+ */
+export declare interface SuperSelectCustomization {
+    classNamePrefix?: string;
+    fallback?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<FallbackProps>;
+    };
+    modalSelectButton?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<ModalSelectButtonProps<AnyHTMLElement>>;
+        selectedContent?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            placeholder?: string;
+            component?: default_2.ComponentType<SelectedContentProps>;
+        };
+    };
+    modal?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<ModalProps>;
+        dialog?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        content?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        header?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        body?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        footer?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        okButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+            component?: default_2.ComponentType<OkButtonProps>;
+        };
+        closeButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+            component?: default_2.ComponentType<CloseButtonProps>;
+        };
+    };
+    optionList?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<OptionListProps<AnyHTMLElement>>;
+    };
+    optionListInput?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<OptionListInputProps<AnyHTMLElement, AnyHTMLElement>>;
+        optionItem?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        groupHeader?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+    };
+    searchInput?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        placeholder?: string;
+        component?: default_2.ComponentType<SearchInputProps<AnyHTMLElement>>;
+    };
+    searchMatcher?: (option: Option_2, search: string) => boolean;
+    toggleButtonInput?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<ToggleButtonInputProps<AnyHTMLElement>>;
+        buttonGroup?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        button?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+    };
+    selectInput?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        component?: default_2.ComponentType<default_2.SelectHTMLAttributes<HTMLSelectElement>>;
+    };
+    errorIndicator?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        icon?: default_2.ReactNode;
+        defaultMessage?: default_2.ReactNode;
+        retryButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+        component?: default_2.ComponentType<ErrorIndicatorProps>;
+    };
+    pendingIndicator?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        title?: string;
+        content?: default_2.ReactNode;
+        component?: default_2.ComponentType<PendingIndicatorProps>;
+    };
+    emptyIndicator?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        content?: default_2.ReactNode;
+        retryButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+        component?: default_2.ComponentType<EmptyIndicatorProps>;
+    };
+    maxAdditionalPages?: number;
+    moreIndicator?: {
+        className?: string;
+        style?: default_2.CSSProperties;
+        loadMoreButton?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+        overflowIndicator?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+            title?: string;
+            content?: default_2.ReactNode;
+        };
+        component?: default_2.ComponentType<MoreIndicatorProps>;
+    };
+}
+
+/**
+ * A display mode supported by `SuperSelect`.
+ */
+export declare type SuperSelectMode = "modal" | "native" | "option-list" | "toggle-button";
+
+/**
+ * Information provided to a `SuperSelectModeResolver` when selecting a display mode.
+ */
+export declare interface SuperSelectModeResolutionContext {
+    /**
+     * The options currently available to the select.
+     */
+    options: Option_2[];
+    /**
+     * Whether more than one option can be selected.
+     */
+    multiple: boolean;
+    /**
+     * Whether the select element is disabled.
+     */
+    disabled: boolean;
+    /**
+     * Whether the select element requires a value.
+     */
+    required: boolean;
+    /**
+     * Whether the option source has another page of options.
+     */
+    hasMore: boolean;
+    /**
+     * The error from loading options, if the optionSource reported an error.
+     */
+    error?: OptionSourceErrorLike;
+    /**
+     * The option source used to load options, if any.
+     */
+    optionSource?: OptionSourceLike;
+}
+
+/**
+ * Selects a display mode from the current options and select state.
+ * Returning `undefined` uses the default `"modal"` mode.
+ */
+export declare type SuperSelectModeResolver = (context: SuperSelectModeResolutionContext) => SuperSelectMode | undefined;
+
+/**
+ * Props for a `SuperSelect` component.
+ * Includes the standard select props plus display mode, option source, value callback, and UI customization options.
+ */
+export declare interface SuperSelectProps<Multiple extends boolean = boolean> extends SelectProps {
+    /**
+     * Whether more than one option can be selected.
+     * A literal `true` or `false` also determines the value type passed to `onValueChange`.
+     */
+    multiple?: Multiple;
+    /**
+     * The mode used to display the select, or a function that chooses a mode from the current options and state.
+     * Defaults to `"modal"` when omitted or when a resolver returns `undefined`.
+     */
+    mode?: SuperSelectMode | SuperSelectModeResolver;
+    /**
+     * A source that loads options and supports searching, pagination, and selected-value resolution.
+     * Options provided as children can be used alongside options from the source.
+     */
+    optionSource?: OptionSourceLike;
+    /**
+     * Called with the selected value whenever the selection changes.
+     * Receives a string for a single select and a string array for a multiple select.
+     * This is a convenience callback and does not replace the standard `onChange` event.
+     */
+    onValueChange?: (value: SelectChangeValue<Multiple>) => void;
+    /**
+     * Classes, styles, content, and replacement components used to customize the rendered UI.
+     */
+    customization?: SuperSelectCustomization;
+}
+
+/**
+ * The default radio or checkbox group used by a toggle button select.
+ */
+export declare function ToggleButtonInput({ autoComplete, autoFocus, className, customization, disabled, form, id, multiple, name, onValueToggle: onToggleValue, options, value: selectedValues, required, style, tabIndex, title, ref, ...fieldsetProps }: ToggleButtonInputProps<HTMLFieldSetElement>): default_2.JSX.Element;
+
+/**
+ * Props for a `ToggleButtonInput` component.
+ */
+export declare interface ToggleButtonInputProps<TElement extends HTMLElement = HTMLFieldSetElement> extends Omit<SelectProps, "children" | "ref" | "value" | "defaultValue" | "onChange" | "onInput" | keyof default_2.DOMAttributes<HTMLSelectElementSubset>>, Omit<default_2.DOMAttributes<TElement>, "onChange" | "onInput"> {
+    /**
+     * The options displayed as toggle buttons.
+     */
+    options: Option_2[];
+    /**
+     * The selected option values.
+     */
+    value: string[];
+    /**
+     * Called with an option value when its selection is toggled.
+     */
+    onValueToggle: (selectedValue: string) => void;
+    /**
+     * A ref to the underlying toggle button group equivalent element.
+     */
+    ref?: default_2.Ref<TElement>;
+    /**
+     * Customization options for the toggle button group.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        buttonGroup?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+        button?: {
+            className?: string;
+            style?: default_2.CSSProperties;
+        };
+    };
+}
+
+/**
+ * A select-compatible component that renders radio buttons or checkboxes that look like toggle buttons.
+ */
+export declare function ToggleButtonSelect<Multiple extends boolean = false>({ autoComplete, autoFocus, children, className, customization, defaultValue, disabled, form, id, multiple, name, required, style, tabIndex, title, value, onChange, onInput, onValueChange, onInvalid, ref, ...toggleButtonInputProps }: ToggleButtonSelectProps<Multiple>): JSX.Element;
+
+/**
+ * Props for a `ToggleButtonSelect` component.
+ */
+export declare interface ToggleButtonSelectProps<Multiple extends boolean = boolean> extends SelectProps {
+    /**
+     * Whether more than one option can be selected.
+     */
+    multiple?: Multiple;
+    /**
+     * Called with the selected value whenever the selection changes.
+     * Receives a string for a single select and a string array for a multiple select.
+     */
+    onValueChange?: (value: SelectChangeValue<Multiple>) => void;
+    /**
+     * Customization options for the select.
+     */
+    customization?: {
+        classNamePrefix?: string;
+        component?: React.ComponentType<ToggleButtonInputProps<AnyHTMLElement>>;
+        buttonGroup?: {
+            className?: string;
+            style?: React.CSSProperties;
+        };
+        button?: {
+            className?: string;
+            style?: React.CSSProperties;
+        };
+    };
+}
+
+export { }