{ "$schema": "https://uipkge.dev/schema/registry-item.json", "name": "waffle-chart", "title": "Waffle Chart", "type": "registry:ui", "files": [ { "path": "packages/registry-angular/components/charts/waffle-chart/waffle-chart.component.ts", "content": "import {\n AfterViewInit,\n Component,\n ElementRef,\n Input,\n OnChanges,\n OnDestroy,\n SimpleChanges,\n ViewChild,\n booleanAttribute,\n ChangeDetectionStrategy,\n} from '@angular/core'\nimport type * as echarts from 'echarts/core'\nimport { cn } from '@/lib/utils'\nimport {\n getChartColors,\n getChartTextColor,\n getChartTooltipBg,\n getChartTooltipBorder,\n getChartTooltipText,\n} from '../use-chart-theme'\n\n/**\n * Angular port of the UIPKGE WaffleChart. The React/Vue source renders a dependency-free\n * SVG grid; this standalone port renders the same largest-remainder cell allocation as an\n * ECharts heatmap plus the same HTML legend. Inputs mirror React/Vue (`data`, `height`,\n * `size`, `radius`, `showLegend`, `colors`); `option` is the Angular ECharts escape hatch.\n */\n@Component({\n changeDetection: ChangeDetectionStrategy.Eager,\n selector: 'ui-waffle-chart, [ui-waffle-chart]',\n standalone: true,\n host: {\n '[attr.data-slot]': '\"waffle-chart\"',\n '[attr.data-uipkge]': '\"\"',\n '[class]': 'hostClass',\n '[attr.role]': '\"img\"',\n '[attr.aria-label]': 'effectiveAriaLabel',\n '[attr.tabindex]': '0',\n '[style.height]': 'heightStyle',\n },\n template: `\n
\n @if (showLegend) {\n \n }\n `,\n})\nexport class UiWaffleChartComponent implements AfterViewInit, OnChanges, OnDestroy {\n /** `{ name, value, color? }` per slice. Cells allocate by largest remainder. */\n @Input() data: { name: string; value: number; color?: string }[] = []\n @Input() height: number | string = 260\n /** Cells per side (total = size²). Default 10. */\n @Input() size = 10\n /** Cell corner radius. Default 2. */\n @Input() radius = 2\n @Input({ transform: booleanAttribute }) showLegend = true\n /** Palette override. Defaults to chart-1..5 tokens. */\n @Input() colors?: string[]\n @Input() option?: Record\n /** Accessible name announced for the chart image. Defaults to a generated \"Waffle chart: …\" summary. */\n @Input() ariaLabel?: string\n @Input('class') className?: string\n\n @ViewChild('chartEl', { static: false }) chartEl?: ElementRef\n\n private chart: echarts.ECharts | null = null\n private unsubscribeTheme: (() => void) | null = null\n\n get hostClass(): string {\n return cn(\n 'block focus-visible:ring-ring w-full focus-visible:ring-2 focus-visible:outline-none',\n this.showLegend && 'flex items-center justify-center gap-5',\n this.className,\n )\n }\n\n get heightStyle(): string {\n return /^\\d+$/.test(String(this.height)) ? `${this.height}px` : String(this.height)\n }\n\n /** Active palette: `colors` override wins, else the chart theme tokens. */\n get palette(): string[] {\n return this.colors ?? getChartColors()\n }\n\n total(): number {\n return this.data.reduce((s, d) => s + d.value, 0) || 1\n }\n\n pct(value: number): number {\n return Math.round((value / this.total()) * 100)\n }\n\n get effectiveAriaLabel(): string {\n if (this.ariaLabel) return this.ariaLabel\n const total = this.total()\n return `Waffle chart: ${this.data.map((d) => `${d.name} ${Math.round((d.value / total) * 100)}%`).join(', ')}`\n }\n\n /** size² cells `[col, row, itemIndex]`, row-major with the first slice at the bottom (mirrors React). Pure — unit-tested. */\n cells(): [number, number, number][] {\n const n = this.size * this.size\n const total = this.total()\n const quotas = this.data.map((d) => (d.value / total) * n)\n const base = quotas.map((q) => Math.floor(q))\n let rest = n - base.reduce((s, b) => s + b, 0)\n const order = quotas.map((q, i) => [q - base[i]!, i] as [number, number]).sort((a, b) => b[0] - a[0])\n for (const [, i] of order) {\n if (rest <= 0) break\n base[i]!++\n rest--\n }\n const cells: [number, number, number][] = []\n let k = 0\n base.forEach((count, item) => {\n for (let j = 0; j < count; j++) {\n cells.push([k % this.size, this.size - 1 - Math.floor(k / this.size), item])\n k++\n }\n })\n return cells\n }\n\n /** Build the merged ECharts option (pure — no DOM needed, unit-testable). */\n getOption(): Record {\n const colors = this.palette\n const cells = this.cells()\n const series = [\n {\n type: 'heatmap',\n data: cells,\n itemStyle: {\n borderWidth: 2,\n borderRadius: this.radius,\n color: (p: { data: [number, number, number] }) => {\n const item = this.data[p.data[2]]\n return item?.color ?? colors[p.data[2] % colors.length]\n },\n },\n label: { show: false },\n },\n ]\n const userOption: Record = this.option ?? {}\n const { series: userSeries, tooltip: userTooltip, ...userRest } = userOption\n const mergedSeries = Array.isArray(userSeries) ? series.map((s, i) => ({ ...s, ...(userSeries[i] ?? {}) })) : series\n return {\n color: colors,\n tooltip: {\n trigger: 'item',\n formatter: (p: { data: [number, number, number] }) => this.data[p.data[2]]?.name ?? '',\n backgroundColor: getChartTooltipBg(),\n borderColor: getChartTooltipBorder(),\n textStyle: { color: getChartTextColor(), fontSize: 12 },\n ...(typeof userTooltip === 'object' && userTooltip !== null ? userTooltip : {}),\n },\n xAxis: { type: 'category', show: false },\n yAxis: { type: 'category', show: false, inverse: true },\n // ECharts throws \"Heatmap must use with visualMap\" outside production builds, so every\n // `ng serve` failed. This one is hidden and only sets opacity: cells keep their own colours.\n visualMap: {\n show: false,\n type: 'piecewise',\n seriesIndex: 0,\n dimension: 2,\n pieces: [{ min: -Infinity }],\n inRange: { opacity: 1 },\n },\n series: mergedSeries,\n ...userRest,\n }\n }\n\n async ngAfterViewInit(): Promise {\n if (typeof window === 'undefined' || !this.chartEl?.nativeElement) return\n const [{ use }, { CanvasRenderer }, { HeatmapChart: EChartsHeatmapChart }, comps] = await Promise.all([\n import('echarts/core'),\n import('echarts/renderers'),\n import('echarts/charts'),\n import('echarts/components'),\n ])\n use([CanvasRenderer, EChartsHeatmapChart, comps.TooltipComponent, comps.VisualMapComponent])\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 (\n this.chart &&\n (changes['data'] ||\n changes['option'] ||\n changes['size'] ||\n changes['radius'] ||\n changes['colors'] ||\n changes['showLegend'])\n ) {\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/waffle-chart/waffle-chart.component.ts" }, { "path": "packages/registry-angular/components/charts/waffle-chart/index.ts", "content": "export { UiWaffleChartComponent } from './waffle-chart.component'\n", "type": "registry:ui", "target": "~/src/app/components/ui/charts/waffle-chart/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>(base: T, user: Partial | 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 `` 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": "Waffle chart as dependency-free SVG. 10×10 part-to-whole grid with legend. No extra npm packages.", "categories": [ "chart" ] }