@astryxdesign/core 0.7.11 → 0.7.12-canary.ccb4a6d

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 (533) hide show
  1. package/dist/AppShell/AppShellMobileContext.d.ts.map +1 -1
  2. package/dist/AppShell/AppShellMobileContext.js +4 -3
  3. package/dist/AppShell/useAppShellMainId.d.ts.map +1 -1
  4. package/dist/AppShell/useAppShellMainId.js +3 -2
  5. package/dist/Avatar/AvatarSizeContext.d.ts.map +1 -1
  6. package/dist/Avatar/AvatarSizeContext.js +2 -2
  7. package/dist/Avatar/AvatarStatusLabelContext.d.ts +2 -2
  8. package/dist/Avatar/AvatarStatusLabelContext.d.ts.map +1 -1
  9. package/dist/Avatar/AvatarStatusLabelContext.js +3 -3
  10. package/dist/AvatarGroup/AvatarGroupContext.d.ts.map +1 -1
  11. package/dist/AvatarGroup/AvatarGroupContext.js +2 -2
  12. package/dist/BottomSheet/BottomSheetHostContext.d.ts.map +1 -1
  13. package/dist/BottomSheet/BottomSheetHostContext.js +3 -2
  14. package/dist/BottomSheet/BottomSheetPanel.d.ts.map +1 -1
  15. package/dist/BottomSheet/BottomSheetPanel.js +48 -4
  16. package/dist/BottomSheet/BottomSheetSwitcherContext.d.ts.map +1 -1
  17. package/dist/BottomSheet/BottomSheetSwitcherContext.js +2 -2
  18. package/dist/BottomSheet/bottomSheetEscape.d.ts.map +1 -1
  19. package/dist/BottomSheet/bottomSheetEscape.js +2 -2
  20. package/dist/BottomSheet/bottomSheetStack.d.ts.map +1 -1
  21. package/dist/BottomSheet/bottomSheetStack.js +2 -13
  22. package/dist/BottomSheet/useSheetGestures.d.ts.map +1 -1
  23. package/dist/BottomSheet/useSheetGestures.js +25 -42
  24. package/dist/Breadcrumbs/Breadcrumbs.d.ts.map +1 -1
  25. package/dist/Breadcrumbs/Breadcrumbs.js +2 -2
  26. package/dist/Button/Button.d.ts.map +1 -1
  27. package/dist/Button/Button.js +12 -21
  28. package/dist/Button/buttonHitArea.d.ts.map +1 -1
  29. package/dist/Button/buttonHitArea.js +3 -3
  30. package/dist/ButtonGroup/ButtonGroup.d.ts.map +1 -1
  31. package/dist/ButtonGroup/ButtonGroup.js +13 -7
  32. package/dist/ButtonGroup/ButtonGroupContext.d.ts.map +1 -1
  33. package/dist/ButtonGroup/ButtonGroupContext.js +2 -2
  34. package/dist/Carousel/Carousel.d.ts.map +1 -1
  35. package/dist/Carousel/Carousel.js +24 -15
  36. package/dist/Chat/ChatContext.d.ts.map +1 -1
  37. package/dist/Chat/ChatContext.js +6 -5
  38. package/dist/Chat/useChatStreamScroll.d.ts.map +1 -1
  39. package/dist/Chat/useChatStreamScroll.js +7 -22
  40. package/dist/CheckboxInput/CheckboxRowPressContext.d.ts.map +1 -1
  41. package/dist/CheckboxInput/CheckboxRowPressContext.js +1 -1
  42. package/dist/CheckboxList/CheckboxListContext.d.ts.map +1 -1
  43. package/dist/CheckboxList/CheckboxListContext.js +1 -1
  44. package/dist/Collapsible/CollapsibleGroupContext.d.ts.map +1 -1
  45. package/dist/Collapsible/CollapsibleGroupContext.js +3 -3
  46. package/dist/CommandPalette/CommandPaletteContext.d.ts.map +1 -1
  47. package/dist/CommandPalette/CommandPaletteContext.js +4 -3
  48. package/dist/CommandPalette/busyStartSettle.d.ts.map +1 -1
  49. package/dist/CommandPalette/busyStartSettle.js +2 -2
  50. package/dist/DateInput/TouchDateField.d.ts.map +1 -1
  51. package/dist/DateInput/TouchDateField.js +41 -4
  52. package/dist/Dialog/DialogContext.d.ts.map +1 -1
  53. package/dist/Dialog/DialogContext.js +3 -2
  54. package/dist/DropdownMenu/DropdownMenuContext.d.ts.map +1 -1
  55. package/dist/DropdownMenu/DropdownMenuContext.js +6 -5
  56. package/dist/DropdownMenu/lazyMenuBottomSheet.d.ts.map +1 -1
  57. package/dist/DropdownMenu/lazyMenuBottomSheet.js +4 -15
  58. package/dist/DropdownMenu/menuRegionStops.d.ts.map +1 -1
  59. package/dist/DropdownMenu/menuRegionStops.js +2 -37
  60. package/dist/FormLayout/FormLayoutContext.d.ts.map +1 -1
  61. package/dist/FormLayout/FormLayoutContext.js +2 -2
  62. package/dist/Heading/Heading.d.ts.map +1 -1
  63. package/dist/Heading/Heading.js +19 -16
  64. package/dist/HoverCard/HoverCard.d.ts +1 -2
  65. package/dist/HoverCard/HoverCard.d.ts.map +1 -1
  66. package/dist/HoverCard/useHoverCard.d.ts +1 -2
  67. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  68. package/dist/HoverCard/useHoverCard.js +5 -1
  69. package/dist/Icon/IconDefaultSizeContext.d.ts.map +1 -1
  70. package/dist/Icon/IconDefaultSizeContext.js +2 -2
  71. package/dist/InputGroup/InputGroupContext.d.ts.map +1 -1
  72. package/dist/InputGroup/InputGroupContext.js +2 -2
  73. package/dist/InputGroup/InputGroupInternalContext.d.ts.map +1 -1
  74. package/dist/InputGroup/InputGroupInternalContext.js +2 -2
  75. package/dist/InteractiveRoleContext/InteractiveRoleContext.d.ts.map +1 -1
  76. package/dist/InteractiveRoleContext/InteractiveRoleContext.js +5 -3
  77. package/dist/Item/ItemDescriptionContext.d.ts.map +1 -1
  78. package/dist/Item/ItemDescriptionContext.js +3 -3
  79. package/dist/Item/ItemListRowContext.d.ts.map +1 -1
  80. package/dist/Item/ItemListRowContext.js +3 -3
  81. package/dist/Item/ItemMarkerColumnsContext.d.ts +1 -1
  82. package/dist/Item/ItemMarkerColumnsContext.d.ts.map +1 -1
  83. package/dist/Item/ItemMarkerColumnsContext.js +2 -2
  84. package/dist/Layer/LayerContext.d.ts.map +1 -1
  85. package/dist/Layer/LayerContext.js +3 -2
  86. package/dist/Layer/LayerDepthContext.d.ts.map +1 -1
  87. package/dist/Layer/LayerDepthContext.js +3 -2
  88. package/dist/Layer/LayerTouch.d.ts +3 -2
  89. package/dist/Layer/LayerTouch.d.ts.map +1 -1
  90. package/dist/Layer/LayerTouch.js +3 -2
  91. package/dist/Layer/anchorName.d.ts.map +1 -1
  92. package/dist/Layer/anchorName.js +5 -1
  93. package/dist/Layer/inputHold.d.ts.map +1 -1
  94. package/dist/Layer/inputHold.js +115 -13
  95. package/dist/Layer/layerScopedContext.d.ts +5 -2
  96. package/dist/Layer/layerScopedContext.d.ts.map +1 -1
  97. package/dist/Layer/layerScopedContext.js +27 -10
  98. package/dist/Layer/layerSlideRules.d.ts +28 -26
  99. package/dist/Layer/layerSlideRules.d.ts.map +1 -1
  100. package/dist/Layer/layerSlideRules.js +41 -40
  101. package/dist/Layer/outsidePress.d.ts +21 -3
  102. package/dist/Layer/outsidePress.d.ts.map +1 -1
  103. package/dist/Layer/outsidePress.js +119 -29
  104. package/dist/Layer/settledBox.d.ts +9 -8
  105. package/dist/Layer/settledBox.d.ts.map +1 -1
  106. package/dist/Layer/settledBox.js +169 -49
  107. package/dist/Layer/toastHost.d.ts.map +1 -1
  108. package/dist/Layer/toastHost.js +3 -2
  109. package/dist/Layer/useLayer.d.ts.map +1 -1
  110. package/dist/Layer/useLayer.js +172 -60
  111. package/dist/Layer/useLayerKeyboardClearance.d.ts +14 -2
  112. package/dist/Layer/useLayerKeyboardClearance.d.ts.map +1 -1
  113. package/dist/Layer/useLayerKeyboardClearance.js +83 -12
  114. package/dist/Layer/useTouchTrigger.d.ts +21 -1
  115. package/dist/Layer/useTouchTrigger.d.ts.map +1 -1
  116. package/dist/Layer/useTouchTrigger.js +61 -37
  117. package/dist/Layout/Layout.d.ts +1 -1
  118. package/dist/Layout/Layout.d.ts.map +1 -1
  119. package/dist/Layout/Layout.js +10 -6
  120. package/dist/Layout/LayoutAreaContext.d.ts.map +1 -1
  121. package/dist/Layout/LayoutAreaContext.js +3 -3
  122. package/dist/Layout/LayoutContent.d.ts +6 -6
  123. package/dist/Layout/LayoutContent.js +9 -9
  124. package/dist/Layout/LayoutDividerContext.d.ts.map +1 -1
  125. package/dist/Layout/LayoutDividerContext.js +2 -2
  126. package/dist/Layout/LayoutSlotsContext.d.ts.map +1 -1
  127. package/dist/Layout/LayoutSlotsContext.js +2 -2
  128. package/dist/Link/LinkContext.d.ts +16 -0
  129. package/dist/Link/LinkContext.d.ts.map +1 -1
  130. package/dist/Link/LinkContext.js +3 -3
  131. package/dist/List/List.d.ts +12 -1
  132. package/dist/List/List.d.ts.map +1 -1
  133. package/dist/List/List.js +29 -10
  134. package/dist/List/ListContext.d.ts +18 -3
  135. package/dist/List/ListContext.d.ts.map +1 -1
  136. package/dist/List/ListContext.js +9 -6
  137. package/dist/List/ListItem.d.ts +13 -4
  138. package/dist/List/ListItem.d.ts.map +1 -1
  139. package/dist/List/ListItem.js +37 -10
  140. package/dist/List/listLayoutUpdates.d.ts +34 -0
  141. package/dist/List/listLayoutUpdates.d.ts.map +1 -0
  142. package/dist/List/listLayoutUpdates.js +539 -0
  143. package/dist/Markdown/Markdown.d.ts.map +1 -1
  144. package/dist/Markdown/Markdown.js +57 -10
  145. package/dist/Markdown/blockDirection.d.ts +26 -0
  146. package/dist/Markdown/blockDirection.d.ts.map +1 -0
  147. package/dist/Markdown/blockDirection.js +68 -0
  148. package/dist/Markdown/plugins/HeadingLinksRenderer.d.ts +3 -1
  149. package/dist/Markdown/plugins/HeadingLinksRenderer.d.ts.map +1 -1
  150. package/dist/Markdown/plugins/HeadingLinksRenderer.js +3 -1
  151. package/dist/MetadataList/MetadataListContext.d.ts.map +1 -1
  152. package/dist/MetadataList/MetadataListContext.js +2 -2
  153. package/dist/NavMenu/NavMenuContext.d.ts.map +1 -1
  154. package/dist/NavMenu/NavMenuContext.js +5 -4
  155. package/dist/Popover/Popover.d.ts.map +1 -1
  156. package/dist/Popover/Popover.js +9 -9
  157. package/dist/Popover/usePopover.d.ts.map +1 -1
  158. package/dist/Popover/usePopover.js +11 -8
  159. package/dist/RadioList/RadioList.d.ts.map +1 -1
  160. package/dist/RadioList/RadioList.js +2 -2
  161. package/dist/RadioList/RadioListReasonContext.d.ts.map +1 -1
  162. package/dist/RadioList/RadioListReasonContext.js +1 -1
  163. package/dist/SegmentedControl/SegmentedControlContext.d.ts.map +1 -1
  164. package/dist/SegmentedControl/SegmentedControlContext.js +2 -2
  165. package/dist/SelectableCard/selectableCardInput.d.ts.map +1 -1
  166. package/dist/SelectableCard/selectableCardInput.js +2 -2
  167. package/dist/Selector/SelectorRowLayoutContext.d.ts.map +1 -1
  168. package/dist/Selector/SelectorRowLayoutContext.js +2 -2
  169. package/dist/SideNav/SideNavCollapseButton.d.ts +4 -3
  170. package/dist/SideNav/SideNavCollapseButton.d.ts.map +1 -1
  171. package/dist/SideNav/SideNavCollapseContext.d.ts.map +1 -1
  172. package/dist/SideNav/SideNavCollapseContext.js +4 -3
  173. package/dist/SideNav/SideNavFocusTargetsContext.d.ts.map +1 -1
  174. package/dist/SideNav/SideNavFocusTargetsContext.js +2 -2
  175. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  176. package/dist/SideNav/SideNavItem.js +3 -2
  177. package/dist/SideNav/SideNavRenderContext.d.ts.map +1 -1
  178. package/dist/SideNav/SideNavRenderContext.js +4 -3
  179. package/dist/SideNav/railMotion.d.ts +40 -0
  180. package/dist/SideNav/railMotion.d.ts.map +1 -1
  181. package/dist/SideNav/railMotion.js +2 -2
  182. package/dist/SizeContext/SizeContext.d.ts.map +1 -1
  183. package/dist/SizeContext/SizeContext.js +2 -2
  184. package/dist/SnapPaging/SnapPaging.d.ts.map +1 -1
  185. package/dist/SnapPaging/SnapPaging.js +162 -36
  186. package/dist/SnapPaging/snapPagingValue.d.ts +29 -3
  187. package/dist/SnapPaging/snapPagingValue.d.ts.map +1 -1
  188. package/dist/SnapPaging/snapPagingValue.js +38 -6
  189. package/dist/Spinner/SpinnerOwnerContext.d.ts.map +1 -1
  190. package/dist/Spinner/SpinnerOwnerContext.js +2 -2
  191. package/dist/Stepper/StepperContext.d.ts.map +1 -1
  192. package/dist/Stepper/StepperContext.js +3 -3
  193. package/dist/Switch/useSwitchTouch.d.ts.map +1 -1
  194. package/dist/Switch/useSwitchTouch.js +8 -3
  195. package/dist/TabList/TabListContext.d.ts.map +1 -1
  196. package/dist/TabList/TabListContext.js +2 -2
  197. package/dist/Table/BaseTable.d.ts +3 -2
  198. package/dist/Table/BaseTable.d.ts.map +1 -1
  199. package/dist/Table/BaseTable.js +73 -16
  200. package/dist/Table/Table.d.ts.map +1 -1
  201. package/dist/Table/Table.js +3 -2
  202. package/dist/Table/TableContext.d.ts.map +1 -1
  203. package/dist/Table/TableContext.js +2 -2
  204. package/dist/Table/index.d.ts +1 -1
  205. package/dist/Table/index.d.ts.map +1 -1
  206. package/dist/Table/plugins/filtering/useTableFiltering.d.ts.map +1 -1
  207. package/dist/Table/plugins/filtering/useTableFiltering.js +4 -3
  208. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.d.ts.map +1 -1
  209. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.js +5 -3
  210. package/dist/Table/plugins/rowIndex/useTableRowIndex.d.ts +16 -18
  211. package/dist/Table/plugins/rowIndex/useTableRowIndex.d.ts.map +1 -1
  212. package/dist/Table/plugins/rowIndex/useTableRowIndex.js +48 -39
  213. package/dist/Table/plugins/selection/useTableSelection.d.ts.map +1 -1
  214. package/dist/Table/plugins/selection/useTableSelection.js +4 -2
  215. package/dist/Table/plugins/stickyColumns/useTableStickyColumns.d.ts.map +1 -1
  216. package/dist/Table/plugins/stickyColumns/useTableStickyColumns.js +1 -0
  217. package/dist/Table/plugins/tree/useTableTreeData.d.ts.map +1 -1
  218. package/dist/Table/plugins/tree/useTableTreeData.js +3 -2
  219. package/dist/Table/tableRowContextUsage.d.ts +21 -0
  220. package/dist/Table/tableRowContextUsage.d.ts.map +1 -0
  221. package/dist/Table/tableRowContextUsage.js +88 -0
  222. package/dist/Table/types.d.ts +58 -5
  223. package/dist/Table/types.d.ts.map +1 -1
  224. package/dist/Table/useBaseTablePlugins.d.ts.map +1 -1
  225. package/dist/Table/useBaseTablePlugins.js +5 -2
  226. package/dist/Text/Text.d.ts.map +1 -1
  227. package/dist/Text/Text.js +18 -14
  228. package/dist/Text/TruncationTooltip.d.ts +45 -0
  229. package/dist/Text/TruncationTooltip.d.ts.map +1 -0
  230. package/dist/Text/TruncationTooltip.js +123 -0
  231. package/dist/Text/textClampContext.d.ts.map +1 -1
  232. package/dist/Text/textClampContext.js +1 -1
  233. package/dist/TimeInput/TimeInput.d.ts.map +1 -1
  234. package/dist/TimeInput/TimeInput.js +4 -0
  235. package/dist/ToggleButton/ToggleButtonGroup.d.ts.map +1 -1
  236. package/dist/ToggleButton/ToggleButtonGroup.js +2 -2
  237. package/dist/Token/TokenNamingContext.d.ts.map +1 -1
  238. package/dist/Token/TokenNamingContext.js +2 -2
  239. package/dist/Tokenizer/TokenizerClearAllMessageContext.d.ts.map +1 -1
  240. package/dist/Tokenizer/TokenizerClearAllMessageContext.js +2 -2
  241. package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts +12 -0
  242. package/dist/Tokenizer/TokenizerItemRemovableContext.d.ts.map +1 -1
  243. package/dist/Tokenizer/TokenizerItemRemovableContext.js +2 -2
  244. package/dist/Toolbar/Toolbar.d.ts.map +1 -1
  245. package/dist/Toolbar/Toolbar.js +12 -6
  246. package/dist/Tooltip/tooltipPresentInterest.d.ts +29 -0
  247. package/dist/Tooltip/tooltipPresentInterest.d.ts.map +1 -0
  248. package/dist/Tooltip/tooltipPresentInterest.js +29 -0
  249. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  250. package/dist/Tooltip/useTooltip.js +30 -4
  251. package/dist/TopNav/TopNavContext.d.ts.map +1 -1
  252. package/dist/TopNav/TopNavContext.js +2 -2
  253. package/dist/TopNav/TopNavMobileContentContext.d.ts +1 -1
  254. package/dist/TopNav/TopNavMobileContentContext.d.ts.map +1 -1
  255. package/dist/TopNav/TopNavMobileContentContext.js +4 -3
  256. package/dist/TopNav/TopNavRenderContext.d.ts.map +1 -1
  257. package/dist/TopNav/TopNavRenderContext.js +4 -3
  258. package/dist/Typeahead/busyIndicatorLane.d.ts.map +1 -1
  259. package/dist/Typeahead/busyIndicatorLane.js +3 -2
  260. package/dist/Typeahead/committedChoicesKey.d.ts.map +1 -1
  261. package/dist/Typeahead/committedChoicesKey.js +3 -2
  262. package/dist/Typeahead/trailingKeyDown.d.ts.map +1 -1
  263. package/dist/Typeahead/trailingKeyDown.js +3 -2
  264. package/dist/astryx.css +18 -8
  265. package/dist/gestures/GestureArena.d.ts +2 -0
  266. package/dist/gestures/GestureArena.d.ts.map +1 -1
  267. package/dist/gestures/GestureArena.js +8 -1
  268. package/dist/gestures/GestureRecognizer.d.ts +6 -0
  269. package/dist/gestures/GestureRecognizer.d.ts.map +1 -1
  270. package/dist/gestures/GestureRecognizer.js +9 -0
  271. package/dist/gestures/PressTracker.d.ts.map +1 -1
  272. package/dist/gestures/PressTracker.js +9 -4
  273. package/dist/hooks/focusableSelector.d.ts +13 -1
  274. package/dist/hooks/focusableSelector.d.ts.map +1 -1
  275. package/dist/hooks/focusableSelector.js +22 -2
  276. package/dist/hooks/longPressDetector.d.ts.map +1 -1
  277. package/dist/hooks/longPressDetector.js +1 -25
  278. package/dist/hooks/pressGroupContext.d.ts.map +1 -1
  279. package/dist/hooks/pressGroupContext.js +1 -1
  280. package/dist/hooks/useActionGroupTracking.d.ts +18 -1
  281. package/dist/hooks/useActionGroupTracking.d.ts.map +1 -1
  282. package/dist/hooks/useActionGroupTracking.js +13 -2
  283. package/dist/hooks/useAnnounce.d.ts.map +1 -1
  284. package/dist/hooks/useAnnounce.js +3 -2
  285. package/dist/hooks/useFocusTrap.d.ts +11 -0
  286. package/dist/hooks/useFocusTrap.d.ts.map +1 -1
  287. package/dist/hooks/useFocusTrap.js +47 -2
  288. package/dist/hooks/useListFocus.d.ts +7 -0
  289. package/dist/hooks/useListFocus.d.ts.map +1 -1
  290. package/dist/hooks/useListFocus.js +20 -3
  291. package/dist/hooks/usePager.d.ts.map +1 -1
  292. package/dist/hooks/usePager.js +26 -3
  293. package/dist/hooks/useScrollOverflow.d.ts +22 -0
  294. package/dist/hooks/useScrollOverflow.d.ts.map +1 -1
  295. package/dist/hooks/useScrollOverflow.js +67 -11
  296. package/dist/i18n/InternationalizationContext.d.ts +19 -0
  297. package/dist/i18n/InternationalizationContext.d.ts.map +1 -1
  298. package/dist/i18n/InternationalizationContext.js +3 -3
  299. package/dist/i18n/englishFallback.d.ts.map +1 -1
  300. package/dist/i18n/englishFallback.js +5 -1
  301. package/dist/i18n/firstStrongDirection.d.ts +7 -0
  302. package/dist/i18n/firstStrongDirection.d.ts.map +1 -0
  303. package/dist/i18n/firstStrongDirection.js +65 -0
  304. package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
  305. package/dist/i18n/generated-locales/en.generated.js +1 -0
  306. package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
  307. package/dist/i18n/generated-locales/pseudo.generated.js +1 -0
  308. package/dist/internal/scroll-anchoring.d.ts +16 -0
  309. package/dist/internal/scroll-anchoring.d.ts.map +1 -0
  310. package/dist/internal/scroll-anchoring.js +16 -0
  311. package/dist/internal/touch.d.ts +2 -0
  312. package/dist/internal/touch.d.ts.map +1 -1
  313. package/dist/internal/touch.js +4 -1
  314. package/dist/motion/animatedLayout.d.ts +8 -0
  315. package/dist/motion/animatedLayout.d.ts.map +1 -1
  316. package/dist/motion/animatedLayout.js +51 -3
  317. package/dist/motion/animator.d.ts +19 -2
  318. package/dist/motion/animator.d.ts.map +1 -1
  319. package/dist/motion/animator.js +72 -7
  320. package/dist/privateAttributes/itemKey.stylex.d.ts +5 -0
  321. package/dist/privateAttributes/itemKey.stylex.d.ts.map +1 -0
  322. package/dist/privateAttributes/itemKey.stylex.js +25 -0
  323. package/dist/privateAttributes/leaving.stylex.d.ts +5 -0
  324. package/dist/privateAttributes/leaving.stylex.d.ts.map +1 -0
  325. package/dist/privateAttributes/leaving.stylex.js +23 -0
  326. package/dist/privateAttributes/press.stylex.d.ts.map +1 -1
  327. package/dist/privateAttributes/press.stylex.js +13 -3
  328. package/dist/privateAttributes/scrollAnchoring.stylex.d.ts +7 -0
  329. package/dist/privateAttributes/scrollAnchoring.stylex.d.ts.map +1 -0
  330. package/dist/privateAttributes/scrollAnchoring.stylex.js +50 -0
  331. package/dist/privateAttributes/travelling.stylex.d.ts +27 -0
  332. package/dist/privateAttributes/travelling.stylex.d.ts.map +1 -0
  333. package/dist/privateAttributes/travelling.stylex.js +51 -0
  334. package/dist/theme/Theme.d.ts.map +1 -1
  335. package/dist/theme/Theme.js +95 -49
  336. package/dist/theme/syntax/SyntaxTheme.d.ts.map +1 -1
  337. package/dist/theme/syntax/SyntaxTheme.js +3 -2
  338. package/dist/theme/useTheme.d.ts.map +1 -1
  339. package/dist/theme/useTheme.js +3 -2
  340. package/dist/utils/calendarSystem.d.ts.map +1 -1
  341. package/dist/utils/calendarSystem.js +4 -1
  342. package/dist/utils/flatTree.d.ts +13 -0
  343. package/dist/utils/flatTree.d.ts.map +1 -1
  344. package/dist/utils/flatTree.js +28 -4
  345. package/dist/utils/inputAge.d.ts +22 -0
  346. package/dist/utils/inputAge.d.ts.map +1 -0
  347. package/dist/utils/inputAge.js +54 -0
  348. package/dist/utils/inputStream.d.ts +8 -0
  349. package/dist/utils/inputStream.d.ts.map +1 -1
  350. package/dist/utils/inputStream.js +53 -3
  351. package/dist/utils/moduleLoader.d.ts +23 -0
  352. package/dist/utils/moduleLoader.d.ts.map +1 -0
  353. package/dist/utils/moduleLoader.js +31 -0
  354. package/dist/utils/pressFeedback.d.ts.map +1 -1
  355. package/dist/utils/pressFeedback.js +13 -8
  356. package/dist/utils/selectionLock.d.ts.map +1 -1
  357. package/dist/utils/selectionLock.js +7 -14
  358. package/dist/utils/sharedContext.d.ts +18 -0
  359. package/dist/utils/sharedContext.d.ts.map +1 -0
  360. package/dist/utils/sharedContext.js +33 -0
  361. package/dist/utils/sharedRealm.d.ts +24 -0
  362. package/dist/utils/sharedRealm.d.ts.map +1 -0
  363. package/dist/utils/sharedRealm.js +38 -0
  364. package/locales/en.json +4 -0
  365. package/locales/pseudo.json +3 -0
  366. package/package.json +10 -5
  367. package/src/AppShell/AppShellMobileContext.tsx +8 -3
  368. package/src/AppShell/useAppShellMainId.ts +7 -2
  369. package/src/Avatar/AvatarSizeContext.ts +6 -2
  370. package/src/Avatar/AvatarStatusLabelContext.ts +8 -3
  371. package/src/AvatarGroup/AvatarGroupContext.ts +7 -4
  372. package/src/BottomSheet/BottomSheetHostContext.ts +7 -3
  373. package/src/BottomSheet/BottomSheetPanel.tsx +56 -7
  374. package/src/BottomSheet/BottomSheetSwitcherContext.ts +7 -2
  375. package/src/BottomSheet/bottomSheetEscape.ts +6 -2
  376. package/src/BottomSheet/bottomSheetStack.ts +6 -14
  377. package/src/BottomSheet/useSheetGestures.ts +28 -48
  378. package/src/Breadcrumbs/Breadcrumbs.tsx +6 -5
  379. package/src/Button/Button.doc.mjs +3 -3
  380. package/src/Button/Button.tsx +10 -22
  381. package/src/Button/buttonHitArea.ts +7 -4
  382. package/src/ButtonGroup/ButtonGroup.doc.mjs +3 -3
  383. package/src/ButtonGroup/ButtonGroup.tsx +27 -16
  384. package/src/ButtonGroup/ButtonGroupContext.ts +7 -4
  385. package/src/Carousel/Carousel.tsx +33 -15
  386. package/src/Chat/ChatContext.tsx +23 -7
  387. package/src/Chat/useChatStreamScroll.ts +7 -26
  388. package/src/CheckboxInput/CheckboxRowPressContext.ts +5 -1
  389. package/src/CheckboxList/CheckboxListContext.tsx +5 -1
  390. package/src/Collapsible/CollapsibleGroupContext.tsx +11 -3
  391. package/src/CommandPalette/CommandPaletteContext.ts +8 -3
  392. package/src/CommandPalette/busyStartSettle.ts +6 -2
  393. package/src/DateInput/TouchDateField.tsx +62 -4
  394. package/src/Dialog/DialogContext.ts +7 -2
  395. package/src/DropdownMenu/DropdownMenuContext.tsx +18 -5
  396. package/src/DropdownMenu/lazyMenuBottomSheet.ts +6 -18
  397. package/src/DropdownMenu/menuRegionStops.ts +1 -49
  398. package/src/FormLayout/FormLayoutContext.ts +3 -3
  399. package/src/Heading/Heading.tsx +34 -18
  400. package/src/HoverCard/HoverCard.doc.mjs +3 -3
  401. package/src/HoverCard/HoverCard.tsx +1 -2
  402. package/src/HoverCard/useHoverCard.tsx +6 -2
  403. package/src/Icon/IconDefaultSizeContext.ts +6 -2
  404. package/src/IconButton/IconButton.doc.mjs +2 -2
  405. package/src/InputGroup/InputGroupContext.ts +7 -4
  406. package/src/InputGroup/InputGroupInternalContext.ts +6 -2
  407. package/src/InteractiveRoleContext/InteractiveRoleContext.ts +8 -3
  408. package/src/Item/ItemDescriptionContext.tsx +7 -3
  409. package/src/Item/ItemListRowContext.tsx +7 -3
  410. package/src/Item/ItemMarkerColumnsContext.tsx +7 -2
  411. package/src/Layer/LayerContext.ts +7 -2
  412. package/src/Layer/LayerDepthContext.tsx +3 -2
  413. package/src/Layer/LayerTouch.ts +6 -2
  414. package/src/Layer/anchorName.ts +8 -4
  415. package/src/Layer/inputHold.ts +138 -21
  416. package/src/Layer/layerScopedContext.tsx +34 -7
  417. package/src/Layer/layerSlideRules.ts +43 -40
  418. package/src/Layer/outsidePress.ts +144 -28
  419. package/src/Layer/settledBox.ts +216 -54
  420. package/src/Layer/toastHost.tsx +6 -2
  421. package/src/Layer/useLayer.tsx +200 -69
  422. package/src/Layer/useLayerKeyboardClearance.ts +90 -12
  423. package/src/Layer/useTouchTrigger.ts +89 -40
  424. package/src/Layout/Layout.doc.mjs +17 -0
  425. package/src/Layout/Layout.tsx +13 -9
  426. package/src/Layout/LayoutAreaContext.ts +8 -9
  427. package/src/Layout/LayoutContent.doc.mjs +11 -0
  428. package/src/Layout/LayoutContent.tsx +9 -9
  429. package/src/Layout/LayoutDividerContext.ts +6 -2
  430. package/src/Layout/LayoutSlotsContext.ts +6 -3
  431. package/src/Link/LinkContext.ts +7 -3
  432. package/src/List/List.doc.mjs +5 -0
  433. package/src/List/List.tsx +53 -5
  434. package/src/List/ListContext.tsx +28 -6
  435. package/src/List/ListItem.doc.mjs +11 -0
  436. package/src/List/ListItem.tsx +51 -14
  437. package/src/List/listLayoutUpdates.ts +603 -0
  438. package/src/Markdown/Markdown.tsx +93 -5
  439. package/src/Markdown/blockDirection.ts +100 -0
  440. package/src/Markdown/plugins/HeadingLinksRenderer.tsx +4 -0
  441. package/src/MetadataList/MetadataListContext.tsx +6 -2
  442. package/src/NavMenu/NavMenuContext.tsx +14 -5
  443. package/src/Popover/Popover.tsx +23 -16
  444. package/src/Popover/usePopover.tsx +21 -7
  445. package/src/RadioList/RadioList.tsx +7 -4
  446. package/src/RadioList/RadioListReasonContext.ts +1 -1
  447. package/src/Section/Section.doc.mjs +22 -0
  448. package/src/SegmentedControl/SegmentedControlContext.ts +6 -2
  449. package/src/SelectableCard/selectableCardInput.ts +6 -2
  450. package/src/Selector/SelectorRowLayoutContext.ts +6 -2
  451. package/src/SideNav/SideNavCollapseButton.doc.mjs +5 -5
  452. package/src/SideNav/SideNavCollapseButton.tsx +4 -3
  453. package/src/SideNav/SideNavCollapseContext.ts +12 -7
  454. package/src/SideNav/SideNavFocusTargetsContext.ts +6 -2
  455. package/src/SideNav/SideNavItem.tsx +6 -2
  456. package/src/SideNav/SideNavRenderContext.ts +9 -8
  457. package/src/SideNav/railMotion.ts +6 -2
  458. package/src/SizeContext/SizeContext.ts +6 -2
  459. package/src/SnapPaging/SnapPaging.ts +164 -39
  460. package/src/SnapPaging/snapPagingValue.ts +59 -12
  461. package/src/Spinner/SpinnerOwnerContext.ts +6 -2
  462. package/src/Stepper/StepperContext.ts +12 -3
  463. package/src/Switch/useSwitchTouch.ts +7 -5
  464. package/src/TabList/TabListContext.ts +7 -2
  465. package/src/Table/BaseTable.tsx +143 -19
  466. package/src/Table/Table.tsx +4 -3
  467. package/src/Table/TableContext.ts +6 -2
  468. package/src/Table/index.ts +2 -0
  469. package/src/Table/plugins/filtering/useTableFiltering.tsx +11 -3
  470. package/src/Table/plugins/rowExpansion/useTableRowExpansion.tsx +10 -3
  471. package/src/Table/plugins/rowIndex/useTableRowIndex.tsx +38 -29
  472. package/src/Table/plugins/selection/useTableSelection.tsx +7 -2
  473. package/src/Table/plugins/stickyColumns/useTableStickyColumns.tsx +1 -0
  474. package/src/Table/plugins/tree/useTableTreeData.tsx +6 -2
  475. package/src/Table/tableRowContextUsage.ts +105 -0
  476. package/src/Table/types.ts +60 -2
  477. package/src/Table/useBaseTablePlugins.ts +5 -2
  478. package/src/Table/useTableRowIndex.doc.mjs +6 -7
  479. package/src/Text/Text.tsx +34 -18
  480. package/src/Text/TruncationTooltip.tsx +179 -0
  481. package/src/Text/textClampContext.ts +5 -1
  482. package/src/TimeInput/TimeInput.tsx +4 -0
  483. package/src/ToggleButton/ToggleButtonGroup.tsx +6 -2
  484. package/src/Token/TokenNamingContext.ts +6 -2
  485. package/src/Tokenizer/TokenizerClearAllMessageContext.ts +4 -4
  486. package/src/Tokenizer/TokenizerItemRemovableContext.ts +3 -3
  487. package/src/Toolbar/Toolbar.tsx +16 -9
  488. package/src/Tooltip/tooltipPresentInterest.ts +43 -0
  489. package/src/Tooltip/useTooltip.tsx +33 -0
  490. package/src/TopNav/TopNavContext.ts +6 -2
  491. package/src/TopNav/TopNavMobileContentContext.ts +8 -3
  492. package/src/TopNav/TopNavRenderContext.ts +8 -4
  493. package/src/Typeahead/busyIndicatorLane.tsx +7 -2
  494. package/src/Typeahead/committedChoicesKey.tsx +4 -3
  495. package/src/Typeahead/trailingKeyDown.tsx +7 -2
  496. package/src/gestures/GestureArena.ts +8 -1
  497. package/src/gestures/GestureRecognizer.ts +9 -0
  498. package/src/gestures/PressTracker.ts +13 -4
  499. package/src/hooks/focusableSelector.ts +29 -1
  500. package/src/hooks/longPressDetector.ts +1 -35
  501. package/src/hooks/pressGroupContext.ts +5 -1
  502. package/src/hooks/useActionGroupTracking.ts +29 -2
  503. package/src/hooks/useAnnounce.ts +8 -4
  504. package/src/hooks/useFocusTrap.ts +62 -2
  505. package/src/hooks/useListFocus.ts +34 -7
  506. package/src/hooks/usePager.ts +30 -3
  507. package/src/hooks/useScrollOverflow.ts +65 -7
  508. package/src/i18n/InternationalizationContext.ts +12 -8
  509. package/src/i18n/englishFallback.ts +7 -1
  510. package/src/i18n/firstStrongDirection.ts +69 -0
  511. package/src/i18n/generated-locales/en.generated.ts +1 -0
  512. package/src/i18n/generated-locales/pseudo.generated.ts +1 -0
  513. package/src/internal/scroll-anchoring.ts +16 -0
  514. package/src/internal/touch.ts +4 -0
  515. package/src/motion/animatedLayout.ts +44 -3
  516. package/src/motion/animator.ts +97 -9
  517. package/src/privateAttributes/itemKey.stylex.ts +25 -0
  518. package/src/privateAttributes/leaving.stylex.ts +23 -0
  519. package/src/privateAttributes/press.stylex.ts +19 -7
  520. package/src/privateAttributes/scrollAnchoring.stylex.ts +50 -0
  521. package/src/privateAttributes/travelling.stylex.ts +88 -0
  522. package/src/theme/Theme.tsx +124 -60
  523. package/src/theme/syntax/SyntaxTheme.tsx +7 -2
  524. package/src/theme/useTheme.ts +7 -8
  525. package/src/utils/calendarSystem.ts +7 -1
  526. package/src/utils/flatTree.ts +31 -4
  527. package/src/utils/inputAge.ts +66 -0
  528. package/src/utils/inputStream.ts +52 -3
  529. package/src/utils/moduleLoader.ts +47 -0
  530. package/src/utils/pressFeedback.ts +16 -7
  531. package/src/utils/selectionLock.ts +8 -18
  532. package/src/utils/sharedContext.ts +42 -0
  533. package/src/utils/sharedRealm.ts +42 -0
@@ -0,0 +1,69 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file firstStrongDirection.ts
5
+ * @input A string of text
6
+ * @output 'ltr' | 'rtl' | null — the direction of the text's first strongly
7
+ * directional character, or null when it has none
8
+ * @position Shared classifier for components that give a block of prose the
9
+ * direction of its own text (Markdown blocks). Server-safe: it reads no
10
+ * context.
11
+ */
12
+
13
+ // Each expression with a Unicode property escape is built at runtime: a
14
+ // source build may rewrite a regular expression literal with one, and the
15
+ // Babel copy that Next.js bundles has no Unicode data to do that.
16
+
17
+ /**
18
+ * The strongly right-to-left characters of the Unicode Bidirectional
19
+ * Algorithm: Bidi_Class `R` and `AL`. The living scripts are named. The two
20
+ * ranges cover the historic right-to-left scripts in the Supplementary
21
+ * Multilingual Plane, which have no script escapes that every engine knows.
22
+ */
23
+ const STRONG_RTL = new RegExp(
24
+ String.raw`[\p{Script=Adlam}\p{Script=Arabic}\p{Script=Hebrew}\p{Script=Mandaic}\p{Script=Nko}\p{Script=Samaritan}\p{Script=Syriac}\p{Script=Thaana}\u200F\u061C\u{10800}-\u{10FFF}\u{1E800}-\u{1EFFF}]`,
25
+ 'u',
26
+ );
27
+
28
+ /**
29
+ * The weak characters of the Arabic script: its digits, the number signs
30
+ * before them, and the currency and per-cent marks beside them. They are
31
+ * Bidi_Class `AN`, `EN` or `ET`, so the scan skips them. NKo and Adlam digits
32
+ * are Bidi_Class `R` and are not here.
33
+ */
34
+ const WEAK_ARABIC_NUMBER =
35
+ /[\u0600-\u0605\u0609\u060A\u0660-\u0669\u066A-\u066C\u06DD\u06F0-\u06F9\u0890\u0891\u08E2]/u;
36
+
37
+ /**
38
+ * Bidi_Class `L`: every other letter, the letter numbers (`\p{Letter}` does
39
+ * not include them), and the left-to-right mark. Digits, punctuation and
40
+ * symbols are not here, so the scan skips them.
41
+ */
42
+ const STRONG_LTR = new RegExp(String.raw`[\p{Letter}\p{Nl}\u200E]`, 'u');
43
+
44
+ /**
45
+ * Bidi_Class `NSM`: a combining mark takes the direction of its base
46
+ * character. A mark has its base letter's script, so without this check a
47
+ * leading Hebrew point would read as right-to-left.
48
+ */
49
+ const COMBINING_MARK = new RegExp(String.raw`\p{Mark}`, 'u');
50
+
51
+ /**
52
+ * Rules P2 and P3 of the Unicode Bidirectional Algorithm: the direction of
53
+ * the first strongly directional character, or null when there is none. The
54
+ * loop reads whole code points, so a surrogate pair counts as one character.
55
+ */
56
+ export function firstStrongDirection(text: string): 'ltr' | 'rtl' | null {
57
+ for (const character of text) {
58
+ if (COMBINING_MARK.test(character) || WEAK_ARABIC_NUMBER.test(character)) {
59
+ continue;
60
+ }
61
+ if (STRONG_RTL.test(character)) {
62
+ return 'rtl';
63
+ }
64
+ if (STRONG_LTR.test(character)) {
65
+ return 'ltr';
66
+ }
67
+ }
68
+ return null;
69
+ }
@@ -279,6 +279,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
279
279
  '@astryx.sideNav.heading.openMenu': '{heading}, Open menu',
280
280
  '@astryx.slider.minimumThumb': 'Minimum value',
281
281
  '@astryx.slider.maximumThumb': 'Maximum value',
282
+ '@astryx.tabBar.badgedItem': '{label}, {badge}',
282
283
  '@astryx.tabList.label': 'Tabs',
283
284
  '@astryx.table.label': 'Table',
284
285
  '@astryx.table.noData': 'No data',
@@ -286,6 +286,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
286
286
  '@astryx.sideNav.heading.openMenu': '⟦{heading}, Óþéñ ɱéñú⟧',
287
287
  '@astryx.slider.minimumThumb': '⟦Ṁíñíɱúɱ ṽàłúé⟧',
288
288
  '@astryx.slider.maximumThumb': '⟦Ṁàẋíɱúɱ ṽàłúé⟧',
289
+ '@astryx.tabBar.badgedItem': '⟦{label}, {badge}⟧',
289
290
  '@astryx.tabList.label': '⟦Ţàƀš⟧',
290
291
  '@astryx.table.label': '⟦Ţàƀłé⟧',
291
292
  '@astryx.table.noData': '⟦Ñó ðàţà⟧',
@@ -0,0 +1,16 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+ /**
3
+ * @file scroll-anchoring.ts
4
+ * @input The scroll-anchoring owner module
5
+ * @output `@astryxdesign/core/internal/scroll-anchoring`: setScrollAnchoringOff,
6
+ * re-exported by name for Lab
7
+ * @position An internal entry reserved for Astryx's own packages. It is
8
+ * undocumented, outside the public API and its compatibility promise, and
9
+ * versioned in lockstep with Core. The `@astryx/no-core-internal-import`
10
+ * lint rule allows it only in Core and Lab. Core components import the
11
+ * owner module by relative path. Named re-exports only: the writer, never
12
+ * the attribute's name.
13
+ *
14
+ * SYNC: When modified, update scripts/sync-exports.js.
15
+ */
16
+ export {setScrollAnchoringOff} from '../privateAttributes/scrollAnchoring.stylex';
@@ -113,3 +113,7 @@ export {animatorFor} from '../motion/animator';
113
113
  export {reducedMotionFade} from '../motion/reducedMotion';
114
114
  export {useTouchHitArea} from '../utils/touchHitArea';
115
115
  export {touchHitAreaStyles} from './touchHitArea.stylex';
116
+
117
+ // Lab's TabBar tracks its press with the shared action-group tracker.
118
+ export {useActionGroupTracking} from '../hooks/useActionGroupTracking';
119
+ export type {ActionGroupTrackingOptions} from '../hooks/useActionGroupTracking';
@@ -10,9 +10,10 @@
10
10
  * exports the exit hold (`holdLayoutExit`, `releaseLayoutExit`), the
11
11
  * in-place swap (`holdLayoutSwap`, `playLayoutSwap`), the edge reveal's
12
12
  * two-state form (`holdLayoutEdge`, `playLayoutEdge`), `playLayoutFrames`
13
- * and `applyLayoutChangeTransition`. It is the one module that produces the
14
- * size-change glide and the edge reveal `spec:AST-105` defines
15
- * (`architecture:react-component-runtime` INV12)
13
+ * and `applyLayoutChangeTransition`. It exports `glideOf` and the glide
14
+ * landings (`landLayoutGlide`, `landLayoutGlideSideways`) too. It is the one
15
+ * module that produces the size-change glide and the edge reveal
16
+ * `spec:AST-105` defines (`architecture:react-component-runtime` INV12)
16
17
  * @position Motion foundation, internal to core. A handle comes from the
17
18
  * public `useAnimatedLayout` hook; a component that takes it reports its
18
19
  * size changes through this module.
@@ -3636,6 +3637,46 @@ export function landLayoutGlide(element: Element): void {
3636
3637
  }
3637
3638
  }
3638
3639
 
3640
+ /**
3641
+ * Lands the sideways part of `element`'s running glide at once and keeps its
3642
+ * vertical move. It changes the glide's frames, and what a later change
3643
+ * carries from it, together. It is for an adopter that moves the element's
3644
+ * own sideways translation onto its children between the two reads. A list
3645
+ * row that a swipe left open is one.
3646
+ */
3647
+ export function landLayoutGlideSideways(element: Element): void {
3648
+ const glide = glides.get(element);
3649
+ const effect = glide?.animation.effect as KeyframeEffect | null | undefined;
3650
+ if (
3651
+ glide == null ||
3652
+ effect == null ||
3653
+ typeof effect.setKeyframes !== 'function'
3654
+ ) {
3655
+ return;
3656
+ }
3657
+ effect.setKeyframes(
3658
+ effect.getKeyframes().map(({computedOffset: _, translate, ...frame}) => {
3659
+ const [, y = '0px'] = String(translate ?? '').split(/\s+/);
3660
+ return {...frame, translate: `0px ${y}`};
3661
+ }),
3662
+ );
3663
+ const vertical: Glide = {
3664
+ animation: glide.animation,
3665
+ offsetAt: t => ({x: 0, y: glide.offsetAt(t).y}),
3666
+ get durationMs() {
3667
+ return glide.durationMs;
3668
+ },
3669
+ shownBefore: {x: 0, y: glide.shownBefore.y},
3670
+ scale: glide.scale,
3671
+ };
3672
+ glides.set(element, vertical);
3673
+ glide.animation.addEventListener?.('finish', () => {
3674
+ if (glides.get(element) === vertical) {
3675
+ glides.delete(element);
3676
+ }
3677
+ });
3678
+ }
3679
+
3639
3680
  /**
3640
3681
  * @internal The motion a change in `area` plays, for tests and for SideNav's
3641
3682
  * rail motion, which plays on the same clock (`component:SideNav` FR6).
@@ -223,6 +223,23 @@ export interface SpringTransition {
223
223
  velocity?: MotionValues;
224
224
  }
225
225
 
226
+ /** What `Animator.rebase` takes besides the amounts. */
227
+ export interface RebaseOptions {
228
+ /** Time of the shift on the document timeline (ms). Defaults to now. */
229
+ at?: number;
230
+ /**
231
+ * Per property, the value its spring heads for after the shift. A spring
232
+ * whose target plus its amount lands there moves whole, before its first
233
+ * frame and once its start is known. Its curve and target move by the
234
+ * amount. It keeps its start time and velocity, as when the element's
235
+ * resting place moves under a curve that keeps going. If its first frame
236
+ * has run while its start is unread, only the model moves. The next call
237
+ * on the channel in the same task rebuilds its animation, or else the end
238
+ * of the task does.
239
+ */
240
+ towards?: MotionValues;
241
+ }
242
+
226
243
  /**
227
244
  * Options of `animate` and `play`: the spring, a release velocity, the Reduced
228
245
  * Motion handling.
@@ -452,9 +469,10 @@ export interface Animator {
452
469
  * moves the element under them: a property moving on a spring keeps its
453
470
  * spring, velocity and target (the curve restarts from the shifted value);
454
471
  * any other moving curve shifts whole, its end included; a resting
455
- * property takes the offset and stays.
472
+ * property takes the offset and stays. `towards` moves some springs whole
473
+ * instead (RebaseOptions).
456
474
  */
457
- rebase(deltas: MotionValues, options?: Pick<AnimateOptions, 'at'>): void;
475
+ rebase(deltas: MotionValues, options?: RebaseOptions): void;
458
476
  /** Freezes properties (all by default) at their presentation values. */
459
477
  stop(properties?: ReadonlyArray<MotionProperty | 'scale'>): void;
460
478
  /**
@@ -676,6 +694,13 @@ const REST_FRAMES_PER_SECOND = 60;
676
694
  /** A curve that has not settled by then (an undamped spring) snaps. */
677
695
  const MAX_DURATION_MS = 30_000;
678
696
 
697
+ /**
698
+ * How close a spring's target and a value must be to count as the same, in
699
+ * the property's own units. Only float rounding separates two ways of
700
+ * computing one value, far below anything the screen shows.
701
+ */
702
+ const SAME_VALUE = 1e-6;
703
+
679
704
  /**
680
705
  * The task calls from rest are made in, shared by every call made in it
681
706
  * (every animator's), so one motion's parts that are separate calls start
@@ -1371,7 +1396,43 @@ export function createMotionEngine(
1371
1396
  running.set(channel, animation);
1372
1397
  };
1373
1398
 
1399
+ const replaceIn = (group: StartGroup, segment: Segment, next: Segment) => {
1400
+ const index = group.segments.indexOf(segment);
1401
+ if (index >= 0) {
1402
+ group.segments[index] = next;
1403
+ } else {
1404
+ group.segments.push(next);
1405
+ }
1406
+ };
1407
+
1408
+ /**
1409
+ * Channels whose model a rebase moved while their animation still shows
1410
+ * the old curve. Any rebuild clears its channel; the end of the task
1411
+ * rebuilds the rest, so a frame never shows the old curve at the new rest.
1412
+ */
1413
+ const stale = new Set<Channel>();
1414
+ let healQueued = false;
1415
+
1416
+ const markStale = (channel: Channel) => {
1417
+ stale.add(channel);
1418
+ if (!healQueued) {
1419
+ healQueued = true;
1420
+ queueMicrotask(healStale);
1421
+ }
1422
+ };
1423
+
1424
+ const healStale = () => {
1425
+ healQueued = false;
1426
+ if (stale.size === 0) {
1427
+ return;
1428
+ }
1429
+ const properties = [...stale].flatMap(channel => CHANNELS[channel]);
1430
+ stale.clear();
1431
+ commit(properties, now());
1432
+ };
1433
+
1374
1434
  const rebuild = (channel: Channel, time: number) => {
1435
+ stale.delete(channel);
1375
1436
  const previous = running.get(channel);
1376
1437
  running.delete(channel);
1377
1438
  clearTimeout(retireTimers.get(channel));
@@ -3869,6 +3930,7 @@ export function createMotionEngine(
3869
3930
  syncPending();
3870
3931
  flushDeferred();
3871
3932
  const time = rebaseOptions.at ?? now();
3933
+ const towards = expand(rebaseOptions.towards ?? {});
3872
3934
  const changed: MotionProperty[] = [];
3873
3935
  const owners = new Set<HandleState>();
3874
3936
  for (const [property, delta] of Object.entries(expand(deltas)) as [
@@ -3878,9 +3940,9 @@ export function createMotionEngine(
3878
3940
  if (delta === 0) {
3879
3941
  continue;
3880
3942
  }
3881
- changed.push(property);
3882
3943
  const segment = segmentAt(property, time);
3883
3944
  if (segment == null) {
3945
+ changed.push(property);
3884
3946
  resting[property] = valueAt(property, time) + delta;
3885
3947
  segments.delete(property);
3886
3948
  continue;
@@ -3896,15 +3958,40 @@ export function createMotionEngine(
3896
3958
  : undefined;
3897
3959
  const replace = (next: Segment) => {
3898
3960
  if (group != null) {
3899
- const index = group.segments.indexOf(segment);
3900
- if (index >= 0) {
3901
- group.segments[index] = next;
3902
- } else {
3903
- group.segments.push(next);
3904
- }
3961
+ replaceIn(group, segment, next);
3905
3962
  }
3906
3963
  segments.set(property, next);
3907
3964
  };
3965
+ const heading = towards[property];
3966
+ if (
3967
+ segment.spring != null &&
3968
+ heading != null &&
3969
+ Math.abs(segment.target + delta - heading) <= SAME_VALUE
3970
+ ) {
3971
+ // The spring keeps its course to the shifted target from its own
3972
+ // start.
3973
+ const whole: Segment = {
3974
+ ...segment,
3975
+ target: heading,
3976
+ at: t => segment.at(t) + delta,
3977
+ };
3978
+ if (latest == null) {
3979
+ changed.push(property);
3980
+ replace(whole);
3981
+ continue;
3982
+ }
3983
+ // While the browser has not told the start, only the model moves.
3984
+ // The call that follows rebuilds the channel from it, or else the
3985
+ // end of the task does.
3986
+ const waiting = segment.group;
3987
+ if (waiting != null && !waiting.resolved) {
3988
+ replaceIn(waiting, segment, whole);
3989
+ segments.set(property, whole);
3990
+ markStale(CHANNEL_OF[property]);
3991
+ continue;
3992
+ }
3993
+ }
3994
+ changed.push(property);
3908
3995
  if (segment.spring != null) {
3909
3996
  const from = valueAt(property, time) + delta;
3910
3997
  const velocity = velocityAt(property, time);
@@ -4023,6 +4110,7 @@ export function createMotionEngine(
4023
4110
  animation.cancel();
4024
4111
  }
4025
4112
  running.clear();
4113
+ stale.clear();
4026
4114
  for (const timer of retireTimers.values()) {
4027
4115
  clearTimeout(timer);
4028
4116
  }
@@ -0,0 +1,25 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file privateAttributes/itemKey.stylex.ts
5
+ * @input A List row's own `itemKey`
6
+ * @output itemKeyProps, which marks a row with its key, and itemKeyOf, which
7
+ * reads it
8
+ * @position Owner module of the private item-key attribute: the only file
9
+ * that writes its name. ListItem marks its row, and List/listLayoutUpdates.ts
10
+ * matches rows by it across renders. No package entry exports it.
11
+ */
12
+
13
+ const ITEM_KEY = 'data-astryx-item-key';
14
+
15
+ /** Spread on a List row: marks it with its `itemKey`, when it has one. */
16
+ export function itemKeyProps(
17
+ itemKey: string | number | undefined,
18
+ ): Readonly<Record<string, string>> {
19
+ return itemKey == null ? {} : {[ITEM_KEY]: String(itemKey)};
20
+ }
21
+
22
+ /** The item key a row carries, or null for a row without one. */
23
+ export function itemKeyOf(row: Element): string | null {
24
+ return row.getAttribute(ITEM_KEY);
25
+ }
@@ -0,0 +1,23 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file privateAttributes/leaving.stylex.ts
5
+ * @input A List row put back in the document for its exit
6
+ * @output markLeaving, which marks such a row, and isLeaving, which reads the
7
+ * mark
8
+ * @position Owner module of the private leaving attribute: the only file that
9
+ * writes its name. List/listLayoutUpdates.ts marks a row it puts back, so no
10
+ * later commit counts it as a row. No package entry exports it.
11
+ */
12
+
13
+ const LEAVING = 'data-astryx-leaving';
14
+
15
+ /** Marks `row` as put back for its exit: it is not a row any more. */
16
+ export function markLeaving(row: Element): void {
17
+ row.setAttribute(LEAVING, '');
18
+ }
19
+
20
+ /** Whether `row` was put back for its exit. */
21
+ export function isLeaving(row: Element): boolean {
22
+ return row.hasAttribute(LEAVING);
23
+ }
@@ -81,8 +81,19 @@ const RELEASE_EASE = easeVars['--ease-exit'];
81
81
  const DIVIDER_WIDTH = borderVars['--border-width'];
82
82
  /** How far a highlighted row's tint reaches past its edge: one divider. */
83
83
  const PAST_DIVIDER = `calc(-1 * ${DIVIDER_WIDTH})`;
84
- /** A tint one divider tall, just above the row: over the row before's divider. */
85
- const tintAbove = (tint: string) => `0 ${PAST_DIVIDER} 0 0 ${tint}`;
84
+ /**
85
+ * The surface a travelling List row rides on (travelling.stylex.ts sets it).
86
+ * A row of a List with dividers adds it to its own shadows.
87
+ */
88
+ const TRAVELLING_SURFACE = 'var(--_travelling-surface, none)';
89
+ /** The same surface as one shadow in a list of them. */
90
+ const TRAVELLING_SURFACE_LAYER = 'var(--_travelling-surface, 0 0 transparent)';
91
+ /**
92
+ * A tint one divider tall, just above the row: over the row before's divider.
93
+ * A travelling row keeps its surface under the tint.
94
+ */
95
+ const tintAbove = (tint: string) =>
96
+ `0 ${PAST_DIVIDER} 0 0 ${tint}, ${TRAVELLING_SURFACE_LAYER}`;
86
97
 
87
98
  export const rowPressLayerStyles = stylex.create({
88
99
  /**
@@ -213,18 +224,19 @@ export const rowPressLayerStyles = stylex.create({
213
224
  * tint. The tint also covers the divider above it, as a shadow, under a
214
225
  * mouse or a finger. Under a coarse pointer, the press layer covers both
215
226
  * dividers, so they fade with it on the release. The tint is translucent,
216
- * so a divider under it reads as it does at rest.
227
+ * so a divider under it reads as it does at rest. Each shadow here keeps a
228
+ * travelling row's surface, which this shadow replaces otherwise.
217
229
  */
218
230
  overDividers: {
219
231
  boxShadow: {
220
- default: null,
232
+ default: TRAVELLING_SURFACE,
221
233
  [ENABLED]: {
222
234
  default: null,
223
235
  ':not(:first-child)': {
224
236
  default: null,
225
237
  ':active': {
226
238
  default: tintAbove(colorVars['--color-overlay-pressed']),
227
- [COARSE]: 'none',
239
+ [COARSE]: TRAVELLING_SURFACE,
228
240
  },
229
241
  [HOVER_HOVER]: {
230
242
  default: null,
@@ -236,11 +248,11 @@ export const rowPressLayerStyles = stylex.create({
236
248
  // row's own press paint, which follows the release's strength.
237
249
  [PRESSED_ON]: {
238
250
  default: tintAbove('var(--_press-paint)'),
239
- [COARSE]: 'none',
251
+ [COARSE]: TRAVELLING_SURFACE,
240
252
  },
241
253
  [PRESSED_FADING]: {
242
254
  default: tintAbove('var(--_press-paint)'),
243
- [COARSE]: 'none',
255
+ [COARSE]: TRAVELLING_SURFACE,
244
256
  },
245
257
  },
246
258
  },
@@ -0,0 +1,50 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file privateAttributes/scrollAnchoring.stylex.ts
5
+ * @input A scroll container whose position a component owns
6
+ * @output setScrollAnchoringOff, which turns the browser's scroll anchoring
7
+ * off on an element and back on
8
+ * @position Owner module of the private scroll-anchoring attribute: the only
9
+ * file that writes its name or its rule. Core's useChatStreamScroll calls
10
+ * it while it follows the end; Lab reaches the writer through
11
+ * `@astryxdesign/core/internal/scroll-anchoring`. No public entry exports
12
+ * it.
13
+ */
14
+
15
+ const SCROLL_ANCHORING = 'data-astryx-scroll-anchoring';
16
+ /** On a scroll container: the browser's anchoring is off there. */
17
+ const OFF = 'off';
18
+ /** On the one `<style>` element that holds the rule. */
19
+ const RULE = 'rule';
20
+
21
+ /**
22
+ * Add the one rule the attribute switches on, once per document. A rule on
23
+ * an attribute, not the element's inline style, so the caller's own
24
+ * `overflow-anchor` is never read, written or restored, and applies again
25
+ * once the attribute is gone. `!important` so an inline `auto` cannot turn
26
+ * anchoring back on under a component that positions the content itself.
27
+ */
28
+ function ensureRule(doc: Document): void {
29
+ if (doc.head.querySelector(`[${SCROLL_ANCHORING}="${RULE}"]`) != null) {
30
+ return;
31
+ }
32
+ const style = doc.createElement('style');
33
+ style.setAttribute(SCROLL_ANCHORING, RULE);
34
+ style.textContent = `[${SCROLL_ANCHORING}="${OFF}"]{overflow-anchor:none !important}`;
35
+ doc.head.appendChild(style);
36
+ }
37
+
38
+ /**
39
+ * Turn the browser's scroll anchoring off on `element` (`on`), or hand it
40
+ * back (`!on`). A component calls this while it alone moves the container's
41
+ * position, so native anchoring does not move it a second time.
42
+ */
43
+ export function setScrollAnchoringOff(element: Element, on: boolean): void {
44
+ if (on) {
45
+ ensureRule(element.ownerDocument);
46
+ element.setAttribute(SCROLL_ANCHORING, OFF);
47
+ } else {
48
+ element.removeAttribute(SCROLL_ANCHORING);
49
+ }
50
+ }
@@ -0,0 +1,88 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file privateAttributes/travelling.stylex.ts
5
+ * @input StyleX and the surface color token
6
+ * @output `travellingStyles` for a List row that slides across other rows,
7
+ * and markTravelling, which marks the row for the length of its slide
8
+ * @position Owner module of the private travelling attribute: the only file
9
+ * that writes its name. List/listLayoutUpdates.ts marks a row, and ListItem
10
+ * composes the styles. No package entry exports it.
11
+ */
12
+
13
+ import * as stylex from '@stylexjs/stylex';
14
+ import {colorVars} from '../theme/tokens.stylex';
15
+
16
+ const TRAVELLING = 'data-astryx-travelling';
17
+
18
+ /**
19
+ * Each row's latest mark, so the end of an earlier slide leaves a later
20
+ * mark in place.
21
+ */
22
+ const marks = new WeakMap<Element, object>();
23
+
24
+ /**
25
+ * Marks `row` as sliding across rows that move the other way. Returns the
26
+ * call that removes the mark when the slide ends. A later mark on the row
27
+ * stays when that call runs.
28
+ */
29
+ export function markTravelling(row: Element): () => void {
30
+ const mark = {};
31
+ marks.set(row, mark);
32
+ row.setAttribute(TRAVELLING, '');
33
+ return () => {
34
+ if (marks.get(row) === mark) {
35
+ marks.delete(row);
36
+ row.removeAttribute(TRAVELLING);
37
+ }
38
+ };
39
+ }
40
+
41
+ export const travellingStyles = stylex.create({
42
+ // A row that slides across rows moving the other way rides above them, with
43
+ // the surface behind it, for the length of its slide. A UIKit cell passes
44
+ // its neighbors opaque and on top, and these rows have no background of
45
+ // their own. The surface is an inset shadow across the padding box, under
46
+ // the press and the row's content, so the divider and the press stay
47
+ // visible. A selected row keeps its own fill. It takes no pseudo-element,
48
+ // since under a finger the row's `::after` is its hit layer. Its z-index, 2,
49
+ // is above a swipeable row's raise under a finger (1), so it rides above
50
+ // the swipeable rows it crosses.
51
+ row: {
52
+ zIndex: {
53
+ default: null,
54
+ '[data-astryx-travelling]': 2,
55
+ },
56
+ boxShadow: {
57
+ default: null,
58
+ '[data-astryx-travelling]:not([aria-selected="true"],[aria-current="true"])': `inset 0 0 0 100vmax ${colorVars['--color-background-surface']}`,
59
+ },
60
+ // A row of a List with dividers takes its shadow from the press layer's
61
+ // `overDividers`, composed later, which wins over the one above. So the
62
+ // surface is also a custom property, which `overDividers` adds to its own
63
+ // shadows. Every other row resets it, so a row inside a travelling row
64
+ // does not inherit it.
65
+ '--_travelling-surface': {
66
+ default: null,
67
+ '[data-astryx-travelling]:not([aria-selected="true"],[aria-current="true"])': `inset 0 0 0 100vmax ${colorVars['--color-background-surface']}`,
68
+ ':not([data-astryx-travelling]:not([aria-selected="true"],[aria-current="true"]))':
69
+ 'initial',
70
+ },
71
+ },
72
+ // A swipeable row is a stacking context at rest, since Item translates its
73
+ // swipe root. So its band's own z-index orders only inside it. Under a
74
+ // finger the row itself rises above the rows after it, whose boxes its band
75
+ // reaches into. The list isolates, so the row stays below a sticky header.
76
+ // StyleX keeps one zIndex per element, so this style also carries the
77
+ // travelling raise. Compose it after `row`.
78
+ raisedSwipeRow: {
79
+ zIndex: {
80
+ default: null,
81
+ '[data-astryx-travelling]': 2,
82
+ '@media (pointer: coarse)': {
83
+ default: 1,
84
+ '[data-astryx-travelling]': 2,
85
+ },
86
+ },
87
+ },
88
+ });