{
  "title": "Change Arrows",
  "description": "2D vector change arrows depicting bivariate shift direction.",
  "name": "tanstack-charts-change-arrows",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/change-arrows.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, arrow, defineChart } 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 { MoveUpRight } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface ArrowDatum {\n    metro: string;\n    pop1980: number;\n    ratio1980: number;\n    pop2015: number;\n    ratio2015: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): ArrowDatum[] {\n    return [\n        { metro: \"New York\", pop1980: 6.9, ratio1980: 4.5, pop2015: 7.3, ratio2015: 7.8 },\n        { metro: \"Los Angeles\", pop1980: 6.8, ratio1980: 4.2, pop2015: 7.1, ratio2015: 8.2 },\n        { metro: \"Chicago\", pop1980: 6.8, ratio1980: 4.0, pop2015: 6.9, ratio2015: 6.1 },\n        { metro: \"Houston\", pop1980: 6.4, ratio1980: 3.8, pop2015: 6.8, ratio2015: 5.9 },\n        { metro: \"Phoenix\", pop1980: 6.1, ratio1980: 3.6, pop2015: 6.6, ratio2015: 5.2 },\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 ArrowDatum;\n    if (!d) return { title: \"\", rows: [] };\n    const diff = d.ratio2015 - d.ratio1980;\n    return {\n        title: d.metro,\n        rows: [\n            { label: \"1980 Ratio\", value: d.ratio1980.toFixed(1), color: \"var(--muted-foreground)\" },\n            { label: \"2015 Ratio\", value: d.ratio2015.toFixed(1), color: points[0].color || \"var(--chart-1)\" },\n            { label: \"Shift\", value: `${diff > 0 ? \"+\" : \"\"}${diff.toFixed(1)}`, color: \"var(--foreground)\" },\n        ],\n    };\n}\n\nexport function ChangeArrows() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const { increases, decreases } = useMemo(() => {\n        return {\n            increases: data.filter((d) => d.ratio2015 >= d.ratio1980),\n            decreases: data.filter((d) => d.ratio2015 < d.ratio1980),\n        };\n    }, [data]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        arrow(increases, {\n                            id: \"arrow-increases\",\n                            x1: \"pop1980\",\n                            y1: \"ratio1980\",\n                            x2: \"pop2015\",\n                            y2: \"ratio2015\",\n                            stroke: \"var(--chart-1)\",\n                            headLength: 7,\n                        }),\n                        arrow(decreases, {\n                            id: \"arrow-decreases\",\n                            x1: \"pop1980\",\n                            y1: \"ratio1980\",\n                            x2: \"pop2015\",\n                            y2: \"ratio2015\",\n                            stroke: \"var(--chart-2)\",\n                            headLength: 7,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleLinear().domain([5.8, 7.6]),\n                            grid: true,\n                            axis: {\n                                line: false,\n                                label: \"Log10 Population\",\n                                ticks: { size: 0 },\n                            },\n                        },\n                        y: {\n                            scale: scaleLinear().domain([3, 9]),\n                            grid: true,\n                            axis: {\n                                line: false,\n                                label: \"Wage Inequality Ratio\",\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        [increases, decreases],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Population & Wage Vector Shifts</CardTitle>\n                <CardDescription>\n                    2D vector arrows depicting metro population growth versus wage inequality shift\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=\"Population & Wage Vector Shifts 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                    Vector direction shows simultaneous population expansion and inequality ratio{\" \"}\n                    <MoveUpRight className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Green vectors denote increasing inequality; Red vectors denote decreasing inequality\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default ChangeArrows;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. 2D vector change arrows depicting bivariate shift direction. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}