{
  "title": "Free 2D Continuous Crosshair Cursor",
  "description": "Arbitrary XY continuous crosshairs with dynamic coordinate popup tooltip.",
  "name": "tanstack-charts-echarts-free-cursor",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/echarts-free-cursor.tsx",
      "type": "registry:block",
      "content": "import { defineChart, dot, lineY } from \"@tanstack/charts\";\nimport { type ContinuousCursorPosition, continuousCursor } from \"@tanstack/charts/interaction/cursor\";\nimport { controlledSignal } from \"@tanstack/charts/interaction/signal\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo, useState } from \"react\";\n\nimport { scaleLinear } from \"d3-scale\";\nimport { Crosshair } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface FreeCursorDatum {\n    hp: number;\n    mpg: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nfunction generateDemoData(): FreeCursorDatum[] {\n    const results: FreeCursorDatum[] = [];\n    for (let hp = 60; hp <= 300; hp += 15) {\n        const mpg = 45 - (hp - 60) * 0.12 + (Math.random() - 0.5) * 4;\n        results.push({ hp, mpg: Number(Math.max(10, mpg).toFixed(1)) });\n    }\n    return results;\n}\n\nexport function EchartsFreeCursor() {\n    const data = useMemo(() => generateDemoData(), []);\n    const [cursorPos, setCursorPos] = useState<ContinuousCursorPosition<number, number> | null>({\n        x: 180,\n        y: 28,\n    });\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        lineY(data, {\n                            id: \"free-cursor-line\",\n                            x: \"hp\",\n                            y: \"mpg\",\n                            stroke: \"var(--chart-1)\",\n                            strokeWidth: 2,\n                        }),\n                        dot(data, {\n                            id: \"free-cursor-dots\",\n                            x: \"hp\",\n                            y: \"mpg\",\n                            fill: \"var(--chart-1)\",\n                            r: 3.5,\n                            stroke: \"var(--background)\",\n                            strokeWidth: 1,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleLinear().domain([50, 310]),\n                            axis: { label: \"Horsepower (HP)\" },\n                        },\n                        y: {\n                            scale: scaleLinear().domain([5, 50]),\n                            grid: true,\n                            axis: { label: \"Fuel Economy (MPG)\" },\n                        },\n                    },\n                    controls: [\n                        continuousCursor({\n                            position: controlledSignal<ContinuousCursorPosition<number, number> | null, any>(\n                                cursorPos,\n                                (next) => setCursorPos(next),\n                            ),\n                            xRule: {\n                                stroke: \"var(--muted-foreground)\",\n                                strokeWidth: 1,\n                                strokeDasharray: \"4 4\",\n                            },\n                            yRule: {\n                                stroke: \"var(--muted-foreground)\",\n                                strokeWidth: 1,\n                                strokeDasharray: \"4 4\",\n                            },\n                            marker: {\n                                radius: 5,\n                                fill: \"var(--background)\",\n                                stroke: \"var(--chart-1)\",\n                                strokeWidth: 2,\n                            },\n                            xLabel: {\n                                background: \"var(--foreground)\",\n                                color: \"var(--background)\",\n                                fontSize: 11,\n                                fontWeight: 600,\n                                radius: 4,\n                                paddingX: 6,\n                                paddingY: 3,\n                                format: (v: number) => `${Math.round(v)} HP`,\n                            },\n                            yLabel: {\n                                side: \"start\",\n                                background: \"var(--foreground)\",\n                                color: \"var(--background)\",\n                                fontSize: 11,\n                                fontWeight: 600,\n                                radius: 4,\n                                paddingX: 6,\n                                paddingY: 3,\n                                format: (v: number) => `${v.toFixed(1)} MPG`,\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                { keyboard: false },\n            ),\n        [cursorPos, data],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Free 2D Continuous Crosshair Cursor</CardTitle>\n                <CardDescription>\n                    Arbitrary XY continuous crosshairs with floating dynamic tick axis coordinate readouts\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=\"Free 2D Continuous Crosshair Cursor 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                    {cursorPos\n                        ? `Coordinates: ${Math.round(cursorPos.x)} HP · ${cursorPos.y.toFixed(1)} MPG`\n                        : \"Move mouse over plot area\"}{\" \"}\n                    <Crosshair className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    `continuousCursor` evaluates non-discrete 2D coordinates across spatial plane\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default EchartsFreeCursor;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Arbitrary XY continuous crosshairs with dynamic coordinate popup tooltip. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack",
      "tooltip"
    ]
  }
}