@mui/x-tree-view 9.10.1 → 9.12.0

package/CHANGELOG.md

@@ -1,5 +1,288 @@
 # Changelog
 
+## 9.12.0
+
+_Aug 21, 2026_
+
+We'd like to extend a big thank you to the 12 contributors who made this release possible. Here are some highlights ✨:
+
+- 🧮 Support [Formulas](https://mui.com/x/react-data-grid/formulas/) on the Data Grid: cells in opted-in columns can hold spreadsheet-like formulas (`=SUM(RANGE(…))`, `=price * quantity`) evaluated by a built-in engine, with a formula editor and [Formula Bar](https://mui.com/x/react-data-grid/components/formula-bar/), autocomplete, reference highlighting, optional A1 notation, fill-handle reference adjustment, custom functions, and live formula Excel export
+- ♿️ Improve the accessibility of Data Grid cells and picker day cells
+- 🗓️ Enable multi-resource event creation and editing in the Scheduler
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+Special thanks go out to these community members for their valuable contributions:
+@Anexus5919, @mustafajw07
+
+The following team members contributed to this release:
+@brijeshb42, @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @rita-codes, @romgrk, @silviuaavram
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.12.0`
+
+- [DataGrid] Expose `apiRef` on `GridCallbackDetails` for selector access in callbacks (#22973) @michelengelen
+- [DataGrid] Fix header height not updating when `headerFilters` or `columnGroupingModel` change (#23059) @MBilalShafi
+- [DataGrid] Fix unhandled rejection when unmounting mid-autosize (#23319) @JCQuintas
+- [DataGrid] Label the blank `singleSelect` filter option (#23294) @JCQuintas
+- [DataGrid] Stop sending incomplete filter items to the data source (#23303) @JCQuintas
+- [DataGrid] Support the `rowheader` attribute for grid cells (#23340) @silviuaavram
+
+#### `@mui/x-data-grid-pro@9.12.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.12.0`, plus:
+
+- [DataGridPro] Honor `hasNextPage` in infinite lazy loading (#23048) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@9.12.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.12.0`, plus:
+
+- [DataGridPremium] Formula support (#22807) @MBilalShafi
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.12.0`
+
+- [fields] Keep the selected section on blank space clicks (#23318) @LukasTy
+- [pickers] Associate the day cells with their week day column header (#23339) @LukasTy
+- [pickers] Keep the `gridcell` role and the column index on filler cells (#23326) @Anexus5919
+
+#### `@mui/x-date-pickers-pro@9.12.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.12.0`, plus:
+
+- [DateRangeCalendar] Round the range highlight at the month grid edges (#23297) @JCQuintas
+- [DateRangePicker] Keep the range highlight opaque for disabled days (#23317) @JCQuintas
+
+### Charts
+
+#### `@mui/x-charts@9.12.0`
+
+- [charts] Add a demo for label on grid row (#23333) @noraleonte
+- [charts] Fix React 18 `propTypes` warnings and stray-pointer test flakiness (#23384) @LukasTy
+- [charts] Focus the clicked item for keyboard navigation (#23247) @JCQuintas
+
+#### `@mui/x-charts-pro@9.12.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.12.0`.
+
+#### `@mui/x-charts-premium@9.12.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.12.0`, plus:
+
+- [charts-premium] Add `onItemClick` to the radial charts (#23253) @JCQuintas
+
+### Tree View
+
+#### `@mui/x-tree-view@9.12.0`
+
+Internal changes.
+
+#### `@mui/x-tree-view-pro@9.12.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.12.0`.
+
+### Scheduler
+
+#### `@mui/x-scheduler@9.0.0-beta.10`
+
+- [scheduler] Add `onEventEditingStart` to let consumers open their own edit UI (#23361) @rita-codes
+- [scheduler] Fix keyboard and focus issues around the "+N more" popover (#23312) @rita-codes
+- [scheduler] Honor `viewConfig` hour limits in the compact day and week views (#23316) @rita-codes
+- [scheduler] Share timeline event layout data (#23366) @flaviendelangle
+- [scheduler] enable multi-resource event creation and editing (#23313) @mustafajw07
+
+#### `@mui/x-scheduler-premium@9.0.0-beta.10` [![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.10`, plus:
+
+- [scheduler-premium] Allow to control the min and max hour in the Event Timeline (#23212) @rita-codes
+- [scheduler-premium] Dependencies - Create, select and delete via terminals (#23200) @rita-codes
+
+### Codemod
+
+#### `@mui/x-codemod@9.12.0`
+
+Internal changes.
+
+### Docs
+
+- [docs][charts] Document line mark size customization (#23370) @JCQuintas
+- [docs] Add recipe for constraining the `make-child` drop action by item type (#22940) @michelengelen
+- [docs] Redirect the renamed Event Timeline views page (#23324) @brijeshb42
+- [docs] Remove unused `adapter-dependencies.json` (#23328) @LukasTy
+
+### Core
+
+- [code-infra] Add release skill (#23308) @brijeshb42
+- [code-infra] Fix changelog categorization of docs and `DateRangeCalendar` tags (#23385) @JCQuintas
+- [code-infra] Sync mui-release skill (#23330) @brijeshb42
+
+### Miscellaneous
+
+- [core] Declare the missing `react-dom` peer dependencies (#23381) @LukasTy
+- [test] Fix act warnings in the data source filter tests (#23360) @JCQuintas
+- [virtualizer] Add inverse-sticky layout (#23053) @romgrk
+
+## 9.11.1
+
+_Aug 6, 2026_
+
+We'd like to extend a big thank you to the 2 contributors who made this release possible. Here are some highlights ✨:
+
+- 🐛 Fix the empty `@mui/x-charts-vendor` package published in v9.11.0
+
+The following team members contributed to this release:
+@JCQuintas, @rita-codes
+
+### Charts
+
+#### `@mui/x-charts@9.11.1`
+
+- [charts] Fix empty `@mui/x-charts-vendor` published package (#23310) @JCQuintas
+
+#### `@mui/x-charts-pro@9.11.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.11.1`.
+
+#### `@mui/x-charts-premium@9.11.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.11.1`.
+
+#### `@mui/x-charts-vendor@9.11.1`
+
+- [charts] Fix empty `@mui/x-charts-vendor` published package (#23310) @JCQuintas
+
+### Scheduler
+
+#### `@mui/x-scheduler@9.0.0-beta.9`
+
+- [scheduler] Show the range validation errors on the End date and End time fields (#23291) @rita-codes
+
+#### `@mui/x-scheduler-premium@9.0.0-beta.9` [![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.9`.
+
+## 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.12.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.12.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;
 }