{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "bar-list",
  "title": "Bar List",
  "description": "A ranked list with proportional bars, for top pages, referrers, or countries.",
  "files": [
    {
      "path": "registry/dashboardcn/ui/bar-list.tsx",
      "content": "import * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport { formatNumber } from \"@/registry/dashboardcn/lib/format\"\n\nexport interface BarListItem {\n  name: string\n  value: number\n  /** Renders the label as a link. */\n  href?: string\n  icon?: React.ReactNode\n  /** Stable key when names can repeat. */\n  key?: string\n}\n\nexport interface BarListProps extends React.ComponentProps<\"div\"> {\n  data: BarListItem[]\n  valueFormatter?: (value: number) => string\n  sortOrder?: \"descending\" | \"ascending\" | \"none\"\n  /** Any CSS color. Defaults to chart-1. */\n  color?: string\n  /** Show each row's share of the total next to its value. */\n  showPercentage?: boolean\n  onItemClick?: (item: BarListItem) => void\n}\n\nfunction BarList({\n  data,\n  valueFormatter = (value) => formatNumber(value, { format: \"compact\" }),\n  sortOrder = \"descending\",\n  color = \"var(--chart-1)\",\n  showPercentage = false,\n  onItemClick,\n  className,\n  ...props\n}: BarListProps) {\n  const items = React.useMemo(() => {\n    if (sortOrder === \"none\") return data\n    const sorted = [...data].sort((a, b) => a.value - b.value)\n    return sortOrder === \"descending\" ? sorted.reverse() : sorted\n  }, [data, sortOrder])\n  const max = Math.max(...items.map((item) => item.value), 0)\n  const total = items.reduce((sum, item) => sum + item.value, 0)\n\n  return (\n    <div\n      data-slot=\"bar-list\"\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      {items.map((item) => {\n        const width = max > 0 ? (item.value / max) * 100 : 0\n        const share = total > 0 ? item.value / total : 0\n        const interactive = Boolean(item.href || onItemClick)\n        const Label = item.href ? \"a\" : onItemClick ? \"button\" : \"div\"\n\n        return (\n          <div\n            key={item.key ?? item.name}\n            data-slot=\"bar-list-row\"\n            className=\"flex items-center gap-3 text-sm\"\n          >\n            <div className=\"relative flex h-8 min-w-0 flex-1 items-center\">\n              <div\n                aria-hidden=\"true\"\n                className=\"absolute inset-y-0 left-0 rounded-md transition-[width] duration-300\"\n                style={{\n                  width: `${width}%`,\n                  backgroundColor: `color-mix(in oklab, ${color} 20%, transparent)`,\n                }}\n              />\n              <Label\n                {...(item.href ? { href: item.href } : {})}\n                {...(onItemClick && !item.href\n                  ? { type: \"button\" as const, onClick: () => onItemClick(item) }\n                  : {})}\n                className={cn(\n                  \"relative flex min-w-0 items-center gap-2 px-2 text-left\",\n                  interactive && \"hover:underline\"\n                )}\n              >\n                {item.icon ? (\n                  <span className=\"text-muted-foreground shrink-0 [&>svg]:size-4\">\n                    {item.icon}\n                  </span>\n                ) : null}\n                <span className=\"truncate\">{item.name}</span>\n              </Label>\n            </div>\n            <div className=\"flex shrink-0 items-center gap-2 tabular-nums\">\n              <span className=\"font-medium\">{valueFormatter(item.value)}</span>\n              {showPercentage ? (\n                <span className=\"text-muted-foreground w-12 text-right text-xs\">\n                  {formatNumber(share, { format: \"percent\" })}\n                </span>\n              ) : null}\n            </div>\n          </div>\n        )\n      })}\n    </div>\n  )\n}\n\nexport { BarList }\n",
      "type": "registry:ui"
    },
    {
      "path": "registry/dashboardcn/lib/format.ts",
      "content": "export type NumberFormat = \"number\" | \"compact\" | \"currency\" | \"percent\"\n\nexport interface FormatNumberOptions {\n  format?: NumberFormat\n  /** ISO 4217 code, used when format is \"currency\". Defaults to USD. */\n  currency?: string\n  locale?: string\n  maximumFractionDigits?: number\n  /** Abbreviate large values, e.g. \"$158K\" instead of \"$158,143\". */\n  compact?: boolean\n}\n\nconst formatterCache = new Map<string, Intl.NumberFormat>()\n\nfunction getFormatter(locale: string, options: Intl.NumberFormatOptions) {\n  const key = locale + JSON.stringify(options)\n  let formatter = formatterCache.get(key)\n  if (!formatter) {\n    formatter = new Intl.NumberFormat(locale, options)\n    formatterCache.set(key, formatter)\n  }\n  return formatter\n}\n\n/**\n * Format a metric value for display.\n *\n * formatNumber(1234567)                          -> \"1,234,567\"\n * formatNumber(1234567, { format: \"compact\" })   -> \"1.2M\"\n * formatNumber(48.2, { format: \"currency\" })     -> \"$48.20\"\n * formatNumber(158143, { format: \"currency\", compact: true }) -> \"$158K\"\n * formatNumber(0.124, { format: \"percent\" })     -> \"12.4%\"\n */\nexport function formatNumber(\n  value: number,\n  {\n    format = \"number\",\n    currency = \"USD\",\n    locale = \"en-US\",\n    maximumFractionDigits,\n    compact = false,\n  }: FormatNumberOptions = {}\n): string {\n  if (!Number.isFinite(value)) return \"—\"\n\n  // Compact values keep three significant digits: $158K, $1.23M, 41.2K.\n  const compactOptions: Intl.NumberFormatOptions = compact\n    ? maximumFractionDigits === undefined\n      ? { notation: \"compact\", maximumSignificantDigits: 3 }\n      : { notation: \"compact\", maximumFractionDigits }\n    : {}\n  switch (format) {\n    case \"compact\":\n      return getFormatter(locale, {\n        notation: \"compact\",\n        maximumFractionDigits: maximumFractionDigits ?? 1,\n      }).format(value)\n    case \"currency\":\n      return getFormatter(locale, {\n        style: \"currency\",\n        currency,\n        maximumFractionDigits: maximumFractionDigits ?? 2,\n        ...compactOptions,\n      }).format(value)\n    case \"percent\":\n      return getFormatter(locale, {\n        style: \"percent\",\n        maximumFractionDigits: maximumFractionDigits ?? 1,\n      }).format(value)\n    default:\n      return getFormatter(locale, {\n        maximumFractionDigits: maximumFractionDigits ?? 0,\n        ...compactOptions,\n      }).format(value)\n  }\n}\n\n/**\n * Format a fractional change as a signed percentage.\n *\n * formatDelta(0.124)  -> \"+12.4%\"\n * formatDelta(-0.03)  -> \"-3.0%\"\n * formatDelta(0)      -> \"0.0%\"\n */\nexport function formatDelta(delta: number, locale = \"en-US\"): string {\n  if (!Number.isFinite(delta)) return \"—\"\n  return getFormatter(locale, {\n    style: \"percent\",\n    signDisplay: \"exceptZero\",\n    maximumFractionDigits: 1,\n    minimumFractionDigits: 1,\n  }).format(delta)\n}\n\n/**\n * Fractional change between two values. Returns 0 when there is no baseline.\n */\nexport function computeDelta(current: number, previous: number): number {\n  if (!previous) return 0\n  return (current - previous) / Math.abs(previous)\n}\n",
      "type": "registry:lib"
    }
  ],
  "type": "registry:ui"
}