@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
@@ -3,9 +3,14 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后的列表。
5
5
  *
6
- * 推荐宽度 680px,底部动作区固定。
6
+ * 推荐宽度 680px。
7
7
  *
8
- * ⚠ **它说「关闭」,独立详情页说「返回」。** 深链接只指向独立详情页。
8
+ * 页头(GAP Design kit「抽屉 / 常规」;业财平台 round-01 裁决,2026-11-10):48 高、左右 12、
9
+ * 0.5px 下边线;左侧标题与副标题同行 14/20,右侧依次为主动作、次要动作组、32×32 纯图标
10
+ * 关闭键,间隔 4。**没有底部动作区** —— 动作一律在页头。
11
+ *
12
+ * ⚠ **它的关闭键可访问名是「关闭」,独立详情页的退出是写着「返回」的按钮。**
13
+ * 深链接只指向独立详情页。
9
14
  *
10
15
  * ⚠ **关闭时必须还原来源页面的**:业务视图、搜索、筛选、排序、分页、
11
16
  * 页面模式、当前对象、滚动位置。少还原任何一项都算缺陷。
@@ -28,10 +33,16 @@ export interface ApplicationDetailDrawerProps extends Omit<HTMLAttributes<HTMLDi
28
33
  /** 宽度,单位 px。推荐 680 */
29
34
  width?: number
30
35
 
31
- /** **唯一**的主对象动作,固定在右下角 */
36
+ /**
37
+ * 从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`,
38
+ * 免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8)
39
+ */
40
+ side?: 'left' | 'right'
41
+
42
+ /** **唯一**的主对象动作,渲染在页头右侧动作区的最左(kit:主按钮在前) */
32
43
  primaryAction?: ReactNode
33
44
 
34
- /** 次要动作组 */
45
+ /** 次要动作组,渲染在主动作之后、关闭键之前。超过两三个时收进「更多」 */
35
46
  secondaryActions?: ReactNode
36
47
 
37
48
  /** 关闭回调。**必须在此还原来源页面上下文** */
@@ -41,4 +52,10 @@ export interface ApplicationDetailDrawerProps extends Omit<HTMLAttributes<HTMLDi
41
52
  children?: ReactNode
42
53
  }
43
54
 
44
- /* 三方对照一致(.d.ts + .prompt.md)。 */
55
+ /*
56
+ * 三方对照一致(.d.ts + .prompt.md)。
57
+ *
58
+ * 业财平台 round-01 · 裁决(以 GAP Design kit 为准):关闭由「关闭」描边文字按钮改为纯图标;
59
+ * 主动作与次要动作由底部固定动作区移到页头右侧,底部动作区取消。「抽屉说关闭、独立详情页
60
+ * 说返回」的结构区分保留在可访问名与独立详情页的「返回」按钮上。
61
+ */
@@ -3,11 +3,18 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 业务对象的新建与编辑表单对话框。
5
5
  *
6
- * 已登记宽度:`small` 720px、`large` 960px,**只有这两种**,
7
- * 且**绝不超出有效视口**。
6
+ * 已登记宽度:`small` 720px、`large` 960px、`xlarge` 1280px,**只有这三种**,
7
+ * 且**绝不超出有效视口**。1280 是 GAP Design kit 弹窗宽度区间的上限(业财平台 round-01 裁决)。
8
8
  *
9
9
  * 字段以 `Field` 子元素传入,默认排布在两列网格上;
10
- * 需要跨列的字段传 `style={{ gridColumn: '1 / -1' }}`。
10
+ * 需要跨列的字段给 `Field` 传 `span="full"`。
11
+ *
12
+ * 页头右侧恒有一个纯图标的关闭按钮(可访问名「关闭」),行为等同 `onCancel`,
13
+ * 提交中禁用 —— 与 `Dialog` 一致。
14
+ *
15
+ * 外观(GAP Design kit「抽屉弹窗 / 弹窗」188:685,业财平台 round-01 起):面板圆角 20;
16
+ * 48px 灰底页头,标题与关闭键间隔 10;主体灰底、内含一张白卡承载字段网格,字段间距 10;
17
+ * 底部动作区同为灰底、内边距 12、动作间隔 4、顶部 0.5px 分隔线。
11
18
  *
12
19
  * ⚠ **提交失败显示为主体顶部的 `Alert`,不是 toast** ——
13
20
  * 用户必须处理的失败绝不能放进转瞬即逝的提示里。
@@ -19,11 +26,15 @@ export interface ApplicationFormDialogProps extends Omit<HTMLAttributes<HTMLDivE
19
26
  /** 标题 */
20
27
  title?: ReactNode
21
28
 
22
- /** 标题下的补充说明 */
29
+ /** 补充说明,与标题同行、以 14/20 label 色跟在标题之后。只写一句短语 */
23
30
  description?: ReactNode
24
31
 
25
- /** 宽度档位。720px / 960px */
26
- size?: 'small' | 'large'
32
+ /**
33
+ * 宽度档位。`small` 720px / `large` 960px / `xlarge` 1280px。
34
+ * `xlarge` 是 GAP Design kit 弹窗宽度区间(680–1280)的上限,用于字段多、需要左右并排
35
+ * 原件与表单的编辑场景(业财平台 round-01 · editor/dialog/width 裁决,2026-11-10)
36
+ */
37
+ size?: 'small' | 'large' | 'xlarge'
27
38
 
28
39
  /** 字段网格列数。默认 2 */
29
40
  columns?: number
@@ -43,9 +54,23 @@ export interface ApplicationFormDialogProps extends Omit<HTMLAttributes<HTMLDivE
43
54
  /** 提交回调 */
44
55
  onSubmit?: () => void
45
56
 
46
- /** 取消回调 */
57
+ /** 取消回调。页头关闭按钮、Esc 与遮罩点击同样触发它 */
47
58
  onCancel?: () => void
48
59
 
60
+ /**
61
+ * 底部动作区的附加次要动作,排在「取消」与提交按钮之间,例如逐条编辑时的
62
+ * 「上一张」「下一张」。传 `SystemButton`(`intent="secondary"`)。
63
+ *
64
+ * **不得**放第二个 primary,也不得放删除类动作 —— 删除不与提交并排出现在页脚。
65
+ */
66
+ secondaryActions?: ReactNode
67
+
68
+ /**
69
+ * 底部动作区左侧的一段说明,12/16 label 色,例如「共 100 条,当前第 6 条」。
70
+ * 只写与本次提交相关的上下文;校验错误与提交失败**不得**写在这里(前者在字段、后者是 `error`)。
71
+ */
72
+ footerNote?: ReactNode
73
+
49
74
  /** 表单字段,传 `Field` 子元素 */
50
75
  children?: ReactNode
51
76
  }
@@ -12,15 +12,19 @@ export interface GlobalActionTab {
12
12
 
13
13
  /**
14
14
  * 四个 popover 型全局动作**共享的同一个面板** ——
15
- * 消息 / 待办 / 运行总览 / 风险预警。
15
+ * 消息 / 待办 / 总览 / 风险预警。
16
16
  *
17
17
  * ⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**
18
18
  *
19
19
  * 宽 720px(`--ui-shell-global-action-popover-width`),20px 圆角,
20
- * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开。
20
+ * 最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开 ——
21
+ * 视口约束按「视口高 − 外壳总高 − 16px」计算,底边不越出视口。
21
22
  *
22
- * ⚠ **设置**打开的是 Drawer / Sheet,不走本面板;
23
- * 且**绝不能存在第二个设置入口**。
23
+ * 非模态:不锁滚动、不陷阱焦点。**Esc 关闭**由本组件承担(进库内的 Esc 层级栈,
24
+ * 上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。外点击关闭由调用方判定。
25
+ *
26
+ * ⚠ **设置**不走本面板:它让 `ApplicationSecondaryNavigation` 换成设置模块
27
+ * (`onAction` 给它的 `kind` 是 `'module'`);且**绝不能存在第二个设置入口**。
24
28
  */
25
29
  export interface ApplicationGlobalActionPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
26
30
  /** 是否打开。为 false 时渲染 `null` */
@@ -41,10 +45,27 @@ export interface ApplicationGlobalActionPanelProps extends Omit<HTMLAttributes<H
41
45
  /** 面板底部内容,如「全部标记为已读」 */
42
46
  footer?: ReactNode
43
47
 
44
- /** 无条目时的空态,应传 `Empty`。文案须区别于无权限与加载失败 */
48
+ /**
49
+ * 面板主体的系统状态(06 · P2-18)。`ready` 渲染 `children`,其余渲染对应槽位:
50
+ * `loading` → `loading`、`empty` → `emptyState`、`error` → `error`、
51
+ * `no-permission` → `noPermission`。缺省时保持原行为:有 `children` 渲染它,
52
+ * 否则渲染 `emptyState`
53
+ */
54
+ state?: 'ready' | 'loading' | 'empty' | 'error' | 'no-permission'
55
+
56
+ /** Loading 状态内容。应传贴近条目结构的 `Skeleton`,而非通用转圈 */
57
+ loading?: ReactNode
58
+
59
+ /** 无条目时的空态,应传 `Empty`。文案须点明当前标签的口径,区别于无权限与加载失败 */
45
60
  emptyState?: ReactNode
46
61
 
47
- /** 关闭回调 */
62
+ /** Error 状态内容。应说明失败原因并提供重试 */
63
+ error?: ReactNode
64
+
65
+ /** No Permission 状态内容。措辞必须区别于空态 */
66
+ noPermission?: ReactNode
67
+
68
+ /** 关闭回调。关闭按钮与 Esc 都会调用;外点击由调用方自行调用 */
48
69
  onClose?: () => void
49
70
 
50
71
  /** 面板内容,通常是一组 `Message` */
@@ -12,7 +12,8 @@ import type { HTMLAttributes, ReactNode } from 'react'
12
12
  * 2. **每区 4–6 张,等高。**
13
13
  * 3. **页面没有真实指标时整个区域不渲染** —— 不得用占位卡凑数。
14
14
  *
15
- * 五个组件共享同一张卡片壳(等高、16px 圆角、1px 边框、无阴影)。
15
+ * 五个组件共享同一个指标壳(等高、无阴影)。GAP Design kit(业财平台 round-01)下
16
+ * 指标**不是卡片**:没有边框、底色与内边距,直接落在页面底色上,高 76。
16
17
  */
17
18
 
18
19
  /** MetricStrip 内置的基础指标条目(numeric / icon 语义) */
@@ -21,28 +22,57 @@ export interface Metric {
21
22
  key?: string
22
23
  /** 指标名,12/16 label 色 */
23
24
  label: ReactNode
24
- /** 指标值,24/32 semibold,等宽数字 */
25
+ /** 指标值,32/32 semibold,等宽数字 */
25
26
  value: ReactNode
27
+ /**
28
+ * 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。
29
+ * 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 ——
30
+ * 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。
31
+ */
32
+ description?: ReactNode
26
33
  /** 单位,紧随数值以 12px regular 显示 */
27
34
  unit?: string
28
35
  /** 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 */
29
36
  icon?: ReactNode
30
37
  }
31
38
 
39
+ /** 指标区的加载状态。指标区没有 empty —— 无真实指标时整个区域不渲染 */
40
+ export type MetricStripState = 'ready' | 'loading' | 'error'
41
+
32
42
  /**
33
43
  * 指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。
34
44
  *
35
45
  * 其他语义的卡片作为 `children` 传入,由本容器统一等高排列。
46
+ *
47
+ * ⚠ 加载与失败由 `state` 表达(06 · P2-10):`loading` 渲染与卡片同壳同高的骨架,
48
+ * `error` 渲染一张横跨整行的卡片承载 `error` 节点。两者都不是「无指标」的替身 ——
49
+ * 页面没有真实指标时仍是整个区域不渲染。
36
50
  */
37
51
  export interface ApplicationMetricStripProps extends HTMLAttributes<HTMLDivElement> {
38
52
  /** 基础指标集合 */
39
53
  metrics?: Metric[]
40
54
 
41
- /** 列数。默认取指标数量,上限 6 */
55
+ /**
56
+ * 列数。默认取卡片总数 —— `metrics` 条目数加 `children` 中的卡片数
57
+ * (null / false / undefined 不计入),钳在 1–6 之间
58
+ */
42
59
  columns?: number
43
60
 
44
61
  /** 其他语义的指标卡(trend / chart / status / primary-secondary) */
45
62
  children?: ReactNode
63
+
64
+ /**
65
+ * 加载状态,默认 `ready`。`loading` 时不渲染 `metrics` 与 `children`,改渲染
66
+ * 内置骨架:张数同 `columns` 的缺省算法(无卡片时为 4),每张与指标卡同壳同高;
67
+ * `error` 时渲染一张横跨整行的卡片,内容取 `error`
68
+ */
69
+ state?: MetricStripState
70
+
71
+ /**
72
+ * `state="error"` 时的内容。应说明失败原因并提供重试(如「指标加载失败」+「重试」),
73
+ * 措辞不得与数据展示区的 Error 共用。不传时显示内置的「指标加载失败」
74
+ */
75
+ error?: ReactNode
46
76
  }
47
77
 
48
78
  /**
@@ -97,7 +127,10 @@ export interface ApplicationMetricChartProps extends HTMLAttributes<HTMLDivEleme
97
127
  value?: ReactNode
98
128
  /** 单位 */
99
129
  unit?: string
100
- /** 走势数据点 */
130
+ /**
131
+ * 走势数据点。纵轴按本组数据的 min–max 归一化(不从 0 起算),
132
+ * 只表达形状、不表达绝对量级;全部相等时画在中线
133
+ */
101
134
  data?: number[]
102
135
  /** 分类色序号,索引 `--application-categorical-01…20`。**不是状态色** */
103
136
  colorIndex?: number
@@ -3,15 +3,15 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。
5
5
  *
6
- * 已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、16px 圆角、32px 默认高度。
7
- * 16px 圆角在 32px 高度下使等宽图标按钮自然成圆,系统内**没有**独立的 pill / circle token。
6
+ * 已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、12px 圆角、32px 默认高度。
7
+ * 圆角取控件角色 `--ds-radius-control`(GAP Design kit「圆角12」);等宽图标按钮为 12 圆角方形。
8
8
  *
9
- * 应用层存在稳定语义适配器时应优先使用 `SystemButton`。
9
+ * **业务页面一律用 `SystemButton`**,本组件只供库内组件使用(实践报告 P1-1 裁决)。
10
10
  * 业务页面不得再造第二套基础按钮视觉。
11
11
  *
12
12
  * 按下态只有颜色变化 —— 不得有缩放、位移或阴影变化。
13
13
  *
14
- * @replaces button
14
+ * 原生 `<button>` 的替换目标是 `SystemButton`,替换登记写在那份契约的 JSDoc 上。
15
15
  */
16
16
  export interface ButtonProps
17
17
  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'size'> {
@@ -19,10 +19,11 @@ export interface ButtonProps
19
19
  * 视觉语义。
20
20
  * `primary` 用于页面主操作,每个动作组内至多一个;
21
21
  * `secondary` 用于次要操作,是默认值;
22
- * `destructive` 用于不可逆的删除类操作;
22
+ * `destructive` 用于不可逆的删除类操作(实心危险色);
23
+ * `destructive-outline` 白底、危险色描边与文字,用于与次要按钮并排的删除类动作;
23
24
  * `link` 用于行内跳转,无内边距、带下划线。
24
25
  */
25
- variant?: 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'link'
26
+ variant?: 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'destructive-outline' | 'link'
26
27
 
27
28
  /**
28
29
  * 尺寸,映射高度 24 / 28 / 32 / 40px。
@@ -40,6 +41,9 @@ export interface ButtonProps
40
41
  /**
41
42
  * 禁用。禁用时不触发 onClick 并移出 tab 顺序。
42
43
  * 禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。
44
+ *
45
+ * 传 `aria-disabled="true"` 得到同一套禁用外观但保持可聚焦(`SystemButton`
46
+ * 的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。
43
47
  */
44
48
  disabled?: boolean
45
49
 
@@ -5,8 +5,8 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
5
5
  *
6
6
  * 在多个选项中择一请用 `ToggleGroup`;页面模式切换一律不用本组件。
7
7
  *
8
- * 选中态为淡强调色洗(`--application-selected`)+ 强调前景。
9
- * 纯文字内容下选中**不得仅靠颜色**表达。
8
+ * 选中态为淡强调色洗(`--application-selected`)+ 强调前景,另有 1px 前景色描边 ——
9
+ * 描边是非颜色标识,纯文字内容下选中也不只靠颜色表达,调用方无须另补。
10
10
  *
11
11
  * 通过 `aria-pressed` 上报状态。
12
12
  */
@@ -30,7 +30,7 @@ export interface ToggleProps
30
30
  */
31
31
  iconOnly?: boolean
32
32
 
33
- /** 开关内容。`iconOnly` 为 true 时放单个 `Icon`;纯文字内容下选中不得仅靠颜色表达 */
33
+ /** 开关内容。`iconOnly` 为 true 时放单个 `Icon` */
34
34
  children?: ReactNode
35
35
  }
36
36
 
@@ -3,12 +3,14 @@ import type { HTMLAttributes } from 'react'
3
3
  /**
4
4
  * 人员或组织的身份标记 —— 人员选择器、联系人列表、审计轨迹、记录负责人。
5
5
  *
6
- * 无图片时回退为文字缩写:**中文名取首字,拉丁名取首字母缩写**。
6
+ * 无图片时回退为文字缩写:**中文名取末字,拉丁名取首字母缩写**。
7
+ * 取末字(07 · C-8):「张伟」→「伟」,占位符「成员 A」→「A」—— 取首字时同姓者与
8
+ * 同一占位符前缀下的头像缩写全相同,无从区分。
7
9
  *
8
10
  * ⚠ **绝不用 Emoji 或装饰性字形代替头像。**
9
11
  */
10
12
  export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
11
- /** 姓名或组织名。用于生成回退缩写,同时作为悬浮提示 */
13
+ /** 姓名或组织名。用于生成回退缩写,同时作为头像图片的替代文本(不渲染原生悬浮提示) */
12
14
  name?: string
13
15
 
14
16
  /** 真实头像地址。存在时优先于文字缩写 */
@@ -33,4 +35,5 @@ export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
33
35
  * 而惯例应为首字母缩写 "JS"。
34
36
  * 裁决:拉丁名按空格分词取各词首字母(最多两个),中文保持取首字。
35
37
  * 契约不变,实现阶段修正。
38
+ * 后续(07 · C-8):中文分支改为取末字,见上方接口注释。
36
39
  */
@@ -3,15 +3,17 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 紧凑的状态或分类标签 —— 行、卡片、指标、详情头。
5
5
  *
6
- * 20px 高,4px 圆角,12/16 字号。
6
+ * 24px 高,20px 圆角(胶囊),左右 10 上下 4,12/16 字号(GAP Design kit「标签」)。
7
+ * soft 档底色为 tone 语义色 10% 透明(neutral 为文字色 6%),前景取 tone 语义色。
7
8
  *
8
9
  * ⚠ **状态色只来自功能状态色板。** 图表分类色(20 色)绝不能用来表达状态。
9
10
  *
10
- * 一个 tone 在整个产品内只能有一个含义 —— 不要在 A 页面用 warning 表示「待整改」、
11
- * 在 B 页面用它表示「即将到期」。
11
+ * 一个 tone 在同一维度内只能有一个含义 —— 不要在 A 页面用 warning 表示「待整改」、
12
+ * 在 B 页面用它表示「即将到期」。同屏有两个状态维度(处理状态与风险等级)时,
13
+ * 用 `variant` 区分维度:一个维度 `soft`、另一个 `outline`,tone 可以跨维度复用(07 · C-9)。
12
14
  */
13
15
  export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
14
- /** 语义色调。每个 tone 在全产品内含义唯一 */
16
+ /** 语义色调。每个 tone 在同一维度内含义唯一;不同维度用 `variant` 区分 */
15
17
  tone?: 'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info'
16
18
 
17
19
  /** 视觉变体。`soft` 为淡色底,`outline` 为透明底加描边 */
@@ -4,10 +4,14 @@ import type { HTMLAttributes, ReactNode } from 'react'
4
4
  * 标准页面承载面 —— CardList 磁贴、工作台面板、图表容器、表单分节。
5
5
  *
6
6
  * 已登记契约:**只有两档密度** —— `default`(16px 节奏)与 `sm`(12px),
7
- * 16px 圆角,1px 边框,**默认无装饰阴影**。不要给它加阴影。
7
+ * `default` 的节奏随视口密度档收为 16 / 12 / 10(07 · C-17),`sm` 在 Compact 档同取 10;
8
+ * 20px 圆角(GAP Design kit「圆角20」),1px 边框,**默认无装饰阴影**。不要给它加阴影。
8
9
  */
9
10
  export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
10
- /** 密度。`default` 内边距与间隙均 16px,`sm` 均 12px。没有第三档 */
11
+ /**
12
+ * 密度。`default` 内边距与间隙均 16px(Condensed 视口 12、Compact 视口 10),
13
+ * `sm` 均 12px(Compact 视口 10)。没有第三档 —— 视口档不是 prop,由 `@media` 自动生效
14
+ */
11
15
  density?: 'default' | 'sm'
12
16
 
13
17
  /** 卡片标题。16/24 medium 字重,超长省略 */
@@ -11,8 +11,10 @@ export interface ChartSeries {
11
11
  /**
12
12
  * 图表基元 —— ANALYSIS 分析页、指标卡、报表摘要。
13
13
  *
14
- * 系列配色按顺序取自共享的 20 色分类色板
14
+ * 系列配色取自共享的 20 色分类色板
15
15
  * (`--application-categorical-01…20`,`hsl(H, 24%, 53%)`,H 每 18° 一步)。
16
+ * 按系列数跳步取色:共 n 条系列时,从 01 号色起每隔 ⌊20/n⌋ 号取一色,使相邻系列的
17
+ * 色相拉开(2 条差 180°、3 条差 108°;11 条起才逐号取)。首条系列恒为 01 号色。
16
18
  * 同亮度设计使整组图表读起来是一家人。
17
19
  *
18
20
  * ⚠ **分类色只编码分类,绝不能替代功能状态色。**
@@ -20,24 +22,32 @@ export interface ChartSeries {
20
22
  *
21
23
  * ⚠ 当图表是当前的 Data Presentation 时,
22
24
  * 其设置按钮**必须**写作「图表设置」,不得写成通用的「视图设置」。
25
+ *
26
+ * 根节点渲染为 `role="figure"`,可访问名称由调用方以 `aria-label`(或
27
+ * `aria-labelledby`)给出,落在该 figure 上;绘图 svg 是 `aria-hidden` 的,
28
+ * 标签行与图例文字对读屏器保持可读。
23
29
  */
24
30
  export interface ChartProps extends HTMLAttributes<HTMLDivElement> {
25
- /** 图表类型 */
31
+ /** 图表类型。默认 `'line'` */
26
32
  type?: 'line' | 'area' | 'bar'
27
33
 
28
- /** 数据系列集合。配色按数组顺序分配 */
34
+ /** 数据系列集合。配色按数组顺序与系列总数分配(跳步规则见组件说明) */
29
35
  series: ChartSeries[]
30
36
 
31
- /** X 轴标签。见 D6 —— 当前实现按均分排布,与数据点不对齐 */
37
+ /**
38
+ * X 轴标签。见 D6 —— 折线 / 面积图按均分排布,与数据点不对齐;
39
+ * 柱状图按等宽列居中,标签数等于类目数时落在各柱组中心。
40
+ * 标签不折行,放不下时以省略号截断,完整文字见悬停提示
41
+ */
32
42
  labels?: string[]
33
43
 
34
- /** 绘图区高度,单位 px */
44
+ /** 绘图区高度,单位 px。默认 200 */
35
45
  height?: number
36
46
 
37
- /** 显示图例 */
47
+ /** 显示图例。默认 `true` */
38
48
  showLegend?: boolean
39
49
 
40
- /** 显示水平网格线 */
50
+ /** 显示水平网格线。默认 `true` */
41
51
  showGrid?: boolean
42
52
  }
43
53
 
@@ -56,6 +66,8 @@ export interface ChartProps extends HTMLAttributes<HTMLDivElement> {
56
66
  * 与任何圆角都会随容器宽高比变形。
57
67
  * 2. labels 用 justify-content: space-between 均分排布,不与数据点对齐。
58
68
  * prompt.md 的示例本身就是 3 个 label 配 6 个数据点 —— 即设计上不对齐。
69
+ * (06 · P3-20 之后柱状图改为等宽列居中,标签数等于类目数时对准柱组中心;
70
+ * 折线 / 面积图仍按本条均分。)
59
71
  *
60
72
  * 实现阶段决定:是接受这是一个「示意图基元」(保持简化,文档写明不适用于
61
73
  * 精确读数场景),还是升级为真实的图表实现。前者成本低且与 readme
@@ -3,8 +3,8 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 消息流的滚动容器。
5
5
  *
6
- * ⚠ 这是一个**有界的、正交的**滚动区域,是 Content Canvas 单一垂直滚动权的
7
- * 合法局部例外。**必须给显式高度** —— 不得在 Content Canvas 内堆叠无界的
6
+ * ⚠ 这是一个**有界的、正交的**滚动区域,是页面级纵向滚动持有者(按页型归属,06 · D-4)
7
+ * 之外的合法局部例外。**必须给显式高度** —— 不得在 Content Canvas 内堆叠无界的
8
8
  * 垂直滚动容器。
9
9
  */
10
10
  export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
@@ -12,8 +12,8 @@ export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
12
12
  height?: number | string
13
13
 
14
14
  /**
15
- * 新内容到达时自动滚到底部。
16
- * 见 D7 —— 当前实现无条件拉到底,用户翻阅历史时会被打断。
15
+ * 新内容到达时自动滚到底部 —— 仅当用户此前已贴近底部(48px 阈值内)时生效,
16
+ * 翻阅历史时不打断(D7 已在阶段 4 修正)。
17
17
  */
18
18
  stickToBottom?: boolean
19
19
 
@@ -24,7 +24,7 @@ export interface MessageScrollerProps extends HTMLAttributes<HTMLDivElement> {
24
24
  /*
25
25
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
26
26
  *
27
- * D7 stickToBottom 无条件生效。
27
+ * D7 stickToBottom 无条件生效。—— 已修正,见上方 prop 注释(06 · P1-12)。
28
28
  * 源实现在每次 children 变化时直接 scrollTop = scrollHeight,
29
29
  * 用户正在向上翻阅历史消息时会被强制拽回底部。
30
30
  * 裁决:改为「仅当用户当前已贴近底部(阈值内)时才自动滚动」。
@@ -23,7 +23,11 @@ export interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
23
23
  /** 轨道高度,单位 px */
24
24
  height?: number
25
25
 
26
- /** 轨道上方的说明文字,12/16 label 色 */
26
+ /**
27
+ * 轨道上方的说明文字,12/16 label 色。同时是 progressbar 的可访问名称
28
+ * (以 `aria-labelledby` 关联)。不给 `label` 时应传 `aria-label`,
29
+ * 它同样落在 progressbar 上而不是根节点
30
+ */
27
31
  label?: ReactNode
28
32
  }
29
33
 
@@ -3,7 +3,13 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 带可拖拽分隔条的双栏布局,支撑 SPLIT 工作面。
5
5
  *
6
- * 默认左栏 360px,与 `--ui-sidebar-list-width` 一致。
6
+ * 默认左栏 360px,与 `--ui-sidebar-list-width` 的 Standard 档一致。
7
+ *
8
+ * 宽度类 prop 收**数字或 CSS 长度字符串**(06 · P1-20):数字按 px,字符串原样
9
+ * 交给 CSS —— 传 `'var(--ui-sidebar-list-width)'` 即跟随密度档(360 / 300),
10
+ * 也可以写 `'30%'`、`'20rem'`。**拖拽与方向键调整后回调的恒为 px 数字**,按调整
11
+ * 那一刻的渲染宽度换算;受控方把它写回 `size` 之后,该栏就不再跟随原字符串里的
12
+ * `var()` / 百分比 —— 要恢复跟随,把 `size` 写回原字符串。
7
13
  *
8
14
  * ⚠ **拖动分栏永远不改变 `pageMode`。** 它只是布局调整。
9
15
  *
@@ -17,20 +23,23 @@ export interface ResizableProps extends HTMLAttributes<HTMLDivElement> {
17
23
  /** 右栏内容,占据剩余宽度 */
18
24
  right?: ReactNode
19
25
 
20
- /** 左栏初始宽度,单位 px */
21
- defaultSize?: number
26
+ /** 左栏初始宽度。数字按 px,字符串为任意 CSS 长度。默认 360 */
27
+ defaultSize?: number | string
22
28
 
23
- /** 受控左栏宽度 */
24
- size?: number
29
+ /** 受控左栏宽度。数字按 px,字符串为任意 CSS 长度(如 `'var(--ui-sidebar-list-width)'`) */
30
+ size?: number | string
25
31
 
26
- /** 宽度变化回调。拖动过程中持续触发 */
32
+ /**
33
+ * 宽度变化回调。拖动过程中持续触发。
34
+ * **参数恒为 px 数字**(已钳在 `min`–`max` 之间),不回传字符串
35
+ */
27
36
  onSizeChange?: (size: number) => void
28
37
 
29
- /** 左栏最小宽度,单位 px */
30
- min?: number
38
+ /** 左栏最小宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 240 */
39
+ min?: number | string
31
40
 
32
- /** 左栏最大宽度,单位 px */
33
- max?: number
41
+ /** 左栏最大宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 720 */
42
+ max?: number | string
34
43
  }
35
44
 
36
45
  /*
@@ -3,7 +3,8 @@ import type { HTMLAttributes, ReactNode } from 'react'
3
3
  /**
4
4
  * 有界滚动区域,带细样式滚动条 —— 长筛选列表、宽表格、必须单行的标签条。
5
5
  *
6
- * ⚠ **Content Canvas 是页面唯一的主垂直滚动权持有者。**
6
+ * ⚠ **每个页面只有一个页面级纵向滚动持有者**:结果集页面是 `ApplicationDataDisplay`
7
+ * 的主体,其余页面是 Content Canvas(06 · D-4)。
7
8
  * 本组件只用于**正交方向**(水平)或**局部有界**的溢出。
8
9
  * 绝不堆叠无界的垂直滚动容器。
9
10
  */
@@ -17,7 +17,7 @@ export interface SeparatorProps extends HTMLAttributes<HTMLDivElement> {
17
17
  /** 居中标签。提供时线被文字断开,用于长列表的分段标题 */
18
18
  label?: ReactNode
19
19
 
20
- /** 分隔线两侧的外边距。应传 token,如 `var(--ds-space-2)` */
20
+ /** 分隔线两侧的外边距。应传 token,如 `var(--application-space-2)` */
21
21
  spacing?: string | number
22
22
  }
23
23
 
@@ -20,6 +20,22 @@ export interface TableColumn<R = unknown> {
20
20
  priority?: 'primary' | 'default' | 'low'
21
21
  /** 单元格渲染函数。提供时取代按 `key` 取值 */
22
22
  render?: (row: R) => ReactNode
23
+ /**
24
+ * 固定列。横向滚动时该列贴住表格左缘或右缘,朝滚动内容一侧带 16px 渐隐阴影。
25
+ *
26
+ * **只允许首列声明 `'left'`、末列声明 `'right'`,每侧至多一列** ——
27
+ * 不计算多列叠加偏移。声明在中间列上不报错,但滚动时会与相邻列重叠。
28
+ * 典型用法:末列「操作」固定在右侧。有选择列时,首列固定会连同选择列一起固定。
29
+ */
30
+ fixed?: 'left' | 'right'
31
+ }
32
+
33
+ /** 数据行之后的通栏行 */
34
+ export interface TableTrailingRow {
35
+ /** 行内容,横跨全部列居中显示。例如「识别中…」「正在加载更多」 */
36
+ content: ReactNode
37
+ /** 进行中。叠加一层扫光动效;系统开启减少动效时不播放 */
38
+ busy?: boolean
23
39
  }
24
40
 
25
41
  /** 排序状态 */
@@ -33,7 +49,8 @@ export interface TableSort {
33
49
  /**
34
50
  * DataTable 承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏。
35
51
  *
36
- * 表头位于 `--application-table-header`,行与行之间用 1px 分隔线,**不是阴影**。
52
+ * 表头位于 `--application-table-header`,高 44;表体行最小高 56(两行内容 72)。
53
+ * 行与行之间、表头列与列之间是 0.5px 分隔线(`--application-hairline`),**不是投影**。
37
54
  *
38
55
  * ⚠ 当本组件是当前的 Data Presentation 时,
39
56
  * 其上方的设置按钮**必须**写作「列设置」,不得写成通用的「视图设置」。
@@ -61,7 +78,7 @@ export interface TableProps<R = unknown> extends HTMLAttributes<HTMLDivElement>
61
78
  /** 选中集合变化回调。表头全选框会一次性给出全部或空数组 */
62
79
  onSelectedChange?: (ids: string[]) => void
63
80
 
64
- /** 行点击回调。设置后整行 `cursor: pointer` */
81
+ /** 行点击回调。设置后整行 `cursor: pointer`、可聚焦,Enter / 空格同样触发 */
65
82
  onRowClick?: (row: R) => void
66
83
 
67
84
  /** 受控排序状态 */
@@ -78,6 +95,13 @@ export interface TableProps<R = unknown> extends HTMLAttributes<HTMLDivElement>
78
95
 
79
96
  /** 密度。影响单元格内边距 */
80
97
  density?: 'default' | 'sm'
98
+
99
+ /**
100
+ * 数据行之后追加的一条通栏行,横跨全部列。用于「识别中…」「正在加载更多」这类
101
+ * 附着在列表末尾的进行中状态。`rows` 为空时不渲染(此时显示 `empty`)。
102
+ * **不得**用它承载数据行、合计行或分组标题 —— 那些有各自的列语义。
103
+ */
104
+ trailingRow?: TableTrailingRow
81
105
  }
82
106
 
83
107
  /*
@@ -10,6 +10,11 @@ import type { HTMLAttributes, ReactNode } from 'react'
10
10
  * 破坏性确认必须是显式选择。
11
11
  *
12
12
  * 需要用户填写内容的一律用 `Dialog`。
13
+ *
14
+ * 版式照 GAP Design kit「弹窗 / 提示」(188:687):宽 680、最小高 240,不接受尺寸调整;
15
+ * 面板圆角 20,与其余模态弹窗同取 `--ds-radius-dialog`。页头、主体、页脚与 `Dialog` 同一套三段结构,
16
+ * 页头在标题前多一个 20px 的提示图标(`circle-alert`,警示色),图标、标题、关闭键间隔 8;
17
+ * 说明在主体内居中,16/20。
13
18
  */
14
19
  export interface AlertDialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
15
20
  /** 是否打开。为 false 时组件渲染 `null` */
@@ -18,7 +23,7 @@ export interface AlertDialogProps extends Omit<HTMLAttributes<HTMLDivElement>, '
18
23
  /** 标题。须写明后果与受影响数量 */
19
24
  title?: ReactNode
20
25
 
21
- /** 说明文字。用于补充不可恢复性等关键信息 */
26
+ /** 说明文字,主体内居中,16/20 文字1。用于补充不可恢复性等关键信息 */
22
27
  description?: ReactNode
23
28
 
24
29
  /** 确认按钮文案。应是具体动词(「删除」)而非泛化的「确定」 */
@@ -27,7 +32,7 @@ export interface AlertDialogProps extends Omit<HTMLAttributes<HTMLDivElement>, '
27
32
  /** 取消按钮文案 */
28
33
  cancelText?: string
29
34
 
30
- /** 破坏性动作。确认按钮转为 danger 色 */
35
+ /** 破坏性动作。确认按钮转为 danger 色;页头的提示图标不随之变化,仍取警示色 */
31
36
  destructive?: boolean
32
37
 
33
38
  /** 确认回调 */
@@ -36,7 +41,7 @@ export interface AlertDialogProps extends Omit<HTMLAttributes<HTMLDivElement>, '
36
41
  /** 取消回调。关闭按钮亦触发 */
37
42
  onCancel?: () => void
38
43
 
39
- /** 额外内容,插在说明与按钮之间。用于列出受影响对象等 */
44
+ /** 额外内容,在主体内排在说明之后。用于列出受影响对象等 */
40
45
  children?: ReactNode
41
46
  }
42
47