{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "activity-heatmap",
  "title": "Activity Heatmap",
  "description": "A calendar heatmap of daily activity, in the style of a contribution graph.",
  "registryDependencies": [
    "tooltip"
  ],
  "files": [
    {
      "path": "registry/dashboardcn/ui/activity-heatmap.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport { formatNumber } from \"@/registry/dashboardcn/lib/format\"\nimport {\n  Tooltip,\n  TooltipContent,\n  TooltipProvider,\n  TooltipTrigger,\n} from \"@/components/ui/tooltip\"\n\nexport interface ActivityDatum {\n  /** ISO date, YYYY-MM-DD. */\n  date: string\n  value: number\n}\n\nexport interface ActivityHeatmapProps extends React.ComponentProps<\"div\"> {\n  data: ActivityDatum[]\n  /** Last day shown. Defaults to today. */\n  endDate?: Date\n  /** Number of week columns. Ignored when `startDate` is set. */\n  weeks?: number\n  /** First day shown. Overrides `weeks`. */\n  startDate?: Date\n  /** Any CSS color. Levels are mixed from this and `--muted`. Defaults to chart-1. */\n  color?: string\n  /**\n   * Explicit color per level, from empty to most active.\n   * Overrides `color`. Length sets the number of levels.\n   */\n  colors?: string[]\n  /** How values map to levels. `sqrt` spreads out small values. */\n  scale?: \"linear\" | \"sqrt\"\n  /** Cell size in px. */\n  cellSize?: number\n  /** Gap between cells in px. */\n  gap?: number\n  valueFormatter?: (value: number) => string\n  /** Label for the value in the tooltip, e.g. \"events\". */\n  unit?: string\n  showMonthLabels?: boolean\n  /** Which weekday labels to show along the left edge. */\n  weekdayLabels?: \"mwf\" | \"all\" | \"none\"\n  showLegend?: boolean\n  /** Scroll to the most recent weeks when the grid overflows. */\n  scrollToEnd?: boolean\n  /** Replace the tooltip body. Return `null` to hide it for that cell. */\n  renderTooltip?: (datum: { date: Date; value: number }) => React.ReactNode\n  onCellClick?: (datum: { date: Date; value: number }) => void\n}\n\nconst DAY = 24 * 60 * 60 * 1000\nconst WEEKDAYS = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"]\n\nfunction toKey(date: Date) {\n  const y = date.getFullYear()\n  const m = String(date.getMonth() + 1).padStart(2, \"0\")\n  const d = String(date.getDate()).padStart(2, \"0\")\n  return `${y}-${m}-${d}`\n}\n\nfunction startOfDay(date: Date) {\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate())\n}\n\nfunction addDays(date: Date, days: number) {\n  return new Date(date.getTime() + days * DAY)\n}\n\nfunction levelFor(\n  value: number,\n  max: number,\n  levels: number,\n  scale: \"linear\" | \"sqrt\"\n) {\n  if (value <= 0 || max <= 0) return 0\n  let t = value / max\n  if (scale === \"sqrt\") t = Math.sqrt(t)\n  return Math.min(levels - 1, Math.max(1, Math.ceil(t * (levels - 1))))\n}\n\nfunction mixedColors(color: string, levels: number) {\n  return Array.from({ length: levels }, (_, level) => {\n    if (level === 0) return \"var(--muted)\"\n    const pct = Math.round(25 + ((level - 1) / (levels - 2)) * 75)\n    return `color-mix(in oklab, ${color} ${pct}%, var(--muted))`\n  })\n}\n\nfunction ActivityHeatmap({\n  data,\n  endDate,\n  weeks = 52,\n  startDate,\n  color = \"var(--chart-1)\",\n  colors,\n  scale = \"linear\",\n  cellSize = 12,\n  gap = 3,\n  valueFormatter = (value) => formatNumber(value),\n  unit = \"events\",\n  showMonthLabels = true,\n  weekdayLabels = \"mwf\",\n  showLegend = true,\n  scrollToEnd = true,\n  renderTooltip,\n  onCellClick,\n  className,\n  ...props\n}: ActivityHeatmapProps) {\n  const endTime = startOfDay(endDate ?? new Date()).getTime()\n  const startTime = startDate\n    ? startOfDay(startDate).getTime()\n    : endTime - (weeks * 7 - 1) * DAY\n\n  const values = React.useMemo(\n    () => new Map(data.map((d) => [d.date, d.value])),\n    [data]\n  )\n  const max = React.useMemo(\n    () => data.reduce((acc, d) => Math.max(acc, d.value), 0),\n    [data]\n  )\n\n  // Columns are full weeks, Sunday first. Days before `start` in the first\n  // week and after `end` in the last are left empty rather than filled in.\n  const columns = React.useMemo(() => {\n    const start = new Date(startTime)\n    const end = new Date(endTime)\n    const result: (Date | null)[][] = []\n    let cursor = addDays(start, -start.getDay())\n    while (cursor <= end) {\n      const week: (Date | null)[] = []\n      for (let i = 0; i < 7; i++) {\n        const day = addDays(cursor, i)\n        week.push(day < start || day > end ? null : day)\n      }\n      result.push(week)\n      cursor = addDays(cursor, 7)\n    }\n    return result\n  }, [startTime, endTime])\n\n  // Month labels span the weeks whose first shown day falls in that month.\n  const months = React.useMemo(() => {\n    const groups: { label: string; from: number; to: number }[] = []\n    const formatter = new Intl.DateTimeFormat(\"en-US\", { month: \"short\" })\n    columns.forEach((week, index) => {\n      const first = week.find((d): d is Date => d !== null)\n      if (!first) return\n      const key = `${first.getFullYear()}-${first.getMonth()}`\n      const last = groups[groups.length - 1]\n      if (last && last.label === key) {\n        last.to = index\n      } else {\n        groups.push({ label: key, from: index, to: index })\n      }\n    })\n    return groups\n      .filter((g) => g.to - g.from >= 1)\n      .map((g) => ({\n        ...g,\n        label: formatter.format(columns[g.from]!.find(Boolean) as Date),\n      }))\n  }, [columns])\n\n  const palette = colors && colors.length > 1 ? colors : mixedColors(color, 5)\n  const levels = palette.length\n\n  const dateFormatter = new Intl.DateTimeFormat(\"en-US\", {\n    weekday: \"short\",\n    month: \"short\",\n    day: \"numeric\",\n    year: \"numeric\",\n  })\n\n  const scrollRef = React.useRef<HTMLDivElement>(null)\n  React.useLayoutEffect(() => {\n    const node = scrollRef.current\n    if (!node || !scrollToEnd) return\n    node.scrollLeft = node.scrollWidth\n  }, [scrollToEnd, columns.length, cellSize, gap])\n\n  const hasHeader = showMonthLabels\n  const hasWeekdays = weekdayLabels !== \"none\"\n  const fontSize = Math.max(10, Math.min(12, cellSize))\n\n  return (\n    <div\n      data-slot=\"activity-heatmap\"\n      className={cn(\"flex min-w-0 flex-col gap-2 text-xs\", className)}\n      {...props}\n    >\n      <div className=\"flex min-w-0\">\n        {hasWeekdays ? (\n          <div\n            aria-hidden\n            className=\"grid shrink-0 pr-1\"\n            style={{\n              gap,\n              gridTemplateRows: `${hasHeader ? `${fontSize}px` : \"0px\"} repeat(7, ${cellSize}px)`,\n            }}\n          >\n            <div />\n            {WEEKDAYS.map((day, index) => (\n              <div\n                key={day}\n                className=\"text-muted-foreground flex items-center leading-none whitespace-nowrap\"\n                style={{ fontSize }}\n              >\n                {weekdayLabels === \"all\" || index % 2 === 1 ? day : \"\"}\n              </div>\n            ))}\n          </div>\n        ) : null}\n        <div\n          ref={scrollRef}\n          className=\"min-w-0 flex-1 overflow-x-auto overscroll-x-contain [scrollbar-width:thin] [scrollbar-color:color-mix(in_oklab,var(--foreground)_20%,transparent)_transparent]\"\n        >\n          <TooltipProvider delayDuration={100} skipDelayDuration={0}>\n            <div\n              role=\"group\"\n              aria-label=\"Activity heatmap\"\n              className=\"grid w-max\"\n              style={{\n                gap,\n                gridTemplateColumns: `repeat(${columns.length}, ${cellSize}px)`,\n                gridTemplateRows: `${hasHeader ? `${fontSize}px` : \"0px\"} repeat(7, ${cellSize}px)`,\n              }}\n            >\n              {hasHeader\n                ? months.map((month) => (\n                    <div\n                      key={`${month.from}-${month.label}`}\n                      className=\"text-muted-foreground self-end leading-none whitespace-nowrap\"\n                      style={{\n                        gridRow: 1,\n                        gridColumn: `${month.from + 1} / ${month.to + 2}`,\n                        fontSize,\n                      }}\n                    >\n                      {month.label}\n                    </div>\n                  ))\n                : null}\n\n              {columns.map((week, weekIndex) =>\n                week.map((day, dayIndex) => {\n                  const style = {\n                    gridColumn: weekIndex + 1,\n                    gridRow: dayIndex + 2,\n                  }\n                  if (!day) {\n                    return <div key={dayIndex} aria-hidden style={style} />\n                  }\n                  const value = values.get(toKey(day)) ?? 0\n                  const level = levelFor(value, max, levels, scale)\n                  const datum = { date: day, value }\n                  const body = renderTooltip ? (\n                    renderTooltip(datum)\n                  ) : (\n                    <>\n                      <span className=\"font-medium tabular-nums\">\n                        {valueFormatter(value)} {unit}\n                      </span>\n                      <span className=\"text-background/70 block\">\n                        {dateFormatter.format(day)}\n                      </span>\n                    </>\n                  )\n                  const label = `${valueFormatter(value)} ${unit} on ${dateFormatter.format(day)}`\n\n                  const cell = (\n                    <button\n                      type=\"button\"\n                      aria-label={label}\n                      data-level={level}\n                      data-date={toKey(day)}\n                      onClick={onCellClick ? () => onCellClick(datum) : undefined}\n                      className={cn(\n                        \"focus-visible:ring-ring/60 ring-inset rounded-[2px] outline-none transition-[filter] duration-100 hover:brightness-110 focus-visible:ring-2 dark:hover:brightness-125\",\n                        \"inset-ring-foreground/6 inset-ring\",\n                        onCellClick ? \"cursor-pointer\" : \"cursor-default\"\n                      )}\n                      style={{ ...style, backgroundColor: palette[level] }}\n                    />\n                  )\n\n                  if (body === null) {\n                    return <React.Fragment key={dayIndex}>{cell}</React.Fragment>\n                  }\n\n                  return (\n                    <Tooltip key={dayIndex}>\n                      <TooltipTrigger asChild>{cell}</TooltipTrigger>\n                      <TooltipContent sideOffset={4} className=\"text-left\">\n                        {body}\n                      </TooltipContent>\n                    </Tooltip>\n                  )\n                })\n              )}\n            </div>\n          </TooltipProvider>\n        </div>\n      </div>\n\n      {showLegend ? (\n        <div\n          className=\"text-muted-foreground flex items-center justify-end gap-1\"\n          style={{ fontSize }}\n        >\n          <span className=\"mr-0.5\">Less</span>\n          {palette.map((fill, level) => (\n            <span\n              key={level}\n              className=\"inset-ring-foreground/6 inset-ring rounded-[2px]\"\n              style={{\n                width: cellSize,\n                height: cellSize,\n                backgroundColor: fill,\n              }}\n            />\n          ))}\n          <span className=\"ml-0.5\">More</span>\n        </div>\n      ) : null}\n    </div>\n  )\n}\n\nexport { ActivityHeatmap }\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"
}