{
  "title": "Difference Chart",
  "description": "Dual-color difference area chart tracking asset premium vs discount to moving average.",
  "name": "tanstack-charts-difference-chart",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/area/difference-chart.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, defineChart, differenceY, rollingWindow } 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, scaleUtc } from \"d3-scale\";\nimport { ArrowUpRight } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface StockDiffDatum {\n    Date: Date;\n    Close: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): StockDiffDatum[] {\n    const baseDate = new Date(2025, 0, 1);\n    return Array.from({ length: 30 }, (_, i) => {\n        const d = new Date(baseDate);\n        d.setDate(baseDate.getDate() + i);\n        const close = 150 + Math.sin(i * 0.4) * 20 + (i % 2 === 0 ? 5 : -5);\n        return { Date: d, Close: close };\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 any;\n    if (!d) return { title: \"\", rows: [] };\n    const dateStr = d.Date.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\" });\n    const diff = d.Close - d.average;\n    return {\n        title: dateStr,\n        rows: [\n            { label: \"Close Price\", value: `$${d.Close.toFixed(2)}`, color: \"var(--chart-1)\" },\n            { label: \"20-day Average\", value: `$${d.average.toFixed(2)}`, color: \"var(--muted-foreground)\" },\n            {\n                label: \"Net Surplus\",\n                value: `${diff >= 0 ? \"+\" : \"\"}$${diff.toFixed(2)}`,\n                color: diff >= 0 ? \"var(--chart-1)\" : \"var(--chart-2)\",\n            },\n        ],\n    };\n}\n\nexport function DifferenceChart() {\n    const rawData = useMemo(() => generateDemoData(), []);\n\n    const data = useMemo(() => {\n        return rollingWindow(rawData, {\n            size: 10,\n            orderBy: \"Date\",\n            anchor: \"end\",\n            partial: false,\n            outputs: {\n                average: { value: \"Close\", reduce: \"mean\" },\n            },\n        });\n    }, [rawData]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        differenceY(data, {\n                            id: \"price-difference\",\n                            x: \"Date\",\n                            y1: \"average\",\n                            y2: \"Close\",\n                            positiveFill: \"var(--chart-1)\",\n                            negativeFill: \"var(--chart-2)\",\n                            fillOpacity: 0.3,\n                            stroke: \"var(--chart-1)\",\n                            strokeWidth: 2,\n                            comparisonStroke: \"var(--border)\",\n                            comparisonStrokeWidth: 2,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleUtc,\n                            axis: {\n                                line: false,\n                                label: \"Date\",\n                                ticks: {\n                                    size: 0,\n                                    padding: 10,\n                                    format: (d: Date) =>\n                                        d.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\" }),\n                                },\n                            },\n                        },\n                        y: {\n                            scale: scaleLinear().domain([120, 185]),\n                            grid: true,\n                            axis: {\n                                line: false,\n                                label: \"Price ($)\",\n                                ticks: { size: 0 },\n                            },\n                        },\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>Price vs Moving Average Difference</CardTitle>\n                <CardDescription>\n                    Dual-color difference area chart tracking price premium vs discount to moving mean\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=\"Price vs Moving Average Difference 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                    Positive difference fill (green) reflects asset trading premium{\" \"}\n                    <ArrowUpRight className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Green area highlights periods above baseline mean; Red area highlights discount dips below baseline\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default DifferenceChart;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Dual-color difference area chart tracking asset premium vs discount to moving average. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}