@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.
Files changed (504) hide show
  1. package/dist/AlertDialog/AlertDialog.d.ts +4 -1
  2. package/dist/AlertDialog/AlertDialog.d.ts.map +1 -1
  3. package/dist/AlertDialog/AlertDialog.js +36 -6
  4. package/dist/AppShell/useCloseMobileDrawerOnActivate.d.ts +13 -0
  5. package/dist/AppShell/useCloseMobileDrawerOnActivate.d.ts.map +1 -0
  6. package/dist/AppShell/useCloseMobileDrawerOnActivate.js +45 -0
  7. package/dist/Avatar/Avatar.d.ts.map +1 -1
  8. package/dist/Avatar/Avatar.js +1 -1
  9. package/dist/BottomSheet/BottomSheet.d.ts.map +1 -1
  10. package/dist/BottomSheet/BottomSheet.js +79 -9
  11. package/dist/BottomSheet/BottomSheetPanel.d.ts.map +1 -1
  12. package/dist/BottomSheet/BottomSheetPanel.js +23 -4
  13. package/dist/BottomSheet/bottomSheetStack.d.ts.map +1 -1
  14. package/dist/BottomSheet/bottomSheetStack.js +5 -4
  15. package/dist/BottomSheet/useSheetGestures.d.ts.map +1 -1
  16. package/dist/BottomSheet/useSheetGestures.js +3 -1
  17. package/dist/Breadcrumbs/BreadcrumbItem.d.ts +2 -1
  18. package/dist/Breadcrumbs/BreadcrumbItem.d.ts.map +1 -1
  19. package/dist/Breadcrumbs/BreadcrumbItem.js +9 -4
  20. package/dist/Button/Button.d.ts.map +1 -1
  21. package/dist/Button/Button.js +50 -5
  22. package/dist/CheckboxList/CheckboxList.d.ts.map +1 -1
  23. package/dist/CheckboxList/CheckboxList.js +7 -1
  24. package/dist/CheckboxList/CheckboxListContext.d.ts +6 -0
  25. package/dist/CheckboxList/CheckboxListContext.d.ts.map +1 -1
  26. package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
  27. package/dist/CheckboxList/CheckboxListItem.js +10 -2
  28. package/dist/ComplexSelector/ComplexSelector.d.ts +4 -1
  29. package/dist/ComplexSelector/ComplexSelector.d.ts.map +1 -1
  30. package/dist/ComplexSelector/ComplexSelector.js +14 -4
  31. package/dist/DateInput/DateInput.d.ts.map +1 -1
  32. package/dist/DateInput/DateInput.js +5 -2
  33. package/dist/DateInput/MonthScroller.d.ts.map +1 -1
  34. package/dist/DateInput/MonthScroller.js +13 -27
  35. package/dist/DateInput/Wheel.d.ts +17 -1
  36. package/dist/DateInput/Wheel.d.ts.map +1 -1
  37. package/dist/DateInput/Wheel.js +161 -20
  38. package/dist/DateRangeInput/DateRangeInput.d.ts.map +1 -1
  39. package/dist/DateRangeInput/DateRangeInput.js +63 -49
  40. package/dist/DateTimeInput/DateTimeInput.d.ts.map +1 -1
  41. package/dist/DateTimeInput/DateTimeInput.js +5 -2
  42. package/dist/Dialog/Dialog.d.ts.map +1 -1
  43. package/dist/Dialog/Dialog.js +53 -15
  44. package/dist/Drawer/Drawer.d.ts.map +1 -1
  45. package/dist/Drawer/Drawer.js +15 -11
  46. package/dist/Drawer/useDrawerDialogPresence.d.ts.map +1 -1
  47. package/dist/Drawer/useDrawerDialogPresence.js +9 -1
  48. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  49. package/dist/DropdownMenu/DropdownMenu.js +20 -4
  50. package/dist/Field/Field.js +2 -2
  51. package/dist/Field/PanelSearchInput.d.ts +9 -1
  52. package/dist/Field/PanelSearchInput.d.ts.map +1 -1
  53. package/dist/Field/PanelSearchInput.js +3 -1
  54. package/dist/HoverCard/HoverCard.d.ts.map +1 -1
  55. package/dist/HoverCard/HoverCard.js +27 -2
  56. package/dist/Icon/Icon.d.ts +5 -1
  57. package/dist/Icon/Icon.d.ts.map +1 -1
  58. package/dist/Icon/Icon.js +5 -2
  59. package/dist/InfoTip/InfoTip.d.ts +63 -0
  60. package/dist/InfoTip/InfoTip.d.ts.map +1 -0
  61. package/dist/InfoTip/InfoTip.js +126 -0
  62. package/dist/InfoTip/index.d.ts +10 -0
  63. package/dist/InfoTip/index.d.ts.map +1 -0
  64. package/dist/InfoTip/index.js +12 -0
  65. package/dist/Layer/layerAnimations.stylex.d.ts +7 -8
  66. package/dist/Layer/layerAnimations.stylex.d.ts.map +1 -1
  67. package/dist/Layer/layerAnimations.stylex.js +25 -20
  68. package/dist/Layer/layerClickBoundary.d.ts +7 -1
  69. package/dist/Layer/layerClickBoundary.d.ts.map +1 -1
  70. package/dist/Layer/layerClickBoundary.js +2 -2
  71. package/dist/Layer/useBackdropPress.d.ts +27 -0
  72. package/dist/Layer/useBackdropPress.d.ts.map +1 -0
  73. package/dist/Layer/useBackdropPress.js +53 -0
  74. package/dist/Layer/usePressPin.d.ts +105 -0
  75. package/dist/Layer/usePressPin.d.ts.map +1 -0
  76. package/dist/Layer/usePressPin.js +413 -0
  77. package/dist/Layer/useTouchTrigger.d.ts +23 -1
  78. package/dist/Layer/useTouchTrigger.d.ts.map +1 -1
  79. package/dist/Layer/useTouchTrigger.js +45 -7
  80. package/dist/Lightbox/Lightbox.d.ts.map +1 -1
  81. package/dist/Lightbox/Lightbox.js +2 -1
  82. package/dist/MobileNav/MobileNav.js +0 -1
  83. package/dist/MultiSelector/hooks.d.ts.map +1 -1
  84. package/dist/MultiSelector/hooks.js +2 -4
  85. package/dist/Outline/Outline.d.ts +2 -4
  86. package/dist/Outline/Outline.d.ts.map +1 -1
  87. package/dist/Outline/Outline.js +4 -52
  88. package/dist/Outline/useOutlineFromMarkdown.d.ts.map +1 -1
  89. package/dist/Outline/useOutlineFromMarkdown.js +1 -0
  90. package/dist/Outline/useScrollSpy.js +3 -3
  91. package/dist/Popover/usePopover.d.ts.map +1 -1
  92. package/dist/Popover/usePopover.js +56 -7
  93. package/dist/PowerSearch/PowerSearch.d.ts +36 -3
  94. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  95. package/dist/PowerSearch/PowerSearch.js +571 -302
  96. package/dist/PowerSearch/PowerSearchBottomSheet.d.ts +100 -0
  97. package/dist/PowerSearch/PowerSearchBottomSheet.d.ts.map +1 -0
  98. package/dist/PowerSearch/PowerSearchBottomSheet.js +1913 -0
  99. package/dist/PowerSearch/PowerSearchEditPopover.d.ts +32 -1
  100. package/dist/PowerSearch/PowerSearchEditPopover.d.ts.map +1 -1
  101. package/dist/PowerSearch/PowerSearchEditPopover.js +17 -6
  102. package/dist/PowerSearch/PowerSearchValueEditor.d.ts +38 -3
  103. package/dist/PowerSearch/PowerSearchValueEditor.d.ts.map +1 -1
  104. package/dist/PowerSearch/PowerSearchValueEditor.js +170 -61
  105. package/dist/PowerSearch/formatFilterValue.d.ts +7 -0
  106. package/dist/PowerSearch/formatFilterValue.d.ts.map +1 -1
  107. package/dist/PowerSearch/formatFilterValue.js +11 -1
  108. package/dist/PowerSearch/formatTokenValue.d.ts +28 -0
  109. package/dist/PowerSearch/formatTokenValue.d.ts.map +1 -0
  110. package/dist/PowerSearch/formatTokenValue.js +160 -0
  111. package/dist/PowerSearch/powerSearchSheetUtils.d.ts +65 -0
  112. package/dist/PowerSearch/powerSearchSheetUtils.d.ts.map +1 -0
  113. package/dist/PowerSearch/powerSearchSheetUtils.js +168 -0
  114. package/dist/ProgressBar/ProgressBar.d.ts +1 -1
  115. package/dist/ProgressBar/ProgressBar.d.ts.map +1 -1
  116. package/dist/ProgressBar/ProgressBar.js +33 -6
  117. package/dist/RadioList/RadioList.d.ts.map +1 -1
  118. package/dist/RadioList/RadioList.js +8 -2
  119. package/dist/RadioList/RadioListItem.d.ts +1 -1
  120. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  121. package/dist/RadioList/RadioListItem.js +5 -3
  122. package/dist/Resizable/ResizeHandle.d.ts.map +1 -1
  123. package/dist/Resizable/ResizeHandle.js +118 -260
  124. package/dist/Resizable/resizeGesture.d.ts +91 -0
  125. package/dist/Resizable/resizeGesture.d.ts.map +1 -0
  126. package/dist/Resizable/resizeGesture.js +251 -0
  127. package/dist/SegmentedControl/SegmentedControl.d.ts +3 -1
  128. package/dist/SegmentedControl/SegmentedControl.d.ts.map +1 -1
  129. package/dist/SegmentedControl/SegmentedControl.js +115 -8
  130. package/dist/SegmentedControl/SegmentedControlContext.d.ts +6 -0
  131. package/dist/SegmentedControl/SegmentedControlContext.d.ts.map +1 -1
  132. package/dist/SegmentedControl/SegmentedControlItem.d.ts +1 -0
  133. package/dist/SegmentedControl/SegmentedControlItem.d.ts.map +1 -1
  134. package/dist/SegmentedControl/SegmentedControlItem.js +10 -2
  135. package/dist/SegmentedControl/useSegmentedSelectionMotion.d.ts +357 -0
  136. package/dist/SegmentedControl/useSegmentedSelectionMotion.d.ts.map +1 -0
  137. package/dist/SegmentedControl/useSegmentedSelectionMotion.js +1349 -0
  138. package/dist/SegmentedControl/useSegmentedTouchTracking.d.ts +70 -0
  139. package/dist/SegmentedControl/useSegmentedTouchTracking.d.ts.map +1 -0
  140. package/dist/SegmentedControl/useSegmentedTouchTracking.js +264 -0
  141. package/dist/Selector/Selector.d.ts.map +1 -1
  142. package/dist/Selector/Selector.js +96 -67
  143. package/dist/Selector/optionShape.d.ts +24 -0
  144. package/dist/Selector/optionShape.d.ts.map +1 -0
  145. package/dist/Selector/optionShape.js +48 -0
  146. package/dist/Selector/selectableOptionEntries.d.ts +20 -0
  147. package/dist/Selector/selectableOptionEntries.d.ts.map +1 -0
  148. package/dist/Selector/selectableOptionEntries.js +38 -0
  149. package/dist/Selector/utils.d.ts +2 -17
  150. package/dist/Selector/utils.d.ts.map +1 -1
  151. package/dist/Selector/utils.js +3 -51
  152. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  153. package/dist/SideNav/SideNavItem.js +3 -9
  154. package/dist/Slider/sliderTouchController.js +2 -2
  155. package/dist/Switch/Switch.d.ts +1 -1
  156. package/dist/Switch/Switch.d.ts.map +1 -1
  157. package/dist/Switch/Switch.js +200 -46
  158. package/dist/Switch/switchFill.d.ts +31 -0
  159. package/dist/Switch/switchFill.d.ts.map +1 -0
  160. package/dist/Switch/switchFill.js +88 -0
  161. package/dist/Switch/switchTouch.d.ts +74 -0
  162. package/dist/Switch/switchTouch.d.ts.map +1 -0
  163. package/dist/Switch/switchTouch.js +125 -0
  164. package/dist/Switch/useSwitchTouch.d.ts +276 -0
  165. package/dist/Switch/useSwitchTouch.d.ts.map +1 -0
  166. package/dist/Switch/useSwitchTouch.js +939 -0
  167. package/dist/TabList/Tab.d.ts.map +1 -1
  168. package/dist/TabList/Tab.js +4 -3
  169. package/dist/Table/BaseTable.d.ts.map +1 -1
  170. package/dist/Table/BaseTable.js +29 -8
  171. package/dist/TextInput/TextInput.d.ts +2 -2
  172. package/dist/TextInput/TextInput.d.ts.map +1 -1
  173. package/dist/TextInput/TextInput.js +10 -7
  174. package/dist/Toast/Toast.d.ts.map +1 -1
  175. package/dist/Toast/Toast.js +5 -0
  176. package/dist/Token/Token.d.ts +2 -2
  177. package/dist/Token/Token.d.ts.map +1 -1
  178. package/dist/Token/Token.js +13 -4
  179. package/dist/Token/TokenNamingContext.d.ts +14 -0
  180. package/dist/Token/TokenNamingContext.d.ts.map +1 -0
  181. package/dist/Token/TokenNamingContext.js +23 -0
  182. package/dist/Tokenizer/Tokenizer.d.ts +46 -59
  183. package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
  184. package/dist/Tokenizer/Tokenizer.js +44 -60
  185. package/dist/Tokenizer/TokenizerBottomSheet.d.ts +25 -28
  186. package/dist/Tokenizer/TokenizerBottomSheet.d.ts.map +1 -1
  187. package/dist/Tokenizer/TokenizerBottomSheet.js +157 -54
  188. package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts +3 -0
  189. package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts.map +1 -0
  190. package/dist/Tokenizer/TokenizerItemRemovableContext.js +19 -0
  191. package/dist/Tooltip/Tooltip.d.ts +24 -5
  192. package/dist/Tooltip/Tooltip.d.ts.map +1 -1
  193. package/dist/Tooltip/Tooltip.js +29 -5
  194. package/dist/Tooltip/useTooltip.d.ts +48 -5
  195. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  196. package/dist/Tooltip/useTooltip.js +90 -20
  197. package/dist/TopNav/TopNavItem.d.ts.map +1 -1
  198. package/dist/TopNav/TopNavItem.js +4 -7
  199. package/dist/TopNav/TopNavMegaMenuItem.d.ts.map +1 -1
  200. package/dist/TopNav/TopNavMegaMenuItem.js +4 -7
  201. package/dist/TopNav/TopNavMenu.d.ts.map +1 -1
  202. package/dist/TopNav/TopNavMenu.js +4 -7
  203. package/dist/Typeahead/Typeahead.d.ts.map +1 -1
  204. package/dist/Typeahead/Typeahead.js +26 -15
  205. package/dist/animator/createAnimator.d.ts +98 -0
  206. package/dist/animator/createAnimator.d.ts.map +1 -0
  207. package/dist/animator/createAnimator.js +259 -0
  208. package/dist/astryx.css +142 -7
  209. package/dist/gestures/GestureHost.d.ts +27 -1
  210. package/dist/gestures/GestureHost.d.ts.map +1 -1
  211. package/dist/gestures/GestureHost.js +161 -22
  212. package/dist/gestures/PressTracker.d.ts +6 -0
  213. package/dist/gestures/PressTracker.d.ts.map +1 -1
  214. package/dist/gestures/PressTracker.js +3 -0
  215. package/dist/gestures/types.d.ts +6 -0
  216. package/dist/gestures/types.d.ts.map +1 -1
  217. package/dist/gestures/usePressTracker.d.ts.map +1 -1
  218. package/dist/gestures/usePressTracker.js +1 -0
  219. package/dist/gestures/wheelSegmenter.d.ts +14 -3
  220. package/dist/gestures/wheelSegmenter.d.ts.map +1 -1
  221. package/dist/gestures/wheelSegmenter.js +32 -8
  222. package/dist/hooks/actionGroupTracker.d.ts +7 -4
  223. package/dist/hooks/actionGroupTracker.d.ts.map +1 -1
  224. package/dist/hooks/actionGroupTracker.js +19 -56
  225. package/dist/hooks/index.d.ts +1 -0
  226. package/dist/hooks/index.d.ts.map +1 -1
  227. package/dist/hooks/index.js +1 -0
  228. package/dist/hooks/pressGroupContext.d.ts +6 -0
  229. package/dist/hooks/pressGroupContext.d.ts.map +1 -0
  230. package/dist/hooks/pressGroupContext.js +20 -0
  231. package/dist/hooks/useActionGroupTracking.d.ts +53 -0
  232. package/dist/hooks/useActionGroupTracking.d.ts.map +1 -0
  233. package/dist/hooks/useActionGroupTracking.js +174 -0
  234. package/dist/hooks/useAnimator.d.ts +41 -0
  235. package/dist/hooks/useAnimator.d.ts.map +1 -0
  236. package/dist/hooks/useAnimator.js +70 -0
  237. package/dist/hooks/useAttachment.d.ts +16 -8
  238. package/dist/hooks/useAttachment.d.ts.map +1 -1
  239. package/dist/hooks/useAttachment.js +35 -15
  240. package/dist/hooks/useFocusTrap.d.ts +15 -0
  241. package/dist/hooks/useFocusTrap.d.ts.map +1 -1
  242. package/dist/hooks/useFocusTrap.js +13 -2
  243. package/dist/hooks/useHighlightedOptionScroll.d.ts +11 -1
  244. package/dist/hooks/useHighlightedOptionScroll.d.ts.map +1 -1
  245. package/dist/hooks/useHighlightedOptionScroll.js +112 -11
  246. package/dist/hooks/useInputStatusIcon.d.ts +1 -1
  247. package/dist/hooks/useInputStatusIcon.d.ts.map +1 -1
  248. package/dist/hooks/useInputStatusIcon.js +2 -2
  249. package/dist/hooks/useMediaQuery.d.ts +2 -1
  250. package/dist/hooks/useMediaQuery.d.ts.map +1 -1
  251. package/dist/hooks/useMediaQuery.js +7 -4
  252. package/dist/hooks/useMenuPress.d.ts.map +1 -1
  253. package/dist/hooks/useMenuPress.js +4 -2
  254. package/dist/hooks/usePager.d.ts +261 -0
  255. package/dist/hooks/usePager.d.ts.map +1 -0
  256. package/dist/hooks/usePager.js +1169 -0
  257. package/dist/i18n/generated-english/InfoTip/InfoTip.generated.d.ts +8 -0
  258. package/dist/i18n/generated-english/InfoTip/InfoTip.generated.d.ts.map +1 -0
  259. package/dist/i18n/generated-english/InfoTip/InfoTip.generated.js +12 -0
  260. package/dist/i18n/generated-english/PowerSearch/PowerSearch.generated.d.ts.map +1 -1
  261. package/dist/i18n/generated-english/PowerSearch/PowerSearch.generated.js +1 -0
  262. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts +8 -0
  263. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.d.ts.map +1 -0
  264. package/dist/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.js +42 -0
  265. package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.d.ts.map +1 -1
  266. package/dist/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.js +6 -0
  267. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts +8 -0
  268. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.d.ts.map +1 -0
  269. package/dist/i18n/generated-english/PowerSearch/formatTokenValue.generated.js +14 -0
  270. package/dist/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.d.ts.map +1 -1
  271. package/dist/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.js +7 -1
  272. package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
  273. package/dist/i18n/generated-locales/en.generated.js +33 -1
  274. package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
  275. package/dist/i18n/generated-locales/pseudo.generated.js +33 -1
  276. package/dist/index.d.ts +2 -0
  277. package/dist/index.d.ts.map +1 -1
  278. package/dist/index.js +5 -0
  279. package/dist/internal/SheetConfirmation.d.ts +11 -0
  280. package/dist/internal/SheetConfirmation.d.ts.map +1 -0
  281. package/dist/internal/SheetConfirmation.js +92 -0
  282. package/dist/internal/sheetDraft.d.ts +35 -0
  283. package/dist/internal/sheetDraft.d.ts.map +1 -0
  284. package/dist/internal/sheetDraft.js +65 -0
  285. package/dist/internal/touch-sheet.d.ts +21 -0
  286. package/dist/internal/touch-sheet.d.ts.map +1 -0
  287. package/dist/internal/touch-sheet.js +19 -0
  288. package/dist/internal/useDismissSearchOnTouchDrag.d.ts +24 -0
  289. package/dist/internal/useDismissSearchOnTouchDrag.d.ts.map +1 -0
  290. package/dist/internal/useDismissSearchOnTouchDrag.js +56 -0
  291. package/dist/motion/animator.d.ts +14 -14
  292. package/dist/motion/animator.d.ts.map +1 -1
  293. package/dist/motion/animator.js +41 -18
  294. package/dist/motion/paging.d.ts +16 -5
  295. package/dist/motion/paging.d.ts.map +1 -1
  296. package/dist/motion/paging.js +34 -14
  297. package/dist/motion/reducedMotion.d.ts +24 -0
  298. package/dist/motion/reducedMotion.d.ts.map +1 -1
  299. package/dist/motion/reducedMotion.js +78 -1
  300. package/dist/motion/roles.d.ts +7 -1
  301. package/dist/motion/roles.d.ts.map +1 -1
  302. package/dist/motion/roles.js +20 -1
  303. package/dist/motion/uikit/alert.d.ts +41 -0
  304. package/dist/motion/uikit/alert.d.ts.map +1 -0
  305. package/dist/motion/uikit/alert.js +43 -0
  306. package/dist/motion/uikit/index.d.ts +7 -4
  307. package/dist/motion/uikit/index.d.ts.map +1 -1
  308. package/dist/motion/uikit/index.js +7 -4
  309. package/dist/motion/uikit/paging.d.ts +31 -20
  310. package/dist/motion/uikit/paging.d.ts.map +1 -1
  311. package/dist/motion/uikit/paging.js +41 -11
  312. package/dist/motion/uikit/progressBar.d.ts +27 -7
  313. package/dist/motion/uikit/progressBar.d.ts.map +1 -1
  314. package/dist/motion/uikit/progressBar.js +31 -11
  315. package/dist/motion/uikit/segmented.d.ts +55 -0
  316. package/dist/motion/uikit/segmented.d.ts.map +1 -0
  317. package/dist/motion/uikit/segmented.js +77 -0
  318. package/dist/motion/uikit/springs.d.ts +8 -42
  319. package/dist/motion/uikit/springs.d.ts.map +1 -1
  320. package/dist/motion/uikit/springs.js +12 -42
  321. package/dist/motion/uikit/switch.d.ts +166 -0
  322. package/dist/motion/uikit/switch.d.ts.map +1 -0
  323. package/dist/motion/uikit/switch.js +186 -0
  324. package/dist/privateAttributes/pressGroupItem.stylex.d.ts +15 -0
  325. package/dist/privateAttributes/pressGroupItem.stylex.d.ts.map +1 -0
  326. package/dist/privateAttributes/pressGroupItem.stylex.js +23 -0
  327. package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts +18 -0
  328. package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts.map +1 -0
  329. package/dist/privateAttributes/pressHoldsDrag.stylex.js +28 -0
  330. package/dist/privateAttributes/segmentTitle.stylex.d.ts +5 -0
  331. package/dist/privateAttributes/segmentTitle.stylex.d.ts.map +1 -0
  332. package/dist/privateAttributes/segmentTitle.stylex.js +22 -0
  333. package/dist/utils/browserClickWait.d.ts +35 -0
  334. package/dist/utils/browserClickWait.d.ts.map +1 -0
  335. package/dist/utils/browserClickWait.js +123 -0
  336. package/dist/utils/clickGuard.d.ts +14 -1
  337. package/dist/utils/clickGuard.d.ts.map +1 -1
  338. package/dist/utils/clickGuard.js +46 -1
  339. package/dist/utils/dateParser.d.ts.map +1 -1
  340. package/dist/utils/dateParser.js +12 -0
  341. package/dist/utils/interactionOverlay.stylex.d.ts +3 -2
  342. package/dist/utils/interactionOverlay.stylex.d.ts.map +1 -1
  343. package/dist/utils/interactionOverlay.stylex.js +3 -2
  344. package/dist/utils/pressFeedback.d.ts.map +1 -1
  345. package/dist/utils/pressFeedback.js +24 -6
  346. package/locales/en.json +128 -0
  347. package/locales/pseudo.json +96 -0
  348. package/package.json +13 -8
  349. package/src/AlertDialog/AlertDialog.doc.mjs +2 -2
  350. package/src/AlertDialog/AlertDialog.tsx +37 -5
  351. package/src/AppShell/useCloseMobileDrawerOnActivate.ts +52 -0
  352. package/src/Avatar/Avatar.tsx +3 -1
  353. package/src/BottomSheet/BottomSheet.tsx +95 -10
  354. package/src/BottomSheet/BottomSheetPanel.tsx +40 -5
  355. package/src/BottomSheet/bottomSheetStack.ts +8 -4
  356. package/src/BottomSheet/useSheetGestures.ts +3 -1
  357. package/src/Breadcrumbs/BreadcrumbItem.tsx +17 -4
  358. package/src/Button/Button.tsx +66 -7
  359. package/src/CheckboxList/CheckboxList.doc.mjs +4 -2
  360. package/src/CheckboxList/CheckboxList.tsx +6 -0
  361. package/src/CheckboxList/CheckboxListContext.tsx +6 -0
  362. package/src/CheckboxList/CheckboxListItem.tsx +11 -2
  363. package/src/ComplexSelector/ComplexSelector.tsx +20 -5
  364. package/src/DateInput/DateInput.tsx +8 -2
  365. package/src/DateInput/MonthScroller.tsx +18 -22
  366. package/src/DateInput/Wheel.tsx +172 -14
  367. package/src/DateRangeInput/DateRangeInput.doc.mjs +3 -2
  368. package/src/DateRangeInput/DateRangeInput.tsx +117 -71
  369. package/src/DateTimeInput/DateTimeInput.tsx +8 -2
  370. package/src/Dialog/Dialog.tsx +81 -15
  371. package/src/Drawer/Drawer.tsx +28 -11
  372. package/src/Drawer/useDrawerDialogPresence.ts +9 -1
  373. package/src/DropdownMenu/DropdownMenu.tsx +28 -6
  374. package/src/Field/Field.tsx +2 -2
  375. package/src/Field/PanelSearchInput.tsx +11 -0
  376. package/src/HoverCard/HoverCard.tsx +31 -1
  377. package/src/Icon/Icon.doc.mjs +49 -8
  378. package/src/Icon/Icon.tsx +15 -7
  379. package/src/InfoTip/InfoTip.doc.mjs +192 -0
  380. package/src/InfoTip/InfoTip.tsx +186 -0
  381. package/src/InfoTip/index.ts +14 -0
  382. package/src/Layer/layerAnimations.stylex.ts +24 -16
  383. package/src/Layer/layerClickBoundary.ts +2 -2
  384. package/src/Layer/useBackdropPress.ts +81 -0
  385. package/src/Layer/usePressPin.ts +576 -0
  386. package/src/Layer/useTouchTrigger.ts +56 -6
  387. package/src/Lightbox/Lightbox.tsx +2 -1
  388. package/src/MobileNav/MobileNav.tsx +1 -1
  389. package/src/MultiSelector/hooks.ts +2 -4
  390. package/src/Outline/Outline.doc.mjs +177 -51
  391. package/src/Outline/Outline.tsx +5 -57
  392. package/src/Outline/useOutlineFromMarkdown.doc.mjs +157 -0
  393. package/src/Outline/useOutlineFromMarkdown.ts +1 -0
  394. package/src/Outline/useScrollSpy.ts +3 -3
  395. package/src/Popover/usePopover.tsx +71 -9
  396. package/src/PowerSearch/PowerSearch.doc.mjs +55 -6
  397. package/src/PowerSearch/PowerSearch.tsx +798 -324
  398. package/src/PowerSearch/PowerSearchBottomSheet.tsx +2515 -0
  399. package/src/PowerSearch/PowerSearchEditPopover.tsx +28 -6
  400. package/src/PowerSearch/PowerSearchValueEditor.tsx +203 -38
  401. package/src/PowerSearch/formatFilterValue.ts +18 -1
  402. package/src/PowerSearch/formatTokenValue.ts +215 -0
  403. package/src/PowerSearch/powerSearchSheetUtils.ts +224 -0
  404. package/src/ProgressBar/ProgressBar.doc.mjs +4 -2
  405. package/src/ProgressBar/ProgressBar.tsx +67 -7
  406. package/src/RadioList/RadioList.doc.mjs +4 -2
  407. package/src/RadioList/RadioList.tsx +7 -2
  408. package/src/RadioList/RadioListItem.tsx +5 -3
  409. package/src/Resizable/ResizeHandle.tsx +133 -328
  410. package/src/Resizable/resizeGesture.ts +368 -0
  411. package/src/SegmentedControl/SegmentedControl.doc.mjs +3 -3
  412. package/src/SegmentedControl/SegmentedControl.tsx +179 -5
  413. package/src/SegmentedControl/SegmentedControlContext.ts +6 -0
  414. package/src/SegmentedControl/SegmentedControlItem.tsx +14 -2
  415. package/src/SegmentedControl/useSegmentedSelectionMotion.ts +1640 -0
  416. package/src/SegmentedControl/useSegmentedTouchTracking.ts +308 -0
  417. package/src/Selector/Selector.tsx +136 -89
  418. package/src/Selector/optionShape.ts +64 -0
  419. package/src/Selector/selectableOptionEntries.ts +39 -0
  420. package/src/Selector/utils.ts +9 -68
  421. package/src/SideNav/SideNavItem.tsx +3 -7
  422. package/src/Slider/sliderTouchController.ts +2 -2
  423. package/src/Switch/Switch.doc.mjs +3 -3
  424. package/src/Switch/Switch.tsx +412 -86
  425. package/src/Switch/switchFill.ts +106 -0
  426. package/src/Switch/switchTouch.ts +186 -0
  427. package/src/Switch/useSwitchTouch.ts +1051 -0
  428. package/src/TabList/Tab.tsx +5 -3
  429. package/src/Table/BaseTable.tsx +46 -12
  430. package/src/TextInput/TextInput.tsx +11 -10
  431. package/src/Toast/Toast.tsx +5 -0
  432. package/src/Token/Token.tsx +15 -4
  433. package/src/Token/TokenNamingContext.ts +28 -0
  434. package/src/Tokenizer/Tokenizer.doc.mjs +16 -0
  435. package/src/Tokenizer/Tokenizer.tsx +93 -88
  436. package/src/Tokenizer/TokenizerBottomSheet.tsx +219 -93
  437. package/src/Tokenizer/TokenizerItemRemovableContext.ts +24 -0
  438. package/src/Tooltip/Tooltip.doc.mjs +123 -39
  439. package/src/Tooltip/Tooltip.tsx +43 -9
  440. package/src/Tooltip/useTooltip.doc.mjs +171 -31
  441. package/src/Tooltip/useTooltip.tsx +137 -22
  442. package/src/TopNav/TopNavItem.tsx +6 -5
  443. package/src/TopNav/TopNavMegaMenuItem.tsx +6 -5
  444. package/src/TopNav/TopNavMenu.tsx +6 -5
  445. package/src/Typeahead/Typeahead.tsx +29 -15
  446. package/src/animator/createAnimator.doc.mjs +153 -0
  447. package/src/animator/createAnimator.ts +324 -0
  448. package/src/gestures/GestureHost.ts +205 -21
  449. package/src/gestures/PressTracker.ts +10 -0
  450. package/src/gestures/types.ts +6 -0
  451. package/src/gestures/usePressTracker.ts +2 -0
  452. package/src/gestures/wheelSegmenter.ts +36 -7
  453. package/src/hooks/actionGroupTracker.ts +32 -61
  454. package/src/hooks/index.ts +2 -0
  455. package/src/hooks/pressGroupContext.ts +21 -0
  456. package/src/hooks/useActionGroupTracking.ts +224 -0
  457. package/src/hooks/useAnimator.doc.mjs +109 -0
  458. package/src/hooks/useAnimator.ts +67 -0
  459. package/src/hooks/useAttachment.ts +56 -14
  460. package/src/hooks/useFocusTrap.ts +26 -2
  461. package/src/hooks/useHighlightedOptionScroll.ts +123 -15
  462. package/src/hooks/useInputStatusIcon.tsx +3 -2
  463. package/src/hooks/useMediaQuery.doc.mjs +2 -2
  464. package/src/hooks/useMediaQuery.ts +13 -4
  465. package/src/hooks/useMenuPress.ts +8 -2
  466. package/src/hooks/usePager.ts +1446 -0
  467. package/src/i18n/generated-english/InfoTip/InfoTip.generated.ts +13 -0
  468. package/src/i18n/generated-english/PowerSearch/PowerSearch.generated.ts +1 -0
  469. package/src/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.ts +43 -0
  470. package/src/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.ts +6 -0
  471. package/src/i18n/generated-english/PowerSearch/formatTokenValue.generated.ts +15 -0
  472. package/src/i18n/generated-english/Tokenizer/TokenizerBottomSheet.generated.ts +7 -1
  473. package/src/i18n/generated-locales/en.generated.ts +43 -0
  474. package/src/i18n/generated-locales/pseudo.generated.ts +44 -0
  475. package/src/index.ts +14 -0
  476. package/src/internal/SheetConfirmation.tsx +101 -0
  477. package/src/internal/sheetDraft.ts +80 -0
  478. package/src/internal/touch-sheet.ts +21 -0
  479. package/src/internal/useDismissSearchOnTouchDrag.ts +69 -0
  480. package/src/motion/MEASUREMENTS.md +36 -27
  481. package/src/motion/README.md +11 -6
  482. package/src/motion/animator.ts +61 -29
  483. package/src/motion/paging.ts +37 -14
  484. package/src/motion/reducedMotion.ts +79 -1
  485. package/src/motion/roles.ts +20 -1
  486. package/src/motion/uikit/alert.ts +43 -0
  487. package/src/motion/uikit/index.ts +6 -5
  488. package/src/motion/uikit/paging.ts +41 -10
  489. package/src/motion/uikit/progressBar.ts +31 -11
  490. package/src/motion/uikit/segmented.ts +74 -0
  491. package/src/motion/uikit/springs.ts +12 -42
  492. package/src/motion/uikit/switch.ts +174 -0
  493. package/src/privateAttributes/pressGroupItem.stylex.ts +23 -0
  494. package/src/privateAttributes/pressHoldsDrag.stylex.ts +28 -0
  495. package/src/privateAttributes/segmentTitle.stylex.ts +22 -0
  496. package/src/utils/browserClickWait.ts +133 -0
  497. package/src/utils/clickGuard.ts +64 -1
  498. package/src/utils/dateParser.ts +16 -0
  499. package/src/utils/interactionOverlay.stylex.ts +3 -2
  500. package/src/utils/pressFeedback.ts +24 -6
  501. package/dist/internal/tokenizer-presentation.d.ts +0 -21
  502. package/dist/internal/tokenizer-presentation.d.ts.map +0 -1
  503. package/dist/internal/tokenizer-presentation.js +0 -21
  504. 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, useTouchTrigger, React hooks
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
- useTouchTrigger,
31
- type LayerTouchTrigger,
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. This is what an info icon rendered
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
- isTouchPointerRef,
337
- isTouchInteraction,
338
- handlePointerEnter,
339
- handlePointerDown: handleTouchPointerDown,
340
- clearTapOpen,
341
- } = useTouchTrigger({
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
- isControlled: isOpen !== undefined,
345
- isOpen: isLayerOpen,
346
- layerId: 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
- [handleTouchPointerDown, isOpen, clearTimeouts, hideLayer],
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
- <div ref={registerLayerSurface} {...stylex.props(styles.content)}>
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 {useAppShellMobile} from '../AppShell/AppShellMobileContext';
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 {closeMobileNav} = useAppShellMobile();
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
- // Forward the original onClick if present
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 {useAppShellMobile} from '../AppShell/AppShellMobileContext';
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 {closeMobileNav} = useAppShellMobile();
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
- closeMobileNav();
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 {useAppShellMobile} from '../AppShell/AppShellMobileContext';
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 {closeMobileNav} = useAppShellMobile();
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
- closeMobileNav();
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
- requestAnimationFrame(() => {
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
- inputRef.current?.blur();
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={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
+ };