@carbon/react 1.103.0 → 1.104.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 (769) hide show
  1. package/.playwright/INTERNAL_AVT_REPORT_DO_NOT_USE.json +990 -1245
  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.js +485 -752
  89. package/es/components/DatePicker/DatePickerLocales.js +75 -126
  90. package/es/components/DatePicker/index.js +13 -5
  91. package/es/components/DatePicker/plugins/appendToPlugin.js +31 -45
  92. package/es/components/DatePicker/plugins/fixEventsPlugin.js +127 -171
  93. package/es/components/DatePicker/plugins/rangePlugin.js +40 -48
  94. package/es/components/DatePicker/utils.js +11 -3
  95. package/es/components/DatePickerInput/DatePickerInput.js +179 -289
  96. package/es/components/DatePickerInput/index.js +12 -4
  97. package/es/components/Dialog/Dialog.js +303 -574
  98. package/es/components/Dialog/index.js +18 -2
  99. package/es/components/Dropdown/Dropdown.Skeleton.js +26 -38
  100. package/es/components/Dropdown/Dropdown.js +344 -535
  101. package/es/components/Dropdown/index.js +13 -5
  102. package/es/components/ErrorBoundary/ErrorBoundary.js +36 -58
  103. package/es/components/ErrorBoundary/ErrorBoundaryContext.js +14 -9
  104. package/es/components/ExpandableSearch/ExpandableSearch.js +60 -69
  105. package/es/components/ExpandableSearch/index.js +12 -4
  106. package/es/components/FeatureFlags/index.d.ts +11 -2
  107. package/es/components/FeatureFlags/index.js +79 -77
  108. package/es/components/FileUploader/FileUploader.Skeleton.js +35 -30
  109. package/es/components/FileUploader/FileUploader.js +269 -343
  110. package/es/components/FileUploader/FileUploaderButton.js +110 -160
  111. package/es/components/FileUploader/FileUploaderDropContainer.js +144 -221
  112. package/es/components/FileUploader/FileUploaderItem.js +138 -157
  113. package/es/components/FileUploader/Filename.d.ts +1 -1
  114. package/es/components/FileUploader/Filename.js +53 -72
  115. package/es/components/FluidComboBox/FluidComboBox.Skeleton.js +26 -28
  116. package/es/components/FluidComboBox/FluidComboBox.js +54 -105
  117. package/es/components/FluidDatePicker/FluidDatePicker.Skeleton.js +56 -53
  118. package/es/components/FluidDatePicker/FluidDatePicker.js +46 -68
  119. package/es/components/FluidDatePickerInput/FluidDatePickerInput.js +23 -16
  120. package/es/components/FluidDropdown/FluidDropdown.Skeleton.js +26 -28
  121. package/es/components/FluidDropdown/FluidDropdown.js +55 -111
  122. package/es/components/FluidForm/FluidForm.js +29 -31
  123. package/es/components/FluidForm/FormContext.js +12 -6
  124. package/es/components/FluidMultiSelect/FluidMultiSelect.Skeleton.js +26 -28
  125. package/es/components/FluidMultiSelect/FluidMultiSelect.js +67 -197
  126. package/es/components/FluidNumberInput/FluidNumberInput.Skeleton.js +27 -30
  127. package/es/components/FluidNumberInput/FluidNumberInput.js +63 -147
  128. package/es/components/FluidSearch/FluidSearch.Skeleton.js +27 -30
  129. package/es/components/FluidSearch/FluidSearch.js +41 -84
  130. package/es/components/FluidSelect/FluidSelect.Skeleton.js +26 -28
  131. package/es/components/FluidSelect/FluidSelect.js +40 -76
  132. package/es/components/FluidSelect/index.js +13 -5
  133. package/es/components/FluidTextArea/FluidTextArea.Skeleton.js +27 -30
  134. package/es/components/FluidTextArea/FluidTextArea.js +48 -112
  135. package/es/components/FluidTextInput/FluidPasswordInput.js +44 -99
  136. package/es/components/FluidTextInput/FluidTextInput.Skeleton.js +27 -30
  137. package/es/components/FluidTextInput/FluidTextInput.js +49 -104
  138. package/es/components/FluidTextInput/index.js +14 -6
  139. package/es/components/FluidTimePicker/FluidTimePicker.Skeleton.js +30 -33
  140. package/es/components/FluidTimePicker/FluidTimePicker.js +68 -115
  141. package/es/components/FluidTimePickerSelect/FluidTimePickerSelect.js +28 -47
  142. package/es/components/Form/Form.js +23 -25
  143. package/es/components/FormGroup/FormGroup.js +45 -67
  144. package/es/components/FormItem/FormItem.js +23 -25
  145. package/es/components/FormLabel/FormLabel.js +28 -34
  146. package/es/components/Grid/CSSGrid.d.ts +1 -1
  147. package/es/components/Grid/CSSGrid.js +85 -127
  148. package/es/components/Grid/Column.js +192 -324
  149. package/es/components/Grid/ColumnHang.js +28 -36
  150. package/es/components/Grid/FlexGrid.js +40 -60
  151. package/es/components/Grid/Grid.js +29 -42
  152. package/es/components/Grid/GridContext.js +36 -42
  153. package/es/components/Grid/Row.js +31 -49
  154. package/es/components/Heading/index.js +36 -51
  155. package/es/components/Icon/Icon.Skeleton.js +21 -21
  156. package/es/components/IconButton/index.js +117 -178
  157. package/es/components/IconIndicator/index.d.ts +1 -1
  158. package/es/components/IconIndicator/index.js +59 -60
  159. package/es/components/IdPrefix/index.js +21 -17
  160. package/es/components/InlineCheckbox/InlineCheckbox.js +69 -113
  161. package/es/components/InlineCheckbox/index.js +12 -4
  162. package/es/components/InlineLoading/InlineLoading.js +83 -100
  163. package/es/components/InlineLoading/index.js +12 -4
  164. package/es/components/Layer/LayerContext.js +12 -4
  165. package/es/components/Layer/LayerLevel.js +20 -4
  166. package/es/components/Layer/index.js +54 -66
  167. package/es/components/Layout/index.js +77 -109
  168. package/es/components/LayoutDirection/LayoutDirection.d.ts +1 -1
  169. package/es/components/LayoutDirection/LayoutDirection.js +33 -37
  170. package/es/components/LayoutDirection/LayoutDirectionContext.js +12 -6
  171. package/es/components/LayoutDirection/useLayoutDirection.js +15 -7
  172. package/es/components/Link/Link.js +63 -108
  173. package/es/components/Link/index.js +12 -4
  174. package/es/components/ListBox/ListBox.js +78 -126
  175. package/es/components/ListBox/ListBoxField.js +24 -43
  176. package/es/components/ListBox/ListBoxMenu.js +36 -42
  177. package/es/components/ListBox/ListBoxMenuIcon.js +39 -40
  178. package/es/components/ListBox/ListBoxMenuItem.js +67 -88
  179. package/es/components/ListBox/ListBoxPropTypes.js +17 -5
  180. package/es/components/ListBox/ListBoxSelection.js +71 -96
  181. package/es/components/ListBox/index.js +16 -14
  182. package/es/components/ListBox/next/ListBoxSelection.js +79 -117
  183. package/es/components/ListBox/next/ListBoxTrigger.js +44 -48
  184. package/es/components/ListItem/ListItem.js +25 -28
  185. package/es/components/Loading/Loading.js +64 -73
  186. package/es/components/Loading/index.js +12 -4
  187. package/es/components/Menu/Menu.js +220 -363
  188. package/es/components/Menu/MenuContext.d.ts +1 -1
  189. package/es/components/Menu/MenuContext.js +41 -38
  190. package/es/components/Menu/MenuItem.js +282 -413
  191. package/es/components/MenuButton/index.js +134 -195
  192. package/es/components/Modal/Modal.js +500 -660
  193. package/es/components/Modal/ModalPresence.js +39 -37
  194. package/es/components/Modal/index.js +13 -5
  195. package/es/components/ModalWrapper/ModalWrapper.d.ts +2 -2
  196. package/es/components/ModalWrapper/ModalWrapper.js +106 -130
  197. package/es/components/MultiSelect/FilterableMultiSelect.js +605 -918
  198. package/es/components/MultiSelect/MultiSelect.js +454 -716
  199. package/es/components/MultiSelect/MultiSelectPropTypes.js +13 -30
  200. package/es/components/MultiSelect/filter.js +14 -9
  201. package/es/components/MultiSelect/tools/sorting.js +21 -34
  202. package/es/components/Notification/Notification.js +508 -785
  203. package/es/components/NumberInput/NumberFormatPropTypes.js +69 -30
  204. package/es/components/NumberInput/NumberInput.Skeleton.js +29 -33
  205. package/es/components/NumberInput/NumberInput.js +565 -947
  206. package/es/components/OrderedList/OrderedList.js +31 -44
  207. package/es/components/OverflowMenu/OverflowMenu.js +335 -450
  208. package/es/components/OverflowMenu/index.js +25 -16
  209. package/es/components/OverflowMenu/next/index.js +154 -186
  210. package/es/components/OverflowMenuItem/OverflowMenuItem.js +100 -160
  211. package/es/components/OverflowMenuItem/index.js +12 -4
  212. package/es/components/OverflowMenuV2/index.js +15 -13
  213. package/es/components/PageHeader/PageHeader.js +297 -442
  214. package/es/components/PageHeader/index.js +24 -2
  215. package/es/components/Pagination/Pagination.Skeleton.js +34 -35
  216. package/es/components/Pagination/Pagination.d.ts +1 -1
  217. package/es/components/Pagination/Pagination.js +251 -356
  218. package/es/components/Pagination/experimental/PageSelector.js +38 -54
  219. package/es/components/Pagination/experimental/Pagination-story.d.ts +114 -0
  220. package/es/components/Pagination/experimental/Pagination.js +144 -196
  221. package/es/components/PaginationNav/PaginationNav.js +320 -426
  222. package/es/components/Popover/index.js +318 -437
  223. package/es/components/PrimaryButton/PrimaryButton.js +11 -9
  224. package/es/components/ProgressBar/ProgressBar.js +117 -143
  225. package/es/components/ProgressIndicator/ProgressIndicator.Skeleton.js +42 -38
  226. package/es/components/ProgressIndicator/ProgressIndicator.js +146 -243
  227. package/es/components/RadioButton/RadioButton.Skeleton.js +23 -25
  228. package/es/components/RadioButton/RadioButton.js +101 -174
  229. package/es/components/RadioButton/index.js +12 -4
  230. package/es/components/RadioButtonGroup/RadioButtonGroup.js +135 -207
  231. package/es/components/RadioTile/RadioTile.js +104 -168
  232. package/es/components/RadioTile/index.js +12 -4
  233. package/es/components/Search/Search.Skeleton.js +28 -33
  234. package/es/components/Search/Search.js +182 -278
  235. package/es/components/Search/index.js +13 -5
  236. package/es/components/Search/utils.js +11 -3
  237. package/es/components/SecondaryButton/SecondaryButton.js +11 -9
  238. package/es/components/Select/Select.Skeleton.js +27 -30
  239. package/es/components/Select/Select.js +178 -257
  240. package/es/components/Select/index.js +13 -5
  241. package/es/components/SelectItem/SelectItem.js +33 -48
  242. package/es/components/SelectItem/index.js +12 -4
  243. package/es/components/SelectItemGroup/SelectItemGroup.js +27 -37
  244. package/es/components/ShapeIndicator/index.d.ts +1 -1
  245. package/es/components/ShapeIndicator/index.js +74 -80
  246. package/es/components/SkeletonIcon/SkeletonIcon.js +21 -24
  247. package/es/components/SkeletonPlaceholder/SkeletonPlaceholder.js +15 -24
  248. package/es/components/SkeletonText/SkeletonText.js +67 -81
  249. package/es/components/SkeletonText/index.js +12 -4
  250. package/es/components/Slider/Slider.Skeleton.js +68 -91
  251. package/es/components/Slider/Slider.js +864 -1315
  252. package/es/components/Slider/SliderHandles.js +73 -66
  253. package/es/components/Stack/HStack.js +19 -11
  254. package/es/components/Stack/Stack.js +56 -80
  255. package/es/components/Stack/VStack.js +19 -11
  256. package/es/components/StructuredList/StructuredList.Skeleton.js +55 -48
  257. package/es/components/StructuredList/StructuredList.js +178 -317
  258. package/es/components/Switch/IconSwitch.js +99 -145
  259. package/es/components/Switch/Switch.js +66 -99
  260. package/es/components/TabContent/TabContent.js +28 -34
  261. package/es/components/Tabs/Tabs.Skeleton.js +41 -36
  262. package/es/components/Tabs/Tabs.js +732 -1149
  263. package/es/components/Tabs/usePressable.js +97 -112
  264. package/es/components/Tag/DismissibleTag.js +119 -156
  265. package/es/components/Tag/OperationalTag.js +91 -111
  266. package/es/components/Tag/SelectableTag.js +94 -129
  267. package/es/components/Tag/Tag.Skeleton.js +26 -30
  268. package/es/components/Tag/Tag.js +152 -200
  269. package/es/components/Tag/isEllipsisActive.js +13 -8
  270. package/es/components/Text/Text.js +66 -79
  271. package/es/components/Text/TextDirection.js +36 -37
  272. package/es/components/Text/TextDirectionContext.js +14 -8
  273. package/es/components/Text/createTextComponent.js +21 -20
  274. package/es/components/TextArea/TextArea.Skeleton.js +25 -29
  275. package/es/components/TextArea/TextArea.js +315 -422
  276. package/es/components/TextArea/index.js +13 -5
  277. package/es/components/TextInput/ControlledPasswordInput.js +133 -198
  278. package/es/components/TextInput/PasswordInput.js +196 -303
  279. package/es/components/TextInput/TextInput.Skeleton.js +24 -28
  280. package/es/components/TextInput/TextInput.js +219 -317
  281. package/es/components/TextInput/index.js +13 -5
  282. package/es/components/TextInput/util.js +21 -25
  283. package/es/components/Theme/index.js +79 -95
  284. package/es/components/Tile/Tile.js +394 -593
  285. package/es/components/TileGroup/TileGroup.js +70 -111
  286. package/es/components/TimePicker/TimePicker.d.ts +1 -1
  287. package/es/components/TimePicker/TimePicker.js +148 -247
  288. package/es/components/TimePickerSelect/TimePickerSelect.js +43 -58
  289. package/es/components/Toggle/Toggle.Skeleton.js +24 -22
  290. package/es/components/Toggle/Toggle.js +102 -171
  291. package/es/components/ToggleSmall/ToggleSmall.Skeleton.js +46 -51
  292. package/es/components/Toggletip/index.d.ts +2 -2
  293. package/es/components/Toggletip/index.js +170 -256
  294. package/es/components/Tooltip/DefinitionTooltip.js +98 -138
  295. package/es/components/Tooltip/Tooltip.js +188 -263
  296. package/es/components/TreeView/TreeContext.js +13 -5
  297. package/es/components/TreeView/TreeNode.js +361 -500
  298. package/es/components/TreeView/TreeView.js +164 -237
  299. package/es/components/UIShell/Content.js +23 -30
  300. package/es/components/UIShell/Header.js +25 -29
  301. package/es/components/UIShell/HeaderContainer.js +31 -40
  302. package/es/components/UIShell/HeaderGlobalAction.js +65 -90
  303. package/es/components/UIShell/HeaderGlobalBar.js +16 -9
  304. package/es/components/UIShell/HeaderMenu.js +141 -215
  305. package/es/components/UIShell/HeaderMenuButton.js +43 -66
  306. package/es/components/UIShell/HeaderMenuItem.js +49 -76
  307. package/es/components/UIShell/HeaderName.js +32 -44
  308. package/es/components/UIShell/HeaderNavigation.js +32 -37
  309. package/es/components/UIShell/HeaderPanel.js +74 -97
  310. package/es/components/UIShell/HeaderSideNavItems.js +27 -33
  311. package/es/components/UIShell/Link.js +29 -50
  312. package/es/components/UIShell/SideNav.js +132 -241
  313. package/es/components/UIShell/SideNavContext.js +21 -15
  314. package/es/components/UIShell/SideNavDetails.js +29 -34
  315. package/es/components/UIShell/SideNavDivider.js +21 -21
  316. package/es/components/UIShell/SideNavFooter.js +43 -52
  317. package/es/components/UIShell/SideNavHeader.js +26 -35
  318. package/es/components/UIShell/SideNavIcon.js +28 -33
  319. package/es/components/UIShell/SideNavItem.js +28 -33
  320. package/es/components/UIShell/SideNavItems.js +31 -40
  321. package/es/components/UIShell/SideNavLink.js +52 -79
  322. package/es/components/UIShell/SideNavLinkText.js +24 -25
  323. package/es/components/UIShell/SideNavMenu.js +102 -143
  324. package/es/components/UIShell/SideNavMenuItem.js +40 -52
  325. package/es/components/UIShell/SideNavSwitcher.js +59 -68
  326. package/es/components/UIShell/SkipToContent.js +28 -36
  327. package/es/components/UIShell/Switcher.js +69 -99
  328. package/es/components/UIShell/SwitcherDivider.js +16 -24
  329. package/es/components/UIShell/SwitcherItem.js +74 -114
  330. package/es/components/UnorderedList/UnorderedList.js +28 -37
  331. package/es/feature-flags.js +19 -10
  332. package/es/index.js +249 -242
  333. package/es/internal/FloatingMenu.js +246 -292
  334. package/es/internal/OptimizedResize.js +35 -46
  335. package/es/internal/Selection.js +99 -132
  336. package/es/internal/clamp.js +12 -4
  337. package/es/internal/defaultItemToString.js +15 -9
  338. package/es/internal/deprecateFieldOnObject.js +22 -14
  339. package/es/internal/environment.js +15 -7
  340. package/es/internal/getAnnouncement.js +16 -13
  341. package/es/internal/keyboard/keys.js +48 -48
  342. package/es/internal/keyboard/match.js +25 -42
  343. package/es/internal/keyboard/navigation.js +22 -27
  344. package/es/internal/noopFn.js +10 -2
  345. package/es/internal/useAttachedMenu.js +43 -51
  346. package/es/internal/useControllableState.js +43 -48
  347. package/es/internal/useDelayedState.js +30 -35
  348. package/es/internal/useEvent.js +39 -35
  349. package/es/internal/useId.js +51 -87
  350. package/es/internal/useIdPrefix.js +13 -5
  351. package/es/internal/useIsomorphicEffect.js +12 -4
  352. package/es/internal/useMatchMedia.js +29 -21
  353. package/es/internal/useMergedRefs.js +26 -22
  354. package/es/internal/useNoInteractiveChildren.js +70 -99
  355. package/es/internal/useNormalizedInputProps.js +47 -51
  356. package/es/internal/useOutsideClick.js +21 -24
  357. package/es/internal/useOverflowItems.js +89 -90
  358. package/es/internal/usePrefix.js +13 -5
  359. package/es/internal/usePresence.js +51 -54
  360. package/es/internal/usePresenceContext.js +35 -35
  361. package/es/internal/usePreviousValue.js +26 -18
  362. package/es/internal/useResizeObserver.js +57 -66
  363. package/es/internal/useSavedCallback.js +24 -17
  364. package/es/internal/utils.js +17 -9
  365. package/es/internal/warning.js +17 -22
  366. package/es/internal/wrapFocus.js +77 -98
  367. package/es/prop-types/AriaPropTypes.js +14 -6
  368. package/es/prop-types/deprecate.js +30 -27
  369. package/es/prop-types/deprecateComponent.js +17 -8
  370. package/es/prop-types/deprecateValuesWithin.js +18 -21
  371. package/es/prop-types/isRequiredOneOf.js +21 -24
  372. package/es/prop-types/requiredIfGivenPropIsTruthy.js +14 -14
  373. package/es/tools/events.js +17 -21
  374. package/es/tools/mapPopoverAlign.js +19 -18
  375. package/es/tools/mergeRefs.js +14 -17
  376. package/es/tools/setupGetInstanceId.js +16 -8
  377. package/es/tools/toggleClass.js +17 -9
  378. package/es/tools/wrapComponent.js +34 -39
  379. package/icons/index.d.ts +2 -1
  380. package/icons/index.esm.js +2 -2
  381. package/icons/index.js +7 -10
  382. package/lib/_virtual/_rolldown/runtime.js +50 -0
  383. package/lib/components/AILabel/index.d.ts +29 -2
  384. package/lib/components/AILabel/index.js +118 -171
  385. package/lib/components/AISkeleton/AISkeletonIcon.js +27 -31
  386. package/lib/components/AISkeleton/AISkeletonPlaceholder.js +29 -31
  387. package/lib/components/AISkeleton/AISkeletonText.js +30 -43
  388. package/lib/components/Accordion/Accordion.Skeleton.js +59 -84
  389. package/lib/components/Accordion/Accordion.js +47 -65
  390. package/lib/components/Accordion/AccordionItem.js +106 -160
  391. package/lib/components/Accordion/AccordionProvider.js +20 -17
  392. package/lib/components/AspectRatio/AspectRatio.js +45 -51
  393. package/lib/components/BadgeIndicator/index.js +33 -39
  394. package/lib/components/Breadcrumb/Breadcrumb.Skeleton.js +43 -55
  395. package/lib/components/Breadcrumb/Breadcrumb.js +43 -55
  396. package/lib/components/Breadcrumb/BreadcrumbItem.js +84 -87
  397. package/lib/components/Button/Button.Skeleton.js +53 -63
  398. package/lib/components/Button/Button.d.ts +1 -1
  399. package/lib/components/Button/Button.js +149 -244
  400. package/lib/components/Button/ButtonBase.js +85 -108
  401. package/lib/components/Button/index.js +13 -15
  402. package/lib/components/ButtonSet/ButtonSet.js +78 -102
  403. package/lib/components/ButtonSet/index.js +12 -9
  404. package/lib/components/ChatButton/ChatButton.Skeleton.js +31 -31
  405. package/lib/components/ChatButton/ChatButton.js +68 -83
  406. package/lib/components/Checkbox/Checkbox.Skeleton.js +30 -30
  407. package/lib/components/Checkbox/Checkbox.js +119 -198
  408. package/lib/components/Checkbox/index.js +13 -11
  409. package/lib/components/CheckboxGroup/CheckboxGroup.js +104 -152
  410. package/lib/components/ClassPrefix/index.js +24 -19
  411. package/lib/components/CodeSnippet/CodeSnippet.Skeleton.js +49 -47
  412. package/lib/components/CodeSnippet/CodeSnippet.js +215 -303
  413. package/lib/components/ComboBox/ComboBox.js +626 -974
  414. package/lib/components/ComboBox/index.js +12 -9
  415. package/lib/components/ComboButton/index.js +176 -210
  416. package/lib/components/ComposedModal/ComposedModal.js +315 -454
  417. package/lib/components/ComposedModal/ComposedModalPresence.js +49 -44
  418. package/lib/components/ComposedModal/ModalFooter.js +131 -209
  419. package/lib/components/ComposedModal/ModalHeader.js +75 -103
  420. package/lib/components/ComposedModal/useComposedModalState.js +22 -17
  421. package/lib/components/ContainedList/ContainedList.js +77 -106
  422. package/lib/components/ContainedList/ContainedListItem/ContainedListItem.js +59 -71
  423. package/lib/components/ContainedList/ContainedListItem/index.js +12 -9
  424. package/lib/components/ContainedList/index.js +18 -15
  425. package/lib/components/ContentSwitcher/ContentSwitcher.js +112 -142
  426. package/lib/components/ContextMenu/useContextMenu.js +42 -40
  427. package/lib/components/Copy/Copy.js +101 -121
  428. package/lib/components/Copy/index.js +12 -9
  429. package/lib/components/CopyButton/CopyButton.js +85 -98
  430. package/lib/components/CopyButton/index.js +12 -9
  431. package/lib/components/DangerButton/DangerButton.js +19 -13
  432. package/lib/components/DataTable/DataTable.d.ts +11 -11
  433. package/lib/components/DataTable/DataTable.js +474 -655
  434. package/lib/components/DataTable/Table.js +115 -161
  435. package/lib/components/DataTable/TableActionList.js +15 -11
  436. package/lib/components/DataTable/TableBatchAction.js +28 -38
  437. package/lib/components/DataTable/TableBatchActions.js +82 -117
  438. package/lib/components/DataTable/TableBody.js +29 -23
  439. package/lib/components/DataTable/TableCell.js +35 -50
  440. package/lib/components/DataTable/TableContainer.js +79 -86
  441. package/lib/components/DataTable/TableContext.js +15 -8
  442. package/lib/components/DataTable/TableDecoratorRow.js +34 -40
  443. package/lib/components/DataTable/TableExpandHeader.js +57 -94
  444. package/lib/components/DataTable/TableExpandRow.js +86 -123
  445. package/lib/components/DataTable/TableExpandedRow.js +49 -55
  446. package/lib/components/DataTable/TableHead.js +8 -10
  447. package/lib/components/DataTable/TableHeader.js +142 -185
  448. package/lib/components/DataTable/TableRow.d.ts +1 -1
  449. package/lib/components/DataTable/TableRow.js +46 -80
  450. package/lib/components/DataTable/TableSelectAll.js +46 -74
  451. package/lib/components/DataTable/TableSelectRow.js +67 -102
  452. package/lib/components/DataTable/TableSlugRow.js +39 -47
  453. package/lib/components/DataTable/TableToolbar.js +37 -49
  454. package/lib/components/DataTable/TableToolbarAction.js +28 -24
  455. package/lib/components/DataTable/TableToolbarContent.js +15 -11
  456. package/lib/components/DataTable/TableToolbarMenu.js +39 -50
  457. package/lib/components/DataTable/TableToolbarSearch.js +101 -191
  458. package/lib/components/DataTable/state/getDerivedStateFromProps.js +38 -47
  459. package/lib/components/DataTable/state/sortStates.js +11 -10
  460. package/lib/components/DataTable/state/sorting.js +54 -76
  461. package/lib/components/DataTable/tools/cells.js +15 -8
  462. package/lib/components/DataTable/tools/denormalize.js +27 -22
  463. package/lib/components/DataTable/tools/filter.js +21 -23
  464. package/lib/components/DataTable/tools/normalize.js +57 -76
  465. package/lib/components/DataTable/tools/sorting.js +50 -75
  466. package/lib/components/DataTableSkeleton/DataTableSkeleton.js +70 -98
  467. package/lib/components/DatePicker/DatePicker.Skeleton.js +48 -56
  468. package/lib/components/DatePicker/DatePicker.js +491 -756
  469. package/lib/components/DatePicker/DatePickerLocales.js +75 -127
  470. package/lib/components/DatePicker/index.js +13 -11
  471. package/lib/components/DatePicker/plugins/appendToPlugin.js +31 -46
  472. package/lib/components/DatePicker/plugins/fixEventsPlugin.js +127 -175
  473. package/lib/components/DatePicker/plugins/rangePlugin.js +42 -50
  474. package/lib/components/DatePicker/utils.js +11 -4
  475. package/lib/components/DatePickerInput/DatePickerInput.js +183 -293
  476. package/lib/components/DatePickerInput/index.js +12 -9
  477. package/lib/components/Dialog/Dialog.js +307 -576
  478. package/lib/components/Dialog/index.js +21 -13
  479. package/lib/components/Dropdown/Dropdown.Skeleton.js +30 -43
  480. package/lib/components/Dropdown/Dropdown.js +348 -539
  481. package/lib/components/Dropdown/index.js +13 -11
  482. package/lib/components/ErrorBoundary/ErrorBoundary.js +39 -62
  483. package/lib/components/ErrorBoundary/ErrorBoundaryContext.js +15 -11
  484. package/lib/components/ExpandableSearch/ExpandableSearch.js +63 -73
  485. package/lib/components/ExpandableSearch/index.js +12 -9
  486. package/lib/components/FeatureFlags/index.d.ts +11 -2
  487. package/lib/components/FeatureFlags/index.js +82 -79
  488. package/lib/components/FileUploader/FileUploader.Skeleton.js +39 -35
  489. package/lib/components/FileUploader/FileUploader.js +273 -347
  490. package/lib/components/FileUploader/FileUploaderButton.js +114 -164
  491. package/lib/components/FileUploader/FileUploaderDropContainer.js +148 -225
  492. package/lib/components/FileUploader/FileUploaderItem.js +142 -161
  493. package/lib/components/FileUploader/Filename.d.ts +1 -1
  494. package/lib/components/FileUploader/Filename.js +56 -76
  495. package/lib/components/FluidComboBox/FluidComboBox.Skeleton.js +30 -32
  496. package/lib/components/FluidComboBox/FluidComboBox.js +58 -109
  497. package/lib/components/FluidDatePicker/FluidDatePicker.Skeleton.js +60 -57
  498. package/lib/components/FluidDatePicker/FluidDatePicker.js +50 -72
  499. package/lib/components/FluidDatePickerInput/FluidDatePickerInput.js +25 -20
  500. package/lib/components/FluidDropdown/FluidDropdown.Skeleton.js +30 -32
  501. package/lib/components/FluidDropdown/FluidDropdown.js +59 -115
  502. package/lib/components/FluidForm/FluidForm.js +33 -35
  503. package/lib/components/FluidForm/FormContext.js +13 -8
  504. package/lib/components/FluidMultiSelect/FluidMultiSelect.Skeleton.js +30 -32
  505. package/lib/components/FluidMultiSelect/FluidMultiSelect.js +71 -201
  506. package/lib/components/FluidNumberInput/FluidNumberInput.Skeleton.js +31 -34
  507. package/lib/components/FluidNumberInput/FluidNumberInput.js +67 -151
  508. package/lib/components/FluidSearch/FluidSearch.Skeleton.js +31 -34
  509. package/lib/components/FluidSearch/FluidSearch.js +45 -88
  510. package/lib/components/FluidSelect/FluidSelect.Skeleton.js +30 -32
  511. package/lib/components/FluidSelect/FluidSelect.js +44 -80
  512. package/lib/components/FluidSelect/index.js +13 -11
  513. package/lib/components/FluidTextArea/FluidTextArea.Skeleton.js +31 -34
  514. package/lib/components/FluidTextArea/FluidTextArea.js +52 -116
  515. package/lib/components/FluidTextInput/FluidPasswordInput.js +48 -103
  516. package/lib/components/FluidTextInput/FluidTextInput.Skeleton.js +31 -34
  517. package/lib/components/FluidTextInput/FluidTextInput.js +53 -108
  518. package/lib/components/FluidTextInput/index.js +14 -13
  519. package/lib/components/FluidTimePicker/FluidTimePicker.Skeleton.js +34 -37
  520. package/lib/components/FluidTimePicker/FluidTimePicker.js +72 -119
  521. package/lib/components/FluidTimePickerSelect/FluidTimePickerSelect.js +31 -51
  522. package/lib/components/Form/Form.js +27 -29
  523. package/lib/components/FormGroup/FormGroup.js +49 -71
  524. package/lib/components/FormItem/FormItem.js +27 -29
  525. package/lib/components/FormLabel/FormLabel.js +32 -38
  526. package/lib/components/Grid/CSSGrid.d.ts +1 -1
  527. package/lib/components/Grid/CSSGrid.js +89 -129
  528. package/lib/components/Grid/Column.js +196 -328
  529. package/lib/components/Grid/ColumnHang.js +32 -38
  530. package/lib/components/Grid/FlexGrid.js +44 -62
  531. package/lib/components/Grid/Grid.js +32 -44
  532. package/lib/components/Grid/GridContext.js +39 -44
  533. package/lib/components/Grid/Row.js +35 -53
  534. package/lib/components/Heading/index.js +39 -53
  535. package/lib/components/Icon/Icon.Skeleton.js +25 -23
  536. package/lib/components/IconButton/index.js +121 -180
  537. package/lib/components/IconIndicator/index.d.ts +1 -1
  538. package/lib/components/IconIndicator/index.js +63 -63
  539. package/lib/components/IdPrefix/index.js +24 -19
  540. package/lib/components/InlineCheckbox/InlineCheckbox.js +72 -117
  541. package/lib/components/InlineCheckbox/index.js +12 -9
  542. package/lib/components/InlineLoading/InlineLoading.js +87 -104
  543. package/lib/components/InlineLoading/index.js +12 -9
  544. package/lib/components/Layer/LayerContext.js +14 -6
  545. package/lib/components/Layer/LayerLevel.js +20 -6
  546. package/lib/components/Layer/index.js +58 -68
  547. package/lib/components/Layout/index.js +81 -111
  548. package/lib/components/LayoutDirection/LayoutDirection.d.ts +1 -1
  549. package/lib/components/LayoutDirection/LayoutDirection.js +36 -40
  550. package/lib/components/LayoutDirection/LayoutDirectionContext.js +14 -8
  551. package/lib/components/LayoutDirection/useLayoutDirection.js +16 -9
  552. package/lib/components/Link/Link.js +67 -112
  553. package/lib/components/Link/index.js +12 -9
  554. package/lib/components/ListBox/ListBox.js +82 -130
  555. package/lib/components/ListBox/ListBoxField.js +33 -47
  556. package/lib/components/ListBox/ListBoxMenu.js +39 -46
  557. package/lib/components/ListBox/ListBoxMenuIcon.js +43 -44
  558. package/lib/components/ListBox/ListBoxMenuItem.js +71 -92
  559. package/lib/components/ListBox/ListBoxPropTypes.js +21 -9
  560. package/lib/components/ListBox/ListBoxSelection.js +75 -100
  561. package/lib/components/ListBox/index.js +17 -21
  562. package/lib/components/ListBox/next/ListBoxSelection.js +83 -121
  563. package/lib/components/ListBox/next/ListBoxTrigger.js +48 -52
  564. package/lib/components/ListItem/ListItem.js +29 -32
  565. package/lib/components/Loading/Loading.js +68 -77
  566. package/lib/components/Loading/index.js +12 -9
  567. package/lib/components/Menu/Menu.js +224 -365
  568. package/lib/components/Menu/MenuContext.d.ts +1 -1
  569. package/lib/components/Menu/MenuContext.js +42 -40
  570. package/lib/components/Menu/MenuItem.js +286 -415
  571. package/lib/components/MenuButton/index.js +138 -197
  572. package/lib/components/Modal/Modal.js +504 -665
  573. package/lib/components/Modal/ModalPresence.js +41 -39
  574. package/lib/components/Modal/index.js +13 -10
  575. package/lib/components/ModalWrapper/ModalWrapper.d.ts +2 -2
  576. package/lib/components/ModalWrapper/ModalWrapper.js +112 -134
  577. package/lib/components/MultiSelect/FilterableMultiSelect.js +611 -920
  578. package/lib/components/MultiSelect/MultiSelect.js +459 -718
  579. package/lib/components/MultiSelect/MultiSelectPropTypes.js +15 -32
  580. package/lib/components/MultiSelect/filter.js +14 -10
  581. package/lib/components/MultiSelect/tools/sorting.js +21 -35
  582. package/lib/components/Notification/Notification.js +514 -787
  583. package/lib/components/NumberInput/NumberFormatPropTypes.js +72 -33
  584. package/lib/components/NumberInput/NumberInput.Skeleton.js +33 -37
  585. package/lib/components/NumberInput/NumberInput.js +569 -950
  586. package/lib/components/OrderedList/OrderedList.js +35 -48
  587. package/lib/components/OverflowMenu/OverflowMenu.js +341 -454
  588. package/lib/components/OverflowMenu/index.js +27 -21
  589. package/lib/components/OverflowMenu/next/index.js +158 -188
  590. package/lib/components/OverflowMenuItem/OverflowMenuItem.js +104 -164
  591. package/lib/components/OverflowMenuItem/index.js +12 -9
  592. package/lib/components/OverflowMenuV2/index.js +25 -15
  593. package/lib/components/PageHeader/PageHeader.js +301 -444
  594. package/lib/components/PageHeader/index.js +27 -19
  595. package/lib/components/Pagination/Pagination.Skeleton.js +38 -37
  596. package/lib/components/Pagination/Pagination.d.ts +1 -1
  597. package/lib/components/Pagination/Pagination.js +256 -360
  598. package/lib/components/Pagination/experimental/PageSelector.js +48 -58
  599. package/lib/components/Pagination/experimental/Pagination-story.d.ts +114 -0
  600. package/lib/components/Pagination/experimental/Pagination.js +148 -200
  601. package/lib/components/PaginationNav/PaginationNav.js +324 -430
  602. package/lib/components/Popover/index.js +323 -440
  603. package/lib/components/PrimaryButton/PrimaryButton.js +19 -13
  604. package/lib/components/ProgressBar/ProgressBar.js +121 -147
  605. package/lib/components/ProgressIndicator/ProgressIndicator.Skeleton.js +46 -43
  606. package/lib/components/ProgressIndicator/ProgressIndicator.js +150 -245
  607. package/lib/components/RadioButton/RadioButton.Skeleton.js +27 -27
  608. package/lib/components/RadioButton/RadioButton.js +105 -178
  609. package/lib/components/RadioButton/index.js +12 -9
  610. package/lib/components/RadioButtonGroup/RadioButtonGroup.js +139 -211
  611. package/lib/components/RadioTile/RadioTile.js +108 -172
  612. package/lib/components/RadioTile/index.js +12 -9
  613. package/lib/components/Search/Search.Skeleton.js +32 -38
  614. package/lib/components/Search/Search.js +185 -281
  615. package/lib/components/Search/index.js +13 -11
  616. package/lib/components/Search/utils.js +11 -4
  617. package/lib/components/SecondaryButton/SecondaryButton.js +19 -13
  618. package/lib/components/Select/Select.Skeleton.js +31 -35
  619. package/lib/components/Select/Select.js +182 -261
  620. package/lib/components/Select/index.js +13 -11
  621. package/lib/components/SelectItem/SelectItem.js +37 -52
  622. package/lib/components/SelectItem/index.js +12 -9
  623. package/lib/components/SelectItemGroup/SelectItemGroup.js +31 -41
  624. package/lib/components/ShapeIndicator/index.d.ts +1 -1
  625. package/lib/components/ShapeIndicator/index.js +78 -83
  626. package/lib/components/SkeletonIcon/SkeletonIcon.js +25 -28
  627. package/lib/components/SkeletonPlaceholder/SkeletonPlaceholder.js +25 -28
  628. package/lib/components/SkeletonText/SkeletonText.js +71 -85
  629. package/lib/components/SkeletonText/index.js +12 -9
  630. package/lib/components/Slider/Slider.Skeleton.js +72 -95
  631. package/lib/components/Slider/Slider.js +868 -1319
  632. package/lib/components/Slider/SliderHandles.js +75 -68
  633. package/lib/components/Stack/HStack.js +22 -14
  634. package/lib/components/Stack/Stack.js +60 -82
  635. package/lib/components/Stack/VStack.js +22 -14
  636. package/lib/components/StructuredList/StructuredList.Skeleton.js +59 -52
  637. package/lib/components/StructuredList/StructuredList.js +182 -319
  638. package/lib/components/Switch/IconSwitch.js +103 -149
  639. package/lib/components/Switch/Switch.js +70 -103
  640. package/lib/components/TabContent/TabContent.js +32 -38
  641. package/lib/components/Tabs/Tabs.Skeleton.js +45 -41
  642. package/lib/components/Tabs/Tabs.js +738 -1153
  643. package/lib/components/Tabs/usePressable.js +98 -114
  644. package/lib/components/Tag/DismissibleTag.js +123 -160
  645. package/lib/components/Tag/OperationalTag.js +95 -115
  646. package/lib/components/Tag/SelectableTag.js +98 -133
  647. package/lib/components/Tag/Tag.Skeleton.js +30 -32
  648. package/lib/components/Tag/Tag.js +156 -204
  649. package/lib/components/Tag/isEllipsisActive.js +13 -9
  650. package/lib/components/Text/Text.js +69 -81
  651. package/lib/components/Text/TextDirection.js +39 -39
  652. package/lib/components/Text/TextDirectionContext.js +15 -10
  653. package/lib/components/Text/createTextComponent.js +29 -22
  654. package/lib/components/TextArea/TextArea.Skeleton.js +29 -34
  655. package/lib/components/TextArea/TextArea.js +319 -426
  656. package/lib/components/TextArea/index.js +13 -11
  657. package/lib/components/TextInput/ControlledPasswordInput.js +137 -202
  658. package/lib/components/TextInput/PasswordInput.js +200 -307
  659. package/lib/components/TextInput/TextInput.Skeleton.js +28 -33
  660. package/lib/components/TextInput/TextInput.js +223 -321
  661. package/lib/components/TextInput/index.js +13 -11
  662. package/lib/components/TextInput/util.js +21 -26
  663. package/lib/components/Theme/index.js +83 -97
  664. package/lib/components/Tile/Tile.js +398 -595
  665. package/lib/components/TileGroup/TileGroup.js +73 -113
  666. package/lib/components/TimePicker/TimePicker.d.ts +1 -1
  667. package/lib/components/TimePicker/TimePicker.js +152 -251
  668. package/lib/components/TimePickerSelect/TimePickerSelect.js +47 -62
  669. package/lib/components/Toggle/Toggle.Skeleton.js +28 -24
  670. package/lib/components/Toggle/Toggle.js +106 -176
  671. package/lib/components/ToggleSmall/ToggleSmall.Skeleton.js +50 -53
  672. package/lib/components/Toggletip/index.d.ts +2 -2
  673. package/lib/components/Toggletip/index.js +174 -258
  674. package/lib/components/Tooltip/DefinitionTooltip.js +102 -140
  675. package/lib/components/Tooltip/Tooltip.js +192 -265
  676. package/lib/components/TreeView/TreeContext.js +14 -7
  677. package/lib/components/TreeView/TreeNode.js +365 -504
  678. package/lib/components/TreeView/TreeView.js +169 -242
  679. package/lib/components/UIShell/Content.js +27 -34
  680. package/lib/components/UIShell/Header.js +29 -33
  681. package/lib/components/UIShell/HeaderContainer.js +34 -44
  682. package/lib/components/UIShell/HeaderGlobalAction.js +69 -94
  683. package/lib/components/UIShell/HeaderGlobalBar.js +17 -14
  684. package/lib/components/UIShell/HeaderMenu.js +146 -221
  685. package/lib/components/UIShell/HeaderMenuButton.js +47 -70
  686. package/lib/components/UIShell/HeaderMenuItem.js +53 -80
  687. package/lib/components/UIShell/HeaderName.js +36 -48
  688. package/lib/components/UIShell/HeaderNavigation.js +36 -41
  689. package/lib/components/UIShell/HeaderPanel.js +78 -101
  690. package/lib/components/UIShell/HeaderSideNavItems.js +31 -37
  691. package/lib/components/UIShell/Link.js +32 -54
  692. package/lib/components/UIShell/SideNav.js +136 -245
  693. package/lib/components/UIShell/SideNavContext.js +23 -17
  694. package/lib/components/UIShell/SideNavDetails.js +33 -38
  695. package/lib/components/UIShell/SideNavDivider.js +25 -25
  696. package/lib/components/UIShell/SideNavFooter.js +47 -56
  697. package/lib/components/UIShell/SideNavHeader.js +30 -39
  698. package/lib/components/UIShell/SideNavIcon.js +32 -37
  699. package/lib/components/UIShell/SideNavItem.js +32 -37
  700. package/lib/components/UIShell/SideNavItems.js +35 -44
  701. package/lib/components/UIShell/SideNavLink.js +56 -83
  702. package/lib/components/UIShell/SideNavLinkText.js +28 -29
  703. package/lib/components/UIShell/SideNavMenu.js +106 -148
  704. package/lib/components/UIShell/SideNavMenuItem.js +44 -56
  705. package/lib/components/UIShell/SideNavSwitcher.js +63 -72
  706. package/lib/components/UIShell/SkipToContent.js +32 -40
  707. package/lib/components/UIShell/Switcher.js +73 -103
  708. package/lib/components/UIShell/SwitcherDivider.js +26 -28
  709. package/lib/components/UIShell/SwitcherItem.js +78 -118
  710. package/lib/components/UnorderedList/UnorderedList.js +32 -41
  711. package/lib/feature-flags.js +21 -13
  712. package/lib/index.js +622 -602
  713. package/lib/internal/FloatingMenu.js +249 -296
  714. package/lib/internal/OptimizedResize.js +35 -47
  715. package/lib/internal/Selection.js +102 -134
  716. package/lib/internal/clamp.js +12 -5
  717. package/lib/internal/defaultItemToString.js +15 -10
  718. package/lib/internal/deprecateFieldOnObject.js +23 -16
  719. package/lib/internal/environment.js +15 -8
  720. package/lib/internal/getAnnouncement.js +16 -14
  721. package/lib/internal/keyboard/keys.js +48 -49
  722. package/lib/internal/keyboard/match.js +25 -43
  723. package/lib/internal/keyboard/navigation.js +22 -29
  724. package/lib/internal/noopFn.js +10 -3
  725. package/lib/internal/useAttachedMenu.js +44 -53
  726. package/lib/internal/useControllableState.js +44 -50
  727. package/lib/internal/useDelayedState.js +31 -37
  728. package/lib/internal/useEvent.js +40 -37
  729. package/lib/internal/useId.js +54 -91
  730. package/lib/internal/useIdPrefix.js +15 -7
  731. package/lib/internal/useIsomorphicEffect.js +13 -8
  732. package/lib/internal/useMatchMedia.js +30 -23
  733. package/lib/internal/useMergedRefs.js +27 -24
  734. package/lib/internal/useNoInteractiveChildren.js +73 -101
  735. package/lib/internal/useNormalizedInputProps.js +55 -53
  736. package/lib/internal/useOutsideClick.js +22 -26
  737. package/lib/internal/useOverflowItems.js +90 -94
  738. package/lib/internal/usePrefix.js +15 -7
  739. package/lib/internal/usePresence.js +52 -56
  740. package/lib/internal/usePresenceContext.js +36 -37
  741. package/lib/internal/usePreviousValue.js +27 -20
  742. package/lib/internal/useResizeObserver.js +58 -68
  743. package/lib/internal/useSavedCallback.js +25 -19
  744. package/lib/internal/utils.js +18 -11
  745. package/lib/internal/warning.js +24 -23
  746. package/lib/internal/wrapFocus.js +78 -100
  747. package/lib/prop-types/AriaPropTypes.js +17 -9
  748. package/lib/prop-types/deprecate.js +30 -29
  749. package/lib/prop-types/deprecateComponent.js +17 -10
  750. package/lib/prop-types/deprecateValuesWithin.js +18 -23
  751. package/lib/prop-types/isRequiredOneOf.js +21 -25
  752. package/lib/prop-types/requiredIfGivenPropIsTruthy.js +14 -15
  753. package/lib/tools/events.js +17 -22
  754. package/lib/tools/mapPopoverAlign.js +19 -19
  755. package/lib/tools/mergeRefs.js +14 -18
  756. package/lib/tools/setupGetInstanceId.js +16 -9
  757. package/lib/tools/toggleClass.js +17 -10
  758. package/lib/tools/wrapComponent.js +38 -43
  759. package/package.json +10 -16
  760. package/es/_virtual/_rollupPluginBabelHelpers.js +0 -40
  761. package/es/components/DataTable/stories/examples/TableToolbarFilter.d.ts +0 -54
  762. package/es/node_modules/es-toolkit/dist/compat/function/debounce.js +0 -55
  763. package/es/node_modules/es-toolkit/dist/compat/function/throttle.js +0 -23
  764. package/es/node_modules/es-toolkit/dist/function/debounce.js +0 -70
  765. package/lib/_virtual/_rollupPluginBabelHelpers.js +0 -45
  766. package/lib/components/DataTable/stories/examples/TableToolbarFilter.d.ts +0 -54
  767. package/lib/node_modules/es-toolkit/dist/compat/function/debounce.js +0 -57
  768. package/lib/node_modules/es-toolkit/dist/compat/function/throttle.js +0 -25
  769. 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 };