{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "kpi-row",
  "title": "KPI Row",
  "author": "Ballmac <https://ui.ballmac.com>",
  "description": "A compact, semantic row of key metrics that adapts from one to four columns.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/ballmac/components/kpi-row.tsx",
      "content": "// Ballmac UI: KPI Row. https://ui.ballmac.com/components/kpi-row\nimport * as React from \"react\"\nimport { cn } from \"@/lib/utils\"\n\ntype KpiRowProps = React.ComponentProps<\"dl\"> & {\n  /** Number of columns at wide widths. */\n  columns?: 2 | 3 | 4\n}\ntype KpiItemProps = React.ComponentProps<\"div\"> & {\n  /** Metric label. */\n  label: string\n  /** Metric value. */\n  value: React.ReactNode\n  /** Supporting context or comparison. */\n  detail?: React.ReactNode\n}\n\nfunction KpiRow({ className, columns = 3, ...props }: KpiRowProps) {\n  return (\n    <dl\n      data-slot=\"kpi-row\"\n      data-columns={columns}\n      className={cn(\n        \"bg-card grid min-w-0 grid-cols-1 overflow-hidden rounded-xl border border-border sm:grid-cols-2 data-[columns=3]:lg:grid-cols-3 data-[columns=4]:lg:grid-cols-4\",\n        className,\n      )}\n      {...props}\n    />\n  )\n}\nfunction KpiItem({ className, label, value, detail, ...props }: KpiItemProps) {\n  return (\n    <div\n      data-slot=\"kpi-item\"\n      className={cn(\n        \"flex min-w-0 flex-col gap-2 border-b border-border p-5 last:border-b-0 sm:border-b-0 sm:border-e sm:last:border-e-0\",\n        className,\n      )}\n      {...props}\n    >\n      <dt className=\"text-muted-foreground text-xs font-medium uppercase tracking-wide\">\n        {label}\n      </dt>\n      <dd className=\"truncate text-2xl font-semibold tabular-nums tracking-tight\">\n        {value}\n      </dd>\n      {detail && <dd className=\"text-muted-foreground text-xs\">{detail}</dd>}\n    </div>\n  )\n}\nexport { KpiRow, KpiItem, type KpiRowProps, type KpiItemProps }\n",
      "type": "registry:ui",
      "target": "@components/ballmac/kpi-row.tsx"
    }
  ],
  "meta": {
    "schema": 1,
    "tier": "free",
    "tags": [
      "metric",
      "dashboard",
      "summary"
    ],
    "version": "1.0.0",
    "updated": "2026-09-30",
    "ai": {
      "summary": "A compact, semantic row of key metrics that adapts from one to four columns.",
      "whenToUse": [
        "Show several related metrics together"
      ],
      "whenNotToUse": [
        "Use Stat Card when each metric needs more context"
      ],
      "composesWith": [
        "stat-card"
      ],
      "a11y": [
        {
          "keys": "None",
          "action": "Static content is announced with semantic structure"
        }
      ],
      "customization": [
        "Content, layout, and token-based className styling"
      ]
    },
    "examples": [
      "kpi-row-demo",
      "kpi-row-states"
    ],
    "url": "https://ui.ballmac.com/components/kpi-row"
  },
  "categories": [
    "data-display"
  ],
  "type": "registry:ui"
}