import { default as React } from 'react';

export interface InputSelectOption {
    value: string;
    label: string;
    /**
     * Secondary caption rendered under the label in the dropdown row, for a qualifier the label
     * shouldn't absorb (e.g. the achievement band a grade falls into). The trigger still shows the
     * `label` alone — pass `helperText` if the qualifier should persist after the dropdown closes.
     */
    description?: string;
}
export type InputSelectSize = 'sm' | 'md';
export type InputSelectDropdownPosition = 'auto' | 'up' | 'down';
export interface InputSelectProps {
    options: InputSelectOption[];
    value?: string;
    onChange?: (value: string) => void;
    placeholder?: string;
    /** Optional left icon (e.g. GlobeIcon) */
    icon?: React.ReactNode;
    disabled?: boolean;
    className?: string;
    'aria-label'?: string;
    error?: string;
    /**
     * Guidance shown below the trigger in secondary text. Independent of `error`, which is styled as
     * a validation failure and announced via `role="alert"`; when both are set the error replaces it.
     */
    helperText?: string;
    /** Set to `false` for an intrinsic-width trigger instead of stretching to fill its container. Defaults to `true`. */
    fullWidth?: boolean;
    /** `sm` is a compact trigger (32px height); `md` is the default (48px height). */
    size?: InputSelectSize;
    /**
     * `'auto'` measures space against `window.innerHeight` and flips up when the trigger is
     * close to the bottom of the viewport. Use `'up'`/`'down'` to force a direction when the
     * trigger sits inside a clipped or scrollable container (e.g. a Drawer) that auto-detection
     * can't see. Defaults to `'auto'`.
     */
    dropdownPosition?: InputSelectDropdownPosition;
}
export declare function InputSelect({ options, value, onChange, placeholder, icon, disabled, className, 'aria-label': ariaLabel, error, helperText, fullWidth, size, dropdownPosition, }: InputSelectProps): import("react/jsx-runtime").JSX.Element;
//# sourceMappingURL=InputSelect.d.ts.map