@wavemaker-ai/react-runtime 1.0.0-next.27766

package/components/data/table/props.d.ts

@@ -0,0 +1,1391 @@
+import { Dispatch, SetStateAction, RefObject, CSSProperties, ReactElement, ReactNode, MouseEvent } from "react";
+import { BaseProps, Prettify } from "@wavemaker-ai/react-runtime/higherOrder/props";
+import { ButtonProps } from "@mui/material";
+import { ColumnDef, Table } from "@tanstack/react-table";
+import { IAlignment, INavigation } from "../list/props";
+import { EditWidgetType } from "./utils";
+import { StorageType } from "../../../utils/state-persistance";
+import { LiveVariableConfig } from "@wavemaker-ai/react-runtime/variables/live-variable";
+export type TableEditMode = "inline" | "dialog" | "form" | "quickedit" | "none";
+export type TableActionPosition = "header" | "footer";
+export type TableFormPosition = "top" | "bottom";
+export type TablePanelSpacing = "normal" | "condensed";
+export type ToastType = "Success" | "Error" | "Info" | "Warning";
+export type TableFilterMode = "multicolumn" | "search";
+/**
+ * Props for the Table component.
+ */
+export interface TableProps {
+    /**
+     * Mode for editing table data.
+     * @default "none"
+     */
+    editmode?: TableEditMode;
+    /**
+     * Storage type for persisting table state.
+     */
+    statehandler?: StorageType;
+    /**
+     * Whether to show the row index column.
+     * @default false
+     */
+    showrowindex?: boolean;
+    /**
+     * Whether to show the table header.
+     * @default true
+     */
+    showheader?: boolean;
+    /**
+     * Whether to enable sorting on columns.
+     * @default true
+     */
+    enablesort?: boolean;
+    /**
+     * When true, clicking column header selects/deselects the column instead of sorting.
+     * @default false
+     */
+    enablecolumnselection?: boolean;
+    /**
+     * Whether to show navigation controls.
+     * @default true
+     */
+    shownavigation?: boolean;
+    /**
+     * Whether to show the total record count.
+     * @default false
+     */
+    showrecordcount?: boolean;
+    /**
+     * Whether to enable radio button selection.
+     * @default false
+     */
+    radioselect?: boolean;
+    /**
+     * Title for the radio selection column.
+     */
+    radioselecttitle?: string;
+    /**
+     * Accessible label for the radio selection column.
+     */
+    radioselectarialabel?: string;
+    /**
+     * Whether to enable multi-selection using checkboxes.
+     * @default false
+     */
+    multiselect?: boolean;
+    /**
+     * Title for the multi-selection column.
+     */
+    multiselecttitle?: string;
+    /**
+     * Accessible label for the multi-selection column.
+     */
+    multiselectarialabel?: string;
+    /**
+     * Whether to select the first row by default.
+     * @default false
+     */
+    gridfirstrowselect?: boolean;
+    /**
+     * When true (default), clicking anywhere on row selects it. When false, only radio/checkbox column click selects.
+     * @default true
+     */
+    isrowselectable?: boolean;
+    /**
+     * Whether row expansion is enabled.
+     * @default false
+     */
+    isrowexpansionenabled?: boolean;
+    /**
+     * Position of the form when editing.
+     */
+    formposition?: TableFormPosition;
+    /**
+     * CSS class to apply to rows.
+     */
+    rowClass?: string;
+    /**
+     * Spacing between table panels.
+     * @default "normal"
+     */
+    spacing?: TablePanelSpacing;
+    /**
+     * Title of the table.
+     */
+    title?: string;
+    /**
+     * Subheading text for the table.
+     */
+    subheading?: string;
+    /**
+     * CSS class for the table icon.
+     */
+    iconclass?: string;
+    /**
+     * URL for the table icon (.svg renders inline, other URLs as image).
+     */
+    iconurl?: string;
+    /**
+     * The collection of data items to display in the table.
+     */
+    dataset?: any[];
+    /**
+     * The type of navigation to use.
+     */
+    navigation?: INavigation;
+    /**
+     * Whether the table is dynamic.
+     */
+    isdynamictable?: boolean;
+    /**
+     * Reference key for the table.
+     */
+    table_reference?: string;
+    /**
+     * Name of the form associated with the table.
+     */
+    formName?: string;
+    /**
+     * Name of the parent form.
+     */
+    parentForm?: string;
+    /**
+     * Number of items per page.
+     * @default 10
+     */
+    pagesize?: number;
+    /**
+     * Alignment of navigation controls.
+     */
+    navigationalign?: IAlignment;
+    /**
+     * Maximum number of page links to show.
+     */
+    maxsize?: number;
+    /**
+     * Whether to show first/last page links.
+     */
+    boundarylinks?: boolean;
+    /**
+     * Whether to allow changing the page size.
+     */
+    allowpagesizechange?: boolean;
+    /**
+     * Available options for page size.
+     */
+    pagesizeoptions?: string;
+    /**
+     * Whether to load data on demand.
+     */
+    onDemandLoad?: boolean;
+    /**
+     * Mode for filtering table data.
+     */
+    filtermode?: TableFilterMode;
+    /**
+     * Label for the search box.
+     */
+    searchlabel?: string;
+    /**
+     * Whether to filter data on every key press in the search box.
+     */
+    filteronkeypress?: boolean;
+    /**
+     * Available formats for exporting data.
+     */
+    exportformat?: any[];
+    /**
+     * Options for exporting data.
+     */
+    exportOptions?: any[];
+    /**
+     * Maximum dataset size for export.
+     */
+    exportdatasize?: number;
+    /**
+     * Callback fired before exporting data.
+     */
+    onBeforeexport?: (data: any) => boolean | void;
+    /**
+     * Callback fired after exporting data.
+     */
+    onAfterexport?: (data: any) => void;
+    /**
+     * Message to confirm record deletion.
+     */
+    confirmdelete?: string;
+    /**
+     * Text for the delete confirm button.
+     */
+    deleteoktext?: string;
+    /**
+     * Text for the delete cancel button.
+     */
+    deletecanceltext?: string;
+    /**
+     * Error message to display.
+     */
+    errormessage?: string;
+    /**
+     * Message to display when no data is available.
+     */
+    nodatamessage?: string;
+    /**
+     * Message to display while loading data.
+     */
+    loadingdatamsg?: string;
+    /**
+     * Number of skeleton body rows shown while loading.
+     * @default 5
+     */
+    skeletonRows?: number;
+    /**
+     * Number of skeleton columns shown while loading.
+     * @default 4
+     */
+    skeletonColumns?: number;
+    /**
+     * Message to display after successful record insertion.
+     */
+    insertmessage?: string;
+    /**
+     * Message to display after successful record update.
+     */
+    updatemessage?: string;
+    /**
+     * Message to display after successful record deletion.
+     */
+    deletemessage?: string;
+    /**
+     * Message for on-demand loading button.
+     */
+    ondemandmessage?: string;
+    /**
+     * Message for view-less button.
+     */
+    viewlessmessage?: string;
+    /**
+     * Whether to show the view-less button.
+     */
+    showviewlessbutton?: boolean;
+    /**
+     * Callback fired when a row is deleted.
+     */
+    onRowDelete?: (deletedRowData: any, deletedRowIndex: number, updatedDataset: any[]) => void;
+    /**
+     * Callback fired when a row is updated.
+     */
+    onRowUpdate?: (updatedRowData: any, rowIndex: number, updatedDataset: any[]) => void;
+    /**
+     * Callback fired when a row is clicked.
+     */
+    onRowclick?: (event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired before data is rendered.
+     */
+    onBeforedatarender?: (widget: any, data: any, columns: any) => void;
+    /**
+     * Callback fired after data is rendered.
+     */
+    onDatarender?: (widget: any, data: any) => void;
+    /**
+     * Callback fired when a column is selected.
+     */
+    onColumnselect?: (event: React.MouseEvent, data: {
+        field: string;
+        colDef: any;
+        data: any[];
+    }) => void;
+    /**
+     * Callback fired when a column is deselected.
+     */
+    onColumndeselect?: (event: React.MouseEvent, data: {
+        field: string;
+        colDef: any;
+        data: any[];
+    }) => void;
+    /**
+     * Callback fired when data is sorted.
+     */
+    onSort?: (event: any, widget: any, data: any) => void;
+    /**
+     * Callback fired before a row is deleted.
+     */
+    onBeforerowdelete?: (event: any, widget: any, row: any, options: any) => void | boolean | Promise<void | boolean>;
+    /**
+     * Callback fired before filtering data.
+     */
+    onBeforefilter?: (widget: any, filterFields: any) => void | boolean | Promise<void | boolean>;
+    /**
+     * Callback fired when a header is clicked.
+     */
+    onHeaderclick?: (event: any, widget: any, column: any) => void;
+    /**
+     * Callback fired when a row is selected.
+     */
+    onRowselect?: (event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired when a row is deselected.
+     */
+    onRowdeselect?: (event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired when a record is set.
+     */
+    onSetrecord?: (event: React.SyntheticEvent, widget: unknown, data: any, pageInfo: any) => void;
+    /**
+     * Children components (columns, actions, etc.).
+     */
+    children: ReactNode;
+    /**
+     * Callback fired when a row is inserted.
+     */
+    onRowinsert?: (event: any, widget: any, data: any) => void;
+    /**
+     * Callback fired when a row is updated.
+     */
+    onRowupdate?: (event: any, widget: any, data: any) => void;
+    /**
+     * Callback fired when a row is deleted.
+     */
+    onRowdelete?: (event: any, widget: any, row: any) => void;
+    /**
+     * Data source for the table.
+     */
+    datasource?: LiveVariableConfig;
+    /**
+     * Binding path for the dataset.
+     */
+    binddataset?: string;
+    /**
+     * Callback fired on successful operation.
+     */
+    onSuccess?: (operation: string, data: any) => void;
+    /**
+     * Callback fired on operation error.
+     */
+    onError?: (event: any, widget: any, data: any, operation: string) => void;
+    customExpressionColumns?: Record<string, (rowData: any) => ReactNode>;
+}
+/**
+ * Combined props for the WmTable component, including base WaveMaker props.
+ */
+export type WmTableProps = Prettify<TableProps & BaseProps>;
+/**
+ * Props for the Table Column component.
+ */
+export interface TableColumnProps {
+    /**
+     * Reference to the parent listener.
+     */
+    listener: any;
+    /**
+     * Data binding path for the column.
+     */
+    binding: string;
+    /**
+     * Field name of the data source.
+     */
+    field: string;
+    /**
+     * Visible caption for the column header.
+     */
+    caption: string;
+    /**
+     * CSS class to apply to the column.
+     */
+    colClass?: string;
+    /**
+     * Display name of the column.
+     */
+    displayName?: string;
+    /**
+     * Default widget type to use for rendering the column.
+     */
+    widgetType: "label" | "button" | string;
+    /**
+     * Widget type to use when the row is in edit mode.
+     */
+    editWidgetType?: EditWidgetType;
+    /**
+     * Whether to show or hide the column.
+     * @default true
+     */
+    show?: boolean;
+    /**
+     * Whether to display on PC.
+     */
+    pcdisplay?: boolean;
+    /**
+     * Whether to display on mobile devices.
+     */
+    mobiledisplay?: boolean;
+    /**
+     * Whether to display on tablets.
+     */
+    tabletdisplay?: boolean;
+    /**
+     * Index of the column in the table.
+     */
+    index: number;
+    /**
+     * Index for header grouping.
+     */
+    headerindex: string;
+    /**
+     * Whether the column is sortable.
+     */
+    sortable?: boolean;
+    /**
+     * Field to sort by.
+     */
+    sortby?: string;
+    /**
+     * Text alignment for the column content.
+     */
+    textalignment?: IAlignment;
+    /**
+     * Background color for the column.
+     */
+    backgroundcolor?: string;
+    /**
+     * Text color for the column.
+     */
+    textcolor?: string;
+    /**
+     * Width of the column.
+     */
+    width?: string;
+    /**
+     * CSS class to apply.
+     */
+    className?: string;
+    /**
+     * CSS styles to apply.
+     */
+    styles?: CSSProperties;
+    /**
+     * Whether the field is required.
+     */
+    required?: boolean;
+    /**
+     * Default value for the field.
+     */
+    defaultvalue?: string | number | boolean;
+    /**
+     * Whether the field is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Placeholder text for the field.
+     */
+    placeholder?: string;
+    /**
+     * Whether the field is read-only.
+     */
+    readonly?: boolean;
+    /**
+     * Type of input for the edit widget.
+     */
+    editinputtype?: "color" | "date" | "datetime-local" | "email" | "month" | "number" | "password" | "search" | "tel" | "text" | "time" | "url" | "week";
+    /**
+     * Position for row operations columns.
+     */
+    rowactionsposition?: number;
+    /**
+     * Data type of the column.
+     */
+    type?: string;
+    /**
+     * Underlying type of the column.
+     */
+    columntype?: string;
+    /**
+     * Whether the column is searchable.
+     */
+    searchable?: boolean;
+    /**
+     * Whether to show the column in filters.
+     */
+    showinfilter?: boolean;
+    /**
+     * Children components.
+     */
+    children?: ReactNode;
+    validationmessage?: string;
+    exportexpression?: string;
+    /**
+     * custome react element
+     */
+    renderCellContent?: Function;
+    /**
+     * Callback fired on click.
+     */
+    onClick?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on focus.
+     */
+    onFocus?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on blur.
+     */
+    onBlur?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on value change.
+     */
+    onChange?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on key press.
+     */
+    onKeypress?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on key down.
+     */
+    onKeydown?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on key up.
+     */
+    onKeyup?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on mouse enter.
+     */
+    onMouseEnter?: ($event: any, widget: any, row: any) => void;
+    /**
+     * Callback fired on mouse leave.
+     */
+    onMouseLeave?: ($event: any, widget: any, row: any) => void;
+}
+/**
+ * Combined props for the WmTableColumn component, including base WaveMaker props.
+ */
+export type WmTableColumnProps = Prettify<TableColumnProps & BaseProps>;
+/**
+ * Props for the Table Action component.
+ */
+export interface TableActionProps {
+    /**
+     * Reference to the parent listener.
+     */
+    listener: any;
+    /**
+     * Type of widget.
+     */
+    widgetType: "button";
+    /**
+     * Unique key for the action.
+     */
+    key: string;
+    /**
+     * Display name of the action.
+     */
+    displayName: string;
+    /**
+     * CSS class for the icon.
+     */
+    iconclass?: string;
+    /**
+     * Action to perform.
+     */
+    action: string;
+    /**
+     * Position of the action in the table.
+     */
+    position?: TableActionPosition | string;
+    /**
+     * Keyboard shortcut for the action.
+     */
+    shortcutkey?: string;
+    /**
+     * Children components.
+     */
+    children?: ReactNode;
+    /**
+     * Visual variant of the button.
+     */
+    variant?: ButtonProps["variant"];
+    /**
+     * Color of the button.
+     */
+    color?: ButtonProps["color"];
+    /**
+     * Tab index for keyboard navigation.
+     */
+    tabindex?: number;
+    /**
+     * Whether the action is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Tooltip title for the action.
+     */
+    title?: string;
+}
+/**
+ * Combined props for the WmTableAction component, including base WaveMaker props.
+ */
+export type WmTableActionProps = Prettify<TableActionProps & BaseProps>;
+/**
+ * Props for the Table Row Action component.
+ */
+export interface TableRowActionProps {
+    /**
+     * Reference to the parent listener.
+     */
+    listener: any;
+    /**
+     * Unique key for the action.
+     */
+    key: string;
+    /**
+     * Name of the action.
+     */
+    name: string;
+    /**
+     * Display name of the action.
+     */
+    displayName: string;
+    /**
+     * Tooltip title for the action.
+     */
+    title: string;
+    /**
+     * CSS class for the icon.
+     */
+    iconclass?: string;
+    /**
+     * Action to perform.
+     */
+    action: string;
+    /**
+     * CSS class to apply.
+     */
+    className?: string;
+    /**
+     * Whether to show or hide the action.
+     */
+    show: boolean;
+    /**
+     * Row data associated with the action.
+     */
+    row?: any;
+    /**
+     * Index of the row.
+     */
+    rowIndex?: number;
+    /**
+     * Children components.
+     */
+    children?: ReactNode;
+    /**
+     * Type of widget to render (e.g., "button", "anchor").
+     */
+    widgettype?: string;
+}
+/**
+ * Combined props for the WmTableRowAction component, including base WaveMaker props.
+ */
+export type WmTableRowActionProps = Prettify<TableRowActionProps & BaseProps>;
+/**
+ * Props for the Table Row Expansion component.
+ */
+export interface TableRowProps {
+    /**
+     * Reference to the parent listener.
+     */
+    listener: any;
+    /**
+     * HTML content or partial name to show in the expanded area.
+     */
+    content?: string;
+    /**
+     * Icon class to show when the row is collapsed.
+     */
+    expandicon?: string;
+    /**
+     * Icon class to show when the row is expanded.
+     */
+    collapseicon?: string;
+    /**
+     * Position of the expansion button.
+     */
+    position?: number | string;
+    /**
+     * Whether to close other expanded rows when this one is expanded.
+     */
+    closeothers?: boolean;
+    /**
+     * Type of widget to use for expansion.
+     */
+    widgetType?: "button" | "anchor";
+    /**
+     * Display name for the expansion control.
+     */
+    displayName?: string;
+    /**
+     * Tooltip title when collapsed.
+     */
+    expandtitle?: string;
+    /**
+     * Tooltip title when expanded.
+     */
+    collapsetitle?: string;
+    /**
+     * Whether to show or hide the expansion control.
+     */
+    show?: boolean;
+    /**
+     * Whether the expansion control is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Width of the expansion column.
+     */
+    columnwidth?: string;
+    /**
+     * Unique name for the expansion control.
+     */
+    name: string;
+    /**
+     * CSS class to apply.
+     */
+    className?: string;
+    /**
+     * Rendering function for content.
+     */
+    renderPartial?: (props: Record<string, any>, onLoad: () => void, currentItem: any) => ReactNode;
+    /**
+     * Per-row callback from codegen for row-bound attrs (e.g. show, disabled).
+     */
+    tableRowProps?: (rowData: any) => Partial<TableRowProps>;
+    /**
+     * Children components.
+     */
+    children?: ReactNode;
+    /**
+     * Callback fired before row expansion.
+     */
+    onBeforerowexpand?: ($event: any, widget: any, row: any, $data: any) => void;
+    /**
+     * Callback fired after row expansion.
+     */
+    onRowexpand?: ($event: any, widget: any, row: any, $data: any) => void;
+    /**
+     * Callback fired before row collapse.
+     */
+    onBeforerowcollapse?: ($event: any, widget: any, row: any, $data: any) => void;
+    /**
+     * Callback fired after row collapse.
+     */
+    onRowcollapse?: ($event: any, widget: any, row: any) => void;
+}
+/**
+ * Combined props for the WmTableRow component, including base WaveMaker props.
+ */
+export type WmTableRowProps = Prettify<TableRowProps & BaseProps>;
+export interface TableBodyProps {
+    table: Table<any>;
+    columns: ColumnDef<any>[];
+    rowClass?: string;
+    formposition?: TableFormPosition;
+    renderAddNewRow: () => ReactElement | null;
+    onRowClick: (event: MouseEvent, rowData: any, rowId: string) => void;
+    isRowActive: (rowId: string, isSelected: boolean) => boolean;
+    isRowSelected: (rowId: string) => boolean;
+    nodatamessage?: string;
+    loadingdatamsg?: string;
+    isLoading?: boolean;
+    rowExpansionConfig?: WmTableRowProps | null;
+    expandedRows?: Set<string>;
+    toggleRowExpansion?: (rowId: string, rowData: any) => void;
+    isRowExpanded?: (rowId: string) => boolean;
+    rowsVersion?: number;
+    ColClassSignature?: string;
+    tableData?: any[];
+    activeRowIds?: string[];
+    editingRowId?: string | null;
+    selectedRowIds?: string[];
+    isAddingNewRow?: boolean;
+    registerRowDefInstance?: (rowId: string, instance: any, rowData?: any) => void;
+    customExpressionColumns?: Record<string, (rowData: any) => ReactNode>;
+    /** Bumps when custom-expression components are re-parsed (forces body cells to refresh). */
+    customColumnsRevision?: number;
+    /** Column proxy / table column definition generation counter. */
+    columnsVersion?: number;
+}
+export interface TableHeaderProps {
+    table: Table<any>;
+    enablesort: boolean;
+    enablecolumnselection?: boolean;
+    rowClass?: string;
+    rowExpansionConfig?: WmTableRowProps | null;
+    columnsVersion?: number;
+    filterMode?: TableFilterMode;
+    listener: any;
+    columnFilters?: Record<string, any>;
+    onColumnFilterChange?: (columnId: string, value: string, matchMode?: string) => void;
+    renderFormWidget: (fieldName: string, widgetType: string, value: any, onChange: (value: any) => void, additionalProps?: any) => React.ReactNode;
+    ColClassSignature?: string;
+    tableStructure?: any[];
+    sorting?: Array<{
+        id: string;
+        desc: boolean;
+    }>;
+    columnSizing?: Record<string, number>;
+    rowSelection?: Record<string, boolean>;
+    onColumnSelect?: (event: React.MouseEvent, columnId: string, colDef: any, columnData: any[]) => void;
+    onColumnDeselect?: (event: React.MouseEvent, columnId: string, colDef: any, columnData: any[]) => void;
+    onHeaderclick?: (event: any, widget: any, column: any) => void;
+    tableName?: string;
+}
+export interface RowExpansionButtonProps {
+    rowId: string;
+    rowData: any;
+    isExpanded: boolean;
+    onToggle: (rowId: string, rowData: any) => void;
+    config: WmTableRowProps;
+}
+export interface AddNewRowProps {
+    isAddingNewRow: boolean;
+    editMode: TableEditMode;
+    wmTableColumns: WmTableColumnProps[];
+    rowActions: WmTableRowActionProps[];
+    showrowindex: boolean;
+    radioselect?: boolean;
+    multiselect?: boolean;
+    sessionKey: number;
+    editingRowData: Record<string, any>;
+    renderEditableCell: (column: WmTableColumnProps, fieldName: string, widgetType: string, editValue: any, rowId: string) => ReactElement;
+    onKeyDown?: (e: KeyboardEvent, sourceRowId?: string) => void;
+    handleSave: () => void;
+    handleCancel: () => void;
+    listener?: any;
+    hasRowExpansion?: boolean;
+    expansionPosition?: number | string;
+}
+export interface EditableCellProps {
+    column: WmTableColumnProps;
+    rowData: any;
+    rowId: string;
+    fieldName: string;
+    widgetType: string;
+    editValue: any;
+    fieldValidationErrorsRef: RefObject<Record<string, boolean>>;
+    cellUpdateCallbacksRef: RefObject<Record<string, () => void>>;
+    fieldRefs: RefObject<Record<string, HTMLElement | null>>;
+    renderFormWidget: (name: string, type: string, value: any, onChange: (newValue: any) => void, props: any) => ReactElement;
+    updateFieldValue: (fieldName: string, newValue: any, rowId?: string) => void;
+    sessionKey?: number;
+    onKeyDown?: (e: KeyboardEvent, sourceRowId?: string) => void;
+    editMode?: TableEditMode;
+    validationmessage?: string;
+}
+export interface FieldValidationErrorProps {
+    showError: boolean;
+    title?: string;
+}
+export interface TableFooterActionsProps {
+    footerActions: any[];
+    spacing?: TablePanelSpacing;
+    isGridEditMode?: boolean;
+    isLoading?: boolean;
+    listener?: any;
+}
+export interface TablePanelHeadingProps {
+    title?: string;
+    subheading?: string;
+    iconclass?: string;
+    iconurl?: string;
+    prefabName?: string;
+    exportformat?: any[];
+    headerActions: any[];
+    spacing?: TablePanelSpacing;
+    isGridEditMode?: boolean;
+    isLoading?: boolean;
+    listener?: any;
+    datasource?: any;
+    columns?: WmTableColumnProps[];
+    sortInfo?: {
+        field: string;
+        direction: string;
+    };
+    filterInfo?: any[];
+    exportdatasize?: number;
+    onBeforeExport?: (data: any) => boolean | void;
+}
+export interface CellRendererContext {
+    column: WmTableColumnProps;
+    rowData: any;
+    listener?: any;
+    cellState?: CellStateReturn;
+}
+export interface CellProps {
+    fieldName: string;
+    value: any;
+    caption: string;
+    className: string;
+    iconclass: string;
+    onClick: (rowData: any) => void;
+}
+export interface ActionButtonConfig {
+    key: string;
+    name: string;
+    className: string;
+    dataActionKey: string;
+    displayName: string;
+    title: string;
+    iconclass: string;
+    action: string;
+    show: boolean;
+    widgettype: string;
+}
+export interface BuildSelectionColumnsProps {
+    useRadioSelect: boolean;
+    useMultiSelect: boolean;
+    /** @deprecated Header now reads from table.getIsAllRowsSelected() — no longer used internally. */
+    selectedRowIds?: string[];
+    handleRadioSelection: (rowId: string, rowData?: any) => void;
+    handleMultiSelection: (rowId: string, rowData: any, isSelected: boolean) => void;
+    handleSelectAll: (isSelected: boolean) => void;
+    /** @deprecated Header now reads from table.getIsAllRowsSelected() — no longer used internally. */
+    internalDataset?: any[];
+    radioselecttitle?: string;
+    radioselectarialabel?: string;
+    multiselecttitle?: string;
+    multiselectarialabel?: string;
+    tableName?: string;
+}
+export interface UseTableDataProps {
+    dataset?: any[];
+    onRowDelete?: (deletedRowData: any, deletedRowIndex: number, updatedDataset: any[]) => void;
+    deleteoktext?: string;
+    deletecanceltext?: string;
+    confirmdelete?: string;
+    deletemessage?: string;
+    errormessage?: string;
+    showToast?: (message: string, type: ToastType) => void;
+    datasource?: LiveVariableConfig;
+    binddataset?: string;
+    onSuccess?: (operation: string, data: any) => void;
+    onError?: (event: any, widget: any, data: any, operation: string) => void;
+    onRowdelete?: (event: any, widget: any, row: any) => void;
+    isServerSidePagination?: boolean;
+    listener?: any;
+    widgetName: string;
+}
+export interface UseTableDataReturn {
+    internalDataset: any[];
+    setInternalDataset: Dispatch<SetStateAction<any[]>>;
+    deleteRecord: (rowData: any, tableInstance?: any) => Promise<boolean>;
+    renderConfirmDialog: () => ReactElement | null;
+}
+export interface UseFormWidgetProps {
+    listener?: any;
+}
+export interface UseFormWidgetReturn {
+    renderFormWidget: (fieldName: string, widgetType: string, value: any, onFieldChange?: (newValue: any) => void, widgetProps?: {
+        required?: boolean;
+        disabled?: boolean;
+        placeholder?: string;
+        defaultvalue?: string | number | boolean;
+        sessionKey?: string | number;
+    }) => ReactElement;
+}
+export interface UseTableEditProps {
+    editMode?: TableEditMode;
+    internalDataset: any[];
+    setInternalDataset: Dispatch<SetStateAction<any[]>>;
+    wmTableColumns: WmTableColumnProps[];
+    listener?: any;
+    onRowUpdate?: (updatedRowData: any, rowIndex: number, updatedDataset: any[]) => void;
+    onNewRowAdded?: (newRecord: any) => void;
+    showToast?: (message: string, type: ToastType) => void;
+    onRowDelete?: (deletedRowData: any, deletedRowIndex: number, updatedDataset: any[]) => void;
+    showrowindex?: boolean;
+    radioselect?: boolean;
+    multiselect?: boolean;
+    rowActions?: any[];
+    formposition?: TableFormPosition;
+    insertmessage?: string;
+    updatemessage?: string;
+    errormessage?: string;
+    cellState?: CellStateReturn;
+    hasRowExpansion?: boolean;
+    expansionPosition?: number | string;
+    tableName: string;
+    datasource?: LiveVariableConfig;
+    binddataset?: string;
+    onSuccess?: (operation: string, data: any) => void;
+    onError?: (event: any, widget: any, data: any, operation: string) => void;
+    onRowdelete?: (event: any, widget: any, row: any) => void;
+    onRowinsert?: (event: any, widget: any, data: any) => void;
+    onRowupdate?: (event: any, widget: any, data: any) => void;
+    tableRef?: React.RefObject<any>;
+    isServerSidePagination?: boolean;
+}
+export interface UseTableEditReturn {
+    editingRowId: string | null;
+    editingRowData: Record<string, any>;
+    isRowEditing: (rowId: string) => boolean;
+    startEditing: (rowData: any, rowId: string) => void;
+    cancelEditing: () => void;
+    saveEditing: () => void;
+    updateFieldValue: (fieldName: string, newValue: any, rowId?: string) => void;
+    renderEditableCell: (column: WmTableColumnProps, rowData: any, rowId: string) => ReactElement;
+    handleRowClick: (rowData: any, rowId: string) => void;
+    handleKeyDown: (e: React.KeyboardEvent, sourceRowId?: string) => void;
+    fieldRefs: RefObject<Record<string, HTMLElement | null>>;
+    isAddingNewRow: boolean;
+    handleAddNewRowClick: () => void;
+    renderAddNewRow: () => ReactElement | null;
+}
+export interface UseTableColumnsProps {
+    wmTableColumns: WmTableColumnProps[];
+    /** Bumps when column proxy / script mutates column props so TanStack defs rebuild */
+    columnsVersion?: number;
+    rowActions: WmTableRowActionProps[];
+    listener?: any;
+    deleteRecord: (rowData: any, tableInstance?: any) => Promise<boolean>;
+    showrowindex?: boolean;
+    editmode: TableEditMode;
+    isDynamicTable?: boolean;
+    renderEditableCell: (column: WmTableColumnProps, rowData: any, rowId: string) => ReactNode;
+    isRowEditing: (rowId: string) => boolean;
+    startEditing: (rowData: any, rowId: string) => void;
+    cancelEditing: () => void;
+    saveEditing: () => void;
+    editingRowId: string | null;
+    cellState?: CellStateReturn;
+    isResizing?: boolean;
+    handleRowClick?: (event: React.MouseEvent, rowData: any, rowId: string) => void;
+    handleRadioSelection?: (rowId: string, rowData: any) => void;
+    handleMultiSelection?: (rowId: string, rowData: any, checked: boolean) => void;
+    useRadioSelect?: boolean;
+    useMultiSelect?: boolean;
+    isRowSelected?: (rowId: string) => boolean;
+}
+export interface UseTableColumnsReturn {
+    columns: ColumnDef<any>[];
+    wmTableColumns: WmTableColumnProps[];
+    rowActions: WmTableRowActionProps[];
+}
+export interface UseTableActionsProps {
+    children: ReactNode;
+    listener?: any;
+    onAddNewRowClick?: () => void;
+}
+export interface UseTableActionsReturn {
+    tableActions: WmTableActionProps[];
+    renderFooterActions: () => ReactElement | null;
+}
+export interface UsePanelStructureProps {
+    title?: string;
+    subheading?: string;
+    iconclass?: string;
+    iconurl?: string;
+    exportformat?: any[];
+    headerActions: any[];
+    footerActions: any[];
+    shownavigation: boolean;
+    onDemandLoad: boolean;
+    internalDataset: any[];
+    pagesize: number;
+    allowpagesizechange: boolean;
+    datasource?: LiveVariableConfig;
+    showrecordcount?: boolean;
+}
+export interface UsePanelStructureReturn {
+    showPanelHeading: boolean;
+    showPagination: boolean;
+}
+export interface UseRowSelectionProps {
+    radioselect?: boolean;
+    multiselect?: boolean;
+    gridfirstrowselect?: boolean;
+    internalDataset: any[];
+    cellState: CellStateReturn;
+    name: string;
+    statehandler?: StorageType;
+    initialActualPageSize?: number;
+    getTableState?: () => {
+        currentPage: number;
+        currentPageSize: number;
+    };
+    onRowselect?: (event: any, widget: any, row: any) => void;
+    onRowdeselect?: (event: any, widget: any, row: any) => void;
+    listener?: any;
+    navigation?: string;
+    onSyncSelectedItems?: (selectedIds: string[]) => void;
+}
+export interface UseRowSelectionReturn {
+    selectedRowIds: string[];
+    useMultiSelect: boolean;
+    useRadioSelect: boolean;
+    handleRadioSelection: (rowId: string, rowData?: any) => void;
+    handleMultiSelection: (rowId: string, rowData: any, isSelected: boolean) => void;
+    handleSelectAll: (isSelected: boolean) => void;
+    handleRowSelectionClick: (event: MouseEvent, rowId: string, rowData: any) => boolean;
+    isRowSelected: (rowId: string) => boolean;
+    isInteractiveElement: (event: MouseEvent) => boolean;
+}
+export interface UseTableStateProps {
+    editMode?: TableEditMode;
+    radioselect?: boolean;
+    multiselect?: boolean;
+}
+export interface UseTableStateReturn {
+    activeRowIds: string[] | [];
+    setActiveRow: (rowIds: string | string[] | null) => void;
+    clearActiveRow: () => void;
+    handleRowActiveClick: (rowId: string, isSelectionHandled: boolean, isEditingOrAdding: boolean) => void;
+    isRowActive: (rowId: string, isSelected: boolean) => boolean;
+}
+export interface SuccessHandlerOptions {
+    showToast?: (message: string, type: ToastType) => void;
+    onSuccess?: (operation: string, data: any) => void;
+    onRowCallback?: (event: any, widget: any, data: any) => void;
+    message?: string;
+    widget?: any;
+}
+export interface DatasetUpdateOptions {
+    setInternalDataset: (updater: (prevDataset: any[]) => any[]) => void;
+    onNewRowAdded?: (newRecord: any) => void;
+    onRowUpdate?: (updatedRowData: any, rowIndex: number, updatedDataset: any[]) => void;
+    showToast?: (message: string, type: ToastType) => void;
+    insertmessage?: string;
+    updatemessage?: string;
+}
+export interface ServerOperationOptions {
+    isNewRow: boolean;
+    rowId: string | null;
+    currentEditingData: Record<string, any>;
+    wmTableColumns: any[];
+    datasource?: LiveVariableConfig;
+    binddataset?: string;
+    setInternalDataset: (updater: (prevDataset: any[]) => any[]) => void;
+    onNewRowAdded?: (newRecord: any) => void;
+    onRowUpdate?: (updatedRowData: any, rowIndex: number, updatedDataset: any[]) => void;
+    showToast?: (message: string, type: ToastType) => void;
+    onSuccess?: (operation: string, data: any) => void;
+    onError?: (event: any, widget: any, data: any, operation: string) => void;
+    onRowinsert?: (event: any, widget: any, data: any) => void;
+    onRowupdate?: (event: any, widget: any, data: any) => void;
+    insertmessage?: string;
+    updatemessage?: string;
+    errormessage?: string;
+    tableInstance?: any;
+    isServerSidePagination?: boolean;
+    listener?: any;
+    widgetName: string;
+}
+export interface DeleteOperationOptions {
+    rowData: any;
+    tableInstance?: any;
+    internalDataset: any[];
+    setInternalDataset: (updater: (prevDataset: any[]) => any[]) => void;
+    datasource?: LiveVariableConfig;
+    binddataset?: string;
+    onRowDelete?: (deletedRowData: any, deletedRowIndex: number, updatedDataset: any[]) => void;
+    showToast?: (message: string, type: ToastType) => void;
+    onSuccess?: (operation: string, data: any) => void;
+    onError?: (event: any, widget: any, data: any, operation: string) => void;
+    onRowdelete?: (event: any, widget: any, row: any) => void;
+    deletemessage?: string;
+    errormessage?: string;
+    isServerSidePagination?: boolean;
+    listener?: any;
+    widgetName: string;
+}
+/**
+ * Interface for the table state structure
+ */
+export interface TableState {
+    cells?: Record<string, Record<string, any>>;
+    selection?: {
+        selectedRowIds?: string[];
+    };
+    [key: string]: any;
+}
+/**
+ * Interface for the cell state hook return value
+ */
+export interface CellStateReturn {
+    getValue: <T = any>(path: string | string[], defaultValue?: T) => T | undefined;
+    setValue: <T = any>(path: string | string[], value: T) => void;
+    updateState: (updates: Record<string, any> | ((currentState: TableState) => TableState)) => void;
+    hasValue: (path: string | string[]) => boolean;
+    removeValue: (path: string | string[]) => void;
+    clearState: () => void;
+    getState: () => TableState;
+    setState: (state: TableState) => void;
+    tableId: string;
+}
+export interface EditingStateConfig {
+    showNewRowFormByDefault: boolean;
+    startEditOnRowClick: boolean;
+    hasKeyboardNavigation: boolean;
+    cancelsAddNewRowOnEdit: boolean;
+}
+export interface UseEditingStateReturn {
+    editingRowId: string | null;
+    isAddingNewRow: boolean;
+    sessionKey: number;
+    editingRowDataRef: RefObject<Record<string, any>>;
+    newRowDataRef: RefObject<Record<string, any>>;
+    setEditingRowId: (id: string | null) => void;
+    setIsAddingNewRow: (value: boolean) => void;
+    incrementSessionKey: () => void;
+    resetEditingData: () => void;
+    isRowEditing: (rowId: string) => boolean;
+}
+export interface UseTableInitializationProps {
+    internalDataset: any[];
+    wmTableColumns: WmTableColumnProps[];
+    cellState: CellStateReturn;
+    gridfirstrowselect: boolean;
+    useRadioSelect: boolean;
+    useMultiSelect: boolean;
+    setActiveRow: (rowIds: string | string[] | null) => void;
+    selectedRowIds: string[];
+    formName?: string;
+    activeRowIds: string[];
+    listener: any;
+    editmode: TableEditMode;
+}
+export interface UseRowHandlersProps {
+    editingRowId: string | null;
+    isAddingNewRow: boolean;
+    handleRowSelectionClick: UseRowSelectionReturn["handleRowSelectionClick"];
+    handleTableEditRowClick: (rowData: any, rowId: string) => void;
+    handleRowActiveClick: (rowId: string, isSelectionHandled: boolean, isEditingOrAdding: boolean) => void;
+    onRowclick?: (event: any, widget: any, row: any) => void;
+    useRadioSelect?: boolean;
+    useMultiSelect?: boolean;
+    isrowselectable?: boolean;
+    listener?: any;
+    name: string;
+}
+export interface UseRowHandlersReturn {
+    handleRowClick: (event: MouseEvent, rowData: any, rowId: string) => void;
+}
+export interface PaginationState {
+    pageIndex: number;
+    pageSize: number;
+}
+export interface UsePaginationStateProps {
+    initialPage: number;
+    initialPageSize: number;
+    editmode: string;
+    internalDataset: any[];
+    datasource?: LiveVariableConfig;
+    isServerSidePagination: boolean;
+}
+export interface UsePaginationStateReturn {
+    paginationState: PaginationState;
+    setPaginationState: React.Dispatch<React.SetStateAction<PaginationState>>;
+    handlePaginationChange: (event: any, widget: any, index: number) => void;
+    handlePageSizeChange: (newPageSize: number) => void;
+}
+export interface UseRowExpansionProps {
+    rowExpansionConfig: WmTableRowProps | null;
+    internalDataset: any[];
+}
+export interface UseRowExpansionReturn {
+    expandedRows: Set<string>;
+    toggleRowExpansion: (rowId: string, rowData: any) => void;
+    isRowExpanded: (rowId: string) => boolean;
+    collapseAllRows: () => void;
+    rowExpansionConfig: WmTableRowProps | null;
+    registerRowDefInstance: (rowId: string, instance: any, rowData?: any) => void;
+    rowDefInstances: Record<string, any>;
+}
+export interface FieldValidationState {
+    fieldRefs: RefObject<Record<string, HTMLElement | null>>;
+    fieldValidationErrors: RefObject<Record<string, boolean>>;
+    cellUpdateCallbacks: RefObject<Record<string, () => void>>;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    invalidElements: HTMLElement[];
+    invalidFieldKeys?: string[];
+    firstInvalidElement?: HTMLElement;
+}
+/**
+ * Interface for summary row value with optional styling
+ */
+export interface SummaryRowValue {
+    value?: string | number | React.ReactNode;
+    class?: string;
+}
+/**
+ * Type for summary row data - can be a simple value, styled object, or Promise
+ */
+export type SummaryRowDataType = string | number | SummaryRowValue | Promise<any>;
+/**
+ * Interface for summary row definition (stores values by column key)
+ */
+export interface SummaryRowDef {
+    [columnKey: string]: string | number | React.ReactNode;
+}
+/**
+ * Interface for summary row definition with styling (stores objects by column key)
+ */
+export interface SummaryRowDefObject {
+    [columnKey: string]: SummaryRowValue | string | number;
+}
+/**
+ * Props for SummaryRowFooter component
+ */
+export interface SummaryRowFooterProps {
+    summaryRowDefs: SummaryRowDef[];
+    summaryRowDefObjects: SummaryRowDefObject[];
+    columns: WmTableColumnProps[];
+    tableName?: string;
+    summaryRowColumnShow?: Record<number, Record<string, boolean>>;
+}
+/**
+ * Props for SummaryRow component
+ */
+export interface SummaryRowProps {
+    rowDef: SummaryRowDef;
+    rowDefObject: SummaryRowDefObject;
+    rowIndex: number;
+    columns: WmTableColumnProps[];
+    summaryRowColumnShow?: Record<number, Record<string, boolean>>;
+}
+/**
+ * Props for SummaryCell component
+ */
+export interface SummaryCellProps {
+    columnKey: string;
+    column: WmTableColumnProps;
+    rowDef: SummaryRowDef;
+    rowDefObject: SummaryRowDefObject;
+    colIndex: number;
+    show: boolean;
+}
+export interface WmTableGroupProps {
+    name: string;
+    caption: string;
+    textalignment?: "left" | "center" | "right";
+    backgroundcolor?: string;
+    class?: string;
+    "col-class"?: string;
+    styles?: React.CSSProperties;
+    children: React.ReactNode;
+    [key: string]: any;
+}
+/**
+ * Header cell data for rendering
+ */
+export interface HeaderCellData {
+    isGroup?: boolean;
+    field: string;
+    displayName: string;
+    colspan?: number;
+    rowspan?: number;
+    textAlignment?: string;
+    backgroundColor?: string;
+    class?: string;
+    colClass?: string;
+    styles?: React.CSSProperties;
+    column?: WmTableColumnProps;
+}