# Vexlora Chart & Visualization System

Recharts owns geometry and interaction; Vexlora owns semantic colors, containers, cards, legends, tooltip treatment, states and responsive composition.

## Rules

- Use `--chart-1` through `--chart-5`; no hardcoded chart palette.
- Use `ChartContainer` for predictable responsive sizing.
- Reuse shared tooltip/legend/state patterns.
- Keep side-by-side dashboard cards aligned; charts flex within the card instead of shrinking the outer row.
- Every production visualization defines loading, empty and error behavior.
- Domain data stays outside generic chart presentation when practical.

## Generic chart recipes

Line, area, grouped bar, stacked bar, horizontal bar, pie, donut, radar, radial progress, scatter, composed line+bar, conversion funnel and KPI sparkline.

Domain dashboards contain additional specialized compositions, but Foundation only promotes patterns that are broadly reusable.

## File layout

- `src/components/charts/**` — shared presentation layer.
- `src/config/chart-system.ts` — semantic chart configuration.
- `src/features/charts/components/**` — generic chart recipe gallery.
- domain `features/**` — business-specific chart compositions.