@astryxdesign/core 0.1.8 → 0.1.9-canary.09e9ddd

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 (610) 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 +53 -3
  7. package/dist/Avatar/Avatar.d.ts.map +1 -1
  8. package/dist/Avatar/Avatar.js +203 -49
  9. package/dist/Avatar/AvatarStatusDot.d.ts +33 -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 +208 -6
  23. package/dist/Breadcrumbs/index.d.ts +5 -0
  24. package/dist/Breadcrumbs/index.d.ts.map +1 -1
  25. package/dist/Breadcrumbs/index.js +9 -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 +30 -2
  34. package/dist/Calendar/dayCellUtils.js +1 -1
  35. package/dist/Card/Card.d.ts +8 -2
  36. package/dist/Card/Card.d.ts.map +1 -1
  37. package/dist/Card/Card.js +28 -2
  38. package/dist/Carousel/Carousel.d.ts +4 -1
  39. package/dist/Carousel/Carousel.d.ts.map +1 -1
  40. package/dist/Carousel/Carousel.js +24 -4
  41. package/dist/Chat/ChatComposer.d.ts +8 -0
  42. package/dist/Chat/ChatComposer.d.ts.map +1 -1
  43. package/dist/Chat/ChatComposer.js +46 -7
  44. package/dist/Chat/ChatComposerDrawer.d.ts +2 -0
  45. package/dist/Chat/ChatComposerDrawer.d.ts.map +1 -1
  46. package/dist/Chat/ChatComposerDrawer.js +11 -1
  47. package/dist/Chat/ChatComposerInput.d.ts +20 -3
  48. package/dist/Chat/ChatComposerInput.d.ts.map +1 -1
  49. package/dist/Chat/ChatComposerInput.js +36 -4
  50. package/dist/Chat/ChatContext.d.ts +33 -0
  51. package/dist/Chat/ChatContext.d.ts.map +1 -1
  52. package/dist/Chat/ChatContext.js +16 -2
  53. package/dist/Chat/ChatDictationButton.d.ts.map +1 -1
  54. package/dist/Chat/ChatDictationButton.js +1 -1
  55. package/dist/Chat/ChatLayout.d.ts.map +1 -1
  56. package/dist/Chat/ChatLayout.js +4 -4
  57. package/dist/Chat/ChatLayoutScrollButton.d.ts.map +1 -1
  58. package/dist/Chat/ChatLayoutScrollButton.js +4 -4
  59. package/dist/Chat/ChatMessageMetadata.d.ts.map +1 -1
  60. package/dist/Chat/ChatSendButton.d.ts.map +1 -1
  61. package/dist/Chat/ChatSendButton.js +7 -1
  62. package/dist/Chat/ChatToolCalls.d.ts +5 -1
  63. package/dist/Chat/ChatToolCalls.d.ts.map +1 -1
  64. package/dist/Chat/ChatToolCalls.js +18 -9
  65. package/dist/Chat/index.d.ts +2 -1
  66. package/dist/Chat/index.d.ts.map +1 -1
  67. package/dist/Chat/index.js +1 -1
  68. package/dist/Chat/useChatStreamScroll.d.ts +2 -1
  69. package/dist/Chat/useChatStreamScroll.d.ts.map +1 -1
  70. package/dist/Chat/useChatStreamScroll.js +22 -8
  71. package/dist/Chat/useSpeechRecognition.d.ts +0 -1
  72. package/dist/Chat/useSpeechRecognition.d.ts.map +1 -1
  73. package/dist/Chat/useSpeechRecognition.js +1 -1
  74. package/dist/Chat/useTriggerMenu.d.ts.map +1 -1
  75. package/dist/Chat/useTriggerMenu.js +2 -2
  76. package/dist/CheckboxInput/CheckboxInput.js +1 -1
  77. package/dist/CheckboxList/CheckboxListItem.d.ts +20 -1
  78. package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
  79. package/dist/CheckboxList/CheckboxListItem.js +11 -1
  80. package/dist/Citation/Citation.d.ts +22 -1
  81. package/dist/Citation/Citation.d.ts.map +1 -1
  82. package/dist/Citation/Citation.js +20 -6
  83. package/dist/ClickableCard/ClickableCard.d.ts +9 -2
  84. package/dist/ClickableCard/ClickableCard.d.ts.map +1 -1
  85. package/dist/ClickableCard/ClickableCard.js +5 -2
  86. package/dist/CodeBlock/CodeBlock.d.ts.map +1 -1
  87. package/dist/CodeBlock/CodeBlock.js +9 -2
  88. package/dist/CommandPalette/CommandPalette.d.ts +1 -1
  89. package/dist/CommandPalette/CommandPalette.d.ts.map +1 -1
  90. package/dist/CommandPalette/CommandPalette.js +3 -1
  91. package/dist/CommandPalette/CommandPaletteGroup.d.ts.map +1 -1
  92. package/dist/CommandPalette/CommandPaletteGroup.js +9 -2
  93. package/dist/CommandPalette/CommandPaletteInput.d.ts +7 -1
  94. package/dist/CommandPalette/CommandPaletteInput.d.ts.map +1 -1
  95. package/dist/CommandPalette/CommandPaletteInput.js +6 -1
  96. package/dist/CommandPalette/CommandPaletteItem.js +1 -1
  97. package/dist/DateInput/DateInput.d.ts +55 -2
  98. package/dist/DateInput/DateInput.d.ts.map +1 -1
  99. package/dist/DateInput/DateInput.js +28 -2
  100. package/dist/DateInput/index.d.ts +1 -1
  101. package/dist/DateInput/index.d.ts.map +1 -1
  102. package/dist/DateRangeInput/DateRangeInput.d.ts +9 -2
  103. package/dist/DateRangeInput/DateRangeInput.d.ts.map +1 -1
  104. package/dist/DateRangeInput/DateRangeInput.js +3 -1
  105. package/dist/DateTimeInput/DateTimeInput.d.ts.map +1 -1
  106. package/dist/DateTimeInput/DateTimeInput.js +18 -3
  107. package/dist/Dialog/Dialog.d.ts +3 -0
  108. package/dist/Dialog/Dialog.d.ts.map +1 -1
  109. package/dist/Dialog/Dialog.js +57 -6
  110. package/dist/Dialog/DialogContext.d.ts +7 -0
  111. package/dist/Dialog/DialogContext.d.ts.map +1 -1
  112. package/dist/Dialog/DialogContext.js +2 -2
  113. package/dist/Dialog/DialogHeader.d.ts +5 -2
  114. package/dist/Dialog/DialogHeader.d.ts.map +1 -1
  115. package/dist/Dialog/DialogHeader.js +6 -1
  116. package/dist/Divider/Divider.js +1 -1
  117. package/dist/DropdownMenu/DropdownMenuCheckboxItem.d.ts +1 -2
  118. package/dist/DropdownMenu/DropdownMenuCheckboxItem.d.ts.map +1 -1
  119. package/dist/DropdownMenu/DropdownMenuCheckboxItem.js +1 -2
  120. package/dist/DropdownMenu/DropdownMenuItem.js +1 -1
  121. package/dist/DropdownMenu/DropdownMenuRadioGroup.d.ts +1 -2
  122. package/dist/DropdownMenu/DropdownMenuRadioGroup.d.ts.map +1 -1
  123. package/dist/DropdownMenu/DropdownMenuRadioGroup.js +1 -2
  124. package/dist/Field/Field.d.ts.map +1 -1
  125. package/dist/Field/Field.js +2 -3
  126. package/dist/Field/FieldLabel.d.ts +1 -1
  127. package/dist/Field/FieldLabel.d.ts.map +1 -1
  128. package/dist/Field/FieldLabel.js +43 -16
  129. package/dist/FieldStatus/FieldStatus.d.ts +15 -0
  130. package/dist/FieldStatus/FieldStatus.d.ts.map +1 -1
  131. package/dist/FieldStatus/FieldStatus.js +58 -6
  132. package/dist/FileInput/FileInput.d.ts +9 -2
  133. package/dist/FileInput/FileInput.d.ts.map +1 -1
  134. package/dist/FileInput/FileInput.js +42 -20
  135. package/dist/HoverCard/HoverCard.d.ts +9 -1
  136. package/dist/HoverCard/HoverCard.d.ts.map +1 -1
  137. package/dist/HoverCard/HoverCard.js +2 -0
  138. package/dist/HoverCard/useHoverCard.d.ts +8 -0
  139. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  140. package/dist/HoverCard/useHoverCard.js +7 -2
  141. package/dist/Icon/Icon.d.ts +7 -2
  142. package/dist/Icon/Icon.d.ts.map +1 -1
  143. package/dist/Item/Item.d.ts +6 -1
  144. package/dist/Item/Item.d.ts.map +1 -1
  145. package/dist/Item/Item.js +22 -1
  146. package/dist/Layer/useLayer.d.ts +6 -0
  147. package/dist/Layer/useLayer.d.ts.map +1 -1
  148. package/dist/Layer/useLayer.js +2 -0
  149. package/dist/Lightbox/Lightbox.js +4 -4
  150. package/dist/MobileNav/MobileNav.d.ts.map +1 -1
  151. package/dist/MobileNav/MobileNav.js +6 -1
  152. package/dist/MobileNav/MobileNavToggle.d.ts.map +1 -1
  153. package/dist/MobileNav/MobileNavToggle.js +4 -0
  154. package/dist/MultiSelector/MultiSelector.d.ts +9 -1
  155. package/dist/MultiSelector/MultiSelector.d.ts.map +1 -1
  156. package/dist/MultiSelector/MultiSelector.js +41 -12
  157. package/dist/MultiSelector/hooks.d.ts.map +1 -1
  158. package/dist/MultiSelector/hooks.js +16 -0
  159. package/dist/NavMenu/NavHeadingMenuItem.js +1 -1
  160. package/dist/NumberInput/NumberInput.d.ts +9 -2
  161. package/dist/NumberInput/NumberInput.d.ts.map +1 -1
  162. package/dist/NumberInput/NumberInput.js +8 -1
  163. package/dist/Outline/Outline.d.ts +0 -1
  164. package/dist/Outline/Outline.d.ts.map +1 -1
  165. package/dist/Outline/Outline.js +0 -1
  166. package/dist/OverflowList/OverflowList.d.ts +20 -3
  167. package/dist/OverflowList/OverflowList.d.ts.map +1 -1
  168. package/dist/OverflowList/OverflowList.js +29 -4
  169. package/dist/Pagination/Pagination.d.ts.map +1 -1
  170. package/dist/Pagination/Pagination.js +11 -3
  171. package/dist/Popover/Popover.d.ts.map +1 -1
  172. package/dist/Popover/Popover.js +3 -2
  173. package/dist/Popover/usePopover.d.ts.map +1 -1
  174. package/dist/Popover/usePopover.js +3 -9
  175. package/dist/PowerSearch/PowerSearch.d.ts +9 -2
  176. package/dist/PowerSearch/PowerSearch.d.ts.map +1 -1
  177. package/dist/PowerSearch/PowerSearch.js +2 -0
  178. package/dist/PowerSearch/PowerSearchEditPopover.js +1 -1
  179. package/dist/PowerSearch/usePowerSearchSource.d.ts.map +1 -1
  180. package/dist/SelectableCard/SelectableCard.d.ts +9 -2
  181. package/dist/SelectableCard/SelectableCard.d.ts.map +1 -1
  182. package/dist/SelectableCard/SelectableCard.js +16 -13
  183. package/dist/Selector/Selector.d.ts +8 -0
  184. package/dist/Selector/Selector.d.ts.map +1 -1
  185. package/dist/Selector/Selector.js +7 -3
  186. package/dist/Selector/hooks.d.ts.map +1 -1
  187. package/dist/Selector/hooks.js +16 -0
  188. package/dist/SideNav/SideNavCollapseButton.d.ts.map +1 -1
  189. package/dist/SideNav/SideNavHeading.d.ts.map +1 -1
  190. package/dist/SideNav/SideNavHeading.js +21 -8
  191. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  192. package/dist/Slider/Slider.d.ts.map +1 -1
  193. package/dist/Slider/Slider.js +19 -2
  194. package/dist/Stack/stack.stylex.d.ts +9 -9
  195. package/dist/TabList/Tab.js +2 -2
  196. package/dist/TabList/TabMenu.js +1 -1
  197. package/dist/Table/BaseTable.d.ts.map +1 -1
  198. package/dist/Table/BaseTable.js +3 -2
  199. package/dist/Table/TableCell.js +3 -3
  200. package/dist/Table/TableHeaderCell.js +3 -3
  201. package/dist/Table/index.d.ts +2 -0
  202. package/dist/Table/index.d.ts.map +1 -1
  203. package/dist/Table/index.js +1 -0
  204. package/dist/Table/plugins/groupedRows/useTableGroupedRows.d.ts.map +1 -1
  205. package/dist/Table/plugins/rowStatus/index.d.ts +3 -0
  206. package/dist/Table/plugins/rowStatus/index.d.ts.map +1 -0
  207. package/dist/Table/plugins/rowStatus/index.js +3 -0
  208. package/dist/Table/plugins/rowStatus/useTableRowStatus.d.ts +60 -0
  209. package/dist/Table/plugins/rowStatus/useTableRowStatus.d.ts.map +1 -0
  210. package/dist/Table/plugins/rowStatus/useTableRowStatus.js +145 -0
  211. package/dist/Table/plugins/selection/useTableSelection.d.ts +13 -0
  212. package/dist/Table/plugins/selection/useTableSelection.d.ts.map +1 -1
  213. package/dist/Table/plugins/selection/useTableSelection.js +4 -1
  214. package/dist/Table/plugins/stickyColumns/useTableStickyColumns.js +1 -1
  215. package/dist/Table/plugins/tree/useTableTreeData.d.ts +16 -0
  216. package/dist/Table/plugins/tree/useTableTreeData.d.ts.map +1 -1
  217. package/dist/Table/plugins/tree/useTableTreeData.js +87 -0
  218. package/dist/Table/plugins/tree/useTableTreeState.d.ts +6 -0
  219. package/dist/Table/plugins/tree/useTableTreeState.d.ts.map +1 -1
  220. package/dist/Table/plugins/tree/useTableTreeState.js +22 -1
  221. package/dist/Table/useBaseTablePlugins.d.ts.map +1 -1
  222. package/dist/Table/useBaseTablePlugins.js +5 -3
  223. package/dist/TextArea/TextArea.d.ts +9 -1
  224. package/dist/TextArea/TextArea.d.ts.map +1 -1
  225. package/dist/TextArea/TextArea.js +2 -0
  226. package/dist/TextInput/TextInput.d.ts +9 -2
  227. package/dist/TextInput/TextInput.d.ts.map +1 -1
  228. package/dist/TextInput/TextInput.js +6 -1
  229. package/dist/Thumbnail/Thumbnail.d.ts +26 -5
  230. package/dist/Thumbnail/Thumbnail.d.ts.map +1 -1
  231. package/dist/Thumbnail/Thumbnail.js +97 -54
  232. package/dist/Thumbnail/thumbnail.markers.stylex.d.ts +9 -0
  233. package/dist/Thumbnail/thumbnail.markers.stylex.d.ts.map +1 -0
  234. package/dist/Thumbnail/thumbnail.markers.stylex.js +14 -0
  235. package/dist/TimeInput/TimeInput.d.ts +9 -2
  236. package/dist/TimeInput/TimeInput.d.ts.map +1 -1
  237. package/dist/TimeInput/TimeInput.js +17 -4
  238. package/dist/Timestamp/Timestamp.d.ts +3 -1
  239. package/dist/Timestamp/Timestamp.d.ts.map +1 -1
  240. package/dist/Timestamp/Timestamp.js +8 -6
  241. package/dist/Toast/useToast.d.ts.map +1 -1
  242. package/dist/Toast/useToast.js +2 -5
  243. package/dist/ToggleButton/ToggleButtonGroup.d.ts +0 -1
  244. package/dist/ToggleButton/ToggleButtonGroup.d.ts.map +1 -1
  245. package/dist/ToggleButton/ToggleButtonGroup.js +1 -1
  246. package/dist/Tokenizer/Tokenizer.d.ts +10 -3
  247. package/dist/Tokenizer/Tokenizer.d.ts.map +1 -1
  248. package/dist/Tokenizer/Tokenizer.js +18 -4
  249. package/dist/TopNav/TopNavHeading.d.ts.map +1 -1
  250. package/dist/TopNav/TopNavHeading.js +18 -8
  251. package/dist/TopNav/TopNavMegaMenu.js +10 -4
  252. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts +9 -1
  253. package/dist/TopNav/TopNavMegaMenuFeaturedCard.d.ts.map +1 -1
  254. package/dist/TopNav/TopNavMegaMenuFeaturedCard.js +8 -1
  255. package/dist/TopNav/TopNavMenu.d.ts +2 -1
  256. package/dist/TopNav/TopNavMenu.d.ts.map +1 -1
  257. package/dist/TopNav/TopNavMenu.js +68 -6
  258. package/dist/TreeList/TreeList.d.ts +12 -3
  259. package/dist/TreeList/TreeList.d.ts.map +1 -1
  260. package/dist/TreeList/TreeList.js +2 -0
  261. package/dist/TreeList/TreeListBranches.d.ts +5 -0
  262. package/dist/TreeList/TreeListBranches.d.ts.map +1 -1
  263. package/dist/TreeList/TreeListBranches.js +10 -4
  264. package/dist/TreeList/TreeListItem.d.ts +8 -2
  265. package/dist/TreeList/TreeListItem.d.ts.map +1 -1
  266. package/dist/TreeList/TreeListItem.js +28 -8
  267. package/dist/TreeList/TreeListTypes.d.ts +25 -1
  268. package/dist/TreeList/TreeListTypes.d.ts.map +1 -1
  269. package/dist/TreeList/index.d.ts +2 -2
  270. package/dist/TreeList/index.d.ts.map +1 -1
  271. package/dist/Typeahead/BaseTypeahead.d.ts.map +1 -1
  272. package/dist/Typeahead/BaseTypeahead.js +20 -11
  273. package/dist/Typeahead/Typeahead.d.ts +9 -2
  274. package/dist/Typeahead/Typeahead.d.ts.map +1 -1
  275. package/dist/Typeahead/Typeahead.js +2 -0
  276. package/dist/astryx.css +41 -31
  277. package/dist/astryx.umd.js +51 -51
  278. package/dist/astryx.umd.js.map +4 -4
  279. package/dist/authoring/doc.d.ts.map +1 -1
  280. package/dist/docs-types.d.ts +8 -0
  281. package/dist/docs-types.d.ts.map +1 -1
  282. package/dist/hooks/computeOverflow.d.ts +47 -0
  283. package/dist/hooks/computeOverflow.d.ts.map +1 -0
  284. package/dist/hooks/computeOverflow.js +213 -0
  285. package/dist/hooks/index.d.ts +1 -0
  286. package/dist/hooks/index.d.ts.map +1 -1
  287. package/dist/hooks/index.js +2 -1
  288. package/dist/hooks/isRtlElement.d.ts +18 -0
  289. package/dist/hooks/isRtlElement.d.ts.map +1 -0
  290. package/dist/hooks/isRtlElement.js +27 -0
  291. package/dist/hooks/useDevWarning.d.ts +18 -0
  292. package/dist/hooks/useDevWarning.d.ts.map +1 -0
  293. package/dist/hooks/useDevWarning.js +49 -0
  294. package/dist/hooks/useGridFocus.d.ts +6 -1
  295. package/dist/hooks/useGridFocus.d.ts.map +1 -1
  296. package/dist/hooks/useGridFocus.js +12 -9
  297. package/dist/hooks/useListFocus.d.ts +6 -1
  298. package/dist/hooks/useListFocus.d.ts.map +1 -1
  299. package/dist/hooks/useListFocus.js +12 -4
  300. package/dist/hooks/useOverflow.d.ts +19 -0
  301. package/dist/hooks/useOverflow.d.ts.map +1 -1
  302. package/dist/hooks/useOverflow.js +36 -25
  303. package/dist/i18n/InternationalizationContext.d.ts +1 -0
  304. package/dist/i18n/InternationalizationContext.d.ts.map +1 -1
  305. package/dist/i18n/InternationalizationContext.js +3 -0
  306. package/dist/i18n/InternationalizationProvider.d.ts +8 -1
  307. package/dist/i18n/InternationalizationProvider.d.ts.map +1 -1
  308. package/dist/i18n/InternationalizationProvider.js +5 -1
  309. package/dist/i18n/getLocaleDirection.d.ts +18 -0
  310. package/dist/i18n/getLocaleDirection.d.ts.map +1 -0
  311. package/dist/i18n/getLocaleDirection.js +29 -0
  312. package/dist/i18n/index.d.ts +6 -0
  313. package/dist/i18n/index.d.ts.map +1 -1
  314. package/dist/i18n/index.js +7 -1
  315. package/dist/i18n/resolve.d.ts.map +1 -1
  316. package/dist/i18n/resolve.js +7 -18
  317. package/dist/i18n/useDirection.d.ts +2 -0
  318. package/dist/i18n/useDirection.d.ts.map +1 -0
  319. package/dist/i18n/useDirection.js +27 -0
  320. package/dist/theme/Theme.d.ts.map +1 -1
  321. package/dist/theme/Theme.js +2 -7
  322. package/dist/theme/derivedVarRegistry.d.ts.map +1 -1
  323. package/dist/theme/derivedVarRegistry.js +13 -0
  324. package/dist/theme/generateThemeRules.d.ts.map +1 -1
  325. package/dist/theme/generateThemeRules.js +51 -0
  326. package/dist/theme/hct.d.ts +0 -1
  327. package/dist/theme/hct.d.ts.map +1 -1
  328. package/dist/theme/hct.js +1 -1
  329. package/dist/theme/syntax/defineSyntaxTheme.d.ts.map +1 -1
  330. package/dist/theme/syntax/defineSyntaxTheme.js +2 -1
  331. package/dist/utils/devWarning.d.ts +42 -0
  332. package/dist/utils/devWarning.d.ts.map +1 -0
  333. package/dist/utils/devWarning.js +88 -0
  334. package/dist/utils/index.d.ts +3 -1
  335. package/dist/utils/index.d.ts.map +1 -1
  336. package/dist/utils/index.js +3 -2
  337. package/dist/utils/plainDate.d.ts +30 -0
  338. package/dist/utils/plainDate.d.ts.map +1 -1
  339. package/dist/utils/plainDate.js +53 -0
  340. package/dist/utils/types.d.ts +13 -0
  341. package/dist/utils/types.d.ts.map +1 -1
  342. package/locales/en.json +32 -0
  343. package/locales/fr-FR.json +14 -0
  344. package/locales/pseudo.json +24 -0
  345. package/package.json +1 -1
  346. package/src/AppShell/AppShell.tsx +6 -0
  347. package/src/AppShell/AppShellMobileContext.tsx +8 -0
  348. package/src/AppShell/useAppShellMobile.doc.mjs +8 -0
  349. package/src/Avatar/Avatar.doc.mjs +60 -3
  350. package/src/Avatar/Avatar.test.tsx +281 -1
  351. package/src/Avatar/Avatar.tsx +324 -64
  352. package/src/Avatar/AvatarStatusDot.doc.mjs +23 -12
  353. package/src/Avatar/AvatarStatusDot.test.tsx +284 -0
  354. package/src/Avatar/AvatarStatusDot.tsx +178 -21
  355. package/src/AvatarGroup/AvatarGroup.doc.mjs +2 -0
  356. package/src/AvatarGroup/AvatarGroup.test.tsx +125 -0
  357. package/src/AvatarGroup/AvatarGroup.tsx +58 -3
  358. package/src/AvatarGroup/AvatarGroupOverflow.tsx +1 -0
  359. package/src/Banner/Banner.doc.mjs +9 -0
  360. package/src/Banner/Banner.test.tsx +30 -0
  361. package/src/Banner/Banner.tsx +53 -9
  362. package/src/Breadcrumbs/BreadcrumbItem.doc.mjs +26 -0
  363. package/src/Breadcrumbs/BreadcrumbItem.tsx +333 -14
  364. package/src/Breadcrumbs/Breadcrumbs.doc.mjs +2 -0
  365. package/src/Breadcrumbs/Breadcrumbs.test.tsx +284 -2
  366. package/src/Breadcrumbs/index.ts +27 -0
  367. package/src/Button/Button.doc.mjs +9 -4
  368. package/src/Button/Button.test.tsx +49 -0
  369. package/src/Button/Button.tsx +27 -3
  370. package/src/ButtonGroup/ButtonGroup.doc.mjs +3 -0
  371. package/src/ButtonGroup/ButtonGroup.test.tsx +37 -0
  372. package/src/ButtonGroup/ButtonGroup.tsx +32 -0
  373. package/src/Calendar/Calendar.doc.mjs +12 -1
  374. package/src/Calendar/Calendar.test.tsx +193 -0
  375. package/src/Calendar/Calendar.tsx +38 -16
  376. package/src/Calendar/dayCellUtils.test.ts +5 -0
  377. package/src/Calendar/dayCellUtils.ts +1 -1
  378. package/src/Card/Card.doc.mjs +9 -0
  379. package/src/Card/Card.test.tsx +21 -3
  380. package/src/Card/Card.tsx +35 -2
  381. package/src/Carousel/Carousel.doc.mjs +1 -0
  382. package/src/Carousel/Carousel.test.tsx +53 -0
  383. package/src/Carousel/Carousel.tsx +34 -4
  384. package/src/Chat/ChatComposer.doc.mjs +12 -3
  385. package/src/Chat/ChatComposer.test.tsx +115 -0
  386. package/src/Chat/ChatComposer.tsx +73 -9
  387. package/src/Chat/ChatComposerDrawer.test.tsx +61 -0
  388. package/src/Chat/ChatComposerDrawer.tsx +11 -1
  389. package/src/Chat/ChatComposerInput.doc.mjs +7 -0
  390. package/src/Chat/ChatComposerInput.test.tsx +103 -0
  391. package/src/Chat/ChatComposerInput.tsx +51 -5
  392. package/src/Chat/ChatContext.tsx +37 -10
  393. package/src/Chat/ChatDictationButton.tsx +4 -1
  394. package/src/Chat/ChatLayout.tsx +7 -5
  395. package/src/Chat/ChatLayoutScrollButton.tsx +7 -2
  396. package/src/Chat/ChatMessageMetadata.tsx +1 -2
  397. package/src/Chat/ChatSendButton.tsx +11 -1
  398. package/src/Chat/ChatToolCalls.test.tsx +64 -0
  399. package/src/Chat/ChatToolCalls.tsx +25 -4
  400. package/src/Chat/index.ts +5 -1
  401. package/src/Chat/useChatStreamScroll.test.tsx +49 -0
  402. package/src/Chat/useChatStreamScroll.ts +27 -10
  403. package/src/Chat/useSpeechRecognition.ts +1 -1
  404. package/src/Chat/useTriggerMenu.tsx +4 -2
  405. package/src/CheckboxInput/CheckboxInput.test.tsx +32 -1
  406. package/src/CheckboxInput/CheckboxInput.tsx +1 -1
  407. package/src/CheckboxList/CheckboxList.test.tsx +81 -3
  408. package/src/CheckboxList/CheckboxListItem.doc.mjs +33 -5
  409. package/src/CheckboxList/CheckboxListItem.tsx +41 -5
  410. package/src/Citation/Citation.doc.mjs +4 -3
  411. package/src/Citation/Citation.test.tsx +97 -0
  412. package/src/Citation/Citation.tsx +43 -11
  413. package/src/ClickableCard/ClickableCard.doc.mjs +2 -0
  414. package/src/ClickableCard/ClickableCard.test.tsx +34 -0
  415. package/src/ClickableCard/ClickableCard.tsx +13 -3
  416. package/src/CodeBlock/CodeBlock.test.tsx +56 -0
  417. package/src/CodeBlock/CodeBlock.tsx +10 -2
  418. package/src/CommandPalette/CommandPalette.doc.mjs +1 -0
  419. package/src/CommandPalette/CommandPalette.tsx +3 -1
  420. package/src/CommandPalette/CommandPaletteGroup.test.tsx +71 -0
  421. package/src/CommandPalette/CommandPaletteGroup.tsx +12 -1
  422. package/src/CommandPalette/CommandPaletteInput.doc.mjs +26 -9
  423. package/src/CommandPalette/CommandPaletteInput.test.tsx +34 -0
  424. package/src/CommandPalette/CommandPaletteInput.tsx +11 -0
  425. package/src/CommandPalette/CommandPaletteItem.tsx +1 -1
  426. package/src/ContextMenu/ContextMenu.test.tsx +193 -0
  427. package/src/DateInput/DateInput.doc.mjs +31 -0
  428. package/src/DateInput/DateInput.test.tsx +131 -0
  429. package/src/DateInput/DateInput.tsx +78 -3
  430. package/src/DateInput/index.ts +1 -0
  431. package/src/DateRangeInput/DateRangeInput.doc.mjs +8 -0
  432. package/src/DateRangeInput/DateRangeInput.test.tsx +23 -0
  433. package/src/DateRangeInput/DateRangeInput.tsx +13 -3
  434. package/src/DateTimeInput/DateTimeInput.doc.mjs +16 -1
  435. package/src/DateTimeInput/DateTimeInput.test.tsx +147 -0
  436. package/src/DateTimeInput/DateTimeInput.tsx +42 -18
  437. package/src/Dialog/Dialog.doc.mjs +2 -2
  438. package/src/Dialog/Dialog.test.tsx +77 -4
  439. package/src/Dialog/Dialog.tsx +89 -5
  440. package/src/Dialog/DialogContext.ts +9 -2
  441. package/src/Dialog/DialogHeader.doc.mjs +2 -2
  442. package/src/Dialog/DialogHeader.tsx +9 -2
  443. package/src/Divider/Divider.tsx +2 -2
  444. package/src/DropdownMenu/DropdownMenu.test.tsx +169 -0
  445. package/src/DropdownMenu/DropdownMenuCheckboxItem.tsx +1 -2
  446. package/src/DropdownMenu/DropdownMenuItem.tsx +1 -1
  447. package/src/DropdownMenu/DropdownMenuRadioGroup.tsx +1 -2
  448. package/src/Field/Field.test.tsx +57 -12
  449. package/src/Field/Field.tsx +6 -5
  450. package/src/Field/FieldLabel.tsx +9 -1
  451. package/src/FieldStatus/FieldStatus.doc.mjs +17 -5
  452. package/src/FieldStatus/FieldStatus.test.tsx +150 -40
  453. package/src/FieldStatus/FieldStatus.tsx +63 -5
  454. package/src/FileInput/FileInput.doc.mjs +17 -2
  455. package/src/FileInput/FileInput.test.tsx +135 -12
  456. package/src/FileInput/FileInput.tsx +53 -28
  457. package/src/HoverCard/HoverCard.doc.mjs +13 -0
  458. package/src/HoverCard/HoverCard.test.tsx +21 -2
  459. package/src/HoverCard/HoverCard.tsx +11 -0
  460. package/src/HoverCard/useHoverCard.doc.mjs +2 -0
  461. package/src/HoverCard/useHoverCard.tsx +24 -2
  462. package/src/Icon/Icon.doc.mjs +3 -2
  463. package/src/Icon/Icon.tsx +7 -2
  464. package/src/IconButton/IconButton.doc.mjs +8 -0
  465. package/src/IconButton/IconButton.test.tsx +15 -18
  466. package/src/Item/Item.test.tsx +40 -18
  467. package/src/Item/Item.tsx +38 -2
  468. package/src/Layer/useLayer.tsx +8 -0
  469. package/src/Lightbox/Lightbox.tsx +4 -4
  470. package/src/List/List.test.tsx +9 -8
  471. package/src/MobileNav/MobileNav.tsx +12 -1
  472. package/src/MobileNav/MobileNavToggle.test.tsx +116 -0
  473. package/src/MobileNav/MobileNavToggle.tsx +9 -1
  474. package/src/MultiSelector/MultiSelector.doc.mjs +13 -2
  475. package/src/MultiSelector/MultiSelector.test.tsx +195 -3
  476. package/src/MultiSelector/MultiSelector.tsx +65 -12
  477. package/src/MultiSelector/hooks.ts +17 -0
  478. package/src/NavMenu/NavHeadingMenuItem.tsx +1 -1
  479. package/src/NumberInput/NumberInput.doc.mjs +15 -0
  480. package/src/NumberInput/NumberInput.test.tsx +82 -7
  481. package/src/NumberInput/NumberInput.tsx +21 -4
  482. package/src/Outline/Outline.tsx +0 -1
  483. package/src/OverflowList/OverflowList.doc.mjs +39 -6
  484. package/src/OverflowList/OverflowList.test.tsx +111 -0
  485. package/src/OverflowList/OverflowList.tsx +48 -8
  486. package/src/Pagination/Pagination.tsx +11 -3
  487. package/src/Popover/Popover.tsx +7 -4
  488. package/src/Popover/usePopover.tsx +9 -13
  489. package/src/PowerSearch/PowerSearch.doc.mjs +29 -0
  490. package/src/PowerSearch/PowerSearch.test.tsx +43 -0
  491. package/src/PowerSearch/PowerSearch.tsx +10 -1
  492. package/src/PowerSearch/PowerSearchEditPopover.test.tsx +67 -0
  493. package/src/PowerSearch/PowerSearchEditPopover.tsx +1 -1
  494. package/src/PowerSearch/usePowerSearchSource.ts +1 -2
  495. package/src/SelectableCard/SelectableCard.doc.mjs +2 -0
  496. package/src/SelectableCard/SelectableCard.test.tsx +46 -4
  497. package/src/SelectableCard/SelectableCard.tsx +29 -16
  498. package/src/Selector/Selector.doc.mjs +7 -0
  499. package/src/Selector/Selector.test.tsx +92 -0
  500. package/src/Selector/Selector.tsx +16 -2
  501. package/src/Selector/hooks.ts +17 -0
  502. package/src/SideNav/SideNav.test.tsx +119 -3
  503. package/src/SideNav/SideNavCollapseButton.tsx +6 -1
  504. package/src/SideNav/SideNavHeading.tsx +24 -8
  505. package/src/SideNav/SideNavItem.tsx +5 -1
  506. package/src/Slider/Slider.test.tsx +75 -2
  507. package/src/Slider/Slider.tsx +21 -5
  508. package/src/Switch/Switch.test.tsx +32 -1
  509. package/src/TabList/Tab.tsx +2 -2
  510. package/src/TabList/TabMenu.tsx +2 -2
  511. package/src/Table/BaseTable.tsx +3 -5
  512. package/src/Table/TableCell.tsx +3 -3
  513. package/src/Table/TableHeaderCell.tsx +3 -3
  514. package/src/Table/index.ts +5 -0
  515. package/src/Table/plugins/groupedRows/useTableGroupedRows.tsx +6 -2
  516. package/src/Table/plugins/rowStatus/index.ts +7 -0
  517. package/src/Table/plugins/rowStatus/useTableRowStatus.test.tsx +138 -0
  518. package/src/Table/plugins/rowStatus/useTableRowStatus.tsx +189 -0
  519. package/src/Table/plugins/selection/useTableSelection.test.tsx +16 -0
  520. package/src/Table/plugins/selection/useTableSelection.tsx +19 -1
  521. package/src/Table/plugins/stickyColumns/useTableStickyColumns.tsx +1 -1
  522. package/src/Table/plugins/tree/useTableTreeData.test.tsx +135 -3
  523. package/src/Table/plugins/tree/useTableTreeData.tsx +128 -1
  524. package/src/Table/plugins/tree/useTableTreeState.test.tsx +104 -0
  525. package/src/Table/plugins/tree/useTableTreeState.tsx +46 -2
  526. package/src/Table/useBaseTablePlugins.ts +10 -6
  527. package/src/Table/useTableRowStatus.doc.mjs +30 -0
  528. package/src/Table/useTableSelection.doc.mjs +65 -14
  529. package/src/Table/useTableTreeData.doc.mjs +29 -0
  530. package/src/Table/useTableTreeState.doc.mjs +2 -2
  531. package/src/TextArea/TextArea.doc.mjs +15 -0
  532. package/src/TextArea/TextArea.test.tsx +32 -1
  533. package/src/TextArea/TextArea.tsx +10 -0
  534. package/src/TextInput/TextInput.doc.mjs +15 -0
  535. package/src/TextInput/TextInput.test.tsx +44 -0
  536. package/src/TextInput/TextInput.tsx +13 -1
  537. package/src/Thumbnail/Thumbnail.doc.mjs +19 -10
  538. package/src/Thumbnail/Thumbnail.test.tsx +98 -7
  539. package/src/Thumbnail/Thumbnail.tsx +142 -42
  540. package/src/Thumbnail/thumbnail.markers.stylex.ts +12 -0
  541. package/src/TimeInput/TimeInput.doc.mjs +15 -0
  542. package/src/TimeInput/TimeInput.test.tsx +99 -1
  543. package/src/TimeInput/TimeInput.tsx +29 -6
  544. package/src/Timestamp/Timestamp.doc.mjs +4 -4
  545. package/src/Timestamp/Timestamp.test.tsx +32 -0
  546. package/src/Timestamp/Timestamp.tsx +28 -8
  547. package/src/Toast/useToast.tsx +7 -8
  548. package/src/ToggleButton/ToggleButtonGroup.tsx +1 -1
  549. package/src/Tokenizer/Tokenizer.doc.mjs +30 -1
  550. package/src/Tokenizer/Tokenizer.test.tsx +206 -2
  551. package/src/Tokenizer/Tokenizer.tsx +26 -4
  552. package/src/TopNav/TopNav.test.tsx +125 -1
  553. package/src/TopNav/TopNavHeading.tsx +24 -8
  554. package/src/TopNav/TopNavMegaMenu.test.tsx +149 -1
  555. package/src/TopNav/TopNavMegaMenu.tsx +10 -4
  556. package/src/TopNav/TopNavMegaMenuFeaturedCard.doc.mjs +3 -3
  557. package/src/TopNav/TopNavMegaMenuFeaturedCard.tsx +19 -2
  558. package/src/TopNav/TopNavMenu.test.tsx +118 -4
  559. package/src/TopNav/TopNavMenu.tsx +83 -5
  560. package/src/TreeList/TreeList.doc.mjs +22 -0
  561. package/src/TreeList/TreeList.test.tsx +232 -0
  562. package/src/TreeList/TreeList.tsx +18 -2
  563. package/src/TreeList/TreeListBranches.tsx +16 -2
  564. package/src/TreeList/TreeListItem.tsx +52 -12
  565. package/src/TreeList/TreeListTypes.ts +27 -1
  566. package/src/TreeList/index.ts +2 -2
  567. package/src/Typeahead/BaseTypeahead.tsx +30 -15
  568. package/src/Typeahead/Typeahead.doc.mjs +7 -0
  569. package/src/Typeahead/Typeahead.test.tsx +50 -0
  570. package/src/Typeahead/Typeahead.tsx +10 -0
  571. package/src/authoring/doc.ts +1 -3
  572. package/src/docs-types.ts +5 -0
  573. package/src/hooks/computeOverflow.test.ts +422 -0
  574. package/src/hooks/computeOverflow.ts +290 -0
  575. package/src/hooks/index.ts +2 -0
  576. package/src/hooks/isRtlElement.ts +27 -0
  577. package/src/hooks/useDevWarning.test.tsx +45 -0
  578. package/src/hooks/useDevWarning.ts +54 -0
  579. package/src/hooks/useGridFocus.doc.mjs +3 -3
  580. package/src/hooks/useGridFocus.test.tsx +41 -0
  581. package/src/hooks/useGridFocus.ts +21 -10
  582. package/src/hooks/useListFocus.doc.mjs +3 -3
  583. package/src/hooks/useListFocus.test.tsx +67 -1
  584. package/src/hooks/useListFocus.ts +21 -5
  585. package/src/hooks/useOverflow.test.ts +96 -4
  586. package/src/hooks/useOverflow.ts +74 -33
  587. package/src/i18n/InternationalizationContext.ts +4 -0
  588. package/src/i18n/InternationalizationProvider.doc.mjs +99 -2
  589. package/src/i18n/InternationalizationProvider.tsx +12 -2
  590. package/src/i18n/__tests__/getLocaleDirection.test.ts +40 -0
  591. package/src/i18n/__tests__/useDirection.test.tsx +66 -0
  592. package/src/i18n/getLocaleDirection.ts +29 -0
  593. package/src/i18n/index.ts +6 -0
  594. package/src/i18n/resolve.ts +9 -21
  595. package/src/i18n/useDirection.ts +29 -0
  596. package/src/reset.css +0 -26
  597. package/src/reset.test.ts +60 -0
  598. package/src/theme/Theme.tsx +11 -14
  599. package/src/theme/derivedVarRegistry.test.ts +1 -0
  600. package/src/theme/derivedVarRegistry.ts +6 -0
  601. package/src/theme/generateThemeRules.test.ts +107 -0
  602. package/src/theme/generateThemeRules.ts +56 -0
  603. package/src/theme/hct.ts +1 -1
  604. package/src/theme/syntax/defineSyntaxTheme.ts +5 -6
  605. package/src/utils/devWarning.test.ts +56 -0
  606. package/src/utils/devWarning.ts +102 -0
  607. package/src/utils/index.ts +6 -0
  608. package/src/utils/plainDate.test.ts +22 -0
  609. package/src/utils/plainDate.ts +61 -0
  610. package/src/utils/types.ts +14 -0
@@ -834,4 +834,135 @@ describe('DateInput', () => {
834
834
  expect(input).not.toHaveAttribute('aria-disabled');
835
835
  });
836
836
  });
837
+
838
+ describe('format', () => {
839
+ it('defaults to the long-month date_long shape', () => {
840
+ // Non-breaking default: byte-identical to the historical hardcoded
841
+ // DATE_FORMAT_LONG rendering. `format` now defaults to 'date_long'.
842
+ render(<DateInput label="Date" value="2026-01-25" onChange={() => {}} />);
843
+ expect(screen.getByDisplayValue('January 25, 2026')).toBeInTheDocument();
844
+ });
845
+
846
+ it('renders the long-month shape for explicit format="date_long"', () => {
847
+ // Explicit date_long is identical to the unset default above and to the
848
+ // old hardcoded long-month output — real named parity with Timestamp.
849
+ render(
850
+ <DateInput
851
+ label="Date"
852
+ value="2026-01-25"
853
+ onChange={() => {}}
854
+ format="date_long"
855
+ />,
856
+ );
857
+ expect(screen.getByDisplayValue('January 25, 2026')).toBeInTheDocument();
858
+ });
859
+
860
+ it('renders the short-month shape for format="date"', () => {
861
+ // Same literal + same shape as <Timestamp format="date" />.
862
+ render(
863
+ <DateInput
864
+ label="Date"
865
+ value="2026-01-25"
866
+ onChange={() => {}}
867
+ format="date"
868
+ />,
869
+ );
870
+ expect(screen.getByDisplayValue('Jan 25, 2026')).toBeInTheDocument();
871
+ });
872
+
873
+ it('renders the ISO shape for format="system_date"', () => {
874
+ render(
875
+ <DateInput
876
+ label="Date"
877
+ value="2026-01-25"
878
+ onChange={() => {}}
879
+ format="system_date"
880
+ />,
881
+ );
882
+ expect(screen.getByDisplayValue('2026-01-25')).toBeInTheDocument();
883
+ });
884
+
885
+ it('renders a weekday prefix for format="date_weekday"', () => {
886
+ render(
887
+ <DateInput
888
+ label="Date"
889
+ value="2026-01-25"
890
+ onChange={() => {}}
891
+ format="date_weekday"
892
+ />,
893
+ );
894
+ // 2026-01-25 is a Sunday; assert the weekday-prefixed shape without
895
+ // over-fitting locale punctuation.
896
+ const input = screen.getByRole('combobox');
897
+ expect(input).toHaveValue('Sun, Jan 25, 2026');
898
+ });
899
+
900
+ it('supports a custom function format', () => {
901
+ render(
902
+ <DateInput
903
+ label="Date"
904
+ value="2026-01-25"
905
+ onChange={() => {}}
906
+ format={iso => `custom:${iso}`}
907
+ />,
908
+ );
909
+ expect(screen.getByDisplayValue('custom:2026-01-25')).toBeInTheDocument();
910
+ });
911
+
912
+ it('does not apply format to in-progress typed input', async () => {
913
+ const user = userEvent.setup();
914
+ render(
915
+ <DateInput label="Date" onChange={() => {}} format="system_date" />,
916
+ );
917
+ const input = screen.getByRole('combobox');
918
+ await user.click(input);
919
+ await user.type(input, 'January 25');
920
+ // While typing, the raw text is shown verbatim — not reformatted.
921
+ expect(input).toHaveValue('January 25');
922
+ });
923
+
924
+ it('recomputes the display in format on external value change', () => {
925
+ const {rerender} = render(
926
+ <DateInput
927
+ label="Date"
928
+ value="2026-01-25"
929
+ onChange={() => {}}
930
+ format="date"
931
+ />,
932
+ );
933
+ expect(screen.getByDisplayValue('Jan 25, 2026')).toBeInTheDocument();
934
+ rerender(
935
+ <DateInput
936
+ label="Date"
937
+ value="2026-03-10"
938
+ onChange={() => {}}
939
+ format="date"
940
+ />,
941
+ );
942
+ expect(screen.getByDisplayValue('Mar 10, 2026')).toBeInTheDocument();
943
+ });
944
+ });
945
+ });
946
+
947
+
948
+ describe('DateInput statusVariant forwarding', () => {
949
+ it('defaults to attached (status renders with data-variant="attached")', () => {
950
+ const {container} = render(
951
+ <DateInput label="Date" onChange={() => {}} status={{type: 'error', message: 'Bad date'}} />,
952
+ );
953
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
954
+ 'data-variant',
955
+ 'attached',
956
+ );
957
+ });
958
+
959
+ it('forwards statusVariant="detached" to the underlying Field status', () => {
960
+ const {container} = render(
961
+ <DateInput label="Date" onChange={() => {}} status={{type: 'error', message: 'Bad date'}} statusVariant="detached" />,
962
+ );
963
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
964
+ 'data-variant',
965
+ 'detached',
966
+ );
967
+ });
837
968
  });
@@ -42,6 +42,7 @@ import {
42
42
  inputStatusBorderStyles,
43
43
  inputStatusHoverShadowStyles,
44
44
  inputStatusFocusWithinStyles,
45
+ type FieldStatusVariant,
45
46
  } from '../Field';
46
47
  import {Icon} from '../Icon';
47
48
  import {VisuallyHidden} from '../VisuallyHidden';
@@ -57,9 +58,9 @@ import {getInputARIA, parseDateInput} from '../utils';
57
58
  import {
58
59
  plainDateFromISO,
59
60
  plainDateToISO,
60
- plainDateFormat,
61
- DATE_FORMAT_LONG,
61
+ formatSharedDate,
62
62
  } from '../utils/plainDate';
63
+ import type {TimestampFormat} from '../Timestamp';
63
64
 
64
65
  const styles = stylex.create({
65
66
  iconButton: {
@@ -127,6 +128,25 @@ const sizeStyles = stylex.create({
127
128
 
128
129
  export type DateInputSize = keyof typeof sizeStyles;
129
130
 
131
+ /**
132
+ * Named display formats for a committed date value. These are the date-only
133
+ * members of Timestamp's `format` vocabulary — reused verbatim (via
134
+ * `Extract`) so the same literal renders the same date shape in both
135
+ * `Timestamp` and `DateInput`:
136
+ * - `'date'`: locale short-month date, e.g. "Mar 21, 2026"
137
+ * - `'date_long'`: locale long-month date, e.g. "March 21, 2026" (the default)
138
+ * - `'date_weekday'`: short weekday + date, e.g. "Wed, Mar 21, 2026"
139
+ * - `'system_date'`: ISO 8601 calendar date, e.g. "2026-03-21"
140
+ *
141
+ * Because `DateInputFormat` is `Extract`ed from `TimestampFormat`, the two
142
+ * types stay in compile-time lockstep: renaming or removing one of these
143
+ * members from `TimestampFormat` breaks this type at build time.
144
+ */
145
+ export type DateInputFormat = Extract<
146
+ TimestampFormat,
147
+ 'date' | 'date_long' | 'date_weekday' | 'system_date'
148
+ >;
149
+
130
150
  // Re-export shared types for convenience
131
151
 
132
152
  export type {
@@ -259,6 +279,13 @@ export interface DateInputProps extends Omit<
259
279
  * If message is provided, displays below the input.
260
280
  */
261
281
  status?: InputStatus;
282
+ /**
283
+ * How the status message is placed relative to the input.
284
+ * - 'attached': message overlaps directly below the input (bordered treatment)
285
+ * - 'detached': message floats below as a separate element with spacing
286
+ * @default 'attached'
287
+ */
288
+ statusVariant?: FieldStatusVariant;
262
289
 
263
290
  /**
264
291
  * Width of the field. Numbers are treated as pixels, strings are used as-is
@@ -283,6 +310,37 @@ export interface DateInputProps extends Omit<
283
310
  * @default 1
284
311
  */
285
312
  numberOfMonths?: 1 | 2;
313
+
314
+ /**
315
+ * How the committed date value is displayed in the text field. Accepts a
316
+ * named format reused from `Timestamp`'s `format` vocabulary (so the same
317
+ * literal renders the same date shape in both components) or a function that
318
+ * maps the ISO value to a custom display string.
319
+ *
320
+ * - `'date_long'` (default): long-month date, e.g. "March 21, 2026"
321
+ * - `'date'`: short-month date, e.g. "Mar 21, 2026"
322
+ * - `'date_weekday'`: short weekday + date, e.g. "Wed, Mar 21, 2026"
323
+ * - `'system_date'`: ISO 8601 calendar date, e.g. "2026-03-21"
324
+ * - `(value: ISODateString) => string`: fully custom display string
325
+ *
326
+ * Formatting applies only to the committed value — never to text the user is
327
+ * actively typing. A custom function's output that `parseDateInput` cannot
328
+ * read back can't be re-committed after an edit; external `value` changes
329
+ * always recompute the display from the ISO value.
330
+ *
331
+ * @default 'date_long'
332
+ * @example
333
+ * ```
334
+ * <DateInput label="Ship date" value={date} onChange={setDate} format="date" />
335
+ * <DateInput
336
+ * label="Ship date"
337
+ * value={date}
338
+ * onChange={setDate}
339
+ * format={iso => new Date(iso + 'T00:00').toDateString()}
340
+ * />
341
+ * ```
342
+ */
343
+ format?: DateInputFormat | ((value: ISODateString) => string);
286
344
  }
287
345
 
288
346
  /**
@@ -315,9 +373,11 @@ export function DateInput({
315
373
  placeholder: placeholderFromProps,
316
374
  size: sizeProp,
317
375
  status,
376
+ statusVariant = 'attached',
318
377
  labelTooltip,
319
378
  hasClear = false,
320
379
  numberOfMonths = 1,
380
+ format = 'date_long',
321
381
  width,
322
382
  xstyle,
323
383
  className,
@@ -404,12 +464,26 @@ export function DateInput({
404
464
  }
405
465
  }
406
466
 
467
+ // Format a committed ISO value for display. The default `date_long` renders
468
+ // the long-month shape (byte-identical to the historical hardcoded
469
+ // DATE_FORMAT_LONG rendering, so still non-breaking); a function is called
470
+ // with the ISO value; every other named member reuses Timestamp's shared
471
+ // date mapping. Applies ONLY to the committed value, never to in-progress
472
+ // typed input.
473
+ const formatCommittedValue = useCallback(
474
+ (iso: ISODateString): string =>
475
+ typeof format === 'function'
476
+ ? format(iso)
477
+ : formatSharedDate(plainDateFromISO(iso), format),
478
+ [format],
479
+ );
480
+
407
481
  // Display value: pending input if typing, otherwise formatted value
408
482
  const displayValue =
409
483
  pendingInput !== null
410
484
  ? pendingInput
411
485
  : optimisticValue && /^\d{4}-\d{2}-\d{2}$/.test(optimisticValue)
412
- ? plainDateFormat(plainDateFromISO(optimisticValue), DATE_FORMAT_LONG)
486
+ ? formatCommittedValue(optimisticValue)
413
487
  : '';
414
488
 
415
489
  // Check if current input is valid (for styling purposes)
@@ -699,6 +773,7 @@ export function DateInput({
699
773
  }
700
774
  : undefined
701
775
  }
776
+ statusVariant={statusVariant}
702
777
  labelTooltip={labelTooltip}
703
778
  width={width}>
704
779
  {inputWrapper}
@@ -13,6 +13,7 @@ export {DateInput} from './DateInput';
13
13
  export type {
14
14
  DateInputProps,
15
15
  DateInputSize,
16
+ DateInputFormat,
16
17
  DateInputStatus,
17
18
  DateInputStatusType,
18
19
  } from './DateInput';
@@ -127,6 +127,13 @@ export const docs = {
127
127
  type: "{type: 'warning' | 'error' | 'success', message?: string}",
128
128
  description: 'Status indicator for error, warning, or success states.',
129
129
  },
130
+ {
131
+ name: 'statusVariant',
132
+ type: "'attached' | 'detached'",
133
+ description:
134
+ '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.',
135
+ default: "'attached'",
136
+ },
130
137
  {
131
138
  name: 'labelTooltip',
132
139
  type: 'string',
@@ -296,6 +303,7 @@ export const docsDense = {
296
303
  placeholder: 'placeholder when empty',
297
304
  size: 'trigger size',
298
305
  status: 'error/warning/success status',
306
+ statusVariant: 'How status message is placed: attached overlaps below input; detached floats below w/ spacing.',
299
307
  labelTooltip: 'tooltip via info icon at label end',
300
308
  numberOfMonths: 'months in calendar (default 2)',
301
309
  changeAction:
@@ -471,3 +471,26 @@ describe('DateRangeInput', () => {
471
471
  });
472
472
  });
473
473
  });
474
+
475
+
476
+ describe('DateRangeInput statusVariant forwarding', () => {
477
+ it('defaults to attached (status renders with data-variant="attached")', () => {
478
+ const {container} = render(
479
+ <DateRangeInput label="Range" value={null} onChange={() => {}} status={{type: 'error', message: 'Required'}} />,
480
+ );
481
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
482
+ 'data-variant',
483
+ 'attached',
484
+ );
485
+ });
486
+
487
+ it('forwards statusVariant="detached" to the underlying Field status', () => {
488
+ const {container} = render(
489
+ <DateRangeInput label="Range" value={null} onChange={() => {}} status={{type: 'error', message: 'Required'}} statusVariant="detached" />,
490
+ );
491
+ expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
492
+ 'data-variant',
493
+ 'detached',
494
+ );
495
+ });
496
+ });
@@ -43,6 +43,7 @@ import {
43
43
  inputStatusBorderStyles,
44
44
  inputStatusHoverShadowStyles,
45
45
  inputStatusFocusWithinStyles,
46
+ type FieldStatusVariant,
46
47
  } from '../Field';
47
48
  import {Icon} from '../Icon';
48
49
  import {Spinner} from '../Spinner';
@@ -127,9 +128,9 @@ const styles = stylex.create({
127
128
  flexDirection: 'column',
128
129
  gap: spacingVars['--spacing-1'],
129
130
  padding: spacingVars['--spacing-3'],
130
- borderRightWidth: borderVars['--border-width'],
131
- borderRightStyle: 'solid',
132
- borderRightColor: colorVars['--color-border-emphasized'],
131
+ borderInlineEndWidth: borderVars['--border-width'],
132
+ borderInlineEndStyle: 'solid',
133
+ borderInlineEndColor: colorVars['--color-border-emphasized'],
133
134
  minWidth: 140,
134
135
  },
135
136
  presetButton: {
@@ -330,6 +331,13 @@ export interface DateRangeInputProps extends Omit<
330
331
  * Status indicator for the input.
331
332
  */
332
333
  status?: InputStatus;
334
+ /**
335
+ * How the status message is placed relative to the input.
336
+ * - 'attached': message overlaps directly below the input (bordered treatment)
337
+ * - 'detached': message floats below as a separate element with spacing
338
+ * @default 'attached'
339
+ */
340
+ statusVariant?: FieldStatusVariant;
333
341
 
334
342
  /**
335
343
  * Width of the field. Numbers are treated as pixels, strings are used as-is
@@ -385,6 +393,7 @@ export function DateRangeInput({
385
393
  placeholder: placeholderFromProps,
386
394
  size: sizeProp,
387
395
  status,
396
+ statusVariant = 'attached',
388
397
  labelTooltip,
389
398
  numberOfMonths = 2,
390
399
  width,
@@ -529,6 +538,7 @@ export function DateRangeInput({
529
538
  }
530
539
  : undefined
531
540
  }
541
+ statusVariant={statusVariant}
532
542
  labelTooltip={labelTooltip}
533
543
  width={width}>
534
544
  <div
@@ -183,6 +183,14 @@ export const docs = {
183
183
  theming: {
184
184
  targets: [
185
185
  {className: 'astryx-date-time-input', visualProps: ['size', 'status']},
186
+ {
187
+ className: 'astryx-date-time-input-date-segment',
188
+ visualProps: ['size', 'status'],
189
+ },
190
+ {
191
+ className: 'astryx-date-time-input-time-segment',
192
+ visualProps: ['size', 'status'],
193
+ },
186
194
  ],
187
195
  },
188
196
  usage: {
@@ -469,11 +477,18 @@ export const docsZh = {
469
477
  description:
470
478
  '用于布局自定义的 StyleX 样式。必须是 stylex.create() 的值。',
471
479
  },
472
-
473
480
  ],
474
481
  theming: {
475
482
  targets: [
476
483
  {className: 'astryx-date-time-input', visualProps: ['size', 'status']},
484
+ {
485
+ className: 'astryx-date-time-input-date-segment',
486
+ visualProps: ['size', 'status'],
487
+ },
488
+ {
489
+ className: 'astryx-date-time-input-time-segment',
490
+ visualProps: ['size', 'status'],
491
+ },
477
492
  ],
478
493
  },
479
494
  };
@@ -15,6 +15,8 @@ import userEvent from '@testing-library/user-event';
15
15
  import {getButton, queryButton} from '../__tests__/fastRoleQueries';
16
16
  import {DateTimeInput} from './DateTimeInput';
17
17
  import type {ISODateTimeString} from './DateTimeInput';
18
+ import {defineTheme} from '../theme/defineTheme';
19
+ import {generateThemeCSSFlat} from '../theme/generateThemeRules';
18
20
 
19
21
  describe('DateTimeInput', () => {
20
22
  it('renders with label', () => {
@@ -185,6 +187,41 @@ describe('DateTimeInput', () => {
185
187
  );
186
188
  });
187
189
 
190
+ it('opens the calendar popover on ArrowDown (keyboard, forms-13)', () => {
191
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
192
+ const input = screen.getByRole('combobox');
193
+ input.focus();
194
+ expect(input).toHaveAttribute('aria-expanded', 'false');
195
+ fireEvent.keyDown(input, {key: 'ArrowDown'});
196
+ expect(input).toHaveAttribute('aria-expanded', 'true');
197
+ // skipAutoFocus keeps focus in the input, per the APG date-picker pattern
198
+ expect(input).toHaveFocus();
199
+ });
200
+
201
+ it('opens the calendar popover on Alt+ArrowDown (keyboard, forms-13)', () => {
202
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
203
+ const input = screen.getByRole('combobox');
204
+ fireEvent.keyDown(input, {key: 'ArrowDown', altKey: true});
205
+ expect(input).toHaveAttribute('aria-expanded', 'true');
206
+ });
207
+
208
+ it('does not open on ArrowDown when disabled', () => {
209
+ render(<DateTimeInput label="Meeting" isDisabled onChange={() => {}} />);
210
+ const input = screen.getByRole('combobox');
211
+ fireEvent.keyDown(input, {key: 'ArrowDown'});
212
+ expect(input).toHaveAttribute('aria-expanded', 'false');
213
+ });
214
+
215
+ it('does not re-trigger on ArrowDown when the calendar is already open', () => {
216
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
217
+ const input = screen.getByRole('combobox');
218
+ fireEvent.keyDown(input, {key: 'ArrowDown'});
219
+ expect(input).toHaveAttribute('aria-expanded', 'true');
220
+ // A second ArrowDown is a no-op: the calendar stays open
221
+ fireEvent.keyDown(input, {key: 'ArrowDown'});
222
+ expect(input).toHaveAttribute('aria-expanded', 'true');
223
+ });
224
+
188
225
  it('calendar button is focusable and clickable', () => {
189
226
  render(<DateTimeInput label="Meeting" onChange={() => {}} />);
190
227
  const button = getButton('Open calendar');
@@ -779,4 +816,114 @@ describe('DateTimeInput', () => {
779
816
  expect(onChange.mock.calls[0][0]).toContain('14:31');
780
817
  });
781
818
  });
819
+ // ===========================================================================
820
+ // Segment theme targets (#4075)
821
+ // ===========================================================================
822
+
823
+ describe('segment theme targets', () => {
824
+ // The root only publishes `astryx-date-time-input`; the date and time
825
+ // wrappers were anonymous nodes carrying hashed atomic classes only, so a
826
+ // theme that restyles input geometry through the text-input/date-input/
827
+ // time-input targets could not reach them and DateTimeInput rendered
828
+ // shorter than every other input under that theme.
829
+
830
+ it('renders the date segment target on the date wrapper', () => {
831
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
832
+ const wrapper = screen
833
+ .getByLabelText('Meeting')
834
+ .closest('.astryx-date-time-input-date-segment');
835
+
836
+ expect(wrapper).not.toBeNull();
837
+ // The wrapper is the input's own container, not an ancestor further up.
838
+ expect(wrapper).toBe(screen.getByLabelText('Meeting').parentElement);
839
+ });
840
+
841
+ it('renders the time segment target on the time wrapper', () => {
842
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
843
+ const wrapper = screen
844
+ .getByLabelText('Meeting time')
845
+ .closest('.astryx-date-time-input-time-segment');
846
+
847
+ expect(wrapper).not.toBeNull();
848
+ expect(wrapper).toBe(screen.getByLabelText('Meeting time').parentElement);
849
+ });
850
+
851
+ it('reflects size on both segments so themes can restyle geometry', () => {
852
+ render(<DateTimeInput label="Meeting" size="lg" onChange={() => {}} />);
853
+
854
+ const date = screen
855
+ .getByLabelText('Meeting')
856
+ .closest('.astryx-date-time-input-date-segment');
857
+ const time = screen
858
+ .getByLabelText('Meeting time')
859
+ .closest('.astryx-date-time-input-time-segment');
860
+
861
+ expect(date).toHaveAttribute('data-size', 'lg');
862
+ expect(date).toHaveClass('lg');
863
+ expect(time).toHaveAttribute('data-size', 'lg');
864
+ expect(time).toHaveClass('lg');
865
+ });
866
+
867
+ it('reflects status on both segments, mirroring the root', () => {
868
+ render(
869
+ <DateTimeInput
870
+ label="Meeting"
871
+ status={{type: 'error', message: 'Required'}}
872
+ onChange={() => {}}
873
+ />,
874
+ );
875
+
876
+ const date = screen
877
+ .getByLabelText('Meeting')
878
+ .closest('.astryx-date-time-input-date-segment');
879
+ const time = screen
880
+ .getByLabelText('Meeting time')
881
+ .closest('.astryx-date-time-input-time-segment');
882
+
883
+ expect(date).toHaveAttribute('data-status', 'error');
884
+ expect(time).toHaveAttribute('data-status', 'error');
885
+ });
886
+
887
+ it('omits data-status when there is no status, like the root does', () => {
888
+ render(<DateTimeInput label="Meeting" onChange={() => {}} />);
889
+
890
+ const date = screen
891
+ .getByLabelText('Meeting')
892
+ .closest('.astryx-date-time-input-date-segment');
893
+
894
+ expect(date).not.toHaveAttribute('data-status');
895
+ });
896
+
897
+ it('keeps the root target intact', () => {
898
+ const {container} = render(
899
+ <DateTimeInput label="Meeting" onChange={() => {}} />,
900
+ );
901
+ // Additive change — the existing root target still renders.
902
+ expect(container.querySelector('.astryx-date-time-input')).not.toBeNull();
903
+ });
904
+
905
+ it('exposes both segments as themeable defineTheme targets', () => {
906
+ // jsdom cannot resolve the @layer cascade, so the generated CSS is what
907
+ // proves a theme can actually reach these nodes.
908
+ const theme = defineTheme({
909
+ name: 'date-time-input-segments-test',
910
+ components: {
911
+ 'date-time-input-date-segment': {
912
+ base: {blockSize: 'var(--size-element-lg)'},
913
+ lg: {paddingInline: 'var(--spacing-4)'},
914
+ },
915
+ 'date-time-input-time-segment': {
916
+ base: {blockSize: 'var(--size-element-lg)'},
917
+ },
918
+ },
919
+ });
920
+ const css = generateThemeCSSFlat(theme);
921
+
922
+ expect(css).toContain('.astryx-date-time-input-date-segment {');
923
+ expect(css).toContain('.astryx-date-time-input-date-segment.lg');
924
+ expect(css).toContain('.astryx-date-time-input-time-segment {');
925
+ expect(css).toContain('block-size: var(--size-element-lg)');
926
+ expect(css).toContain('padding-inline: var(--spacing-4)');
927
+ });
928
+ });
782
929
  });
@@ -719,12 +719,22 @@ export function DateTimeInput({
719
719
  if (e.key === 'Escape' && popover.isOpen) {
720
720
  e.preventDefault();
721
721
  popover.hide();
722
+ } else if (
723
+ (e.key === 'ArrowDown' || (e.altKey && e.key === 'ArrowDown')) &&
724
+ !popover.isOpen
725
+ ) {
726
+ // APG combobox: ArrowDown (and Alt+ArrowDown) opens the calendar
727
+ // popover from the keyboard, keeping focus in the input (forms-13).
728
+ e.preventDefault();
729
+ if (!isEffectivelyDisabled) {
730
+ popover.show({skipAutoFocus: true});
731
+ }
722
732
  } else if (e.key === 'Enter') {
723
733
  e.preventDefault();
724
734
  commitDatePendingInput();
725
735
  }
726
736
  },
727
- [popover, commitDatePendingInput],
737
+ [popover, commitDatePendingInput, isEffectivelyDisabled],
728
738
  );
729
739
 
730
740
  // --- Time handlers ---
@@ -880,14 +890,20 @@ export function DateTimeInput({
880
890
  {/* Date input */}
881
891
  <div
882
892
  ref={popover.triggerRef}
883
- {...stylex.props(
884
- inputWrapperStyles.base,
885
- sizeStyles[size],
886
- styles.dateWrapper,
887
- isEffectivelyDisabled && inputWrapperStyles.disabled,
888
- status && inputStatusBorderStyles[status.type],
889
- status && inputStatusHoverShadowStyles[status.type],
890
- status && inputStatusFocusWithinStyles[status.type],
893
+ {...mergeProps(
894
+ themeProps('date-time-input-date-segment', {
895
+ size,
896
+ status: status?.type ?? null,
897
+ }),
898
+ stylex.props(
899
+ inputWrapperStyles.base,
900
+ sizeStyles[size],
901
+ styles.dateWrapper,
902
+ isEffectivelyDisabled && inputWrapperStyles.disabled,
903
+ status && inputStatusBorderStyles[status.type],
904
+ status && inputStatusHoverShadowStyles[status.type],
905
+ status && inputStatusFocusWithinStyles[status.type],
906
+ ),
891
907
  )}>
892
908
  <button
893
909
  type="button"
@@ -972,14 +988,20 @@ export function DateTimeInput({
972
988
  ref={timeContainerRef}
973
989
  onClick={handleTimeWrapperClick}
974
990
  onMouseUp={handleTimeWrapperMouseUp}
975
- {...stylex.props(
976
- inputWrapperStyles.base,
977
- sizeStyles[size],
978
- styles.timeWrapper,
979
- isEffectivelyDisabled && inputWrapperStyles.disabled,
980
- status && inputStatusBorderStyles[status.type],
981
- status && inputStatusHoverShadowStyles[status.type],
982
- status && inputStatusFocusWithinStyles[status.type],
991
+ {...mergeProps(
992
+ themeProps('date-time-input-time-segment', {
993
+ size,
994
+ status: status?.type ?? null,
995
+ }),
996
+ stylex.props(
997
+ inputWrapperStyles.base,
998
+ sizeStyles[size],
999
+ styles.timeWrapper,
1000
+ isEffectivelyDisabled && inputWrapperStyles.disabled,
1001
+ status && inputStatusBorderStyles[status.type],
1002
+ status && inputStatusHoverShadowStyles[status.type],
1003
+ status && inputStatusFocusWithinStyles[status.type],
1004
+ ),
983
1005
  )}>
984
1006
  <div {...stylex.props(styles.icon)}>
985
1007
  <Icon icon="clock" size="sm" color="secondary" />
@@ -1000,7 +1022,9 @@ export function DateTimeInput({
1000
1022
  disabled={isEffectivelyDisabled && !showsDisabledMessage}
1001
1023
  aria-disabled={showsDisabledMessage ? 'true' : undefined}
1002
1024
  readOnly={showsDisabledMessage || undefined}
1003
- aria-label={timeLabel ?? t('@astryx.dateTimeInput.timeSuffix', {label})}
1025
+ aria-label={
1026
+ timeLabel ?? t('@astryx.dateTimeInput.timeSuffix', {label})
1027
+ }
1004
1028
  aria-describedby={ariaDescribedBy}
1005
1029
  aria-required={isRequired === true ? 'true' : undefined}
1006
1030
  aria-invalid={