@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.
- package/CHANGELOG.md +10 -6
- package/dist/ActionBar/ActionBar.js +502 -705
- package/dist/ActionBar/ActionBar.module.css.js +10 -5
- package/dist/ActionBar/index.js +8 -8
- package/dist/ActionList/ActionList.module.css.js +31 -5
- package/dist/ActionList/ActionListContainerContext.js +4 -5
- package/dist/ActionList/Description.js +117 -133
- package/dist/ActionList/Divider.js +31 -38
- package/dist/ActionList/Group.js +292 -349
- package/dist/ActionList/Group.module.css.js +10 -5
- package/dist/ActionList/Heading.js +88 -106
- package/dist/ActionList/Heading.module.css.js +5 -5
- package/dist/ActionList/Item.js +668 -811
- package/dist/ActionList/LinkItem.js +36 -56
- package/dist/ActionList/List.js +168 -210
- package/dist/ActionList/Selection.js +83 -112
- package/dist/ActionList/TrailingAction.js +97 -112
- package/dist/ActionList/Visuals.js +143 -191
- package/dist/ActionList/index.js +33 -33
- package/dist/ActionList/shared.js +5 -9
- package/dist/ActionMenu/ActionMenu.js +223 -310
- package/dist/ActionMenu/ActionMenu.module.css.js +5 -5
- package/dist/AnchoredOverlay/AnchoredOverlay.d.ts.map +1 -1
- package/dist/AnchoredOverlay/AnchoredOverlay.js +206 -298
- package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +9 -5
- package/dist/Autocomplete/Autocomplete.js +125 -141
- package/dist/Autocomplete/AutocompleteContext.js +18 -20
- package/dist/Autocomplete/AutocompleteInput.js +108 -146
- package/dist/Autocomplete/AutocompleteMenu.js +201 -238
- package/dist/Autocomplete/AutocompleteMenu.module.css.js +8 -5
- package/dist/Autocomplete/AutocompleteOverlay.js +54 -79
- package/dist/Autocomplete/AutocompleteOverlay.module.css.js +5 -5
- package/dist/Avatar/Avatar.js +106 -133
- package/dist/Avatar/Avatar.module.css.js +5 -5
- package/dist/AvatarStack/AvatarStack.js +102 -143
- package/dist/AvatarStack/AvatarStack.module.css.js +9 -5
- package/dist/Banner/Banner.js +133 -186
- package/dist/Banner/Banner.module.css.js +14 -5
- package/dist/Banner/index.js +7 -7
- package/dist/BaseStyles.js +74 -91
- package/dist/BaseStyles.module.css.js +5 -5
- package/dist/Blankslate/Blankslate.js +266 -328
- package/dist/Blankslate/Blankslate.module.css.js +12 -5
- package/dist/Blankslate/BlankslateContext.js +7 -9
- package/dist/Blankslate/index.js +9 -9
- package/dist/BranchName/BranchName.js +49 -59
- package/dist/BranchName/BranchName.module.css.js +5 -5
- package/dist/Breadcrumbs/Breadcrumbs.js +371 -431
- package/dist/Breadcrumbs/Breadcrumbs.module.css.js +15 -5
- package/dist/Button/Button.js +15 -18
- package/dist/Button/ButtonBase.js +76 -139
- package/dist/Button/ButtonBase.module.css.js +16 -5
- package/dist/Button/IconButton.js +42 -74
- package/dist/Button/LinkButton.js +13 -17
- package/dist/ButtonGroup/ButtonGroup.js +80 -97
- package/dist/ButtonGroup/ButtonGroup.module.css.js +5 -5
- package/dist/Card/Card.js +401 -491
- package/dist/Card/Card.module.css.js +18 -5
- package/dist/Card/index.js +9 -9
- package/dist/Checkbox/Checkbox.js +52 -71
- package/dist/Checkbox/Checkbox.module.css.js +9 -5
- package/dist/Checkbox/shared.module.css.js +5 -5
- package/dist/CheckboxGroup/CheckboxGroup.js +111 -132
- package/dist/CheckboxGroup/CheckboxGroupContext.js +4 -4
- package/dist/CircleBadge/CircleBadge.js +77 -90
- package/dist/CircleBadge/CircleBadge.module.css.js +8 -5
- package/dist/ConfirmationDialog/ConfirmationDialog.js +68 -92
- package/dist/CounterLabel/CounterLabel.js +83 -99
- package/dist/CounterLabel/CounterLabel.module.css.js +5 -5
- package/dist/DataTable/DataTable.js +100 -140
- package/dist/DataTable/ErrorDialog.js +33 -45
- package/dist/DataTable/Pagination.js +464 -592
- package/dist/DataTable/Pagination.module.css.js +13 -5
- package/dist/DataTable/Table.js +527 -710
- package/dist/DataTable/Table.module.css.js +26 -5
- package/dist/DataTable/column.js +10 -11
- package/dist/DataTable/index.js +22 -20
- package/dist/DataTable/sorting.js +65 -103
- package/dist/DataTable/useTable.js +207 -290
- package/dist/Details/Details.js +100 -126
- package/dist/Details/Details.module.css.js +5 -5
- package/dist/Dialog/Dialog.js +259 -351
- package/dist/Dialog/Dialog.module.css.js +22 -5
- package/dist/FeatureFlags/DefaultFeatureFlags.js +7 -7
- package/dist/FeatureFlags/FeatureFlagContext.js +5 -5
- package/dist/FeatureFlags/FeatureFlagScope.js +36 -44
- package/dist/FeatureFlags/FeatureFlags.js +29 -37
- package/dist/FeatureFlags/useFeatureFlag.js +17 -19
- package/dist/FilteredActionList/FilteredActionList.js +454 -579
- package/dist/FilteredActionList/FilteredActionList.module.css.js +15 -5
- package/dist/FilteredActionList/FilteredActionListLoaders.js +119 -150
- package/dist/FilteredActionList/FilteredActionListLoaders.module.css.js +9 -5
- package/dist/FilteredActionList/useAnnouncements.js +167 -180
- package/dist/Flash/Flash.js +57 -69
- package/dist/Flash/Flash.module.css.js +5 -5
- package/dist/FormControl/FormControl.js +211 -227
- package/dist/FormControl/FormControl.module.css.js +11 -5
- package/dist/FormControl/FormControlCaption.js +37 -49
- package/dist/FormControl/FormControlCaption.module.css.js +5 -5
- package/dist/FormControl/FormControlLabel.js +95 -115
- package/dist/FormControl/FormControlLeadingVisual.js +29 -37
- package/dist/FormControl/FormControlLeadingVisual.module.css.js +5 -5
- package/dist/FormControl/_FormControlContext.js +41 -48
- package/dist/FormControl/_FormControlValidation.js +29 -39
- package/dist/Header/Header.js +138 -165
- package/dist/Header/Header.module.css.js +9 -5
- package/dist/Heading/Heading.js +26 -37
- package/dist/Heading/Heading.module.css.js +5 -5
- package/dist/Hidden/Hidden.js +54 -77
- package/dist/Hidden/Hidden.module.css.js +5 -5
- package/dist/InlineMessage/InlineMessage.js +88 -116
- package/dist/InlineMessage/InlineMessage.module.css.js +8 -5
- package/dist/KeybindingHint/KeybindingHint.js +70 -88
- package/dist/KeybindingHint/KeybindingHint.module.css.js +5 -5
- package/dist/KeybindingHint/components/Chord.js +81 -93
- package/dist/KeybindingHint/components/Chord.module.css.js +11 -5
- package/dist/KeybindingHint/components/Key.js +49 -66
- package/dist/KeybindingHint/components/Sequence.js +12 -24
- package/dist/KeybindingHint/key-names.js +99 -114
- package/dist/Label/Label.js +56 -66
- package/dist/Label/Label.module.css.js +5 -5
- package/dist/Label/index.js +5 -5
- package/dist/LabelGroup/LabelGroup.js +260 -344
- package/dist/LabelGroup/LabelGroup.module.css.js +12 -5
- package/dist/Link/Link.js +31 -47
- package/dist/Link/Link.module.css.js +5 -5
- package/dist/NavList/NavList.js +424 -614
- package/dist/NavList/NavList.module.css.js +5 -5
- package/dist/Octicon/Octicon.js +35 -37
- package/dist/Overlay/Overlay.js +264 -318
- package/dist/Overlay/Overlay.module.css.js +8 -5
- package/dist/PageHeader/PageHeader.js +579 -823
- package/dist/PageHeader/PageHeader.module.css.js +21 -5
- package/dist/PageLayout/PageLayout.js +631 -913
- package/dist/PageLayout/PageLayout.module.css.js +31 -5
- package/dist/PageLayout/paneUtils.js +15 -29
- package/dist/PageLayout/usePaneWidth.js +334 -437
- package/dist/Pagehead/Pagehead.js +10 -14
- package/dist/Pagehead/Pagehead.module.css.js +5 -5
- package/dist/Pagination/Pagination.js +84 -114
- package/dist/Pagination/Pagination.module.css.js +9 -5
- package/dist/Pagination/index.js +5 -5
- package/dist/Pagination/model.js +118 -194
- package/dist/Popover/Popover.js +126 -151
- package/dist/Popover/Popover.module.css.js +8 -5
- package/dist/Portal/Portal.js +65 -85
- package/dist/Portal/index.js +5 -6
- package/dist/ProgressBar/ProgressBar.js +210 -255
- package/dist/ProgressBar/ProgressBar.module.css.js +9 -5
- package/dist/ProgressBar/index.js +6 -8
- package/dist/Radio/Radio.js +97 -115
- package/dist/Radio/Radio.module.css.js +5 -5
- package/dist/RadioGroup/RadioGroup.js +99 -118
- package/dist/RelativeTime/RelativeTime.js +64 -76
- package/dist/ScrollableRegion/ScrollableRegion.js +67 -79
- package/dist/ScrollableRegion/ScrollableRegion.module.css.js +5 -5
- package/dist/SegmentedControl/SegmentedControl.js +238 -287
- package/dist/SegmentedControl/SegmentedControl.module.css.js +15 -5
- package/dist/SegmentedControl/SegmentedControlButton.js +156 -187
- package/dist/SegmentedControl/SegmentedControlIconButton.js +133 -161
- package/dist/Select/Select.js +185 -234
- package/dist/Select/Select.module.css.js +10 -5
- package/dist/SelectPanel/SelectPanel.js +620 -828
- package/dist/SelectPanel/SelectPanel.module.css.js +27 -5
- package/dist/SelectPanel/SelectPanelMessage.js +37 -39
- package/dist/SideNav.js +24 -47
- package/dist/SideNav.module.css.js +12 -5
- package/dist/Skeleton/SkeletonBox.js +94 -111
- package/dist/Skeleton/SkeletonBox.module.css.js +8 -5
- package/dist/SkeletonAvatar/SkeletonAvatar.js +95 -120
- package/dist/SkeletonAvatar/SkeletonAvatar.module.css.js +5 -5
- package/dist/SkeletonText/SkeletonText.js +114 -137
- package/dist/SkeletonText/SkeletonText.module.css.js +8 -5
- package/dist/Spinner/Spinner.js +183 -211
- package/dist/Spinner/Spinner.module.css.js +9 -5
- package/dist/SplitPageLayout/SplitPageLayout.js +215 -276
- package/dist/Stack/Stack.js +207 -255
- package/dist/Stack/Stack.module.css.js +8 -5
- package/dist/Stack/index.js +4 -6
- package/dist/StateLabel/StateLabel.js +110 -123
- package/dist/StateLabel/StateLabel.module.css.js +8 -5
- package/dist/SubNav/SubNav.js +159 -197
- package/dist/SubNav/SubNav.module.css.js +11 -5
- package/dist/TabNav/TabNav.js +167 -199
- package/dist/TabNav/TabNav.module.css.js +10 -5
- package/dist/Text/Text.js +56 -67
- package/dist/Text/Text.module.css.js +5 -5
- package/dist/TextInput/TextInput.js +195 -228
- package/dist/TextInput/TextInput.module.css.js +8 -5
- package/dist/TextInputWithTokens/TextInputWithTokens.js +567 -673
- package/dist/TextInputWithTokens/TextInputWithTokens.module.css.js +14 -5
- package/dist/Textarea/TextArea.module.css.js +9 -5
- package/dist/Textarea/Textarea.js +264 -294
- package/dist/ThemeProvider.js +199 -257
- package/dist/Timeline/Timeline.js +204 -247
- package/dist/Timeline/Timeline.module.css.js +12 -5
- package/dist/ToggleSwitch/ToggleSwitch.js +403 -471
- package/dist/ToggleSwitch/ToggleSwitch.module.css.js +16 -5
- package/dist/Token/IssueLabelToken.js +256 -297
- package/dist/Token/IssueLabelToken.module.css.js +8 -5
- package/dist/Token/Token.js +232 -280
- package/dist/Token/Token.module.css.js +9 -5
- package/dist/Token/TokenBase.js +99 -126
- package/dist/Token/TokenBase.module.css.js +5 -5
- package/dist/Token/_RemoveTokenButton.js +27 -48
- package/dist/Token/_RemoveTokenButton.module.css.js +5 -5
- package/dist/Token/_TokenTextContainer.js +54 -65
- package/dist/Token/_TokenTextContainer.module.css.js +5 -5
- package/dist/Tooltip/Tooltip.js +49 -56
- package/dist/Tooltip/Tooltip.module.css.js +20 -5
- package/dist/TooltipV2/Tooltip.js +222 -305
- package/dist/TooltipV2/Tooltip.module.css.js +11 -5
- package/dist/TopicTag/TopicTag.js +46 -55
- package/dist/TopicTag/TopicTag.module.css.js +5 -5
- package/dist/TopicTag/TopicTagGroup.js +40 -48
- package/dist/TopicTag/TopicTagGroup.module.css.js +5 -5
- package/dist/TopicTag/index.js +5 -7
- package/dist/TreeView/TreeView.js +1082 -1414
- package/dist/TreeView/TreeView.module.css.js +24 -5
- package/dist/TreeView/shared.js +10 -9
- package/dist/TreeView/useRovingTabIndex.js +129 -203
- package/dist/TreeView/useTreeItemCache.js +64 -79
- package/dist/TreeView/useTypeahead.js +90 -112
- package/dist/Truncate/Truncate.js +21 -33
- package/dist/Truncate/Truncate.module.css.js +5 -5
- package/dist/UnderlineNav/UnderlineNav.js +278 -375
- package/dist/UnderlineNav/UnderlineNav.module.css.js +8 -5
- package/dist/UnderlineNav/UnderlineNavContext.js +8 -8
- package/dist/UnderlineNav/UnderlineNavItem.js +56 -72
- package/dist/UnderlineNav/UnderlineNavItem.module.css.js +5 -5
- package/dist/UnderlineNav/index.js +5 -7
- package/dist/UnderlineNav/styles.js +11 -15
- package/dist/VisuallyHidden/VisuallyHidden.js +51 -49
- package/dist/VisuallyHidden/VisuallyHidden.module.css.js +5 -5
- package/dist/_VisuallyHidden.js +50 -62
- package/dist/_VisuallyHidden.module.css.js +5 -5
- package/dist/deprecated/ActionList/Divider.js +23 -23
- package/dist/deprecated/ActionList/Divider.module.css.js +5 -5
- package/dist/deprecated/ActionList/Group.js +43 -50
- package/dist/deprecated/ActionList/Header.js +69 -81
- package/dist/deprecated/ActionList/Header.module.css.js +5 -5
- package/dist/deprecated/ActionList/Item.js +308 -352
- package/dist/deprecated/ActionList/Item.module.css.js +18 -5
- package/dist/deprecated/ActionList/List.js +157 -196
- package/dist/deprecated/ActionList/List.module.css.js +5 -5
- package/dist/deprecated/ActionList/index.js +14 -14
- package/dist/deprecated/ActionMenu.js +159 -190
- package/dist/deprecated/DialogV1/Dialog.js +166 -200
- package/dist/deprecated/DialogV1/Dialog.module.css.js +11 -5
- package/dist/deprecated/FilteredSearch/FilteredSearch.js +43 -51
- package/dist/deprecated/FilteredSearch/FilteredSearch.module.css.js +5 -5
- package/dist/deprecated/UnderlineNav/UnderlineNav.js +132 -160
- package/dist/deprecated/UnderlineNav/UnderlineNav.module.css.js +14 -5
- package/dist/deprecated/index.js +20 -9
- package/dist/experimental/IssueLabel/IssueLabel.js +134 -158
- package/dist/experimental/IssueLabel/IssueLabel.module.css.js +5 -5
- package/dist/experimental/SelectPanel2/SelectPanel.js +419 -567
- package/dist/experimental/SelectPanel2/SelectPanel.module.css.js +32 -5
- package/dist/experimental/Tabs/Tabs.js +234 -297
- package/dist/experimental/UnderlinePanels/UnderlinePanels.js +165 -215
- package/dist/experimental/UnderlinePanels/UnderlinePanels.module.css.js +5 -5
- package/dist/experimental/index.js +44 -33
- package/dist/hooks/useAnchoredPosition.d.ts +0 -6
- package/dist/hooks/useAnchoredPosition.d.ts.map +1 -1
- package/dist/hooks/useAnchoredPosition.js +123 -130
- package/dist/hooks/useControllableState.js +34 -59
- package/dist/hooks/useDetails.js +84 -99
- package/dist/hooks/useDialog.js +140 -178
- package/dist/hooks/useFocusTrap.js +57 -71
- package/dist/hooks/useFocusZone.js +32 -38
- package/dist/hooks/useId.js +14 -16
- package/dist/hooks/useIsMacOS.js +21 -26
- package/dist/hooks/useMedia.js +54 -68
- package/dist/hooks/useMenuInitialFocus.js +65 -62
- package/dist/hooks/useMenuKeyboardNavigation.js +129 -126
- package/dist/hooks/useMergedRefs.js +63 -78
- package/dist/hooks/useMnemonics.js +77 -107
- package/dist/hooks/useOnEscapePress.js +45 -56
- package/dist/hooks/useOnOutsideClick.js +32 -63
- package/dist/hooks/useOpenAndCloseFocus.js +40 -43
- package/dist/hooks/useOverflow.js +32 -36
- package/dist/hooks/useOverlay.js +56 -75
- package/dist/hooks/useProvidedRefOrCreate.js +24 -24
- package/dist/hooks/useProvidedStateOrCreate.js +33 -39
- package/dist/hooks/useRefObjectAsForwardedRef.js +30 -32
- package/dist/hooks/useRenderForcingRef.js +42 -46
- package/dist/hooks/useResizeObserver.js +32 -43
- package/dist/hooks/useResponsiveValue.js +37 -57
- package/dist/hooks/useSafeTimeout.js +26 -29
- package/dist/hooks/useScrollFlash.js +16 -23
- package/dist/hooks/useSlots.js +102 -136
- package/dist/hooks/useSyncedState.js +31 -37
- package/dist/index.js +88 -85
- package/dist/internal/components/ButtonReset.js +45 -50
- package/dist/internal/components/ButtonReset.module.css.js +5 -5
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +79 -105
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.module.css.js +12 -5
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupCaption.js +16 -21
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupContext.js +4 -4
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupLabel.js +26 -35
- package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroupValidation.js +14 -19
- package/dist/internal/components/ConditionalWrapper.js +41 -51
- package/dist/internal/components/InputLabel.js +92 -113
- package/dist/internal/components/InputLabel.module.css.js +8 -5
- package/dist/internal/components/InputValidation.js +67 -87
- package/dist/internal/components/InputValidation.module.css.js +9 -5
- package/dist/internal/components/TextInputInnerAction.js +134 -173
- package/dist/internal/components/TextInputInnerAction.module.css.js +9 -5
- package/dist/internal/components/TextInputInnerVisualSlot.js +89 -110
- package/dist/internal/components/TextInputInnerVisualSlot.module.css.js +11 -5
- package/dist/internal/components/TextInputWrapper.js +187 -230
- package/dist/internal/components/TextInputWrapper.module.css.js +8 -5
- package/dist/internal/components/UnderlineTabbedInterface.js +191 -238
- package/dist/internal/components/UnderlineTabbedInterface.module.css.js +11 -5
- package/dist/internal/components/UnstyledTextInput.js +40 -47
- package/dist/internal/components/UnstyledTextInput.module.css.js +5 -5
- package/dist/internal/components/ValidationAnimationContainer.js +55 -66
- package/dist/internal/components/ValidationAnimationContainer.module.css.js +8 -5
- package/dist/internal/hooks/useEffectCallback.js +35 -38
- package/dist/internal/hooks/useEffectOnce.js +23 -25
- package/dist/internal/utils/getResponsiveAttributes.js +23 -26
- package/dist/internal/utils/hasInteractiveNodes.js +34 -46
- package/dist/legacy-theme/ts/color-schemes.js +4250 -4732
- package/dist/live-region/Announce.js +144 -183
- package/dist/live-region/AriaAlert.js +20 -22
- package/dist/live-region/AriaStatus.js +20 -22
- package/dist/next/index.js +3 -1
- package/dist/test-helpers.js +40 -62
- package/dist/theme.js +83 -47
- package/dist/utils/character-counter.js +45 -63
- package/dist/utils/create-component.js +15 -16
- package/dist/utils/descendant-registry.js +182 -218
- package/dist/utils/environment.js +7 -7
- package/dist/utils/getBreakpointDeclarations.js +9 -10
- package/dist/utils/invariant.js +17 -23
- package/dist/utils/is-slot.js +10 -11
- package/dist/utils/isNumeric.js +3 -3
- package/dist/utils/modern-polymorphic.js +12 -20
- package/dist/utils/scroll.js +8 -11
- package/dist/utils/theme.js +5 -10
- package/dist/utils/useIsomorphicLayoutEffect.js +4 -9
- package/dist/utils/warning.js +14 -21
- package/generated/components.json +9 -9
- package/package.json +5 -10
|
@@ -1,67 +1,47 @@
|
|
|
1
|
-
import { useMedia } from
|
|
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
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
|
|
25
|
-
|
|
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
|
-
|
|
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
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
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
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
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 {
|
|
2
|
-
|
|
1
|
+
import { useCallback, useEffect, useRef } from "react";
|
|
2
|
+
//#region src/hooks/useSafeTimeout.ts
|
|
3
3
|
/**
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
|
2
|
-
|
|
1
|
+
import { useEffect } from "react";
|
|
2
|
+
//#region src/hooks/useScrollFlash.ts
|
|
3
3
|
/**
|
|
4
|
-
|
|
5
|
-
|
|
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
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
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 };
|
package/dist/hooks/useSlots.js
CHANGED
|
@@ -1,150 +1,116 @@
|
|
|
1
|
-
import
|
|
2
|
-
import {
|
|
3
|
-
import
|
|
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
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
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
|
-
|
|
126
|
-
|
|
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
|
-
|
|
130
|
-
|
|
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
|
-
|
|
137
|
-
|
|
138
|
-
|
|
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
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
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
|
|
2
|
-
import { useState } from
|
|
3
|
-
|
|
1
|
+
import { c } from "react-compiler-runtime";
|
|
2
|
+
import { useState } from "react";
|
|
3
|
+
//#region src/hooks/useSyncedState.tsx
|
|
4
4
|
/**
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
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 };
|