@mui/x-tree-view 9.10.1 → 9.11.0

package/CHANGELOG.md

@@ -1,5 +1,123 @@
 # Changelog
 
+## 9.11.0
+
+_Aug 6, 2026_
+
+We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
+
+- ✨ Add `addItems()` and `getItemSelection()` API methods to Tree View
+
+Special thanks go out to these community members for their valuable contributions:
+@12joan, @Anexus5919, @kevincorizi-sbt, @mixelburg, @mustafajw07, @strazto
+
+The following team members contributed to this release:
+@flaviendelangle, @hasdfa, @JCQuintas, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @rita-codes
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.11.0`
+
+- [DataGrid] Fix `updateRows` stripping class prototypes from rows in datasource mode (#22288) @mixelburg
+- [DataGrid] Do not re-fetch data when an `Activity` becomes visible (#22603) @12joan
+- [DataGrid] Fix toolbar button stealing focus when a sibling's disabled state changes (#23204) @MBilalShafi
+
+#### `@mui/x-data-grid-pro@9.11.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.11.0`.
+
+#### `@mui/x-data-grid-premium@9.11.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.11.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.11.0`
+
+- [pickers] Fix day shift when editing dates predating timezone standardization (#23296) @JCQuintas
+
+#### `@mui/x-date-pickers-pro@9.11.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.11.0`, plus:
+
+- [DateRangePicker] Fix disabled filler cells showing the range highlight (#23293) @JCQuintas
+
+### Charts
+
+#### `@mui/x-charts@9.11.0`
+
+- [charts] Activate the focused item with `Enter`/`Space` (#23218) @JCQuintas
+- [charts] Extract the axis click payload builders (#23215) @JCQuintas
+- [charts] Fix `GestureManager` event listener leak on chart unmount (#23283) @kevincorizi-sbt
+- [charts] Fix `slotProps.legend.position` and `direction` in `RadarChart` (#23254) @JCQuintas
+- [charts] Fix axis clicks being discarded on slight pointer movement (#23244) @noraleonte
+- [charts] Fix image export of charts sized by their parent element (#23255) @JCQuintas
+- [charts] Forward `experimentalFeatures` on `RadarChart` and `Heatmap` (#23216) @JCQuintas
+- [charts] Hide focus indicator when the chart loses focus (#23213) @JCQuintas
+
+#### `@mui/x-charts-pro@9.11.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.11.0`.
+
+#### `@mui/x-charts-premium@9.11.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.11.0`, plus:
+
+- [charts-premium] Fix `RangeBar` type override (#23217) @JCQuintas
+
+### Tree View
+
+#### `@mui/x-tree-view@9.11.0`
+
+- [tree view] Add `addItems()` API method (#23159) @JCQuintas
+- [tree view] Add `getItemSelection` API method (#23257) @noraleonte
+- [tree view] Ignore `keepExistingSelection` when `multiSelect` is `false` (#23242) @JCQuintas
+- [tree view] Prevent duplicate ids in multi-select arrow navigation (#23006) @Anexus5919
+
+#### `@mui/x-tree-view-pro@9.11.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@9.11.0`, plus:
+
+- [tree view] Discard superseded lazy-loading responses (#23005) @Anexus5919
+
+### Scheduler
+
+#### `@mui/x-scheduler@9.0.0-beta.8`
+
+- [scheduler] Add `localeText` prop to standalone views (#23210) @rita-codes
+- [scheduler] Finetune touch experience for time grid events and introduce editing drawer (#22624) @noraleonte
+- [scheduler] Introduce the edit dialog form context & lifecycle contract (#23284) @rita-codes
+- [scheduler] Refactor edit dialog General tab into section components (#23206) @rita-codes
+- [scheduler] Replace copied Base UI internals with `@base-ui/react/internals` imports (#21972) @flaviendelangle
+- [scheduler] Hide resource picker when no resources are provided (#23290) @mustafajw07
+- [scheduler] Support multi-resource occurrences in `EventTimeline` (#23240) @mustafajw07
+
+#### `@mui/x-scheduler-premium@9.0.0-beta.8` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-scheduler@9.0.0-beta.8`.
+
+### Codemod
+
+#### `@mui/x-codemod@9.11.0`
+
+- [codemod] Remove unused `@babel/core` and `@babel/traverse` dependencies (#23245) @LukasTy
+
+### Docs
+
+- [docs] Add recipe for adding new rows from clipboard copy (#22913) @michelengelen
+- [docs] Clarify the package versions in v8 upgrade guides (#22376) @strazto
+- [docs] Replace README peer dependency lists with an npm install command (#23256) @LukasTy
+
+### Core
+
+- [code-infra] Align action pin version comments (#23238) @LukasTy
+
+### Miscellaneous
+
+- [chat] Drop the undeclared `@mui/icons-material` dependency (#23252) @LukasTy
+- [chat] Sanitize image part URLs and share the URL allow-list with markdown (#23058) @hasdfa
+- [test] Type the `PickersTextField` test stub instead of `as any` (#23194) @LukasTy
+
 ## 9.10.1
 
 _Jul 23, 2026_

package/README.md

@@ -8,17 +8,7 @@ It's part of [MUI X](https://mui.com/x/), an open-core extension of our Core li
 Install the package in your project directory with:
 
 ```bash
-npm install @mui/x-tree-view
-```
-
-This component has the following peer dependencies that you need to install as well.
-
-```json
-"peerDependencies": {
-  "@mui/material": "^5.15.14 || ^6.0.0 || ^7.0.0",
-  "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
-  "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0"
-},
+npm install @mui/x-tree-view @mui/material @emotion/react @emotion/styled
 ```
 
 ## Documentation

package/RichTreeView/RichTreeView.js

@@ -143,10 +143,12 @@ process.env.NODE_ENV !== "production" ? RichTreeView.propTypes /* remove-proptyp
    */
   apiRef: _propTypes.default.shape({
     current: _propTypes.default.shape({
+      addItems: _propTypes.default.func,
       focusItem: _propTypes.default.func,
       getItem: _propTypes.default.func,
       getItemDOMElement: _propTypes.default.func,
       getItemOrderedChildrenIds: _propTypes.default.func,
+      getItemSelection: _propTypes.default.func,
       getItemTree: _propTypes.default.func,
       getParentId: _propTypes.default.func,
       isItemExpanded: _propTypes.default.func,

package/RichTreeView/RichTreeView.mjs

@@ -136,10 +136,12 @@ process.env.NODE_ENV !== "production" ? RichTreeView.propTypes /* remove-proptyp
    */
   apiRef: PropTypes.shape({
     current: PropTypes.shape({
+      addItems: PropTypes.func,
       focusItem: PropTypes.func,
       getItem: PropTypes.func,
       getItemDOMElement: PropTypes.func,
       getItemOrderedChildrenIds: PropTypes.func,
+      getItemSelection: PropTypes.func,
       getItemTree: PropTypes.func,
       getParentId: PropTypes.func,
       isItemExpanded: PropTypes.func,

package/SimpleTreeView/SimpleTreeView.js

@@ -127,6 +127,7 @@ process.env.NODE_ENV !== "production" ? SimpleTreeView.propTypes /* remove-propt
       getItem: _propTypes.default.func,
       getItemDOMElement: _propTypes.default.func,
       getItemOrderedChildrenIds: _propTypes.default.func,
+      getItemSelection: _propTypes.default.func,
       getItemTree: _propTypes.default.func,
       getParentId: _propTypes.default.func,
       isItemExpanded: _propTypes.default.func,

package/SimpleTreeView/SimpleTreeView.mjs

@@ -120,6 +120,7 @@ process.env.NODE_ENV !== "production" ? SimpleTreeView.propTypes /* remove-propt
       getItem: PropTypes.func,
       getItemDOMElement: PropTypes.func,
       getItemOrderedChildrenIds: PropTypes.func,
+      getItemSelection: PropTypes.func,
       getItemTree: PropTypes.func,
       getParentId: PropTypes.func,
       isItemExpanded: PropTypes.func,

package/TreeItemIcon/TreeItemIcon.js

@@ -90,6 +90,7 @@ process.env.NODE_ENV !== "production" ? TreeItemIcon.propTypes /* remove-proptyp
     expandable: _propTypes.default.bool.isRequired,
     expanded: _propTypes.default.bool.isRequired,
     focused: _propTypes.default.bool.isRequired,
+    indeterminate: _propTypes.default.bool,
     loading: _propTypes.default.bool.isRequired,
     selected: _propTypes.default.bool.isRequired
   }).isRequired

package/TreeItemIcon/TreeItemIcon.mjs

@@ -83,6 +83,7 @@ process.env.NODE_ENV !== "production" ? TreeItemIcon.propTypes /* remove-proptyp
     expandable: PropTypes.bool.isRequired,
     expanded: PropTypes.bool.isRequired,
     focused: PropTypes.bool.isRequired,
+    indeterminate: PropTypes.bool,
     loading: PropTypes.bool.isRequired,
     selected: PropTypes.bool.isRequired
   }).isRequired

package/hooks/useTreeItemUtils/useTreeItemUtils.js

@@ -35,6 +35,7 @@ const useTreeItemUtils = ({
   const isExpanded = (0, _store.useStore)(store, _selectors.expansionSelectors.isItemExpanded, itemId);
   const isFocused = (0, _store.useStore)(store, _selectors2.focusSelectors.isItemFocused, itemId);
   const isSelected = (0, _store.useStore)(store, _selectors4.selectionSelectors.isItemSelected, itemId);
+  const isIndeterminate = (0, _store.useStore)(store, _selectors4.selectionSelectors.isItemIndeterminate, itemId);
   const isDisabled = (0, _store.useStore)(store, _selectors3.itemsSelectors.isItemDisabled, itemId);
   const isEditing = (0, _store.useStore)(store, _selectors6.labelSelectors.isItemBeingEdited, itemId);
   const isEditable = (0, _store.useStore)(store, _selectors6.labelSelectors.isItemEditable, itemId);
@@ -43,6 +44,7 @@ const useTreeItemUtils = ({
     expanded: isExpanded,
     focused: isFocused,
     selected: isSelected,
+    indeterminate: isIndeterminate,
     disabled: isDisabled,
     editing: isEditing,
     editable: isEditable,

package/hooks/useTreeItemUtils/useTreeItemUtils.mjs

@@ -29,6 +29,7 @@ export const useTreeItemUtils = ({
   const isExpanded = useStore(store, expansionSelectors.isItemExpanded, itemId);
   const isFocused = useStore(store, focusSelectors.isItemFocused, itemId);
   const isSelected = useStore(store, selectionSelectors.isItemSelected, itemId);
+  const isIndeterminate = useStore(store, selectionSelectors.isItemIndeterminate, itemId);
   const isDisabled = useStore(store, itemsSelectors.isItemDisabled, itemId);
   const isEditing = useStore(store, labelSelectors.isItemBeingEdited, itemId);
   const isEditable = useStore(store, labelSelectors.isItemEditable, itemId);
@@ -37,6 +38,7 @@ export const useTreeItemUtils = ({
     expanded: isExpanded,
     focused: isFocused,
     selected: isSelected,
+    indeterminate: isIndeterminate,
     disabled: isDisabled,
     editing: isEditing,
     editable: isEditable,

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-tree-view v9.10.1
+ * @mui/x-tree-view v9.11.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-tree-view v9.10.1
+ * @mui/x-tree-view v9.11.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/MinimalTreeViewStore/MinimalTreeViewStore.d.mts

@@ -52,6 +52,7 @@ export declare class MinimalTreeViewStore<R extends TreeViewValidItem<R>, Multip
       shouldBeExpanded?: boolean;
     }) => void;
     focusItem: (event: React.SyntheticEvent | null, itemId: import("../../index.mjs").TreeViewItemId) => void;
+    getItemSelection: (itemId: import("../../index.mjs").TreeViewItemId) => import("../../index.mjs").TreeViewItemSelectionStatus;
     setItemSelection: ({
       itemId,
       event,

package/internals/MinimalTreeViewStore/MinimalTreeViewStore.d.ts

@@ -52,6 +52,7 @@ export declare class MinimalTreeViewStore<R extends TreeViewValidItem<R>, Multip
       shouldBeExpanded?: boolean;
     }) => void;
     focusItem: (event: React.SyntheticEvent | null, itemId: import("../../index.js").TreeViewItemId) => void;
+    getItemSelection: (itemId: import("../../index.js").TreeViewItemId) => import("../../index.js").TreeViewItemSelectionStatus;
     setItemSelection: ({
       itemId,
       event,

package/internals/RichTreeViewStore/RichTreeViewStore.d.mts

@@ -1,7 +1,7 @@
 import type { TreeViewValidItem } from "../../models/index.mjs";
-import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.mjs";
 import { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.mjs";
-import type { RichTreeViewStoreParameters, RichTreeViewState } from "./RichTreeViewStore.types.mjs";
+import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.mjs";
+import type { RichTreeViewState, RichTreeViewStoreParameters } from "./RichTreeViewStore.types.mjs";
 export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>, Multiple extends boolean | undefined, State extends RichTreeViewState<R, Multiple> = RichTreeViewState<R, Multiple>, Parameters extends RichTreeViewStoreParameters<R, Multiple> = RichTreeViewStoreParameters<R, Multiple>> extends MinimalTreeViewStore<R, Multiple, State, Parameters> {
   labelEditing: TreeViewLabelEditingPlugin;
   /**
@@ -24,6 +24,11 @@ export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>,
       itemId: import("../../index.mjs").TreeViewItemId;
       shouldBeDisabled?: boolean;
     }) => void;
+    addItems: ({
+      items,
+      parentId,
+      index
+    }: import("../plugins/items/index.mjs").AddItemsParameters<R>) => void;
     isItemExpanded: (itemId: import("../../index.mjs").TreeViewItemId) => boolean;
     setItemExpansion: ({
       itemId,
@@ -35,6 +40,7 @@ export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>,
       shouldBeExpanded?: boolean;
     }) => void;
     focusItem: (event: React.SyntheticEvent | null, itemId: import("../../index.mjs").TreeViewItemId) => void;
+    getItemSelection: (itemId: import("../../index.mjs").TreeViewItemId) => import("../../index.mjs").TreeViewItemSelectionStatus;
     setItemSelection: ({
       itemId,
       event,

package/internals/RichTreeViewStore/RichTreeViewStore.d.ts

@@ -1,7 +1,7 @@
 import type { TreeViewValidItem } from "../../models/index.js";
-import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.js";
 import { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.js";
-import type { RichTreeViewStoreParameters, RichTreeViewState } from "./RichTreeViewStore.types.js";
+import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.js";
+import type { RichTreeViewState, RichTreeViewStoreParameters } from "./RichTreeViewStore.types.js";
 export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>, Multiple extends boolean | undefined, State extends RichTreeViewState<R, Multiple> = RichTreeViewState<R, Multiple>, Parameters extends RichTreeViewStoreParameters<R, Multiple> = RichTreeViewStoreParameters<R, Multiple>> extends MinimalTreeViewStore<R, Multiple, State, Parameters> {
   labelEditing: TreeViewLabelEditingPlugin;
   /**
@@ -24,6 +24,11 @@ export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>,
       itemId: import("../../index.js").TreeViewItemId;
       shouldBeDisabled?: boolean;
     }) => void;
+    addItems: ({
+      items,
+      parentId,
+      index
+    }: import("../plugins/items/index.js").AddItemsParameters<R>) => void;
     isItemExpanded: (itemId: import("../../index.js").TreeViewItemId) => boolean;
     setItemExpansion: ({
       itemId,
@@ -35,6 +40,7 @@ export declare class ExtendableRichTreeViewStore<R extends TreeViewValidItem<R>,
       shouldBeExpanded?: boolean;
     }) => void;
     focusItem: (event: React.SyntheticEvent | null, itemId: import("../../index.js").TreeViewItemId) => void;
+    getItemSelection: (itemId: import("../../index.js").TreeViewItemId) => import("../../index.js").TreeViewItemSelectionStatus;
     setItemSelection: ({
       itemId,
       event,

package/internals/RichTreeViewStore/RichTreeViewStore.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.RichTreeViewStore = exports.ExtendableRichTreeViewStore = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var _labelEditing = require("../plugins/labelEditing");
 var _MinimalTreeViewStore = require("../MinimalTreeViewStore");
+var _labelEditing = require("../plugins/labelEditing");
 var _RichTreeViewStore = require("./RichTreeViewStore.utils");
 class ExtendableRichTreeViewStore extends _MinimalTreeViewStore.MinimalTreeViewStore {
   labelEditing = new _labelEditing.TreeViewLabelEditingPlugin(this);
@@ -18,7 +18,10 @@ class ExtendableRichTreeViewStore extends _MinimalTreeViewStore.MinimalTreeViewS
    */
   static rawMapper = _RichTreeViewStore.parametersToStateMapper;
   buildPublicAPI() {
-    return (0, _extends2.default)({}, super.buildPublicAPI(), this.labelEditing.buildPublicAPI());
+    return (0, _extends2.default)({}, super.buildPublicAPI(), this.labelEditing.buildPublicAPI(), {
+      // `addItems` is not exposed on the Simple Tree View, where the items are defined with JSX.
+      addItems: this.items.addItems
+    });
   }
 }
 exports.ExtendableRichTreeViewStore = ExtendableRichTreeViewStore;

package/internals/RichTreeViewStore/RichTreeViewStore.mjs

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
-import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.mjs";
 import { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.mjs";
+import { TreeViewLabelEditingPlugin } from "../plugins/labelEditing/index.mjs";
 import { parametersToStateMapper } from "./RichTreeViewStore.utils.mjs";
 export class ExtendableRichTreeViewStore extends MinimalTreeViewStore {
   labelEditing = new TreeViewLabelEditingPlugin(this);
@@ -11,7 +11,10 @@ export class ExtendableRichTreeViewStore extends MinimalTreeViewStore {
    */
   static rawMapper = parametersToStateMapper;
   buildPublicAPI() {
-    return _extends({}, super.buildPublicAPI(), this.labelEditing.buildPublicAPI());
+    return _extends({}, super.buildPublicAPI(), this.labelEditing.buildPublicAPI(), {
+      // `addItems` is not exposed on the Simple Tree View, where the items are defined with JSX.
+      addItems: this.items.addItems
+    });
   }
 }
 export class RichTreeViewStore extends ExtendableRichTreeViewStore {

package/internals/plugins/items/TreeViewItemsPlugin.d.mts

@@ -58,6 +58,16 @@ export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
    * @param {boolean } parameters.shouldBeDisabled true if the item should be disabled.
    */
   private setIsItemDisabled;
+  /**
+   * Add items to the tree.
+   * The items are added as children of the item with the given `parentId`, or at the root level if `parentId` is `null` or not defined.
+   * @param {AddItemsParameters<R>} parameters The items to add and their position in the tree.
+   */
+  addItems: ({
+    items,
+    parentId,
+    index
+  }: AddItemsParameters<R>) => void;
   buildPublicAPI: () => {
     getItem: (itemId: TreeViewItemId) => R;
     getItemDOMElement: (itemId: TreeViewItemId) => HTMLElement | null;
@@ -102,4 +112,21 @@ export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
    * @param {TreeViewItemId} itemId The id of the item being clicked.
    */
   handleItemClick: (event: React.MouseEvent, itemId: TreeViewItemId) => void;
+}
+export interface AddItemsParameters<R extends TreeViewValidItem<R>> {
+  /**
+   * The items to add to the tree.
+   */
+  items: readonly R[];
+  /**
+   * The id of the item to add the items to.
+   * If `null` or not defined, the items are added at the root level.
+   * @default null
+   */
+  parentId?: TreeViewItemId | null;
+  /**
+   * The position in the parent's children at which the items are inserted.
+   * If not defined, the items are appended after the existing children.
+   */
+  index?: number;
 }

package/internals/plugins/items/TreeViewItemsPlugin.d.ts

@@ -58,6 +58,16 @@ export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
    * @param {boolean } parameters.shouldBeDisabled true if the item should be disabled.
    */
   private setIsItemDisabled;
+  /**
+   * Add items to the tree.
+   * The items are added as children of the item with the given `parentId`, or at the root level if `parentId` is `null` or not defined.
+   * @param {AddItemsParameters<R>} parameters The items to add and their position in the tree.
+   */
+  addItems: ({
+    items,
+    parentId,
+    index
+  }: AddItemsParameters<R>) => void;
   buildPublicAPI: () => {
     getItem: (itemId: TreeViewItemId) => R;
     getItemDOMElement: (itemId: TreeViewItemId) => HTMLElement | null;
@@ -102,4 +112,21 @@ export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
    * @param {TreeViewItemId} itemId The id of the item being clicked.
    */
   handleItemClick: (event: React.MouseEvent, itemId: TreeViewItemId) => void;
+}
+export interface AddItemsParameters<R extends TreeViewValidItem<R>> {
+  /**
+   * The items to add to the tree.
+   */
+  items: readonly R[];
+  /**
+   * The id of the item to add the items to.
+   * If `null` or not defined, the items are added at the root level.
+   * @default null
+   */
+  parentId?: TreeViewItemId | null;
+  /**
+   * The position in the parent's children at which the items are inserted.
+   * If not defined, the items are appended after the existing children.
+   */
+  index?: number;
 }

package/internals/plugins/items/TreeViewItemsPlugin.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.TreeViewItemsPlugin = void 0;
+var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _id = require("../id");
 var _selectors = require("./selectors");
@@ -30,41 +31,13 @@ class TreeViewItemsPlugin {
    * Builds the state properties derived from the `items` prop.
    */
   static buildItemsStateIfNeeded = parameters => {
-    const itemMetaLookup = {};
-    const itemModelLookup = {};
-    const itemOrderedChildrenIdsLookup = {};
-    const itemChildrenIndexesLookup = {};
-    function processSiblings(items, parentId, depth) {
-      const parentIdWithDefault = parentId ?? _utils.TREE_VIEW_ROOT_PARENT_ID;
-      const {
-        metaLookup,
-        modelLookup,
-        orderedChildrenIds,
-        childrenIndexes,
-        itemsChildren
-      } = (0, _utils.buildItemsLookups)({
-        storeParameters: parameters,
-        items,
-        parentId,
-        depth,
-        isItemExpandable: (item, children) => !!children && children.length > 0,
-        otherItemsMetaLookup: itemMetaLookup
-      });
-      Object.assign(itemMetaLookup, metaLookup);
-      Object.assign(itemModelLookup, modelLookup);
-      itemOrderedChildrenIdsLookup[parentIdWithDefault] = orderedChildrenIds;
-      itemChildrenIndexesLookup[parentIdWithDefault] = childrenIndexes;
-      for (const item of itemsChildren) {
-        processSiblings(item.children || [], item.id, depth + 1);
-      }
-    }
-    processSiblings(parameters.items, null, 0);
-    return {
-      itemMetaLookup,
-      itemModelLookup,
-      itemOrderedChildrenIdsLookup,
-      itemChildrenIndexesLookup
-    };
+    return (0, _utils.buildItemsLookupsRecursively)({
+      storeParameters: parameters,
+      items: parameters.items,
+      parentId: null,
+      depth: 0,
+      isItemExpandable: (item, children) => !!children && children.length > 0
+    });
   };
 
   /**
@@ -131,6 +104,79 @@ class TreeViewItemsPlugin {
     });
     this.store.set('itemMetaLookup', itemMetaLookup);
   };
+
+  /**
+   * Add items to the tree.
+   * The items are added as children of the item with the given `parentId`, or at the root level if `parentId` is `null` or not defined.
+   * @param {AddItemsParameters<R>} parameters The items to add and their position in the tree.
+   */
+  addItems = ({
+    items,
+    parentId = null,
+    index
+  }) => {
+    if (items.length === 0) {
+      return;
+    }
+    if (parentId != null && _selectors.itemsSelectors.itemMeta(this.store.state, parentId) == null) {
+      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Tree View: Unable to add items to the parent with id "${parentId}" because it is not present in the tree. ` + 'Pass the id of an existing item, or `null` to add the items at the root level.' : (0, _formatErrorMessage2.default)(295, parentId));
+    }
+    const parentDepth = parentId == null ? -1 : _selectors.itemsSelectors.itemDepth(this.store.state, parentId);
+
+    // When the items are lazy loaded, an item can be expandable even if its children are not loaded yet.
+    const dataSource = this.store.parameters.dataSource;
+    const isItemExpandable = (item, children) => {
+      if (children != null && children.length > 0) {
+        return true;
+      }
+      return dataSource == null ? false : dataSource.getChildrenCount(item) !== 0;
+    };
+    const {
+      itemMetaLookup: metaLookup,
+      itemModelLookup: modelLookup,
+      itemOrderedChildrenIdsLookup: orderedChildrenIdsLookup,
+      itemChildrenIndexesLookup: childrenIndexesLookup
+    } = (0, _utils.buildItemsLookupsRecursively)({
+      storeParameters: this.store.parameters,
+      items,
+      parentId,
+      depth: parentDepth + 1,
+      isItemExpandable,
+      existingItemMetaLookup: this.store.state.itemMetaLookup
+    });
+
+    // `buildItemsLookups` allows an id to be re-used by an item with the same parent,
+    // which is only valid when rebuilding the state from the `items` prop.
+    for (const id of Object.keys(metaLookup)) {
+      if (this.store.state.itemMetaLookup[id] != null) {
+        throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Tree View: All items must have a unique \`id\` property. ` + `The id "${id}" is used by multiple items. ` + 'Use the `getItemId` prop to specify a custom id for each item if needed.' : (0, _formatErrorMessage2.default)(194, id));
+      }
+    }
+    const parentIdWithDefault = parentId ?? _utils.TREE_VIEW_ROOT_PARENT_ID;
+    const existingChildrenIds = _selectors.itemsSelectors.itemOrderedChildrenIds(this.store.state, parentId);
+    const insertionIndex = index ?? existingChildrenIds.length;
+    if (insertionIndex < 0 || insertionIndex > existingChildrenIds.length) {
+      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Tree View: Unable to add items at index "${insertionIndex}" because it is out of range. ` + `The index must be between 0 and the amount of children of the parent item (${existingChildrenIds.length}).` : (0, _formatErrorMessage2.default)(296, insertionIndex, existingChildrenIds.length));
+    }
+    const newChildrenIds = orderedChildrenIdsLookup[parentIdWithDefault];
+    const mergedChildrenIds = [...existingChildrenIds];
+    mergedChildrenIds.splice(insertionIndex, 0, ...newChildrenIds);
+    orderedChildrenIdsLookup[parentIdWithDefault] = mergedChildrenIds;
+    childrenIndexesLookup[parentIdWithDefault] = (0, _utils.buildSiblingIndexes)(mergedChildrenIds);
+    const newMetaLookup = (0, _extends2.default)({}, this.store.state.itemMetaLookup, metaLookup);
+    if (parentId != null && !newMetaLookup[parentId].expandable) {
+      newMetaLookup[parentId] = (0, _extends2.default)({}, newMetaLookup[parentId], {
+        expandable: true
+      });
+    }
+    this.store.update({
+      itemMetaLookup: newMetaLookup,
+      itemModelLookup: (0, _extends2.default)({}, this.store.state.itemModelLookup, modelLookup),
+      itemOrderedChildrenIdsLookup: (0, _extends2.default)({}, this.store.state.itemOrderedChildrenIdsLookup, orderedChildrenIdsLookup),
+      itemChildrenIndexesLookup: (0, _extends2.default)({}, this.store.state.itemChildrenIndexesLookup, childrenIndexesLookup)
+    });
+    this.store.selection.propagateSelectionToNewItems(parentId, newChildrenIds);
+  };
   buildPublicAPI = () => {
     return {
       getItem: this.getItem,