@mui/x-tree-view 6.0.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/CHANGELOG.md +3682 -0
  2. package/LICENSE +21 -0
  3. package/README.md +34 -0
  4. package/TreeItem/TreeItem.d.ts +13 -0
  5. package/TreeItem/TreeItem.js +392 -0
  6. package/TreeItem/TreeItem.types.d.ts +84 -0
  7. package/TreeItem/TreeItem.types.js +1 -0
  8. package/TreeItem/TreeItemContent.d.ts +52 -0
  9. package/TreeItem/TreeItemContent.js +101 -0
  10. package/TreeItem/index.d.ts +5 -0
  11. package/TreeItem/index.js +4 -0
  12. package/TreeItem/package.json +6 -0
  13. package/TreeItem/treeItemClasses.d.ts +23 -0
  14. package/TreeItem/treeItemClasses.js +6 -0
  15. package/TreeItem/useTreeItem.d.ts +10 -0
  16. package/TreeItem/useTreeItem.js +68 -0
  17. package/TreeView/TreeView.d.ts +14 -0
  18. package/TreeView/TreeView.js +854 -0
  19. package/TreeView/TreeView.types.d.ts +170 -0
  20. package/TreeView/TreeView.types.js +1 -0
  21. package/TreeView/TreeViewContext.d.ts +6 -0
  22. package/TreeView/TreeViewContext.js +31 -0
  23. package/TreeView/descendants.d.ts +42 -0
  24. package/TreeView/descendants.js +186 -0
  25. package/TreeView/index.d.ts +3 -0
  26. package/TreeView/index.js +3 -0
  27. package/TreeView/package.json +6 -0
  28. package/TreeView/treeViewClasses.d.ts +7 -0
  29. package/TreeView/treeViewClasses.js +6 -0
  30. package/index.d.ts +2 -0
  31. package/index.js +9 -0
  32. package/internals/models.d.ts +1 -0
  33. package/internals/models.js +1 -0
  34. package/legacy/TreeItem/TreeItem.js +391 -0
  35. package/legacy/TreeItem/TreeItem.types.js +1 -0
  36. package/legacy/TreeItem/TreeItemContent.js +98 -0
  37. package/legacy/TreeItem/index.js +4 -0
  38. package/legacy/TreeItem/treeItemClasses.js +6 -0
  39. package/legacy/TreeItem/useTreeItem.js +67 -0
  40. package/legacy/TreeView/TreeView.js +907 -0
  41. package/legacy/TreeView/TreeView.types.js +1 -0
  42. package/legacy/TreeView/TreeViewContext.js +41 -0
  43. package/legacy/TreeView/descendants.js +199 -0
  44. package/legacy/TreeView/index.js +3 -0
  45. package/legacy/TreeView/treeViewClasses.js +6 -0
  46. package/legacy/index.js +9 -0
  47. package/legacy/internals/models.js +1 -0
  48. package/modern/TreeItem/TreeItem.js +391 -0
  49. package/modern/TreeItem/TreeItem.types.js +1 -0
  50. package/modern/TreeItem/TreeItemContent.js +101 -0
  51. package/modern/TreeItem/index.js +4 -0
  52. package/modern/TreeItem/treeItemClasses.js +6 -0
  53. package/modern/TreeItem/useTreeItem.js +68 -0
  54. package/modern/TreeView/TreeView.js +853 -0
  55. package/modern/TreeView/TreeView.types.js +1 -0
  56. package/modern/TreeView/TreeViewContext.js +31 -0
  57. package/modern/TreeView/descendants.js +186 -0
  58. package/modern/TreeView/index.js +3 -0
  59. package/modern/TreeView/treeViewClasses.js +6 -0
  60. package/modern/index.js +9 -0
  61. package/modern/internals/models.js +1 -0
  62. package/node/TreeItem/TreeItem.js +400 -0
  63. package/node/TreeItem/TreeItem.types.js +5 -0
  64. package/node/TreeItem/TreeItemContent.js +109 -0
  65. package/node/TreeItem/index.js +38 -0
  66. package/node/TreeItem/treeItemClasses.js +15 -0
  67. package/node/TreeItem/useTreeItem.js +76 -0
  68. package/node/TreeView/TreeView.js +862 -0
  69. package/node/TreeView/TreeView.types.js +5 -0
  70. package/node/TreeView/TreeViewContext.js +40 -0
  71. package/node/TreeView/descendants.js +194 -0
  72. package/node/TreeView/index.js +27 -0
  73. package/node/TreeView/treeViewClasses.js +15 -0
  74. package/node/index.js +34 -0
  75. package/node/internals/models.js +5 -0
  76. package/package.json +59 -0
@@ -0,0 +1,907 @@
1
+ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
2
+ import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
3
+ import _extends from "@babel/runtime/helpers/esm/extends";
4
+ var _excluded = ["children", "className", "defaultCollapseIcon", "defaultEndIcon", "defaultExpanded", "defaultExpandIcon", "defaultParentIcon", "defaultSelected", "disabledItemsFocusable", "disableSelection", "expanded", "id", "multiSelect", "onBlur", "onFocus", "onKeyDown", "onNodeFocus", "onNodeSelect", "onNodeToggle", "selected"];
5
+ import * as React from 'react';
6
+ import PropTypes from 'prop-types';
7
+ import clsx from 'clsx';
8
+ import { styled, useTheme, useThemeProps } from '@mui/material/styles';
9
+ import { unstable_composeClasses as composeClasses } from '@mui/base';
10
+ import useControlled from '@mui/utils/useControlled';
11
+ import useForkRef from '@mui/utils/useForkRef';
12
+ import ownerDocument from '@mui/utils/ownerDocument';
13
+ import useId from '@mui/utils/useId';
14
+ import { TreeViewContext } from './TreeViewContext';
15
+ import { DescendantProvider } from './descendants';
16
+ import { getTreeViewUtilityClass } from './treeViewClasses';
17
+ import { jsx as _jsx } from "react/jsx-runtime";
18
+ var useUtilityClasses = function useUtilityClasses(ownerState) {
19
+ var classes = ownerState.classes;
20
+ var slots = {
21
+ root: ['root']
22
+ };
23
+ return composeClasses(slots, getTreeViewUtilityClass, classes);
24
+ };
25
+ var TreeViewRoot = styled('ul', {
26
+ name: 'MuiTreeView',
27
+ slot: 'Root',
28
+ overridesResolver: function overridesResolver(props, styles) {
29
+ return styles.root;
30
+ }
31
+ })({
32
+ padding: 0,
33
+ margin: 0,
34
+ listStyle: 'none',
35
+ outline: 0
36
+ });
37
+ function isPrintableCharacter(string) {
38
+ return string && string.length === 1 && string.match(/\S/);
39
+ }
40
+ function findNextFirstChar(firstChars, startIndex, char) {
41
+ for (var i = startIndex; i < firstChars.length; i += 1) {
42
+ if (char === firstChars[i]) {
43
+ return i;
44
+ }
45
+ }
46
+ return -1;
47
+ }
48
+ function noopSelection() {
49
+ return false;
50
+ }
51
+ var defaultDefaultExpanded = [];
52
+ var defaultDefaultSelected = [];
53
+
54
+ /**
55
+ *
56
+ * Demos:
57
+ *
58
+ * - [Tree View](https://mui.com/material-ui/react-tree-view/)
59
+ *
60
+ * API:
61
+ *
62
+ * - [TreeView API](https://mui.com/material-ui/api/tree-view/)
63
+ */
64
+ var TreeView = /*#__PURE__*/React.forwardRef(function TreeView(inProps, ref) {
65
+ var _themeProps$disabledI, _themeProps$disableSe, _themeProps$multiSele, _themeProps$defaultEx, _themeProps$defaultSe;
66
+ var themeProps = useThemeProps({
67
+ props: inProps,
68
+ name: 'MuiTreeView'
69
+ });
70
+ var props = _extends({}, themeProps, {
71
+ disabledItemsFocusable: (_themeProps$disabledI = themeProps.disabledItemsFocusable) != null ? _themeProps$disabledI : false,
72
+ disableSelection: (_themeProps$disableSe = themeProps.disableSelection) != null ? _themeProps$disableSe : false,
73
+ multiSelect: (_themeProps$multiSele = themeProps.multiSelect) != null ? _themeProps$multiSele : false,
74
+ defaultExpanded: (_themeProps$defaultEx = themeProps.defaultExpanded) != null ? _themeProps$defaultEx : defaultDefaultExpanded,
75
+ defaultSelected: (_themeProps$defaultSe = themeProps.defaultSelected) != null ? _themeProps$defaultSe : defaultDefaultSelected
76
+ });
77
+ var children = props.children,
78
+ className = props.className,
79
+ defaultCollapseIcon = props.defaultCollapseIcon,
80
+ defaultEndIcon = props.defaultEndIcon,
81
+ defaultExpanded = props.defaultExpanded,
82
+ defaultExpandIcon = props.defaultExpandIcon,
83
+ defaultParentIcon = props.defaultParentIcon,
84
+ defaultSelected = props.defaultSelected,
85
+ disabledItemsFocusable = props.disabledItemsFocusable,
86
+ disableSelection = props.disableSelection,
87
+ expandedProp = props.expanded,
88
+ idProp = props.id,
89
+ multiSelect = props.multiSelect,
90
+ onBlur = props.onBlur,
91
+ onFocus = props.onFocus,
92
+ onKeyDown = props.onKeyDown,
93
+ onNodeFocus = props.onNodeFocus,
94
+ onNodeSelect = props.onNodeSelect,
95
+ onNodeToggle = props.onNodeToggle,
96
+ selectedProp = props.selected,
97
+ other = _objectWithoutProperties(props, _excluded);
98
+ var theme = useTheme();
99
+ var isRtl = theme.direction === 'rtl';
100
+ var classes = useUtilityClasses(props);
101
+ var treeId = useId(idProp);
102
+ var treeRef = React.useRef(null);
103
+ var handleRef = useForkRef(treeRef, ref);
104
+ var _React$useState = React.useState(null),
105
+ _React$useState2 = _slicedToArray(_React$useState, 2),
106
+ focusedNodeId = _React$useState2[0],
107
+ setFocusedNodeId = _React$useState2[1];
108
+ var nodeMap = React.useRef({});
109
+ var firstCharMap = React.useRef({});
110
+ var _useControlled = useControlled({
111
+ controlled: expandedProp,
112
+ default: defaultExpanded,
113
+ name: 'TreeView',
114
+ state: 'expanded'
115
+ }),
116
+ _useControlled2 = _slicedToArray(_useControlled, 2),
117
+ expanded = _useControlled2[0],
118
+ setExpandedState = _useControlled2[1];
119
+ var _useControlled3 = useControlled({
120
+ controlled: selectedProp,
121
+ default: defaultSelected,
122
+ name: 'TreeView',
123
+ state: 'selected'
124
+ }),
125
+ _useControlled4 = _slicedToArray(_useControlled3, 2),
126
+ selected = _useControlled4[0],
127
+ setSelectedState = _useControlled4[1];
128
+
129
+ /*
130
+ * Status Helpers
131
+ */
132
+ var isExpanded = React.useCallback(function (nodeId) {
133
+ return Array.isArray(expanded) ? expanded.indexOf(nodeId) !== -1 : false;
134
+ }, [expanded]);
135
+ var isExpandable = React.useCallback(function (nodeId) {
136
+ return nodeMap.current[nodeId] && nodeMap.current[nodeId].expandable;
137
+ }, []);
138
+ var isSelected = React.useCallback(function (nodeId) {
139
+ return Array.isArray(selected) ? selected.indexOf(nodeId) !== -1 : selected === nodeId;
140
+ }, [selected]);
141
+ var isDisabled = React.useCallback(function (nodeId) {
142
+ if (nodeId == null) {
143
+ return false;
144
+ }
145
+ var node = nodeMap.current[nodeId];
146
+
147
+ // This can be called before the node has been added to the node map.
148
+ if (!node) {
149
+ return false;
150
+ }
151
+ if (node.disabled) {
152
+ return true;
153
+ }
154
+ while (node.parentId != null) {
155
+ node = nodeMap.current[node.parentId];
156
+ if (node.disabled) {
157
+ return true;
158
+ }
159
+ }
160
+ return false;
161
+ }, []);
162
+ var isFocused = function isFocused(nodeId) {
163
+ return focusedNodeId === nodeId;
164
+ };
165
+
166
+ /*
167
+ * Child Helpers
168
+ */
169
+
170
+ // Using Object.keys -> .map to mimic Object.values we should replace with Object.values() once we stop IE11 support.
171
+ var getChildrenIds = function getChildrenIds(nodeId) {
172
+ return Object.keys(nodeMap.current).map(function (key) {
173
+ return nodeMap.current[key];
174
+ }).filter(function (node) {
175
+ return node.parentId === nodeId;
176
+ }).sort(function (a, b) {
177
+ return a.index - b.index;
178
+ }).map(function (child) {
179
+ return child.id;
180
+ });
181
+ };
182
+ var getNavigableChildrenIds = function getNavigableChildrenIds(nodeId) {
183
+ var childrenIds = getChildrenIds(nodeId);
184
+ if (!disabledItemsFocusable) {
185
+ childrenIds = childrenIds.filter(function (node) {
186
+ return !isDisabled(node);
187
+ });
188
+ }
189
+ return childrenIds;
190
+ };
191
+
192
+ /*
193
+ * Node Helpers
194
+ */
195
+
196
+ var getNextNode = function getNextNode(nodeId) {
197
+ // If expanded get first child
198
+ if (isExpanded(nodeId) && getNavigableChildrenIds(nodeId).length > 0) {
199
+ return getNavigableChildrenIds(nodeId)[0];
200
+ }
201
+ var node = nodeMap.current[nodeId];
202
+ while (node != null) {
203
+ // Try to get next sibling
204
+ var siblings = getNavigableChildrenIds(node.parentId);
205
+ var nextSibling = siblings[siblings.indexOf(node.id) + 1];
206
+ if (nextSibling) {
207
+ return nextSibling;
208
+ }
209
+
210
+ // If the sibling does not exist, go up a level to the parent and try again.
211
+ node = nodeMap.current[node.parentId];
212
+ }
213
+ return null;
214
+ };
215
+ var getPreviousNode = function getPreviousNode(nodeId) {
216
+ var node = nodeMap.current[nodeId];
217
+ var siblings = getNavigableChildrenIds(node.parentId);
218
+ var nodeIndex = siblings.indexOf(nodeId);
219
+ if (nodeIndex === 0) {
220
+ return node.parentId;
221
+ }
222
+ var currentNode = siblings[nodeIndex - 1];
223
+ while (isExpanded(currentNode) && getNavigableChildrenIds(currentNode).length > 0) {
224
+ currentNode = getNavigableChildrenIds(currentNode).pop();
225
+ }
226
+ return currentNode;
227
+ };
228
+ var getLastNode = function getLastNode() {
229
+ var lastNode = getNavigableChildrenIds(null).pop();
230
+ while (isExpanded(lastNode)) {
231
+ lastNode = getNavigableChildrenIds(lastNode).pop();
232
+ }
233
+ return lastNode;
234
+ };
235
+ var getFirstNode = function getFirstNode() {
236
+ return getNavigableChildrenIds(null)[0];
237
+ };
238
+ var getParent = function getParent(nodeId) {
239
+ return nodeMap.current[nodeId].parentId;
240
+ };
241
+
242
+ /**
243
+ * This is used to determine the start and end of a selection range so
244
+ * we can get the nodes between the two border nodes.
245
+ *
246
+ * It finds the nodes' common ancestor using
247
+ * a naive implementation of a lowest common ancestor algorithm
248
+ * (https://en.wikipedia.org/wiki/Lowest_common_ancestor).
249
+ * Then compares the ancestor's 2 children that are ancestors of nodeA and NodeB
250
+ * so we can compare their indexes to work out which node comes first in a depth first search.
251
+ * (https://en.wikipedia.org/wiki/Depth-first_search)
252
+ *
253
+ * Another way to put it is which node is shallower in a trémaux tree
254
+ * https://en.wikipedia.org/wiki/Tr%C3%A9maux_tree
255
+ */
256
+ var findOrderInTremauxTree = function findOrderInTremauxTree(nodeAId, nodeBId) {
257
+ if (nodeAId === nodeBId) {
258
+ return [nodeAId, nodeBId];
259
+ }
260
+ var nodeA = nodeMap.current[nodeAId];
261
+ var nodeB = nodeMap.current[nodeBId];
262
+ if (nodeA.parentId === nodeB.id || nodeB.parentId === nodeA.id) {
263
+ return nodeB.parentId === nodeA.id ? [nodeA.id, nodeB.id] : [nodeB.id, nodeA.id];
264
+ }
265
+ var aFamily = [nodeA.id];
266
+ var bFamily = [nodeB.id];
267
+ var aAncestor = nodeA.parentId;
268
+ var bAncestor = nodeB.parentId;
269
+ var aAncestorIsCommon = bFamily.indexOf(aAncestor) !== -1;
270
+ var bAncestorIsCommon = aFamily.indexOf(bAncestor) !== -1;
271
+ var continueA = true;
272
+ var continueB = true;
273
+ while (!bAncestorIsCommon && !aAncestorIsCommon) {
274
+ if (continueA) {
275
+ aFamily.push(aAncestor);
276
+ aAncestorIsCommon = bFamily.indexOf(aAncestor) !== -1;
277
+ continueA = aAncestor !== null;
278
+ if (!aAncestorIsCommon && continueA) {
279
+ aAncestor = nodeMap.current[aAncestor].parentId;
280
+ }
281
+ }
282
+ if (continueB && !aAncestorIsCommon) {
283
+ bFamily.push(bAncestor);
284
+ bAncestorIsCommon = aFamily.indexOf(bAncestor) !== -1;
285
+ continueB = bAncestor !== null;
286
+ if (!bAncestorIsCommon && continueB) {
287
+ bAncestor = nodeMap.current[bAncestor].parentId;
288
+ }
289
+ }
290
+ }
291
+ var commonAncestor = aAncestorIsCommon ? aAncestor : bAncestor;
292
+ var ancestorFamily = getChildrenIds(commonAncestor);
293
+ var aSide = aFamily[aFamily.indexOf(commonAncestor) - 1];
294
+ var bSide = bFamily[bFamily.indexOf(commonAncestor) - 1];
295
+ return ancestorFamily.indexOf(aSide) < ancestorFamily.indexOf(bSide) ? [nodeAId, nodeBId] : [nodeBId, nodeAId];
296
+ };
297
+ var getNodesInRange = function getNodesInRange(nodeAId, nodeBId) {
298
+ var _findOrderInTremauxTr = findOrderInTremauxTree(nodeAId, nodeBId),
299
+ _findOrderInTremauxTr2 = _slicedToArray(_findOrderInTremauxTr, 2),
300
+ first = _findOrderInTremauxTr2[0],
301
+ last = _findOrderInTremauxTr2[1];
302
+ var nodes = [first];
303
+ var current = first;
304
+ while (current !== last) {
305
+ current = getNextNode(current);
306
+ nodes.push(current);
307
+ }
308
+ return nodes;
309
+ };
310
+
311
+ /*
312
+ * Focus Helpers
313
+ */
314
+
315
+ var focus = function focus(event, nodeId) {
316
+ if (nodeId) {
317
+ setFocusedNodeId(nodeId);
318
+ if (onNodeFocus) {
319
+ onNodeFocus(event, nodeId);
320
+ }
321
+ }
322
+ };
323
+ var focusNextNode = function focusNextNode(event, nodeId) {
324
+ return focus(event, getNextNode(nodeId));
325
+ };
326
+ var focusPreviousNode = function focusPreviousNode(event, nodeId) {
327
+ return focus(event, getPreviousNode(nodeId));
328
+ };
329
+ var focusFirstNode = function focusFirstNode(event) {
330
+ return focus(event, getFirstNode());
331
+ };
332
+ var focusLastNode = function focusLastNode(event) {
333
+ return focus(event, getLastNode());
334
+ };
335
+ var focusByFirstCharacter = function focusByFirstCharacter(event, nodeId, firstChar) {
336
+ var start;
337
+ var index;
338
+ var lowercaseChar = firstChar.toLowerCase();
339
+ var firstCharIds = [];
340
+ var firstChars = [];
341
+ // This really only works since the ids are strings
342
+ Object.keys(firstCharMap.current).forEach(function (mapNodeId) {
343
+ var map = nodeMap.current[mapNodeId];
344
+ var visible = map.parentId ? isExpanded(map.parentId) : true;
345
+ var shouldBeSkipped = disabledItemsFocusable ? false : isDisabled(mapNodeId);
346
+ if (visible && !shouldBeSkipped) {
347
+ firstCharIds.push(mapNodeId);
348
+ firstChars.push(firstCharMap.current[mapNodeId]);
349
+ }
350
+ });
351
+
352
+ // Get start index for search based on position of currentItem
353
+ start = firstCharIds.indexOf(nodeId) + 1;
354
+ if (start >= firstCharIds.length) {
355
+ start = 0;
356
+ }
357
+
358
+ // Check remaining slots in the menu
359
+ index = findNextFirstChar(firstChars, start, lowercaseChar);
360
+
361
+ // If not found in remaining slots, check from beginning
362
+ if (index === -1) {
363
+ index = findNextFirstChar(firstChars, 0, lowercaseChar);
364
+ }
365
+
366
+ // If match was found...
367
+ if (index > -1) {
368
+ focus(event, firstCharIds[index]);
369
+ }
370
+ };
371
+
372
+ /*
373
+ * Expansion Helpers
374
+ */
375
+
376
+ var toggleExpansion = function toggleExpansion(event) {
377
+ var value = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : focusedNodeId;
378
+ if (value == null) {
379
+ return;
380
+ }
381
+ var newExpanded;
382
+ if (expanded.indexOf(value) !== -1) {
383
+ newExpanded = expanded.filter(function (id) {
384
+ return id !== value;
385
+ });
386
+ } else {
387
+ newExpanded = [value].concat(expanded);
388
+ }
389
+ if (onNodeToggle) {
390
+ onNodeToggle(event, newExpanded);
391
+ }
392
+ setExpandedState(newExpanded);
393
+ };
394
+ var expandAllSiblings = function expandAllSiblings(event, nodeId) {
395
+ var map = nodeMap.current[nodeId];
396
+ var siblings = getChildrenIds(map.parentId);
397
+ var diff = siblings.filter(function (child) {
398
+ return isExpandable(child) && !isExpanded(child);
399
+ });
400
+ var newExpanded = expanded.concat(diff);
401
+ if (diff.length > 0) {
402
+ setExpandedState(newExpanded);
403
+ if (onNodeToggle) {
404
+ onNodeToggle(event, newExpanded);
405
+ }
406
+ }
407
+ };
408
+
409
+ /*
410
+ * Selection Helpers
411
+ */
412
+
413
+ var lastSelectedNode = React.useRef(null);
414
+ var lastSelectionWasRange = React.useRef(false);
415
+ var currentRangeSelection = React.useRef([]);
416
+ var handleRangeArrowSelect = function handleRangeArrowSelect(event, nodes) {
417
+ var base = selected.slice();
418
+ var start = nodes.start,
419
+ next = nodes.next,
420
+ current = nodes.current;
421
+ if (!next || !current) {
422
+ return;
423
+ }
424
+ if (currentRangeSelection.current.indexOf(current) === -1) {
425
+ currentRangeSelection.current = [];
426
+ }
427
+ if (lastSelectionWasRange.current) {
428
+ if (currentRangeSelection.current.indexOf(next) !== -1) {
429
+ base = base.filter(function (id) {
430
+ return id === start || id !== current;
431
+ });
432
+ currentRangeSelection.current = currentRangeSelection.current.filter(function (id) {
433
+ return id === start || id !== current;
434
+ });
435
+ } else {
436
+ base.push(next);
437
+ currentRangeSelection.current.push(next);
438
+ }
439
+ } else {
440
+ base.push(next);
441
+ currentRangeSelection.current.push(current, next);
442
+ }
443
+ if (onNodeSelect) {
444
+ onNodeSelect(event, base);
445
+ }
446
+ setSelectedState(base);
447
+ };
448
+ var handleRangeSelect = function handleRangeSelect(event, nodes) {
449
+ var base = selected.slice();
450
+ var start = nodes.start,
451
+ end = nodes.end;
452
+ // If last selection was a range selection ignore nodes that were selected.
453
+ if (lastSelectionWasRange.current) {
454
+ base = base.filter(function (id) {
455
+ return currentRangeSelection.current.indexOf(id) === -1;
456
+ });
457
+ }
458
+ var range = getNodesInRange(start, end);
459
+ range = range.filter(function (node) {
460
+ return !isDisabled(node);
461
+ });
462
+ currentRangeSelection.current = range;
463
+ var newSelected = base.concat(range);
464
+ newSelected = newSelected.filter(function (id, i) {
465
+ return newSelected.indexOf(id) === i;
466
+ });
467
+ if (onNodeSelect) {
468
+ onNodeSelect(event, newSelected);
469
+ }
470
+ setSelectedState(newSelected);
471
+ };
472
+ var handleMultipleSelect = function handleMultipleSelect(event, nodeId) {
473
+ if (!Array.isArray(selected)) {
474
+ return;
475
+ }
476
+ var newSelected;
477
+ if (selected.indexOf(nodeId) !== -1) {
478
+ newSelected = selected.filter(function (id) {
479
+ return id !== nodeId;
480
+ });
481
+ } else {
482
+ newSelected = [nodeId].concat(selected);
483
+ }
484
+ if (onNodeSelect) {
485
+ onNodeSelect(event, newSelected);
486
+ }
487
+ setSelectedState(newSelected);
488
+ };
489
+ var handleSingleSelect = function handleSingleSelect(event, nodeId) {
490
+ var newSelected = multiSelect ? [nodeId] : nodeId;
491
+ if (onNodeSelect) {
492
+ onNodeSelect(event, newSelected);
493
+ }
494
+ setSelectedState(newSelected);
495
+ };
496
+ var selectNode = function selectNode(event, nodeId) {
497
+ var multiple = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
498
+ if (nodeId) {
499
+ if (multiple) {
500
+ handleMultipleSelect(event, nodeId);
501
+ } else {
502
+ handleSingleSelect(event, nodeId);
503
+ }
504
+ lastSelectedNode.current = nodeId;
505
+ lastSelectionWasRange.current = false;
506
+ currentRangeSelection.current = [];
507
+ return true;
508
+ }
509
+ return false;
510
+ };
511
+ var selectRange = function selectRange(event, nodes) {
512
+ var stacked = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
513
+ var _nodes$start = nodes.start,
514
+ start = _nodes$start === void 0 ? lastSelectedNode.current : _nodes$start,
515
+ end = nodes.end,
516
+ current = nodes.current;
517
+ if (stacked) {
518
+ handleRangeArrowSelect(event, {
519
+ start: start,
520
+ next: end,
521
+ current: current
522
+ });
523
+ } else if (start != null && end != null) {
524
+ handleRangeSelect(event, {
525
+ start: start,
526
+ end: end
527
+ });
528
+ }
529
+ lastSelectionWasRange.current = true;
530
+ };
531
+ var rangeSelectToFirst = function rangeSelectToFirst(event, id) {
532
+ if (!lastSelectedNode.current) {
533
+ lastSelectedNode.current = id;
534
+ }
535
+ var start = lastSelectionWasRange.current ? lastSelectedNode.current : id;
536
+ selectRange(event, {
537
+ start: start,
538
+ end: getFirstNode()
539
+ });
540
+ };
541
+ var rangeSelectToLast = function rangeSelectToLast(event, id) {
542
+ if (!lastSelectedNode.current) {
543
+ lastSelectedNode.current = id;
544
+ }
545
+ var start = lastSelectionWasRange.current ? lastSelectedNode.current : id;
546
+ selectRange(event, {
547
+ start: start,
548
+ end: getLastNode()
549
+ });
550
+ };
551
+ var selectNextNode = function selectNextNode(event, id) {
552
+ if (!isDisabled(getNextNode(id))) {
553
+ selectRange(event, {
554
+ end: getNextNode(id),
555
+ current: id
556
+ }, true);
557
+ }
558
+ };
559
+ var selectPreviousNode = function selectPreviousNode(event, id) {
560
+ if (!isDisabled(getPreviousNode(id))) {
561
+ selectRange(event, {
562
+ end: getPreviousNode(id),
563
+ current: id
564
+ }, true);
565
+ }
566
+ };
567
+ var selectAllNodes = function selectAllNodes(event) {
568
+ selectRange(event, {
569
+ start: getFirstNode(),
570
+ end: getLastNode()
571
+ });
572
+ };
573
+
574
+ /*
575
+ * Mapping Helpers
576
+ */
577
+ var registerNode = React.useCallback(function (node) {
578
+ var id = node.id,
579
+ index = node.index,
580
+ parentId = node.parentId,
581
+ expandable = node.expandable,
582
+ idAttribute = node.idAttribute,
583
+ disabled = node.disabled;
584
+ nodeMap.current[id] = {
585
+ id: id,
586
+ index: index,
587
+ parentId: parentId,
588
+ expandable: expandable,
589
+ idAttribute: idAttribute,
590
+ disabled: disabled
591
+ };
592
+ }, []);
593
+ var unregisterNode = React.useCallback(function (nodeId) {
594
+ var newMap = _extends({}, nodeMap.current);
595
+ delete newMap[nodeId];
596
+ nodeMap.current = newMap;
597
+ setFocusedNodeId(function (oldFocusedNodeId) {
598
+ if (oldFocusedNodeId === nodeId && treeRef.current === ownerDocument(treeRef.current).activeElement) {
599
+ return getChildrenIds(null)[0];
600
+ }
601
+ return oldFocusedNodeId;
602
+ });
603
+ }, []);
604
+ var mapFirstChar = React.useCallback(function (nodeId, firstChar) {
605
+ firstCharMap.current[nodeId] = firstChar;
606
+ }, []);
607
+ var unMapFirstChar = React.useCallback(function (nodeId) {
608
+ var newMap = _extends({}, firstCharMap.current);
609
+ delete newMap[nodeId];
610
+ firstCharMap.current = newMap;
611
+ }, []);
612
+
613
+ /**
614
+ * Event handlers and Navigation
615
+ */
616
+
617
+ var handleNextArrow = function handleNextArrow(event) {
618
+ if (focusedNodeId != null && isExpandable(focusedNodeId)) {
619
+ if (isExpanded(focusedNodeId)) {
620
+ focusNextNode(event, focusedNodeId);
621
+ } else if (!isDisabled(focusedNodeId)) {
622
+ toggleExpansion(event);
623
+ }
624
+ }
625
+ return true;
626
+ };
627
+ var handlePreviousArrow = function handlePreviousArrow(event) {
628
+ if (focusedNodeId == null) {
629
+ return false;
630
+ }
631
+ if (isExpanded(focusedNodeId) && !isDisabled(focusedNodeId)) {
632
+ toggleExpansion(event, focusedNodeId);
633
+ return true;
634
+ }
635
+ var parent = getParent(focusedNodeId);
636
+ if (parent) {
637
+ focus(event, parent);
638
+ return true;
639
+ }
640
+ return false;
641
+ };
642
+ var handleKeyDown = function handleKeyDown(event) {
643
+ var flag = false;
644
+ var key = event.key;
645
+
646
+ // If the tree is empty there will be no focused node
647
+ if (event.altKey || event.currentTarget !== event.target || !focusedNodeId) {
648
+ return;
649
+ }
650
+ var ctrlPressed = event.ctrlKey || event.metaKey;
651
+ switch (key) {
652
+ case ' ':
653
+ if (!disableSelection && focusedNodeId != null && !isDisabled(focusedNodeId)) {
654
+ if (multiSelect && event.shiftKey) {
655
+ selectRange(event, {
656
+ end: focusedNodeId
657
+ });
658
+ flag = true;
659
+ } else if (multiSelect) {
660
+ flag = selectNode(event, focusedNodeId, true);
661
+ } else {
662
+ flag = selectNode(event, focusedNodeId);
663
+ }
664
+ }
665
+ event.stopPropagation();
666
+ break;
667
+ case 'Enter':
668
+ if (!isDisabled(focusedNodeId)) {
669
+ if (isExpandable(focusedNodeId)) {
670
+ toggleExpansion(event);
671
+ flag = true;
672
+ } else if (multiSelect) {
673
+ flag = selectNode(event, focusedNodeId, true);
674
+ } else {
675
+ flag = selectNode(event, focusedNodeId);
676
+ }
677
+ }
678
+ event.stopPropagation();
679
+ break;
680
+ case 'ArrowDown':
681
+ if (multiSelect && event.shiftKey && !disableSelection) {
682
+ selectNextNode(event, focusedNodeId);
683
+ }
684
+ focusNextNode(event, focusedNodeId);
685
+ flag = true;
686
+ break;
687
+ case 'ArrowUp':
688
+ if (multiSelect && event.shiftKey && !disableSelection) {
689
+ selectPreviousNode(event, focusedNodeId);
690
+ }
691
+ focusPreviousNode(event, focusedNodeId);
692
+ flag = true;
693
+ break;
694
+ case 'ArrowRight':
695
+ if (isRtl) {
696
+ flag = handlePreviousArrow(event);
697
+ } else {
698
+ flag = handleNextArrow(event);
699
+ }
700
+ break;
701
+ case 'ArrowLeft':
702
+ if (isRtl) {
703
+ flag = handleNextArrow(event);
704
+ } else {
705
+ flag = handlePreviousArrow(event);
706
+ }
707
+ break;
708
+ case 'Home':
709
+ if (multiSelect && ctrlPressed && event.shiftKey && !disableSelection && !isDisabled(focusedNodeId)) {
710
+ rangeSelectToFirst(event, focusedNodeId);
711
+ }
712
+ focusFirstNode(event);
713
+ flag = true;
714
+ break;
715
+ case 'End':
716
+ if (multiSelect && ctrlPressed && event.shiftKey && !disableSelection && !isDisabled(focusedNodeId)) {
717
+ rangeSelectToLast(event, focusedNodeId);
718
+ }
719
+ focusLastNode(event);
720
+ flag = true;
721
+ break;
722
+ default:
723
+ if (key === '*') {
724
+ expandAllSiblings(event, focusedNodeId);
725
+ flag = true;
726
+ } else if (multiSelect && ctrlPressed && key.toLowerCase() === 'a' && !disableSelection) {
727
+ selectAllNodes(event);
728
+ flag = true;
729
+ } else if (!ctrlPressed && !event.shiftKey && isPrintableCharacter(key)) {
730
+ focusByFirstCharacter(event, focusedNodeId, key);
731
+ flag = true;
732
+ }
733
+ }
734
+ if (flag) {
735
+ event.preventDefault();
736
+ event.stopPropagation();
737
+ }
738
+ if (onKeyDown) {
739
+ onKeyDown(event);
740
+ }
741
+ };
742
+ var handleFocus = function handleFocus(event) {
743
+ // if the event bubbled (which is React specific) we don't want to steal focus
744
+ if (event.target === event.currentTarget) {
745
+ var firstSelected = Array.isArray(selected) ? selected[0] : selected;
746
+ focus(event, firstSelected || getNavigableChildrenIds(null)[0]);
747
+ }
748
+ if (onFocus) {
749
+ onFocus(event);
750
+ }
751
+ };
752
+ var handleBlur = function handleBlur(event) {
753
+ setFocusedNodeId(null);
754
+ if (onBlur) {
755
+ onBlur(event);
756
+ }
757
+ };
758
+ var activeDescendant = nodeMap.current[focusedNodeId] ? nodeMap.current[focusedNodeId].idAttribute : null;
759
+ return /*#__PURE__*/_jsx(TreeViewContext.Provider, {
760
+ // TODO: fix this lint error
761
+ // eslint-disable-next-line react/jsx-no-constructed-context-values
762
+ value: {
763
+ icons: {
764
+ defaultCollapseIcon: defaultCollapseIcon,
765
+ defaultExpandIcon: defaultExpandIcon,
766
+ defaultParentIcon: defaultParentIcon,
767
+ defaultEndIcon: defaultEndIcon
768
+ },
769
+ focus: focus,
770
+ toggleExpansion: toggleExpansion,
771
+ isExpanded: isExpanded,
772
+ isExpandable: isExpandable,
773
+ isFocused: isFocused,
774
+ isSelected: isSelected,
775
+ isDisabled: isDisabled,
776
+ selectNode: disableSelection ? noopSelection : selectNode,
777
+ selectRange: disableSelection ? noopSelection : selectRange,
778
+ multiSelect: multiSelect,
779
+ disabledItemsFocusable: disabledItemsFocusable,
780
+ mapFirstChar: mapFirstChar,
781
+ unMapFirstChar: unMapFirstChar,
782
+ registerNode: registerNode,
783
+ unregisterNode: unregisterNode,
784
+ treeId: treeId
785
+ },
786
+ children: /*#__PURE__*/_jsx(DescendantProvider, {
787
+ children: /*#__PURE__*/_jsx(TreeViewRoot, _extends({
788
+ role: "tree",
789
+ id: treeId,
790
+ "aria-activedescendant": activeDescendant != null ? activeDescendant : undefined,
791
+ "aria-multiselectable": multiSelect,
792
+ className: clsx(classes.root, className),
793
+ tabIndex: 0,
794
+ onKeyDown: handleKeyDown,
795
+ onFocus: handleFocus,
796
+ onBlur: handleBlur,
797
+ ownerState: props
798
+ }, other, {
799
+ ref: handleRef,
800
+ children: children
801
+ }))
802
+ })
803
+ });
804
+ });
805
+ process.env.NODE_ENV !== "production" ? TreeView.propTypes = {
806
+ // ----------------------------- Warning --------------------------------
807
+ // | These PropTypes are generated from the TypeScript type definitions |
808
+ // | To update them edit the TypeScript types and run "yarn proptypes" |
809
+ // ----------------------------------------------------------------------
810
+ /**
811
+ * The content of the component.
812
+ */
813
+ children: PropTypes.node,
814
+ /**
815
+ * Override or extend the styles applied to the component.
816
+ */
817
+ classes: PropTypes.object,
818
+ /**
819
+ * className applied to the root element.
820
+ */
821
+ className: PropTypes.string,
822
+ /**
823
+ * The default icon used to collapse the node.
824
+ */
825
+ defaultCollapseIcon: PropTypes.node,
826
+ /**
827
+ * The default icon displayed next to a end node. This is applied to all
828
+ * tree nodes and can be overridden by the TreeItem `icon` prop.
829
+ */
830
+ defaultEndIcon: PropTypes.node,
831
+ /**
832
+ * Expanded node ids.
833
+ * Used when the item's expansion are not controlled.
834
+ * @default []
835
+ */
836
+ defaultExpanded: PropTypes.arrayOf(PropTypes.string),
837
+ /**
838
+ * The default icon used to expand the node.
839
+ */
840
+ defaultExpandIcon: PropTypes.node,
841
+ /**
842
+ * The default icon displayed next to a parent node. This is applied to all
843
+ * parent nodes and can be overridden by the TreeItem `icon` prop.
844
+ */
845
+ defaultParentIcon: PropTypes.node,
846
+ /**
847
+ * Selected node ids. (Uncontrolled)
848
+ * When `multiSelect` is true this takes an array of strings; when false (default) a string.
849
+ * @default []
850
+ */
851
+ defaultSelected: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.string]),
852
+ /**
853
+ * If `true`, will allow focus on disabled items.
854
+ * @default false
855
+ */
856
+ disabledItemsFocusable: PropTypes.bool,
857
+ /**
858
+ * If `true` selection is disabled.
859
+ * @default false
860
+ */
861
+ disableSelection: PropTypes.bool,
862
+ /**
863
+ * Expanded node ids.
864
+ * Used when the item's expansion are controlled.
865
+ */
866
+ expanded: PropTypes.arrayOf(PropTypes.string),
867
+ /**
868
+ * This prop is used to help implement the accessibility logic.
869
+ * If you don't provide this prop. It falls back to a randomly generated id.
870
+ */
871
+ id: PropTypes.string,
872
+ /**
873
+ * If true `ctrl` and `shift` will trigger multiselect.
874
+ * @default false
875
+ */
876
+ multiSelect: PropTypes.bool,
877
+ /**
878
+ * Callback fired when tree items are focused.
879
+ * @param {React.SyntheticEvent} event The event source of the callback **Warning**: This is a generic event not a focus event.
880
+ * @param {string} nodeId The id of the node focused.
881
+ * @param {string} value of the focused node.
882
+ */
883
+ onNodeFocus: PropTypes.func,
884
+ /**
885
+ * Callback fired when tree items are selected/unselected.
886
+ * @param {React.SyntheticEvent} event The event source of the callback
887
+ * @param {string[] | string} nodeIds Ids of the selected nodes. When `multiSelect` is true
888
+ * this is an array of strings; when false (default) a string.
889
+ */
890
+ onNodeSelect: PropTypes.func,
891
+ /**
892
+ * Callback fired when tree items are expanded/collapsed.
893
+ * @param {React.SyntheticEvent} event The event source of the callback.
894
+ * @param {array} nodeIds The ids of the expanded nodes.
895
+ */
896
+ onNodeToggle: PropTypes.func,
897
+ /**
898
+ * Selected node ids. (Controlled)
899
+ * When `multiSelect` is true this takes an array of strings; when false (default) a string.
900
+ */
901
+ selected: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.string]),
902
+ /**
903
+ * The system prop that allows defining system overrides as well as additional CSS styles.
904
+ */
905
+ sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object])
906
+ } : void 0;
907
+ export { TreeView };