@carto/ps-react-ui 4.3.0-widgets.0 → 5.0.0-widgets.10

package/dist/styles-dOu_pRNb.js

@@ -0,0 +1,77 @@
+function c(t) {
+  const n = [];
+  if (t.length > 0 && (t[0]?.length ?? 0) > 0) {
+    const o = t?.[0]?.[0] ?? {}, e = Object.keys(o);
+    n.push(e);
+  }
+  return t.forEach((o) => {
+    o.forEach((e) => {
+      const i = Object.values(e).map((r) => String(r));
+      n.push(i);
+    });
+  }), n;
+}
+function a(t) {
+  const n = [];
+  return n.push(["x", "y"]), t.forEach((o) => {
+    o.forEach((e) => {
+      n.push([String(e[0]), String(e[1])]);
+    });
+  }), n;
+}
+function l(t) {
+  return {
+    show: t,
+    icon: "circle",
+    left: 0,
+    bottom: 0,
+    orient: "horizontal",
+    type: "scroll"
+  };
+}
+function f(t, n) {
+  return {
+    ...!t && {
+      bottom: parseInt(n.spacing(3))
+    },
+    ...t && {
+      bottom: parseInt(n.spacing(7))
+    }
+  };
+}
+function u(t) {
+  return function(n, o, e, i, r) {
+    const s = {
+      top: parseInt(t.spacing(0.5))
+    };
+    return r.contentSize[0] < r.viewSize[0] - n[0] ? s.left = n[0] : s.right = r.viewSize[0] - n[0], s;
+  };
+}
+const p = {
+  graph: {
+    /**
+     * Common container style for chart widget skeletons
+     */
+    container: {
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "space-between",
+      flexDirection: "column",
+      gap: ({
+        spacing: t
+      }) => t(1),
+      height: ({
+        spacing: t
+      }) => t(38)
+    }
+  }
+};
+export {
+  l as a,
+  f as b,
+  u as c,
+  p as d,
+  c as f,
+  a as s
+};
+//# sourceMappingURL=styles-dOu_pRNb.js.map

package/dist/styles-dOu_pRNb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-dOu_pRNb.js","sources":["../src/widgets/_shared/chart-config/csv-modifiers.ts","../src/widgets/_shared/chart-config/option-builders.ts","../src/widgets/_shared/skeleton/styles.ts"],"sourcesContent":["/**\n * Shared CSV export modifiers for chart widgets\n */\n\n/**\n * Flattens object array data into CSV-ready rows.\n * Used by bar, pie, histogram, and timeseries widgets.\n *\n * @param data - Array of series, where each series is an array of data objects\n * @returns CSV rows with headers and values\n */\nexport function flattenObjectArrayToCSV<T extends Record<string, unknown>>(\n  data: T[][],\n): string[][] {\n  const rows: string[][] = []\n\n  // Add headers from first data point if available\n  if (data.length > 0 && (data[0]?.length ?? 0) > 0) {\n    const firstDataPoint = data?.[0]?.[0] ?? {}\n    const headers = Object.keys(firstDataPoint)\n    rows.push(headers)\n  }\n\n  // Add data rows from all series\n  data.forEach((series) => {\n    series.forEach((dataPoint) => {\n      const values = Object.values(dataPoint).map((v) => String(v))\n      rows.push(values)\n    })\n  })\n\n  return rows\n}\n\n/**\n * Creates CSV rows for scatterplot data.\n * Scatterplot uses array format [x, y] instead of objects.\n *\n * @param data - Array of series, where each series is an array of [x, y] tuples\n * @returns CSV rows with ['x', 'y'] headers\n */\nexport function scatterplotDataToCSV(data: number[][][]): string[][] {\n  const rows: string[][] = []\n\n  // Add headers\n  rows.push(['x', 'y'])\n\n  // Add data rows from all series\n  data.forEach((series) => {\n    series.forEach((dataPoint) => {\n      rows.push([String(dataPoint[0]), String(dataPoint[1])])\n    })\n  })\n\n  return rows\n}\n","import type { Theme } from '@mui/material'\nimport type { LegendComponentOption } from 'echarts'\n\n/**\n * Shared EChart configuration builders for chart widgets\n */\n\n/**\n * Builds standard legend configuration for chart widgets\n *\n * @param hasLegend - Whether to show the legend\n * @returns Legend configuration object\n */\nexport function buildLegendConfig(hasLegend: boolean): LegendComponentOption {\n  return {\n    show: hasLegend,\n    icon: 'circle' as const,\n    left: 0,\n    bottom: 0,\n    orient: 'horizontal',\n    type: 'scroll',\n  }\n}\n\n/**\n * Builds standard grid configuration with legend-aware spacing\n *\n * @param hasLegend - Whether the chart has a legend\n * @param theme - MUI theme for spacing\n * @param additionalConfig - Additional grid configuration to merge\n * @returns Grid configuration object\n */\nexport function buildGridConfig(hasLegend: boolean, theme: Theme) {\n  return {\n    ...(!hasLegend && { bottom: parseInt(theme.spacing(3)) }),\n    ...(hasLegend && { bottom: parseInt(theme.spacing(7)) }),\n  }\n}\n\n/**\n * Creates a tooltip position calculator that handles overflow\n * Used by bar, histogram, and scatterplot widgets\n *\n * @param theme - MUI theme for spacing\n * @returns Tooltip position function\n */\nexport function createTooltipPositioner(theme: Theme) {\n  return function (\n    point: [number, number],\n    _params: unknown,\n    _dom: unknown,\n    _rect: unknown,\n    size: { contentSize: [number, number]; viewSize: [number, number] },\n  ) {\n    const position = { top: parseInt(theme.spacing(0.5)) } as Record<\n      string,\n      number\n    >\n\n    // Position tooltip left or right based on available space\n    if (size.contentSize[0] < size.viewSize[0] - point[0]) {\n      position.left = point[0]\n    } else {\n      position.right = size.viewSize[0] - point[0]\n    }\n\n    return position\n  }\n}\n","import type { Theme } from '@mui/material'\n\n/**\n * Base skeleton styles shared across all chart widgets\n */\nexport const baseSkeletonStyles = {\n  graph: {\n    /**\n     * Common container style for chart widget skeletons\n     */\n    container: {\n      display: 'flex',\n      alignItems: 'center',\n      justifyContent: 'space-between',\n      flexDirection: 'column',\n      gap: ({ spacing }: Theme) => spacing(1),\n      height: ({ spacing }: Theme) => spacing(38),\n    },\n  },\n} as const\n"],"names":["flattenObjectArrayToCSV","data","rows","length","firstDataPoint","headers","Object","keys","push","forEach","series","dataPoint","values","map","v","String","scatterplotDataToCSV","buildLegendConfig","hasLegend","show","icon","left","bottom","orient","type","buildGridConfig","theme","parseInt","spacing","createTooltipPositioner","point","_params","_dom","_rect","size","position","top","contentSize","viewSize","right","baseSkeletonStyles","graph","container","display","alignItems","justifyContent","flexDirection","gap","height"],"mappings":"AAWO,SAASA,EACdC,GACY;AACZ,QAAMC,IAAmB,CAAA;AAGzB,MAAID,EAAKE,SAAS,MAAMF,EAAK,CAAC,GAAGE,UAAU,KAAK,GAAG;AACjD,UAAMC,IAAiBH,IAAO,CAAC,IAAI,CAAC,KAAK,CAAA,GACnCI,IAAUC,OAAOC,KAAKH,CAAc;AAC1CF,IAAAA,EAAKM,KAAKH,CAAO;AAAA,EACnB;AAGAJ,SAAAA,EAAKQ,QAASC,CAAAA,MAAW;AACvBA,IAAAA,EAAOD,QAASE,CAAAA,MAAc;AAC5B,YAAMC,IAASN,OAAOM,OAAOD,CAAS,EAAEE,IAAKC,CAAAA,MAAMC,OAAOD,CAAC,CAAC;AAC5DZ,MAAAA,EAAKM,KAAKI,CAAM;AAAA,IAClB,CAAC;AAAA,EACH,CAAC,GAEMV;AACT;AASO,SAASc,EAAqBf,GAAgC;AACnE,QAAMC,IAAmB,CAAA;AAGzBA,SAAAA,EAAKM,KAAK,CAAC,KAAK,GAAG,CAAC,GAGpBP,EAAKQ,QAASC,CAAAA,MAAW;AACvBA,IAAAA,EAAOD,QAASE,CAAAA,MAAc;AAC5BT,MAAAA,EAAKM,KAAK,CAACO,OAAOJ,EAAU,CAAC,CAAC,GAAGI,OAAOJ,EAAU,CAAC,CAAC,CAAC,CAAC;AAAA,IACxD,CAAC;AAAA,EACH,CAAC,GAEMT;AACT;AC1CO,SAASe,EAAkBC,GAA2C;AAC3E,SAAO;AAAA,IACLC,MAAMD;AAAAA,IACNE,MAAM;AAAA,IACNC,MAAM;AAAA,IACNC,QAAQ;AAAA,IACRC,QAAQ;AAAA,IACRC,MAAM;AAAA,EAAA;AAEV;AAUO,SAASC,EAAgBP,GAAoBQ,GAAc;AAChE,SAAO;AAAA,IACL,GAAI,CAACR,KAAa;AAAA,MAAEI,QAAQK,SAASD,EAAME,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,IACrD,GAAIV,KAAa;AAAA,MAAEI,QAAQK,SAASD,EAAME,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAAE;AAE1D;AASO,SAASC,EAAwBH,GAAc;AACpD,SAAO,SACLI,GACAC,GACAC,GACAC,GACAC,GACA;AACA,UAAMC,IAAW;AAAA,MAAEC,KAAKT,SAASD,EAAME,QAAQ,GAAG,CAAC;AAAA,IAAA;AAMnD,WAAIM,EAAKG,YAAY,CAAC,IAAIH,EAAKI,SAAS,CAAC,IAAIR,EAAM,CAAC,IAClDK,EAASd,OAAOS,EAAM,CAAC,IAEvBK,EAASI,QAAQL,EAAKI,SAAS,CAAC,IAAIR,EAAM,CAAC,GAGtCK;AAAAA,EACT;AACF;AC/DO,MAAMK,IAAqB;AAAA,EAChCC,OAAO;AAAA;AAAA;AAAA;AAAA,IAILC,WAAW;AAAA,MACTC,SAAS;AAAA,MACTC,YAAY;AAAA,MACZC,gBAAgB;AAAA,MAChBC,eAAe;AAAA,MACfC,KAAKA,CAAC;AAAA,QAAEnB,SAAAA;AAAAA,MAAAA,MAAqBA,EAAQ,CAAC;AAAA,MACtCoB,QAAQA,CAAC;AAAA,QAAEpB,SAAAA;AAAAA,MAAAA,MAAqBA,EAAQ,EAAE;AAAA,IAAA;AAAA,EAC5C;AAEJ;"}

package/dist/tooltip-BDnrRKrp.js

@@ -0,0 +1,25 @@
+import { jsx as a } from "react/jsx-runtime";
+import { c as f } from "react/compiler-runtime";
+import { Tooltip as c } from "@mui/material";
+let s = 500;
+function y(i) {
+  const t = f(10);
+  let e, o, r, l;
+  t[0] !== i ? ({
+    children: e,
+    title: l,
+    enterNextDelay: r,
+    ...o
+  } = i, t[0] = i, t[1] = e, t[2] = o, t[3] = r, t[4] = l) : (e = t[1], o = t[2], r = t[3], l = t[4]);
+  const p = r === void 0 ? s : r;
+  let n;
+  return t[5] !== e || t[6] !== p || t[7] !== o || t[8] !== l ? (n = /* @__PURE__ */ a(c, { title: l, enterNextDelay: p, ...o, children: e }), t[5] = e, t[6] = p, t[7] = o, t[8] = l, t[9] = n) : n = t[9], n;
+}
+function D(i) {
+  s = i;
+}
+export {
+  y as T,
+  D as s
+};
+//# sourceMappingURL=tooltip-BDnrRKrp.js.map

package/dist/tooltip-BDnrRKrp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-BDnrRKrp.js","sources":["../src/components/tooltip/tooltip.tsx"],"sourcesContent":["import { Tooltip as MuiTooltip, type TooltipProps } from '@mui/material'\n\nlet tooltipEnterDelay = 500\n\n/**\n * A wrapper around MUI's Tooltip component with enterNextDelay set to 1000ms by default.\n *\n * This component ensures consistent tooltip behavior across the application.\n *\n * @example\n * <Tooltip title=\"This is a tooltip\">\n *   <Button>Hover me</Button>\n * </Tooltip>\n */\nexport function Tooltip({\n  children,\n  title,\n  enterNextDelay = tooltipEnterDelay,\n  ...props\n}: TooltipProps) {\n  return (\n    <MuiTooltip title={title} enterNextDelay={enterNextDelay} {...props}>\n      {children}\n    </MuiTooltip>\n  )\n}\n\nexport function setTooltipEnterDelay(delay: number) {\n  tooltipEnterDelay = delay\n}\n"],"names":["tooltipEnterDelay","Tooltip","t0","$","_c","children","props","t1","title","enterNextDelay","undefined","t2","MuiTooltip","setTooltipEnterDelay","delay"],"mappings":";;;AAEA,IAAIA,IAAoB;AAYjB,SAAAC,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA;AAAA,MAAAC,GAAAC,GAAAC,GAAAC;AAAA,EAAAL,SAAAD,KAAiB;AAAA,IAAAG,UAAAA;AAAAA,IAAAG,OAAAA;AAAAA,IAAAC,gBAAAF;AAAAA,IAAA,GAAAD;AAAAA,EAAAA,IAAAJ,GAKTC,OAAAD,GAAAC,OAAAE,GAAAF,OAAAG,GAAAH,OAAAI,GAAAJ,OAAAK,MAAAH,IAAAF,EAAA,CAAA,GAAAG,IAAAH,EAAA,CAAA,GAAAI,IAAAJ,EAAA,CAAA,GAAAK,IAAAL,EAAA,CAAA;AAFb,QAAAM,IAAAF,MAAAG,SAAAV,IAAAO;AAAkC,MAAAI;AAAA,SAAAR,EAAA,CAAA,MAAAE,KAAAF,EAAA,CAAA,MAAAM,KAAAN,EAAA,CAAA,MAAAG,KAAAH,SAAAK,KAIhCG,sBAACC,GAAA,EAAkBJ,OAAAA,GAAuBC,gBAAAA,MAAoBH,gBAE9D,GAAaH,OAAAE,GAAAF,OAAAM,GAAAN,OAAAG,GAAAH,OAAAK,GAAAL,OAAAQ,KAAAA,IAAAR,EAAA,CAAA,GAFbQ;AAEa;AAIV,SAASE,EAAqBC,GAAe;AAClDd,EAAAA,IAAoBc;AACtB;"}

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

@@ -0,0 +1,2 @@
+export { useDebounce } from './use-debounce';
+export { useWidgetRef } from './use-widget-ref';

package/dist/types/hooks/use-debounce.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Custom hook for debouncing a callback function.
+ *
+ * @param callback - The function to debounce
+ * @param delay - The delay in milliseconds (default: 300ms)
+ * @returns A debounced version of the callback
+ *
+ * @example
+ * ```tsx
+ * const debouncedSearch = useDebounce((searchText: string) => {
+ *   // Perform search
+ *   console.log('Searching for:', searchText)
+ * }, 300)
+ *
+ * // Call it anywhere
+ * debouncedSearch('react')
+ * ```
+ */
+export declare function useDebounce<TArgs extends unknown[], TReturn = void>(callback: (...args: TArgs) => TReturn, delay?: number): (...args: TArgs) => void;

package/dist/types/hooks/use-widget-ref.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Custom hook for registering a DOM element ref with the widget store.
+ * This allows other parts of the application to access the widget's DOM element.
+ *
+ * @param widgetId - The widget ID to register the ref under
+ * @returns A ref object to attach to the DOM element
+ *
+ * @example
+ * ```tsx
+ * function MyWidget({ id }: { id: string }) {
+ *   const ref = useWidgetRef<HTMLDivElement>(id)
+ *
+ *   return <div ref={ref}>Widget content</div>
+ * }
+ * ```
+ */
+export declare function useWidgetRef<T extends HTMLElement = HTMLElement>(widgetId: string): import('react').RefObject<T | null>;

package/dist/types/widgets/_shared/chart-config/config-factory.d.ts

@@ -1,10 +1,8 @@
-import { EchartOptionsProps, EchartWidgetData, EchartWidgetConfig } from '../../echart';
-import { BaseConfig } from '../../config-loader';
-import { Ref } from 'react';
+import { EchartOptionsProps, EchartWidgetData } from '../../echart';
 /**
  * Base configuration interface for chart widgets
  */
-export interface ChartWidgetBaseConfig<TData = EchartWidgetData> extends Omit<BaseConfig, 'data'> {
+export interface ChartWidgetBaseConfig<TData = EchartWidgetData> {
     data?: TData;
 }
 /**
@@ -14,14 +12,12 @@ export interface CreateChartWidgetConfigParams<TData = EchartWidgetData, TConfig
     /** Widget type identifier (e.g., 'bar', 'pie', 'histogram') */
     type: TType;
     /** Function to get EChart options from config */
-    getOptions: (config: Omit<TConfig, 'refUI'>) => EchartOptionsProps;
-    /** Function to create CSV data from widget data */
-    csvModifier: (data: TData) => string[][];
+    getOptions: (config: TConfig) => EchartOptionsProps;
 }
 /**
  * Return type of the chart widget config function
  */
-export type ChartWidgetConfigResult<TData = EchartWidgetData, TConfig extends ChartWidgetBaseConfig<TData> = ChartWidgetBaseConfig<TData>, TType extends string = string> = Omit<TConfig, 'data' | 'refUI'> & EchartWidgetConfig<TData> & {
+export type ChartWidgetConfigResult<TData = EchartWidgetData, TConfig extends ChartWidgetBaseConfig<TData> = ChartWidgetBaseConfig<TData>, TType extends string = string> = TConfig & {
     type: TType;
 };
 /**
@@ -39,6 +35,4 @@ export type ChartWidgetConfigResult<TData = EchartWidgetData, TConfig extends Ch
  * })
  * ```
  */
-export declare function createChartWidgetConfig<TData = EchartWidgetData, TConfig extends ChartWidgetBaseConfig<TData> = ChartWidgetBaseConfig<TData>, TType extends string = string>({ type, getOptions, csvModifier, }: CreateChartWidgetConfigParams<TData, TConfig, TType>): (config: TConfig & {
-    refUI?: Ref<HTMLElement | null>;
-}) => ChartWidgetConfigResult<TData, TConfig, TType>;
+export declare function createChartWidgetConfig<TData = EchartWidgetData, TConfig extends ChartWidgetBaseConfig<TData> = ChartWidgetBaseConfig<TData>, TType extends string = string>({ type, getOptions, }: CreateChartWidgetConfigParams<TData, TConfig, TType>): (config: TConfig) => ChartWidgetConfigResult<TData, TConfig, TType>;

package/dist/types/widgets/_shared/chart-config/option-builders.d.ts

@@ -1,5 +1,5 @@
 import { Theme } from '@mui/material';
-import { GridComponentOption } from 'echarts';
+import { LegendComponentOption } from 'echarts';
 /**
  * Shared EChart configuration builders for chart widgets
  */
@@ -9,12 +9,7 @@ import { GridComponentOption } from 'echarts';
  * @param hasLegend - Whether to show the legend
  * @returns Legend configuration object
  */
-export declare function buildLegendConfig(hasLegend: boolean): {
-    show: boolean;
-    icon: "circle";
-    left: number;
-    bottom: number;
-};
+export declare function buildLegendConfig(hasLegend: boolean): LegendComponentOption;
 /**
  * Builds standard grid configuration with legend-aware spacing
  *
@@ -23,7 +18,7 @@ export declare function buildLegendConfig(hasLegend: boolean): {
  * @param additionalConfig - Additional grid configuration to merge
  * @returns Grid configuration object
  */
-export declare function buildGridConfig(hasLegend: boolean, theme: Theme, additionalConfig?: Record<string, GridComponentOption>): {
+export declare function buildGridConfig(hasLegend: boolean, theme: Theme): {
     bottom?: number | undefined;
 };
 /**

package/dist/types/widgets/actions/change-column/change-column-icon.d.ts

@@ -0,0 +1 @@
+export declare const ChangeColumnIcon: () => import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/change-column/change-column.d.ts

@@ -0,0 +1,16 @@
+import { ChangeColumnProps } from './types';
+/**
+ * Widget action to reorder columns in a table widget via drag-and-drop.
+ *
+ * This action reads the columns from the widget store and allows users to
+ * drag and drop columns to reorder them. All columns are displayed and
+ * can be reordered.
+ *
+ * Returns null if there are fewer than 2 columns.
+ *
+ * @example
+ * ```tsx
+ * <ChangeColumn id="my-table-widget" />
+ * ```
+ */
+export declare function ChangeColumn({ id, labels, Icon, IconButtonProps, MenuProps, }: ChangeColumnProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/actions/change-column/sortable-column-item.d.ts

@@ -0,0 +1,9 @@
+import { TableColumn } from '../../table/types';
+export interface SortableColumnItemProps {
+    column: TableColumn;
+}
+/**
+ * A draggable menu item for column reordering.
+ * Uses @dnd-kit/sortable for drag-and-drop functionality.
+ */
+export declare function SortableColumnItem({ column }: SortableColumnItemProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/change-column/types.d.ts

@@ -0,0 +1,19 @@
+import { IconButtonProps, MenuProps } from '@mui/material';
+import { ReactNode } from 'react';
+export interface ChangeColumnProps {
+    /** Widget ID to update column configuration in the widget store */
+    id: string;
+    /** Custom labels for the action */
+    labels?: {
+        /** Tooltip label */
+        tooltip?: string;
+        /** Accessibility label */
+        ariaLabel?: string;
+    };
+    /** Props passed to the IconButton component */
+    IconButtonProps?: IconButtonProps;
+    /** Props passed to the Menu component */
+    MenuProps?: Partial<MenuProps>;
+    /** Custom icon to display */
+    Icon?: ReactNode;
+}

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

@@ -1,2 +1,2 @@
 import { DownloadProps } from './types';
-export declare function Download({ id, labels, Icon, IconButtonProps, }: DownloadProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Download({ id, items, labels, Icon, IconButtonProps, }: DownloadProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/download/exports.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from 'react';
 import { DownloadItem } from './types';
 export declare const downloadToCSV: DownloadItem<unknown[][]>;
-export declare const downloadToPNG: Omit<DownloadItem<unknown[][]>, 'modifier'> & {
+export declare const downloadToPNG: Omit<DownloadItem, 'modifier'> & {
     modifier: (ref: Ref<HTMLElement | null> | undefined) => Promise<string | undefined>;
 };

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

@@ -1,6 +1,6 @@
 import { JSX, ReactNode } from 'react';
-import { BaseWidgetState } from '../../stores/types';
 import { IconButtonProps } from '@mui/material';
+import { WidgetState } from '../../stores/types';
 export interface DownloadItem<D = unknown> {
     id: string;
     label: string;
@@ -10,17 +10,9 @@ export interface DownloadItem<D = unknown> {
     modifier: (data: D) => Promise<string | undefined>;
     callback?: (data: string) => void;
 }
-export type DownloadState<T = unknown, D = unknown> = BaseWidgetState<T & DownloadConfigProps<D>>;
-export interface DownloadConfig<D = unknown> {
-    enabled?: boolean;
-    isDownloading: boolean;
-    items: DownloadItem<D>[];
-}
-export interface DownloadConfigProps<D = unknown> {
-    downloadConfig: DownloadConfig<D>;
-}
 export interface DownloadProps {
-    id: DownloadState['id'];
+    id: WidgetState['id'];
+    items: DownloadItem[];
     labels?: {
         ariaLabel?: string;
     };

package/dist/types/widgets/actions/fullscreen/fullscreen.d.ts

@@ -1,2 +1,2 @@
 import { FullScreenProps } from './types';
-export declare function FullScreen({ id, labels, children, Icon, IconButtonProps, }: FullScreenProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function FullScreen({ id, labels, children, Icon, IconButtonProps, DialogContentProps: { sx, ...DialogContentProps }, }: FullScreenProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/fullscreen/styles.d.ts

@@ -1,3 +1,4 @@
+import { Theme } from '@mui/material';
 export declare const styles: {
     title: {
         container: {
@@ -7,4 +8,9 @@ export declare const styles: {
             gap: number;
         };
     };
+    content: {
+        display: "flex";
+        flexDirection: "column";
+        gap: ({ spacing }: Theme) => string;
+    };
 };

package/dist/types/widgets/actions/fullscreen/types.d.ts

@@ -1,21 +1,20 @@
-import { IconButtonProps } from '@mui/material';
+import { DialogContentProps, IconButtonProps } from '@mui/material';
 import { ReactNode } from 'react';
-import { BaseWidgetState } from 'src/widgets/stores/types';
-export type FullScreenState<T = unknown> = BaseWidgetState<T & FullScreenConfigProps>;
+import { BaseWidgetState } from '../../../widgets/stores/types';
+export type FullScreenState<T = unknown> = BaseWidgetState<T & FullScreenConfigProps & {
+    title: string;
+}>;
 export interface FullScreenConfig {
-    enabled?: boolean;
     isFullScreen?: boolean;
 }
-export interface FullScreenConfigProps {
-    fullScreenConfig: FullScreenConfig;
-}
+export type FullScreenConfigProps = FullScreenConfig;
 export interface FullScreenProps {
     id: FullScreenState['id'];
-    labels: {
-        title: string;
+    labels?: {
         ariaLabel?: string;
     };
     children: ReactNode;
+    DialogContentProps?: DialogContentProps;
     IconButtonProps?: IconButtonProps;
     Icon?: ReactNode;
 }

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

@@ -1,5 +1,18 @@
 export { FullScreen } from './fullscreen/fullscreen';
 export type { FullScreenState, FullScreenConfig } from './fullscreen/types';
 export { Download } from './download/download';
-export type { DownloadState, DownloadItem, DownloadConfig, } from './download/types';
+export type { DownloadItem, DownloadProps } from './download/types';
 export { downloadToCSV, downloadToPNG } from './download/exports';
+export { RelativeData, RELATIVE_DATA_TOOL_ID, } from './relative-data/relative-data';
+export type { RelativeDataProps } from './relative-data/types';
+export { ZoomToggle } from './zoom-toggle/zoom-toggle';
+export type { ZoomToggleProps, ZoomState, ZoomConfig, } from './zoom-toggle/types';
+export { StackToggle } from './stack-toggle/stack-toggle';
+export type { StackToggleProps, StackToggleState } from './stack-toggle/types';
+export { Searcher, SEARCHER_TOOL_ID } from './searcher/searcher';
+export { SearcherToggle } from './searcher/searcher-toggle';
+export type { SearcherToggleProps, SearcherProps, SearcherFilterFn, SearcherState, } from './searcher/types';
+export { ChangeColumn } from './change-column/change-column';
+export type { ChangeColumnProps } from './change-column/types';
+export { LockSelection, LOCK_SELECTION_TOOL_ID, } from './lock-selection/lock-selection';
+export type { LockSelectionProps, LockSelectionState, } from './lock-selection/types';

package/dist/types/widgets/actions/lock-selection/lock-selection.d.ts

@@ -0,0 +1,19 @@
+import { LockSelectionProps } from './types';
+export declare const LOCK_SELECTION_TOOL_ID = "lock-selection";
+/**
+ * Widget action button to lock the current selection.
+ *
+ * When locked, the widget data is filtered to only show the selected items.
+ * The button is only visible when there are selected items.
+ * Registers a transformation tool in the widget pipeline when mounted.
+ *
+ * @example
+ * ```tsx
+ * <LockSelection
+ *   id="my-widget"
+ *   order={30}
+ *   selectedItems={selectedItems}
+ * />
+ * ```
+ */
+export declare function LockSelection({ id, selectedItems, order, labels, Icon, IconButtonProps, }: LockSelectionProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/actions/lock-selection/types.d.ts

@@ -0,0 +1,38 @@
+import { IconButtonProps } from '@mui/material';
+import { ReactNode } from 'react';
+import { BaseWidgetState } from '../../stores/types';
+/**
+ * Lock selection specific state properties.
+ */
+export interface LockSelectionStateProps {
+    /** Whether the selection is currently locked */
+    isLocked?: boolean;
+    /** The items that are locked (by name) */
+    lockedItems?: string[];
+}
+/**
+ * Widget state extension for lock selection functionality.
+ * Extends the base widget state with lock-specific properties.
+ */
+export type LockSelectionState<T = object> = BaseWidgetState<T & LockSelectionStateProps>;
+export interface LockSelectionProps {
+    /** Widget ID to store lock selection state */
+    id: string;
+    /** Currently selected items (by name) */
+    selectedItems: string[];
+    /** Execution order in the tool pipeline. Lower values execute first. Defaults to 30. */
+    order?: number;
+    /** Custom labels for the action */
+    labels?: {
+        /** Tooltip when unlocked (button will lock selection) */
+        lock?: string;
+        /** Tooltip when locked (button will unlock selection) */
+        unlock?: string;
+        /** Accessibility label */
+        ariaLabel?: string;
+    };
+    /** Props passed to the IconButton component */
+    IconButtonProps?: IconButtonProps;
+    /** Custom icon to display */
+    Icon?: ReactNode;
+}

package/dist/types/widgets/actions/relative-data/relative-data.d.ts

@@ -0,0 +1,18 @@
+import { RelativeDataProps } from './types';
+export declare const RELATIVE_DATA_TOOL_ID = "relative-data";
+/**
+ * Widget action to toggle between relative (percentage) and absolute data display.
+ *
+ * Registers a transformation tool in the widget pipeline when mounted.
+ * When relative mode is active, transforms data to percentages via the pipeline.
+ *
+ * @example
+ * ```tsx
+ * <RelativeData
+ *   id="my-widget"
+ *   order={20}
+ *   defaultIsRelative={false}
+ * />
+ * ```
+ */
+export declare function RelativeData({ id, order, defaultIsRelative, labels, Icon, IconButtonProps, }: RelativeDataProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/relative-data/style.d.ts

@@ -0,0 +1,8 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    trigger: {
+        '&[data-active="true"]': {
+            background: (theme: Theme) => string;
+        };
+    };
+};

package/dist/types/widgets/actions/relative-data/types.d.ts

@@ -0,0 +1,27 @@
+import { IconButtonProps } from '@mui/material';
+import { ReactNode } from 'react';
+import { BaseWidgetState } from '../../stores/types';
+export interface RelativeDataProps {
+    /** Widget ID to update data in the widget store */
+    id: string;
+    /** Execution order in the tool pipeline. Lower values execute first. Defaults to 20. */
+    order?: number;
+    /** Initial toggle state - when true, shows relative (percentage) values */
+    defaultIsRelative?: boolean;
+    /** Custom labels for the action */
+    labels?: {
+        /** Tooltip when showing absolute values (button will switch to relative) */
+        relative?: string;
+        /** Tooltip when showing relative values (button will switch to absolute) */
+        absolute?: string;
+        /** Accessibility label */
+        ariaLabel?: string;
+    };
+    /** Props passed to the IconButton component */
+    IconButtonProps?: IconButtonProps;
+    /** Custom icon to display */
+    Icon?: ReactNode;
+}
+export type RelativeDataState<T = unknown> = BaseWidgetState<T & {
+    isRelative?: boolean;
+}>;

package/dist/types/widgets/actions/relative-data/utils.d.ts

@@ -0,0 +1,9 @@
+import { EchartWidgetData } from '../../echart/types';
+/**
+ * Calculates the sum of all numeric values in the data
+ */
+export declare function calculateTotal(data: EchartWidgetData): number;
+/**
+ * Transforms data to relative (percentage) values
+ */
+export declare function toRelativeData(data: EchartWidgetData, total: number): EchartWidgetData;

package/dist/types/widgets/actions/relative-data/utils.test.d.ts

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

package/dist/types/widgets/actions/searcher/searcher-toggle.d.ts

@@ -0,0 +1,18 @@
+import { SearcherToggleProps } from './types';
+/**
+ * Widget action button to toggle search functionality.
+ *
+ * Stores the enabled state in the widget store using the provided id.
+ * When search is active, the button shows an active state with a light background.
+ * Use in conjunction with the Searcher component to display the search input.
+ *
+ * @example
+ * ```tsx
+ * <SearcherToggle id="my-widget" />
+ * <Searcher
+ *   id="my-widget"
+ *   data={widgetData}
+ * />
+ * ```
+ */
+export declare function SearcherToggle({ id, defaultEnabled, labels, Icon, IconButtonProps, }: SearcherToggleProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/searcher/searcher.d.ts

@@ -0,0 +1,21 @@
+import { SearcherProps } from './types';
+export declare const SEARCHER_TOOL_ID = "searcher";
+/**
+ * Search input component that works with SearcherToggle.
+ *
+ * Registers a transformation tool in the widget pipeline when mounted.
+ * Reads the enabled state from the widget store using the provided id.
+ * Uses a debounced search to filter data via the transformation pipeline.
+ * Auto-focuses when enabled becomes true.
+ *
+ * @example
+ * ```tsx
+ * <SearcherToggle id="my-widget" />
+ * <Searcher
+ *   id="my-widget"
+ *   order={10}
+ *   labels={{ placeholder: 'Search categories...' }}
+ * />
+ * ```
+ */
+export declare function Searcher({ id, filterFn, order, labels, TextFieldProps, ClearIcon, debounceDelay, }: SearcherProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/actions/searcher/types.d.ts

@@ -0,0 +1,64 @@
+import { IconButtonProps, TextFieldProps } from '@mui/material';
+import { ReactNode } from 'react';
+import { EchartWidgetData } from '../../echart/types';
+import { BaseWidgetState } from '../../stores/types';
+/**
+ * Filter function type for custom search filtering logic.
+ * Receives the original data and search text, returns filtered data.
+ * Can be synchronous or asynchronous to support remote filtering.
+ */
+export type SearcherFilterFn = (data: EchartWidgetData, searchText: string) => Promise<EchartWidgetData> | EchartWidgetData;
+/**
+ * Searcher-specific state properties.
+ */
+export interface SearcherStateProps {
+    /** Whether search is currently enabled */
+    isSearchEnabled?: boolean;
+    /** Current search text */
+    searchText?: string;
+}
+/**
+ * Widget state extension for searcher functionality.
+ * Extends the base widget state with search-specific properties.
+ */
+export type SearcherState<T = object> = BaseWidgetState<T & SearcherStateProps>;
+export interface SearcherToggleProps {
+    /** Widget ID to store search enabled state */
+    id: string;
+    /** Initial search enabled state. Defaults to false */
+    defaultEnabled?: boolean;
+    /** Custom labels for the action */
+    labels?: {
+        /** Tooltip when search is disabled (button will enable search) */
+        enable?: string;
+        /** Tooltip when search is enabled (button will disable search) */
+        disable?: string;
+        /** Accessibility label */
+        ariaLabel?: string;
+    };
+    /** Props passed to the IconButton component */
+    IconButtonProps?: IconButtonProps;
+    /** Custom icon to display */
+    Icon?: ReactNode;
+}
+export interface SearcherProps {
+    /** Widget ID to update filtered data in the widget store */
+    id: string;
+    /** Custom filter function. Defaults to case-insensitive search across all string fields */
+    filterFn?: SearcherFilterFn;
+    /** Execution order in the tool pipeline. Lower values execute first. Defaults to 10. */
+    order?: number;
+    /** Custom labels for the searcher input */
+    labels?: {
+        /** Placeholder text for the input */
+        placeholder?: string;
+        /** Accessibility label for clear button */
+        clearAriaLabel?: string;
+    };
+    /** Props passed to the TextField component */
+    TextFieldProps?: Omit<TextFieldProps, 'value' | 'onChange' | 'size'>;
+    /** Custom icon for clear button */
+    ClearIcon?: ReactNode;
+    /** Debounce delay in milliseconds for search input. Defaults to 300ms */
+    debounceDelay?: number;
+}