# Progress

Task progress or a bounded measurement, selected with a required kind.

Choose kind="task" for determinate or indeterminate work. Choose kind="measurement" for a named bounded value and add text when color alone would carry meaning.

## API

The package declarations define these public members.

### Inherited prop contracts

- `AccessibleName` — Requires exactly one accessible name: `label`, `aria-label`, or `aria-labelledby`.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `aria-label` | `string` | prop | No | `undefined` | No additional description. |
| `aria-labelledby` | `string` | prop | No | `undefined` | No additional description. |
| `aria-valuetext` | `string` | prop | No | `undefined` | No additional description. |
| `indeterminate` | `boolean` | prop | No | `false` | No additional description. |
| `kind` | `'measurement' \| 'task'` | prop | Yes | - | No additional description. |
| `label` | `string` | prop | No | `undefined` | No additional description. |
| `max` | `number` | prop | No | `100` | No additional description. |
| `min` | `number` | prop | No | `0` | No additional description. |
| `showValue` | `boolean` | prop | No | `false` | No additional description. |
| `tone` | `ProgressTone` | prop | No | `'accent'` | No additional description. |
| `value` | `number` | prop | No | `0` | No additional description. |
| `valueLabel` | `string` | prop | No | `undefined` | No additional description. |

## Related

- [Badge](/docs/components/badge): Compact semantic or categorical label.
- [StatusDot](/docs/components/status-dot): Semantic status dot with an optional label and pulse.
- [EmptyState](/docs/components/empty-state): Empty-state message with optional art and action.