@astryxdesign/core 0.7.7-canary.550ff21 → 0.7.7-canary.58c5b8a
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/dist/AlertDialog/AlertDialog.d.ts +4 -1
- package/dist/AlertDialog/AlertDialog.d.ts.map +1 -1
- package/dist/AlertDialog/AlertDialog.js +36 -6
- package/dist/AppShell/useCloseMobileDrawerOnActivate.d.ts +13 -0
- package/dist/AppShell/useCloseMobileDrawerOnActivate.d.ts.map +1 -0
- package/dist/AppShell/useCloseMobileDrawerOnActivate.js +45 -0
- package/dist/Avatar/Avatar.d.ts.map +1 -1
- package/dist/Avatar/Avatar.js +1 -1
- package/dist/BottomSheet/BottomSheet.d.ts.map +1 -1
- package/dist/BottomSheet/BottomSheet.js +79 -9
- package/dist/BottomSheet/BottomSheetPanel.d.ts.map +1 -1
- package/dist/BottomSheet/BottomSheetPanel.js +23 -4
- package/dist/BottomSheet/bottomSheetStack.d.ts.map +1 -1
- package/dist/BottomSheet/bottomSheetStack.js +5 -4
- package/dist/BottomSheet/useSheetGestures.d.ts.map +1 -1
- package/dist/BottomSheet/useSheetGestures.js +3 -1
- package/dist/Breadcrumbs/BreadcrumbItem.d.ts +2 -1
- package/dist/Breadcrumbs/BreadcrumbItem.d.ts.map +1 -1
- package/dist/Breadcrumbs/BreadcrumbItem.js +9 -4
- package/dist/Button/Button.d.ts.map +1 -1
- package/dist/Button/Button.js +50 -5
- package/dist/CheckboxList/CheckboxList.d.ts.map +1 -1
- package/dist/CheckboxList/CheckboxList.js +7 -1
- package/dist/CheckboxList/CheckboxListContext.d.ts +6 -0
- package/dist/CheckboxList/CheckboxListContext.d.ts.map +1 -1
- package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
- package/dist/CheckboxList/CheckboxListItem.js +10 -2
- package/dist/ComplexSelector/ComplexSelector.d.ts +4 -1
- package/dist/ComplexSelector/ComplexSelector.d.ts.map +1 -1
- package/dist/ComplexSelector/ComplexSelector.js +14 -4
- package/dist/DateInput/DateInput.d.ts.map +1 -1
- package/dist/DateInput/DateInput.js +5 -2
- package/dist/DateInput/MonthScroller.d.ts.map +1 -1
- package/dist/DateInput/MonthScroller.js +13 -27
- package/dist/DateInput/Wheel.d.ts +17 -1
- package/dist/DateInput/Wheel.d.ts.map +1 -1
- package/dist/DateInput/Wheel.js +161 -20
- package/dist/DateRangeInput/DateRangeInput.d.ts.map +1 -1
- package/dist/DateRangeInput/DateRangeInput.js +63 -49
- package/dist/DateTimeInput/DateTimeInput.d.ts.map +1 -1
- package/dist/DateTimeInput/DateTimeInput.js +5 -2
- package/dist/Dialog/Dialog.d.ts.map +1 -1
- package/dist/Dialog/Dialog.js +53 -15
- package/dist/Drawer/Drawer.d.ts.map +1 -1
- package/dist/Drawer/Drawer.js +15 -11
- package/dist/Drawer/useDrawerDialogPresence.d.ts.map +1 -1
- package/dist/Drawer/useDrawerDialogPresence.js +9 -1
- package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
- package/dist/DropdownMenu/DropdownMenu.js +20 -4
- package/dist/Field/Field.js +2 -2
- package/dist/Field/PanelSearchInput.d.ts +9 -1
- package/dist/Field/PanelSearchInput.d.ts.map +1 -1
- package/dist/Field/PanelSearchInput.js +3 -1
- package/dist/HoverCard/HoverCard.d.ts.map +1 -1
- package/dist/HoverCard/HoverCard.js +27 -2
- package/dist/Icon/Icon.d.ts +5 -1
- package/dist/Icon/Icon.d.ts.map +1 -1
- package/dist/Icon/Icon.js +5 -2
- package/dist/InfoTip/InfoTip.d.ts +63 -0
- package/dist/InfoTip/InfoTip.d.ts.map +1 -0
- package/dist/InfoTip/InfoTip.js +126 -0
- package/dist/InfoTip/index.d.ts +10 -0
- package/dist/InfoTip/index.d.ts.map +1 -0
- package/dist/InfoTip/index.js +12 -0
- package/dist/Layer/layerAnimations.stylex.d.ts +7 -8
- package/dist/Layer/layerAnimations.stylex.d.ts.map +1 -1
- package/dist/Layer/layerAnimations.stylex.js +25 -20
- package/dist/Layer/layerClickBoundary.d.ts +7 -1
- package/dist/Layer/layerClickBoundary.d.ts.map +1 -1
- package/dist/Layer/layerClickBoundary.js +2 -2
- package/dist/Layer/useBackdropPress.d.ts +27 -0
- package/dist/Layer/useBackdropPress.d.ts.map +1 -0
- package/dist/Layer/useBackdropPress.js +53 -0
- package/dist/Layer/usePressPin.d.ts +105 -0
- package/dist/Layer/usePressPin.d.ts.map +1 -0
- package/dist/Layer/usePressPin.js +413 -0
- package/dist/Layer/useTouchTrigger.d.ts +23 -1
- package/dist/Layer/useTouchTrigger.d.ts.map +1 -1
- package/dist/Layer/useTouchTrigger.js +45 -7
- package/dist/Lightbox/Lightbox.d.ts.map +1 -1
- package/dist/Lightbox/Lightbox.js +2 -1
- package/dist/MobileNav/MobileNav.js +0 -1
- package/dist/MultiSelector/hooks.d.ts.map +1 -1
- package/dist/MultiSelector/hooks.js +2 -4
- package/dist/Outline/Outline.d.ts +2 -4
- package/dist/Outline/Outline.d.ts.map +1 -1
- package/dist/Outline/Outline.js +4 -52
- package/dist/Outline/useOutlineFromMarkdown.d.ts.map +1 -1
- package/dist/Outline/useOutlineFromMarkdown.js +1 -0
- package/dist/Outline/useScrollSpy.js +3 -3
- package/dist/Popover/usePopover.d.ts.map +1 -1
- package/dist/Popover/usePopover.js +56 -7
- package/dist/PowerSearch/PowerSearch.d.ts +36 -3
- package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
- package/dist/PowerSearch/PowerSearch.js +571 -302
- package/dist/PowerSearch/PowerSearchBottomSheet.d.ts +100 -0
- package/dist/PowerSearch/PowerSearchBottomSheet.d.ts.map +1 -0
- package/dist/PowerSearch/PowerSearchBottomSheet.js +1913 -0
- package/dist/PowerSearch/PowerSearchEditPopover.d.ts +32 -1
- package/dist/PowerSearch/PowerSearchEditPopover.d.ts.map +1 -1
- package/dist/PowerSearch/PowerSearchEditPopover.js +17 -6
- package/dist/PowerSearch/PowerSearchValueEditor.d.ts +38 -3
- package/dist/PowerSearch/PowerSearchValueEditor.d.ts.map +1 -1
- package/dist/PowerSearch/PowerSearchValueEditor.js +170 -61
- package/dist/PowerSearch/formatFilterValue.d.ts +7 -0
- package/dist/PowerSearch/formatFilterValue.d.ts.map +1 -1
- package/dist/PowerSearch/formatFilterValue.js +11 -1
- package/dist/PowerSearch/formatTokenValue.d.ts +28 -0
- package/dist/PowerSearch/formatTokenValue.d.ts.map +1 -0
- package/dist/PowerSearch/formatTokenValue.js +160 -0
- package/dist/PowerSearch/powerSearchSheetUtils.d.ts +65 -0
- package/dist/PowerSearch/powerSearchSheetUtils.d.ts.map +1 -0
- package/dist/PowerSearch/powerSearchSheetUtils.js +168 -0
- package/dist/ProgressBar/ProgressBar.d.ts +1 -1
- package/dist/ProgressBar/ProgressBar.d.ts.map +1 -1
- package/dist/ProgressBar/ProgressBar.js +33 -6
- package/dist/RadioList/RadioList.d.ts.map +1 -1
- package/dist/RadioList/RadioList.js +8 -2
- package/dist/RadioList/RadioListItem.d.ts +1 -1
- package/dist/RadioList/RadioListItem.d.ts.map +1 -1
- package/dist/RadioList/RadioListItem.js +5 -3
- package/dist/Resizable/ResizeHandle.d.ts.map +1 -1
- package/dist/Resizable/ResizeHandle.js +118 -260
- package/dist/Resizable/resizeGesture.d.ts +91 -0
- package/dist/Resizable/resizeGesture.d.ts.map +1 -0
- package/dist/Resizable/resizeGesture.js +251 -0
- package/dist/SegmentedControl/SegmentedControl.d.ts +3 -1
- package/dist/SegmentedControl/SegmentedControl.d.ts.map +1 -1
- package/dist/SegmentedControl/SegmentedControl.js +115 -8
- package/dist/SegmentedControl/SegmentedControlContext.d.ts +6 -0
- package/dist/SegmentedControl/SegmentedControlContext.d.ts.map +1 -1
- package/dist/SegmentedControl/SegmentedControlItem.d.ts +1 -0
- package/dist/SegmentedControl/SegmentedControlItem.d.ts.map +1 -1
- package/dist/SegmentedControl/SegmentedControlItem.js +10 -2
- package/dist/SegmentedControl/useSegmentedSelectionMotion.d.ts +357 -0
- package/dist/SegmentedControl/useSegmentedSelectionMotion.d.ts.map +1 -0
- package/dist/SegmentedControl/useSegmentedSelectionMotion.js +1349 -0
- package/dist/SegmentedControl/useSegmentedTouchTracking.d.ts +70 -0
- package/dist/SegmentedControl/useSegmentedTouchTracking.d.ts.map +1 -0
- package/dist/SegmentedControl/useSegmentedTouchTracking.js +264 -0
- package/dist/Selector/Selector.d.ts.map +1 -1
- package/dist/Selector/Selector.js +96 -67
- package/dist/Selector/optionShape.d.ts +24 -0
- package/dist/Selector/optionShape.d.ts.map +1 -0
- package/dist/Selector/optionShape.js +48 -0
- package/dist/Selector/selectableOptionEntries.d.ts +20 -0
- package/dist/Selector/selectableOptionEntries.d.ts.map +1 -0
- package/dist/Selector/selectableOptionEntries.js +38 -0
- package/dist/Selector/utils.d.ts +2 -17
- package/dist/Selector/utils.d.ts.map +1 -1
- package/dist/Selector/utils.js +3 -51
- package/dist/SideNav/SideNavItem.d.ts.map +1 -1
- package/dist/SideNav/SideNavItem.js +3 -9
- package/dist/Slider/sliderTouchController.js +2 -2
- package/dist/Switch/Switch.d.ts +1 -1
- package/dist/Switch/Switch.d.ts.map +1 -1
- package/dist/Switch/Switch.js +200 -46
- package/dist/Switch/switchFill.d.ts +31 -0
- package/dist/Switch/switchFill.d.ts.map +1 -0
- package/dist/Switch/switchFill.js +88 -0
- package/dist/Switch/switchTouch.d.ts +74 -0
- package/dist/Switch/switchTouch.d.ts.map +1 -0
- package/dist/Switch/switchTouch.js +125 -0
- package/dist/Switch/useSwitchTouch.d.ts +276 -0
- package/dist/Switch/useSwitchTouch.d.ts.map +1 -0
- package/dist/Switch/useSwitchTouch.js +939 -0
- package/dist/TabList/Tab.d.ts.map +1 -1
- package/dist/TabList/Tab.js +4 -3
- package/dist/Table/BaseTable.d.ts.map +1 -1
- package/dist/Table/BaseTable.js +29 -8
- package/dist/TextInput/TextInput.d.ts +2 -2
- package/dist/TextInput/TextInput.d.ts.map +1 -1
- package/dist/TextInput/TextInput.js +10 -7
- package/dist/Toast/Toast.d.ts.map +1 -1
- package/dist/Toast/Toast.js +5 -0
- package/dist/Token/Token.d.ts +2 -2
- package/dist/Token/Token.d.ts.map +1 -1
- package/dist/Token/Token.js +13 -4
- package/dist/Token/TokenNamingContext.d.ts +14 -0
- package/dist/Token/TokenNamingContext.d.ts.map +1 -0
- package/dist/Token/TokenNamingContext.js +23 -0
- package/dist/Tokenizer/Tokenizer.d.ts +46 -59
- package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
- package/dist/Tokenizer/Tokenizer.js +44 -60
- package/dist/Tokenizer/TokenizerBottomSheet.d.ts +25 -28
- package/dist/Tokenizer/TokenizerBottomSheet.d.ts.map +1 -1
- package/dist/Tokenizer/TokenizerBottomSheet.js +157 -54
- package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts +3 -0
- package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts.map +1 -0
- package/dist/Tokenizer/TokenizerItemRemovableContext.js +19 -0
- package/dist/Tooltip/Tooltip.d.ts +24 -5
- package/dist/Tooltip/Tooltip.d.ts.map +1 -1
- package/dist/Tooltip/Tooltip.js +29 -5
- package/dist/Tooltip/useTooltip.d.ts +48 -5
- package/dist/Tooltip/useTooltip.d.ts.map +1 -1
- package/dist/Tooltip/useTooltip.js +90 -20
- package/dist/TopNav/TopNavItem.d.ts.map +1 -1
- package/dist/TopNav/TopNavItem.js +4 -7
- package/dist/TopNav/TopNavMegaMenuItem.d.ts.map +1 -1
- package/dist/TopNav/TopNavMegaMenuItem.js +4 -7
- package/dist/TopNav/TopNavMenu.d.ts.map +1 -1
- package/dist/TopNav/TopNavMenu.js +4 -7
- package/dist/Typeahead/Typeahead.d.ts.map +1 -1
- package/dist/Typeahead/Typeahead.js +26 -15
- package/dist/animator/createAnimator.d.ts +98 -0
- package/dist/animator/createAnimator.d.ts.map +1 -0
- package/dist/animator/createAnimator.js +259 -0
- package/dist/astryx.css +142 -7
- package/dist/gestures/GestureHost.d.ts +27 -1
- package/dist/gestures/GestureHost.d.ts.map +1 -1
- package/dist/gestures/GestureHost.js +161 -22
- package/dist/gestures/PressTracker.d.ts +6 -0
- package/dist/gestures/PressTracker.d.ts.map +1 -1
- package/dist/gestures/PressTracker.js +3 -0
- package/dist/gestures/types.d.ts +6 -0
- package/dist/gestures/types.d.ts.map +1 -1
- package/dist/gestures/usePressTracker.d.ts.map +1 -1
- package/dist/gestures/usePressTracker.js +1 -0
- package/dist/gestures/wheelSegmenter.d.ts +14 -3
- package/dist/gestures/wheelSegmenter.d.ts.map +1 -1
- package/dist/gestures/wheelSegmenter.js +32 -8
- package/dist/hooks/actionGroupTracker.d.ts +7 -4
- package/dist/hooks/actionGroupTracker.d.ts.map +1 -1
- package/dist/hooks/actionGroupTracker.js +19 -56
- package/dist/hooks/index.d.ts +1 -0
- package/dist/hooks/index.d.ts.map +1 -1
- package/dist/hooks/index.js +1 -0
- package/dist/hooks/pressGroupContext.d.ts +6 -0
- package/dist/hooks/pressGroupContext.d.ts.map +1 -0
- package/dist/hooks/pressGroupContext.js +20 -0
- package/dist/hooks/useActionGroupTracking.d.ts +53 -0
- package/dist/hooks/useActionGroupTracking.d.ts.map +1 -0
- package/dist/hooks/useActionGroupTracking.js +174 -0
- package/dist/hooks/useAnimator.d.ts +41 -0
- package/dist/hooks/useAnimator.d.ts.map +1 -0
- package/dist/hooks/useAnimator.js +70 -0
- package/dist/hooks/useAttachment.d.ts +16 -8
- package/dist/hooks/useAttachment.d.ts.map +1 -1
- package/dist/hooks/useAttachment.js +35 -15
- package/dist/hooks/useFocusTrap.d.ts +15 -0
- package/dist/hooks/useFocusTrap.d.ts.map +1 -1
- package/dist/hooks/useFocusTrap.js +13 -2
- package/dist/hooks/useHighlightedOptionScroll.d.ts +11 -1
- package/dist/hooks/useHighlightedOptionScroll.d.ts.map +1 -1
- package/dist/hooks/useHighlightedOptionScroll.js +112 -11
- package/dist/hooks/useInputStatusIcon.d.ts +1 -1
- package/dist/hooks/useInputStatusIcon.d.ts.map +1 -1
- package/dist/hooks/useInputStatusIcon.js +2 -2
- package/dist/hooks/useMediaQuery.d.ts +2 -1
- package/dist/hooks/useMediaQuery.d.ts.map +1 -1
- package/dist/hooks/useMediaQuery.js +7 -4
- package/dist/hooks/useMenuPress.d.ts.map +1 -1
- package/dist/hooks/useMenuPress.js +4 -2
- package/dist/hooks/usePager.d.ts +261 -0
- package/dist/hooks/usePager.d.ts.map +1 -0
- package/dist/hooks/usePager.js +1169 -0
- package/dist/i18n/generated-english/InfoTip/InfoTip.generated.d.ts +8 -0
- package/dist/i18n/generated-english/InfoTip/InfoTip.generated.d.ts.map +1 -0
- package/dist/i18n/generated-english/InfoTip/InfoTip.generated.js +12 -0
- package/dist/i18n/generated-english/PowerSearch/PowerSearch.generated.d.ts.map +1 -1
- package/dist/i18n/generated-english/PowerSearch/PowerSearch.generated.js +1 -0
- package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts +8 -0
- package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts.map +1 -0
- package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.js +42 -0
- package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.d.ts.map +1 -1
- package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.js +6 -0
- package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts +8 -0
- package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts.map +1 -0
- package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.js +14 -0
- package/dist/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.d.ts.map +1 -1
- package/dist/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.js +7 -1
- package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
- package/dist/i18n/generated-locales/en.generated.js +33 -1
- package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
- package/dist/i18n/generated-locales/pseudo.generated.js +33 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -0
- package/dist/internal/SheetConfirmation.d.ts +11 -0
- package/dist/internal/SheetConfirmation.d.ts.map +1 -0
- package/dist/internal/SheetConfirmation.js +92 -0
- package/dist/internal/sheetDraft.d.ts +35 -0
- package/dist/internal/sheetDraft.d.ts.map +1 -0
- package/dist/internal/sheetDraft.js +65 -0
- package/dist/internal/touch-sheet.d.ts +21 -0
- package/dist/internal/touch-sheet.d.ts.map +1 -0
- package/dist/internal/touch-sheet.js +19 -0
- package/dist/internal/useDismissSearchOnTouchDrag.d.ts +24 -0
- package/dist/internal/useDismissSearchOnTouchDrag.d.ts.map +1 -0
- package/dist/internal/useDismissSearchOnTouchDrag.js +56 -0
- package/dist/motion/animator.d.ts +14 -14
- package/dist/motion/animator.d.ts.map +1 -1
- package/dist/motion/animator.js +41 -18
- package/dist/motion/paging.d.ts +16 -5
- package/dist/motion/paging.d.ts.map +1 -1
- package/dist/motion/paging.js +34 -14
- package/dist/motion/reducedMotion.d.ts +24 -0
- package/dist/motion/reducedMotion.d.ts.map +1 -1
- package/dist/motion/reducedMotion.js +78 -1
- package/dist/motion/roles.d.ts +7 -1
- package/dist/motion/roles.d.ts.map +1 -1
- package/dist/motion/roles.js +20 -1
- package/dist/motion/uikit/alert.d.ts +41 -0
- package/dist/motion/uikit/alert.d.ts.map +1 -0
- package/dist/motion/uikit/alert.js +43 -0
- package/dist/motion/uikit/index.d.ts +7 -4
- package/dist/motion/uikit/index.d.ts.map +1 -1
- package/dist/motion/uikit/index.js +7 -4
- package/dist/motion/uikit/paging.d.ts +31 -20
- package/dist/motion/uikit/paging.d.ts.map +1 -1
- package/dist/motion/uikit/paging.js +41 -11
- package/dist/motion/uikit/progressBar.d.ts +27 -7
- package/dist/motion/uikit/progressBar.d.ts.map +1 -1
- package/dist/motion/uikit/progressBar.js +31 -11
- package/dist/motion/uikit/segmented.d.ts +55 -0
- package/dist/motion/uikit/segmented.d.ts.map +1 -0
- package/dist/motion/uikit/segmented.js +77 -0
- package/dist/motion/uikit/springs.d.ts +8 -42
- package/dist/motion/uikit/springs.d.ts.map +1 -1
- package/dist/motion/uikit/springs.js +12 -42
- package/dist/motion/uikit/switch.d.ts +166 -0
- package/dist/motion/uikit/switch.d.ts.map +1 -0
- package/dist/motion/uikit/switch.js +186 -0
- package/dist/privateAttributes/pressGroupItem.stylex.d.ts +15 -0
- package/dist/privateAttributes/pressGroupItem.stylex.d.ts.map +1 -0
- package/dist/privateAttributes/pressGroupItem.stylex.js +23 -0
- package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts +18 -0
- package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts.map +1 -0
- package/dist/privateAttributes/pressHoldsDrag.stylex.js +28 -0
- package/dist/privateAttributes/segmentTitle.stylex.d.ts +5 -0
- package/dist/privateAttributes/segmentTitle.stylex.d.ts.map +1 -0
- package/dist/privateAttributes/segmentTitle.stylex.js +22 -0
- package/dist/utils/browserClickWait.d.ts +35 -0
- package/dist/utils/browserClickWait.d.ts.map +1 -0
- package/dist/utils/browserClickWait.js +123 -0
- package/dist/utils/clickGuard.d.ts +14 -1
- package/dist/utils/clickGuard.d.ts.map +1 -1
- package/dist/utils/clickGuard.js +46 -1
- package/dist/utils/dateParser.d.ts.map +1 -1
- package/dist/utils/dateParser.js +12 -0
- package/dist/utils/interactionOverlay.stylex.d.ts +3 -2
- package/dist/utils/interactionOverlay.stylex.d.ts.map +1 -1
- package/dist/utils/interactionOverlay.stylex.js +3 -2
- package/dist/utils/pressFeedback.d.ts.map +1 -1
- package/dist/utils/pressFeedback.js +24 -6
- package/locales/en.json +128 -0
- package/locales/pseudo.json +96 -0
- package/package.json +13 -8
- package/src/AlertDialog/AlertDialog.doc.mjs +2 -2
- package/src/AlertDialog/AlertDialog.tsx +37 -5
- package/src/AppShell/useCloseMobileDrawerOnActivate.ts +52 -0
- package/src/Avatar/Avatar.tsx +3 -1
- package/src/BottomSheet/BottomSheet.tsx +95 -10
- package/src/BottomSheet/BottomSheetPanel.tsx +40 -5
- package/src/BottomSheet/bottomSheetStack.ts +8 -4
- package/src/BottomSheet/useSheetGestures.ts +3 -1
- package/src/Breadcrumbs/BreadcrumbItem.tsx +17 -4
- package/src/Button/Button.tsx +66 -7
- package/src/CheckboxList/CheckboxList.doc.mjs +4 -2
- package/src/CheckboxList/CheckboxList.tsx +6 -0
- package/src/CheckboxList/CheckboxListContext.tsx +6 -0
- package/src/CheckboxList/CheckboxListItem.tsx +11 -2
- package/src/ComplexSelector/ComplexSelector.tsx +20 -5
- package/src/DateInput/DateInput.tsx +8 -2
- package/src/DateInput/MonthScroller.tsx +18 -22
- package/src/DateInput/Wheel.tsx +172 -14
- package/src/DateRangeInput/DateRangeInput.doc.mjs +3 -2
- package/src/DateRangeInput/DateRangeInput.tsx +117 -71
- package/src/DateTimeInput/DateTimeInput.tsx +8 -2
- package/src/Dialog/Dialog.tsx +81 -15
- package/src/Drawer/Drawer.tsx +28 -11
- package/src/Drawer/useDrawerDialogPresence.ts +9 -1
- package/src/DropdownMenu/DropdownMenu.tsx +28 -6
- package/src/Field/Field.tsx +2 -2
- package/src/Field/PanelSearchInput.tsx +11 -0
- package/src/HoverCard/HoverCard.tsx +31 -1
- package/src/Icon/Icon.doc.mjs +49 -8
- package/src/Icon/Icon.tsx +15 -7
- package/src/InfoTip/InfoTip.doc.mjs +192 -0
- package/src/InfoTip/InfoTip.tsx +186 -0
- package/src/InfoTip/index.ts +14 -0
- package/src/Layer/layerAnimations.stylex.ts +24 -16
- package/src/Layer/layerClickBoundary.ts +2 -2
- package/src/Layer/useBackdropPress.ts +81 -0
- package/src/Layer/usePressPin.ts +576 -0
- package/src/Layer/useTouchTrigger.ts +56 -6
- package/src/Lightbox/Lightbox.tsx +2 -1
- package/src/MobileNav/MobileNav.tsx +1 -1
- package/src/MultiSelector/hooks.ts +2 -4
- package/src/Outline/Outline.doc.mjs +177 -51
- package/src/Outline/Outline.tsx +5 -57
- package/src/Outline/useOutlineFromMarkdown.doc.mjs +157 -0
- package/src/Outline/useOutlineFromMarkdown.ts +1 -0
- package/src/Outline/useScrollSpy.ts +3 -3
- package/src/Popover/usePopover.tsx +71 -9
- package/src/PowerSearch/PowerSearch.doc.mjs +55 -6
- package/src/PowerSearch/PowerSearch.tsx +798 -324
- package/src/PowerSearch/PowerSearchBottomSheet.tsx +2515 -0
- package/src/PowerSearch/PowerSearchEditPopover.tsx +28 -6
- package/src/PowerSearch/PowerSearchValueEditor.tsx +203 -38
- package/src/PowerSearch/formatFilterValue.ts +18 -1
- package/src/PowerSearch/formatTokenValue.ts +215 -0
- package/src/PowerSearch/powerSearchSheetUtils.ts +224 -0
- package/src/ProgressBar/ProgressBar.doc.mjs +4 -2
- package/src/ProgressBar/ProgressBar.tsx +67 -7
- package/src/RadioList/RadioList.doc.mjs +4 -2
- package/src/RadioList/RadioList.tsx +7 -2
- package/src/RadioList/RadioListItem.tsx +5 -3
- package/src/Resizable/ResizeHandle.tsx +133 -328
- package/src/Resizable/resizeGesture.ts +368 -0
- package/src/SegmentedControl/SegmentedControl.doc.mjs +3 -3
- package/src/SegmentedControl/SegmentedControl.tsx +179 -5
- package/src/SegmentedControl/SegmentedControlContext.ts +6 -0
- package/src/SegmentedControl/SegmentedControlItem.tsx +14 -2
- package/src/SegmentedControl/useSegmentedSelectionMotion.ts +1640 -0
- package/src/SegmentedControl/useSegmentedTouchTracking.ts +308 -0
- package/src/Selector/Selector.tsx +136 -89
- package/src/Selector/optionShape.ts +64 -0
- package/src/Selector/selectableOptionEntries.ts +39 -0
- package/src/Selector/utils.ts +9 -68
- package/src/SideNav/SideNavItem.tsx +3 -7
- package/src/Slider/sliderTouchController.ts +2 -2
- package/src/Switch/Switch.doc.mjs +3 -3
- package/src/Switch/Switch.tsx +412 -86
- package/src/Switch/switchFill.ts +106 -0
- package/src/Switch/switchTouch.ts +186 -0
- package/src/Switch/useSwitchTouch.ts +1051 -0
- package/src/TabList/Tab.tsx +5 -3
- package/src/Table/BaseTable.tsx +46 -12
- package/src/TextInput/TextInput.tsx +11 -10
- package/src/Toast/Toast.tsx +5 -0
- package/src/Token/Token.tsx +15 -4
- package/src/Token/TokenNamingContext.ts +28 -0
- package/src/Tokenizer/Tokenizer.doc.mjs +16 -0
- package/src/Tokenizer/Tokenizer.tsx +93 -88
- package/src/Tokenizer/TokenizerBottomSheet.tsx +219 -93
- package/src/Tokenizer/TokenizerItemRemovableContext.ts +24 -0
- package/src/Tooltip/Tooltip.doc.mjs +123 -39
- package/src/Tooltip/Tooltip.tsx +43 -9
- package/src/Tooltip/useTooltip.doc.mjs +171 -31
- package/src/Tooltip/useTooltip.tsx +137 -22
- package/src/TopNav/TopNavItem.tsx +6 -5
- package/src/TopNav/TopNavMegaMenuItem.tsx +6 -5
- package/src/TopNav/TopNavMenu.tsx +6 -5
- package/src/Typeahead/Typeahead.tsx +29 -15
- package/src/animator/createAnimator.doc.mjs +153 -0
- package/src/animator/createAnimator.ts +324 -0
- package/src/gestures/GestureHost.ts +205 -21
- package/src/gestures/PressTracker.ts +10 -0
- package/src/gestures/types.ts +6 -0
- package/src/gestures/usePressTracker.ts +2 -0
- package/src/gestures/wheelSegmenter.ts +36 -7
- package/src/hooks/actionGroupTracker.ts +32 -61
- package/src/hooks/index.ts +2 -0
- package/src/hooks/pressGroupContext.ts +21 -0
- package/src/hooks/useActionGroupTracking.ts +224 -0
- package/src/hooks/useAnimator.doc.mjs +109 -0
- package/src/hooks/useAnimator.ts +67 -0
- package/src/hooks/useAttachment.ts +56 -14
- package/src/hooks/useFocusTrap.ts +26 -2
- package/src/hooks/useHighlightedOptionScroll.ts +123 -15
- package/src/hooks/useInputStatusIcon.tsx +3 -2
- package/src/hooks/useMediaQuery.doc.mjs +2 -2
- package/src/hooks/useMediaQuery.ts +13 -4
- package/src/hooks/useMenuPress.ts +8 -2
- package/src/hooks/usePager.ts +1446 -0
- package/src/i18n/generated-english/InfoTip/InfoTip.generated.ts +13 -0
- package/src/i18n/generated-english/PowerSearch/PowerSearch.generated.ts +1 -0
- package/src/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.ts +43 -0
- package/src/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.ts +6 -0
- package/src/i18n/generated-english/PowerSearch/formatTokenValue.generated.ts +15 -0
- package/src/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.ts +7 -1
- package/src/i18n/generated-locales/en.generated.ts +43 -0
- package/src/i18n/generated-locales/pseudo.generated.ts +44 -0
- package/src/index.ts +14 -0
- package/src/internal/SheetConfirmation.tsx +101 -0
- package/src/internal/sheetDraft.ts +80 -0
- package/src/internal/touch-sheet.ts +21 -0
- package/src/internal/useDismissSearchOnTouchDrag.ts +69 -0
- package/src/motion/MEASUREMENTS.md +36 -27
- package/src/motion/README.md +11 -6
- package/src/motion/animator.ts +61 -29
- package/src/motion/paging.ts +37 -14
- package/src/motion/reducedMotion.ts +79 -1
- package/src/motion/roles.ts +20 -1
- package/src/motion/uikit/alert.ts +43 -0
- package/src/motion/uikit/index.ts +6 -5
- package/src/motion/uikit/paging.ts +41 -10
- package/src/motion/uikit/progressBar.ts +31 -11
- package/src/motion/uikit/segmented.ts +74 -0
- package/src/motion/uikit/springs.ts +12 -42
- package/src/motion/uikit/switch.ts +174 -0
- package/src/privateAttributes/pressGroupItem.stylex.ts +23 -0
- package/src/privateAttributes/pressHoldsDrag.stylex.ts +28 -0
- package/src/privateAttributes/segmentTitle.stylex.ts +22 -0
- package/src/utils/browserClickWait.ts +133 -0
- package/src/utils/clickGuard.ts +64 -1
- package/src/utils/dateParser.ts +16 -0
- package/src/utils/interactionOverlay.stylex.ts +3 -2
- package/src/utils/pressFeedback.ts +24 -6
- package/dist/internal/tokenizer-presentation.d.ts +0 -21
- package/dist/internal/tokenizer-presentation.d.ts.map +0 -1
- package/dist/internal/tokenizer-presentation.js +0 -21
- package/src/internal/tokenizer-presentation.ts +0 -25
|
@@ -4,8 +4,10 @@
|
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* @file useTooltip.tsx
|
|
7
|
-
* @input Uses useLayer,
|
|
7
|
+
* @input Uses useLayer, usePressPin, React hooks
|
|
8
8
|
* @output Exports useTooltip hook with stable trigger refs for hover/focus/tap tooltips
|
|
9
|
+
* and imperative show() and hide() for an app-built toggle trigger,
|
|
10
|
+
* and the module-only useTooltipWithTriggerBehavior that InfoTip's press-to-pin uses
|
|
9
11
|
* @position Layer hook; builds on useLayer for tooltip behavior
|
|
10
12
|
*
|
|
11
13
|
* SYNC: When modified, update:
|
|
@@ -26,12 +28,12 @@ import {
|
|
|
26
28
|
type LayerAlignment,
|
|
27
29
|
type LayerPlacement,
|
|
28
30
|
} from '../Layer/useLayer';
|
|
29
|
-
import {
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
} from '../Layer/useTouchTrigger';
|
|
31
|
+
import type {LayerTouchTrigger} from '../Layer/useTouchTrigger';
|
|
32
|
+
import {useAnnounceRenderedText} from '../hooks/useAnnounceRenderedText';
|
|
33
|
+
import {useMergedRefs} from '../hooks/useMergedRefs';
|
|
33
34
|
import {layerAnimations} from '../Layer/layerAnimations.stylex';
|
|
34
35
|
import {registerLayerSurface} from '../Layer/layerSurfacePress';
|
|
36
|
+
import {usePressPin, type LayerTriggerBehavior} from '../Layer/usePressPin';
|
|
35
37
|
import {useLayerDismissal} from '../Layer/useLayerDismissal';
|
|
36
38
|
import {themeProps} from '../utils/themeProps';
|
|
37
39
|
import {
|
|
@@ -124,9 +126,7 @@ export interface TooltipOptions {
|
|
|
124
126
|
* - `auto`: tap opens the tooltip, unless the trigger performs an action of
|
|
125
127
|
* its own (a button, a link, a form control) — that tap belongs to the
|
|
126
128
|
* control, and a hint about a control the user just operated is noise
|
|
127
|
-
* - `tap`: tap always opens the tooltip
|
|
128
|
-
* as a button wants: it looks like an action to the DOM, but revealing the
|
|
129
|
-
* tooltip is the only thing it does
|
|
129
|
+
* - `tap`: tap always opens the tooltip, even on a trigger that acts
|
|
130
130
|
* - `none`: touch never opens the tooltip
|
|
131
131
|
*
|
|
132
132
|
* @default 'auto'
|
|
@@ -217,6 +217,25 @@ export interface TooltipReturn {
|
|
|
217
217
|
children: ReactNode,
|
|
218
218
|
props?: Omit<ContextRenderProps, 'positioning'>,
|
|
219
219
|
) => ReactNode;
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* Opens the tooltip now and keeps it open until `hide()`, Escape, a press
|
|
223
|
+
* outside, or focus leaving its trigger, as a pinned tooltip does. Its text
|
|
224
|
+
* is announced once. Reports through `onShow`. Under a controlled `isOpen`,
|
|
225
|
+
* it calls `onShow` and does not change `isOpen`. Does nothing while
|
|
226
|
+
* `isEnabled` is false.
|
|
227
|
+
*
|
|
228
|
+
* Use `show()` and `hide()` to build a toggle-style trigger: your own button
|
|
229
|
+
* calls them, sets `aria-describedby` and `aria-controls` to `describedBy`
|
|
230
|
+
* and `aria-expanded` (true while shown), and keeps its own accessible name.
|
|
231
|
+
*/
|
|
232
|
+
show: () => void;
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Closes the tooltip now. Reports through `onHide`. Under a controlled
|
|
236
|
+
* `isOpen`, it calls `onHide` and does not change `isOpen`.
|
|
237
|
+
*/
|
|
238
|
+
hide: () => void;
|
|
220
239
|
}
|
|
221
240
|
|
|
222
241
|
/**
|
|
@@ -268,6 +287,42 @@ function isFocusable(element: HTMLElement): boolean {
|
|
|
268
287
|
*/
|
|
269
288
|
|
|
270
289
|
export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
290
|
+
// The option is fixed to `adaptive`, so an options object that carries it at
|
|
291
|
+
// runtime cannot reach the press-to-pin path.
|
|
292
|
+
return useTooltipWithTriggerBehavior({
|
|
293
|
+
...options,
|
|
294
|
+
triggerBehavior: 'adaptive',
|
|
295
|
+
});
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* Module-only options for `useTooltipWithTriggerBehavior`. Not exported from
|
|
300
|
+
* the package.
|
|
301
|
+
*/
|
|
302
|
+
export interface TooltipWithTriggerBehaviorOptions extends TooltipOptions {
|
|
303
|
+
/**
|
|
304
|
+
* How the trigger opens the tooltip:
|
|
305
|
+
* - `adaptive` (the default): hover and focus preview it. `touchTrigger`
|
|
306
|
+
* decides taps.
|
|
307
|
+
* - `toggle`: on a button trigger, a click, a tap, Enter, or Space pins the
|
|
308
|
+
* tooltip open, and the same press closes it. Hover and keyboard focus
|
|
309
|
+
* still preview it. A pinned tooltip stays until Escape, a second press,
|
|
310
|
+
* a press outside, or focus leaving. The trigger reports `aria-expanded`
|
|
311
|
+
* and `aria-controls`, and the tooltip's text is announced once when it
|
|
312
|
+
* pins. `touchTrigger` is ignored. InfoTip uses it.
|
|
313
|
+
*
|
|
314
|
+
* @default 'adaptive'
|
|
315
|
+
*/
|
|
316
|
+
triggerBehavior?: LayerTriggerBehavior;
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* `useTooltip` with a trigger behavior. Module-only: InfoTip's press-to-pin
|
|
321
|
+
* goes through it, and the package does not export it.
|
|
322
|
+
*/
|
|
323
|
+
export function useTooltipWithTriggerBehavior(
|
|
324
|
+
options: TooltipWithTriggerBehaviorOptions = {},
|
|
325
|
+
): TooltipReturn {
|
|
271
326
|
const {
|
|
272
327
|
placement = 'above',
|
|
273
328
|
alignment = 'center',
|
|
@@ -275,6 +330,7 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
275
330
|
hideDelay = 0,
|
|
276
331
|
focusTrigger = 'auto',
|
|
277
332
|
touchTrigger = 'auto',
|
|
333
|
+
triggerBehavior = 'adaptive',
|
|
278
334
|
isEnabled = true,
|
|
279
335
|
isOpen,
|
|
280
336
|
isDefaultOpen = false,
|
|
@@ -332,23 +388,47 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
332
388
|
hideLayer();
|
|
333
389
|
}, [clearTimeouts, hideLayer]);
|
|
334
390
|
|
|
391
|
+
// A press pins the tooltip under `triggerBehavior="toggle"`. The pin also
|
|
392
|
+
// owns the tooltip's touch trigger, so this one call wires both.
|
|
335
393
|
const {
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
394
|
+
isToggleTrigger,
|
|
395
|
+
isHeldOpen: isPressHeldOpen,
|
|
396
|
+
attach: attachPressPin,
|
|
397
|
+
unpin: unpinPress,
|
|
398
|
+
hold: holdPress,
|
|
399
|
+
release: releasePress,
|
|
400
|
+
isAppHeld,
|
|
401
|
+
isPinShown,
|
|
402
|
+
touch: {
|
|
403
|
+
isTouchPointerRef,
|
|
404
|
+
isTouchInteraction,
|
|
405
|
+
handlePointerEnter,
|
|
406
|
+
handlePointerDown: handleTouchPointerDown,
|
|
407
|
+
clearTapOpen,
|
|
408
|
+
},
|
|
409
|
+
} = usePressPin({
|
|
410
|
+
triggerBehavior,
|
|
342
411
|
touchTrigger,
|
|
343
412
|
isEnabled,
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
layerId
|
|
413
|
+
isOpen,
|
|
414
|
+
isLayerOpen,
|
|
415
|
+
layerId,
|
|
347
416
|
triggerRef,
|
|
417
|
+
component: 'Tooltip',
|
|
348
418
|
show: showNow,
|
|
349
419
|
hide: hideNow,
|
|
420
|
+
report: next => (next ? onShow?.() : onHide?.()),
|
|
350
421
|
});
|
|
351
422
|
|
|
423
|
+
// Only a pin announces the text: a preview is already the trigger's
|
|
424
|
+
// description.
|
|
425
|
+
const contentRef = useRef<HTMLDivElement | null>(null);
|
|
426
|
+
useAnnounceRenderedText(contentRef, isPinShown, 'pinned');
|
|
427
|
+
const contentRefs = useMergedRefs<HTMLDivElement>(
|
|
428
|
+
contentRef,
|
|
429
|
+
registerLayerSurface,
|
|
430
|
+
);
|
|
431
|
+
|
|
352
432
|
// Schedule show with delay (suppressed when isOpen is false)
|
|
353
433
|
const scheduleShow = useCallback(() => {
|
|
354
434
|
if (!isEnabled || isOpen === false) {
|
|
@@ -376,7 +456,7 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
376
456
|
// trigger onto the tooltip surface without the tooltip vanishing — required
|
|
377
457
|
// for WCAG 1.4.13 (Content on Hover or Focus: hoverable).
|
|
378
458
|
const scheduleHide = useCallback(() => {
|
|
379
|
-
if (isOpen === true) {
|
|
459
|
+
if (isOpen === true || isPressHeldOpen()) {
|
|
380
460
|
return;
|
|
381
461
|
}
|
|
382
462
|
clearTimeouts();
|
|
@@ -384,7 +464,7 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
384
464
|
hideTimeoutRef.current = setTimeout(() => {
|
|
385
465
|
hideLayer();
|
|
386
466
|
}, effectiveHideDelay);
|
|
387
|
-
}, [isOpen, clearTimeouts, hideLayer, hideDelay]);
|
|
467
|
+
}, [isOpen, isPressHeldOpen, clearTimeouts, hideLayer, hideDelay]);
|
|
388
468
|
|
|
389
469
|
// Cancel a pending hide (e.g. the pointer entered the tooltip surface).
|
|
390
470
|
const cancelHide = useCallback(() => {
|
|
@@ -482,6 +562,9 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
482
562
|
],
|
|
483
563
|
);
|
|
484
564
|
|
|
565
|
+
// A pinned tooltip's focus-leave close is the pin's own: it listens on the
|
|
566
|
+
// trigger whatever `focusTrigger` is. This schedules the unpinned hide,
|
|
567
|
+
// which a held tooltip skips.
|
|
485
568
|
const handleFocusOut = useCallback(
|
|
486
569
|
(e: Event) => {
|
|
487
570
|
if (!focusCountedRef.current && !isFocusForTrigger(e)) {
|
|
@@ -502,6 +585,12 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
502
585
|
// tooltip at all), so the touch path answers it first.
|
|
503
586
|
const handlePointerDown = useCallback(
|
|
504
587
|
(event: PointerEvent) => {
|
|
588
|
+
// A toggle trigger's press pins or closes through its click. The app's
|
|
589
|
+
// hide() closes a held tooltip. Neither path hides here or waits for a
|
|
590
|
+
// tap verdict.
|
|
591
|
+
if (isToggleTrigger(triggerRef.current) || isAppHeld()) {
|
|
592
|
+
return;
|
|
593
|
+
}
|
|
505
594
|
if (handleTouchPointerDown(event)) {
|
|
506
595
|
return;
|
|
507
596
|
}
|
|
@@ -511,7 +600,14 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
511
600
|
clearTimeouts();
|
|
512
601
|
hideLayer();
|
|
513
602
|
},
|
|
514
|
-
[
|
|
603
|
+
[
|
|
604
|
+
isToggleTrigger,
|
|
605
|
+
isAppHeld,
|
|
606
|
+
handleTouchPointerDown,
|
|
607
|
+
isOpen,
|
|
608
|
+
clearTimeouts,
|
|
609
|
+
hideLayer,
|
|
610
|
+
],
|
|
515
611
|
);
|
|
516
612
|
|
|
517
613
|
// Interaction ref that handles event listeners only
|
|
@@ -552,8 +648,10 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
552
648
|
}
|
|
553
649
|
|
|
554
650
|
triggerRef.current = el;
|
|
651
|
+
attachPressPin(el);
|
|
555
652
|
},
|
|
556
653
|
[
|
|
654
|
+
attachPressPin,
|
|
557
655
|
focusTrigger,
|
|
558
656
|
handleMouseEnter,
|
|
559
657
|
handleMouseLeave,
|
|
@@ -598,9 +696,11 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
598
696
|
showLayer();
|
|
599
697
|
} else {
|
|
600
698
|
clearTimeouts();
|
|
699
|
+
// A pin or app hold ends when the consumer closes the tooltip.
|
|
700
|
+
unpinPress();
|
|
601
701
|
hideLayer();
|
|
602
702
|
}
|
|
603
|
-
}, [isOpen, clearTimeouts, showLayer, hideLayer]);
|
|
703
|
+
}, [isOpen, clearTimeouts, showLayer, hideLayer, unpinPress]);
|
|
604
704
|
|
|
605
705
|
// Dismiss on Escape (WCAG 1.4.13 — dismissible) through the shared layer
|
|
606
706
|
// stack. A visible tip is the top-most layer, so it takes the press and
|
|
@@ -641,6 +741,7 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
641
741
|
onDismiss: () => {
|
|
642
742
|
clearTimeouts();
|
|
643
743
|
clearTapOpen();
|
|
744
|
+
unpinPress();
|
|
644
745
|
if (isOpen !== undefined) {
|
|
645
746
|
onHide?.();
|
|
646
747
|
return;
|
|
@@ -677,7 +778,8 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
677
778
|
// something else in the shared interactive-ancestor walk, so a
|
|
678
779
|
// clickable container around the trigger leaves the press alone while
|
|
679
780
|
// document listeners still see it.
|
|
680
|
-
|
|
781
|
+
// The pin's announcement reads this element's text.
|
|
782
|
+
<div ref={contentRefs} {...stylex.props(styles.content)}>
|
|
681
783
|
{children}
|
|
682
784
|
</div>,
|
|
683
785
|
renderProps,
|
|
@@ -690,9 +792,20 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
690
792
|
popoverXstyle,
|
|
691
793
|
cancelHide,
|
|
692
794
|
scheduleHide,
|
|
795
|
+
contentRefs,
|
|
693
796
|
],
|
|
694
797
|
);
|
|
695
798
|
|
|
799
|
+
const show = useCallback(() => {
|
|
800
|
+
clearTimeouts();
|
|
801
|
+
holdPress();
|
|
802
|
+
}, [clearTimeouts, holdPress]);
|
|
803
|
+
|
|
804
|
+
const hide = useCallback(() => {
|
|
805
|
+
clearTimeouts();
|
|
806
|
+
releasePress();
|
|
807
|
+
}, [clearTimeouts, releasePress]);
|
|
808
|
+
|
|
696
809
|
return {
|
|
697
810
|
ref,
|
|
698
811
|
positionRef: layerRef,
|
|
@@ -700,5 +813,7 @@ export function useTooltip(options: TooltipOptions = {}): TooltipReturn {
|
|
|
700
813
|
anchorId: layerAnchorId,
|
|
701
814
|
describedBy: layerId,
|
|
702
815
|
renderTooltip,
|
|
816
|
+
show,
|
|
817
|
+
hide,
|
|
703
818
|
};
|
|
704
819
|
}
|
|
@@ -33,7 +33,7 @@ import type {LinkComponentType} from '../Link/types';
|
|
|
33
33
|
import {useTopNavRenderMode} from './TopNavRenderContext';
|
|
34
34
|
import {navItemStyles, type NavItemSize} from '../NavItem/navItemStyles.stylex';
|
|
35
35
|
import {mergeProps} from '../utils';
|
|
36
|
-
import {
|
|
36
|
+
import {useCloseMobileDrawerOnActivate} from '../AppShell/useCloseMobileDrawerOnActivate';
|
|
37
37
|
import {themeProps} from '../utils/themeProps';
|
|
38
38
|
import {focusOutlineProps} from '../utils/focusOutline.stylex';
|
|
39
39
|
import {interactionOverlayStyles} from '../utils/interactionOverlay.stylex';
|
|
@@ -199,7 +199,9 @@ export function TopNavItem({
|
|
|
199
199
|
const pressable = usePressFeedback();
|
|
200
200
|
const LinkComponent = useLinkComponent(as);
|
|
201
201
|
const renderMode = useTopNavRenderMode();
|
|
202
|
-
const
|
|
202
|
+
const closeDrawerAfter = useCloseMobileDrawerOnActivate(
|
|
203
|
+
renderMode === 'drawer',
|
|
204
|
+
);
|
|
203
205
|
|
|
204
206
|
// A disabled item renders as a plain <a> with no href: an href-less anchor
|
|
205
207
|
// is not focusable and exposes no link affordance, so programmatic focus +
|
|
@@ -214,14 +216,13 @@ export function TopNavItem({
|
|
|
214
216
|
// Drawer mode — render as a SideNavItem-style vertical list element
|
|
215
217
|
// =========================================================================
|
|
216
218
|
if (renderMode === 'drawer') {
|
|
219
|
+
const activate = closeDrawerAfter(onClick);
|
|
217
220
|
const handleDrawerClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
|
|
218
221
|
if (isDisabled) {
|
|
219
222
|
preventDefaultClick(e);
|
|
220
223
|
return;
|
|
221
224
|
}
|
|
222
|
-
|
|
223
|
-
onClick?.(e);
|
|
224
|
-
closeMobileNav();
|
|
225
|
+
activate?.(e);
|
|
225
226
|
};
|
|
226
227
|
|
|
227
228
|
return (
|
|
@@ -32,7 +32,7 @@ import type {LinkComponentType} from '../Link/types';
|
|
|
32
32
|
import {useTopNavRenderMode} from './TopNavRenderContext';
|
|
33
33
|
import {mergeProps} from '../utils';
|
|
34
34
|
import type {BaseProps} from '../BaseProps';
|
|
35
|
-
import {
|
|
35
|
+
import {useCloseMobileDrawerOnActivate} from '../AppShell/useCloseMobileDrawerOnActivate';
|
|
36
36
|
import {themeProps} from '../utils/themeProps';
|
|
37
37
|
import {focusOutlineProps} from '../utils/focusOutline.stylex';
|
|
38
38
|
import {interactionOverlayStyles} from '../utils/interactionOverlay.stylex';
|
|
@@ -200,7 +200,9 @@ export function TopNavMegaMenuItem({
|
|
|
200
200
|
const pressable = usePressFeedback();
|
|
201
201
|
const renderMode = useTopNavRenderMode();
|
|
202
202
|
const LinkComponent = useLinkComponent(as);
|
|
203
|
-
const
|
|
203
|
+
const closeDrawerAfter = useCloseMobileDrawerOnActivate(
|
|
204
|
+
renderMode === 'drawer',
|
|
205
|
+
);
|
|
204
206
|
|
|
205
207
|
// =========================================================================
|
|
206
208
|
// Drawer mode — matches SideNavItem / TopNavMenu drawer appearance
|
|
@@ -208,10 +210,9 @@ export function TopNavMegaMenuItem({
|
|
|
208
210
|
if (renderMode === 'drawer') {
|
|
209
211
|
const Element = href ? LinkComponent : 'button';
|
|
210
212
|
const elementProps = Element === 'button' ? {type: 'button' as const} : {};
|
|
211
|
-
const handleDrawerClick = () => {
|
|
213
|
+
const handleDrawerClick = closeDrawerAfter(() => {
|
|
212
214
|
onClick?.();
|
|
213
|
-
|
|
214
|
-
};
|
|
215
|
+
});
|
|
215
216
|
return (
|
|
216
217
|
<Element
|
|
217
218
|
{...restProps}
|
|
@@ -39,7 +39,7 @@ import type {BaseProps} from '../BaseProps';
|
|
|
39
39
|
import {navItemStyles} from '../NavItem/navItemStyles.stylex';
|
|
40
40
|
import {useTopNavSlot} from './TopNavContext';
|
|
41
41
|
import {useTopNavRenderMode} from './TopNavRenderContext';
|
|
42
|
-
import {
|
|
42
|
+
import {useCloseMobileDrawerOnActivate} from '../AppShell/useCloseMobileDrawerOnActivate';
|
|
43
43
|
import {useLinkComponent} from '../Link/useLinkComponent';
|
|
44
44
|
import {isSafeUrl} from '../utils/safeUrl';
|
|
45
45
|
import {themeProps} from '../utils/themeProps';
|
|
@@ -363,7 +363,9 @@ export function TopNavMenu({
|
|
|
363
363
|
}: TopNavMenuProps) {
|
|
364
364
|
const pressable = usePressFeedback();
|
|
365
365
|
const renderMode = useTopNavRenderMode();
|
|
366
|
-
const
|
|
366
|
+
const closeDrawerAfter = useCloseMobileDrawerOnActivate(
|
|
367
|
+
renderMode === 'drawer',
|
|
368
|
+
);
|
|
367
369
|
const LinkComponent = useLinkComponent();
|
|
368
370
|
const [drawerExpanded, setDrawerExpanded] = useState(false);
|
|
369
371
|
const menuId = useId();
|
|
@@ -524,10 +526,9 @@ export function TopNavMenu({
|
|
|
524
526
|
key={getMenuItemKey(item)}
|
|
525
527
|
href={item.href}
|
|
526
528
|
{...pressable}
|
|
527
|
-
onClick={(_e: React.MouseEvent) => {
|
|
529
|
+
onClick={closeDrawerAfter((_e: React.MouseEvent) => {
|
|
528
530
|
item.onClick?.();
|
|
529
|
-
|
|
530
|
-
}}
|
|
531
|
+
})}
|
|
531
532
|
{...focusOutlineProps.focusVisible(
|
|
532
533
|
navItemStyles.item,
|
|
533
534
|
interactionOverlayStyles.backgroundColor,
|
|
@@ -538,26 +538,40 @@ export function Typeahead<T extends SearchableItem>({
|
|
|
538
538
|
[editingValue, isEditing],
|
|
539
539
|
);
|
|
540
540
|
|
|
541
|
+
// Focus the token's button once it renders (the next cycle), so keyboard
|
|
542
|
+
// users stay in the component after edit mode ends.
|
|
543
|
+
const focusTokenNextFrame = useCallback(() => {
|
|
544
|
+
requestAnimationFrame(() => {
|
|
545
|
+
const tokenEl = tokenRef.current;
|
|
546
|
+
if (tokenEl) {
|
|
547
|
+
const button = tokenEl.querySelector('button');
|
|
548
|
+
(button ?? tokenEl).focus();
|
|
549
|
+
}
|
|
550
|
+
});
|
|
551
|
+
}, []);
|
|
552
|
+
|
|
541
553
|
// Handle selection from dropdown — clears edit mode
|
|
542
554
|
const handleChange = useCallback(
|
|
543
555
|
(item: T | null) => {
|
|
544
556
|
setIsEditing(false);
|
|
545
557
|
setEditingValue(null);
|
|
546
558
|
onChange(item);
|
|
547
|
-
// After selection, focus the token so keyboard users stay in the component.
|
|
548
|
-
// Use requestAnimationFrame because the token renders on the next cycle.
|
|
549
559
|
if (item) {
|
|
550
|
-
|
|
551
|
-
const tokenEl = tokenRef.current;
|
|
552
|
-
if (tokenEl) {
|
|
553
|
-
// Focus the internal button inside the token
|
|
554
|
-
const button = tokenEl.querySelector('button');
|
|
555
|
-
(button ?? tokenEl).focus();
|
|
556
|
-
}
|
|
557
|
-
});
|
|
560
|
+
focusTokenNextFrame();
|
|
558
561
|
}
|
|
559
562
|
},
|
|
560
|
-
[onChange],
|
|
563
|
+
[onChange, focusTokenNextFrame],
|
|
564
|
+
);
|
|
565
|
+
|
|
566
|
+
// Whether the base's list is shown: Escape then hides the list first, and
|
|
567
|
+
// edit mode stays.
|
|
568
|
+
const isListOpenRef = useRef(false);
|
|
569
|
+
const handleOpenChange = useCallback(
|
|
570
|
+
(isOpen: boolean) => {
|
|
571
|
+
isListOpenRef.current = isOpen;
|
|
572
|
+
onOpenChange?.(isOpen);
|
|
573
|
+
},
|
|
574
|
+
[onOpenChange],
|
|
561
575
|
);
|
|
562
576
|
|
|
563
577
|
// Handle clear (explicit X button on token). Edit mode copied the label into
|
|
@@ -593,14 +607,14 @@ export function Typeahead<T extends SearchableItem>({
|
|
|
593
607
|
if (isImeKeyEvent(e.nativeEvent)) {
|
|
594
608
|
return;
|
|
595
609
|
}
|
|
596
|
-
if (e.key === 'Escape' && editingValue) {
|
|
610
|
+
if (e.key === 'Escape' && editingValue && !isListOpenRef.current) {
|
|
597
611
|
e.preventDefault();
|
|
598
612
|
setIsEditing(false);
|
|
599
613
|
setEditingValue(null);
|
|
600
|
-
|
|
614
|
+
focusTokenNextFrame();
|
|
601
615
|
}
|
|
602
616
|
},
|
|
603
|
-
[editingValue],
|
|
617
|
+
[editingValue, focusTokenNextFrame],
|
|
604
618
|
);
|
|
605
619
|
|
|
606
620
|
// Click wrapper to focus input or enter edit mode
|
|
@@ -738,7 +752,7 @@ export function Typeahead<T extends SearchableItem>({
|
|
|
738
752
|
// aria-required / aria-invalid still applies.
|
|
739
753
|
aria-invalid={status?.type === 'error' || rest['aria-invalid']}
|
|
740
754
|
onChangeQuery={onChangeQuery}
|
|
741
|
-
onOpenChange={
|
|
755
|
+
onOpenChange={handleOpenChange}
|
|
742
756
|
debounceMs={debounceMs}
|
|
743
757
|
anchorRef={wrapperRef}
|
|
744
758
|
onKeyDown={handleKeyDown}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
// Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
2
|
+
|
|
3
|
+
/** @type {import('@astryxdesign/cli/authoring').HookDoc} */
|
|
4
|
+
export const docs = {
|
|
5
|
+
name: 'createAnimator',
|
|
6
|
+
displayName: 'createAnimator',
|
|
7
|
+
// A factory documented as a hook: listed with the utilities, beside its
|
|
8
|
+
// hook, not as a tile in the components gallery.
|
|
9
|
+
group: 'Utilities',
|
|
10
|
+
keywords: [
|
|
11
|
+
'animate',
|
|
12
|
+
'animation',
|
|
13
|
+
'animator',
|
|
14
|
+
'spring',
|
|
15
|
+
'decay',
|
|
16
|
+
'momentum',
|
|
17
|
+
'fling',
|
|
18
|
+
'motion',
|
|
19
|
+
'transform',
|
|
20
|
+
'opacity',
|
|
21
|
+
'vanilla',
|
|
22
|
+
'factory',
|
|
23
|
+
],
|
|
24
|
+
params: [
|
|
25
|
+
{
|
|
26
|
+
name: 'element',
|
|
27
|
+
type: 'HTMLElement',
|
|
28
|
+
description:
|
|
29
|
+
'The element to animate. The animator writes its `translate`, `scale`, `rotate` and `opacity`, and while it moves an inline `will-change` for them, merged with any it already has and restored 500 ms after its last motion; nothing else, so lay it out and style it as usual. Use one animator per element: two on one element overwrite each other.',
|
|
30
|
+
required: true,
|
|
31
|
+
},
|
|
32
|
+
],
|
|
33
|
+
returns: [
|
|
34
|
+
{
|
|
35
|
+
name: 'animate',
|
|
36
|
+
type: '(target: {x?, y?, scale?, rotate?, opacity?}, options?: {velocity?}) => Promise<void>',
|
|
37
|
+
description:
|
|
38
|
+
"Springs the given channels to `target` from wherever they are on screen, on the state-change motion Astryx's components use, and resolves when they arrive (or as soon as a later call takes them over). `x` and `y` are px, `scale` is 1 at the element's size, `rotate` is degrees and `opacity` runs from 0 to 1. Pass `velocity` (units per second, such as a drag's release velocity) to start with it; without it a channel keeps the velocity it has on screen, so interrupting a motion never jumps.",
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
name: 'decay',
|
|
42
|
+
type: '(velocity: {x?, y?, scale?, rotate?, opacity?}) => Promise<void>',
|
|
43
|
+
description:
|
|
44
|
+
"Coasts the given channels from a release velocity in their units per second, slowing as a scroll view's momentum does, and resolves when they stop (or as soon as a later call takes any of them over); opacity stops at 0 or 1. The distance follows from the velocity: use it to fling something away, then remove or reset it.",
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
name: 'set',
|
|
48
|
+
type: '(values: {x?, y?, scale?, rotate?, opacity?}) => void',
|
|
49
|
+
description:
|
|
50
|
+
'Puts the given channels at these values at once, ending their motion: follow a finger with it, frame by frame.',
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
name: 'get',
|
|
54
|
+
type: '() => {x, y, scale, rotate, opacity}',
|
|
55
|
+
description: "Every channel's value on screen now.",
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
name: 'getVelocity',
|
|
59
|
+
type: '() => {x, y, scale, rotate, opacity}',
|
|
60
|
+
description:
|
|
61
|
+
"Every channel's velocity on screen now, in units per second.",
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
name: 'stop',
|
|
65
|
+
type: '() => void',
|
|
66
|
+
description: 'Halts every channel where it is on screen.',
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
name: 'destroy',
|
|
70
|
+
type: '() => void',
|
|
71
|
+
description:
|
|
72
|
+
'Stops every motion and lets the element go; the element keeps the values it shows. Call it when you remove the element or no longer animate it.',
|
|
73
|
+
},
|
|
74
|
+
],
|
|
75
|
+
usage: {
|
|
76
|
+
description:
|
|
77
|
+
"Animates one element with the motion Astryx's own components use, without React. `animate` springs an element to new values on the state-change motion, `decay` flings it with the momentum of a released scroll view, and `set` moves it directly, so a card can follow a finger, snap back and be thrown away. Use the `useAnimator` hook in React. To animate an area's layout as its items change, use `useAnimatedLayout`; for what a component already animates, such as a sheet's detents or a carousel's snapping, use the component's own props.",
|
|
78
|
+
bestPractices: [
|
|
79
|
+
{
|
|
80
|
+
guidance: true,
|
|
81
|
+
description:
|
|
82
|
+
'Start every `animate` that follows a drag with the release velocity, so the element carries on as it was thrown.',
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
guidance: true,
|
|
86
|
+
description:
|
|
87
|
+
'Reach every state an animation shows without the animation too: a key, a button or a menu item that calls the same code.',
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
guidance: true,
|
|
91
|
+
description:
|
|
92
|
+
'`await` the promise before removing an element you animate out, and call `destroy` once it is gone.',
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
guidance: false,
|
|
96
|
+
description:
|
|
97
|
+
'Read the element\u2019s position from layout while it moves: `get` gives the value on screen, wherever the motion runs.',
|
|
98
|
+
},
|
|
99
|
+
],
|
|
100
|
+
accessibility: [
|
|
101
|
+
{
|
|
102
|
+
name: 'Keyboard and assistive technology',
|
|
103
|
+
category: 'Keyboard',
|
|
104
|
+
description:
|
|
105
|
+
'An animator moves an element; it adds no way to act. Give every action an animation stands for a control a keyboard and a screen reader can reach, such as a button that discards a card, and have it call `animate`, which Reduce Motion turns into a fade in place. Keep `decay` for a throw the person made: Reduce Motion keeps the momentum of a coast, as it continues that throw. Keep focus on an element that stays on screen: move it before you fling its element away.',
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
name: 'Reduce Motion',
|
|
109
|
+
category: 'Content',
|
|
110
|
+
criterion: '2.3.3 Animation from Interactions',
|
|
111
|
+
description:
|
|
112
|
+
'When the person asks for reduced motion, every call is planned for them. On a touch screen a move or a scale becomes a short opacity cross-fade: the element fades out where it was and fades back in where it lands. With a mouse it lands at once. A decay of `x` and `y` keeps its momentum, as it continues the throw the person made; a decay of `scale`, `rotate` or `opacity` is planned like a move. No option turns this off.',
|
|
113
|
+
},
|
|
114
|
+
],
|
|
115
|
+
},
|
|
116
|
+
relatedHooks: ['useAnimator', 'useAnimatedLayout'],
|
|
117
|
+
importPath: '@astryxdesign/core',
|
|
118
|
+
category: 'interaction',
|
|
119
|
+
};
|
|
120
|
+
|
|
121
|
+
/** @type {import('@astryxdesign/cli/authoring').HookTranslationDoc} */
|
|
122
|
+
export const docsDense = {
|
|
123
|
+
description:
|
|
124
|
+
"Animates one element (x, y, scale, rotate, opacity) with Astryx's motion, without React.",
|
|
125
|
+
paramDescriptions: {
|
|
126
|
+
element: 'The element to animate; one animator per element.',
|
|
127
|
+
},
|
|
128
|
+
returnDescriptions: {
|
|
129
|
+
animate:
|
|
130
|
+
'(target, {velocity?}) => Promise<void>; springs on the state-change motion.',
|
|
131
|
+
decay:
|
|
132
|
+
'({x?, y?, scale?, rotate?, opacity?}) => Promise<void>; coasts from a release velocity.',
|
|
133
|
+
set: '(values) => void; jumps, ending motion.',
|
|
134
|
+
get: '() => every value on screen.',
|
|
135
|
+
getVelocity: '() => every velocity on screen.',
|
|
136
|
+
stop: '() => void; halts where it is.',
|
|
137
|
+
destroy: '() => void; lets the element go.',
|
|
138
|
+
},
|
|
139
|
+
usage: {
|
|
140
|
+
description:
|
|
141
|
+
'Spring with animate, fling with decay, follow a finger with set. Reduce Motion: a cross-fade on touch, at once with a mouse; decay keeps its momentum.',
|
|
142
|
+
bestPractices: [
|
|
143
|
+
{
|
|
144
|
+
guidance: true,
|
|
145
|
+
description: 'Pass the release velocity to animate after a drag.',
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
guidance: false,
|
|
149
|
+
description: 'Read layout for the position mid-motion; use get.',
|
|
150
|
+
},
|
|
151
|
+
],
|
|
152
|
+
},
|
|
153
|
+
};
|