{
  "title": "Vector Field",
  "description": "Directional vector arrows mapping circulation and flow field magnitude.",
  "name": "tanstack-charts-vector-field",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/vector-field.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, defineChart, vector } 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, scaleSqrt } from \"d3-scale\";\nimport { Compass } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface VectorDatum {\n    x: number;\n    y: number;\n    u: number;\n    v: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): VectorDatum[] {\n    const results: VectorDatum[] = [];\n    for (let x = -5; x <= 5; x += 1) {\n        for (let y = -5; y <= 5; y += 1) {\n            const u = -y * 1.5;\n            const v = x * 1.5;\n            results.push({ x, y, u, v });\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 VectorDatum;\n    if (!d) return { title: \"\", rows: [] };\n    const speedVal = Math.hypot(d.u, d.v).toFixed(1);\n    const angleDeg = ((Math.atan2(d.u, d.v) * 180) / Math.PI).toFixed(0);\n    return {\n        title: `Grid Position (${d.x}, ${d.y})`,\n        rows: [\n            { label: \"Velocity Magnitude\", value: `${speedVal} m/s`, color: \"var(--chart-1)\" },\n            { label: \"Direction Angle\", value: `${angleDeg}°`, color: \"var(--foreground)\" },\n        ],\n    };\n}\n\nexport function VectorField() {\n    const data = useMemo(() => generateDemoData(), []);\n    const speedScale = useMemo(() => scaleSqrt().domain([0, 15]).range([2, 16]), []);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        vector(data, {\n                            id: \"wind-vectors\",\n                            x: \"x\",\n                            y: \"y\",\n                            length: (row: VectorDatum) => speedScale(Math.hypot(row.u, row.v)),\n                            rotate: (row: VectorDatum) => (Math.atan2(row.u, row.v) * 180) / Math.PI,\n                            stroke: \"var(--chart-1)\",\n                            strokeWidth: 1.5,\n                        }),\n                    ],\n                    scales: {\n                        x: { scale: scaleLinear, grid: true, axis: { label: \"Longitude X\" } },\n                        y: { scale: scaleLinear, grid: true, axis: { label: \"Latitude Y\" } },\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                    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        [data, speedScale],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Rotational Velocity Vector Field</CardTitle>\n                <CardDescription>\n                    Directional vector arrows mapping circulation and flow field magnitude\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=\"Rotational Velocity Vector Field 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                    Counter-clockwise vortex circulation around origin (0,0){\" \"}\n                    <Compass className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Arrow length indicates vector speed; rotation angle represents directional heading\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default VectorField;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Directional vector arrows mapping circulation and flow field magnitude. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}