@carbon/react 1.103.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 (769) hide show
  1. package/.playwright/INTERNAL_AVT_REPORT_DO_NOT_USE.json +956 -956
  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 +567 -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 +571 -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,455 +1,349 @@
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 PropTypes from 'prop-types';
10
- import React, { useState, useEffect, useRef } from 'react';
11
- import cx from 'classnames';
12
- import { CaretRight, CaretLeft, OverflowMenuHorizontal } from '@carbon/icons-react';
13
- import { IconButton } from '../IconButton/index.js';
14
- import { usePrefix } from '../../internal/usePrefix.js';
15
- import { breakpoints } from '@carbon/layout';
16
- import { useMatchMedia } from '../../internal/useMatchMedia.js';
17
- import { clamp } from '../../internal/clamp.js';
8
+ import { usePrefix } from "../../internal/usePrefix.js";
9
+ import { IconButton } from "../IconButton/index.js";
10
+ import { clamp } from "../../internal/clamp.js";
11
+ import { useMatchMedia } from "../../internal/useMatchMedia.js";
12
+ import classNames from "classnames";
13
+ import React, { useEffect, useRef, useState } from "react";
14
+ import PropTypes from "prop-types";
15
+ import { jsx, jsxs } from "react/jsx-runtime";
16
+ import { CaretLeft, CaretRight, OverflowMenuHorizontal } from "@carbon/icons-react";
17
+ import { breakpoints } from "@carbon/layout";
18
18
 
19
- var _CaretRight, _CaretLeft, _option;
19
+ //#region src/components/PaginationNav/PaginationNav.tsx
20
+ /**
21
+ * Copyright IBM Corp. 2020, 2025
22
+ *
23
+ * This source code is licensed under the Apache-2.0 license found in the
24
+ * LICENSE file in the root directory of this source tree.
25
+ */
20
26
  const translationIds = {
21
- 'carbon.pagination-nav.next': 'carbon.pagination-nav.next',
22
- 'carbon.pagination-nav.previous': 'carbon.pagination-nav.previous',
23
- 'carbon.pagination-nav.item': 'carbon.pagination-nav.item',
24
- 'carbon.pagination-nav.active': 'carbon.pagination-nav.active',
25
- 'carbon.pagination-nav.of': 'carbon.pagination-nav.of'
27
+ "carbon.pagination-nav.next": "carbon.pagination-nav.next",
28
+ "carbon.pagination-nav.previous": "carbon.pagination-nav.previous",
29
+ "carbon.pagination-nav.item": "carbon.pagination-nav.item",
30
+ "carbon.pagination-nav.active": "carbon.pagination-nav.active",
31
+ "carbon.pagination-nav.of": "carbon.pagination-nav.of"
26
32
  };
27
33
  const defaultTranslations = {
28
- [translationIds['carbon.pagination-nav.next']]: 'Next',
29
- [translationIds['carbon.pagination-nav.previous']]: 'Previous',
30
- [translationIds['carbon.pagination-nav.item']]: 'Page',
31
- [translationIds['carbon.pagination-nav.active']]: 'Active',
32
- [translationIds['carbon.pagination-nav.of']]: 'of'
34
+ [translationIds["carbon.pagination-nav.next"]]: "Next",
35
+ [translationIds["carbon.pagination-nav.previous"]]: "Previous",
36
+ [translationIds["carbon.pagination-nav.item"]]: "Page",
37
+ [translationIds["carbon.pagination-nav.active"]]: "Active",
38
+ [translationIds["carbon.pagination-nav.of"]]: "of"
33
39
  };
34
- const defaultTranslateWithId = messageId => {
35
- return defaultTranslations[messageId];
40
+ const defaultTranslateWithId = (messageId) => {
41
+ return defaultTranslations[messageId];
36
42
  };
37
-
38
- // https://reactjs.org/docs/hooks-faq.html#how-to-get-the-previous-props-or-state
39
43
  function usePrevious(value) {
40
- const ref = useRef(null);
41
- useEffect(() => {
42
- ref.current = value;
43
- });
44
- return ref.current;
44
+ const ref = useRef(null);
45
+ useEffect(() => {
46
+ ref.current = value;
47
+ });
48
+ return ref.current;
45
49
  }
46
50
  function calculateCuts(page, totalItems, itemsDisplayedOnPage, splitPoint = null) {
47
- if (itemsDisplayedOnPage >= totalItems) {
48
- return {
49
- front: 0,
50
- back: 0
51
- };
52
- }
53
- const split = splitPoint || Math.ceil(itemsDisplayedOnPage / 2) - 1;
54
- let frontHidden = page + 1 - split;
55
- let backHidden = totalItems - page - (itemsDisplayedOnPage - split) + 1;
56
- if (frontHidden <= 1) {
57
- backHidden -= frontHidden <= 0 ? Math.abs(frontHidden) + 1 : 0;
58
- frontHidden = 0;
59
- }
60
- if (backHidden <= 1) {
61
- frontHidden -= backHidden <= 0 ? Math.abs(backHidden) + 1 : 0;
62
- backHidden = 0;
63
- }
64
- return {
65
- front: frontHidden,
66
- back: backHidden
67
- };
51
+ if (itemsDisplayedOnPage >= totalItems) return {
52
+ front: 0,
53
+ back: 0
54
+ };
55
+ const split = splitPoint || Math.ceil(itemsDisplayedOnPage / 2) - 1;
56
+ let frontHidden = page + 1 - split;
57
+ let backHidden = totalItems - page - (itemsDisplayedOnPage - split) + 1;
58
+ if (frontHidden <= 1) {
59
+ backHidden -= frontHidden <= 0 ? Math.abs(frontHidden) + 1 : 0;
60
+ frontHidden = 0;
61
+ }
62
+ if (backHidden <= 1) {
63
+ frontHidden -= backHidden <= 0 ? Math.abs(backHidden) + 1 : 0;
64
+ backHidden = 0;
65
+ }
66
+ return {
67
+ front: frontHidden,
68
+ back: backHidden
69
+ };
68
70
  }
69
- function DirectionButton({
70
- direction,
71
- label,
72
- disabled,
73
- onClick,
74
- tooltipAlignment = 'center',
75
- tooltipPosition = 'bottom'
76
- }) {
77
- const prefix = usePrefix();
78
- const align = tooltipAlignment === 'center' ? tooltipPosition : `${tooltipPosition}-${tooltipAlignment}`;
79
- return /*#__PURE__*/React.createElement("li", {
80
- className: `${prefix}--pagination-nav__list-item`
81
- }, /*#__PURE__*/React.createElement(IconButton, {
82
- align: align,
83
- disabled: disabled,
84
- kind: "ghost",
85
- label: label,
86
- onClick: onClick
87
- }, direction === 'forward' ? _CaretRight || (_CaretRight = /*#__PURE__*/React.createElement(CaretRight, null)) : _CaretLeft || (_CaretLeft = /*#__PURE__*/React.createElement(CaretLeft, null))));
71
+ function DirectionButton({ direction, label, disabled, onClick, tooltipAlignment = "center", tooltipPosition = "bottom" }) {
72
+ const prefix = usePrefix();
73
+ const align = tooltipAlignment === "center" ? tooltipPosition : `${tooltipPosition}-${tooltipAlignment}`;
74
+ return /* @__PURE__ */ jsx("li", {
75
+ className: `${prefix}--pagination-nav__list-item`,
76
+ children: /* @__PURE__ */ jsx(IconButton, {
77
+ align,
78
+ disabled,
79
+ kind: "ghost",
80
+ label,
81
+ onClick,
82
+ children: direction === "forward" ? /* @__PURE__ */ jsx(CaretRight, {}) : /* @__PURE__ */ jsx(CaretLeft, {})
83
+ })
84
+ });
88
85
  }
89
- function PaginationItem({
90
- page,
91
- isActive,
92
- onClick,
93
- translateWithId: t = defaultTranslateWithId
94
- }) {
95
- const prefix = usePrefix();
96
- const itemLabel = t('carbon.pagination-nav.item');
97
- return /*#__PURE__*/React.createElement("li", {
98
- className: `${prefix}--pagination-nav__list-item`
99
- }, /*#__PURE__*/React.createElement("button", {
100
- type: "button",
101
- className: cx(`${prefix}--pagination-nav__page`, {
102
- [`${prefix}--pagination-nav__page--active`]: isActive
103
- }),
104
- onClick: onClick,
105
- "data-page": page,
106
- "aria-current": isActive ? 'page' : undefined
107
- }, /*#__PURE__*/React.createElement("span", {
108
- className: `${prefix}--pagination-nav__accessibility-label`
109
- }, isActive ? `${t('carbon.pagination-nav.active')}, ${itemLabel}` : itemLabel), page));
86
+ function PaginationItem({ page, isActive, onClick, translateWithId: t = defaultTranslateWithId }) {
87
+ const prefix = usePrefix();
88
+ const itemLabel = t("carbon.pagination-nav.item");
89
+ return /* @__PURE__ */ jsx("li", {
90
+ className: `${prefix}--pagination-nav__list-item`,
91
+ children: /* @__PURE__ */ jsxs("button", {
92
+ type: "button",
93
+ className: classNames(`${prefix}--pagination-nav__page`, { [`${prefix}--pagination-nav__page--active`]: isActive }),
94
+ onClick,
95
+ "data-page": page,
96
+ "aria-current": isActive ? "page" : void 0,
97
+ children: [/* @__PURE__ */ jsx("span", {
98
+ className: `${prefix}--pagination-nav__accessibility-label`,
99
+ children: isActive ? `${t("carbon.pagination-nav.active")}, ${itemLabel}` : itemLabel
100
+ }), page]
101
+ })
102
+ });
110
103
  }
111
- function PaginationOverflow({
112
- fromIndex = NaN,
113
- count = NaN,
114
- onSelect,
115
- disableOverflow,
116
- translateWithId: t = defaultTranslateWithId
117
- }) {
118
- const prefix = usePrefix();
119
-
120
- //If overflow is disabled, return a select tag with no select options
121
- if (disableOverflow === true && count > 1) {
122
- return /*#__PURE__*/React.createElement("li", {
123
- className: `${prefix}--pagination-nav__list-item`
124
- }, /*#__PURE__*/React.createElement("div", {
125
- className: `${prefix}--pagination-nav__select`
126
- }, /*#__PURE__*/React.createElement("select", {
127
- className: `${prefix}--pagination-nav__page ${prefix}--pagination-nav__page--select`,
128
- "aria-label": `Select ${t('carbon.pagination-nav.item')} number`,
129
- disabled: true
130
- }), /*#__PURE__*/React.createElement("div", {
131
- className: `${prefix}--pagination-nav__select-icon-wrapper`
132
- }, /*#__PURE__*/React.createElement(OverflowMenuHorizontal, {
133
- className: `${prefix}--pagination-nav__select-icon`
134
- }))));
135
- }
136
- if (count > 1) {
137
- return /*#__PURE__*/React.createElement("li", {
138
- className: `${prefix}--pagination-nav__list-item`
139
- }, /*#__PURE__*/React.createElement("div", {
140
- className: `${prefix}--pagination-nav__select`
141
- }, /*#__PURE__*/React.createElement("select", {
142
- className: `${prefix}--pagination-nav__page ${prefix}--pagination-nav__page--select`,
143
- "aria-label": `Select ${t('carbon.pagination-nav.item')} number`,
144
- onChange: e => {
145
- const index = Number(e.target.value);
146
- onSelect?.(index);
147
- }
148
- }, _option || (_option = /*#__PURE__*/React.createElement("option", {
149
- value: "",
150
- hidden: true
151
- })), [...Array(count)].map((e, i) => /*#__PURE__*/React.createElement("option", {
152
- value: (fromIndex + i).toString(),
153
- "data-page": fromIndex + i + 1,
154
- key: `overflow-${fromIndex + i}`
155
- }, fromIndex + i + 1))), /*#__PURE__*/React.createElement("div", {
156
- className: `${prefix}--pagination-nav__select-icon-wrapper`
157
- }, /*#__PURE__*/React.createElement(OverflowMenuHorizontal, {
158
- className: `${prefix}--pagination-nav__select-icon`
159
- }))));
160
- }
161
- if (count === 1) {
162
- return /*#__PURE__*/React.createElement(PaginationItem, {
163
- page: fromIndex + 1,
164
- translateWithId: t,
165
- onClick: () => {
166
- onSelect?.(fromIndex);
167
- }
168
- });
169
- }
170
- return null;
104
+ function PaginationOverflow({ fromIndex = NaN, count = NaN, onSelect, disableOverflow, translateWithId: t = defaultTranslateWithId }) {
105
+ const prefix = usePrefix();
106
+ if (disableOverflow === true && count > 1) return /* @__PURE__ */ jsx("li", {
107
+ className: `${prefix}--pagination-nav__list-item`,
108
+ children: /* @__PURE__ */ jsxs("div", {
109
+ className: `${prefix}--pagination-nav__select`,
110
+ children: [/* @__PURE__ */ jsx("select", {
111
+ className: `${prefix}--pagination-nav__page ${prefix}--pagination-nav__page--select`,
112
+ "aria-label": `Select ${t("carbon.pagination-nav.item")} number`,
113
+ disabled: true
114
+ }), /* @__PURE__ */ jsx("div", {
115
+ className: `${prefix}--pagination-nav__select-icon-wrapper`,
116
+ children: /* @__PURE__ */ jsx(OverflowMenuHorizontal, { className: `${prefix}--pagination-nav__select-icon` })
117
+ })]
118
+ })
119
+ });
120
+ if (count > 1) return /* @__PURE__ */ jsx("li", {
121
+ className: `${prefix}--pagination-nav__list-item`,
122
+ children: /* @__PURE__ */ jsxs("div", {
123
+ className: `${prefix}--pagination-nav__select`,
124
+ children: [/* @__PURE__ */ jsxs("select", {
125
+ className: `${prefix}--pagination-nav__page ${prefix}--pagination-nav__page--select`,
126
+ "aria-label": `Select ${t("carbon.pagination-nav.item")} number`,
127
+ onChange: (e) => {
128
+ const index = Number(e.target.value);
129
+ onSelect?.(index);
130
+ },
131
+ children: [/* @__PURE__ */ jsx("option", {
132
+ value: "",
133
+ hidden: true
134
+ }), [...Array(count)].map((e, i) => /* @__PURE__ */ jsx("option", {
135
+ value: (fromIndex + i).toString(),
136
+ "data-page": fromIndex + i + 1,
137
+ children: fromIndex + i + 1
138
+ }, `overflow-${fromIndex + i}`))]
139
+ }), /* @__PURE__ */ jsx("div", {
140
+ className: `${prefix}--pagination-nav__select-icon-wrapper`,
141
+ children: /* @__PURE__ */ jsx(OverflowMenuHorizontal, { className: `${prefix}--pagination-nav__select-icon` })
142
+ })]
143
+ })
144
+ });
145
+ if (count === 1) return /* @__PURE__ */ jsx(PaginationItem, {
146
+ page: fromIndex + 1,
147
+ translateWithId: t,
148
+ onClick: () => {
149
+ onSelect?.(fromIndex);
150
+ }
151
+ });
152
+ return null;
171
153
  }
172
- const PaginationNav = /*#__PURE__*/React.forwardRef(({
173
- className,
174
- onChange = () => {},
175
- totalItems = NaN,
176
- disableOverflow,
177
- itemsShown = 10,
178
- page = 0,
179
- loop = false,
180
- size = 'lg',
181
- tooltipAlignment,
182
- tooltipPosition,
183
- translateWithId: t = defaultTranslateWithId,
184
- ...rest
185
- }, ref) => {
186
- const smMediaQuery = `(max-width: ${breakpoints.sm.width})`;
187
- const isSm = useMatchMedia(smMediaQuery);
188
- let numberOfPages;
189
- switch (size) {
190
- case 'md':
191
- numberOfPages = itemsShown === 4 ? itemsShown : 5;
192
- break;
193
- case 'sm':
194
- numberOfPages = clamp(itemsShown, 4, 7);
195
- break;
196
- default:
197
- numberOfPages = 4;
198
- break;
199
- }
200
- const [currentPage, setCurrentPage] = useState(page);
201
- const [itemsDisplayedOnPage, setItemsDisplayedOnPage] = useState(itemsShown >= 4 && !isSm ? itemsShown : numberOfPages);
202
- const [cuts, setCuts] = useState(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage));
203
- const prevPage = usePrevious(currentPage);
204
- const prefix = usePrefix();
205
- const [isOverflowDisabled, setIsOverFlowDisabled] = useState(disableOverflow);
206
- function jumpToItem(index) {
207
- if (index >= 0 && index < totalItems) {
208
- setCurrentPage(index);
209
- onChange(index);
210
- }
211
- }
212
- function jumpToNext() {
213
- const nextIndex = currentPage + 1;
214
- if (nextIndex >= totalItems) {
215
- if (loop) {
216
- jumpToItem(0);
217
- }
218
- } else {
219
- jumpToItem(nextIndex);
220
- }
221
- }
222
- function jumpToPrevious() {
223
- const previousIndex = currentPage - 1;
224
- if (previousIndex < 0) {
225
- if (loop) {
226
- jumpToItem(totalItems - 1);
227
- }
228
- } else {
229
- jumpToItem(previousIndex);
230
- }
231
- }
232
- function pageWouldBeHidden(page) {
233
- const startOffset = itemsDisplayedOnPage <= 4 && page > 1 ? 0 : 1;
234
- const wouldBeHiddenInFront = page >= startOffset && page <= cuts.front || page === 0;
235
- const wouldBeHiddenInBack = page >= totalItems - cuts.back - 1 && page <= totalItems - 2;
236
- return wouldBeHiddenInFront || wouldBeHiddenInBack;
237
- }
238
-
239
- // jump to new page if props.page is updated
240
- useEffect(() => {
241
- setCurrentPage(page);
242
- }, [page]);
243
-
244
- // re-calculate cuts if props.totalItems or props.itemsShown change
245
- useEffect(() => {
246
- const itemsToBeShown = itemsShown >= 4 && !isSm ? itemsShown : numberOfPages;
247
- setItemsDisplayedOnPage(Math.max(itemsToBeShown, 4));
248
- setCuts(calculateCuts(currentPage, totalItems, Math.max(itemsToBeShown, 4)));
249
- }, [totalItems, itemsShown, isSm, size]); // eslint-disable-line react-hooks/exhaustive-deps
250
-
251
- // update cuts if necessary whenever currentPage changes
252
- useEffect(() => {
253
- if (pageWouldBeHidden(currentPage)) {
254
- const delta = currentPage - (prevPage || 0);
255
- if (delta > 0) {
256
- const splitPoint = itemsDisplayedOnPage - 3;
257
- setCuts(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage, splitPoint));
258
- } else {
259
- const splitPoint = itemsDisplayedOnPage > 4 ? 2 : 1;
260
- setCuts(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage, splitPoint));
261
- }
262
- }
263
- }, [currentPage]); // eslint-disable-line react-hooks/exhaustive-deps
264
-
265
- useEffect(() => {
266
- setIsOverFlowDisabled(disableOverflow);
267
- }, [disableOverflow]);
268
- const classNames = cx(`${prefix}--pagination-nav`, className, {
269
- [`${prefix}--layout--size-${size}`]: size
270
- });
271
- const backwardButtonDisabled = !loop && currentPage === 0;
272
- const forwardButtonDisabled = !loop && currentPage === totalItems - 1;
273
- const startOffset = itemsDisplayedOnPage <= 4 && currentPage > 1 ? 0 : 1;
274
- return /*#__PURE__*/React.createElement("nav", _extends({
275
- className: classNames,
276
- ref: ref
277
- }, rest), /*#__PURE__*/React.createElement("ul", {
278
- className: `${prefix}--pagination-nav__list`
279
- }, /*#__PURE__*/React.createElement(DirectionButton, {
280
- direction: "backward",
281
- "aria-label": t('carbon.pagination-nav.previous'),
282
- label: t('carbon.pagination-nav.previous'),
283
- disabled: backwardButtonDisabled,
284
- onClick: jumpToPrevious,
285
- tooltipAlignment: tooltipAlignment,
286
- tooltipPosition: tooltipPosition
287
- }),
288
- // render first item if at least 5 items can be displayed or
289
- // 4 items can be displayed and the current page is either 0 or 1
290
- (itemsDisplayedOnPage >= 5 || itemsDisplayedOnPage <= 4 && currentPage <= 1) && /*#__PURE__*/React.createElement(PaginationItem, {
291
- page: 1,
292
- translateWithId: t,
293
- isActive: currentPage === 0,
294
- onClick: () => {
295
- jumpToItem(0);
296
- }
297
- }), /*#__PURE__*/React.createElement(PaginationOverflow, {
298
- fromIndex: startOffset,
299
- count: cuts.front,
300
- onSelect: jumpToItem,
301
- disableOverflow: isOverflowDisabled
302
- }),
303
- // render items between overflows
304
- [...Array(totalItems)].map((e, i) => i).slice(startOffset + cuts.front, (1 + cuts.back) * -1).map(item => /*#__PURE__*/React.createElement(PaginationItem, {
305
- key: `item-${item}`,
306
- page: item + 1,
307
- translateWithId: t,
308
- isActive: currentPage === item,
309
- onClick: () => {
310
- jumpToItem(item);
311
- }
312
- })), /*#__PURE__*/React.createElement(PaginationOverflow, {
313
- fromIndex: totalItems - cuts.back - 1,
314
- count: cuts.back,
315
- onSelect: jumpToItem,
316
- disableOverflow: isOverflowDisabled
317
- }),
318
- // render last item unless there is only one in total
319
- totalItems > 1 && /*#__PURE__*/React.createElement(PaginationItem, {
320
- page: totalItems,
321
- translateWithId: t,
322
- isActive: currentPage === totalItems - 1,
323
- onClick: () => {
324
- jumpToItem(totalItems - 1);
325
- }
326
- }), /*#__PURE__*/React.createElement(DirectionButton, {
327
- direction: "forward",
328
- "aria-label": t('carbon.pagination-nav.next'),
329
- label: t('carbon.pagination-nav.next'),
330
- disabled: forwardButtonDisabled,
331
- onClick: jumpToNext,
332
- tooltipAlignment: tooltipAlignment,
333
- tooltipPosition: tooltipPosition
334
- })), /*#__PURE__*/React.createElement("div", {
335
- "aria-live": "polite",
336
- "aria-atomic": "true",
337
- className: `${prefix}--pagination-nav__accessibility-label`
338
- }, `${t('carbon.pagination-nav.item')} ${currentPage + 1} ${t('carbon.pagination-nav.of')} ${totalItems}`));
154
+ const PaginationNav = React.forwardRef(({ className, onChange = () => {}, totalItems = NaN, disableOverflow, itemsShown = 10, page = 0, loop = false, size = "lg", tooltipAlignment, tooltipPosition, translateWithId: t = defaultTranslateWithId, ...rest }, ref) => {
155
+ const isSm = useMatchMedia(`(max-width: ${breakpoints.sm.width})`);
156
+ let numberOfPages;
157
+ switch (size) {
158
+ case "md":
159
+ numberOfPages = itemsShown === 4 ? itemsShown : 5;
160
+ break;
161
+ case "sm":
162
+ numberOfPages = clamp(itemsShown, 4, 7);
163
+ break;
164
+ default:
165
+ numberOfPages = 4;
166
+ break;
167
+ }
168
+ const [currentPage, setCurrentPage] = useState(page);
169
+ const [itemsDisplayedOnPage, setItemsDisplayedOnPage] = useState(itemsShown >= 4 && !isSm ? itemsShown : numberOfPages);
170
+ const [cuts, setCuts] = useState(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage));
171
+ const prevPage = usePrevious(currentPage);
172
+ const prefix = usePrefix();
173
+ const [isOverflowDisabled, setIsOverFlowDisabled] = useState(disableOverflow);
174
+ function jumpToItem(index) {
175
+ if (index >= 0 && index < totalItems) {
176
+ setCurrentPage(index);
177
+ onChange(index);
178
+ }
179
+ }
180
+ function jumpToNext() {
181
+ const nextIndex = currentPage + 1;
182
+ if (nextIndex >= totalItems) {
183
+ if (loop) jumpToItem(0);
184
+ } else jumpToItem(nextIndex);
185
+ }
186
+ function jumpToPrevious() {
187
+ const previousIndex = currentPage - 1;
188
+ if (previousIndex < 0) {
189
+ if (loop) jumpToItem(totalItems - 1);
190
+ } else jumpToItem(previousIndex);
191
+ }
192
+ function pageWouldBeHidden(page) {
193
+ const wouldBeHiddenInFront = page >= (itemsDisplayedOnPage <= 4 && page > 1 ? 0 : 1) && page <= cuts.front || page === 0;
194
+ const wouldBeHiddenInBack = page >= totalItems - cuts.back - 1 && page <= totalItems - 2;
195
+ return wouldBeHiddenInFront || wouldBeHiddenInBack;
196
+ }
197
+ useEffect(() => {
198
+ setCurrentPage(page);
199
+ }, [page]);
200
+ useEffect(() => {
201
+ const itemsToBeShown = itemsShown >= 4 && !isSm ? itemsShown : numberOfPages;
202
+ setItemsDisplayedOnPage(Math.max(itemsToBeShown, 4));
203
+ setCuts(calculateCuts(currentPage, totalItems, Math.max(itemsToBeShown, 4)));
204
+ }, [
205
+ totalItems,
206
+ itemsShown,
207
+ isSm,
208
+ size
209
+ ]);
210
+ useEffect(() => {
211
+ if (pageWouldBeHidden(currentPage)) if (currentPage - (prevPage || 0) > 0) setCuts(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage, itemsDisplayedOnPage - 3));
212
+ else setCuts(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage, itemsDisplayedOnPage > 4 ? 2 : 1));
213
+ }, [currentPage]);
214
+ useEffect(() => {
215
+ setIsOverFlowDisabled(disableOverflow);
216
+ }, [disableOverflow]);
217
+ const classNames$1 = classNames(`${prefix}--pagination-nav`, className, { [`${prefix}--layout--size-${size}`]: size });
218
+ const backwardButtonDisabled = !loop && currentPage === 0;
219
+ const forwardButtonDisabled = !loop && currentPage === totalItems - 1;
220
+ const startOffset = itemsDisplayedOnPage <= 4 && currentPage > 1 ? 0 : 1;
221
+ return /* @__PURE__ */ jsxs("nav", {
222
+ className: classNames$1,
223
+ ref,
224
+ ...rest,
225
+ children: [/* @__PURE__ */ jsxs("ul", {
226
+ className: `${prefix}--pagination-nav__list`,
227
+ children: [
228
+ /* @__PURE__ */ jsx(DirectionButton, {
229
+ direction: "backward",
230
+ "aria-label": t("carbon.pagination-nav.previous"),
231
+ label: t("carbon.pagination-nav.previous"),
232
+ disabled: backwardButtonDisabled,
233
+ onClick: jumpToPrevious,
234
+ tooltipAlignment,
235
+ tooltipPosition
236
+ }),
237
+ (itemsDisplayedOnPage >= 5 || itemsDisplayedOnPage <= 4 && currentPage <= 1) && /* @__PURE__ */ jsx(PaginationItem, {
238
+ page: 1,
239
+ translateWithId: t,
240
+ isActive: currentPage === 0,
241
+ onClick: () => {
242
+ jumpToItem(0);
243
+ }
244
+ }),
245
+ /* @__PURE__ */ jsx(PaginationOverflow, {
246
+ fromIndex: startOffset,
247
+ count: cuts.front,
248
+ onSelect: jumpToItem,
249
+ disableOverflow: isOverflowDisabled
250
+ }),
251
+ [...Array(totalItems)].map((e, i) => i).slice(startOffset + cuts.front, (1 + cuts.back) * -1).map((item) => /* @__PURE__ */ jsx(PaginationItem, {
252
+ page: item + 1,
253
+ translateWithId: t,
254
+ isActive: currentPage === item,
255
+ onClick: () => {
256
+ jumpToItem(item);
257
+ }
258
+ }, `item-${item}`)),
259
+ /* @__PURE__ */ jsx(PaginationOverflow, {
260
+ fromIndex: totalItems - cuts.back - 1,
261
+ count: cuts.back,
262
+ onSelect: jumpToItem,
263
+ disableOverflow: isOverflowDisabled
264
+ }),
265
+ totalItems > 1 && /* @__PURE__ */ jsx(PaginationItem, {
266
+ page: totalItems,
267
+ translateWithId: t,
268
+ isActive: currentPage === totalItems - 1,
269
+ onClick: () => {
270
+ jumpToItem(totalItems - 1);
271
+ }
272
+ }),
273
+ /* @__PURE__ */ jsx(DirectionButton, {
274
+ direction: "forward",
275
+ "aria-label": t("carbon.pagination-nav.next"),
276
+ label: t("carbon.pagination-nav.next"),
277
+ disabled: forwardButtonDisabled,
278
+ onClick: jumpToNext,
279
+ tooltipAlignment,
280
+ tooltipPosition
281
+ })
282
+ ]
283
+ }), /* @__PURE__ */ jsx("div", {
284
+ "aria-live": "polite",
285
+ "aria-atomic": "true",
286
+ className: `${prefix}--pagination-nav__accessibility-label`,
287
+ children: `${t("carbon.pagination-nav.item")} ${currentPage + 1} ${t("carbon.pagination-nav.of")} ${totalItems}`
288
+ })]
289
+ });
339
290
  });
340
291
  DirectionButton.propTypes = {
341
- /**
342
- * The direction this button represents ("forward" or "backward").
343
- */
344
- direction: PropTypes.oneOf(['forward', 'backward']),
345
- /**
346
- * Whether or not the button should be disabled.
347
- */
348
- disabled: PropTypes.bool,
349
- /**
350
- * The label shown in the button's tooltip.
351
- */
352
- label: PropTypes.string,
353
- /**
354
- * The callback function called when the button is clicked.
355
- */
356
- onClick: PropTypes.func,
357
- /**
358
- * Specify how the tooltip should align with the navigation button.
359
- * Can be one of: start, center, or end.
360
- */
361
- tooltipAlignment: PropTypes.oneOf(['start', 'center', 'end']),
362
- /**
363
- * Specify the position of the tooltip relative to the navigation button.
364
- * Can be one of: top, right, bottom, or left.
365
- */
366
- tooltipPosition: PropTypes.oneOf(['top', 'right', 'bottom', 'left'])
292
+ direction: PropTypes.oneOf(["forward", "backward"]),
293
+ disabled: PropTypes.bool,
294
+ label: PropTypes.string,
295
+ onClick: PropTypes.func,
296
+ tooltipAlignment: PropTypes.oneOf([
297
+ "start",
298
+ "center",
299
+ "end"
300
+ ]),
301
+ tooltipPosition: PropTypes.oneOf([
302
+ "top",
303
+ "right",
304
+ "bottom",
305
+ "left"
306
+ ])
367
307
  };
368
308
  PaginationItem.propTypes = {
369
- /**
370
- * Whether or not this is the currently active page.
371
- */
372
- isActive: PropTypes.bool,
373
- /**
374
- * The callback function called when the item is clicked.
375
- */
376
- onClick: PropTypes.func,
377
- /**
378
- * The page number this item represents.
379
- */
380
- page: PropTypes.number,
381
- /**
382
- * Translates component strings using your i18n tool.
383
- */
384
- translateWithId: PropTypes.func
309
+ isActive: PropTypes.bool,
310
+ onClick: PropTypes.func,
311
+ page: PropTypes.number,
312
+ translateWithId: PropTypes.func
385
313
  };
386
314
  PaginationOverflow.propTypes = {
387
- /**
388
- * How many items to display in this overflow.
389
- */
390
- count: PropTypes.number,
391
- /**
392
- * From which index on this overflow should start displaying pages.
393
- */
394
- fromIndex: PropTypes.number,
395
- /**
396
- * The callback function called when the user selects a page from the overflow.
397
- */
398
- onSelect: PropTypes.func,
399
- /**
400
- * Translates component strings using your i18n tool.
401
- */
402
- translateWithId: PropTypes.func
315
+ count: PropTypes.number,
316
+ fromIndex: PropTypes.number,
317
+ onSelect: PropTypes.func,
318
+ translateWithId: PropTypes.func
403
319
  };
404
- PaginationNav.displayName = 'PaginationNav';
320
+ PaginationNav.displayName = "PaginationNav";
405
321
  PaginationNav.propTypes = {
406
- /**
407
- * Additional CSS class names.
408
- */
409
- className: PropTypes.string,
410
- /**
411
- * If true, the '...' pagination overflow will not render page links between the first and last rendered buttons.
412
- * Set this to true if you are having performance problems with large data sets.
413
- */
414
- disableOverflow: PropTypes.bool,
415
- /**
416
- * The number of items to be shown (minimum of 4 unless props.items < 4).
417
- */
418
- itemsShown: PropTypes.number,
419
- /**
420
- * Whether user should be able to loop through the items when reaching first / last.
421
- */
422
- loop: PropTypes.bool,
423
- /**
424
- * The callback function called when the current page changes.
425
- */
426
- onChange: PropTypes.func,
427
- /**
428
- * The index of current page.
429
- */
430
- page: PropTypes.number,
431
- /**
432
- * Specify the size of the PaginationNav.
433
- */
434
- size: PropTypes.oneOf(['sm', 'md', 'lg']),
435
- /**
436
- * Specify the alignment of the tooltip for the icon-only prev/next buttons.
437
- * Can be one of: start, center, or end.
438
- */
439
- tooltipAlignment: PropTypes.oneOf(['start', 'center', 'end']),
440
- /**
441
- * Specify the position of the tooltip for the icon-only prev/next buttons.
442
- * Can be one of: top, right, bottom, or left.
443
- */
444
- tooltipPosition: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
445
- /**
446
- * The total number of items.
447
- */
448
- totalItems: PropTypes.number,
449
- /**
450
- * Translates component strings using your i18n tool.
451
- */
452
- translateWithId: PropTypes.func
322
+ className: PropTypes.string,
323
+ disableOverflow: PropTypes.bool,
324
+ itemsShown: PropTypes.number,
325
+ loop: PropTypes.bool,
326
+ onChange: PropTypes.func,
327
+ page: PropTypes.number,
328
+ size: PropTypes.oneOf([
329
+ "sm",
330
+ "md",
331
+ "lg"
332
+ ]),
333
+ tooltipAlignment: PropTypes.oneOf([
334
+ "start",
335
+ "center",
336
+ "end"
337
+ ]),
338
+ tooltipPosition: PropTypes.oneOf([
339
+ "top",
340
+ "right",
341
+ "bottom",
342
+ "left"
343
+ ]),
344
+ totalItems: PropTypes.number,
345
+ translateWithId: PropTypes.func
453
346
  };
454
347
 
455
- export { PaginationNav as default };
348
+ //#endregion
349
+ export { PaginationNav as default };