@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
@@ -13,20 +13,25 @@ export interface ModuleItem {
13
13
  /**
14
14
  * 应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。
15
15
  *
16
- * ### 触发器
17
- * Standard 最小宽 168 / 高 40,Compact 148 / 32;
18
- * 深色 32×32 图标块(8px 圆角,18px 白色字形),
19
- * 名称 16/20 **700**,14px chevron 右对齐。
16
+ * ### 触发器(GAP Design kit「应用二级模块切换」)
17
+ * Standard 168×48,Compact 148×40;内边距 4/12,**没有图标块**;
18
+ * 名称 16/20 **medium**,20px chevron 右对齐;右侧 0.5px 分隔线;悬停与展开时 6% 淡底。
20
19
  *
21
20
  * ⚠ **绝不能简化成一个小图标,也绝不能移除。**
22
21
  *
23
22
  * ### 面板
24
- * `position: fixed`,`top: --ui-shell-application-total-height`,
25
- * `left: 0`,`bottom: 0`,宽 392px(受视口限制),白色表面,
26
- * **1px 右边线,无圆角,无阴影**,自带垂直滚动。
27
- * 条目最小高 40,内边距 8/12,圆角 12,文字 14/22。
23
+ * 挂在触发器正下方(`position: absolute`),与触发器同宽 168、最窄 128,
24
+ * 底色为导航背景与表面色各半,内边距 4,条目间隔 2,
25
+ * **1px 右边线,无圆角,无阴影**,限高到视口底、自带垂直滚动。
26
+ * 条目最小高 40,内边距 8/12,圆角 12,文字 14/22;悬停取导航背景;
27
+ * 当前模块为强调色 semibold,右侧 14px 对勾。
28
28
  *
29
29
  * ⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。
30
+ *
31
+ * ### 键盘
32
+ * 按 WAI-ARIA menu button 模式:打开即聚焦首个可用模块(触发器上按 ↑ 打开则聚焦末项),
33
+ * ↑ / ↓ / Home / End 在模块间移动并跳过禁用项,Esc 与外部点击经 `onOpenChange(false)`
34
+ * 收起,Esc 后焦点回到触发器,Tab 收起面板并离开。
30
35
  */
31
36
  export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect'> {
32
37
  /** 触发器上显示的当前模块名 */
@@ -35,8 +40,6 @@ export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttribute
35
40
  modules?: ModuleItem[];
36
41
  /** 当前模块值。点击它不触发 `onSelect` */
37
42
  currentModule?: string;
38
- /** 触发器图标块内的字形,18px */
39
- glyph?: ReactNode;
40
43
  /** 受控面板开合 */
41
44
  open?: boolean;
42
45
  /** 面板开合变化回调 */
@@ -1 +1 @@
1
- {"version":3,"file":"application-module-switcher.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-module-switcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE5D,mBAAmB;AACnB,MAAM,WAAW,UAAU;IACzB,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/G,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,eAAe;IACf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IAEtB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,eAAe;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC"}
1
+ {"version":3,"file":"application-module-switcher.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-module-switcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE5D,mBAAmB;AACnB,MAAM,WAAW,UAAU;IACzB,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/G,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,eAAe;IACf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IAEtB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,eAAe;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC"}
@@ -1,39 +1,84 @@
1
1
  import type { HTMLAttributes } from 'react';
2
+ import type { IconName } from '../../foundation/icon/icon-name.js';
2
3
  /** 五个已登记的全局动作 */
3
4
  export type GlobalActionKey = 'messages' | 'todos' | 'overview' | 'risk' | 'settings';
4
5
  /**
5
- * `APPLICATION.PRIMARY_NAV` —— 固定 Shell 的**第二带**。
6
- * Standard 64px / Compact 52px。
6
+ * 全局动作的承载类型。`'popover'` —— 消息 / 待办 / 总览 / 风险预警四个动作共用的
7
+ * `ApplicationGlobalActionPanel`;`'module'` —— 设置,`ApplicationSecondaryNavigation`
8
+ * 整带换成设置模块(GAP Design kit「框架结构 / 结构=设置」)。
9
+ */
10
+ export type GlobalActionKind = 'popover' | 'module';
11
+ /**
12
+ * 基础版外壳里本带承载的账户入口(GAP Design kit「导航组合 / 基础版本」:用户头像在应用一级
13
+ * 导航的最右端)。集团版外壳的账户入口在 `TopNavigationPrimaryBar`,此时不传本项。
14
+ */
15
+ export interface ApplicationPrimaryNavigationAccount {
16
+ /**
17
+ * 账户名。同时是头像按钮的可访问名与缩写来源,缩写规则与 `Avatar` 相同 ——
18
+ * 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
19
+ */
20
+ name?: string;
21
+ /**
22
+ * 账户面板是否展开。传入(含 `false`)即输出 `aria-haspopup="dialog"` 与 `aria-expanded`;
23
+ * 缺省时两者都不输出。面板内容根应声明 `role="dialog"` 与可访问名
24
+ */
25
+ open?: boolean;
26
+ /**
27
+ * 头像点击回调。参数是被点的触发器,传给 `Popover` 的 `anchor` 锚定;
28
+ * 回调里切换开合并回写 `open`(与 `TopNavigationPrimaryBar.onAccount` 同一接法)
29
+ */
30
+ onToggle?: (trigger: HTMLButtonElement) => void;
31
+ }
32
+ /**
33
+ * `APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。
34
+ * Standard 48px / Compact 40px,内边距 8/12。
35
+ *
36
+ * 外壳有两种形态(kit「导航组合」):
37
+ *
38
+ * | 形态 | 带 | 总高 |
39
+ * |---|---|---:|
40
+ * | 基础版 | 本带 + `ApplicationSecondaryNavigation` | 96 |
41
+ * | 集团版 | `TopNavigationPrimaryBar` + 本带 + `ApplicationSecondaryNavigation` | 144 |
7
42
  *
8
- * **左侧**:应用身份 —— logo 48×48(Compact 40×40)置于 8% 强调色瓦片上,
9
- * 名称 16/24 **700**,说明 12/16 400(Compact 可隐藏)。
43
+ * **左侧**:应用身份 —— 32×32 logo 瓦片(8px 圆角,8% 强调色混入表面色)+ 4px 间隙 +
44
+ * 应用名 14/20 regular 文字1。kit 里没有应用说明行。
10
45
  *
11
46
  * **右侧**:**恰好这五个已登记全局动作,且顺序固定**:
12
47
  *
13
- * 消息 → 待办 → 运行总览 → 风险预警 → 设置
48
+ * 消息 → 待办 → 总览 → 风险预警 → 设置
14
49
  *
15
- * 32×32 触发器,18px 字形,8px 间距。
16
- * 前四个打开共享 Popover,**设置打开 Drawer**。
50
+ * 每个动作是「18px 字形 + 文字」:32 高,左右 10,字形与文字间隔 4,圆角 12,文字 14/20 文字2;
51
+ * 动作之间 4px。前四个打开共享 Popover;**设置不弹浮层**,而是让 `ApplicationSecondaryNavigation`
52
+ * 整带换成设置模块(kit「框架结构 / 结构=设置」:模块切换器显示设置模块名,标签换成设置项,
53
+ * 最右的「导航设置」按钮换成关闭叉号)。
54
+ * 基础版传 `account` 时,头像(24×24 圆形)在动作组之后,间隔 8px。
17
55
  *
18
56
  * ### ⚠ 硬性约束
19
57
  * - **绝不渲染第二个设置入口**
20
58
  * - logo 瓦片是 8% 强调色混入表面色,**绝不是饱和强调色块**
21
- * - Compact 档可隐藏说明,但**必须保留** logo、名称与全部五个动作入口
59
+ * - Compact 档必须保留 logo、名称与全部五个动作入口
22
60
  */
23
61
  export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDivElement> {
24
- /** 应用名称,16/24 700。mock 文案登记为「示例应用」 */
62
+ /** 应用名称,14/20 regular。mock 文案登记为「示例应用」 */
25
63
  appName?: string;
26
- /** 应用说明,12/16 400。mock 文案登记为「应用说明信息」 */
27
- appDescription?: string;
28
- /** 应用 logo mock 字形的图标名(24px) */
29
- appGlyph?: string;
64
+ /**
65
+ * 应用 logo mock 字形的图标名(20px),默认 `'shield-check'`。
66
+ * 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒
67
+ */
68
+ appGlyph?: IconName;
30
69
  /** 当前激活的全局动作面板 */
31
70
  activeAction?: GlobalActionKey;
32
71
  /** 各动作的未读圆点 */
33
72
  actionBadges?: Partial<Record<GlobalActionKey, boolean>>;
34
- /** 动作点击回调。`kind` 指明该动作打开 Popover 还是 Drawer */
35
- onAction?: (key: GlobalActionKey, kind: 'popover' | 'drawer') => void;
36
- /** Compact 档。隐藏应用说明,其余一律保留 */
37
- compact?: boolean;
73
+ /**
74
+ * 动作点击回调。`kind` 指明该动作的承载:`'popover'` 打开共享的 `ApplicationGlobalActionPanel`,
75
+ * `'module'`(只有设置)把 `ApplicationSecondaryNavigation` 换成设置模块
76
+ */
77
+ onAction?: (key: GlobalActionKey, kind: GlobalActionKind) => void;
78
+ /**
79
+ * 基础版外壳的账户入口。传入即在动作组之后渲染头像;集团版外壳(渲染了
80
+ * `TopNavigationPrimaryBar`)不得传,否则一个外壳里会有两个账户入口
81
+ */
82
+ account?: ApplicationPrimaryNavigationAccount;
38
83
  }
39
84
  //# sourceMappingURL=application-primary-navigation.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"application-primary-navigation.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-primary-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAA;AAErF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iCAAkC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvF,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,kBAAkB;IAClB,YAAY,CAAC,EAAE,eAAe,CAAA;IAE9B,eAAe;IACf,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAExD,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAA;IAErE,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}
1
+ {"version":3,"file":"application-primary-navigation.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-primary-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAElE,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAA;AAErF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEnD;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iCAAkC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvF,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,kBAAkB;IAClB,YAAY,CAAC,EAAE,eAAe,CAAA;IAE9B,eAAe;IACf,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAExD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAEjE;;;OAGG;IACH,OAAO,CAAC,EAAE,mCAAmC,CAAA;CAC9C"}
@@ -1,4 +1,4 @@
1
- import type { HTMLAttributes, ReactNode } from 'react';
1
+ import type { HTMLAttributes, MouseEvent, ReactNode } from 'react';
2
2
  /** 二级导航的业务标签 */
3
3
  export interface SecondaryNavTab {
4
4
  /** 标签值 */
@@ -16,17 +16,34 @@ export interface SecondaryNavTab {
16
16
  disabled?: boolean;
17
17
  }
18
18
  /**
19
- * `APPLICATION.SECONDARY_NAV` —— 固定 Shell 的**第三带**。
20
- * Standard 48px / Compact 40px。
19
+ * `APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带
20
+ * (基础版第二带、集团版第三带)。Standard 48px / Compact 40px,右侧内边距 12。
21
21
  *
22
- * **左侧**:完整的模块切换器。**右侧**:当前模块的业务标签。
22
+ * **左侧**:完整的模块切换器,贴左缘。**中间**:当前模块的业务标签,间隔 8。
23
+ * **最右**:一枚已登记的 32×32 纯图标按钮 —— 平时是「导航设置」,设置模块打开时是「关闭设置」。
24
+ *
25
+ * ### 尾部按钮(kit「二级导航设置」24:134 与「结构=设置」230:1104)
26
+ * 32×32、圆角 12、透明底,悬停是 6% 文字色淡底。两种形态互斥,同一时刻至多一枚:
27
+ *
28
+ * | 形态 | 何时渲染 | 字形 | 可访问名 |
29
+ * |---|---|---|---|
30
+ * | 导航设置 | 传了 `onNavigationSettings`,且未传 `onCloseSettings` | 16px `sliders-horizontal`,文字2 | 「导航设置」 |
31
+ * | 关闭设置 | 传了 `onCloseSettings` | 16px 叉号,文字1 | 「关闭设置」 |
32
+ *
33
+ * 两个回调都不传时不渲染,也不占位。
34
+ *
35
+ * ### 设置模块
36
+ * 全局动作「设置」不弹抽屉:它让本带整体换成设置模块 —— `moduleSwitcher` 显示设置模块名,
37
+ * `tabs` 换成设置项,同时传 `onCloseSettings`,尾部按钮随之变为关闭叉号,根元素输出
38
+ * `data-mode="settings"`。关闭时由调用方把模块切换器、标签与 `value` 换回进入设置前的那一组。
23
39
  *
24
40
  * ### ⚠ 每个标签都是「图标 + 文字」
25
41
  * 图标在左、可见文字在右。**纯文字标签被禁止**,
26
42
  * **为适应窄屏而丢弃全部图标同样被禁止** —— 标签保持单行并横向滚动,绝不换行。
27
43
  *
28
- * 标签几何:32px 高,内边距 6/12,文字 14/20。
29
- * 激活态是已登记的 **2px 下划线**,绝不是 pill 背景。
44
+ * 标签几何:32px 高,内边距 6/12,文字 14/20 文字2。
45
+ * 激活态是已登记的 **2px 下划线**(两端各缩进 12,贴标签底边)加强调色 medium 文字,
46
+ * 绝不是 pill 背景;悬停是 6% 文字色淡底、圆角 12,文字不变色。
30
47
  * 图标容器宽度固定,使字重变化不会横向推移文字。
31
48
  *
32
49
  * ### ⚠ 本带不得承载
@@ -43,5 +60,25 @@ export interface ApplicationSecondaryNavigationProps extends HTMLAttributes<HTML
43
60
  value?: string;
44
61
  /** 标签变化回调 */
45
62
  onValueChange?: (value: string) => void;
63
+ /**
64
+ * 「导航设置」按钮的点击回调(kit「二级导航设置」)。传入即在本带最右端渲染该按钮;
65
+ * 不传即不渲染、不占位。参数是点击事件,`event.currentTarget` 即按钮元素,可传给
66
+ * `Popover` 的 `anchor` 锚定面板,也是面板关闭后焦点的归还目标。
67
+ *
68
+ * 设置模块打开时(传了 `onCloseSettings`)本按钮不渲染 —— 那个位置换成关闭叉号
69
+ */
70
+ onNavigationSettings?: (event: MouseEvent<HTMLButtonElement>) => void;
71
+ /**
72
+ * 导航设置面板是否展开。传入(含 `false`)即在按钮上输出 `aria-haspopup="dialog"` 与
73
+ * `aria-expanded`;缺省时两者都不输出。应与 `onNavigationSettings` 成对提供,
74
+ * 面板内容根相应声明 `role="dialog"` 与可访问名
75
+ */
76
+ navigationSettingsOpen?: boolean;
77
+ /**
78
+ * 设置模块的关闭回调(kit「框架结构 / 结构=设置」)。传入即声明本带当前承载的是设置模块:
79
+ * 最右端渲染关闭叉号(可访问名「关闭设置」)取代「导航设置」按钮,根元素输出
80
+ * `data-mode="settings"`。回调里由调用方换回进入设置前的模块切换器、`tabs` 与 `value`
81
+ */
82
+ onCloseSettings?: (event: MouseEvent<HTMLButtonElement>) => void;
46
83
  }
47
84
  //# sourceMappingURL=application-secondary-navigation.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"application-secondary-navigation.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-secondary-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IAEb,0BAA0B;IAC1B,KAAK,EAAE,SAAS,CAAA;IAEhB;;;;;OAKG;IACH,IAAI,EAAE,SAAS,CAAA;IAEf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,2CAA2C;IAC3C,cAAc,CAAC,EAAE,SAAS,CAAA;IAE1B,aAAa;IACb,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IAExB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC"}
1
+ {"version":3,"file":"application-secondary-navigation.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/application-secondary-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAElE,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IAEb,0BAA0B;IAC1B,KAAK,EAAE,SAAS,CAAA;IAEhB;;;;;OAKG;IACH,IAAI,EAAE,SAAS,CAAA;IAEf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,mCAAoC,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzF,2CAA2C;IAC3C,cAAc,CAAC,EAAE,SAAS,CAAA;IAE1B,aAAa;IACb,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IAExB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;IAErE;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;CACjE"}
@@ -30,7 +30,7 @@ export interface GlobalSidebarProps extends HTMLAttributes<HTMLElement> {
30
30
  value?: string;
31
31
  /** 选中变化回调 */
32
32
  onValueChange?: (key: string) => void;
33
- /** 栏底内容 */
33
+ /** 栏底内容。栏底入口(如「设置」)直接放 `SidebarRailButton`(07 · C-15) */
34
34
  footer?: ReactNode;
35
35
  }
36
36
  //# sourceMappingURL=global-sidebar.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"global-sidebar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/global-sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,kBAAkB;AAClB,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAA;IAEX,mBAAmB;IACnB,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB,kCAAkC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,aAAa;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACrE,WAAW;IACX,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAE5B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,WAAW;IACX,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB"}
1
+ {"version":3,"file":"global-sidebar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/global-sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,kBAAkB;AAClB,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAA;IAEX,mBAAmB;IACnB,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB,kCAAkC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,aAAa;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACrE,WAAW;IACX,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAE5B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,yDAAyD;IACzD,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB"}
@@ -1,31 +1,64 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react';
2
2
  /**
3
- * `PLATFORM.TOP_USER_BAR` —— 固定 Shell 的**第一带**。
4
- * Standard 52px / Compact 44px,**没有第三种高度**。
3
+ * `PLATFORM.TOP_USER_BAR` —— GAP Design kit「集团顶部导航」,**只在集团版外壳出现**
4
+ * (本带 + 应用一级 + 应用二级,共 144)。基础版外壳不渲染本组件,账户入口由
5
+ * `ApplicationPrimaryNavigation` 的 `account` 承载。
6
+ * Standard 48px / Compact 40px,**没有第三种高度**;内边距 8/12,底部 0.5px 分隔线。
5
7
  *
6
- * 栅格 `auto minmax(0,1fr) auto`;应用切换与账户触发器 32×32,
7
- * 动作簇间距 10px,右边距 12px。
8
+ * 渲染本组件时,其 CSS 在 `:root` 上把 `--ui-shell-top-bar-offset` 抬到本带高度,
9
+ * `--ui-shell-application-total-height` 随之计入本带 —— 宿主不必区分两种外壳。
10
+ *
11
+ * 栅格 `auto minmax(0,1fr) auto`;应用切换触发器 32×32、圆角 12,账户头像 24×24 圆形
12
+ * (32×32 命中区),动作簇间距 10px,右边距 12px。
8
13
  *
9
14
  * ### ⚠ 品牌标识必须始终可见
10
- * 没有真实的 120×32 资产时,渲染已登记的 mock:
11
- * **28×28 纯色块 + 8px 间隙 + 企业名称(14/20 700)**。
15
+ * 品牌区按 GAP Design kit「集团顶部导航」(24:249):
16
+ * **36×36 图形 + 8px 间隙 + 企业名称(20/30 semibold)**,宽度按内容。
17
+ * 名称恒为可见文字;图形位放 `brandLogoSrc`,缺省时渲染已登记的 mock 纯色块。
12
18
  * 色块内部**不得**再绘制伪 Logo。
13
19
  *
14
20
  * ### ⚠ Shell 契约禁止添加未登记元素
15
21
  * 不得加搜索框、面包屑、通知铃铛、页面标题、卡片或阴影。
22
+ *
23
+ * ### 两个面板的接法(06 · P1-13)
24
+ * 回调交出被点的触发器,传给 `Popover` 的 `anchor` 即可锚定;开合由调用方受控,
25
+ * 同时回写 `appSwitchOpen` / `accountOpen`,触发器据此输出 `aria-expanded`。
26
+ * 再点触发器即收起 —— Popover 不把外部锚点上的点击当作外部点击。写法:回调里
27
+ * 记下触发器并切换开合(`setAnchor(trigger); setOpen((v) => !v)`),Popover 传
28
+ * `anchor={anchor} open={open} onOpenChange={setOpen}`。
16
29
  */
17
30
  export interface TopNavigationPrimaryBarProps extends HTMLAttributes<HTMLDivElement> {
18
31
  /** 企业名称。mock 兜底文案登记为「企业名称」 */
19
32
  brandName?: string;
20
- /** 真实品牌资产地址(120×32)。缺省时回退到已登记 mock */
33
+ /**
34
+ * 品牌图形地址,按 36×36 渲染(`object-fit: contain`),与 `brandName` 并排;
35
+ * 图形是装饰,可访问名由旁边的名称文字承担。缺省时图形位回退到已登记 mock 色块。
36
+ *
37
+ * 传的是图形标(kit 里的 36px 图形),不是含企业名的横版字标 —— 名称由组件以文字渲染,
38
+ * 再传字标会让名字出现两遍
39
+ */
21
40
  brandLogoSrc?: string;
22
41
  /** 中间区域内容。默认为空 —— 加东西前请确认它是已登记元素 */
23
42
  center?: ReactNode;
24
- /** 账户名 */
43
+ /**
44
+ * 账户名。同时是账户按钮的可访问名与头像缩写的来源;缩写规则与 `Avatar` 相同 ——
45
+ * 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
46
+ */
25
47
  accountName?: string;
26
- /** 应用切换回调 */
27
- onAppSwitch?: () => void;
28
- /** 账户菜单回调 */
29
- onAccount?: () => void;
48
+ /**
49
+ * 应用切换回调。参数是被点的触发器,供 `Popover` 的 `anchor` 锚定;
50
+ * 不需要锚定的调用方照旧写无参函数
51
+ */
52
+ onAppSwitch?: (trigger: HTMLButtonElement) => void;
53
+ /** 账户菜单回调。参数同 `onAppSwitch` */
54
+ onAccount?: (trigger: HTMLButtonElement) => void;
55
+ /**
56
+ * 应用切换面板是否展开。传入(含 `false`)即声明该触发器控制一个弹出面板:
57
+ * 输出 `aria-haspopup="dialog"` 与 `aria-expanded`。缺省时两者都不输出 ——
58
+ * 不知道面板开没开,宁可不说也不能说错。面板内容根应声明 `role="dialog"` 与可访问名
59
+ */
60
+ appSwitchOpen?: boolean;
61
+ /** 账户面板是否展开。语义同 `appSwitchOpen` */
62
+ accountOpen?: boolean;
30
63
  }
31
64
  //# sourceMappingURL=top-navigation-primary-bar.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"top-navigation-primary-bar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/top-navigation-primary-bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,UAAU;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IAExB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB"}
1
+ {"version":3,"file":"top-navigation-primary-bar.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/navigation/top-navigation-primary-bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAElD,+BAA+B;IAC/B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAEhD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB"}
@@ -2,9 +2,14 @@ import type { HTMLAttributes, ReactNode } from 'react';
2
2
  /**
3
3
  * DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后的列表。
4
4
  *
5
- * 推荐宽度 680px,底部动作区固定。
5
+ * 推荐宽度 680px。
6
6
  *
7
- * ⚠ **它说「关闭」,独立详情页说「返回」。** 深链接只指向独立详情页。
7
+ * 页头(GAP Design kit「抽屉 / 常规」;业财平台 round-01 裁决,2026-11-10):48 高、左右 12、
8
+ * 0.5px 下边线;左侧标题与副标题同行 14/20,右侧依次为主动作、次要动作组、32×32 纯图标
9
+ * 关闭键,间隔 4。**没有底部动作区** —— 动作一律在页头。
10
+ *
11
+ * ⚠ **它的关闭键可访问名是「关闭」,独立详情页的退出是写着「返回」的按钮。**
12
+ * 深链接只指向独立详情页。
8
13
  *
9
14
  * ⚠ **关闭时必须还原来源页面的**:业务视图、搜索、筛选、排序、分页、
10
15
  * 页面模式、当前对象、滚动位置。少还原任何一项都算缺陷。
@@ -22,9 +27,14 @@ export interface ApplicationDetailDrawerProps extends Omit<HTMLAttributes<HTMLDi
22
27
  status?: ReactNode;
23
28
  /** 宽度,单位 px。推荐 680 */
24
29
  width?: number;
25
- /** **唯一**的主对象动作,固定在右下角 */
30
+ /**
31
+ * 从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`,
32
+ * 免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8)
33
+ */
34
+ side?: 'left' | 'right';
35
+ /** **唯一**的主对象动作,渲染在页头右侧动作区的最左(kit:主按钮在前) */
26
36
  primaryAction?: ReactNode;
27
- /** 次要动作组 */
37
+ /** 次要动作组,渲染在主动作之后、关闭键之前。超过两三个时收进「更多」 */
28
38
  secondaryActions?: ReactNode;
29
39
  /** 关闭回调。**必须在此还原来源页面上下文** */
30
40
  onClose?: () => void;
@@ -1 +1 @@
1
- {"version":3,"file":"application-detail-drawer.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-detail-drawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACjG,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,kBAAkB;IAClB,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,0BAA0B;IAC1B,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,YAAY;IACZ,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAE5B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"application-detail-drawer.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-detail-drawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACjG,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB,kBAAkB;IAClB,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAEvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,SAAS,CAAA;IAEzB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAE5B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -2,11 +2,18 @@ import type { HTMLAttributes, ReactNode } from 'react';
2
2
  /**
3
3
  * 业务对象的新建与编辑表单对话框。
4
4
  *
5
- * 已登记宽度:`small` 720px、`large` 960px,**只有这两种**,
6
- * 且**绝不超出有效视口**。
5
+ * 已登记宽度:`small` 720px、`large` 960px、`xlarge` 1280px,**只有这三种**,
6
+ * 且**绝不超出有效视口**。1280 是 GAP Design kit 弹窗宽度区间的上限(业财平台 round-01 裁决)。
7
7
  *
8
8
  * 字段以 `Field` 子元素传入,默认排布在两列网格上;
9
- * 需要跨列的字段传 `style={{ gridColumn: '1 / -1' }}`。
9
+ * 需要跨列的字段给 `Field` 传 `span="full"`。
10
+ *
11
+ * 页头右侧恒有一个纯图标的关闭按钮(可访问名「关闭」),行为等同 `onCancel`,
12
+ * 提交中禁用 —— 与 `Dialog` 一致。
13
+ *
14
+ * 外观(GAP Design kit「抽屉弹窗 / 弹窗」188:685,业财平台 round-01 起):面板圆角 20;
15
+ * 48px 灰底页头,标题与关闭键间隔 10;主体灰底、内含一张白卡承载字段网格,字段间距 10;
16
+ * 底部动作区同为灰底、内边距 12、动作间隔 4、顶部 0.5px 分隔线。
10
17
  *
11
18
  * ⚠ **提交失败显示为主体顶部的 `Alert`,不是 toast** ——
12
19
  * 用户必须处理的失败绝不能放进转瞬即逝的提示里。
@@ -16,10 +23,14 @@ export interface ApplicationFormDialogProps extends Omit<HTMLAttributes<HTMLDivE
16
23
  open?: boolean;
17
24
  /** 标题 */
18
25
  title?: ReactNode;
19
- /** 标题下的补充说明 */
26
+ /** 补充说明,与标题同行、以 14/20 label 色跟在标题之后。只写一句短语 */
20
27
  description?: ReactNode;
21
- /** 宽度档位。720px / 960px */
22
- size?: 'small' | 'large';
28
+ /**
29
+ * 宽度档位。`small` 720px / `large` 960px / `xlarge` 1280px。
30
+ * `xlarge` 是 GAP Design kit 弹窗宽度区间(680–1280)的上限,用于字段多、需要左右并排
31
+ * 原件与表单的编辑场景(业财平台 round-01 · editor/dialog/width 裁决,2026-11-10)
32
+ */
33
+ size?: 'small' | 'large' | 'xlarge';
23
34
  /** 字段网格列数。默认 2 */
24
35
  columns?: number;
25
36
  /** 提交按钮文案 */
@@ -32,8 +43,20 @@ export interface ApplicationFormDialogProps extends Omit<HTMLAttributes<HTMLDivE
32
43
  error?: ReactNode;
33
44
  /** 提交回调 */
34
45
  onSubmit?: () => void;
35
- /** 取消回调 */
46
+ /** 取消回调。页头关闭按钮、Esc 与遮罩点击同样触发它 */
36
47
  onCancel?: () => void;
48
+ /**
49
+ * 底部动作区的附加次要动作,排在「取消」与提交按钮之间,例如逐条编辑时的
50
+ * 「上一张」「下一张」。传 `SystemButton`(`intent="secondary"`)。
51
+ *
52
+ * **不得**放第二个 primary,也不得放删除类动作 —— 删除不与提交并排出现在页脚。
53
+ */
54
+ secondaryActions?: ReactNode;
55
+ /**
56
+ * 底部动作区左侧的一段说明,12/16 label 色,例如「共 100 条,当前第 6 条」。
57
+ * 只写与本次提交相关的上下文;校验错误与提交失败**不得**写在这里(前者在字段、后者是 `error`)。
58
+ */
59
+ footerNote?: ReactNode;
37
60
  /** 表单字段,传 `Field` 子元素 */
38
61
  children?: ReactNode;
39
62
  }
@@ -1 +1 @@
1
- {"version":3,"file":"application-form-dialog.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-form-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,SAAS;IACT,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,eAAe;IACf,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,yBAAyB;IACzB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IAExB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAErB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAErB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"application-form-dialog.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-form-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,SAAS;IACT,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IAEnC,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAErB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAErB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAE5B;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -10,15 +10,19 @@ export interface GlobalActionTab {
10
10
  }
11
11
  /**
12
12
  * 四个 popover 型全局动作**共享的同一个面板** ——
13
- * 消息 / 待办 / 运行总览 / 风险预警。
13
+ * 消息 / 待办 / 总览 / 风险预警。
14
14
  *
15
15
  * ⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**
16
16
  *
17
17
  * 宽 720px(`--ui-shell-global-action-popover-width`),20px 圆角,
18
- * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开。
18
+ * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开 ——
19
+ * 视口约束按「视口高 − 外壳总高 − 16px」计算,底边不越出视口。
19
20
  *
20
- * ⚠ **设置**打开的是 Drawer / Sheet,不走本面板;
21
- * 且**绝不能存在第二个设置入口**。
21
+ * 非模态:不锁滚动、不陷阱焦点。**Esc 关闭**由本组件承担(进库内的 Esc 层级栈,
22
+ * 上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。外点击关闭由调用方判定。
23
+ *
24
+ * ⚠ **设置**不走本面板:它让 `ApplicationSecondaryNavigation` 换成设置模块
25
+ * (`onAction` 给它的 `kind` 是 `'module'`);且**绝不能存在第二个设置入口**。
22
26
  */
23
27
  export interface ApplicationGlobalActionPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
24
28
  /** 是否打开。为 false 时渲染 `null` */
@@ -33,9 +37,22 @@ export interface ApplicationGlobalActionPanelProps extends Omit<HTMLAttributes<H
33
37
  onTabChange?: (value: string) => void;
34
38
  /** 面板底部内容,如「全部标记为已读」 */
35
39
  footer?: ReactNode;
36
- /** 无条目时的空态,应传 `Empty`。文案须区别于无权限与加载失败 */
40
+ /**
41
+ * 面板主体的系统状态(06 · P2-18)。`ready` 渲染 `children`,其余渲染对应槽位:
42
+ * `loading` → `loading`、`empty` → `emptyState`、`error` → `error`、
43
+ * `no-permission` → `noPermission`。缺省时保持原行为:有 `children` 渲染它,
44
+ * 否则渲染 `emptyState`
45
+ */
46
+ state?: 'ready' | 'loading' | 'empty' | 'error' | 'no-permission';
47
+ /** Loading 状态内容。应传贴近条目结构的 `Skeleton`,而非通用转圈 */
48
+ loading?: ReactNode;
49
+ /** 无条目时的空态,应传 `Empty`。文案须点明当前标签的口径,区别于无权限与加载失败 */
37
50
  emptyState?: ReactNode;
38
- /** 关闭回调 */
51
+ /** Error 状态内容。应说明失败原因并提供重试 */
52
+ error?: ReactNode;
53
+ /** No Permission 状态内容。措辞必须区别于空态 */
54
+ noPermission?: ReactNode;
55
+ /** 关闭回调。关闭按钮与 Esc 都会调用;外点击由调用方自行调用 */
39
56
  onClose?: () => void;
40
57
  /** 面板内容,通常是一组 `Message` */
41
58
  children?: ReactNode;
@@ -1 +1 @@
1
- {"version":3,"file":"application-global-action-panel.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-global-action-panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,iBAAiB;AACjB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACtG,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uBAAuB;IACvB,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IAExB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,aAAa;IACb,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,wBAAwB;IACxB,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
1
+ {"version":3,"file":"application-global-action-panel.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/overlays/application-global-action-panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,iBAAiB;AACjB,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACtG,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,uBAAuB;IACvB,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IAExB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,aAAa;IACb,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,wBAAwB;IACxB,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,CAAA;IAEjE,+CAA+C;IAC/C,OAAO,CAAC,EAAE,SAAS,CAAA;IAEnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,mCAAmC;IACnC,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB"}
@@ -5,25 +5,51 @@ export interface Metric {
5
5
  key?: string;
6
6
  /** 指标名,12/16 label 色 */
7
7
  label: ReactNode;
8
- /** 指标值,24/32 semibold,等宽数字 */
8
+ /** 指标值,32/32 semibold,等宽数字 */
9
9
  value: ReactNode;
10
+ /**
11
+ * 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。
12
+ * 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 ——
13
+ * 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。
14
+ */
15
+ description?: ReactNode;
10
16
  /** 单位,紧随数值以 12px regular 显示 */
11
17
  unit?: string;
12
18
  /** 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 */
13
19
  icon?: ReactNode;
14
20
  }
21
+ /** 指标区的加载状态。指标区没有 empty —— 无真实指标时整个区域不渲染 */
22
+ export type MetricStripState = 'ready' | 'loading' | 'error';
15
23
  /**
16
24
  * 指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。
17
25
  *
18
26
  * 其他语义的卡片作为 `children` 传入,由本容器统一等高排列。
27
+ *
28
+ * ⚠ 加载与失败由 `state` 表达(06 · P2-10):`loading` 渲染与卡片同壳同高的骨架,
29
+ * `error` 渲染一张横跨整行的卡片承载 `error` 节点。两者都不是「无指标」的替身 ——
30
+ * 页面没有真实指标时仍是整个区域不渲染。
19
31
  */
20
32
  export interface ApplicationMetricStripProps extends HTMLAttributes<HTMLDivElement> {
21
33
  /** 基础指标集合 */
22
34
  metrics?: Metric[];
23
- /** 列数。默认取指标数量,上限 6 */
35
+ /**
36
+ * 列数。默认取卡片总数 —— `metrics` 条目数加 `children` 中的卡片数
37
+ * (null / false / undefined 不计入),钳在 1–6 之间
38
+ */
24
39
  columns?: number;
25
40
  /** 其他语义的指标卡(trend / chart / status / primary-secondary) */
26
41
  children?: ReactNode;
42
+ /**
43
+ * 加载状态,默认 `ready`。`loading` 时不渲染 `metrics` 与 `children`,改渲染
44
+ * 内置骨架:张数同 `columns` 的缺省算法(无卡片时为 4),每张与指标卡同壳同高;
45
+ * `error` 时渲染一张横跨整行的卡片,内容取 `error`
46
+ */
47
+ state?: MetricStripState;
48
+ /**
49
+ * `state="error"` 时的内容。应说明失败原因并提供重试(如「指标加载失败」+「重试」),
50
+ * 措辞不得与数据展示区的 Error 共用。不传时显示内置的「指标加载失败」
51
+ */
52
+ error?: ReactNode;
27
53
  }
28
54
  /**
29
55
  * `trend` 语义:数值 + 环比变化量。
@@ -75,7 +101,10 @@ export interface ApplicationMetricChartProps extends HTMLAttributes<HTMLDivEleme
75
101
  value?: ReactNode;
76
102
  /** 单位 */
77
103
  unit?: string;
78
- /** 走势数据点 */
104
+ /**
105
+ * 走势数据点。纵轴按本组数据的 min–max 归一化(不从 0 起算),
106
+ * 只表达形状、不表达绝对量级;全部相等时画在中线
107
+ */
79
108
  data?: number[];
80
109
  /** 分类色序号,索引 `--application-categorical-01…20`。**不是状态色** */
81
110
  colorIndex?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/statistics/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAiBtD,+CAA+C;AAC/C,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAClC,qCAAqC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjD,2CAA2C;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,qBAAqB;IACrB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,YAAY;IACZ,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,sCAAuC,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC5F,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;CAC9B"}
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../contracts/application-module/statistics/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAkBtD,+CAA+C;AAC/C,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAClC,qCAAqC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA6B,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjD,2CAA2C;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,qBAAqB;IACrB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc,CAAC,cAAc,CAAC;IACjF,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU;IACV,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,YAAY;IACZ,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,sCAAuC,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC5F,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;CAC9B"}