@carbon/react 1.103.0-rc.0 → 1.104.0-rc.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 (777) hide show
  1. package/.playwright/INTERNAL_AVT_REPORT_DO_NOT_USE.json +950 -950
  2. package/es/_virtual/_rolldown/runtime.js +25 -0
  3. package/es/components/AILabel/index.d.ts +29 -2
  4. package/es/components/AILabel/index.js +114 -169
  5. package/es/components/AISkeleton/AISkeletonIcon.js +23 -27
  6. package/es/components/AISkeleton/AISkeletonPlaceholder.js +19 -27
  7. package/es/components/AISkeleton/AISkeletonText.js +26 -39
  8. package/es/components/Accordion/Accordion.Skeleton.js +55 -79
  9. package/es/components/Accordion/Accordion.js +43 -61
  10. package/es/components/Accordion/AccordionItem.js +102 -156
  11. package/es/components/Accordion/AccordionProvider.js +18 -15
  12. package/es/components/AspectRatio/AspectRatio.js +41 -47
  13. package/es/components/BadgeIndicator/index.js +28 -33
  14. package/es/components/Breadcrumb/Breadcrumb.Skeleton.js +39 -50
  15. package/es/components/Breadcrumb/Breadcrumb.js +39 -51
  16. package/es/components/Breadcrumb/BreadcrumbItem.js +80 -83
  17. package/es/components/Button/Button.Skeleton.js +49 -58
  18. package/es/components/Button/Button.d.ts +1 -1
  19. package/es/components/Button/Button.js +146 -240
  20. package/es/components/Button/ButtonBase.js +82 -104
  21. package/es/components/Button/index.js +13 -6
  22. package/es/components/ButtonSet/ButtonSet.js +74 -98
  23. package/es/components/ButtonSet/index.js +12 -4
  24. package/es/components/ChatButton/ChatButton.Skeleton.js +27 -27
  25. package/es/components/ChatButton/ChatButton.js +64 -79
  26. package/es/components/Checkbox/Checkbox.Skeleton.js +26 -25
  27. package/es/components/Checkbox/Checkbox.js +116 -195
  28. package/es/components/Checkbox/index.js +13 -5
  29. package/es/components/CheckboxGroup/CheckboxGroup.js +100 -148
  30. package/es/components/ClassPrefix/index.js +21 -17
  31. package/es/components/CodeSnippet/CodeSnippet.Skeleton.js +45 -42
  32. package/es/components/CodeSnippet/CodeSnippet.js +210 -299
  33. package/es/components/ComboBox/ComboBox.js +621 -970
  34. package/es/components/ComboBox/index.js +12 -4
  35. package/es/components/ComboButton/index.js +172 -208
  36. package/es/components/ComposedModal/ComposedModal.js +311 -450
  37. package/es/components/ComposedModal/ComposedModalPresence.js +47 -42
  38. package/es/components/ComposedModal/ModalFooter.js +127 -207
  39. package/es/components/ComposedModal/ModalHeader.js +71 -101
  40. package/es/components/ComposedModal/useComposedModalState.js +21 -15
  41. package/es/components/ContainedList/ContainedList.js +67 -102
  42. package/es/components/ContainedList/ContainedListItem/ContainedListItem.js +49 -67
  43. package/es/components/ContainedList/ContainedListItem/index.js +12 -4
  44. package/es/components/ContainedList/index.js +15 -12
  45. package/es/components/ContentSwitcher/ContentSwitcher.js +108 -140
  46. package/es/components/ContextMenu/useContextMenu.js +41 -36
  47. package/es/components/Copy/Copy.js +97 -117
  48. package/es/components/Copy/index.js +12 -4
  49. package/es/components/CopyButton/CopyButton.js +81 -94
  50. package/es/components/CopyButton/index.js +12 -4
  51. package/es/components/DangerButton/DangerButton.js +11 -9
  52. package/es/components/DataTable/DataTable.d.ts +11 -11
  53. package/es/components/DataTable/DataTable.js +448 -630
  54. package/es/components/DataTable/Table.js +111 -156
  55. package/es/components/DataTable/TableActionList.js +14 -6
  56. package/es/components/DataTable/TableBatchAction.js +25 -34
  57. package/es/components/DataTable/TableBatchActions.js +78 -113
  58. package/es/components/DataTable/TableBody.js +26 -19
  59. package/es/components/DataTable/TableCell.js +31 -46
  60. package/es/components/DataTable/TableContainer.js +75 -82
  61. package/es/components/DataTable/TableContext.js +14 -6
  62. package/es/components/DataTable/TableDecoratorRow.js +30 -36
  63. package/es/components/DataTable/TableExpandHeader.js +53 -90
  64. package/es/components/DataTable/TableExpandRow.js +82 -119
  65. package/es/components/DataTable/TableExpandedRow.js +45 -51
  66. package/es/components/DataTable/TableHead.js +7 -5
  67. package/es/components/DataTable/TableHeader.js +138 -181
  68. package/es/components/DataTable/TableRow.d.ts +1 -1
  69. package/es/components/DataTable/TableRow.js +42 -76
  70. package/es/components/DataTable/TableSelectAll.js +42 -70
  71. package/es/components/DataTable/TableSelectRow.js +63 -98
  72. package/es/components/DataTable/TableSlugRow.js +35 -43
  73. package/es/components/DataTable/TableToolbar.js +33 -45
  74. package/es/components/DataTable/TableToolbarAction.js +25 -20
  75. package/es/components/DataTable/TableToolbarContent.js +14 -6
  76. package/es/components/DataTable/TableToolbarMenu.js +35 -46
  77. package/es/components/DataTable/TableToolbarSearch.js +97 -187
  78. package/es/components/DataTable/state/getDerivedStateFromProps.js +38 -43
  79. package/es/components/DataTable/state/sortStates.js +11 -9
  80. package/es/components/DataTable/state/sorting.js +53 -72
  81. package/es/components/DataTable/tools/cells.js +15 -7
  82. package/es/components/DataTable/tools/denormalize.js +27 -19
  83. package/es/components/DataTable/tools/filter.js +21 -22
  84. package/es/components/DataTable/tools/normalize.js +57 -72
  85. package/es/components/DataTable/tools/sorting.js +50 -71
  86. package/es/components/DataTableSkeleton/DataTableSkeleton.js +66 -94
  87. package/es/components/DatePicker/DatePicker.Skeleton.js +44 -51
  88. package/es/components/DatePicker/DatePicker.d.ts +4 -2
  89. package/es/components/DatePicker/DatePicker.js +485 -749
  90. package/es/components/DatePicker/DatePickerLocales.js +75 -126
  91. package/es/components/DatePicker/index.js +13 -5
  92. package/es/components/DatePicker/plugins/appendToPlugin.js +31 -45
  93. package/es/components/DatePicker/plugins/fixEventsPlugin.js +127 -171
  94. package/es/components/DatePicker/plugins/rangePlugin.d.ts +1 -1
  95. package/es/components/DatePicker/plugins/rangePlugin.js +40 -47
  96. package/es/components/DatePicker/utils.d.ts +7 -0
  97. package/es/components/DatePicker/utils.js +18 -0
  98. package/es/components/DatePickerInput/DatePickerInput.js +179 -289
  99. package/es/components/DatePickerInput/index.js +12 -4
  100. package/es/components/Dialog/Dialog.js +303 -574
  101. package/es/components/Dialog/index.js +18 -2
  102. package/es/components/Dropdown/Dropdown.Skeleton.js +26 -38
  103. package/es/components/Dropdown/Dropdown.js +344 -535
  104. package/es/components/Dropdown/index.js +13 -5
  105. package/es/components/ErrorBoundary/ErrorBoundary.js +36 -58
  106. package/es/components/ErrorBoundary/ErrorBoundaryContext.js +14 -9
  107. package/es/components/ExpandableSearch/ExpandableSearch.js +60 -69
  108. package/es/components/ExpandableSearch/index.js +12 -4
  109. package/es/components/FeatureFlags/index.d.ts +11 -2
  110. package/es/components/FeatureFlags/index.js +79 -77
  111. package/es/components/FileUploader/FileUploader.Skeleton.js +35 -30
  112. package/es/components/FileUploader/FileUploader.js +269 -343
  113. package/es/components/FileUploader/FileUploaderButton.js +110 -160
  114. package/es/components/FileUploader/FileUploaderDropContainer.js +144 -221
  115. package/es/components/FileUploader/FileUploaderItem.js +138 -157
  116. package/es/components/FileUploader/Filename.d.ts +1 -1
  117. package/es/components/FileUploader/Filename.js +53 -72
  118. package/es/components/FluidComboBox/FluidComboBox.Skeleton.js +26 -28
  119. package/es/components/FluidComboBox/FluidComboBox.js +54 -105
  120. package/es/components/FluidDatePicker/FluidDatePicker.Skeleton.js +56 -53
  121. package/es/components/FluidDatePicker/FluidDatePicker.js +46 -68
  122. package/es/components/FluidDatePickerInput/FluidDatePickerInput.js +23 -16
  123. package/es/components/FluidDropdown/FluidDropdown.Skeleton.js +26 -28
  124. package/es/components/FluidDropdown/FluidDropdown.js +55 -111
  125. package/es/components/FluidForm/FluidForm.js +29 -31
  126. package/es/components/FluidForm/FormContext.js +12 -6
  127. package/es/components/FluidMultiSelect/FluidMultiSelect.Skeleton.js +26 -28
  128. package/es/components/FluidMultiSelect/FluidMultiSelect.js +67 -197
  129. package/es/components/FluidNumberInput/FluidNumberInput.Skeleton.js +27 -30
  130. package/es/components/FluidNumberInput/FluidNumberInput.js +63 -147
  131. package/es/components/FluidSearch/FluidSearch.Skeleton.js +27 -30
  132. package/es/components/FluidSearch/FluidSearch.js +41 -84
  133. package/es/components/FluidSelect/FluidSelect.Skeleton.js +26 -28
  134. package/es/components/FluidSelect/FluidSelect.js +40 -76
  135. package/es/components/FluidSelect/index.js +13 -5
  136. package/es/components/FluidTextArea/FluidTextArea.Skeleton.js +27 -30
  137. package/es/components/FluidTextArea/FluidTextArea.js +48 -112
  138. package/es/components/FluidTextInput/FluidPasswordInput.js +44 -99
  139. package/es/components/FluidTextInput/FluidTextInput.Skeleton.js +27 -30
  140. package/es/components/FluidTextInput/FluidTextInput.js +49 -104
  141. package/es/components/FluidTextInput/index.js +14 -6
  142. package/es/components/FluidTimePicker/FluidTimePicker.Skeleton.js +30 -33
  143. package/es/components/FluidTimePicker/FluidTimePicker.js +68 -115
  144. package/es/components/FluidTimePickerSelect/FluidTimePickerSelect.js +28 -47
  145. package/es/components/Form/Form.js +23 -25
  146. package/es/components/FormGroup/FormGroup.js +45 -67
  147. package/es/components/FormItem/FormItem.js +23 -25
  148. package/es/components/FormLabel/FormLabel.js +28 -34
  149. package/es/components/Grid/CSSGrid.d.ts +1 -1
  150. package/es/components/Grid/CSSGrid.js +85 -127
  151. package/es/components/Grid/Column.js +192 -324
  152. package/es/components/Grid/ColumnHang.js +28 -36
  153. package/es/components/Grid/FlexGrid.js +40 -60
  154. package/es/components/Grid/Grid.js +29 -42
  155. package/es/components/Grid/GridContext.js +36 -42
  156. package/es/components/Grid/Row.js +31 -49
  157. package/es/components/Heading/index.js +36 -51
  158. package/es/components/Icon/Icon.Skeleton.js +21 -21
  159. package/es/components/IconButton/index.js +117 -178
  160. package/es/components/IconIndicator/index.d.ts +1 -1
  161. package/es/components/IconIndicator/index.js +59 -60
  162. package/es/components/IdPrefix/index.js +21 -17
  163. package/es/components/InlineCheckbox/InlineCheckbox.js +69 -113
  164. package/es/components/InlineCheckbox/index.js +12 -4
  165. package/es/components/InlineLoading/InlineLoading.js +83 -100
  166. package/es/components/InlineLoading/index.js +12 -4
  167. package/es/components/Layer/LayerContext.js +12 -4
  168. package/es/components/Layer/LayerLevel.js +20 -4
  169. package/es/components/Layer/index.js +54 -66
  170. package/es/components/Layout/index.js +77 -109
  171. package/es/components/LayoutDirection/LayoutDirection.d.ts +1 -1
  172. package/es/components/LayoutDirection/LayoutDirection.js +33 -37
  173. package/es/components/LayoutDirection/LayoutDirectionContext.js +12 -6
  174. package/es/components/LayoutDirection/useLayoutDirection.js +15 -7
  175. package/es/components/Link/Link.js +63 -108
  176. package/es/components/Link/index.js +12 -4
  177. package/es/components/ListBox/ListBox.js +78 -126
  178. package/es/components/ListBox/ListBoxField.js +24 -43
  179. package/es/components/ListBox/ListBoxMenu.js +36 -42
  180. package/es/components/ListBox/ListBoxMenuIcon.js +39 -40
  181. package/es/components/ListBox/ListBoxMenuItem.js +67 -88
  182. package/es/components/ListBox/ListBoxPropTypes.js +17 -5
  183. package/es/components/ListBox/ListBoxSelection.js +71 -96
  184. package/es/components/ListBox/index.js +16 -14
  185. package/es/components/ListBox/next/ListBoxSelection.js +79 -117
  186. package/es/components/ListBox/next/ListBoxTrigger.js +44 -48
  187. package/es/components/ListItem/ListItem.js +25 -28
  188. package/es/components/Loading/Loading.js +64 -73
  189. package/es/components/Loading/index.js +12 -4
  190. package/es/components/Menu/Menu.js +220 -363
  191. package/es/components/Menu/MenuContext.d.ts +1 -1
  192. package/es/components/Menu/MenuContext.js +41 -38
  193. package/es/components/Menu/MenuItem.js +282 -413
  194. package/es/components/MenuButton/index.js +134 -195
  195. package/es/components/Modal/Modal.js +500 -660
  196. package/es/components/Modal/ModalPresence.js +39 -37
  197. package/es/components/Modal/index.js +13 -5
  198. package/es/components/ModalWrapper/ModalWrapper.d.ts +2 -2
  199. package/es/components/ModalWrapper/ModalWrapper.js +106 -130
  200. package/es/components/MultiSelect/FilterableMultiSelect.js +605 -918
  201. package/es/components/MultiSelect/MultiSelect.js +454 -716
  202. package/es/components/MultiSelect/MultiSelectPropTypes.js +13 -30
  203. package/es/components/MultiSelect/filter.js +14 -9
  204. package/es/components/MultiSelect/tools/sorting.js +21 -34
  205. package/es/components/Notification/Notification.js +508 -785
  206. package/es/components/NumberInput/NumberFormatPropTypes.js +69 -30
  207. package/es/components/NumberInput/NumberInput.Skeleton.js +29 -33
  208. package/es/components/NumberInput/NumberInput.js +567 -947
  209. package/es/components/OrderedList/OrderedList.js +31 -44
  210. package/es/components/OverflowMenu/OverflowMenu.js +335 -450
  211. package/es/components/OverflowMenu/index.js +25 -16
  212. package/es/components/OverflowMenu/next/index.js +154 -186
  213. package/es/components/OverflowMenuItem/OverflowMenuItem.js +100 -160
  214. package/es/components/OverflowMenuItem/index.js +12 -4
  215. package/es/components/OverflowMenuV2/index.js +15 -13
  216. package/es/components/PageHeader/PageHeader.js +297 -442
  217. package/es/components/PageHeader/index.js +24 -2
  218. package/es/components/Pagination/Pagination.Skeleton.js +34 -35
  219. package/es/components/Pagination/Pagination.d.ts +1 -1
  220. package/es/components/Pagination/Pagination.js +251 -356
  221. package/es/components/Pagination/experimental/PageSelector.js +38 -54
  222. package/es/components/Pagination/experimental/Pagination-story.d.ts +114 -0
  223. package/es/components/Pagination/experimental/Pagination.js +144 -196
  224. package/es/components/PaginationNav/PaginationNav.js +320 -426
  225. package/es/components/Popover/index.js +318 -437
  226. package/es/components/PrimaryButton/PrimaryButton.js +11 -9
  227. package/es/components/ProgressBar/ProgressBar.js +117 -143
  228. package/es/components/ProgressIndicator/ProgressIndicator.Skeleton.js +42 -38
  229. package/es/components/ProgressIndicator/ProgressIndicator.js +146 -243
  230. package/es/components/RadioButton/RadioButton.Skeleton.js +23 -25
  231. package/es/components/RadioButton/RadioButton.js +101 -174
  232. package/es/components/RadioButton/index.js +12 -4
  233. package/es/components/RadioButtonGroup/RadioButtonGroup.js +135 -207
  234. package/es/components/RadioTile/RadioTile.js +104 -168
  235. package/es/components/RadioTile/index.js +12 -4
  236. package/es/components/Search/Search.Skeleton.js +28 -33
  237. package/es/components/Search/Search.js +182 -278
  238. package/es/components/Search/index.js +13 -5
  239. package/es/components/Search/utils.js +11 -3
  240. package/es/components/SecondaryButton/SecondaryButton.js +11 -9
  241. package/es/components/Select/Select.Skeleton.js +27 -30
  242. package/es/components/Select/Select.js +178 -257
  243. package/es/components/Select/index.js +13 -5
  244. package/es/components/SelectItem/SelectItem.js +33 -48
  245. package/es/components/SelectItem/index.js +12 -4
  246. package/es/components/SelectItemGroup/SelectItemGroup.js +27 -37
  247. package/es/components/ShapeIndicator/index.d.ts +1 -1
  248. package/es/components/ShapeIndicator/index.js +74 -80
  249. package/es/components/SkeletonIcon/SkeletonIcon.js +21 -24
  250. package/es/components/SkeletonPlaceholder/SkeletonPlaceholder.js +15 -24
  251. package/es/components/SkeletonText/SkeletonText.js +67 -81
  252. package/es/components/SkeletonText/index.js +12 -4
  253. package/es/components/Slider/Slider.Skeleton.js +68 -91
  254. package/es/components/Slider/Slider.js +864 -1315
  255. package/es/components/Slider/SliderHandles.js +73 -66
  256. package/es/components/Stack/HStack.js +19 -11
  257. package/es/components/Stack/Stack.js +56 -80
  258. package/es/components/Stack/VStack.js +19 -11
  259. package/es/components/StructuredList/StructuredList.Skeleton.js +55 -48
  260. package/es/components/StructuredList/StructuredList.js +178 -317
  261. package/es/components/Switch/IconSwitch.js +99 -145
  262. package/es/components/Switch/Switch.js +66 -99
  263. package/es/components/TabContent/TabContent.js +28 -34
  264. package/es/components/Tabs/Tabs.Skeleton.js +41 -36
  265. package/es/components/Tabs/Tabs.js +732 -1147
  266. package/es/components/Tabs/usePressable.js +97 -112
  267. package/es/components/Tag/DismissibleTag.js +119 -156
  268. package/es/components/Tag/OperationalTag.js +91 -111
  269. package/es/components/Tag/SelectableTag.js +94 -129
  270. package/es/components/Tag/Tag.Skeleton.js +26 -30
  271. package/es/components/Tag/Tag.js +152 -200
  272. package/es/components/Tag/isEllipsisActive.js +13 -8
  273. package/es/components/Text/Text.js +66 -79
  274. package/es/components/Text/TextDirection.js +36 -37
  275. package/es/components/Text/TextDirectionContext.js +14 -8
  276. package/es/components/Text/createTextComponent.js +21 -20
  277. package/es/components/TextArea/TextArea.Skeleton.js +25 -29
  278. package/es/components/TextArea/TextArea.js +315 -422
  279. package/es/components/TextArea/index.js +13 -5
  280. package/es/components/TextInput/ControlledPasswordInput.js +133 -198
  281. package/es/components/TextInput/PasswordInput.js +196 -303
  282. package/es/components/TextInput/TextInput.Skeleton.js +24 -28
  283. package/es/components/TextInput/TextInput.js +219 -317
  284. package/es/components/TextInput/index.js +13 -5
  285. package/es/components/TextInput/util.js +21 -25
  286. package/es/components/Theme/index.js +79 -95
  287. package/es/components/Tile/Tile.d.ts +2 -2
  288. package/es/components/Tile/Tile.js +394 -588
  289. package/es/components/TileGroup/TileGroup.js +70 -111
  290. package/es/components/TimePicker/TimePicker.d.ts +1 -1
  291. package/es/components/TimePicker/TimePicker.js +148 -247
  292. package/es/components/TimePickerSelect/TimePickerSelect.js +43 -58
  293. package/es/components/Toggle/Toggle.Skeleton.js +24 -22
  294. package/es/components/Toggle/Toggle.js +102 -171
  295. package/es/components/ToggleSmall/ToggleSmall.Skeleton.js +46 -51
  296. package/es/components/Toggletip/index.d.ts +2 -2
  297. package/es/components/Toggletip/index.js +170 -256
  298. package/es/components/Tooltip/DefinitionTooltip.js +98 -138
  299. package/es/components/Tooltip/Tooltip.js +188 -263
  300. package/es/components/TreeView/TreeContext.js +13 -5
  301. package/es/components/TreeView/TreeNode.js +361 -500
  302. package/es/components/TreeView/TreeView.js +164 -237
  303. package/es/components/UIShell/Content.js +23 -30
  304. package/es/components/UIShell/Header.js +25 -29
  305. package/es/components/UIShell/HeaderContainer.js +31 -40
  306. package/es/components/UIShell/HeaderGlobalAction.js +65 -90
  307. package/es/components/UIShell/HeaderGlobalBar.js +16 -9
  308. package/es/components/UIShell/HeaderMenu.js +141 -215
  309. package/es/components/UIShell/HeaderMenuButton.js +43 -66
  310. package/es/components/UIShell/HeaderMenuItem.js +49 -76
  311. package/es/components/UIShell/HeaderName.js +32 -44
  312. package/es/components/UIShell/HeaderNavigation.js +32 -37
  313. package/es/components/UIShell/HeaderPanel.js +74 -97
  314. package/es/components/UIShell/HeaderSideNavItems.js +27 -33
  315. package/es/components/UIShell/Link.js +29 -50
  316. package/es/components/UIShell/SideNav.js +132 -241
  317. package/es/components/UIShell/SideNavContext.js +21 -15
  318. package/es/components/UIShell/SideNavDetails.js +29 -34
  319. package/es/components/UIShell/SideNavDivider.js +21 -21
  320. package/es/components/UIShell/SideNavFooter.js +43 -52
  321. package/es/components/UIShell/SideNavHeader.js +26 -35
  322. package/es/components/UIShell/SideNavIcon.js +28 -33
  323. package/es/components/UIShell/SideNavItem.js +28 -33
  324. package/es/components/UIShell/SideNavItems.js +31 -40
  325. package/es/components/UIShell/SideNavLink.js +52 -79
  326. package/es/components/UIShell/SideNavLinkText.js +24 -25
  327. package/es/components/UIShell/SideNavMenu.js +102 -143
  328. package/es/components/UIShell/SideNavMenuItem.js +40 -52
  329. package/es/components/UIShell/SideNavSwitcher.js +59 -68
  330. package/es/components/UIShell/SkipToContent.js +28 -36
  331. package/es/components/UIShell/Switcher.js +69 -99
  332. package/es/components/UIShell/SwitcherDivider.js +16 -24
  333. package/es/components/UIShell/SwitcherItem.js +74 -114
  334. package/es/components/UnorderedList/UnorderedList.js +28 -37
  335. package/es/feature-flags.js +19 -10
  336. package/es/index.js +249 -242
  337. package/es/internal/FloatingMenu.js +246 -292
  338. package/es/internal/OptimizedResize.js +35 -46
  339. package/es/internal/Selection.js +99 -132
  340. package/es/internal/clamp.js +12 -4
  341. package/es/internal/defaultItemToString.js +15 -9
  342. package/es/internal/deprecateFieldOnObject.js +22 -14
  343. package/es/internal/environment.js +15 -7
  344. package/es/internal/getAnnouncement.js +16 -13
  345. package/es/internal/keyboard/keys.js +48 -48
  346. package/es/internal/keyboard/match.js +25 -42
  347. package/es/internal/keyboard/navigation.js +22 -27
  348. package/es/internal/noopFn.js +10 -2
  349. package/es/internal/useAttachedMenu.js +43 -51
  350. package/es/internal/useControllableState.js +43 -48
  351. package/es/internal/useDelayedState.js +30 -35
  352. package/es/internal/useEvent.js +39 -35
  353. package/es/internal/useId.js +51 -87
  354. package/es/internal/useIdPrefix.js +13 -5
  355. package/es/internal/useIsomorphicEffect.js +12 -4
  356. package/es/internal/useMatchMedia.js +29 -21
  357. package/es/internal/useMergedRefs.js +26 -22
  358. package/es/internal/useNoInteractiveChildren.js +70 -99
  359. package/es/internal/useNormalizedInputProps.js +47 -51
  360. package/es/internal/useOutsideClick.js +21 -24
  361. package/es/internal/useOverflowItems.js +89 -90
  362. package/es/internal/usePrefix.js +13 -5
  363. package/es/internal/usePresence.js +51 -54
  364. package/es/internal/usePresenceContext.js +35 -35
  365. package/es/internal/usePreviousValue.js +26 -18
  366. package/es/internal/useResizeObserver.js +57 -66
  367. package/es/internal/useSavedCallback.js +24 -17
  368. package/es/internal/utils.js +17 -9
  369. package/es/internal/warning.js +17 -22
  370. package/es/internal/wrapFocus.js +77 -98
  371. package/es/prop-types/AriaPropTypes.js +14 -6
  372. package/es/prop-types/deprecate.js +30 -27
  373. package/es/prop-types/deprecateComponent.js +17 -8
  374. package/es/prop-types/deprecateValuesWithin.js +18 -21
  375. package/es/prop-types/isRequiredOneOf.js +21 -24
  376. package/es/prop-types/requiredIfGivenPropIsTruthy.js +14 -14
  377. package/es/tools/events.js +17 -21
  378. package/es/tools/mapPopoverAlign.js +19 -18
  379. package/es/tools/mergeRefs.js +14 -17
  380. package/es/tools/setupGetInstanceId.js +16 -8
  381. package/es/tools/toggleClass.js +17 -9
  382. package/es/tools/wrapComponent.js +34 -39
  383. package/icons/index.d.ts +2 -1
  384. package/icons/index.esm.js +2 -2
  385. package/icons/index.js +7 -10
  386. package/lib/_virtual/_rolldown/runtime.js +50 -0
  387. package/lib/components/AILabel/index.d.ts +29 -2
  388. package/lib/components/AILabel/index.js +118 -171
  389. package/lib/components/AISkeleton/AISkeletonIcon.js +27 -31
  390. package/lib/components/AISkeleton/AISkeletonPlaceholder.js +29 -31
  391. package/lib/components/AISkeleton/AISkeletonText.js +30 -43
  392. package/lib/components/Accordion/Accordion.Skeleton.js +59 -84
  393. package/lib/components/Accordion/Accordion.js +47 -65
  394. package/lib/components/Accordion/AccordionItem.js +106 -160
  395. package/lib/components/Accordion/AccordionProvider.js +20 -17
  396. package/lib/components/AspectRatio/AspectRatio.js +45 -51
  397. package/lib/components/BadgeIndicator/index.js +33 -39
  398. package/lib/components/Breadcrumb/Breadcrumb.Skeleton.js +43 -55
  399. package/lib/components/Breadcrumb/Breadcrumb.js +43 -55
  400. package/lib/components/Breadcrumb/BreadcrumbItem.js +84 -87
  401. package/lib/components/Button/Button.Skeleton.js +53 -63
  402. package/lib/components/Button/Button.d.ts +1 -1
  403. package/lib/components/Button/Button.js +149 -244
  404. package/lib/components/Button/ButtonBase.js +85 -108
  405. package/lib/components/Button/index.js +13 -15
  406. package/lib/components/ButtonSet/ButtonSet.js +78 -102
  407. package/lib/components/ButtonSet/index.js +12 -9
  408. package/lib/components/ChatButton/ChatButton.Skeleton.js +31 -31
  409. package/lib/components/ChatButton/ChatButton.js +68 -83
  410. package/lib/components/Checkbox/Checkbox.Skeleton.js +30 -30
  411. package/lib/components/Checkbox/Checkbox.js +119 -198
  412. package/lib/components/Checkbox/index.js +13 -11
  413. package/lib/components/CheckboxGroup/CheckboxGroup.js +104 -152
  414. package/lib/components/ClassPrefix/index.js +24 -19
  415. package/lib/components/CodeSnippet/CodeSnippet.Skeleton.js +49 -47
  416. package/lib/components/CodeSnippet/CodeSnippet.js +215 -303
  417. package/lib/components/ComboBox/ComboBox.js +626 -974
  418. package/lib/components/ComboBox/index.js +12 -9
  419. package/lib/components/ComboButton/index.js +176 -210
  420. package/lib/components/ComposedModal/ComposedModal.js +315 -454
  421. package/lib/components/ComposedModal/ComposedModalPresence.js +49 -44
  422. package/lib/components/ComposedModal/ModalFooter.js +131 -209
  423. package/lib/components/ComposedModal/ModalHeader.js +75 -103
  424. package/lib/components/ComposedModal/useComposedModalState.js +22 -17
  425. package/lib/components/ContainedList/ContainedList.js +77 -106
  426. package/lib/components/ContainedList/ContainedListItem/ContainedListItem.js +59 -71
  427. package/lib/components/ContainedList/ContainedListItem/index.js +12 -9
  428. package/lib/components/ContainedList/index.js +18 -15
  429. package/lib/components/ContentSwitcher/ContentSwitcher.js +112 -142
  430. package/lib/components/ContextMenu/useContextMenu.js +42 -40
  431. package/lib/components/Copy/Copy.js +101 -121
  432. package/lib/components/Copy/index.js +12 -9
  433. package/lib/components/CopyButton/CopyButton.js +85 -98
  434. package/lib/components/CopyButton/index.js +12 -9
  435. package/lib/components/DangerButton/DangerButton.js +19 -13
  436. package/lib/components/DataTable/DataTable.d.ts +11 -11
  437. package/lib/components/DataTable/DataTable.js +474 -655
  438. package/lib/components/DataTable/Table.js +115 -161
  439. package/lib/components/DataTable/TableActionList.js +15 -11
  440. package/lib/components/DataTable/TableBatchAction.js +28 -38
  441. package/lib/components/DataTable/TableBatchActions.js +82 -117
  442. package/lib/components/DataTable/TableBody.js +29 -23
  443. package/lib/components/DataTable/TableCell.js +35 -50
  444. package/lib/components/DataTable/TableContainer.js +79 -86
  445. package/lib/components/DataTable/TableContext.js +15 -8
  446. package/lib/components/DataTable/TableDecoratorRow.js +34 -40
  447. package/lib/components/DataTable/TableExpandHeader.js +57 -94
  448. package/lib/components/DataTable/TableExpandRow.js +86 -123
  449. package/lib/components/DataTable/TableExpandedRow.js +49 -55
  450. package/lib/components/DataTable/TableHead.js +8 -10
  451. package/lib/components/DataTable/TableHeader.js +142 -185
  452. package/lib/components/DataTable/TableRow.d.ts +1 -1
  453. package/lib/components/DataTable/TableRow.js +46 -80
  454. package/lib/components/DataTable/TableSelectAll.js +46 -74
  455. package/lib/components/DataTable/TableSelectRow.js +67 -102
  456. package/lib/components/DataTable/TableSlugRow.js +39 -47
  457. package/lib/components/DataTable/TableToolbar.js +37 -49
  458. package/lib/components/DataTable/TableToolbarAction.js +28 -24
  459. package/lib/components/DataTable/TableToolbarContent.js +15 -11
  460. package/lib/components/DataTable/TableToolbarMenu.js +39 -50
  461. package/lib/components/DataTable/TableToolbarSearch.js +101 -191
  462. package/lib/components/DataTable/state/getDerivedStateFromProps.js +38 -47
  463. package/lib/components/DataTable/state/sortStates.js +11 -10
  464. package/lib/components/DataTable/state/sorting.js +54 -76
  465. package/lib/components/DataTable/tools/cells.js +15 -8
  466. package/lib/components/DataTable/tools/denormalize.js +27 -22
  467. package/lib/components/DataTable/tools/filter.js +21 -23
  468. package/lib/components/DataTable/tools/normalize.js +57 -76
  469. package/lib/components/DataTable/tools/sorting.js +50 -75
  470. package/lib/components/DataTableSkeleton/DataTableSkeleton.js +70 -98
  471. package/lib/components/DatePicker/DatePicker.Skeleton.js +48 -56
  472. package/lib/components/DatePicker/DatePicker.d.ts +4 -2
  473. package/lib/components/DatePicker/DatePicker.js +491 -753
  474. package/lib/components/DatePicker/DatePickerLocales.js +75 -127
  475. package/lib/components/DatePicker/index.js +13 -11
  476. package/lib/components/DatePicker/plugins/appendToPlugin.js +31 -46
  477. package/lib/components/DatePicker/plugins/fixEventsPlugin.js +127 -175
  478. package/lib/components/DatePicker/plugins/rangePlugin.d.ts +1 -1
  479. package/lib/components/DatePicker/plugins/rangePlugin.js +42 -49
  480. package/lib/components/DatePicker/utils.d.ts +7 -0
  481. package/lib/components/DatePicker/utils.js +19 -0
  482. package/lib/components/DatePickerInput/DatePickerInput.js +183 -293
  483. package/lib/components/DatePickerInput/index.js +12 -9
  484. package/lib/components/Dialog/Dialog.js +307 -576
  485. package/lib/components/Dialog/index.js +21 -13
  486. package/lib/components/Dropdown/Dropdown.Skeleton.js +30 -43
  487. package/lib/components/Dropdown/Dropdown.js +348 -539
  488. package/lib/components/Dropdown/index.js +13 -11
  489. package/lib/components/ErrorBoundary/ErrorBoundary.js +39 -62
  490. package/lib/components/ErrorBoundary/ErrorBoundaryContext.js +15 -11
  491. package/lib/components/ExpandableSearch/ExpandableSearch.js +63 -73
  492. package/lib/components/ExpandableSearch/index.js +12 -9
  493. package/lib/components/FeatureFlags/index.d.ts +11 -2
  494. package/lib/components/FeatureFlags/index.js +82 -79
  495. package/lib/components/FileUploader/FileUploader.Skeleton.js +39 -35
  496. package/lib/components/FileUploader/FileUploader.js +273 -347
  497. package/lib/components/FileUploader/FileUploaderButton.js +114 -164
  498. package/lib/components/FileUploader/FileUploaderDropContainer.js +148 -225
  499. package/lib/components/FileUploader/FileUploaderItem.js +142 -161
  500. package/lib/components/FileUploader/Filename.d.ts +1 -1
  501. package/lib/components/FileUploader/Filename.js +56 -76
  502. package/lib/components/FluidComboBox/FluidComboBox.Skeleton.js +30 -32
  503. package/lib/components/FluidComboBox/FluidComboBox.js +58 -109
  504. package/lib/components/FluidDatePicker/FluidDatePicker.Skeleton.js +60 -57
  505. package/lib/components/FluidDatePicker/FluidDatePicker.js +50 -72
  506. package/lib/components/FluidDatePickerInput/FluidDatePickerInput.js +25 -20
  507. package/lib/components/FluidDropdown/FluidDropdown.Skeleton.js +30 -32
  508. package/lib/components/FluidDropdown/FluidDropdown.js +59 -115
  509. package/lib/components/FluidForm/FluidForm.js +33 -35
  510. package/lib/components/FluidForm/FormContext.js +13 -8
  511. package/lib/components/FluidMultiSelect/FluidMultiSelect.Skeleton.js +30 -32
  512. package/lib/components/FluidMultiSelect/FluidMultiSelect.js +71 -201
  513. package/lib/components/FluidNumberInput/FluidNumberInput.Skeleton.js +31 -34
  514. package/lib/components/FluidNumberInput/FluidNumberInput.js +67 -151
  515. package/lib/components/FluidSearch/FluidSearch.Skeleton.js +31 -34
  516. package/lib/components/FluidSearch/FluidSearch.js +45 -88
  517. package/lib/components/FluidSelect/FluidSelect.Skeleton.js +30 -32
  518. package/lib/components/FluidSelect/FluidSelect.js +44 -80
  519. package/lib/components/FluidSelect/index.js +13 -11
  520. package/lib/components/FluidTextArea/FluidTextArea.Skeleton.js +31 -34
  521. package/lib/components/FluidTextArea/FluidTextArea.js +52 -116
  522. package/lib/components/FluidTextInput/FluidPasswordInput.js +48 -103
  523. package/lib/components/FluidTextInput/FluidTextInput.Skeleton.js +31 -34
  524. package/lib/components/FluidTextInput/FluidTextInput.js +53 -108
  525. package/lib/components/FluidTextInput/index.js +14 -13
  526. package/lib/components/FluidTimePicker/FluidTimePicker.Skeleton.js +34 -37
  527. package/lib/components/FluidTimePicker/FluidTimePicker.js +72 -119
  528. package/lib/components/FluidTimePickerSelect/FluidTimePickerSelect.js +31 -51
  529. package/lib/components/Form/Form.js +27 -29
  530. package/lib/components/FormGroup/FormGroup.js +49 -71
  531. package/lib/components/FormItem/FormItem.js +27 -29
  532. package/lib/components/FormLabel/FormLabel.js +32 -38
  533. package/lib/components/Grid/CSSGrid.d.ts +1 -1
  534. package/lib/components/Grid/CSSGrid.js +89 -129
  535. package/lib/components/Grid/Column.js +196 -328
  536. package/lib/components/Grid/ColumnHang.js +32 -38
  537. package/lib/components/Grid/FlexGrid.js +44 -62
  538. package/lib/components/Grid/Grid.js +32 -44
  539. package/lib/components/Grid/GridContext.js +39 -44
  540. package/lib/components/Grid/Row.js +35 -53
  541. package/lib/components/Heading/index.js +39 -53
  542. package/lib/components/Icon/Icon.Skeleton.js +25 -23
  543. package/lib/components/IconButton/index.js +121 -180
  544. package/lib/components/IconIndicator/index.d.ts +1 -1
  545. package/lib/components/IconIndicator/index.js +63 -63
  546. package/lib/components/IdPrefix/index.js +24 -19
  547. package/lib/components/InlineCheckbox/InlineCheckbox.js +72 -117
  548. package/lib/components/InlineCheckbox/index.js +12 -9
  549. package/lib/components/InlineLoading/InlineLoading.js +87 -104
  550. package/lib/components/InlineLoading/index.js +12 -9
  551. package/lib/components/Layer/LayerContext.js +14 -6
  552. package/lib/components/Layer/LayerLevel.js +20 -6
  553. package/lib/components/Layer/index.js +58 -68
  554. package/lib/components/Layout/index.js +81 -111
  555. package/lib/components/LayoutDirection/LayoutDirection.d.ts +1 -1
  556. package/lib/components/LayoutDirection/LayoutDirection.js +36 -40
  557. package/lib/components/LayoutDirection/LayoutDirectionContext.js +14 -8
  558. package/lib/components/LayoutDirection/useLayoutDirection.js +16 -9
  559. package/lib/components/Link/Link.js +67 -112
  560. package/lib/components/Link/index.js +12 -9
  561. package/lib/components/ListBox/ListBox.js +82 -130
  562. package/lib/components/ListBox/ListBoxField.js +33 -47
  563. package/lib/components/ListBox/ListBoxMenu.js +39 -46
  564. package/lib/components/ListBox/ListBoxMenuIcon.js +43 -44
  565. package/lib/components/ListBox/ListBoxMenuItem.js +71 -92
  566. package/lib/components/ListBox/ListBoxPropTypes.js +21 -9
  567. package/lib/components/ListBox/ListBoxSelection.js +75 -100
  568. package/lib/components/ListBox/index.js +17 -21
  569. package/lib/components/ListBox/next/ListBoxSelection.js +83 -121
  570. package/lib/components/ListBox/next/ListBoxTrigger.js +48 -52
  571. package/lib/components/ListItem/ListItem.js +29 -32
  572. package/lib/components/Loading/Loading.js +68 -77
  573. package/lib/components/Loading/index.js +12 -9
  574. package/lib/components/Menu/Menu.js +224 -365
  575. package/lib/components/Menu/MenuContext.d.ts +1 -1
  576. package/lib/components/Menu/MenuContext.js +42 -40
  577. package/lib/components/Menu/MenuItem.js +286 -415
  578. package/lib/components/MenuButton/index.js +138 -197
  579. package/lib/components/Modal/Modal.js +504 -665
  580. package/lib/components/Modal/ModalPresence.js +41 -39
  581. package/lib/components/Modal/index.js +13 -10
  582. package/lib/components/ModalWrapper/ModalWrapper.d.ts +2 -2
  583. package/lib/components/ModalWrapper/ModalWrapper.js +112 -134
  584. package/lib/components/MultiSelect/FilterableMultiSelect.js +611 -920
  585. package/lib/components/MultiSelect/MultiSelect.js +459 -718
  586. package/lib/components/MultiSelect/MultiSelectPropTypes.js +15 -32
  587. package/lib/components/MultiSelect/filter.js +14 -10
  588. package/lib/components/MultiSelect/tools/sorting.js +21 -35
  589. package/lib/components/Notification/Notification.js +514 -787
  590. package/lib/components/NumberInput/NumberFormatPropTypes.js +72 -33
  591. package/lib/components/NumberInput/NumberInput.Skeleton.js +33 -37
  592. package/lib/components/NumberInput/NumberInput.js +571 -950
  593. package/lib/components/OrderedList/OrderedList.js +35 -48
  594. package/lib/components/OverflowMenu/OverflowMenu.js +341 -454
  595. package/lib/components/OverflowMenu/index.js +27 -21
  596. package/lib/components/OverflowMenu/next/index.js +158 -188
  597. package/lib/components/OverflowMenuItem/OverflowMenuItem.js +104 -164
  598. package/lib/components/OverflowMenuItem/index.js +12 -9
  599. package/lib/components/OverflowMenuV2/index.js +25 -15
  600. package/lib/components/PageHeader/PageHeader.js +301 -444
  601. package/lib/components/PageHeader/index.js +27 -19
  602. package/lib/components/Pagination/Pagination.Skeleton.js +38 -37
  603. package/lib/components/Pagination/Pagination.d.ts +1 -1
  604. package/lib/components/Pagination/Pagination.js +256 -360
  605. package/lib/components/Pagination/experimental/PageSelector.js +48 -58
  606. package/lib/components/Pagination/experimental/Pagination-story.d.ts +114 -0
  607. package/lib/components/Pagination/experimental/Pagination.js +148 -200
  608. package/lib/components/PaginationNav/PaginationNav.js +324 -430
  609. package/lib/components/Popover/index.js +323 -440
  610. package/lib/components/PrimaryButton/PrimaryButton.js +19 -13
  611. package/lib/components/ProgressBar/ProgressBar.js +121 -147
  612. package/lib/components/ProgressIndicator/ProgressIndicator.Skeleton.js +46 -43
  613. package/lib/components/ProgressIndicator/ProgressIndicator.js +150 -245
  614. package/lib/components/RadioButton/RadioButton.Skeleton.js +27 -27
  615. package/lib/components/RadioButton/RadioButton.js +105 -178
  616. package/lib/components/RadioButton/index.js +12 -9
  617. package/lib/components/RadioButtonGroup/RadioButtonGroup.js +139 -211
  618. package/lib/components/RadioTile/RadioTile.js +108 -172
  619. package/lib/components/RadioTile/index.js +12 -9
  620. package/lib/components/Search/Search.Skeleton.js +32 -38
  621. package/lib/components/Search/Search.js +185 -281
  622. package/lib/components/Search/index.js +13 -11
  623. package/lib/components/Search/utils.js +11 -4
  624. package/lib/components/SecondaryButton/SecondaryButton.js +19 -13
  625. package/lib/components/Select/Select.Skeleton.js +31 -35
  626. package/lib/components/Select/Select.js +182 -261
  627. package/lib/components/Select/index.js +13 -11
  628. package/lib/components/SelectItem/SelectItem.js +37 -52
  629. package/lib/components/SelectItem/index.js +12 -9
  630. package/lib/components/SelectItemGroup/SelectItemGroup.js +31 -41
  631. package/lib/components/ShapeIndicator/index.d.ts +1 -1
  632. package/lib/components/ShapeIndicator/index.js +78 -83
  633. package/lib/components/SkeletonIcon/SkeletonIcon.js +25 -28
  634. package/lib/components/SkeletonPlaceholder/SkeletonPlaceholder.js +25 -28
  635. package/lib/components/SkeletonText/SkeletonText.js +71 -85
  636. package/lib/components/SkeletonText/index.js +12 -9
  637. package/lib/components/Slider/Slider.Skeleton.js +72 -95
  638. package/lib/components/Slider/Slider.js +868 -1319
  639. package/lib/components/Slider/SliderHandles.js +75 -68
  640. package/lib/components/Stack/HStack.js +22 -14
  641. package/lib/components/Stack/Stack.js +60 -82
  642. package/lib/components/Stack/VStack.js +22 -14
  643. package/lib/components/StructuredList/StructuredList.Skeleton.js +59 -52
  644. package/lib/components/StructuredList/StructuredList.js +182 -319
  645. package/lib/components/Switch/IconSwitch.js +103 -149
  646. package/lib/components/Switch/Switch.js +70 -103
  647. package/lib/components/TabContent/TabContent.js +32 -38
  648. package/lib/components/Tabs/Tabs.Skeleton.js +45 -41
  649. package/lib/components/Tabs/Tabs.js +738 -1151
  650. package/lib/components/Tabs/usePressable.js +98 -114
  651. package/lib/components/Tag/DismissibleTag.js +123 -160
  652. package/lib/components/Tag/OperationalTag.js +95 -115
  653. package/lib/components/Tag/SelectableTag.js +98 -133
  654. package/lib/components/Tag/Tag.Skeleton.js +30 -32
  655. package/lib/components/Tag/Tag.js +156 -204
  656. package/lib/components/Tag/isEllipsisActive.js +13 -9
  657. package/lib/components/Text/Text.js +69 -81
  658. package/lib/components/Text/TextDirection.js +39 -39
  659. package/lib/components/Text/TextDirectionContext.js +15 -10
  660. package/lib/components/Text/createTextComponent.js +29 -22
  661. package/lib/components/TextArea/TextArea.Skeleton.js +29 -34
  662. package/lib/components/TextArea/TextArea.js +319 -426
  663. package/lib/components/TextArea/index.js +13 -11
  664. package/lib/components/TextInput/ControlledPasswordInput.js +137 -202
  665. package/lib/components/TextInput/PasswordInput.js +200 -307
  666. package/lib/components/TextInput/TextInput.Skeleton.js +28 -33
  667. package/lib/components/TextInput/TextInput.js +223 -321
  668. package/lib/components/TextInput/index.js +13 -11
  669. package/lib/components/TextInput/util.js +21 -26
  670. package/lib/components/Theme/index.js +83 -97
  671. package/lib/components/Tile/Tile.d.ts +2 -2
  672. package/lib/components/Tile/Tile.js +398 -590
  673. package/lib/components/TileGroup/TileGroup.js +73 -113
  674. package/lib/components/TimePicker/TimePicker.d.ts +1 -1
  675. package/lib/components/TimePicker/TimePicker.js +152 -251
  676. package/lib/components/TimePickerSelect/TimePickerSelect.js +47 -62
  677. package/lib/components/Toggle/Toggle.Skeleton.js +28 -24
  678. package/lib/components/Toggle/Toggle.js +106 -176
  679. package/lib/components/ToggleSmall/ToggleSmall.Skeleton.js +50 -53
  680. package/lib/components/Toggletip/index.d.ts +2 -2
  681. package/lib/components/Toggletip/index.js +174 -258
  682. package/lib/components/Tooltip/DefinitionTooltip.js +102 -140
  683. package/lib/components/Tooltip/Tooltip.js +192 -265
  684. package/lib/components/TreeView/TreeContext.js +14 -7
  685. package/lib/components/TreeView/TreeNode.js +365 -504
  686. package/lib/components/TreeView/TreeView.js +169 -242
  687. package/lib/components/UIShell/Content.js +27 -34
  688. package/lib/components/UIShell/Header.js +29 -33
  689. package/lib/components/UIShell/HeaderContainer.js +34 -44
  690. package/lib/components/UIShell/HeaderGlobalAction.js +69 -94
  691. package/lib/components/UIShell/HeaderGlobalBar.js +17 -14
  692. package/lib/components/UIShell/HeaderMenu.js +146 -221
  693. package/lib/components/UIShell/HeaderMenuButton.js +47 -70
  694. package/lib/components/UIShell/HeaderMenuItem.js +53 -80
  695. package/lib/components/UIShell/HeaderName.js +36 -48
  696. package/lib/components/UIShell/HeaderNavigation.js +36 -41
  697. package/lib/components/UIShell/HeaderPanel.js +78 -101
  698. package/lib/components/UIShell/HeaderSideNavItems.js +31 -37
  699. package/lib/components/UIShell/Link.js +32 -54
  700. package/lib/components/UIShell/SideNav.js +136 -245
  701. package/lib/components/UIShell/SideNavContext.js +23 -17
  702. package/lib/components/UIShell/SideNavDetails.js +33 -38
  703. package/lib/components/UIShell/SideNavDivider.js +25 -25
  704. package/lib/components/UIShell/SideNavFooter.js +47 -56
  705. package/lib/components/UIShell/SideNavHeader.js +30 -39
  706. package/lib/components/UIShell/SideNavIcon.js +32 -37
  707. package/lib/components/UIShell/SideNavItem.js +32 -37
  708. package/lib/components/UIShell/SideNavItems.js +35 -44
  709. package/lib/components/UIShell/SideNavLink.js +56 -83
  710. package/lib/components/UIShell/SideNavLinkText.js +28 -29
  711. package/lib/components/UIShell/SideNavMenu.js +106 -148
  712. package/lib/components/UIShell/SideNavMenuItem.js +44 -56
  713. package/lib/components/UIShell/SideNavSwitcher.js +63 -72
  714. package/lib/components/UIShell/SkipToContent.js +32 -40
  715. package/lib/components/UIShell/Switcher.js +73 -103
  716. package/lib/components/UIShell/SwitcherDivider.js +26 -28
  717. package/lib/components/UIShell/SwitcherItem.js +78 -118
  718. package/lib/components/UnorderedList/UnorderedList.js +32 -41
  719. package/lib/feature-flags.js +21 -13
  720. package/lib/index.js +622 -602
  721. package/lib/internal/FloatingMenu.js +249 -296
  722. package/lib/internal/OptimizedResize.js +35 -47
  723. package/lib/internal/Selection.js +102 -134
  724. package/lib/internal/clamp.js +12 -5
  725. package/lib/internal/defaultItemToString.js +15 -10
  726. package/lib/internal/deprecateFieldOnObject.js +23 -16
  727. package/lib/internal/environment.js +15 -8
  728. package/lib/internal/getAnnouncement.js +16 -14
  729. package/lib/internal/keyboard/keys.js +48 -49
  730. package/lib/internal/keyboard/match.js +25 -43
  731. package/lib/internal/keyboard/navigation.js +22 -29
  732. package/lib/internal/noopFn.js +10 -3
  733. package/lib/internal/useAttachedMenu.js +44 -53
  734. package/lib/internal/useControllableState.js +44 -50
  735. package/lib/internal/useDelayedState.js +31 -37
  736. package/lib/internal/useEvent.js +40 -37
  737. package/lib/internal/useId.js +54 -91
  738. package/lib/internal/useIdPrefix.js +15 -7
  739. package/lib/internal/useIsomorphicEffect.js +13 -8
  740. package/lib/internal/useMatchMedia.js +30 -23
  741. package/lib/internal/useMergedRefs.js +27 -24
  742. package/lib/internal/useNoInteractiveChildren.js +73 -101
  743. package/lib/internal/useNormalizedInputProps.js +55 -53
  744. package/lib/internal/useOutsideClick.js +22 -26
  745. package/lib/internal/useOverflowItems.js +90 -94
  746. package/lib/internal/usePrefix.js +15 -7
  747. package/lib/internal/usePresence.js +52 -56
  748. package/lib/internal/usePresenceContext.js +36 -37
  749. package/lib/internal/usePreviousValue.js +27 -20
  750. package/lib/internal/useResizeObserver.js +58 -68
  751. package/lib/internal/useSavedCallback.js +25 -19
  752. package/lib/internal/utils.js +18 -11
  753. package/lib/internal/warning.js +24 -23
  754. package/lib/internal/wrapFocus.js +78 -100
  755. package/lib/prop-types/AriaPropTypes.js +17 -9
  756. package/lib/prop-types/deprecate.js +30 -29
  757. package/lib/prop-types/deprecateComponent.js +17 -10
  758. package/lib/prop-types/deprecateValuesWithin.js +18 -23
  759. package/lib/prop-types/isRequiredOneOf.js +21 -25
  760. package/lib/prop-types/requiredIfGivenPropIsTruthy.js +14 -15
  761. package/lib/tools/events.js +17 -22
  762. package/lib/tools/mapPopoverAlign.js +19 -19
  763. package/lib/tools/mergeRefs.js +14 -18
  764. package/lib/tools/setupGetInstanceId.js +16 -9
  765. package/lib/tools/toggleClass.js +17 -10
  766. package/lib/tools/wrapComponent.js +38 -43
  767. package/package.json +10 -16
  768. package/es/_virtual/_rollupPluginBabelHelpers.js +0 -40
  769. package/es/components/DataTable/stories/examples/TableToolbarFilter.d.ts +0 -54
  770. package/es/node_modules/es-toolkit/dist/compat/function/debounce.js +0 -55
  771. package/es/node_modules/es-toolkit/dist/compat/function/throttle.js +0 -23
  772. package/es/node_modules/es-toolkit/dist/function/debounce.js +0 -70
  773. package/lib/_virtual/_rollupPluginBabelHelpers.js +0 -45
  774. package/lib/components/DataTable/stories/examples/TableToolbarFilter.d.ts +0 -54
  775. package/lib/node_modules/es-toolkit/dist/compat/function/debounce.js +0 -57
  776. package/lib/node_modules/es-toolkit/dist/compat/function/throttle.js +0 -25
  777. package/lib/node_modules/es-toolkit/dist/function/debounce.js +0 -72
@@ -1,514 +1,375 @@
1
1
  /**
2
- * Copyright IBM Corp. 2016, 2023
2
+ * Copyright IBM Corp. 2016, 2026
3
3
  *
4
4
  * This source code is licensed under the Apache-2.0 license found in the
5
5
  * LICENSE file in the root directory of this source tree.
6
6
  */
7
7
 
8
- import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
9
- import { CaretDown } from '@carbon/icons-react';
10
- import cx from 'classnames';
11
- import PropTypes from 'prop-types';
12
- import React, { useContext, useRef, useState, useEffect, useCallback } from 'react';
13
- import { ArrowLeft, ArrowRight, Enter, Space } from '../../internal/keyboard/keys.js';
14
- import { matches, match } from '../../internal/keyboard/match.js';
15
- import { deprecate } from '../../prop-types/deprecate.js';
16
- import { useControllableState } from '../../internal/useControllableState.js';
17
- import { usePrefix } from '../../internal/usePrefix.js';
18
- import { useId } from '../../internal/useId.js';
19
- import { useFeatureFlag } from '../FeatureFlags/index.js';
20
- import { IconButton } from '../IconButton/index.js';
21
- import { TreeContext, DepthContext } from './TreeContext.js';
8
+ import { usePrefix } from "../../internal/usePrefix.js";
9
+ import { ArrowLeft, ArrowRight as ArrowRight$1, Enter, Space } from "../../internal/keyboard/keys.js";
10
+ import { match, matches } from "../../internal/keyboard/match.js";
11
+ import { useId } from "../../internal/useId.js";
12
+ import { deprecate } from "../../prop-types/deprecate.js";
13
+ import { useFeatureFlag } from "../FeatureFlags/index.js";
14
+ import { IconButton } from "../IconButton/index.js";
15
+ import { useControllableState } from "../../internal/useControllableState.js";
16
+ import { DepthContext, TreeContext } from "./TreeContext.js";
17
+ import classNames from "classnames";
18
+ import React, { useCallback, useContext, useEffect, useRef, useState } from "react";
19
+ import PropTypes from "prop-types";
20
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
21
+ import { CaretDown } from "@carbon/icons-react";
22
22
 
23
- const extractTextContent = node => {
24
- if (node === null || node === undefined) return '';
25
- if (typeof node === 'string') return node;
26
- if (typeof node === 'number') return String(node);
27
- if (typeof node === 'boolean') return String(node);
28
- if (Array.isArray(node)) {
29
- return node.map(extractTextContent).join('');
30
- }
31
- if (/*#__PURE__*/React.isValidElement(node)) {
32
- const element = node;
33
- const children = element.props.children;
34
- return extractTextContent(children);
35
- }
36
- return '';
23
+ //#region src/components/TreeView/TreeNode.tsx
24
+ /**
25
+ * Copyright IBM Corp. 2016, 2026
26
+ *
27
+ * This source code is licensed under the Apache-2.0 license found in the
28
+ * LICENSE file in the root directory of this source tree.
29
+ */
30
+ const extractTextContent = (node) => {
31
+ if (node === null || node === void 0) return "";
32
+ if (typeof node === "string") return node;
33
+ if (typeof node === "number") return String(node);
34
+ if (typeof node === "boolean") return String(node);
35
+ if (Array.isArray(node)) return node.map(extractTextContent).join("");
36
+ if (React.isValidElement(node)) {
37
+ const children = node.props.children;
38
+ return extractTextContent(children);
39
+ }
40
+ return "";
37
41
  };
38
42
  const useEllipsisCheck = (label, detailsWrapperRef) => {
39
- const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
40
- const labelTextRef = useRef(null);
41
- const checkEllipsis = useCallback(() => {
42
- const element = labelTextRef.current;
43
- if (!element) {
44
- setIsEllipsisApplied(false);
45
- return;
46
- }
47
- if (element.offsetWidth === 0) {
48
- setIsEllipsisApplied(false);
49
- return;
50
- }
51
- const checkElement = detailsWrapperRef.current || element;
52
- if (checkElement && checkElement.offsetWidth > 0) {
53
- const isTextTruncated = element.scrollWidth > checkElement.offsetWidth;
54
- setIsEllipsisApplied(isTextTruncated);
55
- } else {
56
- setIsEllipsisApplied(false);
57
- }
58
- }, [detailsWrapperRef]);
59
- useEffect(() => {
60
- const animationFrameId = requestAnimationFrame(checkEllipsis);
61
- let resizeObserver;
62
- if (typeof window !== 'undefined' && typeof window.ResizeObserver !== 'undefined' && labelTextRef.current) {
63
- resizeObserver = new window.ResizeObserver(() => {
64
- requestAnimationFrame(checkEllipsis);
65
- });
66
- resizeObserver.observe(labelTextRef.current);
67
- if (detailsWrapperRef.current) {
68
- resizeObserver.observe(detailsWrapperRef.current);
69
- }
70
- }
71
- return () => {
72
- cancelAnimationFrame(animationFrameId);
73
- if (resizeObserver) {
74
- if (labelTextRef.current) {
75
- // eslint-disable-next-line react-hooks/exhaustive-deps -- https://github.com/carbon-design-system/carbon/issues/20452
76
- resizeObserver.unobserve(labelTextRef.current);
77
- }
78
- if (detailsWrapperRef.current) {
79
- // eslint-disable-next-line react-hooks/exhaustive-deps -- https://github.com/carbon-design-system/carbon/issues/20452
80
- resizeObserver.unobserve(detailsWrapperRef.current);
81
- }
82
- resizeObserver.disconnect();
83
- }
84
- };
85
- }, [checkEllipsis, detailsWrapperRef]);
86
- return {
87
- labelTextRef,
88
- isEllipsisApplied,
89
- tooltipText: extractTextContent(label)
90
- };
43
+ const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
44
+ const labelTextRef = useRef(null);
45
+ const checkEllipsis = useCallback(() => {
46
+ const element = labelTextRef.current;
47
+ if (!element) {
48
+ setIsEllipsisApplied(false);
49
+ return;
50
+ }
51
+ if (element.offsetWidth === 0) {
52
+ setIsEllipsisApplied(false);
53
+ return;
54
+ }
55
+ const checkElement = detailsWrapperRef.current || element;
56
+ if (checkElement && checkElement.offsetWidth > 0) setIsEllipsisApplied(element.scrollWidth > checkElement.offsetWidth);
57
+ else setIsEllipsisApplied(false);
58
+ }, [detailsWrapperRef]);
59
+ useEffect(() => {
60
+ const animationFrameId = requestAnimationFrame(checkEllipsis);
61
+ let resizeObserver;
62
+ if (typeof window !== "undefined" && typeof window.ResizeObserver !== "undefined" && labelTextRef.current) {
63
+ resizeObserver = new window.ResizeObserver(() => {
64
+ requestAnimationFrame(checkEllipsis);
65
+ });
66
+ resizeObserver.observe(labelTextRef.current);
67
+ if (detailsWrapperRef.current) resizeObserver.observe(detailsWrapperRef.current);
68
+ }
69
+ return () => {
70
+ cancelAnimationFrame(animationFrameId);
71
+ if (resizeObserver) {
72
+ if (labelTextRef.current) resizeObserver.unobserve(labelTextRef.current);
73
+ if (detailsWrapperRef.current) resizeObserver.unobserve(detailsWrapperRef.current);
74
+ resizeObserver.disconnect();
75
+ }
76
+ };
77
+ }, [checkEllipsis, detailsWrapperRef]);
78
+ return {
79
+ labelTextRef,
80
+ isEllipsisApplied,
81
+ tooltipText: extractTextContent(label)
82
+ };
91
83
  };
92
- const TreeNode = /*#__PURE__*/React.forwardRef(({
93
- children,
94
- className,
95
- disabled,
96
- id: nodeId,
97
- isExpanded,
98
- defaultIsExpanded,
99
- label,
100
- onSelect: onNodeSelect,
101
- onToggle,
102
- renderIcon: Icon,
103
- value,
104
- href,
105
- align = 'bottom',
106
- autoAlign = false,
107
- // These props are fallback props if the TreeContext is not available or only TreeNode is used as a standalone component
108
- active: propActive,
109
- depth: propDepth,
110
- selected: propSelected,
111
- onTreeSelect: propOnTreeSelect,
112
- onNodeFocusEvent,
113
- ...rest
114
- }, forwardedRef) => {
115
- const treeContext = useContext(TreeContext);
116
- const contextDepth = useContext(DepthContext);
117
-
118
- // Prioritize direct props, and fall back to context values.
119
- const depth = propDepth ?? (contextDepth !== -1 ? contextDepth : 0);
120
- const active = propActive ?? treeContext?.active;
121
- const selected = propSelected ?? treeContext?.selected ?? [];
122
- const onTreeSelect = propOnTreeSelect ?? treeContext?.onTreeSelect;
123
- const detailsWrapperRef = useRef(null);
124
- const {
125
- labelTextRef,
126
- isEllipsisApplied,
127
- tooltipText
128
- } = useEllipsisCheck(label, detailsWrapperRef);
129
- const enableTreeviewControllable = useFeatureFlag('enable-treeview-controllable');
130
-
131
- // eslint-disable-next-line react-hooks/rules-of-hooks -- https://github.com/carbon-design-system/carbon/issues/20452
132
- const {
133
- current: id
134
- } = useRef(nodeId || useId());
135
- const controllableExpandedState = useControllableState({
136
- value: isExpanded,
137
- onChange: onToggle,
138
- defaultValue: defaultIsExpanded ?? false
139
- });
140
- const uncontrollableExpandedState = useState(isExpanded ?? false);
141
- const [expanded, setExpanded] = enableTreeviewControllable ? controllableExpandedState : uncontrollableExpandedState;
142
- const currentNode = useRef(null);
143
- const currentNodeLabel = useRef(null);
144
- const prefix = usePrefix();
145
- const nodeLabelId = `${id}__label`;
146
- const renderLabelText = () => {
147
- if (isEllipsisApplied && tooltipText) {
148
- return /*#__PURE__*/React.createElement(IconButton, {
149
- label: tooltipText,
150
- kind: "ghost",
151
- align: align,
152
- autoAlign: autoAlign,
153
- className: `${prefix}--tree-node__label__text-button`,
154
- wrapperClasses: `${prefix}--popover-container`
155
- }, /*#__PURE__*/React.createElement("span", {
156
- id: nodeLabelId,
157
- ref: labelTextRef,
158
- className: `${prefix}--tree-node__label__text`
159
- }, label));
160
- }
161
- return /*#__PURE__*/React.createElement("span", {
162
- id: nodeLabelId,
163
- ref: labelTextRef,
164
- className: `${prefix}--tree-node__label__text`
165
- }, label);
166
- };
167
- const setRefs = element => {
168
- currentNode.current = element;
169
- if (typeof forwardedRef === 'function') {
170
- forwardedRef(element);
171
- } else if (forwardedRef) {
172
- forwardedRef.current = element;
173
- }
174
- };
175
- const isActive = active === id;
176
- const isSelected = selected?.includes(id) ?? false;
177
- const treeNodeClasses = cx(className, `${prefix}--tree-node`, {
178
- [`${prefix}--tree-node--active`]: isActive,
179
- [`${prefix}--tree-node--disabled`]: disabled,
180
- [`${prefix}--tree-node--selected`]: isSelected,
181
- [`${prefix}--tree-node--with-icon`]: Icon,
182
- [`${prefix}--tree-leaf-node`]: !children,
183
- [`${prefix}--tree-parent-node`]: children
184
- });
185
- const toggleClasses = cx(`${prefix}--tree-parent-node__toggle-icon`, {
186
- [`${prefix}--tree-parent-node__toggle-icon--expanded`]: expanded
187
- });
188
- function handleToggleClick(event) {
189
- if (disabled) {
190
- return;
191
- }
192
-
193
- // Prevent the node from being selected
194
- event.stopPropagation();
195
- if (href) {
196
- event.preventDefault();
197
- }
198
- if (!enableTreeviewControllable) {
199
- onToggle?.(event, {
200
- id,
201
- isExpanded: !expanded,
202
- label,
203
- value
204
- });
205
- }
206
- setExpanded(!expanded);
207
- }
208
- function handleClick(event) {
209
- event.stopPropagation();
210
- if (!disabled) {
211
- onTreeSelect?.(event, {
212
- id,
213
- label,
214
- value
215
- });
216
- onNodeSelect?.(event, {
217
- id,
218
- label,
219
- value
220
- });
221
- rest?.onClick?.(event);
222
- }
223
- }
224
- function handleKeyDown(event) {
225
- function getFocusableNode(node) {
226
- if (node?.classList.contains(`${prefix}--tree-node`)) {
227
- return node;
228
- }
229
- return node?.firstChild;
230
- }
231
- if (disabled) {
232
- return;
233
- }
234
- if (matches(event, [ArrowLeft, ArrowRight, Enter])) {
235
- event.stopPropagation();
236
- }
237
- if (match(event, ArrowLeft)) {
238
- const findParentTreeNode = node => {
239
- if (!node) return null;
240
- if (node.classList.contains(`${prefix}--tree-parent-node`)) {
241
- return node;
242
- }
243
- if (node.classList.contains(`${prefix}--tree-node-link-parent`)) {
244
- return node.firstElementChild;
245
- }
246
- if (node.classList.contains(`${prefix}--tree`)) {
247
- return null;
248
- }
249
- return findParentTreeNode(node.parentElement);
250
- };
251
- if (children && expanded) {
252
- if (!enableTreeviewControllable) {
253
- onToggle?.(event, {
254
- id,
255
- isExpanded: false,
256
- label,
257
- value
258
- });
259
- }
260
- setExpanded(false);
261
- } else {
262
- /**
263
- * When focus is on a leaf node or a closed parent node, move focus to
264
- * its parent node (unless its depth is level 1)
265
- */
266
- const parentNode = findParentTreeNode((href ? currentNode.current?.parentElement?.parentElement : currentNode.current?.parentElement) ?? null);
267
- if (parentNode instanceof HTMLElement) {
268
- parentNode.focus();
269
- }
270
- }
271
- }
272
- if (children && match(event, ArrowRight)) {
273
- if (expanded) {
274
- /**
275
- * When focus is on an expanded parent node, move focus to the first
276
- * child node
277
- */
278
- getFocusableNode(href ? currentNode.current?.parentElement?.lastChild?.firstChild : currentNode.current?.lastChild?.firstChild)?.focus();
279
- } else {
280
- if (!enableTreeviewControllable) {
281
- onToggle?.(event, {
282
- id,
283
- isExpanded: true,
284
- label,
285
- value
286
- });
287
- }
288
- setExpanded(true);
289
- }
290
- }
291
- if (matches(event, [Enter, Space])) {
292
- event.preventDefault();
293
- if (match(event, Enter) && children) {
294
- // Toggle expansion state for parent nodes
295
- if (!enableTreeviewControllable) {
296
- onToggle?.(event, {
297
- id,
298
- isExpanded: !expanded,
299
- label,
300
- value
301
- });
302
- }
303
- setExpanded(!expanded);
304
- }
305
- if (href) {
306
- currentNode.current?.click();
307
- }
308
- handleClick(event);
309
- }
310
- rest?.onKeyDown?.(event);
311
- }
312
- function handleFocusEvent(event) {
313
- if (event.type === 'focus') {
314
- rest?.onFocus?.(event);
315
- }
316
- if (event.type === 'blur') {
317
- rest?.onBlur?.(event);
318
- }
319
- onNodeFocusEvent?.(event);
320
- }
321
- useEffect(() => {
322
- /**
323
- * Negative margin shifts node to align with the left side boundary of the
324
- * tree
325
- * Dynamically calculate padding to recreate tree node indentation
326
- * - parent nodes with icon have (depth + 1rem + depth * 0.5) left padding
327
- * - parent nodes have (depth + 1rem) left padding
328
- * - leaf nodes have (depth + 2.5rem) left padding without icons (because
329
- * of expand icon + spacing)
330
- * - leaf nodes have (depth + 2rem + depth * 0.5) left padding with icons (because of
331
- * reduced spacing between the expand icon and the node icon + label)
332
- */
333
- const calcOffset = () => {
334
- // parent node with icon
335
- if (children && Icon) {
336
- return depth + 1 + depth * 0.5;
337
- }
338
- // parent node without icon
339
- if (children) {
340
- return depth + 1;
341
- }
342
- // leaf node with icon
343
- if (Icon) {
344
- return depth + 2 + depth * 0.5;
345
- }
346
- // leaf node without icon
347
- return depth + 2.5;
348
- };
349
- if (currentNodeLabel.current) {
350
- currentNodeLabel.current.style.marginInlineStart = `-${calcOffset()}rem`;
351
- currentNodeLabel.current.style.paddingInlineStart = `${calcOffset()}rem`;
352
- }
353
- if (!enableTreeviewControllable) {
354
- // sync props and state
355
- setExpanded(isExpanded ?? false);
356
- }
357
- }, [children, depth, Icon, isExpanded, enableTreeviewControllable, setExpanded]);
358
- const tabIndex = disabled ? undefined : rest.tabIndex ?? -1;
359
- const treeNodeProps = {
360
- ...rest,
361
- ['aria-current']: !href ? isActive || undefined : isActive ? 'page' : undefined,
362
- ['aria-selected']: !href ? disabled ? undefined : isSelected : undefined,
363
- ['aria-disabled']: disabled,
364
- ['aria-owns']: children ? `${id}-subtree` : undefined,
365
- className: treeNodeClasses,
366
- id,
367
- onClick: handleClick,
368
- onKeyDown: handleKeyDown,
369
- role: 'treeitem',
370
- tabIndex,
371
- onFocus: handleFocusEvent,
372
- onBlur: handleFocusEvent
373
- };
374
- const nodeContent = /*#__PURE__*/React.createElement("div", {
375
- className: `${prefix}--tree-node__label`,
376
- ref: currentNodeLabel
377
- }, children &&
378
- /*#__PURE__*/
379
- // eslint-disable-next-line jsx-a11y/no-static-element-interactions , jsx-a11y/click-events-have-key-events -- https://github.com/carbon-design-system/carbon/issues/20452
380
- React.createElement("span", {
381
- className: `${prefix}--tree-parent-node__toggle`,
382
- onClick: handleToggleClick
383
- }, /*#__PURE__*/React.createElement(CaretDown, {
384
- className: toggleClasses
385
- })), /*#__PURE__*/React.createElement("span", {
386
- className: `${prefix}--tree-node__label__details`
387
- }, Icon && /*#__PURE__*/React.createElement(Icon, {
388
- className: `${prefix}--tree-node__icon`
389
- }), renderLabelText()));
390
- if (href) {
391
- return /*#__PURE__*/React.createElement("li", {
392
- role: "none",
393
- className: children ? `${prefix}--tree-node-link-parent` : ''
394
- }, /*#__PURE__*/React.createElement("a", _extends({}, treeNodeProps, {
395
- "aria-expanded": !!expanded,
396
- ref: setRefs,
397
- href: !disabled ? href : undefined
398
- }), nodeContent), children && /*#__PURE__*/React.createElement("ul", {
399
- id: `${id}-subtree`,
400
- role: "group",
401
- "aria-labelledby": nodeLabelId,
402
- className: cx(`${prefix}--tree-node__children`, {
403
- [`${prefix}--tree-node--hidden`]: !expanded
404
- })
405
- }, /*#__PURE__*/React.createElement(DepthContext.Provider, {
406
- value: depth + 1
407
- }, children)));
408
- }
409
- return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("li", _extends({}, treeNodeProps, {
410
- "aria-expanded": children ? !!expanded : undefined,
411
- ref: setRefs
412
- }), nodeContent, children && /*#__PURE__*/React.createElement("ul", {
413
- id: `${id}-subtree`,
414
- role: "group",
415
- "aria-labelledby": nodeLabelId,
416
- className: cx(`${prefix}--tree-node__children`, {
417
- [`${prefix}--tree-node--hidden`]: !expanded
418
- })
419
- }, /*#__PURE__*/React.createElement(DepthContext.Provider, {
420
- value: depth + 1
421
- }, children))));
84
+ const TreeNode = React.forwardRef(({ children, className, disabled, id: nodeId, isExpanded, defaultIsExpanded, label, onSelect: onNodeSelect, onToggle, renderIcon: Icon, value, href, align = "bottom", autoAlign = false, active: propActive, depth: propDepth, selected: propSelected, onTreeSelect: propOnTreeSelect, onNodeFocusEvent, ...rest }, forwardedRef) => {
85
+ const treeContext = useContext(TreeContext);
86
+ const contextDepth = useContext(DepthContext);
87
+ const depth = propDepth ?? (contextDepth !== -1 ? contextDepth : 0);
88
+ const active = propActive ?? treeContext?.active;
89
+ const selected = propSelected ?? treeContext?.selected ?? [];
90
+ const onTreeSelect = propOnTreeSelect ?? treeContext?.onTreeSelect;
91
+ const { labelTextRef, isEllipsisApplied, tooltipText } = useEllipsisCheck(label, useRef(null));
92
+ const enableTreeviewControllable = useFeatureFlag("enable-treeview-controllable");
93
+ const { current: id } = useRef(nodeId || useId());
94
+ const controllableExpandedState = useControllableState({
95
+ value: isExpanded,
96
+ onChange: onToggle,
97
+ defaultValue: defaultIsExpanded ?? false
98
+ });
99
+ const uncontrollableExpandedState = useState(isExpanded ?? false);
100
+ const [expanded, setExpanded] = enableTreeviewControllable ? controllableExpandedState : uncontrollableExpandedState;
101
+ const currentNode = useRef(null);
102
+ const currentNodeLabel = useRef(null);
103
+ const prefix = usePrefix();
104
+ const nodeLabelId = `${id}__label`;
105
+ const renderLabelText = () => {
106
+ if (isEllipsisApplied && tooltipText) return /* @__PURE__ */ jsx(IconButton, {
107
+ label: tooltipText,
108
+ kind: "ghost",
109
+ align,
110
+ autoAlign,
111
+ className: `${prefix}--tree-node__label__text-button`,
112
+ wrapperClasses: `${prefix}--popover-container`,
113
+ children: /* @__PURE__ */ jsx("span", {
114
+ id: nodeLabelId,
115
+ ref: labelTextRef,
116
+ className: `${prefix}--tree-node__label__text`,
117
+ children: label
118
+ })
119
+ });
120
+ return /* @__PURE__ */ jsx("span", {
121
+ id: nodeLabelId,
122
+ ref: labelTextRef,
123
+ className: `${prefix}--tree-node__label__text`,
124
+ children: label
125
+ });
126
+ };
127
+ const setRefs = (element) => {
128
+ currentNode.current = element;
129
+ if (typeof forwardedRef === "function") forwardedRef(element);
130
+ else if (forwardedRef) forwardedRef.current = element;
131
+ };
132
+ const isActive = active === id;
133
+ const isSelected = selected?.includes(id) ?? false;
134
+ const treeNodeClasses = classNames(className, `${prefix}--tree-node`, {
135
+ [`${prefix}--tree-node--active`]: isActive,
136
+ [`${prefix}--tree-node--disabled`]: disabled,
137
+ [`${prefix}--tree-node--selected`]: isSelected,
138
+ [`${prefix}--tree-node--with-icon`]: Icon,
139
+ [`${prefix}--tree-leaf-node`]: !children,
140
+ [`${prefix}--tree-parent-node`]: children
141
+ });
142
+ const toggleClasses = classNames(`${prefix}--tree-parent-node__toggle-icon`, { [`${prefix}--tree-parent-node__toggle-icon--expanded`]: expanded });
143
+ function handleToggleClick(event) {
144
+ if (disabled) return;
145
+ event.stopPropagation();
146
+ if (href) event.preventDefault();
147
+ if (!enableTreeviewControllable) onToggle?.(event, {
148
+ id,
149
+ isExpanded: !expanded,
150
+ label,
151
+ value
152
+ });
153
+ setExpanded(!expanded);
154
+ }
155
+ function handleClick(event) {
156
+ event.stopPropagation();
157
+ if (!disabled) {
158
+ onTreeSelect?.(event, {
159
+ id,
160
+ label,
161
+ value
162
+ });
163
+ onNodeSelect?.(event, {
164
+ id,
165
+ label,
166
+ value
167
+ });
168
+ rest?.onClick?.(event);
169
+ }
170
+ }
171
+ function handleKeyDown(event) {
172
+ function getFocusableNode(node) {
173
+ if (node?.classList.contains(`${prefix}--tree-node`)) return node;
174
+ return node?.firstChild;
175
+ }
176
+ if (disabled) return;
177
+ if (matches(event, [
178
+ ArrowLeft,
179
+ ArrowRight$1,
180
+ Enter
181
+ ])) event.stopPropagation();
182
+ if (match(event, ArrowLeft)) {
183
+ const findParentTreeNode = (node) => {
184
+ if (!node) return null;
185
+ if (node.classList.contains(`${prefix}--tree-parent-node`)) return node;
186
+ if (node.classList.contains(`${prefix}--tree-node-link-parent`)) return node.firstElementChild;
187
+ if (node.classList.contains(`${prefix}--tree`)) return null;
188
+ return findParentTreeNode(node.parentElement);
189
+ };
190
+ if (children && expanded) {
191
+ if (!enableTreeviewControllable) onToggle?.(event, {
192
+ id,
193
+ isExpanded: false,
194
+ label,
195
+ value
196
+ });
197
+ setExpanded(false);
198
+ } else {
199
+ /**
200
+ * When focus is on a leaf node or a closed parent node, move focus to
201
+ * its parent node (unless its depth is level 1)
202
+ */
203
+ const parentNode = findParentTreeNode((href ? currentNode.current?.parentElement?.parentElement : currentNode.current?.parentElement) ?? null);
204
+ if (parentNode instanceof HTMLElement) parentNode.focus();
205
+ }
206
+ }
207
+ if (children && match(event, ArrowRight$1)) if (expanded)
208
+ /**
209
+ * When focus is on an expanded parent node, move focus to the first
210
+ * child node
211
+ */
212
+ getFocusableNode(href ? currentNode.current?.parentElement?.lastChild?.firstChild : currentNode.current?.lastChild?.firstChild)?.focus();
213
+ else {
214
+ if (!enableTreeviewControllable) onToggle?.(event, {
215
+ id,
216
+ isExpanded: true,
217
+ label,
218
+ value
219
+ });
220
+ setExpanded(true);
221
+ }
222
+ if (matches(event, [Enter, Space])) {
223
+ event.preventDefault();
224
+ if (match(event, Enter) && children) {
225
+ if (!enableTreeviewControllable) onToggle?.(event, {
226
+ id,
227
+ isExpanded: !expanded,
228
+ label,
229
+ value
230
+ });
231
+ setExpanded(!expanded);
232
+ }
233
+ if (href) currentNode.current?.click();
234
+ handleClick(event);
235
+ }
236
+ rest?.onKeyDown?.(event);
237
+ }
238
+ function handleFocusEvent(event) {
239
+ if (event.type === "focus") rest?.onFocus?.(event);
240
+ if (event.type === "blur") rest?.onBlur?.(event);
241
+ onNodeFocusEvent?.(event);
242
+ }
243
+ useEffect(() => {
244
+ /**
245
+ * Negative margin shifts node to align with the left side boundary of the
246
+ * tree
247
+ * Dynamically calculate padding to recreate tree node indentation
248
+ * - parent nodes with icon have (depth + 1rem + depth * 0.5) left padding
249
+ * - parent nodes have (depth + 1rem) left padding
250
+ * - leaf nodes have (depth + 2.5rem) left padding without icons (because
251
+ * of expand icon + spacing)
252
+ * - leaf nodes have (depth + 2rem + depth * 0.5) left padding with icons (because of
253
+ * reduced spacing between the expand icon and the node icon + label)
254
+ */
255
+ const calcOffset = () => {
256
+ if (children && Icon) return depth + 1 + depth * .5;
257
+ if (children) return depth + 1;
258
+ if (Icon) return depth + 2 + depth * .5;
259
+ return depth + 2.5;
260
+ };
261
+ if (currentNodeLabel.current) {
262
+ currentNodeLabel.current.style.marginInlineStart = `-${calcOffset()}rem`;
263
+ currentNodeLabel.current.style.paddingInlineStart = `${calcOffset()}rem`;
264
+ }
265
+ if (!enableTreeviewControllable) setExpanded(isExpanded ?? false);
266
+ }, [
267
+ children,
268
+ depth,
269
+ Icon,
270
+ isExpanded,
271
+ enableTreeviewControllable,
272
+ setExpanded
273
+ ]);
274
+ const tabIndex = disabled ? void 0 : rest.tabIndex ?? -1;
275
+ const treeNodeProps = {
276
+ ...rest,
277
+ ["aria-current"]: !href ? isActive || void 0 : isActive ? "page" : void 0,
278
+ ["aria-selected"]: !href ? disabled ? void 0 : isSelected : void 0,
279
+ ["aria-disabled"]: disabled,
280
+ ["aria-owns"]: children ? `${id}-subtree` : void 0,
281
+ className: treeNodeClasses,
282
+ id,
283
+ onClick: handleClick,
284
+ onKeyDown: handleKeyDown,
285
+ role: "treeitem",
286
+ tabIndex,
287
+ onFocus: handleFocusEvent,
288
+ onBlur: handleFocusEvent
289
+ };
290
+ const nodeContent = /* @__PURE__ */ jsxs("div", {
291
+ className: `${prefix}--tree-node__label`,
292
+ ref: currentNodeLabel,
293
+ children: [children && /* @__PURE__ */ jsx("span", {
294
+ className: `${prefix}--tree-parent-node__toggle`,
295
+ onClick: handleToggleClick,
296
+ children: /* @__PURE__ */ jsx(CaretDown, { className: toggleClasses })
297
+ }), /* @__PURE__ */ jsxs("span", {
298
+ className: `${prefix}--tree-node__label__details`,
299
+ children: [Icon && /* @__PURE__ */ jsx(Icon, { className: `${prefix}--tree-node__icon` }), renderLabelText()]
300
+ })]
301
+ });
302
+ if (href) return /* @__PURE__ */ jsxs("li", {
303
+ role: "none",
304
+ className: children ? `${prefix}--tree-node-link-parent` : "",
305
+ children: [/* @__PURE__ */ jsx("a", {
306
+ ...treeNodeProps,
307
+ "aria-expanded": !!expanded,
308
+ ref: setRefs,
309
+ href: !disabled ? href : void 0,
310
+ children: nodeContent
311
+ }), children && /* @__PURE__ */ jsx("ul", {
312
+ id: `${id}-subtree`,
313
+ role: "group",
314
+ "aria-labelledby": nodeLabelId,
315
+ className: classNames(`${prefix}--tree-node__children`, { [`${prefix}--tree-node--hidden`]: !expanded }),
316
+ children: /* @__PURE__ */ jsx(DepthContext.Provider, {
317
+ value: depth + 1,
318
+ children
319
+ })
320
+ })]
321
+ });
322
+ return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsxs("li", {
323
+ ...treeNodeProps,
324
+ "aria-expanded": children ? !!expanded : void 0,
325
+ ref: setRefs,
326
+ children: [nodeContent, children && /* @__PURE__ */ jsx("ul", {
327
+ id: `${id}-subtree`,
328
+ role: "group",
329
+ "aria-labelledby": nodeLabelId,
330
+ className: classNames(`${prefix}--tree-node__children`, { [`${prefix}--tree-node--hidden`]: !expanded }),
331
+ children: /* @__PURE__ */ jsx(DepthContext.Provider, {
332
+ value: depth + 1,
333
+ children
334
+ })
335
+ })]
336
+ }) });
422
337
  });
423
338
  TreeNode.propTypes = {
424
- /**
425
- * **Note:** this is controlled by the parent TreeView component, do not set manually.
426
- * The ID of the active node in the tree
427
- */
428
- active: deprecate(PropTypes.oneOfType([PropTypes.string, PropTypes.number]), 'The `active` prop for `TreeNode` is no longer needed and has ' + 'been deprecated. It will be removed in the next major release.'),
429
- /**
430
- * Specify the children of the TreeNode
431
- */
432
- children: PropTypes.node,
433
- /**
434
- * Specify an optional className to be applied to the TreeNode
435
- */
436
- className: PropTypes.string,
437
- /**
438
- * **[Experimental]** The default expansion state of the node.
439
- * *This is only supported with the `enable-treeview-controllable` feature flag!*
440
- */
441
- defaultIsExpanded: PropTypes.bool,
442
- /**
443
- * **Note:** this is controlled by the parent TreeView component, do not set manually.
444
- * TreeNode depth to determine spacing
445
- */
446
- depth: deprecate(PropTypes.number, 'The `depth` prop for `TreeNode` is no longer needed and has ' + 'been deprecated. It will be removed in the next major release.'),
447
- /**
448
- * Specify if the TreeNode is disabled
449
- */
450
- disabled: PropTypes.bool,
451
- /**
452
- * Specify the TreeNode's ID. Must be unique in the DOM and is used for props.active, props.selected and aria-owns
453
- */
454
- id: PropTypes.string,
455
- /**
456
- * Specify if the TreeNode is expanded (only applicable to parent nodes)
457
- */
458
- isExpanded: PropTypes.bool,
459
- /**
460
- * Rendered label for the TreeNode
461
- */
462
- label: PropTypes.node,
463
- /**
464
- * Callback function for when the node receives or loses focus
465
- */
466
- onNodeFocusEvent: deprecate(PropTypes.func, 'The `onNodeFocusEvent` prop for `TreeNode` is no longer needed and has ' + 'been deprecated. It will be removed in the next major release.'),
467
- /**
468
- * Callback function for when the node is selected
469
- */
470
- onSelect: PropTypes.func,
471
- /**
472
- * Callback function for when a parent node is expanded or collapsed
473
- */
474
- onToggle: PropTypes.func,
475
- /**
476
- * Callback function for when any node in the tree is selected
477
- */
478
- onTreeSelect: deprecate(PropTypes.func, 'The `onTreeSelect` prop for `TreeNode` is no longer needed and has ' + 'been deprecated. It will be removed in the next major release.'),
479
- /**
480
- * A component used to render an icon.
481
- */
482
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- https://github.com/carbon-design-system/carbon/issues/20452
483
- // @ts-ignore
484
- renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
485
- /**
486
- * **Note:** this is controlled by the parent TreeView component, do not set manually.
487
- * Array containing all selected node IDs in the tree
488
- */
489
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- https://github.com/carbon-design-system/carbon/issues/20452
490
- // @ts-ignore
491
- selected: deprecate(PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.number])), 'The `selected` prop for `TreeNode` is no longer needed and has ' + 'been deprecated. It will be removed in the next major release.'),
492
- /**
493
- * Specify the value of the TreeNode
494
- */
495
- value: PropTypes.string,
496
- /**
497
- * Optional: The URL the TreeNode is linking to
498
- */
499
- href: PropTypes.string,
500
- /**
501
- * Specify how the tooltip should align when text is truncated
502
- */
503
- align: PropTypes.oneOf(['top', 'bottom', 'left', 'right', 'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
504
- /**
505
- * **Experimental**: Will attempt to automatically align the floating
506
- * element to avoid collisions with the viewport and being clipped by
507
- * ancestor elements. Requires React v17+
508
- * @see https://github.com/carbon-design-system/carbon/issues/18714
509
- */
510
- autoAlign: PropTypes.bool
339
+ active: deprecate(PropTypes.oneOfType([PropTypes.string, PropTypes.number]), "The `active` prop for `TreeNode` is no longer needed and has been deprecated. It will be removed in the next major release."),
340
+ children: PropTypes.node,
341
+ className: PropTypes.string,
342
+ defaultIsExpanded: PropTypes.bool,
343
+ depth: deprecate(PropTypes.number, "The `depth` prop for `TreeNode` is no longer needed and has been deprecated. It will be removed in the next major release."),
344
+ disabled: PropTypes.bool,
345
+ id: PropTypes.string,
346
+ isExpanded: PropTypes.bool,
347
+ label: PropTypes.node,
348
+ onNodeFocusEvent: deprecate(PropTypes.func, "The `onNodeFocusEvent` prop for `TreeNode` is no longer needed and has been deprecated. It will be removed in the next major release."),
349
+ onSelect: PropTypes.func,
350
+ onToggle: PropTypes.func,
351
+ onTreeSelect: deprecate(PropTypes.func, "The `onTreeSelect` prop for `TreeNode` is no longer needed and has been deprecated. It will be removed in the next major release."),
352
+ renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
353
+ selected: deprecate(PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.number])), "The `selected` prop for `TreeNode` is no longer needed and has been deprecated. It will be removed in the next major release."),
354
+ value: PropTypes.string,
355
+ href: PropTypes.string,
356
+ align: PropTypes.oneOf([
357
+ "top",
358
+ "bottom",
359
+ "left",
360
+ "right",
361
+ "top-start",
362
+ "top-end",
363
+ "bottom-start",
364
+ "bottom-end",
365
+ "left-end",
366
+ "left-start",
367
+ "right-end",
368
+ "right-start"
369
+ ]),
370
+ autoAlign: PropTypes.bool
511
371
  };
512
- TreeNode.displayName = 'TreeNode';
372
+ TreeNode.displayName = "TreeNode";
513
373
 
514
- export { TreeNode as default };
374
+ //#endregion
375
+ export { TreeNode as default };