@mui/x-data-grid 8.7.0 → 8.8.0

package/CHANGELOG.md

@@ -5,6 +5,104 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.8.0
+
+_Jul 11, 2025_
+
+We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
+
+- 📊 Chart zoom preview can be enabled
+
+  <img width="758" alt="chart with x-axis preview" src="https://github.com/user-attachments/assets/50ce6f61-16dc-4e9b-a727-ca65d80927d7" />
+
+- 🌎 Add Indonesian (id-ID) locale on the Data Grid
+
+Special thanks go out to the community members for their valuable contributions:
+@kennarddh
+
+The following are all team members who have contributed to this release:
+@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @noraleonte, @prakhargupta1, @rita-codes, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.8.0`
+
+- [DataGrid] Fix `useGridSelector` missing subscription in `React.StrictMode` (#18676) @cherniavskii
+- [DataGrid] Fix scrollbar filler `z-index` (#18688) @KenanYusuf
+- [DataGrid] Set correct data source cache chunk size when pagination is disabled (#18636) @arminmeh
+- [l10n] Add Indonesian (id-ID) locale (#18710) @kennarddh
+
+#### `@mui/x-data-grid-pro@8.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@8.8.0`, plus:
+
+- [DataGridPro] Fix row ordering not auto-scrolling when moving beyond viewport (#18557) @MBilalShafi
+- [DataGridPro] Set correct parent paths when tree is refreshed with data source tree data and row grouping (#18715) @arminmeh
+
+#### `@mui/x-data-grid-premium@8.8.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@8.8.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.8.0`
+
+Internal changes.
+
+#### `@mui/x-date-pickers-pro@8.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@8.8.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.8.0`
+
+- [charts] Add control to the axis highlight (#17900) @alexfauquette
+- [charts] Avoid processing area plot data if area isn't used in series (#18712) @bernardobelchior
+- [charts] Make smarter default domain limit (#18506) @alexfauquette
+
+#### `@mui/x-charts-pro@8.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@8.8.0`, plus:
+
+- [charts-pro] Add `funnelDirection` to control pyramid direction (#18568) @JCQuintas
+- [charts-pro] Add `onBeforeExport` callback (#18722) @bernardobelchior
+- [charts-pro] Add chart zoom preview (#18267) @bernardobelchior
+- [charts-pro] Allow customizing scatter preview marker size (#18726) @bernardobelchior
+- [charts-pro] Allow disabling the copy of styles in charts export (#18753) @bernardobelchior
+
+### Tree View
+
+#### `@mui/x-tree-view@8.8.0`
+
+- [tree view] Fix state update that caused scrolling bug when lazy loading and `checkboxSelection` are enabled (#18749) @rita-codes
+
+#### `@mui/x-tree-view-pro@8.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@8.8.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.8.0`
+
+Internal changes.
+
+### Docs
+
+- [docs] Add standalone Pyramid chart page to improve SEO (#18527) @prakhargupta1
+- [docs] Add example to customise line interaction (#18539) @alexfauquette
+- [docs] Fix `size` column filtering in files tree demo (#17952) @cherniavskii
+- [docs] Generate `llms.txt` for X and their products (#18595) @siriwatknp
+- [docs] Improve bar chart demos on mobile (#18721) @alexfauquette
+- [docs] Refine charts overview page (#17447) @noraleonte
+
+### Miscellaneous
+
+- [code-infra] Ensure all `@mui/*` packages are picked by `Material UI` renovate group (#18711) @LukasTy
+- [code-infra] Fix broken CI (#18716) @LukasTy
+- [code-infra] Refactor `prettier` config resolving (#18720) @LukasTy
+- [test] Increase data points in chart benchmarks (#18714) @bernardobelchior
+
 ## 8.7.0
 
 _Jul 4, 2025_

package/components/GridScrollArea.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { RefObject } from '@mui/x-internals/types';
 import { GridScrollParams } from "../models/params/gridScrollParams.js";
 interface ScrollAreaProps {
-  scrollDirection: 'left' | 'right';
+  scrollDirection: 'left' | 'right' | 'up' | 'down';
   scrollPosition: RefObject<GridScrollParams>;
 }
 declare function GridScrollAreaWrapper(props: ScrollAreaProps): React.JSX.Element | null;

package/components/GridScrollArea.js

@@ -1,6 +1,7 @@
 "use strict";
 'use client';
 
+/* eslint-disable @typescript-eslint/no-use-before-define */
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
@@ -13,6 +14,7 @@ var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallb
 var _composeClasses = _interopRequireDefault(require("@mui/utils/composeClasses"));
 var _system = require("@mui/system");
 var _fastMemo = require("@mui/x-internals/fastMemo");
+var _forwardRef = require("@mui/x-internals/forwardRef");
 var _useGridRootProps = require("../hooks/utils/useGridRootProps");
 var _constants = require("../constants");
 var _useGridApiContext = require("../hooks/utils/useGridApiContext");
@@ -23,6 +25,7 @@ var _densitySelector = require("../hooks/features/density/densitySelector");
 var _useTimeout = require("../hooks/utils/useTimeout");
 var _gridColumnsUtils = require("../hooks/features/columns/gridColumnsUtils");
 var _createSelector = require("../utils/createSelector");
+var _gridRowsMetaSelector = require("../hooks/features/rows/gridRowsMetaSelector");
 var _jsxRuntime = require("react/jsx-runtime");
 const CLIFF = 1;
 const SLOP = 1.5;
@@ -43,18 +46,39 @@ const GridScrollAreaRawRoot = (0, _system.styled)('div', {
     [`&.${_constants.gridClasses['scrollArea--left']}`]: styles['scrollArea--left']
   }, {
     [`&.${_constants.gridClasses['scrollArea--right']}`]: styles['scrollArea--right']
+  }, {
+    [`&.${_constants.gridClasses['scrollArea--up']}`]: styles['scrollArea--up']
+  }, {
+    [`&.${_constants.gridClasses['scrollArea--down']}`]: styles['scrollArea--down']
   }, styles.scrollArea]
 })(() => ({
   position: 'absolute',
-  top: 0,
   zIndex: 101,
-  width: 20,
-  bottom: 0,
+  // Horizontal scroll areas
   [`&.${_constants.gridClasses['scrollArea--left']}`]: {
-    left: 0
+    top: 0,
+    left: 0,
+    width: 20,
+    bottom: 0
   },
   [`&.${_constants.gridClasses['scrollArea--right']}`]: {
-    right: 0
+    top: 0,
+    right: 0,
+    width: 20,
+    bottom: 0
+  },
+  // Vertical scroll areas
+  [`&.${_constants.gridClasses['scrollArea--up']}`]: {
+    top: 0,
+    left: 0,
+    right: 0,
+    height: 20
+  },
+  [`&.${_constants.gridClasses['scrollArea--down']}`]: {
+    bottom: 0,
+    left: 0,
+    right: 0,
+    height: 20
   }
 }));
 const offsetSelector = (0, _createSelector.createSelector)(_gridDimensionsSelectors.gridDimensionsSelector, (dimensions, direction) => {
@@ -64,19 +88,27 @@ const offsetSelector = (0, _createSelector.createSelector)(_gridDimensionsSelect
   if (direction === 'right') {
     return dimensions.rightPinnedWidth + (dimensions.hasScrollX ? dimensions.scrollbarSize : 0);
   }
+  // For vertical scroll areas, we don't need horizontal offset
   return 0;
 });
 function GridScrollAreaWrapper(props) {
   const apiRef = (0, _useGridApiContext.useGridApiContext)();
-  const [dragging, setDragging] = React.useState(false);
-  (0, _useGridEvent.useGridEvent)(apiRef, 'columnHeaderDragStart', () => setDragging(true));
-  (0, _useGridEvent.useGridEvent)(apiRef, 'columnHeaderDragEnd', () => setDragging(false));
-  if (!dragging) {
+  const [dragDirection, setDragDirection] = React.useState('none');
+
+  // Listen for both column and row drag events
+  (0, _useGridEvent.useGridEvent)(apiRef, 'columnHeaderDragStart', () => setDragDirection('horizontal'));
+  (0, _useGridEvent.useGridEvent)(apiRef, 'columnHeaderDragEnd', () => setDragDirection('none'));
+  (0, _useGridEvent.useGridEvent)(apiRef, 'rowDragStart', () => setDragDirection('vertical'));
+  (0, _useGridEvent.useGridEvent)(apiRef, 'rowDragEnd', () => setDragDirection('none'));
+  if (dragDirection === 'none') {
     return null;
   }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridScrollAreaContent, (0, _extends2.default)({}, props));
+  if (dragDirection === 'horizontal') {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridHorizontalScrollAreaContent, (0, _extends2.default)({}, props));
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridVerticalScrollAreaContent, (0, _extends2.default)({}, props));
 }
-function GridScrollAreaContent(props) {
+function GridHorizontalScrollAreaContent(props) {
   const {
     scrollDirection,
     scrollPosition
@@ -100,26 +132,17 @@ function GridScrollAreaContent(props) {
     }
     return false;
   };
-  const [canScrollMore, setCanScrollMore] = React.useState(getCanScrollMore);
   const rootProps = (0, _useGridRootProps.useGridRootProps)();
-  const ownerState = (0, _extends2.default)({}, rootProps, {
-    scrollDirection
-  });
-  const classes = useUtilityClasses(ownerState);
   const totalHeaderHeight = (0, _gridColumnsUtils.getTotalHeaderHeight)(apiRef, rootProps);
   const headerHeight = Math.floor(rootProps.columnHeaderHeight * densityFactor);
-  const style = {
+  const style = (0, _extends2.default)({
     height: headerHeight,
     top: totalHeaderHeight - headerHeight
-  };
-  if (scrollDirection === 'left') {
-    style.left = sideOffset;
-  } else if (scrollDirection === 'right') {
-    style.right = sideOffset;
-  }
-  const handleScrolling = () => {
-    setCanScrollMore(getCanScrollMore);
-  };
+  }, scrollDirection === 'left' ? {
+    left: sideOffset
+  } : {}, scrollDirection === 'right' ? {
+    right: sideOffset
+  } : {});
   const handleDragOver = (0, _useEventCallback.default)(event => {
     let offset;
 
@@ -142,16 +165,99 @@ function GridScrollAreaContent(props) {
       });
     });
   });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridScrollAreaContent, (0, _extends2.default)({}, props, {
+    ref: rootRef,
+    getCanScrollMore: getCanScrollMore,
+    style: style,
+    handleDragOver: handleDragOver
+  }));
+}
+function GridVerticalScrollAreaContent(props) {
+  const {
+    scrollDirection,
+    scrollPosition
+  } = props;
+  const rootRef = React.useRef(null);
+  const apiRef = (0, _useGridApiContext.useGridApiContext)();
+  const timeout = (0, _useTimeout.useTimeout)();
+  const rowsMeta = (0, _useGridSelector.useGridSelector)(apiRef, _gridRowsMetaSelector.gridRowsMetaSelector);
+  const getCanScrollMore = () => {
+    const dimensions = (0, _gridDimensionsSelectors.gridDimensionsSelector)(apiRef);
+    if (scrollDirection === 'up') {
+      // Only render if the user has not reached yet the top of the list
+      return scrollPosition.current.top > 0;
+    }
+    if (scrollDirection === 'down') {
+      // Only render if the user has not reached yet the bottom of the list
+      const totalRowsHeight = rowsMeta.currentPageTotalHeight || 0;
+      const maxScrollTop = totalRowsHeight - dimensions.viewportInnerSize.height - dimensions.scrollbarSize;
+      return scrollPosition.current.top < maxScrollTop;
+    }
+    return false;
+  };
+  const rootProps = (0, _useGridRootProps.useGridRootProps)();
+  const totalHeaderHeight = (0, _gridColumnsUtils.getTotalHeaderHeight)(apiRef, rootProps);
+  const style = {
+    top: scrollDirection === 'up' ? totalHeaderHeight : undefined,
+    bottom: scrollDirection === 'down' ? 0 : undefined
+  };
+  const handleDragOver = (0, _useEventCallback.default)(event => {
+    let offset;
+
+    // Prevents showing the forbidden cursor
+    event.preventDefault();
+    if (scrollDirection === 'up') {
+      offset = event.clientY - rootRef.current.getBoundingClientRect().bottom;
+    } else if (scrollDirection === 'down') {
+      offset = Math.max(1, event.clientY - rootRef.current.getBoundingClientRect().top);
+    } else {
+      throw new Error('MUI X: Wrong drag direction');
+    }
+    offset = (offset - CLIFF) * SLOP + CLIFF;
+
+    // Avoid freeze and inertia.
+    timeout.start(0, () => {
+      apiRef.current.scroll({
+        left: scrollPosition.current.left,
+        top: scrollPosition.current.top + offset
+      });
+    });
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridScrollAreaContent, (0, _extends2.default)({}, props, {
+    ref: rootRef,
+    getCanScrollMore: getCanScrollMore,
+    style: style,
+    handleDragOver: handleDragOver
+  }));
+}
+const GridScrollAreaContent = (0, _forwardRef.forwardRef)(function GridScrollAreaContent(props, ref) {
+  const {
+    scrollDirection,
+    getCanScrollMore,
+    style,
+    handleDragOver
+  } = props;
+  const apiRef = (0, _useGridApiContext.useGridApiContext)();
+  const [canScrollMore, setCanScrollMore] = React.useState(getCanScrollMore);
+  const rootProps = (0, _useGridRootProps.useGridRootProps)();
+  const ownerState = (0, _extends2.default)({}, rootProps, {
+    scrollDirection
+  });
+  const classes = useUtilityClasses(ownerState);
+  const handleScrolling = () => {
+    setCanScrollMore(getCanScrollMore);
+  };
   (0, _useGridEvent.useGridEvent)(apiRef, 'scrollPositionChange', handleScrolling);
   if (!canScrollMore) {
     return null;
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(GridScrollAreaRawRoot, {
-    ref: rootRef,
+    ref: ref,
     className: classes.root,
     ownerState: ownerState,
     onDragOver: handleDragOver,
     style: style
   });
-}
+});
+if (process.env.NODE_ENV !== "production") GridScrollAreaContent.displayName = "GridScrollAreaContent";
 const GridScrollArea = exports.GridScrollArea = (0, _fastMemo.fastMemo)(GridScrollAreaWrapper);

package/components/containers/GridRootStyles.js

@@ -842,6 +842,8 @@ const GridRootStyles = exports.GridRootStyles = (0, _styles.styled)('div', {
       [`&.${_gridClasses.gridClasses['scrollbarFiller--pinnedRight']}`]: {
         backgroundColor: _cssVariables.vars.cell.background.pinned,
         position: 'sticky',
+        zIndex: 40,
+        // Should be above the column separator
         right: 0
       }
     },

package/components/virtualization/GridVirtualScroller.js

@@ -105,6 +105,10 @@ function GridVirtualScroller(props) {
       scrollDirection: "left"
     }, getScrollAreaProps())), /*#__PURE__*/(0, _jsxRuntime.jsx)(_GridScrollArea.GridScrollArea, (0, _extends2.default)({
       scrollDirection: "right"
+    }, getScrollAreaProps())), /*#__PURE__*/(0, _jsxRuntime.jsx)(_GridScrollArea.GridScrollArea, (0, _extends2.default)({
+      scrollDirection: "up"
+    }, getScrollAreaProps())), /*#__PURE__*/(0, _jsxRuntime.jsx)(_GridScrollArea.GridScrollArea, (0, _extends2.default)({
+      scrollDirection: "down"
     }, getScrollAreaProps())), /*#__PURE__*/(0, _jsxRuntime.jsxs)(Scroller, (0, _extends2.default)({
       className: classes.scroller
     }, getScrollerProps(), {

package/constants/gridClasses.d.ts

@@ -639,6 +639,14 @@ export interface GridClasses {
    * Styles applied to the right scroll area element.
    */
   'scrollArea--right': string;
+  /**
+   * Styles applied to the top scroll area element.
+   */
+  'scrollArea--up': string;
+  /**
+   * Styles applied to the bottom scroll area element.
+   */
+  'scrollArea--down': string;
   /**
    * Styles applied to the scrollbars.
    */

package/constants/gridClasses.js

@@ -11,4 +11,4 @@ var _generateUtilityClasses = _interopRequireDefault(require("@mui/utils/generat
 function getDataGridUtilityClass(slot) {
   return (0, _generateUtilityClass.default)('MuiDataGrid', slot);
 }
-const gridClasses = exports.gridClasses = (0, _generateUtilityClasses.default)('MuiDataGrid', ['aiAssistantPanel', 'aiAssistantPanelHeader', 'aiAssistantPanelTitleContainer', 'aiAssistantPanelTitle', 'aiAssistantPanelBody', 'aiAssistantPanelEmptyText', 'aiAssistantPanelFooter', 'aiAssistantPanelConversation', 'aiAssistantPanelConversationList', 'aiAssistantPanelConversationTitle', 'aiAssistantPanelSuggestions', 'aiAssistantPanelSuggestionsList', 'aiAssistantPanelSuggestionsItem', 'aiAssistantPanelSuggestionsLabel', 'actionsCell', 'aggregationColumnHeader', 'aggregationColumnHeader--alignLeft', 'aggregationColumnHeader--alignCenter', 'aggregationColumnHeader--alignRight', 'aggregationColumnHeaderLabel', 'aggregationRowOverlayWrapper', 'autoHeight', 'autosizing', 'mainContent', 'withSidePanel', 'booleanCell', 'cell--editable', 'cell--editing', 'cell--flex', 'cell--textCenter', 'cell--textLeft', 'cell--textRight', 'cell--rangeTop', 'cell--rangeBottom', 'cell--rangeLeft', 'cell--rangeRight', 'cell--pinnedLeft', 'cell--pinnedRight', 'cell--selectionMode', 'cell', 'cellCheckbox', 'cellEmpty', 'cellSkeleton', 'cellOffsetLeft', 'checkboxInput', 'collapsible', 'collapsibleTrigger', 'collapsibleIcon', 'collapsiblePanel', 'columnHeader', 'columnHeader--alignCenter', 'columnHeader--alignLeft', 'columnHeader--alignRight', 'columnHeader--dragging', 'columnHeader--moving', 'columnHeader--numeric', 'columnHeader--sortable', 'columnHeader--sorted', 'columnHeader--filtered', 'columnHeader--pinnedLeft', 'columnHeader--pinnedRight', 'columnHeader--last', 'columnHeader--lastUnpinned', 'columnHeader--siblingFocused', 'columnHeader--filter', 'columnHeaderFilterInput', 'columnHeaderFilterOperatorLabel', 'columnHeaderCheckbox', 'columnHeaderDraggableContainer', 'columnHeaderTitle', 'columnHeaderTitleContainer', 'columnHeaderTitleContainerContent', 'columnHeader--filledGroup', 'columnHeader--emptyGroup', 'columnHeaders', 'columnSeparator--resizable', 'columnSeparator--resizing', 'columnSeparator--sideLeft', 'columnSeparator--sideRight', 'columnSeparator', 'columnsManagement', 'columnsManagementRow', 'columnsManagementHeader', 'columnsManagementSearchInput', 'columnsManagementFooter', 'columnsManagementScrollArea', 'columnsManagementEmptyText', 'container--top', 'container--bottom', 'detailPanel', 'detailPanelToggleCell', 'detailPanelToggleCell--expanded', 'footerCell', 'panel', 'panelHeader', 'panelWrapper', 'panelContent', 'panelFooter', 'paper', 'editBooleanCell', 'editInputCell', 'filler', 'filler--borderBottom', 'filler--pinnedLeft', 'filler--pinnedRight', 'filterForm', 'filterFormDeleteIcon', 'filterFormLogicOperatorInput', 'filterFormColumnInput', 'filterFormOperatorInput', 'filterFormValueInput', 'filterIcon', 'footerContainer', 'headerFilterRow', 'iconButtonContainer', 'iconSeparator', 'main', 'main--hasPinnedRight', 'main--hiddenContent', 'menu', 'menuIcon', 'menuIconButton', 'menuOpen', 'menuList', 'overlay', 'overlayWrapper', 'overlayWrapperInner', 'root', 'root--densityStandard', 'root--densityComfortable', 'root--densityCompact', 'root--disableUserSelection', 'root--noToolbar', 'row', 'row--editable', 'row--editing', 'row--firstVisible', 'row--lastVisible', 'row--dragging', 'row--dynamicHeight', 'row--detailPanelExpanded', 'row--borderBottom', 'rowReorderCellPlaceholder', 'rowCount', 'rowReorderCellContainer', 'rowReorderCell', 'rowReorderCell--draggable', 'rowReorderIcon', 'rowSkeleton', 'scrollArea--left', 'scrollArea--right', 'scrollArea', 'scrollbar', 'scrollbar--vertical', 'scrollbar--horizontal', 'scrollbarFiller', 'scrollbarFiller--header', 'scrollbarFiller--borderTop', 'scrollbarFiller--borderBottom', 'scrollbarFiller--pinnedRight', 'selectedRowCount', 'sortButton', 'sortIcon', 'shadowScrollArea', 'sidebar', 'sidebarHeader', 'toolbarContainer', 'toolbar', 'toolbarLabel', 'toolbarDivider', 'toolbarFilterList', 'toolbarQuickFilter', 'toolbarQuickFilterTrigger', 'toolbarQuickFilterControl', 'virtualScroller', 'virtualScroller--hasScrollX', 'virtualScrollerContent', 'virtualScrollerContent--overflowed', 'virtualScrollerRenderZone', 'withVerticalBorder', 'withBorderColor', 'cell--withRightBorder', 'cell--withLeftBorder', 'columnHeader--withRightBorder', 'columnHeader--withLeftBorder', 'treeDataGroupingCell', 'treeDataGroupingCellToggle', 'treeDataGroupingCellLoadingContainer', 'groupingCriteriaCell', 'groupingCriteriaCellToggle', 'groupingCriteriaCellLoadingContainer', 'pinnedRows', 'pinnedRows--top', 'pinnedRows--bottom', 'pivotPanelAvailableFields', 'pivotPanelField', 'pivotPanelField--sorted', 'pivotPanelFieldActionContainer', 'pivotPanelFieldCheckbox', 'pivotPanelFieldDragIcon', 'pivotPanelFieldList', 'pivotPanelFieldName', 'pivotPanelHeader', 'pivotPanelPlaceholder', 'pivotPanelScrollArea', 'pivotPanelSearchContainer', 'pivotPanelSection', 'pivotPanelSectionTitle', 'pivotPanelSections', 'pivotPanelSwitch', 'pivotPanelSwitchLabel', 'prompt', 'promptContent', 'promptText', 'promptFeedback', 'promptChangeList', 'promptChangesToggle', 'promptChangesToggleIcon', 'promptIcon', 'promptIconContainer', 'promptError', 'promptAction']);
+const gridClasses = exports.gridClasses = (0, _generateUtilityClasses.default)('MuiDataGrid', ['aiAssistantPanel', 'aiAssistantPanelHeader', 'aiAssistantPanelTitleContainer', 'aiAssistantPanelTitle', 'aiAssistantPanelBody', 'aiAssistantPanelEmptyText', 'aiAssistantPanelFooter', 'aiAssistantPanelConversation', 'aiAssistantPanelConversationList', 'aiAssistantPanelConversationTitle', 'aiAssistantPanelSuggestions', 'aiAssistantPanelSuggestionsList', 'aiAssistantPanelSuggestionsItem', 'aiAssistantPanelSuggestionsLabel', 'actionsCell', 'aggregationColumnHeader', 'aggregationColumnHeader--alignLeft', 'aggregationColumnHeader--alignCenter', 'aggregationColumnHeader--alignRight', 'aggregationColumnHeaderLabel', 'aggregationRowOverlayWrapper', 'autoHeight', 'autosizing', 'mainContent', 'withSidePanel', 'booleanCell', 'cell--editable', 'cell--editing', 'cell--flex', 'cell--textCenter', 'cell--textLeft', 'cell--textRight', 'cell--rangeTop', 'cell--rangeBottom', 'cell--rangeLeft', 'cell--rangeRight', 'cell--pinnedLeft', 'cell--pinnedRight', 'cell--selectionMode', 'cell', 'cellCheckbox', 'cellEmpty', 'cellSkeleton', 'cellOffsetLeft', 'checkboxInput', 'collapsible', 'collapsibleTrigger', 'collapsibleIcon', 'collapsiblePanel', 'columnHeader', 'columnHeader--alignCenter', 'columnHeader--alignLeft', 'columnHeader--alignRight', 'columnHeader--dragging', 'columnHeader--moving', 'columnHeader--numeric', 'columnHeader--sortable', 'columnHeader--sorted', 'columnHeader--filtered', 'columnHeader--pinnedLeft', 'columnHeader--pinnedRight', 'columnHeader--last', 'columnHeader--lastUnpinned', 'columnHeader--siblingFocused', 'columnHeader--filter', 'columnHeaderFilterInput', 'columnHeaderFilterOperatorLabel', 'columnHeaderCheckbox', 'columnHeaderDraggableContainer', 'columnHeaderTitle', 'columnHeaderTitleContainer', 'columnHeaderTitleContainerContent', 'columnHeader--filledGroup', 'columnHeader--emptyGroup', 'columnHeaders', 'columnSeparator--resizable', 'columnSeparator--resizing', 'columnSeparator--sideLeft', 'columnSeparator--sideRight', 'columnSeparator', 'columnsManagement', 'columnsManagementRow', 'columnsManagementHeader', 'columnsManagementSearchInput', 'columnsManagementFooter', 'columnsManagementScrollArea', 'columnsManagementEmptyText', 'container--top', 'container--bottom', 'detailPanel', 'detailPanelToggleCell', 'detailPanelToggleCell--expanded', 'footerCell', 'panel', 'panelHeader', 'panelWrapper', 'panelContent', 'panelFooter', 'paper', 'editBooleanCell', 'editInputCell', 'filler', 'filler--borderBottom', 'filler--pinnedLeft', 'filler--pinnedRight', 'filterForm', 'filterFormDeleteIcon', 'filterFormLogicOperatorInput', 'filterFormColumnInput', 'filterFormOperatorInput', 'filterFormValueInput', 'filterIcon', 'footerContainer', 'headerFilterRow', 'iconButtonContainer', 'iconSeparator', 'main', 'main--hasPinnedRight', 'main--hiddenContent', 'menu', 'menuIcon', 'menuIconButton', 'menuOpen', 'menuList', 'overlay', 'overlayWrapper', 'overlayWrapperInner', 'root', 'root--densityStandard', 'root--densityComfortable', 'root--densityCompact', 'root--disableUserSelection', 'root--noToolbar', 'row', 'row--editable', 'row--editing', 'row--firstVisible', 'row--lastVisible', 'row--dragging', 'row--dynamicHeight', 'row--detailPanelExpanded', 'row--borderBottom', 'rowReorderCellPlaceholder', 'rowCount', 'rowReorderCellContainer', 'rowReorderCell', 'rowReorderCell--draggable', 'rowReorderIcon', 'rowSkeleton', 'scrollArea--left', 'scrollArea--right', 'scrollArea--up', 'scrollArea--down', 'scrollArea', 'scrollbar', 'scrollbar--vertical', 'scrollbar--horizontal', 'scrollbarFiller', 'scrollbarFiller--header', 'scrollbarFiller--borderTop', 'scrollbarFiller--borderBottom', 'scrollbarFiller--pinnedRight', 'selectedRowCount', 'sortButton', 'sortIcon', 'shadowScrollArea', 'sidebar', 'sidebarHeader', 'toolbarContainer', 'toolbar', 'toolbarLabel', 'toolbarDivider', 'toolbarFilterList', 'toolbarQuickFilter', 'toolbarQuickFilterTrigger', 'toolbarQuickFilterControl', 'virtualScroller', 'virtualScroller--hasScrollX', 'virtualScrollerContent', 'virtualScrollerContent--overflowed', 'virtualScrollerRenderZone', 'withVerticalBorder', 'withBorderColor', 'cell--withRightBorder', 'cell--withLeftBorder', 'columnHeader--withRightBorder', 'columnHeader--withLeftBorder', 'treeDataGroupingCell', 'treeDataGroupingCellToggle', 'treeDataGroupingCellLoadingContainer', 'groupingCriteriaCell', 'groupingCriteriaCellToggle', 'groupingCriteriaCellLoadingContainer', 'pinnedRows', 'pinnedRows--top', 'pinnedRows--bottom', 'pivotPanelAvailableFields', 'pivotPanelField', 'pivotPanelField--sorted', 'pivotPanelFieldActionContainer', 'pivotPanelFieldCheckbox', 'pivotPanelFieldDragIcon', 'pivotPanelFieldList', 'pivotPanelFieldName', 'pivotPanelHeader', 'pivotPanelPlaceholder', 'pivotPanelScrollArea', 'pivotPanelSearchContainer', 'pivotPanelSection', 'pivotPanelSectionTitle', 'pivotPanelSections', 'pivotPanelSwitch', 'pivotPanelSwitchLabel', 'prompt', 'promptContent', 'promptText', 'promptFeedback', 'promptChangeList', 'promptChangesToggle', 'promptChangesToggleIcon', 'promptIcon', 'promptIconContainer', 'promptError', 'promptAction']);

package/esm/components/GridScrollArea.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { RefObject } from '@mui/x-internals/types';
 import { GridScrollParams } from "../models/params/gridScrollParams.js";
 interface ScrollAreaProps {
-  scrollDirection: 'left' | 'right';
+  scrollDirection: 'left' | 'right' | 'up' | 'down';
   scrollPosition: RefObject<GridScrollParams>;
 }
 declare function GridScrollAreaWrapper(props: ScrollAreaProps): React.JSX.Element | null;

package/esm/components/GridScrollArea.js

@@ -1,11 +1,13 @@
 'use client';
 
+/* eslint-disable @typescript-eslint/no-use-before-define */
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import useEventCallback from '@mui/utils/useEventCallback';
 import composeClasses from '@mui/utils/composeClasses';
 import { styled } from '@mui/system';
 import { fastMemo } from '@mui/x-internals/fastMemo';
+import { forwardRef } from '@mui/x-internals/forwardRef';
 import { useGridRootProps } from "../hooks/utils/useGridRootProps.js";
 import { getDataGridUtilityClass, gridClasses } from "../constants/index.js";
 import { useGridApiContext } from "../hooks/utils/useGridApiContext.js";
@@ -16,6 +18,7 @@ import { gridDensityFactorSelector } from "../hooks/features/density/densitySele
 import { useTimeout } from "../hooks/utils/useTimeout.js";
 import { getTotalHeaderHeight } from "../hooks/features/columns/gridColumnsUtils.js";
 import { createSelector } from "../utils/createSelector.js";
+import { gridRowsMetaSelector } from "../hooks/features/rows/gridRowsMetaSelector.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const CLIFF = 1;
 const SLOP = 1.5;
@@ -36,18 +39,39 @@ const GridScrollAreaRawRoot = styled('div', {
     [`&.${gridClasses['scrollArea--left']}`]: styles['scrollArea--left']
   }, {
     [`&.${gridClasses['scrollArea--right']}`]: styles['scrollArea--right']
+  }, {
+    [`&.${gridClasses['scrollArea--up']}`]: styles['scrollArea--up']
+  }, {
+    [`&.${gridClasses['scrollArea--down']}`]: styles['scrollArea--down']
   }, styles.scrollArea]
 })(() => ({
   position: 'absolute',
-  top: 0,
   zIndex: 101,
-  width: 20,
-  bottom: 0,
+  // Horizontal scroll areas
   [`&.${gridClasses['scrollArea--left']}`]: {
-    left: 0
+    top: 0,
+    left: 0,
+    width: 20,
+    bottom: 0
   },
   [`&.${gridClasses['scrollArea--right']}`]: {
-    right: 0
+    top: 0,
+    right: 0,
+    width: 20,
+    bottom: 0
+  },
+  // Vertical scroll areas
+  [`&.${gridClasses['scrollArea--up']}`]: {
+    top: 0,
+    left: 0,
+    right: 0,
+    height: 20
+  },
+  [`&.${gridClasses['scrollArea--down']}`]: {
+    bottom: 0,
+    left: 0,
+    right: 0,
+    height: 20
   }
 }));
 const offsetSelector = createSelector(gridDimensionsSelector, (dimensions, direction) => {
@@ -57,19 +81,27 @@ const offsetSelector = createSelector(gridDimensionsSelector, (dimensions, direc
   if (direction === 'right') {
     return dimensions.rightPinnedWidth + (dimensions.hasScrollX ? dimensions.scrollbarSize : 0);
   }
+  // For vertical scroll areas, we don't need horizontal offset
   return 0;
 });
 function GridScrollAreaWrapper(props) {
   const apiRef = useGridApiContext();
-  const [dragging, setDragging] = React.useState(false);
-  useGridEvent(apiRef, 'columnHeaderDragStart', () => setDragging(true));
-  useGridEvent(apiRef, 'columnHeaderDragEnd', () => setDragging(false));
-  if (!dragging) {
+  const [dragDirection, setDragDirection] = React.useState('none');
+
+  // Listen for both column and row drag events
+  useGridEvent(apiRef, 'columnHeaderDragStart', () => setDragDirection('horizontal'));
+  useGridEvent(apiRef, 'columnHeaderDragEnd', () => setDragDirection('none'));
+  useGridEvent(apiRef, 'rowDragStart', () => setDragDirection('vertical'));
+  useGridEvent(apiRef, 'rowDragEnd', () => setDragDirection('none'));
+  if (dragDirection === 'none') {
     return null;
   }
-  return /*#__PURE__*/_jsx(GridScrollAreaContent, _extends({}, props));
+  if (dragDirection === 'horizontal') {
+    return /*#__PURE__*/_jsx(GridHorizontalScrollAreaContent, _extends({}, props));
+  }
+  return /*#__PURE__*/_jsx(GridVerticalScrollAreaContent, _extends({}, props));
 }
-function GridScrollAreaContent(props) {
+function GridHorizontalScrollAreaContent(props) {
   const {
     scrollDirection,
     scrollPosition
@@ -93,26 +125,17 @@ function GridScrollAreaContent(props) {
     }
     return false;
   };
-  const [canScrollMore, setCanScrollMore] = React.useState(getCanScrollMore);
   const rootProps = useGridRootProps();
-  const ownerState = _extends({}, rootProps, {
-    scrollDirection
-  });
-  const classes = useUtilityClasses(ownerState);
   const totalHeaderHeight = getTotalHeaderHeight(apiRef, rootProps);
   const headerHeight = Math.floor(rootProps.columnHeaderHeight * densityFactor);
-  const style = {
+  const style = _extends({
     height: headerHeight,
     top: totalHeaderHeight - headerHeight
-  };
-  if (scrollDirection === 'left') {
-    style.left = sideOffset;
-  } else if (scrollDirection === 'right') {
-    style.right = sideOffset;
-  }
-  const handleScrolling = () => {
-    setCanScrollMore(getCanScrollMore);
-  };
+  }, scrollDirection === 'left' ? {
+    left: sideOffset
+  } : {}, scrollDirection === 'right' ? {
+    right: sideOffset
+  } : {});
   const handleDragOver = useEventCallback(event => {
     let offset;
 
@@ -135,16 +158,99 @@ function GridScrollAreaContent(props) {
       });
     });
   });
+  return /*#__PURE__*/_jsx(GridScrollAreaContent, _extends({}, props, {
+    ref: rootRef,
+    getCanScrollMore: getCanScrollMore,
+    style: style,
+    handleDragOver: handleDragOver
+  }));
+}
+function GridVerticalScrollAreaContent(props) {
+  const {
+    scrollDirection,
+    scrollPosition
+  } = props;
+  const rootRef = React.useRef(null);
+  const apiRef = useGridApiContext();
+  const timeout = useTimeout();
+  const rowsMeta = useGridSelector(apiRef, gridRowsMetaSelector);
+  const getCanScrollMore = () => {
+    const dimensions = gridDimensionsSelector(apiRef);
+    if (scrollDirection === 'up') {
+      // Only render if the user has not reached yet the top of the list
+      return scrollPosition.current.top > 0;
+    }
+    if (scrollDirection === 'down') {
+      // Only render if the user has not reached yet the bottom of the list
+      const totalRowsHeight = rowsMeta.currentPageTotalHeight || 0;
+      const maxScrollTop = totalRowsHeight - dimensions.viewportInnerSize.height - dimensions.scrollbarSize;
+      return scrollPosition.current.top < maxScrollTop;
+    }
+    return false;
+  };
+  const rootProps = useGridRootProps();
+  const totalHeaderHeight = getTotalHeaderHeight(apiRef, rootProps);
+  const style = {
+    top: scrollDirection === 'up' ? totalHeaderHeight : undefined,
+    bottom: scrollDirection === 'down' ? 0 : undefined
+  };
+  const handleDragOver = useEventCallback(event => {
+    let offset;
+
+    // Prevents showing the forbidden cursor
+    event.preventDefault();
+    if (scrollDirection === 'up') {
+      offset = event.clientY - rootRef.current.getBoundingClientRect().bottom;
+    } else if (scrollDirection === 'down') {
+      offset = Math.max(1, event.clientY - rootRef.current.getBoundingClientRect().top);
+    } else {
+      throw new Error('MUI X: Wrong drag direction');
+    }
+    offset = (offset - CLIFF) * SLOP + CLIFF;
+
+    // Avoid freeze and inertia.
+    timeout.start(0, () => {
+      apiRef.current.scroll({
+        left: scrollPosition.current.left,
+        top: scrollPosition.current.top + offset
+      });
+    });
+  });
+  return /*#__PURE__*/_jsx(GridScrollAreaContent, _extends({}, props, {
+    ref: rootRef,
+    getCanScrollMore: getCanScrollMore,
+    style: style,
+    handleDragOver: handleDragOver
+  }));
+}
+const GridScrollAreaContent = forwardRef(function GridScrollAreaContent(props, ref) {
+  const {
+    scrollDirection,
+    getCanScrollMore,
+    style,
+    handleDragOver
+  } = props;
+  const apiRef = useGridApiContext();
+  const [canScrollMore, setCanScrollMore] = React.useState(getCanScrollMore);
+  const rootProps = useGridRootProps();
+  const ownerState = _extends({}, rootProps, {
+    scrollDirection
+  });
+  const classes = useUtilityClasses(ownerState);
+  const handleScrolling = () => {
+    setCanScrollMore(getCanScrollMore);
+  };
   useGridEvent(apiRef, 'scrollPositionChange', handleScrolling);
   if (!canScrollMore) {
     return null;
   }
   return /*#__PURE__*/_jsx(GridScrollAreaRawRoot, {
-    ref: rootRef,
+    ref: ref,
     className: classes.root,
     ownerState: ownerState,
     onDragOver: handleDragOver,
     style: style
   });
-}
+});
+if (process.env.NODE_ENV !== "production") GridScrollAreaContent.displayName = "GridScrollAreaContent";
 export const GridScrollArea = fastMemo(GridScrollAreaWrapper);