@carto/ps-react-ui 4.2.7 → 5.0.0-widgets.1

package/dist/types/widgets/note/style.d.ts

@@ -0,0 +1,28 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        typography: string;
+        color: (theme: Theme) => string;
+        marginBlockStart: ({ spacing }: Theme) => string;
+    };
+    clamped: {
+        display: "-webkit-box";
+        WebkitLineClamp: number;
+        WebkitBoxOrient: "vertical";
+        overflow: "hidden";
+    };
+    expanded: {
+        display: "block";
+    };
+    linkButton: {
+        padding: number;
+        minWidth: string;
+        textTransform: "none";
+        typography: string;
+        fontWeight: number;
+        textDecoration: string;
+        '&:hover': {
+            backgroundColor: "transparent";
+        };
+    };
+};

package/dist/types/widgets/note/types.d.ts

@@ -0,0 +1,8 @@
+import { MarkdownComponentProps } from '../markdown';
+export interface NoteProps {
+    children: MarkdownComponentProps['children'];
+    labels?: {
+        showMore?: string;
+        showLess?: string;
+    };
+}

package/dist/types/widgets/pie/config.d.ts

@@ -0,0 +1,5 @@
+import { PieConfig, PieWidgetConfig, PieWidgetData } from './types';
+import { DownloadItem } from '../actions';
+import { ConfigProps } from '../root/types';
+export declare function pieDownloadConfig({ refUI, }: ConfigProps): DownloadItem<PieWidgetData>[];
+export declare function pieConfig(props: PieConfig): PieWidgetConfig;

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

@@ -0,0 +1,3 @@
+export type { PieWidgetData, PieWidgetState, PieWidgetConfig, PieConfig, } from './types';
+export { pieConfig, pieDownloadConfig } from './config';
+export { PieSkeleton } from './skeleton';

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

@@ -0,0 +1 @@
+export declare function PieSkeleton(): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/pie/style.d.ts

@@ -0,0 +1,15 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    skeleton: {
+        graph: {
+            readonly container: {
+                readonly display: "flex";
+                readonly alignItems: "center";
+                readonly justifyContent: "space-between";
+                readonly flexDirection: "column";
+                readonly gap: ({ spacing }: Theme) => string;
+                readonly height: ({ spacing }: Theme) => string;
+            };
+        };
+    };
+};

package/dist/types/widgets/pie/types.d.ts

@@ -0,0 +1,9 @@
+import { EchartWidgetData, EchartWidgetState } from '../echart';
+import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
+import { ConfigProps } from '../root';
+export type PieWidgetData = EchartWidgetData;
+export type PieWidgetState = EchartWidgetState;
+export type PieWidgetConfig = EchartWidgetProps & {
+    type: 'pie';
+};
+export type PieConfig = ConfigProps & EchartWidgetOptionProps<PieWidgetData>;

package/dist/types/widgets/range/components/range-item.d.ts

@@ -0,0 +1,2 @@
+import { RangeItemProps } from '../types';
+export declare function RangeItem({ id, index }: RangeItemProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/range/config.d.ts

@@ -0,0 +1,6 @@
+import { RangeWidgetConfig } from './types';
+export interface RangeConfigProps {
+    formatter?: (value: number) => string;
+    onChange?: (value: number[], index: number) => void;
+}
+export declare function rangeConfig(): RangeWidgetConfig;

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

@@ -0,0 +1,6 @@
+export { RangeUI } from './range-ui';
+export { RangeSkeleton } from './skeleton';
+export { rangeConfig } from './config';
+export { RangeItem } from './components/range-item';
+export type { RangeWidgetState, RangeWidgetConfig, RangeDownloadConfig, RangeUIProps, RangeDataItem, RangeWidgetData, RangeItemProps, } from './types';
+export { sanitizeRangeDataItem, sanitizeRangeDataItems } from './serializer';

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

@@ -0,0 +1,2 @@
+import { RangeUIProps } from './types';
+export declare function RangeUI(props: RangeUIProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/range/serializer.d.ts

@@ -0,0 +1,16 @@
+import { RangeDataItem } from './types';
+/**
+ * Sanitizes RangeDataItem by converting ReactNode note values to undefined.
+ * This ensures only string values are stored in the widget state.
+ *
+ * @param item - The RangeDataItem to sanitize
+ * @returns A new RangeDataItem with ReactNode note values converted to undefined
+ */
+export declare function sanitizeRangeDataItem(item: RangeDataItem): RangeDataItem;
+/**
+ * Sanitizes an array of RangeDataItems by converting ReactNode note values to undefined.
+ *
+ * @param items - Array of RangeDataItems to sanitize
+ * @returns A new array with sanitized RangeDataItems
+ */
+export declare function sanitizeRangeDataItems(items: RangeDataItem[] | undefined): RangeDataItem[] | undefined;

package/dist/types/widgets/range/serializer.test.d.ts

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

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

@@ -0,0 +1 @@
+export declare function RangeSkeleton(): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/range/style.d.ts

@@ -0,0 +1,2 @@
+import { SxProps, Theme } from '@mui/material';
+export declare const styles: Record<string, SxProps<Theme>>;

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

@@ -0,0 +1,33 @@
+import { ReactNode } from 'react';
+import { BaseWidgetState, WidgetsStoreProps } from '../stores/types';
+import { WrapperState } from '../wrapper/types';
+import { DownloadItem } from '../actions/download/types';
+export interface RangeUIProps {
+    id: WidgetsStoreProps['id'];
+}
+export interface RangeDataItem {
+    min: number;
+    max: number;
+    value?: number[];
+    step?: number;
+    marks?: boolean | {
+        value: number;
+        label?: string;
+    }[];
+    disabled?: boolean;
+    color?: string;
+    note?: string | ReactNode;
+}
+export interface RangeItemProps {
+    id: WidgetsStoreProps['id'];
+    index: number;
+}
+export type RangeWidgetData = RangeDataItem[];
+export type RangeWidgetState = BaseWidgetState<WrapperState<RangeWidgetConfig>> & {
+    data: RangeWidgetData;
+};
+export interface RangeWidgetConfig {
+    formatter?: (value: number) => string;
+    onChange?: (value: number[], index: number) => void;
+}
+export type RangeDownloadConfig = DownloadItem<RangeWidgetData>[];

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

@@ -0,0 +1,3 @@
+export { Root } from './root';
+export { mergeWidgetConfig } from './utils';
+export type { RootProps, ConfigProps } from './types';

package/dist/types/widgets/root/root.d.ts

@@ -0,0 +1,2 @@
+import { RootProps } from './types';
+export declare function Root<T>(props: RootProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/root/style.d.ts

@@ -0,0 +1,8 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        display: "flex";
+        flexDirection: "column";
+        gap: (theme: Theme) => string;
+    };
+};

package/dist/types/widgets/root/types.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { WidgetsStoreProps, WidgetState } from '../stores/types';
+export interface RootProps<T> extends WidgetsStoreProps {
+    children: ReactNode;
+    config?: T;
+}
+export interface ConfigProps {
+    refUI?: WidgetState['refUI'];
+}

package/dist/types/widgets/root/utils.d.ts

@@ -0,0 +1 @@
+export declare function mergeWidgetConfig<T>(...options: [T | undefined, T | undefined]): T;

package/dist/types/widgets/scatterplot/config.d.ts

@@ -0,0 +1,5 @@
+import { ScatterplotConfig, ScatterplotWidgetConfig, ScatterplotWidgetData } from './types';
+import { DownloadItem } from '../actions';
+import { ConfigProps } from '../root/types';
+export declare function scatterplotDownloadConfig({ refUI, }: ConfigProps): DownloadItem<ScatterplotWidgetData>[];
+export declare function scatterplotConfig(props: ScatterplotConfig): ScatterplotWidgetConfig;

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

@@ -0,0 +1,3 @@
+export type { ScatterplotWidgetData, ScatterplotWidgetState, ScatterplotWidgetConfig, ScatterplotConfig, } from './types';
+export { scatterplotConfig, scatterplotDownloadConfig } from './config';
+export { ScatterplotSkeleton } from './skeleton';

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

@@ -0,0 +1 @@
+export declare function ScatterplotSkeleton(): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/scatterplot/style.d.ts

@@ -0,0 +1,24 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    skeleton: {
+        graph: {
+            container: {
+                position: "relative";
+                display: "flex";
+                alignItems: "center";
+                justifyContent: "space-between";
+                flexDirection: "column";
+                gap: ({ spacing }: Theme) => string;
+                height: ({ spacing }: Theme) => string;
+            };
+        };
+        legend: {
+            display: "flex";
+            alignItems: "center";
+            gap: ({ spacing }: Theme) => string;
+            height: ({ spacing }: Theme) => string;
+            position: "absolute";
+            bottom: number;
+        };
+    };
+};

package/dist/types/widgets/scatterplot/types.d.ts

@@ -0,0 +1,9 @@
+import { EchartWidgetState } from '../echart';
+import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
+import { ConfigProps } from '../root';
+export type ScatterplotWidgetData = [number, number][][];
+export type ScatterplotWidgetState = EchartWidgetState;
+export type ScatterplotWidgetConfig = EchartWidgetProps & {
+    type: 'scatterplot';
+};
+export type ScatterplotConfig = ConfigProps & EchartWidgetOptionProps<ScatterplotWidgetData>;

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

@@ -0,0 +1,2 @@
+export { SelectionSummary } from './selection-summary';
+export type { SelectedProps, SelectionSummaryLabels } from './types';

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

@@ -0,0 +1,2 @@
+import { SelectedProps } from './types';
+export declare function SelectionSummary({ selections, onClear, labels, }: SelectedProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        display: "flex";
+        alignItems: "center";
+        flex: string;
+        gap: ({ spacing }: Theme) => string;
+    };
+};

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

@@ -0,0 +1,13 @@
+export interface SelectedProps {
+    selections: number;
+    onClear?: () => void;
+    labels?: Partial<SelectionSummaryLabels>;
+}
+export interface SelectionSummaryLabels {
+    /** Label for "All selected" state */
+    allSelected: string;
+    /** Label for number of selections */
+    selections: (count: number) => string;
+    /** Label for clear button */
+    clear: string;
+}

package/dist/types/widgets/skeleton-loader/index.d.ts

@@ -0,0 +1,2 @@
+export { SkeletonLoader } from './skeleton-loader';
+export type { SkeletonLoaderProps } from './types';

package/dist/types/widgets/skeleton-loader/skeleton-loader.d.ts

@@ -0,0 +1,2 @@
+import { SkeletonLoaderProps } from './types';
+export declare function SkeletonLoader({ id, children, Skeleton, }: SkeletonLoaderProps): string | number | bigint | boolean | Iterable<import('react').ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<import('react').ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;

package/dist/types/widgets/skeleton-loader/types.d.ts

@@ -0,0 +1,7 @@
+import { ElementType, ReactNode } from 'react';
+import { WidgetState } from '../stores/types';
+export interface SkeletonLoaderProps {
+    id: WidgetState['id'];
+    Skeleton: ElementType | null;
+    children: ReactNode;
+}

package/dist/types/widgets/spread/components/max-value.d.ts

@@ -0,0 +1,2 @@
+import { ValueProps } from '../types';
+export declare function MaxValue({ id, index, ...props }: ValueProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/spread/components/min-value.d.ts

@@ -0,0 +1,2 @@
+import { ValueProps } from '../types';
+export declare function MinValue({ id, index, ...props }: ValueProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/spread/components/separator.d.ts

@@ -0,0 +1,2 @@
+import { ItemProps } from '../../formula/types';
+export declare function Separator(props: Omit<ItemProps, 'children'>): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/spread/config.d.ts

@@ -0,0 +1,10 @@
+import { DownloadItem } from '../actions';
+import { ConfigProps } from '../root/types';
+import { SpreadWidgetConfig, SpreadWidgetData } from './types';
+import { SeriesConfig } from '../formula/types';
+export interface SpreadConfigProps {
+    formatter?: (value: number) => string;
+    series?: SeriesConfig[];
+}
+export declare function spreadDownloadConfig({ refUI, }: ConfigProps): DownloadItem<SpreadWidgetData>[];
+export declare function spreadConfig(): SpreadWidgetConfig;

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

@@ -0,0 +1,9 @@
+export { SpreadUI } from './spread-ui';
+export { SpreadSkeleton } from './skeleton';
+export { spreadConfig, spreadDownloadConfig } from './config';
+export { MinValue } from './components/min-value';
+export { MaxValue } from './components/max-value';
+export { Separator } from './components/separator';
+export { Item, Row, Prefix, Suffix, Series } from '../formula';
+export type { RowProps, ValueProps, SpreadWidgetState, SpreadWidgetConfig, SpreadWidgetData, SpreadDownloadConfig, ItemProps, SpreadDataItem, SpreadUIProps, } from './types';
+export type { SeriesConfig } from '../formula/types';

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

@@ -0,0 +1 @@
+export declare function SpreadSkeleton(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+import { SpreadUIProps } from './types';
+export declare function SpreadUI(props: SpreadUIProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/spread/style.d.ts

@@ -0,0 +1,21 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        display: "flex";
+        flexDirection: "column";
+        gap: (theme: Theme) => string;
+    };
+    item: {
+        '&[data-disabled="true"]': {
+            color: (theme: Theme) => string;
+        };
+    };
+    row: {
+        display: "flex";
+        alignItems: "center";
+        gap: (theme: Theme) => string;
+        '& + &': {
+            marginTop: (theme: Theme) => string;
+        };
+    };
+};

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

@@ -0,0 +1,40 @@
+import { TypographyProps } from '@mui/material';
+import { ReactNode } from 'react';
+import { BaseWidgetState, WidgetsStoreProps } from '../stores/types';
+import { WrapperState } from '../wrapper/types';
+import { DownloadItem } from '../actions/download/types';
+import { SeriesConfig } from '../formula/types';
+export interface SpreadUIProps {
+    id: WidgetsStoreProps['id'];
+}
+export interface SpreadDataItem {
+    min: number;
+    max: number;
+    prefix?: string | ReactNode;
+    suffix?: string | ReactNode;
+    color?: string;
+}
+export interface RowProps {
+    id: WidgetsStoreProps['id'];
+    children: ReactNode | ((props: {
+        index: number;
+    }) => ReactNode);
+}
+export interface ValueProps extends Omit<ItemProps, 'children'> {
+    id: WidgetsStoreProps['id'];
+    index?: number;
+}
+export interface ItemProps {
+    children: ReactNode;
+    disabled?: boolean;
+    TypographyProps?: TypographyProps;
+}
+export type SpreadWidgetData = SpreadDataItem[];
+export type SpreadWidgetState = BaseWidgetState<WrapperState<SpreadWidgetConfig> & {
+    data: SpreadWidgetData;
+}>;
+export interface SpreadWidgetConfig {
+    formatter?: (value: number) => string;
+    series?: SeriesConfig[];
+}
+export type SpreadDownloadConfig = DownloadItem<SpreadWidgetData>[];

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

@@ -0,0 +1,2 @@
+export { useWidgetStore } from './widget-store';
+export type { BaseWidgetState, WidgetsStoreProps, WidgetState, WidgetStore, WidgetStoreActions, WidgetStoreState, } from './types';

package/dist/types/widgets/stores/types.d.ts

@@ -0,0 +1,233 @@
+import { RefObject } from 'react';
+/**
+ * Sort direction for table columns
+ */
+export type StoreSortDirection = 'asc' | 'desc';
+/**
+ * Pagination mode for tables
+ */
+export type StorePaginationMode = 'local' | 'remote';
+/**
+ * Sort mode for tables
+ */
+export type StoreSortMode = 'local' | 'remote';
+/**
+ * Table pagination state stored in widget store
+ */
+export interface TablePaginationStoreState {
+    /** Current page (0-indexed) */
+    page: number;
+    /** Rows per page */
+    rowsPerPage: number;
+    /** Available rows per page options */
+    rowsPerPageOptions: number[];
+    /** Pagination mode: local or remote */
+    mode: StorePaginationMode;
+}
+/**
+ * Table sort state stored in widget store
+ */
+export interface TableSortStoreState {
+    /** Column ID being sorted */
+    columnId: string | null;
+    /** Sort direction */
+    direction: StoreSortDirection;
+    /** Sort mode: local or remote */
+    mode: StoreSortMode;
+}
+/**
+ * Table selection state stored in widget store
+ */
+export interface TableSelectionStoreState {
+    /** Set of selected row IDs */
+    selectedIds: Set<string | number>;
+}
+/**
+ * Combined table state for widget store
+ */
+export interface TableStoreState {
+    pagination?: TablePaginationStoreState;
+    sort?: TableSortStoreState;
+    selection?: TableSelectionStoreState;
+}
+export interface WidgetsStoreProps {
+    /** Unique identifier for the widget */
+    id: string;
+    /** Type of widget */
+    type: string;
+    /** Widget data - flexible to accommodate different widget types */
+    data: unknown;
+    /** Loading state */
+    isLoading: boolean;
+    /** Fetching state (e.g., for async data) */
+    isFetching: boolean;
+    /** Error message if any */
+    error?: string;
+    /** Whether widget is visible */
+    visible?: boolean;
+    /** Reference to the widget ui instance */
+    refUI?: RefObject<HTMLElement | null>;
+    /** Registered tools for the widget's transformation pipeline */
+    registeredTools?: ToolRegistration[];
+}
+/**
+ * Tool transformation function type
+ * Can be synchronous or asynchronous to support remote operations
+ */
+export type ToolTransformFunction = (data: unknown, config?: Record<string, unknown>) => Promise<unknown> | unknown;
+/**
+ * Tool registration for widget pipeline
+ *
+ * @example Basic tool registration
+ * ```typescript
+ * registerTool(widgetId, {
+ *   id: 'searcher',
+ *   order: 10,
+ *   enabled: true,
+ *   fn: (data) => filterData(data),
+ * })
+ * ```
+ *
+ * @example Tool with dependencies
+ * ```typescript
+ * registerTool(widgetId, {
+ *   id: 'lock-selection',
+ *   order: 20,
+ *   enabled: true,
+ *   fn: (data) => lockData(data),
+ *   disables: ['searcher', 'relative-data'], // Disable these when active
+ * })
+ * ```
+ *
+ * Dependency Management:
+ * - Multiple tools can disable the same target (reference counting)
+ * - Target is only re-enabled when ALL disabling tools are inactive
+ * - Original enabled state is preserved and restored
+ * - Circular dependencies are detected and throw errors
+ */
+export interface ToolRegistration {
+    /** Unique tool identifier (e.g., 'searcher', 'relative-data') */
+    id: string;
+    /** Execution priority - lower numbers execute first */
+    order: number;
+    /** Transformation function */
+    fn: ToolTransformFunction;
+    /** Whether tool is currently enabled */
+    enabled: boolean;
+    /** Tool-specific configuration */
+    config?: Record<string, unknown>;
+    /**
+     * Array of tool IDs to disable when this tool is active.
+     * During pipeline execution, if this tool is enabled, any tools listed
+     * in this array will be excluded from the pipeline.
+     *
+     * @example
+     * ```typescript
+     * disables: ['searcher', 'relative-data']
+     * ```
+     */
+    disables?: string[];
+}
+/**
+ * Base widget state interface
+ */
+export type BaseWidgetState<T> = WidgetsStoreProps & T;
+/**
+ * Union type for all widget states
+ */
+export type WidgetState = BaseWidgetState<unknown>;
+/**
+ * Widget store state with tool registration
+ */
+export interface WidgetStoreState {
+    /** Map of widget id to widget state */
+    widgets: Record<string, WidgetState>;
+}
+/**
+ * Widget store actions
+ */
+export interface WidgetStoreActions {
+    /**
+     * Add or update a widget in the store
+     * @param id - Widget ID
+     * @param widget - Widget state properties to merge (accepts any object structure)
+     * @template T - Type of the widget state for type-safe access
+     */
+    setWidget: <T = any>(id: WidgetState['id'], widget: Partial<T>) => void;
+    /**
+     * Remove a widget from the store
+     * @param id - Widget ID to remove
+     */
+    removeWidget: (id: WidgetState['id']) => void;
+    /**
+     * Clear all widgets
+     */
+    clearWidgets: () => void;
+    /**
+     * Get widget by ID
+     * @param id - Widget ID
+     * @returns Widget state or undefined if not found
+     */
+    getWidget: <T extends WidgetState = WidgetState>(id: WidgetState['id']) => T | undefined;
+    /**
+     * Set table pagination state for a widget
+     * @param id - Widget ID
+     * @param pagination - Partial pagination state to merge
+     */
+    setTablePagination: (id: WidgetState['id'], pagination: Partial<TablePaginationStoreState>) => void;
+    /**
+     * Set table sort state for a widget
+     * @param id - Widget ID
+     * @param sort - Partial sort state to merge
+     */
+    setTableSort: (id: WidgetState['id'], sort: Partial<TableSortStoreState>) => void;
+    /**
+     * Set table selection state for a widget
+     * @param id - Widget ID
+     * @param selection - Partial selection state to merge
+     */
+    setTableSelection: (id: WidgetState['id'], selection: Partial<TableSelectionStoreState>) => void;
+    /**
+     * Get table state for a widget
+     * @param id - Widget ID
+     * @returns Table state or undefined if not found
+     */
+    getTableState: (id: WidgetState['id']) => TableStoreState | undefined;
+    /**
+     * Register a tool with the widget's transformation pipeline
+     * @param widgetId - Widget ID
+     * @param tool - Tool registration object
+     */
+    registerTool: (widgetId: string, tool: ToolRegistration) => void;
+    /**
+     * Unregister a tool from the widget's transformation pipeline
+     * @param widgetId - Widget ID
+     * @param toolId - Tool ID to remove
+     */
+    unregisterTool: (widgetId: string, toolId: string) => void;
+    /**
+     * Update tool configuration
+     * @param widgetId - Widget ID
+     * @param toolId - Tool ID
+     * @param config - New configuration to merge
+     */
+    updateToolConfig: (widgetId: string, toolId: string, config: Record<string, unknown>) => void;
+    /**
+     * Set tool enabled state
+     * @param widgetId - Widget ID
+     * @param toolId - Tool ID
+     * @param enabled - Whether tool should be enabled
+     */
+    setToolEnabled: (widgetId: string, toolId: string, enabled: boolean) => void;
+    /**
+     * Execute the tool transformation pipeline
+     * Supports both synchronous and asynchronous tools
+     * @param widgetId - Widget ID
+     * @param sourceData - Original data to transform
+     */
+    executeToolPipeline: (widgetId: string, sourceData: unknown) => Promise<void>;
+}
+/**
+ * Complete widget store interface
+ */
+export type WidgetStore = WidgetStoreState & WidgetStoreActions;