@carto/ps-react-ui 4.17.2 → 4.18.0

package/dist/types/legend/components/legend-actions/legend-actions.d.ts

@@ -7,8 +7,8 @@ export interface LegendActionsProps {
  * parity): the wrapper partitions its children by component identity and
  * renders this slot inside the header, wrapped in the hover-fade group
  * (`PsLegend-rowFade` in rows, `PsLegend-groupFade` in group headers —
- * resolved from the nearest context). Compose the ⋮ menu last so it sits
- * rightmost, per design.
+ * resolved from the nearest context). Compose the visibility toggle last so
+ * it sits rightmost, per design.
  *
  * @experimental This API is new and may change in a future release.
  */

package/dist/types/legend/components/legend-group/styles.d.ts

@@ -13,6 +13,22 @@ export declare const styles: {
             borderTop: string;
             borderColor: "divider";
         };
+    };
+    groupDragging: {
+        opacity: number;
+    };
+    header: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        padding: ({ spacing }: Theme) => string;
+        minHeight: number;
+        borderBottom: string;
+        borderColor: "divider";
+        position: "sticky";
+        top: number;
+        zIndex: number;
+        backgroundColor: "background.default";
         '& .PsLegend-groupFade > *': {
             opacity: number;
             transition: ({ transitions }: Theme) => string;
@@ -23,10 +39,14 @@ export declare const styles: {
                 opacity: number;
             };
         };
-        '&:hover .PsLegend-groupFade > *, &:focus-within .PsLegend-groupFade > *': {
-            opacity: number;
-        };
         '@media (hover: hover)': {
+            '& .PsLegend-groupFade > *:not(.active)': {
+                width: number;
+                minWidth: number;
+                padding: number;
+                overflow: "hidden";
+                pointerEvents: "none";
+            };
             '& .PsLegend-groupActions:not(:has(.active))': {
                 width: number;
                 minWidth: number;
@@ -35,6 +55,14 @@ export declare const styles: {
                 pointerEvents: "none";
             };
         };
+        '&:hover .PsLegend-groupFade > *, &:focus-within .PsLegend-groupFade > *': {
+            opacity: number;
+            width: string;
+            minWidth: number;
+            padding: string;
+            overflow: "visible";
+            pointerEvents: "auto";
+        };
         '&:hover .PsLegend-groupActions, &:focus-within .PsLegend-groupActions': {
             width: string;
             minWidth: number;
@@ -53,22 +81,6 @@ export declare const styles: {
             opacity: number;
         };
     };
-    groupDragging: {
-        opacity: number;
-    };
-    header: {
-        display: "flex";
-        alignItems: "center";
-        gap: number;
-        padding: ({ spacing }: Theme) => string;
-        minHeight: number;
-        borderBottom: string;
-        borderColor: "divider";
-        position: "sticky";
-        top: number;
-        zIndex: number;
-        backgroundColor: "background.default";
-    };
     titleArea: {
         flex: number;
         minWidth: number;
@@ -88,7 +100,6 @@ export declare const styles: {
         color: "text.secondary";
     };
     label: {
-        flex: number;
         minWidth: number;
         overflow: "hidden";
         textOverflow: "ellipsis";

package/dist/types/legend/components/legend-row/styles.d.ts

@@ -18,10 +18,14 @@ export declare const styles: {
                 opacity: number;
             };
         };
-        '&:hover .PsLegend-rowFade > *, &:focus-within .PsLegend-rowFade > *': {
-            opacity: number;
-        };
         '@media (hover: hover)': {
+            '& .PsLegend-rowFade > *:not(.active)': {
+                width: number;
+                minWidth: number;
+                padding: number;
+                overflow: "hidden";
+                pointerEvents: "none";
+            };
             '& .PsLegend-rowActions:not(:has(.active))': {
                 width: number;
                 minWidth: number;
@@ -30,6 +34,14 @@ export declare const styles: {
                 pointerEvents: "none";
             };
         };
+        '&:hover .PsLegend-rowFade > *, &:focus-within .PsLegend-rowFade > *': {
+            opacity: number;
+            width: string;
+            minWidth: number;
+            padding: string;
+            overflow: "visible";
+            pointerEvents: "auto";
+        };
         '&:hover .PsLegend-rowActions, &:focus-within .PsLegend-rowActions': {
             width: string;
             minWidth: number;
@@ -64,6 +76,9 @@ export declare const styles: {
         zIndex: number;
         backgroundColor: "background.paper";
     };
+    headerGrouped: {
+        paddingLeft: number;
+    };
     titleBox: {
         flex: number;
         minWidth: number;
@@ -86,7 +101,6 @@ export declare const styles: {
         gap: number;
     };
     title: {
-        flex: number;
         minWidth: number;
         overflow: "hidden";
         textOverflow: "ellipsis";
@@ -120,9 +134,15 @@ export declare const styles: {
         gap: number;
         padding: ({ spacing }: Theme) => string;
     };
+    contentGrouped: {
+        paddingLeft: number;
+    };
     footer: {
         padding: ({ spacing }: Theme) => string;
     };
+    footerGrouped: {
+        paddingLeft: number;
+    };
     dimmed: {
         opacity: number;
     };

package/dist/types/legend/components/legend-sortable/styles.d.ts

@@ -6,13 +6,14 @@ export declare const styles: {
         display: "flex";
         alignItems: "center";
         justifyContent: "center";
-        height: number;
+        left: number;
+        top: number;
     };
     handleSlotLayer: {
-        right: number;
+        height: number;
     };
     handleSlotGroup: {
-        right: number;
+        height: number;
     };
     handle: {
         padding: string;

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;"}