@astryxdesign/core 0.7.2-canary.f16dc9f → 0.7.2-canary.f2b60a0

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 (307) hide show
  1. package/dist/AppShell/AppShell.d.ts.map +1 -1
  2. package/dist/AppShell/AppShell.js +40 -1
  3. package/dist/AspectRatio/AspectRatio.d.ts +6 -8
  4. package/dist/AspectRatio/AspectRatio.d.ts.map +1 -1
  5. package/dist/AspectRatio/AspectRatio.js +44 -3
  6. package/dist/Breadcrumbs/BreadcrumbItem.d.ts.map +1 -1
  7. package/dist/Breadcrumbs/BreadcrumbItem.js +5 -2
  8. package/dist/CheckboxInput/CheckboxInput.d.ts +1 -1
  9. package/dist/CheckboxInput/CheckboxInput.d.ts.map +1 -1
  10. package/dist/CheckboxInput/CheckboxInput.js +3 -1
  11. package/dist/CheckboxList/CheckboxListItem.d.ts +9 -1
  12. package/dist/CheckboxList/CheckboxListItem.d.ts.map +1 -1
  13. package/dist/CheckboxList/CheckboxListItem.js +4 -2
  14. package/dist/CommandPalette/CommandPaletteInput.d.ts +1 -1
  15. package/dist/CommandPalette/CommandPaletteInput.d.ts.map +1 -1
  16. package/dist/CommandPalette/CommandPaletteInput.js +37 -5
  17. package/dist/ContextMenu/ContextMenu.d.ts.map +1 -1
  18. package/dist/ContextMenu/ContextMenu.js +5 -2
  19. package/dist/Dialog/Dialog.d.ts.map +1 -1
  20. package/dist/Dialog/Dialog.js +20 -8
  21. package/dist/Drawer/Drawer.d.ts +191 -0
  22. package/dist/Drawer/Drawer.d.ts.map +1 -0
  23. package/dist/Drawer/Drawer.js +382 -0
  24. package/dist/Drawer/DrawerHeader.d.ts +85 -0
  25. package/dist/Drawer/DrawerHeader.d.ts.map +1 -0
  26. package/dist/Drawer/DrawerHeader.js +134 -0
  27. package/dist/Drawer/index.d.ts +11 -0
  28. package/dist/Drawer/index.d.ts.map +1 -0
  29. package/dist/Drawer/index.js +11 -0
  30. package/dist/Drawer/useDrawerDialogPresence.d.ts +42 -0
  31. package/dist/Drawer/useDrawerDialogPresence.d.ts.map +1 -0
  32. package/dist/Drawer/useDrawerDialogPresence.js +236 -0
  33. package/dist/DropdownMenu/DropdownMenu.d.ts +1 -1
  34. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  35. package/dist/DropdownMenu/DropdownMenu.js +83 -11
  36. package/dist/DropdownMenu/DropdownMenuContext.d.ts +17 -0
  37. package/dist/DropdownMenu/DropdownMenuContext.d.ts.map +1 -1
  38. package/dist/DropdownMenu/DropdownMenuContext.js +21 -0
  39. package/dist/DropdownMenu/DropdownMenuDivider.d.ts +5 -3
  40. package/dist/DropdownMenu/DropdownMenuDivider.d.ts.map +1 -1
  41. package/dist/DropdownMenu/DropdownMenuDivider.js +7 -3
  42. package/dist/DropdownMenu/DropdownMenuSubMenu.d.ts.map +1 -1
  43. package/dist/DropdownMenu/DropdownMenuSubMenu.js +19 -8
  44. package/dist/DropdownMenu/lazyMenuBottomSheet.d.ts +24 -0
  45. package/dist/DropdownMenu/lazyMenuBottomSheet.d.ts.map +1 -0
  46. package/dist/DropdownMenu/lazyMenuBottomSheet.js +46 -0
  47. package/dist/EmptyState/EmptyState.d.ts.map +1 -1
  48. package/dist/EmptyState/EmptyState.js +4 -10
  49. package/dist/Field/Field.d.ts +1 -1
  50. package/dist/Field/Field.d.ts.map +1 -1
  51. package/dist/Field/Field.js +8 -4
  52. package/dist/Grid/GridSpan.d.ts.map +1 -1
  53. package/dist/Grid/GridSpan.js +1 -0
  54. package/dist/Heading/Heading.d.ts.map +1 -1
  55. package/dist/Heading/Heading.js +4 -2
  56. package/dist/HoverCard/useHoverCard.d.ts.map +1 -1
  57. package/dist/HoverCard/useHoverCard.js +10 -2
  58. package/dist/Item/Item.d.ts +6 -2
  59. package/dist/Item/Item.d.ts.map +1 -1
  60. package/dist/Item/Item.js +19 -4
  61. package/dist/Layer/layerViewportInset.stylex.d.ts +6 -2
  62. package/dist/Layer/layerViewportInset.stylex.d.ts.map +1 -1
  63. package/dist/Layer/layerViewportInset.stylex.js +6 -2
  64. package/dist/Layer/useLayer.d.ts.map +1 -1
  65. package/dist/Layer/useLayer.js +13 -7
  66. package/dist/Layer/useLayerDismissal.d.ts +1 -1
  67. package/dist/Layer/useLayerDismissal.js +1 -1
  68. package/dist/Layout/container.stylex.d.ts +5 -5
  69. package/dist/Layout/container.stylex.js +4 -4
  70. package/dist/List/List.d.ts +46 -19
  71. package/dist/List/List.d.ts.map +1 -1
  72. package/dist/List/List.js +28 -10
  73. package/dist/List/ListContext.d.ts +8 -3
  74. package/dist/List/ListContext.d.ts.map +1 -1
  75. package/dist/List/ListContext.js +7 -2
  76. package/dist/List/ListItem.d.ts +13 -5
  77. package/dist/List/ListItem.d.ts.map +1 -1
  78. package/dist/List/ListItem.js +21 -8
  79. package/dist/List/index.d.ts +1 -1
  80. package/dist/List/index.d.ts.map +1 -1
  81. package/dist/Markdown/Markdown.d.ts.map +1 -1
  82. package/dist/Markdown/Markdown.js +8 -1
  83. package/dist/Markdown/plugins/frontmatter.d.ts.map +1 -1
  84. package/dist/Markdown/plugins/frontmatter.js +7 -3
  85. package/dist/MetadataList/MetadataList.d.ts.map +1 -1
  86. package/dist/MetadataList/MetadataList.js +5 -1
  87. package/dist/MetadataList/MetadataListContext.d.ts +1 -1
  88. package/dist/MetadataList/MetadataListContext.d.ts.map +1 -1
  89. package/dist/MobileNav/MobileNav.d.ts +9 -0
  90. package/dist/MobileNav/MobileNav.d.ts.map +1 -1
  91. package/dist/MobileNav/MobileNav.js +30 -3
  92. package/dist/MultiSelector/MultiSelector.d.ts.map +1 -1
  93. package/dist/MultiSelector/MultiSelector.js +22 -8
  94. package/dist/MultiSelector/OptionActions.a11y.chromium.spec.js +100 -2
  95. package/dist/Popover/Popover.js +2 -2
  96. package/dist/RadioList/RadioList.d.ts +1 -1
  97. package/dist/RadioList/RadioList.d.ts.map +1 -1
  98. package/dist/RadioList/RadioList.js +6 -2
  99. package/dist/RadioList/RadioListItem.d.ts +9 -1
  100. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  101. package/dist/RadioList/RadioListItem.js +2 -0
  102. package/dist/SideNav/SideNavItem.d.ts +8 -1
  103. package/dist/SideNav/SideNavItem.d.ts.map +1 -1
  104. package/dist/SideNav/SideNavItem.js +71 -9
  105. package/dist/TabList/TabMenu.d.ts +2 -2
  106. package/dist/TabList/TabMenu.d.ts.map +1 -1
  107. package/dist/TabList/TabMenu.js +6 -3
  108. package/dist/Text/Text.d.ts.map +1 -1
  109. package/dist/Text/Text.js +4 -2
  110. package/dist/Text/useTruncation.d.ts +7 -5
  111. package/dist/Text/useTruncation.d.ts.map +1 -1
  112. package/dist/Text/useTruncation.js +16 -5
  113. package/dist/ToggleButton/ToggleButton.d.ts +3 -2
  114. package/dist/ToggleButton/ToggleButton.d.ts.map +1 -1
  115. package/dist/ToggleButton/ToggleButton.js +12 -1
  116. package/dist/TopNav/TopNavMegaMenu.d.ts.map +1 -1
  117. package/dist/TopNav/TopNavMegaMenu.js +3 -3
  118. package/dist/TopNav/TopNavMenu.d.ts.map +1 -1
  119. package/dist/TopNav/TopNavMenu.js +3 -3
  120. package/dist/TreeList/TreeList.d.ts.map +1 -1
  121. package/dist/TreeList/TreeList.js +1 -0
  122. package/dist/TreeList/TreeListBranches.d.ts.map +1 -1
  123. package/dist/TreeList/TreeListBranches.js +2 -2
  124. package/dist/TreeList/TreeListItem.d.ts.map +1 -1
  125. package/dist/TreeList/TreeListItem.js +57 -9
  126. package/dist/astryx.css +46 -13
  127. package/dist/hooks/useEntryAnimation.d.ts +2 -1
  128. package/dist/hooks/useEntryAnimation.d.ts.map +1 -1
  129. package/dist/hooks/useEntryAnimation.js +14 -12
  130. package/dist/hooks/useIsHydrating.d.ts +6 -0
  131. package/dist/hooks/useIsHydrating.d.ts.map +1 -0
  132. package/dist/hooks/useIsHydrating.js +30 -0
  133. package/dist/hooks/useMenuHover.d.ts.map +1 -1
  134. package/dist/hooks/useMenuHover.js +18 -13
  135. package/dist/i18n/generated-locales/en.generated.d.ts.map +1 -1
  136. package/dist/i18n/generated-locales/en.generated.js +93 -1
  137. package/dist/i18n/generated-locales/pseudo.generated.d.ts.map +1 -1
  138. package/dist/i18n/generated-locales/pseudo.generated.js +93 -1
  139. package/dist/index.d.ts +1 -0
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +1 -0
  142. package/dist/theme/derivedVarRegistry.d.ts.map +1 -1
  143. package/dist/theme/derivedVarRegistry.js +0 -3
  144. package/dist/utils/focusOutline.stylex.d.ts +4 -0
  145. package/dist/utils/focusOutline.stylex.d.ts.map +1 -1
  146. package/dist/utils/focusOutline.stylex.js +4 -0
  147. package/dist/utils/plainDate.d.ts.map +1 -1
  148. package/dist/utils/plainDate.js +15 -9
  149. package/dist/utils/sharedMutationObserver.d.ts +21 -0
  150. package/dist/utils/sharedMutationObserver.d.ts.map +1 -0
  151. package/dist/utils/sharedMutationObserver.js +69 -0
  152. package/locales/en.json +368 -0
  153. package/locales/pseudo.json +276 -0
  154. package/package.json +8 -3
  155. package/scripts/agent-doc-state.mjs +38 -0
  156. package/scripts/postinstall.mjs +1 -1
  157. package/src/AppShell/AppShell.tsx +45 -1
  158. package/src/AspectRatio/AspectRatio.test.tsx +44 -43
  159. package/src/AspectRatio/AspectRatio.tsx +38 -18
  160. package/src/AspectRatio/__tests__/AspectRatioFitLayers.a11y.browser.spec.ts +157 -0
  161. package/src/Avatar/Avatar.doc.mjs +5 -3
  162. package/src/AvatarGroup/AvatarGroup.doc.mjs +3 -2
  163. package/src/Breadcrumbs/BreadcrumbItem.tsx +4 -1
  164. package/src/Breadcrumbs/Breadcrumbs.test.tsx +30 -1
  165. package/src/Card/Card.doc.mjs +1 -1
  166. package/src/Chat/__tests__/ChatMessageMetadata.a11y.chromium.spec.ts +3 -1
  167. package/src/CheckboxInput/CheckboxInput.test.tsx +34 -0
  168. package/src/CheckboxInput/CheckboxInput.tsx +3 -1
  169. package/src/CheckboxList/CheckboxList.test.tsx +22 -0
  170. package/src/CheckboxList/CheckboxListItem.doc.mjs +16 -0
  171. package/src/CheckboxList/CheckboxListItem.tsx +10 -0
  172. package/src/CommandPalette/CommandPaletteInput.test.tsx +53 -4
  173. package/src/CommandPalette/CommandPaletteInput.tsx +33 -3
  174. package/src/CommandPalette/__tests__/CommandPaletteInputAudit.a11y.chromium.spec.ts +335 -0
  175. package/src/CommandPalette/__tests__/CommandPaletteItemAudit.a11y.chromium.spec.ts +292 -0
  176. package/src/ContextMenu/ContextMenu.doc.mjs +2 -3
  177. package/src/ContextMenu/ContextMenu.tsx +4 -1
  178. package/src/ContextMenu/__tests__/ContextMenuAudit.a11y.chromium.spec.ts +438 -0
  179. package/src/Dialog/Dialog.test.tsx +46 -0
  180. package/src/Dialog/Dialog.tsx +20 -7
  181. package/src/Dialog/__tests__/Dialog.a11y.known-failures.ts +0 -14
  182. package/src/Drawer/Drawer.doc.mjs +472 -0
  183. package/src/Drawer/Drawer.spec.md +357 -0
  184. package/src/Drawer/Drawer.test.tsx +1300 -0
  185. package/src/Drawer/Drawer.tsx +613 -0
  186. package/src/Drawer/DrawerDirection.test.tsx +127 -0
  187. package/src/Drawer/DrawerHeader.doc.mjs +293 -0
  188. package/src/Drawer/DrawerHeader.test.tsx +102 -0
  189. package/src/Drawer/DrawerHeader.tsx +235 -0
  190. package/src/Drawer/__tests__/DrawerAudit.a11y.chromium.spec.ts +401 -0
  191. package/src/Drawer/__tests__/DrawerHeaderAudit.a11y.chromium.spec.ts +297 -0
  192. package/src/Drawer/index.ts +13 -0
  193. package/src/Drawer/useDrawerDialogPresence.ts +284 -0
  194. package/src/DropdownMenu/DropdownMenu.ssr.test.tsx +57 -0
  195. package/src/DropdownMenu/DropdownMenu.test.tsx +76 -14
  196. package/src/DropdownMenu/DropdownMenu.tsx +83 -12
  197. package/src/DropdownMenu/DropdownMenuContext.tsx +24 -0
  198. package/src/DropdownMenu/DropdownMenuDivider.doc.mjs +2 -2
  199. package/src/DropdownMenu/DropdownMenuDivider.spec.md +192 -0
  200. package/src/DropdownMenu/DropdownMenuDivider.tsx +9 -5
  201. package/src/DropdownMenu/DropdownMenuLazySheet.test.tsx +126 -0
  202. package/src/DropdownMenu/DropdownMenuSubMenu.test.tsx +185 -0
  203. package/src/DropdownMenu/DropdownMenuSubMenu.tsx +19 -5
  204. package/src/DropdownMenu/__tests__/DropdownMenuDividerAudit.a11y.chromium.spec.ts +280 -0
  205. package/src/DropdownMenu/__tests__/Menu.a11y.chromium.spec.ts +145 -0
  206. package/src/DropdownMenu/__tests__/Menu.a11y.known-failures.ts +26 -0
  207. package/src/DropdownMenu/__tests__/Menu.a11y.renders.tsx +65 -0
  208. package/src/DropdownMenu/__tests__/Menu.a11y.states.ts +138 -0
  209. package/src/DropdownMenu/__tests__/Menu.a11y.test.tsx +136 -0
  210. package/src/DropdownMenu/__tests__/warmMenuBottomSheet.tsx +43 -0
  211. package/src/DropdownMenu/lazyMenuBottomSheet.ts +71 -0
  212. package/src/EmptyState/EmptyState.doc.mjs +3 -2
  213. package/src/EmptyState/EmptyState.spec.md +189 -0
  214. package/src/EmptyState/EmptyState.test.tsx +74 -3
  215. package/src/EmptyState/EmptyState.tsx +4 -8
  216. package/src/Field/Field.doc.mjs +14 -8
  217. package/src/Field/Field.spec.md +217 -0
  218. package/src/Field/Field.test.tsx +60 -2
  219. package/src/Field/Field.tsx +17 -8
  220. package/src/Grid/GridSpan.tsx +3 -0
  221. package/src/Heading/Heading.test.tsx +57 -0
  222. package/src/Heading/Heading.tsx +6 -2
  223. package/src/HoverCard/HoverCard.test.tsx +58 -0
  224. package/src/HoverCard/useHoverCard.tsx +10 -2
  225. package/src/Item/Item.doc.mjs +12 -8
  226. package/src/Item/Item.spec.md +226 -0
  227. package/src/Item/Item.test.tsx +61 -0
  228. package/src/Item/Item.tsx +40 -4
  229. package/src/Layer/layerViewportInset.source-build.test.mjs +90 -0
  230. package/src/Layer/layerViewportInset.stylex.ts +6 -2
  231. package/src/Layer/layerViewportInset.test.ts +1 -0
  232. package/src/Layer/useLayer.tsx +24 -13
  233. package/src/Layer/useLayerDismissal.ts +1 -1
  234. package/src/Layout/container.stylex.ts +6 -6
  235. package/src/List/List.doc.mjs +14 -1
  236. package/src/List/List.spec.md +129 -77
  237. package/src/List/List.test.tsx +163 -94
  238. package/src/List/List.tsx +74 -18
  239. package/src/List/ListContext.tsx +9 -3
  240. package/src/List/ListItem.doc.mjs +16 -0
  241. package/src/List/ListItem.tsx +56 -27
  242. package/src/List/index.ts +1 -1
  243. package/src/Markdown/Markdown.tsx +14 -1
  244. package/src/Markdown/plugins/frontmatter.test.tsx +25 -0
  245. package/src/Markdown/plugins/frontmatter.ts +7 -3
  246. package/src/MetadataList/MetadataList.doc.mjs +2 -2
  247. package/src/MetadataList/MetadataList.test.tsx +38 -0
  248. package/src/MetadataList/MetadataList.tsx +8 -1
  249. package/src/MetadataList/MetadataListContext.tsx +1 -1
  250. package/src/MobileNav/MobileNav.tsx +30 -3
  251. package/src/MobileNav/MobileNavCloseEdgeCases.test.tsx +173 -15
  252. package/src/MoreMenu/MoreMenu.test.tsx +5 -1
  253. package/src/MultiSelector/MultiSelector.test.tsx +159 -0
  254. package/src/MultiSelector/MultiSelector.tsx +40 -7
  255. package/src/MultiSelector/OptionActions.a11y.chromium.spec.ts +112 -2
  256. package/src/Popover/Popover.test.tsx +2 -2
  257. package/src/Popover/Popover.tsx +4 -4
  258. package/src/RadioList/RadioList.fr10.test.tsx +45 -2
  259. package/src/RadioList/RadioList.test.tsx +22 -0
  260. package/src/RadioList/RadioList.tsx +4 -1
  261. package/src/RadioList/RadioListItem.doc.mjs +16 -0
  262. package/src/RadioList/RadioListItem.tsx +10 -1
  263. package/src/SideNav/SideNav.test.tsx +179 -0
  264. package/src/SideNav/SideNavItem.doc.mjs +2 -2
  265. package/src/SideNav/SideNavItem.tsx +96 -17
  266. package/src/Slider/Slider.spec.md +39 -18
  267. package/src/TabList/TabList.spec.md +57 -44
  268. package/src/TabList/TabList.test.tsx +67 -0
  269. package/src/TabList/TabMenu.doc.mjs +4 -3
  270. package/src/TabList/TabMenu.tsx +7 -4
  271. package/src/Text/Text.test.tsx +57 -0
  272. package/src/Text/Text.tsx +6 -2
  273. package/src/Text/useTruncation.test.tsx +69 -0
  274. package/src/Text/useTruncation.ts +16 -5
  275. package/src/TimeInput/TimeInput.fr10.test.tsx +15 -0
  276. package/src/ToggleButton/ToggleButton.test.tsx +95 -0
  277. package/src/ToggleButton/ToggleButton.tsx +12 -1
  278. package/src/Tooltip/Tooltip.test.tsx +31 -0
  279. package/src/TopNav/TopNavMegaMenu.test.tsx +22 -0
  280. package/src/TopNav/TopNavMegaMenu.tsx +7 -3
  281. package/src/TopNav/TopNavMenu.test.tsx +19 -0
  282. package/src/TopNav/TopNavMenu.tsx +11 -3
  283. package/src/TreeList/TreeList.doc.mjs +1 -0
  284. package/src/TreeList/TreeList.spec.md +29 -17
  285. package/src/TreeList/TreeList.test.tsx +327 -6
  286. package/src/TreeList/TreeList.tsx +5 -1
  287. package/src/TreeList/TreeListBranches.tsx +6 -0
  288. package/src/TreeList/TreeListItem.tsx +88 -13
  289. package/src/docPropLiterals.test.ts +36 -10
  290. package/src/hooks/useEntryAnimation.doc.mjs +4 -4
  291. package/src/hooks/useEntryAnimation.ssr.test.tsx +143 -0
  292. package/src/hooks/useEntryAnimation.ts +15 -16
  293. package/src/hooks/useIsHydrating.test.tsx +70 -0
  294. package/src/hooks/useIsHydrating.ts +31 -0
  295. package/src/hooks/useMenuHover.ts +18 -13
  296. package/src/i18n/generated-locales/en.generated.ts +100 -0
  297. package/src/i18n/generated-locales/pseudo.generated.ts +100 -0
  298. package/src/index.ts +1 -0
  299. package/src/postinstall.test.mjs +46 -0
  300. package/src/reset.css +0 -29
  301. package/src/theme/derivedVarRegistry.test.ts +7 -3
  302. package/src/theme/derivedVarRegistry.ts +0 -3
  303. package/src/utils/focusOutline.stylex.ts +4 -0
  304. package/src/utils/plainDate.test.ts +37 -1
  305. package/src/utils/plainDate.ts +15 -5
  306. package/src/utils/sharedMutationObserver.test.ts +53 -0
  307. package/src/utils/sharedMutationObserver.ts +78 -0
@@ -35,6 +35,7 @@ import {generateThemeCSS} from '../theme/generateThemeRules';
35
35
  import {selectorPresentationStyles} from '../Selector/selectorPresentation.stylex';
36
36
  import {groupStyles} from '../InputGroup/groupStyles';
37
37
  import {InputGroup, InputGroupText} from '../InputGroup';
38
+ import {focusVars} from '../theme/tokens.stylex';
38
39
 
39
40
  function generateThemeTestCSS(theme: Parameters<typeof generateThemeCSS>[0]) {
40
41
  const {prose, component} = generateThemeCSS(theme);
@@ -4083,6 +4084,164 @@ describe('MultiSelector option actions (grid)', () => {
4083
4084
  expect(onChange).not.toHaveBeenCalled();
4084
4085
  });
4085
4086
 
4087
+ it('draws the standard focus ring on the active action cell, from the focus tokens', async () => {
4088
+ // jsdom resolves no custom property, so the ring is read from StyleX
4089
+ // classes: a class name hashes one property and its value, and the same
4090
+ // declaration yields the same class wherever it is written.
4091
+ const ring = stylex.create({
4092
+ active: {
4093
+ outlineWidth: focusVars['--focus-outline-width'],
4094
+ outlineStyle: focusVars['--focus-outline-style'],
4095
+ outlineColor: focusVars['--focus-outline-color'],
4096
+ outlineOffset: focusVars['--focus-outline-offset'],
4097
+ },
4098
+ });
4099
+ const ringClasses = stylex
4100
+ .props(ring.active)
4101
+ .className!.split(' ')
4102
+ .filter(token => /^x[a-z0-9]+$/.test(token));
4103
+ expect(ringClasses).toHaveLength(4);
4104
+
4105
+ const user = userEvent.setup();
4106
+ render(
4107
+ <MultiSelector
4108
+ label="Labels"
4109
+ options={OPTIONS}
4110
+ value={[]}
4111
+ onChange={() => {}}
4112
+ />,
4113
+ );
4114
+ const trigger = screen.getByRole('combobox', {name: 'Labels'});
4115
+ await user.click(trigger);
4116
+ const bug = screen.getByRole('row', {name: 'Bug', ...h});
4117
+ const actionCell = bug.children[1] as HTMLElement;
4118
+ for (const token of ringClasses) {
4119
+ expect(actionCell).not.toHaveClass(token);
4120
+ }
4121
+ fireEvent.keyDown(trigger, {key: 'ArrowRight'});
4122
+ expect(trigger).toHaveAttribute('aria-activedescendant', actionCell.id);
4123
+ for (const token of ringClasses) {
4124
+ expect(actionCell).toHaveClass(token);
4125
+ }
4126
+ });
4127
+
4128
+ it('draws no focus ring on an action cell highlighted after pointer input, until a key moves the highlight', async () => {
4129
+ const ring = stylex.create({
4130
+ active: {
4131
+ outlineWidth: focusVars['--focus-outline-width'],
4132
+ outlineStyle: focusVars['--focus-outline-style'],
4133
+ outlineColor: focusVars['--focus-outline-color'],
4134
+ outlineOffset: focusVars['--focus-outline-offset'],
4135
+ },
4136
+ });
4137
+ const ringClasses = stylex
4138
+ .props(ring.active)
4139
+ .className!.split(' ')
4140
+ .filter(token => /^x[a-z0-9]+$/.test(token));
4141
+ expect(ringClasses).toHaveLength(4);
4142
+
4143
+ const user = userEvent.setup();
4144
+ render(
4145
+ <MultiSelector
4146
+ label="Labels"
4147
+ options={OPTIONS}
4148
+ value={[]}
4149
+ onChange={() => {}}
4150
+ />,
4151
+ );
4152
+ const trigger = screen.getByRole('combobox', {name: 'Labels'});
4153
+ await user.click(trigger);
4154
+ const bug = screen.getByRole('row', {name: 'Bug', ...h});
4155
+ const actionCell = bug.children[1] as HTMLElement;
4156
+ fireEvent.mouseEnter(actionCell);
4157
+ // The hover moved the highlight onto the action cell, without the ring.
4158
+ expect(trigger).toHaveAttribute('aria-activedescendant', actionCell.id);
4159
+ for (const token of ringClasses) {
4160
+ expect(actionCell).not.toHaveClass(token);
4161
+ }
4162
+ // Keyboard navigation back onto the cell draws it.
4163
+ fireEvent.keyDown(trigger, {key: 'ArrowLeft'});
4164
+ fireEvent.keyDown(trigger, {key: 'ArrowRight'});
4165
+ expect(trigger).toHaveAttribute('aria-activedescendant', actionCell.id);
4166
+ for (const token of ringClasses) {
4167
+ expect(actionCell).toHaveClass(token);
4168
+ }
4169
+ });
4170
+
4171
+ describe('ring under mixed input', () => {
4172
+ const ringClasses = () => {
4173
+ const ring = stylex.create({
4174
+ active: {
4175
+ outlineWidth: focusVars['--focus-outline-width'],
4176
+ outlineStyle: focusVars['--focus-outline-style'],
4177
+ outlineColor: focusVars['--focus-outline-color'],
4178
+ outlineOffset: focusVars['--focus-outline-offset'],
4179
+ },
4180
+ });
4181
+ return stylex
4182
+ .props(ring.active)
4183
+ .className!.split(' ')
4184
+ .filter(token => /^x[a-z0-9]+$/.test(token));
4185
+ };
4186
+ const hasRing = (cell: HTMLElement) =>
4187
+ ringClasses().every(token => cell.classList.contains(token));
4188
+
4189
+ async function openWithKeyboardOnBugAction() {
4190
+ const user = userEvent.setup();
4191
+ render(
4192
+ <MultiSelector
4193
+ label="Labels"
4194
+ options={OPTIONS}
4195
+ value={[]}
4196
+ onChange={() => {}}
4197
+ />,
4198
+ );
4199
+ const trigger = screen.getByRole('combobox', {name: 'Labels'});
4200
+ await user.click(trigger);
4201
+ const row = (name: string) => screen.getByRole('row', {name, ...h});
4202
+ fireEvent.keyDown(trigger, {key: 'ArrowRight'});
4203
+ const bugAction = row('Bug').children[1] as HTMLElement;
4204
+ expect(trigger).toHaveAttribute('aria-activedescendant', bugAction.id);
4205
+ expect(hasRing(bugAction)).toBe(true);
4206
+ return {trigger, row, bugAction};
4207
+ }
4208
+
4209
+ it('keeps the ring when the pointer crosses a disabled option the highlight ignores', async () => {
4210
+ const {trigger, row, bugAction} = await openWithKeyboardOnBugAction();
4211
+ fireEvent.mouseEnter(row('Docs').children[0]);
4212
+ expect(trigger).toHaveAttribute('aria-activedescendant', bugAction.id);
4213
+ expect(hasRing(bugAction)).toBe(true);
4214
+ });
4215
+
4216
+ it('follows the keyboard modality when a hover moves the highlight to another action', async () => {
4217
+ const {trigger, row} = await openWithKeyboardOnBugAction();
4218
+ const docsAction = row('Docs').children[1] as HTMLElement;
4219
+ fireEvent.mouseEnter(docsAction);
4220
+ expect(trigger).toHaveAttribute('aria-activedescendant', docsAction.id);
4221
+ expect(hasRing(docsAction)).toBe(true);
4222
+ });
4223
+
4224
+ it('draws no ring for a modifier chord after pointer input', async () => {
4225
+ const user = userEvent.setup();
4226
+ render(
4227
+ <MultiSelector
4228
+ label="Labels"
4229
+ options={OPTIONS}
4230
+ value={[]}
4231
+ onChange={() => {}}
4232
+ />,
4233
+ );
4234
+ const trigger = screen.getByRole('combobox', {name: 'Labels'});
4235
+ await user.click(trigger);
4236
+ const bugAction = screen.getByRole('row', {name: 'Bug', ...h})
4237
+ .children[1] as HTMLElement;
4238
+ fireEvent.mouseEnter(bugAction);
4239
+ expect(hasRing(bugAction)).toBe(false);
4240
+ fireEvent.keyDown(trigger, {key: 'ArrowRight', ctrlKey: true});
4241
+ expect(hasRing(bugAction)).toBe(false);
4242
+ });
4243
+ });
4244
+
4086
4245
  it('the inline-end arrow reaches the action cell, Enter fires it, inline-start returns', async () => {
4087
4246
  const user = userEvent.setup();
4088
4247
  const onChange = vi.fn();
@@ -50,6 +50,7 @@ import type {IndicatorPosition} from '../Indicator';
50
50
  import {Badge} from '../Badge';
51
51
  import {
52
52
  colorVars,
53
+ focusVars,
53
54
  sizeVars,
54
55
  spacingVars,
55
56
  radiusVars,
@@ -74,7 +75,10 @@ import {
74
75
  import {useMultiCombobox} from './hooks';
75
76
  import {getInputARIA, isImeKeyEvent, mergeProps} from '../utils';
76
77
  import {devWarn, warnOnce} from '../utils/devWarning';
77
- import {FOCUS_OUTLINE_PARTS} from '../utils/focusOutline.stylex';
78
+ import {
79
+ getInteractionModality,
80
+ useInteractionModalityTracking,
81
+ } from '../utils/interactionModality';
78
82
  import {useAnnounce} from '../hooks/useAnnounce';
79
83
  import {FOCUSABLE_SELECTOR} from '../hooks/focusableSelector';
80
84
  import {useAnnounceRenderedText} from '../hooks/useAnnounceRenderedText';
@@ -436,11 +440,15 @@ const styles = stylex.create({
436
440
  flexShrink: 0,
437
441
  borderRadius: radiusVars['--radius-element'],
438
442
  },
443
+ // The standard ring, from the focus tokens themselves: inside
444
+ // `stylex.create` StyleX resolves an imported `defineVars` group, and a
445
+ // plain object such as `FOCUS_OUTLINE_PARTS` compiles to variables nothing
446
+ // defines.
439
447
  actionCellActive: {
440
- outlineWidth: FOCUS_OUTLINE_PARTS.outlineWidth,
441
- outlineStyle: FOCUS_OUTLINE_PARTS.outlineStyle,
442
- outlineColor: FOCUS_OUTLINE_PARTS.outlineColor,
443
- outlineOffset: FOCUS_OUTLINE_PARTS.outlineOffset,
448
+ outlineWidth: focusVars['--focus-outline-width'],
449
+ outlineStyle: focusVars['--focus-outline-style'],
450
+ outlineColor: focusVars['--focus-outline-color'],
451
+ outlineOffset: focusVars['--focus-outline-offset'],
444
452
  },
445
453
 
446
454
  // Empty state
@@ -1752,8 +1760,8 @@ export function MultiSelector<T extends MultiSelectorOptionType>({
1752
1760
  getActionCellId,
1753
1761
  activeDescendantId,
1754
1762
  onTriggerClick,
1755
- onKeyDown,
1756
- onItemMouseEnter,
1763
+ onKeyDown: onComboboxKeyDown,
1764
+ onItemMouseEnter: onComboboxItemMouseEnter,
1757
1765
  } = useMultiCombobox({
1758
1766
  selectableItems: sortedItems,
1759
1767
  isDisabled: isDisabled || isEffectivelyReadOnly,
@@ -1784,6 +1792,29 @@ export function MultiSelector<T extends MultiSelectorOptionType>({
1784
1792
  ),
1785
1793
  });
1786
1794
 
1795
+ // A hover moves the highlight too, but the focus ring follows the shared
1796
+ // interaction modality (architecture:interaction-modality INV1): it is read
1797
+ // whenever a key or the pointer moves the highlight, so an action cell
1798
+ // highlighted after pointer input keeps the hover treatment and no ring.
1799
+ useInteractionModalityTracking();
1800
+ const [isKeyboardHighlight, setIsKeyboardHighlight] = useState(
1801
+ () => getInteractionModality() === 'keyboard',
1802
+ );
1803
+ const onKeyDown = useCallback(
1804
+ (event: React.KeyboardEvent<HTMLElement>) => {
1805
+ onComboboxKeyDown(event);
1806
+ setIsKeyboardHighlight(getInteractionModality() === 'keyboard');
1807
+ },
1808
+ [onComboboxKeyDown],
1809
+ );
1810
+ const onItemMouseEnter = useCallback(
1811
+ (...args: Parameters<typeof onComboboxItemMouseEnter>) => {
1812
+ onComboboxItemMouseEnter(...args);
1813
+ setIsKeyboardHighlight(getInteractionModality() === 'keyboard');
1814
+ },
1815
+ [onComboboxItemMouseEnter],
1816
+ );
1817
+
1787
1818
  // The trigger button owns its click so a consumer `onClick`, which lands on
1788
1819
  // the button, composes after the built-in toggle. A press elsewhere in the
1789
1820
  // control box (padding, start icon, chevron) still opens the panel.
@@ -2117,6 +2148,7 @@ export function MultiSelector<T extends MultiSelectorOptionType>({
2117
2148
  styles.actionCell,
2118
2149
  isHighlighted &&
2119
2150
  highlightedCell === 'action' &&
2151
+ isKeyboardHighlight &&
2120
2152
  styles.actionCellActive,
2121
2153
  )}>
2122
2154
  {isSelectAll || isCreate ? null : item.action}
@@ -2131,6 +2163,7 @@ export function MultiSelector<T extends MultiSelectorOptionType>({
2131
2163
  [
2132
2164
  isGrid,
2133
2165
  highlightedCell,
2166
+ isKeyboardHighlight,
2134
2167
  getActionCellId,
2135
2168
  renderOption,
2136
2169
  indicatorPosition,
@@ -6,8 +6,10 @@
6
6
  * built Storybook.
7
7
  * @output Real-engine proof for option actions: the action is visible at rest
8
8
  * beside its row (`spec:AST-058` FR8), the keyboard reaches it through the
9
- * inline-end arrow in both directions and fires it with Enter, and the
10
- * highlight follows a real mouse across rows and actions.
9
+ * inline-end arrow in both directions and fires it with Enter, the active
10
+ * action cell draws the standard focus ring when the shared input modality
11
+ * is keyboard and not after pointer input, and the highlight follows a real
12
+ * mouse across rows and actions.
11
13
  * @position Run with `pnpm test:a11y-contract`; paint, pointer paths and the
12
14
  * active descendant as an engine exposes them are not jsdom claims.
13
15
  */
@@ -143,6 +145,114 @@ test('the keyboard reaches an action through the inline-end arrow and fires it w
143
145
  await expect.poll(async () => activeDescendant(page)).toBe('row:Bug');
144
146
  });
145
147
 
148
+ test('the active action cell draws the standard focus ring', async ({page}) => {
149
+ await page.goto(
150
+ `${storybook.origin}/iframe.html?id=core-multiselector--row-actions&viewMode=story`,
151
+ );
152
+ const search = page.getByRole('combobox');
153
+ await expect(search).toBeFocused();
154
+ await search.press('ArrowDown'); // select-all
155
+ await search.press('ArrowDown'); // Feature (no action)
156
+ await search.press('ArrowDown'); // Bug
157
+ await search.press('ArrowRight');
158
+ await expect
159
+ .poll(async () => activeDescendant(page))
160
+ .toBe('gridcell:Edit Bug');
161
+ const ring = await page.evaluate(() => {
162
+ const id = document.activeElement?.getAttribute('aria-activedescendant');
163
+ const cell = id ? document.getElementById(id) : null;
164
+ if (!cell) {
165
+ return null;
166
+ }
167
+ const cs = getComputedStyle(cell);
168
+ // The ring the focus tokens describe, resolved by the browser on a probe.
169
+ const probe = document.createElement('div');
170
+ probe.style.cssText =
171
+ 'outline-width:var(--focus-outline-width);outline-style:var(--focus-outline-style);outline-color:var(--focus-outline-color);outline-offset:var(--focus-outline-offset)';
172
+ document.body.appendChild(probe);
173
+ const want = getComputedStyle(probe);
174
+ const result = {
175
+ style: cs.outlineStyle,
176
+ width: cs.outlineWidth,
177
+ color: cs.outlineColor,
178
+ offset: cs.outlineOffset,
179
+ wantStyle: want.outlineStyle,
180
+ wantWidth: want.outlineWidth,
181
+ wantColor: want.outlineColor,
182
+ wantOffset: want.outlineOffset,
183
+ };
184
+ probe.remove();
185
+ return result;
186
+ });
187
+ expect(ring).not.toBeNull();
188
+ expect(ring!.style).not.toBe('none');
189
+ expect(ring!.width).not.toBe('0px');
190
+ expect(ring!.style).toBe(ring!.wantStyle);
191
+ expect(ring!.width).toBe(ring!.wantWidth);
192
+ expect(ring!.color).toBe(ring!.wantColor);
193
+ expect(ring!.offset).toBe(ring!.wantOffset);
194
+ // Back on the option cell, the action cell drops the ring.
195
+ await search.press('ArrowLeft');
196
+ await expect.poll(async () => activeDescendant(page)).toBe('row:Bug');
197
+ const after = await page
198
+ .getByRole('row', {name: 'Bug'})
199
+ .locator('[data-multi-selector-action-cell]')
200
+ .evaluate(cell => getComputedStyle(cell).outlineStyle);
201
+ expect(after).toBe('none');
202
+ });
203
+
204
+ test('the action-cell ring follows the shared input modality', async ({
205
+ page,
206
+ }) => {
207
+ await page.goto(
208
+ `${storybook.origin}/iframe.html?id=core-multiselector--row-actions&viewMode=story`,
209
+ );
210
+ const search = page.getByRole('combobox');
211
+ await expect(search).toBeFocused();
212
+ const actionCell = (name: string) =>
213
+ page.getByRole('row', {name}).locator('[data-multi-selector-action-cell]');
214
+ const outlineStyle = async (name: string) =>
215
+ actionCell(name).evaluate(cell => getComputedStyle(cell).outlineStyle);
216
+ const hover = async (name: string) => {
217
+ const cell = await box(actionCell(name));
218
+ await page.mouse.move(cell.x + cell.width / 2, cell.y + cell.height / 2, {
219
+ steps: 6,
220
+ });
221
+ };
222
+
223
+ // Pointer input: a click into the search field, then a hover onto an
224
+ // action, moves the highlight without the ring, and leaves none behind.
225
+ await search.click();
226
+ await hover('Bug');
227
+ await expect
228
+ .poll(async () => activeDescendant(page))
229
+ .toBe('gridcell:Edit Bug');
230
+ expect(await outlineStyle('Bug')).toBe('none');
231
+ // A modifier chord is not keyboard navigation for the shared tracker.
232
+ await search.press('Control+ArrowRight');
233
+ expect(await outlineStyle('Bug')).toBe('none');
234
+ await page.mouse.move(1, 1, {steps: 6});
235
+ expect(await outlineStyle('Bug')).toBe('none');
236
+
237
+ // Keyboard input: back onto the same cell, the ring is drawn.
238
+ await search.press('ArrowLeft');
239
+ await expect.poll(async () => activeDescendant(page)).toBe('row:Bug');
240
+ await search.press('ArrowRight');
241
+ await expect
242
+ .poll(async () => activeDescendant(page))
243
+ .toBe('gridcell:Edit Bug');
244
+ expect(await outlineStyle('Bug')).not.toBe('none');
245
+
246
+ // Still keyboard-driven, a hover that moves the highlight to another
247
+ // row's action carries the ring with it.
248
+ await hover('P0');
249
+ await expect
250
+ .poll(async () => activeDescendant(page))
251
+ .toBe('gridcell:Edit P0');
252
+ expect(await outlineStyle('P0')).not.toBe('none');
253
+ expect(await outlineStyle('Bug')).toBe('none');
254
+ });
255
+
146
256
  test('under RTL the inline-end arrow is ArrowLeft', async ({page}) => {
147
257
  await page.goto(
148
258
  `${storybook.origin}/iframe.html?id=core-multiselector--row-actions-rtl&viewMode=story`,
@@ -280,10 +280,10 @@ describe('Popover', () => {
280
280
  'utf8',
281
281
  );
282
282
  expect(popoverSource).toMatch(
283
- /surfaceViewportFit:[\s\S]*?maxInlineSize: stylex\.firstThatWorks\(\s*layerViewportInset\.maxInlineSize/,
283
+ /surfaceViewportFit:[\s\S]*?maxInlineSize: stylex\.firstThatWorks\(\s*`calc\(\$\{layerViewportInset\.maxInlineSize\}\)`/,
284
284
  );
285
285
  expect(popoverSource).toMatch(
286
- /surfaceViewportFit:[\s\S]*?maxBlockSize: stylex\.firstThatWorks\(\s*layerViewportInset\.maxBlockSize/,
286
+ /surfaceViewportFit:[\s\S]*?maxBlockSize: stylex\.firstThatWorks\(\s*`calc\(\$\{layerViewportInset\.maxBlockSize\}\)`/,
287
287
  );
288
288
  expect(popoverSource).not.toMatch(/safe-area-inset|calc\(100%/);
289
289
  expect(surface?.className).not.toContain(
@@ -272,12 +272,12 @@ const styles = stylex.create({
272
272
  surfaceViewportFit: {
273
273
  boxSizing: 'border-box',
274
274
  maxInlineSize: stylex.firstThatWorks(
275
- layerViewportInset.maxInlineSize,
276
- layerViewportInset.maxInlineSizeFallback,
275
+ `calc(${layerViewportInset.maxInlineSize})`,
276
+ `calc(${layerViewportInset.maxInlineSizeFallback})`,
277
277
  ),
278
278
  maxBlockSize: stylex.firstThatWorks(
279
- layerViewportInset.maxBlockSize,
280
- layerViewportInset.maxBlockSizeFallback,
279
+ `calc(${layerViewportInset.maxBlockSize})`,
280
+ `calc(${layerViewportInset.maxBlockSizeFallback})`,
281
281
  ),
282
282
  },
283
283
  surfaceScrollable: {
@@ -1,7 +1,7 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
2
 
3
- import {describe, it} from 'vitest';
4
- import {screen} from '@testing-library/react';
3
+ import {describe, it, expect} from 'vitest';
4
+ import {render, screen} from '@testing-library/react';
5
5
  import {expectFieldInputProps} from '../Field/fieldInputFamily.testing';
6
6
  import {describeFieldInputParts} from '../Field/fieldInputFamily.render-testing';
7
7
  import {RadioList, type RadioListProps} from './RadioList';
@@ -22,3 +22,46 @@ describeFieldInputParts('RadioList', {
22
22
  getControl: () => screen.getByRole('radiogroup'),
23
23
  inGroup: false,
24
24
  });
25
+
26
+ describe('RadioList FR10 details', () => {
27
+ it("names the radiogroup by its label and then a caller's aria-labelledby", () => {
28
+ render(
29
+ <>
30
+ <span id="caller-name">Billing</span>
31
+ <RadioList
32
+ label="Plan"
33
+ value="a"
34
+ onChange={() => {}}
35
+ aria-labelledby="caller-name">
36
+ <RadioListItem label="A" value="a" />
37
+ </RadioList>
38
+ </>,
39
+ );
40
+ const group = screen.getByRole('radiogroup');
41
+ const ids = group.getAttribute('aria-labelledby')?.split(' ');
42
+ expect(ids).toHaveLength(2);
43
+ expect(document.getElementById(ids?.[0] ?? '')?.textContent).toContain(
44
+ 'Plan',
45
+ );
46
+ expect(ids?.[1]).toBe('caller-name');
47
+ expect(screen.getByRole('radiogroup', {name: 'Plan Billing'})).toBe(group);
48
+ });
49
+
50
+ it('puts hidden, inert, and dir on the radiogroup', () => {
51
+ render(
52
+ <RadioList
53
+ label="Plan"
54
+ value="a"
55
+ onChange={() => {}}
56
+ hidden
57
+ inert
58
+ dir="rtl">
59
+ <RadioListItem label="A" value="a" />
60
+ </RadioList>,
61
+ );
62
+ const group = document.querySelector<HTMLElement>('[role="radiogroup"]');
63
+ expect(group).toHaveAttribute('hidden');
64
+ expect(group).toHaveAttribute('inert');
65
+ expect(group).toHaveAttribute('dir', 'rtl');
66
+ });
67
+ });
@@ -524,6 +524,28 @@ describe('RadioList', () => {
524
524
  });
525
525
 
526
526
  describe('RadioListItem rest forwarding', () => {
527
+ it('forwards align to its Item row unchanged', () => {
528
+ render(
529
+ <RadioList label="Preference" value="" onChange={() => {}}>
530
+ <RadioListItem label="Option A" value="a" data-testid="item-a" />
531
+ <RadioListItem
532
+ label="Option B"
533
+ value="b"
534
+ align="first-line"
535
+ data-testid="item-b"
536
+ />
537
+ </RadioList>,
538
+ );
539
+ expect(screen.getByTestId('item-a')).toHaveAttribute(
540
+ 'data-align',
541
+ 'center',
542
+ );
543
+ expect(screen.getByTestId('item-b')).toHaveAttribute(
544
+ 'data-align',
545
+ 'first-line',
546
+ );
547
+ });
548
+
527
549
  it('forwards data-testid, id, and aria-* to the item root element', () => {
528
550
  render(
529
551
  <RadioList label="Preference" value="" onChange={() => {}}>
@@ -31,6 +31,7 @@ import type {InputStatus} from '../Field/types';
31
31
  import {useTooltip} from '../Tooltip';
32
32
  import {useResolvedRequired} from '../hooks/useResolvedRequired';
33
33
  import {composeEventHandlers, mergeProps} from '../utils';
34
+ import {joinAriaIDs} from '../utils/inputAria';
34
35
  import {
35
36
  type FieldInputBaseProps,
36
37
  useFieldInputStyling,
@@ -216,6 +217,7 @@ export function RadioList({
216
217
  htmlName,
217
218
  children,
218
219
  onFocus,
220
+ 'aria-labelledby': ariaLabelledByProp,
219
221
  'aria-describedby': ariaDescribedByProp,
220
222
  ...restProps
221
223
  }: RadioListProps) {
@@ -399,7 +401,8 @@ export function RadioList({
399
401
  disabledMessageTooltip.ref(el);
400
402
  }}
401
403
  role="radiogroup"
402
- aria-labelledby={labelID}
404
+ // A caller aria-labelledby names the group together with its label.
405
+ aria-labelledby={joinAriaIDs(labelID, ariaLabelledByProp)}
403
406
  onFocus={composeEventHandlers(handleFocus, onFocus)}
404
407
  aria-describedby={
405
408
  [
@@ -43,6 +43,13 @@ export const docs = {
43
43
  description:
44
44
  'Secondary content displayed below the label. Links and buttons keep their own click behaviour — the row only delegates clicks from its non-interactive surface to the radio.',
45
45
  },
46
+ {
47
+ name: 'align',
48
+ type: "'center' | 'start' | 'first-line'",
49
+ description:
50
+ 'Vertical alignment of the start and end content against the label, passed through to Item unchanged. `first-line` keeps a small mark (a radio) level with the first line of a wrapped label. See Item.align.',
51
+ default: "'center'",
52
+ },
46
53
  {
47
54
  name: 'isDisabled',
48
55
  type: 'boolean',
@@ -117,6 +124,13 @@ export const docsZh = {
117
124
  description:
118
125
  '显示在标签下方的次要内容。链接和按钮保留自身的点击行为——整行仅将非交互区域的点击委派给单选框。',
119
126
  },
127
+ {
128
+ name: 'align',
129
+ type: "'center' | 'start' | 'first-line'",
130
+ description:
131
+ '起始和结束内容相对于标签的垂直对齐方式,原样传递给 Item。`first-line` 让小标记(单选按钮)与换行标签的第一行保持水平。参见 Item.align。',
132
+ default: "'center'",
133
+ },
120
134
  {
121
135
  name: 'isDisabled',
122
136
  type: 'boolean',
@@ -142,6 +156,8 @@ export const docsDense = {
142
156
  displayName: 'Radio List Item',
143
157
  description: 'Individual radio item w/ label, description, content slots.',
144
158
  propDescriptions: {
159
+ align:
160
+ "Start/end content alignment, passed to Item: 'center' (default), 'start', or 'first-line' (centered on the label's first line).",
145
161
  label:
146
162
  'Primary label. String or ReactNode; nested controls keep their behavior.',
147
163
  'aria-label':
@@ -29,7 +29,7 @@ import {indicatorScope} from '../Indicator/indicator.markers.stylex';
29
29
  import {useIndicatorFocusRing} from '../hooks/useIndicatorFocusRing';
30
30
  import {usePressFeedback} from '../hooks/usePressFeedback';
31
31
  import {useIndicator} from '../Indicator';
32
- import {Item} from '../Item';
32
+ import {Item, type ItemAlign} from '../Item';
33
33
  import {themeProps} from '../utils/themeProps';
34
34
 
35
35
  // The touch press's paint, declared by the shared overlay styles on the
@@ -156,6 +156,13 @@ const rowStyles = stylex.create({
156
156
 
157
157
  export interface RadioListItemProps extends BaseProps<HTMLDivElement> {
158
158
  ref?: React.Ref<HTMLDivElement>;
159
+ /**
160
+ * Vertical alignment of the start and end content against the label,
161
+ * forwarded to Item. Use `first-line` to keep the radio level with the
162
+ * first line of a wrapped label.
163
+ * @default 'center'
164
+ */
165
+ align?: ItemAlign;
159
166
  /**
160
167
  * Primary label for the radio item.
161
168
  *
@@ -232,6 +239,7 @@ export function RadioListItem({
232
239
  isDisabled: isItemDisabled = false,
233
240
  startContent,
234
241
  endContent,
242
+ align,
235
243
  xstyle,
236
244
  className,
237
245
  style,
@@ -366,6 +374,7 @@ export function RadioListItem({
366
374
  ) : undefined
367
375
  }
368
376
  endContent={endContent}
377
+ align={align}
369
378
  xstyle={
370
379
  [
371
380
  // Hover reaches the radio visual through this ancestor marker rather