# HelperText: API

## Пропсы корня

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `size` | `HelperTextSize` | `'md'` | Нет | Визуальный размер вспомогательного текста. Настраивает размер шрифта и интервалы относительно размера элемента формы. |
| `error` | `boolean` | — | Нет | Показывает вспомогательный текст в состоянии ошибки. Меняет цвет на красный. |
| `ref` | `Ref<HTMLSpanElement>` | — | Нет | Ref на нижележащий `<span>` или элемент в слоте. Полезен для измерений, фокуса или работы с DOM. |
| `asChild` | `boolean` | — | Нет | Если true, рендерит текст как дочерний компонент через `Slot`. Полезно для совместимости с нативными элементами или другими компонентами. |
| `fontWeight` | `400 \| 500 \| 600 \| 700 \| 900` | — | Нет | Насыщенность шрифта текста. Распространённые значения: 400: обычный; 500: средний; 600: полужирный; 700: жирный; 900: сверхжирный |

Также принимает все атрибуты `<span>`.

## Дочерние части

- Нет. `HelperText` — единственный экспортируемый примитив.

## Типы

- `HelperTextProps`

## Модель состояния

- У `HelperText` нет контролируемого состояния.
- `error` — визуальный семантический переключатель, а не логика валидации сама по себе.