@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
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # @moheng-design/ui
2
2
 
3
- 陌衡企信设计系统的 React 组件库。91 个组件,纯 CSS 样式,不依赖 Tailwind。
3
+ 陌衡企信设计系统的 React 组件库。92 个组件,纯 CSS 样式,不依赖 Tailwind。
4
4
 
5
- **当前是 `0.0.0`,91 个组件已全部实现。** 阶段 5 的 Skill 生成器与两个 lint 插件已落地,
5
+ **当前是 `0.0.0`,92 个组件已全部实现。** 阶段 5 的 Skill 生成器与两个 lint 插件已落地,
6
6
  见 [`@moheng-design/ui-skill`](../ui-skill/README.md) 与 [docs/01-实施规范.md](../../docs/01-实施规范.md) §6、§7。
7
7
  本包是那一侧的唯一上游:契约与 `mappings.json` 一改,`pnpm generate` 即重出规则数据。
8
8
 
@@ -10,10 +10,10 @@
10
10
 
11
11
  | 路径 | 内容 | 阶段 |
12
12
  |---|---|---|
13
- | `contracts/` | 91 个组件的 props 契约,带 prop 级 JSDoc | 1 ✅ |
14
- | `src/components/` | 91 个组件的实现,组件与其 CSS 同名同目录 | 4 ✅ |
13
+ | `contracts/` | 92 个组件的 props 契约,带 prop 级 JSDoc | 1 ✅ |
14
+ | `src/components/` | 92 个组件的实现,组件与其 CSS 同名同目录 | 4 ✅ |
15
15
  | `src/internal/` | 库内共享基元(Overlay 基座、浮层 hooks、菜单样式),不进公共入口 | 4 ✅ |
16
- | `src/icon/` | 字形清单 `registry.json` 与生成的 `glyphs.ts` | 4 ✅ |
16
+ | `src/icon/` | 字形清单 `registry.json` 与生成的 `glyphs.ts`(另生成 `contracts/foundation/icon/icon-name.ts` 的 `IconName`) | 4 ✅ |
17
17
  | `src/tokens/` | 设计令牌源(CSS),见目录内 [README](src/tokens/README.md) | 2 ✅ |
18
18
  | `tokens.json` | DTCG 导出产物,由 CSS 生成 | 2 ✅ |
19
19
  | `src/styles/` | `@layer` 顺序声明与全局 keyframes | 4 ✅ |
@@ -47,7 +47,7 @@ pnpm --filter @moheng-design/ui check:tokens # 校验产物与源一致,CI
47
47
 
48
48
  主题色与状态色刻意解耦:换主题永远不改变「危险」长什么样。
49
49
 
50
- ### ⚠️ 主题必须挂在 `<html>` 上,挂 `<body>` 或容器 div 无效
50
+ ### ⚠️ 主题必须挂在 `<html>` 上,挂 `<body>` 或容器 div 半生效
51
51
 
52
52
  `--application-*` 别名层整层声明在 `:root` 上。CSS 自定义属性的 `var()` 代换发生在
53
53
  **声明所在的元素**,因此 `--application-accent: var(--ds-color-theme-primary)`
@@ -59,13 +59,16 @@ pnpm --filter @moheng-design/ui check:tokens # 校验产物与源一致,CI
59
59
  <html style="--ds-color-theme-primary:#7b3fe4"> <!-- ✅ 生效 -->
60
60
  <html class="dark"> <!-- ✅ 生效 -->
61
61
 
62
- <body style="--ds-color-theme-primary:#7b3fe4"> <!-- ❌ 无效 -->
63
- <body class="dark"> <!-- ❌ 无效 -->
64
- <div class="dark">局部暗色</div> <!-- ❌ 无效 -->
62
+ <body style="--ds-color-theme-primary:#7b3fe4"> <!-- ❌ 半生效 -->
63
+ <body class="dark"> <!-- ❌ 半生效 -->
64
+ <div class="dark">局部暗色</div> <!-- ❌ 半生效 -->
65
65
  ```
66
66
 
67
67
  已实测确认(1920×1080 / 1400×900 / 1024×576 三档下均如此):`.dark` 加在 `<body>` 上时,
68
- `--application-surface` 仍为 `#ffffff`,暗色完全不生效。
68
+ `--application-surface` 仍为 `#ffffff`。但这不是「完全不生效」:`.dark` 在 `<body>` 上重新声明的
69
+ `--ds-*` 原语照常下传,直接读 `--ds-*` 的 Foundation 部件跟着变暗,读 `--application-*` 的
70
+ Application 部件与应用代码不变(06 · P2-17)。**半生效比无效更糟** —— 一半变了,看上去像是
71
+ 生效了,问题因此更难察觉。
69
72
 
70
73
  **因此本库不支持局部换肤与局部暗色区块。** 需要时须由消费方在该子树内重新声明整个
71
74
  `--application-*` 别名层,本库不提供这种用法。
@@ -4,8 +4,9 @@ import type { HTMLAttributes } from 'react'
4
4
  * 列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。
5
5
  * 数据展示区的标准页脚,LIST 页面模式的默认配置。
6
6
  *
7
- * ⚠ **分页语义必须跨 Page Mode 与 Business View 切换存活**,
8
- * 从详情返回时也必须还原 —— 规范要求恢复来源上下文。
7
+ * ⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,
8
+ * 切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。
9
+ * 搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。
9
10
  *
10
11
  * 没有总数与每页条数需求时,用 Foundation `Pagination`。
11
12
  */
@@ -9,25 +9,41 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
9
9
  * ⚠ **页面不得自建平台级或业务级的按钮变体。** 改一次应用强调色,
10
10
  * 全部 SystemButton 同时换肤 —— 逐页 fork 会摧毁这个性质。
11
11
  *
12
- * 只有在没有稳定应用语义可用时才降级到 Foundation `Button`。
12
+ * **业务页面的按钮一律用本组件**,Foundation `Button` 只供库内组件使用
13
+ * (实践报告 P1-1 裁决)。
14
+ *
15
+ * @replaces button
13
16
  */
14
17
  export interface SystemButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
15
18
  /**
16
- * 应用意图。映射到 Foundation Button 的 variant:
17
- * `quiet` → ghost,`icon` → ghost + 等宽,其余同名。
19
+ * 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。
20
+ */
21
+ intent?: 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive'
22
+
23
+ /**
24
+ * 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。
25
+ * `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作
26
+ * (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。
18
27
  */
19
- intent?: 'primary' | 'secondary' | 'quiet' | 'icon' | 'link' | 'destructive'
28
+ size?: 'default' | 'compact' | 'sm'
20
29
 
21
- /** 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异 */
22
- size?: 'default' | 'compact' | 'icon'
30
+ /**
31
+ * 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation
32
+ * `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。
33
+ */
34
+ iconOnly?: boolean
23
35
 
24
36
  /**
25
- * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈。
26
- * 与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
37
+ * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈
38
+ * 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
39
+ *
40
+ * 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中
41
+ * `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦,
42
+ * 焦点不会在点击后掉到 `<body>`。
27
43
  */
28
44
  loading?: boolean
29
45
 
30
- /** 纯图标按钮(`intent="icon"` 或 `size="icon"`)**必须**提供 `aria-label` */
46
+ /** 按钮内容。`iconOnly` 时为单个 `Icon` 元素 */
31
47
  children?: ReactNode
32
48
  }
33
49
 
@@ -51,8 +67,10 @@ export interface SystemButtonProps extends ButtonHTMLAttributes<HTMLButtonElemen
51
67
  * T3 内联注入 @keyframes(loading 转圈),与 D9 / F14 同型,这是第 3 处。
52
68
  *
53
69
  * ── 连锁影响 ──
54
- * A1 采纳后 Foundation Button 的 size 拆为 size + iconOnly,
55
- * 本组件的 intent/size → Button props 映射需同步改写。
70
+ * A1 采纳后 Foundation Button 的 size 拆为 size + iconOnly。本组件原有的
71
+ * `intent="icon"` 与 `size="icon"` 正是反例「发明不存在的 prop」点名的 shadcn 写法,
72
+ * 业务页面一律改用本组件后两层的图标按钮写法不能再互相否定 —— 已移除两者,
73
+ * 改为与 Button 同名同义的 `iconOnly`(实践报告 P1-1)。
56
74
  *
57
75
  * ── 正面记录 ──
58
76
  * 本组件是迄今**唯一正确复用了 Foundation 组件**的适配器
@@ -1,5 +1,6 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
  import type { SplitSidebarItem } from '../content/application-split-list-sidebar.js'
3
+ import type { DataDisplayState } from '../content/application-data-display.js'
3
4
 
4
5
  /** 工作台中的人员条目 */
5
6
  export interface WorkspacePerson {
@@ -20,6 +21,10 @@ export interface WorkspacePerson {
20
21
  * 不要在每个页面重新搭一遍三栏布局。
21
22
  *
22
23
  * 详情栏应传 `ApplicationRecordDetailBody`,与其他详情载体保持同一份主体。
24
+ *
25
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
26
+ * 非 `ready` 时对应槽位顶替成员栏与详情栏两栏,组织树定位器保留 —— 某个机构
27
+ * 加载失败、无权限或已撤销时,读者仍要能换一个机构。六种状态各写各的措辞。
23
28
  */
24
29
  export interface ContactsCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
25
30
  /** 机构搜索,应传 `SearchField` */
@@ -43,8 +48,41 @@ export interface ContactsCollaborationWorkspaceProps extends HTMLAttributes<HTML
43
48
  /** 成员变化回调 */
44
49
  onPersonChange?: (id: string) => void
45
50
 
46
- /** 成员详情,应传 `ApplicationRecordDetailBody` */
51
+ /** 成员详情,应传 `ApplicationRecordDetailBody`。未选中成员时**不传**,详情栏显示 `detailEmpty` */
47
52
  detail?: ReactNode
53
+
54
+ /**
55
+ * `ready` 且当前机构下没有成员时成员栏的内容。
56
+ * 缺省为内置的 `Empty`「此机构下无成员」;需要附带动作时覆盖
57
+ */
58
+ peopleEmpty?: ReactNode
59
+
60
+ /**
61
+ * 未传 `detail` 时详情栏的内容。缺省为内置的 `Empty`「未选择成员」。
62
+ * 不得为了填满详情栏而自动选中第一个成员
63
+ */
64
+ detailEmpty?: ReactNode
65
+
66
+ /**
67
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染成员栏与详情栏,
68
+ * 其余状态渲染对应槽位,顶替成员栏与详情栏两栏;组织树始终保留
69
+ */
70
+ state?: DataDisplayState
71
+
72
+ /** Loading 状态内容。应传贴近「成员列表 · 详情」两栏结构的 `Skeleton` */
73
+ loading?: ReactNode
74
+
75
+ /** Empty 状态内容(整个工作台无数据)。应传 `Empty`,文案须点明当前口径 */
76
+ empty?: ReactNode
77
+
78
+ /** Error 状态内容。应说明失败原因并提供重试 */
79
+ error?: ReactNode
80
+
81
+ /** No Permission 状态内容。措辞必须区别于 Empty */
82
+ noPermission?: ReactNode
83
+
84
+ /** Not Found 状态内容(如机构不存在或已撤销)。措辞必须区别于 Empty 与 No Permission */
85
+ notFound?: ReactNode
48
86
  }
49
87
 
50
88
  /*
@@ -1,5 +1,6 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
  import type { SplitSidebarItem } from '../content/application-split-list-sidebar.js'
3
+ import type { DataDisplayState } from '../content/application-data-display.js'
3
4
 
4
5
  /** 工作台中的文件条目 */
5
6
  export interface WorkspaceFile {
@@ -22,6 +23,10 @@ export interface WorkspaceFile {
22
23
  *
23
24
  * ⚠ **没有选中项时省略 `preview`**,而不是显示一条空的预览栏 ——
24
25
  * 与「无真实指标时不渲染指标区」同一条原则。
26
+ *
27
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
28
+ * 非 `ready` 时对应槽位顶替文件表,预览栏不渲染;文件夹定位器与工具栏保留 ——
29
+ * 换个文件夹、在空目录里上传,都不该被状态挡住。
25
30
  */
26
31
  export interface FilesCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
27
32
  /** 文件搜索,应传 `SearchField` */
@@ -54,8 +59,29 @@ export interface FilesCollaborationWorkspaceProps extends HTMLAttributes<HTMLDiv
54
59
  /** 预览栏。**无选中项时不要传** */
55
60
  preview?: ReactNode
56
61
 
57
- /** 空态,应传 `Empty`。文案须点明是「此目录下」 */
62
+ /**
63
+ * 空态,应传 `Empty`。文案须点明是「此目录下」。
64
+ * `ready` 且 `files` 为空时由文件表显示,`state="empty"` 时顶替文件表显示
65
+ */
58
66
  empty?: ReactNode
67
+
68
+ /**
69
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染文件表与预览栏,
70
+ * 其余状态渲染对应槽位,顶替文件表;文件夹树与工具栏始终保留
71
+ */
72
+ state?: DataDisplayState
73
+
74
+ /** Loading 状态内容。应传贴近文件表结构的 `Skeleton` */
75
+ loading?: ReactNode
76
+
77
+ /** Error 状态内容。应说明失败原因并提供重试 */
78
+ error?: ReactNode
79
+
80
+ /** No Permission 状态内容。措辞必须区别于 Empty */
81
+ noPermission?: ReactNode
82
+
83
+ /** Not Found 状态内容(如文件夹不存在或已删除)。措辞必须区别于 Empty 与 No Permission */
84
+ notFound?: ReactNode
59
85
  }
60
86
 
61
87
  /*
@@ -1,4 +1,5 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
+ import type { DataDisplayState } from '../content/application-data-display.js'
2
3
 
3
4
  /** 日程事件 */
4
5
  export interface ScheduleEvent {
@@ -22,11 +23,25 @@ export type ScheduleGrain = 'day' | 'week' | 'month'
22
23
  *
23
24
  * ⚠ 选择日历型承载面之前,**必须先命名日期字段与真实的观察粒度** ——
24
25
  * `CALENDAR` 页面模式两者都要求。
26
+ *
27
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
28
+ * 非 `ready` 时对应槽位顶替月格,议程栏不渲染;标题行(粒度切换、工具栏)保留 ——
29
+ * 某个月加载失败时读者仍要能翻到别的月份。
25
30
  */
26
31
  export interface ScheduleCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
27
32
  /** 当前显示的月份 */
28
33
  month?: Date
29
34
 
35
+ /**
36
+ * 翻页回调,回传目标月份的 1 日。**提供时工作台内置「上一页 · 今天 · 下一页」三个控件**,
37
+ * 不提供时不渲染(翻页由调用方自理,保持旧行为)。
38
+ *
39
+ * 翻页按粒度走:月档翻一个月;周档、日档把焦点日前后移 7 天 / 1 天,经 `onSelectDate`
40
+ * 回传新的焦点日,跨月时同时回调本函数。周档、日档未提供 `onSelectDate` 时按月翻。
41
+ * 「今天」回调今天所在月份,并经 `onSelectDate` 选中今天
42
+ */
43
+ onMonthChange?: (month: Date) => void
44
+
30
45
  /** 事件集合 */
31
46
  events?: ScheduleEvent[]
32
47
 
@@ -44,6 +59,33 @@ export interface ScheduleCollaborationWorkspaceProps extends HTMLAttributes<HTML
44
59
 
45
60
  /** 工具栏内容 */
46
61
  toolbar?: ReactNode
62
+
63
+ /**
64
+ * 选中日期当天没有事件时议程栏的内容。缺省为内置的 `Empty`「当日无日程」;
65
+ * 需要附带「新建」之类的动作时覆盖
66
+ */
67
+ agendaEmpty?: ReactNode
68
+
69
+ /**
70
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染月格与议程栏,
71
+ * 其余状态渲染对应槽位,顶替月格;标题行始终保留
72
+ */
73
+ state?: DataDisplayState
74
+
75
+ /** Loading 状态内容。应传贴近月格结构的 `Skeleton` */
76
+ loading?: ReactNode
77
+
78
+ /** Empty 状态内容。应传 `Empty`,文案须点明当前口径(如「本月」) */
79
+ empty?: ReactNode
80
+
81
+ /** Error 状态内容。应说明失败原因并提供重试 */
82
+ error?: ReactNode
83
+
84
+ /** No Permission 状态内容。措辞必须区别于 Empty */
85
+ noPermission?: ReactNode
86
+
87
+ /** Not Found 状态内容(如日历不存在或已删除)。措辞必须区别于 Empty 与 No Permission */
88
+ notFound?: ReactNode
47
89
  }
48
90
 
49
91
  /*
@@ -1,4 +1,4 @@
1
- import type { HTMLAttributes, ReactNode } from 'react'
1
+ import type { HTMLAttributes, ReactNode, Ref } from 'react'
2
2
  import type { DataPresentation } from './application-query-toolbar.js'
3
3
 
4
4
  /** 数据展示区的系统状态 */
@@ -24,6 +24,7 @@ export type DataDisplayState =
24
24
  * ⚠ **六种状态各有各的节点与各自的措辞。**
25
25
  * Loading / Empty / Error / No Permission / Not Found 绝不共用文案 ——
26
26
  * 「当前口径下无数据」「你没有权限」「未找到」「请求失败」是四句不同的话。
27
+ * 第六种 Partial Failure 不替换呈现,而是在 ready 态经 `notice` 叠一条 `Alert`。
27
28
  */
28
29
  export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement> {
29
30
  /** 当前呈现方式。应与 `ApplicationQueryToolbar` 的取值保持一致 */
@@ -35,6 +36,15 @@ export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement>
35
36
  /** 批量动作条,应传 `ListBatchActionBar`。有记录被选中时才出现 */
36
37
  batchBar?: ReactNode
37
38
 
39
+ /**
40
+ * 区域级提示,承载 **Partial Failure**(05 · P2-2):应传 `Alert`,说明哪部分没取到并给出重试。
41
+ *
42
+ * 固定在批量条之下、呈现之上,**不随内容滚动**;**只在 `state="ready"` 时渲染** ——
43
+ * 其余五种状态整块换成对应槽位,部分失败无从谈起。此前没有这个位置,调用方只能把
44
+ * Alert 塞进 `children` 顶部,与呈现组件同处滚动区,滚走后读者就看不到哪些字段缺失。
45
+ */
46
+ notice?: ReactNode
47
+
38
48
  /** 分页,应传 `ListTablePagination`。固定在区域底部 */
39
49
  pagination?: ReactNode
40
50
 
@@ -55,6 +65,18 @@ export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement>
55
65
 
56
66
  /** `state="ready"` 时渲染的呈现组件 */
57
67
  children?: ReactNode
68
+
69
+ /**
70
+ * 主体滚动容器的 ref —— 批量条与分页之间、自身滚动的那一层(06 · P2-4)。
71
+ *
72
+ * 供「从详情返回列表时还原滚动位置」:离开前读它的 `scrollTop` 存进跨路由存活的
73
+ * 状态,回来后在 `state` 首次变为 `ready` 时写回。主体容器跨状态切换不重建,
74
+ * 同一个 ref 在 loading → ready 之间一直指向同一个元素。
75
+ *
76
+ * 走具名 prop 而不是 `ref`:`ref` 在 React 18 不交给函数组件,且根元素也不是
77
+ * 滚动的那一层;具名 prop 在 18 与 19 下行为一致。
78
+ */
79
+ bodyRef?: Ref<HTMLDivElement>
58
80
  }
59
81
 
60
82
  /*
@@ -23,8 +23,8 @@ export interface FilterGroup {
23
23
  /**
24
24
  * 完整的筛选维度列表 —— **「更多筛选」的面板主体**。
25
25
  *
26
- * ⚠ **必须包含搜索**,外加每一个可筛选维度 ——
27
- * 「更多筛选」是筛选能力的全集入口,不是常用筛选的补充。
26
+ * ⚠ **必须包含搜索**,外加常用筛选之外的每一个可筛选维度 ——
27
+ * 常用筛选里出现的维度不再进「更多筛选」,同一维度只有一个入口(07 · C-11)。
28
28
  *
29
29
  * ⚠ **它持有草稿:在点「应用」之前,任何改动都不生效。**
30
30
  *
@@ -34,7 +34,7 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
34
34
  /** 数据状态。决定状态文案与刷新按钮的可用性 */
35
35
  dataStatus?: 'normal' | 'refreshing' | 'failed'
36
36
 
37
- /** 最后更新时刻,仅在 `normal` 状态显示为「更新于 …」 */
37
+ /** 最后更新时刻,只写 `HH:mm`(如 `09:12`,07 · C-12)。仅在 `normal` 状态显示为「更新于 09:12」 */
38
38
  updatedAt?: string
39
39
 
40
40
  /** 刷新回调。`refreshing` 状态下按钮禁用 */
@@ -15,8 +15,22 @@ import type { HTMLAttributes, ReactNode } from 'react'
15
15
  * **不要在它外面再包一层自己的 padding。**
16
16
  *
17
17
  * ⚠ 页面没有真实指标时传 `metrics={undefined}`,**绝不用占位卡凑数**。
18
+ *
19
+ * `pageType` 必填:五层 Canvas 模型的 L1 只有本组件这一个承载者,
20
+ * 不传即结构不完整(实践报告 P1-2)。
18
21
  */
19
22
  export interface ApplicationPageLayoutContainerProps extends HTMLAttributes<HTMLDivElement> {
23
+ /**
24
+ * L1 页面类型。输出为根节点的 `data-page-type`,不改变区域顺序与留白。
25
+ *
26
+ * 唯一受它影响的是纵向尺寸:`DETAIL` 页的容器随内容增高、由 Content Canvas
27
+ * 滚动;其余页型的容器可收缩到 Canvas 高度,数据展示区拿到剩余高度后
28
+ * 由 `ApplicationDataDisplay` 内部滚动。
29
+ *
30
+ * `DETAIL` 页的内容结构用 `ApplicationRecordDetailBody`,仍以本组件为内容根。
31
+ */
32
+ pageType: 'WORKBENCH' | 'MANAGEMENT' | 'LEDGER' | 'ANALYSIS' | 'REPORT' | 'DETAIL'
33
+
20
34
  /** 上下文区,应传 `ApplicationPageHeader` */
21
35
  header?: ReactNode
22
36
 
@@ -1,4 +1,4 @@
1
- import type { ChangeEvent, HTMLAttributes, ReactNode } from 'react'
1
+ import type { ChangeEvent, HTMLAttributes, MouseEvent, ReactNode } from 'react'
2
2
 
3
3
  /** L3 业务视图标签 */
4
4
  export interface BusinessViewTab {
@@ -20,9 +20,16 @@ export interface AppliedFilterTag {
20
20
  labelText?: string
21
21
  }
22
22
 
23
- /** L5 数据呈现方式 */
23
+ /**
24
+ * L5 数据呈现方式。
25
+ *
26
+ * `RecordList` 是结构化列表(`ApplicationRecordList`),06 · D-2 裁决补入:此前 LIST 页用
27
+ * RecordList 只能谎报为 `DataTable`。`KanbanBoard` / `Calendar` / `Timeline` 暂无专属组件,
28
+ * 按 canvas-model「呈现配方」一节的标准拼装写法承载。
29
+ */
24
30
  export type DataPresentation =
25
31
  | 'DataTable'
32
+ | 'RecordList'
26
33
  | 'CardList'
27
34
  | 'KanbanBoard'
28
35
  | 'Calendar'
@@ -48,10 +55,11 @@ export type DataPresentation =
48
55
  * 由「应用」提交,并**回写到第三行的标签**。
49
56
  *
50
57
  * ### ⚠ 呈现设置按钮必须按当前呈现方式命名
51
- * DataTable → 列设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
58
+ * DataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
52
59
  * Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。
53
60
  * **通用的「视图设置」被明令禁止。**
54
- * 无真实可配置项时(`hasPresentationSettings={false}`)按钮不渲染且不占位。
61
+ * 无真实可配置项时(`hasPresentationSettings={false}`,或不传
62
+ * `onPresentationSettings`)按钮不渲染且不占位。
55
63
  * 每种呈现方式**各自独立存储**其设置。
56
64
  *
57
65
  * ### ⚠ Page Mode Switch 不属于本组件
@@ -80,16 +88,31 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
80
88
  /** 搜索提交回调。**仅 Enter 触发** */
81
89
  onSearchSubmit?: (value: string) => void
82
90
 
83
- /** 搜索占位文字。应写明搜索范围 */
91
+ /**
92
+ * 搜索占位文字。应写明搜索范围,如「搜索任务名称或编号」。
93
+ *
94
+ * **无默认值**(05 · P1-7):此前缺省为 `'搜索'`,不传即违反 SearchField
95
+ * 「不得写成不含范围的『搜索』」,且同时充当可访问名。缺省时占位文字取
96
+ * `searchAriaLabel`,二者都缺省则不显示占位文字。
97
+ */
84
98
  searchPlaceholder?: string
85
99
 
100
+ /**
101
+ * 搜索框的可访问名,必须写明搜索范围。优先级:本 prop → `searchPlaceholder`。
102
+ *
103
+ * 占位文字写示例、可访问名写范围时分开传;二者同文时只传 `searchPlaceholder`
104
+ * 即可。两者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次 ——
105
+ * SearchField 的 `ariaLabel` 必填,不能留空,而写明范围只有调用方做得到(05 · P1-7)
106
+ */
107
+ searchAriaLabel?: string
108
+
86
109
  /** 常用筛选,传 2–3 个 `ApplicationFilterMenu` */
87
110
  commonFilters?: ReactNode
88
111
 
89
- /** 「更多筛选」触发器,通常是 `Collapsible` 或 `Popover` */
112
+ /** 「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4) */
90
113
  moreFilters?: ReactNode
91
114
 
92
- /** 排序控件 */
115
+ /** 排序控件,传 `Select`。DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2) */
93
116
  sort?: ReactNode
94
117
 
95
118
  /** 已生效的筛选标签 */
@@ -104,11 +127,27 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
104
127
  /** 当前呈现方式。**决定呈现设置按钮的文案** */
105
128
  presentation?: DataPresentation
106
129
 
107
- /** 是否有可配置的呈现设置。false 时按钮不渲染且不占位 */
130
+ /**
131
+ * 是否有可配置的呈现设置。false 时按钮不渲染且不占位。
132
+ *
133
+ * 缺省时按是否提供 `onPresentationSettings` 推断(05 · P1-7):此前缺省为
134
+ * `true`,不传即渲染一个点了没反应的设置按钮,默认值站在了违规一边。
135
+ * 显式传入仍优先
136
+ */
108
137
  hasPresentationSettings?: boolean
109
138
 
110
- /** 呈现设置点击回调 */
111
- onPresentationSettings?: () => void
139
+ /**
140
+ * 呈现设置点击回调。参数是按钮的点击事件,`event.currentTarget` 即设置按钮本身,
141
+ * 供调用方把面板锚定在它上面、或关闭后把焦点还给它(06 · P2-6)。
142
+ * 不读参数的无参回调照旧可用
143
+ */
144
+ onPresentationSettings?: (event: MouseEvent<HTMLButtonElement>) => void
145
+
146
+ /**
147
+ * 呈现设置面板当前是否展开。传入后设置按钮输出 `aria-expanded`,读屏据此报出开合;
148
+ * 不传则不输出 —— 面板由调用方持有,组件无从得知开合,宁可不报也不报错(06 · P2-6)
149
+ */
150
+ presentationSettingsOpen?: boolean
112
151
 
113
152
  /** **仅 SPLIT 右栏使用**的视图模式切换器 */
114
153
  viewModeSwitch?: ReactNode
@@ -38,12 +38,19 @@ export interface ApplicationSplitListSidebarProps extends HTMLAttributes<HTMLEle
38
38
  /** 目录项集合 */
39
39
  items?: SplitSidebarItem[]
40
40
 
41
- /** 当前选中项。`undefined` / `null` 是合法状态 */
42
- value?: string
41
+ /** 当前选中项。`undefined` 与 `null` 都表示未定位,是合法状态 */
42
+ value?: string | null
43
43
 
44
- /** 选中项变化回调 */
44
+ /** 选中项变化回调。只回传条目值,不回传 `null` —— 取消定位走 `onClear` */
45
45
  onValueChange?: (value: string) => void
46
46
 
47
+ /**
48
+ * 取消定位回调(06 · P2-1)。提供时**再次选择当前项即取消定位**(点击或 Enter / 空格),
49
+ * 调用方在此把 `value` 写回 `null`;当前项另带描述「再次选择取消定位」。
50
+ * 不提供时再次选择当前项照旧回调 `onValueChange`,不会取消定位
51
+ */
52
+ onClear?: () => void
53
+
47
54
  /** 目录设置触发器。**与呈现设置是两回事**,不要混用 */
48
55
  settings?: ReactNode
49
56
 
@@ -54,4 +61,9 @@ export interface ApplicationSplitListSidebarProps extends HTMLAttributes<HTMLEle
54
61
  width?: number | string
55
62
  }
56
63
 
57
- /* 三方一致,契约中的禁止清单与「null 是合法状态」的约束已完整表达。 */
64
+ /* 三方一致,契约中的禁止清单与「null 是合法状态」的约束已完整表达。
65
+ *
66
+ * 06 · P2-1:此前 `value` 只收 string,「null 是合法状态」只写在说明里、类型上写不出来,
67
+ * 也没有取消定位的出口。`value` 放宽为 `string | null`;出口另开 `onClear` 而不让
68
+ * `onValueChange` 回传 null —— 后者会让现有的 `(value: string) => void` 回调在
69
+ * strictFunctionTypes 下不再可赋值,违反「现有调用零改动」。 */
@@ -12,7 +12,7 @@ export interface RecordListItem {
12
12
  status?: ReactNode
13
13
  /** 关键数值 */
14
14
  value?: ReactNode
15
- /** 行尾的记录级动作。**必须阻止事件冒泡**,以免误触打开详情 */
15
+ /** 行尾的记录级动作。组件包一层阻止事件冒泡,点动作不会误触打开详情 */
16
16
  actions?: ReactNode
17
17
  }
18
18
 
@@ -21,7 +21,8 @@ export interface RecordListItem {
21
21
  *
22
22
  * 适用于表格列数过剩、但行仍需扫视的场景。
23
23
  *
24
- * ⚠ **记录级动作位于行尾**,且必须阻止冒泡 —— 点动作绝不能顺带打开详情。
24
+ * ⚠ **记录级动作位于行尾** —— 点动作绝不能顺带打开详情。行点击忽略来自行内
25
+ * 可交互元素的事件,`renderRow` 接管时同样成立,调用方不必手动阻止冒泡。
25
26
  * 勾选记录应唤出 `ListBatchActionBar`。
26
27
  *
27
28
  * ⚠ 与 DataTable 一样,它的呈现设置按钮读作**「列设置」**。
@@ -33,7 +34,11 @@ export interface ApplicationRecordListProps<R extends RecordListItem = RecordLis
33
34
  /** 记录集合 */
34
35
  records?: R[]
35
36
 
36
- /** 启用行选择 */
37
+ /**
38
+ * 启用行选择。为 true 时行首渲染勾选框,列表顶部另有一行吸顶的全选框
39
+ * (`ListSelectionCheckbox scope="all"`,06 · P3-2):全选 / 全不选只作用于本次传入的
40
+ * `records`,`selected` 里不在 `records` 中的 id(如其他页已选)原样保留
41
+ */
37
42
  selectable?: boolean
38
43
 
39
44
  /** 已选记录 id 集合 */
@@ -42,10 +47,10 @@ export interface ApplicationRecordListProps<R extends RecordListItem = RecordLis
42
47
  /** 选中集合变化回调 */
43
48
  onSelectedChange?: (ids: string[]) => void
44
49
 
45
- /** SPLIT 右栏或抽屉流程中的当前对象 id */
50
+ /** SPLIT 右栏或抽屉流程中的当前对象 id。该行输出 `aria-current="true"` */
46
51
  activeId?: string
47
52
 
48
- /** 打开记录回调。点击行主体触发 */
53
+ /** 打开记录回调。点击行主体、或行聚焦时按 Enter / 空格触发 */
49
54
  onOpen?: (record: R) => void
50
55
 
51
56
  /** 默认行结构不适用时,完全接管行主体的渲染 */
@@ -17,18 +17,23 @@ export interface ModuleItem {
17
17
  *
18
18
  * ### 触发器
19
19
  * Standard 最小宽 168 / 高 40,Compact 148 / 32;
20
- * 深色 32×32 图标块(8px 圆角,18px 白色字形),
20
+ * 32×32 浅灰底图标块(8px 圆角,18px 正文色字形,`--ui-shell-module-switch-icon-*`),
21
21
  * 名称 16/20 **700**,14px chevron 右对齐。
22
22
  *
23
23
  * ⚠ **绝不能简化成一个小图标,也绝不能移除。**
24
24
  *
25
25
  * ### 面板
26
26
  * `position: fixed`,`top: --ui-shell-application-total-height`,
27
- * `left: 0`,`bottom: 0`,宽 392px(受视口限制),白色表面,
27
+ * `left: 0`,`bottom: 0`,宽 `--ui-shell-module-switch-panel-width`(320px,受视口限制),白色表面,
28
28
  * **1px 右边线,无圆角,无阴影**,自带垂直滚动。
29
29
  * 条目最小高 40,内边距 8/12,圆角 12,文字 14/22。
30
30
  *
31
31
  * ⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。
32
+ *
33
+ * ### 键盘
34
+ * 按 WAI-ARIA menu button 模式:打开即聚焦首个可用模块(触发器上按 ↑ 打开则聚焦末项),
35
+ * ↑ / ↓ / Home / End 在模块间移动并跳过禁用项,Esc 与外部点击经 `onOpenChange(false)`
36
+ * 收起,Esc 后焦点回到触发器,Tab 收起面板并离开。
32
37
  */
33
38
  export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect'> {
34
39
  /** 触发器上显示的当前模块名 */