{
  "title": "Premium KPI Sparklines",
  "description": "Compact micro sparkline KPI cards with trend indicators.",
  "name": "tanstack-charts-premium-kpi-sparklines",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale",
    "d3-shape"
  ],
  "registryDependencies": [
    "card"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/premium-kpi-sparklines.tsx",
      "type": "registry:block",
      "content": "import { areaY, d3Curve, defineChart, lineY } from \"@tanstack/charts\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { useMemo } from \"react\";\n\nimport { scaleLinear, scalePoint } from \"d3-scale\";\nimport { curveMonotoneX } from \"d3-shape\";\nimport { TrendingDown, TrendingUp } from \"lucide-react\";\n\nimport { Card, CardContent, CardHeader, CardTitle } from \"@/components/ui/card\";\n\ninterface SparklineDatum {\n    id: number;\n    period: number;\n    value: number;\n}\n\ninterface KpiMetric {\n    id: string;\n    label: string;\n    value: string;\n    trend: string;\n    trendDirection: \"up\" | \"down\";\n    surface: \"area\" | \"line\";\n    colorToken: string;\n    rows: SparklineDatum[];\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst smoothCurve = d3Curve(curveMonotoneX);\n\nfunction generateKpiMetrics(): KpiMetric[] {\n    const generateRows = (base: number, volatility: number) => {\n        const rows: SparklineDatum[] = [];\n        let val = base;\n        for (let i = 1; i <= 12; i++) {\n            val += Math.sin(i * 0.6) * volatility + (Math.random() - 0.4) * (volatility * 0.8);\n            rows.push({ id: i, period: i, value: Math.max(10, val) });\n        }\n        return rows;\n    };\n\n    return [\n        {\n            id: \"revenue\",\n            label: \"Monthly Recurring Revenue\",\n            value: \"$124,500\",\n            trend: \"+12.4%\",\n            trendDirection: \"up\",\n            surface: \"area\",\n            colorToken: \"var(--chart-1)\",\n            rows: generateRows(100, 15),\n        },\n        {\n            id: \"customers\",\n            label: \"Active Subscriptions\",\n            value: \"1,420\",\n            trend: \"+8.1%\",\n            trendDirection: \"up\",\n            surface: \"area\",\n            colorToken: \"var(--chart-2)\",\n            rows: generateRows(1200, 60),\n        },\n        {\n            id: \"churn\",\n            label: \"User Churn Rate\",\n            value: \"1.82%\",\n            trend: \"-0.4%\",\n            trendDirection: \"down\",\n            surface: \"line\",\n            colorToken: \"var(--chart-3)\",\n            rows: generateRows(2.2, 0.3),\n        },\n    ];\n}\n\nfunction KpiCard({ metric }: { metric: KpiMetric }) {\n    const definition = useMemo(() => {\n        const values = metric.rows.map((r) => r.value);\n        const minimum = Math.min(...values);\n        const maximum = Math.max(...values);\n        const pad = Math.max((maximum - minimum) * 0.15, 0.1);\n        const baseline = minimum - pad;\n\n        const line = lineY(metric.rows, {\n            id: `${metric.id}-line`,\n            x: \"period\",\n            y: \"value\",\n            key: \"id\",\n            stroke: metric.colorToken,\n            strokeWidth: 2.2,\n            curve: smoothCurve,\n        });\n\n        const marks =\n            metric.surface === \"area\"\n                ? [\n                      areaY(metric.rows, {\n                          id: `${metric.id}-area`,\n                          x: \"period\",\n                          y: \"value\",\n                          y1: baseline,\n                          key: \"id\",\n                          fill: `url(#${metric.id}-fill)`,\n                          fillOpacity: 1,\n                          curve: smoothCurve,\n                      }),\n                      line,\n                  ]\n                : [line];\n\n        return defineChart({\n            renderer: motionRenderer,\n            marks,\n            gradients:\n                metric.surface === \"area\"\n                    ? [\n                          {\n                              id: `${metric.id}-fill`,\n                              x1: 0,\n                              y1: 0,\n                              x2: 0,\n                              y2: 1,\n                              stops: [\n                                  { offset: 0, color: metric.colorToken, opacity: 0.3 },\n                                  { offset: 1, color: metric.colorToken, opacity: 0 },\n                              ],\n                          },\n                      ]\n                    : [],\n            scales: {\n                x: {\n                    scale: scalePoint<number>()\n                        .domain(metric.rows.map((r) => r.period))\n                        .padding(0.05),\n                    axis: false,\n                },\n                y: {\n                    scale: scaleLinear().domain([baseline, maximum + pad]),\n                    axis: false,\n                },\n            },\n            margin: { top: 4, right: 4, bottom: 4, left: 4 },\n            theme: {\n                foreground: \"transparent\",\n                grid: \"transparent\",\n                background: \"transparent\",\n            },\n        });\n    }, [metric]);\n\n    return (\n        <Card className=\"flex flex-col justify-between p-4\">\n            <CardHeader className=\"flex-row items-center justify-between space-y-0 p-0 pb-2\">\n                <CardTitle className=\"text-muted-foreground text-xs font-medium\">{metric.label}</CardTitle>\n                <div\n                    className={`flex items-center text-xs font-semibold ${\n                        metric.trendDirection === \"up\" ? \"text-emerald-500\" : \"text-amber-500\"\n                    }`}>\n                    {metric.trendDirection === \"up\" ? (\n                        <TrendingUp className=\"mr-1 h-3.5 w-3.5\" />\n                    ) : (\n                        <TrendingDown className=\"mr-1 h-3.5 w-3.5\" />\n                    )}\n                    {metric.trend}\n                </div>\n            </CardHeader>\n            <CardContent className=\"space-y-2 p-0\">\n                <div className=\"text-2xl font-bold tracking-tight\">{metric.value}</div>\n                <div className=\"h-[60px] w-full\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={60}\n                        ariaLabel={`${metric.label} sparkline trend`}\n                    />\n                </div>\n            </CardContent>\n        </Card>\n    );\n}\n\nexport function PremiumKpiSparklines() {\n    const metrics = useMemo(() => generateKpiMetrics(), []);\n\n    return (\n        <div className=\"grid w-full max-w-xl grid-cols-1 gap-4 sm:grid-cols-3\">\n            {metrics.map((metric) => (\n                <KpiCard key={metric.id} metric={metric} />\n            ))}\n        </div>\n    );\n}\n\nexport default PremiumKpiSparklines;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Compact micro sparkline KPI cards with trend indicators. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}