@mui/lab 5.0.0-alpha.141 → 5.0.0-alpha.143

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