{
  "title": "Semicircular Metric Needle Dial Gauge",
  "description": "Arc dial gauge featuring colored risk zones and animated needle pointer.",
  "name": "tanstack-charts-needle-gauge",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/pie/needle-gauge.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, defineChart } from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { pie, polar, radialArc, radialDot, radialRule, radialText } from \"@tanstack/charts/polar\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { scaleLinear } from \"d3-scale\";\nimport { Gauge } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface GaugeBand {\n    id: string;\n    label: string;\n    value: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst startAngle = -Math.PI / 2;\nconst endAngle = Math.PI / 2;\nconst gaugeMaximum = 100;\n\nconst gaugeBands: GaugeBand[] = [\n    { id: \"low\", label: \"Normal (0-50%)\", value: 50 },\n    { id: \"elevated\", label: \"Warning (50-80%)\", value: 30 },\n    { id: \"high\", label: \"Critical (80-100%)\", value: 20 },\n];\n\nconst bandIds = [\"low\", \"elevated\", \"high\"];\nconst bandColors = [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"];\n\nfunction shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {\n    if (points.length === 0) return { title: \"\", rows: [] };\n    const d = points[0].datum as { label?: string; rate?: number };\n    if (!d) return { title: \"\", rows: [] };\n    return {\n        title: d.label || \"System Performance Load\",\n        rows: [\n            {\n                label: \"Gauge Value\",\n                value: d.rate !== undefined ? `${d.rate}%` : \"Zone Range\",\n                color: \"var(--chart-1)\",\n            },\n        ],\n    };\n}\n\nexport function NeedleGauge() {\n    const currentReading = useMemo(() => ({ id: \"reading\", rate: 68, label: \"Server CPU Load\" }), []);\n\n    const definition = useMemo(() => {\n        const angleScale = scaleLinear().domain([0, gaugeMaximum]);\n        const radiusScale = scaleLinear().domain([0, 1]);\n\n        const arcs = pie(gaugeBands, {\n            value: \"value\",\n            startAngle,\n            endAngle,\n        });\n\n        const ticks = [\n            { id: \"t1\", value: 25 },\n            { id: \"t2\", value: 50 },\n            { id: \"t3\", value: 75 },\n        ];\n\n        return defineChart(\n            {\n                renderer: motionRenderer,\n                scales: {\n                    x: null,\n                    y: null,\n                },\n                marks: [\n                    polar({\n                        scales: {\n                            angle: { scale: angleScale },\n                            radius: { scale: radiusScale },\n                        },\n                        startAngle,\n                        endAngle,\n                        radiusRatio: 0.85,\n                        marks: [\n                            radialArc(arcs, {\n                                id: \"gauge-bands\",\n                                key: \"id\",\n                                innerRadius: ({ radius }) => radius * 0.72,\n                                color: \"id\",\n                            }),\n                            radialRule(ticks, {\n                                id: \"gauge-ticks\",\n                                key: \"id\",\n                                angle: \"value\",\n                                radius1: 0.74,\n                                radius2: 0.94,\n                                stroke: \"var(--background)\",\n                                strokeOpacity: 0.85,\n                                strokeWidth: 2,\n                            }),\n                            radialRule([currentReading], {\n                                id: \"gauge-needle\",\n                                key: \"id\",\n                                angle: \"rate\",\n                                radius1: 0,\n                                radius2: 0.64,\n                                stroke: \"var(--foreground)\",\n                                strokeWidth: 3.5,\n                            }),\n                            radialDot([currentReading], {\n                                id: \"gauge-hub\",\n                                key: \"id\",\n                                angle: \"rate\",\n                                radius: 0,\n                                r: 7,\n                                fill: \"var(--foreground)\",\n                            }),\n                            radialText([currentReading], {\n                                id: \"gauge-value\",\n                                key: \"id\",\n                                angle: \"rate\",\n                                radius: 0,\n                                text: (row) => `${row.rate}%`,\n                                dy: 32,\n                                anchor: \"middle\",\n                                baseline: \"middle\",\n                                fill: \"var(--foreground)\",\n                                fontSize: 20,\n                                fontWeight: 700,\n                            }),\n                        ],\n                    }),\n                ],\n                color: { domain: bandIds, range: bandColors },\n                margin: { top: 20, right: 20, bottom: 20, left: 20 },\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: \"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    }, [currentReading]);\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Semicircular Metric Needle Dial Gauge</CardTitle>\n                <CardDescription>\n                    Arc dial gauge featuring colored risk thresholds, center hub, and rotating needle pointer\n                </CardDescription>\n            </CardHeader>\n            <CardContent>\n                <div className=\"h-[220px] w-full\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={220}\n                        ariaLabel=\"Semicircular Metric Needle Dial Gauge 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                    Current CPU Load reading pinned at {currentReading.rate}%{\" \"}\n                    <Gauge className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    `radialRule` combined with `radialDot` renders centered angular needle arms\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default NeedleGauge;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Arc dial gauge featuring colored risk zones and animated needle pointer. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}