@primer/components 31.2.0-rc.fbb10090 → 31.2.1-rc.32ed6e21

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 (503) hide show
  1. package/.github/workflows/ci.yml +5 -2
  2. package/.github/workflows/release.yml +1 -0
  3. package/.github/workflows/release_canary.yml +1 -0
  4. package/CHANGELOG.md +26 -0
  5. package/dist/browser.esm.js +671 -654
  6. package/dist/browser.esm.js.map +1 -1
  7. package/dist/browser.umd.js +223 -206
  8. package/dist/browser.umd.js.map +1 -1
  9. package/docs/content/ActionList2.mdx +359 -0
  10. package/docs/content/{Box.md → Box.mdx} +22 -0
  11. package/docs/content/StateLabel.md +5 -4
  12. package/docs/content/getting-started.md +1 -1
  13. package/docs/src/@primer/gatsby-theme-doctocat/components/hero.js +1 -3
  14. package/docs/src/@primer/gatsby-theme-doctocat/components/live-preview-wrapper.js +1 -1
  15. package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +17 -0
  16. package/docs/src/component-checklist.js +81 -0
  17. package/lib/ActionList/Divider.jsx +29 -0
  18. package/lib/ActionList/Group.jsx +23 -0
  19. package/lib/ActionList/Header.jsx +66 -0
  20. package/lib/ActionList/Item.js +55 -71
  21. package/lib/ActionList/Item.jsx +288 -0
  22. package/lib/ActionList/List.jsx +138 -0
  23. package/lib/ActionList/index.js +12 -23
  24. package/lib/ActionList2/Description.d.ts +12 -0
  25. package/lib/ActionList2/Description.js +57 -0
  26. package/lib/ActionList2/Description.jsx +29 -0
  27. package/lib/ActionList2/Divider.d.ts +5 -0
  28. package/lib/ActionList2/Divider.js +35 -0
  29. package/lib/ActionList2/Divider.jsx +22 -0
  30. package/lib/ActionList2/Group.d.ts +37 -0
  31. package/lib/ActionList2/Group.js +106 -0
  32. package/lib/ActionList2/Group.jsx +54 -0
  33. package/lib/ActionList2/Header.d.ts +26 -0
  34. package/lib/ActionList2/Header.js +55 -0
  35. package/lib/ActionList2/Header.jsx +36 -0
  36. package/lib/ActionList2/Item.d.ts +63 -0
  37. package/lib/ActionList2/Item.js +242 -0
  38. package/lib/ActionList2/Item.jsx +174 -0
  39. package/lib/ActionList2/LinkItem.d.ts +17 -0
  40. package/lib/ActionList2/LinkItem.js +57 -0
  41. package/lib/ActionList2/LinkItem.jsx +28 -0
  42. package/lib/ActionList2/List.d.ts +26 -0
  43. package/lib/ActionList2/List.js +59 -0
  44. package/lib/ActionList2/List.jsx +41 -0
  45. package/lib/ActionList2/Selection.d.ts +5 -0
  46. package/lib/ActionList2/Selection.js +84 -0
  47. package/lib/ActionList2/Selection.jsx +50 -0
  48. package/lib/ActionList2/Visuals.d.ts +9 -0
  49. package/lib/ActionList2/Visuals.js +90 -0
  50. package/lib/ActionList2/Visuals.jsx +48 -0
  51. package/lib/ActionList2/index.d.ts +36 -0
  52. package/lib/ActionList2/index.js +29 -0
  53. package/lib/ActionMenu.jsx +73 -0
  54. package/lib/AnchoredOverlay/AnchoredOverlay.jsx +100 -0
  55. package/lib/AnchoredOverlay/index.js +4 -12
  56. package/lib/Autocomplete/Autocomplete.d.ts +28 -28
  57. package/lib/Autocomplete/Autocomplete.jsx +100 -0
  58. package/lib/Autocomplete/AutocompleteContext.jsx +5 -0
  59. package/lib/Autocomplete/AutocompleteInput.d.ts +28 -28
  60. package/lib/Autocomplete/AutocompleteInput.jsx +113 -0
  61. package/lib/Autocomplete/AutocompleteMenu.jsx +190 -0
  62. package/lib/Autocomplete/AutocompleteOverlay.jsx +55 -0
  63. package/lib/Autocomplete/index.js +7 -14
  64. package/lib/Avatar.jsx +34 -0
  65. package/lib/AvatarPair.jsx +29 -0
  66. package/lib/AvatarStack.jsx +151 -0
  67. package/lib/BaseStyles.jsx +65 -0
  68. package/lib/BorderBox.jsx +18 -0
  69. package/lib/Box.jsx +10 -0
  70. package/lib/BranchName.jsx +20 -0
  71. package/lib/Breadcrumbs.jsx +74 -0
  72. package/lib/Button/Button.d.ts +25 -25
  73. package/lib/Button/Button.jsx +60 -0
  74. package/lib/Button/ButtonBase.jsx +36 -0
  75. package/lib/Button/ButtonClose.d.ts +45 -45
  76. package/lib/Button/ButtonClose.jsx +55 -0
  77. package/lib/Button/ButtonDanger.d.ts +25 -25
  78. package/lib/Button/ButtonDanger.jsx +63 -0
  79. package/lib/Button/ButtonGroup.jsx +55 -0
  80. package/lib/Button/ButtonInvisible.d.ts +25 -25
  81. package/lib/Button/ButtonInvisible.jsx +52 -0
  82. package/lib/Button/ButtonOutline.d.ts +25 -25
  83. package/lib/Button/ButtonOutline.jsx +63 -0
  84. package/lib/Button/ButtonPrimary.d.ts +25 -25
  85. package/lib/Button/ButtonPrimary.jsx +62 -0
  86. package/lib/Button/ButtonStyles.jsx +37 -0
  87. package/lib/Button/ButtonTableList.jsx +49 -0
  88. package/lib/Button/index.js +21 -70
  89. package/lib/Caret.jsx +93 -0
  90. package/lib/CircleBadge.jsx +43 -0
  91. package/lib/CircleOcticon.d.ts +42 -42
  92. package/lib/CircleOcticon.jsx +21 -0
  93. package/lib/CounterLabel.jsx +44 -0
  94. package/lib/Details.jsx +21 -0
  95. package/lib/Dialog/ConfirmationDialog.jsx +146 -0
  96. package/lib/Dialog/Dialog.js +1 -0
  97. package/lib/Dialog/Dialog.jsx +273 -0
  98. package/lib/Dialog.d.ts +45 -45
  99. package/lib/Dialog.jsx +131 -0
  100. package/lib/Dropdown.d.ts +176 -176
  101. package/lib/Dropdown.jsx +134 -0
  102. package/lib/DropdownMenu/DropdownButton.d.ts +46 -46
  103. package/lib/DropdownMenu/DropdownButton.jsx +14 -0
  104. package/lib/DropdownMenu/DropdownMenu.jsx +70 -0
  105. package/lib/DropdownMenu/index.js +6 -20
  106. package/lib/DropdownStyles.js +18 -26
  107. package/lib/FilterList.d.ts +42 -42
  108. package/lib/FilterList.jsx +63 -0
  109. package/lib/FilteredActionList/FilteredActionList.jsx +100 -0
  110. package/lib/FilteredActionList/index.js +4 -12
  111. package/lib/FilteredSearch.jsx +29 -0
  112. package/lib/Flash.jsx +70 -0
  113. package/lib/Flex.jsx +15 -0
  114. package/lib/FormGroup.jsx +25 -0
  115. package/lib/Grid.jsx +15 -0
  116. package/lib/Header.jsx +90 -0
  117. package/lib/Heading.jsx +21 -0
  118. package/lib/Label.jsx +84 -0
  119. package/lib/LabelGroup.jsx +19 -0
  120. package/lib/Link.jsx +38 -0
  121. package/lib/NewButton/button-counter.d.ts +6 -0
  122. package/lib/NewButton/button-counter.js +31 -0
  123. package/lib/NewButton/button-counter.jsx +14 -0
  124. package/lib/NewButton/button.d.ts +13 -0
  125. package/lib/NewButton/button.js +308 -0
  126. package/lib/NewButton/button.jsx +279 -0
  127. package/lib/NewButton/index.d.ts +14 -0
  128. package/lib/NewButton/index.js +8 -0
  129. package/lib/NewButton/types.d.ts +32 -0
  130. package/lib/NewButton/types.js +2 -0
  131. package/lib/Overlay.js +3 -1
  132. package/lib/Overlay.jsx +156 -0
  133. package/lib/Pagehead.jsx +18 -0
  134. package/lib/Pagination/Pagination.jsx +163 -0
  135. package/lib/Pagination/index.js +6 -12
  136. package/lib/Pagination/model.jsx +174 -0
  137. package/lib/PointerBox.jsx +25 -0
  138. package/lib/Popover.jsx +210 -0
  139. package/lib/Portal/Portal.js +3 -2
  140. package/lib/Portal/Portal.jsx +79 -0
  141. package/lib/Portal/index.js +5 -16
  142. package/lib/Position.d.ts +4 -4
  143. package/lib/Position.jsx +46 -0
  144. package/lib/ProgressBar.jsx +39 -0
  145. package/lib/SelectMenu/SelectMenu.d.ts +246 -246
  146. package/lib/SelectMenu/SelectMenu.jsx +114 -0
  147. package/lib/SelectMenu/SelectMenuContext.jsx +5 -0
  148. package/lib/SelectMenu/SelectMenuDivider.jsx +43 -0
  149. package/lib/SelectMenu/SelectMenuFilter.jsx +59 -0
  150. package/lib/SelectMenu/SelectMenuFooter.jsx +46 -0
  151. package/lib/SelectMenu/SelectMenuHeader.jsx +44 -0
  152. package/lib/SelectMenu/SelectMenuItem.d.ts +1 -1
  153. package/lib/SelectMenu/SelectMenuItem.jsx +143 -0
  154. package/lib/SelectMenu/SelectMenuList.jsx +60 -0
  155. package/lib/SelectMenu/SelectMenuLoadingAnimation.jsx +21 -0
  156. package/lib/SelectMenu/SelectMenuModal.d.ts +1 -1
  157. package/lib/SelectMenu/SelectMenuModal.jsx +119 -0
  158. package/lib/SelectMenu/SelectMenuTab.jsx +93 -0
  159. package/lib/SelectMenu/SelectMenuTabPanel.jsx +43 -0
  160. package/lib/SelectMenu/SelectMenuTabs.jsx +58 -0
  161. package/lib/SelectMenu/hooks/useKeyboardNav.js +80 -96
  162. package/lib/SelectMenu/index.js +7 -14
  163. package/lib/SelectPanel/SelectPanel.jsx +105 -0
  164. package/lib/SelectPanel/index.js +4 -12
  165. package/lib/SideNav.jsx +177 -0
  166. package/lib/Spinner.jsx +35 -0
  167. package/lib/StateLabel.d.ts +1 -1
  168. package/lib/StateLabel.js +6 -1
  169. package/lib/StateLabel.jsx +94 -0
  170. package/lib/StyledOcticon.jsx +20 -0
  171. package/lib/SubNav.jsx +104 -0
  172. package/lib/TabNav.jsx +60 -0
  173. package/lib/Text.jsx +14 -0
  174. package/lib/TextInput.jsx +23 -0
  175. package/lib/TextInputWithTokens.d.ts +28 -28
  176. package/lib/TextInputWithTokens.jsx +218 -0
  177. package/lib/ThemeProvider.jsx +130 -0
  178. package/lib/Timeline.d.ts +43 -43
  179. package/lib/Timeline.jsx +124 -0
  180. package/lib/Token/AvatarToken.d.ts +1 -1
  181. package/lib/Token/AvatarToken.jsx +54 -0
  182. package/lib/Token/IssueLabelToken.d.ts +1 -1
  183. package/lib/Token/IssueLabelToken.jsx +125 -0
  184. package/lib/Token/Token.d.ts +1 -1
  185. package/lib/Token/Token.jsx +103 -0
  186. package/lib/Token/TokenBase.jsx +88 -0
  187. package/lib/Token/_RemoveTokenButton.jsx +108 -0
  188. package/lib/Token/_TokenTextContainer.jsx +49 -0
  189. package/lib/Token/index.js +11 -30
  190. package/lib/Tooltip.jsx +246 -0
  191. package/lib/Truncate.jsx +27 -0
  192. package/lib/UnderlineNav.jsx +90 -0
  193. package/lib/_TextInputWrapper.js +2 -2
  194. package/lib/_TextInputWrapper.jsx +120 -0
  195. package/lib/_UnstyledTextInput.jsx +22 -0
  196. package/lib/__tests__/ActionList.test.jsx +49 -0
  197. package/lib/__tests__/ActionList.types.test.jsx +45 -0
  198. package/lib/__tests__/ActionList2.test.d.ts +1 -0
  199. package/lib/__tests__/ActionList2.test.js +53 -0
  200. package/lib/__tests__/ActionList2.test.jsx +46 -0
  201. package/lib/__tests__/ActionMenu.test.jsx +124 -0
  202. package/lib/__tests__/AnchoredOverlay.test.js +4 -2
  203. package/lib/__tests__/AnchoredOverlay.test.jsx +121 -0
  204. package/lib/__tests__/Autocomplete.test.jsx +299 -0
  205. package/lib/__tests__/Avatar.test.jsx +42 -0
  206. package/lib/__tests__/AvatarStack.test.jsx +43 -0
  207. package/lib/__tests__/BorderBox.test.jsx +36 -0
  208. package/lib/__tests__/Box.test.jsx +41 -0
  209. package/lib/__tests__/BranchName.test.jsx +27 -0
  210. package/lib/__tests__/Breadcrumbs.test.jsx +28 -0
  211. package/lib/__tests__/BreadcrumbsItem.test.jsx +31 -0
  212. package/lib/__tests__/Button.test.jsx +100 -0
  213. package/lib/__tests__/Caret.test.jsx +37 -0
  214. package/lib/__tests__/CircleBadge.test.jsx +55 -0
  215. package/lib/__tests__/CircleOcticon.test.jsx +45 -0
  216. package/lib/__tests__/ConfirmationDialog.test.jsx +119 -0
  217. package/lib/__tests__/CounterLabel.test.jsx +36 -0
  218. package/lib/__tests__/Details.test.jsx +85 -0
  219. package/lib/__tests__/Dialog.test.jsx +139 -0
  220. package/lib/__tests__/Dropdown.test.jsx +49 -0
  221. package/lib/__tests__/DropdownMenu.test.jsx +119 -0
  222. package/lib/__tests__/FilterList.test.jsx +27 -0
  223. package/lib/__tests__/FilterListItem.test.jsx +31 -0
  224. package/lib/__tests__/FilteredSearch.test.jsx +27 -0
  225. package/lib/__tests__/Flash.test.jsx +36 -0
  226. package/lib/__tests__/Flex.test.jsx +51 -0
  227. package/lib/__tests__/FormGroup.test.jsx +36 -0
  228. package/lib/__tests__/Grid.test.jsx +69 -0
  229. package/lib/__tests__/Header.test.jsx +45 -0
  230. package/lib/__tests__/Heading.test.jsx +71 -0
  231. package/lib/__tests__/KeyPaths.types.test.d.ts +2 -1
  232. package/lib/__tests__/KeyPaths.types.test.js +5 -8
  233. package/lib/__tests__/Label.test.jsx +33 -0
  234. package/lib/__tests__/LabelGroup.test.jsx +29 -0
  235. package/lib/__tests__/Link.test.jsx +43 -0
  236. package/lib/__tests__/Merge.types.test.js +13 -19
  237. package/lib/__tests__/NewButton.test.d.ts +1 -0
  238. package/lib/__tests__/NewButton.test.js +95 -0
  239. package/lib/__tests__/NewButton.test.jsx +61 -0
  240. package/lib/__tests__/Overlay.test.jsx +105 -0
  241. package/lib/__tests__/Pagehead.test.jsx +25 -0
  242. package/lib/__tests__/Pagination/Pagination.test.jsx +32 -0
  243. package/lib/__tests__/Pagination/PaginationModel.test.jsx +118 -0
  244. package/lib/__tests__/PointerBox.test.jsx +33 -0
  245. package/lib/__tests__/Popover.test.jsx +58 -0
  246. package/lib/__tests__/Portal.test.jsx +102 -0
  247. package/lib/__tests__/Position.test.jsx +96 -0
  248. package/lib/__tests__/ProgressBar.test.jsx +38 -0
  249. package/lib/__tests__/SelectMenu.test.jsx +120 -0
  250. package/lib/__tests__/SelectPanel.test.jsx +48 -0
  251. package/lib/__tests__/SideNav.test.jsx +55 -0
  252. package/lib/__tests__/Spinner.test.jsx +41 -0
  253. package/lib/__tests__/StateLabel.test.jsx +46 -0
  254. package/lib/__tests__/StyledOcticon.test.jsx +28 -0
  255. package/lib/__tests__/SubNav.test.jsx +47 -0
  256. package/lib/__tests__/SubNavLink.test.jsx +31 -0
  257. package/lib/__tests__/TabNav.test.jsx +32 -0
  258. package/lib/__tests__/Text.test.jsx +71 -0
  259. package/lib/__tests__/TextInput.test.jsx +45 -0
  260. package/lib/__tests__/TextInputWithTokens.test.js +1 -10
  261. package/lib/__tests__/TextInputWithTokens.test.jsx +302 -0
  262. package/lib/__tests__/ThemeProvider.test.jsx +314 -0
  263. package/lib/__tests__/Timeline.test.jsx +51 -0
  264. package/lib/__tests__/Token.test.jsx +93 -0
  265. package/lib/__tests__/Tooltip.test.jsx +46 -0
  266. package/lib/__tests__/Truncate.test.jsx +41 -0
  267. package/lib/__tests__/UnderlineNav.test.jsx +53 -0
  268. package/lib/__tests__/UnderlineNavLink.test.jsx +31 -0
  269. package/lib/__tests__/behaviors/anchoredPosition.test.js +229 -376
  270. package/lib/__tests__/behaviors/focusTrap.test.jsx +184 -0
  271. package/lib/__tests__/behaviors/focusZone.test.jsx +406 -0
  272. package/lib/__tests__/behaviors/iterateFocusableElements.test.jsx +58 -0
  273. package/lib/__tests__/behaviors/scrollIntoViewingArea.test.js +145 -216
  274. package/lib/__tests__/filterObject.test.js +48 -27
  275. package/lib/__tests__/hooks/useAnchoredPosition.test.jsx +29 -0
  276. package/lib/__tests__/hooks/useOnEscapePress.test.jsx +19 -0
  277. package/lib/__tests__/hooks/useOnOutsideClick.test.jsx +63 -0
  278. package/lib/__tests__/hooks/useOpenAndCloseFocus.test.jsx +61 -0
  279. package/lib/__tests__/hooks/useProvidedStateOrCreate.test.jsx +56 -0
  280. package/lib/__tests__/theme.test.js +33 -34
  281. package/lib/__tests__/themeGet.test.js +12 -23
  282. package/lib/__tests__/useSafeTimeout.test.jsx +36 -0
  283. package/lib/__tests__/utils/createSlots.test.d.ts +1 -0
  284. package/lib/__tests__/utils/createSlots.test.js +75 -0
  285. package/lib/__tests__/utils/createSlots.test.jsx +57 -0
  286. package/lib/behaviors/anchoredPosition.js +205 -234
  287. package/lib/behaviors/focusTrap.js +121 -157
  288. package/lib/behaviors/focusZone.js +434 -509
  289. package/lib/behaviors/scrollIntoViewingArea.js +18 -35
  290. package/lib/constants.js +39 -43
  291. package/lib/drafts.d.ts +8 -0
  292. package/lib/drafts.js +21 -0
  293. package/lib/hooks/index.js +16 -60
  294. package/lib/hooks/useAnchoredPosition.js +32 -39
  295. package/lib/hooks/useCombinedRefs.d.ts +2 -2
  296. package/lib/hooks/useCombinedRefs.js +32 -38
  297. package/lib/hooks/useDetails.jsx +39 -0
  298. package/lib/hooks/useDialog.js +72 -96
  299. package/lib/hooks/useFocusTrap.js +43 -60
  300. package/lib/hooks/useFocusZone.js +54 -50
  301. package/lib/hooks/useOnEscapePress.js +25 -36
  302. package/lib/hooks/useOnOutsideClick.jsx +61 -0
  303. package/lib/hooks/useOpenAndCloseFocus.js +22 -34
  304. package/lib/hooks/useOverlay.jsx +15 -0
  305. package/lib/hooks/useProvidedRefOrCreate.js +10 -14
  306. package/lib/hooks/useProvidedStateOrCreate.js +13 -16
  307. package/lib/hooks/useRenderForcingRef.js +13 -17
  308. package/lib/hooks/useResizeObserver.js +15 -18
  309. package/lib/hooks/useSafeTimeout.js +22 -30
  310. package/lib/hooks/useScrollFlash.js +16 -23
  311. package/lib/index.d.ts +2 -0
  312. package/lib/index.js +163 -636
  313. package/lib/polyfills/eventListenerSignal.js +37 -45
  314. package/lib/stories/ActionList2.stories.js +909 -0
  315. package/lib/stories/NewButton.stories.js +230 -0
  316. package/lib/stories/TextInput.stories.js +144 -0
  317. package/lib/stories/Token.stories.js +19 -2
  318. package/lib/sx.d.ts +2 -0
  319. package/lib/sx.js +10 -14
  320. package/lib/theme-preval.js +65 -2945
  321. package/lib/theme.js +3 -12
  322. package/lib/utils/create-slots.d.ts +17 -0
  323. package/lib/utils/create-slots.js +105 -0
  324. package/lib/utils/create-slots.jsx +65 -0
  325. package/lib/utils/deprecate.jsx +59 -0
  326. package/lib/utils/isNumeric.jsx +7 -0
  327. package/lib/utils/iterateFocusableElements.js +63 -85
  328. package/lib/utils/ssr.jsx +6 -0
  329. package/lib/utils/test-deprecations.jsx +20 -0
  330. package/lib/utils/test-helpers.jsx +8 -0
  331. package/lib/utils/test-matchers.jsx +100 -0
  332. package/lib/utils/testing.d.ts +20 -61
  333. package/lib/utils/testing.jsx +206 -0
  334. package/lib/utils/theme.js +33 -47
  335. package/lib/utils/types/AriaRole.js +2 -1
  336. package/lib/utils/types/ComponentProps.js +2 -1
  337. package/lib/utils/types/Flatten.js +2 -1
  338. package/lib/utils/types/KeyPaths.d.ts +1 -1
  339. package/lib/utils/types/KeyPaths.js +2 -1
  340. package/lib/utils/types/MandateProps.js +16 -1
  341. package/lib/utils/types/Merge.js +2 -1
  342. package/lib/utils/types/index.js +16 -69
  343. package/lib/utils/uniqueId.js +5 -8
  344. package/lib/utils/use-force-update.d.ts +1 -0
  345. package/lib/utils/use-force-update.js +13 -0
  346. package/lib/utils/useIsomorphicLayoutEffect.d.ts +3 -0
  347. package/lib/utils/useIsomorphicLayoutEffect.js +9 -0
  348. package/lib/utils/userAgent.js +8 -12
  349. package/lib-esm/ActionList/Item.js +56 -72
  350. package/lib-esm/ActionList2/Description.d.ts +12 -0
  351. package/lib-esm/ActionList2/Description.js +41 -0
  352. package/lib-esm/ActionList2/Divider.d.ts +5 -0
  353. package/lib-esm/ActionList2/Divider.js +23 -0
  354. package/lib-esm/ActionList2/Group.d.ts +37 -0
  355. package/lib-esm/ActionList2/Group.js +87 -0
  356. package/lib-esm/ActionList2/Header.d.ts +26 -0
  357. package/lib-esm/ActionList2/Header.js +44 -0
  358. package/lib-esm/ActionList2/Item.d.ts +63 -0
  359. package/lib-esm/ActionList2/Item.js +208 -0
  360. package/lib-esm/ActionList2/LinkItem.d.ts +17 -0
  361. package/lib-esm/ActionList2/LinkItem.js +43 -0
  362. package/lib-esm/ActionList2/List.d.ts +26 -0
  363. package/lib-esm/ActionList2/List.js +37 -0
  364. package/lib-esm/ActionList2/Selection.d.ts +5 -0
  365. package/lib-esm/ActionList2/Selection.js +66 -0
  366. package/lib-esm/ActionList2/Visuals.d.ts +9 -0
  367. package/lib-esm/ActionList2/Visuals.js +68 -0
  368. package/lib-esm/ActionList2/index.d.ts +36 -0
  369. package/lib-esm/ActionList2/index.js +33 -0
  370. package/lib-esm/Autocomplete/Autocomplete.d.ts +28 -28
  371. package/lib-esm/Autocomplete/AutocompleteInput.d.ts +28 -28
  372. package/lib-esm/Button/Button.d.ts +25 -25
  373. package/lib-esm/Button/ButtonClose.d.ts +45 -45
  374. package/lib-esm/Button/ButtonDanger.d.ts +25 -25
  375. package/lib-esm/Button/ButtonInvisible.d.ts +25 -25
  376. package/lib-esm/Button/ButtonOutline.d.ts +25 -25
  377. package/lib-esm/Button/ButtonPrimary.d.ts +25 -25
  378. package/lib-esm/CircleOcticon.d.ts +42 -42
  379. package/lib-esm/Dialog/Dialog.js +1 -0
  380. package/lib-esm/Dialog.d.ts +45 -45
  381. package/lib-esm/Dropdown.d.ts +176 -176
  382. package/lib-esm/DropdownMenu/DropdownButton.d.ts +46 -46
  383. package/lib-esm/FilterList.d.ts +42 -42
  384. package/lib-esm/NewButton/button-counter.d.ts +6 -0
  385. package/lib-esm/NewButton/button-counter.js +18 -0
  386. package/lib-esm/NewButton/button.d.ts +13 -0
  387. package/lib-esm/NewButton/button.js +287 -0
  388. package/lib-esm/NewButton/index.d.ts +14 -0
  389. package/lib-esm/NewButton/index.js +5 -0
  390. package/lib-esm/NewButton/types.d.ts +32 -0
  391. package/lib-esm/NewButton/types.js +1 -0
  392. package/lib-esm/Overlay.js +2 -1
  393. package/lib-esm/Portal/Portal.js +2 -1
  394. package/lib-esm/Position.d.ts +4 -4
  395. package/lib-esm/SelectMenu/SelectMenu.d.ts +246 -246
  396. package/lib-esm/SelectMenu/SelectMenuItem.d.ts +1 -1
  397. package/lib-esm/SelectMenu/SelectMenuModal.d.ts +1 -1
  398. package/lib-esm/StateLabel.d.ts +1 -1
  399. package/lib-esm/StateLabel.js +7 -2
  400. package/lib-esm/TextInputWithTokens.d.ts +28 -28
  401. package/lib-esm/Timeline.d.ts +43 -43
  402. package/lib-esm/Token/AvatarToken.d.ts +1 -1
  403. package/lib-esm/Token/IssueLabelToken.d.ts +1 -1
  404. package/lib-esm/Token/Token.d.ts +1 -1
  405. package/lib-esm/_TextInputWrapper.js +2 -2
  406. package/lib-esm/__tests__/ActionList2.test.d.ts +1 -0
  407. package/lib-esm/__tests__/ActionList2.test.js +41 -0
  408. package/lib-esm/__tests__/AnchoredOverlay.test.js +4 -2
  409. package/lib-esm/__tests__/KeyPaths.types.test.d.ts +2 -1
  410. package/lib-esm/__tests__/NewButton.test.d.ts +1 -0
  411. package/lib-esm/__tests__/NewButton.test.js +84 -0
  412. package/lib-esm/__tests__/TextInputWithTokens.test.js +1 -10
  413. package/lib-esm/__tests__/utils/createSlots.test.d.ts +1 -0
  414. package/lib-esm/__tests__/utils/createSlots.test.js +67 -0
  415. package/lib-esm/drafts.d.ts +8 -0
  416. package/lib-esm/drafts.js +9 -0
  417. package/lib-esm/hooks/useAnchoredPosition.js +2 -1
  418. package/lib-esm/hooks/useCombinedRefs.d.ts +2 -2
  419. package/lib-esm/hooks/useCombinedRefs.js +3 -2
  420. package/lib-esm/hooks/useResizeObserver.js +2 -2
  421. package/lib-esm/index.d.ts +2 -0
  422. package/lib-esm/index.js +1 -0
  423. package/lib-esm/stories/ActionList2.stories.js +797 -0
  424. package/lib-esm/stories/NewButton.stories.js +178 -0
  425. package/lib-esm/stories/TextInput.stories.js +117 -0
  426. package/lib-esm/stories/Token.stories.js +14 -1
  427. package/lib-esm/sx.d.ts +2 -0
  428. package/lib-esm/sx.js +3 -1
  429. package/lib-esm/theme-preval.js +147 -368
  430. package/lib-esm/utils/create-slots.d.ts +17 -0
  431. package/lib-esm/utils/create-slots.js +84 -0
  432. package/lib-esm/utils/testing.d.ts +20 -61
  433. package/lib-esm/utils/types/KeyPaths.d.ts +1 -1
  434. package/lib-esm/utils/use-force-update.d.ts +1 -0
  435. package/lib-esm/utils/use-force-update.js +6 -0
  436. package/lib-esm/utils/useIsomorphicLayoutEffect.d.ts +3 -0
  437. package/lib-esm/utils/useIsomorphicLayoutEffect.js +3 -0
  438. package/migrating.md +1 -1
  439. package/package-lock.json +168 -16
  440. package/package.json +9 -5
  441. package/script/build +3 -1
  442. package/src/ActionList/Item.tsx +49 -65
  443. package/src/ActionList2/Description.tsx +52 -0
  444. package/src/ActionList2/Divider.tsx +24 -0
  445. package/src/ActionList2/Group.tsx +103 -0
  446. package/src/ActionList2/Header.tsx +58 -0
  447. package/src/ActionList2/Item.tsx +246 -0
  448. package/src/ActionList2/LinkItem.tsx +49 -0
  449. package/src/ActionList2/List.tsx +55 -0
  450. package/src/ActionList2/Selection.tsx +60 -0
  451. package/src/ActionList2/Visuals.tsx +76 -0
  452. package/src/ActionList2/index.ts +39 -0
  453. package/src/Dialog/Dialog.tsx +1 -0
  454. package/src/NewButton/button-counter.tsx +15 -0
  455. package/src/NewButton/button.tsx +283 -0
  456. package/src/NewButton/index.ts +10 -0
  457. package/src/NewButton/types.ts +36 -0
  458. package/src/Overlay.tsx +2 -1
  459. package/src/Portal/Portal.tsx +2 -1
  460. package/src/StateLabel.tsx +14 -2
  461. package/src/_TextInputWrapper.tsx +7 -0
  462. package/src/__tests__/ActionList2.test.tsx +47 -0
  463. package/src/__tests__/AnchoredOverlay.test.tsx +2 -2
  464. package/src/__tests__/KeyPaths.types.test.ts +2 -1
  465. package/src/__tests__/NewButton.test.tsx +70 -0
  466. package/src/__tests__/TextInputWithTokens.test.tsx +0 -10
  467. package/src/__tests__/__snapshots__/ActionList.test.tsx.snap +5 -5
  468. package/src/__tests__/__snapshots__/ActionList2.test.tsx.snap +14 -0
  469. package/src/__tests__/__snapshots__/AnchoredOverlay.test.tsx.snap +35 -135
  470. package/src/__tests__/__snapshots__/Autocomplete.test.tsx.snap +747 -280
  471. package/src/__tests__/__snapshots__/CircleBadge.test.tsx.snap +1 -0
  472. package/src/__tests__/__snapshots__/CircleOcticon.test.tsx.snap +1 -0
  473. package/src/__tests__/__snapshots__/Dialog.test.tsx.snap +1 -0
  474. package/src/__tests__/__snapshots__/DropdownMenu.test.tsx.snap +1 -0
  475. package/src/__tests__/__snapshots__/NewButton.test.tsx.snap +305 -0
  476. package/src/__tests__/__snapshots__/SelectMenu.test.tsx.snap +4 -0
  477. package/src/__tests__/__snapshots__/SelectPanel.test.tsx.snap +1 -0
  478. package/src/__tests__/__snapshots__/StateLabel.test.tsx.snap +13 -6
  479. package/src/__tests__/__snapshots__/StyledOcticon.test.tsx.snap +1 -0
  480. package/src/__tests__/__snapshots__/TextInputWithTokens.test.tsx.snap +66 -0
  481. package/src/__tests__/__snapshots__/Token.test.tsx.snap +17 -0
  482. package/src/__tests__/utils/__snapshots__/createSlots.test.tsx.snap +55 -0
  483. package/src/__tests__/utils/createSlots.test.tsx +74 -0
  484. package/src/drafts.ts +10 -0
  485. package/src/hooks/useAnchoredPosition.ts +2 -1
  486. package/src/hooks/useCombinedRefs.ts +3 -3
  487. package/src/hooks/useResizeObserver.ts +2 -2
  488. package/src/index.ts +2 -0
  489. package/src/stories/ActionList2.stories.tsx +1291 -0
  490. package/src/stories/Button.stories.tsx +1 -1
  491. package/src/stories/NewButton.stories.tsx +201 -0
  492. package/src/stories/TextInput.stories.tsx +113 -0
  493. package/src/stories/Token.stories.tsx +12 -1
  494. package/src/sx.ts +3 -0
  495. package/src/theme-preval.js +1 -0
  496. package/src/utils/create-slots.tsx +96 -0
  497. package/src/utils/types/KeyPaths.ts +7 -1
  498. package/src/utils/use-force-update.ts +7 -0
  499. package/src/utils/useIsomorphicLayoutEffect.ts +10 -0
  500. package/stats.html +1 -1
  501. package/tsconfig.base.json +20 -0
  502. package/tsconfig.build.json +2 -2
  503. package/tsconfig.json +4 -17
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.List = void 0;
7
+ const react_1 = __importDefault(require("react"));
8
+ const Group_1 = require("./Group");
9
+ const Item_1 = require("./Item");
10
+ const Divider_1 = require("./Divider");
11
+ const styled_components_1 = __importDefault(require("styled-components"));
12
+ const constants_1 = require("../constants");
13
+ const focusZone_1 = require("../behaviors/focusZone");
14
+ /**
15
+ * Asserts that the given value fulfills the `GroupedListProps` contract.
16
+ * @param props A value which fulfills either the `ListPropsBase` or the `GroupedListProps` contract.
17
+ */
18
+ function isGroupedListProps(props) {
19
+ return 'groupMetadata' in props;
20
+ }
21
+ const StyledList = styled_components_1.default.div `
22
+ font-size: ${constants_1.get('fontSizes.1')};
23
+ /* 14px font-size * 1.428571429 = 20px line height
24
+ *
25
+ * TODO: When rem-based spacing on a 4px scale lands, replace
26
+ * hardcoded '20px'
27
+ */
28
+ line-height: 20px;
29
+
30
+ &[${focusZone_1.hasActiveDescendantAttribute}], &:focus-within {
31
+ --item-hover-bg-override: none;
32
+ --item-hover-divider-border-color-override: ${constants_1.get('colors.border.muted')};
33
+ }
34
+ `;
35
+ /**
36
+ * Returns `sx` prop values for `List` children matching the given `List` style variation.
37
+ * @param variant `List` style variation.
38
+ */
39
+ function useListVariant(variant = 'inset') {
40
+ switch (variant) {
41
+ case 'full':
42
+ return {
43
+ headerStyle: { paddingX: constants_1.get('space.2') },
44
+ itemStyle: { borderRadius: 0 }
45
+ };
46
+ default:
47
+ return {
48
+ firstGroupStyle: { marginTop: constants_1.get('space.2') },
49
+ lastGroupStyle: { marginBottom: constants_1.get('space.2') },
50
+ itemStyle: { marginX: constants_1.get('space.2') }
51
+ };
52
+ }
53
+ }
54
+ /**
55
+ * Lists `Item`s, either grouped or ungrouped, with a `Divider` between each `Group`.
56
+ */
57
+ exports.List = react_1.default.forwardRef((props, forwardedRef) => {
58
+ // Get `sx` prop values for `List` children matching the given `List` style variation.
59
+ const { firstGroupStyle, lastGroupStyle, headerStyle, itemStyle } = useListVariant(props.variant);
60
+ /**
61
+ * Render a `Group` using the first of the following renderers that is defined:
62
+ * A `Group`-level or `List`-level custom `Group` renderer, or
63
+ * the default `Group` renderer.
64
+ */
65
+ const renderGroup = (groupProps) => {
66
+ const GroupComponent = (('renderGroup' in groupProps && groupProps.renderGroup) ?? props.renderGroup) || Group_1.Group;
67
+ return <GroupComponent {...groupProps} key={groupProps.groupId}/>;
68
+ };
69
+ /**
70
+ * Render an `Item` using the first of the following renderers that is defined:
71
+ * An `Item`-level, `Group`-level, or `List`-level custom `Item` renderer,
72
+ * or the default `Item` renderer.
73
+ */
74
+ const renderItem = (itemProps, item, itemIndex) => {
75
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
76
+ const ItemComponent = ('renderItem' in itemProps && itemProps.renderItem) || props.renderItem || Item_1.Item;
77
+ const key = ('key' in itemProps ? itemProps.key : undefined) ?? itemProps.id?.toString() ?? itemIndex.toString();
78
+ return (<ItemComponent showDivider={props.showItemDividers} selectionVariant={props.selectionVariant} {...itemProps} key={key} sx={{ ...itemStyle, ...itemProps.sx }} item={item}/>);
79
+ };
80
+ /**
81
+ * An array of `Group`s, each with an associated `Header` and with an array of `Item`s belonging to that `Group`.
82
+ */
83
+ let groups = [];
84
+ // Collect rendered `Item`s into `Group`s, avoiding excess iteration over the lists of `items` and `groupMetadata`:
85
+ if (!isGroupedListProps(props)) {
86
+ // When no `groupMetadata`s is provided, collect rendered `Item`s into a single anonymous `Group`.
87
+ groups = [{ items: props.items.map((item, index) => renderItem(item, item, index)), groupId: '0' }];
88
+ }
89
+ else {
90
+ // When `groupMetadata` is provided, collect rendered `Item`s into their associated `Group`s.
91
+ /**
92
+ * A map of group identifiers to `Group`s, each with an associated array of `Item`s belonging to that `Group`.
93
+ */
94
+ const groupMap = props.groupMetadata.reduce((groupAccumulator, groupMetadata) => groupAccumulator.set(groupMetadata.groupId, groupMetadata), new Map());
95
+ for (const itemProps of props.items) {
96
+ // Look up the group associated with the current item.
97
+ const group = groupMap.get(itemProps.groupId);
98
+ const itemIndex = group?.items?.length ?? 0;
99
+ // Upsert the group to include the current item (rendered).
100
+ groupMap.set(itemProps.groupId, {
101
+ ...group,
102
+ items: [
103
+ ...(group?.items ?? []),
104
+ renderItem({
105
+ showDivider: group?.showItemDividers,
106
+ ...(group && 'renderItem' in group && { renderItem: group.renderItem }),
107
+ ...itemProps
108
+ }, itemProps, itemIndex)
109
+ ]
110
+ });
111
+ }
112
+ groups = [...groupMap.values()];
113
+ }
114
+ return (<StyledList {...props} ref={forwardedRef}>
115
+ {groups.map(({ header, ...groupProps }, index) => {
116
+ const hasFilledHeader = header?.variant === 'filled';
117
+ const shouldShowDivider = index > 0 && !hasFilledHeader;
118
+ return (<react_1.default.Fragment key={groupProps.groupId}>
119
+ {shouldShowDivider ? <Divider_1.Divider key={`${groupProps.groupId}-divider`}/> : null}
120
+ {renderGroup({
121
+ sx: {
122
+ ...(index === 0 && firstGroupStyle),
123
+ ...(index === groups.length - 1 && lastGroupStyle),
124
+ ...(index > 0 && !shouldShowDivider && { mt: 2 })
125
+ },
126
+ ...(header && {
127
+ header: {
128
+ ...header,
129
+ sx: { ...headerStyle, ...header.sx }
130
+ }
131
+ }),
132
+ ...groupProps
133
+ })}
134
+ </react_1.default.Fragment>);
135
+ })}
136
+ </StyledList>);
137
+ });
138
+ exports.List.displayName = 'ActionList';
@@ -1,29 +1,18 @@
1
1
  "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
2
+ Object.defineProperty(exports, "__esModule", { value: true });
6
3
  exports.ActionList = void 0;
7
-
8
- var _List = require("./List");
9
-
10
- var _Group = require("./Group");
11
-
12
- var _Item = require("./Item");
13
-
14
- var _Divider = require("./Divider");
15
-
4
+ const List_1 = require("./List");
5
+ const Group_1 = require("./Group");
6
+ const Item_1 = require("./Item");
7
+ const Divider_1 = require("./Divider");
16
8
  /**
17
9
  * Collection of list-related components.
18
10
  */
19
- const ActionList = Object.assign(_List.List, {
20
- /** Collects related `Items` in an `ActionList`. */
21
- Group: _Group.Group,
22
-
23
- /** An actionable or selectable `Item` with an optional icon and description. */
24
- Item: _Item.Item,
25
-
26
- /** Visually separates `Item`s or `Group`s in an `ActionList`. */
27
- Divider: _Divider.Divider
11
+ exports.ActionList = Object.assign(List_1.List, {
12
+ /** Collects related `Items` in an `ActionList`. */
13
+ Group: Group_1.Group,
14
+ /** An actionable or selectable `Item` with an optional icon and description. */
15
+ Item: Item_1.Item,
16
+ /** Visually separates `Item`s or `Group`s in an `ActionList`. */
17
+ Divider: Divider_1.Divider
28
18
  });
29
- exports.ActionList = ActionList;
@@ -0,0 +1,12 @@
1
+ import React from 'react';
2
+ import { SxProp } from '../sx';
3
+ export declare type DescriptionProps = {
4
+ /**
5
+ * Secondary text style variations.
6
+ *
7
+ * - `"inline"` - Secondary text is positioned beside primary text.
8
+ * - `"block"` - Secondary text is positioned below primary text.
9
+ */
10
+ variant?: 'inline' | 'block';
11
+ } & SxProp;
12
+ export declare const Description: React.FC<DescriptionProps>;
@@ -0,0 +1,57 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.Description = void 0;
7
+
8
+ var _react = _interopRequireDefault(require("react"));
9
+
10
+ var _Box = _interopRequireDefault(require("../Box"));
11
+
12
+ var _sx = require("../sx");
13
+
14
+ var _Truncate = _interopRequireDefault(require("../Truncate"));
15
+
16
+ var _Item = require("./Item");
17
+
18
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
19
+
20
+ const Description = ({
21
+ variant = 'inline',
22
+ sx = {},
23
+ ...props
24
+ }) => {
25
+ const styles = {
26
+ fontSize: 0,
27
+ lineHeight: '16px',
28
+ flexGrow: 1,
29
+ flexBasis: 0,
30
+ minWidth: 0,
31
+ marginLeft: variant === 'block' ? 0 : 2
32
+ };
33
+ return /*#__PURE__*/_react.default.createElement(_Item.Slot, {
34
+ name: variant === 'block' ? 'BlockDescription' : 'InlineDescription'
35
+ }, ({
36
+ blockDescriptionId,
37
+ inlineDescriptionId,
38
+ disabled
39
+ }) => variant === 'block' ? /*#__PURE__*/_react.default.createElement(_Box.default, {
40
+ as: "span",
41
+ sx: (0, _sx.merge)({ ...styles,
42
+ color: disabled ? 'fg.disabled' : 'fg.muted'
43
+ }, sx),
44
+ id: blockDescriptionId
45
+ }, props.children) : /*#__PURE__*/_react.default.createElement(_Truncate.default, {
46
+ id: inlineDescriptionId,
47
+ sx: (0, _sx.merge)({ ...styles,
48
+ color: disabled ? 'fg.disabled' : 'fg.muted'
49
+ }, sx),
50
+ title: props.children,
51
+ inline: true,
52
+ maxWidth: "100%"
53
+ }, props.children));
54
+ };
55
+
56
+ exports.Description = Description;
57
+ Description.displayName = "Description";
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.Description = void 0;
7
+ const react_1 = __importDefault(require("react"));
8
+ const Box_1 = __importDefault(require("../Box"));
9
+ const sx_1 = require("../sx");
10
+ const Truncate_1 = __importDefault(require("../Truncate"));
11
+ const Item_1 = require("./Item");
12
+ const Description = ({ variant = 'inline', sx = {}, ...props }) => {
13
+ const styles = {
14
+ fontSize: 0,
15
+ lineHeight: '16px',
16
+ flexGrow: 1,
17
+ flexBasis: 0,
18
+ minWidth: 0,
19
+ marginLeft: variant === 'block' ? 0 : 2
20
+ };
21
+ return (<Item_1.Slot name={variant === 'block' ? 'BlockDescription' : 'InlineDescription'}>
22
+ {({ blockDescriptionId, inlineDescriptionId, disabled }) => variant === 'block' ? (<Box_1.default as="span" sx={sx_1.merge({ ...styles, color: disabled ? 'fg.disabled' : 'fg.muted' }, sx)} id={blockDescriptionId}>
23
+ {props.children}
24
+ </Box_1.default>) : (<Truncate_1.default id={inlineDescriptionId} sx={sx_1.merge({ ...styles, color: disabled ? 'fg.disabled' : 'fg.muted' }, sx)} title={props.children} inline={true} maxWidth="100%">
25
+ {props.children}
26
+ </Truncate_1.default>)}
27
+ </Item_1.Slot>);
28
+ };
29
+ exports.Description = Description;
@@ -0,0 +1,5 @@
1
+ /// <reference types="react" />
2
+ /**
3
+ * Visually separates `Item`s or `Group`s in an `ActionList`.
4
+ */
5
+ export declare function Divider(): JSX.Element;
@@ -0,0 +1,35 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.Divider = Divider;
7
+
8
+ var _react = _interopRequireDefault(require("react"));
9
+
10
+ var _Box = _interopRequireDefault(require("../Box"));
11
+
12
+ var _constants = require("../constants");
13
+
14
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
15
+
16
+ /**
17
+ * Visually separates `Item`s or `Group`s in an `ActionList`.
18
+ */
19
+ function Divider() {
20
+ return /*#__PURE__*/_react.default.createElement(_Box.default, {
21
+ as: "li",
22
+ role: "separator",
23
+ sx: {
24
+ height: 1,
25
+ backgroundColor: 'actionListItem.inlineDivider',
26
+ marginTop: theme => `calc(${(0, _constants.get)('space.2')(theme)} - 1px)`,
27
+ marginBottom: 2,
28
+ listStyle: 'none' // hide the ::marker inserted by browser's stylesheet
29
+
30
+ },
31
+ "data-component": "ActionList.Divider"
32
+ });
33
+ }
34
+
35
+ Divider.displayName = "Divider";
@@ -0,0 +1,22 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.Divider = void 0;
7
+ const react_1 = __importDefault(require("react"));
8
+ const Box_1 = __importDefault(require("../Box"));
9
+ const constants_1 = require("../constants");
10
+ /**
11
+ * Visually separates `Item`s or `Group`s in an `ActionList`.
12
+ */
13
+ function Divider() {
14
+ return (<Box_1.default as="li" role="separator" sx={{
15
+ height: 1,
16
+ backgroundColor: 'actionListItem.inlineDivider',
17
+ marginTop: (theme) => `calc(${constants_1.get('space.2')(theme)} - 1px)`,
18
+ marginBottom: 2,
19
+ listStyle: 'none' // hide the ::marker inserted by browser's stylesheet
20
+ }} data-component="ActionList.Divider"/>);
21
+ }
22
+ exports.Divider = Divider;
@@ -0,0 +1,37 @@
1
+ import React from 'react';
2
+ import { SxProp } from '../sx';
3
+ import { ListProps } from './List';
4
+ import { AriaRole } from '../utils/types';
5
+ export declare type GroupProps = {
6
+ /**
7
+ * Style variations. Usage is discretionary.
8
+ *
9
+ * - `"filled"` - Superimposed on a background, offset from nearby content
10
+ * - `"subtle"` - Relatively less offset from nearby content
11
+ */
12
+ variant?: 'subtle' | 'filled';
13
+ /**
14
+ * Primary text which names a `Group`.
15
+ */
16
+ title?: string;
17
+ /**
18
+ * Secondary text which provides additional information about a `Group`.
19
+ */
20
+ auxiliaryText?: string;
21
+ /**
22
+ * The ARIA role describing the function of the list inside `Group` component. `listbox` or `menu` are a common values.
23
+ */
24
+ role?: AriaRole;
25
+ } & SxProp & {
26
+ /**
27
+ * Whether multiple Items or a single Item can be selected in the Group. Overrides value on ActionList root.
28
+ */
29
+ selectionVariant?: ListProps['selectionVariant'] | false;
30
+ };
31
+ declare type ContextProps = Pick<GroupProps, 'selectionVariant'>;
32
+ export declare const GroupContext: React.Context<ContextProps>;
33
+ export declare const Group: React.FC<GroupProps>;
34
+ export declare type HeaderProps = Pick<GroupProps, 'variant' | 'title' | 'auxiliaryText'> & {
35
+ labelId: string;
36
+ };
37
+ export {};
@@ -0,0 +1,106 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.Group = exports.GroupContext = void 0;
7
+
8
+ var _react = _interopRequireDefault(require("react"));
9
+
10
+ var _ssr = require("@react-aria/ssr");
11
+
12
+ var _Box = _interopRequireDefault(require("../Box"));
13
+
14
+ var _List = require("./List");
15
+
16
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
17
+
18
+ function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
19
+
20
+ const GroupContext = /*#__PURE__*/_react.default.createContext({});
21
+
22
+ exports.GroupContext = GroupContext;
23
+
24
+ const Group = ({
25
+ title,
26
+ variant = 'subtle',
27
+ auxiliaryText,
28
+ selectionVariant,
29
+ role,
30
+ sx = {},
31
+ ...props
32
+ }) => {
33
+ const labelId = (0, _ssr.useSSRSafeId)();
34
+ return /*#__PURE__*/_react.default.createElement(_Box.default, _extends({
35
+ as: "li",
36
+ sx: {
37
+ '&:not(:first-child)': {
38
+ marginTop: 2
39
+ },
40
+ listStyle: 'none',
41
+ // hide the ::marker inserted by browser's stylesheet
42
+ ...sx
43
+ }
44
+ }, props), title && /*#__PURE__*/_react.default.createElement(Header, {
45
+ title: title,
46
+ variant: variant,
47
+ auxiliaryText: auxiliaryText,
48
+ labelId: labelId
49
+ }), /*#__PURE__*/_react.default.createElement(GroupContext.Provider, {
50
+ value: {
51
+ selectionVariant
52
+ }
53
+ }, /*#__PURE__*/_react.default.createElement(_Box.default, {
54
+ as: "ul",
55
+ sx: {
56
+ paddingInlineStart: 0
57
+ },
58
+ "aria-labelledby": title ? labelId : undefined,
59
+ role: role
60
+ }, props.children)));
61
+ };
62
+
63
+ exports.Group = Group;
64
+ Group.displayName = "Group";
65
+
66
+ /**
67
+ * Displays the name and description of a `Group`.
68
+ *
69
+ * For visual presentation only. It's hidden from screen readers.
70
+ */
71
+ const Header = ({
72
+ variant,
73
+ title,
74
+ auxiliaryText,
75
+ labelId,
76
+ ...props
77
+ }) => {
78
+ const {
79
+ variant: listVariant
80
+ } = _react.default.useContext(_List.ListContext);
81
+
82
+ const styles = {
83
+ paddingY: '6px',
84
+ paddingX: listVariant === 'full' ? 2 : 3,
85
+ fontSize: 0,
86
+ fontWeight: 'bold',
87
+ color: 'fg.muted',
88
+ ...(variant === 'filled' && {
89
+ backgroundColor: 'canvas.subtle',
90
+ marginX: 0,
91
+ marginBottom: 2,
92
+ borderTop: '1px solid',
93
+ borderBottom: '1px solid',
94
+ borderColor: 'neutral.muted'
95
+ })
96
+ };
97
+ return /*#__PURE__*/_react.default.createElement(_Box.default, _extends({
98
+ sx: styles,
99
+ role: "presentation",
100
+ "aria-hidden": "true"
101
+ }, props), /*#__PURE__*/_react.default.createElement("span", {
102
+ id: labelId
103
+ }, title), auxiliaryText && /*#__PURE__*/_react.default.createElement("span", null, auxiliaryText));
104
+ };
105
+
106
+ Header.displayName = "Header";
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.Group = exports.GroupContext = void 0;
7
+ const react_1 = __importDefault(require("react"));
8
+ const ssr_1 = require("@react-aria/ssr");
9
+ const Box_1 = __importDefault(require("../Box"));
10
+ const List_1 = require("./List");
11
+ exports.GroupContext = react_1.default.createContext({});
12
+ const Group = ({ title, variant = 'subtle', auxiliaryText, selectionVariant, role, sx = {}, ...props }) => {
13
+ const labelId = ssr_1.useSSRSafeId();
14
+ return (<Box_1.default as="li" sx={{
15
+ '&:not(:first-child)': { marginTop: 2 },
16
+ listStyle: 'none',
17
+ ...sx
18
+ }} {...props}>
19
+ {title && <Header title={title} variant={variant} auxiliaryText={auxiliaryText} labelId={labelId}/>}
20
+ <exports.GroupContext.Provider value={{ selectionVariant }}>
21
+ <Box_1.default as="ul" sx={{ paddingInlineStart: 0 }} aria-labelledby={title ? labelId : undefined} role={role}>
22
+ {props.children}
23
+ </Box_1.default>
24
+ </exports.GroupContext.Provider>
25
+ </Box_1.default>);
26
+ };
27
+ exports.Group = Group;
28
+ /**
29
+ * Displays the name and description of a `Group`.
30
+ *
31
+ * For visual presentation only. It's hidden from screen readers.
32
+ */
33
+ const Header = ({ variant, title, auxiliaryText, labelId, ...props }) => {
34
+ const { variant: listVariant } = react_1.default.useContext(List_1.ListContext);
35
+ const styles = {
36
+ paddingY: '6px',
37
+ paddingX: listVariant === 'full' ? 2 : 3,
38
+ fontSize: 0,
39
+ fontWeight: 'bold',
40
+ color: 'fg.muted',
41
+ ...(variant === 'filled' && {
42
+ backgroundColor: 'canvas.subtle',
43
+ marginX: 0,
44
+ marginBottom: 2,
45
+ borderTop: '1px solid',
46
+ borderBottom: '1px solid',
47
+ borderColor: 'neutral.muted'
48
+ })
49
+ };
50
+ return (<Box_1.default sx={styles} role="presentation" aria-hidden="true" {...props}>
51
+ <span id={labelId}>{title}</span>
52
+ {auxiliaryText && <span>{auxiliaryText}</span>}
53
+ </Box_1.default>);
54
+ };
@@ -0,0 +1,26 @@
1
+ /// <reference types="react" />
2
+ import { SxProp } from '../sx';
3
+ /**
4
+ * Contract for props passed to the `Header` component.
5
+ */
6
+ export declare type HeaderProps = {
7
+ /**
8
+ * Style variations. Usage is discretionary.
9
+ *
10
+ * - `"filled"` - Superimposed on a background, offset from nearby content
11
+ * - `"subtle"` - Relatively less offset from nearby content
12
+ */
13
+ variant?: 'subtle' | 'filled';
14
+ /**
15
+ * Primary text which names a `Group`.
16
+ */
17
+ title?: string;
18
+ /**
19
+ * Secondary text which provides additional information about a `Group`.
20
+ */
21
+ auxiliaryText?: string;
22
+ } & SxProp;
23
+ /**
24
+ * Displays the name and description of a `Group`.
25
+ */
26
+ export declare const Header: ({ variant, title, auxiliaryText, sx, ...props }: HeaderProps) => JSX.Element;
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.Header = void 0;
7
+
8
+ var _react = _interopRequireDefault(require("react"));
9
+
10
+ var _Box = _interopRequireDefault(require("../Box"));
11
+
12
+ var _List = require("./List");
13
+
14
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
15
+
16
+ function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
17
+
18
+ /**
19
+ * Displays the name and description of a `Group`.
20
+ */
21
+ const Header = ({
22
+ variant = 'subtle',
23
+ title,
24
+ auxiliaryText,
25
+ sx = {},
26
+ ...props
27
+ }) => {
28
+ const {
29
+ variant: listVariant
30
+ } = _react.default.useContext(_List.ListContext);
31
+
32
+ const styles = {
33
+ paddingY: '6px',
34
+ paddingX: listVariant === 'full' ? 2 : 3,
35
+ fontSize: 0,
36
+ fontWeight: 'bold',
37
+ color: 'fg.muted',
38
+ ...(variant === 'filled' && {
39
+ backgroundColor: 'canvas.subtle',
40
+ marginX: 0,
41
+ marginBottom: 2,
42
+ borderTop: '1px solid',
43
+ borderBottom: '1px solid',
44
+ borderColor: 'neutral.muted'
45
+ }),
46
+ ...sx
47
+ };
48
+ return /*#__PURE__*/_react.default.createElement(_Box.default, _extends({
49
+ sx: styles,
50
+ role: "heading"
51
+ }, props), title, auxiliaryText && /*#__PURE__*/_react.default.createElement("span", null, auxiliaryText));
52
+ };
53
+
54
+ exports.Header = Header;
55
+ Header.displayName = "Header";
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.Header = void 0;
7
+ const react_1 = __importDefault(require("react"));
8
+ const Box_1 = __importDefault(require("../Box"));
9
+ const List_1 = require("./List");
10
+ /**
11
+ * Displays the name and description of a `Group`.
12
+ */
13
+ const Header = ({ variant = 'subtle', title, auxiliaryText, sx = {}, ...props }) => {
14
+ const { variant: listVariant } = react_1.default.useContext(List_1.ListContext);
15
+ const styles = {
16
+ paddingY: '6px',
17
+ paddingX: listVariant === 'full' ? 2 : 3,
18
+ fontSize: 0,
19
+ fontWeight: 'bold',
20
+ color: 'fg.muted',
21
+ ...(variant === 'filled' && {
22
+ backgroundColor: 'canvas.subtle',
23
+ marginX: 0,
24
+ marginBottom: 2,
25
+ borderTop: '1px solid',
26
+ borderBottom: '1px solid',
27
+ borderColor: 'neutral.muted'
28
+ }),
29
+ ...sx
30
+ };
31
+ return (<Box_1.default sx={styles} role="heading" {...props}>
32
+ {title}
33
+ {auxiliaryText && <span>{auxiliaryText}</span>}
34
+ </Box_1.default>);
35
+ };
36
+ exports.Header = Header;