| ariaLabel | string | — | | Required accessible name. |
| 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. |
| hideOutline | boolean | false | | Drops the field’s border and focus border while keeping its surface, padding, and text metrics. |
| inputClass | string? | built-in | | Replaces the default input classes. |
| inputRef | HTMLInputElement | null | null | — | Bindable native input. |
| placeholder | string? | 'Search...' | | Native placeholder. |
| ratios | SearchInputRatioOverrides? | — | | Partial override of the field and search-icon ratios; the gutter derives from the icon inset, glyph, and gap. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Box, text, and icon scale together; numbers are icon-scale pixels interpolated between the steps. |
| value | string | — | | Bindable search text; the eye resets it to empty. |
| wrapperClass | string? | '' | | Extra classes for the outer wrapper. |
| onClear | () => void | clears value | — | Clear handler; falls back to clearing the bound value when omitted. |
| onblur | (event: FocusEvent) => void | — | — | Blur callback. |
| onfocus | (event: FocusEvent) => void | — | — | Focus callback. |
| oninput | (event: Event) => void | — | — | Input callback. |
| onkeydown | (event: KeyboardEvent) => void | — | — | Keydown callback; Escape clears in this demo. |