{
  "title": "Grouped Tooltip",
  "description": "Multi-series grouped tooltip combining all series data points for a single X-index focus.",
  "name": "tanstack-charts-grouped-tooltip",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/tooltip/grouped-tooltip.tsx",
      "type": "registry:block",
      "content": "import { type ChartPoint, bandX, defineChart, dot, lineY, whenFocused } from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { portal } from \"@tanstack/charts/tooltip/portal\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { scaleLinear, scaleUtc } from \"d3-scale\";\nimport { Layers } from \"lucide-react\";\n\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface GroupedTooltipDatum {\n    date: Date;\n    industry: string;\n    unemployed: number;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst industryNames = [\"Tech\", \"Finance\", \"Services\"];\n\nfunction generateDemoData(): GroupedTooltipDatum[] {\n    const baseDate = new Date(2025, 0, 1);\n    const results: GroupedTooltipDatum[] = [];\n\n    for (let i = 0; i < 10; i++) {\n        const d = new Date(baseDate);\n        d.setMonth(baseDate.getMonth() + i);\n        results.push({ date: d, industry: \"Tech\", unemployed: 120 + Math.sin(i * 0.5) * 20 });\n        results.push({ date: d, industry: \"Finance\", unemployed: 190 + Math.cos(i * 0.6) * 30 });\n        results.push({ date: d, industry: \"Services\", unemployed: 150 + Math.sin(i * 0.8) * 15 });\n    }\n    return results;\n}\n\nfunction shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {\n    if (points.length === 0) return { title: \"\", rows: [] };\n    const dateVal = (points[0].datum as GroupedTooltipDatum)?.date;\n    const dateObj = dateVal ? (dateVal instanceof Date ? dateVal : new Date(dateVal)) : null;\n    const titleStr =\n        dateObj && !isNaN(dateObj.getTime())\n            ? dateObj.toLocaleDateString(\"en-US\", { month: \"short\", year: \"numeric\" })\n            : \"\";\n    return {\n        title: titleStr,\n        rows: points.map((p) => {\n            const d = p.datum as GroupedTooltipDatum;\n            return {\n                label: d.industry,\n                value: `${d.unemployed.toFixed(0)}k unemployed`,\n                color: p.color || \"var(--chart-1)\",\n            };\n        }),\n    };\n}\n\nexport function GroupedTooltipChart() {\n    const data = useMemo(() => generateDemoData(), []);\n\n    const dates = useMemo(() => {\n        return data.filter((row) => row.industry === industryNames[0]);\n    }, [data]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        whenFocused(\n                            bandX(dates, {\n                                id: \"focus-date-band\",\n                                x: \"date\",\n                                fill: \"var(--foreground)\",\n                                fillOpacity: 0.08,\n                                inset: 3,\n                                radius: 4,\n                            }),\n                            { match: \"x\" },\n                        ),\n                        lineY(data, {\n                            id: \"grouped-lines\",\n                            x: \"date\",\n                            y: \"unemployed\",\n                            color: \"industry\",\n                            strokeWidth: 2,\n                        }),\n                        dot(data, {\n                            id: \"grouped-points\",\n                            x: \"date\",\n                            y: \"unemployed\",\n                            z: \"industry\",\n                            color: \"industry\",\n                            r: 3,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleUtc,\n                            axis: {\n                                line: false,\n                                label: \"Month\",\n                                ticks: {\n                                    size: 0,\n                                    padding: 10,\n                                    format: (d: Date) => d.toLocaleDateString(\"en-US\", { month: \"short\" }),\n                                },\n                            },\n                        },\n                        y: {\n                            scale: scaleLinear().domain([80, 240]),\n                            grid: true,\n                            axis: {\n                                line: false,\n                                label: \"Unemployed Volume (k)\",\n                                ticks: { size: 0 },\n                            },\n                        },\n                    },\n                    color: {\n                        domain: industryNames,\n                        range: [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"],\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                        portal,\n                        anchor: \"group-center\",\n                        placement: \"auto\",\n                        className:\n                            \"font-sans shadow-none! rounded-md bg-popover text-popover-foreground border p-2 text-xs\",\n                        content: (points) => shadcnTooltipContent(points),\n                    },\n                },\n            ),\n        [data, dates],\n    );\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Group-Focused Category Tooltip</CardTitle>\n                <CardDescription>\n                    Multi-series grouped tooltip combining all series data points for a single X-index focus\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=\"Group-Focused Category Tooltip 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                    Hovering highlights shared temporal band across all 3 sector series{\" \"}\n                    <Layers className=\"h-4 w-4 text-blue-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    Group-center anchor presents a unified popover card detailing all active series\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default GroupedTooltipChart;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Multi-series grouped tooltip combining all series data points for a single X-index focus. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack",
      "tooltip"
    ]
  }
}