@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
@@ -1,4 +1,4 @@
1
- import type { ChangeEvent, HTMLAttributes, ReactNode } from 'react'
1
+ import type { ChangeEvent, HTMLAttributes, MouseEvent, ReactNode } from 'react'
2
2
 
3
3
  /** L3 业务视图标签 */
4
4
  export interface BusinessViewTab {
@@ -20,9 +20,16 @@ export interface AppliedFilterTag {
20
20
  labelText?: string
21
21
  }
22
22
 
23
- /** L5 数据呈现方式 */
23
+ /**
24
+ * L5 数据呈现方式。
25
+ *
26
+ * `RecordList` 是结构化列表(`ApplicationRecordList`),06 · D-2 裁决补入:此前 LIST 页用
27
+ * RecordList 只能谎报为 `DataTable`。`KanbanBoard` / `Calendar` / `Timeline` 暂无专属组件,
28
+ * 按 canvas-model「呈现配方」一节的标准拼装写法承载。
29
+ */
24
30
  export type DataPresentation =
25
31
  | 'DataTable'
32
+ | 'RecordList'
26
33
  | 'CardList'
27
34
  | 'KanbanBoard'
28
35
  | 'Calendar'
@@ -37,8 +44,16 @@ export type DataPresentation =
37
44
  * | 行 | 内容 | 渲染条件 |
38
45
  * |---|---|---|
39
46
  * | 1 | 业务视图标签(2–4 个稳定工作视角) | 仅当确有视图 |
40
- * | 2 | 结果摘要 │ 搜索 + 常用筛选 + 更多 │ 排序 + 呈现设置 | always |
41
- * | 3 | 已生效筛选标签(可移除 + 重置全部) | 仅当有筛选生效 |
47
+ * | 2 | 结果摘要 │ 搜索 + 排序 + 常用筛选 + 更多 ‖ 视图切换 + 呈现设置 | always |
48
+ * | 3 | 已生效筛选标签(可移除 + 「清空」全部) | 仅当有筛选生效 |
49
+ *
50
+ * 第 2 行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」—— 排序紧跟搜索、
51
+ * 在筛选之前(GAP Design kit「数据筛选搜索」的标注;业财平台 round-01 裁决,2026-11-10)。
52
+ * 右组只放 `viewModeSwitch` 与呈现设置。
53
+ *
54
+ * 几何按 kit「数据筛选搜索」(84:2803):三行之间 8;第 2 行左组控件之间 4,摘要与搜索之间
55
+ * 由组件画一条 1×20 的线条色竖线(只在传了 `resultSummary` 时出现);右组之间 4;左右两组之间 12。
56
+ * 调用方传入的排序与筛选控件不得自带外边距 —— 间隔由组件统一给出。
42
57
  *
43
58
  * ### ⚠ 搜索
44
59
  * **通过 Enter 或明确的搜索动作提交,绝不逐字实时搜索。**
@@ -48,10 +63,13 @@ export type DataPresentation =
48
63
  * 由「应用」提交,并**回写到第三行的标签**。
49
64
  *
50
65
  * ### ⚠ 呈现设置按钮必须按当前呈现方式命名
51
- * DataTable → 列设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
66
+ * 按钮是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12,kit「列表工具」),
67
+ * 名字落在可访问名与悬停提示上:
68
+ * DataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
52
69
  * Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。
53
- * **通用的「视图设置」被明令禁止。**
54
- * 无真实可配置项时(`hasPresentationSettings={false}`)按钮不渲染且不占位。
70
+ * **通用的「视图设置」被明令禁止**,「自定义」同理 —— 它不说明设的是什么。
71
+ * 无真实可配置项时(`hasPresentationSettings={false}`,或不传
72
+ * `onPresentationSettings`)按钮不渲染且不占位。
55
73
  * 每种呈现方式**各自独立存储**其设置。
56
74
  *
57
75
  * ### ⚠ Page Mode Switch 不属于本组件
@@ -68,7 +86,10 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
68
86
  /** 业务视图变化回调 */
69
87
  onBusinessViewChange?: (value: string) => void
70
88
 
71
- /** 结果摘要,如「共 1,284 条」 */
89
+ /**
90
+ * 结果摘要,渲染为一枚胶囊,如 `<>共 <strong>1,284</strong> 条</>`。
91
+ * 数字用 `<strong>` 包裹即加粗为正文色;有勾选时紧随写已选数(「已选 3 条」)。
92
+ */
72
93
  resultSummary?: ReactNode
73
94
 
74
95
  /** 搜索框受控值 */
@@ -80,16 +101,34 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
80
101
  /** 搜索提交回调。**仅 Enter 触发** */
81
102
  onSearchSubmit?: (value: string) => void
82
103
 
83
- /** 搜索占位文字。应写明搜索范围 */
104
+ /**
105
+ * 搜索占位文字。应写明搜索范围,如「搜索任务名称或编号」。
106
+ *
107
+ * **无默认值**(05 · P1-7):此前缺省为 `'搜索'`,不传即违反 SearchField
108
+ * 「不得写成不含范围的『搜索』」,且同时充当可访问名。缺省时占位文字取
109
+ * `searchAriaLabel`,二者都缺省则不显示占位文字。
110
+ */
84
111
  searchPlaceholder?: string
85
112
 
113
+ /**
114
+ * 搜索框的可访问名,必须写明搜索范围。优先级:本 prop → `searchPlaceholder`。
115
+ *
116
+ * 占位文字写示例、可访问名写范围时分开传;二者同文时只传 `searchPlaceholder`
117
+ * 即可。两者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次 ——
118
+ * SearchField 的 `ariaLabel` 必填,不能留空,而写明范围只有调用方做得到(05 · P1-7)
119
+ */
120
+ searchAriaLabel?: string
121
+
86
122
  /** 常用筛选,传 2–3 个 `ApplicationFilterMenu` */
87
123
  commonFilters?: ReactNode
88
124
 
89
- /** 「更多筛选」触发器,通常是 `Collapsible` 或 `Popover` */
125
+ /** 「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4) */
90
126
  moreFilters?: ReactNode
91
127
 
92
- /** 排序控件 */
128
+ /**
129
+ * 排序控件,传 `Select`,渲染在搜索框之后、常用筛选之前。
130
+ * DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2)
131
+ */
93
132
  sort?: ReactNode
94
133
 
95
134
  /** 已生效的筛选标签 */
@@ -98,17 +137,33 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
98
137
  /** 移除单个标签回调 */
99
138
  onRemoveTag?: (id: string) => void
100
139
 
101
- /** 重置全部筛选回调 */
140
+ /** 清空全部筛选回调。按钮文案为「清空」,与筛选标签同款胶囊 */
102
141
  onResetTags?: () => void
103
142
 
104
143
  /** 当前呈现方式。**决定呈现设置按钮的文案** */
105
144
  presentation?: DataPresentation
106
145
 
107
- /** 是否有可配置的呈现设置。false 时按钮不渲染且不占位 */
146
+ /**
147
+ * 是否有可配置的呈现设置。false 时按钮不渲染且不占位。
148
+ *
149
+ * 缺省时按是否提供 `onPresentationSettings` 推断(05 · P1-7):此前缺省为
150
+ * `true`,不传即渲染一个点了没反应的设置按钮,默认值站在了违规一边。
151
+ * 显式传入仍优先
152
+ */
108
153
  hasPresentationSettings?: boolean
109
154
 
110
- /** 呈现设置点击回调 */
111
- onPresentationSettings?: () => void
155
+ /**
156
+ * 呈现设置点击回调。参数是按钮的点击事件,`event.currentTarget` 即设置按钮本身,
157
+ * 供调用方把面板锚定在它上面、或关闭后把焦点还给它(06 · P2-6)。
158
+ * 不读参数的无参回调照旧可用
159
+ */
160
+ onPresentationSettings?: (event: MouseEvent<HTMLButtonElement>) => void
161
+
162
+ /**
163
+ * 呈现设置面板当前是否展开。传入后设置按钮输出 `aria-expanded`,读屏据此报出开合;
164
+ * 不传则不输出 —— 面板由调用方持有,组件无从得知开合,宁可不报也不报错(06 · P2-6)
165
+ */
166
+ presentationSettingsOpen?: boolean
112
167
 
113
168
  /** **仅 SPLIT 右栏使用**的视图模式切换器 */
114
169
  viewModeSwitch?: ReactNode
@@ -2,9 +2,9 @@ import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
3
  /** 详情中的单个字段 */
4
4
  export interface DetailField {
5
- /** 字段名,12/16 label 色 */
5
+ /** 字段名,14/20 label 色,固定 160px 宽,与值横排 */
6
6
  label: ReactNode
7
- /** 字段值,14/20,长值自动断行 */
7
+ /** 字段值,14/20 medium 字重,长值自动断行 */
8
8
  value: ReactNode
9
9
  /** React key。`label` 为非字符串时**必须**提供。见 M8 */
10
10
  key?: string
@@ -14,7 +14,7 @@ export interface DetailField {
14
14
  export interface DetailSection {
15
15
  /** React key。`title` 为非字符串时**必须**提供。见 M8 */
16
16
  key?: string
17
- /** 分节标题,16/24 medium 字重 */
17
+ /** 分节标题,16/20 medium 字重,左侧带 2×14 强调色竖条 */
18
18
  title: ReactNode
19
19
  /** 字段列表,自适应多列网格排布 */
20
20
  fields?: DetailField[]
@@ -39,6 +39,16 @@ export interface ApplicationRecordDetailBodyProps extends HTMLAttributes<HTMLDiv
39
39
 
40
40
  /** 分节集合,按顺序渲染 */
41
41
  sections?: DetailSection[]
42
+
43
+ /**
44
+ * 侧栏分节。提供时主体变为两栏:左栏(`summary` + `sections`)弹性伸展,
45
+ * 右栏固定 360px,两栏各是一张白卡,间距 12。用于「处理记录」「审批流转」这类
46
+ * **伴随主内容、随它一起看**的内容。
47
+ *
48
+ * 只放一个分节;**不得**把主要字段分节挪进侧栏,也不得用它放对象级动作
49
+ * (动作在载体的动作区)。可用宽度不足 960px 时侧栏落到主栏下方。
50
+ */
51
+ aside?: DetailSection
42
52
  }
43
53
 
44
54
  /*
@@ -38,12 +38,19 @@ export interface ApplicationSplitListSidebarProps extends HTMLAttributes<HTMLEle
38
38
  /** 目录项集合 */
39
39
  items?: SplitSidebarItem[]
40
40
 
41
- /** 当前选中项。`undefined` / `null` 是合法状态 */
42
- value?: string
41
+ /** 当前选中项。`undefined` 与 `null` 都表示未定位,是合法状态 */
42
+ value?: string | null
43
43
 
44
- /** 选中项变化回调 */
44
+ /** 选中项变化回调。只回传条目值,不回传 `null` —— 取消定位走 `onClear` */
45
45
  onValueChange?: (value: string) => void
46
46
 
47
+ /**
48
+ * 取消定位回调(06 · P2-1)。提供时**再次选择当前项即取消定位**(点击或 Enter / 空格),
49
+ * 调用方在此把 `value` 写回 `null`;当前项另带描述「再次选择取消定位」。
50
+ * 不提供时再次选择当前项照旧回调 `onValueChange`,不会取消定位
51
+ */
52
+ onClear?: () => void
53
+
47
54
  /** 目录设置触发器。**与呈现设置是两回事**,不要混用 */
48
55
  settings?: ReactNode
49
56
 
@@ -54,4 +61,9 @@ export interface ApplicationSplitListSidebarProps extends HTMLAttributes<HTMLEle
54
61
  width?: number | string
55
62
  }
56
63
 
57
- /* 三方一致,契约中的禁止清单与「null 是合法状态」的约束已完整表达。 */
64
+ /* 三方一致,契约中的禁止清单与「null 是合法状态」的约束已完整表达。
65
+ *
66
+ * 06 · P2-1:此前 `value` 只收 string,「null 是合法状态」只写在说明里、类型上写不出来,
67
+ * 也没有取消定位的出口。`value` 放宽为 `string | null`;出口另开 `onClear` 而不让
68
+ * `onValueChange` 回传 null —— 后者会让现有的 `(value: string) => void` 回调在
69
+ * strictFunctionTypes 下不再可赋值,违反「现有调用零改动」。 */
@@ -12,7 +12,7 @@ export interface RecordListItem {
12
12
  status?: ReactNode
13
13
  /** 关键数值 */
14
14
  value?: ReactNode
15
- /** 行尾的记录级动作。**必须阻止事件冒泡**,以免误触打开详情 */
15
+ /** 行尾的记录级动作。组件包一层阻止事件冒泡,点动作不会误触打开详情 */
16
16
  actions?: ReactNode
17
17
  }
18
18
 
@@ -21,7 +21,8 @@ export interface RecordListItem {
21
21
  *
22
22
  * 适用于表格列数过剩、但行仍需扫视的场景。
23
23
  *
24
- * ⚠ **记录级动作位于行尾**,且必须阻止冒泡 —— 点动作绝不能顺带打开详情。
24
+ * ⚠ **记录级动作位于行尾** —— 点动作绝不能顺带打开详情。行点击忽略来自行内
25
+ * 可交互元素的事件,`renderRow` 接管时同样成立,调用方不必手动阻止冒泡。
25
26
  * 勾选记录应唤出 `ListBatchActionBar`。
26
27
  *
27
28
  * ⚠ 与 DataTable 一样,它的呈现设置按钮读作**「列设置」**。
@@ -33,7 +34,11 @@ export interface ApplicationRecordListProps<R extends RecordListItem = RecordLis
33
34
  /** 记录集合 */
34
35
  records?: R[]
35
36
 
36
- /** 启用行选择 */
37
+ /**
38
+ * 启用行选择。为 true 时行首渲染勾选框,列表顶部另有一行吸顶的全选框
39
+ * (`ListSelectionCheckbox scope="all"`,06 · P3-2):全选 / 全不选只作用于本次传入的
40
+ * `records`,`selected` 里不在 `records` 中的 id(如其他页已选)原样保留
41
+ */
37
42
  selectable?: boolean
38
43
 
39
44
  /** 已选记录 id 集合 */
@@ -42,10 +47,10 @@ export interface ApplicationRecordListProps<R extends RecordListItem = RecordLis
42
47
  /** 选中集合变化回调 */
43
48
  onSelectedChange?: (ids: string[]) => void
44
49
 
45
- /** SPLIT 右栏或抽屉流程中的当前对象 id */
50
+ /** SPLIT 右栏或抽屉流程中的当前对象 id。该行输出 `aria-current="true"` */
46
51
  activeId?: string
47
52
 
48
- /** 打开记录回调。点击行主体触发 */
53
+ /** 打开记录回调。点击行主体、或行聚焦时按 Enter / 空格触发 */
49
54
  onOpen?: (record: R) => void
50
55
 
51
56
  /** 默认行结构不适用时,完全接管行主体的渲染 */
@@ -15,20 +15,25 @@ export interface ModuleItem {
15
15
  /**
16
16
  * 应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。
17
17
  *
18
- * ### 触发器
19
- * Standard 最小宽 168 / 高 40,Compact 148 / 32;
20
- * 深色 32×32 图标块(8px 圆角,18px 白色字形),
21
- * 名称 16/20 **700**,14px chevron 右对齐。
18
+ * ### 触发器(GAP Design kit「应用二级模块切换」)
19
+ * Standard 168×48,Compact 148×40;内边距 4/12,**没有图标块**;
20
+ * 名称 16/20 **medium**,20px chevron 右对齐;右侧 0.5px 分隔线;悬停与展开时 6% 淡底。
22
21
  *
23
22
  * ⚠ **绝不能简化成一个小图标,也绝不能移除。**
24
23
  *
25
24
  * ### 面板
26
- * `position: fixed`,`top: --ui-shell-application-total-height`,
27
- * `left: 0`,`bottom: 0`,宽 392px(受视口限制),白色表面,
28
- * **1px 右边线,无圆角,无阴影**,自带垂直滚动。
29
- * 条目最小高 40,内边距 8/12,圆角 12,文字 14/22。
25
+ * 挂在触发器正下方(`position: absolute`),与触发器同宽 168、最窄 128,
26
+ * 底色为导航背景与表面色各半,内边距 4,条目间隔 2,
27
+ * **1px 右边线,无圆角,无阴影**,限高到视口底、自带垂直滚动。
28
+ * 条目最小高 40,内边距 8/12,圆角 12,文字 14/22;悬停取导航背景;
29
+ * 当前模块为强调色 semibold,右侧 14px 对勾。
30
30
  *
31
31
  * ⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。
32
+ *
33
+ * ### 键盘
34
+ * 按 WAI-ARIA menu button 模式:打开即聚焦首个可用模块(触发器上按 ↑ 打开则聚焦末项),
35
+ * ↑ / ↓ / Home / End 在模块间移动并跳过禁用项,Esc 与外部点击经 `onOpenChange(false)`
36
+ * 收起,Esc 后焦点回到触发器,Tab 收起面板并离开。
32
37
  */
33
38
  export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect'> {
34
39
  /** 触发器上显示的当前模块名 */
@@ -40,9 +45,6 @@ export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttribute
40
45
  /** 当前模块值。点击它不触发 `onSelect` */
41
46
  currentModule?: string
42
47
 
43
- /** 触发器图标块内的字形,18px */
44
- glyph?: ReactNode
45
-
46
48
  /** 受控面板开合 */
47
49
  open?: boolean
48
50
 
@@ -56,4 +58,7 @@ export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttribute
56
58
  /*
57
59
  * 三方一致。面板的「无圆角、无阴影、仅 1px 右边线」是 readme §1.6
58
60
  * 明确点名的特例,实现忠实遵守。
61
+ *
62
+ * 业财平台 round-01 · Shell 裁决(2026-11-10,以 GAP Design kit 为准):触发器去掉图标块,
63
+ * `glyph` 随之删除;面板由贴视口的 320 宽 fixed 侧板改为触发器下方的 168 宽下拉。
59
64
  */
@@ -1,36 +1,78 @@
1
1
  import type { HTMLAttributes } from 'react'
2
+ import type { IconName } from '../../foundation/icon/icon-name.js'
2
3
 
3
4
  /** 五个已登记的全局动作 */
4
5
  export type GlobalActionKey = 'messages' | 'todos' | 'overview' | 'risk' | 'settings'
5
6
 
6
7
  /**
7
- * `APPLICATION.PRIMARY_NAV` —— 固定 Shell 的**第二带**。
8
- * Standard 64px / Compact 52px。
8
+ * 全局动作的承载类型。`'popover'` —— 消息 / 待办 / 总览 / 风险预警四个动作共用的
9
+ * `ApplicationGlobalActionPanel`;`'module'` —— 设置,`ApplicationSecondaryNavigation`
10
+ * 整带换成设置模块(GAP Design kit「框架结构 / 结构=设置」)。
11
+ */
12
+ export type GlobalActionKind = 'popover' | 'module'
13
+
14
+ /**
15
+ * 基础版外壳里本带承载的账户入口(GAP Design kit「导航组合 / 基础版本」:用户头像在应用一级
16
+ * 导航的最右端)。集团版外壳的账户入口在 `TopNavigationPrimaryBar`,此时不传本项。
17
+ */
18
+ export interface ApplicationPrimaryNavigationAccount {
19
+ /**
20
+ * 账户名。同时是头像按钮的可访问名与缩写来源,缩写规则与 `Avatar` 相同 ——
21
+ * 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
22
+ */
23
+ name?: string
24
+
25
+ /**
26
+ * 账户面板是否展开。传入(含 `false`)即输出 `aria-haspopup="dialog"` 与 `aria-expanded`;
27
+ * 缺省时两者都不输出。面板内容根应声明 `role="dialog"` 与可访问名
28
+ */
29
+ open?: boolean
30
+
31
+ /**
32
+ * 头像点击回调。参数是被点的触发器,传给 `Popover` 的 `anchor` 锚定;
33
+ * 回调里切换开合并回写 `open`(与 `TopNavigationPrimaryBar.onAccount` 同一接法)
34
+ */
35
+ onToggle?: (trigger: HTMLButtonElement) => void
36
+ }
37
+
38
+ /**
39
+ * `APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。
40
+ * Standard 48px / Compact 40px,内边距 8/12。
41
+ *
42
+ * 外壳有两种形态(kit「导航组合」):
9
43
  *
10
- * **左侧**:应用身份 —— logo 48×48(Compact 40×40)置于 8% 强调色瓦片上,
11
- * 名称 16/24 **700**,说明 12/16 400(Compact 可隐藏)。
44
+ * | 形态 | 带 | 总高 |
45
+ * |---|---|---:|
46
+ * | 基础版 | 本带 + `ApplicationSecondaryNavigation` | 96 |
47
+ * | 集团版 | `TopNavigationPrimaryBar` + 本带 + `ApplicationSecondaryNavigation` | 144 |
48
+ *
49
+ * **左侧**:应用身份 —— 32×32 logo 瓦片(8px 圆角,8% 强调色混入表面色)+ 4px 间隙 +
50
+ * 应用名 14/20 regular 文字1。kit 里没有应用说明行。
12
51
  *
13
52
  * **右侧**:**恰好这五个已登记全局动作,且顺序固定**:
14
53
  *
15
- * 消息 → 待办 → 运行总览 → 风险预警 → 设置
54
+ * 消息 → 待办 → 总览 → 风险预警 → 设置
16
55
  *
17
- * 32×32 触发器,18px 字形,8px 间距。
18
- * 前四个打开共享 Popover,**设置打开 Drawer**。
56
+ * 每个动作是「18px 字形 + 文字」:32 高,左右 10,字形与文字间隔 4,圆角 12,文字 14/20 文字2;
57
+ * 动作之间 4px。前四个打开共享 Popover;**设置不弹浮层**,而是让 `ApplicationSecondaryNavigation`
58
+ * 整带换成设置模块(kit「框架结构 / 结构=设置」:模块切换器显示设置模块名,标签换成设置项,
59
+ * 最右的「导航设置」按钮换成关闭叉号)。
60
+ * 基础版传 `account` 时,头像(24×24 圆形)在动作组之后,间隔 8px。
19
61
  *
20
62
  * ### ⚠ 硬性约束
21
63
  * - **绝不渲染第二个设置入口**
22
64
  * - logo 瓦片是 8% 强调色混入表面色,**绝不是饱和强调色块**
23
- * - Compact 档可隐藏说明,但**必须保留** logo、名称与全部五个动作入口
65
+ * - Compact 档必须保留 logo、名称与全部五个动作入口
24
66
  */
25
67
  export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDivElement> {
26
- /** 应用名称,16/24 700。mock 文案登记为「示例应用」 */
68
+ /** 应用名称,14/20 regular。mock 文案登记为「示例应用」 */
27
69
  appName?: string
28
70
 
29
- /** 应用说明,12/16 400。mock 文案登记为「应用说明信息」 */
30
- appDescription?: string
31
-
32
- /** 应用 logo mock 字形的图标名(24px) */
33
- appGlyph?: string
71
+ /**
72
+ * 应用 logo mock 字形的图标名(20px),默认 `'shield-check'`。
73
+ * 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒
74
+ */
75
+ appGlyph?: IconName
34
76
 
35
77
  /** 当前激活的全局动作面板 */
36
78
  activeAction?: GlobalActionKey
@@ -38,14 +80,35 @@ export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDi
38
80
  /** 各动作的未读圆点 */
39
81
  actionBadges?: Partial<Record<GlobalActionKey, boolean>>
40
82
 
41
- /** 动作点击回调。`kind` 指明该动作打开 Popover 还是 Drawer */
42
- onAction?: (key: GlobalActionKey, kind: 'popover' | 'drawer') => void
83
+ /**
84
+ * 动作点击回调。`kind` 指明该动作的承载:`'popover'` 打开共享的 `ApplicationGlobalActionPanel`,
85
+ * `'module'`(只有设置)把 `ApplicationSecondaryNavigation` 换成设置模块
86
+ */
87
+ onAction?: (key: GlobalActionKey, kind: GlobalActionKind) => void
43
88
 
44
- /** Compact 档。隐藏应用说明,其余一律保留 */
45
- compact?: boolean
89
+ /**
90
+ * 基础版外壳的账户入口。传入即在动作组之后渲染头像;集团版外壳(渲染了
91
+ * `TopNavigationPrimaryBar`)不得传,否则一个外壳里会有两个账户入口
92
+ */
93
+ account?: ApplicationPrimaryNavigationAccount
46
94
  }
47
95
 
48
96
  /*
49
- * 三方一致。五个动作及其顺序被写死在实现中,是对规范的正确固化 ——
50
- * 调用方无法增删或重排,这正是「已登记」的含义。
97
+ * 五个动作及其顺序被写死在实现中,是对规范的正确固化 —— 调用方无法增删或重排,
98
+ * 这正是「已登记」的含义。
99
+ *
100
+ * ─── 业财平台 round-01 · Shell 裁决(2026-11-10,以 GAP Design kit 为准)───────
101
+ *
102
+ * 本带由 64px「logo 48 + 名称 16/24 700 + 说明 12/16 + 五个 32×32 纯图标动作」改为 kit 的
103
+ * 48px「logo 32 + 名称 14/20 regular + 五个图标 + 文字动作」。随之删除:
104
+ * · appDescription —— kit 没有说明行
105
+ * · compact —— 07 · C-18 起已弃用;本带不再有随 Compact 档隐藏的内容,强制档无物可强制
106
+ * 「运行总览」按 kit 改称「总览」。动作文字常显,内置 Tooltip 一并去掉 —— 提示条只会
107
+ * 重复一遍已经写在按钮上的字。
108
+ *
109
+ * ─── 设置改为模块(2026-11-10,用户按 kit「结构=设置」裁定)──────────────────
110
+ *
111
+ * `onAction` 的 `kind` 由 `'popover' | 'drawer'` 改为 `'popover' | 'module'`:设置不再打开
112
+ * Drawer / Sheet,而是由调用方把二级导航换成设置模块并传 `onCloseSettings`。
113
+ * `activeAction === 'settings'` 时设置动作带激活态,表示设置模块正开着。
51
114
  */
@@ -1,4 +1,4 @@
1
- import type { HTMLAttributes, ReactNode } from 'react'
1
+ import type { HTMLAttributes, MouseEvent, ReactNode } from 'react'
2
2
 
3
3
  /** 二级导航的业务标签 */
4
4
  export interface SecondaryNavTab {
@@ -21,17 +21,34 @@ export interface SecondaryNavTab {
21
21
  }
22
22
 
23
23
  /**
24
- * `APPLICATION.SECONDARY_NAV` —— 固定 Shell 的**第三带**。
25
- * Standard 48px / Compact 40px。
24
+ * `APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带
25
+ * (基础版第二带、集团版第三带)。Standard 48px / Compact 40px,右侧内边距 12。
26
26
  *
27
- * **左侧**:完整的模块切换器。**右侧**:当前模块的业务标签。
27
+ * **左侧**:完整的模块切换器,贴左缘。**中间**:当前模块的业务标签,间隔 8。
28
+ * **最右**:一枚已登记的 32×32 纯图标按钮 —— 平时是「导航设置」,设置模块打开时是「关闭设置」。
29
+ *
30
+ * ### 尾部按钮(kit「二级导航设置」24:134 与「结构=设置」230:1104)
31
+ * 32×32、圆角 12、透明底,悬停是 6% 文字色淡底。两种形态互斥,同一时刻至多一枚:
32
+ *
33
+ * | 形态 | 何时渲染 | 字形 | 可访问名 |
34
+ * |---|---|---|---|
35
+ * | 导航设置 | 传了 `onNavigationSettings`,且未传 `onCloseSettings` | 16px `sliders-horizontal`,文字2 | 「导航设置」 |
36
+ * | 关闭设置 | 传了 `onCloseSettings` | 16px 叉号,文字1 | 「关闭设置」 |
37
+ *
38
+ * 两个回调都不传时不渲染,也不占位。
39
+ *
40
+ * ### 设置模块
41
+ * 全局动作「设置」不弹抽屉:它让本带整体换成设置模块 —— `moduleSwitcher` 显示设置模块名,
42
+ * `tabs` 换成设置项,同时传 `onCloseSettings`,尾部按钮随之变为关闭叉号,根元素输出
43
+ * `data-mode="settings"`。关闭时由调用方把模块切换器、标签与 `value` 换回进入设置前的那一组。
28
44
  *
29
45
  * ### ⚠ 每个标签都是「图标 + 文字」
30
46
  * 图标在左、可见文字在右。**纯文字标签被禁止**,
31
47
  * **为适应窄屏而丢弃全部图标同样被禁止** —— 标签保持单行并横向滚动,绝不换行。
32
48
  *
33
- * 标签几何:32px 高,内边距 6/12,文字 14/20。
34
- * 激活态是已登记的 **2px 下划线**,绝不是 pill 背景。
49
+ * 标签几何:32px 高,内边距 6/12,文字 14/20 文字2。
50
+ * 激活态是已登记的 **2px 下划线**(两端各缩进 12,贴标签底边)加强调色 medium 文字,
51
+ * 绝不是 pill 背景;悬停是 6% 文字色淡底、圆角 12,文字不变色。
35
52
  * 图标容器宽度固定,使字重变化不会横向推移文字。
36
53
  *
37
54
  * ### ⚠ 本带不得承载
@@ -51,6 +68,29 @@ export interface ApplicationSecondaryNavigationProps extends HTMLAttributes<HTML
51
68
 
52
69
  /** 标签变化回调 */
53
70
  onValueChange?: (value: string) => void
71
+
72
+ /**
73
+ * 「导航设置」按钮的点击回调(kit「二级导航设置」)。传入即在本带最右端渲染该按钮;
74
+ * 不传即不渲染、不占位。参数是点击事件,`event.currentTarget` 即按钮元素,可传给
75
+ * `Popover` 的 `anchor` 锚定面板,也是面板关闭后焦点的归还目标。
76
+ *
77
+ * 设置模块打开时(传了 `onCloseSettings`)本按钮不渲染 —— 那个位置换成关闭叉号
78
+ */
79
+ onNavigationSettings?: (event: MouseEvent<HTMLButtonElement>) => void
80
+
81
+ /**
82
+ * 导航设置面板是否展开。传入(含 `false`)即在按钮上输出 `aria-haspopup="dialog"` 与
83
+ * `aria-expanded`;缺省时两者都不输出。应与 `onNavigationSettings` 成对提供,
84
+ * 面板内容根相应声明 `role="dialog"` 与可访问名
85
+ */
86
+ navigationSettingsOpen?: boolean
87
+
88
+ /**
89
+ * 设置模块的关闭回调(kit「框架结构 / 结构=设置」)。传入即声明本带当前承载的是设置模块:
90
+ * 最右端渲染关闭叉号(可访问名「关闭设置」)取代「导航设置」按钮,根元素输出
91
+ * `data-mode="settings"`。回调里由调用方换回进入设置前的模块切换器、`tabs` 与 `value`
92
+ */
93
+ onCloseSettings?: (event: MouseEvent<HTMLButtonElement>) => void
54
94
  }
55
95
 
56
96
  /*
@@ -65,4 +105,15 @@ export interface ApplicationSecondaryNavigationProps extends HTMLAttributes<HTML
65
105
  *
66
106
  * 本组件使用 --ui-shell-* token 是正确的(它就是 Shell 第三带本身),
67
107
  * 与 N3(Foundation Tabs 借用同一批 token)性质不同。
108
+ *
109
+ * ─── round-01 之后的 kit 差异补齐(2026-11-10)──────────────────────────────
110
+ *
111
+ * 尾部按钮是**已登记的两个回调**,不是任意 ReactNode 槽位:kit 在这个位置只画了两种东西
112
+ * (导航设置、关闭设置),开一个任意槽位等于允许业务页面往 Shell 里塞未登记元素 ——
113
+ * 与「本带不得承载」那一节冲突。
114
+ *
115
+ * 设置由「打开 Drawer」改为「本带换成设置模块」是用户按 kit 裁定的(推翻了 PrimaryNavigation
116
+ * 与 Drawer / Sheet / GlobalActionPanel 四处的已登记行为)。模式不另设 prop:给了关闭回调
117
+ * 就是设置模块 —— 一个没有关闭入口的设置模块与一个不在设置模块里的关闭叉号都不该存在,
118
+ * 用同一个 prop 表达两者,两种错配在类型上都写不出来。
68
119
  */
@@ -39,7 +39,7 @@ export interface GlobalSidebarProps extends HTMLAttributes<HTMLElement> {
39
39
  /** 选中变化回调 */
40
40
  onValueChange?: (key: string) => void
41
41
 
42
- /** 栏底内容 */
42
+ /** 栏底内容。栏底入口(如「设置」)直接放 `SidebarRailButton`(07 · C-15) */
43
43
  footer?: ReactNode
44
44
  }
45
45
 
@@ -1,38 +1,73 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
3
  /**
4
- * `PLATFORM.TOP_USER_BAR` —— 固定 Shell 的**第一带**。
5
- * Standard 52px / Compact 44px,**没有第三种高度**。
4
+ * `PLATFORM.TOP_USER_BAR` —— GAP Design kit「集团顶部导航」,**只在集团版外壳出现**
5
+ * (本带 + 应用一级 + 应用二级,共 144)。基础版外壳不渲染本组件,账户入口由
6
+ * `ApplicationPrimaryNavigation` 的 `account` 承载。
7
+ * Standard 48px / Compact 40px,**没有第三种高度**;内边距 8/12,底部 0.5px 分隔线。
6
8
  *
7
- * 栅格 `auto minmax(0,1fr) auto`;应用切换与账户触发器 32×32,
8
- * 动作簇间距 10px,右边距 12px。
9
+ * 渲染本组件时,其 CSS 在 `:root` 上把 `--ui-shell-top-bar-offset` 抬到本带高度,
10
+ * `--ui-shell-application-total-height` 随之计入本带 —— 宿主不必区分两种外壳。
11
+ *
12
+ * 栅格 `auto minmax(0,1fr) auto`;应用切换触发器 32×32、圆角 12,账户头像 24×24 圆形
13
+ * (32×32 命中区),动作簇间距 10px,右边距 12px。
9
14
  *
10
15
  * ### ⚠ 品牌标识必须始终可见
11
- * 没有真实的 120×32 资产时,渲染已登记的 mock:
12
- * **28×28 纯色块 + 8px 间隙 + 企业名称(14/20 700)**。
16
+ * 品牌区按 GAP Design kit「集团顶部导航」(24:249):
17
+ * **36×36 图形 + 8px 间隙 + 企业名称(20/30 semibold)**,宽度按内容。
18
+ * 名称恒为可见文字;图形位放 `brandLogoSrc`,缺省时渲染已登记的 mock 纯色块。
13
19
  * 色块内部**不得**再绘制伪 Logo。
14
20
  *
15
21
  * ### ⚠ Shell 契约禁止添加未登记元素
16
22
  * 不得加搜索框、面包屑、通知铃铛、页面标题、卡片或阴影。
23
+ *
24
+ * ### 两个面板的接法(06 · P1-13)
25
+ * 回调交出被点的触发器,传给 `Popover` 的 `anchor` 即可锚定;开合由调用方受控,
26
+ * 同时回写 `appSwitchOpen` / `accountOpen`,触发器据此输出 `aria-expanded`。
27
+ * 再点触发器即收起 —— Popover 不把外部锚点上的点击当作外部点击。写法:回调里
28
+ * 记下触发器并切换开合(`setAnchor(trigger); setOpen((v) => !v)`),Popover 传
29
+ * `anchor={anchor} open={open} onOpenChange={setOpen}`。
17
30
  */
18
31
  export interface TopNavigationPrimaryBarProps extends HTMLAttributes<HTMLDivElement> {
19
32
  /** 企业名称。mock 兜底文案登记为「企业名称」 */
20
33
  brandName?: string
21
34
 
22
- /** 真实品牌资产地址(120×32)。缺省时回退到已登记 mock */
35
+ /**
36
+ * 品牌图形地址,按 36×36 渲染(`object-fit: contain`),与 `brandName` 并排;
37
+ * 图形是装饰,可访问名由旁边的名称文字承担。缺省时图形位回退到已登记 mock 色块。
38
+ *
39
+ * 传的是图形标(kit 里的 36px 图形),不是含企业名的横版字标 —— 名称由组件以文字渲染,
40
+ * 再传字标会让名字出现两遍
41
+ */
23
42
  brandLogoSrc?: string
24
43
 
25
44
  /** 中间区域内容。默认为空 —— 加东西前请确认它是已登记元素 */
26
45
  center?: ReactNode
27
46
 
28
- /** 账户名 */
47
+ /**
48
+ * 账户名。同时是账户按钮的可访问名与头像缩写的来源;缩写规则与 `Avatar` 相同 ——
49
+ * 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
50
+ */
29
51
  accountName?: string
30
52
 
31
- /** 应用切换回调 */
32
- onAppSwitch?: () => void
53
+ /**
54
+ * 应用切换回调。参数是被点的触发器,供 `Popover` 的 `anchor` 锚定;
55
+ * 不需要锚定的调用方照旧写无参函数
56
+ */
57
+ onAppSwitch?: (trigger: HTMLButtonElement) => void
58
+
59
+ /** 账户菜单回调。参数同 `onAppSwitch` */
60
+ onAccount?: (trigger: HTMLButtonElement) => void
33
61
 
34
- /** 账户菜单回调 */
35
- onAccount?: () => void
62
+ /**
63
+ * 应用切换面板是否展开。传入(含 `false`)即声明该触发器控制一个弹出面板:
64
+ * 输出 `aria-haspopup="dialog"` 与 `aria-expanded`。缺省时两者都不输出 ——
65
+ * 不知道面板开没开,宁可不说也不能说错。面板内容根应声明 `role="dialog"` 与可访问名
66
+ */
67
+ appSwitchOpen?: boolean
68
+
69
+ /** 账户面板是否展开。语义同 `appSwitchOpen` */
70
+ accountOpen?: boolean
36
71
  }
37
72
 
38
73
  /*
@@ -40,4 +75,9 @@ export interface TopNavigationPrimaryBarProps extends HTMLAttributes<HTMLDivElem
40
75
  * 不属于 N3 / F9 那类跨层耦合。
41
76
  *
42
77
  * 品牌资产缺失是已登记的 SUBSTITUTION,见 02 §6.2。
78
+ *
79
+ * ─── 品牌区按 kit 改(2026-11-10,round-01 之后的 kit 差异补齐)───────────────
80
+ *
81
+ * 由「120×32 字标资产,或 28×28 色块 + 14/20 bold 名称」改为 kit 的「36 图形 + 20/30 semibold
82
+ * 名称」,两种情况下名称都以文字渲染。`brandLogoSrc` 的含义随之由字标变为图形标。
43
83
  */