{
  "title": "Donut Chart",
  "description": "Ring cutout donut distribution chart showing category proportions.",
  "name": "tanstack-charts-donut-chart",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/pie/donut-chart.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, defineChart } from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { pie, polar, radialArc } from \"@tanstack/charts/polar\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { CircleDot } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface RevenueDatum {\n    channel: string;\n    value: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): RevenueDatum[] {\n    return [\n        { channel: \"Direct\", value: 4200 },\n        { channel: \"Organic Search\", value: 3100 },\n        { channel: \"Referral\", value: 1800 },\n        { channel: \"Social Media\", value: 1200 },\n        { channel: \"Email Campaign\", value: 900 },\n    ];\n}\n\nfunction shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {\n    if (points.length === 0) return { title: \"\", rows: [] };\n    const d = points[0].datum as RevenueDatum;\n    if (!d) return { title: \"\", rows: [] };\n    return {\n        title: d.channel,\n        rows: [{ label: \"Revenue\", value: `$${d.value.toLocaleString()}`, color: \"var(--chart-1)\" }],\n    };\n}\n\nexport function DonutChart() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const arcs = useMemo(() => {\n        return pie(data, {\n            value: \"value\",\n        });\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                        polar({\n                            inset: 0,\n                            radiusRatio: 0.8,\n                            scales: {\n                                angle: null,\n                                radius: null,\n                            },\n                            marks: [\n                                radialArc(arcs, {\n                                    id: \"channel-donuts\",\n                                    key: \"channel\",\n                                    innerRadius: ({ radius }: { radius: number }) => radius * 0.6,\n                                    color: \"channel\",\n                                    stroke: \"var(--background)\",\n                                    strokeWidth: 2,\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: 10,\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        [arcs],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Ring Cutout Donut Distribution</CardTitle>\n                <CardDescription>\n                    Hollow inner-radius ring donut chart showing revenue channel breakdowns\n                </CardDescription>\n            </CardHeader>\n            <CardContent>\n                <div className=\"flex h-[250px] w-full items-center justify-center\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={250}\n                        ariaLabel=\"Ring Cutout Donut 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                    Direct sales channel generates 37% of total revenue{\" \"}\n                    <CircleDot className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    `innerRadius` cutout provides central space for total KPIs or secondary metrics\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default DonutChart;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Ring cutout donut distribution chart showing category proportions. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack",
      "pie"
    ]
  }
}