{
  "title": "Population Pyramid",
  "description": "Bilateral horizontal bar chart displaying demographic population breakdowns.",
  "name": "tanstack-charts-population-pyramid",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/bar/population-pyramid.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, barX, defineChart, groupBy, stack } 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 { scaleBand, scaleLinear } from \"d3-scale\";\nimport { Users } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface PopulationDatum {\n    ageGroup: string;\n    sex: \"MALE\" | \"FEMALE\";\n    count: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst ageGroups = [\"0-14\", \"15-29\", \"30-44\", \"45-59\", \"60-74\", \"75+\"];\nconst pyramidSexes: (\"MALE\" | \"FEMALE\")[] = [\"MALE\", \"FEMALE\"];\n\nfunction generateDemoData(): PopulationDatum[] {\n    const results: PopulationDatum[] = [];\n    const maleCounts = [65, 82, 95, 88, 54, 32];\n    const femaleCounts = [62, 80, 98, 92, 58, 38];\n\n    ageGroups.forEach((age, idx) => {\n        results.push({ ageGroup: age, sex: \"MALE\", count: maleCounts[idx] });\n        results.push({ ageGroup: age, sex: \"FEMALE\", count: femaleCounts[idx] });\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 PopulationDatum;\n    if (!d) return { title: \"\", rows: [] };\n    return {\n        title: `Age Group ${d.ageGroup}`,\n        rows: [\n            {\n                label: d.sex === \"MALE\" ? \"Male Population\" : \"Female Population\",\n                value: `${d.count}k`,\n                color: d.sex === \"MALE\" ? \"var(--chart-1)\" : \"var(--chart-2)\",\n            },\n        ],\n    };\n}\n\nexport function PopulationPyramid() {\n    const rawData = useMemo(() => generateDemoData(), []);\n\n    const counts = useMemo(() => {\n        return groupBy(rawData, {\n            by: {\n                ageGroup: \"ageGroup\",\n                sex: \"sex\",\n            },\n            outputs: { count: { value: \"count\", reduce: \"sum\" } },\n        });\n    }, [rawData]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        barX(counts, {\n                            id: \"population-bars\",\n                            x: (row: PopulationDatum) => (row.sex === \"MALE\" ? -row.count : row.count),\n                            y: \"ageGroup\",\n                            z: \"sex\",\n                            color: \"sex\",\n                            layout: stack({ offset: \"diverging\", order: pyramidSexes }),\n                            key: (row: PopulationDatum) => `${row.ageGroup}:${row.sex}`,\n                            inset: 1,\n                            radius: 3,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleLinear().domain([-120, 120]),\n                            grid: true,\n                            axis: {\n                                ticks: {\n                                    count: 7,\n                                    format: (value: number) => `${Math.abs(value)}k`,\n                                },\n                                label: \"Population (Thousands)\",\n                            },\n                        },\n                        y: {\n                            scale: () => scaleBand<string>().domain(ageGroups).paddingInner(0.15).paddingOuter(0.05),\n                        },\n                    },\n                    color: {\n                        domain: pyramidSexes,\n                        range: [\"var(--chart-1)\", \"var(--chart-2)\"],\n                    },\n                    margin: { top: 24, right: 24, bottom: 32, left: 55 },\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        [counts],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Diverging Population Demographic Pyramid</CardTitle>\n                <CardDescription>\n                    Bilateral horizontal bar chart displaying male vs female population distributions across age\n                    brackets\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=\"Diverging Population Demographic Pyramid 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                    Peak working-age demographic concentrated in 30-44 bracket{\" \"}\n                    <Users className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Negative male X values mirror positive female X values around zero center axis\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default PopulationPyramid;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Bilateral horizontal bar chart displaying demographic population breakdowns. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}