{
  "title": "Scatter Marginal Histograms",
  "description": "Bivariate scatterplot paired with marginal X/Y frequency density distributions.",
  "name": "tanstack-charts-scatter-marginal-histograms",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/scatter-marginal-histograms.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, binX, binY, defineChart, dot, rect } from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { viewGrid } from \"@tanstack/charts/view\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { scaleLinear } from \"d3-scale\";\nimport { BarChart3 } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface PenguinDatum {\n    species: \"Adelie\" | \"Chinstrap\" | \"Gentoo\";\n    flipper_length_mm: number;\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 flipperBoundaries = [170, 180, 190, 200, 210, 220, 230, 240];\nconst massBoundaries = [2500, 3000, 3500, 4000, 4500, 5000, 5500, 6000, 6500];\n\nfunction generateDemoData(): PenguinDatum[] {\n    const results: PenguinDatum[] = [];\n    const speciesList: (\"Adelie\" | \"Chinstrap\" | \"Gentoo\")[] = [\"Adelie\", \"Chinstrap\", \"Gentoo\"];\n\n    speciesList.forEach((sp) => {\n        let fMean = 190;\n        let mMean = 3700;\n        if (sp === \"Chinstrap\") {\n            fMean = 195;\n            mMean = 3730;\n        }\n        if (sp === \"Gentoo\") {\n            fMean = 217;\n            mMean = 5080;\n        }\n\n        for (let i = 0; i < 35; i++) {\n            const flipper = fMean + (Math.random() - 0.5) * 16;\n            const mass = mMean + (Math.random() - 0.5) * 900;\n            results.push({\n                species: sp,\n                flipper_length_mm: Math.round(flipper),\n                body_mass_g: Math.round(mass),\n            });\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 PenguinDatum | { x1?: number; x2?: number; y1?: number; y2?: number; count?: number };\n    if (!d) return { title: \"\", rows: [] };\n\n    if (\"count\" in d && \"x1\" in d && d.x1 !== undefined) {\n        return {\n            title: `Flipper Range: ${d.x1}–${d.x2} mm`,\n            rows: [{ label: \"Penguin Count\", value: `${d.count}`, color: \"var(--chart-1)\" }],\n        };\n    }\n    if (\"count\" in d && \"y1\" in d && d.y1 !== undefined) {\n        return {\n            title: `Mass Range: ${d.y1}–${d.y2} g`,\n            rows: [{ label: \"Penguin Count\", value: `${d.count}`, color: \"var(--chart-2)\" }],\n        };\n    }\n    const p = d as PenguinDatum;\n    return {\n        title: `${p.species} Penguin`,\n        rows: [\n            { label: \"Flipper Length\", value: `${p.flipper_length_mm} mm`, color: \"var(--chart-1)\" },\n            { label: \"Body Mass\", value: `${p.body_mass_g} g`, color: \"var(--chart-2)\" },\n        ],\n    };\n}\n\nexport function ScatterMarginalHistograms() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const xBins = useMemo(\n        () =>\n            binX(data, {\n                value: \"flipper_length_mm\",\n                thresholds: flipperBoundaries,\n                outputs: { count: { reduce: \"count\" } },\n            }),\n        [data],\n    );\n\n    const yBins = useMemo(\n        () =>\n            binY(data, {\n                value: \"body_mass_g\",\n                thresholds: massBoundaries,\n                outputs: { count: { reduce: \"count\" } },\n            }),\n        [data],\n    );\n\n    const flipperScale = useMemo(() => scaleLinear().domain([170, 240]), []);\n    const massScale = useMemo(() => scaleLinear().domain([2500, 6500]), []);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                viewGrid({\n                    id: \"penguin-marginals\",\n                    rows: [\n                        { id: \"top\", size: 60 },\n                        { id: \"main\", grow: 1 },\n                    ],\n                    columns: [\n                        { id: \"main\", grow: 1 },\n                        { id: \"right\", size: 60 },\n                    ],\n                    gap: 6,\n                    views: [\n                        {\n                            id: \"main\",\n                            row: \"main\",\n                            column: \"main\",\n                            chart: defineChart({\n                                marks: [\n                                    dot(data, {\n                                        id: \"penguins\",\n                                        x: \"flipper_length_mm\",\n                                        y: \"body_mass_g\",\n                                        color: \"species\",\n                                        r: 3.5,\n                                        fillOpacity: 0.85,\n                                    }),\n                                ],\n                                scales: {\n                                    x: {\n                                        scale: flipperScale,\n                                        grid: true,\n                                        axis: { label: \"Flipper Length (mm)\" },\n                                    },\n                                    y: {\n                                        scale: massScale,\n                                        grid: true,\n                                        axis: { label: \"Body Mass (g)\" },\n                                    },\n                                },\n                                color: {\n                                    range: [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"],\n                                },\n                            }),\n                        },\n                        {\n                            id: \"top\",\n                            row: \"top\",\n                            column: \"main\",\n                            share: { x: \"main\" },\n                            chart: defineChart({\n                                marks: [\n                                    rect(xBins, {\n                                        id: \"flipper-histogram\",\n                                        x: \"x\",\n                                        x1: \"x1\",\n                                        x2: \"x2\",\n                                        y: \"count\",\n                                        y1: () => 0,\n                                        y2: \"count\",\n                                        fill: \"var(--chart-1)\",\n                                        fillOpacity: 0.75,\n                                        inset: 1,\n                                    }),\n                                ],\n                                scales: {\n                                    x: { scale: flipperScale },\n                                    y: { scale: scaleLinear },\n                                },\n                                guides: false,\n                            }),\n                        },\n                        {\n                            id: \"right\",\n                            row: \"main\",\n                            column: \"right\",\n                            share: { y: \"main\" },\n                            chart: defineChart({\n                                marks: [\n                                    rect(yBins, {\n                                        id: \"mass-histogram\",\n                                        x: \"count\",\n                                        x1: () => 0,\n                                        x2: \"count\",\n                                        y: \"y\",\n                                        y1: \"y1\",\n                                        y2: \"y2\",\n                                        fill: \"var(--chart-2)\",\n                                        fillOpacity: 0.75,\n                                        inset: 1,\n                                    }),\n                                ],\n                                scales: {\n                                    x: { scale: scaleLinear },\n                                    y: { scale: massScale },\n                                },\n                                guides: false,\n                            }),\n                        },\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        [data, xBins, yBins, flipperScale, massScale],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Scatterplot with Marginal Histograms</CardTitle>\n                <CardDescription>\n                    Bivariate scatter paired with top and right 1D marginal frequency bins\n                </CardDescription>\n            </CardHeader>\n            <CardContent>\n                <div className=\"h-[280px] w-full\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={280}\n                        ariaLabel=\"Scatterplot with Marginal Histograms 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                    Marginal bars summarize 1D distribution peaks alongside 2D point cloud{\" \"}\n                    <BarChart3 className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Multi-view grid layout aligns top X-histogram and right Y-histogram seamlessly\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default ScatterMarginalHistograms;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Bivariate scatterplot paired with marginal X/Y frequency density distributions. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack",
      "line"
    ]
  }
}