@astryxdesign/core 0.7.6-canary.ec128c4 → 0.7.6-canary.f73623d

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 (454) hide show
  1. package/dist/AppShell/AppShell.d.ts.map +1 -1
  2. package/dist/AppShell/AppShell.js +183 -5
  3. package/dist/AppShell/observeMainOverflow.d.ts +9 -0
  4. package/dist/AppShell/observeMainOverflow.d.ts.map +1 -0
  5. package/dist/AppShell/observeMainOverflow.js +125 -0
  6. package/dist/Carousel/Carousel.d.ts +3 -1
  7. package/dist/Carousel/Carousel.d.ts.map +1 -1
  8. package/dist/Carousel/Carousel.js +12 -3
  9. package/dist/ComplexSelector/ComplexSelector.d.ts.map +1 -1
  10. package/dist/ComplexSelector/ComplexSelector.js +41 -4
  11. package/dist/DateInput/Wheel.d.ts.map +1 -1
  12. package/dist/DateInput/Wheel.js +11 -7
  13. package/dist/DateInput/usePointerDragScroll.d.ts +10 -1
  14. package/dist/DateInput/usePointerDragScroll.d.ts.map +1 -1
  15. package/dist/DateInput/usePointerDragScroll.js +25 -9
  16. package/dist/DateInput/useScrollSettle.d.ts +3 -1
  17. package/dist/DateInput/useScrollSettle.d.ts.map +1 -1
  18. package/dist/DateInput/useScrollSettle.js +37 -8
  19. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  20. package/dist/DropdownMenu/DropdownMenu.js +28 -19
  21. package/dist/Item/Item.d.ts.map +1 -1
  22. package/dist/Item/Item.js +19 -6
  23. package/dist/Layer/useLayer.d.ts.map +1 -1
  24. package/dist/Layer/useLayer.js +27 -6
  25. package/dist/Link/Link.d.ts.map +1 -1
  26. package/dist/Link/Link.js +8 -3
  27. package/dist/Markdown/plugins/headingLinks.a11y.chromium.spec.js +1 -1
  28. package/dist/NavMenu/NavHeadingMenuItem.d.ts.map +1 -1
  29. package/dist/NavMenu/NavHeadingMenuItem.js +5 -29
  30. package/dist/NumberInput/NumberInput.d.ts.map +1 -1
  31. package/dist/NumberInput/NumberInput.js +23 -2
  32. package/dist/Outline/Outline.d.ts.map +1 -1
  33. package/dist/Outline/Outline.js +27 -0
  34. package/dist/Popover/Popover.d.ts.map +1 -1
  35. package/dist/Popover/Popover.js +32 -12
  36. package/dist/Popover/usePopover.d.ts.map +1 -1
  37. package/dist/Popover/usePopover.js +10 -3
  38. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  39. package/dist/PowerSearch/PowerSearch.js +37 -30
  40. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  41. package/dist/RadioList/RadioListItem.js +11 -3
  42. package/dist/SideNav/SideNavItem.d.ts +2 -2
  43. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  44. package/dist/SideNav/SideNavItem.js +18 -7
  45. package/dist/Skeleton/Skeleton.d.ts.map +1 -1
  46. package/dist/Skeleton/Skeleton.js +1 -1
  47. package/dist/Spinner/Spinner.d.ts.map +1 -1
  48. package/dist/Spinner/Spinner.js +1 -1
  49. package/dist/Stepper/Step.d.ts.map +1 -1
  50. package/dist/Stepper/Step.js +26 -6
  51. package/dist/Switch/Switch.d.ts.map +1 -1
  52. package/dist/Switch/Switch.js +10 -3
  53. package/dist/Table/Table.d.ts.map +1 -1
  54. package/dist/Table/Table.js +36 -10
  55. package/dist/Table/plugins/sortable/useTableSortable.d.ts.map +1 -1
  56. package/dist/Table/plugins/sortable/useTableSortable.js +46 -58
  57. package/dist/Toast/ToastViewport.d.ts.map +1 -1
  58. package/dist/Toast/ToastViewport.js +19 -3
  59. package/dist/ToggleButton/ToggleButtonGroup.d.ts +7 -1
  60. package/dist/ToggleButton/ToggleButtonGroup.d.ts.map +1 -1
  61. package/dist/ToggleButton/ToggleButtonGroup.js +16 -2
  62. package/dist/Token/Token.d.ts.map +1 -1
  63. package/dist/Token/Token.js +37 -5
  64. package/dist/Token/TokenLink.d.ts.map +1 -1
  65. package/dist/Token/TokenLink.js +14 -2
  66. package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
  67. package/dist/Tokenizer/Tokenizer.js +15 -4
  68. package/dist/Tokenizer/TokenizerClearAllMessageContext.d.ts +2 -0
  69. package/dist/Tokenizer/TokenizerClearAllMessageContext.d.ts.map +1 -0
  70. package/dist/Tokenizer/TokenizerClearAllMessageContext.js +17 -0
  71. package/dist/TreeList/TreeListItem.d.ts.map +1 -1
  72. package/dist/TreeList/TreeListItem.js +27 -4
  73. package/dist/Typeahead/BaseTypeahead.d.ts +4 -4
  74. package/dist/Typeahead/BaseTypeahead.d.ts.map +1 -1
  75. package/dist/Typeahead/BaseTypeahead.js +43 -7
  76. package/dist/astryx.css +10 -3
  77. package/dist/gestures/GestureArena.d.ts +26 -1
  78. package/dist/gestures/GestureArena.d.ts.map +1 -1
  79. package/dist/gestures/GestureArena.js +71 -9
  80. package/dist/gestures/GestureHost.d.ts +2 -3
  81. package/dist/gestures/GestureHost.d.ts.map +1 -1
  82. package/dist/gestures/GestureHost.js +7 -7
  83. package/dist/gestures/GestureRecognizer.d.ts +3 -1
  84. package/dist/gestures/GestureRecognizer.d.ts.map +1 -1
  85. package/dist/gestures/GestureRecognizer.js +3 -1
  86. package/dist/gestures/PressTracker.d.ts +112 -0
  87. package/dist/gestures/PressTracker.d.ts.map +1 -0
  88. package/dist/gestures/PressTracker.js +267 -0
  89. package/dist/gestures/index.d.ts +37 -0
  90. package/dist/gestures/index.d.ts.map +1 -0
  91. package/dist/gestures/index.js +25 -0
  92. package/dist/gestures/useGestureRecognizer.d.ts +56 -0
  93. package/dist/gestures/useGestureRecognizer.d.ts.map +1 -0
  94. package/dist/gestures/useGestureRecognizer.js +226 -0
  95. package/dist/hooks/scrollKeyboardDelegation.d.ts.map +1 -1
  96. package/dist/hooks/scrollKeyboardDelegation.js +7 -3
  97. package/dist/hooks/useScrollOverflow.d.ts +2 -1
  98. package/dist/hooks/useScrollOverflow.d.ts.map +1 -1
  99. package/dist/hooks/useScrollOverflow.js +56 -10
  100. package/dist/i18n/generated-locales/af-ZA.generated.d.ts.map +1 -1
  101. package/dist/i18n/generated-locales/af-ZA.generated.js +0 -5
  102. package/dist/i18n/generated-locales/ar-SA.generated.d.ts.map +1 -1
  103. package/dist/i18n/generated-locales/ar-SA.generated.js +0 -5
  104. package/dist/i18n/generated-locales/ca-ES.generated.d.ts.map +1 -1
  105. package/dist/i18n/generated-locales/ca-ES.generated.js +0 -5
  106. package/dist/i18n/generated-locales/cs-CZ.generated.d.ts.map +1 -1
  107. package/dist/i18n/generated-locales/cs-CZ.generated.js +0 -5
  108. package/dist/i18n/generated-locales/da-DK.generated.d.ts.map +1 -1
  109. package/dist/i18n/generated-locales/da-DK.generated.js +0 -5
  110. package/dist/i18n/generated-locales/de-DE.generated.d.ts.map +1 -1
  111. package/dist/i18n/generated-locales/de-DE.generated.js +0 -5
  112. package/dist/i18n/generated-locales/el-GR.generated.d.ts.map +1 -1
  113. package/dist/i18n/generated-locales/el-GR.generated.js +0 -5
  114. package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
  115. package/dist/i18n/generated-locales/en.generated.js +3 -5
  116. package/dist/i18n/generated-locales/es-ES.generated.d.ts.map +1 -1
  117. package/dist/i18n/generated-locales/es-ES.generated.js +0 -5
  118. package/dist/i18n/generated-locales/fi-FI.generated.d.ts.map +1 -1
  119. package/dist/i18n/generated-locales/fi-FI.generated.js +0 -5
  120. package/dist/i18n/generated-locales/fr-FR.generated.d.ts.map +1 -1
  121. package/dist/i18n/generated-locales/fr-FR.generated.js +0 -5
  122. package/dist/i18n/generated-locales/he-IL.generated.d.ts.map +1 -1
  123. package/dist/i18n/generated-locales/he-IL.generated.js +0 -5
  124. package/dist/i18n/generated-locales/hu-HU.generated.d.ts.map +1 -1
  125. package/dist/i18n/generated-locales/hu-HU.generated.js +0 -5
  126. package/dist/i18n/generated-locales/it-IT.generated.d.ts.map +1 -1
  127. package/dist/i18n/generated-locales/it-IT.generated.js +0 -5
  128. package/dist/i18n/generated-locales/ja-JP.generated.d.ts.map +1 -1
  129. package/dist/i18n/generated-locales/ja-JP.generated.js +0 -5
  130. package/dist/i18n/generated-locales/ko-KR.generated.d.ts.map +1 -1
  131. package/dist/i18n/generated-locales/ko-KR.generated.js +0 -5
  132. package/dist/i18n/generated-locales/nl-NL.generated.d.ts.map +1 -1
  133. package/dist/i18n/generated-locales/nl-NL.generated.js +0 -5
  134. package/dist/i18n/generated-locales/no-NO.generated.d.ts.map +1 -1
  135. package/dist/i18n/generated-locales/no-NO.generated.js +0 -5
  136. package/dist/i18n/generated-locales/pl-PL.generated.d.ts.map +1 -1
  137. package/dist/i18n/generated-locales/pl-PL.generated.js +0 -5
  138. package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
  139. package/dist/i18n/generated-locales/pseudo.generated.js +3 -5
  140. package/dist/i18n/generated-locales/pt-BR.generated.d.ts.map +1 -1
  141. package/dist/i18n/generated-locales/pt-BR.generated.js +0 -5
  142. package/dist/i18n/generated-locales/pt-PT.generated.d.ts.map +1 -1
  143. package/dist/i18n/generated-locales/pt-PT.generated.js +0 -5
  144. package/dist/i18n/generated-locales/ro-RO.generated.d.ts.map +1 -1
  145. package/dist/i18n/generated-locales/ro-RO.generated.js +0 -5
  146. package/dist/i18n/generated-locales/ru-RU.generated.d.ts.map +1 -1
  147. package/dist/i18n/generated-locales/ru-RU.generated.js +0 -5
  148. package/dist/i18n/generated-locales/sr-SP.generated.d.ts.map +1 -1
  149. package/dist/i18n/generated-locales/sr-SP.generated.js +0 -5
  150. package/dist/i18n/generated-locales/sv-SE.generated.d.ts.map +1 -1
  151. package/dist/i18n/generated-locales/sv-SE.generated.js +0 -5
  152. package/dist/i18n/generated-locales/tr-TR.generated.d.ts.map +1 -1
  153. package/dist/i18n/generated-locales/tr-TR.generated.js +0 -5
  154. package/dist/i18n/generated-locales/uk-UA.generated.d.ts.map +1 -1
  155. package/dist/i18n/generated-locales/uk-UA.generated.js +0 -5
  156. package/dist/i18n/generated-locales/vi-VN.generated.d.ts.map +1 -1
  157. package/dist/i18n/generated-locales/vi-VN.generated.js +0 -5
  158. package/dist/i18n/generated-locales/zh-CN.generated.d.ts.map +1 -1
  159. package/dist/i18n/generated-locales/zh-CN.generated.js +0 -5
  160. package/dist/i18n/generated-locales/zh-TW.generated.d.ts.map +1 -1
  161. package/dist/i18n/generated-locales/zh-TW.generated.js +0 -5
  162. package/dist/motion/animator.d.ts +76 -7
  163. package/dist/motion/animator.d.ts.map +1 -1
  164. package/dist/motion/animator.js +589 -99
  165. package/dist/motion/coast.d.ts +4 -1
  166. package/dist/motion/coast.d.ts.map +1 -1
  167. package/dist/motion/coast.js +4 -2
  168. package/dist/motion/reducedMotion.d.ts.map +1 -1
  169. package/dist/motion/reducedMotion.js +6 -2
  170. package/dist/motion/reducedMotionPlan.d.ts +7 -0
  171. package/dist/motion/reducedMotionPlan.d.ts.map +1 -1
  172. package/dist/motion/reducedMotionPlan.js +14 -1
  173. package/dist/motion/resolveMotion.d.ts +42 -0
  174. package/dist/motion/resolveMotion.d.ts.map +1 -0
  175. package/dist/motion/resolveMotion.js +43 -0
  176. package/dist/motion/roleValue.d.ts +2 -1
  177. package/dist/motion/roleValue.d.ts.map +1 -1
  178. package/dist/motion/roleValue.js +2 -1
  179. package/dist/motion/uikit/timing.d.ts +7 -1
  180. package/dist/motion/uikit/timing.d.ts.map +1 -1
  181. package/dist/motion/uikit/timing.js +19 -1
  182. package/dist/theme/defineTheme.d.ts +19 -5
  183. package/dist/theme/defineTheme.d.ts.map +1 -1
  184. package/dist/theme/defineTheme.js +63 -3
  185. package/dist/theme/index.d.ts +1 -0
  186. package/dist/theme/index.d.ts.map +1 -1
  187. package/dist/theme/motionKnobs.d.ts +56 -0
  188. package/dist/theme/motionKnobs.d.ts.map +1 -0
  189. package/dist/theme/motionKnobs.js +48 -0
  190. package/dist/theme/resolveThemeValues.d.ts +11 -4
  191. package/dist/theme/resolveThemeValues.d.ts.map +1 -1
  192. package/dist/theme/resolveThemeValues.js +40 -4
  193. package/dist/theme/themeAdaptations.d.ts +7 -3
  194. package/dist/theme/themeAdaptations.d.ts.map +1 -1
  195. package/dist/theme/themeAdaptations.js +36 -7
  196. package/dist/theme/themeMotion.d.ts +96 -0
  197. package/dist/theme/themeMotion.d.ts.map +1 -0
  198. package/dist/theme/themeMotion.js +177 -0
  199. package/dist/theme/tokenReferences.d.ts +31 -0
  200. package/dist/theme/tokenReferences.d.ts.map +1 -0
  201. package/dist/theme/tokenReferences.js +132 -0
  202. package/dist/theme/tokens.d.ts +1 -0
  203. package/dist/theme/tokens.d.ts.map +1 -1
  204. package/dist/theme/tokens.js +9 -129
  205. package/dist/theme/tokens.stylex.d.ts +12 -0
  206. package/dist/theme/tokens.stylex.d.ts.map +1 -1
  207. package/dist/theme/tokens.stylex.js +12 -0
  208. package/dist/utils/focusOutline.stylex.d.ts +6 -0
  209. package/dist/utils/focusOutline.stylex.d.ts.map +1 -1
  210. package/dist/utils/focusOutline.stylex.js +7 -0
  211. package/dist/utils/interactionOverlay.stylex.d.ts.map +1 -1
  212. package/dist/utils/interactionOverlay.stylex.js +17 -8
  213. package/dist/utils/pressFeedback.d.ts.map +1 -1
  214. package/dist/utils/pressFeedback.js +20 -1
  215. package/dist/utils/sharedMutationObserver.d.ts +19 -11
  216. package/dist/utils/sharedMutationObserver.d.ts.map +1 -1
  217. package/dist/utils/sharedMutationObserver.js +66 -26
  218. package/dist/utils/touchPresentation.d.ts +2 -2
  219. package/dist/utils/touchPresentation.d.ts.map +1 -1
  220. package/dist/utils/touchPresentation.js +8 -5
  221. package/dist/utils/touchQueries.d.ts +13 -0
  222. package/dist/utils/touchQueries.d.ts.map +1 -0
  223. package/dist/utils/touchQueries.js +15 -0
  224. package/dist/utils/useFocusAcrossSwap.d.ts +19 -0
  225. package/dist/utils/useFocusAcrossSwap.d.ts.map +1 -0
  226. package/dist/utils/useFocusAcrossSwap.js +41 -0
  227. package/locales/af-ZA.json +0 -21
  228. package/locales/ar-SA.json +0 -21
  229. package/locales/ca-ES.json +0 -21
  230. package/locales/cs-CZ.json +0 -21
  231. package/locales/da-DK.json +0 -21
  232. package/locales/de-DE.json +0 -21
  233. package/locales/el-GR.json +0 -21
  234. package/locales/en.json +12 -20
  235. package/locales/es-ES.json +0 -21
  236. package/locales/fi-FI.json +0 -21
  237. package/locales/fr-FR.json +0 -21
  238. package/locales/he-IL.json +0 -21
  239. package/locales/hu-HU.json +0 -21
  240. package/locales/it-IT.json +0 -21
  241. package/locales/ja-JP.json +0 -21
  242. package/locales/ko-KR.json +0 -21
  243. package/locales/nl-NL.json +0 -21
  244. package/locales/no-NO.json +0 -21
  245. package/locales/pl-PL.json +0 -21
  246. package/locales/pseudo.json +8 -14
  247. package/locales/pt-BR.json +0 -21
  248. package/locales/pt-PT.json +0 -21
  249. package/locales/ro-RO.json +0 -21
  250. package/locales/ru-RU.json +0 -21
  251. package/locales/sr-SP.json +0 -21
  252. package/locales/sv-SE.json +0 -21
  253. package/locales/tr-TR.json +0 -21
  254. package/locales/uk-UA.json +0 -21
  255. package/locales/vi-VN.json +0 -21
  256. package/locales/zh-CN.json +0 -21
  257. package/locales/zh-TW.json +0 -21
  258. package/package.json +4 -4
  259. package/src/AppShell/AppShell.doc.mjs +1 -1
  260. package/src/AppShell/AppShell.spec.md +9 -12
  261. package/src/AppShell/AppShell.test.tsx +164 -2
  262. package/src/AppShell/AppShell.tsx +225 -5
  263. package/src/AppShell/__tests__/AppShellMainKeyboard.a11y.browser.spec.ts +534 -0
  264. package/src/AppShell/observeMainOverflow.test.ts +173 -0
  265. package/src/AppShell/observeMainOverflow.ts +143 -0
  266. package/src/Carousel/Carousel.doc.mjs +1 -1
  267. package/src/Carousel/Carousel.spec.md +9 -9
  268. package/src/Carousel/Carousel.test.tsx +124 -3
  269. package/src/Carousel/Carousel.tsx +10 -2
  270. package/src/Carousel/__tests__/Carousel.a11y.known-failures.ts +1 -16
  271. package/src/Chat/ChatComposer.spec.md +75 -59
  272. package/src/Chat/ChatComposerTokenElement.spec.md +45 -33
  273. package/src/Chat/ChatDictationButton.spec.md +126 -81
  274. package/src/Chat/ChatLayout.spec.md +41 -36
  275. package/src/Chat/ChatLayoutScrollButton.spec.md +87 -103
  276. package/src/Chat/ChatSendButton.spec.md +78 -67
  277. package/src/CodeBlock/__tests__/CodeBlockCopyClearance.a11y.chromium.spec.ts +38 -3
  278. package/src/ComplexSelector/ComplexSelector.test.tsx +111 -0
  279. package/src/ComplexSelector/ComplexSelector.tsx +41 -4
  280. package/src/ContextMenu/ContextMenu.spec.md +84 -56
  281. package/src/ContextMenu/ContextMenuItem.spec.md +132 -0
  282. package/src/DateInput/DateInputTouch.test.tsx +44 -0
  283. package/src/DateInput/Wheel.tsx +9 -6
  284. package/src/DateInput/usePointerDragScroll.ts +34 -10
  285. package/src/DateInput/useScrollSettle.ts +38 -7
  286. package/src/DropdownMenu/DropdownMenu.spec.md +198 -218
  287. package/src/DropdownMenu/DropdownMenu.test.tsx +117 -0
  288. package/src/DropdownMenu/DropdownMenu.tsx +33 -18
  289. package/src/DropdownMenu/DropdownMenuCheckboxItem.spec.md +192 -0
  290. package/src/DropdownMenu/DropdownMenuDivider.spec.md +25 -31
  291. package/src/DropdownMenu/DropdownMenuGroup.spec.md +145 -0
  292. package/src/DropdownMenu/DropdownMenuItem.spec.md +48 -42
  293. package/src/DropdownMenu/DropdownMenuRadioGroup.spec.md +34 -37
  294. package/src/DropdownMenu/DropdownMenuRadioItem.spec.md +54 -53
  295. package/src/DropdownMenu/DropdownMenuSubMenu.spec.md +47 -41
  296. package/src/EmptyState/EmptyState.spec.md +35 -29
  297. package/src/Item/Item.test.tsx +60 -0
  298. package/src/Item/Item.tsx +14 -7
  299. package/src/Layer/useLayer.test.tsx +78 -3
  300. package/src/Layer/useLayer.tsx +27 -6
  301. package/src/Link/Link.spec.md +3 -2
  302. package/src/Link/Link.tsx +11 -0
  303. package/src/Link/__tests__/Link.truncation.a11y.chromium.spec.ts +58 -0
  304. package/src/Markdown/plugins/headingLinks.a11y.chromium.spec.ts +1 -1
  305. package/src/NavMenu/NavHeadingMenuItem.tsx +5 -39
  306. package/src/NumberInput/NumberInput.test.tsx +68 -7
  307. package/src/NumberInput/NumberInput.tsx +31 -1
  308. package/src/Outline/Outline.spec.md +165 -69
  309. package/src/Outline/Outline.test.tsx +67 -2
  310. package/src/Outline/Outline.tsx +23 -0
  311. package/src/Outline/modules/parseOutlineFromMarkdown.spec.md +3 -4
  312. package/src/OverflowList/OverflowList.spec.md +102 -55
  313. package/src/Pagination/Pagination.spec.md +158 -84
  314. package/src/Popover/Popover.test.tsx +84 -0
  315. package/src/Popover/Popover.tsx +34 -14
  316. package/src/Popover/__tests__/PopoverSecondDocument.a11y.chromium.spec.ts +70 -8
  317. package/src/Popover/usePopover.tsx +10 -3
  318. package/src/PowerSearch/PowerSearch.test.tsx +24 -0
  319. package/src/PowerSearch/PowerSearch.tsx +42 -31
  320. package/src/RadioList/RadioList.spec.md +1 -1
  321. package/src/RadioList/RadioList.test.tsx +84 -0
  322. package/src/RadioList/RadioListItem.tsx +11 -2
  323. package/src/Resizable/Resizable.spec.md +144 -124
  324. package/src/SideNav/SideNav.test.tsx +124 -4
  325. package/src/SideNav/SideNavItem.spec.md +14 -24
  326. package/src/SideNav/SideNavItem.tsx +27 -10
  327. package/src/Skeleton/Skeleton.tsx +3 -1
  328. package/src/Spinner/Spinner.tsx +3 -1
  329. package/src/Stepper/Step.spec.md +36 -42
  330. package/src/Stepper/Step.tsx +33 -6
  331. package/src/Stepper/Stepper.doc.mjs +1 -1
  332. package/src/Stepper/Stepper.test.tsx +69 -7
  333. package/src/Switch/Switch.spec.md +1 -1
  334. package/src/Switch/Switch.test.tsx +66 -1
  335. package/src/Switch/Switch.tsx +11 -3
  336. package/src/Table/Table.spec.md +1 -1
  337. package/src/Table/Table.test.tsx +32 -0
  338. package/src/Table/Table.tsx +43 -11
  339. package/src/Table/__tests__/Table.a11y.states.ts +1 -5
  340. package/src/Table/plugins/sortable/useTableSortable.test.tsx +73 -144
  341. package/src/Table/plugins/sortable/useTableSortable.tsx +44 -73
  342. package/src/Table/plugins/sortable/useTableSortableState.test.tsx +9 -21
  343. package/src/TimeInput/TimeInput.spec.md +13 -13
  344. package/src/Toast/Toast.spec.md +2 -5
  345. package/src/Toast/ToastViewport.test.tsx +79 -0
  346. package/src/Toast/ToastViewport.tsx +21 -3
  347. package/src/ToggleButton/ToggleButton.test.tsx +27 -0
  348. package/src/ToggleButton/ToggleButtonGroup.tsx +20 -1
  349. package/src/Token/Token.doc.mjs +2 -2
  350. package/src/Token/Token.spec.md +41 -51
  351. package/src/Token/Token.test.tsx +67 -0
  352. package/src/Token/Token.tsx +60 -5
  353. package/src/Token/TokenLink.tsx +21 -7
  354. package/src/Tokenizer/Tokenizer.spec.md +13 -1
  355. package/src/Tokenizer/Tokenizer.test.tsx +27 -0
  356. package/src/Tokenizer/Tokenizer.tsx +24 -10
  357. package/src/Tokenizer/TokenizerBottomSheet.test.tsx +8 -0
  358. package/src/Tokenizer/TokenizerClearAllMessageContext.ts +21 -0
  359. package/src/TreeList/TreeList.test.tsx +26 -0
  360. package/src/TreeList/TreeListItem.tsx +26 -4
  361. package/src/Typeahead/BaseTypeahead.doc.mjs +3 -3
  362. package/src/Typeahead/BaseTypeahead.spec.md +45 -45
  363. package/src/Typeahead/BaseTypeahead.tsx +48 -9
  364. package/src/Typeahead/Typeahead.test.tsx +120 -0
  365. package/src/__tests__/internalModulesNotExperimental.test.ts +88 -0
  366. package/src/__tests__/pressState.ts +8 -4
  367. package/src/gestures/GestureArena.ts +76 -11
  368. package/src/gestures/GestureHost.ts +6 -7
  369. package/src/gestures/GestureRecognizer.ts +3 -1
  370. package/src/gestures/PressTracker.ts +386 -0
  371. package/src/gestures/README.md +420 -0
  372. package/src/gestures/__tests__/GestureHost.test.ts +50 -1
  373. package/src/gestures/__tests__/PressTracker.test.ts +275 -0
  374. package/src/gestures/__tests__/arena.test.ts +35 -0
  375. package/src/gestures/__tests__/harness.ts +31 -2
  376. package/src/gestures/__tests__/pressTrackerFactory.test.ts +59 -0
  377. package/src/gestures/__tests__/useGestureRecognizer.test.tsx +570 -0
  378. package/src/gestures/index.ts +79 -0
  379. package/src/gestures/useGestureRecognizer.ts +305 -0
  380. package/src/hooks/scrollKeyboardDelegation.test.ts +33 -0
  381. package/src/hooks/scrollKeyboardDelegation.ts +9 -3
  382. package/src/hooks/useScrollOverflow.doc.mjs +1 -1
  383. package/src/hooks/useScrollOverflow.test.tsx +102 -1
  384. package/src/hooks/useScrollOverflow.ts +59 -10
  385. package/src/i18n/generated-locales/af-ZA.generated.ts +0 -7
  386. package/src/i18n/generated-locales/ar-SA.generated.ts +0 -6
  387. package/src/i18n/generated-locales/ca-ES.generated.ts +0 -7
  388. package/src/i18n/generated-locales/cs-CZ.generated.ts +0 -6
  389. package/src/i18n/generated-locales/da-DK.generated.ts +0 -6
  390. package/src/i18n/generated-locales/de-DE.generated.ts +0 -6
  391. package/src/i18n/generated-locales/el-GR.generated.ts +0 -7
  392. package/src/i18n/generated-locales/en.generated.ts +3 -6
  393. package/src/i18n/generated-locales/es-ES.generated.ts +0 -7
  394. package/src/i18n/generated-locales/fi-FI.generated.ts +0 -6
  395. package/src/i18n/generated-locales/fr-FR.generated.ts +0 -7
  396. package/src/i18n/generated-locales/he-IL.generated.ts +0 -6
  397. package/src/i18n/generated-locales/hu-HU.generated.ts +0 -6
  398. package/src/i18n/generated-locales/it-IT.generated.ts +0 -7
  399. package/src/i18n/generated-locales/ja-JP.generated.ts +0 -6
  400. package/src/i18n/generated-locales/ko-KR.generated.ts +0 -6
  401. package/src/i18n/generated-locales/nl-NL.generated.ts +0 -6
  402. package/src/i18n/generated-locales/no-NO.generated.ts +0 -6
  403. package/src/i18n/generated-locales/pl-PL.generated.ts +0 -7
  404. package/src/i18n/generated-locales/pseudo.generated.ts +3 -6
  405. package/src/i18n/generated-locales/pt-BR.generated.ts +0 -7
  406. package/src/i18n/generated-locales/pt-PT.generated.ts +0 -7
  407. package/src/i18n/generated-locales/ro-RO.generated.ts +0 -6
  408. package/src/i18n/generated-locales/ru-RU.generated.ts +0 -7
  409. package/src/i18n/generated-locales/sr-SP.generated.ts +0 -6
  410. package/src/i18n/generated-locales/sv-SE.generated.ts +0 -6
  411. package/src/i18n/generated-locales/tr-TR.generated.ts +0 -7
  412. package/src/i18n/generated-locales/uk-UA.generated.ts +0 -7
  413. package/src/i18n/generated-locales/vi-VN.generated.ts +0 -6
  414. package/src/i18n/generated-locales/zh-CN.generated.ts +0 -6
  415. package/src/i18n/generated-locales/zh-TW.generated.ts +0 -6
  416. package/src/motion/MEASUREMENTS.md +2 -1
  417. package/src/motion/README.md +102 -32
  418. package/src/motion/__tests__/animator.interaction.browser.spec.ts +843 -0
  419. package/src/motion/__tests__/motionBundle.ts +14 -0
  420. package/src/motion/animator.test.ts +978 -33
  421. package/src/motion/animator.ts +790 -104
  422. package/src/motion/coast.ts +10 -3
  423. package/src/motion/reducedMotion.ts +12 -2
  424. package/src/motion/reducedMotionPlan.test.ts +26 -0
  425. package/src/motion/reducedMotionPlan.ts +20 -1
  426. package/src/motion/resolveMotion.test.ts +123 -0
  427. package/src/motion/resolveMotion.ts +68 -0
  428. package/src/motion/roleValue.ts +2 -1
  429. package/src/motion/roles.test.ts +21 -4
  430. package/src/motion/uikit/tableImports.test.ts +293 -0
  431. package/src/motion/uikit/timing.ts +15 -1
  432. package/src/motion/uikit/values.test.ts +23 -12
  433. package/src/theme/Theme.doc.mjs +1 -1
  434. package/src/theme/defineTheme.ts +116 -7
  435. package/src/theme/expandMotionScale.test.ts +1 -1
  436. package/src/theme/index.ts +5 -0
  437. package/src/theme/motionKnobs.ts +82 -0
  438. package/src/theme/resolveThemeValues.ts +68 -6
  439. package/src/theme/themeAdaptations.ts +52 -12
  440. package/src/theme/themeMotion.test.ts +620 -0
  441. package/src/theme/themeMotion.ts +221 -0
  442. package/src/theme/tokenReferences.ts +149 -0
  443. package/src/theme/tokens.stylex.ts +10 -0
  444. package/src/theme/tokens.ts +15 -158
  445. package/src/utils/focusOutline.stylex.ts +28 -0
  446. package/src/utils/interactionOverlay.stylex.ts +12 -3
  447. package/src/utils/pressFeedback.test.ts +138 -0
  448. package/src/utils/pressFeedback.ts +34 -11
  449. package/src/utils/pressGesture.test.ts +9 -0
  450. package/src/utils/sharedMutationObserver.test.ts +54 -1
  451. package/src/utils/sharedMutationObserver.ts +87 -29
  452. package/src/utils/touchPresentation.ts +8 -5
  453. package/src/utils/touchQueries.ts +15 -0
  454. package/src/utils/useFocusAcrossSwap.ts +55 -0
@@ -0,0 +1,570 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file useGestureRecognizer.test.tsx
5
+ * @input React components using useGestureRecognizer / usePressTracker, and
6
+ * touch events dispatched on their elements
7
+ * @output The hooks keep one recognizer per component, attach before the
8
+ * first touch, run the latest listener without rendering per move, and
9
+ * detach on unmount
10
+ * @position jsdom tests of packages/core/src/gestures/useGestureRecognizer.ts
11
+ */
12
+
13
+ import {act, render} from '@testing-library/react';
14
+ import {useRef} from 'react';
15
+ import {afterEach, beforeEach, describe, expect, it, vi} from 'vitest';
16
+ import {getGestureHost} from '../GestureHost';
17
+ import {PanGestureRecognizer} from '../PanGestureRecognizer';
18
+ import {TapGestureRecognizer} from '../TapGestureRecognizer';
19
+ import {TOUCH_ACTION_ATTRIBUTE} from '../touchActionRule';
20
+ import type {ControlEvent} from '../PressTracker';
21
+ import {useGestureRecognizer, usePressTracker} from '../useGestureRecognizer';
22
+ import {coarsePrimaryPointer} from './harness';
23
+
24
+ function touch(
25
+ type: string,
26
+ target: EventTarget,
27
+ contact: {id: number; x: number; y: number},
28
+ time: number,
29
+ isLift = false,
30
+ ): void {
31
+ const event = new Event(type, {bubbles: true, cancelable: true});
32
+ const entry = {
33
+ identifier: contact.id,
34
+ clientX: contact.x,
35
+ clientY: contact.y,
36
+ target,
37
+ };
38
+ Object.defineProperty(event, 'changedTouches', {value: [entry]});
39
+ Object.defineProperty(event, 'touches', {value: isLift ? [] : [entry]});
40
+ Object.defineProperty(event, 'timeStamp', {value: time});
41
+ target.dispatchEvent(event);
42
+ }
43
+
44
+ let renders = 0;
45
+
46
+ function Draggable({
47
+ onPan,
48
+ onRecognizer,
49
+ isEnabled = true,
50
+ }: {
51
+ onPan: (recognizer: PanGestureRecognizer) => void;
52
+ onRecognizer?: (recognizer: PanGestureRecognizer) => void;
53
+ isEnabled?: boolean;
54
+ }) {
55
+ renders += 1;
56
+ const ref = useRef<HTMLDivElement>(null);
57
+ const pan = useGestureRecognizer(
58
+ ref,
59
+ () => new PanGestureRecognizer({direction: 'horizontal'}),
60
+ onPan,
61
+ {isEnabled},
62
+ );
63
+ onRecognizer?.(pan);
64
+ return <div data-testid="surface" ref={ref} />;
65
+ }
66
+
67
+ // A phone: the document's host listens only where the pointer is coarse.
68
+ let restorePointer: () => void = () => {};
69
+ beforeEach(() => {
70
+ restorePointer = coarsePrimaryPointer();
71
+ });
72
+ afterEach(() => {
73
+ restorePointer();
74
+ });
75
+
76
+ describe('useGestureRecognizer', () => {
77
+ afterEach(() => {
78
+ renders = 0;
79
+ });
80
+
81
+ it('drives the latest listener with no render per move', () => {
82
+ const seen: string[] = [];
83
+ const {getByTestId} = render(
84
+ <Draggable
85
+ onPan={recognizer => {
86
+ seen.push(`${recognizer.state}:${recognizer.translation().x}`);
87
+ }}
88
+ />,
89
+ );
90
+ const surface = getByTestId('surface');
91
+ expect(renders).toBe(1);
92
+ touch('touchstart', surface, {id: 1, x: 0, y: 0}, 0);
93
+ for (let x = 6; x <= 36; x += 6) {
94
+ touch('touchmove', surface, {id: 1, x, y: 0}, x * 2);
95
+ }
96
+ touch('touchend', surface, {id: 1, x: 36, y: 0}, 80, true);
97
+ // The 10 px hysteresis is left out of the translation, as in UIKit.
98
+ expect(seen).toEqual([
99
+ 'began:2',
100
+ 'changed:8',
101
+ 'changed:14',
102
+ 'changed:20',
103
+ 'changed:26',
104
+ 'ended:26',
105
+ ]);
106
+ expect(renders).toBe(1);
107
+ });
108
+
109
+ it('keeps one recognizer across renders and reads the newest listener', () => {
110
+ const identities = new Set<PanGestureRecognizer>();
111
+ const first = vi.fn();
112
+ const second = vi.fn();
113
+ const {getByTestId, rerender} = render(
114
+ <Draggable onPan={first} onRecognizer={r => identities.add(r)} />,
115
+ );
116
+ rerender(
117
+ <Draggable onPan={second} onRecognizer={r => identities.add(r)} />,
118
+ );
119
+ expect(identities.size).toBe(1);
120
+ const surface = getByTestId('surface');
121
+ touch('touchstart', surface, {id: 2, x: 0, y: 0}, 0);
122
+ touch('touchmove', surface, {id: 2, x: 30, y: 0}, 16);
123
+ expect(first).not.toHaveBeenCalled();
124
+ expect(second).toHaveBeenCalledTimes(1);
125
+ touch('touchend', surface, {id: 2, x: 30, y: 0}, 32, true);
126
+ });
127
+
128
+ it('cancels a gesture in flight when it is disabled, without calling the listener from the effect', () => {
129
+ const states: string[] = [];
130
+ // A listener of the recognizer's own, outside the hook, hears the cancel.
131
+ const heard: string[] = [];
132
+ let pan: PanGestureRecognizer | null = null;
133
+ const {getByTestId, rerender} = render(
134
+ <Draggable
135
+ onPan={r => states.push(r.state)}
136
+ onRecognizer={r => {
137
+ if (pan == null) {
138
+ pan = r;
139
+ r.addListener(current => heard.push(current.state));
140
+ }
141
+ }}
142
+ />,
143
+ );
144
+ const surface = getByTestId('surface');
145
+ touch('touchstart', surface, {id: 3, x: 0, y: 0}, 0);
146
+ touch('touchmove', surface, {id: 3, x: 30, y: 0}, 16);
147
+ act(() => {
148
+ rerender(
149
+ <Draggable onPan={r => states.push(r.state)} isEnabled={false} />,
150
+ );
151
+ });
152
+ // Disabling cancels the gesture; its attachment then goes (FR24), which
153
+ // leaves the recognizer at rest. The hook reports nothing from the effect.
154
+ expect(heard).toContain('cancelled');
155
+ expect(pan!.state).not.toBe('changed');
156
+ expect(states).toEqual(['began']);
157
+ touch('touchend', surface, {id: 3, x: 30, y: 0}, 32, true);
158
+ expect(states).toEqual(['began']);
159
+ });
160
+
161
+ it('follows the element when the node behind the ref is replaced', () => {
162
+ const onPan = vi.fn();
163
+ function Swappable({tag}: {tag: 'div' | 'section'}) {
164
+ const ref = useRef<HTMLElement>(null);
165
+ useGestureRecognizer(
166
+ ref,
167
+ () => new PanGestureRecognizer({direction: 'horizontal'}),
168
+ onPan,
169
+ );
170
+ const Tag = tag;
171
+ return <Tag data-testid="surface" ref={ref as never} />;
172
+ }
173
+ const {getByTestId, rerender} = render(<Swappable tag="div" />);
174
+ const first = getByTestId('surface');
175
+ rerender(<Swappable tag="section" />);
176
+ const second = getByTestId('surface');
177
+ expect(second).not.toBe(first);
178
+ touch('touchstart', first, {id: 6, x: 0, y: 0}, 0);
179
+ touch('touchmove', first, {id: 6, x: 30, y: 0}, 16);
180
+ touch('touchend', first, {id: 6, x: 30, y: 0}, 32, true);
181
+ expect(onPan).not.toHaveBeenCalled();
182
+ touch('touchstart', second, {id: 7, x: 0, y: 0}, 100);
183
+ touch('touchmove', second, {id: 7, x: 30, y: 0}, 116);
184
+ expect(onPan).toHaveBeenCalled();
185
+ touch('touchend', second, {id: 7, x: 30, y: 0}, 132, true);
186
+ });
187
+
188
+ it('reports cancelled to a handler that disables the recognizer itself, from that handler', () => {
189
+ const states: string[] = [];
190
+ let pan: PanGestureRecognizer | null = null;
191
+ const {getByTestId} = render(
192
+ <Draggable
193
+ onPan={r => states.push(r.state)}
194
+ onRecognizer={r => {
195
+ pan = r;
196
+ }}
197
+ />,
198
+ );
199
+ const surface = getByTestId('surface');
200
+ touch('touchstart', surface, {id: 6, x: 0, y: 0}, 0);
201
+ touch('touchmove', surface, {id: 6, x: 30, y: 0}, 16);
202
+ // A handler (here, the test) turns it off: UIKit's .cancelled, at once.
203
+ (pan as PanGestureRecognizer | null)?.setEnabled(false);
204
+ expect(states).toEqual(['began', 'cancelled']);
205
+ touch('touchend', surface, {id: 6, x: 30, y: 0}, 32, true);
206
+ });
207
+
208
+ it('attaches nothing while disabled: no touch-action, no gesture (FR24)', () => {
209
+ const states: string[] = [];
210
+ const {getByTestId, rerender} = render(
211
+ <Draggable onPan={r => states.push(r.state)} />,
212
+ );
213
+ const surface = getByTestId('surface');
214
+ expect(surface.hasAttribute(TOUCH_ACTION_ATTRIBUTE)).toBe(true);
215
+ act(() => {
216
+ rerender(
217
+ <Draggable onPan={r => states.push(r.state)} isEnabled={false} />,
218
+ );
219
+ });
220
+ // Disabling detaches: the host takes its touch-action off the element.
221
+ expect(surface.hasAttribute(TOUCH_ACTION_ATTRIBUTE)).toBe(false);
222
+ touch('touchstart', surface, {id: 6, x: 0, y: 0}, 0);
223
+ touch('touchmove', surface, {id: 6, x: 30, y: 0}, 16);
224
+ touch('touchend', surface, {id: 6, x: 30, y: 0}, 32, true);
225
+ expect(states).toEqual([]);
226
+ act(() => {
227
+ rerender(<Draggable onPan={r => states.push(r.state)} />);
228
+ });
229
+ touch('touchstart', surface, {id: 8, x: 0, y: 0}, 100);
230
+ touch('touchmove', surface, {id: 8, x: 30, y: 0}, 116);
231
+ expect(states).toContain('began');
232
+ touch('touchend', surface, {id: 8, x: 30, y: 0}, 132, true);
233
+ });
234
+
235
+ it('follows the element behind the ref when it is replaced (INV6)', () => {
236
+ const states: string[] = [];
237
+ function Swapped({id}: {id: string}) {
238
+ const ref = useRef<HTMLDivElement>(null);
239
+ useGestureRecognizer(
240
+ ref,
241
+ () => new PanGestureRecognizer({direction: 'horizontal'}),
242
+ r => states.push(r.state),
243
+ );
244
+ return <div key={id} data-testid={id} ref={ref} />;
245
+ }
246
+ const {getByTestId, rerender} = render(<Swapped id="first" />);
247
+ act(() => {
248
+ rerender(<Swapped id="second" />);
249
+ });
250
+ const second = getByTestId('second');
251
+ touch('touchstart', second, {id: 9, x: 0, y: 0}, 0);
252
+ touch('touchmove', second, {id: 9, x: 30, y: 0}, 16);
253
+ expect(states).toContain('began');
254
+ touch('touchend', second, {id: 9, x: 30, y: 0}, 32, true);
255
+ });
256
+
257
+ it('ends a gesture in flight on unmount without calling the listener from the cleanup (INV2)', () => {
258
+ const states: string[] = [];
259
+ // A listener of the recognizer's own, outside the hook, hears the cancel.
260
+ const heard: string[] = [];
261
+ let pan: PanGestureRecognizer | null = null;
262
+ const {getByTestId, unmount} = render(
263
+ <Draggable
264
+ onPan={r => states.push(r.state)}
265
+ onRecognizer={r => {
266
+ if (pan == null) {
267
+ pan = r;
268
+ r.addListener(current => heard.push(current.state));
269
+ }
270
+ }}
271
+ />,
272
+ );
273
+ const surface = getByTestId('surface');
274
+ touch('touchstart', surface, {id: 5, x: 0, y: 0}, 0);
275
+ touch('touchmove', surface, {id: 5, x: 30, y: 0}, 16);
276
+ expect(states).toEqual(['began']);
277
+ unmount();
278
+ expect(heard).toContain('cancelled');
279
+ expect(states).toEqual(['began']);
280
+ });
281
+
282
+ it('ends a gesture in flight when the node is replaced without calling the listener from the effect (INV2)', () => {
283
+ const states: string[] = [];
284
+ function Swapped({id}: {id: string}) {
285
+ const ref = useRef<HTMLDivElement>(null);
286
+ useGestureRecognizer(
287
+ ref,
288
+ () => new PanGestureRecognizer({direction: 'horizontal'}),
289
+ r => states.push(r.state),
290
+ );
291
+ return <div key={id} data-testid={id} ref={ref} />;
292
+ }
293
+ const {getByTestId, rerender} = render(<Swapped id="first" />);
294
+ const first = getByTestId('first');
295
+ touch('touchstart', first, {id: 10, x: 0, y: 0}, 0);
296
+ touch('touchmove', first, {id: 10, x: 30, y: 0}, 16);
297
+ expect(states).toEqual(['began']);
298
+ act(() => {
299
+ rerender(<Swapped id="second" />);
300
+ });
301
+ expect(states).toEqual(['began']);
302
+ });
303
+
304
+ it('keeps a recognizer that waits on one being disabled from calling its listener from the effect, and reports it after (INV2)', async () => {
305
+ const heard: string[] = [];
306
+ let inCommit = false;
307
+ function Pair({isDoubleTapEnabled}: {isDoubleTapEnabled: boolean}) {
308
+ const ref = useRef<HTMLDivElement>(null);
309
+ const doubleTap = useGestureRecognizer(
310
+ ref,
311
+ () => new TapGestureRecognizer({numberOfTapsRequired: 2}),
312
+ () => {},
313
+ {isEnabled: isDoubleTapEnabled},
314
+ );
315
+ useGestureRecognizer(
316
+ ref,
317
+ () => new TapGestureRecognizer().requireToFail(doubleTap),
318
+ tap => heard.push(`${inCommit ? 'effect' : 'handler'}:${tap.state}`),
319
+ );
320
+ return <div data-testid="surface" ref={ref} />;
321
+ }
322
+ const {getByTestId, rerender} = render(<Pair isDoubleTapEnabled />);
323
+ const surface = getByTestId('surface');
324
+ touch('touchstart', surface, {id: 5, x: 10, y: 10}, 0);
325
+ touch('touchend', surface, {id: 5, x: 10, y: 10}, 40, true);
326
+ // The single tap waits for the double tap to fail.
327
+ expect(heard).toEqual([]);
328
+ inCommit = true;
329
+ act(() => {
330
+ rerender(<Pair isDoubleTapEnabled={false} />);
331
+ });
332
+ inCommit = false;
333
+ // Disabling the double tap fails it inside that Effect, and nothing
334
+ // reports there: the single tap it held back is not lost, it recognizes
335
+ // after React's update, where its listener reports as usual.
336
+ expect(heard.filter(entry => entry.startsWith('effect:'))).toEqual([]);
337
+ await act(async () => {
338
+ await Promise.resolve();
339
+ });
340
+ expect(heard).toEqual(['handler:ended']);
341
+ });
342
+
343
+ it('detaches on unmount', () => {
344
+ const onPan = vi.fn();
345
+ const {getByTestId, unmount} = render(<Draggable onPan={onPan} />);
346
+ const surface = getByTestId('surface');
347
+ expect(surface.hasAttribute(TOUCH_ACTION_ATTRIBUTE)).toBe(true);
348
+ unmount();
349
+ expect(surface.hasAttribute(TOUCH_ACTION_ATTRIBUTE)).toBe(false);
350
+ touch('touchstart', surface, {id: 4, x: 0, y: 0}, 0);
351
+ touch('touchmove', surface, {id: 4, x: 30, y: 0}, 16);
352
+ expect(onPan).not.toHaveBeenCalled();
353
+ });
354
+ });
355
+
356
+ function Button({
357
+ onEvent,
358
+ cancelTravel,
359
+ isBraking,
360
+ isDisabled = false,
361
+ }: {
362
+ onEvent: (event: ControlEvent) => void;
363
+ cancelTravel?: number;
364
+ isBraking?: () => boolean;
365
+ isDisabled?: boolean;
366
+ }) {
367
+ const ref = useRef<HTMLButtonElement>(null);
368
+ usePressTracker(ref, {
369
+ onControlEvent: event => onEvent(event),
370
+ cancelTravel,
371
+ isBraking,
372
+ isEnabled: () => !isDisabled,
373
+ });
374
+ return (
375
+ <button data-testid="button" ref={ref} type="button">
376
+ Go
377
+ </button>
378
+ );
379
+ }
380
+
381
+ describe('usePressTracker', () => {
382
+ it('gives the host no listener while the control is disabled (FR24)', () => {
383
+ const add = vi.spyOn(document, 'addEventListener');
384
+ const remove = vi.spyOn(document, 'removeEventListener');
385
+ const {rerender, unmount} = render(
386
+ <Button onEvent={() => {}} isDisabled />,
387
+ );
388
+ const added = () =>
389
+ add.mock.calls.filter(([type]) => type === 'touchstart').length;
390
+ expect(added()).toBe(0);
391
+ rerender(<Button onEvent={() => {}} />);
392
+ expect(added()).toBe(1);
393
+ rerender(<Button onEvent={() => {}} isDisabled />);
394
+ expect(
395
+ remove.mock.calls.filter(([type]) => type === 'touchstart').length,
396
+ ).toBe(1);
397
+ unmount();
398
+ add.mockRestore();
399
+ remove.mockRestore();
400
+ });
401
+
402
+ it("keeps the tracker's own ancestor veto when the caller gives none: a single tap by its kind, nothing else with the same counts (architecture:react-component-runtime INV13)", () => {
403
+ let tracker: ReturnType<typeof usePressTracker> | null = null;
404
+ function Tracked() {
405
+ const ref = useRef<HTMLButtonElement>(null);
406
+ tracker = usePressTracker(ref);
407
+ return (
408
+ <button ref={ref} type="button">
409
+ Go
410
+ </button>
411
+ );
412
+ }
413
+ render(<Tracked />);
414
+ const tap = new TapGestureRecognizer({});
415
+ expect(tracker!.allowsAncestorRecognizer(tap)).toBe(false);
416
+ // A discrete recognizer that is not a tap, carrying the same counts.
417
+ const notATap = {
418
+ kind: 'swipe',
419
+ isDiscrete: true,
420
+ numberOfTapsRequired: 1,
421
+ numberOfTouchesRequired: 1,
422
+ view: null,
423
+ };
424
+ expect(tracker!.allowsAncestorRecognizer(notATap)).toBe(true);
425
+ });
426
+
427
+ it('rebuilds its tracker when trackingExpansion, highlightDelay, cancelTravel or quickTapFlash change', () => {
428
+ const trackers: unknown[] = [];
429
+ function Tracked(props: {
430
+ trackingExpansion?: number;
431
+ highlightDelay?: 'inScrollers' | 'always' | 'never';
432
+ cancelTravel?: number;
433
+ quickTapFlash?: number;
434
+ label?: string;
435
+ }) {
436
+ const ref = useRef<HTMLButtonElement>(null);
437
+ trackers.push(usePressTracker(ref, props));
438
+ return (
439
+ <button ref={ref} type="button">
440
+ {props.label ?? 'Go'}
441
+ </button>
442
+ );
443
+ }
444
+ const {rerender} = render(<Tracked cancelTravel={70} />);
445
+ rerender(<Tracked cancelTravel={70} label="Same options" />);
446
+ expect(trackers[1]).toBe(trackers[0]);
447
+ rerender(<Tracked cancelTravel={20} />);
448
+ expect(trackers[2]).not.toBe(trackers[1]);
449
+ rerender(<Tracked cancelTravel={20} trackingExpansion={30} />);
450
+ expect(trackers[3]).not.toBe(trackers[2]);
451
+ rerender(
452
+ <Tracked
453
+ cancelTravel={20}
454
+ trackingExpansion={30}
455
+ highlightDelay="never"
456
+ />,
457
+ );
458
+ expect(trackers[4]).not.toBe(trackers[3]);
459
+ rerender(
460
+ <Tracked
461
+ cancelTravel={20}
462
+ trackingExpansion={30}
463
+ highlightDelay="never"
464
+ quickTapFlash={0}
465
+ />,
466
+ );
467
+ expect(trackers[5]).not.toBe(trackers[4]);
468
+ });
469
+
470
+ it('reports UIControl events for a tap', () => {
471
+ const events: ControlEvent[] = [];
472
+ const {getByTestId} = render(
473
+ <Button onEvent={event => events.push(event)} />,
474
+ );
475
+ const button = getByTestId('button');
476
+ touch('touchstart', button, {id: 5, x: 1, y: 1}, 0);
477
+ touch('touchend', button, {id: 5, x: 1, y: 1}, 50, true);
478
+ expect(events).toEqual(['touchDown', 'touchUpInside']);
479
+ });
480
+
481
+ it('ends a held press on unmount without calling back from the effect', () => {
482
+ const highlights: boolean[] = [];
483
+ const events: ControlEvent[] = [];
484
+ function HeldButton() {
485
+ const ref = useRef<HTMLButtonElement>(null);
486
+ usePressTracker(ref, {
487
+ onControlEvent: event => events.push(event),
488
+ onHighlightChange: isHighlighted => highlights.push(isHighlighted),
489
+ });
490
+ return (
491
+ <button data-testid="held" ref={ref} type="button">
492
+ Go
493
+ </button>
494
+ );
495
+ }
496
+ const {getByTestId, unmount} = render(<HeldButton />);
497
+ touch('touchstart', getByTestId('held'), {id: 9, x: 1, y: 1}, 0);
498
+ const seenHighlights = [...highlights];
499
+ const seenEvents = [...events];
500
+ unmount();
501
+ expect(highlights).toEqual(seenHighlights);
502
+ expect(events).toEqual(seenEvents);
503
+ });
504
+
505
+ it('passes isBraking through to the tracker', () => {
506
+ const events: ControlEvent[] = [];
507
+ const isBraking = vi.fn(() => true);
508
+ function BrakingButton() {
509
+ const ref = useRef<HTMLButtonElement>(null);
510
+ usePressTracker(ref, {
511
+ onControlEvent: event => events.push(event),
512
+ isBraking,
513
+ });
514
+ return (
515
+ <button data-testid="braking" ref={ref} type="button">
516
+ Go
517
+ </button>
518
+ );
519
+ }
520
+ const {getByTestId} = render(<BrakingButton />);
521
+ const button = getByTestId('braking');
522
+ touch('touchstart', button, {id: 8, x: 1, y: 1}, 0);
523
+ touch('touchend', button, {id: 8, x: 1, y: 1}, 50, true);
524
+ expect(isBraking).toHaveBeenCalled();
525
+ expect(events).not.toContain('touchDown');
526
+ });
527
+
528
+ it("uses the caller's scroll brake", () => {
529
+ const events: ControlEvent[] = [];
530
+ const {getByTestId} = render(
531
+ <Button onEvent={event => events.push(event)} isBraking={() => true} />,
532
+ );
533
+ const button = getByTestId('button');
534
+ touch('touchstart', button, {id: 8, x: 1, y: 1}, 0);
535
+ touch('touchend', button, {id: 8, x: 1, y: 1}, 50, true);
536
+ expect(events).toEqual([]);
537
+ });
538
+
539
+ it('tracks the element behind the ref when it is replaced (INV6)', () => {
540
+ const events: ControlEvent[] = [];
541
+ function Swapped({id}: {id: string}) {
542
+ const ref = useRef<HTMLButtonElement>(null);
543
+ usePressTracker(ref, {onControlEvent: event => events.push(event)});
544
+ return <button key={id} data-testid={id} ref={ref} type="button" />;
545
+ }
546
+ const {getByTestId, rerender} = render(<Swapped id="first" />);
547
+ act(() => {
548
+ rerender(<Swapped id="second" />);
549
+ });
550
+ const second = getByTestId('second');
551
+ touch('touchstart', second, {id: 10, x: 1, y: 1}, 0);
552
+ touch('touchend', second, {id: 10, x: 1, y: 1}, 50, true);
553
+ expect(events).toEqual(['touchDown', 'touchUpInside']);
554
+ });
555
+
556
+ it('presses nothing for a touch that brakes a scroll', () => {
557
+ const events: ControlEvent[] = [];
558
+ const {getByTestId} = render(
559
+ <Button onEvent={event => events.push(event)} />,
560
+ );
561
+ const button = getByTestId('button');
562
+ const brake = vi
563
+ .spyOn(getGestureHost(document), 'isScrollBraking')
564
+ .mockReturnValue(true);
565
+ touch('touchstart', button, {id: 7, x: 1, y: 1}, 0);
566
+ touch('touchend', button, {id: 7, x: 1, y: 1}, 50, true);
567
+ expect(events).toEqual([]);
568
+ brake.mockRestore();
569
+ });
570
+ });
@@ -0,0 +1,79 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file index.ts
5
+ * @input The modules of packages/core/src/gestures
6
+ * @output Re-exports the gesture system for core's own components
7
+ * @position Core's own barrel. Not exported from the package.
8
+ */
9
+
10
+ export {GestureArena, browserClock} from './GestureArena';
11
+ export type {
12
+ ArenaBeganInput,
13
+ ClickDisposition,
14
+ GestureArenaOptions,
15
+ GestureClock,
16
+ } from './GestureArena';
17
+ export {GestureHost, getGestureHost} from './GestureHost';
18
+ export type {AttachOptions, GestureHostOptions} from './GestureHost';
19
+ export {
20
+ GestureRecognizer,
21
+ isActive,
22
+ isTerminal,
23
+ isTransitionAllowed,
24
+ } from './GestureRecognizer';
25
+ export type {
26
+ GestureListener,
27
+ GestureRecognizerOptions,
28
+ GestureTransitionListener,
29
+ NativeTouchBehavior,
30
+ } from './GestureRecognizer';
31
+ export {
32
+ attachTapHaptic,
33
+ canVibrate,
34
+ playHaptic,
35
+ supportsSwitchControl,
36
+ } from './haptics';
37
+ export {LongPressGestureRecognizer} from './LongPressGestureRecognizer';
38
+ export type {LongPressGestureRecognizerOptions} from './LongPressGestureRecognizer';
39
+ export {createNativeScrollProbe, parseTouchAction} from './nativeScroll';
40
+ export {PanGestureRecognizer} from './PanGestureRecognizer';
41
+ export type {
42
+ PanDirection,
43
+ PanGestureRecognizerOptions,
44
+ } from './PanGestureRecognizer';
45
+ export {PinchGestureRecognizer} from './PinchGestureRecognizer';
46
+ export type {PinchGestureRecognizerOptions} from './PinchGestureRecognizer';
47
+ export {PRESS_PROFILES, createPressTracker} from './PressTracker';
48
+ export type {
49
+ ControlEvent,
50
+ PressBounds,
51
+ PressHighlightDelay,
52
+ PressProfile,
53
+ PressProfileName,
54
+ PressTracker,
55
+ PressTrackerOptions,
56
+ } from './PressTracker';
57
+ export {ScreenEdgePanGestureRecognizer} from './ScreenEdgePanGestureRecognizer';
58
+ export type {
59
+ ScreenEdge,
60
+ ScreenEdgePanGestureRecognizerOptions,
61
+ } from './ScreenEdgePanGestureRecognizer';
62
+ export {SwipeGestureRecognizer} from './SwipeGestureRecognizer';
63
+ export type {
64
+ SwipeDirection,
65
+ SwipeGestureRecognizerOptions,
66
+ } from './SwipeGestureRecognizer';
67
+ export {TapGestureRecognizer} from './TapGestureRecognizer';
68
+ export type {TapGestureRecognizerOptions} from './TapGestureRecognizer';
69
+ export {deriveTouchAction, gestureHostStyle} from './touchAction';
70
+ export type {GestureHostStyle} from './touchAction';
71
+ export type * from './types';
72
+ export {DEFAULT_ENVIRONMENT} from './types';
73
+ export {useGestureRecognizer, usePressTracker} from './useGestureRecognizer';
74
+ export type {
75
+ UseGestureRecognizerOptions,
76
+ UsePressTrackerOptions,
77
+ } from './useGestureRecognizer';
78
+ export {VelocityTracker} from './VelocityTracker';
79
+ export type {VelocityTrackerOptions} from './VelocityTracker';