{
  "$schema": "https://uipkge.dev/schema/registry-item.json",
  "name": "heatmap",
  "title": "Heatmap",
  "type": "registry:ui",
  "files": [
    {
      "path": "packages/registry-angular/components/charts/heatmap/heatmap.component.ts",
      "content": "import {\n  AfterViewInit,\n  Component,\n  ElementRef,\n  Input,\n  OnChanges,\n  OnDestroy,\n  SimpleChanges,\n  ViewChild,\n  ChangeDetectionStrategy,\n} from '@angular/core'\nimport type * as echarts from 'echarts/core'\nimport { cn } from '@/lib/utils'\nimport {\n  getChartAxisColor,\n  getChartColors,\n  getChartSplitLineColor,\n  getChartTextColor,\n  getChartTooltipBg,\n  getChartTooltipBorder,\n  getChartTooltipText,\n  mergeOptionBlock,\n} from '../use-chart-theme'\n\nexport type HeatmapPoint = { x: string; y: string; value: number }\nexport type HeatmapDatum = [number, number, number] | HeatmapPoint\n\nfunction isTuple(d: HeatmapDatum): d is [number, number, number] {\n  return Array.isArray(d)\n}\n\n/**\n * Angular port of the UIPKGE Heatmap — category/category intensity\n * grid with a continuous visual map. Standalone, theme-aware.\n */\n@Component({\n  changeDetection: ChangeDetectionStrategy.Eager,\n  selector: 'ui-heatmap, [ui-heatmap]',\n  standalone: true,\n  host: {\n    '[attr.data-slot]': '\"heatmap\"',\n    '[attr.data-uipkge]': '\"\"',\n    '[class]': 'hostClass',\n    '[attr.role]': '\"img\"',\n    '[attr.aria-label]': 'ariaLabel || \"Chart\"',\n    '[attr.tabindex]': '0',\n    '[style.height]': 'heightStyle',\n  },\n  template: `<div #chartEl class=\"size-full\"></div>`,\n})\nexport class UiHeatmapComponent implements AfterViewInit, OnChanges, OnDestroy {\n  /** `[xIndex, yIndex, value]` tuples (React/Vue shape). `{ x, y, value }` objects also accepted. */\n  @Input() data: HeatmapDatum[] = []\n  @Input() xLabels: string[] = []\n  @Input() yLabels: string[] = []\n  /** @deprecated Use `xLabels`. Kept for backwards compatibility. */\n  @Input() xCategories: string[] = []\n  /** @deprecated Use `yLabels`. Kept for backwards compatibility. */\n  @Input() yCategories: string[] = []\n  /** Visual-map minimum. Defaults to data min. */\n  @Input() min?: number\n  /** Visual-map maximum. Defaults to data max. */\n  @Input() max?: number\n  @Input() height: number | string = 300\n  @Input() option?: Record<string, unknown>\n  /** Accessible name announced for the chart image. Defaults to \"Chart\". */\n  @Input() ariaLabel?: string\n  @Input('class') className?: string\n\n  resolvedX(): string[] {\n    if (this.xLabels.length) return this.xLabels\n    if (this.xCategories.length) return this.xCategories\n    return [...new Set(this.data.filter((d): d is HeatmapPoint => !isTuple(d)).map((d) => d.x))]\n  }\n\n  resolvedY(): string[] {\n    if (this.yLabels.length) return this.yLabels\n    if (this.yCategories.length) return this.yCategories\n    return [...new Set(this.data.filter((d): d is HeatmapPoint => !isTuple(d)).map((d) => d.y))]\n  }\n\n  /** Data normalized to `[xIndex, yIndex, value]` triples. Pure. */\n  triples(): [number, number, number][] {\n    const xCats = this.resolvedX()\n    const yCats = this.resolvedY()\n    return this.data.map((d) =>\n      isTuple(d) ? d : [xCats.indexOf(d.x), yCats.indexOf(d.y), d.value],\n    )\n  }\n\n  extent(): [number, number] {\n    const values = this.triples().map((t) => t[2])\n    const lo = this.min ?? (values.length ? Math.min(...values) : 0)\n    const hi = this.max ?? (values.length ? Math.max(...values) : 1)\n    return [lo, hi]\n  }\n  @ViewChild('chartEl', { static: false }) chartEl?: ElementRef<HTMLDivElement>\n\n  private chart: echarts.ECharts | null = null\n  private unsubscribeTheme: (() => void) | null = null\n\n  get hostClass(): string {\n    return cn('block focus-visible:ring-ring w-full focus-visible:ring-2 focus-visible:outline-none', this.className)\n  }\n\n  get heightStyle(): string {\n    return /^\\d+$/.test(String(this.height)) ? `${this.height}px` : String(this.height)\n  }\n\n  /** Build the merged ECharts option (pure — no DOM needed, unit-testable). */\n  getOption(): Record<string, unknown> {\n    const colors = getChartColors()\n    const xCats = this.resolvedX()\n    const yCats = this.resolvedY()\n    const [lo, hi] = this.extent()\n    const values = this.triples()\n\n    const userOption: Record<string, any> = this.option ?? {}\n    const {\n      series: userSeries,\n      xAxis: userXAxis,\n      yAxis: userYAxis,\n      grid: userGrid,\n      visualMap: userVisualMap,\n      tooltip: userTooltip,\n      ...userRest\n    } = userOption\n\n    return {\n      color: colors,\n      grid: mergeOptionBlock(\n        { left: 16, right: 16, top: 24, bottom: 24, outerBoundsMode: 'same', outerBoundsContain: 'axisLabel' },\n        userGrid,\n      ),\n      tooltip: mergeOptionBlock(\n        {\n          trigger: 'item',\n          position: 'top',\n          backgroundColor: getChartTooltipBg(),\n          borderColor: getChartTooltipBorder(),\n          textStyle: { color: getChartTooltipText(), fontSize: 12 },\n          formatter: (params: { value: [number, number, number] }) =>\n            `${yCats[params.value[1]]} / ${xCats[params.value[0]]}: ${params.value[2]}`,\n        },\n        userTooltip,\n      ),\n      xAxis: mergeOptionBlock(\n        {\n          type: 'category',\n          data: xCats,\n          axisLabel: { color: getChartTextColor(), fontSize: 11 },\n          axisTick: { show: false },\n          splitArea: { show: true },\n        },\n        userXAxis,\n      ),\n      yAxis: mergeOptionBlock(\n        {\n          type: 'category',\n          data: yCats,\n          axisLabel: { color: getChartTextColor(), fontSize: 11 },\n          axisTick: { show: false },\n          splitArea: { show: true },\n        },\n        userYAxis,\n      ),\n      visualMap: mergeOptionBlock(\n        {\n          min: lo,\n          max: hi,\n          calculable: true,\n          orient: 'horizontal',\n          left: 'center',\n          bottom: 0,\n          itemWidth: 12,\n          itemHeight: 80,\n          inRange: { color: [colors[0], colors[1], colors[2]] },\n          textStyle: { fontSize: 10 },\n        },\n        userVisualMap,\n      ),\n      series: Array.isArray(userSeries)\n        ? userSeries\n        : [\n            {\n              type: 'heatmap',\n              data: values,\n              label: { show: false },\n              itemStyle: { borderRadius: 2, borderWidth: 0 },\n              emphasis: {\n                itemStyle: { shadowBlur: 10, shadowColor: 'rgba(0,0,0,0.2)' },\n              },\n            },\n          ],\n      ...userRest,\n    }\n  }\n\n  /** ECharts chart + component modules, resolved lazily so SSR never loads canvas code. */\n  private chartModules(charts: Record<string, unknown>, comps: Record<string, unknown>): unknown[] {\n    return [charts['HeatmapChart'], comps['GridComponent'], comps['TooltipComponent'], comps['VisualMapComponent']]\n  }\n\n  async ngAfterViewInit(): Promise<void> {\n    if (typeof window === 'undefined' || !this.chartEl?.nativeElement) return\n    const [{ use }, { CanvasRenderer }, charts, comps] = await Promise.all([\n      import('echarts/core'),\n      import('echarts/renderers'),\n      import('echarts/charts'),\n      import('echarts/components'),\n    ])\n    use([CanvasRenderer, ...(this.chartModules(charts, comps) as never[])])\n    const { init } = await import('echarts/core')\n    this.chart = init(this.chartEl.nativeElement)\n    this.chart.setOption(this.getOption())\n    const { onChartThemeChange } = await import('../use-chart-theme')\n    this.unsubscribeTheme = onChartThemeChange(() => this.chart?.setOption(this.getOption()))\n    if (typeof ResizeObserver !== 'undefined') {\n      new ResizeObserver(() => this.chart?.resize()).observe(this.chartEl.nativeElement)\n    }\n  }\n\n  ngOnChanges(changes: SimpleChanges): void {\n    if (this.chart && Object.keys(changes).length) {\n      this.chart.setOption(this.getOption())\n    }\n  }\n\n  ngOnDestroy(): void {\n    this.unsubscribeTheme?.()\n    this.unsubscribeTheme = null\n    try {\n      this.chart?.dispose()\n    } catch {\n      /* already disposed */\n    }\n    this.chart = null\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/src/app/components/ui/charts/heatmap/heatmap.component.ts"
    },
    {
      "path": "packages/registry-angular/components/charts/heatmap/index.ts",
      "content": "export { UiHeatmapComponent } from './heatmap.component'\n",
      "type": "registry:ui",
      "target": "~/src/app/components/ui/charts/heatmap/index.ts"
    },
    {
      "path": "packages/registry-angular/components/charts/use-chart-theme.ts",
      "content": "// Angular port of `useChartTheme.ts` (Vue) — framework-free helpers + plain\n// functions instead of Vue `computed` refs. The palette is driven by Tailwind\n// v4 CSS variables (`--chart-1`..`--chart-5`, `--muted-foreground`, `--border`,\n// `--popover`, …) so dark/light flips happen automatically when the consumer\n// toggles their theme class. Values resolve at runtime via `getComputedStyle`,\n// so they pick up whatever the consumer set in their own `tailwind.css`.\n//\n// In a non-DOM environment (SSR / unit tests) every accessor returns the\n// fallback palette, which roughly matches the shadcn Neutral defaults so the\n// first paint doesn't flicker.\n\nexport const CHART_FALLBACK = ['#f59e0b', '#14b8a6', '#3b82f6', '#f97316', '#eab308']\n\n// ECharts' canvas renderer does not accept OKLCH in every browser. Assigning\n// one of our Tailwind tokens to `fillStyle` can silently leave the sentinel\n// colour in place, turning a whole chart black. Convert OKLCH ourselves and\n// let the canvas normalize older CSS colour formats.\nlet _hexCanvas: CanvasRenderingContext2D | null = null\n\nexport function toCanvasColor(cssColor: string): string {\n  const value = cssColor.trim()\n  const match = value.match(\n    /^oklch\\(\\s*([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(%?)\\s+([+-]?(?:\\d+\\.?\\d*|\\.\\d+))\\s+([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(?:deg)?(?:\\s*\\/\\s*([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(%?))?\\s*\\)$/i,\n  )\n\n  if (match) {\n    const lightness = Number(match[1]) / (match[2] === '%' ? 100 : 1)\n    const chroma = Number(match[3])\n    const hue = (Number(match[4]) * Math.PI) / 180\n    const alpha = match[5] == null ? 1 : Number(match[5]) / (match[6] === '%' ? 100 : 1)\n    const a = chroma * Math.cos(hue)\n    const b = chroma * Math.sin(hue)\n\n    const l = Math.pow(lightness + 0.3963377774 * a + 0.2158037573 * b, 3)\n    const m = Math.pow(lightness - 0.1055613458 * a - 0.0638541728 * b, 3)\n    const s = Math.pow(lightness - 0.0894841775 * a - 1.291485548 * b, 3)\n    const linear = [\n      4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,\n      -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,\n      -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,\n    ]\n    const rgb = linear.map((channel) => {\n      const encoded = channel <= 0.0031308 ? 12.92 * channel : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055\n      return Math.round(Math.min(1, Math.max(0, encoded)) * 255)\n    })\n\n    return alpha < 1 ? `rgba(${rgb.join(', ')}, ${alpha})` : `rgb(${rgb.join(', ')})`\n  }\n\n  if (typeof document === 'undefined') return cssColor\n  if (!_hexCanvas) {\n    _hexCanvas = document.createElement('canvas').getContext('2d')\n  }\n  if (!_hexCanvas) return cssColor\n  _hexCanvas.fillStyle = '#010203'\n  _hexCanvas.fillStyle = value\n  const normalized = _hexCanvas.fillStyle as string\n  return normalized === '#010203' && value.toLowerCase() !== '#010203' ? value : normalized\n}\n\n// Convert any CSS color (hex, rgb, oklch, color()) + alpha 0..1 to a\n// canvas-safe rgba(r,g,b,a). `colorString + '40'` (8-digit hex alpha)\n// only works when `colorString` is `#rrggbb`; once tokens resolve to\n// oklch() post-hydration the gradient stops break and the canvas paint\n// throws every frame. Stay defensive and always return rgba.\nexport function toRgba(cssColor: string, alpha: number): string {\n  const normalized = toCanvasColor(cssColor)\n  if (normalized.startsWith('#') && normalized.length === 7) {\n    const r = parseInt(normalized.slice(1, 3), 16)\n    const g = parseInt(normalized.slice(3, 5), 16)\n    const b = parseInt(normalized.slice(5, 7), 16)\n    return `rgba(${r},${g},${b},${alpha})`\n  }\n  if (normalized.startsWith('rgba(')) {\n    return normalized.replace(/,\\s*[\\d.]+\\s*\\)$/, `,${alpha})`)\n  }\n  if (normalized.startsWith('rgb(')) {\n    return normalized.replace(/^rgb\\(/, 'rgba(').replace(/\\)$/, `,${alpha})`)\n  }\n  // Canvas refused to parse this color -- ship the original string and\n  // let ECharts complain (better than crashing the paint loop).\n  return cssColor\n}\n\nexport function resolveCssVar(name: string, fallback: string): string {\n  if (typeof window === 'undefined') return fallback\n  const v = getComputedStyle(document.documentElement).getPropertyValue(name).trim()\n  if (!v) return fallback\n  return toCanvasColor(v)\n}\n\nexport function getChartColors(): string[] {\n  return Array.from({ length: 5 }, (_, i) => resolveCssVar(`--chart-${i + 1}`, CHART_FALLBACK[i]!))\n}\n\nexport function getChartTextColor(): string {\n  return resolveCssVar('--muted-foreground', '#888888')\n}\n\nexport function getChartAxisColor(): string {\n  return resolveCssVar('--border', '#e5e5e5')\n}\n\nexport function getChartSplitLineColor(): string {\n  return resolveCssVar('--border', '#f0f0f0')\n}\n\nexport function getChartTooltipBg(): string {\n  return resolveCssVar('--popover', 'rgba(255,255,255,0.96)')\n}\n\nexport function getChartTooltipBorder(): string {\n  return resolveCssVar('--border', '#e5e5e5')\n}\n\nexport function getChartTooltipText(): string {\n  return resolveCssVar('--popover-foreground', '#333333')\n}\n\nexport function getChartBgColor(): string {\n  return resolveCssVar('--card', resolveCssVar('--background', '#ffffff'))\n}\n\n// The app's accent, for the one highlighted element on a chart or map — a\n// selected route, a focused bar. Category series keep using getChartColors().\nexport function getChartAccentColor(): string {\n  return resolveCssVar('--primary', '#38bdf8')\n}\n\n// Out-of-bounds / failure colour for charts that encode good vs bad rather\n// than a category — control limits, error series.\nexport function getChartDangerColor(): string {\n  return resolveCssVar('--destructive', '#dc2626')\n}\n\n// Two-level deep merge for ECharts option blocks (xAxis, yAxis, grid,\n// tooltip, legend, singleAxis, parallel, etc.). The top-level keys merge\n// shallowly, but one nested level (axisLabel, axisLine, splitLine, etc.)\n// merges shallowly too so a consumer passing `xAxis: { axisLabel: { fontSize: 9 } }`\n// doesn't blow away the wrapper's `color` + base font defaults on the same\n// axisLabel block. Arrays + primitives replace outright.\nexport function mergeOptionBlock<T extends Record<string, any>>(base: T, user: Partial<T> | undefined): T {\n  if (!user) return base\n  const out: any = { ...base }\n  for (const k of Object.keys(user)) {\n    const bv = (base as any)[k]\n    const uv = (user as any)[k]\n    if (\n      bv != null &&\n      uv != null &&\n      typeof bv === 'object' &&\n      typeof uv === 'object' &&\n      !Array.isArray(bv) &&\n      !Array.isArray(uv)\n    ) {\n      out[k] = { ...bv, ...uv }\n    } else {\n      out[k] = uv\n    }\n  }\n  return out\n}\n\n// Default gauge stoplight: teal (safe) -> amber (warning) -> red (danger).\n// Static because gauges have semantic meaning (green safe / red danger) that\n// we deliberately don't theme-flip.\nexport const gaugeThresholds: [number, string][] = [\n  [0.6, '#14b8a6'],\n  [0.85, '#f59e0b'],\n  [1, '#dc2626'],\n]\n\n/**\n * Re-render callback subscription for theme flips: bumps every listener\n * whenever `<html>` class/style changes (the typical shadcn dark-mode pivot)\n * so chart components can rebuild their options and re-paint. Returns an\n * unsubscribe function. No-op (never fires) outside the DOM.\n */\nexport function onChartThemeChange(cb: () => void): () => void {\n  if (typeof window === 'undefined' || typeof MutationObserver === 'undefined') return () => {}\n  const observer = new MutationObserver(() => cb())\n  observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'style', 'data-theme'] })\n  return () => observer.disconnect()\n}\n",
      "type": "registry:ui",
      "target": "~/src/app/components/ui/charts/use-chart-theme.ts"
    }
  ],
  "dependencies": [
    "echarts"
  ],
  "devDependencies": [],
  "registryDependencies": [],
  "description": "Heatmap wrapper around Apache ECharts. Category/category intensity grid with a continuous visual map. Theme-aware via registry tokens.",
  "categories": [
    "chart"
  ]
}