# IncomingOutgoingsCard

## 2026-07-28 — Bucket-taxonomy labels + info-icon tooltips

**Prompted by:** frontend Storybook backfill (Sprint B — dashboard bucket model)

### What changed
- Relabelled the row taxonomy to match the FE dashboard: `Living Expenses` → **Essentials**, `Lifestyle Expenses` → **Lifestyle: Discretionary**, `Surplus Income & Savings` → **Surplus & Future Savings** (Total Income / Debt Repayments / Over Spending unchanged). Icon map updated to suit.
- New optional `tooltip` prop on `IncomingOutgoingsCardProps` — a whole-card explainer shown as an info icon next to the title.
- New optional `tooltip` field on `IncomingOutgoingsItem` — a per-row explainer (e.g. why Debt Repayments don't add up exactly to income; how Surplus is derived).
- Added a dedicated story (the card previously had none).

### Why
- The dashboard moved to the budget-bucket model; the card's rows and copy now mirror it, and the minimum-loan-repayment / consumption logic is explained inline via tooltips instead of an extra row.

### Affected tokens / files
- `packages/shadcn/src/components/ui/incoming-outgoings-card.tsx`

> Note: `IncomingOutgoingsLabel` changed values — a breaking type change. Only the frontend dashboard story consumed it; it was updated in the same branch.