{
  "$schema": "https://uipkge.dev/schema/registry-item.json",
  "name": "waffle-chart",
  "title": "Waffle Chart",
  "type": "registry:ui",
  "description": "React mirror of @uipkge/waffle-chart — see the Vue registry item for the canonical description.",
  "categories": [
    "chart"
  ],
  "files": [
    {
      "path": "packages/elements-lit/src/components/charts/waffle-chart.ts",
      "content": "import { LitElement, css, html, svg } from 'lit'\nimport { styleMap } from 'lit/directives/style-map.js'\nimport { tailwind } from '../../lib/styles'\nimport { ThemeController } from '../../lib/theme'\nimport { defaultTrue } from './lib/chart-element'\nimport { heightToStyle } from './lib/chart-theme'\n\nexport interface WaffleSlice {\n  name: string\n  value: number\n  color?: string\n}\n\nconst DEFAULT_COLORS = ['var(--chart-1)', 'var(--chart-2)', 'var(--chart-3)', 'var(--chart-4)', 'var(--chart-5)']\n\n/**\n * <uip-waffle-chart> — the registry WaffleChart (React `WaffleChart`): pure\n * SVG, no ECharts. Same cells, legend and classes as React.\n *\n * Like <uip-smooth-funnel> (the other pure-SVG chart) this is a standalone\n * element, not a `ChartElement`: that base lazily imports the whole ECharts\n * bundle and manages an instance, which an SVG chart would pay for and never\n * use. The shared API (`height`, `aria-label`) and helpers (`heightToStyle`,\n * `defaultTrue`) still come from the chart-element lib.\n *\n * Properties (React props): `data` ({ name, value, color? }[]; JSON\n * attribute or property), `height` (default 260), `size` (cells per side;\n * default 10), `radius` (cell corner radius; default 2), `show-legend`\n * (default true; `show-legend=\"false\"` hides it), `colors` (default\n * var(--chart-1..5)), `aria-label` (React `ariaLabel`; default describes the\n * shares like React). React's `className` → host classes.\n */\nexport class UipWaffleChart extends LitElement {\n  // :host display can't be a utility class (the host has no template of its own).\n  static styles = [tailwind, css`:host { display: block; }`]\n\n  static properties = {\n    data: { type: Array },\n    height: {},\n    size: { type: Number },\n    radius: { type: Number },\n    showLegend: { attribute: 'show-legend', converter: defaultTrue },\n    colors: { type: Array },\n    accessibleLabel: { attribute: 'aria-label' },\n  }\n\n  data: WaffleSlice[] = []\n  height: number | string = 260\n  size = 10\n  radius = 2\n  showLegend = true\n  colors: string[] = DEFAULT_COLORS\n  accessibleLabel?: string\n\n  constructor() {\n    super()\n    new ThemeController(this)\n  }\n\n  connectedCallback() {\n    super.connectedCallback()\n    this.setAttribute('data-uipkge', '')\n    this.setAttribute('data-slot', 'waffle-chart')\n  }\n\n  private get total() {\n    return (this.data ?? []).reduce((s, d) => s + d.value, 0) || 1\n  }\n\n  private cells() {\n    const data = this.data ?? []\n    const total = this.total\n    const n = this.size * this.size\n    const counts = data.map((d) => Math.floor((d.value / total) * n))\n    let rest = n - counts.reduce((s, c) => s + c, 0)\n    const remainders = data.map((d, i) => ({ i, r: (d.value / total) * n - counts[i]! })).sort((a, b) => b.r - a.r)\n    for (const { i } of remainders) {\n      if (rest <= 0) break\n      counts[i]!++\n      rest--\n    }\n    const out: { color: string; name: string }[] = []\n    data.forEach((d, i) => {\n      for (let k = 0; k < counts[i]!; k++) out.push({ color: d.color ?? this.colors[i % this.colors.length]!, name: d.name })\n    })\n    return out.reverse()\n  }\n\n  private defaultLabel() {\n    const data = this.data ?? []\n    const total = this.total\n    return `Waffle chart: ${data.map((d) => `${d.name} ${Math.round((d.value / total) * 100)}%`).join(', ')}`\n  }\n\n  render() {\n    const data = this.data ?? []\n    const total = this.total\n    return html`<div\n      part=\"base\"\n      role=\"img\"\n      aria-label=${this.accessibleLabel || this.defaultLabel()}\n      tabindex=\"0\"\n      style=${styleMap({ height: heightToStyle(this.height) })}\n      class=\"focus-visible:ring-ring flex w-full items-center justify-center gap-5 focus-visible:ring-2 focus-visible:outline-none\"\n    >\n      <svg\n        viewBox=${`0 0 ${this.size * 12} ${this.size * 12}`}\n        class=\"aspect-square h-full max-h-full\"\n        role=\"presentation\"\n      >\n        ${this.cells().map(\n          (c, i) =>\n            svg`<rect\n              x=${(i % this.size) * 12 + 1}\n              y=${Math.floor(i / this.size) * 12 + 1}\n              width=\"10\"\n              height=\"10\"\n              rx=${this.radius}\n              fill=${c.color}\n            ><title>${c.name}</title></rect>`,\n        )}\n      </svg>\n      ${this.showLegend\n        ? html`<ul class=\"space-y-1.5 text-xs\">\n            ${data.map(\n              (d, i) => html`<li class=\"flex items-center gap-2\">\n                <span\n                  class=\"size-2.5 rounded-[3px]\"\n                  style=${styleMap({ background: d.color ?? this.colors[i % this.colors.length]! })}\n                ></span>\n                <span class=\"text-foreground font-medium\">${d.name}</span>\n                <span class=\"text-muted-foreground tabular-nums\">${Math.round((d.value / total) * 100)}%</span>\n              </li>`,\n            )}\n          </ul>`\n        : null}\n    </div>`\n  }\n}\n\ncustomElements.get('uip-waffle-chart') || customElements.define('uip-waffle-chart', UipWaffleChart)\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'uip-waffle-chart': UipWaffleChart\n  }\n}\n",
      "type": "registry:file",
      "target": "src/uip/components/charts/waffle-chart.ts"
    },
    {
      "path": "packages/elements-lit/src/components/charts/lib/chart-element.ts",
      "content": "import { LitElement, css, html, type PropertyDeclarations, type PropertyValues } from 'lit'\nimport { styleMap } from 'lit/directives/style-map.js'\nimport type { ECharts } from 'echarts/core'\nimport { tailwind } from '../../../lib/styles'\nimport { ThemeController } from '../../../lib/theme'\nimport { heightToStyle, resolveChartTheme, subscribeChartTheme, type ChartTheme } from './chart-theme'\n\n/**\n * Attribute converter for booleans whose React default is `true`\n * (`showLabels`, `autoresize`): Lit's `type: Boolean` can't be switched off\n * from markup, so `show-labels=\"false\"` turns it off and anything else\n * (including removing the attribute) means true.\n */\nexport const defaultTrue = {\n  fromAttribute: (v: string | null) => v !== 'false',\n  toAttribute: (v: boolean) => (v ? '' : 'false'),\n}\n\n/**\n * `yField=\"value\"` from markup, `yField=['north', 'south']` from markup as a\n * JSON array or from JS as a property.\n */\nexport const stringOrArray = {\n  fromAttribute: (v: string | null) => (v?.trim().startsWith('[') ? (JSON.parse(v) as string[]) : v),\n}\n\n/**\n * Shared base for every ECharts-backed element — the Lit stand-in for React's\n * `ChartFrame` + `EChart` + `useChartTheme()`:\n *\n *  - renders React's ChartFrame chrome (role=\"img\", tabindex, focus ring,\n *    `height`) with a full-size inner container for the canvas;\n *  - resolves the chart theme from the CSS tokens and re-resolves it (and\n *    re-sets the option) whenever <html> class/style/data-theme changes;\n *  - lazily `import()`s echarts in firstUpdated (SSR-safe: nothing runs on the\n *    server), resizes with a ResizeObserver and disposes on disconnect;\n *  - applies `buildOption()` with `{ notMerge: true, lazyUpdate: true }`,\n *    exactly like React's EChart.\n *\n * Subclasses implement `buildOption()` (React's `mergedOption` useMemo) and\n * set `chartSlot` (the host's data-slot). `instance` exposes the ECharts\n * instance (undefined until initialised) for getOption()/dispatchAction().\n */\nexport abstract class ChartElement extends LitElement {\n  // :host display can't be a utility class (the host has no template of its own).\n  static styles = [tailwind, css`:host { display: block; }`]\n\n  static properties: PropertyDeclarations = {\n    height: {},\n    // role=\"img\" lives on the inner frame, so the host's aria-label is forwarded.\n    accessibleLabel: { attribute: 'aria-label' },\n    chartTheme: { state: true },\n  }\n\n  height: number | string = 300\n  accessibleLabel?: string\n  protected chartTheme: ChartTheme = resolveChartTheme()\n  /** Resize with the container. Only RawChart exposes it as a property. */\n  protected autoresize = true\n\n  protected abstract readonly chartSlot: string\n  protected abstract buildOption(): any\n\n  private chart?: ECharts\n  private resizeObserver?: ResizeObserver\n  private unsubscribeTheme?: () => void\n\n  constructor() {\n    super()\n    new ThemeController(this)\n  }\n\n  /** The ECharts instance, once initialised in the browser. */\n  get instance(): ECharts | undefined {\n    return this.chart\n  }\n\n  connectedCallback() {\n    super.connectedCallback()\n    this.setAttribute('data-uipkge', '')\n    this.setAttribute('data-slot', this.chartSlot)\n    this.chartTheme = resolveChartTheme()\n    this.unsubscribeTheme = subscribeChartTheme(() => {\n      this.chartTheme = resolveChartTheme()\n    })\n    // Re-attached after a move: firstUpdated won't run again.\n    if (this.hasUpdated) void this.initChart()\n  }\n\n  disconnectedCallback() {\n    super.disconnectedCallback()\n    this.unsubscribeTheme?.()\n    this.resizeObserver?.disconnect()\n    this.resizeObserver = undefined\n    this.chart?.dispose()\n    this.chart = undefined\n  }\n\n  protected firstUpdated() {\n    void this.initChart()\n  }\n\n  protected updated(changed: PropertyValues) {\n    if (!this.chart) return\n    if (changed.has('autoresize')) this.observeResize()\n    this.chart.setOption(this.buildOption(), { notMerge: true, lazyUpdate: true })\n  }\n\n  private get container() {\n    return this.renderRoot.querySelector<HTMLDivElement>('[data-chart]')\n  }\n\n  private async initChart() {\n    const { echarts } = await import('./echarts')\n    const el = this.container\n    if (!this.isConnected || this.chart || !el) return\n    this.chart = echarts.init(el)\n    this.chart.setOption(this.buildOption(), { notMerge: true, lazyUpdate: true })\n    this.observeResize()\n  }\n\n  private observeResize() {\n    this.resizeObserver?.disconnect()\n    this.resizeObserver = undefined\n    const el = this.container\n    if (!this.autoresize || !el) return\n    this.resizeObserver = new ResizeObserver(() => this.chart?.resize())\n    this.resizeObserver.observe(el)\n  }\n\n  render() {\n    return html`<div\n      part=\"base\"\n      role=\"img\"\n      aria-label=${this.accessibleLabel || 'Chart'}\n      tabindex=\"0\"\n      style=${styleMap({ height: heightToStyle(this.height) })}\n      class=\"focus-visible:ring-ring w-full focus-visible:ring-2 focus-visible:outline-none\"\n    >\n      <div data-chart class=\"h-full w-full\"></div>\n    </div>`\n  }\n}\n",
      "type": "registry:file",
      "target": "src/uip/components/charts/lib/chart-element.ts"
    },
    {
      "path": "packages/elements-lit/src/components/charts/lib/chart-theme.ts",
      "content": "import { isServer } from 'lit'\n\n// Port of packages/registry-react/components/charts/useChartTheme.ts.\n//\n// The chart palette is driven by the design tokens (`--chart-1`..`--chart-5`,\n// `--muted-foreground`, `--border`, `--popover`, …). They are resolved with\n// getComputedStyle on <html> and re-resolved whenever <html> class / style /\n// data-theme changes, so a light/dark flip re-colours every chart. Instead of\n// React's useChartTheme() hook, elements call subscribeChartTheme().\n\nconst listeners = new Set<() => void>()\nlet observing = false\n\nfunction bump() {\n  listeners.forEach((l) => l())\n}\n\n/** Call `cb` whenever the page theme changes. Returns the unsubscribe fn. */\nexport function subscribeChartTheme(cb: () => void): () => void {\n  listeners.add(cb)\n  if (!observing && !isServer) {\n    observing = true\n    // Same as React: one bump on the first frame (tokens resolved after the\n    // stylesheet applies), then on every <html> class/style/data-theme change.\n    requestAnimationFrame(bump)\n    new MutationObserver(bump).observe(document.documentElement, {\n      attributes: true,\n      attributeFilter: ['class', 'style', 'data-theme'],\n    })\n  }\n  return () => listeners.delete(cb)\n}\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 (isServer) 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).\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  return cssColor\n}\n\nexport function resolveVar(name: string, fallback: string): string {\n  if (isServer) return fallback\n  const v = getComputedStyle(document.documentElement).getPropertyValue(name).trim()\n  if (!v) return fallback\n  return toCanvasColor(v)\n}\n\n// SSR / pre-hydration fallback palette (same values as React).\nconst CHART_FALLBACK = ['#f59e0b', '#14b8a6', '#3b82f6', '#f97316', '#eab308']\n\n/** The resolved chart theme tokens. All values are canvas-safe hex/rgba. */\nexport interface ChartTheme {\n  colors: string[]\n  textColor: string\n  axisColor: string\n  splitLineColor: string\n  tooltipBg: string\n  tooltipBorder: string\n  tooltipText: string\n  bgColor: string\n  accentColor: string\n  dangerColor: string\n  /** `--card`: cell borders and inside-label text, so they read as gaps /\n   *  contrast on light and dark surfaces (never '#fff'). */\n  surfaceColor: string\n  /** `--foreground`: primary numbers drawn on the canvas (gauge value). */\n  foregroundColor: string\n  /** Gauge stoplight from the status tokens, same rule as <uip-usage-bar>:\n   *  < 70% success, 70-89% warning, >= 90% destructive. */\n  semanticGaugeThresholds: [number, string][]\n}\n\nexport function resolveChartTheme(): ChartTheme {\n  return {\n    colors: Array.from({ length: 5 }, (_, i) => resolveVar(`--chart-${i + 1}`, CHART_FALLBACK[i]!)),\n    textColor: resolveVar('--muted-foreground', '#888888'),\n    axisColor: resolveVar('--border', '#e5e5e5'),\n    splitLineColor: resolveVar('--border', '#f0f0f0'),\n    tooltipBg: resolveVar('--popover', 'rgba(255,255,255,0.96)'),\n    tooltipBorder: resolveVar('--border', '#e5e5e5'),\n    tooltipText: resolveVar('--popover-foreground', '#333333'),\n    bgColor: resolveVar('--card', resolveVar('--background', '#ffffff')),\n    accentColor: resolveVar('--primary', '#38bdf8'),\n    dangerColor: resolveVar('--destructive', '#dc2626'),\n    surfaceColor: resolveVar('--card', '#ffffff'),\n    foregroundColor: resolveVar('--foreground', '#171717'),\n    semanticGaugeThresholds: [\n      [0.7, resolveVar('--success', '#14b8a6')],\n      [0.9, resolveVar('--warning', '#f59e0b')],\n      [1, resolveVar('--destructive', '#dc2626')],\n    ],\n  }\n}\n\n// Two-level deep merge for ECharts option blocks (verbatim from React): top-level\n// keys merge shallowly, and one nested level (axisLabel, splitLine, …) merges\n// shallowly too. Arrays + primitives replace outright — including a whole\n// block given as an array (e.g. `xAxis: [a, b]` for two axes).\nexport function mergeOptionBlock<T extends Record<string, any>>(base: T, user: Partial<T> | undefined): T {\n  if (!user) return base\n  if (Array.isArray(user)) return user as unknown as T\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/** `height` prop → CSS: bare digits are px, anything else is raw CSS. */\nexport function heightToStyle(height: number | string): string {\n  return /^\\d+$/.test(String(height)) ? `${height}px` : String(height)\n}\n",
      "type": "registry:file",
      "target": "src/uip/components/charts/lib/chart-theme.ts"
    },
    {
      "path": "packages/elements-lit/src/components/charts/lib/echarts.ts",
      "content": "// ECharts core with every chart type / component the React wrappers register\n// (same list as packages/registry-react/components/charts/shared.tsx), so\n// <uip-raw-chart> can render any of them. Only ever loaded with a dynamic\n// import() from ChartElement.firstUpdated — never at module scope — so the\n// elements stay SSR-safe and echarts stays out of the initial bundle.\n// (Lives in charts/lib/ so src/index.ts's components/*/*.ts glob skips it.)\nimport * as echarts from 'echarts/core'\nimport { CanvasRenderer } from 'echarts/renderers'\nimport {\n  LineChart,\n  BarChart,\n  PieChart,\n  ScatterChart,\n  EffectScatterChart,\n  PictorialBarChart,\n  RadarChart,\n  GaugeChart,\n  HeatmapChart,\n  TreemapChart,\n  FunnelChart,\n  BoxplotChart,\n  CandlestickChart,\n  CustomChart,\n  ChordChart,\n  MapChart,\n  GraphChart,\n  ParallelChart,\n  SankeyChart,\n  SunburstChart,\n  ThemeRiverChart,\n  TreeChart,\n} from 'echarts/charts'\nimport {\n  GridComponent,\n  PolarComponent,\n  TooltipComponent,\n  LegendComponent,\n  MarkLineComponent,\n  MarkAreaComponent,\n  MarkPointComponent,\n  GraphicComponent,\n  RadarComponent,\n  VisualMapComponent,\n  CalendarComponent,\n  DataZoomComponent,\n  ParallelComponent,\n  SingleAxisComponent,\n  TitleComponent,\n} from 'echarts/components'\n\necharts.use([\n  CanvasRenderer,\n  LineChart,\n  BarChart,\n  PieChart,\n  ScatterChart,\n  EffectScatterChart,\n  PictorialBarChart,\n  RadarChart,\n  GaugeChart,\n  HeatmapChart,\n  TreemapChart,\n  FunnelChart,\n  BoxplotChart,\n  CandlestickChart,\n  CustomChart,\n  ChordChart,\n  MapChart,\n  GraphChart,\n  ParallelChart,\n  SankeyChart,\n  SunburstChart,\n  ThemeRiverChart,\n  TreeChart,\n  GridComponent,\n  PolarComponent,\n  TooltipComponent,\n  LegendComponent,\n  MarkLineComponent,\n  MarkAreaComponent,\n  MarkPointComponent,\n  GraphicComponent,\n  RadarComponent,\n  VisualMapComponent,\n  CalendarComponent,\n  DataZoomComponent,\n  ParallelComponent,\n  SingleAxisComponent,\n  TitleComponent,\n])\n\nexport { echarts }\n",
      "type": "registry:file",
      "target": "src/uip/components/charts/lib/echarts.ts"
    }
  ],
  "dependencies": [
    "echarts",
    "lit"
  ],
  "registryDependencies": [
    "https://uipkge.dev/r/lit/lit-core.json"
  ]
}