material-react-table 0.23.5 → 0.25.0

package/dist/MaterialReactTable.d.ts

@@ -1,19 +1,12 @@
-import { ChangeEvent, Dispatch, FC, FocusEvent, ReactNode, SetStateAction } from 'react';
-import { AlertProps, ButtonProps, CheckboxProps, IconButtonProps, LinearProgressProps, PaperProps, SkeletonProps, TableBodyProps, TableCellProps, TableContainerProps, TableFooterProps, TableHeadProps, TablePaginationProps, TableProps, TableRowProps, TextFieldProps, ToolbarProps } from '@mui/material';
-import { Cell, Column, ColumnDef, FilterFn, Header, HeaderGroup, OnChangeFn, Row, SortingFn, Table, TableOptions, TableState } from '@tanstack/react-table';
-import { Options as VirtualizerOptions } from 'react-virtual';
+import { ChangeEvent, Dispatch, DragEvent, FC, FocusEvent, ReactNode, SetStateAction } from 'react';
+import type { AlertProps, ButtonProps, CheckboxProps, IconButtonProps, LinearProgressProps, PaperProps, SkeletonProps, TableBodyProps, TableCellProps, TableContainerProps, TableFooterProps, TableHeadProps, TablePaginationProps, TableProps, TableRowProps, TextFieldProps, ToolbarProps } from '@mui/material';
+import type { Cell, Column, ColumnDef, FilterFn, Header, HeaderGroup, OnChangeFn, Row, SortingFn, Table, TableOptions, TableState } from '@tanstack/react-table';
+import type { Options as VirtualizerOptions } from 'react-virtual';
 import { MRT_Localization } from './localization';
 import { MRT_Icons } from './icons';
 import { MRT_FilterFns } from './filtersFns';
 import { MRT_SortingFns } from './sortingFns';
 declare type LiteralUnion<T extends U, U = string> = T | (U & Record<never, never>);
-export declare type MRT_TableOptions<TData extends Record<string, any> = {}> = Partial<Omit<TableOptions<TData>, 'columns' | 'data' | 'initialState' | 'state' | 'expandRowsFn'>> & {
-    columns: MRT_ColumnDef<TData>[];
-    data: TData[];
-    expandRowsFn?: (dataRow: TData) => TData[];
-    initialState?: Partial<MRT_TableState<TData>>;
-    state?: Partial<MRT_TableState<TData>>;
-};
 export interface MRT_RowModel<TData extends Record<string, any> = {}> {
     flatRows: MRT_Row<TData>[];
     rows: MRT_Row<TData>[];
@@ -43,6 +36,7 @@ export declare type MRT_TableInstance<TData extends Record<string, any> = {}> =
         localization: MRT_Localization;
     };
     setCurrentDraggingColumn: Dispatch<SetStateAction<MRT_Column<TData> | null>>;
+    setCurrentDraggingRow: Dispatch<SetStateAction<MRT_Row<TData> | null>>;
     setCurrentEditingCell: Dispatch<SetStateAction<MRT_Cell | null>>;
     setCurrentEditingRow: Dispatch<SetStateAction<MRT_Row | null>>;
     setCurrentFilterFns: Dispatch<SetStateAction<{
@@ -50,6 +44,7 @@ export declare type MRT_TableInstance<TData extends Record<string, any> = {}> =
     }>>;
     setCurrentGlobalFilterFn: Dispatch<SetStateAction<MRT_FilterOption>>;
     setCurrentHoveredColumn: Dispatch<SetStateAction<MRT_Column<TData> | null>>;
+    setCurrentHoveredRow: Dispatch<SetStateAction<MRT_Row | null>>;
     setDensity: Dispatch<SetStateAction<'comfortable' | 'compact' | 'spacious'>>;
     setIsFullScreen: Dispatch<SetStateAction<boolean>>;
     setShowAlertBanner: Dispatch<SetStateAction<boolean>>;
@@ -58,11 +53,13 @@ export declare type MRT_TableInstance<TData extends Record<string, any> = {}> =
 };
 export declare type MRT_TableState<TData extends Record<string, any> = {}> = TableState & {
     currentDraggingColumn: MRT_Column<TData> | null;
+    currentDraggingRow: MRT_Row<TData> | null;
     currentEditingCell: MRT_Cell<TData> | null;
     currentEditingRow: MRT_Row<TData> | null;
     currentFilterFns: Record<string, MRT_FilterOption>;
     currentGlobalFilterFn: Record<string, MRT_FilterOption>;
     currentHoveredColumn: MRT_Column<TData> | null;
+    currentHoveredRow: MRT_Row<TData> | null;
     density: 'comfortable' | 'compact' | 'spacious';
     isFullScreen: boolean;
     isLoading: boolean;
@@ -110,7 +107,7 @@ export declare type MRT_ColumnDef<TData extends Record<string, any> = {}> = Omit
      *
      * @example accessorKey: 'username'
      */
-    accessorKey?: LiteralUnion<string & keyof TData>;
+    accessorKey?: string & keyof TData;
     /**
      * Specify what type of column this is. Either `data`, `display`, or `group`. Defaults to `data`.
      * Leave this blank if you are just creating a normal data column.
@@ -123,6 +120,7 @@ export declare type MRT_ColumnDef<TData extends Record<string, any> = {}> = Omit
     columns?: MRT_ColumnDef<TData>[];
     enableClickToCopy?: boolean;
     enableColumnActions?: boolean;
+    enableColumnDragging?: boolean;
     enableColumnFilterChangeMode?: boolean;
     enableColumnOrdering?: boolean;
     enableEditing?: boolean;
@@ -170,6 +168,10 @@ export declare type MRT_ColumnDef<TData extends Record<string, any> = {}> = Omit
         table: MRT_TableInstance<TData>;
         column: MRT_Column<TData>;
     }) => IconButtonProps);
+    muiTableHeadCellDragHandleProps?: IconButtonProps | (({ table, column, }: {
+        table: MRT_TableInstance<TData>;
+        column: MRT_Column<TData>;
+    }) => IconButtonProps);
     muiTableHeadCellFilterTextFieldProps?: TextFieldProps | (({ table, column, }: {
         table: MRT_TableInstance<TData>;
         column: MRT_Column<TData>;
@@ -206,11 +208,10 @@ export declare type MRT_Header<TData extends Record<string, any> = {}> = Omit<He
 export declare type MRT_HeaderGroup<TData extends Record<string, any> = {}> = Omit<HeaderGroup<TData>, 'headers'> & {
     headers: MRT_Header<TData>[];
 };
-export declare type MRT_Row<TData extends Record<string, any> = {}> = Omit<Row<TData>, 'getVisibleCells' | 'getAllCells' | 'subRows' | 'original' | '_valuesCache'> & {
+export declare type MRT_Row<TData extends Record<string, any> = {}> = Omit<Row<TData>, 'getVisibleCells' | 'getAllCells' | 'subRows' | '_valuesCache'> & {
     getAllCells: () => MRT_Cell<TData>[];
     getVisibleCells: () => MRT_Cell<TData>[];
     subRows?: MRT_Row<TData>[];
-    original: TData;
     _valuesCache?: TData;
 };
 export declare type MRT_Cell<TData extends Record<string, any> = {}> = Omit<Cell<TData, unknown>, 'column' | 'row'> & {
@@ -221,10 +222,26 @@ export declare type MRT_SortingOption = keyof typeof MRT_SortingFns;
 export declare type MRT_SortingFn<TData extends Record<string, any> = {}> = SortingFn<TData> | MRT_SortingOption;
 export declare type MRT_FilterOption = keyof typeof MRT_FilterFns;
 export declare type MRT_FilterFn<TData extends Record<string, any> = {}> = FilterFn<TData> | MRT_FilterOption;
-export declare type MaterialReactTableProps<TData extends Record<string, any> = {}> = MRT_TableOptions<TData> & {
+export declare type MRT_DisplayColumnIds = 'mrt-row-drag' | 'mrt-row-actions' | 'mrt-row-expand' | 'mrt-row-select' | 'mrt-row-numbers';
+/**
+ * `columns` and `data` props are the only required props, but there are over 150 other optional props.
+ *
+ * See more info on creating columns and data on the official docs site:
+ * @link https://www.material-react-table.com/docs/usage
+ *
+ * See the full props list on the official docs site:
+ * @link https://www.material-react-table.com/docs/api/props
+ */
+export declare type MaterialReactTableProps<TData extends Record<string, any> = {}> = Omit<Partial<TableOptions<TData>>, 'columns' | 'data' | 'initialState' | 'state' | 'expandRowsFn'> & {
+    displayColumnDefOptions?: Partial<{
+        [key in MRT_DisplayColumnIds]: Partial<MRT_ColumnDef>;
+    }>;
+    columns: MRT_ColumnDef<TData>[];
+    data: TData[];
     editingMode?: 'table' | 'row' | 'cell';
     enableClickToCopy?: boolean;
     enableColumnActions?: boolean;
+    enableColumnDragging?: boolean;
     enableColumnFilterChangeMode?: boolean;
     enableColumnOrdering?: boolean;
     enableDensityToggle?: boolean;
@@ -235,7 +252,9 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
     enableGlobalFilterRankedResults?: boolean;
     enablePagination?: boolean;
     enableRowActions?: boolean;
+    enableRowDragging?: boolean;
     enableRowNumbers?: boolean;
+    enableRowOrdering?: boolean;
     enableRowVirtualization?: boolean;
     enableSelectAll?: boolean;
     enableStickyHeader?: boolean;
@@ -246,7 +265,9 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
     enableToolbarTop?: boolean;
     enabledColumnFilterOptions?: (MRT_FilterOption | string)[] | null;
     enabledGlobalFilterOptions?: (MRT_FilterOption | string)[] | null;
+    expandRowsFn?: (dataRow: TData) => TData[];
     icons?: Partial<MRT_Icons>;
+    initialState?: Partial<MRT_TableState<TData>>;
     localization?: Partial<MRT_Localization>;
     muiExpandAllButtonProps?: IconButtonProps | (({ table }: {
         table: MRT_TableInstance<TData>;
@@ -288,6 +309,10 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
     muiTableBodyProps?: TableBodyProps | (({ table }: {
         table: MRT_TableInstance<TData>;
     }) => TableBodyProps);
+    muiTableBodyRowDragHandleProps?: IconButtonProps | (({ table, row, }: {
+        table: MRT_TableInstance<TData>;
+        row: MRT_Row<TData>;
+    }) => IconButtonProps);
     muiTableBodyRowProps?: TableRowProps | (({ table, row, }: {
         table: MRT_TableInstance<TData>;
         row: MRT_Row<TData>;
@@ -314,6 +339,10 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
         table: MRT_TableInstance<TData>;
         column: MRT_Column<TData>;
     }) => IconButtonProps);
+    muiTableHeadCellDragHandleProps?: IconButtonProps | (({ table, column, }: {
+        table: MRT_TableInstance<TData>;
+        column: MRT_Column<TData>;
+    }) => IconButtonProps);
     muiTableHeadCellFilterTextFieldProps?: TextFieldProps | (({ table, column, }: {
         table: MRT_TableInstance<TData>;
         column: MRT_Column<TData>;
@@ -357,7 +386,13 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
         cell: MRT_Cell<TData>;
         table: MRT_TableInstance<TData>;
     }) => void;
+    onColumnDrop?: ({ event, draggedColumn, targetColumn, }: {
+        event: DragEvent<HTMLButtonElement>;
+        draggedColumn: MRT_Column<TData>;
+        targetColumn: MRT_Column<TData> | null;
+    }) => void;
     onCurrentDraggingColumnChange?: OnChangeFn<MRT_Column<TData> | null>;
+    onCurrentDraggingRowChange?: OnChangeFn<MRT_Row<TData> | null>;
     onCurrentEditingCellChange?: OnChangeFn<MRT_Cell<TData> | null>;
     onCurrentEditingRowChange?: OnChangeFn<MRT_Row<TData> | null>;
     onCurrentFilterFnsChange?: OnChangeFn<{
@@ -365,12 +400,18 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
     }>;
     onCurrentGlobalFilterFnChange?: OnChangeFn<MRT_FilterOption>;
     onCurrentHoveredColumnChange?: OnChangeFn<MRT_Column<TData> | null>;
+    onCurrentHoveredRowChange?: OnChangeFn<MRT_Row<TData> | null>;
+    onDensityChange?: OnChangeFn<boolean>;
     onEditRowSubmit?: ({ row, table, }: {
         row: MRT_Row<TData>;
         table: MRT_TableInstance<TData>;
     }) => Promise<void> | void;
-    onDensityChange?: OnChangeFn<boolean>;
     onIsFullScreenChange?: OnChangeFn<boolean>;
+    onRowDrop?: ({ event, draggedRow, targetRow, }: {
+        event: DragEvent<HTMLButtonElement>;
+        draggedRow: MRT_Row<TData>;
+        targetRow: MRT_Row<TData> | null;
+    }) => void;
     onShowAlertBannerChange?: OnChangeFn<boolean>;
     onShowFiltersChange?: OnChangeFn<boolean>;
     onShowGlobalFilterChange?: OnChangeFn<boolean>;
@@ -394,9 +435,6 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
     renderToolbarBottomCustomActions?: ({ table, }: {
         table: MRT_TableInstance<TData>;
     }) => ReactNode;
-    renderToolbarTopCustomActions?: ({ table, }: {
-        table: MRT_TableInstance<TData>;
-    }) => ReactNode;
     renderToolbarInternalActions?: ({ table, MRT_ToggleGlobalFilterButton, MRT_ToggleFiltersButton, MRT_ShowHideColumnsButton, MRT_ToggleDensePaddingButton, MRT_FullScreenToggleButton, }: {
         table: MRT_TableInstance<TData>;
         MRT_ToggleGlobalFilterButton: FC<IconButtonProps & {
@@ -415,20 +453,15 @@ export declare type MaterialReactTableProps<TData extends Record<string, any> =
             table: MRT_TableInstance<TData>;
         }>;
     }) => ReactNode;
+    renderToolbarTopCustomActions?: ({ table, }: {
+        table: MRT_TableInstance<TData>;
+    }) => ReactNode;
     rowCount?: number;
     rowNumberMode?: 'original' | 'static';
     selectAllMode?: 'all' | 'page';
+    state?: Partial<MRT_TableState<TData>>;
     tableId?: string;
     virtualizerProps?: Partial<VirtualizerOptions<HTMLDivElement>>;
 };
 declare const _default: <TData extends Record<string, any> = {}>({ autoResetExpanded, columnResizeMode, defaultColumn, editingMode, enableColumnActions, enableColumnFilterChangeMode, enableColumnFilters, enableColumnOrdering, enableColumnResizing, enableDensityToggle, enableExpandAll, enableFilters, enableFullScreenToggle, enableGlobalFilter, enableGlobalFilterChangeMode, enableGlobalFilterRankedResults, enableGrouping, enableHiding, enableMultiRowSelection, enableMultiSort, enablePagination, enablePinning, enableRowSelection, enableSelectAll, enableSorting, enableStickyHeader, enableTableFooter, enableTableHead, enableToolbarBottom, enableToolbarInternalActions, enableToolbarTop, icons, localization, positionActionsColumn, positionGlobalFilter, positionPagination, positionToolbarAlertBanner, rowNumberMode, selectAllMode, ...rest }: MaterialReactTableProps<TData>) => JSX.Element;
-/**
- * `columns` and `data` props are the only required props, but there are over 150 other optional props.
- *
- * See more info on creating columns and data on the official docs site:
- * @link https://www.material-react-table.com/docs/usage
- *
- * See the full props list on the official docs site:
- * @link https://www.material-react-table.com/docs/api/props
- */
 export default _default;

package/dist/body/MRT_TableBodyCell.d.ts

@@ -1,9 +1,10 @@
-import { FC } from 'react';
+import { FC, RefObject } from 'react';
 import type { MRT_Cell, MRT_TableInstance } from '..';
 interface Props {
     cell: MRT_Cell;
     enableHover?: boolean;
     rowIndex: number;
+    rowRef: RefObject<HTMLTableRowElement>;
     table: MRT_TableInstance;
 }
 export declare const MRT_TableBodyCell: FC<Props>;

package/dist/body/MRT_TableBodyRowGrabHandle.d.ts

@@ -0,0 +1,9 @@
+import { FC, RefObject } from 'react';
+import { MRT_Cell, MRT_TableInstance } from '..';
+interface Props {
+    cell: MRT_Cell;
+    rowRef: RefObject<HTMLTableRowElement>;
+    table: MRT_TableInstance;
+}
+export declare const MRT_TableBodyRowGrabHandle: FC<Props>;
+export {};

package/dist/buttons/MRT_GrabHandleButton.d.ts

@@ -1,8 +1,10 @@
+import { IconButtonProps } from '@mui/material';
 import { DragEventHandler, FC } from 'react';
 import { MRT_TableInstance } from '..';
 interface Props {
-    handleDragStart: DragEventHandler<HTMLButtonElement>;
-    handleDragEnd: DragEventHandler<HTMLButtonElement>;
+    iconButtonProps?: IconButtonProps;
+    onDragStart: DragEventHandler<HTMLButtonElement>;
+    onDragEnd: DragEventHandler<HTMLButtonElement>;
     table: MRT_TableInstance;
 }
 export declare const MRT_GrabHandleButton: FC<Props>;

package/dist/head/MRT_TableHeadCellGrabHandle.d.ts

@@ -0,0 +1,9 @@
+import { FC, RefObject } from 'react';
+import type { MRT_Column, MRT_TableInstance } from '..';
+interface Props {
+    column: MRT_Column;
+    table: MRT_TableInstance;
+    tableHeadCellRef: RefObject<HTMLTableCellElement>;
+}
+export declare const MRT_TableHeadCellGrabHandle: FC<Props>;
+export {};

package/dist/localization.d.ts

@@ -34,6 +34,7 @@ export interface MRT_Localization {
     hideColumn: string;
     max: string;
     min: string;
+    move: string;
     pinToLeft: string;
     pinToRight: string;
     resetColumnSize: string;