@carto/ps-react-ui 6.1.1 → 6.3.0

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

@@ -8,15 +8,38 @@ export declare const styles: {
         width: string;
     };
     list: {
+        position: string;
         display: string;
-        flexDirection: string;
+        gridTemplateColumns: string;
         gap: number;
         py: number;
     };
+    listMulti: {
+        gridTemplateColumns: string;
+    };
+    barWrap: {
+        position: string;
+    };
+    multiZeroArea: {
+        position: string;
+        inset: number;
+        gridColumn: string;
+        pointerEvents: string;
+    };
+    zeroTick: {
+        position: string;
+        top: number;
+        bottom: number;
+        width: string;
+        transform: string;
+        bgcolor: string;
+        pointerEvents: string;
+    };
     listScroll: {
         pr: number;
     };
     rowSingle: {
+        gridColumn: string;
         display: string;
         flexDirection: string;
         gap: number;
@@ -39,9 +62,11 @@ export declare const styles: {
         gap: number;
     };
     rowMulti: {
+        position: string;
+        gridColumn: string;
         display: string;
-        flexDirection: string;
-        gap: number;
+        gridTemplateColumns: string;
+        rowGap: number;
         cursor: string;
         userSelect: string;
         transition: string;
@@ -62,6 +87,7 @@ export declare const styles: {
         fontWeight: string;
     };
     multiName: {
+        gridColumn: string;
         overflow: string;
         whiteSpace: string;
         textOverflow: string;
@@ -73,19 +99,19 @@ export declare const styles: {
         fontVariantNumeric: string;
         minWidth: number;
         textAlign: string;
+        alignSelf: string;
     };
     bar: Record<CategorySize, SxProps<Theme>>;
     barFill: Record<CategorySize, SxProps<Theme>>;
     stackedSegment: Record<CategorySize, SxProps<Theme>>;
     multiBarRow: {
         display: string;
-        alignItems: string;
-        gap: number;
     };
     multiBarContainer: {
-        flex: number;
+        alignSelf: string;
     };
     rowStacked: {
+        gridColumn: string;
         display: string;
         flexDirection: string;
         gap: number;
@@ -160,6 +186,7 @@ export declare const styles: {
         fontWeight: string;
     };
     otherRow: {
+        gridColumn: string;
         display: string;
         alignItems: string;
         gap: number;

package/dist/types/widgets/histogram/bins.d.ts

@@ -0,0 +1,7 @@
+import { HistogramBin } from './types.js';
+/** Count of a {@link HistogramBin}, whichever form it takes. */
+export declare function getHistogramBinValue(bin: HistogramBin): number;
+/** Whether `v` is a valid {@link HistogramBin} with a finite count. */
+export declare function isHistogramBin(v: unknown): v is HistogramBin;
+/** Same bin with its count replaced; keeps the object form (and `color`). */
+export declare function withHistogramBinValue(bin: HistogramBin, value: number): HistogramBin;

package/dist/types/widgets/histogram/download.d.ts

@@ -1,12 +1,12 @@
 import { DownloadItem, WidgetDownloadArgs } from '../actions/download/index.js';
-import { HistogramWidgetData } from './types.js';
+import { HistogramBin, HistogramWidgetData } from './types.js';
 /**
  * Download menu items for histograms. Always includes a CSV item with
  * `bin_low, bin_high, series_1_count, series_2_count, …` columns (one row
  * per bin). When `getCaptureEl` is given, prepends a PNG item that
  * rasterises the captured element via `html2canvas`.
  */
-export declare function createHistogramDownloadConfig(args: WidgetDownloadArgs<HistogramWidgetData> & {
+export declare function createHistogramDownloadConfig(args: WidgetDownloadArgs<HistogramWidgetData<HistogramBin>> & {
     getTicks: () => readonly number[];
     seriesNames?: readonly string[];
 }): DownloadItem[];

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

@@ -2,4 +2,5 @@ export { histogramOptions, createHistogramOptionFactory } from './options.js';
 export { HistogramSkeleton, type HistogramSkeletonProps } from './skeleton.js';
 export { createHistogramDownloadConfig } from './download.js';
 export { toRelativeHistogramData, filterHistogramByLockedBins, } from './transforms.js';
-export type { HistogramWidgetData, HistogramOptionsInput, HistogramOptionFactoryInput, HistogramEChartsOption, } from './types.js';
+export { getHistogramBinValue } from './bins.js';
+export type { HistogramBin, HistogramBinObject, HistogramWidgetData, HistogramOptionsInput, HistogramOptionFactoryInput, HistogramEChartsOption, } from './types.js';

package/dist/types/widgets/histogram/options.d.ts

@@ -31,7 +31,7 @@ export declare function histogramOptions({ theme, formatter, }: HistogramOptions
  *     the consumer-supplied `optionsOverride`. Called once by Provider to
  *     seed `rawOptions` in the store.
  *   - **Merge phase** (`option != null`) — fuses post-pipeline `state.data`
- *     (`HistogramWidgetData` — `number[][]`) into the option via the
+ *     (`HistogramWidgetData` — `HistogramBin[][]`) into the option via the
  *     dataset API. Each series gets its own dataset of `[binLabel, count]`
  *     pairs derived from `ticks`; series reference their dataset by
  *     `datasetIndex` and are encoded by column position. Reactive

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

@@ -1,6 +1,7 @@
 /**
  * Histogram-specific `RelativeData` transform. Histogram data is
- * `number[][]` — each series is a flat list of bin counts. This
+ * `HistogramBin[][]` — each series is a flat list of bin counts (plain
+ * numbers or `{ value, color? }`, whose shape is kept). This
  * rewrites each count to its share of the series total (0–100), so
  * pairing with `createPercentFormatter` renders the y-axis as
  * percentages.
@@ -11,13 +12,13 @@
  * inputs produce sane signed shares-of-magnitude. A series whose total
  * magnitude is zero (all-zero or empty input) is returned unchanged so
  * a stalled or empty data set doesn't show misleading 0% values. Inputs
- * whose shape isn't `number[][]` fall through untouched (same defensive
+ * whose shape isn't `HistogramBin[][]` fall through untouched (same defensive
  * 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
+ * `LockSelection` filter for Histogram. Data is `HistogramBin[][]` — 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,

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

@@ -2,12 +2,29 @@ import { Theme } from '@mui/material';
 import { EChartsOption } from 'echarts';
 import { WidgetSeries } from '../types.js';
 /**
- * Histogram widget data — array of series, each a flat array of bin counts.
- * The option factory's merge phase (see {@link createHistogramOptionFactory})
- * combines this with `ticks` to produce a 2-column dataset (`[binLabel, count]`)
- * for ECharts.
+ * One histogram bin: either its count, or `{ value, color? }` to give the
+ * bar its own colour (CSS colour or theme palette path such as
+ * `'primary.main'`). A bin `color` wins over the template's
+ * `itemStyle.color` and the series colour; selection dimming still applies.
  */
-export type HistogramWidgetData = readonly (readonly number[])[];
+export type HistogramBin = number | HistogramBinObject;
+/** Object form of a {@link HistogramBin}. */
+export interface HistogramBinObject {
+    value: number;
+    color?: string;
+}
+/**
+ * Histogram widget data — array of series, each a flat array of bins. The
+ * option factory's merge phase (see {@link createHistogramOptionFactory})
+ * combines this with `ticks` to produce a 2-column dataset
+ * (`[binLabel, count]`) for ECharts.
+ *
+ * Defaults to plain counts (`number[][]`) so existing code that reads bins
+ * as numbers keeps type-checking; use `HistogramWidgetData<HistogramBin>`
+ * to also accept `{ value, color? }` bins. Every histogram API (option
+ * factory, transforms, download) accepts both forms.
+ */
+export type HistogramWidgetData<B extends HistogramBin = number> = readonly (readonly B[])[];
 /** Inputs to the structural-only {@link histogramOptions} builder. */
 export interface HistogramOptionsInput {
     theme: Theme;

package/dist/types/widgets/index.d.ts

@@ -101,7 +101,7 @@ export type { FormulaUIProps, FormulaDataItem, FormulaWidgetData, } from './form
 export type { MarkdownUIProps, MarkdownWidgetData } from './markdown/index.js';
 export type { PieDatum, PieWidgetData } from './pie/index.js';
 export type { TimeseriesDatum, TimeseriesWidgetData } from './timeseries/index.js';
-export type { ScatterplotDatum, ScatterplotWidgetData } from './scatterplot/index.js';
+export type { ScatterplotDatum, ScatterplotPoint, ScatterplotItem, ScatterplotWidgetData, } from './scatterplot/index.js';
 export type { SpreadUIProps, SpreadDataItem, SpreadWidgetData, SpreadVariant, } from './spread/index.js';
 export type { RangeProps, RangeUIProps, RangeDataItem, RangeWidgetData, RangeItemValue, } from './range/index.js';
 export type { CategoryProps, CategoryUIProps, CategoryDataItem, CategoryWidgetData, CategoryKey, CategorySeriesConfig, CategoryLabels, } from './category/index.js';

package/dist/types/widgets/pie/types.d.ts

@@ -5,6 +5,12 @@ import { WidgetSeries } from '../types.js';
 export interface PieDatum {
     name: string | number;
     value: number;
+    /**
+     * Optional colour for this item (CSS colour or theme palette path such as
+     * `'primary.main'`). Wins over the template's `itemStyle.color` and the
+     * series colour; selection dimming still applies on top.
+     */
+    color?: string;
 }
 /** Pie widget data — one slice array per series (rendered as side-by-side donuts). */
 export type PieWidgetData = readonly (readonly PieDatum[])[];

package/dist/types/widgets/scatterplot/download.d.ts

@@ -1,11 +1,11 @@
 import { DownloadItem, WidgetDownloadArgs } from '../actions/download/index.js';
-import { ScatterplotWidgetData } from './types.js';
+import { ScatterplotItem, ScatterplotWidgetData } from './types.js';
 /**
  * Download menu items for the Scatterplot widget. Always includes a CSV item
  * with `series, x, y` columns (one row per point). When `getCaptureEl` is
  * given, prepends a PNG item that rasterises the captured element via
  * `html2canvas`.
  */
-export declare function createScatterplotDownloadConfig(args: WidgetDownloadArgs<ScatterplotWidgetData> & {
+export declare function createScatterplotDownloadConfig(args: WidgetDownloadArgs<ScatterplotWidgetData<ScatterplotItem>> & {
     seriesNames?: readonly string[];
 }): DownloadItem[];

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

@@ -2,4 +2,5 @@ export { scatterplotOptions, createScatterplotOptionFactory } from './options.js
 export { ScatterplotSkeleton, type ScatterplotSkeletonProps } from './skeleton.js';
 export { createScatterplotDownloadConfig } from './download.js';
 export { toRelativeScatterplotData, filterScatterplotByLockedPoints, } from './transforms.js';
-export type { ScatterplotDatum, ScatterplotWidgetData, ScatterplotOptionsInput, ScatterplotOptionFactoryInput, ScatterplotEChartsOption, } from './types.js';
+export { getScatterplotXY } from './points.js';
+export type { ScatterplotDatum, ScatterplotPoint, ScatterplotItem, ScatterplotWidgetData, ScatterplotOptionsInput, ScatterplotOptionFactoryInput, ScatterplotEChartsOption, } from './types.js';

package/dist/types/widgets/scatterplot/points.d.ts

@@ -0,0 +1,7 @@
+import { ScatterplotItem } from './types.js';
+/** `[x, y]` of a {@link ScatterplotItem}, whichever form it takes. */
+export declare function getScatterplotXY(point: ScatterplotItem): readonly [number, number];
+/** Whether `v` is a valid {@link ScatterplotItem} with finite coordinates. */
+export declare function isScatterplotDatum(v: unknown): v is ScatterplotItem;
+/** Same point with new coordinates; keeps the object form (and `color`). */
+export declare function withScatterplotXY(point: ScatterplotItem, x: number, y: number): ScatterplotItem;

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

@@ -1,6 +1,7 @@
 /**
  * Scatterplot-specific `RelativeData` transform. Scatter data is
- * `[number, number][]` — each series is a list of `[x, y]` tuples.
+ * `ScatterplotItem[][]` — each series is a list of `[x, y]` tuples or
+ * `{ x, y, color? }` points (whose shape is kept).
  * Relative is a values-axis concept, so this rewrites `y` to its
  * share of the series's total `y` (0–100) and leaves `x` raw — x is
  * coordinate space, not part of the cohort total.
@@ -11,12 +12,12 @@
  * y values produce sane signed shares-of-magnitude. A series whose
  * total y-magnitude is zero (all-zero or empty input) is returned
  * unchanged so a stalled or empty data set doesn't show misleading 0%
- * values. Inputs whose shape isn't `[number, number][]` fall through
+ * values. Inputs whose shape isn't `ScatterplotItem[]` fall through
  * untouched.
  */
 export declare const toRelativeScatterplotData: (input: unknown) => unknown;
 /**
- * `LockSelection` filter for Scatterplot. Data is `[number, number][][]` —
+ * `LockSelection` filter for Scatterplot. Data is `ScatterplotItem[][]` —
  * 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,

package/dist/types/widgets/scatterplot/types.d.ts

@@ -3,8 +3,27 @@ import { EChartsOption } from 'echarts';
 import { WidgetSeries } from '../types.js';
 /** A single point — `[x, y]` tuple. */
 export type ScatterplotDatum = readonly [number, number];
-/** Scatterplot widget data — array of series, each a list of `[x, y]` tuples. */
-export type ScatterplotWidgetData = readonly (readonly ScatterplotDatum[])[];
+/**
+ * Object form of a point, to give it its own colour. `color` (CSS colour or
+ * theme palette path such as `'primary.main'`) wins over the template's
+ * `itemStyle.color` and the series colour; selection dimming still applies.
+ */
+export interface ScatterplotPoint {
+    x: number;
+    y: number;
+    color?: string;
+}
+/** Any accepted point: an `[x, y]` tuple or a {@link ScatterplotPoint}. */
+export type ScatterplotItem = ScatterplotDatum | ScatterplotPoint;
+/**
+ * Scatterplot widget data — array of series, each a list of points.
+ *
+ * Defaults to `[x, y]` tuples so existing code that destructures points
+ * keeps type-checking; use `ScatterplotWidgetData<ScatterplotItem>` to also
+ * accept `{ x, y, color? }` points. Every scatterplot API (option factory,
+ * transforms, download) accepts both forms.
+ */
+export type ScatterplotWidgetData<P extends ScatterplotItem = ScatterplotDatum> = readonly (readonly P[])[];
 /** Inputs to the structural-only {@link scatterplotOptions} builder. */
 export interface ScatterplotOptionsInput {
     theme: Theme;

package/dist/types/widgets/timeseries/types.d.ts

@@ -9,6 +9,12 @@ import { WidgetSeries } from '../types.js';
 export interface TimeseriesDatum {
     name: Date | number | string;
     value: number;
+    /**
+     * Optional colour for this item (CSS colour or theme palette path such as
+     * `'primary.main'`). Wins over the template's `itemStyle.color` and the
+     * series colour; selection dimming still applies on top.
+     */
+    color?: string;
 }
 /** Timeseries widget data — one array of points per series. */
 export type TimeseriesWidgetData = readonly (readonly TimeseriesDatum[])[];

package/dist/types/widgets/utils/item-color.d.ts

@@ -0,0 +1,26 @@
+import { Theme } from '@mui/material';
+import { CallbackDataParams } from 'echarts/types/dist/shared';
+/** ECharts `itemStyle.color` callback, as emitted by the chart widgets. */
+export type ItemColorCallback = (params: CallbackDataParams) => string;
+/**
+ * Builds the callback that resolves the **base** colour of every item of one
+ * series, before any selection dimming. Priority:
+ *
+ *   1. the datum's own `color` (`datums[params.dataIndex].color`);
+ *   2. the consumer's `template.itemStyle.color` (from `optionsOverride`):
+ *      a string is used as is, a function is called with the ECharts params;
+ *   3. `fallback` — the widget's default (series colour / palette).
+ *
+ * The datum is looked up by `params.dataIndex` in the widget's own data
+ * rather than read off `params.data`, so it works whatever the dataset row
+ * shape is (object rows, `[label, count]` tuples, `[x, y]` tuples).
+ *
+ * Datum and template colours go through {@link resolveThemeColor}, same as
+ * per-series colours, so palette paths such as `'primary.main'` work.
+ */
+export declare function createItemColorResolver({ theme, datums, template, fallback, }: {
+    theme: Theme;
+    datums: readonly unknown[];
+    template: unknown;
+    fallback: ItemColorCallback;
+}): ItemColorCallback;

package/dist/utils-C-eWwOhE.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils-C-eWwOhE.js","names":[],"sources":["../src/widgets/utils/merge-options.ts","../src/widgets/utils/data-zoom-layout.ts","../src/widgets/utils/resolve-theme-color.ts"],"sourcesContent":["/**\n * Shallow-merges two ECharts option objects:\n *   - Top-level keys from both are combined.\n *   - Arrays are merged by index (element-wise shallow merge, primitive override).\n *   - Plain objects are shallow-merged.\n *   - Primitives are overridden by the override value.\n *\n * Designed for the two-stage memoization pattern: first build a base option\n * object from data + theme + formatters, then call `mergeOptions(base, override)`\n * inside a second `useMemo` keyed on `[base, override]`.\n */\nexport function mergeOptions<T extends Record<string, unknown>>(\n  base: T,\n  override?: Partial<T>,\n): T {\n  if (!override) return base\n  const out: Record<string, unknown> = { ...base }\n  for (const key of Object.keys(override) as (keyof T)[]) {\n    const a = base[key]\n    const b = override[key]\n    if (b === undefined) continue\n    out[key as string] = mergeValue(a, b)\n  }\n  return out as T\n}\n\nfunction mergeValue(a: unknown, b: unknown): unknown {\n  if (Array.isArray(a) && Array.isArray(b)) {\n    const len = Math.max(a.length, b.length)\n    const result = new Array<unknown>(len)\n    for (let i = 0; i < len; i++) {\n      const av: unknown = a[i]\n      const bv: unknown = b[i]\n      if (bv === undefined) result[i] = av\n      else if (av === undefined) result[i] = bv\n      else result[i] = mergeValue(av, bv)\n    }\n    return result\n  }\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return { ...a, ...b }\n  }\n  return b\n}\n\nfunction isPlainObject(v: unknown): v is Record<string, unknown> {\n  if (v === null || typeof v !== 'object') return false\n  const proto = Object.getPrototypeOf(v) as unknown\n  return proto === Object.prototype || proto === null\n}\n","import { ZOOM_LAYOUT } from '../actions/zoom-toggle'\n\n/**\n * If the option includes a `dataZoom` array (from ZoomToggle's transform),\n * lift any slider entries above the legend row so they don't overlap.\n * Returns `null` when there is no `dataZoom` — caller skips the layout\n * adjustment entirely.\n *\n * Shared between bar, histogram, and timeseries — every widget with a\n * horizontal x-axis dataZoom slider needs the same offset when a legend\n * is rendered below the plot.\n */\nexport function positionDataZoomForLegend(\n  dataZoom: unknown,\n  hasLegend: boolean,\n): unknown[] | null {\n  if (!Array.isArray(dataZoom) || dataZoom.length === 0) return null\n  return dataZoom.map((entry: unknown) => {\n    if (entry == null || typeof entry !== 'object') return entry\n    const dz = entry as { type?: string; bottom?: number }\n    if (dz.type === 'slider' && hasLegend) {\n      return { ...dz, bottom: ZOOM_LAYOUT.sliderBottomWithLegend }\n    }\n    return dz\n  })\n}\n","import type { Theme } from '@mui/material'\n\n/**\n * Resolve a colour string against the MUI theme palette.\n *\n * - `'primary.main'`, `'secondary.dark'`, `'success.contrastText'`, … →\n *   walks `theme.palette` along the dot-separated path and returns the\n *   resolved string when traversal succeeds.\n * - `'#ff0000'`, `'rgb(255, 0, 0)'`, `'red'` → returned as-is (assumed\n *   raw CSS; ECharts consumes them directly).\n * - `undefined` → `undefined` (callers fall back to ECharts' palette).\n *\n * Used by the echart option factories (Bar, Pie, Histogram, Scatterplot,\n * Timeseries) so per-series colours specified as theme paths in the\n * unified `WidgetSeries` shape paint correctly. Category, Formula, and\n * Spread render colours through MUI's `sx` resolver, which already\n * handles theme paths — they don't need this helper.\n */\nexport function resolveThemeColor(\n  theme: Theme,\n  raw: string | undefined,\n): string | undefined {\n  if (raw == null) return undefined\n  if (!raw.includes('.')) return raw\n  const parts = raw.split('.')\n  let cursor: unknown = theme.palette\n  for (const part of parts) {\n    if (cursor == null || typeof cursor !== 'object') {\n      return raw\n    }\n    cursor = (cursor as Record<string, unknown>)[part]\n  }\n  return typeof cursor === 'string' ? cursor : raw\n}\n"],"mappings":";;AAWA,SAAgB,EACd,GACA,GACG;CACH,IAAI,CAAC,GAAU,OAAO;CACtB,IAAM,IAA+B,EAAE,GAAG,EAAK;CAC/C,KAAK,IAAM,KAAO,OAAO,KAAK,CAAQ,GAAkB;EACtD,IAAM,IAAI,EAAK,IACT,IAAI,EAAS;EACf,MAAM,KAAA,MACV,EAAI,KAAiB,EAAW,GAAG,CAAC;CACtC;CACA,OAAO;AACT;AAEA,SAAS,EAAW,GAAY,GAAqB;CACnD,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;EACxC,IAAM,IAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,GACjC,IAAa,MAAe,CAAG;EACrC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAK,KAAK;GAC5B,IAAM,IAAc,EAAE,IAChB,IAAc,EAAE;GACtB,AAAI,MAAO,KAAA,IAAW,EAAO,KAAK,IACzB,MAAO,KAAA,IAAW,EAAO,KAAK,IAClC,EAAO,KAAK,EAAW,GAAI,CAAE;EACpC;EACA,OAAO;CACT;CAIA,OAHI,EAAc,CAAC,KAAK,EAAc,CAAC,IAC9B;EAAE,GAAG;EAAG,GAAG;CAAE,IAEf;AACT;AAEA,SAAS,EAAc,GAA0C;CAC/D,IAAkB,OAAO,KAAM,aAA3B,GAAqC,OAAO;CAChD,IAAM,IAAQ,OAAO,eAAe,CAAC;CACrC,OAAO,MAAU,OAAO,aAAa,MAAU;AACjD;;;ACrCA,SAAgB,EACd,GACA,GACkB;CAElB,OADI,CAAC,MAAM,QAAQ,CAAQ,KAAK,EAAS,WAAW,IAAU,OACvD,EAAS,KAAK,MAAmB;EACtC,IAAqB,OAAO,KAAU,aAAlC,GAA4C,OAAO;EACvD,IAAM,IAAK;EAIX,OAHI,EAAG,SAAS,YAAY,IACnB;GAAE,GAAG;GAAI,QAAQ,EAAY;EAAuB,IAEtD;CACT,CAAC;AACH;;;ACPA,SAAgB,EACd,GACA,GACoB;CACpB,IAAI,KAAO,MAAM;CACjB,IAAI,CAAC,EAAI,SAAS,GAAG,GAAG,OAAO;CAC/B,IAAM,IAAQ,EAAI,MAAM,GAAG,GACvB,IAAkB,EAAM;CAC5B,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAsB,OAAO,KAAW,aAApC,GACF,OAAO;EAET,IAAU,EAAmC;CAC/C;CACA,OAAO,OAAO,KAAW,WAAW,IAAS;AAC/C"}
+{"version":3,"file":"utils-C-eWwOhE.js","names":["ZOOM_LAYOUT","mergeOptions","override","base","out","key","b","mergeValue","a","len","result","i","av","bv","isPlainObject","v","proto","positionDataZoomForLegend","dataZoom","entry","dz","hasLegend","resolveThemeColor","raw","parts","cursor","theme","part"],"sources":["../src/widgets/utils/merge-options.ts","../src/widgets/utils/data-zoom-layout.ts","../src/widgets/utils/resolve-theme-color.ts"],"sourcesContent":["/**\n * Shallow-merges two ECharts option objects:\n *   - Top-level keys from both are combined.\n *   - Arrays are merged by index (element-wise shallow merge, primitive override).\n *   - Plain objects are shallow-merged.\n *   - Primitives are overridden by the override value.\n *\n * Designed for the two-stage memoization pattern: first build a base option\n * object from data + theme + formatters, then call `mergeOptions(base, override)`\n * inside a second `useMemo` keyed on `[base, override]`.\n */\nexport function mergeOptions<T extends Record<string, unknown>>(\n  base: T,\n  override?: Partial<T>,\n): T {\n  if (!override) return base\n  const out: Record<string, unknown> = { ...base }\n  for (const key of Object.keys(override) as (keyof T)[]) {\n    const a = base[key]\n    const b = override[key]\n    if (b === undefined) continue\n    out[key as string] = mergeValue(a, b)\n  }\n  return out as T\n}\n\nfunction mergeValue(a: unknown, b: unknown): unknown {\n  if (Array.isArray(a) && Array.isArray(b)) {\n    const len = Math.max(a.length, b.length)\n    const result = new Array<unknown>(len)\n    for (let i = 0; i < len; i++) {\n      const av: unknown = a[i]\n      const bv: unknown = b[i]\n      if (bv === undefined) result[i] = av\n      else if (av === undefined) result[i] = bv\n      else result[i] = mergeValue(av, bv)\n    }\n    return result\n  }\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return { ...a, ...b }\n  }\n  return b\n}\n\nfunction isPlainObject(v: unknown): v is Record<string, unknown> {\n  if (v === null || typeof v !== 'object') return false\n  const proto = Object.getPrototypeOf(v) as unknown\n  return proto === Object.prototype || proto === null\n}\n","import { ZOOM_LAYOUT } from '../actions/zoom-toggle'\n\n/**\n * If the option includes a `dataZoom` array (from ZoomToggle's transform),\n * lift any slider entries above the legend row so they don't overlap.\n * Returns `null` when there is no `dataZoom` — caller skips the layout\n * adjustment entirely.\n *\n * Shared between bar, histogram, and timeseries — every widget with a\n * horizontal x-axis dataZoom slider needs the same offset when a legend\n * is rendered below the plot.\n */\nexport function positionDataZoomForLegend(\n  dataZoom: unknown,\n  hasLegend: boolean,\n): unknown[] | null {\n  if (!Array.isArray(dataZoom) || dataZoom.length === 0) return null\n  return dataZoom.map((entry: unknown) => {\n    if (entry == null || typeof entry !== 'object') return entry\n    const dz = entry as { type?: string; bottom?: number }\n    if (dz.type === 'slider' && hasLegend) {\n      return { ...dz, bottom: ZOOM_LAYOUT.sliderBottomWithLegend }\n    }\n    return dz\n  })\n}\n","import type { Theme } from '@mui/material'\n\n/**\n * Resolve a colour string against the MUI theme palette.\n *\n * - `'primary.main'`, `'secondary.dark'`, `'success.contrastText'`, … →\n *   walks `theme.palette` along the dot-separated path and returns the\n *   resolved string when traversal succeeds.\n * - `'#ff0000'`, `'rgb(255, 0, 0)'`, `'red'` → returned as-is (assumed\n *   raw CSS; ECharts consumes them directly).\n * - `undefined` → `undefined` (callers fall back to ECharts' palette).\n *\n * Used by the echart option factories (Bar, Pie, Histogram, Scatterplot,\n * Timeseries) so per-series colours specified as theme paths in the\n * unified `WidgetSeries` shape paint correctly. Category, Formula, and\n * Spread render colours through MUI's `sx` resolver, which already\n * handles theme paths — they don't need this helper.\n */\nexport function resolveThemeColor(\n  theme: Theme,\n  raw: string | undefined,\n): string | undefined {\n  if (raw == null) return undefined\n  if (!raw.includes('.')) return raw\n  const parts = raw.split('.')\n  let cursor: unknown = theme.palette\n  for (const part of parts) {\n    if (cursor == null || typeof cursor !== 'object') {\n      return raw\n    }\n    cursor = (cursor as Record<string, unknown>)[part]\n  }\n  return typeof cursor === 'string' ? cursor : raw\n}\n"],"mappings":";;AAWA,SAAgBC,EACd,GACA,GACG;CACH,IAAI,CAACC,GAAU,OAAOC;CACtB,IAAMC,IAA+B,EAAE,GAAGD,EAAK;CAC/C,KAAK,IAAME,KAAO,OAAO,KAAKH,CAAQ,GAAkB;EACtD,IAAM,IAAIC,EAAKE,IACTC,IAAIJ,EAASG;EACnB,AAAIC,MAAM,KAAA,MACV,EAAID,KAAiBE,EAAW,GAAGD,CAAC;CACtC;CACA,OAAOF;AACT;AAEA,SAASG,EAAW,GAAY,GAAqB;CACnD,IAAI,MAAM,QAAQC,CAAC,KAAK,MAAM,QAAQF,CAAC,GAAG;EACxC,IAAMG,IAAM,KAAK,IAAID,EAAE,QAAQF,EAAE,MAAM,GACjCI,IAAa,MAAeD,CAAG;EACrC,KAAK,IAAIE,IAAI,GAAGA,IAAIF,GAAK,KAAK;GAC5B,IAAMG,IAAcJ,EAAEG,IAChBE,IAAcP,EAAEK;GACtB,AAAIE,MAAO,KAAA,IAAW,EAAOF,KAAKC,IACzBA,MAAO,KAAA,IAAW,EAAOD,KAAKE,IAClC,EAAOF,KAAKJ,EAAWK,GAAIC,CAAE;EACpC;EACA,OAAOH;CACT;CAIA,OAHII,EAAcN,CAAC,KAAKM,EAAcR,CAAC,IAC9B;EAAE,GAAGE;EAAG,GAAGF;CAAE,IAEfA;AACT;AAEA,SAASQ,EAAc,GAA0C;CAC/D,IAAkB,OAAOC,KAAM,aAA3BA,GAAqC,OAAO;CAChD,IAAMC,IAAQ,OAAO,eAAeD,CAAC;CACrC,OAAOC,MAAU,OAAO,aAAaA,MAAU;AACjD;;;ACrCA,SAAgBC,EACd,GACA,GACkB;CAElB,OADI,CAAC,MAAM,QAAQC,CAAQ,KAAKA,EAAS,WAAW,IAAU,OACvDA,EAAS,KAAK,MAAmB;EACtC,IAAqB,OAAOC,KAAU,aAAlCA,GAA4C,OAAOA;EACvD,IAAMC,IAAKD;EAIX,OAHIC,EAAG,SAAS,YAAYC,IACnB;GAAE,GAAGD;GAAI,QAAQpB,EAAY;EAAuB,IAEtDoB;CACT,CAAC;AACH;;;ACPA,SAAgBE,EACd,GACA,GACoB;CACpB,IAAIC,KAAO,MAAM;CACjB,IAAI,CAACA,EAAI,SAAS,GAAG,GAAG,OAAOA;CAC/B,IAAMC,IAAQD,EAAI,MAAM,GAAG,GACvBE,IAAkBC,EAAM;CAC5B,KAAK,IAAMC,KAAQH,GAAO;EACxB,IAAsB,OAAOC,KAAW,aAApCA,GACF,OAAOF;EAET,IAAUE,EAAmCE;CAC/C;CACA,OAAO,OAAOF,KAAW,WAAWA,IAASF;AAC/C"}

package/dist/widgets/actions.js

@@ -1,4 +1,4 @@
-import { C as e, E as t, S as n, T as r, _ as i, a, b as o, c as s, d as c, f as l, g as u, h as d, i as f, l as p, m, n as h, o as g, p as _, r as v, s as y, t as b, u as x, v as S, w as C, x as w, y as T } from "../actions-BWlS5tpP.js";
+import { C as e, E as t, S as n, T as r, _ as i, a, b as o, c as s, d as c, f as l, g as u, h as d, i as f, l as p, m, n as h, o as g, p as _, r as v, s as y, t as b, u as x, v as S, w as C, x as w, y as T } from "../actions-CkxKe8-J.js";
 import { a as E, i as D, n as O, r as k, t as A } from "../zoom-toggle-MmLjMTEw.js";
 import { a as j, c as M, d as N, f as P, i as F, l as I, n as L, o as R, p as z, r as B, s as V, t as H, u as U } from "../download-B4sykOFm.js";
 export { l as BrushToggle, j as CSVIcon, b as ChangeColumn, _ as DEFAULT_BRUSH_TOGGLE_LABELS, h as DEFAULT_CHANGE_COLUMN_LABELS, I as DEFAULT_DOWNLOAD_LABELS, y as DEFAULT_FULLSCREEN_LABELS, f as DEFAULT_LOCK_SELECTION_LABELS, p as DEFAULT_RELATIVE_DATA_LABELS, r as DEFAULT_SEARCHER_LABELS, S as DEFAULT_SHOW_ALL_LABELS, o as DEFAULT_STACK_TOGGLE_LABELS, O as DEFAULT_ZOOM_TOGGLE_LABELS, F as DOWNLOAD_ITEM_IDS, M as Download, g as FullScreen, v as LockSelection, R as MarkdownIcon, V as PNGIcon, s as RelativeData, d as SHOW_ALL_ID, n as Searcher, e as SearcherToggle, u as ShowAllToggle, T as StackToggle, k as ZOOM_LAYOUT, A as ZoomToggle, m as addBrush, w as addStack, D as addZoom, L as buildCsvDownloadItem, B as buildPngDownloadItem, E as createAddZoom, x as createPercentFormatter, U as downloadDOMToPNG, N as downloadToCSV, a as filterByLockedItems, t as filterBySearchText, C as setSearcherText, i as setShowAll, P as toCsvString, c as toRelativeData, z as triggerLinkDownload, H as withPngItem };