@primer/react 0.0.0-20260428150519 → 0.0.0-20260428191209

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 (362) hide show
  1. package/CHANGELOG.md +5 -1
  2. package/dist/ActionBar/ActionBar.js +705 -502
  3. package/dist/ActionBar/ActionBar.module.css.js +5 -10
  4. package/dist/ActionBar/index.js +8 -8
  5. package/dist/ActionList/{ActionList-53389912.css → ActionList-09f5c4a8.css} +2 -2
  6. package/dist/ActionList/ActionList-09f5c4a8.css.map +1 -0
  7. package/dist/ActionList/ActionList.module.css.js +5 -31
  8. package/dist/ActionList/ActionListContainerContext.js +5 -4
  9. package/dist/ActionList/Description.js +133 -117
  10. package/dist/ActionList/Divider.js +38 -31
  11. package/dist/ActionList/Group.js +349 -292
  12. package/dist/ActionList/Group.module.css.js +5 -10
  13. package/dist/ActionList/Heading.js +106 -88
  14. package/dist/ActionList/Heading.module.css.js +5 -5
  15. package/dist/ActionList/Item.js +811 -668
  16. package/dist/ActionList/LinkItem.js +56 -36
  17. package/dist/ActionList/List.js +210 -168
  18. package/dist/ActionList/Selection.d.ts +2 -3
  19. package/dist/ActionList/Selection.d.ts.map +1 -1
  20. package/dist/ActionList/Selection.js +112 -83
  21. package/dist/ActionList/TrailingAction.js +112 -97
  22. package/dist/ActionList/Visuals.js +191 -143
  23. package/dist/ActionList/index.d.ts +7 -0
  24. package/dist/ActionList/index.d.ts.map +1 -1
  25. package/dist/ActionList/index.js +38 -33
  26. package/dist/ActionList/shared.js +9 -5
  27. package/dist/ActionMenu/ActionMenu.js +310 -223
  28. package/dist/ActionMenu/ActionMenu.module.css.js +5 -5
  29. package/dist/AnchoredOverlay/AnchoredOverlay.js +280 -206
  30. package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +5 -9
  31. package/dist/Autocomplete/Autocomplete.js +141 -125
  32. package/dist/Autocomplete/AutocompleteContext.js +20 -18
  33. package/dist/Autocomplete/AutocompleteInput.js +146 -108
  34. package/dist/Autocomplete/AutocompleteMenu.js +238 -201
  35. package/dist/Autocomplete/AutocompleteMenu.module.css.js +5 -8
  36. package/dist/Autocomplete/AutocompleteOverlay.js +79 -54
  37. package/dist/Autocomplete/AutocompleteOverlay.module.css.js +5 -5
  38. package/dist/Avatar/Avatar.js +133 -106
  39. package/dist/Avatar/Avatar.module.css.js +5 -5
  40. package/dist/AvatarStack/AvatarStack.js +143 -102
  41. package/dist/AvatarStack/AvatarStack.module.css.js +5 -9
  42. package/dist/Banner/Banner.js +186 -133
  43. package/dist/Banner/Banner.module.css.js +5 -14
  44. package/dist/Banner/index.js +7 -7
  45. package/dist/BaseStyles.js +91 -74
  46. package/dist/BaseStyles.module.css.js +5 -5
  47. package/dist/Blankslate/Blankslate.js +328 -266
  48. package/dist/Blankslate/Blankslate.module.css.js +5 -12
  49. package/dist/Blankslate/BlankslateContext.js +9 -7
  50. package/dist/Blankslate/index.js +9 -9
  51. package/dist/BranchName/BranchName.js +59 -49
  52. package/dist/BranchName/BranchName.module.css.js +5 -5
  53. package/dist/Breadcrumbs/Breadcrumbs.js +431 -371
  54. package/dist/Breadcrumbs/Breadcrumbs.module.css.js +5 -15
  55. package/dist/Button/Button.js +18 -15
  56. package/dist/Button/ButtonBase.js +139 -76
  57. package/dist/Button/ButtonBase.module.css.js +5 -16
  58. package/dist/Button/IconButton.js +74 -42
  59. package/dist/Button/LinkButton.js +17 -13
  60. package/dist/ButtonGroup/ButtonGroup.js +97 -80
  61. package/dist/ButtonGroup/ButtonGroup.module.css.js +5 -5
  62. package/dist/Card/Card.js +491 -401
  63. package/dist/Card/Card.module.css.js +5 -18
  64. package/dist/Card/index.js +9 -9
  65. package/dist/Checkbox/Checkbox.js +71 -52
  66. package/dist/Checkbox/Checkbox.module.css.js +5 -9
  67. package/dist/Checkbox/shared.module.css.js +5 -5
  68. package/dist/CheckboxGroup/CheckboxGroup.js +132 -111
  69. package/dist/CheckboxGroup/CheckboxGroupContext.js +4 -4
  70. package/dist/CircleBadge/CircleBadge.js +90 -77
  71. package/dist/CircleBadge/CircleBadge.module.css.js +5 -8
  72. package/dist/ConfirmationDialog/ConfirmationDialog.js +92 -68
  73. package/dist/CounterLabel/CounterLabel.js +99 -83
  74. package/dist/CounterLabel/CounterLabel.module.css.js +5 -5
  75. package/dist/DataTable/DataTable.js +140 -100
  76. package/dist/DataTable/ErrorDialog.js +45 -33
  77. package/dist/DataTable/Pagination.js +592 -464
  78. package/dist/DataTable/Pagination.module.css.js +5 -13
  79. package/dist/DataTable/Table.js +710 -527
  80. package/dist/DataTable/Table.module.css.js +5 -26
  81. package/dist/DataTable/column.js +11 -10
  82. package/dist/DataTable/index.js +20 -22
  83. package/dist/DataTable/sorting.js +103 -65
  84. package/dist/DataTable/useTable.js +290 -207
  85. package/dist/Details/Details.js +126 -100
  86. package/dist/Details/Details.module.css.js +5 -5
  87. package/dist/Dialog/Dialog.js +351 -259
  88. package/dist/Dialog/Dialog.module.css.js +5 -22
  89. package/dist/FeatureFlags/DefaultFeatureFlags.js +7 -7
  90. package/dist/FeatureFlags/FeatureFlagContext.js +5 -5
  91. package/dist/FeatureFlags/FeatureFlagScope.js +44 -36
  92. package/dist/FeatureFlags/FeatureFlags.js +37 -29
  93. package/dist/FeatureFlags/useFeatureFlag.js +19 -17
  94. package/dist/FilteredActionList/FilteredActionList.d.ts.map +1 -1
  95. package/dist/FilteredActionList/FilteredActionList.js +559 -454
  96. package/dist/FilteredActionList/FilteredActionList.module.css.js +5 -15
  97. package/dist/FilteredActionList/FilteredActionListInput.d.ts +15 -0
  98. package/dist/FilteredActionList/FilteredActionListInput.d.ts.map +1 -0
  99. package/dist/FilteredActionList/FilteredActionListInput.js +119 -0
  100. package/dist/FilteredActionList/FilteredActionListLoaders.js +150 -119
  101. package/dist/FilteredActionList/FilteredActionListLoaders.module.css.js +5 -9
  102. package/dist/FilteredActionList/index.d.ts +9 -1
  103. package/dist/FilteredActionList/index.d.ts.map +1 -1
  104. package/dist/FilteredActionList/index.js +11 -0
  105. package/dist/FilteredActionList/useAnnouncements.js +180 -167
  106. package/dist/Flash/Flash.js +69 -57
  107. package/dist/Flash/Flash.module.css.js +5 -5
  108. package/dist/FormControl/FormControl.js +227 -211
  109. package/dist/FormControl/FormControl.module.css.js +5 -11
  110. package/dist/FormControl/FormControlCaption.js +49 -37
  111. package/dist/FormControl/FormControlCaption.module.css.js +5 -5
  112. package/dist/FormControl/FormControlLabel.js +115 -95
  113. package/dist/FormControl/FormControlLeadingVisual.js +37 -29
  114. package/dist/FormControl/FormControlLeadingVisual.module.css.js +5 -5
  115. package/dist/FormControl/_FormControlContext.js +48 -41
  116. package/dist/FormControl/_FormControlValidation.js +39 -29
  117. package/dist/Header/Header.js +165 -138
  118. package/dist/Header/Header.module.css.js +5 -9
  119. package/dist/Heading/Heading.js +37 -26
  120. package/dist/Heading/Heading.module.css.js +5 -5
  121. package/dist/Hidden/Hidden.js +77 -54
  122. package/dist/Hidden/Hidden.module.css.js +5 -5
  123. package/dist/InlineMessage/InlineMessage.js +116 -88
  124. package/dist/InlineMessage/InlineMessage.module.css.js +5 -8
  125. package/dist/KeybindingHint/KeybindingHint.js +88 -70
  126. package/dist/KeybindingHint/KeybindingHint.module.css.js +5 -5
  127. package/dist/KeybindingHint/components/Chord.js +93 -81
  128. package/dist/KeybindingHint/components/Chord.module.css.js +5 -11
  129. package/dist/KeybindingHint/components/Key.js +66 -49
  130. package/dist/KeybindingHint/components/Sequence.js +24 -12
  131. package/dist/KeybindingHint/key-names.js +114 -99
  132. package/dist/Label/Label.js +66 -56
  133. package/dist/Label/Label.module.css.js +5 -5
  134. package/dist/Label/index.js +5 -5
  135. package/dist/LabelGroup/LabelGroup.js +344 -260
  136. package/dist/LabelGroup/LabelGroup.module.css.js +5 -12
  137. package/dist/Link/Link.js +47 -31
  138. package/dist/Link/Link.module.css.js +5 -5
  139. package/dist/NavList/NavList.js +614 -424
  140. package/dist/NavList/NavList.module.css.js +5 -5
  141. package/dist/Octicon/Octicon.js +37 -35
  142. package/dist/Overlay/Overlay.js +318 -264
  143. package/dist/Overlay/Overlay.module.css.js +5 -8
  144. package/dist/PageHeader/PageHeader.js +823 -579
  145. package/dist/PageHeader/PageHeader.module.css.js +5 -21
  146. package/dist/PageLayout/PageLayout.js +913 -631
  147. package/dist/PageLayout/PageLayout.module.css.js +5 -31
  148. package/dist/PageLayout/paneUtils.js +29 -15
  149. package/dist/PageLayout/usePaneWidth.js +437 -334
  150. package/dist/Pagehead/Pagehead.js +14 -10
  151. package/dist/Pagehead/Pagehead.module.css.js +5 -5
  152. package/dist/Pagination/Pagination.js +114 -84
  153. package/dist/Pagination/Pagination.module.css.js +5 -9
  154. package/dist/Pagination/index.js +5 -5
  155. package/dist/Pagination/model.js +194 -118
  156. package/dist/Popover/Popover.js +151 -126
  157. package/dist/Popover/Popover.module.css.js +5 -8
  158. package/dist/Portal/Portal.js +85 -65
  159. package/dist/Portal/index.js +6 -5
  160. package/dist/ProgressBar/ProgressBar.js +255 -210
  161. package/dist/ProgressBar/ProgressBar.module.css.js +5 -9
  162. package/dist/ProgressBar/index.js +8 -6
  163. package/dist/Radio/Radio.js +115 -97
  164. package/dist/Radio/Radio.module.css.js +5 -5
  165. package/dist/RadioGroup/RadioGroup.js +118 -99
  166. package/dist/RelativeTime/RelativeTime.js +76 -64
  167. package/dist/ScrollableRegion/ScrollableRegion.js +79 -67
  168. package/dist/ScrollableRegion/ScrollableRegion.module.css.js +5 -5
  169. package/dist/SegmentedControl/SegmentedControl.js +287 -238
  170. package/dist/SegmentedControl/SegmentedControl.module.css.js +5 -15
  171. package/dist/SegmentedControl/SegmentedControlButton.js +187 -156
  172. package/dist/SegmentedControl/SegmentedControlIconButton.js +161 -133
  173. package/dist/Select/Select.js +234 -185
  174. package/dist/Select/Select.module.css.js +5 -10
  175. package/dist/SelectPanel/SelectPanel.d.ts +1 -0
  176. package/dist/SelectPanel/SelectPanel.d.ts.map +1 -1
  177. package/dist/SelectPanel/SelectPanel.js +829 -620
  178. package/dist/SelectPanel/SelectPanel.module.css.js +5 -27
  179. package/dist/SelectPanel/SelectPanelMessage.js +39 -37
  180. package/dist/SelectPanel/index.d.ts +1 -0
  181. package/dist/SelectPanel/index.d.ts.map +1 -1
  182. package/dist/SideNav.js +47 -24
  183. package/dist/SideNav.module.css.js +5 -12
  184. package/dist/Skeleton/SkeletonBox.js +111 -94
  185. package/dist/Skeleton/SkeletonBox.module.css.js +5 -8
  186. package/dist/SkeletonAvatar/SkeletonAvatar.js +120 -95
  187. package/dist/SkeletonAvatar/SkeletonAvatar.module.css.js +5 -5
  188. package/dist/SkeletonText/SkeletonText.js +137 -114
  189. package/dist/SkeletonText/SkeletonText.module.css.js +5 -8
  190. package/dist/Spinner/Spinner.js +211 -183
  191. package/dist/Spinner/Spinner.module.css.js +5 -9
  192. package/dist/SplitPageLayout/SplitPageLayout.js +276 -215
  193. package/dist/Stack/Stack.js +255 -207
  194. package/dist/Stack/Stack.module.css.js +5 -8
  195. package/dist/Stack/index.js +6 -4
  196. package/dist/StateLabel/StateLabel.js +123 -110
  197. package/dist/StateLabel/StateLabel.module.css.js +5 -8
  198. package/dist/SubNav/SubNav.js +197 -159
  199. package/dist/SubNav/SubNav.module.css.js +5 -11
  200. package/dist/TabNav/TabNav.js +199 -167
  201. package/dist/TabNav/TabNav.module.css.js +5 -10
  202. package/dist/Text/Text.js +67 -56
  203. package/dist/Text/Text.module.css.js +5 -5
  204. package/dist/TextInput/TextInput.js +228 -195
  205. package/dist/TextInput/TextInput.module.css.js +5 -8
  206. package/dist/TextInputWithTokens/TextInputWithTokens.js +673 -567
  207. package/dist/TextInputWithTokens/TextInputWithTokens.module.css.js +5 -14
  208. package/dist/Textarea/TextArea.module.css.js +5 -9
  209. package/dist/Textarea/Textarea.js +294 -264
  210. package/dist/ThemeProvider.js +257 -199
  211. package/dist/Timeline/Timeline.js +247 -204
  212. package/dist/Timeline/Timeline.module.css.js +5 -12
  213. package/dist/ToggleSwitch/ToggleSwitch.js +471 -403
  214. package/dist/ToggleSwitch/ToggleSwitch.module.css.js +5 -16
  215. package/dist/Token/IssueLabelToken.js +297 -256
  216. package/dist/Token/IssueLabelToken.module.css.js +5 -8
  217. package/dist/Token/Token.js +280 -232
  218. package/dist/Token/Token.module.css.js +5 -9
  219. package/dist/Token/TokenBase.js +126 -99
  220. package/dist/Token/TokenBase.module.css.js +5 -5
  221. package/dist/Token/_RemoveTokenButton.js +48 -27
  222. package/dist/Token/_RemoveTokenButton.module.css.js +5 -5
  223. package/dist/Token/_TokenTextContainer.js +65 -54
  224. package/dist/Token/_TokenTextContainer.module.css.js +5 -5
  225. package/dist/Tooltip/Tooltip.js +56 -49
  226. package/dist/Tooltip/Tooltip.module.css.js +5 -20
  227. package/dist/TooltipV2/Tooltip.js +305 -222
  228. package/dist/TooltipV2/Tooltip.module.css.js +5 -11
  229. package/dist/TopicTag/TopicTag.js +55 -46
  230. package/dist/TopicTag/TopicTag.module.css.js +5 -5
  231. package/dist/TopicTag/TopicTagGroup.js +48 -40
  232. package/dist/TopicTag/TopicTagGroup.module.css.js +5 -5
  233. package/dist/TopicTag/index.js +7 -5
  234. package/dist/TreeView/TreeView.js +1414 -1082
  235. package/dist/TreeView/TreeView.module.css.js +5 -24
  236. package/dist/TreeView/shared.js +9 -10
  237. package/dist/TreeView/useRovingTabIndex.js +203 -129
  238. package/dist/TreeView/useTreeItemCache.js +79 -64
  239. package/dist/TreeView/useTypeahead.js +112 -90
  240. package/dist/Truncate/Truncate.js +33 -21
  241. package/dist/Truncate/Truncate.module.css.js +5 -5
  242. package/dist/UnderlineNav/UnderlineNav.js +375 -278
  243. package/dist/UnderlineNav/UnderlineNav.module.css.js +5 -8
  244. package/dist/UnderlineNav/UnderlineNavContext.js +8 -8
  245. package/dist/UnderlineNav/UnderlineNavItem.js +72 -56
  246. package/dist/UnderlineNav/UnderlineNavItem.module.css.js +5 -5
  247. package/dist/UnderlineNav/index.js +7 -5
  248. package/dist/UnderlineNav/styles.js +15 -11
  249. package/dist/VisuallyHidden/VisuallyHidden.js +49 -51
  250. package/dist/VisuallyHidden/VisuallyHidden.module.css.js +5 -5
  251. package/dist/_VisuallyHidden.js +62 -50
  252. package/dist/_VisuallyHidden.module.css.js +5 -5
  253. package/dist/deprecated/ActionList/Divider.js +23 -23
  254. package/dist/deprecated/ActionList/Divider.module.css.js +5 -5
  255. package/dist/deprecated/ActionList/Group.js +50 -43
  256. package/dist/deprecated/ActionList/Header.js +81 -69
  257. package/dist/deprecated/ActionList/Header.module.css.js +5 -5
  258. package/dist/deprecated/ActionList/Item.js +352 -308
  259. package/dist/deprecated/ActionList/Item.module.css.js +5 -18
  260. package/dist/deprecated/ActionList/List.js +196 -157
  261. package/dist/deprecated/ActionList/List.module.css.js +5 -5
  262. package/dist/deprecated/ActionList/index.js +14 -14
  263. package/dist/deprecated/ActionMenu.js +190 -159
  264. package/dist/deprecated/DialogV1/Dialog.js +200 -166
  265. package/dist/deprecated/DialogV1/Dialog.module.css.js +5 -11
  266. package/dist/deprecated/FilteredSearch/FilteredSearch.js +51 -43
  267. package/dist/deprecated/FilteredSearch/FilteredSearch.module.css.js +5 -5
  268. package/dist/deprecated/UnderlineNav/UnderlineNav.js +160 -132
  269. package/dist/deprecated/UnderlineNav/UnderlineNav.module.css.js +5 -14
  270. package/dist/deprecated/index.js +9 -20
  271. package/dist/experimental/IssueLabel/IssueLabel.js +158 -134
  272. package/dist/experimental/IssueLabel/IssueLabel.module.css.js +5 -5
  273. package/dist/experimental/SelectPanel2/SelectPanel.js +567 -419
  274. package/dist/experimental/SelectPanel2/SelectPanel.module.css.js +5 -32
  275. package/dist/experimental/Tabs/Tabs.js +297 -234
  276. package/dist/experimental/UnderlinePanels/UnderlinePanels.js +215 -165
  277. package/dist/experimental/UnderlinePanels/UnderlinePanels.module.css.js +5 -5
  278. package/dist/experimental/index.d.ts +2 -2
  279. package/dist/experimental/index.d.ts.map +1 -1
  280. package/dist/experimental/index.js +34 -44
  281. package/dist/hooks/useAnchoredPosition.js +144 -123
  282. package/dist/hooks/useControllableState.js +59 -34
  283. package/dist/hooks/useDetails.js +99 -84
  284. package/dist/hooks/useDialog.js +178 -140
  285. package/dist/hooks/useFocusTrap.js +71 -57
  286. package/dist/hooks/useFocusZone.js +38 -32
  287. package/dist/hooks/useId.js +16 -14
  288. package/dist/hooks/useIsMacOS.js +26 -21
  289. package/dist/hooks/useMedia.js +68 -54
  290. package/dist/hooks/useMenuInitialFocus.js +62 -65
  291. package/dist/hooks/useMenuKeyboardNavigation.js +126 -129
  292. package/dist/hooks/useMergedRefs.js +78 -63
  293. package/dist/hooks/useMnemonics.js +107 -77
  294. package/dist/hooks/useOnEscapePress.js +56 -45
  295. package/dist/hooks/useOnOutsideClick.js +63 -32
  296. package/dist/hooks/useOpenAndCloseFocus.js +43 -40
  297. package/dist/hooks/useOverflow.js +36 -32
  298. package/dist/hooks/useOverlay.js +75 -56
  299. package/dist/hooks/useProvidedRefOrCreate.js +24 -24
  300. package/dist/hooks/useProvidedStateOrCreate.js +39 -33
  301. package/dist/hooks/useRefObjectAsForwardedRef.js +32 -30
  302. package/dist/hooks/useRenderForcingRef.js +46 -42
  303. package/dist/hooks/useResizeObserver.js +43 -32
  304. package/dist/hooks/useResponsiveValue.js +57 -37
  305. package/dist/hooks/useSafeTimeout.js +29 -26
  306. package/dist/hooks/useScrollFlash.js +23 -16
  307. package/dist/hooks/useSlots.js +136 -102
  308. package/dist/hooks/useSyncedState.js +37 -31
  309. package/dist/index.d.ts +2 -2
  310. package/dist/index.d.ts.map +1 -1
  311. package/dist/index.js +86 -88
  312. package/dist/internal/components/ButtonReset.js +50 -45
  313. package/dist/internal/components/ButtonReset.module.css.js +5 -5
  314. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +105 -79
  315. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.module.css.js +5 -12
  316. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupCaption.js +21 -16
  317. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupContext.js +4 -4
  318. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupLabel.js +35 -26
  319. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupValidation.js +19 -14
  320. package/dist/internal/components/ConditionalWrapper.js +51 -41
  321. package/dist/internal/components/InputLabel.js +113 -92
  322. package/dist/internal/components/InputLabel.module.css.js +5 -8
  323. package/dist/internal/components/InputValidation.js +87 -67
  324. package/dist/internal/components/InputValidation.module.css.js +5 -9
  325. package/dist/internal/components/TextInputInnerAction.js +173 -134
  326. package/dist/internal/components/TextInputInnerAction.module.css.js +5 -9
  327. package/dist/internal/components/TextInputInnerVisualSlot.js +110 -89
  328. package/dist/internal/components/TextInputInnerVisualSlot.module.css.js +5 -11
  329. package/dist/internal/components/TextInputWrapper.js +230 -187
  330. package/dist/internal/components/TextInputWrapper.module.css.js +5 -8
  331. package/dist/internal/components/UnderlineTabbedInterface.js +238 -191
  332. package/dist/internal/components/UnderlineTabbedInterface.module.css.js +5 -11
  333. package/dist/internal/components/UnstyledTextInput.js +47 -40
  334. package/dist/internal/components/UnstyledTextInput.module.css.js +5 -5
  335. package/dist/internal/components/ValidationAnimationContainer.js +66 -55
  336. package/dist/internal/components/ValidationAnimationContainer.module.css.js +5 -8
  337. package/dist/internal/hooks/useEffectCallback.js +38 -35
  338. package/dist/internal/hooks/useEffectOnce.js +25 -23
  339. package/dist/internal/utils/getResponsiveAttributes.js +26 -23
  340. package/dist/internal/utils/hasInteractiveNodes.js +46 -34
  341. package/dist/legacy-theme/ts/color-schemes.js +4732 -4250
  342. package/dist/live-region/Announce.js +183 -144
  343. package/dist/live-region/AriaAlert.js +22 -20
  344. package/dist/live-region/AriaStatus.js +22 -20
  345. package/dist/next/index.js +1 -3
  346. package/dist/test-helpers.js +62 -40
  347. package/dist/theme.js +47 -83
  348. package/dist/utils/character-counter.js +63 -45
  349. package/dist/utils/create-component.js +16 -15
  350. package/dist/utils/descendant-registry.js +218 -182
  351. package/dist/utils/environment.js +7 -7
  352. package/dist/utils/getBreakpointDeclarations.js +10 -9
  353. package/dist/utils/invariant.js +23 -17
  354. package/dist/utils/is-slot.js +11 -10
  355. package/dist/utils/isNumeric.js +3 -3
  356. package/dist/utils/modern-polymorphic.js +20 -12
  357. package/dist/utils/scroll.js +11 -8
  358. package/dist/utils/theme.js +10 -5
  359. package/dist/utils/useIsomorphicLayoutEffect.js +9 -4
  360. package/dist/utils/warning.js +21 -14
  361. package/package.json +10 -5
  362. 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 };