| align | 'left' | 'right' | 'left' | | Panel edge anchored to the field. |
| ariaLabel | string? | — | | Accessible name for the combobox. |
| autoPlace | boolean | true | | Flips the panel when crowded. |
| clearLabel | string? | '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). |
| clearable | boolean | false | | Appends a cross button that clears the value. |
| defaultValue | string? | '' | | Baseline the clear button compares against; the cross hides while the value matches it. |
| disabled | boolean | false | | Disables the field; the panel never opens. |
| hideOutline | boolean | false | | 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. |
| panelClass | string? | built-in | | Replaces the floating panel classes. |
| placeholder | string? | — | | Native placeholder. |
| ratios | AutoCompleteRatioOverrides? | — | | 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. |
| value | string | — | | 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. |
| inputRef | HTMLInputElement | null | null | — | Bindable native input element. |
| onClear | () => void | clears 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. |