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

package/CHANGELOG.md

@@ -1,5 +1,356 @@
 # 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_
+
+We'd like to extend a big thank you to the 12 contributors who made this release possible. Here are some highlights ✨:
+
+- 🐞 Bugfixes and internal improvements
+
+The following team members contributed to this release:
+@aemartos, @alexfauquette, @bernardobelchior, @Janpot, @JCQuintas, @LukasTy, @mapache-salvaje, @michelengelen, @noraleonte, @rita-codes, @sai6855, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.0.0-alpha.4`
+
+- [DataGrid] Mark charts integration as stable (#21764) @JCQuintas
+- [DataGrid] Move `elementOverrides` to constants and remove duplicates (#21618) @sai6855
+- [DataGrid] Migrate from deprecated Material UI APIs (#21682) @siriwatknp
+
+#### `@mui/x-data-grid-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-data-grid@9.0.0-alpha.4`.
+
+#### `@mui/x-data-grid-premium@9.0.0-alpha.4` [![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-alpha.4`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.0.0-alpha.4`
+
+- [pickers] Avoid stealing focus on click away (#13434) @LukasTy
+- [pickers] Promote `fieldRef` to stable and add `clearValue` method (#21655) @michelengelen
+
+#### `@mui/x-date-pickers-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-date-pickers@9.0.0-alpha.4`.
+
+### Charts
+
+#### `@mui/x-charts@9.0.0-alpha.4`
+
+- [charts] Add v9 chart series types and helper functions migration (#21009) @bernardobelchior
+- [charts] Extract event listener to the layer container (#21751) @alexfauquette
+- [charts] Fix WebGL print export canvas stretching (#21738) @JCQuintas
+- [charts] Improve deprecation warnings (#21760) @alexfauquette
+- [charts] Improve type safety in `identifierCleaner` (#21719) @bernardobelchior
+- [charts] Make `preferStrictDomainInLineCharts` the default (#21744) @JCQuintas
+- [charts] Move title and description to the layer container (#21757) @alexfauquette
+- [charts] Refactor `FunnelChart` classes structure (#21652) @JCQuintas
+- [charts] Refactor `Heatmap` classes structure (#21653) @JCQuintas
+- [charts] Refactor `RadarChart` classes structure (#21650) @JCQuintas
+- [charts] Refactor `SankeyChart` classes structure (#21654) @JCQuintas
+- [charts] Refactor legend getters to use utility functions (#21628) @sai6855
+- [charts] Remove deprecated `ChartContainer` and `ChartDataProvider` (#21777) @alexfauquette
+- [charts] Remove deprecated `itemId` from `SeriesLegendItemContext` (#21788) @alexfauquette
+- [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 the deprecated `disableHover` property (#21785) @alexfauquette
+- [charts] Remove the deprecated `message` prop (#21784) @alexfauquette
+- [charts] Remove deprecated props about voronoi (#21796) @alexfauquette
+- [charts] Remove deprecated pieArcClasses (#21795) @alexfauquette
+- [charts] Rename `data-series-id` by `data-series` (#21761) @alexfauquette
+- [charts] Rename `voronoiMaxRadius`/`disableVoronoi` to `hitAreaRadius`/`disableHitArea` (#21750) @bernardobelchior
+- [charts] Update pt-PT locale (#21296) @bernardobelchior
+- [charts] Use different shape per series by default (#21713) @alexfauquette
+- [charts] Add className prop to Radar components (#21794) @JCQuintas
+- [charts] Add className prop to shared chart components (#21792) @JCQuintas
+- [charts] Add className prop to BarPlot (#21791) @JCQuintas
+- [charts] Portal tooltip into ChartsLayerContainer (#21801) @JCQuintas
+
+#### `@mui/x-charts-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-charts@9.0.0-alpha.4`, plus:
+
+- [charts-pro] Allow `brush` interaction to accept `requiredKeys/pointerMode` (#21716) @JCQuintas
+- [charts-pro] Remove deprecated `onAxisClick` for Heatmap (#21786) @alexfauquette
+
+#### `@mui/x-charts-premium@9.0.0-alpha.4` [![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-alpha.4`, plus:
+
+- [charts-premium] Add candlestick chart (#21129) @bernardobelchior
+
+### 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-infra] Exclude `ServerSideLazyLoadingRevalidation` from argos (#21734) @sai6855
+- [docs] Update charts v9 migration guide to include premium package (#21743) @bernardobelchior
+- [docs] Update v9 migration guides to install next tag (#21741) @bernardobelchior
+- [docs] Revise the Pie chart docs (#21565) @mapache-salvaje
+- [docs] Revise the Bar Chart docs (#21482) @mapache-salvaje
+- [docs] Removed a `console.log` from an aggregation demo (#21698) @michelengelen
+
+### Core
+
+- [code-infra] Add pkg-pr-new as dev dependency (#21754) @Janpot
+- [code-infra] Prevent `combiner` to have default parameters (#21707) @JCQuintas
+- [code-infra] Remove CI coverage collection and upload to Codecov (#21671) @Janpot
+- [internal] Remove @bernardobelchior from Charts CODEOWNERS (#21776) @Copilot
+
+### Miscellaneous
+
+- [x-license] Fix process.env.MUI_VERSION not being replaced during build (#21727) @aemartos
+- [x-license] Add new watermark license status message (#21720) @aemartos
+
+## 9.0.0-alpha.3
+
+_Mar 12, 2026_
+
+We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
+
+- 🐞 Bugfixes and internal improvements
+
+The following team members contributed to this release:
+@aemartos, @alexfauquette, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @MBilalShafi, @michelengelen, @rita-codes, @sai6855, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.0.0-alpha.3`
+
+- [DataGrid] Fix crash when `rows` and `rowModesModel` are updated simultaneously (#21265) @michelengelen
+- [DataGrid] Add missing `resizablePanelHandle` classes to `gridClasses` object (#21538) @sai6855
+- [DataGrid] Refactor `headerAlign` style calls (#21541) @sai6855
+
+#### `@mui/x-data-grid-pro@9.0.0-alpha.3` [![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-alpha.3`, plus:
+
+- [DataGridPro] Add `role="presentation"` to detail panel toggle header content (#21634) @michelengelen
+- [DataGridPro] Fix sorting not reflected in nested server-side data (#21619) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@9.0.0-alpha.3` [![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-alpha.3`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.0.0-alpha.3`
+
+- [pickers] Refactor `DateRangePickerDay` overrides to use a centralized `elementOverrides` object (#21426) @sai6855
+- [pickers] Migrate from deprecated props for `PickersModalDialog` (#21702) @siriwatknp
+
+#### `@mui/x-date-pickers-pro@9.0.0-alpha.3` [![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-alpha.3`.
+
+### Charts
+
+#### `@mui/x-charts@9.0.0-alpha.3`
+
+- [charts] Differentiate Line Plot roots classes (#21679) @JCQuintas
+- [charts] Enable keyboard navigation by default (#21675) @alexfauquette
+- [charts] Fix keyboard tooltip radar (#21667) @alexfauquette
+- [charts] Fix selector default parameter (#21638) @JCQuintas
+- [charts] Fix tooltip blink between node and pointer anchor (#21611) @alexfauquette
+- [charts] Let tooltip and legend reflect the line shape (#21475) @alexfauquette
+- [charts] Refactor `BarChart` classes structure (#21601) @JCQuintas
+- [charts] Refactor `LineChart` classes structure (#21648) @JCQuintas
+- [charts] Refactor `ScatterChart` classes structure (#21651) @JCQuintas
+- [charts] Refactor `PieChart` classes structure (#21649) @JCQuintas
+- [charts] Remove batch rendering checks in highlight selectors (#21646) @bernardobelchior
+- [charts] Standardize generic arg names to `SeriesType` (#21694) @alexfauquette
+- [charts] Simplify highlight hooks return types (#21695) @alexfauquette
+
+#### `@mui/x-charts-pro@9.0.0-alpha.3` [![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-alpha.3`, plus:
+
+- [charts-pro] Fix heatmap style override from `arc` to `cell` (#21693) @Copilot
+- [charts-pro] Fix image export truncated when page is zoomed out (#21685) @bernardobelchior
+- [charts-pro] Speed-up heatmap cell search with an index lookup (#21130) @alexfauquette
+- [charts-pro] Fix heatmap highlight not working (#21710) @Copilot
+
+#### `@mui/x-charts-premium@9.0.0-alpha.3` [![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-alpha.3`, plus:
+
+- [charts-premium] Re-enable WebGL tests (#21708) @bernardobelchior
+
+### Tree View
+
+#### Breaking changes
+
+- Remove `TreeViewBaseItem` type (use `TreeViewDefaultItemModelProperties` or a custom interface)
+- Remove `useTreeViewApiRef` hook (use `useRichTreeViewApiRef`, `useSimpleTreeViewApiRef`, or `useRichTreeViewProApiRef`)
+- Remove `status` from content slot props returned by `getContentProps()` (use `data-*` attributes; `status` on `useTreeItem` return value is unchanged)
+- Remove deprecated CSS state classes from `treeItemClasses`: `expanded`, `selected`, `focused`, `disabled`, `editable`, `editing` (use `[data-expanded]`, `[data-selected]`, etc.)
+- The `<RichTreeViewPro />` component has now virtualization enabled by default.
+- The items used inside the `<RichTreeViewPro />` now have a default height of `32px`.
+- The events of the `<RichTreeViewPro />` are now rendered as a flat list instead of a nested tree.
+
+#### `@mui/x-tree-view@9.0.0-alpha.3`
+
+- [tree view] Remove deprecated APIs (#21591) @flaviendelangle
+- [tree view] Fix collapsed children not selected with `selectionPropagation.descendants` in `SimpleTreeView` (#21253) @flaviendelangle
+
+#### `@mui/x-tree-view-pro@9.0.0-alpha.3` [![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.3`, plus:
+
+- [RichTreeViewPro] Make the virtualization opt-out and port the layout doc from the data grid (#21461) @flaviendelangle
+
+### Codemod
+
+#### `@mui/x-codemod@9.0.0-alpha.3`
+
+Internal changes.
+
+### Docs
+
+- [docs] Fix `AssistantWithDataSource` demo crashing (#21555) @sai6855
+- [docs] Remove `Preview` pill from Sankey (#21623) @bernardobelchior
+- [docs] Migrate internal Material UI deprecated APIs (#21680) @siriwatknp
+- [docs] Remove `New` flag on Tree View and Date and Time Pickers features released before v9 alpha (#21585) @flaviendelangle
+
+### Core
+
+- [code-infra] Remove checkout step (#21688) @Janpot
+- [code-infra] Fix contributor generation in changelog (#21718) @brijeshb42
+- [docs-infra] Do not point to non-existent v8 subdomain (#21640) @cherniavskii
+
+### Miscellaneous
+
+- [test] Add missing tests for forwarding props to filter operators in DataGrid (#21441) @siriwatknp
+- [x-license] Export additional license types and constants (#21625) @aemartos
+- [x-license] Refactor license verification to accept package info object and add v9 version gating (#21690) @aemartos
+
 ## 9.0.0-alpha.2
 
 _Mar 5, 2026_
@@ -92,7 +443,7 @@ Internal changes.
 
 - [docs] Add backticks and parentheses to all functions and hooks (DX-173) (#21496) @mapache-salvaje
 - [docs] Remove mentions of `mySvgRef` (#21559) @bernardobelchior
-- [docs] Update Roadmap section in the docs  (#20892) @alelthomas
+- [docs] Update Roadmap section in the docs (#20892) @alelthomas
 - [docs] Add tutorial and example app for aggregation with row grouping (DX-162) (#21102) @mapache-salvaje
 - [docs] Fix missing codemod docs (#21604) @JCQuintas
 

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-alpha.1
+ * @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-alpha.1
+ * @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-alpha.1",
+  "version": "1.0.0-beta.1",
   "author": "MUI Team",
   "description": "MUI virtualization library",
   "license": "MIT",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@babel/runtime": "^7.28.6",
     "@mui/utils": "^7.3.7",
-    "@mui/x-internals": "9.0.0-alpha.2"
+    "@mui/x-internals": "9.0.0-alpha.4"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0",