{
  "$schema": "https://uipkge.dev/schema/registry-item.json",
  "name": "theme-river",
  "title": "Theme River",
  "type": "registry:ui",
  "description": "React mirror of @uipkge/theme-river — see the Vue registry item for the canonical description.",
  "categories": [
    "chart"
  ],
  "files": [
    {
      "path": "packages/elements-lit/src/components/charts/theme-river.ts",
      "content": "import { ChartElement } from './lib/chart-element'\nimport { mergeOptionBlock } from './lib/chart-theme'\n\n/**\n * <uip-theme-river> — the registry ThemeRiver (React `ThemeRiver`) as a web\n * component. Builds the same ECharts option as React for the same props.\n *\n * Properties (React props): `data` ([time, value, series][]; property or JSON\n * attribute), `height` (default 320), `option` (ECharts escape hatch, merged\n * like React), `aria-label` (React `ariaLabel`). React's `className` → host\n * classes.\n */\nexport class UipThemeRiver extends ChartElement {\n  static properties = {\n    data: { type: Array },\n    option: { type: Object },\n  }\n\n  data: [string | number, number, string][] = []\n  option?: any\n  height: number | string = 320\n  protected readonly chartSlot = 'theme-river'\n\n  protected buildOption() {\n    const theme = this.chartTheme\n    const { data, option } = this\n    const series = [\n      {\n        type: 'themeRiver',\n        data,\n        label: { show: false },\n        emphasis: { itemStyle: { shadowBlur: 12, shadowColor: 'rgba(0,0,0,0.2)' } },\n      },\n    ]\n\n    const userOption: any = option ?? {}\n    const {\n      series: userSeries,\n      singleAxis: userSingleAxis,\n      tooltip: userTooltip,\n      legend: userLegend,\n      ...userRest\n    } = userOption\n    const mergedSeries = Array.isArray(userSeries) ? series.map((s, i) => ({ ...s, ...(userSeries[i] ?? {}) })) : series\n\n    return {\n      color: theme.colors,\n      tooltip: mergeOptionBlock(\n        {\n          trigger: 'axis',\n          axisPointer: { type: 'line', lineStyle: { color: theme.axisColor, opacity: 0.8 } },\n          backgroundColor: theme.tooltipBg,\n          borderColor: theme.tooltipBorder,\n          textStyle: { color: theme.tooltipText, fontSize: 12 },\n        },\n        userTooltip,\n      ),\n      legend:\n        userLegend?.show === false\n          ? undefined\n          : mergeOptionBlock(\n              {\n                bottom: 0,\n                icon: 'circle',\n                itemWidth: 8,\n                itemHeight: 8,\n                textStyle: { fontSize: 11, color: theme.textColor },\n              },\n              userLegend,\n            ),\n      singleAxis: mergeOptionBlock(\n        {\n          top: 12,\n          bottom: 40,\n          type: 'time',\n          axisTick: { show: false },\n          axisLabel: { color: theme.textColor, fontSize: 11 },\n          axisLine: { lineStyle: { color: theme.axisColor } },\n        },\n        userSingleAxis,\n      ),\n      series: mergedSeries,\n      ...userRest,\n    }\n  }\n}\n\ncustomElements.get('uip-theme-river') || customElements.define('uip-theme-river', UipThemeRiver)\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'uip-theme-river': UipThemeRiver\n  }\n}\n",
      "type": "registry:file",
      "target": "src/uip/components/charts/theme-river.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"
  ]
}