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