@carto/ps-react-ui 4.17.3 → 4.18.0

package/dist/echart-B10dhEaM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echart-B10dhEaM.js","sources":["../src/widgets-v2/echart/edge-label-clamp.ts","../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":["import * as echarts from 'echarts'\nimport type { ECharts, EChartsOption } from 'echarts'\n\n/**\n * Render-time clamp that stops the first/last **category x-axis** labels from\n * clipping at the chart edges — *only when they actually overflow*.\n *\n * ECharts centers each category label on its tick; the first/last ticks sit at\n * the plot boundary, so a wide edge label spills past the chart and is cut off.\n * `grid.containLabel` does not contain this horizontal overflow and the v6\n * `outerBounds` shrink is unreliable, so we measure at render time and anchor\n * the overflowing edge label inward (`alignMinLabel: 'left'` /\n * `alignMaxLabel: 'right'`). Labels that fit stay centered.\n *\n * Lives in the generic bridge because the verdict needs the laid-out chart\n * (`convertToPixel`, `getWidth`); everything else is read from the `option`.\n * Auto-targets bar + histogram (category x-axis); pie's horizontal-bar fallback\n * (category *y*-axis), scatterplot (value) and timeseries (time) are skipped.\n */\n\nexport interface EdgeAlignment {\n  alignMinLabel: 'left' | null\n  alignMaxLabel: 'right' | null\n}\n\nexport const CENTERED: EdgeAlignment = {\n  alignMinLabel: null,\n  alignMaxLabel: null,\n}\n\n// Small cushion biasing toward anchoring when borderline: clipping is worse\n// than a hair of off-centering, and the measured width can differ slightly\n// from the final render (mainly when the web font isn't loaded yet at measure\n// time). Kept to 1px — a wider margin anchored labels that only just clear the\n// edge, and an anchored edge label can then be dropped by the axis\n// `hideOverlap`, leaving a gap. 1px guards measurement error without that.\nconst SAFETY_MARGIN_PX = 1\n\n/**\n * Pure overflow decision. Inputs are anchor-independent (tick centers and text\n * width don't depend on the label's current `text-anchor`), so feeding the\n * result back via `setOption` doesn't change them — the next pass yields the\n * same verdict, keeping the clamp loop-stable.\n */\nexport function decideEdgeAlignment(args: {\n  firstLabel: string\n  lastLabel: string\n  font: string\n  firstTickX: number\n  lastTickX: number\n  width: number\n}): EdgeAlignment {\n  const halfFirst =\n    echarts.format.getTextRect(args.firstLabel, args.font).width / 2\n  const halfLast =\n    echarts.format.getTextRect(args.lastLabel, args.font).width / 2\n  return {\n    alignMinLabel:\n      halfFirst + SAFETY_MARGIN_PX > args.firstTickX ? 'left' : null,\n    alignMaxLabel:\n      halfLast + SAFETY_MARGIN_PX > args.width - args.lastTickX\n        ? 'right'\n        : null,\n  }\n}\n\ninterface AxisLabel {\n  formatter?: (value: string | number) => string | number\n  fontSize?: number | string\n  fontFamily?: string\n  fontWeight?: number | string\n}\n\ninterface CategoryXAxis {\n  type?: string\n  axisLabel?: AxisLabel\n}\n\ninterface SeriesLike {\n  encode?: { x?: string | number }\n  datasetIndex?: number\n}\n\ntype Cell = string | number | null | undefined\n\nfunction firstOf<T>(value: T | T[] | undefined): T | undefined {\n  if (Array.isArray(value)) return value[0]\n  return value\n}\n\nfunction firstXAxis(option: EChartsOption): CategoryXAxis | undefined {\n  const axis = firstOf(\n    option.xAxis as CategoryXAxis | CategoryXAxis[] | undefined,\n  )\n  return axis && typeof axis === 'object' ? axis : undefined\n}\n\nfunction hasDataZoom(option: EChartsOption): boolean {\n  const dz = option.dataZoom\n  return Array.isArray(dz) ? dz.length > 0 : dz != null\n}\n\nfunction cellToText(value: Cell, fmt: AxisLabel['formatter']): string {\n  if (typeof fmt === 'function') return String(fmt(value ?? ''))\n  return value == null ? '' : String(value)\n}\n\n/**\n * Extracts the displayed first/last category strings and the label font from\n * the option, reading categories generically via `series[0].encode.x` into the\n * referenced dataset (`'name'` for bar, `0` for histogram). Returns `null` when\n * the option isn't a measurable category x-axis (fewer than 2 categories, no\n * dataset, etc.).\n */\nexport function resolveEdgeLabels(option: EChartsOption): {\n  firstLabel: string\n  lastLabel: string\n  font: string\n  count: number\n} | null {\n  const xAxis = firstXAxis(option)\n  if (!xAxis) return null\n  if (xAxis.type !== 'category') return null\n\n  const series0 = firstOf(\n    option.series as SeriesLike | SeriesLike[] | undefined,\n  )\n  const encodeX = series0?.encode?.x\n  if (encodeX == null) return null\n\n  const datasetIndex = series0?.datasetIndex ?? 0\n  const allDatasets = option.dataset as\n    | { source?: unknown }\n    | { source?: unknown }[]\n    | undefined\n  const dataset = Array.isArray(allDatasets)\n    ? allDatasets[datasetIndex]\n    : allDatasets\n  const source = dataset?.source\n  if (!Array.isArray(source) || source.length < 2) return null\n\n  const rows = source as Record<string | number, Cell>[]\n  const fmt = xAxis.axisLabel?.formatter\n  const axisLabel = xAxis.axisLabel ?? {}\n  const size =\n    typeof axisLabel.fontSize === 'number'\n      ? `${axisLabel.fontSize}px`\n      : (axisLabel.fontSize ?? '12px')\n  const family = axisLabel.fontFamily ?? 'sans-serif'\n  const weight = axisLabel.fontWeight != null ? `${axisLabel.fontWeight} ` : ''\n\n  return {\n    firstLabel: cellToText(rows[0]?.[encodeX], fmt),\n    lastLabel: cellToText(rows[rows.length - 1]?.[encodeX], fmt),\n    font: `${weight}${size} ${family}`,\n    count: source.length,\n  }\n}\n\n/**\n * Measures the rendered chart and, when the edge labels would clip, applies\n * `alignMinLabel`/`alignMaxLabel` (or clears them) via an imperative merge\n * `setOption`. Returns the alignment now in effect so the caller can keep a\n * `prev` ref and skip redundant `setOption`s. Should be invoked from the\n * chart's `finished` event (layout is settled, so `convertToPixel` is valid).\n */\nexport function clampEdgeLabels(\n  chart: ECharts,\n  option: EChartsOption,\n  prev: EdgeAlignment,\n): EdgeAlignment {\n  const next = computeAlignment(chart, option)\n  if (\n    next.alignMinLabel === prev.alignMinLabel &&\n    next.alignMaxLabel === prev.alignMaxLabel\n  ) {\n    return prev\n  }\n  chart.setOption({ xAxis: { axisLabel: { ...next } } } as EChartsOption, {\n    lazyUpdate: true,\n  })\n  return next\n}\n\nfunction computeAlignment(\n  chart: ECharts,\n  option: EChartsOption,\n): EdgeAlignment {\n  // Under dataZoom, convertToPixel on the absolute first/last index returns\n  // off-plot pixels, so the overflow math is invalid — reset to centered.\n  if (hasDataZoom(option)) return CENTERED\n\n  const labels = resolveEdgeLabels(option)\n  if (!labels) return CENTERED\n\n  const firstTickX = chart.convertToPixel({ xAxisIndex: 0 }, 0)\n  const lastTickX = chart.convertToPixel({ xAxisIndex: 0 }, labels.count - 1)\n  const width = chart.getWidth()\n  // Layout not measurable yet (defensive — `finished` normally fires after\n  // layout). Fall back to centered; a later `finished` re-measures.\n  if (\n    typeof firstTickX !== 'number' ||\n    typeof lastTickX !== 'number' ||\n    !Number.isFinite(firstTickX) ||\n    !Number.isFinite(lastTickX) ||\n    !width\n  ) {\n    return CENTERED\n  }\n\n  return decideEdgeAlignment({\n    firstLabel: labels.firstLabel,\n    lastLabel: labels.lastLabel,\n    font: labels.font,\n    firstTickX,\n    lastTickX,\n    width,\n  })\n}\n","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 {\n  clampEdgeLabels,\n  CENTERED,\n  type EdgeAlignment,\n} from './edge-label-clamp'\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  // Latest applied option (read by the `finished` clamp listener, which is\n  // bound once and must see the current option) + the edge-label alignment\n  // currently applied to the chart (so the clamp skips redundant setOptions).\n  const optionRef = useRef<echarts.EChartsOption>(option)\n  const edgeAlignRef = useRef<EdgeAlignment>(CENTERED)\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    // Edge-label clamp: after each layout settles (option change OR resize both\n    // end in a render → `finished`), measure the category x-axis edge labels\n    // and anchor them inward only if they'd clip. `finished` (not rAF) so\n    // `convertToPixel` sees the flushed `lazyUpdate` layout. Loop-safe: the\n    // verdict is anchor-independent, so our own clamp setOption recomputes the\n    // same result and the ref guard short-circuits.\n    const onFinished = (): void => {\n      edgeAlignRef.current = clampEdgeLabels(\n        chart,\n        optionRef.current,\n        edgeAlignRef.current,\n      )\n    }\n    chart.on('finished', onFinished)\n    // Never let the legend end up with every item hidden — a user can click\n    // series off one by one until the chart goes blank. `selected` on this\n    // event is always the FULL name→boolean map (not just the clicked item),\n    // so \"every value false\" reliably means \"nothing left visible\". Restore\n    // all of them instead. `legendAllSelect` fires its own `legendselectall`\n    // event, not `legendselectchanged`, so this can't re-trigger itself.\n    // Always-on and independent of the consumer's `onEvents` — applies to\n    // every ECharts widget in the library for free. A widget that disables\n    // legend clicks entirely (e.g. Pie's `selectedMode: false`) never fires\n    // `legendselectchanged`, so this is a no-op there.\n    const onLegendSelectChanged = (params: unknown): void => {\n      const { selected } = params as { selected?: Record<string, boolean> }\n      if (!selected) return\n      const names = Object.keys(selected)\n      if (names.length > 0 && names.every((name) => !selected[name])) {\n        chart.dispatchAction({ type: 'legendAllSelect' })\n      }\n    }\n    chart.on('legendselectchanged', onLegendSelectChanged)\n    return () => {\n      chart.off('finished', onFinished)\n      chart.off('legendselectchanged', onLegendSelectChanged)\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    // Expose the latest option to the `finished` clamp listener (bound once).\n    optionRef.current = option\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":["CENTERED","alignMinLabel","alignMaxLabel","SAFETY_MARGIN_PX","decideEdgeAlignment","args","halfFirst","echarts","format","getTextRect","firstLabel","font","width","halfLast","lastLabel","firstTickX","lastTickX","firstOf","value","Array","isArray","firstXAxis","option","axis","xAxis","undefined","hasDataZoom","dz","dataZoom","length","cellToText","fmt","String","resolveEdgeLabels","type","series0","series","encodeX","encode","x","datasetIndex","allDatasets","dataset","source","rows","axisLabel","formatter","size","fontSize","family","fontFamily","weight","fontWeight","count","clampEdgeLabels","chart","prev","next","computeAlignment","setOption","lazyUpdate","labels","convertToPixel","xAxisIndex","getWidth","Number","isFinite","callbacks","Map","observer","getObserver","ResizeObserver","entries","entry","callback","get","target","NOOP_CLEANUP","observeResize","element","ro","set","observe","delete","unobserve","disconnect","__resetSharedResizeObserver","clear","styles","root","minHeight","DEFAULT_INIT_OPTS","renderer","height","EchartUI","t0","$","_c","replaceMerge","onEvents","init","onInstance","className","sx","containerRef","useRef","chartRef","seriesFingerprintRef","datasetFingerprintRef","optionRef","edgeAlignRef","t1","notifyInstance","useEffectEvent","t2","current","chart_0","onFinished","on","onLegendSelectChanged","params","selected","names","Object","keys","every","name","dispatchAction","off","dispose","t3","useEffect","t4","t5","seriesFp","computeSeriesFingerprint","datasetFp","computeDatasetFingerprint","augmented","Set","add","notMerge","from","t6","t7","Symbol","for","node","resize","t8","t9","chart_1","event","handler","event_0","handler_0","t10","t11","Box","map","s","o","stack","JSON","stringify","join","DEFAULT_REPLACE_MERGE","echartSelector","data","configTransforms","labelFormatter","Echart","optionFactory","id","useWidgetId","slice","useWidgetShallow","setEchartInstance","sliceData","sliceFormatter","sliceLabelFormatter","structural","applyTransforms","transformed","xf","enabled","replaceMergeKeys","k","sort"],"mappings":";;;;;;;;AAyBO,MAAMA,IAA0B;AAAA,EACrCC,eAAe;AAAA,EACfC,eAAe;AACjB,GAQMC,IAAmB;AAQlB,SAASC,EAAoBC,GAOlB;AAChB,QAAMC,IACJC,EAAQC,OAAOC,YAAYJ,EAAKK,YAAYL,EAAKM,IAAI,EAAEC,QAAQ,GAC3DC,IACJN,EAAQC,OAAOC,YAAYJ,EAAKS,WAAWT,EAAKM,IAAI,EAAEC,QAAQ;AAChE,SAAO;AAAA,IACLX,eACEK,IAAYH,IAAmBE,EAAKU,aAAa,SAAS;AAAA,IAC5Db,eACEW,IAAWV,IAAmBE,EAAKO,QAAQP,EAAKW,YAC5C,UACA;AAAA,EAAA;AAEV;AAqBA,SAASC,EAAWC,GAA2C;AAC7D,SAAIC,MAAMC,QAAQF,CAAK,IAAUA,EAAM,CAAC,IACjCA;AACT;AAEA,SAASG,EAAWC,GAAkD;AACpE,QAAMC,IAAON,EACXK,EAAOE,KACT;AACA,SAAOD,KAAQ,OAAOA,KAAS,WAAWA,IAAOE;AACnD;AAEA,SAASC,EAAYJ,GAAgC;AACnD,QAAMK,IAAKL,EAAOM;AAClB,SAAOT,MAAMC,QAAQO,CAAE,IAAIA,EAAGE,SAAS,IAAIF,KAAM;AACnD;AAEA,SAASG,EAAWZ,GAAaa,GAAqC;AACpE,SAAI,OAAOA,KAAQ,aAAmBC,OAAOD,EAAIb,KAAS,EAAE,CAAC,IACtDA,KAAS,OAAO,KAAKc,OAAOd,CAAK;AAC1C;AASO,SAASe,GAAkBX,GAKzB;AACP,QAAME,IAAQH,EAAWC,CAAM;AAE/B,MADI,CAACE,KACDA,EAAMU,SAAS,WAAY,QAAO;AAEtC,QAAMC,IAAUlB,EACdK,EAAOc,MACT,GACMC,IAAUF,GAASG,QAAQC;AACjC,MAAIF,KAAW,KAAM,QAAO;AAE5B,QAAMG,IAAeL,GAASK,gBAAgB,GACxCC,IAAcnB,EAAOoB,SAOrBC,KAHUxB,MAAMC,QAAQqB,CAAW,IACrCA,EAAYD,CAAY,IACxBC,IACoBE;AACxB,MAAI,CAACxB,MAAMC,QAAQuB,CAAM,KAAKA,EAAOd,SAAS,EAAG,QAAO;AAExD,QAAMe,IAAOD,GACPZ,IAAMP,EAAMqB,WAAWC,WACvBD,IAAYrB,EAAMqB,aAAa,CAAA,GAC/BE,IACJ,OAAOF,EAAUG,YAAa,WAC1B,GAAGH,EAAUG,QAAQ,OACpBH,EAAUG,YAAY,QACvBC,IAASJ,EAAUK,cAAc,cACjCC,IAASN,EAAUO,cAAc,OAAO,GAAGP,EAAUO,UAAU,MAAM;AAE3E,SAAO;AAAA,IACL1C,YAAYoB,EAAWc,EAAK,CAAC,IAAIP,CAAO,GAAGN,CAAG;AAAA,IAC9CjB,WAAWgB,EAAWc,EAAKA,EAAKf,SAAS,CAAC,IAAIQ,CAAO,GAAGN,CAAG;AAAA,IAC3DpB,MAAM,GAAGwC,CAAM,GAAGJ,CAAI,IAAIE,CAAM;AAAA,IAChCI,OAAOV,EAAOd;AAAAA,EAAAA;AAElB;AASO,SAASyB,GACdC,GACAjC,GACAkC,GACe;AACf,QAAMC,IAAOC,GAAiBH,GAAOjC,CAAM;AAC3C,SACEmC,EAAKxD,kBAAkBuD,EAAKvD,iBAC5BwD,EAAKvD,kBAAkBsD,EAAKtD,gBAErBsD,KAETD,EAAMI,UAAU;AAAA,IAAEnC,OAAO;AAAA,MAAEqB,WAAW;AAAA,QAAE,GAAGY;AAAAA,MAAAA;AAAAA,IAAK;AAAA,EAAE,GAAsB;AAAA,IACtEG,YAAY;AAAA,EAAA,CACb,GACMH;AACT;AAEA,SAASC,GACPH,GACAjC,GACe;AAGf,MAAII,EAAYJ,CAAM,EAAG,QAAOtB;AAEhC,QAAM6D,IAAS5B,GAAkBX,CAAM;AACvC,MAAI,CAACuC,EAAQ,QAAO7D;AAEpB,QAAMe,IAAawC,EAAMO,eAAe;AAAA,IAAEC,YAAY;AAAA,EAAA,GAAK,CAAC,GACtD/C,IAAYuC,EAAMO,eAAe;AAAA,IAAEC,YAAY;AAAA,EAAA,GAAKF,EAAOR,QAAQ,CAAC,GACpEzC,IAAQ2C,EAAMS,SAAAA;AAGpB,SACE,OAAOjD,KAAe,YACtB,OAAOC,KAAc,YACrB,CAACiD,OAAOC,SAASnD,CAAU,KAC3B,CAACkD,OAAOC,SAASlD,CAAS,KAC1B,CAACJ,IAEMZ,IAGFI,EAAoB;AAAA,IACzBM,YAAYmD,EAAOnD;AAAAA,IACnBI,WAAW+C,EAAO/C;AAAAA,IAClBH,MAAMkD,EAAOlD;AAAAA,IACbI,YAAAA;AAAAA,IACAC,WAAAA;AAAAA,IACAJ,OAAAA;AAAAA,EAAAA,CACD;AACH;ACxNA,MAAMuD,wBAAgBC,IAAAA;AACtB,IAAIC,IAAkC;AAOtC,SAASC,KAAqC;AAC5C,SAAI,OAAOC,iBAAmB,MAAoB,QAClDF,MAAa,IAAIE,eAAgBC,CAAAA,MAAY;AAC3C,eAAWC,KAASD;AAElBE,MADiBP,EAAUQ,IAAIF,EAAMG,MAAM,IAC3CF;AAAAA,EAEJ,CAAC,GACML;AACT;AAEA,MAAMQ,KAAeA,MAAAA;AAAAA;AAEd,SAASC,GACdC,GACAL,GACY;AACZ,QAAMM,IAAKV,GAAAA;AAIX,SAAKU,KACLb,EAAUc,IAAIF,GAASL,CAAQ,GAC/BM,EAAGE,QAAQH,CAAO,GACX,MAAM;AACXZ,IAAAA,EAAUgB,OAAOJ,CAAO,GACpBV,MACFA,EAASe,UAAUL,CAAO,GAKtBZ,EAAUpB,SAAS,MACrBsB,EAASgB,WAAAA,GACThB,IAAW;AAAA,EAGjB,KAhBgBQ;AAiBlB;AAGO,SAASS,KAAoC;AAClD,EAAIjB,OAAmBgB,WAAAA,GACvBlB,EAAUoB,MAAAA,GACVlB,IAAW;AACb;ACrDO,MAAMmB,KAAS;AAAA,EACpBC,MAAM;AAAA,IACJ7E,OAAO;AAAA,IACP8E,WAAW;AAAA,EAAA;AAEf,GCIaC,KAAoB;AAAA,EAC/BC,UAAU;AAAA,EACVC,QAAQ;AACV;AAyCO,SAAAC,GAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAkB;AAAA,IAAA3E,QAAAA;AAAAA,IAAA4E,cAAAA;AAAAA,IAAAC,UAAAA;AAAAA,IAAAC,MAAAA;AAAAA,IAAAC,YAAAA;AAAAA,IAAAC,WAAAA;AAAAA,IAAAC,IAAAA;AAAAA,EAAAA,IAAAR,GASvBS,IAAqBC,EAAuB,IAAI,GAChDC,IAAiBD,EAA+B,IAAI,GASpDE,IAA6BF,EAAsB,IAAI,GACvDG,IAA8BH,EAAsB,IAAI,GAKxDI,IAAkBJ,EAA8BnF,CAAM,GACtDwF,IAAqBL,EAAsBzG,CAAQ;AAAC,MAAA+G;AAAA,EAAAf,SAAAK,KAOlDU,IAAAxD,CAAAA,MAAA;AACE8C,IAAAA,IAAa9C,CAAK;AAAA,EAAC,GACpByC,OAAAK,GAAAL,OAAAe,KAAAA,IAAAf,EAAA,CAAA;AAHH,QAAAgB,IAAuBC,EACrBF,CAGF;AAAC,MAAAG;AAAA,EAAAlB,EAAA,CAAA,MAAAI,KAAAJ,SAAAgB,KAGSE,IAAAA,MAAA;AACR,QAAI,CAACV,EAAYW;AAAQ;AACzB,UAAAC,IAAc7G,EAAO6F,KAAMI,EAAYW,SAAU,MAAM;AAAA,MAAA,GAClDxB;AAAAA,MAAiB,GACjBS;AAAAA,IAAAA,CACJ;AACDM,IAAAA,EAAQS,UAAW5D,GACnByD,EAAezD,CAAK;AAOpB,UAAA8D,IAAmBA,MAAA;AACjBP,MAAAA,EAAYK,UAAW7D,GACrBC,GACAsD,EAASM,SACTL,EAAYK,OACd;AAAA,IAJoB;AAMtB5D,IAAAA,EAAK+D,GAAI,YAAYD,CAAU;AAW/B,UAAAE,IAA8BC,CAAAA,MAAA;AAC5B,YAAA;AAAA,QAAAC,UAAAA;AAAAA,MAAAA,IAAqBD;AACrB,UAAI,CAACC;AAAQ;AACb,YAAAC,IAAcC,OAAMC,KAAMH,CAAQ;AAClC,MAAIC,EAAK7F,SAAU,KAAK6F,EAAKG,MAAOC,OAAU,CAACL,EAASK,CAAI,CAAC,KAC3DvE,EAAKwE,eAAgB;AAAA,QAAA7F,MAAQ;AAAA,MAAA,CAAmB;AAAA,IACjD;AAEHqB,WAAAA,EAAK+D,GAAI,uBAAuBC,CAAqB,GAC9C,MAAA;AACLhE,MAAAA,EAAKyE,IAAK,YAAYX,CAAU,GAChC9D,EAAKyE,IAAK,uBAAuBT,CAAqB,GAItDP,EAAe,IAAI,GACnBzD,EAAK0E,QAAAA,GACLvB,EAAQS,UAAW;AAAA,IAAH;AAAA,EACjB,GACFnB,OAAAI,GAAAJ,OAAAgB,GAAAhB,OAAAkB,KAAAA,IAAAlB,EAAA,CAAA;AAAA,MAAAkC;AAAA,EAAAlC,SAAAI,KAAE8B,IAAA,CAAC9B,CAAI,GAACJ,OAAAI,GAAAJ,OAAAkC,KAAAA,IAAAlC,EAAA,CAAA,GAnDTmC,EAAUjB,GAmDPgB,CAAM;AAAC,MAAAE,GAAAC;AAAA,EAAArC,EAAA,CAAA,MAAA1E,KAAA0E,SAAAE,KAGAkC,IAAAA,MAAA;AACR,UAAAE,IAAiBC,GAAyBjH,CAAM,GAChDkH,IAAkBC,GAA0BnH,CAAM,GAClDoH,IAAkB,IAAIC,IAAYzC,KAAA,CAAA,CAAkB;AACpD,IAAIoC,MAAa3B,EAAoBQ,WAAUuB,EAASE,IAAK,QAAQ,GACjEJ,MAAc5B,EAAqBO,WAAUuB,EAASE,IAAK,SAAS,GACxEjC,EAAoBQ,UAAWmB,GAC/B1B,EAAqBO,UAAWqB,GAEhC3B,EAASM,UAAW7F,GACpBoF,EAAQS,SAAmBxD,UAACrC,GAAQ;AAAA,MAAAuH,UACxB;AAAA,MAAKjF,YACH;AAAA,MAAIsC,cACFwC,EAAS3F,OAAQ,IAAI5B,MAAK2H,KAAMJ,CAAqB,IAArDjH;AAAAA,IAAAA,CACf;AAAA,EAAC,GACD4G,IAAA,CAAC/G,GAAQ4E,CAAY,GAACF,OAAA1E,GAAA0E,OAAAE,GAAAF,OAAAoC,GAAApC,QAAAqC,MAAAD,IAAApC,EAAA,CAAA,GAAAqC,IAAArC,EAAA,EAAA,IAfzBmC,EAAUC,GAePC,CAAsB;AAAC,MAAAU,GAAAC;AAAA,EAAAhD,EAAA,EAAA,MAAAiD,uBAAAC,IAAA,2BAAA,KAGhBH,IAAAA,MAAA;AACR,UAAAI,IAAa3C,EAAYW;AACzB,QAAKgC;AAAsB,aACpBrE,GAAcqE,GAAM,MAAA;AACzBzC,QAAAA,EAAQS,SAAgBiC,OAAAA;AAAAA,MAAE,CAC3B;AAAA,EAAC,GACDJ,IAAA,CAAA,GAAEhD,QAAA+C,GAAA/C,QAAAgD,MAAAD,IAAA/C,EAAA,EAAA,GAAAgD,IAAAhD,EAAA,EAAA,IANLmC,EAAUY,GAMPC,CAAE;AAAC,MAAAK,GAAAC;AAAA,EAAAtD,UAAAG,KAGIkD,IAAAA,MAAA;AACR,UAAAE,IAAc7C,EAAQS;AACtB,QAAI,GAAC5D,KAAD,CAAW4C,IACf;AAAA,iBAAK,CAAAqD,GAAAC,CAAA,KAA0B9B,OAAMnD,QAAS2B,CAAQ;AACpD5C,QAAAA,EAAK+D,GAAIkC,GAAOC,CAAO;AACxB,aACM,MAAA;AACL,mBAAK,CAAAC,GAAAC,CAAA,KAA0BhC,OAAMnD,QAAS2B,CAAQ;AACpD5C,UAAAA,EAAKyE,IAAKwB,GAAOC,CAAO;AAAA,MACzB;AAAA;AAAA,EACF,GACAH,IAAA,CAACnD,CAAQ,GAACH,QAAAG,GAAAH,QAAAqD,GAAArD,QAAAsD,MAAAD,IAAArD,EAAA,EAAA,GAAAsD,IAAAtD,EAAA,EAAA,IAXbmC,EAAUkB,GAWPC,CAAU;AAAC,MAAAM;AAAA,EAAA5D,UAAAO,KAMNqD,IAAA;AAAA,IAAA,GAAKpE,GAAMC;AAAAA,IAAK,GAAKc;AAAAA,EAAAA,GAAIP,QAAAO,GAAAP,QAAA4D,KAAAA,IAAA5D,EAAA,EAAA;AAAA,MAAA6D;AAAA,SAAA7D,EAAA,EAAA,MAAAM,KAAAN,UAAA4D,KAH/BC,sBAACC,GAAA,EACMtD,KAAAA,GACMF,WAAAA,GACP,IAAAsD,GAAyB,GAC7B5D,QAAAM,GAAAN,QAAA4D,GAAA5D,QAAA6D,KAAAA,IAAA7D,EAAA,EAAA,GAJF6D;AAIE;AAUN,SAAStB,GAAyBjH,GAAuC;AACvE,QAAMc,IAASd,EAAOc;AACtB,SAAKjB,MAAMC,QAAQgB,CAAM,IAClBA,EACJ2H,IAAKC,CAAAA,MAAM;AACV,QAAIA,KAAK,QAAQ,OAAOA,KAAM,SAAU,QAAOhI,OAAOgI,CAAC;AACvD,UAAMC,IAAID;AACV,WAAO;AAAA,MACLC,EAAE/H;AAAAA,MACF+H,EAAEzH;AAAAA,MACFyH,EAAEnC;AAAAA,MACFmC,EAAEC;AAAAA;AAAAA,MAEFC,KAAKC,UAAUH,EAAE3H,UAAU,IAAI;AAAA,IAAA,EAC/B+H,KAAK,GAAG;AAAA,EACZ,CAAC,EACAA,KAAK,IAAI,IAduBjI,IAAS,MAAM;AAepD;AAOA,SAASqG,GAA0BnH,GAAuC;AACxE,QAAMoB,IAAUpB,EAAOoB;AACvB,SAAKvB,MAAMC,QAAQsB,CAAO,IACnBV,OAAOU,EAAQb,MAAM,IADQa,IAAU,MAAM;AAEtD;AChNA,MAAM4H,KAA2C,CAAC,SAAS,GAiErDC,KAAiBA,CAACP,OAKJ;AAAA,EAClBQ,MAAMR,EAAEQ;AAAAA,EACRC,kBAAkBT,EAAES;AAAAA,EACpB3H,WAAWkH,EAAElH;AAAAA,EACb4H,gBAAgBV,EAAEU;AACpB;AAyBO,SAAAC,GAAA5E,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAgB;AAAA,IAAA2E,eAAAA;AAAAA,IAAAzE,UAAAA;AAAAA,IAAAC,MAAAA;AAAAA,IAAAE,WAAAA;AAAAA,EAAAA,IAAAP,GAMrB8E,IAAWC,EAAAA,GACXC,IAAcC,EAAiBH,GAAIN,EAAc;AAAC,MAAAxD;AAAA,EAAAf,SAAA6E,KAOhD9D,IAAAxD,CAAAA,MAAmC0H,EAAkBJ,GAAItH,CAAK,GAACyC,OAAA6E,GAAA7E,OAAAe,KAAAA,IAAAf,EAAA,CAAA;AADjE,QAAAK,IAAmBU,GASnB;AAAA,IAAAyD,MAAAU;AAAAA,IAAAT,kBAAAA;AAAAA,IAAA3H,WAAAqI;AAAAA,IAAAT,gBAAAU;AAAAA,EAAAA,IAKIL;AAAK,MAAA7D;AAAA,EAAAlB,SAAA4E,KAGD1D,IAAA0D,EAAcnJ,QAAWA,MAAS,GAACuE,OAAA4E,GAAA5E,OAAAkB,KAAAA,IAAAlB,EAAA,CAAA;AAD3C,QAAAqF,IACQnE;AAEP,MAAAgB;AAAA,EAAAlC,EAAA,CAAA,MAAAyE,KAAAzE,SAAAqF,KAIGnD,IAAAoD,EAAgBD,GAAYZ,CAAgB,GAACzE,OAAAyE,GAAAzE,OAAAqF,GAAArF,OAAAkC,KAAAA,IAAAlC,EAAA,CAAA;AAFjD,QAAAuF,IAEIrD;AAEH,MAAAE;AAAA,MAAApC,SAAAyE,GAAA;AAGC,UAAA7C,IAAa,IAAIe,IAAY2B,EAAqB;AAClD,eAAKkB,KAAYf;AACf,UAAIe,EAAEC,WAAYD,EAAEE,kBAAyB7J;AAC3C,mBAAK8J,KAAWH,EAAEE;AAAmB9D,UAAAA,EAAIgB,IAAK+C,CAAC;AAG5CvD,IAAAA,IAAAjH,MAAK2H,KAAMlB,CAAI,EAACgE,KAAAA,GAAO5F,OAAAyE,GAAAzE,OAAAoC;AAAAA,EAAA;AAAAA,IAAAA,IAAApC,EAAA,CAAA;AAPhC,QAAAE,IAOEkC;AACoB,MAAAC;AAAA,EAAArC,EAAA,CAAA,MAAA4E,KAAA5E,EAAA,EAAA,MAAAkF,KAAAlF,EAAA,EAAA,MAAAmF,KAAAnF,EAAA,EAAA,MAAAoF,KAAApF,UAAAuF,KAIlBlD,IAAAuC,EAAcW,GAAaL,GAAW;AAAA,IAAApI,WACzBqI;AAAAA,IAAcT,gBACTU;AAAAA,EAAAA,CACjB,GAACpF,OAAA4E,GAAA5E,QAAAkF,GAAAlF,QAAAmF,GAAAnF,QAAAoF,GAAApF,QAAAuF,GAAAvF,QAAAqC,KAAAA,IAAArC,EAAA,EAAA;AALN,QAAA1E,IAEI+G;AAWH,MAAAU;AAAA,SAAA/C,UAAAM,KAAAN,EAAA,EAAA,MAAAI,KAAAJ,EAAA,EAAA,MAAAG,KAAAH,EAAA,EAAA,MAAAK,KAAAL,UAAA1E,KAAA0E,EAAA,EAAA,MAAAE,KAGC6C,sBAACjD,IAAA,EACSxE,QAAAA,GACM4E,cAAAA,GACJC,UAAAA,GACJC,MAAAA,GACMC,YAAAA,GACDC,WAAAA,GAAS,GACpBN,QAAAM,GAAAN,QAAAI,GAAAJ,QAAAG,GAAAH,QAAAK,GAAAL,QAAA1E,GAAA0E,QAAAE,GAAAF,QAAA+C,KAAAA,IAAA/C,EAAA,EAAA,GAPF+C;AAOE;"}

package/dist/types/widgets-v2/actions/lock-selection/lock-selection.d.ts

@@ -2,28 +2,38 @@ import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
 import { LockSelectionLabels } from './labels';
 export type LockSelectionKey = string | number;
-export interface LockSelectionProps {
+export interface LockSelectionProps<K extends LockSelectionKey = LockSelectionKey> {
     /**
      * Currently-selected items (destination-owned). On lock, this set is
      * snapshotted into `lockedItems` via `onLockChange`.
      */
-    selection: readonly LockSelectionKey[];
+    selection: readonly K[];
     /**
      * Currently-locked items (destination-owned). When non-empty, the widget's
      * data is filtered to these items via the registered transform.
      */
-    lockedItems: readonly LockSelectionKey[];
+    lockedItems: readonly K[];
     /**
      * Fires when the user toggles the lock. The destination is responsible for
      * persisting the new locked set (and re-feeding it via `lockedItems`).
      */
-    onLockChange: (next: readonly LockSelectionKey[]) => void;
+    onLockChange: (next: readonly K[]) => void;
     labels?: Partial<LockSelectionLabels>;
     /** Lock icon (default: `LockIcon`). */
     lockIcon?: ComponentType<SvgIconProps>;
     /** Unlock icon (default: `LockOpenIcon`). */
     unlockIcon?: ComponentType<SvgIconProps>;
     iconProps?: SvgIconProps;
+    /**
+     * Data transform applied while locked. Defaults to {@link filterByLockedItems}
+     * (keeps only `{name, ...}` items whose `name` is in `lockedItems`, across a
+     * `X[][]` series shape — matches Bar/Pie/Category/Timeseries data). Widgets
+     * whose data shape or selection identity differs (bin index, composite
+     * point key, flat rows) pass their own — e.g. Histogram's
+     * `filterHistogramByLockedBins`, Scatterplot's
+     * `filterScatterplotByLockedPoints`, Table's `filterTableByLockedRows`.
+     */
+    filterFn?: (data: unknown, lockedItems: readonly K[]) => unknown;
 }
 /**
  * Action that pins the current selection so the widget's data filters down
@@ -33,4 +43,4 @@ export interface LockSelectionProps {
  *
  * The trigger is disabled when there is nothing to lock and nothing locked.
  */
-export declare function LockSelection({ selection, lockedItems, onLockChange, labels, lockIcon: LockSvg, unlockIcon: UnlockSvg, iconProps, }: LockSelectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function LockSelection<K extends LockSelectionKey = LockSelectionKey>({ selection, lockedItems, onLockChange, labels, lockIcon: LockSvg, unlockIcon: UnlockSvg, iconProps, filterFn, }: LockSelectionProps<K>): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets-v2/category/components/category-legend.d.ts

@@ -10,9 +10,25 @@ export interface CategoryLegendProps {
      * same source).
      */
     colorAt: (index: number) => string | undefined;
+    /**
+     * Series indices currently hidden from the chart. Renders dimmed.
+     * Optional — defaults to none hidden. Added after this component's first
+     * release; kept optional (not required) so it stays a non-breaking
+     * addition for any direct consumer of `CategoryLegend` (a public
+     * subpath export) that predates the hide feature.
+     */
+    hiddenSeries?: ReadonlySet<number>;
+    /**
+     * Fires with the series index when its legend item is clicked. Optional
+     * — omitting it renders a legend with no hide affordance (same
+     * reasoning as `hiddenSeries`).
+     */
+    onToggle?: (index: number) => void;
 }
 /**
  * Sticky color legend rendered below a multi-series Category list.
- * Per-series `color` overrides the matching `colorAt(i)` result.
+ * Per-series `color` overrides the matching `colorAt(i)` result. Clicking an
+ * item toggles that series' visibility in the rows above (mirrors ECharts'
+ * native legend click-to-hide).
  */
-export declare function CategoryLegend({ series, colorAt }: CategoryLegendProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CategoryLegend({ series, colorAt, hiddenSeries, onToggle, }: CategoryLegendProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets-v2/category/components/category-row-stacked.d.ts

@@ -8,7 +8,12 @@ export interface CategoryRowStackedProps {
     values: readonly number[];
     /** One color per series (palette + per-series overrides resolved upstream). */
     colors: readonly string[];
-    /** Series names for the breakdown row. Missing entries fall back to `Series N`. */
+    /**
+     * Series names for the breakdown row, one per visible series, already
+     * resolved by the caller (unnamed series fall back to `Series N` using
+     * their ORIGINAL series index — this component has no notion of which
+     * series were hidden, so it must not recompute a positional fallback).
+     */
     seriesNames: readonly string[];
     formatter: (n: number) => string;
     selected: boolean;

package/dist/types/widgets-v2/category/style.d.ts

@@ -140,6 +140,14 @@ export declare const styles: {
         display: string;
         alignItems: string;
         gap: number;
+        cursor: string;
+    };
+    legendItemHidden: {
+        display: string;
+        alignItems: string;
+        gap: number;
+        cursor: string;
+        opacity: number;
     };
     legendDot: {
         width: number;

package/dist/types/widgets-v2/echart/use-chart-selection.d.ts

@@ -2,7 +2,13 @@ import { CallbackDataParams } from 'echarts/types/dist/shared';
 import { EchartsEventHandler } from './echart-ui';
 export type SelectionKey = string | number;
 export interface UseChartSelectionOptions<K extends SelectionKey> {
-    /** Controlled selection. `undefined` is treated the same as `[]`. */
+    /**
+     * Controlled selection. `undefined`/`null`/an explicit `[]` all mean "no
+     * selection interaction" — every current merger already treats an empty
+     * selection as "nothing excluded," so this hook collapses all three to
+     * `null` rather than promising per-merger `[]` semantics it doesn't
+     * implement.
+     */
     selection?: readonly K[];
     /** Receives the next selection. When omitted the wiring is a no-op. */
     onSelectionChange?: (next: readonly K[]) => void;
@@ -29,9 +35,9 @@ export interface ChartSelectionWiring<K extends SelectionKey> {
      */
     onEvents: Record<string, EchartsEventHandler>;
     /**
-     * The current selection — `null` when the consumer didn't pass one or it's
-     * empty. Mergers should treat `null` as "no dimming" and a non-null array
-     * as "render only these as fully opaque, dim the rest".
+     * The current selection — `null` for "no selection interaction"
+     * (`undefined`/`null`/an explicit `[]`), or a non-empty array meaning
+     * "render only these as fully opaque, dim the rest".
      */
     selection: readonly K[] | null;
 }

package/dist/types/widgets-v2/histogram/index.d.ts

@@ -1,5 +1,5 @@
 export { histogramOptions, createHistogramOptionFactory } from './options';
 export { HistogramSkeleton, type HistogramSkeletonProps } from './skeleton';
 export { createHistogramDownloadConfig } from './download';
-export { toRelativeHistogramData } from './transforms';
+export { toRelativeHistogramData, filterHistogramByLockedBins, } from './transforms';
 export type { HistogramWidgetData, HistogramOptionsInput, HistogramOptionFactoryInput, HistogramEChartsOption, } from './types';

package/dist/types/widgets-v2/histogram/transforms.d.ts

@@ -15,3 +15,14 @@
  * shape-check pattern as the default transform).
  */
 export declare const toRelativeHistogramData: (input: unknown) => unknown;
+/**
+ * `LockSelection` filter for Histogram. Data is `number[][]` — a flat list
+ * of bin counts per series, positionally paired with `ticks` (bin `i` covers
+ * `[ticks[i], ticks[i+1])`). Unlike name-keyed widgets, locked-out bins can't
+ * be REMOVED — that would shift every later bin's index and desync it from
+ * its `ticks` range. Zeroing them out instead preserves array length/position,
+ * so locked bins just render as empty (height 0) rather than disappearing.
+ *
+ * `lockedItems` holds bin indices (numbers, from Histogram's `selection`).
+ */
+export declare function filterHistogramByLockedBins(input: unknown, lockedItems: readonly (string | number)[]): unknown;

package/dist/types/widgets-v2/histogram/types.d.ts

@@ -41,6 +41,15 @@ export interface HistogramOptionFactoryInput {
      * (`itemStyle.opacity: 0.15`). `null`/empty means no selection.
      */
     selection?: readonly number[] | null;
+    /**
+     * Locked bin indices (from `LockSelection`). The x-axis crops its visible
+     * window to `[min(lockedItems), max(lockedItems)]` so the chart actually
+     * zooms into the locked range instead of showing every bin label with
+     * zeroed-out bars outside it. `null`/empty means no crop. Histogram's
+     * selection is always a contiguous run (`use-widget-filters`'s BETWEEN
+     * envelope round-trip fills any gaps), so min/max fully describes it.
+     */
+    lockedItems?: readonly number[] | null;
     /**
      * Consumer-supplied partial option merged into the structural option at
      * structural-build time. Lets stories override pieces of the theme-aware

package/dist/types/widgets-v2/scatterplot/index.d.ts

@@ -1,5 +1,5 @@
 export { scatterplotOptions, createScatterplotOptionFactory } from './options';
 export { ScatterplotSkeleton, type ScatterplotSkeletonProps } from './skeleton';
 export { createScatterplotDownloadConfig } from './download';
-export { toRelativeScatterplotData } from './transforms';
+export { toRelativeScatterplotData, filterScatterplotByLockedPoints, } from './transforms';
 export type { ScatterplotDatum, ScatterplotWidgetData, ScatterplotOptionsInput, ScatterplotOptionFactoryInput, ScatterplotEChartsOption, } from './types';

package/dist/types/widgets-v2/scatterplot/transforms.d.ts

@@ -15,3 +15,12 @@
  * untouched.
  */
 export declare const toRelativeScatterplotData: (input: unknown) => unknown;
+/**
+ * `LockSelection` filter for Scatterplot. Data is `[number, number][][]` —
+ * points have no `name`, so selection (and locking) is keyed on a synthetic
+ * `${seriesIndex}:${dataIndex}` string (same format `useChartSelection`'s
+ * `keyFromClick`/`keysFromBrush` produce for this widget). Unlike Histogram,
+ * a point's position carries no external meaning (no `ticks` to desync from),
+ * so non-locked points are removed outright rather than zeroed.
+ */
+export declare function filterScatterplotByLockedPoints(input: unknown, lockedItems: readonly (string | number)[]): unknown;

package/dist/types/widgets-v2/table/index.d.ts

@@ -2,6 +2,7 @@ export { Table, type TableProps } from './table';
 export { TableUI, type TableUIProps } from './table-ui';
 export { TableSkeleton, type TableSkeletonProps } from './skeleton';
 export { createTableDownloadConfig } from './download';
+export { filterTableByLockedRows } from './transforms';
 export { compareValues, sortRows, paginateRows, resolveColumns, deriveVisibleRows, tableDataToCsv, } from './helpers';
 export { DEFAULT_TABLE_LABELS, type TableLabels } from './labels';
 export { DEFAULT_TABLE_PAGE_SIZE, DEFAULT_TABLE_PAGE_SIZE_OPTIONS, type TableColumn, type TableRow, type TableWidgetData, type TableWidgetState, type TableSortDirection, type TableSortState, } from './types';

package/dist/types/widgets-v2/table/transforms.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `LockSelection` filter for Table. Data is a FLAT `TableRow[]` (unlike every
+ * other widget's `X[][]` series shape) and row identity comes from
+ * `row[keyColumn]` (default `'id'`), not `name` — so `filterByLockedItems`
+ * doesn't apply here (its outer `.map` treats each row as a "series", and a
+ * plain row object isn't an array, so it would silently pass everything
+ * through unfiltered). Falls back to the row's index when the identity
+ * column is nullish, mirroring `TableUI`'s own `resolveRowId`.
+ *
+ * `keyColumn` isn't part of `LockSelection`'s generic `filterFn` signature —
+ * close over it: `filterFn={(data, locked) => filterTableByLockedRows(data, locked, keyColumn)}`.
+ */
+export declare function filterTableByLockedRows(input: unknown, lockedItems: readonly (string | number)[], keyColumn?: string): unknown;

package/dist/types/widgets-v2/table/transforms.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/widgets-v2/timeseries/index.d.ts

@@ -1,4 +1,5 @@
 export { timeseriesOptions, createTimeseriesOptionFactory } from './options';
 export { TimeseriesSkeleton } from './skeleton';
 export { createTimeseriesDownloadConfig } from './download';
+export { filterTimeseriesByLockedItems } from './transforms';
 export type { TimeseriesDatum, TimeseriesWidgetData, TimeseriesOptionsInput, TimeseriesOptionFactoryInput, TimeseriesEChartsOption, } from './types';

package/dist/types/widgets-v2/timeseries/transforms.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `LockSelection` filter for Timeseries. Data is `{name, value}[][]` like
+ * Bar/Pie/Category, but `name` may arrive as `Date | number | string` (the
+ * time axis stores a `Date`). `lockedItems` is snapshotted from `selection`,
+ * whose keys are already normalized to `Date → ms` (see `options.ts`'s
+ * `normalizeName`) — so a raw `Date` name must be normalized the same way
+ * before the membership check, or every point would compare a `Date` object
+ * against a `number` and silently fail to match, filtering everything out.
+ */
+export declare function filterTimeseriesByLockedItems(input: unknown, lockedItems: readonly (string | number)[]): unknown;

package/dist/types/widgets-v2/timeseries/transforms.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/widgets-v2/actions.js

@@ -1,4 +1,4 @@
-import { B as L, C as o, D as e, a as A, b as E, c as r, d as t, e as S, f as _, g as T, h as l, i as D, j as d, F as n, L as c, R as O, S as g, k as B, l as C, m, n as F, Z as U, o as i, p as I, q as h, r as w, s as G, t as f, u as N, v as R } from "../change-column-CiVAjOUB.js";
+import { B as L, C as o, D as e, a as A, b as E, c as r, d as t, e as S, f as _, g as T, h as l, i as D, j as d, F as n, L as c, R as O, S as g, k as B, l as C, m, n as F, Z as U, o as i, p as I, q as h, r as w, s as G, t as f, u as N, v as R } from "../change-column-Bhcxmp-r.js";
 import { Z as u, a as x, c as M } from "../transforms-Cdx4fkU5.js";
 import { d as b, a as p, t as v, b as H } from "../exports-Cx-f6m6U.js";
 import { C as W, D as V, M as y, P as K, b as j } from "../png-item-9dNbB37T.js";

package/dist/widgets-v2/category.js

@@ -1,4 +1,4 @@
-import { C as N, a as P, b as $, c as z, d as G, e as L, f as M } from "../category-CGS_eHr4.js";
+import { C as N, a as P, b as $, c as z, d as G, e as L, f as M } from "../category-Ct2BzADB.js";
 import { jsx as m, jsxs as g } from "react/jsx-runtime";
 import { c as d } from "react/compiler-runtime";
 import { Box as c, Skeleton as p } from "@mui/material";

package/dist/widgets-v2/echart.js

@@ -1,4 +1,4 @@
-import { D as T, E as z, a as D, _ as U, o as w } from "../echart-Bdvbfx9s.js";
+import { D as T, E as z, a as D, _ as U, o as w } from "../echart-B10dhEaM.js";
 import { c as C } from "react/compiler-runtime";
 import { useRef as R } from "react";
 function F(x) {

package/dist/widgets-v2/echart.js.map

@@ -1 +1 @@
-{"version":3,"file":"echart.js","sources":["../../src/widgets-v2/echart/use-chart-selection.ts"],"sourcesContent":["import { useCallback, useMemo, useRef } from 'react'\nimport type { CallbackDataParams } from 'echarts/types/dist/shared'\nimport type { EchartsEventHandler } from './echart-ui'\n\nexport type SelectionKey = string | number\n\nexport interface UseChartSelectionOptions<K extends SelectionKey> {\n  /** Controlled selection. `undefined` is treated the same as `[]`. */\n  selection?: readonly K[]\n  /** Receives the next selection. When omitted the wiring is a no-op. */\n  onSelectionChange?: (next: readonly K[]) => void\n  /**\n   * Pull a selection key out of an ECharts `click` event. Return `null` to\n   * skip (e.g. a click on empty plot area). For Bar/Pie/Timeseries this is\n   * usually `(p) => p.name`; for Histogram/Scatterplot it's the dataIndex.\n   */\n  keyFromClick: (params: CallbackDataParams) => K | null\n  /**\n   * Map a `brushSelected` payload's `selected[*]` entries (each carrying a\n   * `seriesIndex` + `dataIndex[]`) into the full set of selection keys for\n   * the brushed area. Called once per brush event.\n   */\n  keysFromBrush: (\n    selected: readonly { seriesIndex: number; dataIndex: number[] }[],\n  ) => K[]\n}\n\nexport interface ChartSelectionWiring<K extends SelectionKey> {\n  /**\n   * Pass straight to `<Widget.Echart onEvents={…}>`. Wires `click` and\n   * `brushSelected` so the user's interactions reach `onSelectionChange`.\n   */\n  onEvents: Record<string, EchartsEventHandler>\n  /**\n   * The current selection — `null` when the consumer didn't pass one or it's\n   * empty. Mergers should treat `null` as \"no dimming\" and a non-null array\n   * as \"render only these as fully opaque, dim the rest\".\n   */\n  selection: readonly K[] | null\n}\n\n/**\n * Translate ECharts' click + brush events into a consumer-owned selection\n * with the expected dashboard semantics:\n *\n *   - **Click toggles** — clicking an item adds it to the selection if\n *     absent, removes it if present.\n *   - **Brush replaces** — finishing a brush stroke overwrites the selection\n *     with whatever the brush covered (drag-to-empty clears).\n *\n * Wire the returned `onEvents` into `<Widget.Echart>` and feed\n * `wiring.selection` to the widget's option factory so the merger can dim\n * non-selected rows at fusion time.\n */\nexport function useChartSelection<K extends SelectionKey>({\n  selection,\n  onSelectionChange,\n  keyFromClick,\n  keysFromBrush,\n}: UseChartSelectionOptions<K>): ChartSelectionWiring<K> {\n  const handleClick = useCallback(\n    (event: unknown) => {\n      if (!onSelectionChange) return\n      const params = event as CallbackDataParams\n      const key = keyFromClick(params)\n      if (key == null) return\n      const current = selection ?? []\n      const idx = current.indexOf(key)\n      const next =\n        idx === -1\n          ? [...current, key]\n          : [...current.slice(0, idx), ...current.slice(idx + 1)]\n      onSelectionChange(next)\n    },\n    [selection, onSelectionChange, keyFromClick],\n  )\n\n  // ECharts fires `brushSelected` on every pointer-move while the user is\n  // drawing a brush, but we only want to push to `onSelectionChange` once\n  // the gesture ends. Cache the latest `brushSelected` payload here, then\n  // commit on `brushEnd`.\n  const latestBrushedRef = useRef<\n    readonly { seriesIndex: number; dataIndex: number[] }[]\n  >([])\n\n  const handleBrushSelected = useCallback((event: unknown) => {\n    const params = event as {\n      batch?: {\n        selected?: { seriesIndex: number; dataIndex: number[] }[]\n      }[]\n    }\n    latestBrushedRef.current = params.batch?.[0]?.selected ?? []\n  }, [])\n\n  const handleBrushEnd = useCallback(() => {\n    if (!onSelectionChange) return\n    onSelectionChange(keysFromBrush(latestBrushedRef.current))\n  }, [onSelectionChange, keysFromBrush])\n\n  const onEvents = useMemo<Record<string, EchartsEventHandler>>(\n    () => ({\n      click: handleClick,\n      brushSelected: handleBrushSelected,\n      brushEnd: handleBrushEnd,\n    }),\n    [handleClick, handleBrushSelected, handleBrushEnd],\n  )\n\n  const wiringSelection = useMemo(\n    () => (selection && selection.length > 0 ? selection : null),\n    [selection],\n  )\n\n  return { onEvents, selection: wiringSelection }\n}\n"],"names":["useChartSelection","t0","$","_c","selection","onSelectionChange","keyFromClick","keysFromBrush","t1","event","key","current","idx","indexOf","next","slice","handleClick","t2","Symbol","for","latestBrushedRef","useRef","t3","event_0","params_0","params","batch","selected","handleBrushSelected","t4","handleBrushEnd","t5","click","brushSelected","brushEnd","onEvents","wiringSelection","length","t6"],"mappings":";;;AAsDO,SAAAA,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAmD;AAAA,IAAAC,WAAAA;AAAAA,IAAAC,mBAAAA;AAAAA,IAAAC,cAAAA;AAAAA,IAAAC,eAAAA;AAAAA,EAAAA,IAAAN;AAK5B,MAAAO;AAAA,EAAAN,EAAA,CAAA,MAAAI,KAAAJ,SAAAG,KAAAH,EAAA,CAAA,MAAAE,KAE1BI,IAAAC,CAAAA,MAAA;AACE,QAAI,CAACJ;AAAiB;AAEtB,UAAAK,IAAYJ,EADGG,CACgB;AAC/B,QAAIC,KAAO;AAAI;AACf,UAAAC,IAAgBP,KAAA,CAAA,GAChBQ,IAAYD,EAAOE,QAASH,CAAG,GAC/BI,IACEF,MAAQ,KAAR,CAAA,GACQD,GAASD,CAAG,IADpB,IAEQC,EAAOI,MAAO,GAAGH,CAAG,GAAC,GAAKD,EAAOI,MAAOH,IAAM,CAAC,CAAC;AAC1DP,IAAAA,EAAkBS,CAAI;AAAA,EAAC,GACxBZ,OAAAI,GAAAJ,OAAAG,GAAAH,OAAAE,GAAAF,OAAAM,KAAAA,IAAAN,EAAA,CAAA;AAbH,QAAAc,IAAoBR;AAenB,MAAAS;AAAA,EAAAf,EAAA,CAAA,MAAAgB,uBAAAC,IAAA,2BAAA,KAQCF,IAAA,CAAA,GAAEf,OAAAe,KAAAA,IAAAf,EAAA,CAAA;AAFJ,QAAAkB,IAAyBC,EAEvBJ,CAAE;AAAC,MAAAK;AAAA,EAAApB,EAAA,CAAA,MAAAgB,uBAAAC,IAAA,2BAAA,KAEmCG,IAAAC,CAAAA,MAAA;AACtC,UAAAC,IAAef;AAKfW,IAAAA,EAAgBT,UAAWc,EAAMC,QAAW,CAAA,GAAUC,YAA3B,CAAA;AAAA,EAAH,GACzBzB,OAAAoB,KAAAA,IAAApB,EAAA,CAAA;AAPD,QAAA0B,IAA4BN;AAOtB,MAAAO;AAAA,EAAA3B,EAAA,CAAA,MAAAK,KAAAL,SAAAG,KAE6BwB,IAAAA,MAAA;AACjC,IAAKxB,KACLA,EAAkBE,EAAca,EAAgBT,OAAQ,CAAC;AAAA,EAAC,GAC3DT,OAAAK,GAAAL,OAAAG,GAAAH,OAAA2B,KAAAA,IAAA3B,EAAA,CAAA;AAHD,QAAA4B,IAAuBD;AAGe,MAAAE;AAAA,EAAA7B,EAAA,CAAA,MAAA4B,KAAA5B,UAAAc,KAG7Be,IAAA;AAAA,IAAAC,OACEhB;AAAAA,IAAWiB,eACHL;AAAAA,IAAmBM,UACxBJ;AAAAA,EAAAA,GACX5B,OAAA4B,GAAA5B,QAAAc,GAAAd,QAAA6B,KAAAA,IAAA7B,EAAA,EAAA;AALH,QAAAiC,IACSJ,GAQTK,IACShC,KAAaA,EAASiC,SAAU,IAAhCjC,IAAA;AAER,MAAAkC;AAAA,SAAApC,EAAA,EAAA,MAAAiC,KAAAjC,UAAAkC,KAEME,IAAA;AAAA,IAAAH,UAAAA;AAAAA,IAAA/B,WAAuBgC;AAAAA,EAAAA,GAAiBlC,QAAAiC,GAAAjC,QAAAkC,GAAAlC,QAAAoC,KAAAA,IAAApC,EAAA,EAAA,GAAxCoC;AAAwC;"}
+{"version":3,"file":"echart.js","sources":["../../src/widgets-v2/echart/use-chart-selection.ts"],"sourcesContent":["import { useCallback, useMemo, useRef } from 'react'\nimport type { CallbackDataParams } from 'echarts/types/dist/shared'\nimport type { EchartsEventHandler } from './echart-ui'\n\nexport type SelectionKey = string | number\n\nexport interface UseChartSelectionOptions<K extends SelectionKey> {\n  /**\n   * Controlled selection. `undefined`/`null`/an explicit `[]` all mean \"no\n   * selection interaction\" — every current merger already treats an empty\n   * selection as \"nothing excluded,\" so this hook collapses all three to\n   * `null` rather than promising per-merger `[]` semantics it doesn't\n   * implement.\n   */\n  selection?: readonly K[]\n  /** Receives the next selection. When omitted the wiring is a no-op. */\n  onSelectionChange?: (next: readonly K[]) => void\n  /**\n   * Pull a selection key out of an ECharts `click` event. Return `null` to\n   * skip (e.g. a click on empty plot area). For Bar/Pie/Timeseries this is\n   * usually `(p) => p.name`; for Histogram/Scatterplot it's the dataIndex.\n   */\n  keyFromClick: (params: CallbackDataParams) => K | null\n  /**\n   * Map a `brushSelected` payload's `selected[*]` entries (each carrying a\n   * `seriesIndex` + `dataIndex[]`) into the full set of selection keys for\n   * the brushed area. Called once per brush event.\n   */\n  keysFromBrush: (\n    selected: readonly { seriesIndex: number; dataIndex: number[] }[],\n  ) => K[]\n}\n\nexport interface ChartSelectionWiring<K extends SelectionKey> {\n  /**\n   * Pass straight to `<Widget.Echart onEvents={…}>`. Wires `click` and\n   * `brushSelected` so the user's interactions reach `onSelectionChange`.\n   */\n  onEvents: Record<string, EchartsEventHandler>\n  /**\n   * The current selection — `null` for \"no selection interaction\"\n   * (`undefined`/`null`/an explicit `[]`), or a non-empty array meaning\n   * \"render only these as fully opaque, dim the rest\".\n   */\n  selection: readonly K[] | null\n}\n\n/**\n * Translate ECharts' click + brush events into a consumer-owned selection\n * with the expected dashboard semantics:\n *\n *   - **Click toggles** — clicking an item adds it to the selection if\n *     absent, removes it if present.\n *   - **Brush replaces** — finishing a brush stroke overwrites the selection\n *     with whatever the brush covered (drag-to-empty clears).\n *\n * Wire the returned `onEvents` into `<Widget.Echart>` and feed\n * `wiring.selection` to the widget's option factory so the merger can dim\n * non-selected rows at fusion time.\n */\nexport function useChartSelection<K extends SelectionKey>({\n  selection,\n  onSelectionChange,\n  keyFromClick,\n  keysFromBrush,\n}: UseChartSelectionOptions<K>): ChartSelectionWiring<K> {\n  const handleClick = useCallback(\n    (event: unknown) => {\n      if (!onSelectionChange) return\n      const params = event as CallbackDataParams\n      const key = keyFromClick(params)\n      if (key == null) return\n      const current = selection ?? []\n      const idx = current.indexOf(key)\n      const next =\n        idx === -1\n          ? [...current, key]\n          : [...current.slice(0, idx), ...current.slice(idx + 1)]\n      onSelectionChange(next)\n    },\n    [selection, onSelectionChange, keyFromClick],\n  )\n\n  // ECharts fires `brushSelected` on every pointer-move while the user is\n  // drawing a brush, but we only want to push to `onSelectionChange` once\n  // the gesture ends. Cache the latest `brushSelected` payload here, then\n  // commit on `brushEnd`.\n  const latestBrushedRef = useRef<\n    readonly { seriesIndex: number; dataIndex: number[] }[]\n  >([])\n\n  const handleBrushSelected = useCallback((event: unknown) => {\n    const params = event as {\n      batch?: {\n        selected?: { seriesIndex: number; dataIndex: number[] }[]\n      }[]\n    }\n    latestBrushedRef.current = params.batch?.[0]?.selected ?? []\n  }, [])\n\n  const handleBrushEnd = useCallback(() => {\n    if (!onSelectionChange) return\n    onSelectionChange(keysFromBrush(latestBrushedRef.current))\n  }, [onSelectionChange, keysFromBrush])\n\n  const onEvents = useMemo<Record<string, EchartsEventHandler>>(\n    () => ({\n      click: handleClick,\n      brushSelected: handleBrushSelected,\n      brushEnd: handleBrushEnd,\n    }),\n    [handleClick, handleBrushSelected, handleBrushEnd],\n  )\n\n  const wiringSelection = useMemo(\n    () => (selection && selection.length > 0 ? selection : null),\n    [selection],\n  )\n\n  return { onEvents, selection: wiringSelection }\n}\n"],"names":["useChartSelection","t0","$","_c","selection","onSelectionChange","keyFromClick","keysFromBrush","t1","event","key","current","idx","indexOf","next","slice","handleClick","t2","Symbol","for","latestBrushedRef","useRef","t3","event_0","params_0","params","batch","selected","handleBrushSelected","t4","handleBrushEnd","t5","click","brushSelected","brushEnd","onEvents","wiringSelection","length","t6"],"mappings":";;;AA4DO,SAAAA,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAmD;AAAA,IAAAC,WAAAA;AAAAA,IAAAC,mBAAAA;AAAAA,IAAAC,cAAAA;AAAAA,IAAAC,eAAAA;AAAAA,EAAAA,IAAAN;AAK5B,MAAAO;AAAA,EAAAN,EAAA,CAAA,MAAAI,KAAAJ,SAAAG,KAAAH,EAAA,CAAA,MAAAE,KAE1BI,IAAAC,CAAAA,MAAA;AACE,QAAI,CAACJ;AAAiB;AAEtB,UAAAK,IAAYJ,EADGG,CACgB;AAC/B,QAAIC,KAAO;AAAI;AACf,UAAAC,IAAgBP,KAAA,CAAA,GAChBQ,IAAYD,EAAOE,QAASH,CAAG,GAC/BI,IACEF,MAAQ,KAAR,CAAA,GACQD,GAASD,CAAG,IADpB,IAEQC,EAAOI,MAAO,GAAGH,CAAG,GAAC,GAAKD,EAAOI,MAAOH,IAAM,CAAC,CAAC;AAC1DP,IAAAA,EAAkBS,CAAI;AAAA,EAAC,GACxBZ,OAAAI,GAAAJ,OAAAG,GAAAH,OAAAE,GAAAF,OAAAM,KAAAA,IAAAN,EAAA,CAAA;AAbH,QAAAc,IAAoBR;AAenB,MAAAS;AAAA,EAAAf,EAAA,CAAA,MAAAgB,uBAAAC,IAAA,2BAAA,KAQCF,IAAA,CAAA,GAAEf,OAAAe,KAAAA,IAAAf,EAAA,CAAA;AAFJ,QAAAkB,IAAyBC,EAEvBJ,CAAE;AAAC,MAAAK;AAAA,EAAApB,EAAA,CAAA,MAAAgB,uBAAAC,IAAA,2BAAA,KAEmCG,IAAAC,CAAAA,MAAA;AACtC,UAAAC,IAAef;AAKfW,IAAAA,EAAgBT,UAAWc,EAAMC,QAAW,CAAA,GAAUC,YAA3B,CAAA;AAAA,EAAH,GACzBzB,OAAAoB,KAAAA,IAAApB,EAAA,CAAA;AAPD,QAAA0B,IAA4BN;AAOtB,MAAAO;AAAA,EAAA3B,EAAA,CAAA,MAAAK,KAAAL,SAAAG,KAE6BwB,IAAAA,MAAA;AACjC,IAAKxB,KACLA,EAAkBE,EAAca,EAAgBT,OAAQ,CAAC;AAAA,EAAC,GAC3DT,OAAAK,GAAAL,OAAAG,GAAAH,OAAA2B,KAAAA,IAAA3B,EAAA,CAAA;AAHD,QAAA4B,IAAuBD;AAGe,MAAAE;AAAA,EAAA7B,EAAA,CAAA,MAAA4B,KAAA5B,UAAAc,KAG7Be,IAAA;AAAA,IAAAC,OACEhB;AAAAA,IAAWiB,eACHL;AAAAA,IAAmBM,UACxBJ;AAAAA,EAAAA,GACX5B,OAAA4B,GAAA5B,QAAAc,GAAAd,QAAA6B,KAAAA,IAAA7B,EAAA,EAAA;AALH,QAAAiC,IACSJ,GAQTK,IACShC,KAAaA,EAASiC,SAAU,IAAhCjC,IAAA;AAER,MAAAkC;AAAA,SAAApC,EAAA,EAAA,MAAAiC,KAAAjC,UAAAkC,KAEME,IAAA;AAAA,IAAAH,UAAAA;AAAAA,IAAA/B,WAAuBgC;AAAAA,EAAAA,GAAiBlC,QAAAiC,GAAAjC,QAAAkC,GAAAlC,QAAAoC,KAAAA,IAAApC,EAAA,EAAA,GAAxCoC;AAAwC;"}