@primer/react 0.0.0-20260428150519 → 0.0.0-20260428192448

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 (371) hide show
  1. package/CHANGELOG.md +15 -3
  2. package/dist/ActionBar/ActionBar-3f7b52a3.css +2 -0
  3. package/dist/ActionBar/ActionBar-3f7b52a3.css.map +1 -0
  4. package/dist/ActionBar/ActionBar.d.ts +1 -1
  5. package/dist/ActionBar/ActionBar.d.ts.map +1 -1
  6. package/dist/ActionBar/ActionBar.js +630 -514
  7. package/dist/ActionBar/ActionBar.module.css.js +5 -10
  8. package/dist/ActionBar/index.d.ts +1 -1
  9. package/dist/ActionBar/index.js +8 -8
  10. package/dist/ActionList/{ActionList-53389912.css → ActionList-09f5c4a8.css} +2 -2
  11. package/dist/ActionList/ActionList-09f5c4a8.css.map +1 -0
  12. package/dist/ActionList/ActionList.module.css.js +5 -31
  13. package/dist/ActionList/ActionListContainerContext.js +5 -4
  14. package/dist/ActionList/Description.js +133 -117
  15. package/dist/ActionList/Divider.js +38 -31
  16. package/dist/ActionList/Group.js +349 -292
  17. package/dist/ActionList/Group.module.css.js +5 -10
  18. package/dist/ActionList/Heading.js +106 -88
  19. package/dist/ActionList/Heading.module.css.js +5 -5
  20. package/dist/ActionList/Item.js +811 -668
  21. package/dist/ActionList/LinkItem.js +56 -36
  22. package/dist/ActionList/List.js +210 -168
  23. package/dist/ActionList/Selection.d.ts +2 -3
  24. package/dist/ActionList/Selection.d.ts.map +1 -1
  25. package/dist/ActionList/Selection.js +112 -83
  26. package/dist/ActionList/TrailingAction.js +112 -97
  27. package/dist/ActionList/Visuals.js +191 -143
  28. package/dist/ActionList/index.d.ts +7 -0
  29. package/dist/ActionList/index.d.ts.map +1 -1
  30. package/dist/ActionList/index.js +38 -33
  31. package/dist/ActionList/shared.js +9 -5
  32. package/dist/ActionMenu/ActionMenu.js +310 -223
  33. package/dist/ActionMenu/ActionMenu.module.css.js +5 -5
  34. package/dist/AnchoredOverlay/AnchoredOverlay.js +280 -206
  35. package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +5 -9
  36. package/dist/Autocomplete/Autocomplete.js +141 -125
  37. package/dist/Autocomplete/AutocompleteContext.js +20 -18
  38. package/dist/Autocomplete/AutocompleteInput.js +146 -108
  39. package/dist/Autocomplete/AutocompleteMenu.js +238 -201
  40. package/dist/Autocomplete/AutocompleteMenu.module.css.js +5 -8
  41. package/dist/Autocomplete/AutocompleteOverlay.js +79 -54
  42. package/dist/Autocomplete/AutocompleteOverlay.module.css.js +5 -5
  43. package/dist/Avatar/Avatar.js +133 -106
  44. package/dist/Avatar/Avatar.module.css.js +5 -5
  45. package/dist/AvatarStack/AvatarStack.js +143 -102
  46. package/dist/AvatarStack/AvatarStack.module.css.js +5 -9
  47. package/dist/Banner/Banner.js +186 -133
  48. package/dist/Banner/Banner.module.css.js +5 -14
  49. package/dist/Banner/index.js +7 -7
  50. package/dist/BaseStyles.js +91 -74
  51. package/dist/BaseStyles.module.css.js +5 -5
  52. package/dist/Blankslate/Blankslate.js +328 -266
  53. package/dist/Blankslate/Blankslate.module.css.js +5 -12
  54. package/dist/Blankslate/BlankslateContext.js +9 -7
  55. package/dist/Blankslate/index.js +9 -9
  56. package/dist/BranchName/BranchName.js +59 -49
  57. package/dist/BranchName/BranchName.module.css.js +5 -5
  58. package/dist/Breadcrumbs/Breadcrumbs.js +431 -371
  59. package/dist/Breadcrumbs/Breadcrumbs.module.css.js +5 -15
  60. package/dist/Button/Button.js +18 -15
  61. package/dist/Button/ButtonBase.js +139 -76
  62. package/dist/Button/ButtonBase.module.css.js +5 -16
  63. package/dist/Button/IconButton.js +74 -42
  64. package/dist/Button/LinkButton.js +17 -13
  65. package/dist/ButtonGroup/ButtonGroup.js +97 -80
  66. package/dist/ButtonGroup/ButtonGroup.module.css.js +5 -5
  67. package/dist/Card/Card.js +491 -401
  68. package/dist/Card/Card.module.css.js +5 -18
  69. package/dist/Card/index.js +9 -9
  70. package/dist/Checkbox/Checkbox.d.ts.map +1 -1
  71. package/dist/Checkbox/Checkbox.js +75 -52
  72. package/dist/Checkbox/Checkbox.module.css.js +5 -9
  73. package/dist/Checkbox/shared.module.css.js +5 -5
  74. package/dist/CheckboxGroup/CheckboxGroup.js +132 -111
  75. package/dist/CheckboxGroup/CheckboxGroupContext.js +4 -4
  76. package/dist/CircleBadge/CircleBadge.js +90 -77
  77. package/dist/CircleBadge/CircleBadge.module.css.js +5 -8
  78. package/dist/ConfirmationDialog/ConfirmationDialog.js +92 -68
  79. package/dist/CounterLabel/CounterLabel.js +99 -83
  80. package/dist/CounterLabel/CounterLabel.module.css.js +5 -5
  81. package/dist/DataTable/DataTable.js +140 -100
  82. package/dist/DataTable/ErrorDialog.js +45 -33
  83. package/dist/DataTable/Pagination.js +592 -464
  84. package/dist/DataTable/Pagination.module.css.js +5 -13
  85. package/dist/DataTable/Table.js +710 -527
  86. package/dist/DataTable/Table.module.css.js +5 -26
  87. package/dist/DataTable/column.js +11 -10
  88. package/dist/DataTable/index.js +20 -22
  89. package/dist/DataTable/sorting.js +103 -65
  90. package/dist/DataTable/useTable.js +290 -207
  91. package/dist/Details/Details.js +126 -100
  92. package/dist/Details/Details.module.css.js +5 -5
  93. package/dist/Dialog/Dialog.js +351 -259
  94. package/dist/Dialog/Dialog.module.css.js +5 -22
  95. package/dist/FeatureFlags/DefaultFeatureFlags.js +7 -7
  96. package/dist/FeatureFlags/FeatureFlagContext.js +5 -5
  97. package/dist/FeatureFlags/FeatureFlagScope.js +44 -36
  98. package/dist/FeatureFlags/FeatureFlags.js +37 -29
  99. package/dist/FeatureFlags/useFeatureFlag.js +19 -17
  100. package/dist/FilteredActionList/FilteredActionList.d.ts.map +1 -1
  101. package/dist/FilteredActionList/FilteredActionList.js +559 -454
  102. package/dist/FilteredActionList/FilteredActionList.module.css.js +5 -15
  103. package/dist/FilteredActionList/FilteredActionListInput.d.ts +15 -0
  104. package/dist/FilteredActionList/FilteredActionListInput.d.ts.map +1 -0
  105. package/dist/FilteredActionList/FilteredActionListInput.js +119 -0
  106. package/dist/FilteredActionList/FilteredActionListLoaders.js +150 -119
  107. package/dist/FilteredActionList/FilteredActionListLoaders.module.css.js +5 -9
  108. package/dist/FilteredActionList/index.d.ts +9 -1
  109. package/dist/FilteredActionList/index.d.ts.map +1 -1
  110. package/dist/FilteredActionList/index.js +11 -0
  111. package/dist/FilteredActionList/useAnnouncements.js +180 -167
  112. package/dist/Flash/Flash.js +69 -57
  113. package/dist/Flash/Flash.module.css.js +5 -5
  114. package/dist/FormControl/FormControl.js +227 -211
  115. package/dist/FormControl/FormControl.module.css.js +5 -11
  116. package/dist/FormControl/FormControlCaption.js +49 -37
  117. package/dist/FormControl/FormControlCaption.module.css.js +5 -5
  118. package/dist/FormControl/FormControlLabel.js +115 -95
  119. package/dist/FormControl/FormControlLeadingVisual.js +37 -29
  120. package/dist/FormControl/FormControlLeadingVisual.module.css.js +5 -5
  121. package/dist/FormControl/_FormControlContext.js +48 -41
  122. package/dist/FormControl/_FormControlValidation.js +39 -29
  123. package/dist/Header/Header.js +165 -138
  124. package/dist/Header/Header.module.css.js +5 -9
  125. package/dist/Heading/Heading.js +37 -26
  126. package/dist/Heading/Heading.module.css.js +5 -5
  127. package/dist/Hidden/Hidden.js +77 -54
  128. package/dist/Hidden/Hidden.module.css.js +5 -5
  129. package/dist/InlineMessage/InlineMessage.js +116 -88
  130. package/dist/InlineMessage/InlineMessage.module.css.js +5 -8
  131. package/dist/KeybindingHint/KeybindingHint.js +88 -70
  132. package/dist/KeybindingHint/KeybindingHint.module.css.js +5 -5
  133. package/dist/KeybindingHint/components/Chord.js +93 -81
  134. package/dist/KeybindingHint/components/Chord.module.css.js +5 -11
  135. package/dist/KeybindingHint/components/Key.js +66 -49
  136. package/dist/KeybindingHint/components/Sequence.js +24 -12
  137. package/dist/KeybindingHint/key-names.js +114 -99
  138. package/dist/Label/Label.js +66 -56
  139. package/dist/Label/Label.module.css.js +5 -5
  140. package/dist/Label/index.js +5 -5
  141. package/dist/LabelGroup/LabelGroup.js +344 -260
  142. package/dist/LabelGroup/LabelGroup.module.css.js +5 -12
  143. package/dist/Link/Link.js +47 -31
  144. package/dist/Link/Link.module.css.js +5 -5
  145. package/dist/NavList/NavList.js +614 -424
  146. package/dist/NavList/NavList.module.css.js +5 -5
  147. package/dist/Octicon/Octicon.js +37 -35
  148. package/dist/Overlay/Overlay.js +318 -264
  149. package/dist/Overlay/Overlay.module.css.js +5 -8
  150. package/dist/PageHeader/PageHeader.js +823 -579
  151. package/dist/PageHeader/PageHeader.module.css.js +5 -21
  152. package/dist/PageLayout/PageLayout.js +913 -631
  153. package/dist/PageLayout/PageLayout.module.css.js +5 -31
  154. package/dist/PageLayout/paneUtils.js +29 -15
  155. package/dist/PageLayout/usePaneWidth.js +437 -334
  156. package/dist/Pagehead/Pagehead.js +14 -10
  157. package/dist/Pagehead/Pagehead.module.css.js +5 -5
  158. package/dist/Pagination/Pagination.js +114 -84
  159. package/dist/Pagination/Pagination.module.css.js +5 -9
  160. package/dist/Pagination/index.js +5 -5
  161. package/dist/Pagination/model.js +194 -118
  162. package/dist/Popover/Popover.js +151 -126
  163. package/dist/Popover/Popover.module.css.js +5 -8
  164. package/dist/Portal/Portal.js +85 -65
  165. package/dist/Portal/index.js +6 -5
  166. package/dist/ProgressBar/ProgressBar.js +255 -210
  167. package/dist/ProgressBar/ProgressBar.module.css.js +5 -9
  168. package/dist/ProgressBar/index.js +8 -6
  169. package/dist/Radio/Radio.js +115 -97
  170. package/dist/Radio/Radio.module.css.js +5 -5
  171. package/dist/RadioGroup/RadioGroup.js +118 -99
  172. package/dist/RelativeTime/RelativeTime.js +76 -64
  173. package/dist/ScrollableRegion/ScrollableRegion.js +79 -67
  174. package/dist/ScrollableRegion/ScrollableRegion.module.css.js +5 -5
  175. package/dist/SegmentedControl/SegmentedControl.js +287 -238
  176. package/dist/SegmentedControl/SegmentedControl.module.css.js +5 -15
  177. package/dist/SegmentedControl/SegmentedControlButton.js +187 -156
  178. package/dist/SegmentedControl/SegmentedControlIconButton.js +161 -133
  179. package/dist/Select/Select.js +234 -185
  180. package/dist/Select/Select.module.css.js +5 -10
  181. package/dist/SelectPanel/SelectPanel.d.ts +1 -0
  182. package/dist/SelectPanel/SelectPanel.d.ts.map +1 -1
  183. package/dist/SelectPanel/SelectPanel.js +829 -620
  184. package/dist/SelectPanel/SelectPanel.module.css.js +5 -27
  185. package/dist/SelectPanel/SelectPanelMessage.js +39 -37
  186. package/dist/SelectPanel/index.d.ts +1 -0
  187. package/dist/SelectPanel/index.d.ts.map +1 -1
  188. package/dist/SideNav.js +47 -24
  189. package/dist/SideNav.module.css.js +5 -12
  190. package/dist/Skeleton/SkeletonBox.js +111 -94
  191. package/dist/Skeleton/SkeletonBox.module.css.js +5 -8
  192. package/dist/SkeletonAvatar/SkeletonAvatar.js +120 -95
  193. package/dist/SkeletonAvatar/SkeletonAvatar.module.css.js +5 -5
  194. package/dist/SkeletonText/SkeletonText.js +137 -114
  195. package/dist/SkeletonText/SkeletonText.module.css.js +5 -8
  196. package/dist/Spinner/Spinner.js +211 -183
  197. package/dist/Spinner/Spinner.module.css.js +5 -9
  198. package/dist/SplitPageLayout/SplitPageLayout.js +276 -215
  199. package/dist/Stack/Stack.js +255 -207
  200. package/dist/Stack/Stack.module.css.js +5 -8
  201. package/dist/Stack/index.js +6 -4
  202. package/dist/StateLabel/StateLabel.js +123 -110
  203. package/dist/StateLabel/StateLabel.module.css.js +5 -8
  204. package/dist/SubNav/SubNav.js +197 -159
  205. package/dist/SubNav/SubNav.module.css.js +5 -11
  206. package/dist/TabNav/TabNav.js +199 -167
  207. package/dist/TabNav/TabNav.module.css.js +5 -10
  208. package/dist/Text/Text.js +67 -56
  209. package/dist/Text/Text.module.css.js +5 -5
  210. package/dist/TextInput/TextInput.js +228 -195
  211. package/dist/TextInput/TextInput.module.css.js +5 -8
  212. package/dist/TextInputWithTokens/TextInputWithTokens.js +673 -567
  213. package/dist/TextInputWithTokens/TextInputWithTokens.module.css.js +5 -14
  214. package/dist/Textarea/TextArea.module.css.js +5 -9
  215. package/dist/Textarea/Textarea.js +294 -264
  216. package/dist/ThemeProvider.js +257 -199
  217. package/dist/Timeline/Timeline.js +247 -204
  218. package/dist/Timeline/Timeline.module.css.js +5 -12
  219. package/dist/ToggleSwitch/ToggleSwitch.js +471 -403
  220. package/dist/ToggleSwitch/ToggleSwitch.module.css.js +5 -16
  221. package/dist/Token/IssueLabelToken.js +297 -256
  222. package/dist/Token/IssueLabelToken.module.css.js +5 -8
  223. package/dist/Token/Token.js +280 -232
  224. package/dist/Token/Token.module.css.js +5 -9
  225. package/dist/Token/TokenBase.js +126 -99
  226. package/dist/Token/TokenBase.module.css.js +5 -5
  227. package/dist/Token/_RemoveTokenButton.js +48 -27
  228. package/dist/Token/_RemoveTokenButton.module.css.js +5 -5
  229. package/dist/Token/_TokenTextContainer.js +65 -54
  230. package/dist/Token/_TokenTextContainer.module.css.js +5 -5
  231. package/dist/Tooltip/Tooltip.js +56 -49
  232. package/dist/Tooltip/Tooltip.module.css.js +5 -20
  233. package/dist/TooltipV2/Tooltip.js +305 -222
  234. package/dist/TooltipV2/Tooltip.module.css.js +5 -11
  235. package/dist/TopicTag/TopicTag.js +55 -46
  236. package/dist/TopicTag/TopicTag.module.css.js +5 -5
  237. package/dist/TopicTag/TopicTagGroup.js +48 -40
  238. package/dist/TopicTag/TopicTagGroup.module.css.js +5 -5
  239. package/dist/TopicTag/index.js +7 -5
  240. package/dist/TreeView/TreeView.js +1414 -1082
  241. package/dist/TreeView/TreeView.module.css.js +5 -24
  242. package/dist/TreeView/shared.js +9 -10
  243. package/dist/TreeView/useRovingTabIndex.js +203 -129
  244. package/dist/TreeView/useTreeItemCache.js +79 -64
  245. package/dist/TreeView/useTypeahead.js +112 -90
  246. package/dist/Truncate/Truncate.js +33 -21
  247. package/dist/Truncate/Truncate.module.css.js +5 -5
  248. package/dist/UnderlineNav/UnderlineNav.js +375 -278
  249. package/dist/UnderlineNav/UnderlineNav.module.css.js +5 -8
  250. package/dist/UnderlineNav/UnderlineNavContext.js +8 -8
  251. package/dist/UnderlineNav/UnderlineNavItem.js +72 -56
  252. package/dist/UnderlineNav/UnderlineNavItem.module.css.js +5 -5
  253. package/dist/UnderlineNav/index.js +7 -5
  254. package/dist/UnderlineNav/styles.js +15 -11
  255. package/dist/VisuallyHidden/VisuallyHidden.js +49 -51
  256. package/dist/VisuallyHidden/VisuallyHidden.module.css.js +5 -5
  257. package/dist/_VisuallyHidden.js +62 -50
  258. package/dist/_VisuallyHidden.module.css.js +5 -5
  259. package/dist/deprecated/ActionList/Divider.js +23 -23
  260. package/dist/deprecated/ActionList/Divider.module.css.js +5 -5
  261. package/dist/deprecated/ActionList/Group.js +50 -43
  262. package/dist/deprecated/ActionList/Header.js +81 -69
  263. package/dist/deprecated/ActionList/Header.module.css.js +5 -5
  264. package/dist/deprecated/ActionList/Item.js +352 -308
  265. package/dist/deprecated/ActionList/Item.module.css.js +5 -18
  266. package/dist/deprecated/ActionList/List.js +196 -157
  267. package/dist/deprecated/ActionList/List.module.css.js +5 -5
  268. package/dist/deprecated/ActionList/index.js +14 -14
  269. package/dist/deprecated/ActionMenu.js +190 -159
  270. package/dist/deprecated/DialogV1/Dialog.js +200 -166
  271. package/dist/deprecated/DialogV1/Dialog.module.css.js +5 -11
  272. package/dist/deprecated/FilteredSearch/FilteredSearch.js +51 -43
  273. package/dist/deprecated/FilteredSearch/FilteredSearch.module.css.js +5 -5
  274. package/dist/deprecated/UnderlineNav/UnderlineNav.js +160 -132
  275. package/dist/deprecated/UnderlineNav/UnderlineNav.module.css.js +5 -14
  276. package/dist/deprecated/index.js +9 -20
  277. package/dist/experimental/IssueLabel/IssueLabel.js +158 -134
  278. package/dist/experimental/IssueLabel/IssueLabel.module.css.js +5 -5
  279. package/dist/experimental/SelectPanel2/SelectPanel.js +567 -419
  280. package/dist/experimental/SelectPanel2/SelectPanel.module.css.js +5 -32
  281. package/dist/experimental/Tabs/Tabs.js +297 -234
  282. package/dist/experimental/UnderlinePanels/UnderlinePanels.js +215 -165
  283. package/dist/experimental/UnderlinePanels/UnderlinePanels.module.css.js +5 -5
  284. package/dist/experimental/index.d.ts +2 -2
  285. package/dist/experimental/index.d.ts.map +1 -1
  286. package/dist/experimental/index.js +34 -44
  287. package/dist/hooks/useAnchoredPosition.js +144 -123
  288. package/dist/hooks/useControllableState.js +59 -34
  289. package/dist/hooks/useDetails.js +99 -84
  290. package/dist/hooks/useDialog.js +178 -140
  291. package/dist/hooks/useFocusTrap.js +71 -57
  292. package/dist/hooks/useFocusZone.js +38 -32
  293. package/dist/hooks/useId.js +16 -14
  294. package/dist/hooks/useIsMacOS.js +26 -21
  295. package/dist/hooks/useMedia.js +68 -54
  296. package/dist/hooks/useMenuInitialFocus.js +62 -65
  297. package/dist/hooks/useMenuKeyboardNavigation.js +126 -129
  298. package/dist/hooks/useMergedRefs.js +78 -63
  299. package/dist/hooks/useMnemonics.js +107 -77
  300. package/dist/hooks/useOnEscapePress.js +56 -45
  301. package/dist/hooks/useOnOutsideClick.js +63 -32
  302. package/dist/hooks/useOpenAndCloseFocus.js +43 -40
  303. package/dist/hooks/useOverflow.js +36 -32
  304. package/dist/hooks/useOverlay.js +75 -56
  305. package/dist/hooks/useProvidedRefOrCreate.js +24 -24
  306. package/dist/hooks/useProvidedStateOrCreate.js +39 -33
  307. package/dist/hooks/useRefObjectAsForwardedRef.js +32 -30
  308. package/dist/hooks/useRenderForcingRef.js +46 -42
  309. package/dist/hooks/useResizeObserver.js +43 -32
  310. package/dist/hooks/useResponsiveValue.js +57 -37
  311. package/dist/hooks/useSafeTimeout.js +29 -26
  312. package/dist/hooks/useScrollFlash.js +23 -16
  313. package/dist/hooks/useSlots.js +136 -102
  314. package/dist/hooks/useSyncedState.js +37 -31
  315. package/dist/index.d.ts +2 -2
  316. package/dist/index.d.ts.map +1 -1
  317. package/dist/index.js +86 -88
  318. package/dist/internal/components/ButtonReset.js +50 -45
  319. package/dist/internal/components/ButtonReset.module.css.js +5 -5
  320. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +105 -79
  321. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.module.css.js +5 -12
  322. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupCaption.js +21 -16
  323. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupContext.js +4 -4
  324. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupLabel.js +35 -26
  325. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupValidation.js +19 -14
  326. package/dist/internal/components/ConditionalWrapper.js +51 -41
  327. package/dist/internal/components/InputLabel.js +113 -92
  328. package/dist/internal/components/InputLabel.module.css.js +5 -8
  329. package/dist/internal/components/InputValidation.js +87 -67
  330. package/dist/internal/components/InputValidation.module.css.js +5 -9
  331. package/dist/internal/components/TextInputInnerAction.js +173 -134
  332. package/dist/internal/components/TextInputInnerAction.module.css.js +5 -9
  333. package/dist/internal/components/TextInputInnerVisualSlot.js +110 -89
  334. package/dist/internal/components/TextInputInnerVisualSlot.module.css.js +5 -11
  335. package/dist/internal/components/TextInputWrapper.js +230 -187
  336. package/dist/internal/components/TextInputWrapper.module.css.js +5 -8
  337. package/dist/internal/components/UnderlineTabbedInterface.js +238 -191
  338. package/dist/internal/components/UnderlineTabbedInterface.module.css.js +5 -11
  339. package/dist/internal/components/UnstyledTextInput.js +47 -40
  340. package/dist/internal/components/UnstyledTextInput.module.css.js +5 -5
  341. package/dist/internal/components/ValidationAnimationContainer.js +66 -55
  342. package/dist/internal/components/ValidationAnimationContainer.module.css.js +5 -8
  343. package/dist/internal/hooks/useEffectCallback.js +38 -35
  344. package/dist/internal/hooks/useEffectOnce.js +25 -23
  345. package/dist/internal/utils/getResponsiveAttributes.js +26 -23
  346. package/dist/internal/utils/hasInteractiveNodes.js +46 -34
  347. package/dist/legacy-theme/ts/color-schemes.js +4732 -4250
  348. package/dist/live-region/Announce.js +183 -144
  349. package/dist/live-region/AriaAlert.js +22 -20
  350. package/dist/live-region/AriaStatus.js +22 -20
  351. package/dist/next/index.js +1 -3
  352. package/dist/test-helpers.js +62 -40
  353. package/dist/theme.js +47 -83
  354. package/dist/utils/character-counter.js +63 -45
  355. package/dist/utils/create-component.js +16 -15
  356. package/dist/utils/descendant-registry.js +218 -182
  357. package/dist/utils/environment.js +7 -7
  358. package/dist/utils/getBreakpointDeclarations.js +10 -9
  359. package/dist/utils/invariant.js +23 -17
  360. package/dist/utils/is-slot.js +11 -10
  361. package/dist/utils/isNumeric.js +3 -3
  362. package/dist/utils/modern-polymorphic.js +20 -12
  363. package/dist/utils/scroll.js +11 -8
  364. package/dist/utils/theme.js +10 -5
  365. package/dist/utils/useIsomorphicLayoutEffect.js +9 -4
  366. package/dist/utils/warning.js +21 -14
  367. package/generated/components.json +1 -1
  368. package/package.json +10 -5
  369. package/dist/ActionBar/ActionBar-a41224b2.css +0 -2
  370. package/dist/ActionBar/ActionBar-a41224b2.css.map +0 -1
  371. package/dist/ActionList/ActionList-53389912.css.map +0 -1
@@ -1,148 +1,186 @@
1
- import { useOnEscapePress } from "./useOnEscapePress.js";
2
- import { c } from "react-compiler-runtime";
3
- import { useEffect } from "react";
4
- //#region src/hooks/useDialog.ts
1
+ import { c } from 'react-compiler-runtime';
2
+ import { useEffect } from 'react';
3
+ import { useOnEscapePress } from './useOnEscapePress.js';
4
+
5
5
  const noop = () => null;
6
6
  function visible(el) {
7
- return !el.hidden && (!el.type || el.type !== "hidden") && (el.offsetWidth > 0 || el.offsetHeight > 0);
7
+ return !el.hidden && (!el.type || el.type !== 'hidden') && (el.offsetWidth > 0 || el.offsetHeight > 0);
8
8
  }
9
9
  function focusable(el) {
10
- const inputEl = el;
11
- return inputEl.tabIndex >= 0 && !inputEl.disabled && visible(inputEl);
10
+ const inputEl = el;
11
+ return inputEl.tabIndex >= 0 && !inputEl.disabled && visible(inputEl);
12
12
  }
13
13
  function useDialog(t0) {
14
- const $ = c(27);
15
- const { modalRef, overlayRef, isOpen, onDismiss: t1, initialFocusRef, closeButtonRef } = t0;
16
- const onDismiss = t1 === void 0 ? noop : t1;
17
- let t2;
18
- if ($[0] !== modalRef || $[1] !== onDismiss || $[2] !== overlayRef) {
19
- t2 = (e) => {
20
- if (modalRef.current && overlayRef.current && e.target instanceof Node && !modalRef.current.contains(e.target) && overlayRef.current.contains(e.target)) onDismiss();
21
- };
22
- $[0] = modalRef;
23
- $[1] = onDismiss;
24
- $[2] = overlayRef;
25
- $[3] = t2;
26
- } else t2 = $[3];
27
- const onClickOutside = t2;
28
- let t3;
29
- let t4;
30
- if ($[4] !== isOpen || $[5] !== onClickOutside) {
31
- t3 = () => {
32
- if (isOpen) {
33
- document.addEventListener("click", onClickOutside);
34
- return () => {
35
- document.removeEventListener("click", onClickOutside);
36
- };
37
- }
38
- };
39
- t4 = [isOpen, onClickOutside];
40
- $[4] = isOpen;
41
- $[5] = onClickOutside;
42
- $[6] = t3;
43
- $[7] = t4;
44
- } else {
45
- t3 = $[6];
46
- t4 = $[7];
47
- }
48
- useEffect(t3, t4);
49
- let t5;
50
- let t6;
51
- if ($[8] !== closeButtonRef || $[9] !== initialFocusRef || $[10] !== isOpen) {
52
- t5 = () => {
53
- if (isOpen) {
54
- if (initialFocusRef && initialFocusRef.current) initialFocusRef.current.focus();
55
- else if (closeButtonRef && closeButtonRef.current) closeButtonRef.current.focus();
56
- }
57
- };
58
- t6 = [
59
- isOpen,
60
- initialFocusRef,
61
- closeButtonRef
62
- ];
63
- $[8] = closeButtonRef;
64
- $[9] = initialFocusRef;
65
- $[10] = isOpen;
66
- $[11] = t5;
67
- $[12] = t6;
68
- } else {
69
- t5 = $[11];
70
- t6 = $[12];
71
- }
72
- useEffect(t5, t6);
73
- let t7;
74
- if ($[13] !== modalRef) {
75
- t7 = (e_0, movement) => {
76
- if (modalRef.current) {
77
- const items = Array.from(modalRef.current.querySelectorAll("*")).filter(focusable);
78
- if (items.length === 0) return;
79
- e_0.preventDefault();
80
- const focusedElement = document.activeElement;
81
- if (!focusedElement) return;
82
- const offsetIndex = items.indexOf(focusedElement) + movement;
83
- const fallbackIndex = movement === 1 ? 0 : items.length - 1;
84
- return items[offsetIndex] || items[fallbackIndex];
85
- }
86
- };
87
- $[13] = modalRef;
88
- $[14] = t7;
89
- } else t7 = $[14];
90
- const getFocusableItem = t7;
91
- let t8;
92
- if ($[15] !== getFocusableItem) {
93
- t8 = (e_1) => {
94
- const focusableItem_0 = getFocusableItem(e_1, e_1.shiftKey ? -1 : 1);
95
- if (!focusableItem_0) return;
96
- focusableItem_0.focus();
97
- };
98
- $[15] = getFocusableItem;
99
- $[16] = t8;
100
- } else t8 = $[16];
101
- const handleTab = t8;
102
- let t9;
103
- if ($[17] !== handleTab) {
104
- t9 = (event) => {
105
- switch (event.key) {
106
- case "Tab": handleTab(event);
107
- }
108
- };
109
- $[17] = handleTab;
110
- $[18] = t9;
111
- } else t9 = $[18];
112
- const onKeyDown = t9;
113
- let t10;
114
- if ($[19] !== onKeyDown) {
115
- t10 = () => ({ onKeyDown });
116
- $[19] = onKeyDown;
117
- $[20] = t10;
118
- } else t10 = $[20];
119
- const getDialogProps = t10;
120
- let t11;
121
- let t12;
122
- if ($[21] !== isOpen || $[22] !== onDismiss) {
123
- t11 = (event_0) => {
124
- if (isOpen) {
125
- onDismiss();
126
- event_0.preventDefault();
127
- }
128
- };
129
- t12 = [isOpen, onDismiss];
130
- $[21] = isOpen;
131
- $[22] = onDismiss;
132
- $[23] = t11;
133
- $[24] = t12;
134
- } else {
135
- t11 = $[23];
136
- t12 = $[24];
137
- }
138
- useOnEscapePress(t11, t12);
139
- let t13;
140
- if ($[25] !== getDialogProps) {
141
- t13 = { getDialogProps };
142
- $[25] = getDialogProps;
143
- $[26] = t13;
144
- } else t13 = $[26];
145
- return t13;
14
+ const $ = c(27);
15
+ const {
16
+ modalRef,
17
+ overlayRef,
18
+ isOpen,
19
+ onDismiss: t1,
20
+ initialFocusRef,
21
+ closeButtonRef
22
+ } = t0;
23
+ const onDismiss = t1 === undefined ? noop : t1;
24
+ let t2;
25
+ if ($[0] !== modalRef || $[1] !== onDismiss || $[2] !== overlayRef) {
26
+ t2 = e => {
27
+ if (modalRef.current && overlayRef.current && e.target instanceof Node && !modalRef.current.contains(e.target) && overlayRef.current.contains(e.target)) {
28
+ onDismiss();
29
+ }
30
+ };
31
+ $[0] = modalRef;
32
+ $[1] = onDismiss;
33
+ $[2] = overlayRef;
34
+ $[3] = t2;
35
+ } else {
36
+ t2 = $[3];
37
+ }
38
+ const onClickOutside = t2;
39
+ let t3;
40
+ let t4;
41
+ if ($[4] !== isOpen || $[5] !== onClickOutside) {
42
+ t3 = () => {
43
+ if (isOpen) {
44
+ document.addEventListener("click", onClickOutside);
45
+ return () => {
46
+ document.removeEventListener("click", onClickOutside);
47
+ };
48
+ }
49
+ };
50
+ t4 = [isOpen, onClickOutside];
51
+ $[4] = isOpen;
52
+ $[5] = onClickOutside;
53
+ $[6] = t3;
54
+ $[7] = t4;
55
+ } else {
56
+ t3 = $[6];
57
+ t4 = $[7];
58
+ }
59
+ useEffect(t3, t4);
60
+ let t5;
61
+ let t6;
62
+ if ($[8] !== closeButtonRef || $[9] !== initialFocusRef || $[10] !== isOpen) {
63
+ t5 = () => {
64
+ if (isOpen) {
65
+ if (initialFocusRef && initialFocusRef.current) {
66
+ initialFocusRef.current.focus();
67
+ } else {
68
+ if (closeButtonRef && closeButtonRef.current) {
69
+ closeButtonRef.current.focus();
70
+ }
71
+ }
72
+ }
73
+ };
74
+ t6 = [isOpen, initialFocusRef, closeButtonRef];
75
+ $[8] = closeButtonRef;
76
+ $[9] = initialFocusRef;
77
+ $[10] = isOpen;
78
+ $[11] = t5;
79
+ $[12] = t6;
80
+ } else {
81
+ t5 = $[11];
82
+ t6 = $[12];
83
+ }
84
+ useEffect(t5, t6);
85
+ let t7;
86
+ if ($[13] !== modalRef) {
87
+ t7 = (e_0, movement) => {
88
+ if (modalRef.current) {
89
+ const items = Array.from(modalRef.current.querySelectorAll("*")).filter(focusable);
90
+ if (items.length === 0) {
91
+ return;
92
+ }
93
+ e_0.preventDefault();
94
+ const focusedElement = document.activeElement;
95
+ if (!focusedElement) {
96
+ return;
97
+ }
98
+ const index = items.indexOf(focusedElement);
99
+ const offsetIndex = index + movement;
100
+ const fallbackIndex = movement === 1 ? 0 : items.length - 1;
101
+ const focusableItem = items[offsetIndex] || items[fallbackIndex];
102
+ return focusableItem;
103
+ }
104
+ };
105
+ $[13] = modalRef;
106
+ $[14] = t7;
107
+ } else {
108
+ t7 = $[14];
109
+ }
110
+ const getFocusableItem = t7;
111
+ let t8;
112
+ if ($[15] !== getFocusableItem) {
113
+ t8 = e_1 => {
114
+ const movement_0 = e_1.shiftKey ? -1 : 1;
115
+ const focusableItem_0 = getFocusableItem(e_1, movement_0);
116
+ if (!focusableItem_0) {
117
+ return;
118
+ }
119
+ focusableItem_0.focus();
120
+ };
121
+ $[15] = getFocusableItem;
122
+ $[16] = t8;
123
+ } else {
124
+ t8 = $[16];
125
+ }
126
+ const handleTab = t8;
127
+ let t9;
128
+ if ($[17] !== handleTab) {
129
+ t9 = event => {
130
+ switch (event.key) {
131
+ case "Tab":
132
+ {
133
+ handleTab(event);
134
+ }
135
+ }
136
+ };
137
+ $[17] = handleTab;
138
+ $[18] = t9;
139
+ } else {
140
+ t9 = $[18];
141
+ }
142
+ const onKeyDown = t9;
143
+ let t10;
144
+ if ($[19] !== onKeyDown) {
145
+ t10 = () => ({
146
+ onKeyDown
147
+ });
148
+ $[19] = onKeyDown;
149
+ $[20] = t10;
150
+ } else {
151
+ t10 = $[20];
152
+ }
153
+ const getDialogProps = t10;
154
+ let t11;
155
+ let t12;
156
+ if ($[21] !== isOpen || $[22] !== onDismiss) {
157
+ t11 = event_0 => {
158
+ if (isOpen) {
159
+ onDismiss();
160
+ event_0.preventDefault();
161
+ }
162
+ };
163
+ t12 = [isOpen, onDismiss];
164
+ $[21] = isOpen;
165
+ $[22] = onDismiss;
166
+ $[23] = t11;
167
+ $[24] = t12;
168
+ } else {
169
+ t11 = $[23];
170
+ t12 = $[24];
171
+ }
172
+ useOnEscapePress(t11, t12);
173
+ let t13;
174
+ if ($[25] !== getDialogProps) {
175
+ t13 = {
176
+ getDialogProps
177
+ };
178
+ $[25] = getDialogProps;
179
+ $[26] = t13;
180
+ } else {
181
+ t13 = $[26];
182
+ }
183
+ return t13;
146
184
  }
147
- //#endregion
185
+
148
186
  export { useDialog as default };
@@ -1,61 +1,75 @@
1
- import { useOnOutsideClick } from "./useOnOutsideClick.js";
2
- import { useProvidedRefOrCreate } from "./useProvidedRefOrCreate.js";
3
- import React from "react";
4
- import { focusTrap } from "@primer/behaviors";
5
- //#region src/hooks/useFocusTrap.ts
1
+ import React from 'react';
2
+ import { focusTrap } from '@primer/behaviors';
3
+ import { useProvidedRefOrCreate } from './useProvidedRefOrCreate.js';
4
+ import { useOnOutsideClick } from './useOnOutsideClick.js';
5
+
6
6
  /**
7
- * Hook used to trap focus inside a container. Returns a ref that can be added to the container
8
- * that should trap focus.
9
- * @param settings {FocusTrapHookSettings}
10
- */
7
+ * Hook used to trap focus inside a container. Returns a ref that can be added to the container
8
+ * that should trap focus.
9
+ * @param settings {FocusTrapHookSettings}
10
+ */
11
11
  function useFocusTrap(settings, dependencies = []) {
12
- const [outsideClicked, setOutsideClicked] = React.useState(false);
13
- const containerRef = useProvidedRefOrCreate(settings === null || settings === void 0 ? void 0 : settings.containerRef);
14
- const initialFocusRef = useProvidedRefOrCreate(settings === null || settings === void 0 ? void 0 : settings.initialFocusRef);
15
- const disabled = settings === null || settings === void 0 ? void 0 : settings.disabled;
16
- const abortController = React.useRef();
17
- const previousFocusedElement = React.useRef(null);
18
- if (!previousFocusedElement.current && !disabled) previousFocusedElement.current = document.activeElement;
19
- function disableTrap() {
20
- var _abortController$curr;
21
- (_abortController$curr = abortController.current) === null || _abortController$curr === void 0 || _abortController$curr.abort();
22
- if (settings !== null && settings !== void 0 && settings.allowOutsideClick && outsideClicked) return;
23
- if (settings !== null && settings !== void 0 && settings.returnFocusRef && settings.returnFocusRef.current instanceof HTMLElement) settings.returnFocusRef.current.focus();
24
- else if (settings !== null && settings !== void 0 && settings.restoreFocusOnCleanUp && previousFocusedElement.current instanceof HTMLElement) {
25
- previousFocusedElement.current.focus();
26
- previousFocusedElement.current = null;
27
- }
28
- }
29
- React.useEffect(() => {
30
- if (containerRef.current instanceof HTMLElement) if (!disabled) {
31
- var _initialFocusRef$curr;
32
- abortController.current = focusTrap(containerRef.current, (_initialFocusRef$curr = initialFocusRef.current) !== null && _initialFocusRef$curr !== void 0 ? _initialFocusRef$curr : void 0);
33
- return () => {
34
- disableTrap();
35
- };
36
- } else disableTrap();
37
- }, [
38
- containerRef,
39
- initialFocusRef,
40
- disabled,
41
- ...dependencies
42
- ]);
43
- useOnOutsideClick({
44
- containerRef,
45
- onClickOutside: () => {
46
- setOutsideClicked(true);
47
- if (settings !== null && settings !== void 0 && settings.allowOutsideClick) {
48
- var _abortController$curr2;
49
- if (settings.returnFocusRef) settings.returnFocusRef = void 0;
50
- settings.restoreFocusOnCleanUp = false;
51
- (_abortController$curr2 = abortController.current) === null || _abortController$curr2 === void 0 || _abortController$curr2.abort();
52
- }
53
- }
54
- });
55
- return {
56
- containerRef,
57
- initialFocusRef
58
- };
12
+ const [outsideClicked, setOutsideClicked] = React.useState(false);
13
+ const containerRef = useProvidedRefOrCreate(settings === null || settings === void 0 ? void 0 : settings.containerRef);
14
+ const initialFocusRef = useProvidedRefOrCreate(settings === null || settings === void 0 ? void 0 : settings.initialFocusRef);
15
+ const disabled = settings === null || settings === void 0 ? void 0 : settings.disabled;
16
+ const abortController = React.useRef();
17
+ const previousFocusedElement = React.useRef(null);
18
+
19
+ // If we are enabling a focus trap and haven't already stored the previously focused element
20
+ // go ahead an do that so we can restore later when the trap is disabled.
21
+ // eslint-disable-next-line react-hooks/refs
22
+ if (!previousFocusedElement.current && !disabled) {
23
+ previousFocusedElement.current = document.activeElement;
24
+ }
25
+
26
+ // This function removes the event listeners that enable the focus trap and restores focus
27
+ // to the previously-focused element (if necessary).
28
+ function disableTrap() {
29
+ var _abortController$curr;
30
+ (_abortController$curr = abortController.current) === null || _abortController$curr === void 0 ? void 0 : _abortController$curr.abort();
31
+ if (settings !== null && settings !== void 0 && settings.allowOutsideClick && outsideClicked) {
32
+ return;
33
+ }
34
+ if (settings !== null && settings !== void 0 && settings.returnFocusRef && settings.returnFocusRef.current instanceof HTMLElement) {
35
+ settings.returnFocusRef.current.focus();
36
+ } else if (settings !== null && settings !== void 0 && settings.restoreFocusOnCleanUp && previousFocusedElement.current instanceof HTMLElement) {
37
+ previousFocusedElement.current.focus();
38
+ previousFocusedElement.current = null;
39
+ }
40
+ }
41
+ React.useEffect(() => {
42
+ if (containerRef.current instanceof HTMLElement) {
43
+ if (!disabled) {
44
+ var _initialFocusRef$curr;
45
+ abortController.current = focusTrap(containerRef.current, (_initialFocusRef$curr = initialFocusRef.current) !== null && _initialFocusRef$curr !== void 0 ? _initialFocusRef$curr : undefined);
46
+ return () => {
47
+ disableTrap();
48
+ };
49
+ } else {
50
+ disableTrap();
51
+ }
52
+ }
53
+ },
54
+ // eslint-disable-next-line react-hooks/exhaustive-deps
55
+ [containerRef, initialFocusRef, disabled, ...dependencies]);
56
+ useOnOutsideClick({
57
+ containerRef: containerRef,
58
+ onClickOutside: () => {
59
+ setOutsideClicked(true);
60
+ if (settings !== null && settings !== void 0 && settings.allowOutsideClick) {
61
+ var _abortController$curr2;
62
+ // eslint-disable-next-line react-hooks/immutability
63
+ if (settings.returnFocusRef) settings.returnFocusRef = undefined;
64
+ settings.restoreFocusOnCleanUp = false;
65
+ (_abortController$curr2 = abortController.current) === null || _abortController$curr2 === void 0 ? void 0 : _abortController$curr2.abort();
66
+ }
67
+ }
68
+ });
69
+ return {
70
+ containerRef,
71
+ initialFocusRef
72
+ };
59
73
  }
60
- //#endregion
74
+
61
75
  export { useFocusTrap };
@@ -1,34 +1,40 @@
1
- import { useProvidedRefOrCreate } from "./useProvidedRefOrCreate.js";
2
- import React, { useEffect } from "react";
3
- import { FocusKeys as FocusKeys$1, focusZone } from "@primer/behaviors";
4
- //#region src/hooks/useFocusZone.ts
1
+ import React, { useEffect } from 'react';
2
+ import { focusZone } from '@primer/behaviors';
3
+ export { FocusKeys } from '@primer/behaviors';
4
+ import { useProvidedRefOrCreate } from './useProvidedRefOrCreate.js';
5
+
5
6
  function useFocusZone(settings = {}, dependencies = []) {
6
- const containerRef = useProvidedRefOrCreate(settings.containerRef);
7
- const useActiveDescendant = !!settings.activeDescendantFocus;
8
- const activeDescendantControlRef = useProvidedRefOrCreate(typeof settings.activeDescendantFocus === "boolean" || !settings.activeDescendantFocus ? void 0 : settings.activeDescendantFocus);
9
- const disabled = settings.disabled;
10
- const abortController = React.useRef();
11
- useEffect(() => {
12
- if (containerRef.current instanceof HTMLElement && (!useActiveDescendant || activeDescendantControlRef.current instanceof HTMLElement)) if (!disabled) {
13
- var _activeDescendantCont;
14
- const vanillaSettings = {
15
- ...settings,
16
- activeDescendantControl: (_activeDescendantCont = activeDescendantControlRef.current) !== null && _activeDescendantCont !== void 0 ? _activeDescendantCont : void 0
17
- };
18
- abortController.current = focusZone(containerRef.current, vanillaSettings);
19
- return () => {
20
- var _abortController$curr;
21
- (_abortController$curr = abortController.current) === null || _abortController$curr === void 0 || _abortController$curr.abort();
22
- };
23
- } else {
24
- var _abortController$curr2;
25
- (_abortController$curr2 = abortController.current) === null || _abortController$curr2 === void 0 || _abortController$curr2.abort();
26
- }
27
- }, [disabled, ...dependencies]);
28
- return {
29
- containerRef,
30
- activeDescendantControlRef
31
- };
7
+ const containerRef = useProvidedRefOrCreate(settings.containerRef);
8
+ const useActiveDescendant = !!settings.activeDescendantFocus;
9
+ const passedActiveDescendantRef = typeof settings.activeDescendantFocus === 'boolean' || !settings.activeDescendantFocus ? undefined : settings.activeDescendantFocus;
10
+ const activeDescendantControlRef = useProvidedRefOrCreate(passedActiveDescendantRef);
11
+ const disabled = settings.disabled;
12
+ const abortController = React.useRef();
13
+ useEffect(() => {
14
+ if (containerRef.current instanceof HTMLElement && (!useActiveDescendant || activeDescendantControlRef.current instanceof HTMLElement)) {
15
+ if (!disabled) {
16
+ var _activeDescendantCont;
17
+ const vanillaSettings = {
18
+ ...settings,
19
+ activeDescendantControl: (_activeDescendantCont = activeDescendantControlRef.current) !== null && _activeDescendantCont !== void 0 ? _activeDescendantCont : undefined
20
+ };
21
+ abortController.current = focusZone(containerRef.current, vanillaSettings);
22
+ return () => {
23
+ var _abortController$curr;
24
+ (_abortController$curr = abortController.current) === null || _abortController$curr === void 0 ? void 0 : _abortController$curr.abort();
25
+ };
26
+ } else {
27
+ var _abortController$curr2;
28
+ (_abortController$curr2 = abortController.current) === null || _abortController$curr2 === void 0 ? void 0 : _abortController$curr2.abort();
29
+ }
30
+ }
31
+ },
32
+ // eslint-disable-next-line react-hooks/exhaustive-deps
33
+ [disabled, ...dependencies]);
34
+ return {
35
+ containerRef,
36
+ activeDescendantControlRef
37
+ };
32
38
  }
33
- //#endregion
34
- export { FocusKeys$1 as FocusKeys, useFocusZone };
39
+
40
+ export { useFocusZone };
@@ -1,16 +1,18 @@
1
- import { useId } from "react";
2
- //#region src/hooks/useId.ts
1
+ import { useId as useId$1 } from 'react';
2
+
3
3
  /**
4
- * Generate a unique id to be used in a component. If an `id` is provided, it
5
- * will be used instead.
6
- *
7
- * @param id - An optional value to be used instead of generating a unique id.
8
- * Useful when accepting an optional `id` as a prop in a component.
9
- */
10
- function useId$1(id) {
11
- const uniqueId = useId();
12
- if (id) return id;
13
- return uniqueId;
4
+ * Generate a unique id to be used in a component. If an `id` is provided, it
5
+ * will be used instead.
6
+ *
7
+ * @param id - An optional value to be used instead of generating a unique id.
8
+ * Useful when accepting an optional `id` as a prop in a component.
9
+ */
10
+ function useId(id) {
11
+ const uniqueId = useId$1();
12
+ if (id) {
13
+ return id;
14
+ }
15
+ return uniqueId;
14
16
  }
15
- //#endregion
16
- export { useId$1 as useId };
17
+
18
+ export { useId };
@@ -1,27 +1,32 @@
1
- import { useSyncExternalStore } from "react";
2
- import { isMacOS } from "@primer/behaviors/utils";
3
- //#region src/hooks/useIsMacOS.ts
1
+ import { isMacOS } from '@primer/behaviors/utils';
2
+ import { useSyncExternalStore } from 'react';
3
+
4
+ // No-op. The platform never changes at runtime, so there is nothing to
5
+ // subscribe to. Hoisted to avoid creating a new function on every call.
4
6
  const subscribe = () => () => {};
7
+
8
+ // Safe default for SSR since we can't detect the platform on the server.
5
9
  const getServerSnapshot = () => false;
10
+
6
11
  /**
7
- * SSR-safe hook for determining if the current platform is MacOS.
8
- *
9
- * Uses `useSyncExternalStore` to read the platform value:
10
- *
11
- * - On the **client**, `ssrUnsafeIsMacOS` reads `navigator.userAgent` and
12
- * returns the real value immediately, with no extra render pass.
13
- *
14
- * - On the **server**, returns `false`. During hydration, if the snapshots
15
- * differ, React handles the mismatch internally in a single synchronous
16
- * pass, avoiding the layout shift that a deferred `useEffect` + `setState`
17
- * would cause.
18
- *
19
- * Previous implementation used `useState` + `useEffect`, which caused an
20
- * unconditional second render on every mount (even on the client where the
21
- * initial value was already correct).
22
- */
12
+ * SSR-safe hook for determining if the current platform is MacOS.
13
+ *
14
+ * Uses `useSyncExternalStore` to read the platform value:
15
+ *
16
+ * - On the **client**, `ssrUnsafeIsMacOS` reads `navigator.userAgent` and
17
+ * returns the real value immediately, with no extra render pass.
18
+ *
19
+ * - On the **server**, returns `false`. During hydration, if the snapshots
20
+ * differ, React handles the mismatch internally in a single synchronous
21
+ * pass, avoiding the layout shift that a deferred `useEffect` + `setState`
22
+ * would cause.
23
+ *
24
+ * Previous implementation used `useState` + `useEffect`, which caused an
25
+ * unconditional second render on every mount (even on the client where the
26
+ * initial value was already correct).
27
+ */
23
28
  function useIsMacOS() {
24
- return useSyncExternalStore(subscribe, isMacOS, getServerSnapshot);
29
+ return useSyncExternalStore(subscribe, isMacOS, getServerSnapshot);
25
30
  }
26
- //#endregion
31
+
27
32
  export { useIsMacOS };