@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/dist/tokens.css CHANGED
@@ -229,6 +229,19 @@
229
229
  * 裁决为改用 Foundation 自有的 tab 几何。值与 Shell 那组相同且都在已登记标尺
230
230
  * 内(32 高 / 6 纵向 / 12 横向),只是从此不再随 Shell 变动。
231
231
  *
232
+ * ── 卡片内边距 ──────────────────────────────────────────────────
233
+ * 07 · C-17(06 · P2-14):页面留白随视口三档收紧(12 / 10 / 8),Card 却恒为 16,
234
+ * 窄屏下卡片比它所在的页面还「松」。裁决为 Card 内边距随档 16 / 12 / 10。
235
+ *
236
+ * 按「响应式密度靠 @media 改写 :root 变量」落在 token 层,组件 CSS 只读
237
+ * --ds-card-padding,不在组件里写断点。两个 @media 的条件与 viewport.css 逐字相同
238
+ * (Condensed ≤1439、Compact ≤1180 宽或 ≤720 高,即 --ui-viewport-* 三个断点 token
239
+ * 的值;@media 里读不了 var(),只能写字面值),build-tokens 因此把它们并进同一档。
240
+ * 写在本文件而非 viewport.css:后者是逐字镜像,不得手改。
241
+ *
242
+ * 10px 不落在间距标尺(0/4/8/12/16/24)上,与 viewport.css 里 Condensed 档的
243
+ * --ui-page-gutter / --ui-card-gap 同为登记的版式值。
244
+ *
232
245
  * ── 回流方向 ────────────────────────────────────────────────────
233
246
  * 回流上游时,application.css 的 --application-button-height 应改为
234
247
  * var(--ds-control-height-32)。它现在写的是字面 32px,是同步文件中少数
@@ -275,6 +288,21 @@
275
288
  /* 垂直导航项高度。36 介于控件标尺的 32 与 40 之间,是有意的 ——
276
289
  * 导航项要比行内控件宽松、又比列表行紧凑。见上方 36px 一节的裁决。 */
277
290
  --ds-nav-item-height:36px;
291
+
292
+ /* 卡片内边距,随视口密度档改写。见上方「卡片内边距」一节。 */
293
+ --ds-card-padding:var(--ds-space-4);
294
+ }
295
+
296
+ @media (max-width:1439px){
297
+ :root{
298
+ --ds-card-padding:var(--ds-space-3);
299
+ }
300
+ }
301
+
302
+ @media (max-width:1180px),(max-height:720px){
303
+ :root{
304
+ --ds-card-padding:10px;
305
+ }
278
306
  }
279
307
 
280
308
  /* ── src/tokens/application.css ── */
@@ -708,13 +736,15 @@
708
736
  }
709
737
 
710
738
  /* ── src/tokens/base.css ── */
711
- /* Minimal element baseline. Not part of the source token file — added so
712
- * standalone specimen cards and prototypes inherit the registered
713
- * typography and canvas without restating it. */
714
- html{-webkit-text-size-adjust:100%}
715
- body{margin:0;font-family:var(--ds-font-family);font-size:var(--ds-font-size-14);line-height:var(--ds-line-height-20);color:var(--ds-color-text);background:var(--ds-color-canvas);-webkit-font-smoothing:antialiased}
716
- *,*::before,*::after{box-sizing:border-box}
717
- a{color:var(--ds-color-application-accent);text-decoration:none}
718
- a:hover{color:color-mix(in srgb,var(--ds-color-application-accent) 82%,var(--ds-color-text))}
719
- :focus-visible{outline:2px solid var(--ds-color-application-accent);outline-offset:1px}
739
+ @layer moheng.base {
740
+ /* Minimal element baseline. Not part of the source token file — added so
741
+ * standalone specimen cards and prototypes inherit the registered
742
+ * typography and canvas without restating it. */
743
+ html{-webkit-text-size-adjust:100%}
744
+ body{margin:0;font-family:var(--ds-font-family);font-size:var(--ds-font-size-14);line-height:var(--ds-line-height-20);color:var(--ds-color-text);background:var(--ds-color-canvas);-webkit-font-smoothing:antialiased}
745
+ *,*::before,*::after{box-sizing:border-box}
746
+ a{color:var(--ds-color-application-accent);text-decoration:none}
747
+ a:hover{color:color-mix(in srgb,var(--ds-color-application-accent) 82%,var(--ds-color-text))}
748
+ :focus-visible{outline:2px solid var(--ds-color-application-accent);outline-offset:1px}
749
+ }
720
750
 
@@ -3,8 +3,9 @@ import type { HTMLAttributes } from 'react';
3
3
  * 列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。
4
4
  * 数据展示区的标准页脚,LIST 页面模式的默认配置。
5
5
  *
6
- * ⚠ **分页语义必须跨 Page Mode 与 Business View 切换存活**,
7
- * 从详情返回时也必须还原 —— 规范要求恢复来源上下文。
6
+ * ⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,
7
+ * 切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。
8
+ * 搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。
8
9
  *
9
10
  * 没有总数与每页条数需求时,用 Foundation `Pagination`。
10
11
  */
@@ -1 +1 @@
1
- {"version":3,"file":"list-table-pagination.d.ts","sourceRoot":"","sources":["../../../contracts/application-atomic/list-table-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC9E,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,eAAe;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAE1B,aAAa;IACb,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C"}
1
+ {"version":3,"file":"list-table-pagination.d.ts","sourceRoot":"","sources":["../../../contracts/application-atomic/list-table-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC9E,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,eAAe;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAE1B,aAAa;IACb,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C"}
@@ -8,22 +8,37 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react';
8
8
  * ⚠ **页面不得自建平台级或业务级的按钮变体。** 改一次应用强调色,
9
9
  * 全部 SystemButton 同时换肤 —— 逐页 fork 会摧毁这个性质。
10
10
  *
11
- * 只有在没有稳定应用语义可用时才降级到 Foundation `Button`。
11
+ * **业务页面的按钮一律用本组件**,Foundation `Button` 只供库内组件使用
12
+ * (实践报告 P1-1 裁决)。
13
+ *
14
+ * @replaces button
12
15
  */
13
16
  export interface SystemButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
14
17
  /**
15
- * 应用意图。映射到 Foundation Button 的 variant:
16
- * `quiet` → ghost,`icon` → ghost + 等宽,其余同名。
18
+ * 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。
19
+ */
20
+ intent?: 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive';
21
+ /**
22
+ * 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。
23
+ * `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作
24
+ * (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。
25
+ */
26
+ size?: 'default' | 'compact' | 'sm';
27
+ /**
28
+ * 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation
29
+ * `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。
17
30
  */
18
- intent?: 'primary' | 'secondary' | 'quiet' | 'icon' | 'link' | 'destructive';
19
- /** 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异 */
20
- size?: 'default' | 'compact' | 'icon';
31
+ iconOnly?: boolean;
21
32
  /**
22
- * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈。
23
- * 与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
33
+ * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈
34
+ * 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
35
+ *
36
+ * 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中
37
+ * `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦,
38
+ * 焦点不会在点击后掉到 `<body>`。
24
39
  */
25
40
  loading?: boolean;
26
- /** 纯图标按钮(`intent="icon"` 或 `size="icon"`)**必须**提供 `aria-label` */
41
+ /** 按钮内容。`iconOnly` 时为单个 `Icon` 元素 */
27
42
  children?: ReactNode;
28
43
  }
29
44
  //# sourceMappingURL=system-button.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"system-button.d.ts","sourceRoot":"","sources":["../../../contracts/application-atomic/system-button.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IAChF;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAA;IAE5E,+CAA+C;IAC/C,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"system-button.d.ts","sourceRoot":"","sources":["../../../contracts/application-atomic/system-button.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IAChF;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAA;IAEnE;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAA;IAEnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -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
  export interface WorkspacePerson {
5
6
  /** 唯一标识 */
@@ -18,6 +19,10 @@ export interface WorkspacePerson {
18
19
  * 不要在每个页面重新搭一遍三栏布局。
19
20
  *
20
21
  * 详情栏应传 `ApplicationRecordDetailBody`,与其他详情载体保持同一份主体。
22
+ *
23
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
24
+ * 非 `ready` 时对应槽位顶替成员栏与详情栏两栏,组织树定位器保留 —— 某个机构
25
+ * 加载失败、无权限或已撤销时,读者仍要能换一个机构。六种状态各写各的措辞。
21
26
  */
22
27
  export interface ContactsCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
23
28
  /** 机构搜索,应传 `SearchField` */
@@ -34,7 +39,32 @@ export interface ContactsCollaborationWorkspaceProps extends HTMLAttributes<HTML
34
39
  activePerson?: string;
35
40
  /** 成员变化回调 */
36
41
  onPersonChange?: (id: string) => void;
37
- /** 成员详情,应传 `ApplicationRecordDetailBody` */
42
+ /** 成员详情,应传 `ApplicationRecordDetailBody`。未选中成员时**不传**,详情栏显示 `detailEmpty` */
38
43
  detail?: ReactNode;
44
+ /**
45
+ * `ready` 且当前机构下没有成员时成员栏的内容。
46
+ * 缺省为内置的 `Empty`「此机构下无成员」;需要附带动作时覆盖
47
+ */
48
+ peopleEmpty?: ReactNode;
49
+ /**
50
+ * 未传 `detail` 时详情栏的内容。缺省为内置的 `Empty`「未选择成员」。
51
+ * 不得为了填满详情栏而自动选中第一个成员
52
+ */
53
+ detailEmpty?: ReactNode;
54
+ /**
55
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染成员栏与详情栏,
56
+ * 其余状态渲染对应槽位,顶替成员栏与详情栏两栏;组织树始终保留
57
+ */
58
+ state?: DataDisplayState;
59
+ /** Loading 状态内容。应传贴近「成员列表 · 详情」两栏结构的 `Skeleton` */
60
+ loading?: ReactNode;
61
+ /** Empty 状态内容(整个工作台无数据)。应传 `Empty`,文案须点明当前口径 */
62
+ empty?: ReactNode;
63
+ /** Error 状态内容。应说明失败原因并提供重试 */
64
+ error?: ReactNode;
65
+ /** No Permission 状态内容。措辞必须区别于 Empty */
66
+ noPermission?: ReactNode;
67
+ /** Not Found 状态内容(如机构不存在或已撤销)。措辞必须区别于 Empty 与 No Permission */
68
+ notFound?: ReactNode;
39
69
  }
40
70
  //# sourceMappingURL=contacts-collaboration-workspace.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"contacts-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/contacts-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAEpF,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,SAAS;IACT,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc;IACd,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE5B,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,aAAa;IACb,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,eAAe;IACf,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAE1B,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,aAAa;IACb,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB"}
1
+ {"version":3,"file":"contacts-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/contacts-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAE9E,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,SAAS;IACT,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc;IACd,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE5B,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,aAAa;IACb,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,eAAe;IACf,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAE1B,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,aAAa;IACb,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -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
  export interface WorkspaceFile {
5
6
  /** 唯一标识 */
@@ -20,6 +21,10 @@ export interface WorkspaceFile {
20
21
  *
21
22
  * ⚠ **没有选中项时省略 `preview`**,而不是显示一条空的预览栏 ——
22
23
  * 与「无真实指标时不渲染指标区」同一条原则。
24
+ *
25
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
26
+ * 非 `ready` 时对应槽位顶替文件表,预览栏不渲染;文件夹定位器与工具栏保留 ——
27
+ * 换个文件夹、在空目录里上传,都不该被状态挡住。
23
28
  */
24
29
  export interface FilesCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
25
30
  /** 文件搜索,应传 `SearchField` */
@@ -42,7 +47,23 @@ export interface FilesCollaborationWorkspaceProps extends HTMLAttributes<HTMLDiv
42
47
  toolbar?: ReactNode;
43
48
  /** 预览栏。**无选中项时不要传** */
44
49
  preview?: ReactNode;
45
- /** 空态,应传 `Empty`。文案须点明是「此目录下」 */
50
+ /**
51
+ * 空态,应传 `Empty`。文案须点明是「此目录下」。
52
+ * `ready` 且 `files` 为空时由文件表显示,`state="empty"` 时顶替文件表显示
53
+ */
46
54
  empty?: ReactNode;
55
+ /**
56
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染文件表与预览栏,
57
+ * 其余状态渲染对应槽位,顶替文件表;文件夹树与工具栏始终保留
58
+ */
59
+ state?: DataDisplayState;
60
+ /** Loading 状态内容。应传贴近文件表结构的 `Skeleton` */
61
+ loading?: ReactNode;
62
+ /** Error 状态内容。应说明失败原因并提供重试 */
63
+ error?: ReactNode;
64
+ /** No Permission 状态内容。措辞必须区别于 Empty */
65
+ noPermission?: ReactNode;
66
+ /** Not Found 状态内容(如文件夹不存在或已删除)。措辞必须区别于 Empty 与 No Permission */
67
+ notFound?: ReactNode;
47
68
  }
48
69
  //# sourceMappingURL=files-collaboration-workspace.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"files-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/files-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAEpF,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,UAAU;IACV,IAAI,EAAE,SAAS,CAAA;IACf,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAiC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE5B,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC,gBAAgB;IAChB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IAEvB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB,aAAa;IACb,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAE1C,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IAEtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,uBAAuB;IACvB,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB"}
1
+ {"version":3,"file":"files-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/files-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAE9E,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,UAAU;IACV,IAAI,EAAE,SAAS,CAAA;IACf,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gCAAiC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE5B,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC,gBAAgB;IAChB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IAEvB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB,aAAa;IACb,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAE1C,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IAEtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,uBAAuB;IACvB,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -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
  export interface ScheduleEvent {
4
5
  /** 唯一标识 */
@@ -19,10 +20,23 @@ export type ScheduleGrain = 'day' | 'week' | 'month';
19
20
  *
20
21
  * ⚠ 选择日历型承载面之前,**必须先命名日期字段与真实的观察粒度** ——
21
22
  * `CALENDAR` 页面模式两者都要求。
23
+ *
24
+ * ⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。
25
+ * 非 `ready` 时对应槽位顶替月格,议程栏不渲染;标题行(粒度切换、工具栏)保留 ——
26
+ * 某个月加载失败时读者仍要能翻到别的月份。
22
27
  */
23
28
  export interface ScheduleCollaborationWorkspaceProps extends HTMLAttributes<HTMLDivElement> {
24
29
  /** 当前显示的月份 */
25
30
  month?: Date;
31
+ /**
32
+ * 翻页回调,回传目标月份的 1 日。**提供时工作台内置「上一页 · 今天 · 下一页」三个控件**,
33
+ * 不提供时不渲染(翻页由调用方自理,保持旧行为)。
34
+ *
35
+ * 翻页按粒度走:月档翻一个月;周档、日档把焦点日前后移 7 天 / 1 天,经 `onSelectDate`
36
+ * 回传新的焦点日,跨月时同时回调本函数。周档、日档未提供 `onSelectDate` 时按月翻。
37
+ * 「今天」回调今天所在月份,并经 `onSelectDate` 选中今天
38
+ */
39
+ onMonthChange?: (month: Date) => void;
26
40
  /** 事件集合 */
27
41
  events?: ScheduleEvent[];
28
42
  /** 选中日期,ISO `yyyy-mm-dd` */
@@ -35,5 +49,25 @@ export interface ScheduleCollaborationWorkspaceProps extends HTMLAttributes<HTML
35
49
  onGrainChange?: (grain: ScheduleGrain) => void;
36
50
  /** 工具栏内容 */
37
51
  toolbar?: ReactNode;
52
+ /**
53
+ * 选中日期当天没有事件时议程栏的内容。缺省为内置的 `Empty`「当日无日程」;
54
+ * 需要附带「新建」之类的动作时覆盖
55
+ */
56
+ agendaEmpty?: ReactNode;
57
+ /**
58
+ * 当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染月格与议程栏,
59
+ * 其余状态渲染对应槽位,顶替月格;标题行始终保留
60
+ */
61
+ state?: DataDisplayState;
62
+ /** Loading 状态内容。应传贴近月格结构的 `Skeleton` */
63
+ loading?: ReactNode;
64
+ /** Empty 状态内容。应传 `Empty`,文案须点明当前口径(如「本月」) */
65
+ empty?: ReactNode;
66
+ /** Error 状态内容。应说明失败原因并提供重试 */
67
+ error?: ReactNode;
68
+ /** No Permission 状态内容。措辞必须区别于 Empty */
69
+ noPermission?: ReactNode;
70
+ /** Not Found 状态内容(如日历不存在或已删除)。措辞必须区别于 Empty 与 No Permission */
71
+ notFound?: ReactNode;
38
72
  }
39
73
  //# sourceMappingURL=schedule-collaboration-workspace.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"schedule-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/schedule-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,aAAa;AACb,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAEpD;;;;;;;GAOG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,cAAc;IACd,KAAK,CAAC,EAAE,IAAI,CAAA;IAEZ,WAAW;IACX,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IAExB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,eAAe;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,WAAW;IACX,KAAK,CAAC,EAAE,aAAa,CAAA;IAErB,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAE9C,YAAY;IACZ,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB"}
1
+ {"version":3,"file":"schedule-collaboration-workspace.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/collaboration/schedule-collaboration-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAE9E,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,aAAa;AACb,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,cAAc;IACd,KAAK,CAAC,EAAE,IAAI,CAAA;IAEZ;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAA;IAErC,WAAW;IACX,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IAExB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,eAAe;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,WAAW;IACX,KAAK,CAAC,EAAE,aAAa,CAAA;IAErB,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAE9C,YAAY;IACZ,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB,wCAAwC;IACxC,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -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
  export type DataDisplayState = 'ready' | 'loading' | 'empty' | 'error' | 'no-permission' | 'not-found';
@@ -16,6 +16,7 @@ export type DataDisplayState = 'ready' | 'loading' | 'empty' | 'error' | 'no-per
16
16
  * ⚠ **六种状态各有各的节点与各自的措辞。**
17
17
  * Loading / Empty / Error / No Permission / Not Found 绝不共用文案 ——
18
18
  * 「当前口径下无数据」「你没有权限」「未找到」「请求失败」是四句不同的话。
19
+ * 第六种 Partial Failure 不替换呈现,而是在 ready 态经 `notice` 叠一条 `Alert`。
19
20
  */
20
21
  export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement> {
21
22
  /** 当前呈现方式。应与 `ApplicationQueryToolbar` 的取值保持一致 */
@@ -24,6 +25,14 @@ export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement>
24
25
  state?: DataDisplayState;
25
26
  /** 批量动作条,应传 `ListBatchActionBar`。有记录被选中时才出现 */
26
27
  batchBar?: ReactNode;
28
+ /**
29
+ * 区域级提示,承载 **Partial Failure**(05 · P2-2):应传 `Alert`,说明哪部分没取到并给出重试。
30
+ *
31
+ * 固定在批量条之下、呈现之上,**不随内容滚动**;**只在 `state="ready"` 时渲染** ——
32
+ * 其余五种状态整块换成对应槽位,部分失败无从谈起。此前没有这个位置,调用方只能把
33
+ * Alert 塞进 `children` 顶部,与呈现组件同处滚动区,滚走后读者就看不到哪些字段缺失。
34
+ */
35
+ notice?: ReactNode;
27
36
  /** 分页,应传 `ListTablePagination`。固定在区域底部 */
28
37
  pagination?: ReactNode;
29
38
  /** Loading 状态内容。应传贴近最终结构的 `Skeleton`,而非通用转圈 */
@@ -38,5 +47,16 @@ export interface ApplicationDataDisplayProps extends HTMLAttributes<HTMLElement>
38
47
  notFound?: ReactNode;
39
48
  /** `state="ready"` 时渲染的呈现组件 */
40
49
  children?: ReactNode;
50
+ /**
51
+ * 主体滚动容器的 ref —— 批量条与分页之间、自身滚动的那一层(06 · P2-4)。
52
+ *
53
+ * 供「从详情返回列表时还原滚动位置」:离开前读它的 `scrollTop` 存进跨路由存活的
54
+ * 状态,回来后在 `state` 首次变为 `ready` 时写回。主体容器跨状态切换不重建,
55
+ * 同一个 ref 在 loading → ready 之间一直指向同一个元素。
56
+ *
57
+ * 走具名 prop 而不是 `ref`:`ref` 在 React 18 不交给函数组件,且根元素也不是
58
+ * 滚动的那一层;具名 prop 在 18 与 19 下行为一致。
59
+ */
60
+ bodyRef?: Ref<HTMLDivElement>;
41
61
  }
42
62
  //# sourceMappingURL=application-data-display.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"application-data-display.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-data-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,iBAAiB;AACjB,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,SAAS,GACT,OAAO,GACP,OAAO,GACP,eAAe,GACf,WAAW,CAAA;AAEf;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC9E,kDAAkD;IAClD,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"application-data-display.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-data-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,iBAAiB;AACjB,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,SAAS,GACT,OAAO,GACP,OAAO,GACP,eAAe,GACf,WAAW,CAAA;AAEf;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC9E,kDAAkD;IAClD,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAA;CAC9B"}
@@ -20,8 +20,8 @@ export interface FilterGroup {
20
20
  /**
21
21
  * 完整的筛选维度列表 —— **「更多筛选」的面板主体**。
22
22
  *
23
- * ⚠ **必须包含搜索**,外加每一个可筛选维度 ——
24
- * 「更多筛选」是筛选能力的全集入口,不是常用筛选的补充。
23
+ * ⚠ **必须包含搜索**,外加常用筛选之外的每一个可筛选维度 ——
24
+ * 常用筛选里出现的维度不再进「更多筛选」,同一维度只有一个入口(07 · C-11)。
25
25
  *
26
26
  * ⚠ **它持有草稿:在点「应用」之前,任何改动都不生效。**
27
27
  *
@@ -29,7 +29,7 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
29
29
  subtitle?: ReactNode;
30
30
  /** 数据状态。决定状态文案与刷新按钮的可用性 */
31
31
  dataStatus?: 'normal' | 'refreshing' | 'failed';
32
- /** 最后更新时刻,仅在 `normal` 状态显示为「更新于 …」 */
32
+ /** 最后更新时刻,只写 `HH:mm`(如 `09:12`,07 · C-12)。仅在 `normal` 状态显示为「更新于 09:12」 */
33
33
  updatedAt?: string;
34
34
  /** 刷新回调。`refreshing` 状态下按钮禁用 */
35
35
  onRefresh?: () => void;
@@ -1 +1 @@
1
- {"version":3,"file":"application-page-header.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-page-header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAA;IAE/C,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IAEtB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IAEtB,aAAa;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,eAAe;IACf,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAE3C,sBAAsB;IACtB,UAAU,CAAC,EAAE,SAAS,CAAA;CACvB"}
1
+ {"version":3,"file":"application-page-header.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-page-header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAA;IAE/C,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IAEtB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IAEtB,aAAa;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,eAAe;IACf,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAE3C,sBAAsB;IACtB,UAAU,CAAC,EAAE,SAAS,CAAA;CACvB"}
@@ -14,8 +14,21 @@ import type { HTMLAttributes, ReactNode } from 'react';
14
14
  * **不要在它外面再包一层自己的 padding。**
15
15
  *
16
16
  * ⚠ 页面没有真实指标时传 `metrics={undefined}`,**绝不用占位卡凑数**。
17
+ *
18
+ * `pageType` 必填:五层 Canvas 模型的 L1 只有本组件这一个承载者,
19
+ * 不传即结构不完整(实践报告 P1-2)。
17
20
  */
18
21
  export interface ApplicationPageLayoutContainerProps extends HTMLAttributes<HTMLDivElement> {
22
+ /**
23
+ * L1 页面类型。输出为根节点的 `data-page-type`,不改变区域顺序与留白。
24
+ *
25
+ * 唯一受它影响的是纵向尺寸:`DETAIL` 页的容器随内容增高、由 Content Canvas
26
+ * 滚动;其余页型的容器可收缩到 Canvas 高度,数据展示区拿到剩余高度后
27
+ * 由 `ApplicationDataDisplay` 内部滚动。
28
+ *
29
+ * `DETAIL` 页的内容结构用 `ApplicationRecordDetailBody`,仍以本组件为内容根。
30
+ */
31
+ pageType: 'WORKBENCH' | 'MANAGEMENT' | 'LEDGER' | 'ANALYSIS' | 'REPORT' | 'DETAIL';
19
32
  /** 上下文区,应传 `ApplicationPageHeader` */
20
33
  header?: ReactNode;
21
34
  /** 指标区,应传 `ApplicationMetricStrip`。无真实指标时整体省略 */
@@ -1 +1 @@
1
- {"version":3,"file":"application-page-layout-container.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-page-layout-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"application-page-layout-container.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-page-layout-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF;;;;;;;;OAQG;IACH,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAElF,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -1,4 +1,4 @@
1
- import type { ChangeEvent, HTMLAttributes, ReactNode } from 'react';
1
+ import type { ChangeEvent, HTMLAttributes, MouseEvent, ReactNode } from 'react';
2
2
  /** L3 业务视图标签 */
3
3
  export interface BusinessViewTab {
4
4
  /** 视图值 */
@@ -17,8 +17,14 @@ export interface AppliedFilterTag {
17
17
  /** 移除按钮无障碍名称用的纯文本。`label` 非字符串时必须提供。见 M7 */
18
18
  labelText?: string;
19
19
  }
20
- /** L5 数据呈现方式 */
21
- export type DataPresentation = 'DataTable' | 'CardList' | 'KanbanBoard' | 'Calendar' | 'Chart' | 'Timeline';
20
+ /**
21
+ * L5 数据呈现方式。
22
+ *
23
+ * `RecordList` 是结构化列表(`ApplicationRecordList`),06 · D-2 裁决补入:此前 LIST 页用
24
+ * RecordList 只能谎报为 `DataTable`。`KanbanBoard` / `Calendar` / `Timeline` 暂无专属组件,
25
+ * 按 canvas-model「呈现配方」一节的标准拼装写法承载。
26
+ */
27
+ export type DataPresentation = 'DataTable' | 'RecordList' | 'CardList' | 'KanbanBoard' | 'Calendar' | 'Chart' | 'Timeline';
22
28
  /**
23
29
  * **数据控制区** —— 统一承载 Canvas 五层模型的 L3 业务视图与 L4 数据控制。
24
30
  *
@@ -38,10 +44,11 @@ export type DataPresentation = 'DataTable' | 'CardList' | 'KanbanBoard' | 'Calen
38
44
  * 由「应用」提交,并**回写到第三行的标签**。
39
45
  *
40
46
  * ### ⚠ 呈现设置按钮必须按当前呈现方式命名
41
- * DataTable → 列设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
47
+ * DataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
42
48
  * Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。
43
49
  * **通用的「视图设置」被明令禁止。**
44
- * 无真实可配置项时(`hasPresentationSettings={false}`)按钮不渲染且不占位。
50
+ * 无真实可配置项时(`hasPresentationSettings={false}`,或不传
51
+ * `onPresentationSettings`)按钮不渲染且不占位。
45
52
  * 每种呈现方式**各自独立存储**其设置。
46
53
  *
47
54
  * ### ⚠ Page Mode Switch 不属于本组件
@@ -67,13 +74,27 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
67
74
  }) => void;
68
75
  /** 搜索提交回调。**仅 Enter 触发** */
69
76
  onSearchSubmit?: (value: string) => void;
70
- /** 搜索占位文字。应写明搜索范围 */
77
+ /**
78
+ * 搜索占位文字。应写明搜索范围,如「搜索任务名称或编号」。
79
+ *
80
+ * **无默认值**(05 · P1-7):此前缺省为 `'搜索'`,不传即违反 SearchField
81
+ * 「不得写成不含范围的『搜索』」,且同时充当可访问名。缺省时占位文字取
82
+ * `searchAriaLabel`,二者都缺省则不显示占位文字。
83
+ */
71
84
  searchPlaceholder?: string;
85
+ /**
86
+ * 搜索框的可访问名,必须写明搜索范围。优先级:本 prop → `searchPlaceholder`。
87
+ *
88
+ * 占位文字写示例、可访问名写范围时分开传;二者同文时只传 `searchPlaceholder`
89
+ * 即可。两者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次 ——
90
+ * SearchField 的 `ariaLabel` 必填,不能留空,而写明范围只有调用方做得到(05 · P1-7)
91
+ */
92
+ searchAriaLabel?: string;
72
93
  /** 常用筛选,传 2–3 个 `ApplicationFilterMenu` */
73
94
  commonFilters?: ReactNode;
74
- /** 「更多筛选」触发器,通常是 `Collapsible` 或 `Popover` */
95
+ /** 「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4) */
75
96
  moreFilters?: ReactNode;
76
- /** 排序控件 */
97
+ /** 排序控件,传 `Select`。DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2) */
77
98
  sort?: ReactNode;
78
99
  /** 已生效的筛选标签 */
79
100
  appliedTags?: AppliedFilterTag[];
@@ -83,10 +104,25 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
83
104
  onResetTags?: () => void;
84
105
  /** 当前呈现方式。**决定呈现设置按钮的文案** */
85
106
  presentation?: DataPresentation;
86
- /** 是否有可配置的呈现设置。false 时按钮不渲染且不占位 */
107
+ /**
108
+ * 是否有可配置的呈现设置。false 时按钮不渲染且不占位。
109
+ *
110
+ * 缺省时按是否提供 `onPresentationSettings` 推断(05 · P1-7):此前缺省为
111
+ * `true`,不传即渲染一个点了没反应的设置按钮,默认值站在了违规一边。
112
+ * 显式传入仍优先
113
+ */
87
114
  hasPresentationSettings?: boolean;
88
- /** 呈现设置点击回调 */
89
- onPresentationSettings?: () => void;
115
+ /**
116
+ * 呈现设置点击回调。参数是按钮的点击事件,`event.currentTarget` 即设置按钮本身,
117
+ * 供调用方把面板锚定在它上面、或关闭后把焦点还给它(06 · P2-6)。
118
+ * 不读参数的无参回调照旧可用
119
+ */
120
+ onPresentationSettings?: (event: MouseEvent<HTMLButtonElement>) => void;
121
+ /**
122
+ * 呈现设置面板当前是否展开。传入后设置按钮输出 `aria-expanded`,读屏据此报出开合;
123
+ * 不传则不输出 —— 面板由调用方持有,组件无从得知开合,宁可不报也不报错(06 · P2-6)
124
+ */
125
+ presentationSettingsOpen?: boolean;
90
126
  /** **仅 SPLIT 右栏使用**的视图模式切换器 */
91
127
  viewModeSwitch?: ReactNode;
92
128
  }
@@ -1 +1 @@
1
- {"version":3,"file":"application-query-toolbar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-query-toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnE,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAA;IAChB,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,UAAU,GACV,aAAa,GACb,UAAU,GACV,OAAO,GACP,UAAU,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,qBAAqB;IACrB,aAAa,CAAC,EAAE,eAAe,EAAE,CAAA;IAEjC,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,eAAe;IACf,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAE9C,wBAAwB;IACxB,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,eAAe;IACf,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IAE/F,4BAA4B;IAC5B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC,qBAAqB;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB,eAAe;IACf,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAEhC,eAAe;IACf,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAElC,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IAExB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B,mCAAmC;IACnC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IAEjC,eAAe;IACf,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAA;IAEnC,+BAA+B;IAC/B,cAAc,CAAC,EAAE,SAAS,CAAA;CAC3B"}
1
+ {"version":3,"file":"application-query-toolbar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-query-toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE/E,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAA;IAChB,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,YAAY,GACZ,UAAU,GACV,aAAa,GACb,UAAU,GACV,OAAO,GACP,UAAU,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,qBAAqB;IACrB,aAAa,CAAC,EAAE,eAAe,EAAE,CAAA;IAEjC,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,eAAe;IACf,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAE9C,wBAAwB;IACxB,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,eAAe;IACf,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IAE/F,4BAA4B;IAC5B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB,eAAe;IACf,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAEhC,eAAe;IACf,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAElC,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IAExB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IAEjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;IAEvE;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAElC,+BAA+B;IAC/B,cAAc,CAAC,EAAE,SAAS,CAAA;CAC3B"}
@@ -34,10 +34,16 @@ export interface ApplicationSplitListSidebarProps extends HTMLAttributes<HTMLEle
34
34
  search?: ReactNode;
35
35
  /** 目录项集合 */
36
36
  items?: SplitSidebarItem[];
37
- /** 当前选中项。`undefined` / `null` 是合法状态 */
38
- value?: string;
39
- /** 选中项变化回调 */
37
+ /** 当前选中项。`undefined` 与 `null` 都表示未定位,是合法状态 */
38
+ value?: string | null;
39
+ /** 选中项变化回调。只回传条目值,不回传 `null` —— 取消定位走 `onClear` */
40
40
  onValueChange?: (value: string) => void;
41
+ /**
42
+ * 取消定位回调(06 · P2-1)。提供时**再次选择当前项即取消定位**(点击或 Enter / 空格),
43
+ * 调用方在此把 `value` 写回 `null`;当前项另带描述「再次选择取消定位」。
44
+ * 不提供时再次选择当前项照旧回调 `onValueChange`,不会取消定位
45
+ */
46
+ onClear?: () => void;
41
47
  /** 目录设置触发器。**与呈现设置是两回事**,不要混用 */
42
48
  settings?: ReactNode;
43
49
  /** 栏底内容 */
@@ -1 +1 @@
1
- {"version":3,"file":"application-split-list-sidebar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-split-list-sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gCAAiC,SAAQ,cAAc,CAAC,WAAW,CAAC;IACnF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,YAAY;IACZ,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,cAAc;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,WAAW;IACX,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACxB"}
1
+ {"version":3,"file":"application-split-list-sidebar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/content/application-split-list-sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gCAAiC,SAAQ,cAAc,CAAC,WAAW,CAAC;IACnF,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,YAAY;IACZ,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE1B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB,mDAAmD;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,WAAW;IACX,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACxB"}
@@ -11,7 +11,7 @@ export interface RecordListItem {
11
11
  status?: ReactNode;
12
12
  /** 关键数值 */
13
13
  value?: ReactNode;
14
- /** 行尾的记录级动作。**必须阻止事件冒泡**,以免误触打开详情 */
14
+ /** 行尾的记录级动作。组件包一层阻止事件冒泡,点动作不会误触打开详情 */
15
15
  actions?: ReactNode;
16
16
  }
17
17
  /**
@@ -19,7 +19,8 @@ export interface RecordListItem {
19
19
  *
20
20
  * 适用于表格列数过剩、但行仍需扫视的场景。
21
21
  *
22
- * ⚠ **记录级动作位于行尾**,且必须阻止冒泡 —— 点动作绝不能顺带打开详情。
22
+ * ⚠ **记录级动作位于行尾** —— 点动作绝不能顺带打开详情。行点击忽略来自行内
23
+ * 可交互元素的事件,`renderRow` 接管时同样成立,调用方不必手动阻止冒泡。
23
24
  * 勾选记录应唤出 `ListBatchActionBar`。
24
25
  *
25
26
  * ⚠ 与 DataTable 一样,它的呈现设置按钮读作**「列设置」**。
@@ -29,15 +30,19 @@ export interface RecordListItem {
29
30
  export interface ApplicationRecordListProps<R extends RecordListItem = RecordListItem> extends HTMLAttributes<HTMLDivElement> {
30
31
  /** 记录集合 */
31
32
  records?: R[];
32
- /** 启用行选择 */
33
+ /**
34
+ * 启用行选择。为 true 时行首渲染勾选框,列表顶部另有一行吸顶的全选框
35
+ * (`ListSelectionCheckbox scope="all"`,06 · P3-2):全选 / 全不选只作用于本次传入的
36
+ * `records`,`selected` 里不在 `records` 中的 id(如其他页已选)原样保留
37
+ */
33
38
  selectable?: boolean;
34
39
  /** 已选记录 id 集合 */
35
40
  selected?: string[];
36
41
  /** 选中集合变化回调 */
37
42
  onSelectedChange?: (ids: string[]) => void;
38
- /** SPLIT 右栏或抽屉流程中的当前对象 id */
43
+ /** SPLIT 右栏或抽屉流程中的当前对象 id。该行输出 `aria-current="true"` */
39
44
  activeId?: string;
40
- /** 打开记录回调。点击行主体触发 */
45
+ /** 打开记录回调。点击行主体、或行聚焦时按 Enter / 空格触发 */
41
46
  onOpen?: (record: R) => void;
42
47
  /** 默认行结构不适用时,完全接管行主体的渲染 */
43
48
  renderRow?: (record: R) => ReactNode;