@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
@@ -0,0 +1,43 @@
1
+ const NESTED_INTERACTIVE = [
2
+ "a[href]",
3
+ "button",
4
+ "input",
5
+ "select",
6
+ "textarea",
7
+ "summary",
8
+ "label",
9
+ '[contenteditable=""]',
10
+ '[contenteditable="true"]',
11
+ '[role="button"]',
12
+ '[role="link"]',
13
+ '[role="checkbox"]',
14
+ '[role="switch"]',
15
+ '[role="radio"]',
16
+ '[role="menu"]',
17
+ '[role="menuitem"]',
18
+ '[role="menuitemcheckbox"]',
19
+ '[role="menuitemradio"]',
20
+ '[role="listbox"]',
21
+ '[role="option"]',
22
+ '[role="combobox"]',
23
+ '[role="slider"]',
24
+ '[role="tab"]',
25
+ '[role="textbox"]'
26
+ ].join(", ");
27
+ function fromNestedInteractive(event) {
28
+ const row = event.currentTarget;
29
+ const target = event.target;
30
+ if (!(row instanceof Element) || !(target instanceof Element)) return false;
31
+ if (!row.contains(target)) return true;
32
+ const hit = target.closest(NESTED_INTERACTIVE);
33
+ return hit !== null && hit !== row && row.contains(hit);
34
+ }
35
+ function isRowActivationKey(event) {
36
+ if (event.defaultPrevented || event.target !== event.currentTarget) return false;
37
+ return event.key === "Enter" || event.key === " ";
38
+ }
39
+ export {
40
+ fromNestedInteractive,
41
+ isRowActivationKey
42
+ };
43
+ //# sourceMappingURL=row-activation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/internal/row-activation.ts"],"sourcesContent":["/* 整行可点的列表行(Table 行、RecordList 行)共用的事件判定。\n *\n * 行内常放勾选框、行尾动作、右键菜单、标题链接。它们的点击与按键沿 React 组件树\n * 冒泡到行上,于是点「更多」顺带打开了详情(06 · P0-5 / P2-3)。先前的做法是让每个\n * 调用方在 renderRow 里自己 stopPropagation,可约定从没列全要截哪些区域 —— P0-5 正出\n * 在那个空白处。判定收回到行自己:来自行内可交互元素的事件属于那个元素,不触发整行。\n *\n * 两种情形都算「不归行」:\n * ① DOM 上不在行内 —— 菜单、对话框经 portal 渲染到 body,React 事件照样冒泡上来;\n * ② 在行内,且最近的可交互祖先落在行内(不含行自己)。 */\n\n/** 行内可交互元素。按角色列全,不按标签名猜 —— 本库的勾选框是 span[role=checkbox]。 */\nconst NESTED_INTERACTIVE = [\n 'a[href]',\n 'button',\n 'input',\n 'select',\n 'textarea',\n 'summary',\n 'label',\n '[contenteditable=\"\"]',\n '[contenteditable=\"true\"]',\n '[role=\"button\"]',\n '[role=\"link\"]',\n '[role=\"checkbox\"]',\n '[role=\"switch\"]',\n '[role=\"radio\"]',\n '[role=\"menu\"]',\n '[role=\"menuitem\"]',\n '[role=\"menuitemcheckbox\"]',\n '[role=\"menuitemradio\"]',\n '[role=\"listbox\"]',\n '[role=\"option\"]',\n '[role=\"combobox\"]',\n '[role=\"slider\"]',\n '[role=\"tab\"]',\n '[role=\"textbox\"]',\n].join(', ')\n\n/** 事件是否来自行内的可交互元素(或行外的 portal 内容)。是则行不应响应。 */\nexport function fromNestedInteractive(event: {\n target: EventTarget\n currentTarget: EventTarget\n}): boolean {\n const row = event.currentTarget\n const target = event.target\n if (!(row instanceof Element) || !(target instanceof Element)) return false\n if (!row.contains(target)) return true\n const hit = target.closest(NESTED_INTERACTIVE)\n return hit !== null && hit !== row && row.contains(hit)\n}\n\n/** Enter / 空格且焦点就在行上 —— 行内控件自己的按键不算。 */\nexport function isRowActivationKey(event: {\n key: string\n target: EventTarget\n currentTarget: EventTarget\n defaultPrevented: boolean\n}): boolean {\n if (event.defaultPrevented || event.target !== event.currentTarget) return false\n return event.key === 'Enter' || event.key === ' '\n}\n"],"mappings":"AAYA,MAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAGJ,SAAS,sBAAsB,OAG1B;AACV,QAAM,MAAM,MAAM;AAClB,QAAM,SAAS,MAAM;AACrB,MAAI,EAAE,eAAe,YAAY,EAAE,kBAAkB,SAAU,QAAO;AACtE,MAAI,CAAC,IAAI,SAAS,MAAM,EAAG,QAAO;AAClC,QAAM,MAAM,OAAO,QAAQ,kBAAkB;AAC7C,SAAO,QAAQ,QAAQ,QAAQ,OAAO,IAAI,SAAS,GAAG;AACxD;AAGO,SAAS,mBAAmB,OAKvB;AACV,MAAI,MAAM,oBAAoB,MAAM,WAAW,MAAM,cAAe,QAAO;AAC3E,SAAO,MAAM,QAAQ,WAAW,MAAM,QAAQ;AAChD;","names":[]}
@@ -0,0 +1,22 @@
1
+ function stateSlot(state, slots) {
2
+ switch (state) {
3
+ case "loading":
4
+ return slots.loading;
5
+ case "empty":
6
+ return slots.empty;
7
+ case "error":
8
+ return slots.error;
9
+ case "no-permission":
10
+ return slots.noPermission;
11
+ case "not-found":
12
+ return slots.notFound;
13
+ }
14
+ }
15
+ function isAbsent(node) {
16
+ return node === void 0 || node === null || node === false;
17
+ }
18
+ export {
19
+ isAbsent,
20
+ stateSlot
21
+ };
22
+ //# sourceMappingURL=state-slot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/internal/state-slot.ts"],"sourcesContent":["import type { ReactNode } from 'react'\nimport type { DataDisplayState } from '../../contracts/application-module/content/application-data-display.js'\n\n/** 五种非 `ready` 状态各自的槽位,命名与 `ApplicationDataDisplay` 一致。 */\nexport interface StateSlots {\n loading?: ReactNode\n empty?: ReactNode\n error?: ReactNode\n noPermission?: ReactNode\n notFound?: ReactNode\n}\n\n/**\n * 按系统状态取对应槽位。三个协作工作台共用(06 · P1-17)——\n * 状态名到槽位名的映射写在一处,`no-permission` → `noPermission` 不会某一份写漏。\n * `ready` 不在这里处理:各组件 `ready` 时渲染的是自己的栏位结构。\n */\nexport function stateSlot(state: Exclude<DataDisplayState, 'ready'>, slots: StateSlots): ReactNode {\n switch (state) {\n case 'loading':\n return slots.loading\n case 'empty':\n return slots.empty\n case 'error':\n return slots.error\n case 'no-permission':\n return slots.noPermission\n case 'not-found':\n return slots.notFound\n }\n}\n\n/** 槽位是否「没传」—— `null` / `false` 与 `undefined` 同样视为没传,内置占位顶上。 */\nexport function isAbsent(node: ReactNode): boolean {\n return node === undefined || node === null || node === false\n}\n"],"mappings":"AAiBO,SAAS,UAAU,OAA2C,OAA8B;AACjG,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,MAAM;AAAA,EACjB;AACF;AAGO,SAAS,SAAS,MAA0B;AACjD,SAAO,SAAS,UAAa,SAAS,QAAQ,SAAS;AACzD;","names":[]}
@@ -1,29 +1,73 @@
1
1
  "use client";
2
- import { useEffect } from "react";
3
- function useDismiss({ open, onDismiss, floating, anchor }) {
2
+ import { useEffect, useRef } from "react";
3
+ import { isTopEscapeLayer, pushEscapeLayer, removeEscapeLayer } from "./escape-stack.js";
4
+ import { getFocusable } from "./focus.js";
5
+ function focusTargetIn(wrapper) {
6
+ if (!wrapper) return null;
7
+ return getFocusable(wrapper)[0] ?? wrapper;
8
+ }
9
+ function useDismiss({
10
+ open,
11
+ onDismiss,
12
+ floating,
13
+ anchor,
14
+ returnFocus,
15
+ dismissOnFocusOut = false
16
+ }) {
17
+ const onDismissRef = useRef(onDismiss);
18
+ const returnFocusRef = useRef(returnFocus);
19
+ const focusOutRef = useRef(dismissOnFocusOut);
20
+ useEffect(() => {
21
+ onDismissRef.current = onDismiss;
22
+ returnFocusRef.current = returnFocus;
23
+ focusOutRef.current = dismissOnFocusOut;
24
+ });
4
25
  useEffect(() => {
5
26
  if (!open) return;
27
+ const layer = {};
28
+ pushEscapeLayer(layer);
29
+ const within = (node) => Boolean(floating.current?.contains(node) || anchor?.current?.contains(node));
30
+ let focusInside = Boolean(floating.current?.contains(document.activeElement));
31
+ let engaged = within(document.activeElement);
6
32
  const onPointerDown = (event) => {
7
33
  const target = event.target;
8
34
  if (!target) return;
9
35
  if (floating.current?.contains(target)) return;
10
36
  if (anchor?.current?.contains(target)) return;
11
- onDismiss();
37
+ onDismissRef.current();
12
38
  };
13
39
  const onKeyDown = (event) => {
14
- if (event.key !== "Escape") return;
40
+ if (event.key !== "Escape" || !isTopEscapeLayer(layer)) return;
15
41
  event.stopPropagation();
16
- onDismiss();
42
+ onDismissRef.current();
43
+ };
44
+ const onFocusIn = (event) => {
45
+ const target = event.target;
46
+ focusInside = Boolean(floating.current?.contains(target));
47
+ if (within(target)) {
48
+ engaged = true;
49
+ } else if (engaged && focusOutRef.current) {
50
+ onDismissRef.current();
51
+ }
17
52
  };
18
53
  document.addEventListener("pointerdown", onPointerDown, true);
19
54
  document.addEventListener("keydown", onKeyDown, true);
55
+ document.addEventListener("focusin", onFocusIn, true);
20
56
  return () => {
21
57
  document.removeEventListener("pointerdown", onPointerDown, true);
22
58
  document.removeEventListener("keydown", onKeyDown, true);
59
+ document.removeEventListener("focusin", onFocusIn, true);
60
+ removeEscapeLayer(layer);
61
+ if (!focusInside || !returnFocusRef.current) return;
62
+ const active = document.activeElement;
63
+ if (active && active !== document.body && active.isConnected) return;
64
+ const target = returnFocusRef.current();
65
+ if (target?.isConnected) target.focus();
23
66
  };
24
- }, [open, onDismiss, floating, anchor]);
67
+ }, [open, floating, anchor]);
25
68
  }
26
69
  export {
70
+ focusTargetIn,
27
71
  useDismiss
28
72
  };
29
73
  //# sourceMappingURL=use-dismiss.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/internal/use-dismiss.ts"],"sourcesContent":["'use client'\n\nimport { useEffect } from 'react'\nimport type { RefObject } from 'react'\n\nexport interface UseDismissOptions {\n /** 是否打开。关闭时不挂监听 */\n open: boolean\n /** 需要关闭时调用 */\n onDismiss: () => void\n /** 浮层内容。点在它内部不算外点击 */\n floating: RefObject<HTMLElement | null>\n /** 触发器。点它由触发器自己的 onClick 处理开合,此处必须放过 */\n anchor?: RefObject<HTMLElement | null>\n}\n\n/**\n * 非模态浮层的关闭行为:Esc + 点击外部。\n *\n * 与 `useModal` 的区别在于**不锁滚动、不陷阱焦点** —— 下拉、气泡、工具提示\n * 不是模态,背景仍然可用。\n *\n * 两个实现细节,都来自源实现踩过的坑:\n *\n * ① 用 `pointerdown` 而非 `mousedown`:触屏与手写笔也要能点外部关闭。\n * ② 触发器必须排除在外。源实现(Popover)只判断「不在浮层内就关」,于是点\n * 触发器会先关一次、再由 onClick 开一次,看上去像没反应。\n *\n * 另:源实现的 `useEffect` 漏了依赖数组(04 · F10),每次渲染都重新绑定一次\n * mousedown 监听。这里依赖列全。\n */\nexport function useDismiss({ open, onDismiss, floating, anchor }: UseDismissOptions): void {\n useEffect(() => {\n if (!open) return\n\n const onPointerDown = (event: PointerEvent) => {\n const target = event.target as Node | null\n if (!target) return\n if (floating.current?.contains(target)) return\n if (anchor?.current?.contains(target)) return\n onDismiss()\n }\n\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key !== 'Escape') return\n event.stopPropagation()\n onDismiss()\n }\n\n document.addEventListener('pointerdown', onPointerDown, true)\n document.addEventListener('keydown', onKeyDown, true)\n return () => {\n document.removeEventListener('pointerdown', onPointerDown, true)\n document.removeEventListener('keydown', onKeyDown, true)\n }\n }, [open, onDismiss, floating, anchor])\n}\n"],"mappings":";AAEA,SAAS,iBAAiB;AA6BnB,SAAS,WAAW,EAAE,MAAM,WAAW,UAAU,OAAO,GAA4B;AACzF,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AAEX,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,SAAS,MAAM;AACrB,UAAI,CAAC,OAAQ;AACb,UAAI,SAAS,SAAS,SAAS,MAAM,EAAG;AACxC,UAAI,QAAQ,SAAS,SAAS,MAAM,EAAG;AACvC,gBAAU;AAAA,IACZ;AAEA,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,SAAU;AAC5B,YAAM,gBAAgB;AACtB,gBAAU;AAAA,IACZ;AAEA,aAAS,iBAAiB,eAAe,eAAe,IAAI;AAC5D,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,WAAO,MAAM;AACX,eAAS,oBAAoB,eAAe,eAAe,IAAI;AAC/D,eAAS,oBAAoB,WAAW,WAAW,IAAI;AAAA,IACzD;AAAA,EACF,GAAG,CAAC,MAAM,WAAW,UAAU,MAAM,CAAC;AACxC;","names":[]}
1
+ {"version":3,"sources":["../../src/internal/use-dismiss.ts"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport { isTopEscapeLayer, pushEscapeLayer, removeEscapeLayer } from './escape-stack.js'\nimport { getFocusable } from './focus.js'\nimport type { RefObject } from 'react'\n\nexport interface UseDismissOptions {\n /** 是否打开。关闭时不挂监听 */\n open: boolean\n /** 需要关闭时调用 */\n onDismiss: () => void\n /** 浮层内容。点在它内部不算外点击 */\n floating: RefObject<HTMLElement | null>\n /** 触发器。点它由触发器自己的 onClick 处理开合,此处必须放过 */\n anchor?: RefObject<HTMLElement | null>\n /**\n * 关闭后焦点的归还目标。只在「关闭那一刻焦点在浮层内、关闭后焦点掉到了 body」\n * 时才归还 —— 焦点已经被用户移到别处(Tab 出去、点了外部的输入框)时不抢。\n * 不传即不归还,与此前行为一致。\n */\n returnFocus?: () => HTMLElement | null | undefined\n /**\n * 焦点离开「触发器 + 浮层」两者时关闭(Tab 出去、程序化聚焦到别处),不归还焦点。\n * 只在焦点曾落在两者之一后才生效:触发器在 `anchor` 之外的用法(外部按钮控制\n * `open`)打开时焦点本就不在里面,此时 Tab 不应把还没进入过的浮层关掉。\n */\n dismissOnFocusOut?: boolean\n}\n\n/**\n * 触发器包装元素里真正该拿焦点的那个元素:内部第一个可聚焦元素,没有则包装元素自身。\n *\n * DropdownMenu / Popover 的 `trigger` 外面套着一层 span 作锚点,焦点要还给的是\n * 调用方传进来的那个按钮,不是 span。\n */\nexport function focusTargetIn(wrapper: HTMLElement | null | undefined): HTMLElement | null {\n if (!wrapper) return null\n return getFocusable(wrapper)[0] ?? wrapper\n}\n\n/**\n * 非模态浮层的关闭行为:Esc + 点击外部,可选关闭后归还焦点。\n *\n * 与 `useModal` 的区别在于**不锁滚动、不陷阱焦点** —— 下拉、气泡、工具提示\n * 不是模态,背景仍然可用。\n *\n * 两个实现细节,都来自源实现踩过的坑:\n *\n * ① 用 `pointerdown` 而非 `mousedown`:触屏与手写笔也要能点外部关闭。\n * ② 触发器必须排除在外。源实现(Popover)只判断「不在浮层内就关」,于是点\n * 触发器会先关一次、再由 onClick 开一次,看上去像没反应。\n *\n * 另:源实现的 `useEffect` 漏了依赖数组(04 · F10),每次渲染都重新绑定一次\n * mousedown 监听。这里只在开合与节点变化时重绑;`onDismiss` 走 ref —— 调用方常传\n * 内联函数,作为依赖会让本层每次重渲染都从 Esc 栈里出栈再入栈,跑到后开的模态之上。\n *\n * Esc 与模态共用 escape-stack:只有栈顶一层响应。对话框里展开着下拉时,Esc 只收起\n * 下拉,不连带关掉对话框。\n *\n * 焦点归还(`returnFocus`):浮层卸载时若焦点在它里面,浏览器把焦点丢给 body。\n * 实测两个后果 —— Esc 收起菜单后键盘用户要从页首重新 Tab;菜单项打开\n * AlertDialog 时,`useModal` 记下的恢复目标是 body,对话框关闭后焦点同样丢失;\n * 在 Dialog 内的气泡则直接逃出焦点陷阱。判据「焦点曾在浮层内」靠 focusin 记录,\n * 因为卸载时浏览器不派发 focusout,事后已无从查起。\n *\n * 焦点离开即关闭(`dismissOnFocusOut`)同样挂在 focusin 上而不用 blur:点浮层内的\n * 空白处也会让焦点元素失焦(relatedTarget 为空),那不是离开。focusin 只在焦点真的\n * 落到某个元素上时派发,落在触发器与浮层之外才算离开。\n */\nexport function useDismiss({\n open,\n onDismiss,\n floating,\n anchor,\n returnFocus,\n dismissOnFocusOut = false,\n}: UseDismissOptions): void {\n const onDismissRef = useRef(onDismiss)\n const returnFocusRef = useRef(returnFocus)\n const focusOutRef = useRef(dismissOnFocusOut)\n useEffect(() => {\n onDismissRef.current = onDismiss\n returnFocusRef.current = returnFocus\n focusOutRef.current = dismissOnFocusOut\n })\n\n useEffect(() => {\n if (!open) return\n const layer = {}\n pushEscapeLayer(layer)\n\n const within = (node: Node | null) =>\n Boolean(floating.current?.contains(node) || anchor?.current?.contains(node))\n let focusInside = Boolean(floating.current?.contains(document.activeElement))\n /** 焦点自打开以来是否落在过触发器或浮层内 —— dismissOnFocusOut 的前提 */\n let engaged = within(document.activeElement)\n\n const onPointerDown = (event: PointerEvent) => {\n const target = event.target as Node | null\n if (!target) return\n if (floating.current?.contains(target)) return\n if (anchor?.current?.contains(target)) return\n onDismissRef.current()\n }\n\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key !== 'Escape' || !isTopEscapeLayer(layer)) return\n event.stopPropagation()\n onDismissRef.current()\n }\n\n const onFocusIn = (event: FocusEvent) => {\n const target = event.target as Node | null\n focusInside = Boolean(floating.current?.contains(target))\n if (within(target)) {\n engaged = true\n } else if (engaged && focusOutRef.current) {\n // focusInside 已为 false:焦点去了它该去的地方,卸载时不抢回来。\n onDismissRef.current()\n }\n }\n\n document.addEventListener('pointerdown', onPointerDown, true)\n document.addEventListener('keydown', onKeyDown, true)\n document.addEventListener('focusin', onFocusIn, true)\n return () => {\n document.removeEventListener('pointerdown', onPointerDown, true)\n document.removeEventListener('keydown', onKeyDown, true)\n document.removeEventListener('focusin', onFocusIn, true)\n removeEscapeLayer(layer)\n\n if (!focusInside || !returnFocusRef.current) return\n const active = document.activeElement\n // 焦点仍在一个挂载着的非 body 元素上 —— 要么浮层没卸载,要么用户已经移走了焦点。\n if (active && active !== document.body && active.isConnected) return\n const target = returnFocusRef.current()\n if (target?.isConnected) target.focus()\n }\n }, [open, floating, anchor])\n}\n"],"mappings":";AAEA,SAAS,WAAW,cAAc;AAClC,SAAS,kBAAkB,iBAAiB,yBAAyB;AACrE,SAAS,oBAAoB;AAgCtB,SAAS,cAAc,SAA6D;AACzF,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,aAAa,OAAO,EAAE,CAAC,KAAK;AACrC;AA+BO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAoB;AACtB,GAA4B;AAC1B,QAAM,eAAe,OAAO,SAAS;AACrC,QAAM,iBAAiB,OAAO,WAAW;AACzC,QAAM,cAAc,OAAO,iBAAiB;AAC5C,YAAU,MAAM;AACd,iBAAa,UAAU;AACvB,mBAAe,UAAU;AACzB,gBAAY,UAAU;AAAA,EACxB,CAAC;AAED,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,UAAM,QAAQ,CAAC;AACf,oBAAgB,KAAK;AAErB,UAAM,SAAS,CAAC,SACd,QAAQ,SAAS,SAAS,SAAS,IAAI,KAAK,QAAQ,SAAS,SAAS,IAAI,CAAC;AAC7E,QAAI,cAAc,QAAQ,SAAS,SAAS,SAAS,SAAS,aAAa,CAAC;AAE5E,QAAI,UAAU,OAAO,SAAS,aAAa;AAE3C,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,SAAS,MAAM;AACrB,UAAI,CAAC,OAAQ;AACb,UAAI,SAAS,SAAS,SAAS,MAAM,EAAG;AACxC,UAAI,QAAQ,SAAS,SAAS,MAAM,EAAG;AACvC,mBAAa,QAAQ;AAAA,IACvB;AAEA,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,YAAY,CAAC,iBAAiB,KAAK,EAAG;AACxD,YAAM,gBAAgB;AACtB,mBAAa,QAAQ;AAAA,IACvB;AAEA,UAAM,YAAY,CAAC,UAAsB;AACvC,YAAM,SAAS,MAAM;AACrB,oBAAc,QAAQ,SAAS,SAAS,SAAS,MAAM,CAAC;AACxD,UAAI,OAAO,MAAM,GAAG;AAClB,kBAAU;AAAA,MACZ,WAAW,WAAW,YAAY,SAAS;AAEzC,qBAAa,QAAQ;AAAA,MACvB;AAAA,IACF;AAEA,aAAS,iBAAiB,eAAe,eAAe,IAAI;AAC5D,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,WAAO,MAAM;AACX,eAAS,oBAAoB,eAAe,eAAe,IAAI;AAC/D,eAAS,oBAAoB,WAAW,WAAW,IAAI;AACvD,eAAS,oBAAoB,WAAW,WAAW,IAAI;AACvD,wBAAkB,KAAK;AAEvB,UAAI,CAAC,eAAe,CAAC,eAAe,QAAS;AAC7C,YAAM,SAAS,SAAS;AAExB,UAAI,UAAU,WAAW,SAAS,QAAQ,OAAO,YAAa;AAC9D,YAAM,SAAS,eAAe,QAAQ;AACtC,UAAI,QAAQ,YAAa,QAAO,MAAM;AAAA,IACxC;AAAA,EACF,GAAG,CAAC,MAAM,UAAU,MAAM,CAAC;AAC7B;","names":[]}
@@ -8,7 +8,8 @@ function useListNavigation({
8
8
  onSelect,
9
9
  onDismiss,
10
10
  orientation = "vertical",
11
- loop = true
11
+ loop = true,
12
+ textEntry = false
12
13
  }) {
13
14
  const [active, setActive] = useState(-1);
14
15
  const typeahead = useRef({ query: "", at: 0 });
@@ -50,13 +51,18 @@ function useListNavigation({
50
51
  setActive((i) => i < 0 ? edge(false) : step(i, -1));
51
52
  break;
52
53
  case "Home":
54
+ if (textEntry) return;
53
55
  setActive(edge(true));
54
56
  break;
55
57
  case "End":
58
+ if (textEntry) return;
56
59
  setActive(edge(false));
57
60
  break;
58
- case "Enter":
59
61
  case " ":
62
+ if (textEntry || active < 0) return;
63
+ onSelect?.(active);
64
+ break;
65
+ case "Enter":
60
66
  if (active < 0) return;
61
67
  onSelect?.(active);
62
68
  break;
@@ -64,7 +70,7 @@ function useListNavigation({
64
70
  onDismiss?.();
65
71
  break;
66
72
  default: {
67
- if (!getText || event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey) {
73
+ if (textEntry || !getText || event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey) {
68
74
  return;
69
75
  }
70
76
  const now = event.timeStamp;
@@ -85,7 +91,7 @@ function useListNavigation({
85
91
  }
86
92
  event.preventDefault();
87
93
  },
88
- [active, count, edge, getText, isDisabled, onDismiss, onSelect, orientation, step]
94
+ [active, count, edge, getText, isDisabled, onDismiss, onSelect, orientation, step, textEntry]
89
95
  );
90
96
  return { active, setActive, onKeyDown };
91
97
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/internal/use-list-navigation.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\n\n/** typeahead 的按键合并窗口。超过这个间隔算新一轮输入。 */\nconst TYPEAHEAD_RESET = 600\n\nexport interface UseListNavigationOptions {\n /** 选项总数 */\n count: number\n /** 判断第 i 项是否被禁用 —— 键盘应当跳过它 */\n isDisabled?: (index: number) => boolean\n /** 供 typeahead 匹配的文本。返回空串即该项不参与首字母跳转 */\n getText?: (index: number) => string\n /** 回车 / 空格在活动项上确认 */\n onSelect?: (index: number) => void\n /** 请求关闭列表(Esc,或在末项 Tab 出去) */\n onDismiss?: () => void\n /** 排列方向。水平列表用左右键,垂直列表用上下键 */\n orientation?: 'vertical' | 'horizontal'\n /** 走到头是否绕回另一端 */\n loop?: boolean\n}\n\n/**\n * 列表型浮层的键盘导航 —— 04 · I12 的落点。\n *\n * I12 记录 Select / Combobox / ContextMenu / Menubar / Command / Popover\n * **全部没有键盘导航**,与 F5 合起来「整个浮层族的键盘可达性是系统性缺失的」。\n * 01 §1.10 ② 的裁决是自建并收敛为一个共享 hook,这就是那个 hook。\n *\n * 覆盖:上下(或左右)移动、Home / End、回车与空格确认、Esc 关闭、\n * 首字母跳转。禁用项在移动中被跳过 —— 停在一个按了没反应的项上是最差的反馈。\n */\nexport function useListNavigation({\n count,\n isDisabled,\n getText,\n onSelect,\n onDismiss,\n orientation = 'vertical',\n loop = true,\n}: UseListNavigationOptions) {\n const [active, setActive] = useState(-1)\n const typeahead = useRef({ query: '', at: 0 })\n\n /** 从 from 起按 step 找下一个可用项。全禁用时返回原值,避免死循环。 */\n const step = useCallback(\n (from: number, delta: number): number => {\n if (count === 0) return -1\n let next = from\n for (let i = 0; i < count; i += 1) {\n next += delta\n if (next < 0) {\n if (!loop) return from\n next = count - 1\n } else if (next >= count) {\n if (!loop) return from\n next = 0\n }\n if (!isDisabled?.(next)) return next\n }\n return from\n },\n [count, isDisabled, loop]\n )\n\n const edge = useCallback(\n (fromStart: boolean): number => {\n const start = fromStart ? -1 : count\n return step(start, fromStart ? 1 : -1)\n },\n [count, step]\n )\n\n const onKeyDown = useCallback(\n (event: ReactKeyboardEvent) => {\n const prevKey = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft'\n const nextKey = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight'\n\n switch (event.key) {\n case nextKey:\n setActive((i) => step(i, 1))\n break\n case prevKey:\n setActive((i) => (i < 0 ? edge(false) : step(i, -1)))\n break\n case 'Home':\n setActive(edge(true))\n break\n case 'End':\n setActive(edge(false))\n break\n case 'Enter':\n case ' ':\n if (active < 0) return\n onSelect?.(active)\n break\n case 'Escape':\n onDismiss?.()\n break\n default: {\n // 首字母跳转。只对单个可打印字符生效,带修饰键的一律放过 ——\n // Ctrl+A 之类不该被当成 typeahead。\n if (!getText || event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey) {\n return\n }\n const now = event.timeStamp\n const state = typeahead.current\n state.query = now - state.at > TYPEAHEAD_RESET ? event.key : state.query + event.key\n state.at = now\n\n const query = state.query.toLowerCase()\n for (let i = 1; i <= count; i += 1) {\n const index = (Math.max(active, 0) + i) % count\n if (isDisabled?.(index)) continue\n if (getText(index).toLowerCase().startsWith(query)) {\n setActive(index)\n break\n }\n }\n break\n }\n }\n event.preventDefault()\n },\n [active, count, edge, getText, isDisabled, onDismiss, onSelect, orientation, step]\n )\n\n return { active, setActive, onKeyDown }\n}\n"],"mappings":";AAEA,SAAS,aAAa,QAAQ,gBAAgB;AAI9C,MAAM,kBAAkB;AA6BjB,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,OAAO;AACT,GAA6B;AAC3B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,EAAE;AACvC,QAAM,YAAY,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AAG7C,QAAM,OAAO;AAAA,IACX,CAAC,MAAc,UAA0B;AACvC,UAAI,UAAU,EAAG,QAAO;AACxB,UAAI,OAAO;AACX,eAAS,IAAI,GAAG,IAAI,OAAO,KAAK,GAAG;AACjC,gBAAQ;AACR,YAAI,OAAO,GAAG;AACZ,cAAI,CAAC,KAAM,QAAO;AAClB,iBAAO,QAAQ;AAAA,QACjB,WAAW,QAAQ,OAAO;AACxB,cAAI,CAAC,KAAM,QAAO;AAClB,iBAAO;AAAA,QACT;AACA,YAAI,CAAC,aAAa,IAAI,EAAG,QAAO;AAAA,MAClC;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,OAAO,YAAY,IAAI;AAAA,EAC1B;AAEA,QAAM,OAAO;AAAA,IACX,CAAC,cAA+B;AAC9B,YAAM,QAAQ,YAAY,KAAK;AAC/B,aAAO,KAAK,OAAO,YAAY,IAAI,EAAE;AAAA,IACvC;AAAA,IACA,CAAC,OAAO,IAAI;AAAA,EACd;AAEA,QAAM,YAAY;AAAA,IAChB,CAAC,UAA8B;AAC7B,YAAM,UAAU,gBAAgB,aAAa,YAAY;AACzD,YAAM,UAAU,gBAAgB,aAAa,cAAc;AAE3D,cAAQ,MAAM,KAAK;AAAA,QACjB,KAAK;AACH,oBAAU,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAC3B;AAAA,QACF,KAAK;AACH,oBAAU,CAAC,MAAO,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,GAAG,EAAE,CAAE;AACpD;AAAA,QACF,KAAK;AACH,oBAAU,KAAK,IAAI,CAAC;AACpB;AAAA,QACF,KAAK;AACH,oBAAU,KAAK,KAAK,CAAC;AACrB;AAAA,QACF,KAAK;AAAA,QACL,KAAK;AACH,cAAI,SAAS,EAAG;AAChB,qBAAW,MAAM;AACjB;AAAA,QACF,KAAK;AACH,sBAAY;AACZ;AAAA,QACF,SAAS;AAGP,cAAI,CAAC,WAAW,MAAM,IAAI,WAAW,KAAK,MAAM,WAAW,MAAM,WAAW,MAAM,QAAQ;AACxF;AAAA,UACF;AACA,gBAAM,MAAM,MAAM;AAClB,gBAAM,QAAQ,UAAU;AACxB,gBAAM,QAAQ,MAAM,MAAM,KAAK,kBAAkB,MAAM,MAAM,MAAM,QAAQ,MAAM;AACjF,gBAAM,KAAK;AAEX,gBAAM,QAAQ,MAAM,MAAM,YAAY;AACtC,mBAAS,IAAI,GAAG,KAAK,OAAO,KAAK,GAAG;AAClC,kBAAM,SAAS,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK;AAC1C,gBAAI,aAAa,KAAK,EAAG;AACzB,gBAAI,QAAQ,KAAK,EAAE,YAAY,EAAE,WAAW,KAAK,GAAG;AAClD,wBAAU,KAAK;AACf;AAAA,YACF;AAAA,UACF;AACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,eAAe;AAAA,IACvB;AAAA,IACA,CAAC,QAAQ,OAAO,MAAM,SAAS,YAAY,WAAW,UAAU,aAAa,IAAI;AAAA,EACnF;AAEA,SAAO,EAAE,QAAQ,WAAW,UAAU;AACxC;","names":[]}
1
+ {"version":3,"sources":["../../src/internal/use-list-navigation.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\n\n/** typeahead 的按键合并窗口。超过这个间隔算新一轮输入。 */\nconst TYPEAHEAD_RESET = 600\n\nexport interface UseListNavigationOptions {\n /** 选项总数 */\n count: number\n /** 判断第 i 项是否被禁用 —— 键盘应当跳过它 */\n isDisabled?: (index: number) => boolean\n /** 供 typeahead 匹配的文本。返回空串即该项不参与首字母跳转 */\n getText?: (index: number) => string\n /** 回车 / 空格在活动项上确认 */\n onSelect?: (index: number) => void\n /** 请求关闭列表(Esc,或在末项 Tab 出去) */\n onDismiss?: () => void\n /** 排列方向。水平列表用左右键,垂直列表用上下键 */\n orientation?: 'vertical' | 'horizontal'\n /** 走到头是否绕回另一端 */\n loop?: boolean\n /**\n * 键盘事件来自一个文本框(Combobox 的输入框)。此时可打印字符、空格、Home / End\n * 都属于文本编辑,一律放给输入框:首字母跳转与空格确认会把用户正在打的字吞掉 ——\n * 实测 Combobox 按任何字母数字输入框都保持为空,只有输入法上屏的中文能进去。\n */\n textEntry?: boolean\n}\n\n/**\n * 列表型浮层的键盘导航 —— 04 · I12 的落点。\n *\n * I12 记录 Select / Combobox / ContextMenu / Menubar / Command / Popover\n * **全部没有键盘导航**,与 F5 合起来「整个浮层族的键盘可达性是系统性缺失的」。\n * 01 §1.10 ② 的裁决是自建并收敛为一个共享 hook,这就是那个 hook。\n *\n * 覆盖:上下(或左右)移动、Home / End、回车与空格确认、Esc 关闭、\n * 首字母跳转。禁用项在移动中被跳过 —— 停在一个按了没反应的项上是最差的反馈。\n */\nexport function useListNavigation({\n count,\n isDisabled,\n getText,\n onSelect,\n onDismiss,\n orientation = 'vertical',\n loop = true,\n textEntry = false,\n}: UseListNavigationOptions) {\n const [active, setActive] = useState(-1)\n const typeahead = useRef({ query: '', at: 0 })\n\n /** 从 from 起按 step 找下一个可用项。全禁用时返回原值,避免死循环。 */\n const step = useCallback(\n (from: number, delta: number): number => {\n if (count === 0) return -1\n let next = from\n for (let i = 0; i < count; i += 1) {\n next += delta\n if (next < 0) {\n if (!loop) return from\n next = count - 1\n } else if (next >= count) {\n if (!loop) return from\n next = 0\n }\n if (!isDisabled?.(next)) return next\n }\n return from\n },\n [count, isDisabled, loop]\n )\n\n const edge = useCallback(\n (fromStart: boolean): number => {\n const start = fromStart ? -1 : count\n return step(start, fromStart ? 1 : -1)\n },\n [count, step]\n )\n\n const onKeyDown = useCallback(\n (event: ReactKeyboardEvent) => {\n const prevKey = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft'\n const nextKey = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight'\n\n switch (event.key) {\n case nextKey:\n setActive((i) => step(i, 1))\n break\n case prevKey:\n setActive((i) => (i < 0 ? edge(false) : step(i, -1)))\n break\n case 'Home':\n if (textEntry) return\n setActive(edge(true))\n break\n case 'End':\n if (textEntry) return\n setActive(edge(false))\n break\n case ' ':\n if (textEntry || active < 0) return\n onSelect?.(active)\n break\n case 'Enter':\n if (active < 0) return\n onSelect?.(active)\n break\n case 'Escape':\n onDismiss?.()\n break\n default: {\n // 首字母跳转。只对单个可打印字符生效,带修饰键的一律放过 ——\n // Ctrl+A 之类不该被当成 typeahead。\n if (textEntry || !getText || event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey) {\n return\n }\n const now = event.timeStamp\n const state = typeahead.current\n state.query = now - state.at > TYPEAHEAD_RESET ? event.key : state.query + event.key\n state.at = now\n\n const query = state.query.toLowerCase()\n for (let i = 1; i <= count; i += 1) {\n const index = (Math.max(active, 0) + i) % count\n if (isDisabled?.(index)) continue\n if (getText(index).toLowerCase().startsWith(query)) {\n setActive(index)\n break\n }\n }\n break\n }\n }\n event.preventDefault()\n },\n [active, count, edge, getText, isDisabled, onDismiss, onSelect, orientation, step, textEntry]\n )\n\n return { active, setActive, onKeyDown }\n}\n"],"mappings":";AAEA,SAAS,aAAa,QAAQ,gBAAgB;AAI9C,MAAM,kBAAkB;AAmCjB,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,OAAO;AAAA,EACP,YAAY;AACd,GAA6B;AAC3B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,EAAE;AACvC,QAAM,YAAY,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AAG7C,QAAM,OAAO;AAAA,IACX,CAAC,MAAc,UAA0B;AACvC,UAAI,UAAU,EAAG,QAAO;AACxB,UAAI,OAAO;AACX,eAAS,IAAI,GAAG,IAAI,OAAO,KAAK,GAAG;AACjC,gBAAQ;AACR,YAAI,OAAO,GAAG;AACZ,cAAI,CAAC,KAAM,QAAO;AAClB,iBAAO,QAAQ;AAAA,QACjB,WAAW,QAAQ,OAAO;AACxB,cAAI,CAAC,KAAM,QAAO;AAClB,iBAAO;AAAA,QACT;AACA,YAAI,CAAC,aAAa,IAAI,EAAG,QAAO;AAAA,MAClC;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,OAAO,YAAY,IAAI;AAAA,EAC1B;AAEA,QAAM,OAAO;AAAA,IACX,CAAC,cAA+B;AAC9B,YAAM,QAAQ,YAAY,KAAK;AAC/B,aAAO,KAAK,OAAO,YAAY,IAAI,EAAE;AAAA,IACvC;AAAA,IACA,CAAC,OAAO,IAAI;AAAA,EACd;AAEA,QAAM,YAAY;AAAA,IAChB,CAAC,UAA8B;AAC7B,YAAM,UAAU,gBAAgB,aAAa,YAAY;AACzD,YAAM,UAAU,gBAAgB,aAAa,cAAc;AAE3D,cAAQ,MAAM,KAAK;AAAA,QACjB,KAAK;AACH,oBAAU,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAC3B;AAAA,QACF,KAAK;AACH,oBAAU,CAAC,MAAO,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,GAAG,EAAE,CAAE;AACpD;AAAA,QACF,KAAK;AACH,cAAI,UAAW;AACf,oBAAU,KAAK,IAAI,CAAC;AACpB;AAAA,QACF,KAAK;AACH,cAAI,UAAW;AACf,oBAAU,KAAK,KAAK,CAAC;AACrB;AAAA,QACF,KAAK;AACH,cAAI,aAAa,SAAS,EAAG;AAC7B,qBAAW,MAAM;AACjB;AAAA,QACF,KAAK;AACH,cAAI,SAAS,EAAG;AAChB,qBAAW,MAAM;AACjB;AAAA,QACF,KAAK;AACH,sBAAY;AACZ;AAAA,QACF,SAAS;AAGP,cAAI,aAAa,CAAC,WAAW,MAAM,IAAI,WAAW,KAAK,MAAM,WAAW,MAAM,WAAW,MAAM,QAAQ;AACrG;AAAA,UACF;AACA,gBAAM,MAAM,MAAM;AAClB,gBAAM,QAAQ,UAAU;AACxB,gBAAM,QAAQ,MAAM,MAAM,KAAK,kBAAkB,MAAM,MAAM,MAAM,QAAQ,MAAM;AACjF,gBAAM,KAAK;AAEX,gBAAM,QAAQ,MAAM,MAAM,YAAY;AACtC,mBAAS,IAAI,GAAG,KAAK,OAAO,KAAK,GAAG;AAClC,kBAAM,SAAS,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK;AAC1C,gBAAI,aAAa,KAAK,EAAG;AACzB,gBAAI,QAAQ,KAAK,EAAE,YAAY,EAAE,WAAW,KAAK,GAAG;AAClD,wBAAU,KAAK;AACf;AAAA,YACF;AAAA,UACF;AACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,eAAe;AAAA,IACvB;AAAA,IACA,CAAC,QAAQ,OAAO,MAAM,SAAS,YAAY,WAAW,UAAU,aAAa,MAAM,SAAS;AAAA,EAC9F;AAEA,SAAO,EAAE,QAAQ,WAAW,UAAU;AACxC;","names":[]}
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
  import { useEffect, useRef } from "react";
3
3
  import { focusFirst, trapTab } from "./focus.js";
4
+ import { isTopEscapeLayer, pushEscapeLayer, removeEscapeLayer } from "./escape-stack.js";
4
5
  let scrollLocks = 0;
5
6
  let restoreOverflow = "";
6
7
  let restorePadding = "";
@@ -13,6 +14,7 @@ function lockScroll() {
13
14
  body.style.overflow = "hidden";
14
15
  if (barWidth > 0) body.style.paddingRight = `${barWidth}px`;
15
16
  }
17
+ const modalStack = [];
16
18
  function unlockScroll() {
17
19
  if (--scrollLocks > 0) return;
18
20
  scrollLocks = 0;
@@ -21,29 +23,42 @@ function unlockScroll() {
21
23
  }
22
24
  function useModal({ open, ref, onClose, disableEscape = false }) {
23
25
  const restoreTo = useRef(null);
26
+ const onCloseRef = useRef(onClose);
27
+ const disableEscapeRef = useRef(disableEscape);
28
+ useEffect(() => {
29
+ onCloseRef.current = onClose;
30
+ disableEscapeRef.current = disableEscape;
31
+ });
24
32
  useEffect(() => {
25
33
  if (!open) return;
26
34
  const container = ref.current;
27
35
  if (!container) return;
28
36
  restoreTo.current = document.activeElement;
37
+ modalStack.push(container);
38
+ pushEscapeLayer(container);
29
39
  focusFirst(container);
30
40
  lockScroll();
31
41
  const onKeyDown = (event) => {
32
- if (event.key === "Escape" && !disableEscape) {
42
+ if (event.key === "Escape") {
43
+ if (!isTopEscapeLayer(container) || disableEscapeRef.current) return;
33
44
  event.stopPropagation();
34
- onClose?.();
45
+ onCloseRef.current?.();
35
46
  return;
36
47
  }
48
+ if (modalStack[modalStack.length - 1] !== container) return;
37
49
  if (trapTab(container, event)) event.preventDefault();
38
50
  };
39
51
  document.addEventListener("keydown", onKeyDown, true);
40
52
  return () => {
41
53
  document.removeEventListener("keydown", onKeyDown, true);
54
+ const index = modalStack.lastIndexOf(container);
55
+ if (index !== -1) modalStack.splice(index, 1);
56
+ removeEscapeLayer(container);
42
57
  unlockScroll();
43
58
  const target = restoreTo.current;
44
59
  if (target?.isConnected) target.focus();
45
60
  };
46
- }, [open, ref, onClose, disableEscape]);
61
+ }, [open, ref]);
47
62
  }
48
63
  export {
49
64
  useModal
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/internal/use-modal.ts"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { RefObject } from 'react'\nimport { focusFirst, trapTab } from './focus.js'\n\n/** 模态打开时锁住背景滚动的引用计数。多层模态叠加时只在最后一层关闭后解锁。 */\nlet scrollLocks = 0\nlet restoreOverflow = ''\nlet restorePadding = ''\n\nfunction lockScroll() {\n if (scrollLocks++ > 0) return\n const { body, documentElement } = document\n // 滚动条消失会让页面横向跳一下 —— 用等宽的内边距补上。\n const barWidth = window.innerWidth - documentElement.clientWidth\n restoreOverflow = body.style.overflow\n restorePadding = body.style.paddingRight\n body.style.overflow = 'hidden'\n if (barWidth > 0) body.style.paddingRight = `${barWidth}px`\n}\n\nfunction unlockScroll() {\n if (--scrollLocks > 0) return\n scrollLocks = 0\n document.body.style.overflow = restoreOverflow\n document.body.style.paddingRight = restorePadding\n}\n\nexport interface UseModalOptions {\n /** 是否打开 */\n open: boolean\n /** 浮层容器,焦点陷阱与外点击判定都以它为界 */\n ref: RefObject<HTMLElement | null>\n /** 请求关闭。Esc 与遮罩点击都会调用 */\n onClose?: (() => void) | undefined\n /** 关掉 Esc 关闭。用于必须显式选择的确认框 */\n disableEscape?: boolean\n}\n\n/**\n * 模态浮层的行为基座 —— 04 · F5 点名缺失的三件事,加上滚动锁定。\n *\n * 承担:\n * · Esc 关闭\n * · 焦点陷阱(Tab / Shift+Tab 在浮层内循环)\n * · 打开时把焦点移入浮层,关闭后恢复到触发元素\n * · 背景滚动锁定,带滚动条宽度补偿\n *\n * 前三件是 F5 的原文。滚动锁定不在那份清单里,但 WAI-ARIA 的模态对话框模式\n * 要求背景不可交互 —— 一个能在背后滚动的「模态」名不副实。\n *\n * 遮罩点击关闭不在这里,它是 DOM 结构的事,由 Overlay 组件负责。\n */\nexport function useModal({ open, ref, onClose, disableEscape = false }: UseModalOptions): void {\n const restoreTo = useRef<HTMLElement | null>(null)\n\n useEffect(() => {\n if (!open) return\n const container = ref.current\n if (!container) return\n\n // 记住是谁把浮层打开的,关闭后要把焦点还回去。\n restoreTo.current = document.activeElement as HTMLElement | null\n focusFirst(container)\n lockScroll()\n\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key === 'Escape' && !disableEscape) {\n event.stopPropagation()\n onClose?.()\n return\n }\n if (trapTab(container, event)) event.preventDefault()\n }\n\n document.addEventListener('keydown', onKeyDown, true)\n return () => {\n document.removeEventListener('keydown', onKeyDown, true)\n unlockScroll()\n // 触发元素可能已随内容卸载 —— isConnected 挡住往已移除节点上聚焦。\n const target = restoreTo.current\n if (target?.isConnected) target.focus()\n }\n }, [open, ref, onClose, disableEscape])\n}\n"],"mappings":";AAEA,SAAS,WAAW,cAAc;AAElC,SAAS,YAAY,eAAe;AAGpC,IAAI,cAAc;AAClB,IAAI,kBAAkB;AACtB,IAAI,iBAAiB;AAErB,SAAS,aAAa;AACpB,MAAI,gBAAgB,EAAG;AACvB,QAAM,EAAE,MAAM,gBAAgB,IAAI;AAElC,QAAM,WAAW,OAAO,aAAa,gBAAgB;AACrD,oBAAkB,KAAK,MAAM;AAC7B,mBAAiB,KAAK,MAAM;AAC5B,OAAK,MAAM,WAAW;AACtB,MAAI,WAAW,EAAG,MAAK,MAAM,eAAe,GAAG,QAAQ;AACzD;AAEA,SAAS,eAAe;AACtB,MAAI,EAAE,cAAc,EAAG;AACvB,gBAAc;AACd,WAAS,KAAK,MAAM,WAAW;AAC/B,WAAS,KAAK,MAAM,eAAe;AACrC;AA2BO,SAAS,SAAS,EAAE,MAAM,KAAK,SAAS,gBAAgB,MAAM,GAA0B;AAC7F,QAAM,YAAY,OAA2B,IAAI;AAEjD,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,UAAM,YAAY,IAAI;AACtB,QAAI,CAAC,UAAW;AAGhB,cAAU,UAAU,SAAS;AAC7B,eAAW,SAAS;AACpB,eAAW;AAEX,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,YAAY,CAAC,eAAe;AAC5C,cAAM,gBAAgB;AACtB,kBAAU;AACV;AAAA,MACF;AACA,UAAI,QAAQ,WAAW,KAAK,EAAG,OAAM,eAAe;AAAA,IACtD;AAEA,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,WAAW,IAAI;AACvD,mBAAa;AAEb,YAAM,SAAS,UAAU;AACzB,UAAI,QAAQ,YAAa,QAAO,MAAM;AAAA,IACxC;AAAA,EACF,GAAG,CAAC,MAAM,KAAK,SAAS,aAAa,CAAC;AACxC;","names":[]}
1
+ {"version":3,"sources":["../../src/internal/use-modal.ts"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { RefObject } from 'react'\nimport { focusFirst, trapTab } from './focus.js'\nimport { isTopEscapeLayer, pushEscapeLayer, removeEscapeLayer } from './escape-stack.js'\n\n/** 模态打开时锁住背景滚动的引用计数。多层模态叠加时只在最后一层关闭后解锁。 */\nlet scrollLocks = 0\nlet restoreOverflow = ''\nlet restorePadding = ''\n\nfunction lockScroll() {\n if (scrollLocks++ > 0) return\n const { body, documentElement } = document\n // 滚动条消失会让页面横向跳一下 —— 用等宽的内边距补上。\n const barWidth = window.innerWidth - documentElement.clientWidth\n restoreOverflow = body.style.overflow\n restorePadding = body.style.paddingRight\n body.style.overflow = 'hidden'\n if (barWidth > 0) body.style.paddingRight = `${barWidth}px`\n}\n\n/**\n * 当前打开的模态容器,后开的在末尾。焦点陷阱只由最上层的模态处理 —— 每层都在\n * document 上挂 capture 监听,不按栈判定时,抽屉上叠确认框后两层的陷阱互相把焦点\n * 拽来拽去,Tab 永远停在同一个按钮上。Esc 另走 escape-stack(还要算上非模态浮层)。\n */\nconst modalStack: HTMLElement[] = []\n\nfunction unlockScroll() {\n if (--scrollLocks > 0) return\n scrollLocks = 0\n document.body.style.overflow = restoreOverflow\n document.body.style.paddingRight = restorePadding\n}\n\nexport interface UseModalOptions {\n /** 是否打开 */\n open: boolean\n /** 浮层容器,焦点陷阱与外点击判定都以它为界 */\n ref: RefObject<HTMLElement | null>\n /** 请求关闭。Esc 与遮罩点击都会调用 */\n onClose?: (() => void) | undefined\n /** 关掉 Esc 关闭。用于必须显式选择的确认框 */\n disableEscape?: boolean\n}\n\n/**\n * 模态浮层的行为基座 —— 04 · F5 点名缺失的三件事,加上滚动锁定。\n *\n * 承担:\n * · Esc 关闭\n * · 焦点陷阱(Tab / Shift+Tab 在浮层内循环)\n * · 打开时把焦点移入浮层,关闭后恢复到触发元素\n * · 背景滚动锁定,带滚动条宽度补偿\n *\n * 前三件是 F5 的原文。滚动锁定不在那份清单里,但 WAI-ARIA 的模态对话框模式\n * 要求背景不可交互 —— 一个能在背后滚动的「模态」名不副实。\n *\n * 遮罩点击关闭不在这里,它是 DOM 结构的事,由 Overlay 组件负责。\n */\nexport function useModal({ open, ref, onClose, disableEscape = false }: UseModalOptions): void {\n const restoreTo = useRef<HTMLElement | null>(null)\n\n // 回调与开关走 ref,不进下面那个 effect 的依赖:调用方几乎总是传内联箭头函数,\n // 每次父组件重渲染都是新引用。若作为依赖,effect 会随每一次键入重跑 ——\n // 清理时把焦点还给触发元素、重跑时 focusFirst 又拽回首个控件,\n // 表单里在第二个字段打字,从第二个字符起就落进了第一个字段(实践验证实测)。\n const onCloseRef = useRef(onClose)\n const disableEscapeRef = useRef(disableEscape)\n useEffect(() => {\n onCloseRef.current = onClose\n disableEscapeRef.current = disableEscape\n })\n\n useEffect(() => {\n if (!open) return\n const container = ref.current\n if (!container) return\n\n // 记住是谁把浮层打开的,关闭后要把焦点还回去。\n restoreTo.current = document.activeElement as HTMLElement | null\n modalStack.push(container)\n pushEscapeLayer(container)\n focusFirst(container)\n lockScroll()\n\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key === 'Escape') {\n if (!isTopEscapeLayer(container) || disableEscapeRef.current) return\n event.stopPropagation()\n onCloseRef.current?.()\n return\n }\n if (modalStack[modalStack.length - 1] !== container) return\n if (trapTab(container, event)) event.preventDefault()\n }\n\n document.addEventListener('keydown', onKeyDown, true)\n return () => {\n document.removeEventListener('keydown', onKeyDown, true)\n const index = modalStack.lastIndexOf(container)\n if (index !== -1) modalStack.splice(index, 1)\n removeEscapeLayer(container)\n unlockScroll()\n // 触发元素可能已随内容卸载 —— isConnected 挡住往已移除节点上聚焦。\n const target = restoreTo.current\n if (target?.isConnected) target.focus()\n }\n }, [open, ref])\n}\n"],"mappings":";AAEA,SAAS,WAAW,cAAc;AAElC,SAAS,YAAY,eAAe;AACpC,SAAS,kBAAkB,iBAAiB,yBAAyB;AAGrE,IAAI,cAAc;AAClB,IAAI,kBAAkB;AACtB,IAAI,iBAAiB;AAErB,SAAS,aAAa;AACpB,MAAI,gBAAgB,EAAG;AACvB,QAAM,EAAE,MAAM,gBAAgB,IAAI;AAElC,QAAM,WAAW,OAAO,aAAa,gBAAgB;AACrD,oBAAkB,KAAK,MAAM;AAC7B,mBAAiB,KAAK,MAAM;AAC5B,OAAK,MAAM,WAAW;AACtB,MAAI,WAAW,EAAG,MAAK,MAAM,eAAe,GAAG,QAAQ;AACzD;AAOA,MAAM,aAA4B,CAAC;AAEnC,SAAS,eAAe;AACtB,MAAI,EAAE,cAAc,EAAG;AACvB,gBAAc;AACd,WAAS,KAAK,MAAM,WAAW;AAC/B,WAAS,KAAK,MAAM,eAAe;AACrC;AA2BO,SAAS,SAAS,EAAE,MAAM,KAAK,SAAS,gBAAgB,MAAM,GAA0B;AAC7F,QAAM,YAAY,OAA2B,IAAI;AAMjD,QAAM,aAAa,OAAO,OAAO;AACjC,QAAM,mBAAmB,OAAO,aAAa;AAC7C,YAAU,MAAM;AACd,eAAW,UAAU;AACrB,qBAAiB,UAAU;AAAA,EAC7B,CAAC;AAED,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,UAAM,YAAY,IAAI;AACtB,QAAI,CAAC,UAAW;AAGhB,cAAU,UAAU,SAAS;AAC7B,eAAW,KAAK,SAAS;AACzB,oBAAgB,SAAS;AACzB,eAAW,SAAS;AACpB,eAAW;AAEX,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,UAAU;AAC1B,YAAI,CAAC,iBAAiB,SAAS,KAAK,iBAAiB,QAAS;AAC9D,cAAM,gBAAgB;AACtB,mBAAW,UAAU;AACrB;AAAA,MACF;AACA,UAAI,WAAW,WAAW,SAAS,CAAC,MAAM,UAAW;AACrD,UAAI,QAAQ,WAAW,KAAK,EAAG,OAAM,eAAe;AAAA,IACtD;AAEA,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,WAAW,IAAI;AACvD,YAAM,QAAQ,WAAW,YAAY,SAAS;AAC9C,UAAI,UAAU,GAAI,YAAW,OAAO,OAAO,CAAC;AAC5C,wBAAkB,SAAS;AAC3B,mBAAa;AAEb,YAAM,SAAS,UAAU;AACzB,UAAI,QAAQ,YAAa,QAAO,MAAM;AAAA,IACxC;AAAA,EACF,GAAG,CAAC,MAAM,GAAG,CAAC;AAChB;","names":[]}
@@ -0,0 +1,94 @@
1
+ "use client";
2
+ import { useCallback, useRef, useState } from "react";
3
+ function rovingTarget(key, from, count, isDisabled, orientation = "horizontal") {
4
+ const prevKey = orientation === "horizontal" ? "ArrowLeft" : "ArrowUp";
5
+ const nextKey = orientation === "horizontal" ? "ArrowRight" : "ArrowDown";
6
+ let at;
7
+ let delta;
8
+ let wrap = true;
9
+ switch (key) {
10
+ case nextKey:
11
+ at = from;
12
+ delta = 1;
13
+ break;
14
+ case prevKey:
15
+ at = from;
16
+ delta = -1;
17
+ break;
18
+ case "Home":
19
+ at = -1;
20
+ delta = 1;
21
+ wrap = false;
22
+ break;
23
+ case "End":
24
+ at = count;
25
+ delta = -1;
26
+ wrap = false;
27
+ break;
28
+ default:
29
+ return null;
30
+ }
31
+ for (let i = 0; i < count; i += 1) {
32
+ at += delta;
33
+ if (at < 0 || at >= count) {
34
+ if (!wrap) return null;
35
+ at = (at + count) % count;
36
+ }
37
+ if (!isDisabled?.(at)) return at === from ? null : at;
38
+ }
39
+ return null;
40
+ }
41
+ function useRovingFocus({
42
+ count,
43
+ selected = -1,
44
+ isDisabled,
45
+ orientation = "horizontal",
46
+ onNavigate
47
+ }) {
48
+ const items = useRef([]);
49
+ const [focused, setFocused] = useState(-1);
50
+ const [last, setLast] = useState(-1);
51
+ const usable = (index) => index >= 0 && index < count && !isDisabled?.(index);
52
+ let tabStop = -1;
53
+ for (const candidate of [focused, selected, last]) {
54
+ if (usable(candidate)) {
55
+ tabStop = candidate;
56
+ break;
57
+ }
58
+ }
59
+ if (tabStop < 0) tabStop = rovingTarget("Home", -1, count, isDisabled, orientation) ?? -1;
60
+ const focusItem = useCallback((index) => {
61
+ items.current[index]?.focus();
62
+ }, []);
63
+ const getItemProps = (index) => ({
64
+ ref: (node) => {
65
+ items.current[index] = node;
66
+ },
67
+ tabIndex: index === tabStop ? 0 : -1,
68
+ onFocus: () => {
69
+ setFocused(index);
70
+ setLast(index);
71
+ },
72
+ onBlur: (event) => {
73
+ if (items.current.includes(event.relatedTarget)) return;
74
+ setFocused(-1);
75
+ },
76
+ onKeyDown: (event) => {
77
+ if (event.altKey || event.ctrlKey || event.metaKey) return;
78
+ const next = rovingTarget(event.key, index, count, isDisabled, orientation);
79
+ if (next === null) {
80
+ if (event.key === "Home" || event.key === "End") event.preventDefault();
81
+ return;
82
+ }
83
+ event.preventDefault();
84
+ focusItem(next);
85
+ onNavigate?.(next);
86
+ }
87
+ });
88
+ return { getItemProps, tabStop, focusItem };
89
+ }
90
+ export {
91
+ rovingTarget,
92
+ useRovingFocus
93
+ };
94
+ //# sourceMappingURL=use-roving-focus.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/internal/use-roving-focus.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useRef, useState } from 'react'\nimport type { FocusEvent as ReactFocusEvent, KeyboardEvent as ReactKeyboardEvent } from 'react'\n\nexport type RovingOrientation = 'horizontal' | 'vertical'\n\n/**\n * 方向键 / Home / End 对应的目标索引,跳过禁用项;该键不归方向导航、或无处可去时返回 null。\n *\n * ← / →(或 ↑ / ↓)首尾相接;Home / End 落到首末个可用项。单独导出给「每项都是\n * Tab 停靠点、只补方向键」的场合(Accordion 的标题行,WAI-ARIA accordion 模式)。\n */\nexport function rovingTarget(\n key: string,\n from: number,\n count: number,\n isDisabled?: (index: number) => boolean,\n orientation: RovingOrientation = 'horizontal'\n): number | null {\n const prevKey = orientation === 'horizontal' ? 'ArrowLeft' : 'ArrowUp'\n const nextKey = orientation === 'horizontal' ? 'ArrowRight' : 'ArrowDown'\n let at: number\n let delta: number\n let wrap = true\n switch (key) {\n case nextKey:\n at = from\n delta = 1\n break\n case prevKey:\n at = from\n delta = -1\n break\n case 'Home':\n at = -1\n delta = 1\n wrap = false\n break\n case 'End':\n at = count\n delta = -1\n wrap = false\n break\n default:\n return null\n }\n for (let i = 0; i < count; i += 1) {\n at += delta\n if (at < 0 || at >= count) {\n if (!wrap) return null\n at = (at + count) % count\n }\n if (!isDisabled?.(at)) return at === from ? null : at\n }\n return null\n}\n\nexport interface UseRovingFocusOptions {\n /** 项数 */\n count: number\n /** 选中项的索引,没有为 -1。焦点不在组内时,Tab 停靠点落在它上面 */\n selected?: number\n /** 第 i 项禁用 —— 方向键跳过它,它也不做停靠点 */\n isDisabled?: (index: number) => boolean\n orientation?: RovingOrientation\n /**\n * 方向键把焦点移到第 i 项之后调用。radio 语义在这里同时选中(选中跟随焦点);\n * tab 语义按 Tabs 的手动激活不传,只移焦点。\n */\n onNavigate?: (index: number) => void\n}\n\n/**\n * roving tabindex —— 一组控件只占一个 Tab 停靠点,组内用方向键移动(06 · P3-3)。\n *\n * radiogroup / tablist / menubar / menu 的 WAI-ARIA 模式都要求它。此前 Page Mode Switch、\n * ToggleGroup 的每一项都是停靠点,键盘用户穿过一个五项切换要按五次 Tab;Tabs 有 ← / →\n * 而每项仍可 Tab 到、且没有 Home / End;Menubar 有一份内联实现。现收敛为这一份。\n *\n * 停靠点的取法:焦点在组内时就是焦点所在项 —— 否则 Shift+Tab 会从一个 tabIndex=-1 的项\n * 退回到它前面那个 tabIndex=0 的兄弟上,而不是离开这一组(Tabs 手动激活时实测会这样);\n * 焦点离开后回到选中项,没有选中项时回到最近一次聚焦的项,再没有就是首个可用项。\n *\n * 返回 `getItemProps(i)`,展开到每一项上。需要额外按键的调用方(Menubar 的 ↓ 打开面板)\n * 自己先处理,余下的再交给它返回的 `onKeyDown`。\n */\nexport function useRovingFocus({\n count,\n selected = -1,\n isDisabled,\n orientation = 'horizontal',\n onNavigate,\n}: UseRovingFocusOptions) {\n const items = useRef<(HTMLElement | null)[]>([])\n const [focused, setFocused] = useState(-1)\n const [last, setLast] = useState(-1)\n\n const usable = (index: number) => index >= 0 && index < count && !isDisabled?.(index)\n let tabStop = -1\n for (const candidate of [focused, selected, last]) {\n if (usable(candidate)) {\n tabStop = candidate\n break\n }\n }\n if (tabStop < 0) tabStop = rovingTarget('Home', -1, count, isDisabled, orientation) ?? -1\n\n const focusItem = useCallback((index: number) => {\n items.current[index]?.focus()\n }, [])\n\n const getItemProps = (index: number) => ({\n ref: (node: HTMLElement | null) => {\n items.current[index] = node\n },\n tabIndex: index === tabStop ? 0 : -1,\n onFocus: () => {\n setFocused(index)\n setLast(index)\n },\n onBlur: (event: ReactFocusEvent) => {\n // 焦点移到组内另一项时由那一项的 onFocus 接手;移出组外才清空。\n if (items.current.includes(event.relatedTarget as HTMLElement | null)) return\n setFocused(-1)\n },\n onKeyDown: (event: ReactKeyboardEvent) => {\n if (event.altKey || event.ctrlKey || event.metaKey) return\n const next = rovingTarget(event.key, index, count, isDisabled, orientation)\n if (next === null) {\n // Home / End 在已处于首末项时也要吞掉,否则在可滚动祖先里会跳到页首页尾。\n if (event.key === 'Home' || event.key === 'End') event.preventDefault()\n return\n }\n event.preventDefault()\n focusItem(next)\n onNavigate?.(next)\n },\n })\n\n return { getItemProps, tabStop, focusItem }\n}\n"],"mappings":";AAEA,SAAS,aAAa,QAAQ,gBAAgB;AAWvC,SAAS,aACd,KACA,MACA,OACA,YACA,cAAiC,cAClB;AACf,QAAM,UAAU,gBAAgB,eAAe,cAAc;AAC7D,QAAM,UAAU,gBAAgB,eAAe,eAAe;AAC9D,MAAI;AACJ,MAAI;AACJ,MAAI,OAAO;AACX,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,WAAK;AACL,cAAQ;AACR;AAAA,IACF,KAAK;AACH,WAAK;AACL,cAAQ;AACR;AAAA,IACF,KAAK;AACH,WAAK;AACL,cAAQ;AACR,aAAO;AACP;AAAA,IACF,KAAK;AACH,WAAK;AACL,cAAQ;AACR,aAAO;AACP;AAAA,IACF;AACE,aAAO;AAAA,EACX;AACA,WAAS,IAAI,GAAG,IAAI,OAAO,KAAK,GAAG;AACjC,UAAM;AACN,QAAI,KAAK,KAAK,MAAM,OAAO;AACzB,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,KAAK,SAAS;AAAA,IACtB;AACA,QAAI,CAAC,aAAa,EAAE,EAAG,QAAO,OAAO,OAAO,OAAO;AAAA,EACrD;AACA,SAAO;AACT;AA+BO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA,cAAc;AAAA,EACd;AACF,GAA0B;AACxB,QAAM,QAAQ,OAA+B,CAAC,CAAC;AAC/C,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,EAAE;AACzC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,EAAE;AAEnC,QAAM,SAAS,CAAC,UAAkB,SAAS,KAAK,QAAQ,SAAS,CAAC,aAAa,KAAK;AACpF,MAAI,UAAU;AACd,aAAW,aAAa,CAAC,SAAS,UAAU,IAAI,GAAG;AACjD,QAAI,OAAO,SAAS,GAAG;AACrB,gBAAU;AACV;AAAA,IACF;AAAA,EACF;AACA,MAAI,UAAU,EAAG,WAAU,aAAa,QAAQ,IAAI,OAAO,YAAY,WAAW,KAAK;AAEvF,QAAM,YAAY,YAAY,CAAC,UAAkB;AAC/C,UAAM,QAAQ,KAAK,GAAG,MAAM;AAAA,EAC9B,GAAG,CAAC,CAAC;AAEL,QAAM,eAAe,CAAC,WAAmB;AAAA,IACvC,KAAK,CAAC,SAA6B;AACjC,YAAM,QAAQ,KAAK,IAAI;AAAA,IACzB;AAAA,IACA,UAAU,UAAU,UAAU,IAAI;AAAA,IAClC,SAAS,MAAM;AACb,iBAAW,KAAK;AAChB,cAAQ,KAAK;AAAA,IACf;AAAA,IACA,QAAQ,CAAC,UAA2B;AAElC,UAAI,MAAM,QAAQ,SAAS,MAAM,aAAmC,EAAG;AACvE,iBAAW,EAAE;AAAA,IACf;AAAA,IACA,WAAW,CAAC,UAA8B;AACxC,UAAI,MAAM,UAAU,MAAM,WAAW,MAAM,QAAS;AACpD,YAAM,OAAO,aAAa,MAAM,KAAK,OAAO,OAAO,YAAY,WAAW;AAC1E,UAAI,SAAS,MAAM;AAEjB,YAAI,MAAM,QAAQ,UAAU,MAAM,QAAQ,MAAO,OAAM,eAAe;AACtE;AAAA,MACF;AACA,YAAM,eAAe;AACrB,gBAAU,IAAI;AACd,mBAAa,IAAI;AAAA,IACnB;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,SAAS,UAAU;AAC5C;","names":[]}