# Meter: API

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

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `size` | `MeterSize` | `'md'` | Нет | Визуальный размер индикатора. Обычно соответствует предопределённым токенам размера дизайн-системы. |
| `variant` | `MeterVariant` | `'primary'` | Нет | Визуальный вариант индикатора (например, для тем оформления). |
| `max` | `number` | `1` | Нет | Максимально возможное значение индикатора. По умолчанию 1. |
| `min` | `number` | `0` | Нет | Минимально возможное значение индикатора. По умолчанию 0. |
| `value` | `number` | — | Да | Текущее числовое значение индикатора. Обязательно. Ограничивается диапазоном от `min` до `max`. |
| `valueText` | `string` | — | Нет | Визуально скрытая доступная метка для скринридеров, описывающая текущее значение (например, "60% fuel"). |
| `fullWidth` | `boolean` | — | Нет | Растягивается ли индикатор на всю ширину контейнера. |
| `optimum` | `number` | — | Нет | «Оптимальное» значение индикатора. Определяет, какая область (low, high, optimum) предпочтительна. |
| `low` | `number` | — | Нет | Нижний порог неоптимальных значений. Значение ниже него может считаться «плохим». |
| `high` | `number` | — | Нет | Верхний порог неоптимальных значений. Значение выше него может считаться «плохим» (если optimum низкий). |

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

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

- `MeterTrack`: видимая дорожка заполнения.

### `MeterTrack`

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

## Типы

- `MeterProps`
- `MeterTrackProps`
- `MeterSize`
- `MeterVariant`

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

- `Meter` всегда определяется значением и не бывает неопределённым.
- Пропсы порогов могут менять семантическое состояние с нейтрального на хорошее, предупреждающее или плохое.