@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.
- package/README.md +13 -10
- package/contracts/application-atomic/application-date-range-filter.ts +43 -0
- package/contracts/application-atomic/list-table-pagination.ts +20 -7
- package/contracts/application-atomic/search-field.ts +1 -1
- package/contracts/application-atomic/system-button.ts +33 -11
- package/contracts/application-module/collaboration/contacts-collaboration-workspace.ts +39 -1
- package/contracts/application-module/collaboration/files-collaboration-workspace.ts +27 -1
- package/contracts/application-module/collaboration/schedule-collaboration-workspace.ts +42 -0
- package/contracts/application-module/content/application-data-display.ts +23 -1
- package/contracts/application-module/content/application-filter-list.ts +2 -2
- package/contracts/application-module/content/application-page-header.ts +55 -6
- package/contracts/application-module/content/application-page-layout-container.ts +14 -0
- package/contracts/application-module/content/application-query-toolbar.ts +70 -15
- package/contracts/application-module/content/application-record-detail-body.ts +13 -3
- package/contracts/application-module/content/application-split-list-sidebar.ts +16 -4
- package/contracts/application-module/lists/application-record-list.ts +10 -5
- package/contracts/application-module/navigation/application-module-switcher.ts +16 -11
- package/contracts/application-module/navigation/application-primary-navigation.ts +83 -20
- package/contracts/application-module/navigation/application-secondary-navigation.ts +57 -6
- package/contracts/application-module/navigation/global-sidebar.ts +1 -1
- package/contracts/application-module/navigation/top-navigation-primary-bar.ts +52 -12
- package/contracts/application-module/overlays/application-detail-drawer.ts +22 -5
- package/contracts/application-module/overlays/application-form-dialog.ts +32 -7
- package/contracts/application-module/overlays/application-global-action-panel.ts +27 -6
- package/contracts/application-module/statistics/metrics.ts +37 -4
- package/contracts/foundation/actions/button.ts +10 -6
- package/contracts/foundation/actions/toggle.ts +3 -3
- package/contracts/foundation/data-content-layout/avatar.ts +5 -2
- package/contracts/foundation/data-content-layout/badge.ts +6 -4
- package/contracts/foundation/data-content-layout/card.ts +6 -2
- package/contracts/foundation/data-content-layout/chart.ts +19 -7
- package/contracts/foundation/data-content-layout/message-scroller.ts +5 -5
- package/contracts/foundation/data-content-layout/progress.ts +5 -1
- package/contracts/foundation/data-content-layout/resizable.ts +19 -10
- package/contracts/foundation/data-content-layout/scroll-area.ts +2 -1
- package/contracts/foundation/data-content-layout/separator.ts +1 -1
- package/contracts/foundation/data-content-layout/table.ts +26 -2
- package/contracts/foundation/feedback-overlay/alert-dialog.ts +8 -3
- package/contracts/foundation/feedback-overlay/collapsible.ts +5 -4
- package/contracts/foundation/feedback-overlay/dialog.ts +22 -3
- package/contracts/foundation/feedback-overlay/drawer.ts +2 -2
- package/contracts/foundation/feedback-overlay/dropdown-menu.ts +5 -1
- package/contracts/foundation/feedback-overlay/hover-card.ts +1 -0
- package/contracts/foundation/feedback-overlay/popover.ts +19 -4
- package/contracts/foundation/feedback-overlay/sheet.ts +4 -2
- package/contracts/foundation/feedback-overlay/sonner-provider.ts +35 -0
- package/contracts/foundation/feedback-overlay/sonner.ts +4 -1
- package/contracts/foundation/icon/icon-name.ts +51 -0
- package/contracts/foundation/icon/icon.ts +20 -4
- package/contracts/foundation/input-selection/calendar.ts +14 -1
- package/contracts/foundation/input-selection/checkbox.ts +6 -0
- package/contracts/foundation/input-selection/combobox.ts +8 -2
- package/contracts/foundation/input-selection/date-input.ts +39 -0
- package/contracts/foundation/input-selection/field.ts +15 -1
- package/contracts/foundation/input-selection/input-group.ts +10 -0
- package/contracts/foundation/input-selection/input-otp.ts +6 -0
- package/contracts/foundation/input-selection/input.ts +2 -2
- package/contracts/foundation/input-selection/radio-group.ts +7 -0
- package/contracts/foundation/input-selection/select.ts +4 -1
- package/contracts/foundation/input-selection/switch.ts +9 -0
- package/contracts/foundation/navigation-command/command.ts +22 -3
- package/contracts/foundation/navigation-command/context-menu.ts +6 -1
- package/contracts/foundation/navigation-command/menubar.ts +6 -1
- package/contracts/foundation/navigation-command/navigation-menu.ts +12 -3
- package/contracts/foundation/navigation-command/pagination.ts +8 -4
- package/contracts/foundation/navigation-command/sidebar.ts +2 -1
- package/contracts/foundation/navigation-command/tabs.ts +12 -1
- package/dist/components/application-atomic/ApplicationDateRangeFilter.js +112 -0
- package/dist/components/application-atomic/ApplicationDateRangeFilter.js.map +1 -0
- package/dist/components/application-atomic/ListTablePagination.js +45 -26
- package/dist/components/application-atomic/ListTablePagination.js.map +1 -1
- package/dist/components/application-atomic/SidebarRailButton.js +12 -2
- package/dist/components/application-atomic/SidebarRailButton.js.map +1 -1
- package/dist/components/application-atomic/SystemButton.js +19 -6
- package/dist/components/application-atomic/SystemButton.js.map +1 -1
- package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js +27 -15
- package/dist/components/application-module/collaboration/ContactsCollaborationWorkspace.js.map +1 -1
- package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js +10 -4
- package/dist/components/application-module/collaboration/FilesCollaborationWorkspace.js.map +1 -1
- package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js +143 -69
- package/dist/components/application-module/collaboration/ScheduleCollaborationWorkspace.js.map +1 -1
- package/dist/components/application-module/content/ApplicationDataDisplay.js +4 -1
- package/dist/components/application-module/content/ApplicationDataDisplay.js.map +1 -1
- package/dist/components/application-module/content/ApplicationPageHeader.js +38 -12
- package/dist/components/application-module/content/ApplicationPageHeader.js.map +1 -1
- package/dist/components/application-module/content/ApplicationPageLayoutContainer.js +6 -2
- package/dist/components/application-module/content/ApplicationPageLayoutContainer.js.map +1 -1
- package/dist/components/application-module/content/ApplicationQueryToolbar.js +30 -14
- package/dist/components/application-module/content/ApplicationQueryToolbar.js.map +1 -1
- package/dist/components/application-module/content/ApplicationRecordDetailBody.js +20 -13
- package/dist/components/application-module/content/ApplicationRecordDetailBody.js.map +1 -1
- package/dist/components/application-module/content/ApplicationSplitListSidebar.js +52 -21
- package/dist/components/application-module/content/ApplicationSplitListSidebar.js.map +1 -1
- package/dist/components/application-module/lists/ApplicationRecordList.js +53 -5
- package/dist/components/application-module/lists/ApplicationRecordList.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js +95 -28
- package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js +41 -26
- package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js +37 -2
- package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js.map +1 -1
- package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js +15 -8
- package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationDetailDrawer.js +14 -11
- package/dist/components/application-module/overlays/ApplicationDetailDrawer.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationFormDialog.js +44 -17
- package/dist/components/application-module/overlays/ApplicationFormDialog.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js +60 -1
- package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js.map +1 -1
- package/dist/components/application-module/overlays/PeoplePickerDialog.js +70 -25
- package/dist/components/application-module/overlays/PeoplePickerDialog.js.map +1 -1
- package/dist/components/application-module/statistics/ApplicationMetricChart.js +5 -2
- package/dist/components/application-module/statistics/ApplicationMetricChart.js.map +1 -1
- package/dist/components/application-module/statistics/ApplicationMetricStrip.js +19 -4
- package/dist/components/application-module/statistics/ApplicationMetricStrip.js.map +1 -1
- package/dist/components/foundation/actions/ToggleGroup.js +14 -1
- package/dist/components/foundation/actions/ToggleGroup.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Avatar.js +1 -12
- package/dist/components/foundation/data-content-layout/Avatar.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Card.js +25 -1
- package/dist/components/foundation/data-content-layout/Card.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Carousel.js +39 -2
- package/dist/components/foundation/data-content-layout/Carousel.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Chart.js +13 -8
- package/dist/components/foundation/data-content-layout/Chart.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Item.js +16 -1
- package/dist/components/foundation/data-content-layout/Item.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Message.js +17 -0
- package/dist/components/foundation/data-content-layout/Message.js.map +1 -1
- package/dist/components/foundation/data-content-layout/MessageScroller.js +1 -0
- package/dist/components/foundation/data-content-layout/MessageScroller.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Progress.js +8 -1
- package/dist/components/foundation/data-content-layout/Progress.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Resizable.js +62 -15
- package/dist/components/foundation/data-content-layout/Resizable.js.map +1 -1
- package/dist/components/foundation/data-content-layout/ScrollArea.js +25 -0
- package/dist/components/foundation/data-content-layout/ScrollArea.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Table.js +112 -71
- package/dist/components/foundation/data-content-layout/Table.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/AlertDialog.js +18 -7
- package/dist/components/foundation/feedback-overlay/AlertDialog.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Dialog.js +25 -6
- package/dist/components/foundation/feedback-overlay/Dialog.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Drawer.js +4 -3
- package/dist/components/foundation/feedback-overlay/Drawer.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/DropdownMenu.js +40 -6
- package/dist/components/foundation/feedback-overlay/DropdownMenu.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/HoverCard.js +8 -0
- package/dist/components/foundation/feedback-overlay/HoverCard.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Popover.js +80 -28
- package/dist/components/foundation/feedback-overlay/Popover.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Sheet.js +4 -3
- package/dist/components/foundation/feedback-overlay/Sheet.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Sonner.js +1 -1
- package/dist/components/foundation/feedback-overlay/Sonner.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/SonnerProvider.js +37 -0
- package/dist/components/foundation/feedback-overlay/SonnerProvider.js.map +1 -0
- package/dist/components/foundation/feedback-overlay/Tooltip.js +2 -0
- package/dist/components/foundation/feedback-overlay/Tooltip.js.map +1 -1
- package/dist/components/foundation/input-selection/Calendar.js +120 -23
- package/dist/components/foundation/input-selection/Calendar.js.map +1 -1
- package/dist/components/foundation/input-selection/Checkbox.js +3 -0
- package/dist/components/foundation/input-selection/Checkbox.js.map +1 -1
- package/dist/components/foundation/input-selection/Combobox.js +58 -6
- package/dist/components/foundation/input-selection/Combobox.js.map +1 -1
- package/dist/components/foundation/input-selection/DateInput.js +70 -0
- package/dist/components/foundation/input-selection/DateInput.js.map +1 -0
- package/dist/components/foundation/input-selection/Field.js +7 -2
- package/dist/components/foundation/input-selection/Field.js.map +1 -1
- package/dist/components/foundation/input-selection/Input.js +5 -1
- package/dist/components/foundation/input-selection/Input.js.map +1 -1
- package/dist/components/foundation/input-selection/InputGroup.js +2 -0
- package/dist/components/foundation/input-selection/InputGroup.js.map +1 -1
- package/dist/components/foundation/input-selection/InputOTP.js +3 -1
- package/dist/components/foundation/input-selection/InputOTP.js.map +1 -1
- package/dist/components/foundation/input-selection/NativeSelect.js.map +1 -1
- package/dist/components/foundation/input-selection/RadioGroup.js +3 -0
- package/dist/components/foundation/input-selection/RadioGroup.js.map +1 -1
- package/dist/components/foundation/input-selection/Select.js +30 -4
- package/dist/components/foundation/input-selection/Select.js.map +1 -1
- package/dist/components/foundation/input-selection/Switch.js +9 -3
- package/dist/components/foundation/input-selection/Switch.js.map +1 -1
- package/dist/components/foundation/input-selection/Textarea.js.map +1 -1
- package/dist/components/foundation/navigation-command/Accordion.js +21 -3
- package/dist/components/foundation/navigation-command/Accordion.js.map +1 -1
- package/dist/components/foundation/navigation-command/Breadcrumb.js +3 -4
- package/dist/components/foundation/navigation-command/Breadcrumb.js.map +1 -1
- package/dist/components/foundation/navigation-command/Command.js +85 -33
- package/dist/components/foundation/navigation-command/Command.js.map +1 -1
- package/dist/components/foundation/navigation-command/ContextMenu.js +73 -14
- package/dist/components/foundation/navigation-command/ContextMenu.js.map +1 -1
- package/dist/components/foundation/navigation-command/Menubar.js +114 -25
- package/dist/components/foundation/navigation-command/Menubar.js.map +1 -1
- package/dist/components/foundation/navigation-command/NavigationMenu.js +68 -9
- package/dist/components/foundation/navigation-command/NavigationMenu.js.map +1 -1
- package/dist/components/foundation/navigation-command/Pagination.js +11 -5
- package/dist/components/foundation/navigation-command/Pagination.js.map +1 -1
- package/dist/components/foundation/navigation-command/Sidebar.js +43 -24
- package/dist/components/foundation/navigation-command/Sidebar.js.map +1 -1
- package/dist/components/foundation/navigation-command/Tabs.js +57 -35
- package/dist/components/foundation/navigation-command/Tabs.js.map +1 -1
- package/dist/icon/Icon.js +2 -1
- package/dist/icon/Icon.js.map +1 -1
- package/dist/icon/glyphs.js +11 -1
- package/dist/icon/glyphs.js.map +1 -1
- package/dist/index.js +8 -1
- package/dist/index.js.map +1 -1
- package/dist/internal/CloseButton.js +7 -1
- package/dist/internal/CloseButton.js.map +1 -1
- package/dist/internal/FieldAssociation.js +39 -0
- package/dist/internal/FieldAssociation.js.map +1 -0
- package/dist/internal/Overlay.js +42 -8
- package/dist/internal/Overlay.js.map +1 -1
- package/dist/internal/date.js +8 -0
- package/dist/internal/date.js.map +1 -1
- package/dist/internal/escape-stack.js +17 -0
- package/dist/internal/escape-stack.js.map +1 -0
- package/dist/internal/focus.js +5 -1
- package/dist/internal/focus.js.map +1 -1
- package/dist/internal/initials.js +18 -0
- package/dist/internal/initials.js.map +1 -0
- package/dist/internal/row-activation.js +43 -0
- package/dist/internal/row-activation.js.map +1 -0
- package/dist/internal/state-slot.js +22 -0
- package/dist/internal/state-slot.js.map +1 -0
- package/dist/internal/use-dismiss.js +50 -6
- package/dist/internal/use-dismiss.js.map +1 -1
- package/dist/internal/use-list-navigation.js +10 -4
- package/dist/internal/use-list-navigation.js.map +1 -1
- package/dist/internal/use-modal.js +18 -3
- package/dist/internal/use-modal.js.map +1 -1
- package/dist/internal/use-roving-focus.js +94 -0
- package/dist/internal/use-roving-focus.js.map +1 -0
- package/dist/styles.css +5606 -4391
- package/dist/tokens.css +165 -70
- package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts +36 -0
- package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts.map +1 -0
- package/dist-types/contracts/application-atomic/list-table-pagination.d.ts +15 -4
- package/dist-types/contracts/application-atomic/list-table-pagination.d.ts.map +1 -1
- package/dist-types/contracts/application-atomic/search-field.d.ts +1 -1
- package/dist-types/contracts/application-atomic/system-button.d.ts +28 -9
- package/dist-types/contracts/application-atomic/system-button.d.ts.map +1 -1
- package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts +31 -1
- package/dist-types/contracts/application-module/collaboration/contacts-collaboration-workspace.d.ts.map +1 -1
- package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts +22 -1
- package/dist-types/contracts/application-module/collaboration/files-collaboration-workspace.d.ts.map +1 -1
- package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts +34 -0
- package/dist-types/contracts/application-module/collaboration/schedule-collaboration-workspace.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-data-display.d.ts +21 -1
- package/dist-types/contracts/application-module/content/application-data-display.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-filter-list.d.ts +2 -2
- package/dist-types/contracts/application-module/content/application-page-header.d.ts +51 -6
- package/dist-types/contracts/application-module/content/application-page-header.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts +13 -0
- package/dist-types/contracts/application-module/content/application-page-layout-container.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts +68 -16
- package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts +12 -3
- package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts +9 -3
- package/dist-types/contracts/application-module/content/application-split-list-sidebar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/lists/application-record-list.d.ts +10 -5
- package/dist-types/contracts/application-module/lists/application-record-list.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts +13 -10
- package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts +62 -17
- package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts +43 -6
- package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts +1 -1
- package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts +45 -12
- package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts +14 -4
- package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts +30 -7
- package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts +23 -6
- package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts.map +1 -1
- package/dist-types/contracts/application-module/statistics/metrics.d.ts +32 -3
- package/dist-types/contracts/application-module/statistics/metrics.d.ts.map +1 -1
- package/dist-types/contracts/foundation/actions/button.d.ts +10 -6
- package/dist-types/contracts/foundation/actions/button.d.ts.map +1 -1
- package/dist-types/contracts/foundation/actions/toggle.d.ts +3 -3
- package/dist-types/contracts/foundation/actions/toggle.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts +4 -2
- package/dist-types/contracts/foundation/data-content-layout/avatar.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/badge.d.ts +6 -4
- package/dist-types/contracts/foundation/data-content-layout/badge.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/card.d.ts +6 -2
- package/dist-types/contracts/foundation/data-content-layout/card.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/chart.d.ts +17 -7
- package/dist-types/contracts/foundation/data-content-layout/chart.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/message-scroller.d.ts +4 -4
- package/dist-types/contracts/foundation/data-content-layout/progress.d.ts +5 -1
- package/dist-types/contracts/foundation/data-content-layout/progress.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts +19 -10
- package/dist-types/contracts/foundation/data-content-layout/resizable.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts +2 -1
- package/dist-types/contracts/foundation/data-content-layout/scroll-area.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/separator.d.ts +1 -1
- package/dist-types/contracts/foundation/data-content-layout/separator.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/table.d.ts +24 -2
- package/dist-types/contracts/foundation/data-content-layout/table.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts +8 -3
- package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts +5 -4
- package/dist-types/contracts/foundation/feedback-overlay/collapsible.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts +20 -3
- package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/drawer.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts +4 -0
- package/dist-types/contracts/foundation/feedback-overlay/dropdown-menu.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts +15 -2
- package/dist-types/contracts/foundation/feedback-overlay/popover.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts +4 -2
- package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts +31 -0
- package/dist-types/contracts/foundation/feedback-overlay/sonner-provider.d.ts.map +1 -0
- package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts +4 -1
- package/dist-types/contracts/foundation/feedback-overlay/sonner.d.ts.map +1 -1
- package/dist-types/contracts/foundation/icon/icon-name.d.ts +8 -0
- package/dist-types/contracts/foundation/icon/icon-name.d.ts.map +1 -0
- package/dist-types/contracts/foundation/icon/icon.d.ts +15 -2
- package/dist-types/contracts/foundation/icon/icon.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/calendar.d.ts +13 -1
- package/dist-types/contracts/foundation/input-selection/calendar.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/checkbox.d.ts +5 -0
- package/dist-types/contracts/foundation/input-selection/checkbox.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/combobox.d.ts +6 -1
- package/dist-types/contracts/foundation/input-selection/combobox.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/date-input.d.ts +32 -0
- package/dist-types/contracts/foundation/input-selection/date-input.d.ts.map +1 -0
- package/dist-types/contracts/foundation/input-selection/field.d.ts +14 -1
- package/dist-types/contracts/foundation/input-selection/field.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/input-group.d.ts +9 -0
- package/dist-types/contracts/foundation/input-selection/input-group.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/input-otp.d.ts +5 -0
- package/dist-types/contracts/foundation/input-selection/input-otp.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/input.d.ts +2 -2
- package/dist-types/contracts/foundation/input-selection/radio-group.d.ts +6 -0
- package/dist-types/contracts/foundation/input-selection/radio-group.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/select.d.ts +4 -1
- package/dist-types/contracts/foundation/input-selection/select.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/switch.d.ts +8 -0
- package/dist-types/contracts/foundation/input-selection/switch.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/command.d.ts +19 -3
- package/dist-types/contracts/foundation/navigation-command/command.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts +5 -0
- package/dist-types/contracts/foundation/navigation-command/context-menu.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/menubar.d.ts +5 -0
- package/dist-types/contracts/foundation/navigation-command/menubar.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts +9 -0
- package/dist-types/contracts/foundation/navigation-command/navigation-menu.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/pagination.d.ts +8 -4
- package/dist-types/contracts/foundation/navigation-command/pagination.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts +2 -1
- package/dist-types/contracts/foundation/navigation-command/sidebar.d.ts.map +1 -1
- package/dist-types/contracts/foundation/navigation-command/tabs.d.ts +12 -1
- package/dist-types/contracts/foundation/navigation-command/tabs.d.ts.map +1 -1
- package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts +13 -0
- package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts.map +1 -0
- package/dist-types/src/components/application-atomic/ListTablePagination.d.ts +12 -10
- package/dist-types/src/components/application-atomic/ListTablePagination.d.ts.map +1 -1
- package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts +5 -0
- package/dist-types/src/components/application-atomic/SidebarRailButton.d.ts.map +1 -1
- package/dist-types/src/components/application-atomic/SystemButton.d.ts +16 -1
- package/dist-types/src/components/application-atomic/SystemButton.d.ts.map +1 -1
- package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts +11 -1
- package/dist-types/src/components/application-module/collaboration/ContactsCollaborationWorkspace.d.ts.map +1 -1
- package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts +5 -1
- package/dist-types/src/components/application-module/collaboration/FilesCollaborationWorkspace.d.ts.map +1 -1
- package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts +10 -1
- package/dist-types/src/components/application-module/collaboration/ScheduleCollaborationWorkspace.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts +4 -1
- package/dist-types/src/components/application-module/content/ApplicationDataDisplay.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts +12 -4
- package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts +10 -1
- package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts +9 -3
- package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts +1 -10
- package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts +14 -1
- package/dist-types/src/components/application-module/content/ApplicationSplitListSidebar.d.ts.map +1 -1
- package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts +22 -2
- package/dist-types/src/components/application-module/lists/ApplicationRecordList.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts +19 -3
- package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts +14 -10
- package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts +13 -3
- package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts +19 -5
- package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts +13 -4
- package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts +9 -2
- package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts +26 -3
- package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/PeoplePickerDialog.d.ts.map +1 -1
- package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts +3 -0
- package/dist-types/src/components/application-module/statistics/ApplicationMetricChart.d.ts.map +1 -1
- package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts +9 -3
- package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts.map +1 -1
- package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts +4 -0
- package/dist-types/src/components/foundation/actions/ToggleGroup.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts +7 -0
- package/dist-types/src/components/foundation/data-content-layout/Avatar.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Card.d.ts +9 -0
- package/dist-types/src/components/foundation/data-content-layout/Card.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts +11 -2
- package/dist-types/src/components/foundation/data-content-layout/Carousel.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts +15 -2
- package/dist-types/src/components/foundation/data-content-layout/Chart.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Item.d.ts +5 -0
- package/dist-types/src/components/foundation/data-content-layout/Item.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Message.d.ts +6 -1
- package/dist-types/src/components/foundation/data-content-layout/Message.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts +7 -1
- package/dist-types/src/components/foundation/data-content-layout/MessageScroller.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts +7 -1
- package/dist-types/src/components/foundation/data-content-layout/Progress.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts +10 -0
- package/dist-types/src/components/foundation/data-content-layout/Resizable.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts +9 -2
- package/dist-types/src/components/foundation/data-content-layout/ScrollArea.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Table.d.ts +18 -5
- package/dist-types/src/components/foundation/data-content-layout/Table.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts +12 -0
- package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts +10 -1
- package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Drawer.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts +6 -1
- package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts +5 -0
- package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts +23 -1
- package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts +2 -1
- package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts +3 -0
- package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts +21 -0
- package/dist-types/src/components/foundation/feedback-overlay/SonnerProvider.d.ts.map +1 -0
- package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts +4 -0
- package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Calendar.d.ts +17 -1
- package/dist-types/src/components/foundation/input-selection/Calendar.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts +5 -1
- package/dist-types/src/components/foundation/input-selection/Checkbox.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Combobox.d.ts +18 -2
- package/dist-types/src/components/foundation/input-selection/Combobox.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/DateInput.d.ts +13 -0
- package/dist-types/src/components/foundation/input-selection/DateInput.d.ts.map +1 -0
- package/dist-types/src/components/foundation/input-selection/Field.d.ts +7 -1
- package/dist-types/src/components/foundation/input-selection/Field.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Input.d.ts +9 -1
- package/dist-types/src/components/foundation/input-selection/Input.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts +6 -1
- package/dist-types/src/components/foundation/input-selection/InputGroup.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts +4 -1
- package/dist-types/src/components/foundation/input-selection/InputOTP.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts +6 -1
- package/dist-types/src/components/foundation/input-selection/NativeSelect.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts +4 -1
- package/dist-types/src/components/foundation/input-selection/RadioGroup.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Select.d.ts +8 -1
- package/dist-types/src/components/foundation/input-selection/Select.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Switch.d.ts +7 -1
- package/dist-types/src/components/foundation/input-selection/Switch.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/Textarea.d.ts +6 -1
- package/dist-types/src/components/foundation/input-selection/Textarea.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts +5 -0
- package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts +3 -0
- package/dist-types/src/components/foundation/navigation-command/Breadcrumb.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Command.d.ts +15 -2
- package/dist-types/src/components/foundation/navigation-command/Command.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts +15 -5
- package/dist-types/src/components/foundation/navigation-command/ContextMenu.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts +12 -1
- package/dist-types/src/components/foundation/navigation-command/Menubar.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts +19 -2
- package/dist-types/src/components/foundation/navigation-command/NavigationMenu.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts +9 -1
- package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts +5 -0
- package/dist-types/src/components/foundation/navigation-command/Sidebar.d.ts.map +1 -1
- package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts +14 -3
- package/dist-types/src/components/foundation/navigation-command/Tabs.d.ts.map +1 -1
- package/dist-types/src/icon/Icon.d.ts +2 -2
- package/dist-types/src/icon/Icon.d.ts.map +1 -1
- package/dist-types/src/icon/glyphs.d.ts +7 -3
- package/dist-types/src/icon/glyphs.d.ts.map +1 -1
- package/dist-types/src/index.d.ts +11 -5
- package/dist-types/src/index.d.ts.map +1 -1
- package/dist-types/src/internal/CloseButton.d.ts +11 -1
- package/dist-types/src/internal/CloseButton.d.ts.map +1 -1
- package/dist-types/src/internal/FieldAssociation.d.ts +33 -0
- package/dist-types/src/internal/FieldAssociation.d.ts.map +1 -0
- package/dist-types/src/internal/Overlay.d.ts +20 -2
- package/dist-types/src/internal/Overlay.d.ts.map +1 -1
- package/dist-types/src/internal/date.d.ts +2 -0
- package/dist-types/src/internal/date.d.ts.map +1 -1
- package/dist-types/src/internal/escape-stack.d.ts +4 -0
- package/dist-types/src/internal/escape-stack.d.ts.map +1 -0
- package/dist-types/src/internal/focus.d.ts +10 -1
- package/dist-types/src/internal/focus.d.ts.map +1 -1
- package/dist-types/src/internal/initials.d.ts +17 -0
- package/dist-types/src/internal/initials.d.ts.map +1 -0
- package/dist-types/src/internal/row-activation.d.ts +13 -0
- package/dist-types/src/internal/row-activation.d.ts.map +1 -0
- package/dist-types/src/internal/state-slot.d.ts +19 -0
- package/dist-types/src/internal/state-slot.d.ts.map +1 -0
- package/dist-types/src/internal/use-dismiss.d.ts +36 -3
- package/dist-types/src/internal/use-dismiss.d.ts.map +1 -1
- package/dist-types/src/internal/use-list-navigation.d.ts +7 -1
- package/dist-types/src/internal/use-list-navigation.d.ts.map +1 -1
- package/dist-types/src/internal/use-modal.d.ts.map +1 -1
- package/dist-types/src/internal/use-roving-focus.d.ts +49 -0
- package/dist-types/src/internal/use-roving-focus.d.ts.map +1 -0
- package/mappings.json +4 -4
- package/package.json +3 -3
- 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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,
|
|
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 +
|
|
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 '
|
|
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"
|
|
42
|
+
if (event.key === "Escape") {
|
|
43
|
+
if (!isTopEscapeLayer(container) || disableEscapeRef.current) return;
|
|
33
44
|
event.stopPropagation();
|
|
34
|
-
|
|
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
|
|
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'
|
|
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":[]}
|