{ "$schema": "https://uipkge.dev/schema/registry-item.json", "name": "category-distribution-chart", "title": "Category Distribution Chart", "type": "registry:ui", "description": "React mirror of @uipkge/category-distribution-chart — see the Vue registry item for the canonical description.", "categories": [ "chart" ], "files": [ { "path": "packages/elements-lit/src/components/charts/category-distribution-chart.ts", "content": "import { LitElement, css, html } 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 DistributionSlice {\n label: string\n /** Share of the whole; auto-normalised when the sum is not 100. */\n percentage: number\n value?: string | number\n color?: string\n}\n\nexport interface DistributionTrend {\n value: string\n direction: 'up' | 'down'\n}\n\nconst DEFAULT_COLORS = ['var(--chart-1)', 'var(--chart-2)', 'var(--chart-3)', 'var(--chart-4)', 'var(--chart-5)']\n\n/**\n * — the registry CategoryDistributionChart\n * (React `CategoryDistributionChart`): dependency-free KPI + share bar, no\n * ECharts. Same KPI row, share bar, legend, classes and titles as React.\n *\n * Like (the other non-ECharts chart) this is a\n * standalone element, not a `ChartElement`: that base lazily imports the\n * whole ECharts bundle and manages an instance, which a DOM chart would pay\n * for and never use. The shared API (`height`, `aria-label`) and helpers\n * (`heightToStyle`, `defaultTrue`) still come from the chart-element lib.\n *\n * Properties (React props): `primary-value`, `primary-label`, `trend`\n * ({ value, direction } via property), `categories` ({ label, percentage,\n * value?, color? }[]; property or JSON attribute), `show-legend` (default\n * true; `show-legend=\"false\"` hides it), `colors` (default chart-1..5 tokens),\n * `height` (default 220), `aria-label` (React `ariaLabel`). React's\n * `className` → host classes.\n */\nexport class UipCategoryDistributionChart extends LitElement {\n // :host display can't be a utility class (the host has no template of its own).\n static styles = [\n tailwind,\n css`\n :host {\n display: block;\n }\n `,\n ]\n\n static properties = {\n primaryValue: { attribute: 'primary-value' },\n primaryLabel: { attribute: 'primary-label' },\n trend: { type: Object },\n categories: { type: Array },\n showLegend: { attribute: 'show-legend', converter: defaultTrue },\n colors: { type: Array },\n height: {},\n accessibleLabel: { attribute: 'aria-label' },\n }\n\n primaryValue: string | number = ''\n primaryLabel?: string\n trend?: DistributionTrend\n categories: DistributionSlice[] = []\n showLegend = true\n colors: string[] = DEFAULT_COLORS\n height: number | string = 220\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', 'category-distribution-chart')\n }\n\n render() {\n const categories = this.categories ?? []\n const colors = this.colors ?? DEFAULT_COLORS\n const total = categories.reduce((s, c) => s + c.percentage, 0) || 1\n const slices = categories.map((c, i) => ({\n ...c,\n share: (c.percentage / total) * 100,\n color: c.color ?? colors[i % colors.length],\n }))\n // React passes focusable={false}: w-full frame, no tabindex / focus ring.\n return html`\n
\n ${this.primaryValue}\n ${\n this.trend\n ? html`${this.trend.direction === 'up' ? '+' : '−'}${this.trend.value}`\n : null\n }\n ${this.primaryLabel ? html`${this.primaryLabel}` : null}\n
\n
\n ${slices.map(\n (s) =>\n html`
`,\n )}\n \n ${\n this.showLegend\n ? html`
    \n ${slices.map(\n (s) =>\n html`
  • \n \n ${s.label}\n ${s.value ?? `${Math.round(s.share)}%`}\n
    • `,\n )}\n
`\n : null\n }\n `\n }\n}\n\ncustomElements.get('uip-category-distribution-chart') ||\n customElements.define('uip-category-distribution-chart', UipCategoryDistributionChart)\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'uip-category-distribution-chart': UipCategoryDistributionChart\n }\n}\n", "type": "registry:file", "target": "src/uip/components/charts/category-distribution-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 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('[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`\n
\n `\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 and re-resolved whenever 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 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 :\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>(base: T, user: Partial | 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// 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" ] }