@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
@@ -6,7 +6,8 @@
6
6
  * @file useTouchTrigger.ts
7
7
  * @input Touch trigger mode, layer open state, trigger ref, show/hide callbacks
8
8
  * @output Exports useTouchTrigger hook, isActionTrigger, LayerTouchTrigger type,
9
- * tapLandsOnDisabledControl, TOUCH_POINTER_TYPES and useTapStop (internal:
9
+ * tapLandsOnDisabledControl, TOUCH_POINTER_TYPES, useTapRecognizer and
10
+ * useTapStop (internal:
10
11
  * not re-exported from index). Also useTouchTriggerInternal, with the
11
12
  * outside dismissal's arm for useTooltip's hold (Core-internal).
12
13
  * @position Layer hook; shared touch behavior for useTooltip and useHoverCard
@@ -48,6 +49,7 @@ import {
48
49
  useCallback,
49
50
  useEffect,
50
51
  useRef,
52
+ useState,
51
53
  type MouseEvent as ReactMouseEvent,
52
54
  type PointerEvent as ReactPointerEvent,
53
55
  type RefObject,
@@ -80,6 +82,72 @@ export type LayerTouchTrigger = 'auto' | 'tap' | 'none';
80
82
  */
81
83
  export const TOUCH_POINTER_TYPES = new Set(['touch', 'pen']);
82
84
 
85
+ /** Waits for the tap that a touch or pen press may become. Internal. */
86
+ export interface TapRecognizer {
87
+ /**
88
+ * Call on every press. A touch or pen press on `trigger` waits for its tap:
89
+ * the press's own `click`. A touch the browser takes for a scroll or a
90
+ * pinch (`pointercancel`) is no tap, and a new press replaces one still
91
+ * waiting. Returns whether the press is touch or pen.
92
+ */
93
+ press(
94
+ event: PointerEvent,
95
+ trigger: Element | null,
96
+ onTap: (tapEvent: Event) => void,
97
+ ): boolean;
98
+ /** Stops waiting for a press still waiting for its tap. */
99
+ forget(): void;
100
+ }
101
+
102
+ /** One tap recognizer for a trigger, released on unmount. Internal. */
103
+ export function useTapRecognizer(): TapRecognizer {
104
+ const [recognizer] = useState(createTapRecognizer);
105
+ // Releases a pending tap on unmount.
106
+ useEffect(() => () => recognizer.forget(), [recognizer]);
107
+ return recognizer;
108
+ }
109
+
110
+ function createTapRecognizer(): TapRecognizer {
111
+ let stopWaiting: (() => void) | null = null;
112
+ const forget = () => {
113
+ stopWaiting?.();
114
+ stopWaiting = null;
115
+ };
116
+ return {
117
+ press(event, trigger, onTap) {
118
+ forget();
119
+ if (!TOUCH_POINTER_TYPES.has(event.pointerType)) {
120
+ return false;
121
+ }
122
+ if (trigger == null) {
123
+ return true;
124
+ }
125
+ // The tap must belong to this press. A key press or a new pointer press
126
+ // advances the gesture, so a keyboard activation that later fires
127
+ // `click` on the trigger (Enter on a button) is not mistaken for it.
128
+ const gesture = currentGesture();
129
+ const stop = () => {
130
+ trigger.removeEventListener('click', handleTap);
131
+ trigger.removeEventListener('pointercancel', stop);
132
+ if (stopWaiting === stop) {
133
+ stopWaiting = null;
134
+ }
135
+ };
136
+ const handleTap = (tapEvent: Event) => {
137
+ stop();
138
+ if (currentGesture() === gesture) {
139
+ onTap(tapEvent);
140
+ }
141
+ };
142
+ trigger.addEventListener('click', handleTap);
143
+ trigger.addEventListener('pointercancel', stop);
144
+ stopWaiting = stop;
145
+ return true;
146
+ },
147
+ forget,
148
+ };
149
+ }
150
+
83
151
  export function useTapStop(event: 'click'): {
84
152
  onPointerDown: (event: ReactPointerEvent<Element>) => void;
85
153
  onClick: (event: ReactMouseEvent<Element>) => void;
@@ -296,6 +364,11 @@ export interface UseTouchTriggerInternalReturn extends UseTouchTriggerReturn {
296
364
  * hold arms it too.
297
365
  */
298
366
  armOutsideDismiss: () => void;
367
+ /**
368
+ * Answers a tap the trigger completed before the layer mounted, by the same
369
+ * rules as a tap it sees, and arms the outside dismissal when it opens.
370
+ */
371
+ answerTap: (tapEvent: Event | null) => void;
299
372
  }
300
373
 
301
374
  /**
@@ -379,9 +452,7 @@ export function useTouchTriggerInternal(
379
452
  // The documents the outside dismissal listens on: the page's, and the
380
453
  // trigger's own when it renders in another document, such as an iframe.
381
454
  const outsideDocumentsRef = useRef<Document[]>([]);
382
- // A touch press on the trigger still waiting for its tap: calling it stops
383
- // waiting. The next press, a cancel, the tap itself or unmounting calls it.
384
- const forgetPendingTapRef = useRef<(() => void) | null>(null);
455
+ const tapRecognizer = useTapRecognizer();
385
456
 
386
457
  const readModality = useInteractionModalityTrackingFor(triggerRef);
387
458
 
@@ -453,9 +524,6 @@ export function useTouchTriggerInternal(
453
524
 
454
525
  // Releases the outside-dismiss listener on unmount.
455
526
  useEffect(() => disarmOutsideDismiss, [disarmOutsideDismiss]);
456
- // Releases a pending tap on unmount.
457
- useEffect(() => () => forgetPendingTapRef.current?.(), []);
458
-
459
527
  const isTouchInteraction = useCallback(
460
528
  () => isTouchPointerRef.current && readModality() === 'pointer',
461
529
  [readModality],
@@ -471,12 +539,12 @@ export function useTouchTriggerInternal(
471
539
 
472
540
  // What a tap on the trigger does. It runs from the tap's `click`, after the
473
541
  // render that armed it, so it reads the latest props through this ref.
474
- const answerTapRef = useRef<(tapEvent: Event) => void>(() => {});
475
- answerTapRef.current = (tapEvent: Event) => {
542
+ const answerTapRef = useRef<(tapEvent: Event | null) => void>(() => {});
543
+ answerTapRef.current = (tapEvent: Event | null) => {
476
544
  const trigger = triggerRef.current;
477
545
  // A tap that landed in a disabled control is that control's: its reason
478
546
  // opens. Every other tap is the trigger's to decide.
479
- const tapped = tapEvent.target instanceof Element ? tapEvent.target : null;
547
+ const tapped = tapEvent?.target instanceof Element ? tapEvent.target : null;
480
548
  const mode =
481
549
  touchTrigger === 'auto'
482
550
  ? tapped != null && tapLandsOnDisabledControl(tapped)
@@ -509,45 +577,20 @@ export function useTouchTriggerInternal(
509
577
  (event: PointerEvent): boolean => {
510
578
  const isTouch = TOUCH_POINTER_TYPES.has(event.pointerType);
511
579
  isTouchPointerRef.current = isTouch;
512
- // A new press replaces one that never became a tap.
513
- forgetPendingTapRef.current?.();
514
-
515
580
  if (!isTouch || isControlled) {
581
+ tapRecognizer.forget();
516
582
  return false;
517
583
  }
518
-
519
584
  const trigger =
520
585
  event.currentTarget instanceof Element
521
586
  ? event.currentTarget
522
587
  : triggerRef.current;
523
- if (trigger == null) {
524
- return true;
525
- }
526
-
527
- // The tap must belong to this press. A key press or a new pointer press
528
- // advances the gesture, so a keyboard activation that later fires
529
- // `click` on the trigger (Enter on a button) is not mistaken for it.
530
- const gesture = currentGesture();
531
- const forget = () => {
532
- trigger.removeEventListener('click', handleTap);
533
- trigger.removeEventListener('pointercancel', forget);
534
- if (forgetPendingTapRef.current === forget) {
535
- forgetPendingTapRef.current = null;
536
- }
537
- };
538
- const handleTap = (tapEvent: Event) => {
539
- forget();
540
- if (currentGesture() === gesture) {
541
- answerTapRef.current(tapEvent);
542
- }
543
- };
544
- trigger.addEventListener('click', handleTap);
545
- // The browser took the touch for a scroll or a pinch: no tap is coming.
546
- trigger.addEventListener('pointercancel', forget);
547
- forgetPendingTapRef.current = forget;
588
+ tapRecognizer.press(event, trigger, tapEvent =>
589
+ answerTapRef.current(tapEvent),
590
+ );
548
591
  return true;
549
592
  },
550
- [isControlled, triggerRef],
593
+ [isControlled, triggerRef, tapRecognizer],
551
594
  );
552
595
 
553
596
  // A layer closed by any other path (Escape, a consumer, the browser) leaves
@@ -563,6 +606,11 @@ export function useTouchTriggerInternal(
563
606
  wasOpenRef.current = isOpen;
564
607
  }, [isOpen, disarmOutsideDismiss]);
565
608
 
609
+ const answerTap = useCallback(
610
+ (tapEvent: Event | null) => answerTapRef.current(tapEvent),
611
+ [],
612
+ );
613
+
566
614
  return {
567
615
  isTouchPointerRef,
568
616
  isTouchInteraction,
@@ -570,5 +618,6 @@ export function useTouchTriggerInternal(
570
618
  handlePointerDown,
571
619
  clearTapOpen: disarmOutsideDismiss,
572
620
  armOutsideDismiss,
621
+ answerTap,
573
622
  };
574
623
  }
@@ -144,6 +144,17 @@ export const docs = {
144
144
  description:
145
145
  "Padding at the layout's outer edges using the spacing scale. Applies to this Layout's own header, footer, panels, and content. A nested Layout does not inherit it: without `padding`, its regions use the enclosing Card, Section, or Dialog padding, or the default inset (spacing 4). That keeps a page Layout inside AppShell inset even though AppShell's own regions are full bleed.",
146
146
  },
147
+ {
148
+ name: 'children',
149
+ type: 'ReactNode',
150
+ description:
151
+ 'Shorthand for the content slot: `<Layout>{main}</Layout>` is the same as `<Layout content={main} />`. When both are given, `content` wins.',
152
+ },
153
+ {
154
+ name: 'ref',
155
+ type: 'React.Ref<HTMLDivElement>',
156
+ description: 'Ref forwarded to the root layout element.',
157
+ },
147
158
  {
148
159
  name: 'defaultHasDividers',
149
160
  type: 'boolean',
@@ -165,6 +176,8 @@ export const docs = {
165
176
  bestPractices: [
166
177
  { guidance: true, description: 'Use Layout when content needs named header, start, content, end, or footer regions.' },
167
178
  { guidance: true, description: 'Use HStack and VStack for simple directional stacking within a content area.' },
179
+ { guidance: true, description: 'Hide a region by passing `false`, `null`, or `undefined` to its slot, for example `isOpen && <LayoutPanel />`. The slot counts as empty, so the neighbouring regions move out to the layout edge.' },
180
+ { guidance: true, description: 'Give a region a landmark role and label on the region component when it is a page landmark, for example `<LayoutPanel role="navigation" label="Sections">`. Layout adds no role or name.' },
168
181
  { guidance: false, description: 'Use Layout for simple stacking layouts; use HStack or VStack instead.' },
169
182
  { guidance: false, description: 'Use Layout as the page shell or for app-wide navigation; use AppShell for that responsibility.' },
170
183
  ],
@@ -230,6 +243,8 @@ export const docsZh = {
230
243
  bestPractices: [
231
244
  { guidance: true, description: 'Use Layout when content needs named header, start, content, end, or footer regions.' },
232
245
  { guidance: true, description: 'Use HStack and VStack for simple directional stacking within a content area.' },
246
+ { guidance: true, description: 'Hide a region by passing `false`, `null`, or `undefined` to its slot, for example `isOpen && <LayoutPanel />`. The slot counts as empty, so the neighbouring regions move out to the layout edge.' },
247
+ { guidance: true, description: 'Give a region a landmark role and label on the region component when it is a page landmark, for example `<LayoutPanel role="navigation" label="Sections">`. Layout adds no role or name.' },
233
248
  { guidance: false, description: 'Use Layout for simple stacking layouts; use HStack or VStack instead.' },
234
249
  { guidance: false, description: 'Use Layout as the page shell or for app-wide navigation; use AppShell for that responsibility.' },
235
250
  ],
@@ -246,6 +261,8 @@ export const docsDense = {
246
261
  bestPractices: [
247
262
  { guidance: true, description: 'Use Layout when content needs named header, start, content, end, or footer regions.' },
248
263
  { guidance: true, description: 'Use HStack and VStack for simple directional stacking within a content area.' },
264
+ { guidance: true, description: 'Hide a region by passing `false`, `null`, or `undefined` to its slot, for example `isOpen && <LayoutPanel />`. The slot counts as empty, so the neighbouring regions move out to the layout edge.' },
265
+ { guidance: true, description: 'Give a region a landmark role and label on the region component when it is a page landmark, for example `<LayoutPanel role="navigation" label="Sections">`. Layout adds no role or name.' },
249
266
  { guidance: false, description: 'Use Layout for simple stacking layouts; use HStack or VStack instead.' },
250
267
  { guidance: false, description: 'Use Layout as the page shell or for app-wide navigation; use AppShell for that responsibility.' },
251
268
  ],
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * @file Layout.tsx
7
- * @input Uses React, stack/stackItem utilities, LayoutAreaContext, LayoutSlotsContext
7
+ * @input Uses React, stack/stackItem utilities, isRenderable, LayoutAreaContext, LayoutSlotsContext
8
8
  * @output Exports Layout component and LayoutProps, LayoutHeight types
9
9
  * @position General five-slot layout primitive for arranging header, start, content, end, and footer regions.
10
10
  * Building a page area with a side panel? Use Layout with start/end slots.
@@ -25,6 +25,7 @@ import {LayoutDividerContext} from './LayoutDividerContext';
25
25
  import {stack} from '../Stack/stack.stylex';
26
26
  import {stackItem} from '../Stack/stackItem.stylex';
27
27
  import {mergeProps} from '../utils/mergeProps';
28
+ import {isRenderable} from '../utils/isRenderable';
28
29
  import {layoutFooterMarker, layoutHeaderMarker} from './layoutEdges.stylex';
29
30
  import type {BaseProps} from '../BaseProps';
30
31
  import type {SizeValue, SpacingStep} from '../utils/types';
@@ -89,6 +90,8 @@ const styles = stylex.create({
89
90
  // explicit `padding` on this Layout overrides this on the same node.
90
91
  '--layout-padding-own-outer-x': 'initial',
91
92
  '--layout-padding-own-outer-y': 'initial',
93
+ '--_layout-flush-block-start': 'initial',
94
+ '--_layout-flush-block-end': 'initial',
92
95
  },
93
96
  fill: {
94
97
  // Add 2x container block padding to compensate for negative block margins
@@ -106,9 +109,9 @@ const styles = stylex.create({
106
109
  // LayoutFooter without one right after it, removes the matching inner
107
110
  // padding of LayoutContent (it reads these, falling back to its padding).
108
111
  // Sibling relations on this row only: a `:has()` on the layout followed
109
- // by `*` restyles everything inside it on any change. Unset otherwise, so
110
- // a nested Layout's content inherits an outer row's value, as the
111
- // ancestor rule this replaces matched any enclosing layout.
112
+ // by `*` restyles everything inside it on any change. Unset otherwise:
113
+ // the inner stack clears both values, so a nested Layout does not take an
114
+ // outer row's collapse.
112
115
  '--_layout-flush-block-start': {
113
116
  default: null,
114
117
  [stylex.when.siblingBefore(':not([data-divider])', layoutHeaderMarker)]:
@@ -366,11 +369,12 @@ export function Layout({
366
369
  [defaultHasDividers],
367
370
  );
368
371
 
369
- // Memoize slots info to avoid unnecessary re-renders
370
- const hasHeader = header != null;
371
- const hasFooter = footer != null;
372
- const hasStart = start != null;
373
- const hasEnd = end != null;
372
+ // A slot that renders nothing, such as `false` from `isOpen && <LayoutHeader />`,
373
+ // is absent, so its neighbours take the outer inset on that side.
374
+ const hasHeader = isRenderable(header);
375
+ const hasFooter = isRenderable(footer);
376
+ const hasStart = isRenderable(start);
377
+ const hasEnd = isRenderable(end);
374
378
  const hasBothPanels = hasStart && hasEnd;
375
379
  const hasSinglePanel = hasStart !== hasEnd;
376
380
  const usesInternalContentWidth =
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * @file LayoutAreaContext.ts
7
- * @input Uses React createContext
7
+ * @input Uses createSharedContext
8
8
  * @output Exports LayoutAreaContext and LayoutArea type
9
9
  * @position Context for layout slot detection
10
10
  *
@@ -12,19 +12,14 @@
12
12
  * - /packages/core/src/Layout/Layout.doc.mjs
13
13
  */
14
14
 
15
- import {createContext} from 'react';
15
+ import {createSharedContext} from '../utils/sharedContext';
16
16
 
17
17
  /**
18
18
  * Layout area type representing which slot a component is rendered in.
19
19
  * Used by content area components to detect their position and adjust styling.
20
20
  */
21
21
  export type LayoutArea =
22
- | 'header'
23
- | 'footer'
24
- | 'content'
25
- | 'start'
26
- | 'end'
27
- | null;
22
+ 'header' | 'footer' | 'content' | 'start' | 'end' | null;
28
23
 
29
24
  /**
30
25
  * Context for detecting which layout area a component is rendered in.
@@ -33,5 +28,9 @@ export type LayoutArea =
33
28
  * - Apply correct semantic elements
34
29
  * - Adjust internal spacing
35
30
  */
36
- export const LayoutAreaContext = createContext<LayoutArea>(null);
31
+ export const LayoutAreaContext = createSharedContext<LayoutArea>(
32
+ 'LayoutAreaContext',
33
+ 1,
34
+ null,
35
+ );
37
36
  LayoutAreaContext.displayName = 'LayoutAreaContext';
@@ -38,6 +38,11 @@ export const docs = {
38
38
  type: 'AriaRole',
39
39
  description: 'ARIA landmark role.',
40
40
  },
41
+ {
42
+ name: 'ref',
43
+ type: 'React.Ref<HTMLDivElement>',
44
+ description: 'Ref forwarded to the content region element.',
45
+ },
41
46
  ],
42
47
  };
43
48
 
@@ -75,6 +80,11 @@ export const docsZh = {
75
80
  type: 'AriaRole',
76
81
  description: 'ARIA 地标角色。',
77
82
  },
83
+ {
84
+ name: 'ref',
85
+ type: 'React.Ref<HTMLDivElement>',
86
+ description: '转发到内容区域元素的 ref。',
87
+ },
78
88
  ],
79
89
  };
80
90
 
@@ -91,5 +101,6 @@ export const docsDense = {
91
101
  label:
92
102
  'Accessible label for landmark element; also names the region while it scrolls (default "Content").',
93
103
  role: 'ARIA landmark role.',
104
+ ref: 'Ref forwarded to the content region element.',
94
105
  },
95
106
  };
@@ -51,18 +51,18 @@ const styles = stylex.create({
51
51
  // Publish container padding vars for bleed children (Table, Divider, etc.)
52
52
  '--container-padding-inline-start': `var(--layout-padding-inner-x, ${spacingVars['--spacing-4']})`,
53
53
  '--container-padding-inline-end': `var(--layout-padding-inner-x, ${spacingVars['--spacing-4']})`,
54
- '--container-padding-block-start': `var(--layout-padding-inner-y, ${spacingVars['--spacing-4']})`,
55
- '--container-padding-block-end': `var(--layout-padding-inner-y, ${spacingVars['--spacing-4']})`,
54
+ '--container-padding-block-start': `var(--_layout-flush-block-start, var(--layout-padding-inner-y, ${spacingVars['--spacing-4']}))`,
55
+ '--container-padding-block-end': `var(--_layout-flush-block-end, var(--layout-padding-inner-y, ${spacingVars['--spacing-4']}))`,
56
56
  },
57
57
  // When no start panel: outer-x on left edge
58
58
  noStart: {
59
59
  paddingInlineStart: `var(--layout-padding-own-outer-x, var(--layout-padding-outer-x, ${spacingVars['--spacing-4']}))`,
60
60
  '--container-padding-inline-start': `var(--layout-padding-own-outer-x, var(--layout-padding-outer-x, ${spacingVars['--spacing-4']}))`,
61
- '--container-padding-inline-end': `var(--layout-padding-own-outer-x, var(--layout-padding-outer-x, ${spacingVars['--spacing-4']}))`,
62
61
  },
63
62
  // When no end panel: outer-x on right edge
64
63
  noEnd: {
65
64
  paddingInlineEnd: `var(--layout-padding-own-outer-x, var(--layout-padding-outer-x, ${spacingVars['--spacing-4']}))`,
65
+ '--container-padding-inline-end': `var(--layout-padding-own-outer-x, var(--layout-padding-outer-x, ${spacingVars['--spacing-4']}))`,
66
66
  },
67
67
  // When no header: outer-y on top
68
68
  noHeader: {
@@ -155,13 +155,13 @@ export interface LayoutContentProps extends BaseProps<HTMLDivElement> {
155
155
  *
156
156
  * @example
157
157
  * ```
158
- * <LayoutContainer variant="card">
158
+ * <Card>
159
159
  * <Layout
160
160
  * header={<LayoutHeader>Title</LayoutHeader>}
161
161
  * content={<LayoutContent>Main body content</LayoutContent>}
162
162
  * />
163
- * </LayoutContainer>
164
- * <LayoutContainer variant="card">
163
+ * </Card>
164
+ * <Card>
165
165
  * <Layout
166
166
  * content={
167
167
  * <LayoutContent padding={0}>
@@ -169,8 +169,8 @@ export interface LayoutContentProps extends BaseProps<HTMLDivElement> {
169
169
  * </LayoutContent>
170
170
  * }
171
171
  * />
172
- * </LayoutContainer>
173
- * <LayoutContainer variant="card">
172
+ * </Card>
173
+ * <Card>
174
174
  * <Layout
175
175
  * content={
176
176
  * <LayoutContent isScrollable={false}>
@@ -178,7 +178,7 @@ export interface LayoutContentProps extends BaseProps<HTMLDivElement> {
178
178
  * </LayoutContent>
179
179
  * }
180
180
  * />
181
- * </LayoutContainer>
181
+ * </Card>
182
182
  * ```
183
183
  */
184
184
  export function LayoutContent({
@@ -16,12 +16,16 @@
16
16
  * - /packages/core/src/Layout/LayoutFooter.tsx
17
17
  */
18
18
 
19
- import {createLayerScopedContext as createContext} from '../Layer/layerScopedContext';
19
+ import {createLayerScopedContext} from '../Layer/layerScopedContext';
20
20
 
21
21
  export interface LayoutDividerContextValue {
22
22
  defaultHasDividers: boolean;
23
23
  }
24
24
 
25
25
  export const LayoutDividerContext =
26
- createContext<LayoutDividerContextValue | null>(null);
26
+ createLayerScopedContext<LayoutDividerContextValue | null>(
27
+ 'LayoutDividerContext',
28
+ 1,
29
+ null,
30
+ );
27
31
  LayoutDividerContext.displayName = 'LayoutDividerContext';
@@ -13,7 +13,7 @@
13
13
  * - /packages/core/src/Layout/Layout/index.ts
14
14
  */
15
15
 
16
- import {createLayerScopedContext as createContext} from '../Layer/layerScopedContext';
16
+ import {createLayerScopedContext} from '../Layer/layerScopedContext';
17
17
 
18
18
  /**
19
19
  * Information about which layout slots are filled.
@@ -47,6 +47,9 @@ export const DEFAULT_LAYOUT_SLOTS: LayoutSlots = {
47
47
  * Content area components use this to determine if they are at an edge
48
48
  * (for applying outer padding).
49
49
  */
50
- export const LayoutSlotsContext =
51
- createContext<LayoutSlots>(DEFAULT_LAYOUT_SLOTS);
50
+ export const LayoutSlotsContext = createLayerScopedContext<LayoutSlots>(
51
+ 'LayoutSlotsContext',
52
+ 1,
53
+ DEFAULT_LAYOUT_SLOTS,
54
+ );
52
55
  LayoutSlotsContext.displayName = 'LayoutSlotsContext';
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * @file LinkContext.ts
7
- * @input React createContext, LinkComponentType
7
+ * @input createSharedContext, LinkComponentType
8
8
  * @output Exports LinkContext and LinkContextValue
9
9
  * @position Context definition for polymorphic link support
10
10
  *
@@ -19,8 +19,8 @@
19
19
  * - /packages/core/src/Link/Link.doc.mjs
20
20
  */
21
21
 
22
- import {createContext} from 'react';
23
22
  import type {LinkComponentType} from './types';
23
+ import {createSharedContext} from '../utils/sharedContext';
24
24
 
25
25
  /**
26
26
  * Context value for the link provider.
@@ -33,5 +33,9 @@ export interface LinkContextValue {
33
33
  * Context for providing a custom link component to all Astryx components.
34
34
  * Defaults to null (components fall back to native `<a>`).
35
35
  */
36
- export const LinkContext = createContext<LinkContextValue | null>(null);
36
+ export const LinkContext = createSharedContext<LinkContextValue | null>(
37
+ 'LinkContext',
38
+ 1,
39
+ null,
40
+ );
37
41
  LinkContext.displayName = 'LinkContext';
@@ -50,6 +50,11 @@ export const docs = {
50
50
  description: 'Show dividers between items.',
51
51
  default: 'false',
52
52
  },
53
+ {
54
+ name: 'animatedLayout',
55
+ type: 'AnimatedLayout',
56
+ description: 'The handle from useAnimatedLayout({containerRef}). With it, when rows are inserted, removed or reordered, an inserted row enters, a removed row collapses in place, a row that crosses rows moving the other way rides above them with the surface color behind it, and the rows after a change and the content after the list, up to that container, glide to their new places, all on one shared motion, under every pointer. Under Reduce Motion nothing travels. A row is identified by its itemKey: a row without one changes at once. Without a handle the list changes at once.',
57
+ },
53
58
  {
54
59
  name: 'edge',
55
60
  type: "'padded' | 'flush' | 'outset' | 'bleed'",
package/src/List/List.tsx CHANGED
@@ -19,7 +19,7 @@
19
19
  * - /packages/cli/assets/templates/blocks/components/List/ (showcase blocks)
20
20
  */
21
21
 
22
- import {useId, useMemo, type ReactNode} from 'react';
22
+ import {useId, useMemo, useRef, type ReactNode} from 'react';
23
23
  import * as stylex from '@stylexjs/stylex';
24
24
  import {spacingVars} from '../theme/tokens.stylex';
25
25
  import type {BaseProps} from '../BaseProps';
@@ -30,6 +30,10 @@ import {
30
30
  type ListMarkerStyle,
31
31
  } from './ListContext';
32
32
  import {mergeProps} from '../utils/mergeProps';
33
+ import {useMergedRefs} from '../hooks/useMergedRefs';
34
+ import {useListLayoutUpdates} from './listLayoutUpdates';
35
+ import {LayoutChangeSnapshot} from '../motion/LayoutChangeSnapshot';
36
+ import type {AnimatedLayout} from '../motion/animatedLayout';
33
37
  import {themeProps} from '../utils/themeProps';
34
38
  import {useDevWarning} from '../hooks/useDevWarning';
35
39
 
@@ -58,6 +62,17 @@ export interface ListProps extends BaseProps<
58
62
  */
59
63
  density?: ListDensity;
60
64
 
65
+ /**
66
+ * The handle from `useAnimatedLayout({containerRef})`. With it, the list
67
+ * animates its row changes on one shared motion, under every pointer. An
68
+ * inserted row enters, and a removed row collapses in place. A row that
69
+ * crosses rows moving the other way rides above them. The rows after a
70
+ * change, and the content after the list up to that container, glide to
71
+ * their new places. A row's identity is its `itemKey`, so a row without one
72
+ * changes at once. Without a handle the list changes at once.
73
+ */
74
+ animatedLayout?: AnimatedLayout;
75
+
61
76
  /**
62
77
  * Whether to show dividers between list items.
63
78
  * @default false
@@ -154,6 +169,12 @@ const styles = stylex.create({
154
169
  // mouse nothing rises, so the list keeps its stacking.
155
170
  isolation: {default: null, '@media (pointer: coarse)': 'isolate'},
156
171
  },
172
+ // A list under an `animatedLayout` handle isolates for every pointer. A row
173
+ // that slides across others rides above them with a mouse too, and it must
174
+ // stay below a page-level sticky header.
175
+ animatedIsolation: {
176
+ isolation: 'isolate',
177
+ },
157
178
  // Subgridded numbered rows contribute their marker's intrinsic width to
158
179
  // one column, so text and nested lists never move with an individual number.
159
180
  numberColumns: {
@@ -225,6 +246,7 @@ const dynamicStyles = stylex.create({
225
246
  */
226
247
  export function List({
227
248
  children,
249
+ animatedLayout,
228
250
  density = 'balanced',
229
251
  hasDividers = false,
230
252
  edge: edgeProp,
@@ -240,6 +262,12 @@ export function List({
240
262
  ...props
241
263
  }: ListProps) {
242
264
  const headerId = useId();
265
+ const listRef = useRef<HTMLUListElement & HTMLOListElement>(null);
266
+ const measureRows = useListLayoutUpdates(listRef, animatedLayout);
267
+ const mergedRef = useMergedRefs(
268
+ listRef,
269
+ ref as React.Ref<HTMLUListElement & HTMLOListElement>,
270
+ );
243
271
  const isOrdered = listStyle === 'decimal';
244
272
  const Tag = isOrdered ? 'ol' : 'ul';
245
273
  // Plain use of the deprecated prop is reported by its @deprecated type;
@@ -255,13 +283,19 @@ export function List({
255
283
  const reachesContainerPadding = edge === 'outset' || edge === 'bleed';
256
284
 
257
285
  const contextValue = useMemo(
258
- () => ({density, hasDividers, edge, listStyle}),
259
- [density, hasDividers, edge, listStyle],
286
+ () => ({
287
+ density,
288
+ hasDividers,
289
+ edge,
290
+ listStyle,
291
+ animatedLayout,
292
+ }),
293
+ [density, hasDividers, edge, listStyle, animatedLayout],
260
294
  );
261
295
 
262
296
  const listElement = (
263
297
  <Tag
264
- ref={ref as React.Ref<HTMLUListElement & HTMLOListElement>}
298
+ ref={mergedRef}
265
299
  // Consumer props first: everything the component sets for itself below
266
300
  // is part of its contract and wins on conflict.
267
301
  {...props}
@@ -281,6 +315,7 @@ export function List({
281
315
  themeProps('list', {density, listStyle}),
282
316
  stylex.props(
283
317
  styles.list,
318
+ animatedLayout != null && styles.animatedIsolation,
284
319
  isOrdered && styles.numberColumns,
285
320
  hasDividers && styles.withDividers,
286
321
  reachesContainerPadding && styles.reachesContainerPadding,
@@ -297,12 +332,25 @@ export function List({
297
332
  </Tag>
298
333
  );
299
334
 
335
+ // Every change of the rows is measured before it lands. LayoutChangeSnapshot
336
+ // calls this in the commit, before the DOM changes.
337
+ const snapshot =
338
+ animatedLayout != null ? (
339
+ <LayoutChangeSnapshot value={children} onBeforeChange={measureRows} />
340
+ ) : null;
341
+
300
342
  if (header == null) {
301
- return <ListContext value={contextValue}>{listElement}</ListContext>;
343
+ return (
344
+ <ListContext value={contextValue}>
345
+ {snapshot}
346
+ {listElement}
347
+ </ListContext>
348
+ );
302
349
  }
303
350
 
304
351
  return (
305
352
  <ListContext value={contextValue}>
353
+ {snapshot}
306
354
  <div {...stylex.props(styles.root)}>
307
355
  <div id={headerId} {...stylex.props(styles.header)}>
308
356
  {header}