{
  "title": "Violin Distributions",
  "description": "Symmetric KDE violin profiles overlaid with boxplot quartiles.",
  "name": "tanstack-charts-violin-distributions",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale",
    "d3-shape"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/area/violin-distributions.tsx",
      "type": "registry:block",
      "content": "import {\n    type ChartPoint,\n    binY,\n    d3AreaXCurve,\n    defineChart,\n    dot,\n    groupBy,\n    median,\n    normalize,\n    tickY,\n    violinY,\n} from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { scaleLinear, scalePoint } from \"d3-scale\";\nimport { curveBasis } from \"d3-shape\";\nimport { SlidersHorizontal } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface PenguinDatum {\n    species: \"Adelie\" | \"Chinstrap\" | \"Gentoo\";\n    body_mass_g: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst speciesList: (\"Adelie\" | \"Chinstrap\" | \"Gentoo\")[] = [\"Adelie\", \"Chinstrap\", \"Gentoo\"];\nconst massBoundaries = [2500, 3000, 3500, 4000, 4500, 5000, 5500, 6000, 6500];\n\nfunction generateDemoData(): PenguinDatum[] {\n    const results: PenguinDatum[] = [];\n    const means = [3700, 3730, 5080];\n\n    speciesList.forEach((sp, idx) => {\n        for (let i = 0; i < 50; i++) {\n            const mass = means[idx] + (Math.random() - 0.5) * 800;\n            results.push({ species: sp, body_mass_g: Math.round(mass) });\n        }\n    });\n\n    return results;\n}\n\nfunction shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {\n    if (points.length === 0) return { title: \"\", rows: [] };\n    const d = points[0].datum as { species: string; median?: number; y?: number };\n    if (!d) return { title: \"\", rows: [] };\n    if (d.median !== undefined) {\n        return {\n            title: `${d.species} (Median Marker)`,\n            rows: [\n                { label: \"Median Mass\", value: `${Math.round(d.median).toLocaleString()} g`, color: \"var(--chart-1)\" },\n            ],\n        };\n    }\n    return {\n        title: `${d.species} (Violin Profile)`,\n        rows: [{ label: \"Mass Bin\", value: `${d.y?.toLocaleString()} g`, color: \"var(--chart-2)\" }],\n    };\n}\n\nexport function ViolinDistributions() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const profiles = useMemo(() => {\n        const bins = binY(data, {\n            value: \"body_mass_g\",\n            by: \"species\",\n            thresholds: massBoundaries,\n            outputs: { count: { reduce: \"count\" } },\n        });\n\n        return normalize(bins, {\n            value: \"count\",\n            by: \"species\",\n            basis: \"max\",\n            as: \"width\",\n        });\n    }, [data]);\n\n    const summaries = useMemo(() => {\n        return groupBy(data, {\n            by: \"species\",\n            outputs: {\n                median: { value: \"body_mass_g\", reduce: median },\n            },\n        });\n    }, [data]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        violinY(profiles, {\n                            id: \"mass-violins\",\n                            x: \"species\",\n                            y: \"y\",\n                            width: \"width\",\n                            key: (row: { species: string; y: number }) => `${row.species}:${row.y}`,\n                            span: 0.76,\n                            color: \"species\",\n                            fillOpacity: 0.55,\n                            curve: d3AreaXCurve(curveBasis),\n                        }),\n                        tickY(summaries, {\n                            id: \"median-ticks\",\n                            x: \"species\",\n                            y: \"median\",\n                            key: \"species\",\n                            span: 0.36,\n                            stroke: \"var(--foreground)\",\n                            strokeWidth: 2,\n                        }),\n                        dot(summaries, {\n                            id: \"median-dots\",\n                            x: \"species\",\n                            y: \"median\",\n                            key: \"species\",\n                            color: \"species\",\n                            stroke: \"var(--background)\",\n                            strokeWidth: 1.5,\n                            r: 4,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scalePoint<string>().domain(speciesList).padding(0.5),\n                        },\n                        y: { scale: scaleLinear, grid: true, axis: { label: \"Body Mass (g)\" } },\n                    },\n                    color: {\n                        domain: speciesList,\n                        range: [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"],\n                    },\n                    margin: { top: 24, right: 24, bottom: 32, left: 45 },\n                    theme: {\n                        foreground: \"var(--muted-foreground)\",\n                        grid: \"var(--border)\",\n                        background: \"transparent\",\n                    },\n                },\n                {\n                    keyboard: true,\n                    tooltip: {\n                        use: tooltip,\n                        className:\n                            \"font-sans shadow-none rounded-md bg-popover text-popover-foreground border p-2 text-xs\",\n                        anchor: \"pointer\",\n                        placement: \"auto\",\n                        content: (points) => shadcnTooltipContent(points),\n                    },\n                },\n            ),\n        [profiles, summaries],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Violin Kernel Density Plot</CardTitle>\n                <CardDescription>Symmetric KDE violin profiles overlaid with central median markers</CardDescription>\n            </CardHeader>\n            <CardContent>\n                <div className=\"h-[250px] w-full\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={250}\n                        ariaLabel=\"Violin Kernel Density Plot Chart\"\n                    />\n                </div>\n            </CardContent>\n            <CardFooter className=\"flex-col items-start gap-2 text-sm\">\n                <div className=\"flex items-center gap-2 leading-none font-medium\">\n                    Violin contours reveal multi-modal continuous density shapes{\" \"}\n                    <SlidersHorizontal className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Combines boxplot median markers with smooth kernel density estimations\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default ViolinDistributions;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Symmetric KDE violin profiles overlaid with boxplot quartiles. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}