@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,67 +1,47 @@
1
- import { useMedia } from './useMedia.js';
2
-
3
- // This file contains utilities for working with responsive values.
4
-
5
- // The viewport range values from @primer/primtives don't work in Chrome
6
- // because they use `em` units inside `calc()` (e.g., calc(48em - 0.02px)).
7
- // As a temporary workaround, we're hardcoding the viewport ranges in `px` units.
8
- // TODO: Use viewport range tokens from @primer/primitives
1
+ import { useMedia } from "./useMedia.js";
2
+ //#region src/hooks/useResponsiveValue.ts
9
3
  const viewportRanges = {
10
- narrow: '(max-width: calc(768px - 0.02px))',
11
- // < 768px
12
- regular: '(min-width: 768px)',
13
- // >= 768px
14
- wide: '(min-width: 1400px)' // >= 1400px
4
+ narrow: "(max-width: calc(768px - 0.02px))",
5
+ regular: "(min-width: 768px)",
6
+ wide: "(min-width: 1400px)"
15
7
  };
16
-
17
8
  /**
18
- * Flattens all possible value types into single union type
19
- * For example, if `T` is `'none' | 'line' | Responsive<'none' | 'line' | 'filled'>`,
20
- * `FlattenResponsiveValue<T>` will be `'none' | 'line' | 'filled'`
21
- */
22
-
9
+ * Flattens all possible value types into single union type
10
+ * For example, if `T` is `'none' | 'line' | Responsive<'none' | 'line' | 'filled'>`,
11
+ * `FlattenResponsiveValue<T>` will be `'none' | 'line' | 'filled'`
12
+ */
23
13
  /**
24
- * Checks if the value is a responsive value.
25
- * In other words, is it an object with viewport range keys?
26
- */
27
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
14
+ * Checks if the value is a responsive value.
15
+ * In other words, is it an object with viewport range keys?
16
+ */
28
17
  function isResponsiveValue(value) {
29
- return typeof value === 'object' && Object.keys(value).some(key => ['narrow', 'regular', 'wide'].includes(key));
18
+ return typeof value === "object" && Object.keys(value).some((key) => [
19
+ "narrow",
20
+ "regular",
21
+ "wide"
22
+ ].includes(key));
30
23
  }
31
-
32
24
  /**
33
- * Resolves responsive values based on the current viewport width.
34
- * For example, if the current viewport width is narrow (less than 768px), the value of `{regular: 'foo', narrow: 'bar'}` will resolve to `'bar'`.
35
- *
36
- * @deprecated Prefer responsive data attributes with `getResponsiveAttributes` and CSS media queries instead.
37
- *
38
- * @example
39
- * const value = useResponsiveValue({regular: 'foo', narrow: 'bar'})
40
- * console.log(value) // 'bar'
41
- */
42
- // TODO: Improve SSR support
25
+ * Resolves responsive values based on the current viewport width.
26
+ * For example, if the current viewport width is narrow (less than 768px), the value of `{regular: 'foo', narrow: 'bar'}` will resolve to `'bar'`.
27
+ *
28
+ * @deprecated Prefer responsive data attributes with `getResponsiveAttributes` and CSS media queries instead.
29
+ *
30
+ * @example
31
+ * const value = useResponsiveValue({regular: 'foo', narrow: 'bar'})
32
+ * console.log(value) // 'bar'
33
+ */
43
34
  function useResponsiveValue(value, fallback) {
44
- const isNarrowViewport = useMedia(viewportRanges.narrow, false);
45
- const isRegularViewport = useMedia(viewportRanges.regular, false);
46
- const isWideViewport = useMedia(viewportRanges.wide, false);
47
- if (isResponsiveValue(value)) {
48
- const responsiveValue = value;
49
- if (isNarrowViewport && "narrow" in responsiveValue) {
50
- return responsiveValue.narrow;
51
- } else {
52
- if (isWideViewport && "wide" in responsiveValue) {
53
- return responsiveValue.wide;
54
- } else {
55
- if (isRegularViewport && "regular" in responsiveValue) {
56
- return responsiveValue.regular;
57
- } else {
58
- return fallback;
59
- }
60
- }
61
- }
62
- } else {
63
- return value;
64
- }
35
+ const isNarrowViewport = useMedia(viewportRanges.narrow, false);
36
+ const isRegularViewport = useMedia(viewportRanges.regular, false);
37
+ const isWideViewport = useMedia(viewportRanges.wide, false);
38
+ if (isResponsiveValue(value)) {
39
+ const responsiveValue = value;
40
+ if (isNarrowViewport && "narrow" in responsiveValue) return responsiveValue.narrow;
41
+ else if (isWideViewport && "wide" in responsiveValue) return responsiveValue.wide;
42
+ else if (isRegularViewport && "regular" in responsiveValue) return responsiveValue.regular;
43
+ else return fallback;
44
+ } else return value;
65
45
  }
66
-
46
+ //#endregion
67
47
  export { isResponsiveValue, useResponsiveValue, viewportRanges };
@@ -1,33 +1,30 @@
1
- import { useRef, useCallback, useEffect } from 'react';
2
-
1
+ import { useCallback, useEffect, useRef } from "react";
2
+ //#region src/hooks/useSafeTimeout.ts
3
3
  /**
4
- * Safely call `setTimeout` and `clearTimeout` within a component.
5
- *
6
- * This hook ensures that all timeouts are cleared when the component unmounts.
7
- */
4
+ * Safely call `setTimeout` and `clearTimeout` within a component.
5
+ *
6
+ * This hook ensures that all timeouts are cleared when the component unmounts.
7
+ */
8
8
  function useSafeTimeout() {
9
- const timers = useRef(new Set());
10
- const safeSetTimeout = useCallback((handler, timeout, ...args) => {
11
- const id = window.setTimeout(handler, timeout, ...args);
12
- timers.current.add(id);
13
- return id;
14
- }, []);
15
- const safeClearTimeout = useCallback(id => {
16
- clearTimeout(id);
17
- timers.current.delete(id);
18
- }, []);
19
- useEffect(() => {
20
- return () => {
21
- // eslint-disable-next-line react-hooks/exhaustive-deps
22
- for (const id of timers.current) {
23
- clearTimeout(id);
24
- }
25
- };
26
- }, []);
27
- return {
28
- safeSetTimeout,
29
- safeClearTimeout
30
- };
9
+ const timers = useRef(/* @__PURE__ */ new Set());
10
+ const safeSetTimeout = useCallback((handler, timeout, ...args) => {
11
+ const id = window.setTimeout(handler, timeout, ...args);
12
+ timers.current.add(id);
13
+ return id;
14
+ }, []);
15
+ const safeClearTimeout = useCallback((id) => {
16
+ clearTimeout(id);
17
+ timers.current.delete(id);
18
+ }, []);
19
+ useEffect(() => {
20
+ return () => {
21
+ for (const id of timers.current) clearTimeout(id);
22
+ };
23
+ }, []);
24
+ return {
25
+ safeSetTimeout,
26
+ safeClearTimeout
27
+ };
31
28
  }
32
-
29
+ //#endregion
33
30
  export { useSafeTimeout as default };
@@ -1,27 +1,20 @@
1
- import { useEffect } from 'react';
2
-
1
+ import { useEffect } from "react";
2
+ //#region src/hooks/useScrollFlash.ts
3
3
  /**
4
- * This hook will flash the scrollbars for a ref of a container that has scrollable overflow
5
- * @param scrollContainerRef The ref of the scrollable content
6
- */
4
+ * This hook will flash the scrollbars for a ref of a container that has scrollable overflow
5
+ * @param scrollContainerRef The ref of the scrollable content
6
+ */
7
7
  function useScrollFlash(scrollContainerRef) {
8
- // https://adxlv.computer/projects/flash-scrollers/
9
- useEffect(() => {
10
- const scrollContainer = scrollContainerRef.current;
11
- if (!scrollContainer) {
12
- return;
13
- }
14
-
15
- // Defer to the next frame to avoid forcing a synchronous reflow
16
- // when the effect runs immediately after React commits DOM changes.
17
- const id = requestAnimationFrame(() => {
18
- const currentScroll = scrollContainer.scrollTop;
19
- const altScroll = currentScroll < 1 ? currentScroll + 1 : currentScroll - 1;
20
- scrollContainer.scrollTop = altScroll;
21
- scrollContainer.scrollTop = currentScroll;
22
- });
23
- return () => cancelAnimationFrame(id);
24
- }, [scrollContainerRef]);
8
+ useEffect(() => {
9
+ const scrollContainer = scrollContainerRef.current;
10
+ if (!scrollContainer) return;
11
+ const id = requestAnimationFrame(() => {
12
+ const currentScroll = scrollContainer.scrollTop;
13
+ scrollContainer.scrollTop = currentScroll < 1 ? currentScroll + 1 : currentScroll - 1;
14
+ scrollContainer.scrollTop = currentScroll;
15
+ });
16
+ return () => cancelAnimationFrame(id);
17
+ }, [scrollContainerRef]);
25
18
  }
26
-
19
+ //#endregion
27
20
  export { useScrollFlash as default };
@@ -1,150 +1,116 @@
1
- import React from 'react';
2
- import { warning } from '../utils/warning.js';
3
- import { isSlot } from '../utils/is-slot.js';
4
-
1
+ import { warning } from "../utils/warning.js";
2
+ import { isSlot } from "../utils/is-slot.js";
3
+ import React from "react";
4
+ //#region src/hooks/useSlots.ts
5
5
  /**
6
- * useSlots - Extract slot components from children for SSR-compatible slot APIs.
7
- *
8
- * Given a list of children and a config mapping slot names to component types,
9
- * separates children into two groups: matched slots and the rest.
10
- *
11
- * Config: { leadingVisual: LeadingVisual, description: Description }
12
- *
13
- * Children: Matching: Output:
14
- * +----------------+ slots = {
15
- * | LeadingVisual | -> matches slot 0 --> leadingVisual: <LeadingVisual />
16
- * | "Project name" | -> no match --> description: <Description />
17
- * | Description | -> matches slot 1 --> }
18
- * | TrailingVisual | -> no match --> rest = ["Project name", <TrailingVisual />]
19
- * +----------------+
20
- *
21
- * Performance-sensitive: called per item in lists (e.g. 100-item ActionList
22
- * calls this 101 times per render).
23
- *
24
- * Once all slots are filled, remaining children skip matching entirely in
25
- * production (single integer comparison). In dev, we still scan for duplicates
26
- * to emit a warning.
27
- *
28
- * Flow per child:
29
- *
30
- * child ──> isValidElement? ──no──> rest[]
31
- * |
32
- * yes
33
- * |
34
- * v
35
- * all slots filled? ──yes──> rest[] (prod)
36
- * | |
37
- * no [dev: check for
38
- * | duplicate warning]
39
- * v
40
- * match against unfilled slots
41
- * |
42
- * found match? ──no──> rest[]
43
- * |
44
- * yes
45
- * |
46
- * v
47
- * slots[key] = child, slotsFound++
48
- *
49
- * Slot config supports two matcher styles:
50
- * 1. Component reference: { visual: LeadingVisual }
51
- * 2. Component + test fn: { block: [Description, props => props.variant === 'block'] }
52
- */
53
-
54
- // --- Types ---
55
-
56
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
57
-
58
- // --- Matching ---
59
-
6
+ * useSlots - Extract slot components from children for SSR-compatible slot APIs.
7
+ *
8
+ * Given a list of children and a config mapping slot names to component types,
9
+ * separates children into two groups: matched slots and the rest.
10
+ *
11
+ * Config: { leadingVisual: LeadingVisual, description: Description }
12
+ *
13
+ * Children: Matching: Output:
14
+ * +----------------+ slots = {
15
+ * | LeadingVisual | -> matches slot 0 --> leadingVisual: <LeadingVisual />
16
+ * | "Project name" | -> no match --> description: <Description />
17
+ * | Description | -> matches slot 1 --> }
18
+ * | TrailingVisual | -> no match --> rest = ["Project name", <TrailingVisual />]
19
+ * +----------------+
20
+ *
21
+ * Performance-sensitive: called per item in lists (e.g. 100-item ActionList
22
+ * calls this 101 times per render).
23
+ *
24
+ * Once all slots are filled, remaining children skip matching entirely in
25
+ * production (single integer comparison). In dev, we still scan for duplicates
26
+ * to emit a warning.
27
+ *
28
+ * Flow per child:
29
+ *
30
+ * child ──> isValidElement? ──no──> rest[]
31
+ * |
32
+ * yes
33
+ * |
34
+ * v
35
+ * all slots filled? ──yes──> rest[] (prod)
36
+ * | |
37
+ * no [dev: check for
38
+ * | duplicate warning]
39
+ * v
40
+ * match against unfilled slots
41
+ * |
42
+ * found match? ──no──> rest[]
43
+ * |
44
+ * yes
45
+ * |
46
+ * v
47
+ * slots[key] = child, slotsFound++
48
+ *
49
+ * Slot config supports two matcher styles:
50
+ * 1. Component reference: { visual: LeadingVisual }
51
+ * 2. Component + test fn: { block: [Description, props => props.variant === 'block'] }
52
+ */
60
53
  /** Check if a child element matches a slot config entry, either by direct type comparison or slot symbol. */
61
54
  function childMatchesSlot(child, slotValue) {
62
- if (Array.isArray(slotValue)) {
63
- const [component, testFn] = slotValue;
64
- return (child.type === component || isSlot(child, component)) && testFn(child.props);
65
- }
66
- return child.type === slotValue || isSlot(child, slotValue);
55
+ if (Array.isArray(slotValue)) {
56
+ const [component, testFn] = slotValue;
57
+ return (child.type === component || isSlot(child, component)) && testFn(child.props);
58
+ }
59
+ return child.type === slotValue || isSlot(child, slotValue);
67
60
  }
68
-
69
- // --- Hook ---
70
-
71
61
  /** Extract slot components from children. See file header for details. */
72
62
  function useSlots(children, config) {
73
- const rest = [];
74
- const keys = Object.keys(config);
75
- const values = Object.values(config);
76
- const totalSlots = keys.length;
77
-
78
- // Initialize all slot keys to undefined so callers can check `slots.x === undefined`
79
- const slots = {};
80
- for (let i = 0; i < totalSlots; i++) {
81
- slots[keys[i]] = undefined;
82
- }
83
- let slotsFound = 0;
84
-
85
- // eslint-disable-next-line github/array-foreach
86
- React.Children.forEach(children, child => {
87
- if (! /*#__PURE__*/React.isValidElement(child)) {
88
- rest.push(child);
89
- return;
90
- }
91
-
92
- // Short-circuit: all slots filled, no more matching needed
93
- if (slotsFound === totalSlots) {
94
- if (process.env.NODE_ENV !== "production" && warnIfDuplicate(child, keys, values, totalSlots)) {
95
- return;
96
- }
97
- rest.push(child);
98
- return;
99
- }
100
-
101
- // Try to match child against a slot
102
- const matchedIndex = findMatchingSlot(child, values, totalSlots);
103
- if (matchedIndex === -1) {
104
- rest.push(child);
105
- return;
106
- }
107
- const slotKey = keys[matchedIndex];
108
-
109
- // Duplicate: slot already filled by an earlier child
110
- if (slots[slotKey] !== undefined) {
111
- if (process.env.NODE_ENV !== "production") {
112
- process.env.NODE_ENV !== "production" ? warning(true, `Found duplicate "${String(slotKey)}" slot. Only the first will be rendered.`) : void 0;
113
- }
114
- return;
115
- }
116
- slots[slotKey] = child;
117
- slotsFound++;
118
- });
119
- return [slots, rest];
63
+ const rest = [];
64
+ const keys = Object.keys(config);
65
+ const values = Object.values(config);
66
+ const totalSlots = keys.length;
67
+ const slots = {};
68
+ for (let i = 0; i < totalSlots; i++) slots[keys[i]] = void 0;
69
+ let slotsFound = 0;
70
+ React.Children.forEach(children, (child) => {
71
+ if (!/* @__PURE__ */ React.isValidElement(child)) {
72
+ rest.push(child);
73
+ return;
74
+ }
75
+ if (slotsFound === totalSlots) {
76
+ if (warnIfDuplicate(child, keys, values, totalSlots)) return;
77
+ rest.push(child);
78
+ return;
79
+ }
80
+ const matchedIndex = findMatchingSlot(child, values, totalSlots);
81
+ if (matchedIndex === -1) {
82
+ rest.push(child);
83
+ return;
84
+ }
85
+ const slotKey = keys[matchedIndex];
86
+ if (slots[slotKey] !== void 0) {
87
+ warning(true, `Found duplicate "${String(slotKey)}" slot. Only the first will be rendered.`);
88
+ return;
89
+ }
90
+ slots[slotKey] = child;
91
+ slotsFound++;
92
+ });
93
+ return [slots, rest];
120
94
  }
121
-
122
- // --- Helpers ---
123
-
124
95
  /**
125
- * Find the first slot config entry matching this child.
126
- * Returns the config index, or -1 if no match.
127
- */
96
+ * Find the first slot config entry matching this child.
97
+ * Returns the config index, or -1 if no match.
98
+ */
128
99
  function findMatchingSlot(child, values, totalSlots) {
129
- for (let i = 0; i < totalSlots; i++) {
130
- if (childMatchesSlot(child, values[i])) return i;
131
- }
132
- return -1;
100
+ for (let i = 0; i < totalSlots; i++) if (childMatchesSlot(child, values[i])) return i;
101
+ return -1;
133
102
  }
134
-
135
103
  /**
136
- * Dev-only: check if a child duplicates an already-filled slot.
137
- * Returns true (and warns) if a duplicate is found, false otherwise.
138
- * Used in the short-circuit path where all slots are already filled.
139
- */
104
+ * Dev-only: check if a child duplicates an already-filled slot.
105
+ * Returns true (and warns) if a duplicate is found, false otherwise.
106
+ * Used in the short-circuit path where all slots are already filled.
107
+ */
140
108
  function warnIfDuplicate(child, keys, values, totalSlots) {
141
- for (let i = 0; i < totalSlots; i++) {
142
- if (childMatchesSlot(child, values[i])) {
143
- process.env.NODE_ENV !== "production" ? warning(true, `Found duplicate "${String(keys[i])}" slot. Only the first will be rendered.`) : void 0;
144
- return true;
145
- }
146
- }
147
- return false;
109
+ for (let i = 0; i < totalSlots; i++) if (childMatchesSlot(child, values[i])) {
110
+ warning(true, `Found duplicate "${String(keys[i])}" slot. Only the first will be rendered.`);
111
+ return true;
112
+ }
113
+ return false;
148
114
  }
149
-
115
+ //#endregion
150
116
  export { useSlots };
@@ -1,41 +1,35 @@
1
- import { c } from 'react-compiler-runtime';
2
- import { useState } from 'react';
3
-
1
+ import { c } from "react-compiler-runtime";
2
+ import { useState } from "react";
3
+ //#region src/hooks/useSyncedState.tsx
4
4
  /**
5
- * When the value that initialized the state changes
6
- * this hook will update the state to the new value, immediately.
7
- *
8
- * This uses an Object.is comparison to determine if the value has changed by default
9
- *
10
- * If you use a non-primitive value as the initial value, you should provide a custom isEqual function
11
- *
12
- * This is adapted almost directly from https://beta.reactjs.org/learn/you-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes
13
- */
14
-
5
+ * When the value that initialized the state changes
6
+ * this hook will update the state to the new value, immediately.
7
+ *
8
+ * This uses an Object.is comparison to determine if the value has changed by default
9
+ *
10
+ * If you use a non-primitive value as the initial value, you should provide a custom isEqual function
11
+ *
12
+ * This is adapted almost directly from https://beta.reactjs.org/learn/you-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes
13
+ */
15
14
  const useSyncedState = (initialValue, t0) => {
16
- const $ = c(2);
17
- const {
18
- isPropUpdateDisabled: t1,
19
- isEqual: t2
20
- } = t0 === undefined ? {} : t0;
21
- const isPropUpdateDisabled = t1 === undefined ? false : t1;
22
- const isEqual = t2 === undefined ? Object.is : t2;
23
- const [state, setState] = useState(initialValue);
24
- const [previous, setPrevious] = useState(initialValue);
25
- const nextInitialValue = initialValue instanceof Function ? initialValue() : initialValue;
26
- if (!isPropUpdateDisabled && !isEqual(previous, nextInitialValue)) {
27
- setPrevious(nextInitialValue);
28
- setState(nextInitialValue);
29
- }
30
- let t3;
31
- if ($[0] !== state) {
32
- t3 = [state, setState];
33
- $[0] = state;
34
- $[1] = t3;
35
- } else {
36
- t3 = $[1];
37
- }
38
- return t3;
15
+ const $ = c(2);
16
+ const { isPropUpdateDisabled: t1, isEqual: t2 } = t0 === void 0 ? {} : t0;
17
+ const isPropUpdateDisabled = t1 === void 0 ? false : t1;
18
+ const isEqual = t2 === void 0 ? Object.is : t2;
19
+ const [state, setState] = useState(initialValue);
20
+ const [previous, setPrevious] = useState(initialValue);
21
+ const nextInitialValue = initialValue instanceof Function ? initialValue() : initialValue;
22
+ if (!isPropUpdateDisabled && !isEqual(previous, nextInitialValue)) {
23
+ setPrevious(nextInitialValue);
24
+ setState(nextInitialValue);
25
+ }
26
+ let t3;
27
+ if ($[0] !== state) {
28
+ t3 = [state, setState];
29
+ $[0] = state;
30
+ $[1] = t3;
31
+ } else t3 = $[1];
32
+ return t3;
39
33
  };
40
-
34
+ //#endregion
41
35
  export { useSyncedState };