{
  "title": "Waterfall Chart",
  "description": "Sequential revenue bridge waterfall chart tracking period variance drivers.",
  "name": "tanstack-charts-waterfall",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/bar/waterfall.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, barY, defineChart, 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 { scaleBand, scaleLinear } from \"d3-scale\";\nimport { TrendingDown } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface WaterfallItemDatum {\n    step: string;\n    start: number;\n    end: number;\n    kind: \"increase\" | \"decrease\" | \"total\";\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): WaterfallItemDatum[] {\n    return [\n        { step: \"Start Revenue\", start: 0, end: 100, kind: \"increase\" },\n        { step: \"New Sales\", start: 100, end: 145, kind: \"increase\" },\n        { step: \"Churn\", start: 145, end: 125, kind: \"decrease\" },\n        { step: \"Discounts\", start: 125, end: 110, kind: \"decrease\" },\n        { step: \"Upsells\", start: 110, end: 140, kind: \"increase\" },\n        { step: \"Net Total\", start: 0, end: 140, kind: \"total\" },\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 WaterfallItemDatum;\n    if (!d) return { title: \"\", rows: [] };\n    const diff = d.end - d.start;\n    const isTotal = d.kind === \"total\";\n    return {\n        title: d.step,\n        rows: [\n            {\n                label: isTotal ? \"Total Value\" : \"Variance\",\n                value: isTotal ? `$${d.end}k` : `${diff > 0 ? \"+\" : \"\"}$${diff}k`,\n                color: points[0].color || \"var(--chart-1)\",\n            },\n        ],\n    };\n}\n\nexport function WaterfallChart() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        barY(data, {\n                            id: \"waterfall-bars\",\n                            x: \"step\",\n                            y1: \"start\",\n                            y2: \"end\",\n                            color: \"kind\",\n                            inset: 1.5,\n                            radius: 3,\n                        }),\n                        ruleY([0], { stroke: \"var(--border)\" }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: () => scaleBand<string>().padding(0.2),\n                            axis: {\n                                line: false,\n                                ticks: { size: 0, padding: 10 },\n                            },\n                        },\n                        y: {\n                            scale: scaleLinear().domain([0, 170]),\n                            grid: true,\n                            axis: {\n                                line: false,\n                                label: \"Revenue ($k)\",\n                                ticks: { size: 0 },\n                            },\n                        },\n                    },\n                    color: {\n                        domain: [\"increase\", \"decrease\", \"total\"],\n                        range: [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"],\n                    },\n                    margin: { top: 24, right: 24, bottom: 32, left: 45 },\n                    theme: {\n                        foreground: \"var(--muted-foreground)\",\n                        grid: \"var(--border)\",\n                        background: \"transparent\",\n                    },\n                },\n                {\n                    focus: \"group-x\",\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: \"group-center\",\n                        placement: \"auto\",\n                        content: (points) => shadcnTooltipContent(points),\n                    },\n                },\n            ),\n        [data],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Revenue Waterfall Bridge</CardTitle>\n                <CardDescription>Sequential waterfall bridge analyzing net revenue variance drivers</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=\"Revenue Waterfall Bridge 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                    Net ending revenue expanded +$40k over fiscal period{\" \"}\n                    <TrendingDown className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Green bars reflect gains; Red bars depict losses; Blue bar shows net ending total\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default WaterfallChart;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Sequential revenue bridge waterfall chart tracking period variance drivers. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}