# Stat

Metric value and caption for KPI compositions.

Use Stat to foreground one metric and its caption inside a dashboard or summary.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `label` | `string` | prop | No | `undefined` | Caption below the value. |
| `leading` | `Snippet` | snippet | No | `undefined` | Optional content slot rendered above the value (e.g. badge, icon). |
| `size` | `StatSize` | prop | No | `'md'` | Display size — `sm` 32 / `md` 40 / `lg` 56 px. Default `md`. |
| `value` | `string \| number` | prop | Yes | - | The numeric or short value displayed prominently. |

## Related

- [Eyebrow](/docs/components/eyebrow): Tracked label used above headings.
- [Avatar](/docs/components/avatar): Identity image or fallback with an optional status marker.
- [CodeBlock](/docs/components/code-block): Read-only code surface with copy support.