@astryxdesign/core 0.1.8 → 0.1.9-canary.02ef052

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 (728) hide show
  1. package/CHANGELOG.md +100 -0
  2. package/dist/AppShell/AppShell.d.ts.map +1 -1
  3. package/dist/AppShell/AppShell.js +6 -2
  4. package/dist/AppShell/AppShellMobileContext.d.ts +8 -0
  5. package/dist/AppShell/AppShellMobileContext.d.ts.map +1 -1
  6. package/dist/Avatar/Avatar.d.ts +58 -3
  7. package/dist/Avatar/Avatar.d.ts.map +1 -1
  8. package/dist/Avatar/Avatar.js +240 -53
  9. package/dist/Avatar/AvatarStatusDot.d.ts +35 -5
  10. package/dist/Avatar/AvatarStatusDot.d.ts.map +1 -1
  11. package/dist/Avatar/AvatarStatusDot.js +144 -19
  12. package/dist/AvatarGroup/AvatarGroup.d.ts +7 -1
  13. package/dist/AvatarGroup/AvatarGroup.d.ts.map +1 -1
  14. package/dist/AvatarGroup/AvatarGroup.js +58 -6
  15. package/dist/AvatarGroup/AvatarGroupOverflow.d.ts.map +1 -1
  16. package/dist/AvatarGroup/AvatarGroupOverflow.js +1 -0
  17. package/dist/Banner/Banner.d.ts +9 -1
  18. package/dist/Banner/Banner.d.ts.map +1 -1
  19. package/dist/Banner/Banner.js +33 -4
  20. package/dist/Breadcrumbs/BreadcrumbItem.d.ts +31 -2
  21. package/dist/Breadcrumbs/BreadcrumbItem.d.ts.map +1 -1
  22. package/dist/Breadcrumbs/BreadcrumbItem.js +215 -6
  23. package/dist/Breadcrumbs/index.d.ts +6 -0
  24. package/dist/Breadcrumbs/index.d.ts.map +1 -1
  25. package/dist/Breadcrumbs/index.js +10 -1
  26. package/dist/Button/Button.d.ts +8 -2
  27. package/dist/Button/Button.d.ts.map +1 -1
  28. package/dist/Button/Button.js +33 -4
  29. package/dist/ButtonGroup/ButtonGroup.d.ts +9 -1
  30. package/dist/ButtonGroup/ButtonGroup.d.ts.map +1 -1
  31. package/dist/ButtonGroup/ButtonGroup.js +30 -1
  32. package/dist/Calendar/Calendar.d.ts.map +1 -1
  33. package/dist/Calendar/Calendar.js +80 -11
  34. package/dist/Calendar/dayCellUtils.d.ts +4 -4
  35. package/dist/Calendar/dayCellUtils.js +3 -3
  36. package/dist/Calendar/styles.d.ts +30 -31
  37. package/dist/Calendar/styles.d.ts.map +1 -1
  38. package/dist/Calendar/styles.js +30 -31
  39. package/dist/Card/Card.d.ts +8 -2
  40. package/dist/Card/Card.d.ts.map +1 -1
  41. package/dist/Card/Card.js +28 -2
  42. package/dist/Carousel/Carousel.d.ts +4 -1
  43. package/dist/Carousel/Carousel.d.ts.map +1 -1
  44. package/dist/Carousel/Carousel.js +46 -16
  45. package/dist/Chat/ChatComposer.d.ts +8 -0
  46. package/dist/Chat/ChatComposer.d.ts.map +1 -1
  47. package/dist/Chat/ChatComposer.js +46 -7
  48. package/dist/Chat/ChatComposerDrawer.d.ts +2 -0
  49. package/dist/Chat/ChatComposerDrawer.d.ts.map +1 -1
  50. package/dist/Chat/ChatComposerDrawer.js +11 -1
  51. package/dist/Chat/ChatComposerInput.d.ts +20 -3
  52. package/dist/Chat/ChatComposerInput.d.ts.map +1 -1
  53. package/dist/Chat/ChatComposerInput.js +36 -4
  54. package/dist/Chat/ChatContext.d.ts +33 -0
  55. package/dist/Chat/ChatContext.d.ts.map +1 -1
  56. package/dist/Chat/ChatContext.js +16 -2
  57. package/dist/Chat/ChatDictationButton.d.ts.map +1 -1
  58. package/dist/Chat/ChatDictationButton.js +4 -2
  59. package/dist/Chat/ChatLayout.d.ts.map +1 -1
  60. package/dist/Chat/ChatLayout.js +4 -4
  61. package/dist/Chat/ChatLayoutScrollButton.d.ts.map +1 -1
  62. package/dist/Chat/ChatLayoutScrollButton.js +4 -4
  63. package/dist/Chat/ChatMessageMetadata.d.ts.map +1 -1
  64. package/dist/Chat/ChatSendButton.d.ts.map +1 -1
  65. package/dist/Chat/ChatSendButton.js +7 -1
  66. package/dist/Chat/ChatToolCalls.d.ts +5 -1
  67. package/dist/Chat/ChatToolCalls.d.ts.map +1 -1
  68. package/dist/Chat/ChatToolCalls.js +27 -11
  69. package/dist/Chat/index.d.ts +2 -1
  70. package/dist/Chat/index.d.ts.map +1 -1
  71. package/dist/Chat/index.js +1 -1
  72. package/dist/Chat/useChatStreamScroll.d.ts +2 -1
  73. package/dist/Chat/useChatStreamScroll.d.ts.map +1 -1
  74. package/dist/Chat/useChatStreamScroll.js +22 -8
  75. package/dist/Chat/useSpeechRecognition.d.ts +0 -1
  76. package/dist/Chat/useSpeechRecognition.d.ts.map +1 -1
  77. package/dist/Chat/useSpeechRecognition.js +1 -1
  78. package/dist/Chat/useTriggerMenu.d.ts.map +1 -1
  79. package/dist/Chat/useTriggerMenu.js +2 -2
  80. package/dist/CheckboxInput/CheckboxInput.js +5 -5
  81. package/dist/CheckboxList/CheckboxListItem.d.ts +20 -1
  82. package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
  83. package/dist/CheckboxList/CheckboxListItem.js +11 -1
  84. package/dist/Citation/Citation.d.ts +22 -1
  85. package/dist/Citation/Citation.d.ts.map +1 -1
  86. package/dist/Citation/Citation.js +20 -6
  87. package/dist/ClickableCard/ClickableCard.d.ts +9 -2
  88. package/dist/ClickableCard/ClickableCard.d.ts.map +1 -1
  89. package/dist/ClickableCard/ClickableCard.js +5 -2
  90. package/dist/CodeBlock/CodeBlock.d.ts.map +1 -1
  91. package/dist/CodeBlock/CodeBlock.js +22 -9
  92. package/dist/Collapsible/Collapsible.d.ts.map +1 -1
  93. package/dist/Collapsible/Collapsible.js +3 -1
  94. package/dist/CommandPalette/CommandPalette.d.ts +2 -2
  95. package/dist/CommandPalette/CommandPalette.d.ts.map +1 -1
  96. package/dist/CommandPalette/CommandPalette.js +45 -4
  97. package/dist/CommandPalette/CommandPaletteGroup.d.ts.map +1 -1
  98. package/dist/CommandPalette/CommandPaletteGroup.js +9 -2
  99. package/dist/CommandPalette/CommandPaletteInput.d.ts +7 -1
  100. package/dist/CommandPalette/CommandPaletteInput.d.ts.map +1 -1
  101. package/dist/CommandPalette/CommandPaletteInput.js +6 -1
  102. package/dist/CommandPalette/CommandPaletteItem.js +1 -1
  103. package/dist/ContextMenu/ContextMenu.d.ts.map +1 -1
  104. package/dist/ContextMenu/ContextMenu.js +14 -5
  105. package/dist/ContextMenu/index.d.ts +1 -0
  106. package/dist/ContextMenu/index.d.ts.map +1 -1
  107. package/dist/ContextMenu/index.js +3 -1
  108. package/dist/DateInput/DateInput.d.ts +56 -2
  109. package/dist/DateInput/DateInput.d.ts.map +1 -1
  110. package/dist/DateInput/DateInput.js +59 -21
  111. package/dist/DateInput/index.d.ts +1 -1
  112. package/dist/DateInput/index.d.ts.map +1 -1
  113. package/dist/DateRangeInput/DateRangeInput.d.ts +10 -2
  114. package/dist/DateRangeInput/DateRangeInput.d.ts.map +1 -1
  115. package/dist/DateRangeInput/DateRangeInput.js +23 -20
  116. package/dist/DateTimeInput/DateTimeInput.d.ts.map +1 -1
  117. package/dist/DateTimeInput/DateTimeInput.js +33 -19
  118. package/dist/Dialog/Dialog.d.ts +3 -0
  119. package/dist/Dialog/Dialog.d.ts.map +1 -1
  120. package/dist/Dialog/Dialog.js +57 -6
  121. package/dist/Dialog/DialogContext.d.ts +7 -0
  122. package/dist/Dialog/DialogContext.d.ts.map +1 -1
  123. package/dist/Dialog/DialogContext.js +2 -2
  124. package/dist/Dialog/DialogHeader.d.ts +5 -2
  125. package/dist/Dialog/DialogHeader.d.ts.map +1 -1
  126. package/dist/Dialog/DialogHeader.js +6 -1
  127. package/dist/Divider/Divider.js +1 -1
  128. package/dist/DropdownMenu/DropdownMenu.d.ts +6 -0
  129. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  130. package/dist/DropdownMenu/DropdownMenu.js +22 -5
  131. package/dist/DropdownMenu/DropdownMenuCheckboxItem.d.ts +1 -2
  132. package/dist/DropdownMenu/DropdownMenuCheckboxItem.d.ts.map +1 -1
  133. package/dist/DropdownMenu/DropdownMenuCheckboxItem.js +5 -3
  134. package/dist/DropdownMenu/DropdownMenuItem.d.ts.map +1 -1
  135. package/dist/DropdownMenu/DropdownMenuItem.js +5 -2
  136. package/dist/DropdownMenu/DropdownMenuRadioGroup.d.ts +1 -2
  137. package/dist/DropdownMenu/DropdownMenuRadioGroup.d.ts.map +1 -1
  138. package/dist/DropdownMenu/DropdownMenuRadioGroup.js +1 -2
  139. package/dist/DropdownMenu/DropdownMenuRadioItem.d.ts.map +1 -1
  140. package/dist/DropdownMenu/DropdownMenuRadioItem.js +4 -1
  141. package/dist/DropdownMenu/DropdownMenuSubMenu.d.ts +104 -0
  142. package/dist/DropdownMenu/DropdownMenuSubMenu.d.ts.map +1 -0
  143. package/dist/DropdownMenu/DropdownMenuSubMenu.js +427 -0
  144. package/dist/DropdownMenu/index.d.ts +10 -0
  145. package/dist/DropdownMenu/index.d.ts.map +1 -1
  146. package/dist/DropdownMenu/index.js +13 -0
  147. package/dist/DropdownMenu/menuItemHover.d.ts +23 -0
  148. package/dist/DropdownMenu/menuItemHover.d.ts.map +1 -0
  149. package/dist/DropdownMenu/menuItemHover.js +33 -0
  150. package/dist/DropdownMenu/menuItemRoles.d.ts +8 -0
  151. package/dist/DropdownMenu/menuItemRoles.d.ts.map +1 -1
  152. package/dist/DropdownMenu/menuItemRoles.js +10 -1
  153. package/dist/DropdownMenu/renderDropdownItems.d.ts.map +1 -1
  154. package/dist/DropdownMenu/renderDropdownItems.js +21 -6
  155. package/dist/Field/Field.d.ts +3 -1
  156. package/dist/Field/Field.d.ts.map +1 -1
  157. package/dist/Field/Field.js +6 -4
  158. package/dist/Field/FieldLabel.d.ts +1 -1
  159. package/dist/Field/FieldLabel.d.ts.map +1 -1
  160. package/dist/Field/FieldLabel.js +43 -16
  161. package/dist/Field/inputStyles.stylex.d.ts +1 -0
  162. package/dist/Field/inputStyles.stylex.d.ts.map +1 -1
  163. package/dist/Field/inputStyles.stylex.js +1 -0
  164. package/dist/FieldStatus/FieldStatus.d.ts +18 -0
  165. package/dist/FieldStatus/FieldStatus.d.ts.map +1 -1
  166. package/dist/FieldStatus/FieldStatus.js +60 -6
  167. package/dist/FileInput/FileInput.d.ts +10 -2
  168. package/dist/FileInput/FileInput.d.ts.map +1 -1
  169. package/dist/FileInput/FileInput.js +54 -35
  170. package/dist/HoverCard/HoverCard.d.ts +9 -1
  171. package/dist/HoverCard/HoverCard.d.ts.map +1 -1
  172. package/dist/HoverCard/HoverCard.js +2 -0
  173. package/dist/HoverCard/useHoverCard.d.ts +8 -0
  174. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  175. package/dist/HoverCard/useHoverCard.js +17 -6
  176. package/dist/Icon/Icon.d.ts +22 -3
  177. package/dist/Icon/Icon.d.ts.map +1 -1
  178. package/dist/Icon/Icon.js +19 -3
  179. package/dist/Item/Item.d.ts +6 -1
  180. package/dist/Item/Item.d.ts.map +1 -1
  181. package/dist/Item/Item.js +22 -1
  182. package/dist/Layer/useLayer.d.ts +6 -0
  183. package/dist/Layer/useLayer.d.ts.map +1 -1
  184. package/dist/Layer/useLayer.js +2 -0
  185. package/dist/Lightbox/Lightbox.d.ts.map +1 -1
  186. package/dist/Lightbox/Lightbox.js +19 -13
  187. package/dist/Markdown/Markdown.d.ts.map +1 -1
  188. package/dist/Markdown/Markdown.js +7 -0
  189. package/dist/MobileNav/MobileNav.d.ts.map +1 -1
  190. package/dist/MobileNav/MobileNav.js +6 -1
  191. package/dist/MobileNav/MobileNavToggle.d.ts.map +1 -1
  192. package/dist/MobileNav/MobileNavToggle.js +4 -0
  193. package/dist/MultiSelector/MultiSelector.d.ts +9 -1
  194. package/dist/MultiSelector/MultiSelector.d.ts.map +1 -1
  195. package/dist/MultiSelector/MultiSelector.js +104 -50
  196. package/dist/MultiSelector/hooks.d.ts.map +1 -1
  197. package/dist/MultiSelector/hooks.js +16 -0
  198. package/dist/NavMenu/NavHeadingMenuItem.js +1 -1
  199. package/dist/NumberInput/NumberInput.d.ts +10 -2
  200. package/dist/NumberInput/NumberInput.d.ts.map +1 -1
  201. package/dist/NumberInput/NumberInput.js +22 -17
  202. package/dist/Outline/Outline.d.ts +0 -1
  203. package/dist/Outline/Outline.d.ts.map +1 -1
  204. package/dist/Outline/Outline.js +0 -1
  205. package/dist/OverflowList/OverflowList.d.ts +20 -3
  206. package/dist/OverflowList/OverflowList.d.ts.map +1 -1
  207. package/dist/OverflowList/OverflowList.js +29 -4
  208. package/dist/Pagination/Pagination.d.ts.map +1 -1
  209. package/dist/Pagination/Pagination.js +11 -3
  210. package/dist/Popover/Popover.d.ts.map +1 -1
  211. package/dist/Popover/Popover.js +3 -2
  212. package/dist/Popover/usePopover.d.ts.map +1 -1
  213. package/dist/Popover/usePopover.js +3 -9
  214. package/dist/PowerSearch/PowerSearch.d.ts +9 -2
  215. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  216. package/dist/PowerSearch/PowerSearch.js +2 -0
  217. package/dist/PowerSearch/PowerSearchEditPopover.js +1 -1
  218. package/dist/PowerSearch/usePowerSearchSource.d.ts.map +1 -1
  219. package/dist/RadioList/RadioList.d.ts +2 -2
  220. package/dist/RadioList/RadioListItem.js +4 -4
  221. package/dist/SegmentedControl/SegmentedControlItem.d.ts +1 -1
  222. package/dist/SegmentedControl/SegmentedControlItem.d.ts.map +1 -1
  223. package/dist/SegmentedControl/SegmentedControlItem.js +2 -1
  224. package/dist/SelectableCard/SelectableCard.d.ts +9 -2
  225. package/dist/SelectableCard/SelectableCard.d.ts.map +1 -1
  226. package/dist/SelectableCard/SelectableCard.js +16 -13
  227. package/dist/Selector/Selector.d.ts +8 -0
  228. package/dist/Selector/Selector.d.ts.map +1 -1
  229. package/dist/Selector/Selector.js +65 -19
  230. package/dist/Selector/hooks.d.ts.map +1 -1
  231. package/dist/Selector/hooks.js +16 -0
  232. package/dist/SideNav/SideNav.d.ts.map +1 -1
  233. package/dist/SideNav/SideNav.js +5 -5
  234. package/dist/SideNav/SideNavCollapseButton.d.ts.map +1 -1
  235. package/dist/SideNav/SideNavCollapseButton.js +13 -10
  236. package/dist/SideNav/SideNavHeading.d.ts.map +1 -1
  237. package/dist/SideNav/SideNavHeading.js +21 -8
  238. package/dist/SideNav/SideNavItem.d.ts +1 -1
  239. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  240. package/dist/SideNav/SideNavItem.js +12 -10
  241. package/dist/Slider/Slider.d.ts.map +1 -1
  242. package/dist/Slider/Slider.js +106 -36
  243. package/dist/Stack/stack.stylex.d.ts +9 -9
  244. package/dist/Switch/Switch.d.ts +8 -1
  245. package/dist/Switch/Switch.d.ts.map +1 -1
  246. package/dist/Switch/Switch.js +160 -91
  247. package/dist/TabList/Tab.js +2 -2
  248. package/dist/TabList/TabMenu.js +1 -1
  249. package/dist/Table/BaseTable.d.ts.map +1 -1
  250. package/dist/Table/BaseTable.js +33 -6
  251. package/dist/Table/TableCell.js +3 -3
  252. package/dist/Table/TableHeaderCell.js +3 -3
  253. package/dist/Table/index.d.ts +2 -0
  254. package/dist/Table/index.d.ts.map +1 -1
  255. package/dist/Table/index.js +1 -0
  256. package/dist/Table/plugins/groupedRows/useTableGroupedRows.d.ts.map +1 -1
  257. package/dist/Table/plugins/groupedRows/useTableGroupedRows.js +15 -11
  258. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.d.ts.map +1 -1
  259. package/dist/Table/plugins/rowExpansion/useTableRowExpansion.js +36 -26
  260. package/dist/Table/plugins/rowStatus/index.d.ts +3 -0
  261. package/dist/Table/plugins/rowStatus/index.d.ts.map +1 -0
  262. package/dist/Table/plugins/rowStatus/index.js +3 -0
  263. package/dist/Table/plugins/rowStatus/useTableRowStatus.d.ts +60 -0
  264. package/dist/Table/plugins/rowStatus/useTableRowStatus.d.ts.map +1 -0
  265. package/dist/Table/plugins/rowStatus/useTableRowStatus.js +145 -0
  266. package/dist/Table/plugins/selection/useTableSelection.d.ts +13 -0
  267. package/dist/Table/plugins/selection/useTableSelection.d.ts.map +1 -1
  268. package/dist/Table/plugins/selection/useTableSelection.js +7 -1
  269. package/dist/Table/plugins/stickyColumns/useTableStickyColumns.js +1 -1
  270. package/dist/Table/plugins/tree/useTableTreeData.d.ts +16 -0
  271. package/dist/Table/plugins/tree/useTableTreeData.d.ts.map +1 -1
  272. package/dist/Table/plugins/tree/useTableTreeData.js +105 -12
  273. package/dist/Table/plugins/tree/useTableTreeState.d.ts +6 -0
  274. package/dist/Table/plugins/tree/useTableTreeState.d.ts.map +1 -1
  275. package/dist/Table/plugins/tree/useTableTreeState.js +22 -1
  276. package/dist/Table/types.d.ts +32 -0
  277. package/dist/Table/types.d.ts.map +1 -1
  278. package/dist/Table/useBaseTablePlugins.d.ts.map +1 -1
  279. package/dist/Table/useBaseTablePlugins.js +5 -3
  280. package/dist/TextArea/TextArea.d.ts +10 -1
  281. package/dist/TextArea/TextArea.d.ts.map +1 -1
  282. package/dist/TextArea/TextArea.js +18 -19
  283. package/dist/TextInput/TextInput.d.ts +10 -2
  284. package/dist/TextInput/TextInput.d.ts.map +1 -1
  285. package/dist/TextInput/TextInput.js +20 -17
  286. package/dist/Thumbnail/Thumbnail.d.ts +26 -5
  287. package/dist/Thumbnail/Thumbnail.d.ts.map +1 -1
  288. package/dist/Thumbnail/Thumbnail.js +97 -54
  289. package/dist/Thumbnail/thumbnail.markers.stylex.d.ts +9 -0
  290. package/dist/Thumbnail/thumbnail.markers.stylex.d.ts.map +1 -0
  291. package/dist/Thumbnail/thumbnail.markers.stylex.js +14 -0
  292. package/dist/TimeInput/TimeInput.d.ts +10 -2
  293. package/dist/TimeInput/TimeInput.d.ts.map +1 -1
  294. package/dist/TimeInput/TimeInput.js +32 -21
  295. package/dist/Timestamp/Timestamp.d.ts +3 -1
  296. package/dist/Timestamp/Timestamp.d.ts.map +1 -1
  297. package/dist/Timestamp/Timestamp.js +8 -6
  298. package/dist/Toast/useToast.d.ts.map +1 -1
  299. package/dist/Toast/useToast.js +2 -5
  300. package/dist/ToggleButton/ToggleButtonGroup.d.ts +0 -1
  301. package/dist/ToggleButton/ToggleButtonGroup.d.ts.map +1 -1
  302. package/dist/ToggleButton/ToggleButtonGroup.js +1 -1
  303. package/dist/Token/Token.d.ts +30 -3
  304. package/dist/Token/Token.d.ts.map +1 -1
  305. package/dist/Token/Token.js +17 -2
  306. package/dist/Token/index.d.ts +1 -1
  307. package/dist/Token/index.d.ts.map +1 -1
  308. package/dist/Tokenizer/Tokenizer.d.ts +10 -3
  309. package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
  310. package/dist/Tokenizer/Tokenizer.js +20 -6
  311. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  312. package/dist/Tooltip/useTooltip.js +17 -1
  313. package/dist/TopNav/TopNavHeading.d.ts.map +1 -1
  314. package/dist/TopNav/TopNavHeading.js +18 -8
  315. package/dist/TopNav/TopNavMegaMenu.js +10 -4
  316. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts +9 -1
  317. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts.map +1 -1
  318. package/dist/TopNav/TopNavMegaMenuFeaturedCard.js +8 -1
  319. package/dist/TopNav/TopNavMenu.d.ts +2 -1
  320. package/dist/TopNav/TopNavMenu.d.ts.map +1 -1
  321. package/dist/TopNav/TopNavMenu.js +68 -6
  322. package/dist/TreeList/TreeList.d.ts +12 -3
  323. package/dist/TreeList/TreeList.d.ts.map +1 -1
  324. package/dist/TreeList/TreeList.js +3 -0
  325. package/dist/TreeList/TreeListBranches.d.ts +5 -0
  326. package/dist/TreeList/TreeListBranches.d.ts.map +1 -1
  327. package/dist/TreeList/TreeListBranches.js +18 -10
  328. package/dist/TreeList/TreeListItem.d.ts +8 -2
  329. package/dist/TreeList/TreeListItem.d.ts.map +1 -1
  330. package/dist/TreeList/TreeListItem.js +59 -21
  331. package/dist/TreeList/TreeListTypes.d.ts +25 -1
  332. package/dist/TreeList/TreeListTypes.d.ts.map +1 -1
  333. package/dist/TreeList/index.d.ts +2 -2
  334. package/dist/TreeList/index.d.ts.map +1 -1
  335. package/dist/Typeahead/BaseTypeahead.d.ts.map +1 -1
  336. package/dist/Typeahead/BaseTypeahead.js +20 -11
  337. package/dist/Typeahead/Typeahead.d.ts +9 -2
  338. package/dist/Typeahead/Typeahead.d.ts.map +1 -1
  339. package/dist/Typeahead/Typeahead.js +3 -1
  340. package/dist/Typeahead/TypeaheadItem.d.ts +1 -1
  341. package/dist/Typeahead/TypeaheadItem.d.ts.map +1 -1
  342. package/dist/Typeahead/TypeaheadItem.js +20 -10
  343. package/dist/astryx.css +61 -39
  344. package/dist/astryx.umd.js +53 -53
  345. package/dist/astryx.umd.js.map +4 -4
  346. package/dist/authoring/doc.d.ts.map +1 -1
  347. package/dist/docs-types.d.ts +8 -0
  348. package/dist/docs-types.d.ts.map +1 -1
  349. package/dist/hooks/computeOverflow.d.ts +47 -0
  350. package/dist/hooks/computeOverflow.d.ts.map +1 -0
  351. package/dist/hooks/computeOverflow.js +213 -0
  352. package/dist/hooks/index.d.ts +3 -0
  353. package/dist/hooks/index.d.ts.map +1 -1
  354. package/dist/hooks/index.js +3 -1
  355. package/dist/hooks/isRtlElement.d.ts +18 -0
  356. package/dist/hooks/isRtlElement.d.ts.map +1 -0
  357. package/dist/hooks/isRtlElement.js +27 -0
  358. package/dist/hooks/useDevWarning.d.ts +18 -0
  359. package/dist/hooks/useDevWarning.d.ts.map +1 -0
  360. package/dist/hooks/useDevWarning.js +49 -0
  361. package/dist/hooks/useGridFocus.d.ts +6 -1
  362. package/dist/hooks/useGridFocus.d.ts.map +1 -1
  363. package/dist/hooks/useGridFocus.js +12 -9
  364. package/dist/hooks/useInputStatusIcon.d.ts +38 -0
  365. package/dist/hooks/useInputStatusIcon.d.ts.map +1 -0
  366. package/dist/hooks/useInputStatusIcon.js +158 -0
  367. package/dist/hooks/useListFocus.d.ts +39 -1
  368. package/dist/hooks/useListFocus.d.ts.map +1 -1
  369. package/dist/hooks/useListFocus.js +54 -9
  370. package/dist/hooks/useOverflow.d.ts +19 -0
  371. package/dist/hooks/useOverflow.d.ts.map +1 -1
  372. package/dist/hooks/useOverflow.js +36 -25
  373. package/dist/i18n/InternationalizationContext.d.ts +1 -0
  374. package/dist/i18n/InternationalizationContext.d.ts.map +1 -1
  375. package/dist/i18n/InternationalizationContext.js +3 -0
  376. package/dist/i18n/InternationalizationProvider.d.ts +8 -1
  377. package/dist/i18n/InternationalizationProvider.d.ts.map +1 -1
  378. package/dist/i18n/InternationalizationProvider.js +5 -1
  379. package/dist/i18n/getLocaleDirection.d.ts +18 -0
  380. package/dist/i18n/getLocaleDirection.d.ts.map +1 -0
  381. package/dist/i18n/getLocaleDirection.js +29 -0
  382. package/dist/i18n/index.d.ts +6 -0
  383. package/dist/i18n/index.d.ts.map +1 -1
  384. package/dist/i18n/index.js +7 -1
  385. package/dist/i18n/resolve.d.ts.map +1 -1
  386. package/dist/i18n/resolve.js +7 -18
  387. package/dist/i18n/useDirection.d.ts +2 -0
  388. package/dist/i18n/useDirection.d.ts.map +1 -0
  389. package/dist/i18n/useDirection.js +27 -0
  390. package/dist/theme/Theme.d.ts.map +1 -1
  391. package/dist/theme/Theme.js +2 -7
  392. package/dist/theme/derivedVarRegistry.d.ts.map +1 -1
  393. package/dist/theme/derivedVarRegistry.js +13 -0
  394. package/dist/theme/generateThemeRules.d.ts.map +1 -1
  395. package/dist/theme/generateThemeRules.js +51 -0
  396. package/dist/theme/hct.d.ts +0 -1
  397. package/dist/theme/hct.d.ts.map +1 -1
  398. package/dist/theme/hct.js +1 -1
  399. package/dist/theme/syntax/defineSyntaxTheme.d.ts.map +1 -1
  400. package/dist/theme/syntax/defineSyntaxTheme.js +2 -1
  401. package/dist/utils/devWarning.d.ts +42 -0
  402. package/dist/utils/devWarning.d.ts.map +1 -0
  403. package/dist/utils/devWarning.js +88 -0
  404. package/dist/utils/index.d.ts +4 -1
  405. package/dist/utils/index.d.ts.map +1 -1
  406. package/dist/utils/index.js +4 -2
  407. package/dist/utils/plainDate.d.ts +30 -0
  408. package/dist/utils/plainDate.d.ts.map +1 -1
  409. package/dist/utils/plainDate.js +65 -3
  410. package/dist/utils/rtlStyles.d.ts +24 -0
  411. package/dist/utils/rtlStyles.d.ts.map +1 -0
  412. package/dist/utils/rtlStyles.js +27 -0
  413. package/dist/utils/types.d.ts +13 -0
  414. package/dist/utils/types.d.ts.map +1 -1
  415. package/locales/en.json +104 -0
  416. package/locales/fr-FR.json +14 -0
  417. package/locales/pseudo.json +78 -0
  418. package/package.json +6 -1
  419. package/src/AppShell/AppShell.tsx +6 -0
  420. package/src/AppShell/AppShellMobileContext.tsx +8 -0
  421. package/src/AppShell/useAppShellMobile.doc.mjs +8 -0
  422. package/src/Avatar/Avatar.doc.mjs +64 -5
  423. package/src/Avatar/Avatar.test.tsx +374 -1
  424. package/src/Avatar/Avatar.tsx +367 -69
  425. package/src/Avatar/AvatarStatusDot.doc.mjs +23 -12
  426. package/src/Avatar/AvatarStatusDot.test.tsx +284 -0
  427. package/src/Avatar/AvatarStatusDot.tsx +180 -21
  428. package/src/AvatarGroup/AvatarGroup.doc.mjs +2 -0
  429. package/src/AvatarGroup/AvatarGroup.test.tsx +141 -1
  430. package/src/AvatarGroup/AvatarGroup.tsx +58 -3
  431. package/src/AvatarGroup/AvatarGroupOverflow.tsx +1 -0
  432. package/src/Banner/Banner.doc.mjs +9 -0
  433. package/src/Banner/Banner.test.tsx +30 -0
  434. package/src/Banner/Banner.tsx +53 -9
  435. package/src/Breadcrumbs/BreadcrumbItem.doc.mjs +26 -0
  436. package/src/Breadcrumbs/BreadcrumbItem.tsx +333 -14
  437. package/src/Breadcrumbs/Breadcrumbs.doc.mjs +2 -0
  438. package/src/Breadcrumbs/Breadcrumbs.test.tsx +335 -2
  439. package/src/Breadcrumbs/index.ts +31 -0
  440. package/src/Button/Button.doc.mjs +9 -4
  441. package/src/Button/Button.test.tsx +49 -0
  442. package/src/Button/Button.tsx +27 -3
  443. package/src/ButtonGroup/ButtonGroup.doc.mjs +3 -0
  444. package/src/ButtonGroup/ButtonGroup.test.tsx +37 -0
  445. package/src/ButtonGroup/ButtonGroup.tsx +32 -0
  446. package/src/Calendar/Calendar.doc.mjs +12 -1
  447. package/src/Calendar/Calendar.test.tsx +362 -19
  448. package/src/Calendar/Calendar.tsx +111 -32
  449. package/src/Calendar/dayCellUtils.test.ts +23 -18
  450. package/src/Calendar/dayCellUtils.ts +3 -3
  451. package/src/Calendar/styles.ts +33 -39
  452. package/src/Card/Card.doc.mjs +9 -0
  453. package/src/Card/Card.test.tsx +21 -3
  454. package/src/Card/Card.tsx +35 -2
  455. package/src/Carousel/Carousel.doc.mjs +1 -0
  456. package/src/Carousel/Carousel.test.tsx +53 -0
  457. package/src/Carousel/Carousel.tsx +59 -10
  458. package/src/Chat/ChatComposer.doc.mjs +12 -3
  459. package/src/Chat/ChatComposer.test.tsx +115 -0
  460. package/src/Chat/ChatComposer.tsx +73 -9
  461. package/src/Chat/ChatComposerDrawer.test.tsx +61 -0
  462. package/src/Chat/ChatComposerDrawer.tsx +11 -1
  463. package/src/Chat/ChatComposerInput.doc.mjs +7 -0
  464. package/src/Chat/ChatComposerInput.test.tsx +103 -0
  465. package/src/Chat/ChatComposerInput.tsx +51 -5
  466. package/src/Chat/ChatContext.tsx +37 -10
  467. package/src/Chat/ChatDictationButton.tsx +11 -2
  468. package/src/Chat/ChatLayout.tsx +7 -5
  469. package/src/Chat/ChatLayoutScrollButton.tsx +7 -2
  470. package/src/Chat/ChatMessageMetadata.tsx +1 -2
  471. package/src/Chat/ChatSendButton.tsx +11 -1
  472. package/src/Chat/ChatToolCalls.test.tsx +64 -0
  473. package/src/Chat/ChatToolCalls.tsx +33 -5
  474. package/src/Chat/index.ts +5 -1
  475. package/src/Chat/useChatStreamScroll.test.tsx +49 -0
  476. package/src/Chat/useChatStreamScroll.ts +27 -10
  477. package/src/Chat/useSpeechRecognition.ts +1 -1
  478. package/src/Chat/useTriggerMenu.tsx +4 -2
  479. package/src/CheckboxInput/CheckboxInput.doc.mjs +6 -0
  480. package/src/CheckboxInput/CheckboxInput.test.tsx +32 -1
  481. package/src/CheckboxInput/CheckboxInput.tsx +5 -5
  482. package/src/CheckboxList/CheckboxList.doc.mjs +6 -0
  483. package/src/CheckboxList/CheckboxList.test.tsx +81 -3
  484. package/src/CheckboxList/CheckboxListItem.doc.mjs +33 -5
  485. package/src/CheckboxList/CheckboxListItem.tsx +41 -5
  486. package/src/Citation/Citation.doc.mjs +4 -3
  487. package/src/Citation/Citation.test.tsx +97 -0
  488. package/src/Citation/Citation.tsx +43 -11
  489. package/src/ClickableCard/ClickableCard.doc.mjs +2 -0
  490. package/src/ClickableCard/ClickableCard.test.tsx +34 -0
  491. package/src/ClickableCard/ClickableCard.tsx +13 -3
  492. package/src/CodeBlock/CodeBlock.test.tsx +56 -0
  493. package/src/CodeBlock/CodeBlock.tsx +45 -10
  494. package/src/Collapsible/Collapsible.doc.mjs +1 -0
  495. package/src/Collapsible/Collapsible.test.tsx +7 -0
  496. package/src/Collapsible/Collapsible.tsx +16 -6
  497. package/src/CommandPalette/CommandPalette.doc.mjs +1 -0
  498. package/src/CommandPalette/CommandPalette.test.tsx +95 -1
  499. package/src/CommandPalette/CommandPalette.tsx +44 -3
  500. package/src/CommandPalette/CommandPaletteGroup.test.tsx +71 -0
  501. package/src/CommandPalette/CommandPaletteGroup.tsx +12 -1
  502. package/src/CommandPalette/CommandPaletteInput.doc.mjs +26 -9
  503. package/src/CommandPalette/CommandPaletteInput.test.tsx +34 -0
  504. package/src/CommandPalette/CommandPaletteInput.tsx +11 -0
  505. package/src/CommandPalette/CommandPaletteItem.tsx +1 -1
  506. package/src/ContextMenu/ContextMenu.test.tsx +235 -0
  507. package/src/ContextMenu/ContextMenu.tsx +13 -11
  508. package/src/ContextMenu/index.ts +5 -0
  509. package/src/DateInput/DateInput.doc.mjs +41 -0
  510. package/src/DateInput/DateInput.test.tsx +338 -0
  511. package/src/DateInput/DateInput.tsx +119 -32
  512. package/src/DateInput/index.ts +1 -0
  513. package/src/DateRangeInput/DateRangeInput.doc.mjs +16 -0
  514. package/src/DateRangeInput/DateRangeInput.test.tsx +140 -0
  515. package/src/DateRangeInput/DateRangeInput.tsx +42 -30
  516. package/src/DateTimeInput/DateTimeInput.doc.mjs +22 -1
  517. package/src/DateTimeInput/DateTimeInput.test.tsx +147 -0
  518. package/src/DateTimeInput/DateTimeInput.tsx +58 -41
  519. package/src/Dialog/Dialog.doc.mjs +2 -2
  520. package/src/Dialog/Dialog.test.tsx +77 -4
  521. package/src/Dialog/Dialog.tsx +89 -5
  522. package/src/Dialog/DialogContext.ts +9 -2
  523. package/src/Dialog/DialogHeader.doc.mjs +2 -2
  524. package/src/Dialog/DialogHeader.tsx +9 -2
  525. package/src/Divider/Divider.tsx +2 -2
  526. package/src/DropdownMenu/DropdownMenu.test.tsx +229 -0
  527. package/src/DropdownMenu/DropdownMenu.tsx +31 -12
  528. package/src/DropdownMenu/DropdownMenuCheckboxItem.tsx +9 -4
  529. package/src/DropdownMenu/DropdownMenuItem.tsx +9 -3
  530. package/src/DropdownMenu/DropdownMenuRadioGroup.tsx +1 -2
  531. package/src/DropdownMenu/DropdownMenuRadioItem.tsx +8 -2
  532. package/src/DropdownMenu/DropdownMenuSubMenu.doc.mjs +88 -0
  533. package/src/DropdownMenu/DropdownMenuSubMenu.test.tsx +635 -0
  534. package/src/DropdownMenu/DropdownMenuSubMenu.tsx +553 -0
  535. package/src/DropdownMenu/index.ts +16 -0
  536. package/src/DropdownMenu/menuItemHover.ts +39 -0
  537. package/src/DropdownMenu/menuItemRoles.ts +9 -0
  538. package/src/DropdownMenu/renderDropdownItems.tsx +29 -15
  539. package/src/Field/Field.test.tsx +57 -12
  540. package/src/Field/Field.tsx +20 -14
  541. package/src/Field/FieldLabel.tsx +9 -1
  542. package/src/Field/inputStyles.stylex.ts +2 -0
  543. package/src/FieldStatus/FieldStatus.doc.mjs +17 -5
  544. package/src/FieldStatus/FieldStatus.test.tsx +150 -40
  545. package/src/FieldStatus/FieldStatus.tsx +69 -5
  546. package/src/FileInput/FileInput.doc.mjs +23 -2
  547. package/src/FileInput/FileInput.test.tsx +135 -12
  548. package/src/FileInput/FileInput.tsx +65 -51
  549. package/src/HoverCard/HoverCard.doc.mjs +13 -0
  550. package/src/HoverCard/HoverCard.test.tsx +21 -2
  551. package/src/HoverCard/HoverCard.tsx +11 -0
  552. package/src/HoverCard/useHoverCard.doc.mjs +2 -0
  553. package/src/HoverCard/useHoverCard.tsx +39 -5
  554. package/src/Icon/Icon.doc.mjs +16 -2
  555. package/src/Icon/Icon.test.tsx +89 -0
  556. package/src/Icon/Icon.tsx +58 -5
  557. package/src/IconButton/IconButton.doc.mjs +8 -0
  558. package/src/IconButton/IconButton.test.tsx +15 -18
  559. package/src/Item/Item.test.tsx +40 -18
  560. package/src/Item/Item.tsx +38 -2
  561. package/src/Layer/useLayer.tsx +8 -0
  562. package/src/Lightbox/Lightbox.tsx +15 -7
  563. package/src/List/List.test.tsx +9 -8
  564. package/src/Markdown/Markdown.test.tsx +21 -0
  565. package/src/Markdown/Markdown.tsx +4 -0
  566. package/src/MobileNav/MobileNav.tsx +12 -1
  567. package/src/MobileNav/MobileNavToggle.test.tsx +116 -0
  568. package/src/MobileNav/MobileNavToggle.tsx +9 -1
  569. package/src/MultiSelector/MultiSelector.doc.mjs +24 -2
  570. package/src/MultiSelector/MultiSelector.test.tsx +498 -3
  571. package/src/MultiSelector/MultiSelector.tsx +149 -65
  572. package/src/MultiSelector/hooks.ts +17 -0
  573. package/src/NavMenu/NavHeadingMenuItem.tsx +1 -1
  574. package/src/NumberInput/NumberInput.doc.mjs +21 -0
  575. package/src/NumberInput/NumberInput.test.tsx +82 -7
  576. package/src/NumberInput/NumberInput.tsx +36 -28
  577. package/src/Outline/Outline.tsx +0 -1
  578. package/src/OverflowList/OverflowList.doc.mjs +39 -6
  579. package/src/OverflowList/OverflowList.test.tsx +111 -0
  580. package/src/OverflowList/OverflowList.tsx +48 -8
  581. package/src/Pagination/Pagination.tsx +11 -3
  582. package/src/Popover/Popover.tsx +7 -4
  583. package/src/Popover/usePopover.tsx +9 -13
  584. package/src/PowerSearch/PowerSearch.doc.mjs +29 -0
  585. package/src/PowerSearch/PowerSearch.test.tsx +43 -0
  586. package/src/PowerSearch/PowerSearch.tsx +10 -1
  587. package/src/PowerSearch/PowerSearchEditPopover.test.tsx +67 -0
  588. package/src/PowerSearch/PowerSearchEditPopover.tsx +1 -1
  589. package/src/PowerSearch/usePowerSearchSource.ts +1 -2
  590. package/src/RadioList/RadioList.doc.mjs +6 -0
  591. package/src/RadioList/RadioList.tsx +2 -2
  592. package/src/RadioList/RadioListItem.tsx +4 -4
  593. package/src/SegmentedControl/SegmentedControlItem.tsx +2 -0
  594. package/src/SelectableCard/SelectableCard.doc.mjs +2 -0
  595. package/src/SelectableCard/SelectableCard.test.tsx +46 -4
  596. package/src/SelectableCard/SelectableCard.tsx +29 -16
  597. package/src/Selector/Selector.doc.mjs +15 -0
  598. package/src/Selector/Selector.test.tsx +417 -0
  599. package/src/Selector/Selector.tsx +86 -21
  600. package/src/Selector/hooks.ts +17 -0
  601. package/src/SideNav/SideNav.test.tsx +119 -3
  602. package/src/SideNav/SideNav.tsx +1 -8
  603. package/src/SideNav/SideNavCollapseButton.tsx +15 -8
  604. package/src/SideNav/SideNavHeading.tsx +24 -8
  605. package/src/SideNav/SideNavItem.tsx +10 -4
  606. package/src/Slider/Slider.doc.mjs +6 -0
  607. package/src/Slider/Slider.test.tsx +314 -13
  608. package/src/Slider/Slider.tsx +117 -28
  609. package/src/Switch/Switch.doc.mjs +142 -42
  610. package/src/Switch/Switch.test.tsx +54 -1
  611. package/src/Switch/Switch.tsx +90 -33
  612. package/src/TabList/Tab.tsx +2 -2
  613. package/src/TabList/TabMenu.tsx +2 -2
  614. package/src/Table/BaseTable.tsx +37 -7
  615. package/src/Table/Table.doc.mjs +11 -0
  616. package/src/Table/Table.test.tsx +85 -0
  617. package/src/Table/TableCell.tsx +3 -3
  618. package/src/Table/TableHeaderCell.tsx +3 -3
  619. package/src/Table/index.ts +5 -0
  620. package/src/Table/plugins/groupedRows/useTableGroupedRows.tsx +15 -8
  621. package/src/Table/plugins/rowExpansion/useTableRowExpansion.tsx +24 -17
  622. package/src/Table/plugins/rowStatus/index.ts +7 -0
  623. package/src/Table/plugins/rowStatus/useTableRowStatus.test.tsx +138 -0
  624. package/src/Table/plugins/rowStatus/useTableRowStatus.tsx +189 -0
  625. package/src/Table/plugins/selection/useTableSelection.test.tsx +77 -3
  626. package/src/Table/plugins/selection/useTableSelection.tsx +22 -1
  627. package/src/Table/plugins/stickyColumns/useTableStickyColumns.tsx +1 -1
  628. package/src/Table/plugins/tree/useTableTreeData.test.tsx +135 -3
  629. package/src/Table/plugins/tree/useTableTreeData.tsx +139 -8
  630. package/src/Table/plugins/tree/useTableTreeState.test.tsx +104 -0
  631. package/src/Table/plugins/tree/useTableTreeState.tsx +46 -2
  632. package/src/Table/types.ts +33 -0
  633. package/src/Table/useBaseTablePlugins.ts +10 -6
  634. package/src/Table/useTableRowStatus.doc.mjs +30 -0
  635. package/src/Table/useTableSelection.doc.mjs +65 -14
  636. package/src/Table/useTableTreeData.doc.mjs +29 -0
  637. package/src/Table/useTableTreeState.doc.mjs +2 -2
  638. package/src/TextArea/TextArea.doc.mjs +21 -0
  639. package/src/TextArea/TextArea.test.tsx +32 -1
  640. package/src/TextArea/TextArea.tsx +27 -26
  641. package/src/TextInput/TextInput.doc.mjs +21 -0
  642. package/src/TextInput/TextInput.test.tsx +150 -0
  643. package/src/TextInput/TextInput.tsx +28 -25
  644. package/src/Thumbnail/Thumbnail.doc.mjs +19 -10
  645. package/src/Thumbnail/Thumbnail.test.tsx +98 -7
  646. package/src/Thumbnail/Thumbnail.tsx +142 -42
  647. package/src/Thumbnail/thumbnail.markers.stylex.ts +12 -0
  648. package/src/TimeInput/TimeInput.doc.mjs +21 -0
  649. package/src/TimeInput/TimeInput.test.tsx +99 -1
  650. package/src/TimeInput/TimeInput.tsx +43 -31
  651. package/src/Timestamp/Timestamp.doc.mjs +4 -4
  652. package/src/Timestamp/Timestamp.test.tsx +32 -0
  653. package/src/Timestamp/Timestamp.tsx +28 -8
  654. package/src/Toast/useToast.tsx +7 -8
  655. package/src/ToggleButton/ToggleButtonGroup.tsx +1 -1
  656. package/src/Token/Token.test.tsx +21 -15
  657. package/src/Token/Token.tsx +31 -14
  658. package/src/Token/index.ts +1 -1
  659. package/src/Tokenizer/Tokenizer.doc.mjs +38 -2
  660. package/src/Tokenizer/Tokenizer.test.tsx +206 -2
  661. package/src/Tokenizer/Tokenizer.tsx +30 -6
  662. package/src/Tooltip/Tooltip.test.tsx +46 -0
  663. package/src/Tooltip/useTooltip.tsx +20 -0
  664. package/src/TopNav/TopNav.test.tsx +125 -1
  665. package/src/TopNav/TopNavHeading.tsx +24 -8
  666. package/src/TopNav/TopNavMegaMenu.test.tsx +149 -1
  667. package/src/TopNav/TopNavMegaMenu.tsx +10 -4
  668. package/src/TopNav/TopNavMegaMenuFeaturedCard.doc.mjs +3 -3
  669. package/src/TopNav/TopNavMegaMenuFeaturedCard.tsx +19 -2
  670. package/src/TopNav/TopNavMenu.test.tsx +118 -4
  671. package/src/TopNav/TopNavMenu.tsx +83 -5
  672. package/src/TreeList/TreeList.doc.mjs +28 -0
  673. package/src/TreeList/TreeList.test.tsx +272 -0
  674. package/src/TreeList/TreeList.tsx +23 -2
  675. package/src/TreeList/TreeListBranches.tsx +24 -8
  676. package/src/TreeList/TreeListItem.tsx +84 -22
  677. package/src/TreeList/TreeListTypes.ts +27 -1
  678. package/src/TreeList/index.ts +2 -2
  679. package/src/Typeahead/BaseTypeahead.tsx +30 -15
  680. package/src/Typeahead/Typeahead.doc.mjs +13 -0
  681. package/src/Typeahead/Typeahead.test.tsx +50 -0
  682. package/src/Typeahead/Typeahead.tsx +11 -1
  683. package/src/Typeahead/TypeaheadItem.tsx +2 -1
  684. package/src/__tests__/inputWidthContract.test.tsx +62 -0
  685. package/src/authoring/doc.ts +1 -3
  686. package/src/doc-mjs.d.ts +19 -0
  687. package/src/docs-types.ts +5 -0
  688. package/src/hooks/computeOverflow.test.ts +422 -0
  689. package/src/hooks/computeOverflow.ts +290 -0
  690. package/src/hooks/index.ts +8 -0
  691. package/src/hooks/isRtlElement.ts +27 -0
  692. package/src/hooks/useDevWarning.test.tsx +45 -0
  693. package/src/hooks/useDevWarning.ts +54 -0
  694. package/src/hooks/useGridFocus.doc.mjs +3 -3
  695. package/src/hooks/useGridFocus.test.tsx +41 -0
  696. package/src/hooks/useGridFocus.ts +21 -10
  697. package/src/hooks/useInputStatusIcon.test.tsx +162 -0
  698. package/src/hooks/useInputStatusIcon.tsx +224 -0
  699. package/src/hooks/useListFocus.doc.mjs +25 -3
  700. package/src/hooks/useListFocus.test.tsx +153 -1
  701. package/src/hooks/useListFocus.ts +102 -9
  702. package/src/hooks/useOverflow.test.ts +96 -4
  703. package/src/hooks/useOverflow.ts +74 -33
  704. package/src/i18n/InternationalizationContext.ts +4 -0
  705. package/src/i18n/InternationalizationProvider.doc.mjs +99 -2
  706. package/src/i18n/InternationalizationProvider.tsx +12 -2
  707. package/src/i18n/__tests__/getLocaleDirection.test.ts +40 -0
  708. package/src/i18n/__tests__/useDirection.test.tsx +66 -0
  709. package/src/i18n/getLocaleDirection.ts +29 -0
  710. package/src/i18n/index.ts +6 -0
  711. package/src/i18n/resolve.ts +9 -21
  712. package/src/i18n/useDirection.ts +29 -0
  713. package/src/reset.css +0 -26
  714. package/src/reset.test.ts +60 -0
  715. package/src/theme/Theme.tsx +11 -14
  716. package/src/theme/derivedVarRegistry.test.ts +1 -0
  717. package/src/theme/derivedVarRegistry.ts +6 -0
  718. package/src/theme/generateThemeRules.test.ts +107 -0
  719. package/src/theme/generateThemeRules.ts +56 -0
  720. package/src/theme/hct.ts +1 -1
  721. package/src/theme/syntax/defineSyntaxTheme.ts +5 -6
  722. package/src/utils/devWarning.test.ts +56 -0
  723. package/src/utils/devWarning.ts +102 -0
  724. package/src/utils/index.ts +8 -0
  725. package/src/utils/plainDate.test.ts +46 -6
  726. package/src/utils/plainDate.ts +69 -3
  727. package/src/utils/rtlStyles.ts +27 -0
  728. package/src/utils/types.ts +14 -0
@@ -4,14 +4,18 @@
4
4
 
5
5
  /**
6
6
  * @file Thumbnail.tsx
7
- * @input Uses React, stylex, Button, Skeleton, Spinner, MediaTheme, useImageMode
7
+ * @input Uses React, stylex, Button, Skeleton, Spinner
8
8
  * @output Exports Thumbnail component, ThumbnailProps
9
9
  * @position Core implementation; consumed by index.ts
10
10
  *
11
11
  * Square preview card for image attachments. Shows a skeleton shimmer while
12
12
  * the image loads, the image on success, or a placeholder on failure.
13
- * Uses useImageMode (APCA) to detect image luminance so the overlaid
14
- * remove button always has sufficient contrast.
13
+ * The overlaid remove button sits on a fixed --color-overlay scrim with an
14
+ * --color-on-dark icon so it always has sufficient contrast against the image.
15
+ *
16
+ * Images without `alt` are explicitly decorative (alt="" +
17
+ * role="presentation" + aria-hidden, matching Avatar). A dev-time warning
18
+ * fires once when `src` is set with no `alt` and no other name source.
15
19
  *
16
20
  * SYNC: When modified, update these files to stay in sync:
17
21
  * - /packages/core/src/Thumbnail/Thumbnail.doc.mjs
@@ -26,7 +30,6 @@ import {
26
30
  colorVars,
27
31
  radiusVars,
28
32
  spacingVars,
29
- shadowVars,
30
33
  durationVars,
31
34
  easeVars,
32
35
  } from '../theme/tokens.stylex';
@@ -35,15 +38,12 @@ import {Icon} from '../Icon';
35
38
  import {Skeleton} from '../Skeleton';
36
39
  import {Spinner} from '../Spinner';
37
40
  import {Tooltip} from '../Tooltip/Tooltip';
38
- import {MediaTheme} from '../theme/MediaTheme';
39
- import {useImageMode} from '../hooks/useImageMode';
41
+ import {useDevWarning} from '../hooks/useDevWarning';
40
42
  import type {BaseProps} from '../BaseProps';
41
43
  import {mergeProps} from '../utils';
42
44
  import {themeProps} from '../utils/themeProps';
43
45
  import {useTranslator} from '../i18n';
44
-
45
- /** Sample the region behind the remove button (20px button, 4px inset, in 64px container). */
46
- const BUTTON_REGION = {x: 0.5, y: 0.06, width: 0.44, height: 0.44};
46
+ import {thumbnailScope} from './thumbnail.markers.stylex';
47
47
 
48
48
  export interface ThumbnailProps extends BaseProps<HTMLDivElement> {
49
49
  /** Ref forwarded to the root element */
@@ -54,7 +54,14 @@ export interface ThumbnailProps extends BaseProps<HTMLDivElement> {
54
54
  */
55
55
  src?: string;
56
56
  /**
57
- * Alt text for the image. Required for accessibility when `src` is provided.
57
+ * Alt text for the image.
58
+ *
59
+ * When omitted, the image is explicitly decorative (`alt=""` +
60
+ * `role="presentation"` + `aria-hidden`, matching Avatar) and hidden from
61
+ * assistive technology. Provide `alt` whenever the image conveys content;
62
+ * without it, screen reader users only hear the `label` (file name), or a
63
+ * generic "thumbnail" if `label` is also missing — which triggers a
64
+ * dev-time warning.
58
65
  */
59
66
  alt?: string;
60
67
  /**
@@ -90,6 +97,17 @@ export interface ThumbnailProps extends BaseProps<HTMLDivElement> {
90
97
  * @default false
91
98
  */
92
99
  isDisabled?: boolean;
100
+ /**
101
+ * When the remove button is visible.
102
+ * - `'hover'` — the button is revealed on hover, and on keyboard focus so
103
+ * it stays reachable. On any touch-capable device it stays visible.
104
+ * This is the default.
105
+ * - `'always'` — the button is always shown.
106
+ *
107
+ * Only has an effect when `onRemove` is set.
108
+ * @default 'hover'
109
+ */
110
+ showRemoveOn?: 'always' | 'hover';
93
111
  /**
94
112
  * Test ID for testing frameworks.
95
113
  */
@@ -140,22 +158,6 @@ const styles = stylex.create({
140
158
  },
141
159
  interactive: {
142
160
  cursor: 'pointer',
143
- transitionProperty: 'opacity, box-shadow',
144
- transitionDuration: durationVars['--duration-fast'],
145
- transitionTimingFunction: easeVars['--ease-standard'],
146
- boxShadow: {
147
- default: 'none',
148
- ':hover': {
149
- '@media (hover: hover)': shadowVars['--shadow-med'],
150
- },
151
- },
152
- opacity: {
153
- default: 1,
154
- ':hover': {
155
- '@media (hover: hover)': 0.85,
156
- },
157
- ':active': 0.75,
158
- },
159
161
  outline: {
160
162
  default: null,
161
163
  ':has(:focus-visible)': `2px solid ${colorVars['--color-accent']}`,
@@ -165,6 +167,33 @@ const styles = stylex.create({
165
167
  ':has(:focus-visible)': '2px',
166
168
  },
167
169
  },
170
+ // Hover/pressed overlay — the exact same treatment as ClickableCard and
171
+ // SelectableCard. A transparent `::after` tints on hover/press instead of
172
+ // shifting shadow or opacity. Guarded by @media (hover: hover) so touch
173
+ // devices don't show a stuck hover state; active/pressed works everywhere.
174
+ overlay: {
175
+ '::after': {
176
+ content: '""',
177
+ position: 'absolute',
178
+ inset: 0,
179
+ borderRadius: 'inherit',
180
+ pointerEvents: 'none',
181
+ transitionProperty: 'background-color',
182
+ transitionDuration: durationVars['--duration-fast'],
183
+ transitionTimingFunction: easeVars['--ease-standard'],
184
+ backgroundColor: 'transparent',
185
+ },
186
+ ':active::after': {
187
+ backgroundColor: colorVars['--color-overlay-pressed'],
188
+ },
189
+ },
190
+ hoverOnPointer: {
191
+ '@media (hover: hover)': {
192
+ ':hover::after': {
193
+ backgroundColor: colorVars['--color-overlay-hover'],
194
+ },
195
+ },
196
+ },
168
197
  interactiveButton: {
169
198
  all: 'unset',
170
199
  cursor: 'pointer',
@@ -175,14 +204,22 @@ const styles = stylex.create({
175
204
  overflow: 'hidden',
176
205
  },
177
206
 
178
- removeButtonOverrides: {
207
+ removeSlot: {
179
208
  position: 'absolute',
180
209
  top: spacingVars['--spacing-1'],
181
- right: spacingVars['--spacing-1'],
210
+ insetInlineEnd: spacingVars['--spacing-1'],
182
211
  zIndex: 1,
212
+ lineHeight: 0,
213
+ },
214
+ removeButtonOverrides: {
183
215
  '--_button-radius': `calc(${radiusVars['--radius-element']} - ${spacingVars['--spacing-1']})`,
184
216
  height: 20,
185
217
  minWidth: 20,
218
+ // Fixed colors instead of luminance-adapting theme: a translucent scrim
219
+ // (--color-overlay) plus an --color-on-dark icon reads on any image
220
+ // without sampling pixel brightness.
221
+ backgroundColor: colorVars['--color-overlay'],
222
+ color: colorVars['--color-on-dark'],
186
223
  },
187
224
  disabled: {
188
225
  opacity: 0.5,
@@ -199,6 +236,28 @@ const styles = stylex.create({
199
236
  zIndex: 1,
200
237
  lineHeight: 0,
201
238
  },
239
+ // showRemoveOn="hover": the remove button is hidden at rest and revealed
240
+ // when the thumbnail is hovered or when focus enters it (keyboard). Only
241
+ // opacity is animated — the button stays mounted and focusable so tabbing
242
+ // to it triggers the :focus-within reveal. Any touch-capable device (incl.
243
+ // hybrid laptops that also report hover) keeps the button visible so the
244
+ // remove path is never gated behind an unavailable hover.
245
+ removeOnHover: {
246
+ opacity: {
247
+ default: 0,
248
+ [stylex.when.ancestor(':hover', thumbnailScope)]: {
249
+ '@media (hover: hover)': 1,
250
+ },
251
+ [stylex.when.ancestor(':focus-within', thumbnailScope)]: 1,
252
+ '@media (any-pointer: coarse)': 1,
253
+ },
254
+ transitionProperty: 'opacity',
255
+ transitionDuration: {
256
+ default: durationVars['--duration-fast'],
257
+ '@media (prefers-reduced-motion: reduce)': '0s',
258
+ },
259
+ transitionTimingFunction: easeVars['--ease-standard'],
260
+ },
202
261
  });
203
262
 
204
263
  // =============================================================================
@@ -227,15 +286,18 @@ function ImagePlaceholder() {
227
286
  *
228
287
  * Shows a skeleton shimmer while the image loads, the image on success, or
229
288
  * a placeholder icon on failure / when no src is provided. An overlaid
230
- * remove button appears when `onRemove` is set.
289
+ * remove button appears when `onRemove` is set — revealed on hover or
290
+ * keyboard focus by default (`showRemoveOn`), or always shown.
231
291
  *
232
- * Uses `useImageMode` (APCA) to detect image luminance and `MediaTheme`
233
- * to ensure the remove button always has sufficient contrast against the image.
292
+ * The remove button uses a fixed `--color-overlay` scrim with an
293
+ * `--color-on-dark` icon so it stays legible on any image without sampling
294
+ * the image's luminance.
234
295
  *
235
296
  * @example
236
297
  * ```
237
298
  * <Thumbnail src="/photo.jpg" alt="Vacation photo" onRemove={() => {}} />
238
299
  * <Thumbnail src="/preview.png" alt="Preview" onClick={() => {}} label="preview.png" />
300
+ * <Thumbnail src="/logo.png" alt="Logo" onRemove={() => {}} showRemoveOn="always" />
239
301
  * ```
240
302
  */
241
303
  export function Thumbnail({
@@ -246,6 +308,7 @@ export function Thumbnail({
246
308
  onClick,
247
309
  isLoading = false,
248
310
  isDisabled = false,
311
+ showRemoveOn = 'hover',
249
312
  xstyle,
250
313
  className,
251
314
  style,
@@ -254,7 +317,6 @@ export function Thumbnail({
254
317
  ...props
255
318
  }: ThumbnailProps) {
256
319
  const t = useTranslator();
257
- const imageMode = useImageMode(src, {region: BUTTON_REGION, fallback: null});
258
320
 
259
321
  const hasSrc = src != null;
260
322
  const showSkeleton = isLoading && !hasSrc;
@@ -262,13 +324,47 @@ export function Thumbnail({
262
324
  const showUploadOverlay = isLoading && hasSrc;
263
325
  const showPlaceholder = !isLoading && !hasSrc;
264
326
  const isInteractive = onClick != null && !isDisabled && !isLoading;
327
+ const hasRemove = onRemove != null && !isDisabled;
328
+ const isHoverReveal = hasRemove && showRemoveOn === 'hover';
265
329
  const accessibleName =
266
- label && alt ? `${label} — ${alt}` : (label ?? alt ?? 'thumbnail');
330
+ label && alt
331
+ ? `${label} — ${alt}`
332
+ : (label ?? alt ?? t('@astryx.thumbnail.fallbackName'));
333
+
334
+ // Without `alt`, the image is explicitly decorative rather than silently
335
+ // empty-alt, matching Avatar's handling of unnamed images.
336
+ const isImageDecorative = !alt;
337
+
338
+ // Dev-time guardrail: `src` with no `alt` hides the image from assistive
339
+ // technology. That is fine when the thumbnail is otherwise named — `label`
340
+ // (or a consumer-provided aria name) becomes the group's accessible name —
341
+ // but with no name source at all the group falls back to a generic
342
+ // "thumbnail".
343
+ const hasNameSource =
344
+ alt != null ||
345
+ label != null ||
346
+ props['aria-label'] != null ||
347
+ props['aria-labelledby'] != null;
348
+ useDevWarning(
349
+ 'Thumbnail',
350
+ '`src` is set without `alt` or `label`. The image is ' +
351
+ 'treated as decorative and hidden from assistive technology, and ' +
352
+ 'the thumbnail falls back to a generic "thumbnail" name. Pass ' +
353
+ '`alt` to describe the image content, or `label` (file name) to ' +
354
+ 'name the thumbnail.',
355
+ hasSrc && !hasNameSource,
356
+ );
267
357
 
268
358
  const imageContent = (
269
359
  <>
270
360
  {showImage && (
271
- <img src={src} alt={alt ?? ''} {...stylex.props(styles.image)} />
361
+ <img
362
+ src={src}
363
+ alt={alt ?? ''}
364
+ role={isImageDecorative ? 'presentation' : undefined}
365
+ aria-hidden={isImageDecorative || undefined}
366
+ {...stylex.props(styles.image)}
367
+ />
272
368
  )}
273
369
  {showSkeleton && <Skeleton radius={2} />}
274
370
  {showPlaceholder && (
@@ -279,8 +375,12 @@ export function Thumbnail({
279
375
  </>
280
376
  );
281
377
 
282
- const removeButtonEl =
283
- onRemove != null && !isDisabled ? (
378
+ const removeButtonEl = hasRemove ? (
379
+ <div
380
+ {...stylex.props(
381
+ styles.removeSlot,
382
+ isHoverReveal && styles.removeOnHover,
383
+ )}>
284
384
  <Button
285
385
  icon={<Icon icon="close" size="xsm" />}
286
386
  label={t('@astryx.thumbnail.remove', {accessibleName})}
@@ -293,7 +393,8 @@ export function Thumbnail({
293
393
  }}
294
394
  xstyle={styles.removeButtonOverrides}
295
395
  />
296
- ) : null;
396
+ </div>
397
+ ) : null;
297
398
 
298
399
  const thumbnail = (
299
400
  <div
@@ -311,7 +412,10 @@ export function Thumbnail({
311
412
  <div
312
413
  {...stylex.props(
313
414
  styles.imageContainer,
415
+ isHoverReveal && thumbnailScope,
314
416
  isInteractive && styles.interactive,
417
+ isInteractive && styles.overlay,
418
+ isInteractive && styles.hoverOnPointer,
315
419
  )}>
316
420
  {isInteractive ? (
317
421
  <button
@@ -330,11 +434,7 @@ export function Thumbnail({
330
434
  <Spinner size="sm" shade="onMedia" />
331
435
  </div>
332
436
  )}
333
- {removeButtonEl != null && imageMode != null ? (
334
- <MediaTheme mode={imageMode}>{removeButtonEl}</MediaTheme>
335
- ) : (
336
- removeButtonEl
337
- )}
437
+ {removeButtonEl}
338
438
  </div>
339
439
  </div>
340
440
  );
@@ -0,0 +1,12 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ import * as stylex from '@stylexjs/stylex';
4
+
5
+ /**
6
+ * Scoped marker for Thumbnail ancestor selectors. Applied to the image
7
+ * container so the remove button's hover/focus reveal (`showRemoveOn="hover"`)
8
+ * responds only to this thumbnail — not to hover/focus state from an outer
9
+ * container the thumbnail happens to sit inside.
10
+ */
11
+ export const thumbnailScope: ReturnType<typeof stylex.defineMarker> =
12
+ stylex.defineMarker();
@@ -229,12 +229,25 @@ export const docs = {
229
229
  description:
230
230
  'Status indicator that colors the border and displays an icon. When a message is provided it is rendered below the input.',
231
231
  },
232
+ {
233
+ name: 'statusVariant',
234
+ type: "'attached' | 'detached' | 'tooltip'",
235
+ description:
236
+ 'How the status message is placed relative to the input. attached overlaps directly below the input (bordered treatment); detached floats below as a separate element with spacing; tooltip hides the message box and surfaces it in a tooltip on the status icon.',
237
+ default: "'attached'",
238
+ },
232
239
  {
233
240
  name: 'labelTooltip',
234
241
  type: 'string',
235
242
  description:
236
243
  'Tooltip text rendered as an info icon at the end of the label row.',
237
244
  },
245
+ {
246
+ name: 'width',
247
+ type: 'SizeValue',
248
+ description:
249
+ 'Width of the field (number = pixels, string used as-is, e.g. "100%"). Sizes the whole field (label, control, and status) so they stay aligned.',
250
+ },
238
251
  {
239
252
  name: 'xstyle',
240
253
  type: 'StyleXStyles',
@@ -372,6 +385,13 @@ export const docsZh = {
372
385
  description:
373
386
  '为边框着色并显示图标的状态指示器。当提供消息时,消息渲染在输入框下方。',
374
387
  },
388
+ {
389
+ name: 'statusVariant',
390
+ type: "'attached' | 'detached' | 'tooltip'",
391
+ description:
392
+ '状态消息相对于输入框的放置方式。attached 直接叠加在输入框下方(带边框处理);detached 作为独立元素浮于下方并留有间距;tooltip 隐藏消息框,并在状态图标上以提示气泡形式显示。',
393
+ default: "'attached'",
394
+ },
375
395
  {
376
396
  name: 'labelTooltip',
377
397
  type: 'string',
@@ -545,6 +565,7 @@ export const docsDense = {
545
565
  placeholder: 'Placeholder when empty. Focused+empty shows format hint.',
546
566
  size: 'Input element height.',
547
567
  status: 'Colored border+icon. Message rendered below input.',
568
+ statusVariant: 'How status message is placed: attached overlaps below input; detached floats below w/ spacing; tooltip hides the box and shows it on the status icon.',
548
569
  labelTooltip: 'Tooltip as info icon at label row end.',
549
570
  xstyle:
550
571
  'StyleX styles for layout customization. Must be stylex.create() value, not inline style.',
@@ -9,12 +9,24 @@
9
9
  * SYNC: When TimeInput.tsx changes, update tests to match new behavior
10
10
  */
11
11
 
12
- import {describe, it, expect, vi, beforeEach} from 'vitest';
12
+ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
13
13
  import {render, screen, fireEvent, waitFor} from '@testing-library/react';
14
14
  import userEvent from '@testing-library/user-event';
15
15
  import {TimeInput} from './TimeInput';
16
16
  import {InputGroup, InputGroupText} from '../InputGroup';
17
17
  import type {ISOTimeString} from '../utils';
18
+ import {__resetLiveRegionsForTest} from '../hooks/useAnnounce';
19
+
20
+ function politeRegion(): HTMLElement | null {
21
+ return document.querySelector('[data-astryx-live-region="polite"]');
22
+ }
23
+ function assertiveRegion(): HTMLElement | null {
24
+ return document.querySelector('[data-astryx-live-region="assertive"]');
25
+ }
26
+
27
+ afterEach(() => {
28
+ __resetLiveRegionsForTest();
29
+ });
18
30
 
19
31
  describe('TimeInput', () => {
20
32
  it('renders with label', () => {
@@ -352,6 +364,69 @@ describe('TimeInput', () => {
352
364
  // duplicated.
353
365
  expect(container.querySelectorAll('svg')).toHaveLength(1);
354
366
  });
367
+
368
+ // The grouped status node exists only for aria-describedby; announcing
369
+ // happens through the persistent useAnnounce regions because a live
370
+ // region mounted together with its content is not reliably announced.
371
+ it('keeps the grouped status node role-free while announcing via the persistent region', async () => {
372
+ render(
373
+ <InputGroup label="Schedule">
374
+ <InputGroupText>Starts</InputGroupText>
375
+ <TimeInput
376
+ label="Start time"
377
+ isLabelHidden
378
+ value={'09:00' as ISOTimeString}
379
+ onChange={() => {}}
380
+ status={{type: 'error', message: 'Start time is required'}}
381
+ />
382
+ </InputGroup>,
383
+ );
384
+
385
+ const input = screen.getByRole('textbox', {
386
+ name: 'Schedule Start time',
387
+ });
388
+ const describedByIDs =
389
+ input.getAttribute('aria-describedby')?.split(' ') ?? [];
390
+ const statusNode = describedByIDs
391
+ .map(id => document.getElementById(id))
392
+ .find(el => el?.textContent === 'Start time is required');
393
+ expect(statusNode).toBeTruthy();
394
+ expect(statusNode).not.toHaveAttribute('role');
395
+ expect(statusNode).not.toHaveAttribute('aria-live');
396
+
397
+ await waitFor(() => {
398
+ expect(assertiveRegion()).toHaveTextContent('Start time is required');
399
+ });
400
+ });
401
+
402
+ // Regression: a grouped status message appearing after mount (the common
403
+ // validation flow) must land in the persistent announce region.
404
+ it('announces a grouped status message that appears after mount', async () => {
405
+ const grouped = (status?: {
406
+ type: 'error' | 'warning';
407
+ message: string;
408
+ }) => (
409
+ <InputGroup label="Schedule">
410
+ <InputGroupText>Starts</InputGroupText>
411
+ <TimeInput
412
+ label="Start time"
413
+ isLabelHidden
414
+ value={'09:00' as ISOTimeString}
415
+ onChange={() => {}}
416
+ status={status}
417
+ />
418
+ </InputGroup>
419
+ );
420
+ const {rerender} = render(grouped());
421
+ expect(politeRegion()).toBeNull();
422
+
423
+ rerender(grouped({type: 'warning', message: 'Schedule is unusual'}));
424
+ await waitFor(() => {
425
+ expect(politeRegion()).toHaveTextContent('Schedule is unusual');
426
+ });
427
+ // Non-error statuses stay on the polite channel.
428
+ expect(assertiveRegion()).toHaveTextContent('');
429
+ });
355
430
  });
356
431
 
357
432
  describe('disabledMessage', () => {
@@ -496,3 +571,26 @@ describe('TimeInput', () => {
496
571
  });
497
572
  });
498
573
  });
574
+
575
+
576
+ describe('TimeInput statusVariant forwarding', () => {
577
+ it('defaults to attached (status renders with data-variant="attached")', () => {
578
+ const {container} = render(
579
+ <TimeInput label="Start" value={undefined} onChange={() => {}} status={{type: 'error', message: 'Required'}} />,
580
+ );
581
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
582
+ 'data-variant',
583
+ 'attached',
584
+ );
585
+ });
586
+
587
+ it('forwards statusVariant="detached" to the underlying Field status', () => {
588
+ const {container} = render(
589
+ <TimeInput label="Start" value={undefined} onChange={() => {}} status={{type: 'error', message: 'Required'}} statusVariant="detached" />,
590
+ );
591
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
592
+ 'data-variant',
593
+ 'detached',
594
+ );
595
+ });
596
+ });
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * @file TimeInput.tsx
7
- * @input Uses React, useId, useState, useCallback, useRef, Field, Icon, InputGroupContext
7
+ * @input Uses React, useId, useState, useCallback, useRef, Field, Icon, InputGroupContext, useAnnounce
8
8
  * @output Exports TimeInput component, TimeInputProps
9
9
  * @position Core implementation; consumed by index.ts, tested by TimeInput.test.tsx
10
10
  *
@@ -20,6 +20,7 @@ import {
20
20
  useId,
21
21
  useState,
22
22
  useCallback,
23
+ useEffect,
23
24
  useRef,
24
25
  useMemo,
25
26
  useOptimistic,
@@ -28,7 +29,6 @@ import {
28
29
  type FocusEvent,
29
30
  } from 'react';
30
31
  import * as stylex from '@stylexjs/stylex';
31
- import type {IconName} from '../Icon';
32
32
  import {
33
33
  colorVars,
34
34
  sizeVars,
@@ -40,11 +40,11 @@ import {
40
40
  import {
41
41
  Field,
42
42
  type InputStatus,
43
- type InputStatusType,
44
43
  inputWrapperStyles,
45
44
  inputStatusBorderStyles,
46
45
  inputStatusHoverShadowStyles,
47
46
  inputStatusFocusWithinStyles,
47
+ type FieldStatusVariant,
48
48
  } from '../Field';
49
49
  import {Icon} from '../Icon';
50
50
  import {Spinner} from '../Spinner';
@@ -64,7 +64,9 @@ import {
64
64
  import type {BaseProps} from '../BaseProps';
65
65
  import type {SizeValue} from '../utils/types';
66
66
  import {useSize} from '../SizeContext/SizeContext';
67
+ import {useAnnounce} from '../hooks/useAnnounce';
67
68
  import {useInputContainer} from '../hooks/useInputContainer';
69
+ import {useInputStatusIcon} from '../hooks/useInputStatusIcon';
68
70
  import {useInputGroup} from '../InputGroup/InputGroupContext';
69
71
  import {groupStyles} from '../InputGroup/groupStyles';
70
72
  import {useTooltip} from '../Tooltip';
@@ -296,6 +298,14 @@ export interface TimeInputProps extends Omit<
296
298
  * If message is provided, displays below the input.
297
299
  */
298
300
  status?: InputStatus;
301
+ /**
302
+ * How the status message is placed relative to the input.
303
+ * - 'attached': message overlaps directly below the input (bordered treatment)
304
+ * - 'detached': message floats below as a separate element with spacing
305
+ * - 'tooltip': no message box; the status icon becomes a focusable info-tip button that reveals the message on hover, keyboard focus, or tap
306
+ * @default 'attached'
307
+ */
308
+ statusVariant?: FieldStatusVariant;
299
309
 
300
310
  /**
301
311
  * Width of the field. Numbers are treated as pixels, strings are used as-is
@@ -345,6 +355,7 @@ export function TimeInput({
345
355
  placeholder: placeholderFromProps,
346
356
  size: sizeProp,
347
357
  status,
358
+ statusVariant = 'attached',
348
359
  labelTooltip,
349
360
  width,
350
361
  xstyle,
@@ -369,6 +380,21 @@ export function TimeInput({
369
380
  const [optimisticValue, setOptimisticValue] = useOptimistic(value);
370
381
  const isBusy = isLoading || optimisticValue !== value;
371
382
 
383
+ // In grouped mode the status message renders as a visually-hidden node that
384
+ // exists only for aria-describedby. Announce it through the persistent
385
+ // useAnnounce live regions instead of role/aria-live on that node — a live
386
+ // region mounted together with its content is not reliably announced.
387
+ // Ungrouped mode delegates to Field -> FieldStatus, which announces itself.
388
+ const announce = useAnnounce();
389
+ useEffect(() => {
390
+ if (inputGroup && status?.message) {
391
+ announce(
392
+ status.message,
393
+ status.type === 'error' ? 'assertive' : 'polite',
394
+ );
395
+ }
396
+ }, [announce, inputGroup, status?.message, status?.type]);
397
+
372
398
  // Disabled-reason tooltip. Disabled controls swallow pointer events, so the
373
399
  // tooltip listeners attach to the input container (which already exists) and
374
400
  // the input stays perceivable via aria-disabled instead of the disabled
@@ -383,26 +409,21 @@ export function TimeInput({
383
409
  });
384
410
 
385
411
  // Status icon mapping
386
- const statusIconMap: Record<InputStatusType, IconName> = {
387
- warning: 'warning',
388
- error: 'error',
389
- success: 'success',
390
- };
391
-
392
- const statusIconColorMap: Record<
393
- InputStatusType,
394
- 'warning' | 'error' | 'success'
395
- > = {
396
- warning: 'warning',
397
- error: 'error',
398
- success: 'success',
399
- };
412
+ const {statusIcon, describedBy: statusTooltipDescribedBy} =
413
+ useInputStatusIcon({
414
+ status,
415
+ statusVariant,
416
+ isInGroup: !!inputGroup,
417
+ });
400
418
 
401
419
  const {ariaLabelledBy, ariaDescribedBy} = getInputARIA(
402
420
  inputLabelID,
403
421
  [
404
422
  description ? descriptionID : null,
405
- status?.message ? statusMessageID : null,
423
+ statusVariant !== 'tooltip' && status?.message ? statusMessageID : null,
424
+ // The tooltip variant renders no message box; describe the input by the
425
+ // tooltip's content instead so the status is still announced.
426
+ statusTooltipDescribedBy,
406
427
  showsDisabledMessage ? disabledMessageTooltip.describedBy : null,
407
428
  ],
408
429
  inputGroup,
@@ -593,7 +614,7 @@ export function TimeInput({
593
614
  sizeStyles[size],
594
615
  isDisabled && inputWrapperStyles.disabled,
595
616
  status && inputStatusBorderStyles[status.type],
596
- status && inputStatusHoverShadowStyles[status.type],
617
+ status && !isDisabled && inputStatusHoverShadowStyles[status.type],
597
618
  status && inputStatusFocusWithinStyles[status.type],
598
619
  inputGroup && groupStyles.inGroup,
599
620
  xstyle,
@@ -611,11 +632,7 @@ export function TimeInput({
611
632
  </VisuallyHidden>
612
633
  )}
613
634
  {inputGroup && status?.message && (
614
- <VisuallyHidden
615
- as="div"
616
- id={statusMessageID}
617
- role={status.type === 'error' ? 'alert' : 'status'}
618
- aria-live={status.type === 'error' ? 'assertive' : 'polite'}>
635
+ <VisuallyHidden as="div" id={statusMessageID}>
619
636
  {status.message}
620
637
  </VisuallyHidden>
621
638
  )}
@@ -668,13 +685,7 @@ export function TimeInput({
668
685
  <Icon icon="close" size="sm" color="secondary" />
669
686
  </button>
670
687
  )}
671
- {status && !inputGroup && (
672
- <Icon
673
- icon={statusIconMap[status.type]}
674
- size="md"
675
- color={statusIconColorMap[status.type]}
676
- />
677
- )}
688
+ {statusIcon}
678
689
  </div>
679
690
  );
680
691
 
@@ -707,6 +718,7 @@ export function TimeInput({
707
718
  }
708
719
  : undefined
709
720
  }
721
+ statusVariant={statusVariant}
710
722
  labelTooltip={labelTooltip}
711
723
  width={width}>
712
724
  {inputWrapper}