@mui/x-tree-view-pro 9.0.0-alpha.2 → 9.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,127 @@
 # Changelog
 
+## 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 +214,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/RichTreeViewPro/RichTreeViewPro.js

@@ -13,9 +13,8 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 var _useMergedRefs = require("@base-ui/utils/useMergedRefs");
 var _store = require("@mui/x-internals/store");
 var _composeClasses = _interopRequireDefault(require("@mui/utils/composeClasses"));
-var _useLicenseVerifier = require("@mui/x-license/useLicenseVerifier");
-var _Watermark = require("@mui/x-license/Watermark");
-var _internals = require("@mui/x-tree-view/internals");
+var _internals = require("@mui/x-license/internals");
+var _internals2 = require("@mui/x-tree-view/internals");
 var _warning = require("@mui/x-internals/warning");
 var _zeroStyled = require("../internals/zero-styled");
 var _richTreeViewProClasses = require("./richTreeViewProClasses");
@@ -59,7 +58,11 @@ const RichTreeViewProRoot = exports.RichTreeViewProRoot = (0, _zeroStyled.styled
     width: '100%'
   }
 });
-const releaseInfo = "MTc3MjY2ODgwMDAwMA==";
+const packageInfo = {
+  releaseDate: "MTc3MzI3MzYwMDAwMA==",
+  version: process.env.MUI_VERSION,
+  name: 'x-tree-view-pro'
+};
 
 /**
  *
@@ -76,7 +79,7 @@ const RichTreeViewPro = exports.RichTreeViewPro = /*#__PURE__*/React.forwardRef(
     props: inProps,
     name: 'MuiRichTreeViewPro'
   });
-  (0, _useLicenseVerifier.useLicenseVerifier)('x-tree-view-pro', releaseInfo);
+  (0, _internals.useLicenseVerifier)(packageInfo);
   if (process.env.NODE_ENV !== 'production') {
     if (props.children != null) {
       (0, _warning.warnOnce)(['MUI X: The `<RichTreeViewPro />` component does not support JSX children.', 'If you want to add items, you need to use the `items` prop.', 'Check the documentation for more details: https://mui.com/x/react-tree-view/rich-tree-view/items/.']);
@@ -89,9 +92,14 @@ const RichTreeViewPro = exports.RichTreeViewPro = /*#__PURE__*/React.forwardRef(
     parameters,
     forwardedProps
   } = (0, _useExtractRichTreeViewProParameters.useExtractRichTreeViewProParameters)(props);
+  if (process.env.NODE_ENV !== 'production') {
+    if (parameters.itemHeight === null && !parameters.disableVirtualization) {
+      (0, _warning.warnOnce)(['MUI X: `itemHeight={null}` is not compatible with virtualization.', 'Please use `disableVirtualization` when using `itemHeight={null}`.']);
+    }
+  }
 
   // Context hooks
-  const store = (0, _internals.useTreeViewStore)(_RichTreeViewProStore.RichTreeViewProStore, parameters);
+  const store = (0, _internals2.useTreeViewStore)(_RichTreeViewProStore.RichTreeViewProStore, parameters);
 
   // Ref hooks
   const ref = React.useRef(null);
@@ -105,25 +113,24 @@ const RichTreeViewPro = exports.RichTreeViewPro = /*#__PURE__*/React.forwardRef(
   const slots = React.useMemo(() => (0, _extends2.default)({
     root: RichTreeViewProRoot
   }, inSlots), [inSlots]);
-  const Renderer = isVirtualizationEnabled ? _RichTreeViewVirtualizedItems.RichTreeViewVirtualizedItems : _internals.RichTreeViewItems;
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_internals.TreeViewProvider, {
+  const Renderer = isVirtualizationEnabled ? _RichTreeViewVirtualizedItems.RichTreeViewVirtualizedItems : _internals2.RichTreeViewItems;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_internals2.TreeViewProvider, {
     store: store,
     classes: classes,
     slots: slots,
     slotProps: slotProps,
     apiRef: apiRef,
     rootRef: ref,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_internals.TreeViewItemDepthContext.Provider, {
-      value: _internals.itemsSelectors.itemDepth,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_internals2.TreeViewItemDepthContext.Provider, {
+      value: _internals2.itemsSelectors.itemDepth,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(Renderer, {
         slots: slots,
         slotProps: slotProps,
         forwardedProps: forwardedProps,
         ownerState: props,
         rootRef: handleRef
-      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Watermark.Watermark, {
-        packageName: "x-tree-view-pro",
-        releaseInfo: releaseInfo
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_internals.Watermark, {
+        packageInfo: packageInfo
       })]
     })
   });
@@ -210,11 +217,16 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
    * @default false
    */
   disableSelection: _propTypes.default.bool,
+  /**
+   * If `true`, virtualization is disabled.
+   * @default false
+   */
+  disableVirtualization: _propTypes.default.bool,
   /**
    * When equal to 'flat', the tree is rendered as a flat list (children are rendered as siblings of their parents).
    * When equal to 'nested', the tree is rendered with nested children (children are rendered inside the groupTransition slot of their children).
    * Nested DOM structure is not compatible with collapse / expansion animations.
-   * @default 'flat' when using virtualization, 'nested' otherwise
+   * @default 'flat'
    */
   domStructure: _propTypes.default.oneOf(['flat', 'nested']),
   /**
@@ -296,7 +308,8 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
   itemChildrenIndentation: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
   /**
    * Sets the height in pixel of an item.
-   * If not provided, no height restriction is applied to the tree item content element.
+   * Set to `null` to explicitly remove any item height restriction when items have different heights (not compatible with virtualization).
+   * @default 32
    */
   itemHeight: _propTypes.default.number,
   items: _propTypes.default.array.isRequired,
@@ -401,12 +414,5 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */
-  sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object]),
-  /**
-   * Whether virtualization is enabled.
-   * If true, the DOM structure will be set to 'flat'.
-   * If true and no itemHeight is provided, a default item height of 32px will be used for calculating the virtualization.
-   * @default false
-   */
-  virtualization: _propTypes.default.bool
+  sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object])
 } : void 0;

package/RichTreeViewPro/RichTreeViewPro.mjs

@@ -6,8 +6,7 @@ import PropTypes from 'prop-types';
 import { useMergedRefs } from '@base-ui/utils/useMergedRefs';
 import { useStore } from '@mui/x-internals/store';
 import composeClasses from '@mui/utils/composeClasses';
-import { useLicenseVerifier } from '@mui/x-license/useLicenseVerifier';
-import { Watermark } from '@mui/x-license/Watermark';
+import { useLicenseVerifier, Watermark } from '@mui/x-license/internals';
 import { TreeViewProvider, RichTreeViewItems, TreeViewItemDepthContext, itemsSelectors, useTreeViewStore } from '@mui/x-tree-view/internals';
 import { warnOnce } from '@mui/x-internals/warning';
 import { styled, createUseThemeProps } from "../internals/zero-styled/index.mjs";
@@ -52,7 +51,11 @@ export const RichTreeViewProRoot = styled('ul', {
     width: '100%'
   }
 });
-const releaseInfo = "MTc3MjY2ODgwMDAwMA==";
+const packageInfo = {
+  releaseDate: "MTc3MzI3MzYwMDAwMA==",
+  version: process.env.MUI_VERSION,
+  name: 'x-tree-view-pro'
+};
 
 /**
  *
@@ -69,7 +72,7 @@ const RichTreeViewPro = /*#__PURE__*/React.forwardRef(function RichTreeViewPro(i
     props: inProps,
     name: 'MuiRichTreeViewPro'
   });
-  useLicenseVerifier('x-tree-view-pro', releaseInfo);
+  useLicenseVerifier(packageInfo);
   if (process.env.NODE_ENV !== 'production') {
     if (props.children != null) {
       warnOnce(['MUI X: The `<RichTreeViewPro />` component does not support JSX children.', 'If you want to add items, you need to use the `items` prop.', 'Check the documentation for more details: https://mui.com/x/react-tree-view/rich-tree-view/items/.']);
@@ -82,6 +85,11 @@ const RichTreeViewPro = /*#__PURE__*/React.forwardRef(function RichTreeViewPro(i
     parameters,
     forwardedProps
   } = useExtractRichTreeViewProParameters(props);
+  if (process.env.NODE_ENV !== 'production') {
+    if (parameters.itemHeight === null && !parameters.disableVirtualization) {
+      warnOnce(['MUI X: `itemHeight={null}` is not compatible with virtualization.', 'Please use `disableVirtualization` when using `itemHeight={null}`.']);
+    }
+  }
 
   // Context hooks
   const store = useTreeViewStore(RichTreeViewProStore, parameters);
@@ -115,8 +123,7 @@ const RichTreeViewPro = /*#__PURE__*/React.forwardRef(function RichTreeViewPro(i
         ownerState: props,
         rootRef: handleRef
       }), /*#__PURE__*/_jsx(Watermark, {
-        packageName: "x-tree-view-pro",
-        releaseInfo: releaseInfo
+        packageInfo: packageInfo
       })]
     })
   });
@@ -203,11 +210,16 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
    * @default false
    */
   disableSelection: PropTypes.bool,
+  /**
+   * If `true`, virtualization is disabled.
+   * @default false
+   */
+  disableVirtualization: PropTypes.bool,
   /**
    * When equal to 'flat', the tree is rendered as a flat list (children are rendered as siblings of their parents).
    * When equal to 'nested', the tree is rendered with nested children (children are rendered inside the groupTransition slot of their children).
    * Nested DOM structure is not compatible with collapse / expansion animations.
-   * @default 'flat' when using virtualization, 'nested' otherwise
+   * @default 'flat'
    */
   domStructure: PropTypes.oneOf(['flat', 'nested']),
   /**
@@ -289,7 +301,8 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
   itemChildrenIndentation: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
   /**
    * Sets the height in pixel of an item.
-   * If not provided, no height restriction is applied to the tree item content element.
+   * Set to `null` to explicitly remove any item height restriction when items have different heights (not compatible with virtualization).
+   * @default 32
    */
   itemHeight: PropTypes.number,
   items: PropTypes.array.isRequired,
@@ -394,13 +407,6 @@ process.env.NODE_ENV !== "production" ? RichTreeViewPro.propTypes = {
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */
-  sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
-  /**
-   * Whether virtualization is enabled.
-   * If true, the DOM structure will be set to 'flat'.
-   * If true and no itemHeight is provided, a default item height of 32px will be used for calculating the virtualization.
-   * @default false
-   */
-  virtualization: PropTypes.bool
+  sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object])
 } : void 0;
 export { RichTreeViewPro };

package/RichTreeViewPro/useExtractRichTreeViewProParameters.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useExtractRichTreeViewProParameters = useExtractRichTreeViewProParameters;
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var React = _interopRequireWildcard(require("react"));
-const _excluded = ["apiRef", "slots", "slotProps", "disabledItemsFocusable", "items", "isItemDisabled", "isItemSelectionDisabled", "getItemLabel", "getItemChildren", "getItemId", "onItemClick", "itemChildrenIndentation", "id", "expandedItems", "defaultExpandedItems", "onExpandedItemsChange", "onItemExpansionToggle", "expansionTrigger", "disableSelection", "selectedItems", "defaultSelectedItems", "multiSelect", "checkboxSelection", "selectionPropagation", "onSelectedItemsChange", "onItemSelectionToggle", "onItemFocus", "itemHeight", "onItemLabelChange", "isItemEditable", "domStructure", "dataSource", "dataSourceCache", "itemsReordering", "isItemReorderable", "canMoveItemToNewPosition", "onItemPositionChange", "virtualization"];
+const _excluded = ["apiRef", "slots", "slotProps", "disabledItemsFocusable", "items", "isItemDisabled", "isItemSelectionDisabled", "getItemLabel", "getItemChildren", "getItemId", "onItemClick", "itemChildrenIndentation", "id", "expandedItems", "defaultExpandedItems", "onExpandedItemsChange", "onItemExpansionToggle", "expansionTrigger", "disableSelection", "selectedItems", "defaultSelectedItems", "multiSelect", "checkboxSelection", "selectionPropagation", "onSelectedItemsChange", "onItemSelectionToggle", "onItemFocus", "itemHeight", "onItemLabelChange", "isItemEditable", "domStructure", "dataSource", "dataSourceCache", "itemsReordering", "isItemReorderable", "canMoveItemToNewPosition", "onItemPositionChange", "disableVirtualization"];
 function useExtractRichTreeViewProParameters(props) {
   const {
       // Props for Provider
@@ -52,7 +52,7 @@ function useExtractRichTreeViewProParameters(props) {
       isItemReorderable,
       canMoveItemToNewPosition,
       onItemPositionChange,
-      virtualization
+      disableVirtualization
 
       // Forwarded props
     } = props,
@@ -95,14 +95,14 @@ function useExtractRichTreeViewProParameters(props) {
     isItemReorderable,
     canMoveItemToNewPosition,
     onItemPositionChange,
-    virtualization
+    disableVirtualization
   }), [
   // Shared parameters
   disabledItemsFocusable, items, isItemDisabled, isItemSelectionDisabled, getItemLabel, getItemChildren, getItemId, onItemClick, itemChildrenIndentation, id, expandedItems, defaultExpandedItems, onExpandedItemsChange, onItemExpansionToggle, expansionTrigger, disableSelection, selectedItems, defaultSelectedItems, multiSelect, checkboxSelection, selectionPropagation, onSelectedItemsChange, onItemSelectionToggle, onItemFocus, itemHeight,
   // RichTreeViewStore parameters
   onItemLabelChange, isItemEditable, domStructure,
   // RichTreeViewProStore parameters
-  dataSource, dataSourceCache, itemsReordering, isItemReorderable, canMoveItemToNewPosition, onItemPositionChange, virtualization]);
+  dataSource, dataSourceCache, itemsReordering, isItemReorderable, canMoveItemToNewPosition, onItemPositionChange, disableVirtualization]);
   return {
     apiRef,
     slots,

package/RichTreeViewPro/useExtractRichTreeViewProParameters.mjs

@@ -1,5 +1,5 @@
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["apiRef", "slots", "slotProps", "disabledItemsFocusable", "items", "isItemDisabled", "isItemSelectionDisabled", "getItemLabel", "getItemChildren", "getItemId", "onItemClick", "itemChildrenIndentation", "id", "expandedItems", "defaultExpandedItems", "onExpandedItemsChange", "onItemExpansionToggle", "expansionTrigger", "disableSelection", "selectedItems", "defaultSelectedItems", "multiSelect", "checkboxSelection", "selectionPropagation", "onSelectedItemsChange", "onItemSelectionToggle", "onItemFocus", "itemHeight", "onItemLabelChange", "isItemEditable", "domStructure", "dataSource", "dataSourceCache", "itemsReordering", "isItemReorderable", "canMoveItemToNewPosition", "onItemPositionChange", "virtualization"];
+const _excluded = ["apiRef", "slots", "slotProps", "disabledItemsFocusable", "items", "isItemDisabled", "isItemSelectionDisabled", "getItemLabel", "getItemChildren", "getItemId", "onItemClick", "itemChildrenIndentation", "id", "expandedItems", "defaultExpandedItems", "onExpandedItemsChange", "onItemExpansionToggle", "expansionTrigger", "disableSelection", "selectedItems", "defaultSelectedItems", "multiSelect", "checkboxSelection", "selectionPropagation", "onSelectedItemsChange", "onItemSelectionToggle", "onItemFocus", "itemHeight", "onItemLabelChange", "isItemEditable", "domStructure", "dataSource", "dataSourceCache", "itemsReordering", "isItemReorderable", "canMoveItemToNewPosition", "onItemPositionChange", "disableVirtualization"];
 import * as React from 'react';
 export function useExtractRichTreeViewProParameters(props) {
   const {
@@ -44,7 +44,7 @@ export function useExtractRichTreeViewProParameters(props) {
       isItemReorderable,
       canMoveItemToNewPosition,
       onItemPositionChange,
-      virtualization
+      disableVirtualization
 
       // Forwarded props
     } = props,
@@ -87,14 +87,14 @@ export function useExtractRichTreeViewProParameters(props) {
     isItemReorderable,
     canMoveItemToNewPosition,
     onItemPositionChange,
-    virtualization
+    disableVirtualization
   }), [
   // Shared parameters
   disabledItemsFocusable, items, isItemDisabled, isItemSelectionDisabled, getItemLabel, getItemChildren, getItemId, onItemClick, itemChildrenIndentation, id, expandedItems, defaultExpandedItems, onExpandedItemsChange, onItemExpansionToggle, expansionTrigger, disableSelection, selectedItems, defaultSelectedItems, multiSelect, checkboxSelection, selectionPropagation, onSelectedItemsChange, onItemSelectionToggle, onItemFocus, itemHeight,
   // RichTreeViewStore parameters
   onItemLabelChange, isItemEditable, domStructure,
   // RichTreeViewProStore parameters
-  dataSource, dataSourceCache, itemsReordering, isItemReorderable, canMoveItemToNewPosition, onItemPositionChange, virtualization]);
+  dataSource, dataSourceCache, itemsReordering, isItemReorderable, canMoveItemToNewPosition, onItemPositionChange, disableVirtualization]);
   return {
     apiRef,
     slots,

package/components/RichTreeViewVirtualizedItems.js

@@ -68,7 +68,7 @@ function RichTreeViewVirtualizedItems(props) {
   const virtualizer = (0, _xVirtualizer.useVirtualizer)({
     layout,
     dimensions: {
-      rowHeight: defaultItemHeight // The defaultItemHeight is always defined when virtualization is enabled.
+      rowHeight: defaultItemHeight ?? 32
     },
     virtualization: {},
     rows: items,

package/components/RichTreeViewVirtualizedItems.mjs

@@ -61,7 +61,7 @@ export function RichTreeViewVirtualizedItems(props) {
   const virtualizer = useVirtualizer({
     layout,
     dimensions: {
-      rowHeight: defaultItemHeight // The defaultItemHeight is always defined when virtualization is enabled.
+      rowHeight: defaultItemHeight ?? 32
     },
     virtualization: {},
     rows: items,

package/index.d.mts

@@ -8,5 +8,5 @@ export * from '@mui/x-tree-view/TreeItemDragAndDropOverlay';
 export * from '@mui/x-tree-view/TreeItemLabelInput';
 export * from '@mui/x-tree-view/models';
 export * from '@mui/x-tree-view/icons';
-export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount, useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount } from '@mui/x-tree-view/hooks';
 export * from "./hooks/index.mjs";

package/index.d.ts

@@ -8,5 +8,5 @@ export * from '@mui/x-tree-view/TreeItemDragAndDropOverlay';
 export * from '@mui/x-tree-view/TreeItemLabelInput';
 export * from '@mui/x-tree-view/models';
 export * from '@mui/x-tree-view/icons';
-export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount, useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount } from '@mui/x-tree-view/hooks';
 export * from "./hooks/index.js";

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-tree-view-pro v9.0.0-alpha.2
+ * @mui/x-tree-view-pro v9.0.0-alpha.3
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the
@@ -13,8 +13,7 @@ Object.defineProperty(exports, "__esModule", {
 var _exportNames = {
   useTreeItemUtils: true,
   useTreeItemModel: true,
-  useApplyPropagationToSelectedItemsOnMount: true,
-  useTreeViewApiRef: true
+  useApplyPropagationToSelectedItemsOnMount: true
 };
 Object.defineProperty(exports, "useApplyPropagationToSelectedItemsOnMount", {
   enumerable: true,
@@ -34,12 +33,6 @@ Object.defineProperty(exports, "useTreeItemUtils", {
     return _hooks.useTreeItemUtils;
   }
 });
-Object.defineProperty(exports, "useTreeViewApiRef", {
-  enumerable: true,
-  get: function () {
-    return _hooks.useTreeViewApiRef;
-  }
-});
 var _SimpleTreeView = require("@mui/x-tree-view/SimpleTreeView");
 Object.keys(_SimpleTreeView).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-tree-view-pro v9.0.0-alpha.2
+ * @mui/x-tree-view-pro v9.0.0-alpha.3
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the
@@ -18,5 +18,5 @@ export * from '@mui/x-tree-view/TreeItemDragAndDropOverlay';
 export * from '@mui/x-tree-view/TreeItemLabelInput';
 export * from '@mui/x-tree-view/models';
 export * from '@mui/x-tree-view/icons';
-export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount, useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+export { useTreeItemUtils, useTreeItemModel, useApplyPropagationToSelectedItemsOnMount } from '@mui/x-tree-view/hooks';
 export * from "./hooks/index.mjs";

package/internals/RichTreeViewProStore/RichTreeViewProStore.types.d.mts

@@ -74,14 +74,18 @@ export interface RichTreeViewProStoreParameters<R extends TreeViewValidItem<R>,
    * When equal to 'flat', the tree is rendered as a flat list (children are rendered as siblings of their parents).
    * When equal to 'nested', the tree is rendered with nested children (children are rendered inside the groupTransition slot of their children).
    * Nested DOM structure is not compatible with collapse / expansion animations.
-   * @default 'flat' when using virtualization, 'nested' otherwise
+   * @default 'flat'
    */
   domStructure?: TreeViewDOMStructure;
   /**
-   * Whether virtualization is enabled.
-   * If true, the DOM structure will be set to 'flat'.
-   * If true and no itemHeight is provided, a default item height of 32px will be used for calculating the virtualization.
+   * If `true`, virtualization is disabled.
    * @default false
    */
-  virtualization?: boolean;
+  disableVirtualization?: boolean;
+  /**
+   * Sets the height in pixel of an item.
+   * Set to `null` to explicitly remove any item height restriction when items have different heights (not compatible with virtualization).
+   * @default 32
+   */
+  itemHeight?: number | null;
 }

package/internals/RichTreeViewProStore/RichTreeViewProStore.types.d.ts

@@ -74,14 +74,18 @@ export interface RichTreeViewProStoreParameters<R extends TreeViewValidItem<R>,
    * When equal to 'flat', the tree is rendered as a flat list (children are rendered as siblings of their parents).
    * When equal to 'nested', the tree is rendered with nested children (children are rendered inside the groupTransition slot of their children).
    * Nested DOM structure is not compatible with collapse / expansion animations.
-   * @default 'flat' when using virtualization, 'nested' otherwise
+   * @default 'flat'
    */
   domStructure?: TreeViewDOMStructure;
   /**
-   * Whether virtualization is enabled.
-   * If true, the DOM structure will be set to 'flat'.
-   * If true and no itemHeight is provided, a default item height of 32px will be used for calculating the virtualization.
+   * If `true`, virtualization is disabled.
    * @default false
    */
-  virtualization?: boolean;
+  disableVirtualization?: boolean;
+  /**
+   * Sets the height in pixel of an item.
+   * Set to `null` to explicitly remove any item height restriction when items have different heights (not compatible with virtualization).
+   * @default 32
+   */
+  itemHeight?: number | null;
 }

package/internals/RichTreeViewProStore/RichTreeViewProStore.utils.js

@@ -10,14 +10,14 @@ var _internals = require("@mui/x-tree-view/internals");
 var _lazyLoading = require("../plugins/lazyLoading");
 const DEFAULT_IS_ITEM_REORDERABLE_WHEN_ENABLED = () => true;
 const DEFAULT_IS_ITEM_REORDERABLE_WHEN_DISABLED = () => false;
-const DEFAULT_ITEM_HEIGHT_WITH_VIRTUALIZATION = 32;
+const DEFAULT_ITEM_HEIGHT = 32;
 const deriveStateFromParameters = parameters => ({
   lazyLoadedItems: parameters.dataSource ? _lazyLoading.TREE_VIEW_LAZY_LOADED_ITEMS_INITIAL_STATE : null,
   currentReorder: null,
   isItemReorderable: parameters.itemsReordering ? parameters.isItemReorderable ?? DEFAULT_IS_ITEM_REORDERABLE_WHEN_ENABLED : DEFAULT_IS_ITEM_REORDERABLE_WHEN_DISABLED,
-  domStructure: parameters.domStructure ?? (parameters.virtualization ? 'flat' : 'nested'),
-  virtualization: parameters.virtualization ?? false,
-  itemHeight: parameters.itemHeight ?? (parameters.virtualization ? DEFAULT_ITEM_HEIGHT_WITH_VIRTUALIZATION : null)
+  domStructure: parameters.domStructure ?? 'flat',
+  virtualization: !(parameters.disableVirtualization ?? false),
+  itemHeight: parameters.itemHeight === undefined ? DEFAULT_ITEM_HEIGHT : parameters.itemHeight
 });
 const parametersToStateMapper = exports.parametersToStateMapper = {
   getInitialState: (minimalInitialState, parameters) => (0, _extends2.default)({}, _internals.ExtendableRichTreeViewStore.rawMapper.getInitialState(minimalInitialState, parameters), deriveStateFromParameters(parameters)),

package/internals/RichTreeViewProStore/RichTreeViewProStore.utils.mjs

@@ -3,14 +3,14 @@ import { ExtendableRichTreeViewStore } from '@mui/x-tree-view/internals';
 import { TREE_VIEW_LAZY_LOADED_ITEMS_INITIAL_STATE } from "../plugins/lazyLoading/index.mjs";
 const DEFAULT_IS_ITEM_REORDERABLE_WHEN_ENABLED = () => true;
 const DEFAULT_IS_ITEM_REORDERABLE_WHEN_DISABLED = () => false;
-const DEFAULT_ITEM_HEIGHT_WITH_VIRTUALIZATION = 32;
+const DEFAULT_ITEM_HEIGHT = 32;
 const deriveStateFromParameters = parameters => ({
   lazyLoadedItems: parameters.dataSource ? TREE_VIEW_LAZY_LOADED_ITEMS_INITIAL_STATE : null,
   currentReorder: null,
   isItemReorderable: parameters.itemsReordering ? parameters.isItemReorderable ?? DEFAULT_IS_ITEM_REORDERABLE_WHEN_ENABLED : DEFAULT_IS_ITEM_REORDERABLE_WHEN_DISABLED,
-  domStructure: parameters.domStructure ?? (parameters.virtualization ? 'flat' : 'nested'),
-  virtualization: parameters.virtualization ?? false,
-  itemHeight: parameters.itemHeight ?? (parameters.virtualization ? DEFAULT_ITEM_HEIGHT_WITH_VIRTUALIZATION : null)
+  domStructure: parameters.domStructure ?? 'flat',
+  virtualization: !(parameters.disableVirtualization ?? false),
+  itemHeight: parameters.itemHeight === undefined ? DEFAULT_ITEM_HEIGHT : parameters.itemHeight
 });
 export const parametersToStateMapper = {
   getInitialState: (minimalInitialState, parameters) => _extends({}, ExtendableRichTreeViewStore.rawMapper.getInitialState(minimalInitialState, parameters), deriveStateFromParameters(parameters)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-tree-view-pro",
-  "version": "9.0.0-alpha.2",
+  "version": "9.0.0-alpha.3",
   "author": "MUI Team",
   "description": "The Pro plan edition of the MUI X Tree View components.",
   "license": "SEE LICENSE IN LICENSE",
@@ -41,8 +41,8 @@
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.6.0",
     "@mui/x-internals": "9.0.0-alpha.2",
-    "@mui/x-license": "9.0.0-alpha.2",
-    "@mui/x-tree-view": "9.0.0-alpha.2",
+    "@mui/x-license": "9.0.0-alpha.3",
+    "@mui/x-tree-view": "9.0.0-alpha.3",
     "@mui/x-virtualizer": "1.0.0-alpha.1"
   },
   "peerDependencies": {