UI Library

Prop Type Default Value Notes
align'left' | 'right''left'
Panel edge anchored to the field.
ariaLabelstring?—
Accessible name for the combobox.
autoPlacebooleantrue
Flips the panel when crowded.
clearLabelstring?'Clear'
Accessible name for the clear button.
clearPlacement'auto' | 'inside' | 'outside''auto'
Inside overlays the field edge; outside sits after it; auto stays inside (no trailing adornment).
clearablebooleanfalse
Appends a cross button that clears the value.
defaultValuestring?''
Baseline the clear button compares against; the cross hides while the value matches it.
disabledbooleanfalse
Disables the field; the panel never opens.
hideOutlinebooleanfalse
Drops the bordered field’s border and focus border while keeping its surface, padding, and text metrics.
options(string | { value: string; label?: string })[]—
Suggestion options; a bare string (or a missing label) displays as its own value. The eye resets to the default options.
panelClassstring?built-in
Replaces the floating panel classes.
placeholderstring?—
Native placeholder.
ratiosAutoCompleteRatioOverrides?—
Partial override of the field and panel ratios; the panel line follows the font.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Field scale; numbers are icon-scale pixels interpolated between the steps.
valuestring—
Bindable input text; free-typed text persists; the eye resets to the default text.
variant'bordered' | 'embedded''bordered'
Chrome variant; embedded drops the border, the background, and the focus ring for a field rendered inside another surface.
inputRefHTMLInputElement | nullnull—Bindable native input element.
onClear() => voidclears value—Clear handler; falls back to clearing the bound value when omitted.
onSelect(value: string) => void——Called with the chosen option's value when an option is picked.