{
  "title": "Faceted Distributions",
  "description": "Small multiples faceting histogram distributions across species and sex categories.",
  "name": "tanstack-charts-faceted-distributions",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/bar/faceted-distributions.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, binX, defineChart, facet, normalize, rect } 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 } from \"d3-scale\";\nimport { LayoutGrid } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface PenguinMass {\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 boundaries = [2500, 3000, 3500, 4000, 4500, 5000, 5500, 6000, 6500];\n\nfunction generateDemoData(): PenguinMass[] {\n    const results: PenguinMass[] = [];\n    const speciesList: (\"Adelie\" | \"Chinstrap\" | \"Gentoo\")[] = [\"Adelie\", \"Chinstrap\", \"Gentoo\"];\n\n    speciesList.forEach((sp) => {\n        let mean = 3700;\n        if (sp === \"Chinstrap\") mean = 3730;\n        if (sp === \"Gentoo\") mean = 5000;\n\n        for (let i = 0; i < 60; i++) {\n            const mass = mean + (Math.random() - 0.5) * 1200;\n            results.push({ species: sp, body_mass_g: 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; x1: number; x2: number; proportion: number };\n    if (!d) return { title: \"\", rows: [] };\n    return {\n        title: `${d.species} (${d.x1}–${d.x2} g)`,\n        rows: [{ label: \"Proportion\", value: `${(d.proportion * 100).toFixed(1)}%`, color: \"var(--chart-1)\" }],\n    };\n}\n\nexport function FacetedDistributions() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const bins = useMemo(() => {\n        return normalize(\n            binX(data, {\n                value: \"body_mass_g\",\n                by: \"species\",\n                thresholds: boundaries,\n                outputs: { count: { reduce: \"count\" } },\n            }),\n            {\n                value: \"count\",\n                by: \"species\",\n                basis: \"sum\",\n                as: \"proportion\",\n            },\n        ).filter(({ count }) => count > 0);\n    }, [data]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    scales: {\n                        x: null,\n                        y: null,\n                    },\n                    marks: [\n                        facet(bins, {\n                            by: \"species\",\n                            columns: 1,\n                            gap: 8,\n                            label: (group) => String(group),\n                            chart: (facetBins) => ({\n                                marks: [\n                                    rect(facetBins, {\n                                        x1: \"x1\",\n                                        x2: \"x2\",\n                                        y1: () => 0,\n                                        y2: \"proportion\",\n                                        fill: \"var(--chart-1)\",\n                                        inset: 0.75,\n                                    }),\n                                ],\n                                scales: {\n                                    x: {\n                                        scale: scaleLinear().domain([2500, 6500]),\n                                        grid: true,\n                                        axis: { label: \"Body Mass (g)\" },\n                                    },\n                                    y: {\n                                        scale: scaleLinear().domain([0, 0.5]),\n                                        grid: true,\n                                        axis: {\n                                            ticks: { count: 3, format: (v: number) => `${Math.round(v * 100)}%` },\n                                            label: \"Proportion\",\n                                        },\n                                    },\n                                },\n                            }),\n                        }),\n                    ],\n                    margin: 8,\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        [bins],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Faceted Body Mass Distribution</CardTitle>\n                <CardDescription>Small multiples faceting histogram distributions across species</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=\"Faceted Body Mass Distribution 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                    Gentoo penguins show distinctly higher body mass distribution{\" \"}\n                    <LayoutGrid className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Faceted rows enable direct multi-category distribution shape comparisons\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default FacetedDistributions;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Small multiples faceting histogram distributions across species and sex categories. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}