## progress (`poetry_progress`)

A determinate progress bar toward task completion.

Class: Poetry::Ui::Progress::Component - BEM block `poetry-ui-progress`.
- `label:` (string) - required - The progressbar's accessible name and visible caption.
- `max:` (integer) - default 100 - The completion value.
- `show_value:` (boolean) - default true - Set false to hide the percent readout.
- `value:` (integer) - required - The current progress, clamped into 0..max:.
- PART `progress` - Root (role=progressbar, aria-value* and the accessible name) - label, value readout, and track stack here
- PART `progress-label` - The visible caption span (label:)
- PART `progress-value` - The tabular percent readout - renders unless show_value: false
- PART `progress-track` - The full-width rail the indicator fills
- PART `progress-indicator` - The filled bar - sized by an inline width percentage computed from value:/max:
- RULE: label: is REQUIRED - it is the progressbar's accessible name and the visible caption.
- RULE: value: is the current progress (0..max:, default max 100); the component computes the width.
- RULE: For an UNKNOWN duration use Spinner, not Progress - this bar is determinate.