Compare commits

..

10 Commits

Author SHA1 Message Date
hsiegeln
a62ff5b064 feat: add source badge to LogViewer entries
All checks were successful
Build & Publish / publish (push) Successful in 1m58s
SonarQube Analysis / sonarqube (push) Successful in 2m47s
LogEntry now accepts an optional `source` field. When present, a small
badge (container/app/agent) renders between the level and message columns.
Backward compatible — entries without source render as before.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 23:30:29 +02:00
hsiegeln
53a9ed015a fix: limit x-axis tick labels to prevent overlap
All checks were successful
Build & Publish / publish (push) Successful in 1m23s
SonarQube Analysis / sonarqube (push) Successful in 2m31s
Auto-calculates tick interval to show ~6 labels max, with minTickGap
as safety net. Fixes unreadable x-axis on short time ranges (1h).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 22:08:03 +02:00
hsiegeln
38e42d10bb chore: bump version to 0.1.47
All checks were successful
Build & Publish / publish (push) Successful in 1m58s
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 19:38:17 +02:00
hsiegeln
ae420246c8 docs: update COMPONENT_GUIDE for ThemedChart migration 2026-04-12 19:37:27 +02:00
hsiegeln
7d9643bd1b feat!: replace custom chart components with ThemedChart + Recharts
BREAKING: LineChart, AreaChart, BarChart, ChartSeries, DataPoint removed.
Use ThemedChart with Recharts children (Line, Area, Bar, etc.) instead.
2026-04-12 19:36:19 +02:00
hsiegeln
99ff461d4d feat: add ThemedChart wrapper component 2026-04-12 19:34:21 +02:00
hsiegeln
ce93ba456c feat: add ChartTooltip component for ThemedChart 2026-04-12 19:33:45 +02:00
hsiegeln
3fc5fb8267 chore: add recharts dependency, move CHART_COLORS to rechartsTheme
Also fixes duplicate CHART_COLORS export in index.ts by switching from
export * to a named export of rechartsTheme only.
2026-04-12 19:33:28 +02:00
hsiegeln
e07afe37f2 docs: add Recharts migration implementation plan
All checks were successful
Build & Publish / publish (push) Successful in 1m2s
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 19:30:33 +02:00
hsiegeln
89453121a0 docs: add Recharts migration design spec
All checks were successful
Build & Publish / publish (push) Successful in 1m6s
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 19:24:32 +02:00
22 changed files with 1705 additions and 1402 deletions

View File

@@ -54,8 +54,8 @@
### "I need to display data"
- Key metrics → **StatCard** (with optional sparkline/trend)
- Tabular data → **DataTable** (sortable, paginated)
- Time series → **LineChart**, **AreaChart**
- Categorical comparison → **BarChart**
- Time series → **ThemedChart** with `<Line>` or `<Area>`
- Categorical comparison → **ThemedChart** with `<Bar>`
- Inline trend → **Sparkline**
- Advanced charts (treemap, radar, heatmap, pie, etc.) → **Recharts** with `rechartsTheme` (see [Charting Strategy](#charting-strategy))
- Event log → **EventFeed**
@@ -138,7 +138,7 @@ FormField wraps any input (Input, Textarea, Select, RadioGroup, etc.)
### KPI dashboard
```
Row of StatCard components (each with optional Sparkline and trend)
Below: charts (AreaChart, LineChart, BarChart)
Below: charts (ThemedChart with Line, Area, or Bar)
```
### Master/detail management pattern
@@ -175,57 +175,54 @@ StatCard strip (top, recalculates per scope)
→ GroupCard grid (2-col for all, full-width for single app)
Each GroupCard: header (app name + count) + meta (TPS, routes) + instance rows
Instance rows: StatusDot + name + Badge + metrics
Single instance: expanded with LineChart panels
Single instance: expanded with ThemedChart panels
→ EventFeed (bottom, filtered by scope)
URL-driven progressive filtering: /agents → /agents/:appId → /agents/:appId/:instanceId
```
## Charting Strategy
The design system includes built-in **AreaChart**, **BarChart**, **LineChart**, and **Sparkline** components for standard use cases. For advanced chart types (treemap, radar, heatmap, pie, sankey, etc.), consuming apps should use **Recharts** directly with the design system's theme preset for visual consistency.
The design system provides a **ThemedChart** wrapper component that applies consistent styling to Recharts charts. Recharts is bundled as a dependency — consumers do not need to install it separately.
**Recharts is the app's dependency, not the design system's.** The design system only exports a theme config object.
### Setup in consuming app
```bash
npm install recharts
```
### Usage with theme preset
### Usage
```tsx
import { rechartsTheme, CHART_COLORS } from '@cameleer/design-system'
import {
ResponsiveContainer, LineChart, Line,
CartesianGrid, XAxis, YAxis, Tooltip, Legend,
} from 'recharts'
import { ThemedChart, Line, Area, ReferenceLine, CHART_COLORS } from '@cameleer/design-system'
<ResponsiveContainer width="100%" height={300}>
<LineChart data={data}>
<CartesianGrid {...rechartsTheme.cartesianGrid} />
<XAxis dataKey="name" {...rechartsTheme.xAxis} />
<YAxis {...rechartsTheme.yAxis} />
<Tooltip {...rechartsTheme.tooltip} />
<Legend {...rechartsTheme.legend} />
<Line dataKey="value" stroke={CHART_COLORS[0]} strokeWidth={2} dot={false} />
<Line dataKey="other" stroke={CHART_COLORS[1]} strokeWidth={2} dot={false} />
</LineChart>
</ResponsiveContainer>
const data = metrics.map(m => ({ time: m.timestamp, cpu: m.value * 100 }))
<ThemedChart data={data} height={160} xDataKey="time" yLabel="%">
<Area dataKey="cpu" stroke={CHART_COLORS[0]} fill={CHART_COLORS[0]} fillOpacity={0.1} />
<ReferenceLine y={85} stroke="var(--error)" strokeDasharray="5 3" label="Alert" />
</ThemedChart>
```
### Exports
### ThemedChart Props
| Export | Description |
|--------|-------------|
| `rechartsTheme.cartesianGrid` | Dashed gridlines, subtle stroke |
| `rechartsTheme.xAxis` | Mono font axis ticks, subtle color |
| `rechartsTheme.yAxis` | Mono font axis ticks, no axis line |
| `rechartsTheme.tooltip` | Surface bg, border, shadow, monospace values |
| `rechartsTheme.legend` | Matching text size and color |
| `rechartsTheme.colors` | The 8 `CHART_COLORS` (CSS variables with light/dark support) |
| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `data` | `Record<string, any>[]` | required | Flat array of data objects |
| `height` | `number` | `200` | Chart height in pixels |
| `xDataKey` | `string` | `"time"` | Key for x-axis values |
| `xType` | `'number' \| 'category'` | `"category"` | X-axis scale type |
| `xTickFormatter` | `(value: any) => string` | — | Custom x-axis label formatter |
| `yTickFormatter` | `(value: any) => string` | — | Custom y-axis label formatter |
| `yLabel` | `string` | — | Y-axis label text |
| `children` | `ReactNode` | required | Recharts elements (Line, Area, Bar, etc.) |
| `className` | `string` | — | Container CSS class |
### Available Recharts Re-exports
`Line`, `Area`, `Bar`, `ReferenceLine`, `ReferenceArea`, `Legend`, `Brush`
For chart types not covered (treemap, radar, pie, sankey), import from `recharts` directly and use `rechartsTheme` for consistent styling.
### Theme Utilities
| Export | Purpose |
|--------|---------|
| `CHART_COLORS` | Array of `var(--chart-1)` through `var(--chart-8)` |
| `ChartSeries` / `DataPoint` | Type interfaces for chart data |
| `rechartsTheme` | Pre-configured prop objects for Recharts sub-components |
## Component Index
@@ -234,11 +231,9 @@ import {
| Accordion | composite | Multiple collapsible sections, single or multi-open mode |
| Alert | primitive | Page-level attention banner with variant colors |
| AlertDialog | composite | Confirmation dialog for destructive/important actions |
| AreaChart | composite | Time series visualization with filled area |
| Avatar | primitive | User representation with initials and color |
| AvatarGroup | composite | Stacked overlapping avatars with overflow count |
| Badge | primitive | Labeled status indicator with semantic colors |
| BarChart | composite | Categorical data comparison, optional stacking |
| Breadcrumb | composite | Navigation path showing current location |
| Button | primitive | Action trigger (primary, secondary, danger, ghost) |
| ButtonGroup | primitive | Multi-select toggle group with optional colored dot indicators. Props: items (value, label, color?), value (Set), onChange |
@@ -266,7 +261,7 @@ import {
| KeyboardHint | primitive | Keyboard shortcut display |
| KpiStrip | composite | Horizontal row of KPI cards with colored left border, trend, subtitle, optional sparkline |
| Label | primitive | Form label with optional required asterisk |
| LineChart | composite | Time series line visualization |
| ThemedChart | composite | Recharts wrapper with themed axes, grid, and tooltip |
| LogViewer | composite | Scrollable log output with timestamped, severity-colored monospace entries |
| MenuItem | composite | Sidebar navigation item with health/count |
| Modal | composite | Generic dialog overlay with backdrop |

View File

@@ -0,0 +1,845 @@
# Recharts Migration Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Replace the design system's hand-rolled SVG chart components with a single `ThemedChart` wrapper around Recharts, using Recharts-native data format.
**Architecture:** Add Recharts as a DS dependency. Create `ThemedChart` component that renders `ResponsiveContainer` + `ComposedChart` with pre-themed grid/axes/tooltip. Consumers compose Recharts elements (`<Line>`, `<Area>`, `<Bar>`, `<ReferenceLine>`) as children. Delete old `LineChart/`, `AreaChart/`, `BarChart/`, `_chart-utils.ts`. Migrate the server UI's `AgentInstance.tsx` to the new API.
**Tech Stack:** React 19, Recharts, CSS Modules, Vitest
---
## File Structure
**Design System (`C:\Users\Hendrik\Documents\projects\design-system`):**
| Action | Path | Purpose |
|--------|------|---------|
| Create | `src/design-system/composites/ThemedChart/ThemedChart.tsx` | Wrapper component: ResponsiveContainer + ComposedChart + themed axes/grid/tooltip |
| Create | `src/design-system/composites/ThemedChart/ChartTooltip.tsx` | Custom tooltip with timestamp header + series values |
| Create | `src/design-system/composites/ThemedChart/ChartTooltip.module.css` | Tooltip styles using DS tokens |
| Create | `src/design-system/composites/ThemedChart/ThemedChart.test.tsx` | Render tests for ThemedChart |
| Modify | `src/design-system/utils/rechartsTheme.ts` | Move `CHART_COLORS` definition here (was in `_chart-utils.ts`) |
| Modify | `src/design-system/composites/index.ts` | Remove old chart exports, add ThemedChart + Recharts re-exports |
| Modify | `COMPONENT_GUIDE.md` | Update charting strategy section |
| Modify | `package.json` | Add `recharts` dependency, bump version |
| Delete | `src/design-system/composites/LineChart/` | Old hand-rolled SVG line chart |
| Delete | `src/design-system/composites/AreaChart/` | Old hand-rolled SVG area chart |
| Delete | `src/design-system/composites/BarChart/` | Old hand-rolled SVG bar chart |
| Delete | `src/design-system/composites/_chart-utils.ts` | Old chart utilities |
**Server UI (`C:\Users\Hendrik\Documents\projects\cameleer3-server`):**
| Action | Path | Purpose |
|--------|------|---------|
| Modify | `ui/src/pages/AgentInstance/AgentInstance.tsx` | Migrate 6 charts to ThemedChart + Recharts children |
| Modify | `ui/package.json` | Update `@cameleer/design-system` to new version |
---
### Task 1: Add Recharts Dependency and Move CHART_COLORS
**Files:**
- Modify: `package.json`
- Modify: `src/design-system/utils/rechartsTheme.ts`
- [ ] **Step 1: Install recharts**
```bash
cd C:\Users\Hendrik\Documents\projects\design-system
npm install recharts
```
- [ ] **Step 2: Move CHART_COLORS into rechartsTheme.ts**
Replace the entire file `src/design-system/utils/rechartsTheme.ts` with:
```tsx
export const CHART_COLORS = [
'var(--chart-1)',
'var(--chart-2)',
'var(--chart-3)',
'var(--chart-4)',
'var(--chart-5)',
'var(--chart-6)',
'var(--chart-7)',
'var(--chart-8)',
]
/**
* Pre-configured Recharts prop objects that match the design system's
* chart styling. Used internally by ThemedChart and available for
* consumers composing Recharts directly.
*/
export const rechartsTheme = {
colors: CHART_COLORS,
cartesianGrid: {
stroke: 'var(--border-subtle)',
strokeDasharray: '3 3',
vertical: false,
},
xAxis: {
tick: { fontSize: 9, fontFamily: 'var(--font-mono)', fill: 'var(--text-faint)' },
axisLine: { stroke: 'var(--border-subtle)' },
tickLine: false as const,
},
yAxis: {
tick: { fontSize: 9, fontFamily: 'var(--font-mono)', fill: 'var(--text-faint)' },
axisLine: false as const,
tickLine: false as const,
},
tooltip: {
contentStyle: {
background: 'var(--bg-surface)',
border: '1px solid var(--border)',
borderRadius: 'var(--radius-sm)',
boxShadow: 'var(--shadow-md)',
fontSize: 11,
padding: '6px 10px',
},
labelStyle: {
color: 'var(--text-muted)',
fontSize: 11,
marginBottom: 4,
},
itemStyle: {
color: 'var(--text-primary)',
fontFamily: 'var(--font-mono)',
fontSize: 11,
padding: 0,
},
cursor: { stroke: 'var(--text-faint)' },
},
legend: {
wrapperStyle: {
fontSize: 11,
color: 'var(--text-secondary)',
},
},
} as const
```
- [ ] **Step 3: Verify build compiles**
```bash
npm run build:lib
```
Expected: Build succeeds. The old chart components still import `CHART_COLORS` from `_chart-utils.ts` which still exists — they'll be deleted in Task 4.
- [ ] **Step 4: Commit**
```bash
git add package.json package-lock.json src/design-system/utils/rechartsTheme.ts
git commit -m "chore: add recharts dependency, move CHART_COLORS to rechartsTheme"
```
---
### Task 2: Create ChartTooltip Component
**Files:**
- Create: `src/design-system/composites/ThemedChart/ChartTooltip.tsx`
- Create: `src/design-system/composites/ThemedChart/ChartTooltip.module.css`
- [ ] **Step 1: Create tooltip CSS**
Create `src/design-system/composites/ThemedChart/ChartTooltip.module.css`:
```css
.tooltip {
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
padding: 6px 10px;
font-size: 12px;
}
.time {
font-family: var(--font-mono);
font-size: 10px;
color: var(--text-muted);
margin-bottom: 4px;
padding-bottom: 3px;
border-bottom: 1px solid var(--border-subtle);
}
.row {
display: flex;
align-items: center;
gap: 5px;
margin-bottom: 2px;
}
.row:last-child {
margin-bottom: 0;
}
.dot {
width: 6px;
height: 6px;
border-radius: 50%;
flex-shrink: 0;
}
.label {
color: var(--text-muted);
font-size: 11px;
}
.value {
font-family: var(--font-mono);
font-weight: 600;
font-size: 11px;
color: var(--text-primary);
}
```
- [ ] **Step 2: Create ChartTooltip component**
Create `src/design-system/composites/ThemedChart/ChartTooltip.tsx`:
```tsx
import type { TooltipProps } from 'recharts'
import styles from './ChartTooltip.module.css'
function formatValue(val: number): string {
if (val >= 1_000_000) return `${(val / 1_000_000).toFixed(1)}M`
if (val >= 1000) return `${(val / 1000).toFixed(1)}k`
if (Number.isInteger(val)) return String(val)
return val.toFixed(1)
}
function formatTimestamp(val: unknown): string | null {
if (val == null) return null
const str = String(val)
const ms = typeof val === 'number' && val > 1e12 ? val
: typeof val === 'number' && val > 1e9 ? val * 1000
: Date.parse(str)
if (isNaN(ms)) return str
return new Date(ms).toLocaleString([], {
month: 'short', day: 'numeric',
hour: '2-digit', minute: '2-digit', second: '2-digit',
})
}
export function ChartTooltip({ active, payload, label }: TooltipProps<number, string>) {
if (!active || !payload?.length) return null
const timeLabel = formatTimestamp(label)
return (
<div className={styles.tooltip}>
{timeLabel && <div className={styles.time}>{timeLabel}</div>}
{payload.map((entry) => (
<div key={entry.dataKey as string} className={styles.row}>
<span className={styles.dot} style={{ background: entry.color }} />
<span className={styles.label}>{entry.name}:</span>
<span className={styles.value}>{formatValue(entry.value as number)}</span>
</div>
))}
</div>
)
}
```
- [ ] **Step 3: Commit**
```bash
git add src/design-system/composites/ThemedChart/
git commit -m "feat: add ChartTooltip component for ThemedChart"
```
---
### Task 3: Create ThemedChart Component
**Files:**
- Create: `src/design-system/composites/ThemedChart/ThemedChart.tsx`
- Create: `src/design-system/composites/ThemedChart/ThemedChart.test.tsx`
- [ ] **Step 1: Create ThemedChart component**
Create `src/design-system/composites/ThemedChart/ThemedChart.tsx`:
```tsx
import {
ResponsiveContainer,
ComposedChart,
CartesianGrid,
XAxis,
YAxis,
Tooltip,
} from 'recharts'
import { rechartsTheme } from '../../utils/rechartsTheme'
import { ChartTooltip } from './ChartTooltip'
interface ThemedChartProps {
data: Record<string, any>[]
height?: number
xDataKey?: string
xType?: 'number' | 'category'
xTickFormatter?: (value: any) => string
yTickFormatter?: (value: any) => string
yLabel?: string
children: React.ReactNode
className?: string
}
export function ThemedChart({
data,
height = 200,
xDataKey = 'time',
xType = 'category',
xTickFormatter,
yTickFormatter,
yLabel,
children,
className,
}: ThemedChartProps) {
if (!data.length) {
return null
}
return (
<div className={className} style={{ width: '100%', height }}>
<ResponsiveContainer width="100%" height="100%">
<ComposedChart data={data} margin={{ top: 4, right: 8, bottom: 0, left: 0 }}>
<CartesianGrid {...rechartsTheme.cartesianGrid} />
<XAxis
dataKey={xDataKey}
type={xType}
{...rechartsTheme.xAxis}
tickFormatter={xTickFormatter}
/>
<YAxis
{...rechartsTheme.yAxis}
tickFormatter={yTickFormatter}
label={yLabel ? {
value: yLabel,
angle: -90,
position: 'insideLeft',
style: { fontSize: 11, fill: 'var(--text-muted)' },
} : undefined}
/>
<Tooltip content={<ChartTooltip />} cursor={rechartsTheme.tooltip.cursor} />
{children}
</ComposedChart>
</ResponsiveContainer>
</div>
)
}
```
- [ ] **Step 2: Write test**
Create `src/design-system/composites/ThemedChart/ThemedChart.test.tsx`:
```tsx
import { describe, it, expect } from 'vitest'
import { render, screen } from '@testing-library/react'
import { ThemedChart } from './ThemedChart'
import { Line } from 'recharts'
// Recharts uses ResizeObserver internally
class ResizeObserverMock {
observe() {}
unobserve() {}
disconnect() {}
}
globalThis.ResizeObserver = ResizeObserverMock as any
describe('ThemedChart', () => {
it('renders nothing when data is empty', () => {
const { container } = render(
<ThemedChart data={[]}>
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.innerHTML).toBe('')
})
it('renders a chart container when data is provided', () => {
const data = [
{ time: '10:00', value: 10 },
{ time: '10:01', value: 20 },
]
const { container } = render(
<ThemedChart data={data} height={160}>
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.querySelector('.recharts-responsive-container')).toBeTruthy()
})
it('applies custom className', () => {
const data = [{ time: '10:00', value: 5 }]
const { container } = render(
<ThemedChart data={data} className="my-chart">
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.querySelector('.my-chart')).toBeTruthy()
})
})
```
- [ ] **Step 3: Run tests**
```bash
npx vitest run src/design-system/composites/ThemedChart/ThemedChart.test.tsx
```
Expected: 3 tests pass.
- [ ] **Step 4: Verify lib build**
```bash
npm run build:lib
```
Expected: Build succeeds.
- [ ] **Step 5: Commit**
```bash
git add src/design-system/composites/ThemedChart/
git commit -m "feat: add ThemedChart wrapper component"
```
---
### Task 4: Update Barrel Exports and Delete Old Charts
**Files:**
- Modify: `src/design-system/composites/index.ts`
- Delete: `src/design-system/composites/LineChart/`
- Delete: `src/design-system/composites/AreaChart/`
- Delete: `src/design-system/composites/BarChart/`
- Delete: `src/design-system/composites/_chart-utils.ts`
- [ ] **Step 1: Update composites/index.ts**
Remove these lines:
```
export { AreaChart } from './AreaChart/AreaChart'
export { BarChart } from './BarChart/BarChart'
export { LineChart } from './LineChart/LineChart'
export { CHART_COLORS } from './_chart-utils'
export type { ChartSeries, DataPoint } from './_chart-utils'
```
Add in their place:
```tsx
// Charts — ThemedChart wrapper + Recharts re-exports
export { ThemedChart } from './ThemedChart/ThemedChart'
export { CHART_COLORS, rechartsTheme } from '../utils/rechartsTheme'
export {
Line, Area, Bar,
ReferenceLine, ReferenceArea,
Legend, Brush,
} from 'recharts'
```
- [ ] **Step 2: Remove the rechartsTheme re-export from main index.ts**
In `src/design-system/index.ts`, remove this line (it's now re-exported via composites):
```
export * from './utils/rechartsTheme'
```
Replace with a targeted export that avoids double-exporting `CHART_COLORS`:
```tsx
export { rechartsTheme } from './utils/rechartsTheme'
```
Wait — actually `composites/index.ts` already re-exports both `CHART_COLORS` and `rechartsTheme`. And `index.ts` does `export * from './composites'`. So the main `index.ts` line `export * from './utils/rechartsTheme'` would cause a duplicate export of both symbols. Remove it entirely:
Delete this line from `src/design-system/index.ts`:
```
export * from './utils/rechartsTheme'
```
- [ ] **Step 3: Delete old chart directories and utilities**
```bash
rm -rf src/design-system/composites/LineChart
rm -rf src/design-system/composites/AreaChart
rm -rf src/design-system/composites/BarChart
rm src/design-system/composites/_chart-utils.ts
```
- [ ] **Step 4: Verify lib build**
```bash
npm run build:lib
```
Expected: Build succeeds. The old components are gone, ThemedChart and Recharts re-exports are the new public API.
- [ ] **Step 5: Run all tests**
```bash
npx vitest run
```
Expected: All tests pass. No test files existed for the deleted components.
- [ ] **Step 6: Commit**
```bash
git add -A
git commit -m "feat!: replace custom chart components with ThemedChart + Recharts
BREAKING: LineChart, AreaChart, BarChart, ChartSeries, DataPoint removed.
Use ThemedChart with Recharts children (Line, Area, Bar, etc.) instead."
```
---
### Task 5: Update COMPONENT_GUIDE.md
**Files:**
- Modify: `COMPONENT_GUIDE.md`
- [ ] **Step 1: Update the charting strategy section**
Find the section starting with `## Charting Strategy` (around line 183) and replace through line 228 with:
```markdown
## Charting Strategy
The design system provides a **ThemedChart** wrapper component that applies consistent styling to Recharts charts. Recharts is bundled as a dependency — consumers do not need to install it separately.
### Usage
```tsx
import { ThemedChart, Line, Area, ReferenceLine, CHART_COLORS } from '@cameleer/design-system'
const data = metrics.map(m => ({ time: m.timestamp, cpu: m.value * 100 }))
<ThemedChart data={data} height={160} xDataKey="time" yLabel="%">
<Area dataKey="cpu" stroke={CHART_COLORS[0]} fill={CHART_COLORS[0]} fillOpacity={0.1} />
<ReferenceLine y={85} stroke="var(--error)" strokeDasharray="5 3" label="Alert" />
</ThemedChart>
```
### ThemedChart Props
| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `data` | `Record<string, any>[]` | required | Flat array of data objects |
| `height` | `number` | `200` | Chart height in pixels |
| `xDataKey` | `string` | `"time"` | Key for x-axis values |
| `xType` | `'number' \| 'category'` | `"category"` | X-axis scale type |
| `xTickFormatter` | `(value: any) => string` | — | Custom x-axis label formatter |
| `yTickFormatter` | `(value: any) => string` | — | Custom y-axis label formatter |
| `yLabel` | `string` | — | Y-axis label text |
| `children` | `ReactNode` | required | Recharts elements (Line, Area, Bar, etc.) |
| `className` | `string` | — | Container CSS class |
### Available Recharts Re-exports
`Line`, `Area`, `Bar`, `ReferenceLine`, `ReferenceArea`, `Legend`, `Brush`
For chart types not covered (treemap, radar, pie, sankey), import from `recharts` directly and use `rechartsTheme` for consistent styling.
### Theme Utilities
| Export | Purpose |
|--------|---------|
| `CHART_COLORS` | Array of `var(--chart-1)` through `var(--chart-8)` |
| `rechartsTheme` | Pre-configured prop objects for Recharts sub-components |
```
- [ ] **Step 2: Update the component index table**
Find the rows for `AreaChart`, `BarChart`, `LineChart` in the component index table and replace all three with:
```
| ThemedChart | composite | Recharts wrapper with themed axes, grid, and tooltip |
```
- [ ] **Step 3: Update the decision tree**
Find lines 57-60 (the chart decision tree entries):
```
- Time series → **LineChart**, **AreaChart**
- Categorical comparison → **BarChart**
```
Replace with:
```
- Time series → **ThemedChart** with `<Line>` or `<Area>`
- Categorical comparison → **ThemedChart** with `<Bar>`
```
- [ ] **Step 4: Commit**
```bash
git add COMPONENT_GUIDE.md
git commit -m "docs: update COMPONENT_GUIDE for ThemedChart migration"
```
---
### Task 6: Publish Design System
**Files:**
- Modify: `package.json` (version bump)
- [ ] **Step 1: Bump version**
In `package.json`, change `"version"` to `"0.1.47"`.
- [ ] **Step 2: Build and verify**
```bash
npm run build:lib
```
- [ ] **Step 3: Commit and tag**
```bash
git add package.json
git commit -m "chore: bump version to 0.1.47"
git tag v0.1.47
git push && git push --tags
```
- [ ] **Step 4: Wait for CI to publish**
Wait for the Gitea CI pipeline to build and publish `@cameleer/design-system@0.1.47` to the npm registry. Verify with:
```bash
npm view @cameleer/design-system@0.1.47 version
```
---
### Task 7: Migrate Server UI AgentInstance Charts
**Files:**
- Modify: `C:\Users\Hendrik\Documents\projects\cameleer3-server\ui\src\pages\AgentInstance\AgentInstance.tsx`
- Modify: `C:\Users\Hendrik\Documents\projects\cameleer3-server\ui\package.json`
- [ ] **Step 1: Update design system dependency**
```bash
cd C:\Users\Hendrik\Documents\projects\cameleer3-server\ui
npm install @cameleer/design-system@0.1.47
```
- [ ] **Step 2: Update imports in AgentInstance.tsx**
Replace the chart-related imports:
Old:
```tsx
import {
StatCard, StatusDot, Badge, LineChart, AreaChart, BarChart,
EventFeed, Spinner, EmptyState, SectionHeader, MonoText,
LogViewer, ButtonGroup, useGlobalFilters,
} from '@cameleer/design-system'
```
New:
```tsx
import {
StatCard, StatusDot, Badge,
ThemedChart, Line, Area, ReferenceLine, CHART_COLORS,
EventFeed, Spinner, EmptyState, SectionHeader, MonoText,
LogViewer, ButtonGroup, useGlobalFilters,
} from '@cameleer/design-system'
```
- [ ] **Step 3: Replace data prep — JVM metrics**
Replace the 4 JVM series useMemo blocks (cpuSeries, heapSeries, threadSeries, gcSeries) with flat data builders:
```tsx
const formatTime = (t: string) =>
new Date(t).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
// JVM chart data — merge all metrics into flat objects by time bucket
const cpuData = useMemo(() => {
const pts = jvmMetrics?.metrics?.['process.cpu.usage.value'];
if (!pts?.length) return [];
return pts.map((p: any) => ({ time: p.time, cpu: p.value * 100 }));
}, [jvmMetrics]);
const heapData = useMemo(() => {
const pts = jvmMetrics?.metrics?.['jvm.memory.used.value'];
if (!pts?.length) return [];
return pts.map((p: any) => ({ time: p.time, heap: p.value / (1024 * 1024) }));
}, [jvmMetrics]);
const threadData = useMemo(() => {
const pts = jvmMetrics?.metrics?.['jvm.threads.live.value'];
if (!pts?.length) return [];
return pts.map((p: any) => ({ time: p.time, threads: p.value }));
}, [jvmMetrics]);
const gcData = useMemo(() => {
const pts = jvmMetrics?.metrics?.['jvm.gc.pause.total_time'];
if (!pts?.length) return [];
return pts.map((p: any) => ({ time: p.time, gc: p.value }));
}, [jvmMetrics]);
```
- [ ] **Step 4: Replace data prep — throughput and error**
Replace the throughputSeries and errorSeries useMemo blocks:
```tsx
const throughputData = useMemo(() => {
if (!chartData.length) return [];
return chartData.map((d: any) => ({ time: d.date.toISOString(), throughput: d.throughput }));
}, [chartData]);
const errorData = useMemo(() => {
if (!chartData.length) return [];
return chartData.map((d: any) => ({ time: d.date.toISOString(), errorPct: d.errorPct }));
}, [chartData]);
```
- [ ] **Step 5: Replace chart JSX — CPU Usage**
Replace the CPU chart card content:
```tsx
{cpuData.length ? (
<ThemedChart data={cpuData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="%">
<Area dataKey="cpu" name="CPU %" stroke={CHART_COLORS[0]}
fill={CHART_COLORS[0]} fillOpacity={0.1} strokeWidth={2} dot={false} />
<ReferenceLine y={85} stroke="var(--error)" strokeDasharray="5 3"
label={{ value: 'Alert', position: 'right', fill: 'var(--error)', fontSize: 9 }} />
</ThemedChart>
) : (
<EmptyState title="No data" description="No CPU metrics available" />
)}
```
- [ ] **Step 6: Replace chart JSX — Memory (Heap)**
Replace the heap chart card content:
```tsx
{heapData.length ? (
<ThemedChart data={heapData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="MB">
<Area dataKey="heap" name="Heap MB" stroke={CHART_COLORS[0]}
fill={CHART_COLORS[0]} fillOpacity={0.1} strokeWidth={2} dot={false} />
{heapMax != null && (
<ReferenceLine y={heapMax / (1024 * 1024)} stroke="var(--error)" strokeDasharray="5 3"
label={{ value: 'Max Heap', position: 'right', fill: 'var(--error)', fontSize: 9 }} />
)}
</ThemedChart>
) : (
<EmptyState title="No data" description="No heap metrics available" />
)}
```
- [ ] **Step 7: Replace chart JSX — Throughput**
```tsx
{throughputData.length ? (
<ThemedChart data={throughputData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="msg/s">
<Line dataKey="throughput" name="msg/s" stroke={CHART_COLORS[0]}
strokeWidth={2} dot={false} />
</ThemedChart>
) : (
<EmptyState title="No data" description="No throughput data in range" />
)}
```
- [ ] **Step 8: Replace chart JSX — Error Rate**
```tsx
{errorData.length ? (
<ThemedChart data={errorData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="%">
<Line dataKey="errorPct" name="Error %" stroke={CHART_COLORS[0]}
strokeWidth={2} dot={false} />
</ThemedChart>
) : (
<EmptyState title="No data" description="No error data in range" />
)}
```
- [ ] **Step 9: Replace chart JSX — Thread Count**
```tsx
{threadData.length ? (
<ThemedChart data={threadData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="threads">
<Line dataKey="threads" name="Threads" stroke={CHART_COLORS[0]}
strokeWidth={2} dot={false} />
</ThemedChart>
) : (
<EmptyState title="No data" description="No thread metrics available" />
)}
```
- [ ] **Step 10: Replace chart JSX — GC Pauses**
```tsx
{gcData.length ? (
<ThemedChart data={gcData} height={160} xDataKey="time"
xTickFormatter={formatTime} yLabel="ms">
<Area dataKey="gc" name="GC ms" stroke={CHART_COLORS[1]}
fill={CHART_COLORS[1]} fillOpacity={0.1} strokeWidth={2} dot={false} />
</ThemedChart>
) : (
<EmptyState title="No data" description="No GC metrics available" />
)}
```
- [ ] **Step 11: Update the Thread Count meta display**
The thread count meta currently reads from `threadSeries`. Update to read from `threadData`:
Old:
```tsx
{threadSeries
? `${threadSeries[0].data[threadSeries[0].data.length - 1]?.y.toFixed(0)} active`
: ''}
```
New:
```tsx
{threadData.length
? `${threadData[threadData.length - 1].threads.toFixed(0)} active`
: ''}
```
- [ ] **Step 12: Build server UI**
```bash
cd C:\Users\Hendrik\Documents\projects\cameleer3-server\ui
npm run build
```
Expected: Build succeeds.
- [ ] **Step 13: Commit and push**
```bash
cd C:\Users\Hendrik\Documents\projects\cameleer3-server
git add ui/
git commit -m "feat: migrate agent charts to ThemedChart + Recharts
Replace custom LineChart/AreaChart/BarChart usage with ThemedChart
wrapper. Data format changed from ChartSeries[] to Recharts-native
flat objects. Uses DS v0.1.47."
git push
```

View File

@@ -0,0 +1,121 @@
# Recharts Migration Design
## Goal
Replace the design system's hand-rolled SVG chart components (LineChart, AreaChart, BarChart) with Recharts-based implementations. The current custom charts have responsiveness issues (preserveAspectRatio distorting text), limited tooltip/axis formatting, and growing maintenance burden.
## Architecture
Add Recharts as a DS dependency. Replace the three custom chart components and `_chart-utils.ts` with a single `ThemedChart` wrapper component. Consumers compose Recharts elements (`<Line>`, `<Area>`, `<Bar>`, etc.) as children inside `<ThemedChart>`. The DS re-exports Recharts components so consumers don't need to add Recharts as a separate dependency.
Sparkline stays hand-rolled SVG (no axes, no tooltips — Recharts is overkill).
### What gets removed
- `composites/LineChart/` directory (LineChart.tsx, LineChart.module.css)
- `composites/AreaChart/` directory (AreaChart.tsx, AreaChart.module.css)
- `composites/BarChart/` directory (BarChart.tsx, BarChart.module.css)
- `composites/_chart-utils.ts`
- `ChartSeries` and `DataPoint` type exports
### What gets added
- `composites/ThemedChart/ThemedChart.tsx` — wrapper component
- `composites/ThemedChart/ChartTooltip.tsx` — internal themed tooltip
- `composites/ThemedChart/ThemedChart.module.css`
- Recharts re-exports from the DS barrel
### What stays unchanged
- `utils/rechartsTheme.ts` (now also used internally by ThemedChart)
- `CHART_COLORS`
- `primitives/Sparkline/`
## Data Format
Consumers use Recharts-native flat data format instead of the current `ChartSeries[]`:
```tsx
// Before (custom)
const series = [
{ label: 'CPU %', data: pts.map(p => ({ x: new Date(p.time), y: p.value * 100 })) }
]
<AreaChart series={series} height={160} yLabel="%" />
// After (Recharts-native)
const data = pts.map(p => ({ time: p.time, cpu: p.value * 100 }))
<ThemedChart data={data} height={160} xDataKey="time" yLabel="%">
<Area dataKey="cpu" stroke={CHART_COLORS[0]} fill={CHART_COLORS[0]} fillOpacity={0.1} />
</ThemedChart>
```
This is a breaking change. The migration cost is bounded — only `AgentInstance.tsx` in the server repo uses these components.
## ThemedChart API
```tsx
interface ThemedChartProps {
data: Record<string, any>[]
height?: number // default 200
xDataKey?: string // default "time"
xType?: 'number' | 'category' // default "category"
xTickFormatter?: (value: any) => string
yTickFormatter?: (value: any) => string
yLabel?: string
children: React.ReactNode // Recharts elements
className?: string
}
```
ThemedChart renders internally:
- `ResponsiveContainer` (width 100%, height from prop)
- `ComposedChart` (supports mixing Line + Bar + Area in one chart)
- `CartesianGrid` with `rechartsTheme.cartesianGrid`
- `XAxis` with `rechartsTheme.xAxis` + formatter
- `YAxis` with `rechartsTheme.yAxis` + formatter + label
- `Tooltip` with custom `ChartTooltip` component
## Tooltip
ThemedChart provides a custom `ChartTooltip` component (internal, not exported) that:
- Shows the x-value formatted as date/time in a header row (mono font, subtle border separator)
- Shows each series with colored dot + label + formatted value
- Uses DS tokens for styling (surface bg, border, shadow, mono font)
Consumers can override by passing their own `<Tooltip content={...} />` as a child. Recharts uses the last Tooltip it finds, so a consumer-provided one replaces the default.
## DS Re-exports
Selected Recharts components re-exported so consumers don't need `recharts` in their own package.json:
```tsx
export { ThemedChart } from './ThemedChart/ThemedChart'
export {
Line, Area, Bar, ReferenceLine, ReferenceArea,
Legend, Brush, ComposedChart,
} from 'recharts'
```
More can be added on demand.
## Consumer Migration — Server UI
`AgentInstance.tsx` has 6 charts to migrate:
| Chart | Before | After |
|-------|--------|-------|
| CPU Usage | `<AreaChart series={cpuSeries} threshold={...}>` | `<ThemedChart><Area dataKey="cpu" /><ReferenceLine y={85} /></ThemedChart>` |
| Memory (Heap) | `<AreaChart series={heapSeries} threshold={...}>` | `<ThemedChart><Area dataKey="heap" /><ReferenceLine y={max} /></ThemedChart>` |
| Throughput | `<LineChart series={throughputSeries}>` | `<ThemedChart><Line dataKey="throughput" /></ThemedChart>` |
| Error Rate | `<LineChart series={errorSeries}>` | `<ThemedChart><Line dataKey="errorPct" /></ThemedChart>` |
| Thread Count | `<LineChart series={threadSeries}>` | `<ThemedChart><Line dataKey="threads" /></ThemedChart>` |
| GC Pauses | `<AreaChart series={gcSeries}>` | `<ThemedChart><Area dataKey="gc" /></ThemedChart>` |
Data prep changes from building `ChartSeries[]` arrays to flat objects with named keys.
## Not in Scope
- Sparkline migration (no responsiveness issues, no axes/tooltips)
- SaaS UI (no chart component usage)
- Dashboard tab (already uses Recharts directly with `rechartsTheme`)
- New chart types (treemap, radar, etc. — consumers compose these directly)

411
package-lock.json generated
View File

@@ -1,17 +1,18 @@
{
"name": "@cameleer/design-system",
"version": "0.1.44",
"version": "0.1.46",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@cameleer/design-system",
"version": "0.1.44",
"version": "0.1.46",
"dependencies": {
"lucide-react": "^1.7.0",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-router-dom": "^7.0.0"
"react-router-dom": "^7.0.0",
"recharts": "^3.8.1"
},
"devDependencies": {
"@playwright/test": "^1.58.2",
@@ -1012,6 +1013,42 @@
"node": ">=18"
}
},
"node_modules/@reduxjs/toolkit": {
"version": "2.11.2",
"resolved": "https://registry.npmjs.org/@reduxjs/toolkit/-/toolkit-2.11.2.tgz",
"integrity": "sha512-Kd6kAHTA6/nUpp8mySPqj3en3dm0tdMIgbttnQ1xFMVpufoj+ADi8pXLBsd4xzTRHQa7t/Jv8W5UnCuW4kuWMQ==",
"license": "MIT",
"dependencies": {
"@standard-schema/spec": "^1.0.0",
"@standard-schema/utils": "^0.3.0",
"immer": "^11.0.0",
"redux": "^5.0.1",
"redux-thunk": "^3.1.0",
"reselect": "^5.1.0"
},
"peerDependencies": {
"react": "^16.9.0 || ^17.0.0 || ^18 || ^19",
"react-redux": "^7.2.1 || ^8.1.3 || ^9.0.0"
},
"peerDependenciesMeta": {
"react": {
"optional": true
},
"react-redux": {
"optional": true
}
}
},
"node_modules/@reduxjs/toolkit/node_modules/immer": {
"version": "11.1.4",
"resolved": "https://registry.npmjs.org/immer/-/immer-11.1.4.tgz",
"integrity": "sha512-XREFCPo6ksxVzP4E0ekD5aMdf8WMwmdNaz6vuvxgI40UaEiu6q3p8X52aU6GdyvLY3XXX/8R7JOTXStz/nBbRw==",
"license": "MIT",
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/immer"
}
},
"node_modules/@rolldown/pluginutils": {
"version": "1.0.0-beta.27",
"resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz",
@@ -1519,6 +1556,18 @@
"string-argv": "~0.3.1"
}
},
"node_modules/@standard-schema/spec": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
"integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
"license": "MIT"
},
"node_modules/@standard-schema/utils": {
"version": "0.3.0",
"resolved": "https://registry.npmjs.org/@standard-schema/utils/-/utils-0.3.0.tgz",
"integrity": "sha512-e7Mew686owMaPJVNNLs55PUvgz371nKgwsc4vxE49zsODpJEnxgxRo2y/OKrqueavXgZNMDVj3DdHFlaSAeU8g==",
"license": "MIT"
},
"node_modules/@testing-library/dom": {
"version": "10.4.1",
"resolved": "https://registry.npmjs.org/@testing-library/dom/-/dom-10.4.1.tgz",
@@ -1680,6 +1729,69 @@
"assertion-error": "^2.0.1"
}
},
"node_modules/@types/d3-array": {
"version": "3.2.2",
"resolved": "https://registry.npmjs.org/@types/d3-array/-/d3-array-3.2.2.tgz",
"integrity": "sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==",
"license": "MIT"
},
"node_modules/@types/d3-color": {
"version": "3.1.3",
"resolved": "https://registry.npmjs.org/@types/d3-color/-/d3-color-3.1.3.tgz",
"integrity": "sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==",
"license": "MIT"
},
"node_modules/@types/d3-ease": {
"version": "3.0.2",
"resolved": "https://registry.npmjs.org/@types/d3-ease/-/d3-ease-3.0.2.tgz",
"integrity": "sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==",
"license": "MIT"
},
"node_modules/@types/d3-interpolate": {
"version": "3.0.4",
"resolved": "https://registry.npmjs.org/@types/d3-interpolate/-/d3-interpolate-3.0.4.tgz",
"integrity": "sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==",
"license": "MIT",
"dependencies": {
"@types/d3-color": "*"
}
},
"node_modules/@types/d3-path": {
"version": "3.1.1",
"resolved": "https://registry.npmjs.org/@types/d3-path/-/d3-path-3.1.1.tgz",
"integrity": "sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==",
"license": "MIT"
},
"node_modules/@types/d3-scale": {
"version": "4.0.9",
"resolved": "https://registry.npmjs.org/@types/d3-scale/-/d3-scale-4.0.9.tgz",
"integrity": "sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==",
"license": "MIT",
"dependencies": {
"@types/d3-time": "*"
}
},
"node_modules/@types/d3-shape": {
"version": "3.1.8",
"resolved": "https://registry.npmjs.org/@types/d3-shape/-/d3-shape-3.1.8.tgz",
"integrity": "sha512-lae0iWfcDeR7qt7rA88BNiqdvPS5pFVPpo5OfjElwNaT2yyekbM0C9vK+yqBqEmHr6lDkRnYNoTBYlAgJa7a4w==",
"license": "MIT",
"dependencies": {
"@types/d3-path": "*"
}
},
"node_modules/@types/d3-time": {
"version": "3.0.4",
"resolved": "https://registry.npmjs.org/@types/d3-time/-/d3-time-3.0.4.tgz",
"integrity": "sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==",
"license": "MIT"
},
"node_modules/@types/d3-timer": {
"version": "3.0.2",
"resolved": "https://registry.npmjs.org/@types/d3-timer/-/d3-timer-3.0.2.tgz",
"integrity": "sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==",
"license": "MIT"
},
"node_modules/@types/deep-eql": {
"version": "4.0.2",
"resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
@@ -1708,7 +1820,7 @@
"version": "19.2.14",
"resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz",
"integrity": "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==",
"dev": true,
"devOptional": true,
"license": "MIT",
"dependencies": {
"csstype": "^3.2.2"
@@ -1724,6 +1836,12 @@
"@types/react": "^19.2.0"
}
},
"node_modules/@types/use-sync-external-store": {
"version": "0.0.6",
"resolved": "https://registry.npmjs.org/@types/use-sync-external-store/-/use-sync-external-store-0.0.6.tgz",
"integrity": "sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg==",
"license": "MIT"
},
"node_modules/@types/whatwg-mimetype": {
"version": "3.0.2",
"resolved": "https://registry.npmjs.org/@types/whatwg-mimetype/-/whatwg-mimetype-3.0.2.tgz",
@@ -2319,6 +2437,15 @@
"node": ">= 16"
}
},
"node_modules/clsx": {
"version": "2.1.1",
"resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
"integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
"license": "MIT",
"engines": {
"node": ">=6"
}
},
"node_modules/color-convert": {
"version": "2.0.1",
"resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
@@ -2399,9 +2526,130 @@
"version": "3.2.3",
"resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
"integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
"dev": true,
"devOptional": true,
"license": "MIT"
},
"node_modules/d3-array": {
"version": "3.2.4",
"resolved": "https://registry.npmjs.org/d3-array/-/d3-array-3.2.4.tgz",
"integrity": "sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==",
"license": "ISC",
"dependencies": {
"internmap": "1 - 2"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-color": {
"version": "3.1.0",
"resolved": "https://registry.npmjs.org/d3-color/-/d3-color-3.1.0.tgz",
"integrity": "sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==",
"license": "ISC",
"engines": {
"node": ">=12"
}
},
"node_modules/d3-ease": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-3.0.1.tgz",
"integrity": "sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==",
"license": "BSD-3-Clause",
"engines": {
"node": ">=12"
}
},
"node_modules/d3-format": {
"version": "3.1.2",
"resolved": "https://registry.npmjs.org/d3-format/-/d3-format-3.1.2.tgz",
"integrity": "sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==",
"license": "ISC",
"engines": {
"node": ">=12"
}
},
"node_modules/d3-interpolate": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-3.0.1.tgz",
"integrity": "sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==",
"license": "ISC",
"dependencies": {
"d3-color": "1 - 3"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-path": {
"version": "3.1.0",
"resolved": "https://registry.npmjs.org/d3-path/-/d3-path-3.1.0.tgz",
"integrity": "sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==",
"license": "ISC",
"engines": {
"node": ">=12"
}
},
"node_modules/d3-scale": {
"version": "4.0.2",
"resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-4.0.2.tgz",
"integrity": "sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==",
"license": "ISC",
"dependencies": {
"d3-array": "2.10.0 - 3",
"d3-format": "1 - 3",
"d3-interpolate": "1.2.0 - 3",
"d3-time": "2.1.1 - 3",
"d3-time-format": "2 - 4"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-shape": {
"version": "3.2.0",
"resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-3.2.0.tgz",
"integrity": "sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==",
"license": "ISC",
"dependencies": {
"d3-path": "^3.1.0"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-time": {
"version": "3.1.0",
"resolved": "https://registry.npmjs.org/d3-time/-/d3-time-3.1.0.tgz",
"integrity": "sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==",
"license": "ISC",
"dependencies": {
"d3-array": "2 - 3"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-time-format": {
"version": "4.1.0",
"resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-4.1.0.tgz",
"integrity": "sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==",
"license": "ISC",
"dependencies": {
"d3-time": "1 - 3"
},
"engines": {
"node": ">=12"
}
},
"node_modules/d3-timer": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz",
"integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==",
"license": "ISC",
"engines": {
"node": ">=12"
}
},
"node_modules/de-indent": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/de-indent/-/de-indent-1.0.2.tgz",
@@ -2427,6 +2675,12 @@
}
}
},
"node_modules/decimal.js-light": {
"version": "2.5.1",
"resolved": "https://registry.npmjs.org/decimal.js-light/-/decimal.js-light-2.5.1.tgz",
"integrity": "sha512-qIMFpTMZmny+MMIitAB6D7iVPEorVw6YQRWkvarTkT4tBeSLLiHzcwj6q0MmYSFCiVpiqPJTJEYIrpcPzVEIvg==",
"license": "MIT"
},
"node_modules/deep-eql": {
"version": "5.0.2",
"resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz",
@@ -2506,6 +2760,16 @@
"dev": true,
"license": "MIT"
},
"node_modules/es-toolkit": {
"version": "1.45.1",
"resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.45.1.tgz",
"integrity": "sha512-/jhoOj/Fx+A+IIyDNOvO3TItGmlMKhtX8ISAHKE90c4b/k1tqaqEZ+uUqfpU8DMnW5cgNJv606zS55jGvza0Xw==",
"license": "MIT",
"workspaces": [
"docs",
"benchmarks"
]
},
"node_modules/esbuild": {
"version": "0.25.12",
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
@@ -2568,6 +2832,12 @@
"@types/estree": "^1.0.0"
}
},
"node_modules/eventemitter3": {
"version": "5.0.4",
"resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz",
"integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==",
"license": "MIT"
},
"node_modules/expect-type": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
@@ -2814,6 +3084,16 @@
"dev": true,
"license": "MIT"
},
"node_modules/immer": {
"version": "10.2.0",
"resolved": "https://registry.npmjs.org/immer/-/immer-10.2.0.tgz",
"integrity": "sha512-d/+XTN3zfODyjr89gM3mPq1WNX2B8pYsu7eORitdwyA2sBubnTl3laYlBk4sXY5FUa5qTZGBDPJICVbvqzjlbw==",
"license": "MIT",
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/immer"
}
},
"node_modules/import-lazy": {
"version": "4.0.0",
"resolved": "https://registry.npmjs.org/import-lazy/-/import-lazy-4.0.0.tgz",
@@ -2834,6 +3114,15 @@
"node": ">=8"
}
},
"node_modules/internmap": {
"version": "2.0.3",
"resolved": "https://registry.npmjs.org/internmap/-/internmap-2.0.3.tgz",
"integrity": "sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==",
"license": "ISC",
"engines": {
"node": ">=12"
}
},
"node_modules/is-core-module": {
"version": "2.16.1",
"resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
@@ -3476,10 +3765,32 @@
"version": "17.0.2",
"resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",
"integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==",
"dev": true,
"license": "MIT",
"peer": true
},
"node_modules/react-redux": {
"version": "9.2.0",
"resolved": "https://registry.npmjs.org/react-redux/-/react-redux-9.2.0.tgz",
"integrity": "sha512-ROY9fvHhwOD9ySfrF0wmvu//bKCQ6AeZZq1nJNtbDC+kk5DuSuNX/n6YWYF/SYy7bSba4D4FSz8DJeKY/S/r+g==",
"license": "MIT",
"dependencies": {
"@types/use-sync-external-store": "^0.0.6",
"use-sync-external-store": "^1.4.0"
},
"peerDependencies": {
"@types/react": "^18.2.25 || ^19",
"react": "^18.0 || ^19",
"redux": "^5.0.0"
},
"peerDependenciesMeta": {
"@types/react": {
"optional": true
},
"redux": {
"optional": true
}
}
},
"node_modules/react-refresh": {
"version": "0.17.0",
"resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.17.0.tgz",
@@ -3528,6 +3839,36 @@
"react-dom": ">=18"
}
},
"node_modules/recharts": {
"version": "3.8.1",
"resolved": "https://registry.npmjs.org/recharts/-/recharts-3.8.1.tgz",
"integrity": "sha512-mwzmO1s9sFL0TduUpwndxCUNoXsBw3u3E/0+A+cLcrSfQitSG62L32N69GhqUrrT5qKcAE3pCGVINC6pqkBBQg==",
"license": "MIT",
"workspaces": [
"www"
],
"dependencies": {
"@reduxjs/toolkit": "^1.9.0 || 2.x.x",
"clsx": "^2.1.1",
"decimal.js-light": "^2.5.1",
"es-toolkit": "^1.39.3",
"eventemitter3": "^5.0.1",
"immer": "^10.1.1",
"react-redux": "8.x.x || 9.x.x",
"reselect": "5.1.1",
"tiny-invariant": "^1.3.3",
"use-sync-external-store": "^1.2.2",
"victory-vendor": "^37.0.2"
},
"engines": {
"node": ">=18"
},
"peerDependencies": {
"react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
"react-dom": "^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
"react-is": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
}
},
"node_modules/redent": {
"version": "3.0.0",
"resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz",
@@ -3542,6 +3883,21 @@
"node": ">=8"
}
},
"node_modules/redux": {
"version": "5.0.1",
"resolved": "https://registry.npmjs.org/redux/-/redux-5.0.1.tgz",
"integrity": "sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w==",
"license": "MIT"
},
"node_modules/redux-thunk": {
"version": "3.1.0",
"resolved": "https://registry.npmjs.org/redux-thunk/-/redux-thunk-3.1.0.tgz",
"integrity": "sha512-NW2r5T6ksUKXCabzhL9z+h206HQw/NJkcLm1GPImRQ8IzfXwRGqjVhKJGauHirT0DAuyy6hjdnMZaRoAcy0Klw==",
"license": "MIT",
"peerDependencies": {
"redux": "^5.0.0"
}
},
"node_modules/require-from-string": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
@@ -3552,6 +3908,12 @@
"node": ">=0.10.0"
}
},
"node_modules/reselect": {
"version": "5.1.1",
"resolved": "https://registry.npmjs.org/reselect/-/reselect-5.1.1.tgz",
"integrity": "sha512-K/BG6eIky/SBpzfHZv/dd+9JBFiS4SWV7FIujVyJRux6e45+73RaUHXLmIR1f7WOMaQ0U1km6qwklRQxpJJY0w==",
"license": "MIT"
},
"node_modules/resolve": {
"version": "1.22.11",
"resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
@@ -3921,6 +4283,12 @@
"node": ">=18"
}
},
"node_modules/tiny-invariant": {
"version": "1.3.3",
"resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz",
"integrity": "sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==",
"license": "MIT"
},
"node_modules/tinybench": {
"version": "2.9.0",
"resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
@@ -4051,6 +4419,37 @@
"browserslist": ">= 4.21.0"
}
},
"node_modules/use-sync-external-store": {
"version": "1.6.0",
"resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz",
"integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==",
"license": "MIT",
"peerDependencies": {
"react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
}
},
"node_modules/victory-vendor": {
"version": "37.3.6",
"resolved": "https://registry.npmjs.org/victory-vendor/-/victory-vendor-37.3.6.tgz",
"integrity": "sha512-SbPDPdDBYp+5MJHhBCAyI7wKM3d5ivekigc2Dk2s7pgbZ9wIgIBYGVw4zGHBml/qTFbexrofXW6Gu4noGxrOwQ==",
"license": "MIT AND ISC",
"dependencies": {
"@types/d3-array": "^3.0.3",
"@types/d3-ease": "^3.0.0",
"@types/d3-interpolate": "^3.0.1",
"@types/d3-scale": "^4.0.2",
"@types/d3-shape": "^3.1.0",
"@types/d3-time": "^3.0.0",
"@types/d3-timer": "^3.0.0",
"d3-array": "^3.1.6",
"d3-ease": "^3.0.1",
"d3-interpolate": "^3.0.1",
"d3-scale": "^4.0.2",
"d3-shape": "^3.1.0",
"d3-time": "^3.0.0",
"d3-timer": "^3.0.1"
}
},
"node_modules/vite": {
"version": "6.4.1",
"resolved": "https://registry.npmjs.org/vite/-/vite-6.4.1.tgz",

View File

@@ -1,6 +1,6 @@
{
"name": "@cameleer/design-system",
"version": "0.1.46",
"version": "0.1.49",
"type": "module",
"main": "./dist/index.es.js",
"module": "./dist/index.es.js",
@@ -40,7 +40,8 @@
"lucide-react": "^1.7.0",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-router-dom": "^7.0.0"
"react-router-dom": "^7.0.0",
"recharts": "^3.8.1"
},
"peerDependencies": {
"react": "^19.0.0",

View File

@@ -1,167 +0,0 @@
.wrapper {
position: relative;
display: flex;
flex-direction: column;
gap: 4px;
width: 100%;
}
.svg {
display: block;
overflow: visible;
}
.empty {
display: flex;
align-items: center;
justify-content: center;
color: var(--text-muted);
font-size: 12px;
height: 120px;
}
/* Grid */
.gridLine {
stroke: var(--border-subtle);
stroke-width: 1;
stroke-dasharray: 3 3;
}
.axisLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--text-faint);
}
/* Threshold line */
.thresholdLine {
stroke: var(--error);
stroke-width: 1.5;
stroke-dasharray: 5 3;
}
.thresholdLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--error);
}
/* Area + line */
.area {
opacity: 0.1;
}
.line {
stroke-width: 2;
stroke-linecap: round;
stroke-linejoin: round;
}
/* Crosshair */
.crosshair {
stroke: var(--text-faint);
stroke-width: 1;
stroke-dasharray: 3 3;
pointer-events: none;
}
/* Tooltip */
.tooltip {
position: absolute;
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
padding: 6px 10px;
font-size: 12px;
pointer-events: none;
z-index: 10;
white-space: nowrap;
}
.tooltipTime {
font-family: var(--font-mono);
font-size: 10px;
color: var(--text-muted);
margin-bottom: 4px;
padding-bottom: 3px;
border-bottom: 1px solid var(--border-subtle);
}
.tooltipRow {
display: flex;
align-items: center;
gap: 5px;
margin-bottom: 2px;
}
.tooltipRow:last-child {
margin-bottom: 0;
}
.tooltipDot {
width: 6px;
height: 6px;
border-radius: 50%;
flex-shrink: 0;
}
.tooltipLabel {
color: var(--text-muted);
}
.tooltipValue {
font-family: var(--font-mono);
font-weight: 600;
color: var(--text-primary);
}
/* Legend */
.legend {
display: flex;
flex-wrap: wrap;
gap: 12px;
padding-left: 48px;
}
.legendItem {
display: flex;
align-items: center;
gap: 5px;
font-size: 12px;
color: var(--text-secondary);
}
.legendDot {
width: 8px;
height: 8px;
border-radius: 50%;
flex-shrink: 0;
}
.legendLabel {
font-size: 12px;
}
/* Axis labels */
.yLabel {
font-size: 12px;
color: var(--text-muted);
writing-mode: vertical-lr;
transform: rotate(180deg);
text-align: center;
position: absolute;
left: 4px;
top: 0;
bottom: 28px;
display: flex;
align-items: center;
justify-content: center;
}
.xLabel {
text-align: center;
font-size: 12px;
color: var(--text-muted);
padding-left: 48px;
}

View File

@@ -1,268 +0,0 @@
import { useState } from 'react'
import styles from './AreaChart.module.css'
import {
computeYScale,
computeXScale,
seriesPoints,
seriesPath,
formatAxisLabel,
CHART_COLORS,
type ChartSeries,
} from '../_chart-utils'
interface Threshold {
value: number
label: string
}
interface AreaChartProps {
series: ChartSeries[]
xLabel?: string
yLabel?: string
threshold?: Threshold
height?: number
width?: number
className?: string
}
const Y_TICK_COUNT = 4
const DIMS = {
paddingTop: 12,
paddingRight: 16,
paddingBottom: 28,
paddingLeft: 48,
}
export function AreaChart({
series,
xLabel,
yLabel,
threshold,
height = 200,
width = 400,
className,
}: AreaChartProps) {
const [tooltip, setTooltip] = useState<{
x: number
y: number
xLabel: string
values: { label: string; value: number; color: string }[]
} | null>(null)
const dims = { ...DIMS, width, height }
const allData = series.flatMap((s) => s.data)
if (allData.length === 0) {
return <div className={`${styles.empty} ${className ?? ''}`}>No data</div>
}
const { max, toY } = computeYScale(series, dims, threshold?.value)
const { toX } = computeXScale(series, dims)
const plotH = height - dims.paddingTop - dims.paddingBottom
const plotW = width - dims.paddingLeft - dims.paddingRight
const bottomY = dims.paddingTop + plotH
// Y-axis ticks
const yTicks = Array.from({ length: Y_TICK_COUNT + 1 }, (_, i) =>
Math.round((max / Y_TICK_COUNT) * i),
)
// X-axis ticks (first, middle, last)
const firstSeries = series[0]
const xSamples =
firstSeries && firstSeries.data.length > 0
? [
firstSeries.data[0].x,
firstSeries.data[Math.floor(firstSeries.data.length / 2)]?.x,
firstSeries.data[firstSeries.data.length - 1].x,
].filter(Boolean)
: []
function handleMouseMove(e: React.MouseEvent<SVGSVGElement>) {
const rect = e.currentTarget.getBoundingClientRect()
const mx = e.clientX - rect.left
const my = e.clientY - rect.top
// Find closest x value
const pctX = (mx - dims.paddingLeft) / plotW
const firstS = series[0]
const idx0 = Math.max(0, Math.min(firstS.data.length - 1, Math.round(pctX * (firstS.data.length - 1))))
const xVal = firstS.data[idx0]?.x
const xLabel = xVal instanceof Date
? xVal.toLocaleString([], { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit', second: '2-digit' })
: typeof xVal === 'number' && xVal > 1e10
? new Date(xVal).toLocaleString([], { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit', second: '2-digit' })
: String(xVal ?? '')
const values = series.map((s, i) => {
const idx = Math.round(pctX * (s.data.length - 1))
const clamped = Math.max(0, Math.min(s.data.length - 1, idx))
const pt = s.data[clamped]
return {
label: s.label,
value: pt?.y ?? 0,
color: s.color ?? CHART_COLORS[i % CHART_COLORS.length],
}
})
setTooltip({ x: mx, y: my, xLabel, values })
}
return (
<div className={`${styles.wrapper} ${className ?? ''}`}>
{yLabel && <div className={styles.yLabel}>{yLabel}</div>}
<svg
width="100%"
height={height}
viewBox={`0 0 ${width} ${height}`}
preserveAspectRatio="none"
className={styles.svg}
onMouseMove={handleMouseMove}
onMouseLeave={() => setTooltip(null)}
aria-label="Area chart"
role="img"
>
{/* Grid lines */}
{yTicks.map((val) => {
const y = toY(val)
return (
<g key={val}>
<line
x1={dims.paddingLeft}
y1={y}
x2={width - dims.paddingRight}
y2={y}
className={styles.gridLine}
/>
<text x={dims.paddingLeft - 6} y={y + 4} className={styles.axisLabel} textAnchor="end">
{formatAxisLabel(val)}
</text>
</g>
)
})}
{/* X-axis labels */}
{xSamples.map((xVal, i) => {
const xPos = toX(xVal)
const xv = xVal instanceof Date ? xVal : new Date(xVal as number)
const label =
xVal instanceof Date || (typeof xVal === 'number' && xVal > 1e10)
? xv.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
: formatAxisLabel(xVal as number)
const anchor = i === 0 ? 'start' : i === xSamples.length - 1 ? 'end' : 'middle'
return (
<text
key={i}
x={xPos}
y={height - dims.paddingBottom + 16}
className={styles.axisLabel}
textAnchor={anchor}
>
{label}
</text>
)
})}
{/* SLA threshold line */}
{threshold && (
<g>
<line
x1={dims.paddingLeft}
y1={toY(threshold.value)}
x2={width - dims.paddingRight}
y2={toY(threshold.value)}
className={styles.thresholdLine}
/>
<text
x={width - dims.paddingRight - 4}
y={toY(threshold.value) - 4}
className={styles.thresholdLabel}
textAnchor="end"
>
{threshold.label}
</text>
</g>
)}
{/* Area fills */}
{series.map((s, i) => {
const color = s.color ?? CHART_COLORS[i % CHART_COLORS.length]
const areaD = seriesPath(s, toX, toY, bottomY)
return (
<path
key={`area-${i}`}
d={areaD}
fill={color}
className={styles.area}
/>
)
})}
{/* Lines */}
{series.map((s, i) => {
const color = s.color ?? CHART_COLORS[i % CHART_COLORS.length]
const pts = seriesPoints(s, toX, toY)
return (
<polyline
key={`line-${i}`}
points={pts}
fill="none"
stroke={color}
className={styles.line}
/>
)
})}
{/* Crosshair */}
{tooltip && (
<line
x1={tooltip.x}
y1={dims.paddingTop}
x2={tooltip.x}
y2={bottomY}
className={styles.crosshair}
/>
)}
</svg>
{/* Tooltip */}
{tooltip && (
<div
className={styles.tooltip}
style={{
left: tooltip.x + 12,
top: tooltip.y,
}}
>
{tooltip.xLabel && (
<div className={styles.tooltipTime}>{tooltip.xLabel}</div>
)}
{tooltip.values.map((v) => (
<div key={v.label} className={styles.tooltipRow}>
<span className={styles.tooltipDot} style={{ background: v.color }} />
<span className={styles.tooltipLabel}>{v.label}:</span>
<span className={styles.tooltipValue}>{formatAxisLabel(v.value)}</span>
</div>
))}
</div>
)}
{/* Legend */}
{series.length > 1 && (
<div className={styles.legend}>
{series.map((s, i) => (
<div key={s.label} className={styles.legendItem}>
<span
className={styles.legendDot}
style={{ background: s.color ?? CHART_COLORS[i % CHART_COLORS.length] }}
/>
<span className={styles.legendLabel}>{s.label}</span>
</div>
))}
</div>
)}
{xLabel && <div className={styles.xLabel}>{xLabel}</div>}
</div>
)
}

View File

@@ -1,144 +0,0 @@
.wrapper {
position: relative;
display: flex;
flex-direction: column;
gap: 4px;
width: 100%;
}
.svg {
display: block;
overflow: visible;
}
.empty {
display: flex;
align-items: center;
justify-content: center;
color: var(--text-muted);
font-size: 12px;
height: 120px;
}
.gridLine {
stroke: var(--border-subtle);
stroke-width: 1;
stroke-dasharray: 3 3;
}
.axisLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--text-faint);
}
.catLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--text-faint);
}
.bar {
cursor: pointer;
transition: opacity 0.1s;
}
.bar:hover {
opacity: 0.8;
}
.tooltip {
position: absolute;
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
padding: 6px 10px;
font-size: 12px;
pointer-events: none;
z-index: 10;
white-space: nowrap;
}
.tooltipTitle {
font-weight: 600;
color: var(--text-primary);
margin-bottom: 4px;
font-size: 12px;
}
.tooltipRow {
display: flex;
align-items: center;
gap: 5px;
margin-bottom: 2px;
}
.tooltipRow:last-child {
margin-bottom: 0;
}
.tooltipDot {
width: 6px;
height: 6px;
border-radius: 50%;
flex-shrink: 0;
}
.tooltipLabel {
color: var(--text-muted);
}
.tooltipValue {
font-family: var(--font-mono);
font-weight: 600;
color: var(--text-primary);
}
.legend {
display: flex;
flex-wrap: wrap;
gap: 12px;
padding-left: 48px;
}
.legendItem {
display: flex;
align-items: center;
gap: 5px;
font-size: 12px;
color: var(--text-secondary);
}
.legendDot {
width: 8px;
height: 8px;
border-radius: 50%;
flex-shrink: 0;
}
.legendLabel {
font-size: 12px;
}
.yLabel {
font-size: 12px;
color: var(--text-muted);
writing-mode: vertical-lr;
transform: rotate(180deg);
text-align: center;
position: absolute;
left: 4px;
top: 0;
bottom: 40px;
display: flex;
align-items: center;
justify-content: center;
}
.xLabel {
text-align: center;
font-size: 12px;
color: var(--text-muted);
padding-left: 48px;
}

View File

@@ -1,242 +0,0 @@
import { useState } from 'react'
import styles from './BarChart.module.css'
import { formatAxisLabel, CHART_COLORS } from '../_chart-utils'
interface BarSeries {
label: string
data: { x: string; y: number }[]
color?: string
}
interface BarChartProps {
series: BarSeries[]
stacked?: boolean
height?: number
width?: number
xLabel?: string
yLabel?: string
className?: string
}
const PADDING = { top: 12, right: 16, bottom: 40, left: 48 }
const Y_TICK_COUNT = 4
const BAR_GAP = 0.2 // fraction of bar group width reserved for gaps
export function BarChart({
series,
stacked = false,
height = 200,
width = 400,
xLabel,
yLabel,
className,
}: BarChartProps) {
const [tooltip, setTooltip] = useState<{
x: number
y: number
label: string
values: { series: string; value: number; color: string }[]
} | null>(null)
if (series.length === 0 || series[0].data.length === 0) {
return <div className={`${styles.empty} ${className ?? ''}`}>No data</div>
}
// Collect all x categories (union across all series)
const categories = Array.from(new Set(series.flatMap((s) => s.data.map((d) => d.x))))
const numCats = categories.length
const plotW = width - PADDING.left - PADDING.right
const plotH = height - PADDING.top - PADDING.bottom
// Compute max Y
let maxY = 0
if (stacked) {
for (const cat of categories) {
const sum = series.reduce((acc, s) => {
const pt = s.data.find((d) => d.x === cat)
return acc + (pt?.y ?? 0)
}, 0)
maxY = Math.max(maxY, sum)
}
} else {
maxY = Math.max(...series.flatMap((s) => s.data.map((d) => d.y)))
}
maxY = maxY || 1
const yTicks = Array.from({ length: Y_TICK_COUNT + 1 }, (_, i) =>
Math.round((maxY / Y_TICK_COUNT) * i),
)
const toY = (val: number) => PADDING.top + plotH - (val / maxY) * plotH
const bottomY = PADDING.top + plotH
const catWidth = plotW / numCats
const groupGap = catWidth * BAR_GAP
const groupW = catWidth - groupGap
function handleMouseEnter(
catLabel: string,
mx: number,
my: number,
values: { series: string; value: number; color: string }[],
) {
setTooltip({ x: mx, y: my, label: catLabel, values })
}
function showBarTooltip(e: React.MouseEvent<SVGRectElement>, cat: string) {
const rect = e.currentTarget.closest('svg')!.getBoundingClientRect()
handleMouseEnter(
cat,
e.clientX - rect.left,
e.clientY - rect.top,
series.map((ss, ssi) => ({
series: ss.label,
value: ss.data.find((d) => d.x === cat)?.y ?? 0,
color: ss.color ?? CHART_COLORS[ssi % CHART_COLORS.length],
})),
)
}
return (
<div className={`${styles.wrapper} ${className ?? ''}`}>
{yLabel && <div className={styles.yLabel}>{yLabel}</div>}
<svg
width="100%"
height={height}
viewBox={`0 0 ${width} ${height}`}
preserveAspectRatio="none"
className={styles.svg}
onMouseLeave={() => setTooltip(null)}
aria-label="Bar chart"
role="img"
>
{/* Grid lines */}
{yTicks.map((val) => {
const y = toY(val)
return (
<g key={val}>
<line
x1={PADDING.left}
y1={y}
x2={width - PADDING.right}
y2={y}
className={styles.gridLine}
/>
<text x={PADDING.left - 6} y={y + 4} className={styles.axisLabel} textAnchor="end">
{formatAxisLabel(val)}
</text>
</g>
)
})}
{/* Bars */}
{categories.map((cat, ci) => {
const groupX = PADDING.left + ci * catWidth + groupGap / 2
if (stacked) {
let stackY = bottomY
return (
<g key={cat}>
{series.map((s, si) => {
const pt = s.data.find((d) => d.x === cat)
const val = pt?.y ?? 0
const barH = (val / maxY) * plotH
const color = s.color ?? CHART_COLORS[si % CHART_COLORS.length]
const y = stackY - barH
stackY -= barH
return (
<rect
key={si}
x={groupX}
y={y}
width={groupW}
height={barH}
fill={color}
className={styles.bar}
onMouseEnter={(e) => showBarTooltip(e, cat)}
/>
)
})}
<text
x={groupX + groupW / 2}
y={bottomY + 14}
className={styles.catLabel}
textAnchor="middle"
>
{cat}
</text>
</g>
)
}
// Grouped
const barW = groupW / series.length
return (
<g key={cat}>
{series.map((s, si) => {
const pt = s.data.find((d) => d.x === cat)
const val = pt?.y ?? 0
const barH = (val / maxY) * plotH
const color = s.color ?? CHART_COLORS[si % CHART_COLORS.length]
return (
<rect
key={si}
x={groupX + si * barW}
y={toY(val)}
width={barW - 1}
height={barH}
fill={color}
className={styles.bar}
onMouseEnter={(e) => showBarTooltip(e, cat)}
/>
)
})}
<text
x={groupX + groupW / 2}
y={bottomY + 14}
className={styles.catLabel}
textAnchor="middle"
>
{cat}
</text>
</g>
)
})}
</svg>
{/* Tooltip */}
{tooltip && (
<div
className={styles.tooltip}
style={{ left: tooltip.x + 12, top: tooltip.y }}
>
<div className={styles.tooltipTitle}>{tooltip.label}</div>
{tooltip.values.map((v) => (
<div key={v.series} className={styles.tooltipRow}>
<span className={styles.tooltipDot} style={{ background: v.color }} />
<span className={styles.tooltipLabel}>{v.series}:</span>
<span className={styles.tooltipValue}>{formatAxisLabel(v.value)}</span>
</div>
))}
</div>
)}
{/* Legend */}
{series.length > 1 && (
<div className={styles.legend}>
{series.map((s, i) => (
<div key={s.label} className={styles.legendItem}>
<span
className={styles.legendDot}
style={{ background: s.color ?? CHART_COLORS[i % CHART_COLORS.length] }}
/>
<span className={styles.legendLabel}>{s.label}</span>
</div>
))}
</div>
)}
{xLabel && <div className={styles.xLabel}>{xLabel}</div>}
</div>
)
}

View File

@@ -1,156 +0,0 @@
.wrapper {
position: relative;
display: flex;
flex-direction: column;
gap: 4px;
width: 100%;
}
.svg {
display: block;
overflow: visible;
}
.empty {
display: flex;
align-items: center;
justify-content: center;
color: var(--text-muted);
font-size: 12px;
height: 120px;
}
.gridLine {
stroke: var(--border-subtle);
stroke-width: 1;
stroke-dasharray: 3 3;
}
.axisLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--text-faint);
}
.thresholdLine {
stroke: var(--error);
stroke-width: 1.5;
stroke-dasharray: 5 3;
}
.thresholdLabel {
font-family: var(--font-mono);
font-size: 9px;
fill: var(--error);
}
.line {
stroke-width: 2;
stroke-linecap: round;
stroke-linejoin: round;
}
.crosshair {
stroke: var(--text-faint);
stroke-width: 1;
stroke-dasharray: 3 3;
pointer-events: none;
}
.tooltip {
position: absolute;
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
padding: 6px 10px;
font-size: 12px;
pointer-events: none;
z-index: 10;
white-space: nowrap;
}
.tooltipTime {
font-family: var(--font-mono);
font-size: 10px;
color: var(--text-muted);
margin-bottom: 4px;
padding-bottom: 3px;
border-bottom: 1px solid var(--border-subtle);
}
.tooltipRow {
display: flex;
align-items: center;
gap: 5px;
margin-bottom: 2px;
}
.tooltipRow:last-child {
margin-bottom: 0;
}
.tooltipDot {
width: 6px;
height: 6px;
border-radius: 50%;
flex-shrink: 0;
}
.tooltipLabel {
color: var(--text-muted);
}
.tooltipValue {
font-family: var(--font-mono);
font-weight: 600;
color: var(--text-primary);
}
.legend {
display: flex;
flex-wrap: wrap;
gap: 12px;
padding-left: 48px;
}
.legendItem {
display: flex;
align-items: center;
gap: 5px;
font-size: 12px;
color: var(--text-secondary);
}
.legendDot {
width: 8px;
height: 8px;
border-radius: 50%;
flex-shrink: 0;
}
.legendLabel {
font-size: 12px;
}
.yLabel {
font-size: 12px;
color: var(--text-muted);
writing-mode: vertical-lr;
transform: rotate(180deg);
text-align: center;
position: absolute;
left: 4px;
top: 0;
bottom: 28px;
display: flex;
align-items: center;
justify-content: center;
}
.xLabel {
text-align: center;
font-size: 12px;
color: var(--text-muted);
padding-left: 48px;
}

View File

@@ -1,247 +0,0 @@
import { useState } from 'react'
import styles from './LineChart.module.css'
import {
computeYScale,
computeXScale,
seriesPoints,
formatAxisLabel,
CHART_COLORS,
type ChartSeries,
} from '../_chart-utils'
interface Threshold {
value: number
label: string
}
interface LineChartProps {
series: ChartSeries[]
xLabel?: string
yLabel?: string
threshold?: Threshold
height?: number
width?: number
className?: string
}
const Y_TICK_COUNT = 4
const DIMS = {
paddingTop: 12,
paddingRight: 16,
paddingBottom: 28,
paddingLeft: 48,
}
export function LineChart({
series,
xLabel,
yLabel,
threshold,
height = 200,
width = 400,
className,
}: LineChartProps) {
const [tooltip, setTooltip] = useState<{
x: number
y: number
xLabel: string
values: { label: string; value: number; color: string }[]
} | null>(null)
const dims = { ...DIMS, width, height }
const allData = series.flatMap((s) => s.data)
if (allData.length === 0) {
return <div className={`${styles.empty} ${className ?? ''}`}>No data</div>
}
const { max, toY } = computeYScale(series, dims, threshold?.value)
const { toX } = computeXScale(series, dims)
const plotH = height - dims.paddingTop - dims.paddingBottom
const plotW = width - dims.paddingLeft - dims.paddingRight
const bottomY = dims.paddingTop + plotH
const yTicks = Array.from({ length: Y_TICK_COUNT + 1 }, (_, i) =>
Math.round((max / Y_TICK_COUNT) * i),
)
const firstSeries = series[0]
const xSamples =
firstSeries && firstSeries.data.length > 0
? [
firstSeries.data[0].x,
firstSeries.data[Math.floor(firstSeries.data.length / 2)]?.x,
firstSeries.data[firstSeries.data.length - 1].x,
].filter(Boolean)
: []
function handleMouseMove(e: React.MouseEvent<SVGSVGElement>) {
const rect = e.currentTarget.getBoundingClientRect()
const mx = e.clientX - rect.left
const my = e.clientY - rect.top
const pctX = (mx - dims.paddingLeft) / plotW
const firstS = series[0]
const idx0 = Math.max(0, Math.min(firstS.data.length - 1, Math.round(pctX * (firstS.data.length - 1))))
const xVal = firstS.data[idx0]?.x
const xLabel = xVal instanceof Date
? xVal.toLocaleString([], { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit', second: '2-digit' })
: typeof xVal === 'number' && xVal > 1e10
? new Date(xVal).toLocaleString([], { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit', second: '2-digit' })
: String(xVal ?? '')
const values = series.map((s, i) => {
const idx = Math.round(pctX * (s.data.length - 1))
const clamped = Math.max(0, Math.min(s.data.length - 1, idx))
const pt = s.data[clamped]
return {
label: s.label,
value: pt?.y ?? 0,
color: s.color ?? CHART_COLORS[i % CHART_COLORS.length],
}
})
setTooltip({ x: mx, y: my, xLabel, values })
}
return (
<div className={`${styles.wrapper} ${className ?? ''}`}>
{yLabel && <div className={styles.yLabel}>{yLabel}</div>}
<svg
width="100%"
height={height}
viewBox={`0 0 ${width} ${height}`}
preserveAspectRatio="none"
className={styles.svg}
onMouseMove={handleMouseMove}
onMouseLeave={() => setTooltip(null)}
aria-label="Line chart"
role="img"
>
{/* Grid lines */}
{yTicks.map((val) => {
const y = toY(val)
return (
<g key={val}>
<line
x1={dims.paddingLeft}
y1={y}
x2={width - dims.paddingRight}
y2={y}
className={styles.gridLine}
/>
<text x={dims.paddingLeft - 6} y={y + 4} className={styles.axisLabel} textAnchor="end">
{formatAxisLabel(val)}
</text>
</g>
)
})}
{/* X-axis labels */}
{xSamples.map((xVal, i) => {
const xPos = toX(xVal)
const xv = xVal instanceof Date ? xVal : new Date(xVal as number)
const label =
xVal instanceof Date || (typeof xVal === 'number' && xVal > 1e10)
? xv.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
: formatAxisLabel(xVal as number)
const anchor = i === 0 ? 'start' : i === xSamples.length - 1 ? 'end' : 'middle'
return (
<text
key={i}
x={xPos}
y={height - dims.paddingBottom + 16}
className={styles.axisLabel}
textAnchor={anchor}
>
{label}
</text>
)
})}
{/* Threshold line */}
{threshold && (
<g>
<line
x1={dims.paddingLeft}
y1={toY(threshold.value)}
x2={width - dims.paddingRight}
y2={toY(threshold.value)}
className={styles.thresholdLine}
/>
<text
x={width - dims.paddingRight - 4}
y={toY(threshold.value) - 4}
className={styles.thresholdLabel}
textAnchor="end"
>
{threshold.label}
</text>
</g>
)}
{/* Lines only (no area fill) */}
{series.map((s, i) => {
const color = s.color ?? CHART_COLORS[i % CHART_COLORS.length]
const pts = seriesPoints(s, toX, toY)
return (
<polyline
key={`line-${i}`}
points={pts}
fill="none"
stroke={color}
className={styles.line}
/>
)
})}
{/* Crosshair */}
{tooltip && (
<line
x1={tooltip.x}
y1={dims.paddingTop}
x2={tooltip.x}
y2={bottomY}
className={styles.crosshair}
/>
)}
</svg>
{/* Tooltip */}
{tooltip && (
<div
className={styles.tooltip}
style={{ left: tooltip.x + 12, top: tooltip.y }}
>
{tooltip.xLabel && (
<div className={styles.tooltipTime}>{tooltip.xLabel}</div>
)}
{tooltip.values.map((v) => (
<div key={v.label} className={styles.tooltipRow}>
<span className={styles.tooltipDot} style={{ background: v.color }} />
<span className={styles.tooltipLabel}>{v.label}:</span>
<span className={styles.tooltipValue}>{formatAxisLabel(v.value)}</span>
</div>
))}
</div>
)}
{/* Legend */}
{series.length > 1 && (
<div className={styles.legend}>
{series.map((s, i) => (
<div key={s.label} className={styles.legendItem}>
<span
className={styles.legendDot}
style={{ background: s.color ?? CHART_COLORS[i % CHART_COLORS.length] }}
/>
<span className={styles.legendLabel}>{s.label}</span>
</div>
))}
</div>
)}
{xLabel && <div className={styles.xLabel}>{xLabel}</div>}
</div>
)
}

View File

@@ -61,6 +61,38 @@
background: color-mix(in srgb, var(--text-faint) 8%, transparent);
}
.sourceBadge {
flex-shrink: 0;
font-size: 9px;
font-family: var(--font-mono);
padding: 1px 6px;
border-radius: 3px;
line-height: 1.5;
white-space: nowrap;
min-width: 48px;
text-align: center;
}
.sourceContainer {
color: var(--text-muted);
background: color-mix(in srgb, var(--text-muted) 10%, transparent);
}
.sourceApp {
color: var(--running);
background: color-mix(in srgb, var(--running) 10%, transparent);
}
.sourceAgent {
color: var(--warning);
background: color-mix(in srgb, var(--warning) 10%, transparent);
}
.sourceDefault {
color: var(--text-muted);
background: color-mix(in srgb, var(--text-muted) 8%, transparent);
}
.message {
font-size: 12px;
font-family: var(--font-mono);

View File

@@ -3,9 +3,9 @@ import { render, screen } from '@testing-library/react'
import { LogViewer, type LogEntry } from './LogViewer'
const entries: LogEntry[] = [
{ timestamp: '2024-01-15T10:30:00Z', level: 'info', message: 'Server started' },
{ timestamp: '2024-01-15T10:30:05Z', level: 'warn', message: 'High memory usage' },
{ timestamp: '2024-01-15T10:30:10Z', level: 'error', message: 'Connection failed' },
{ timestamp: '2024-01-15T10:30:00Z', level: 'info', message: 'Server started', source: 'app' },
{ timestamp: '2024-01-15T10:30:05Z', level: 'warn', message: 'High memory usage', source: 'container' },
{ timestamp: '2024-01-15T10:30:10Z', level: 'error', message: 'Connection failed', source: 'agent' },
{ timestamp: '2024-01-15T10:30:15Z', level: 'debug', message: 'Query executed in 3ms' },
{ timestamp: '2024-01-15T10:30:20Z', level: 'trace', message: 'Entering handleRequest()' },
]
@@ -52,6 +52,23 @@ describe('LogViewer', () => {
expect(el.classList.contains('custom-class')).toBe(true)
})
it('renders source badges when source is provided', () => {
render(<LogViewer entries={entries} />)
expect(screen.getByText('app')).toBeInTheDocument()
expect(screen.getByText('container')).toBeInTheDocument()
expect(screen.getByText('agent')).toBeInTheDocument()
})
it('omits source badge when source is not provided', () => {
const noSourceEntries: LogEntry[] = [
{ timestamp: '2024-01-15T10:30:00Z', level: 'info', message: 'No source here' },
]
render(<LogViewer entries={noSourceEntries} />)
expect(screen.getByText('No source here')).toBeInTheDocument()
expect(screen.queryByText('app')).not.toBeInTheDocument()
expect(screen.queryByText('container')).not.toBeInTheDocument()
})
it('has role="log" for accessibility', () => {
render(<LogViewer entries={entries} />)
expect(screen.getByRole('log')).toBeInTheDocument()

View File

@@ -5,6 +5,7 @@ export interface LogEntry {
timestamp: string
level: 'info' | 'warn' | 'error' | 'debug' | 'trace'
message: string
source?: string
}
export interface LogViewerProps {
@@ -21,6 +22,12 @@ const LEVEL_CLASS: Record<LogEntry['level'], string> = {
trace: styles.levelTrace,
}
const SOURCE_CLASS: Record<string, string> = {
container: styles.sourceContainer,
app: styles.sourceApp,
agent: styles.sourceAgent,
}
function formatTime(iso: string): string {
try {
return new Date(iso).toLocaleTimeString('en-GB', {
@@ -67,6 +74,11 @@ export function LogViewer({ entries, maxHeight = 400, className }: LogViewerProp
<span className={[styles.levelBadge, LEVEL_CLASS[entry.level]].join(' ')}>
{entry.level.toUpperCase()}
</span>
{entry.source && (
<span className={[styles.sourceBadge, SOURCE_CLASS[entry.source] ?? styles.sourceDefault].join(' ')}>
{entry.source}
</span>
)}
<span className={styles.message}>{entry.message}</span>
</div>
))}

View File

@@ -0,0 +1,47 @@
.tooltip {
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
padding: 6px 10px;
font-size: 12px;
}
.time {
font-family: var(--font-mono);
font-size: 10px;
color: var(--text-muted);
margin-bottom: 4px;
padding-bottom: 3px;
border-bottom: 1px solid var(--border-subtle);
}
.row {
display: flex;
align-items: center;
gap: 5px;
margin-bottom: 2px;
}
.row:last-child {
margin-bottom: 0;
}
.dot {
width: 6px;
height: 6px;
border-radius: 50%;
flex-shrink: 0;
}
.label {
color: var(--text-muted);
font-size: 11px;
}
.value {
font-family: var(--font-mono);
font-weight: 600;
font-size: 11px;
color: var(--text-primary);
}

View File

@@ -0,0 +1,41 @@
import type { TooltipProps } from 'recharts'
import styles from './ChartTooltip.module.css'
function formatValue(val: number): string {
if (val >= 1_000_000) return `${(val / 1_000_000).toFixed(1)}M`
if (val >= 1000) return `${(val / 1000).toFixed(1)}k`
if (Number.isInteger(val)) return String(val)
return val.toFixed(1)
}
function formatTimestamp(val: unknown): string | null {
if (val == null) return null
const str = String(val)
const ms = typeof val === 'number' && val > 1e12 ? val
: typeof val === 'number' && val > 1e9 ? val * 1000
: Date.parse(str)
if (isNaN(ms)) return str
return new Date(ms).toLocaleString([], {
month: 'short', day: 'numeric',
hour: '2-digit', minute: '2-digit', second: '2-digit',
})
}
export function ChartTooltip({ active, payload, label }: TooltipProps<number, string>) {
if (!active || !payload?.length) return null
const timeLabel = formatTimestamp(label)
return (
<div className={styles.tooltip}>
{timeLabel && <div className={styles.time}>{timeLabel}</div>}
{payload.map((entry) => (
<div key={entry.dataKey as string} className={styles.row}>
<span className={styles.dot} style={{ background: entry.color }} />
<span className={styles.label}>{entry.name}:</span>
<span className={styles.value}>{formatValue(entry.value as number)}</span>
</div>
))}
</div>
)
}

View File

@@ -0,0 +1,46 @@
import { describe, it, expect } from 'vitest'
import { render } from '@testing-library/react'
import { ThemedChart } from './ThemedChart'
import { Line } from 'recharts'
// Recharts uses ResizeObserver internally
class ResizeObserverMock {
observe() {}
unobserve() {}
disconnect() {}
}
globalThis.ResizeObserver = ResizeObserverMock as any
describe('ThemedChart', () => {
it('renders nothing when data is empty', () => {
const { container } = render(
<ThemedChart data={[]}>
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.innerHTML).toBe('')
})
it('renders a chart container when data is provided', () => {
const data = [
{ time: '10:00', value: 10 },
{ time: '10:01', value: 20 },
]
const { container } = render(
<ThemedChart data={data} height={160}>
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.querySelector('.recharts-responsive-container')).toBeTruthy()
})
it('applies custom className', () => {
const data = [{ time: '10:00', value: 5 }]
const { container } = render(
<ThemedChart data={data} className="my-chart">
<Line dataKey="value" />
</ThemedChart>,
)
expect(container.querySelector('.my-chart')).toBeTruthy()
})
})

View File

@@ -0,0 +1,74 @@
import {
ResponsiveContainer,
ComposedChart,
CartesianGrid,
XAxis,
YAxis,
Tooltip,
} from 'recharts'
import { rechartsTheme } from '../../utils/rechartsTheme'
import { ChartTooltip } from './ChartTooltip'
interface ThemedChartProps {
data: Record<string, any>[]
height?: number
xDataKey?: string
xType?: 'number' | 'category'
xTickFormatter?: (value: any) => string
yTickFormatter?: (value: any) => string
yLabel?: string
children: React.ReactNode
className?: string
}
export function ThemedChart({
data,
height = 200,
xDataKey = 'time',
xType = 'category',
xTickFormatter,
yTickFormatter,
yLabel,
children,
className,
}: ThemedChartProps) {
if (!data.length) {
return null
}
// Show ~5-6 ticks max to avoid label overlap
const maxTicks = 6
const tickInterval = data.length > maxTicks
? Math.ceil(data.length / maxTicks) - 1
: 0
return (
<div className={className} style={{ width: '100%', height }}>
<ResponsiveContainer width="100%" height="100%">
<ComposedChart data={data} margin={{ top: 4, right: 8, bottom: 0, left: 0 }}>
<CartesianGrid {...rechartsTheme.cartesianGrid} />
<XAxis
dataKey={xDataKey}
type={xType}
{...rechartsTheme.xAxis}
tickFormatter={xTickFormatter}
interval={tickInterval}
minTickGap={40}
/>
<YAxis
{...rechartsTheme.yAxis}
tickFormatter={yTickFormatter}
label={yLabel ? {
value: yLabel,
angle: -90,
position: 'insideLeft',
style: { fontSize: 11, fill: 'var(--text-muted)' },
} : undefined}
/>
<Tooltip content={<ChartTooltip />} cursor={rechartsTheme.tooltip.cursor} />
{children}
</ComposedChart>
</ResponsiveContainer>
</div>
)
}

View File

@@ -1,101 +0,0 @@
export interface DataPoint {
x: number | Date
y: number
}
export interface ChartSeries {
label: string
data: DataPoint[]
color?: string
}
export interface ChartDimensions {
width: number
height: number
paddingTop: number
paddingRight: number
paddingBottom: number
paddingLeft: number
}
export function computeYScale(
series: ChartSeries[],
dims: ChartDimensions,
threshold?: number,
) {
const allY = series.flatMap((s) => s.data.map((d) => d.y))
if (threshold != null) allY.push(threshold)
const min = 0
const max = Math.max(...allY, 1)
const range = max - min
const plotH = dims.height - dims.paddingTop - dims.paddingBottom
const toY = (val: number) => dims.paddingTop + plotH - ((val - min) / range) * plotH
return { min, max, range, toY }
}
export function computeXScale(series: ChartSeries[], dims: ChartDimensions) {
const allX = series.flatMap((s) =>
s.data.map((d) => (d.x instanceof Date ? d.x.getTime() : d.x)),
)
const minX = Math.min(...allX)
const maxX = Math.max(...allX)
const rangeX = maxX - minX || 1
const plotW = dims.width - dims.paddingLeft - dims.paddingRight
const toX = (val: number | Date) => {
const v = val instanceof Date ? val.getTime() : val
return dims.paddingLeft + ((v - minX) / rangeX) * plotW
}
return { minX, maxX, rangeX, toX }
}
export function seriesPoints(
series: ChartSeries,
toX: (v: number | Date) => number,
toY: (v: number) => number,
): string {
return series.data.map((d) => `${toX(d.x).toFixed(1)},${toY(d.y).toFixed(1)}`).join(' ')
}
export function seriesPath(
series: ChartSeries,
toX: (v: number | Date) => number,
toY: (v: number) => number,
bottomY: number,
): string {
if (series.data.length === 0) return ''
const pts = series.data.map((d) => `${toX(d.x).toFixed(1)},${toY(d.y).toFixed(1)}`)
const firstX = toX(series.data[0].x).toFixed(1)
const lastX = toX(series.data[series.data.length - 1].x).toFixed(1)
return `M${pts.join(' L')} L${lastX},${bottomY} L${firstX},${bottomY} Z`
}
export function formatAxisLabel(val: number): string {
if (val >= 1_000_000) return `${(val / 1_000_000).toFixed(1)}M`
if (val >= 1000) return `${(val / 1000).toFixed(1)}k`
if (Number.isInteger(val)) return String(val)
return val.toFixed(1)
}
export function formatXLabel(val: number | Date, _totalPoints: number): string {
if (val instanceof Date || (typeof val === 'number' && val > 1e10)) {
const d = val instanceof Date ? val : new Date(val)
return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
}
return formatAxisLabel(val as number)
}
// Default color tokens for series (fallback when no color given)
export const CHART_COLORS = [
'var(--chart-1)',
'var(--chart-2)',
'var(--chart-3)',
'var(--chart-4)',
'var(--chart-5)',
'var(--chart-6)',
'var(--chart-7)',
'var(--chart-8)',
]

View File

@@ -1,8 +1,6 @@
export { Accordion } from './Accordion/Accordion'
export { AlertDialog } from './AlertDialog/AlertDialog'
export { AreaChart } from './AreaChart/AreaChart'
export { AvatarGroup } from './AvatarGroup/AvatarGroup'
export { BarChart } from './BarChart/BarChart'
export { Breadcrumb } from './Breadcrumb/Breadcrumb'
export { CommandPalette } from './CommandPalette/CommandPalette'
export type { SearchResult, SearchCategory, ScopeFilter } from './CommandPalette/types'
@@ -20,7 +18,6 @@ export { KpiStrip } from './KpiStrip/KpiStrip'
export type { KpiItem, KpiStripProps } from './KpiStrip/KpiStrip'
export type { FeedEvent } from './EventFeed/EventFeed'
export { FilterBar } from './FilterBar/FilterBar'
export { LineChart } from './LineChart/LineChart'
export { LogViewer } from './LogViewer/LogViewer'
export type { LogEntry, LogViewerProps } from './LogViewer/LogViewer'
export { LoginDialog } from './LoginForm/LoginDialog'
@@ -43,6 +40,11 @@ export { Tabs } from './Tabs/Tabs'
export { ToastProvider, useToast } from './Toast/Toast'
export { TreeView } from './TreeView/TreeView'
// Chart utilities for consumers using Recharts or custom charts
export { CHART_COLORS } from './_chart-utils'
export type { ChartSeries, DataPoint } from './_chart-utils'
// Charts — ThemedChart wrapper + Recharts re-exports
export { ThemedChart } from './ThemedChart/ThemedChart'
export { CHART_COLORS, rechartsTheme } from '../utils/rechartsTheme'
export {
Line, Area, Bar,
ReferenceLine, ReferenceArea,
Legend, Brush,
} from 'recharts'

View File

@@ -11,4 +11,4 @@ export { BreadcrumbProvider, useBreadcrumb } from './providers/BreadcrumbProvide
export type { BreadcrumbItem } from './providers/BreadcrumbProvider'
export * from './utils/hashColor'
export * from './utils/timePresets'
export * from './utils/rechartsTheme'

View File

@@ -1,22 +1,18 @@
import { CHART_COLORS } from '../composites/_chart-utils'
export const CHART_COLORS = [
'var(--chart-1)',
'var(--chart-2)',
'var(--chart-3)',
'var(--chart-4)',
'var(--chart-5)',
'var(--chart-6)',
'var(--chart-7)',
'var(--chart-8)',
]
/**
* Pre-configured Recharts prop objects that match the design system's
* chart styling. Spread these onto Recharts sub-components:
*
* ```tsx
* import { rechartsTheme, CHART_COLORS } from '@cameleer/design-system'
* import { LineChart, Line, CartesianGrid, XAxis, YAxis, Tooltip, Legend } from 'recharts'
*
* <LineChart data={data}>
* <CartesianGrid {...rechartsTheme.cartesianGrid} />
* <XAxis dataKey="name" {...rechartsTheme.xAxis} />
* <YAxis {...rechartsTheme.yAxis} />
* <Tooltip {...rechartsTheme.tooltip} />
* <Legend {...rechartsTheme.legend} />
* <Line stroke={CHART_COLORS[0]} strokeWidth={2} dot={false} />
* </LineChart>
* ```
* chart styling. Used internally by ThemedChart and available for
* consumers composing Recharts directly.
*/
export const rechartsTheme = {
colors: CHART_COLORS,