@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,433 +1,326 @@
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, { useContext, useRef, useState, useEffect, forwardRef, cloneElement } from 'react';
11
- import cx from 'classnames';
12
- import { deprecate } from '../../prop-types/deprecate.js';
13
- import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
14
- import { usePrefix } from '../../internal/usePrefix.js';
15
- import '../FluidForm/FluidForm.js';
16
- import { FormContext } from '../FluidForm/FormContext.js';
17
- import { getAnnouncement } from '../../internal/getAnnouncement.js';
18
- import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
19
- import { useMergedRefs } from '../../internal/useMergedRefs.js';
20
- import { useId } from '../../internal/useId.js';
21
- import { noopFn } from '../../internal/noopFn.js';
22
- import { Text } from '../Text/Text.js';
23
- import '../Text/TextDirection.js';
24
- import { AILabel } from '../AILabel/index.js';
25
- import { isComponentElement } from '../../internal/utils.js';
8
+ import { usePrefix } from "../../internal/usePrefix.js";
9
+ import { Text } from "../Text/Text.js";
10
+ import useIsomorphicEffect from "../../internal/useIsomorphicEffect.js";
11
+ import { useId } from "../../internal/useId.js";
12
+ import { noopFn } from "../../internal/noopFn.js";
13
+ import { deprecate } from "../../prop-types/deprecate.js";
14
+ import { useMergedRefs } from "../../internal/useMergedRefs.js";
15
+ import { AILabel } from "../AILabel/index.js";
16
+ import { isComponentElement } from "../../internal/utils.js";
17
+ import { FormContext } from "../FluidForm/FormContext.js";
18
+ import { getAnnouncement } from "../../internal/getAnnouncement.js";
19
+ import classNames from "classnames";
20
+ import React, { cloneElement, forwardRef, useContext, useEffect, useRef, useState } from "react";
21
+ import PropTypes from "prop-types";
22
+ import { jsx, jsxs } from "react/jsx-runtime";
23
+ import { WarningAltFilled, WarningFilled } from "@carbon/icons-react";
26
24
 
27
- const frFn = forwardRef;
28
- const TextArea = frFn((props, forwardRef) => {
29
- const {
30
- className,
31
- decorator,
32
- disabled = false,
33
- id,
34
- labelText,
35
- hideLabel,
36
- onChange = noopFn,
37
- onClick = noopFn,
38
- onKeyDown = noopFn,
39
- invalid = false,
40
- invalidText = '',
41
- helperText,
42
- light,
43
- placeholder = '',
44
- enableCounter = false,
45
- maxCount,
46
- counterMode = 'character',
47
- warn = false,
48
- warnText = '',
49
- rows = 4,
50
- slug,
51
- ...other
52
- } = props;
53
- const prefix = usePrefix();
54
- const {
55
- isFluid
56
- } = useContext(FormContext);
57
- const {
58
- defaultValue,
59
- value
60
- } = other;
61
- const textAreaInstanceId = useId();
62
- const wrapperRef = useRef(null);
63
- const textareaRef = useRef(null);
64
- const helperTextRef = useRef(null);
65
- const errorTextRef = useRef(null);
66
- const warnTextRef = useRef(null);
67
- const ref = useMergedRefs([forwardRef, textareaRef]);
68
- function getInitialTextCount() {
69
- const targetValue = defaultValue || value || textareaRef.current?.value || '';
70
- const strValue = targetValue.toString();
71
- if (counterMode === 'character') {
72
- return strValue.length;
73
- } else {
74
- return strValue.match(/\p{L}+/gu)?.length || 0;
75
- }
76
- }
77
- const [textCount, setTextCount] = useState(getInitialTextCount());
78
- useEffect(() => {
79
- setTextCount(getInitialTextCount());
80
- // eslint-disable-next-line react-hooks/exhaustive-deps
81
- }, [value, defaultValue, counterMode]);
82
- useIsomorphicEffect(() => {
83
- if (other.cols && textareaRef.current) {
84
- textareaRef.current.style.width = '';
85
- textareaRef.current.style.resize = 'none';
86
- } else if (textareaRef.current) {
87
- textareaRef.current.style.width = `100%`;
88
- }
89
- if (!wrapperRef.current) return;
90
- const applyWidth = width => {
91
- [helperTextRef, errorTextRef, warnTextRef].forEach(r => {
92
- if (r.current) {
93
- r.current.style.maxWidth = `${width}px`;
94
- r.current.style.overflowWrap = 'break-word';
95
- }
96
- });
97
- };
98
- const resizeObserver = new ResizeObserver(([entry]) => {
99
- applyWidth(entry.contentRect.width);
100
- });
101
- resizeObserver.observe(wrapperRef.current);
102
- return () => resizeObserver && resizeObserver.disconnect();
103
- }, [other.cols, invalid, warn]);
104
- const textareaProps = {
105
- id,
106
- onKeyDown: evt => {
107
- if (!disabled && enableCounter && counterMode === 'word') {
108
- const key = evt.which;
109
- if (maxCount && textCount >= maxCount && key === 32 || maxCount && textCount >= maxCount && key === 13) {
110
- evt.preventDefault();
111
- }
112
- }
113
- if (!disabled && onKeyDown) {
114
- onKeyDown(evt);
115
- }
116
- },
117
- onPaste: evt => {
118
- if (!disabled) {
119
- if (counterMode === 'word' && enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
120
- const existingWords = textareaRef.current.value.match(/\p{L}+/gu) || [];
121
- const pastedWords = evt.clipboardData.getData('Text').match(/\p{L}+/gu) || [];
122
- const totalWords = existingWords.length + pastedWords.length;
123
- if (totalWords > maxCount) {
124
- evt.preventDefault();
125
- const allowedWords = existingWords.concat(pastedWords).slice(0, maxCount);
126
- setTimeout(() => {
127
- setTextCount(maxCount);
128
- }, 0);
129
- textareaRef.current.value = allowedWords.join(' ');
130
- }
131
- }
132
- }
133
- },
134
- onChange: evt => {
135
- if (!disabled) {
136
- if (counterMode == 'character') {
137
- evt?.persist?.();
138
- // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
139
- setTimeout(() => {
140
- setTextCount(evt.target?.value?.length);
141
- }, 0);
142
- } else if (counterMode == 'word') {
143
- if (!evt.target.value) {
144
- setTimeout(() => {
145
- setTextCount(0);
146
- }, 0);
147
- } else if (enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
148
- const matchedWords = evt.target?.value?.match(/\p{L}+/gu);
149
- if (matchedWords && matchedWords.length <= maxCount) {
150
- textareaRef.current.removeAttribute('maxLength');
151
- setTimeout(() => {
152
- setTextCount(matchedWords.length);
153
- }, 0);
154
- } else if (matchedWords && matchedWords.length > maxCount) {
155
- setTimeout(() => {
156
- setTextCount(matchedWords.length);
157
- }, 0);
158
- }
159
- }
160
- }
161
- if (onChange) {
162
- onChange(evt);
163
- }
164
- }
165
- },
166
- onClick: evt => {
167
- if (!disabled && onClick) {
168
- onClick(evt);
169
- }
170
- }
171
- };
172
- const formItemClasses = cx(`${prefix}--form-item`, className);
173
- const textAreaWrapperClasses = cx(`${prefix}--text-area__wrapper`, {
174
- [`${prefix}--text-area__wrapper--cols`]: other.cols,
175
- [`${prefix}--text-area__wrapper--readonly`]: other.readOnly,
176
- [`${prefix}--text-area__wrapper--warn`]: warn,
177
- [`${prefix}--text-area__wrapper--slug`]: slug,
178
- [`${prefix}--text-area__wrapper--decorator`]: decorator
179
- });
180
- const labelClasses = cx(`${prefix}--label`, {
181
- [`${prefix}--visually-hidden`]: hideLabel && !isFluid,
182
- [`${prefix}--label--disabled`]: disabled
183
- });
184
- const textareaClasses = cx(`${prefix}--text-area`, {
185
- [`${prefix}--text-area--light`]: light,
186
- [`${prefix}--text-area--invalid`]: invalid,
187
- [`${prefix}--text-area--warn`]: warn
188
- });
189
- const counterClasses = cx(`${prefix}--label`, {
190
- [`${prefix}--label--disabled`]: disabled,
191
- [`${prefix}--text-area__label-counter`]: true
192
- });
193
- const helperTextClasses = cx(`${prefix}--form__helper-text`, {
194
- [`${prefix}--form__helper-text--disabled`]: disabled
195
- });
196
- const label = typeof labelText !== 'undefined' && labelText !== null && /*#__PURE__*/React.createElement(Text, {
197
- as: "label",
198
- htmlFor: id,
199
- className: labelClasses
200
- }, labelText);
201
- const counter = enableCounter && maxCount && (counterMode === 'character' || counterMode === 'word') ? /*#__PURE__*/React.createElement(Text, {
202
- as: "div",
203
- className: counterClasses,
204
- "aria-hidden": "true"
205
- }, `${textCount}/${maxCount}`) : null;
206
- const counterDescriptionId = enableCounter && maxCount ? `${id}-counter-desc` : undefined;
207
- const hasHelper = typeof helperText !== 'undefined' && helperText !== null;
208
- const helperId = !hasHelper ? undefined : `text-area-helper-text-${textAreaInstanceId}`;
209
- const helper = hasHelper && /*#__PURE__*/React.createElement(Text, {
210
- as: "div",
211
- id: helperId,
212
- className: helperTextClasses,
213
- ref: helperTextRef
214
- }, helperText);
215
- const errorId = id + '-error-msg';
216
- const error = invalid ? /*#__PURE__*/React.createElement(Text, {
217
- as: "div",
218
- role: "alert",
219
- className: `${prefix}--form-requirement`,
220
- id: errorId,
221
- ref: errorTextRef
222
- }, invalidText, isFluid && /*#__PURE__*/React.createElement(WarningFilled, {
223
- className: `${prefix}--text-area__invalid-icon`
224
- })) : null;
225
- const warnId = id + '-warn-msg';
226
- const warning = warn ? /*#__PURE__*/React.createElement(Text, {
227
- as: "div",
228
- role: "alert",
229
- className: `${prefix}--form-requirement`,
230
- id: warnId,
231
- ref: warnTextRef
232
- }, warnText, isFluid && /*#__PURE__*/React.createElement(WarningAltFilled, {
233
- className: `${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning`
234
- })) : null;
235
- let ariaDescribedBy;
236
- if (invalid) {
237
- ariaDescribedBy = errorId;
238
- } else if (warn && !isFluid) {
239
- ariaDescribedBy = warnId;
240
- } else {
241
- const ids = [];
242
- if (!isFluid && hasHelper && helperId) ids.push(helperId);
243
- if (counterDescriptionId) ids.push(counterDescriptionId);
244
- ariaDescribedBy = ids.length > 0 ? ids.join(' ') : undefined;
245
- }
246
- if (enableCounter) {
247
- // handle different counter mode
248
- if (counterMode == 'character') {
249
- textareaProps.maxLength = maxCount;
250
- }
251
- }
252
- const announcerRef = useRef(null);
253
- const [prevAnnouncement, setPrevAnnouncement] = useState('');
254
- const ariaAnnouncement = getAnnouncement(textCount, maxCount, counterMode === 'word' ? 'word' : undefined, counterMode === 'word' ? 'words' : undefined);
255
- useEffect(() => {
256
- if (ariaAnnouncement && ariaAnnouncement !== prevAnnouncement) {
257
- const announcer = announcerRef.current;
258
- if (announcer) {
259
- // Clear the content first
260
- announcer.textContent = '';
261
-
262
- // Set the new content after a small delay
263
- const timeoutId = setTimeout(() => {
264
- if (announcer) {
265
- announcer.textContent = ariaAnnouncement;
266
- setPrevAnnouncement(ariaAnnouncement);
267
- }
268
- }, counterMode === 'word' ? 2000 : 1000);
269
-
270
- //clear the timeout
271
- return () => {
272
- if (timeoutId) {
273
- clearTimeout(timeoutId);
274
- }
275
- };
276
- }
277
- }
278
- }, [ariaAnnouncement, prevAnnouncement, counterMode]);
279
- const input = /*#__PURE__*/React.createElement("textarea", _extends({}, other, textareaProps, {
280
- placeholder: placeholder,
281
- "aria-readonly": other.readOnly,
282
- className: textareaClasses,
283
- "aria-invalid": invalid,
284
- "aria-describedby": ariaDescribedBy,
285
- disabled: disabled,
286
- rows: rows,
287
- readOnly: other.readOnly,
288
- ref: ref
289
- }));
290
-
291
- // AILabel is always size `mini`
292
- const candidate = slug ?? decorator;
293
- const candidateIsAILabel = isComponentElement(candidate, AILabel);
294
- const normalizedDecorator = candidateIsAILabel ? /*#__PURE__*/cloneElement(candidate, {
295
- size: 'mini'
296
- }) : candidate;
297
- return /*#__PURE__*/React.createElement("div", {
298
- className: formItemClasses
299
- }, /*#__PURE__*/React.createElement("div", {
300
- className: `${prefix}--text-area__label-wrapper`
301
- }, label, counter), enableCounter && maxCount && /*#__PURE__*/React.createElement("span", {
302
- id: counterDescriptionId,
303
- className: `${prefix}--visually-hidden`
304
- }, counterMode === 'word' ? `Word limit ${maxCount}` : `Character limit ${maxCount}`), /*#__PURE__*/React.createElement("div", {
305
- ref: wrapperRef,
306
- className: textAreaWrapperClasses,
307
- "data-invalid": invalid || null
308
- }, invalid && !isFluid && /*#__PURE__*/React.createElement(WarningFilled, {
309
- className: `${prefix}--text-area__invalid-icon`
310
- }), warn && !invalid && !isFluid && /*#__PURE__*/React.createElement(WarningAltFilled, {
311
- className: `${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning`
312
- }), input, slug ? normalizedDecorator : decorator ? /*#__PURE__*/React.createElement("div", {
313
- className: `${prefix}--text-area__inner-wrapper--decorator`
314
- }, normalizedDecorator) : '', /*#__PURE__*/React.createElement("span", {
315
- className: `${prefix}--text-area__counter-alert`,
316
- role: "alert",
317
- "aria-live": "assertive",
318
- "aria-atomic": "true",
319
- ref: announcerRef
320
- }, ariaAnnouncement), isFluid && /*#__PURE__*/React.createElement("hr", {
321
- className: `${prefix}--text-area__divider`
322
- }), isFluid && invalid ? error : null, isFluid && warn && !invalid ? warning : null), !invalid && !warn && !isFluid ? helper : null, invalid && !isFluid ? error : null, warn && !invalid && !isFluid ? warning : null);
25
+ //#region src/components/TextArea/TextArea.tsx
26
+ /**
27
+ * Copyright IBM Corp. 2016, 2026
28
+ *
29
+ * This source code is licensed under the Apache-2.0 license found in the
30
+ * LICENSE file in the root directory of this source tree.
31
+ */
32
+ const TextArea = forwardRef((props, forwardRef) => {
33
+ const { className, decorator, disabled = false, id, labelText, hideLabel, onChange = noopFn, onClick = noopFn, onKeyDown = noopFn, invalid = false, invalidText = "", helperText, light, placeholder = "", enableCounter = false, maxCount, counterMode = "character", warn = false, warnText = "", rows = 4, slug, ...other } = props;
34
+ const prefix = usePrefix();
35
+ const { isFluid } = useContext(FormContext);
36
+ const { defaultValue, value } = other;
37
+ const textAreaInstanceId = useId();
38
+ const wrapperRef = useRef(null);
39
+ const textareaRef = useRef(null);
40
+ const helperTextRef = useRef(null);
41
+ const errorTextRef = useRef(null);
42
+ const warnTextRef = useRef(null);
43
+ const ref = useMergedRefs([forwardRef, textareaRef]);
44
+ function getInitialTextCount() {
45
+ const strValue = (defaultValue || value || textareaRef.current?.value || "").toString();
46
+ if (counterMode === "character") return strValue.length;
47
+ else return strValue.match(/\p{L}+/gu)?.length || 0;
48
+ }
49
+ const [textCount, setTextCount] = useState(getInitialTextCount());
50
+ useEffect(() => {
51
+ setTextCount(getInitialTextCount());
52
+ }, [
53
+ value,
54
+ defaultValue,
55
+ counterMode
56
+ ]);
57
+ useIsomorphicEffect(() => {
58
+ if (other.cols && textareaRef.current) {
59
+ textareaRef.current.style.width = "";
60
+ textareaRef.current.style.resize = "none";
61
+ } else if (textareaRef.current) textareaRef.current.style.width = `100%`;
62
+ if (!wrapperRef.current) return;
63
+ const applyWidth = (width) => {
64
+ [
65
+ helperTextRef,
66
+ errorTextRef,
67
+ warnTextRef
68
+ ].forEach((r) => {
69
+ if (r.current) {
70
+ r.current.style.maxWidth = `${width}px`;
71
+ r.current.style.overflowWrap = "break-word";
72
+ }
73
+ });
74
+ };
75
+ const resizeObserver = new ResizeObserver(([entry]) => {
76
+ applyWidth(entry.contentRect.width);
77
+ });
78
+ resizeObserver.observe(wrapperRef.current);
79
+ return () => resizeObserver && resizeObserver.disconnect();
80
+ }, [
81
+ other.cols,
82
+ invalid,
83
+ warn
84
+ ]);
85
+ const textareaProps = {
86
+ id,
87
+ onKeyDown: (evt) => {
88
+ if (!disabled && enableCounter && counterMode === "word") {
89
+ const key = evt.which;
90
+ if (maxCount && textCount >= maxCount && key === 32 || maxCount && textCount >= maxCount && key === 13) evt.preventDefault();
91
+ }
92
+ if (!disabled && onKeyDown) onKeyDown(evt);
93
+ },
94
+ onPaste: (evt) => {
95
+ if (!disabled) {
96
+ if (counterMode === "word" && enableCounter && typeof maxCount !== "undefined" && textareaRef.current !== null) {
97
+ const existingWords = textareaRef.current.value.match(/\p{L}+/gu) || [];
98
+ const pastedWords = evt.clipboardData.getData("Text").match(/\p{L}+/gu) || [];
99
+ if (existingWords.length + pastedWords.length > maxCount) {
100
+ evt.preventDefault();
101
+ const allowedWords = existingWords.concat(pastedWords).slice(0, maxCount);
102
+ setTimeout(() => {
103
+ setTextCount(maxCount);
104
+ }, 0);
105
+ textareaRef.current.value = allowedWords.join(" ");
106
+ }
107
+ }
108
+ }
109
+ },
110
+ onChange: (evt) => {
111
+ if (!disabled) {
112
+ if (counterMode == "character") {
113
+ evt?.persist?.();
114
+ setTimeout(() => {
115
+ setTextCount(evt.target?.value?.length);
116
+ }, 0);
117
+ } else if (counterMode == "word") {
118
+ if (!evt.target.value) setTimeout(() => {
119
+ setTextCount(0);
120
+ }, 0);
121
+ else if (enableCounter && typeof maxCount !== "undefined" && textareaRef.current !== null) {
122
+ const matchedWords = evt.target?.value?.match(/\p{L}+/gu);
123
+ if (matchedWords && matchedWords.length <= maxCount) {
124
+ textareaRef.current.removeAttribute("maxLength");
125
+ setTimeout(() => {
126
+ setTextCount(matchedWords.length);
127
+ }, 0);
128
+ } else if (matchedWords && matchedWords.length > maxCount) setTimeout(() => {
129
+ setTextCount(matchedWords.length);
130
+ }, 0);
131
+ }
132
+ }
133
+ if (onChange) onChange(evt);
134
+ }
135
+ },
136
+ onClick: (evt) => {
137
+ if (!disabled && onClick) onClick(evt);
138
+ }
139
+ };
140
+ const formItemClasses = classNames(`${prefix}--form-item`, className);
141
+ const textAreaWrapperClasses = classNames(`${prefix}--text-area__wrapper`, {
142
+ [`${prefix}--text-area__wrapper--cols`]: other.cols,
143
+ [`${prefix}--text-area__wrapper--readonly`]: other.readOnly,
144
+ [`${prefix}--text-area__wrapper--warn`]: warn,
145
+ [`${prefix}--text-area__wrapper--slug`]: slug,
146
+ [`${prefix}--text-area__wrapper--decorator`]: decorator
147
+ });
148
+ const labelClasses = classNames(`${prefix}--label`, {
149
+ [`${prefix}--visually-hidden`]: hideLabel && !isFluid,
150
+ [`${prefix}--label--disabled`]: disabled
151
+ });
152
+ const textareaClasses = classNames(`${prefix}--text-area`, {
153
+ [`${prefix}--text-area--light`]: light,
154
+ [`${prefix}--text-area--invalid`]: invalid,
155
+ [`${prefix}--text-area--warn`]: warn
156
+ });
157
+ const counterClasses = classNames(`${prefix}--label`, {
158
+ [`${prefix}--label--disabled`]: disabled,
159
+ [`${prefix}--text-area__label-counter`]: true
160
+ });
161
+ const helperTextClasses = classNames(`${prefix}--form__helper-text`, { [`${prefix}--form__helper-text--disabled`]: disabled });
162
+ const label = typeof labelText !== "undefined" && labelText !== null && /* @__PURE__ */ jsx(Text, {
163
+ as: "label",
164
+ htmlFor: id,
165
+ className: labelClasses,
166
+ children: labelText
167
+ });
168
+ const counter = enableCounter && maxCount && (counterMode === "character" || counterMode === "word") ? /* @__PURE__ */ jsx(Text, {
169
+ as: "div",
170
+ className: counterClasses,
171
+ "aria-hidden": "true",
172
+ children: `${textCount}/${maxCount}`
173
+ }) : null;
174
+ const counterDescriptionId = enableCounter && maxCount ? `${id}-counter-desc` : void 0;
175
+ const hasHelper = typeof helperText !== "undefined" && helperText !== null;
176
+ const helperId = !hasHelper ? void 0 : `text-area-helper-text-${textAreaInstanceId}`;
177
+ const helper = hasHelper && /* @__PURE__ */ jsx(Text, {
178
+ as: "div",
179
+ id: helperId,
180
+ className: helperTextClasses,
181
+ ref: helperTextRef,
182
+ children: helperText
183
+ });
184
+ const errorId = id + "-error-msg";
185
+ const error = invalid ? /* @__PURE__ */ jsxs(Text, {
186
+ as: "div",
187
+ role: "alert",
188
+ className: `${prefix}--form-requirement`,
189
+ id: errorId,
190
+ ref: errorTextRef,
191
+ children: [invalidText, isFluid && /* @__PURE__ */ jsx(WarningFilled, { className: `${prefix}--text-area__invalid-icon` })]
192
+ }) : null;
193
+ const warnId = id + "-warn-msg";
194
+ const warning = warn ? /* @__PURE__ */ jsxs(Text, {
195
+ as: "div",
196
+ role: "alert",
197
+ className: `${prefix}--form-requirement`,
198
+ id: warnId,
199
+ ref: warnTextRef,
200
+ children: [warnText, isFluid && /* @__PURE__ */ jsx(WarningAltFilled, { className: `${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning` })]
201
+ }) : null;
202
+ let ariaDescribedBy;
203
+ if (invalid) ariaDescribedBy = errorId;
204
+ else if (warn && !isFluid) ariaDescribedBy = warnId;
205
+ else {
206
+ const ids = [];
207
+ if (!isFluid && hasHelper && helperId) ids.push(helperId);
208
+ if (counterDescriptionId) ids.push(counterDescriptionId);
209
+ ariaDescribedBy = ids.length > 0 ? ids.join(" ") : void 0;
210
+ }
211
+ if (enableCounter) {
212
+ if (counterMode == "character") textareaProps.maxLength = maxCount;
213
+ }
214
+ const announcerRef = useRef(null);
215
+ const [prevAnnouncement, setPrevAnnouncement] = useState("");
216
+ const ariaAnnouncement = getAnnouncement(textCount, maxCount, counterMode === "word" ? "word" : void 0, counterMode === "word" ? "words" : void 0);
217
+ useEffect(() => {
218
+ if (ariaAnnouncement && ariaAnnouncement !== prevAnnouncement) {
219
+ const announcer = announcerRef.current;
220
+ if (announcer) {
221
+ announcer.textContent = "";
222
+ const timeoutId = setTimeout(() => {
223
+ if (announcer) {
224
+ announcer.textContent = ariaAnnouncement;
225
+ setPrevAnnouncement(ariaAnnouncement);
226
+ }
227
+ }, counterMode === "word" ? 2e3 : 1e3);
228
+ return () => {
229
+ if (timeoutId) clearTimeout(timeoutId);
230
+ };
231
+ }
232
+ }
233
+ }, [
234
+ ariaAnnouncement,
235
+ prevAnnouncement,
236
+ counterMode
237
+ ]);
238
+ const input = /* @__PURE__ */ jsx("textarea", {
239
+ ...other,
240
+ ...textareaProps,
241
+ placeholder,
242
+ "aria-readonly": other.readOnly,
243
+ className: textareaClasses,
244
+ "aria-invalid": invalid,
245
+ "aria-describedby": ariaDescribedBy,
246
+ disabled,
247
+ rows,
248
+ readOnly: other.readOnly,
249
+ ref
250
+ });
251
+ const candidate = slug ?? decorator;
252
+ const normalizedDecorator = isComponentElement(candidate, AILabel) ? cloneElement(candidate, { size: "mini" }) : candidate;
253
+ return /* @__PURE__ */ jsxs("div", {
254
+ className: formItemClasses,
255
+ children: [
256
+ /* @__PURE__ */ jsxs("div", {
257
+ className: `${prefix}--text-area__label-wrapper`,
258
+ children: [label, counter]
259
+ }),
260
+ enableCounter && maxCount && /* @__PURE__ */ jsx("span", {
261
+ id: counterDescriptionId,
262
+ className: `${prefix}--visually-hidden`,
263
+ children: counterMode === "word" ? `Word limit ${maxCount}` : `Character limit ${maxCount}`
264
+ }),
265
+ /* @__PURE__ */ jsxs("div", {
266
+ ref: wrapperRef,
267
+ className: textAreaWrapperClasses,
268
+ "data-invalid": invalid || null,
269
+ children: [
270
+ invalid && !isFluid && /* @__PURE__ */ jsx(WarningFilled, { className: `${prefix}--text-area__invalid-icon` }),
271
+ warn && !invalid && !isFluid && /* @__PURE__ */ jsx(WarningAltFilled, { className: `${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning` }),
272
+ input,
273
+ slug ? normalizedDecorator : decorator ? /* @__PURE__ */ jsx("div", {
274
+ className: `${prefix}--text-area__inner-wrapper--decorator`,
275
+ children: normalizedDecorator
276
+ }) : "",
277
+ /* @__PURE__ */ jsx("span", {
278
+ className: `${prefix}--text-area__counter-alert`,
279
+ role: "alert",
280
+ "aria-live": "assertive",
281
+ "aria-atomic": "true",
282
+ ref: announcerRef,
283
+ children: ariaAnnouncement
284
+ }),
285
+ isFluid && /* @__PURE__ */ jsx("hr", { className: `${prefix}--text-area__divider` }),
286
+ isFluid && invalid ? error : null,
287
+ isFluid && warn && !invalid ? warning : null
288
+ ]
289
+ }),
290
+ !invalid && !warn && !isFluid ? helper : null,
291
+ invalid && !isFluid ? error : null,
292
+ warn && !invalid && !isFluid ? warning : null
293
+ ]
294
+ });
323
295
  });
324
- TextArea.displayName = 'TextArea';
296
+ TextArea.displayName = "TextArea";
325
297
  TextArea.propTypes = {
326
- /**
327
- * Provide a custom className that is applied to the wrapper node
328
- */
329
- className: PropTypes.string,
330
- /**
331
- * Specify the `cols` attribute for the underlying `<textarea>` node
332
- */
333
- cols: PropTypes.number,
334
- /**
335
- * Specify the method used for calculating the counter number
336
- */
337
- counterMode: PropTypes.oneOf(['character', 'word']),
338
- /**
339
- * **Experimental**: Provide a `decorator` component to be rendered inside the `TextArea` component
340
- */
341
- decorator: PropTypes.node,
342
- /**
343
- * Optionally provide the default value of the `<textarea>`
344
- */
345
- defaultValue: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
346
- /**
347
- * Specify whether the control is disabled
348
- */
349
- disabled: PropTypes.bool,
350
- /**
351
- * Specify whether to display the counter
352
- */
353
- enableCounter: PropTypes.bool,
354
- /**
355
- * Provide text that is used alongside the control label for additional help
356
- */
357
- helperText: PropTypes.node,
358
- /**
359
- * Specify whether you want the underlying label to be visually hidden
360
- */
361
- hideLabel: PropTypes.bool,
362
- /**
363
- * Provide a unique identifier for the control
364
- */
365
- id: PropTypes.string,
366
- /**
367
- * Specify whether the control is currently invalid
368
- */
369
- invalid: PropTypes.bool,
370
- /**
371
- * Provide the text that is displayed when the control is in an invalid state
372
- */
373
- invalidText: PropTypes.node,
374
- /**
375
- * Provide the text that will be read by a screen reader when visiting this
376
- * control
377
- */
378
- labelText: PropTypes.node.isRequired,
379
- /**
380
- * `true` to use the light version. For use on $ui-01 backgrounds only.
381
- * Don't use this to make tile background color same as container background color.
382
- */
383
- light: deprecate(PropTypes.bool, 'The `light` prop for `TextArea` has ' + 'been deprecated in favor of the new `Layer` component. It will be removed in the next major release.'),
384
- /**
385
- * Max entity count allowed for the textarea. This is needed in order for enableCounter to display
386
- */
387
- maxCount: PropTypes.number,
388
- /**
389
- * Optionally provide an `onChange` handler that is called whenever `<textarea>`
390
- * is updated
391
- */
392
- onChange: PropTypes.func,
393
- /**
394
- * Optionally provide an `onClick` handler that is called whenever the
395
- * `<textarea>` is clicked
396
- */
397
- onClick: PropTypes.func,
398
- /**
399
- * Optionally provide an `onKeyDown` handler that is called whenever `<textarea>`
400
- * is keyed
401
- */
402
- onKeyDown: PropTypes.func,
403
- /**
404
- * Specify the placeholder attribute for the `<textarea>`
405
- */
406
- placeholder: PropTypes.string,
407
- /**
408
- * Whether the textarea should be read-only
409
- */
410
- readOnly: PropTypes.bool,
411
- /**
412
- * Specify the rows attribute for the `<textarea>`
413
- */
414
- rows: PropTypes.number,
415
- /**
416
- * **Experimental**: Provide a `Slug` component to be rendered inside the `TextArea` component
417
- */
418
- slug: deprecate(PropTypes.node, 'The `slug` prop for `TextArea` has ' + 'been deprecated in favor of the new `decorator` prop. It will be removed in the next major release.'),
419
- /**
420
- * Provide the current value of the `<textarea>`
421
- */
422
- value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
423
- /**
424
- * Specify whether the control is currently in warning state
425
- */
426
- warn: PropTypes.bool,
427
- /**
428
- * Provide the text that is displayed when the control is in warning state
429
- */
430
- warnText: PropTypes.node
298
+ className: PropTypes.string,
299
+ cols: PropTypes.number,
300
+ counterMode: PropTypes.oneOf(["character", "word"]),
301
+ decorator: PropTypes.node,
302
+ defaultValue: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
303
+ disabled: PropTypes.bool,
304
+ enableCounter: PropTypes.bool,
305
+ helperText: PropTypes.node,
306
+ hideLabel: PropTypes.bool,
307
+ id: PropTypes.string,
308
+ invalid: PropTypes.bool,
309
+ invalidText: PropTypes.node,
310
+ labelText: PropTypes.node.isRequired,
311
+ light: deprecate(PropTypes.bool, "The `light` prop for `TextArea` has been deprecated in favor of the new `Layer` component. It will be removed in the next major release."),
312
+ maxCount: PropTypes.number,
313
+ onChange: PropTypes.func,
314
+ onClick: PropTypes.func,
315
+ onKeyDown: PropTypes.func,
316
+ placeholder: PropTypes.string,
317
+ readOnly: PropTypes.bool,
318
+ rows: PropTypes.number,
319
+ slug: deprecate(PropTypes.node, "The `slug` prop for `TextArea` has been deprecated in favor of the new `decorator` prop. It will be removed in the next major release."),
320
+ value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
321
+ warn: PropTypes.bool,
322
+ warnText: PropTypes.node
431
323
  };
432
324
 
433
- export { TextArea as default };
325
+ //#endregion
326
+ export { TextArea as default };