| ariaLabel | string | — | | Required accessible name. |
| className | string? | '' | | Extra classes appended after the base chrome; an embedded field takes its text rules here. |
| clearLabel | string? | 'Clear' | | Accessible name for the clear button. |
| clearPlacement | 'auto' | 'inside' | 'outside' | 'auto' | | Inside overlays the editor’s first line; outside sits after it; auto renders inside. |
| 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. |
| hideOutline | boolean | false | | Drops the field’s border and focus border while keeping its surface, padding, and text metrics. |
| id | string? | — | | Native textarea id. |
| inputClass | string? | built-in | | Replaces the default textarea classes. |
| inputRef | HTMLTextAreaElement | null | null | — | Bindable native textarea. |
| placeholder | string? | — | | Native placeholder. |
| ratios | TextAreaRatioOverrides? | — | | Partial override of the editor’s tunable ratios (font, radius, paddings, the clear box and gutter, and the outside row’s gap); the line box follows the font and the clear inset follows padX. |
| readonly | boolean | false | | Read-only field. |
| rows | number? | 3 | | Visible text rows. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers are icon-scale pixels interpolated between the steps. |
| 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. |
| 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. |