@moheng-design/ui 1.0.0 → 3.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 (529) hide show
  1. package/README.md +13 -10
  2. package/contracts/application-atomic/application-date-range-filter.ts +43 -0
  3. package/contracts/application-atomic/list-table-pagination.ts +20 -7
  4. package/contracts/application-atomic/search-field.ts +1 -1
  5. package/contracts/application-atomic/system-button.ts +33 -11
  6. package/contracts/application-module/collaboration/contacts-collaboration-workspace.ts +39 -1
  7. package/contracts/application-module/collaboration/files-collaboration-workspace.ts +27 -1
  8. package/contracts/application-module/collaboration/schedule-collaboration-workspace.ts +42 -0
  9. package/contracts/application-module/content/application-data-display.ts +23 -1
  10. package/contracts/application-module/content/application-filter-list.ts +2 -2
  11. package/contracts/application-module/content/application-page-header.ts +55 -6
  12. package/contracts/application-module/content/application-page-layout-container.ts +14 -0
  13. package/contracts/application-module/content/application-query-toolbar.ts +70 -15
  14. package/contracts/application-module/content/application-record-detail-body.ts +13 -3
  15. package/contracts/application-module/content/application-split-list-sidebar.ts +16 -4
  16. package/contracts/application-module/lists/application-record-list.ts +10 -5
  17. package/contracts/application-module/navigation/application-module-switcher.ts +16 -11
  18. package/contracts/application-module/navigation/application-primary-navigation.ts +83 -20
  19. package/contracts/application-module/navigation/application-secondary-navigation.ts +57 -6
  20. package/contracts/application-module/navigation/global-sidebar.ts +1 -1
  21. package/contracts/application-module/navigation/top-navigation-primary-bar.ts +52 -12
  22. package/contracts/application-module/overlays/application-detail-drawer.ts +22 -5
  23. package/contracts/application-module/overlays/application-form-dialog.ts +32 -7
  24. package/contracts/application-module/overlays/application-global-action-panel.ts +27 -6
  25. package/contracts/application-module/statistics/metrics.ts +37 -4
  26. package/contracts/foundation/actions/button.ts +10 -6
  27. package/contracts/foundation/actions/toggle.ts +3 -3
  28. package/contracts/foundation/data-content-layout/avatar.ts +5 -2
  29. package/contracts/foundation/data-content-layout/badge.ts +6 -4
  30. package/contracts/foundation/data-content-layout/card.ts +6 -2
  31. package/contracts/foundation/data-content-layout/chart.ts +19 -7
  32. package/contracts/foundation/data-content-layout/message-scroller.ts +5 -5
  33. package/contracts/foundation/data-content-layout/progress.ts +5 -1
  34. package/contracts/foundation/data-content-layout/resizable.ts +19 -10
  35. package/contracts/foundation/data-content-layout/scroll-area.ts +2 -1
  36. package/contracts/foundation/data-content-layout/separator.ts +1 -1
  37. package/contracts/foundation/data-content-layout/table.ts +26 -2
  38. package/contracts/foundation/feedback-overlay/alert-dialog.ts +8 -3
  39. package/contracts/foundation/feedback-overlay/collapsible.ts +5 -4
  40. package/contracts/foundation/feedback-overlay/dialog.ts +22 -3
  41. package/contracts/foundation/feedback-overlay/drawer.ts +2 -2
  42. package/contracts/foundation/feedback-overlay/dropdown-menu.ts +5 -1
  43. package/contracts/foundation/feedback-overlay/hover-card.ts +1 -0
  44. package/contracts/foundation/feedback-overlay/popover.ts +19 -4
  45. package/contracts/foundation/feedback-overlay/sheet.ts +4 -2
  46. package/contracts/foundation/feedback-overlay/sonner-provider.ts +35 -0
  47. package/contracts/foundation/feedback-overlay/sonner.ts +4 -1
  48. package/contracts/foundation/icon/icon-name.ts +51 -0
  49. package/contracts/foundation/icon/icon.ts +20 -4
  50. package/contracts/foundation/input-selection/calendar.ts +14 -1
  51. package/contracts/foundation/input-selection/checkbox.ts +6 -0
  52. package/contracts/foundation/input-selection/combobox.ts +8 -2
  53. package/contracts/foundation/input-selection/date-input.ts +39 -0
  54. package/contracts/foundation/input-selection/field.ts +15 -1
  55. package/contracts/foundation/input-selection/input-group.ts +10 -0
  56. package/contracts/foundation/input-selection/input-otp.ts +6 -0
  57. package/contracts/foundation/input-selection/input.ts +2 -2
  58. package/contracts/foundation/input-selection/radio-group.ts +7 -0
  59. package/contracts/foundation/input-selection/select.ts +4 -1
  60. package/contracts/foundation/input-selection/switch.ts +9 -0
  61. package/contracts/foundation/navigation-command/command.ts +22 -3
  62. package/contracts/foundation/navigation-command/context-menu.ts +6 -1
  63. package/contracts/foundation/navigation-command/menubar.ts +6 -1
  64. package/contracts/foundation/navigation-command/navigation-menu.ts +12 -3
  65. package/contracts/foundation/navigation-command/pagination.ts +8 -4
  66. package/contracts/foundation/navigation-command/sidebar.ts +2 -1
  67. package/contracts/foundation/navigation-command/tabs.ts +12 -1
  68. package/dist/components/application-atomic/ApplicationDateRangeFilter.js +112 -0
  69. package/dist/components/application-atomic/ApplicationDateRangeFilter.js.map +1 -0
  70. package/dist/components/application-atomic/ListTablePagination.js +45 -26
  71. package/dist/components/application-atomic/ListTablePagination.js.map +1 -1
  72. package/dist/components/application-atomic/SidebarRailButton.js +12 -2
  73. package/dist/components/application-atomic/SidebarRailButton.js.map +1 -1
  74. package/dist/components/application-atomic/SystemButton.js +19 -6
  75. package/dist/components/application-atomic/SystemButton.js.map +1 -1
  76. package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js +27 -15
  77. package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js.map +1 -1
  78. package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js +10 -4
  79. package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js.map +1 -1
  80. package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js +143 -69
  81. package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js.map +1 -1
  82. package/dist/components/application-module/content/ApplicationDataDisplay.js +4 -1
  83. package/dist/components/application-module/content/ApplicationDataDisplay.js.map +1 -1
  84. package/dist/components/application-module/content/ApplicationPageHeader.js +38 -12
  85. package/dist/components/application-module/content/ApplicationPageHeader.js.map +1 -1
  86. package/dist/components/application-module/content/ApplicationPageLayoutContainer.js +6 -2
  87. package/dist/components/application-module/content/ApplicationPageLayoutContainer.js.map +1 -1
  88. package/dist/components/application-module/content/ApplicationQueryToolbar.js +30 -14
  89. package/dist/components/application-module/content/ApplicationQueryToolbar.js.map +1 -1
  90. package/dist/components/application-module/content/ApplicationRecordDetailBody.js +20 -13
  91. package/dist/components/application-module/content/ApplicationRecordDetailBody.js.map +1 -1
  92. package/dist/components/application-module/content/ApplicationSplitListSidebar.js +52 -21
  93. package/dist/components/application-module/content/ApplicationSplitListSidebar.js.map +1 -1
  94. package/dist/components/application-module/lists/ApplicationRecordList.js +53 -5
  95. package/dist/components/application-module/lists/ApplicationRecordList.js.map +1 -1
  96. package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js +95 -28
  97. package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js.map +1 -1
  98. package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js +41 -26
  99. package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js.map +1 -1
  100. package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js +37 -2
  101. package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js.map +1 -1
  102. package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js +15 -8
  103. package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js.map +1 -1
  104. package/dist/components/application-module/overlays/ApplicationDetailDrawer.js +14 -11
  105. package/dist/components/application-module/overlays/ApplicationDetailDrawer.js.map +1 -1
  106. package/dist/components/application-module/overlays/ApplicationFormDialog.js +44 -17
  107. package/dist/components/application-module/overlays/ApplicationFormDialog.js.map +1 -1
  108. package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js +60 -1
  109. package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js.map +1 -1
  110. package/dist/components/application-module/overlays/PeoplePickerDialog.js +70 -25
  111. package/dist/components/application-module/overlays/PeoplePickerDialog.js.map +1 -1
  112. package/dist/components/application-module/statistics/ApplicationMetricChart.js +5 -2
  113. package/dist/components/application-module/statistics/ApplicationMetricChart.js.map +1 -1
  114. package/dist/components/application-module/statistics/ApplicationMetricStrip.js +19 -4
  115. package/dist/components/application-module/statistics/ApplicationMetricStrip.js.map +1 -1
  116. package/dist/components/foundation/actions/ToggleGroup.js +14 -1
  117. package/dist/components/foundation/actions/ToggleGroup.js.map +1 -1
  118. package/dist/components/foundation/data-content-layout/Avatar.js +1 -12
  119. package/dist/components/foundation/data-content-layout/Avatar.js.map +1 -1
  120. package/dist/components/foundation/data-content-layout/Card.js +25 -1
  121. package/dist/components/foundation/data-content-layout/Card.js.map +1 -1
  122. package/dist/components/foundation/data-content-layout/Carousel.js +39 -2
  123. package/dist/components/foundation/data-content-layout/Carousel.js.map +1 -1
  124. package/dist/components/foundation/data-content-layout/Chart.js +13 -8
  125. package/dist/components/foundation/data-content-layout/Chart.js.map +1 -1
  126. package/dist/components/foundation/data-content-layout/Item.js +16 -1
  127. package/dist/components/foundation/data-content-layout/Item.js.map +1 -1
  128. package/dist/components/foundation/data-content-layout/Message.js +17 -0
  129. package/dist/components/foundation/data-content-layout/Message.js.map +1 -1
  130. package/dist/components/foundation/data-content-layout/MessageScroller.js +1 -0
  131. package/dist/components/foundation/data-content-layout/MessageScroller.js.map +1 -1
  132. package/dist/components/foundation/data-content-layout/Progress.js +8 -1
  133. package/dist/components/foundation/data-content-layout/Progress.js.map +1 -1
  134. package/dist/components/foundation/data-content-layout/Resizable.js +62 -15
  135. package/dist/components/foundation/data-content-layout/Resizable.js.map +1 -1
  136. package/dist/components/foundation/data-content-layout/ScrollArea.js +25 -0
  137. package/dist/components/foundation/data-content-layout/ScrollArea.js.map +1 -1
  138. package/dist/components/foundation/data-content-layout/Table.js +112 -71
  139. package/dist/components/foundation/data-content-layout/Table.js.map +1 -1
  140. package/dist/components/foundation/feedback-overlay/AlertDialog.js +18 -7
  141. package/dist/components/foundation/feedback-overlay/AlertDialog.js.map +1 -1
  142. package/dist/components/foundation/feedback-overlay/Dialog.js +25 -6
  143. package/dist/components/foundation/feedback-overlay/Dialog.js.map +1 -1
  144. package/dist/components/foundation/feedback-overlay/Drawer.js +4 -3
  145. package/dist/components/foundation/feedback-overlay/Drawer.js.map +1 -1
  146. package/dist/components/foundation/feedback-overlay/DropdownMenu.js +40 -6
  147. package/dist/components/foundation/feedback-overlay/DropdownMenu.js.map +1 -1
  148. package/dist/components/foundation/feedback-overlay/HoverCard.js +8 -0
  149. package/dist/components/foundation/feedback-overlay/HoverCard.js.map +1 -1
  150. package/dist/components/foundation/feedback-overlay/Popover.js +80 -28
  151. package/dist/components/foundation/feedback-overlay/Popover.js.map +1 -1
  152. package/dist/components/foundation/feedback-overlay/Sheet.js +4 -3
  153. package/dist/components/foundation/feedback-overlay/Sheet.js.map +1 -1
  154. package/dist/components/foundation/feedback-overlay/Sonner.js +1 -1
  155. package/dist/components/foundation/feedback-overlay/Sonner.js.map +1 -1
  156. package/dist/components/foundation/feedback-overlay/SonnerProvider.js +37 -0
  157. package/dist/components/foundation/feedback-overlay/SonnerProvider.js.map +1 -0
  158. package/dist/components/foundation/feedback-overlay/Tooltip.js +2 -0
  159. package/dist/components/foundation/feedback-overlay/Tooltip.js.map +1 -1
  160. package/dist/components/foundation/input-selection/Calendar.js +120 -23
  161. package/dist/components/foundation/input-selection/Calendar.js.map +1 -1
  162. package/dist/components/foundation/input-selection/Checkbox.js +3 -0
  163. package/dist/components/foundation/input-selection/Checkbox.js.map +1 -1
  164. package/dist/components/foundation/input-selection/Combobox.js +58 -6
  165. package/dist/components/foundation/input-selection/Combobox.js.map +1 -1
  166. package/dist/components/foundation/input-selection/DateInput.js +70 -0
  167. package/dist/components/foundation/input-selection/DateInput.js.map +1 -0
  168. package/dist/components/foundation/input-selection/Field.js +7 -2
  169. package/dist/components/foundation/input-selection/Field.js.map +1 -1
  170. package/dist/components/foundation/input-selection/Input.js +5 -1
  171. package/dist/components/foundation/input-selection/Input.js.map +1 -1
  172. package/dist/components/foundation/input-selection/InputGroup.js +2 -0
  173. package/dist/components/foundation/input-selection/InputGroup.js.map +1 -1
  174. package/dist/components/foundation/input-selection/InputOTP.js +3 -1
  175. package/dist/components/foundation/input-selection/InputOTP.js.map +1 -1
  176. package/dist/components/foundation/input-selection/NativeSelect.js.map +1 -1
  177. package/dist/components/foundation/input-selection/RadioGroup.js +3 -0
  178. package/dist/components/foundation/input-selection/RadioGroup.js.map +1 -1
  179. package/dist/components/foundation/input-selection/Select.js +30 -4
  180. package/dist/components/foundation/input-selection/Select.js.map +1 -1
  181. package/dist/components/foundation/input-selection/Switch.js +9 -3
  182. package/dist/components/foundation/input-selection/Switch.js.map +1 -1
  183. package/dist/components/foundation/input-selection/Textarea.js.map +1 -1
  184. package/dist/components/foundation/navigation-command/Accordion.js +21 -3
  185. package/dist/components/foundation/navigation-command/Accordion.js.map +1 -1
  186. package/dist/components/foundation/navigation-command/Breadcrumb.js +3 -4
  187. package/dist/components/foundation/navigation-command/Breadcrumb.js.map +1 -1
  188. package/dist/components/foundation/navigation-command/Command.js +85 -33
  189. package/dist/components/foundation/navigation-command/Command.js.map +1 -1
  190. package/dist/components/foundation/navigation-command/ContextMenu.js +73 -14
  191. package/dist/components/foundation/navigation-command/ContextMenu.js.map +1 -1
  192. package/dist/components/foundation/navigation-command/Menubar.js +114 -25
  193. package/dist/components/foundation/navigation-command/Menubar.js.map +1 -1
  194. package/dist/components/foundation/navigation-command/NavigationMenu.js +68 -9
  195. package/dist/components/foundation/navigation-command/NavigationMenu.js.map +1 -1
  196. package/dist/components/foundation/navigation-command/Pagination.js +11 -5
  197. package/dist/components/foundation/navigation-command/Pagination.js.map +1 -1
  198. package/dist/components/foundation/navigation-command/Sidebar.js +43 -24
  199. package/dist/components/foundation/navigation-command/Sidebar.js.map +1 -1
  200. package/dist/components/foundation/navigation-command/Tabs.js +57 -35
  201. package/dist/components/foundation/navigation-command/Tabs.js.map +1 -1
  202. package/dist/icon/Icon.js +2 -1
  203. package/dist/icon/Icon.js.map +1 -1
  204. package/dist/icon/glyphs.js +11 -1
  205. package/dist/icon/glyphs.js.map +1 -1
  206. package/dist/index.js +8 -1
  207. package/dist/index.js.map +1 -1
  208. package/dist/internal/CloseButton.js +7 -1
  209. package/dist/internal/CloseButton.js.map +1 -1
  210. package/dist/internal/FieldAssociation.js +39 -0
  211. package/dist/internal/FieldAssociation.js.map +1 -0
  212. package/dist/internal/Overlay.js +42 -8
  213. package/dist/internal/Overlay.js.map +1 -1
  214. package/dist/internal/date.js +8 -0
  215. package/dist/internal/date.js.map +1 -1
  216. package/dist/internal/escape-stack.js +17 -0
  217. package/dist/internal/escape-stack.js.map +1 -0
  218. package/dist/internal/focus.js +5 -1
  219. package/dist/internal/focus.js.map +1 -1
  220. package/dist/internal/initials.js +18 -0
  221. package/dist/internal/initials.js.map +1 -0
  222. package/dist/internal/row-activation.js +43 -0
  223. package/dist/internal/row-activation.js.map +1 -0
  224. package/dist/internal/state-slot.js +22 -0
  225. package/dist/internal/state-slot.js.map +1 -0
  226. package/dist/internal/use-dismiss.js +50 -6
  227. package/dist/internal/use-dismiss.js.map +1 -1
  228. package/dist/internal/use-list-navigation.js +10 -4
  229. package/dist/internal/use-list-navigation.js.map +1 -1
  230. package/dist/internal/use-modal.js +18 -3
  231. package/dist/internal/use-modal.js.map +1 -1
  232. package/dist/internal/use-roving-focus.js +94 -0
  233. package/dist/internal/use-roving-focus.js.map +1 -0
  234. package/dist/styles.css +5606 -4391
  235. package/dist/tokens.css +165 -70
  236. package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts +36 -0
  237. package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts.map +1 -0
  238. package/dist-types/contracts/application-atomic/list-table-pagination.d.ts +15 -4
  239. package/dist-types/contracts/application-atomic/list-table-pagination.d.ts.map +1 -1
  240. package/dist-types/contracts/application-atomic/search-field.d.ts +1 -1
  241. package/dist-types/contracts/application-atomic/system-button.d.ts +28 -9
  242. package/dist-types/contracts/application-atomic/system-button.d.ts.map +1 -1
  243. package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts +31 -1
  244. package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts.map +1 -1
  245. package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts +22 -1
  246. package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts.map +1 -1
  247. package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts +34 -0
  248. package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts.map +1 -1
  249. package/dist-types/contracts/application-module/content/application-data-display.d.ts +21 -1
  250. package/dist-types/contracts/application-module/content/application-data-display.d.ts.map +1 -1
  251. package/dist-types/contracts/application-module/content/application-filter-list.d.ts +2 -2
  252. package/dist-types/contracts/application-module/content/application-page-header.d.ts +51 -6
  253. package/dist-types/contracts/application-module/content/application-page-header.d.ts.map +1 -1
  254. package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts +13 -0
  255. package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts.map +1 -1
  256. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts +68 -16
  257. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts.map +1 -1
  258. package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts +12 -3
  259. package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts.map +1 -1
  260. package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts +9 -3
  261. package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts.map +1 -1
  262. package/dist-types/contracts/application-module/lists/application-record-list.d.ts +10 -5
  263. package/dist-types/contracts/application-module/lists/application-record-list.d.ts.map +1 -1
  264. package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts +13 -10
  265. package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts.map +1 -1
  266. package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts +62 -17
  267. package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts.map +1 -1
  268. package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts +43 -6
  269. package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts.map +1 -1
  270. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts +1 -1
  271. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts.map +1 -1
  272. package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts +45 -12
  273. package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts.map +1 -1
  274. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts +14 -4
  275. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts.map +1 -1
  276. package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts +30 -7
  277. package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts.map +1 -1
  278. package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts +23 -6
  279. package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts.map +1 -1
  280. package/dist-types/contracts/application-module/statistics/metrics.d.ts +32 -3
  281. package/dist-types/contracts/application-module/statistics/metrics.d.ts.map +1 -1
  282. package/dist-types/contracts/foundation/actions/button.d.ts +10 -6
  283. package/dist-types/contracts/foundation/actions/button.d.ts.map +1 -1
  284. package/dist-types/contracts/foundation/actions/toggle.d.ts +3 -3
  285. package/dist-types/contracts/foundation/actions/toggle.d.ts.map +1 -1
  286. package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts +4 -2
  287. package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts.map +1 -1
  288. package/dist-types/contracts/foundation/data-content-layout/badge.d.ts +6 -4
  289. package/dist-types/contracts/foundation/data-content-layout/badge.d.ts.map +1 -1
  290. package/dist-types/contracts/foundation/data-content-layout/card.d.ts +6 -2
  291. package/dist-types/contracts/foundation/data-content-layout/card.d.ts.map +1 -1
  292. package/dist-types/contracts/foundation/data-content-layout/chart.d.ts +17 -7
  293. package/dist-types/contracts/foundation/data-content-layout/chart.d.ts.map +1 -1
  294. package/dist-types/contracts/foundation/data-content-layout/message-scroller.d.ts +4 -4
  295. package/dist-types/contracts/foundation/data-content-layout/progress.d.ts +5 -1
  296. package/dist-types/contracts/foundation/data-content-layout/progress.d.ts.map +1 -1
  297. package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts +19 -10
  298. package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts.map +1 -1
  299. package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts +2 -1
  300. package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts.map +1 -1
  301. package/dist-types/contracts/foundation/data-content-layout/separator.d.ts +1 -1
  302. package/dist-types/contracts/foundation/data-content-layout/separator.d.ts.map +1 -1
  303. package/dist-types/contracts/foundation/data-content-layout/table.d.ts +24 -2
  304. package/dist-types/contracts/foundation/data-content-layout/table.d.ts.map +1 -1
  305. package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts +8 -3
  306. package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts.map +1 -1
  307. package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts +5 -4
  308. package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts.map +1 -1
  309. package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts +20 -3
  310. package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts.map +1 -1
  311. package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts +1 -1
  312. package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts.map +1 -1
  313. package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts +4 -0
  314. package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts.map +1 -1
  315. package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts +15 -2
  316. package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts.map +1 -1
  317. package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts +4 -2
  318. package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts.map +1 -1
  319. package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts +31 -0
  320. package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts.map +1 -0
  321. package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts +4 -1
  322. package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts.map +1 -1
  323. package/dist-types/contracts/foundation/icon/icon-name.d.ts +8 -0
  324. package/dist-types/contracts/foundation/icon/icon-name.d.ts.map +1 -0
  325. package/dist-types/contracts/foundation/icon/icon.d.ts +15 -2
  326. package/dist-types/contracts/foundation/icon/icon.d.ts.map +1 -1
  327. package/dist-types/contracts/foundation/input-selection/calendar.d.ts +13 -1
  328. package/dist-types/contracts/foundation/input-selection/calendar.d.ts.map +1 -1
  329. package/dist-types/contracts/foundation/input-selection/checkbox.d.ts +5 -0
  330. package/dist-types/contracts/foundation/input-selection/checkbox.d.ts.map +1 -1
  331. package/dist-types/contracts/foundation/input-selection/combobox.d.ts +6 -1
  332. package/dist-types/contracts/foundation/input-selection/combobox.d.ts.map +1 -1
  333. package/dist-types/contracts/foundation/input-selection/date-input.d.ts +32 -0
  334. package/dist-types/contracts/foundation/input-selection/date-input.d.ts.map +1 -0
  335. package/dist-types/contracts/foundation/input-selection/field.d.ts +14 -1
  336. package/dist-types/contracts/foundation/input-selection/field.d.ts.map +1 -1
  337. package/dist-types/contracts/foundation/input-selection/input-group.d.ts +9 -0
  338. package/dist-types/contracts/foundation/input-selection/input-group.d.ts.map +1 -1
  339. package/dist-types/contracts/foundation/input-selection/input-otp.d.ts +5 -0
  340. package/dist-types/contracts/foundation/input-selection/input-otp.d.ts.map +1 -1
  341. package/dist-types/contracts/foundation/input-selection/input.d.ts +2 -2
  342. package/dist-types/contracts/foundation/input-selection/radio-group.d.ts +6 -0
  343. package/dist-types/contracts/foundation/input-selection/radio-group.d.ts.map +1 -1
  344. package/dist-types/contracts/foundation/input-selection/select.d.ts +4 -1
  345. package/dist-types/contracts/foundation/input-selection/select.d.ts.map +1 -1
  346. package/dist-types/contracts/foundation/input-selection/switch.d.ts +8 -0
  347. package/dist-types/contracts/foundation/input-selection/switch.d.ts.map +1 -1
  348. package/dist-types/contracts/foundation/navigation-command/command.d.ts +19 -3
  349. package/dist-types/contracts/foundation/navigation-command/command.d.ts.map +1 -1
  350. package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts +5 -0
  351. package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts.map +1 -1
  352. package/dist-types/contracts/foundation/navigation-command/menubar.d.ts +5 -0
  353. package/dist-types/contracts/foundation/navigation-command/menubar.d.ts.map +1 -1
  354. package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts +9 -0
  355. package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts.map +1 -1
  356. package/dist-types/contracts/foundation/navigation-command/pagination.d.ts +8 -4
  357. package/dist-types/contracts/foundation/navigation-command/pagination.d.ts.map +1 -1
  358. package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts +2 -1
  359. package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts.map +1 -1
  360. package/dist-types/contracts/foundation/navigation-command/tabs.d.ts +12 -1
  361. package/dist-types/contracts/foundation/navigation-command/tabs.d.ts.map +1 -1
  362. package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts +13 -0
  363. package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts.map +1 -0
  364. package/dist-types/src/components/application-atomic/ListTablePagination.d.ts +12 -10
  365. package/dist-types/src/components/application-atomic/ListTablePagination.d.ts.map +1 -1
  366. package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts +5 -0
  367. package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts.map +1 -1
  368. package/dist-types/src/components/application-atomic/SystemButton.d.ts +16 -1
  369. package/dist-types/src/components/application-atomic/SystemButton.d.ts.map +1 -1
  370. package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts +11 -1
  371. package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts.map +1 -1
  372. package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts +5 -1
  373. package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts.map +1 -1
  374. package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts +10 -1
  375. package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts.map +1 -1
  376. package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts +4 -1
  377. package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts.map +1 -1
  378. package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts +12 -4
  379. package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts.map +1 -1
  380. package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts +10 -1
  381. package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts.map +1 -1
  382. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts +9 -3
  383. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts.map +1 -1
  384. package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts +1 -10
  385. package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts.map +1 -1
  386. package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts +14 -1
  387. package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts.map +1 -1
  388. package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts +22 -2
  389. package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts.map +1 -1
  390. package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts +19 -3
  391. package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts.map +1 -1
  392. package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts +14 -10
  393. package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts.map +1 -1
  394. package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts +13 -3
  395. package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts.map +1 -1
  396. package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts +19 -5
  397. package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts.map +1 -1
  398. package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts +13 -4
  399. package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts.map +1 -1
  400. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts +9 -2
  401. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts.map +1 -1
  402. package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts +26 -3
  403. package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts.map +1 -1
  404. package/dist-types/src/components/application-module/overlays/PeoplePickerDialog.d.ts.map +1 -1
  405. package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts +3 -0
  406. package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts.map +1 -1
  407. package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts +9 -3
  408. package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts.map +1 -1
  409. package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts +4 -0
  410. package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts.map +1 -1
  411. package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts +7 -0
  412. package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts.map +1 -1
  413. package/dist-types/src/components/foundation/data-content-layout/Card.d.ts +9 -0
  414. package/dist-types/src/components/foundation/data-content-layout/Card.d.ts.map +1 -1
  415. package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts +11 -2
  416. package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts.map +1 -1
  417. package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts +15 -2
  418. package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts.map +1 -1
  419. package/dist-types/src/components/foundation/data-content-layout/Item.d.ts +5 -0
  420. package/dist-types/src/components/foundation/data-content-layout/Item.d.ts.map +1 -1
  421. package/dist-types/src/components/foundation/data-content-layout/Message.d.ts +6 -1
  422. package/dist-types/src/components/foundation/data-content-layout/Message.d.ts.map +1 -1
  423. package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts +7 -1
  424. package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts.map +1 -1
  425. package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts +7 -1
  426. package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts.map +1 -1
  427. package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts +10 -0
  428. package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts.map +1 -1
  429. package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts +9 -2
  430. package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts.map +1 -1
  431. package/dist-types/src/components/foundation/data-content-layout/Table.d.ts +18 -5
  432. package/dist-types/src/components/foundation/data-content-layout/Table.d.ts.map +1 -1
  433. package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts +12 -0
  434. package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts.map +1 -1
  435. package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts +10 -1
  436. package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts.map +1 -1
  437. package/dist-types/src/components/foundation/feedback-overlay/Drawer.d.ts.map +1 -1
  438. package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts +6 -1
  439. package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts.map +1 -1
  440. package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts +5 -0
  441. package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts.map +1 -1
  442. package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts +23 -1
  443. package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts.map +1 -1
  444. package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts +2 -1
  445. package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts.map +1 -1
  446. package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts +3 -0
  447. package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts.map +1 -1
  448. package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts +21 -0
  449. package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts.map +1 -0
  450. package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts +4 -0
  451. package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts.map +1 -1
  452. package/dist-types/src/components/foundation/input-selection/Calendar.d.ts +17 -1
  453. package/dist-types/src/components/foundation/input-selection/Calendar.d.ts.map +1 -1
  454. package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts +5 -1
  455. package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts.map +1 -1
  456. package/dist-types/src/components/foundation/input-selection/Combobox.d.ts +18 -2
  457. package/dist-types/src/components/foundation/input-selection/Combobox.d.ts.map +1 -1
  458. package/dist-types/src/components/foundation/input-selection/DateInput.d.ts +13 -0
  459. package/dist-types/src/components/foundation/input-selection/DateInput.d.ts.map +1 -0
  460. package/dist-types/src/components/foundation/input-selection/Field.d.ts +7 -1
  461. package/dist-types/src/components/foundation/input-selection/Field.d.ts.map +1 -1
  462. package/dist-types/src/components/foundation/input-selection/Input.d.ts +9 -1
  463. package/dist-types/src/components/foundation/input-selection/Input.d.ts.map +1 -1
  464. package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts +6 -1
  465. package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts.map +1 -1
  466. package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts +4 -1
  467. package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts.map +1 -1
  468. package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts +6 -1
  469. package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts.map +1 -1
  470. package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts +4 -1
  471. package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts.map +1 -1
  472. package/dist-types/src/components/foundation/input-selection/Select.d.ts +8 -1
  473. package/dist-types/src/components/foundation/input-selection/Select.d.ts.map +1 -1
  474. package/dist-types/src/components/foundation/input-selection/Switch.d.ts +7 -1
  475. package/dist-types/src/components/foundation/input-selection/Switch.d.ts.map +1 -1
  476. package/dist-types/src/components/foundation/input-selection/Textarea.d.ts +6 -1
  477. package/dist-types/src/components/foundation/input-selection/Textarea.d.ts.map +1 -1
  478. package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts +5 -0
  479. package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts.map +1 -1
  480. package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts +3 -0
  481. package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts.map +1 -1
  482. package/dist-types/src/components/foundation/navigation-command/Command.d.ts +15 -2
  483. package/dist-types/src/components/foundation/navigation-command/Command.d.ts.map +1 -1
  484. package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts +15 -5
  485. package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts.map +1 -1
  486. package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts +12 -1
  487. package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts.map +1 -1
  488. package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts +19 -2
  489. package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts.map +1 -1
  490. package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts +9 -1
  491. package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts.map +1 -1
  492. package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts +5 -0
  493. package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts.map +1 -1
  494. package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts +14 -3
  495. package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts.map +1 -1
  496. package/dist-types/src/icon/Icon.d.ts +2 -2
  497. package/dist-types/src/icon/Icon.d.ts.map +1 -1
  498. package/dist-types/src/icon/glyphs.d.ts +7 -3
  499. package/dist-types/src/icon/glyphs.d.ts.map +1 -1
  500. package/dist-types/src/index.d.ts +11 -5
  501. package/dist-types/src/index.d.ts.map +1 -1
  502. package/dist-types/src/internal/CloseButton.d.ts +11 -1
  503. package/dist-types/src/internal/CloseButton.d.ts.map +1 -1
  504. package/dist-types/src/internal/FieldAssociation.d.ts +33 -0
  505. package/dist-types/src/internal/FieldAssociation.d.ts.map +1 -0
  506. package/dist-types/src/internal/Overlay.d.ts +20 -2
  507. package/dist-types/src/internal/Overlay.d.ts.map +1 -1
  508. package/dist-types/src/internal/date.d.ts +2 -0
  509. package/dist-types/src/internal/date.d.ts.map +1 -1
  510. package/dist-types/src/internal/escape-stack.d.ts +4 -0
  511. package/dist-types/src/internal/escape-stack.d.ts.map +1 -0
  512. package/dist-types/src/internal/focus.d.ts +10 -1
  513. package/dist-types/src/internal/focus.d.ts.map +1 -1
  514. package/dist-types/src/internal/initials.d.ts +17 -0
  515. package/dist-types/src/internal/initials.d.ts.map +1 -0
  516. package/dist-types/src/internal/row-activation.d.ts +13 -0
  517. package/dist-types/src/internal/row-activation.d.ts.map +1 -0
  518. package/dist-types/src/internal/state-slot.d.ts +19 -0
  519. package/dist-types/src/internal/state-slot.d.ts.map +1 -0
  520. package/dist-types/src/internal/use-dismiss.d.ts +36 -3
  521. package/dist-types/src/internal/use-dismiss.d.ts.map +1 -1
  522. package/dist-types/src/internal/use-list-navigation.d.ts +7 -1
  523. package/dist-types/src/internal/use-list-navigation.d.ts.map +1 -1
  524. package/dist-types/src/internal/use-modal.d.ts.map +1 -1
  525. package/dist-types/src/internal/use-roving-focus.d.ts +49 -0
  526. package/dist-types/src/internal/use-roving-focus.d.ts.map +1 -0
  527. package/mappings.json +4 -4
  528. package/package.json +3 -3
  529. package/tokens.json +490 -128
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-*` 别名层,本库不提供这种用法。
@@ -0,0 +1,43 @@
1
+ import type { HTMLAttributes, ReactNode } from 'react'
2
+
3
+ /** 日期区间。两端均为本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限 */
4
+ export interface DateRangeValue {
5
+ /** 起始日期(含) */
6
+ start?: string
7
+ /** 结束日期(含) */
8
+ end?: string
9
+ }
10
+
11
+ /**
12
+ * 查询工具栏主控制行中的**日期区间**快捷筛选,与 `ApplicationFilterMenu` 同为一个
13
+ * 常驻维度,放进 `ApplicationQueryToolbar` 的 `commonFilters`。
14
+ *
15
+ * 触发器与 `ApplicationFilterMenu` 同高同壳,生效时回显「接收时间:2026-07-01 – 2026-07-28」。
16
+ * 面板里是起止两张 `Calendar` 月格,由「应用」提交、「清空」撤销 —— 选到一半不生效。
17
+ *
18
+ * ⚠ **已生效的区间必须回写到工具栏第三行的筛选标签行**(`appliedTags`),且标签可移除。
19
+ * 与 `ApplicationFilterMenu` 同一条规矩:筛选状态只存在于触发器上是不合规的。
20
+ */
21
+ export interface ApplicationDateRangeFilterProps
22
+ extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
23
+ /** 维度名称,显示在触发器上,如「接收时间」 */
24
+ label: ReactNode
25
+
26
+ /**
27
+ * 维度名称的纯文本,用于触发器回显与可访问名。
28
+ * `label` 为非字符串时**必须**提供,否则回显为 `[object Object]`。
29
+ */
30
+ labelText?: string
31
+
32
+ /** 受控值。两端都缺省即未生效 */
33
+ value?: DateRangeValue
34
+
35
+ /** 「应用」提交时的回调。「清空」提交 `{}` */
36
+ onValueChange?: (value: DateRangeValue) => void
37
+
38
+ /** 禁用 */
39
+ disabled?: boolean
40
+
41
+ /** 「今天」,透传给两张 `Calendar` */
42
+ today?: Date
43
+ }
@@ -1,13 +1,19 @@
1
1
  import type { HTMLAttributes } from 'react'
2
2
 
3
3
  /**
4
- * 列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。
4
+ * 列表 / 表格分页 —— 摘要、每页条数、页码窗口与跳页。
5
5
  * 数据展示区的标准页脚,LIST 页面模式的默认配置。
6
6
  *
7
- * ⚠ **分页语义必须跨 Page Mode 与 Business View 切换存活**,
8
- * 从详情返回时也必须还原 —— 规范要求恢复来源上下文。
7
+ * 形态按 GAP Design kit「分页行」(业财平台 round-01 · pagination/structure 裁决,2026-11-10):
8
+ * 左侧摘要「每页 N 条,共 Z 条数据」12/20 三级文字色,右侧依次为每页条数选择器、
9
+ * Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,
10
+ * 控件一律 32 高、圆角 12、间隔 4。**本组件包含 `Pagination`**,两者不再是替代关系。
9
11
  *
10
- * 没有总数与每页条数需求时,用 Foundation `Pagination`。
12
+ * ⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,
13
+ * 切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。
14
+ * 搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。
15
+ *
16
+ * 没有总数与每页条数需求时,直接用 Foundation `Pagination`。
11
17
  */
12
18
  export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement> {
13
19
  /** 当前页码,从 1 开始 */
@@ -22,6 +28,12 @@ export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement>
22
28
  /** 每页条数的可选值 */
23
29
  pageSizeOptions?: number[]
24
30
 
31
+ /**
32
+ * 是否显示「第 [ ] 页」跳页框,默认 `true`(kit 分页行恒有)。回车提交,越界时夹到
33
+ * 1 与总页数之间,提交后清空。总页数很少、跳页没有意义时可传 `false`
34
+ */
35
+ showJumper?: boolean
36
+
25
37
  /** 页码变化回调 */
26
38
  onPageChange?: (page: number) => void
27
39
 
@@ -32,16 +44,17 @@ export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement>
32
44
  /*
33
45
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
34
46
  *
35
- * T6 未复用 Foundation Pagination,页码窗口能力丢失。
47
+ * T6 ✅ 业财平台 round-01 起内部复用 Pagination 渲染页码区。
36
48
  * 源实现只提供「上一页 / 当前页 / 下一页」步进,
37
49
  * 而 Foundation Pagination 有完整的页码窗口(首页 + 当前 ±1 + 末页 + 省略号)。
38
50
  * 在 1284 条 / 每页 20 条 = 65 页的场景下,用户只能一页页点。
39
51
  * 裁决:实现阶段内部复用 Pagination 渲染页码区,
40
52
  * 本组件只额外承载结果区间、总数与每页条数选择器。
53
+ * 此前实现以「两份契约写的是替代关系」为由未做,round-01 按 kit 分页行补齐,另加跳页框。
41
54
  *
42
55
  * T7 未复用 NativeSelect,内联写了原生 <select>。
43
56
  * 与 I4 / D1 / F3 同类。改用 NativeSelect。
44
57
  *
45
- * I16 中文硬编码:「第 X–Y 条 / 共 Z 条」「上一页」「下一页」
46
- * 「每页条数」「N 条/页」。数量与格式均无法覆盖。
58
+ * I16 中文硬编码:「每页 N 条,共 Z 条数据」「每页 N 条」「第 … 页」「请输入」,
59
+ * 以及 Pagination 的四个步进名。数量与格式均无法覆盖。
47
60
  */
@@ -4,7 +4,7 @@ import type { ChangeEvent, HTMLAttributes, InputHTMLAttributes } from 'react'
4
4
  * 共享的紧凑搜索入口 —— **产品内每一处纯文本搜索**:
5
5
  * 查询工具栏、目录搜索、人员与文件选择器。
6
6
  *
7
- * 32px 最小高度,16px 圆角,焦点只在外壳表达一次。
7
+ * 32px 最小高度,12px 圆角,白底 1px 描边(GAP Design kit「表单/输入」),焦点只在外壳表达一次。
8
8
  *
9
9
  * ⚠ **只在 Enter 时提交。** 规范禁止逐字实时搜索作为默认行为。
10
10
  *
@@ -9,25 +9,45 @@ 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
+ * 删除类动作两档:`destructive-outline`(白底、危险色描边与文字)用于与次要按钮
22
+ * 并排出现的删除,例如表单里「删除此附件」;`destructive`(实心危险色)只用于
23
+ * 确认弹窗里那个不可逆的最终动作。同一动作组内不得同时出现两档。
24
+ */
25
+ intent?: 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive' | 'destructive-outline'
26
+
27
+ /**
28
+ * 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。
29
+ * `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作
30
+ * (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。
18
31
  */
19
- intent?: 'primary' | 'secondary' | 'quiet' | 'icon' | 'link' | 'destructive'
32
+ size?: 'default' | 'compact' | 'sm'
20
33
 
21
- /** 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异 */
22
- size?: 'default' | 'compact' | 'icon'
34
+ /**
35
+ * 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation
36
+ * `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。
37
+ */
38
+ iconOnly?: boolean
23
39
 
24
40
  /**
25
- * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈。
26
- * 与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
41
+ * 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈
42
+ * 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。
43
+ *
44
+ * 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中
45
+ * `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦,
46
+ * 焦点不会在点击后掉到 `<body>`。
27
47
  */
28
48
  loading?: boolean
29
49
 
30
- /** 纯图标按钮(`intent="icon"` 或 `size="icon"`)**必须**提供 `aria-label` */
50
+ /** 按钮内容。`iconOnly` 时为单个 `Icon` 元素 */
31
51
  children?: ReactNode
32
52
  }
33
53
 
@@ -51,8 +71,10 @@ export interface SystemButtonProps extends ButtonHTMLAttributes<HTMLButtonElemen
51
71
  * T3 内联注入 @keyframes(loading 转圈),与 D9 / F14 同型,这是第 3 处。
52
72
  *
53
73
  * ── 连锁影响 ──
54
- * A1 采纳后 Foundation Button 的 size 拆为 size + iconOnly,
55
- * 本组件的 intent/size → Button props 映射需同步改写。
74
+ * A1 采纳后 Foundation Button 的 size 拆为 size + iconOnly。本组件原有的
75
+ * `intent="icon"` 与 `size="icon"` 正是反例「发明不存在的 prop」点名的 shadcn 写法,
76
+ * 业务页面一律改用本组件后两层的图标按钮写法不能再互相否定 —— 已移除两者,
77
+ * 改为与 Button 同名同义的 `iconOnly`(实践报告 P1-1)。
56
78
  *
57
79
  * ── 正面记录 ──
58
80
  * 本组件是迄今**唯一正确复用了 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
  *
@@ -1,16 +1,35 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
+ /** 页头中部的任务状态胶囊 */
4
+ export interface ApplicationPageHeaderTaskStatus {
5
+ /** 胶囊文案,如「正在识别 14/100」 */
6
+ label: ReactNode
7
+ /** 任务进行中。为 true 时胶囊前带转圈,任务结束后改为 false 或移除整个 `taskStatus` */
8
+ busy?: boolean
9
+ }
10
+
3
11
  /** Canvas 五层模型的 L2 页面模式 */
4
12
  export type PageMode = 'LIST' | 'CARD' | 'SPLIT' | 'BOARD' | 'CALENDAR'
5
13
 
6
14
  /**
7
15
  * Canvas 的**上下文区**(源仓库名 `application-page-header`)。
8
16
  *
9
- * 左侧:品牌强调色条 · 16px 标题 · 数据状态 + 刷新。
17
+ * 左侧:可选的「返回」· 16px 标题 · 竖线 · 更新时间与刷新。中部:可选的任务状态胶囊(`taskStatus`)。
10
18
  * 右侧:页面动作组,再经分隔线之后是**页面级的 Page Mode Switch**。
11
19
  *
20
+ * 左侧按 GAP Design kit「数据更新」(业财平台 round-01 裁决,2026-11-10):
21
+ * - 二级页面以「返回」幽灵按钮(16px chevron + 文字,32 高、左右 12、圆角 12)开头,
22
+ * 与标题间隔 8 —— 传 `onBack` 即渲染
23
+ * - 标题之后是一条 12px 高的竖线,再接更新时间:完整日期时间(`2026-07-28 10:00`)
24
+ * 14/20 文字1,不加「更新于」前缀;传了 `onRefresh` 时时间与其后的 16px 刷新字形
25
+ * 合成一枚幽灵按钮(32 高、左右 12、圆角 12),点它即刷新
26
+ *
27
+ * 外观(GAP Design kit,业财平台 round-01):48px 高的通栏,落在页面底色上、只有一条
28
+ * 0.5px 下边线,不是卡片。放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时
29
+ * 向两侧与顶部吃掉页面留白,贴满内容区宽度。此前左侧的 3×16 强调色条已移除。
30
+ *
12
31
  * ### 允许出现在这里
13
- * 新建 / 导入 / 导出 / 更多、刷新、面包屑、Page Mode Switch。
32
+ * 新建 / 导入 / 导出 / 更多、刷新、返回、面包屑、Page Mode Switch。
14
33
  *
15
34
  * ### ⚠ 禁止出现在这里
16
35
  * **搜索、常用筛选、排序、SPLIT 视图模式切换、列设置、行级或批量动作。**
@@ -25,7 +44,7 @@ export type PageMode = 'LIST' | 'CARD' | 'SPLIT' | 'BOARD' | 'CALENDAR'
25
44
  * 刷新**只更新数据**,绝不重置业务视图、搜索、筛选、排序或页面模式。
26
45
  */
27
46
  export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
28
- /** 页面标题,16/24 medium 字重,超长省略 */
47
+ /** 页面标题,16/32 regular 字重,超长省略 */
29
48
  title?: ReactNode
30
49
 
31
50
  /** 副标题,紧随标题以 12px label 色显示 */
@@ -34,12 +53,39 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
34
53
  /** 数据状态。决定状态文案与刷新按钮的可用性 */
35
54
  dataStatus?: 'normal' | 'refreshing' | 'failed'
36
55
 
37
- /** 最后更新时刻,仅在 `normal` 状态显示为「更新于 …」 */
56
+ /**
57
+ * 数据更新时间,写完整日期时间 `YYYY-MM-DD HH:mm`(如 `2026-07-28 10:00`),原样显示、
58
+ * 不加前缀(GAP Design kit「数据更新」;推翻 07 · C-12 的「只写 HH:mm」)。
59
+ * 仅在 `normal` 状态显示;`refreshing` / `failed` 显示「刷新中」/「刷新失败」
60
+ */
38
61
  updatedAt?: string
39
62
 
40
- /** 刷新回调。`refreshing` 状态下按钮禁用 */
63
+ /**
64
+ * 刷新回调。提供时更新时间与刷新字形合成一枚按钮,`refreshing` 状态下不可点、字形转圈。
65
+ * **未提供时不渲染刷新字形,时间按纯文字显示** —— 没有刷新能力的页面(草稿、向导、
66
+ * 一次性结果)不得出现一个点了没反应的按钮。状态文案(时间 / 刷新中 / 刷新失败)不受影响。
67
+ */
41
68
  onRefresh?: () => void
42
69
 
70
+ /**
71
+ * 返回回调。提供时标题前渲染「返回」幽灵按钮(kit「数据更新-二级页面」)。
72
+ * 组件不做路由跳转,回到哪里、还原哪些上下文由调用方决定。
73
+ * 与 `breadcrumb` 不得同时传 —— 二级页面用返回,需要展示多级路径时才用面包屑
74
+ */
75
+ onBack?: () => void
76
+
77
+ /** 返回按钮文案,默认「返回」。只在 `onBack` 提供时生效 */
78
+ backLabel?: string
79
+
80
+ /**
81
+ * 页面级进行中任务的状态胶囊,居中显示在页头中部。例如批量识别的「正在识别 14/100」。
82
+ * `busy` 为 true 时胶囊前带转圈。
83
+ *
84
+ * 只表达**本页正在进行的一项任务**的进度;**不得**用它显示数据刷新状态(那是
85
+ * `dataStatus`)、页面说明(那是 `subtitle`)或筛选摘要(那属于 `ApplicationQueryToolbar`)。
86
+ */
87
+ taskStatus?: ApplicationPageHeaderTaskStatus
88
+
43
89
  /** 页面级动作组。**至多一个 primary** */
44
90
  actions?: ReactNode
45
91
 
@@ -52,7 +98,10 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
52
98
  /** 页面模式变化回调 */
53
99
  onPageModeChange?: (mode: PageMode) => void
54
100
 
55
- /** 面包屑。仅当页面确有层级时提供 */
101
+ /**
102
+ * 面包屑。仅当页面需要展示多级路径时提供;单纯「回到上一层」用 `onBack`,两者不得同时传。
103
+ * 面包屑在标题上方另占一行,页头因此高于 48
104
+ */
56
105
  breadcrumb?: ReactNode
57
106
  }
58
107
 
@@ -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