@carto/ps-react-ui 4.19.0 → 4.20.1

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

@@ -51,8 +51,8 @@ export declare const Widget: {
     readonly State: typeof State;
     readonly SelectionSummary: typeof SelectionSummary;
     readonly Toolbox: typeof Toolbox;
-    readonly Note: (({ lineClamp, labels, children }: import('.').NoteProps) => import("react/jsx-runtime").JSX.Element) & {
-        Markdown: ({ content, lineClamp, labels }: import('.').NoteMarkdownProps) => import("react/jsx-runtime").JSX.Element;
+    readonly Note: (({ lineClamp, labels, children }: import('.').NoteProps) => import("react").JSX.Element) & {
+        Markdown: ({ content, lineClamp, labels }: import('.').NoteMarkdownProps) => import("react").JSX.Element;
     };
     readonly Echart: typeof Echart;
     readonly EchartUI: typeof EchartUI;
@@ -65,8 +65,8 @@ export declare const Widget: {
     readonly RelativeData: typeof RelativeData;
     readonly Download: typeof Download;
     readonly FullScreen: {
-        Trigger: ({ labels, enterIcon: EnterIcon, exitIcon: ExitIcon, iconProps, }: import('./actions').FullScreenTriggerProps) => import("react/jsx-runtime").JSX.Element;
-        Slot: ({ children, title, labels, closeIcon: CloseSvg, iconProps, }: import('./actions').FullScreenSlotProps) => import("react/jsx-runtime").JSX.Element;
+        Trigger: ({ labels, enterIcon: EnterIcon, exitIcon: ExitIcon, iconProps, }: import('./actions').FullScreenTriggerProps) => import("react").JSX.Element;
+        Slot: ({ children, title, labels, closeIcon: CloseSvg, iconProps, }: import('./actions').FullScreenSlotProps) => import("react").JSX.Element;
     };
     readonly LockSelection: typeof LockSelection;
     readonly ChangeColumn: typeof ChangeColumn;
@@ -102,7 +102,7 @@ export type { MarkdownUIProps, MarkdownWidgetData } from './markdown';
 export type { PieDatum, PieWidgetData } from './pie';
 export type { TimeseriesDatum, TimeseriesWidgetData } from './timeseries';
 export type { ScatterplotDatum, ScatterplotWidgetData } from './scatterplot';
-export type { SpreadUIProps, SpreadDataItem, SpreadWidgetData } from './spread';
+export type { SpreadUIProps, SpreadDataItem, SpreadWidgetData, SpreadVariant, } from './spread';
 export type { RangeProps, RangeUIProps, RangeDataItem, RangeWidgetData, RangeItemValue, } from './range';
 export type { CategoryProps, CategoryUIProps, CategoryDataItem, CategoryWidgetData, CategoryKey, CategorySeriesConfig, CategoryLabels, } from './category';
 export type { TableProps, TableUIProps, TableColumn, TableRow, TableWidgetData, TableWidgetState, TableSortDirection, TableSortState, } from './table';

package/dist/types/widgets-v2/markdown/markdown-content.d.ts

@@ -37,4 +37,4 @@ export interface MarkdownContentProps {
  * tree. `safeUrlTransform` is always applied as a second layer for markdown
  * links/images on the `allowHtml=false` path.
  */
-export declare function MarkdownContent({ content, components, allowHtml, allowImages, gfm, }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function MarkdownContent({ content, components, allowHtml, allowImages, gfm, }: MarkdownContentProps): import("react").JSX.Element;

package/dist/types/widgets-v2/markdown/markdown-ui.d.ts

@@ -9,4 +9,4 @@ export interface MarkdownUIProps {
  * the one slot in the library where authors can ship rich content. Caption
  * slots like `Note` keep the conservative defaults.
  */
-export declare function MarkdownUI({ content }: MarkdownUIProps): import("react/jsx-runtime").JSX.Element;
+export declare function MarkdownUI({ content }: MarkdownUIProps): import("react").JSX.Element;

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

@@ -3,4 +3,4 @@
  * per-widget store and forwards it to the pure {@link MarkdownUI}. Sits
  * inside `<Widget.Provider>`.
  */
-export declare function Markdown(): import("react/jsx-runtime").JSX.Element;
+export declare function Markdown(): import("react").JSX.Element;

package/dist/types/widgets-v2/markdown/skeleton.d.ts

@@ -1,4 +1,4 @@
 export interface MarkdownSkeletonProps {
     lines?: number;
 }
-export declare function MarkdownSkeleton({ lines }: MarkdownSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function MarkdownSkeleton({ lines }: MarkdownSkeletonProps): import("react").JSX.Element;

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

@@ -33,13 +33,13 @@ export interface NoteMarkdownProps {
  * Renders `children` verbatim through caption typography. For markdown
  * source, use the {@link NoteMarkdown} (`Note.Markdown`) subcomponent.
  */
-declare function NoteBase({ lineClamp, labels, children }: NoteProps): import("react/jsx-runtime").JSX.Element;
+declare function NoteBase({ lineClamp, labels, children }: NoteProps): import("react").JSX.Element;
 /**
  * Markdown variant of {@link Note}. Pipes the `content` string through the
  * shared {@link MarkdownContent} engine with caption-safe element mapping
  * (headings demoted, links open in new tabs, images/HTML stripped).
  */
-declare function NoteMarkdown({ content, lineClamp, labels }: NoteMarkdownProps): import("react/jsx-runtime").JSX.Element;
+declare function NoteMarkdown({ content, lineClamp, labels }: NoteMarkdownProps): import("react").JSX.Element;
 export declare const Note: typeof NoteBase & {
     Markdown: typeof NoteMarkdown;
 };

package/dist/types/widgets-v2/pie/skeleton.d.ts

@@ -10,4 +10,4 @@ export interface PieSkeletonProps {
  * Single donut only: multi-series pie loads as a horizontal bar chart, so
  * rendering one ring stays honest regardless of `count`.
  */
-export declare function PieSkeleton({ count }: PieSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function PieSkeleton({ count }: PieSkeletonProps): import("react").JSX.Element;

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

@@ -29,4 +29,4 @@ export interface ProviderProps {
  * (Formula, Spread, Range, Table, Category, Markdown) just don't pass
  * anything ECharts-shaped.
  */
-export declare function Provider({ id, data, isLoading, isFetching, error, formatter, labelFormatter, keepAlive, children, }: ProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function Provider({ id, data, isLoading, isFetching, error, formatter, labelFormatter, keepAlive, children, }: ProviderProps): import("react").JSX.Element;

package/dist/types/widgets-v2/range/range-ui.d.ts

@@ -24,4 +24,4 @@ export interface RangeUIProps {
  * UX. Each item is always a two-thumb range; supply `value` to seed the
  * starting selection, otherwise it defaults to `[min, max]`.
  */
-export declare function RangeUI({ items, onChange, onChangeCommitted, formatter, }: RangeUIProps): import("react/jsx-runtime").JSX.Element;
+export declare function RangeUI({ items, onChange, onChangeCommitted, formatter, }: RangeUIProps): import("react").JSX.Element;

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

@@ -21,4 +21,4 @@ export interface RangeProps {
  * is expected to update the data prop on `<Provider>`. Use `disabled` on
  * individual `RangeDataItem`s to disable specific rows.
  */
-export declare function Range({ onChange, onChangeCommitted }: RangeProps): import("react/jsx-runtime").JSX.Element;
+export declare function Range({ onChange, onChangeCommitted }: RangeProps): import("react").JSX.Element;

package/dist/types/widgets-v2/range/skeleton.d.ts

@@ -6,4 +6,4 @@ export interface RangeSkeletonProps {
  * matching the slider-then-inputs layout of {@link RangeUI} so the layout
  * doesn't jump when data resolves.
  */
-export declare function RangeSkeleton({ count }: RangeSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function RangeSkeleton({ count }: RangeSkeletonProps): import("react").JSX.Element;

package/dist/types/widgets-v2/scatterplot/skeleton.d.ts

@@ -9,4 +9,4 @@ export interface ScatterplotSkeletonProps {
  * rather than a generic list. Matches bar/histogram/pie skeleton structure
  * (grid stub + legend stub in a flex column).
  */
-export declare function ScatterplotSkeleton({ count }: ScatterplotSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScatterplotSkeleton({ count }: ScatterplotSkeletonProps): import("react").JSX.Element;

package/dist/types/widgets-v2/selection-summary/selection-summary.d.ts

@@ -26,4 +26,4 @@ export interface SelectionSummaryProps {
  * node instead — it receives the already-resolved displayed number (which
  * equals `total` when nothing is selected).
  */
-export declare function SelectionSummary({ count, total, onClear, labels, icon: Icon, iconProps, }: SelectionSummaryProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SelectionSummary({ count, total, onClear, labels, icon: Icon, iconProps, }: SelectionSummaryProps): import("react").JSX.Element | null;

package/dist/types/widgets-v2/spread/band.d.ts

@@ -0,0 +1,37 @@
+/**
+ * How a `spread` amount is applied to a centre value.
+ *
+ * - `percentage` — `spread` is a whole-number percentage of the centre
+ *   value, so `5` means +/-5%.
+ * - `absolute` — `spread` is a raw offset in the value's own units.
+ */
+export type SpreadVariant = 'percentage' | 'absolute';
+export interface GetSpreadBandOptions {
+    /** The centre value the band is drawn around. */
+    value: number;
+    /** Half-width of the band, read according to `variant`. */
+    spread: number;
+    /** Defaults to `percentage`. */
+    variant?: SpreadVariant;
+}
+/**
+ * Derives the `min` / `max` band around a centre value, for feeding a
+ * {@link SpreadDataItem} from a single aggregated number (a prediction, a
+ * target) plus a tolerance — rather than from a real column range.
+ *
+ * `spread` is read as a percentage by default, which is what a tolerance
+ * almost always is: an absolute offset is meaningless without knowing the
+ * value's magnitude, and gets visually lost on large values (+/-5 on a
+ * prediction of 204,113 renders as a range indistinguishable from a single
+ * number).
+ *
+ * @example
+ * getSpreadBand({ value: 1000, spread: 5 })
+ * // -> { min: 950, max: 1050 }
+ * getSpreadBand({ value: 1000, spread: 5, variant: 'absolute' })
+ * // -> { min: 995, max: 1005 }
+ */
+export declare function getSpreadBand({ value, spread, variant, }: GetSpreadBandOptions): {
+    min: number;
+    max: number;
+};

package/dist/types/widgets-v2/spread/band.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -3,4 +3,5 @@ export { SpreadUI, type SpreadUIProps } from './spread-ui';
 export { Separator } from './separator';
 export { SpreadSkeleton, type SpreadSkeletonProps } from './skeleton';
 export { createSpreadDownloadConfig } from './download';
+export { getSpreadBand, type SpreadVariant, type GetSpreadBandOptions } from './band';
 export type { SpreadDataItem, SpreadWidgetData } from './types';

package/dist/types/widgets-v2/spread/separator.d.ts

@@ -4,4 +4,4 @@
  * baseline alignment) matches the numbers around it. Renders with
  * `text.secondary` so it visually recedes between the two bounds.
  */
-export declare function Separator(): import("react/jsx-runtime").JSX.Element;
+export declare function Separator(): import("react").JSX.Element;

package/dist/types/widgets-v2/spread/skeleton.d.ts

@@ -6,4 +6,4 @@ export interface SpreadSkeletonProps {
  * sized for the `min — max` pair so the layout doesn't jump once data
  * resolves. Mirrors the row-per-item structure of {@link SpreadUI}.
  */
-export declare function SpreadSkeleton({ count }: SpreadSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function SpreadSkeleton({ count }: SpreadSkeletonProps): import("react").JSX.Element;

package/dist/types/widgets-v2/spread/spread-ui.d.ts

@@ -15,4 +15,4 @@ export interface SpreadUIProps {
  * {@link Note}) and the Formula row styles so Spread and Formula stay
  * visually aligned when used together.
  */
-export declare function SpreadUI({ items, formatter, ref }: SpreadUIProps): import("react/jsx-runtime").JSX.Element;
+export declare function SpreadUI({ items, formatter, ref }: SpreadUIProps): import("react").JSX.Element;

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

@@ -2,4 +2,4 @@
  * Stateful Spread bridge — reads `data` (post-pipeline) and `formatter` from
  * the per-widget store and forwards them to the pure {@link SpreadUI}.
  */
-export declare function Spread(): import("react/jsx-runtime").JSX.Element;
+export declare function Spread(): import("react").JSX.Element;

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

@@ -16,4 +16,4 @@ export interface StateProps {
  * errors thrown by `children` are caught by the inlined error boundary and
  * routed through the same path.
  */
-export declare function State({ skeleton, children, isEmpty, fallback, labels, }: StateProps): import("react/jsx-runtime").JSX.Element;
+export declare function State({ skeleton, children, isEmpty, fallback, labels, }: StateProps): import("react").JSX.Element;

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

@@ -8,4 +8,4 @@ export interface SubheaderProps {
  * Stateless layout: CSS grid `1fr auto`. Children self-place — typically
  * `<Widget.SelectionSummary />` (left) and `<Widget.Toolbox>` (right).
  */
-export declare function Subheader({ sx, children }: SubheaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function Subheader({ sx, children }: SubheaderProps): import("react").JSX.Element;

package/dist/types/widgets-v2/table/skeleton.d.ts

@@ -19,4 +19,4 @@ export interface TableSkeletonProps {
  * Mirrors the v1 widget's `<TableSkeleton>` structure with v2's themed
  * `styles.headerCell`.
  */
-export declare function TableSkeleton({ rows, columns, size, }: TableSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare function TableSkeleton({ rows, columns, size, }: TableSkeletonProps): import("react").JSX.Element;

package/dist/types/widgets-v2/table/table-ui.d.ts

@@ -41,4 +41,4 @@ export interface TableUIProps<T extends TableRow = TableRow> {
  * Has no widget-store coupling — `<Table>` (the bridge) reads from the store
  * and feeds this UI with already-projected data.
  */
-export declare function TableUI<T extends TableRow = TableRow>({ columns, rows, total, page, pageSize, pageSizeOptions, sort, keyColumn, selection, selectable, onSortChange, onPageChange, onPageSizeChange, onSelectionChange, onRowClick, onRowHover, labels, emptyContent, size, }: TableUIProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function TableUI<T extends TableRow = TableRow>({ columns, rows, total, page, pageSize, pageSizeOptions, sort, keyColumn, selection, selectable, onSortChange, onPageChange, onPageSizeChange, onSelectionChange, onRowClick, onRowHover, labels, emptyContent, size, }: TableUIProps<T>): import("react").JSX.Element;

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

@@ -47,4 +47,4 @@ export interface TableProps<T extends TableRow = TableRow> extends Pick<TableUIP
  * locally, and feeds `<TableUI />`. Sort, page, and pageSize live on the
  * extended widget state ({@link TableWidgetState}).
  */
-export declare function Table<T extends TableRow = TableRow>({ columns, visibleColumns, initialPageSize, selection, onSelectionChange, onRowClick, onRowHover, remote, total: remoteTotal, onSortChange, onPageChange, onPageSizeChange, ...uiProps }: TableProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function Table<T extends TableRow = TableRow>({ columns, visibleColumns, initialPageSize, selection, onSelectionChange, onRowClick, onRowHover, remote, total: remoteTotal, onSortChange, onPageChange, onPageSizeChange, ...uiProps }: TableProps<T>): import("react").JSX.Element;

package/dist/types/widgets-v2/timeseries/skeleton.d.ts

@@ -5,4 +5,4 @@
  * with Bar / Histogram / Scatter skeletons (column-flex container with
  * legend strip below).
  */
-export declare function TimeseriesSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function TimeseriesSkeleton(): import("react").JSX.Element;

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

@@ -46,4 +46,4 @@ export interface ToolboxProps {
  * they don't appear as orphan separators in the inline row; they're still
  * there in the popover.
  */
-export declare function Toolbox({ visibleCount, labels, icon: Icon, iconProps, direction, sx, children, }: ToolboxProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Toolbox({ visibleCount, labels, icon: Icon, iconProps, direction, sx, children, }: ToolboxProps): import("react").JSX.Element | null;

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

@@ -14,9 +14,9 @@ export interface ActionsProps {
  * The container also stops click propagation so interacting with an action
  * doesn't toggle the wrapper's collapse.
  */
-export declare function Actions({ sx, children }: ActionsProps): import("react/jsx-runtime").JSX.Element;
+export declare function Actions({ sx, children }: ActionsProps): import("react").JSX.Element;
 export interface OptionsProps {
     sx?: SxProps<Theme>;
     children: ReactNode;
 }
-export declare function Options({ sx, children }: OptionsProps): import("react/jsx-runtime").JSX.Element;
+export declare function Options({ sx, children }: OptionsProps): import("react").JSX.Element;

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

@@ -4,9 +4,9 @@ export interface ContentProps {
     sx?: SxProps<Theme>;
     children: ReactNode;
 }
-export declare function Content({ sx, children }: ContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function Content({ sx, children }: ContentProps): import("react").JSX.Element;
 export interface FooterProps {
     sx?: SxProps<Theme>;
     children: ReactNode;
 }
-export declare function Footer({ sx, children }: FooterProps): import("react/jsx-runtime").JSX.Element;
+export declare function Footer({ sx, children }: FooterProps): import("react").JSX.Element;

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

@@ -53,4 +53,4 @@ export interface WrapperProps {
  * 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-runtime").JSX.Element;
+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-DFl2hW0R.js.map → use-widget-selector-VSPhfhNm.js.map}

@@ -1 +1 @@
-{"version":3,"file":"use-widget-selector-DFl2hW0R.js","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"],"names":["useWidgetSelector","widgetId","selector","$","_c","t0","state","widgets","useWidgetStore","useShallow"],"mappings":";;;AAqCO,SAAAA,EAAAC,GAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,CAAA;AAAA,MAAAC;AAAA,SAAAF,EAAA,CAAA,MAAAD,KAAAC,SAAAF,KAKQI,IAAAC,CAAAA,MACTJ,EAASI,EAAKC,QAASN,CAAQ,CAAC,GAACE,OAAAD,GAAAC,OAAAF,GAAAE,OAAAE,KAAAA,IAAAF,EAAA,CAAA,GAF9BK,EACLC,EAAWJ,CAEX,CACF;AAAC;"}
+{"version":3,"file":"use-widget-selector-VSPhfhNm.js","names":["useWidgetStore","WidgetState","useShallow","useWidgetSelector","widgetId","selector","$","_c","t0","state","widgets"],"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,SAAOG,EAAAC,GAAAC,GAAA;CAAA,IAAAC,IAAAC,EAAA,CAAA,GAAAC;CAMgC,OANhCF,EAAA,OAAAD,KAAAC,EAAA,OAAAF,KAKQI,KAAAC,MACTJ,EAASI,EAAKC,QAASN,EAAS,GAACE,EAAA,KAAAD,GAAAC,EAAA,KAAAF,GAAAE,EAAA,KAAAE,KAAAA,IAAAF,EAAA,IAF9BN,EACLE,EAAWM,CAEX,CACF;AAAC"}

package/dist/utils-DtvTjjMq.js

@@ -0,0 +1,58 @@
+import { r as e } from "./zoom-toggle-CA0ifG23.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-DtvTjjMq.js.map

package/dist/utils-DtvTjjMq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-DtvTjjMq.js","names":["mergeOptions","Record","base","T","override","Partial","out","key","Object","keys","a","b","undefined","mergeValue","Array","isArray","len","Math","max","length","result","i","av","bv","isPlainObject","v","proto","getPrototypeOf","prototype","ZOOM_LAYOUT","positionDataZoomForLegend","dataZoom","hasLegend","Array","isArray","length","map","entry","dz","type","bottom","sliderBottomWithLegend","Theme","resolveThemeColor","theme","raw","undefined","includes","parts","split","cursor","palette","part","Record"],"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,SAAgBA,EACdE,GACAE,GACG;CACH,IAAI,CAACA,GAAU,OAAOF;CACtB,IAAMI,IAA+B,EAAE,GAAGJ,EAAK;CAC/C,KAAK,IAAMK,KAAOC,OAAOC,KAAKL,CAAQ,GAAkB;EACtD,IAAMM,IAAIR,EAAKK,IACTI,IAAIP,EAASG;EACfI,MAAMC,KAAAA,MACVN,EAAIC,KAAiBM,EAAWH,GAAGC,CAAC;CACtC;CACA,OAAOL;AACT;AAEA,SAASO,EAAWH,GAAYC,GAAqB;CACnD,IAAIG,MAAMC,QAAQL,CAAC,KAAKI,MAAMC,QAAQJ,CAAC,GAAG;EACxC,IAAMK,IAAMC,KAAKC,IAAIR,EAAES,QAAQR,EAAEQ,MAAM,GACjCC,IAAaN,MAAeE,CAAG;EACrC,KAAK,IAAIK,IAAI,GAAGA,IAAIL,GAAKK,KAAK;GAC5B,IAAMC,IAAcZ,EAAEW,IAChBE,IAAcZ,EAAEU;GACtB,AAAIE,MAAOX,KAAAA,IAAWQ,EAAOC,KAAKC,IACzBA,MAAOV,KAAAA,IAAWQ,EAAOC,KAAKE,IAClCH,EAAOC,KAAKR,EAAWS,GAAIC,CAAE;EACpC;EACA,OAAOH;CACT;CAIA,OAHII,EAAcd,CAAC,KAAKc,EAAcb,CAAC,IAC9B;EAAE,GAAGD;EAAG,GAAGC;CAAE,IAEfA;AACT;AAEA,SAASa,EAAcC,GAA0C;CAC/D,IAAkB,OAAOA,KAAM,aAA3BA,GAAqC,OAAO;CAChD,IAAMC,IAAQlB,OAAOmB,eAAeF,CAAC;CACrC,OAAOC,MAAUlB,OAAOoB,aAAaF,MAAU;AACjD;;;ACrCA,SAAgBI,EACdC,GACAC,GACkB;CAElB,OADI,CAACC,MAAMC,QAAQH,CAAQ,KAAKA,EAASI,WAAW,IAAU,OACvDJ,EAASK,KAAKC,MAAmB;EACtC,IAAqB,OAAOA,KAAU,aAAlCA,GAA4C,OAAOA;EACvD,IAAMC,IAAKD;EAIX,OAHIC,EAAGC,SAAS,YAAYP,IACnB;GAAE,GAAGM;GAAIE,QAAQX,EAAYY;EAAuB,IAEtDH;CACT,CAAC;AACH;;;ACPA,SAAgBK,EACdC,GACAC,GACoB;CACpB,IAAIA,KAAO,MAAM;CACjB,IAAI,CAACA,EAAIE,SAAS,GAAG,GAAG,OAAOF;CAC/B,IAAMG,IAAQH,EAAII,MAAM,GAAG,GACvBC,IAAkBN,EAAMO;CAC5B,KAAK,IAAMC,KAAQJ,GAAO;EACxB,IAAsB,OAAOE,KAAW,aAApCA,GACF,OAAOL;EAETK,IAAUA,EAAmCE;CAC/C;CACA,OAAO,OAAOF,KAAW,WAAWA,IAASL;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