| ariaLabel | string | — | | Accessible name for the control. |
| caretAtEnd | boolean | false | | Places the caret after the last character on focus and click instead of at the clicked position. |
| className | string? | '' | | Extra classes for the input. |
| clearLabel | string? | 'Clear' | | Accessible name for the clear button. |
| clearPlacement | 'auto' | 'inside' | 'outside' | 'auto' | | Inside sits left of the steppers; outside sits after them; auto renders outside because the steppers own the right edge. |
| clearable | boolean | false | | Appends a cross button that clears the value. |
| decrementLabel | string? | locale | | Accessible name for the down button. |
| defaultValue | string? | '' | | Baseline the clear button compares against; the cross hides while the value matches it. |
| disabled | boolean | false | | Disables the input and steppers. |
| 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. |
| incrementLabel | string? | locale | | Accessible name for the up button. |
| inputStyle | string? | — | | Inline style for the input; widths the field when steppers are hidden. |
| max | number? | — | | Upper clamp on typing, blur, and step. |
| min | number? | — | | Lower clamp on blur and step (and on typing when a longer entry could not fit). |
| placeholder | string? | — | | Native placeholder. |
| ratios | NumberInputRatioOverrides? | — | | Partial override of the field and stepper-column ratios; the line box follows the font. |
| showControls | boolean | true | | Renders the stepper buttons; hiding them leaves the box and chrome untouched. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers are icon-scale pixels scaled by fixed ratios. |
| step | number? | 1 | | Arrow/wheel step; decimals preserved. |
| value | string | — | | Bindable field value; the eye resets it to 5. |
| variant | 'bordered' | 'embedded' | 'bordered' | | Bordered keeps the shared chrome and metrics whether or not the steppers render; embedded drops them so the caller’s class owns the box. |
| onClear | () => void | clears value | — | Clear handler; falls back to clearing the bound value when omitted. |
| onblur | (event: FocusEvent) => void | — | — | Blur callback. |
| oninput | (event: Event) => void | — | — | Input callback. |
| onkeydown | (event: KeyboardEvent) => void | — | — | Keydown callback. |