ui/chart-strip.tsx
GitHub'use client';
import {useRef, useState} from 'react';
import {cva, type VariantProps} from 'class-variance-authority';
import {CHART_EMPTY, EMPTY_VALUE} from '../lib/data';
import {cn} from '../lib/utils';
import {ChartDataTable, ChartTooltip, ChartTooltipContent, ChartTooltipRow, useElementWidth, useRovingPoints, type ChartStatus} from './chart-parts';
import {StatusMark} from './status';
const sparklineVariants = cva('relative inline-block min-w-0 align-middle', {
variants: {
size: {
sm: 'h-4',
default: 'h-(--control-sm)',
lg: 'h-(--control-lg)',
},
},
defaultVariants: {size: 'default'},
});
const statusText: Record<ChartStatus, string> = {ok: 'text-ok', warn: 'text-warn', fail: 'text-fail'};
type SparklineProps = Omit<React.ComponentProps<'div'>, 'children'> & VariantProps<typeof sparklineVariants> & {
data: (number | null)[];
label: string;
status?: ChartStatus;
variant?: 'line' | 'bar';
area?: boolean;
end?: boolean;
labels?: string[];
valueFormat?: (value: number) => string;
interactive?: boolean;
};
const VIEW_H = 100;
const PAD = 8;
function trendWords(values: number[], format: (v: number) => string) {
if (!values.length) return 'no data';
const first = values[0], last = values[values.length - 1];
const direction = last > first ? 'up' : last < first ? 'down' : 'flat';
return `${direction} from ${format(first)} to ${format(last)}, low ${format(Math.min(...values))}, high ${format(Math.max(...values))}`;
}
function Sparkline({data, label, status, variant = 'line', area, end = variant === 'line', labels, valueFormat = v => v.toLocaleString('en-US'), interactive, size = 'default', className, ...props}: SparklineProps) {
const values = data.filter((v): v is number => v !== null && Number.isFinite(v));
const n = data.length;
const lo = variant === 'bar' ? Math.min(0, ...values) : Math.min(...values);
const hi = Math.max(...values, lo + 1);
const viewW = Math.max(n - 1, 1) * 10;
const y = (v: number) => PAD + (1 - (v - lo) / (hi - lo || 1)) * (VIEW_H - PAD * 2);
const x = (i: number) => variant === 'bar' ? (i + 0.5) * (viewW / n) : n === 1 ? viewW / 2 : (i / (n - 1)) * viewW;
const nameAt = (i: number) => labels?.[i] ?? `Point ${i + 1}`;
const segments: {x: number; y: number}[][] = [];
let run: {x: number; y: number}[] = [];
data.forEach((v, i) => {
if (v === null || !Number.isFinite(v)) { if (run.length) segments.push(run); run = []; return; }
run.push({x: x(i), y: y(v)});
});
if (run.length) segments.push(run);
const lastIndex = data.findLastIndex(v => v !== null && Number.isFinite(v));
const svgRef = useRef<SVGSVGElement>(null);
const [active, setActive] = useState<number | null>(null);
const [anchor, setAnchor] = useState<{x: number; y: number} | null>(null);
const show = (i: number) => {
setActive(i);
const svg = svgRef.current;
const rect = svg?.getBoundingClientRect();
const v = data[i];
if (!svg || !rect) return;
const along = (x(i) / viewW) * rect.width;
const rtl = getComputedStyle(svg).direction === 'rtl';
setAnchor({x: rtl ? rect.right - along : rect.left + along, y: rect.top + ((v === null ? VIEW_H : y(v)) / VIEW_H) * rect.height});
};
const hide = () => { setActive(null); setAnchor(null); };
const roving = useRovingPoints(n, i => show(i));
const pct = (px: number, total: number) => `${(px / total) * 100}%`;
const tone = status ? statusText[status] : 'text-text-1';
return <div data-slot="sparkline" data-status={status} data-variant={variant} className={cn(sparklineVariants({size}), 'w-24', tone, className)} {...props}>
<ChartDataTable
caption={`${label}: ${trendWords(values, valueFormat)}`}
empty={CHART_EMPTY}
rowHeader="Point"
columns={[{key: 'v', label}]}
rows={data.map((v, i) => ({key: String(i), label: nameAt(i), values: {v: v === null ? EMPTY_VALUE : valueFormat(v)}}))}
/>
<svg ref={svgRef} aria-hidden viewBox={`0 0 ${viewW} ${VIEW_H}`} preserveAspectRatio="none" className="block size-full overflow-visible rtl:-scale-x-100">
{variant === 'bar'
? data.map((v, i) => v !== null && Number.isFinite(v) && <rect key={i} x={x(i) - (viewW / n) * 0.32} width={(viewW / n) * 0.64} y={Math.min(y(v), y(0))} height={Math.max(Math.abs(y(0) - y(v)), 2)} className={cn('fill-current transition-opacity duration-(--dur-state)', active !== null && active !== i && 'opacity-(--stale)')}/>)
: <>
{area && segments.map((pts, i) => pts.length > 1 && <path key={`a${i}`} d={`M${pts[0].x},${VIEW_H}${pts.map(p => `L${p.x},${p.y}`).join('')}L${pts[pts.length - 1].x},${VIEW_H}Z`} className="fill-hover"/>)}
{segments.map((pts, i) => pts.length === 1 && <path key={`d${i}`} d={`M${pts[0].x},${pts[0].y}h0`} fill="none" vectorEffect="non-scaling-stroke" strokeLinecap="round" strokeWidth={4} className="stroke-current"/>)}
{segments.map((pts, i) => pts.length > 1 && <path key={i} d={pts.map((p, j) => `${j ? 'L' : 'M'}${p.x},${p.y}`).join('')} fill="none" vectorEffect="non-scaling-stroke" strokeLinejoin="round" strokeLinecap="round" strokeWidth={size === 'sm' ? 1 : 1.5} className="stroke-current forced-colors:stroke-[CanvasText]"/>)}
</>}
</svg>
{variant === 'line' && (active ?? (end ? lastIndex : -1)) >= 0 && (() => {
const i = active ?? lastIndex;
const v = data[i];
if (v === null || !Number.isFinite(v)) return null;
return <span aria-hidden data-slot="sparkline-end" className="pointer-events-none absolute size-1.5 -translate-x-1/2 -translate-y-1/2 bg-current rtl:translate-x-1/2" style={{insetInlineStart: pct(x(i), viewW), top: pct(y(v), VIEW_H)}}/>;
})()}
{interactive && n > 0 && <>
<span role="group" aria-label={label} aria-roledescription="chart" className="absolute inset-0 flex" onPointerLeave={hide}>
{data.map((v, i) => <button
key={i}
ref={roving.ref(i)}
type="button"
tabIndex={roving.tabIndex(i)}
aria-label={`${nameAt(i)}: ${v === null ? 'no data' : valueFormat(v)}`}
onPointerEnter={() => { roving.setCurrent(i); show(i); }}
onFocus={() => { roving.setCurrent(i); show(i); }}
onBlur={event => { if (!event.currentTarget.parentElement?.contains(event.relatedTarget as Node)) hide(); }}
onKeyDown={event => { if (event.key === 'Escape') hide(); else roving.onKeyDown(event, i); }}
className="h-full min-w-0 flex-1 rounded-tag focus-visible:focus-ring-inset"
/>)}
</span>
<ChartTooltip anchor={active !== null ? anchor : null}>
{active !== null && <ChartTooltipContent title={nameAt(active)}>
<ChartTooltipRow label={label} value={data[active] === null ? EMPTY_VALUE : valueFormat(data[active]!)}/>
</ChartTooltipContent>}
</ChartTooltip>
</>}
</div>;
}
type StatusBarBucket = {
label: string;
count: number;
status?: ChartStatus;
issues?: number;
description?: string;
};
const statusBarVariants = cva('flex w-full min-w-0', {
variants: {
size: {
sm: 'h-4',
default: 'h-(--control-sm)',
lg: 'h-(--control)',
},
},
defaultVariants: {size: 'default'},
});
type StatusBarProps = Omit<React.ComponentProps<'div'>, 'children'> & VariantProps<typeof statusBarVariants> & {
data: StatusBarBucket[];
label: string;
unit?: [string, string];
range?: [React.ReactNode, React.ReactNode] | false;
onBucketClick?: (bucket: StatusBarBucket, index: number) => void;
};
const statusWords = {ok: 'Passed', warn: 'Warning', fail: 'Failed'} as const;
const cellTone = {quiet: 'bg-field', ok: 'bg-line-strong', warn: 'bg-warn', fail: 'bg-fail'} as const;
function StatusBar({data, label, unit = ['run', 'runs'], range, onBucketClick, size = 'default', className, ...props}: StatusBarProps) {
const ref = useRef<HTMLDivElement>(null);
const [active, setActive] = useState<number | null>(null);
const [anchor, setAnchor] = useState<{x: number; y: number} | null>(null);
const cells = useRef<(HTMLElement | null)[]>([]);
const show = (i: number, el?: HTMLElement | null) => {
setActive(i);
const rect = (el ?? cells.current[i])?.getBoundingClientRect();
if (rect) setAnchor({x: rect.left + rect.width / 2, y: rect.top});
};
const hide = () => { setActive(null); setAnchor(null); };
const roving = useRovingPoints(data.length, (i, el) => show(i, el));
const noun = (n: number) => `${n.toLocaleString('en-US')} ${n === 1 ? unit[0] : unit[1]}`;
const describe = (b: StatusBarBucket) => {
if (b.description) return b.description;
const parts = [b.count ? noun(b.count) : `No ${unit[1]}`];
if (b.status && b.status !== 'ok') parts.push(`${b.issues ?? ''} ${b.status === 'fail' ? 'failed' : 'with warnings'}`.trim());
return parts.join(', ');
};
const ends = range === false ? null : range ?? [data[0]?.label, data[data.length - 1]?.label];
const [stripRef, stripWidth] = useElementWidth<HTMLDivElement>();
const gapPx = data.length > 60 ? 1 : 2;
const avail = stripWidth - gapPx * (data.length - 1);
const cellWidth = (i: number) => (stripWidth && avail >= data.length ? Math.floor(((i + 1) * avail) / data.length) - Math.floor((i * avail) / data.length) : undefined);
return <div ref={ref} data-slot="status-bar" className={cn('flex w-full min-w-0 flex-col gap-1.5', className)} {...props}>
<ChartDataTable
caption={label}
rowHeader="Bucket"
columns={[{key: 'count', label: unit[1][0].toUpperCase() + unit[1].slice(1)}, {key: 'status', label: 'Status'}]}
rows={data.map((b, i) => ({key: String(i), label: b.label, values: {count: b.count.toLocaleString('en-US'), status: b.count ? statusWords[b.status ?? 'ok'] : EMPTY_VALUE}}))}
empty={CHART_EMPTY}
/>
<div
ref={stripRef}
role="group"
aria-label={label}
aria-roledescription="status bar"
className={cn(statusBarVariants({size}), data.length > 60 ? 'gap-px' : 'gap-0.5')}
onPointerLeave={() => { if (!ref.current?.contains(document.activeElement)) hide(); }}
>
{data.map((b, i) => {
const tone = b.count === 0 ? 'quiet' : b.status ?? 'ok';
const w = cellWidth(i);
return <button
key={i}
ref={el => { cells.current[i] = el; roving.ref(i)(el); }}
type="button"
tabIndex={roving.tabIndex(i)}
data-slot="status-bar-cell"
data-tone={tone}
aria-label={`${b.label}: ${describe(b)}`}
onPointerEnter={event => { roving.setCurrent(i); show(i, event.currentTarget); }}
onFocus={event => { roving.setCurrent(i); show(i, event.currentTarget); }}
onBlur={event => { if (!event.currentTarget.parentElement?.contains(event.relatedTarget as Node)) hide(); }}
onKeyDown={event => { if (event.key === 'Escape') hide(); else roving.onKeyDown(event, i); }}
onClick={onBucketClick && (() => onBucketClick(b, i))}
style={w ? {width: w, flex: 'none'} : undefined}
className={cn(
'h-full min-w-px flex-1 rounded-pill transition-opacity duration-(--dur-state) focus-sm',
cellTone[tone],
tone === 'quiet' ? 'forced-colors:bg-[Canvas] forced-colors:outline-1 forced-colors:-outline-offset-1' : 'forced-colors:bg-[CanvasText]',
active !== null && active !== i && 'opacity-(--stale)',
onBucketClick ? 'cursor-pointer' : 'cursor-default',
)}
/>;
})}
</div>
{ends && <div aria-hidden className="flex justify-between gap-4 type-caption text-text-2 data"><span>{ends[0]}</span><span>{ends[1]}</span></div>}
<ChartTooltip anchor={active !== null ? anchor : null}>
{active !== null && data[active] && <ChartTooltipContent title={data[active].label}>
<ChartTooltipRow
indicator={<StatusMark status={data[active].count === 0 ? 'idle' : data[active].status ?? 'ok'} className="h-auto text-text-inverse"/>}
label={data[active].count ? statusWords[data[active].status ?? 'ok'] : 'Quiet'}
value={describe(data[active])}
/>
</ChartTooltipContent>}
</ChartTooltip>
</div>;
}
export {
Sparkline, sparklineVariants,
StatusBar, statusBarVariants,
type SparklineProps, type StatusBarProps, type StatusBarBucket,
};