@fluentui/react-tree 9.16.9 → 9.17.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 (227) hide show
  1. package/CHANGELOG.md +20 -2
  2. package/dist/index.d.cts +83 -6
  3. package/dist/index.d.ts +83 -6
  4. package/lib/Tree.js +1 -1
  5. package/lib/Tree.js.map +1 -1
  6. package/lib/TreeItemLayout.js +1 -1
  7. package/lib/TreeItemLayout.js.map +1 -1
  8. package/lib/components/FlatTree/FlatTree.js.map +1 -1
  9. package/lib/components/FlatTree/FlatTree.types.js.map +1 -1
  10. package/lib/components/FlatTree/index.js.map +1 -1
  11. package/lib/components/FlatTree/renderFlatTree.js.map +1 -1
  12. package/lib/components/FlatTree/useFlatControllableCheckedItems.js.map +1 -1
  13. package/lib/components/FlatTree/useFlatTree.js +28 -3
  14. package/lib/components/FlatTree/useFlatTree.js.map +1 -1
  15. package/lib/components/FlatTree/useFlatTreeContextValues.js.map +1 -1
  16. package/lib/components/FlatTree/useFlatTreeStyles.styles.raw.js.map +1 -1
  17. package/lib/components/FlatTree/useHeadlessFlatTree.js.map +1 -1
  18. package/lib/components/FlatTreeItem/FlatTreeItem.js.map +1 -1
  19. package/lib/components/FlatTreeItem/FlatTreeItem.types.js.map +1 -1
  20. package/lib/components/FlatTreeItem/index.js.map +1 -1
  21. package/lib/components/Tree/Tree.js.map +1 -1
  22. package/lib/components/Tree/Tree.types.js +1 -1
  23. package/lib/components/Tree/Tree.types.js.map +1 -1
  24. package/lib/components/Tree/index.js +1 -1
  25. package/lib/components/Tree/index.js.map +1 -1
  26. package/lib/components/Tree/renderTree.js +8 -4
  27. package/lib/components/Tree/renderTree.js.map +1 -1
  28. package/lib/components/Tree/useNestedControllableCheckedItems.js.map +1 -1
  29. package/lib/components/Tree/useTree.js +75 -6
  30. package/lib/components/Tree/useTree.js.map +1 -1
  31. package/lib/components/Tree/useTreeContextValues.js +4 -1
  32. package/lib/components/Tree/useTreeContextValues.js.map +1 -1
  33. package/lib/components/Tree/useTreeStyles.styles.raw.js.map +1 -1
  34. package/lib/components/TreeItem/TreeItem.js.map +1 -1
  35. package/lib/components/TreeItem/TreeItem.types.js.map +1 -1
  36. package/lib/components/TreeItem/index.js.map +1 -1
  37. package/lib/components/TreeItem/renderTreeItem.js +2 -2
  38. package/lib/components/TreeItem/renderTreeItem.js.map +1 -1
  39. package/lib/components/TreeItem/useTreeItem.js +1 -1
  40. package/lib/components/TreeItem/useTreeItem.js.map +1 -1
  41. package/lib/components/TreeItem/useTreeItemContextValues.js.map +1 -1
  42. package/lib/components/TreeItem/useTreeItemStyles.styles.raw.js.map +1 -1
  43. package/lib/components/TreeItemChevron.js.map +1 -1
  44. package/lib/components/TreeItemLayout/TreeItemLayout.js.map +1 -1
  45. package/lib/components/TreeItemLayout/TreeItemLayout.types.js +1 -1
  46. package/lib/components/TreeItemLayout/TreeItemLayout.types.js.map +1 -1
  47. package/lib/components/TreeItemLayout/index.js +1 -1
  48. package/lib/components/TreeItemLayout/index.js.map +1 -1
  49. package/lib/components/TreeItemLayout/renderTreeItemLayout.js +14 -8
  50. package/lib/components/TreeItemLayout/renderTreeItemLayout.js.map +1 -1
  51. package/lib/components/TreeItemLayout/useTreeItemLayout.js +201 -30
  52. package/lib/components/TreeItemLayout/useTreeItemLayout.js.map +1 -1
  53. package/lib/components/TreeItemLayout/useTreeItemLayoutStyles.styles.raw.js.map +1 -1
  54. package/lib/components/TreeItemPersonaLayout/TreeItemPersonaLayout.js.map +1 -1
  55. package/lib/components/TreeItemPersonaLayout/TreeItemPersonaLayout.types.js.map +1 -1
  56. package/lib/components/TreeItemPersonaLayout/index.js.map +1 -1
  57. package/lib/components/TreeItemPersonaLayout/renderTreeItemPersonaLayout.js +2 -2
  58. package/lib/components/TreeItemPersonaLayout/renderTreeItemPersonaLayout.js.map +1 -1
  59. package/lib/components/TreeItemPersonaLayout/useTreeItemPersonaLayout.js.map +1 -1
  60. package/lib/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutContextValues.js.map +1 -1
  61. package/lib/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutStyles.styles.raw.js.map +1 -1
  62. package/lib/components/TreeProvider.js.map +1 -1
  63. package/lib/contexts/index.js.map +1 -1
  64. package/lib/contexts/subtreeContext.js.map +1 -1
  65. package/lib/contexts/treeContext.js.map +1 -1
  66. package/lib/contexts/treeItemContext.js.map +1 -1
  67. package/lib/hooks/useControllableOpenItems.js.map +1 -1
  68. package/lib/hooks/useFlatTreeNavigation.js +3 -4
  69. package/lib/hooks/useFlatTreeNavigation.js.map +1 -1
  70. package/lib/hooks/useHTMLElementWalkerRef.js.map +1 -1
  71. package/lib/hooks/useRootTree.js +4 -9
  72. package/lib/hooks/useRootTree.js.map +1 -1
  73. package/lib/hooks/useRovingTabIndexBase.js +108 -0
  74. package/lib/hooks/useRovingTabIndexBase.js.map +1 -0
  75. package/lib/hooks/useRovingTabIndexes.js +2 -61
  76. package/lib/hooks/useRovingTabIndexes.js.map +1 -1
  77. package/lib/hooks/useSubtree.js +1 -11
  78. package/lib/hooks/useSubtree.js.map +1 -1
  79. package/lib/hooks/useTreeNavigation.js +6 -84
  80. package/lib/hooks/useTreeNavigation.js.map +1 -1
  81. package/lib/hooks/useTreeNavigationBase.js +131 -0
  82. package/lib/hooks/useTreeNavigationBase.js.map +1 -0
  83. package/lib/index.js +2 -2
  84. package/lib/index.js.map +1 -1
  85. package/lib/utils/ImmutableMap.js.map +1 -1
  86. package/lib/utils/ImmutableSet.js.map +1 -1
  87. package/lib/utils/assert.js.map +1 -1
  88. package/lib/utils/createCheckedItems.js.map +1 -1
  89. package/lib/utils/createHTMLElementWalker.js +2 -2
  90. package/lib/utils/createHTMLElementWalker.js.map +1 -1
  91. package/lib/utils/createHeadlessTree.js +4 -4
  92. package/lib/utils/createHeadlessTree.js.map +1 -1
  93. package/lib/utils/flattenTree.js.map +1 -1
  94. package/lib/utils/getTreeItemValueFromElement.js.map +1 -1
  95. package/lib/utils/nextTypeAheadElement.js.map +1 -1
  96. package/lib/utils/normalizeOpenItems.js.map +1 -1
  97. package/lib/utils/queryTreeItemActions.js +29 -0
  98. package/lib/utils/queryTreeItemActions.js.map +1 -0
  99. package/lib/utils/tokens.js.map +1 -1
  100. package/lib/utils/treeItemFilter.js.map +1 -1
  101. package/lib-commonjs/FlatTree.cjs +8 -8
  102. package/lib-commonjs/Tree.cjs +10 -7
  103. package/lib-commonjs/Tree.cjs.map +1 -1
  104. package/lib-commonjs/TreeItem.cjs +7 -7
  105. package/lib-commonjs/TreeItemLayout.cjs +9 -6
  106. package/lib-commonjs/TreeItemLayout.cjs.map +1 -1
  107. package/lib-commonjs/TreeItemPersonaLayout.cjs +6 -6
  108. package/lib-commonjs/components/FlatTree/FlatTree.cjs.map +1 -1
  109. package/lib-commonjs/components/FlatTree/FlatTree.types.cjs.map +1 -1
  110. package/lib-commonjs/components/FlatTree/index.cjs +8 -8
  111. package/lib-commonjs/components/FlatTree/index.cjs.map +1 -1
  112. package/lib-commonjs/components/FlatTree/renderFlatTree.cjs.map +1 -1
  113. package/lib-commonjs/components/FlatTree/useFlatControllableCheckedItems.cjs +3 -3
  114. package/lib-commonjs/components/FlatTree/useFlatControllableCheckedItems.cjs.map +1 -1
  115. package/lib-commonjs/components/FlatTree/useFlatTree.cjs +28 -3
  116. package/lib-commonjs/components/FlatTree/useFlatTree.cjs.map +1 -1
  117. package/lib-commonjs/components/FlatTree/useFlatTreeContextValues.cjs.map +1 -1
  118. package/lib-commonjs/components/FlatTree/useFlatTreeStyles.styles.cjs +3 -3
  119. package/lib-commonjs/components/FlatTree/useFlatTreeStyles.styles.cjs.map +1 -1
  120. package/lib-commonjs/components/FlatTree/useFlatTreeStyles.styles.raw.cjs +3 -3
  121. package/lib-commonjs/components/FlatTree/useFlatTreeStyles.styles.raw.cjs.map +1 -1
  122. package/lib-commonjs/components/FlatTree/useHeadlessFlatTree.cjs.map +1 -1
  123. package/lib-commonjs/components/FlatTreeItem/FlatTreeItem.cjs.map +1 -1
  124. package/lib-commonjs/components/FlatTreeItem/FlatTreeItem.types.cjs.map +1 -1
  125. package/lib-commonjs/components/FlatTreeItem/index.cjs.map +1 -1
  126. package/lib-commonjs/components/Tree/Tree.cjs.map +1 -1
  127. package/lib-commonjs/components/Tree/Tree.types.cjs +1 -1
  128. package/lib-commonjs/components/Tree/Tree.types.cjs.map +1 -1
  129. package/lib-commonjs/components/Tree/index.cjs +10 -7
  130. package/lib-commonjs/components/Tree/index.cjs.map +1 -1
  131. package/lib-commonjs/components/Tree/renderTree.cjs +1 -1
  132. package/lib-commonjs/components/Tree/renderTree.cjs.map +1 -1
  133. package/lib-commonjs/components/Tree/useNestedControllableCheckedItems.cjs +3 -3
  134. package/lib-commonjs/components/Tree/useNestedControllableCheckedItems.cjs.map +1 -1
  135. package/lib-commonjs/components/Tree/useTree.cjs +68 -8
  136. package/lib-commonjs/components/Tree/useTree.cjs.map +1 -1
  137. package/lib-commonjs/components/Tree/useTreeContextValues.cjs +4 -1
  138. package/lib-commonjs/components/Tree/useTreeContextValues.cjs.map +1 -1
  139. package/lib-commonjs/components/Tree/useTreeStyles.styles.cjs +3 -3
  140. package/lib-commonjs/components/Tree/useTreeStyles.styles.cjs.map +1 -1
  141. package/lib-commonjs/components/Tree/useTreeStyles.styles.raw.cjs +3 -3
  142. package/lib-commonjs/components/Tree/useTreeStyles.styles.raw.cjs.map +1 -1
  143. package/lib-commonjs/components/TreeItem/TreeItem.cjs.map +1 -1
  144. package/lib-commonjs/components/TreeItem/TreeItem.types.cjs.map +1 -1
  145. package/lib-commonjs/components/TreeItem/index.cjs +7 -7
  146. package/lib-commonjs/components/TreeItem/index.cjs.map +1 -1
  147. package/lib-commonjs/components/TreeItem/renderTreeItem.cjs.map +1 -1
  148. package/lib-commonjs/components/TreeItem/useTreeItem.cjs +1 -1
  149. package/lib-commonjs/components/TreeItem/useTreeItem.cjs.map +1 -1
  150. package/lib-commonjs/components/TreeItem/useTreeItemContextValues.cjs.map +1 -1
  151. package/lib-commonjs/components/TreeItem/useTreeItemStyles.styles.cjs +3 -3
  152. package/lib-commonjs/components/TreeItem/useTreeItemStyles.styles.cjs.map +1 -1
  153. package/lib-commonjs/components/TreeItem/useTreeItemStyles.styles.raw.cjs +3 -3
  154. package/lib-commonjs/components/TreeItem/useTreeItemStyles.styles.raw.cjs.map +1 -1
  155. package/lib-commonjs/components/TreeItemChevron.cjs.map +1 -1
  156. package/lib-commonjs/components/TreeItemLayout/TreeItemLayout.cjs.map +1 -1
  157. package/lib-commonjs/components/TreeItemLayout/TreeItemLayout.types.cjs +1 -1
  158. package/lib-commonjs/components/TreeItemLayout/TreeItemLayout.types.cjs.map +1 -1
  159. package/lib-commonjs/components/TreeItemLayout/index.cjs +9 -6
  160. package/lib-commonjs/components/TreeItemLayout/index.cjs.map +1 -1
  161. package/lib-commonjs/components/TreeItemLayout/renderTreeItemLayout.cjs +9 -6
  162. package/lib-commonjs/components/TreeItemLayout/renderTreeItemLayout.cjs.map +1 -1
  163. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayout.cjs +200 -32
  164. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayout.cjs.map +1 -1
  165. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayoutStyles.styles.cjs +3 -3
  166. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayoutStyles.styles.cjs.map +1 -1
  167. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayoutStyles.styles.raw.cjs +3 -3
  168. package/lib-commonjs/components/TreeItemLayout/useTreeItemLayoutStyles.styles.raw.cjs.map +1 -1
  169. package/lib-commonjs/components/TreeItemPersonaLayout/TreeItemPersonaLayout.cjs.map +1 -1
  170. package/lib-commonjs/components/TreeItemPersonaLayout/TreeItemPersonaLayout.types.cjs.map +1 -1
  171. package/lib-commonjs/components/TreeItemPersonaLayout/index.cjs +6 -6
  172. package/lib-commonjs/components/TreeItemPersonaLayout/index.cjs.map +1 -1
  173. package/lib-commonjs/components/TreeItemPersonaLayout/renderTreeItemPersonaLayout.cjs.map +1 -1
  174. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayout.cjs.map +1 -1
  175. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutContextValues.cjs.map +1 -1
  176. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutStyles.styles.cjs +3 -3
  177. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutStyles.styles.cjs.map +1 -1
  178. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutStyles.styles.raw.cjs +3 -3
  179. package/lib-commonjs/components/TreeItemPersonaLayout/useTreeItemPersonaLayoutStyles.styles.raw.cjs.map +1 -1
  180. package/lib-commonjs/components/TreeProvider.cjs +3 -3
  181. package/lib-commonjs/components/TreeProvider.cjs.map +1 -1
  182. package/lib-commonjs/contexts/index.cjs +7 -7
  183. package/lib-commonjs/contexts/index.cjs.map +1 -1
  184. package/lib-commonjs/contexts/subtreeContext.cjs +3 -3
  185. package/lib-commonjs/contexts/subtreeContext.cjs.map +1 -1
  186. package/lib-commonjs/contexts/treeContext.cjs +3 -3
  187. package/lib-commonjs/contexts/treeContext.cjs.map +1 -1
  188. package/lib-commonjs/contexts/treeItemContext.cjs +3 -3
  189. package/lib-commonjs/contexts/treeItemContext.cjs.map +1 -1
  190. package/lib-commonjs/hooks/useControllableOpenItems.cjs +3 -3
  191. package/lib-commonjs/hooks/useControllableOpenItems.cjs.map +1 -1
  192. package/lib-commonjs/hooks/useFlatTreeNavigation.cjs +3 -4
  193. package/lib-commonjs/hooks/useFlatTreeNavigation.cjs.map +1 -1
  194. package/lib-commonjs/hooks/useHTMLElementWalkerRef.cjs.map +1 -1
  195. package/lib-commonjs/hooks/useRootTree.cjs +4 -9
  196. package/lib-commonjs/hooks/useRootTree.cjs.map +1 -1
  197. package/lib-commonjs/hooks/useRovingTabIndexBase.cjs +116 -0
  198. package/lib-commonjs/hooks/useRovingTabIndexBase.cjs.map +1 -0
  199. package/lib-commonjs/hooks/useRovingTabIndexes.cjs +2 -62
  200. package/lib-commonjs/hooks/useRovingTabIndexes.cjs.map +1 -1
  201. package/lib-commonjs/hooks/useSubtree.cjs +1 -11
  202. package/lib-commonjs/hooks/useSubtree.cjs.map +1 -1
  203. package/lib-commonjs/hooks/useTreeNavigation.cjs +5 -84
  204. package/lib-commonjs/hooks/useTreeNavigation.cjs.map +1 -1
  205. package/lib-commonjs/hooks/useTreeNavigationBase.cjs +140 -0
  206. package/lib-commonjs/hooks/useTreeNavigationBase.cjs.map +1 -0
  207. package/lib-commonjs/index.cjs +46 -40
  208. package/lib-commonjs/index.cjs.map +1 -1
  209. package/lib-commonjs/utils/ImmutableMap.cjs.map +1 -1
  210. package/lib-commonjs/utils/ImmutableSet.cjs.map +1 -1
  211. package/lib-commonjs/utils/assert.cjs.map +1 -1
  212. package/lib-commonjs/utils/createCheckedItems.cjs.map +1 -1
  213. package/lib-commonjs/utils/createHTMLElementWalker.cjs +2 -2
  214. package/lib-commonjs/utils/createHTMLElementWalker.cjs.map +1 -1
  215. package/lib-commonjs/utils/createHeadlessTree.cjs +7 -7
  216. package/lib-commonjs/utils/createHeadlessTree.cjs.map +1 -1
  217. package/lib-commonjs/utils/flattenTree.cjs.map +1 -1
  218. package/lib-commonjs/utils/getTreeItemValueFromElement.cjs +3 -3
  219. package/lib-commonjs/utils/getTreeItemValueFromElement.cjs.map +1 -1
  220. package/lib-commonjs/utils/nextTypeAheadElement.cjs.map +1 -1
  221. package/lib-commonjs/utils/normalizeOpenItems.cjs.map +1 -1
  222. package/lib-commonjs/utils/queryTreeItemActions.cjs +38 -0
  223. package/lib-commonjs/utils/queryTreeItemActions.cjs.map +1 -0
  224. package/lib-commonjs/utils/tokens.cjs +4 -4
  225. package/lib-commonjs/utils/tokens.cjs.map +1 -1
  226. package/lib-commonjs/utils/treeItemFilter.cjs.map +1 -1
  227. package/package.json +2 -2
@@ -1,7 +1,6 @@
1
1
  'use client';
2
2
  import { getIntrinsicElementProps, useEventCallback, slot } from "@fluentui/react-utilities";
3
3
  import * as React from "react";
4
- import { Collapse } from "@fluentui/react-motion-components-preview";
5
4
  import { createCheckedItems } from "../utils/createCheckedItems.js";
6
5
  import { treeDataTypes } from "../utils/tokens.js";
7
6
  import { createNextOpenItems } from "./useControllableOpenItems.js";
@@ -13,8 +12,9 @@ import { ImmutableMap } from "../utils/ImmutableMap.js";
13
12
  * @param props - props from this instance of tree
14
13
  * @param ref - reference to root HTMLElement of tree
15
14
  */ export function useRootTree(props, ref) {
15
+ var _props_navigationMode;
16
16
  warnIfNoProperPropsRootTree(props);
17
- const { appearance = 'subtle', size = 'medium', selectionMode = 'none' } = props;
17
+ const { selectionMode = 'none' } = props;
18
18
  const openItems = React.useMemo(()=>ImmutableSet.from(props.openItems), [
19
19
  props.openItems
20
20
  ]);
@@ -69,18 +69,14 @@ import { ImmutableMap } from "../utils/ImmutableMap.js";
69
69
  return requestCheckedChange(request);
70
70
  }
71
71
  });
72
- var _props_navigationMode;
73
72
  return {
74
73
  components: {
75
- root: 'div',
76
- collapseMotion: Collapse
74
+ root: 'div'
77
75
  },
78
76
  contextType: 'root',
79
77
  selectionMode,
80
78
  navigationMode: (_props_navigationMode = props.navigationMode) !== null && _props_navigationMode !== void 0 ? _props_navigationMode : 'tree',
81
79
  open: true,
82
- appearance,
83
- size,
84
80
  level: 1,
85
81
  openItems,
86
82
  checkedItems,
@@ -98,8 +94,7 @@ import { ImmutableMap } from "../utils/ImmutableMap.js";
98
94
  ...props
99
95
  }), {
100
96
  elementType: 'div'
101
- }),
102
- collapseMotion: undefined
97
+ })
103
98
  };
104
99
  }
105
100
  function warnIfNoProperPropsRootTree(props) {
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/useRootTree.ts"],"sourcesContent":["'use client';\n\nimport { getIntrinsicElementProps, useEventCallback, slot } from '@fluentui/react-utilities';\nimport type { TreeCheckedChangeData, TreeProps, TreeState } from '../Tree';\nimport * as React from 'react';\nimport { Collapse } from '@fluentui/react-motion-components-preview';\nimport type { TreeContextValue, TreeItemRequest } from '../contexts/treeContext';\nimport { createCheckedItems } from '../utils/createCheckedItems';\nimport { treeDataTypes } from '../utils/tokens';\nimport { createNextOpenItems } from './useControllableOpenItems';\nimport { ImmutableSet } from '../utils/ImmutableSet';\nimport { ImmutableMap } from '../utils/ImmutableMap';\n\n/**\n * Create the state required to render the root level tree.\n *\n * @param props - props from this instance of tree\n * @param ref - reference to root HTMLElement of tree\n */\nexport function useRootTree(\n props: TreeProps,\n ref: React.Ref<HTMLElement>,\n): Omit<TreeState & TreeContextValue, 'treeType'> {\n warnIfNoProperPropsRootTree(props);\n\n const { appearance = 'subtle', size = 'medium', selectionMode = 'none' } = props;\n\n const openItems = React.useMemo(() => ImmutableSet.from(props.openItems), [props.openItems]);\n const checkedItems = React.useMemo(() => createCheckedItems(props.checkedItems), [props.checkedItems]);\n\n const requestOpenChange = (request: Extract<TreeItemRequest, { requestType: 'open' }>) => {\n props.onOpenChange?.(request.event, {\n ...request,\n openItems: ImmutableSet.dangerouslyGetInternalSet(createNextOpenItems(request, openItems)),\n });\n };\n\n const requestCheckedChange = (request: Extract<TreeItemRequest, { requestType: 'selection' }>) => {\n if (selectionMode === 'none') {\n return;\n }\n props.onCheckedChange?.(request.event, {\n ...request,\n selectionMode,\n checkedItems: ImmutableMap.dangerouslyGetInternalMap(checkedItems),\n // Casting is required here due to selection | multiselection spreading the union problem\n } as TreeCheckedChangeData);\n };\n\n const requestNavigation = (request: Extract<TreeItemRequest, { requestType: 'navigate' }>) => {\n let isScrollPrevented = false;\n props.onNavigation?.(request.event, {\n ...request,\n preventScroll: () => {\n isScrollPrevented = true;\n },\n isScrollPrevented: () => isScrollPrevented,\n });\n switch (request.type) {\n case treeDataTypes.ArrowDown:\n case treeDataTypes.ArrowUp:\n case treeDataTypes.Home:\n case treeDataTypes.End:\n // stop the default behavior of the event\n // which is to scroll the page\n request.event.preventDefault();\n }\n };\n\n const requestTreeResponse = useEventCallback((request: TreeItemRequest) => {\n switch (request.requestType) {\n case 'navigate':\n return requestNavigation(request);\n case 'open':\n return requestOpenChange(request);\n case 'selection':\n return requestCheckedChange(request);\n }\n });\n\n return {\n components: {\n root: 'div',\n collapseMotion: Collapse,\n },\n contextType: 'root',\n selectionMode,\n navigationMode: props.navigationMode ?? 'tree',\n open: true,\n appearance,\n size,\n level: 1,\n openItems,\n checkedItems,\n requestTreeResponse,\n forceUpdateRovingTabIndex: () => {\n // noop\n },\n root: slot.always(\n getIntrinsicElementProps('div', {\n // FIXME:\n // `ref` is wrongly assigned to be `HTMLElement` instead of `HTMLDivElement`\n // but since it would be a breaking change to fix it, we are casting ref to it's proper type\n ref: ref as React.Ref<HTMLDivElement>,\n role: 'tree',\n 'aria-multiselectable': selectionMode === 'multiselect' ? true : undefined,\n ...props,\n }),\n { elementType: 'div' },\n ),\n collapseMotion: undefined,\n };\n}\n\nfunction warnIfNoProperPropsRootTree(props: Pick<TreeProps, 'aria-label' | 'aria-labelledby'>) {\n if (process.env.NODE_ENV === 'development') {\n if (!props['aria-label'] && !props['aria-labelledby']) {\n // eslint-disable-next-line no-console\n console.warn(/* #__DE-INDENT__ */ `\n @fluentui/react-tree [useRootTree]:\n Tree must have either a \\`aria-label\\` or \\`aria-labelledby\\` property defined\n `);\n }\n }\n}\n"],"names":["getIntrinsicElementProps","useEventCallback","slot","React","Collapse","createCheckedItems","treeDataTypes","createNextOpenItems","ImmutableSet","ImmutableMap","useRootTree","props","ref","warnIfNoProperPropsRootTree","appearance","size","selectionMode","openItems","useMemo","from","checkedItems","requestOpenChange","request","onOpenChange","event","dangerouslyGetInternalSet","requestCheckedChange","onCheckedChange","dangerouslyGetInternalMap","requestNavigation","isScrollPrevented","onNavigation","preventScroll","type","ArrowDown","ArrowUp","Home","End","preventDefault","requestTreeResponse","requestType","components","root","collapseMotion","contextType","navigationMode","open","level","forceUpdateRovingTabIndex","always","role","undefined","elementType","process","env","NODE_ENV","console","warn"],"mappings":"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"}
1
+ {"version":3,"sources":["../../src/hooks/useRootTree.ts"],"sourcesContent":["'use client';\n\nimport { getIntrinsicElementProps, useEventCallback, slot } from '@fluentui/react-utilities';\nimport type { TreeBaseProps, TreeBaseState, TreeCheckedChangeData } from '../components/Tree/Tree.types';\nimport * as React from 'react';\nimport type { TreeContextValue, TreeItemRequest } from '../contexts/treeContext';\nimport { createCheckedItems } from '../utils/createCheckedItems';\nimport { treeDataTypes } from '../utils/tokens';\nimport { createNextOpenItems } from './useControllableOpenItems';\nimport { ImmutableSet } from '../utils/ImmutableSet';\nimport { ImmutableMap } from '../utils/ImmutableMap';\n\n/**\n * Create the state required to render the root level tree.\n *\n * @param props - props from this instance of tree\n * @param ref - reference to root HTMLElement of tree\n */\nexport function useRootTree(\n props: TreeBaseProps,\n ref: React.Ref<HTMLElement>,\n): Omit<TreeBaseState & Omit<TreeContextValue, 'appearance' | 'size'>, 'treeType'> {\n warnIfNoProperPropsRootTree(props);\n\n const { selectionMode = 'none' } = props;\n\n const openItems = React.useMemo(() => ImmutableSet.from(props.openItems), [props.openItems]);\n const checkedItems = React.useMemo(() => createCheckedItems(props.checkedItems), [props.checkedItems]);\n\n const requestOpenChange = (request: Extract<TreeItemRequest, { requestType: 'open' }>) => {\n props.onOpenChange?.(request.event, {\n ...request,\n openItems: ImmutableSet.dangerouslyGetInternalSet(createNextOpenItems(request, openItems)),\n });\n };\n\n const requestCheckedChange = (request: Extract<TreeItemRequest, { requestType: 'selection' }>) => {\n if (selectionMode === 'none') {\n return;\n }\n props.onCheckedChange?.(request.event, {\n ...request,\n selectionMode,\n checkedItems: ImmutableMap.dangerouslyGetInternalMap(checkedItems),\n // Casting is required here due to selection | multiselection spreading the union problem\n } as TreeCheckedChangeData);\n };\n\n const requestNavigation = (request: Extract<TreeItemRequest, { requestType: 'navigate' }>) => {\n let isScrollPrevented = false;\n props.onNavigation?.(request.event, {\n ...request,\n preventScroll: () => {\n isScrollPrevented = true;\n },\n isScrollPrevented: () => isScrollPrevented,\n });\n switch (request.type) {\n case treeDataTypes.ArrowDown:\n case treeDataTypes.ArrowUp:\n case treeDataTypes.Home:\n case treeDataTypes.End:\n // stop the default behavior of the event\n // which is to scroll the page\n request.event.preventDefault();\n }\n };\n\n const requestTreeResponse = useEventCallback((request: TreeItemRequest) => {\n switch (request.requestType) {\n case 'navigate':\n return requestNavigation(request);\n case 'open':\n return requestOpenChange(request);\n case 'selection':\n return requestCheckedChange(request);\n }\n });\n\n return {\n components: {\n root: 'div',\n },\n contextType: 'root',\n selectionMode,\n navigationMode: props.navigationMode ?? 'tree',\n open: true,\n level: 1,\n openItems,\n checkedItems,\n requestTreeResponse,\n forceUpdateRovingTabIndex: () => {\n // noop\n },\n root: slot.always(\n getIntrinsicElementProps('div', {\n // FIXME:\n // `ref` is wrongly assigned to be `HTMLElement` instead of `HTMLDivElement`\n // but since it would be a breaking change to fix it, we are casting ref to it's proper type\n ref: ref as React.Ref<HTMLDivElement>,\n role: 'tree',\n 'aria-multiselectable': selectionMode === 'multiselect' ? true : undefined,\n ...props,\n }),\n { elementType: 'div' },\n ),\n };\n}\n\nfunction warnIfNoProperPropsRootTree(props: Pick<TreeBaseProps, 'aria-label' | 'aria-labelledby'>) {\n if (process.env.NODE_ENV === 'development') {\n if (!props['aria-label'] && !props['aria-labelledby']) {\n // eslint-disable-next-line no-console\n console.warn(/* #__DE-INDENT__ */ `\n @fluentui/react-tree [useRootTree]:\n Tree must have either a \\`aria-label\\` or \\`aria-labelledby\\` property defined\n `);\n }\n }\n}\n"],"names":["getIntrinsicElementProps","useEventCallback","slot","React","createCheckedItems","treeDataTypes","createNextOpenItems","ImmutableSet","ImmutableMap","useRootTree","props","ref","warnIfNoProperPropsRootTree","selectionMode","openItems","useMemo","from","checkedItems","requestOpenChange","request","onOpenChange","event","dangerouslyGetInternalSet","requestCheckedChange","onCheckedChange","dangerouslyGetInternalMap","requestNavigation","isScrollPrevented","onNavigation","preventScroll","type","ArrowDown","ArrowUp","Home","End","preventDefault","requestTreeResponse","requestType","components","root","contextType","navigationMode","open","level","forceUpdateRovingTabIndex","always","role","undefined","elementType","process","env","NODE_ENV","console","warn"],"mappings":"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"}
@@ -0,0 +1,108 @@
1
+ 'use client';
2
+ import * as React from "react";
3
+ import { useFluent_unstable as useFluent } from "@fluentui/react-shared-contexts";
4
+ import { isHTMLElement } from "@fluentui/react-utilities";
5
+ const findTreeItemRoot = (element)=>{
6
+ let parent = element.parentElement;
7
+ while(parent && parent.getAttribute('role') !== 'tree'){
8
+ parent = parent.parentElement;
9
+ }
10
+ return parent;
11
+ };
12
+ /**
13
+ * Plain DOM implementation of `UseFocusedElementChange`, free of any focus management runtime.
14
+ *
15
+ * @internal
16
+ */ export const useDOMFocusedElementChange = (callback)=>{
17
+ const { targetDocument } = useFluent();
18
+ const callbackRef = React.useRef(callback);
19
+ React.useEffect(()=>{
20
+ callbackRef.current = callback;
21
+ });
22
+ React.useEffect(()=>{
23
+ var _activeElement_shadowRoot;
24
+ if (!targetDocument) {
25
+ return;
26
+ }
27
+ const listener = (event)=>{
28
+ var _event_composedPath_;
29
+ // The target is retargeted to the shadow host when focus moves within a shadow root
30
+ const target = (_event_composedPath_ = event.composedPath()[0]) !== null && _event_composedPath_ !== void 0 ? _event_composedPath_ : event.target;
31
+ callbackRef.current(isHTMLElement(target) ? target : undefined);
32
+ };
33
+ // Capture phase, so that consumers stopping the propagation of focus events do not desync the roving tab index
34
+ targetDocument.addEventListener('focusin', listener, true);
35
+ // Focus may have moved before the listener was attached, e.g. from a parent layout effect
36
+ let activeElement = targetDocument.activeElement;
37
+ while(activeElement === null || activeElement === void 0 ? void 0 : (_activeElement_shadowRoot = activeElement.shadowRoot) === null || _activeElement_shadowRoot === void 0 ? void 0 : _activeElement_shadowRoot.activeElement){
38
+ activeElement = activeElement.shadowRoot.activeElement;
39
+ }
40
+ if (isHTMLElement(activeElement)) {
41
+ callbackRef.current(activeElement);
42
+ }
43
+ return ()=>targetDocument.removeEventListener('focusin', listener, true);
44
+ }, [
45
+ targetDocument
46
+ ]);
47
+ };
48
+ /**
49
+ * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex
50
+ *
51
+ * The focused element tracking is provided by the caller, so that the roving tab index can be
52
+ * driven either by a focus management runtime or by plain DOM events.
53
+ *
54
+ * @internal
55
+ */ export function useRovingTabIndexBase(useFocusedElementChange) {
56
+ const currentElementRef = React.useRef(null);
57
+ const walkerRef = React.useRef(null);
58
+ const { targetDocument } = useFluent();
59
+ // The callback only runs on focus changes, never during render.
60
+ // eslint-disable-next-line react-hooks/refs
61
+ useFocusedElementChange((element)=>{
62
+ if ((element === null || element === void 0 ? void 0 : element.getAttribute('role')) === 'treeitem' && walkerRef.current && walkerRef.current.root.contains(element)) {
63
+ const treeitemRoot = findTreeItemRoot(element);
64
+ if (walkerRef.current.root !== treeitemRoot) {
65
+ return;
66
+ }
67
+ rove(element);
68
+ }
69
+ });
70
+ const initialize = React.useCallback((walker)=>{
71
+ walkerRef.current = walker;
72
+ walker.currentElement = walker.root;
73
+ let tabbableChild = walker.firstChild((element)=>element.tabIndex === 0 ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP);
74
+ walker.currentElement = walker.root;
75
+ tabbableChild !== null && tabbableChild !== void 0 ? tabbableChild : tabbableChild = walker.firstChild();
76
+ if (!tabbableChild) {
77
+ return;
78
+ }
79
+ tabbableChild.tabIndex = 0;
80
+ currentElementRef.current = tabbableChild;
81
+ let nextElement = null;
82
+ while((nextElement = walker.nextElement()) && nextElement !== tabbableChild){
83
+ nextElement.tabIndex = -1;
84
+ }
85
+ }, []);
86
+ const rove = React.useCallback((nextElement, focusOptions)=>{
87
+ if (!currentElementRef.current) {
88
+ return;
89
+ }
90
+ currentElementRef.current.tabIndex = -1;
91
+ nextElement.tabIndex = 0;
92
+ nextElement.focus(focusOptions);
93
+ currentElementRef.current = nextElement;
94
+ }, []);
95
+ const forceUpdate = React.useCallback(()=>{
96
+ if ((currentElementRef.current === null || !(targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.body.contains(currentElementRef.current))) && walkerRef.current) {
97
+ initialize(walkerRef.current);
98
+ }
99
+ }, [
100
+ targetDocument,
101
+ initialize
102
+ ]);
103
+ return {
104
+ rove,
105
+ initialize,
106
+ forceUpdate
107
+ };
108
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/hooks/useRovingTabIndexBase.ts"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport { isHTMLElement } from '@fluentui/react-utilities';\nimport type { HTMLElementWalker } from '../utils/createHTMLElementWalker';\n\n/**\n * Subscribes to focused element changes, invoking the callback with the newly focused element.\n *\n * @internal\n */\nexport type UseFocusedElementChange = (callback: (element: HTMLElement | undefined) => void) => void;\n\nconst findTreeItemRoot = (element: HTMLElement) => {\n let parent = element.parentElement;\n while (parent && parent.getAttribute('role') !== 'tree') {\n parent = parent.parentElement;\n }\n return parent;\n};\n\n/**\n * Plain DOM implementation of `UseFocusedElementChange`, free of any focus management runtime.\n *\n * @internal\n */\nexport const useDOMFocusedElementChange: UseFocusedElementChange = callback => {\n const { targetDocument } = useFluent();\n const callbackRef = React.useRef(callback);\n\n React.useEffect(() => {\n callbackRef.current = callback;\n });\n\n React.useEffect(() => {\n if (!targetDocument) {\n return;\n }\n const listener = (event: FocusEvent) => {\n // The target is retargeted to the shadow host when focus moves within a shadow root\n const target = event.composedPath()[0] ?? event.target;\n callbackRef.current(isHTMLElement(target) ? target : undefined);\n };\n // Capture phase, so that consumers stopping the propagation of focus events do not desync the roving tab index\n targetDocument.addEventListener('focusin', listener, true);\n\n // Focus may have moved before the listener was attached, e.g. from a parent layout effect\n let activeElement = targetDocument.activeElement;\n while (activeElement?.shadowRoot?.activeElement) {\n activeElement = activeElement.shadowRoot.activeElement;\n }\n if (isHTMLElement(activeElement)) {\n callbackRef.current(activeElement);\n }\n\n return () => targetDocument.removeEventListener('focusin', listener, true);\n }, [targetDocument]);\n};\n\n/**\n * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex\n *\n * The focused element tracking is provided by the caller, so that the roving tab index can be\n * driven either by a focus management runtime or by plain DOM events.\n *\n * @internal\n */\nexport function useRovingTabIndexBase(useFocusedElementChange: UseFocusedElementChange): {\n rove: (nextElement: HTMLElement, focusOptions?: FocusOptions) => void;\n initialize: (walker: HTMLElementWalker) => void;\n forceUpdate: () => void;\n} {\n const currentElementRef = React.useRef<HTMLElement | null>(null);\n const walkerRef = React.useRef<HTMLElementWalker | null>(null);\n const { targetDocument } = useFluent();\n\n // The callback only runs on focus changes, never during render.\n // eslint-disable-next-line react-hooks/refs\n useFocusedElementChange(element => {\n if (element?.getAttribute('role') === 'treeitem' && walkerRef.current && walkerRef.current.root.contains(element)) {\n const treeitemRoot = findTreeItemRoot(element);\n if (walkerRef.current.root !== treeitemRoot) {\n return;\n }\n rove(element);\n }\n });\n\n const initialize = React.useCallback((walker: HTMLElementWalker) => {\n walkerRef.current = walker;\n walker.currentElement = walker.root;\n let tabbableChild = walker.firstChild(element =>\n element.tabIndex === 0 ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,\n );\n walker.currentElement = walker.root;\n tabbableChild ??= walker.firstChild();\n if (!tabbableChild) {\n return;\n }\n tabbableChild.tabIndex = 0;\n currentElementRef.current = tabbableChild;\n let nextElement: HTMLElement | null = null;\n while ((nextElement = walker.nextElement()) && nextElement !== tabbableChild) {\n nextElement.tabIndex = -1;\n }\n }, []);\n const rove = React.useCallback((nextElement: HTMLElement, focusOptions?: FocusOptions) => {\n if (!currentElementRef.current) {\n return;\n }\n currentElementRef.current.tabIndex = -1;\n nextElement.tabIndex = 0;\n nextElement.focus(focusOptions);\n currentElementRef.current = nextElement;\n }, []);\n\n const forceUpdate = React.useCallback(() => {\n if (\n (currentElementRef.current === null || !targetDocument?.body.contains(currentElementRef.current)) &&\n walkerRef.current\n ) {\n initialize(walkerRef.current);\n }\n }, [targetDocument, initialize]);\n\n return {\n rove,\n initialize,\n forceUpdate,\n };\n}\n"],"names":["React","useFluent_unstable","useFluent","isHTMLElement","findTreeItemRoot","element","parent","parentElement","getAttribute","useDOMFocusedElementChange","callback","targetDocument","callbackRef","useRef","useEffect","current","activeElement","listener","event","target","composedPath","undefined","addEventListener","shadowRoot","removeEventListener","useRovingTabIndexBase","useFocusedElementChange","currentElementRef","walkerRef","root","contains","treeitemRoot","rove","initialize","useCallback","walker","currentElement","tabbableChild","firstChild","tabIndex","NodeFilter","FILTER_ACCEPT","FILTER_SKIP","nextElement","focusOptions","focus","forceUpdate","body"],"mappings":"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"}
@@ -1,69 +1,10 @@
1
1
  'use client';
2
- import * as React from "react";
3
- import { useFluent_unstable as useFluent } from "@fluentui/react-shared-contexts";
4
2
  import { useFocusedElementChange } from "@fluentui/react-tabster";
5
- const findTreeItemRoot = (element)=>{
6
- let parent = element.parentElement;
7
- while(parent && parent.getAttribute('role') !== 'tree'){
8
- parent = parent.parentElement;
9
- }
10
- return parent;
11
- };
3
+ import { useRovingTabIndexBase } from "./useRovingTabIndexBase.js";
12
4
  /**
13
5
  * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex
14
6
  *
15
7
  * @internal
16
8
  */ export function useRovingTabIndex() {
17
- const currentElementRef = React.useRef(null);
18
- const walkerRef = React.useRef(null);
19
- const { targetDocument } = useFluent();
20
- useFocusedElementChange((element)=>{
21
- if ((element === null || element === void 0 ? void 0 : element.getAttribute('role')) === 'treeitem' && walkerRef.current && walkerRef.current.root.contains(element)) {
22
- const treeitemRoot = findTreeItemRoot(element);
23
- if (walkerRef.current.root !== treeitemRoot) {
24
- return;
25
- }
26
- // eslint-disable-next-line react-hooks/immutability, react-hooks/preserve-manual-memoization
27
- rove(element);
28
- }
29
- });
30
- const initialize = React.useCallback((walker)=>{
31
- walkerRef.current = walker;
32
- walker.currentElement = walker.root;
33
- let tabbableChild = walker.firstChild((element)=>element.tabIndex === 0 ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP);
34
- walker.currentElement = walker.root;
35
- tabbableChild !== null && tabbableChild !== void 0 ? tabbableChild : tabbableChild = walker.firstChild();
36
- if (!tabbableChild) {
37
- return;
38
- }
39
- tabbableChild.tabIndex = 0;
40
- currentElementRef.current = tabbableChild;
41
- let nextElement = null;
42
- while((nextElement = walker.nextElement()) && nextElement !== tabbableChild){
43
- nextElement.tabIndex = -1;
44
- }
45
- }, []);
46
- // eslint-disable-next-line react-hooks/preserve-manual-memoization
47
- const rove = React.useCallback((nextElement, focusOptions)=>{
48
- if (!currentElementRef.current) {
49
- return;
50
- }
51
- currentElementRef.current.tabIndex = -1;
52
- nextElement.tabIndex = 0;
53
- nextElement.focus(focusOptions);
54
- currentElementRef.current = nextElement;
55
- }, []);
56
- const forceUpdate = React.useCallback(()=>{
57
- if ((currentElementRef.current === null || !(targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.body.contains(currentElementRef.current))) && walkerRef.current) {
58
- initialize(walkerRef.current);
59
- }
60
- }, [
61
- targetDocument,
62
- initialize
63
- ]);
64
- return {
65
- rove,
66
- initialize,
67
- forceUpdate
68
- };
9
+ return useRovingTabIndexBase(useFocusedElementChange);
69
10
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/useRovingTabIndexes.ts"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport type { HTMLElementWalker } from '../utils/createHTMLElementWalker';\nimport { useFocusedElementChange } from '@fluentui/react-tabster';\n\nconst findTreeItemRoot = (element: HTMLElement) => {\n let parent = element.parentElement;\n while (parent && parent.getAttribute('role') !== 'tree') {\n parent = parent.parentElement;\n }\n return parent;\n};\n\n/**\n * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex\n *\n * @internal\n */\nexport function useRovingTabIndex(): {\n rove: (nextElement: HTMLElement, focusOptions?: FocusOptions) => void;\n initialize: (walker: HTMLElementWalker) => void;\n forceUpdate: () => void;\n} {\n const currentElementRef = React.useRef<HTMLElement | null>(null);\n const walkerRef = React.useRef<HTMLElementWalker | null>(null);\n const { targetDocument } = useFluent();\n\n useFocusedElementChange(element => {\n if (element?.getAttribute('role') === 'treeitem' && walkerRef.current && walkerRef.current.root.contains(element)) {\n const treeitemRoot = findTreeItemRoot(element);\n if (walkerRef.current.root !== treeitemRoot) {\n return;\n }\n // eslint-disable-next-line react-hooks/immutability, react-hooks/preserve-manual-memoization\n rove(element);\n }\n });\n\n const initialize = React.useCallback((walker: HTMLElementWalker) => {\n walkerRef.current = walker;\n walker.currentElement = walker.root;\n let tabbableChild = walker.firstChild(element =>\n element.tabIndex === 0 ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,\n );\n walker.currentElement = walker.root;\n tabbableChild ??= walker.firstChild();\n if (!tabbableChild) {\n return;\n }\n tabbableChild.tabIndex = 0;\n currentElementRef.current = tabbableChild;\n let nextElement: HTMLElement | null = null;\n while ((nextElement = walker.nextElement()) && nextElement !== tabbableChild) {\n nextElement.tabIndex = -1;\n }\n }, []);\n // eslint-disable-next-line react-hooks/preserve-manual-memoization\n const rove = React.useCallback((nextElement: HTMLElement, focusOptions?: FocusOptions) => {\n if (!currentElementRef.current) {\n return;\n }\n currentElementRef.current.tabIndex = -1;\n nextElement.tabIndex = 0;\n nextElement.focus(focusOptions);\n currentElementRef.current = nextElement;\n }, []);\n\n const forceUpdate = React.useCallback(() => {\n if (\n (currentElementRef.current === null || !targetDocument?.body.contains(currentElementRef.current)) &&\n walkerRef.current\n ) {\n initialize(walkerRef.current);\n }\n }, [targetDocument, initialize]);\n\n return {\n rove,\n initialize,\n forceUpdate,\n };\n}\n"],"names":["React","useFluent_unstable","useFluent","useFocusedElementChange","findTreeItemRoot","element","parent","parentElement","getAttribute","useRovingTabIndex","currentElementRef","useRef","walkerRef","targetDocument","current","root","contains","treeitemRoot","rove","initialize","useCallback","walker","currentElement","tabbableChild","firstChild","tabIndex","NodeFilter","FILTER_ACCEPT","FILTER_SKIP","nextElement","focusOptions","focus","forceUpdate","body"],"mappings":"AAAA;AAEA,YAAYA,WAAW,QAAQ;AAC/B,SAASC,sBAAsBC,SAAS,QAAQ,kCAAkC;AAElF,SAASC,uBAAuB,QAAQ,0BAA0B;AAElE,MAAMC,mBAAmB,CAACC;IACxB,IAAIC,SAASD,QAAQE,aAAa;IAClC,MAAOD,UAAUA,OAAOE,YAAY,CAAC,YAAY,OAAQ;QACvDF,SAASA,OAAOC,aAAa;IAC/B;IACA,OAAOD;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASG;IAKd,MAAMC,oBAAoBV,MAAMW,MAAM,CAAqB;IAC3D,MAAMC,YAAYZ,MAAMW,MAAM,CAA2B;IACzD,MAAM,EAAEE,cAAc,EAAE,GAAGX;IAE3BC,wBAAwBE,CAAAA;QACtB,IAAIA,CAAAA,oBAAAA,8BAAAA,QAASG,YAAY,CAAC,aAAY,cAAcI,UAAUE,OAAO,IAAIF,UAAUE,OAAO,CAACC,IAAI,CAACC,QAAQ,CAACX,UAAU;YACjH,MAAMY,eAAeb,iBAAiBC;YACtC,IAAIO,UAAUE,OAAO,CAACC,IAAI,KAAKE,cAAc;gBAC3C;YACF;YACA,6FAA6F;YAC7FC,KAAKb;QACP;IACF;IAEA,MAAMc,aAAanB,MAAMoB,WAAW,CAAC,CAACC;QACpCT,UAAUE,OAAO,GAAGO;QACpBA,OAAOC,cAAc,GAAGD,OAAON,IAAI;QACnC,IAAIQ,gBAAgBF,OAAOG,UAAU,CAACnB,CAAAA,UACpCA,QAAQoB,QAAQ,KAAK,IAAIC,WAAWC,aAAa,GAAGD,WAAWE,WAAW;QAE5EP,OAAOC,cAAc,GAAGD,OAAON,IAAI;QACnCQ,0BAAAA,2BAAAA,gBAAAA,gBAAkBF,OAAOG,UAAU;QACnC,IAAI,CAACD,eAAe;YAClB;QACF;QACAA,cAAcE,QAAQ,GAAG;QACzBf,kBAAkBI,OAAO,GAAGS;QAC5B,IAAIM,cAAkC;QACtC,MAAO,AAACA,CAAAA,cAAcR,OAAOQ,WAAW,EAAC,KAAMA,gBAAgBN,cAAe;YAC5EM,YAAYJ,QAAQ,GAAG,CAAC;QAC1B;IACF,GAAG,EAAE;IACL,mEAAmE;IACnE,MAAMP,OAAOlB,MAAMoB,WAAW,CAAC,CAACS,aAA0BC;QACxD,IAAI,CAACpB,kBAAkBI,OAAO,EAAE;YAC9B;QACF;QACAJ,kBAAkBI,OAAO,CAACW,QAAQ,GAAG,CAAC;QACtCI,YAAYJ,QAAQ,GAAG;QACvBI,YAAYE,KAAK,CAACD;QAClBpB,kBAAkBI,OAAO,GAAGe;IAC9B,GAAG,EAAE;IAEL,MAAMG,cAAchC,MAAMoB,WAAW,CAAC;QACpC,IACE,AAACV,CAAAA,kBAAkBI,OAAO,KAAK,QAAQ,EAACD,2BAAAA,qCAAAA,eAAgBoB,IAAI,CAACjB,QAAQ,CAACN,kBAAkBI,OAAO,EAAA,KAC/FF,UAAUE,OAAO,EACjB;YACAK,WAAWP,UAAUE,OAAO;QAC9B;IACF,GAAG;QAACD;QAAgBM;KAAW;IAE/B,OAAO;QACLD;QACAC;QACAa;IACF;AACF"}
1
+ {"version":3,"sources":["../../src/hooks/useRovingTabIndexes.ts"],"sourcesContent":["'use client';\n\nimport { useFocusedElementChange } from '@fluentui/react-tabster';\nimport type { HTMLElementWalker } from '../utils/createHTMLElementWalker';\nimport { useRovingTabIndexBase } from './useRovingTabIndexBase';\n\n/**\n * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex\n *\n * @internal\n */\nexport function useRovingTabIndex(): {\n rove: (nextElement: HTMLElement, focusOptions?: FocusOptions) => void;\n initialize: (walker: HTMLElementWalker) => void;\n forceUpdate: () => void;\n} {\n return useRovingTabIndexBase(useFocusedElementChange);\n}\n"],"names":["useFocusedElementChange","useRovingTabIndexBase","useRovingTabIndex"],"mappings":"AAAA;AAEA,SAASA,uBAAuB,QAAQ,0BAA0B;AAElE,SAASC,qBAAqB,QAAQ,6BAA0B;AAEhE;;;;CAIC,GACD,OAAO,SAASC;IAKd,OAAOD,sBAAsBD;AAC/B"}
@@ -1,8 +1,6 @@
1
1
  'use client';
2
2
  import { useSubtreeContext_unstable, useTreeItemContext_unstable } from "../contexts/index.js";
3
3
  import { getIntrinsicElementProps, useMergedRefs, slot } from "@fluentui/react-utilities";
4
- import { Collapse } from "@fluentui/react-motion-components-preview";
5
- import { presenceMotionSlot } from "@fluentui/react-motion";
6
4
  /**
7
5
  * Create the state required to render a sub-level tree.
8
6
  *
@@ -16,8 +14,7 @@ import { presenceMotionSlot } from "@fluentui/react-motion";
16
14
  contextType: 'subtree',
17
15
  open,
18
16
  components: {
19
- root: 'div',
20
- collapseMotion: Collapse
17
+ root: 'div'
21
18
  },
22
19
  level: parentLevel + 1,
23
20
  root: slot.always(getIntrinsicElementProps('div', {
@@ -29,13 +26,6 @@ import { presenceMotionSlot } from "@fluentui/react-motion";
29
26
  ...props
30
27
  }), {
31
28
  elementType: 'div'
32
- }),
33
- collapseMotion: presenceMotionSlot(props.collapseMotion, {
34
- elementType: Collapse,
35
- defaultProps: {
36
- visible: open,
37
- unmountOnExit: true
38
- }
39
29
  })
40
30
  };
41
31
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/useSubtree.ts"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport type { TreeProps, TreeState } from '../Tree';\nimport type { SubtreeContextValue } from '../contexts/index';\nimport { useSubtreeContext_unstable, useTreeItemContext_unstable } from '../contexts/index';\nimport { getIntrinsicElementProps, useMergedRefs, slot } from '@fluentui/react-utilities';\nimport { Collapse } from '@fluentui/react-motion-components-preview';\nimport { presenceMotionSlot } from '@fluentui/react-motion';\n\n/**\n * Create the state required to render a sub-level tree.\n *\n * @param props - props from this instance of tree\n * @param ref - reference to root HTMLElement of tree\n */\nexport function useSubtree(\n props: TreeProps,\n ref: React.Ref<HTMLElement>,\n): Omit<TreeState & SubtreeContextValue, 'treeType'> {\n const subtreeRef = useTreeItemContext_unstable(ctx => ctx.subtreeRef);\n\n const { level: parentLevel } = useSubtreeContext_unstable();\n\n const open = useTreeItemContext_unstable(ctx => ctx.open);\n\n return {\n contextType: 'subtree',\n open,\n components: {\n root: 'div',\n collapseMotion: Collapse,\n },\n level: parentLevel + 1,\n root: slot.always(\n getIntrinsicElementProps('div', {\n // FIXME:\n // `ref` is wrongly assigned to be `HTMLElement` instead of `HTMLDivElement`\n // but since it would be a breaking change to fix it, we are casting ref to it's proper type\n ref: useMergedRefs(ref, subtreeRef) as React.Ref<HTMLDivElement>,\n role: 'group',\n ...props,\n }),\n { elementType: 'div' },\n ),\n collapseMotion: presenceMotionSlot(props.collapseMotion, {\n elementType: Collapse,\n defaultProps: {\n visible: open,\n unmountOnExit: true,\n },\n }),\n };\n}\n"],"names":["useSubtreeContext_unstable","useTreeItemContext_unstable","getIntrinsicElementProps","useMergedRefs","slot","Collapse","presenceMotionSlot","useSubtree","props","ref","subtreeRef","ctx","level","parentLevel","open","contextType","components","root","collapseMotion","always","role","elementType","defaultProps","visible","unmountOnExit"],"mappings":"AAAA;AAKA,SAASA,0BAA0B,EAAEC,2BAA2B,QAAQ,uBAAoB;AAC5F,SAASC,wBAAwB,EAAEC,aAAa,EAAEC,IAAI,QAAQ,4BAA4B;AAC1F,SAASC,QAAQ,QAAQ,4CAA4C;AACrE,SAASC,kBAAkB,QAAQ,yBAAyB;AAE5D;;;;;CAKC,GACD,OAAO,SAASC,WACdC,KAAgB,EAChBC,GAA2B;IAE3B,MAAMC,aAAaT,4BAA4BU,CAAAA,MAAOA,IAAID,UAAU;IAEpE,MAAM,EAAEE,OAAOC,WAAW,EAAE,GAAGb;IAE/B,MAAMc,OAAOb,4BAA4BU,CAAAA,MAAOA,IAAIG,IAAI;IAExD,OAAO;QACLC,aAAa;QACbD;QACAE,YAAY;YACVC,MAAM;YACNC,gBAAgBb;QAClB;QACAO,OAAOC,cAAc;QACrBI,MAAMb,KAAKe,MAAM,CACfjB,yBAAyB,OAAO;YAC9B,SAAS;YACT,4EAA4E;YAC5E,4FAA4F;YAC5FO,KAAKN,cAAcM,KAAKC;YACxBU,MAAM;YACN,GAAGZ,KAAK;QACV,IACA;YAAEa,aAAa;QAAM;QAEvBH,gBAAgBZ,mBAAmBE,MAAMU,cAAc,EAAE;YACvDG,aAAahB;YACbiB,cAAc;gBACZC,SAAST;gBACTU,eAAe;YACjB;QACF;IACF;AACF"}
1
+ {"version":3,"sources":["../../src/hooks/useSubtree.ts"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport type { TreeBaseProps, TreeBaseState } from '../components/Tree/Tree.types';\nimport type { SubtreeContextValue } from '../contexts/index';\nimport { useSubtreeContext_unstable, useTreeItemContext_unstable } from '../contexts/index';\nimport { getIntrinsicElementProps, useMergedRefs, slot } from '@fluentui/react-utilities';\n\n/**\n * Create the state required to render a sub-level tree.\n *\n * @param props - props from this instance of tree\n * @param ref - reference to root HTMLElement of tree\n */\nexport function useSubtree(\n props: TreeBaseProps,\n ref: React.Ref<HTMLElement>,\n): Omit<TreeBaseState & SubtreeContextValue, 'treeType'> {\n const subtreeRef = useTreeItemContext_unstable(ctx => ctx.subtreeRef);\n\n const { level: parentLevel } = useSubtreeContext_unstable();\n\n const open = useTreeItemContext_unstable(ctx => ctx.open);\n\n return {\n contextType: 'subtree',\n open,\n components: {\n root: 'div',\n },\n level: parentLevel + 1,\n root: slot.always(\n getIntrinsicElementProps('div', {\n // FIXME:\n // `ref` is wrongly assigned to be `HTMLElement` instead of `HTMLDivElement`\n // but since it would be a breaking change to fix it, we are casting ref to it's proper type\n ref: useMergedRefs(ref, subtreeRef) as React.Ref<HTMLDivElement>,\n role: 'group',\n ...props,\n }),\n { elementType: 'div' },\n ),\n };\n}\n"],"names":["useSubtreeContext_unstable","useTreeItemContext_unstable","getIntrinsicElementProps","useMergedRefs","slot","useSubtree","props","ref","subtreeRef","ctx","level","parentLevel","open","contextType","components","root","always","role","elementType"],"mappings":"AAAA;AAKA,SAASA,0BAA0B,EAAEC,2BAA2B,QAAQ,uBAAoB;AAC5F,SAASC,wBAAwB,EAAEC,aAAa,EAAEC,IAAI,QAAQ,4BAA4B;AAE1F;;;;;CAKC,GACD,OAAO,SAASC,WACdC,KAAoB,EACpBC,GAA2B;IAE3B,MAAMC,aAAaP,4BAA4BQ,CAAAA,MAAOA,IAAID,UAAU;IAEpE,MAAM,EAAEE,OAAOC,WAAW,EAAE,GAAGX;IAE/B,MAAMY,OAAOX,4BAA4BQ,CAAAA,MAAOA,IAAIG,IAAI;IAExD,OAAO;QACLC,aAAa;QACbD;QACAE,YAAY;YACVC,MAAM;QACR;QACAL,OAAOC,cAAc;QACrBI,MAAMX,KAAKY,MAAM,CACfd,yBAAyB,OAAO;YAC9B,SAAS;YACT,4EAA4E;YAC5E,4FAA4F;YAC5FK,KAAKJ,cAAcI,KAAKC;YACxBS,MAAM;YACN,GAAGX,KAAK;QACV,IACA;YAAEY,aAAa;QAAM;IAEzB;AACF"}
@@ -1,92 +1,14 @@
1
1
  'use client';
2
- import { nextTypeAheadElement } from "../utils/nextTypeAheadElement.js";
3
- import { treeDataTypes } from "../utils/tokens.js";
4
- import { useRovingTabIndex } from "./useRovingTabIndexes.js";
5
- import * as React from "react";
6
- import { useHTMLElementWalkerRef } from "./useHTMLElementWalkerRef.js";
7
- import { useMergedRefs } from "@fluentui/react-utilities";
8
- import { treeItemLayoutClassNames } from "../TreeItemLayout.js";
9
- import { useFocusFinders } from "@fluentui/react-tabster";
2
+ import { useFocusFinders, useFocusedElementChange } from "@fluentui/react-tabster";
3
+ import { useTreeNavigationBase } from "./useTreeNavigationBase.js";
10
4
  /***
11
5
  * Hook used to manage navigation in the tree.
12
6
  *
13
7
  * @param navigationMode - the navigation mode of the tree, 'tree' (default) or 'treegrid'
14
8
  */ export function useTreeNavigation(navigationMode = 'tree') {
15
- 'use no memo'; // justified: compiler would optimize useTreeNavigation — manual opt-out to preserve runtime behavior
16
- const { rove, initialize: initializeRovingTabIndex, forceUpdate: forceUpdateRovingTabIndex } = useRovingTabIndex();
17
9
  const { findFirstFocusable } = useFocusFinders();
18
- const { walkerRef, rootRef: walkerRootRef } = useHTMLElementWalkerRef();
19
- const rootRefCallback = React.useCallback((root)=>{
20
- if (root && walkerRef.current) {
21
- initializeRovingTabIndex(walkerRef.current);
22
- }
23
- }, [
24
- walkerRef,
25
- initializeRovingTabIndex
26
- ]);
27
- const getNextElement = (data)=>{
28
- if (!walkerRef.current) {
29
- return null;
30
- }
31
- switch(data.type){
32
- case treeDataTypes.Click:
33
- return data.target;
34
- case treeDataTypes.TypeAhead:
35
- walkerRef.current.currentElement = data.target;
36
- return nextTypeAheadElement(walkerRef.current, data.event.key);
37
- case treeDataTypes.ArrowLeft:
38
- {
39
- const actions = queryActions(data.target);
40
- if (navigationMode === 'treegrid' && (actions === null || actions === void 0 ? void 0 : actions.contains(data.target.ownerDocument.activeElement))) {
41
- return data.target;
42
- }
43
- walkerRef.current.currentElement = data.target;
44
- return walkerRef.current.parentElement();
45
- }
46
- case treeDataTypes.ArrowRight:
47
- if (navigationMode === 'treegrid') {
48
- const actions = queryActions(data.target);
49
- if (actions) {
50
- var _findFirstFocusable;
51
- (_findFirstFocusable = findFirstFocusable(actions)) === null || _findFirstFocusable === void 0 ? void 0 : _findFirstFocusable.focus();
52
- }
53
- return null;
54
- }
55
- walkerRef.current.currentElement = data.target;
56
- return walkerRef.current.firstChild();
57
- case treeDataTypes.End:
58
- walkerRef.current.currentElement = walkerRef.current.root;
59
- return lastChildRecursive(walkerRef.current);
60
- case treeDataTypes.Home:
61
- walkerRef.current.currentElement = walkerRef.current.root;
62
- return walkerRef.current.firstChild();
63
- case treeDataTypes.ArrowDown:
64
- walkerRef.current.currentElement = data.target;
65
- return walkerRef.current.nextElement();
66
- case treeDataTypes.ArrowUp:
67
- walkerRef.current.currentElement = data.target;
68
- return walkerRef.current.previousElement();
69
- }
70
- };
71
- function navigate(data, focusOptions) {
72
- const nextElement = getNextElement(data);
73
- if (nextElement) {
74
- rove(nextElement, focusOptions);
75
- }
76
- return nextElement;
77
- }
78
- return {
79
- navigate,
80
- treeRef: useMergedRefs(walkerRootRef, rootRefCallback),
81
- forceUpdateRovingTabIndex
82
- };
10
+ return useTreeNavigationBase(navigationMode, {
11
+ findFirstFocusable,
12
+ useFocusedElementChange
13
+ });
83
14
  }
84
- function lastChildRecursive(walker) {
85
- let lastElement = null;
86
- let nextElement = null;
87
- while(nextElement = walker.lastChild()){
88
- lastElement = nextElement;
89
- }
90
- return lastElement;
91
- }
92
- const queryActions = (target)=>target.querySelector(`:scope > .${treeItemLayoutClassNames.root} > .${treeItemLayoutClassNames.actions}`);
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/useTreeNavigation.ts"],"sourcesContent":["'use client';\n\nimport type { TreeNavigationData_unstable, TreeNavigationMode } from '../components/Tree/Tree.types';\nimport { nextTypeAheadElement } from '../utils/nextTypeAheadElement';\nimport { treeDataTypes } from '../utils/tokens';\nimport { useRovingTabIndex } from './useRovingTabIndexes';\nimport type { HTMLElementWalker } from '../utils/createHTMLElementWalker';\nimport * as React from 'react';\nimport { useHTMLElementWalkerRef } from './useHTMLElementWalkerRef';\nimport { useMergedRefs } from '@fluentui/react-utilities';\nimport { treeItemLayoutClassNames } from '../TreeItemLayout';\nimport { useFocusFinders } from '@fluentui/react-tabster';\n\n/***\n * Hook used to manage navigation in the tree.\n *\n * @param navigationMode - the navigation mode of the tree, 'tree' (default) or 'treegrid'\n */\nexport function useTreeNavigation(navigationMode: TreeNavigationMode = 'tree'): {\n navigate: (data: TreeNavigationData_unstable, focusOptions?: FocusOptions) => HTMLElement | null;\n treeRef: React.RefCallback<HTMLElement>;\n forceUpdateRovingTabIndex: () => void;\n} {\n 'use no memo'; // justified: compiler would optimize useTreeNavigation — manual opt-out to preserve runtime behavior\n\n const { rove, initialize: initializeRovingTabIndex, forceUpdate: forceUpdateRovingTabIndex } = useRovingTabIndex();\n const { findFirstFocusable } = useFocusFinders();\n const { walkerRef, rootRef: walkerRootRef } = useHTMLElementWalkerRef();\n\n const rootRefCallback: React.RefCallback<HTMLElement> = React.useCallback(\n root => {\n if (root && walkerRef.current) {\n initializeRovingTabIndex(walkerRef.current);\n }\n },\n [walkerRef, initializeRovingTabIndex],\n );\n\n const getNextElement = (data: TreeNavigationData_unstable) => {\n if (!walkerRef.current) {\n return null;\n }\n switch (data.type) {\n case treeDataTypes.Click:\n return data.target;\n case treeDataTypes.TypeAhead:\n walkerRef.current.currentElement = data.target;\n return nextTypeAheadElement(walkerRef.current, data.event.key);\n case treeDataTypes.ArrowLeft: {\n const actions = queryActions(data.target);\n if (navigationMode === 'treegrid' && actions?.contains(data.target.ownerDocument.activeElement)) {\n return data.target;\n }\n walkerRef.current.currentElement = data.target;\n return walkerRef.current.parentElement();\n }\n case treeDataTypes.ArrowRight:\n if (navigationMode === 'treegrid') {\n const actions = queryActions(data.target);\n if (actions) {\n findFirstFocusable(actions)?.focus();\n }\n return null;\n }\n walkerRef.current.currentElement = data.target;\n return walkerRef.current.firstChild();\n case treeDataTypes.End:\n walkerRef.current.currentElement = walkerRef.current.root;\n return lastChildRecursive(walkerRef.current);\n case treeDataTypes.Home:\n walkerRef.current.currentElement = walkerRef.current.root;\n return walkerRef.current.firstChild();\n case treeDataTypes.ArrowDown:\n walkerRef.current.currentElement = data.target;\n return walkerRef.current.nextElement();\n case treeDataTypes.ArrowUp:\n walkerRef.current.currentElement = data.target;\n return walkerRef.current.previousElement();\n }\n };\n function navigate(data: TreeNavigationData_unstable, focusOptions?: FocusOptions) {\n const nextElement = getNextElement(data);\n if (nextElement) {\n rove(nextElement, focusOptions);\n }\n return nextElement;\n }\n return {\n navigate,\n treeRef: useMergedRefs(walkerRootRef, rootRefCallback) as React.RefCallback<HTMLElement>,\n forceUpdateRovingTabIndex,\n } as const;\n}\n\nfunction lastChildRecursive(walker: HTMLElementWalker) {\n let lastElement: HTMLElement | null = null;\n let nextElement: HTMLElement | null = null;\n while ((nextElement = walker.lastChild())) {\n lastElement = nextElement;\n }\n return lastElement;\n}\n\nconst queryActions = (target: HTMLElement) =>\n target.querySelector<HTMLElement>(\n `:scope > .${treeItemLayoutClassNames.root} > .${treeItemLayoutClassNames.actions}`,\n );\n"],"names":["nextTypeAheadElement","treeDataTypes","useRovingTabIndex","React","useHTMLElementWalkerRef","useMergedRefs","treeItemLayoutClassNames","useFocusFinders","useTreeNavigation","navigationMode","rove","initialize","initializeRovingTabIndex","forceUpdate","forceUpdateRovingTabIndex","findFirstFocusable","walkerRef","rootRef","walkerRootRef","rootRefCallback","useCallback","root","current","getNextElement","data","type","Click","target","TypeAhead","currentElement","event","key","ArrowLeft","actions","queryActions","contains","ownerDocument","activeElement","parentElement","ArrowRight","focus","firstChild","End","lastChildRecursive","Home","ArrowDown","nextElement","ArrowUp","previousElement","navigate","focusOptions","treeRef","walker","lastElement","lastChild","querySelector"],"mappings":"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"}
1
+ {"version":3,"sources":["../../src/hooks/useTreeNavigation.ts"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport { useFocusFinders, useFocusedElementChange } from '@fluentui/react-tabster';\nimport type { TreeNavigationData_unstable, TreeNavigationMode } from '../components/Tree/Tree.types';\nimport { useTreeNavigationBase } from './useTreeNavigationBase';\n\n/***\n * Hook used to manage navigation in the tree.\n *\n * @param navigationMode - the navigation mode of the tree, 'tree' (default) or 'treegrid'\n */\nexport function useTreeNavigation(navigationMode: TreeNavigationMode = 'tree'): {\n navigate: (data: TreeNavigationData_unstable, focusOptions?: FocusOptions) => HTMLElement | null;\n treeRef: React.RefCallback<HTMLElement>;\n forceUpdateRovingTabIndex: () => void;\n} {\n const { findFirstFocusable } = useFocusFinders();\n\n return useTreeNavigationBase(navigationMode, { findFirstFocusable, useFocusedElementChange });\n}\n"],"names":["useFocusFinders","useFocusedElementChange","useTreeNavigationBase","useTreeNavigation","navigationMode","findFirstFocusable"],"mappings":"AAAA;AAGA,SAASA,eAAe,EAAEC,uBAAuB,QAAQ,0BAA0B;AAEnF,SAASC,qBAAqB,QAAQ,6BAA0B;AAEhE;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,iBAAqC,MAAM;IAK3E,MAAM,EAAEC,kBAAkB,EAAE,GAAGL;IAE/B,OAAOE,sBAAsBE,gBAAgB;QAAEC;QAAoBJ;IAAwB;AAC7F"}
@@ -0,0 +1,131 @@
1
+ 'use client';
2
+ import * as React from "react";
3
+ import { useMergedRefs } from "@fluentui/react-utilities";
4
+ import { nextTypeAheadElement } from "../utils/nextTypeAheadElement.js";
5
+ import { treeDataTypes } from "../utils/tokens.js";
6
+ import { useHTMLElementWalkerRef } from "./useHTMLElementWalkerRef.js";
7
+ import { useRovingTabIndexBase } from "./useRovingTabIndexBase.js";
8
+ import { queryTreeItemActions } from "../utils/queryTreeItemActions.js";
9
+ /**
10
+ * Plain DOM approximation of Tabster's focus finders, used when no focus management runtime is provided.
11
+ */ const FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), details > summary:first-of-type, [tabindex]:not([tabindex="-1"]), [contenteditable]:not([contenteditable="false"])';
12
+ /**
13
+ * Plain DOM implementation of `TreeNavigationOptions['findFirstFocusable']`.
14
+ *
15
+ * @internal
16
+ */ export const findFirstFocusableDOM = (container)=>{
17
+ var _Array_from_find;
18
+ return (_Array_from_find = Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).find(isFocusableDOM)) !== null && _Array_from_find !== void 0 ? _Array_from_find : null;
19
+ };
20
+ function isFocusableDOM(element) {
21
+ var _element_getAttribute, _getComputedStyle;
22
+ const contentEditable = (_element_getAttribute = element.getAttribute('contenteditable')) === null || _element_getAttribute === void 0 ? void 0 : _element_getAttribute.toLowerCase();
23
+ const isEditable = element.isContentEditable || contentEditable === 'true' || contentEditable === 'plaintext-only' || contentEditable === '';
24
+ if (element.matches(':disabled') || element.hasAttribute('tabindex') && element.tabIndex < 0 || element.tabIndex < 0 && !isEditable) {
25
+ return false;
26
+ }
27
+ const getComputedStyle = (target)=>{
28
+ var _target_ownerDocument_defaultView;
29
+ return (_target_ownerDocument_defaultView = target.ownerDocument.defaultView) === null || _target_ownerDocument_defaultView === void 0 ? void 0 : _target_ownerDocument_defaultView.getComputedStyle(target);
30
+ };
31
+ // `visibility` is inherited and can be overridden by a descendant, so only the candidate's own computed value matters
32
+ const visibility = (_getComputedStyle = getComputedStyle(element)) === null || _getComputedStyle === void 0 ? void 0 : _getComputedStyle.visibility;
33
+ if (visibility === 'hidden' || visibility === 'collapse') {
34
+ return false;
35
+ }
36
+ let child = null;
37
+ let current = element;
38
+ while(current){
39
+ var _getComputedStyle1;
40
+ if (current.hidden || current.hasAttribute('inert') || current.getAttribute('aria-hidden') === 'true' || ((_getComputedStyle1 = getComputedStyle(current)) === null || _getComputedStyle1 === void 0 ? void 0 : _getComputedStyle1.display) === 'none' || // The content of a closed details element is not rendered, except for its first summary
41
+ child && current.tagName === 'DETAILS' && !current.hasAttribute('open') && child !== current.querySelector(':scope > summary')) {
42
+ return false;
43
+ }
44
+ child = current;
45
+ current = current.parentElement;
46
+ }
47
+ return true;
48
+ }
49
+ /***
50
+ * Hook used to manage navigation in the tree, with the focus management provided by the caller.
51
+ *
52
+ * @internal
53
+ * @param navigationMode - the navigation mode of the tree, 'tree' (default) or 'treegrid'
54
+ * @param options - focus management used to find focusable elements and track focus changes
55
+ */ export function useTreeNavigationBase(navigationMode = 'tree', { findFirstFocusable, useFocusedElementChange }) {
56
+ 'use no memo'; // justified: compiler would optimize useTreeNavigationBase — manual opt-out to preserve runtime behavior
57
+ const { rove, initialize: initializeRovingTabIndex, forceUpdate: forceUpdateRovingTabIndex } = useRovingTabIndexBase(useFocusedElementChange);
58
+ const { walkerRef, rootRef: walkerRootRef } = useHTMLElementWalkerRef();
59
+ const rootRefCallback = React.useCallback((root)=>{
60
+ if (root && walkerRef.current) {
61
+ initializeRovingTabIndex(walkerRef.current);
62
+ }
63
+ }, [
64
+ walkerRef,
65
+ initializeRovingTabIndex
66
+ ]);
67
+ const getNextElement = (data)=>{
68
+ if (!walkerRef.current) {
69
+ return null;
70
+ }
71
+ switch(data.type){
72
+ case treeDataTypes.Click:
73
+ return data.target;
74
+ case treeDataTypes.TypeAhead:
75
+ walkerRef.current.currentElement = data.target;
76
+ return nextTypeAheadElement(walkerRef.current, data.event.key);
77
+ case treeDataTypes.ArrowLeft:
78
+ {
79
+ const actions = queryTreeItemActions(data.target);
80
+ if (navigationMode === 'treegrid' && (actions === null || actions === void 0 ? void 0 : actions.contains(data.target.ownerDocument.activeElement))) {
81
+ return data.target;
82
+ }
83
+ walkerRef.current.currentElement = data.target;
84
+ return walkerRef.current.parentElement();
85
+ }
86
+ case treeDataTypes.ArrowRight:
87
+ if (navigationMode === 'treegrid') {
88
+ const actions = queryTreeItemActions(data.target);
89
+ if (actions) {
90
+ var _findFirstFocusable;
91
+ (_findFirstFocusable = findFirstFocusable(actions)) === null || _findFirstFocusable === void 0 ? void 0 : _findFirstFocusable.focus();
92
+ }
93
+ return null;
94
+ }
95
+ walkerRef.current.currentElement = data.target;
96
+ return walkerRef.current.firstChild();
97
+ case treeDataTypes.End:
98
+ walkerRef.current.currentElement = walkerRef.current.root;
99
+ return lastChildRecursive(walkerRef.current);
100
+ case treeDataTypes.Home:
101
+ walkerRef.current.currentElement = walkerRef.current.root;
102
+ return walkerRef.current.firstChild();
103
+ case treeDataTypes.ArrowDown:
104
+ walkerRef.current.currentElement = data.target;
105
+ return walkerRef.current.nextElement();
106
+ case treeDataTypes.ArrowUp:
107
+ walkerRef.current.currentElement = data.target;
108
+ return walkerRef.current.previousElement();
109
+ }
110
+ };
111
+ function navigate(data, focusOptions) {
112
+ const nextElement = getNextElement(data);
113
+ if (nextElement) {
114
+ rove(nextElement, focusOptions);
115
+ }
116
+ return nextElement;
117
+ }
118
+ return {
119
+ navigate,
120
+ treeRef: useMergedRefs(walkerRootRef, rootRefCallback),
121
+ forceUpdateRovingTabIndex
122
+ };
123
+ }
124
+ function lastChildRecursive(walker) {
125
+ let lastElement = null;
126
+ let nextElement = null;
127
+ while(nextElement = walker.lastChild()){
128
+ lastElement = nextElement;
129
+ }
130
+ return lastElement;
131
+ }