| ariaLabel | string? | — | | Accessible name; optional so wrappers can leave it to an external label. |
| autocomplete | string? | — | | Native autocomplete token. |
| className | string? | '' | | Extra classes appended to the input. |
| clearLabel | string? | 'Clear' | | Accessible name for the clear button. |
| clearPlacement | 'auto' | 'inside' | 'outside' | 'auto' | | Inside overlays the field edge; outside sits after it; auto picks outside when a trailing adornment is set. |
| 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 input. |
| hideOutline | boolean | false | | Drops the bordered field’s border and focus border while keeping its surface, padding, and text metrics. |
| id | string? | — | | Native input id. |
| inputClass | string? | built-in | | Replaces the default input classes. |
| inputStyle | string? | — | | Inline style appended after the size metrics; sizes the field at runtime. |
| inputmode | string? | — | | Native inputmode; NumberInput drives numeric/decimal. |
| leading | Snippet | — | | Adornment block rendered before the text, positioned inside the frame. |
| name | string? | — | | Native input name. |
| placeholder | string? | — | | Native placeholder. |
| ratios | TextInputRatioOverrides? | — | | Partial override of the field’s tunable ratios (font, radius, paddings, the clear box and gutter, and the trailer gap); the editor opens on the shared defaults, omitted keys keep them, the line box follows the font, and the clear inset follows padX. |
| readonly | boolean | false | | Read-only input. |
| required | boolean | false | | Native required flag. |
| 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 field, after it, in a size-scaled row. |
| trailing | Snippet | — | | Adornment block rendered after the text, positioned inside the frame. |
| type | string? | 'text' | | Native input type; PasswordInput and SearchInput drive it. |
| value | string | — | | Bindable field value; the eye resets it to empty. |
| variant | 'bordered' | 'embedded' | 'bordered' | | Chrome variant; embedded drops the border, the background, and the focus ring for a field rendered inside another surface. |
| wrapperStyle | string? | — | | Style for the wrapping frame: the adornments’ metric custom properties and any frame-level layout a composite supplies. |
| inputRef | HTMLInputElement | null | null | — | Bindable native input. |
| 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. |
| onpointercancel | (event: PointerEvent) => void | — | — | Pointer-cancel callback. |
| onpointerdown | (event: PointerEvent) => void | — | — | Pointer-down callback. |
| onpointerup | (event: PointerEvent) => void | — | — | Pointer-up callback. |