@carto/ps-react-ui 4.2.7 → 4.3.0

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/scatterplot/config.d.ts

@@ -0,0 +1,5 @@
+import { ScatterplotConfig, ScatterplotWidgetConfig, ScatterplotWidgetData } from './types';
+import { DownloadItem } from '../actions';
+import { ConfigProps } from '../loader/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 '../loader';
+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 { WidgetSelectionSummary } from './selection-summary';
+export type { WidgetSelectionSummaryProps, SelectionSummaryLabels, } from './types';

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

@@ -0,0 +1,2 @@
+import { WidgetSelectionSummaryProps } from './types';
+export declare function WidgetSelectionSummary({ selections, onClear, labels, }: WidgetSelectionSummaryProps): 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 WidgetSelectionSummaryProps {
+    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 '../loader/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,165 @@
+import { RefObject } from 'react';
+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?: {
+        title?: string;
+        message?: 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[];
+    /** Formatter function for widget values */
+    formatter?: (value: number) => string;
+    /** Locale for number formatting (e.g., 'en-US', 'es-ES', 'fr-FR') */
+    locale?: string;
+}
+/**
+ * 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;
+    /**
+     * 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;

package/dist/types/widgets/stores/widget-store.d.ts

@@ -0,0 +1,39 @@
+import { WidgetStore } from './types';
+/**
+ * Zustand store for managing widget state across the application.
+ *
+ * This store provides centralized state management for all widget UI components
+ *
+ * @example
+ * ```tsx
+ * // Import the store
+ * import { useWidgetStore } from '@carto/ps-react-ui/widgets'
+ *
+ * // Use in a component
+ * function MyWidget() {
+ *   const setWidget = useWidgetStore((state) => state.setWidget)
+ *   const widget = useWidgetStore((state) => state.widgets['my-widget'])
+ *
+ *   useEffect(() => {
+ *     setWidget({
+ *       id: 'my-widget',
+ *       type: 'formula',
+ *       title: 'Total Sales',
+ *       isLoading: false,
+ *       visible: true,
+ *       data: { value: 1000, prefix: '$' }
+ *     })
+ *   }, [setWidget])
+ *
+ *   return <div>{widget?.data?.value}</div>
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Get widgets by type
+ * const getWidgetsByType = useWidgetStore((state) => state.getWidgetsByType)
+ * const formulaWidgets = getWidgetsByType('formula')
+ * ```
+ */
+export declare const useWidgetStore: import('node_modules/zustand/esm/react.mjs').UseBoundStore<import('node_modules/zustand/esm/vanilla.mjs').StoreApi<WidgetStore>>;

package/dist/types/widgets/stores/widget-store.test.d.ts

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

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

@@ -0,0 +1,2 @@
+export { WidgetSubHeader } from './subheader';
+export type { WidgetSubHeaderProps } from './types';

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

@@ -0,0 +1,19 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        display: "flex";
+        alignItems: "center";
+        gap: ({ spacing }: Theme) => string;
+        minHeight: ({ spacing }: Theme) => string;
+    };
+    slotLeft: {
+        flexShrink: number;
+    };
+    slotRight: {
+        flexGrow: number;
+        display: "flex";
+        justifyContent: "flex-end";
+        alignItems: "center";
+        gap: ({ spacing }: Theme) => string;
+    };
+};

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

@@ -0,0 +1,2 @@
+import { WidgetSubHeaderProps } from './types';
+export declare function WidgetSubHeader({ slotLeft, slotRight, sx, }: WidgetSubHeaderProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import { SxProps, Theme } from '@mui/material';
+import { ReactNode } from 'react';
+export interface WidgetSubHeaderProps {
+    /** Content for the left slot */
+    slotLeft?: ReactNode;
+    /** Content for the right slot*/
+    slotRight?: ReactNode;
+    /** Custom styles */
+    sx?: SxProps<Theme>;
+}

package/dist/types/widgets/table/components/cell-header.d.ts

@@ -0,0 +1,5 @@
+import { CellHeaderProps } from '../types';
+/**
+ * Table cell header component with optional sorting and select-all checkbox
+ */
+export declare function CellHeader({ column, sortState, onSort, isSelectAll, isAllSelected, isIndeterminate, onSelectAll, }: CellHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/table/components/cell.d.ts

@@ -0,0 +1,16 @@
+import { TableColumn } from '../types';
+/**
+ * Props for Cell component
+ */
+export interface CellProps {
+    /** Column definition */
+    column: TableColumn;
+    /** Cell value */
+    value: unknown;
+}
+/**
+ * Table cell component with automatic markdown support for string values
+ * Markdown is rendered when the raw value is a string and no formatter is defined.
+ * If a formatter is used, its output is rendered directly without markdown parsing.
+ */
+export declare function Cell({ column, value }: CellProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/table/components/index.d.ts

@@ -0,0 +1,4 @@
+export { CellHeader } from './cell-header';
+export { Row } from './row';
+export { Pagination } from './pagination';
+export { PaginationActions } from './pagination-actions';

package/dist/types/widgets/table/components/pagination-actions.d.ts

@@ -0,0 +1,5 @@
+import { PaginationActionsProps } from '../types';
+/**
+ * Custom pagination actions with first/prev/next/last buttons
+ */
+export declare function PaginationActions({ count, page, rowsPerPage, onPageChange, }: PaginationActionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/table/components/pagination.d.ts

@@ -0,0 +1,5 @@
+import { PaginationProps } from '../types';
+/**
+ * Table pagination component
+ */
+export declare function Pagination({ page, rowsPerPage, total, rowsPerPageOptions, onPageChange, onRowsPerPageChange, }: PaginationProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/table/components/row.d.ts

@@ -0,0 +1,5 @@
+import { RowProps } from '../types';
+/**
+ * Table row component with selection and hover support
+ */
+export declare function Row({ row, columns, isSelected, selectable, onClick, onSelect, onMouseEnter, onMouseLeave, }: RowProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,17 @@
+import { ConfigProps } from '../loader/types';
+import { TableDownloadConfig, TableWidgetConfig, TableColumn, Mode, SortDirection } from './types';
+export declare const DEFAULT_MODE: Mode;
+export declare const DEFAULT_PAGE = 0;
+export declare const DEFAULT_ROWS_PER_PAGE = 10;
+export declare const DEFAULT_ROWS_PER_PAGE_OPTIONS: number[];
+export declare const DEFAULT_COLUMN_ID: null;
+export declare const DEFAULT_DIRECTION: SortDirection;
+/**
+ * Default table download configuration
+ * Supports PNG export (screenshot) and CSV export (data)
+ */
+export declare function tableDownloadConfig({ refUI, }: ConfigProps): TableDownloadConfig;
+/**
+ * Default table widget configuration
+ */
+export declare function tableConfig(columns?: TableColumn[]): TableWidgetConfig;

package/dist/types/widgets/table/helpers.d.ts

@@ -0,0 +1,38 @@
+import { ReactNode } from 'react';
+/**
+ * Get formatted cell value for display
+ * Handles primitives, arrays, objects, and custom formatters
+ *
+ * @param cellValue - Raw cell value
+ * @param formatter - Optional formatter function
+ * @returns Formatted value for display
+ */
+export declare function getCellValue<T>(cellValue: T): ReactNode;
+/**
+ * Compare two values for sorting
+ * Handles strings, numbers, and other types
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @param direction - Sort direction
+ * @returns Comparison result (-1, 0, 1)
+ */
+export declare function compareValues(a: unknown, b: unknown, direction: 'asc' | 'desc'): number;
+/**
+ * Sort data array by column
+ *
+ * @param data - Data array to sort
+ * @param columnId - Column ID to sort by
+ * @param direction - Sort direction
+ * @returns Sorted data array (new array, does not mutate original)
+ */
+export declare function sortData<T extends Record<string, unknown>>(data: T[], columnId: string, direction: 'asc' | 'desc'): T[];
+/**
+ * Paginate data array
+ *
+ * @param data - Data array to paginate
+ * @param page - Current page (0-indexed)
+ * @param rowsPerPage - Number of rows per page
+ * @returns Paginated data slice
+ */
+export declare function paginateData<T>(data: T[], page: number, rowsPerPage: number): T[];

package/dist/types/widgets/table/helpers.test.d.ts

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

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

@@ -0,0 +1,6 @@
+export { usePagination } from './use-pagination';
+export { useSort } from './use-sort';
+export { useSelection } from './use-selection';
+export type { UsePaginationResult } from './use-pagination';
+export type { UseSortResult } from './use-sort';
+export type { UseSelectionOptions, UseSelectionResult } from './use-selection';