@primer/components 29.1.1 → 30.0.0-rc.9be85598

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 (740) hide show
  1. package/.changeset/README.md +8 -0
  2. package/.changeset/config.json +10 -0
  3. package/.devcontainer/devcontainer.json +8 -0
  4. package/.eslintrc.json +136 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.md +38 -0
  6. package/.github/ISSUE_TEMPLATE/new_component_proposal_template.md +41 -0
  7. package/.github/dependabot.yml +18 -0
  8. package/.github/pull_request_template.md +18 -0
  9. package/.github/workflows/ci.yml +31 -0
  10. package/.github/workflows/deploy_preview.yml +47 -0
  11. package/.github/workflows/deploy_production.yml +70 -0
  12. package/.github/workflows/release.yml +35 -0
  13. package/.github/workflows/release_canary.yml +70 -0
  14. package/.github/workflows/release_candidate.yml +60 -0
  15. package/.github/workflows/size.yml +13 -0
  16. package/.github/workflows/stale.yml +26 -0
  17. package/.gitignore +10 -0
  18. package/.npmrc +4 -0
  19. package/.nvmrc +1 -0
  20. package/.storybook/main.js +11 -0
  21. package/.storybook/preview.js +69 -0
  22. package/.vscode/launch.json +21 -0
  23. package/.vscode/settings.json +13 -0
  24. package/@types/@styled-system/index.d.ts +0 -0
  25. package/@types/@styled-system/prop-types/index.d.ts +1 -0
  26. package/@types/@styled-system/props/index.d.ts +1 -0
  27. package/@types/jest-styled-components/index.d.ts +1 -0
  28. package/CHANGELOG.md +13 -1
  29. package/CODEOWNERS +2 -0
  30. package/babel-defines.js +13 -0
  31. package/babel.config.js +39 -0
  32. package/contributor-docs/CODE_OF_CONDUCT.md +76 -0
  33. package/contributor-docs/CONTRIBUTING.md +274 -0
  34. package/contributor-docs/adrs/adr-001-typescript.md +23 -0
  35. package/contributor-docs/adrs/adr-002-behavior-isolation.md +106 -0
  36. package/contributor-docs/behaviors.md +132 -0
  37. package/contributor-docs/component-contents-api-patterns.md +316 -0
  38. package/contributor-docs/principles.md +39 -0
  39. package/dist/browser.esm.js +131 -131
  40. package/dist/browser.esm.js.map +1 -1
  41. package/dist/browser.umd.js +114 -114
  42. package/dist/browser.umd.js.map +1 -1
  43. package/docs/.eslintrc +0 -0
  44. package/docs/.gitignore +91 -0
  45. package/docs/components/PropsList.js +5 -0
  46. package/docs/components/State.js +9 -0
  47. package/docs/components/constants.js +34 -0
  48. package/docs/components/index.js +2 -0
  49. package/docs/content/ActionList.mdx +72 -0
  50. package/docs/content/ActionMenu.mdx +80 -0
  51. package/docs/content/AnchoredOverlay.mdx +37 -0
  52. package/docs/content/Avatar.mdx +33 -0
  53. package/docs/content/AvatarStack.mdx +43 -0
  54. package/docs/content/BorderBox.md +46 -0
  55. package/docs/content/Box.md +74 -0
  56. package/docs/content/BranchName.md +18 -0
  57. package/docs/content/Breadcrumbs.md +52 -0
  58. package/docs/content/Buttons.md +56 -0
  59. package/docs/content/CircleBadge.md +45 -0
  60. package/docs/content/CircleOcticon.md +18 -0
  61. package/docs/content/CounterLabel.md +32 -0
  62. package/docs/content/Details.md +105 -0
  63. package/docs/content/Dialog.md +108 -0
  64. package/docs/content/Dialog2.mdx +179 -0
  65. package/docs/content/Dropdown.md +72 -0
  66. package/docs/content/DropdownMenu.mdx +49 -0
  67. package/docs/content/FilterList.md +44 -0
  68. package/docs/content/FilteredSearch.md +39 -0
  69. package/docs/content/Flash.md +44 -0
  70. package/docs/content/Flex.md +58 -0
  71. package/docs/content/FormGroup.md +46 -0
  72. package/docs/content/Grid.md +59 -0
  73. package/docs/content/Header.md +79 -0
  74. package/docs/content/Heading.md +22 -0
  75. package/docs/content/Label.md +42 -0
  76. package/docs/content/LabelGroup.md +31 -0
  77. package/docs/content/Link.md +37 -0
  78. package/docs/content/Overlay.mdx +94 -0
  79. package/docs/content/Pagehead.md +27 -0
  80. package/docs/content/Pagination.md +187 -0
  81. package/docs/content/PointerBox.md +81 -0
  82. package/docs/content/Popover.md +137 -0
  83. package/docs/content/Portal.mdx +78 -0
  84. package/docs/content/Position.md +100 -0
  85. package/docs/content/ProgressBar.mdx +29 -0
  86. package/docs/content/SelectMenu.md +435 -0
  87. package/docs/content/SelectPanel.mdx +67 -0
  88. package/docs/content/SideNav.md +179 -0
  89. package/docs/content/Spinner.mdx +32 -0
  90. package/docs/content/StateLabel.md +35 -0
  91. package/docs/content/StyledOcticon.md +36 -0
  92. package/docs/content/SubNav.md +102 -0
  93. package/docs/content/TabNav.md +50 -0
  94. package/docs/content/Text.md +31 -0
  95. package/docs/content/TextInput.md +34 -0
  96. package/docs/content/Timeline.md +138 -0
  97. package/docs/content/Tooltip.md +41 -0
  98. package/docs/content/Truncate.md +64 -0
  99. package/docs/content/UnderlineNav.md +53 -0
  100. package/docs/content/anchoredPosition.mdx +163 -0
  101. package/docs/content/core-concepts.md +70 -0
  102. package/docs/content/focusTrap.mdx +103 -0
  103. package/docs/content/focusZone.mdx +145 -0
  104. package/docs/content/getting-started.md +138 -0
  105. package/docs/content/index.md +33 -0
  106. package/docs/content/linting.md +35 -0
  107. package/docs/content/overriding-styles.mdx +81 -0
  108. package/docs/content/philosophy.md +23 -0
  109. package/docs/content/primer-theme.md +89 -0
  110. package/docs/content/ssr.mdx +43 -0
  111. package/docs/content/system-props.mdx +37 -0
  112. package/docs/content/theme-reference.md +16 -0
  113. package/docs/content/theming.md +249 -0
  114. package/docs/content/useOnEscapePress.mdx +56 -0
  115. package/docs/content/useOnOutsideClick.mdx +57 -0
  116. package/docs/content/useOpenAndCloseFocus.mdx +49 -0
  117. package/docs/content/useOverlay.mdx +62 -0
  118. package/docs/content/useSafeTimeout.mdx +32 -0
  119. package/docs/gatsby-config.js +30 -0
  120. package/docs/gatsby-node.js +101 -0
  121. package/docs/package-lock.json +20979 -0
  122. package/docs/package.json +36 -0
  123. package/docs/src/@primer/gatsby-theme-doctocat/components/hero.js +21 -0
  124. package/docs/src/@primer/gatsby-theme-doctocat/components/live-code.js +84 -0
  125. package/docs/src/@primer/gatsby-theme-doctocat/components/live-preview-wrapper.js +39 -0
  126. package/docs/src/@primer/gatsby-theme-doctocat/components/nav-dropdown.js +48 -0
  127. package/docs/src/@primer/gatsby-theme-doctocat/components/wrap-page-element.js +25 -0
  128. package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +54 -0
  129. package/docs/src/@primer/gatsby-theme-doctocat/nav.yml +127 -0
  130. package/docs/src/@primer/gatsby-theme-doctocat/primer-components-hero.svg +1411 -0
  131. package/docs/src/props.js +77 -0
  132. package/jest.config.js +13 -0
  133. package/lib/ActionList/Item.js +1 -1
  134. package/lib/Breadcrumbs.d.ts +40 -0
  135. package/lib/{Breadcrumb.js → Breadcrumbs.js} +31 -21
  136. package/lib/__tests__/ActionList.d.ts +1 -0
  137. package/lib/__tests__/ActionList.js +64 -0
  138. package/lib/__tests__/ActionMenu.d.ts +1 -0
  139. package/lib/__tests__/ActionMenu.js +151 -0
  140. package/lib/__tests__/AnchoredOverlay.d.ts +1 -0
  141. package/lib/__tests__/AnchoredOverlay.js +160 -0
  142. package/lib/__tests__/Avatar.d.ts +1 -0
  143. package/lib/__tests__/Avatar.js +67 -0
  144. package/lib/__tests__/AvatarStack.d.ts +1 -0
  145. package/lib/__tests__/AvatarStack.js +68 -0
  146. package/lib/__tests__/BorderBox.d.ts +1 -0
  147. package/lib/__tests__/BorderBox.js +58 -0
  148. package/lib/__tests__/Box.d.ts +1 -0
  149. package/lib/__tests__/Box.js +78 -0
  150. package/lib/__tests__/BranchName.d.ts +1 -0
  151. package/lib/__tests__/BranchName.js +36 -0
  152. package/lib/__tests__/Breadcrumbs.d.ts +1 -0
  153. package/lib/__tests__/Breadcrumbs.js +37 -0
  154. package/lib/__tests__/BreadcrumbsItem.d.ts +1 -0
  155. package/lib/__tests__/BreadcrumbsItem.js +49 -0
  156. package/lib/__tests__/Button.d.ts +1 -0
  157. package/lib/__tests__/Button.js +143 -0
  158. package/lib/__tests__/Caret.d.ts +1 -0
  159. package/lib/__tests__/Caret.js +52 -0
  160. package/lib/__tests__/CircleBadge.d.ts +1 -0
  161. package/lib/__tests__/CircleBadge.js +83 -0
  162. package/lib/__tests__/CircleOcticon.d.ts +1 -0
  163. package/lib/__tests__/CircleOcticon.js +71 -0
  164. package/lib/__tests__/CounterLabel.d.ts +1 -0
  165. package/lib/__tests__/CounterLabel.js +58 -0
  166. package/lib/__tests__/Details.d.ts +1 -0
  167. package/lib/__tests__/Details.js +117 -0
  168. package/lib/__tests__/Dialog.d.ts +1 -0
  169. package/lib/__tests__/Dialog.js +184 -0
  170. package/lib/__tests__/Dropdown.d.ts +1 -0
  171. package/lib/__tests__/Dropdown.js +63 -0
  172. package/lib/__tests__/DropdownMenu.d.ts +1 -0
  173. package/lib/__tests__/DropdownMenu.js +150 -0
  174. package/lib/__tests__/FilterList.d.ts +1 -0
  175. package/lib/__tests__/FilterList.js +36 -0
  176. package/lib/__tests__/FilterListItem.d.ts +1 -0
  177. package/lib/__tests__/FilterListItem.js +46 -0
  178. package/lib/__tests__/FilteredSearch.d.ts +1 -0
  179. package/lib/__tests__/FilteredSearch.js +36 -0
  180. package/lib/__tests__/Flash.d.ts +1 -0
  181. package/lib/__tests__/Flash.js +62 -0
  182. package/lib/__tests__/Flex.d.ts +1 -0
  183. package/lib/__tests__/Flex.js +74 -0
  184. package/lib/__tests__/FormGroup.d.ts +1 -0
  185. package/lib/__tests__/FormGroup.js +54 -0
  186. package/lib/__tests__/Grid.d.ts +1 -0
  187. package/lib/__tests__/Grid.js +104 -0
  188. package/lib/__tests__/Header.d.ts +1 -0
  189. package/lib/__tests__/Header.js +58 -0
  190. package/lib/__tests__/Heading.d.ts +1 -0
  191. package/lib/__tests__/Heading.js +109 -0
  192. package/lib/__tests__/Label.d.ts +1 -0
  193. package/lib/__tests__/Label.js +46 -0
  194. package/lib/__tests__/LabelGroup.d.ts +1 -0
  195. package/lib/__tests__/LabelGroup.js +38 -0
  196. package/lib/__tests__/Link.d.ts +1 -0
  197. package/lib/__tests__/Link.js +70 -0
  198. package/lib/__tests__/Overlay.d.ts +1 -0
  199. package/lib/__tests__/Overlay.js +145 -0
  200. package/lib/__tests__/Pagehead.d.ts +1 -0
  201. package/lib/__tests__/Pagehead.js +37 -0
  202. package/lib/__tests__/Pagination/Pagination.d.ts +1 -0
  203. package/lib/__tests__/Pagination/Pagination.js +47 -0
  204. package/lib/__tests__/Pagination/PaginationModel.d.ts +1 -0
  205. package/lib/__tests__/Pagination/PaginationModel.js +186 -0
  206. package/lib/__tests__/PointerBox.d.ts +1 -0
  207. package/lib/__tests__/PointerBox.js +46 -0
  208. package/lib/__tests__/Popover.d.ts +1 -0
  209. package/lib/__tests__/Popover.js +66 -0
  210. package/lib/__tests__/Portal.d.ts +1 -0
  211. package/lib/__tests__/Portal.js +124 -0
  212. package/lib/__tests__/Position.d.ts +1 -0
  213. package/lib/__tests__/Position.js +143 -0
  214. package/lib/__tests__/ProgressBar.d.ts +1 -0
  215. package/lib/__tests__/ProgressBar.js +68 -0
  216. package/lib/__tests__/SelectMenu.d.ts +1 -0
  217. package/lib/__tests__/SelectMenu.js +155 -0
  218. package/lib/__tests__/SelectPanel.d.ts +1 -0
  219. package/lib/__tests__/SelectPanel.js +80 -0
  220. package/lib/__tests__/SideNav.d.ts +1 -0
  221. package/lib/__tests__/SideNav.js +71 -0
  222. package/lib/__tests__/Spinner.d.ts +1 -0
  223. package/lib/__tests__/Spinner.js +53 -0
  224. package/lib/__tests__/StateLabel.d.ts +1 -0
  225. package/lib/__tests__/StateLabel.js +71 -0
  226. package/lib/__tests__/StyledOcticon.d.ts +1 -0
  227. package/lib/__tests__/StyledOcticon.js +40 -0
  228. package/lib/__tests__/SubNav.d.ts +1 -0
  229. package/lib/__tests__/SubNav.js +62 -0
  230. package/lib/__tests__/SubNavLink.d.ts +1 -0
  231. package/lib/__tests__/SubNavLink.js +49 -0
  232. package/lib/__tests__/TabNav.d.ts +1 -0
  233. package/lib/__tests__/TabNav.js +49 -0
  234. package/lib/__tests__/Text.d.ts +1 -0
  235. package/lib/__tests__/Text.js +105 -0
  236. package/lib/__tests__/TextInput.d.ts +1 -0
  237. package/lib/__tests__/TextInput.js +78 -0
  238. package/lib/__tests__/ThemeProvider.d.ts +1 -0
  239. package/lib/__tests__/ThemeProvider.js +444 -0
  240. package/lib/__tests__/Timeline.d.ts +1 -0
  241. package/lib/__tests__/Timeline.js +75 -0
  242. package/lib/__tests__/Tooltip.d.ts +1 -0
  243. package/lib/__tests__/Tooltip.js +69 -0
  244. package/lib/__tests__/Truncate.d.ts +1 -0
  245. package/lib/__tests__/Truncate.js +63 -0
  246. package/lib/__tests__/UnderlineNav.d.ts +1 -0
  247. package/lib/__tests__/UnderlineNav.js +72 -0
  248. package/lib/__tests__/UnderlineNavLink.d.ts +1 -0
  249. package/lib/__tests__/UnderlineNavLink.js +51 -0
  250. package/lib/__tests__/behaviors/anchoredPosition.d.ts +1 -0
  251. package/lib/__tests__/behaviors/anchoredPosition.js +390 -0
  252. package/lib/__tests__/behaviors/focusTrap.d.ts +1 -0
  253. package/lib/__tests__/behaviors/focusTrap.js +234 -0
  254. package/lib/__tests__/behaviors/focusZone.d.ts +1 -0
  255. package/lib/__tests__/behaviors/focusZone.js +570 -0
  256. package/lib/__tests__/behaviors/iterateFocusableElements.d.ts +1 -0
  257. package/lib/__tests__/behaviors/iterateFocusableElements.js +55 -0
  258. package/lib/__tests__/filterObject.d.ts +1 -0
  259. package/lib/__tests__/filterObject.js +30 -0
  260. package/lib/__tests__/hooks/useAnchoredPosition.d.ts +1 -0
  261. package/lib/__tests__/hooks/useAnchoredPosition.js +54 -0
  262. package/lib/__tests__/hooks/useOnEscapePress.d.ts +1 -0
  263. package/lib/__tests__/hooks/useOnEscapePress.js +32 -0
  264. package/lib/__tests__/hooks/useOnOutsideClick.d.ts +1 -0
  265. package/lib/__tests__/hooks/useOnOutsideClick.js +87 -0
  266. package/lib/__tests__/hooks/useOpenAndCloseFocus.d.ts +1 -0
  267. package/lib/__tests__/hooks/useOpenAndCloseFocus.js +60 -0
  268. package/lib/__tests__/hooks/useProvidedStateOrCreate.d.ts +1 -0
  269. package/lib/__tests__/hooks/useProvidedStateOrCreate.js +45 -0
  270. package/lib/__tests__/theme.d.ts +1 -0
  271. package/lib/__tests__/theme.js +36 -0
  272. package/lib/__tests__/themeGet.d.ts +1 -0
  273. package/lib/__tests__/themeGet.js +25 -0
  274. package/lib/__tests__/useSafeTimeout.d.ts +1 -0
  275. package/lib/__tests__/useSafeTimeout.js +45 -0
  276. package/lib/index.d.ts +2 -2
  277. package/lib/index.js +8 -2
  278. package/lib/stories/ActionList.stories.js +382 -0
  279. package/lib/stories/ActionMenu.stories.js +338 -0
  280. package/lib/stories/AnchoredOverlay.stories.js +127 -0
  281. package/lib/stories/AvatarStack.stories.js +49 -0
  282. package/lib/stories/Button.stories.js +114 -0
  283. package/lib/stories/ConfirmationDialog.stories.js +111 -0
  284. package/lib/stories/Dialog.stories.js +265 -0
  285. package/lib/stories/DropdownMenu.stories.js +122 -0
  286. package/lib/stories/Overlay.stories.js +185 -0
  287. package/lib/stories/Portal.stories.js +104 -0
  288. package/lib/stories/SelectPanel.stories.js +342 -0
  289. package/lib/stories/ThemeProvider.stories.js +102 -0
  290. package/lib/stories/useAnchoredPosition.stories.js +351 -0
  291. package/lib/stories/useFocusTrap.stories.js +356 -0
  292. package/lib/stories/useFocusZone.stories.js +599 -0
  293. package/lib/utils/testing.d.ts +0 -1
  294. package/lib-esm/ActionList/Item.js +1 -1
  295. package/lib-esm/Breadcrumbs.d.ts +40 -0
  296. package/lib-esm/{Breadcrumb.js → Breadcrumbs.js} +28 -19
  297. package/lib-esm/__tests__/ActionList.d.ts +1 -0
  298. package/lib-esm/__tests__/ActionList.js +52 -0
  299. package/lib-esm/__tests__/ActionMenu.d.ts +1 -0
  300. package/lib-esm/__tests__/ActionMenu.js +139 -0
  301. package/lib-esm/__tests__/AnchoredOverlay.d.ts +1 -0
  302. package/lib-esm/__tests__/AnchoredOverlay.js +134 -0
  303. package/lib-esm/__tests__/Avatar.d.ts +1 -0
  304. package/lib-esm/__tests__/Avatar.js +56 -0
  305. package/lib-esm/__tests__/AvatarStack.d.ts +1 -0
  306. package/lib-esm/__tests__/AvatarStack.js +55 -0
  307. package/lib-esm/__tests__/BorderBox.d.ts +1 -0
  308. package/lib-esm/__tests__/BorderBox.js +47 -0
  309. package/lib-esm/__tests__/Box.d.ts +1 -0
  310. package/lib-esm/__tests__/Box.js +67 -0
  311. package/lib-esm/__tests__/BranchName.d.ts +1 -0
  312. package/lib-esm/__tests__/BranchName.js +26 -0
  313. package/lib-esm/__tests__/Breadcrumbs.d.ts +1 -0
  314. package/lib-esm/__tests__/Breadcrumbs.js +27 -0
  315. package/lib-esm/__tests__/BreadcrumbsItem.d.ts +1 -0
  316. package/lib-esm/__tests__/BreadcrumbsItem.js +39 -0
  317. package/lib-esm/__tests__/Button.d.ts +1 -0
  318. package/lib-esm/__tests__/Button.js +133 -0
  319. package/lib-esm/__tests__/Caret.d.ts +1 -0
  320. package/lib-esm/__tests__/Caret.js +42 -0
  321. package/lib-esm/__tests__/CircleBadge.d.ts +1 -0
  322. package/lib-esm/__tests__/CircleBadge.js +70 -0
  323. package/lib-esm/__tests__/CircleOcticon.d.ts +1 -0
  324. package/lib-esm/__tests__/CircleOcticon.js +59 -0
  325. package/lib-esm/__tests__/CounterLabel.d.ts +1 -0
  326. package/lib-esm/__tests__/CounterLabel.js +47 -0
  327. package/lib-esm/__tests__/Details.d.ts +1 -0
  328. package/lib-esm/__tests__/Details.js +107 -0
  329. package/lib-esm/__tests__/Dialog.d.ts +1 -0
  330. package/lib-esm/__tests__/Dialog.js +171 -0
  331. package/lib-esm/__tests__/Dropdown.d.ts +1 -0
  332. package/lib-esm/__tests__/Dropdown.js +53 -0
  333. package/lib-esm/__tests__/DropdownMenu.d.ts +1 -0
  334. package/lib-esm/__tests__/DropdownMenu.js +137 -0
  335. package/lib-esm/__tests__/FilterList.d.ts +1 -0
  336. package/lib-esm/__tests__/FilterList.js +26 -0
  337. package/lib-esm/__tests__/FilterListItem.d.ts +1 -0
  338. package/lib-esm/__tests__/FilterListItem.js +36 -0
  339. package/lib-esm/__tests__/FilteredSearch.d.ts +1 -0
  340. package/lib-esm/__tests__/FilteredSearch.js +26 -0
  341. package/lib-esm/__tests__/Flash.d.ts +1 -0
  342. package/lib-esm/__tests__/Flash.js +51 -0
  343. package/lib-esm/__tests__/Flex.d.ts +1 -0
  344. package/lib-esm/__tests__/Flex.js +64 -0
  345. package/lib-esm/__tests__/FormGroup.d.ts +1 -0
  346. package/lib-esm/__tests__/FormGroup.js +44 -0
  347. package/lib-esm/__tests__/Grid.d.ts +1 -0
  348. package/lib-esm/__tests__/Grid.js +94 -0
  349. package/lib-esm/__tests__/Header.d.ts +1 -0
  350. package/lib-esm/__tests__/Header.js +48 -0
  351. package/lib-esm/__tests__/Heading.d.ts +1 -0
  352. package/lib-esm/__tests__/Heading.js +99 -0
  353. package/lib-esm/__tests__/Label.d.ts +1 -0
  354. package/lib-esm/__tests__/Label.js +36 -0
  355. package/lib-esm/__tests__/LabelGroup.d.ts +1 -0
  356. package/lib-esm/__tests__/LabelGroup.js +26 -0
  357. package/lib-esm/__tests__/Link.d.ts +1 -0
  358. package/lib-esm/__tests__/Link.js +60 -0
  359. package/lib-esm/__tests__/Overlay.d.ts +1 -0
  360. package/lib-esm/__tests__/Overlay.js +123 -0
  361. package/lib-esm/__tests__/Pagehead.d.ts +1 -0
  362. package/lib-esm/__tests__/Pagehead.js +26 -0
  363. package/lib-esm/__tests__/Pagination/Pagination.d.ts +1 -0
  364. package/lib-esm/__tests__/Pagination/Pagination.js +35 -0
  365. package/lib-esm/__tests__/Pagination/PaginationModel.d.ts +1 -0
  366. package/lib-esm/__tests__/Pagination/PaginationModel.js +182 -0
  367. package/lib-esm/__tests__/PointerBox.d.ts +1 -0
  368. package/lib-esm/__tests__/PointerBox.js +36 -0
  369. package/lib-esm/__tests__/Popover.d.ts +1 -0
  370. package/lib-esm/__tests__/Popover.js +53 -0
  371. package/lib-esm/__tests__/Portal.d.ts +1 -0
  372. package/lib-esm/__tests__/Portal.js +104 -0
  373. package/lib-esm/__tests__/Position.d.ts +1 -0
  374. package/lib-esm/__tests__/Position.js +133 -0
  375. package/lib-esm/__tests__/ProgressBar.d.ts +1 -0
  376. package/lib-esm/__tests__/ProgressBar.js +58 -0
  377. package/lib-esm/__tests__/SelectMenu.d.ts +1 -0
  378. package/lib-esm/__tests__/SelectMenu.js +145 -0
  379. package/lib-esm/__tests__/SelectPanel.d.ts +1 -0
  380. package/lib-esm/__tests__/SelectPanel.js +65 -0
  381. package/lib-esm/__tests__/SideNav.d.ts +1 -0
  382. package/lib-esm/__tests__/SideNav.js +60 -0
  383. package/lib-esm/__tests__/Spinner.d.ts +1 -0
  384. package/lib-esm/__tests__/Spinner.js +43 -0
  385. package/lib-esm/__tests__/StateLabel.d.ts +1 -0
  386. package/lib-esm/__tests__/StateLabel.js +61 -0
  387. package/lib-esm/__tests__/StyledOcticon.d.ts +1 -0
  388. package/lib-esm/__tests__/StyledOcticon.js +29 -0
  389. package/lib-esm/__tests__/SubNav.d.ts +1 -0
  390. package/lib-esm/__tests__/SubNav.js +50 -0
  391. package/lib-esm/__tests__/SubNavLink.d.ts +1 -0
  392. package/lib-esm/__tests__/SubNavLink.js +39 -0
  393. package/lib-esm/__tests__/TabNav.d.ts +1 -0
  394. package/lib-esm/__tests__/TabNav.js +39 -0
  395. package/lib-esm/__tests__/Text.d.ts +1 -0
  396. package/lib-esm/__tests__/Text.js +93 -0
  397. package/lib-esm/__tests__/TextInput.d.ts +1 -0
  398. package/lib-esm/__tests__/TextInput.js +68 -0
  399. package/lib-esm/__tests__/ThemeProvider.d.ts +1 -0
  400. package/lib-esm/__tests__/ThemeProvider.js +408 -0
  401. package/lib-esm/__tests__/Timeline.d.ts +1 -0
  402. package/lib-esm/__tests__/Timeline.js +65 -0
  403. package/lib-esm/__tests__/Tooltip.d.ts +1 -0
  404. package/lib-esm/__tests__/Tooltip.js +59 -0
  405. package/lib-esm/__tests__/Truncate.d.ts +1 -0
  406. package/lib-esm/__tests__/Truncate.js +53 -0
  407. package/lib-esm/__tests__/UnderlineNav.d.ts +1 -0
  408. package/lib-esm/__tests__/UnderlineNav.js +60 -0
  409. package/lib-esm/__tests__/UnderlineNavLink.d.ts +1 -0
  410. package/lib-esm/__tests__/UnderlineNavLink.js +41 -0
  411. package/lib-esm/__tests__/behaviors/anchoredPosition.d.ts +1 -0
  412. package/lib-esm/__tests__/behaviors/anchoredPosition.js +388 -0
  413. package/lib-esm/__tests__/behaviors/focusTrap.d.ts +1 -0
  414. package/lib-esm/__tests__/behaviors/focusTrap.js +227 -0
  415. package/lib-esm/__tests__/behaviors/focusZone.d.ts +1 -0
  416. package/lib-esm/__tests__/behaviors/focusZone.js +487 -0
  417. package/lib-esm/__tests__/behaviors/iterateFocusableElements.d.ts +1 -0
  418. package/lib-esm/__tests__/behaviors/iterateFocusableElements.js +48 -0
  419. package/lib-esm/__tests__/filterObject.d.ts +1 -0
  420. package/lib-esm/__tests__/filterObject.js +27 -0
  421. package/lib-esm/__tests__/hooks/useAnchoredPosition.d.ts +1 -0
  422. package/lib-esm/__tests__/hooks/useAnchoredPosition.js +46 -0
  423. package/lib-esm/__tests__/hooks/useOnEscapePress.d.ts +1 -0
  424. package/lib-esm/__tests__/hooks/useOnEscapePress.js +23 -0
  425. package/lib-esm/__tests__/hooks/useOnOutsideClick.d.ts +1 -0
  426. package/lib-esm/__tests__/hooks/useOnOutsideClick.js +68 -0
  427. package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.d.ts +1 -0
  428. package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.js +52 -0
  429. package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.d.ts +1 -0
  430. package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.js +36 -0
  431. package/lib-esm/__tests__/theme.d.ts +1 -0
  432. package/lib-esm/__tests__/theme.js +33 -0
  433. package/lib-esm/__tests__/themeGet.d.ts +1 -0
  434. package/lib-esm/__tests__/themeGet.js +22 -0
  435. package/lib-esm/__tests__/useSafeTimeout.d.ts +1 -0
  436. package/lib-esm/__tests__/useSafeTimeout.js +39 -0
  437. package/lib-esm/index.d.ts +2 -2
  438. package/lib-esm/index.js +1 -1
  439. package/lib-esm/stories/ActionList.stories.js +334 -0
  440. package/lib-esm/stories/ActionMenu.stories.js +293 -0
  441. package/lib-esm/stories/AnchoredOverlay.stories.js +101 -0
  442. package/lib-esm/stories/AvatarStack.stories.js +32 -0
  443. package/lib-esm/stories/Button.stories.js +78 -0
  444. package/lib-esm/stories/ConfirmationDialog.stories.js +86 -0
  445. package/lib-esm/stories/Dialog.stories.js +240 -0
  446. package/lib-esm/stories/DropdownMenu.stories.js +94 -0
  447. package/lib-esm/stories/Overlay.stories.js +154 -0
  448. package/lib-esm/stories/Portal.stories.js +68 -0
  449. package/lib-esm/stories/SelectPanel.stories.js +284 -0
  450. package/lib-esm/stories/ThemeProvider.stories.js +83 -0
  451. package/lib-esm/stories/useAnchoredPosition.stories.js +313 -0
  452. package/lib-esm/stories/useFocusTrap.stories.js +309 -0
  453. package/lib-esm/stories/useFocusZone.stories.js +554 -0
  454. package/lib-esm/utils/testing.d.ts +0 -1
  455. package/migrating.md +250 -0
  456. package/now.json +17 -0
  457. package/package-lock.json +29072 -0
  458. package/package.json +10 -9
  459. package/rollup.config.js +36 -0
  460. package/script/build +19 -0
  461. package/script/build-storybook +10 -0
  462. package/script/setup +12 -0
  463. package/src/ActionList/Divider.tsx +25 -0
  464. package/src/ActionList/Group.tsx +45 -0
  465. package/src/ActionList/Header.tsx +74 -0
  466. package/src/ActionList/Item.tsx +460 -0
  467. package/src/ActionList/List.tsx +253 -0
  468. package/src/ActionList/index.ts +21 -0
  469. package/src/ActionMenu.tsx +106 -0
  470. package/src/AnchoredOverlay/AnchoredOverlay.tsx +180 -0
  471. package/src/AnchoredOverlay/index.ts +2 -0
  472. package/src/Avatar.tsx +46 -0
  473. package/src/AvatarPair.tsx +35 -0
  474. package/src/AvatarStack.tsx +161 -0
  475. package/src/BaseStyles.tsx +53 -0
  476. package/src/BorderBox.tsx +18 -0
  477. package/src/Box.tsx +54 -0
  478. package/src/BranchName.tsx +19 -0
  479. package/src/Breadcrumbs.tsx +101 -0
  480. package/src/Button/Button.tsx +40 -0
  481. package/src/Button/ButtonBase.tsx +43 -0
  482. package/src/Button/ButtonClose.tsx +40 -0
  483. package/src/Button/ButtonDanger.tsx +43 -0
  484. package/src/Button/ButtonGroup.tsx +55 -0
  485. package/src/Button/ButtonInvisible.tsx +27 -0
  486. package/src/Button/ButtonOutline.tsx +43 -0
  487. package/src/Button/ButtonPrimary.tsx +41 -0
  488. package/src/Button/ButtonStyles.tsx +36 -0
  489. package/src/Button/ButtonTableList.tsx +58 -0
  490. package/src/Button/index.ts +16 -0
  491. package/src/Caret.tsx +133 -0
  492. package/src/CircleBadge.tsx +55 -0
  493. package/src/CircleOcticon.tsx +37 -0
  494. package/src/CounterLabel.tsx +52 -0
  495. package/src/Details.tsx +23 -0
  496. package/src/Dialog/ConfirmationDialog.tsx +184 -0
  497. package/src/Dialog/Dialog.tsx +419 -0
  498. package/src/Dialog.tsx +149 -0
  499. package/src/Dropdown.tsx +158 -0
  500. package/src/DropdownMenu/DropdownButton.tsx +15 -0
  501. package/src/DropdownMenu/DropdownMenu.tsx +115 -0
  502. package/src/DropdownMenu/index.ts +4 -0
  503. package/src/DropdownStyles.ts +128 -0
  504. package/src/FilterList.tsx +81 -0
  505. package/src/FilteredActionList/FilteredActionList.tsx +152 -0
  506. package/src/FilteredActionList/index.ts +2 -0
  507. package/src/FilteredSearch.tsx +28 -0
  508. package/src/Flash.tsx +77 -0
  509. package/src/Flex.tsx +15 -0
  510. package/src/FormGroup.tsx +27 -0
  511. package/src/Grid.tsx +15 -0
  512. package/src/Header.tsx +84 -0
  513. package/src/Heading.tsx +21 -0
  514. package/src/Label.tsx +75 -0
  515. package/src/LabelGroup.tsx +18 -0
  516. package/src/Link.tsx +46 -0
  517. package/src/Overlay.tsx +194 -0
  518. package/src/Pagehead.tsx +17 -0
  519. package/src/Pagination/Pagination.tsx +214 -0
  520. package/src/Pagination/index.ts +4 -0
  521. package/src/Pagination/model.tsx +187 -0
  522. package/src/PointerBox.tsx +31 -0
  523. package/src/Popover.tsx +236 -0
  524. package/src/Portal/Portal.tsx +96 -0
  525. package/src/Portal/index.ts +5 -0
  526. package/src/Position.tsx +63 -0
  527. package/src/ProgressBar.tsx +52 -0
  528. package/src/SelectMenu/SelectMenu.tsx +125 -0
  529. package/src/SelectMenu/SelectMenuContext.tsx +9 -0
  530. package/src/SelectMenu/SelectMenuDivider.tsx +25 -0
  531. package/src/SelectMenu/SelectMenuFilter.tsx +51 -0
  532. package/src/SelectMenu/SelectMenuFooter.tsx +28 -0
  533. package/src/SelectMenu/SelectMenuHeader.tsx +50 -0
  534. package/src/SelectMenu/SelectMenuItem.tsx +137 -0
  535. package/src/SelectMenu/SelectMenuList.tsx +42 -0
  536. package/src/SelectMenu/SelectMenuLoadingAnimation.tsx +24 -0
  537. package/src/SelectMenu/SelectMenuModal.tsx +121 -0
  538. package/src/SelectMenu/SelectMenuTab.tsx +88 -0
  539. package/src/SelectMenu/SelectMenuTabPanel.tsx +30 -0
  540. package/src/SelectMenu/SelectMenuTabs.tsx +44 -0
  541. package/src/SelectMenu/hooks/useKeyboardNav.js +90 -0
  542. package/src/SelectMenu/index.ts +15 -0
  543. package/src/SelectPanel/SelectPanel.tsx +172 -0
  544. package/src/SelectPanel/index.ts +2 -0
  545. package/src/SideNav.tsx +193 -0
  546. package/src/Spinner.tsx +59 -0
  547. package/src/StateLabel.tsx +110 -0
  548. package/src/StyledOcticon.tsx +24 -0
  549. package/src/SubNav.tsx +129 -0
  550. package/src/TabNav.tsx +77 -0
  551. package/src/Text.tsx +13 -0
  552. package/src/TextInput.tsx +183 -0
  553. package/src/ThemeProvider.tsx +176 -0
  554. package/src/Timeline.tsx +141 -0
  555. package/src/Tooltip.tsx +263 -0
  556. package/src/Truncate.tsx +36 -0
  557. package/src/UnderlineNav.tsx +110 -0
  558. package/src/__tests__/.eslintrc.json +11 -0
  559. package/src/__tests__/ActionList.tsx +47 -0
  560. package/src/__tests__/ActionMenu.tsx +136 -0
  561. package/src/__tests__/AnchoredOverlay.tsx +150 -0
  562. package/src/__tests__/Avatar.tsx +44 -0
  563. package/src/__tests__/AvatarStack.tsx +44 -0
  564. package/src/__tests__/BorderBox.tsx +43 -0
  565. package/src/__tests__/Box.tsx +42 -0
  566. package/src/__tests__/BranchName.tsx +26 -0
  567. package/src/__tests__/Breadcrumbs.tsx +27 -0
  568. package/src/__tests__/BreadcrumbsItem.tsx +31 -0
  569. package/src/__tests__/Button.tsx +128 -0
  570. package/src/__tests__/Caret.tsx +36 -0
  571. package/src/__tests__/CircleBadge.tsx +66 -0
  572. package/src/__tests__/CircleOcticon.tsx +50 -0
  573. package/src/__tests__/CounterLabel.tsx +50 -0
  574. package/src/__tests__/Details.tsx +115 -0
  575. package/src/__tests__/Dialog.tsx +155 -0
  576. package/src/__tests__/Dropdown.tsx +53 -0
  577. package/src/__tests__/DropdownMenu.tsx +136 -0
  578. package/src/__tests__/FilterList.tsx +26 -0
  579. package/src/__tests__/FilterListItem.tsx +31 -0
  580. package/src/__tests__/FilteredSearch.tsx +26 -0
  581. package/src/__tests__/Flash.tsx +45 -0
  582. package/src/__tests__/Flex.tsx +58 -0
  583. package/src/__tests__/FormGroup.tsx +38 -0
  584. package/src/__tests__/Grid.tsx +82 -0
  585. package/src/__tests__/Header.tsx +49 -0
  586. package/src/__tests__/Heading.tsx +91 -0
  587. package/src/__tests__/Label.tsx +34 -0
  588. package/src/__tests__/LabelGroup.tsx +30 -0
  589. package/src/__tests__/Link.tsx +47 -0
  590. package/src/__tests__/Overlay.tsx +103 -0
  591. package/src/__tests__/Pagehead.tsx +23 -0
  592. package/src/__tests__/Pagination/Pagination.tsx +30 -0
  593. package/src/__tests__/Pagination/PaginationModel.tsx +133 -0
  594. package/src/__tests__/Pagination/__snapshots__/Pagination.tsx.snap +184 -0
  595. package/src/__tests__/PointerBox.tsx +34 -0
  596. package/src/__tests__/Popover.tsx +68 -0
  597. package/src/__tests__/Portal.tsx +103 -0
  598. package/src/__tests__/Position.tsx +117 -0
  599. package/src/__tests__/ProgressBar.tsx +40 -0
  600. package/src/__tests__/SelectMenu.tsx +142 -0
  601. package/src/__tests__/SelectPanel.tsx +63 -0
  602. package/src/__tests__/SideNav.tsx +62 -0
  603. package/src/__tests__/Spinner.tsx +42 -0
  604. package/src/__tests__/StateLabel.tsx +48 -0
  605. package/src/__tests__/StyledOcticon.tsx +26 -0
  606. package/src/__tests__/SubNav.tsx +50 -0
  607. package/src/__tests__/SubNavLink.tsx +31 -0
  608. package/src/__tests__/TabNav.tsx +32 -0
  609. package/src/__tests__/Text.tsx +78 -0
  610. package/src/__tests__/TextInput.tsx +49 -0
  611. package/src/__tests__/ThemeProvider.tsx +441 -0
  612. package/src/__tests__/Timeline.tsx +58 -0
  613. package/src/__tests__/Tooltip.tsx +52 -0
  614. package/src/__tests__/Truncate.tsx +43 -0
  615. package/src/__tests__/UnderlineNav.tsx +58 -0
  616. package/src/__tests__/UnderlineNavLink.tsx +31 -0
  617. package/src/__tests__/__snapshots__/ActionList.tsx.snap +27 -0
  618. package/src/__tests__/__snapshots__/ActionMenu.tsx.snap +80 -0
  619. package/src/__tests__/__snapshots__/AnchoredOverlay.tsx.snap +332 -0
  620. package/src/__tests__/__snapshots__/Avatar.tsx.snap +19 -0
  621. package/src/__tests__/__snapshots__/AvatarStack.tsx.snap +377 -0
  622. package/src/__tests__/__snapshots__/BorderBox.tsx.snap +14 -0
  623. package/src/__tests__/__snapshots__/Box.tsx.snap +201 -0
  624. package/src/__tests__/__snapshots__/BranchName.tsx.snap +17 -0
  625. package/src/__tests__/__snapshots__/Breadcrumbs.tsx.snap +29 -0
  626. package/src/__tests__/__snapshots__/BreadcrumbsItem.tsx.snap +79 -0
  627. package/src/__tests__/__snapshots__/Button.tsx.snap +832 -0
  628. package/src/__tests__/__snapshots__/Caret.tsx.snap +373 -0
  629. package/src/__tests__/__snapshots__/CircleBadge.tsx.snap +141 -0
  630. package/src/__tests__/__snapshots__/CircleOcticon.tsx.snap +64 -0
  631. package/src/__tests__/__snapshots__/CounterLabel.tsx.snap +22 -0
  632. package/src/__tests__/__snapshots__/Details.tsx.snap +15 -0
  633. package/src/__tests__/__snapshots__/Dialog.tsx.snap +200 -0
  634. package/src/__tests__/__snapshots__/Dropdown.tsx.snap +249 -0
  635. package/src/__tests__/__snapshots__/DropdownMenu.tsx.snap +106 -0
  636. package/src/__tests__/__snapshots__/FilterList.tsx.snap +13 -0
  637. package/src/__tests__/__snapshots__/FilterListItem.tsx.snap +80 -0
  638. package/src/__tests__/__snapshots__/FilteredSearch.tsx.snap +32 -0
  639. package/src/__tests__/__snapshots__/Flash.tsx.snap +32 -0
  640. package/src/__tests__/__snapshots__/Flex.tsx.snap +130 -0
  641. package/src/__tests__/__snapshots__/FormGroup.tsx.snap +25 -0
  642. package/src/__tests__/__snapshots__/Grid.tsx.snap +178 -0
  643. package/src/__tests__/__snapshots__/Header.tsx.snap +79 -0
  644. package/src/__tests__/__snapshots__/Heading.tsx.snap +13 -0
  645. package/src/__tests__/__snapshots__/Label.tsx.snap +74 -0
  646. package/src/__tests__/__snapshots__/LabelGroup.tsx.snap +15 -0
  647. package/src/__tests__/__snapshots__/Link.tsx.snap +213 -0
  648. package/src/__tests__/__snapshots__/Pagehead.tsx.snap +15 -0
  649. package/src/__tests__/__snapshots__/PointerBox.tsx.snap +174 -0
  650. package/src/__tests__/__snapshots__/Popover.tsx.snap +4687 -0
  651. package/src/__tests__/__snapshots__/Position.tsx.snap +44 -0
  652. package/src/__tests__/__snapshots__/ProgressBar.tsx.snap +53 -0
  653. package/src/__tests__/__snapshots__/SelectMenu.tsx.snap +469 -0
  654. package/src/__tests__/__snapshots__/SelectPanel.tsx.snap +123 -0
  655. package/src/__tests__/__snapshots__/SideNav.tsx.snap +143 -0
  656. package/src/__tests__/__snapshots__/Spinner.tsx.snap +33 -0
  657. package/src/__tests__/__snapshots__/StateLabel.tsx.snap +409 -0
  658. package/src/__tests__/__snapshots__/StyledOcticon.tsx.snap +25 -0
  659. package/src/__tests__/__snapshots__/SubNav.tsx.snap +44 -0
  660. package/src/__tests__/__snapshots__/SubNavLink.tsx.snap +199 -0
  661. package/src/__tests__/__snapshots__/TabNav.tsx.snap +58 -0
  662. package/src/__tests__/__snapshots__/Text.tsx.snap +7 -0
  663. package/src/__tests__/__snapshots__/TextInput.tsx.snap +440 -0
  664. package/src/__tests__/__snapshots__/ThemeProvider.tsx.snap +15 -0
  665. package/src/__tests__/__snapshots__/Timeline.tsx.snap +159 -0
  666. package/src/__tests__/__snapshots__/Tooltip.tsx.snap +227 -0
  667. package/src/__tests__/__snapshots__/Truncate.tsx.snap +17 -0
  668. package/src/__tests__/__snapshots__/UnderlineNav.tsx.snap +59 -0
  669. package/src/__tests__/__snapshots__/UnderlineNavLink.tsx.snap +130 -0
  670. package/src/__tests__/behaviors/anchoredPosition.ts +295 -0
  671. package/src/__tests__/behaviors/focusTrap.tsx +236 -0
  672. package/src/__tests__/behaviors/focusZone.tsx +549 -0
  673. package/src/__tests__/behaviors/iterateFocusableElements.tsx +61 -0
  674. package/src/__tests__/filterObject.ts +54 -0
  675. package/src/__tests__/hooks/useAnchoredPosition.tsx +31 -0
  676. package/src/__tests__/hooks/useOnEscapePress.tsx +16 -0
  677. package/src/__tests__/hooks/useOnOutsideClick.tsx +48 -0
  678. package/src/__tests__/hooks/useOpenAndCloseFocus.tsx +48 -0
  679. package/src/__tests__/hooks/useProvidedStateOrCreate.tsx +39 -0
  680. package/src/__tests__/theme.ts +41 -0
  681. package/src/__tests__/themeGet.ts +15 -0
  682. package/src/__tests__/useSafeTimeout.tsx +36 -0
  683. package/src/behaviors/anchoredPosition.ts +442 -0
  684. package/src/behaviors/focusTrap.ts +184 -0
  685. package/src/behaviors/focusZone.ts +713 -0
  686. package/src/constants.ts +62 -0
  687. package/src/hooks/index.ts +11 -0
  688. package/src/hooks/useAnchoredPosition.ts +53 -0
  689. package/src/hooks/useCombinedRefs.ts +40 -0
  690. package/src/hooks/useDetails.tsx +54 -0
  691. package/src/hooks/useDialog.ts +121 -0
  692. package/src/hooks/useFocusTrap.ts +80 -0
  693. package/src/hooks/useFocusZone.ts +64 -0
  694. package/src/hooks/useOnEscapePress.ts +63 -0
  695. package/src/hooks/useOnOutsideClick.tsx +82 -0
  696. package/src/hooks/useOpenAndCloseFocus.ts +27 -0
  697. package/src/hooks/useOverlay.tsx +32 -0
  698. package/src/hooks/useProvidedRefOrCreate.ts +14 -0
  699. package/src/hooks/useProvidedStateOrCreate.ts +27 -0
  700. package/src/hooks/useRenderForcingRef.ts +22 -0
  701. package/src/hooks/useResizeObserver.ts +11 -0
  702. package/src/hooks/useSafeTimeout.ts +38 -0
  703. package/src/hooks/useScrollFlash.ts +21 -0
  704. package/src/index.ts +165 -0
  705. package/src/polyfills/eventListenerSignal.ts +66 -0
  706. package/src/stories/ActionList.stories.tsx +364 -0
  707. package/src/stories/ActionMenu.stories.tsx +322 -0
  708. package/src/stories/AnchoredOverlay.stories.tsx +117 -0
  709. package/src/stories/AvatarStack.stories.tsx +37 -0
  710. package/src/stories/Button.stories.tsx +88 -0
  711. package/src/stories/ConfirmationDialog.stories.tsx +105 -0
  712. package/src/stories/Dialog.stories.tsx +240 -0
  713. package/src/stories/DropdownMenu.stories.tsx +84 -0
  714. package/src/stories/Overlay.stories.tsx +186 -0
  715. package/src/stories/Portal.stories.tsx +109 -0
  716. package/src/stories/SelectPanel.stories.tsx +300 -0
  717. package/src/stories/ThemeProvider.stories.tsx +104 -0
  718. package/src/stories/useAnchoredPosition.stories.tsx +320 -0
  719. package/src/stories/useFocusTrap.stories.tsx +400 -0
  720. package/src/stories/useFocusZone.stories.tsx +663 -0
  721. package/src/sx.ts +9 -0
  722. package/src/theme-preval.js +136 -0
  723. package/src/theme.ts +3 -0
  724. package/src/utils/deprecate.tsx +73 -0
  725. package/src/utils/isNumeric.tsx +4 -0
  726. package/src/utils/iterateFocusableElements.ts +121 -0
  727. package/src/utils/ssr.tsx +1 -0
  728. package/src/utils/test-deprecations.tsx +19 -0
  729. package/src/utils/test-helpers.tsx +7 -0
  730. package/src/utils/test-matchers.tsx +109 -0
  731. package/src/utils/testing.tsx +242 -0
  732. package/src/utils/theme.js +64 -0
  733. package/src/utils/types.ts +90 -0
  734. package/src/utils/uniqueId.ts +6 -0
  735. package/src/utils/userAgent.ts +7 -0
  736. package/stats.html +3279 -0
  737. package/tsconfig.build.json +7 -0
  738. package/tsconfig.json +20 -0
  739. package/lib/Breadcrumb.d.ts +0 -23
  740. package/lib-esm/Breadcrumb.d.ts +0 -23
@@ -0,0 +1,96 @@
1
+ import React from 'react'
2
+ import {createPortal} from 'react-dom'
3
+
4
+ const PRIMER_PORTAL_ROOT_ID = '__primerPortalRoot__'
5
+ const DEFAULT_PORTAL_CONTAINER_NAME = '__default__'
6
+
7
+ const portalRootRegistry: Partial<Record<string, Element>> = {}
8
+
9
+ /**
10
+ * Register a container to serve as a portal root.
11
+ * @param root The element that will be the root for portals created in this container
12
+ * @param name The name of the container, to be used with the `containerName` prop on the Portal Component.
13
+ * If name is not specified, registers the default portal root.
14
+ */
15
+ export function registerPortalRoot(root: Element, name = DEFAULT_PORTAL_CONTAINER_NAME): void {
16
+ portalRootRegistry[name] = root
17
+ }
18
+
19
+ // Ensures that a default portal root exists and is registered. If a DOM element exists
20
+ // with id __primerPortalRoot__, allow that element to serve as the default portal root.
21
+ // Otherwise, create that element and attach it to the end of document.body.
22
+ function ensureDefaultPortal() {
23
+ const existingDefaultPortalContainer = portalRootRegistry[DEFAULT_PORTAL_CONTAINER_NAME]
24
+ if (!existingDefaultPortalContainer || !document.body.contains(existingDefaultPortalContainer)) {
25
+ let defaultPortalContainer = document.getElementById(PRIMER_PORTAL_ROOT_ID)
26
+ if (!(defaultPortalContainer instanceof Element)) {
27
+ defaultPortalContainer = document.createElement('div')
28
+ defaultPortalContainer.setAttribute('id', PRIMER_PORTAL_ROOT_ID)
29
+ defaultPortalContainer.style.position = 'absolute'
30
+ defaultPortalContainer.style.top = '0'
31
+ defaultPortalContainer.style.left = '0'
32
+ const suitablePortalRoot = document.querySelector('[data-portal-root]')
33
+ if (suitablePortalRoot) {
34
+ suitablePortalRoot.appendChild(defaultPortalContainer)
35
+ } else {
36
+ document.body.appendChild(defaultPortalContainer)
37
+ }
38
+ }
39
+
40
+ registerPortalRoot(defaultPortalContainer)
41
+ }
42
+ }
43
+
44
+ export interface PortalProps {
45
+ /**
46
+ * Called when this portal is added to the DOM
47
+ */
48
+ onMount?: () => void
49
+
50
+ /**
51
+ * Optional. Mount this portal at the container specified
52
+ * by this name. The container must be previously registered
53
+ * with `registerPortal`.
54
+ */
55
+ containerName?: string
56
+ }
57
+
58
+ /**
59
+ * Creates a React Portal, placing all children in a separate physical DOM root node.
60
+ * @see https://reactjs.org/docs/portals.html
61
+ */
62
+ export const Portal: React.FC<PortalProps> = ({children, onMount, containerName: _containerName}) => {
63
+ const hostElement = document.createElement('div')
64
+
65
+ // Portaled content should get their own stacking context so they don't interfere
66
+ // with each other in unexpected ways. One should never find themselves tempted
67
+ // to change the zIndex to a value other than "1".
68
+ hostElement.style.position = 'relative'
69
+ hostElement.style.zIndex = '1'
70
+ const elementRef = React.useRef(hostElement)
71
+
72
+ React.useLayoutEffect(() => {
73
+ let containerName = _containerName
74
+ if (containerName === undefined) {
75
+ containerName = DEFAULT_PORTAL_CONTAINER_NAME
76
+ ensureDefaultPortal()
77
+ }
78
+ const parentElement = portalRootRegistry[containerName]
79
+
80
+ if (!parentElement) {
81
+ throw new Error(
82
+ `Portal container '${_containerName}' is not yet registered. Container must be registered with registerPortal before use.`
83
+ )
84
+ }
85
+ const element = elementRef.current
86
+ parentElement.appendChild(element)
87
+ onMount?.()
88
+
89
+ return () => {
90
+ parentElement.removeChild(element)
91
+ }
92
+ // eslint-disable-next-line react-hooks/exhaustive-deps
93
+ }, [elementRef])
94
+
95
+ return createPortal(children, elementRef.current)
96
+ }
@@ -0,0 +1,5 @@
1
+ import {Portal, PortalProps, registerPortalRoot} from './Portal'
2
+
3
+ export default Portal
4
+ export {registerPortalRoot}
5
+ export type {PortalProps}
@@ -0,0 +1,63 @@
1
+ import React from 'react'
2
+ import styled from 'styled-components'
3
+ import Box from './Box'
4
+ import {ComponentProps} from './utils/types'
5
+
6
+ type StyledPositionProps = {as?: React.ElementType}
7
+
8
+ /**
9
+ * @deprecated Use the Box component instead (i.e. <Position> → <Box>)
10
+ */
11
+ const Position = styled(Box)<StyledPositionProps>``
12
+
13
+ export type PositionProps = ComponentProps<typeof Position>
14
+
15
+ /**
16
+ * @deprecated Use the Box component instead (i.e. <Absolute> → <Box position="absolute">)
17
+ */
18
+ export default Position
19
+
20
+ // Absolute
21
+ export type AbsoluteProps = Omit<PositionProps, 'position'>
22
+
23
+ /**
24
+ * @deprecated Use the Box component instead (i.e. <Absolute> → <Box position="absolute">)
25
+ */
26
+ export const Absolute = React.forwardRef((props: AbsoluteProps, ref) => {
27
+ return <Position {...props} position="absolute" ref={ref} />
28
+ })
29
+ Absolute.displayName = 'Absolute'
30
+
31
+ // Fixed
32
+ export type FixedProps = Omit<PositionProps, 'position'>
33
+
34
+ /**
35
+ * @deprecated Use the Box component instead (i.e. <Fixed> → <Box position="fixed">)
36
+ */
37
+ export const Fixed = React.forwardRef((props: AbsoluteProps, ref) => {
38
+ return <Position {...props} position="fixed" ref={ref} />
39
+ })
40
+ Fixed.displayName = 'Fixed'
41
+
42
+ // Relative
43
+ export type RelativeProps = Omit<PositionProps, 'position'>
44
+
45
+ /**
46
+ * @deprecated Use the Box component instead (i.e. <Relative> → <Box position="relative">)
47
+ */
48
+ export const Relative = React.forwardRef((props: RelativeProps, ref) => {
49
+ return <Position {...props} position="relative" ref={ref} />
50
+ })
51
+ Relative.displayName = 'Relative'
52
+
53
+ // Sticky
54
+ export type StickyProps = Omit<PositionProps, 'position'>
55
+
56
+ /**
57
+ * @deprecated Use the Box component instead (i.e. <Sticky> → <Box position="sticky">)
58
+ */
59
+ export const Sticky = React.forwardRef((props: StickyProps, ref) => {
60
+ return <Position {...props} position="sticky" ref={ref} />
61
+ })
62
+ Sticky.defaultProps = {top: 0, zIndex: 1}
63
+ Sticky.displayName = 'Sticky'
@@ -0,0 +1,52 @@
1
+ import React from 'react'
2
+ import styled from 'styled-components'
3
+ import {width, WidthProps} from 'styled-system'
4
+ import {COMMON, get, SystemCommonProps} from './constants'
5
+ import sx, {SxProp} from './sx'
6
+ import {ComponentProps} from './utils/types'
7
+
8
+ const Bar = styled.span<{progress?: string | number} & SystemCommonProps>`
9
+ width: ${props => (props.progress ? `${props.progress}%` : 0)};
10
+ ${COMMON}
11
+ `
12
+
13
+ const sizeMap = {
14
+ small: '5px',
15
+ large: '10px',
16
+ default: '8px'
17
+ }
18
+
19
+ type StyledProgressContainerProps = {
20
+ inline?: boolean
21
+ barSize?: keyof typeof sizeMap
22
+ } & WidthProps &
23
+ SystemCommonProps &
24
+ SxProp
25
+
26
+ const ProgressContainer = styled.span<StyledProgressContainerProps>`
27
+ display: ${props => (props.inline ? 'inline-flex' : 'flex')};
28
+ overflow: hidden;
29
+ background-color: ${get('colors.border.default')};
30
+ border-radius: ${get('radii.1')};
31
+ height: ${props => sizeMap[props.barSize || 'default']};
32
+ ${COMMON}
33
+ ${width}
34
+ ${sx};
35
+ `
36
+
37
+ export type ProgressBarProps = ComponentProps<typeof ProgressContainer> & ComponentProps<typeof Bar>
38
+
39
+ function ProgressBar({progress, bg, theme, ...rest}: ProgressBarProps) {
40
+ return (
41
+ <ProgressContainer theme={theme} {...rest}>
42
+ <Bar progress={progress} bg={bg} theme={theme} />
43
+ </ProgressContainer>
44
+ )
45
+ }
46
+
47
+ ProgressBar.defaultProps = {
48
+ bg: 'bg.successInverse',
49
+ barSize: 'default'
50
+ }
51
+
52
+ export default ProgressBar
@@ -0,0 +1,125 @@
1
+ import React, {useCallback, useEffect, useRef, useState} from 'react'
2
+ import styled from 'styled-components'
3
+ import {COMMON, SystemCommonProps} from '../constants'
4
+ import sx, {SxProp} from '../sx'
5
+ import {ComponentProps} from '../utils/types'
6
+ import useKeyboardNav from './hooks/useKeyboardNav'
7
+ import {MenuContext} from './SelectMenuContext'
8
+ import SelectMenuDivider from './SelectMenuDivider'
9
+ import SelectMenuFilter from './SelectMenuFilter'
10
+ import SelectMenuFooter from './SelectMenuFooter'
11
+ import SelectMenuHeader from './SelectMenuHeader'
12
+ import SelectMenuItem from './SelectMenuItem'
13
+ import SelectMenuList from './SelectMenuList'
14
+ import SelectMenuLoadingAnimation from './SelectMenuLoadingAnimation'
15
+ import SelectMenuModal from './SelectMenuModal'
16
+ import SelectMenuTab from './SelectMenuTab'
17
+ import SelectMenuTabPanel from './SelectMenuTabPanel'
18
+ import SelectMenuTabs from './SelectMenuTabs'
19
+
20
+ const wrapperStyles = `
21
+ // Remove marker added by the display: list-item browser default
22
+ > summary {
23
+ list-style: none;
24
+ }
25
+ // Remove marker added by details polyfill
26
+ > summary::before {
27
+ display: none;
28
+ }
29
+ // Remove marker added by Chrome
30
+ > summary::-webkit-details-marker {
31
+ display: none;
32
+ }
33
+ `
34
+
35
+ const StyledSelectMenu = styled.details<SystemCommonProps & SxProp>`
36
+ ${wrapperStyles}
37
+ ${COMMON}
38
+ ${sx};
39
+ `
40
+
41
+ type SelectMenuInternalProps = {
42
+ initialTab?: string
43
+ as?: React.ReactElement
44
+ } & ComponentProps<typeof StyledSelectMenu>
45
+
46
+ // 'as' is spread out because we don't want users to be able to change the tag.
47
+ const SelectMenu = React.forwardRef<HTMLElement, SelectMenuInternalProps>(
48
+ ({children, initialTab = '', as: _ignoredAs, ...rest}, forwardedRef) => {
49
+ const backupRef = useRef<HTMLElement>(null)
50
+ const ref = forwardedRef ?? backupRef
51
+ const [selectedTab, setSelectedTab] = useState(initialTab)
52
+ const [open, setOpen] = useState(false)
53
+ const menuProviderValues = {
54
+ selectedTab,
55
+ setSelectedTab,
56
+ setOpen,
57
+ open,
58
+ initialTab
59
+ }
60
+
61
+ const onClickOutside = useCallback(
62
+ event => {
63
+ if ('current' in ref && ref.current && !ref.current.contains(event.target)) {
64
+ if (!event.defaultPrevented) {
65
+ setOpen(false)
66
+ }
67
+ }
68
+ },
69
+ [ref, setOpen]
70
+ )
71
+
72
+ // handles the overlay behavior - closing the menu when clicking outside of it
73
+ useEffect(() => {
74
+ if (open) {
75
+ document.addEventListener('click', onClickOutside)
76
+ return () => {
77
+ document.removeEventListener('click', onClickOutside)
78
+ }
79
+ }
80
+ }, [open, onClickOutside])
81
+
82
+ function toggle(event: React.SyntheticEvent<HTMLDetailsElement, Event>) {
83
+ setOpen((event.target as HTMLDetailsElement).open)
84
+ }
85
+
86
+ useKeyboardNav(ref, open, setOpen)
87
+
88
+ return (
89
+ <MenuContext.Provider value={menuProviderValues}>
90
+ <StyledSelectMenu ref={ref} {...rest} open={open} onToggle={toggle}>
91
+ {children}
92
+ </StyledSelectMenu>
93
+ </MenuContext.Provider>
94
+ )
95
+ }
96
+ )
97
+
98
+ SelectMenu.displayName = 'SelectMenu'
99
+
100
+ export type SelectMenuProps = ComponentProps<typeof SelectMenu>
101
+ export type {SelectMenuDividerProps} from './SelectMenuDivider'
102
+ export type {SelectMenuFilterProps} from './SelectMenuFilter'
103
+ export type {SelectMenuFooterProps} from './SelectMenuFooter'
104
+ export type {SelectMenuHeaderProps} from './SelectMenuHeader'
105
+ export type {SelectMenuItemProps} from './SelectMenuItem'
106
+ export type {SelectMenuListProps} from './SelectMenuList'
107
+ export type {SelectMenuLoadingAnimationProps} from './SelectMenuLoadingAnimation'
108
+ export type {SelectMenuModalProps} from './SelectMenuModal'
109
+ export type {SelectMenuTabProps} from './SelectMenuTab'
110
+ export type {SelectMenuTabPanelProps} from './SelectMenuTabPanel'
111
+ export type {SelectMenuTabsProps} from './SelectMenuTabs'
112
+ export default Object.assign(SelectMenu, {
113
+ MenuContext,
114
+ List: SelectMenuList,
115
+ Divider: SelectMenuDivider,
116
+ Filter: SelectMenuFilter,
117
+ Footer: SelectMenuFooter,
118
+ Item: SelectMenuItem,
119
+ Modal: SelectMenuModal,
120
+ Tabs: SelectMenuTabs,
121
+ Tab: SelectMenuTab,
122
+ TabPanel: SelectMenuTabPanel,
123
+ Header: SelectMenuHeader,
124
+ LoadingAnimation: SelectMenuLoadingAnimation
125
+ })
@@ -0,0 +1,9 @@
1
+ import {createContext} from 'react'
2
+
3
+ export const MenuContext = createContext<{
4
+ selectedTab?: string
5
+ setSelectedTab?: React.Dispatch<React.SetStateAction<string>>
6
+ setOpen?: React.Dispatch<React.SetStateAction<boolean>>
7
+ open?: boolean
8
+ initialTab?: string
9
+ }>({})
@@ -0,0 +1,25 @@
1
+ import styled, {css} from 'styled-components'
2
+ import {COMMON, get, SystemCommonProps} from '../constants'
3
+ import sx, {SxProp} from '../sx'
4
+ import {ComponentProps} from '../utils/types'
5
+
6
+ const dividerStyles = css`
7
+ padding: ${get('space.1')} ${get('space.3')};
8
+ margin: 0;
9
+ font-size: ${get('fontSizes.0')};
10
+ font-weight: ${get('fontWeights.bold')};
11
+ color: ${get('colors.fg.muted')};
12
+ background-color: ${get('colors.canvas.subtle')};
13
+ border-bottom: ${get('borderWidths.1')} solid ${get('colors.border.muted')};
14
+ `
15
+
16
+ const SelectMenuDivider = styled.div<SystemCommonProps & SxProp>`
17
+ ${dividerStyles}
18
+ ${COMMON}
19
+ ${sx};
20
+ `
21
+
22
+ SelectMenuDivider.displayName = 'SelectMenu.Divider'
23
+
24
+ export type SelectMenuDividerProps = ComponentProps<typeof SelectMenuDivider>
25
+ export default SelectMenuDivider
@@ -0,0 +1,51 @@
1
+ import React, {forwardRef, useContext, useEffect, useRef} from 'react'
2
+ import styled from 'styled-components'
3
+ import {COMMON, get, SystemCommonProps} from '../constants'
4
+ import sx, {SxProp} from '../sx'
5
+ import TextInput, {TextInputProps} from '../TextInput'
6
+ import {ComponentProps} from '../utils/types'
7
+ import {MenuContext} from './SelectMenuContext'
8
+
9
+ const StyledForm = styled.form<SystemCommonProps & SxProp>`
10
+ padding: ${get('space.3')};
11
+ margin: 0;
12
+ border-bottom: ${get('borderWidths.1')} solid ${get('colors.border.muted')};
13
+ background-color: ${get('colors.canvas.overlay')};
14
+ ${COMMON};
15
+
16
+ @media (min-width: ${get('breakpoints.0')}) {
17
+ padding: ${get('space.2')};
18
+ }
19
+
20
+ ${sx};
21
+ `
22
+
23
+ type SelectMenuFilterInternalProps = {
24
+ value?: string
25
+ } & TextInputProps
26
+
27
+ const SelectMenuFilter = forwardRef<HTMLInputElement, SelectMenuFilterInternalProps>(
28
+ ({theme, value, sx: sxProp, ...rest}, forwardedRef) => {
29
+ const inputRef = useRef<HTMLInputElement>(null)
30
+ const ref = forwardedRef ?? inputRef
31
+ const {open} = useContext(MenuContext)
32
+
33
+ // puts focus on the filter input when the menu is opened
34
+ useEffect(() => {
35
+ if (open) {
36
+ inputRef.current?.focus()
37
+ }
38
+ }, [open])
39
+
40
+ return (
41
+ <StyledForm theme={theme} sx={sxProp}>
42
+ <TextInput theme={theme} ref={ref} width="100%" block value={value} contrast {...rest} />
43
+ </StyledForm>
44
+ )
45
+ }
46
+ )
47
+
48
+ SelectMenuFilter.displayName = 'SelectMenu.Filter'
49
+
50
+ export type SelectMenuFilterProps = ComponentProps<typeof SelectMenuFilter>
51
+ export default SelectMenuFilter
@@ -0,0 +1,28 @@
1
+ import styled, {css} from 'styled-components'
2
+ import {COMMON, get, SystemCommonProps} from '../constants'
3
+ import sx, {SxProp} from '../sx'
4
+ import {ComponentProps} from '../utils/types'
5
+
6
+ const footerStyles = css`
7
+ margin-top: -1px;
8
+ padding: ${get('space.2')} ${get('space.3')};
9
+ font-size: ${get('fontSizes.0')};
10
+ color: ${get('colors.fg.muted')};
11
+ text-align: center;
12
+ border-top: ${get('borderWidths.1')} solid ${get('colors.border.muted')};
13
+
14
+ @media (min-width: ${get('breakpoints.0')}) {
15
+ padding: ${get('space.1')} ${get('space.2')};
16
+ }
17
+ `
18
+
19
+ const SelectMenuFooter = styled.footer<SystemCommonProps & SxProp>`
20
+ ${footerStyles}
21
+ ${COMMON}
22
+ ${sx};
23
+ `
24
+
25
+ SelectMenuFooter.displayName = 'SelectMenu.Footer'
26
+
27
+ export type SelectMenuFooterProps = ComponentProps<typeof SelectMenuFooter>
28
+ export default SelectMenuFooter
@@ -0,0 +1,50 @@
1
+ import React from 'react'
2
+ import styled from 'styled-components'
3
+ import {COMMON, get, SystemCommonProps, SystemTypographyProps, TYPOGRAPHY} from '../constants'
4
+ import sx, {SxProp} from '../sx'
5
+ import {ComponentProps} from '../utils/types'
6
+
7
+ // SelectMenu.Header is intentionally not exported, it's an internal component used in
8
+ // SelectMenu.Modal
9
+
10
+ const SelectMenuTitle = styled.h3`
11
+ color: ${get('colors.fg.default')};
12
+ flex: auto;
13
+ font-size: ${get('fontSizes.1')};
14
+ font-weight: ${get('fontWeights.bold')};
15
+ margin: 0;
16
+
17
+ @media (min-width: ${get('breakpoints.0')}) {
18
+ font-size: inherit;
19
+ }
20
+ `
21
+
22
+ const StyledHeader = styled.header<SystemTypographyProps & SystemCommonProps & SxProp>`
23
+ display: flex;
24
+ flex: none; // fixes header from getting squeezed in Safari iOS
25
+ padding: ${get('space.3')};
26
+ border-bottom: ${get('borderWidths')} solid ${get('colors.border.muted')};
27
+ ${COMMON}
28
+ ${TYPOGRAPHY}
29
+
30
+ @media (min-width: ${get('breakpoints.0')}) {
31
+ padding-top: ${get('space.2')};
32
+ padding-bottom: ${get('space.2')};
33
+ }
34
+
35
+ ${sx};
36
+ `
37
+
38
+ export type SelectMenuHeaderProps = ComponentProps<typeof StyledHeader>
39
+
40
+ const SelectMenuHeader = ({children, theme, ...rest}: SelectMenuHeaderProps) => {
41
+ return (
42
+ <StyledHeader theme={theme} {...rest}>
43
+ <SelectMenuTitle theme={theme}>{children}</SelectMenuTitle>
44
+ </StyledHeader>
45
+ )
46
+ }
47
+
48
+ SelectMenuHeader.displayName = 'SelectMenu.Header'
49
+
50
+ export default SelectMenuHeader
@@ -0,0 +1,137 @@
1
+ import {CheckIcon} from '@primer/octicons-react'
2
+ import React, {forwardRef, useContext, useRef} from 'react'
3
+ import styled, {css} from 'styled-components'
4
+ import {COMMON, get, SystemCommonProps} from '../constants'
5
+ import StyledOcticon from '../StyledOcticon'
6
+ import sx, {SxProp} from '../sx'
7
+ import {ComponentProps} from '../utils/types'
8
+ import {MenuContext} from './SelectMenuContext'
9
+
10
+ export const listItemStyles = css`
11
+ display: flex;
12
+ align-items: center;
13
+ padding: ${get('space.3')};
14
+ overflow: hidden;
15
+ text-align: left;
16
+ cursor: pointer;
17
+ background-color: ${get('colors.canvas.overlay')};
18
+ border: 0;
19
+ border-bottom: ${get('borderWidths.1')} solid ${get('colors.border.muted')};
20
+ color: ${get('colors.fg.muted')};
21
+ text-decoration: none;
22
+ font-size: ${get('fontSizes.0')};
23
+ font-family: inherit; // needed if user uses a "button" tag
24
+ width: 100%;
25
+
26
+ &:hover {
27
+ text-decoration: none;
28
+ }
29
+ &:focus {
30
+ outline: none;
31
+ }
32
+
33
+ &[hidden] {
34
+ display: none !important;
35
+ }
36
+
37
+ @media (min-width: ${get('breakpoints.0')}) {
38
+ padding-top: ${get('space.2')};
39
+ padding-bottom: ${get('space.2')};
40
+ }
41
+
42
+ .SelectMenu-icon {
43
+ width: ${get('space.3')};
44
+ margin-right: ${get('space.2')};
45
+ flex-shrink: 0;
46
+ }
47
+
48
+ .SelectMenu-selected-icon {
49
+ visibility: hidden;
50
+ transition: transform 0.12s cubic-bezier(0.5, 0.1, 1, 0.5), visibility 0s 0.12s linear;
51
+ transform: scale(0);
52
+ }
53
+
54
+ // selected items
55
+ &[aria-checked='true'] {
56
+ font-weight: 500;
57
+ color: ${get('colors.fg.default')};
58
+
59
+ .SelectMenu-selected-icon {
60
+ visibility: visible;
61
+ transition: transform 0.12s cubic-bezier(0, 0, 0.2, 1), visibility 0s linear;
62
+ transform: scale(1);
63
+ }
64
+ }
65
+
66
+ // can hover states
67
+ @media (hover: hover) {
68
+ &:hover,
69
+ &:active,
70
+ &:focus {
71
+ background-color: ${get('colors.neutral.subtle')};
72
+ }
73
+ }
74
+
75
+ // Can not hover states
76
+ //
77
+ // For touch input
78
+
79
+ @media (hover: none) {
80
+ // Android
81
+ &:focus,
82
+ &:active {
83
+ background-color: ${get('colors.canvas.subtle')};
84
+ }
85
+
86
+ // iOS Safari
87
+ // :active would work if ontouchstart is added to the button
88
+ // Instead this tweaks the "native" highlight color
89
+ -webkit-tap-highlight-color: ${get('colors.selectMenu.tapHighlight')};
90
+ }
91
+ `
92
+
93
+ const StyledItem = styled.a.attrs(() => ({
94
+ role: 'menuitemcheckbox'
95
+ }))<SystemCommonProps & SxProp>`
96
+ ${listItemStyles}
97
+ ${COMMON}
98
+ ${sx};
99
+ `
100
+
101
+ type SelectMenuItemInteralProps = {
102
+ as?: React.ElementType
103
+ selected?: boolean
104
+ } & ComponentProps<typeof StyledItem>
105
+
106
+ const SelectMenuItem = forwardRef<HTMLAnchorElement, SelectMenuItemInteralProps>(
107
+ ({children, selected, theme, onClick, ...rest}, forwardedRef) => {
108
+ const menuContext = useContext(MenuContext)
109
+ const backupRef = useRef<HTMLAnchorElement>(null)
110
+ const itemRef = forwardedRef ?? backupRef
111
+
112
+ // close the menu when an item is clicked
113
+ // this can be overriden if the user provides a `onClick` prop and prevents default in it
114
+ const handleClick = (e: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => {
115
+ onClick && onClick(e)
116
+
117
+ if (!e.defaultPrevented) {
118
+ menuContext.setOpen?.(false)
119
+ }
120
+ }
121
+ return (
122
+ <StyledItem ref={itemRef} {...rest} theme={theme} onClick={handleClick} aria-checked={selected}>
123
+ <StyledOcticon theme={theme} className="SelectMenu-icon SelectMenu-selected-icon" icon={CheckIcon} />
124
+ {children}
125
+ </StyledItem>
126
+ )
127
+ }
128
+ )
129
+
130
+ SelectMenuItem.defaultProps = {
131
+ selected: false
132
+ }
133
+
134
+ SelectMenuItem.displayName = 'SelectMenu.Item'
135
+
136
+ export type SelectMenuItemProps = ComponentProps<typeof SelectMenuItem>
137
+ export default SelectMenuItem
@@ -0,0 +1,42 @@
1
+ import styled, {css} from 'styled-components'
2
+ import {COMMON, get, SystemCommonProps} from '../constants'
3
+ import sx, {SxProp} from '../sx'
4
+ import {ComponentProps} from '../utils/types'
5
+
6
+ const listStyles = css`
7
+ position: relative;
8
+ padding: 0;
9
+ margin: 0;
10
+ flex: auto;
11
+ overflow-x: hidden;
12
+ overflow-y: auto;
13
+ background-color: ${get('colors.canvas.overlay')};
14
+ -webkit-overflow-scrolling: touch; // Adds momentum + bouncy scrolling
15
+
16
+ @media (hover: hover) {
17
+ .SelectMenuTab:focus {
18
+ background-color: ${get('colors.selectMenu.tapFocusBg')};
19
+ }
20
+
21
+ .SelectMenuTab:not([aria-checked='true']):hover {
22
+ color: ${get('colors.fg.default')};
23
+ background-color: ${get('colors.canvas.subtle')};
24
+ }
25
+
26
+ .SelectMenuTab:not([aria-checked='true']):active {
27
+ color: ${get('colors.fg.default')};
28
+ background-color: ${get('colors.canvas.subtle')};
29
+ }
30
+ }
31
+ `
32
+
33
+ const SelectMenuList = styled.div<SystemCommonProps & SxProp>`
34
+ ${listStyles}
35
+ ${COMMON}
36
+ ${sx};
37
+ `
38
+
39
+ SelectMenuList.displayName = 'SelectMenu.List'
40
+
41
+ export type SelectMenuListProps = ComponentProps<typeof SelectMenuList>
42
+ export default SelectMenuList