@mui/x-tree-view 8.0.0-alpha.11 → 8.0.0-alpha.13

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 (753) hide show
  1. package/CHANGELOG.md +460 -1
  2. package/RichTreeView/RichTreeView.d.ts +3 -3
  3. package/RichTreeView/RichTreeView.js +74 -68
  4. package/RichTreeView/RichTreeView.plugins.d.ts +9 -10
  5. package/RichTreeView/RichTreeView.plugins.js +14 -8
  6. package/RichTreeView/RichTreeView.types.d.ts +40 -40
  7. package/RichTreeView/RichTreeView.types.js +5 -1
  8. package/RichTreeView/index.d.ts +5 -5
  9. package/RichTreeView/index.js +39 -3
  10. package/RichTreeView/richTreeViewClasses.d.ts +3 -3
  11. package/RichTreeView/richTreeViewClasses.js +13 -5
  12. package/SimpleTreeView/SimpleTreeView.d.ts +4 -4
  13. package/SimpleTreeView/SimpleTreeView.js +67 -61
  14. package/SimpleTreeView/SimpleTreeView.plugins.d.ts +8 -9
  15. package/SimpleTreeView/SimpleTreeView.plugins.js +14 -8
  16. package/SimpleTreeView/SimpleTreeView.types.d.ts +41 -41
  17. package/SimpleTreeView/SimpleTreeView.types.js +5 -1
  18. package/SimpleTreeView/index.d.ts +3 -3
  19. package/SimpleTreeView/index.js +27 -3
  20. package/SimpleTreeView/simpleTreeViewClasses.d.ts +3 -3
  21. package/SimpleTreeView/simpleTreeViewClasses.js +13 -5
  22. package/TreeItem/TreeItem.d.ts +7 -7
  23. package/TreeItem/TreeItem.js +78 -71
  24. package/TreeItem/TreeItem.types.d.ts +83 -84
  25. package/TreeItem/TreeItem.types.js +5 -1
  26. package/TreeItem/index.d.ts +2 -2
  27. package/TreeItem/index.js +69 -2
  28. package/TreeItem/treeItemClasses.d.ts +29 -29
  29. package/TreeItem/treeItemClasses.js +13 -5
  30. package/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.d.ts +3 -3
  31. package/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.js +21 -15
  32. package/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.d.ts +4 -4
  33. package/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.js +5 -1
  34. package/TreeItemDragAndDropOverlay/index.d.ts +2 -2
  35. package/TreeItemDragAndDropOverlay/index.js +12 -1
  36. package/TreeItemIcon/TreeItemIcon.d.ts +3 -3
  37. package/TreeItemIcon/TreeItemIcon.js +33 -27
  38. package/TreeItemIcon/TreeItemIcon.types.d.ts +33 -33
  39. package/TreeItemIcon/TreeItemIcon.types.js +5 -1
  40. package/TreeItemIcon/index.d.ts +2 -2
  41. package/TreeItemIcon/index.js +12 -1
  42. package/TreeItemLabelInput/TreeItemLabelInput.d.ts +1 -1
  43. package/TreeItemLabelInput/TreeItemLabelInput.js +11 -6
  44. package/TreeItemLabelInput/TreeItemLabelInput.types.d.ts +12 -12
  45. package/TreeItemLabelInput/TreeItemLabelInput.types.js +5 -1
  46. package/TreeItemLabelInput/index.d.ts +2 -2
  47. package/TreeItemLabelInput/index.js +12 -1
  48. package/TreeItemProvider/TreeItemProvider.d.ts +3 -3
  49. package/TreeItemProvider/TreeItemProvider.js +22 -16
  50. package/TreeItemProvider/TreeItemProvider.types.d.ts +5 -5
  51. package/TreeItemProvider/TreeItemProvider.types.js +5 -1
  52. package/TreeItemProvider/index.d.ts +2 -2
  53. package/TreeItemProvider/index.js +12 -1
  54. package/esm/RichTreeView/RichTreeView.d.ts +18 -0
  55. package/{node → esm}/RichTreeView/RichTreeView.js +68 -74
  56. package/esm/RichTreeView/RichTreeView.plugins.d.ts +13 -0
  57. package/esm/RichTreeView/RichTreeView.plugins.js +10 -0
  58. package/esm/RichTreeView/RichTreeView.types.d.ts +52 -0
  59. package/esm/RichTreeView/RichTreeView.types.js +1 -0
  60. package/esm/RichTreeView/index.d.ts +5 -0
  61. package/esm/RichTreeView/index.js +3 -0
  62. package/esm/RichTreeView/richTreeViewClasses.d.ts +7 -0
  63. package/esm/RichTreeView/richTreeViewClasses.js +6 -0
  64. package/esm/SimpleTreeView/SimpleTreeView.d.ts +20 -0
  65. package/{node → esm}/SimpleTreeView/SimpleTreeView.js +61 -67
  66. package/esm/SimpleTreeView/SimpleTreeView.plugins.d.ts +12 -0
  67. package/esm/SimpleTreeView/SimpleTreeView.plugins.js +10 -0
  68. package/esm/SimpleTreeView/SimpleTreeView.types.d.ts +51 -0
  69. package/esm/SimpleTreeView/SimpleTreeView.types.js +1 -0
  70. package/esm/SimpleTreeView/index.d.ts +3 -0
  71. package/esm/SimpleTreeView/index.js +3 -0
  72. package/esm/SimpleTreeView/simpleTreeViewClasses.d.ts +7 -0
  73. package/esm/SimpleTreeView/simpleTreeViewClasses.js +6 -0
  74. package/esm/TreeItem/TreeItem.d.ts +31 -0
  75. package/{node → esm}/TreeItem/TreeItem.js +71 -78
  76. package/esm/TreeItem/TreeItem.types.d.ts +93 -0
  77. package/esm/TreeItem/TreeItem.types.js +1 -0
  78. package/esm/TreeItem/index.d.ts +3 -0
  79. package/esm/TreeItem/index.js +2 -0
  80. package/esm/TreeItem/treeItemClasses.d.ts +33 -0
  81. package/esm/TreeItem/treeItemClasses.js +6 -0
  82. package/esm/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.d.ts +7 -0
  83. package/{node → esm}/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.js +15 -21
  84. package/esm/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.d.ts +6 -0
  85. package/esm/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.js +1 -0
  86. package/esm/TreeItemDragAndDropOverlay/index.d.ts +2 -0
  87. package/esm/TreeItemDragAndDropOverlay/index.js +1 -0
  88. package/esm/TreeItemIcon/TreeItemIcon.d.ts +7 -0
  89. package/esm/TreeItemIcon/TreeItemIcon.js +72 -0
  90. package/esm/TreeItemIcon/TreeItemIcon.types.d.ts +40 -0
  91. package/esm/TreeItemIcon/TreeItemIcon.types.js +1 -0
  92. package/esm/TreeItemIcon/index.d.ts +2 -0
  93. package/esm/TreeItemIcon/index.js +1 -0
  94. package/esm/TreeItemLabelInput/TreeItemLabelInput.d.ts +5 -0
  95. package/esm/TreeItemLabelInput/TreeItemLabelInput.js +24 -0
  96. package/esm/TreeItemLabelInput/TreeItemLabelInput.types.d.ts +14 -0
  97. package/esm/TreeItemLabelInput/TreeItemLabelInput.types.js +1 -0
  98. package/esm/TreeItemLabelInput/index.d.ts +2 -0
  99. package/esm/TreeItemLabelInput/index.js +1 -0
  100. package/esm/TreeItemProvider/TreeItemProvider.d.ts +7 -0
  101. package/esm/TreeItemProvider/TreeItemProvider.js +45 -0
  102. package/esm/TreeItemProvider/TreeItemProvider.types.d.ts +7 -0
  103. package/esm/TreeItemProvider/TreeItemProvider.types.js +1 -0
  104. package/esm/TreeItemProvider/index.d.ts +2 -0
  105. package/esm/TreeItemProvider/index.js +1 -0
  106. package/esm/hooks/index.d.ts +3 -0
  107. package/esm/hooks/index.js +3 -0
  108. package/esm/hooks/useTreeItemModel.d.ts +2 -0
  109. package/esm/hooks/useTreeItemModel.js +11 -0
  110. package/esm/hooks/useTreeItemUtils/index.d.ts +1 -0
  111. package/esm/hooks/useTreeItemUtils/index.js +1 -0
  112. package/esm/hooks/useTreeItemUtils/useTreeItemUtils.d.ts +41 -0
  113. package/{node → esm}/hooks/useTreeItemUtils/useTreeItemUtils.js +26 -32
  114. package/esm/hooks/useTreeViewApiRef.d.ts +7 -0
  115. package/esm/hooks/useTreeViewApiRef.js +7 -0
  116. package/esm/icons/icons.d.ts +6 -0
  117. package/esm/icons/icons.js +9 -0
  118. package/esm/icons/index.d.ts +1 -0
  119. package/esm/icons/index.js +1 -0
  120. package/esm/index.d.ts +12 -0
  121. package/esm/index.js +22 -0
  122. package/esm/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.d.ts +5 -0
  123. package/esm/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.js +5 -0
  124. package/esm/internals/TreeViewItemDepthContext/index.d.ts +1 -0
  125. package/esm/internals/TreeViewItemDepthContext/index.js +1 -0
  126. package/esm/internals/TreeViewProvider/TreeViewChildrenItemProvider.d.ts +17 -0
  127. package/{node → esm}/internals/TreeViewProvider/TreeViewChildrenItemProvider.js +14 -23
  128. package/esm/internals/TreeViewProvider/TreeViewContext.d.ts +6 -0
  129. package/esm/internals/TreeViewProvider/TreeViewContext.js +8 -0
  130. package/esm/internals/TreeViewProvider/TreeViewProvider.d.ts +9 -0
  131. package/esm/internals/TreeViewProvider/TreeViewProvider.js +20 -0
  132. package/esm/internals/TreeViewProvider/TreeViewProvider.types.d.ts +19 -0
  133. package/esm/internals/TreeViewProvider/TreeViewProvider.types.js +1 -0
  134. package/esm/internals/TreeViewProvider/index.d.ts +3 -0
  135. package/esm/internals/TreeViewProvider/index.js +2 -0
  136. package/esm/internals/TreeViewProvider/useTreeViewContext.d.ts +3 -0
  137. package/esm/internals/TreeViewProvider/useTreeViewContext.js +9 -0
  138. package/esm/internals/components/RichTreeViewItems.d.ts +32 -0
  139. package/esm/internals/components/RichTreeViewItems.js +68 -0
  140. package/esm/internals/corePlugins/corePlugins.d.ts +9 -0
  141. package/esm/internals/corePlugins/corePlugins.js +8 -0
  142. package/esm/internals/corePlugins/index.d.ts +2 -0
  143. package/esm/internals/corePlugins/index.js +1 -0
  144. package/esm/internals/corePlugins/useTreeViewId/index.d.ts +2 -0
  145. package/esm/internals/corePlugins/useTreeViewId/index.js +1 -0
  146. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.d.ts +3 -0
  147. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.js +39 -0
  148. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.d.ts +36 -0
  149. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.js +9 -0
  150. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.types.d.ts +20 -0
  151. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.types.js +1 -0
  152. package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.utils.d.ts +21 -0
  153. package/{node → esm}/internals/corePlugins/useTreeViewId/useTreeViewId.utils.js +3 -11
  154. package/esm/internals/corePlugins/useTreeViewInstanceEvents/index.d.ts +2 -0
  155. package/esm/internals/corePlugins/useTreeViewInstanceEvents/index.js +1 -0
  156. package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.d.ts +3 -0
  157. package/{node → esm}/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.js +4 -12
  158. package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.d.ts +22 -0
  159. package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.js +1 -0
  160. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/index.d.ts +2 -0
  161. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/index.js +1 -0
  162. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.d.ts +3 -0
  163. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.js +12 -0
  164. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.d.ts +8 -0
  165. package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.js +1 -0
  166. package/esm/internals/hooks/useInstanceEventHandler.d.ts +15 -0
  167. package/{node → esm}/internals/hooks/useInstanceEventHandler.js +7 -16
  168. package/esm/internals/hooks/useLazyRef.d.ts +1 -0
  169. package/esm/internals/hooks/useLazyRef.js +1 -0
  170. package/esm/internals/hooks/useOnMount.d.ts +1 -0
  171. package/esm/internals/hooks/useOnMount.js +1 -0
  172. package/esm/internals/hooks/useSelector.d.ts +4 -0
  173. package/esm/internals/hooks/useSelector.js +9 -0
  174. package/esm/internals/hooks/useTimeout.d.ts +1 -0
  175. package/esm/internals/hooks/useTimeout.js +1 -0
  176. package/esm/internals/index.d.ts +28 -0
  177. package/esm/internals/index.js +21 -0
  178. package/esm/internals/models/events.d.ts +9 -0
  179. package/esm/internals/models/events.js +1 -0
  180. package/esm/internals/models/helpers.d.ts +7 -0
  181. package/esm/internals/models/helpers.js +1 -0
  182. package/esm/internals/models/index.d.ts +4 -0
  183. package/esm/internals/models/index.js +4 -0
  184. package/esm/internals/models/itemPlugin.d.ts +43 -0
  185. package/esm/internals/models/itemPlugin.js +1 -0
  186. package/esm/internals/models/plugin.d.ts +151 -0
  187. package/esm/internals/models/plugin.js +1 -0
  188. package/esm/internals/models/treeView.d.ts +32 -0
  189. package/esm/internals/models/treeView.js +1 -0
  190. package/esm/internals/plugins/useTreeViewExpansion/index.d.ts +2 -0
  191. package/esm/internals/plugins/useTreeViewExpansion/index.js +1 -0
  192. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.d.ts +3 -0
  193. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.js +111 -0
  194. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.d.ts +180 -0
  195. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.js +24 -0
  196. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.d.ts +78 -0
  197. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.js +1 -0
  198. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.d.ts +7 -0
  199. package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.js +19 -0
  200. package/esm/internals/plugins/useTreeViewFocus/index.d.ts +2 -0
  201. package/esm/internals/plugins/useTreeViewFocus/index.js +1 -0
  202. package/esm/internals/plugins/useTreeViewFocus/useTreeViewFocus.d.ts +3 -0
  203. package/esm/internals/plugins/useTreeViewFocus/useTreeViewFocus.js +135 -0
  204. package/esm/internals/plugins/useTreeViewFocus/useTreeViewFocus.selectors.d.ts +182 -0
  205. package/{node → esm}/internals/plugins/useTreeViewFocus/useTreeViewFocus.selectors.js +5 -11
  206. package/esm/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.d.ts +45 -0
  207. package/esm/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.js +1 -0
  208. package/esm/internals/plugins/useTreeViewIcons/index.d.ts +2 -0
  209. package/esm/internals/plugins/useTreeViewIcons/index.js +1 -0
  210. package/esm/internals/plugins/useTreeViewIcons/useTreeViewIcons.d.ts +3 -0
  211. package/{node → esm}/internals/plugins/useTreeViewIcons/useTreeViewIcons.js +2 -10
  212. package/esm/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.d.ts +42 -0
  213. package/esm/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.js +1 -0
  214. package/esm/internals/plugins/useTreeViewItems/index.d.ts +3 -0
  215. package/esm/internals/plugins/useTreeViewItems/index.js +2 -0
  216. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.d.ts +3 -0
  217. package/{node → esm}/internals/plugins/useTreeViewItems/useTreeViewItems.js +28 -37
  218. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.selectors.d.ts +886 -0
  219. package/{node → esm}/internals/plugins/useTreeViewItems/useTreeViewItems.selectors.js +12 -18
  220. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.types.d.ts +156 -0
  221. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.types.js +1 -0
  222. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.utils.d.ts +4 -0
  223. package/esm/internals/plugins/useTreeViewItems/useTreeViewItems.utils.js +8 -0
  224. package/esm/internals/plugins/useTreeViewJSXItems/index.d.ts +2 -0
  225. package/esm/internals/plugins/useTreeViewJSXItems/index.js +1 -0
  226. package/esm/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.d.ts +3 -0
  227. package/esm/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.js +183 -0
  228. package/esm/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.d.ts +35 -0
  229. package/esm/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.js +1 -0
  230. package/esm/internals/plugins/useTreeViewKeyboardNavigation/index.d.ts +2 -0
  231. package/esm/internals/plugins/useTreeViewKeyboardNavigation/index.js +1 -0
  232. package/esm/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.d.ts +3 -0
  233. package/{node → esm}/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.js +31 -40
  234. package/esm/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.d.ts +32 -0
  235. package/esm/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.js +1 -0
  236. package/esm/internals/plugins/useTreeViewLabel/index.d.ts +2 -0
  237. package/esm/internals/plugins/useTreeViewLabel/index.js +1 -0
  238. package/esm/internals/plugins/useTreeViewLabel/useTreeViewLabel.d.ts +3 -0
  239. package/esm/internals/plugins/useTreeViewLabel/useTreeViewLabel.itemPlugin.d.ts +2 -0
  240. package/{node → esm}/internals/plugins/useTreeViewLabel/useTreeViewLabel.itemPlugin.js +9 -17
  241. package/{node → esm}/internals/plugins/useTreeViewLabel/useTreeViewLabel.js +11 -20
  242. package/esm/internals/plugins/useTreeViewLabel/useTreeViewLabel.selectors.d.ts +74 -0
  243. package/{node → esm}/internals/plugins/useTreeViewLabel/useTreeViewLabel.selectors.js +4 -10
  244. package/esm/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.d.ts +59 -0
  245. package/esm/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.js +1 -0
  246. package/esm/internals/plugins/useTreeViewSelection/index.d.ts +2 -0
  247. package/esm/internals/plugins/useTreeViewSelection/index.js +1 -0
  248. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.d.ts +3 -0
  249. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.itemPlugin.d.ts +2 -0
  250. package/{node → esm}/internals/plugins/useTreeViewSelection/useTreeViewSelection.itemPlugin.js +14 -22
  251. package/{node → esm}/internals/plugins/useTreeViewSelection/useTreeViewSelection.js +30 -39
  252. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.d.ts +32 -0
  253. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.js +9 -0
  254. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.d.ts +144 -0
  255. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.js +1 -0
  256. package/esm/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.d.ts +38 -0
  257. package/{node → esm}/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.js +16 -26
  258. package/esm/internals/useTreeView/extractPluginParamsFromProps.d.ts +22 -0
  259. package/{node → esm}/internals/useTreeView/extractPluginParamsFromProps.js +4 -12
  260. package/esm/internals/useTreeView/index.d.ts +1 -0
  261. package/esm/internals/useTreeView/index.js +1 -0
  262. package/esm/internals/useTreeView/useTreeView.d.ts +9 -0
  263. package/{node → esm}/internals/useTreeView/useTreeView.js +19 -29
  264. package/esm/internals/useTreeView/useTreeView.types.d.ts +23 -0
  265. package/esm/internals/useTreeView/useTreeView.types.js +1 -0
  266. package/esm/internals/useTreeView/useTreeViewBuildContext.d.ts +18 -0
  267. package/{node → esm}/internals/useTreeView/useTreeViewBuildContext.js +3 -11
  268. package/esm/internals/useTreeView/useTreeViewModels.d.ts +7 -0
  269. package/{node → esm}/internals/useTreeView/useTreeViewModels.js +5 -14
  270. package/esm/internals/useTreeView/useTreeViewPlugins.d.ts +0 -0
  271. package/esm/internals/useTreeView/useTreeViewPlugins.js +0 -0
  272. package/esm/internals/utils/TreeViewStore.d.ts +12 -0
  273. package/{node → esm}/internals/utils/TreeViewStore.js +2 -9
  274. package/esm/internals/utils/cleanupTracking/CleanupTracking.d.ts +9 -0
  275. package/esm/internals/utils/cleanupTracking/CleanupTracking.js +1 -0
  276. package/esm/internals/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.d.ts +7 -0
  277. package/{node → esm}/internals/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.js +2 -9
  278. package/esm/internals/utils/cleanupTracking/TimerBasedCleanupTracking.d.ts +9 -0
  279. package/{node → esm}/internals/utils/cleanupTracking/TimerBasedCleanupTracking.js +2 -9
  280. package/esm/internals/utils/plugins.d.ts +2 -0
  281. package/esm/internals/utils/plugins.js +4 -0
  282. package/esm/internals/utils/publishTreeViewEvent.d.ts +5 -0
  283. package/esm/internals/utils/publishTreeViewEvent.js +3 -0
  284. package/esm/internals/utils/selectors.d.ts +9 -0
  285. package/{node → esm}/internals/utils/selectors.js +5 -12
  286. package/esm/internals/utils/tree.d.ts +32 -0
  287. package/{node → esm}/internals/utils/tree.js +41 -55
  288. package/esm/internals/utils/utils.d.ts +2 -0
  289. package/{node → esm}/internals/utils/utils.js +2 -10
  290. package/esm/internals/zero-styled/index.d.ts +3 -0
  291. package/esm/internals/zero-styled/index.js +7 -0
  292. package/esm/models/events.d.ts +4 -0
  293. package/esm/models/events.js +1 -0
  294. package/esm/models/index.d.ts +3 -0
  295. package/esm/models/index.js +5 -0
  296. package/esm/models/items.d.ts +13 -0
  297. package/esm/models/items.js +1 -0
  298. package/esm/package.json +1 -0
  299. package/esm/themeAugmentation/components.d.ts +21 -0
  300. package/esm/themeAugmentation/index.d.ts +3 -0
  301. package/esm/themeAugmentation/index.js +0 -0
  302. package/esm/themeAugmentation/overrides.d.ts +16 -0
  303. package/esm/themeAugmentation/props.d.ts +14 -0
  304. package/esm/useTreeItem/index.d.ts +2 -0
  305. package/esm/useTreeItem/index.js +1 -0
  306. package/esm/useTreeItem/useTreeItem.d.ts +2 -0
  307. package/{node → esm}/useTreeItem/useTreeItem.js +54 -62
  308. package/esm/useTreeItem/useTreeItem.types.d.ts +175 -0
  309. package/esm/useTreeItem/useTreeItem.types.js +1 -0
  310. package/hooks/index.d.ts +3 -3
  311. package/hooks/index.js +26 -3
  312. package/hooks/useTreeItemModel.d.ts +2 -2
  313. package/hooks/useTreeItemModel.js +13 -7
  314. package/hooks/useTreeItemUtils/index.d.ts +1 -1
  315. package/hooks/useTreeItemUtils/index.js +12 -1
  316. package/hooks/useTreeItemUtils/useTreeItemUtils.d.ts +22 -24
  317. package/hooks/useTreeItemUtils/useTreeItemUtils.js +32 -26
  318. package/hooks/useTreeViewApiRef.d.ts +3 -3
  319. package/hooks/useTreeViewApiRef.js +9 -2
  320. package/icons/icons.d.ts +3 -3
  321. package/icons/icons.js +12 -5
  322. package/icons/index.d.ts +1 -1
  323. package/icons/index.js +16 -1
  324. package/index.d.ts +12 -12
  325. package/index.js +147 -15
  326. package/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.d.ts +3 -3
  327. package/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.js +9 -2
  328. package/internals/TreeViewItemDepthContext/index.d.ts +1 -1
  329. package/internals/TreeViewItemDepthContext/index.js +12 -1
  330. package/internals/TreeViewProvider/TreeViewChildrenItemProvider.d.ts +8 -8
  331. package/internals/TreeViewProvider/TreeViewChildrenItemProvider.js +23 -14
  332. package/internals/TreeViewProvider/TreeViewContext.d.ts +2 -2
  333. package/internals/TreeViewProvider/TreeViewContext.js +9 -2
  334. package/internals/TreeViewProvider/TreeViewProvider.d.ts +3 -3
  335. package/internals/TreeViewProvider/TreeViewProvider.js +12 -5
  336. package/internals/TreeViewProvider/TreeViewProvider.types.d.ts +13 -13
  337. package/internals/TreeViewProvider/TreeViewProvider.types.js +5 -1
  338. package/internals/TreeViewProvider/index.d.ts +3 -3
  339. package/internals/TreeViewProvider/index.js +19 -2
  340. package/internals/TreeViewProvider/useTreeViewContext.d.ts +3 -3
  341. package/internals/TreeViewProvider/useTreeViewContext.js +13 -5
  342. package/internals/components/RichTreeViewItems.d.ts +21 -21
  343. package/internals/components/RichTreeViewItems.js +31 -23
  344. package/internals/corePlugins/corePlugins.d.ts +3 -4
  345. package/internals/corePlugins/corePlugins.js +10 -4
  346. package/internals/corePlugins/index.d.ts +2 -2
  347. package/internals/corePlugins/index.js +12 -1
  348. package/internals/corePlugins/useTreeViewId/index.d.ts +2 -2
  349. package/internals/corePlugins/useTreeViewId/index.js +12 -1
  350. package/internals/corePlugins/useTreeViewId/useTreeViewId.d.ts +3 -3
  351. package/internals/corePlugins/useTreeViewId/useTreeViewId.js +19 -10
  352. package/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.d.ts +25 -25
  353. package/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.js +8 -2
  354. package/internals/corePlugins/useTreeViewId/useTreeViewId.types.d.ts +14 -14
  355. package/internals/corePlugins/useTreeViewId/useTreeViewId.types.js +5 -1
  356. package/internals/corePlugins/useTreeViewId/useTreeViewId.utils.d.ts +10 -6
  357. package/internals/corePlugins/useTreeViewId/useTreeViewId.utils.js +11 -3
  358. package/internals/corePlugins/useTreeViewInstanceEvents/index.d.ts +2 -2
  359. package/internals/corePlugins/useTreeViewInstanceEvents/index.js +12 -1
  360. package/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.d.ts +2 -2
  361. package/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.js +12 -4
  362. package/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.d.ts +19 -19
  363. package/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.js +5 -1
  364. package/internals/corePlugins/useTreeViewOptionalPlugins/index.d.ts +2 -2
  365. package/internals/corePlugins/useTreeViewOptionalPlugins/index.js +12 -1
  366. package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.d.ts +3 -3
  367. package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.js +8 -1
  368. package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.d.ts +4 -4
  369. package/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.js +5 -1
  370. package/internals/hooks/useInstanceEventHandler.d.ts +8 -8
  371. package/internals/hooks/useInstanceEventHandler.js +16 -7
  372. package/internals/hooks/useLazyRef.d.ts +1 -1
  373. package/internals/hooks/useLazyRef.js +13 -1
  374. package/internals/hooks/useOnMount.d.ts +1 -1
  375. package/internals/hooks/useOnMount.js +13 -1
  376. package/internals/hooks/useSelector.d.ts +4 -4
  377. package/internals/hooks/useSelector.js +15 -4
  378. package/internals/hooks/useTimeout.d.ts +1 -1
  379. package/internals/hooks/useTimeout.js +13 -1
  380. package/internals/index.d.ts +26 -26
  381. package/internals/index.js +159 -20
  382. package/internals/models/events.d.ts +3 -3
  383. package/internals/models/events.js +5 -1
  384. package/internals/models/helpers.d.ts +1 -1
  385. package/internals/models/helpers.js +5 -1
  386. package/internals/models/index.d.ts +4 -4
  387. package/internals/models/index.js +49 -4
  388. package/internals/models/itemPlugin.d.ts +28 -28
  389. package/internals/models/itemPlugin.js +5 -1
  390. package/internals/models/plugin.d.ts +125 -148
  391. package/internals/models/plugin.js +5 -1
  392. package/internals/models/treeView.d.ts +19 -19
  393. package/internals/models/treeView.js +5 -1
  394. package/internals/plugins/useTreeViewExpansion/index.d.ts +2 -2
  395. package/internals/plugins/useTreeViewExpansion/index.js +12 -1
  396. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.d.ts +3 -3
  397. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.js +33 -25
  398. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.d.ts +137 -137
  399. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.js +11 -5
  400. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.d.ts +66 -66
  401. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.js +5 -1
  402. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.d.ts +6 -3
  403. package/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.js +11 -3
  404. package/internals/plugins/useTreeViewFocus/index.d.ts +2 -2
  405. package/internals/plugins/useTreeViewFocus/index.js +12 -1
  406. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.d.ts +3 -3
  407. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.js +40 -31
  408. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.selectors.d.ts +121 -121
  409. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.selectors.js +11 -5
  410. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.d.ts +32 -36
  411. package/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.js +5 -1
  412. package/internals/plugins/useTreeViewIcons/index.d.ts +2 -2
  413. package/internals/plugins/useTreeViewIcons/index.js +12 -1
  414. package/internals/plugins/useTreeViewIcons/useTreeViewIcons.d.ts +3 -3
  415. package/internals/plugins/useTreeViewIcons/useTreeViewIcons.js +10 -2
  416. package/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.d.ts +31 -32
  417. package/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.js +5 -1
  418. package/internals/plugins/useTreeViewItems/index.d.ts +3 -3
  419. package/internals/plugins/useTreeViewItems/index.js +25 -2
  420. package/internals/plugins/useTreeViewItems/useTreeViewItems.d.ts +3 -3
  421. package/internals/plugins/useTreeViewItems/useTreeViewItems.js +37 -28
  422. package/internals/plugins/useTreeViewItems/useTreeViewItems.selectors.d.ts +684 -684
  423. package/internals/plugins/useTreeViewItems/useTreeViewItems.selectors.js +18 -12
  424. package/internals/plugins/useTreeViewItems/useTreeViewItems.types.d.ts +131 -131
  425. package/internals/plugins/useTreeViewItems/useTreeViewItems.types.js +5 -1
  426. package/internals/plugins/useTreeViewItems/useTreeViewItems.utils.d.ts +2 -2
  427. package/internals/plugins/useTreeViewItems/useTreeViewItems.utils.js +10 -3
  428. package/internals/plugins/useTreeViewJSXItems/index.d.ts +2 -2
  429. package/internals/plugins/useTreeViewJSXItems/index.js +12 -1
  430. package/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.d.ts +3 -3
  431. package/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.js +56 -47
  432. package/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.d.ts +32 -34
  433. package/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.js +5 -1
  434. package/internals/plugins/useTreeViewKeyboardNavigation/index.d.ts +2 -2
  435. package/internals/plugins/useTreeViewKeyboardNavigation/index.js +12 -1
  436. package/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.d.ts +3 -3
  437. package/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.js +40 -31
  438. package/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.d.ts +26 -31
  439. package/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.js +5 -1
  440. package/internals/plugins/useTreeViewLabel/index.d.ts +2 -2
  441. package/internals/plugins/useTreeViewLabel/index.js +12 -1
  442. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.d.ts +3 -3
  443. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.itemPlugin.d.ts +2 -2
  444. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.itemPlugin.js +17 -9
  445. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.js +20 -11
  446. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.selectors.d.ts +49 -49
  447. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.selectors.js +10 -4
  448. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.d.ts +44 -46
  449. package/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.js +5 -1
  450. package/internals/plugins/useTreeViewSelection/index.d.ts +2 -2
  451. package/internals/plugins/useTreeViewSelection/index.js +12 -1
  452. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.d.ts +3 -3
  453. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.itemPlugin.d.ts +2 -2
  454. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.itemPlugin.js +22 -14
  455. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.js +39 -30
  456. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.d.ts +22 -22
  457. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.js +8 -2
  458. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.d.ts +123 -128
  459. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.js +5 -1
  460. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.d.ts +27 -17
  461. package/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.js +26 -16
  462. package/internals/useTreeView/extractPluginParamsFromProps.d.ts +18 -9
  463. package/internals/useTreeView/extractPluginParamsFromProps.js +12 -4
  464. package/internals/useTreeView/index.d.ts +1 -1
  465. package/internals/useTreeView/index.js +12 -1
  466. package/internals/useTreeView/useTreeView.d.ts +7 -3
  467. package/internals/useTreeView/useTreeView.js +29 -19
  468. package/internals/useTreeView/useTreeView.types.d.ts +13 -13
  469. package/internals/useTreeView/useTreeView.types.js +5 -1
  470. package/internals/useTreeView/useTreeViewBuildContext.d.ts +17 -11
  471. package/internals/useTreeView/useTreeViewBuildContext.js +11 -3
  472. package/internals/useTreeView/useTreeViewModels.d.ts +3 -3
  473. package/internals/useTreeView/useTreeViewModels.js +14 -5
  474. package/internals/useTreeView/useTreeViewPlugins.js +1 -0
  475. package/internals/utils/TreeViewStore.d.ts +7 -7
  476. package/internals/utils/TreeViewStore.js +9 -2
  477. package/internals/utils/cleanupTracking/CleanupTracking.d.ts +5 -5
  478. package/internals/utils/cleanupTracking/CleanupTracking.js +5 -1
  479. package/internals/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.d.ts +6 -6
  480. package/internals/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.js +9 -2
  481. package/internals/utils/cleanupTracking/TimerBasedCleanupTracking.d.ts +8 -8
  482. package/internals/utils/cleanupTracking/TimerBasedCleanupTracking.js +9 -2
  483. package/internals/utils/plugins.d.ts +2 -2
  484. package/internals/utils/plugins.js +9 -2
  485. package/internals/utils/publishTreeViewEvent.d.ts +4 -4
  486. package/internals/utils/publishTreeViewEvent.js +9 -2
  487. package/internals/utils/selectors.d.ts +2 -2
  488. package/internals/utils/selectors.js +12 -5
  489. package/internals/utils/tree.d.ts +2 -2
  490. package/internals/utils/tree.js +55 -41
  491. package/internals/utils/utils.d.ts +1 -1
  492. package/internals/utils/utils.js +10 -2
  493. package/internals/zero-styled/index.d.ts +1 -1
  494. package/internals/zero-styled/index.js +14 -4
  495. package/models/events.d.ts +2 -2
  496. package/models/events.js +5 -1
  497. package/models/index.d.ts +3 -3
  498. package/models/index.js +26 -4
  499. package/models/items.d.ts +6 -6
  500. package/models/items.js +5 -1
  501. package/modern/RichTreeView/RichTreeView.d.ts +18 -0
  502. package/modern/RichTreeView/RichTreeView.plugins.d.ts +13 -0
  503. package/modern/RichTreeView/RichTreeView.types.d.ts +52 -0
  504. package/modern/RichTreeView/index.d.ts +5 -0
  505. package/modern/RichTreeView/richTreeViewClasses.d.ts +7 -0
  506. package/modern/SimpleTreeView/SimpleTreeView.d.ts +20 -0
  507. package/modern/SimpleTreeView/SimpleTreeView.plugins.d.ts +12 -0
  508. package/modern/SimpleTreeView/SimpleTreeView.types.d.ts +51 -0
  509. package/modern/SimpleTreeView/index.d.ts +3 -0
  510. package/modern/SimpleTreeView/simpleTreeViewClasses.d.ts +7 -0
  511. package/modern/TreeItem/TreeItem.d.ts +31 -0
  512. package/modern/TreeItem/TreeItem.types.d.ts +93 -0
  513. package/modern/TreeItem/index.d.ts +3 -0
  514. package/modern/TreeItem/treeItemClasses.d.ts +33 -0
  515. package/modern/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.d.ts +7 -0
  516. package/modern/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.d.ts +6 -0
  517. package/modern/TreeItemDragAndDropOverlay/index.d.ts +2 -0
  518. package/modern/TreeItemIcon/TreeItemIcon.d.ts +7 -0
  519. package/modern/TreeItemIcon/TreeItemIcon.types.d.ts +40 -0
  520. package/modern/TreeItemIcon/index.d.ts +2 -0
  521. package/modern/TreeItemLabelInput/TreeItemLabelInput.d.ts +5 -0
  522. package/modern/TreeItemLabelInput/TreeItemLabelInput.types.d.ts +14 -0
  523. package/modern/TreeItemLabelInput/index.d.ts +2 -0
  524. package/modern/TreeItemProvider/TreeItemProvider.d.ts +7 -0
  525. package/modern/TreeItemProvider/TreeItemProvider.types.d.ts +7 -0
  526. package/modern/TreeItemProvider/index.d.ts +2 -0
  527. package/modern/hooks/index.d.ts +3 -0
  528. package/modern/hooks/useTreeItemModel.d.ts +2 -0
  529. package/modern/hooks/useTreeItemUtils/index.d.ts +1 -0
  530. package/modern/hooks/useTreeItemUtils/useTreeItemUtils.d.ts +41 -0
  531. package/modern/hooks/useTreeViewApiRef.d.ts +7 -0
  532. package/modern/icons/icons.d.ts +6 -0
  533. package/modern/icons/index.d.ts +1 -0
  534. package/modern/index.d.ts +12 -0
  535. package/modern/index.js +1 -1
  536. package/modern/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.d.ts +5 -0
  537. package/modern/internals/TreeViewItemDepthContext/index.d.ts +1 -0
  538. package/modern/internals/TreeViewProvider/TreeViewChildrenItemProvider.d.ts +17 -0
  539. package/modern/internals/TreeViewProvider/TreeViewContext.d.ts +6 -0
  540. package/modern/internals/TreeViewProvider/TreeViewProvider.d.ts +9 -0
  541. package/modern/internals/TreeViewProvider/TreeViewProvider.types.d.ts +19 -0
  542. package/modern/internals/TreeViewProvider/index.d.ts +3 -0
  543. package/modern/internals/TreeViewProvider/useTreeViewContext.d.ts +3 -0
  544. package/modern/internals/components/RichTreeViewItems.d.ts +32 -0
  545. package/modern/internals/corePlugins/corePlugins.d.ts +9 -0
  546. package/modern/internals/corePlugins/index.d.ts +2 -0
  547. package/modern/internals/corePlugins/useTreeViewId/index.d.ts +2 -0
  548. package/modern/internals/corePlugins/useTreeViewId/useTreeViewId.d.ts +3 -0
  549. package/modern/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.d.ts +36 -0
  550. package/modern/internals/corePlugins/useTreeViewId/useTreeViewId.types.d.ts +20 -0
  551. package/modern/internals/corePlugins/useTreeViewId/useTreeViewId.utils.d.ts +21 -0
  552. package/modern/internals/corePlugins/useTreeViewInstanceEvents/index.d.ts +2 -0
  553. package/modern/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.d.ts +3 -0
  554. package/modern/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.d.ts +22 -0
  555. package/modern/internals/corePlugins/useTreeViewOptionalPlugins/index.d.ts +2 -0
  556. package/modern/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.d.ts +3 -0
  557. package/modern/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.d.ts +8 -0
  558. package/modern/internals/hooks/useInstanceEventHandler.d.ts +15 -0
  559. package/modern/internals/hooks/useLazyRef.d.ts +1 -0
  560. package/modern/internals/hooks/useOnMount.d.ts +1 -0
  561. package/modern/internals/hooks/useSelector.d.ts +4 -0
  562. package/modern/internals/hooks/useSelector.js +4 -1
  563. package/modern/internals/hooks/useTimeout.d.ts +1 -0
  564. package/modern/internals/index.d.ts +28 -0
  565. package/modern/internals/models/events.d.ts +9 -0
  566. package/modern/internals/models/helpers.d.ts +7 -0
  567. package/modern/internals/models/index.d.ts +4 -0
  568. package/modern/internals/models/itemPlugin.d.ts +43 -0
  569. package/modern/internals/models/plugin.d.ts +151 -0
  570. package/modern/internals/models/treeView.d.ts +32 -0
  571. package/modern/internals/plugins/useTreeViewExpansion/index.d.ts +2 -0
  572. package/modern/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.d.ts +3 -0
  573. package/modern/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.d.ts +180 -0
  574. package/modern/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.d.ts +78 -0
  575. package/modern/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.d.ts +7 -0
  576. package/modern/internals/plugins/useTreeViewFocus/index.d.ts +2 -0
  577. package/modern/internals/plugins/useTreeViewFocus/useTreeViewFocus.d.ts +3 -0
  578. package/modern/internals/plugins/useTreeViewFocus/useTreeViewFocus.selectors.d.ts +182 -0
  579. package/modern/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.d.ts +45 -0
  580. package/modern/internals/plugins/useTreeViewIcons/index.d.ts +2 -0
  581. package/modern/internals/plugins/useTreeViewIcons/useTreeViewIcons.d.ts +3 -0
  582. package/modern/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.d.ts +42 -0
  583. package/modern/internals/plugins/useTreeViewItems/index.d.ts +3 -0
  584. package/modern/internals/plugins/useTreeViewItems/useTreeViewItems.d.ts +3 -0
  585. package/modern/internals/plugins/useTreeViewItems/useTreeViewItems.selectors.d.ts +886 -0
  586. package/modern/internals/plugins/useTreeViewItems/useTreeViewItems.types.d.ts +156 -0
  587. package/modern/internals/plugins/useTreeViewItems/useTreeViewItems.utils.d.ts +4 -0
  588. package/modern/internals/plugins/useTreeViewJSXItems/index.d.ts +2 -0
  589. package/modern/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.d.ts +3 -0
  590. package/modern/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.d.ts +35 -0
  591. package/modern/internals/plugins/useTreeViewKeyboardNavigation/index.d.ts +2 -0
  592. package/modern/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.d.ts +3 -0
  593. package/modern/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.d.ts +32 -0
  594. package/modern/internals/plugins/useTreeViewLabel/index.d.ts +2 -0
  595. package/modern/internals/plugins/useTreeViewLabel/useTreeViewLabel.d.ts +3 -0
  596. package/modern/internals/plugins/useTreeViewLabel/useTreeViewLabel.itemPlugin.d.ts +2 -0
  597. package/modern/internals/plugins/useTreeViewLabel/useTreeViewLabel.selectors.d.ts +74 -0
  598. package/modern/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.d.ts +59 -0
  599. package/modern/internals/plugins/useTreeViewSelection/index.d.ts +2 -0
  600. package/modern/internals/plugins/useTreeViewSelection/useTreeViewSelection.d.ts +3 -0
  601. package/modern/internals/plugins/useTreeViewSelection/useTreeViewSelection.itemPlugin.d.ts +2 -0
  602. package/modern/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.d.ts +32 -0
  603. package/modern/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.d.ts +144 -0
  604. package/modern/internals/plugins/useTreeViewSelection/useTreeViewSelection.utils.d.ts +38 -0
  605. package/modern/internals/useTreeView/extractPluginParamsFromProps.d.ts +22 -0
  606. package/modern/internals/useTreeView/index.d.ts +1 -0
  607. package/modern/internals/useTreeView/useTreeView.d.ts +9 -0
  608. package/modern/internals/useTreeView/useTreeView.types.d.ts +23 -0
  609. package/modern/internals/useTreeView/useTreeViewBuildContext.d.ts +18 -0
  610. package/modern/internals/useTreeView/useTreeViewModels.d.ts +7 -0
  611. package/modern/internals/useTreeView/useTreeViewPlugins.d.ts +0 -0
  612. package/modern/internals/utils/TreeViewStore.d.ts +12 -0
  613. package/modern/internals/utils/cleanupTracking/CleanupTracking.d.ts +9 -0
  614. package/modern/internals/utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.d.ts +7 -0
  615. package/modern/internals/utils/cleanupTracking/TimerBasedCleanupTracking.d.ts +9 -0
  616. package/modern/internals/utils/plugins.d.ts +2 -0
  617. package/modern/internals/utils/publishTreeViewEvent.d.ts +5 -0
  618. package/modern/internals/utils/selectors.d.ts +9 -0
  619. package/modern/internals/utils/tree.d.ts +32 -0
  620. package/modern/internals/utils/utils.d.ts +2 -0
  621. package/modern/internals/zero-styled/index.d.ts +3 -0
  622. package/modern/models/events.d.ts +4 -0
  623. package/modern/models/index.d.ts +3 -0
  624. package/modern/models/items.d.ts +13 -0
  625. package/modern/package.json +1 -0
  626. package/modern/themeAugmentation/components.d.ts +21 -0
  627. package/modern/themeAugmentation/index.d.ts +3 -0
  628. package/modern/themeAugmentation/overrides.d.ts +16 -0
  629. package/modern/themeAugmentation/props.d.ts +14 -0
  630. package/modern/useTreeItem/index.d.ts +2 -0
  631. package/modern/useTreeItem/useTreeItem.d.ts +2 -0
  632. package/modern/useTreeItem/useTreeItem.types.d.ts +175 -0
  633. package/package.json +38 -8
  634. package/themeAugmentation/components.d.ts +1 -3
  635. package/themeAugmentation/index.d.ts +1 -1
  636. package/themeAugmentation/index.js +1 -0
  637. package/themeAugmentation/overrides.d.ts +4 -5
  638. package/themeAugmentation/props.d.ts +4 -6
  639. package/tsconfig.build.tsbuildinfo +1 -0
  640. package/useTreeItem/index.d.ts +2 -2
  641. package/useTreeItem/index.js +12 -1
  642. package/useTreeItem/useTreeItem.d.ts +2 -2
  643. package/useTreeItem/useTreeItem.js +62 -54
  644. package/useTreeItem/useTreeItem.types.d.ts +140 -151
  645. package/useTreeItem/useTreeItem.types.js +5 -1
  646. package/RichTreeView/package.json +0 -6
  647. package/SimpleTreeView/package.json +0 -6
  648. package/TreeItem/package.json +0 -6
  649. package/TreeItemDragAndDropOverlay/package.json +0 -6
  650. package/TreeItemIcon/package.json +0 -6
  651. package/TreeItemLabelInput/package.json +0 -6
  652. package/TreeItemProvider/package.json +0 -6
  653. package/hooks/package.json +0 -6
  654. package/icons/package.json +0 -6
  655. package/internals/package.json +0 -6
  656. package/models/package.json +0 -6
  657. package/node/RichTreeView/RichTreeView.plugins.js +0 -16
  658. package/node/RichTreeView/RichTreeView.types.js +0 -5
  659. package/node/RichTreeView/index.js +0 -39
  660. package/node/RichTreeView/richTreeViewClasses.js +0 -14
  661. package/node/SimpleTreeView/SimpleTreeView.plugins.js +0 -16
  662. package/node/SimpleTreeView/SimpleTreeView.types.js +0 -5
  663. package/node/SimpleTreeView/index.js +0 -27
  664. package/node/SimpleTreeView/simpleTreeViewClasses.js +0 -14
  665. package/node/TreeItem/TreeItem.types.js +0 -5
  666. package/node/TreeItem/index.js +0 -69
  667. package/node/TreeItem/treeItemClasses.js +0 -14
  668. package/node/TreeItemDragAndDropOverlay/TreeItemDragAndDropOverlay.types.js +0 -5
  669. package/node/TreeItemDragAndDropOverlay/index.js +0 -12
  670. package/node/TreeItemIcon/TreeItemIcon.js +0 -78
  671. package/node/TreeItemIcon/TreeItemIcon.types.js +0 -5
  672. package/node/TreeItemIcon/index.js +0 -12
  673. package/node/TreeItemLabelInput/TreeItemLabelInput.js +0 -29
  674. package/node/TreeItemLabelInput/TreeItemLabelInput.types.js +0 -5
  675. package/node/TreeItemLabelInput/index.js +0 -12
  676. package/node/TreeItemProvider/TreeItemProvider.js +0 -51
  677. package/node/TreeItemProvider/TreeItemProvider.types.js +0 -5
  678. package/node/TreeItemProvider/index.js +0 -12
  679. package/node/hooks/index.js +0 -26
  680. package/node/hooks/useTreeItemModel.js +0 -17
  681. package/node/hooks/useTreeItemUtils/index.js +0 -12
  682. package/node/hooks/useTreeViewApiRef.js +0 -14
  683. package/node/icons/icons.js +0 -16
  684. package/node/icons/index.js +0 -16
  685. package/node/index.js +0 -154
  686. package/node/internals/TreeViewItemDepthContext/TreeViewItemDepthContext.js +0 -12
  687. package/node/internals/TreeViewItemDepthContext/index.js +0 -12
  688. package/node/internals/TreeViewProvider/TreeViewContext.js +0 -15
  689. package/node/internals/TreeViewProvider/TreeViewProvider.js +0 -27
  690. package/node/internals/TreeViewProvider/TreeViewProvider.types.js +0 -5
  691. package/node/internals/TreeViewProvider/index.js +0 -19
  692. package/node/internals/TreeViewProvider/useTreeViewContext.js +0 -17
  693. package/node/internals/components/RichTreeViewItems.js +0 -76
  694. package/node/internals/corePlugins/corePlugins.js +0 -14
  695. package/node/internals/corePlugins/index.js +0 -12
  696. package/node/internals/corePlugins/useTreeViewId/index.js +0 -12
  697. package/node/internals/corePlugins/useTreeViewId/useTreeViewId.js +0 -48
  698. package/node/internals/corePlugins/useTreeViewId/useTreeViewId.selectors.js +0 -15
  699. package/node/internals/corePlugins/useTreeViewId/useTreeViewId.types.js +0 -5
  700. package/node/internals/corePlugins/useTreeViewInstanceEvents/index.js +0 -12
  701. package/node/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.js +0 -5
  702. package/node/internals/corePlugins/useTreeViewOptionalPlugins/index.js +0 -12
  703. package/node/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.js +0 -19
  704. package/node/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.js +0 -5
  705. package/node/internals/hooks/useLazyRef.js +0 -13
  706. package/node/internals/hooks/useOnMount.js +0 -13
  707. package/node/internals/hooks/useSelector.js +0 -13
  708. package/node/internals/hooks/useTimeout.js +0 -13
  709. package/node/internals/index.js +0 -160
  710. package/node/internals/models/events.js +0 -5
  711. package/node/internals/models/helpers.js +0 -5
  712. package/node/internals/models/index.js +0 -49
  713. package/node/internals/models/itemPlugin.js +0 -5
  714. package/node/internals/models/plugin.js +0 -5
  715. package/node/internals/models/treeView.js +0 -5
  716. package/node/internals/plugins/useTreeViewExpansion/index.js +0 -12
  717. package/node/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.js +0 -119
  718. package/node/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.js +0 -30
  719. package/node/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.types.js +0 -5
  720. package/node/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.utils.js +0 -27
  721. package/node/internals/plugins/useTreeViewFocus/index.js +0 -12
  722. package/node/internals/plugins/useTreeViewFocus/useTreeViewFocus.js +0 -144
  723. package/node/internals/plugins/useTreeViewFocus/useTreeViewFocus.types.js +0 -5
  724. package/node/internals/plugins/useTreeViewIcons/index.js +0 -12
  725. package/node/internals/plugins/useTreeViewIcons/useTreeViewIcons.types.js +0 -5
  726. package/node/internals/plugins/useTreeViewItems/index.js +0 -25
  727. package/node/internals/plugins/useTreeViewItems/useTreeViewItems.types.js +0 -5
  728. package/node/internals/plugins/useTreeViewItems/useTreeViewItems.utils.js +0 -15
  729. package/node/internals/plugins/useTreeViewJSXItems/index.js +0 -12
  730. package/node/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.js +0 -192
  731. package/node/internals/plugins/useTreeViewJSXItems/useTreeViewJSXItems.types.js +0 -5
  732. package/node/internals/plugins/useTreeViewKeyboardNavigation/index.js +0 -12
  733. package/node/internals/plugins/useTreeViewKeyboardNavigation/useTreeViewKeyboardNavigation.types.js +0 -5
  734. package/node/internals/plugins/useTreeViewLabel/index.js +0 -12
  735. package/node/internals/plugins/useTreeViewLabel/useTreeViewLabel.types.js +0 -5
  736. package/node/internals/plugins/useTreeViewSelection/index.js +0 -12
  737. package/node/internals/plugins/useTreeViewSelection/useTreeViewSelection.selectors.js +0 -15
  738. package/node/internals/plugins/useTreeViewSelection/useTreeViewSelection.types.js +0 -5
  739. package/node/internals/useTreeView/index.js +0 -12
  740. package/node/internals/useTreeView/useTreeView.types.js +0 -5
  741. package/node/internals/useTreeView/useTreeViewPlugins.js +0 -1
  742. package/node/internals/utils/cleanupTracking/CleanupTracking.js +0 -5
  743. package/node/internals/utils/plugins.js +0 -11
  744. package/node/internals/utils/publishTreeViewEvent.js +0 -10
  745. package/node/internals/zero-styled/index.js +0 -17
  746. package/node/models/events.js +0 -5
  747. package/node/models/index.js +0 -27
  748. package/node/models/items.js +0 -5
  749. package/node/themeAugmentation/index.js +0 -1
  750. package/node/useTreeItem/index.js +0 -12
  751. package/node/useTreeItem/useTreeItem.types.js +0 -5
  752. package/themeAugmentation/package.json +0 -6
  753. package/useTreeItem/package.json +0 -6
@@ -1,11 +1,5 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.selectorItemParentId = exports.selectorItemOrderedChildrenIds = exports.selectorItemModel = exports.selectorItemMetaLookup = exports.selectorItemMeta = exports.selectorItemIndex = exports.selectorItemDepth = exports.selectorIsItemDisabled = exports.selectorCanItemBeFocused = void 0;
7
- var _selectors = require("../../utils/selectors");
8
- var _useTreeViewItems = require("./useTreeViewItems.utils");
1
+ import { createSelector } from "../../utils/selectors.js";
2
+ import { TREE_VIEW_ROOT_PARENT_ID } from "./useTreeViewItems.utils.js";
9
3
  const selectorTreeViewItemsState = state => state.items;
10
4
 
11
5
  /**
@@ -13,7 +7,7 @@ const selectorTreeViewItemsState = state => state.items;
13
7
  * @param {TreeViewState<[UseTreeViewItemsSignature]>} state The state of the tree view.
14
8
  * @returns {TreeViewItemMetaLookup} The meta-information of all items.
15
9
  */
16
- const selectorItemMetaLookup = exports.selectorItemMetaLookup = (0, _selectors.createSelector)(selectorTreeViewItemsState, items => items.itemMetaLookup);
10
+ export const selectorItemMetaLookup = createSelector(selectorTreeViewItemsState, items => items.itemMetaLookup);
17
11
  const EMPTY_CHILDREN = [];
18
12
 
19
13
  /**
@@ -22,7 +16,7 @@ const EMPTY_CHILDREN = [];
22
16
  * @param {TreeViewItemId} itemId The id of the item to get the children of.
23
17
  * @returns {TreeViewItemId[]} The ordered children ids of the item.
24
18
  */
25
- const selectorItemOrderedChildrenIds = exports.selectorItemOrderedChildrenIds = (0, _selectors.createSelector)([selectorTreeViewItemsState, (_, itemId) => itemId], (itemsState, itemId) => itemsState.itemOrderedChildrenIdsLookup[itemId ?? _useTreeViewItems.TREE_VIEW_ROOT_PARENT_ID] ?? EMPTY_CHILDREN);
19
+ export const selectorItemOrderedChildrenIds = createSelector([selectorTreeViewItemsState, (_, itemId) => itemId], (itemsState, itemId) => itemsState.itemOrderedChildrenIdsLookup[itemId ?? TREE_VIEW_ROOT_PARENT_ID] ?? EMPTY_CHILDREN);
26
20
 
27
21
  /**
28
22
  * Get the model of an item.
@@ -30,7 +24,7 @@ const selectorItemOrderedChildrenIds = exports.selectorItemOrderedChildrenIds =
30
24
  * @param {TreeViewItemId} itemId The id of the item to get the model of.
31
25
  * @returns {R} The model of the item.
32
26
  */
33
- const selectorItemModel = exports.selectorItemModel = (0, _selectors.createSelector)([selectorTreeViewItemsState, (_, itemId) => itemId], (itemsState, itemId) => {
27
+ export const selectorItemModel = createSelector([selectorTreeViewItemsState, (_, itemId) => itemId], (itemsState, itemId) => {
34
28
  const a = itemsState.itemModelLookup[itemId];
35
29
  return a;
36
30
  });
@@ -42,7 +36,7 @@ const selectorItemModel = exports.selectorItemModel = (0, _selectors.createSelec
42
36
  * @param {TreeViewItemId} itemId The id of the item to get the meta-information of.
43
37
  * @returns {TreeViewItemMeta | null} The meta-information of the item.
44
38
  */
45
- const selectorItemMeta = exports.selectorItemMeta = (0, _selectors.createSelector)([selectorItemMetaLookup, (_, itemId) => itemId], (itemMetaLookup, itemId) => itemMetaLookup[itemId ?? _useTreeViewItems.TREE_VIEW_ROOT_PARENT_ID] ?? null);
39
+ export const selectorItemMeta = createSelector([selectorItemMetaLookup, (_, itemId) => itemId], (itemMetaLookup, itemId) => itemMetaLookup[itemId ?? TREE_VIEW_ROOT_PARENT_ID] ?? null);
46
40
 
47
41
  /**
48
42
  * Check if an item is disabled.
@@ -50,7 +44,7 @@ const selectorItemMeta = exports.selectorItemMeta = (0, _selectors.createSelecto
50
44
  * @param {TreeViewItemId} itemId The id of the item to check.
51
45
  * @returns {boolean} `true` if the item is disabled, `false` otherwise.
52
46
  */
53
- const selectorIsItemDisabled = exports.selectorIsItemDisabled = (0, _selectors.createSelector)([selectorItemMetaLookup, (_, itemId) => itemId], (itemMetaLookup, itemId) => {
47
+ export const selectorIsItemDisabled = createSelector([selectorItemMetaLookup, (_, itemId) => itemId], (itemMetaLookup, itemId) => {
54
48
  if (itemId == null) {
55
49
  return false;
56
50
  }
@@ -78,11 +72,11 @@ const selectorIsItemDisabled = exports.selectorIsItemDisabled = (0, _selectors.c
78
72
  * @param {TreeViewItemId} itemId The id of the item to get the index of.
79
73
  * @returns {number} The index of the item in its parent's children.
80
74
  */
81
- const selectorItemIndex = exports.selectorItemIndex = (0, _selectors.createSelector)([selectorTreeViewItemsState, selectorItemMeta], (itemsState, itemMeta) => {
75
+ export const selectorItemIndex = createSelector([selectorTreeViewItemsState, selectorItemMeta], (itemsState, itemMeta) => {
82
76
  if (itemMeta == null) {
83
77
  return -1;
84
78
  }
85
- const parentIndexes = itemsState.itemChildrenIndexesLookup[itemMeta.parentId ?? _useTreeViewItems.TREE_VIEW_ROOT_PARENT_ID];
79
+ const parentIndexes = itemsState.itemChildrenIndexesLookup[itemMeta.parentId ?? TREE_VIEW_ROOT_PARENT_ID];
86
80
  return parentIndexes[itemMeta.id];
87
81
  });
88
82
 
@@ -92,7 +86,7 @@ const selectorItemIndex = exports.selectorItemIndex = (0, _selectors.createSelec
92
86
  * @param {TreeViewItemId} itemId The id of the item to get the parent id of.
93
87
  * @returns {TreeViewItemId | null} The id of the parent of the item.
94
88
  */
95
- const selectorItemParentId = exports.selectorItemParentId = (0, _selectors.createSelector)([selectorItemMeta], itemMeta => itemMeta?.parentId ?? null);
89
+ export const selectorItemParentId = createSelector([selectorItemMeta], itemMeta => itemMeta?.parentId ?? null);
96
90
 
97
91
  /**
98
92
  * Get the depth of an item (items at the root level have a depth of 0).
@@ -100,8 +94,8 @@ const selectorItemParentId = exports.selectorItemParentId = (0, _selectors.creat
100
94
  * @param {TreeViewItemId} itemId The id of the item to get the depth of.
101
95
  * @returns {number} The depth of the item.
102
96
  */
103
- const selectorItemDepth = exports.selectorItemDepth = (0, _selectors.createSelector)([selectorItemMeta], itemMeta => itemMeta?.depth ?? 0);
104
- const selectorCanItemBeFocused = exports.selectorCanItemBeFocused = (0, _selectors.createSelector)([selectorTreeViewItemsState, selectorIsItemDisabled], (itemsState, isItemDisabled) => {
97
+ export const selectorItemDepth = createSelector([selectorItemMeta], itemMeta => itemMeta?.depth ?? 0);
98
+ export const selectorCanItemBeFocused = createSelector([selectorTreeViewItemsState, selectorIsItemDisabled], (itemsState, isItemDisabled) => {
105
99
  if (itemsState.disabledItemsFocusable) {
106
100
  return true;
107
101
  }
@@ -0,0 +1,156 @@
1
+ import * as React from 'react';
2
+ import { DefaultizedProps } from '@mui/x-internals/types';
3
+ import { TreeViewItemMeta, TreeViewPluginSignature } from "../../models/index.js";
4
+ import { TreeViewBaseItem, TreeViewDefaultItemModelProperties, TreeViewItemId } from "../../../models/index.js";
5
+ export interface UseTreeViewItemsPublicAPI<R extends {}> {
6
+ /**
7
+ * Get the item with the given id.
8
+ * When used in the Simple Tree View, it returns an object with the `id` and `label` properties.
9
+ * @param {string} itemId The id of the item to retrieve.
10
+ * @returns {R} The item with the given id.
11
+ */
12
+ getItem: (itemId: TreeViewItemId) => R;
13
+ /**
14
+ * Get the DOM element of the item with the given id.
15
+ * @param {TreeViewItemId} itemId The id of the item to get the DOM element of.
16
+ * @returns {HTMLElement | null} The DOM element of the item with the given id.
17
+ */
18
+ getItemDOMElement: (itemId: TreeViewItemId) => HTMLElement | null;
19
+ /**
20
+ * Get the ids of a given item's children.
21
+ * Those ids are returned in the order they should be rendered.
22
+ * To get the root items, pass `null` as the `itemId`.
23
+ * @param {TreeViewItemId | null} itemId The id of the item to get the children of.
24
+ * @returns {TreeViewItemId[]} The ids of the item's children.
25
+ */
26
+ getItemOrderedChildrenIds: (itemId: TreeViewItemId | null) => TreeViewItemId[];
27
+ /**
28
+ * Get all the items in the same format as provided by `props.items`.
29
+ * @returns {TreeViewBaseItem[]} The items in the tree.
30
+ */
31
+ getItemTree: () => TreeViewBaseItem[];
32
+ }
33
+ export interface UseTreeViewItemsInstance<R extends {}> extends Pick<UseTreeViewItemsPublicAPI<R>, 'getItemDOMElement'> {
34
+ /**
35
+ * Freeze any future update to the state based on the `items` prop.
36
+ * This is useful when `useTreeViewJSXItems` is used to avoid having conflicting sources of truth.
37
+ */
38
+ preventItemUpdates: () => void;
39
+ /**
40
+ * Check if the updates to the state based on the `items` prop are prevented.
41
+ * This is useful when `useTreeViewJSXItems` is used to avoid having conflicting sources of truth.
42
+ * @returns {boolean} `true` if the updates to the state based on the `items` prop are prevented.
43
+ */
44
+ areItemUpdatesPrevented: () => boolean;
45
+ }
46
+ export interface UseTreeViewItemsParameters<R extends {
47
+ children?: R[];
48
+ }> {
49
+ /**
50
+ * If `true`, will allow focus on disabled items.
51
+ * @default false
52
+ */
53
+ disabledItemsFocusable?: boolean;
54
+ items: readonly R[];
55
+ /**
56
+ * Used to determine if a given item should be disabled.
57
+ * @template R
58
+ * @param {R} item The item to check.
59
+ * @returns {boolean} `true` if the item should be disabled.
60
+ */
61
+ isItemDisabled?: (item: R) => boolean;
62
+ /**
63
+ * Used to determine the string label for a given item.
64
+ *
65
+ * @template R
66
+ * @param {R} item The item to check.
67
+ * @returns {string} The label of the item.
68
+ * @default (item) => item.label
69
+ */
70
+ getItemLabel?: (item: R) => string;
71
+ /**
72
+ * Used to determine the id of a given item.
73
+ *
74
+ * @template R
75
+ * @param {R} item The item to check.
76
+ * @returns {string} The id of the item.
77
+ * @default (item) => item.id
78
+ */
79
+ getItemId?: (item: R) => TreeViewItemId;
80
+ /**
81
+ * Callback fired when the `content` slot of a given Tree Item is clicked.
82
+ * @param {React.MouseEvent} event The DOM event that triggered the change.
83
+ * @param {string} itemId The id of the focused item.
84
+ */
85
+ onItemClick?: (event: React.MouseEvent, itemId: string) => void;
86
+ /**
87
+ * Horizontal indentation between an item and its children.
88
+ * Examples: 24, "24px", "2rem", "2em".
89
+ * @default 12px
90
+ */
91
+ itemChildrenIndentation?: string | number;
92
+ }
93
+ export type UseTreeViewItemsDefaultizedParameters<R extends {
94
+ children?: R[];
95
+ }> = DefaultizedProps<UseTreeViewItemsParameters<R>, 'disabledItemsFocusable' | 'itemChildrenIndentation'>;
96
+ interface UseTreeViewItemsEventLookup {
97
+ removeItem: {
98
+ params: {
99
+ id: string;
100
+ };
101
+ };
102
+ }
103
+ export interface UseTreeViewItemsState<R extends {}> {
104
+ items: {
105
+ /**
106
+ * If `true`, will allow focus on disabled items.
107
+ * Always equal to `props.disabledItemsFocusable` (or `false` if not provided).
108
+ */
109
+ disabledItemsFocusable: boolean;
110
+ /**
111
+ * Model of each item as provided by `props.items` or by imperative items updates.
112
+ * It is not updated when properties derived from the model are updated:
113
+ * - when the label of an item is updated, `itemMetaLookup` is updated, not `itemModelLookup`.
114
+ * - when the children of an item are updated, `itemOrderedChildrenIdsLookup` and `itemChildrenIndexesLookup` are updated, not `itemModelLookup`.
115
+ * This means that the `children`, `label` or `id` properties of an item model should never be used directly, always use the structured sub-states instead.
116
+ */
117
+ itemModelLookup: {
118
+ [itemId: string]: TreeViewBaseItem<R>;
119
+ };
120
+ /**
121
+ * Meta data of each item.
122
+ */
123
+ itemMetaLookup: {
124
+ [itemId: string]: TreeViewItemMeta;
125
+ };
126
+ /**
127
+ * Ordered children ids of each item.
128
+ */
129
+ itemOrderedChildrenIdsLookup: {
130
+ [parentItemId: string]: string[];
131
+ };
132
+ /**
133
+ * Index of each child in the ordered children ids of its parent.
134
+ */
135
+ itemChildrenIndexesLookup: {
136
+ [parentItemId: string]: {
137
+ [itemId: string]: number;
138
+ };
139
+ };
140
+ };
141
+ }
142
+ interface UseTreeViewItemsContextValue {
143
+ items: {
144
+ onItemClick: (event: React.MouseEvent, itemId: string) => void;
145
+ };
146
+ }
147
+ export type UseTreeViewItemsSignature = TreeViewPluginSignature<{
148
+ params: UseTreeViewItemsParameters<any>;
149
+ defaultizedParams: UseTreeViewItemsDefaultizedParameters<any>;
150
+ instance: UseTreeViewItemsInstance<any>;
151
+ publicAPI: UseTreeViewItemsPublicAPI<any>;
152
+ events: UseTreeViewItemsEventLookup;
153
+ state: UseTreeViewItemsState<TreeViewDefaultItemModelProperties>;
154
+ contextValue: UseTreeViewItemsContextValue;
155
+ }>;
156
+ export {};
@@ -0,0 +1,4 @@
1
+ export declare const TREE_VIEW_ROOT_PARENT_ID = "__TREE_VIEW_ROOT_PARENT_ID__";
2
+ export declare const buildSiblingIndexes: (siblings: string[]) => {
3
+ [itemId: string]: number;
4
+ };
@@ -0,0 +1,8 @@
1
+ export const TREE_VIEW_ROOT_PARENT_ID = '__TREE_VIEW_ROOT_PARENT_ID__';
2
+ export const buildSiblingIndexes = siblings => {
3
+ const siblingsIndexLookup = {};
4
+ siblings.forEach((childId, index) => {
5
+ siblingsIndexLookup[childId] = index;
6
+ });
7
+ return siblingsIndexLookup;
8
+ };
@@ -0,0 +1,2 @@
1
+ export { useTreeViewJSXItems } from "./useTreeViewJSXItems.js";
2
+ export type { UseTreeViewJSXItemsSignature, UseTreeViewJSXItemsParameters, UseTreeViewItemsDefaultizedParameters } from './useTreeViewJSXItems.types';
@@ -0,0 +1 @@
1
+ export { useTreeViewJSXItems } from "./useTreeViewJSXItems.js";
@@ -0,0 +1,3 @@
1
+ import { TreeViewPlugin } from "../../models/index.js";
2
+ import { UseTreeViewJSXItemsSignature } from "./useTreeViewJSXItems.types.js";
3
+ export declare const useTreeViewJSXItems: TreeViewPlugin<UseTreeViewJSXItemsSignature>;
@@ -0,0 +1,183 @@
1
+ import _extends from "@babel/runtime/helpers/esm/extends";
2
+ import * as React from 'react';
3
+ import useEventCallback from '@mui/utils/useEventCallback';
4
+ import useForkRef from '@mui/utils/useForkRef';
5
+ import useEnhancedEffect from '@mui/utils/useEnhancedEffect';
6
+ import { publishTreeViewEvent } from "../../utils/publishTreeViewEvent.js";
7
+ import { useTreeViewContext } from "../../TreeViewProvider/index.js";
8
+ import { TreeViewChildrenItemContext, TreeViewChildrenItemProvider } from "../../TreeViewProvider/TreeViewChildrenItemProvider.js";
9
+ import { buildSiblingIndexes, TREE_VIEW_ROOT_PARENT_ID } from "../useTreeViewItems/useTreeViewItems.utils.js";
10
+ import { TreeViewItemDepthContext } from "../../TreeViewItemDepthContext/index.js";
11
+ import { generateTreeItemIdAttribute } from "../../corePlugins/useTreeViewId/useTreeViewId.utils.js";
12
+ import { isItemExpandable } from "../../../hooks/useTreeItemUtils/useTreeItemUtils.js";
13
+ import { useSelector } from "../../hooks/useSelector.js";
14
+ import { selectorTreeViewId } from "../../corePlugins/useTreeViewId/useTreeViewId.selectors.js";
15
+ import { jsx as _jsx } from "react/jsx-runtime";
16
+ export const useTreeViewJSXItems = ({
17
+ instance,
18
+ store
19
+ }) => {
20
+ instance.preventItemUpdates();
21
+ const insertJSXItem = useEventCallback(item => {
22
+ store.update(prevState => {
23
+ if (prevState.items.itemMetaLookup[item.id] != null) {
24
+ throw new Error(['MUI X: The Tree View component requires all items to have a unique `id` property.', 'Alternatively, you can use the `getItemId` prop to specify a custom id for each item.', `Two items were provided with the same id in the \`items\` prop: "${item.id}"`].join('\n'));
25
+ }
26
+ return _extends({}, prevState, {
27
+ items: _extends({}, prevState.items, {
28
+ itemMetaLookup: _extends({}, prevState.items.itemMetaLookup, {
29
+ [item.id]: item
30
+ }),
31
+ // For Simple Tree View, we don't have a proper `item` object, so we create a very basic one.
32
+ itemModelLookup: _extends({}, prevState.items.itemModelLookup, {
33
+ [item.id]: {
34
+ id: item.id,
35
+ label: item.label ?? ''
36
+ }
37
+ })
38
+ })
39
+ });
40
+ });
41
+ return () => {
42
+ store.update(prevState => {
43
+ const newItemMetaLookup = _extends({}, prevState.items.itemMetaLookup);
44
+ const newItemModelLookup = _extends({}, prevState.items.itemModelLookup);
45
+ delete newItemMetaLookup[item.id];
46
+ delete newItemModelLookup[item.id];
47
+ return _extends({}, prevState, {
48
+ items: _extends({}, prevState.items, {
49
+ itemMetaLookup: newItemMetaLookup,
50
+ itemModelLookup: newItemModelLookup
51
+ })
52
+ });
53
+ });
54
+ publishTreeViewEvent(instance, 'removeItem', {
55
+ id: item.id
56
+ });
57
+ };
58
+ });
59
+ const setJSXItemsOrderedChildrenIds = (parentId, orderedChildrenIds) => {
60
+ const parentIdWithDefault = parentId ?? TREE_VIEW_ROOT_PARENT_ID;
61
+ store.update(prevState => _extends({}, prevState, {
62
+ items: _extends({}, prevState.items, {
63
+ itemOrderedChildrenIdsLookup: _extends({}, prevState.items.itemOrderedChildrenIdsLookup, {
64
+ [parentIdWithDefault]: orderedChildrenIds
65
+ }),
66
+ itemChildrenIndexesLookup: _extends({}, prevState.items.itemChildrenIndexesLookup, {
67
+ [parentIdWithDefault]: buildSiblingIndexes(orderedChildrenIds)
68
+ })
69
+ })
70
+ }));
71
+ };
72
+ const mapFirstCharFromJSX = useEventCallback((itemId, firstChar) => {
73
+ instance.updateFirstCharMap(firstCharMap => {
74
+ firstCharMap[itemId] = firstChar;
75
+ return firstCharMap;
76
+ });
77
+ return () => {
78
+ instance.updateFirstCharMap(firstCharMap => {
79
+ const newMap = _extends({}, firstCharMap);
80
+ delete newMap[itemId];
81
+ return newMap;
82
+ });
83
+ };
84
+ });
85
+ return {
86
+ instance: {
87
+ insertJSXItem,
88
+ setJSXItemsOrderedChildrenIds,
89
+ mapFirstCharFromJSX
90
+ }
91
+ };
92
+ };
93
+ const useTreeViewJSXItemsItemPlugin = ({
94
+ props,
95
+ rootRef,
96
+ contentRef
97
+ }) => {
98
+ const {
99
+ instance,
100
+ store
101
+ } = useTreeViewContext();
102
+ const {
103
+ children,
104
+ disabled = false,
105
+ label,
106
+ itemId,
107
+ id
108
+ } = props;
109
+ const parentContext = React.useContext(TreeViewChildrenItemContext);
110
+ if (parentContext == null) {
111
+ throw new Error(['MUI X: Could not find the Tree View Children Item context.', 'It looks like you rendered your component outside of a SimpleTreeView parent component.', 'This can also happen if you are bundling multiple versions of the Tree View.'].join('\n'));
112
+ }
113
+ const {
114
+ registerChild,
115
+ unregisterChild,
116
+ parentId
117
+ } = parentContext;
118
+ const expandable = isItemExpandable(children);
119
+ const pluginContentRef = React.useRef(null);
120
+ const handleContentRef = useForkRef(pluginContentRef, contentRef);
121
+ const treeId = useSelector(store, selectorTreeViewId);
122
+
123
+ // Prevent any flashing
124
+ useEnhancedEffect(() => {
125
+ const idAttribute = generateTreeItemIdAttribute({
126
+ itemId,
127
+ treeId,
128
+ id
129
+ });
130
+ registerChild(idAttribute, itemId);
131
+ return () => {
132
+ unregisterChild(idAttribute);
133
+ unregisterChild(idAttribute);
134
+ };
135
+ }, [store, instance, registerChild, unregisterChild, itemId, id, treeId]);
136
+ useEnhancedEffect(() => {
137
+ return instance.insertJSXItem({
138
+ id: itemId,
139
+ idAttribute: id,
140
+ parentId,
141
+ expandable,
142
+ disabled
143
+ });
144
+ }, [instance, parentId, itemId, expandable, disabled, id]);
145
+ React.useEffect(() => {
146
+ if (label) {
147
+ return instance.mapFirstCharFromJSX(itemId, (pluginContentRef.current?.textContent ?? '').substring(0, 1).toLowerCase());
148
+ }
149
+ return undefined;
150
+ }, [instance, itemId, label]);
151
+ return {
152
+ contentRef: handleContentRef,
153
+ rootRef
154
+ };
155
+ };
156
+ useTreeViewJSXItems.itemPlugin = useTreeViewJSXItemsItemPlugin;
157
+ useTreeViewJSXItems.wrapItem = ({
158
+ children,
159
+ itemId,
160
+ idAttribute
161
+ }) => {
162
+ // eslint-disable-next-line react-hooks/rules-of-hooks
163
+ const depthContext = React.useContext(TreeViewItemDepthContext);
164
+ return /*#__PURE__*/_jsx(TreeViewChildrenItemProvider, {
165
+ itemId: itemId,
166
+ idAttribute: idAttribute,
167
+ children: /*#__PURE__*/_jsx(TreeViewItemDepthContext.Provider, {
168
+ value: depthContext + 1,
169
+ children: children
170
+ })
171
+ });
172
+ };
173
+ useTreeViewJSXItems.wrapRoot = ({
174
+ children
175
+ }) => /*#__PURE__*/_jsx(TreeViewChildrenItemProvider, {
176
+ itemId: null,
177
+ idAttribute: null,
178
+ children: /*#__PURE__*/_jsx(TreeViewItemDepthContext.Provider, {
179
+ value: 0,
180
+ children: children
181
+ })
182
+ });
183
+ useTreeViewJSXItems.params = {};
@@ -0,0 +1,35 @@
1
+ import { TreeViewItemMeta, TreeViewPluginSignature } from "../../models/index.js";
2
+ import { UseTreeViewItemsSignature } from "../useTreeViewItems/index.js";
3
+ import { UseTreeViewKeyboardNavigationSignature } from "../useTreeViewKeyboardNavigation/index.js";
4
+ import { TreeViewItemId } from "../../../models/index.js";
5
+ export interface UseTreeViewItemsInstance {
6
+ /**
7
+ * Insert a new item in the state from a Tree Item component.
8
+ * @param {TreeViewItemMeta} item The meta-information of the item to insert.
9
+ * @returns {() => void} A function to remove the item from the state.
10
+ */
11
+ insertJSXItem: (item: TreeViewItemMeta) => () => void;
12
+ /**
13
+ * Updates the `firstCharMap` to register the first character of the given item's label.
14
+ * This map is used to navigate the tree using type-ahead search.
15
+ * @param {TreeViewItemId} itemId The id of the item to map the first character of.
16
+ * @param {string} firstChar The first character of the item's label.
17
+ * @returns {() => void} A function to remove the item from the `firstCharMap`.
18
+ */
19
+ mapFirstCharFromJSX: (itemId: TreeViewItemId, firstChar: string) => () => void;
20
+ /**
21
+ * Store the ids of a given item's children in the state.
22
+ * Those ids must be passed in the order they should be rendered.
23
+ * @param {TreeViewItemId | null} parentId The id of the item to store the children of.
24
+ * @param {TreeViewItemId[]} orderedChildrenIds The ids of the item's children.
25
+ */
26
+ setJSXItemsOrderedChildrenIds: (parentId: TreeViewItemId | null, orderedChildrenIds: TreeViewItemId[]) => void;
27
+ }
28
+ export interface UseTreeViewJSXItemsParameters {}
29
+ export interface UseTreeViewItemsDefaultizedParameters {}
30
+ export type UseTreeViewJSXItemsSignature = TreeViewPluginSignature<{
31
+ params: UseTreeViewJSXItemsParameters;
32
+ defaultizedParams: UseTreeViewItemsDefaultizedParameters;
33
+ instance: UseTreeViewItemsInstance;
34
+ dependencies: [UseTreeViewItemsSignature, UseTreeViewKeyboardNavigationSignature];
35
+ }>;
@@ -0,0 +1,2 @@
1
+ export { useTreeViewKeyboardNavigation } from "./useTreeViewKeyboardNavigation.js";
2
+ export type { UseTreeViewKeyboardNavigationSignature } from './useTreeViewKeyboardNavigation.types';
@@ -0,0 +1 @@
1
+ export { useTreeViewKeyboardNavigation } from "./useTreeViewKeyboardNavigation.js";
@@ -0,0 +1,3 @@
1
+ import { TreeViewPlugin } from "../../models/index.js";
2
+ import { UseTreeViewKeyboardNavigationSignature } from "./useTreeViewKeyboardNavigation.types.js";
3
+ export declare const useTreeViewKeyboardNavigation: TreeViewPlugin<UseTreeViewKeyboardNavigationSignature>;