@moheng-design/ui 3.0.0 → 3.1.1

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 (121) hide show
  1. package/contracts/application-atomic/application-date-range-filter.ts +4 -3
  2. package/contracts/application-atomic/application-filter-menu.ts +9 -5
  3. package/contracts/application-atomic/system-button.ts +9 -3
  4. package/contracts/application-module/content/application-page-header.ts +6 -2
  5. package/contracts/application-module/content/application-query-toolbar.ts +8 -1
  6. package/contracts/application-module/content/application-record-detail-body.ts +18 -7
  7. package/contracts/application-module/navigation/global-sidebar.ts +2 -1
  8. package/contracts/application-module/overlays/application-detail-drawer.ts +1 -1
  9. package/contracts/application-module/overlays/application-form-dialog.ts +9 -2
  10. package/contracts/foundation/actions/button.ts +13 -5
  11. package/contracts/foundation/data-content-layout/table.ts +8 -4
  12. package/contracts/foundation/feedback-overlay/sonner.ts +1 -1
  13. package/contracts/foundation/icon/icon-name.ts +4 -1
  14. package/contracts/foundation/input-selection/date-input.ts +1 -1
  15. package/contracts/foundation/input-selection/label.ts +1 -1
  16. package/dist/components/application-atomic/ApplicationDateRangeFilter.js +2 -6
  17. package/dist/components/application-atomic/ApplicationDateRangeFilter.js.map +1 -1
  18. package/dist/components/application-atomic/ApplicationFilterMenu.js +50 -9
  19. package/dist/components/application-atomic/ApplicationFilterMenu.js.map +1 -1
  20. package/dist/components/application-atomic/ListTablePagination.js.map +1 -1
  21. package/dist/components/application-atomic/SystemButton.js +1 -0
  22. package/dist/components/application-atomic/SystemButton.js.map +1 -1
  23. package/dist/components/application-module/content/ApplicationQueryToolbar.js +5 -1
  24. package/dist/components/application-module/content/ApplicationQueryToolbar.js.map +1 -1
  25. package/dist/components/application-module/content/ApplicationRecordDetailBody.js +4 -6
  26. package/dist/components/application-module/content/ApplicationRecordDetailBody.js.map +1 -1
  27. package/dist/components/application-module/overlays/ApplicationFormDialog.js +5 -1
  28. package/dist/components/application-module/overlays/ApplicationFormDialog.js.map +1 -1
  29. package/dist/components/foundation/data-content-layout/Table.js +116 -96
  30. package/dist/components/foundation/data-content-layout/Table.js.map +1 -1
  31. package/dist/components/foundation/feedback-overlay/Collapsible.js +5 -2
  32. package/dist/components/foundation/feedback-overlay/Collapsible.js.map +1 -1
  33. package/dist/components/foundation/feedback-overlay/DropdownMenu.js +2 -1
  34. package/dist/components/foundation/feedback-overlay/DropdownMenu.js.map +1 -1
  35. package/dist/components/foundation/feedback-overlay/HoverCard.js +5 -20
  36. package/dist/components/foundation/feedback-overlay/HoverCard.js.map +1 -1
  37. package/dist/components/foundation/feedback-overlay/Popover.js +2 -1
  38. package/dist/components/foundation/feedback-overlay/Popover.js.map +1 -1
  39. package/dist/components/foundation/feedback-overlay/Sonner.js +20 -4
  40. package/dist/components/foundation/feedback-overlay/Sonner.js.map +1 -1
  41. package/dist/components/foundation/feedback-overlay/Tooltip.js +5 -17
  42. package/dist/components/foundation/feedback-overlay/Tooltip.js.map +1 -1
  43. package/dist/components/foundation/input-selection/Combobox.js +2 -1
  44. package/dist/components/foundation/input-selection/Combobox.js.map +1 -1
  45. package/dist/components/foundation/input-selection/Select.js +5 -3
  46. package/dist/components/foundation/input-selection/Select.js.map +1 -1
  47. package/dist/components/foundation/navigation-command/Accordion.js +14 -1
  48. package/dist/components/foundation/navigation-command/Accordion.js.map +1 -1
  49. package/dist/components/foundation/navigation-command/Pagination.js +3 -1
  50. package/dist/components/foundation/navigation-command/Pagination.js.map +1 -1
  51. package/dist/icon/glyphs.js +3 -0
  52. package/dist/icon/glyphs.js.map +1 -1
  53. package/dist/internal/DisclosureBody.js +25 -0
  54. package/dist/internal/DisclosureBody.js.map +1 -0
  55. package/dist/internal/Overlay.js +17 -4
  56. package/dist/internal/Overlay.js.map +1 -1
  57. package/dist/internal/use-modal.js +10 -1
  58. package/dist/internal/use-modal.js.map +1 -1
  59. package/dist/internal/use-presence.js +27 -0
  60. package/dist/internal/use-presence.js.map +1 -0
  61. package/dist/internal/use-preview.js +50 -0
  62. package/dist/internal/use-preview.js.map +1 -0
  63. package/dist/styles.css +345 -133
  64. package/dist/tokens.css +38 -1
  65. package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts +4 -3
  66. package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts.map +1 -1
  67. package/dist-types/contracts/application-atomic/application-filter-menu.d.ts +8 -4
  68. package/dist-types/contracts/application-atomic/application-filter-menu.d.ts.map +1 -1
  69. package/dist-types/contracts/application-atomic/system-button.d.ts +9 -3
  70. package/dist-types/contracts/application-atomic/system-button.d.ts.map +1 -1
  71. package/dist-types/contracts/application-module/content/application-page-header.d.ts +6 -2
  72. package/dist-types/contracts/application-module/content/application-page-header.d.ts.map +1 -1
  73. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts +7 -1
  74. package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts.map +1 -1
  75. package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts +18 -7
  76. package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts.map +1 -1
  77. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts +2 -1
  78. package/dist-types/contracts/application-module/navigation/global-sidebar.d.ts.map +1 -1
  79. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts +1 -1
  80. package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts.map +1 -1
  81. package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts +8 -2
  82. package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts.map +1 -1
  83. package/dist-types/contracts/foundation/actions/button.d.ts +13 -5
  84. package/dist-types/contracts/foundation/actions/button.d.ts.map +1 -1
  85. package/dist-types/contracts/foundation/data-content-layout/table.d.ts +8 -4
  86. package/dist-types/contracts/foundation/data-content-layout/table.d.ts.map +1 -1
  87. package/dist-types/contracts/foundation/icon/icon-name.d.ts +2 -2
  88. package/dist-types/contracts/foundation/icon/icon-name.d.ts.map +1 -1
  89. package/dist-types/contracts/foundation/input-selection/date-input.d.ts +1 -1
  90. package/dist-types/contracts/foundation/input-selection/label.d.ts +1 -1
  91. package/dist-types/src/components/application-atomic/ApplicationFilterMenu.d.ts.map +1 -1
  92. package/dist-types/src/components/application-atomic/ListTablePagination.d.ts.map +1 -1
  93. package/dist-types/src/components/application-atomic/SystemButton.d.ts.map +1 -1
  94. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts +1 -1
  95. package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts.map +1 -1
  96. package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts.map +1 -1
  97. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts +1 -1
  98. package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts.map +1 -1
  99. package/dist-types/src/components/foundation/data-content-layout/Table.d.ts.map +1 -1
  100. package/dist-types/src/components/foundation/feedback-overlay/Collapsible.d.ts.map +1 -1
  101. package/dist-types/src/components/foundation/feedback-overlay/DropdownMenu.d.ts.map +1 -1
  102. package/dist-types/src/components/foundation/feedback-overlay/HoverCard.d.ts.map +1 -1
  103. package/dist-types/src/components/foundation/feedback-overlay/Popover.d.ts.map +1 -1
  104. package/dist-types/src/components/foundation/feedback-overlay/Sonner.d.ts.map +1 -1
  105. package/dist-types/src/components/foundation/feedback-overlay/Tooltip.d.ts.map +1 -1
  106. package/dist-types/src/components/foundation/input-selection/Combobox.d.ts.map +1 -1
  107. package/dist-types/src/components/foundation/input-selection/Select.d.ts.map +1 -1
  108. package/dist-types/src/components/foundation/navigation-command/Accordion.d.ts.map +1 -1
  109. package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts.map +1 -1
  110. package/dist-types/src/icon/glyphs.d.ts.map +1 -1
  111. package/dist-types/src/internal/DisclosureBody.d.ts +7 -0
  112. package/dist-types/src/internal/DisclosureBody.d.ts.map +1 -0
  113. package/dist-types/src/internal/Overlay.d.ts +1 -1
  114. package/dist-types/src/internal/Overlay.d.ts.map +1 -1
  115. package/dist-types/src/internal/use-modal.d.ts.map +1 -1
  116. package/dist-types/src/internal/use-presence.d.ts +8 -0
  117. package/dist-types/src/internal/use-presence.d.ts.map +1 -0
  118. package/dist-types/src/internal/use-preview.d.ts +13 -0
  119. package/dist-types/src/internal/use-preview.d.ts.map +1 -0
  120. package/package.json +4 -1
  121. package/tokens.json +97 -2
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/DropdownMenu.tsx"],"sourcesContent":["'use client'\n\nimport { cloneElement, isValidElement, useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { focusTargetIn, useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n DropdownMenuProps,\n DropdownMenuItem,\n} from '../../../../contracts/foundation/feedback-overlay/dropdown-menu.js'\n\nexport type { DropdownMenuProps, DropdownMenuItem }\n\n/** 可选中的条目 —— 分隔线与分组标题不算。键盘导航只在这些上面走。 */\nfunction isSelectable(item: DropdownMenuItem): boolean {\n return !item.separator && !item.heading && item.value !== undefined\n}\n\n/**\n * 触发器 + 菜单面板,低频动作的收纳处 —— 上下文区或行尾的「更多」按钮。\n *\n * ⚠️ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见,这是 Shell\n * 契约的硬性要求,不是布局偏好。\n *\n * 分组标题走显式的 `heading` 字段(04 · F8)。源实现靠「有 label 但无 value」\n * 这一隐式条件判定,契约里完全没有表达 —— agent 看不出分组能力存在,反而\n * 更可能因为漏传 `value` 而意外得到一个不可点击的条目。\n *\n * 补齐了键盘导航(04 · I12):上下移动跳过禁用项与非选中项,回车确认,\n * Esc 关闭,首字母跳转。键盘打开(Enter / 空格 / ↓)高亮首个可用项,↑ 高亮末项;\n * 鼠标打开不预先高亮。Tab 收起菜单,焦点按正常顺序移走。\n *\n * 焦点归还:Esc 关闭或选中条目后,焦点回到触发器。实测此前落在 body ——\n * 条目若随即打开 AlertDialog,`useModal` 记下的恢复目标就是 body,对话框关闭后\n * 焦点再丢一次。选中时先同步归还焦点、再调 `onSelect`,恢复目标因此是触发器。\n *\n * ── 关于 cloneElement ─────────────────────────────────────────\n * 这里仍用 `cloneElement`,但注入的是 `aria-expanded` / `aria-haspopup`,\n * 不是 style。01 §1.7 否决的是注入样式 —— 那会覆盖调用方的 className 并\n * 依赖「子组件必须转发 style」这条未成文约定。aria 属性两者都不沾:它不改\n * 视觉,且触发器不带这两个属性时,读屏用户根本不知道这里有个菜单。\n */\nexport function DropdownMenu({\n trigger,\n items,\n onSelect,\n align = 'start',\n className,\n ...rest\n}: DropdownMenuProps) {\n const [open, setOpen] = useState(false)\n const anchorRef = useRef<HTMLSpanElement>(null)\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: align === 'end' ? 'bottom-end' : 'bottom-start',\n gap: 4,\n })\n\n /** 可选中条目在原数组中的下标,用于把导航索引映射回 items。 */\n const selectable = useMemo(\n () => items.map((item, index) => ({ item, index })).filter(({ item }) => isSelectable(item)),\n [items]\n )\n\n const close = useCallback(() => setOpen(false), [])\n const triggerTarget = useCallback(() => focusTargetIn(anchorRef.current), [])\n useDismiss({\n open,\n onDismiss: close,\n floating: refs.floating,\n anchor: anchorRef,\n returnFocus: triggerTarget,\n })\n\n const choose = useCallback(\n (navIndex: number) => {\n const entry = selectable[navIndex]\n if (!entry || entry.item.disabled) return\n // 先把焦点还给触发器,再通知调用方 —— 调用方在 onSelect 里打开的对话框\n // 记录的恢复目标因此是触发器,而不是随菜单卸载掉进的 body。\n triggerTarget()?.focus()\n setOpen(false)\n onSelect?.(entry.item.value!)\n },\n [selectable, onSelect, triggerTarget]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: selectable.length,\n isDisabled: (i) => Boolean(selectable[i]?.item.disabled),\n getText: (i) => (typeof selectable[i]?.item.label === 'string' ? (selectable[i]!.item.label as string) : ''),\n onSelect: choose,\n onDismiss: close,\n })\n\n // 面板打开后立刻接管键盘,否则第一次按方向键落在触发器上,不会有反应。\n useEffect(() => {\n if (open) refs.floating.current?.focus()\n }, [open, refs.floating])\n\n /**\n * 打开菜单并决定初始高亮。`active` 状态在组件上常驻,不随面板卸载重置 ——\n * 每次打开都必须显式设定,否则上一次停留的条目会被下一次的回车直接执行。\n */\n const openWith = (highlight: 'none' | 'first' | 'last') => {\n let index = -1\n if (highlight !== 'none') {\n const order = selectable.map((_, i) => i)\n if (highlight === 'last') order.reverse()\n index = order.find((i) => !selectable[i]!.item.disabled) ?? -1\n }\n setActive(index)\n setOpen(true)\n }\n\n const onTriggerKeyDown = (event: ReactKeyboardEvent) => {\n if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return\n event.preventDefault()\n openWith(event.key === 'ArrowDown' ? 'first' : 'last')\n }\n\n const onMenuKeyDown = (event: ReactKeyboardEvent) => {\n // Tab 收起菜单,不拦默认行为 —— 焦点照常移到下一个可聚焦元素。\n if (event.key === 'Tab') {\n close()\n return\n }\n onKeyDown(event)\n }\n\n const baseId = useId()\n let navIndex = -1\n\n return (\n <div className={clsx('mh-dropdown-menu-root', className)} {...rest}>\n <span\n ref={(node) => {\n anchorRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-dropdown-menu-root__trigger\"\n // detail === 0 是键盘(Enter / 空格)合成的点击:打开并高亮首项。\n onClick={(event) => (open ? close() : openWith(event.detail === 0 ? 'first' : 'none'))}\n onKeyDown={open ? undefined : onTriggerKeyDown}\n >\n {isValidElement(trigger)\n ? cloneElement(trigger as React.ReactElement<Record<string, unknown>>, {\n 'aria-expanded': open,\n 'aria-haspopup': 'menu',\n })\n : trigger}\n </span>\n\n {open && (\n <div\n ref={refs.setFloating}\n className=\"mh-menu\"\n role=\"menu\"\n tabIndex={-1}\n aria-activedescendant={active >= 0 ? `${baseId}-${active}` : undefined}\n style={floatingStyles}\n onKeyDown={onMenuKeyDown}\n >\n {items.map((item, i) => {\n if (item.separator) {\n return <div key={`separator-${i}`} className=\"mh-menu__separator\" role=\"separator\" />\n }\n if (item.heading) {\n return (\n <div key={`heading-${i}`} className=\"mh-menu__heading\" role=\"presentation\">\n {item.label}\n </div>\n )\n }\n navIndex += 1\n const current = navIndex\n return (\n <div\n key={item.value}\n id={`${baseId}-${current}`}\n className=\"mh-menu__item\"\n role=\"menuitem\"\n tabIndex={-1}\n aria-disabled={item.disabled || undefined}\n data-active={active === current || undefined}\n data-destructive={item.destructive || undefined}\n data-disabled={item.disabled || undefined}\n onMouseEnter={() => setActive(current)}\n onClick={() => choose(current)}\n >\n {item.icon}\n {item.label}\n </div>\n )\n })}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":["navIndex"]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/DropdownMenu.tsx"],"sourcesContent":["'use client'\n\nimport { cloneElement, isValidElement, useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { focusTargetIn, useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n DropdownMenuProps,\n DropdownMenuItem,\n} from '../../../../contracts/foundation/feedback-overlay/dropdown-menu.js'\n\nexport type { DropdownMenuProps, DropdownMenuItem }\n\n/** 可选中的条目 —— 分隔线与分组标题不算。键盘导航只在这些上面走。 */\nfunction isSelectable(item: DropdownMenuItem): boolean {\n return !item.separator && !item.heading && item.value !== undefined\n}\n\n/**\n * 触发器 + 菜单面板,低频动作的收纳处 —— 上下文区或行尾的「更多」按钮。\n *\n * ⚠️ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见,这是 Shell\n * 契约的硬性要求,不是布局偏好。\n *\n * 分组标题走显式的 `heading` 字段(04 · F8)。源实现靠「有 label 但无 value」\n * 这一隐式条件判定,契约里完全没有表达 —— agent 看不出分组能力存在,反而\n * 更可能因为漏传 `value` 而意外得到一个不可点击的条目。\n *\n * 补齐了键盘导航(04 · I12):上下移动跳过禁用项与非选中项,回车确认,\n * Esc 关闭,首字母跳转。键盘打开(Enter / 空格 / ↓)高亮首个可用项,↑ 高亮末项;\n * 鼠标打开不预先高亮。Tab 收起菜单,焦点按正常顺序移走。\n *\n * 焦点归还:Esc 关闭或选中条目后,焦点回到触发器。实测此前落在 body ——\n * 条目若随即打开 AlertDialog,`useModal` 记下的恢复目标就是 body,对话框关闭后\n * 焦点再丢一次。选中时先同步归还焦点、再调 `onSelect`,恢复目标因此是触发器。\n *\n * ── 关于 cloneElement ─────────────────────────────────────────\n * 这里仍用 `cloneElement`,但注入的是 `aria-expanded` / `aria-haspopup`,\n * 不是 style。01 §1.7 否决的是注入样式 —— 那会覆盖调用方的 className 并\n * 依赖「子组件必须转发 style」这条未成文约定。aria 属性两者都不沾:它不改\n * 视觉,且触发器不带这两个属性时,读屏用户根本不知道这里有个菜单。\n */\nexport function DropdownMenu({\n trigger,\n items,\n onSelect,\n align = 'start',\n className,\n ...rest\n}: DropdownMenuProps) {\n const [open, setOpen] = useState(false)\n const anchorRef = useRef<HTMLSpanElement>(null)\n\n const { refs, floatingStyles, isPositioned } = useAnchored({\n open,\n placement: align === 'end' ? 'bottom-end' : 'bottom-start',\n gap: 4,\n })\n\n /** 可选中条目在原数组中的下标,用于把导航索引映射回 items。 */\n const selectable = useMemo(\n () => items.map((item, index) => ({ item, index })).filter(({ item }) => isSelectable(item)),\n [items]\n )\n\n const close = useCallback(() => setOpen(false), [])\n const triggerTarget = useCallback(() => focusTargetIn(anchorRef.current), [])\n useDismiss({\n open,\n onDismiss: close,\n floating: refs.floating,\n anchor: anchorRef,\n returnFocus: triggerTarget,\n })\n\n const choose = useCallback(\n (navIndex: number) => {\n const entry = selectable[navIndex]\n if (!entry || entry.item.disabled) return\n // 先把焦点还给触发器,再通知调用方 —— 调用方在 onSelect 里打开的对话框\n // 记录的恢复目标因此是触发器,而不是随菜单卸载掉进的 body。\n triggerTarget()?.focus()\n setOpen(false)\n onSelect?.(entry.item.value!)\n },\n [selectable, onSelect, triggerTarget]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: selectable.length,\n isDisabled: (i) => Boolean(selectable[i]?.item.disabled),\n getText: (i) => (typeof selectable[i]?.item.label === 'string' ? (selectable[i]!.item.label as string) : ''),\n onSelect: choose,\n onDismiss: close,\n })\n\n // 面板打开后立刻接管键盘,否则第一次按方向键落在触发器上,不会有反应。\n useEffect(() => {\n if (open) refs.floating.current?.focus()\n }, [open, refs.floating])\n\n /**\n * 打开菜单并决定初始高亮。`active` 状态在组件上常驻,不随面板卸载重置 ——\n * 每次打开都必须显式设定,否则上一次停留的条目会被下一次的回车直接执行。\n */\n const openWith = (highlight: 'none' | 'first' | 'last') => {\n let index = -1\n if (highlight !== 'none') {\n const order = selectable.map((_, i) => i)\n if (highlight === 'last') order.reverse()\n index = order.find((i) => !selectable[i]!.item.disabled) ?? -1\n }\n setActive(index)\n setOpen(true)\n }\n\n const onTriggerKeyDown = (event: ReactKeyboardEvent) => {\n if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return\n event.preventDefault()\n openWith(event.key === 'ArrowDown' ? 'first' : 'last')\n }\n\n const onMenuKeyDown = (event: ReactKeyboardEvent) => {\n // Tab 收起菜单,不拦默认行为 —— 焦点照常移到下一个可聚焦元素。\n if (event.key === 'Tab') {\n close()\n return\n }\n onKeyDown(event)\n }\n\n const baseId = useId()\n let navIndex = -1\n\n return (\n <div className={clsx('mh-dropdown-menu-root', className)} {...rest}>\n <span\n ref={(node) => {\n anchorRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-dropdown-menu-root__trigger\"\n // detail === 0 是键盘(Enter / 空格)合成的点击:打开并高亮首项。\n onClick={(event) => (open ? close() : openWith(event.detail === 0 ? 'first' : 'none'))}\n onKeyDown={open ? undefined : onTriggerKeyDown}\n >\n {isValidElement(trigger)\n ? cloneElement(trigger as React.ReactElement<Record<string, unknown>>, {\n 'aria-expanded': open,\n 'aria-haspopup': 'menu',\n })\n : trigger}\n </span>\n\n {open && (\n <div\n ref={refs.setFloating}\n data-mh-positioned={isPositioned}\n className=\"mh-menu\"\n role=\"menu\"\n tabIndex={-1}\n aria-activedescendant={active >= 0 ? `${baseId}-${active}` : undefined}\n style={floatingStyles}\n onKeyDown={onMenuKeyDown}\n >\n {items.map((item, i) => {\n if (item.separator) {\n return <div key={`separator-${i}`} className=\"mh-menu__separator\" role=\"separator\" />\n }\n if (item.heading) {\n return (\n <div key={`heading-${i}`} className=\"mh-menu__heading\" role=\"presentation\">\n {item.label}\n </div>\n )\n }\n navIndex += 1\n const current = navIndex\n return (\n <div\n key={item.value}\n id={`${baseId}-${current}`}\n className=\"mh-menu__item\"\n role=\"menuitem\"\n tabIndex={-1}\n aria-disabled={item.disabled || undefined}\n data-active={active === current || undefined}\n data-destructive={item.destructive || undefined}\n data-disabled={item.disabled || undefined}\n onMouseEnter={() => setActive(current)}\n onClick={() => choose(current)}\n >\n {item.icon}\n {item.label}\n </div>\n )\n })}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":["navIndex"]}
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useRef, useState } from "react";
3
+ import { usePreview } from "../../../internal/use-preview.js";
4
4
  import clsx from "clsx";
5
5
  import { useAnchored } from "../../../internal/use-anchored.js";
6
6
  import { useDismiss } from "../../../internal/use-dismiss.js";
@@ -14,31 +14,15 @@ function HoverCard({
14
14
  style,
15
15
  ...rest
16
16
  }) {
17
- const [open, setOpen] = useState(false);
18
- const timer = useRef(null);
19
- const { refs, floatingStyles } = useAnchored({ open, placement: "bottom-start" });
20
- const show = () => {
21
- if (timer.current) clearTimeout(timer.current);
22
- timer.current = setTimeout(() => setOpen(true), openDelay);
23
- };
24
- const hide = () => {
25
- if (timer.current) clearTimeout(timer.current);
26
- setOpen(false);
27
- };
28
- const handleBlur = (event) => {
29
- if (event.currentTarget.contains(event.relatedTarget)) return;
30
- hide();
31
- };
17
+ const { open, hide, events } = usePreview(openDelay, 150);
18
+ const { refs, floatingStyles, isPositioned } = useAnchored({ open, placement: "bottom-start" });
32
19
  useDismiss({ open, onDismiss: hide, floating: refs.floating });
33
20
  return /* @__PURE__ */ jsxs(
34
21
  "span",
35
22
  {
36
23
  ref: refs.setReference,
37
24
  className: clsx("mh-hover-card-anchor", className),
38
- onMouseEnter: show,
39
- onMouseLeave: hide,
40
- onFocus: show,
41
- onBlur: handleBlur,
25
+ ...events,
42
26
  style,
43
27
  ...rest,
44
28
  children: [
@@ -47,6 +31,7 @@ function HoverCard({
47
31
  "span",
48
32
  {
49
33
  ref: refs.setFloating,
34
+ "data-mh-positioned": isPositioned,
50
35
  className: "mh-hover-card",
51
36
  style: cssVars({ "--mh-hover-card-width": toLength(width) }, floatingStyles),
52
37
  children: content
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/HoverCard.tsx"],"sourcesContent":["'use client'\n\nimport { useRef, useState } from 'react'\nimport type { FocusEvent } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { cssVars, toLength } from '../../../internal/css-vars.js'\nimport type { HoverCardProps } from '../../../../contracts/foundation/feedback-overlay/hover-card.js'\n\nexport type { HoverCardProps }\n\n/**\n * 悬停时展示的富预览 —— 人员、机构、关联记录。\n *\n * ⚠️ **永远只是补充。** 悬停对键盘用户与触屏用户不可用,因此同样的信息必须\n * 能通过点击或详情视图获得。绝不能让 HoverCard 成为某项信息的唯一入口。\n *\n * 只是给纯图标控件命名,请用 `Tooltip`。\n *\n * 键盘聚焦触发器同样打开、焦点离开锚点即关闭,Esc 随时可关(WCAG 1.4.13,\n * 06 · P3-5)。Esc 走 `useDismiss`,与库内其他浮层共用 Esc 层级栈。\n * 这只让键盘用户「看得到」预览 —— 面板与触发器没有可访问关联,读屏不播报,\n * 上面那条「不得是唯一入口」不因此放宽。\n */\nexport function HoverCard({\n trigger,\n content,\n width = 280,\n openDelay = 220,\n className,\n style,\n ...rest\n}: HoverCardProps) {\n const [open, setOpen] = useState(false)\n const timer = useRef<ReturnType<typeof setTimeout> | null>(null)\n const { refs, floatingStyles } = useAnchored({ open, placement: 'bottom-start' })\n\n const show = () => {\n if (timer.current) clearTimeout(timer.current)\n timer.current = setTimeout(() => setOpen(true), openDelay)\n }\n\n const hide = () => {\n if (timer.current) clearTimeout(timer.current)\n setOpen(false)\n }\n\n // 焦点在锚点内部移动(触发器 → 面板)不算离开。\n const handleBlur = (event: FocusEvent<HTMLSpanElement>) => {\n if (event.currentTarget.contains(event.relatedTarget as Node | null)) return\n hide()\n }\n\n useDismiss({ open, onDismiss: hide, floating: refs.floating })\n\n return (\n <span\n ref={refs.setReference}\n className={clsx('mh-hover-card-anchor', className)}\n onMouseEnter={show}\n onMouseLeave={hide}\n onFocus={show}\n onBlur={handleBlur}\n style={style}\n {...rest}\n >\n {trigger}\n {open && (\n <span\n ref={refs.setFloating}\n className=\"mh-hover-card\"\n style={cssVars({ '--mh-hover-card-width': toLength(width) }, floatingStyles)}\n >\n {content}\n </span>\n )}\n </span>\n )\n}\n"],"mappings":";AAyDI,SAYI,KAZJ;AAvDJ,SAAS,QAAQ,gBAAgB;AAEjC,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,SAAS,gBAAgB;AAkB3B,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmB;AACjB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,EAAE,MAAM,eAAe,IAAI,YAAY,EAAE,MAAM,WAAW,eAAe,CAAC;AAEhF,QAAM,OAAO,MAAM;AACjB,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,UAAM,UAAU,WAAW,MAAM,QAAQ,IAAI,GAAG,SAAS;AAAA,EAC3D;AAEA,QAAM,OAAO,MAAM;AACjB,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAQ,KAAK;AAAA,EACf;AAGA,QAAM,aAAa,CAAC,UAAuC;AACzD,QAAI,MAAM,cAAc,SAAS,MAAM,aAA4B,EAAG;AACtE,SAAK;AAAA,EACP;AAEA,aAAW,EAAE,MAAM,WAAW,MAAM,UAAU,KAAK,SAAS,CAAC;AAE7D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,KAAK;AAAA,MACV,WAAW,KAAK,wBAAwB,SAAS;AAAA,MACjD,cAAc;AAAA,MACd,cAAc;AAAA,MACd,SAAS;AAAA,MACT,QAAQ;AAAA,MACR;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,QACA,QACC;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,KAAK;AAAA,YACV,WAAU;AAAA,YACV,OAAO,QAAQ,EAAE,yBAAyB,SAAS,KAAK,EAAE,GAAG,cAAc;AAAA,YAE1E;AAAA;AAAA,QACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/HoverCard.tsx"],"sourcesContent":["'use client'\n\nimport { usePreview } from '../../../internal/use-preview.js'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { cssVars, toLength } from '../../../internal/css-vars.js'\nimport type { HoverCardProps } from '../../../../contracts/foundation/feedback-overlay/hover-card.js'\n\nexport type { HoverCardProps }\n\n/**\n * 悬停时展示的富预览 —— 人员、机构、关联记录。\n *\n * ⚠️ **永远只是补充。** 悬停对键盘用户与触屏用户不可用,因此同样的信息必须\n * 能通过点击或详情视图获得。绝不能让 HoverCard 成为某项信息的唯一入口。\n *\n * 只是给纯图标控件命名,请用 `Tooltip`。\n *\n * 键盘聚焦触发器同样打开、焦点离开锚点即关闭,Esc 随时可关(WCAG 1.4.13,\n * 06 · P3-5)。Esc 走 `useDismiss`,与库内其他浮层共用 Esc 层级栈。\n * 这只让键盘用户「看得到」预览 —— 面板与触发器没有可访问关联,读屏不播报,\n * 上面那条「不得是唯一入口」不因此放宽。\n */\nexport function HoverCard({\n trigger,\n content,\n width = 280,\n openDelay = 220,\n className,\n style,\n ...rest\n}: HoverCardProps) {\n const { open, hide, events } = usePreview(openDelay, 150)\n const { refs, floatingStyles, isPositioned } = useAnchored({ open, placement: 'bottom-start' })\n\n useDismiss({ open, onDismiss: hide, floating: refs.floating })\n\n return (\n <span\n ref={refs.setReference}\n className={clsx('mh-hover-card-anchor', className)}\n {...events}\n style={style}\n {...rest}\n >\n {trigger}\n {open && (\n <span\n ref={refs.setFloating}\n data-mh-positioned={isPositioned}\n className=\"mh-hover-card\"\n style={cssVars({ '--mh-hover-card-width': toLength(width) }, floatingStyles)}\n >\n {content}\n </span>\n )}\n </span>\n )\n}\n"],"mappings":";AAuCI,SASI,KATJ;AArCJ,SAAS,kBAAkB;AAC3B,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,SAAS,gBAAgB;AAkB3B,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmB;AACjB,QAAM,EAAE,MAAM,MAAM,OAAO,IAAI,WAAW,WAAW,GAAG;AACxD,QAAM,EAAE,MAAM,gBAAgB,aAAa,IAAI,YAAY,EAAE,MAAM,WAAW,eAAe,CAAC;AAE9F,aAAW,EAAE,MAAM,WAAW,MAAM,UAAU,KAAK,SAAS,CAAC;AAE7D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,KAAK;AAAA,MACV,WAAW,KAAK,wBAAwB,SAAS;AAAA,MAChD,GAAG;AAAA,MACJ;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,QACA,QACC;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,KAAK;AAAA,YACV,sBAAoB;AAAA,YACpB,WAAU;AAAA,YACV,OAAO,QAAQ,EAAE,yBAAyB,SAAS,KAAK,EAAE,GAAG,cAAc;AAAA,YAE1E;AAAA;AAAA,QACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
@@ -31,7 +31,7 @@ function Popover({
31
31
  },
32
32
  [open, onOpenChange]
33
33
  );
34
- const { refs, floatingStyles } = useAnchored({
34
+ const { refs, floatingStyles, isPositioned } = useAnchored({
35
35
  open: expanded,
36
36
  placement: align === "end" ? "bottom-end" : "bottom-start"
37
37
  });
@@ -102,6 +102,7 @@ function Popover({
102
102
  "div",
103
103
  {
104
104
  ref: refs.setFloating,
105
+ "data-mh-positioned": isPositioned,
105
106
  className: "mh-popover",
106
107
  style: cssVars(
107
108
  { "--mh-popover-width": toLength(width), "--mh-popover-radius": radius },
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Popover.tsx"],"sourcesContent":["'use client'\n\nimport { cloneElement, isValidElement, useCallback, useEffect, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { focusTargetIn, useDismiss } from '../../../internal/use-dismiss.js'\nimport { getFocusable } from '../../../internal/focus.js'\nimport { cssVars, toLength } from '../../../internal/css-vars.js'\nimport type { PopoverProps } from '../../../../contracts/foundation/feedback-overlay/popover.js'\n\nexport type { PopoverProps }\n\n/**\n * 锚定的浮动面板,支撑共享的全局动作气泡。\n *\n * 三处相对源实现的修正:\n *\n * ① `useEffect` 补齐依赖数组(04 · F10)。源实现漏了它,每次渲染都重新绑定\n * 一次 mousedown 监听 —— 开着的面板每渲染一帧就多挂一个。\n * ② 外点击用 `pointerdown` 且排除触发器本身。源实现只判断「不在面板内就关」,\n * 于是点触发器会先关一次、再由 onClick 开一次,看上去像点了没反应。\n * ③ 定位交给 floating-ui。源实现是 `top: calc(100% + 6px)` 的绝对定位,\n * 在页面底部打开的面板会被视口裁掉。\n *\n * 另两处可达性修正(实测):\n *\n * ④ `aria-expanded` 注入到 `trigger` 元素本身。此前挂在外层 span 上 ——\n * 读屏读的是那个按钮,span 上的状态它根本不读。注入方式与 DropdownMenu 相同\n * (cloneElement 只注入 aria 属性,不注入 style,见那里的说明)。不注入\n * `aria-haspopup`:该值必须与弹出物的 role 对应,而面板内容任意(筛选、设置、\n * 日期),没有一个固定 role 可声明 —— 按展开 / 收起的披露模式表达即可。\n * ⑤ 关闭时焦点若在面板内(Esc、面板内的按钮调用 `onOpenChange(false)`),\n * 焦点回到触发器。此前落到 body —— 在 Dialog 里打开的气泡一关,焦点就逃出了\n * 对话框的焦点陷阱。\n * ⑥ 焦点离开触发器与面板两者(Tab 出去、聚焦到别处)即收起,不归还焦点 —— 此前\n * 面板停在原处,盖着焦点已经移到的下方字段。面板内的焦点移动(Calendar 网格、\n * 表单控件)与回到触发器都不算离开。\n *\n * 外部锚点(`anchor`,06 · P1-13):触发器由别的组件渲染时(顶栏的应用切换与账户),\n * 定位、外点击排除、焦点归还与焦点离开的判据一律改认该元素。此前调用方只能放一个\n * 空锚点去凑位置,而点触发器在 pointerdown 被当作外部点击先关一次、click 又开一次,\n * 触发器永远关不掉面板。此时组件根改为 `display: contents`,不在宿主布局里占一行。\n * 面板与锚点在 DOM 中不一定相邻(顶栏的面板只能挂在顶栏之后),因此 Tab 顺序按\n * 「锚点 → 面板 → 锚点之后的元素」接上:不接的话,从锚点 Tab 落到它在 DOM 里的下一个\n * 元素,焦点离开即收起,键盘用户永远进不了面板(实测)。\n */\nexport function Popover({\n trigger,\n anchor,\n open,\n defaultOpen = false,\n onOpenChange,\n width = 320,\n align = 'start',\n radius,\n className,\n style,\n children,\n ...rest\n}: PopoverProps) {\n const [internal, setInternal] = useState(defaultOpen)\n const expanded = open === undefined ? internal : open\n const external = anchor !== undefined\n /** 实际锚点:外部锚点,或包着 `trigger` 的 span。useDismiss 与焦点归还都读它 */\n const anchorRef = useRef<HTMLElement | null>(null)\n\n const setOpen = useCallback(\n (next: boolean) => {\n if (open === undefined) setInternal(next)\n onOpenChange?.(next)\n },\n [open, onOpenChange]\n )\n\n const { refs, floatingStyles } = useAnchored({\n open: expanded,\n placement: align === 'end' ? 'bottom-end' : 'bottom-start',\n })\n\n const close = useCallback(() => setOpen(false), [setOpen])\n const triggerTarget = useCallback(() => focusTargetIn(anchorRef.current), [])\n\n useEffect(() => {\n if (!external) return\n anchorRef.current = anchor\n refs.setReference(anchor)\n }, [external, anchor, refs])\n\n useEffect(() => {\n if (!external || !expanded) return\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key !== 'Tab' || event.altKey || event.ctrlKey || event.metaKey) return\n const panel = refs.floating.current\n const anchorEl = anchorRef.current\n if (!panel || !anchorEl) return\n const active = document.activeElement\n const items = getFocusable(panel)\n let target: HTMLElement | undefined\n if (active === anchorEl) {\n if (!event.shiftKey) target = items[0]\n } else if (panel.contains(active)) {\n if (event.shiftKey && (active === items[0] || active === panel)) target = anchorEl\n else if (!event.shiftKey && active === items[items.length - 1]) {\n const order = getFocusable(document.body).filter((el) => !panel.contains(el))\n target = order[order.indexOf(anchorEl) + 1]\n }\n }\n if (!target) return\n event.preventDefault()\n target.focus()\n }\n document.addEventListener('keydown', onKeyDown, true)\n return () => document.removeEventListener('keydown', onKeyDown, true)\n }, [external, expanded, refs])\n useDismiss({\n open: expanded,\n onDismiss: close,\n floating: refs.floating,\n anchor: anchorRef,\n returnFocus: triggerTarget,\n dismissOnFocusOut: true,\n })\n\n return (\n <div\n className={clsx('mh-popover-root', className)}\n data-anchor={external ? 'external' : undefined}\n style={style}\n {...rest}\n >\n {!external && (\n <span\n ref={(node) => {\n anchorRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-popover-root__trigger\"\n onClick={() => setOpen(!expanded)}\n >\n {isValidElement(trigger)\n ? cloneElement(trigger as React.ReactElement<Record<string, unknown>>, {\n 'aria-expanded': expanded,\n })\n : trigger}\n </span>\n )}\n {expanded && (\n <div\n ref={refs.setFloating}\n className=\"mh-popover\"\n style={cssVars(\n { '--mh-popover-width': toLength(width), '--mh-popover-radius': radius },\n floatingStyles\n )}\n >\n {children}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Popover.tsx"],"sourcesContent":["'use client'\n\nimport { cloneElement, isValidElement, useCallback, useEffect, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { focusTargetIn, useDismiss } from '../../../internal/use-dismiss.js'\nimport { getFocusable } from '../../../internal/focus.js'\nimport { cssVars, toLength } from '../../../internal/css-vars.js'\nimport type { PopoverProps } from '../../../../contracts/foundation/feedback-overlay/popover.js'\n\nexport type { PopoverProps }\n\n/**\n * 锚定的浮动面板,支撑共享的全局动作气泡。\n *\n * 三处相对源实现的修正:\n *\n * ① `useEffect` 补齐依赖数组(04 · F10)。源实现漏了它,每次渲染都重新绑定\n * 一次 mousedown 监听 —— 开着的面板每渲染一帧就多挂一个。\n * ② 外点击用 `pointerdown` 且排除触发器本身。源实现只判断「不在面板内就关」,\n * 于是点触发器会先关一次、再由 onClick 开一次,看上去像点了没反应。\n * ③ 定位交给 floating-ui。源实现是 `top: calc(100% + 6px)` 的绝对定位,\n * 在页面底部打开的面板会被视口裁掉。\n *\n * 另两处可达性修正(实测):\n *\n * ④ `aria-expanded` 注入到 `trigger` 元素本身。此前挂在外层 span 上 ——\n * 读屏读的是那个按钮,span 上的状态它根本不读。注入方式与 DropdownMenu 相同\n * (cloneElement 只注入 aria 属性,不注入 style,见那里的说明)。不注入\n * `aria-haspopup`:该值必须与弹出物的 role 对应,而面板内容任意(筛选、设置、\n * 日期),没有一个固定 role 可声明 —— 按展开 / 收起的披露模式表达即可。\n * ⑤ 关闭时焦点若在面板内(Esc、面板内的按钮调用 `onOpenChange(false)`),\n * 焦点回到触发器。此前落到 body —— 在 Dialog 里打开的气泡一关,焦点就逃出了\n * 对话框的焦点陷阱。\n * ⑥ 焦点离开触发器与面板两者(Tab 出去、聚焦到别处)即收起,不归还焦点 —— 此前\n * 面板停在原处,盖着焦点已经移到的下方字段。面板内的焦点移动(Calendar 网格、\n * 表单控件)与回到触发器都不算离开。\n *\n * 外部锚点(`anchor`,06 · P1-13):触发器由别的组件渲染时(顶栏的应用切换与账户),\n * 定位、外点击排除、焦点归还与焦点离开的判据一律改认该元素。此前调用方只能放一个\n * 空锚点去凑位置,而点触发器在 pointerdown 被当作外部点击先关一次、click 又开一次,\n * 触发器永远关不掉面板。此时组件根改为 `display: contents`,不在宿主布局里占一行。\n * 面板与锚点在 DOM 中不一定相邻(顶栏的面板只能挂在顶栏之后),因此 Tab 顺序按\n * 「锚点 → 面板 → 锚点之后的元素」接上:不接的话,从锚点 Tab 落到它在 DOM 里的下一个\n * 元素,焦点离开即收起,键盘用户永远进不了面板(实测)。\n */\nexport function Popover({\n trigger,\n anchor,\n open,\n defaultOpen = false,\n onOpenChange,\n width = 320,\n align = 'start',\n radius,\n className,\n style,\n children,\n ...rest\n}: PopoverProps) {\n const [internal, setInternal] = useState(defaultOpen)\n const expanded = open === undefined ? internal : open\n const external = anchor !== undefined\n /** 实际锚点:外部锚点,或包着 `trigger` 的 span。useDismiss 与焦点归还都读它 */\n const anchorRef = useRef<HTMLElement | null>(null)\n\n const setOpen = useCallback(\n (next: boolean) => {\n if (open === undefined) setInternal(next)\n onOpenChange?.(next)\n },\n [open, onOpenChange]\n )\n\n const { refs, floatingStyles, isPositioned } = useAnchored({\n open: expanded,\n placement: align === 'end' ? 'bottom-end' : 'bottom-start',\n })\n\n const close = useCallback(() => setOpen(false), [setOpen])\n const triggerTarget = useCallback(() => focusTargetIn(anchorRef.current), [])\n\n useEffect(() => {\n if (!external) return\n anchorRef.current = anchor\n refs.setReference(anchor)\n }, [external, anchor, refs])\n\n useEffect(() => {\n if (!external || !expanded) return\n const onKeyDown = (event: KeyboardEvent) => {\n if (event.key !== 'Tab' || event.altKey || event.ctrlKey || event.metaKey) return\n const panel = refs.floating.current\n const anchorEl = anchorRef.current\n if (!panel || !anchorEl) return\n const active = document.activeElement\n const items = getFocusable(panel)\n let target: HTMLElement | undefined\n if (active === anchorEl) {\n if (!event.shiftKey) target = items[0]\n } else if (panel.contains(active)) {\n if (event.shiftKey && (active === items[0] || active === panel)) target = anchorEl\n else if (!event.shiftKey && active === items[items.length - 1]) {\n const order = getFocusable(document.body).filter((el) => !panel.contains(el))\n target = order[order.indexOf(anchorEl) + 1]\n }\n }\n if (!target) return\n event.preventDefault()\n target.focus()\n }\n document.addEventListener('keydown', onKeyDown, true)\n return () => document.removeEventListener('keydown', onKeyDown, true)\n }, [external, expanded, refs])\n useDismiss({\n open: expanded,\n onDismiss: close,\n floating: refs.floating,\n anchor: anchorRef,\n returnFocus: triggerTarget,\n dismissOnFocusOut: true,\n })\n\n return (\n <div\n className={clsx('mh-popover-root', className)}\n data-anchor={external ? 'external' : undefined}\n style={style}\n {...rest}\n >\n {!external && (\n <span\n ref={(node) => {\n anchorRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-popover-root__trigger\"\n onClick={() => setOpen(!expanded)}\n >\n {isValidElement(trigger)\n ? cloneElement(trigger as React.ReactElement<Record<string, unknown>>, {\n 'aria-expanded': expanded,\n })\n : trigger}\n </span>\n )}\n {expanded && (\n <div\n ref={refs.setFloating}\n data-mh-positioned={isPositioned}\n className=\"mh-popover\"\n style={cssVars(\n { '--mh-popover-width': toLength(width), '--mh-popover-radius': radius },\n floatingStyles\n )}\n >\n {children}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":";AA4HI,SAOI,KAPJ;AA1HJ,SAAS,cAAc,gBAAgB,aAAa,WAAW,QAAQ,gBAAgB;AACvF,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAC5B,SAAS,eAAe,kBAAkB;AAC1C,SAAS,oBAAoB;AAC7B,SAAS,SAAS,gBAAgB;AAuC3B,SAAS,QAAQ;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAiB;AACf,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,WAAW;AACpD,QAAM,WAAW,SAAS,SAAY,WAAW;AACjD,QAAM,WAAW,WAAW;AAE5B,QAAM,YAAY,OAA2B,IAAI;AAEjD,QAAM,UAAU;AAAA,IACd,CAAC,SAAkB;AACjB,UAAI,SAAS,OAAW,aAAY,IAAI;AACxC,qBAAe,IAAI;AAAA,IACrB;AAAA,IACA,CAAC,MAAM,YAAY;AAAA,EACrB;AAEA,QAAM,EAAE,MAAM,gBAAgB,aAAa,IAAI,YAAY;AAAA,IACzD,MAAM;AAAA,IACN,WAAW,UAAU,QAAQ,eAAe;AAAA,EAC9C,CAAC;AAED,QAAM,QAAQ,YAAY,MAAM,QAAQ,KAAK,GAAG,CAAC,OAAO,CAAC;AACzD,QAAM,gBAAgB,YAAY,MAAM,cAAc,UAAU,OAAO,GAAG,CAAC,CAAC;AAE5E,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AACf,cAAU,UAAU;AACpB,SAAK,aAAa,MAAM;AAAA,EAC1B,GAAG,CAAC,UAAU,QAAQ,IAAI,CAAC;AAE3B,YAAU,MAAM;AACd,QAAI,CAAC,YAAY,CAAC,SAAU;AAC5B,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,SAAS,MAAM,UAAU,MAAM,WAAW,MAAM,QAAS;AAC3E,YAAM,QAAQ,KAAK,SAAS;AAC5B,YAAM,WAAW,UAAU;AAC3B,UAAI,CAAC,SAAS,CAAC,SAAU;AACzB,YAAM,SAAS,SAAS;AACxB,YAAM,QAAQ,aAAa,KAAK;AAChC,UAAI;AACJ,UAAI,WAAW,UAAU;AACvB,YAAI,CAAC,MAAM,SAAU,UAAS,MAAM,CAAC;AAAA,MACvC,WAAW,MAAM,SAAS,MAAM,GAAG;AACjC,YAAI,MAAM,aAAa,WAAW,MAAM,CAAC,KAAK,WAAW,OAAQ,UAAS;AAAA,iBACjE,CAAC,MAAM,YAAY,WAAW,MAAM,MAAM,SAAS,CAAC,GAAG;AAC9D,gBAAM,QAAQ,aAAa,SAAS,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC;AAC5E,mBAAS,MAAM,MAAM,QAAQ,QAAQ,IAAI,CAAC;AAAA,QAC5C;AAAA,MACF;AACA,UAAI,CAAC,OAAQ;AACb,YAAM,eAAe;AACrB,aAAO,MAAM;AAAA,IACf;AACA,aAAS,iBAAiB,WAAW,WAAW,IAAI;AACpD,WAAO,MAAM,SAAS,oBAAoB,WAAW,WAAW,IAAI;AAAA,EACtE,GAAG,CAAC,UAAU,UAAU,IAAI,CAAC;AAC7B,aAAW;AAAA,IACT,MAAM;AAAA,IACN,WAAW;AAAA,IACX,UAAU,KAAK;AAAA,IACf,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,mBAAmB;AAAA,EACrB,CAAC;AAED,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,mBAAmB,SAAS;AAAA,MAC5C,eAAa,WAAW,aAAa;AAAA,MACrC;AAAA,MACC,GAAG;AAAA,MAEH;AAAA,SAAC,YACA;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,CAAC,SAAS;AACb,wBAAU,UAAU;AACpB,mBAAK,aAAa,IAAI;AAAA,YACxB;AAAA,YACA,WAAU;AAAA,YACV,SAAS,MAAM,QAAQ,CAAC,QAAQ;AAAA,YAE/B,yBAAe,OAAO,IACnB,aAAa,SAAwD;AAAA,cACnE,iBAAiB;AAAA,YACnB,CAAC,IACD;AAAA;AAAA,QACN;AAAA,QAED,YACC;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,KAAK;AAAA,YACV,sBAAoB;AAAA,YACpB,WAAU;AAAA,YACV,OAAO;AAAA,cACL,EAAE,sBAAsB,SAAS,KAAK,GAAG,uBAAuB,OAAO;AAAA,cACvE;AAAA,YACF;AAAA,YAEC;AAAA;AAAA,QACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
@@ -17,7 +17,7 @@ function ToastItem({ toast, paused, onDismiss }) {
17
17
  remaining.current -= Date.now() - startedAt.current;
18
18
  };
19
19
  }, [paused, duration, toast.id, onDismiss]);
20
- return /* @__PURE__ */ jsxs("div", { className: "mh-sonner__item", role: "status", "data-tone": toast.tone ?? "info", children: [
20
+ return /* @__PURE__ */ jsxs("div", { className: "mh-sonner__item", "data-toast-id": toast.id, role: "status", "data-tone": toast.tone ?? "info", children: [
21
21
  /* @__PURE__ */ jsx("span", { className: "mh-sonner__bar", "aria-hidden": "true" }),
22
22
  /* @__PURE__ */ jsxs("div", { className: "mh-sonner__body", children: [
23
23
  /* @__PURE__ */ jsx("div", { className: "mh-sonner__title", children: toast.title }),
@@ -34,15 +34,31 @@ function Sonner({
34
34
  className,
35
35
  ...rest
36
36
  }) {
37
- const [paused, setPaused] = useState(false);
37
+ const [hovered, setHovered] = useState(false);
38
+ const [focusedId, setFocusedId] = useState();
39
+ const paused = hovered || toasts.some((toast) => toast.id === focusedId);
38
40
  return /* @__PURE__ */ jsx(
39
41
  "div",
40
42
  {
41
43
  className: clsx("mh-sonner", className),
42
44
  "data-position": position,
43
- onMouseEnter: () => setPaused(true),
44
- onMouseLeave: () => setPaused(false),
45
45
  ...rest,
46
+ onMouseEnter: (event) => {
47
+ setHovered(true);
48
+ rest.onMouseEnter?.(event);
49
+ },
50
+ onMouseLeave: (event) => {
51
+ setHovered(false);
52
+ rest.onMouseLeave?.(event);
53
+ },
54
+ onFocus: (event) => {
55
+ setFocusedId(event.target.closest("[data-toast-id]")?.dataset.toastId);
56
+ rest.onFocus?.(event);
57
+ },
58
+ onBlur: (event) => {
59
+ if (!event.currentTarget.contains(event.relatedTarget)) setFocusedId(void 0);
60
+ rest.onBlur?.(event);
61
+ },
46
62
  children: toasts.map((toast) => /* @__PURE__ */ jsx(ToastItem, { toast, paused, onDismiss }, toast.id))
47
63
  }
48
64
  );
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Sonner.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { CloseButton } from '../../../internal/CloseButton.js'\nimport type {\n SonnerProps,\n SonnerToast,\n} from '../../../../contracts/foundation/feedback-overlay/sonner.js'\n\nexport type { SonnerProps, SonnerToast }\n\n/** 未指定 duration 时的默认停留时长。 */\nconst DEFAULT_DURATION = 5000\n\ninterface ToastItemProps {\n toast: SonnerToast\n paused: boolean\n onDismiss?: ((id: string) => void) | undefined\n}\n\n/**\n * 单条提示,各自持有自己的倒计时。\n *\n * 暂停时把已过去的时间从剩余时长里扣掉 —— 否则每次鼠标移开都重新计满,\n * 一条 toast 会因为用户划过而多停留好几秒。\n */\nfunction ToastItem({ toast, paused, onDismiss }: ToastItemProps) {\n const duration = toast.duration ?? DEFAULT_DURATION\n const remaining = useRef(duration)\n const startedAt = useRef(0)\n\n useEffect(() => {\n if (paused || duration <= 0) return\n startedAt.current = Date.now()\n const timer = setTimeout(() => onDismiss?.(toast.id), remaining.current)\n return () => {\n clearTimeout(timer)\n remaining.current -= Date.now() - startedAt.current\n }\n }, [paused, duration, toast.id, onDismiss])\n\n return (\n <div className=\"mh-sonner__item\" role=\"status\" data-tone={toast.tone ?? 'info'}>\n <span className=\"mh-sonner__bar\" aria-hidden=\"true\" />\n <div className=\"mh-sonner__body\">\n <div className=\"mh-sonner__title\">{toast.title}</div>\n {toast.description && <div className=\"mh-sonner__description\">{toast.description}</div>}\n </div>\n {toast.action}\n <CloseButton onClick={() => onDismiss?.(toast.id)} />\n </div>\n )\n}\n\n/**\n * 转瞬即逝的提示堆栈 —— 确认某件事已经发生(已保存、已导出、3 条已办结)。\n *\n * ⚠️ **绝不能承载用户必须处理的信息或必须应对的失败。**\n * 判据很简单:**如果用户错过了这条提示会有损失,它就不该是 toast。**\n *\n * 会自己消失(04 · F13)。源实现**完全没有自动消失机制**,与它自称的\n * \"transient toast\" 直接矛盾 —— 不会自己消失的提示不是 toast,是一块常驻的\n * 浮层。鼠标停在堆栈上时暂停计时,用户正在读的提示不该被抽走。\n *\n * 默认在右上角(07 · C-20,06 · P3-18)。此前默认右下角,正好压在列表批量栏、\n * 表单弹窗页脚这类底部动作条上,一停 5 秒,用户要点的按钮被盖住。\n */\nexport function Sonner({\n toasts,\n onDismiss,\n position = 'top-right',\n className,\n ...rest\n}: SonnerProps) {\n const [paused, setPaused] = useState(false)\n\n return (\n <div\n className={clsx('mh-sonner', className)}\n data-position={position}\n onMouseEnter={() => setPaused(true)}\n onMouseLeave={() => setPaused(false)}\n {...rest}\n >\n {toasts.map((toast) => (\n <ToastItem key={toast.id} toast={toast} paused={paused} onDismiss={onDismiss} />\n ))}\n </div>\n )\n}\n"],"mappings":";AA4CM,cACA,YADA;AA1CN,SAAS,WAAW,QAAQ,gBAAgB;AAC5C,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAS5B,MAAM,mBAAmB;AAczB,SAAS,UAAU,EAAE,OAAO,QAAQ,UAAU,GAAmB;AAC/D,QAAM,WAAW,MAAM,YAAY;AACnC,QAAM,YAAY,OAAO,QAAQ;AACjC,QAAM,YAAY,OAAO,CAAC;AAE1B,YAAU,MAAM;AACd,QAAI,UAAU,YAAY,EAAG;AAC7B,cAAU,UAAU,KAAK,IAAI;AAC7B,UAAM,QAAQ,WAAW,MAAM,YAAY,MAAM,EAAE,GAAG,UAAU,OAAO;AACvE,WAAO,MAAM;AACX,mBAAa,KAAK;AAClB,gBAAU,WAAW,KAAK,IAAI,IAAI,UAAU;AAAA,IAC9C;AAAA,EACF,GAAG,CAAC,QAAQ,UAAU,MAAM,IAAI,SAAS,CAAC;AAE1C,SACE,qBAAC,SAAI,WAAU,mBAAkB,MAAK,UAAS,aAAW,MAAM,QAAQ,QACtE;AAAA,wBAAC,UAAK,WAAU,kBAAiB,eAAY,QAAO;AAAA,IACpD,qBAAC,SAAI,WAAU,mBACb;AAAA,0BAAC,SAAI,WAAU,oBAAoB,gBAAM,OAAM;AAAA,MAC9C,MAAM,eAAe,oBAAC,SAAI,WAAU,0BAA0B,gBAAM,aAAY;AAAA,OACnF;AAAA,IACC,MAAM;AAAA,IACP,oBAAC,eAAY,SAAS,MAAM,YAAY,MAAM,EAAE,GAAG;AAAA,KACrD;AAEJ;AAeO,SAAS,OAAO;AAAA,EACrB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAgB;AACd,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,KAAK;AAE1C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,aAAa,SAAS;AAAA,MACtC,iBAAe;AAAA,MACf,cAAc,MAAM,UAAU,IAAI;AAAA,MAClC,cAAc,MAAM,UAAU,KAAK;AAAA,MAClC,GAAG;AAAA,MAEH,iBAAO,IAAI,CAAC,UACX,oBAAC,aAAyB,OAAc,QAAgB,aAAxC,MAAM,EAAwD,CAC/E;AAAA;AAAA,EACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Sonner.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { CloseButton } from '../../../internal/CloseButton.js'\nimport type {\n SonnerProps,\n SonnerToast,\n} from '../../../../contracts/foundation/feedback-overlay/sonner.js'\n\nexport type { SonnerProps, SonnerToast }\n\n/** 未指定 duration 时的默认停留时长。 */\nconst DEFAULT_DURATION = 5000\n\ninterface ToastItemProps {\n toast: SonnerToast\n paused: boolean\n onDismiss?: ((id: string) => void) | undefined\n}\n\n/**\n * 单条提示,各自持有自己的倒计时。\n *\n * 暂停时把已过去的时间从剩余时长里扣掉 —— 否则每次鼠标移开都重新计满,\n * 一条 toast 会因为用户划过而多停留好几秒。\n */\nfunction ToastItem({ toast, paused, onDismiss }: ToastItemProps) {\n const duration = toast.duration ?? DEFAULT_DURATION\n const remaining = useRef(duration)\n const startedAt = useRef(0)\n\n useEffect(() => {\n if (paused || duration <= 0) return\n startedAt.current = Date.now()\n const timer = setTimeout(() => onDismiss?.(toast.id), remaining.current)\n return () => {\n clearTimeout(timer)\n remaining.current -= Date.now() - startedAt.current\n }\n }, [paused, duration, toast.id, onDismiss])\n\n return (\n <div className=\"mh-sonner__item\" data-toast-id={toast.id} role=\"status\" data-tone={toast.tone ?? 'info'}>\n <span className=\"mh-sonner__bar\" aria-hidden=\"true\" />\n <div className=\"mh-sonner__body\">\n <div className=\"mh-sonner__title\">{toast.title}</div>\n {toast.description && <div className=\"mh-sonner__description\">{toast.description}</div>}\n </div>\n {toast.action}\n <CloseButton onClick={() => onDismiss?.(toast.id)} />\n </div>\n )\n}\n\n/**\n * 转瞬即逝的提示堆栈 —— 确认某件事已经发生(已保存、已导出、3 条已办结)。\n *\n * ⚠️ **绝不能承载用户必须处理的信息或必须应对的失败。**\n * 判据很简单:**如果用户错过了这条提示会有损失,它就不该是 toast。**\n *\n * 会自己消失(04 · F13)。源实现**完全没有自动消失机制**,与它自称的\n * \"transient toast\" 直接矛盾 —— 不会自己消失的提示不是 toast,是一块常驻的\n * 浮层。鼠标停在堆栈上时暂停计时,用户正在读的提示不该被抽走。\n *\n * 默认在右上角(07 · C-20,06 · P3-18)。此前默认右下角,正好压在列表批量栏、\n * 表单弹窗页脚这类底部动作条上,一停 5 秒,用户要点的按钮被盖住。\n */\nexport function Sonner({\n toasts,\n onDismiss,\n position = 'top-right',\n className,\n ...rest\n}: SonnerProps) {\n const [hovered, setHovered] = useState(false)\n const [focusedId, setFocusedId] = useState<string | undefined>()\n const paused = hovered || toasts.some((toast) => toast.id === focusedId)\n\n return (\n <div\n className={clsx('mh-sonner', className)}\n data-position={position}\n {...rest}\n onMouseEnter={(event) => { setHovered(true); rest.onMouseEnter?.(event) }}\n onMouseLeave={(event) => { setHovered(false); rest.onMouseLeave?.(event) }}\n onFocus={(event) => {\n setFocusedId(event.target.closest<HTMLElement>('[data-toast-id]')?.dataset.toastId)\n rest.onFocus?.(event)\n }}\n onBlur={(event) => {\n if (!event.currentTarget.contains(event.relatedTarget)) setFocusedId(undefined)\n rest.onBlur?.(event)\n }}\n >\n {toasts.map((toast) => (\n <ToastItem key={toast.id} toast={toast} paused={paused} onDismiss={onDismiss} />\n ))}\n </div>\n )\n}\n"],"mappings":";AA4CM,cACA,YADA;AA1CN,SAAS,WAAW,QAAQ,gBAAgB;AAC5C,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAS5B,MAAM,mBAAmB;AAczB,SAAS,UAAU,EAAE,OAAO,QAAQ,UAAU,GAAmB;AAC/D,QAAM,WAAW,MAAM,YAAY;AACnC,QAAM,YAAY,OAAO,QAAQ;AACjC,QAAM,YAAY,OAAO,CAAC;AAE1B,YAAU,MAAM;AACd,QAAI,UAAU,YAAY,EAAG;AAC7B,cAAU,UAAU,KAAK,IAAI;AAC7B,UAAM,QAAQ,WAAW,MAAM,YAAY,MAAM,EAAE,GAAG,UAAU,OAAO;AACvE,WAAO,MAAM;AACX,mBAAa,KAAK;AAClB,gBAAU,WAAW,KAAK,IAAI,IAAI,UAAU;AAAA,IAC9C;AAAA,EACF,GAAG,CAAC,QAAQ,UAAU,MAAM,IAAI,SAAS,CAAC;AAE1C,SACE,qBAAC,SAAI,WAAU,mBAAkB,iBAAe,MAAM,IAAI,MAAK,UAAS,aAAW,MAAM,QAAQ,QAC/F;AAAA,wBAAC,UAAK,WAAU,kBAAiB,eAAY,QAAO;AAAA,IACpD,qBAAC,SAAI,WAAU,mBACb;AAAA,0BAAC,SAAI,WAAU,oBAAoB,gBAAM,OAAM;AAAA,MAC9C,MAAM,eAAe,oBAAC,SAAI,WAAU,0BAA0B,gBAAM,aAAY;AAAA,OACnF;AAAA,IACC,MAAM;AAAA,IACP,oBAAC,eAAY,SAAS,MAAM,YAAY,MAAM,EAAE,GAAG;AAAA,KACrD;AAEJ;AAeO,SAAS,OAAO;AAAA,EACrB;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAgB;AACd,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,CAAC,WAAW,YAAY,IAAI,SAA6B;AAC/D,QAAM,SAAS,WAAW,OAAO,KAAK,CAAC,UAAU,MAAM,OAAO,SAAS;AAEvE,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,KAAK,aAAa,SAAS;AAAA,MACtC,iBAAe;AAAA,MACd,GAAG;AAAA,MACJ,cAAc,CAAC,UAAU;AAAE,mBAAW,IAAI;AAAG,aAAK,eAAe,KAAK;AAAA,MAAE;AAAA,MACxE,cAAc,CAAC,UAAU;AAAE,mBAAW,KAAK;AAAG,aAAK,eAAe,KAAK;AAAA,MAAE;AAAA,MACzE,SAAS,CAAC,UAAU;AAClB,qBAAa,MAAM,OAAO,QAAqB,iBAAiB,GAAG,QAAQ,OAAO;AAClF,aAAK,UAAU,KAAK;AAAA,MACtB;AAAA,MACA,QAAQ,CAAC,UAAU;AACjB,YAAI,CAAC,MAAM,cAAc,SAAS,MAAM,aAAa,EAAG,cAAa,MAAS;AAC9E,aAAK,SAAS,KAAK;AAAA,MACrB;AAAA,MAEC,iBAAO,IAAI,CAAC,UACX,oBAAC,aAAyB,OAAc,QAAgB,aAAxC,MAAM,EAAwD,CAC/E;AAAA;AAAA,EACH;AAEJ;","names":[]}
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useRef, useState } from "react";
3
+ import { usePreview } from "../../../internal/use-preview.js";
4
4
  import clsx from "clsx";
5
5
  import { useAnchored } from "../../../internal/use-anchored.js";
6
6
  import { useDismiss } from "../../../internal/use-dismiss.js";
@@ -12,31 +12,19 @@ function Tooltip({
12
12
  children,
13
13
  ...rest
14
14
  }) {
15
- const [open, setOpen] = useState(false);
16
- const timer = useRef(null);
17
- const { refs, floatingStyles } = useAnchored({ open, placement: side, gap: 8 });
18
- const show = () => {
19
- if (timer.current) clearTimeout(timer.current);
20
- timer.current = setTimeout(() => setOpen(true), OPEN_DELAY);
21
- };
22
- const hide = () => {
23
- if (timer.current) clearTimeout(timer.current);
24
- setOpen(false);
25
- };
15
+ const { open, hide, events } = usePreview(OPEN_DELAY);
16
+ const { refs, floatingStyles, isPositioned } = useAnchored({ open, placement: side, gap: 8 });
26
17
  useDismiss({ open, onDismiss: hide, floating: refs.floating });
27
18
  return /* @__PURE__ */ jsxs(
28
19
  "span",
29
20
  {
30
21
  ref: refs.setReference,
31
22
  className: clsx("mh-tooltip-anchor", className),
32
- onMouseEnter: show,
33
- onMouseLeave: hide,
34
- onFocusCapture: show,
35
- onBlurCapture: hide,
23
+ ...events,
36
24
  ...rest,
37
25
  children: [
38
26
  children,
39
- open && content && /* @__PURE__ */ jsx("span", { ref: refs.setFloating, className: "mh-tooltip", role: "tooltip", style: floatingStyles, children: content })
27
+ open && content && /* @__PURE__ */ jsx("span", { ref: refs.setFloating, "data-mh-positioned": isPositioned, className: "mh-tooltip", role: "tooltip", style: floatingStyles, children: content })
40
28
  ]
41
29
  }
42
30
  );
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Tooltip.tsx"],"sourcesContent":["'use client'\n\nimport { useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport type { TooltipProps } from '../../../../contracts/foundation/feedback-overlay/tooltip.js'\n\nexport type { TooltipProps }\n\n/** 显示延迟。密集工具栏上划过一排图标按钮时,没有它会连闪一串(04 · F12)。 */\nconst OPEN_DELAY = 220\n\n/**\n * 悬停或聚焦时出现的短标签,用于为纯图标控件命名。\n *\n * ⚠️ **工具提示不是可访问名称。** 控件本身必须同时带真实的 `aria-label` ——\n * 屏幕阅读器用户与键盘用户不能只依赖悬停。\n *\n * 两处相对源实现的修正:\n *\n * ① 显示延迟(04 · F12)。源实现即时弹出,密集工具栏上划过会闪烁;\n * 同族的 HoverCard 反而有 openDelay。\n * ② 定位改用 floating-ui。源实现是 `position: absolute` 加四个方位的\n * 硬编码偏移,贴着视口边缘时会被裁掉;现在空间不足会自动翻到对侧。\n *\n * Esc 关闭提示且不移动焦点与指针(WCAG 1.4.13,06 · P3-5),走 `useDismiss`,\n * 因此与库内其他浮层共用 Esc 层级栈:对话框里的图标按钮亮着提示时,第一次 Esc\n * 只收起提示,第二次才关对话框。\n *\n * 样式 token 也从 Shell 解耦了(04 · F9)—— 高度、内边距、圆角、背景、前景、\n * 偏移六项此前全部取自 `--ui-shell-global-action-tooltip-*`,那组属于顶栏的\n * 五个全局动作触发器,改它会连带改掉产品内每一个工具提示。\n */\nexport function Tooltip({\n content,\n side = 'bottom',\n className,\n children,\n ...rest\n}: TooltipProps) {\n const [open, setOpen] = useState(false)\n const timer = useRef<ReturnType<typeof setTimeout> | null>(null)\n const { refs, floatingStyles } = useAnchored({ open, placement: side, gap: 8 })\n\n const show = () => {\n if (timer.current) clearTimeout(timer.current)\n timer.current = setTimeout(() => setOpen(true), OPEN_DELAY)\n }\n\n const hide = () => {\n if (timer.current) clearTimeout(timer.current)\n setOpen(false)\n }\n\n useDismiss({ open, onDismiss: hide, floating: refs.floating })\n\n return (\n <span\n ref={refs.setReference}\n className={clsx('mh-tooltip-anchor', className)}\n onMouseEnter={show}\n onMouseLeave={hide}\n onFocusCapture={show}\n onBlurCapture={hide}\n {...rest}\n >\n {children}\n {open && content && (\n <span ref={refs.setFloating} className=\"mh-tooltip\" role=\"tooltip\" style={floatingStyles}>\n {content}\n </span>\n )}\n </span>\n )\n}\n"],"mappings":";AA0DI,SAWI,KAXJ;AAxDJ,SAAS,QAAQ,gBAAgB;AACjC,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAM3B,MAAM,aAAa;AAuBZ,SAAS,QAAQ;AAAA,EACtB;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAiB;AACf,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,EAAE,MAAM,eAAe,IAAI,YAAY,EAAE,MAAM,WAAW,MAAM,KAAK,EAAE,CAAC;AAE9E,QAAM,OAAO,MAAM;AACjB,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,UAAM,UAAU,WAAW,MAAM,QAAQ,IAAI,GAAG,UAAU;AAAA,EAC5D;AAEA,QAAM,OAAO,MAAM;AACjB,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAQ,KAAK;AAAA,EACf;AAEA,aAAW,EAAE,MAAM,WAAW,MAAM,UAAU,KAAK,SAAS,CAAC;AAE7D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,KAAK;AAAA,MACV,WAAW,KAAK,qBAAqB,SAAS;AAAA,MAC9C,cAAc;AAAA,MACd,cAAc;AAAA,MACd,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACd,GAAG;AAAA,MAEH;AAAA;AAAA,QACA,QAAQ,WACP,oBAAC,UAAK,KAAK,KAAK,aAAa,WAAU,cAAa,MAAK,WAAU,OAAO,gBACvE,mBACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/feedback-overlay/Tooltip.tsx"],"sourcesContent":["'use client'\n\nimport { usePreview } from '../../../internal/use-preview.js'\nimport clsx from 'clsx'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport type { TooltipProps } from '../../../../contracts/foundation/feedback-overlay/tooltip.js'\n\nexport type { TooltipProps }\n\n/** 显示延迟。密集工具栏上划过一排图标按钮时,没有它会连闪一串(04 · F12)。 */\nconst OPEN_DELAY = 220\n\n/**\n * 悬停或聚焦时出现的短标签,用于为纯图标控件命名。\n *\n * ⚠️ **工具提示不是可访问名称。** 控件本身必须同时带真实的 `aria-label` ——\n * 屏幕阅读器用户与键盘用户不能只依赖悬停。\n *\n * 两处相对源实现的修正:\n *\n * ① 显示延迟(04 · F12)。源实现即时弹出,密集工具栏上划过会闪烁;\n * 同族的 HoverCard 反而有 openDelay。\n * ② 定位改用 floating-ui。源实现是 `position: absolute` 加四个方位的\n * 硬编码偏移,贴着视口边缘时会被裁掉;现在空间不足会自动翻到对侧。\n *\n * Esc 关闭提示且不移动焦点与指针(WCAG 1.4.13,06 · P3-5),走 `useDismiss`,\n * 因此与库内其他浮层共用 Esc 层级栈:对话框里的图标按钮亮着提示时,第一次 Esc\n * 只收起提示,第二次才关对话框。\n *\n * 样式 token 也从 Shell 解耦了(04 · F9)—— 高度、内边距、圆角、背景、前景、\n * 偏移六项此前全部取自 `--ui-shell-global-action-tooltip-*`,那组属于顶栏的\n * 五个全局动作触发器,改它会连带改掉产品内每一个工具提示。\n */\nexport function Tooltip({\n content,\n side = 'bottom',\n className,\n children,\n ...rest\n}: TooltipProps) {\n const { open, hide, events } = usePreview(OPEN_DELAY)\n const { refs, floatingStyles, isPositioned } = useAnchored({ open, placement: side, gap: 8 })\n\n useDismiss({ open, onDismiss: hide, floating: refs.floating })\n\n return (\n <span\n ref={refs.setReference}\n className={clsx('mh-tooltip-anchor', className)}\n {...events}\n {...rest}\n >\n {children}\n {open && content && (\n <span ref={refs.setFloating} data-mh-positioned={isPositioned} className=\"mh-tooltip\" role=\"tooltip\" style={floatingStyles}>\n {content}\n </span>\n )}\n </span>\n )\n}\n"],"mappings":";AA+CI,SAQI,KARJ;AA7CJ,SAAS,kBAAkB;AAC3B,OAAO,UAAU;AACjB,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAM3B,MAAM,aAAa;AAuBZ,SAAS,QAAQ;AAAA,EACtB;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAiB;AACf,QAAM,EAAE,MAAM,MAAM,OAAO,IAAI,WAAW,UAAU;AACpD,QAAM,EAAE,MAAM,gBAAgB,aAAa,IAAI,YAAY,EAAE,MAAM,WAAW,MAAM,KAAK,EAAE,CAAC;AAE5F,aAAW,EAAE,MAAM,WAAW,MAAM,UAAU,KAAK,SAAS,CAAC;AAE7D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,KAAK;AAAA,MACV,WAAW,KAAK,qBAAqB,SAAS;AAAA,MAC7C,GAAG;AAAA,MACH,GAAG;AAAA,MAEH;AAAA;AAAA,QACA,QAAQ,WACP,oBAAC,UAAK,KAAK,KAAK,aAAa,sBAAoB,cAAc,WAAU,cAAa,MAAK,WAAU,OAAO,gBACzG,mBACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
@@ -41,7 +41,7 @@ function Combobox({
41
41
  if (!needle) return options;
42
42
  return options.filter((option) => searchTextOf(option).toLowerCase().includes(needle));
43
43
  }, [options, query]);
44
- const { refs, floatingStyles } = useAnchored({
44
+ const { refs, floatingStyles, isPositioned } = useAnchored({
45
45
  open,
46
46
  placement: "bottom-start",
47
47
  gap: 4,
@@ -147,6 +147,7 @@ function Combobox({
147
147
  "div",
148
148
  {
149
149
  ref: refs.setFloating,
150
+ "data-mh-positioned": isPositioned,
150
151
  id: listboxId,
151
152
  className: "mh-combobox__listbox",
152
153
  role: "listbox",
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Combobox.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useId, useMemo, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n ComboboxProps,\n ComboboxOption,\n} from '../../../../contracts/foundation/input-selection/combobox.js'\n\nexport type { ComboboxProps, ComboboxOption }\n\n/**\n * 取一个选项用于筛选匹配的纯文本。\n *\n * `searchText` 优先;没有它时只有 `label` 是字符串才参与匹配(04 · I13)——\n * 源实现一律 `String(label)`,ReactNode 会 stringify 成 `[object Object]`,\n * 于是带图标或高亮的选项永远筛不到。契约因此把 `searchText` 定为\n * 「label 非字符串时**必须**提供」。\n */\nfunction searchTextOf(option: ComboboxOption): string {\n if (option.searchText !== undefined) return option.searchText\n return typeof option.label === 'string' ? option.label : ''\n}\n\n/**\n * 可输入筛选的单选控件。\n *\n * 两处相对源实现的修正:\n *\n * ① 关闭不再靠 `setTimeout(120)`。源实现在 `onBlur` 里延迟 120ms 关闭,好让\n * 选项的 `onMouseDown` 抢在前面 —— 这是一个纯粹靠时序赌赢的写法,慢一点的\n * 机器上点选项会落空。改用共享的外点击判定;浮层上的 `mousedown` 一律\n * `preventDefault`,焦点从不离开输入框,失焦关闭因此不会抢掉选项的点击。\n * ② 补键盘导航(04 · I12)。\n *\n * 读屏与键盘按 WAI-ARIA 1.2 combobox 模式(06 · P3-10):\n *\n * - `role=\"combobox\"`、`aria-expanded`、`aria-controls`、`aria-activedescendant`\n * 全在输入框上 —— 焦点始终在输入框,活动项只有经 `aria-activedescendant` 才报得出来。\n * - `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到输入框,其余属性\n * 仍在根元素。此前落在根 div,`Field htmlFor` 与 `aria-label` 都给了一个读屏不读的元素。\n * - **聚焦不展开。** 此前一 Tab 进来浮层就盖住下方字段,键盘用户只是路过也得先\n * 关掉它。展开的入口是输入、↓ / ↑(落到当前选中项或首 / 末项)、Alt+↓(只展开)\n * 与鼠标点击。\n * - Tab 与失焦即收起,不抢走焦点。收起状态下 Esc 与 Enter 原样放行 —— 前者留给\n * 外层对话框,后者留给表单提交。\n *\n * `invalid`(06 · P1-16)分两处落:`aria-invalid` 在输入框上(与 `id` 同处,`Field`\n * 关联的就是它),danger 边框画在外壳上(焦点与边框本就由外壳表达)。\n */\nexport function Combobox({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '搜索选项',\n emptyText = '无匹配项',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: ComboboxProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const [query, setQuery] = useState('')\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const shellRef = useRef<HTMLDivElement>(null)\n const inputRef = useRef<HTMLInputElement>(null)\n const baseId = useId()\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n\n const shown = useMemo(() => {\n const needle = query.trim().toLowerCase()\n if (!needle) return options\n return options.filter((option) => searchTextOf(option).toLowerCase().includes(needle))\n }, [options, query])\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => {\n setOpen(false)\n setQuery('')\n }, [])\n useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: shellRef })\n\n const choose = useCallback(\n (index: number) => {\n const option = shown[index]\n if (!option) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setQuery('')\n setOpen(false)\n },\n [shown, value, onValueChange]\n )\n\n // 筛选由输入框本身承担,不做首字母跳转;按键交给输入框编辑文本\n const { active, setActive, onKeyDown } = useListNavigation({\n count: shown.length,\n onSelect: choose,\n onDismiss: close,\n textEntry: true,\n })\n\n // 输入框里显示的文本:展开时是查询词,收起时是已选项的文本。\n const inputValue = open ? query : selected ? searchTextOf(selected) : ''\n const activeId = open && active >= 0 && active < shown.length ? optionId(active) : undefined\n\n return (\n <div className={clsx('mh-combobox', className)} {...rest}>\n <div\n ref={(node) => {\n shellRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-combobox__shell\"\n data-open={open || undefined}\n data-disabled={disabled || undefined}\n data-invalid={invalid || undefined}\n onMouseDown={(event) => {\n // 点外壳的空白或箭头:焦点交给输入框并切换展开。点输入框本身走它自己的 onClick。\n if (disabled || event.target === inputRef.current) return\n event.preventDefault()\n inputRef.current?.focus()\n if (open) close()\n else setOpen(true)\n }}\n >\n <input\n ref={inputRef}\n id={id}\n className=\"mh-combobox__input\"\n role=\"combobox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={ariaDescribedBy}\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-activedescendant={activeId}\n aria-autocomplete=\"list\"\n aria-invalid={invalid || undefined}\n disabled={disabled}\n value={inputValue}\n placeholder={placeholder}\n // 收起时框里是已选项的文本;全选它,键入即替换成查询词,而不是接在已选文本后面\n // 筛出一个空列表。此前聚焦即展开、框里随之清空,不存在这个问题。\n onFocus={(event) => event.target.select()}\n onClick={() => {\n if (!open) setOpen(true)\n }}\n onBlur={(event) => {\n if (!refs.floating.current?.contains(event.relatedTarget as Node | null)) close()\n }}\n onChange={(event) => {\n setQuery(event.target.value)\n setOpen(true)\n setActive(-1)\n }}\n onKeyDown={(event) => {\n if (open) {\n if (event.key === 'Tab') close()\n else onKeyDown(event)\n return\n }\n if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return\n event.preventDefault()\n setOpen(true)\n if (event.altKey) {\n setActive(-1)\n return\n }\n const index = options.findIndex((option) => option.value === current)\n setActive(index >= 0 ? index : event.key === 'ArrowDown' ? 0 : options.length - 1)\n }}\n />\n <Icon className=\"mh-combobox__chevron\" name=\"chevron-down\" size={14} />\n </div>\n\n {open && (\n <div\n ref={refs.setFloating}\n id={listboxId}\n className=\"mh-combobox__listbox\"\n role=\"listbox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabel ? undefined : ariaLabelledBy}\n style={floatingStyles}\n // 焦点留在输入框:点选项、拖滚动条都不触发输入框失焦。\n onMouseDown={(event) => event.preventDefault()}\n >\n {shown.length === 0 ? (\n <div className=\"mh-combobox__empty\">{emptyText}</div>\n ) : (\n shown.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-combobox__option\"\n role=\"option\"\n aria-selected={option.value === current}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n {option.label}\n </div>\n ))\n )}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Combobox.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useId, useMemo, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n ComboboxProps,\n ComboboxOption,\n} from '../../../../contracts/foundation/input-selection/combobox.js'\n\nexport type { ComboboxProps, ComboboxOption }\n\n/**\n * 取一个选项用于筛选匹配的纯文本。\n *\n * `searchText` 优先;没有它时只有 `label` 是字符串才参与匹配(04 · I13)——\n * 源实现一律 `String(label)`,ReactNode 会 stringify 成 `[object Object]`,\n * 于是带图标或高亮的选项永远筛不到。契约因此把 `searchText` 定为\n * 「label 非字符串时**必须**提供」。\n */\nfunction searchTextOf(option: ComboboxOption): string {\n if (option.searchText !== undefined) return option.searchText\n return typeof option.label === 'string' ? option.label : ''\n}\n\n/**\n * 可输入筛选的单选控件。\n *\n * 两处相对源实现的修正:\n *\n * ① 关闭不再靠 `setTimeout(120)`。源实现在 `onBlur` 里延迟 120ms 关闭,好让\n * 选项的 `onMouseDown` 抢在前面 —— 这是一个纯粹靠时序赌赢的写法,慢一点的\n * 机器上点选项会落空。改用共享的外点击判定;浮层上的 `mousedown` 一律\n * `preventDefault`,焦点从不离开输入框,失焦关闭因此不会抢掉选项的点击。\n * ② 补键盘导航(04 · I12)。\n *\n * 读屏与键盘按 WAI-ARIA 1.2 combobox 模式(06 · P3-10):\n *\n * - `role=\"combobox\"`、`aria-expanded`、`aria-controls`、`aria-activedescendant`\n * 全在输入框上 —— 焦点始终在输入框,活动项只有经 `aria-activedescendant` 才报得出来。\n * - `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到输入框,其余属性\n * 仍在根元素。此前落在根 div,`Field htmlFor` 与 `aria-label` 都给了一个读屏不读的元素。\n * - **聚焦不展开。** 此前一 Tab 进来浮层就盖住下方字段,键盘用户只是路过也得先\n * 关掉它。展开的入口是输入、↓ / ↑(落到当前选中项或首 / 末项)、Alt+↓(只展开)\n * 与鼠标点击。\n * - Tab 与失焦即收起,不抢走焦点。收起状态下 Esc 与 Enter 原样放行 —— 前者留给\n * 外层对话框,后者留给表单提交。\n *\n * `invalid`(06 · P1-16)分两处落:`aria-invalid` 在输入框上(与 `id` 同处,`Field`\n * 关联的就是它),danger 边框画在外壳上(焦点与边框本就由外壳表达)。\n */\nexport function Combobox({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '搜索选项',\n emptyText = '无匹配项',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: ComboboxProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const [query, setQuery] = useState('')\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const shellRef = useRef<HTMLDivElement>(null)\n const inputRef = useRef<HTMLInputElement>(null)\n const baseId = useId()\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n\n const shown = useMemo(() => {\n const needle = query.trim().toLowerCase()\n if (!needle) return options\n return options.filter((option) => searchTextOf(option).toLowerCase().includes(needle))\n }, [options, query])\n\n const { refs, floatingStyles, isPositioned } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => {\n setOpen(false)\n setQuery('')\n }, [])\n useDismiss({ open, onDismiss: close, floating: refs.floating, anchor: shellRef })\n\n const choose = useCallback(\n (index: number) => {\n const option = shown[index]\n if (!option) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setQuery('')\n setOpen(false)\n },\n [shown, value, onValueChange]\n )\n\n // 筛选由输入框本身承担,不做首字母跳转;按键交给输入框编辑文本\n const { active, setActive, onKeyDown } = useListNavigation({\n count: shown.length,\n onSelect: choose,\n onDismiss: close,\n textEntry: true,\n })\n\n // 输入框里显示的文本:展开时是查询词,收起时是已选项的文本。\n const inputValue = open ? query : selected ? searchTextOf(selected) : ''\n const activeId = open && active >= 0 && active < shown.length ? optionId(active) : undefined\n\n return (\n <div className={clsx('mh-combobox', className)} {...rest}>\n <div\n ref={(node) => {\n shellRef.current = node\n refs.setReference(node)\n }}\n className=\"mh-combobox__shell\"\n data-open={open || undefined}\n data-disabled={disabled || undefined}\n data-invalid={invalid || undefined}\n onMouseDown={(event) => {\n // 点外壳的空白或箭头:焦点交给输入框并切换展开。点输入框本身走它自己的 onClick。\n if (disabled || event.target === inputRef.current) return\n event.preventDefault()\n inputRef.current?.focus()\n if (open) close()\n else setOpen(true)\n }}\n >\n <input\n ref={inputRef}\n id={id}\n className=\"mh-combobox__input\"\n role=\"combobox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={ariaDescribedBy}\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-activedescendant={activeId}\n aria-autocomplete=\"list\"\n aria-invalid={invalid || undefined}\n disabled={disabled}\n value={inputValue}\n placeholder={placeholder}\n // 收起时框里是已选项的文本;全选它,键入即替换成查询词,而不是接在已选文本后面\n // 筛出一个空列表。此前聚焦即展开、框里随之清空,不存在这个问题。\n onFocus={(event) => event.target.select()}\n onClick={() => {\n if (!open) setOpen(true)\n }}\n onBlur={(event) => {\n if (!refs.floating.current?.contains(event.relatedTarget as Node | null)) close()\n }}\n onChange={(event) => {\n setQuery(event.target.value)\n setOpen(true)\n setActive(-1)\n }}\n onKeyDown={(event) => {\n if (open) {\n if (event.key === 'Tab') close()\n else onKeyDown(event)\n return\n }\n if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return\n event.preventDefault()\n setOpen(true)\n if (event.altKey) {\n setActive(-1)\n return\n }\n const index = options.findIndex((option) => option.value === current)\n setActive(index >= 0 ? index : event.key === 'ArrowDown' ? 0 : options.length - 1)\n }}\n />\n <Icon className=\"mh-combobox__chevron\" name=\"chevron-down\" size={14} />\n </div>\n\n {open && (\n <div\n ref={refs.setFloating}\n data-mh-positioned={isPositioned}\n id={listboxId}\n className=\"mh-combobox__listbox\"\n role=\"listbox\"\n aria-label={ariaLabel}\n aria-labelledby={ariaLabel ? undefined : ariaLabelledBy}\n style={floatingStyles}\n // 焦点留在输入框:点选项、拖滚动条都不触发输入框失焦。\n onMouseDown={(event) => event.preventDefault()}\n >\n {shown.length === 0 ? (\n <div className=\"mh-combobox__empty\">{emptyText}</div>\n ) : (\n shown.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-combobox__option\"\n role=\"option\"\n aria-selected={option.value === current}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n {option.label}\n </div>\n ))\n )}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
@@ -33,7 +33,7 @@ function Select({
33
33
  const optionId = (index) => `${baseId}-option-${index}`;
34
34
  const named = Boolean(id || ariaLabel || ariaLabelledBy);
35
35
  const describedBy = [ariaDescribedBy, named ? valueId : void 0].filter(Boolean).join(" ") || void 0;
36
- const { refs, floatingStyles } = useAnchored({
36
+ const { refs, floatingStyles, isPositioned } = useAnchored({
37
37
  open,
38
38
  placement: "bottom-start",
39
39
  gap: 4,
@@ -45,7 +45,8 @@ function Select({
45
45
  onDismiss: close,
46
46
  floating: refs.floating,
47
47
  anchor: triggerRef,
48
- returnFocus: () => triggerRef.current
48
+ returnFocus: () => triggerRef.current,
49
+ dismissOnFocusOut: true
49
50
  });
50
51
  const choose = useCallback(
51
52
  (index) => {
@@ -104,7 +105,7 @@ function Select({
104
105
  },
105
106
  children: [
106
107
  /* @__PURE__ */ jsx("span", { id: valueId, className: "mh-select__value", children: selected ? selected.label : placeholder }),
107
- /* @__PURE__ */ jsx(Icon, { className: "mh-select__chevron", name: "chevron-down", size: 14 })
108
+ /* @__PURE__ */ jsx(Icon, { className: "mh-select__chevron", name: "chevron-down", size: 16 })
108
109
  ]
109
110
  }
110
111
  ),
@@ -112,6 +113,7 @@ function Select({
112
113
  "div",
113
114
  {
114
115
  ref: refs.setFloating,
116
+ "data-mh-positioned": isPositioned,
115
117
  id: listboxId,
116
118
  className: "mh-select__listbox",
117
119
  role: "listbox",
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/input-selection/Select.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useId, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n SelectProps,\n SelectOption,\n} from '../../../../contracts/foundation/input-selection/select.js'\n\nexport type { SelectProps, SelectOption }\n\n/**\n * 自绘单选下拉 —— 表单与筛选行中的默认选择控件。\n *\n * 选型边界:选项极多或密集的行内编辑器用 `NativeSelect`;需要输入筛选用\n * `Combobox`;2–5 个选项且需全部可见用 `RadioGroup`;显示设置用 `ToggleGroup`。\n *\n * 补齐了键盘导航与浮层外点击关闭(04 · I12),并把定位交给 floating-ui ——\n * 源实现是 `top: calc(100% + 4px)` 的绝对定位,页面底部的下拉会被视口裁掉。\n * 打开时活动项落在当前选中项上,而不是列表首项。\n *\n * `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到触发按钮,其余属性\n * 仍落在根元素(05 · P3-2、06 · P3-14)。此前四者都在外层 div 上:`Field htmlFor`\n * 的 `label for` 指向一个不可标注的 div,排序控件传的 `aria-label` 读屏读不到,\n * 按钮的名称只剩当前值。按钮有名称之后,当前值另由 `aria-describedby` 指向值文本\n * 补回 —— 按钮的名称一旦来自标签,它的内容就不再进名称,不补读屏只听得到\n * 「负责人,按钮」而不知道选了谁。\n */\nexport function Select({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '未选择',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: SelectProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const triggerRef = useRef<HTMLButtonElement>(null)\n const baseId = useId()\n const triggerId = id ?? `${baseId}-trigger`\n const valueId = `${baseId}-value`\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n // 名称来自外部(标签或 aria-*)时,内容不再计入名称,当前值改由描述带出。\n const named = Boolean(id || ariaLabel || ariaLabelledBy)\n const describedBy = [ariaDescribedBy, named ? valueId : undefined].filter(Boolean).join(' ') || undefined\n\n const { refs, floatingStyles } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => setOpen(false), [])\n // Esc 由 useDismiss 在捕获阶段截停,列表自己的 onDismiss(聚焦触发器)根本收不到;\n // 焦点归还因此必须交给 useDismiss,否则收起后焦点掉到 body(对话框里同样)。\n useDismiss({\n open,\n onDismiss: close,\n floating: refs.floating,\n anchor: triggerRef,\n returnFocus: () => triggerRef.current,\n })\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index]\n if (!option || option.disabled) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setOpen(false)\n triggerRef.current?.focus()\n },\n [options, value, onValueChange]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: options.length,\n isDisabled: (i) => Boolean(options[i]?.disabled),\n getText: (i) => (typeof options[i]?.label === 'string' ? (options[i]!.label as string) : ''),\n onSelect: choose,\n onDismiss: () => {\n close()\n triggerRef.current?.focus()\n },\n })\n\n // 打开时把活动项放在当前选中项上,并接管键盘。\n useEffect(() => {\n if (!open) return\n setActive(options.findIndex((option) => option.value === current))\n refs.floating.current?.focus()\n }, [open, options, current, setActive, refs.floating])\n\n return (\n <div className={clsx('mh-select', className)} {...rest}>\n <button\n ref={(node) => {\n triggerRef.current = node\n refs.setReference(node)\n }}\n type=\"button\"\n id={triggerId}\n className=\"mh-select__trigger\"\n disabled={disabled}\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={describedBy}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n data-open={open || undefined}\n data-placeholder={selected ? undefined : 'true'}\n onClick={() => !disabled && setOpen(!open)}\n onKeyDown={(event) => {\n // 关闭状态下按方向键直接打开,是原生 select 的习惯。\n if (!open && (event.key === 'ArrowDown' || event.key === 'ArrowUp')) {\n setOpen(true)\n event.preventDefault()\n }\n }}\n >\n <span id={valueId} className=\"mh-select__value\">\n {selected ? selected.label : placeholder}\n </span>\n <Icon className=\"mh-select__chevron\" name=\"chevron-down\" size={14} />\n </button>\n\n {open && (\n <div\n ref={refs.setFloating}\n id={listboxId}\n className=\"mh-select__listbox\"\n role=\"listbox\"\n tabIndex={-1}\n aria-labelledby={triggerId}\n // 焦点在列表本身,活动项靠它报给读屏;只有视觉标记时方向键走动是无声的。\n aria-activedescendant={active >= 0 ? optionId(active) : undefined}\n style={floatingStyles}\n onKeyDown={onKeyDown}\n >\n {options.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-select__option\"\n role=\"option\"\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n data-disabled={option.disabled || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n <span className=\"mh-select__option-label\">{option.label}</span>\n {option.value === current && <Icon name=\"check\" size={14} />}\n </div>\n ))}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/input-selection/Select.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useId, useRef, useState } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { useAnchored } from '../../../internal/use-anchored.js'\nimport { useDismiss } from '../../../internal/use-dismiss.js'\nimport { useListNavigation } from '../../../internal/use-list-navigation.js'\nimport type {\n SelectProps,\n SelectOption,\n} from '../../../../contracts/foundation/input-selection/select.js'\n\nexport type { SelectProps, SelectOption }\n\n/**\n * 自绘单选下拉 —— 表单与筛选行中的默认选择控件。\n *\n * 选型边界:选项极多或密集的行内编辑器用 `NativeSelect`;需要输入筛选用\n * `Combobox`;2–5 个选项且需全部可见用 `RadioGroup`;显示设置用 `ToggleGroup`。\n *\n * 补齐了键盘导航与浮层外点击关闭(04 · I12),并把定位交给 floating-ui ——\n * 源实现是 `top: calc(100% + 4px)` 的绝对定位,页面底部的下拉会被视口裁掉。\n * 打开时活动项落在当前选中项上,而不是列表首项。\n *\n * `id`、`aria-label`、`aria-labelledby`、`aria-describedby` 落到触发按钮,其余属性\n * 仍落在根元素(05 · P3-2、06 · P3-14)。此前四者都在外层 div 上:`Field htmlFor`\n * 的 `label for` 指向一个不可标注的 div,排序控件传的 `aria-label` 读屏读不到,\n * 按钮的名称只剩当前值。按钮有名称之后,当前值另由 `aria-describedby` 指向值文本\n * 补回 —— 按钮的名称一旦来自标签,它的内容就不再进名称,不补读屏只听得到\n * 「负责人,按钮」而不知道选了谁。\n */\nexport function Select({\n options,\n value,\n defaultValue,\n onValueChange,\n placeholder = '未选择',\n disabled = false,\n invalid = false,\n className,\n id,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledBy,\n 'aria-describedby': ariaDescribedBy,\n ...rest\n}: SelectProps) {\n const [internal, setInternal] = useState(defaultValue)\n const [open, setOpen] = useState(false)\n const current = value === undefined ? internal : value\n const selected = options.find((option) => option.value === current)\n const triggerRef = useRef<HTMLButtonElement>(null)\n const baseId = useId()\n const triggerId = id ?? `${baseId}-trigger`\n const valueId = `${baseId}-value`\n const listboxId = `${baseId}-listbox`\n const optionId = (index: number) => `${baseId}-option-${index}`\n // 名称来自外部(标签或 aria-*)时,内容不再计入名称,当前值改由描述带出。\n const named = Boolean(id || ariaLabel || ariaLabelledBy)\n const describedBy = [ariaDescribedBy, named ? valueId : undefined].filter(Boolean).join(' ') || undefined\n\n const { refs, floatingStyles, isPositioned } = useAnchored({\n open,\n placement: 'bottom-start',\n gap: 4,\n matchAnchorWidth: true,\n })\n\n const close = useCallback(() => setOpen(false), [])\n // Esc 由 useDismiss 在捕获阶段截停,列表自己的 onDismiss(聚焦触发器)根本收不到;\n // 焦点归还因此必须交给 useDismiss,否则收起后焦点掉到 body(对话框里同样)。\n useDismiss({\n open,\n onDismiss: close,\n floating: refs.floating,\n anchor: triggerRef,\n returnFocus: () => triggerRef.current,\n dismissOnFocusOut: true,\n })\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index]\n if (!option || option.disabled) return\n if (value === undefined) setInternal(option.value)\n onValueChange?.(option.value)\n setOpen(false)\n triggerRef.current?.focus()\n },\n [options, value, onValueChange]\n )\n\n const { active, setActive, onKeyDown } = useListNavigation({\n count: options.length,\n isDisabled: (i) => Boolean(options[i]?.disabled),\n getText: (i) => (typeof options[i]?.label === 'string' ? (options[i]!.label as string) : ''),\n onSelect: choose,\n onDismiss: () => {\n close()\n triggerRef.current?.focus()\n },\n })\n\n // 打开时把活动项放在当前选中项上,并接管键盘。\n useEffect(() => {\n if (!open) return\n setActive(options.findIndex((option) => option.value === current))\n refs.floating.current?.focus()\n }, [open, options, current, setActive, refs.floating])\n\n return (\n <div className={clsx('mh-select', className)} {...rest}>\n <button\n ref={(node) => {\n triggerRef.current = node\n refs.setReference(node)\n }}\n type=\"button\"\n id={triggerId}\n className=\"mh-select__trigger\"\n disabled={disabled}\n aria-label={ariaLabel}\n aria-labelledby={ariaLabelledBy}\n aria-describedby={describedBy}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-controls={open ? listboxId : undefined}\n aria-invalid={invalid || undefined}\n data-invalid={invalid || undefined}\n data-open={open || undefined}\n data-placeholder={selected ? undefined : 'true'}\n onClick={() => !disabled && setOpen(!open)}\n onKeyDown={(event) => {\n // 关闭状态下按方向键直接打开,是原生 select 的习惯。\n if (!open && (event.key === 'ArrowDown' || event.key === 'ArrowUp')) {\n setOpen(true)\n event.preventDefault()\n }\n }}\n >\n <span id={valueId} className=\"mh-select__value\">\n {selected ? selected.label : placeholder}\n </span>\n <Icon className=\"mh-select__chevron\" name=\"chevron-down\" size={16} />\n </button>\n\n {open && (\n <div\n ref={refs.setFloating}\n data-mh-positioned={isPositioned}\n id={listboxId}\n className=\"mh-select__listbox\"\n role=\"listbox\"\n tabIndex={-1}\n aria-labelledby={triggerId}\n // 焦点在列表本身,活动项靠它报给读屏;只有视觉标记时方向键走动是无声的。\n aria-activedescendant={active >= 0 ? optionId(active) : undefined}\n style={floatingStyles}\n onKeyDown={onKeyDown}\n >\n {options.map((option, index) => (\n <div\n key={option.value}\n id={optionId(index)}\n className=\"mh-select__option\"\n role=\"option\"\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={active === index || undefined}\n data-selected={option.value === current || undefined}\n data-disabled={option.disabled || undefined}\n onMouseEnter={() => setActive(index)}\n onClick={() => choose(index)}\n >\n <span className=\"mh-select__option-label\">{option.label}</span>\n {option.value === current && <Icon name=\"check\" size={14} />}\n </div>\n ))}\n </div>\n )}\n </div>\n )\n}\n"],"mappings":"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","names":[]}
@@ -2,6 +2,7 @@
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useId, useRef, useState } from "react";
4
4
  import clsx from "clsx";
5
+ import { DisclosureBody } from "../../../internal/DisclosureBody.js";
5
6
  import { Icon } from "../../../icon/Icon.js";
6
7
  import { rovingTarget } from "../../../internal/use-roving-focus.js";
7
8
  function Accordion({
@@ -13,6 +14,7 @@ function Accordion({
13
14
  className,
14
15
  ...rest
15
16
  }) {
17
+ const trigger = useRef(null);
16
18
  const [internal, setInternal] = useState(defaultOpen);
17
19
  const current = open === void 0 ? internal : open;
18
20
  const baseId = useId();
@@ -54,7 +56,18 @@ function Accordion({
54
56
  ]
55
57
  }
56
58
  ),
57
- expanded && /* @__PURE__ */ jsx("div", { id: contentId, className: "mh-accordion__content", role: "region", "aria-labelledby": triggerId, children: item.content })
59
+ /* @__PURE__ */ jsx(
60
+ DisclosureBody,
61
+ {
62
+ open: expanded,
63
+ trigger: () => triggers.current[index] ?? null,
64
+ id: contentId,
65
+ className: "mh-accordion__content",
66
+ role: "region",
67
+ "aria-labelledby": triggerId,
68
+ children: item.content
69
+ }
70
+ )
58
71
  ] }, item.value);
59
72
  }) });
60
73
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../src/components/foundation/navigation-command/Accordion.tsx"],"sourcesContent":["'use client'\n\nimport { useId, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport { Icon } from '../../../icon/Icon.js'\nimport { rovingTarget } from '../../../internal/use-roving-focus.js'\nimport type {\n AccordionProps,\n AccordionItem,\n} from '../../../../contracts/foundation/navigation-command/accordion.js'\n\nexport type { AccordionProps, AccordionItem }\n\n/**\n * 堆叠式渐进披露,区块之间以 1px 分隔线相隔 —— **无卡片、无阴影**。\n *\n * 用于长表单或详情内容的分组。页面级的区域切换请用 `Tabs`。\n *\n * 契约补齐了受控模式(`open` / `onOpenChange`,04 · N1),源实现只有\n * `defaultOpen` —— 展开状态完全内部持有,无法持久化用户偏好,也无法在\n * 两个 Accordion 之间同步。\n *\n * 无障碍按 WAI-ARIA accordion 模式(06 · P3-12):标题行以 `aria-controls` 指向展开的\n * 内容区,内容区是以标题行命名的 `region`;↑ / ↓ 在标题行间移动焦点、首尾相接,\n * Home / End 跳到首末项。每个标题行仍是各自的 Tab 停靠点 —— 该模式不用 roving。\n * 收起的内容区不渲染,`aria-controls` 只在展开时输出,不指向不存在的节点。\n */\nexport function Accordion({\n items,\n type = 'single',\n open,\n defaultOpen = [],\n onOpenChange,\n className,\n ...rest\n}: AccordionProps) {\n const [internal, setInternal] = useState(defaultOpen)\n const current = open === undefined ? internal : open\n const baseId = useId()\n const triggers = useRef<(HTMLButtonElement | null)[]>([])\n\n const onTriggerKeyDown = (index: number) => (event: ReactKeyboardEvent) => {\n if (event.altKey || event.ctrlKey || event.metaKey) return\n const next = rovingTarget(event.key, index, items.length, undefined, 'vertical')\n if (next === null) return\n event.preventDefault()\n triggers.current[next]?.focus()\n }\n\n const toggle = (value: string) => {\n const next = current.includes(value)\n ? current.filter((x) => x !== value)\n : type === 'single'\n ? [value]\n : [...current, value]\n if (open === undefined) setInternal(next)\n onOpenChange?.(next)\n }\n\n return (\n <div className={clsx('mh-accordion', className)} {...rest}>\n {items.map((item, index) => {\n const expanded = current.includes(item.value)\n const triggerId = `${baseId}-trigger-${index}`\n const contentId = `${baseId}-content-${index}`\n return (\n <div key={item.value} className=\"mh-accordion__section\">\n <button\n ref={(node) => {\n triggers.current[index] = node\n }}\n id={triggerId}\n type=\"button\"\n className=\"mh-accordion__trigger\"\n aria-expanded={expanded}\n aria-controls={expanded ? contentId : undefined}\n data-state={expanded ? 'open' : 'closed'}\n onClick={() => toggle(item.value)}\n onKeyDown={onTriggerKeyDown(index)}\n >\n {item.title}\n <Icon className=\"mh-accordion__chevron\" name=\"chevron-down\" size={14} />\n </button>\n {expanded && (\n <div id={contentId} className=\"mh-accordion__content\" role=\"region\" aria-labelledby={triggerId}>\n {item.content}\n </div>\n )}\n </div>\n )\n })}\n </div>\n )\n}\n"],"mappings":";AAoEY,SAcE,KAdF;AAlEZ,SAAS,OAAO,QAAQ,gBAAgB;AAExC,OAAO,UAAU;AACjB,SAAS,YAAY;AACrB,SAAS,oBAAoB;AAsBtB,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,cAAc,CAAC;AAAA,EACf;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmB;AACjB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,WAAW;AACpD,QAAM,UAAU,SAAS,SAAY,WAAW;AAChD,QAAM,SAAS,MAAM;AACrB,QAAM,WAAW,OAAqC,CAAC,CAAC;AAExD,QAAM,mBAAmB,CAAC,UAAkB,CAAC,UAA8B;AACzE,QAAI,MAAM,UAAU,MAAM,WAAW,MAAM,QAAS;AACpD,UAAM,OAAO,aAAa,MAAM,KAAK,OAAO,MAAM,QAAQ,QAAW,UAAU;AAC/E,QAAI,SAAS,KAAM;AACnB,UAAM,eAAe;AACrB,aAAS,QAAQ,IAAI,GAAG,MAAM;AAAA,EAChC;AAEA,QAAM,SAAS,CAAC,UAAkB;AAChC,UAAM,OAAO,QAAQ,SAAS,KAAK,IAC/B,QAAQ,OAAO,CAAC,MAAM,MAAM,KAAK,IACjC,SAAS,WACP,CAAC,KAAK,IACN,CAAC,GAAG,SAAS,KAAK;AACxB,QAAI,SAAS,OAAW,aAAY,IAAI;AACxC,mBAAe,IAAI;AAAA,EACrB;AAEA,SACE,oBAAC,SAAI,WAAW,KAAK,gBAAgB,SAAS,GAAI,GAAG,MAClD,gBAAM,IAAI,CAAC,MAAM,UAAU;AAC1B,UAAM,WAAW,QAAQ,SAAS,KAAK,KAAK;AAC5C,UAAM,YAAY,GAAG,MAAM,YAAY,KAAK;AAC5C,UAAM,YAAY,GAAG,MAAM,YAAY,KAAK;AAC5C,WACE,qBAAC,SAAqB,WAAU,yBAC9B;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,KAAK,CAAC,SAAS;AACb,qBAAS,QAAQ,KAAK,IAAI;AAAA,UAC5B;AAAA,UACA,IAAI;AAAA,UACJ,MAAK;AAAA,UACL,WAAU;AAAA,UACV,iBAAe;AAAA,UACf,iBAAe,WAAW,YAAY;AAAA,UACtC,cAAY,WAAW,SAAS;AAAA,UAChC,SAAS,MAAM,OAAO,KAAK,KAAK;AAAA,UAChC,WAAW,iBAAiB,KAAK;AAAA,UAEhC;AAAA,iBAAK;AAAA,YACN,oBAAC,QAAK,WAAU,yBAAwB,MAAK,gBAAe,MAAM,IAAI;AAAA;AAAA;AAAA,MACxE;AAAA,MACC,YACC,oBAAC,SAAI,IAAI,WAAW,WAAU,yBAAwB,MAAK,UAAS,mBAAiB,WAClF,eAAK,SACR;AAAA,SApBM,KAAK,KAsBf;AAAA,EAEJ,CAAC,GACH;AAEJ;","names":[]}
1
+ {"version":3,"sources":["../../../../src/components/foundation/navigation-command/Accordion.tsx"],"sourcesContent":["'use client'\n\nimport { useId, useRef, useState } from 'react'\nimport type { KeyboardEvent as ReactKeyboardEvent } from 'react'\nimport clsx from 'clsx'\nimport { DisclosureBody } from '../../../internal/DisclosureBody.js'\nimport { Icon } from '../../../icon/Icon.js'\nimport { rovingTarget } from '../../../internal/use-roving-focus.js'\nimport type {\n AccordionProps,\n AccordionItem,\n} from '../../../../contracts/foundation/navigation-command/accordion.js'\n\nexport type { AccordionProps, AccordionItem }\n\n/**\n * 堆叠式渐进披露,区块之间以 1px 分隔线相隔 —— **无卡片、无阴影**。\n *\n * 用于长表单或详情内容的分组。页面级的区域切换请用 `Tabs`。\n *\n * 契约补齐了受控模式(`open` / `onOpenChange`,04 · N1),源实现只有\n * `defaultOpen` —— 展开状态完全内部持有,无法持久化用户偏好,也无法在\n * 两个 Accordion 之间同步。\n *\n * 无障碍按 WAI-ARIA accordion 模式(06 · P3-12):标题行以 `aria-controls` 指向展开的\n * 内容区,内容区是以标题行命名的 `region`;↑ / ↓ 在标题行间移动焦点、首尾相接,\n * Home / End 跳到首末项。每个标题行仍是各自的 Tab 停靠点 —— 该模式不用 roving。\n * 收起的内容区不渲染,`aria-controls` 只在展开时输出,不指向不存在的节点。\n */\nexport function Accordion({\n items,\n type = 'single',\n open,\n defaultOpen = [],\n onOpenChange,\n className,\n ...rest\n}: AccordionProps) {\n const trigger = useRef<HTMLButtonElement>(null)\n const [internal, setInternal] = useState(defaultOpen)\n const current = open === undefined ? internal : open\n const baseId = useId()\n const triggers = useRef<(HTMLButtonElement | null)[]>([])\n\n const onTriggerKeyDown = (index: number) => (event: ReactKeyboardEvent) => {\n if (event.altKey || event.ctrlKey || event.metaKey) return\n const next = rovingTarget(event.key, index, items.length, undefined, 'vertical')\n if (next === null) return\n event.preventDefault()\n triggers.current[next]?.focus()\n }\n\n const toggle = (value: string) => {\n const next = current.includes(value)\n ? current.filter((x) => x !== value)\n : type === 'single'\n ? [value]\n : [...current, value]\n if (open === undefined) setInternal(next)\n onOpenChange?.(next)\n }\n\n return (\n <div className={clsx('mh-accordion', className)} {...rest}>\n {items.map((item, index) => {\n const expanded = current.includes(item.value)\n const triggerId = `${baseId}-trigger-${index}`\n const contentId = `${baseId}-content-${index}`\n return (\n <div key={item.value} className=\"mh-accordion__section\">\n <button\n ref={(node) => {\n triggers.current[index] = node\n }}\n id={triggerId}\n type=\"button\"\n className=\"mh-accordion__trigger\"\n aria-expanded={expanded}\n aria-controls={expanded ? contentId : undefined}\n data-state={expanded ? 'open' : 'closed'}\n onClick={() => toggle(item.value)}\n onKeyDown={onTriggerKeyDown(index)}\n >\n {item.title}\n <Icon className=\"mh-accordion__chevron\" name=\"chevron-down\" size={14} />\n </button>\n <DisclosureBody\n open={expanded}\n trigger={() => triggers.current[index] ?? null}\n id={contentId}\n className=\"mh-accordion__content\"\n role=\"region\"\n aria-labelledby={triggerId}\n >\n {item.content}\n </DisclosureBody>\n </div>\n )\n })}\n </div>\n )\n}\n"],"mappings":";AAsEY,SAcE,KAdF;AApEZ,SAAS,OAAO,QAAQ,gBAAgB;AAExC,OAAO,UAAU;AACjB,SAAS,sBAAsB;AAC/B,SAAS,YAAY;AACrB,SAAS,oBAAoB;AAsBtB,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,cAAc,CAAC;AAAA,EACf;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmB;AACjB,QAAM,UAAU,OAA0B,IAAI;AAC9C,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,WAAW;AACpD,QAAM,UAAU,SAAS,SAAY,WAAW;AAChD,QAAM,SAAS,MAAM;AACrB,QAAM,WAAW,OAAqC,CAAC,CAAC;AAExD,QAAM,mBAAmB,CAAC,UAAkB,CAAC,UAA8B;AACzE,QAAI,MAAM,UAAU,MAAM,WAAW,MAAM,QAAS;AACpD,UAAM,OAAO,aAAa,MAAM,KAAK,OAAO,MAAM,QAAQ,QAAW,UAAU;AAC/E,QAAI,SAAS,KAAM;AACnB,UAAM,eAAe;AACrB,aAAS,QAAQ,IAAI,GAAG,MAAM;AAAA,EAChC;AAEA,QAAM,SAAS,CAAC,UAAkB;AAChC,UAAM,OAAO,QAAQ,SAAS,KAAK,IAC/B,QAAQ,OAAO,CAAC,MAAM,MAAM,KAAK,IACjC,SAAS,WACP,CAAC,KAAK,IACN,CAAC,GAAG,SAAS,KAAK;AACxB,QAAI,SAAS,OAAW,aAAY,IAAI;AACxC,mBAAe,IAAI;AAAA,EACrB;AAEA,SACE,oBAAC,SAAI,WAAW,KAAK,gBAAgB,SAAS,GAAI,GAAG,MAClD,gBAAM,IAAI,CAAC,MAAM,UAAU;AAC1B,UAAM,WAAW,QAAQ,SAAS,KAAK,KAAK;AAC5C,UAAM,YAAY,GAAG,MAAM,YAAY,KAAK;AAC5C,UAAM,YAAY,GAAG,MAAM,YAAY,KAAK;AAC5C,WACE,qBAAC,SAAqB,WAAU,yBAC9B;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,KAAK,CAAC,SAAS;AACb,qBAAS,QAAQ,KAAK,IAAI;AAAA,UAC5B;AAAA,UACA,IAAI;AAAA,UACJ,MAAK;AAAA,UACL,WAAU;AAAA,UACV,iBAAe;AAAA,UACf,iBAAe,WAAW,YAAY;AAAA,UACtC,cAAY,WAAW,SAAS;AAAA,UAChC,SAAS,MAAM,OAAO,KAAK,KAAK;AAAA,UAChC,WAAW,iBAAiB,KAAK;AAAA,UAEhC;AAAA,iBAAK;AAAA,YACN,oBAAC,QAAK,WAAU,yBAAwB,MAAK,gBAAe,MAAM,IAAI;AAAA;AAAA;AAAA,MACxE;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,MAAM;AAAA,UACN,SAAS,MAAM,SAAS,QAAQ,KAAK,KAAK;AAAA,UAC1C,IAAI;AAAA,UACJ,WAAU;AAAA,UACV,MAAK;AAAA,UACL,mBAAiB;AAAA,UAEhB,eAAK;AAAA;AAAA,MACR;AAAA,SA1BQ,KAAK,KA2Bf;AAAA,EAEJ,CAAC,GACH;AAEJ;","names":[]}
@@ -9,7 +9,9 @@ function pageWindow(page, total) {
9
9
  const sorted = [...wanted].sort((a, b) => a - b);
10
10
  const slots = [];
11
11
  sorted.forEach((p, i) => {
12
- if (i > 0 && p - sorted[i - 1] > 1) slots.push(null);
12
+ const gap = i > 0 ? p - sorted[i - 1] : 1;
13
+ if (gap === 2) slots.push(p - 1);
14
+ else if (gap > 2) slots.push(null);
13
15
  slots.push(p);
14
16
  });
15
17
  return slots;