@carto/ps-react-ui 4.11.1 → 4.11.2

package/src/widgets-v2/histogram/options.ts

@@ -209,7 +209,14 @@ export function createHistogramOptionFactory(
     // pick that up.
     const liveFormatter = ctx?.formatter
 
-    const { niceMinVal, niceMaxVal } = computeHistogramNiceBounds(seriesArr)
+    // Closure shared between the yAxis min/max callbacks and the label
+    // formatter, so only the rounded extents are labelled (matches v1 +
+    // bar). Delegating the extent to ECharts (rather than precomputing
+    // scalars from the raw counts) keeps stacked bins inside the plot:
+    // when StackToggle marks the series, ECharts feeds the *post-stack*
+    // extent to these callbacks, so `niceNum` rounds the stacked total.
+    let niceMin = 0
+    let niceMax = 1
 
     // Zoom slider layout: when ZoomToggle has installed `dataZoom`, push
     // the slider above the legend (if any) and reserve room in the grid.
@@ -270,12 +277,18 @@ export function createHistogramOptionFactory(
       ...(dataZoomLayout ? { dataZoom: dataZoomLayout } : {}),
       yAxis: {
         ...baseYAxis,
-        min: niceMinVal,
-        max: niceMaxVal,
+        min: (extent: { min: number }) => {
+          niceMin = extent.min < 0 ? niceNum(extent.min) : 0
+          return niceMin
+        },
+        max: (extent: { min: number; max: number }) => {
+          niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)
+          return niceMax
+        },
         axisLabel: {
           ...((baseYAxis as { axisLabel?: object }).axisLabel ?? {}),
           formatter: (value: number) => {
-            if (value !== niceMaxVal && value !== niceMinVal) return ''
+            if (value !== niceMax && value !== niceMin) return ''
             if (value === 0) return ''
             return liveFormatter ? liveFormatter(value) : String(value)
           },
@@ -315,23 +328,6 @@ function buildHistogramTooltipFormatter(
   })
 }
 
-function computeHistogramNiceBounds(seriesArr: HistogramWidgetData): {
-  niceMinVal: number
-  niceMaxVal: number
-} {
-  let max = -Infinity
-  for (const counts of seriesArr) {
-    for (const v of counts) {
-      if (typeof v !== 'number' || !Number.isFinite(v)) continue
-      if (v > max) max = v
-    }
-  }
-  return {
-    niceMinVal: 0,
-    niceMaxVal: max <= 0 ? 1 : niceNum(max),
-  }
-}
-
 function formatNumber(n: number): string {
   if (Number.isInteger(n)) return String(n)
   return Number(n.toFixed(2)).toString()

package/src/widgets-v2/timeseries/options.test.ts

@@ -260,13 +260,18 @@ describe('createTimeseriesOptionFactory', () => {
       { formatter: fmt },
     ) as {
       yAxis: {
-        min: number
-        max: number
+        min: (extent: { min: number }) => number
+        max: (extent: { min: number; max: number }) => number
         axisLabel: { formatter: (v: number) => string }
       }
     }
-    expect(out.yAxis.min).toBe(0)
-    expect(out.yAxis.max).toBe(100)
+    // Bounds are callbacks now: ECharts supplies the (post-stack) extent and
+    // we round it with niceNum. Invoke them as ECharts would before reading
+    // the label formatter (which keys off the closure-cached extents).
+    expect(typeof out.yAxis.min).toBe('function')
+    expect(typeof out.yAxis.max).toBe('function')
+    expect(out.yAxis.min({ min: 0 })).toBe(0)
+    expect(out.yAxis.max({ min: 0, max: 100 })).toBe(100)
     expect(out.yAxis.axisLabel.formatter(100)).toBe('100%')
     expect(out.yAxis.axisLabel.formatter(50)).toBe('')
     expect(out.yAxis.axisLabel.formatter(0)).toBe('')

package/src/widgets-v2/timeseries/options.ts

@@ -207,7 +207,14 @@ export function createTimeseriesOptionFactory(
     // not relativizable — so the merge branch reads the closure-time value.
     const liveFormatter = ctx?.formatter
 
-    const { niceMinVal, niceMaxVal } = computeTimeseriesNiceBounds(seriesArr)
+    // Closure shared between the yAxis min/max callbacks and the label
+    // formatter, so only the rounded extents are labelled (matches v1 +
+    // bar). Delegating the extent to ECharts (rather than precomputing
+    // scalars from the raw data) keeps stacked lines inside the plot: when
+    // StackToggle marks the series, ECharts feeds the *post-stack* extent
+    // to these callbacks, so `niceNum` rounds the stacked total.
+    let niceMin = 0
+    let niceMax = 1
 
     // Zoom slider layout: when ZoomToggle has installed `dataZoom`, push the
     // slider above the legend (if any) and reserve room in the grid below.
@@ -278,12 +285,18 @@ export function createTimeseriesOptionFactory(
       ...(dataZoomLayout ? { dataZoom: dataZoomLayout } : {}),
       yAxis: {
         ...baseYAxis,
-        min: niceMinVal,
-        max: niceMaxVal,
+        min: (extent: { min: number }) => {
+          niceMin = extent.min < 0 ? niceNum(extent.min) : 0
+          return niceMin
+        },
+        max: (extent: { min: number; max: number }) => {
+          niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)
+          return niceMax
+        },
         axisLabel: {
           ...((baseYAxis as { axisLabel?: object }).axisLabel ?? {}),
           formatter: (value: number) => {
-            if (value !== niceMaxVal && value !== niceMinVal) return ''
+            if (value !== niceMax && value !== niceMin) return ''
             if (value === 0) return ''
             return liveFormatter ? liveFormatter(value) : String(value)
           },
@@ -328,21 +341,3 @@ function buildTimeseriesTooltipFormatter(
     return { name: String(name), seriesName, marker, value: formattedValue }
   })
 }
-
-function computeTimeseriesNiceBounds(seriesArr: TimeseriesWidgetData): {
-  niceMinVal: number
-  niceMaxVal: number
-} {
-  let min = 0
-  let max = -Infinity
-  for (const series of seriesArr) {
-    for (const d of series) {
-      if (typeof d?.value !== 'number' || !Number.isFinite(d.value)) continue
-      if (d.value < min) min = d.value
-      if (d.value > max) max = d.value
-    }
-  }
-  const niceMinVal = min < 0 ? niceNum(min) : 0
-  const niceMaxVal = max <= 0 ? 1 : niceNum(max)
-  return { niceMinVal, niceMaxVal }
-}

package/dist/echart-CU0KmClP.js

@@ -1,176 +0,0 @@
-import { jsx as j } from "react/jsx-runtime";
-import { c as k } from "react/compiler-runtime";
-import { useRef as M, useEffectEvent as w, useEffect as T } from "react";
-import { u as N, a as D, m as L } from "./widget-store-registry-_W4Z4xp-.js";
-import { u as U } from "./widget-context-DTGO0Yta.js";
-import "zustand";
-import { Box as P } from "@mui/material";
-import * as C from "echarts";
-const z = /* @__PURE__ */ new Map();
-let g = null;
-function K() {
-  return typeof ResizeObserver > "u" ? null : (g ??= new ResizeObserver((r) => {
-    for (const e of r)
-      z.get(e.target)?.();
-  }), g);
-}
-const W = () => {
-};
-function $(r, e) {
-  const t = K();
-  return t ? (z.set(r, e), t.observe(r), () => {
-    z.delete(r), g && (g.unobserve(r), z.size === 0 && (g.disconnect(), g = null));
-  }) : W;
-}
-function se() {
-  g && g.disconnect(), z.clear(), g = null;
-}
-const B = {
-  root: {
-    width: "100%",
-    minHeight: 0
-  }
-}, G = {
-  renderer: "svg",
-  height: 304
-};
-function H(r) {
-  const e = k(21), {
-    option: t,
-    replaceMerge: s,
-    onEvents: c,
-    init: a,
-    onInstance: b,
-    className: x,
-    sx: y
-  } = r, h = M(null), i = M(null), l = M(null), A = M(null);
-  let v;
-  e[0] !== b ? (v = (n) => {
-    b?.(n);
-  }, e[0] = b, e[1] = v) : v = e[1];
-  const f = w(v);
-  let E;
-  e[2] !== a || e[3] !== f ? (E = () => {
-    if (!h.current)
-      return;
-    const n = C.init(h.current, null, {
-      ...G,
-      ...a
-    });
-    return i.current = n, f(n), () => {
-      f(null), n.dispose(), i.current = null;
-    };
-  }, e[2] = a, e[3] = f, e[4] = E) : E = e[4];
-  let u;
-  e[5] !== a ? (u = [a], e[5] = a, e[6] = u) : u = e[6], T(E, u);
-  let F, d;
-  e[7] !== t || e[8] !== s ? (F = () => {
-    const n = J(t), I = q(t), S = new Set(s ?? []);
-    n !== l.current && S.add("series"), I !== A.current && S.add("dataset"), l.current = n, A.current = I, i.current?.setOption(t, {
-      notMerge: !1,
-      lazyUpdate: !0,
-      replaceMerge: S.size > 0 ? Array.from(S) : void 0
-    });
-  }, d = [t, s], e[7] = t, e[8] = s, e[9] = F, e[10] = d) : (F = e[9], d = e[10]), T(F, d);
-  let _, m;
-  e[11] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (_ = () => {
-    const n = h.current;
-    if (n)
-      return $(n, () => {
-        i.current?.resize();
-      });
-  }, m = [], e[11] = _, e[12] = m) : (_ = e[11], m = e[12]), T(_, m);
-  let O, p;
-  e[13] !== c ? (O = () => {
-    const n = i.current;
-    if (!(!n || !c)) {
-      for (const [I, S] of Object.entries(c))
-        n.on(I, S);
-      return () => {
-        for (const [I, S] of Object.entries(c))
-          n.off(I, S);
-      };
-    }
-  }, p = [c], e[13] = c, e[14] = O, e[15] = p) : (O = e[14], p = e[15]), T(O, p);
-  let o;
-  e[16] !== y ? (o = {
-    ...B.root,
-    ...y
-  }, e[16] = y, e[17] = o) : o = e[17];
-  let R;
-  return e[18] !== x || e[19] !== o ? (R = /* @__PURE__ */ j(P, { ref: h, className: x, sx: o }), e[18] = x, e[19] = o, e[20] = R) : R = e[20], R;
-}
-function J(r) {
-  const e = r.series;
-  return Array.isArray(e) ? e.map((t) => {
-    if (t == null || typeof t != "object") return String(t);
-    const s = t;
-    return [
-      s.type,
-      s.datasetIndex,
-      s.name,
-      s.stack,
-      // `encode` is small; stringify is cheap and stable for plain objects.
-      JSON.stringify(s.encode ?? null)
-    ].join("|");
-  }).join("||") : e ? "1" : "";
-}
-function q(r) {
-  const e = r.dataset;
-  return Array.isArray(e) ? String(e.length) : e ? "1" : "";
-}
-const Q = ["toolbox"], V = (r) => ({
-  data: r.data,
-  configTransforms: r.configTransforms,
-  formatter: r.formatter,
-  labelFormatter: r.labelFormatter
-});
-function oe(r) {
-  const e = k(22), {
-    optionFactory: t,
-    onEvents: s,
-    init: c,
-    className: a
-  } = r, b = U(), x = N(b, V);
-  let y;
-  e[0] !== b ? (y = (o) => L(b, o), e[0] = b, e[1] = y) : y = e[1];
-  const h = y, {
-    data: i,
-    configTransforms: l,
-    formatter: A,
-    labelFormatter: v
-  } = x;
-  let f;
-  e[2] !== t ? (f = t(void 0, void 0), e[2] = t, e[3] = f) : f = e[3];
-  const E = f;
-  let u;
-  e[4] !== l || e[5] !== E ? (u = D(E, l), e[4] = l, e[5] = E, e[6] = u) : u = e[6];
-  const F = u;
-  let d;
-  if (e[7] !== l) {
-    const o = new Set(Q);
-    for (const R of l)
-      if (R.enabled && R.replaceMergeKeys?.length)
-        for (const n of R.replaceMergeKeys)
-          o.add(n);
-    d = Array.from(o).sort(), e[7] = l, e[8] = d;
-  } else
-    d = e[8];
-  const _ = d;
-  let m;
-  e[9] !== t || e[10] !== i || e[11] !== A || e[12] !== v || e[13] !== F ? (m = t(F, i, {
-    formatter: A,
-    labelFormatter: v
-  }), e[9] = t, e[10] = i, e[11] = A, e[12] = v, e[13] = F, e[14] = m) : m = e[14];
-  const O = m;
-  let p;
-  return e[15] !== a || e[16] !== c || e[17] !== s || e[18] !== h || e[19] !== O || e[20] !== _ ? (p = /* @__PURE__ */ j(H, { option: O, replaceMerge: _, onEvents: s, init: c, onInstance: h, className: a }), e[15] = a, e[16] = c, e[17] = s, e[18] = h, e[19] = O, e[20] = _, e[21] = p) : p = e[21], p;
-}
-export {
-  G as D,
-  oe as E,
-  se as _,
-  H as a,
-  $ as o
-};
-//# sourceMappingURL=echart-CU0KmClP.js.map

package/dist/echart-CU0KmClP.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"echart-CU0KmClP.js","sources":["../src/widgets-v2/echart/shared-resize-observer.ts","../src/widgets-v2/echart/style.ts","../src/widgets-v2/echart/echart-ui.tsx","../src/widgets-v2/echart/echart.tsx"],"sourcesContent":["type ResizeCallback = () => void\n\nconst callbacks = new Map<Element, ResizeCallback>()\nlet observer: ResizeObserver | null = null\n\n/**\n * Returns the singleton ResizeObserver, lazily constructing it on first use.\n * Returns `null` when `ResizeObserver` is not available in the global scope\n * (SSR, very old browsers, or tests that intentionally remove it).\n */\nfunction getObserver(): ResizeObserver | null {\n  if (typeof ResizeObserver === 'undefined') return null\n  observer ??= new ResizeObserver((entries) => {\n    for (const entry of entries) {\n      const callback = callbacks.get(entry.target)\n      callback?.()\n    }\n  })\n  return observer\n}\n\nconst NOOP_CLEANUP = (): void => undefined\n\nexport function observeResize(\n  element: Element,\n  callback: ResizeCallback,\n): () => void {\n  const ro = getObserver()\n  // Gracefully degrade when no ResizeObserver is available — consumers\n  // still see one initial measure() pass via their own effect; we just\n  // skip the subsequent resize-driven re-measures.\n  if (!ro) return NOOP_CLEANUP\n  callbacks.set(element, callback)\n  ro.observe(element)\n  return () => {\n    callbacks.delete(element)\n    if (observer) {\n      observer.unobserve(element)\n      // Disconnect the singleton once the last subscriber leaves so the\n      // observer doesn't outlive its consumers in SSR teardown / micro-\n      // frontend unmount scenarios. A subsequent observeResize() will\n      // lazily re-create it via getObserver().\n      if (callbacks.size === 0) {\n        observer.disconnect()\n        observer = null\n      }\n    }\n  }\n}\n\n/** @internal — for tests only. */\nexport function __resetSharedResizeObserver(): void {\n  if (observer) observer.disconnect()\n  callbacks.clear()\n  observer = null\n}\n","import type { SxProps, Theme } from '@mui/material'\n\nexport const styles = {\n  root: {\n    width: '100%',\n    minHeight: 0,\n  },\n} satisfies Record<string, SxProps<Theme>>\n","import { useEffect, useEffectEvent, useRef } from 'react'\nimport { Box, type SxProps, type Theme } from '@mui/material'\nimport * as echarts from 'echarts'\nimport { observeResize } from './shared-resize-observer'\nimport { styles } from './style'\n\nexport const DEFAULT_INIT_OPTS = {\n  renderer: 'svg',\n  height: 304,\n} satisfies echarts.EChartsInitOpts\n\nexport type EchartsEventHandler = (event: unknown) => void\n\nexport interface EchartUIProps {\n  option: echarts.EChartsOption\n  /**\n   * Keys to merge as arrays (replace by index) instead of by id. The middleware\n   * memoizes this content-stably, so identical sets don't re-trigger setOption.\n   */\n  replaceMerge?: readonly string[]\n  /**\n   * Opaque ECharts event passthrough — handlers fire untransformed.\n   *\n   * **Must be referentially stable** (memoize it with `useMemo` /\n   * `useCallback`, or hoist to module scope). The binding effect depends on\n   * the `onEvents` object identity; an inline `{ click: handler }` literal\n   * recreates the object on every render and causes every listener to be\n   * detached and re-attached each commit.\n   */\n  onEvents?: Record<string, EchartsEventHandler>\n  /**\n   * Init options forwarded to echarts.init. Captured at mount only — to change\n   * `renderer` or `height` after mount, unmount and remount the chart.\n   * Defaults: `{ renderer: 'svg', height: 304 }`.\n   */\n  init?: echarts.EChartsInitOpts\n  /**\n   * Optional callback fired once after the ECharts instance is created\n   * (`onInstance(chart)`) and once when it's about to be disposed\n   * (`onInstance(null)`). Used by `Widget.Echart` to publish the live\n   * instance to the per-widget registry so other actions (e.g.\n   * `ZoomToggle`'s disable handler) can reach it without DOM lookups.\n   * No need to memoize — the bridge wraps it in `useEffectEvent` so an\n   * unstable reference does not re-init the chart.\n   */\n  onInstance?: (chart: echarts.ECharts | null) => void\n  className?: string\n  sx?: SxProps<Theme>\n}\n\nexport function EchartUI({\n  option,\n  replaceMerge,\n  onEvents,\n  init,\n  onInstance,\n  className,\n  sx,\n}: EchartUIProps) {\n  const containerRef = useRef<HTMLDivElement>(null)\n  const chartRef = useRef<echarts.ECharts | null>(null)\n\n  // Structural fingerprint of the last applied series / dataset arrays.\n  // Used to decide whether the next `setOption` should *replace* those\n  // components (when their shape changed) or *merge* them (when only\n  // styling-level fields differ — e.g. a new `itemStyle.color` callback\n  // from a selection update). Replacing wipes ECharts' per-series runtime\n  // state (hover, animation cache, brush areas), so we want to do it only\n  // when the structure actually moved.\n  const seriesFingerprintRef = useRef<string | null>(null)\n  const datasetFingerprintRef = useRef<string | null>(null)\n\n  // Stable notify wrapper — always reads the latest `onInstance` prop\n  // without forcing the init effect below to re-run when the parent\n  // passes a fresh function reference. The init effect now only fires\n  // when `init` actually changes (documented as mount-only anyway).\n  const notifyInstance = useEffectEvent(\n    (chart: echarts.ECharts | null): void => {\n      onInstance?.(chart)\n    },\n  )\n\n  // Init / dispose. `init` is captured once at mount.\n  useEffect(() => {\n    if (!containerRef.current) return undefined\n    const chart = echarts.init(containerRef.current, null, {\n      ...DEFAULT_INIT_OPTS,\n      ...init,\n    })\n    chartRef.current = chart\n    notifyInstance(chart)\n    return () => {\n      // Notify observers *before* disposal so any queued imperative\n      // dispatches (e.g. ZoomToggle's `setOption` cleanup) see the\n      // instance disappear before its DOM is torn down.\n      notifyInstance(null)\n      chart.dispose()\n      chartRef.current = null\n    }\n  }, [init])\n\n  // Apply option / replaceMerge changes via merge mode (no remount required).\n  useEffect(() => {\n    const seriesFp = computeSeriesFingerprint(option)\n    const datasetFp = computeDatasetFingerprint(option)\n    const augmented = new Set<string>(replaceMerge ?? [])\n    if (seriesFp !== seriesFingerprintRef.current) augmented.add('series')\n    if (datasetFp !== datasetFingerprintRef.current) augmented.add('dataset')\n    seriesFingerprintRef.current = seriesFp\n    datasetFingerprintRef.current = datasetFp\n    chartRef.current?.setOption(option, {\n      notMerge: false,\n      lazyUpdate: true,\n      replaceMerge: augmented.size > 0 ? Array.from(augmented) : undefined,\n    })\n  }, [option, replaceMerge])\n\n  // Resize via shared singleton observer.\n  useEffect(() => {\n    const node = containerRef.current\n    if (!node) return undefined\n    return observeResize(node, () => {\n      chartRef.current?.resize()\n    })\n  }, [])\n\n  // Bind / unbind opaque event handlers.\n  useEffect(() => {\n    const chart = chartRef.current\n    if (!chart || !onEvents) return undefined\n    for (const [event, handler] of Object.entries(onEvents)) {\n      chart.on(event, handler)\n    }\n    return () => {\n      for (const [event, handler] of Object.entries(onEvents)) {\n        chart.off(event, handler)\n      }\n    }\n  }, [onEvents])\n\n  return (\n    <Box\n      ref={containerRef}\n      className={className}\n      sx={{ ...styles.root, ...sx }}\n    />\n  )\n}\n\n/**\n * Cheap structural digest of the option's `series` array — covers the fields\n * that actually demand a `replaceMerge` (length, type, datasetIndex, name,\n * stack, encode). Excludes runtime-style fields like `itemStyle` (callbacks\n * have unstable identity but don't change structure).\n */\nfunction computeSeriesFingerprint(option: echarts.EChartsOption): string {\n  const series = option.series\n  if (!Array.isArray(series)) return series ? '1' : ''\n  return series\n    .map((s) => {\n      if (s == null || typeof s !== 'object') return String(s)\n      const o = s as Record<string, unknown>\n      return [\n        o.type,\n        o.datasetIndex,\n        o.name,\n        o.stack,\n        // `encode` is small; stringify is cheap and stable for plain objects.\n        JSON.stringify(o.encode ?? null),\n      ].join('|')\n    })\n    .join('||')\n}\n\n/**\n * Structural digest of the option's `dataset` array — count is the only\n * thing that needs `replaceMerge` here. Row-level changes are picked up by\n * ECharts' default merge.\n */\nfunction computeDatasetFingerprint(option: echarts.EChartsOption): string {\n  const dataset = option.dataset\n  if (!Array.isArray(dataset)) return dataset ? '1' : ''\n  return String(dataset.length)\n}\n","import { useCallback, useMemo } from 'react'\nimport type * as echarts from 'echarts'\nimport {\n  applyTransforms,\n  setEchartInstance,\n  useWidgetId,\n  useWidgetShallow,\n  type Transform,\n} from '../stores'\nimport { EchartUI, type EchartsEventHandler } from './echart-ui'\n\n/**\n * Default ECharts `replaceMerge` keys for every widget. `dataZoom` and\n * `brush` are omitted so ZoomToggle / BrushToggle's user-driven runtime\n * state (slider range, brushed areas in `multiple` mode) survives unrelated\n * re-renders. `series` and `dataset` are also omitted: EchartUI fingerprints\n * them per-render and adds them to `replaceMerge` only when their shape\n * actually changes, keeping ECharts' per-series runtime state alive when\n * only callback-style fields differ.\n *\n * Lives in this module (not the generic store) because it's an ECharts\n * concept. Module-private — callers should not need it.\n */\nconst DEFAULT_REPLACE_MERGE: readonly string[] = ['toolbox']\n\n/**\n * Reactive context passed to every {@link OptionFactory} call so the\n * factory can rebuild render-time pieces (axis label / tooltip formatters)\n * from the live store. Drives RelativeData / consumer-formatter changes\n * through to the chart without rebuilding the structural option.\n */\nexport interface OptionFactoryContext {\n  formatter?: (value: number) => string\n  labelFormatter?: (value: string | number) => string | number\n}\n\n/**\n * The per-widget option factory — a single callable that owns BOTH phases\n * of option construction:\n *\n * - **Structural phase** — when `option == null`, return the theme-aware\n *   structural option (tooltip / legend / color palette / series\n *   template, optionally merged with a consumer-supplied `optionsOverride`).\n *   No data is read. `<Widget.Echart>` calls the factory with\n *   `(undefined, undefined)` synchronously during render to derive the\n *   structural base; `configTransforms` (Stack/Zoom/Brush) then mutate it\n *   in the same render pass.\n * - **Merge phase** — when `option` is defined, fuse `data` into the\n *   post-configTransforms option at fusion time. `<Widget.Echart>` calls\n *   the factory with `(transformed, data, ctx)` on every render.\n *\n * The two phases share a closure (the factory creator captures `theme`,\n * `formatter`, `labelFormatter`, `seriesNames`, `selection`, `optionsOverride`,\n * …), so structural and merge agree on the same widget configuration.\n *\n * The third arg `ctx` carries the **live** store-side formatters at the\n * call site — distinct from the closure-time formatters because actions\n * like RelativeData can install a percent formatter on the store after\n * the factory was constructed. The merge phase reads from `ctx`; the\n * structural phase typically uses the closure-time values.\n */\nexport type OptionFactory = (\n  option: echarts.EChartsOption | undefined,\n  data: unknown,\n  ctx?: OptionFactoryContext,\n) => echarts.EChartsOption\n\nexport interface EchartProps {\n  /**\n   * The per-widget {@link OptionFactory}. Required — `<Widget.Echart>`\n   * derives the structural option from it (so configTransforms have a base\n   * to mutate) and fuses `state.data` into the post-pipeline option at\n   * render time. Wrap the factory creator in `useMemo` so its identity is\n   * stable across renders.\n   */\n  optionFactory: OptionFactory\n  onEvents?: Record<string, EchartsEventHandler>\n  init?: echarts.EChartsInitOpts\n  className?: string\n}\n\ninterface EchartSlice {\n  data: unknown\n  configTransforms: readonly Transform[]\n  formatter?: (value: number) => string\n  labelFormatter?: (value: string | number) => string | number\n}\n\nconst echartSelector = (s: {\n  data: unknown\n  configTransforms: readonly Transform[]\n  formatter?: (value: number) => string\n  labelFormatter?: (value: string | number) => string | number\n}): EchartSlice => ({\n  data: s.data,\n  configTransforms: s.configTransforms,\n  formatter: s.formatter,\n  labelFormatter: s.labelFormatter,\n})\n\n/**\n * Stateful Echart bridge — owns the entire ECharts coupling. The whole\n * option pipeline lives here, not in the store:\n *\n * 1. **Structural** — `optionFactory(undefined, undefined)` produces the\n *    theme-aware base. Memoized on the factory identity, so the consumer's\n *    `useMemo` ID gates the rebuild.\n * 2. **Transformed** — `applyTransforms(structural, configTransforms)`\n *    applies any registered configTransforms (Stack/Zoom/Brush) over the\n *    structural base. Memoized on `[structural, configTransforms]`.\n * 3. **`replaceMerge`** — derived from the enabled configTransforms'\n *    `replaceMergeKeys`, deduped and sorted, seeded with\n *    {@link DEFAULT_REPLACE_MERGE}. Memoized on `[configTransforms]` so\n *    ECharts sees a stable array reference across non-transform changes.\n * 4. **Merge** — `optionFactory(transformed, data, ctx)` fuses post-\n *    pipeline data into the option. Reactive `ctx` carries the live store\n *    formatters so RelativeData's percent formatter flows through without\n *    a structural rebuild.\n *\n * The `<Widget.Provider>` doesn't know about the factory at all: it stays\n * a renderer-agnostic shell. The `ProviderProps` surface has no ECharts\n * coupling, so non-Echart widgets don't transitively import the type.\n */\nexport function Echart({\n  optionFactory,\n  onEvents,\n  init,\n  className,\n}: EchartProps) {\n  const id = useWidgetId()\n  const slice = useWidgetShallow(id, echartSelector)\n\n  // Publish the live ECharts instance to the per-id registry so actions\n  // (e.g. `ZoomToggle`'s disable handler) can reach it imperatively. The\n  // callback identity is stable across renders (only `id` is in deps), so\n  // EchartUI's init effect doesn't see a fresh `onInstance` and re-init.\n  const onInstance = useCallback(\n    (chart: echarts.ECharts | null) => setEchartInstance(id, chart),\n    [id],\n  )\n\n  // Destructure so React Compiler sees specific deps instead of inferring\n  // the whole `slice` object. `useWidgetShallow` already shallow-compares\n  // the slice, so per-field deps drive each memo exactly when its inputs\n  // change.\n  const {\n    data: sliceData,\n    configTransforms,\n    formatter: sliceFormatter,\n    labelFormatter: sliceLabelFormatter,\n  } = slice\n\n  const structural = useMemo(\n    () => optionFactory(undefined, undefined),\n    [optionFactory],\n  )\n\n  const transformed = useMemo(\n    () =>\n      applyTransforms(structural, configTransforms) as echarts.EChartsOption,\n    [structural, configTransforms],\n  )\n\n  const replaceMerge = useMemo(() => {\n    const keys = new Set<string>(DEFAULT_REPLACE_MERGE)\n    for (const xf of configTransforms) {\n      if (xf.enabled && xf.replaceMergeKeys?.length) {\n        for (const k of xf.replaceMergeKeys) keys.add(k)\n      }\n    }\n    return Array.from(keys).sort()\n  }, [configTransforms])\n\n  const option = useMemo(\n    () =>\n      optionFactory(transformed, sliceData, {\n        formatter: sliceFormatter,\n        labelFormatter: sliceLabelFormatter,\n      }),\n    [\n      optionFactory,\n      transformed,\n      sliceData,\n      sliceFormatter,\n      sliceLabelFormatter,\n    ],\n  )\n\n  return (\n    <EchartUI\n      option={option}\n      replaceMerge={replaceMerge}\n      onEvents={onEvents}\n      init={init}\n      onInstance={onInstance}\n      className={className}\n    />\n  )\n}\n"],"names":["callbacks","Map","observer","getObserver","ResizeObserver","entries","entry","callback","get","target","NOOP_CLEANUP","observeResize","element","ro","set","observe","delete","unobserve","size","disconnect","__resetSharedResizeObserver","clear","styles","root","width","minHeight","DEFAULT_INIT_OPTS","renderer","height","EchartUI","t0","$","_c","option","replaceMerge","onEvents","init","onInstance","className","sx","containerRef","useRef","chartRef","seriesFingerprintRef","datasetFingerprintRef","t1","chart","notifyInstance","useEffectEvent","t2","current","chart_0","echarts","dispose","t3","useEffect","t4","t5","seriesFp","computeSeriesFingerprint","datasetFp","computeDatasetFingerprint","augmented","Set","add","setOption","notMerge","lazyUpdate","Array","from","undefined","t6","t7","Symbol","for","node","resize","t8","t9","chart_1","event","handler","Object","on","event_0","handler_0","off","t10","t11","Box","series","isArray","map","s","String","o","type","datasetIndex","name","stack","JSON","stringify","encode","join","dataset","length","DEFAULT_REPLACE_MERGE","echartSelector","data","configTransforms","formatter","labelFormatter","Echart","optionFactory","id","useWidgetId","slice","useWidgetShallow","setEchartInstance","sliceData","sliceFormatter","sliceLabelFormatter","structural","applyTransforms","transformed","keys","xf","enabled","replaceMergeKeys","k","sort"],"mappings":"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"}