@carto/ps-react-ui 4.25.0 → 4.27.0

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

@@ -96,12 +96,12 @@ export type { ToolboxLabels } from './toolbox/labels.js';
 export type { EchartProps, EchartUIProps, EchartsEventHandler } from './echart/index.js';
 export type { NoteProps, NoteMarkdownProps } from './note/widget-note.js';
 export type { NoteLabels } from './note/labels.js';
-export type { SearcherProps, SearcherToggleProps, StackToggleProps, ShowAllToggleProps, ZoomToggleProps, BrushToggleProps, RelativeDataProps, DownloadProps, DownloadItem, DownloadContext, FullScreenTriggerProps, FullScreenSlotProps, LockSelectionProps, LockSelectionKey, ChangeColumnProps, ChangeColumnItem, } from './actions/index.js';
+export type { SearcherProps, SearcherToggleProps, StackToggleProps, ShowAllToggleProps, ZoomToggleProps, BrushToggleProps, RelativeDataProps, RelativeScale, DownloadProps, DownloadItem, DownloadContext, FullScreenTriggerProps, FullScreenSlotProps, LockSelectionProps, LockSelectionKey, ChangeColumnProps, ChangeColumnItem, } from './actions/index.js';
 export type { FormulaUIProps, FormulaDataItem, FormulaWidgetData, } from './formula/index.js';
 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-DON6fSCh.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

@@ -1,20 +1,22 @@
 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 { n as t } from "../scale-0elCv3tk.js";
+import { n, t as r } from "../download--wRRnf19.js";
+import { n as i, r as a, t as o } from "../utils-ClB6nn4w.js";
+import { a as s, d as c, f as l, i as u, s as d, u as f } from "../chart-config-BWxjodlt.js";
+import { t as p } from "../item-color-C1cu6EJd.js";
+import { c as m } from "react/compiler-runtime";
+import { Box as h, Skeleton as g } from "@mui/material";
+import { jsx as _, jsxs as v } from "react/jsx-runtime";
+import * as y from "echarts";
 //#region src/widgets-v2/bar/options.ts
-function v({ theme: e, formatter: t, labelFormatter: n }) {
+function b({ theme: e, formatter: t, labelFormatter: n }) {
 	let r = 0, i = 1;
 	return {
 		grid: {
 			left: parseInt(e.spacing(1)),
 			top: parseInt(e.spacing(3)),
 			right: parseInt(e.spacing(1)),
-			...o(!1, e),
+			...s(!1, e),
 			containLabel: !0
 		},
 		tooltip: {
@@ -28,10 +30,10 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 				fontFamily: e.typography.caption.fontFamily
 			},
 			axisPointer: { type: "line" },
-			position: s(e),
-			formatter: b(t, n)
+			position: c(e),
+			formatter: S(t, n)
 		},
-		legend: { ...u({
+		legend: { ...d({
 			hasLegend: !1,
 			labelFormatter: n
 		}) },
@@ -42,7 +44,7 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 			axisLine: { show: !1 },
 			axisTick: { show: !1 },
 			axisLabel: {
-				...l(e),
+				...u(e),
 				padding: [
 					parseInt(e.spacing(.5)),
 					0,
@@ -57,8 +59,8 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 		},
 		yAxis: {
 			type: "value",
-			min: (e) => (r = e.min < 0 ? c(e.min) : 0, r),
-			max: (e) => (i = e.max <= 0 ? 1 : c(e.max), i),
+			min: (e) => (r = e.min < 0 ? l(e.min) : 0, r),
+			max: (e) => (i = e.max <= 0 ? 1 : l(e.max), i),
 			axisLine: { show: !1 },
 			axisTick: { show: !1 },
 			splitLine: {
@@ -66,7 +68,7 @@ function v({ theme: e, formatter: t, labelFormatter: n }) {
 				lineStyle: { color: e.palette.black?.[4] ?? e.palette.divider }
 			},
 			axisLabel: {
-				...l(e),
+				...u(e),
 				margin: parseInt(e.spacing(1)),
 				show: !0,
 				showMaxLabel: !0,
@@ -78,76 +80,84 @@ 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) => {
-		if (t == null) {
-			let e = v({
-				theme: n,
-				formatter: o,
-				labelFormatter: s
+function x(n) {
+	let { theme: r, formatter: s, labelFormatter: c, optionsOverride: u } = n, d = n.series, f = n.selection, m = f && f.length > 0 ? new Set(f) : null;
+	return (n, f, h) => {
+		if (n == null) {
+			let e = b({
+				theme: r,
+				formatter: s,
+				labelFormatter: c
 			});
-			return l ? i(e, l) : e;
+			return u ? a(e, u) : e;
 		}
-		let m = Array.isArray(d) ? d : [];
-		if (m.length === 0) return {
-			...t,
+		let g = Array.isArray(f) ? f : [];
+		if (g.length === 0) return {
+			...n,
 			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.length > 1, v = typeof n.legend == "object" && !Array.isArray(n.legend) ? n.legend : {}, x = typeof n.grid == "object" && !Array.isArray(n.grid) ? n.grid : {}, C = typeof n.tooltip == "object" && !Array.isArray(n.tooltip) ? n.tooltip : {}, w = typeof n.yAxis == "object" && !Array.isArray(n.yAxis) ? n.yAxis : {}, T = t(w), E = Array.isArray(n.series) ? n.series : [], D = E[0] ?? {}, O = h?.formatter, k = h?.labelFormatter, A = 0, j = 1, M = i(n.dataZoom, _), N = typeof x.bottom == "number" ? x.bottom : 24, P = _ ? 56 : N, F = M ? P + e.sliderHeight + e.sliderGap : P, I = (e, t) => {
+			let n = p({
+				theme: r,
+				datums: e,
+				template: t,
+				fallback: (e) => e.color
+			});
+			return { color: (e) => {
+				let t = n(e);
+				if (!m) return t;
+				let r = e.value?.name ?? e.name;
+				return r != null && m.has(r) ? t : y.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);
+			...n,
+			dataset: g.map((e) => ({ source: e })),
+			series: g.map((e, t) => {
+				let n = E[t] ?? D, i = o(r, d?.[t]?.color);
 				return {
-					...typeof r == "object" ? r : {},
+					...typeof n == "object" ? n : {},
 					type: "bar",
 					datasetIndex: t,
-					name: u?.[t]?.name ?? `Series ${t + 1}`,
+					name: d?.[t]?.name ?? `Series ${t + 1}`,
 					encode: {
 						x: "name",
 						y: "value"
 					},
 					barMaxWidth: 100,
 					emphasis: { focus: "series" },
-					itemStyle: N,
+					itemStyle: I(e, n),
 					...i ? { color: i } : {}
 				};
 			}),
 			legend: {
-				...g,
-				show: h
+				...v,
+				show: _
 			},
 			grid: {
-				...y,
-				bottom: M
+				...x,
+				bottom: F
 			},
-			...k ? { dataZoom: k } : {},
+			...M ? { dataZoom: M } : {},
 			yAxis: {
-				...S,
-				min: (e) => (D = e.min < 0 ? c(e.min) : 0, D),
-				max: (e) => (O = e.max <= 0 ? 1 : c(e.max), O),
+				...w,
+				min: (e) => (A = e.min < 0 ? T.min ?? l(e.min) : 0, A),
+				max: (e) => (j = e.max <= 0 ? 1 : T.max ?? l(e.max), j),
 				axisLabel: {
-					...S.axisLabel ?? {},
-					formatter: (e) => e !== O && e !== D || e === 0 ? "" : T ? T(e) : String(e)
+					...w.axisLabel ?? {},
+					formatter: (e) => e !== j && e !== A || e === 0 ? "" : O ? O(e) : String(e)
 				}
 			},
 			tooltip: {
-				...x,
-				formatter: b(T, E)
+				...C,
+				formatter: S(O, k)
 			}
 		};
 	};
 }
-function b(e, t) {
-	return d((n) => {
+function S(e, t) {
+	return f((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 {
 			name: String(s),
@@ -159,7 +169,7 @@ function b(e, t) {
 }
 //#endregion
 //#region src/widgets-v2/bar/skeleton.tsx
-var x = {
+var C = {
 	container: {
 		display: "flex",
 		alignItems: "center",
@@ -191,58 +201,58 @@ var x = {
 		alignItems: "center",
 		gap: ({ spacing: e }) => e(1.5)
 	}
-}, S = [
+}, w = [
 	"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 T() {
+	let e = m(2), t;
+	e[0] === Symbol.for("react.memo_cache_sentinel") ? (t = /* @__PURE__ */ _(h, {
+		sx: C.grid,
+		children: w.map(D)
 	}), 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__ */ v(h, {
+		sx: C.container,
+		children: [t, /* @__PURE__ */ _(h, {
+			sx: C.legend,
+			children: [0, 1].map(E)
 		})]
 	}), e[1] = n) : n = e[1], n;
 }
-function w(e) {
-	return /* @__PURE__ */ g(p, {
-		sx: x.legendItem,
-		children: [/* @__PURE__ */ h(m, {
+function E(e) {
+	return /* @__PURE__ */ v(h, {
+		sx: C.legendItem,
+		children: [/* @__PURE__ */ _(g, {
 			variant: "circular",
 			width: 8,
 			height: 8
-		}), /* @__PURE__ */ h(m, {
+		}), /* @__PURE__ */ _(g, {
 			width: 48,
 			height: 8
 		})]
 	}, `legend-${e}`);
 }
-function T(e, t) {
-	return /* @__PURE__ */ h(m, {
-		sx: x.bar,
+function D(e, t) {
+	return /* @__PURE__ */ _(g, {
+		sx: C.bar,
 		variant: "rectangular",
 		height: e
 	}, `bar-${t}`);
 }
 //#endregion
 //#region src/widgets-v2/bar/download.tsx
-function E(e) {
-	let r = [];
-	return e.getCaptureEl && r.push(t({
+function O(e) {
+	let t = [];
+	return e.getCaptureEl && t.push(n({
 		filename: e.filename,
 		getCaptureEl: e.getCaptureEl,
 		pixelRatio: e.pngPixelRatio,
 		backgroundColor: e.pngBackgroundColor
-	})), r.push(n({
+	})), t.push(r({
 		filename: e.filename,
 		getRows: (t) => {
 			let n = e.getData(t), r = [];
@@ -252,9 +262,9 @@ function E(e) {
 			}
 			return r;
 		}
-	})), r;
+	})), t;
 }
 //#endregion
-export { C as BarSkeleton, v as barOptions, E as createBarDownloadConfig, y as createBarOptionFactory };
+export { T as BarSkeleton, b as barOptions, O as createBarDownloadConfig, x 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","fixedAxisBounds","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","fixedY","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'\nimport { fixedAxisBounds } from '../actions/relative-data/scale'\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    const fixedY = fixedAxisBounds(baseYAxis)\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        // A config transform (RelativeData's `'total'` scale) may pin the\n        // ends; each applies only on the side the data reaches.\n        min: (extent: { min: number }) => {\n          niceMin = extent.min < 0 ? (fixedY.min ?? niceNum(extent.min)) : 0\n          return niceMin\n        },\n        max: (extent: { min: number; max: number }) => {\n          niceMax = extent.max <= 0 ? 1 : (fixedY.max ?? 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-DuKx_CJX.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-BoT5FHHp.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 };