@primer/components 29.1.0 → 29.1.1-rc.cea79543

Sign up to get free protection for your applications and to get access to all the features.
Files changed (753) 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 +106 -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 +6 -0
  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 +315 -0
  38. package/contributor-docs/principles.md +39 -0
  39. package/docs/.eslintrc +0 -0
  40. package/docs/.gitignore +91 -0
  41. package/docs/components/PropsList.js +5 -0
  42. package/docs/components/State.js +9 -0
  43. package/docs/components/constants.js +34 -0
  44. package/docs/components/index.js +2 -0
  45. package/docs/content/ActionList.mdx +72 -0
  46. package/docs/content/ActionMenu.mdx +80 -0
  47. package/docs/content/AnchoredOverlay.mdx +37 -0
  48. package/docs/content/Avatar.mdx +33 -0
  49. package/docs/content/AvatarStack.mdx +43 -0
  50. package/docs/content/BorderBox.md +46 -0
  51. package/docs/content/Box.md +74 -0
  52. package/docs/content/BranchName.md +18 -0
  53. package/docs/content/Breadcrumbs.md +52 -0
  54. package/docs/content/Buttons.md +54 -0
  55. package/docs/content/CircleBadge.md +45 -0
  56. package/docs/content/CircleOcticon.md +18 -0
  57. package/docs/content/CounterLabel.md +30 -0
  58. package/docs/content/Details.md +105 -0
  59. package/docs/content/Dialog.md +108 -0
  60. package/docs/content/Dialog2.mdx +179 -0
  61. package/docs/content/Dropdown.md +72 -0
  62. package/docs/content/DropdownMenu.mdx +49 -0
  63. package/docs/content/FilterList.md +44 -0
  64. package/docs/content/FilteredSearch.md +39 -0
  65. package/docs/content/Flash.md +42 -0
  66. package/docs/content/Flex.md +58 -0
  67. package/docs/content/FormGroup.md +44 -0
  68. package/docs/content/Grid.md +59 -0
  69. package/docs/content/Header.md +79 -0
  70. package/docs/content/Heading.md +22 -0
  71. package/docs/content/Label.md +40 -0
  72. package/docs/content/LabelGroup.md +31 -0
  73. package/docs/content/Link.md +37 -0
  74. package/docs/content/Overlay.mdx +94 -0
  75. package/docs/content/Pagehead.md +27 -0
  76. package/docs/content/Pagination.md +187 -0
  77. package/docs/content/PointerBox.md +81 -0
  78. package/docs/content/Popover.md +137 -0
  79. package/docs/content/Portal.mdx +73 -0
  80. package/docs/content/Position.md +97 -0
  81. package/docs/content/ProgressBar.mdx +29 -0
  82. package/docs/content/SelectMenu.md +433 -0
  83. package/docs/content/SelectPanel.mdx +67 -0
  84. package/docs/content/SideNav.md +179 -0
  85. package/docs/content/Spinner.mdx +32 -0
  86. package/docs/content/StateLabel.md +33 -0
  87. package/docs/content/StyledOcticon.md +34 -0
  88. package/docs/content/SubNav.md +102 -0
  89. package/docs/content/TabNav.md +50 -0
  90. package/docs/content/Text.md +29 -0
  91. package/docs/content/TextInput.md +32 -0
  92. package/docs/content/Timeline.md +138 -0
  93. package/docs/content/Tooltip.md +41 -0
  94. package/docs/content/Truncate.md +65 -0
  95. package/docs/content/UnderlineNav.md +53 -0
  96. package/docs/content/anchoredPosition.mdx +163 -0
  97. package/docs/content/core-concepts.md +70 -0
  98. package/docs/content/focusTrap.mdx +103 -0
  99. package/docs/content/focusZone.mdx +145 -0
  100. package/docs/content/getting-started.md +134 -0
  101. package/docs/content/index.md +33 -0
  102. package/docs/content/linting.md +35 -0
  103. package/docs/content/overriding-styles.mdx +79 -0
  104. package/docs/content/philosophy.md +23 -0
  105. package/docs/content/primer-theme.md +89 -0
  106. package/docs/content/ssr.mdx +43 -0
  107. package/docs/content/system-props.mdx +37 -0
  108. package/docs/content/theme-reference.md +16 -0
  109. package/docs/content/theming.md +249 -0
  110. package/docs/content/useOnEscapePress.mdx +56 -0
  111. package/docs/content/useOnOutsideClick.mdx +57 -0
  112. package/docs/content/useOpenAndCloseFocus.mdx +49 -0
  113. package/docs/content/useOverlay.mdx +62 -0
  114. package/docs/content/useSafeTimeout.mdx +32 -0
  115. package/docs/gatsby-config.js +30 -0
  116. package/docs/gatsby-node.js +101 -0
  117. package/docs/package-lock.json +20979 -0
  118. package/docs/package.json +35 -0
  119. package/docs/src/@primer/gatsby-theme-doctocat/components/hero.js +21 -0
  120. package/docs/src/@primer/gatsby-theme-doctocat/components/live-code.js +84 -0
  121. package/docs/src/@primer/gatsby-theme-doctocat/components/live-preview-wrapper.js +39 -0
  122. package/docs/src/@primer/gatsby-theme-doctocat/components/nav-dropdown.js +48 -0
  123. package/docs/src/@primer/gatsby-theme-doctocat/components/wrap-page-element.js +25 -0
  124. package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +54 -0
  125. package/docs/src/@primer/gatsby-theme-doctocat/nav.yml +127 -0
  126. package/docs/src/@primer/gatsby-theme-doctocat/primer-components-hero.svg +1411 -0
  127. package/docs/src/props.js +77 -0
  128. package/jest.config.js +13 -0
  129. package/lib/Button/Button.d.ts +0 -1
  130. package/lib/Button/ButtonClose.d.ts +1 -2
  131. package/lib/Button/ButtonDanger.d.ts +0 -1
  132. package/lib/Button/ButtonInvisible.d.ts +0 -1
  133. package/lib/Button/ButtonOutline.d.ts +0 -1
  134. package/lib/Button/ButtonPrimary.d.ts +0 -1
  135. package/lib/CircleOcticon.d.ts +0 -1
  136. package/lib/Dialog.d.ts +2 -3
  137. package/lib/Dropdown.d.ts +0 -4
  138. package/lib/DropdownMenu/DropdownButton.d.ts +1 -2
  139. package/lib/FilterList.d.ts +0 -1
  140. package/lib/Position.d.ts +4 -4
  141. package/lib/SelectMenu/SelectMenu.d.ts +4 -10
  142. package/lib/SelectMenu/SelectMenuItem.d.ts +1 -1
  143. package/lib/SelectMenu/SelectMenuModal.d.ts +1 -1
  144. package/lib/Timeline.d.ts +0 -1
  145. package/lib/__tests__/ActionList.d.ts +1 -0
  146. package/lib/__tests__/ActionList.js +67 -0
  147. package/lib/__tests__/ActionMenu.d.ts +1 -0
  148. package/lib/__tests__/ActionMenu.js +154 -0
  149. package/lib/__tests__/AnchoredOverlay.d.ts +1 -0
  150. package/lib/__tests__/AnchoredOverlay.js +161 -0
  151. package/lib/__tests__/Avatar.d.ts +1 -0
  152. package/lib/__tests__/Avatar.js +70 -0
  153. package/lib/__tests__/AvatarStack.d.ts +1 -0
  154. package/lib/__tests__/AvatarStack.js +71 -0
  155. package/lib/__tests__/BorderBox.d.ts +1 -0
  156. package/lib/__tests__/BorderBox.js +61 -0
  157. package/lib/__tests__/Box.d.ts +1 -0
  158. package/lib/__tests__/Box.js +81 -0
  159. package/lib/__tests__/BranchName.d.ts +1 -0
  160. package/lib/__tests__/BranchName.js +39 -0
  161. package/lib/__tests__/Breadcrumb.d.ts +1 -0
  162. package/lib/__tests__/Breadcrumb.js +42 -0
  163. package/lib/__tests__/BreadcrumbItem.d.ts +1 -0
  164. package/lib/__tests__/BreadcrumbItem.js +52 -0
  165. package/lib/__tests__/Button.d.ts +1 -0
  166. package/lib/__tests__/Button.js +152 -0
  167. package/lib/__tests__/Caret.d.ts +1 -0
  168. package/lib/__tests__/Caret.js +52 -0
  169. package/lib/__tests__/CircleBadge.d.ts +1 -0
  170. package/lib/__tests__/CircleBadge.js +87 -0
  171. package/lib/__tests__/CircleOcticon.d.ts +1 -0
  172. package/lib/__tests__/CircleOcticon.js +74 -0
  173. package/lib/__tests__/CounterLabel.d.ts +1 -0
  174. package/lib/__tests__/CounterLabel.js +61 -0
  175. package/lib/__tests__/Details.d.ts +1 -0
  176. package/lib/__tests__/Details.js +120 -0
  177. package/lib/__tests__/Dialog.d.ts +1 -0
  178. package/lib/__tests__/Dialog.js +188 -0
  179. package/lib/__tests__/Dropdown.d.ts +1 -0
  180. package/lib/__tests__/Dropdown.js +70 -0
  181. package/lib/__tests__/DropdownMenu.d.ts +1 -0
  182. package/lib/__tests__/DropdownMenu.js +153 -0
  183. package/lib/__tests__/FilterList.d.ts +1 -0
  184. package/lib/__tests__/FilterList.js +39 -0
  185. package/lib/__tests__/FilterListItem.d.ts +1 -0
  186. package/lib/__tests__/FilterListItem.js +49 -0
  187. package/lib/__tests__/FilteredSearch.d.ts +1 -0
  188. package/lib/__tests__/FilteredSearch.js +39 -0
  189. package/lib/__tests__/Flash.d.ts +1 -0
  190. package/lib/__tests__/Flash.js +65 -0
  191. package/lib/__tests__/Flex.d.ts +1 -0
  192. package/lib/__tests__/Flex.js +77 -0
  193. package/lib/__tests__/FormGroup.d.ts +1 -0
  194. package/lib/__tests__/FormGroup.js +58 -0
  195. package/lib/__tests__/Grid.d.ts +1 -0
  196. package/lib/__tests__/Grid.js +107 -0
  197. package/lib/__tests__/Header.d.ts +1 -0
  198. package/lib/__tests__/Header.js +63 -0
  199. package/lib/__tests__/Heading.d.ts +1 -0
  200. package/lib/__tests__/Heading.js +112 -0
  201. package/lib/__tests__/Label.d.ts +1 -0
  202. package/lib/__tests__/Label.js +49 -0
  203. package/lib/__tests__/LabelGroup.d.ts +1 -0
  204. package/lib/__tests__/LabelGroup.js +41 -0
  205. package/lib/__tests__/Link.d.ts +1 -0
  206. package/lib/__tests__/Link.js +73 -0
  207. package/lib/__tests__/Overlay.d.ts +1 -0
  208. package/lib/__tests__/Overlay.js +145 -0
  209. package/lib/__tests__/Pagehead.d.ts +1 -0
  210. package/lib/__tests__/Pagehead.js +40 -0
  211. package/lib/__tests__/Pagination/Pagination.d.ts +1 -0
  212. package/lib/__tests__/Pagination/Pagination.js +50 -0
  213. package/lib/__tests__/Pagination/PaginationModel.d.ts +1 -0
  214. package/lib/__tests__/Pagination/PaginationModel.js +186 -0
  215. package/lib/__tests__/PointerBox.d.ts +1 -0
  216. package/lib/__tests__/PointerBox.js +49 -0
  217. package/lib/__tests__/Popover.d.ts +1 -0
  218. package/lib/__tests__/Popover.js +70 -0
  219. package/lib/__tests__/Portal.d.ts +1 -0
  220. package/lib/__tests__/Portal.js +124 -0
  221. package/lib/__tests__/Position.d.ts +1 -0
  222. package/lib/__tests__/Position.js +149 -0
  223. package/lib/__tests__/ProgressBar.d.ts +1 -0
  224. package/lib/__tests__/ProgressBar.js +71 -0
  225. package/lib/__tests__/SelectMenu.d.ts +1 -0
  226. package/lib/__tests__/SelectMenu.js +155 -0
  227. package/lib/__tests__/SelectPanel.d.ts +1 -0
  228. package/lib/__tests__/SelectPanel.js +83 -0
  229. package/lib/__tests__/SideNav.d.ts +1 -0
  230. package/lib/__tests__/SideNav.js +75 -0
  231. package/lib/__tests__/Spinner.d.ts +1 -0
  232. package/lib/__tests__/Spinner.js +56 -0
  233. package/lib/__tests__/StateLabel.d.ts +1 -0
  234. package/lib/__tests__/StateLabel.js +74 -0
  235. package/lib/__tests__/StyledOcticon.d.ts +1 -0
  236. package/lib/__tests__/StyledOcticon.js +43 -0
  237. package/lib/__tests__/SubNav.d.ts +1 -0
  238. package/lib/__tests__/SubNav.js +65 -0
  239. package/lib/__tests__/SubNavLink.d.ts +1 -0
  240. package/lib/__tests__/SubNavLink.js +52 -0
  241. package/lib/__tests__/TabNav.d.ts +1 -0
  242. package/lib/__tests__/TabNav.js +53 -0
  243. package/lib/__tests__/Text.d.ts +1 -0
  244. package/lib/__tests__/Text.js +108 -0
  245. package/lib/__tests__/TextInput.d.ts +1 -0
  246. package/lib/__tests__/TextInput.js +81 -0
  247. package/lib/__tests__/ThemeProvider.d.ts +1 -0
  248. package/lib/__tests__/ThemeProvider.js +444 -0
  249. package/lib/__tests__/Timeline.d.ts +1 -0
  250. package/lib/__tests__/Timeline.js +80 -0
  251. package/lib/__tests__/Tooltip.d.ts +1 -0
  252. package/lib/__tests__/Tooltip.js +72 -0
  253. package/lib/__tests__/Truncate.d.ts +1 -0
  254. package/lib/__tests__/Truncate.js +66 -0
  255. package/lib/__tests__/UnderlineNav.d.ts +1 -0
  256. package/lib/__tests__/UnderlineNav.js +75 -0
  257. package/lib/__tests__/UnderlineNavLink.d.ts +1 -0
  258. package/lib/__tests__/UnderlineNavLink.js +54 -0
  259. package/lib/__tests__/behaviors/anchoredPosition.d.ts +1 -0
  260. package/lib/__tests__/behaviors/anchoredPosition.js +390 -0
  261. package/lib/__tests__/behaviors/focusTrap.d.ts +1 -0
  262. package/lib/__tests__/behaviors/focusTrap.js +234 -0
  263. package/lib/__tests__/behaviors/focusZone.d.ts +1 -0
  264. package/lib/__tests__/behaviors/focusZone.js +570 -0
  265. package/lib/__tests__/behaviors/iterateFocusableElements.d.ts +1 -0
  266. package/lib/__tests__/behaviors/iterateFocusableElements.js +55 -0
  267. package/lib/__tests__/filterObject.d.ts +1 -0
  268. package/lib/__tests__/filterObject.js +30 -0
  269. package/lib/__tests__/hooks/useAnchoredPosition.d.ts +1 -0
  270. package/lib/__tests__/hooks/useAnchoredPosition.js +54 -0
  271. package/lib/__tests__/hooks/useOnEscapePress.d.ts +1 -0
  272. package/lib/__tests__/hooks/useOnEscapePress.js +32 -0
  273. package/lib/__tests__/hooks/useOnOutsideClick.d.ts +1 -0
  274. package/lib/__tests__/hooks/useOnOutsideClick.js +87 -0
  275. package/lib/__tests__/hooks/useOpenAndCloseFocus.d.ts +1 -0
  276. package/lib/__tests__/hooks/useOpenAndCloseFocus.js +60 -0
  277. package/lib/__tests__/hooks/useProvidedStateOrCreate.d.ts +1 -0
  278. package/lib/__tests__/hooks/useProvidedStateOrCreate.js +45 -0
  279. package/lib/__tests__/theme.d.ts +1 -0
  280. package/lib/__tests__/theme.js +36 -0
  281. package/lib/__tests__/themeGet.d.ts +1 -0
  282. package/lib/__tests__/themeGet.js +25 -0
  283. package/lib/__tests__/useSafeTimeout.d.ts +1 -0
  284. package/lib/__tests__/useSafeTimeout.js +45 -0
  285. package/lib/stories/ActionList.stories.js +382 -0
  286. package/lib/stories/ActionMenu.stories.js +338 -0
  287. package/lib/stories/AnchoredOverlay.stories.js +127 -0
  288. package/lib/stories/AvatarStack.stories.js +49 -0
  289. package/lib/stories/Button.stories.js +114 -0
  290. package/lib/stories/ConfirmationDialog.stories.js +111 -0
  291. package/lib/stories/Dialog.stories.js +265 -0
  292. package/lib/stories/DropdownMenu.stories.js +122 -0
  293. package/lib/stories/Overlay.stories.js +185 -0
  294. package/lib/stories/Portal.stories.js +104 -0
  295. package/lib/stories/SelectPanel.stories.js +342 -0
  296. package/lib/stories/ThemeProvider.stories.js +102 -0
  297. package/lib/stories/useAnchoredPosition.stories.js +351 -0
  298. package/lib/stories/useFocusTrap.stories.js +356 -0
  299. package/lib/stories/useFocusZone.stories.js +599 -0
  300. package/lib-esm/Button/Button.d.ts +0 -1
  301. package/lib-esm/Button/ButtonClose.d.ts +1 -2
  302. package/lib-esm/Button/ButtonDanger.d.ts +0 -1
  303. package/lib-esm/Button/ButtonInvisible.d.ts +0 -1
  304. package/lib-esm/Button/ButtonOutline.d.ts +0 -1
  305. package/lib-esm/Button/ButtonPrimary.d.ts +0 -1
  306. package/lib-esm/CircleOcticon.d.ts +0 -1
  307. package/lib-esm/Dialog.d.ts +2 -3
  308. package/lib-esm/Dropdown.d.ts +0 -4
  309. package/lib-esm/DropdownMenu/DropdownButton.d.ts +1 -2
  310. package/lib-esm/FilterList.d.ts +0 -1
  311. package/lib-esm/Position.d.ts +4 -4
  312. package/lib-esm/SelectMenu/SelectMenu.d.ts +4 -10
  313. package/lib-esm/SelectMenu/SelectMenuItem.d.ts +1 -1
  314. package/lib-esm/SelectMenu/SelectMenuModal.d.ts +1 -1
  315. package/lib-esm/Timeline.d.ts +0 -1
  316. package/lib-esm/__tests__/ActionList.d.ts +1 -0
  317. package/lib-esm/__tests__/ActionList.js +54 -0
  318. package/lib-esm/__tests__/ActionMenu.d.ts +1 -0
  319. package/lib-esm/__tests__/ActionMenu.js +141 -0
  320. package/lib-esm/__tests__/AnchoredOverlay.d.ts +1 -0
  321. package/lib-esm/__tests__/AnchoredOverlay.js +135 -0
  322. package/lib-esm/__tests__/Avatar.d.ts +1 -0
  323. package/lib-esm/__tests__/Avatar.js +58 -0
  324. package/lib-esm/__tests__/AvatarStack.d.ts +1 -0
  325. package/lib-esm/__tests__/AvatarStack.js +57 -0
  326. package/lib-esm/__tests__/BorderBox.d.ts +1 -0
  327. package/lib-esm/__tests__/BorderBox.js +49 -0
  328. package/lib-esm/__tests__/Box.d.ts +1 -0
  329. package/lib-esm/__tests__/Box.js +69 -0
  330. package/lib-esm/__tests__/BranchName.d.ts +1 -0
  331. package/lib-esm/__tests__/BranchName.js +28 -0
  332. package/lib-esm/__tests__/Breadcrumb.d.ts +1 -0
  333. package/lib-esm/__tests__/Breadcrumb.js +31 -0
  334. package/lib-esm/__tests__/BreadcrumbItem.d.ts +1 -0
  335. package/lib-esm/__tests__/BreadcrumbItem.js +41 -0
  336. package/lib-esm/__tests__/Button.d.ts +1 -0
  337. package/lib-esm/__tests__/Button.js +141 -0
  338. package/lib-esm/__tests__/Caret.d.ts +1 -0
  339. package/lib-esm/__tests__/Caret.js +42 -0
  340. package/lib-esm/__tests__/CircleBadge.d.ts +1 -0
  341. package/lib-esm/__tests__/CircleBadge.js +73 -0
  342. package/lib-esm/__tests__/CircleOcticon.d.ts +1 -0
  343. package/lib-esm/__tests__/CircleOcticon.js +61 -0
  344. package/lib-esm/__tests__/CounterLabel.d.ts +1 -0
  345. package/lib-esm/__tests__/CounterLabel.js +49 -0
  346. package/lib-esm/__tests__/Details.d.ts +1 -0
  347. package/lib-esm/__tests__/Details.js +109 -0
  348. package/lib-esm/__tests__/Dialog.d.ts +1 -0
  349. package/lib-esm/__tests__/Dialog.js +174 -0
  350. package/lib-esm/__tests__/Dropdown.d.ts +1 -0
  351. package/lib-esm/__tests__/Dropdown.js +59 -0
  352. package/lib-esm/__tests__/DropdownMenu.d.ts +1 -0
  353. package/lib-esm/__tests__/DropdownMenu.js +139 -0
  354. package/lib-esm/__tests__/FilterList.d.ts +1 -0
  355. package/lib-esm/__tests__/FilterList.js +28 -0
  356. package/lib-esm/__tests__/FilterListItem.d.ts +1 -0
  357. package/lib-esm/__tests__/FilterListItem.js +38 -0
  358. package/lib-esm/__tests__/FilteredSearch.d.ts +1 -0
  359. package/lib-esm/__tests__/FilteredSearch.js +28 -0
  360. package/lib-esm/__tests__/Flash.d.ts +1 -0
  361. package/lib-esm/__tests__/Flash.js +53 -0
  362. package/lib-esm/__tests__/Flex.d.ts +1 -0
  363. package/lib-esm/__tests__/Flex.js +66 -0
  364. package/lib-esm/__tests__/FormGroup.d.ts +1 -0
  365. package/lib-esm/__tests__/FormGroup.js +47 -0
  366. package/lib-esm/__tests__/Grid.d.ts +1 -0
  367. package/lib-esm/__tests__/Grid.js +96 -0
  368. package/lib-esm/__tests__/Header.d.ts +1 -0
  369. package/lib-esm/__tests__/Header.js +52 -0
  370. package/lib-esm/__tests__/Heading.d.ts +1 -0
  371. package/lib-esm/__tests__/Heading.js +101 -0
  372. package/lib-esm/__tests__/Label.d.ts +1 -0
  373. package/lib-esm/__tests__/Label.js +38 -0
  374. package/lib-esm/__tests__/LabelGroup.d.ts +1 -0
  375. package/lib-esm/__tests__/LabelGroup.js +28 -0
  376. package/lib-esm/__tests__/Link.d.ts +1 -0
  377. package/lib-esm/__tests__/Link.js +62 -0
  378. package/lib-esm/__tests__/Overlay.d.ts +1 -0
  379. package/lib-esm/__tests__/Overlay.js +123 -0
  380. package/lib-esm/__tests__/Pagehead.d.ts +1 -0
  381. package/lib-esm/__tests__/Pagehead.js +28 -0
  382. package/lib-esm/__tests__/Pagination/Pagination.d.ts +1 -0
  383. package/lib-esm/__tests__/Pagination/Pagination.js +37 -0
  384. package/lib-esm/__tests__/Pagination/PaginationModel.d.ts +1 -0
  385. package/lib-esm/__tests__/Pagination/PaginationModel.js +182 -0
  386. package/lib-esm/__tests__/PointerBox.d.ts +1 -0
  387. package/lib-esm/__tests__/PointerBox.js +38 -0
  388. package/lib-esm/__tests__/Popover.d.ts +1 -0
  389. package/lib-esm/__tests__/Popover.js +56 -0
  390. package/lib-esm/__tests__/Portal.d.ts +1 -0
  391. package/lib-esm/__tests__/Portal.js +104 -0
  392. package/lib-esm/__tests__/Position.d.ts +1 -0
  393. package/lib-esm/__tests__/Position.js +138 -0
  394. package/lib-esm/__tests__/ProgressBar.d.ts +1 -0
  395. package/lib-esm/__tests__/ProgressBar.js +60 -0
  396. package/lib-esm/__tests__/SelectMenu.d.ts +1 -0
  397. package/lib-esm/__tests__/SelectMenu.js +145 -0
  398. package/lib-esm/__tests__/SelectPanel.d.ts +1 -0
  399. package/lib-esm/__tests__/SelectPanel.js +67 -0
  400. package/lib-esm/__tests__/SideNav.d.ts +1 -0
  401. package/lib-esm/__tests__/SideNav.js +63 -0
  402. package/lib-esm/__tests__/Spinner.d.ts +1 -0
  403. package/lib-esm/__tests__/Spinner.js +45 -0
  404. package/lib-esm/__tests__/StateLabel.d.ts +1 -0
  405. package/lib-esm/__tests__/StateLabel.js +63 -0
  406. package/lib-esm/__tests__/StyledOcticon.d.ts +1 -0
  407. package/lib-esm/__tests__/StyledOcticon.js +31 -0
  408. package/lib-esm/__tests__/SubNav.d.ts +1 -0
  409. package/lib-esm/__tests__/SubNav.js +52 -0
  410. package/lib-esm/__tests__/SubNavLink.d.ts +1 -0
  411. package/lib-esm/__tests__/SubNavLink.js +41 -0
  412. package/lib-esm/__tests__/TabNav.d.ts +1 -0
  413. package/lib-esm/__tests__/TabNav.js +42 -0
  414. package/lib-esm/__tests__/Text.d.ts +1 -0
  415. package/lib-esm/__tests__/Text.js +95 -0
  416. package/lib-esm/__tests__/TextInput.d.ts +1 -0
  417. package/lib-esm/__tests__/TextInput.js +70 -0
  418. package/lib-esm/__tests__/ThemeProvider.d.ts +1 -0
  419. package/lib-esm/__tests__/ThemeProvider.js +408 -0
  420. package/lib-esm/__tests__/Timeline.d.ts +1 -0
  421. package/lib-esm/__tests__/Timeline.js +69 -0
  422. package/lib-esm/__tests__/Tooltip.d.ts +1 -0
  423. package/lib-esm/__tests__/Tooltip.js +61 -0
  424. package/lib-esm/__tests__/Truncate.d.ts +1 -0
  425. package/lib-esm/__tests__/Truncate.js +55 -0
  426. package/lib-esm/__tests__/UnderlineNav.d.ts +1 -0
  427. package/lib-esm/__tests__/UnderlineNav.js +62 -0
  428. package/lib-esm/__tests__/UnderlineNavLink.d.ts +1 -0
  429. package/lib-esm/__tests__/UnderlineNavLink.js +43 -0
  430. package/lib-esm/__tests__/behaviors/anchoredPosition.d.ts +1 -0
  431. package/lib-esm/__tests__/behaviors/anchoredPosition.js +388 -0
  432. package/lib-esm/__tests__/behaviors/focusTrap.d.ts +1 -0
  433. package/lib-esm/__tests__/behaviors/focusTrap.js +227 -0
  434. package/lib-esm/__tests__/behaviors/focusZone.d.ts +1 -0
  435. package/lib-esm/__tests__/behaviors/focusZone.js +487 -0
  436. package/lib-esm/__tests__/behaviors/iterateFocusableElements.d.ts +1 -0
  437. package/lib-esm/__tests__/behaviors/iterateFocusableElements.js +48 -0
  438. package/lib-esm/__tests__/filterObject.d.ts +1 -0
  439. package/lib-esm/__tests__/filterObject.js +27 -0
  440. package/lib-esm/__tests__/hooks/useAnchoredPosition.d.ts +1 -0
  441. package/lib-esm/__tests__/hooks/useAnchoredPosition.js +46 -0
  442. package/lib-esm/__tests__/hooks/useOnEscapePress.d.ts +1 -0
  443. package/lib-esm/__tests__/hooks/useOnEscapePress.js +23 -0
  444. package/lib-esm/__tests__/hooks/useOnOutsideClick.d.ts +1 -0
  445. package/lib-esm/__tests__/hooks/useOnOutsideClick.js +68 -0
  446. package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.d.ts +1 -0
  447. package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.js +52 -0
  448. package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.d.ts +1 -0
  449. package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.js +36 -0
  450. package/lib-esm/__tests__/theme.d.ts +1 -0
  451. package/lib-esm/__tests__/theme.js +33 -0
  452. package/lib-esm/__tests__/themeGet.d.ts +1 -0
  453. package/lib-esm/__tests__/themeGet.js +22 -0
  454. package/lib-esm/__tests__/useSafeTimeout.d.ts +1 -0
  455. package/lib-esm/__tests__/useSafeTimeout.js +39 -0
  456. package/lib-esm/stories/ActionList.stories.js +334 -0
  457. package/lib-esm/stories/ActionMenu.stories.js +293 -0
  458. package/lib-esm/stories/AnchoredOverlay.stories.js +101 -0
  459. package/lib-esm/stories/AvatarStack.stories.js +32 -0
  460. package/lib-esm/stories/Button.stories.js +78 -0
  461. package/lib-esm/stories/ConfirmationDialog.stories.js +86 -0
  462. package/lib-esm/stories/Dialog.stories.js +240 -0
  463. package/lib-esm/stories/DropdownMenu.stories.js +94 -0
  464. package/lib-esm/stories/Overlay.stories.js +154 -0
  465. package/lib-esm/stories/Portal.stories.js +68 -0
  466. package/lib-esm/stories/SelectPanel.stories.js +284 -0
  467. package/lib-esm/stories/ThemeProvider.stories.js +83 -0
  468. package/lib-esm/stories/useAnchoredPosition.stories.js +313 -0
  469. package/lib-esm/stories/useFocusTrap.stories.js +309 -0
  470. package/lib-esm/stories/useFocusZone.stories.js +554 -0
  471. package/migrating.md +250 -0
  472. package/now.json +17 -0
  473. package/package-lock.json +28661 -0
  474. package/package.json +2 -2
  475. package/rollup.config.js +36 -0
  476. package/script/build +19 -0
  477. package/script/setup +12 -0
  478. package/src/ActionList/Divider.tsx +25 -0
  479. package/src/ActionList/Group.tsx +45 -0
  480. package/src/ActionList/Header.tsx +74 -0
  481. package/src/ActionList/Item.tsx +460 -0
  482. package/src/ActionList/List.tsx +253 -0
  483. package/src/ActionList/index.ts +21 -0
  484. package/src/ActionMenu.tsx +106 -0
  485. package/src/AnchoredOverlay/AnchoredOverlay.tsx +180 -0
  486. package/src/AnchoredOverlay/index.ts +2 -0
  487. package/src/Avatar.tsx +46 -0
  488. package/src/AvatarPair.tsx +35 -0
  489. package/src/AvatarStack.tsx +161 -0
  490. package/src/BaseStyles.tsx +53 -0
  491. package/src/BorderBox.tsx +18 -0
  492. package/src/Box.tsx +54 -0
  493. package/src/BranchName.tsx +19 -0
  494. package/src/Breadcrumb.tsx +87 -0
  495. package/src/Button/Button.tsx +40 -0
  496. package/src/Button/ButtonBase.tsx +43 -0
  497. package/src/Button/ButtonClose.tsx +40 -0
  498. package/src/Button/ButtonDanger.tsx +43 -0
  499. package/src/Button/ButtonGroup.tsx +55 -0
  500. package/src/Button/ButtonInvisible.tsx +27 -0
  501. package/src/Button/ButtonOutline.tsx +43 -0
  502. package/src/Button/ButtonPrimary.tsx +41 -0
  503. package/src/Button/ButtonStyles.tsx +36 -0
  504. package/src/Button/ButtonTableList.tsx +58 -0
  505. package/src/Button/index.ts +16 -0
  506. package/src/Caret.tsx +133 -0
  507. package/src/CircleBadge.tsx +55 -0
  508. package/src/CircleOcticon.tsx +37 -0
  509. package/src/CounterLabel.tsx +52 -0
  510. package/src/Details.tsx +23 -0
  511. package/src/Dialog/ConfirmationDialog.tsx +184 -0
  512. package/src/Dialog/Dialog.tsx +419 -0
  513. package/src/Dialog.tsx +149 -0
  514. package/src/Dropdown.tsx +158 -0
  515. package/src/DropdownMenu/DropdownButton.tsx +15 -0
  516. package/src/DropdownMenu/DropdownMenu.tsx +115 -0
  517. package/src/DropdownMenu/index.ts +4 -0
  518. package/src/DropdownStyles.ts +128 -0
  519. package/src/FilterList.tsx +81 -0
  520. package/src/FilteredActionList/FilteredActionList.tsx +152 -0
  521. package/src/FilteredActionList/index.ts +2 -0
  522. package/src/FilteredSearch.tsx +28 -0
  523. package/src/Flash.tsx +77 -0
  524. package/src/Flex.tsx +15 -0
  525. package/src/FormGroup.tsx +27 -0
  526. package/src/Grid.tsx +15 -0
  527. package/src/Header.tsx +84 -0
  528. package/src/Heading.tsx +21 -0
  529. package/src/Label.tsx +75 -0
  530. package/src/LabelGroup.tsx +18 -0
  531. package/src/Link.tsx +46 -0
  532. package/src/Overlay.tsx +194 -0
  533. package/src/Pagehead.tsx +17 -0
  534. package/src/Pagination/Pagination.tsx +214 -0
  535. package/src/Pagination/index.ts +4 -0
  536. package/src/Pagination/model.tsx +187 -0
  537. package/src/PointerBox.tsx +31 -0
  538. package/src/Popover.tsx +236 -0
  539. package/src/Portal/Portal.tsx +96 -0
  540. package/src/Portal/index.ts +5 -0
  541. package/src/Position.tsx +63 -0
  542. package/src/ProgressBar.tsx +52 -0
  543. package/src/SelectMenu/SelectMenu.tsx +125 -0
  544. package/src/SelectMenu/SelectMenuContext.tsx +9 -0
  545. package/src/SelectMenu/SelectMenuDivider.tsx +25 -0
  546. package/src/SelectMenu/SelectMenuFilter.tsx +51 -0
  547. package/src/SelectMenu/SelectMenuFooter.tsx +28 -0
  548. package/src/SelectMenu/SelectMenuHeader.tsx +50 -0
  549. package/src/SelectMenu/SelectMenuItem.tsx +137 -0
  550. package/src/SelectMenu/SelectMenuList.tsx +42 -0
  551. package/src/SelectMenu/SelectMenuLoadingAnimation.tsx +24 -0
  552. package/src/SelectMenu/SelectMenuModal.tsx +121 -0
  553. package/src/SelectMenu/SelectMenuTab.tsx +88 -0
  554. package/src/SelectMenu/SelectMenuTabPanel.tsx +30 -0
  555. package/src/SelectMenu/SelectMenuTabs.tsx +44 -0
  556. package/src/SelectMenu/hooks/useKeyboardNav.js +90 -0
  557. package/src/SelectMenu/index.ts +15 -0
  558. package/src/SelectPanel/SelectPanel.tsx +173 -0
  559. package/src/SelectPanel/index.ts +2 -0
  560. package/src/SideNav.tsx +193 -0
  561. package/src/Spinner.tsx +59 -0
  562. package/src/StateLabel.tsx +110 -0
  563. package/src/StyledOcticon.tsx +24 -0
  564. package/src/SubNav.tsx +129 -0
  565. package/src/TabNav.tsx +77 -0
  566. package/src/Text.tsx +13 -0
  567. package/src/TextInput.tsx +183 -0
  568. package/src/ThemeProvider.tsx +176 -0
  569. package/src/Timeline.tsx +141 -0
  570. package/src/Tooltip.tsx +263 -0
  571. package/src/Truncate.tsx +36 -0
  572. package/src/UnderlineNav.tsx +110 -0
  573. package/src/__tests__/.eslintrc.json +11 -0
  574. package/src/__tests__/ActionList.tsx +49 -0
  575. package/src/__tests__/ActionMenu.tsx +138 -0
  576. package/src/__tests__/AnchoredOverlay.tsx +151 -0
  577. package/src/__tests__/Avatar.tsx +45 -0
  578. package/src/__tests__/AvatarStack.tsx +45 -0
  579. package/src/__tests__/BorderBox.tsx +44 -0
  580. package/src/__tests__/Box.tsx +43 -0
  581. package/src/__tests__/BranchName.tsx +27 -0
  582. package/src/__tests__/Breadcrumb.tsx +31 -0
  583. package/src/__tests__/BreadcrumbItem.tsx +32 -0
  584. package/src/__tests__/Button.tsx +129 -0
  585. package/src/__tests__/Caret.tsx +36 -0
  586. package/src/__tests__/CircleBadge.tsx +69 -0
  587. package/src/__tests__/CircleOcticon.tsx +52 -0
  588. package/src/__tests__/CounterLabel.tsx +51 -0
  589. package/src/__tests__/Details.tsx +116 -0
  590. package/src/__tests__/Dialog.tsx +157 -0
  591. package/src/__tests__/Dropdown.tsx +57 -0
  592. package/src/__tests__/DropdownMenu.tsx +138 -0
  593. package/src/__tests__/FilterList.tsx +27 -0
  594. package/src/__tests__/FilterListItem.tsx +32 -0
  595. package/src/__tests__/FilteredSearch.tsx +27 -0
  596. package/src/__tests__/Flash.tsx +46 -0
  597. package/src/__tests__/Flex.tsx +59 -0
  598. package/src/__tests__/FormGroup.tsx +39 -0
  599. package/src/__tests__/Grid.tsx +83 -0
  600. package/src/__tests__/Header.tsx +50 -0
  601. package/src/__tests__/Heading.tsx +92 -0
  602. package/src/__tests__/Label.tsx +35 -0
  603. package/src/__tests__/LabelGroup.tsx +31 -0
  604. package/src/__tests__/Link.tsx +48 -0
  605. package/src/__tests__/Overlay.tsx +103 -0
  606. package/src/__tests__/Pagehead.tsx +24 -0
  607. package/src/__tests__/Pagination/Pagination.tsx +31 -0
  608. package/src/__tests__/Pagination/PaginationModel.tsx +133 -0
  609. package/src/__tests__/Pagination/__snapshots__/Pagination.tsx.snap +184 -0
  610. package/src/__tests__/PointerBox.tsx +35 -0
  611. package/src/__tests__/Popover.tsx +69 -0
  612. package/src/__tests__/Portal.tsx +103 -0
  613. package/src/__tests__/Position.tsx +118 -0
  614. package/src/__tests__/ProgressBar.tsx +41 -0
  615. package/src/__tests__/SelectMenu.tsx +142 -0
  616. package/src/__tests__/SelectPanel.tsx +65 -0
  617. package/src/__tests__/SideNav.tsx +63 -0
  618. package/src/__tests__/Spinner.tsx +44 -0
  619. package/src/__tests__/StateLabel.tsx +50 -0
  620. package/src/__tests__/StyledOcticon.tsx +28 -0
  621. package/src/__tests__/SubNav.tsx +51 -0
  622. package/src/__tests__/SubNavLink.tsx +32 -0
  623. package/src/__tests__/TabNav.tsx +33 -0
  624. package/src/__tests__/Text.tsx +79 -0
  625. package/src/__tests__/TextInput.tsx +50 -0
  626. package/src/__tests__/ThemeProvider.tsx +441 -0
  627. package/src/__tests__/Timeline.tsx +59 -0
  628. package/src/__tests__/Tooltip.tsx +53 -0
  629. package/src/__tests__/Truncate.tsx +45 -0
  630. package/src/__tests__/UnderlineNav.tsx +59 -0
  631. package/src/__tests__/UnderlineNavLink.tsx +32 -0
  632. package/src/__tests__/__snapshots__/ActionList.tsx.snap +27 -0
  633. package/src/__tests__/__snapshots__/ActionMenu.tsx.snap +80 -0
  634. package/src/__tests__/__snapshots__/AnchoredOverlay.tsx.snap +332 -0
  635. package/src/__tests__/__snapshots__/Avatar.tsx.snap +19 -0
  636. package/src/__tests__/__snapshots__/AvatarStack.tsx.snap +377 -0
  637. package/src/__tests__/__snapshots__/BorderBox.tsx.snap +14 -0
  638. package/src/__tests__/__snapshots__/Box.tsx.snap +201 -0
  639. package/src/__tests__/__snapshots__/BranchName.tsx.snap +17 -0
  640. package/src/__tests__/__snapshots__/Breadcrumb.tsx.snap +29 -0
  641. package/src/__tests__/__snapshots__/BreadcrumbItem.tsx.snap +79 -0
  642. package/src/__tests__/__snapshots__/Button.tsx.snap +832 -0
  643. package/src/__tests__/__snapshots__/Caret.tsx.snap +373 -0
  644. package/src/__tests__/__snapshots__/CircleBadge.tsx.snap +141 -0
  645. package/src/__tests__/__snapshots__/CircleOcticon.tsx.snap +64 -0
  646. package/src/__tests__/__snapshots__/CounterLabel.tsx.snap +22 -0
  647. package/src/__tests__/__snapshots__/Details.tsx.snap +15 -0
  648. package/src/__tests__/__snapshots__/Dialog.tsx.snap +200 -0
  649. package/src/__tests__/__snapshots__/Dropdown.tsx.snap +249 -0
  650. package/src/__tests__/__snapshots__/DropdownMenu.tsx.snap +106 -0
  651. package/src/__tests__/__snapshots__/FilterList.tsx.snap +13 -0
  652. package/src/__tests__/__snapshots__/FilterListItem.tsx.snap +80 -0
  653. package/src/__tests__/__snapshots__/FilteredSearch.tsx.snap +32 -0
  654. package/src/__tests__/__snapshots__/Flash.tsx.snap +32 -0
  655. package/src/__tests__/__snapshots__/Flex.tsx.snap +130 -0
  656. package/src/__tests__/__snapshots__/FormGroup.tsx.snap +25 -0
  657. package/src/__tests__/__snapshots__/Grid.tsx.snap +178 -0
  658. package/src/__tests__/__snapshots__/Header.tsx.snap +79 -0
  659. package/src/__tests__/__snapshots__/Heading.tsx.snap +13 -0
  660. package/src/__tests__/__snapshots__/Label.tsx.snap +74 -0
  661. package/src/__tests__/__snapshots__/LabelGroup.tsx.snap +15 -0
  662. package/src/__tests__/__snapshots__/Link.tsx.snap +213 -0
  663. package/src/__tests__/__snapshots__/Pagehead.tsx.snap +15 -0
  664. package/src/__tests__/__snapshots__/PointerBox.tsx.snap +174 -0
  665. package/src/__tests__/__snapshots__/Popover.tsx.snap +4687 -0
  666. package/src/__tests__/__snapshots__/Position.tsx.snap +44 -0
  667. package/src/__tests__/__snapshots__/ProgressBar.tsx.snap +53 -0
  668. package/src/__tests__/__snapshots__/SelectMenu.tsx.snap +469 -0
  669. package/src/__tests__/__snapshots__/SelectPanel.tsx.snap +123 -0
  670. package/src/__tests__/__snapshots__/SideNav.tsx.snap +143 -0
  671. package/src/__tests__/__snapshots__/Spinner.tsx.snap +33 -0
  672. package/src/__tests__/__snapshots__/StateLabel.tsx.snap +409 -0
  673. package/src/__tests__/__snapshots__/StyledOcticon.tsx.snap +25 -0
  674. package/src/__tests__/__snapshots__/SubNav.tsx.snap +44 -0
  675. package/src/__tests__/__snapshots__/SubNavLink.tsx.snap +199 -0
  676. package/src/__tests__/__snapshots__/TabNav.tsx.snap +58 -0
  677. package/src/__tests__/__snapshots__/Text.tsx.snap +7 -0
  678. package/src/__tests__/__snapshots__/TextInput.tsx.snap +440 -0
  679. package/src/__tests__/__snapshots__/ThemeProvider.tsx.snap +15 -0
  680. package/src/__tests__/__snapshots__/Timeline.tsx.snap +159 -0
  681. package/src/__tests__/__snapshots__/Tooltip.tsx.snap +227 -0
  682. package/src/__tests__/__snapshots__/Truncate.tsx.snap +17 -0
  683. package/src/__tests__/__snapshots__/UnderlineNav.tsx.snap +59 -0
  684. package/src/__tests__/__snapshots__/UnderlineNavLink.tsx.snap +130 -0
  685. package/src/__tests__/behaviors/anchoredPosition.ts +295 -0
  686. package/src/__tests__/behaviors/focusTrap.tsx +236 -0
  687. package/src/__tests__/behaviors/focusZone.tsx +549 -0
  688. package/src/__tests__/behaviors/iterateFocusableElements.tsx +61 -0
  689. package/src/__tests__/filterObject.ts +54 -0
  690. package/src/__tests__/hooks/useAnchoredPosition.tsx +31 -0
  691. package/src/__tests__/hooks/useOnEscapePress.tsx +16 -0
  692. package/src/__tests__/hooks/useOnOutsideClick.tsx +48 -0
  693. package/src/__tests__/hooks/useOpenAndCloseFocus.tsx +48 -0
  694. package/src/__tests__/hooks/useProvidedStateOrCreate.tsx +39 -0
  695. package/src/__tests__/theme.ts +41 -0
  696. package/src/__tests__/themeGet.ts +15 -0
  697. package/src/__tests__/useSafeTimeout.tsx +36 -0
  698. package/src/behaviors/anchoredPosition.ts +442 -0
  699. package/src/behaviors/focusTrap.ts +184 -0
  700. package/src/behaviors/focusZone.ts +713 -0
  701. package/src/constants.ts +62 -0
  702. package/src/hooks/index.ts +11 -0
  703. package/src/hooks/useAnchoredPosition.ts +53 -0
  704. package/src/hooks/useCombinedRefs.ts +40 -0
  705. package/src/hooks/useDetails.tsx +54 -0
  706. package/src/hooks/useDialog.ts +121 -0
  707. package/src/hooks/useFocusTrap.ts +80 -0
  708. package/src/hooks/useFocusZone.ts +64 -0
  709. package/src/hooks/useOnEscapePress.ts +63 -0
  710. package/src/hooks/useOnOutsideClick.tsx +82 -0
  711. package/src/hooks/useOpenAndCloseFocus.ts +27 -0
  712. package/src/hooks/useOverlay.tsx +32 -0
  713. package/src/hooks/useProvidedRefOrCreate.ts +14 -0
  714. package/src/hooks/useProvidedStateOrCreate.ts +27 -0
  715. package/src/hooks/useRenderForcingRef.ts +22 -0
  716. package/src/hooks/useResizeObserver.ts +11 -0
  717. package/src/hooks/useSafeTimeout.ts +38 -0
  718. package/src/hooks/useScrollFlash.ts +21 -0
  719. package/src/index.ts +165 -0
  720. package/src/polyfills/eventListenerSignal.ts +66 -0
  721. package/src/stories/ActionList.stories.tsx +364 -0
  722. package/src/stories/ActionMenu.stories.tsx +322 -0
  723. package/src/stories/AnchoredOverlay.stories.tsx +117 -0
  724. package/src/stories/AvatarStack.stories.tsx +37 -0
  725. package/src/stories/Button.stories.tsx +88 -0
  726. package/src/stories/ConfirmationDialog.stories.tsx +105 -0
  727. package/src/stories/Dialog.stories.tsx +240 -0
  728. package/src/stories/DropdownMenu.stories.tsx +84 -0
  729. package/src/stories/Overlay.stories.tsx +186 -0
  730. package/src/stories/Portal.stories.tsx +109 -0
  731. package/src/stories/SelectPanel.stories.tsx +300 -0
  732. package/src/stories/ThemeProvider.stories.tsx +104 -0
  733. package/src/stories/useAnchoredPosition.stories.tsx +320 -0
  734. package/src/stories/useFocusTrap.stories.tsx +400 -0
  735. package/src/stories/useFocusZone.stories.tsx +663 -0
  736. package/src/sx.ts +9 -0
  737. package/src/theme-preval.js +136 -0
  738. package/src/theme.ts +3 -0
  739. package/src/utils/deprecate.tsx +73 -0
  740. package/src/utils/isNumeric.tsx +4 -0
  741. package/src/utils/iterateFocusableElements.ts +121 -0
  742. package/src/utils/ssr.tsx +1 -0
  743. package/src/utils/test-deprecations.tsx +19 -0
  744. package/src/utils/test-helpers.tsx +7 -0
  745. package/src/utils/test-matchers.tsx +109 -0
  746. package/src/utils/testing.tsx +243 -0
  747. package/src/utils/theme.js +64 -0
  748. package/src/utils/types.ts +90 -0
  749. package/src/utils/uniqueId.ts +6 -0
  750. package/src/utils/userAgent.ts +7 -0
  751. package/stats.html +3279 -0
  752. package/tsconfig.build.json +7 -0
  753. package/tsconfig.json +20 -0
@@ -0,0 +1,43 @@
1
+ import React from 'react';
2
+ import { UnderlineNav } from '..';
3
+ import { COMMON } from '../constants';
4
+ import { render, behavesAsComponent } from '../utils/testing';
5
+ import { render as HTMLRender, cleanup } from '@testing-library/react';
6
+ import { axe, toHaveNoViolations } from 'jest-axe';
7
+ import 'babel-polyfill';
8
+ expect.extend(toHaveNoViolations);
9
+ describe('UnderlineNav.Link', () => {
10
+ behavesAsComponent({
11
+ Component: UnderlineNav.Link,
12
+ systemPropArray: [COMMON]
13
+ });
14
+ it('renders an <a> by default', () => {
15
+ expect(render( /*#__PURE__*/React.createElement(UnderlineNav.Link, null)).type).toEqual('a');
16
+ });
17
+ it('should have no axe violations', async () => {
18
+ const {
19
+ container
20
+ } = HTMLRender( /*#__PURE__*/React.createElement(UnderlineNav.Link, {
21
+ href: "www.github.com"
22
+ }, "Go to GitHub"));
23
+ const results = await axe(container);
24
+ expect(results).toHaveNoViolations();
25
+ cleanup();
26
+ });
27
+ it('respects the "selected" prop', () => {
28
+ expect(render( /*#__PURE__*/React.createElement(UnderlineNav.Link, {
29
+ selected: true
30
+ }))).toMatchSnapshot();
31
+ });
32
+ it('adds activeClassName={SELECTED_CLASS} when it gets a "to" prop', () => {
33
+ const Link = ({
34
+ theme: _ignoredTheme,
35
+ ...props
36
+ }) => /*#__PURE__*/React.createElement("div", props);
37
+
38
+ expect(render( /*#__PURE__*/React.createElement(UnderlineNav.Link, {
39
+ as: Link,
40
+ to: "#"
41
+ }))).toMatchSnapshot();
42
+ });
43
+ });
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,388 @@
1
+ import { getAnchoredPosition } from '../../behaviors/anchoredPosition';
2
+ /*
3
+
4
+ Note: In each test below, we check the calculation from getAnchoredPosition against exact
5
+ values. For each `expect` call, there is an accompanying comment that distills the effective
6
+ calculation from the inputs, which may help debugging in the event of a test failure.
7
+
8
+ */
9
+ // The DOMRect constructor isn't available in JSDOM, so we improvise here.
10
+
11
+ function makeDOMRect(x, y, width, height) {
12
+ return {
13
+ x,
14
+ y,
15
+ width,
16
+ height,
17
+ top: y,
18
+ left: x,
19
+ right: x + width,
20
+ bottom: y + height,
21
+
22
+ toJSON() {
23
+ return this;
24
+ }
25
+
26
+ };
27
+ } // Since Jest/JSDOM doesn't support layout, we can stub out getBoundingClientRect if we know the
28
+ // correct dimensions. JSDOM will handle the rest of the DOM API used by getAnchoredPosition.
29
+
30
+
31
+ function createVirtualDOM(parentRect, anchorRect, floatingRect, parentBorders = {
32
+ top: 0,
33
+ right: 0,
34
+ bottom: 0,
35
+ left: 0
36
+ }) {
37
+ const parent = document.createElement('div');
38
+ parent.style.overflow = 'hidden';
39
+ parent.style.position = 'relative';
40
+ parent.style.borderTopWidth = `${parentBorders.top}px`;
41
+ parent.style.borderRightWidth = `${parentBorders.right}px`;
42
+ parent.style.borderBottomWidth = `${parentBorders.bottom}px`;
43
+ parent.style.borderLeftWidth = `${parentBorders.left}px`;
44
+ parent.id = 'parent'; // eslint-disable-next-line github/unescaped-html-literal
45
+
46
+ parent.innerHTML = '<div id="float"></div><div id="anchor"></div>';
47
+ const float = parent.querySelector('#float');
48
+ const anchor = parent.querySelector('#anchor');
49
+
50
+ anchor.getBoundingClientRect = () => anchorRect;
51
+
52
+ parent.getBoundingClientRect = () => parentRect;
53
+
54
+ float.getBoundingClientRect = () => floatingRect;
55
+
56
+ return {
57
+ float,
58
+ parent,
59
+ anchor
60
+ };
61
+ }
62
+
63
+ describe('getAnchoredPosition', () => {
64
+ it('returns the correct position in the default case with no overflow', () => {
65
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
66
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100); // eslint-disable-next-line github/unescaped-html-literal
67
+
68
+ document.body.innerHTML = '<div id="float"></div><div id="anchor"></div>';
69
+ const float = document.querySelector('#float');
70
+ const anchor = document.querySelector('#anchor');
71
+
72
+ float.getBoundingClientRect = () => floatingRect;
73
+
74
+ anchor.getBoundingClientRect = () => anchorRect;
75
+
76
+ document.body.getBoundingClientRect = () => makeDOMRect(0, 0, 1920, 0);
77
+
78
+ Object.defineProperty(window, 'innerHeight', {
79
+ get: () => 1080
80
+ });
81
+ const settings = {
82
+ anchorOffset: 4
83
+ };
84
+ const {
85
+ top,
86
+ left
87
+ } = getAnchoredPosition(float, anchor, settings);
88
+ expect(top).toEqual(254);
89
+ expect(left).toEqual(300);
90
+ });
91
+ it('returns the correct position in the default case with no overflow, inside a clipping parent', () => {
92
+ const parentRect = makeDOMRect(20, 20, 500, 500);
93
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
94
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
95
+ const {
96
+ float,
97
+ anchor
98
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
99
+ const settings = {
100
+ anchorOffset: 4
101
+ };
102
+ const {
103
+ top,
104
+ left
105
+ } = getAnchoredPosition(float, anchor, settings);
106
+ expect(top).toEqual(234);
107
+ expect(left).toEqual(280);
108
+ });
109
+ it('returns the correct position for different outside side settings with no overflow', () => {
110
+ const parentRect = makeDOMRect(20, 20, 500, 500);
111
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
112
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
113
+ const {
114
+ float,
115
+ anchor
116
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
117
+ const settings = {};
118
+ let top = 0;
119
+ let left = 0; // should be the same calculation as the default settings test above
120
+
121
+ settings.side = 'outside-bottom';
122
+ ({
123
+ top,
124
+ left
125
+ } = getAnchoredPosition(float, anchor, settings));
126
+ expect(top).toEqual(234); // anchorRect.top + anchorRect.height + (settings.anchorOffset ?? 4) - parentRect.top
127
+
128
+ expect(left).toEqual(280); // anchorRect.left - parentRect.left
129
+
130
+ settings.side = 'outside-left';
131
+ ({
132
+ top,
133
+ left
134
+ } = getAnchoredPosition(float, anchor, settings));
135
+ expect(top).toEqual(180); // anchorRect.top - parentRect.top
136
+
137
+ expect(left).toEqual(176); // anchorRect.left - floatingRect.width - (settings.anchorOffset ?? 4) - parentRect.left
138
+
139
+ settings.side = 'outside-right';
140
+ ({
141
+ top,
142
+ left
143
+ } = getAnchoredPosition(float, anchor, settings));
144
+ expect(top).toEqual(180); // anchorRect.top - parentRect.top
145
+
146
+ expect(left).toEqual(334); // anchorRect.left + anchorRect.width + (settings.anchorOffset ?? 4) - parentRect.left
147
+
148
+ settings.side = 'outside-top';
149
+ ({
150
+ top,
151
+ left
152
+ } = getAnchoredPosition(float, anchor, settings));
153
+ expect(top).toEqual(76); // anchorRect.top - floatingRect.height - (settings.anchorOffset ?? 4) - parentRect.top
154
+
155
+ expect(left).toEqual(280); // anchorRect.left - parentRect.left
156
+ });
157
+ it('returns the correct position for different inside side settings', () => {
158
+ const parentRect = makeDOMRect(20, 20, 500, 500);
159
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
160
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
161
+ const {
162
+ float,
163
+ anchor
164
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
165
+ const settings = {};
166
+ let top = 0;
167
+ let left = 0;
168
+ settings.side = 'inside-bottom';
169
+ ({
170
+ top,
171
+ left
172
+ } = getAnchoredPosition(float, anchor, settings)); // anchorRect.top + anchorRect.height - (settings.anchorOffset ?? 4) - floatingRect.height - parentRect.top
173
+
174
+ expect(top).toEqual(126); // anchorRect.left + (settings.alignmentOffset ?? 4) - parentRect.left
175
+
176
+ expect(left).toEqual(284);
177
+ settings.side = 'inside-left';
178
+ ({
179
+ top,
180
+ left
181
+ } = getAnchoredPosition(float, anchor, settings));
182
+ expect(top).toEqual(184); // anchorRect.top + (settings.alignmentOffset ?? 4) - parentRect.top
183
+
184
+ expect(left).toEqual(284); // anchorRect.left + (settings.anchorOffset ?? 4) - parentRect.left
185
+
186
+ settings.side = 'inside-right';
187
+ ({
188
+ top,
189
+ left
190
+ } = getAnchoredPosition(float, anchor, settings)); // anchorRect.top + (settings.alignmentOffset ?? 4) - parentRect.top
191
+
192
+ expect(top).toEqual(184); // anchorRect.left + anchorRect.width - (settings.anchorOffset ?? 4) - floatingRect.width - parentRect.left
193
+
194
+ expect(left).toEqual(226); // almost the same as inside-left, with the exception of offsets
195
+
196
+ settings.side = 'inside-top';
197
+ ({
198
+ top,
199
+ left
200
+ } = getAnchoredPosition(float, anchor, settings));
201
+ expect(top).toEqual(184); // anchorRect.top + (settings.anchorOffset ?? 4) - parentRect.top
202
+
203
+ expect(left).toEqual(284); // anchorRect.left + (settings.alignmentOffset ?? 4) - parentRect.left
204
+
205
+ settings.side = 'inside-center';
206
+ ({
207
+ top,
208
+ left
209
+ } = getAnchoredPosition(float, anchor, settings));
210
+ expect(top).toEqual(184); // anchorRect.top + (settings.alignmentOffset ?? 4) - parentRect.top
211
+
212
+ expect(left).toEqual(255); // anchorRect.left + anchorRect.width / 2 - floatingRect.width / 2 - parentRect.left
213
+ });
214
+ it('returns the correct position inside centering along both axes', () => {
215
+ const parentRect = makeDOMRect(20, 20, 500, 500);
216
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
217
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
218
+ const {
219
+ float,
220
+ anchor
221
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
222
+ const settings = {
223
+ side: 'inside-center',
224
+ align: 'center'
225
+ };
226
+ const {
227
+ top,
228
+ left
229
+ } = getAnchoredPosition(float, anchor, settings);
230
+ expect(top).toEqual(155); // anchorRect.top + anchorRect.height / 2 - floatingRect.height / 2 - parentRect.top
231
+
232
+ expect(left).toEqual(255); // anchorRect.left + anchorRect.width / 2 - floatingRect.width / 2 - parentRect.left
233
+ });
234
+ it('returns the correct position for different alignment settings with no overflow', () => {
235
+ const parentRect = makeDOMRect(20, 20, 500, 500);
236
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
237
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
238
+ const {
239
+ float,
240
+ anchor
241
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
242
+ const settings = {};
243
+ let top = 0;
244
+ let left = 0;
245
+ settings.align = 'start';
246
+ ({
247
+ top,
248
+ left
249
+ } = getAnchoredPosition(float, anchor, settings));
250
+ expect(top).toEqual(234); // anchorRect.top + anchorRect.height + (settings.anchorOffset ?? 4) - parentRect.top
251
+
252
+ expect(left).toEqual(280); // anchorRect.left + (settings.alignmentOffset ?? 0) - parentRect.left
253
+
254
+ settings.align = 'center';
255
+ ({
256
+ top,
257
+ left
258
+ } = getAnchoredPosition(float, anchor, settings)); // anchorRect.top + anchorRect.height + (settings.anchorOffset ?? 4) - parentRect.top
259
+
260
+ expect(top).toEqual(234); // anchorRect.left + anchorRect.width / 2 - floatingRect.width / 2 + (settings.anchorOffset ?? 0) - parentRect.left
261
+
262
+ expect(left).toEqual(255);
263
+ settings.align = 'end';
264
+ ({
265
+ top,
266
+ left
267
+ } = getAnchoredPosition(float, anchor, settings)); // anchorRect.top + anchorRect.height + (settings.anchorOffset ?? 4) - parentRect.top
268
+
269
+ expect(top).toEqual(234); // anchorRect.left + anchorRect.width - floatingRect.width - (settings.alignmentOffset ?? 0) - parentRect.left
270
+
271
+ expect(left).toEqual(230);
272
+ });
273
+ it('properly flips to the opposite side if the calculated position overflows along the same axis', () => {
274
+ const parentRect = makeDOMRect(20, 20, 500, 500);
275
+ const anchorRect = makeDOMRect(300, 400, 50, 50);
276
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
277
+ const {
278
+ float,
279
+ anchor
280
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
281
+ const settings = {};
282
+ const {
283
+ top,
284
+ left
285
+ } = getAnchoredPosition(float, anchor, settings);
286
+ expect(top).toEqual(276); // anchorRect.top - floatingRect.height - (settings.anchorOffset ?? 4) - parentRect.top
287
+
288
+ expect(left).toEqual(280); // anchorRect.left - parentRect.left
289
+ });
290
+ it('properly moves to an adjacent side if overflow happens along side edge and flipped edge', () => {
291
+ const parentRect = makeDOMRect(20, 20, 500, 200);
292
+ const anchorRect = makeDOMRect(300, 100, 50, 50);
293
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 100);
294
+ const {
295
+ float,
296
+ anchor
297
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
298
+ const settings = {};
299
+ const {
300
+ top,
301
+ left
302
+ } = getAnchoredPosition(float, anchor, settings);
303
+ expect(top).toEqual(80); // anchorRect.top - parentRect.top
304
+
305
+ expect(left).toEqual(334); // anchorRect.left + anchorRect.width + (settings.anchorOffset ?? 4) - parentRect.left
306
+ });
307
+ it('properly adjusts the position using an alignment offset if overflow happens along the alignment edge', () => {
308
+ const parentRect = makeDOMRect(20, 20, 500, 500);
309
+ const anchorRect = makeDOMRect(300, 200, 50, 50);
310
+ const floatingRect = makeDOMRect(NaN, NaN, 400, 100);
311
+ const {
312
+ float,
313
+ anchor
314
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
315
+ const settings = {};
316
+ const {
317
+ top,
318
+ left
319
+ } = getAnchoredPosition(float, anchor, settings);
320
+ expect(top).toEqual(234); // anchorRect.top + anchorRect.height + (settings.anchorOffset ?? 4) - parentRect.top
321
+
322
+ expect(left).toEqual(100); // parentRect.width - floatingRect.width
323
+ });
324
+ it('properly calculates the position that needs to be flipped and offset-adjusted', () => {
325
+ const parentRect = makeDOMRect(20, 20, 500, 500);
326
+ const anchorRect = makeDOMRect(300, 400, 50, 50);
327
+ const floatingRect = makeDOMRect(NaN, NaN, 400, 100);
328
+ const {
329
+ float,
330
+ anchor
331
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
332
+ const settings = {};
333
+ const {
334
+ top,
335
+ left
336
+ } = getAnchoredPosition(float, anchor, settings);
337
+ expect(top).toEqual(276); // anchorRect.top - floatingRect.height - (settings.anchorOffset ?? 4) - parentRect.top
338
+
339
+ expect(left).toEqual(100); // parentRect.width - floatingRect.width
340
+ });
341
+ it('properly calculates the outside position with many simultaneous settings interactions (stress test)', () => {
342
+ const parentRect = makeDOMRect(20, 20, 200, 500);
343
+ const anchorRect = makeDOMRect(95, 295, 100, 200);
344
+ const floatingRect = makeDOMRect(NaN, NaN, 175, 200);
345
+ const {
346
+ float,
347
+ anchor
348
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
349
+ const settings = {
350
+ side: 'outside-right',
351
+ align: 'center',
352
+ alignmentOffset: 10,
353
+ anchorOffset: -10
354
+ };
355
+ const {
356
+ top,
357
+ left
358
+ } = getAnchoredPosition(float, anchor, settings); // expect to try right, left, and bottom before ending on top
359
+
360
+ expect(top).toEqual(85); // anchorRect.top - floatingRect.height - (settings.anchorOffset ?? 4) - parentRect.top
361
+ // expect center alignment to run against edge, so ignored. Also causes alignment offset to be ignored.
362
+
363
+ expect(left).toEqual(25); // parentRect.width - floatingRect.width
364
+ });
365
+ it('properly calculates the inside position with many simultaneous settings interactions (stress test)', () => {
366
+ const parentRect = makeDOMRect(20, 20, 500, 500);
367
+ const anchorRect = makeDOMRect(100, 100, 300, 300);
368
+ const floatingRect = makeDOMRect(NaN, NaN, 100, 200);
369
+ const {
370
+ float,
371
+ anchor
372
+ } = createVirtualDOM(parentRect, anchorRect, floatingRect);
373
+ const settings = {
374
+ side: 'inside-right',
375
+ align: 'center',
376
+ alignmentOffset: 10,
377
+ anchorOffset: -10
378
+ };
379
+ const {
380
+ top,
381
+ left
382
+ } = getAnchoredPosition(float, anchor, settings); // anchorRect.top + anchorRect.height / 2 - floatingRect.height / 2 + (settings.alignmentOffset ?? 4) - parentRect.top
383
+
384
+ expect(top).toEqual(140); // anchorRect.left + anchorRect.width - floatingRect.width - (settings.anchorOffset ?? 4) - parentRect.left
385
+
386
+ expect(left).toEqual(290);
387
+ });
388
+ });
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,227 @@
1
+ import React from 'react';
2
+ import { fireEvent, render } from '@testing-library/react';
3
+ import { focusTrap } from '../../behaviors/focusTrap'; // Since we use strict `isTabbable` checks within focus trap, we need to mock these
4
+ // properties that Jest does not populate.
5
+
6
+ beforeAll(() => {
7
+ try {
8
+ Object.defineProperties(HTMLElement.prototype, {
9
+ offsetHeight: {
10
+ get: () => 42
11
+ },
12
+ offsetWidth: {
13
+ get: () => 42
14
+ },
15
+ getClientRects: {
16
+ get: () => () => [42]
17
+ }
18
+ });
19
+ } catch {// ignore
20
+ }
21
+ });
22
+ it('Should initially focus the container when activated', () => {
23
+ const {
24
+ container
25
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("button", {
26
+ tabIndex: 0
27
+ }, "Bad Apple"), /*#__PURE__*/React.createElement("div", {
28
+ id: "trapContainer"
29
+ }, /*#__PURE__*/React.createElement("button", {
30
+ tabIndex: 0
31
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
32
+ tabIndex: 0
33
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
34
+ tabIndex: 0
35
+ }, "Cantaloupe"))));
36
+ const trapContainer = container.querySelector('#trapContainer');
37
+ const controller = focusTrap(trapContainer);
38
+ expect(document.activeElement).toEqual(trapContainer);
39
+ controller.abort();
40
+ });
41
+ it('Should initially focus the initialFocus element when specified', () => {
42
+ const {
43
+ container
44
+ } = render( /*#__PURE__*/React.createElement("div", {
45
+ id: "trapContainer"
46
+ }, /*#__PURE__*/React.createElement("button", {
47
+ tabIndex: 0
48
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
49
+ tabIndex: 0
50
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
51
+ tabIndex: 0
52
+ }, "Cantaloupe")));
53
+ const trapContainer = container.querySelector('#trapContainer');
54
+ const secondButton = trapContainer.querySelectorAll('button')[1];
55
+ const controller = focusTrap(trapContainer, secondButton);
56
+ expect(document.activeElement).toEqual(secondButton);
57
+ controller.abort();
58
+ });
59
+ it('Should prevent focus from exiting the trap, returns focus to previously-focused element', async () => {
60
+ const {
61
+ container
62
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
63
+ id: "trapContainer"
64
+ }, /*#__PURE__*/React.createElement("button", {
65
+ tabIndex: 0
66
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
67
+ tabIndex: 0
68
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
69
+ tabIndex: 0
70
+ }, "Cantaloupe")), /*#__PURE__*/React.createElement("button", {
71
+ id: "durian",
72
+ tabIndex: 0
73
+ }, "Durian")));
74
+ const trapContainer = container.querySelector('#trapContainer');
75
+ const secondButton = trapContainer.querySelectorAll('button')[1];
76
+ const durianButton = container.querySelector('#durian');
77
+ const controller = focusTrap(trapContainer);
78
+ focus(durianButton);
79
+ expect(document.activeElement).toEqual(trapContainer);
80
+ focus(secondButton);
81
+ expect(document.activeElement).toEqual(secondButton);
82
+ focus(durianButton);
83
+ expect(document.activeElement).toEqual(secondButton);
84
+ controller.abort();
85
+ });
86
+ it('Should prevent focus from exiting the trap if there are no focusable children', async () => {
87
+ const {
88
+ container
89
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
90
+ id: "trapContainer"
91
+ }), /*#__PURE__*/React.createElement("button", {
92
+ id: "durian",
93
+ tabIndex: 0
94
+ }, "Durian")));
95
+ const trapContainer = container.querySelector('#trapContainer');
96
+ const durianButton = container.querySelector('#durian');
97
+ const controller = focusTrap(trapContainer);
98
+ focus(durianButton);
99
+ expect(document.activeElement === durianButton).toEqual(false);
100
+ controller.abort();
101
+ });
102
+ it('Should cycle focus from last element to first element and vice-versa', async () => {
103
+ const {
104
+ container
105
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
106
+ id: "trapContainer"
107
+ }, /*#__PURE__*/React.createElement("button", {
108
+ tabIndex: 0
109
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
110
+ tabIndex: 0
111
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
112
+ tabIndex: 0
113
+ }, "Cantaloupe")), /*#__PURE__*/React.createElement("button", {
114
+ id: "durian",
115
+ tabIndex: 0
116
+ }, "Durian")));
117
+ const trapContainer = container.querySelector('#trapContainer');
118
+ const firstButton = trapContainer.querySelector('button');
119
+ const lastButton = trapContainer.querySelectorAll('button')[2];
120
+ const controller = focusTrap(trapContainer);
121
+ lastButton.focus();
122
+ fireEvent(lastButton, new KeyboardEvent('keydown', {
123
+ bubbles: true,
124
+ key: 'Tab'
125
+ }));
126
+ expect(document.activeElement).toEqual(firstButton);
127
+ fireEvent(firstButton, new KeyboardEvent('keydown', {
128
+ bubbles: true,
129
+ key: 'Tab',
130
+ shiftKey: true
131
+ }));
132
+ expect(document.activeElement).toEqual(lastButton);
133
+ controller.abort();
134
+ });
135
+ it('Should should release the trap when the signal is aborted', async () => {
136
+ const {
137
+ container
138
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
139
+ id: "trapContainer"
140
+ }, /*#__PURE__*/React.createElement("button", {
141
+ tabIndex: 0
142
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
143
+ tabIndex: 0
144
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
145
+ tabIndex: 0
146
+ }, "Cantaloupe")), /*#__PURE__*/React.createElement("button", {
147
+ id: "durian",
148
+ tabIndex: 0
149
+ }, "Durian")));
150
+ const trapContainer = container.querySelector('#trapContainer');
151
+ const durianButton = container.querySelector('#durian');
152
+ const controller = focusTrap(trapContainer);
153
+ focus(durianButton);
154
+ expect(document.activeElement).toEqual(trapContainer);
155
+ controller.abort();
156
+ focus(durianButton);
157
+ expect(document.activeElement).toEqual(durianButton);
158
+ });
159
+ it('Should should release the trap when the container is removed from the DOM', async () => {
160
+ var _trapContainer$parent;
161
+
162
+ const {
163
+ container
164
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
165
+ id: "trapContainer"
166
+ }, /*#__PURE__*/React.createElement("button", {
167
+ tabIndex: 0
168
+ }, "Apple")), /*#__PURE__*/React.createElement("button", {
169
+ id: "durian",
170
+ tabIndex: 0
171
+ }, "Durian")));
172
+ const trapContainer = container.querySelector('#trapContainer');
173
+ const durianButton = container.querySelector('#durian');
174
+ const firstButton = trapContainer.querySelector('button');
175
+ focusTrap(trapContainer);
176
+ focus(durianButton);
177
+ expect(document.activeElement).toEqual(trapContainer); // empty trap and remove it from the DOM
178
+
179
+ trapContainer.removeChild(firstButton);
180
+ (_trapContainer$parent = trapContainer.parentElement) === null || _trapContainer$parent === void 0 ? void 0 : _trapContainer$parent.removeChild(trapContainer);
181
+ focus(durianButton);
182
+ expect(document.activeElement).toEqual(durianButton);
183
+ });
184
+ it('Should handle dynamic content', async () => {
185
+ const {
186
+ container
187
+ } = render( /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
188
+ id: "trapContainer"
189
+ }, /*#__PURE__*/React.createElement("button", {
190
+ tabIndex: 0
191
+ }, "Apple"), /*#__PURE__*/React.createElement("button", {
192
+ tabIndex: 0
193
+ }, "Banana"), /*#__PURE__*/React.createElement("button", {
194
+ tabIndex: 0
195
+ }, "Cantaloupe")), /*#__PURE__*/React.createElement("button", {
196
+ id: "durian",
197
+ tabIndex: 0
198
+ }, "Durian")));
199
+ const trapContainer = container.querySelector('#trapContainer');
200
+ const [firstButton, secondButton, thirdButton] = trapContainer.querySelectorAll('button');
201
+ const controller = focusTrap(trapContainer);
202
+ secondButton.focus();
203
+ trapContainer.removeChild(thirdButton);
204
+ fireEvent(secondButton, new KeyboardEvent('keydown', {
205
+ bubbles: true,
206
+ key: 'Tab'
207
+ }));
208
+ expect(document.activeElement).toEqual(firstButton);
209
+ fireEvent(firstButton, new KeyboardEvent('keydown', {
210
+ bubbles: true,
211
+ key: 'Tab',
212
+ shiftKey: true
213
+ }));
214
+ expect(document.activeElement).toEqual(secondButton);
215
+ controller.abort();
216
+ });
217
+ /**
218
+ * Helper to handle firing the focusin event, which jest/JSDOM does not do for us.
219
+ * @param element
220
+ */
221
+
222
+ function focus(element) {
223
+ element.focus();
224
+ fireEvent(element, new FocusEvent('focusin', {
225
+ bubbles: true
226
+ }));
227
+ }
@@ -0,0 +1 @@
1
+ export {};