@mui/x-tree-view 7.8.0 → 7.10.0

package/CHANGELOG.md

@@ -3,6 +3,146 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 7.10.0
+
+_Jul 11, 2024_
+
+We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
+
+- 🎁 Add selectors to support showing child row count in footer in the Data Grid
+- ✨ New APIs for retrieving current item tree and item's children IDs in the Tree View
+- 🌍 Improve Spanish (es-ES) locale on the Data Grid
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
+
+### Data Grid
+
+#### `@mui/x-data-grid@7.10.0`
+
+- [DataGrid] Add selectors to support showing child row count in footer (#13725) @KenanYusuf
+- [DataGrid] Fix incorrect panels position when using a toolbar (#13474) @oukunan
+- [DataGrid] Set default variant to `'standard'` in `GridFilterInputMultipleValue` (#13129) @tarunrajput
+- [DataGrid] Use `readonly` on more array props (#13331) @pcorpet
+- [l10n] Improve Spanish (es-ES) locale (#13772) @joserealdev
+
+#### `@mui/x-data-grid-pro@7.10.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@7.10.0`, plus:
+
+- [DataGridPro] Keep bottom pinned row at the bottom (#13313) @romgrk
+
+#### `@mui/x-data-grid-premium@7.10.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@7.10.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@7.10.0`
+
+- [fields] Prevent infinite recursion when ensuring selection (#13779) @LukasTy
+- [fields] Unify fields behavior regardless of the `readOnly` flag (#13688) @LukasTy
+
+#### `@mui/x-date-pickers-pro@7.10.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@7.10.0`, plus:
+
+- [DateRangePicker] Fix `calendarHeader` slot props propagation (#13780) @LukasTy
+- [DateTimeRangePicker] Resolve `format` from given `views` (#13743) @LukasTy
+
+### Charts
+
+#### `@mui/x-charts@7.10.0`
+
+- [charts] Fix displaying area of a `LineChart` when using the `log` scale (#13791) @alexfauquette
+- [charts] Use correct click handler prop on pie chart `OnSeriesItemClick` documentation (#13761) @tonyhallett
+
+### Tree View
+
+#### `@mui/x-tree-view@7.10.0`
+
+- [TreeView] Add `getItemTree` and `getItemOrderedChildrenIds` methods to the public API (#13804) @flaviendelangle
+- [TreeView] Add utility function to check if an optional plugin is present (#13788) @flaviendelangle
+
+### Docs
+
+- [docs] Add missing default `loading` prop value (#13604) @oliviertassinari
+- [docs] Add the `DateTimeRangePicker` to the "Commonly used components" demo (#13775) @flaviendelangle
+- [docs] Fix Pickers customization playground overflow (#13742) @LukasTy
+- [docs] Move Pickers dialog guidelines to accessibility page (#13778) @arthurbalduini
+
+### Core
+
+- [core] Sort `DATA_GRID_PROPS_DEFAULT_VALUES` alphabetically (#13783) @oliviertassinari
+- [test] Fix split infinitive use in tests @oliviertassinari
+
+## 7.9.0
+
+_Jul 5, 2024_
+
+We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
+
+- 🔄 Add loading overlay variants, including a skeleton loader option to the Data Grid component. See [Loading overlay docs](https://mui.com/x/react-data-grid/overlays/#loading-overlay) for more details.
+- 🌳 Add `selectItem` and `getItemDOMElement` methods to the TreeView component public API
+- ⛏️ Make the `usePickersTranslations` hook public in the pickers component
+- 🐞 Bugfixes
+
+<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
+
+### Data Grid
+
+#### `@mui/x-data-grid@7.9.0`
+
+- [DataGrid] Add skeleton loading overlay support (#13293) @KenanYusuf
+- [DataGrid] Fix pagination when `pagination={undefined}` (#13349) @sai6855
+
+#### `@mui/x-data-grid-pro@7.9.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@7.9.0`.
+
+#### `@mui/x-data-grid-premium@7.9.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@7.9.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@7.9.0`
+
+- [pickers] Make the `usePickersTranslations` hook public (#13657) @flaviendelangle
+
+#### `@mui/x-date-pickers-pro@7.9.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@7.9.0`.
+
+### Charts
+
+#### `@mui/x-charts@7.9.0`
+
+- [charts] Add Heatmap (unreleased) (#13209) @alexfauquette
+- [charts] Add initial `Zoom&Pan` to the Pro charts (unreleased) (#13405) @JCQuintas
+- [charts] Fix Axis Highlight on horizontal bar charts regression (#13717) @JCQuintas
+- [charts] Improve charts interaction for mobile users (#13692) @JCQuintas
+- [charts] Add documentation on how to disable the tooltip on charts (#13724) @JCQuintas
+
+### Tree View
+
+#### `@mui/x-tree-view@7.9.0`
+
+- [TreeView] Add `selectItem` and `getItemDOMElement` methods to the public API (#13485) @flaviendelangle
+
+### Docs
+
+- [docs] Fix custom "no results overlay" demo in dark mode (#13715) @KenanYusuf
+
+### Core
+
+- [core] Add `react_next` workflow in CircleCI (#13360) @cherniavskii
+- [core] Create a new package to share utils across X packages (#13528) @flaviendelangle
+- [core] Fix dependency setup (#13684) @LukasTy
+- [core] Remove `jscodeshift-add-imports` package (#13720) @LukasTy
+- [code-infra] Cleanup monorepo and `@mui/docs` usage (#13713) @LukasTy
+
 ## 7.8.0
 
 _Jun 28, 2024_

package/RichTreeView/RichTreeView.js

@@ -137,6 +137,10 @@ process.env.NODE_ENV !== "production" ? RichTreeView.propTypes = {
     current: PropTypes.shape({
       focusItem: PropTypes.func.isRequired,
       getItem: PropTypes.func.isRequired,
+      getItemDOMElement: PropTypes.func.isRequired,
+      getItemOrderedChildrenIds: PropTypes.func.isRequired,
+      getItemTree: PropTypes.func.isRequired,
+      selectItem: PropTypes.func.isRequired,
       setItemExpansion: PropTypes.func.isRequired
     })
   }),
@@ -234,34 +238,34 @@ process.env.NODE_ENV !== "production" ? RichTreeView.propTypes = {
   multiSelect: PropTypes.bool,
   /**
    * Callback fired when tree items are expanded/collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemIds The ids of the expanded items.
    */
   onExpandedItemsChange: PropTypes.func,
   /**
    * Callback fired when a tree item is expanded or collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isExpanded `true` if the item has just been expanded, `false` if it has just been collapsed.
    */
   onItemExpansionToggle: 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.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change. **Warning**: This is a generic event not a focus event.
    * @param {string} itemId The id of the focused item.
    * @param {string} value of the focused item.
    */
   onItemFocus: PropTypes.func,
   /**
    * Callback fired when a tree item is selected or deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isSelected `true` if the item has just been selected, `false` if it has just been deselected.
    */
   onItemSelectionToggle: PropTypes.func,
   /**
    * Callback fired when tree items are selected/deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {string[] | string} itemIds The ids of the selected items.
    * When `multiSelect` is `true`, this is an array of strings; when false (default) a string.
    */

package/SimpleTreeView/SimpleTreeView.js

@@ -95,6 +95,10 @@ process.env.NODE_ENV !== "production" ? SimpleTreeView.propTypes = {
     current: PropTypes.shape({
       focusItem: PropTypes.func.isRequired,
       getItem: PropTypes.func.isRequired,
+      getItemDOMElement: PropTypes.func.isRequired,
+      getItemOrderedChildrenIds: PropTypes.func.isRequired,
+      getItemTree: PropTypes.func.isRequired,
+      selectItem: PropTypes.func.isRequired,
       setItemExpansion: PropTypes.func.isRequired
     })
   }),
@@ -170,34 +174,34 @@ process.env.NODE_ENV !== "production" ? SimpleTreeView.propTypes = {
   multiSelect: PropTypes.bool,
   /**
    * Callback fired when tree items are expanded/collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemIds The ids of the expanded items.
    */
   onExpandedItemsChange: PropTypes.func,
   /**
    * Callback fired when a tree item is expanded or collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isExpanded `true` if the item has just been expanded, `false` if it has just been collapsed.
    */
   onItemExpansionToggle: 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.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change. **Warning**: This is a generic event not a focus event.
    * @param {string} itemId The id of the focused item.
    * @param {string} value of the focused item.
    */
   onItemFocus: PropTypes.func,
   /**
    * Callback fired when a tree item is selected or deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isSelected `true` if the item has just been selected, `false` if it has just been deselected.
    */
   onItemSelectionToggle: PropTypes.func,
   /**
    * Callback fired when tree items are selected/deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {string[] | string} itemIds The ids of the selected items.
    * When `multiSelect` is `true`, this is an array of strings; when false (default) a string.
    */

package/TreeItem/useTreeItemState.js

@@ -39,10 +39,18 @@ export function useTreeItemState(itemId) {
         if (event.shiftKey) {
           instance.expandSelectionRange(event, itemId);
         } else {
-          instance.selectItem(event, itemId, true);
+          instance.selectItem({
+            event,
+            itemId,
+            keepExistingSelection: true
+          });
         }
       } else {
-        instance.selectItem(event, itemId, false);
+        instance.selectItem({
+          event,
+          itemId,
+          shouldBeSelected: true
+        });
       }
     }
   };
@@ -54,7 +62,12 @@ export function useTreeItemState(itemId) {
     if (multiSelect && hasShift) {
       instance.expandSelectionRange(event, itemId);
     } else {
-      instance.selectItem(event, itemId, multiSelect, event.target.checked);
+      instance.selectItem({
+        event,
+        itemId,
+        keepExistingSelection: multiSelect,
+        shouldBeSelected: event.target.checked
+      });
     }
   };
   const preventSelection = event => {

package/TreeView/TreeView.js

@@ -72,6 +72,10 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
     current: PropTypes.shape({
       focusItem: PropTypes.func.isRequired,
       getItem: PropTypes.func.isRequired,
+      getItemDOMElement: PropTypes.func.isRequired,
+      getItemOrderedChildrenIds: PropTypes.func.isRequired,
+      getItemTree: PropTypes.func.isRequired,
+      selectItem: PropTypes.func.isRequired,
       setItemExpansion: PropTypes.func.isRequired
     })
   }),
@@ -147,34 +151,34 @@ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
   multiSelect: PropTypes.bool,
   /**
    * Callback fired when tree items are expanded/collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemIds The ids of the expanded items.
    */
   onExpandedItemsChange: PropTypes.func,
   /**
    * Callback fired when a tree item is expanded or collapsed.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isExpanded `true` if the item has just been expanded, `false` if it has just been collapsed.
    */
   onItemExpansionToggle: 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.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change. **Warning**: This is a generic event not a focus event.
    * @param {string} itemId The id of the focused item.
    * @param {string} value of the focused item.
    */
   onItemFocus: PropTypes.func,
   /**
    * Callback fired when a tree item is selected or deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback.
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {array} itemId The itemId of the modified item.
    * @param {array} isSelected `true` if the item has just been selected, `false` if it has just been deselected.
    */
   onItemSelectionToggle: PropTypes.func,
   /**
    * Callback fired when tree items are selected/deselected.
-   * @param {React.SyntheticEvent} event The event source of the callback
+   * @param {React.SyntheticEvent} event The DOM event that triggered the change.
    * @param {string[] | string} itemIds The ids of the selected items.
    * When `multiSelect` is `true`, this is an array of strings; when false (default) a string.
    */

package/hooks/useTreeItem2Utils/useTreeItem2Utils.js

@@ -57,10 +57,18 @@ export const useTreeItem2Utils = ({
       if (event.shiftKey) {
         instance.expandSelectionRange(event, itemId);
       } else {
-        instance.selectItem(event, itemId, true);
+        instance.selectItem({
+          event,
+          itemId,
+          keepExistingSelection: true
+        });
       }
     } else {
-      instance.selectItem(event, itemId, false);
+      instance.selectItem({
+        event,
+        itemId,
+        shouldBeSelected: true
+      });
     }
   };
   const handleCheckboxSelection = event => {
@@ -68,7 +76,12 @@ export const useTreeItem2Utils = ({
     if (multiSelect && hasShift) {
       instance.expandSelectionRange(event, itemId);
     } else {
-      instance.selectItem(event, itemId, multiSelect, event.target.checked);
+      instance.selectItem({
+        event,
+        itemId,
+        keepExistingSelection: multiSelect,
+        shouldBeSelected: event.target.checked
+      });
     }
   };
   const interactions = {

package/index.js

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

package/internals/corePlugins/corePlugins.d.ts

@@ -4,7 +4,7 @@ import { ConvertPluginsIntoSignatures } from '../models';
  * Internal plugins that create the tools used by the other plugins.
  * These plugins are used by the tree view components.
  */
-export declare const TREE_VIEW_CORE_PLUGINS: readonly [import("../models").TreeViewPlugin<import("./useTreeViewInstanceEvents").UseTreeViewInstanceEventsSignature>, import("../models").TreeViewPlugin<import("./useTreeViewId").UseTreeViewIdSignature>];
+export declare const TREE_VIEW_CORE_PLUGINS: readonly [import("../models").TreeViewPlugin<import("./useTreeViewInstanceEvents").UseTreeViewInstanceEventsSignature>, import("../models").TreeViewPlugin<import("./useTreeViewOptionalPlugins").UseTreeViewOptionalPluginsSignature>, import("../models").TreeViewPlugin<import("./useTreeViewId").UseTreeViewIdSignature>];
 export type TreeViewCorePluginSignatures = ConvertPluginsIntoSignatures<typeof TREE_VIEW_CORE_PLUGINS>;
 export interface TreeViewCorePluginParameters extends UseTreeViewIdParameters {
 }

package/internals/corePlugins/corePlugins.js

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

package/internals/corePlugins/useTreeViewOptionalPlugins/index.d.ts

@@ -0,0 +1,2 @@
+export { useTreeViewOptionalPlugins } from './useTreeViewOptionalPlugins';
+export type { UseTreeViewOptionalPluginsSignature } from './useTreeViewOptionalPlugins.types';

package/internals/corePlugins/useTreeViewOptionalPlugins/index.js

@@ -0,0 +1 @@
+export { useTreeViewOptionalPlugins } from './useTreeViewOptionalPlugins';

package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.d.ts

@@ -0,0 +1,3 @@
+import { TreeViewPlugin } from '../../models';
+import { UseTreeViewOptionalPluginsSignature } from './useTreeViewOptionalPlugins.types';
+export declare const useTreeViewOptionalPlugins: TreeViewPlugin<UseTreeViewOptionalPluginsSignature>;

package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.js

@@ -0,0 +1,12 @@
+export const useTreeViewOptionalPlugins = ({
+  plugins
+}) => {
+  const pluginSet = new Set(plugins);
+  const getAvailablePlugins = () => pluginSet;
+  return {
+    instance: {
+      getAvailablePlugins
+    }
+  };
+};
+useTreeViewOptionalPlugins.params = {};

package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.d.ts

@@ -0,0 +1,8 @@
+import { TreeViewPlugin, TreeViewAnyPluginSignature, TreeViewPluginSignature } from '../../models';
+interface UseTreeViewOptionalPluginsInstance {
+    getAvailablePlugins: () => Set<TreeViewPlugin<TreeViewAnyPluginSignature>>;
+}
+export type UseTreeViewOptionalPluginsSignature = TreeViewPluginSignature<{
+    instance: UseTreeViewOptionalPluginsInstance;
+}>;
+export {};

package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.js

@@ -0,0 +1 @@
+export {};

package/internals/models/plugin.d.ts

@@ -15,6 +15,7 @@ export interface TreeViewPluginOptions<TSignature extends TreeViewAnyPluginSigna
     models: TreeViewUsedModels<TSignature>;
     setState: React.Dispatch<React.SetStateAction<TreeViewUsedState<TSignature>>>;
     rootRef: React.RefObject<HTMLUListElement>;
+    plugins: TreeViewPlugin<TreeViewAnyPluginSignature>[];
 }
 type TreeViewModelsInitializer<TSignature extends TreeViewAnyPluginSignature> = {
     [TControlled in keyof TSignature['models']]: {

package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.d.ts

@@ -5,9 +5,9 @@ import { TreeViewItemId } from '../../../models';
 export interface UseTreeViewExpansionPublicAPI {
     /**
      * Change the expansion status of a given item.
-     * @param {React.SyntheticEvent} event The UI event that triggered the change.
-     * @param {string} itemId The id of the item to modify.
-     * @param {boolean} isExpanded The new expansion status of the given item.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
+     * @param {string} itemId The id of the item to expand of collapse.
+     * @param {boolean} isExpanded If `true` the item will be expanded. If `false` the item will be collapsed.
      */
     setItemExpansion: (event: React.SyntheticEvent, itemId: string, isExpanded: boolean) => void;
 }
@@ -29,13 +29,13 @@ export interface UseTreeViewExpansionInstance extends UseTreeViewExpansionPublic
     /**
      * Toggle the current expansion of an item.
      * If it is expanded, it will be collapsed, and vice versa.
-     * @param {React.SyntheticEvent} event The UI event that triggered the change.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
      * @param {TreeViewItemId} itemId The id of the item to toggle.
      */
     toggleItemExpansion: (event: React.SyntheticEvent, itemId: TreeViewItemId) => void;
     /**
      * Expand all the siblings (i.e.: the items that have the same parent) of a given item.
-     * @param {React.SyntheticEvent} event The UI event that triggered the change.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
      * @param {TreeViewItemId} itemId The id of the item whose siblings will be expanded.
      */
     expandAllSiblings: (event: React.KeyboardEvent, itemId: TreeViewItemId) => void;
@@ -54,13 +54,13 @@ export interface UseTreeViewExpansionParameters {
     defaultExpandedItems?: string[];
     /**
      * Callback fired when tree items are expanded/collapsed.
-     * @param {React.SyntheticEvent} event The event source of the callback.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
      * @param {array} itemIds The ids of the expanded items.
      */
     onExpandedItemsChange?: (event: React.SyntheticEvent, itemIds: string[]) => void;
     /**
      * Callback fired when a tree item is expanded or collapsed.
-     * @param {React.SyntheticEvent} event The event source of the callback.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
      * @param {array} itemId The itemId of the modified item.
      * @param {array} isExpanded `true` if the item has just been expanded, `false` if it has just been collapsed.
      */

package/internals/plugins/useTreeViewFocus/useTreeViewFocus.js

@@ -43,8 +43,7 @@ export const useTreeViewFocus = ({
     return itemMeta && (itemMeta.parentId == null || instance.isItemExpanded(itemMeta.parentId));
   };
   const innerFocusItem = (event, itemId) => {
-    const itemMeta = instance.getItemMeta(itemId);
-    const itemElement = document.getElementById(instance.getTreeItemIdAttribute(itemId, itemMeta.idAttribute));
+    const itemElement = instance.getItemDOMElement(itemId);
     if (itemElement) {
       itemElement.focus();
     }

package/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.d.ts

@@ -10,7 +10,7 @@ export interface UseTreeViewFocusPublicAPI {
      *
      * If the item is the child of a collapsed item, then this method will do nothing.
      * Make sure to expand the ancestors of the item before calling this method if needed.
-     * @param {React.SyntheticEvent} event The event source of the action.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change.
      * @param {TreeViewItemId} itemId The id of the item to focus.
      */
     focusItem: (event: React.SyntheticEvent, itemId: string) => void;
@@ -38,7 +38,7 @@ export interface UseTreeViewFocusInstance extends UseTreeViewFocusPublicAPI {
 export interface UseTreeViewFocusParameters {
     /**
      * 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.
+     * @param {React.SyntheticEvent} event The DOM event that triggered the change. **Warning**: This is a generic event not a focus event.
      * @param {string} itemId The id of the focused item.
      * @param {string} value of the focused item.
      */

package/internals/plugins/useTreeViewItems/useTreeViewItems.js

@@ -1,4 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["children"];
 import * as React from 'react';
 import { publishTreeViewEvent } from '../../utils/publishTreeViewEvent';
 import { buildSiblingIndexes, TREE_VIEW_ROOT_PARENT_ID } from './useTreeViewItems.utils';
@@ -37,7 +39,6 @@ const updateItemsState = ({
       depth
     };
     itemMap[id] = item;
-    itemOrderedChildrenIds[id] = [];
     const parentIdWithDefault = parentId ?? TREE_VIEW_ROOT_PARENT_ID;
     if (!itemOrderedChildrenIds[parentIdWithDefault]) {
       itemOrderedChildrenIds[parentIdWithDefault] = [];
@@ -66,6 +67,18 @@ export const useTreeViewItems = ({
 }) => {
   const getItemMeta = React.useCallback(itemId => state.items.itemMetaMap[itemId], [state.items.itemMetaMap]);
   const getItem = React.useCallback(itemId => state.items.itemMap[itemId], [state.items.itemMap]);
+  const getItemTree = React.useCallback(() => {
+    const getItemFromItemId = id => {
+      const _state$items$itemMap$ = state.items.itemMap[id],
+        item = _objectWithoutPropertiesLoose(_state$items$itemMap$, _excluded);
+      const newChildren = state.items.itemOrderedChildrenIds[id];
+      if (newChildren) {
+        item.children = newChildren.map(getItemFromItemId);
+      }
+      return item;
+    };
+    return state.items.itemOrderedChildrenIds[TREE_VIEW_ROOT_PARENT_ID].map(getItemFromItemId);
+  }, [state.items.itemMap, state.items.itemOrderedChildrenIds]);
   const isItemDisabled = React.useCallback(itemId => {
     if (itemId == null) {
       return false;
@@ -92,6 +105,13 @@ export const useTreeViewItems = ({
     return state.items.itemChildrenIndexes[parentId][itemId];
   }, [instance, state.items.itemChildrenIndexes]);
   const getItemOrderedChildrenIds = React.useCallback(itemId => state.items.itemOrderedChildrenIds[itemId ?? TREE_VIEW_ROOT_PARENT_ID] ?? [], [state.items.itemOrderedChildrenIds]);
+  const getItemDOMElement = itemId => {
+    const itemMeta = instance.getItemMeta(itemId);
+    if (itemMeta == null) {
+      return null;
+    }
+    return document.getElementById(instance.getTreeItemIdAttribute(itemId, itemMeta.idAttribute));
+  };
   const isItemNavigable = itemId => {
     if (params.disabledItemsFocusable) {
       return true;
@@ -133,7 +153,7 @@ export const useTreeViewItems = ({
         label: item.label,
         itemId: item.id,
         id: item.idAttribute,
-        children: state.items.itemOrderedChildrenIds[id].map(getPropsFromItemId)
+        children: state.items.itemOrderedChildrenIds[id]?.map(getPropsFromItemId)
       };
     };
     return state.items.itemOrderedChildrenIds[TREE_VIEW_ROOT_PARENT_ID].map(getPropsFromItemId);
@@ -145,13 +165,18 @@ export const useTreeViewItems = ({
       }
     }),
     publicAPI: {
-      getItem
+      getItem,
+      getItemDOMElement,
+      getItemTree,
+      getItemOrderedChildrenIds
     },
     instance: {
       getItemMeta,
       getItem,
+      getItemTree,
       getItemsToRender,
       getItemIndex,
+      getItemDOMElement,
       getItemOrderedChildrenIds,
       isItemDisabled,
       isItemNavigable,

package/internals/plugins/useTreeViewItems/useTreeViewItems.types.d.ts

@@ -1,5 +1,5 @@
 import { TreeViewItemMeta, DefaultizedProps, TreeViewPluginSignature } from '../../models';
-import { TreeViewItemId } from '../../../models';
+import { TreeViewBaseItem, TreeViewItemId } from '../../../models';
 interface TreeViewItemProps {
     label: string;
     itemId: string;
@@ -10,10 +10,28 @@ export interface UseTreeViewItemsPublicAPI<R extends {}> {
     /**
      * Get the item with the given id.
      * When used in the `SimpleTreeView`, it returns an object with the `id` and `label` properties.
-     * @param {string} itemId The id of the item to return.
+     * @param {string} itemId The id of the item to retrieve.
      * @returns {R} The item with the given id.
      */
     getItem: (itemId: TreeViewItemId) => R;
+    /**
+     * Get the DOM element of the item with the given id.
+     * @param {TreeViewItemId} itemId The id of the item to get the DOM element of.
+     * @returns {HTMLElement | null} The DOM element of the item with the given id.
+     */
+    getItemDOMElement: (itemId: TreeViewItemId) => HTMLElement | null;
+    /**
+     * Get the ids of a given item's children.
+     * Those ids are returned in the order they should be rendered.
+     * @param {TreeViewItemId | null} itemId The id of the item to get the children of.
+     * @returns {TreeViewItemId[]} The ids of the item's children.
+     */
+    getItemOrderedChildrenIds: (itemId: TreeViewItemId | null) => TreeViewItemId[];
+    /**
+     * Get all the items in the same format as provided by `props.items`.
+     * @returns {TreeViewItemProps[]} The items in the tree.
+     */
+    getItemTree: () => TreeViewBaseItem[];
 }
 export interface UseTreeViewItemsInstance<R extends {}> extends UseTreeViewItemsPublicAPI<R> {
     /**
@@ -30,13 +48,6 @@ export interface UseTreeViewItemsInstance<R extends {}> extends UseTreeViewItems
      * @returns {TreeViewItemProps[]} The items to render.
      */
     getItemsToRender: () => TreeViewItemProps[];
-    /**
-     * Get the ids of a given item's children.
-     * Those ids are returned in the order they should be rendered.
-     * @param {TreeViewItemId | null} itemId The id of the item to get the children of.
-     * @returns {TreeViewItemId[]} The ids of the item's children.
-     */
-    getItemOrderedChildrenIds: (itemId: TreeViewItemId | null) => TreeViewItemId[];
     /**
      * Check if a given item is disabled.
      * An item is disabled if it was marked as disabled or if one of its ancestors is disabled.