@mui/x-virtualizer 1.0.0-beta.0 → 1.0.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,111 @@
 # Changelog
 
+## 9.0.0-beta.0
+
+<!-- generated comparing v9.0.0-alpha.4..master -->
+
+_Mar 27, 2026_
+
+We'd like to extend a big thank you to the 10 contributors who made this release possible. Here are some highlights ✨:
+
+- 🔊 New Charts voiceover component for improved screen reader support
+- ⌨️ Charts keyboard navigation improvements: axis tooltip now shows when navigating with the keyboard
+- 📊 Charts axes now can be set to automatically resize to fit their content
+- 📝 New `rowCheckbox` slot in Data Grid for easier checkbox column customization
+- ⚡️ `fetchRows()` API in Data Grid Pro now defaults `start` and `end` based on scroll position with lazy loading
+- 🐞 Bugfixes and internal improvements
+
+The following team members contributed to this release:
+@aemartos, @alexfauquette, @arminmeh, @cherniavskii, @Janpot, @JCQuintas, @mapache-salvaje, @michelengelen, @noraleonte, @rita-codes
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.0.0-beta.0`
+
+- [DataGrid] Add `rowCheckbox` slot for easier customization (#21797) @michelengelen
+- [DataGrid] Prevent repeated `hasScrollbar` state updates (#21820) @arminmeh
+
+#### `@mui/x-data-grid-pro@9.0.0-beta.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@9.0.0-beta.0`, plus:
+
+- [DataGridPro] `fetchRows()` API's default `start` and `end` params based on scroll position with lazy loading (#21742) @arminmeh
+
+#### `@mui/x-data-grid-premium@9.0.0-beta.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@9.0.0-beta.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.0.0-beta.0`
+
+Internal changes.
+
+#### `@mui/x-date-pickers-pro@9.0.0-beta.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@9.0.0-beta.0`.
+
+### Charts
+
+#### `@mui/x-charts@9.0.0-beta.0`
+
+- [charts] Add `className` prop to Pro chart plot components (#21793) @JCQuintas
+- [charts] Add experimental position-based pointer interaction for line series (#21809) @JCQuintas
+- [charts] Add l10n to the bar accessibility (#21815) @alexfauquette
+- [charts] Add localization for the basic charts (#21822) @alexfauquette
+- [charts] Add voiceover component (#21344) @alexfauquette
+- [charts] Allow axes to automatically resize to content (#21087) @JCQuintas
+- [charts] Document multiple use-cases for references (#21768) @alexfauquette
+- [charts] Remove compatibility layer for React vs native events (#21780) @JCQuintas
+- [charts] Remove deprecated `barLabel` props (#21783) @alexfauquette
+- [charts] Show axis tooltip when navigating with keyboard (#21689) @Copilot
+
+#### `@mui/x-charts-pro@9.0.0-beta.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@9.0.0-beta.0`.
+
+#### `@mui/x-charts-premium@9.0.0-beta.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-charts-pro@9.0.0-beta.0`.
+
+### Tree View
+
+#### `@mui/x-tree-view@9.0.0-alpha.4`
+
+Internal changes.
+
+#### `@mui/x-tree-view-pro@9.0.0-alpha.4` [![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@9.0.0-alpha.4`.
+
+### Codemod
+
+#### `@mui/x-codemod@9.0.0-alpha.4`
+
+Internal changes.
+
+### Docs
+
+- [docs] Document how to customize voiceover announcement (#21833) @alexfauquette
+- [docs] Remove Discord mention from docs (#21855) @mapache-salvaje
+- [docs] Remove stabilized experimental feature from demo (#21869) @JCQuintas
+- [docs] Update telemetry guide to reflect pseudonymous data collection and license compliance (#21812) @aemartos
+- [docs] Revise the Sparkline doc (#21614) @mapache-salvaje
+- [docs] Revise the Gauge doc (#21673) @mapache-salvaje
+- [docs] Revise the Heatmap doc (#21676) @mapache-salvaje
+
+### Core
+
+- [code-infra] Remove unused deps and unify es-toolkit via catalog (#21840) @Janpot
+- [code-infra] Update @mui/internal-bundle-size-checker to canary.68 (#21836) @Janpot
+- [code-infra] Update next (#21837) @Janpot
+- [internal] Remove headless data grid packages (#21843) @cherniavskii
+
+### Miscellaneous
+
+- Add @romgrk to CODEOWNERS for `x-virtualizer` and `x-internals` (#21819) @Copilot
+- [x-license] add 2022 plan version (#21814) @aemartos
+
 ## 9.0.0-alpha.4
 
 _Mar 19, 2026_
@@ -59,7 +165,7 @@ Same changes as in `@mui/x-date-pickers@9.0.0-alpha.4`.
 - [charts] Remove deprecated `useMouseTracker()` (#21787) @alexfauquette
 - [charts] Remove deprecated classes (#21775) @alexfauquette
 - [charts] Remove deprecated props from PieArcLabel animation (#21789) @alexfauquette
-- [charts] Remove get*UtilityClass from public exports (#21769) @JCQuintas
+- [charts] Remove get\*UtilityClass from public exports (#21769) @JCQuintas
 - [charts] Remove the deprecated `disableHover` property (#21785) @alexfauquette
 - [charts] Remove the deprecated `message` prop (#21784) @alexfauquette
 - [charts] Remove deprecated props about voronoi (#21796) @alexfauquette

package/features/dimensions.js

@@ -97,6 +97,21 @@ function initializeState(params) {
 }
 function useDimensions(store, params, _api) {
   const isFirstSizing = React.useRef(true);
+
+  // Vertical scrollbar oscillation detector.
+  // Counts consecutive hasScrollY flips that happen with no row-height change.
+  // After 2 flips it is certainly a layout feedback loop, so every further flip
+  // is forced to false (no scrollbar). The counter resets when row heights change.
+  // Only vertical scrollbar can oscillate because column widths are never 'auto'.
+  // https://github.com/mui/mui-x/issues/20539
+  const scrollYOscillation = React.useRef({
+    counter: 0,
+    heights: {
+      content: 0,
+      pinnedTop: 0,
+      pinnedBottom: 0
+    }
+  });
   const {
     layout,
     dimensions: {
@@ -130,6 +145,7 @@ function useDimensions(store, params, _api) {
       width: columnsTotalWidth,
       height: (0, _math.roundToDecimalPlaces)(rowsMeta.currentPageTotalHeight, 1)
     };
+    const prevDimensions = store.state.dimensions;
     let viewportOuterSize;
     let viewportInnerSize;
     let hasScrollX = false;
@@ -167,6 +183,36 @@ function useDimensions(store, params, _api) {
           hasScrollY = content.height + scrollbarSize > container.height;
         }
       }
+
+      // Detect vertical scrollbar oscillation.
+      // Track consecutive hasScrollY flips with no row-height change.
+      // Once confirmed (≥ 2 flips), force hasScrollY off — the scrollbar is
+      // not genuinely needed, it is a layout feedback loop caused by stale
+      // rootSize or the horizontal scrollbar's height cascading.
+      {
+        const osc = scrollYOscillation.current;
+        const heightsChanged = rowsMeta.currentPageTotalHeight !== osc.heights.content || rowsMeta.pinnedTopRowsTotalHeight !== osc.heights.pinnedTop || rowsMeta.pinnedBottomRowsTotalHeight !== osc.heights.pinnedBottom;
+        if (heightsChanged) {
+          osc.counter = 0;
+          osc.heights = {
+            content: rowsMeta.currentPageTotalHeight,
+            pinnedTop: rowsMeta.pinnedTopRowsTotalHeight,
+            pinnedBottom: rowsMeta.pinnedBottomRowsTotalHeight
+          };
+        }
+        if (prevDimensions.isReady && hasScrollY !== prevDimensions.hasScrollY) {
+          if (!heightsChanged) {
+            osc.counter += 1;
+          }
+          if (osc.counter >= 2) {
+            hasScrollY = false;
+            // Recompute hasScrollX without the vertical scrollbar's width impact,
+            // otherwise the cascade (hasScrollY → narrower viewport → hasScrollX)
+            // keeps the horizontal scrollbar/filler alive and the root keeps resizing.
+            hasScrollX = hasScrollXIfNoYScrollBar;
+          }
+        }
+      }
       if (hasScrollY) {
         viewportInnerSize.width -= scrollbarSize;
       }
@@ -205,7 +251,6 @@ function useDimensions(store, params, _api) {
       autoHeight: params.dimensions.autoHeight,
       minimalContentHeight: params.dimensions.minimalContentHeight
     };
-    const prevDimensions = store.state.dimensions;
     if ((0, _isDeepEqual.isDeepEqual)(prevDimensions, newDimensions)) {
       return;
     }

package/features/dimensions.mjs

@@ -90,6 +90,21 @@ function initializeState(params) {
 }
 function useDimensions(store, params, _api) {
   const isFirstSizing = React.useRef(true);
+
+  // Vertical scrollbar oscillation detector.
+  // Counts consecutive hasScrollY flips that happen with no row-height change.
+  // After 2 flips it is certainly a layout feedback loop, so every further flip
+  // is forced to false (no scrollbar). The counter resets when row heights change.
+  // Only vertical scrollbar can oscillate because column widths are never 'auto'.
+  // https://github.com/mui/mui-x/issues/20539
+  const scrollYOscillation = React.useRef({
+    counter: 0,
+    heights: {
+      content: 0,
+      pinnedTop: 0,
+      pinnedBottom: 0
+    }
+  });
   const {
     layout,
     dimensions: {
@@ -123,6 +138,7 @@ function useDimensions(store, params, _api) {
       width: columnsTotalWidth,
       height: roundToDecimalPlaces(rowsMeta.currentPageTotalHeight, 1)
     };
+    const prevDimensions = store.state.dimensions;
     let viewportOuterSize;
     let viewportInnerSize;
     let hasScrollX = false;
@@ -160,6 +176,36 @@ function useDimensions(store, params, _api) {
           hasScrollY = content.height + scrollbarSize > container.height;
         }
       }
+
+      // Detect vertical scrollbar oscillation.
+      // Track consecutive hasScrollY flips with no row-height change.
+      // Once confirmed (≥ 2 flips), force hasScrollY off — the scrollbar is
+      // not genuinely needed, it is a layout feedback loop caused by stale
+      // rootSize or the horizontal scrollbar's height cascading.
+      {
+        const osc = scrollYOscillation.current;
+        const heightsChanged = rowsMeta.currentPageTotalHeight !== osc.heights.content || rowsMeta.pinnedTopRowsTotalHeight !== osc.heights.pinnedTop || rowsMeta.pinnedBottomRowsTotalHeight !== osc.heights.pinnedBottom;
+        if (heightsChanged) {
+          osc.counter = 0;
+          osc.heights = {
+            content: rowsMeta.currentPageTotalHeight,
+            pinnedTop: rowsMeta.pinnedTopRowsTotalHeight,
+            pinnedBottom: rowsMeta.pinnedBottomRowsTotalHeight
+          };
+        }
+        if (prevDimensions.isReady && hasScrollY !== prevDimensions.hasScrollY) {
+          if (!heightsChanged) {
+            osc.counter += 1;
+          }
+          if (osc.counter >= 2) {
+            hasScrollY = false;
+            // Recompute hasScrollX without the vertical scrollbar's width impact,
+            // otherwise the cascade (hasScrollY → narrower viewport → hasScrollX)
+            // keeps the horizontal scrollbar/filler alive and the root keeps resizing.
+            hasScrollX = hasScrollXIfNoYScrollBar;
+          }
+        }
+      }
       if (hasScrollY) {
         viewportInnerSize.width -= scrollbarSize;
       }
@@ -198,7 +244,6 @@ function useDimensions(store, params, _api) {
       autoHeight: params.dimensions.autoHeight,
       minimalContentHeight: params.dimensions.minimalContentHeight
     };
-    const prevDimensions = store.state.dimensions;
     if (isDeepEqual(prevDimensions, newDimensions)) {
       return;
     }

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-virtualizer v1.0.0-beta.0
+ * @mui/x-virtualizer v1.0.0-beta.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-virtualizer v1.0.0-beta.0
+ * @mui/x-virtualizer v1.0.0-beta.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-virtualizer",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.1",
   "author": "MUI Team",
   "description": "MUI virtualization library",
   "license": "MIT",