@mui/x-tree-view 7.0.0 → 7.1.0

package/node/internals/plugins/useTreeViewSelection/useTreeViewSelection.js

@@ -16,13 +16,13 @@ const useTreeViewSelection = ({
   params,
   models
 }) => {
-  const lastSelectedNode = React.useRef(null);
+  const lastSelectedItem = React.useRef(null);
   const lastSelectionWasRange = React.useRef(false);
   const currentRangeSelection = React.useRef([]);
   const setSelectedItems = (event, newSelectedItems) => {
     if (params.onItemSelectionToggle) {
       if (params.multiSelect) {
-        const addedItems = newSelectedItems.filter(itemId => !instance.isNodeSelected(itemId));
+        const addedItems = newSelectedItems.filter(itemId => !instance.isItemSelected(itemId));
         const removedItems = models.selectedItems.value.filter(itemId => !newSelectedItems.includes(itemId));
         addedItems.forEach(itemId => {
           params.onItemSelectionToggle(event, itemId, true);
@@ -44,8 +44,8 @@ const useTreeViewSelection = ({
     }
     models.selectedItems.setControlledValue(newSelectedItems);
   };
-  const isNodeSelected = itemId => Array.isArray(models.selectedItems.value) ? models.selectedItems.value.indexOf(itemId) !== -1 : models.selectedItems.value === itemId;
-  const selectNode = (event, itemId, multiple = false) => {
+  const isItemSelected = itemId => Array.isArray(models.selectedItems.value) ? models.selectedItems.value.indexOf(itemId) !== -1 : models.selectedItems.value === itemId;
+  const selectItem = (event, itemId, multiple = false) => {
     if (params.disableSelection) {
       return;
     }
@@ -63,27 +63,27 @@ const useTreeViewSelection = ({
       const newSelected = params.multiSelect ? [itemId] : itemId;
       setSelectedItems(event, newSelected);
     }
-    lastSelectedNode.current = itemId;
+    lastSelectedItem.current = itemId;
     lastSelectionWasRange.current = false;
     currentRangeSelection.current = [];
   };
-  const getNodesInRange = (nodeAId, nodeBId) => {
-    const [first, last] = (0, _useTreeViewSelection.findOrderInTremauxTree)(instance, nodeAId, nodeBId);
-    const nodes = [first];
+  const getItemsInRange = (itemAId, itemBId) => {
+    const [first, last] = (0, _useTreeViewSelection.findOrderInTremauxTree)(instance, itemAId, itemBId);
+    const items = [first];
     let current = first;
     while (current !== last) {
-      current = (0, _useTreeView.getNextNode)(instance, current);
-      nodes.push(current);
+      current = (0, _useTreeView.getNextItem)(instance, current);
+      items.push(current);
     }
-    return nodes;
+    return items;
   };
-  const handleRangeArrowSelect = (event, nodes) => {
+  const handleRangeArrowSelect = (event, items) => {
     let base = models.selectedItems.value.slice();
     const {
       start,
       next,
       current
-    } = nodes;
+    } = items;
     if (!next || !current) {
       return;
     }
@@ -104,32 +104,32 @@ const useTreeViewSelection = ({
     }
     setSelectedItems(event, base);
   };
-  const handleRangeSelect = (event, nodes) => {
+  const handleRangeSelect = (event, items) => {
     let base = models.selectedItems.value.slice();
     const {
       start,
       end
-    } = nodes;
-    // If last selection was a range selection ignore nodes that were selected.
+    } = items;
+    // If last selection was a range selection ignore items that were selected.
     if (lastSelectionWasRange.current) {
       base = base.filter(id => currentRangeSelection.current.indexOf(id) === -1);
     }
-    let range = getNodesInRange(start, end);
-    range = range.filter(node => !instance.isNodeDisabled(node));
+    let range = getItemsInRange(start, end);
+    range = range.filter(item => !instance.isItemDisabled(item));
     currentRangeSelection.current = range;
     let newSelected = base.concat(range);
     newSelected = newSelected.filter((id, i) => newSelected.indexOf(id) === i);
     setSelectedItems(event, newSelected);
   };
-  const selectRange = (event, nodes, stacked = false) => {
+  const selectRange = (event, items, stacked = false) => {
     if (params.disableSelection) {
       return;
     }
     const {
-      start = lastSelectedNode.current,
+      start = lastSelectedItem.current,
       end,
       current
-    } = nodes;
+    } = items;
     if (stacked) {
       handleRangeArrowSelect(event, {
         start,
@@ -145,28 +145,28 @@ const useTreeViewSelection = ({
     lastSelectionWasRange.current = true;
   };
   const rangeSelectToFirst = (event, itemId) => {
-    if (!lastSelectedNode.current) {
-      lastSelectedNode.current = itemId;
+    if (!lastSelectedItem.current) {
+      lastSelectedItem.current = itemId;
     }
-    const start = lastSelectionWasRange.current ? lastSelectedNode.current : itemId;
+    const start = lastSelectionWasRange.current ? lastSelectedItem.current : itemId;
     instance.selectRange(event, {
       start,
-      end: (0, _useTreeView.getFirstNode)(instance)
+      end: (0, _useTreeView.getFirstItem)(instance)
     });
   };
   const rangeSelectToLast = (event, itemId) => {
-    if (!lastSelectedNode.current) {
-      lastSelectedNode.current = itemId;
+    if (!lastSelectedItem.current) {
+      lastSelectedItem.current = itemId;
     }
-    const start = lastSelectionWasRange.current ? lastSelectedNode.current : itemId;
+    const start = lastSelectionWasRange.current ? lastSelectedItem.current : itemId;
     instance.selectRange(event, {
       start,
-      end: (0, _useTreeView.getLastNode)(instance)
+      end: (0, _useTreeView.getLastItem)(instance)
     });
   };
   (0, _useTreeView.populateInstance)(instance, {
-    isNodeSelected,
-    selectNode,
+    isItemSelected,
+    selectItem,
     selectRange,
     rangeSelectToLast,
     rangeSelectToFirst
@@ -188,11 +188,11 @@ useTreeViewSelection.models = {
     getDefaultValue: params => params.defaultSelectedItems
   }
 };
-const DEFAULT_SELECTED_NODES = [];
+const DEFAULT_SELECTED_ITEMS = [];
 useTreeViewSelection.getDefaultizedParams = params => (0, _extends2.default)({}, params, {
   disableSelection: params.disableSelection ?? false,
   multiSelect: params.multiSelect ?? false,
-  defaultSelectedItems: params.defaultSelectedItems ?? (params.multiSelect ? DEFAULT_SELECTED_NODES : null)
+  defaultSelectedItems: params.defaultSelectedItems ?? (params.multiSelect ? DEFAULT_SELECTED_ITEMS : null)
 });
 useTreeViewSelection.params = {
   disableSelection: true,

package/node/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.js

@@ -6,16 +6,16 @@ Object.defineProperty(exports, "__esModule", {
 exports.findOrderInTremauxTree = void 0;
 /**
  * This is used to determine the start and end of a selection range so
- * we can get the nodes between the two border nodes.
+ * we can get the items between the two border items.
  *
- * It finds the nodes' common ancestor using
+ * It finds the items' common ancestor using
  * a naive implementation of a lowest common ancestor algorithm
  * (https://en.wikipedia.org/wiki/Lowest_common_ancestor).
- * Then compares the ancestor's 2 children that are ancestors of nodeA and NodeB
- * so we can compare their indexes to work out which node comes first in a depth first search.
+ * Then compares the ancestor's 2 children that are ancestors of itemA and ItemB
+ * so we can compare their indexes to work out which item comes first in a depth first search.
  * (https://en.wikipedia.org/wiki/Depth-first_search)
  *
- * Another way to put it is which node is shallower in a trémaux tree
+ * Another way to put it is which item is shallower in a trémaux tree
  * https://en.wikipedia.org/wiki/Tr%C3%A9maux_tree
  */
 const findOrderInTremauxTree = (instance, nodeAId, nodeBId) => {

package/node/internals/useTreeView/useTreeView.utils.js

@@ -3,51 +3,51 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.populatePublicAPI = exports.populateInstance = exports.getPreviousNode = exports.getNextNode = exports.getLastNode = exports.getFirstNode = void 0;
-const getPreviousNode = (instance, itemId) => {
-  const item = instance.getNode(itemId);
-  const siblings = instance.getNavigableChildrenIds(item.parentId);
+exports.populatePublicAPI = exports.populateInstance = exports.getPreviousItem = exports.getNextItem = exports.getLastItem = exports.getFirstItem = void 0;
+const getPreviousItem = (instance, itemId) => {
+  const node = instance.getNode(itemId);
+  const siblings = instance.getNavigableChildrenIds(node.parentId);
   const itemIndex = siblings.indexOf(itemId);
   if (itemIndex === 0) {
-    return item.parentId;
+    return node.parentId;
   }
   let currentItem = siblings[itemIndex - 1];
-  while (instance.isNodeExpanded(currentItem) && instance.getNavigableChildrenIds(currentItem).length > 0) {
+  while (instance.isItemExpanded(currentItem) && instance.getNavigableChildrenIds(currentItem).length > 0) {
     currentItem = instance.getNavigableChildrenIds(currentItem).pop();
   }
   return currentItem;
 };
-exports.getPreviousNode = getPreviousNode;
-const getNextNode = (instance, itemId) => {
+exports.getPreviousItem = getPreviousItem;
+const getNextItem = (instance, itemId) => {
   // If expanded get first child
-  if (instance.isNodeExpanded(itemId) && instance.getNavigableChildrenIds(itemId).length > 0) {
+  if (instance.isItemExpanded(itemId) && instance.getNavigableChildrenIds(itemId).length > 0) {
     return instance.getNavigableChildrenIds(itemId)[0];
   }
-  let item = instance.getNode(itemId);
-  while (item != null) {
+  let node = instance.getNode(itemId);
+  while (node != null) {
     // Try to get next sibling
-    const siblings = instance.getNavigableChildrenIds(item.parentId);
-    const nextSibling = siblings[siblings.indexOf(item.id) + 1];
+    const siblings = instance.getNavigableChildrenIds(node.parentId);
+    const nextSibling = siblings[siblings.indexOf(node.id) + 1];
     if (nextSibling) {
       return nextSibling;
     }
 
     // If the sibling does not exist, go up a level to the parent and try again.
-    item = instance.getNode(item.parentId);
+    node = instance.getNode(node.parentId);
   }
   return null;
 };
-exports.getNextNode = getNextNode;
-const getLastNode = instance => {
+exports.getNextItem = getNextItem;
+const getLastItem = instance => {
   let lastItem = instance.getNavigableChildrenIds(null).pop();
-  while (instance.isNodeExpanded(lastItem)) {
+  while (instance.isItemExpanded(lastItem)) {
     lastItem = instance.getNavigableChildrenIds(lastItem).pop();
   }
   return lastItem;
 };
-exports.getLastNode = getLastNode;
-const getFirstNode = instance => instance.getNavigableChildrenIds(null)[0];
-exports.getFirstNode = getFirstNode;
+exports.getLastItem = getLastItem;
+const getFirstItem = instance => instance.getNavigableChildrenIds(null)[0];
+exports.getFirstItem = getFirstItem;
 const populateInstance = (instance, methods) => {
   Object.assign(instance, methods);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-tree-view",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "The community edition of the tree view components (MUI X).",
   "author": "MUI Team",
   "main": "./node/index.js",

package/useTreeItem2/useTreeItem2.d.ts

@@ -1,2 +1,2 @@
 import { UseTreeItem2Parameters, UseTreeItem2ReturnValue } from './useTreeItem2.types';
-export declare const useTreeItem2: <TPlugins extends [import("../internals").UseTreeViewIdSignature, import("../internals").UseTreeViewNodesSignature, import("../internals").UseTreeViewExpansionSignature, import("../internals").UseTreeViewSelectionSignature, import("../internals").UseTreeViewFocusSignature, import("../internals").UseTreeViewKeyboardNavigationSignature, import("../internals").UseTreeViewIconsSignature] = [import("../internals").UseTreeViewIdSignature, import("../internals").UseTreeViewNodesSignature, import("../internals").UseTreeViewExpansionSignature, import("../internals").UseTreeViewSelectionSignature, import("../internals").UseTreeViewFocusSignature, import("../internals").UseTreeViewKeyboardNavigationSignature, import("../internals").UseTreeViewIconsSignature]>(parameters: UseTreeItem2Parameters) => UseTreeItem2ReturnValue<TPlugins>;
+export declare const useTreeItem2: <TPlugins extends [import("../internals").UseTreeViewIdSignature, import("../internals").UseTreeViewItemsSignature, import("../internals").UseTreeViewExpansionSignature, import("../internals").UseTreeViewSelectionSignature, import("../internals").UseTreeViewFocusSignature, import("../internals").UseTreeViewKeyboardNavigationSignature, import("../internals").UseTreeViewIconsSignature] = [import("../internals").UseTreeViewIdSignature, import("../internals").UseTreeViewItemsSignature, import("../internals").UseTreeViewExpansionSignature, import("../internals").UseTreeViewSelectionSignature, import("../internals").UseTreeViewFocusSignature, import("../internals").UseTreeViewKeyboardNavigationSignature, import("../internals").UseTreeViewIconsSignature]>(parameters: UseTreeItem2Parameters) => UseTreeItem2ReturnValue<TPlugins>;

package/internals/plugins/useTreeViewJSXNodes/index.d.ts

@@ -1,2 +0,0 @@
-export { useTreeViewJSXNodes } from './useTreeViewJSXNodes';
-export type { UseTreeViewJSXNodesSignature, UseTreeViewNodesParameters, UseTreeViewNodesDefaultizedParameters, } from './useTreeViewJSXNodes.types';

package/internals/plugins/useTreeViewJSXNodes/index.js

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

package/internals/plugins/useTreeViewJSXNodes/useTreeViewJSXNodes.d.ts

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

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

@@ -1,18 +0,0 @@
-import { TreeViewNode, TreeViewPluginSignature } from '../../models';
-import { UseTreeViewNodesSignature } from '../useTreeViewNodes';
-import { UseTreeViewKeyboardNavigationSignature } from '../useTreeViewKeyboardNavigation';
-export interface UseTreeViewNodesInstance {
-    insertJSXNode: (node: TreeViewNode) => void;
-    removeJSXNode: (itemId: string) => void;
-    mapFirstCharFromJSX: (itemId: string, firstChar: string) => () => void;
-}
-export interface UseTreeViewNodesParameters {
-}
-export interface UseTreeViewNodesDefaultizedParameters {
-}
-export type UseTreeViewJSXNodesSignature = TreeViewPluginSignature<{
-    params: UseTreeViewNodesParameters;
-    defaultizedParams: UseTreeViewNodesDefaultizedParameters;
-    instance: UseTreeViewNodesInstance;
-    dependantPlugins: [UseTreeViewNodesSignature, UseTreeViewKeyboardNavigationSignature];
-}>;

package/internals/plugins/useTreeViewNodes/index.d.ts

@@ -1,2 +0,0 @@
-export { useTreeViewNodes } from './useTreeViewNodes';
-export type { UseTreeViewNodesSignature, UseTreeViewNodesParameters, UseTreeViewNodesDefaultizedParameters, } from './useTreeViewNodes.types';

package/internals/plugins/useTreeViewNodes/index.js

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

package/internals/plugins/useTreeViewNodes/useTreeViewNodes.d.ts

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

package/modern/internals/plugins/useTreeViewJSXNodes/index.js

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

package/modern/internals/plugins/useTreeViewNodes/index.js

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

package/node/internals/plugins/useTreeViewJSXNodes/index.js

@@ -1,12 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "useTreeViewJSXNodes", {
-  enumerable: true,
-  get: function () {
-    return _useTreeViewJSXNodes.useTreeViewJSXNodes;
-  }
-});
-var _useTreeViewJSXNodes = require("./useTreeViewJSXNodes");

package/node/internals/plugins/useTreeViewNodes/index.js

@@ -1,12 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "useTreeViewNodes", {
-  enumerable: true,
-  get: function () {
-    return _useTreeViewNodes.useTreeViewNodes;
-  }
-});
-var _useTreeViewNodes = require("./useTreeViewNodes");