| activeValue | string? | '' | | Committed option value (not its label); marked in the panel. |
| align | 'left' | 'right' | 'left' | | Panel edge anchored to the trigger. |
| allowCustomValue | boolean | false | | Enter commits typed text that matches no option (filterable only). |
| ariaLabel | string? | — | | Accessible name for the control. |
| autoPlace | boolean | true | | Flips the panel when crowded. |
| buttonClass | string? | built-in | | Replaces the trigger button box classes. |
| buttonLabel | string? | derived | | Overrides the trigger label; omit it and the trigger shows the committed option's label (or the raw value). |
| clearLabel | string? | 'Clear selection' | | Accessible name for the clear button. |
| clearable | boolean | false | | Appends a cross button that clears the value. |
| controlClass | string? | built-in | | Replaces the filterable trigger box classes. |
| defaultValue | string? | '' | | Baseline the clear button compares against: the option value (not its label); the cross hides while the committed value matches it. |
| emptyLabel | string? | — | | Shown when the filtered list is empty. |
| filterable | boolean | false | | Renders a combobox input with filtering. |
| hideOutline | boolean | false | | Drops the bordered trigger’s border, hover tint, and focus border while keeping its surface, metrics, and text rules. |
| leading | Snippet | — | | Content rendered in the trigger before the text; it sits in flow and is sized by the caller (a leading search icon or glyph). |
| optionClass | string? | built-in | | Replaces the option row classes. |
| options | (string | { value: string; label?: string })[] | — | | Selectable options; a bare string (or a missing label) displays as its own value. The eye resets to the default options. |
| panelClass | string? | built-in | | Replaces the floating panel classes. |
| ratios | SelectRatioOverrides? | — | | Partial override of the trigger and option-row ratios (font, paddings, the chevron’s border gutter and label gap, min-width, gap, icon); the line box follows the font and both chevron metrics stay independent of padX. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers are icon-scale pixels interpolated between the steps. |
| trailer | Snippet | — | | Content rendered outside the trigger, after it (and after the clear affordance). |
| variant | 'bordered' | 'embedded' | 'bordered' | | Chrome variant; embedded drops the border, surface, and focus styles for a trigger inside another surface. |
| onClear | () => void | onSelect(default) | — | Clear handler; selects the default value when omitted. |
| onSelect | (value: string) => void | — | — | Called with the chosen value. |