# AvatarStack: API

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

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `ref` | `Ref<HTMLDivElement>` | — | Нет | Ref, передаваемый на корневой элемент `div` группы аватаров. Полезен для прямого доступа к DOM (например, чтобы измерить ширину или подключить слушатели). |
| `size` | `AvatarGroupSize` | `'md'` | Нет | Размер всех аватаров в группе. Обеспечивает единый размер всех элементов. |
| `variant` | `AvatarGroupVariant` | `'primary'` | Нет | Вариант для всех аватаров группы. Применяет единый визуальный стиль (например, `primary`, `secondary`). |

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

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

- `AvatarStackItem`: аватар, учитывающий стопку.

### `AvatarStackItem`

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `ref` | `Ref<HTMLDivElement>` | — | Нет | Ref, передаваемый на корневой элемент `div` аватара. Даёт доступ к DOM-узлу, например для фокуса или измерений. |
| `size` | `AvatarSize` | — | Нет | Определяет размер аватара. Влияет и на контейнер, и на вложенное содержимое (изображение, инициалы и т. д.). |
| `variant` | `AvatarVariant` | — | Нет | Визуальный вариант аватара. Позволяет различать роли, типы или контексты. 'primary': визуальный стиль по умолчанию; 'secondary': альтернативный или менее заметный стиль |

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

## Типы

- `AvatarGroupProps`
- `AvatarGroupStackItemProps`
- `AvatarGroupSize`
- `AvatarGroupVariant`

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

- У `AvatarStack` нет контролируемого состояния.
- Размер и вариант передаются дочерним аватарам через контекст.