@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,4 +1,5 @@
1
1
  import type { HTMLAttributes } from 'react'
2
+ import type { IconName } from '../../foundation/icon/icon-name.js'
2
3
 
3
4
  /** 五个已登记的全局动作 */
4
5
  export type GlobalActionKey = 'messages' | 'todos' | 'overview' | 'risk' | 'settings'
@@ -8,7 +9,10 @@ export type GlobalActionKey = 'messages' | 'todos' | 'overview' | 'risk' | 'sett
8
9
  * Standard 64px / Compact 52px。
9
10
  *
10
11
  * **左侧**:应用身份 —— logo 48×48(Compact 40×40)置于 8% 强调色瓦片上,
11
- * 名称 16/24 **700**,说明 12/16 400(Compact 可隐藏)。
12
+ * 名称 16/24 **700**,说明 12/16 400(Compact 档隐藏)。
13
+ *
14
+ * Compact 档由 `@media` 驱动(07 · C-18),与 Shell 三带 52/64/48 → 44/52/40 同一断点:
15
+ * 视口宽 ≤1180px 或高 ≤720px。调用方不必、也不得自行判定断点。
12
16
  *
13
17
  * **右侧**:**恰好这五个已登记全局动作,且顺序固定**:
14
18
  *
@@ -29,8 +33,11 @@ export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDi
29
33
  /** 应用说明,12/16 400。mock 文案登记为「应用说明信息」 */
30
34
  appDescription?: string
31
35
 
32
- /** 应用 logo mock 字形的图标名(24px) */
33
- appGlyph?: string
36
+ /**
37
+ * 应用 logo mock 字形的图标名(24px),默认 `'shield-check'`。
38
+ * 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒
39
+ */
40
+ appGlyph?: IconName
34
41
 
35
42
  /** 当前激活的全局动作面板 */
36
43
  activeAction?: GlobalActionKey
@@ -41,7 +48,13 @@ export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDi
41
48
  /** 动作点击回调。`kind` 指明该动作打开 Popover 还是 Drawer */
42
49
  onAction?: (key: GlobalActionKey, kind: 'popover' | 'drawer') => void
43
50
 
44
- /** Compact 档。隐藏应用说明,其余一律保留 */
51
+ /**
52
+ * 强制 Compact 档:隐藏应用说明,其余一律保留。
53
+ *
54
+ * @deprecated 下一个 minor 删除。Compact 档已由 `@media` 随视口自动生效(07 · C-18),
55
+ * 不再需要宿主判定断点后传入。在删除之前,传 `true` 仍强制紧凑;传 `false` 或不传
56
+ * 等价,均交给 `@media` 决定
57
+ */
45
58
  compact?: boolean
46
59
  }
47
60
 
@@ -39,7 +39,7 @@ export interface GlobalSidebarProps extends HTMLAttributes<HTMLElement> {
39
39
  /** 选中变化回调 */
40
40
  onValueChange?: (key: string) => void
41
41
 
42
- /** 栏底内容 */
42
+ /** 栏底内容。栏底入口(如「设置」)直接放 `SidebarRailButton`(07 · C-15) */
43
43
  footer?: ReactNode
44
44
  }
45
45
 
@@ -14,6 +14,13 @@ import type { HTMLAttributes, ReactNode } from 'react'
14
14
  *
15
15
  * ### ⚠ Shell 契约禁止添加未登记元素
16
16
  * 不得加搜索框、面包屑、通知铃铛、页面标题、卡片或阴影。
17
+ *
18
+ * ### 两个面板的接法(06 · P1-13)
19
+ * 回调交出被点的触发器,传给 `Popover` 的 `anchor` 即可锚定;开合由调用方受控,
20
+ * 同时回写 `appSwitchOpen` / `accountOpen`,触发器据此输出 `aria-expanded`。
21
+ * 再点触发器即收起 —— Popover 不把外部锚点上的点击当作外部点击。写法:回调里
22
+ * 记下触发器并切换开合(`setAnchor(trigger); setOpen((v) => !v)`),Popover 传
23
+ * `anchor={anchor} open={open} onOpenChange={setOpen}`。
17
24
  */
18
25
  export interface TopNavigationPrimaryBarProps extends HTMLAttributes<HTMLDivElement> {
19
26
  /** 企业名称。mock 兜底文案登记为「企业名称」 */
@@ -25,14 +32,30 @@ export interface TopNavigationPrimaryBarProps extends HTMLAttributes<HTMLDivElem
25
32
  /** 中间区域内容。默认为空 —— 加东西前请确认它是已登记元素 */
26
33
  center?: ReactNode
27
34
 
28
- /** 账户名 */
35
+ /**
36
+ * 账户名。同时是账户按钮的可访问名与头像缩写的来源;缩写规则与 `Avatar` 相同 ——
37
+ * 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
38
+ */
29
39
  accountName?: string
30
40
 
31
- /** 应用切换回调 */
32
- onAppSwitch?: () => void
41
+ /**
42
+ * 应用切换回调。参数是被点的触发器,供 `Popover` 的 `anchor` 锚定;
43
+ * 不需要锚定的调用方照旧写无参函数
44
+ */
45
+ onAppSwitch?: (trigger: HTMLButtonElement) => void
46
+
47
+ /** 账户菜单回调。参数同 `onAppSwitch` */
48
+ onAccount?: (trigger: HTMLButtonElement) => void
49
+
50
+ /**
51
+ * 应用切换面板是否展开。传入(含 `false`)即声明该触发器控制一个弹出面板:
52
+ * 输出 `aria-haspopup="dialog"` 与 `aria-expanded`。缺省时两者都不输出 ——
53
+ * 不知道面板开没开,宁可不说也不能说错。面板内容根应声明 `role="dialog"` 与可访问名
54
+ */
55
+ appSwitchOpen?: boolean
33
56
 
34
- /** 账户菜单回调 */
35
- onAccount?: () => void
57
+ /** 账户面板是否展开。语义同 `appSwitchOpen` */
58
+ accountOpen?: boolean
36
59
  }
37
60
 
38
61
  /*
@@ -28,6 +28,12 @@ export interface ApplicationDetailDrawerProps extends Omit<HTMLAttributes<HTMLDi
28
28
  /** 宽度,单位 px。推荐 680 */
29
29
  width?: number
30
30
 
31
+ /**
32
+ * 从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`,
33
+ * 免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8)
34
+ */
35
+ side?: 'left' | 'right'
36
+
31
37
  /** **唯一**的主对象动作,固定在右下角 */
32
38
  primaryAction?: ReactNode
33
39
 
@@ -7,7 +7,7 @@ import type { HTMLAttributes, ReactNode } from 'react'
7
7
  * 且**绝不超出有效视口**。
8
8
  *
9
9
  * 字段以 `Field` 子元素传入,默认排布在两列网格上;
10
- * 需要跨列的字段传 `style={{ gridColumn: '1 / -1' }}`。
10
+ * 需要跨列的字段给 `Field` 传 `span="full"`。
11
11
  *
12
12
  * ⚠ **提交失败显示为主体顶部的 `Alert`,不是 toast** ——
13
13
  * 用户必须处理的失败绝不能放进转瞬即逝的提示里。
@@ -17,7 +17,11 @@ export interface GlobalActionTab {
17
17
  * ⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**
18
18
  *
19
19
  * 宽 720px(`--ui-shell-global-action-popover-width`),20px 圆角,
20
- * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开。
20
+ * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开 ——
21
+ * 视口约束按「视口高 − 外壳总高 − 16px」计算,底边不越出视口。
22
+ *
23
+ * 非模态:不锁滚动、不陷阱焦点。**Esc 关闭**由本组件承担(进库内的 Esc 层级栈,
24
+ * 上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。外点击关闭由调用方判定。
21
25
  *
22
26
  * ⚠ **设置**打开的是 Drawer / Sheet,不走本面板;
23
27
  * 且**绝不能存在第二个设置入口**。
@@ -41,10 +45,27 @@ export interface ApplicationGlobalActionPanelProps extends Omit<HTMLAttributes<H
41
45
  /** 面板底部内容,如「全部标记为已读」 */
42
46
  footer?: ReactNode
43
47
 
44
- /** 无条目时的空态,应传 `Empty`。文案须区别于无权限与加载失败 */
48
+ /**
49
+ * 面板主体的系统状态(06 · P2-18)。`ready` 渲染 `children`,其余渲染对应槽位:
50
+ * `loading` → `loading`、`empty` → `emptyState`、`error` → `error`、
51
+ * `no-permission` → `noPermission`。缺省时保持原行为:有 `children` 渲染它,
52
+ * 否则渲染 `emptyState`
53
+ */
54
+ state?: 'ready' | 'loading' | 'empty' | 'error' | 'no-permission'
55
+
56
+ /** Loading 状态内容。应传贴近条目结构的 `Skeleton`,而非通用转圈 */
57
+ loading?: ReactNode
58
+
59
+ /** 无条目时的空态,应传 `Empty`。文案须点明当前标签的口径,区别于无权限与加载失败 */
45
60
  emptyState?: ReactNode
46
61
 
47
- /** 关闭回调 */
62
+ /** Error 状态内容。应说明失败原因并提供重试 */
63
+ error?: ReactNode
64
+
65
+ /** No Permission 状态内容。措辞必须区别于空态 */
66
+ noPermission?: ReactNode
67
+
68
+ /** 关闭回调。关闭按钮与 Esc 都会调用;外点击由调用方自行调用 */
48
69
  onClose?: () => void
49
70
 
50
71
  /** 面板内容,通常是一组 `Message` */
@@ -29,20 +29,43 @@ export interface Metric {
29
29
  icon?: ReactNode
30
30
  }
31
31
 
32
+ /** 指标区的加载状态。指标区没有 empty —— 无真实指标时整个区域不渲染 */
33
+ export type MetricStripState = 'ready' | 'loading' | 'error'
34
+
32
35
  /**
33
36
  * 指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。
34
37
  *
35
38
  * 其他语义的卡片作为 `children` 传入,由本容器统一等高排列。
39
+ *
40
+ * ⚠ 加载与失败由 `state` 表达(06 · P2-10):`loading` 渲染与卡片同壳同高的骨架,
41
+ * `error` 渲染一张横跨整行的卡片承载 `error` 节点。两者都不是「无指标」的替身 ——
42
+ * 页面没有真实指标时仍是整个区域不渲染。
36
43
  */
37
44
  export interface ApplicationMetricStripProps extends HTMLAttributes<HTMLDivElement> {
38
45
  /** 基础指标集合 */
39
46
  metrics?: Metric[]
40
47
 
41
- /** 列数。默认取指标数量,上限 6 */
48
+ /**
49
+ * 列数。默认取卡片总数 —— `metrics` 条目数加 `children` 中的卡片数
50
+ * (null / false / undefined 不计入),钳在 1–6 之间
51
+ */
42
52
  columns?: number
43
53
 
44
54
  /** 其他语义的指标卡(trend / chart / status / primary-secondary) */
45
55
  children?: ReactNode
56
+
57
+ /**
58
+ * 加载状态,默认 `ready`。`loading` 时不渲染 `metrics` 与 `children`,改渲染
59
+ * 内置骨架:张数同 `columns` 的缺省算法(无卡片时为 4),每张与指标卡同壳同高;
60
+ * `error` 时渲染一张横跨整行的卡片,内容取 `error`
61
+ */
62
+ state?: MetricStripState
63
+
64
+ /**
65
+ * `state="error"` 时的内容。应说明失败原因并提供重试(如「指标加载失败」+「重试」),
66
+ * 措辞不得与数据展示区的 Error 共用。不传时显示内置的「指标加载失败」
67
+ */
68
+ error?: ReactNode
46
69
  }
47
70
 
48
71
  /**
@@ -97,7 +120,10 @@ export interface ApplicationMetricChartProps extends HTMLAttributes<HTMLDivEleme
97
120
  value?: ReactNode
98
121
  /** 单位 */
99
122
  unit?: string
100
- /** 走势数据点 */
123
+ /**
124
+ * 走势数据点。纵轴按本组数据的 min–max 归一化(不从 0 起算),
125
+ * 只表达形状、不表达绝对量级;全部相等时画在中线
126
+ */
101
127
  data?: number[]
102
128
  /** 分类色序号,索引 `--application-categorical-01…20`。**不是状态色** */
103
129
  colorIndex?: number
@@ -6,12 +6,12 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
6
6
  * 已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、16px 圆角、32px 默认高度。
7
7
  * 16px 圆角在 32px 高度下使等宽图标按钮自然成圆,系统内**没有**独立的 pill / circle token。
8
8
  *
9
- * 应用层存在稳定语义适配器时应优先使用 `SystemButton`。
9
+ * **业务页面一律用 `SystemButton`**,本组件只供库内组件使用(实践报告 P1-1 裁决)。
10
10
  * 业务页面不得再造第二套基础按钮视觉。
11
11
  *
12
12
  * 按下态只有颜色变化 —— 不得有缩放、位移或阴影变化。
13
13
  *
14
- * @replaces button
14
+ * 原生 `<button>` 的替换目标是 `SystemButton`,替换登记写在那份契约的 JSDoc 上。
15
15
  */
16
16
  export interface ButtonProps
17
17
  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'size'> {
@@ -40,6 +40,9 @@ export interface ButtonProps
40
40
  /**
41
41
  * 禁用。禁用时不触发 onClick 并移出 tab 顺序。
42
42
  * 禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。
43
+ *
44
+ * 传 `aria-disabled="true"` 得到同一套禁用外观但保持可聚焦(`SystemButton`
45
+ * 的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。
43
46
  */
44
47
  disabled?: boolean
45
48
 
@@ -5,8 +5,8 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
5
5
  *
6
6
  * 在多个选项中择一请用 `ToggleGroup`;页面模式切换一律不用本组件。
7
7
  *
8
- * 选中态为淡强调色洗(`--application-selected`)+ 强调前景。
9
- * 纯文字内容下选中**不得仅靠颜色**表达。
8
+ * 选中态为淡强调色洗(`--application-selected`)+ 强调前景,另有 1px 前景色描边 ——
9
+ * 描边是非颜色标识,纯文字内容下选中也不只靠颜色表达,调用方无须另补。
10
10
  *
11
11
  * 通过 `aria-pressed` 上报状态。
12
12
  */
@@ -30,7 +30,7 @@ export interface ToggleProps
30
30
  */
31
31
  iconOnly?: boolean
32
32
 
33
- /** 开关内容。`iconOnly` 为 true 时放单个 `Icon`;纯文字内容下选中不得仅靠颜色表达 */
33
+ /** 开关内容。`iconOnly` 为 true 时放单个 `Icon` */
34
34
  children?: ReactNode
35
35
  }
36
36
 
@@ -3,12 +3,14 @@ import type { HTMLAttributes } from 'react'
3
3
  /**
4
4
  * 人员或组织的身份标记 —— 人员选择器、联系人列表、审计轨迹、记录负责人。
5
5
  *
6
- * 无图片时回退为文字缩写:**中文名取首字,拉丁名取首字母缩写**。
6
+ * 无图片时回退为文字缩写:**中文名取末字,拉丁名取首字母缩写**。
7
+ * 取末字(07 · C-8):「张伟」→「伟」,占位符「成员 A」→「A」—— 取首字时同姓者与
8
+ * 同一占位符前缀下的头像缩写全相同,无从区分。
7
9
  *
8
10
  * ⚠ **绝不用 Emoji 或装饰性字形代替头像。**
9
11
  */
10
12
  export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
11
- /** 姓名或组织名。用于生成回退缩写,同时作为悬浮提示 */
13
+ /** 姓名或组织名。用于生成回退缩写,同时作为头像图片的替代文本(不渲染原生悬浮提示) */
12
14
  name?: string
13
15
 
14
16
  /** 真实头像地址。存在时优先于文字缩写 */
@@ -33,4 +35,5 @@ export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
33
35
  * 而惯例应为首字母缩写 "JS"。
34
36
  * 裁决:拉丁名按空格分词取各词首字母(最多两个),中文保持取首字。
35
37
  * 契约不变,实现阶段修正。
38
+ * 后续(07 · C-8):中文分支改为取末字,见上方接口注释。
36
39
  */
@@ -7,11 +7,12 @@ import type { HTMLAttributes, ReactNode } from 'react'
7
7
  *
8
8
  * ⚠ **状态色只来自功能状态色板。** 图表分类色(20 色)绝不能用来表达状态。
9
9
  *
10
- * 一个 tone 在整个产品内只能有一个含义 —— 不要在 A 页面用 warning 表示「待整改」、
11
- * 在 B 页面用它表示「即将到期」。
10
+ * 一个 tone 在同一维度内只能有一个含义 —— 不要在 A 页面用 warning 表示「待整改」、
11
+ * 在 B 页面用它表示「即将到期」。同屏有两个状态维度(处理状态与风险等级)时,
12
+ * 用 `variant` 区分维度:一个维度 `soft`、另一个 `outline`,tone 可以跨维度复用(07 · C-9)。
12
13
  */
13
14
  export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
14
- /** 语义色调。每个 tone 在全产品内含义唯一 */
15
+ /** 语义色调。每个 tone 在同一维度内含义唯一;不同维度用 `variant` 区分 */
15
16
  tone?: 'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info'
16
17
 
17
18
  /** 视觉变体。`soft` 为淡色底,`outline` 为透明底加描边 */
@@ -4,10 +4,14 @@ import type { HTMLAttributes, ReactNode } from 'react'
4
4
  * 标准页面承载面 —— CardList 磁贴、工作台面板、图表容器、表单分节。
5
5
  *
6
6
  * 已登记契约:**只有两档密度** —— `default`(16px 节奏)与 `sm`(12px),
7
+ * `default` 的节奏随视口密度档收为 16 / 12 / 10(07 · C-17),`sm` 在 Compact 档同取 10;
7
8
  * 16px 圆角,1px 边框,**默认无装饰阴影**。不要给它加阴影。
8
9
  */
9
10
  export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
10
- /** 密度。`default` 内边距与间隙均 16px,`sm` 均 12px。没有第三档 */
11
+ /**
12
+ * 密度。`default` 内边距与间隙均 16px(Condensed 视口 12、Compact 视口 10),
13
+ * `sm` 均 12px(Compact 视口 10)。没有第三档 —— 视口档不是 prop,由 `@media` 自动生效
14
+ */
11
15
  density?: 'default' | 'sm'
12
16
 
13
17
  /** 卡片标题。16/24 medium 字重,超长省略 */
@@ -11,8 +11,10 @@ export interface ChartSeries {
11
11
  /**
12
12
  * 图表基元 —— ANALYSIS 分析页、指标卡、报表摘要。
13
13
  *
14
- * 系列配色按顺序取自共享的 20 色分类色板
14
+ * 系列配色取自共享的 20 色分类色板
15
15
  * (`--application-categorical-01…20`,`hsl(H, 24%, 53%)`,H 每 18° 一步)。
16
+ * 按系列数跳步取色:共 n 条系列时,从 01 号色起每隔 ⌊20/n⌋ 号取一色,使相邻系列的
17
+ * 色相拉开(2 条差 180°、3 条差 108°;11 条起才逐号取)。首条系列恒为 01 号色。
16
18
  * 同亮度设计使整组图表读起来是一家人。
17
19
  *
18
20
  * ⚠ **分类色只编码分类,绝不能替代功能状态色。**
@@ -20,24 +22,32 @@ export interface ChartSeries {
20
22
  *
21
23
  * ⚠ 当图表是当前的 Data Presentation 时,
22
24
  * 其设置按钮**必须**写作「图表设置」,不得写成通用的「视图设置」。
25
+ *
26
+ * 根节点渲染为 `role="figure"`,可访问名称由调用方以 `aria-label`(或
27
+ * `aria-labelledby`)给出,落在该 figure 上;绘图 svg 是 `aria-hidden` 的,
28
+ * 标签行与图例文字对读屏器保持可读。
23
29
  */
24
30
  export interface ChartProps extends HTMLAttributes<HTMLDivElement> {
25
- /** 图表类型 */
31
+ /** 图表类型。默认 `'line'` */
26
32
  type?: 'line' | 'area' | 'bar'
27
33
 
28
- /** 数据系列集合。配色按数组顺序分配 */
34
+ /** 数据系列集合。配色按数组顺序与系列总数分配(跳步规则见组件说明) */
29
35
  series: ChartSeries[]
30
36
 
31
- /** X 轴标签。见 D6 —— 当前实现按均分排布,与数据点不对齐 */
37
+ /**
38
+ * X 轴标签。见 D6 —— 折线 / 面积图按均分排布,与数据点不对齐;
39
+ * 柱状图按等宽列居中,标签数等于类目数时落在各柱组中心。
40
+ * 标签不折行,放不下时以省略号截断,完整文字见悬停提示
41
+ */
32
42
  labels?: string[]
33
43
 
34
- /** 绘图区高度,单位 px */
44
+ /** 绘图区高度,单位 px。默认 200 */
35
45
  height?: number
36
46
 
37
- /** 显示图例 */
47
+ /** 显示图例。默认 `true` */
38
48
  showLegend?: boolean
39
49
 
40
- /** 显示水平网格线 */
50
+ /** 显示水平网格线。默认 `true` */
41
51
  showGrid?: boolean
42
52
  }
43
53
 
@@ -56,6 +66,8 @@ export interface ChartProps extends HTMLAttributes<HTMLDivElement> {
56
66
  * 与任何圆角都会随容器宽高比变形。
57
67
  * 2. labels 用 justify-content: space-between 均分排布,不与数据点对齐。
58
68
  * prompt.md 的示例本身就是 3 个 label 配 6 个数据点 —— 即设计上不对齐。
69
+ * (06 · P3-20 之后柱状图改为等宽列居中,标签数等于类目数时对准柱组中心;
70
+ * 折线 / 面积图仍按本条均分。)
59
71
  *
60
72
  * 实现阶段决定:是接受这是一个「示意图基元」(保持简化,文档写明不适用于
61
73
  * 精确读数场景),还是升级为真实的图表实现。前者成本低且与 readme
@@ -3,8 +3,8 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 消息流的滚动容器。
5
5
  *
6
- * ⚠ 这是一个**有界的、正交的**滚动区域,是 Content Canvas 单一垂直滚动权的
7
- * 合法局部例外。**必须给显式高度** —— 不得在 Content Canvas 内堆叠无界的
6
+ * ⚠ 这是一个**有界的、正交的**滚动区域,是页面级纵向滚动持有者(按页型归属,06 · D-4)
7
+ * 之外的合法局部例外。**必须给显式高度** —— 不得在 Content Canvas 内堆叠无界的
8
8
  * 垂直滚动容器。
9
9
  */
10
10
  export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
@@ -12,8 +12,8 @@ export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
12
12
  height?: number | string
13
13
 
14
14
  /**
15
- * 新内容到达时自动滚到底部。
16
- * 见 D7 —— 当前实现无条件拉到底,用户翻阅历史时会被打断。
15
+ * 新内容到达时自动滚到底部 —— 仅当用户此前已贴近底部(48px 阈值内)时生效,
16
+ * 翻阅历史时不打断(D7 已在阶段 4 修正)。
17
17
  */
18
18
  stickToBottom?: boolean
19
19
 
@@ -24,7 +24,7 @@ export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
24
24
  /*
25
25
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
26
26
  *
27
- * D7 stickToBottom 无条件生效。
27
+ * D7 stickToBottom 无条件生效。—— 已修正,见上方 prop 注释(06 · P1-12)。
28
28
  * 源实现在每次 children 变化时直接 scrollTop = scrollHeight,
29
29
  * 用户正在向上翻阅历史消息时会被强制拽回底部。
30
30
  * 裁决:改为「仅当用户当前已贴近底部(阈值内)时才自动滚动」。
@@ -23,7 +23,11 @@ export interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
23
23
  /** 轨道高度,单位 px */
24
24
  height?: number
25
25
 
26
- /** 轨道上方的说明文字,12/16 label 色 */
26
+ /**
27
+ * 轨道上方的说明文字,12/16 label 色。同时是 progressbar 的可访问名称
28
+ * (以 `aria-labelledby` 关联)。不给 `label` 时应传 `aria-label`,
29
+ * 它同样落在 progressbar 上而不是根节点
30
+ */
27
31
  label?: ReactNode
28
32
  }
29
33
 
@@ -3,7 +3,13 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 带可拖拽分隔条的双栏布局,支撑 SPLIT 工作面。
5
5
  *
6
- * 默认左栏 360px,与 `--ui-sidebar-list-width` 一致。
6
+ * 默认左栏 360px,与 `--ui-sidebar-list-width` 的 Standard 档一致。
7
+ *
8
+ * 宽度类 prop 收**数字或 CSS 长度字符串**(06 · P1-20):数字按 px,字符串原样
9
+ * 交给 CSS —— 传 `'var(--ui-sidebar-list-width)'` 即跟随密度档(360 / 300),
10
+ * 也可以写 `'30%'`、`'20rem'`。**拖拽与方向键调整后回调的恒为 px 数字**,按调整
11
+ * 那一刻的渲染宽度换算;受控方把它写回 `size` 之后,该栏就不再跟随原字符串里的
12
+ * `var()` / 百分比 —— 要恢复跟随,把 `size` 写回原字符串。
7
13
  *
8
14
  * ⚠ **拖动分栏永远不改变 `pageMode`。** 它只是布局调整。
9
15
  *
@@ -17,20 +23,23 @@ export interface ResizableProps extends HTMLAttributes<HTMLDivElement> {
17
23
  /** 右栏内容,占据剩余宽度 */
18
24
  right?: ReactNode
19
25
 
20
- /** 左栏初始宽度,单位 px */
21
- defaultSize?: number
26
+ /** 左栏初始宽度。数字按 px,字符串为任意 CSS 长度。默认 360 */
27
+ defaultSize?: number | string
22
28
 
23
- /** 受控左栏宽度 */
24
- size?: number
29
+ /** 受控左栏宽度。数字按 px,字符串为任意 CSS 长度(如 `'var(--ui-sidebar-list-width)'`) */
30
+ size?: number | string
25
31
 
26
- /** 宽度变化回调。拖动过程中持续触发 */
32
+ /**
33
+ * 宽度变化回调。拖动过程中持续触发。
34
+ * **参数恒为 px 数字**(已钳在 `min`–`max` 之间),不回传字符串
35
+ */
27
36
  onSizeChange?: (size: number) => void
28
37
 
29
- /** 左栏最小宽度,单位 px */
30
- min?: number
38
+ /** 左栏最小宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 240 */
39
+ min?: number | string
31
40
 
32
- /** 左栏最大宽度,单位 px */
33
- max?: number
41
+ /** 左栏最大宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 720 */
42
+ max?: number | string
34
43
  }
35
44
 
36
45
  /*
@@ -3,7 +3,8 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 有界滚动区域,带细样式滚动条 —— 长筛选列表、宽表格、必须单行的标签条。
5
5
  *
6
- * ⚠ **Content Canvas 是页面唯一的主垂直滚动权持有者。**
6
+ * ⚠ **每个页面只有一个页面级纵向滚动持有者**:结果集页面是 `ApplicationDataDisplay`
7
+ * 的主体,其余页面是 Content Canvas(06 · D-4)。
7
8
  * 本组件只用于**正交方向**(水平)或**局部有界**的溢出。
8
9
  * 绝不堆叠无界的垂直滚动容器。
9
10
  */
@@ -17,7 +17,7 @@ export interface SeparatorProps extends HTMLAttributes<HTMLDivElement> {
17
17
  /** 居中标签。提供时线被文字断开,用于长列表的分段标题 */
18
18
  label?: ReactNode
19
19
 
20
- /** 分隔线两侧的外边距。应传 token,如 `var(--ds-space-2)` */
20
+ /** 分隔线两侧的外边距。应传 token,如 `var(--application-space-2)` */
21
21
  spacing?: string | number
22
22
  }
23
23
 
@@ -61,7 +61,7 @@ export interface TableProps<R = unknown> extends HTMLAttributes<HTMLDivElement>
61
61
  /** 选中集合变化回调。表头全选框会一次性给出全部或空数组 */
62
62
  onSelectedChange?: (ids: string[]) => void
63
63
 
64
- /** 行点击回调。设置后整行 `cursor: pointer` */
64
+ /** 行点击回调。设置后整行 `cursor: pointer`、可聚焦,Enter / 空格同样触发 */
65
65
  onRowClick?: (row: R) => void
66
66
 
67
67
  /** 受控排序状态 */
@@ -1,11 +1,12 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
3
  /**
4
- * 单个显隐区域,由一个触发器控制 —— 查询工具栏里的「更多筛选」模式。
4
+ * 单个显隐区域,由一个触发器控制 —— 详情页的次要分节、表单里的高级选项。
5
5
  *
6
- * ⚠ **折叠只改变入口,绝不移除能力。** 被收起的筛选项仍然存在、仍可使用。
6
+ * ⚠ **折叠只改变入口,绝不移除能力。** 被收起的内容仍然存在、仍可使用。
7
7
  *
8
- * 「更多筛选」通过「应用」提交,生效的条件须回写到筛选标签行。
8
+ * ⚠ 查询工具栏的「更多筛选」**不用本组件**,一律用 `Popover`:就地展开会把工具栏
9
+ * 撑高(实测 99px → 452px),SPLIT 页的两栏随之被压扁(06 · D-4)。
9
10
  *
10
11
  * 多个并列的折叠区请用 `Accordion`。
11
12
  *
@@ -13,7 +14,7 @@ import type { HTMLAttributes, ReactNode } from 'react'
13
14
  * @replaces summary
14
15
  */
15
16
  export interface CollapsibleProps extends HTMLAttributes<HTMLDivElement> {
16
- /** 触发器文字,如「更多筛选」 */
17
+ /** 触发器文字,如「版本记录」 */
17
18
  label?: ReactNode
18
19
 
19
20
  /** 非受控初始展开状态 */
@@ -1,4 +1,4 @@
1
- import type { HTMLAttributes, ReactNode } from 'react'
1
+ import type { HTMLAttributes, ReactNode, RefObject } from 'react'
2
2
 
3
3
  /**
4
4
  * 模态容器,用于用户必须完成或放弃的聚焦任务 —— 新建、编辑、导入映射。
@@ -35,6 +35,13 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
35
35
  /** 关闭回调。点击遮罩与关闭按钮都会触发 */
36
36
  onClose?: () => void
37
37
 
38
+ /**
39
+ * 打开时的初始焦点(06 · P3-1)。缺省时落在面板内首个可聚焦元素 —— 标题栏的
40
+ * 关闭按钮。键盘优先的内容(首个输入框、搜索框)应把它的 ref 传进来。
41
+ * 目标须在本组件内;关闭后焦点照常回到打开前的元素
42
+ */
43
+ initialFocus?: RefObject<HTMLElement | null>
44
+
38
45
  /** 主体内容。超长时本区域内部滚动,标题与页脚保持固定 */
39
46
  children?: ReactNode
40
47
  }
@@ -23,7 +23,7 @@ export interface DrawerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
23
23
  /** 宽度,单位 px。推荐 680 */
24
24
  width?: number
25
25
 
26
- /** 停靠侧。见 F2 —— 当前实现下 `left` 不生效 */
26
+ /** 停靠侧,默认 `right`。两侧均生效(F2 已在阶段 4 修正) */
27
27
  side?: 'right' | 'left'
28
28
 
29
29
  /** 底部动作区,右对齐且固定 */
@@ -39,7 +39,7 @@ export interface DrawerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
39
39
  /*
40
40
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
41
41
  *
42
- * F2 ★ bug:side="left" 完全不生效。
42
+ * F2 ★ bug:side="left" 完全不生效。—— 已修正:Overlay 基座按 side 分流落位,两侧实测生效(06 · P1-12)。
43
43
  * 源实现给 Scrim 传的是硬编码的 align="end",
44
44
  * 而 Scrim 的 justifyContent 是 align === 'end' ? 'flex-end' : 'center',
45
45
  * 因此抽屉永远靠右。side 只影响 borderLeft 那一条边框。
@@ -27,6 +27,10 @@ export interface DropdownMenuItem {
27
27
  *
28
28
  * ⚠ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见 ——
29
29
  * 这是 Shell 契约的硬性要求,不是布局偏好。
30
+ *
31
+ * 键盘打开(Enter / 空格 / ↓)高亮首个可用项,↑ 高亮末项,鼠标打开不预先高亮;
32
+ * Tab 收起菜单。Esc 关闭或选中后焦点回到 `trigger` —— 选中时先归还焦点再调
33
+ * `onSelect`,在 `onSelect` 里打开的 `AlertDialog` 关闭后焦点因此回到触发器。
30
34
  */
31
35
  export interface DropdownMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
32
36
  /** 触发元素。通常是一个「更多」Button */
@@ -54,5 +58,5 @@ export interface DropdownMenuProps extends Omit<HTMLAttributes<HTMLDivElement>,
54
58
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
55
59
  * S1 使用越层 token --application-divider
56
60
  * F1 trigger 用 cloneElement 注入 aria 属性(第 4 处 cloneElement)
57
- * I12 无键盘导航。外部点击关闭已实现,是本族少数做对的
61
+ * I12 ✅ 已补键盘导航与关闭后的焦点归还。外部点击关闭源实现即已做对
58
62
  */
@@ -32,4 +32,5 @@ export interface HoverCardProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'c
32
32
  * 实现只绑定 mouseEnter / mouseLeave,无 focus 支持。契约本身已声明
33
33
  * 「悬停对键盘用户不可用、信息必须另有入口」,故不算契约违背;
34
34
  * 但实现阶段仍建议补 focus 触发,让键盘用户至少能看到预览。
35
+ * 已补(06 · P3-5):聚焦打开、失焦关闭、Esc 关闭,契约不变。
35
36
  */