@moheng-design/ui 1.0.0 → 2.0.0

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 (481) hide show
  1. package/README.md +13 -10
  2. package/contracts/application-atomic/list-table-pagination.ts +3 -2
  3. package/contracts/application-atomic/system-button.ts +29 -11
  4. package/contracts/application-module/collaboration/contacts-collaboration-workspace.ts +39 -1
  5. package/contracts/application-module/collaboration/files-collaboration-workspace.ts +27 -1
  6. package/contracts/application-module/collaboration/schedule-collaboration-workspace.ts +42 -0
  7. package/contracts/application-module/content/application-data-display.ts +23 -1
  8. package/contracts/application-module/content/application-filter-list.ts +2 -2
  9. package/contracts/application-module/content/application-page-header.ts +1 -1
  10. package/contracts/application-module/content/application-page-layout-container.ts +14 -0
  11. package/contracts/application-module/content/application-query-toolbar.ts +49 -10
  12. package/contracts/application-module/content/application-split-list-sidebar.ts +16 -4
  13. package/contracts/application-module/lists/application-record-list.ts +10 -5
  14. package/contracts/application-module/navigation/application-module-switcher.ts +7 -2
  15. package/contracts/application-module/navigation/application-primary-navigation.ts +17 -4
  16. package/contracts/application-module/navigation/global-sidebar.ts +1 -1
  17. package/contracts/application-module/navigation/top-navigation-primary-bar.ts +28 -5
  18. package/contracts/application-module/overlays/application-detail-drawer.ts +6 -0
  19. package/contracts/application-module/overlays/application-form-dialog.ts +1 -1
  20. package/contracts/application-module/overlays/application-global-action-panel.ts +24 -3
  21. package/contracts/application-module/statistics/metrics.ts +28 -2
  22. package/contracts/foundation/actions/button.ts +5 -2
  23. package/contracts/foundation/actions/toggle.ts +3 -3
  24. package/contracts/foundation/data-content-layout/avatar.ts +5 -2
  25. package/contracts/foundation/data-content-layout/badge.ts +4 -3
  26. package/contracts/foundation/data-content-layout/card.ts +5 -1
  27. package/contracts/foundation/data-content-layout/chart.ts +19 -7
  28. package/contracts/foundation/data-content-layout/message-scroller.ts +5 -5
  29. package/contracts/foundation/data-content-layout/progress.ts +5 -1
  30. package/contracts/foundation/data-content-layout/resizable.ts +19 -10
  31. package/contracts/foundation/data-content-layout/scroll-area.ts +2 -1
  32. package/contracts/foundation/data-content-layout/separator.ts +1 -1
  33. package/contracts/foundation/data-content-layout/table.ts +1 -1
  34. package/contracts/foundation/feedback-overlay/collapsible.ts +5 -4
  35. package/contracts/foundation/feedback-overlay/dialog.ts +8 -1
  36. package/contracts/foundation/feedback-overlay/drawer.ts +2 -2
  37. package/contracts/foundation/feedback-overlay/dropdown-menu.ts +5 -1
  38. package/contracts/foundation/feedback-overlay/hover-card.ts +1 -0
  39. package/contracts/foundation/feedback-overlay/popover.ts +19 -4
  40. package/contracts/foundation/feedback-overlay/sonner-provider.ts +35 -0
  41. package/contracts/foundation/feedback-overlay/sonner.ts +4 -1
  42. package/contracts/foundation/icon/icon-name.ts +49 -0
  43. package/contracts/foundation/icon/icon.ts +20 -4
  44. package/contracts/foundation/input-selection/calendar.ts +14 -1
  45. package/contracts/foundation/input-selection/checkbox.ts +6 -0
  46. package/contracts/foundation/input-selection/combobox.ts +8 -2
  47. package/contracts/foundation/input-selection/field.ts +15 -1
  48. package/contracts/foundation/input-selection/input-group.ts +10 -0
  49. package/contracts/foundation/input-selection/input-otp.ts +6 -0
  50. package/contracts/foundation/input-selection/radio-group.ts +7 -0
  51. package/contracts/foundation/input-selection/select.ts +4 -1
  52. package/contracts/foundation/input-selection/switch.ts +9 -0
  53. package/contracts/foundation/navigation-command/command.ts +22 -3
  54. package/contracts/foundation/navigation-command/context-menu.ts +6 -1
  55. package/contracts/foundation/navigation-command/menubar.ts +6 -1
  56. package/contracts/foundation/navigation-command/navigation-menu.ts +12 -3
  57. package/contracts/foundation/navigation-command/sidebar.ts +2 -1
  58. package/contracts/foundation/navigation-command/tabs.ts +12 -1
  59. package/dist/components/application-atomic/ListTablePagination.js +8 -1
  60. package/dist/components/application-atomic/ListTablePagination.js.map +1 -1
  61. package/dist/components/application-atomic/SidebarRailButton.js +12 -2
  62. package/dist/components/application-atomic/SidebarRailButton.js.map +1 -1
  63. package/dist/components/application-atomic/SystemButton.js +17 -5
  64. package/dist/components/application-atomic/SystemButton.js.map +1 -1
  65. package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js +27 -15
  66. package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js.map +1 -1
  67. package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js +10 -4
  68. package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js.map +1 -1
  69. package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js +143 -69
  70. package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js.map +1 -1
  71. package/dist/components/application-module/content/ApplicationDataDisplay.js +4 -1
  72. package/dist/components/application-module/content/ApplicationDataDisplay.js.map +1 -1
  73. package/dist/components/application-module/content/ApplicationPageHeader.js +14 -3
  74. package/dist/components/application-module/content/ApplicationPageHeader.js.map +1 -1
  75. package/dist/components/application-module/content/ApplicationPageLayoutContainer.js +2 -0
  76. package/dist/components/application-module/content/ApplicationPageLayoutContainer.js.map +1 -1
  77. package/dist/components/application-module/content/ApplicationQueryToolbar.js +19 -5
  78. package/dist/components/application-module/content/ApplicationQueryToolbar.js.map +1 -1
  79. package/dist/components/application-module/content/ApplicationSplitListSidebar.js +52 -21
  80. package/dist/components/application-module/content/ApplicationSplitListSidebar.js.map +1 -1
  81. package/dist/components/application-module/lists/ApplicationRecordList.js +53 -5
  82. package/dist/components/application-module/lists/ApplicationRecordList.js.map +1 -1
  83. package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js +91 -23
  84. package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js.map +1 -1
  85. package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js +29 -17
  86. package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js.map +1 -1
  87. package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js +8 -1
  88. package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js.map +1 -1
  89. package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js +10 -3
  90. package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js.map +1 -1
  91. package/dist/components/application-module/overlays/ApplicationDetailDrawer.js +7 -4
  92. package/dist/components/application-module/overlays/ApplicationDetailDrawer.js.map +1 -1
  93. package/dist/components/application-module/overlays/ApplicationFormDialog.js +31 -20
  94. package/dist/components/application-module/overlays/ApplicationFormDialog.js.map +1 -1
  95. package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js +60 -1
  96. package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js.map +1 -1
  97. package/dist/components/application-module/overlays/PeoplePickerDialog.js +70 -25
  98. package/dist/components/application-module/overlays/PeoplePickerDialog.js.map +1 -1
  99. package/dist/components/application-module/statistics/ApplicationMetricChart.js +5 -2
  100. package/dist/components/application-module/statistics/ApplicationMetricChart.js.map +1 -1
  101. package/dist/components/application-module/statistics/ApplicationMetricStrip.js +17 -3
  102. package/dist/components/application-module/statistics/ApplicationMetricStrip.js.map +1 -1
  103. package/dist/components/foundation/actions/ToggleGroup.js +14 -1
  104. package/dist/components/foundation/actions/ToggleGroup.js.map +1 -1
  105. package/dist/components/foundation/data-content-layout/Avatar.js +1 -12
  106. package/dist/components/foundation/data-content-layout/Avatar.js.map +1 -1
  107. package/dist/components/foundation/data-content-layout/Card.js +25 -1
  108. package/dist/components/foundation/data-content-layout/Card.js.map +1 -1
  109. package/dist/components/foundation/data-content-layout/Carousel.js +39 -2
  110. package/dist/components/foundation/data-content-layout/Carousel.js.map +1 -1
  111. package/dist/components/foundation/data-content-layout/Chart.js +13 -8
  112. package/dist/components/foundation/data-content-layout/Chart.js.map +1 -1
  113. package/dist/components/foundation/data-content-layout/Item.js +16 -1
  114. package/dist/components/foundation/data-content-layout/Item.js.map +1 -1
  115. package/dist/components/foundation/data-content-layout/Message.js +17 -0
  116. package/dist/components/foundation/data-content-layout/Message.js.map +1 -1
  117. package/dist/components/foundation/data-content-layout/MessageScroller.js +1 -0
  118. package/dist/components/foundation/data-content-layout/MessageScroller.js.map +1 -1
  119. package/dist/components/foundation/data-content-layout/Progress.js +8 -1
  120. package/dist/components/foundation/data-content-layout/Progress.js.map +1 -1
  121. package/dist/components/foundation/data-content-layout/Resizable.js +62 -15
  122. package/dist/components/foundation/data-content-layout/Resizable.js.map +1 -1
  123. package/dist/components/foundation/data-content-layout/ScrollArea.js +25 -0
  124. package/dist/components/foundation/data-content-layout/ScrollArea.js.map +1 -1
  125. package/dist/components/foundation/data-content-layout/Table.js +19 -3
  126. package/dist/components/foundation/data-content-layout/Table.js.map +1 -1
  127. package/dist/components/foundation/feedback-overlay/AlertDialog.js +12 -5
  128. package/dist/components/foundation/feedback-overlay/AlertDialog.js.map +1 -1
  129. package/dist/components/foundation/feedback-overlay/Dialog.js +19 -4
  130. package/dist/components/foundation/feedback-overlay/Dialog.js.map +1 -1
  131. package/dist/components/foundation/feedback-overlay/Drawer.js +4 -3
  132. package/dist/components/foundation/feedback-overlay/Drawer.js.map +1 -1
  133. package/dist/components/foundation/feedback-overlay/DropdownMenu.js +40 -6
  134. package/dist/components/foundation/feedback-overlay/DropdownMenu.js.map +1 -1
  135. package/dist/components/foundation/feedback-overlay/HoverCard.js +8 -0
  136. package/dist/components/foundation/feedback-overlay/HoverCard.js.map +1 -1
  137. package/dist/components/foundation/feedback-overlay/Popover.js +80 -28
  138. package/dist/components/foundation/feedback-overlay/Popover.js.map +1 -1
  139. package/dist/components/foundation/feedback-overlay/Sheet.js +4 -3
  140. package/dist/components/foundation/feedback-overlay/Sheet.js.map +1 -1
  141. package/dist/components/foundation/feedback-overlay/Sonner.js +1 -1
  142. package/dist/components/foundation/feedback-overlay/Sonner.js.map +1 -1
  143. package/dist/components/foundation/feedback-overlay/SonnerProvider.js +37 -0
  144. package/dist/components/foundation/feedback-overlay/SonnerProvider.js.map +1 -0
  145. package/dist/components/foundation/feedback-overlay/Tooltip.js +2 -0
  146. package/dist/components/foundation/feedback-overlay/Tooltip.js.map +1 -1
  147. package/dist/components/foundation/input-selection/Calendar.js +120 -23
  148. package/dist/components/foundation/input-selection/Calendar.js.map +1 -1
  149. package/dist/components/foundation/input-selection/Checkbox.js +3 -0
  150. package/dist/components/foundation/input-selection/Checkbox.js.map +1 -1
  151. package/dist/components/foundation/input-selection/Combobox.js +58 -6
  152. package/dist/components/foundation/input-selection/Combobox.js.map +1 -1
  153. package/dist/components/foundation/input-selection/Field.js +7 -2
  154. package/dist/components/foundation/input-selection/Field.js.map +1 -1
  155. package/dist/components/foundation/input-selection/Input.js +5 -1
  156. package/dist/components/foundation/input-selection/Input.js.map +1 -1
  157. package/dist/components/foundation/input-selection/InputGroup.js +2 -0
  158. package/dist/components/foundation/input-selection/InputGroup.js.map +1 -1
  159. package/dist/components/foundation/input-selection/InputOTP.js +3 -1
  160. package/dist/components/foundation/input-selection/InputOTP.js.map +1 -1
  161. package/dist/components/foundation/input-selection/NativeSelect.js.map +1 -1
  162. package/dist/components/foundation/input-selection/RadioGroup.js +3 -0
  163. package/dist/components/foundation/input-selection/RadioGroup.js.map +1 -1
  164. package/dist/components/foundation/input-selection/Select.js +30 -4
  165. package/dist/components/foundation/input-selection/Select.js.map +1 -1
  166. package/dist/components/foundation/input-selection/Switch.js +9 -3
  167. package/dist/components/foundation/input-selection/Switch.js.map +1 -1
  168. package/dist/components/foundation/input-selection/Textarea.js.map +1 -1
  169. package/dist/components/foundation/navigation-command/Accordion.js +21 -3
  170. package/dist/components/foundation/navigation-command/Accordion.js.map +1 -1
  171. package/dist/components/foundation/navigation-command/Breadcrumb.js +3 -4
  172. package/dist/components/foundation/navigation-command/Breadcrumb.js.map +1 -1
  173. package/dist/components/foundation/navigation-command/Command.js +85 -33
  174. package/dist/components/foundation/navigation-command/Command.js.map +1 -1
  175. package/dist/components/foundation/navigation-command/ContextMenu.js +73 -14
  176. package/dist/components/foundation/navigation-command/ContextMenu.js.map +1 -1
  177. package/dist/components/foundation/navigation-command/Menubar.js +114 -25
  178. package/dist/components/foundation/navigation-command/Menubar.js.map +1 -1
  179. package/dist/components/foundation/navigation-command/NavigationMenu.js +68 -9
  180. package/dist/components/foundation/navigation-command/NavigationMenu.js.map +1 -1
  181. package/dist/components/foundation/navigation-command/Pagination.js +1 -0
  182. package/dist/components/foundation/navigation-command/Pagination.js.map +1 -1
  183. package/dist/components/foundation/navigation-command/Sidebar.js +43 -24
  184. package/dist/components/foundation/navigation-command/Sidebar.js.map +1 -1
  185. package/dist/components/foundation/navigation-command/Tabs.js +57 -35
  186. package/dist/components/foundation/navigation-command/Tabs.js.map +1 -1
  187. package/dist/icon/Icon.js +2 -1
  188. package/dist/icon/Icon.js.map +1 -1
  189. package/dist/icon/glyphs.js +9 -1
  190. package/dist/icon/glyphs.js.map +1 -1
  191. package/dist/index.js +4 -1
  192. package/dist/index.js.map +1 -1
  193. package/dist/internal/FieldAssociation.js +39 -0
  194. package/dist/internal/FieldAssociation.js.map +1 -0
  195. package/dist/internal/Overlay.js +42 -8
  196. package/dist/internal/Overlay.js.map +1 -1
  197. package/dist/internal/escape-stack.js +17 -0
  198. package/dist/internal/escape-stack.js.map +1 -0
  199. package/dist/internal/focus.js +5 -1
  200. package/dist/internal/focus.js.map +1 -1
  201. package/dist/internal/initials.js +18 -0
  202. package/dist/internal/initials.js.map +1 -0
  203. package/dist/internal/row-activation.js +43 -0
  204. package/dist/internal/row-activation.js.map +1 -0
  205. package/dist/internal/state-slot.js +22 -0
  206. package/dist/internal/state-slot.js.map +1 -0
  207. package/dist/internal/use-dismiss.js +50 -6
  208. package/dist/internal/use-dismiss.js.map +1 -1
  209. package/dist/internal/use-list-navigation.js +10 -4
  210. package/dist/internal/use-list-navigation.js.map +1 -1
  211. package/dist/internal/use-modal.js +18 -3
  212. package/dist/internal/use-modal.js.map +1 -1
  213. package/dist/internal/use-roving-focus.js +94 -0
  214. package/dist/internal/use-roving-focus.js.map +1 -0
  215. package/dist/styles.css +4888 -4343
  216. package/dist/tokens.css +39 -9
  217. package/dist-types/contracts/application-atomic/list-table-pagination.d.ts +3 -2
  218. package/dist-types/contracts/application-atomic/list-table-pagination.d.ts.map +1 -1
  219. package/dist-types/contracts/application-atomic/system-button.d.ts +24 -9
  220. package/dist-types/contracts/application-atomic/system-button.d.ts.map +1 -1
  221. package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts +31 -1
  222. package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts.map +1 -1
  223. package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts +22 -1
  224. package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts.map +1 -1
  225. package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts +34 -0
  226. package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts.map +1 -1
  227. package/dist-types/contracts/application-module/content/application-data-display.d.ts +21 -1
  228. package/dist-types/contracts/application-module/content/application-data-display.d.ts.map +1 -1
  229. package/dist-types/contracts/application-module/content/application-filter-list.d.ts +2 -2
  230. package/dist-types/contracts/application-module/content/application-page-header.d.ts +1 -1
  231. package/dist-types/contracts/application-module/content/application-page-header.d.ts.map +1 -1
  232. package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts +13 -0
  233. package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts.map +1 -1
  234. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts +47 -11
  235. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts.map +1 -1
  236. package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts +9 -3
  237. package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts.map +1 -1
  238. package/dist-types/contracts/application-module/lists/application-record-list.d.ts +10 -5
  239. package/dist-types/contracts/application-module/lists/application-record-list.d.ts.map +1 -1
  240. package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts +7 -2
  241. package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts.map +1 -1
  242. package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts +17 -4
  243. package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts.map +1 -1
  244. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts +1 -1
  245. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts.map +1 -1
  246. package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts +26 -5
  247. package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts.map +1 -1
  248. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts +5 -0
  249. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts.map +1 -1
  250. package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts +1 -1
  251. package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts +20 -3
  252. package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts.map +1 -1
  253. package/dist-types/contracts/application-module/statistics/metrics.d.ts +25 -2
  254. package/dist-types/contracts/application-module/statistics/metrics.d.ts.map +1 -1
  255. package/dist-types/contracts/foundation/actions/button.d.ts +5 -2
  256. package/dist-types/contracts/foundation/actions/button.d.ts.map +1 -1
  257. package/dist-types/contracts/foundation/actions/toggle.d.ts +3 -3
  258. package/dist-types/contracts/foundation/actions/toggle.d.ts.map +1 -1
  259. package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts +4 -2
  260. package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts.map +1 -1
  261. package/dist-types/contracts/foundation/data-content-layout/badge.d.ts +4 -3
  262. package/dist-types/contracts/foundation/data-content-layout/badge.d.ts.map +1 -1
  263. package/dist-types/contracts/foundation/data-content-layout/card.d.ts +5 -1
  264. package/dist-types/contracts/foundation/data-content-layout/card.d.ts.map +1 -1
  265. package/dist-types/contracts/foundation/data-content-layout/chart.d.ts +17 -7
  266. package/dist-types/contracts/foundation/data-content-layout/chart.d.ts.map +1 -1
  267. package/dist-types/contracts/foundation/data-content-layout/message-scroller.d.ts +4 -4
  268. package/dist-types/contracts/foundation/data-content-layout/progress.d.ts +5 -1
  269. package/dist-types/contracts/foundation/data-content-layout/progress.d.ts.map +1 -1
  270. package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts +19 -10
  271. package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts.map +1 -1
  272. package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts +2 -1
  273. package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts.map +1 -1
  274. package/dist-types/contracts/foundation/data-content-layout/separator.d.ts +1 -1
  275. package/dist-types/contracts/foundation/data-content-layout/separator.d.ts.map +1 -1
  276. package/dist-types/contracts/foundation/data-content-layout/table.d.ts +1 -1
  277. package/dist-types/contracts/foundation/data-content-layout/table.d.ts.map +1 -1
  278. package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts +5 -4
  279. package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts.map +1 -1
  280. package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts +7 -1
  281. package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts.map +1 -1
  282. package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts +1 -1
  283. package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts.map +1 -1
  284. package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts +4 -0
  285. package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts.map +1 -1
  286. package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts +15 -2
  287. package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts.map +1 -1
  288. package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts +31 -0
  289. package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts.map +1 -0
  290. package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts +4 -1
  291. package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts.map +1 -1
  292. package/dist-types/contracts/foundation/icon/icon-name.d.ts +8 -0
  293. package/dist-types/contracts/foundation/icon/icon-name.d.ts.map +1 -0
  294. package/dist-types/contracts/foundation/icon/icon.d.ts +15 -2
  295. package/dist-types/contracts/foundation/icon/icon.d.ts.map +1 -1
  296. package/dist-types/contracts/foundation/input-selection/calendar.d.ts +13 -1
  297. package/dist-types/contracts/foundation/input-selection/calendar.d.ts.map +1 -1
  298. package/dist-types/contracts/foundation/input-selection/checkbox.d.ts +5 -0
  299. package/dist-types/contracts/foundation/input-selection/checkbox.d.ts.map +1 -1
  300. package/dist-types/contracts/foundation/input-selection/combobox.d.ts +6 -1
  301. package/dist-types/contracts/foundation/input-selection/combobox.d.ts.map +1 -1
  302. package/dist-types/contracts/foundation/input-selection/field.d.ts +14 -1
  303. package/dist-types/contracts/foundation/input-selection/field.d.ts.map +1 -1
  304. package/dist-types/contracts/foundation/input-selection/input-group.d.ts +9 -0
  305. package/dist-types/contracts/foundation/input-selection/input-group.d.ts.map +1 -1
  306. package/dist-types/contracts/foundation/input-selection/input-otp.d.ts +5 -0
  307. package/dist-types/contracts/foundation/input-selection/input-otp.d.ts.map +1 -1
  308. package/dist-types/contracts/foundation/input-selection/radio-group.d.ts +6 -0
  309. package/dist-types/contracts/foundation/input-selection/radio-group.d.ts.map +1 -1
  310. package/dist-types/contracts/foundation/input-selection/select.d.ts +4 -1
  311. package/dist-types/contracts/foundation/input-selection/select.d.ts.map +1 -1
  312. package/dist-types/contracts/foundation/input-selection/switch.d.ts +8 -0
  313. package/dist-types/contracts/foundation/input-selection/switch.d.ts.map +1 -1
  314. package/dist-types/contracts/foundation/navigation-command/command.d.ts +19 -3
  315. package/dist-types/contracts/foundation/navigation-command/command.d.ts.map +1 -1
  316. package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts +5 -0
  317. package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts.map +1 -1
  318. package/dist-types/contracts/foundation/navigation-command/menubar.d.ts +5 -0
  319. package/dist-types/contracts/foundation/navigation-command/menubar.d.ts.map +1 -1
  320. package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts +9 -0
  321. package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts.map +1 -1
  322. package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts +2 -1
  323. package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts.map +1 -1
  324. package/dist-types/contracts/foundation/navigation-command/tabs.d.ts +12 -1
  325. package/dist-types/contracts/foundation/navigation-command/tabs.d.ts.map +1 -1
  326. package/dist-types/src/components/application-atomic/ListTablePagination.d.ts +4 -0
  327. package/dist-types/src/components/application-atomic/ListTablePagination.d.ts.map +1 -1
  328. package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts +5 -0
  329. package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts.map +1 -1
  330. package/dist-types/src/components/application-atomic/SystemButton.d.ts +16 -1
  331. package/dist-types/src/components/application-atomic/SystemButton.d.ts.map +1 -1
  332. package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts +11 -1
  333. package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts.map +1 -1
  334. package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts +5 -1
  335. package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts.map +1 -1
  336. package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts +10 -1
  337. package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts.map +1 -1
  338. package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts +4 -1
  339. package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts.map +1 -1
  340. package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts +2 -0
  341. package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts.map +1 -1
  342. package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts +6 -1
  343. package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts.map +1 -1
  344. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts +1 -1
  345. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts.map +1 -1
  346. package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts +14 -1
  347. package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts.map +1 -1
  348. package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts +22 -2
  349. package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts.map +1 -1
  350. package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts +16 -3
  351. package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts.map +1 -1
  352. package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts +11 -0
  353. package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts.map +1 -1
  354. package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts.map +1 -1
  355. package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts +9 -1
  356. package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts.map +1 -1
  357. package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts +4 -1
  358. package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts.map +1 -1
  359. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts +7 -0
  360. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts.map +1 -1
  361. package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts +24 -1
  362. package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts.map +1 -1
  363. package/dist-types/src/components/application-module/overlays/PeoplePickerDialog.d.ts.map +1 -1
  364. package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts +3 -0
  365. package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts.map +1 -1
  366. package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts +9 -3
  367. package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts.map +1 -1
  368. package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts +4 -0
  369. package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts.map +1 -1
  370. package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts +7 -0
  371. package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts.map +1 -1
  372. package/dist-types/src/components/foundation/data-content-layout/Card.d.ts +9 -0
  373. package/dist-types/src/components/foundation/data-content-layout/Card.d.ts.map +1 -1
  374. package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts +11 -2
  375. package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts.map +1 -1
  376. package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts +15 -2
  377. package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts.map +1 -1
  378. package/dist-types/src/components/foundation/data-content-layout/Item.d.ts +5 -0
  379. package/dist-types/src/components/foundation/data-content-layout/Item.d.ts.map +1 -1
  380. package/dist-types/src/components/foundation/data-content-layout/Message.d.ts +6 -1
  381. package/dist-types/src/components/foundation/data-content-layout/Message.d.ts.map +1 -1
  382. package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts +7 -1
  383. package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts.map +1 -1
  384. package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts +7 -1
  385. package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts.map +1 -1
  386. package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts +10 -0
  387. package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts.map +1 -1
  388. package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts +9 -2
  389. package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts.map +1 -1
  390. package/dist-types/src/components/foundation/data-content-layout/Table.d.ts +13 -0
  391. package/dist-types/src/components/foundation/data-content-layout/Table.d.ts.map +1 -1
  392. package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts +5 -0
  393. package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts.map +1 -1
  394. package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts +7 -1
  395. package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts.map +1 -1
  396. package/dist-types/src/components/foundation/feedback-overlay/Drawer.d.ts.map +1 -1
  397. package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts +6 -1
  398. package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts.map +1 -1
  399. package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts +5 -0
  400. package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts.map +1 -1
  401. package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts +23 -1
  402. package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts.map +1 -1
  403. package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts.map +1 -1
  404. package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts +3 -0
  405. package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts.map +1 -1
  406. package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts +21 -0
  407. package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts.map +1 -0
  408. package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts +4 -0
  409. package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts.map +1 -1
  410. package/dist-types/src/components/foundation/input-selection/Calendar.d.ts +17 -1
  411. package/dist-types/src/components/foundation/input-selection/Calendar.d.ts.map +1 -1
  412. package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts +5 -1
  413. package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts.map +1 -1
  414. package/dist-types/src/components/foundation/input-selection/Combobox.d.ts +18 -2
  415. package/dist-types/src/components/foundation/input-selection/Combobox.d.ts.map +1 -1
  416. package/dist-types/src/components/foundation/input-selection/Field.d.ts +7 -1
  417. package/dist-types/src/components/foundation/input-selection/Field.d.ts.map +1 -1
  418. package/dist-types/src/components/foundation/input-selection/Input.d.ts +9 -1
  419. package/dist-types/src/components/foundation/input-selection/Input.d.ts.map +1 -1
  420. package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts +6 -1
  421. package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts.map +1 -1
  422. package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts +4 -1
  423. package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts.map +1 -1
  424. package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts +6 -1
  425. package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts.map +1 -1
  426. package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts +4 -1
  427. package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts.map +1 -1
  428. package/dist-types/src/components/foundation/input-selection/Select.d.ts +8 -1
  429. package/dist-types/src/components/foundation/input-selection/Select.d.ts.map +1 -1
  430. package/dist-types/src/components/foundation/input-selection/Switch.d.ts +7 -1
  431. package/dist-types/src/components/foundation/input-selection/Switch.d.ts.map +1 -1
  432. package/dist-types/src/components/foundation/input-selection/Textarea.d.ts +6 -1
  433. package/dist-types/src/components/foundation/input-selection/Textarea.d.ts.map +1 -1
  434. package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts +5 -0
  435. package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts.map +1 -1
  436. package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts +3 -0
  437. package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts.map +1 -1
  438. package/dist-types/src/components/foundation/navigation-command/Command.d.ts +15 -2
  439. package/dist-types/src/components/foundation/navigation-command/Command.d.ts.map +1 -1
  440. package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts +15 -5
  441. package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts.map +1 -1
  442. package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts +12 -1
  443. package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts.map +1 -1
  444. package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts +19 -2
  445. package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts.map +1 -1
  446. package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts +3 -0
  447. package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts.map +1 -1
  448. package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts +5 -0
  449. package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts.map +1 -1
  450. package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts +14 -3
  451. package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts.map +1 -1
  452. package/dist-types/src/icon/Icon.d.ts +2 -2
  453. package/dist-types/src/icon/Icon.d.ts.map +1 -1
  454. package/dist-types/src/icon/glyphs.d.ts +7 -3
  455. package/dist-types/src/icon/glyphs.d.ts.map +1 -1
  456. package/dist-types/src/index.d.ts +4 -2
  457. package/dist-types/src/index.d.ts.map +1 -1
  458. package/dist-types/src/internal/FieldAssociation.d.ts +33 -0
  459. package/dist-types/src/internal/FieldAssociation.d.ts.map +1 -0
  460. package/dist-types/src/internal/Overlay.d.ts +20 -2
  461. package/dist-types/src/internal/Overlay.d.ts.map +1 -1
  462. package/dist-types/src/internal/escape-stack.d.ts +4 -0
  463. package/dist-types/src/internal/escape-stack.d.ts.map +1 -0
  464. package/dist-types/src/internal/focus.d.ts +10 -1
  465. package/dist-types/src/internal/focus.d.ts.map +1 -1
  466. package/dist-types/src/internal/initials.d.ts +17 -0
  467. package/dist-types/src/internal/initials.d.ts.map +1 -0
  468. package/dist-types/src/internal/row-activation.d.ts +13 -0
  469. package/dist-types/src/internal/row-activation.d.ts.map +1 -0
  470. package/dist-types/src/internal/state-slot.d.ts +19 -0
  471. package/dist-types/src/internal/state-slot.d.ts.map +1 -0
  472. package/dist-types/src/internal/use-dismiss.d.ts +36 -3
  473. package/dist-types/src/internal/use-dismiss.d.ts.map +1 -1
  474. package/dist-types/src/internal/use-list-navigation.d.ts +7 -1
  475. package/dist-types/src/internal/use-list-navigation.d.ts.map +1 -1
  476. package/dist-types/src/internal/use-modal.d.ts.map +1 -1
  477. package/dist-types/src/internal/use-roving-focus.d.ts +49 -0
  478. package/dist-types/src/internal/use-roving-focus.d.ts.map +1 -0
  479. package/mappings.json +4 -4
  480. package/package.json +19 -19
  481. package/tokens.json +13 -1
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useCallback, useMemo, useRef, useState } from "react";
3
+ import { useCallback, useId, useMemo, useRef, useState } from "react";
4
4
  import clsx from "clsx";
5
5
  import { Icon } from "../../../icon/Icon.js";
6
6
  import { useAnchored } from "../../../internal/use-anchored.js";
@@ -15,10 +15,15 @@ function Combobox({
15
15
  value,
16
16
  defaultValue,
17
17
  onValueChange,
18
- placeholder = "\u641C\u7D22\u6216\u9009\u62E9",
18
+ placeholder = "\u641C\u7D22\u9009\u9879",
19
19
  emptyText = "\u65E0\u5339\u914D\u9879",
20
20
  disabled = false,
21
+ invalid = false,
21
22
  className,
23
+ id,
24
+ "aria-label": ariaLabel,
25
+ "aria-labelledby": ariaLabelledBy,
26
+ "aria-describedby": ariaDescribedBy,
22
27
  ...rest
23
28
  }) {
24
29
  const [internal, setInternal] = useState(defaultValue);
@@ -27,6 +32,10 @@ function Combobox({
27
32
  const current = value === void 0 ? internal : value;
28
33
  const selected = options.find((option) => option.value === current);
29
34
  const shellRef = useRef(null);
35
+ const inputRef = useRef(null);
36
+ const baseId = useId();
37
+ const listboxId = `${baseId}-listbox`;
38
+ const optionId = (index) => `${baseId}-option-${index}`;
30
39
  const shown = useMemo(() => {
31
40
  const needle = query.trim().toLowerCase();
32
41
  if (!needle) return options;
@@ -56,11 +65,12 @@ function Combobox({
56
65
  );
57
66
  const { active, setActive, onKeyDown } = useListNavigation({
58
67
  count: shown.length,
59
- getText: (i) => shown[i] ? searchTextOf(shown[i]) : "",
60
68
  onSelect: choose,
61
- onDismiss: close
69
+ onDismiss: close,
70
+ textEntry: true
62
71
  });
63
72
  const inputValue = open ? query : selected ? searchTextOf(selected) : "";
73
+ const activeId = open && active >= 0 && active < shown.length ? optionId(active) : void 0;
64
74
  return /* @__PURE__ */ jsxs("div", { className: clsx("mh-combobox", className), ...rest, children: [
65
75
  /* @__PURE__ */ jsxs(
66
76
  "div",
@@ -72,24 +82,61 @@ function Combobox({
72
82
  className: "mh-combobox__shell",
73
83
  "data-open": open || void 0,
74
84
  "data-disabled": disabled || void 0,
85
+ "data-invalid": invalid || void 0,
86
+ onMouseDown: (event) => {
87
+ if (disabled || event.target === inputRef.current) return;
88
+ event.preventDefault();
89
+ inputRef.current?.focus();
90
+ if (open) close();
91
+ else setOpen(true);
92
+ },
75
93
  children: [
76
94
  /* @__PURE__ */ jsx(
77
95
  "input",
78
96
  {
97
+ ref: inputRef,
98
+ id,
79
99
  className: "mh-combobox__input",
80
100
  role: "combobox",
101
+ "aria-label": ariaLabel,
102
+ "aria-labelledby": ariaLabelledBy,
103
+ "aria-describedby": ariaDescribedBy,
81
104
  "aria-expanded": open,
105
+ "aria-controls": open ? listboxId : void 0,
106
+ "aria-activedescendant": activeId,
82
107
  "aria-autocomplete": "list",
108
+ "aria-invalid": invalid || void 0,
83
109
  disabled,
84
110
  value: inputValue,
85
111
  placeholder,
86
- onFocus: () => setOpen(true),
112
+ onFocus: (event) => event.target.select(),
113
+ onClick: () => {
114
+ if (!open) setOpen(true);
115
+ },
116
+ onBlur: (event) => {
117
+ if (!refs.floating.current?.contains(event.relatedTarget)) close();
118
+ },
87
119
  onChange: (event) => {
88
120
  setQuery(event.target.value);
89
121
  setOpen(true);
90
122
  setActive(-1);
91
123
  },
92
- onKeyDown
124
+ onKeyDown: (event) => {
125
+ if (open) {
126
+ if (event.key === "Tab") close();
127
+ else onKeyDown(event);
128
+ return;
129
+ }
130
+ if (event.key !== "ArrowDown" && event.key !== "ArrowUp") return;
131
+ event.preventDefault();
132
+ setOpen(true);
133
+ if (event.altKey) {
134
+ setActive(-1);
135
+ return;
136
+ }
137
+ const index = options.findIndex((option) => option.value === current);
138
+ setActive(index >= 0 ? index : event.key === "ArrowDown" ? 0 : options.length - 1);
139
+ }
93
140
  }
94
141
  ),
95
142
  /* @__PURE__ */ jsx(Icon, { className: "mh-combobox__chevron", name: "chevron-down", size: 14 })
@@ -100,12 +147,17 @@ function Combobox({
100
147
  "div",
101
148
  {
102
149
  ref: refs.setFloating,
150
+ id: listboxId,
103
151
  className: "mh-combobox__listbox",
104
152
  role: "listbox",
153
+ "aria-label": ariaLabel,
154
+ "aria-labelledby": ariaLabel ? void 0 : ariaLabelledBy,
105
155
  style: floatingStyles,
156
+ onMouseDown: (event) => event.preventDefault(),
106
157
  children: shown.length === 0 ? /* @__PURE__ */ jsx("div", { className: "mh-combobox__empty", children: emptyText }) : shown.map((option, index) => /* @__PURE__ */ jsx(
107
158
  "div",
108
159
  {
160
+ id: optionId(index),
109
161
  className: "mh-combobox__option",
110
162
  role: "option",
111
163
  "aria-selected": option.value === current,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Combobox.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useMemo, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n ComboboxProps,\n ComboboxOption,\n} from '../../../../contracts/foundation/input-selection/combobox.js'\n\nexport type { ComboboxProps, ComboboxOption }\n\n/**\n * 取一个选项用于筛选匹配的纯文本。\n *\n * `searchText` 优先;没有它时只有 `label` 是字符串才参与匹配(04 · I13)——\n * 源实现一律 `String(label)`,ReactNode 会 stringify 成 `[object Object]`,\n * 于是带图标或高亮的选项永远筛不到。契约因此把 `searchText` 定为\n * 「label 非字符串时**必须**提供」。\n */\nfunction searchTextOf(option: ComboboxOption): string {\n if (option.searchText !== undefined) return option.searchText\n return typeof option.label === 'string' ? option.label : ''\n}\n\n/**\n * 可输入筛选的单选控件。\n *\n * 两处相对源实现的修正:\n *\n * ① 关闭不再靠 `setTimeout(120)`。源实现在 `onBlur` 里延迟 120ms 关闭,好让\n * 选项的 `onMouseDown` 抢在前面 —— 这是一个纯粹靠时序赌赢的写法,慢一点的\n * 机器上点选项会落空。改用共享的外点击判定。\n * ② 补键盘导航(04 · I12)。\n */\nexport function Combobox({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '搜索或选择',\n emptyText = '无匹配项',\n disabled = false,\n className,\n ...rest\n}: ComboboxProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const [query, setQuery] = useState('')\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const shellRef = useRef<HTMLDivElement>(null)\n\n const shown = useMemo(() => {\n const needle = query.trim().toLowerCase()\n if (!needle) return options\n return options.filter((option) => searchTextOf(option).toLowerCase().includes(needle))\n }, [options, query])\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => {\n setOpen(false)\n setQuery('')\n }, [])\n useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: shellRef })\n\n const choose = useCallback(\n (index: number) => {\n const option = shown[index]\n if (!option) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setQuery('')\n setOpen(false)\n },\n [shown, value, onValueChange]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: shown.length,\n getText: (i) => (shown[i] ? searchTextOf(shown[i]!) : ''),\n onSelect: choose,\n onDismiss: close,\n })\n\n // 输入框里显示的文本:展开时是查询词,收起时是已选项的文本。\n const inputValue = open ? query : selected ? searchTextOf(selected) : ''\n\n return (\n <div className={clsx('mh-combobox', className)} {...rest}>\n <div\n ref={(node) => {\n shellRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-combobox__shell\"\n data-open={open || undefined}\n data-disabled={disabled || undefined}\n >\n <input\n className=\"mh-combobox__input\"\n role=\"combobox\"\n aria-expanded={open}\n aria-autocomplete=\"list\"\n disabled={disabled}\n value={inputValue}\n placeholder={placeholder}\n onFocus={() => setOpen(true)}\n onChange={(event) => {\n setQuery(event.target.value)\n setOpen(true)\n setActive(-1)\n }}\n onKeyDown={onKeyDown}\n />\n <Icon className=\"mh-combobox__chevron\" name=\"chevron-down\" size={14} />\n </div>\n\n {open && (\n <div\n ref={refs.setFloating}\n className=\"mh-combobox__listbox\"\n role=\"listbox\"\n style={floatingStyles}\n >\n {shown.length === 0 ? (\n <div className=\"mh-combobox__empty\">{emptyText}</div>\n ) : (\n shown.map((option, index) => (\n <div\n key={option.value}\n className=\"mh-combobox__option\"\n role=\"option\"\n aria-selected={option.value === current}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n {option.label}\n </div>\n ))\n )}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Combobox.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useId, useMemo, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n ComboboxProps,\n ComboboxOption,\n} from '../../../../contracts/foundation/input-selection/combobox.js'\n\nexport type { ComboboxProps, ComboboxOption }\n\n/**\n * 取一个选项用于筛选匹配的纯文本。\n *\n * `searchText` 优先;没有它时只有 `label` 是字符串才参与匹配(04 · I13)——\n * 源实现一律 `String(label)`,ReactNode 会 stringify 成 `[object Object]`,\n * 于是带图标或高亮的选项永远筛不到。契约因此把 `searchText` 定为\n * 「label 非字符串时**必须**提供」。\n */\nfunction searchTextOf(option: ComboboxOption): string {\n if (option.searchText !== undefined) return option.searchText\n return typeof option.label === 'string' ? option.label : ''\n}\n\n/**\n * 可输入筛选的单选控件。\n *\n * 两处相对源实现的修正:\n *\n * ① 关闭不再靠 `setTimeout(120)`。源实现在 `onBlur` 里延迟 120ms 关闭,好让\n * 选项的 `onMouseDown` 抢在前面 —— 这是一个纯粹靠时序赌赢的写法,慢一点的\n * 机器上点选项会落空。改用共享的外点击判定;浮层上的 `mousedown` 一律\n * `preventDefault`,焦点从不离开输入框,失焦关闭因此不会抢掉选项的点击。\n * ② 补键盘导航(04 · I12)。\n *\n * 读屏与键盘按 WAI-ARIA 1.2 combobox 模式(06 · P3-10):\n *\n * - `role=\"combobox\"`、`aria-expanded`、`aria-controls`、`aria-activedescendant`\n * 全在输入框上 —— 焦点始终在输入框,活动项只有经 `aria-activedescendant` 才报得出来。\n * - `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到输入框,其余属性\n * 仍在根元素。此前落在根 div,`Field htmlFor` 与 `aria-label` 都给了一个读屏不读的元素。\n * - **聚焦不展开。** 此前一 Tab 进来浮层就盖住下方字段,键盘用户只是路过也得先\n * 关掉它。展开的入口是输入、↓ / ↑(落到当前选中项或首 / 末项)、Alt+↓(只展开)\n * 与鼠标点击。\n * - Tab 与失焦即收起,不抢走焦点。收起状态下 Esc 与 Enter 原样放行 —— 前者留给\n * 外层对话框,后者留给表单提交。\n *\n * `invalid`(06 · P1-16)分两处落:`aria-invalid` 在输入框上(与 `id` 同处,`Field`\n * 关联的就是它),danger 边框画在外壳上(焦点与边框本就由外壳表达)。\n */\nexport function Combobox({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '搜索选项',\n emptyText = '无匹配项',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: ComboboxProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const [query, setQuery] = useState('')\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const shellRef = useRef<HTMLDivElement>(null)\n const inputRef = useRef<HTMLInputElement>(null)\n const baseId = useId()\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n\n const shown = useMemo(() => {\n const needle = query.trim().toLowerCase()\n if (!needle) return options\n return options.filter((option) => searchTextOf(option).toLowerCase().includes(needle))\n }, [options, query])\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => {\n setOpen(false)\n setQuery('')\n }, [])\n useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: shellRef })\n\n const choose = useCallback(\n (index: number) => {\n const option = shown[index]\n if (!option) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setQuery('')\n setOpen(false)\n },\n [shown, value, onValueChange]\n )\n\n // 筛选由输入框本身承担,不做首字母跳转;按键交给输入框编辑文本\n const { active, setActive, onKeyDown } = useListNavigation({\n count: shown.length,\n onSelect: choose,\n onDismiss: close,\n textEntry: true,\n })\n\n // 输入框里显示的文本:展开时是查询词,收起时是已选项的文本。\n const inputValue = open ? query : selected ? searchTextOf(selected) : ''\n const activeId = open && active >= 0 && active < shown.length ? optionId(active) : undefined\n\n return (\n <div className={clsx('mh-combobox', className)} {...rest}>\n <div\n ref={(node) => {\n shellRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-combobox__shell\"\n data-open={open || undefined}\n data-disabled={disabled || undefined}\n data-invalid={invalid || undefined}\n onMouseDown={(event) => {\n // 点外壳的空白或箭头:焦点交给输入框并切换展开。点输入框本身走它自己的 onClick。\n if (disabled || event.target === inputRef.current) return\n event.preventDefault()\n inputRef.current?.focus()\n if (open) close()\n else setOpen(true)\n }}\n >\n <input\n ref={inputRef}\n id={id}\n className=\"mh-combobox__input\"\n role=\"combobox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={ariaDescribedBy}\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-activedescendant={activeId}\n aria-autocomplete=\"list\"\n aria-invalid={invalid || undefined}\n disabled={disabled}\n value={inputValue}\n placeholder={placeholder}\n // 收起时框里是已选项的文本;全选它,键入即替换成查询词,而不是接在已选文本后面\n // 筛出一个空列表。此前聚焦即展开、框里随之清空,不存在这个问题。\n onFocus={(event) => event.target.select()}\n onClick={() => {\n if (!open) setOpen(true)\n }}\n onBlur={(event) => {\n if (!refs.floating.current?.contains(event.relatedTarget as Node | null)) close()\n }}\n onChange={(event) => {\n setQuery(event.target.value)\n setOpen(true)\n setActive(-1)\n }}\n onKeyDown={(event) => {\n if (open) {\n if (event.key === 'Tab') close()\n else onKeyDown(event)\n return\n }\n if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return\n event.preventDefault()\n setOpen(true)\n if (event.altKey) {\n setActive(-1)\n return\n }\n const index = options.findIndex((option) => option.value === current)\n setActive(index >= 0 ? index : event.key === 'ArrowDown' ? 0 : options.length - 1)\n }}\n />\n <Icon className=\"mh-combobox__chevron\" name=\"chevron-down\" size={14} />\n </div>\n\n {open && (\n <div\n ref={refs.setFloating}\n id={listboxId}\n className=\"mh-combobox__listbox\"\n role=\"listbox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabel ? undefined : ariaLabelledBy}\n style={floatingStyles}\n // 焦点留在输入框:点选项、拖滚动条都不触发输入框失焦。\n onMouseDown={(event) => event.preventDefault()}\n >\n {shown.length === 0 ? (\n <div className=\"mh-combobox__empty\">{emptyText}</div>\n ) : (\n shown.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-combobox__option\"\n role=\"option\"\n aria-selected={option.value === current}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n {option.label}\n </div>\n ))\n )}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
@@ -1,20 +1,25 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import clsx from "clsx";
3
3
  import { Label } from "./Label.js";
4
+ import { FieldAssociation } from "../../../internal/FieldAssociation.js";
4
5
  function Field({
5
6
  label,
6
7
  description,
7
8
  error,
8
9
  required = false,
9
10
  htmlFor,
11
+ span,
10
12
  className,
11
13
  children,
12
14
  ...rest
13
15
  }) {
14
- return /* @__PURE__ */ jsxs("div", { className: clsx("mh-field", className), ...rest, children: [
16
+ const message = error ? "error" : description ? "description" : null;
17
+ const messageId = htmlFor && message ? `${htmlFor}-${message}` : void 0;
18
+ return /* @__PURE__ */ jsxs("div", { className: clsx("mh-field", className), "data-span": span, ...rest, children: [
15
19
  label && /* @__PURE__ */ jsx(Label, { htmlFor, required, children: label }),
16
20
  children,
17
- error ? /* @__PURE__ */ jsx("span", { className: "mh-field__error", children: error }) : description && /* @__PURE__ */ jsx("span", { className: "mh-field__description", children: description })
21
+ error ? /* @__PURE__ */ jsx("span", { id: messageId, className: "mh-field__error", role: "alert", children: error }) : description && /* @__PURE__ */ jsx("span", { id: messageId, className: "mh-field__description", children: description }),
22
+ htmlFor && messageId && /* @__PURE__ */ jsx(FieldAssociation, { control: htmlFor, describedBy: messageId, invalid: Boolean(error) })
18
23
  ] });
19
24
  }
20
25
  export {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Field.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport { Label } from './Label.js'\nimport type { FieldProps } from '../../../../contracts/foundation/input-selection/field.js'\n\nexport type { FieldProps }\n\n/**\n * 表单行:标签 + 控件 + 一行说明**或**错误。\n *\n * 本组件只拥有垂直节奏(4px 间隙),绝不干预控件自身的视觉。\n *\n * 标签复用 `Label` 而不是再实现一遍(04 · I4)。源实现两处各写各的,差异\n * 已经出现:`Label` 用容器 `gap: 2` 放星号,`Field` 用星号自己的\n * `margin-left: 2` —— 标签有多个子节点时两者表现不同。`Label` 是标签视觉的\n * Foundation Owner,这里只是它的调用方。\n *\n * `error` **不会**把内部控件切到 invalid 态(04 · I5)。这是有意保留的不联动:\n * 让 Field 下发 invalid 要么引入 context 与 `\"use client\"`,要么用\n * `cloneElement` 注入 —— 后者正是 §1.7 刚否决掉的机制。改由阶段 5 的 lint\n * 规则拦截「Field 带 error 但内部控件没有 invalid」。\n */\nexport function Field({\n label,\n description,\n error,\n required = false,\n htmlFor,\n className,\n children,\n ...rest\n}: FieldProps) {\n return (\n <div className={clsx('mh-field', className)} {...rest}>\n {label && (\n <Label htmlFor={htmlFor} required={required}>\n {label}\n </Label>\n )}\n {children}\n {error ? (\n <span className=\"mh-field__error\">{error}</span>\n ) : (\n description && <span className=\"mh-field__description\">{description}</span>\n )}\n </div>\n )\n}\n"],"mappings":"AAgCI,SAEI,KAFJ;AAhCJ,OAAO,UAAU;AACjB,SAAS,aAAa;AAoBf,SAAS,MAAM;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAe;AACb,SACE,qBAAC,SAAI,WAAW,KAAK,YAAY,SAAS,GAAI,GAAG,MAC9C;AAAA,aACC,oBAAC,SAAM,SAAkB,UACtB,iBACH;AAAA,IAED;AAAA,IACA,QACC,oBAAC,UAAK,WAAU,mBAAmB,iBAAM,IAEzC,eAAe,oBAAC,UAAK,WAAU,yBAAyB,uBAAY;AAAA,KAExE;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Field.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport { Label } from './Label.js'\nimport { FieldAssociation } from '../../../internal/FieldAssociation.js'\nimport type { FieldProps } from '../../../../contracts/foundation/input-selection/field.js'\n\nexport type { FieldProps }\n\n/**\n * 表单行:标签 + 控件 + 一行说明**或**错误。\n *\n * 本组件只拥有垂直节奏(4px 间隙),绝不干预控件自身的视觉。\n *\n * 标签复用 `Label` 而不是再实现一遍(04 · I4)。源实现两处各写各的,差异\n * 已经出现:`Label` 用容器 `gap: 2` 放星号,`Field` 用星号自己的\n * `margin-left: 2` —— 标签有多个子节点时两者表现不同。`Label` 是标签视觉的\n * Foundation Owner,这里只是它的调用方。\n *\n * `error` **不会**把内部控件切到 invalid 态(04 · I5)。这是有意保留的不联动:\n * 让 Field 下发 invalid 要么引入 context 与 `\"use client\"`,要么用\n * `cloneElement` 注入 —— 后者正是 §1.7 刚否决掉的机制。改由阶段 5 的 lint\n * 规则拦截「Field 带 error 但内部控件没有 invalid」。\n *\n * 读屏关联(06 · P3-11):给了 `htmlFor` 时,说明与错误取 `<htmlFor>-description` /\n * `<htmlFor>-error` 为 id,并由 `FieldAssociation` 并入该控件的 `aria-describedby`;\n * 有错误时控件若没有 `aria-invalid` 一并补上 —— 只补读屏语义,失败态视觉仍按上一段\n * 由控件的 `invalid` 决定。错误带 `role=\"alert\"`,出现即播报。没有 `htmlFor` 时\n * 标签本就关联不到控件,这里同样不做关联。\n */\nexport function Field({\n label,\n description,\n error,\n required = false,\n htmlFor,\n span,\n className,\n children,\n ...rest\n}: FieldProps) {\n const message = error ? 'error' : description ? 'description' : null\n const messageId = htmlFor && message ? `${htmlFor}-${message}` : undefined\n\n return (\n <div className={clsx('mh-field', className)} data-span={span} {...rest}>\n {label && (\n <Label htmlFor={htmlFor} required={required}>\n {label}\n </Label>\n )}\n {children}\n {error ? (\n <span id={messageId} className=\"mh-field__error\" role=\"alert\">\n {error}\n </span>\n ) : (\n description && (\n <span id={messageId} className=\"mh-field__description\">\n {description}\n </span>\n )\n )}\n {htmlFor && messageId && (\n <FieldAssociation control={htmlFor} describedBy={messageId} invalid={Boolean(error)} />\n )}\n </div>\n )\n}\n"],"mappings":"AA2CI,SAEI,KAFJ;AA3CJ,OAAO,UAAU;AACjB,SAAS,aAAa;AACtB,SAAS,wBAAwB;AA0B1B,SAAS,MAAM;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAe;AACb,QAAM,UAAU,QAAQ,UAAU,cAAc,gBAAgB;AAChE,QAAM,YAAY,WAAW,UAAU,GAAG,OAAO,IAAI,OAAO,KAAK;AAEjE,SACE,qBAAC,SAAI,WAAW,KAAK,YAAY,SAAS,GAAG,aAAW,MAAO,GAAG,MAC/D;AAAA,aACC,oBAAC,SAAM,SAAkB,UACtB,iBACH;AAAA,IAED;AAAA,IACA,QACC,oBAAC,UAAK,IAAI,WAAW,WAAU,mBAAkB,MAAK,SACnD,iBACH,IAEA,eACE,oBAAC,UAAK,IAAI,WAAW,WAAU,yBAC5B,uBACH;AAAA,IAGH,WAAW,aACV,oBAAC,oBAAiB,SAAS,SAAS,aAAa,WAAW,SAAS,QAAQ,KAAK,GAAG;AAAA,KAEzF;AAEJ;","names":[]}
@@ -1,6 +1,10 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
2
  import clsx from "clsx";
3
- function Input({ invalid = false, className, ...rest }) {
3
+ function Input({
4
+ invalid = false,
5
+ className,
6
+ ...rest
7
+ }) {
4
8
  return /* @__PURE__ */ jsx(
5
9
  "input",
6
10
  {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Input.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { InputProps } from '../../../../contracts/foundation/input-selection/input.js'\n\nexport type { InputProps }\n\n/**\n * 单行文本控件。\n *\n * 搜索请用 `SearchField` —— 它拥有紧凑工具栏外壳,不要用 Input 自行拼装。\n *\n * 无 `\"use client\"`。源实现用 `useState` 记录焦点,还因此带了一个 bug:\n * `{...rest}` 展开在 `onFocus` / `onBlur` **之后**,调用方一传自己的 `onFocus`,\n * 内部 `setFocus` 就不再执行,焦点视觉态静默失效(04 · I3)。焦点交给\n * `:focus-visible` 之后,状态和这个 bug 一起消失。\n */\nexport function Input({ invalid = false, className, ...rest }: InputProps) {\n return (\n <input\n className={clsx('mh-input', className)}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n />\n )\n}\n"],"mappings":"AAiBI;AAjBJ,OAAO,UAAU;AAeV,SAAS,MAAM,EAAE,UAAU,OAAO,WAAW,GAAG,KAAK,GAAe;AACzE,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,YAAY,SAAS;AAAA,MACrC,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA;AAAA,EACN;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Input.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { Ref } from 'react'\nimport type { InputProps } from '../../../../contracts/foundation/input-selection/input.js'\n\nexport type { InputProps }\n\n/**\n * 单行文本控件。\n *\n * 搜索请用 `SearchField` —— 它拥有紧凑工具栏外壳,不要用 Input 自行拼装。\n *\n * 无 `\"use client\"`。源实现用 `useState` 记录焦点,还因此带了一个 bug:\n * `{...rest}` 展开在 `onFocus` / `onBlur` **之后**,调用方一传自己的 `onFocus`,\n * 内部 `setFocus` 就不再执行,焦点视觉态静默失效(04 · I3)。焦点交给\n * `:focus-visible` 之后,状态和这个 bug 一起消失。\n *\n * `ref` 落到 `<input>` 本身(06 · P2-22):React 19 起 `ref` 是普通 prop,随 `rest`\n * 展开到原生元素,不需要 `forwardRef`。签名里另声明它,是因为契约继承的\n * `InputHTMLAttributes` 不含 `ref`,不声明则调用方传了会被 tsc 拒绝。React 18 不把\n * `ref` 交给函数组件,在那里它不生效。\n */\nexport function Input({\n invalid = false,\n className,\n ...rest\n}: InputProps & { ref?: Ref<HTMLInputElement> }) {\n return (\n <input\n className={clsx('mh-input', className)}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n />\n )\n}\n"],"mappings":"AA2BI;AA3BJ,OAAO,UAAU;AAqBV,SAAS,MAAM;AAAA,EACpB,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAiD;AAC/C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,YAAY,SAAS;AAAA,MACrC,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA;AAAA,EACN;AAEJ;","names":[]}
@@ -4,6 +4,7 @@ function InputGroup({
4
4
  leading,
5
5
  trailing,
6
6
  disabled = false,
7
+ invalid = false,
7
8
  className,
8
9
  children,
9
10
  ...rest
@@ -13,6 +14,7 @@ function InputGroup({
13
14
  {
14
15
  className: clsx("mh-input-group", className),
15
16
  "data-disabled": disabled || void 0,
17
+ "data-invalid": invalid || void 0,
16
18
  ...rest,
17
19
  children: [
18
20
  leading && /* @__PURE__ */ jsx("span", { className: "mh-input-group__addon", children: leading }),
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/InputGroup.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { InputGroupProps } from '../../../../contracts/foundation/input-selection/input-group.js'\n\nexport type { InputGroupProps }\n\n/**\n * 单一焦点壳,包裹前置/后置附加物与一个控件。\n *\n * 这是 `SearchField` 适配的 Foundation 基座。不要把它的壳复制进页面 ——\n * 需要搜索时直接用 `SearchField`。\n *\n * 无 `\"use client\"`,也无 `cloneElement`(04 · I6)。源实现用 `cloneElement`\n * 剥掉子控件的 border / background / padding / box-shadow,依赖一条未成文约定:\n * **子组件必须把 `style` 展开在自己样式的最后**。任何控件改变展开顺序,剥离就\n * 静默失效,表现为双层边框和双圈焦点环。后代选择器不需要这条约定。\n *\n * 焦点由外壳用 `:focus-within` 表达一次,内部控件的焦点环被显式去掉。\n */\nexport function InputGroup({\n leading,\n trailing,\n disabled = false,\n className,\n children,\n ...rest\n}: InputGroupProps) {\n return (\n <div\n className={clsx('mh-input-group', className)}\n data-disabled={disabled || undefined}\n {...rest}\n >\n {leading && <span className=\"mh-input-group__addon\">{leading}</span>}\n <span className=\"mh-input-group__control\">{children}</span>\n {trailing && <span className=\"mh-input-group__addon\">{trailing}</span>}\n </div>\n )\n}\n"],"mappings":"AA2BI,SAKc,KALd;AA3BJ,OAAO,UAAU;AAkBV,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,kBAAkB,SAAS;AAAA,MAC3C,iBAAe,YAAY;AAAA,MAC1B,GAAG;AAAA,MAEH;AAAA,mBAAW,oBAAC,UAAK,WAAU,yBAAyB,mBAAQ;AAAA,QAC7D,oBAAC,UAAK,WAAU,2BAA2B,UAAS;AAAA,QACnD,YAAY,oBAAC,UAAK,WAAU,yBAAyB,oBAAS;AAAA;AAAA;AAAA,EACjE;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/InputGroup.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { InputGroupProps } from '../../../../contracts/foundation/input-selection/input-group.js'\n\nexport type { InputGroupProps }\n\n/**\n * 单一焦点壳,包裹前置/后置附加物与一个控件。\n *\n * 这是 `SearchField` 适配的 Foundation 基座。不要把它的壳复制进页面 ——\n * 需要搜索时直接用 `SearchField`。\n *\n * 无 `\"use client\"`,也无 `cloneElement`(04 · I6)。源实现用 `cloneElement`\n * 剥掉子控件的 border / background / padding / box-shadow,依赖一条未成文约定:\n * **子组件必须把 `style` 展开在自己样式的最后**。任何控件改变展开顺序,剥离就\n * 静默失效,表现为双层边框和双圈焦点环。后代选择器不需要这条约定。\n *\n * 焦点由外壳用 `:focus-within` 表达一次,内部控件的焦点环被显式去掉。\n *\n * `invalid`(06 · P1-16)只画外壳的 danger 边框,不输出 `aria-invalid`:壳是包装\n * 元素,失败语义属于里面那个控件。内部 `Input` 的 `invalid` 在壳内只剩\n * `aria-invalid` 生效(边框已被剥掉),两者同设才是完整的失败态。没有 `:has()`\n * 可用(理由见 CSS),壳也就无从反推内部控件的状态。\n */\nexport function InputGroup({\n leading,\n trailing,\n disabled = false,\n invalid = false,\n className,\n children,\n ...rest\n}: InputGroupProps) {\n return (\n <div\n className={clsx('mh-input-group', className)}\n data-disabled={disabled || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n >\n {leading && <span className=\"mh-input-group__addon\">{leading}</span>}\n <span className=\"mh-input-group__control\">{children}</span>\n {trailing && <span className=\"mh-input-group__addon\">{trailing}</span>}\n </div>\n )\n}\n"],"mappings":"AAiCI,SAMc,KANd;AAjCJ,OAAO,UAAU;AAuBV,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,kBAAkB,SAAS;AAAA,MAC3C,iBAAe,YAAY;AAAA,MAC3B,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA,MAEH;AAAA,mBAAW,oBAAC,UAAK,WAAU,yBAAyB,mBAAQ;AAAA,QAC7D,oBAAC,UAAK,WAAU,2BAA2B,UAAS;AAAA,QACnD,YAAY,oBAAC,UAAK,WAAU,yBAAyB,oBAAS;AAAA;AAAA;AAAA,EACjE;AAEJ;","names":[]}
@@ -13,6 +13,7 @@ function InputOTP({
13
13
  defaultValue = "",
14
14
  onValueChange,
15
15
  disabled = false,
16
+ invalid = false,
16
17
  className,
17
18
  ...rest
18
19
  }) {
@@ -45,7 +46,7 @@ function InputOTP({
45
46
  else return;
46
47
  if (event.key !== "Backspace") event.preventDefault();
47
48
  };
48
- return /* @__PURE__ */ jsx("div", { className: clsx("mh-input-otp", className), ...rest, children: Array.from({ length }, (_, index) => /* @__PURE__ */ jsx(
49
+ return /* @__PURE__ */ jsx("div", { className: clsx("mh-input-otp", className), "data-invalid": invalid || void 0, ...rest, children: Array.from({ length }, (_, index) => /* @__PURE__ */ jsx(
49
50
  "input",
50
51
  {
51
52
  ref: (el) => {
@@ -58,6 +59,7 @@ function InputOTP({
58
59
  disabled,
59
60
  value: current[index]?.trim() ?? "",
60
61
  "aria-label": `\u7B2C ${index + 1} \u4F4D`,
62
+ "aria-invalid": invalid || void 0,
61
63
  onChange: (event) => {
62
64
  const char = event.target.value.slice(-1);
63
65
  commit(writeAt(current, index, char, length));
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/InputOTP.tsx"],"sourcesContent":["'use client'\n\nimport { useRef, useState } from 'react'\nimport type { ClipboardEvent as ReactClipboardEvent, KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport type { InputOTPProps } from '../../../../contracts/foundation/input-selection/input-otp.js'\n\nexport type { InputOTPProps }\n\n/** 把某一位写进码串。不足位补空格,使第 i 个字符始终对应第 i 格。 */\nfunction writeAt(current: string, index: number, char: string, length: number): string {\n const chars = current.padEnd(length, ' ').slice(0, length).split('')\n chars[index] = char || ' '\n return chars.join('').replace(/ +$/, '')\n}\n\n/**\n * 定长验证码输入 —— 每个字符一个 40px 方框,光标自动前进。\n *\n * 空框上按退格回退到前一格。每个方框带独立的 `aria-label`(第 N 位)。\n *\n * ── 粘贴(04 · I19)────────────────────────────────────────────\n * 源实现每格 `maxLength=1`,粘贴一个 6 位码只会落进当前格的一个字符,其余被\n * 浏览器截断 —— 而从短信里复制粘贴恰恰是验证码最主要的输入方式。这里接管\n * `onPaste`,从当前格起依次填入,并把焦点移到最后一个填充位。\n *\n * ── 中间空位 ───────────────────────────────────────────────────\n * 值以空格占位保持「第 i 个字符对应第 i 格」,尾部空格会被裁掉。用户跳格输入\n * 时中间会留空格 —— 这是定长码用单一字符串表达位置的固有结果,调用方校验时\n * 应当把含空格的值视为未填完。\n *\n * 中文 aria-label 硬编码是 I16 的既定裁决(接受硬编码、声明单语言),不是遗漏。\n */\nexport function InputOTP({\n length = 6,\n value,\n defaultValue = '',\n onValueChange,\n disabled = false,\n className,\n ...rest\n}: InputOTPProps) {\n const [internal, setInternal] = useState(defaultValue)\n const current = value === undefined ? internal : value\n const refs = useRef<(HTMLInputElement | null)[]>([])\n\n const commit = (next: string) => {\n if (value === undefined) setInternal(next)\n onValueChange?.(next)\n }\n\n const focusBox = (index: number) => {\n refs.current[Math.max(0, Math.min(length - 1, index))]?.focus()\n }\n\n const handlePaste = (index: number) => (event: ReactClipboardEvent<HTMLInputElement>) => {\n const pasted = event.clipboardData.getData('text').replace(/\\s+/g, '')\n if (!pasted) return\n event.preventDefault()\n\n let next = current\n const room = Math.min(pasted.length, length - index)\n for (let i = 0; i < room; i += 1) {\n next = writeAt(next, index + i, pasted[i]!, length)\n }\n commit(next)\n focusBox(index + room)\n }\n\n const handleKeyDown = (index: number) => (event: ReactKeyboardEvent<HTMLInputElement>) => {\n if (event.key === 'Backspace' && !current[index]) focusBox(index - 1)\n else if (event.key === 'ArrowLeft') focusBox(index - 1)\n else if (event.key === 'ArrowRight') focusBox(index + 1)\n else return\n if (event.key !== 'Backspace') event.preventDefault()\n }\n\n return (\n <div className={clsx('mh-input-otp', className)} {...rest}>\n {Array.from({ length }, (_, index) => (\n <input\n key={index}\n ref={(el) => {\n refs.current[index] = el\n }}\n className=\"mh-input-otp__box\"\n inputMode=\"numeric\"\n autoComplete=\"one-time-code\"\n maxLength={1}\n disabled={disabled}\n value={current[index]?.trim() ?? ''}\n aria-label={`第 ${index + 1} 位`}\n onChange={(event) => {\n const char = event.target.value.slice(-1)\n commit(writeAt(current, index, char, length))\n if (char) focusBox(index + 1)\n }}\n onPaste={handlePaste(index)}\n onKeyDown={handleKeyDown(index)}\n />\n ))}\n </div>\n )\n}\n"],"mappings":";AAgFQ;AA9ER,SAAS,QAAQ,gBAAgB;AAEjC,OAAO,UAAU;AAMjB,SAAS,QAAQ,SAAiB,OAAe,MAAc,QAAwB;AACrF,QAAM,QAAQ,QAAQ,OAAO,QAAQ,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE;AACnE,QAAM,KAAK,IAAI,QAAQ;AACvB,SAAO,MAAM,KAAK,EAAE,EAAE,QAAQ,OAAO,EAAE;AACzC;AAmBO,SAAS,SAAS;AAAA,EACvB,SAAS;AAAA,EACT;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAkB;AAChB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,YAAY;AACrD,QAAM,UAAU,UAAU,SAAY,WAAW;AACjD,QAAM,OAAO,OAAoC,CAAC,CAAC;AAEnD,QAAM,SAAS,CAAC,SAAiB;AAC/B,QAAI,UAAU,OAAW,aAAY,IAAI;AACzC,oBAAgB,IAAI;AAAA,EACtB;AAEA,QAAM,WAAW,CAAC,UAAkB;AAClC,SAAK,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,MAAM;AAAA,EAChE;AAEA,QAAM,cAAc,CAAC,UAAkB,CAAC,UAAiD;AACvF,UAAM,SAAS,MAAM,cAAc,QAAQ,MAAM,EAAE,QAAQ,QAAQ,EAAE;AACrE,QAAI,CAAC,OAAQ;AACb,UAAM,eAAe;AAErB,QAAI,OAAO;AACX,UAAM,OAAO,KAAK,IAAI,OAAO,QAAQ,SAAS,KAAK;AACnD,aAAS,IAAI,GAAG,IAAI,MAAM,KAAK,GAAG;AAChC,aAAO,QAAQ,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAI,MAAM;AAAA,IACpD;AACA,WAAO,IAAI;AACX,aAAS,QAAQ,IAAI;AAAA,EACvB;AAEA,QAAM,gBAAgB,CAAC,UAAkB,CAAC,UAAgD;AACxF,QAAI,MAAM,QAAQ,eAAe,CAAC,QAAQ,KAAK,EAAG,UAAS,QAAQ,CAAC;AAAA,aAC3D,MAAM,QAAQ,YAAa,UAAS,QAAQ,CAAC;AAAA,aAC7C,MAAM,QAAQ,aAAc,UAAS,QAAQ,CAAC;AAAA,QAClD;AACL,QAAI,MAAM,QAAQ,YAAa,OAAM,eAAe;AAAA,EACtD;AAEA,SACE,oBAAC,SAAI,WAAW,KAAK,gBAAgB,SAAS,GAAI,GAAG,MAClD,gBAAM,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,UAC1B;AAAA,IAAC;AAAA;AAAA,MAEC,KAAK,CAAC,OAAO;AACX,aAAK,QAAQ,KAAK,IAAI;AAAA,MACxB;AAAA,MACA,WAAU;AAAA,MACV,WAAU;AAAA,MACV,cAAa;AAAA,MACb,WAAW;AAAA,MACX;AAAA,MACA,OAAO,QAAQ,KAAK,GAAG,KAAK,KAAK;AAAA,MACjC,cAAY,UAAK,QAAQ,CAAC;AAAA,MAC1B,UAAU,CAAC,UAAU;AACnB,cAAM,OAAO,MAAM,OAAO,MAAM,MAAM,EAAE;AACxC,eAAO,QAAQ,SAAS,OAAO,MAAM,MAAM,CAAC;AAC5C,YAAI,KAAM,UAAS,QAAQ,CAAC;AAAA,MAC9B;AAAA,MACA,SAAS,YAAY,KAAK;AAAA,MAC1B,WAAW,cAAc,KAAK;AAAA;AAAA,IAjBzB;AAAA,EAkBP,CACD,GACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/InputOTP.tsx"],"sourcesContent":["'use client'\n\nimport { useRef, useState } from 'react'\nimport type { ClipboardEvent as ReactClipboardEvent, KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport type { InputOTPProps } from '../../../../contracts/foundation/input-selection/input-otp.js'\n\nexport type { InputOTPProps }\n\n/** 把某一位写进码串。不足位补空格,使第 i 个字符始终对应第 i 格。 */\nfunction writeAt(current: string, index: number, char: string, length: number): string {\n const chars = current.padEnd(length, ' ').slice(0, length).split('')\n chars[index] = char || ' '\n return chars.join('').replace(/ +$/, '')\n}\n\n/**\n * 定长验证码输入 —— 每个字符一个 40px 方框,光标自动前进。\n *\n * 空框上按退格回退到前一格。每个方框带独立的 `aria-label`(第 N 位)。\n *\n * ── 粘贴(04 · I19)────────────────────────────────────────────\n * 源实现每格 `maxLength=1`,粘贴一个 6 位码只会落进当前格的一个字符,其余被\n * 浏览器截断 —— 而从短信里复制粘贴恰恰是验证码最主要的输入方式。这里接管\n * `onPaste`,从当前格起依次填入,并把焦点移到最后一个填充位。\n *\n * ── 中间空位 ───────────────────────────────────────────────────\n * 值以空格占位保持「第 i 个字符对应第 i 格」,尾部空格会被裁掉。用户跳格输入\n * 时中间会留空格 —— 这是定长码用单一字符串表达位置的固有结果,调用方校验时\n * 应当把含空格的值视为未填完。\n *\n * 中文 aria-label 硬编码是 I16 的既定裁决(接受硬编码、声明单语言),不是遗漏。\n *\n * `invalid`(06 · P1-16):每个方框都是独立的文本框,`aria-invalid` 逐格输出,\n * 焦点停在哪一格都读得到失败态;danger 边框由根上的 `data-invalid` 统一驱动。\n */\nexport function InputOTP({\n length = 6,\n value,\n defaultValue = '',\n onValueChange,\n disabled = false,\n invalid = false,\n className,\n ...rest\n}: InputOTPProps) {\n const [internal, setInternal] = useState(defaultValue)\n const current = value === undefined ? internal : value\n const refs = useRef<(HTMLInputElement | null)[]>([])\n\n const commit = (next: string) => {\n if (value === undefined) setInternal(next)\n onValueChange?.(next)\n }\n\n const focusBox = (index: number) => {\n refs.current[Math.max(0, Math.min(length - 1, index))]?.focus()\n }\n\n const handlePaste = (index: number) => (event: ReactClipboardEvent<HTMLInputElement>) => {\n const pasted = event.clipboardData.getData('text').replace(/\\s+/g, '')\n if (!pasted) return\n event.preventDefault()\n\n let next = current\n const room = Math.min(pasted.length, length - index)\n for (let i = 0; i < room; i += 1) {\n next = writeAt(next, index + i, pasted[i]!, length)\n }\n commit(next)\n focusBox(index + room)\n }\n\n const handleKeyDown = (index: number) => (event: ReactKeyboardEvent<HTMLInputElement>) => {\n if (event.key === 'Backspace' && !current[index]) focusBox(index - 1)\n else if (event.key === 'ArrowLeft') focusBox(index - 1)\n else if (event.key === 'ArrowRight') focusBox(index + 1)\n else return\n if (event.key !== 'Backspace') event.preventDefault()\n }\n\n return (\n <div className={clsx('mh-input-otp', className)} data-invalid={invalid || undefined} {...rest}>\n {Array.from({ length }, (_, index) => (\n <input\n key={index}\n ref={(el) => {\n refs.current[index] = el\n }}\n className=\"mh-input-otp__box\"\n inputMode=\"numeric\"\n autoComplete=\"one-time-code\"\n maxLength={1}\n disabled={disabled}\n value={current[index]?.trim() ?? ''}\n aria-label={`第 ${index + 1} 位`}\n aria-invalid={invalid || undefined}\n onChange={(event) => {\n const char = event.target.value.slice(-1)\n commit(writeAt(current, index, char, length))\n if (char) focusBox(index + 1)\n }}\n onPaste={handlePaste(index)}\n onKeyDown={handleKeyDown(index)}\n />\n ))}\n </div>\n )\n}\n"],"mappings":";AAoFQ;AAlFR,SAAS,QAAQ,gBAAgB;AAEjC,OAAO,UAAU;AAMjB,SAAS,QAAQ,SAAiB,OAAe,MAAc,QAAwB;AACrF,QAAM,QAAQ,QAAQ,OAAO,QAAQ,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE;AACnE,QAAM,KAAK,IAAI,QAAQ;AACvB,SAAO,MAAM,KAAK,EAAE,EAAE,QAAQ,OAAO,EAAE;AACzC;AAsBO,SAAS,SAAS;AAAA,EACvB,SAAS;AAAA,EACT;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAkB;AAChB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,YAAY;AACrD,QAAM,UAAU,UAAU,SAAY,WAAW;AACjD,QAAM,OAAO,OAAoC,CAAC,CAAC;AAEnD,QAAM,SAAS,CAAC,SAAiB;AAC/B,QAAI,UAAU,OAAW,aAAY,IAAI;AACzC,oBAAgB,IAAI;AAAA,EACtB;AAEA,QAAM,WAAW,CAAC,UAAkB;AAClC,SAAK,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,MAAM;AAAA,EAChE;AAEA,QAAM,cAAc,CAAC,UAAkB,CAAC,UAAiD;AACvF,UAAM,SAAS,MAAM,cAAc,QAAQ,MAAM,EAAE,QAAQ,QAAQ,EAAE;AACrE,QAAI,CAAC,OAAQ;AACb,UAAM,eAAe;AAErB,QAAI,OAAO;AACX,UAAM,OAAO,KAAK,IAAI,OAAO,QAAQ,SAAS,KAAK;AACnD,aAAS,IAAI,GAAG,IAAI,MAAM,KAAK,GAAG;AAChC,aAAO,QAAQ,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAI,MAAM;AAAA,IACpD;AACA,WAAO,IAAI;AACX,aAAS,QAAQ,IAAI;AAAA,EACvB;AAEA,QAAM,gBAAgB,CAAC,UAAkB,CAAC,UAAgD;AACxF,QAAI,MAAM,QAAQ,eAAe,CAAC,QAAQ,KAAK,EAAG,UAAS,QAAQ,CAAC;AAAA,aAC3D,MAAM,QAAQ,YAAa,UAAS,QAAQ,CAAC;AAAA,aAC7C,MAAM,QAAQ,aAAc,UAAS,QAAQ,CAAC;AAAA,QAClD;AACL,QAAI,MAAM,QAAQ,YAAa,OAAM,eAAe;AAAA,EACtD;AAEA,SACE,oBAAC,SAAI,WAAW,KAAK,gBAAgB,SAAS,GAAG,gBAAc,WAAW,QAAY,GAAG,MACtF,gBAAM,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,UAC1B;AAAA,IAAC;AAAA;AAAA,MAEC,KAAK,CAAC,OAAO;AACX,aAAK,QAAQ,KAAK,IAAI;AAAA,MACxB;AAAA,MACA,WAAU;AAAA,MACV,WAAU;AAAA,MACV,cAAa;AAAA,MACb,WAAW;AAAA,MACX;AAAA,MACA,OAAO,QAAQ,KAAK,GAAG,KAAK,KAAK;AAAA,MACjC,cAAY,UAAK,QAAQ,CAAC;AAAA,MAC1B,gBAAc,WAAW;AAAA,MACzB,UAAU,CAAC,UAAU;AACnB,cAAM,OAAO,MAAM,OAAO,MAAM,MAAM,EAAE;AACxC,eAAO,QAAQ,SAAS,OAAO,MAAM,MAAM,CAAC;AAC5C,YAAI,KAAM,UAAS,QAAQ,CAAC;AAAA,MAC9B;AAAA,MACA,SAAS,YAAY,KAAK;AAAA,MAC1B,WAAW,cAAc,KAAK;AAAA;AAAA,IAlBzB;AAAA,EAmBP,CACD,GACH;AAEJ;","names":[]}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/NativeSelect.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type {\n NativeSelectProps,\n NativeSelectOption,\n} from '../../../../contracts/foundation/input-selection/native-select.js'\n\nexport type { NativeSelectProps, NativeSelectOption }\n\n/**\n * 平台原生 `<select>`,套用已登记的外壳样式。\n *\n * 在原生选择器优于自绘浮层时使用:选项极多、密集的行内编辑器。\n * 其余场景用 `Select`。\n *\n * 下拉面板由浏览器绘制,不受设计系统的浮层样式约束 —— 这是选用它的代价。\n */\nexport function NativeSelect({\n options,\n placeholder,\n invalid = false,\n className,\n ...rest\n}: NativeSelectProps) {\n return (\n <select\n className={clsx('mh-native-select', className)}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n >\n {placeholder && <option value=\"\">{placeholder}</option>}\n {options.map((option) => (\n <option key={option.value} value={option.value} disabled={option.disabled}>\n {option.label}\n </option>\n ))}\n </select>\n )\n}\n"],"mappings":"AAwBI,SAMkB,KANlB;AAxBJ,OAAO,UAAU;AAgBV,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,oBAAoB,SAAS;AAAA,MAC7C,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA,MAEH;AAAA,uBAAe,oBAAC,YAAO,OAAM,IAAI,uBAAY;AAAA,QAC7C,QAAQ,IAAI,CAAC,WACZ,oBAAC,YAA0B,OAAO,OAAO,OAAO,UAAU,OAAO,UAC9D,iBAAO,SADG,OAAO,KAEpB,CACD;AAAA;AAAA;AAAA,EACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/NativeSelect.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { Ref } from 'react'\nimport type {\n NativeSelectProps,\n NativeSelectOption,\n} from '../../../../contracts/foundation/input-selection/native-select.js'\n\nexport type { NativeSelectProps, NativeSelectOption }\n\n/**\n * 平台原生 `<select>`,套用已登记的外壳样式。\n *\n * 在原生选择器优于自绘浮层时使用:选项极多、密集的行内编辑器。\n * 其余场景用 `Select`。\n *\n * 下拉面板由浏览器绘制,不受设计系统的浮层样式约束 —— 这是选用它的代价。\n *\n * `ref` 落到 `<select>` 本身,理由同 `Input`(06 · P2-22)。\n */\nexport function NativeSelect({\n options,\n placeholder,\n invalid = false,\n className,\n ...rest\n}: NativeSelectProps & { ref?: Ref<HTMLSelectElement> }) {\n return (\n <select\n className={clsx('mh-native-select', className)}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n >\n {placeholder && <option value=\"\">{placeholder}</option>}\n {options.map((option) => (\n <option key={option.value} value={option.value} disabled={option.disabled}>\n {option.label}\n </option>\n ))}\n </select>\n )\n}\n"],"mappings":"AA2BI,SAMkB,KANlB;AA3BJ,OAAO,UAAU;AAmBV,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAyD;AACvD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,oBAAoB,SAAS;AAAA,MAC7C,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA,MAEH;AAAA,uBAAe,oBAAC,YAAO,OAAM,IAAI,uBAAY;AAAA,QAC7C,QAAQ,IAAI,CAAC,WACZ,oBAAC,YAA0B,OAAO,OAAO,OAAO,UAAU,OAAO,UAC9D,iBAAO,SADG,OAAO,KAEpB,CACD;AAAA;AAAA;AAAA,EACH;AAEJ;","names":[]}
@@ -10,6 +10,7 @@ function RadioGroup({
10
10
  name,
11
11
  orientation = "vertical",
12
12
  disabled = false,
13
+ invalid = false,
13
14
  className,
14
15
  ...rest
15
16
  }) {
@@ -23,6 +24,8 @@ function RadioGroup({
23
24
  role: "radiogroup",
24
25
  className: clsx("mh-radio-group", className),
25
26
  "data-orientation": orientation,
27
+ "data-invalid": invalid || void 0,
28
+ "aria-invalid": invalid || void 0,
26
29
  ...rest,
27
30
  children: items.map((item) => {
28
31
  const on = current === item.value;
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/RadioGroup.tsx"],"sourcesContent":["'use client'\n\nimport { useId, useState } from 'react'\nimport clsx from 'clsx'\nimport type {\n RadioGroupProps,\n RadioGroupItem,\n} from '../../../../contracts/foundation/input-selection/radio-group.js'\n\nexport type { RadioGroupProps, RadioGroupItem }\n\n/**\n * 在 2–5 个可见选项中互斥择一。\n *\n * 6 个及以上选项改用 `Select`;若该选择是**显示设置**而非表单数据,\n * 改用 `ToggleGroup`。\n *\n * `name` 不传时由 `useId()` 生成(04 · I7)。源实现用的是\n * `Math.random().toString(36)` —— 服务端与客户端生成的字符串不同,\n * React 会报 hydration mismatch,直接违反 01 §4.4 的 RSC 兼容要求。\n */\nexport function RadioGroup({\n items,\n value,\n defaultValue,\n onValueChange,\n name,\n orientation = 'vertical',\n disabled = false,\n className,\n ...rest\n}: RadioGroupProps) {\n const [internal, setInternal] = useState(defaultValue)\n const current = value === undefined ? internal : value\n const autoName = useId()\n const groupName = name ?? autoName\n\n return (\n <div\n role=\"radiogroup\"\n className={clsx('mh-radio-group', className)}\n data-orientation={orientation}\n {...rest}\n >\n {items.map((item) => {\n const on = current === item.value\n const off = disabled || item.disabled\n\n return (\n <label\n key={item.value}\n className=\"mh-radio-group__option\"\n data-disabled={off || undefined}\n >\n <input\n className=\"mh-radio-group__input\"\n type=\"radio\"\n name={groupName}\n value={item.value}\n checked={on}\n disabled={off}\n onChange={() => {\n if (value === undefined) setInternal(item.value)\n onValueChange?.(item.value)\n }}\n />\n <span className=\"mh-radio-group__mark\" data-state={on ? 'on' : 'off'} aria-hidden=\"true\" />\n {item.label}\n </label>\n )\n })}\n </div>\n )\n}\n"],"mappings":";AAiDU,SAKE,KALF;AA/CV,SAAS,OAAO,gBAAgB;AAChC,OAAO,UAAU;AAkBV,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,YAAY;AACrD,QAAM,UAAU,UAAU,SAAY,WAAW;AACjD,QAAM,WAAW,MAAM;AACvB,QAAM,YAAY,QAAQ;AAE1B,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,WAAW,KAAK,kBAAkB,SAAS;AAAA,MAC3C,oBAAkB;AAAA,MACjB,GAAG;AAAA,MAEH,gBAAM,IAAI,CAAC,SAAS;AACnB,cAAM,KAAK,YAAY,KAAK;AAC5B,cAAM,MAAM,YAAY,KAAK;AAE7B,eACE;AAAA,UAAC;AAAA;AAAA,YAEC,WAAU;AAAA,YACV,iBAAe,OAAO;AAAA,YAEtB;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,WAAU;AAAA,kBACV,MAAK;AAAA,kBACL,MAAM;AAAA,kBACN,OAAO,KAAK;AAAA,kBACZ,SAAS;AAAA,kBACT,UAAU;AAAA,kBACV,UAAU,MAAM;AACd,wBAAI,UAAU,OAAW,aAAY,KAAK,KAAK;AAC/C,oCAAgB,KAAK,KAAK;AAAA,kBAC5B;AAAA;AAAA,cACF;AAAA,cACA,oBAAC,UAAK,WAAU,wBAAuB,cAAY,KAAK,OAAO,OAAO,eAAY,QAAO;AAAA,cACxF,KAAK;AAAA;AAAA;AAAA,UAjBD,KAAK;AAAA,QAkBZ;AAAA,MAEJ,CAAC;AAAA;AAAA,EACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/RadioGroup.tsx"],"sourcesContent":["'use client'\n\nimport { useId, useState } from 'react'\nimport clsx from 'clsx'\nimport type {\n RadioGroupProps,\n RadioGroupItem,\n} from '../../../../contracts/foundation/input-selection/radio-group.js'\n\nexport type { RadioGroupProps, RadioGroupItem }\n\n/**\n * 在 2–5 个可见选项中互斥择一。\n *\n * 6 个及以上选项改用 `Select`;若该选择是**显示设置**而非表单数据,\n * 改用 `ToggleGroup`。\n *\n * `name` 不传时由 `useId()` 生成(04 · I7)。源实现用的是\n * `Math.random().toString(36)` —— 服务端与客户端生成的字符串不同,\n * React 会报 hydration mismatch,直接违反 01 §4.4 的 RSC 兼容要求。\n *\n * `invalid`(06 · P1-16):`aria-invalid` 落在 `role=\"radiogroup\"` 的根上 —— 失败的是\n * 「这一组没选对」,不是某一个圆点;圆点描边一律转 danger。\n */\nexport function RadioGroup({\n items,\n value,\n defaultValue,\n onValueChange,\n name,\n orientation = 'vertical',\n disabled = false,\n invalid = false,\n className,\n ...rest\n}: RadioGroupProps) {\n const [internal, setInternal] = useState(defaultValue)\n const current = value === undefined ? internal : value\n const autoName = useId()\n const groupName = name ?? autoName\n\n return (\n <div\n role=\"radiogroup\"\n className={clsx('mh-radio-group', className)}\n data-orientation={orientation}\n data-invalid={invalid || undefined}\n aria-invalid={invalid || undefined}\n {...rest}\n >\n {items.map((item) => {\n const on = current === item.value\n const off = disabled || item.disabled\n\n return (\n <label\n key={item.value}\n className=\"mh-radio-group__option\"\n data-disabled={off || undefined}\n >\n <input\n className=\"mh-radio-group__input\"\n type=\"radio\"\n name={groupName}\n value={item.value}\n checked={on}\n disabled={off}\n onChange={() => {\n if (value === undefined) setInternal(item.value)\n onValueChange?.(item.value)\n }}\n />\n <span className=\"mh-radio-group__mark\" data-state={on ? 'on' : 'off'} aria-hidden=\"true\" />\n {item.label}\n </label>\n )\n })}\n </div>\n )\n}\n"],"mappings":";AAuDU,SAKE,KALF;AArDV,SAAS,OAAO,gBAAgB;AAChC,OAAO,UAAU;AAqBV,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,YAAY;AACrD,QAAM,UAAU,UAAU,SAAY,WAAW;AACjD,QAAM,WAAW,MAAM;AACvB,QAAM,YAAY,QAAQ;AAE1B,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,WAAW,KAAK,kBAAkB,SAAS;AAAA,MAC3C,oBAAkB;AAAA,MAClB,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA,MAEH,gBAAM,IAAI,CAAC,SAAS;AACnB,cAAM,KAAK,YAAY,KAAK;AAC5B,cAAM,MAAM,YAAY,KAAK;AAE7B,eACE;AAAA,UAAC;AAAA;AAAA,YAEC,WAAU;AAAA,YACV,iBAAe,OAAO;AAAA,YAEtB;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,WAAU;AAAA,kBACV,MAAK;AAAA,kBACL,MAAM;AAAA,kBACN,OAAO,KAAK;AAAA,kBACZ,SAAS;AAAA,kBACT,UAAU;AAAA,kBACV,UAAU,MAAM;AACd,wBAAI,UAAU,OAAW,aAAY,KAAK,KAAK;AAC/C,oCAAgB,KAAK,KAAK;AAAA,kBAC5B;AAAA;AAAA,cACF;AAAA,cACA,oBAAC,UAAK,WAAU,wBAAuB,cAAY,KAAK,OAAO,OAAO,eAAY,QAAO;AAAA,cACxF,KAAK;AAAA;AAAA;AAAA,UAjBD,KAAK;AAAA,QAkBZ;AAAA,MAEJ,CAAC;AAAA;AAAA,EACH;AAEJ;","names":[]}
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useCallback, useEffect, useRef, useState } from "react";
3
+ import { useCallback, useEffect, useId, useRef, useState } from "react";
4
4
  import clsx from "clsx";
5
5
  import { Icon } from "../../../icon/Icon.js";
6
6
  import { useAnchored } from "../../../internal/use-anchored.js";
@@ -11,10 +11,14 @@ function Select({
11
11
  value,
12
12
  defaultValue,
13
13
  onValueChange,
14
- placeholder = "\u8BF7\u9009\u62E9",
14
+ placeholder = "\u672A\u9009\u62E9",
15
15
  disabled = false,
16
16
  invalid = false,
17
17
  className,
18
+ id,
19
+ "aria-label": ariaLabel,
20
+ "aria-labelledby": ariaLabelledBy,
21
+ "aria-describedby": ariaDescribedBy,
18
22
  ...rest
19
23
  }) {
20
24
  const [internal, setInternal] = useState(defaultValue);
@@ -22,6 +26,13 @@ function Select({
22
26
  const current = value === void 0 ? internal : value;
23
27
  const selected = options.find((option) => option.value === current);
24
28
  const triggerRef = useRef(null);
29
+ const baseId = useId();
30
+ const triggerId = id ?? `${baseId}-trigger`;
31
+ const valueId = `${baseId}-value`;
32
+ const listboxId = `${baseId}-listbox`;
33
+ const optionId = (index) => `${baseId}-option-${index}`;
34
+ const named = Boolean(id || ariaLabel || ariaLabelledBy);
35
+ const describedBy = [ariaDescribedBy, named ? valueId : void 0].filter(Boolean).join(" ") || void 0;
25
36
  const { refs, floatingStyles } = useAnchored({
26
37
  open,
27
38
  placement: "bottom-start",
@@ -29,7 +40,13 @@ function Select({
29
40
  matchAnchorWidth: true
30
41
  });
31
42
  const close = useCallback(() => setOpen(false), []);
32
- useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: triggerRef });
43
+ useDismiss({
44
+ open,
45
+ onDismiss: close,
46
+ floating: refs.floating,
47
+ anchor: triggerRef,
48
+ returnFocus: () => triggerRef.current
49
+ });
33
50
  const choose = useCallback(
34
51
  (index) => {
35
52
  const option = options[index];
@@ -65,10 +82,15 @@ function Select({
65
82
  refs.setReference(node);
66
83
  },
67
84
  type: "button",
85
+ id: triggerId,
68
86
  className: "mh-select__trigger",
69
87
  disabled,
88
+ "aria-label": ariaLabel,
89
+ "aria-labelledby": ariaLabelledBy,
90
+ "aria-describedby": describedBy,
70
91
  "aria-haspopup": "listbox",
71
92
  "aria-expanded": open,
93
+ "aria-controls": open ? listboxId : void 0,
72
94
  "aria-invalid": invalid || void 0,
73
95
  "data-invalid": invalid || void 0,
74
96
  "data-open": open || void 0,
@@ -81,7 +103,7 @@ function Select({
81
103
  }
82
104
  },
83
105
  children: [
84
- /* @__PURE__ */ jsx("span", { className: "mh-select__value", children: selected ? selected.label : placeholder }),
106
+ /* @__PURE__ */ jsx("span", { id: valueId, className: "mh-select__value", children: selected ? selected.label : placeholder }),
85
107
  /* @__PURE__ */ jsx(Icon, { className: "mh-select__chevron", name: "chevron-down", size: 14 })
86
108
  ]
87
109
  }
@@ -90,14 +112,18 @@ function Select({
90
112
  "div",
91
113
  {
92
114
  ref: refs.setFloating,
115
+ id: listboxId,
93
116
  className: "mh-select__listbox",
94
117
  role: "listbox",
95
118
  tabIndex: -1,
119
+ "aria-labelledby": triggerId,
120
+ "aria-activedescendant": active >= 0 ? optionId(active) : void 0,
96
121
  style: floatingStyles,
97
122
  onKeyDown,
98
123
  children: options.map((option, index) => /* @__PURE__ */ jsxs(
99
124
  "div",
100
125
  {
126
+ id: optionId(index),
101
127
  className: "mh-select__option",
102
128
  role: "option",
103
129
  "aria-selected": option.value === current,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Select.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n SelectProps,\n SelectOption,\n} from '../../../../contracts/foundation/input-selection/select.js'\n\nexport type { SelectProps, SelectOption }\n\n/**\n * 自绘单选下拉 —— 表单与筛选行中的默认选择控件。\n *\n * 选型边界:选项极多或密集的行内编辑器用 `NativeSelect`;需要输入筛选用\n * `Combobox`;2–5 个选项且需全部可见用 `RadioGroup`;显示设置用 `ToggleGroup`。\n *\n * 补齐了键盘导航与浮层外点击关闭(04 · I12),并把定位交给 floating-ui ——\n * 源实现是 `top: calc(100% + 4px)` 的绝对定位,页面底部的下拉会被视口裁掉。\n * 打开时活动项落在当前选中项上,而不是列表首项。\n */\nexport function Select({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '请选择',\n disabled = false,\n invalid = false,\n className,\n ...rest\n}: SelectProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const triggerRef = useRef<HTMLButtonElement>(null)\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => setOpen(false), [])\n useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: triggerRef })\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index]\n if (!option || option.disabled) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setOpen(false)\n triggerRef.current?.focus()\n },\n [options, value, onValueChange]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: options.length,\n isDisabled: (i) => Boolean(options[i]?.disabled),\n getText: (i) => (typeof options[i]?.label === 'string' ? (options[i]!.label as string) : ''),\n onSelect: choose,\n onDismiss: () => {\n close()\n triggerRef.current?.focus()\n },\n })\n\n // 打开时把活动项放在当前选中项上,并接管键盘。\n useEffect(() => {\n if (!open) return\n setActive(options.findIndex((option) => option.value === current))\n refs.floating.current?.focus()\n }, [open, options, current, setActive, refs.floating])\n\n return (\n <div className={clsx('mh-select', className)} {...rest}>\n <button\n ref={(node) => {\n triggerRef.current = node\n refs.setReference(node)\n }}\n type=\"button\"\n className=\"mh-select__trigger\"\n disabled={disabled}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n data-open={open || undefined}\n data-placeholder={selected ? undefined : 'true'}\n onClick={() => !disabled && setOpen(!open)}\n onKeyDown={(event) => {\n // 关闭状态下按方向键直接打开,是原生 select 的习惯。\n if (!open && (event.key === 'ArrowDown' || event.key === 'ArrowUp')) {\n setOpen(true)\n event.preventDefault()\n }\n }}\n >\n <span className=\"mh-select__value\">{selected ? selected.label : placeholder}</span>\n <Icon className=\"mh-select__chevron\" name=\"chevron-down\" size={14} />\n </button>\n\n {open && (\n <div\n ref={refs.setFloating}\n className=\"mh-select__listbox\"\n role=\"listbox\"\n tabIndex={-1}\n style={floatingStyles}\n onKeyDown={onKeyDown}\n >\n {options.map((option, index) => (\n <div\n key={option.value}\n className=\"mh-select__option\"\n role=\"option\"\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n data-disabled={option.disabled || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n <span className=\"mh-select__option-label\">{option.label}</span>\n {option.value === current && <Icon name=\"check\" size={14} />}\n </div>\n ))}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Select.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useId, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n SelectProps,\n SelectOption,\n} from '../../../../contracts/foundation/input-selection/select.js'\n\nexport type { SelectProps, SelectOption }\n\n/**\n * 自绘单选下拉 —— 表单与筛选行中的默认选择控件。\n *\n * 选型边界:选项极多或密集的行内编辑器用 `NativeSelect`;需要输入筛选用\n * `Combobox`;2–5 个选项且需全部可见用 `RadioGroup`;显示设置用 `ToggleGroup`。\n *\n * 补齐了键盘导航与浮层外点击关闭(04 · I12),并把定位交给 floating-ui ——\n * 源实现是 `top: calc(100% + 4px)` 的绝对定位,页面底部的下拉会被视口裁掉。\n * 打开时活动项落在当前选中项上,而不是列表首项。\n *\n * `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到触发按钮,其余属性\n * 仍落在根元素(05 · P3-2、06 · P3-14)。此前四者都在外层 div 上:`Field htmlFor`\n * 的 `label for` 指向一个不可标注的 div,排序控件传的 `aria-label` 读屏读不到,\n * 按钮的名称只剩当前值。按钮有名称之后,当前值另由 `aria-describedby` 指向值文本\n * 补回 —— 按钮的名称一旦来自标签,它的内容就不再进名称,不补读屏只听得到\n * 「负责人,按钮」而不知道选了谁。\n */\nexport function Select({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '未选择',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: SelectProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const triggerRef = useRef<HTMLButtonElement>(null)\n const baseId = useId()\n const triggerId = id ?? `${baseId}-trigger`\n const valueId = `${baseId}-value`\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n // 名称来自外部(标签或 aria-*)时,内容不再计入名称,当前值改由描述带出。\n const named = Boolean(id || ariaLabel || ariaLabelledBy)\n const describedBy = [ariaDescribedBy, named ? valueId : undefined].filter(Boolean).join(' ') || undefined\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => setOpen(false), [])\n // Esc 由 useDismiss 在捕获阶段截停,列表自己的 onDismiss(聚焦触发器)根本收不到;\n // 焦点归还因此必须交给 useDismiss,否则收起后焦点掉到 body(对话框里同样)。\n useDismiss({\n open,\n onDismiss: close,\n floating: refs.floating,\n anchor: triggerRef,\n returnFocus: () => triggerRef.current,\n })\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index]\n if (!option || option.disabled) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setOpen(false)\n triggerRef.current?.focus()\n },\n [options, value, onValueChange]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: options.length,\n isDisabled: (i) => Boolean(options[i]?.disabled),\n getText: (i) => (typeof options[i]?.label === 'string' ? (options[i]!.label as string) : ''),\n onSelect: choose,\n onDismiss: () => {\n close()\n triggerRef.current?.focus()\n },\n })\n\n // 打开时把活动项放在当前选中项上,并接管键盘。\n useEffect(() => {\n if (!open) return\n setActive(options.findIndex((option) => option.value === current))\n refs.floating.current?.focus()\n }, [open, options, current, setActive, refs.floating])\n\n return (\n <div className={clsx('mh-select', className)} {...rest}>\n <button\n ref={(node) => {\n triggerRef.current = node\n refs.setReference(node)\n }}\n type=\"button\"\n id={triggerId}\n className=\"mh-select__trigger\"\n disabled={disabled}\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={describedBy}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n data-open={open || undefined}\n data-placeholder={selected ? undefined : 'true'}\n onClick={() => !disabled && setOpen(!open)}\n onKeyDown={(event) => {\n // 关闭状态下按方向键直接打开,是原生 select 的习惯。\n if (!open && (event.key === 'ArrowDown' || event.key === 'ArrowUp')) {\n setOpen(true)\n event.preventDefault()\n }\n }}\n >\n <span id={valueId} className=\"mh-select__value\">\n {selected ? selected.label : placeholder}\n </span>\n <Icon className=\"mh-select__chevron\" name=\"chevron-down\" size={14} />\n </button>\n\n {open && (\n <div\n ref={refs.setFloating}\n id={listboxId}\n className=\"mh-select__listbox\"\n role=\"listbox\"\n tabIndex={-1}\n aria-labelledby={triggerId}\n // 焦点在列表本身,活动项靠它报给读屏;只有视觉标记时方向键走动是无声的。\n aria-activedescendant={active >= 0 ? optionId(active) : undefined}\n style={floatingStyles}\n onKeyDown={onKeyDown}\n >\n {options.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-select__option\"\n role=\"option\"\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n data-disabled={option.disabled || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n <span className=\"mh-select__option-label\">{option.label}</span>\n {option.value === current && <Icon name=\"check\" size={14} />}\n </div>\n ))}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
@@ -2,12 +2,14 @@
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useState } from "react";
4
4
  import clsx from "clsx";
5
+ import { Spinner } from "../feedback-overlay/Spinner.js";
5
6
  function Switch({
6
7
  checked,
7
8
  defaultChecked = false,
8
9
  onCheckedChange,
9
10
  label,
10
11
  disabled = false,
12
+ busy = false,
11
13
  type = "button",
12
14
  className,
13
15
  style,
@@ -22,6 +24,7 @@ function Switch({
22
24
  className: clsx("mh-switch", className),
23
25
  style,
24
26
  "data-disabled": disabled || void 0,
27
+ "data-busy": busy || void 0,
25
28
  children: [
26
29
  /* @__PURE__ */ jsx(
27
30
  "button",
@@ -30,15 +33,18 @@ function Switch({
30
33
  className: "mh-switch__track",
31
34
  role: "switch",
32
35
  "aria-checked": on,
36
+ "aria-busy": busy || void 0,
33
37
  disabled,
34
38
  "data-state": on ? "on" : "off",
35
39
  onClick: (event) => {
36
- if (checked === void 0) setInternal(!on);
37
- onCheckedChange?.(!on);
40
+ if (!busy) {
41
+ if (checked === void 0) setInternal(!on);
42
+ onCheckedChange?.(!on);
43
+ }
38
44
  onClick?.(event);
39
45
  },
40
46
  ...rest,
41
- children: /* @__PURE__ */ jsx("span", { className: "mh-switch__thumb" })
47
+ children: /* @__PURE__ */ jsx("span", { className: "mh-switch__thumb", children: busy && /* @__PURE__ */ jsx(Spinner, { className: "mh-switch__spinner", "aria-hidden": "true" }) })
42
48
  }
43
49
  ),
44
50
  label
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Switch.tsx"],"sourcesContent":["'use client'\n\nimport { useState } from 'react'\nimport clsx from 'clsx'\nimport type { SwitchProps } from '../../../../contracts/foundation/input-selection/switch.js'\n\nexport type { SwitchProps }\n\n/**\n * 立即生效的开关控件,36×20 轨道 + 16px 滑块。\n *\n * 用于**立即应用**的设置 —— 列可见性、通知开关、密度。\n * 等待「应用」/「提交」的表单数据请用 `Checkbox`。这是两者唯一的区分标准,\n * 与视觉偏好无关。\n *\n * ── props 分流(04 · I8)────────────────────────────────────────\n * `className` 与 `style` 作用于外层可见的 `<label>`,其余属性透传给内部\n * `<button role=\"switch\">`。源实现把 `{...rest}` 给了内部 button,\n * 调用方传的 className 落到那里,与 style 分家。\n */\nexport function Switch({\n checked,\n defaultChecked = false,\n onCheckedChange,\n label,\n disabled = false,\n type = 'button',\n className,\n style,\n onClick,\n ...rest\n}: SwitchProps) {\n const [internal, setInternal] = useState(defaultChecked)\n const on = checked === undefined ? internal : checked\n\n return (\n <label\n className={clsx('mh-switch', className)}\n style={style}\n data-disabled={disabled || undefined}\n >\n <button\n type={type}\n className=\"mh-switch__track\"\n role=\"switch\"\n aria-checked={on}\n disabled={disabled}\n data-state={on ? 'on' : 'off'}\n onClick={(event) => {\n if (checked === undefined) setInternal(!on)\n onCheckedChange?.(!on)\n onClick?.(event)\n }}\n {...rest}\n >\n <span className=\"mh-switch__thumb\" />\n </button>\n {label}\n </label>\n )\n}\n"],"mappings":";AAoCI,SAmBI,KAnBJ;AAlCJ,SAAS,gBAAgB;AACzB,OAAO,UAAU;AAiBV,SAAS,OAAO;AAAA,EACrB;AAAA,EACA,iBAAiB;AAAA,EACjB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAgB;AACd,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,cAAc;AACvD,QAAM,KAAK,YAAY,SAAY,WAAW;AAE9C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,aAAa,SAAS;AAAA,MACtC;AAAA,MACA,iBAAe,YAAY;AAAA,MAE3B;AAAA;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA,WAAU;AAAA,YACV,MAAK;AAAA,YACL,gBAAc;AAAA,YACd;AAAA,YACA,cAAY,KAAK,OAAO;AAAA,YACxB,SAAS,CAAC,UAAU;AAClB,kBAAI,YAAY,OAAW,aAAY,CAAC,EAAE;AAC1C,gCAAkB,CAAC,EAAE;AACrB,wBAAU,KAAK;AAAA,YACjB;AAAA,YACC,GAAG;AAAA,YAEJ,8BAAC,UAAK,WAAU,oBAAmB;AAAA;AAAA,QACrC;AAAA,QACC;AAAA;AAAA;AAAA,EACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Switch.tsx"],"sourcesContent":["'use client'\n\nimport { useState } from 'react'\nimport clsx from 'clsx'\nimport { Spinner } from '../feedback-overlay/Spinner.js'\nimport type { SwitchProps } from '../../../../contracts/foundation/input-selection/switch.js'\n\nexport type { SwitchProps }\n\n/**\n * 立即生效的开关控件,36×20 轨道 + 16px 滑块。\n *\n * 用于**立即应用**的设置 —— 列可见性、通知开关、密度。\n * 等待「应用」/「提交」的表单数据请用 `Checkbox`。这是两者唯一的区分标准,\n * 与视觉偏好无关。\n *\n * ── props 分流(04 · I8)────────────────────────────────────────\n * `className` 与 `style` 作用于外层可见的 `<label>`,其余属性透传给内部\n * `<button role=\"switch\">`。源实现把 `{...rest}` 给了内部 button,\n * 调用方传的 className 落到那里,与 style 分家。\n *\n * ── 落库中(06 · P3-17)────────────────────────────────────────\n * `busy` 期间不切换,但**不禁用**:`disabled` 的按钮会失去焦点,刚按下空格的键盘\n * 用户随之掉到 `body`。这里只拦截切换(原生 `onClick` 仍照常触发),按钮带\n * `aria-busy`,滑块里换上复用 `Spinner` 的进行中指示 —— 它在 `role=\"switch\"`\n * 里只是装饰(switch 的子节点不进可访问树),因此整体 `aria-hidden`。\n */\nexport function Switch({\n checked,\n defaultChecked = false,\n onCheckedChange,\n label,\n disabled = false,\n busy = false,\n type = 'button',\n className,\n style,\n onClick,\n ...rest\n}: SwitchProps) {\n const [internal, setInternal] = useState(defaultChecked)\n const on = checked === undefined ? internal : checked\n\n return (\n <label\n className={clsx('mh-switch', className)}\n style={style}\n data-disabled={disabled || undefined}\n data-busy={busy || undefined}\n >\n <button\n type={type}\n className=\"mh-switch__track\"\n role=\"switch\"\n aria-checked={on}\n aria-busy={busy || undefined}\n disabled={disabled}\n data-state={on ? 'on' : 'off'}\n onClick={(event) => {\n if (!busy) {\n if (checked === undefined) setInternal(!on)\n onCheckedChange?.(!on)\n }\n onClick?.(event)\n }}\n {...rest}\n >\n <span className=\"mh-switch__thumb\">\n {busy && <Spinner className=\"mh-switch__spinner\" aria-hidden=\"true\" />}\n </span>\n </button>\n {label}\n </label>\n )\n}\n"],"mappings":";AA4CI,SAwBe,KAxBf;AA1CJ,SAAS,gBAAgB;AACzB,OAAO,UAAU;AACjB,SAAS,eAAe;AAuBjB,SAAS,OAAO;AAAA,EACrB;AAAA,EACA,iBAAiB;AAAA,EACjB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAgB;AACd,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,cAAc;AACvD,QAAM,KAAK,YAAY,SAAY,WAAW;AAE9C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,aAAa,SAAS;AAAA,MACtC;AAAA,MACA,iBAAe,YAAY;AAAA,MAC3B,aAAW,QAAQ;AAAA,MAEnB;AAAA;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA,WAAU;AAAA,YACV,MAAK;AAAA,YACL,gBAAc;AAAA,YACd,aAAW,QAAQ;AAAA,YACnB;AAAA,YACA,cAAY,KAAK,OAAO;AAAA,YACxB,SAAS,CAAC,UAAU;AAClB,kBAAI,CAAC,MAAM;AACT,oBAAI,YAAY,OAAW,aAAY,CAAC,EAAE;AAC1C,kCAAkB,CAAC,EAAE;AAAA,cACvB;AACA,wBAAU,KAAK;AAAA,YACjB;AAAA,YACC,GAAG;AAAA,YAEJ,8BAAC,UAAK,WAAU,oBACb,kBAAQ,oBAAC,WAAQ,WAAU,sBAAqB,eAAY,QAAO,GACtE;AAAA;AAAA,QACF;AAAA,QACC;AAAA;AAAA;AAAA,EACH;AAEJ;","names":[]}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Textarea.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { TextareaProps } from '../../../../contracts/foundation/input-selection/textarea.js'\n\nexport type { TextareaProps }\n\n/**\n * 多行文本控件,用于备注、说明与事由。\n *\n * 与 `Input` 共享边框、焦点与校验失败契约。仅允许垂直方向调整尺寸 ——\n * 横向拉伸会撑破表单栅格。\n */\nexport function Textarea({\n invalid = false,\n rows = 4,\n className,\n ...rest\n}: TextareaProps) {\n return (\n <textarea\n className={clsx('mh-textarea', className)}\n rows={rows}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n />\n )\n}\n"],"mappings":"AAkBI;AAlBJ,OAAO,UAAU;AAWV,SAAS,SAAS;AAAA,EACvB,UAAU;AAAA,EACV,OAAO;AAAA,EACP;AAAA,EACA,GAAG;AACL,GAAkB;AAChB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,eAAe,SAAS;AAAA,MACxC;AAAA,MACA,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA;AAAA,EACN;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Textarea.tsx"],"sourcesContent":["import clsx from 'clsx'\nimport type { Ref } from 'react'\nimport type { TextareaProps } from '../../../../contracts/foundation/input-selection/textarea.js'\n\nexport type { TextareaProps }\n\n/**\n * 多行文本控件,用于备注、说明与事由。\n *\n * 与 `Input` 共享边框、焦点与校验失败契约。仅允许垂直方向调整尺寸 ——\n * 横向拉伸会撑破表单栅格。\n *\n * `ref` 落到 `<textarea>` 本身,理由同 `Input`(06 · P2-22)。\n */\nexport function Textarea({\n invalid = false,\n rows = 4,\n className,\n ...rest\n}: TextareaProps & { ref?: Ref<HTMLTextAreaElement> }) {\n return (\n <textarea\n className={clsx('mh-textarea', className)}\n rows={rows}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n {...rest}\n />\n )\n}\n"],"mappings":"AAqBI;AArBJ,OAAO,UAAU;AAcV,SAAS,SAAS;AAAA,EACvB,UAAU;AAAA,EACV,OAAO;AAAA,EACP;AAAA,EACA,GAAG;AACL,GAAuD;AACrD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,eAAe,SAAS;AAAA,MACxC;AAAA,MACA,gBAAc,WAAW;AAAA,MACzB,gBAAc,WAAW;AAAA,MACxB,GAAG;AAAA;AAAA,EACN;AAEJ;","names":[]}