@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
@@ -42,14 +42,16 @@
42
42
  * current value with the current velocity (`spec:AST-094` FR6). A gesture's release velocity
43
43
  * can be handed in explicitly instead.
44
44
  *
45
- * End state without a flicker frame: the element's inline style always holds
46
- * the values the animations END on, and the keyframes hold that end state for
47
- * a while after the curve ends (END_HOLD_MS). The main thread drops a finished
48
- * animation as soon as it runs after the curve's end; the inline style already
49
- * shows the same values, so nothing moves. The hold matters when the curve
50
- * ends during a main-thread block: WebKit's compositor ends an animation by
51
- * falling back to the value its main thread last committed, which is
52
- * mid-flight.
45
+ * No frame shows a value the element is not at. While a curve runs, the
46
+ * element's inline style holds the value the curve starts from (the value on
47
+ * screen when it was built), so a frame painted before the compositor has the
48
+ * curve (WebKit can receive a new curve a few updates late) shows the element
49
+ * where it is, never where it is going. The keyframes hold the end state for a
50
+ * while after the curve ends (END_HOLD_MS); the main thread retires a finished
51
+ * animation as soon as it runs after the curve's end, writing the end values
52
+ * inline in the same task that cancels it, so nothing moves. The hold matters
53
+ * when the curve ends during a main-thread block: WebKit's compositor ends an
54
+ * animation by falling back to the value its main thread last committed.
53
55
  *
54
56
  * Start time: a call that starts from rest (nothing on its channels moving,
55
57
  * no `options.at`) gets no start time, so the browser starts it when it
@@ -62,18 +64,34 @@
62
64
  * `options.at` to line several animators up, so the new curve continues
63
65
  * from the frame on screen. Keyframes are sampled from the call's start, so
64
66
  * a value that keeps moving through a rebuild stays on its curve to the
65
- * frame.
67
+ * frame. `options.start` changes that per call: `'commit'` dates a retarget
68
+ * by the browser's commit as well, and `'presented'` creates the animations
69
+ * of a call from rest two frames later, once its element at rest has been
70
+ * presented (a UI process that applies commits late); a retarget still starts
71
+ * now, from the value and velocity on screen.
72
+ * `handle.curve(property)` hands out the curve a call plays, so a
73
+ * companion can follow it on the same clock.
74
+ * `options.additive` retargets as UIKit does: the old curve keeps going and a
75
+ * curve of the change between the targets is added on top, baked into one
76
+ * animation (two animations on one property leave the compositor in both
77
+ * engines), so the retarget keeps the velocity on screen.
66
78
  *
67
- * WebKit starts an animation created just before a block at its last frame
68
- * time before the block, so there the motion still skips into its curve;
69
- * Chromium starts it after the block.
79
+ * WebKit dates an animation created just before a block at its last frame
80
+ * time before the block, where the first frame after it would show the
81
+ * motion skipped into its curve; when the call's own task ran on more than
82
+ * two frames, the call's first read of that start moves it to that read, so
83
+ * WebKit delays the motion as Chromium's commit does (startAfterBlock). Every
84
+ * call of that task moves together, and a shorter task or a read that other
85
+ * tasks delay keeps the browser's start, so a sequence chained on a call's
86
+ * end (a Reduce Motion cross-fade's second half) keeps its clock.
70
87
  *
71
88
  * Promotion: Mobile Safari runs an animation whose start time is set from
72
89
  * script on its compositor at its first commit only if the element (or the
73
90
  * pseudo-element) already has a compositing layer; without one, a block
74
91
  * right after that commit freezes it (iOS 26.2 simulator: 2 of 7 runs kept
75
92
  * moving, 0 of 5 on a ::before). Every animation the animator creates, and
76
- * every `set`, therefore promotes its channels in the same task: inline
93
+ * every `set` (unless it passes `{promote: false}`), therefore promotes its
94
+ * channels in the same task: inline
77
95
  * `will-change` on the element, merged with the element's own, or the custom
78
96
  * property `--astryx-motion-will-change-<pseudo>` on the host for a
79
97
  * pseudo-element, whose style opts in with
@@ -116,8 +134,8 @@
116
134
  * call that lands too carries a landing still waiting (two calls in one
117
135
  * frame land together), and a later opacity change lands it at once;
118
136
  * - on any other primary pointer (DR3) it completes at once.
119
- * No call option and no theme value lengthens the fade or keeps travel (DR4):
120
- * the fade's length is not a theme role.
137
+ * No call option and no role value lengthens the fade or keeps travel (DR4):
138
+ * the fade's length is not a role.
121
139
  *
122
140
  * Momentum under Reduce Motion (`design:reduced-motion` DR2, DEC-2): a
123
141
  * decay's momentum continues the velocity a finger handed it on release
@@ -129,6 +147,15 @@
129
147
  * Motion policy above, a cross-fade on a coarse pointer or after a touch
130
148
  * release (`touchRelease`) and at once elsewhere (DR2, DR3).
131
149
  *
150
+ * Roles: every spring and curve the animator plays passes through
151
+ * resolveMotion.ts, which names the motion role it plays (`springs.settle`
152
+ * once `registerSpringsTable()` has run, the Reduce Motion fade's curve,
153
+ * which the animator registers alone). The per-role tables stay internal
154
+ * (`spec:AST-094` DEC-15), so a role plays its table value: nothing reads a
155
+ * CSS variable or the element's style for it. A spring written inline at the call
156
+ * site, and a table never registered, play as given; the fade's length is not
157
+ * a role.
158
+ *
132
159
  * A pseudo-element (`options.pseudoElement`, a dialog's `::backdrop`) has no
133
160
  * inline style: its end value is held by a static filling animation (after a
134
161
  * curve ends, and after `set`) until the next animation replaces it, and for
@@ -143,12 +170,15 @@
143
170
  * SYNC: When modified, update:
144
171
  * - /packages/core/src/motion/animator.test.ts
145
172
  * - /packages/core/src/motion/reducedMotionPlan.ts (the Reduce Motion plan)
173
+ * - /packages/core/src/motion/__tests__/animator.interaction.browser.spec.ts
174
+ * - /packages/core/src/motion/resolveMotion.ts (the roles it resolves)
146
175
  * - /packages/core/src/motion/README.md
147
176
  */
148
177
 
149
178
  import { cubicBezier } from "./bezier.js";
150
179
  import { solveSpring, toSpring } from "./spring.js";
151
- import { reducedMotionCrossFade } from "./uikit/timing.js";
180
+ import { resolveMotion } from "./resolveMotion.js";
181
+ import { reducedMotionCrossFade, registerReducedMotionCrossFade } from "./uikit/timing.js";
152
182
  import { planReducedMotion } from "./reducedMotionPlan.js";
153
183
 
154
184
  /**
@@ -179,6 +209,7 @@ import { planReducedMotion } from "./reducedMotionPlan.js";
179
209
  /**
180
210
  * Options of `createAnimator`.
181
211
  */
212
+ /** How `set` puts values in place. */
182
213
 
183
214
  /**
184
215
  * One `animate` / `decay` call's animations.
@@ -237,32 +268,97 @@ export const SETTLE_THRESHOLD = {
237
268
  opacity: 0.001
238
269
  };
239
270
 
240
- /** Keyframes are added until linear interpolation is within this. */
271
+ /**
272
+ * Keyframes are added until linear interpolation is within this: a quarter of
273
+ * a device pixel (this quarter of a CSS pixel, divided by the device pixel
274
+ * ratio where it is above 1), a twentieth of a degree, a 2000th of the size,
275
+ * about one step of an 8-bit alpha. Every one is below what a moving element
276
+ * can show.
277
+ */
241
278
  const SAMPLE_TOLERANCE = {
242
- x: 0.05,
243
- y: 0.05,
244
- rotate: 0.02,
245
- scaleX: 0.0002,
246
- scaleY: 0.0002,
247
- opacity: 0.002
279
+ x: 0.25,
280
+ y: 0.25,
281
+ rotate: 0.05,
282
+ scaleX: 0.0005,
283
+ scaleY: 0.0005,
284
+ opacity: 0.004
248
285
  };
249
286
 
287
+ /** Keyframes start on this grid (ms) and are split where the curve needs it. */
288
+ const SAMPLE_GRID_MS = 1000 / 30;
289
+
250
290
  /** A curve that has not settled by then (an undamped spring) snaps. */
251
291
  const MAX_DURATION_MS = 30_000;
292
+
293
+ /**
294
+ * How long a task must run on past its first call from rest before that
295
+ * counts as a block (WebKit; startAfterBlock): two frames at 60 Hz.
296
+ */
297
+ // Browser start times are frame times and a task's end a live clock, so only a block longer than a frame plus the task's own length can be told apart from that quantization.
298
+ const LATE_START_MS = 34;
299
+
300
+ /**
301
+ * The task calls from rest are made in, shared by every call made in it
302
+ * (every animator's), so one motion's parts that are separate calls start
303
+ * together (startAfterBlock).
304
+ */
305
+
306
+ /** The task the current calls from rest are made in, until it ends. */
307
+ let openTask = null;
308
+
309
+ /** The mark of the running task, opened by its first call from rest. */
310
+ function markTask(time, clock) {
311
+ if (openTask == null) {
312
+ const task = {
313
+ first: time
314
+ };
315
+ openTask = task;
316
+ queueMicrotask(() => {
317
+ task.ended = clock();
318
+ openTask = null;
319
+ });
320
+ }
321
+ return openTask;
322
+ }
323
+
252
324
  /** Above this many keyframes the tolerance is relaxed. */
253
325
  const MAX_KEYFRAMES = 1200;
254
326
  /**
255
327
  * The keyframes hold the end state this long after a curve ends. An engine
256
328
  * whose compositor ends an animation while the main thread is blocked falls
257
- * back to the value its main thread last committed, mid-flight (WebKit); the
258
- * hold keeps the end state on screen through such a block. The main thread
259
- * drops the animation as soon as it runs after the curve's end.
329
+ * back to the value its main thread last committed, the curve's start
330
+ * (WebKit on Linux); the hold keeps the end state on screen through any such
331
+ * block. It only stretches the last keyframe. The main thread retires the
332
+ * animation as soon as it runs after the curve's end.
333
+ *
334
+ * Why a tail inside the curve's own animation, with a bound (measured Oct 24
335
+ * 2026; do not replace it without these proofs):
336
+ * - WebKit on Linux (WebKitGTK and WPE) ignores `fill` on its compositor:
337
+ * a 400 ms move that ends during a 1 s main-thread block snaps back to the
338
+ * block-start position 13 ms after its end, with `fill: forwards` or with
339
+ * no fill, and holds with this tail. iOS 26.2 Mobile Safari holds the end
340
+ * in all three forms, so there the tail is unneeded but harmless (measured
341
+ * Oct 25 2026). The browser proof "a spring that ends inside the block
342
+ * keeps showing its end state" catches it.
343
+ * - A separate static animation of the end state under the curve would hold
344
+ * it without a bound, but two animations on one property push Chromium to
345
+ * run the curve on the main thread: the 1 s block proof moved in 0 of 57
346
+ * frames, the start-before-a-block proof failed, and seeking the curve
347
+ * broke.
260
348
  */
261
- export const END_HOLD_MS = 5000;
349
+ export const END_HOLD_MS = 60_000;
262
350
 
263
351
  /** How often a paused animation is looked at again for retiring, ms. */
264
352
  const RETIRE_RECHECK_MS = 100;
265
353
 
354
+ /**
355
+ * The soonest a running animation's end is looked for again, ms: a frame at
356
+ * 60 Hz. WebKit moves an animation's currentTime once per frame, so a look
357
+ * within a frame reads the frame's time, a fraction of a ms short of the end,
358
+ * and a timer for that fraction would fire again before anything moved.
359
+ */
360
+ const END_RECHECK_MS = 1000 / 60;
361
+
266
362
  /** How long an element stays promoted after its last motion, ms. */
267
363
  export const PROMOTION_LINGER_MS = 500;
268
364
  const CHANNELS = {
@@ -419,8 +515,9 @@ const REDUCED_TRANSITION = {
419
515
  * @example
420
516
  * ```
421
517
  * const animator = createAnimator(sheet);
422
- * // finger lifts at 1200 px/s heading for the detent at 0:
423
- * animator.animate({y: 0}, {spring: springs.sheetDetent, velocity: {y: 1200}});
518
+ * // finger lifts at 1200 px/s heading for the detent at 0 (a component
519
+ * // passes the spring of its motion role):
520
+ * animator.animate({y: 0}, {spring: {response: 0.45, dampingRatio: 0.9}, velocity: {y: 1200}});
424
521
  * // the finger lands again: where is it right now?
425
522
  * const y = animator.get('y', event.timeStamp);
426
523
  * animator.stop(['y']);
@@ -481,6 +578,15 @@ export function createAnimator(element, options = {}) {
481
578
  let ownWillChange = null;
482
579
  /** The stylesheet's will-change when there is no inline value. */
483
580
  let sheetWillChange = '';
581
+ /**
582
+ * Whether sheetWillChange holds a read of the element's current style: it
583
+ * is read in the task after the element is attached, and again after each
584
+ * demotion, so a promotion (a drag's first move) reads no style in its
585
+ * own task.
586
+ */
587
+ let sheetWillChangeRead = false;
588
+ /** The pending read of sheetWillChange, cancelled with its element. */
589
+ let sheetReadTimer = null;
484
590
  let demoteTimer = null;
485
591
  /** A pseudo-element is promoted through a custom property on its host. */
486
592
  const promotionProperty = pseudoElement == null ? null : `--astryx-motion-will-change-${pseudoElement.replace(/^:+/, '')}`;
@@ -553,18 +659,21 @@ export function createAnimator(element, options = {}) {
553
659
  // -- writing --------------------------------------------------------------
554
660
 
555
661
  const finalValue = property => segments.get(property)?.target ?? resting[property];
556
- const writeInline = (channel, value) => {
662
+ const writeInline = (channel, value, release = true) => {
557
663
  if (target == null || pseudoElement != null) {
558
664
  return;
559
665
  }
560
666
  touched.add(channel);
561
667
  const text = inlineText(channel, value);
562
- if (text === IDENTITY_TEXT[channel]) {
563
- // Identity leaves the element when nothing else would move it.
668
+ // An unchanged value is not written: a style write invalidates the
669
+ // element, and WebKit can repaint sticky content stale when that lands in
670
+ // the frame a scroll commits.
671
+ if (target.style.getPropertyValue(channel) !== text) {
564
672
  target.style.setProperty(channel, text);
673
+ }
674
+ if (release && text === IDENTITY_TEXT[channel]) {
675
+ // Identity leaves the element when nothing else would move it.
565
676
  releaseIdentity(channel);
566
- } else {
567
- target.style.setProperty(channel, text);
568
677
  }
569
678
  };
570
679
  const sampleTimes = (property, from, to, tolerance) => {
@@ -584,9 +693,9 @@ export function createAnimator(element, options = {}) {
584
693
  for (let e = 0; e + 1 < edges.length; e++) {
585
694
  const a = edges[e];
586
695
  const b = edges[e + 1];
587
- // A 120 Hz grid, each interval split until the chord is within the
696
+ // A 30 Hz grid, each interval split until the chord is within the
588
697
  // tolerance at its quarter points.
589
- const steps = Math.max(1, Math.ceil((b - a) / (1000 / 120)));
698
+ const steps = Math.max(1, Math.ceil((b - a) / SAMPLE_GRID_MS));
590
699
  const split = (t0, t1, depth) => {
591
700
  const v0 = value(t0);
592
701
  const v1 = t1 === b && breaks.includes(b) ? valueBefore(property, b) : value(t1);
@@ -633,9 +742,10 @@ export function createAnimator(element, options = {}) {
633
742
  running.delete(channel);
634
743
  clearTimeout(retireTimers.get(channel));
635
744
  retireTimers.delete(channel);
636
- // An element's inline style holds the end state, so its old animation can
637
- // go first. A pseudo-element has none: its old animation keeps holding the
638
- // value until the new one exists (same task, no frame in between).
745
+ // An element's inline style takes the value on screen below, so its old
746
+ // animation can go first. A pseudo-element has none: its old animation
747
+ // keeps holding the value until the new one exists (same task, no frame in
748
+ // between).
639
749
  if (pseudoElement == null) {
640
750
  previous?.cancel();
641
751
  }
@@ -648,8 +758,14 @@ export function createAnimator(element, options = {}) {
648
758
  segments.delete(property);
649
759
  }
650
760
  }
651
- writeInline(channel, finalValue);
652
761
  const moving = properties.filter(p => segments.has(p));
762
+ if (moving.length === 0 || target == null || typeof target.animate !== 'function') {
763
+ writeInline(channel, finalValue);
764
+ } else {
765
+ // The value on screen as the curve starts: what a frame painted before
766
+ // the compositor has the curve shows. The end is written at retire.
767
+ writeInline(channel, p => valueAt(p, time));
768
+ }
653
769
  if (target == null || typeof target.animate !== 'function') {
654
770
  previous?.cancel();
655
771
  return;
@@ -697,10 +813,14 @@ export function createAnimator(element, options = {}) {
697
813
  }
698
814
  }
699
815
  }
816
+ // Read where the keyframes are baked: a page moved to another screen
817
+ // bakes its next motion for that screen.
818
+ const devicePixel = 1 / Math.max(1, globalThis.devicePixelRatio || 1);
700
819
  const collect = scale => {
701
820
  const times = new Set([from, end]);
702
821
  for (const property of moving) {
703
- for (const t of sampleTimes(property, from, end, SAMPLE_TOLERANCE[property] * scale)) {
822
+ const tolerance = SAMPLE_TOLERANCE[property] * scale * (property === 'x' || property === 'y' ? devicePixel : 1);
823
+ for (const t of sampleTimes(property, from, end, tolerance)) {
704
824
  times.add(t);
705
825
  }
706
826
  }
@@ -750,8 +870,8 @@ export function createAnimator(element, options = {}) {
750
870
  duration: span,
751
871
  // The last keyframes hold the end state (END_HOLD_MS); filling both
752
872
  // ways also keeps it where an engine honors the fill on its compositor.
753
- // The main thread drops the animation once it runs after the end; the
754
- // inline style already holds the same values, so that changes no pixel.
873
+ // The main thread retires the animation once it runs after the end,
874
+ // writing the end inline in that task, so that changes no pixel.
755
875
  fill: 'both',
756
876
  easing: 'linear',
757
877
  ...(pseudoElement != null ? {
@@ -777,9 +897,16 @@ export function createAnimator(element, options = {}) {
777
897
 
778
898
  /**
779
899
  * Once the main thread runs after the curve's end, the animation leaves the
780
- * running state: an element's inline style already shows the end values; a
781
- * pseudo-element's end value moves to a static holding animation, created
782
- * before the long one goes.
900
+ * running state: an element's end values are written inline in the task
901
+ * that cancels it; a pseudo-element's end value moves to a static holding
902
+ * animation, created before the long one goes.
903
+ *
904
+ * Why a timer at the curve's end: no browser event reports that an
905
+ * animation's time has reached a point inside its effect, and its
906
+ * `finished` comes only after the END_HOLD_MS tail, which would keep the
907
+ * element promoted and the animation alive for a minute. The timer is set
908
+ * on the curve's own clock and re-armed while a sampler pauses or seeks the
909
+ * animation, so it never retires a held one.
783
910
  */
784
911
  const scheduleRetire = (channel, animation, end) => {
785
912
  clearTimeout(retireTimers.get(channel));
@@ -792,7 +919,7 @@ export function createAnimator(element, options = {}) {
792
919
  // reaches the curve's end, never from the wall clock.
793
920
  const remaining = remainingCurve(animation);
794
921
  if (remaining != null && remaining > 0) {
795
- retireTimers.set(channel, setTimeout(retire, animation.playState === 'paused' ? RETIRE_RECHECK_MS : remaining));
922
+ retireTimers.set(channel, setTimeout(retire, animation.playState === 'paused' ? RETIRE_RECHECK_MS : Math.max(remaining, END_RECHECK_MS)));
796
923
  return;
797
924
  }
798
925
  running.delete(channel);
@@ -801,8 +928,25 @@ export function createAnimator(element, options = {}) {
801
928
  const handsBack = channel === 'opacity' && borrowedOpacity != null && ![...landings].some(landing => landing.fadeIn?.isBorrowed === true);
802
929
  if (pseudoElement != null && !handsBack) {
803
930
  hold(channel, now());
931
+ } else {
932
+ // The end goes inline in the task that cancels the animation. Whether
933
+ // an identity end may leave the element is judged after the cancel:
934
+ // until then the end-state tail still holds the end, so the computed
935
+ // style would hide a stylesheet value (an opacity 0) under it.
936
+ writeInline(channel, finalValue, false);
937
+ }
938
+ // A call from rest the browser never started (finished from outside
939
+ // before its first frame, a sampler's finish()): read its start from the
940
+ // animation before the cancel takes it, and with nothing left to wait
941
+ // on the call keeps its own clock, so its landing is still armed.
942
+ const waiting = [...pendingGroups].filter(group => group.animations.includes(animation));
943
+ for (const group of waiting) {
944
+ syncGroup(group);
804
945
  }
805
946
  animation.cancel();
947
+ for (const group of waiting) {
948
+ resolveGroup(group, group.provisional);
949
+ }
806
950
  releaseIdentity(channel);
807
951
  flushReleases();
808
952
  };
@@ -997,8 +1141,12 @@ export function createAnimator(element, options = {}) {
997
1141
  if (ownWillChange == null) {
998
1142
  ownWillChange = element.style.willChange;
999
1143
  // Without an inline value, the stylesheet's reasons stay alongside the
1000
- // promotion's (read once, as the promotion starts).
1001
- sheetWillChange = ownWillChange === '' ? element.ownerDocument.defaultView?.getComputedStyle(element).getPropertyValue('will-change') ?? '' : '';
1144
+ // promotion's. They were read in the task after the element was
1145
+ // attached; a promotion that comes first (an element attached in this
1146
+ // task that moves at once) reads them now.
1147
+ if (ownWillChange === '' && !sheetWillChangeRead) {
1148
+ readSheetWillChange(element);
1149
+ }
1002
1150
  }
1003
1151
  const base = ownWillChange !== '' ? ownWillChange : sheetWillChange;
1004
1152
  const own = base === 'auto' ? '' : base;
@@ -1006,6 +1154,44 @@ export function createAnimator(element, options = {}) {
1006
1154
  element.style.willChange = [...reasons, ...promoted].join(', ');
1007
1155
  };
1008
1156
 
1157
+ /** Reads the element's own will-change while no promotion of ours is written. */
1158
+ const readSheetWillChange = element => {
1159
+ sheetWillChange = element.ownerDocument.defaultView?.getComputedStyle(element).getPropertyValue('will-change') ?? '';
1160
+ sheetWillChangeRead = true;
1161
+ };
1162
+
1163
+ /**
1164
+ * Reads sheetWillChange in a task of its own, so a later promotion reads no
1165
+ * style in its own task. Skipped while a promotion of ours is written,
1166
+ * which the read would see (demote asks again), and for a node out of the
1167
+ * document. A pseudo-element's promotion is its own property, with
1168
+ * nothing to read.
1169
+ */
1170
+ const readSheetWillChangeLater = () => {
1171
+ cancelSheetWillChangeRead();
1172
+ sheetWillChangeRead = false;
1173
+ if (target == null || promotionProperty != null) {
1174
+ return;
1175
+ }
1176
+ const element = target;
1177
+ sheetReadTimer = setTimeout(() => {
1178
+ sheetReadTimer = null;
1179
+ // A node out of the document has no style to read, and reading one
1180
+ // still costs a style pass: a shared animator (animatorFor) is never
1181
+ // detached, so its node can leave with this read waiting. Skipped, the
1182
+ // read waits for a promotion that needs it.
1183
+ if (target === element && promoted.size === 0 && element.isConnected) {
1184
+ readSheetWillChange(element);
1185
+ }
1186
+ }, 0);
1187
+ };
1188
+ const cancelSheetWillChangeRead = () => {
1189
+ if (sheetReadTimer != null) {
1190
+ clearTimeout(sheetReadTimer);
1191
+ sheetReadTimer = null;
1192
+ }
1193
+ };
1194
+
1009
1195
  /**
1010
1196
  * Gives the element (or its pseudo-element) a compositing layer for
1011
1197
  * `channel` from the task that starts the motion: Mobile Safari runs an
@@ -1054,6 +1240,8 @@ export function createAnimator(element, options = {}) {
1054
1240
  promoted.clear();
1055
1241
  if (target != null) {
1056
1242
  writePromotion(target);
1243
+ // Its stylesheet may have changed its will-change since.
1244
+ readSheetWillChangeLater();
1057
1245
  }
1058
1246
  };
1059
1247
 
@@ -1065,7 +1253,7 @@ export function createAnimator(element, options = {}) {
1065
1253
  * pins its clock (`at`). Returns its start group, or null for an explicit
1066
1254
  * start.
1067
1255
  */
1068
- const beginGroup = (time, properties, at) => {
1256
+ const beginGroup = (time, properties, at, start) => {
1069
1257
  if (target == null || typeof target.animate !== 'function') {
1070
1258
  return null;
1071
1259
  }
@@ -1092,7 +1280,11 @@ export function createAnimator(element, options = {}) {
1092
1280
  }
1093
1281
  return null;
1094
1282
  }
1095
- for (const channel of channels) {
1283
+ // A call that continues motion starts now unless it asks for the
1284
+ // browser's start (`commit`). `presented` asks only for a call from rest:
1285
+ // an element still moving is not at rest, so a retarget starts now, from
1286
+ // the value and velocity on screen (spec:AST-094 FR6).
1287
+ for (const channel of start === 'commit' ? [] : channels) {
1096
1288
  for (const property of CHANNELS[channel]) {
1097
1289
  const segment = segments.get(property);
1098
1290
  if (segment != null && time < segment.start + segment.duration && (segment.group == null || segment.group.resolved)) {
@@ -1106,6 +1298,7 @@ export function createAnimator(element, options = {}) {
1106
1298
  });
1107
1299
  return {
1108
1300
  provisional: time,
1301
+ fresh: false,
1109
1302
  segments: [],
1110
1303
  animations: [],
1111
1304
  channels: new Set(),
@@ -1116,7 +1309,7 @@ export function createAnimator(element, options = {}) {
1116
1309
  };
1117
1310
 
1118
1311
  /** Commits a call's changes, from rest when it has a start group. */
1119
- const commitCall = (group, owner, changed, time) => {
1312
+ const commitCall = (group, owner, changed, time, presented = false) => {
1120
1313
  if (group != null) {
1121
1314
  for (const property of changed) {
1122
1315
  const segment = segments.get(property);
@@ -1126,6 +1319,88 @@ export function createAnimator(element, options = {}) {
1126
1319
  }
1127
1320
  }
1128
1321
  }
1322
+ if (presented && group != null && requestFrame != null) {
1323
+ // At rest until then: the animations, and the layer they promote, come
1324
+ // two frames later. Promoting now, a layer at rest for two frames, left
1325
+ // a stale paint of the element's rest in WebKit on iOS 26.2 (a title in
1326
+ // a scroller inside a clipped card) after the motion ended.
1327
+ // Each call waits its own two frames: one queued after another change
1328
+ // flushed the queue, or after an earlier call's first frame, still
1329
+ // waits its two.
1330
+ const call = {
1331
+ group,
1332
+ changed
1333
+ };
1334
+ deferredCalls.push(call);
1335
+ requestFrame(() => requestFrame(() => flushDeferredThrough(call)));
1336
+ return;
1337
+ }
1338
+ startCall(group, changed, time);
1339
+ };
1340
+
1341
+ /** Calls with `start: 'presented'` waiting for their second frame. */
1342
+ const deferredCalls = [];
1343
+
1344
+ /** Creates the animations of the given waiting calls, in call order. */
1345
+ const startDeferred = calls => {
1346
+ for (const {
1347
+ group,
1348
+ changed
1349
+ } of calls) {
1350
+ // Not a channel that holds the curve of a later call still waiting: a
1351
+ // later presented call that took a property over starts that channel
1352
+ // with its own two frames. Every other property starts here, whatever
1353
+ // its segment's group: a value Reduce Motion writes at once, or lands
1354
+ // under a dip, has no curve of this call's.
1355
+ const own = [];
1356
+ let handedTo = null;
1357
+ for (const property of changed) {
1358
+ const holder = CHANNELS[CHANNEL_OF[property]].map(other => segments.get(other)?.group).find(waiting => waiting != null && waiting !== group && deferredCalls.some(call => call.group === waiting));
1359
+ if (holder == null) {
1360
+ own.push(property);
1361
+ continue;
1362
+ }
1363
+ // A curve of this call's in that channel never ran: the element held
1364
+ // it at its start. It starts with the later call, which creates the
1365
+ // channel, dated from that call's start, so the model reads what the
1366
+ // screen shows.
1367
+ const segment = segments.get(property);
1368
+ if (segment != null && segment.group === group) {
1369
+ segment.start += holder.provisional - group.provisional;
1370
+ segment.group = holder;
1371
+ holder.segments.push(segment);
1372
+ group.segments.splice(group.segments.indexOf(segment), 1);
1373
+ handedTo = holder;
1374
+ }
1375
+ }
1376
+ if (own.length === 0 && handedTo != null) {
1377
+ // Everything this call still plays starts with the later call.
1378
+ const adopter = handedTo;
1379
+ group.adoptedBy = adopter;
1380
+ void adopter.started.then(start => resolveGroup(group, start));
1381
+ continue;
1382
+ }
1383
+ // From the call's own time: the curve starts at the browser's commit.
1384
+ startCall(group, own, group.provisional);
1385
+ }
1386
+ };
1387
+
1388
+ /** Creates the animations of every waiting call, in call order. */
1389
+ const flushDeferred = () => {
1390
+ startDeferred(deferredCalls.splice(0));
1391
+ };
1392
+
1393
+ /**
1394
+ * A call's second frame: it starts, with every call queued before it (in
1395
+ * call order), unless another change created it already.
1396
+ */
1397
+ const flushDeferredThrough = call => {
1398
+ const index = deferredCalls.indexOf(call);
1399
+ if (index >= 0) {
1400
+ startDeferred(deferredCalls.splice(0, index + 1));
1401
+ }
1402
+ };
1403
+ const startCall = (group, changed, time) => {
1129
1404
  callGroup = group;
1130
1405
  try {
1131
1406
  commit(changed, time);
@@ -1140,6 +1415,14 @@ export function createAnimator(element, options = {}) {
1140
1415
  return;
1141
1416
  }
1142
1417
  pendingGroups.add(group);
1418
+ group.fresh = true;
1419
+ // The task that creates the animations, not the call's: a presented
1420
+ // call's is its second frame's callback, wherever in its frame the call
1421
+ // was made.
1422
+ group.task = markTask(now(), now);
1423
+ queueMicrotask(() => {
1424
+ group.fresh = false;
1425
+ });
1143
1426
  for (const animation of group.animations) {
1144
1427
  // A cancel before the first frame rejects each one's ready promise.
1145
1428
  animation.ready?.catch(() => {});
@@ -1153,7 +1436,10 @@ export function createAnimator(element, options = {}) {
1153
1436
  // or when its compositor starts them (Chromium). Read it in that first
1154
1437
  // frame, ahead of anything that might pause or seek the animations, and
1155
1438
  // when `ready` settles.
1156
- requestFrame?.(() => syncGroup(group));
1439
+ requestFrame?.(() => {
1440
+ syncGroup(group);
1441
+ group.framed = true;
1442
+ });
1157
1443
  ready.then(() => syncGroup(group), () => settleCancelled(group));
1158
1444
  };
1159
1445
 
@@ -1201,7 +1487,7 @@ export function createAnimator(element, options = {}) {
1201
1487
  }
1202
1488
  for (const animation of group.animations) {
1203
1489
  if (animation.startTime != null) {
1204
- resolveGroup(group, Number(animation.startTime));
1490
+ resolveGroup(group, startAfterBlock(group, Number(animation.startTime)));
1205
1491
  return;
1206
1492
  }
1207
1493
  }
@@ -1222,10 +1508,16 @@ export function createAnimator(element, options = {}) {
1222
1508
  }
1223
1509
  };
1224
1510
 
1225
- /** Reads the start of every call whose first frame has been committed. */
1511
+ /**
1512
+ * Reads the start of every call whose first frame may have been committed:
1513
+ * not those created in the running task, whose start the browser cannot
1514
+ * have set (reading it there can cost a style update per call).
1515
+ */
1226
1516
  const syncPending = () => {
1227
1517
  for (const group of pendingGroups) {
1228
- syncGroup(group);
1518
+ if (!group.fresh) {
1519
+ syncGroup(group);
1520
+ }
1229
1521
  }
1230
1522
  syncFinished();
1231
1523
  };
@@ -1253,6 +1545,50 @@ export function createAnimator(element, options = {}) {
1253
1545
  }
1254
1546
  };
1255
1547
 
1548
+ /**
1549
+ * The start of a call from rest, on the frame that commits it. Chromium,
1550
+ * like Core Animation, starts a pending animation when it commits it, so a
1551
+ * main-thread block later in the call's task delays the motion; WebKit
1552
+ * dates it at its last frame time before that task, so the first frame
1553
+ * after the block would show it skipped into its curve. When the task ran
1554
+ * on more than LATE_START_MS past its first call, a start the browser put
1555
+ * by the task's first animations (a presented call's second frame, not the
1556
+ * call) and more than LATE_START_MS before the call's first read (its
1557
+ * `ready`, once the task has ended, or the first frame after it) moves to
1558
+ * that read, with every animation of the call, and every call of the task
1559
+ * moves to the same read. A shorter task, or a read other tasks delay,
1560
+ * keeps the browser's start.
1561
+ */
1562
+ const startAfterBlock = (group, start) => {
1563
+ const timeline = typeof document === 'undefined' ? null : document.timeline?.currentTime;
1564
+ // A start well after the animations were created is the browser's
1565
+ // commit of them.
1566
+ if (timeline == null || group.framed === true || start > (group.task?.first ?? group.provisional) + LATE_START_MS) {
1567
+ return start;
1568
+ }
1569
+ const {
1570
+ task
1571
+ } = group;
1572
+ // A read in the task's first microtasks comes after its end too.
1573
+ const ended = task?.ended ?? now();
1574
+ if (task == null || ended - task.first <= LATE_START_MS) {
1575
+ return start;
1576
+ }
1577
+ // Read once the task has ended (its `ready`) or in the first frame after
1578
+ // it, both after the block; the task's other calls take the same read.
1579
+ const at = task.at ?? Math.max(now(), timeline);
1580
+ if (at - start <= LATE_START_MS) {
1581
+ return start;
1582
+ }
1583
+ task.at = at;
1584
+ for (const animation of group.animations) {
1585
+ if (animation.playState !== 'idle') {
1586
+ animation.startTime = at;
1587
+ }
1588
+ }
1589
+ return at;
1590
+ };
1591
+
1256
1592
  /** Moves a call from rest onto the time the browser started it. */
1257
1593
  const resolveGroup = (group, start) => {
1258
1594
  if (group.resolved) {
@@ -1291,10 +1627,7 @@ export function createAnimator(element, options = {}) {
1291
1627
  }
1292
1628
  clearTimeout(owner.timer);
1293
1629
  const ends = group.segments.filter(segment => segment.owner === owner).map(segment => segment.start + segment.duration);
1294
- owner.timer = setTimeout(() => {
1295
- owner.timer = null;
1296
- settle(owner, true);
1297
- }, Math.max(0, Math.max(start, ...ends) - now()));
1630
+ owner.timer = setTimeout(() => settleAtEnd(owner), Math.max(0, Math.max(start, ...ends) - now()));
1298
1631
  }
1299
1632
  }
1300
1633
  group.resolve(start);
@@ -1324,26 +1657,70 @@ export function createAnimator(element, options = {}) {
1324
1657
  }
1325
1658
  owner.resolve(finished);
1326
1659
  };
1327
- const makeHandle = (owner, properties, finished, time, group = null) => {
1660
+
1661
+ /**
1662
+ * A handle whose curves have reached their end on the wall clock finishes,
1663
+ * unless a sampler holds one of its animations (paused, or sought back):
1664
+ * then it waits on that animation's own time, as retiring does
1665
+ * (scheduleRetire), so `finished` never resolves under motion still on
1666
+ * screen.
1667
+ */
1668
+ const settleAtEnd = owner => {
1669
+ owner.timer = null;
1670
+ let wait = 0;
1671
+ for (const [channel, animation] of running) {
1672
+ if (!CHANNELS[channel].some(property => segments.get(property)?.owner === owner)) {
1673
+ continue;
1674
+ }
1675
+ const remaining = remainingCurve(animation);
1676
+ if (remaining != null && remaining > 0) {
1677
+ wait = Math.max(wait, animation.playState === 'paused' ? RETIRE_RECHECK_MS : Math.max(remaining, END_RECHECK_MS));
1678
+ }
1679
+ }
1680
+ if (wait > 0) {
1681
+ owner.timer = setTimeout(() => settleAtEnd(owner), wait);
1682
+ return;
1683
+ }
1684
+ settle(owner, true);
1685
+ };
1686
+ const makeHandle = (owner, properties, finished, time, group = null, settlesWithLanding = false) => {
1328
1687
  const ends = properties.map(p => {
1329
1688
  const segment = segments.get(p);
1330
1689
  return segment != null && segment.owner === owner ? segment.start + segment.duration : time;
1331
1690
  });
1332
1691
  const end = Math.max(time, ...ends);
1333
- if (properties.length === 0 || end <= time) {
1692
+ if (settlesWithLanding) {
1693
+ // The landing it joined settles it.
1694
+ } else if (properties.length === 0 || end <= time) {
1334
1695
  settle(owner, true);
1335
1696
  } else {
1336
1697
  // Interruptions settle false as they happen (interrupt); reaching the
1337
1698
  // end untouched is completion.
1338
- owner.timer = setTimeout(() => {
1339
- owner.timer = null;
1340
- settle(owner, true);
1341
- }, Math.max(0, end - now()));
1699
+ owner.timer = setTimeout(() => settleAtEnd(owner), Math.max(0, end - now()));
1700
+ }
1701
+ // The call's own curves, as it started them.
1702
+ const curves = new Map();
1703
+ for (const property of properties) {
1704
+ const segment = segments.get(property);
1705
+ if (segment != null && segment.owner === owner) {
1706
+ curves.set(property, segment);
1707
+ }
1342
1708
  }
1343
1709
  const handle = {
1344
1710
  properties,
1345
1711
  finished,
1346
1712
  started: group?.started ?? Promise.resolve(time),
1713
+ curve: property => {
1714
+ const segment = curves.get(property === 'scale' ? 'scaleX' : property);
1715
+ if (segment == null) {
1716
+ return null;
1717
+ }
1718
+ return {
1719
+ duration: segment.duration / 1000,
1720
+ at: t => t * 1000 >= segment.duration ? segment.target : segment.at(Math.max(0, t * 1000)),
1721
+ velocity: t => t * 1000 >= segment.duration ? 0 : segment.speed(t * 1000)
1722
+ };
1723
+ },
1347
1724
  value: (property, at = now()) => {
1348
1725
  syncPending();
1349
1726
  return valueAt(property, at);
@@ -1392,7 +1769,9 @@ export function createAnimator(element, options = {}) {
1392
1769
  if (from === to && velocity === 0) {
1393
1770
  return null;
1394
1771
  }
1395
- const curve = solveSpring(toSpring(spring), {
1772
+ // The motion role it plays: its table value (DEC-15).
1773
+ const resolved = resolveMotion(target, spring);
1774
+ const curve = solveSpring(toSpring(resolved), {
1396
1775
  from,
1397
1776
  to,
1398
1777
  velocity
@@ -1406,11 +1785,58 @@ export function createAnimator(element, options = {}) {
1406
1785
  speed: t => curve.velocity(t / 1000),
1407
1786
  jumps: [],
1408
1787
  owner,
1409
- spring
1788
+ spring: resolved
1789
+ };
1790
+ };
1791
+
1792
+ /** The retarget of `additive`: the old curve plus a spring of the difference. */
1793
+ const additiveSegment = (owner, property, start, to, spring, old) => {
1794
+ const oldEnd = old.start + old.duration;
1795
+ const resolved = resolveMotion(target, spring);
1796
+ const delta = solveSpring(toSpring(resolved), {
1797
+ from: 0,
1798
+ to: to - old.target,
1799
+ velocity: 0
1800
+ });
1801
+ const deltaMs = Math.min(MAX_DURATION_MS, delta.settleTime(SETTLE_THRESHOLD[property]) * 1000);
1802
+ const ownAt = t => t >= deltaMs ? to - old.target : delta.value(t / 1000);
1803
+ const oldAt = time => time >= oldEnd ? old.target : old.at(Math.max(0, time - old.start));
1804
+ return {
1805
+ start,
1806
+ duration: Math.min(MAX_DURATION_MS, Math.max(oldEnd - start, deltaMs)),
1807
+ target: to,
1808
+ at: t => oldAt(start + t) + ownAt(t),
1809
+ speed: t => (start + t >= oldEnd ? 0 : old.speed(start + t - old.start)) + (t >= deltaMs ? 0 : delta.velocity(t / 1000)),
1810
+ jumps: old.jumps.map(jump => old.start + jump - start).filter(jump => jump > 0),
1811
+ owner,
1812
+ spring: resolved
1813
+ };
1814
+ };
1815
+
1816
+ /**
1817
+ * `additive` for a played curve: the old curve plus the new curve's shape,
1818
+ * scaled to the difference between the two targets.
1819
+ */
1820
+ const additiveCurveSegment = (owner, start, curve, old) => {
1821
+ const from = curve.at(0);
1822
+ const to = curve.at(curve.duration);
1823
+ const scale = (to - old.target) / (to - from);
1824
+ const ms = Math.min(MAX_DURATION_MS, curve.duration * 1000);
1825
+ const oldEnd = old.start + old.duration;
1826
+ const oldAt = time => time >= oldEnd ? old.target : old.at(Math.max(0, time - old.start));
1827
+ return {
1828
+ start,
1829
+ duration: Math.min(MAX_DURATION_MS, Math.max(oldEnd - start, ms)),
1830
+ target: to,
1831
+ at: t => oldAt(start + t) + (t >= ms ? to - old.target : (curve.at(t / 1000) - from) * scale),
1832
+ speed: t => (start + t >= oldEnd ? 0 : old.speed(start + t - old.start)) + (t >= ms ? 0 : curve.velocity(t / 1000) * scale),
1833
+ jumps: old.jumps.map(jump => old.start + jump - start).filter(jump => jump > 0),
1834
+ owner
1410
1835
  };
1411
1836
  };
1412
1837
  const fadeSegment = (owner, start, stops, jumps = []) => {
1413
- const ease = cubicBezier(reducedMotionCrossFade.curve);
1838
+ registerReducedMotionCrossFade();
1839
+ const ease = cubicBezier(resolveMotion(target, reducedMotionCrossFade.curve));
1414
1840
  const duration = stops[stops.length - 1].at;
1415
1841
  const at = t => {
1416
1842
  for (let i = 0; i + 1 < stops.length; i++) {
@@ -1530,6 +1956,27 @@ export function createAnimator(element, options = {}) {
1530
1956
  };
1531
1957
  };
1532
1958
 
1959
+ /**
1960
+ * A call joins the newest waiting dip: it takes the landing over and
1961
+ * settles when the dip ends, and the call it replaces lands with it. Each
1962
+ * value keeps the call whose move it is.
1963
+ */
1964
+ const joinWaitingDip = owner => {
1965
+ const dip = [...landings].reverse().find(landing => landing.fadeIn != null);
1966
+ if (dip == null) {
1967
+ settle(owner, true);
1968
+ return;
1969
+ }
1970
+ for (const property of dip.values.keys()) {
1971
+ if (!dip.owners.has(property)) {
1972
+ dip.owners.set(property, dip.owner);
1973
+ }
1974
+ }
1975
+ dip.carried.push(dip.owner);
1976
+ carriedOwners.add(dip.owner);
1977
+ dip.owner = owner;
1978
+ };
1979
+
1533
1980
  /** Where opacity is heading: past a waiting landing's fade back in. */
1534
1981
  const opacityHeading = () => {
1535
1982
  let to = finalValue('opacity');
@@ -1583,8 +2030,9 @@ export function createAnimator(element, options = {}) {
1583
2030
  * never an animation (DR2: opacity only), so it is never shown in the wrong
1584
2031
  * place. In a dip the fade back in starts from here and takes what is left
1585
2032
  * of the cross-fade, so the dip ends when it was due even when a busy main
1586
- * thread runs this timer late; past the whole fade back in (over 100 ms
1587
- * late) the element appears at once where it landed.
2033
+ * thread runs this timer late; past the whole fade back in (100 ms late or
2034
+ * more) the element appears at once where it landed, with no animation,
2035
+ * and the call settles then.
1588
2036
  */
1589
2037
  const land = landing => {
1590
2038
  landings.delete(landing);
@@ -1597,13 +2045,16 @@ export function createAnimator(element, options = {}) {
1597
2045
  changed.push(property);
1598
2046
  }
1599
2047
  let end = time;
1600
- if (landing.fadeIn != null) {
1601
- // The fade back in takes what is left of the cross-fade: a timer that
1602
- // a busy main thread runs late shortens it, so the dip still ends
1603
- // when it was due (design:reduced-motion DR2, 200 ms or less), and the
1604
- // element is never shown before it lands.
1605
- const late = landing.due == null ? 0 : Math.max(0, time - landing.due);
1606
- const ms = Math.max(1, landing.fadeIn.ms - late);
2048
+ // The fade back in takes what is left of the cross-fade: a timer that a
2049
+ // busy main thread runs late shortens it, so the dip still ends when it
2050
+ // was due (design:reduced-motion DR2, 200 ms or less), and the element is
2051
+ // never shown before it lands. Past the whole fade back in nothing is
2052
+ // left: the element appears at once, a plain write with no fade for the
2053
+ // browser to start a frame later, so the call settles showing it.
2054
+ const late = landing.due == null ? 0 : Math.max(0, time - landing.due);
2055
+ const appears = landing.fadeIn != null && late >= landing.fadeIn.ms;
2056
+ if (landing.fadeIn != null && !appears) {
2057
+ const ms = landing.fadeIn.ms - late;
1607
2058
  segments.set('opacity', fadeSegment(landing.owner, time, [{
1608
2059
  at: 0,
1609
2060
  value: valueAt('opacity', time)
@@ -1613,17 +2064,20 @@ export function createAnimator(element, options = {}) {
1613
2064
  }]));
1614
2065
  changed.push('opacity');
1615
2066
  end = time + ms;
2067
+ } else if (landing.fadeIn != null) {
2068
+ segments.delete('opacity');
2069
+ resting.opacity = landing.fadeIn.isBorrowed === true ? IDENTITY.opacity : landing.fadeIn.to;
2070
+ changed.push('opacity');
1616
2071
  } else if (landing.restore != null) {
1617
2072
  segments.delete('opacity');
1618
2073
  resting.opacity = landing.restoreIsBorrowed === true ? IDENTITY.opacity : landing.restore;
1619
2074
  changed.push('opacity');
1620
2075
  }
1621
2076
  commit(changed, time);
1622
- if (landing.restoreIsBorrowed === true) {
2077
+ if (landing.restoreIsBorrowed === true || appears && landing.fadeIn?.isBorrowed === true) {
1623
2078
  // The stylesheet owns its opacity again.
1624
2079
  releaseOwnOpacity();
1625
- }
1626
- if (landing.fadeIn?.isBorrowed === true) {
2080
+ } else if (landing.fadeIn?.isBorrowed === true) {
1627
2081
  // The fade back in returns to the stylesheet's opacity: it owns it
1628
2082
  // again once the fade ends (releaseIdentity).
1629
2083
  borrowedOpacity = landing.fadeIn.to;
@@ -1644,10 +2098,7 @@ export function createAnimator(element, options = {}) {
1644
2098
  if (end <= time) {
1645
2099
  settle(owner, true);
1646
2100
  } else {
1647
- owner.timer = setTimeout(() => {
1648
- owner.timer = null;
1649
- settle(owner, true);
1650
- }, Math.max(0, end - now()));
2101
+ owner.timer = setTimeout(() => settleAtEnd(owner), Math.max(0, end - now()));
1651
2102
  }
1652
2103
  };
1653
2104
 
@@ -1728,6 +2179,9 @@ export function createAnimator(element, options = {}) {
1728
2179
  },
1729
2180
  get hasPendingLanding() {
1730
2181
  return landings.size > 0;
2182
+ },
2183
+ get hasWaitingDip() {
2184
+ return [...landings].some(landing => landing.fadeIn != null);
1731
2185
  }
1732
2186
  };
1733
2187
 
@@ -1760,7 +2214,8 @@ export function createAnimator(element, options = {}) {
1760
2214
  next,
1761
2215
  holds: plan.holds,
1762
2216
  landing: plan.landing,
1763
- borrowed: plan.borrowed
2217
+ borrowed: plan.borrowed,
2218
+ joins: plan.joins
1764
2219
  };
1765
2220
  };
1766
2221
  const animator = {
@@ -1777,6 +2232,7 @@ export function createAnimator(element, options = {}) {
1777
2232
  if (next === target) {
1778
2233
  return;
1779
2234
  }
2235
+ flushDeferred();
1780
2236
  if (next == null) {
1781
2237
  // Unmount, unless a node replaces this one in the same task (React's
1782
2238
  // replacement order: attach(null), then the new node): nothing is
@@ -1812,6 +2268,9 @@ export function createAnimator(element, options = {}) {
1812
2268
  }
1813
2269
  retireTimers.clear();
1814
2270
  demote();
2271
+ // demote() asks for a fresh will-change read of the node it
2272
+ // demotes; a detached node gets none.
2273
+ cancelSheetWillChangeRead();
1815
2274
  });
1816
2275
  lastDetached = null;
1817
2276
  const time = now();
@@ -1858,6 +2317,9 @@ export function createAnimator(element, options = {}) {
1858
2317
  }
1859
2318
  const held = heldIdentity;
1860
2319
  target = next;
2320
+ // A new node: its own will-change is read again.
2321
+ cancelSheetWillChangeRead();
2322
+ sheetWillChangeRead = false;
1861
2323
  if (target == null) {
1862
2324
  return;
1863
2325
  }
@@ -1889,6 +2351,7 @@ export function createAnimator(element, options = {}) {
1889
2351
  }
1890
2352
  }
1891
2353
  flushReleases();
2354
+ readSheetWillChangeLater();
1892
2355
  },
1893
2356
  get(property, time = now()) {
1894
2357
  syncPending();
@@ -1898,8 +2361,9 @@ export function createAnimator(element, options = {}) {
1898
2361
  syncPending();
1899
2362
  return velocityAt(property === 'scale' ? 'scaleX' : property, time);
1900
2363
  },
1901
- set(values) {
2364
+ set(values, setOptions = {}) {
1902
2365
  syncPending();
2366
+ flushDeferred();
1903
2367
  const time = now();
1904
2368
  const next = expand(values);
1905
2369
  for (const [property, value] of Object.entries(next)) {
@@ -1908,13 +2372,18 @@ export function createAnimator(element, options = {}) {
1908
2372
  resting[property] = value;
1909
2373
  }
1910
2374
  // Direct manipulation: the layer makes each write a composite only.
1911
- for (const property of Object.keys(next)) {
1912
- promote(CHANNEL_OF[property]);
2375
+ if (setOptions.promote !== false) {
2376
+ for (const property of Object.keys(next)) {
2377
+ promote(CHANNEL_OF[property]);
2378
+ }
1913
2379
  }
1914
2380
  commit(Object.keys(next), time);
1915
2381
  },
1916
2382
  animate(to, transition, animateOptions = {}) {
1917
2383
  syncPending();
2384
+ if (animateOptions.start !== 'presented') {
2385
+ flushDeferred();
2386
+ }
1918
2387
  const time = animateOptions.at ?? now();
1919
2388
  const targets = expand(to);
1920
2389
  const velocities = expand(transition.velocity ?? {});
@@ -1931,11 +2400,16 @@ export function createAnimator(element, options = {}) {
1931
2400
  Object.assign(next, plan.next);
1932
2401
  } else {
1933
2402
  for (const property of properties) {
2403
+ const running = animateOptions.additive === true && velocities[property] == null ? segmentAt(property, time) : null;
2404
+ if (running != null && !isHeld(running)) {
2405
+ next[property] = additiveSegment(owner, property, time, targets[property], transition.spring, running);
2406
+ continue;
2407
+ }
1934
2408
  const velocity = velocities[property] ?? velocityAt(property, time);
1935
2409
  next[property] = springSegment(owner, property, time, targets[property], transition.spring, velocity);
1936
2410
  }
1937
2411
  }
1938
- const group = beginGroup(time, Object.keys(next), animateOptions.at);
2412
+ const group = beginGroup(time, Object.keys(next), animateOptions.at, animateOptions.start);
1939
2413
  const adopted = plan?.landing != null ? adoptLandings(plan.landing, Object.keys(next)) : null;
1940
2414
  const changed = [];
1941
2415
  for (const [property, segment] of Object.entries(next)) {
@@ -1950,12 +2424,15 @@ export function createAnimator(element, options = {}) {
1950
2424
  segments.set(property, segment);
1951
2425
  }
1952
2426
  }
1953
- commitCall(group, owner, changed, time);
2427
+ commitCall(group, owner, changed, time, animateOptions.start === 'presented' && animateOptions.at == null);
1954
2428
  if (plan?.borrowed != null) {
1955
2429
  // The dip's own commit cleared it; the borrow lasts the dip.
1956
2430
  borrowedOpacity = plan.borrowed;
1957
2431
  }
1958
- const handle = makeHandle(owner, changed, finished, time, group);
2432
+ if (plan?.joins === true) {
2433
+ joinWaitingDip(owner);
2434
+ }
2435
+ const handle = plan?.joins === true ? makeHandle(owner, ['opacity'], finished, time, group, true) : makeHandle(owner, changed, finished, time, group);
1959
2436
  if (plan?.landing != null) {
1960
2437
  scheduleLanding(owner, handle.started, plan.landing, adopted);
1961
2438
  }
@@ -1963,6 +2440,9 @@ export function createAnimator(element, options = {}) {
1963
2440
  },
1964
2441
  play(curves, playOptions = {}) {
1965
2442
  syncPending();
2443
+ if (playOptions.start !== 'presented') {
2444
+ flushDeferred();
2445
+ }
1966
2446
  const time = playOptions.at ?? now();
1967
2447
  const {
1968
2448
  owner,
@@ -1997,6 +2477,11 @@ export function createAnimator(element, options = {}) {
1997
2477
  continue;
1998
2478
  }
1999
2479
  const curve = byProperty[property];
2480
+ const running = playOptions.additive === true ? segmentAt(property, time) : null;
2481
+ if (running != null && !isHeld(running) && curve.duration > 0 && Math.abs(curve.at(curve.duration) - curve.at(0)) > 1e-9) {
2482
+ next[property] = additiveCurveSegment(owner, time, curve, running);
2483
+ continue;
2484
+ }
2000
2485
  next[property] = curve.duration === 0 ? null : {
2001
2486
  start: time,
2002
2487
  duration: Math.min(MAX_DURATION_MS, curve.duration * 1000),
@@ -2007,7 +2492,7 @@ export function createAnimator(element, options = {}) {
2007
2492
  owner
2008
2493
  };
2009
2494
  }
2010
- const group = beginGroup(time, Object.keys(next), playOptions.at);
2495
+ const group = beginGroup(time, Object.keys(next), playOptions.at, playOptions.start);
2011
2496
  const adopted = plan?.landing != null ? adoptLandings(plan.landing, Object.keys(next)) : null;
2012
2497
  const changed = [];
2013
2498
  for (const [property, segment] of Object.entries(next)) {
@@ -2022,12 +2507,15 @@ export function createAnimator(element, options = {}) {
2022
2507
  segments.set(property, segment);
2023
2508
  }
2024
2509
  }
2025
- commitCall(group, owner, changed, time);
2510
+ commitCall(group, owner, changed, time, playOptions.start === 'presented' && playOptions.at == null);
2026
2511
  if (plan?.borrowed != null) {
2027
2512
  // The dip's own commit cleared it; the borrow lasts the dip.
2028
2513
  borrowedOpacity = plan.borrowed;
2029
2514
  }
2030
- const handle = makeHandle(owner, changed, finished, time, group);
2515
+ if (plan?.joins === true) {
2516
+ joinWaitingDip(owner);
2517
+ }
2518
+ const handle = plan?.joins === true ? makeHandle(owner, ['opacity'], finished, time, group, true) : makeHandle(owner, changed, finished, time, group);
2031
2519
  if (plan?.landing != null) {
2032
2520
  scheduleLanding(owner, handle.started, plan.landing, adopted);
2033
2521
  }
@@ -2035,6 +2523,7 @@ export function createAnimator(element, options = {}) {
2035
2523
  },
2036
2524
  decay(curves, decayOptions = {}) {
2037
2525
  syncPending();
2526
+ flushDeferred();
2038
2527
  const time = decayOptions.at ?? now();
2039
2528
  // Under Reduce Motion only momentum keeps moving (DR2, DEC-2): a curve
2040
2529
  // that is a transition plays as `animate` does, a cross-fade or at once.
@@ -2101,6 +2590,7 @@ export function createAnimator(element, options = {}) {
2101
2590
  },
2102
2591
  stop(properties) {
2103
2592
  syncPending();
2593
+ flushDeferred();
2104
2594
  const time = now();
2105
2595
  const list = properties == null ? PROPERTIES : expandList(properties);
2106
2596
  const changed = [];
@@ -2129,6 +2619,7 @@ export function createAnimator(element, options = {}) {
2129
2619
  },
2130
2620
  rebase(deltas, rebaseOptions = {}) {
2131
2621
  syncPending();
2622
+ flushDeferred();
2132
2623
  const time = rebaseOptions.at ?? now();
2133
2624
  const changed = [];
2134
2625
  const owners = new Set();
@@ -2200,10 +2691,7 @@ export function createAnimator(element, options = {}) {
2200
2691
  end = Math.max(end, segment.start + segment.duration);
2201
2692
  }
2202
2693
  }
2203
- owner.timer = setTimeout(() => {
2204
- owner.timer = null;
2205
- settle(owner, true);
2206
- }, Math.max(0, end - now()));
2694
+ owner.timer = setTimeout(() => settleAtEnd(owner), Math.max(0, end - now()));
2207
2695
  }
2208
2696
  },
2209
2697
  async atRest(properties) {
@@ -2247,6 +2735,7 @@ export function createAnimator(element, options = {}) {
2247
2735
  });
2248
2736
  },
2249
2737
  dispose() {
2738
+ flushDeferred();
2250
2739
  // A Reduce Motion move still waiting to land is written at its end
2251
2740
  // state, so the element is left visible where it was going (the node
2252
2741
  // just detached, when an unmount is pending); its call and the calls
@@ -2275,6 +2764,7 @@ export function createAnimator(element, options = {}) {
2275
2764
  retireTimers.clear();
2276
2765
  handBackBorrow();
2277
2766
  demote();
2767
+ cancelSheetWillChangeRead();
2278
2768
  target = null;
2279
2769
  }
2280
2770
  };