@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,663 @@
1
+ import React, {useCallback, useRef, useState} from 'react'
2
+ import {Meta} from '@storybook/react'
3
+ import styled, {createGlobalStyle} from 'styled-components'
4
+
5
+ import {Box, BaseStyles, Button, Flash, theme, ThemeProvider} from '..'
6
+ import {Direction, FocusKeys} from '../behaviors/focusZone'
7
+ import {themeGet} from '@styled-system/theme-get'
8
+ import {useFocusZone} from '../hooks/useFocusZone'
9
+ import {useTheme} from '../ThemeProvider'
10
+ import {ButtonDanger, ButtonPrimary} from '../Button'
11
+
12
+ export default {
13
+ title: 'Hooks/useFocusZone',
14
+ decorators: [
15
+ Story => {
16
+ return (
17
+ <ThemeProvider theme={theme}>
18
+ <BaseStyles>
19
+ <Story />
20
+ </BaseStyles>
21
+ </ThemeProvider>
22
+ )
23
+ }
24
+ ]
25
+ } as Meta
26
+
27
+ // NOTE: the below styles are solely intended as a visual aid for
28
+ // this Storybook story, but they're not recommended for a real site!
29
+ const HelperGlobalStyling = createGlobalStyle`
30
+ *:focus {
31
+ outline: 2px solid ${themeGet('colors.border.info')} !important;
32
+ }
33
+ `
34
+
35
+ const MarginButton = styled(Button)`
36
+ margin: ${themeGet('space.1')};
37
+ `
38
+
39
+ export const BasicFocusZone = () => {
40
+ // Display each key press in the top-right corner of the page as a visual aid
41
+ const [lastKey, setLastKey] = useState('none')
42
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
43
+ setLastKey(event.key)
44
+ }, [])
45
+
46
+ const [fzEnabled, setFzEnabled] = useState(true)
47
+ const {containerRef} = useFocusZone({disabled: !fzEnabled}, [fzEnabled])
48
+
49
+ const ToggleButton = fzEnabled ? ButtonDanger : ButtonPrimary
50
+ const toggleFz = useCallback(() => {
51
+ setFzEnabled(!fzEnabled)
52
+ }, [fzEnabled])
53
+
54
+ return (
55
+ <>
56
+ <HelperGlobalStyling />
57
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
58
+ <Box position="absolute" right={5} top={2}>
59
+ Last key pressed: {lastKey}
60
+ </Box>
61
+ <ToggleButton mb={3} onClick={toggleFz}>
62
+ {fzEnabled ? 'Disable' : 'Enable'} Focus Zone
63
+ </ToggleButton>
64
+ <MarginButton>Apple</MarginButton>
65
+ <MarginButton>Banana</MarginButton>
66
+ <MarginButton>Cantaloupe</MarginButton>
67
+ <Box
68
+ borderColor="gray.5"
69
+ ref={containerRef as React.RefObject<HTMLDivElement>}
70
+ m={4}
71
+ p={4}
72
+ borderWidth="1px"
73
+ borderStyle="solid"
74
+ borderRadius={2}
75
+ >
76
+ <strong>Use Up Arrow, Down Arrow, Home, and End to move focus within this box.</strong>
77
+ <Box display="flex" flexDirection="column" alignItems="flex-start">
78
+ <MarginButton>Durian</MarginButton>
79
+ <MarginButton>Elderberry</MarginButton>
80
+ <MarginButton>Fig</MarginButton>
81
+ </Box>
82
+ </Box>
83
+ <MarginButton>Kiwi</MarginButton>
84
+ <MarginButton>Lemon</MarginButton>
85
+ <MarginButton>Mango</MarginButton>
86
+ </Box>
87
+ </>
88
+ )
89
+ }
90
+
91
+ export const FocusOutBehavior = () => {
92
+ // Display each key press in the top-right corner of the page as a visual aid
93
+ const [lastKey, setLastKey] = useState('none')
94
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
95
+ setLastKey(event.key)
96
+ }, [])
97
+
98
+ const {containerRef: containerRef1} = useFocusZone({
99
+ focusOutBehavior: 'stop',
100
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd
101
+ })
102
+ const {containerRef: containerRef2} = useFocusZone({
103
+ focusOutBehavior: 'wrap',
104
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd
105
+ })
106
+
107
+ return (
108
+ <>
109
+ <HelperGlobalStyling />
110
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
111
+ <Box position="absolute" right={5} top={2}>
112
+ Last key pressed: {lastKey}
113
+ </Box>
114
+ <MarginButton>Apple</MarginButton>
115
+ <MarginButton>Banana</MarginButton>
116
+ <MarginButton>Cantaloupe</MarginButton>
117
+ <Box
118
+ borderColor="gray.5"
119
+ ref={containerRef1 as React.RefObject<HTMLDivElement>}
120
+ m={4}
121
+ p={4}
122
+ borderWidth="1px"
123
+ borderStyle="solid"
124
+ borderRadius={2}
125
+ >
126
+ <strong>
127
+ Use Left Arrow, Right Arrow, Home, and End to move focus within this box. Focus stops at the ends.
128
+ </strong>
129
+
130
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
131
+ <MarginButton>Durian</MarginButton>
132
+ <MarginButton>Elderberry</MarginButton>
133
+ <MarginButton>Fig</MarginButton>
134
+ </Box>
135
+ </Box>
136
+ <Box
137
+ borderColor="gray.5"
138
+ ref={containerRef2 as React.RefObject<HTMLDivElement>}
139
+ m={4}
140
+ p={4}
141
+ borderWidth="1px"
142
+ borderStyle="solid"
143
+ borderRadius={2}
144
+ >
145
+ <strong>Use Left Arrow, Right Arrow, Home, and End to move focus within this box. Focus is circular.</strong>
146
+
147
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
148
+ <MarginButton>Grapefruit</MarginButton>
149
+ <MarginButton>Honeydew</MarginButton>
150
+ <MarginButton>Jackfruit</MarginButton>
151
+ </Box>
152
+ </Box>
153
+ <MarginButton>Kiwi</MarginButton>
154
+ <MarginButton>Lemon</MarginButton>
155
+ <MarginButton>Mango</MarginButton>
156
+ </Box>
157
+ </>
158
+ )
159
+ }
160
+
161
+ function getSiblingIndex(element: Element) {
162
+ let child: Element | null = element
163
+ let i = 0
164
+ while ((child = child.previousElementSibling) != null) {
165
+ ++i
166
+ }
167
+ return i
168
+ }
169
+
170
+ export const CustomFocusMovement = () => {
171
+ // Display each key press in the top-right corner of the page as a visual aid
172
+ const [lastKey, setLastKey] = useState('none')
173
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
174
+ setLastKey(event.key)
175
+ }, [])
176
+
177
+ const containerRef = useRef<HTMLElement>(null)
178
+
179
+ const getNextFocusable = useCallback(
180
+ (direction: Direction, from: Element | undefined, event: KeyboardEvent): HTMLElement | undefined => {
181
+ const toEnd = direction === 'start' || direction === 'end'
182
+ if (from && containerRef.current) {
183
+ const currentIndex = getSiblingIndex(from)
184
+ let nextIndex = currentIndex
185
+ if (['End', 'ArrowRight'].includes(event.key)) {
186
+ while (nextIndex % 3 !== 2) {
187
+ nextIndex += 1
188
+ if (!toEnd) {
189
+ break
190
+ }
191
+ }
192
+ }
193
+ if (['Home', 'ArrowLeft'].includes(event.key)) {
194
+ while (nextIndex % 3 !== 0) {
195
+ nextIndex -= 1
196
+ if (!toEnd) {
197
+ break
198
+ }
199
+ }
200
+ }
201
+ if (event.key === 'ArrowUp') {
202
+ while (nextIndex - 3 >= 0) {
203
+ nextIndex -= 3
204
+ if (!toEnd) {
205
+ break
206
+ }
207
+ }
208
+ }
209
+ if (event.key === 'ArrowDown') {
210
+ while (nextIndex + 3 < 9) {
211
+ nextIndex += 3
212
+ if (!toEnd) {
213
+ break
214
+ }
215
+ }
216
+ }
217
+ return containerRef.current.children[nextIndex] as HTMLElement
218
+ }
219
+ },
220
+ [containerRef]
221
+ )
222
+
223
+ useFocusZone({containerRef, getNextFocusable})
224
+
225
+ return (
226
+ <>
227
+ <HelperGlobalStyling />
228
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
229
+ <Box position="absolute" right={5} top={2}>
230
+ Last key pressed: {lastKey}
231
+ </Box>
232
+ <MarginButton>Apple</MarginButton>
233
+
234
+ <Box borderColor="gray.5" m={4} p={4} borderWidth="1px" borderStyle="solid" borderRadius={2}>
235
+ <strong>Use arrow keys to move focus within this box.</strong>
236
+ <Box
237
+ display="grid"
238
+ ref={containerRef as React.RefObject<HTMLDivElement>}
239
+ gridTemplateRows="1fr 1fr 1fr"
240
+ gridTemplateColumns="1fr 1fr 1fr"
241
+ >
242
+ <MarginButton>Banana</MarginButton>
243
+ <MarginButton>Cantaloupe</MarginButton>
244
+ <MarginButton>Durian</MarginButton>
245
+ <MarginButton>Elderberry</MarginButton>
246
+ <MarginButton>Fig</MarginButton>
247
+ <MarginButton>Grapefruit</MarginButton>
248
+ <MarginButton>Honeydew</MarginButton>
249
+ <MarginButton>Jackfruit</MarginButton>
250
+ <MarginButton>Kiwi</MarginButton>
251
+ </Box>
252
+ </Box>
253
+ <MarginButton>Lemon</MarginButton>
254
+ <MarginButton>Mango</MarginButton>
255
+ </Box>
256
+ </>
257
+ )
258
+ }
259
+
260
+ export const FocusInStrategy = () => {
261
+ // Display each key press in the top-right corner of the page as a visual aid
262
+ const [lastKey, setLastKey] = useState('none')
263
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
264
+ setLastKey(event.key)
265
+ }, [])
266
+
267
+ const {containerRef: firstContainerRef} = useFocusZone({
268
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd,
269
+ focusInStrategy: 'first'
270
+ })
271
+
272
+ const {containerRef: closestContainerRef} = useFocusZone({
273
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd,
274
+ focusInStrategy: 'closest'
275
+ })
276
+
277
+ const {containerRef: prevContainerRef} = useFocusZone({
278
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd,
279
+ focusInStrategy: 'previous'
280
+ })
281
+
282
+ const customContainerRef = useRef<HTMLElement>(null)
283
+ const customStrategy = React.useCallback(() => {
284
+ if (customContainerRef.current) {
285
+ const buttons = Array.from(customContainerRef.current.querySelectorAll('button'))
286
+ return buttons[Math.floor(Math.random() * 3)]
287
+ }
288
+ }, [customContainerRef])
289
+
290
+ useFocusZone({
291
+ containerRef: customContainerRef,
292
+ bindKeys: FocusKeys.ArrowHorizontal | FocusKeys.HomeAndEnd,
293
+ focusInStrategy: customStrategy
294
+ })
295
+
296
+ return (
297
+ <>
298
+ <HelperGlobalStyling />
299
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
300
+ <Box position="absolute" right={5} top={2}>
301
+ Last key pressed: {lastKey}
302
+ </Box>
303
+ <MarginButton>Apple</MarginButton>
304
+ <MarginButton>Banana</MarginButton>
305
+ <MarginButton>Cantaloupe</MarginButton>
306
+ <Box
307
+ borderColor="gray.5"
308
+ ref={firstContainerRef as React.RefObject<HTMLDivElement>}
309
+ m={4}
310
+ p={4}
311
+ borderWidth="1px"
312
+ borderStyle="solid"
313
+ borderRadius={2}
314
+ >
315
+ <strong>&ldquo;First&rdquo; strategy (focus first focusable element)</strong>
316
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
317
+ <MarginButton>Banana</MarginButton>
318
+ <MarginButton>Cantaloupe</MarginButton>
319
+ <MarginButton>Durian</MarginButton>
320
+ </Box>
321
+ </Box>
322
+ <Box
323
+ borderColor="gray.5"
324
+ ref={closestContainerRef as React.RefObject<HTMLDivElement>}
325
+ m={4}
326
+ p={4}
327
+ borderWidth="1px"
328
+ borderStyle="solid"
329
+ borderRadius={2}
330
+ >
331
+ <strong>&ldquo;Closest&rdquo; strategy (focus first or last depending on focus direction)</strong>
332
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
333
+ <MarginButton>Elderberry</MarginButton>
334
+ <MarginButton>Fig</MarginButton>
335
+ <MarginButton>Grapefruit</MarginButton>
336
+ </Box>
337
+ </Box>
338
+ <Box
339
+ borderColor="gray.5"
340
+ ref={prevContainerRef as React.RefObject<HTMLDivElement>}
341
+ m={4}
342
+ p={4}
343
+ borderWidth="1px"
344
+ borderStyle="solid"
345
+ borderRadius={2}
346
+ >
347
+ <strong>&ldquo;Previous&rdquo; strategy (most recently focused element)</strong>
348
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
349
+ <MarginButton>Honeydew</MarginButton>
350
+ <MarginButton>Jackfruit</MarginButton>
351
+ <MarginButton>Kiwi</MarginButton>
352
+ </Box>
353
+ </Box>
354
+ <Box
355
+ borderColor="gray.5"
356
+ ref={customContainerRef as React.RefObject<HTMLDivElement>}
357
+ m={4}
358
+ p={4}
359
+ borderWidth="1px"
360
+ borderStyle="solid"
361
+ borderRadius={2}
362
+ >
363
+ <strong>&ldquo;Custom&rdquo; strategy (choose randomly for this example)</strong>
364
+ <Box display="flex" flexDirection="row" alignItems="flex-start">
365
+ <MarginButton>Lemon</MarginButton>
366
+ <MarginButton>Mango</MarginButton>
367
+ <MarginButton>Nectarine</MarginButton>
368
+ </Box>
369
+ </Box>
370
+ <MarginButton>Orange</MarginButton>
371
+ <MarginButton>Papaya</MarginButton>
372
+ </Box>
373
+ </>
374
+ )
375
+ }
376
+
377
+ export const SpecialSituations = () => {
378
+ // Display each key press in the top-right corner of the page as a visual aid
379
+ const [lastKey, setLastKey] = useState('none')
380
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
381
+ setLastKey(event.key)
382
+ }, [])
383
+
384
+ const {containerRef: vContainerRef} = useFocusZone({
385
+ bindKeys:
386
+ FocusKeys.ArrowVertical |
387
+ FocusKeys.JK |
388
+ FocusKeys.WS |
389
+ FocusKeys.Tab |
390
+ FocusKeys.PageUpDown |
391
+ FocusKeys.HomeAndEnd
392
+ })
393
+ const {containerRef: hContainerRef} = useFocusZone({focusOutBehavior: 'wrap', bindKeys: FocusKeys.ArrowHorizontal})
394
+
395
+ return (
396
+ <>
397
+ <HelperGlobalStyling />
398
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
399
+ <Flash mb={3}>
400
+ This story is very esoteric! It only exists to show some of the nuance of the arrow key focus behavior in
401
+ different situations. Focus treatment within your component should be evaluated for your particular UX using
402
+ the <a href="https://www.w3.org/TR/wai-aria-practices-1.1/#keyboard">ARIA guidelines</a>.
403
+ </Flash>
404
+ <Box position="absolute" right={5} top={2}>
405
+ Last key pressed: {lastKey}
406
+ </Box>
407
+ <MarginButton>Apple</MarginButton>
408
+ <MarginButton>Banana</MarginButton>
409
+ <MarginButton>Cantaloupe</MarginButton>
410
+ <Box
411
+ borderColor="gray.5"
412
+ ref={vContainerRef as React.RefObject<HTMLDivElement>}
413
+ m={4}
414
+ p={4}
415
+ borderWidth="1px"
416
+ borderStyle="solid"
417
+ borderRadius={2}
418
+ >
419
+ <strong>Bound keys: Up, Down, PageUp, PageDown, W, S, J, K, Home, End, Tab</strong>
420
+ <Box display="flex" flexDirection="column" alignItems="flex-start">
421
+ <input style={{width: '250px'}} type="text" defaultValue="Printable characters won't move focus" />
422
+ <MarginButton>Regular button</MarginButton>
423
+ <select>
424
+ <option>Down arrow invokes dropdown</option>
425
+ <option>Unless Cmd (mac)/Ctrl (Windows)</option>
426
+ <option>Is held</option>
427
+ </select>
428
+ <textarea
429
+ style={{width: '250px', height: '95px'}}
430
+ defaultValue="Up/Down only works when at beginning/end. PageUp and PageDown completely disabled. Printable characters will never move focus."
431
+ ></textarea>
432
+ </Box>
433
+ </Box>
434
+ <Box
435
+ borderColor="gray.5"
436
+ ref={hContainerRef as React.RefObject<HTMLDivElement>}
437
+ m={4}
438
+ p={4}
439
+ borderWidth="1px"
440
+ borderStyle="solid"
441
+ borderRadius={2}
442
+ >
443
+ <strong>Use Left Arrow and Right Arrow to move focus within this box. Focus is circular.</strong>
444
+
445
+ <Box display="flex" flexDirection="row" alignItems="center">
446
+ <MarginButton>Grapefruit</MarginButton>
447
+ <input
448
+ style={{width: '300px'}}
449
+ type="text"
450
+ defaultValue="Left/Right only work at beginning/end of input."
451
+ />
452
+ <MarginButton>Jackfruit</MarginButton>
453
+ </Box>
454
+ </Box>
455
+ <MarginButton>Kiwi</MarginButton>
456
+ <MarginButton>Lemon</MarginButton>
457
+ <MarginButton>Mango</MarginButton>
458
+ </Box>
459
+ </>
460
+ )
461
+ }
462
+
463
+ export const ChangingSubtree = () => {
464
+ // Display each key press in the top-right corner of the page as a visual aid
465
+ const [lastKey, setLastKey] = useState('none')
466
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
467
+ setLastKey(event.key)
468
+ }, [])
469
+
470
+ const {containerRef} = useFocusZone({bindKeys: FocusKeys.ArrowVertical})
471
+
472
+ const [buttonCount, setButtonCount] = useState(3)
473
+ const removeButton = useCallback(() => {
474
+ setButtonCount(buttonCount - 1)
475
+ }, [setButtonCount, buttonCount])
476
+
477
+ const addButton = useCallback(() => {
478
+ setButtonCount(buttonCount + 1)
479
+ }, [setButtonCount, buttonCount])
480
+
481
+ const buttons: JSX.Element[] = []
482
+ for (let i = 0; i < buttonCount; ++i) {
483
+ buttons.push(
484
+ <div>
485
+ <MarginButton key={`button${i}`}>{i + 1}</MarginButton>
486
+ </div>
487
+ )
488
+ }
489
+
490
+ return (
491
+ <>
492
+ <HelperGlobalStyling />
493
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
494
+ <Flash mb={3}>
495
+ This story demonstrates that focusZone is consistent even when the container&rsquo;s subtree changes.
496
+ </Flash>
497
+ <Box position="absolute" right={5} top={2}>
498
+ Last key pressed: {lastKey}
499
+ </Box>
500
+ <MarginButton>Apple</MarginButton>
501
+ <MarginButton>Banana</MarginButton>
502
+ <MarginButton>Cantaloupe</MarginButton>
503
+ <Box
504
+ borderColor="gray.5"
505
+ ref={containerRef as React.RefObject<HTMLDivElement>}
506
+ m={4}
507
+ p={4}
508
+ borderWidth="1px"
509
+ borderStyle="solid"
510
+ borderRadius={2}
511
+ >
512
+ <strong>Bound keys: Arrow Up and Arrow Down</strong>
513
+ <Box display="flex" flexDirection="column" alignItems="flex-start">
514
+ {buttons}
515
+ </Box>
516
+ </Box>
517
+ <Box display="flex" flexDirection="row">
518
+ <MarginButton onClick={removeButton}>Remove Button</MarginButton>
519
+ <MarginButton onClick={addButton}>Add Button</MarginButton>
520
+ </Box>
521
+ </Box>
522
+ </>
523
+ )
524
+ }
525
+
526
+ export const NestedZones = () => {
527
+ // Display each key press in the top-right corner of the page as a visual aid
528
+ const [lastKey, setLastKey] = useState('none')
529
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
530
+ setLastKey(event.key)
531
+ }, [])
532
+
533
+ const outerContainerRef = useRef<HTMLElement>(null)
534
+ const innerContainerRef = useRef<HTMLElement>(null)
535
+
536
+ useFocusZone({
537
+ containerRef: outerContainerRef,
538
+ bindKeys: FocusKeys.ArrowVertical
539
+ })
540
+
541
+ useFocusZone({
542
+ containerRef: innerContainerRef,
543
+ bindKeys: FocusKeys.ArrowHorizontal
544
+ })
545
+
546
+ return (
547
+ <>
548
+ <HelperGlobalStyling />
549
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
550
+ <Box position="absolute" right={5} top={2}>
551
+ Last key pressed: {lastKey}
552
+ </Box>
553
+ <MarginButton>Apple</MarginButton>
554
+ <MarginButton>Banana</MarginButton>
555
+ <Box
556
+ borderColor="gray.5"
557
+ m={4}
558
+ p={4}
559
+ ref={outerContainerRef as React.RefObject<HTMLDivElement>}
560
+ borderWidth="1px"
561
+ borderStyle="solid"
562
+ borderRadius={2}
563
+ >
564
+ <strong>Bound keys: Arrow Up and Arrow Down</strong>
565
+ <br />
566
+ <MarginButton>Cantaloupe</MarginButton>
567
+ <Box
568
+ borderColor="gray.5"
569
+ m={4}
570
+ p={4}
571
+ ref={innerContainerRef as React.RefObject<HTMLDivElement>}
572
+ borderWidth="1px"
573
+ borderStyle="solid"
574
+ borderRadius={2}
575
+ >
576
+ <strong>Additional Bound keys: Arrow Left and Arrow Right</strong>
577
+ <Box display="flex" id="list" flexDirection="column" alignItems="flex-start">
578
+ <MarginButton>Durian</MarginButton>
579
+ <MarginButton>Elderberry</MarginButton>
580
+ <MarginButton>Fig</MarginButton>
581
+ <MarginButton>Grapefruit</MarginButton>
582
+ </Box>
583
+ </Box>
584
+ <MarginButton>Honeydew</MarginButton>
585
+ </Box>
586
+ <MarginButton>Jackfruit</MarginButton>
587
+ <MarginButton>Kiwi</MarginButton>
588
+ </Box>
589
+ </>
590
+ )
591
+ }
592
+
593
+ export const ActiveDescendant = () => {
594
+ // Display each key press in the top-right corner of the page as a visual aid
595
+ const [lastKey, setLastKey] = useState('none')
596
+ const reportKey = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
597
+ setLastKey(event.key)
598
+ }, [])
599
+
600
+ const containerRef = useRef<HTMLElement>(null)
601
+ const controllingElementRef = useRef<HTMLElement>(null)
602
+ const {theme: themeFromContext} = useTheme()
603
+
604
+ useFocusZone({
605
+ containerRef,
606
+ activeDescendantFocus: controllingElementRef,
607
+ bindKeys: FocusKeys.ArrowVertical,
608
+ onActiveDescendantChanged: (current, previous) => {
609
+ if (current) {
610
+ current.style.outline = `2px solid ${themeFromContext?.colors.border.info}`
611
+ }
612
+ if (previous) {
613
+ previous.style.outline = ''
614
+ }
615
+ },
616
+ focusableElementFilter: elem => elem instanceof HTMLButtonElement
617
+ })
618
+
619
+ return (
620
+ <>
621
+ <HelperGlobalStyling />
622
+ <Box display="flex" flexDirection="column" alignItems="flex-start" onKeyDownCapture={reportKey}>
623
+ <Flash mb={3}>
624
+ This story demonstrates using the `aria-activedescendant` pattern for managing both a focused element and an
625
+ active element. Below, you can focus the input box then use the up/down arrow keys to change the active
626
+ descendant (dark blue outline).
627
+ </Flash>
628
+ <Box position="absolute" right={5} top={2}>
629
+ Last key pressed: {lastKey}
630
+ </Box>
631
+ <MarginButton>Apple</MarginButton>
632
+ <MarginButton>Banana</MarginButton>
633
+ <MarginButton>Cantaloupe</MarginButton>
634
+ <Box borderColor="gray.5" m={4} p={4} borderWidth="1px" borderStyle="solid" borderRadius={2}>
635
+ <strong>Bound keys: Arrow Up and Arrow Down</strong>
636
+ <Box display="flex" flexDirection="column" alignItems="flex-start">
637
+ <input
638
+ ref={controllingElementRef as React.RefObject<HTMLInputElement>}
639
+ type="text"
640
+ defaultValue="Focus remains here."
641
+ aria-controls="list"
642
+ />
643
+ <Box
644
+ display="flex"
645
+ id="list"
646
+ flexDirection="column"
647
+ alignItems="flex-start"
648
+ ref={containerRef as React.RefObject<HTMLDivElement>}
649
+ >
650
+ <MarginButton>Durian</MarginButton>
651
+ <MarginButton>Elderberry</MarginButton>
652
+ <MarginButton>Fig</MarginButton>
653
+ <MarginButton>Grapefruit</MarginButton>
654
+ </Box>
655
+ </Box>
656
+ </Box>
657
+ <MarginButton>Honeydew</MarginButton>
658
+ <MarginButton>Jackfruit</MarginButton>
659
+ <MarginButton>Kiwi</MarginButton>
660
+ </Box>
661
+ </>
662
+ )
663
+ }
package/src/sx.ts ADDED
@@ -0,0 +1,9 @@
1
+ import css, {SystemStyleObject} from '@styled-system/css'
2
+
3
+ export interface SxProp {
4
+ sx?: SystemStyleObject
5
+ }
6
+
7
+ const sx = (props: SxProp) => css(props.sx)
8
+
9
+ export default sx