{
  "title": "Ridgeline Density",
  "description": "Overlapping ridgeline density plot comparing continuous distribution mountain curves.",
  "name": "tanstack-charts-ridgeline-density",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale",
    "d3-shape"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/area/ridgeline-density.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, binX, d3Curve, defineChart, normalize, ridgelineY, ruleY } 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 { Layers } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface EpisodeDatum {\n    season: number;\n    rating: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst seasonsList = [1, 2, 3, 4, 5];\nconst ratingBoundaries = [4, 5, 6, 7, 8, 9, 10];\n\nfunction generateDemoData(): EpisodeDatum[] {\n    const results: EpisodeDatum[] = [];\n\n    seasonsList.forEach((s) => {\n        const meanRating = 9.2 - s * 0.4;\n        for (let ep = 0; ep < 25; ep++) {\n            const r = Math.max(4, Math.min(10, meanRating + (Math.random() - 0.45) * 1.8));\n            results.push({ season: s, rating: Number(r.toFixed(1)) });\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 { season: number; x: number; height: number };\n    if (!d) return { title: \"\", rows: [] };\n    return {\n        title: `Season ${d.season} (Rating ${d.x?.toFixed(1)})`,\n        rows: [{ label: \"Density Height\", value: `${(d.height * 100).toFixed(1)}%`, color: \"var(--chart-1)\" }],\n    };\n}\n\nexport function RidgelineDensity() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const rows = useMemo(() => {\n        const bins = binX(data, {\n            value: \"rating\",\n            by: \"season\",\n            thresholds: ratingBoundaries,\n            outputs: { count: { reduce: \"count\" } },\n        });\n\n        return normalize(bins, {\n            value: \"count\",\n            by: \"season\",\n            basis: \"max\",\n            as: \"height\",\n        });\n    }, [data]);\n\n    const overlap = 0.75;\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        ruleY(seasonsList, {\n                            id: \"season-guides\",\n                            stroke: \"var(--border)\",\n                            strokeOpacity: 0.7,\n                        }),\n                        ridgelineY(rows, {\n                            id: \"rating-ridges\",\n                            x: \"x\",\n                            y: \"season\",\n                            height: \"height\",\n                            key: (row: { season: number; x: number }) => `${row.season}:${row.x}`,\n                            overlap,\n                            color: \"season\",\n                            fillOpacity: 0.45,\n                            strokeWidth: 1.5,\n                            curve: d3Curve(curveBasis),\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleLinear().domain([4, 10]),\n                            grid: true,\n                            axis: { label: \"IMDb Rating Score\" },\n                        },\n                        y: {\n                            scale: scalePoint<number>().domain(seasonsList).padding(overlap),\n                            reverse: true,\n                            axis: {\n                                ticks: {\n                                    values: seasonsList,\n                                    format: (s: number) => `Season ${s}`,\n                                },\n                            },\n                        },\n                    },\n                    color: {\n                        range: [\n                            \"var(--chart-1)\",\n                            \"var(--chart-2)\",\n                            \"var(--chart-3)\",\n                            \"var(--chart-4)\",\n                            \"var(--chart-5)\",\n                        ],\n                    },\n                    margin: { top: 24, right: 24, bottom: 32, left: 65 },\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        [rows],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Overlapping Ridgeline Density Plot</CardTitle>\n                <CardDescription>\n                    Stacked density ridge mountain plots comparing ratings distribution per season\n                </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=\"Overlapping Ridgeline 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                    Season 1 displays peak density concentrated at higher 8.8 rating{\" \"}\n                    <Layers className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Partial Y-axis overlapping ridgelines economize vertical space in multi-series KDE plots\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default RidgelineDensity;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Overlapping ridgeline density plot comparing continuous distribution mountain curves. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}