@mui/x-data-grid 8.10.2 → 8.11.1

package/esm/components/panel/filterPanel/GridFilterInputSingleSelect.js

@@ -48,15 +48,9 @@ function GridFilterInputSingleSelect(props) {
   const labelId = useId();
   const rootProps = useGridRootProps();
   const isSelectNative = rootProps.slotProps?.baseSelect?.native ?? false;
-  let resolvedColumn = null;
-  if (item.field) {
-    const column = apiRef.current.getColumn(item.field);
-    if (isSingleSelectColDef(column)) {
-      resolvedColumn = column;
-    }
-  }
-  const getOptionValue = resolvedColumn?.getOptionValue;
-  const getOptionLabel = resolvedColumn?.getOptionLabel;
+  const resolvedColumn = apiRef.current.getColumn(item.field);
+  const getOptionValue = resolvedColumn.getOptionValue;
+  const getOptionLabel = resolvedColumn.getOptionLabel;
   const currentValueOptions = React.useMemo(() => {
     return getValueOptions(resolvedColumn);
   }, [resolvedColumn]);
@@ -69,7 +63,7 @@ function GridFilterInputSingleSelect(props) {
       value
     }));
   }, [currentValueOptions, getOptionValue, applyValue, item]);
-  if (!isSingleSelectColDef(resolvedColumn)) {
+  if (!resolvedColumn || !isSingleSelectColDef(resolvedColumn)) {
     return null;
   }
   const label = slotProps?.root.label ?? apiRef.current.getLocaleText('filterPanelInputLabel');

package/esm/components/virtualization/GridVirtualScrollerRenderZone.js

@@ -6,10 +6,7 @@ import clsx from 'clsx';
 import { styled } from '@mui/system';
 import composeClasses from '@mui/utils/composeClasses';
 import { forwardRef } from '@mui/x-internals/forwardRef';
-import { useGridApiContext } from "../../hooks/utils/useGridApiContext.js";
-import { useGridSelector } from "../../hooks/utils/useGridSelector.js";
-import { gridRowsMetaSelector } from "../../hooks/features/rows/index.js";
-import { gridRenderContextSelector } from "../../hooks/features/virtualization/index.js";
+import { useGridPrivateApiContext } from "../../hooks/utils/useGridPrivateApiContext.js";
 import { useGridRootProps } from "../../hooks/utils/useGridRootProps.js";
 import { getDataGridUtilityClass } from "../../constants/gridClasses.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -36,14 +33,10 @@ const GridVirtualScrollerRenderZone = forwardRef(function GridVirtualScrollerRen
       className
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
-  const apiRef = useGridApiContext();
+  const apiRef = useGridPrivateApiContext();
   const rootProps = useGridRootProps();
   const classes = useUtilityClasses(rootProps);
-  const offsetTop = useGridSelector(apiRef, () => {
-    const renderContext = gridRenderContextSelector(apiRef);
-    const rowsMeta = gridRowsMetaSelector(apiRef);
-    return rowsMeta.positions[renderContext.firstRowIndex] ?? 0;
-  });
+  const offsetTop = apiRef.current.virtualizer.api.useVirtualization().getters.getOffsetTop();
   return /*#__PURE__*/_jsx(VirtualScrollerRenderZoneRoot, _extends({
     className: clsx(classes.root, className),
     ownerState: rootProps,

package/esm/hooks/core/pipeProcessing/gridPipeProcessingApi.d.ts

@@ -91,6 +91,21 @@ export interface GridPipeProcessingLookup {
     };
     context: boolean;
   };
+  /**
+   * Does validation of the current reorder operation.
+   * If the reorder is valid, it returns the position index of the drop indicator.
+   *   - For example before first row is `0` and after the last row is `rows.length`.
+   * If the reorder is invalid, it returns `-1`.
+   */
+  getRowReorderTargetIndex: {
+    value: number;
+    context: {
+      sourceRowId: GridRowId;
+      targetRowId: GridRowId;
+      dropPosition: 'above' | 'below';
+      dragDirection: 'up' | 'down';
+    };
+  };
 }
 export type GridPipeProcessor<P extends GridPipeProcessorGroup> = (value: GridPipeProcessingLookup[P]['value'], context: GridPipeProcessingLookup[P] extends {
   context: any;

package/esm/hooks/features/editing/useGridCellEditing.js

@@ -365,7 +365,7 @@ export const useGridCellEditing = (apiRef, props) => {
         if (onProcessRowUpdateError) {
           onProcessRowUpdateError(errorThrown);
         } else if (process.env.NODE_ENV !== 'production') {
-          warnOnce(['MUI X: A call to `processRowUpdate` threw an error which was not handled because `onProcessRowUpdateError` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
+          warnOnce(['MUI X: A call to `processRowUpdate()` threw an error which was not handled because `onProcessRowUpdateError()` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError()` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
         }
       };
       try {

package/esm/hooks/features/editing/useGridRowEditing.js

@@ -449,7 +449,7 @@ export const useGridRowEditing = (apiRef, props) => {
         if (onProcessRowUpdateError) {
           onProcessRowUpdateError(errorThrown);
         } else if (process.env.NODE_ENV !== 'production') {
-          warnOnce(['MUI X: A call to `processRowUpdate` threw an error which was not handled because `onProcessRowUpdateError` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
+          warnOnce(['MUI X: A call to `processRowUpdate()` threw an error which was not handled because `onProcessRowUpdateError()` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError()` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
         }
       };
       try {

package/esm/hooks/features/filter/gridFilterSelector.d.ts

@@ -134,4 +134,12 @@ export type GridFilterActiveItemsLookup = {
  */
 export declare const gridFilterActiveItemsLookupSelector: (args_0: import("react").RefObject<{
   state: GridStateCommunity;
-} | null>) => GridFilterActiveItemsLookup;
+} | null>) => GridFilterActiveItemsLookup;
+/**
+ * Get the index lookup for expanded (visible) rows only.
+ * Does not include collapsed children.
+ * @ignore - do not document.
+ */
+export declare const gridExpandedSortedRowIndexLookupSelector: (args_0: import("react").RefObject<{
+  state: GridStateCommunity;
+} | null>) => Record<GridRowId, number>;

package/esm/hooks/features/filter/gridFilterSelector.js

@@ -174,4 +174,16 @@ export const gridFilterActiveItemsLookupSelector = createSelectorMemoized(gridFi
     return res;
   }, {});
   return result;
+});
+
+/**
+ * Get the index lookup for expanded (visible) rows only.
+ * Does not include collapsed children.
+ * @ignore - do not document.
+ */
+export const gridExpandedSortedRowIndexLookupSelector = createSelectorMemoized(gridExpandedSortedRowIdsSelector, expandedSortedIds => {
+  return expandedSortedIds.reduce((acc, id, index) => {
+    acc[id] = index;
+    return acc;
+  }, Object.create(null));
 });

package/esm/hooks/features/pagination/useGridPaginationModel.js

@@ -219,13 +219,13 @@ export const useGridPaginationModel = (apiRef, props) => {
   React.useEffect(() => {
     apiRef.current.setState(state => {
       const isEnabled = props.pagination === true;
-      if (state.pagination.paginationMode === props.paginationMode || state.pagination.enabled === isEnabled) {
+      if (state.pagination.paginationMode === props.paginationMode && state.pagination.enabled === isEnabled) {
         return state;
       }
       return _extends({}, state, {
         pagination: _extends({}, state.pagination, {
           paginationMode: props.paginationMode,
-          enabled: props.pagination === true
+          enabled: isEnabled
         })
       });
     });

package/esm/hooks/features/rows/useGridRows.d.ts

@@ -2,5 +2,6 @@ import { RefObject } from '@mui/x-internals/types';
 import { DataGridProcessedProps } from "../../../models/props/DataGridProps.js";
 import { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
 import { GridStateInitializer } from "../../utils/useGridInitializeState.js";
+import type { GridConfiguration } from "../../../models/configuration/gridConfiguration.js";
 export declare const rowsStateInitializer: GridStateInitializer<Pick<DataGridProcessedProps, 'dataSource' | 'rows' | 'rowCount' | 'getRowId' | 'loading'>>;
-export declare const useGridRows: (apiRef: RefObject<GridPrivateApiCommunity>, props: Pick<DataGridProcessedProps, "rows" | "getRowId" | "rowCount" | "throttleRowsMs" | "signature" | "pagination" | "paginationMode" | "loading" | "dataSource">) => void;
+export declare const useGridRows: (apiRef: RefObject<GridPrivateApiCommunity>, props: Pick<DataGridProcessedProps, "rows" | "getRowId" | "rowCount" | "throttleRowsMs" | "signature" | "pagination" | "paginationMode" | "loading" | "dataSource" | "processRowUpdate" | "onProcessRowUpdateError">, configuration: GridConfiguration) => void;

package/esm/hooks/features/rows/useGridRows.js

@@ -36,7 +36,7 @@ export const rowsStateInitializer = (state, props, apiRef) => {
     })
   });
 };
-export const useGridRows = (apiRef, props) => {
+export const useGridRows = (apiRef, props, configuration) => {
   if (process.env.NODE_ENV !== 'production') {
     try {
       // Freeze the `rows` prop so developers have a fast failure if they try to use Array.prototype.push().
@@ -49,6 +49,11 @@ export const useGridRows = (apiRef, props) => {
   const lastUpdateMs = React.useRef(Date.now());
   const lastRowCount = React.useRef(props.rowCount);
   const timeout = useTimeout();
+
+  // Get overridable methods from configuration
+  const {
+    setRowIndex
+  } = configuration.hooks.useGridRowsOverridableMethods(apiRef, props);
   const getRow = React.useCallback(id => {
     const model = gridRowsLookupSelector(apiRef)[id];
     if (model) {
@@ -226,39 +231,6 @@ export const useGridRows = (apiRef, props) => {
     }
     return children;
   }, [apiRef]);
-  const setRowIndex = React.useCallback((rowId, targetIndex) => {
-    const node = gridRowNodeSelector(apiRef, rowId);
-    if (!node) {
-      throw new Error(`MUI X: No row with id #${rowId} found.`);
-    }
-    if (node.parent !== GRID_ROOT_GROUP_ID) {
-      throw new Error(`MUI X: The row reordering do not support reordering of grouped rows yet.`);
-    }
-    if (node.type !== 'leaf') {
-      throw new Error(`MUI X: The row reordering do not support reordering of footer or grouping rows.`);
-    }
-    apiRef.current.setState(state => {
-      const group = gridRowTreeSelector(apiRef)[GRID_ROOT_GROUP_ID];
-      const allRows = group.children;
-      const oldIndex = allRows.findIndex(row => row === rowId);
-      if (oldIndex === -1 || oldIndex === targetIndex) {
-        return state;
-      }
-      logger.debug(`Moving row ${rowId} to index ${targetIndex}`);
-      const updatedRows = [...allRows];
-      updatedRows.splice(targetIndex, 0, updatedRows.splice(oldIndex, 1)[0]);
-      return _extends({}, state, {
-        rows: _extends({}, state.rows, {
-          tree: _extends({}, state.rows.tree, {
-            [GRID_ROOT_GROUP_ID]: _extends({}, group, {
-              children: updatedRows
-            })
-          })
-        })
-      });
-    });
-    apiRef.current.publishEvent('rowsSet');
-  }, [apiRef, logger]);
   const replaceRows = React.useCallback((firstRowToRender, newRows) => {
     if (props.signature === GridSignature.DataGrid && newRows.length > 1) {
       throw new Error(['MUI X: You cannot replace rows using `apiRef.current.unstable_replaceRows` on the DataGrid.', 'You need to upgrade to DataGridPro or DataGridPremium component to unlock this feature.'].join('\n'));

package/esm/hooks/features/rows/useGridRowsOverridableMethods.d.ts

@@ -0,0 +1,6 @@
+import { RefObject } from '@mui/x-internals/types';
+import { GridRowId } from "../../../models/gridRows.js";
+import { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
+export declare const useGridRowsOverridableMethods: (apiRef: RefObject<GridPrivateApiCommunity>) => {
+  setRowIndex: (rowId: GridRowId, targetIndex: number) => void;
+};

package/esm/hooks/features/rows/useGridRowsOverridableMethods.js

@@ -0,0 +1,43 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { gridRowTreeSelector, gridRowNodeSelector } from "./gridRowsSelector.js";
+import { GRID_ROOT_GROUP_ID } from "./gridRowsUtils.js";
+export const useGridRowsOverridableMethods = apiRef => {
+  const setRowIndex = React.useCallback((rowId, targetIndex) => {
+    const node = gridRowNodeSelector(apiRef, rowId);
+    if (!node) {
+      throw new Error(`MUI X: No row with id #${rowId} found.`);
+    }
+
+    // TODO: Remove irrelevant checks
+    if (node.parent !== GRID_ROOT_GROUP_ID) {
+      throw new Error(`MUI X: The row reordering do not support reordering of grouped rows yet.`);
+    }
+    if (node.type !== 'leaf') {
+      throw new Error(`MUI X: The row reordering do not support reordering of footer or grouping rows.`);
+    }
+    apiRef.current.setState(state => {
+      const group = gridRowTreeSelector(apiRef)[GRID_ROOT_GROUP_ID];
+      const allRows = group.children;
+      const oldIndex = allRows.findIndex(row => row === rowId);
+      if (oldIndex === -1 || oldIndex === targetIndex) {
+        return state;
+      }
+      const updatedRows = [...allRows];
+      updatedRows.splice(targetIndex, 0, updatedRows.splice(oldIndex, 1)[0]);
+      return _extends({}, state, {
+        rows: _extends({}, state.rows, {
+          tree: _extends({}, state.rows.tree, {
+            [GRID_ROOT_GROUP_ID]: _extends({}, group, {
+              children: updatedRows
+            })
+          })
+        })
+      });
+    });
+    apiRef.current.publishEvent('rowsSet');
+  }, [apiRef]);
+  return {
+    setRowIndex
+  };
+};

package/esm/hooks/features/scroll/useGridScroll.js

@@ -93,7 +93,7 @@ export const useGridScroll = (apiRef, props) => {
       });
     }
     scrollCoordinates = apiRef.current.unstable_applyPipeProcessors('scrollToIndexes', scrollCoordinates, params);
-    if (typeof scrollCoordinates.left !== undefined || typeof scrollCoordinates.top !== undefined) {
+    if (typeof scrollCoordinates.left !== 'undefined' || typeof scrollCoordinates.top !== 'undefined') {
       apiRef.current.scroll(scrollCoordinates);
       return true;
     }

package/esm/hooks/utils/useGridConfiguration.d.ts

@@ -1,2 +1,4 @@
 import { GridConfiguration } from "../../models/configuration/gridConfiguration.js";
-export declare const useGridConfiguration: () => GridConfiguration;
+import type { GridPrivateApiCommon } from "../../models/api/gridApiCommon.js";
+import type { GridPrivateApiCommunity } from "../../models/api/gridApiCommunity.js";
+export declare const useGridConfiguration: <Api extends GridPrivateApiCommon = GridPrivateApiCommunity>() => GridConfiguration<Api>;

package/esm/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid v8.10.2
+ * @mui/x-data-grid v8.11.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/esm/internals/index.d.ts

@@ -41,7 +41,7 @@ export { useGridPrintExport } from "../hooks/features/export/useGridPrintExport.
 export { useGridFilter, filterStateInitializer } from "../hooks/features/filter/useGridFilter.js";
 export { defaultGridFilterLookup } from "../hooks/features/filter/gridFilterState.js";
 export { passFilterLogic } from "../hooks/features/filter/gridFilterUtils.js";
-export { gridFilteredChildrenCountLookupSelector, gridExpandedSortedRowTreeLevelPositionLookupSelector } from "../hooks/features/filter/gridFilterSelector.js";
+export { gridFilteredChildrenCountLookupSelector, gridExpandedSortedRowTreeLevelPositionLookupSelector, gridExpandedSortedRowIndexLookupSelector } from "../hooks/features/filter/gridFilterSelector.js";
 export { isSingleSelectColDef } from "../components/panel/filterPanel/filterPanelUtils.js";
 export type { GridAggregatedFilterItemApplier, GridAggregatedFilterItemApplierResult } from "../hooks/features/filter/gridFilterState.js";
 export { useGridFocus, focusStateInitializer } from "../hooks/features/focus/useGridFocus.js";
@@ -54,6 +54,7 @@ export { useGridRows, rowsStateInitializer } from "../hooks/features/rows/useGri
 export { useGridRowSpanning, rowSpanningStateInitializer } from "../hooks/features/rows/useGridRowSpanning.js";
 export { useGridAriaAttributes } from "../hooks/utils/useGridAriaAttributes.js";
 export { useGridRowAriaAttributes } from "../hooks/features/rows/useGridRowAriaAttributes.js";
+export { useGridRowsOverridableMethods } from "../hooks/features/rows/useGridRowsOverridableMethods.js";
 export { useGridRowsPreProcessors } from "../hooks/features/rows/useGridRowsPreProcessors.js";
 export type { GridRowTreeCreationParams, GridRowTreeCreationValue, GridHydrateRowsValue, GridRowsPartialUpdates, GridRowsPartialUpdateAction, GridTreeDepths, GridRowTreeUpdatedGroupsManager, GridRowTreeUpdateGroupAction, GridPinnedRowsState } from "../hooks/features/rows/gridRowsInterfaces.js";
 export { getTreeNodeDescendants, buildRootGroup } from "../hooks/features/rows/gridRowsUtils.js";

package/esm/internals/index.js

@@ -31,7 +31,7 @@ export { useGridPrintExport } from "../hooks/features/export/useGridPrintExport.
 export { useGridFilter, filterStateInitializer } from "../hooks/features/filter/useGridFilter.js";
 export { defaultGridFilterLookup } from "../hooks/features/filter/gridFilterState.js";
 export { passFilterLogic } from "../hooks/features/filter/gridFilterUtils.js";
-export { gridFilteredChildrenCountLookupSelector, gridExpandedSortedRowTreeLevelPositionLookupSelector } from "../hooks/features/filter/gridFilterSelector.js";
+export { gridFilteredChildrenCountLookupSelector, gridExpandedSortedRowTreeLevelPositionLookupSelector, gridExpandedSortedRowIndexLookupSelector } from "../hooks/features/filter/gridFilterSelector.js";
 export { isSingleSelectColDef } from "../components/panel/filterPanel/filterPanelUtils.js";
 export { useGridFocus, focusStateInitializer } from "../hooks/features/focus/useGridFocus.js";
 export { useGridKeyboardNavigation } from "../hooks/features/keyboardNavigation/useGridKeyboardNavigation.js";
@@ -43,6 +43,7 @@ export { useGridRows, rowsStateInitializer } from "../hooks/features/rows/useGri
 export { useGridRowSpanning, rowSpanningStateInitializer } from "../hooks/features/rows/useGridRowSpanning.js";
 export { useGridAriaAttributes } from "../hooks/utils/useGridAriaAttributes.js";
 export { useGridRowAriaAttributes } from "../hooks/features/rows/useGridRowAriaAttributes.js";
+export { useGridRowsOverridableMethods } from "../hooks/features/rows/useGridRowsOverridableMethods.js";
 export { useGridRowsPreProcessors } from "../hooks/features/rows/useGridRowsPreProcessors.js";
 export { getTreeNodeDescendants, buildRootGroup } from "../hooks/features/rows/gridRowsUtils.js";
 export { useGridRowsMeta, rowsMetaStateInitializer } from "../hooks/features/rows/useGridRowsMeta.js";

package/esm/material/index.js

@@ -58,6 +58,7 @@ import MUIInputLabel from '@mui/material/InputLabel';
 import MUISkeleton from '@mui/material/Skeleton';
 import { forwardRef } from '@mui/x-internals/forwardRef';
 import { GridAddIcon, GridArrowDownwardIcon, GridArrowUpwardIcon, GridCheckIcon, GridCloseIcon, GridColumnIcon, GridDragIcon, GridExpandMoreIcon, GridFilterAltIcon, GridFilterListIcon, GridKeyboardArrowRight, GridMoreVertIcon, GridRemoveIcon, GridSearchIcon, GridSeparatorIcon, GridTableRowsIcon, GridTripleDotsVerticalIcon, GridViewHeadlineIcon, GridViewStreamIcon, GridVisibilityOffIcon, GridViewColumnIcon, GridClearIcon, GridLoadIcon, GridDeleteForeverIcon, GridDownloadIcon } from "./icons/index.js";
+import { GridColumnUnsortedIcon } from "../components/GridColumnUnsortedIcon.js";
 import { useGridApiContext } from "../hooks/utils/useGridApiContext.js";
 import { useGridRootProps } from "../hooks/utils/useGridRootProps.js";
 import "./augmentation.js";
@@ -663,6 +664,7 @@ const iconSlots = {
   filterPanelDeleteIcon: GridCloseIcon,
   columnFilteredIcon: GridFilterAltIcon,
   columnSelectorIcon: GridColumnIcon,
+  columnUnsortedIcon: GridColumnUnsortedIcon,
   columnSortedAscendingIcon: GridArrowUpwardIcon,
   columnSortedDescendingIcon: GridArrowDownwardIcon,
   columnResizeIcon: GridSeparatorIcon,

package/esm/models/api/gridParamsApi.d.ts

@@ -13,7 +13,7 @@ export interface GridParamsApi {
    * @param {string} field The column field.
    * @returns {v} The cell value.
    */
-  getCellValue: <V extends any = any>(id: GridRowId, field: string) => V;
+  getCellValue: <V = any>(id: GridRowId, field: string) => V;
   /**
    * Gets the cell value.
    * Use it instead of `getCellValue` for better performance if you have `row` and `colDef`.
@@ -23,7 +23,7 @@ export interface GridParamsApi {
    * @returns {v} The cell value.
    * @ignore - do not document
    */
-  getRowValue: <V extends any = any>(row: GridRowModel, colDef: GridColDef) => V;
+  getRowValue: <V = any>(row: GridRowModel, colDef: GridColDef) => V;
   /**
    * Gets the cell formatted value
    * Use it instead of `getCellParams` for better performance if you only need the formatted value.
@@ -33,7 +33,7 @@ export interface GridParamsApi {
    * @returns {v} The cell value.
    * @ignore - do not document
    */
-  getRowFormattedValue: <V extends any = any>(row: GridRowModel, colDef: GridColDef) => V;
+  getRowFormattedValue: <V = any>(row: GridRowModel, colDef: GridColDef) => V;
   /**
    * Gets the [[GridCellParams]] object that is passed as argument in events.
    * @param {GridRowId} id The id of the row.

package/esm/models/colDef/gridColDef.d.ts

@@ -279,14 +279,16 @@ export interface GridSingleSelectColDef<R extends GridValidRowModel = any, V = a
    * Used to determine the label displayed for a given value option.
    * @param {ValueOptions} value The current value option.
    * @returns {string} The text to be displayed.
+   * @default {defaultGetOptionLabel}
    */
-  getOptionLabel?: (value: ValueOptions) => string;
+  getOptionLabel: (value: ValueOptions) => string;
   /**
    * Used to determine the value used for a value option.
    * @param {ValueOptions} value The current value option.
    * @returns {string} The value to be used.
+   * @default {defaultGetOptionValue}
    */
-  getOptionValue?: (value: ValueOptions) => any;
+  getOptionValue: (value: ValueOptions) => any;
 }
 /**
  * Column Definition interface.

package/esm/models/configuration/gridConfiguration.d.ts

@@ -1,11 +1,13 @@
 import * as React from 'react';
-import { GridRowAriaAttributesInternalHook } from "./gridRowConfiguration.js";
+import { GridRowAriaAttributesInternalHook, GridRowsOverridableMethodsInternalHook } from "./gridRowConfiguration.js";
 import type { GridCSSVariablesInterface } from "../../constants/cssVariables.js";
 import type { GridRowId } from "../gridRows.js";
+import type { GridPrivateApiCommon } from "../api/gridApiCommon.js";
+import type { GridPrivateApiCommunity } from "../api/gridApiCommunity.js";
 export interface GridAriaAttributesInternalHook {
   useGridAriaAttributes: () => React.HTMLAttributes<HTMLElement>;
 }
-export interface GridInternalHook extends GridAriaAttributesInternalHook, GridRowAriaAttributesInternalHook {
+export interface GridInternalHook<Api> extends GridAriaAttributesInternalHook, GridRowAriaAttributesInternalHook, GridRowsOverridableMethodsInternalHook<Api> {
   useCSSVariables: () => {
     id: string;
     variables: GridCSSVariablesInterface;
@@ -15,6 +17,6 @@ export interface GridInternalHook extends GridAriaAttributesInternalHook, GridRo
     value: any;
   } | null;
 }
-export interface GridConfiguration {
-  hooks: GridInternalHook;
+export interface GridConfiguration<Api extends GridPrivateApiCommon = GridPrivateApiCommunity> {
+  hooks: GridInternalHook<Api>;
 }

package/esm/models/configuration/gridRowConfiguration.d.ts

@@ -1,5 +1,7 @@
 import * as React from 'react';
-import { GridTreeNode } from "../gridRows.js";
+import { RefObject } from '@mui/x-internals/types';
+import { GridTreeNode, GridRowId } from "../gridRows.js";
+import { DataGridProcessedProps } from "../props/DataGridProps.js";
 /**
  * Get the ARIA attributes for a row
  * @param {GridTreeNode} rowNode The row node
@@ -9,4 +11,12 @@ import { GridTreeNode } from "../gridRows.js";
 export type GetRowAriaAttributesFn = (rowNode: GridTreeNode, index: number) => React.HTMLAttributes<HTMLElement>;
 export interface GridRowAriaAttributesInternalHook {
   useGridRowAriaAttributes: () => GetRowAriaAttributesFn;
+}
+/**
+ * Overridable row methods interface, these methods could be overriden in a higher plan package.
+ */
+export interface GridRowsOverridableMethodsInternalHook<Api> {
+  useGridRowsOverridableMethods: (apiRef: RefObject<Api>, props: Pick<DataGridProcessedProps, 'processRowUpdate' | 'onProcessRowUpdateError' | 'dataSource'>) => {
+    setRowIndex: (rowId: GridRowId, targetIndex: number) => void;
+  };
 }

package/esm/models/gridIconSlotsComponent.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { IconProps } from "./gridBaseSlots.js";
+import type { GridColumnUnsortedIconProps } from "../components/GridColumnUnsortedIcon.js";
 /**
  * Set of icons used in the grid component UI.
  */
@@ -34,6 +35,11 @@ export interface GridIconSlotsComponent {
    * @default GridColumnIcon
    */
   columnSelectorIcon: React.JSXElementConstructor<IconProps>;
+  /**
+   * Icon displayed on the side of the column header title when unsorted.
+   * @default GridColumnUnsortedIcon
+   */
+  columnUnsortedIcon: React.JSXElementConstructor<GridColumnUnsortedIconProps> | null;
   /**
    * Icon displayed on the side of the column header title when sorted in ascending order.
    * @default GridArrowUpwardIcon

package/esm/models/props/DataGridProps.d.ts

@@ -787,7 +787,7 @@ export interface DataGridPropsWithoutDefaultValue<R extends GridValidRowModel =
     rowId: GridRowId;
   }) => Promise<R> | R;
   /**
-   * Callback called when `processRowUpdate` throws an error or rejects.
+   * Callback called when `processRowUpdate()` throws an error or rejects.
    * @param {any} error The error thrown.
    */
   onProcessRowUpdateError?: (error: any) => void;

package/esm/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.js

@@ -10,7 +10,5 @@ export class FinalizationRegistryBasedCleanupTracking {
   unregister(unregisterToken) {
     this.registry.unregister(unregisterToken);
   }
-
-  // eslint-disable-next-line class-methods-use-this
   reset() {}
 }

package/hooks/core/pipeProcessing/gridPipeProcessingApi.d.ts

@@ -91,6 +91,21 @@ export interface GridPipeProcessingLookup {
     };
     context: boolean;
   };
+  /**
+   * Does validation of the current reorder operation.
+   * If the reorder is valid, it returns the position index of the drop indicator.
+   *   - For example before first row is `0` and after the last row is `rows.length`.
+   * If the reorder is invalid, it returns `-1`.
+   */
+  getRowReorderTargetIndex: {
+    value: number;
+    context: {
+      sourceRowId: GridRowId;
+      targetRowId: GridRowId;
+      dropPosition: 'above' | 'below';
+      dragDirection: 'up' | 'down';
+    };
+  };
 }
 export type GridPipeProcessor<P extends GridPipeProcessorGroup> = (value: GridPipeProcessingLookup[P]['value'], context: GridPipeProcessingLookup[P] extends {
   context: any;

package/hooks/features/editing/useGridCellEditing.js

@@ -372,7 +372,7 @@ const useGridCellEditing = (apiRef, props) => {
         if (onProcessRowUpdateError) {
           onProcessRowUpdateError(errorThrown);
         } else if (process.env.NODE_ENV !== 'production') {
-          (0, _warning.warnOnce)(['MUI X: A call to `processRowUpdate` threw an error which was not handled because `onProcessRowUpdateError` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
+          (0, _warning.warnOnce)(['MUI X: A call to `processRowUpdate()` threw an error which was not handled because `onProcessRowUpdateError()` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError()` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
         }
       };
       try {

package/hooks/features/editing/useGridRowEditing.js

@@ -456,7 +456,7 @@ const useGridRowEditing = (apiRef, props) => {
         if (onProcessRowUpdateError) {
           onProcessRowUpdateError(errorThrown);
         } else if (process.env.NODE_ENV !== 'production') {
-          (0, _warning.warnOnce)(['MUI X: A call to `processRowUpdate` threw an error which was not handled because `onProcessRowUpdateError` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
+          (0, _warning.warnOnce)(['MUI X: A call to `processRowUpdate()` threw an error which was not handled because `onProcessRowUpdateError()` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError()` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
         }
       };
       try {

package/hooks/features/filter/gridFilterSelector.d.ts

@@ -134,4 +134,12 @@ export type GridFilterActiveItemsLookup = {
  */
 export declare const gridFilterActiveItemsLookupSelector: (args_0: import("react").RefObject<{
   state: GridStateCommunity;
-} | null>) => GridFilterActiveItemsLookup;
+} | null>) => GridFilterActiveItemsLookup;
+/**
+ * Get the index lookup for expanded (visible) rows only.
+ * Does not include collapsed children.
+ * @ignore - do not document.
+ */
+export declare const gridExpandedSortedRowIndexLookupSelector: (args_0: import("react").RefObject<{
+  state: GridStateCommunity;
+} | null>) => Record<GridRowId, number>;

package/hooks/features/filter/gridFilterSelector.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.gridVisibleRowsLookupSelector = exports.gridQuickFilterValuesSelector = exports.gridFilteredTopLevelRowCountSelector = exports.gridFilteredSortedTopLevelRowEntriesSelector = exports.gridFilteredSortedRowIdsSelector = exports.gridFilteredSortedRowEntriesSelector = exports.gridFilteredRowsLookupSelector = exports.gridFilteredRowCountSelector = exports.gridFilteredDescendantRowCountSelector = exports.gridFilteredDescendantCountLookupSelector = exports.gridFilteredChildrenCountLookupSelector = exports.gridFilterModelSelector = exports.gridFilterActiveItemsSelector = exports.gridFilterActiveItemsLookupSelector = exports.gridExpandedSortedRowTreeLevelPositionLookupSelector = exports.gridExpandedSortedRowIdsSelector = exports.gridExpandedSortedRowEntriesSelector = exports.gridExpandedRowCountSelector = void 0;
+exports.gridVisibleRowsLookupSelector = exports.gridQuickFilterValuesSelector = exports.gridFilteredTopLevelRowCountSelector = exports.gridFilteredSortedTopLevelRowEntriesSelector = exports.gridFilteredSortedRowIdsSelector = exports.gridFilteredSortedRowEntriesSelector = exports.gridFilteredRowsLookupSelector = exports.gridFilteredRowCountSelector = exports.gridFilteredDescendantRowCountSelector = exports.gridFilteredDescendantCountLookupSelector = exports.gridFilteredChildrenCountLookupSelector = exports.gridFilterModelSelector = exports.gridFilterActiveItemsSelector = exports.gridFilterActiveItemsLookupSelector = exports.gridExpandedSortedRowTreeLevelPositionLookupSelector = exports.gridExpandedSortedRowIndexLookupSelector = exports.gridExpandedSortedRowIdsSelector = exports.gridExpandedSortedRowEntriesSelector = exports.gridExpandedRowCountSelector = void 0;
 var _isObjectEmpty = require("@mui/x-internals/isObjectEmpty");
 var _createSelector = require("../../../utils/createSelector");
 var _gridSortingSelector = require("../sorting/gridSortingSelector");
@@ -179,4 +179,16 @@ const gridFilterActiveItemsLookupSelector = exports.gridFilterActiveItemsLookupS
     return res;
   }, {});
   return result;
+});
+
+/**
+ * Get the index lookup for expanded (visible) rows only.
+ * Does not include collapsed children.
+ * @ignore - do not document.
+ */
+const gridExpandedSortedRowIndexLookupSelector = exports.gridExpandedSortedRowIndexLookupSelector = (0, _createSelector.createSelectorMemoized)(gridExpandedSortedRowIdsSelector, expandedSortedIds => {
+  return expandedSortedIds.reduce((acc, id, index) => {
+    acc[id] = index;
+    return acc;
+  }, Object.create(null));
 });

package/hooks/features/pagination/useGridPaginationModel.js

@@ -227,13 +227,13 @@ const useGridPaginationModel = (apiRef, props) => {
   React.useEffect(() => {
     apiRef.current.setState(state => {
       const isEnabled = props.pagination === true;
-      if (state.pagination.paginationMode === props.paginationMode || state.pagination.enabled === isEnabled) {
+      if (state.pagination.paginationMode === props.paginationMode && state.pagination.enabled === isEnabled) {
         return state;
       }
       return (0, _extends2.default)({}, state, {
         pagination: (0, _extends2.default)({}, state.pagination, {
           paginationMode: props.paginationMode,
-          enabled: props.pagination === true
+          enabled: isEnabled
         })
       });
     });

package/hooks/features/rows/useGridRows.d.ts

@@ -2,5 +2,6 @@ import { RefObject } from '@mui/x-internals/types';
 import { DataGridProcessedProps } from "../../../models/props/DataGridProps.js";
 import { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
 import { GridStateInitializer } from "../../utils/useGridInitializeState.js";
+import type { GridConfiguration } from "../../../models/configuration/gridConfiguration.js";
 export declare const rowsStateInitializer: GridStateInitializer<Pick<DataGridProcessedProps, 'dataSource' | 'rows' | 'rowCount' | 'getRowId' | 'loading'>>;
-export declare const useGridRows: (apiRef: RefObject<GridPrivateApiCommunity>, props: Pick<DataGridProcessedProps, "rows" | "getRowId" | "rowCount" | "throttleRowsMs" | "signature" | "pagination" | "paginationMode" | "loading" | "dataSource">) => void;
+export declare const useGridRows: (apiRef: RefObject<GridPrivateApiCommunity>, props: Pick<DataGridProcessedProps, "rows" | "getRowId" | "rowCount" | "throttleRowsMs" | "signature" | "pagination" | "paginationMode" | "loading" | "dataSource" | "processRowUpdate" | "onProcessRowUpdateError">, configuration: GridConfiguration) => void;