@splunk/react-ui 5.1.0 → 5.2.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 (408) hide show
  1. package/Accordion.js +60 -39
  2. package/Anchor.js +9 -9
  3. package/Animation.js +2 -2
  4. package/Avatar.js +10 -10
  5. package/Box.js +2 -2
  6. package/Breadcrumbs.js +13 -13
  7. package/Button.js +12 -12
  8. package/ButtonGroup.js +9 -9
  9. package/ButtonSimple.js +2 -2
  10. package/CHANGELOG.md +23 -0
  11. package/Calendar.js +61 -61
  12. package/Card.js +286 -255
  13. package/CardLayout.js +10 -10
  14. package/Chip.js +31 -31
  15. package/Clickable.js +29 -29
  16. package/Code.js +15 -15
  17. package/CollapsiblePanel.js +93 -91
  18. package/Color.js +10 -10
  19. package/ColumnLayout.js +16 -16
  20. package/ComboBox.js +110 -110
  21. package/ControlGroup.js +99 -99
  22. package/Date.js +62 -62
  23. package/DefinitionList.js +124 -104
  24. package/Divider.js +2 -2
  25. package/DualListbox.js +178 -173
  26. package/File.js +22 -22
  27. package/FormRows.js +15 -15
  28. package/Heading.js +15 -15
  29. package/Image.js +31 -31
  30. package/JSONTree.js +492 -476
  31. package/Layer.js +4 -1
  32. package/Layout.js +10 -10
  33. package/Link.js +2 -2
  34. package/List.js +24 -24
  35. package/Markdown.js +102 -102
  36. package/Menu.js +21 -20
  37. package/Message.js +20 -20
  38. package/MessageBar.js +13 -13
  39. package/Modal.js +33 -33
  40. package/Monogram.js +94 -68
  41. package/Multiselect.js +822 -719
  42. package/Number.js +18 -18
  43. package/Paginator.js +39 -39
  44. package/Paragraph.js +10 -10
  45. package/Popover.js +243 -208
  46. package/Progress.js +6 -6
  47. package/Prose.js +16 -16
  48. package/RadioBar.js +118 -118
  49. package/RadioList.js +137 -113
  50. package/Resize.js +20 -20
  51. package/ResultsMenu.js +48 -48
  52. package/ScreenReaderContent.js +13 -13
  53. package/Scroll.js +24 -24
  54. package/Search.js +25 -25
  55. package/Select.js +941 -838
  56. package/SidePanel.js +29 -29
  57. package/Slider.js +30 -30
  58. package/SlidingPanels.js +28 -28
  59. package/SplitButton.js +100 -72
  60. package/StaticContent.js +6 -6
  61. package/StepBar.js +8 -8
  62. package/Switch.js +2 -2
  63. package/TabBar.js +293 -270
  64. package/TabLayout.js +68 -68
  65. package/Table.js +807 -790
  66. package/Text.js +2 -2
  67. package/TextArea.js +16 -16
  68. package/Tooltip.js +22 -22
  69. package/TransitionOpen.js +11 -11
  70. package/Tree.js +194 -189
  71. package/Typography.js +15 -15
  72. package/WaitSpinner.js +6 -6
  73. package/package.json +15 -18
  74. package/types/src/Accordion/docs/examples/Controlled.d.ts +3 -0
  75. package/types/src/Accordion/docs/examples/Inset.d.ts +4 -0
  76. package/types/src/Accordion/docs/examples/Uncontrolled.d.ts +3 -0
  77. package/types/src/Anchor/docs/examples/Basic.d.ts +4 -0
  78. package/types/src/AnimationToggle/docs/examples/Provider.d.ts +4 -0
  79. package/types/src/AnimationToggle/docs/examples/ReducedMotionComponent.d.ts +4 -0
  80. package/types/src/AnimationToggle/docs/examples/ReducedMotionHook.d.ts +4 -0
  81. package/types/src/AnimationToggle/docs/examples/ToggleComponent.d.ts +4 -0
  82. package/types/src/Avatar/docs/examples/BackgroundColor.d.ts +4 -0
  83. package/types/src/Avatar/docs/examples/Basic.d.ts +4 -0
  84. package/types/src/Avatar/docs/examples/Image.d.ts +4 -0
  85. package/types/src/Avatar/docs/examples/Interactive.d.ts +4 -0
  86. package/types/src/Avatar/docs/examples/Size.d.ts +4 -0
  87. package/types/src/Breadcrumbs/docs/examples/Adornments.d.ts +4 -0
  88. package/types/src/Breadcrumbs/docs/examples/Basic.d.ts +3 -0
  89. package/types/src/Breadcrumbs/docs/examples/CustomizedClick.d.ts +4 -0
  90. package/types/src/Button/docs/examples/Basic.d.ts +3 -0
  91. package/types/src/Button/docs/examples/Block.d.ts +4 -0
  92. package/types/src/Button/docs/examples/Disabled.d.ts +4 -0
  93. package/types/src/Button/docs/examples/Icons.d.ts +4 -0
  94. package/types/src/Button/docs/examples/Menus.d.ts +4 -0
  95. package/types/src/Button/docs/examples/To.d.ts +4 -0
  96. package/types/src/ButtonGroup/docs/examples/Basic.d.ts +3 -0
  97. package/types/src/Card/docs/examples/Basic.d.ts +4 -0
  98. package/types/src/Card/docs/examples/Clickable.d.ts +4 -0
  99. package/types/src/Card/docs/examples/Full.d.ts +4 -0
  100. package/types/src/Card/docs/examples/HeadingTitle.d.ts +4 -0
  101. package/types/src/Card/docs/examples/Images.d.ts +4 -0
  102. package/types/src/Card/docs/examples/Selectable.d.ts +4 -0
  103. package/types/src/CardLayout/docs/examples/Basic.d.ts +3 -0
  104. package/types/src/CardLayout/docs/examples/Interactive.d.ts +4 -0
  105. package/types/src/Chip/docs/examples/Appearance.d.ts +3 -0
  106. package/types/src/Chip/docs/examples/CustomColors.d.ts +4 -0
  107. package/types/src/Chip/docs/examples/Disabled.d.ts +3 -0
  108. package/types/src/Chip/docs/examples/Icon.d.ts +3 -0
  109. package/types/src/Chip/docs/examples/Removable.d.ts +3 -0
  110. package/types/src/Chip/docs/examples/RemovableWithNonStringChildren.d.ts +4 -0
  111. package/types/src/Clickable/docs/examples/Disabled.d.ts +4 -0
  112. package/types/src/Code/docs/examples/Default.d.ts +3 -0
  113. package/types/src/Code/docs/examples/HideIndent.d.ts +4 -0
  114. package/types/src/Code/docs/examples/Language.d.ts +4 -0
  115. package/types/src/Code/docs/examples/LineHighlights.d.ts +4 -0
  116. package/types/src/Code/docs/examples/LineNumbers.d.ts +4 -0
  117. package/types/src/Code/docs/examples/LineNumbersCustomStart.d.ts +4 -0
  118. package/types/src/CollapsiblePanel/docs/examples/Actions.d.ts +4 -0
  119. package/types/src/CollapsiblePanel/docs/examples/BasicControlled.d.ts +3 -0
  120. package/types/src/CollapsiblePanel/docs/examples/BasicUncontrolled.d.ts +3 -0
  121. package/types/src/CollapsiblePanel/docs/examples/Disabled.d.ts +7 -0
  122. package/types/src/CollapsiblePanel/docs/examples/MultiControlled.d.ts +3 -0
  123. package/types/src/CollapsiblePanel/docs/examples/MultiUncontrolled.d.ts +3 -0
  124. package/types/src/CollapsiblePanel/docs/examples/SingleOpenPanelGroupControlled.d.ts +4 -0
  125. package/types/src/CollapsiblePanel/docs/examples/SingleOpenPanelGroupInset.d.ts +4 -0
  126. package/types/src/CollapsiblePanel/docs/examples/SingleOpenPanelGroupUncontrolled.d.ts +4 -0
  127. package/types/src/CollapsiblePanel/docs/examples/Subtle.d.ts +4 -0
  128. package/types/src/Color/docs/examples/Controlled.d.ts +3 -0
  129. package/types/src/Color/docs/examples/CustomizedPalette.d.ts +4 -0
  130. package/types/src/Color/docs/examples/HideInput.d.ts +4 -0
  131. package/types/src/Color/docs/examples/Null.d.ts +4 -0
  132. package/types/src/Color/docs/examples/ThemeVariables.d.ts +4 -0
  133. package/types/src/Color/docs/examples/Transparent.d.ts +4 -0
  134. package/types/src/Color/docs/examples/Uncontrolled.d.ts +3 -0
  135. package/types/src/ColumnLayout/docs/examples/AlignItems.d.ts +4 -0
  136. package/types/src/ColumnLayout/docs/examples/Basic.d.ts +4 -0
  137. package/types/src/ColumnLayout/docs/examples/Dividers.d.ts +4 -0
  138. package/types/src/ColumnLayout/docs/examples/Gutters.d.ts +4 -0
  139. package/types/src/ComboBox/docs/examples/Controlled.d.ts +4 -0
  140. package/types/src/ComboBox/docs/examples/Fetching.d.ts +4 -0
  141. package/types/src/ComboBox/docs/examples/Headings.d.ts +3 -0
  142. package/types/src/ComboBox/docs/examples/Label.d.ts +4 -0
  143. package/types/src/ComboBox/docs/examples/Uncontrolled.d.ts +4 -0
  144. package/types/src/ControlGroup/docs/examples/Basic.d.ts +4 -0
  145. package/types/src/ControlGroup/docs/examples/CustomizedLabelTarget.d.ts +4 -0
  146. package/types/src/ControlGroup/docs/examples/Error.d.ts +4 -0
  147. package/types/src/ControlGroup/docs/examples/HelpWithErrorText.d.ts +4 -0
  148. package/types/src/ControlGroup/docs/examples/HelpWithLinks.d.ts +4 -0
  149. package/types/src/ControlGroup/docs/examples/LabelLeft.d.ts +4 -0
  150. package/types/src/ControlGroup/docs/examples/LayoutFill.d.ts +4 -0
  151. package/types/src/ControlGroup/docs/examples/LayoutFillJoin.d.ts +4 -0
  152. package/types/src/ControlGroup/docs/examples/LayoutNone.d.ts +4 -0
  153. package/types/src/ControlGroup/docs/examples/Required.d.ts +4 -0
  154. package/types/src/Date/docs/examples/Basic.d.ts +3 -0
  155. package/types/src/Date/docs/examples/Controlled.d.ts +3 -0
  156. package/types/src/Date/docs/examples/CustomDate.d.ts +4 -0
  157. package/types/src/Date/docs/examples/Disabled.d.ts +3 -0
  158. package/types/src/Date/docs/examples/Error.d.ts +3 -0
  159. package/types/src/Date/docs/examples/HighlightToday.d.ts +4 -0
  160. package/types/src/Date/docs/examples/WithoutCalendar.d.ts +4 -0
  161. package/types/src/DefinitionList/DefinitionList.d.ts +22 -4
  162. package/types/src/DefinitionList/DefinitionListContext.d.ts +2 -0
  163. package/types/src/DefinitionList/docs/examples/Basic.d.ts +3 -0
  164. package/types/src/DefinitionList/docs/examples/CustomizedWidths.d.ts +7 -0
  165. package/types/src/DefinitionList/docs/examples/EmptyDescription.d.ts +4 -0
  166. package/types/src/DefinitionList/docs/examples/WithSeparator.d.ts +4 -0
  167. package/types/src/Divider/docs/examples/Appearance.d.ts +4 -0
  168. package/types/src/Divider/docs/examples/Basic.d.ts +3 -0
  169. package/types/src/Divider/docs/examples/CustomStyle.d.ts +4 -0
  170. package/types/src/Divider/docs/examples/Decorative.d.ts +4 -0
  171. package/types/src/Divider/docs/examples/Vertical.d.ts +3 -0
  172. package/types/src/Dropdown/docs/examples/Basic.d.ts +4 -0
  173. package/types/src/Dropdown/docs/examples/BasicMenu.d.ts +3 -0
  174. package/types/src/Dropdown/docs/examples/ControlledDropdown.d.ts +4 -0
  175. package/types/src/Dropdown/docs/examples/Dialog.d.ts +4 -0
  176. package/types/src/Dropdown/docs/examples/ScrollContainer.d.ts +4 -0
  177. package/types/src/Dropdown/docs/examples/ScrollingMenu.d.ts +4 -0
  178. package/types/src/Dropdown/docs/examples/Submenu.d.ts +3 -0
  179. package/types/src/Dropdown/docs/examples/TooltipButtonToggle.d.ts +4 -0
  180. package/types/src/DualListbox/Option.d.ts +1 -1
  181. package/types/src/DualListbox/docs/examples/Basic.d.ts +3 -0
  182. package/types/src/DualListbox/docs/examples/Controlled.d.ts +3 -0
  183. package/types/src/DualListbox/docs/examples/Fill.d.ts +4 -0
  184. package/types/src/File/docs/examples/CustomizedMessages.d.ts +4 -0
  185. package/types/src/File/docs/examples/Disabled.d.ts +3 -0
  186. package/types/src/File/docs/examples/DropAnywhere.d.ts +4 -0
  187. package/types/src/File/docs/examples/Error.d.ts +4 -0
  188. package/types/src/File/docs/examples/FullScreen.d.ts +4 -0
  189. package/types/src/File/docs/examples/Multi.d.ts +4 -0
  190. package/types/src/File/docs/examples/Progress.d.ts +4 -0
  191. package/types/src/File/docs/examples/Single.d.ts +4 -0
  192. package/types/src/FormRows/docs/examples/Basic.d.ts +3 -0
  193. package/types/src/FormRows/docs/examples/Header.d.ts +4 -0
  194. package/types/src/FormRows/docs/examples/Menu.d.ts +4 -0
  195. package/types/src/FormRows/docs/examples/ReorderOnly.d.ts +4 -0
  196. package/types/src/Heading/docs/examples/Basic.d.ts +3 -0
  197. package/types/src/Heading/docs/examples/Variant.d.ts +4 -0
  198. package/types/src/Image/docs/examples/Basic.d.ts +3 -0
  199. package/types/src/JSONTree/docs/examples/Basic.d.ts +3 -0
  200. package/types/src/JSONTree/docs/examples/Events.d.ts +4 -0
  201. package/types/src/JSONTree/docs/examples/ExpandChildrenOnShiftKey.d.ts +4 -0
  202. package/types/src/Layer/docs/examples/Basic.d.ts +4 -0
  203. package/types/src/Layout/docs/examples/Basic.d.ts +3 -0
  204. package/types/src/Link/docs/examples/Basic.d.ts +4 -0
  205. package/types/src/Link/docs/examples/Disabled.d.ts +4 -0
  206. package/types/src/Link/docs/examples/NewWindow.d.ts +4 -0
  207. package/types/src/Link/docs/examples/Standalone.d.ts +4 -0
  208. package/types/src/List/docs/examples/CustomizedList.d.ts +4 -0
  209. package/types/src/List/docs/examples/OrderedList.d.ts +4 -0
  210. package/types/src/List/docs/examples/UnorderedList.d.ts +3 -0
  211. package/types/src/Markdown/docs/examples/Basic.d.ts +4 -0
  212. package/types/src/Markdown/docs/examples/I18n.d.ts +4 -0
  213. package/types/src/Menu/Item.d.ts +27 -10
  214. package/types/src/Menu/docs/examples/Adornments.d.ts +4 -0
  215. package/types/src/Menu/docs/examples/Basic.d.ts +3 -0
  216. package/types/src/Menu/docs/examples/Complex.d.ts +4 -0
  217. package/types/src/Menu/docs/examples/Descriptions.d.ts +4 -0
  218. package/types/src/Menu/docs/examples/Dimmed.d.ts +4 -0
  219. package/types/src/Menu/docs/examples/Disabled.d.ts +3 -0
  220. package/types/src/Menu/docs/examples/Dividers.d.ts +3 -0
  221. package/types/src/Menu/docs/examples/Headings.d.ts +4 -0
  222. package/types/src/Menu/docs/examples/Links.d.ts +4 -0
  223. package/types/src/Menu/docs/examples/MatchRanges.d.ts +4 -0
  224. package/types/src/Menu/docs/examples/Selectable.d.ts +4 -0
  225. package/types/src/Menu/docs/examples/SelectableWithAdornments.d.ts +4 -0
  226. package/types/src/Menu/docs/examples/Truncate.d.ts +4 -0
  227. package/types/src/Message/docs/examples/Basic.d.ts +3 -0
  228. package/types/src/Message/docs/examples/Content.d.ts +4 -0
  229. package/types/src/Message/docs/examples/Fill.d.ts +3 -0
  230. package/types/src/Message/docs/examples/Removable.d.ts +3 -0
  231. package/types/src/MessageBar/docs/examples/Basic.d.ts +4 -0
  232. package/types/src/MessageBar/docs/examples/Types.d.ts +4 -0
  233. package/types/src/MessageBar/docs/examples/WithActions.d.ts +3 -0
  234. package/types/src/Modal/Modal.d.ts +10 -3
  235. package/types/src/Modal/docs/examples/Basic.d.ts +3 -0
  236. package/types/src/Modal/docs/examples/InitialFocus.d.ts +4 -0
  237. package/types/src/Modal/docs/examples/TypicalUsage.d.ts +4 -0
  238. package/types/src/Modal/docs/examples/Undismissable.d.ts +4 -0
  239. package/types/src/Monogram/Monogram.d.ts +4 -0
  240. package/types/src/Monogram/docs/examples/BackgroundAuto.d.ts +4 -0
  241. package/types/src/Monogram/docs/examples/BackgroundCustom.d.ts +3 -0
  242. package/types/src/Monogram/docs/examples/Basic.d.ts +4 -0
  243. package/types/src/Monogram/docs/examples/Interactive.d.ts +4 -0
  244. package/types/src/Monogram/docs/examples/Size.d.ts +4 -0
  245. package/types/src/Multiselect/Compact.d.ts +1 -1
  246. package/types/src/Multiselect/Multiselect.d.ts +1 -1
  247. package/types/src/Multiselect/docs/examples/Children.d.ts +4 -0
  248. package/types/src/Multiselect/docs/examples/Compact.d.ts +4 -0
  249. package/types/src/Multiselect/docs/examples/Controlled.d.ts +3 -0
  250. package/types/src/Multiselect/docs/examples/CustomizeSelected.d.ts +4 -0
  251. package/types/src/Multiselect/docs/examples/Disabled.d.ts +3 -0
  252. package/types/src/Multiselect/docs/examples/Error.d.ts +3 -0
  253. package/types/src/Multiselect/docs/examples/Fetching.d.ts +4 -0
  254. package/types/src/Multiselect/docs/examples/Headings.d.ts +3 -0
  255. package/types/src/Multiselect/docs/examples/Icons.d.ts +3 -0
  256. package/types/src/Multiselect/docs/examples/LoadMoreOnScrollBottom.d.ts +4 -0
  257. package/types/src/Multiselect/docs/examples/NewValues.d.ts +4 -0
  258. package/types/src/Multiselect/docs/examples/TabInput.d.ts +4 -0
  259. package/types/src/Multiselect/docs/examples/Uncontrolled.d.ts +3 -0
  260. package/types/src/Number/docs/examples/Basic.d.ts +4 -0
  261. package/types/src/Number/docs/examples/Disabled.d.ts +3 -0
  262. package/types/src/Number/docs/examples/Error.d.ts +3 -0
  263. package/types/src/Number/docs/examples/Limits.d.ts +4 -0
  264. package/types/src/Number/docs/examples/Locale.d.ts +4 -0
  265. package/types/src/Number/docs/examples/Uncontrolled.d.ts +4 -0
  266. package/types/src/Paginator/docs/examples/Basic.d.ts +3 -0
  267. package/types/src/Paginator/docs/examples/Compact.d.ts +4 -0
  268. package/types/src/Paginator/docs/examples/CompactCustomLabel.d.ts +3 -0
  269. package/types/src/Paginator/docs/examples/CompactWithLabel.d.ts +3 -0
  270. package/types/src/Paginator/docs/examples/CustomPages.d.ts +4 -0
  271. package/types/src/Paginator/docs/examples/Labelled.d.ts +4 -0
  272. package/types/src/Paginator/docs/examples/PageControl.d.ts +4 -0
  273. package/types/src/Paragraph/docs/examples/Basic.d.ts +4 -0
  274. package/types/src/Popover/PopoverProvider.d.ts +9 -1
  275. package/types/src/Popover/docs/examples/Basic.d.ts +4 -0
  276. package/types/src/Progress/docs/examples/Basic.d.ts +3 -0
  277. package/types/src/Progress/docs/examples/Type.d.ts +3 -0
  278. package/types/src/Prose/docs/examples/Basic.d.ts +3 -0
  279. package/types/src/Prose/docs/examples/Customize.d.ts +4 -0
  280. package/types/src/RadioBar/docs/examples/AdornmentAriaExamples.d.ts +5 -0
  281. package/types/src/RadioBar/docs/examples/Basic.d.ts +3 -0
  282. package/types/src/RadioBar/docs/examples/Disabled.d.ts +4 -0
  283. package/types/src/RadioBar/docs/examples/Error.d.ts +3 -0
  284. package/types/src/RadioBar/docs/examples/MenuBar.d.ts +4 -0
  285. package/types/src/RadioBar/docs/examples/Uncontrolled.d.ts +3 -0
  286. package/types/src/RadioList/docs/examples/Basic.d.ts +4 -0
  287. package/types/src/RadioList/docs/examples/Disabled.d.ts +3 -0
  288. package/types/src/RadioList/docs/examples/Error.d.ts +3 -0
  289. package/types/src/RadioList/docs/examples/Row.d.ts +3 -0
  290. package/types/src/RadioList/docs/examples/Uncontrolled.d.ts +4 -0
  291. package/types/src/Resize/docs/examples/Appearance.d.ts +4 -0
  292. package/types/src/Resize/docs/examples/Basic.d.ts +4 -0
  293. package/types/src/Resize/docs/examples/Percentage.d.ts +4 -0
  294. package/types/src/Resize/docs/examples/SizingInner.d.ts +4 -0
  295. package/types/src/Resize/docs/examples/SizingOuter.d.ts +4 -0
  296. package/types/src/ScreenReaderContent/docs/examples/Basic.d.ts +4 -0
  297. package/types/src/ScreenReaderContent/docs/examples/SkipLink.d.ts +4 -0
  298. package/types/src/Scroll/docs/examples/Controlled.d.ts +4 -0
  299. package/types/src/Scroll/docs/examples/Uncontrolled.d.ts +4 -0
  300. package/types/src/ScrollContainerContext/docs/examples/Provider.d.ts +4 -0
  301. package/types/src/Search/docs/examples/Controlled.d.ts +4 -0
  302. package/types/src/Search/docs/examples/Loading.d.ts +4 -0
  303. package/types/src/Search/docs/examples/Options.d.ts +4 -0
  304. package/types/src/Search/docs/examples/OptionsLinks.d.ts +4 -0
  305. package/types/src/Select/SelectAllOption.d.ts +5 -10
  306. package/types/src/Select/SelectBase.d.ts +1 -1
  307. package/types/src/Select/docs/examples/Appearance.d.ts +4 -0
  308. package/types/src/Select/docs/examples/Basic.d.ts +4 -0
  309. package/types/src/Select/docs/examples/Children.d.ts +4 -0
  310. package/types/src/Select/docs/examples/Descriptions.d.ts +4 -0
  311. package/types/src/Select/docs/examples/Error.d.ts +3 -0
  312. package/types/src/Select/docs/examples/Fetching.d.ts +4 -0
  313. package/types/src/Select/docs/examples/Filter.d.ts +4 -0
  314. package/types/src/Select/docs/examples/Headings.d.ts +3 -0
  315. package/types/src/Select/docs/examples/Icons.d.ts +3 -0
  316. package/types/src/Select/docs/examples/LoadMoreOnScrollBottom.d.ts +4 -0
  317. package/types/src/Select/docs/examples/Prefix.d.ts +4 -0
  318. package/types/src/Select/docs/examples/Truncate.d.ts +4 -0
  319. package/types/src/Select/docs/examples/Uncontrolled.d.ts +4 -0
  320. package/types/src/SidePanel/docs/examples/Basic.d.ts +4 -0
  321. package/types/src/SidePanel/docs/examples/ChangeSize.d.ts +3 -0
  322. package/types/src/SidePanel/docs/examples/Composition.d.ts +4 -0
  323. package/types/src/Slider/docs/examples/Basic.d.ts +3 -0
  324. package/types/src/Slider/docs/examples/Controlled.d.ts +4 -0
  325. package/types/src/Slider/docs/examples/CustomLabels.d.ts +4 -0
  326. package/types/src/Slider/docs/examples/Disabled.d.ts +3 -0
  327. package/types/src/Slider/docs/examples/Error.d.ts +3 -0
  328. package/types/src/Slider/docs/examples/StepMarks.d.ts +4 -0
  329. package/types/src/SlidingPanels/docs/examples/Basic.d.ts +3 -0
  330. package/types/src/SlidingPanels/docs/examples/Dropdown.d.ts +3 -0
  331. package/types/src/SlidingPanels/docs/examples/Modal.d.ts +3 -0
  332. package/types/src/SplitButton/SplitButton.d.ts +6 -1
  333. package/types/src/SplitButton/docs/examples/Basic.d.ts +3 -0
  334. package/types/src/SplitButton/docs/examples/Block.d.ts +4 -0
  335. package/types/src/SplitButton/docs/examples/ChangeLabel.d.ts +4 -0
  336. package/types/src/SplitButton/docs/examples/Disabled.d.ts +3 -0
  337. package/types/src/StaticContent/docs/examples/Basic.d.ts +4 -0
  338. package/types/src/StaticContent/docs/examples/FieldValue.d.ts +4 -0
  339. package/types/src/StepBar/docs/examples/Basic.d.ts +3 -0
  340. package/types/src/StepBar/docs/examples/Error.d.ts +3 -0
  341. package/types/src/Switch/docs/examples/Basic.d.ts +4 -0
  342. package/types/src/Switch/docs/examples/Disabled.d.ts +3 -0
  343. package/types/src/Switch/docs/examples/Error.d.ts +3 -0
  344. package/types/src/TabBar/docs/examples/Basic.d.ts +3 -0
  345. package/types/src/TabBar/docs/examples/Disabled.d.ts +3 -0
  346. package/types/src/TabBar/docs/examples/Icons.d.ts +3 -0
  347. package/types/src/TabBar/docs/examples/Tooltips.d.ts +3 -0
  348. package/types/src/TabBar/docs/examples/Vertical.d.ts +3 -0
  349. package/types/src/TabBar/docs/examples/VerticalIcons.d.ts +3 -0
  350. package/types/src/TabBar/docs/examples/WithCount.d.ts +3 -0
  351. package/types/src/TabBar/tabBarUtils.d.ts +4 -0
  352. package/types/src/TabBar/types.d.ts +5 -0
  353. package/types/src/TabLayout/docs/examples/AutoActivate.d.ts +4 -0
  354. package/types/src/TabLayout/docs/examples/Controlled.d.ts +4 -0
  355. package/types/src/TabLayout/docs/examples/Icons.d.ts +3 -0
  356. package/types/src/TabLayout/docs/examples/Uncontrolled.d.ts +3 -0
  357. package/types/src/TabLayout/docs/examples/Vertical.d.ts +3 -0
  358. package/types/src/TabLayout/docs/examples/VerticalIcons.d.ts +3 -0
  359. package/types/src/Table/docs/examples/Basic.d.ts +3 -0
  360. package/types/src/Table/docs/examples/Click.d.ts +4 -0
  361. package/types/src/Table/docs/examples/ClickRows.d.ts +4 -0
  362. package/types/src/Table/docs/examples/Complex.d.ts +4 -0
  363. package/types/src/Table/docs/examples/DockedHeaderScrollbar.d.ts +4 -0
  364. package/types/src/Table/docs/examples/FilterColumnValues.d.ts +4 -0
  365. package/types/src/Table/docs/examples/FixedHeader.d.ts +4 -0
  366. package/types/src/Table/docs/examples/HeadDropdownCell.d.ts +4 -0
  367. package/types/src/Table/docs/examples/ReorderColumns.d.ts +4 -0
  368. package/types/src/Table/docs/examples/ReorderRows.d.ts +4 -0
  369. package/types/src/Table/docs/examples/Resizable.d.ts +4 -0
  370. package/types/src/Table/docs/examples/ResizableFill.d.ts +4 -0
  371. package/types/src/Table/docs/examples/RowActions.d.ts +4 -0
  372. package/types/src/Table/docs/examples/Selectable.d.ts +4 -0
  373. package/types/src/Table/docs/examples/SortableColumns.d.ts +4 -0
  374. package/types/src/Table/docs/examples/StripeRows.d.ts +3 -0
  375. package/types/src/Text/docs/examples/Basic.d.ts +4 -0
  376. package/types/src/Text/docs/examples/CustomizedIcon.d.ts +4 -0
  377. package/types/src/Text/docs/examples/Dimmed.d.ts +4 -0
  378. package/types/src/Text/docs/examples/Disabled.d.ts +4 -0
  379. package/types/src/Text/docs/examples/Error.d.ts +4 -0
  380. package/types/src/Text/docs/examples/Inline.d.ts +4 -0
  381. package/types/src/Text/docs/examples/Password.d.ts +4 -0
  382. package/types/src/Text/docs/examples/Uncontrolled.d.ts +4 -0
  383. package/types/src/TextArea/docs/examples/Basic.d.ts +4 -0
  384. package/types/src/TextArea/docs/examples/Disabled.d.ts +3 -0
  385. package/types/src/TextArea/docs/examples/Error.d.ts +4 -0
  386. package/types/src/TextArea/docs/examples/Inline.d.ts +4 -0
  387. package/types/src/TextArea/docs/examples/Uncontrolled.d.ts +4 -0
  388. package/types/src/Tooltip/docs/examples/Basic.d.ts +4 -0
  389. package/types/src/Tooltip/docs/examples/ContentRelationship.d.ts +4 -0
  390. package/types/src/Tooltip/docs/examples/Controlled.d.ts +4 -0
  391. package/types/src/Tooltip/docs/examples/CustomDelay.d.ts +4 -0
  392. package/types/src/Tooltip/docs/examples/CustomProps.d.ts +4 -0
  393. package/types/src/Tooltip/docs/examples/Toggletip.d.ts +4 -0
  394. package/types/src/TransitionOpen/docs/examples/ExpandHeight.d.ts +3 -0
  395. package/types/src/TransitionOpen/docs/examples/ExpandWidth.d.ts +3 -0
  396. package/types/src/TransitionOpen/docs/examples/None.d.ts +4 -0
  397. package/types/src/TransitionOpen/docs/examples/SlideFromBottom.d.ts +4 -0
  398. package/types/src/TransitionOpen/docs/examples/SlideFromLeft.d.ts +4 -0
  399. package/types/src/TransitionOpen/docs/examples/SlideFromRight.d.ts +4 -0
  400. package/types/src/TransitionOpen/docs/examples/SlideFromTop.d.ts +4 -0
  401. package/types/src/Tree/Item.d.ts +4 -4
  402. package/types/src/Tree/docs/examples/Basic.d.ts +5 -0
  403. package/types/src/Tree/docs/examples/ClickableExpansion.d.ts +2 -0
  404. package/types/src/Tree/docs/examples/ClickableExpansionWithSelection.d.ts +2 -0
  405. package/types/src/Typography/docs/examples/Basic.d.ts +4 -0
  406. package/types/src/WaitSpinner/docs/examples/Basic.d.ts +3 -0
  407. package/useResizeObserver.js +2 -2
  408. package/types/src/DefinitionList/docs/examples/Customize.d.ts +0 -3
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Error
4
+ * @description The File and File.Item have separate error states. Generally, they should not be used together. Either the File is in error (for example, required field), or an Item is in error (for example, incorrect file type).
5
+ */
2
6
  export default function FileErrors(): React.JSX.Element;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Full screen
4
+ * @description This example must open in a modal. There can only be one File component on the page. Dropping a file anywhere will upload the file.
5
+ */
2
6
  declare function Fullscreen(): React.JSX.Element;
3
7
  export default Fullscreen;
@@ -4,6 +4,10 @@ interface FileItem {
4
4
  name: string;
5
5
  value?: string | ArrayBuffer | null;
6
6
  }
7
+ /**
8
+ * @name Multifile
9
+ * @description By storing an array of items, multiple files can be supported.
10
+ */
7
11
  declare class Multi extends Component<object, {
8
12
  files: FileItem[];
9
13
  }> {
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Progress
4
+ * @description The File.Item can display its upload progress.
5
+ */
2
6
  export default function Progress(): React.JSX.Element;
@@ -1,5 +1,9 @@
1
1
  import React, { Component } from 'react';
2
2
  import { FileRequestAddHandler } from '@splunk/react-ui/File';
3
+ /**
4
+ * @name Single file
5
+ * @description Here, selecting a new file will replace the existing file.
6
+ */
3
7
  declare class Single extends Component<object, {
4
8
  filename?: string;
5
9
  }> {
@@ -1,5 +1,8 @@
1
1
  import React, { Component } from 'react';
2
2
  import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
3
+ /**
4
+ * @name Basic
5
+ */
3
6
  declare class Basic extends Component<object, {
4
7
  items: React.ReactElement[];
5
8
  }> {
@@ -1,5 +1,9 @@
1
1
  import React, { Component } from 'react';
2
2
  import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
3
+ /**
4
+ * @name Header
5
+ * @description Form Rows does not provide a concept of columns, but this can be simulated by adding content to the header and setting fixed widths on the elements. For accessibility compliance, ensure each heading has a unique id and form controls have a matching describedBy prop.
6
+ */
3
7
  declare class Header extends Component<object, {
4
8
  items: React.ReactElement[];
5
9
  }> {
@@ -1,6 +1,10 @@
1
1
  import React, { Component } from 'react';
2
2
  import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
3
3
  import { SelectChangeHandler } from '@splunk/react-ui/Select';
4
+ /**
5
+ * @name Custom add menu
6
+ * @description The 'Add row' button can be replaced with a button, multiple buttons, or any other content you want to show below the Form Rows.
7
+ */
4
8
  declare class Menu extends Component<object, {
5
9
  items: React.ReactElement[];
6
10
  }> {
@@ -1,5 +1,9 @@
1
1
  import React, { Component } from 'react';
2
2
  import { FormRowsRequestMoveHandler } from '@splunk/react-ui/FormRows';
3
+ /**
4
+ * @name Reorder only
5
+ * @description The add and delete functionality can be removed by not including the onRequestAdd handler on Form Rows and the onRequestRemove handler on Row. The functionality of reordering Rows will still remain intact. If users can add, they should be able to delete as well.
6
+ */
3
7
  declare class ReorderOnly extends Component<object, {
4
8
  items: React.ReactElement[];
5
9
  }> {
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Variant
4
+ * @description The level prop determines the <hX> HTML tag and has an associated default typography mixin style. To override this default styling, the variant prop can be used to specify a typography mixin style. For instance, it is possible for a variant to have title1 styling and be a <h2> tag as in the below example.
5
+ */
2
6
  declare function Variant(): React.JSX.Element;
3
7
  export default Variant;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,2 +1,5 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  export default function Basic(): React.JSX.Element;
@@ -1,5 +1,9 @@
1
1
  import React, { Component } from 'react';
2
2
  import { JSONTreeClickValueHandler, JSONTreeClickKeyHandler } from '@splunk/react-ui/JSONTree';
3
+ /**
4
+ * @name Click events
5
+ * @description Click the value to see the interaction.
6
+ */
3
7
  declare class Events extends Component<object, {
4
8
  key: string;
5
9
  keyPath?: (string | number)[];
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Expand children on shift key
4
+ * @description Shift + Click or Shift + Enter to expand all child nodes at once.
5
+ */
2
6
  export default function ExpandChildrenOnShiftKey(): React.JSX.Element;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ * @description This example shows a simple overlay that can be dismissed by pressing the Escape key.
5
+ */
2
6
  declare function Basic(): React.JSX.Element;
3
7
  export default Basic;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ * @description Use the Link component instead of an <a> tag, by default it is displayed inline.
5
+ */
2
6
  declare function Basic(): React.JSX.Element;
3
7
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Disabled
4
+ * @description Links can be disabled. The href is then removed from the markup.
5
+ */
2
6
  declare function Disabled(): React.JSX.Element;
3
7
  export default Disabled;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name New window
4
+ * @description openInNewContext=true adds an icon and sets target to _blank. A message indicates the behavior for screen reader users. The default message, '(Opens new window)', can be customized by by passing a string to openInNewContext.
5
+ */
2
6
  declare function NewWindow(): React.JSX.Element;
3
7
  export default NewWindow;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Standalone
4
+ * @description Use appearance="standalone" when using Link on its own without other text content.
5
+ */
2
6
  declare function Standalone(): React.JSX.Element;
3
7
  export default Standalone;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Customized list
4
+ * @description List style type can be customized using CSS.
5
+ */
2
6
  declare function CustomizedList(): React.JSX.Element;
3
7
  export default CustomizedList;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Ordered list
4
+ * @description Ordered Lists use numerals by default.
5
+ */
2
6
  declare function Ordered(): React.JSX.Element;
3
7
  export default Ordered;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Unordered list
4
+ */
2
5
  declare function UnorderedList(): React.JSX.Element;
3
6
  export default UnorderedList;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ * @description Most Markdown elements and capabilities are supported. HTML is not permitted.
5
+ */
2
6
  declare function BasicExample(): React.JSX.Element;
3
7
  export default BasicExample;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name I18n
4
+ * @description Combine with gettext interpolation.
5
+ */
2
6
  declare function I18nExample(): React.JSX.Element;
3
7
  export default I18nExample;
@@ -74,20 +74,25 @@ interface ItemPropsBase {
74
74
  */
75
75
  role?: 'menuitem' | 'menuitemradio' | 'menuitemcheckbox' | 'listboxitem' | 'option';
76
76
  /**
77
- * If selectable is true, whitespace is left where the checkmark can be shown.
77
+ * Enables selection for this item and reserves space for the control.
78
+ * Required when using `selected` or `selectableAppearance`.
78
79
  */
79
80
  selectable?: boolean;
80
81
  /**
81
- * If selectable is true, whitespace is left where the checkmark can be shown.
82
+ * Specifies the type of selection control to display when `selectable` is enabled.
82
83
  */
83
84
  selectableAppearance?: 'checkmark' | 'checkbox';
84
85
  /**
85
- * Indicates the selection state of the item.
86
- * - With `selectableAppearance='checkmark'`: if `selected` is `true`, a checkmark shows the item is selected.
87
- * - With `selectableAppearance='checkbox'`:
88
- * - `selected=true` renders a fully checked checkbox.
89
- * - `selected='some'` renders a partially checked (indeterminate) checkbox, corresponding to `aria-checked='mixed'`.
90
- * - `selected=false` renders an unchecked checkbox.
86
+ * Controls the selection state of the item.
87
+ * The selection control (checkmark or checkbox) is only rendered when `selectable` is enabled.
88
+ *
89
+ * When `selectableAppearance = 'checkmark'`:
90
+ * - `true` shows a checkmark.
91
+ *
92
+ * When `selectableAppearance = 'checkbox'`:
93
+ * - `true` renders a checked box.
94
+ * - `'some'` renders an indeterminate box (`aria-checked="mixed"`).
95
+ * - `false` renders an unchecked box.
91
96
  */
92
97
  selected?: boolean | 'some';
93
98
  /** Adornment in front of the label. */
@@ -101,8 +106,20 @@ interface ItemPropsBase {
101
106
  */
102
107
  truncate?: boolean;
103
108
  }
104
- type ItemButtonProps = ComponentProps<ItemPropsBase, 'button'>;
105
- type ItemLinkProps = ComponentProps<ItemPropsBase, 'a', 'href'>;
109
+ type SharedItemProps = Omit<ItemPropsBase, 'selectable' | 'selectableAppearance' | 'selected'>;
110
+ interface NonSelectableItemProps extends SharedItemProps {
111
+ selectable?: false;
112
+ selectableAppearance?: never;
113
+ selected?: never;
114
+ }
115
+ interface SelectableItemProps extends SharedItemProps {
116
+ selectable: true;
117
+ selectableAppearance?: 'checkmark' | 'checkbox';
118
+ selected?: boolean | 'some';
119
+ }
120
+ type ItemPropsCommon = NonSelectableItemProps | SelectableItemProps;
121
+ type ItemButtonProps = ComponentProps<ItemPropsCommon, 'button'>;
122
+ type ItemLinkProps = ComponentProps<ItemPropsCommon, 'a', 'href'>;
106
123
  type ItemProps = ItemButtonProps | ItemLinkProps;
107
124
  declare function Item({ active, children, description, descriptionPosition, disabled, endAdornment, elementRef, hasSubmenu, itemKey, matchRanges, onClick, onFocus, openInNewContext, role, selectable, selectableAppearance, selected, startAdornment, to, truncate, ...otherProps }: ItemProps): React.JSX.Element;
108
125
  declare namespace Item {
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Adornments
4
+ * @description A startAdornment and/or endAdornment can be added to a Menu.Item. Adornments should be decorative.
5
+ */
2
6
  declare function Adornments(): React.JSX.Element;
3
7
  export default Adornments;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Complex
4
+ * @description All the options can be used together. Additional props, such as hasSubmenu, are detailed in the following example.
5
+ */
2
6
  declare function Complex(): React.JSX.Element;
3
7
  export default Complex;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Descriptions
4
+ * @description Descriptions can be placed below or to the right of the label. Defaults to descriptionPosition="bottom".
5
+ */
2
6
  declare function Descriptions(): React.JSX.Element;
3
7
  export default Descriptions;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Dimmed
4
+ * @description If you absolutely need to disable a Menu Item use a dimmed Menu Item. When the disabled prop is set to "dimmed", the Menu Item does not respond to events but can still receive focus to ensure users can navigate to the Item when using assistive technologies. This also sets aria-disabled to true.
5
+ */
2
6
  declare function Dimmed(): React.JSX.Element;
3
7
  export default Dimmed;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Disabled
4
+ */
2
5
  declare function Disabled(): React.JSX.Element;
3
6
  export default Disabled;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Dividers
4
+ */
2
5
  declare function Dividers(): React.JSX.Element;
3
6
  export default Dividers;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Headings
4
+ * @description Menus can have headings to summarize the following items.
5
+ */
2
6
  declare function Headings(): React.JSX.Element;
3
7
  export default Headings;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Links
4
+ * @description Menu.Items can contain links by including a to attribute.
5
+ */
2
6
  declare function Links(): React.JSX.Element;
3
7
  export default Links;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Match ranges
4
+ * @description Menu.Item can highlight portions of the label as matching a filter or search.
5
+ */
2
6
  declare function MatchRanges(): React.JSX.Element;
3
7
  export default MatchRanges;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Selectable and selected
4
+ * @description Items can be selected or selectable, which ensures space is reserved for the checkmark.
5
+ */
2
6
  declare function Selectable(): React.JSX.Element;
3
7
  export default Selectable;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Selectable and selected with adornments
4
+ * @description Items with adornments can be selected or selectable.
5
+ */
2
6
  declare function SelectableWithAdornments(): React.JSX.Element;
3
7
  export default SelectableWithAdornments;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Truncation
4
+ * @description Labels that are too long can be optionally constrained to one line and truncated.
5
+ */
2
6
  declare function Truncate(): React.JSX.Element;
3
7
  export default Truncate;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Message types
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Content
4
+ * @description Message can contain text, links, and buttons. Interactive items should not be included in content when Message is being used as a toast.
5
+ */
2
6
  declare function Content(): React.JSX.Element;
3
7
  export default Content;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Fill
4
+ */
2
5
  declare function Fill(): React.JSX.Element;
3
6
  export default Fill;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Removable
4
+ */
2
5
  declare function Removable(): React.JSX.Element;
3
6
  export default Removable;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ * @description Message Bar is a landmark so that users can easily navigate to and discover the important information; therefore, they must include a label using aria-labelledby or aria-label. There are several ways to accomplish this so each of the examples on this page illustrates a different approach.
5
+ */
2
6
  declare function Basic(): React.JSX.Element;
3
7
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Types
4
+ * @description Message Bar can have one of four types: "info", "warning", "error" or "success".
5
+ */
2
6
  declare function Types(): React.JSX.Element;
3
7
  export default Types;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name With actions
4
+ */
2
5
  declare function WithActions(): React.JSX.Element;
3
6
  export default WithActions;
@@ -23,6 +23,13 @@ interface ModalPropsBase {
23
23
  /**
24
24
  * @private
25
25
  * Set to 'true' to enable closing the Modal by clicking outside of it.
26
+ *
27
+ * This behavior should be avoided as it can lead to accidental dismissal of the modal causing data loss or disruption of a user's workflow.
28
+ * Only enable click outside to dismiss when:
29
+ * - The modal content is non-critical or purely informational
30
+ * - Accidental dismissal will not result in loss of progress, data, or important context
31
+ *
32
+ * `onRequestClose` will receive an event with reason 'clickAway' when this happens.
26
33
  */
27
34
  closeOnClickAway?: boolean;
28
35
  /**
@@ -39,12 +46,12 @@ interface ModalPropsBase {
39
46
  */
40
47
  initialFocus?: ModalInitialFocus;
41
48
  /**
42
- * Called when a close event occurs. The callback is passed the event
43
- * and a reason, which is 'escapeKey', 'clickAway', or 'clickCloseButton'.
44
- *
49
+ * Called when a close event occurs.
45
50
  * When `Modal` includes this prop, a close button is displayed by default in the `Modal.Header`.
46
51
  * To hide the close button, pass the `hideCloseButton` prop to `Modal.Header`.
47
52
  *
53
+ * The callback is passed the event and a reason, which is 'escapeKey' or 'clickCloseButton'.
54
+ *
48
55
  * Generally, use this callback to toggle the `open` prop.
49
56
  */
50
57
  onRequestClose?: ModalRequestCloseHandler;
@@ -1,3 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ */
2
5
  declare function Basic(): React.JSX.Element;
3
6
  export default Basic;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Initial focus
4
+ * @description Initial focus can be set to an different element.
5
+ */
2
6
  declare function InitialFocus(): React.JSX.Element;
3
7
  export default InitialFocus;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Typical usage
4
+ * @description This example shows a basic Splunk UI-styled Modal. By default, the Modal takes on the width of the content, so ensure that the width is set on the children. Alternately, set width on the Modal or Modal.Body with an inline style. Use an inline style to set the width and height of the icon to fit the icon's container. Modals *must* return focus to the element that invoked the dialog (or another element that follows the logical flow of the application) on close. To automatically return focus to the invoking element on Modal close, pass the ref of the invoking element to Modal's returnFocus prop. If using a ref is not possible, you *must* manually return focus to the invoking element in a function passed to returnFocus. Additionally, Modals containing a form should not close when clickAway event occurs. See below for an example of how to implement these requirements.
5
+ */
2
6
  declare function TypicalUsage(): React.JSX.Element;
3
7
  export default TypicalUsage;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Undismissable
4
+ * @description To create a Modal that cannot be dismissed, omit the onClose callback.
5
+ */
2
6
  declare function Basic(): React.JSX.Element;
3
7
  export default Basic;
@@ -44,6 +44,10 @@ type MonogramProps = MonogramInteractiveProps | MonogramNonInteractiveProps;
44
44
  * @public
45
45
  */
46
46
  declare function getInitials(name: string): string;
47
+ /**
48
+ * @deprecated
49
+ * Monogram has been deprecated and will be removed in a future major version. Use Avatar instead.
50
+ */
47
51
  declare function Monogram({ backgroundColor, initials, size, ...otherProps }: MonogramProps): React.JSX.Element;
48
52
  declare namespace Monogram {
49
53
  var propTypes: {
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Auto background color
4
+ * @description The background color is derived from the initials prop if the backgroundColor prop is set to "auto". We do not recommend using "auto" background color because the existing built-in background color set might lead to color contrast issues. Please use a custom background color and ensure that it has sufficient color contrast with the initial&apos;s text color.
5
+ */
2
6
  export default function BackgroundAuto(): React.JSX.Element;
@@ -1,2 +1,5 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Custom background color
4
+ */
2
5
  export default function BackgroundCustom(): React.JSX.Element;
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Basic
4
+ * @description A Monogram can show one to three characters. You can use the getInitials helper to shorten a name.
5
+ */
2
6
  export default function Basic(): React.JSX.Element;
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Interactive
4
+ * @description A click handler can be added to enable interactivity.
5
+ */
2
6
  export default function Interactive(): React.JSX.Element;
@@ -1,2 +1,6 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Size
4
+ * @description Monograms can be one of three standard sizes: "small", "medium" (default), "large", or "xlarge" (deprecated). The size prop can also be a number if the standard size does not fit your use case. Note: using a non-standard size may have unexpected layouts when combined with other components.
5
+ */
2
6
  export default function Size(): React.JSX.Element;
@@ -129,7 +129,7 @@ interface CompactPropsBase {
129
129
  * @deprecatedValue 'buttongroup'
130
130
  * The 'buttongroup' value is deprecated and will be removed in a future major version.
131
131
  */
132
- selectAllAppearance?: 'buttongroup' | 'checkbox';
132
+ selectAllAppearance?: 'buttongroup' | 'checkbox' | 'none';
133
133
  /**
134
134
  * Move selected values to the top of the list on next open, immediately, or not at all.
135
135
  */
@@ -154,7 +154,7 @@ interface MultiselectPropsBase {
154
154
  * @deprecatedValue 'buttongroup'
155
155
  * The 'buttongroup' value is deprecated and will be removed in a future major version.
156
156
  */
157
- selectAllAppearance?: 'buttongroup' | 'checkbox';
157
+ selectAllAppearance?: 'buttongroup' | 'checkbox' | 'none';
158
158
  /**
159
159
  * When `compact=true`, move selected values to the top of the list on next open (default), immediately, or not at all.
160
160
  */
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Children
4
+ * @description children replace label when provided. label is still used for matching to the filter.
5
+ */
2
6
  declare function Children(): React.JSX.Element;
3
7
  export default Children;
@@ -1,3 +1,7 @@
1
1
  import React from 'react';
2
+ /**
3
+ * @name Compact
4
+ * @description When compact is true, the Multiselect will never grow tall.
5
+ */
2
6
  declare function Compact(): React.JSX.Element;
3
7
  export default Compact;