@mui/x-tree-view 7.0.0-alpha.1 → 7.0.0-alpha.8

package/legacy/TreeItem/TreeItem.js

@@ -1,19 +1,15 @@
-import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
-var _excluded = ["children", "className", "collapseIcon", "ContentComponent", "ContentProps", "endIcon", "expandIcon", "disabled", "icon", "id", "label", "nodeId", "onClick", "onMouseDown", "TransitionComponent", "TransitionProps"];
+var _excluded = ["children", "className", "collapseIcon", "ContentComponent", "ContentProps", "endIcon", "expandIcon", "icon", "nodeId", "id", "label", "onClick", "onMouseDown", "TransitionComponent", "TransitionProps"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import clsx from 'clsx';
 import Collapse from '@mui/material/Collapse';
 import { alpha, styled, useThemeProps } from '@mui/material/styles';
-import ownerDocument from '@mui/utils/ownerDocument';
-import useForkRef from '@mui/utils/useForkRef';
 import unsupportedProp from '@mui/utils/unsupportedProp';
 import elementTypeAcceptingRef from '@mui/utils/elementTypeAcceptingRef';
 import { unstable_composeClasses as composeClasses } from '@mui/base';
-import { DescendantProvider, useDescendant } from '../internals/TreeViewProvider/DescendantProvider';
 import { TreeItemContent } from './TreeItemContent';
 import { treeItemClasses, getTreeItemUtilityClass } from './treeItemClasses';
 import { useTreeViewContext } from '../internals/TreeViewProvider/useTreeViewContext';
@@ -53,9 +49,8 @@ var StyledTreeItemContent = styled(TreeItemContent, {
     return [styles.content, styles.iconContainer && _defineProperty({}, "& .".concat(treeItemClasses.iconContainer), styles.iconContainer), styles.label && _defineProperty({}, "& .".concat(treeItemClasses.label), styles.label)];
   }
 })(function (_ref3) {
-  var _ref4;
   var theme = _ref3.theme;
-  return _ref4 = {
+  return _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({
     padding: '0 8px',
     width: '100%',
     boxSizing: 'border-box',
@@ -71,12 +66,12 @@ var StyledTreeItemContent = styled(TreeItemContent, {
         backgroundColor: 'transparent'
       }
     }
-  }, _defineProperty(_ref4, "&.".concat(treeItemClasses.disabled), {
+  }, "&.".concat(treeItemClasses.disabled), {
     opacity: (theme.vars || theme).palette.action.disabledOpacity,
     backgroundColor: 'transparent'
-  }), _defineProperty(_ref4, "&.".concat(treeItemClasses.focused), {
+  }), "&.".concat(treeItemClasses.focused), {
     backgroundColor: (theme.vars || theme).palette.action.focus
-  }), _defineProperty(_ref4, "&.".concat(treeItemClasses.selected), _defineProperty({
+  }), "&.".concat(treeItemClasses.selected), _defineProperty({
     backgroundColor: theme.vars ? "rgba(".concat(theme.vars.palette.primary.mainChannel, " / ").concat(theme.vars.palette.action.selectedOpacity, ")") : alpha(theme.palette.primary.main, theme.palette.action.selectedOpacity),
     '&:hover': {
       backgroundColor: theme.vars ? "rgba(".concat(theme.vars.palette.primary.mainChannel, " / calc(").concat(theme.vars.palette.action.selectedOpacity, " + ").concat(theme.vars.palette.action.hoverOpacity, "))") : alpha(theme.palette.primary.main, theme.palette.action.selectedOpacity + theme.palette.action.hoverOpacity),
@@ -87,7 +82,7 @@ var StyledTreeItemContent = styled(TreeItemContent, {
     }
   }, "&.".concat(treeItemClasses.focused), {
     backgroundColor: theme.vars ? "rgba(".concat(theme.vars.palette.primary.mainChannel, " / calc(").concat(theme.vars.palette.action.selectedOpacity, " + ").concat(theme.vars.palette.action.focusOpacity, "))") : alpha(theme.palette.primary.main, theme.palette.action.selectedOpacity + theme.palette.action.focusOpacity)
-  })), _defineProperty(_ref4, "& .".concat(treeItemClasses.iconContainer), {
+  })), "& .".concat(treeItemClasses.iconContainer), {
     marginRight: 4,
     width: 15,
     display: 'flex',
@@ -96,7 +91,7 @@ var StyledTreeItemContent = styled(TreeItemContent, {
     '& svg': {
       fontSize: 18
     }
-  }), _defineProperty(_ref4, "& .".concat(treeItemClasses.label), _extends({
+  }), "& .".concat(treeItemClasses.label), _extends({
     paddingLeft: 4,
     width: '100%',
     boxSizing: 'border-box',
@@ -104,7 +99,7 @@ var StyledTreeItemContent = styled(TreeItemContent, {
     // fixes overflow - see https://github.com/mui/material-ui/issues/27372
     minWidth: 0,
     position: 'relative'
-  }, theme.typography.body1)), _ref4;
+  }, theme.typography.body1));
 });
 var TreeItemGroup = styled(Collapse, {
   name: 'MuiTreeItem',
@@ -128,11 +123,24 @@ var TreeItemGroup = styled(Collapse, {
  *
  * - [TreeItem API](https://mui.com/x/api/tree-view/tree-item/)
  */
-export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, ref) {
-  var props = useThemeProps({
+export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, inRef) {
+  var _useTreeViewContext = useTreeViewContext(),
+    contextIcons = _useTreeViewContext.icons,
+    runItemPlugins = _useTreeViewContext.runItemPlugins,
+    multiSelect = _useTreeViewContext.multiSelect,
+    disabledItemsFocusable = _useTreeViewContext.disabledItemsFocusable,
+    instance = _useTreeViewContext.instance;
+  var inPropsWithTheme = useThemeProps({
     props: inProps,
     name: 'MuiTreeItem'
   });
+  var _runItemPlugins = runItemPlugins({
+      props: inPropsWithTheme,
+      ref: inRef
+    }),
+    props = _runItemPlugins.props,
+    ref = _runItemPlugins.ref,
+    wrapItem = _runItemPlugins.wrapItem;
   var children = props.children,
     className = props.className,
     collapseIcon = props.collapseIcon,
@@ -141,49 +149,21 @@ export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, r
     ContentProps = props.ContentProps,
     endIcon = props.endIcon,
     expandIcon = props.expandIcon,
-    disabledProp = props.disabled,
     icon = props.icon,
-    idProp = props.id,
-    label = props.label,
     nodeId = props.nodeId,
+    id = props.id,
+    label = props.label,
     onClick = props.onClick,
     onMouseDown = props.onMouseDown,
     _props$TransitionComp = props.TransitionComponent,
     TransitionComponent = _props$TransitionComp === void 0 ? Collapse : _props$TransitionComp,
     TransitionProps = props.TransitionProps,
     other = _objectWithoutProperties(props, _excluded);
-  var _useTreeViewContext = useTreeViewContext(),
-    contextIcons = _useTreeViewContext.icons,
-    multiSelect = _useTreeViewContext.multiSelect,
-    disabledItemsFocusable = _useTreeViewContext.disabledItemsFocusable,
-    treeId = _useTreeViewContext.treeId,
-    instance = _useTreeViewContext.instance;
-  var id;
-  if (idProp != null) {
-    id = idProp;
-  } else if (treeId && nodeId) {
-    id = "".concat(treeId, "-").concat(nodeId);
-  }
-  var _React$useState = React.useState(null),
-    _React$useState2 = _slicedToArray(_React$useState, 2),
-    treeItemElement = _React$useState2[0],
-    setTreeItemElement = _React$useState2[1];
-  var contentRef = React.useRef(null);
-  var handleRef = useForkRef(setTreeItemElement, ref);
-  var descendant = React.useMemo(function () {
-    return {
-      element: treeItemElement,
-      id: nodeId
-    };
-  }, [nodeId, treeItemElement]);
-  var _useDescendant = useDescendant(descendant),
-    index = _useDescendant.index,
-    parentId = _useDescendant.parentId;
   var expandable = Boolean(Array.isArray(children) ? children.length : children);
-  var expanded = instance ? instance.isNodeExpanded(nodeId) : false;
-  var focused = instance ? instance.isNodeFocused(nodeId) : false;
-  var selected = instance ? instance.isNodeSelected(nodeId) : false;
-  var disabled = instance ? instance.isNodeDisabled(nodeId) : false;
+  var expanded = instance.isNodeExpanded(nodeId);
+  var focused = instance.isNodeFocused(nodeId);
+  var selected = instance.isNodeSelected(nodeId);
+  var disabled = instance.isNodeDisabled(nodeId);
   var ownerState = _extends({}, props, {
     expanded: expanded,
     focused: focused,
@@ -205,30 +185,6 @@ export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, r
   } else {
     displayIcon = endIcon || contextIcons.defaultEndIcon;
   }
-  React.useEffect(function () {
-    // On the first render a node's index will be -1. We want to wait for the real index.
-    if (instance && index !== -1) {
-      instance.updateNode({
-        id: nodeId,
-        idAttribute: id,
-        index: index,
-        parentId: parentId,
-        expandable: expandable,
-        disabled: disabledProp
-      });
-      return function () {
-        return instance.removeNode(nodeId);
-      };
-    }
-    return undefined;
-  }, [instance, parentId, index, nodeId, expandable, disabledProp, id]);
-  React.useEffect(function () {
-    if (instance && label) {
-      var _contentRef$current$t, _contentRef$current;
-      return instance.mapFirstChar(nodeId, ((_contentRef$current$t = (_contentRef$current = contentRef.current) == null ? void 0 : _contentRef$current.textContent) != null ? _contentRef$current$t : '').substring(0, 1).toLowerCase());
-    }
-    return undefined;
-  }, [instance, nodeId, label]);
   var ariaSelected;
   if (multiSelect) {
     ariaSelected = selected;
@@ -244,36 +200,28 @@ export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, r
   function handleFocus(event) {
     // DOM focus stays on the tree which manages focus with aria-activedescendant
     if (event.target === event.currentTarget) {
-      var rootElement;
-      if (typeof event.target.getRootNode === 'function') {
-        rootElement = event.target.getRootNode();
-      } else {
-        rootElement = ownerDocument(event.target);
-      }
-      rootElement.getElementById(treeId).focus({
-        preventScroll: true
-      });
+      instance.focusRoot();
     }
-    var unfocusable = !disabledItemsFocusable && disabled;
-    if (instance && !focused && event.currentTarget === event.target && !unfocusable) {
+    var canBeFocused = !disabled || disabledItemsFocusable;
+    if (!focused && canBeFocused && event.currentTarget === event.target) {
       instance.focusNode(event, nodeId);
     }
   }
-  return /*#__PURE__*/_jsxs(TreeItemRoot, _extends({
+  var idAttribute = instance.getTreeItemId(nodeId, id);
+  var item = /*#__PURE__*/_jsxs(TreeItemRoot, _extends({
     className: clsx(classes.root, className),
     role: "treeitem",
     "aria-expanded": expandable ? expanded : undefined,
     "aria-selected": ariaSelected,
     "aria-disabled": disabled || undefined,
-    id: id,
+    id: idAttribute,
     tabIndex: -1
   }, other, {
     ownerState: ownerState,
     onFocus: handleFocus,
-    ref: handleRef,
+    ref: ref,
     children: [/*#__PURE__*/_jsx(StyledTreeItemContent, _extends({
       as: ContentComponent,
-      ref: contentRef,
       classes: {
         root: classes.content,
         expanded: classes.expanded,
@@ -291,22 +239,20 @@ export var TreeItem = /*#__PURE__*/React.forwardRef(function TreeItem(inProps, r
       expansionIcon: expansionIcon,
       displayIcon: displayIcon,
       ownerState: ownerState
-    }, ContentProps)), children && /*#__PURE__*/_jsx(DescendantProvider, {
-      id: nodeId,
-      children: /*#__PURE__*/_jsx(TreeItemGroup, _extends({
-        as: TransitionComponent,
-        unmountOnExit: true,
-        className: classes.group,
-        in: expanded,
-        component: "ul",
-        role: "group"
-      }, TransitionProps, {
-        children: children
-      }))
-    })]
+    }, ContentProps)), children && /*#__PURE__*/_jsx(TreeItemGroup, _extends({
+      as: TransitionComponent,
+      unmountOnExit: true,
+      className: classes.group,
+      in: expanded,
+      component: "ul",
+      role: "group"
+    }, TransitionProps, {
+      children: children
+    }))]
   }));
+  return wrapItem(item);
 });
-process.env.NODE_ENV !== "production" ? TreeItem.propTypes = {
+TreeItem.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "yarn proptypes"  |
@@ -381,4 +327,4 @@ process.env.NODE_ENV !== "production" ? TreeItem.propTypes = {
    * By default, the element is based on this [`Transition`](http://reactcommunity.org/react-transition-group/transition/) component.
    */
   TransitionProps: PropTypes.object
-} : void 0;
+};

package/legacy/TreeItem/index.js

@@ -1,4 +1,4 @@
-export * from './TreeItem';
-export * from './useTreeItem';
+export { TreeItem } from './TreeItem';
 export * from './treeItemClasses';
+export * from './useTreeItem';
 export { TreeItemContent } from './TreeItemContent';

package/legacy/TreeItem/useTreeItem.js

@@ -3,11 +3,11 @@ export function useTreeItem(nodeId) {
   var _useTreeViewContext = useTreeViewContext(),
     instance = _useTreeViewContext.instance,
     multiSelect = _useTreeViewContext.multiSelect;
-  var expandable = instance ? instance.isNodeExpandable(nodeId) : false;
-  var expanded = instance ? instance.isNodeExpanded(nodeId) : false;
-  var focused = instance ? instance.isNodeFocused(nodeId) : false;
-  var selected = instance ? instance.isNodeSelected(nodeId) : false;
-  var disabled = instance ? instance.isNodeDisabled(nodeId) : false;
+  var expandable = instance.isNodeExpandable(nodeId);
+  var expanded = instance.isNodeExpanded(nodeId);
+  var focused = instance.isNodeFocused(nodeId);
+  var selected = instance.isNodeSelected(nodeId);
+  var disabled = instance.isNodeDisabled(nodeId);
   var handleExpansion = function handleExpansion(event) {
     if (instance && !disabled) {
       if (!focused) {

package/legacy/TreeView/TreeView.js

@@ -1,15 +1,10 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
-import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
-var _excluded = ["disabledItemsFocusable", "expanded", "defaultExpanded", "onNodeToggle", "onNodeFocus", "disableSelection", "defaultSelected", "selected", "multiSelect", "onNodeSelect", "id", "defaultCollapseIcon", "defaultEndIcon", "defaultExpandIcon", "defaultParentIcon", "children"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { styled, useThemeProps } from '@mui/material/styles';
 import composeClasses from '@mui/utils/composeClasses';
-import { useSlotProps } from '@mui/base/utils';
 import { getTreeViewUtilityClass } from './treeViewClasses';
-import { useTreeView } from '../internals/useTreeView';
-import { TreeViewProvider } from '../internals/TreeViewProvider';
-import { DEFAULT_TREE_VIEW_PLUGINS } from '../internals/plugins';
+import { SimpleTreeView, SimpleTreeViewRoot } from '../SimpleTreeView';
 import { jsx as _jsx } from "react/jsx-runtime";
 var useUtilityClasses = function useUtilityClasses(ownerState) {
   var classes = ownerState.classes;
@@ -18,19 +13,24 @@ var useUtilityClasses = function useUtilityClasses(ownerState) {
   };
   return composeClasses(slots, getTreeViewUtilityClass, classes);
 };
-var TreeViewRoot = styled('ul', {
+var TreeViewRoot = styled(SimpleTreeViewRoot, {
   name: 'MuiTreeView',
   slot: 'Root',
   overridesResolver: function overridesResolver(props, styles) {
     return styles.root;
   }
-})({
-  padding: 0,
-  margin: 0,
-  listStyle: 'none',
-  outline: 0
-});
+})({});
+var warnedOnce = false;
+var warn = function warn() {
+  if (!warnedOnce) {
+    console.warn(['MUI X: The TreeView component was renamed SimpleTreeView.', 'The component with the old naming will be removed in the version v8.0.0.', '', "You should use `import { SimpleTreeView } from '@mui/x-tree-view'`", "or `import { SimpleTreeView } from '@mui/x-tree-view/TreeView'`"].join('\n'));
+    warnedOnce = true;
+  }
+};
+
 /**
+ * This component has been deprecated in favor of the new `SimpleTreeView` component.
+ * You can have a look at how to migrate to the new component in the v7 [migration guide](https://next.mui.com/x/migration/migration-tree-view-v6/#use-simpletreeview-instead-of-treeview)
  *
  * Demos:
  *
@@ -39,67 +39,25 @@ var TreeViewRoot = styled('ul', {
  * API:
  *
  * - [TreeView API](https://mui.com/x/api/tree-view/tree-view/)
+ *
+ * @deprecated
  */
 var TreeView = /*#__PURE__*/React.forwardRef(function TreeView(inProps, ref) {
-  var themeProps = useThemeProps({
+  if (process.env.NODE_ENV !== 'production' && process.env.NODE_ENV !== 'test') {
+    warn();
+  }
+  var props = useThemeProps({
     props: inProps,
     name: 'MuiTreeView'
   });
-  var ownerState = themeProps;
-  var _ref = themeProps,
-    disabledItemsFocusable = _ref.disabledItemsFocusable,
-    expanded = _ref.expanded,
-    defaultExpanded = _ref.defaultExpanded,
-    onNodeToggle = _ref.onNodeToggle,
-    onNodeFocus = _ref.onNodeFocus,
-    disableSelection = _ref.disableSelection,
-    defaultSelected = _ref.defaultSelected,
-    selected = _ref.selected,
-    multiSelect = _ref.multiSelect,
-    onNodeSelect = _ref.onNodeSelect,
-    id = _ref.id,
-    defaultCollapseIcon = _ref.defaultCollapseIcon,
-    defaultEndIcon = _ref.defaultEndIcon,
-    defaultExpandIcon = _ref.defaultExpandIcon,
-    defaultParentIcon = _ref.defaultParentIcon,
-    children = _ref.children,
-    other = _objectWithoutProperties(_ref, _excluded);
-  var _useTreeView = useTreeView({
-      disabledItemsFocusable: disabledItemsFocusable,
-      expanded: expanded,
-      defaultExpanded: defaultExpanded,
-      onNodeToggle: onNodeToggle,
-      onNodeFocus: onNodeFocus,
-      disableSelection: disableSelection,
-      defaultSelected: defaultSelected,
-      selected: selected,
-      multiSelect: multiSelect,
-      onNodeSelect: onNodeSelect,
-      id: id,
-      defaultCollapseIcon: defaultCollapseIcon,
-      defaultEndIcon: defaultEndIcon,
-      defaultExpandIcon: defaultExpandIcon,
-      defaultParentIcon: defaultParentIcon,
-      plugins: DEFAULT_TREE_VIEW_PLUGINS,
-      rootRef: ref
-    }),
-    getRootProps = _useTreeView.getRootProps,
-    contextValue = _useTreeView.contextValue;
-  var classes = useUtilityClasses(themeProps);
-  var rootProps = useSlotProps({
-    elementType: TreeViewRoot,
-    externalSlotProps: {},
-    externalForwardedProps: other,
-    className: classes.root,
-    getSlotProps: getRootProps,
-    ownerState: ownerState
-  });
-  return /*#__PURE__*/_jsx(TreeViewProvider, {
-    value: contextValue,
-    children: /*#__PURE__*/_jsx(TreeViewRoot, _extends({}, rootProps, {
-      children: children
-    }))
-  });
+  var classes = useUtilityClasses(props);
+  return /*#__PURE__*/_jsx(SimpleTreeView, _extends({}, props, {
+    ref: ref,
+    classes: classes,
+    slots: _extends({
+      root: TreeViewRoot
+    }, props.slots)
+  }));
 });
 process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
   // ----------------------------- Warning --------------------------------
@@ -132,7 +90,7 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
    * Used when the item's expansion is not controlled.
    * @default []
    */
-  defaultExpanded: PropTypes.arrayOf(PropTypes.string),
+  defaultExpandedNodes: PropTypes.arrayOf(PropTypes.string),
   /**
    * The default icon used to expand the node.
    */
@@ -147,7 +105,7 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
    * When `multiSelect` is true this takes an array of strings; when false (default) a string.
    * @default []
    */
-  defaultSelected: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.string]),
+  defaultSelectedNodes: PropTypes.any,
   /**
    * If `true`, will allow focus on disabled items.
    * @default false
@@ -162,7 +120,25 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
    * Expanded node ids.
    * Used when the item's expansion is controlled.
    */
-  expanded: PropTypes.arrayOf(PropTypes.string),
+  expandedNodes: PropTypes.arrayOf(PropTypes.string),
+  /**
+   * Used to determine the string label for a given item.
+   *
+   * @template R
+   * @param {R} item The item to check.
+   * @returns {string} The id of the item.
+   * @default `(item) => item.id`
+   */
+  getItemId: PropTypes.func,
+  /**
+   * Used to determine the string label for a given item.
+   *
+   * @template R
+   * @param {R} item The item to check.
+   * @returns {string} The label of the item.
+   * @default `(item) => item.label`
+   */
+  getItemLabel: PropTypes.func,
   /**
    * This prop is used to help implement the accessibility logic.
    * If you don't provide this prop. It falls back to a randomly generated id.
@@ -173,6 +149,19 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
    * @default false
    */
   multiSelect: PropTypes.bool,
+  /**
+   * Callback fired when tree items are expanded/collapsed.
+   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {array} nodeIds The ids of the expanded nodes.
+   */
+  onExpandedNodesChange: PropTypes.func,
+  /**
+   * Callback fired when a tree item is expanded or collapsed.
+   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {array} nodeId The nodeId of the modified node.
+   * @param {array} isExpanded `true` if the node has just been expanded, `false` if it has just been collapsed.
+   */
+  onNodeExpansionToggle: PropTypes.func,
   /**
    * Callback fired when tree items are focused.
    * @param {React.SyntheticEvent} event The event source of the callback **Warning**: This is a generic event not a focus event.
@@ -181,23 +170,32 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
    */
   onNodeFocus: PropTypes.func,
   /**
-   * Callback fired when tree items are selected/unselected.
-   * @param {React.SyntheticEvent} event The event source of the callback
-   * @param {string[] | string} nodeIds Ids of the selected nodes. When `multiSelect` is true
-   * this is an array of strings; when false (default) a string.
+   * Callback fired when a tree item is selected or deselected.
+   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {array} nodeId The nodeId of the modified node.
+   * @param {array} isSelected `true` if the node has just been selected, `false` if it has just been deselected.
    */
-  onNodeSelect: PropTypes.func,
+  onNodeSelectionToggle: PropTypes.func,
   /**
-   * Callback fired when tree items are expanded/collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
-   * @param {array} nodeIds The ids of the expanded nodes.
+   * Callback fired when tree items are selected/deselected.
+   * @param {React.SyntheticEvent} event The event source of the callback
+   * @param {string[] | string} nodeIds The ids of the selected nodes.
+   * When `multiSelect` is `true`, this is an array of strings; when false (default) a string.
    */
-  onNodeToggle: PropTypes.func,
+  onSelectedNodesChange: PropTypes.func,
   /**
    * Selected node ids. (Controlled)
    * When `multiSelect` is true this takes an array of strings; when false (default) a string.
    */
-  selected: PropTypes.any,
+  selectedNodes: PropTypes.any,
+  /**
+   * The props used for each component slot.
+   */
+  slotProps: PropTypes.object,
+  /**
+   * Overridable component slots.
+   */
+  slots: PropTypes.object,
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */

package/legacy/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-tree-view v7.0.0-alpha.1
+ * @mui/x-tree-view v7.0.0-alpha.8
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -7,4 +7,7 @@
  */
 export * from './TreeItem';
 export * from './TreeView';
-export { unstable_resetCleanupTracking } from './internals/hooks/useInstanceEventHandler';
+export * from './SimpleTreeView';
+export * from './RichTreeView';
+export { unstable_resetCleanupTracking } from './internals/hooks/useInstanceEventHandler';
+export * from './models';

package/legacy/internals/TreeViewProvider/TreeViewContext.js

@@ -1,21 +1,8 @@
 import * as React from 'react';
-export var DEFAULT_TREE_VIEW_CONTEXT_VALUE = {
-  instance: null,
-  multiSelect: false,
-  disabledItemsFocusable: false,
-  treeId: undefined,
-  icons: {
-    defaultCollapseIcon: null,
-    defaultExpandIcon: null,
-    defaultParentIcon: null,
-    defaultEndIcon: null
-  }
-};
-
 /**
  * @ignore - internal component.
  */
-export var TreeViewContext = /*#__PURE__*/React.createContext(DEFAULT_TREE_VIEW_CONTEXT_VALUE);
+export var TreeViewContext = /*#__PURE__*/React.createContext(null);
 if (process.env.NODE_ENV !== 'production') {
   TreeViewContext.displayName = 'TreeViewContext';
 }

package/legacy/internals/TreeViewProvider/useTreeViewContext.js

@@ -1,5 +1,9 @@
 import * as React from 'react';
 import { TreeViewContext } from './TreeViewContext';
 export var useTreeViewContext = function useTreeViewContext() {
-  return React.useContext(TreeViewContext);
+  var context = React.useContext(TreeViewContext);
+  if (context == null) {
+    throw new Error(['MUI X: Could not find the Tree View context.', 'It looks like you rendered your component outside of a SimpleTreeView or RichTreeView parent component.', 'This can also happen if you are bundling multiple versions of the Tree View.'].join('\n'));
+  }
+  return context;
 };

package/legacy/internals/corePlugins/corePlugins.js

@@ -1,6 +1,6 @@
 import { useTreeViewInstanceEvents } from './useTreeViewInstanceEvents';
 /**
- * Internal plugins that creates the tools used by the other plugins.
+ * Internal plugins that create the tools used by the other plugins.
  * These plugins are used by the tree view components.
  */
 export var TREE_VIEW_CORE_PLUGINS = [useTreeViewInstanceEvents];

package/legacy/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.js

@@ -5,12 +5,6 @@ import { populateInstance } from '../../useTreeView/useTreeView.utils';
 var isSyntheticEvent = function isSyntheticEvent(event) {
   return event.isPropagationStopped !== undefined;
 };
-
-/**
- * Plugin responsible for the registration of the nodes defined as JSX children of the TreeView.
- * When we will have both a SimpleTreeView using JSX children and a TreeView using a data prop,
- * this plugin will only be used by SimpleTreeView.
- */
 export var useTreeViewInstanceEvents = function useTreeViewInstanceEvents(_ref) {
   var instance = _ref.instance;
   var _React$useState = React.useState(function () {
@@ -42,4 +36,5 @@ export var useTreeViewInstanceEvents = function useTreeViewInstanceEvents(_ref)
     $$publishEvent: publishEvent,
     $$subscribeEvent: subscribeEvent
   });
-};
+};
+useTreeViewInstanceEvents.params = {};

package/legacy/internals/hooks/useLazyRef.js

@@ -0,0 +1,11 @@
+import * as React from 'react';
+var UNINITIALIZED = {};
+
+// See https://github.com/facebook/react/issues/14490 for when to use this.
+export function useLazyRef(init, initArg) {
+  var ref = React.useRef(UNINITIALIZED);
+  if (ref.current === UNINITIALIZED) {
+    ref.current = init(initArg);
+  }
+  return ref;
+}

package/legacy/internals/hooks/useOnMount.js

@@ -0,0 +1,7 @@
+import * as React from 'react';
+var EMPTY = [];
+export function useOnMount(fn) {
+  /* eslint-disable react-hooks/exhaustive-deps */
+  React.useEffect(fn, EMPTY);
+  /* eslint-enable react-hooks/exhaustive-deps */
+}