@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,11 +1,12 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
3
  /**
4
- * 单个显隐区域,由一个触发器控制 —— 查询工具栏里的「更多筛选」模式。
4
+ * 单个显隐区域,由一个触发器控制 —— 详情页的次要分节、表单里的高级选项。
5
5
  *
6
- * ⚠ **折叠只改变入口,绝不移除能力。** 被收起的筛选项仍然存在、仍可使用。
6
+ * ⚠ **折叠只改变入口,绝不移除能力。** 被收起的内容仍然存在、仍可使用。
7
7
  *
8
- * 「更多筛选」通过「应用」提交,生效的条件须回写到筛选标签行。
8
+ * ⚠ 查询工具栏的「更多筛选」**不用本组件**,一律用 `Popover`:就地展开会把工具栏
9
+ * 撑高(实测 99px → 452px),SPLIT 页的两栏随之被压扁(06 · D-4)。
9
10
  *
10
11
  * 多个并列的折叠区请用 `Accordion`。
11
12
  *
@@ -13,7 +14,7 @@ import type { HTMLAttributes, ReactNode } from 'react'
13
14
  * @replaces summary
14
15
  */
15
16
  export interface CollapsibleProps extends HTMLAttributes<HTMLDivElement> {
16
- /** 触发器文字,如「更多筛选」 */
17
+ /** 触发器文字,如「版本记录」 */
17
18
  label?: ReactNode
18
19
 
19
20
  /** 非受控初始展开状态 */
@@ -1,9 +1,15 @@
1
- import type { HTMLAttributes, ReactNode } from 'react'
1
+ import type { HTMLAttributes, ReactNode, RefObject } from 'react'
2
2
 
3
3
  /**
4
4
  * 模态容器,用于用户必须完成或放弃的聚焦任务 —— 新建、编辑、导入映射。
5
5
  *
6
- * 已登记宽度:`small` 720px、`large` 960px。
6
+ * 已登记宽度:`small` 720px、`large` 960px。面板圆角 20(GAP Design kit「抽屉弹窗 / 弹窗」,
7
+ * 模态弹窗角色 `--ds-radius-dialog`,与 `AlertDialog`、`ApplicationFormDialog`、`PeoplePickerDialog` 一致)。
8
+ *
9
+ * 三段结构照 kit「弹窗」类型=默认(188:685):页头最小高 48、内边距 8/12、标题与关闭键间隔 10,
10
+ * 底边 0.5px 分隔线;主体内边距 12;页脚内边距 12、动作间隔 4,顶边 0.5px 分隔线。
11
+ * 三段同为导航背景色(`--ds-color-canvas`),关闭键 32×32、圆角 12。面板最小高 240,
12
+ * 视口更矮时让位于「绝不超出有效视口」。
7
13
  *
8
14
  * ⚠ **Overlay 只是物理容器。** 它绝不创造新的 Page Type 或 Page Mode,
9
15
  * 也**绝不超出有效视口**。
@@ -17,7 +23,7 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
17
23
  /** 是否打开。为 false 时组件渲染 `null` */
18
24
  open?: boolean
19
25
 
20
- /** 标题,16/24 medium 字重 */
26
+ /** 标题,16/20 medium 字重 */
21
27
  title?: ReactNode
22
28
 
23
29
  /** 标题下的补充说明,12/16 label 色 */
@@ -32,9 +38,22 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
32
38
  /** 底部动作区,右对齐。取消在左、主操作在右 */
33
39
  footer?: ReactNode
34
40
 
41
+ /**
42
+ * 页脚左侧的说明,12/16 label 色,占满动作左侧的剩余宽度(kit「弹窗」操作插槽 188:662)。
43
+ * 只传它不传 `footer` 时页脚照样渲染
44
+ */
45
+ footerNote?: ReactNode
46
+
35
47
  /** 关闭回调。点击遮罩与关闭按钮都会触发 */
36
48
  onClose?: () => void
37
49
 
50
+ /**
51
+ * 打开时的初始焦点(06 · P3-1)。缺省时落在面板内首个可聚焦元素 —— 标题栏的
52
+ * 关闭按钮。键盘优先的内容(首个输入框、搜索框)应把它的 ref 传进来。
53
+ * 目标须在本组件内;关闭后焦点照常回到打开前的元素
54
+ */
55
+ initialFocus?: RefObject<HTMLElement | null>
56
+
38
57
  /** 主体内容。超长时本区域内部滚动,标题与页脚保持固定 */
39
58
  children?: ReactNode
40
59
  }
@@ -23,7 +23,7 @@ export interface DrawerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
23
23
  /** 宽度,单位 px。推荐 680 */
24
24
  width?: number
25
25
 
26
- /** 停靠侧。见 F2 —— 当前实现下 `left` 不生效 */
26
+ /** 停靠侧,默认 `right`。两侧均生效(F2 已在阶段 4 修正) */
27
27
  side?: 'right' | 'left'
28
28
 
29
29
  /** 底部动作区,右对齐且固定 */
@@ -39,7 +39,7 @@ export interface DrawerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title
39
39
  /*
40
40
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
41
41
  *
42
- * F2 ★ bug:side="left" 完全不生效。
42
+ * F2 ★ bug:side="left" 完全不生效。—— 已修正:Overlay 基座按 side 分流落位,两侧实测生效(06 · P1-12)。
43
43
  * 源实现给 Scrim 传的是硬编码的 align="end",
44
44
  * 而 Scrim 的 justifyContent 是 align === 'end' ? 'flex-end' : 'center',
45
45
  * 因此抽屉永远靠右。side 只影响 borderLeft 那一条边框。
@@ -27,6 +27,10 @@ export interface DropdownMenuItem {
27
27
  *
28
28
  * ⚠ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见 ——
29
29
  * 这是 Shell 契约的硬性要求,不是布局偏好。
30
+ *
31
+ * 键盘打开(Enter / 空格 / ↓)高亮首个可用项,↑ 高亮末项,鼠标打开不预先高亮;
32
+ * Tab 收起菜单。Esc 关闭或选中后焦点回到 `trigger` —— 选中时先归还焦点再调
33
+ * `onSelect`,在 `onSelect` 里打开的 `AlertDialog` 关闭后焦点因此回到触发器。
30
34
  */
31
35
  export interface DropdownMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
32
36
  /** 触发元素。通常是一个「更多」Button */
@@ -54,5 +58,5 @@ export interface DropdownMenuProps extends Omit<HTMLAttributes<HTMLDivElement>,
54
58
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
55
59
  * S1 使用越层 token --application-divider
56
60
  * F1 trigger 用 cloneElement 注入 aria 属性(第 4 处 cloneElement)
57
- * I12 无键盘导航。外部点击关闭已实现,是本族少数做对的
61
+ * I12 ✅ 已补键盘导航与关闭后的焦点归还。外部点击关闭源实现即已做对
58
62
  */
@@ -32,4 +32,5 @@ export interface HoverCardProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'c
32
32
  * 实现只绑定 mouseEnter / mouseLeave,无 focus 支持。契约本身已声明
33
33
  * 「悬停对键盘用户不可用、信息必须另有入口」,故不算契约违背;
34
34
  * 但实现阶段仍建议补 focus 触发,让键盘用户至少能看到预览。
35
+ * 已补(06 · P3-5):聚焦打开、失焦关闭、Esc 关闭,契约不变。
35
36
  */
@@ -4,7 +4,7 @@ import type { HTMLAttributes, ReactNode } from 'react'
4
4
  * 锚定式浮层面板 —— 筛选器、呈现设置、日期选择器。
5
5
  *
6
6
  * ⚠ **呈现设置面板必须按当前呈现方式命名**
7
- * (列设置 / 卡片设置 / 看板设置 / 日历设置 / 图表设置 / 时间轴设置),
7
+ * (列设置 / 列表设置 / 卡片设置 / 看板设置 / 日历设置 / 图表设置 / 时间轴设置),
8
8
  * 禁止通用的「视图设置」。
9
9
  *
10
10
  * ⚠ **呈现设置不得改变**搜索、筛选、业务视图或页面模式 ——
@@ -12,11 +12,25 @@ import type { HTMLAttributes, ReactNode } from 'react'
12
12
  *
13
13
  * 共享的全局动作弹层(720px 宽、20px 圆角、680px 最高)
14
14
  * 由 `ApplicationGlobalActionPanel` 承载,不要用本组件手工拼装。
15
+ *
16
+ * 关闭时焦点若在面板内(Esc,或面板内的控件经 `onOpenChange(false)` 收起),
17
+ * 焦点回到 `trigger`。
15
18
  */
16
19
  export interface PopoverProps extends HTMLAttributes<HTMLDivElement> {
17
- /** 触发元素 */
20
+ /** 触发元素。组件向它注入 `aria-expanded`,须为单个能接收该属性的 React 元素 */
18
21
  trigger?: ReactNode
19
22
 
23
+ /**
24
+ * 外部锚点。触发器由别的组件渲染、只经回调交出元素时传入(例如
25
+ * `TopNavigationPrimaryBar` 的 `onAppSwitch` / `onAccount`):面板贴它定位,
26
+ * 点它不算外部点击(开合由它自己的点击切换),收起时焦点还给它;Tab 顺序按
27
+ * 「锚点 → 面板 → 锚点之后的元素」接上,面板在 DOM 中不必紧跟锚点。
28
+ *
29
+ * 传了本项即不再渲染 `trigger`,组件根也不占布局;`aria-expanded` 不会注入,
30
+ * 须由渲染该触发器的组件输出。必须受控使用(`open` + `onOpenChange`)。
31
+ */
32
+ anchor?: HTMLElement | null
33
+
20
34
  /** 受控开合状态 */
21
35
  open?: boolean
22
36
 
@@ -45,6 +59,7 @@ export interface PopoverProps extends HTMLAttributes<HTMLDivElement> {
45
59
  * F10 useEffect 未传依赖数组,每次渲染都解绑并重新绑定 mousedown 监听。
46
60
  * 功能正常但每帧都在动 DOM 事件,实现阶段补依赖数组。
47
61
  *
48
- * F1 trigger 用 cloneElement 注入 aria-expanded(第 5 处 cloneElement)
49
- * I12 无 Esc 关闭、无焦点管理
62
+ * F1 trigger 用 cloneElement 注入 aria-expanded(第 5 处 cloneElement)。实现一度改挂
63
+ * 在外层 span 上,读屏读不到;已改回注入到 trigger 元素本身
64
+ * I12 ✅ Esc 关闭与关闭后焦点归还触发器已实现
50
65
  */
@@ -1,8 +1,10 @@
1
1
  import type { HTMLAttributes, ReactNode } from 'react'
2
2
 
3
3
  /**
4
- * 从任意边缘滑出的面板,用于**辅助性内容** ——
5
- * 从一级导航打开的「设置」面板、帮助面板、附件预览。
4
+ * 从任意边缘滑出的面板,用于**辅助性内容** —— 帮助面板、附件预览。
5
+ *
6
+ * ⚠ **全局设置也不属于这里。** 一级导航的「设置」让 `ApplicationSecondaryNavigation`
7
+ * 换成设置模块(GAP Design kit「框架结构 / 结构=设置」),不打开任何侧板。
6
8
  *
7
9
  * ⚠ **业务对象详情不属于这里。** 详情用 `Drawer`(680px)
8
10
  * 或独立详情页 —— Sheet 在结构上比 Drawer 更轻,不承载业务记录。
@@ -0,0 +1,35 @@
1
+ import type { ReactNode } from 'react'
2
+ import type { SonnerToast } from './sonner.js'
3
+
4
+ /** `toast()` 的入参:与 `SonnerToast` 相同,只是不带 `id` —— id 由 Provider 生成 */
5
+ export type ToastOptions = Omit<SonnerToast, 'id'>
6
+
7
+ /**
8
+ * `useToast()` 的返回值。本身可调用:`toast({ title: '已保存', tone: 'success' })`
9
+ * 弹出一条提示并返回其 id。
10
+ */
11
+ export interface ToastFunction {
12
+ (toast: ToastOptions): string
13
+ /** 按 id 提前消除一条提示,如点了「撤销」之后。自动消失与关闭按钮不需要调它 */
14
+ dismiss: (id: string) => void
15
+ }
16
+
17
+ /**
18
+ * `Sonner` 的调用入口 —— 挂在应用根,子树里任何位置用 `useToast()` 弹出提示。
19
+ *
20
+ * 内部持有提示集合并渲染唯一的 `Sonner`(07 · C-10)。
21
+ *
22
+ * 此前 `Sonner` 只有受控用法:「全应用只挂一个」+「`toasts` 由调用方持有」意味着
23
+ * 每个项目都要先自建一层 context 才能在页面里弹一条提示(05 · P2-8)。本组件就是
24
+ * 那层 context,收进库内后各项目不再各写一份。受控的 `Sonner` 保留不变。
25
+ */
26
+ export interface SonnerProviderProps {
27
+ /** 应用根的子树。其中任何位置都可以用 `useToast()` */
28
+ children?: ReactNode
29
+
30
+ /** 堆栈位置,原样传给内部的 `Sonner`。默认 `top-right`,理由见 `Sonner` 的 `position` */
31
+ position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
32
+
33
+ /** 追加到内部 `Sonner` 堆栈根上的类名 */
34
+ className?: string
35
+ }
@@ -32,7 +32,10 @@ export interface SonnerProps extends HTMLAttributes<HTMLDivElement> {
32
32
  /** 消除回调。自动消失与点击关闭都会触发 */
33
33
  onDismiss?: (id: string) => void
34
34
 
35
- /** 堆栈位置 */
35
+ /**
36
+ * 堆栈位置,默认 `top-right`(07 · C-20)。
37
+ * 右下角会盖住批量栏、弹窗页脚一类底部动作条,因此不作默认
38
+ */
36
39
  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
37
40
  }
38
41
 
@@ -0,0 +1,51 @@
1
+ /* 生成文件 —— 请勿手改。
2
+ *
3
+ * 源:packages/ui/src/icon/registry.json(清单)
4
+ * 生成器:packages/ui/scripts/build-icons.mjs
5
+ *
6
+ * 改动方式:编辑 registry.json 后跑 pnpm build:icons。
7
+ * 直接改本文件会在下次 pnpm check:icons 时被检出。
8
+ */
9
+
10
+ /**
11
+ * 已登记字形名 —— `<Icon name>` 只收这 35 个 kebab-case 名字。
12
+ *
13
+ * 清单外的名字在类型层就被拒绝;ui-skill 据此生成 `prop-enum` 规则,
14
+ * 字面量写错时 lint 也报。新增字形须先登记进 registry.json 并随包发版。
15
+ */
16
+ export type IconName =
17
+ | 'activity'
18
+ | 'arrow-down'
19
+ | 'arrow-up'
20
+ | 'calendar'
21
+ | 'check'
22
+ | 'chevron-down'
23
+ | 'chevron-left'
24
+ | 'chevron-right'
25
+ | 'chevron-up'
26
+ | 'chevrons-left'
27
+ | 'chevrons-right'
28
+ | 'circle-alert'
29
+ | 'circle-check'
30
+ | 'circle-check-big'
31
+ | 'columns-2'
32
+ | 'download'
33
+ | 'ellipsis'
34
+ | 'funnel'
35
+ | 'info'
36
+ | 'kanban'
37
+ | 'layout-grid'
38
+ | 'list'
39
+ | 'message-square'
40
+ | 'minus'
41
+ | 'pencil'
42
+ | 'plus'
43
+ | 'refresh-cw'
44
+ | 'search'
45
+ | 'settings'
46
+ | 'shield-check'
47
+ | 'sliders-horizontal'
48
+ | 'trash-2'
49
+ | 'triangle-alert'
50
+ | 'upload'
51
+ | 'x'
@@ -1,4 +1,7 @@
1
1
  import type { CSSProperties, SVGProps } from 'react'
2
+ import type { IconName } from './icon-name.js'
3
+
4
+ export type { IconName }
2
5
 
3
6
  /**
4
7
  * 已登记字形集中的单色图标 —— 规范要求图标的任何位置都用它。
@@ -20,8 +23,19 @@ import type { CSSProperties, SVGProps } from 'react'
20
23
  * @replaces svg
21
24
  */
22
25
  export interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'name' | 'color'> {
23
- /** 图标名。接受 kebab 或 Pascal 形式(`chevron-down` / `ChevronDown`) */
24
- name: string
26
+ /**
27
+ * 图标名,只收已登记字形的 kebab-case 名(`chevron-down`)。
28
+ *
29
+ * 类型是生成的 `IconName` 字面量联合(05 · P1-6):此前是 `string`,未登记名
30
+ * 过 tsc、过 strict lint,运行时渲染成空方盒。现在清单外的名字在 tsc 与
31
+ * `prop-enum` 两处被拒。数据里存图标名时把字段类型写成 `IconName`,
32
+ * 不要写 `string` 再断言。
33
+ *
34
+ * 类型层不再收 Pascal 写法(`ChevronDown`):两种写法并收会让取值表翻倍,
35
+ * 且收窄当时库内、文档站示例与验证页里没有一处 Pascal 用法。运行时仍把
36
+ * Pascal / 下划线写法归一成 kebab,未经类型检查的 JS 调用方不受影响。
37
+ */
38
+ name: IconName
25
39
 
26
40
  /**
27
41
  * 尺寸,单位 px。取值即登记档:
@@ -53,14 +67,16 @@ export interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'name' | 'color
53
67
  *
54
68
  * src/icon/registry.json 已登记字形清单(手写,唯一事实来源)
55
69
  * └─ scripts/build-icons.mjs 从 lucide-static 取几何,仅 devDependency
56
- * └─ src/icon/glyphs.ts 生成产物,构建时内联
70
+ * ├─ src/icon/glyphs.ts 生成产物,构建时内联
71
+ * └─ contracts/foundation/icon/icon-name.ts 生成产物,name 的类型
57
72
  *
58
73
  * 因此本组件的运行时行为相对源实现有三处变化:
59
74
  *
60
75
  * ① 不再有 window.lucide 探测,SSR 直出完整 SVG,无空盒子首屏
61
76
  * ② name 落在清单外时渲染占位方盒并在开发构建下 console.warn ——
62
77
  * 但清单本身的正确性在**构建时**就已校验(清单中不存在于字形源的
63
- * 名字会让 build-icons.mjs 以非零退出码结束)
78
+ * 名字会让 build-icons.mjs 以非零退出码结束)。自 05 · P1-6 起 name 的
79
+ * 类型是 IconName,经类型检查的调用方走不到占位盒,它只兜未经类型检查的 JS
64
80
  * ③ 新增图标须改 registry.json 并发版,这是方案 B 明确接受的代价
65
81
  *
66
82
  * 02 §6.1 记录的 SUBSTITUTION 仍未消除:Lucide 只是推断,源规范包
@@ -11,7 +11,11 @@ import type { HTMLAttributes } from 'react'
11
11
  * 两者同名但不同层,不要混用。
12
12
  */
13
13
  export interface CalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
14
- /** 初始显示的月份。仅取年月,日被忽略 */
14
+ /**
15
+ * 显示的月份。仅取年月,日被忽略。
16
+ *
17
+ * 年月变化时视图跟随;年月不变的重渲染不重置用户已翻到的月份。
18
+ */
15
19
  month?: Date
16
20
 
17
21
  /** 选中日期 */
@@ -19,6 +23,15 @@ export interface CalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onS
19
23
 
20
24
  /** 选中日期变化回调 */
21
25
  onSelect?: (date: Date) => void
26
+
27
+ /**
28
+ * 「今天」。仅取年月日,按本地时区解读。默认取当前本地日期(06 · P2-20)。
29
+ *
30
+ * 决定今日高亮(`aria-current="date"`)、未传 `month` 时的初始月份、以及没有
31
+ * 选中日时 Tab 停顿的回落位置。以服务端时间为准的业务、服务端渲染(避免跨零点
32
+ * 的水合不一致)与测试(固定日期)传入它;其余场景不传。
33
+ */
34
+ today?: Date
22
35
  }
23
36
 
24
37
  /*
@@ -31,6 +31,12 @@ export interface CheckboxProps
31
31
 
32
32
  /** 可见标签,渲染在方框右侧,与方框同属一个 `<label>` 因而可点击 */
33
33
  label?: ReactNode
34
+
35
+ /**
36
+ * 校验失败态。方框描边转为 danger 色,内部 `<input>` 带 `aria-invalid`(06 · P1-16)。
37
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。
38
+ */
39
+ invalid?: boolean
34
40
  }
35
41
 
36
42
  /*
@@ -33,7 +33,7 @@ export interface ComboboxProps
33
33
  /** 选中值变化回调。选中后浮层关闭并清空输入 */
34
34
  onValueChange?: (value: string) => void
35
35
 
36
- /** 输入框占位文字 */
36
+ /** 输入框占位文字。默认「搜索选项」—— 写范围而非指令(02 §8 表单与说明文案) */
37
37
  placeholder?: string
38
38
 
39
39
  /** 筛选无结果时的提示文字 */
@@ -41,6 +41,12 @@ export interface ComboboxProps
41
41
 
42
42
  /** 禁用 */
43
43
  disabled?: boolean
44
+
45
+ /**
46
+ * 校验失败态。外壳边框转为 danger 色,输入框带 `aria-invalid`(06 · P1-16)。
47
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。
48
+ */
49
+ invalid?: boolean
44
50
  }
45
51
 
46
52
  /*
@@ -52,7 +58,7 @@ export interface ComboboxProps
52
58
  *
53
59
  * ─── 待裁决 ───────────────────────────────────────────────────────
54
60
  * I13 label 类型与筛选实现冲突(本文件已按建议方案落草案)
55
- * I14 缺 invalid,与 Select 不一致
61
+ * I14 缺 invalid,与 Select 不一致 —— 已补(06 · P1-16)
56
62
  * S1 token 命名层 I12 缺键盘导航 I16 默认文案硬编码
57
63
  * 详见 docs/04-契约决议.md
58
64
  */
@@ -0,0 +1,39 @@
1
+ import type { HTMLAttributes } from 'react'
2
+
3
+ /**
4
+ * 单个日期的录入控件:与 `Input` 同高同壳(32px、12px 圆角、1px 描边),右侧带 16px
5
+ * 日历图标,点击弹出 `Calendar` 月格,选中即回填并收起。
6
+ *
7
+ * 值一律是本地时区的 ISO 日期串 `yyyy-mm-dd`(不是 `Date`,也不是带时区的时间戳)——
8
+ * 表单提交与接口对接都按字符串走,组件内部用本地时区换算,不经 `toISOString()`。
9
+ *
10
+ * 只选一个日期。日期区间筛选用 `ApplicationDateRangeFilter`;带时分的时刻本库暂无组件。
11
+ *
12
+ * 在 `Field` 里使用时,`Field` 的 `htmlFor` 指向本组件的 `id`(落在触发按钮上)。
13
+ */
14
+ export interface DateInputProps
15
+ extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
16
+ /** 受控值,ISO `yyyy-mm-dd`。空串或不传表示未选 */
17
+ value?: string
18
+
19
+ /** 非受控初始值,ISO `yyyy-mm-dd` */
20
+ defaultValue?: string
21
+
22
+ /** 值变化回调,给出 ISO `yyyy-mm-dd`;清空时给出空串 */
23
+ onValueChange?: (value: string) => void
24
+
25
+ /** 未选时的占位文字。写明格式或含义,如「选择开票日期」 */
26
+ placeholder?: string
27
+
28
+ /** 禁用 */
29
+ disabled?: boolean
30
+
31
+ /**
32
+ * 校验失败态。边框转为 danger 色并设置 `aria-invalid`。
33
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,与 `Input` 相同。
34
+ */
35
+ invalid?: boolean
36
+
37
+ /** 「今天」,透传给 `Calendar`。以服务端时间为准、服务端渲染或测试时传入 */
38
+ today?: Date
39
+ }
@@ -19,15 +19,29 @@ export interface FieldProps extends HTMLAttributes<HTMLDivElement> {
19
19
  * 错误文字,12/16 字号 danger 色。设置后取代 `description`。
20
20
  *
21
21
  * **不会自动把内部控件切到 invalid 态** —— 控件的 `invalid` 需另行设置。见 I5。
22
+ * 给了 `htmlFor` 时,错误(或说明)并入该控件的 `aria-describedby`,有错误时控件
23
+ * 若没有 `aria-invalid` 则补上 —— 只是读屏语义,失败态视觉仍归控件的 `invalid`。
22
24
  */
23
25
  error?: ReactNode
24
26
 
25
27
  /** 必填标记。在标签文字后追加 danger 色星号 */
26
28
  required?: boolean
27
29
 
28
- /** 关联内部控件的 id。透传给内部 `<label for>` */
30
+ /**
31
+ * 关联内部控件的 id。透传给内部 `<label for>`,并据此把说明 / 错误关联到控件
32
+ * (`aria-describedby`)。控件包在别的组件里(`InputGroup`、`Popover`)时同样生效
33
+ */
29
34
  htmlFor?: string
30
35
 
36
+ /**
37
+ * 网格跨度。`full` 时本行占满所在网格的全部列(输出 `data-span`,由本组件
38
+ * CSS 写 `grid-column: 1 / -1`)。父级不是网格时无效果。
39
+ *
40
+ * 取代此前登记的 `style={{ gridColumn: '1 / -1' }}` —— 内联 style 违反 §1.7
41
+ * (实践报告 P1-3,裁决:以规范为准)。
42
+ */
43
+ span?: 'full'
44
+
31
45
  /** 受本行管辖的控件。仅一个 */
32
46
  children?: ReactNode
33
47
  }
@@ -20,6 +20,16 @@ export interface InputGroupProps extends HTMLAttributes<HTMLDivElement> {
20
20
 
21
21
  /** 禁用整组。背景转为 `--ds-color-bg-3` */
22
22
  disabled?: boolean
23
+
24
+ /**
25
+ * 校验失败态。外壳边框转为 danger 色(06 · P1-16)。
26
+ *
27
+ * 只管外壳视觉:壳是包装元素而非控件,`aria-invalid` 不落在它上面。读屏语义由
28
+ * 内部控件承担 —— 内部 `Input` 同设 `invalid`(壳内它的边框已被剥掉,只剩
29
+ * `aria-invalid` 生效),或经 `Field.htmlFor` 由 Field 补上。
30
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。
31
+ */
32
+ invalid?: boolean
23
33
  }
24
34
 
25
35
  /*
@@ -23,6 +23,12 @@ export interface InputOTPProps
23
23
 
24
24
  /** 禁用整组 */
25
25
  disabled?: boolean
26
+
27
+ /**
28
+ * 校验失败态。全部方框边框转为 danger 色,每个方框带 `aria-invalid`(06 · P1-16)。
29
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。
30
+ */
31
+ invalid?: boolean
26
32
  }
27
33
 
28
34
  /*
@@ -3,10 +3,10 @@ import type { InputHTMLAttributes } from 'react'
3
3
  /**
4
4
  * 单行文本控件。
5
5
  *
6
- * 用于 `Field` 内的自由文本、数字与日期录入。
6
+ * 用于 `Field` 内的自由文本与数字录入。单个日期用 `DateInput`。
7
7
  * 搜索请用 `SearchField` —— 它拥有紧凑工具栏外壳,不要用 Input 自行拼装。
8
8
  *
9
- * 最小高度 32px,8px 圆角。
9
+ * 最小高度 32px,12px 圆角(GAP Design kit)。
10
10
  * **焦点只在外层壳表达一次,内部不得再套第二圈焦点环。**
11
11
  *
12
12
  * @replaces input
@@ -45,6 +45,13 @@ export interface RadioGroupProps
45
45
 
46
46
  /** 整组禁用。单个选项的禁用用 `RadioGroupItem.disabled` */
47
47
  disabled?: boolean
48
+
49
+ /**
50
+ * 校验失败态。全部圆点描边转为 danger 色,`role="radiogroup"` 的根元素带
51
+ * `aria-invalid`(06 · P1-16)。
52
+ * 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。
53
+ */
54
+ invalid?: boolean
48
55
  }
49
56
 
50
57
  /*
@@ -37,7 +37,10 @@ export interface SelectProps
37
37
  /** 选中值变化回调。选中后浮层自动关闭 */
38
38
  onValueChange?: (value: string) => void
39
39
 
40
- /** 未选中时的占位文字,以 placeholder 色显示 */
40
+ /**
41
+ * 未选中时的占位文字,以 placeholder 色显示。默认「未选择」—— 写状态而非指令,
42
+ * 不写「请选择」(02 §8 表单与说明文案,07 · C-4)
43
+ */
41
44
  placeholder?: string
42
45
 
43
46
  /** 禁用 */
@@ -21,6 +21,15 @@ export interface SwitchProps
21
21
 
22
22
  /** 可见标签,渲染在轨道右侧,与轨道同属一个 `<label>` 因而可点击 */
23
23
  label?: ReactNode
24
+
25
+ /**
26
+ * 落库中(06 · P3-17)。`onCheckedChange` 发起的保存尚未返回时设为 true。
27
+ *
28
+ * 期间控件**保持可聚焦**、带 `aria-busy`,点击与空格不再切换(不改内部状态、
29
+ * 不调 `onCheckedChange`),滑块内显示进行中指示。不要用 `disabled` 表达这段
30
+ * 等待 —— 它让按钮失焦,焦点掉到 `body`,键盘用户得从页首重新找回来。
31
+ */
32
+ busy?: boolean
24
33
  }
25
34
 
26
35
  /*
@@ -26,24 +26,43 @@ export interface CommandGroup {
26
26
  }
27
27
 
28
28
  /**
29
- * 键盘优先的命令面板 —— 放进 `Dialog` 里作为全局搜索与执行入口。
29
+ * 键盘优先的命令面板 —— 以 `dialog` 形态作为全局搜索与执行入口。
30
30
  *
31
31
  * 本地筛选。**筛选后无命中的分组整组消失**,不显示空标题。
32
32
  *
33
+ * ### `dialog` 形态(06 · P1-15)
34
+ * 面板自身就是模态框:与 `Dialog` 共用同一个基座(遮罩、Esc、焦点陷阱、关闭后
35
+ * 焦点恢复、滚动锁定),打开时焦点落在输入框,没有标题栏与关闭按钮 —— 搜索行
36
+ * 就是头部;宽度受视口边距约束,不溢出。此前只能把本组件放进 `Dialog`:不传
37
+ * `title` 仍渲染空标题栏、初始焦点落在「关闭」、420px 宽在 Dialog 主体内溢出,
38
+ * 且与「不得被带边框的容器包裹」互相矛盾。
39
+ *
33
40
  * 目录中已登记,但**尚未在生产业务代码中集成**。见 I20。
34
41
  */
35
42
  export interface CommandProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
36
43
  /** 命令分组集合 */
37
44
  groups: CommandGroup[]
38
45
 
39
- /** 输入框占位文字 */
46
+ /** 输入框占位文字。默认「搜索命令」—— 写范围而非指令(02 §8 表单与说明文案) */
40
47
  placeholder?: string
41
48
 
42
49
  /** 筛选无结果时的提示文字 */
43
50
  emptyText?: string
44
51
 
45
- /** 命令选中回调 */
52
+ /** 命令选中回调。`dialog` 形态下选中后是否收起由调用方在这里决定 */
46
53
  onSelect?: (value: string) => void
54
+
55
+ /**
56
+ * 以模态外壳渲染。可访问名取 `aria-label` / `aria-labelledby`(同时落在模态框与
57
+ * 输入框上),缺省时回落到 `placeholder`
58
+ */
59
+ dialog?: boolean
60
+
61
+ /** `dialog` 形态下是否打开。为 false 时渲染 `null`;非 `dialog` 形态忽略 */
62
+ open?: boolean
63
+
64
+ /** `dialog` 形态下的开合回调:Esc 与遮罩点击以 `false` 调用 */
65
+ onOpenChange?: (open: boolean) => void
47
66
  }
48
67
 
49
68
  /*
@@ -21,6 +21,11 @@ export interface ContextMenuItem {
21
21
  *
22
22
  * ⚠ **绝不能是某个动作的唯一入口。** 记录级动作必须同时出现在行尾或详情中 ——
23
23
  * 右键是加速器,不是可达性路径。
24
+ *
25
+ * 菜单内的点击、指针与键盘事件在菜单根截停,**不冒泡**到 `children` 及其祖先 ——
26
+ * 放在可点击的记录行里,选中条目不会连带触发行的 `onClick` / 回车。
27
+ * 高亮项每次打开都清空;Esc 关闭或选中后,焦点回到打开菜单前持有焦点的元素。
28
+ * 任一祖先滚动或窗口尺寸变化时菜单收起。
24
29
  */
25
30
  export interface ContextMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
26
31
  /** 菜单条目集合 */
@@ -36,5 +41,5 @@ export interface ContextMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, '
36
41
  /*
37
42
  * ─── 待处理(不阻塞契约) ─────────────────────────────────────────
38
43
  * S1 使用越层 token --application-divider
39
- * I12 无键盘导航(Esc / 方向键),菜单无视口碰撞检测,可能溢出屏幕边界
44
+ * I12 ✅ 已补键盘导航(方向键 / Home / End / 回车 / Esc / Tab)与视口碰撞收回
40
45
  */