@mui/x-tree-view 9.10.0 → 9.11.0

package/CHANGELOG.md

@@ -1,5 +1,229 @@
 # 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_
+
+We'd like to extend a big thank you to the 11 contributors who made this release possible. Here are some highlights ✨:
+
+- 🦮 Improve accessibility of the Charts and Pickers components.
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+Special thanks go out to these community members for their valuable contributions:
+@kevincorizi-sbt, @mustafajw07, @SamanPandey-in
+
+The following team members contributed to this release:
+@brijeshb42, @hasdfa, @JCQuintas, @LukasTy, @michelengelen, @noraleonte, @rita-codes, @silviuaavram
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.10.1`
+
+- [data grid] Fix `getColumn` return type not reflecting that it can return undefined (#23165) @JCQuintas
+
+#### `@mui/x-data-grid-pro@9.10.1` [![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.10.1`.
+
+#### `@mui/x-data-grid-premium@9.10.1` [![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.10.1`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.10.1`
+
+- [pickers] Fix format placeholder brightness with a start adornment (#23189) @LukasTy
+
+#### `@mui/x-date-pickers-pro@9.10.1` [![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.10.1`, plus:
+
+- [DateRangePicker] Fix broken active range position underline in single input range fields (#23166) @LukasTy
+
+### Charts
+
+#### `@mui/x-charts@9.10.1`
+
+- [charts] Fix pie chart disappearing when an arc spans almost the full circle (#23145) @JCQuintas
+- [charts] Set `aria-hidden` on accessibility proxy divs at initialization (#23186) @kevincorizi-sbt
+- [charts] Fix keyboard navigation on series with different lengths (#23182) @JCQuintas
+- [charts] Fix out of bounds keyboard navigation (#23180) @silviuaavram
+
+#### `@mui/x-charts-pro@9.10.1` [![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.10.1`, plus:
+
+- [charts-pro] Fix highlight shifting on sampled bar charts (#23190) @noraleonte
+- [charts-pro] Sampled band highlight falls back to single-band width for Date/object values (#23024) @SamanPandey-in
+
+#### `@mui/x-charts-premium@9.10.1` [![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.10.1`.
+
+### Tree View
+
+#### `@mui/x-tree-view@9.10.1`
+
+- [TreeView] Fix selection propagation to exclude disabled items (#23012) @michelengelen
+
+#### `@mui/x-tree-view-pro@9.10.1` [![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.10.1`.
+
+### Scheduler
+
+#### `@mui/x-scheduler@9.0.0-beta.7`
+
+- [scheduler] Polish `EventCalendar` rendering for multi-resource events (#23161) @mustafajw07
+- [scheduler] Responsive header (#22954) @noraleonte
+
+#### `@mui/x-scheduler-premium@9.0.0-beta.7` [![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.7`, plus:
+
+- [scheduler-premium] Add the dependencies data model (#23117) @rita-codes
+- [scheduler-premium] Dependencies - Render the FS arrow (#23162) @rita-codes
+
+### Codemod
+
+#### `@mui/x-codemod@9.10.1`
+
+Internal changes.
+
+### Docs
+
+- [docs] Fix clearing, layout shift, and prop leak in Pickers demos (#23191) @LukasTy
+
+### Core
+
+- [code-infra] Validate working of specific code-infra canary (#23207) @brijeshb42
+
+### Miscellaneous
+
+- [chat] Normalize message part link URLs (#23187) @hasdfa
+- [x-chat] Fix object URL leaks for submitted attachments (#23198) @hasdfa
+- [internals] Make disposable types self-contained without `esnext.disposable` lib (#23164) @JCQuintas
+
 ## 9.10.0
 
 _Jul 17, 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.0
+ * @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.0
+ * @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

@@ -1,5 +1,5 @@
 import { Store } from '@mui/x-internals/store';
-import { disposeSymbol } from '@mui/x-internals/disposable';
+import { DisposableStack, disposeSymbol } from '@mui/x-internals/disposable';
 import type { MinimalTreeViewParameters, TreeViewParametersToStateMapper, MinimalTreeViewState } from "./MinimalTreeViewStore.types.mjs";
 import type { TreeViewValidItem } from "../../models/index.mjs";
 import { TimeoutManager } from "./TimeoutManager.mjs";
@@ -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

@@ -1,5 +1,5 @@
 import { Store } from '@mui/x-internals/store';
-import { disposeSymbol } from '@mui/x-internals/disposable';
+import { DisposableStack, disposeSymbol } from '@mui/x-internals/disposable';
 import type { MinimalTreeViewParameters, TreeViewParametersToStateMapper, MinimalTreeViewState } from "./MinimalTreeViewStore.types.js";
 import type { TreeViewValidItem } from "../../models/index.js";
 import { TimeoutManager } from "./TimeoutManager.js";
@@ -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;
 }