# Heading: API

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

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `as` | `HeadingAs` | — | Нет | HTML-тег заголовка для рендера (например, 'h1', 'h2'). Определяет семантическую структуру и уровень для доступности. |
| `size` | `HeadingSize` | — | Нет | Визуальный размер заголовка, независимый от тега `as`. Обычно соответствует типографической шкале дизайн-системы. Принимает значения от 1 (наименьший) до 11 (наибольший). |
| `fontWeight` | `400 \| 500 \| 600 \| 700 \| 900` | — | Нет | Насыщенность шрифта текста заголовка. 400: обычный; 500: средний; 600: полужирный; 700: жирный; 900: сверхжирный |
| `ref` | `Ref<HTMLHeadingElement>` | — | Нет | Ref на нативный HTML-элемент заголовка. Полезен для доступа к DOM или управления фокусом. |

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

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

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

## Типы

- `HeadingProps`
- `HeadingAs`
- `HeadingSize`

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

- У `Heading` нет контролируемого состояния.
- Семантика задаётся через `as`, внешний вид — через `size` и `fontWeight`.