@mui/x-data-grid 8.0.0-alpha.11 → 8.0.0-alpha.13

package/esm/hooks/features/rowSelection/useGridRowSelection.js

@@ -0,0 +1,547 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import useEventCallback from '@mui/utils/useEventCallback';
+import { GridSignature } from "../../../constants/signature.js";
+import { useGridApiEventHandler } from "../../utils/useGridApiEventHandler.js";
+import { useGridApiMethod } from "../../utils/useGridApiMethod.js";
+import { useGridLogger } from "../../utils/useGridLogger.js";
+import { useGridSelector } from "../../utils/useGridSelector.js";
+import { gridRowsLookupSelector, gridRowMaximumTreeDepthSelector, gridRowNodeSelector, gridRowTreeSelector } from "../rows/gridRowsSelector.js";
+import { gridRowSelectionManagerSelector, gridRowSelectionStateSelector, gridRowSelectionCountSelector, gridRowSelectionIdsSelector } from "./gridRowSelectionSelector.js";
+import { gridFocusCellSelector } from "../focus/gridFocusStateSelector.js";
+import { gridExpandedSortedRowIdsSelector, gridFilteredRowsLookupSelector, gridFilterModelSelector, gridQuickFilterValuesSelector } from "../filter/gridFilterSelector.js";
+import { GRID_CHECKBOX_SELECTION_COL_DEF, GRID_ACTIONS_COLUMN_TYPE } from "../../../colDef/index.js";
+import { GridCellModes } from "../../../models/gridEditRowModel.js";
+import { isKeyboardEvent, isNavigationKey } from "../../../utils/keyboardUtils.js";
+import { getVisibleRows } from "../../utils/useGridVisibleRows.js";
+import { GRID_DETAIL_PANEL_TOGGLE_FIELD } from "../../../internals/constants.js";
+import { gridClasses } from "../../../constants/gridClasses.js";
+import { isEventTargetInPortal } from "../../../utils/domUtils.js";
+import { isMultipleRowSelectionEnabled, findRowsToSelect, findRowsToDeselect } from "./utils.js";
+import { createRowSelectionManager } from "../../../models/gridRowSelectionManager.js";
+import { gridPaginatedVisibleSortedGridRowIdsSelector } from "../pagination/index.js";
+const emptyModel = {
+  type: 'include',
+  ids: new Set()
+};
+export const rowSelectionStateInitializer = (state, props) => _extends({}, state, {
+  rowSelection: props.rowSelection ? props.rowSelectionModel ?? emptyModel : emptyModel
+});
+
+/**
+ * @requires useGridRows (state, method) - can be after
+ * @requires useGridParamsApi (method) - can be after
+ * @requires useGridFocus (state) - can be after
+ * @requires useGridKeyboardNavigation (`cellKeyDown` event must first be consumed by it)
+ */
+export const useGridRowSelection = (apiRef, props) => {
+  const logger = useGridLogger(apiRef, 'useGridSelection');
+  const runIfRowSelectionIsEnabled = React.useCallback(callback => (...args) => {
+    if (props.rowSelection) {
+      callback(...args);
+    }
+  }, [props.rowSelection]);
+  const applyAutoSelection = props.signature !== GridSignature.DataGrid && (props.rowSelectionPropagation?.parents || props.rowSelectionPropagation?.descendants);
+  const propRowSelectionModel = React.useMemo(() => {
+    return props.rowSelectionModel;
+  }, [props.rowSelectionModel]);
+  const lastRowToggled = React.useRef(null);
+  apiRef.current.registerControlState({
+    stateId: 'rowSelection',
+    propModel: propRowSelectionModel,
+    propOnChange: props.onRowSelectionModelChange,
+    stateSelector: gridRowSelectionStateSelector,
+    changeEvent: 'rowSelectionChange'
+  });
+  const {
+    checkboxSelection,
+    disableRowSelectionOnClick,
+    isRowSelectable: propIsRowSelectable
+  } = props;
+  const canHaveMultipleSelection = isMultipleRowSelectionEnabled(props);
+  const tree = useGridSelector(apiRef, gridRowTreeSelector);
+  const isNestedData = useGridSelector(apiRef, gridRowMaximumTreeDepthSelector) > 1;
+  const expandMouseRowRangeSelection = React.useCallback(id => {
+    let endId = id;
+    const startId = lastRowToggled.current ?? id;
+    const isSelected = apiRef.current.isRowSelected(id);
+    if (isSelected) {
+      const visibleRowIds = gridExpandedSortedRowIdsSelector(apiRef);
+      const startIndex = visibleRowIds.findIndex(rowId => rowId === startId);
+      const endIndex = visibleRowIds.findIndex(rowId => rowId === endId);
+      if (startIndex === endIndex) {
+        return;
+      }
+      if (startIndex > endIndex) {
+        endId = visibleRowIds[endIndex + 1];
+      } else {
+        endId = visibleRowIds[endIndex - 1];
+      }
+    }
+    lastRowToggled.current = id;
+    apiRef.current.selectRowRange({
+      startId,
+      endId
+    }, !isSelected);
+  }, [apiRef]);
+  const getRowsToBeSelected = useEventCallback(() => {
+    const rowsToBeSelected = props.pagination && props.checkboxSelectionVisibleOnly && props.paginationMode === 'client' ? gridPaginatedVisibleSortedGridRowIdsSelector(apiRef) : gridExpandedSortedRowIdsSelector(apiRef);
+    return rowsToBeSelected;
+  });
+
+  /*
+   * API METHODS
+   */
+  const setRowSelectionModel = React.useCallback(model => {
+    if (props.signature === GridSignature.DataGrid && !canHaveMultipleSelection && (model.type !== 'include' || model.ids.size > 1)) {
+      throw new Error(['MUI X: `rowSelectionModel` can only contain 1 item in DataGrid.', 'You need to upgrade to DataGridPro or DataGridPremium component to unlock multiple selection.'].join('\n'));
+    }
+    const currentModel = gridRowSelectionStateSelector(apiRef);
+    if (currentModel !== model) {
+      logger.debug(`Setting selection model`);
+      apiRef.current.setState(state => _extends({}, state, {
+        rowSelection: props.rowSelection ? model : emptyModel
+      }));
+    }
+  }, [apiRef, logger, props.rowSelection, props.signature, canHaveMultipleSelection]);
+  const isRowSelected = React.useCallback(id => {
+    const selectionManager = gridRowSelectionManagerSelector(apiRef);
+    return selectionManager.has(id);
+  }, [apiRef]);
+  const isRowSelectable = React.useCallback(id => {
+    if (props.rowSelection === false) {
+      return false;
+    }
+    if (propIsRowSelectable && !propIsRowSelectable(apiRef.current.getRowParams(id))) {
+      return false;
+    }
+    const rowNode = gridRowNodeSelector(apiRef, id);
+    if (rowNode?.type === 'footer' || rowNode?.type === 'pinnedRow') {
+      return false;
+    }
+    return true;
+  }, [apiRef, props.rowSelection, propIsRowSelectable]);
+  const getSelectedRows = React.useCallback(() => gridRowSelectionIdsSelector(apiRef), [apiRef]);
+  const selectRow = React.useCallback((id, isSelected = true, resetSelection = false) => {
+    if (!apiRef.current.isRowSelectable(id)) {
+      return;
+    }
+    lastRowToggled.current = id;
+    if (resetSelection) {
+      logger.debug(`Setting selection for row ${id}`);
+      const newSelectionModel = {
+        type: 'include',
+        ids: new Set()
+      };
+      const addRow = rowId => {
+        newSelectionModel.ids.add(rowId);
+      };
+      if (isSelected) {
+        addRow(id);
+        if (applyAutoSelection) {
+          findRowsToSelect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, addRow);
+        }
+      }
+      apiRef.current.setRowSelectionModel(newSelectionModel);
+    } else {
+      logger.debug(`Toggling selection for row ${id}`);
+      const selectionModel = gridRowSelectionStateSelector(apiRef);
+      const newSelectionModel = {
+        type: selectionModel.type,
+        ids: new Set(selectionModel.ids)
+      };
+      const selectionManager = createRowSelectionManager(newSelectionModel);
+      selectionManager.unselect(id);
+      const addRow = rowId => {
+        selectionManager.select(rowId);
+      };
+      const removeRow = rowId => {
+        selectionManager.unselect(rowId);
+      };
+      if (isSelected) {
+        addRow(id);
+        if (applyAutoSelection) {
+          findRowsToSelect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, addRow);
+        }
+      } else if (applyAutoSelection) {
+        findRowsToDeselect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, removeRow);
+      }
+      const isSelectionValid = newSelectionModel.type === 'include' && newSelectionModel.ids.size < 2 || canHaveMultipleSelection;
+      if (isSelectionValid) {
+        apiRef.current.setRowSelectionModel(newSelectionModel);
+      }
+    }
+  }, [apiRef, logger, applyAutoSelection, tree, props.rowSelectionPropagation?.descendants, props.rowSelectionPropagation?.parents, canHaveMultipleSelection]);
+  const selectRows = React.useCallback((ids, isSelected = true, resetSelection = false) => {
+    logger.debug(`Setting selection for several rows`);
+    if (props.rowSelection === false) {
+      return;
+    }
+    const selectableIds = new Set();
+    for (let i = 0; i < ids.length; i += 1) {
+      const id = ids[i];
+      if (apiRef.current.isRowSelectable(id)) {
+        selectableIds.add(id);
+      }
+    }
+    const currentSelectionModel = gridRowSelectionStateSelector(apiRef);
+    let newSelectionModel;
+    if (resetSelection) {
+      newSelectionModel = {
+        type: 'include',
+        ids: selectableIds
+      };
+      if (isSelected) {
+        const selectionManager = createRowSelectionManager(newSelectionModel);
+        if (applyAutoSelection) {
+          const addRow = rowId => {
+            selectionManager.select(rowId);
+          };
+          for (const id of selectableIds) {
+            findRowsToSelect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, addRow);
+          }
+        }
+      } else {
+        newSelectionModel.ids = new Set();
+      }
+      if (currentSelectionModel.type === newSelectionModel.type && newSelectionModel.ids.size === currentSelectionModel.ids.size && Array.from(newSelectionModel.ids).every(id => currentSelectionModel.ids.has(id))) {
+        return;
+      }
+    } else {
+      newSelectionModel = {
+        type: currentSelectionModel.type,
+        ids: new Set(currentSelectionModel.ids)
+      };
+      const selectionManager = createRowSelectionManager(newSelectionModel);
+      const addRow = rowId => {
+        selectionManager.select(rowId);
+      };
+      const removeRow = rowId => {
+        selectionManager.unselect(rowId);
+      };
+      for (const id of selectableIds) {
+        if (isSelected) {
+          selectionManager.select(id);
+          if (applyAutoSelection) {
+            findRowsToSelect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, addRow);
+          }
+        } else {
+          removeRow(id);
+          if (applyAutoSelection) {
+            findRowsToDeselect(apiRef, tree, id, props.rowSelectionPropagation?.descendants ?? false, props.rowSelectionPropagation?.parents ?? false, removeRow);
+          }
+        }
+      }
+    }
+    const isSelectionValid = newSelectionModel.type === 'include' && newSelectionModel.ids.size < 2 || canHaveMultipleSelection;
+    if (isSelectionValid) {
+      apiRef.current.setRowSelectionModel(newSelectionModel);
+    }
+  }, [logger, applyAutoSelection, canHaveMultipleSelection, apiRef, tree, props.rowSelectionPropagation?.descendants, props.rowSelectionPropagation?.parents, props.rowSelection]);
+  const selectRowRange = React.useCallback(({
+    startId,
+    endId
+  }, isSelected = true, resetSelection = false) => {
+    if (!apiRef.current.getRow(startId) || !apiRef.current.getRow(endId)) {
+      return;
+    }
+    logger.debug(`Expanding selection from row ${startId} to row ${endId}`);
+
+    // Using rows from all pages allow to select a range across several pages
+    const allPagesRowIds = gridExpandedSortedRowIdsSelector(apiRef);
+    const startIndex = allPagesRowIds.indexOf(startId);
+    const endIndex = allPagesRowIds.indexOf(endId);
+    const [start, end] = startIndex > endIndex ? [endIndex, startIndex] : [startIndex, endIndex];
+    const rowsBetweenStartAndEnd = allPagesRowIds.slice(start, end + 1);
+    apiRef.current.selectRows(rowsBetweenStartAndEnd, isSelected, resetSelection);
+  }, [apiRef, logger]);
+  const selectionPublicApi = {
+    selectRow,
+    setRowSelectionModel,
+    getSelectedRows,
+    isRowSelected,
+    isRowSelectable
+  };
+  const selectionPrivateApi = {
+    selectRows,
+    selectRowRange
+  };
+  useGridApiMethod(apiRef, selectionPublicApi, 'public');
+  useGridApiMethod(apiRef, selectionPrivateApi, props.signature === GridSignature.DataGrid ? 'private' : 'public');
+
+  /*
+   * EVENTS
+   */
+  const removeOutdatedSelection = React.useCallback((sortModelUpdated = false) => {
+    const currentSelection = gridRowSelectionStateSelector(apiRef);
+    const rowsLookup = gridRowsLookupSelector(apiRef);
+    const filteredRowsLookup = gridFilteredRowsLookupSelector(apiRef);
+    const isNonExistent = id => {
+      if (props.filterMode === 'server') {
+        return !rowsLookup[id];
+      }
+      return !rowsLookup[id] || filteredRowsLookup[id] === false;
+    };
+    const newSelectionModel = {
+      type: currentSelection.type,
+      ids: new Set(currentSelection.ids)
+    };
+    const selectionManager = createRowSelectionManager(newSelectionModel);
+    let hasChanged = false;
+    for (const id of currentSelection.ids) {
+      if (isNonExistent(id)) {
+        if (props.keepNonExistentRowsSelected) {
+          continue;
+        }
+        selectionManager.unselect(id);
+        hasChanged = true;
+        continue;
+      }
+      if (!props.rowSelectionPropagation?.parents) {
+        continue;
+      }
+      const node = tree[id];
+      if (node?.type === 'group') {
+        const isAutoGenerated = node.isAutoGenerated;
+        if (isAutoGenerated) {
+          selectionManager.unselect(id);
+          hasChanged = true;
+          continue;
+        }
+        // Keep previously selected tree data parents selected if all their children are filtered out
+        if (!node.children.every(childId => filteredRowsLookup[childId] === false)) {
+          selectionManager.unselect(id);
+          hasChanged = true;
+        }
+      }
+    }
+
+    // For nested data, on row tree updation (filtering, adding rows, etc.) when the selection is
+    // not empty, we need to re-run scanning of the tree to propagate the selection changes
+    // Example: A parent whose de-selected children are filtered out should now be selected
+    const shouldReapplyPropagation = isNestedData && props.rowSelectionPropagation?.parents && (newSelectionModel.ids.size > 0 ||
+    // In case of exclude selection, newSelectionModel.ids.size === 0 means all rows are selected
+    newSelectionModel.type === 'exclude');
+    if (hasChanged || shouldReapplyPropagation && !sortModelUpdated) {
+      if (shouldReapplyPropagation) {
+        if (newSelectionModel.type === 'exclude') {
+          const unfilteredSelectedRowIds = getRowsToBeSelected();
+          const selectedRowIds = [];
+          for (let i = 0; i < unfilteredSelectedRowIds.length; i += 1) {
+            const rowId = unfilteredSelectedRowIds[i];
+            if ((props.keepNonExistentRowsSelected || !isNonExistent(rowId)) && selectionManager.has(rowId)) {
+              selectedRowIds.push(rowId);
+            }
+          }
+          apiRef.current.selectRows(selectedRowIds, true, true);
+        } else {
+          apiRef.current.selectRows(Array.from(newSelectionModel.ids), true, true);
+        }
+      } else {
+        apiRef.current.setRowSelectionModel(newSelectionModel);
+      }
+    }
+  }, [apiRef, isNestedData, props.rowSelectionPropagation?.parents, props.keepNonExistentRowsSelected, props.filterMode, tree, getRowsToBeSelected]);
+  const handleSingleRowSelection = React.useCallback((id, event) => {
+    const hasCtrlKey = event.metaKey || event.ctrlKey;
+
+    // multiple selection is only allowed if:
+    // - it is a checkboxSelection
+    // - it is a keyboard selection
+    // - Ctrl is pressed
+
+    const isMultipleSelectionDisabled = !checkboxSelection && !hasCtrlKey && !isKeyboardEvent(event);
+    const resetSelection = !canHaveMultipleSelection || isMultipleSelectionDisabled;
+    const selectedRowsCount = gridRowSelectionCountSelector(apiRef);
+    if (canHaveMultipleSelection && selectedRowsCount > 1 && !hasCtrlKey) {
+      apiRef.current.selectRow(id, true, resetSelection);
+    } else {
+      const isSelected = apiRef.current.isRowSelected(id);
+      apiRef.current.selectRow(id, !isSelected, resetSelection);
+    }
+  }, [apiRef, canHaveMultipleSelection, checkboxSelection]);
+  const handleRowClick = React.useCallback((params, event) => {
+    if (disableRowSelectionOnClick) {
+      return;
+    }
+    const field = event.target.closest(`.${gridClasses.cell}`)?.getAttribute('data-field');
+    if (field === GRID_CHECKBOX_SELECTION_COL_DEF.field) {
+      // click on checkbox should not trigger row selection
+      return;
+    }
+    if (field === GRID_DETAIL_PANEL_TOGGLE_FIELD) {
+      // click to open the detail panel should not select the row
+      return;
+    }
+    if (field) {
+      const column = apiRef.current.getColumn(field);
+      if (column?.type === GRID_ACTIONS_COLUMN_TYPE) {
+        return;
+      }
+    }
+    const rowNode = gridRowNodeSelector(apiRef, params.id);
+    if (rowNode.type === 'pinnedRow') {
+      return;
+    }
+    if (event.shiftKey && canHaveMultipleSelection) {
+      expandMouseRowRangeSelection(params.id);
+    } else {
+      handleSingleRowSelection(params.id, event);
+    }
+  }, [disableRowSelectionOnClick, canHaveMultipleSelection, apiRef, expandMouseRowRangeSelection, handleSingleRowSelection]);
+  const preventSelectionOnShift = React.useCallback((params, event) => {
+    if (canHaveMultipleSelection && event.shiftKey) {
+      window.getSelection()?.removeAllRanges();
+    }
+  }, [canHaveMultipleSelection]);
+  const handleRowSelectionCheckboxChange = React.useCallback((params, event) => {
+    if (canHaveMultipleSelection && event.nativeEvent.shiftKey) {
+      expandMouseRowRangeSelection(params.id);
+    } else {
+      apiRef.current.selectRow(params.id, params.value, !canHaveMultipleSelection);
+    }
+  }, [apiRef, expandMouseRowRangeSelection, canHaveMultipleSelection]);
+  const toggleAllRows = React.useCallback(value => {
+    const filterModel = gridFilterModelSelector(apiRef);
+    const quickFilterModel = gridQuickFilterValuesSelector(apiRef);
+    const hasFilters = filterModel.items.length > 0 || (quickFilterModel?.length || 0) > 0;
+    if (!props.isRowSelectable && !props.checkboxSelectionVisibleOnly && applyAutoSelection && !hasFilters) {
+      apiRef.current.setRowSelectionModel({
+        type: value ? 'exclude' : 'include',
+        ids: new Set()
+      });
+    } else {
+      apiRef.current.selectRows(getRowsToBeSelected(), value);
+    }
+  }, [apiRef, applyAutoSelection, getRowsToBeSelected, props.checkboxSelectionVisibleOnly, props.isRowSelectable]);
+  const handleHeaderSelectionCheckboxChange = React.useCallback(params => {
+    toggleAllRows(params.value);
+  }, [toggleAllRows]);
+  const handleCellKeyDown = React.useCallback((params, event) => {
+    // Get the most recent cell mode because it may have been changed by another listener
+    if (apiRef.current.getCellMode(params.id, params.field) === GridCellModes.Edit) {
+      return;
+    }
+
+    // Ignore portal
+    // Do not apply shortcuts if the focus is not on the cell root component
+    if (isEventTargetInPortal(event)) {
+      return;
+    }
+    if (isNavigationKey(event.key) && event.shiftKey) {
+      // The cell that has focus after the keyboard navigation
+      const focusCell = gridFocusCellSelector(apiRef);
+      if (focusCell && focusCell.id !== params.id) {
+        event.preventDefault();
+        const isNextRowSelected = apiRef.current.isRowSelected(focusCell.id);
+        if (!canHaveMultipleSelection) {
+          apiRef.current.selectRow(focusCell.id, !isNextRowSelected, true);
+          return;
+        }
+        const newRowIndex = apiRef.current.getRowIndexRelativeToVisibleRows(focusCell.id);
+        const previousRowIndex = apiRef.current.getRowIndexRelativeToVisibleRows(params.id);
+        let start;
+        let end;
+        if (newRowIndex > previousRowIndex) {
+          if (isNextRowSelected) {
+            // We are navigating to the bottom of the page and adding selected rows
+            start = previousRowIndex;
+            end = newRowIndex - 1;
+          } else {
+            // We are navigating to the bottom of the page and removing selected rows
+            start = previousRowIndex;
+            end = newRowIndex;
+          }
+        } else {
+          // eslint-disable-next-line no-lonely-if
+          if (isNextRowSelected) {
+            // We are navigating to the top of the page and removing selected rows
+            start = newRowIndex + 1;
+            end = previousRowIndex;
+          } else {
+            // We are navigating to the top of the page and adding selected rows
+            start = newRowIndex;
+            end = previousRowIndex;
+          }
+        }
+        const visibleRows = getVisibleRows(apiRef);
+        const rowsBetweenStartAndEnd = [];
+        for (let i = start; i <= end; i += 1) {
+          rowsBetweenStartAndEnd.push(visibleRows.rows[i].id);
+        }
+        apiRef.current.selectRows(rowsBetweenStartAndEnd, !isNextRowSelected);
+        return;
+      }
+    }
+    if (event.key === ' ' && event.shiftKey) {
+      event.preventDefault();
+      handleSingleRowSelection(params.id, event);
+      return;
+    }
+    if (String.fromCharCode(event.keyCode) === 'A' && (event.ctrlKey || event.metaKey)) {
+      event.preventDefault();
+      toggleAllRows(true);
+    }
+  }, [apiRef, canHaveMultipleSelection, handleSingleRowSelection, toggleAllRows]);
+  useGridApiEventHandler(apiRef, 'sortedRowsSet', runIfRowSelectionIsEnabled(() => removeOutdatedSelection(true)));
+  useGridApiEventHandler(apiRef, 'filteredRowsSet', runIfRowSelectionIsEnabled(removeOutdatedSelection));
+  useGridApiEventHandler(apiRef, 'rowClick', runIfRowSelectionIsEnabled(handleRowClick));
+  useGridApiEventHandler(apiRef, 'rowSelectionCheckboxChange', runIfRowSelectionIsEnabled(handleRowSelectionCheckboxChange));
+  useGridApiEventHandler(apiRef, 'headerSelectionCheckboxChange', handleHeaderSelectionCheckboxChange);
+  useGridApiEventHandler(apiRef, 'cellMouseDown', runIfRowSelectionIsEnabled(preventSelectionOnShift));
+  useGridApiEventHandler(apiRef, 'cellKeyDown', runIfRowSelectionIsEnabled(handleCellKeyDown));
+
+  /*
+   * EFFECTS
+   */
+  React.useEffect(() => {
+    if (propRowSelectionModel !== undefined) {
+      apiRef.current.setRowSelectionModel(propRowSelectionModel);
+    }
+  }, [apiRef, propRowSelectionModel, props.rowSelection]);
+  React.useEffect(() => {
+    if (!props.rowSelection) {
+      apiRef.current.setRowSelectionModel(emptyModel);
+    }
+  }, [apiRef, props.rowSelection]);
+  const isStateControlled = propRowSelectionModel != null;
+  React.useEffect(() => {
+    if (isStateControlled || !props.rowSelection) {
+      return;
+    }
+
+    // props.isRowSelectable changed
+    const currentSelection = gridRowSelectionStateSelector(apiRef);
+    if (typeof isRowSelectable === 'function') {
+      let selectableIds = new Set();
+      if (currentSelection.type === 'include') {
+        for (const id of currentSelection.ids) {
+          if (isRowSelectable(id)) {
+            selectableIds.add(id);
+          }
+        }
+      } else {
+        selectableIds = new Set(currentSelection.ids);
+      }
+      if (currentSelection.type === 'include' && selectableIds.size < currentSelection.ids.size) {
+        apiRef.current.setRowSelectionModel({
+          type: currentSelection.type,
+          ids: selectableIds
+        });
+      }
+    }
+  }, [apiRef, isRowSelectable, isStateControlled, props.rowSelection]);
+  React.useEffect(() => {
+    if (!props.rowSelection || isStateControlled) {
+      return;
+    }
+    const currentSelection = gridRowSelectionStateSelector(apiRef);
+    if (!canHaveMultipleSelection && (currentSelection.type === 'include' && currentSelection.ids.size > 1 || currentSelection.type === 'exclude')) {
+      // See https://github.com/mui/mui-x/issues/8455
+      apiRef.current.setRowSelectionModel(emptyModel);
+    }
+  }, [apiRef, canHaveMultipleSelection, checkboxSelection, isStateControlled, props.rowSelection]);
+  React.useEffect(() => {
+    runIfRowSelectionIsEnabled(removeOutdatedSelection);
+  }, [removeOutdatedSelection, runIfRowSelectionIsEnabled]);
+};

package/esm/hooks/features/rowSelection/useGridRowSelectionPreProcessors.d.ts

@@ -0,0 +1,4 @@
+import { RefObject } from '@mui/x-internals/types';
+import { DataGridProcessedProps } from "../../../models/props/DataGridProps.js";
+import { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
+export declare const useGridRowSelectionPreProcessors: (apiRef: RefObject<GridPrivateApiCommunity>, props: DataGridProcessedProps) => void;

package/esm/hooks/features/rowSelection/useGridRowSelectionPreProcessors.js

@@ -0,0 +1,44 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import composeClasses from '@mui/utils/composeClasses';
+import { useGridRegisterPipeProcessor } from "../../core/pipeProcessing/index.js";
+import { getDataGridUtilityClass } from "../../../constants/index.js";
+import { GRID_CHECKBOX_SELECTION_COL_DEF, GRID_CHECKBOX_SELECTION_FIELD } from "../../../colDef/index.js";
+const useUtilityClasses = ownerState => {
+  const {
+    classes
+  } = ownerState;
+  return React.useMemo(() => {
+    const slots = {
+      cellCheckbox: ['cellCheckbox'],
+      columnHeaderCheckbox: ['columnHeaderCheckbox']
+    };
+    return composeClasses(slots, getDataGridUtilityClass, classes);
+  }, [classes]);
+};
+export const useGridRowSelectionPreProcessors = (apiRef, props) => {
+  const ownerState = {
+    classes: props.classes
+  };
+  const classes = useUtilityClasses(ownerState);
+  const updateSelectionColumn = React.useCallback(columnsState => {
+    const selectionColumn = _extends({}, GRID_CHECKBOX_SELECTION_COL_DEF, {
+      cellClassName: classes.cellCheckbox,
+      headerClassName: classes.columnHeaderCheckbox,
+      headerName: apiRef.current.getLocaleText('checkboxSelectionHeaderName')
+    });
+    const shouldHaveSelectionColumn = props.checkboxSelection;
+    const haveSelectionColumn = columnsState.lookup[GRID_CHECKBOX_SELECTION_FIELD] != null;
+    if (shouldHaveSelectionColumn && !haveSelectionColumn) {
+      columnsState.lookup[GRID_CHECKBOX_SELECTION_FIELD] = selectionColumn;
+      columnsState.orderedFields = [GRID_CHECKBOX_SELECTION_FIELD, ...columnsState.orderedFields];
+    } else if (!shouldHaveSelectionColumn && haveSelectionColumn) {
+      delete columnsState.lookup[GRID_CHECKBOX_SELECTION_FIELD];
+      columnsState.orderedFields = columnsState.orderedFields.filter(field => field !== GRID_CHECKBOX_SELECTION_FIELD);
+    } else if (shouldHaveSelectionColumn && haveSelectionColumn) {
+      columnsState.lookup[GRID_CHECKBOX_SELECTION_FIELD] = _extends({}, selectionColumn, columnsState.lookup[GRID_CHECKBOX_SELECTION_FIELD]);
+    }
+    return columnsState;
+  }, [apiRef, classes, props.checkboxSelection]);
+  useGridRegisterPipeProcessor(apiRef, 'hydrateColumns', updateSelectionColumn);
+};

package/esm/hooks/features/rowSelection/utils.d.ts

@@ -0,0 +1,13 @@
+import { RefObject } from '@mui/x-internals/types';
+import type { GridRowId, GridRowTreeConfig } from '../../../models/gridRows';
+import type { DataGridProcessedProps } from '../../../models/props/DataGridProps';
+import type { GridPrivateApiCommunity } from '../../../models/api/gridApiCommunity';
+import { type GridRowSelectionPropagation } from "../../../models/gridRowSelectionModel.js";
+export declare const ROW_SELECTION_PROPAGATION_DEFAULT: GridRowSelectionPropagation;
+export declare function getCheckboxPropsSelector(groupId: GridRowId, autoSelectParents: boolean): import("../../..").OutputSelector<import("../../../models/gridStateCommunity").GridStateCommunity, import("../../../models/gridRowSelectionManager").RowSelectionManager, {
+  isIndeterminate: boolean;
+  isChecked: boolean;
+}>;
+export declare function isMultipleRowSelectionEnabled(props: Pick<DataGridProcessedProps, 'signature' | 'disableMultipleRowSelection' | 'checkboxSelection'>): boolean;
+export declare const findRowsToSelect: (apiRef: RefObject<GridPrivateApiCommunity>, tree: GridRowTreeConfig, selectedRow: GridRowId, autoSelectDescendants: boolean, autoSelectParents: boolean, addRow: (rowId: GridRowId) => void) => void;
+export declare const findRowsToDeselect: (apiRef: RefObject<GridPrivateApiCommunity>, tree: GridRowTreeConfig, deselectedRow: GridRowId, autoSelectDescendants: boolean, autoSelectParents: boolean, removeRow: (rowId: GridRowId) => void) => void;