## meter (`poetry_meter`)

A gauge that shows a quantity within a known range.

Class: Poetry::Ui::Meter::Component - BEM block `poetry-ui-meter`.
- `label:` (string) - required - The meter's accessible name and visible caption.
- `max:` (integer) - default 100 - The range's upper bound - must exceed min:.
- `min:` (integer) - default 0 - The range's lower bound.
- `show_value:` (boolean) - default true - Set false to hide the visible readout.
- `value:` (integer) - required - The measured quantity, clamped into min:..max:.
- `value_text:` (string) - Verbatim human-readable value ("3 of 4 seats") replacing the percentage readout. Visible readout only - ARIA 1.2 deprecated aria-valuetext on role=meter, so aria-valuenow carries the value.
- PART `meter` - Root (role=meter, aria-value*, and the accessible name); label, readout, and track stack here
- PART `meter-label` - The visible caption span (label:)
- PART `meter-value` - The readout - value_text: verbatim, else the range percentage; renders unless show_value: false
- PART `meter-track` - The full-width rail (Progress's cn chrome)
- PART `meter-indicator` - The filled bar - inline width percentage of the range
- RULE: A quantity within a range is a Meter (disk, seats, strength); an operation's completion over time is Progress. There is NO indeterminate meter - unknown duration means Spinner.
- RULE: label: is REQUIRED - the meter's accessible name and visible caption.
- RULE: value_text: replaces the visible readout verbatim ("3 of 4 seats"); without it the readout shows the percentage of the RANGE. No aria-valuetext - ARIA 1.2 deprecated it on role=meter; aria-valuenow carries the value.