# Core/TextField - Usage

Single-line text field with optional label and helper text.

| Prop | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `onChange` | `(value: string) => void` | No | `--` | Called with the new string value when the input changes. |
| `showCount` | `boolean` | No | `--` | When true, shows a character count. |
| `value` | `string \| number \| undefined` | No | `--` | `--` |
| `helperText` | `string` | No | `--` | Helper text below the field. Replaced by error message when status is error. Use for requirements, disclaimers. |
| `label` | `string` | No | `--` | Label for the field. Required for accessibility; use aria-label if another element acts as label. |
| `layout` | `'vertical' \| 'horizontal'` | No | `--` | Label and field layout: vertical (label above) or horizontal (label on leading side). Prefer vertical; use horizontal when space is limited. |