@astryxdesign/core 0.1.4 → 0.1.5-canary.76e6697

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 (635) hide show
  1. package/CHANGELOG.md +141 -0
  2. package/dist/AlertDialog/AlertDialog.d.ts +1 -1
  3. package/dist/AlertDialog/AlertDialog.d.ts.map +1 -1
  4. package/dist/AlertDialog/AlertDialog.js +20 -18
  5. package/dist/AlertDialog/useImperativeAlertDialog.d.ts +0 -2
  6. package/dist/AlertDialog/useImperativeAlertDialog.d.ts.map +1 -1
  7. package/dist/AlertDialog/useImperativeAlertDialog.js +3 -5
  8. package/dist/AppShell/AppShell.d.ts +1 -1
  9. package/dist/AppShell/AppShell.d.ts.map +1 -1
  10. package/dist/AppShell/AppShell.js +55 -53
  11. package/dist/AspectRatio/AspectRatio.d.ts +48 -10
  12. package/dist/AspectRatio/AspectRatio.d.ts.map +1 -1
  13. package/dist/AspectRatio/AspectRatio.js +33 -12
  14. package/dist/AspectRatio/index.d.ts +1 -1
  15. package/dist/AspectRatio/index.d.ts.map +1 -1
  16. package/dist/Avatar/Avatar.d.ts.map +1 -1
  17. package/dist/Avatar/Avatar.js +28 -26
  18. package/dist/Avatar/AvatarStatusDot.js +6 -6
  19. package/dist/AvatarGroup/AvatarGroup.js +6 -6
  20. package/dist/AvatarGroup/AvatarGroupOverflow.js +7 -7
  21. package/dist/Badge/Badge.js +3 -3
  22. package/dist/Banner/Banner.d.ts.map +1 -1
  23. package/dist/Banner/Banner.js +32 -25
  24. package/dist/Blockquote/Blockquote.js +7 -7
  25. package/dist/Breadcrumbs/BreadcrumbItem.js +17 -17
  26. package/dist/Breadcrumbs/Breadcrumbs.js +7 -7
  27. package/dist/Button/Button.js +19 -19
  28. package/dist/ButtonGroup/ButtonGroup.js +7 -7
  29. package/dist/Calendar/Calendar.d.ts.map +1 -1
  30. package/dist/Calendar/Calendar.js +68 -48
  31. package/dist/Calendar/dayCellUtils.d.ts.map +1 -1
  32. package/dist/Calendar/styles.d.ts +2 -2
  33. package/dist/Calendar/styles.d.ts.map +1 -1
  34. package/dist/Calendar/styles.js +2 -2
  35. package/dist/Card/Card.d.ts +4 -2
  36. package/dist/Card/Card.d.ts.map +1 -1
  37. package/dist/Card/Card.js +18 -10
  38. package/dist/Carousel/Carousel.d.ts.map +1 -1
  39. package/dist/Carousel/Carousel.js +24 -21
  40. package/dist/Center/Center.js +3 -3
  41. package/dist/Chat/ChatComposer.js +23 -23
  42. package/dist/Chat/ChatComposerDrawer.js +14 -14
  43. package/dist/Chat/ChatComposerInput.d.ts +1 -1
  44. package/dist/Chat/ChatComposerInput.d.ts.map +1 -1
  45. package/dist/Chat/ChatComposerInput.js +27 -15
  46. package/dist/Chat/ChatDictationButton.d.ts +1 -1
  47. package/dist/Chat/ChatDictationButton.d.ts.map +1 -1
  48. package/dist/Chat/ChatDictationButton.js +13 -11
  49. package/dist/Chat/ChatLayout.js +17 -17
  50. package/dist/Chat/ChatLayoutScrollButton.d.ts +1 -1
  51. package/dist/Chat/ChatLayoutScrollButton.d.ts.map +1 -1
  52. package/dist/Chat/ChatLayoutScrollButton.js +12 -10
  53. package/dist/Chat/ChatMessage.js +12 -12
  54. package/dist/Chat/ChatMessageBubble.js +7 -7
  55. package/dist/Chat/ChatMessageList.js +14 -14
  56. package/dist/Chat/ChatMessageMetadata.d.ts +1 -1
  57. package/dist/Chat/ChatMessageMetadata.d.ts.map +1 -1
  58. package/dist/Chat/ChatMessageMetadata.js +14 -12
  59. package/dist/Chat/ChatPastedTextToken.js +13 -13
  60. package/dist/Chat/ChatSendButton.js +3 -3
  61. package/dist/Chat/ChatSystemMessage.d.ts +1 -1
  62. package/dist/Chat/ChatSystemMessage.d.ts.map +1 -1
  63. package/dist/Chat/ChatSystemMessage.js +17 -17
  64. package/dist/Chat/ChatTokenizedText.d.ts +1 -1
  65. package/dist/Chat/ChatTokenizedText.d.ts.map +1 -1
  66. package/dist/Chat/ChatTokenizedText.js +24 -15
  67. package/dist/Chat/ChatToolCalls.d.ts.map +1 -1
  68. package/dist/Chat/ChatToolCalls.js +81 -74
  69. package/dist/Chat/index.d.ts +1 -1
  70. package/dist/Chat/index.d.ts.map +1 -1
  71. package/dist/Chat/useTriggerMenu.d.ts.map +1 -1
  72. package/dist/Chat/useTriggerMenu.js +15 -15
  73. package/dist/CheckboxInput/CheckboxInput.d.ts +1 -1
  74. package/dist/CheckboxInput/CheckboxInput.d.ts.map +1 -1
  75. package/dist/CheckboxInput/CheckboxInput.js +25 -23
  76. package/dist/CheckboxList/CheckboxList.js +9 -9
  77. package/dist/CheckboxList/CheckboxListItem.d.ts +1 -1
  78. package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
  79. package/dist/CheckboxList/CheckboxListItem.js +8 -6
  80. package/dist/Citation/Citation.js +10 -10
  81. package/dist/ClickableCard/ClickableCard.d.ts.map +1 -1
  82. package/dist/ClickableCard/ClickableCard.js +32 -9
  83. package/dist/Code/Code.js +3 -3
  84. package/dist/CodeBlock/CodeBlock.d.ts +10 -1
  85. package/dist/CodeBlock/CodeBlock.d.ts.map +1 -1
  86. package/dist/CodeBlock/CodeBlock.js +88 -52
  87. package/dist/Collapsible/Collapsible.d.ts +9 -3
  88. package/dist/Collapsible/Collapsible.d.ts.map +1 -1
  89. package/dist/Collapsible/Collapsible.js +109 -22
  90. package/dist/Collapsible/CollapsibleGroup.d.ts +37 -7
  91. package/dist/Collapsible/CollapsibleGroup.d.ts.map +1 -1
  92. package/dist/Collapsible/CollapsibleGroup.js +64 -12
  93. package/dist/Collapsible/CollapsibleGroupContext.d.ts +24 -0
  94. package/dist/Collapsible/CollapsibleGroupContext.d.ts.map +1 -1
  95. package/dist/Collapsible/CollapsibleGroupContext.js +26 -3
  96. package/dist/Collapsible/index.d.ts +1 -0
  97. package/dist/Collapsible/index.d.ts.map +1 -1
  98. package/dist/Collapsible/useCollapsible.d.ts +4 -1
  99. package/dist/Collapsible/useCollapsible.d.ts.map +1 -1
  100. package/dist/Collapsible/useCollapsible.js +20 -6
  101. package/dist/CommandPalette/CommandPalette.d.ts.map +1 -1
  102. package/dist/CommandPalette/CommandPalette.js +36 -34
  103. package/dist/CommandPalette/CommandPaletteEmpty.js +3 -3
  104. package/dist/CommandPalette/CommandPaletteFooter.js +16 -16
  105. package/dist/CommandPalette/CommandPaletteGroup.js +5 -5
  106. package/dist/CommandPalette/CommandPaletteInput.js +13 -13
  107. package/dist/CommandPalette/CommandPaletteItem.js +3 -3
  108. package/dist/CommandPalette/CommandPaletteList.js +3 -3
  109. package/dist/ContextMenu/ContextMenu.d.ts +7 -2
  110. package/dist/ContextMenu/ContextMenu.d.ts.map +1 -1
  111. package/dist/ContextMenu/ContextMenu.js +76 -43
  112. package/dist/DateInput/DateInput.js +18 -18
  113. package/dist/DateRangeInput/DateRangeInput.js +21 -21
  114. package/dist/DateTimeInput/DateTimeInput.d.ts +5 -2
  115. package/dist/DateTimeInput/DateTimeInput.d.ts.map +1 -1
  116. package/dist/DateTimeInput/DateTimeInput.js +30 -26
  117. package/dist/DateTimeInput/index.d.ts +1 -1
  118. package/dist/DateTimeInput/index.d.ts.map +1 -1
  119. package/dist/Dialog/Dialog.js +9 -9
  120. package/dist/Dialog/DialogHeader.js +16 -16
  121. package/dist/Dialog/useImperativeDialog.js +3 -3
  122. package/dist/Divider/Divider.js +7 -7
  123. package/dist/DropdownMenu/DropdownMenu.js +10 -10
  124. package/dist/DropdownMenu/DropdownMenuItem.d.ts +2 -17
  125. package/dist/DropdownMenu/DropdownMenuItem.d.ts.map +1 -1
  126. package/dist/DropdownMenu/DropdownMenuItem.js +3 -3
  127. package/dist/DropdownMenu/renderDropdownItems.js +10 -10
  128. package/dist/EmptyState/EmptyState.js +9 -9
  129. package/dist/Field/Field.js +17 -17
  130. package/dist/Field/FieldLabel.js +15 -15
  131. package/dist/Field/InputClearButton.js +5 -5
  132. package/dist/FieldStatus/FieldStatus.js +3 -3
  133. package/dist/FileInput/FileInput.js +29 -29
  134. package/dist/FormLayout/FormLayout.js +5 -5
  135. package/dist/Grid/Grid.d.ts +4 -3
  136. package/dist/Grid/Grid.d.ts.map +1 -1
  137. package/dist/Grid/Grid.js +29 -12
  138. package/dist/Grid/GridSpan.js +3 -3
  139. package/dist/HStack/HStack.js +3 -3
  140. package/dist/Heading/Heading.js +10 -10
  141. package/dist/HoverCard/HoverCard.js +9 -9
  142. package/dist/HoverCard/useHoverCard.d.ts +5 -1
  143. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  144. package/dist/HoverCard/useHoverCard.js +3 -3
  145. package/dist/Icon/Icon.d.ts.map +1 -1
  146. package/dist/Icon/Icon.js +16 -12
  147. package/dist/Icon/defaultIcons.js +116 -116
  148. package/dist/IconButton/IconButton.js +3 -3
  149. package/dist/InputGroup/InputGroup.js +11 -11
  150. package/dist/InputGroup/InputGroupText.js +3 -3
  151. package/dist/Item/Item.js +18 -18
  152. package/dist/Kbd/Kbd.js +5 -5
  153. package/dist/Layer/LayerProvider.js +7 -7
  154. package/dist/Layer/useLayer.d.ts +29 -2
  155. package/dist/Layer/useLayer.d.ts.map +1 -1
  156. package/dist/Layer/useLayer.js +44 -31
  157. package/dist/Layout/Layout.js +21 -21
  158. package/dist/Layout/LayoutContent.js +3 -3
  159. package/dist/Layout/LayoutFooter.js +5 -5
  160. package/dist/Layout/LayoutHeader.js +5 -5
  161. package/dist/Layout/LayoutPanel.js +3 -3
  162. package/dist/Lightbox/Lightbox.d.ts.map +1 -1
  163. package/dist/Lightbox/Lightbox.js +55 -31
  164. package/dist/Lightbox/useLightbox.d.ts +0 -1
  165. package/dist/Lightbox/useLightbox.d.ts.map +1 -1
  166. package/dist/Lightbox/useLightbox.js +3 -4
  167. package/dist/Link/Link.d.ts +0 -2
  168. package/dist/Link/Link.d.ts.map +1 -1
  169. package/dist/Link/Link.js +15 -17
  170. package/dist/Link/LinkProvider.js +3 -3
  171. package/dist/Link/useLinkify.js +3 -3
  172. package/dist/List/List.js +11 -11
  173. package/dist/List/ListItem.js +11 -11
  174. package/dist/Markdown/Markdown.d.ts.map +1 -1
  175. package/dist/Markdown/Markdown.js +102 -102
  176. package/dist/MetadataList/MetadataList.js +10 -10
  177. package/dist/MetadataList/MetadataListItem.js +15 -15
  178. package/dist/MobileNav/MobileNav.d.ts +1 -1
  179. package/dist/MobileNav/MobileNav.d.ts.map +1 -1
  180. package/dist/MobileNav/MobileNav.js +26 -23
  181. package/dist/MobileNav/MobileNavToggle.js +5 -5
  182. package/dist/MoreMenu/MoreMenu.js +3 -3
  183. package/dist/MultiSelector/MultiSelector.js +56 -56
  184. package/dist/NavIcon/NavIcon.js +3 -3
  185. package/dist/NavMenu/NavHeadingMenu.js +5 -5
  186. package/dist/NavMenu/NavHeadingMenuItem.js +8 -8
  187. package/dist/NumberInput/NumberInput.d.ts.map +1 -1
  188. package/dist/NumberInput/NumberInput.js +48 -32
  189. package/dist/Outline/Outline.js +15 -15
  190. package/dist/OverflowList/OverflowList.js +8 -8
  191. package/dist/Overlay/Overlay.js +3 -3
  192. package/dist/Overlay/OverlayScrim.js +5 -5
  193. package/dist/Overlay/useOverlay.d.ts +0 -3
  194. package/dist/Overlay/useOverlay.d.ts.map +1 -1
  195. package/dist/Overlay/useOverlay.js +3 -6
  196. package/dist/Pagination/Pagination.d.ts +1 -1
  197. package/dist/Pagination/Pagination.d.ts.map +1 -1
  198. package/dist/Pagination/Pagination.js +125 -72
  199. package/dist/Popover/Popover.js +16 -16
  200. package/dist/Popover/usePopover.js +7 -7
  201. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  202. package/dist/PowerSearch/PowerSearch.js +110 -92
  203. package/dist/PowerSearch/PowerSearchEditPopover.js +84 -84
  204. package/dist/PowerSearch/PowerSearchFilterEditor.js +3 -3
  205. package/dist/PowerSearch/PowerSearchToken.js +5 -5
  206. package/dist/PowerSearch/PowerSearchValueEditor.js +54 -54
  207. package/dist/ProgressBar/ProgressBar.d.ts.map +1 -1
  208. package/dist/ProgressBar/ProgressBar.js +25 -18
  209. package/dist/RadioList/RadioList.js +7 -7
  210. package/dist/RadioList/RadioListItem.d.ts +1 -1
  211. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  212. package/dist/RadioList/RadioListItem.js +24 -21
  213. package/dist/Resizable/ResizeHandle.d.ts.map +1 -1
  214. package/dist/Resizable/ResizeHandle.js +28 -10
  215. package/dist/Section/Section.js +5 -5
  216. package/dist/SegmentedControl/SegmentedControl.d.ts +1 -1
  217. package/dist/SegmentedControl/SegmentedControl.d.ts.map +1 -1
  218. package/dist/SegmentedControl/SegmentedControl.js +32 -10
  219. package/dist/SegmentedControl/SegmentedControlItem.d.ts +1 -1
  220. package/dist/SegmentedControl/SegmentedControlItem.d.ts.map +1 -1
  221. package/dist/SegmentedControl/SegmentedControlItem.js +18 -12
  222. package/dist/SelectableCard/SelectableCard.js +5 -5
  223. package/dist/Selector/Selector.js +46 -46
  224. package/dist/Selector/SelectorOption.js +3 -3
  225. package/dist/SideNav/SideNav.d.ts.map +1 -1
  226. package/dist/SideNav/SideNav.js +38 -34
  227. package/dist/SideNav/SideNavCollapseButton.d.ts +1 -1
  228. package/dist/SideNav/SideNavCollapseButton.d.ts.map +1 -1
  229. package/dist/SideNav/SideNavCollapseButton.js +8 -6
  230. package/dist/SideNav/SideNavHeading.js +87 -87
  231. package/dist/SideNav/SideNavItem.js +42 -42
  232. package/dist/SideNav/SideNavSection.d.ts +1 -1
  233. package/dist/SideNav/SideNavSection.d.ts.map +1 -1
  234. package/dist/SideNav/SideNavSection.js +18 -16
  235. package/dist/Skeleton/Skeleton.js +3 -3
  236. package/dist/Slider/Slider.js +23 -23
  237. package/dist/Spinner/Spinner.js +9 -9
  238. package/dist/StatusDot/StatusDot.js +5 -5
  239. package/dist/Switch/Switch.d.ts +8 -4
  240. package/dist/Switch/Switch.d.ts.map +1 -1
  241. package/dist/Switch/Switch.js +34 -29
  242. package/dist/TabList/Tab.js +18 -18
  243. package/dist/TabList/TabList.js +5 -5
  244. package/dist/TabList/TabMenu.d.ts.map +1 -1
  245. package/dist/TabList/TabMenu.js +57 -30
  246. package/dist/TabList/tab.markers.stylex.d.ts +1 -1
  247. package/dist/Table/BaseTable.d.ts.map +1 -1
  248. package/dist/Table/BaseTable.js +50 -39
  249. package/dist/Table/Table.js +7 -7
  250. package/dist/Table/TableBody.d.ts +1 -1
  251. package/dist/Table/TableBody.d.ts.map +1 -1
  252. package/dist/Table/TableBody.js +9 -5
  253. package/dist/Table/TableCell.js +3 -3
  254. package/dist/Table/TableFooter.d.ts +1 -1
  255. package/dist/Table/TableFooter.d.ts.map +1 -1
  256. package/dist/Table/TableFooter.js +9 -5
  257. package/dist/Table/TableHeader.d.ts +1 -1
  258. package/dist/Table/TableHeader.d.ts.map +1 -1
  259. package/dist/Table/TableHeader.js +9 -5
  260. package/dist/Table/TableHeaderCell.js +3 -3
  261. package/dist/Table/TableRow.js +5 -5
  262. package/dist/Table/index.d.ts +2 -0
  263. package/dist/Table/index.d.ts.map +1 -1
  264. package/dist/Table/index.js +1 -0
  265. package/dist/Table/plugins/columnResize/useTableColumnResize.d.ts.map +1 -1
  266. package/dist/Table/plugins/columnResize/useTableColumnResize.js +14 -11
  267. package/dist/Table/plugins/filtering/useTableFiltering.js +71 -71
  268. package/dist/Table/plugins/groupedRows/index.d.ts +3 -0
  269. package/dist/Table/plugins/groupedRows/index.d.ts.map +1 -0
  270. package/dist/Table/plugins/groupedRows/index.js +3 -0
  271. package/dist/Table/plugins/groupedRows/useTableGroupedRows.d.ts +78 -0
  272. package/dist/Table/plugins/groupedRows/useTableGroupedRows.d.ts.map +1 -0
  273. package/dist/Table/plugins/groupedRows/useTableGroupedRows.js +250 -0
  274. package/dist/Table/plugins/pagination/paginateData.d.ts.map +1 -1
  275. package/dist/Table/plugins/pagination/paginateData.js +5 -1
  276. package/dist/Table/plugins/pagination/useTablePagination.js +7 -7
  277. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.d.ts +1 -1
  278. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.js +23 -23
  279. package/dist/Table/plugins/selection/useTableSelection.js +18 -18
  280. package/dist/Table/plugins/selection/useTableSelectionState.d.ts.map +1 -1
  281. package/dist/Table/plugins/selection/useTableSelectionState.js +11 -1
  282. package/dist/Table/plugins/sortable/useTableSortable.js +17 -17
  283. package/dist/Table/plugins/sortable/useTableSortableState.d.ts.map +1 -1
  284. package/dist/Table/plugins/sortable/useTableSortableState.js +8 -4
  285. package/dist/Table/tableContextMenu.js +9 -9
  286. package/dist/Text/Text.js +10 -10
  287. package/dist/TextArea/TextArea.js +14 -14
  288. package/dist/TextInput/TextInput.js +15 -15
  289. package/dist/Thumbnail/Thumbnail.d.ts +3 -2
  290. package/dist/Thumbnail/Thumbnail.d.ts.map +1 -1
  291. package/dist/Thumbnail/Thumbnail.js +30 -29
  292. package/dist/TimeInput/TimeInput.d.ts.map +1 -1
  293. package/dist/TimeInput/TimeInput.js +26 -21
  294. package/dist/Timestamp/Timestamp.d.ts +1 -1
  295. package/dist/Timestamp/Timestamp.d.ts.map +1 -1
  296. package/dist/Timestamp/Timestamp.js +37 -26
  297. package/dist/Toast/Toast.d.ts.map +1 -1
  298. package/dist/Toast/Toast.js +25 -17
  299. package/dist/Toast/ToastViewport.d.ts.map +1 -1
  300. package/dist/Toast/ToastViewport.js +23 -11
  301. package/dist/Toast/useToast.d.ts.map +1 -1
  302. package/dist/Toast/useToast.js +44 -4
  303. package/dist/ToggleButton/ToggleButton.js +12 -12
  304. package/dist/ToggleButton/ToggleButtonGroup.js +5 -5
  305. package/dist/Token/Token.js +21 -21
  306. package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
  307. package/dist/Tokenizer/Tokenizer.js +36 -34
  308. package/dist/Toolbar/Toolbar.js +18 -18
  309. package/dist/Tooltip/Tooltip.js +11 -11
  310. package/dist/Tooltip/useTooltip.d.ts +5 -1
  311. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  312. package/dist/Tooltip/useTooltip.js +3 -3
  313. package/dist/TopNav/TopNav.js +32 -32
  314. package/dist/TopNav/TopNavHeading.js +67 -67
  315. package/dist/TopNav/TopNavItem.js +5 -5
  316. package/dist/TopNav/TopNavMegaMenu.js +30 -30
  317. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts +1 -1
  318. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts.map +1 -1
  319. package/dist/TopNav/TopNavMegaMenuFeaturedCard.js +25 -14
  320. package/dist/TopNav/TopNavMegaMenuItem.js +16 -16
  321. package/dist/TopNav/TopNavMenu.js +32 -32
  322. package/dist/TreeList/TreeList.js +8 -8
  323. package/dist/TreeList/TreeListBranches.js +11 -11
  324. package/dist/TreeList/TreeListItem.js +30 -30
  325. package/dist/Typeahead/BaseTypeahead.d.ts.map +1 -1
  326. package/dist/Typeahead/BaseTypeahead.js +23 -20
  327. package/dist/Typeahead/Typeahead.js +12 -12
  328. package/dist/Typeahead/TypeaheadItem.js +10 -10
  329. package/dist/VStack/VStack.js +3 -3
  330. package/dist/VisuallyHidden/VisuallyHidden.d.ts +0 -3
  331. package/dist/VisuallyHidden/VisuallyHidden.d.ts.map +1 -1
  332. package/dist/VisuallyHidden/VisuallyHidden.js +0 -3
  333. package/dist/astryx.css +7 -0
  334. package/dist/astryx.umd.js +63 -63
  335. package/dist/astryx.umd.js.map +4 -4
  336. package/dist/docs-types.d.ts +8 -2
  337. package/dist/docs-types.d.ts.map +1 -1
  338. package/dist/hooks/focusableSelector.d.ts +1 -1
  339. package/dist/hooks/focusableSelector.d.ts.map +1 -1
  340. package/dist/hooks/focusableSelector.js +1 -1
  341. package/dist/hooks/index.d.ts +2 -0
  342. package/dist/hooks/index.d.ts.map +1 -1
  343. package/dist/hooks/index.js +1 -0
  344. package/dist/hooks/useFocusTrap.d.ts +3 -0
  345. package/dist/hooks/useFocusTrap.d.ts.map +1 -1
  346. package/dist/hooks/useFocusTrap.js +38 -1
  347. package/dist/hooks/useHotkeys.d.ts +51 -0
  348. package/dist/hooks/useHotkeys.d.ts.map +1 -0
  349. package/dist/hooks/useHotkeys.js +160 -0
  350. package/dist/hooks/useInteractiveRole.d.ts +6 -2
  351. package/dist/hooks/useInteractiveRole.d.ts.map +1 -1
  352. package/dist/hooks/useInteractiveRole.js +6 -2
  353. package/dist/hooks/useKeyboardHint.js +9 -9
  354. package/dist/hooks/useStreamingText.d.ts +3 -1
  355. package/dist/hooks/useStreamingText.d.ts.map +1 -1
  356. package/dist/hooks/useStreamingText.js +14 -5
  357. package/dist/theme/MediaTheme.js +3 -3
  358. package/dist/theme/Theme.js +7 -7
  359. package/dist/theme/defineTheme.d.ts +1 -1
  360. package/dist/theme/defineTheme.d.ts.map +1 -1
  361. package/dist/theme/expandColorScale.d.ts.map +1 -1
  362. package/dist/theme/expandColorScale.js +10 -3
  363. package/dist/theme/hct.d.ts +0 -15
  364. package/dist/theme/hct.d.ts.map +1 -1
  365. package/dist/theme/hct.js +9 -9
  366. package/dist/theme/syntax/SyntaxTheme.js +5 -5
  367. package/dist/theme/tokens.d.ts +10 -2
  368. package/dist/theme/tokens.d.ts.map +1 -1
  369. package/dist/theme/tokens.js +220 -4
  370. package/dist/theme/useTheme.d.ts +3 -2
  371. package/dist/theme/useTheme.d.ts.map +1 -1
  372. package/dist/theme/useTheme.js +73 -6
  373. package/dist/utils/color.d.ts +42 -0
  374. package/dist/utils/color.d.ts.map +1 -0
  375. package/dist/utils/color.js +150 -0
  376. package/dist/utils/composeEventHandlers.d.ts +30 -0
  377. package/dist/utils/composeEventHandlers.d.ts.map +1 -0
  378. package/dist/utils/composeEventHandlers.js +40 -0
  379. package/dist/utils/index.d.ts +3 -0
  380. package/dist/utils/index.d.ts.map +1 -1
  381. package/dist/utils/index.js +3 -1
  382. package/dist/utils/timeParser.d.ts.map +1 -1
  383. package/dist/utils/timeParser.js +8 -5
  384. package/package.json +4 -4
  385. package/src/AlertDialog/AlertDialog.doc.mjs +4 -0
  386. package/src/AlertDialog/AlertDialog.tsx +2 -0
  387. package/src/AlertDialog/useImperativeAlertDialog.tsx +0 -2
  388. package/src/AppShell/AppShell.tsx +2 -0
  389. package/src/AspectRatio/AspectRatio.doc.mjs +28 -1
  390. package/src/AspectRatio/AspectRatio.test.tsx +142 -1
  391. package/src/AspectRatio/AspectRatio.tsx +70 -10
  392. package/src/AspectRatio/index.ts +5 -1
  393. package/src/Avatar/Avatar.doc.mjs +11 -0
  394. package/src/Avatar/Avatar.test.tsx +32 -1
  395. package/src/Avatar/Avatar.tsx +14 -22
  396. package/src/Avatar/AvatarStatusDot.tsx +2 -2
  397. package/src/AvatarGroup/AvatarGroup.doc.mjs +1 -0
  398. package/src/AvatarGroup/AvatarGroup.tsx +2 -2
  399. package/src/AvatarGroup/AvatarGroupOverflow.tsx +2 -2
  400. package/src/Banner/Banner.doc.mjs +8 -0
  401. package/src/Banner/Banner.test.tsx +38 -0
  402. package/src/Banner/Banner.tsx +8 -1
  403. package/src/Calendar/Calendar.doc.mjs +1 -1
  404. package/src/Calendar/Calendar.test.tsx +122 -17
  405. package/src/Calendar/Calendar.tsx +26 -5
  406. package/src/Calendar/dayCellUtils.ts +3 -1
  407. package/src/Calendar/styles.ts +12 -2
  408. package/src/Card/Card.doc.mjs +1 -1
  409. package/src/Card/Card.tsx +16 -6
  410. package/src/Carousel/Carousel.doc.mjs +12 -12
  411. package/src/Carousel/Carousel.test.tsx +13 -0
  412. package/src/Carousel/Carousel.tsx +4 -2
  413. package/src/Chat/Chat.doc.mjs +1 -1
  414. package/src/Chat/ChatComposerInput.test.tsx +27 -1
  415. package/src/Chat/ChatComposerInput.tsx +20 -15
  416. package/src/Chat/ChatDictationButton.test.tsx +43 -0
  417. package/src/Chat/ChatDictationButton.tsx +4 -4
  418. package/src/Chat/ChatLayoutScrollButton.test.tsx +33 -0
  419. package/src/Chat/ChatLayoutScrollButton.tsx +3 -1
  420. package/src/Chat/ChatMessageMetadata.test.tsx +32 -0
  421. package/src/Chat/ChatMessageMetadata.tsx +4 -6
  422. package/src/Chat/ChatSystemMessage.test.tsx +26 -11
  423. package/src/Chat/ChatSystemMessage.tsx +7 -7
  424. package/src/Chat/ChatTokenizedText.test.tsx +29 -16
  425. package/src/Chat/ChatTokenizedText.tsx +15 -8
  426. package/src/Chat/ChatToolCalls.test.tsx +55 -0
  427. package/src/Chat/ChatToolCalls.tsx +10 -12
  428. package/src/Chat/index.ts +1 -4
  429. package/src/Chat/useTriggerMenu.tsx +1 -4
  430. package/src/CheckboxInput/CheckboxInput.doc.mjs +3 -3
  431. package/src/CheckboxInput/CheckboxInput.test.tsx +71 -4
  432. package/src/CheckboxInput/CheckboxInput.tsx +2 -0
  433. package/src/CheckboxList/CheckboxList.test.tsx +19 -0
  434. package/src/CheckboxList/CheckboxListItem.tsx +11 -2
  435. package/src/Citation/Citation.doc.mjs +5 -0
  436. package/src/ClickableCard/ClickableCard.tsx +45 -2
  437. package/src/CodeBlock/CodeBlock.doc.mjs +7 -2
  438. package/src/CodeBlock/CodeBlock.test.tsx +122 -3
  439. package/src/CodeBlock/CodeBlock.tsx +62 -4
  440. package/src/Collapsible/Collapsible.doc.mjs +8 -4
  441. package/src/Collapsible/Collapsible.test.tsx +403 -0
  442. package/src/Collapsible/Collapsible.tsx +85 -10
  443. package/src/Collapsible/CollapsibleGroup.doc.mjs +27 -3
  444. package/src/Collapsible/CollapsibleGroup.test.tsx +314 -0
  445. package/src/Collapsible/CollapsibleGroup.tsx +97 -9
  446. package/src/Collapsible/CollapsibleGroupContext.tsx +34 -2
  447. package/src/Collapsible/index.ts +1 -0
  448. package/src/Collapsible/useCollapsible.ts +20 -6
  449. package/src/CommandPalette/CommandPalette.doc.mjs +5 -0
  450. package/src/CommandPalette/CommandPalette.tsx +5 -3
  451. package/src/CommandPalette/CommandPaletteEmpty.doc.mjs +5 -0
  452. package/src/CommandPalette/CommandPaletteGroup.doc.mjs +10 -0
  453. package/src/CommandPalette/CommandPaletteInput.doc.mjs +6 -0
  454. package/src/CommandPalette/CommandPaletteItem.doc.mjs +6 -0
  455. package/src/CommandPalette/CommandPaletteList.doc.mjs +9 -0
  456. package/src/ContextMenu/ContextMenu.doc.mjs +15 -0
  457. package/src/ContextMenu/ContextMenu.test.tsx +87 -0
  458. package/src/ContextMenu/ContextMenu.tsx +87 -28
  459. package/src/ContextMenu/ContextMenuItem.doc.mjs +6 -0
  460. package/src/DateInput/DateInput.test.tsx +11 -20
  461. package/src/DateRangeInput/DateRangeInput.doc.mjs +9 -6
  462. package/src/DateRangeInput/DateRangeInput.test.tsx +31 -44
  463. package/src/DateTimeInput/DateTimeInput.doc.mjs +3 -2
  464. package/src/DateTimeInput/DateTimeInput.test.tsx +118 -16
  465. package/src/DateTimeInput/DateTimeInput.tsx +8 -2
  466. package/src/DateTimeInput/index.ts +1 -0
  467. package/src/Dialog/Dialog.doc.mjs +4 -0
  468. package/src/Dialog/DialogHeader.doc.mjs +45 -0
  469. package/src/DropdownMenu/DropdownMenu.doc.mjs +1 -1
  470. package/src/DropdownMenu/DropdownMenu.test.tsx +22 -2
  471. package/src/DropdownMenu/DropdownMenuItem.tsx +5 -17
  472. package/src/EmptyState/EmptyState.doc.mjs +1 -1
  473. package/src/Field/Field.test.tsx +1 -4
  474. package/src/Field/FieldLabel.test.tsx +2 -2
  475. package/src/FieldStatus/FieldStatus.test.tsx +282 -0
  476. package/src/FormLayout/__snapshots__/FormLayout.test.tsx.snap +0 -3
  477. package/src/Grid/Grid.test.tsx +43 -18
  478. package/src/Grid/Grid.tsx +26 -9
  479. package/src/HoverCard/HoverCard.doc.mjs +6 -6
  480. package/src/HoverCard/useHoverCard.doc.mjs +5 -5
  481. package/src/HoverCard/useHoverCard.tsx +9 -2
  482. package/src/Icon/Icon.test.tsx +41 -29
  483. package/src/Icon/Icon.tsx +6 -2
  484. package/src/InputGroup/InputGroup.doc.mjs +1 -0
  485. package/src/InputGroup/InputGroup.tsx +2 -2
  486. package/src/InteractiveRoleContext/InteractiveRoleContext.test.tsx +185 -0
  487. package/src/Item/Item.tsx +1 -1
  488. package/src/Layer/useLayer.doc.mjs +2 -2
  489. package/src/Layer/useLayer.test.tsx +221 -2
  490. package/src/Layer/useLayer.tsx +69 -30
  491. package/src/Layout/Layout.test.tsx +285 -0
  492. package/src/Layout/LayoutContent.doc.mjs +12 -0
  493. package/src/Layout/LayoutPanel.doc.mjs +40 -0
  494. package/src/Layout/LayoutSlots.test.tsx +364 -0
  495. package/src/Lightbox/Lightbox.doc.mjs +5 -0
  496. package/src/Lightbox/Lightbox.test.tsx +123 -2
  497. package/src/Lightbox/Lightbox.tsx +29 -1
  498. package/src/Lightbox/useLightbox.tsx +0 -1
  499. package/src/Link/Link.tsx +0 -2
  500. package/src/Markdown/Markdown.tsx +9 -7
  501. package/src/Markdown/parser.perf.test.ts +34 -12
  502. package/src/MobileNav/MobileNav.test.tsx +56 -0
  503. package/src/MobileNav/MobileNav.tsx +13 -8
  504. package/src/NavMenu/NavMenu.doc.mjs +15 -0
  505. package/src/NumberInput/NumberInput.test.tsx +48 -3
  506. package/src/NumberInput/NumberInput.tsx +32 -15
  507. package/src/Outline/Outline.doc.mjs +2 -0
  508. package/src/Outline/parseOutlineFromMarkdown.test.ts +80 -0
  509. package/src/OverflowList/OverflowList.test.tsx +416 -0
  510. package/src/Overlay/Overlay.doc.mjs +6 -0
  511. package/src/Overlay/Overlay.test.tsx +356 -0
  512. package/src/Overlay/useOverlay.tsx +0 -3
  513. package/src/Pagination/Pagination.test.tsx +162 -0
  514. package/src/Pagination/Pagination.tsx +80 -26
  515. package/src/Popover/Popover.doc.mjs +6 -6
  516. package/src/Popover/Popover.test.tsx +65 -0
  517. package/src/Popover/usePopover.doc.mjs +1 -1
  518. package/src/PowerSearch/PowerSearch.doc.mjs +2 -2
  519. package/src/PowerSearch/PowerSearch.test.tsx +109 -1
  520. package/src/PowerSearch/PowerSearch.tsx +37 -16
  521. package/src/ProgressBar/ProgressBar.doc.mjs +2 -0
  522. package/src/ProgressBar/ProgressBar.test.tsx +30 -0
  523. package/src/ProgressBar/ProgressBar.tsx +12 -5
  524. package/src/RadioList/RadioList.test.tsx +19 -0
  525. package/src/RadioList/RadioListItem.tsx +9 -4
  526. package/src/Resizable/ResizeHandle.test.tsx +218 -0
  527. package/src/Resizable/ResizeHandle.tsx +22 -4
  528. package/src/SegmentedControl/SegmentedControl.doc.mjs +1 -1
  529. package/src/SegmentedControl/SegmentedControl.test.tsx +192 -0
  530. package/src/SegmentedControl/SegmentedControl.tsx +27 -5
  531. package/src/SegmentedControl/SegmentedControlItem.tsx +9 -4
  532. package/src/SelectableCard/SelectableCard.doc.mjs +1 -1
  533. package/src/Selector/Selector.test.tsx +27 -1
  534. package/src/SideNav/SideNav.doc.mjs +7 -1
  535. package/src/SideNav/SideNav.test.tsx +66 -0
  536. package/src/SideNav/SideNav.tsx +6 -2
  537. package/src/SideNav/SideNavCollapseButton.tsx +4 -3
  538. package/src/SideNav/SideNavSection.tsx +6 -4
  539. package/src/SizeContext/SizeContext.test.tsx +226 -0
  540. package/src/Switch/Switch.doc.mjs +7 -7
  541. package/src/Switch/Switch.test.tsx +102 -3
  542. package/src/Switch/Switch.tsx +20 -7
  543. package/src/TabList/TabList.test.tsx +185 -1
  544. package/src/TabList/TabMenu.tsx +45 -9
  545. package/src/Table/BaseTable.tsx +13 -2
  546. package/src/Table/Table.doc.mjs +6 -1
  547. package/src/Table/Table.test.tsx +87 -0
  548. package/src/Table/TableBody.tsx +15 -2
  549. package/src/Table/TableFooter.tsx +15 -2
  550. package/src/Table/TableHeader.tsx +15 -2
  551. package/src/Table/index.ts +5 -0
  552. package/src/Table/plugins/columnResize/useTableColumnResize.test.tsx +13 -0
  553. package/src/Table/plugins/columnResize/useTableColumnResize.tsx +3 -1
  554. package/src/Table/plugins/groupedRows/index.ts +7 -0
  555. package/src/Table/plugins/groupedRows/useTableGroupedRows.test.tsx +231 -0
  556. package/src/Table/plugins/groupedRows/useTableGroupedRows.tsx +349 -0
  557. package/src/Table/plugins/pagination/paginateData.ts +5 -1
  558. package/src/Table/plugins/pagination/useTablePagination.test.tsx +13 -0
  559. package/src/Table/plugins/rowExpansion/useTableRowExpansion.tsx +1 -1
  560. package/src/Table/plugins/selection/useTableSelectionState.test.tsx +23 -0
  561. package/src/Table/plugins/selection/useTableSelectionState.tsx +11 -6
  562. package/src/Table/plugins/sortable/useTableSortableState.test.tsx +35 -1
  563. package/src/Table/plugins/sortable/useTableSortableState.tsx +8 -4
  564. package/src/Table/useTableGroupedRows.doc.mjs +71 -0
  565. package/src/TextArea/TextArea.test.tsx +3 -3
  566. package/src/TextInput/TextInput.test.tsx +3 -3
  567. package/src/Thumbnail/Thumbnail.test.tsx +36 -2
  568. package/src/Thumbnail/Thumbnail.tsx +4 -2
  569. package/src/TimeInput/TimeInput.test.tsx +37 -0
  570. package/src/TimeInput/TimeInput.tsx +11 -1
  571. package/src/Timestamp/Timestamp.doc.mjs +1 -1
  572. package/src/Timestamp/Timestamp.test.tsx +52 -0
  573. package/src/Timestamp/Timestamp.tsx +30 -16
  574. package/src/Toast/Toast.tsx +11 -3
  575. package/src/Toast/ToastViewport.test.tsx +64 -0
  576. package/src/Toast/ToastViewport.tsx +12 -0
  577. package/src/Toast/useToast.test.tsx +258 -0
  578. package/src/Toast/useToast.tsx +41 -0
  579. package/src/ToggleButton/ToggleButton.doc.mjs +1 -0
  580. package/src/Tokenizer/Tokenizer.doc.mjs +2 -2
  581. package/src/Tokenizer/Tokenizer.test.tsx +54 -0
  582. package/src/Tokenizer/Tokenizer.tsx +5 -4
  583. package/src/Tooltip/Tooltip.doc.mjs +6 -6
  584. package/src/Tooltip/useTooltip.doc.mjs +5 -5
  585. package/src/Tooltip/useTooltip.tsx +12 -2
  586. package/src/TopNav/TopNav.doc.mjs +1 -1
  587. package/src/TopNav/TopNav.test.tsx +23 -7
  588. package/src/TopNav/TopNavMegaMenuFeaturedCard.tsx +9 -2
  589. package/src/TreeList/TreeList.doc.mjs +2 -2
  590. package/src/Typeahead/BaseTypeahead.doc.mjs +19 -0
  591. package/src/Typeahead/BaseTypeahead.tsx +5 -2
  592. package/src/Typeahead/Typeahead.doc.mjs +1 -1
  593. package/src/Typeahead/Typeahead.test.tsx +45 -1
  594. package/src/VisuallyHidden/VisuallyHidden.tsx +0 -3
  595. package/src/__tests__/TestIcon.tsx +26 -0
  596. package/src/__tests__/fastRoleQueries.ts +66 -0
  597. package/src/docPropReferences.test.ts +178 -0
  598. package/src/docs-types.ts +9 -1
  599. package/src/hooks/focusableSelector.ts +1 -1
  600. package/src/hooks/index.ts +3 -0
  601. package/src/hooks/useFocusTrap.doc.mjs +4 -2
  602. package/src/hooks/useFocusTrap.test.tsx +149 -1
  603. package/src/hooks/useFocusTrap.ts +50 -1
  604. package/src/hooks/useHotkeys.doc.mjs +52 -0
  605. package/src/hooks/useHotkeys.test.ts +245 -0
  606. package/src/hooks/useHotkeys.ts +203 -0
  607. package/src/hooks/useInteractiveRole.ts +12 -4
  608. package/src/hooks/useStreamingText.test.ts +54 -19
  609. package/src/hooks/useStreamingText.ts +16 -5
  610. package/src/hooks/useTreeFocus.test.tsx +1 -3
  611. package/src/reset.css +29 -0
  612. package/src/theme/SyntaxTheme.doc.mjs +4 -4
  613. package/src/theme/defineTheme.ts +4 -13
  614. package/src/theme/derivedVarRegistry.test.ts +2 -2
  615. package/src/theme/expandColorScale.test.ts +29 -0
  616. package/src/theme/expandColorScale.ts +11 -6
  617. package/src/theme/hct.ts +9 -17
  618. package/src/theme/themingTargets.test.ts +353 -0
  619. package/src/theme/tokens.test.ts +182 -9
  620. package/src/theme/tokens.ts +239 -4
  621. package/src/theme/useTheme.test.tsx +126 -2
  622. package/src/theme/useTheme.ts +87 -6
  623. package/src/utils/color.test.ts +133 -0
  624. package/src/utils/color.ts +148 -0
  625. package/src/utils/composeEventHandlers.test.ts +71 -0
  626. package/src/utils/composeEventHandlers.ts +44 -0
  627. package/src/utils/index.ts +4 -0
  628. package/src/utils/mergeProps.test.ts +166 -0
  629. package/src/utils/sharedResizeObserver.test.ts +2 -2
  630. package/src/utils/timeParser.test.ts +13 -0
  631. package/src/utils/timeParser.ts +8 -5
  632. package/dist/Carousel/carousel.markers.stylex.d.ts +0 -7
  633. package/dist/Carousel/carousel.markers.stylex.d.ts.map +0 -1
  634. package/dist/Carousel/carousel.markers.stylex.js +0 -12
  635. package/src/Carousel/carousel.markers.stylex.ts +0 -10
@@ -25,7 +25,6 @@
25
25
 
26
26
  import {useCallback, type ReactNode} from 'react';
27
27
  import * as stylex from '@stylexjs/stylex';
28
- import type {StyleXStyles} from '@stylexjs/stylex';
29
28
  import {renderIconSlot, type IconType} from '../Icon';
30
29
  import {Item} from '../Item';
31
30
  import {
@@ -35,6 +34,7 @@ import {
35
34
  typeScaleVars,
36
35
  } from '../theme/tokens.stylex';
37
36
  import {mergeProps} from '../utils';
37
+ import type {BaseProps} from '../BaseProps';
38
38
  import {useDropdownMenuContext} from './DropdownMenuContext';
39
39
  import {themeProps} from '../utils/themeProps';
40
40
 
@@ -75,7 +75,10 @@ const itemSizeStyles = stylex.create({
75
75
  lg: {},
76
76
  });
77
77
 
78
- export interface DropdownMenuItemProps {
78
+ export interface DropdownMenuItemProps extends Pick<
79
+ BaseProps,
80
+ 'xstyle' | 'className' | 'style'
81
+ > {
79
82
  /** Icon to display before the label. */
80
83
  icon?: ReactNode | IconType;
81
84
  /** Primary label text. */
@@ -88,21 +91,6 @@ export interface DropdownMenuItemProps {
88
91
  isDisabled?: boolean;
89
92
  /** Additional content to render after the label/description. */
90
93
  endContent?: ReactNode;
91
- /**
92
- * StyleX styles for layout customization (margins, positioning, sizing).
93
- * Must be a `stylex.create()` value — not an inline style object.
94
- *
95
- * @example
96
- * ```
97
- * const styles = stylex.create({ wrapper: { marginTop: 8 } });
98
- * <DropdownMenuItem xstyle={styles.wrapper} />
99
- * ```
100
- */
101
- xstyle?: StyleXStyles;
102
- /** CSS class name(s) appended to the root element. */
103
- className?: string;
104
- /** Inline styles applied to the root element. */
105
- style?: React.CSSProperties;
106
94
  }
107
95
 
108
96
  /**
@@ -140,7 +140,7 @@ export const docsZh = {
140
140
  ],
141
141
  theming: {
142
142
  targets: [
143
- {className: 'astryx-empty-state'},
143
+ {className: 'astryx-empty-state', visualProps: ['variant']},
144
144
  ],
145
145
  },
146
146
  usage: {
@@ -137,10 +137,7 @@ describe('Field', () => {
137
137
 
138
138
  it('renders description without ID attribute when descriptionID is not provided', () => {
139
139
  render(
140
- <Field
141
- label="Email"
142
- inputID="email-input"
143
- description="Description text">
140
+ <Field label="Email" inputID="email-input" description="Description text">
144
141
  <input id="email-input" />
145
142
  </Field>,
146
143
  );
@@ -11,7 +11,7 @@
11
11
 
12
12
  import {describe, it, expect, vi} from 'vitest';
13
13
  import {render, screen} from '@testing-library/react';
14
- import {StarIcon} from '@heroicons/react/24/outline';
14
+ import {TestIcon} from '../__tests__/TestIcon';
15
15
  import {FieldLabel} from './FieldLabel';
16
16
 
17
17
  describe('FieldLabel', () => {
@@ -49,7 +49,7 @@ describe('FieldLabel', () => {
49
49
  <FieldLabel
50
50
  label="Starred"
51
51
  inputID="starred-input"
52
- labelIcon={StarIcon}
52
+ labelIcon={TestIcon}
53
53
  />,
54
54
  );
55
55
  const svg = document.querySelector('svg');
@@ -0,0 +1,282 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file FieldStatus.test.tsx
5
+ * @input Uses vitest, @testing-library/react, FieldStatus component
6
+ * @output Characterization coverage for FieldStatus behavior
7
+ * @position Testing; validates FieldStatus.tsx implementation
8
+ *
9
+ * SYNC: When FieldStatus.tsx changes, update tests to match new behavior
10
+ */
11
+
12
+ import {describe, it, expect, vi} from 'vitest';
13
+ import {render, screen} from '@testing-library/react';
14
+ import * as stylex from '@stylexjs/stylex';
15
+ import {FieldStatus} from './FieldStatus';
16
+
17
+ const testStyles = stylex.create({
18
+ custom: {color: 'rebeccapurple'},
19
+ });
20
+
21
+ describe('FieldStatus', () => {
22
+ it('renders the message text', () => {
23
+ render(<FieldStatus type="error" message="This field is required" />);
24
+ expect(screen.getByText('This field is required')).toBeInTheDocument();
25
+ });
26
+
27
+ it('renders the message inside a <div>', () => {
28
+ render(<FieldStatus type="error" message="Boom" data-testid="fs" />);
29
+ expect(screen.getByTestId('fs').tagName).toBe('DIV');
30
+ });
31
+
32
+ describe('role semantics', () => {
33
+ // Errors are urgent — they get role="alert" so assistive tech interrupts.
34
+ it('uses role="alert" for error status', () => {
35
+ render(<FieldStatus type="error" message="msg" />);
36
+ expect(screen.getByRole('alert')).toHaveTextContent('msg');
37
+ });
38
+
39
+ // Non-error statuses are advisory — role="status" is a polite live region.
40
+ it('uses role="status" for warning status', () => {
41
+ render(<FieldStatus type="warning" message="msg" data-testid="fs" />);
42
+ expect(screen.getByTestId('fs')).toHaveAttribute('role', 'status');
43
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
44
+ });
45
+
46
+ it('uses role="status" for success status', () => {
47
+ render(<FieldStatus type="success" message="msg" data-testid="fs" />);
48
+ expect(screen.getByTestId('fs')).toHaveAttribute('role', 'status');
49
+ });
50
+ });
51
+
52
+ describe('aria-live politeness', () => {
53
+ // Error → assertive so screen readers announce immediately.
54
+ it('sets aria-live="assertive" for error', () => {
55
+ render(<FieldStatus type="error" message="msg" data-testid="fs" />);
56
+ expect(screen.getByTestId('fs')).toHaveAttribute(
57
+ 'aria-live',
58
+ 'assertive',
59
+ );
60
+ });
61
+
62
+ it('sets aria-live="polite" for warning', () => {
63
+ render(<FieldStatus type="warning" message="msg" data-testid="fs" />);
64
+ expect(screen.getByTestId('fs')).toHaveAttribute('aria-live', 'polite');
65
+ });
66
+
67
+ it('sets aria-live="polite" for success', () => {
68
+ render(<FieldStatus type="success" message="msg" data-testid="fs" />);
69
+ expect(screen.getByTestId('fs')).toHaveAttribute('aria-live', 'polite');
70
+ });
71
+
72
+ // The element is a live region, never hidden from assistive tech.
73
+ it('does not mark itself aria-hidden', () => {
74
+ render(<FieldStatus type="error" message="msg" data-testid="fs" />);
75
+ expect(screen.getByTestId('fs')).not.toHaveAttribute('aria-hidden');
76
+ });
77
+ });
78
+
79
+ describe('theme class + data attribute reflection', () => {
80
+ it('renders the stable astryx-field-status class', () => {
81
+ render(<FieldStatus type="error" message="msg" data-testid="fs" />);
82
+ expect(screen.getByTestId('fs')).toHaveClass('astryx-field-status');
83
+ });
84
+
85
+ it('reflects the type as a class token and data-type attribute', () => {
86
+ render(<FieldStatus type="warning" message="msg" data-testid="fs" />);
87
+ const el = screen.getByTestId('fs');
88
+ expect(el).toHaveClass('warning');
89
+ expect(el).toHaveAttribute('data-type', 'warning');
90
+ });
91
+
92
+ it('reflects the variant as a class token and data-variant attribute', () => {
93
+ render(
94
+ <FieldStatus
95
+ type="error"
96
+ message="msg"
97
+ variant="detached"
98
+ data-testid="fs"
99
+ />,
100
+ );
101
+ const el = screen.getByTestId('fs');
102
+ expect(el).toHaveClass('detached');
103
+ expect(el).toHaveAttribute('data-variant', 'detached');
104
+ });
105
+
106
+ it('defaults data-variant to "attached"', () => {
107
+ render(<FieldStatus type="error" message="msg" data-testid="fs" />);
108
+ const el = screen.getByTestId('fs');
109
+ expect(el).toHaveAttribute('data-variant', 'attached');
110
+ expect(el).toHaveClass('attached');
111
+ });
112
+ });
113
+
114
+ describe('color styling per status type', () => {
115
+ // Each status type maps to a distinct color treatment. The rendered class
116
+ // list must therefore differ between types — a regression that collapsed
117
+ // them onto one color would be caught here.
118
+ it('applies distinct StyleX classes for each type', () => {
119
+ const {rerender} = render(
120
+ <FieldStatus type="error" message="msg" data-testid="fs" />,
121
+ );
122
+ const errorClass = screen.getByTestId('fs').getAttribute('class');
123
+
124
+ rerender(<FieldStatus type="warning" message="msg" data-testid="fs" />);
125
+ const warningClass = screen.getByTestId('fs').getAttribute('class');
126
+
127
+ rerender(<FieldStatus type="success" message="msg" data-testid="fs" />);
128
+ const successClass = screen.getByTestId('fs').getAttribute('class');
129
+
130
+ expect(errorClass).not.toEqual(warningClass);
131
+ expect(warningClass).not.toEqual(successClass);
132
+ expect(errorClass).not.toEqual(successClass);
133
+ });
134
+
135
+ it('applies distinct StyleX classes for each variant', () => {
136
+ const {rerender} = render(
137
+ <FieldStatus
138
+ type="error"
139
+ message="msg"
140
+ variant="attached"
141
+ data-testid="fs"
142
+ />,
143
+ );
144
+ const attachedClass = screen.getByTestId('fs').getAttribute('class');
145
+
146
+ rerender(
147
+ <FieldStatus
148
+ type="error"
149
+ message="msg"
150
+ variant="detached"
151
+ data-testid="fs"
152
+ />,
153
+ );
154
+ const detachedClass = screen.getByTestId('fs').getAttribute('class');
155
+
156
+ expect(attachedClass).not.toEqual(detachedClass);
157
+ });
158
+ });
159
+
160
+ describe('prop forwarding', () => {
161
+ it('forwards a ref to the root element', () => {
162
+ const ref = vi.fn();
163
+ render(<FieldStatus ref={ref} type="error" message="msg" />);
164
+ expect(ref).toHaveBeenCalledWith(expect.any(HTMLDivElement));
165
+ });
166
+
167
+ it('applies the id attribute', () => {
168
+ render(
169
+ <FieldStatus
170
+ type="error"
171
+ message="msg"
172
+ id="email-error"
173
+ data-testid="fs"
174
+ />,
175
+ );
176
+ expect(screen.getByTestId('fs')).toHaveAttribute('id', 'email-error');
177
+ });
178
+
179
+ it('passes through arbitrary DOM props', () => {
180
+ render(
181
+ <FieldStatus
182
+ type="error"
183
+ message="msg"
184
+ data-testid="fs"
185
+ data-custom="xyz"
186
+ />,
187
+ );
188
+ expect(screen.getByTestId('fs')).toHaveAttribute('data-custom', 'xyz');
189
+ });
190
+
191
+ it('merges a consumer className with the stable class', () => {
192
+ render(
193
+ <FieldStatus
194
+ type="error"
195
+ message="msg"
196
+ className="my-status"
197
+ data-testid="fs"
198
+ />,
199
+ );
200
+ const el = screen.getByTestId('fs');
201
+ expect(el).toHaveClass('my-status');
202
+ expect(el).toHaveClass('astryx-field-status');
203
+ });
204
+
205
+ it('merges a consumer inline style', () => {
206
+ render(
207
+ <FieldStatus
208
+ type="error"
209
+ message="msg"
210
+ style={{marginTop: '10px'}}
211
+ data-testid="fs"
212
+ />,
213
+ );
214
+ expect(screen.getByTestId('fs')).toHaveStyle({marginTop: '10px'});
215
+ });
216
+
217
+ it('applies an xstyle as an extra class', () => {
218
+ const {rerender} = render(
219
+ <FieldStatus type="error" message="msg" data-testid="fs" />,
220
+ );
221
+ const withoutXstyle = screen.getByTestId('fs').getAttribute('class');
222
+
223
+ // xstyle values are compiled StyleX styles; passing one adds classes.
224
+ rerender(
225
+ <FieldStatus
226
+ type="error"
227
+ message="msg"
228
+ data-testid="fs"
229
+ xstyle={testStyles.custom}
230
+ />,
231
+ );
232
+ const withXstyle = screen.getByTestId('fs').getAttribute('class');
233
+ expect(withXstyle).not.toEqual(withoutXstyle);
234
+ });
235
+ });
236
+
237
+ describe('dynamic updates', () => {
238
+ it('updates the rendered message on rerender', () => {
239
+ const {rerender} = render(
240
+ <FieldStatus type="error" message="First" data-testid="fs" />,
241
+ );
242
+ expect(screen.getByTestId('fs')).toHaveTextContent('First');
243
+
244
+ rerender(<FieldStatus type="error" message="Second" data-testid="fs" />);
245
+ expect(screen.getByTestId('fs')).toHaveTextContent('Second');
246
+ });
247
+
248
+ // Switching from error to a non-error type must relax both the role and
249
+ // the live-region politeness in lockstep.
250
+ it('relaxes role and aria-live when type changes from error', () => {
251
+ const {rerender} = render(
252
+ <FieldStatus type="error" message="msg" data-testid="fs" />,
253
+ );
254
+ let el = screen.getByTestId('fs');
255
+ expect(el).toHaveAttribute('role', 'alert');
256
+ expect(el).toHaveAttribute('aria-live', 'assertive');
257
+
258
+ rerender(<FieldStatus type="success" message="msg" data-testid="fs" />);
259
+ el = screen.getByTestId('fs');
260
+ expect(el).toHaveAttribute('role', 'status');
261
+ expect(el).toHaveAttribute('aria-live', 'polite');
262
+ });
263
+ });
264
+
265
+ describe('edge cases', () => {
266
+ it('renders an empty message without crashing', () => {
267
+ render(<FieldStatus type="error" message="" data-testid="fs" />);
268
+ const el = screen.getByTestId('fs');
269
+ expect(el).toBeInTheDocument();
270
+ expect(el).toHaveTextContent('');
271
+ });
272
+
273
+ it('renders message content verbatim, including whitespace-only strings', () => {
274
+ render(<FieldStatus type="warning" message=" " data-testid="fs" />);
275
+ expect(screen.getByTestId('fs').textContent).toBe(' ');
276
+ });
277
+ });
278
+
279
+ it('exposes a displayName for devtools', () => {
280
+ expect(FieldStatus.displayName).toBe('FieldStatus');
281
+ });
282
+ });
@@ -4,7 +4,6 @@ exports[`FormLayout > matches snapshot for horizontal direction 1`] = `
4
4
  <div
5
5
  class="astryx-form-layout horizontal FormLayout__styles.base xdt5ytf x18g69wz FormLayout__styles.horizontal xrvj5dj x1mt1orb xu6a5m6"
6
6
  data-direction="horizontal"
7
- data-style-src="@astryxdesign/core:src/FormLayout/FormLayout.tsx:40; @astryxdesign/core:src/FormLayout/FormLayout.tsx:45"
8
7
  data-testid="layout"
9
8
  >
10
9
  <input
@@ -20,7 +19,6 @@ exports[`FormLayout > matches snapshot for horizontal-labels direction 1`] = `
20
19
  <div
21
20
  class="astryx-form-layout horizontal-labels FormLayout__styles.base xdt5ytf FormLayout__styles.horizontalLabels xrvj5dj x1pmbctz xlaq8a2 x7a106z xedohl4 x1rpgqan x1a1jff"
22
21
  data-direction="horizontal-labels"
23
- data-style-src="@astryxdesign/core:src/FormLayout/FormLayout.tsx:40; @astryxdesign/core:src/FormLayout/FormLayout.tsx:50"
24
22
  data-testid="layout"
25
23
  >
26
24
  <label>
@@ -36,7 +34,6 @@ exports[`FormLayout > matches snapshot for vertical direction 1`] = `
36
34
  <div
37
35
  class="astryx-form-layout vertical FormLayout__styles.base x78zum5 xdt5ytf x18g69wz"
38
36
  data-direction="vertical"
39
- data-style-src="@astryxdesign/core:src/FormLayout/FormLayout.tsx:40"
40
37
  data-testid="layout"
41
38
  >
42
39
  <input
@@ -65,7 +65,7 @@ describe('Grid', () => {
65
65
  expect(templateColumns(grid)).toBe('repeat(auto-fill, minmax(250px, 1fr))');
66
66
  });
67
67
 
68
- it('renders with columns object max (capped via track-max)', () => {
68
+ it('renders with columns object max (count capped, tracks still fill)', () => {
69
69
  render(
70
70
  <Grid columns={{minWidth: 250, max: 3}} gap={4} data-testid="grid">
71
71
  <div>Item 1</div>
@@ -74,13 +74,37 @@ describe('Grid', () => {
74
74
  </Grid>,
75
75
  );
76
76
  const grid = screen.getByTestId('grid');
77
- // Track max caps at (100% - 2 * gap) / 3 — no maxWidth on container
77
+ // Cap lives on the track MIN (min(100%, max(minWidth, perColumn))); the
78
+ // track MAX stays 1fr so present columns fill the row (a lone column on
79
+ // mobile stretches to 100% instead of leaving dead space).
78
80
  expect(templateColumns(grid)).toBe(
79
- 'repeat(auto-fill, minmax(250px, calc((100% - 2 * var(--spacing-4)) / 3)))',
81
+ 'repeat(auto-fill, minmax(min(100%, max(250px, calc((100% - 2 * var(--spacing-4)) / 3))), 1fr))',
80
82
  );
81
83
  expect(grid.style.maxWidth).toBe('');
82
84
  });
83
85
 
86
+ it('keeps track max at 1fr with a max cap so a lone column can fill (#3391)', () => {
87
+ // Regression: previously the cap was applied to the track MAX
88
+ // (minmax(minWidth, 100%/max)), so when fewer than `max` columns fit —
89
+ // e.g. a single column on mobile — the lone column was pinned to ~100%/max
90
+ // and left dead space on the right. The cap now lives on the track MIN and
91
+ // the track MAX stays 1fr, so present columns always stretch to fill.
92
+ render(
93
+ <Grid columns={{minWidth: 360, max: 2}} gap={4} data-testid="grid">
94
+ <div>Left</div>
95
+ <div>Right</div>
96
+ </Grid>,
97
+ );
98
+ const grid = screen.getByTestId('grid');
99
+ const template = templateColumns(grid);
100
+ // Track max must be 1fr (fills), not a fraction-of-container cap.
101
+ expect(template).toMatch(/, 1fr\)\)$/);
102
+ expect(template).not.toMatch(/, calc\([^)]*\/ 2\)\)\)$/);
103
+ expect(template).toBe(
104
+ 'repeat(auto-fill, minmax(min(100%, max(360px, calc((100% - 1 * var(--spacing-4)) / 2))), 1fr))',
105
+ );
106
+ });
107
+
84
108
  it('renders with columns object max using columnGap', () => {
85
109
  render(
86
110
  <Grid columns={{minWidth: 200, max: 4}} columnGap={6} data-testid="grid">
@@ -89,9 +113,9 @@ describe('Grid', () => {
89
113
  </Grid>,
90
114
  );
91
115
  const grid = screen.getByTestId('grid');
92
- // columnGap takes precedence for track-max calculation
116
+ // columnGap takes precedence in the perColumn floor calculation
93
117
  expect(templateColumns(grid)).toBe(
94
- 'repeat(auto-fill, minmax(200px, calc((100% - 3 * var(--spacing-6)) / 4)))',
118
+ 'repeat(auto-fill, minmax(min(100%, max(200px, calc((100% - 3 * var(--spacing-6)) / 4))), 1fr))',
95
119
  );
96
120
  expect(grid.style.maxWidth).toBe('');
97
121
  });
@@ -165,7 +189,7 @@ describe('Grid', () => {
165
189
  expect(templateColumns(grid)).toBe('1fr');
166
190
  });
167
191
 
168
- it('uses auto-fill without track-max cap when no max specified', () => {
192
+ it('uses auto-fill with a plain 1fr track when no max specified', () => {
169
193
  render(
170
194
  <Grid columns={{minWidth: 200}} data-testid="grid">
171
195
  <div>Item</div>
@@ -220,7 +244,7 @@ describe('Grid', () => {
220
244
 
221
245
  // --- P2: columns object + columnGap interaction (hardening #719) ---
222
246
 
223
- it('uses columnGap var in track-max when both columnGap and gap are set', () => {
247
+ it('uses columnGap var in the count-cap floor when both columnGap and gap are set', () => {
224
248
  render(
225
249
  <Grid
226
250
  columns={{minWidth: 200, max: 3}}
@@ -231,14 +255,14 @@ describe('Grid', () => {
231
255
  </Grid>,
232
256
  );
233
257
  const grid = screen.getByTestId('grid');
234
- // columnGap takes precedence over gap in track-max
258
+ // columnGap takes precedence over gap in the perColumn floor
235
259
  expect(templateColumns(grid)).toBe(
236
- 'repeat(auto-fill, minmax(200px, calc((100% - 2 * var(--spacing-6)) / 3)))',
260
+ 'repeat(auto-fill, minmax(min(100%, max(200px, calc((100% - 2 * var(--spacing-6)) / 3))), 1fr))',
237
261
  );
238
262
  expect(grid.style.maxWidth).toBe('');
239
263
  });
240
264
 
241
- it('uses gap var in track-max when columnGap is not set', () => {
265
+ it('uses gap var in the count-cap floor when columnGap is not set', () => {
242
266
  render(
243
267
  <Grid columns={{minWidth: 150, max: 2}} gap={3} data-testid="grid">
244
268
  <div>Item</div>
@@ -246,12 +270,12 @@ describe('Grid', () => {
246
270
  );
247
271
  const grid = screen.getByTestId('grid');
248
272
  expect(templateColumns(grid)).toBe(
249
- 'repeat(auto-fill, minmax(150px, calc((100% - 1 * var(--spacing-3)) / 2)))',
273
+ 'repeat(auto-fill, minmax(min(100%, max(150px, calc((100% - 1 * var(--spacing-3)) / 2))), 1fr))',
250
274
  );
251
275
  expect(grid.style.maxWidth).toBe('');
252
276
  });
253
277
 
254
- it('uses simple fraction in track-max when no gap is set', () => {
278
+ it('uses simple fraction in the count-cap floor when no gap is set', () => {
255
279
  render(
256
280
  <Grid columns={{minWidth: 100, max: 3}} data-testid="grid">
257
281
  <div>Item</div>
@@ -259,7 +283,7 @@ describe('Grid', () => {
259
283
  );
260
284
  const grid = screen.getByTestId('grid');
261
285
  expect(templateColumns(grid)).toBe(
262
- 'repeat(auto-fill, minmax(100px, calc(100% / 3)))',
286
+ 'repeat(auto-fill, minmax(min(100%, max(100px, calc(100% / 3))), 1fr))',
263
287
  );
264
288
  expect(grid.style.maxWidth).toBe('');
265
289
  });
@@ -332,7 +356,7 @@ describe('Grid', () => {
332
356
  expect(templateColumns(grid)).toBe('repeat(auto-fill, minmax(280px, 1fr))');
333
357
  });
334
358
 
335
- it('renders with columns={{minWidth, max}} capping via track-max', () => {
359
+ it('renders with columns={{minWidth, max}} capping the count while filling', () => {
336
360
  render(
337
361
  <Grid columns={{minWidth: 280, max: 3}} gap={4} data-testid="grid">
338
362
  <div>Item 1</div>
@@ -340,14 +364,15 @@ describe('Grid', () => {
340
364
  </Grid>,
341
365
  );
342
366
  const grid = screen.getByTestId('grid');
343
- // Track-max limits columns — grid stays full width
367
+ // Count is capped via the track MIN; track MAX stays 1fr so present
368
+ // columns fill the row (grid stays full width).
344
369
  expect(templateColumns(grid)).toBe(
345
- 'repeat(auto-fill, minmax(280px, calc((100% - 2 * var(--spacing-4)) / 3)))',
370
+ 'repeat(auto-fill, minmax(min(100%, max(280px, calc((100% - 2 * var(--spacing-4)) / 3))), 1fr))',
346
371
  );
347
372
  expect(grid.style.maxWidth).toBe('');
348
373
  });
349
374
 
350
- it('renders with columns={{minWidth, max, repeat: "fit"}} using auto-fit + track-max', () => {
375
+ it('renders with columns={{minWidth, max, repeat: "fit"}} using auto-fit + count cap', () => {
351
376
  render(
352
377
  <Grid
353
378
  columns={{minWidth: 280, max: 3, repeat: 'fit'}}
@@ -359,7 +384,7 @@ describe('Grid', () => {
359
384
  );
360
385
  const grid = screen.getByTestId('grid');
361
386
  expect(templateColumns(grid)).toBe(
362
- 'repeat(auto-fit, minmax(280px, calc((100% - 2 * var(--spacing-4)) / 3)))',
387
+ 'repeat(auto-fit, minmax(min(100%, max(280px, calc((100% - 2 * var(--spacing-4)) / 3))), 1fr))',
363
388
  );
364
389
  expect(grid.style.maxWidth).toBe('');
365
390
  });
package/src/Grid/Grid.tsx CHANGED
@@ -38,9 +38,10 @@ export type GridAlignment = 'start' | 'center' | 'end' | 'stretch';
38
38
  * - `minWidth` — minimum width (px) for each column track
39
39
  * - `repeat` — `'fill'` (default) preserves empty tracks for consistent widths;
40
40
  * `'fit'` collapses empty tracks so items stretch to fill
41
- * - `max` — caps the maximum number of columns by limiting track max size.
42
- * The grid stretches to 100% of its parent; `max` only limits how many
43
- * columns appear.
41
+ * - `max` — caps the maximum number of columns. The grid stretches to 100%
42
+ * of its parent and the columns that are present always fill the row, so a
43
+ * layout collapsing to a single column on mobile stretches to full width
44
+ * (no dead space on the right).
44
45
  */
45
46
  export type GridColumns =
46
47
  | number
@@ -321,9 +322,20 @@ const spacingVarNames: Record<SpacingStep, string> = {
321
322
  };
322
323
 
323
324
  /**
324
- * Build a grid-template-columns value that caps columns at `max` by
325
- * limiting each track's max size to `(100% - (max-1) * gap) / max`.
326
- * The grid stays 100% width; the track-max prevents more than `max` columns.
325
+ * Build a grid-template-columns value that caps the column *count* at `max`
326
+ * while still letting the columns that are actually present stretch to fill
327
+ * the row.
328
+ *
329
+ * The cap lives on the track's **min** size, not its max: each track is at
330
+ * least `perColumn = (100% - (max-1) * gap) / max`, so more than `max` columns
331
+ * can never fit. The track **max** stays `1fr`, so whenever fewer than `max`
332
+ * columns fit (most importantly a lone column on mobile) they still grow to
333
+ * fill the whole row — no dead space on the right.
334
+ *
335
+ * The track min is `max(minWidth, perColumn)` so an explicit `minWidth` is
336
+ * still honored, wrapped in `min(100%, …)` so a single column on a viewport
337
+ * narrower than `minWidth`/`perColumn` shrinks to the container instead of
338
+ * overflowing it.
327
339
  */
328
340
  function buildCappedTemplate(
329
341
  minWidth: number,
@@ -339,12 +351,17 @@ function buildCappedTemplate(
339
351
  ? spacingVarNames[gap]
340
352
  : null;
341
353
 
342
- // trackMax = (100% - (maxCols - 1) * gap) / maxCols
343
- const trackMax = gapVar
354
+ // perColumn = (100% - (maxCols - 1) * gap) / maxCols — the width a track
355
+ // would have if exactly `maxCols` columns were present. Used as a floor so
356
+ // the grid never fits more than `maxCols` columns.
357
+ const perColumn = gapVar
344
358
  ? `calc((100% - ${maxCols - 1} * var(${gapVar})) / ${maxCols})`
345
359
  : `calc(100% / ${maxCols})`;
346
360
 
347
- return `repeat(${repeatMode}, minmax(${minWidth}px, ${trackMax}))`;
361
+ // Track min caps the count; track max stays 1fr so present columns fill.
362
+ const trackMin = `min(100%, max(${minWidth}px, ${perColumn}))`;
363
+
364
+ return `repeat(${repeatMode}, minmax(${trackMin}, 1fr))`;
348
365
  }
349
366
 
350
367
  /**
@@ -46,13 +46,13 @@ export const docs = {
46
46
  {
47
47
  name: 'placement',
48
48
  type: "'above' | 'below' | 'start' | 'end'",
49
- description: 'Position relative to the anchor element.',
49
+ description: "Position relative to the anchor element. Logical: start/end resolve against the popover\'s own inherited direction (RTL mirrors in pure CSS).",
50
50
  default: "'above'",
51
51
  },
52
52
  {
53
53
  name: 'alignment',
54
54
  type: "'start' | 'center' | 'end'",
55
- description: 'Alignment along the placement axis.',
55
+ description: "Alignment along the placement axis. Logical: start/end resolve against the popover\'s own inherited direction (RTL mirrors in pure CSS).",
56
56
  default: "'center'",
57
57
  },
58
58
  {
@@ -155,13 +155,13 @@ export const docsZh = {
155
155
  {
156
156
  name: 'placement',
157
157
  type: "'above' | 'below' | 'start' | 'end'",
158
- description: '相对于锚点元素的位置。',
158
+ description: '相对于锚点元素的位置。逻辑值:start/end 根据弹出层自身继承的方向解析(RTL 镜像)。',
159
159
  default: "'above'",
160
160
  },
161
161
  {
162
162
  name: 'alignment',
163
163
  type: "'start' | 'center' | 'end'",
164
- description: '沿放置轴的对齐方式。',
164
+ description: '沿放置轴的对齐方式。逻辑值:start/end 根据弹出层自身继承的方向解析(RTL 镜像)。',
165
165
  default: "'center'",
166
166
  },
167
167
  {
@@ -246,8 +246,8 @@ export const docsDense = {
246
246
  propDescriptions: {
247
247
  children: 'Trigger element; must accept ref.',
248
248
  content: 'Hover card content.',
249
- placement: 'Position relative to anchor element.',
250
- alignment: 'Alignment along placement axis.',
249
+ placement: 'Position relative to anchor element. Logical: start/end follow the popover\'s inherited direction (RTL mirrors).',
250
+ alignment: 'Alignment along placement axis. Logical: start/end follow the popover\'s inherited direction (RTL mirrors).',
251
251
  delay: 'Show delay in ms.',
252
252
  hideDelay: 'Hide delay in ms.',
253
253
  focusTrigger: 'Controls when focus events trigger hover card.',