UI Library

Prop Type Default Value Notes
activeValuestring?''
Committed option value (not its label); marked in the panel.
align'left' | 'right''left'
Panel edge anchored to the trigger.
ariaLabelstring—
Accessible name for the trigger.
autoPlacebooleantrue
Flips the panel when crowded.
buttonClassstring?built-in
Replaces the trigger chip classes.
clearLabelstring?'Clear selection'
Accessible name for the clear button.
clearablebooleanfalse
Appends a cross button that selects the default value.
defaultValuestring?''
Baseline the clear button compares against: the option value (not its label); the cross hides while the committed value matches it.
disabledbooleanfalse
Disables the trigger.
emptyTextstring?—
Shown when the filtered panel is empty; falls back to the localized label.
filterPlaceholderstring?—
Search input placeholder; falls back to the localized label.
filterLabelstring?—
Accessible name for the search input; falls back to the shared Search label.
filterablebooleanfalse
Adds a search field to the panel.
labelstring—
Trigger chip text; usually the selected label.
options(string | { value: string; label?: string })[]—
Selectable chips; a bare string (or a missing label) displays as its own value. The eye resets to the default chips.
panelClassstring?built-in
Replaces the floating panel classes.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Chip scale; numbers are icon-scale pixels interpolated between the steps.
variant'sky' | 'violet' | 'amber' | 'fuchsia' | 'emerald''violet'
Chip color scheme.
onClear() => voidonSelect(default)—Clear handler; selects the default value when omitted.
onSelect(value: string) => void——Called with the chosen value.