@primer/components 31.2.0-rc.b718ff50 → 31.2.0-rc.decfca99

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 (420) 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 +13 -1
  5. package/dist/browser.esm.js +620 -618
  6. package/dist/browser.esm.js.map +1 -1
  7. package/dist/browser.umd.js +188 -186
  8. package/dist/browser.umd.js.map +1 -1
  9. package/docs/content/ActionList2.mdx +360 -0
  10. package/docs/content/StateLabel.md +5 -4
  11. package/docs/content/getting-started.md +1 -1
  12. package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +17 -0
  13. package/lib/ActionList/Divider.jsx +29 -0
  14. package/lib/ActionList/Group.jsx +23 -0
  15. package/lib/ActionList/Header.jsx +66 -0
  16. package/lib/ActionList/Item.jsx +301 -0
  17. package/lib/ActionList/List.jsx +138 -0
  18. package/lib/ActionList/index.js +12 -23
  19. package/lib/ActionList2/Description.d.ts +12 -0
  20. package/lib/ActionList2/Description.js +53 -0
  21. package/lib/ActionList2/Description.jsx +30 -0
  22. package/lib/ActionList2/Divider.d.ts +5 -0
  23. package/lib/ActionList2/Divider.js +35 -0
  24. package/lib/ActionList2/Divider.jsx +22 -0
  25. package/lib/ActionList2/Group.d.ts +11 -0
  26. package/lib/ActionList2/Group.js +57 -0
  27. package/lib/ActionList2/Group.jsx +25 -0
  28. package/lib/ActionList2/Header.d.ts +26 -0
  29. package/lib/ActionList2/Header.js +55 -0
  30. package/lib/ActionList2/Header.jsx +36 -0
  31. package/lib/ActionList2/Item.d.ts +63 -0
  32. package/lib/ActionList2/Item.js +244 -0
  33. package/lib/ActionList2/Item.jsx +174 -0
  34. package/lib/ActionList2/LinkItem.d.ts +17 -0
  35. package/lib/ActionList2/LinkItem.js +57 -0
  36. package/lib/ActionList2/LinkItem.jsx +28 -0
  37. package/lib/ActionList2/List.d.ts +26 -0
  38. package/lib/ActionList2/List.js +59 -0
  39. package/lib/ActionList2/List.jsx +41 -0
  40. package/lib/ActionList2/Selection.d.ts +5 -0
  41. package/lib/ActionList2/Selection.js +70 -0
  42. package/lib/ActionList2/Selection.jsx +36 -0
  43. package/lib/ActionList2/Visuals.d.ts +9 -0
  44. package/lib/ActionList2/Visuals.js +90 -0
  45. package/lib/ActionList2/Visuals.jsx +48 -0
  46. package/lib/ActionList2/index.d.ts +36 -0
  47. package/lib/ActionList2/index.js +29 -0
  48. package/lib/ActionMenu.jsx +73 -0
  49. package/lib/AnchoredOverlay/AnchoredOverlay.jsx +100 -0
  50. package/lib/AnchoredOverlay/index.js +4 -12
  51. package/lib/Autocomplete/Autocomplete.d.ts +28 -28
  52. package/lib/Autocomplete/Autocomplete.jsx +100 -0
  53. package/lib/Autocomplete/AutocompleteContext.jsx +5 -0
  54. package/lib/Autocomplete/AutocompleteInput.d.ts +28 -28
  55. package/lib/Autocomplete/AutocompleteInput.jsx +113 -0
  56. package/lib/Autocomplete/AutocompleteMenu.jsx +190 -0
  57. package/lib/Autocomplete/AutocompleteOverlay.jsx +55 -0
  58. package/lib/Autocomplete/index.js +7 -14
  59. package/lib/Avatar.jsx +34 -0
  60. package/lib/AvatarPair.jsx +29 -0
  61. package/lib/AvatarStack.jsx +151 -0
  62. package/lib/BaseStyles.jsx +65 -0
  63. package/lib/BorderBox.jsx +18 -0
  64. package/lib/Box.jsx +10 -0
  65. package/lib/BranchName.jsx +20 -0
  66. package/lib/Breadcrumbs.jsx +74 -0
  67. package/lib/Button/Button.d.ts +25 -25
  68. package/lib/Button/Button.jsx +60 -0
  69. package/lib/Button/ButtonBase.jsx +36 -0
  70. package/lib/Button/ButtonClose.d.ts +45 -45
  71. package/lib/Button/ButtonClose.jsx +55 -0
  72. package/lib/Button/ButtonDanger.d.ts +25 -25
  73. package/lib/Button/ButtonDanger.jsx +63 -0
  74. package/lib/Button/ButtonGroup.jsx +55 -0
  75. package/lib/Button/ButtonInvisible.d.ts +25 -25
  76. package/lib/Button/ButtonInvisible.jsx +52 -0
  77. package/lib/Button/ButtonOutline.d.ts +25 -25
  78. package/lib/Button/ButtonOutline.jsx +63 -0
  79. package/lib/Button/ButtonPrimary.d.ts +25 -25
  80. package/lib/Button/ButtonPrimary.jsx +62 -0
  81. package/lib/Button/ButtonStyles.jsx +37 -0
  82. package/lib/Button/ButtonTableList.jsx +49 -0
  83. package/lib/Button/index.js +21 -70
  84. package/lib/Caret.jsx +93 -0
  85. package/lib/CircleBadge.jsx +43 -0
  86. package/lib/CircleOcticon.d.ts +42 -42
  87. package/lib/CircleOcticon.jsx +21 -0
  88. package/lib/CounterLabel.jsx +44 -0
  89. package/lib/Details.jsx +21 -0
  90. package/lib/Dialog/ConfirmationDialog.jsx +146 -0
  91. package/lib/Dialog/Dialog.jsx +273 -0
  92. package/lib/Dialog.d.ts +45 -45
  93. package/lib/Dialog.jsx +131 -0
  94. package/lib/Dropdown.d.ts +176 -176
  95. package/lib/Dropdown.jsx +134 -0
  96. package/lib/DropdownMenu/DropdownButton.d.ts +46 -46
  97. package/lib/DropdownMenu/DropdownButton.jsx +14 -0
  98. package/lib/DropdownMenu/DropdownMenu.jsx +70 -0
  99. package/lib/DropdownMenu/index.js +6 -20
  100. package/lib/DropdownStyles.js +18 -26
  101. package/lib/FilterList.d.ts +42 -42
  102. package/lib/FilterList.jsx +63 -0
  103. package/lib/FilteredActionList/FilteredActionList.jsx +100 -0
  104. package/lib/FilteredActionList/index.js +4 -12
  105. package/lib/FilteredSearch.jsx +29 -0
  106. package/lib/Flash.jsx +70 -0
  107. package/lib/Flex.jsx +15 -0
  108. package/lib/FormGroup.jsx +25 -0
  109. package/lib/Grid.jsx +15 -0
  110. package/lib/Header.jsx +90 -0
  111. package/lib/Heading.jsx +21 -0
  112. package/lib/Label.jsx +84 -0
  113. package/lib/LabelGroup.jsx +19 -0
  114. package/lib/Link.jsx +38 -0
  115. package/lib/Overlay.jsx +156 -0
  116. package/lib/Pagehead.jsx +18 -0
  117. package/lib/Pagination/Pagination.jsx +163 -0
  118. package/lib/Pagination/index.js +6 -12
  119. package/lib/Pagination/model.jsx +174 -0
  120. package/lib/PointerBox.jsx +25 -0
  121. package/lib/Popover.jsx +210 -0
  122. package/lib/Portal/Portal.jsx +79 -0
  123. package/lib/Portal/index.js +5 -16
  124. package/lib/Position.d.ts +4 -4
  125. package/lib/Position.jsx +46 -0
  126. package/lib/ProgressBar.jsx +39 -0
  127. package/lib/SelectMenu/SelectMenu.d.ts +246 -246
  128. package/lib/SelectMenu/SelectMenu.jsx +114 -0
  129. package/lib/SelectMenu/SelectMenuContext.jsx +5 -0
  130. package/lib/SelectMenu/SelectMenuDivider.jsx +43 -0
  131. package/lib/SelectMenu/SelectMenuFilter.jsx +59 -0
  132. package/lib/SelectMenu/SelectMenuFooter.jsx +46 -0
  133. package/lib/SelectMenu/SelectMenuHeader.jsx +44 -0
  134. package/lib/SelectMenu/SelectMenuItem.d.ts +1 -1
  135. package/lib/SelectMenu/SelectMenuItem.jsx +143 -0
  136. package/lib/SelectMenu/SelectMenuList.jsx +60 -0
  137. package/lib/SelectMenu/SelectMenuLoadingAnimation.jsx +21 -0
  138. package/lib/SelectMenu/SelectMenuModal.d.ts +1 -1
  139. package/lib/SelectMenu/SelectMenuModal.jsx +119 -0
  140. package/lib/SelectMenu/SelectMenuTab.jsx +93 -0
  141. package/lib/SelectMenu/SelectMenuTabPanel.jsx +43 -0
  142. package/lib/SelectMenu/SelectMenuTabs.jsx +58 -0
  143. package/lib/SelectMenu/hooks/useKeyboardNav.js +80 -96
  144. package/lib/SelectMenu/index.js +7 -14
  145. package/lib/SelectPanel/SelectPanel.jsx +105 -0
  146. package/lib/SelectPanel/index.js +4 -12
  147. package/lib/SideNav.jsx +177 -0
  148. package/lib/Spinner.jsx +35 -0
  149. package/lib/StateLabel.d.ts +1 -1
  150. package/lib/StateLabel.js +6 -1
  151. package/lib/StateLabel.jsx +94 -0
  152. package/lib/StyledOcticon.jsx +20 -0
  153. package/lib/SubNav.jsx +104 -0
  154. package/lib/TabNav.jsx +60 -0
  155. package/lib/Text.jsx +14 -0
  156. package/lib/TextInput.jsx +23 -0
  157. package/lib/TextInputWithTokens.d.ts +28 -28
  158. package/lib/TextInputWithTokens.jsx +218 -0
  159. package/lib/ThemeProvider.jsx +130 -0
  160. package/lib/Timeline.d.ts +43 -43
  161. package/lib/Timeline.jsx +124 -0
  162. package/lib/Token/AvatarToken.d.ts +1 -1
  163. package/lib/Token/AvatarToken.jsx +54 -0
  164. package/lib/Token/IssueLabelToken.d.ts +1 -1
  165. package/lib/Token/IssueLabelToken.jsx +125 -0
  166. package/lib/Token/Token.d.ts +1 -1
  167. package/lib/Token/Token.jsx +103 -0
  168. package/lib/Token/TokenBase.jsx +88 -0
  169. package/lib/Token/_RemoveTokenButton.jsx +108 -0
  170. package/lib/Token/_TokenTextContainer.jsx +49 -0
  171. package/lib/Token/index.js +11 -30
  172. package/lib/Tooltip.jsx +246 -0
  173. package/lib/Truncate.jsx +27 -0
  174. package/lib/UnderlineNav.jsx +90 -0
  175. package/lib/_TextInputWrapper.js +2 -2
  176. package/lib/_TextInputWrapper.jsx +120 -0
  177. package/lib/_UnstyledTextInput.jsx +22 -0
  178. package/lib/__tests__/ActionList.test.jsx +49 -0
  179. package/lib/__tests__/ActionList.types.test.jsx +45 -0
  180. package/lib/__tests__/ActionList2.test.d.ts +1 -0
  181. package/lib/__tests__/ActionList2.test.js +53 -0
  182. package/lib/__tests__/ActionList2.test.jsx +46 -0
  183. package/lib/__tests__/ActionMenu.test.jsx +124 -0
  184. package/lib/__tests__/AnchoredOverlay.test.jsx +121 -0
  185. package/lib/__tests__/Autocomplete.test.jsx +299 -0
  186. package/lib/__tests__/Avatar.test.jsx +42 -0
  187. package/lib/__tests__/AvatarStack.test.jsx +43 -0
  188. package/lib/__tests__/BorderBox.test.jsx +36 -0
  189. package/lib/__tests__/Box.test.jsx +41 -0
  190. package/lib/__tests__/BranchName.test.jsx +27 -0
  191. package/lib/__tests__/Breadcrumbs.test.jsx +28 -0
  192. package/lib/__tests__/BreadcrumbsItem.test.jsx +31 -0
  193. package/lib/__tests__/Button.test.jsx +100 -0
  194. package/lib/__tests__/Caret.test.jsx +37 -0
  195. package/lib/__tests__/CircleBadge.test.jsx +55 -0
  196. package/lib/__tests__/CircleOcticon.test.jsx +45 -0
  197. package/lib/__tests__/ConfirmationDialog.test.jsx +119 -0
  198. package/lib/__tests__/CounterLabel.test.jsx +36 -0
  199. package/lib/__tests__/Details.test.jsx +85 -0
  200. package/lib/__tests__/Dialog.test.jsx +139 -0
  201. package/lib/__tests__/Dropdown.test.jsx +49 -0
  202. package/lib/__tests__/DropdownMenu.test.jsx +119 -0
  203. package/lib/__tests__/FilterList.test.jsx +27 -0
  204. package/lib/__tests__/FilterListItem.test.jsx +31 -0
  205. package/lib/__tests__/FilteredSearch.test.jsx +27 -0
  206. package/lib/__tests__/Flash.test.jsx +36 -0
  207. package/lib/__tests__/Flex.test.jsx +51 -0
  208. package/lib/__tests__/FormGroup.test.jsx +36 -0
  209. package/lib/__tests__/Grid.test.jsx +69 -0
  210. package/lib/__tests__/Header.test.jsx +45 -0
  211. package/lib/__tests__/Heading.test.jsx +71 -0
  212. package/lib/__tests__/KeyPaths.types.test.js +5 -8
  213. package/lib/__tests__/Label.test.jsx +33 -0
  214. package/lib/__tests__/LabelGroup.test.jsx +29 -0
  215. package/lib/__tests__/Link.test.jsx +43 -0
  216. package/lib/__tests__/Merge.types.test.js +13 -19
  217. package/lib/__tests__/Overlay.test.jsx +105 -0
  218. package/lib/__tests__/Pagehead.test.jsx +25 -0
  219. package/lib/__tests__/Pagination/Pagination.test.jsx +32 -0
  220. package/lib/__tests__/Pagination/PaginationModel.test.jsx +118 -0
  221. package/lib/__tests__/PointerBox.test.jsx +33 -0
  222. package/lib/__tests__/Popover.test.jsx +58 -0
  223. package/lib/__tests__/Portal.test.jsx +102 -0
  224. package/lib/__tests__/Position.test.jsx +96 -0
  225. package/lib/__tests__/ProgressBar.test.jsx +38 -0
  226. package/lib/__tests__/SelectMenu.test.jsx +120 -0
  227. package/lib/__tests__/SelectPanel.test.jsx +48 -0
  228. package/lib/__tests__/SideNav.test.jsx +55 -0
  229. package/lib/__tests__/Spinner.test.jsx +41 -0
  230. package/lib/__tests__/StateLabel.test.jsx +46 -0
  231. package/lib/__tests__/StyledOcticon.test.jsx +28 -0
  232. package/lib/__tests__/SubNav.test.jsx +47 -0
  233. package/lib/__tests__/SubNavLink.test.jsx +31 -0
  234. package/lib/__tests__/TabNav.test.jsx +32 -0
  235. package/lib/__tests__/Text.test.jsx +71 -0
  236. package/lib/__tests__/TextInput.test.jsx +45 -0
  237. package/lib/__tests__/TextInputWithTokens.test.jsx +302 -0
  238. package/lib/__tests__/ThemeProvider.test.jsx +314 -0
  239. package/lib/__tests__/Timeline.test.jsx +51 -0
  240. package/lib/__tests__/Token.test.jsx +93 -0
  241. package/lib/__tests__/Tooltip.test.jsx +46 -0
  242. package/lib/__tests__/Truncate.test.jsx +41 -0
  243. package/lib/__tests__/UnderlineNav.test.jsx +53 -0
  244. package/lib/__tests__/UnderlineNavLink.test.jsx +31 -0
  245. package/lib/__tests__/behaviors/anchoredPosition.test.js +229 -376
  246. package/lib/__tests__/behaviors/focusTrap.test.jsx +184 -0
  247. package/lib/__tests__/behaviors/focusZone.test.jsx +406 -0
  248. package/lib/__tests__/behaviors/iterateFocusableElements.test.jsx +58 -0
  249. package/lib/__tests__/behaviors/scrollIntoViewingArea.test.js +145 -216
  250. package/lib/__tests__/filterObject.test.js +48 -27
  251. package/lib/__tests__/hooks/useAnchoredPosition.test.jsx +29 -0
  252. package/lib/__tests__/hooks/useOnEscapePress.test.jsx +19 -0
  253. package/lib/__tests__/hooks/useOnOutsideClick.test.jsx +63 -0
  254. package/lib/__tests__/hooks/useOpenAndCloseFocus.test.jsx +61 -0
  255. package/lib/__tests__/hooks/useProvidedStateOrCreate.test.jsx +56 -0
  256. package/lib/__tests__/theme.test.js +33 -34
  257. package/lib/__tests__/themeGet.test.js +12 -23
  258. package/lib/__tests__/useSafeTimeout.test.jsx +36 -0
  259. package/lib/__tests__/utils/createSlots.test.d.ts +1 -0
  260. package/lib/__tests__/utils/createSlots.test.js +75 -0
  261. package/lib/__tests__/utils/createSlots.test.jsx +57 -0
  262. package/lib/behaviors/anchoredPosition.js +205 -234
  263. package/lib/behaviors/focusTrap.js +121 -157
  264. package/lib/behaviors/focusZone.js +434 -509
  265. package/lib/behaviors/scrollIntoViewingArea.js +18 -35
  266. package/lib/constants.js +39 -43
  267. package/lib/drafts.d.ts +7 -0
  268. package/lib/drafts.js +20 -0
  269. package/lib/hooks/index.js +16 -60
  270. package/lib/hooks/useAnchoredPosition.js +32 -40
  271. package/lib/hooks/useCombinedRefs.js +32 -36
  272. package/lib/hooks/useDetails.jsx +39 -0
  273. package/lib/hooks/useDialog.js +72 -96
  274. package/lib/hooks/useFocusTrap.js +43 -60
  275. package/lib/hooks/useFocusZone.js +54 -50
  276. package/lib/hooks/useOnEscapePress.js +25 -36
  277. package/lib/hooks/useOnOutsideClick.jsx +61 -0
  278. package/lib/hooks/useOpenAndCloseFocus.js +22 -34
  279. package/lib/hooks/useOverlay.jsx +15 -0
  280. package/lib/hooks/useProvidedRefOrCreate.js +10 -14
  281. package/lib/hooks/useProvidedStateOrCreate.js +13 -16
  282. package/lib/hooks/useRenderForcingRef.js +13 -17
  283. package/lib/hooks/useResizeObserver.js +15 -18
  284. package/lib/hooks/useSafeTimeout.js +22 -30
  285. package/lib/hooks/useScrollFlash.js +16 -23
  286. package/lib/index.js +161 -636
  287. package/lib/polyfills/eventListenerSignal.js +37 -45
  288. package/lib/stories/ActionList2.stories.js +908 -0
  289. package/lib/stories/TextInput.stories.js +144 -0
  290. package/lib/sx.d.ts +2 -0
  291. package/lib/sx.js +10 -14
  292. package/lib/theme-preval.js +65 -2945
  293. package/lib/theme.js +3 -12
  294. package/lib/utils/create-slots.d.ts +17 -0
  295. package/lib/utils/create-slots.js +105 -0
  296. package/lib/utils/create-slots.jsx +65 -0
  297. package/lib/utils/deprecate.jsx +59 -0
  298. package/lib/utils/isNumeric.jsx +7 -0
  299. package/lib/utils/iterateFocusableElements.js +63 -85
  300. package/lib/utils/ssr.jsx +6 -0
  301. package/lib/utils/test-deprecations.jsx +20 -0
  302. package/lib/utils/test-helpers.jsx +8 -0
  303. package/lib/utils/test-matchers.jsx +100 -0
  304. package/lib/utils/testing.d.ts +14 -1
  305. package/lib/utils/testing.jsx +206 -0
  306. package/lib/utils/theme.js +33 -47
  307. package/lib/utils/types/AriaRole.js +2 -1
  308. package/lib/utils/types/ComponentProps.js +2 -1
  309. package/lib/utils/types/Flatten.js +2 -1
  310. package/lib/utils/types/KeyPaths.js +2 -1
  311. package/lib/utils/types/MandateProps.js +16 -1
  312. package/lib/utils/types/Merge.js +2 -1
  313. package/lib/utils/types/index.js +16 -69
  314. package/lib/utils/uniqueId.js +5 -8
  315. package/lib/utils/use-force-update.d.ts +1 -0
  316. package/lib/utils/use-force-update.js +13 -0
  317. package/lib/utils/useIsomorphicLayoutEffect.js +8 -11
  318. package/lib/utils/userAgent.js +8 -12
  319. package/lib-esm/ActionList2/Description.d.ts +12 -0
  320. package/lib-esm/ActionList2/Description.js +37 -0
  321. package/lib-esm/ActionList2/Divider.d.ts +5 -0
  322. package/lib-esm/ActionList2/Divider.js +23 -0
  323. package/lib-esm/ActionList2/Group.d.ts +11 -0
  324. package/lib-esm/ActionList2/Group.js +40 -0
  325. package/lib-esm/ActionList2/Header.d.ts +26 -0
  326. package/lib-esm/ActionList2/Header.js +44 -0
  327. package/lib-esm/ActionList2/Item.d.ts +63 -0
  328. package/lib-esm/ActionList2/Item.js +210 -0
  329. package/lib-esm/ActionList2/LinkItem.d.ts +17 -0
  330. package/lib-esm/ActionList2/LinkItem.js +43 -0
  331. package/lib-esm/ActionList2/List.d.ts +26 -0
  332. package/lib-esm/ActionList2/List.js +37 -0
  333. package/lib-esm/ActionList2/Selection.d.ts +5 -0
  334. package/lib-esm/ActionList2/Selection.js +52 -0
  335. package/lib-esm/ActionList2/Visuals.d.ts +9 -0
  336. package/lib-esm/ActionList2/Visuals.js +68 -0
  337. package/lib-esm/ActionList2/index.d.ts +36 -0
  338. package/lib-esm/ActionList2/index.js +33 -0
  339. package/lib-esm/Autocomplete/Autocomplete.d.ts +28 -28
  340. package/lib-esm/Autocomplete/AutocompleteInput.d.ts +28 -28
  341. package/lib-esm/Button/Button.d.ts +25 -25
  342. package/lib-esm/Button/ButtonClose.d.ts +45 -45
  343. package/lib-esm/Button/ButtonDanger.d.ts +25 -25
  344. package/lib-esm/Button/ButtonInvisible.d.ts +25 -25
  345. package/lib-esm/Button/ButtonOutline.d.ts +25 -25
  346. package/lib-esm/Button/ButtonPrimary.d.ts +25 -25
  347. package/lib-esm/CircleOcticon.d.ts +42 -42
  348. package/lib-esm/Dialog.d.ts +45 -45
  349. package/lib-esm/Dropdown.d.ts +176 -176
  350. package/lib-esm/DropdownMenu/DropdownButton.d.ts +46 -46
  351. package/lib-esm/FilterList.d.ts +42 -42
  352. package/lib-esm/Position.d.ts +4 -4
  353. package/lib-esm/SelectMenu/SelectMenu.d.ts +246 -246
  354. package/lib-esm/SelectMenu/SelectMenuItem.d.ts +1 -1
  355. package/lib-esm/SelectMenu/SelectMenuModal.d.ts +1 -1
  356. package/lib-esm/StateLabel.d.ts +1 -1
  357. package/lib-esm/StateLabel.js +7 -2
  358. package/lib-esm/TextInputWithTokens.d.ts +28 -28
  359. package/lib-esm/Timeline.d.ts +43 -43
  360. package/lib-esm/Token/AvatarToken.d.ts +1 -1
  361. package/lib-esm/Token/IssueLabelToken.d.ts +1 -1
  362. package/lib-esm/Token/Token.d.ts +1 -1
  363. package/lib-esm/_TextInputWrapper.js +2 -2
  364. package/lib-esm/__tests__/ActionList2.test.d.ts +1 -0
  365. package/lib-esm/__tests__/ActionList2.test.js +41 -0
  366. package/lib-esm/__tests__/utils/createSlots.test.d.ts +1 -0
  367. package/lib-esm/__tests__/utils/createSlots.test.js +67 -0
  368. package/lib-esm/drafts.d.ts +7 -0
  369. package/lib-esm/drafts.js +8 -0
  370. package/lib-esm/stories/ActionList2.stories.js +796 -0
  371. package/lib-esm/stories/TextInput.stories.js +117 -0
  372. package/lib-esm/sx.d.ts +2 -0
  373. package/lib-esm/sx.js +3 -1
  374. package/lib-esm/theme-preval.js +81 -2
  375. package/lib-esm/utils/create-slots.d.ts +17 -0
  376. package/lib-esm/utils/create-slots.js +84 -0
  377. package/lib-esm/utils/testing.d.ts +14 -1
  378. package/lib-esm/utils/use-force-update.d.ts +1 -0
  379. package/lib-esm/utils/use-force-update.js +6 -0
  380. package/package-lock.json +153 -14
  381. package/package.json +7 -4
  382. package/script/build +1 -1
  383. package/src/ActionList2/Description.tsx +49 -0
  384. package/src/ActionList2/Divider.tsx +24 -0
  385. package/src/ActionList2/Group.tsx +34 -0
  386. package/src/ActionList2/Header.tsx +58 -0
  387. package/src/ActionList2/Item.tsx +245 -0
  388. package/src/ActionList2/LinkItem.tsx +49 -0
  389. package/src/ActionList2/List.tsx +55 -0
  390. package/src/ActionList2/Selection.tsx +40 -0
  391. package/src/ActionList2/Visuals.tsx +76 -0
  392. package/src/ActionList2/index.ts +39 -0
  393. package/src/StateLabel.tsx +14 -2
  394. package/src/_TextInputWrapper.tsx +7 -0
  395. package/src/__tests__/ActionList2.test.tsx +47 -0
  396. package/src/__tests__/__snapshots__/ActionList2.test.tsx.snap +14 -0
  397. package/src/__tests__/__snapshots__/Autocomplete.test.tsx.snap +1 -0
  398. package/src/__tests__/__snapshots__/CircleBadge.test.tsx.snap +1 -0
  399. package/src/__tests__/__snapshots__/CircleOcticon.test.tsx.snap +1 -0
  400. package/src/__tests__/__snapshots__/Dialog.test.tsx.snap +1 -0
  401. package/src/__tests__/__snapshots__/DropdownMenu.test.tsx.snap +1 -0
  402. package/src/__tests__/__snapshots__/SelectMenu.test.tsx.snap +4 -0
  403. package/src/__tests__/__snapshots__/SelectPanel.test.tsx.snap +1 -0
  404. package/src/__tests__/__snapshots__/StateLabel.test.tsx.snap +13 -6
  405. package/src/__tests__/__snapshots__/StyledOcticon.test.tsx.snap +1 -0
  406. package/src/__tests__/__snapshots__/TextInputWithTokens.test.tsx.snap +66 -0
  407. package/src/__tests__/__snapshots__/Token.test.tsx.snap +17 -0
  408. package/src/__tests__/utils/__snapshots__/createSlots.test.tsx.snap +55 -0
  409. package/src/__tests__/utils/createSlots.test.tsx +74 -0
  410. package/src/drafts.ts +9 -0
  411. package/src/stories/ActionList2.stories.tsx +1291 -0
  412. package/src/stories/TextInput.stories.tsx +113 -0
  413. package/src/sx.ts +3 -0
  414. package/src/theme-preval.js +1 -0
  415. package/src/utils/create-slots.tsx +96 -0
  416. package/src/utils/use-force-update.ts +7 -0
  417. package/stats.html +1 -1
  418. package/tsconfig.base.json +20 -0
  419. package/tsconfig.build.json +2 -2
  420. package/tsconfig.json +4 -17
@@ -0,0 +1,301 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
5
+ }) : (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ o[k2] = m[k];
8
+ }));
9
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
10
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
11
+ }) : function(o, v) {
12
+ o["default"] = v;
13
+ });
14
+ var __importStar = (this && this.__importStar) || function (mod) {
15
+ if (mod && mod.__esModule) return mod;
16
+ var result = {};
17
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
18
+ __setModuleDefault(result, mod);
19
+ return result;
20
+ };
21
+ var __importDefault = (this && this.__importDefault) || function (mod) {
22
+ return (mod && mod.__esModule) ? mod : { "default": mod };
23
+ };
24
+ Object.defineProperty(exports, "__esModule", { value: true });
25
+ exports.Item = exports.TextContainer = void 0;
26
+ const octicons_react_1 = require("@primer/octicons-react");
27
+ const react_1 = __importStar(require("react"));
28
+ const constants_1 = require("../constants");
29
+ const sx_1 = __importDefault(require("../sx"));
30
+ const Truncate_1 = __importDefault(require("../Truncate"));
31
+ const styled_components_1 = __importDefault(require("styled-components"));
32
+ const Header_1 = require("./Header");
33
+ const Divider_1 = require("./Divider");
34
+ const ThemeProvider_1 = require("../ThemeProvider");
35
+ const focusZone_1 = require("../behaviors/focusZone");
36
+ const ssr_1 = require("@react-aria/ssr");
37
+ /**
38
+ * These colors are not yet in our default theme. Need to remove this once they are added.
39
+ */
40
+ const customItemThemes = {
41
+ default: {
42
+ hover: {
43
+ light: 'rgba(46, 77, 108, 0.06)',
44
+ dark: 'rgba(201, 206, 212, 0.12)',
45
+ dark_dimmed: 'rgba(201, 206, 212, 0.12)'
46
+ },
47
+ focus: {
48
+ light: 'rgba(54, 77, 100, 0.16)',
49
+ dark: 'rgba(201, 206, 212, 0.24)',
50
+ dark_dimmed: 'rgba(201, 206, 212, 0.24)'
51
+ }
52
+ },
53
+ danger: {
54
+ hover: {
55
+ light: 'rgba(234, 74, 90, 0.08)',
56
+ dark: 'rgba(248, 81, 73, 0.16)',
57
+ dark_dimmed: 'rgba(248, 81, 73, 0.16)'
58
+ },
59
+ focus: {
60
+ light: 'rgba(234, 74, 90, 0.14)',
61
+ dark: 'rgba(248, 81, 73, 0.24)',
62
+ dark_dimmed: 'rgba(248, 81, 73, 0.24)'
63
+ }
64
+ }
65
+ };
66
+ const getItemVariant = (variant = 'default', disabled) => {
67
+ if (disabled) {
68
+ return {
69
+ color: constants_1.get('colors.primer.fg.disabled'),
70
+ iconColor: constants_1.get('colors.primer.fg.disabled'),
71
+ annotationColor: constants_1.get('colors.primer.fg.disabled'),
72
+ hoverCursor: 'default'
73
+ };
74
+ }
75
+ switch (variant) {
76
+ case 'danger':
77
+ return {
78
+ color: constants_1.get('colors.danger.fg'),
79
+ iconColor: constants_1.get('colors.danger.fg'),
80
+ annotationColor: constants_1.get('colors.fg.muted'),
81
+ hoverCursor: 'pointer'
82
+ };
83
+ default:
84
+ return {
85
+ color: constants_1.get('colors.fg.default'),
86
+ iconColor: constants_1.get('colors.fg.muted'),
87
+ annotationColor: constants_1.get('colors.fg.muted'),
88
+ hoverCursor: 'pointer'
89
+ };
90
+ }
91
+ };
92
+ const DividedContent = styled_components_1.default.div `
93
+ display: flex;
94
+ min-width: 0;
95
+
96
+ /* Required for dividers */
97
+ position: relative;
98
+ flex-grow: 1;
99
+ `;
100
+ const MainContent = styled_components_1.default.div `
101
+ align-items: baseline;
102
+ display: flex;
103
+ min-width: 0;
104
+ flex-direction: var(--main-content-flex-direction);
105
+ flex-grow: 1;
106
+ `;
107
+ const StyledItem = styled_components_1.default.div `
108
+ /* 6px vertical padding + 20px line height = 32px total height
109
+ *
110
+ * TODO: When rem-based spacing on a 4px scale lands, replace
111
+ * hardcoded '6px' with 'calc((${constants_1.get('space.s32')} - ${constants_1.get('space.20')}) / 2)'.
112
+ */
113
+ padding: 6px ${constants_1.get('space.2')};
114
+ display: flex;
115
+ border-radius: ${constants_1.get('radii.2')};
116
+ color: ${({ variant, item }) => getItemVariant(variant, item?.disabled).color};
117
+ // 2 frames on a 60hz monitor
118
+ transition: background 33.333ms linear;
119
+ text-decoration: none;
120
+
121
+ @media (hover: hover) and (pointer: fine) {
122
+ :hover {
123
+ // allow override in case another item in the list is active/focused
124
+ background: var(--item-hover-bg-override, ${({ hoverBackground }) => hoverBackground});
125
+ cursor: ${({ variant, item }) => getItemVariant(variant, item?.disabled).hoverCursor};
126
+ }
127
+ }
128
+
129
+ // Item dividers
130
+ :not(:first-of-type):not(${Divider_1.StyledDivider} + &):not(${Header_1.StyledHeader} + &) {
131
+ margin-top: ${({ showDivider }) => (showDivider ? `1px` : '0')};
132
+
133
+ ${DividedContent}::before {
134
+ content: ' ';
135
+ display: block;
136
+ position: absolute;
137
+ width: 100%;
138
+ top: -7px;
139
+ // NB: This 'get' won’t execute if it’s moved into the arrow function below.
140
+ border: 0 solid ${constants_1.get('colors.border.muted')};
141
+ border-top-width: ${({ showDivider }) => (showDivider ? `1px` : '0')};
142
+ }
143
+ }
144
+
145
+ // Item dividers should not be visible:
146
+ // - above Hovered
147
+ &:hover ${DividedContent}::before,
148
+ // - below Hovered
149
+ // '*' instead of '&' because '&' maps to separate class names depending on 'variant'
150
+ :hover + * ${DividedContent}::before {
151
+ // allow override in case another item in the list is active/focused
152
+ border-color: var(--item-hover-divider-border-color-override, transparent) !important;
153
+ }
154
+
155
+ // - above Focused
156
+ &:focus ${DividedContent}::before,
157
+ // - below Focused
158
+ // '*' instead of '&' because '&' maps to separate class names depending on 'variant'
159
+ :focus + * ${DividedContent}::before,
160
+ // - above Active Descendent
161
+ &[${focusZone_1.isActiveDescendantAttribute}] ${DividedContent}::before,
162
+ // - below Active Descendent
163
+ [${focusZone_1.isActiveDescendantAttribute}] + & ${DividedContent}::before {
164
+ // '!important' because all the ':not's above give higher specificity
165
+ border-color: transparent !important;
166
+ }
167
+
168
+ // Active Descendant
169
+ &[${focusZone_1.isActiveDescendantAttribute}='${focusZone_1.activeDescendantActivatedDirectly}'] {
170
+ background: ${({ focusBackground }) => focusBackground};
171
+ }
172
+ &[${focusZone_1.isActiveDescendantAttribute}='${focusZone_1.activeDescendantActivatedIndirectly}'] {
173
+ background: ${({ hoverBackground }) => hoverBackground};
174
+ }
175
+
176
+ &:focus {
177
+ background: ${({ focusBackground }) => focusBackground};
178
+ outline: none;
179
+ }
180
+
181
+ &:active {
182
+ background: ${({ focusBackground }) => focusBackground};
183
+ }
184
+
185
+ ${sx_1.default}
186
+ `;
187
+ exports.TextContainer = styled_components_1.default.span ``;
188
+ const BaseVisualContainer = styled_components_1.default.div `
189
+ // Match visual height to adjacent text line height.
190
+ // TODO: When rem-based spacing on a 4px scale lands, replace
191
+ // hardcoded '20px' with '${constants_1.get('space.s20')}'.
192
+ height: 20px;
193
+ width: ${constants_1.get('space.3')};
194
+ margin-right: ${constants_1.get('space.2')};
195
+ `;
196
+ const ColoredVisualContainer = styled_components_1.default(BaseVisualContainer) `
197
+ svg {
198
+ fill: ${({ variant, disabled }) => getItemVariant(variant, disabled).iconColor};
199
+ font-size: ${constants_1.get('fontSizes.0')};
200
+ }
201
+ `;
202
+ const LeadingVisualContainer = styled_components_1.default(ColoredVisualContainer) `
203
+ flex-shrink: 0;
204
+ display: flex;
205
+ flex-direction: column;
206
+ justify-content: center;
207
+ `;
208
+ const TrailingContent = styled_components_1.default(ColoredVisualContainer) `
209
+ color: ${({ variant, disabled }) => getItemVariant(variant, disabled).annotationColor}};
210
+ margin-left: ${constants_1.get('space.2')};
211
+ margin-right: 0;
212
+ width: auto;
213
+ div:nth-child(2) {
214
+ margin-left: ${constants_1.get('space.2')};
215
+ }
216
+ `;
217
+ const DescriptionContainer = styled_components_1.default.span `
218
+ color: ${constants_1.get('colors.fg.muted')};
219
+ font-size: ${constants_1.get('fontSizes.0')};
220
+ // TODO: When rem-based spacing on a 4px scale lands, replace
221
+ // hardcoded '16px' with '${constants_1.get('lh-12')}'.
222
+ line-height: 16px;
223
+ margin-left: var(--description-container-margin-left);
224
+ min-width: 0;
225
+ flex-grow: 1;
226
+ flex-basis: var(--description-container-flex-basis);
227
+ `;
228
+ const MultiSelectInput = styled_components_1.default.input `
229
+ pointer-events: none;
230
+ `;
231
+ /**
232
+ * An actionable or selectable `Item` with an optional icon and description.
233
+ */
234
+ exports.Item = react_1.default.forwardRef((itemProps, ref) => {
235
+ const { as: Component, text, description, descriptionVariant = 'inline', selected, selectionVariant, leadingVisual: LeadingVisual, trailingIcon: TrailingIcon, trailingVisual: TrailingVisual, trailingText, variant = 'default', showDivider, disabled, onAction, onKeyPress, children, onClick, id, ...props } = itemProps;
236
+ const labelId = ssr_1.useSSRSafeId();
237
+ const descriptionId = ssr_1.useSSRSafeId();
238
+ const keyPressHandler = react_1.useCallback(event => {
239
+ if (disabled) {
240
+ return;
241
+ }
242
+ onKeyPress?.(event);
243
+ const isCheckbox = event.target instanceof HTMLInputElement && event.target.type === 'checkbox';
244
+ if (isCheckbox && event.key === ' ') {
245
+ // space key on a checkbox will also trigger a click event. Ignore the space key so we don't get double events
246
+ return;
247
+ }
248
+ if (!event.defaultPrevented && [' ', 'Enter'].includes(event.key)) {
249
+ onAction?.(itemProps, event);
250
+ }
251
+ }, [onAction, disabled, itemProps, onKeyPress]);
252
+ const clickHandler = react_1.useCallback(event => {
253
+ if (disabled) {
254
+ return;
255
+ }
256
+ onClick?.(event);
257
+ if (!event.defaultPrevented) {
258
+ onAction?.(itemProps, event);
259
+ }
260
+ }, [onAction, disabled, itemProps, onClick]);
261
+ const customItemTheme = customItemThemes[variant];
262
+ const hoverBackground = ThemeProvider_1.useColorSchemeVar(customItemTheme.hover, 'inherit');
263
+ const focusBackground = ThemeProvider_1.useColorSchemeVar(customItemTheme.focus, 'inherit');
264
+ const { theme } = ThemeProvider_1.useTheme();
265
+ return (<StyledItem ref={ref} as={Component} tabIndex={disabled ? undefined : -1} variant={variant} showDivider={showDivider} aria-selected={selected} aria-labelledby={text ? labelId : undefined} aria-describedby={description ? descriptionId : undefined} {...props} data-id={id} onKeyPress={keyPressHandler} onClick={clickHandler} hoverBackground={disabled ? 'inherit' : hoverBackground} focusBackground={disabled ? 'inherit' : focusBackground}>
266
+ {!!selected === selected && (<BaseVisualContainer>
267
+ {selectionVariant === 'multiple' ? (<>
268
+ {/*
269
+ * readOnly is required because we are doing a one-way bind to `checked`.
270
+ * aria-readonly="false" tells screen that they can still interact with the checkbox
271
+ */}
272
+ <MultiSelectInput disabled={disabled} tabIndex={-1} type="checkbox" checked={selected} aria-label={text} readOnly aria-readonly="false"/>
273
+ </>) : (selected && <octicons_react_1.CheckIcon fill={theme?.colors.fg.default}/>)}
274
+ </BaseVisualContainer>)}
275
+ {LeadingVisual && (<LeadingVisualContainer variant={variant} disabled={disabled}>
276
+ <LeadingVisual />
277
+ </LeadingVisualContainer>)}
278
+ <DividedContent>
279
+ <MainContent style={{ '--main-content-flex-direction': descriptionVariant === 'inline' ? 'row' : 'column' }}>
280
+ {children}
281
+ {text ? <exports.TextContainer id={labelId}>{text}</exports.TextContainer> : null}
282
+ {description ? (<DescriptionContainer id={descriptionId} style={{
283
+ '--description-container-margin-left': descriptionVariant === 'inline' ? constants_1.get('space.2')(theme) : 0,
284
+ '--description-container-flex-basis': descriptionVariant === 'inline' ? 0 : 'auto'
285
+ }}>
286
+ {descriptionVariant === 'block' ? (description) : (<Truncate_1.default title={description} inline={true} maxWidth="100%">
287
+ {description}
288
+ </Truncate_1.default>)}
289
+ </DescriptionContainer>) : null}
290
+ </MainContent>
291
+ {/* backward compatibility: prefer TrailingVisual but fallback to TrailingIcon */}
292
+ {TrailingVisual ? (<TrailingContent variant={variant} disabled={disabled}>
293
+ {typeof TrailingVisual === 'function' ? <TrailingVisual /> : TrailingVisual}
294
+ </TrailingContent>) : TrailingIcon || trailingText ? (<TrailingContent variant={variant} disabled={disabled}>
295
+ {trailingText}
296
+ {TrailingIcon && <TrailingIcon />}
297
+ </TrailingContent>) : null}
298
+ </DividedContent>
299
+ </StyledItem>);
300
+ });
301
+ exports.Item.displayName = 'ActionList.Item';
@@ -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,53 @@
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
+ color: 'fg.muted',
27
+ fontSize: 0,
28
+ lineHeight: '16px',
29
+ flexGrow: 1,
30
+ flexBasis: 0,
31
+ minWidth: 0,
32
+ marginLeft: variant === 'block' ? 0 : 2
33
+ };
34
+ return /*#__PURE__*/_react.default.createElement(_Item.Slot, {
35
+ name: variant === 'block' ? 'BlockDescription' : 'InlineDescription'
36
+ }, ({
37
+ blockDescriptionId,
38
+ inlineDescriptionId
39
+ }) => variant === 'block' ? /*#__PURE__*/_react.default.createElement(_Box.default, {
40
+ as: "span",
41
+ sx: (0, _sx.merge)(styles, sx),
42
+ id: blockDescriptionId
43
+ }, props.children) : /*#__PURE__*/_react.default.createElement(_Truncate.default, {
44
+ id: inlineDescriptionId,
45
+ sx: (0, _sx.merge)(styles, sx),
46
+ title: props.children,
47
+ inline: true,
48
+ maxWidth: "100%"
49
+ }, props.children));
50
+ };
51
+
52
+ exports.Description = Description;
53
+ Description.displayName = "Description";
@@ -0,0 +1,30 @@
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
+ color: 'fg.muted',
15
+ fontSize: 0,
16
+ lineHeight: '16px',
17
+ flexGrow: 1,
18
+ flexBasis: 0,
19
+ minWidth: 0,
20
+ marginLeft: variant === 'block' ? 0 : 2
21
+ };
22
+ return (<Item_1.Slot name={variant === 'block' ? 'BlockDescription' : 'InlineDescription'}>
23
+ {({ blockDescriptionId, inlineDescriptionId }) => variant === 'block' ? (<Box_1.default as="span" sx={sx_1.merge(styles, sx)} id={blockDescriptionId}>
24
+ {props.children}
25
+ </Box_1.default>) : (<Truncate_1.default id={inlineDescriptionId} sx={sx_1.merge(styles, sx)} title={props.children} inline={true} maxWidth="100%">
26
+ {props.children}
27
+ </Truncate_1.default>)}
28
+ </Item_1.Slot>);
29
+ };
30
+ 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,11 @@
1
+ import React from 'react';
2
+ import { SxProp } from '../sx';
3
+ import { HeaderProps } from './Header';
4
+ import { ListProps } from './List';
5
+ export declare type GroupProps = HeaderProps & SxProp & {
6
+ selectionVariant?: ListProps['selectionVariant'] | false;
7
+ };
8
+ declare type ContextProps = Pick<GroupProps, 'selectionVariant'>;
9
+ export declare const GroupContext: React.Context<ContextProps>;
10
+ export declare const Group: React.FC<GroupProps>;
11
+ export {};