# Status icons and progress

Package: @commenda/pathfinder@0.1.0
Page: /docs/assets/status-icons

<AssetExplorer collection="status-icons" />

## Usage [#usage]

```tsx
import { Icons } from '@commenda/pathfinder';
<Icons.Status status="in-review" label="In review" />
<Icons.Progress.Ring value={33} label="Documents complete" valueText="3 of 9 complete" />
```

**ASSET-STATUS-01:** Ten statuses use sizes 12, 16 (default), 20, and 24. `to-do` is backlog; `scheduled` is planned but not started. They share a glyph, so their labels carry the distinction. `in-progress` means started; `in-review` awaits a reviewer; `completed` is done; `canceled` will not be done.

**ASSET-STATUS-02:** `blocking` holds up another item; `blocked-by` waits on another item. These relationships stay neutral. `failed` needs a redo; `needs-attention` needs someone to act. In progress uses Amber 600, review Blue 600, completed Green 700, failed Red 700, attention Orange 700, and neutral states Soft Pearl 700.

**ASSET-PROGRESS-01:** The semantic `ProgressRing` / `Icons.Progress.Ring` accepts any measured numeric value with an optional `max` (100 by default), or `null` for indeterminate progress. Sizes remain 16 (default), 24 and 32. The source-aligned arc sweeps clockwise from 12 o'clock; track Soft Pearl 700 at 35% opacity. Provide a name and pair with a count; `valueText` supplies a human-readable value. Explicit complete/failed states and reduced-motion-aware animation follow the [Progress contract](/docs/components/progress). The nine static `Progress0Icon` through `Progress100Icon` artwork exports remain available for static specimens.

The additional Figma `activity` family contains five row-indicator states with tooltip variants and a running-motion rule. Its ten source variants are retained, but are explicitly excluded from this static status API. Its tooltip and animation behavior require a dedicated component.

## Progress library [#progress-library]

<AssetExplorer collection="progress" />