
1D collision-avoidance dodge layout packing discrete data points along category lanes.
components/tanstack-charts/line/beeswarm-dodge.tsx
import { type ChartPoint, defineChart, dodgeY, dot } from "@tanstack/charts";
import { motion } from "@tanstack/charts/motion";
import { tooltip } from "@tanstack/charts/tooltip";
import { Chart } from "@tanstack/react-charts/core";
import { useMemo } from "react";
import { scaleLinear } from "d3-scale";
import { CircleDot } from "lucide-react";
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card";
interface BeeswarmDatum {
name: string;
mpg: number;
}
const motionRenderer = motion({
initial: "always",
transition: { type: "spring", stiffness: 170, damping: 18, mass: 1 },
});
function generateDemoData(): BeeswarmDatum[] {
const results: BeeswarmDatum[] = [];
const models = ["Civic", "Corolla", "Golf", "Focus", "Elantra", "Sentra", "Impreza", "Mazda3"];
for (let i = 0; i < 75; i++) {
const mpg = 15 + Math.floor(Math.random() * 28 + Math.random() * 8);
results.push({
name: `${models[i % models.length]} #${i + 1}`,
mpg,
});
}
return results;
}
function shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {
if (points.length === 0) return { title: "", rows: [] };
const d = points[0].datum as BeeswarmDatum;
if (!d) return { title: "", rows: [] };
return {
title: d.name,
rows: [{ label: "Fuel Economy", value: `${d.mpg} mpg`, color: "var(--chart-1)" }],
};
}
export function BeeswarmDodge() {
const data = useMemo(() => generateDemoData(), []);
const definition = useMemo(
() =>
defineChart(
{
renderer: motionRenderer,
marks: [
dot(data, {
x: "mpg",
key: "name",
r: 4.5,
fill: "var(--chart-1)",
stroke: "var(--background)",
strokeWidth: 1,
layout: dodgeY({
anchor: "middle",
padding: 1,
}),
}),
],
scales: {
x: {
scale: scaleLinear().domain([10, 55]),
grid: true,
axis: { label: "Fuel Economy (mpg)" },
},
y: null,
},
guides: false,
margin: { top: 24, right: 24, bottom: 32, left: 24 },
theme: {
foreground: "var(--muted-foreground)",
grid: "var(--border)",
background: "transparent",
},
},
{
keyboard: true,
tooltip: {
use: tooltip,
className:
"font-sans shadow-none rounded-md bg-popover text-popover-foreground border p-2 text-xs",
anchor: "pointer",
placement: "auto",
content: (points) => shadcnTooltipContent(points),
},
},
),
[data],
);
return (
<Card className="w-full max-w-xl">
<CardHeader>
<CardTitle>Beeswarm Point Dodge Distribution</CardTitle>
<CardDescription>1D collision-avoidance dodge layout packing dots along value density</CardDescription>
</CardHeader>
<CardContent>
<div className="h-[250px] w-full">
<Chart
definition={definition}
renderer={motionRenderer}
height={250}
ariaLabel="Beeswarm Point Dodge Distribution Chart"
/>
</div>
</CardContent>
<CardFooter className="flex-col items-start gap-2 text-sm">
<div className="flex items-center gap-2 leading-none font-medium">
Dense clustering around 28–34 mpg efficiency range{" "}
<CircleDot className="h-4 w-4 text-emerald-500" />
</div>
<div className="text-muted-foreground leading-none">
Non-overlapping point dodge layout reveals individual data points while preserving density
</div>
</CardFooter>
</Card>
);
}
export default BeeswarmDodge;