# MeterStack: API

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

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `size` | `MeterStackSize` | `'md'` | Нет | Визуальный размер индикатора. Обычно соответствует предопределённым токенам размера дизайн-системы. |
| `max` | `number` | `1` | Нет | Максимально возможное значение индикатора. По умолчанию 100. |
| `min` | `number` | `0` | Нет | Минимально возможное значение индикатора. По умолчанию 0. |
| `value` | `number` | — | Да | Текущее числовое значение индикатора. Обязательно. Ограничивается диапазоном от `min` до `max`. |
| `fullWidth` | `boolean` | — | Нет | Растягивается ли индикатор на всю ширину контейнера. |

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

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

- `MeterStackSegment`: один пропорциональный сегмент.

### `MeterStackSegment`

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `value` | `number` | — | Нет | Числовое значение, которое визуально представляет этот частичный элемент. Например, сегмент составного индикатора. |

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

## Типы

- `MeterStackProps`
- `MeterStackSegmentProps`
- `MeterStackSize`

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

- `MeterStack` только отображает данные и не имеет контролируемого состояния взаимодействия.
- Корень передаёт каждому сегменту контекст `min` и `max` для семантики ARIA meter.