@carto/ps-react-ui 4.24.0 → 4.26.0

package/dist/types/widgets-v2/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-v2/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-v2/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-v2/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-v2/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-v2/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-v2/scatterplot/download.d.ts

@@ -1,5 +1,5 @@
 import { DownloadContext, DownloadItem } 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
@@ -8,7 +8,7 @@ import { ScatterplotWidgetData } from './types.js';
  */
 export declare function createScatterplotDownloadConfig(args: {
     filename: string;
-    getData: (ctx: DownloadContext) => ScatterplotWidgetData;
+    getData: (ctx: DownloadContext) => ScatterplotWidgetData<ScatterplotItem>;
     seriesNames?: readonly string[];
     getCaptureEl?: (ctx: DownloadContext) => HTMLElement | null;
     pngPixelRatio?: number;

package/dist/types/widgets-v2/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-v2/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-v2/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-v2/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-v2/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-v2/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/widgets-v2/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-B1ss030_.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-DXfQMrll.js";
 import { a as E, i as D, n as O, r as k, t as A } from "../zoom-toggle-KA63b6-J.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, r as z, s as B, t as V, u as H } from "../download--wRRnf19.js";
 export { l as BrushToggle, F as CSVIcon, b as ChangeColumn, _ as DEFAULT_BRUSH_TOGGLE_LABELS, h as DEFAULT_CHANGE_COLUMN_LABELS, M 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, z as DOWNLOAD_ITEM_IDS, B as Download, g as FullScreen, v as LockSelection, j as MarkdownIcon, R 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, V as buildCsvDownloadItem, L as buildPngDownloadItem, E as createAddZoom, x as createPercentFormatter, I as downloadDOMToPNG, H as downloadToCSV, a as filterByLockedItems, t as filterBySearchText, C as setSearcherText, i as setShowAll, N as toCsvString, c as toRelativeData, P as triggerLinkDownload };

package/dist/widgets-v2/bar.js

@@ -2,12 +2,13 @@ import { r as e } from "../zoom-toggle-KA63b6-J.js";
 import { n as t, t as n } from "../download--wRRnf19.js";
 import { n as r, r as i, t as a } from "../utils-ClB6nn4w.js";
 import { a as o, d as s, f as c, i as l, s as u, u as d } from "../chart-config-BWxjodlt.js";
-import { c as f } from "react/compiler-runtime";
-import { Box as p, Skeleton as m } from "@mui/material";
-import { jsx as h, jsxs as g } from "react/jsx-runtime";
-import * as _ from "echarts";
+import { t as f } from "../item-color-C1cu6EJd.js";
+import { c as p } from "react/compiler-runtime";
+import { Box as m, Skeleton as h } from "@mui/material";
+import { jsx as g, jsxs as _ } from "react/jsx-runtime";
+import * as v from "echarts";
 //#region src/widgets-v2/bar/options.ts
-function v({ theme: e, formatter: t, labelFormatter: n }) {
+function y({ theme: e, formatter: t, labelFormatter: n }) {
 	let r = 0, i = 1;
 	return {
 		grid: {
@@ -29,7 +30,7 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 			},
 			axisPointer: { type: "line" },
 			position: s(e),
-			formatter: b(t, n)
+			formatter: x(t, n)
 		},
 		legend: { ...u({
 			hasLegend: !1,
@@ -78,34 +79,42 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 		}
 	};
 }
-function y(t) {
-	let { theme: n, formatter: o, labelFormatter: s, optionsOverride: l } = t, u = t.series, d = t.selection, f = d && d.length > 0 ? new Set(d) : null;
-	return (t, d, p) => {
+function b(t) {
+	let { theme: n, formatter: o, labelFormatter: s, optionsOverride: l } = t, u = t.series, d = t.selection, p = d && d.length > 0 ? new Set(d) : null;
+	return (t, d, m) => {
 		if (t == null) {
-			let e = v({
+			let e = y({
 				theme: n,
 				formatter: o,
 				labelFormatter: s
 			});
 			return l ? i(e, l) : e;
 		}
-		let m = Array.isArray(d) ? d : [];
-		if (m.length === 0) return {
+		let h = Array.isArray(d) ? d : [];
+		if (h.length === 0) return {
 			...t,
 			dataset: [],
 			series: []
 		};
-		let h = m.length > 1, g = typeof t.legend == "object" && !Array.isArray(t.legend) ? t.legend : {}, y = typeof t.grid == "object" && !Array.isArray(t.grid) ? t.grid : {}, x = typeof t.tooltip == "object" && !Array.isArray(t.tooltip) ? t.tooltip : {}, S = typeof t.yAxis == "object" && !Array.isArray(t.yAxis) ? t.yAxis : {}, C = Array.isArray(t.series) ? t.series : [], w = C[0] ?? {}, T = p?.formatter, E = p?.labelFormatter, D = 0, O = 1, k = r(t.dataZoom, h), A = typeof y.bottom == "number" ? y.bottom : 24, j = h ? 56 : A, M = k ? j + e.sliderHeight + e.sliderGap : j, N = { color: (e) => {
-			let t = e.color;
-			if (!f) return t;
-			let n = e.value?.name ?? e.name;
-			return n != null && f.has(n) ? t : _.color.modifyAlpha(t, .15);
-		} };
+		let g = h.length > 1, _ = typeof t.legend == "object" && !Array.isArray(t.legend) ? t.legend : {}, b = typeof t.grid == "object" && !Array.isArray(t.grid) ? t.grid : {}, S = typeof t.tooltip == "object" && !Array.isArray(t.tooltip) ? t.tooltip : {}, C = typeof t.yAxis == "object" && !Array.isArray(t.yAxis) ? t.yAxis : {}, w = Array.isArray(t.series) ? t.series : [], T = w[0] ?? {}, E = m?.formatter, D = m?.labelFormatter, O = 0, k = 1, A = r(t.dataZoom, g), j = typeof b.bottom == "number" ? b.bottom : 24, M = g ? 56 : j, N = A ? M + e.sliderHeight + e.sliderGap : M, P = (e, t) => {
+			let r = f({
+				theme: n,
+				datums: e,
+				template: t,
+				fallback: (e) => e.color
+			});
+			return { color: (e) => {
+				let t = r(e);
+				if (!p) return t;
+				let n = e.value?.name ?? e.name;
+				return n != null && p.has(n) ? t : v.color.modifyAlpha(t, .15);
+			} };
+		};
 		return {
 			...t,
-			dataset: m.map((e) => ({ source: e })),
-			series: m.map((e, t) => {
-				let r = C[t] ?? w, i = a(n, u?.[t]?.color);
+			dataset: h.map((e) => ({ source: e })),
+			series: h.map((e, t) => {
+				let r = w[t] ?? T, i = a(n, u?.[t]?.color);
 				return {
 					...typeof r == "object" ? r : {},
 					type: "bar",
@@ -117,36 +126,36 @@ function y(t) {
 					},
 					barMaxWidth: 100,
 					emphasis: { focus: "series" },
-					itemStyle: N,
+					itemStyle: P(e, r),
 					...i ? { color: i } : {}
 				};
 			}),
 			legend: {
-				...g,
-				show: h
+				..._,
+				show: g
 			},
 			grid: {
-				...y,
-				bottom: M
+				...b,
+				bottom: N
 			},
-			...k ? { dataZoom: k } : {},
+			...A ? { dataZoom: A } : {},
 			yAxis: {
-				...S,
-				min: (e) => (D = e.min < 0 ? c(e.min) : 0, D),
-				max: (e) => (O = e.max <= 0 ? 1 : c(e.max), O),
+				...C,
+				min: (e) => (O = e.min < 0 ? c(e.min) : 0, O),
+				max: (e) => (k = e.max <= 0 ? 1 : c(e.max), k),
 				axisLabel: {
-					...S.axisLabel ?? {},
-					formatter: (e) => e !== O && e !== D || e === 0 ? "" : T ? T(e) : String(e)
+					...C.axisLabel ?? {},
+					formatter: (e) => e !== k && e !== O || e === 0 ? "" : E ? E(e) : String(e)
 				}
 			},
 			tooltip: {
-				...x,
-				formatter: b(T, E)
+				...S,
+				formatter: x(E, D)
 			}
 		};
 	};
 }
-function b(e, t) {
+function x(e, t) {
 	return d((n) => {
 		let r = n.value?.value, i = typeof r == "number" && e ? e(r) : r ?? "", a = typeof n.marker == "string" ? n.marker : "", o = n.seriesName ? `${n.seriesName}: ` : "", s = t ? String(t(n.name ?? "")) : n.name ?? "";
 		return {
@@ -159,7 +168,7 @@ function b(e, t) {
 }
 //#endregion
 //#region src/widgets-v2/bar/skeleton.tsx
-var x = {
+var S = {
 	container: {
 		display: "flex",
 		alignItems: "center",
@@ -191,51 +200,51 @@ var x = {
 		alignItems: "center",
 		gap: ({ spacing: e }) => e(1.5)
 	}
-}, S = [
+}, C = [
 	"20%",
 	"40%",
 	"60%",
 	"20%",
 	"80%"
 ];
-function C() {
-	let e = f(2), t;
-	e[0] === Symbol.for("react.memo_cache_sentinel") ? (t = /* @__PURE__ */ h(p, {
-		sx: x.grid,
-		children: S.map(T)
+function w() {
+	let e = p(2), t;
+	e[0] === Symbol.for("react.memo_cache_sentinel") ? (t = /* @__PURE__ */ g(m, {
+		sx: S.grid,
+		children: C.map(E)
 	}), e[0] = t) : t = e[0];
 	let n;
-	return e[1] === Symbol.for("react.memo_cache_sentinel") ? (n = /* @__PURE__ */ g(p, {
-		sx: x.container,
-		children: [t, /* @__PURE__ */ h(p, {
-			sx: x.legend,
-			children: [0, 1].map(w)
+	return e[1] === Symbol.for("react.memo_cache_sentinel") ? (n = /* @__PURE__ */ _(m, {
+		sx: S.container,
+		children: [t, /* @__PURE__ */ g(m, {
+			sx: S.legend,
+			children: [0, 1].map(T)
 		})]
 	}), e[1] = n) : n = e[1], n;
 }
-function w(e) {
-	return /* @__PURE__ */ g(p, {
-		sx: x.legendItem,
-		children: [/* @__PURE__ */ h(m, {
+function T(e) {
+	return /* @__PURE__ */ _(m, {
+		sx: S.legendItem,
+		children: [/* @__PURE__ */ g(h, {
 			variant: "circular",
 			width: 8,
 			height: 8
-		}), /* @__PURE__ */ h(m, {
+		}), /* @__PURE__ */ g(h, {
 			width: 48,
 			height: 8
 		})]
 	}, `legend-${e}`);
 }
-function T(e, t) {
-	return /* @__PURE__ */ h(m, {
-		sx: x.bar,
+function E(e, t) {
+	return /* @__PURE__ */ g(h, {
+		sx: S.bar,
 		variant: "rectangular",
 		height: e
 	}, `bar-${t}`);
 }
 //#endregion
 //#region src/widgets-v2/bar/download.tsx
-function E(e) {
+function D(e) {
 	let r = [];
 	return e.getCaptureEl && r.push(t({
 		filename: e.filename,
@@ -255,6 +264,6 @@ function E(e) {
 	})), r;
 }
 //#endregion
-export { C as BarSkeleton, v as barOptions, E as createBarDownloadConfig, y as createBarOptionFactory };
+export { w as BarSkeleton, y as barOptions, D as createBarDownloadConfig, b as createBarOptionFactory };
 
 //# sourceMappingURL=bar.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"bar.js","names":["EChartsOption","echarts","CallbackDataParams","buildAxisLabelStyle","buildGridConfig","buildLegendConfig","createTooltipFormatter","createTooltipPositioner","niceNum","ZOOM_LAYOUT","OptionFactory","mergeOptions","resolveThemeColor","positionDataZoomForLegend","BarEChartsOption","BarOptionFactoryInput","BarOptionsInput","BarWidgetData","barOptions","theme","formatter","labelFormatter","niceMin","niceMax","grid","left","parseInt","spacing","top","right","containLabel","tooltip","trigger","backgroundColor","palette","grey","borderWidth","padding","textStyle","color","common","white","fontSize","fontFamily","typography","caption","axisPointer","type","position","buildBarTooltipFormatter","legend","hasLegend","lineStyle","secondary","main","Object","values","qualitative","bold","Record","xAxis","axisLine","show","axisTick","axisLabel","margin","interval","hideOverlap","v","String","yAxis","min","extent","max","splitLine","black","divider","showMaxLabel","showMinLabel","verticalAlign","inside","value","createBarOptionFactory","options","optionsOverride","series","selection","selectionSet","length","Set","option","data","ctx","structural","Partial","seriesArr","Array","isArray","dataset","baseLegend","baseGrid","baseTooltip","baseYAxis","seriesTemplates","broadcastTemplate","liveFormatter","liveLabelFormatter","dataZoomLayout","dataZoom","fallbackBottom","bottom","baseBottom","gridBottom","sliderHeight","sliderGap","dimItemStyle","params","base","datum","name","has","modifyAlpha","map","s","source","_","i","template","overrideColor","const","datasetIndex","encode","x","y","barMaxWidth","emphasis","focus","itemStyle","item","row","raw","formattedValue","marker","seriesName","Box","Skeleton","SxProps","Theme","styles","container","display","alignItems","justifyContent","flexDirection","gap","spacing","height","grid","flex","width","bar","maxWidth","marginLeft","legend","legendItem","Record","BAR_HEIGHTS","const","BarSkeleton","$","_c","t0","Symbol","for","map","_temp","t1","_temp2","i_0","i","buildCsvDownloadItem","buildPngDownloadItem","DownloadContext","DownloadItem","BarWidgetData","BarDownloadConfigArgs","filename","getData","ctx","getCaptureEl","HTMLElement","pngPixelRatio","pngBackgroundColor","createBarDownloadConfig","args","items","push","pixelRatio","backgroundColor","getRows","data","rows","i","series","entries","d","name","value"],"sources":["../../src/widgets-v2/bar/options.ts","../../src/widgets-v2/bar/skeleton.tsx","../../src/widgets-v2/bar/download.tsx"],"sourcesContent":["import type { EChartsOption } from 'echarts'\nimport * as echarts from 'echarts'\nimport type { CallbackDataParams } from 'echarts/types/dist/shared'\nimport {\n  buildAxisLabelStyle,\n  buildGridConfig,\n  buildLegendConfig,\n  createTooltipFormatter,\n  createTooltipPositioner,\n  niceNum,\n} from '../../widgets/utils/chart-config'\nimport { ZOOM_LAYOUT } from '../actions/zoom-toggle'\nimport type { OptionFactory } from '../echart'\nimport { mergeOptions, resolveThemeColor } from '../utils'\nimport { positionDataZoomForLegend } from '../utils/data-zoom-layout'\nimport type {\n  BarEChartsOption,\n  BarOptionFactoryInput,\n  BarOptionsInput,\n  BarWidgetData,\n} from './types'\n\n/**\n * Builds the **structural** ECharts option for a bar widget — axes, grid,\n * tooltip styling, themed legend. Intentionally data-agnostic: no series,\n * no dataset, no `legend.show` (those depend on data and are added by the\n * option factory's merge phase). This separation is what lets data-side\n * pipeline transforms (Searcher, RelativeData) drive the rendered chart —\n * the merge happens at render time inside the Echart bridge.\n *\n * Styling matches the v1 `barConfig` look-and-feel: minimal axes (only\n * min/max y-labels rendered inside the plot via `niceNum`), themed tooltip,\n * scroll legend, and CARTO color palette. The y-axis min/max + label\n * formatter and the tooltip formatter are wired here for the no-data case;\n * {@link createBarOptionFactory} re-derives them at fusion time so reactive\n * formatter changes (RelativeData) and stack templates (StackToggle) flow\n * through to the chart.\n */\nexport function barOptions({\n  theme,\n  formatter,\n  labelFormatter,\n}: BarOptionsInput): BarEChartsOption {\n  // Closure shared between yAxis min/max callbacks and the label formatter,\n  // so only the rounded extents are labelled (matches v1).\n  let niceMin = 0\n  let niceMax = 1\n\n  return {\n    grid: {\n      left: parseInt(theme.spacing(1)),\n      top: parseInt(theme.spacing(3)),\n      right: parseInt(theme.spacing(1)),\n      // Default: no legend. Merger bumps this when there are >1 series.\n      ...buildGridConfig(false, theme),\n      containLabel: true,\n    },\n    tooltip: {\n      trigger: 'axis',\n      backgroundColor: theme.palette.grey[900],\n      borderWidth: 0,\n      padding: [parseInt(theme.spacing(1)), parseInt(theme.spacing(1))],\n      textStyle: {\n        color: theme.palette.common.white,\n        fontSize: 11,\n        fontFamily: theme.typography.caption.fontFamily,\n      },\n      axisPointer: { type: 'line' },\n      position: createTooltipPositioner(theme),\n      formatter: buildBarTooltipFormatter(formatter, labelFormatter),\n    },\n    // Legend styling baked here; `show` is toggled by the merger based on\n    // series count.\n    legend: {\n      ...buildLegendConfig({ hasLegend: false, labelFormatter }),\n    },\n    axisPointer: { lineStyle: { color: theme.palette.grey[400] } },\n    color: [\n      theme.palette.secondary.main,\n      ...Object.values(\n        (theme.palette as { qualitative?: { bold?: Record<string, string> } })\n          .qualitative?.bold ?? {},\n      ),\n    ],\n    xAxis: {\n      type: 'category',\n      axisLine: { show: false },\n      axisTick: { show: false },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        padding: [parseInt(theme.spacing(0.5)), 0, 0, 0],\n        margin: 0,\n        // `interval: 0` makes every category label a candidate so `hideOverlap`\n        // can pack the maximum number that physically fit; the category-axis\n        // default (`'auto'`) sub-samples first and shows fewer than fit.\n        interval: 0,\n        hideOverlap: true,\n        ...(labelFormatter && {\n          formatter: (v: string | number) => String(labelFormatter(v)),\n        }),\n      },\n    },\n    yAxis: {\n      type: 'value',\n      min: (extent: { min: number }) => {\n        niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n        return niceMin\n      },\n      max: (extent: { min: number; max: number }) => {\n        niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n        return niceMax\n      },\n      axisLine: { show: false },\n      axisTick: { show: false },\n      splitLine: {\n        show: true,\n        lineStyle: { color: theme.palette.black?.[4] ?? theme.palette.divider },\n      },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        margin: parseInt(theme.spacing(1)),\n        show: true,\n        showMaxLabel: true,\n        showMinLabel: true,\n        verticalAlign: 'bottom',\n        inside: true,\n        formatter: (value: number) => {\n          if (value !== niceMax && value !== niceMin) return ''\n          if (value === 0) return ''\n          return formatter ? formatter(value) : String(value)\n        },\n      },\n    },\n  } as BarEChartsOption\n}\n\n/**\n * Returns the bar widget's {@link OptionFactory} — a single closure that\n * handles BOTH option-construction phases:\n *\n *   - **Structural phase** (`option == null`) — builds the theme-aware\n *     structural option via {@link barOptions}, optionally merging the\n *     consumer-supplied `optionsOverride` on top. Called once by Provider\n *     to seed `rawOptions` in the store; configTransforms (StackToggle /\n *     ZoomToggle / BrushToggle) then mutate it via the pipeline middleware.\n *   - **Merge phase** (`option != null`) — fuses post-pipeline `state.data`\n *     (`BarWidgetData`) into the option via the dataset API: one dataset\n *     per series, each series referencing its dataset by index, encoded\n *     by `name` (x) and `value` (y). Spreads any series-template fields\n *     already on the incoming option (e.g. `{ stack: 'total' }` from\n *     `addStack`) into every emitted series so configTransforms compose\n *     end-to-end. Reactive `ctx.formatter` / `ctx.labelFormatter` drive\n *     the y-axis min/max-only label and the tooltip formatter at fusion\n *     time so RelativeData's percent formatter flows through without a\n *     structural rebuild.\n *\n * Stable identity when the inputs don't change (consumers should wrap the\n * call in `useMemo` keyed on the same inputs).\n */\nexport function createBarOptionFactory(\n  options: BarOptionFactoryInput,\n): OptionFactory {\n  const { theme, formatter, labelFormatter, optionsOverride } = options\n  const series = options.series\n  const selection = options.selection\n  const selectionSet =\n    selection && selection.length > 0\n      ? new Set<string | number>(selection)\n      : null\n  return (option, data, ctx) => {\n    // Structural phase: Provider seeds rawOptions with this branch. No data\n    // is read; we just emit the theme-aware base (optionally with override).\n    if (option == null) {\n      const structural = barOptions({ theme, formatter, labelFormatter })\n      return optionsOverride\n        ? (mergeOptions(\n            structural as unknown as Record<string, unknown>,\n            optionsOverride as Partial<Record<string, unknown>>,\n          ) as EChartsOption)\n        : structural\n    }\n\n    const seriesArr = Array.isArray(data) ? (data as BarWidgetData) : []\n    if (seriesArr.length === 0) {\n      return { ...option, dataset: [], series: [] }\n    }\n    const hasLegend = seriesArr.length > 1\n    const baseLegend =\n      typeof option.legend === 'object' && !Array.isArray(option.legend)\n        ? option.legend\n        : {}\n    const baseGrid =\n      typeof option.grid === 'object' && !Array.isArray(option.grid)\n        ? option.grid\n        : {}\n    const baseTooltip =\n      typeof option.tooltip === 'object' && !Array.isArray(option.tooltip)\n        ? option.tooltip\n        : {}\n    const baseYAxis =\n      typeof option.yAxis === 'object' && !Array.isArray(option.yAxis)\n        ? option.yAxis\n        : {}\n\n    const seriesTemplates = Array.isArray(option.series) ? option.series : []\n    const broadcastTemplate = seriesTemplates[0] ?? {}\n\n    // Reactive (live store) formatters from ctx — distinct from the\n    // closure-time `formatter` / `labelFormatter` captured for the\n    // structural-build branch above. RelativeData can install a percent\n    // formatter on the store after the factory was constructed; the merge\n    // phase reads `ctx` to pick that up.\n    const liveFormatter = ctx?.formatter\n    const liveLabelFormatter = ctx?.labelFormatter\n\n    // Closure shared between the yAxis min/max callbacks and the label\n    // formatter, so only the rounded extents are labelled (matches v1).\n    // Delegating the extent to ECharts (rather than precomputing scalars\n    // from the raw data) is what keeps stacked bars inside the plot: when\n    // StackToggle marks the series, ECharts feeds the *post-stack* extent\n    // to these callbacks, so `niceNum` rounds the stacked total instead of\n    // a single series.\n    let niceMin = 0\n    let niceMax = 1\n\n    // Zoom slider layout: when ZoomToggle has installed `dataZoom`, push the\n    // slider above the legend (if any) and reserve room in the grid below.\n    const dataZoomLayout = positionDataZoomForLegend(option.dataZoom, hasLegend)\n    const fallbackBottom =\n      typeof baseGrid.bottom === 'number' ? baseGrid.bottom : 24\n    const baseBottom = hasLegend ? 56 : fallbackBottom\n    const gridBottom = dataZoomLayout\n      ? baseBottom + ZOOM_LAYOUT.sliderHeight + ZOOM_LAYOUT.sliderGap\n      : baseBottom\n\n    // When a selection is active, dim non-selected bars by routing the\n    // resolved palette color through `modifyAlpha`. Per-row `itemStyle` on\n    // dataset object-rows is silently ignored when `series.encode` is in\n    // play — the callback approach is the standard ECharts pattern for\n    // per-data styling derived from a dataset.\n    //\n    // We *always* emit `itemStyle.color` (a passthrough when nothing is\n    // selected), not conditionally — dropping the key between renders\n    // would let ECharts' default merge keep the previous callback alive\n    // and bars would stay dimmed forever after an external clear. Always\n    // emitting lets normal merge swap the callback in place, no\n    // `replaceMerge` and no entry-animation flash on selection on/off.\n    const dimItemStyle = {\n      color: (params: CallbackDataParams) => {\n        const base = params.color as string\n        if (!selectionSet) return base\n        const datum = params.value as { name?: string | number } | undefined\n        const name = datum?.name ?? params.name\n        return name != null && selectionSet.has(name)\n          ? base\n          : echarts.color.modifyAlpha(base, 0.15)\n      },\n    }\n\n    return {\n      ...option,\n      dataset: seriesArr.map((s) => ({ source: s as readonly object[] })),\n      series: seriesArr.map((_, i) => {\n        const template =\n          (seriesTemplates[i] as object | undefined) ??\n          (broadcastTemplate as object)\n        // Per-series `color` override: ECharts sets `params.color` from\n        // `series[i].color` when resolving styles, so the dim callback\n        // above keeps working — it just dims the user's colour rather\n        // than the palette default.\n        const overrideColor = resolveThemeColor(theme, series?.[i]?.color)\n        return {\n          ...(typeof template === 'object' ? template : {}),\n          type: 'bar' as const,\n          datasetIndex: i,\n          name: series?.[i]?.name ?? `Series ${i + 1}`,\n          encode: { x: 'name', y: 'value' },\n          barMaxWidth: 100,\n          emphasis: { focus: 'series' },\n          itemStyle: dimItemStyle,\n          ...(overrideColor ? { color: overrideColor } : {}),\n        }\n      }),\n      legend: { ...baseLegend, show: hasLegend },\n      grid: {\n        ...baseGrid,\n        bottom: gridBottom,\n      },\n      ...(dataZoomLayout ? { dataZoom: dataZoomLayout } : {}),\n      yAxis: {\n        ...baseYAxis,\n        min: (extent: { min: number }) => {\n          niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n          return niceMin\n        },\n        max: (extent: { min: number; max: number }) => {\n          niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n          return niceMax\n        },\n        axisLabel: {\n          ...((baseYAxis as { axisLabel?: object }).axisLabel ?? {}),\n          formatter: (value: number) => {\n            if (value !== niceMax && value !== niceMin) return ''\n            if (value === 0) return ''\n            return liveFormatter ? liveFormatter(value) : String(value)\n          },\n        },\n      } as EChartsOption['yAxis'],\n      tooltip: {\n        ...baseTooltip,\n        formatter: buildBarTooltipFormatter(liveFormatter, liveLabelFormatter),\n      },\n    } as EChartsOption\n  }\n}\n\nfunction buildBarTooltipFormatter(\n  formatter: ((value: number) => string) | undefined,\n  labelFormatter: ((value: string | number) => string | number) | undefined,\n) {\n  return createTooltipFormatter((item) => {\n    const row = item.value as { name?: string | number; value?: number }\n    const raw = row?.value\n    const formattedValue =\n      typeof raw === 'number' && formatter ? formatter(raw) : (raw ?? '')\n    const marker = typeof item.marker === 'string' ? item.marker : ''\n    const seriesName = item.seriesName ? `${item.seriesName}: ` : ''\n    const name = labelFormatter\n      ? String(labelFormatter(item.name ?? ''))\n      : (item.name ?? '')\n    return { name: String(name), seriesName, marker, value: formattedValue }\n  })\n}\n","import { Box, Skeleton, type SxProps, type Theme } from '@mui/material'\n\nconst styles = {\n  container: {\n    display: 'flex',\n    alignItems: 'center',\n    justifyContent: 'space-between',\n    flexDirection: 'column',\n    gap: ({ spacing }) => spacing(1),\n    height: ({ spacing }) => spacing(38),\n  },\n  grid: {\n    display: 'flex',\n    justifyContent: 'space-between',\n    flex: '1 1 auto',\n    alignItems: 'flex-end',\n    width: '100%',\n  },\n  bar: {\n    flex: 1,\n    maxWidth: ({ spacing }) => spacing(12),\n    '& + &': {\n      marginLeft: ({ spacing }) => spacing(1),\n    },\n  },\n  legend: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(2),\n    height: ({ spacing }) => spacing(5),\n  },\n  legendItem: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(1.5),\n  },\n} satisfies Record<string, SxProps<Theme>>\n\nconst BAR_HEIGHTS = ['20%', '40%', '60%', '20%', '80%'] as const\n\n/**\n * Loading state for the Bar widget. Mirrors a bar chart's silhouette — five\n * vertical bars at staggered heights anchored to the bottom, plus a legend\n * stub — so the skeleton reads as \"a bar chart\" rather than a generic list.\n */\nexport function BarSkeleton() {\n  return (\n    <Box sx={styles.container}>\n      <Box sx={styles.grid}>\n        {BAR_HEIGHTS.map((height, i) => (\n          <Skeleton\n            key={`bar-${i}`}\n            sx={styles.bar}\n            variant='rectangular'\n            height={height}\n          />\n        ))}\n      </Box>\n      <Box sx={styles.legend}>\n        {[0, 1].map((i) => (\n          <Box key={`legend-${i}`} sx={styles.legendItem}>\n            <Skeleton variant='circular' width={8} height={8} />\n            <Skeleton width={48} height={8} />\n          </Box>\n        ))}\n      </Box>\n    </Box>\n  )\n}\n","import {\n  buildCsvDownloadItem,\n  buildPngDownloadItem,\n  type DownloadContext,\n  type DownloadItem,\n} from '../actions/download'\nimport type { BarWidgetData } from './types'\n\nexport interface BarDownloadConfigArgs {\n  filename: string\n  getData: (ctx: DownloadContext) => BarWidgetData\n  /**\n   * Optional getter for the widget's capture element (registered by\n   * `Widget.State` on its success path). When provided, a PNG item is\n   * prepended to the returned list. Wire it to\n   * `() => getCaptureEl(id)`.\n   */\n  getCaptureEl?: (ctx: DownloadContext) => HTMLElement | null\n  /** PNG `pixelRatio` (default 2). */\n  pngPixelRatio?: number\n  /** PNG `backgroundColor` (default transparent). */\n  pngBackgroundColor?: string | null\n}\n\n/**\n * Builds download items for the Bar widget. Always includes a CSV item\n * with one `name,value` block per series, separated by an empty row when\n * there are multiple. When `getCaptureEl` is supplied, also prepends a PNG\n * item that rasterises the captured element via `html2canvas`.\n */\nexport function createBarDownloadConfig(\n  args: BarDownloadConfigArgs,\n): DownloadItem[] {\n  const items: DownloadItem[] = []\n  if (args.getCaptureEl) {\n    items.push(\n      buildPngDownloadItem({\n        filename: args.filename,\n        getCaptureEl: args.getCaptureEl,\n        pixelRatio: args.pngPixelRatio,\n        backgroundColor: args.pngBackgroundColor,\n      }),\n    )\n  }\n  items.push(\n    buildCsvDownloadItem({\n      filename: args.filename,\n      getRows: (ctx) => {\n        const data = args.getData(ctx)\n        const rows: unknown[][] = []\n        for (const [i, series] of data.entries()) {\n          if (i > 0) rows.push([])\n          rows.push(['name', 'value'])\n          for (const d of series) rows.push([d.name, d.value])\n        }\n        return rows\n      },\n    }),\n  )\n  return items\n}\n"],"mappings":"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"}
+{"version":3,"file":"bar.js","names":["EChartsOption","echarts","CallbackDataParams","buildAxisLabelStyle","buildGridConfig","buildLegendConfig","createTooltipFormatter","createTooltipPositioner","niceNum","ZOOM_LAYOUT","OptionFactory","mergeOptions","resolveThemeColor","createItemColorResolver","positionDataZoomForLegend","BarEChartsOption","BarOptionFactoryInput","BarOptionsInput","BarWidgetData","barOptions","theme","formatter","labelFormatter","niceMin","niceMax","grid","left","parseInt","spacing","top","right","containLabel","tooltip","trigger","backgroundColor","palette","grey","borderWidth","padding","textStyle","color","common","white","fontSize","fontFamily","typography","caption","axisPointer","type","position","buildBarTooltipFormatter","legend","hasLegend","lineStyle","secondary","main","Object","values","qualitative","bold","Record","xAxis","axisLine","show","axisTick","axisLabel","margin","interval","hideOverlap","v","String","yAxis","min","extent","max","splitLine","black","divider","showMaxLabel","showMinLabel","verticalAlign","inside","value","createBarOptionFactory","options","optionsOverride","series","selection","selectionSet","length","Set","option","data","ctx","structural","Partial","seriesArr","Array","isArray","dataset","baseLegend","baseGrid","baseTooltip","baseYAxis","seriesTemplates","broadcastTemplate","liveFormatter","liveLabelFormatter","dataZoomLayout","dataZoom","fallbackBottom","bottom","baseBottom","gridBottom","sliderHeight","sliderGap","makeDimItemStyle","datums","template","baseColor","fallback","params","base","datum","name","has","modifyAlpha","map","s","source","i","overrideColor","const","datasetIndex","encode","x","y","barMaxWidth","emphasis","focus","itemStyle","item","row","raw","formattedValue","marker","seriesName","Box","Skeleton","SxProps","Theme","styles","container","display","alignItems","justifyContent","flexDirection","gap","spacing","height","grid","flex","width","bar","maxWidth","marginLeft","legend","legendItem","Record","BAR_HEIGHTS","const","BarSkeleton","$","_c","t0","Symbol","for","map","_temp","t1","_temp2","i_0","i","buildCsvDownloadItem","buildPngDownloadItem","DownloadContext","DownloadItem","BarWidgetData","BarDownloadConfigArgs","filename","getData","ctx","getCaptureEl","HTMLElement","pngPixelRatio","pngBackgroundColor","createBarDownloadConfig","args","items","push","pixelRatio","backgroundColor","getRows","data","rows","i","series","entries","d","name","value"],"sources":["../../src/widgets-v2/bar/options.ts","../../src/widgets-v2/bar/skeleton.tsx","../../src/widgets-v2/bar/download.tsx"],"sourcesContent":["import type { EChartsOption } from 'echarts'\nimport * as echarts from 'echarts'\nimport type { CallbackDataParams } from 'echarts/types/dist/shared'\nimport {\n  buildAxisLabelStyle,\n  buildGridConfig,\n  buildLegendConfig,\n  createTooltipFormatter,\n  createTooltipPositioner,\n  niceNum,\n} from '../../widgets/utils/chart-config'\nimport { ZOOM_LAYOUT } from '../actions/zoom-toggle'\nimport type { OptionFactory } from '../echart'\nimport { mergeOptions, resolveThemeColor } from '../utils'\nimport { createItemColorResolver } from '../utils/item-color'\nimport { positionDataZoomForLegend } from '../utils/data-zoom-layout'\nimport type {\n  BarEChartsOption,\n  BarOptionFactoryInput,\n  BarOptionsInput,\n  BarWidgetData,\n} from './types'\n\n/**\n * Builds the **structural** ECharts option for a bar widget — axes, grid,\n * tooltip styling, themed legend. Intentionally data-agnostic: no series,\n * no dataset, no `legend.show` (those depend on data and are added by the\n * option factory's merge phase). This separation is what lets data-side\n * pipeline transforms (Searcher, RelativeData) drive the rendered chart —\n * the merge happens at render time inside the Echart bridge.\n *\n * Styling matches the v1 `barConfig` look-and-feel: minimal axes (only\n * min/max y-labels rendered inside the plot via `niceNum`), themed tooltip,\n * scroll legend, and CARTO color palette. The y-axis min/max + label\n * formatter and the tooltip formatter are wired here for the no-data case;\n * {@link createBarOptionFactory} re-derives them at fusion time so reactive\n * formatter changes (RelativeData) and stack templates (StackToggle) flow\n * through to the chart.\n */\nexport function barOptions({\n  theme,\n  formatter,\n  labelFormatter,\n}: BarOptionsInput): BarEChartsOption {\n  // Closure shared between yAxis min/max callbacks and the label formatter,\n  // so only the rounded extents are labelled (matches v1).\n  let niceMin = 0\n  let niceMax = 1\n\n  return {\n    grid: {\n      left: parseInt(theme.spacing(1)),\n      top: parseInt(theme.spacing(3)),\n      right: parseInt(theme.spacing(1)),\n      // Default: no legend. Merger bumps this when there are >1 series.\n      ...buildGridConfig(false, theme),\n      containLabel: true,\n    },\n    tooltip: {\n      trigger: 'axis',\n      backgroundColor: theme.palette.grey[900],\n      borderWidth: 0,\n      padding: [parseInt(theme.spacing(1)), parseInt(theme.spacing(1))],\n      textStyle: {\n        color: theme.palette.common.white,\n        fontSize: 11,\n        fontFamily: theme.typography.caption.fontFamily,\n      },\n      axisPointer: { type: 'line' },\n      position: createTooltipPositioner(theme),\n      formatter: buildBarTooltipFormatter(formatter, labelFormatter),\n    },\n    // Legend styling baked here; `show` is toggled by the merger based on\n    // series count.\n    legend: {\n      ...buildLegendConfig({ hasLegend: false, labelFormatter }),\n    },\n    axisPointer: { lineStyle: { color: theme.palette.grey[400] } },\n    color: [\n      theme.palette.secondary.main,\n      ...Object.values(\n        (theme.palette as { qualitative?: { bold?: Record<string, string> } })\n          .qualitative?.bold ?? {},\n      ),\n    ],\n    xAxis: {\n      type: 'category',\n      axisLine: { show: false },\n      axisTick: { show: false },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        padding: [parseInt(theme.spacing(0.5)), 0, 0, 0],\n        margin: 0,\n        // `interval: 0` makes every category label a candidate so `hideOverlap`\n        // can pack the maximum number that physically fit; the category-axis\n        // default (`'auto'`) sub-samples first and shows fewer than fit.\n        interval: 0,\n        hideOverlap: true,\n        ...(labelFormatter && {\n          formatter: (v: string | number) => String(labelFormatter(v)),\n        }),\n      },\n    },\n    yAxis: {\n      type: 'value',\n      min: (extent: { min: number }) => {\n        niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n        return niceMin\n      },\n      max: (extent: { min: number; max: number }) => {\n        niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n        return niceMax\n      },\n      axisLine: { show: false },\n      axisTick: { show: false },\n      splitLine: {\n        show: true,\n        lineStyle: { color: theme.palette.black?.[4] ?? theme.palette.divider },\n      },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        margin: parseInt(theme.spacing(1)),\n        show: true,\n        showMaxLabel: true,\n        showMinLabel: true,\n        verticalAlign: 'bottom',\n        inside: true,\n        formatter: (value: number) => {\n          if (value !== niceMax && value !== niceMin) return ''\n          if (value === 0) return ''\n          return formatter ? formatter(value) : String(value)\n        },\n      },\n    },\n  } as BarEChartsOption\n}\n\n/**\n * Returns the bar widget's {@link OptionFactory} — a single closure that\n * handles BOTH option-construction phases:\n *\n *   - **Structural phase** (`option == null`) — builds the theme-aware\n *     structural option via {@link barOptions}, optionally merging the\n *     consumer-supplied `optionsOverride` on top. Called once by Provider\n *     to seed `rawOptions` in the store; configTransforms (StackToggle /\n *     ZoomToggle / BrushToggle) then mutate it via the pipeline middleware.\n *   - **Merge phase** (`option != null`) — fuses post-pipeline `state.data`\n *     (`BarWidgetData`) into the option via the dataset API: one dataset\n *     per series, each series referencing its dataset by index, encoded\n *     by `name` (x) and `value` (y). Spreads any series-template fields\n *     already on the incoming option (e.g. `{ stack: 'total' }` from\n *     `addStack`) into every emitted series so configTransforms compose\n *     end-to-end. Reactive `ctx.formatter` / `ctx.labelFormatter` drive\n *     the y-axis min/max-only label and the tooltip formatter at fusion\n *     time so RelativeData's percent formatter flows through without a\n *     structural rebuild.\n *\n * Stable identity when the inputs don't change (consumers should wrap the\n * call in `useMemo` keyed on the same inputs).\n */\nexport function createBarOptionFactory(\n  options: BarOptionFactoryInput,\n): OptionFactory {\n  const { theme, formatter, labelFormatter, optionsOverride } = options\n  const series = options.series\n  const selection = options.selection\n  const selectionSet =\n    selection && selection.length > 0\n      ? new Set<string | number>(selection)\n      : null\n  return (option, data, ctx) => {\n    // Structural phase: Provider seeds rawOptions with this branch. No data\n    // is read; we just emit the theme-aware base (optionally with override).\n    if (option == null) {\n      const structural = barOptions({ theme, formatter, labelFormatter })\n      return optionsOverride\n        ? (mergeOptions(\n            structural as unknown as Record<string, unknown>,\n            optionsOverride as Partial<Record<string, unknown>>,\n          ) as EChartsOption)\n        : structural\n    }\n\n    const seriesArr = Array.isArray(data) ? (data as BarWidgetData) : []\n    if (seriesArr.length === 0) {\n      return { ...option, dataset: [], series: [] }\n    }\n    const hasLegend = seriesArr.length > 1\n    const baseLegend =\n      typeof option.legend === 'object' && !Array.isArray(option.legend)\n        ? option.legend\n        : {}\n    const baseGrid =\n      typeof option.grid === 'object' && !Array.isArray(option.grid)\n        ? option.grid\n        : {}\n    const baseTooltip =\n      typeof option.tooltip === 'object' && !Array.isArray(option.tooltip)\n        ? option.tooltip\n        : {}\n    const baseYAxis =\n      typeof option.yAxis === 'object' && !Array.isArray(option.yAxis)\n        ? option.yAxis\n        : {}\n\n    const seriesTemplates = Array.isArray(option.series) ? option.series : []\n    const broadcastTemplate = seriesTemplates[0] ?? {}\n\n    // Reactive (live store) formatters from ctx — distinct from the\n    // closure-time `formatter` / `labelFormatter` captured for the\n    // structural-build branch above. RelativeData can install a percent\n    // formatter on the store after the factory was constructed; the merge\n    // phase reads `ctx` to pick that up.\n    const liveFormatter = ctx?.formatter\n    const liveLabelFormatter = ctx?.labelFormatter\n\n    // Closure shared between the yAxis min/max callbacks and the label\n    // formatter, so only the rounded extents are labelled (matches v1).\n    // Delegating the extent to ECharts (rather than precomputing scalars\n    // from the raw data) is what keeps stacked bars inside the plot: when\n    // StackToggle marks the series, ECharts feeds the *post-stack* extent\n    // to these callbacks, so `niceNum` rounds the stacked total instead of\n    // a single series.\n    let niceMin = 0\n    let niceMax = 1\n\n    // Zoom slider layout: when ZoomToggle has installed `dataZoom`, push the\n    // slider above the legend (if any) and reserve room in the grid below.\n    const dataZoomLayout = positionDataZoomForLegend(option.dataZoom, hasLegend)\n    const fallbackBottom =\n      typeof baseGrid.bottom === 'number' ? baseGrid.bottom : 24\n    const baseBottom = hasLegend ? 56 : fallbackBottom\n    const gridBottom = dataZoomLayout\n      ? baseBottom + ZOOM_LAYOUT.sliderHeight + ZOOM_LAYOUT.sliderGap\n      : baseBottom\n\n    // When a selection is active, dim non-selected bars by routing the\n    // item's base colour through `modifyAlpha`. Per-row `itemStyle` on\n    // dataset object-rows is silently ignored when `series.encode` is in\n    // play — the callback approach is the standard ECharts pattern for\n    // per-data styling derived from a dataset. The base colour is the\n    // datum's `color`, else the template's `itemStyle.color`, else the\n    // series colour / palette (`params.color`).\n    //\n    // We *always* emit `itemStyle.color` (a passthrough when nothing is\n    // selected), not conditionally — dropping the key between renders\n    // would let ECharts' default merge keep the previous callback alive\n    // and bars would stay dimmed forever after an external clear. Always\n    // emitting lets normal merge swap the callback in place, no\n    // `replaceMerge` and no entry-animation flash on selection on/off.\n    const makeDimItemStyle = (datums: readonly object[], template: unknown) => {\n      const baseColor = createItemColorResolver({\n        theme,\n        datums,\n        template,\n        fallback: (params) => params.color as string,\n      })\n      return {\n        color: (params: CallbackDataParams) => {\n          const base = baseColor(params)\n          if (!selectionSet) return base\n          const datum = params.value as { name?: string | number } | undefined\n          const name = datum?.name ?? params.name\n          return name != null && selectionSet.has(name)\n            ? base\n            : echarts.color.modifyAlpha(base, 0.15)\n        },\n      }\n    }\n\n    return {\n      ...option,\n      dataset: seriesArr.map((s) => ({ source: s as readonly object[] })),\n      series: seriesArr.map((s, i) => {\n        const template =\n          (seriesTemplates[i] as object | undefined) ??\n          (broadcastTemplate as object)\n        // Per-series `color` override: ECharts sets `params.color` from\n        // `series[i].color` when resolving styles, so the dim callback\n        // above keeps working — it just dims the user's colour rather\n        // than the palette default.\n        const overrideColor = resolveThemeColor(theme, series?.[i]?.color)\n        return {\n          ...(typeof template === 'object' ? template : {}),\n          type: 'bar' as const,\n          datasetIndex: i,\n          name: series?.[i]?.name ?? `Series ${i + 1}`,\n          encode: { x: 'name', y: 'value' },\n          barMaxWidth: 100,\n          emphasis: { focus: 'series' },\n          itemStyle: makeDimItemStyle(s, template),\n          ...(overrideColor ? { color: overrideColor } : {}),\n        }\n      }),\n      legend: { ...baseLegend, show: hasLegend },\n      grid: {\n        ...baseGrid,\n        bottom: gridBottom,\n      },\n      ...(dataZoomLayout ? { dataZoom: dataZoomLayout } : {}),\n      yAxis: {\n        ...baseYAxis,\n        min: (extent: { min: number }) => {\n          niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n          return niceMin\n        },\n        max: (extent: { min: number; max: number }) => {\n          niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n          return niceMax\n        },\n        axisLabel: {\n          ...((baseYAxis as { axisLabel?: object }).axisLabel ?? {}),\n          formatter: (value: number) => {\n            if (value !== niceMax && value !== niceMin) return ''\n            if (value === 0) return ''\n            return liveFormatter ? liveFormatter(value) : String(value)\n          },\n        },\n      } as EChartsOption['yAxis'],\n      tooltip: {\n        ...baseTooltip,\n        formatter: buildBarTooltipFormatter(liveFormatter, liveLabelFormatter),\n      },\n    } as EChartsOption\n  }\n}\n\nfunction buildBarTooltipFormatter(\n  formatter: ((value: number) => string) | undefined,\n  labelFormatter: ((value: string | number) => string | number) | undefined,\n) {\n  return createTooltipFormatter((item) => {\n    const row = item.value as { name?: string | number; value?: number }\n    const raw = row?.value\n    const formattedValue =\n      typeof raw === 'number' && formatter ? formatter(raw) : (raw ?? '')\n    const marker = typeof item.marker === 'string' ? item.marker : ''\n    const seriesName = item.seriesName ? `${item.seriesName}: ` : ''\n    const name = labelFormatter\n      ? String(labelFormatter(item.name ?? ''))\n      : (item.name ?? '')\n    return { name: String(name), seriesName, marker, value: formattedValue }\n  })\n}\n","import { Box, Skeleton, type SxProps, type Theme } from '@mui/material'\n\nconst styles = {\n  container: {\n    display: 'flex',\n    alignItems: 'center',\n    justifyContent: 'space-between',\n    flexDirection: 'column',\n    gap: ({ spacing }) => spacing(1),\n    height: ({ spacing }) => spacing(38),\n  },\n  grid: {\n    display: 'flex',\n    justifyContent: 'space-between',\n    flex: '1 1 auto',\n    alignItems: 'flex-end',\n    width: '100%',\n  },\n  bar: {\n    flex: 1,\n    maxWidth: ({ spacing }) => spacing(12),\n    '& + &': {\n      marginLeft: ({ spacing }) => spacing(1),\n    },\n  },\n  legend: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(2),\n    height: ({ spacing }) => spacing(5),\n  },\n  legendItem: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(1.5),\n  },\n} satisfies Record<string, SxProps<Theme>>\n\nconst BAR_HEIGHTS = ['20%', '40%', '60%', '20%', '80%'] as const\n\n/**\n * Loading state for the Bar widget. Mirrors a bar chart's silhouette — five\n * vertical bars at staggered heights anchored to the bottom, plus a legend\n * stub — so the skeleton reads as \"a bar chart\" rather than a generic list.\n */\nexport function BarSkeleton() {\n  return (\n    <Box sx={styles.container}>\n      <Box sx={styles.grid}>\n        {BAR_HEIGHTS.map((height, i) => (\n          <Skeleton\n            key={`bar-${i}`}\n            sx={styles.bar}\n            variant='rectangular'\n            height={height}\n          />\n        ))}\n      </Box>\n      <Box sx={styles.legend}>\n        {[0, 1].map((i) => (\n          <Box key={`legend-${i}`} sx={styles.legendItem}>\n            <Skeleton variant='circular' width={8} height={8} />\n            <Skeleton width={48} height={8} />\n          </Box>\n        ))}\n      </Box>\n    </Box>\n  )\n}\n","import {\n  buildCsvDownloadItem,\n  buildPngDownloadItem,\n  type DownloadContext,\n  type DownloadItem,\n} from '../actions/download'\nimport type { BarWidgetData } from './types'\n\nexport interface BarDownloadConfigArgs {\n  filename: string\n  getData: (ctx: DownloadContext) => BarWidgetData\n  /**\n   * Optional getter for the widget's capture element (registered by\n   * `Widget.State` on its success path). When provided, a PNG item is\n   * prepended to the returned list. Wire it to\n   * `() => getCaptureEl(id)`.\n   */\n  getCaptureEl?: (ctx: DownloadContext) => HTMLElement | null\n  /** PNG `pixelRatio` (default 2). */\n  pngPixelRatio?: number\n  /** PNG `backgroundColor` (default transparent). */\n  pngBackgroundColor?: string | null\n}\n\n/**\n * Builds download items for the Bar widget. Always includes a CSV item\n * with one `name,value` block per series, separated by an empty row when\n * there are multiple. When `getCaptureEl` is supplied, also prepends a PNG\n * item that rasterises the captured element via `html2canvas`.\n */\nexport function createBarDownloadConfig(\n  args: BarDownloadConfigArgs,\n): DownloadItem[] {\n  const items: DownloadItem[] = []\n  if (args.getCaptureEl) {\n    items.push(\n      buildPngDownloadItem({\n        filename: args.filename,\n        getCaptureEl: args.getCaptureEl,\n        pixelRatio: args.pngPixelRatio,\n        backgroundColor: args.pngBackgroundColor,\n      }),\n    )\n  }\n  items.push(\n    buildCsvDownloadItem({\n      filename: args.filename,\n      getRows: (ctx) => {\n        const data = args.getData(ctx)\n        const rows: unknown[][] = []\n        for (const [i, series] of data.entries()) {\n          if (i > 0) rows.push([])\n          rows.push(['name', 'value'])\n          for (const d of series) rows.push([d.name, d.value])\n        }\n        return rows\n      },\n    }),\n  )\n  return items\n}\n"],"mappings":"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"}

package/dist/widgets-v2/category.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../category-Ca5XDx0N.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../category-DuKx_CJX.js";
 export { o as Category, r as CategoryBar, e as CategoryLegend, s as CategoryRowMulti, a as CategoryRowOther, t as CategoryRowSingle, i as CategorySkeleton, n as CategoryUI, c as createCategoryDownloadConfig };