@carto/ps-react-ui 5.0.0-widgets.8 → 5.0.0

package/dist/types/widgets-v2/wrapper/widget-wrapper.d.ts

@@ -0,0 +1,56 @@
+import { ComponentType, ReactNode } from 'react';
+import { SvgIconProps, SxProps, Theme } from '@mui/material';
+import { WrapperLabels } from './labels.js';
+export interface WrapperProps {
+    title: string;
+    /**
+     * Controlled collapsed state. When supplied, the wrapper is fully
+     * controlled — the consumer is responsible for updating it via
+     * `onCollapseChange`. Leave undefined to use the uncontrolled mode,
+     * which seeds internal state from `defaultCollapsed`.
+     */
+    collapsed?: boolean;
+    /**
+     * Fires whenever the user interacts to toggle the wrapper, with the
+     * NEXT collapsed value. Called for both controlled and uncontrolled
+     * usage — consumers can subscribe to user-driven toggles even when
+     * letting the wrapper manage its own state.
+     */
+    onCollapseChange?: (collapsed: boolean) => void;
+    /**
+     * Initial collapsed state when the wrapper is uncontrolled (i.e.
+     * `collapsed` is undefined). Ignored when `collapsed` is supplied.
+     */
+    defaultCollapsed?: boolean;
+    disabled?: boolean;
+    /**
+     * Visual variant. `'elevation'` (default) renders a borderless shell;
+     * `'outlined'` adds a 1px divider border around the card.
+     */
+    variant?: 'outlined' | 'elevation';
+    labels?: Partial<WrapperLabels>;
+    /**
+     * Icon shown at the right edge of the summary row. Accordion rotates it
+     * 180° automatically when the wrapper expands. Default: `ExpandMoreIcon`.
+     */
+    expandIcon?: ComponentType<SvgIconProps>;
+    iconProps?: SvgIconProps;
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+/**
+ * Widget shell — title + collapsible body, built on MUI `<Accordion>` for
+ * native click-to-toggle on the summary header and a smooth open/close
+ * transition. UX matches v1 `<WrapperUI>`:
+ *
+ *   • hover-fade action buttons (always visible on coarse-pointer devices)
+ *   • multi-line title clamp (`WebkitLineClamp: 2`, word-break) + SmartTooltip
+ *     when the text overflows
+ *   • top-edge `<LinearProgress>` driven by the widget store's `isFetching`
+ *   • chevron at the right end (rotated by Accordion based on expanded state)
+ *
+ * Children are partitioned by component identity: `<Actions>` and `<Options>`
+ * render inside the summary row; everything else (`<Content>`, `<Footer>`,
+ * loose nodes) renders inside the details panel.
+ */
+export declare function Wrapper({ title, collapsed, onCollapseChange, defaultCollapsed, disabled, variant, labels, expandIcon: ExpandIcon, iconProps, sx, children, }: WrapperProps): import('react').JSX.Element;

package/dist/use-widget-selector-VSPhfhNm.js

@@ -0,0 +1,12 @@
+import { t as e } from "./widget-store-BFPKYm4R.js";
+import { c as t } from "react/compiler-runtime";
+import { useShallow as n } from "zustand/shallow";
+//#region src/widgets/stores/use-widget-selector.ts
+function r(r, i) {
+	let a = t(3), o;
+	return a[0] !== i || a[1] !== r ? (o = (e) => i(e.widgets[r]), a[0] = i, a[1] = r, a[2] = o) : o = a[2], e(n(o));
+}
+//#endregion
+export { r as t };
+
+//# sourceMappingURL=use-widget-selector-VSPhfhNm.js.map

package/dist/use-widget-selector-VSPhfhNm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-widget-selector-VSPhfhNm.js","names":["(state: { widgets: Record<string, WidgetState> }) =>\n      selector(state.widgets[widgetId])"],"sources":["../src/widgets/stores/use-widget-selector.ts"],"sourcesContent":["import { useWidgetStore } from './widget-store'\nimport type { WidgetState } from './types'\nimport { useShallow } from 'zustand/shallow'\n\n/**\n * Scoped selector hook for reading a single widget's state from the store.\n *\n * Consolidates multiple `useWidgetStore(useShallow(...))` calls into a single\n * subscription per component. The selector receives only this widget's state\n * (or undefined if not yet registered), and uses shallow comparison to avoid\n * re-renders when unrelated properties change.\n *\n * @param widgetId - The widget ID to subscribe to.\n * @param selector - A function that extracts the needed properties from the widget state.\n *   Must be a stable reference (inline arrow is fine due to useCallback wrapping).\n *\n * @example\n * ```tsx\n * // Before: 4 separate subscriptions\n * const title = useWidgetStore(useShallow((s) => s.getWidget(id)?.title))\n * const collapsed = useWidgetStore(useShallow((s) => s.getWidget(id)?.collapsed))\n * const disabled = useWidgetStore(useShallow((s) => s.getWidget(id)?.disabled))\n * const isFetching = useWidgetStore(useShallow((s) => s.getWidget(id)?.isFetching))\n *\n * // After: 1 subscription\n * const { title, collapsed, disabled, isFetching } = useWidgetSelector(id, (w) => ({\n *   title: w?.title, collapsed: w?.collapsed, disabled: w?.disabled, isFetching: w?.isFetching,\n * }))\n *\n * // With extra dependencies (e.g., index prop):\n * const value = useWidgetSelector(\n *   id,\n *   (w) => (w as MyState | undefined)?.data?.[index]?.value,\n *   [index],\n * )\n * ```\n */\nexport function useWidgetSelector<T>(\n  widgetId: string,\n  selector: (widget: WidgetState | undefined) => T,\n): T {\n  return useWidgetStore(\n    useShallow((state: { widgets: Record<string, WidgetState> }) =>\n      selector(state.widgets[widgetId]),\n    ),\n  )\n}\n"],"mappings":";;;;AAqCA,SAAgB,EACd,GACA,GACG;eAEUA;CADb,OAEI,EAAA,OAAA,KAAA,EAAA,OAAuB,KADd,KAAC,MACV,EAAS,EAAM,QAAQ,EAAS,GAAhC,EAAA,KAAA,GAAuB,EAAA,KAAA,yBAFpB,EACL,EAAWA,CAEX,CACF;AACF"}

package/dist/utils-Dr6gf3vD.js

@@ -0,0 +1,58 @@
+import { r as e } from "./zoom-toggle-IsF8BnAp.js";
+//#region src/widgets-v2/utils/merge-options.ts
+function t(e, t) {
+	if (!t) return e;
+	let r = { ...e };
+	for (let i of Object.keys(t)) {
+		let a = e[i], o = t[i];
+		o !== void 0 && (r[i] = n(a, o));
+	}
+	return r;
+}
+function n(e, t) {
+	if (Array.isArray(e) && Array.isArray(t)) {
+		let r = Math.max(e.length, t.length), i = Array(r);
+		for (let a = 0; a < r; a++) {
+			let r = e[a], o = t[a];
+			o === void 0 ? i[a] = r : r === void 0 ? i[a] = o : i[a] = n(r, o);
+		}
+		return i;
+	}
+	return r(e) && r(t) ? {
+		...e,
+		...t
+	} : t;
+}
+function r(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+}
+//#endregion
+//#region src/widgets-v2/utils/data-zoom-layout.ts
+function i(t, n) {
+	return !Array.isArray(t) || t.length === 0 ? null : t.map((t) => {
+		if (typeof t != "object" || !t) return t;
+		let r = t;
+		return r.type === "slider" && n ? {
+			...r,
+			bottom: e.sliderBottomWithLegend
+		} : r;
+	});
+}
+//#endregion
+//#region src/widgets-v2/utils/resolve-theme-color.ts
+function a(e, t) {
+	if (t == null) return;
+	if (!t.includes(".")) return t;
+	let n = t.split("."), r = e.palette;
+	for (let e of n) {
+		if (typeof r != "object" || !r) return t;
+		r = r[e];
+	}
+	return typeof r == "string" ? r : t;
+}
+//#endregion
+export { i as n, t as r, a as t };
+
+//# sourceMappingURL=utils-Dr6gf3vD.js.map

package/dist/utils-Dr6gf3vD.js.map

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

package/dist/widget-store-BFPKYm4R.js

@@ -0,0 +1,187 @@
+import { create as e } from "zustand";
+//#region src/widgets/stores/widget-store.ts
+var t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), r = e()((e, r) => ({
+	widgets: {},
+	setWidget: (t, n) => {
+		e((e) => {
+			let r = e.widgets[t] ?? {};
+			return { widgets: {
+				...e.widgets,
+				[t]: {
+					...r,
+					...n,
+					id: t
+				}
+			} };
+		});
+	},
+	removeWidget: (t) => e((e) => {
+		let n = { ...e.widgets };
+		return delete n[t], { widgets: n };
+	}),
+	clearWidgets: () => e({ widgets: {} }),
+	getWidget: (e) => r().widgets[e],
+	registerTool: (t, n) => {
+		let i = r().widgets[t]?.registeredTools?.find((e) => e.id === n.id);
+		if (i?.order === n.order && i.enabled === n.enabled && i.type === n.type && i.disables === n.disables) {
+			i.fn = n.fn;
+			return;
+		}
+		e((e) => {
+			let r = e.widgets[t] ?? {}, i = (r.registeredTools ?? []).filter((e) => e.id !== n.id);
+			return { widgets: {
+				...e.widgets,
+				[t]: {
+					...r,
+					id: t,
+					registeredTools: [...i, n]
+				}
+			} };
+		});
+	},
+	unregisterTool: (t, n) => e((e) => {
+		let r = e.widgets[t];
+		if (!r) return e;
+		let i = (r.registeredTools ?? []).filter((e) => e.id !== n);
+		return { widgets: {
+			...e.widgets,
+			[t]: {
+				...r,
+				registeredTools: i
+			}
+		} };
+	}),
+	triggerToolPipeline: (t) => e((e) => {
+		let n = e.widgets[t];
+		return n ? { widgets: {
+			...e.widgets,
+			[t]: {
+				...n,
+				registeredTools: [...n.registeredTools ?? []]
+			}
+		} } : e;
+	}),
+	setToolEnabled: (t, n, i) => {
+		let a = r().widgets[t];
+		a && a.registeredTools?.find((e) => e.id === n)?.enabled === i || e((e) => {
+			let r = e.widgets[t];
+			if (!r) return e;
+			let a = (r.registeredTools ?? []).map((e) => e.id === n ? {
+				...e,
+				enabled: i
+			} : e);
+			return { widgets: {
+				...e.widgets,
+				[t]: {
+					...r,
+					registeredTools: a
+				}
+			} };
+		});
+	},
+	executeToolPipeline: async (n, i) => {
+		let a = r().widgets[n];
+		if (!a) return;
+		let o = (t.get(n) ?? 0) + 1;
+		t.set(n, o);
+		let s = a, c = /* @__PURE__ */ new Set();
+		for (let e of s.registeredTools ?? []) e.enabled && e.disables && e.disables.forEach((e) => c.add(e));
+		let l = [...s.registeredTools ?? []].filter((e) => (e.type ?? "data") === "data" && e.enabled && !c.has(e.id)).sort((e, t) => e.order - t.order), u = i;
+		for (let e of l) {
+			if (t.get(n) !== o) return;
+			try {
+				u = await e.fn(u);
+			} catch (t) {
+				console.error(`Tool ${e.id} failed for widget ${n}:`, t);
+			}
+		}
+		let d = r().widgets[n];
+		if (d && Object.is(d.data, u) && Object.is(d.sourceData, i)) {
+			t.get(n) === o && t.delete(n);
+			return;
+		}
+		e((e) => {
+			let t = e.widgets[n];
+			return t ? { widgets: {
+				...e.widgets,
+				[n]: {
+					...t,
+					sourceData: i,
+					data: u
+				}
+			} } : e;
+		}), t.get(n) === o && t.delete(n);
+	},
+	executeConfigPipeline: async (t, i) => {
+		let a = r().widgets[t];
+		if (!a) return;
+		let o = (n.get(t) ?? 0) + 1;
+		n.set(t, o);
+		let s = /* @__PURE__ */ new Set();
+		for (let e of a.registeredTools ?? []) e.enabled && e.disables && e.disables.forEach((e) => s.add(e));
+		let c = [...a.registeredTools ?? []].filter((e) => e.type === "config" && e.enabled && !s.has(e.id)).sort((e, t) => e.order - t.order), l = i;
+		for (let e of c) {
+			if (n.get(t) !== o) return;
+			try {
+				l = await e.fn(l);
+			} catch (n) {
+				console.error(`Config tool ${e.id} failed for widget ${t}:`, n);
+			}
+		}
+		let u = i, d = l, f = r().widgets[t], p = f?._lastConfig, m = {};
+		for (let e of Object.keys(d)) {
+			let t = !Object.is(d[e], u[e]), n = !p || !(e in p), r = !n && Object.is(f[e], p[e]);
+			(t || n || r) && (m[e] = d[e]);
+		}
+		if (!Object.keys(m).some((e) => !Object.is(f?.[e], m[e])) && Object.is(l, p)) {
+			n.get(t) === o && n.delete(t);
+			return;
+		}
+		e((e) => {
+			let n = e.widgets[t];
+			return n ? { widgets: {
+				...e.widgets,
+				[t]: {
+					...n,
+					...m,
+					_lastConfig: l
+				}
+			} } : e;
+		}), n.get(t) === o && n.delete(t);
+	}
+})), i = {
+	get setWidget() {
+		return r.getState().setWidget;
+	},
+	get removeWidget() {
+		return r.getState().removeWidget;
+	},
+	get clearWidgets() {
+		return r.getState().clearWidgets;
+	},
+	get getWidget() {
+		return r.getState().getWidget;
+	},
+	get registerTool() {
+		return r.getState().registerTool;
+	},
+	get unregisterTool() {
+		return r.getState().unregisterTool;
+	},
+	get setToolEnabled() {
+		return r.getState().setToolEnabled;
+	},
+	get triggerToolPipeline() {
+		return r.getState().triggerToolPipeline;
+	},
+	get executeToolPipeline() {
+		return r.getState().executeToolPipeline;
+	},
+	get executeConfigPipeline() {
+		return r.getState().executeConfigPipeline;
+	}
+};
+//#endregion
+export { i as n, r as t };
+
+//# sourceMappingURL=widget-store-BFPKYm4R.js.map

package/dist/widget-store-BFPKYm4R.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-store-BFPKYm4R.js","names":[],"sources":["../src/widgets/stores/widget-store.ts"],"sourcesContent":["import { create } from 'zustand'\nimport type {\n  WidgetState,\n  WidgetStore,\n  ToolRegistration,\n  WidgetStoreActions,\n} from './types'\n\n// Track active pipeline executions for cancellation\nconst activePipelines = new Map<string, number>()\nconst activeConfigPipelines = new Map<string, number>()\n\n/**\n * Zustand store for managing widget state across the application.\n *\n * Provides centralized state management for all widget UI components, including\n * data/config transformation pipelines via registered tools.\n *\n * **Performance optimizations:**\n * - `registerTool` skips the store update when structural properties (order, enabled,\n *   type, disables) haven't changed — only `fn` is updated via direct mutation,\n *   avoiding a new `registeredTools` array reference and WidgetLoader pipeline cascades.\n * - `setToolEnabled` skips the store update when the enabled state is already the\n *   requested value.\n * - `executeToolPipeline` / `executeConfigPipeline` skip the final `set()` when\n *   the transformed data/config is referentially identical to what's already in the store.\n * - Both pipelines support cancellation — newer executions for the same widget\n *   automatically cancel in-progress ones.\n *\n * @example Reading widget state (prefer useWidgetSelector for performance)\n * ```tsx\n * import { useWidgetSelector } from '@carto/ps-react-ui/widgets'\n *\n * function MyWidget({ id }: { id: string }) {\n *   const { title, data } = useWidgetSelector(id, (w) => ({\n *     title: w?.title,\n *     data: w?.data,\n *   }))\n *   return <div>{title}: {JSON.stringify(data)}</div>\n * }\n * ```\n *\n * @example Writing widget state\n * ```tsx\n * import { widgetStoreActions } from '@carto/ps-react-ui/widgets'\n *\n * const { setWidget } = widgetStoreActions\n * setWidget('my-widget', { type: 'formula', isLoading: false, data: { value: 1000 } })\n * ```\n */\nexport const useWidgetStore = create<WidgetStore>()((set, get) => ({\n  // State\n  widgets: {},\n\n  // Actions\n\n  /** Merges partial state into the widget entry. Creates the widget if it doesn't exist. */\n  setWidget: (id, widget) => {\n    set((state) => {\n      const prev = state.widgets[id] ?? ({} as WidgetStore['widgets'][string])\n      return {\n        widgets: {\n          ...state.widgets,\n          [id]: {\n            ...prev,\n            ...widget,\n            id,\n          },\n        },\n      }\n    })\n  },\n\n  removeWidget: (id) =>\n    set((state) => {\n      const widgets = { ...state.widgets }\n\n      delete widgets[id]\n\n      return { widgets }\n    }),\n\n  clearWidgets: () =>\n    set({\n      widgets: {},\n    }),\n\n  getWidget: <T extends WidgetState>(id: string) => {\n    return get().widgets[id] as T | undefined\n  },\n\n  /**\n   * Registers a transformation tool for a widget's data or config pipeline.\n   *\n   * **No-op optimization:** When a tool with the same `id` already exists and its\n   * structural properties (`order`, `enabled`, `type`, `disables`) are unchanged,\n   * only `fn` is updated via direct mutation — no store update is triggered. This\n   * allows action components to include all reactive dependencies in their\n   * `useEffect` arrays without causing WidgetLoader pipeline cascades.\n   */\n  registerTool: (widgetId: string, tool: ToolRegistration) => {\n    const current = get().widgets[widgetId]\n    const existingTool = current?.registeredTools?.find(\n      (t: ToolRegistration) => t.id === tool.id,\n    )\n\n    // No-op: structural properties unchanged — update fn via direct mutation.\n    // Safe because fn is only consumed imperatively during pipeline execution.\n    if (\n      existingTool?.order === tool.order &&\n      existingTool.enabled === tool.enabled &&\n      existingTool.type === tool.type &&\n      existingTool.disables === tool.disables\n    ) {\n      existingTool.fn = tool.fn\n      return\n    }\n\n    set((state) => {\n      const widget = state.widgets[widgetId] ?? ({} as WidgetState)\n      const registeredTools = widget.registeredTools ?? []\n\n      // Remove existing tool with same id if present\n      const filteredTools = registeredTools.filter(\n        (t: ToolRegistration) => t.id !== tool.id,\n      )\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...widget,\n            id: widgetId,\n            registeredTools: [...filteredTools, tool],\n          },\n        },\n      }\n    })\n  },\n\n  unregisterTool: (widgetId: string, toolId: string) =>\n    set((state) => {\n      const current = state.widgets[widgetId]\n      if (!current) return state\n\n      const registeredTools = current.registeredTools ?? []\n      const filteredTools = registeredTools.filter(\n        (t: ToolRegistration) => t.id !== toolId,\n      )\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...current,\n            registeredTools: filteredTools,\n          },\n        },\n      }\n    }),\n\n  /**\n   * Triggers pipeline re-execution by creating a new `registeredTools` reference.\n   * This is a lightweight operation that only bumps the array reference without\n   * modifying any tool.\n   */\n  triggerToolPipeline: (widgetId: string) =>\n    set((state) => {\n      const widget = state.widgets[widgetId]\n      if (!widget) return state\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...widget,\n            registeredTools: [...(widget.registeredTools ?? [])],\n          },\n        },\n      }\n    }),\n\n  /**\n   * Updates a tool's enabled state.\n   *\n   * **No-op optimization:** Skips the store update if the tool already has the\n   * requested enabled value.\n   */\n  setToolEnabled: (widgetId: string, toolId: string, enabled: boolean) => {\n    const current = get().widgets[widgetId]\n    if (current) {\n      const tool = current.registeredTools?.find(\n        (t: ToolRegistration) => t.id === toolId,\n      )\n      if (tool?.enabled === enabled) return\n    }\n\n    set((state) => {\n      const widget = state.widgets[widgetId]\n      if (!widget) return state\n\n      const registeredTools = widget.registeredTools ?? []\n      const updatedTools = registeredTools.map((tool: ToolRegistration) =>\n        tool.id === toolId ? { ...tool, enabled } : tool,\n      )\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...widget,\n            registeredTools: updatedTools,\n          },\n        },\n      }\n    })\n  },\n\n  /**\n   * Executes the data transformation pipeline for a widget.\n   *\n   * Filters to enabled data-type tools (respecting `disables`), sorts by `order`,\n   * and chains their `fn` calls. Supports async tools.\n   *\n   * **Cancellation:** Newer executions for the same widget automatically cancel\n   * in-progress ones via a version counter.\n   *\n   * **No-op optimization:** Skips the final `set()` if the transformed data is\n   * referentially identical (`Object.is`) to what's already in the store.\n   */\n  executeToolPipeline: async (widgetId: string, sourceData: unknown) => {\n    const widget = get().widgets[widgetId]\n    if (!widget) return\n\n    // Cancel any in-progress pipeline for this widget\n    const currentExecution = (activePipelines.get(widgetId) ?? 0) + 1\n    activePipelines.set(widgetId, currentExecution)\n\n    const widgetWithTools = widget\n\n    // Build set of tool IDs that should be disabled\n    const disabledToolIds = new Set<string>()\n    for (const tool of widgetWithTools.registeredTools ?? []) {\n      if (tool.enabled && tool.disables) {\n        tool.disables.forEach((id) => disabledToolIds.add(id))\n      }\n    }\n\n    // Sort tools by order and filter enabled data-only tools, excluding disabled tools\n    const sortedTools = [...(widgetWithTools.registeredTools ?? [])]\n      .filter(\n        (tool) =>\n          (tool.type ?? 'data') === 'data' &&\n          tool.enabled &&\n          !disabledToolIds.has(tool.id),\n      )\n      .sort((a, b) => a.order - b.order)\n\n    // Execute pipeline - handle both sync and async tools\n    let transformedData = sourceData\n    for (const tool of sortedTools) {\n      // Check if this execution was cancelled\n      if (activePipelines.get(widgetId) !== currentExecution) {\n        return\n      }\n\n      try {\n        // Call tool function (may return Promise or direct value)\n        transformedData = await tool.fn(transformedData)\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(`Tool ${tool.id} failed for widget ${widgetId}:`, error)\n        // Continue with current data to prevent one tool from breaking all\n      }\n    }\n\n    // Skip store update if neither data nor sourceData changed\n    const widgetAfter = get().widgets[widgetId]\n    if (\n      widgetAfter &&\n      Object.is(widgetAfter.data, transformedData) &&\n      Object.is(widgetAfter.sourceData, sourceData)\n    ) {\n      if (activePipelines.get(widgetId) === currentExecution) {\n        activePipelines.delete(widgetId)\n      }\n      return\n    }\n\n    // Single store update with final transformed data\n    set((state) => {\n      const currentWidget = state.widgets[widgetId]\n      if (!currentWidget) return state\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...currentWidget,\n            sourceData,\n            data: transformedData,\n          },\n        },\n      }\n    })\n\n    // Clean up tracking\n    if (activePipelines.get(widgetId) === currentExecution) {\n      activePipelines.delete(widgetId)\n    }\n  },\n\n  /**\n   * Executes the config transformation pipeline for a widget.\n   *\n   * Filters to enabled config-type tools (respecting `disables`), sorts by `order`,\n   * and chains their `fn` calls. The transformed config is spread into the widget state.\n   *\n   * **Cancellation:** Newer executions for the same widget automatically cancel\n   * in-progress ones via a version counter.\n   *\n   * **No-op optimization:** Skips the final `set()` when the config object is unchanged\n   * and all its properties already match what's in the store.\n   */\n  executeConfigPipeline: async (widgetId: string, baseConfig: object) => {\n    const widget = get().widgets[widgetId]\n    if (!widget) return\n\n    // Cancel any in-progress config pipeline for this widget\n    const currentExecution = (activeConfigPipelines.get(widgetId) ?? 0) + 1\n    activeConfigPipelines.set(widgetId, currentExecution)\n\n    // Build set of tool IDs that should be disabled (cross-type disabling works)\n    const disabledToolIds = new Set<string>()\n    for (const tool of widget.registeredTools ?? []) {\n      if (tool.enabled && tool.disables) {\n        tool.disables.forEach((id) => disabledToolIds.add(id))\n      }\n    }\n\n    // Filter to config tools only, sort by order\n    const sortedTools = [...(widget.registeredTools ?? [])]\n      .filter(\n        (tool) =>\n          tool.type === 'config' &&\n          tool.enabled &&\n          !disabledToolIds.has(tool.id),\n      )\n      .sort((a, b) => a.order - b.order)\n\n    // Chain config tools\n    let transformedConfig: unknown = baseConfig\n    for (const tool of sortedTools) {\n      if (activeConfigPipelines.get(widgetId) !== currentExecution) {\n        return\n      }\n\n      try {\n        transformedConfig = await tool.fn(transformedConfig)\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\n          `Config tool ${tool.id} failed for widget ${widgetId}:`,\n          error,\n        )\n      }\n    }\n\n    // Build a patch that only includes properties the pipeline should set.\n    // A property is applied when:\n    //   1. A config tool explicitly changed it (transformedConfig[k] !== baseConfig[k])\n    //   2. First pipeline run for this widget (no _lastConfig yet)\n    //   3. The widget value still matches what the pipeline last set — meaning the\n    //      user hasn't modified it via setWidget, so it's safe to overwrite.\n    // A property is SKIPPED when the widget value differs from _lastConfig,\n    // meaning the user (or a hook) changed it since the last pipeline run.\n    const base = baseConfig as Record<string, unknown>\n    const result = transformedConfig as Record<string, unknown>\n    const widgetNow = get().widgets[widgetId] as unknown as Record<\n      string,\n      unknown\n    >\n    const lastConfig = widgetNow?._lastConfig as\n      Record<string, unknown> | undefined\n\n    const patch: Record<string, unknown> = {}\n    for (const key of Object.keys(result)) {\n      const toolChanged = !Object.is(result[key], base[key])\n      const isFirstRun = !lastConfig || !(key in lastConfig)\n      const userUnmodified =\n        !isFirstRun && Object.is(widgetNow[key], lastConfig[key])\n\n      if (toolChanged || isFirstRun || userUnmodified) {\n        patch[key] = result[key]\n      }\n    }\n\n    // Skip store update if every patch value already matches the widget\n    const hasChanges = Object.keys(patch).some(\n      (k) => !Object.is(widgetNow?.[k], patch[k]),\n    )\n    const configRefChanged = !Object.is(transformedConfig, lastConfig)\n\n    if (!hasChanges && !configRefChanged) {\n      if (activeConfigPipelines.get(widgetId) === currentExecution) {\n        activeConfigPipelines.delete(widgetId)\n      }\n      return\n    }\n\n    // Apply the patch and store the pipeline output for next run's comparison\n    set((state) => {\n      const currentWidget = state.widgets[widgetId]\n      if (!currentWidget) return state\n\n      return {\n        widgets: {\n          ...state.widgets,\n          [widgetId]: {\n            ...currentWidget,\n            ...patch,\n            _lastConfig: transformedConfig,\n          },\n        },\n      }\n    })\n\n    if (activeConfigPipelines.get(widgetId) === currentExecution) {\n      activeConfigPipelines.delete(widgetId)\n    }\n  },\n}))\n\n/**\n * Stable references to store actions, accessible without creating a subscription.\n *\n * Use this instead of `useWidgetStore((state) => state.setWidget)` to avoid\n * unnecessary subscriber evaluations. Actions are stable functions that never\n * change, so subscribing to them wastes cycles on every store update.\n *\n * @example\n * ```tsx\n * import { widgetStoreActions } from '@carto/ps-react-ui/widgets'\n *\n * const { setWidget, registerTool } = widgetStoreActions\n *\n * useEffect(() => {\n *   registerTool(id, { id: 'my-tool', order: 10, enabled: true, fn: (d) => d })\n *   return () => widgetStoreActions.unregisterTool(id, 'my-tool')\n * }, [id])\n * ```\n */\nexport const widgetStoreActions: WidgetStoreActions = {\n  get setWidget() {\n    return useWidgetStore.getState().setWidget\n  },\n  get removeWidget() {\n    return useWidgetStore.getState().removeWidget\n  },\n  get clearWidgets() {\n    return useWidgetStore.getState().clearWidgets\n  },\n  get getWidget() {\n    return useWidgetStore.getState().getWidget\n  },\n  get registerTool() {\n    return useWidgetStore.getState().registerTool\n  },\n  get unregisterTool() {\n    return useWidgetStore.getState().unregisterTool\n  },\n  get setToolEnabled() {\n    return useWidgetStore.getState().setToolEnabled\n  },\n  get triggerToolPipeline() {\n    return useWidgetStore.getState().triggerToolPipeline\n  },\n  get executeToolPipeline() {\n    return useWidgetStore.getState().executeToolPipeline\n  },\n  get executeConfigPipeline() {\n    return useWidgetStore.getState().executeConfigPipeline\n  },\n} as WidgetStoreActions\n"],"mappings":";;AASA,IAAM,oBAAkB,IAAI,IAAoB,GAC1C,oBAAwB,IAAI,IAAoB,GAwCzC,IAAiB,EAAoB,CAAC,EAAE,GAAK,OAAS;CAEjE,SAAS,CAAC;CAKV,YAAY,GAAI,MAAW;EACzB,GAAK,MAAU;GACb,IAAM,IAAO,EAAM,QAAQ,MAAQ,CAAC;GACpC,OAAO,EACL,SAAS;IACP,GAAG,EAAM;KACR,IAAK;KACJ,GAAG;KACH,GAAG;KACH;IACF;GACF,EACF;EACF,CAAC;CACH;CAEA,eAAe,MACb,GAAK,MAAU;EACb,IAAM,IAAU,EAAE,GAAG,EAAM,QAAQ;EAInC,OAFA,OAAO,EAAQ,IAER,EAAE,WAAQ;CACnB,CAAC;CAEH,oBACE,EAAI,EACF,SAAS,CAAC,EACZ,CAAC;CAEH,YAAmC,MAC1B,EAAI,CAAC,CAAC,QAAQ;CAYvB,eAAe,GAAkB,MAA2B;EAE1D,IAAM,IADU,EAAI,CAAC,CAAC,QAAQ,EACT,EAAS,iBAAiB,MAC5C,MAAwB,EAAE,OAAO,EAAK,EACzC;EAIA,IACE,GAAc,UAAU,EAAK,SAC7B,EAAa,YAAY,EAAK,WAC9B,EAAa,SAAS,EAAK,QAC3B,EAAa,aAAa,EAAK,UAC/B;GACA,EAAa,KAAK,EAAK;GACvB;EACF;EAEA,GAAK,MAAU;GACb,IAAM,IAAS,EAAM,QAAQ,MAAc,CAAC,GAItC,KAHkB,EAAO,mBAAmB,CAAC,EAAA,CAGb,QACnC,MAAwB,EAAE,OAAO,EAAK,EACzC;GAEA,OAAO,EACL,SAAS;IACP,GAAG,EAAM;KACR,IAAW;KACV,GAAG;KACH,IAAI;KACJ,iBAAiB,CAAC,GAAG,GAAe,CAAI;IAC1C;GACF,EACF;EACF,CAAC;CACH;CAEA,iBAAiB,GAAkB,MACjC,GAAK,MAAU;EACb,IAAM,IAAU,EAAM,QAAQ;EAC9B,IAAI,CAAC,GAAS,OAAO;EAGrB,IAAM,KADkB,EAAQ,mBAAmB,CAAC,EAAA,CACd,QACnC,MAAwB,EAAE,OAAO,CACpC;EAEA,OAAO,EACL,SAAS;GACP,GAAG,EAAM;IACR,IAAW;IACV,GAAG;IACH,iBAAiB;GACnB;EACF,EACF;CACF,CAAC;CAOH,sBAAsB,MACpB,GAAK,MAAU;EACb,IAAM,IAAS,EAAM,QAAQ;EAG7B,OAFK,IAEE,EACL,SAAS;GACP,GAAG,EAAM;IACR,IAAW;IACV,GAAG;IACH,iBAAiB,CAAC,GAAI,EAAO,mBAAmB,CAAC,CAAE;GACrD;EACF,EACF,IAVoB;CAWtB,CAAC;CAQH,iBAAiB,GAAkB,GAAgB,MAAqB;EACtE,IAAM,IAAU,EAAI,CAAC,CAAC,QAAQ;EAC1B,KACW,EAAQ,iBAAiB,MACnC,MAAwB,EAAE,OAAO,CACpC,CAAA,EACU,YAAY,KAGxB,GAAK,MAAU;GACb,IAAM,IAAS,EAAM,QAAQ;GAC7B,IAAI,CAAC,GAAQ,OAAO;GAGpB,IAAM,KADkB,EAAO,mBAAmB,CAAC,EAAA,CACd,KAAK,MACxC,EAAK,OAAO,IAAS;IAAE,GAAG;IAAM;GAAQ,IAAI,CAC9C;GAEA,OAAO,EACL,SAAS;IACP,GAAG,EAAM;KACR,IAAW;KACV,GAAG;KACH,iBAAiB;IACnB;GACF,EACF;EACF,CAAC;CACH;CAcA,qBAAqB,OAAO,GAAkB,MAAwB;EACpE,IAAM,IAAS,EAAI,CAAC,CAAC,QAAQ;EAC7B,IAAI,CAAC,GAAQ;EAGb,IAAM,KAAoB,EAAgB,IAAI,CAAQ,KAAK,KAAK;EAChE,EAAgB,IAAI,GAAU,CAAgB;EAE9C,IAAM,IAAkB,GAGlB,oBAAkB,IAAI,IAAY;EACxC,KAAK,IAAM,KAAQ,EAAgB,mBAAmB,CAAC,GACrD,AAAI,EAAK,WAAW,EAAK,YACvB,EAAK,SAAS,SAAS,MAAO,EAAgB,IAAI,CAAE,CAAC;EAKzD,IAAM,IAAc,CAAC,GAAI,EAAgB,mBAAmB,CAAC,CAAE,CAAC,CAC7D,QACE,OACE,EAAK,QAAQ,YAAY,UAC1B,EAAK,WACL,CAAC,EAAgB,IAAI,EAAK,EAAE,CAChC,CAAC,CACA,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,GAG/B,IAAkB;EACtB,KAAK,IAAM,KAAQ,GAAa;GAE9B,IAAI,EAAgB,IAAI,CAAQ,MAAM,GACpC;GAGF,IAAI;IAEF,IAAkB,MAAM,EAAK,GAAG,CAAe;GACjD,SAAS,GAAO;IAEd,QAAQ,MAAM,QAAQ,EAAK,GAAG,qBAAqB,EAAS,IAAI,CAAK;GAEvE;EACF;EAGA,IAAM,IAAc,EAAI,CAAC,CAAC,QAAQ;EAClC,IACE,KACA,OAAO,GAAG,EAAY,MAAM,CAAe,KAC3C,OAAO,GAAG,EAAY,YAAY,CAAU,GAC5C;GACA,AAAI,EAAgB,IAAI,CAAQ,MAAM,KACpC,EAAgB,OAAO,CAAQ;GAEjC;EACF;EAoBA,AAjBA,GAAK,MAAU;GACb,IAAM,IAAgB,EAAM,QAAQ;GAGpC,OAFK,IAEE,EACL,SAAS;IACP,GAAG,EAAM;KACR,IAAW;KACV,GAAG;KACH;KACA,MAAM;IACR;GACF,EACF,IAX2B;EAY7B,CAAC,GAGG,EAAgB,IAAI,CAAQ,MAAM,KACpC,EAAgB,OAAO,CAAQ;CAEnC;CAcA,uBAAuB,OAAO,GAAkB,MAAuB;EACrE,IAAM,IAAS,EAAI,CAAC,CAAC,QAAQ;EAC7B,IAAI,CAAC,GAAQ;EAGb,IAAM,KAAoB,EAAsB,IAAI,CAAQ,KAAK,KAAK;EACtE,EAAsB,IAAI,GAAU,CAAgB;EAGpD,IAAM,oBAAkB,IAAI,IAAY;EACxC,KAAK,IAAM,KAAQ,EAAO,mBAAmB,CAAC,GAC5C,AAAI,EAAK,WAAW,EAAK,YACvB,EAAK,SAAS,SAAS,MAAO,EAAgB,IAAI,CAAE,CAAC;EAKzD,IAAM,IAAc,CAAC,GAAI,EAAO,mBAAmB,CAAC,CAAE,CAAC,CACpD,QACE,MACC,EAAK,SAAS,YACd,EAAK,WACL,CAAC,EAAgB,IAAI,EAAK,EAAE,CAChC,CAAC,CACA,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,GAG/B,IAA6B;EACjC,KAAK,IAAM,KAAQ,GAAa;GAC9B,IAAI,EAAsB,IAAI,CAAQ,MAAM,GAC1C;GAGF,IAAI;IACF,IAAoB,MAAM,EAAK,GAAG,CAAiB;GACrD,SAAS,GAAO;IAEd,QAAQ,MACN,eAAe,EAAK,GAAG,qBAAqB,EAAS,IACrD,CACF;GACF;EACF;EAUA,IAAM,IAAO,GACP,IAAS,GACT,IAAY,EAAI,CAAC,CAAC,QAAQ,IAI1B,IAAa,GAAW,aAGxB,IAAiC,CAAC;EACxC,KAAK,IAAM,KAAO,OAAO,KAAK,CAAM,GAAG;GACrC,IAAM,IAAc,CAAC,OAAO,GAAG,EAAO,IAAM,EAAK,EAAI,GAC/C,IAAa,CAAC,KAAc,EAAE,KAAO,IACrC,IACJ,CAAC,KAAc,OAAO,GAAG,EAAU,IAAM,EAAW,EAAI;GAE1D,CAAI,KAAe,KAAc,OAC/B,EAAM,KAAO,EAAO;EAExB;EAQA,IAAI,CALe,OAAO,KAAK,CAAK,CAAC,CAAC,MACnC,MAAM,CAAC,OAAO,GAAG,IAAY,IAAI,EAAM,EAAE,CAIvC,KAFqB,OAAO,GAAG,GAAmB,CAAU,GAE3B;GACpC,AAAI,EAAsB,IAAI,CAAQ,MAAM,KAC1C,EAAsB,OAAO,CAAQ;GAEvC;EACF;EAmBA,AAhBA,GAAK,MAAU;GACb,IAAM,IAAgB,EAAM,QAAQ;GAGpC,OAFK,IAEE,EACL,SAAS;IACP,GAAG,EAAM;KACR,IAAW;KACV,GAAG;KACH,GAAG;KACH,aAAa;IACf;GACF,EACF,IAX2B;EAY7B,CAAC,GAEG,EAAsB,IAAI,CAAQ,MAAM,KAC1C,EAAsB,OAAO,CAAQ;CAEzC;AACF,EAAE,GAqBW,IAAyC;CACpD,IAAI,YAAY;EACd,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,eAAe;EACjB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,eAAe;EACjB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,YAAY;EACd,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,eAAe;EACjB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,iBAAiB;EACnB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,iBAAiB;EACnB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,sBAAsB;EACxB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,sBAAsB;EACxB,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;CACA,IAAI,wBAAwB;EAC1B,OAAO,EAAe,SAAS,CAAC,CAAC;CACnC;AACF"}