@primer/react 0.0.0-20260427204434 → 0.0.0-20260428150519

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (344) hide show
  1. package/CHANGELOG.md +10 -6
  2. package/dist/ActionBar/ActionBar.js +502 -705
  3. package/dist/ActionBar/ActionBar.module.css.js +10 -5
  4. package/dist/ActionBar/index.js +8 -8
  5. package/dist/ActionList/ActionList.module.css.js +31 -5
  6. package/dist/ActionList/ActionListContainerContext.js +4 -5
  7. package/dist/ActionList/Description.js +117 -133
  8. package/dist/ActionList/Divider.js +31 -38
  9. package/dist/ActionList/Group.js +292 -349
  10. package/dist/ActionList/Group.module.css.js +10 -5
  11. package/dist/ActionList/Heading.js +88 -106
  12. package/dist/ActionList/Heading.module.css.js +5 -5
  13. package/dist/ActionList/Item.js +668 -811
  14. package/dist/ActionList/LinkItem.js +36 -56
  15. package/dist/ActionList/List.js +168 -210
  16. package/dist/ActionList/Selection.js +83 -112
  17. package/dist/ActionList/TrailingAction.js +97 -112
  18. package/dist/ActionList/Visuals.js +143 -191
  19. package/dist/ActionList/index.js +33 -33
  20. package/dist/ActionList/shared.js +5 -9
  21. package/dist/ActionMenu/ActionMenu.js +223 -310
  22. package/dist/ActionMenu/ActionMenu.module.css.js +5 -5
  23. package/dist/AnchoredOverlay/AnchoredOverlay.d.ts.map +1 -1
  24. package/dist/AnchoredOverlay/AnchoredOverlay.js +206 -298
  25. package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +9 -5
  26. package/dist/Autocomplete/Autocomplete.js +125 -141
  27. package/dist/Autocomplete/AutocompleteContext.js +18 -20
  28. package/dist/Autocomplete/AutocompleteInput.js +108 -146
  29. package/dist/Autocomplete/AutocompleteMenu.js +201 -238
  30. package/dist/Autocomplete/AutocompleteMenu.module.css.js +8 -5
  31. package/dist/Autocomplete/AutocompleteOverlay.js +54 -79
  32. package/dist/Autocomplete/AutocompleteOverlay.module.css.js +5 -5
  33. package/dist/Avatar/Avatar.js +106 -133
  34. package/dist/Avatar/Avatar.module.css.js +5 -5
  35. package/dist/AvatarStack/AvatarStack.js +102 -143
  36. package/dist/AvatarStack/AvatarStack.module.css.js +9 -5
  37. package/dist/Banner/Banner.js +133 -186
  38. package/dist/Banner/Banner.module.css.js +14 -5
  39. package/dist/Banner/index.js +7 -7
  40. package/dist/BaseStyles.js +74 -91
  41. package/dist/BaseStyles.module.css.js +5 -5
  42. package/dist/Blankslate/Blankslate.js +266 -328
  43. package/dist/Blankslate/Blankslate.module.css.js +12 -5
  44. package/dist/Blankslate/BlankslateContext.js +7 -9
  45. package/dist/Blankslate/index.js +9 -9
  46. package/dist/BranchName/BranchName.js +49 -59
  47. package/dist/BranchName/BranchName.module.css.js +5 -5
  48. package/dist/Breadcrumbs/Breadcrumbs.js +371 -431
  49. package/dist/Breadcrumbs/Breadcrumbs.module.css.js +15 -5
  50. package/dist/Button/Button.js +15 -18
  51. package/dist/Button/ButtonBase.js +76 -139
  52. package/dist/Button/ButtonBase.module.css.js +16 -5
  53. package/dist/Button/IconButton.js +42 -74
  54. package/dist/Button/LinkButton.js +13 -17
  55. package/dist/ButtonGroup/ButtonGroup.js +80 -97
  56. package/dist/ButtonGroup/ButtonGroup.module.css.js +5 -5
  57. package/dist/Card/Card.js +401 -491
  58. package/dist/Card/Card.module.css.js +18 -5
  59. package/dist/Card/index.js +9 -9
  60. package/dist/Checkbox/Checkbox.js +52 -71
  61. package/dist/Checkbox/Checkbox.module.css.js +9 -5
  62. package/dist/Checkbox/shared.module.css.js +5 -5
  63. package/dist/CheckboxGroup/CheckboxGroup.js +111 -132
  64. package/dist/CheckboxGroup/CheckboxGroupContext.js +4 -4
  65. package/dist/CircleBadge/CircleBadge.js +77 -90
  66. package/dist/CircleBadge/CircleBadge.module.css.js +8 -5
  67. package/dist/ConfirmationDialog/ConfirmationDialog.js +68 -92
  68. package/dist/CounterLabel/CounterLabel.js +83 -99
  69. package/dist/CounterLabel/CounterLabel.module.css.js +5 -5
  70. package/dist/DataTable/DataTable.js +100 -140
  71. package/dist/DataTable/ErrorDialog.js +33 -45
  72. package/dist/DataTable/Pagination.js +464 -592
  73. package/dist/DataTable/Pagination.module.css.js +13 -5
  74. package/dist/DataTable/Table.js +527 -710
  75. package/dist/DataTable/Table.module.css.js +26 -5
  76. package/dist/DataTable/column.js +10 -11
  77. package/dist/DataTable/index.js +22 -20
  78. package/dist/DataTable/sorting.js +65 -103
  79. package/dist/DataTable/useTable.js +207 -290
  80. package/dist/Details/Details.js +100 -126
  81. package/dist/Details/Details.module.css.js +5 -5
  82. package/dist/Dialog/Dialog.js +259 -351
  83. package/dist/Dialog/Dialog.module.css.js +22 -5
  84. package/dist/FeatureFlags/DefaultFeatureFlags.js +7 -7
  85. package/dist/FeatureFlags/FeatureFlagContext.js +5 -5
  86. package/dist/FeatureFlags/FeatureFlagScope.js +36 -44
  87. package/dist/FeatureFlags/FeatureFlags.js +29 -37
  88. package/dist/FeatureFlags/useFeatureFlag.js +17 -19
  89. package/dist/FilteredActionList/FilteredActionList.js +454 -579
  90. package/dist/FilteredActionList/FilteredActionList.module.css.js +15 -5
  91. package/dist/FilteredActionList/FilteredActionListLoaders.js +119 -150
  92. package/dist/FilteredActionList/FilteredActionListLoaders.module.css.js +9 -5
  93. package/dist/FilteredActionList/useAnnouncements.js +167 -180
  94. package/dist/Flash/Flash.js +57 -69
  95. package/dist/Flash/Flash.module.css.js +5 -5
  96. package/dist/FormControl/FormControl.js +211 -227
  97. package/dist/FormControl/FormControl.module.css.js +11 -5
  98. package/dist/FormControl/FormControlCaption.js +37 -49
  99. package/dist/FormControl/FormControlCaption.module.css.js +5 -5
  100. package/dist/FormControl/FormControlLabel.js +95 -115
  101. package/dist/FormControl/FormControlLeadingVisual.js +29 -37
  102. package/dist/FormControl/FormControlLeadingVisual.module.css.js +5 -5
  103. package/dist/FormControl/_FormControlContext.js +41 -48
  104. package/dist/FormControl/_FormControlValidation.js +29 -39
  105. package/dist/Header/Header.js +138 -165
  106. package/dist/Header/Header.module.css.js +9 -5
  107. package/dist/Heading/Heading.js +26 -37
  108. package/dist/Heading/Heading.module.css.js +5 -5
  109. package/dist/Hidden/Hidden.js +54 -77
  110. package/dist/Hidden/Hidden.module.css.js +5 -5
  111. package/dist/InlineMessage/InlineMessage.js +88 -116
  112. package/dist/InlineMessage/InlineMessage.module.css.js +8 -5
  113. package/dist/KeybindingHint/KeybindingHint.js +70 -88
  114. package/dist/KeybindingHint/KeybindingHint.module.css.js +5 -5
  115. package/dist/KeybindingHint/components/Chord.js +81 -93
  116. package/dist/KeybindingHint/components/Chord.module.css.js +11 -5
  117. package/dist/KeybindingHint/components/Key.js +49 -66
  118. package/dist/KeybindingHint/components/Sequence.js +12 -24
  119. package/dist/KeybindingHint/key-names.js +99 -114
  120. package/dist/Label/Label.js +56 -66
  121. package/dist/Label/Label.module.css.js +5 -5
  122. package/dist/Label/index.js +5 -5
  123. package/dist/LabelGroup/LabelGroup.js +260 -344
  124. package/dist/LabelGroup/LabelGroup.module.css.js +12 -5
  125. package/dist/Link/Link.js +31 -47
  126. package/dist/Link/Link.module.css.js +5 -5
  127. package/dist/NavList/NavList.js +424 -614
  128. package/dist/NavList/NavList.module.css.js +5 -5
  129. package/dist/Octicon/Octicon.js +35 -37
  130. package/dist/Overlay/Overlay.js +264 -318
  131. package/dist/Overlay/Overlay.module.css.js +8 -5
  132. package/dist/PageHeader/PageHeader.js +579 -823
  133. package/dist/PageHeader/PageHeader.module.css.js +21 -5
  134. package/dist/PageLayout/PageLayout.js +631 -913
  135. package/dist/PageLayout/PageLayout.module.css.js +31 -5
  136. package/dist/PageLayout/paneUtils.js +15 -29
  137. package/dist/PageLayout/usePaneWidth.js +334 -437
  138. package/dist/Pagehead/Pagehead.js +10 -14
  139. package/dist/Pagehead/Pagehead.module.css.js +5 -5
  140. package/dist/Pagination/Pagination.js +84 -114
  141. package/dist/Pagination/Pagination.module.css.js +9 -5
  142. package/dist/Pagination/index.js +5 -5
  143. package/dist/Pagination/model.js +118 -194
  144. package/dist/Popover/Popover.js +126 -151
  145. package/dist/Popover/Popover.module.css.js +8 -5
  146. package/dist/Portal/Portal.js +65 -85
  147. package/dist/Portal/index.js +5 -6
  148. package/dist/ProgressBar/ProgressBar.js +210 -255
  149. package/dist/ProgressBar/ProgressBar.module.css.js +9 -5
  150. package/dist/ProgressBar/index.js +6 -8
  151. package/dist/Radio/Radio.js +97 -115
  152. package/dist/Radio/Radio.module.css.js +5 -5
  153. package/dist/RadioGroup/RadioGroup.js +99 -118
  154. package/dist/RelativeTime/RelativeTime.js +64 -76
  155. package/dist/ScrollableRegion/ScrollableRegion.js +67 -79
  156. package/dist/ScrollableRegion/ScrollableRegion.module.css.js +5 -5
  157. package/dist/SegmentedControl/SegmentedControl.js +238 -287
  158. package/dist/SegmentedControl/SegmentedControl.module.css.js +15 -5
  159. package/dist/SegmentedControl/SegmentedControlButton.js +156 -187
  160. package/dist/SegmentedControl/SegmentedControlIconButton.js +133 -161
  161. package/dist/Select/Select.js +185 -234
  162. package/dist/Select/Select.module.css.js +10 -5
  163. package/dist/SelectPanel/SelectPanel.js +620 -828
  164. package/dist/SelectPanel/SelectPanel.module.css.js +27 -5
  165. package/dist/SelectPanel/SelectPanelMessage.js +37 -39
  166. package/dist/SideNav.js +24 -47
  167. package/dist/SideNav.module.css.js +12 -5
  168. package/dist/Skeleton/SkeletonBox.js +94 -111
  169. package/dist/Skeleton/SkeletonBox.module.css.js +8 -5
  170. package/dist/SkeletonAvatar/SkeletonAvatar.js +95 -120
  171. package/dist/SkeletonAvatar/SkeletonAvatar.module.css.js +5 -5
  172. package/dist/SkeletonText/SkeletonText.js +114 -137
  173. package/dist/SkeletonText/SkeletonText.module.css.js +8 -5
  174. package/dist/Spinner/Spinner.js +183 -211
  175. package/dist/Spinner/Spinner.module.css.js +9 -5
  176. package/dist/SplitPageLayout/SplitPageLayout.js +215 -276
  177. package/dist/Stack/Stack.js +207 -255
  178. package/dist/Stack/Stack.module.css.js +8 -5
  179. package/dist/Stack/index.js +4 -6
  180. package/dist/StateLabel/StateLabel.js +110 -123
  181. package/dist/StateLabel/StateLabel.module.css.js +8 -5
  182. package/dist/SubNav/SubNav.js +159 -197
  183. package/dist/SubNav/SubNav.module.css.js +11 -5
  184. package/dist/TabNav/TabNav.js +167 -199
  185. package/dist/TabNav/TabNav.module.css.js +10 -5
  186. package/dist/Text/Text.js +56 -67
  187. package/dist/Text/Text.module.css.js +5 -5
  188. package/dist/TextInput/TextInput.js +195 -228
  189. package/dist/TextInput/TextInput.module.css.js +8 -5
  190. package/dist/TextInputWithTokens/TextInputWithTokens.js +567 -673
  191. package/dist/TextInputWithTokens/TextInputWithTokens.module.css.js +14 -5
  192. package/dist/Textarea/TextArea.module.css.js +9 -5
  193. package/dist/Textarea/Textarea.js +264 -294
  194. package/dist/ThemeProvider.js +199 -257
  195. package/dist/Timeline/Timeline.js +204 -247
  196. package/dist/Timeline/Timeline.module.css.js +12 -5
  197. package/dist/ToggleSwitch/ToggleSwitch.js +403 -471
  198. package/dist/ToggleSwitch/ToggleSwitch.module.css.js +16 -5
  199. package/dist/Token/IssueLabelToken.js +256 -297
  200. package/dist/Token/IssueLabelToken.module.css.js +8 -5
  201. package/dist/Token/Token.js +232 -280
  202. package/dist/Token/Token.module.css.js +9 -5
  203. package/dist/Token/TokenBase.js +99 -126
  204. package/dist/Token/TokenBase.module.css.js +5 -5
  205. package/dist/Token/_RemoveTokenButton.js +27 -48
  206. package/dist/Token/_RemoveTokenButton.module.css.js +5 -5
  207. package/dist/Token/_TokenTextContainer.js +54 -65
  208. package/dist/Token/_TokenTextContainer.module.css.js +5 -5
  209. package/dist/Tooltip/Tooltip.js +49 -56
  210. package/dist/Tooltip/Tooltip.module.css.js +20 -5
  211. package/dist/TooltipV2/Tooltip.js +222 -305
  212. package/dist/TooltipV2/Tooltip.module.css.js +11 -5
  213. package/dist/TopicTag/TopicTag.js +46 -55
  214. package/dist/TopicTag/TopicTag.module.css.js +5 -5
  215. package/dist/TopicTag/TopicTagGroup.js +40 -48
  216. package/dist/TopicTag/TopicTagGroup.module.css.js +5 -5
  217. package/dist/TopicTag/index.js +5 -7
  218. package/dist/TreeView/TreeView.js +1082 -1414
  219. package/dist/TreeView/TreeView.module.css.js +24 -5
  220. package/dist/TreeView/shared.js +10 -9
  221. package/dist/TreeView/useRovingTabIndex.js +129 -203
  222. package/dist/TreeView/useTreeItemCache.js +64 -79
  223. package/dist/TreeView/useTypeahead.js +90 -112
  224. package/dist/Truncate/Truncate.js +21 -33
  225. package/dist/Truncate/Truncate.module.css.js +5 -5
  226. package/dist/UnderlineNav/UnderlineNav.js +278 -375
  227. package/dist/UnderlineNav/UnderlineNav.module.css.js +8 -5
  228. package/dist/UnderlineNav/UnderlineNavContext.js +8 -8
  229. package/dist/UnderlineNav/UnderlineNavItem.js +56 -72
  230. package/dist/UnderlineNav/UnderlineNavItem.module.css.js +5 -5
  231. package/dist/UnderlineNav/index.js +5 -7
  232. package/dist/UnderlineNav/styles.js +11 -15
  233. package/dist/VisuallyHidden/VisuallyHidden.js +51 -49
  234. package/dist/VisuallyHidden/VisuallyHidden.module.css.js +5 -5
  235. package/dist/_VisuallyHidden.js +50 -62
  236. package/dist/_VisuallyHidden.module.css.js +5 -5
  237. package/dist/deprecated/ActionList/Divider.js +23 -23
  238. package/dist/deprecated/ActionList/Divider.module.css.js +5 -5
  239. package/dist/deprecated/ActionList/Group.js +43 -50
  240. package/dist/deprecated/ActionList/Header.js +69 -81
  241. package/dist/deprecated/ActionList/Header.module.css.js +5 -5
  242. package/dist/deprecated/ActionList/Item.js +308 -352
  243. package/dist/deprecated/ActionList/Item.module.css.js +18 -5
  244. package/dist/deprecated/ActionList/List.js +157 -196
  245. package/dist/deprecated/ActionList/List.module.css.js +5 -5
  246. package/dist/deprecated/ActionList/index.js +14 -14
  247. package/dist/deprecated/ActionMenu.js +159 -190
  248. package/dist/deprecated/DialogV1/Dialog.js +166 -200
  249. package/dist/deprecated/DialogV1/Dialog.module.css.js +11 -5
  250. package/dist/deprecated/FilteredSearch/FilteredSearch.js +43 -51
  251. package/dist/deprecated/FilteredSearch/FilteredSearch.module.css.js +5 -5
  252. package/dist/deprecated/UnderlineNav/UnderlineNav.js +132 -160
  253. package/dist/deprecated/UnderlineNav/UnderlineNav.module.css.js +14 -5
  254. package/dist/deprecated/index.js +20 -9
  255. package/dist/experimental/IssueLabel/IssueLabel.js +134 -158
  256. package/dist/experimental/IssueLabel/IssueLabel.module.css.js +5 -5
  257. package/dist/experimental/SelectPanel2/SelectPanel.js +419 -567
  258. package/dist/experimental/SelectPanel2/SelectPanel.module.css.js +32 -5
  259. package/dist/experimental/Tabs/Tabs.js +234 -297
  260. package/dist/experimental/UnderlinePanels/UnderlinePanels.js +165 -215
  261. package/dist/experimental/UnderlinePanels/UnderlinePanels.module.css.js +5 -5
  262. package/dist/experimental/index.js +44 -33
  263. package/dist/hooks/useAnchoredPosition.d.ts +0 -6
  264. package/dist/hooks/useAnchoredPosition.d.ts.map +1 -1
  265. package/dist/hooks/useAnchoredPosition.js +123 -130
  266. package/dist/hooks/useControllableState.js +34 -59
  267. package/dist/hooks/useDetails.js +84 -99
  268. package/dist/hooks/useDialog.js +140 -178
  269. package/dist/hooks/useFocusTrap.js +57 -71
  270. package/dist/hooks/useFocusZone.js +32 -38
  271. package/dist/hooks/useId.js +14 -16
  272. package/dist/hooks/useIsMacOS.js +21 -26
  273. package/dist/hooks/useMedia.js +54 -68
  274. package/dist/hooks/useMenuInitialFocus.js +65 -62
  275. package/dist/hooks/useMenuKeyboardNavigation.js +129 -126
  276. package/dist/hooks/useMergedRefs.js +63 -78
  277. package/dist/hooks/useMnemonics.js +77 -107
  278. package/dist/hooks/useOnEscapePress.js +45 -56
  279. package/dist/hooks/useOnOutsideClick.js +32 -63
  280. package/dist/hooks/useOpenAndCloseFocus.js +40 -43
  281. package/dist/hooks/useOverflow.js +32 -36
  282. package/dist/hooks/useOverlay.js +56 -75
  283. package/dist/hooks/useProvidedRefOrCreate.js +24 -24
  284. package/dist/hooks/useProvidedStateOrCreate.js +33 -39
  285. package/dist/hooks/useRefObjectAsForwardedRef.js +30 -32
  286. package/dist/hooks/useRenderForcingRef.js +42 -46
  287. package/dist/hooks/useResizeObserver.js +32 -43
  288. package/dist/hooks/useResponsiveValue.js +37 -57
  289. package/dist/hooks/useSafeTimeout.js +26 -29
  290. package/dist/hooks/useScrollFlash.js +16 -23
  291. package/dist/hooks/useSlots.js +102 -136
  292. package/dist/hooks/useSyncedState.js +31 -37
  293. package/dist/index.js +88 -85
  294. package/dist/internal/components/ButtonReset.js +45 -50
  295. package/dist/internal/components/ButtonReset.module.css.js +5 -5
  296. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +79 -105
  297. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.module.css.js +12 -5
  298. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupCaption.js +16 -21
  299. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupContext.js +4 -4
  300. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupLabel.js +26 -35
  301. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupValidation.js +14 -19
  302. package/dist/internal/components/ConditionalWrapper.js +41 -51
  303. package/dist/internal/components/InputLabel.js +92 -113
  304. package/dist/internal/components/InputLabel.module.css.js +8 -5
  305. package/dist/internal/components/InputValidation.js +67 -87
  306. package/dist/internal/components/InputValidation.module.css.js +9 -5
  307. package/dist/internal/components/TextInputInnerAction.js +134 -173
  308. package/dist/internal/components/TextInputInnerAction.module.css.js +9 -5
  309. package/dist/internal/components/TextInputInnerVisualSlot.js +89 -110
  310. package/dist/internal/components/TextInputInnerVisualSlot.module.css.js +11 -5
  311. package/dist/internal/components/TextInputWrapper.js +187 -230
  312. package/dist/internal/components/TextInputWrapper.module.css.js +8 -5
  313. package/dist/internal/components/UnderlineTabbedInterface.js +191 -238
  314. package/dist/internal/components/UnderlineTabbedInterface.module.css.js +11 -5
  315. package/dist/internal/components/UnstyledTextInput.js +40 -47
  316. package/dist/internal/components/UnstyledTextInput.module.css.js +5 -5
  317. package/dist/internal/components/ValidationAnimationContainer.js +55 -66
  318. package/dist/internal/components/ValidationAnimationContainer.module.css.js +8 -5
  319. package/dist/internal/hooks/useEffectCallback.js +35 -38
  320. package/dist/internal/hooks/useEffectOnce.js +23 -25
  321. package/dist/internal/utils/getResponsiveAttributes.js +23 -26
  322. package/dist/internal/utils/hasInteractiveNodes.js +34 -46
  323. package/dist/legacy-theme/ts/color-schemes.js +4250 -4732
  324. package/dist/live-region/Announce.js +144 -183
  325. package/dist/live-region/AriaAlert.js +20 -22
  326. package/dist/live-region/AriaStatus.js +20 -22
  327. package/dist/next/index.js +3 -1
  328. package/dist/test-helpers.js +40 -62
  329. package/dist/theme.js +83 -47
  330. package/dist/utils/character-counter.js +45 -63
  331. package/dist/utils/create-component.js +15 -16
  332. package/dist/utils/descendant-registry.js +182 -218
  333. package/dist/utils/environment.js +7 -7
  334. package/dist/utils/getBreakpointDeclarations.js +9 -10
  335. package/dist/utils/invariant.js +17 -23
  336. package/dist/utils/is-slot.js +10 -11
  337. package/dist/utils/isNumeric.js +3 -3
  338. package/dist/utils/modern-polymorphic.js +12 -20
  339. package/dist/utils/scroll.js +8 -11
  340. package/dist/utils/theme.js +5 -10
  341. package/dist/utils/useIsomorphicLayoutEffect.js +4 -9
  342. package/dist/utils/warning.js +14 -21
  343. package/generated/components.json +9 -9
  344. package/package.json +5 -10
@@ -1,71 +1,57 @@
1
- import { c } from 'react-compiler-runtime';
2
- import React, { useContext, useEffect, createContext } from 'react';
3
- import 'react/jsx-runtime';
4
-
1
+ import { canUseDOM } from "../utils/environment.js";
2
+ import { warning } from "../utils/warning.js";
3
+ import { c } from "react-compiler-runtime";
4
+ import "react/jsx-runtime";
5
+ import React, { createContext, useContext, useEffect } from "react";
6
+ //#region src/hooks/useMedia.tsx
5
7
  function useMedia(mediaQueryString, defaultState) {
6
- const $ = c(8);
7
- const features = useContext(MatchMediaContext);
8
- let t0;
9
- if ($[0] !== defaultState || $[1] !== features || $[2] !== mediaQueryString) {
10
- t0 = () => {
11
- if (features[mediaQueryString] !== undefined) {
12
- return features[mediaQueryString];
13
- }
14
- {
15
- return defaultState;
16
- }
17
- };
18
- $[0] = defaultState;
19
- $[1] = features;
20
- $[2] = mediaQueryString;
21
- $[3] = t0;
22
- } else {
23
- t0 = $[3];
24
- }
25
- const [matches, setMatches] = React.useState(t0);
26
- if (features[mediaQueryString] !== undefined && matches !== features[mediaQueryString]) {
27
- setMatches(features[mediaQueryString]);
28
- }
29
- let t1;
30
- let t2;
31
- if ($[4] !== features || $[5] !== mediaQueryString) {
32
- t1 = () => {
33
- if (features[mediaQueryString] !== undefined) {
34
- return;
35
- }
36
- const listener = function listener(event) {
37
- setMatches(event.matches);
38
- };
39
- const mediaQueryList = window.matchMedia(mediaQueryString);
40
- if (mediaQueryList.addEventListener) {
41
- mediaQueryList.addEventListener("change", listener);
42
- } else {
43
- mediaQueryList.addListener(listener);
44
- }
45
- setMatches(mediaQueryList.matches);
46
- return () => {
47
- if (mediaQueryList.addEventListener) {
48
- mediaQueryList.removeEventListener("change", listener);
49
- } else {
50
- mediaQueryList.removeListener(listener);
51
- }
52
- };
53
- };
54
- t2 = [features, mediaQueryString];
55
- $[4] = features;
56
- $[5] = mediaQueryString;
57
- $[6] = t1;
58
- $[7] = t2;
59
- } else {
60
- t1 = $[6];
61
- t2 = $[7];
62
- }
63
- useEffect(t1, t2);
64
- return matches;
8
+ const $ = c(8);
9
+ const features = useContext(MatchMediaContext);
10
+ let t0;
11
+ if ($[0] !== defaultState || $[1] !== features || $[2] !== mediaQueryString) {
12
+ t0 = () => {
13
+ if (features[mediaQueryString] !== void 0) return features[mediaQueryString];
14
+ if (defaultState !== void 0) return defaultState;
15
+ if (canUseDOM) return window.matchMedia(mediaQueryString).matches;
16
+ warning(true, "`useMedia` When server side rendering, defaultState should be defined to prevent a hydration mismatches.");
17
+ return false;
18
+ };
19
+ $[0] = defaultState;
20
+ $[1] = features;
21
+ $[2] = mediaQueryString;
22
+ $[3] = t0;
23
+ } else t0 = $[3];
24
+ const [matches, setMatches] = React.useState(t0);
25
+ if (features[mediaQueryString] !== void 0 && matches !== features[mediaQueryString]) setMatches(features[mediaQueryString]);
26
+ let t1;
27
+ let t2;
28
+ if ($[4] !== features || $[5] !== mediaQueryString) {
29
+ t1 = () => {
30
+ if (features[mediaQueryString] !== void 0) return;
31
+ const listener = function listener(event) {
32
+ setMatches(event.matches);
33
+ };
34
+ const mediaQueryList = window.matchMedia(mediaQueryString);
35
+ if (mediaQueryList.addEventListener) mediaQueryList.addEventListener("change", listener);
36
+ else mediaQueryList.addListener(listener);
37
+ setMatches(mediaQueryList.matches);
38
+ return () => {
39
+ if (mediaQueryList.addEventListener) mediaQueryList.removeEventListener("change", listener);
40
+ else mediaQueryList.removeListener(listener);
41
+ };
42
+ };
43
+ t2 = [features, mediaQueryString];
44
+ $[4] = features;
45
+ $[5] = mediaQueryString;
46
+ $[6] = t1;
47
+ $[7] = t2;
48
+ } else {
49
+ t1 = $[6];
50
+ t2 = $[7];
51
+ }
52
+ useEffect(t1, t2);
53
+ return matches;
65
54
  }
66
- // Used to keep track of overrides to specific media query features, this should
67
- // be used for development and demo purposes to emulate specific features if
68
- // unavailable through devtools
69
- const MatchMediaContext = /*#__PURE__*/createContext({});
70
-
55
+ const MatchMediaContext = /* @__PURE__ */ createContext({});
56
+ //#endregion
71
57
  export { useMedia };
@@ -1,65 +1,68 @@
1
- import React from 'react';
2
- import { iterateFocusableElements } from '@primer/behaviors/utils';
3
-
1
+ import React from "react";
2
+ import { iterateFocusableElements } from "@primer/behaviors/utils";
3
+ //#region src/hooks/useMenuInitialFocus.ts
4
4
  const useMenuInitialFocus = (open, containerRef, anchorRef) => {
5
- /**
6
- * We need to pick the first element to focus based on how the menu was opened,
7
- * however, we need to wait for the menu to be open to set focus.
8
- * This is why we use set openingKey in state and have 2 effects
9
- */
10
- const [openingGesture, setOpeningGesture] = React.useState(undefined);
11
- React.useEffect(function inferOpeningKey() {
12
- const anchorElement = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
13
- const clickHandler = event => {
14
- // event.detail === 0 means onClick was fired by Enter/Space key
15
- // https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail
16
- if (event.detail !== 0) setOpeningGesture('mouse-click');
17
- };
18
- const keydownHandler = event => {
19
- if (['Space', 'Enter', 'ArrowDown', 'ArrowUp'].includes(event.code)) {
20
- setOpeningGesture(event.code);
21
- }
22
- };
23
- anchorElement === null || anchorElement === void 0 ? void 0 : anchorElement.addEventListener('click', clickHandler);
24
- anchorElement === null || anchorElement === void 0 ? void 0 : anchorElement.addEventListener('keydown', keydownHandler);
25
- return () => {
26
- anchorElement === null || anchorElement === void 0 ? void 0 : anchorElement.removeEventListener('click', clickHandler);
27
- anchorElement === null || anchorElement === void 0 ? void 0 : anchorElement.removeEventListener('keydown', keydownHandler);
28
- };
29
- }, [anchorRef]);
30
-
31
- /**
32
- * Pick the first element to focus based on the key used to open the Menu
33
- * Click: anchor
34
- * ArrowDown | Space | Enter: first element
35
- * ArrowUp: last element
36
- */
37
- React.useEffect(function moveFocusOnOpen() {
38
- if (!open || !(containerRef !== null && containerRef !== void 0 && containerRef.current)) return; // wait till the menu is open
39
-
40
- const iterable = iterateFocusableElements(containerRef.current);
41
- if (openingGesture === 'mouse-click') {
42
- if (anchorRef !== null && anchorRef !== void 0 && anchorRef.current) anchorRef.current.focus();else throw new Error('For focus management, please attach anchorRef');
43
- } else if (openingGesture && ['ArrowDown', 'Space', 'Enter'].includes(openingGesture)) {
44
- const firstElement = iterable.next().value;
45
- /** We push imperative focus to the next tick to prevent React's batching */
46
- setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
47
- } else if ('ArrowUp' === openingGesture) {
48
- const elements = [...iterable];
49
- const lastElement = elements[elements.length - 1];
50
- setTimeout(() => lastElement.focus());
51
- } else {
52
- /** if the menu was not opened with the anchor, we default to the first element
53
- * for example: with keyboard shortcut (see stories/fixtures)
54
- */
55
- const firstElement = iterable.next().value;
56
- setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
57
- }
58
- },
59
- // we don't want containerRef in dependencies
60
- // because re-renders to containerRef while it's open should not fire initialMenuFocus
61
- // eslint-disable-next-line react-hooks/exhaustive-deps
62
- [open, openingGesture, anchorRef]);
5
+ /**
6
+ * We need to pick the first element to focus based on how the menu was opened,
7
+ * however, we need to wait for the menu to be open to set focus.
8
+ * This is why we use set openingKey in state and have 2 effects
9
+ */
10
+ const [openingGesture, setOpeningGesture] = React.useState(void 0);
11
+ React.useEffect(function inferOpeningKey() {
12
+ const anchorElement = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
13
+ const clickHandler = (event) => {
14
+ if (event.detail !== 0) setOpeningGesture("mouse-click");
15
+ };
16
+ const keydownHandler = (event) => {
17
+ if ([
18
+ "Space",
19
+ "Enter",
20
+ "ArrowDown",
21
+ "ArrowUp"
22
+ ].includes(event.code)) setOpeningGesture(event.code);
23
+ };
24
+ anchorElement === null || anchorElement === void 0 || anchorElement.addEventListener("click", clickHandler);
25
+ anchorElement === null || anchorElement === void 0 || anchorElement.addEventListener("keydown", keydownHandler);
26
+ return () => {
27
+ anchorElement === null || anchorElement === void 0 || anchorElement.removeEventListener("click", clickHandler);
28
+ anchorElement === null || anchorElement === void 0 || anchorElement.removeEventListener("keydown", keydownHandler);
29
+ };
30
+ }, [anchorRef]);
31
+ /**
32
+ * Pick the first element to focus based on the key used to open the Menu
33
+ * Click: anchor
34
+ * ArrowDown | Space | Enter: first element
35
+ * ArrowUp: last element
36
+ */
37
+ React.useEffect(function moveFocusOnOpen() {
38
+ if (!open || !(containerRef !== null && containerRef !== void 0 && containerRef.current)) return;
39
+ const iterable = iterateFocusableElements(containerRef.current);
40
+ if (openingGesture === "mouse-click") if (anchorRef !== null && anchorRef !== void 0 && anchorRef.current) anchorRef.current.focus();
41
+ else throw new Error("For focus management, please attach anchorRef");
42
+ else if (openingGesture && [
43
+ "ArrowDown",
44
+ "Space",
45
+ "Enter"
46
+ ].includes(openingGesture)) {
47
+ const firstElement = iterable.next().value;
48
+ /** We push imperative focus to the next tick to prevent React's batching */
49
+ setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
50
+ } else if ("ArrowUp" === openingGesture) {
51
+ const elements = [...iterable];
52
+ const lastElement = elements[elements.length - 1];
53
+ setTimeout(() => lastElement.focus());
54
+ } else {
55
+ /** if the menu was not opened with the anchor, we default to the first element
56
+ * for example: with keyboard shortcut (see stories/fixtures)
57
+ */
58
+ const firstElement = iterable.next().value;
59
+ setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
60
+ }
61
+ }, [
62
+ open,
63
+ openingGesture,
64
+ anchorRef
65
+ ]);
63
66
  };
64
-
67
+ //#endregion
65
68
  export { useMenuInitialFocus };
@@ -1,139 +1,142 @@
1
- import { c } from 'react-compiler-runtime';
2
- import React from 'react';
3
- import { iterateFocusableElements } from '@primer/behaviors/utils';
4
- import { useMenuInitialFocus } from './useMenuInitialFocus.js';
5
- import { useMnemonics } from './useMnemonics.js';
6
-
1
+ import { useMenuInitialFocus } from "./useMenuInitialFocus.js";
2
+ import { useMnemonics } from "./useMnemonics.js";
3
+ import { c } from "react-compiler-runtime";
4
+ import React from "react";
5
+ import { iterateFocusableElements } from "@primer/behaviors/utils";
6
+ //#region src/hooks/useMenuKeyboardNavigation.ts
7
7
  /**
8
- * Keyboard navigation is a mix of 4 hooks
9
- * 1. useMenuInitialFocus
10
- * 2. useTypeaheadFocus
11
- * 3. useCloseMenuOnTab
12
- * 4. useMoveFocusToMenuItem
13
- */
8
+ * Keyboard navigation is a mix of 4 hooks
9
+ * 1. useMenuInitialFocus
10
+ * 2. useTypeaheadFocus
11
+ * 3. useCloseMenuOnTab
12
+ * 4. useMoveFocusToMenuItem
13
+ */
14
14
  const useMenuKeyboardNavigation = (open, onClose, containerRef, anchorRef, t0) => {
15
- const isSubmenu = t0 === undefined ? false : t0;
16
- useMenuInitialFocus(open, containerRef, anchorRef);
17
- useMnemonics(open, containerRef);
18
- useCloseMenuOnTab(open, onClose, containerRef, anchorRef);
19
- useMoveFocusToMenuItem(open, containerRef, anchorRef);
20
- useCloseSubmenuOnArrow(open, isSubmenu, onClose, containerRef);
15
+ const isSubmenu = t0 === void 0 ? false : t0;
16
+ useMenuInitialFocus(open, containerRef, anchorRef);
17
+ useMnemonics(open, containerRef);
18
+ useCloseMenuOnTab(open, onClose, containerRef, anchorRef);
19
+ useMoveFocusToMenuItem(open, containerRef, anchorRef);
20
+ useCloseSubmenuOnArrow(open, isSubmenu, onClose, containerRef);
21
21
  };
22
-
23
22
  /**
24
- * When Tab or Shift+Tab is pressed, the menu should close
25
- * and the focus should naturally move to the next item
26
- */
23
+ * When Tab or Shift+Tab is pressed, the menu should close
24
+ * and the focus should naturally move to the next item
25
+ */
27
26
  const useCloseMenuOnTab = (open, onClose, containerRef, anchorRef) => {
28
- const $ = c(6);
29
- let t0;
30
- let t1;
31
- if ($[0] !== anchorRef || $[1] !== containerRef || $[2] !== onClose || $[3] !== open) {
32
- t0 = () => {
33
- const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
34
- const anchor = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
35
- const handler = event => {
36
- if (open && event.key === "Tab") {
37
- onClose === null || onClose === void 0 ? void 0 : onClose("tab");
38
- }
39
- };
40
- container === null || container === void 0 ? void 0 : container.addEventListener("keydown", handler);
41
- anchor === null || anchor === void 0 ? void 0 : anchor.addEventListener("keydown", handler);
42
- return () => {
43
- container === null || container === void 0 ? void 0 : container.removeEventListener("keydown", handler);
44
- anchor === null || anchor === void 0 ? void 0 : anchor.removeEventListener("keydown", handler);
45
- };
46
- };
47
- t1 = [open, onClose, containerRef, anchorRef];
48
- $[0] = anchorRef;
49
- $[1] = containerRef;
50
- $[2] = onClose;
51
- $[3] = open;
52
- $[4] = t0;
53
- $[5] = t1;
54
- } else {
55
- t0 = $[4];
56
- t1 = $[5];
57
- }
58
- React.useEffect(t0, t1);
27
+ const $ = c(6);
28
+ let t0;
29
+ let t1;
30
+ if ($[0] !== anchorRef || $[1] !== containerRef || $[2] !== onClose || $[3] !== open) {
31
+ t0 = () => {
32
+ const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
33
+ const anchor = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
34
+ const handler = (event) => {
35
+ if (open && event.key === "Tab") onClose === null || onClose === void 0 || onClose("tab");
36
+ };
37
+ container === null || container === void 0 || container.addEventListener("keydown", handler);
38
+ anchor === null || anchor === void 0 || anchor.addEventListener("keydown", handler);
39
+ return () => {
40
+ container === null || container === void 0 || container.removeEventListener("keydown", handler);
41
+ anchor === null || anchor === void 0 || anchor.removeEventListener("keydown", handler);
42
+ };
43
+ };
44
+ t1 = [
45
+ open,
46
+ onClose,
47
+ containerRef,
48
+ anchorRef
49
+ ];
50
+ $[0] = anchorRef;
51
+ $[1] = containerRef;
52
+ $[2] = onClose;
53
+ $[3] = open;
54
+ $[4] = t0;
55
+ $[5] = t1;
56
+ } else {
57
+ t0 = $[4];
58
+ t1 = $[5];
59
+ }
60
+ React.useEffect(t0, t1);
59
61
  };
60
-
61
62
  /**
62
- * Close submenu when left arrow key is pressed
63
- */
63
+ * Close submenu when left arrow key is pressed
64
+ */
64
65
  const useCloseSubmenuOnArrow = (open, isSubmenu, onClose, containerRef) => {
65
- const $ = c(6);
66
- let t0;
67
- let t1;
68
- if ($[0] !== containerRef || $[1] !== isSubmenu || $[2] !== onClose || $[3] !== open) {
69
- t0 = () => {
70
- const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
71
- const handler = event => {
72
- if (open && isSubmenu && event.key === "ArrowLeft") {
73
- onClose === null || onClose === void 0 ? void 0 : onClose("arrow-left");
74
- }
75
- };
76
- container === null || container === void 0 ? void 0 : container.addEventListener("keydown", handler);
77
- return () => {
78
- container === null || container === void 0 ? void 0 : container.removeEventListener("keydown", handler);
79
- };
80
- };
81
- t1 = [open, onClose, containerRef, isSubmenu];
82
- $[0] = containerRef;
83
- $[1] = isSubmenu;
84
- $[2] = onClose;
85
- $[3] = open;
86
- $[4] = t0;
87
- $[5] = t1;
88
- } else {
89
- t0 = $[4];
90
- t1 = $[5];
91
- }
92
- React.useEffect(t0, t1);
66
+ const $ = c(6);
67
+ let t0;
68
+ let t1;
69
+ if ($[0] !== containerRef || $[1] !== isSubmenu || $[2] !== onClose || $[3] !== open) {
70
+ t0 = () => {
71
+ const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
72
+ const handler = (event) => {
73
+ if (open && isSubmenu && event.key === "ArrowLeft") onClose === null || onClose === void 0 || onClose("arrow-left");
74
+ };
75
+ container === null || container === void 0 || container.addEventListener("keydown", handler);
76
+ return () => {
77
+ container === null || container === void 0 || container.removeEventListener("keydown", handler);
78
+ };
79
+ };
80
+ t1 = [
81
+ open,
82
+ onClose,
83
+ containerRef,
84
+ isSubmenu
85
+ ];
86
+ $[0] = containerRef;
87
+ $[1] = isSubmenu;
88
+ $[2] = onClose;
89
+ $[3] = open;
90
+ $[4] = t0;
91
+ $[5] = t1;
92
+ } else {
93
+ t0 = $[4];
94
+ t1 = $[5];
95
+ }
96
+ React.useEffect(t0, t1);
93
97
  };
94
-
95
98
  /**
96
- * When Arrow Keys are pressed and the focus is on the anchor,
97
- * focus should move to a menu item
98
- */
99
+ * When Arrow Keys are pressed and the focus is on the anchor,
100
+ * focus should move to a menu item
101
+ */
99
102
  const useMoveFocusToMenuItem = (open, containerRef, anchorRef) => {
100
- const $ = c(5);
101
- let t0;
102
- let t1;
103
- if ($[0] !== anchorRef || $[1] !== containerRef || $[2] !== open) {
104
- t0 = () => {
105
- const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
106
- const anchor = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
107
- const handler = event => {
108
- if (!open || !container) {
109
- return;
110
- }
111
- const iterable = iterateFocusableElements(container);
112
- if (event.key === "ArrowDown") {
113
- const firstElement = iterable.next().value;
114
- setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
115
- } else {
116
- if (event.key === "ArrowUp") {
117
- const elements = [...iterable];
118
- const lastElement = elements[elements.length - 1];
119
- setTimeout(() => lastElement.focus());
120
- }
121
- }
122
- };
123
- anchor === null || anchor === void 0 ? void 0 : anchor.addEventListener("keydown", handler);
124
- return () => anchor === null || anchor === void 0 ? void 0 : anchor.addEventListener("keydown", handler);
125
- };
126
- t1 = [open, containerRef, anchorRef];
127
- $[0] = anchorRef;
128
- $[1] = containerRef;
129
- $[2] = open;
130
- $[3] = t0;
131
- $[4] = t1;
132
- } else {
133
- t0 = $[3];
134
- t1 = $[4];
135
- }
136
- React.useEffect(t0, t1);
103
+ const $ = c(5);
104
+ let t0;
105
+ let t1;
106
+ if ($[0] !== anchorRef || $[1] !== containerRef || $[2] !== open) {
107
+ t0 = () => {
108
+ const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
109
+ const anchor = anchorRef === null || anchorRef === void 0 ? void 0 : anchorRef.current;
110
+ const handler = (event) => {
111
+ if (!open || !container) return;
112
+ const iterable = iterateFocusableElements(container);
113
+ if (event.key === "ArrowDown") {
114
+ const firstElement = iterable.next().value;
115
+ setTimeout(() => firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus());
116
+ } else if (event.key === "ArrowUp") {
117
+ const elements = [...iterable];
118
+ const lastElement = elements[elements.length - 1];
119
+ setTimeout(() => lastElement.focus());
120
+ }
121
+ };
122
+ anchor === null || anchor === void 0 || anchor.addEventListener("keydown", handler);
123
+ return () => anchor === null || anchor === void 0 ? void 0 : anchor.addEventListener("keydown", handler);
124
+ };
125
+ t1 = [
126
+ open,
127
+ containerRef,
128
+ anchorRef
129
+ ];
130
+ $[0] = anchorRef;
131
+ $[1] = containerRef;
132
+ $[2] = open;
133
+ $[3] = t0;
134
+ $[4] = t1;
135
+ } else {
136
+ t0 = $[3];
137
+ t1 = $[4];
138
+ }
139
+ React.useEffect(t0, t1);
137
140
  };
138
-
141
+ //#endregion
139
142
  export { useMenuKeyboardNavigation };