## stat (`poetry_stat`)

A single KPI: a muted label over a large metric value.

Class: Poetry::Ui::Stat::Component - BEM block `poetry-ui-stat`.
Content block REQUIRED (the metric value) - a blockless call raises.
- `delta:` (string) - The change text shown in the pill beside the value ("+12.5%").
- `label:` (string) - required - The metric's name, shown muted above the value.
- `sentiment:` (symbol) - one of positive|negative|neutral - Overrides the trend-derived sentiment - color follows sentiment, never the arrow (set :positive when DOWN is the good direction).
- `trend:` (symbol) - one of up|down|flat, default "up" - The arrow direction; also derives the default sentiment.
Slots: description (Muted supporting copy rendered under the value.), media (The trend-visual slot (sparkline, chart, glyph) below the text stack.).
- PART `stat` - The stat root - a label/value/delta/description column
- PART `stat-label` - The muted metric name above the value
- PART `stat-value` - The metric itself - large, semibold, tabular numerals
- PART `stat-delta` - The change pill beside the value - arrow icon + delta text with an sr-only trend word | states: data-trend=up|down|flat (always - the arrow direction); data-sentiment=positive|negative|neutral (always - resolved sentiment (trend-derived unless overridden))
- PART `stat-description` - Muted supporting copy under the value
- PART `stat-media` - The trend-visual slot (sparkline, chart, glyph) below the text stack
- RULE: One Stat is ONE metric: label: names it, the content block is the value - compose several in a grid (typically each inside a Card) for a dashboard row.
- RULE: delta: carries the change text ('+12.5%'); trend: (up/down/flat) sets the arrow and the default sentiment. Override sentiment: :positive when DOWN is the good direction (costs, churn, error rate) - color follows sentiment, never the arrow.
- RULE: Keep the value textual - tabular numerals are already applied; units and formatting belong in the content ('$45,231', '99.98%').
- RULE: A Stat is not a chart: a trend over time goes in the media slot (or use poetry-charts).