@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/context-menu/context-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.js","names":["mergeVueProps","mergeProps"],"sources":["../../../src/components/context-menu/context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context menu 相关实现。\n\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { ContextMenuAnyItemProps, ContextMenuApi, ContextMenuGroupProps, ContextMenuNode, ContextMenuNodeMeta, ContextMenuRadioValue, ContextMenuSchema, MenuApi, MenuNode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { groupAdjacentRuns, mergeProps } from '@xihan-ui/core'\nimport { computed, defineComponent, h, mergeProps as mergeVueProps, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideMenu, useMenuContext } from '../menu/context'\nimport { MenuDefaultNodes, XhMenuContent, XhMenuPositioner } from '../menu/menu'\nimport { useMenuWithParent } from '../menu/use-menu'\nimport {\n  provideContextMenu,\n  provideContextMenuGroup,\n  provideContextMenuItem,\n  provideContextMenuSub,\n  useContextMenuContext,\n  useContextMenuGroupContext,\n  useContextMenuItemContext,\n  useContextMenuSubContext,\n} from './context'\nimport { useContextMenu } from './use-context-menu'\n\ntype ContextMenuProps = ContextMenuSchema['props']\n\n/** 默认插槽的载荷：右键菜单的展开态与锚点坐标，以及开合、按坐标展开的命令。 */\nexport type ContextMenuRootSlotProps = Pick<ContextMenuApi, 'open' | 'point' | 'setOpen' | 'openAt' | 'checkboxValue' | 'radioValue' | 'setCheckboxValue' | 'setRadioValue'>\n\n/** 子菜单默认插槽的载荷：该层子菜单自己的展开态与开合命令。 */\nexport type ContextMenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\n/** 代铺条目时可逐槽接管的三个插槽；三个都不写即完全按数据铺。 */\nexport interface ContextMenuItemSlots {\n  /** 只填条目的文字槽，其余槽照旧由数据铺。 */\n  item?: (node: ContextMenuNodeMeta) => VNode[]\n  /** 只接管行首那一格，其余槽照旧由数据铺。 */\n  ['item-prefix']?: (node: ContextMenuNodeMeta) => VNode[]\n  /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺。 */\n  ['item-suffix']?: (node: ContextMenuNodeMeta) => VNode[]\n}\n\nexport const XhContextMenuRoot = defineComponent({\n  name: 'XhContextMenuRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ContextMenuNode[]> },\n    checkboxValue: { type: Array as PropType<string[]> },\n    defaultCheckboxValue: { type: Array as PropType<string[]> },\n    radioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    defaultRadioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<ContextMenuProps['translations']> },\n    dir: { type: String as PropType<Direction> },\n    longPressDelay: { type: Number },\n    /** 整张菜单禁用：不再展开，浏览器自己的右键菜单照常出现。 */\n    disabled: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<ContextMenuProps, 'onOpenChange'>) => true,\n    'select': (_details: PayloadOf<ContextMenuProps, 'onSelect'>) => true,\n    'checkbox-value-change': (_details: PayloadOf<ContextMenuProps, 'onCheckboxValueChange'>) => true,\n    'radio-value-change': (_details: PayloadOf<ContextMenuProps, 'onRadioValueChange'>) => true,\n    'update:open': (_open: PayloadOf<ContextMenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ContextMenuRootSlotProps) => VNode[]\n    'trigger'?: () => VNode[]\n    /** 只填条目的文字槽，标记位、副文本与快捷键照旧由数据铺 */\n    'item'?: (node: ContextMenuNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ContextMenuNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ContextMenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit, expose }) {\n    const notifyOpen: ContextMenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifySelect: ContextMenuProps['onSelect'] = details => emit('select', details)\n    const ctx = useContextMenu(\n      withXhConfig('context-menu', props) as ContextMenuProps,\n      notifyOpen,\n      notifySelect,\n      details => emit('checkbox-value-change', details),\n      details => emit('radio-value-change', details),\n    )\n    provideContextMenu(ctx)\n    // 菜单钉在坐标上，坐标只能由 openAt 交进来。默认插槽那条路从载荷里拿，\n    // 只交 collection 的那条路没有载荷，所以同一组命令也从实例上暴露一份。\n    expose({\n      openAt: (x: number, y: number) => ctx.api.value.openAt(x, y),\n      setOpen: (open: boolean) => ctx.api.value.setOpen(open),\n      get open() {\n        return ctx.api.value.open\n      },\n      get point() {\n        return ctx.api.value.point\n      },\n    })\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default({\n            open: ctx.api.value.open,\n            point: ctx.api.value.point,\n            setOpen: ctx.api.value.setOpen,\n            openAt: ctx.api.value.openAt,\n            checkboxValue: ctx.api.value.checkboxValue,\n            radioValue: ctx.api.value.radioValue,\n            setCheckboxValue: ctx.api.value.setCheckboxValue,\n            setRadioValue: ctx.api.value.setRadioValue,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, { 'item': slots.item, 'item-prefix': slots['item-prefix'], 'item-suffix': slots['item-suffix'] })\n          : [],\n    )\n  },\n})\n\nexport const XhContextMenuTrigger = defineComponent({\n  name: 'XhContextMenuTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useContextMenuContext()\n    // 触发区渲染为 div，语义由 connect 打上的 ARIA 属性给出\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'context-menu')\n        if (merged)\n          return merged\n      }\n      return h('div', part, children)\n    }\n  },\n})\n\nexport const XhContextMenuPositioner = defineComponent({\n  name: 'XhContextMenuPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useContextMenuContext()\n    // 条目列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    // 浮层里的条子走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeVueProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhContextMenuContent = defineComponent({\n  name: 'XhContextMenuContent',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroup = defineComponent({\n  name: 'XhContextMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuRadioGroup = defineComponent({\n  name: 'XhContextMenuRadioGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getRadioGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroupLabel = defineComponent({\n  name: 'XhContextMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { group } = useContextMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nfunction createContextMenuItemComponent(name: string, kind: 'item' | 'checkbox' | 'radio'): ReturnType<typeof defineComponent> {\n  return defineComponent({\n    name,\n    props: {\n      value: { type: String, required: true },\n      disabled: { type: Boolean, default: undefined },\n      closeOnSelect: { type: Boolean, default: undefined },\n    },\n    setup(props, { slots }) {\n      const ctx = useContextMenuContext()\n      const radioGroup = kind === 'radio' ? useContextMenuGroupContext() : null\n      const item = computed<ContextMenuAnyItemProps>(() => kind === 'radio'\n        ? { value: props.value, disabled: props.disabled, closeOnSelect: props.closeOnSelect, kind, group: radioGroup!.group.value.value }\n        : kind === 'checkbox'\n          ? { value: props.value, disabled: props.disabled, closeOnSelect: props.closeOnSelect, kind }\n          : { value: props.value, disabled: props.disabled, kind })\n      provideContextMenuItem({ item })\n      // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n      const itemEl = ref<HTMLElement | null>(null)\n      watch(() => props.value, (next, prev) => {\n        if (next === prev)\n          return\n        const { service } = ctx\n        if (service.getStatus() !== 'Started')\n          return\n        if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n          service.send({ type: 'ITEM.FOCUS', value: next })\n      })\n      onBeforeUnmount(() => {\n        const { service } = ctx\n        // 根已停机时不再送事件\n        if (service.getStatus() !== 'Started')\n          return\n        // 按「本节点当下正持有焦点」判定，不按 value 比对\n        if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n          service.send({ type: 'ITEM.LOST' })\n      })\n      return () => {\n        const declaration = item.value\n        const part = declaration.kind === 'checkbox'\n          ? ctx.api.value.getCheckboxItemProps(declaration)\n          : declaration.kind === 'radio'\n            ? ctx.api.value.getRadioItemProps(declaration)\n            : ctx.api.value.getItemProps(declaration)\n        return h('div', { ...part as Record<string, unknown>, ref: itemEl }, slots.default?.())\n      }\n    },\n  })\n}\n\nexport const XhContextMenuItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuItem', 'item')\nexport const XhContextMenuCheckboxItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuCheckboxItem', 'checkbox')\nexport const XhContextMenuRadioItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuRadioItem', 'radio')\n\n/**\n * 右键菜单中的子菜单：子层运行一台 submenu 模式的 menu 状态机，触发条目由\n * XhContextMenuSubTrigger 渲染为父层条目与子层触发器的双重身份。\n * 子层内部使用 XhMenu 系部件（再往深嵌套即 menu 嵌套 menu）。本身不渲染节点。\n */\nexport const XhContextMenuSub = defineComponent({\n  name: 'XhContextMenuSub',\n  props: {\n    /** 它在父右键菜单中的条目身份。 */\n    value: { type: String, required: true },\n    disabled: { type: Boolean, default: undefined },\n    /** 子层的条目数据：显示文本与禁用的事实源，按数据铺子层时由默认树代填。 */\n    collection: { type: Array as PropType<MenuNode[]> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number },\n    /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */\n    dir: { type: String as PropType<Direction> },\n    /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */\n    tone: { type: String as PropType<Tone> },\n    /** 尺寸；默认继承父层，理由同 tone。 */\n    size: { type: String as PropType<Size> },\n    hoverCloseDelay: { type: Number },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ContextMenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const parent = useContextMenuContext()\n    const sub = useMenuWithParent(\n      {\n        ...props,\n        submenu: true,\n        dir: props.dir ?? parent.service.prop('dir'),\n        tone: props.tone ?? parent.service.prop('tone'),\n        size: props.size ?? parent.service.prop('size'),\n      },\n      undefined,\n      parent.tree,\n    )\n    // 子树内的 XhMenu 系部件都归子机器\n    provideMenu(sub)\n    provideContextMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        sub.api.value.setOpen(false)\n    })\n    return () => slots.default?.({ open: sub.api.value.open, setOpen: sub.api.value.setOpen })\n  },\n})\n\nexport const XhContextMenuSubTrigger = defineComponent({\n  name: 'XhContextMenuSubTrigger',\n  setup(_, { slots }) {\n    const handle = useContextMenuSubContext()\n    const sub = useMenuContext()\n    return () => h('div', {\n      // 合并序=子先父后：父层的 data-scope/data-part 胜出，父层的方向键与选中照常认它\n      ...mergeProps(\n        sub.api.value.getSubmenuTriggerProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n        handle.parent.api.value.getItemProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        sub.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemText = defineComponent({\n  name: 'XhContextMenuItemText',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemIndicator = defineComponent({\n  name: 'XhContextMenuItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的副文本，排在文字下一行 */\nexport const XhContextMenuItemDescription = defineComponent({\n  name: 'XhContextMenuItemDescription',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的快捷键提示，贴行尾；纯装饰，读屏从条目文字取意 */\nexport const XhContextMenuItemShortcut = defineComponent({\n  name: 'XhContextMenuItemShortcut',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemShortcutProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标、次级图标）；家族只管落位，不规定字号与颜色 */\nexport const XhContextMenuItemSuffix = defineComponent({\n  name: 'XhContextMenuItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuSeparator = defineComponent({\n  name: 'XhContextMenuSeparator',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhContextMenuArrow = defineComponent({\n  name: 'XhContextMenuArrow',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/** 一段连续的同组条目；不分组的条目各自单独成段。 */\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 触发区中放置的内容由作者决定，经 trigger 插槽给出。\n */\nfunction renderDefaultTree(\n  collection: readonly ContextMenuNodeMeta[],\n  trigger: (VNode | string)[] | null,\n  itemSlots: ContextMenuItemSlots,\n): VNode[] {\n  return [\n    h(XhContextMenuTrigger, null, () => trigger ?? []),\n    h(XhContextMenuPositioner, null, () => [\n      h(XhContextMenuContent, null, () => renderNodes(collection, itemSlots)),\n    ]),\n  ]\n}\n\n/** content 的内容：分组段铺为 group，段首的分隔线落在 group 外面。 */\nfunction renderNodes(\n  collection: readonly ContextMenuNodeMeta[],\n  itemSlots: ContextMenuItemSlots,\n): VNode[] {\n  return groupAdjacentRuns(collection, node => node.group).flatMap((run, runIndex) => {\n    const head = run[0]\n    // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n    const lead = runIndex > 0 && head.separatorBefore\n      ? [h(XhContextMenuSeparator, { key: `separator:${head.value}` })]\n      : []\n    if (head.group == null)\n      return [...lead, renderItem(head, itemSlots)]\n    const groupLabel = run.find(node => node.groupLabel != null)?.groupLabel ?? null\n    return [\n      ...lead,\n      h(head.kind === 'radio' ? XhContextMenuRadioGroup : XhContextMenuGroup, { key: `group:${head.group}`, value: head.group }, () => [\n        ...(groupLabel != null ? [h(XhContextMenuGroupLabel, null, () => groupLabel)] : []),\n        ...run.flatMap((node, index) => [\n          ...(index > 0 && node.separatorBefore ? [h(XhContextMenuSeparator, { key: `separator:${node.value}` })] : []),\n          renderItem(node, itemSlots),\n        ]),\n      ]),\n    ]\n  })\n}\n\n/**\n * 单个条目：标记位排在文字前面，未提供标记位时不铺该部件。\n * `item-prefix` / `item-suffix` 插槽各接管首尾一格，其余槽照旧由数据铺；\n * 行首那一格与数据里的 `indicator` 同一个部件，插槽在场时以它为准。\n */\nfunction renderItem(\n  meta: ContextMenuNodeMeta,\n  itemSlots: ContextMenuItemSlots,\n): VNode {\n  // 带 children 的条目铺成子菜单：子层跑的是 menu 机器，条目按数据铺、不经本层的插槽\n  if (meta.children) {\n    return h(XhContextMenuSub, { key: meta.value, value: meta.value, disabled: meta.disabled || undefined, collection: meta.children as MenuNode[] }, () => [\n      h(XhContextMenuSubTrigger, null, () => [meta.label]),\n      h(XhMenuPositioner, null, () => [h(XhMenuContent, null, () => [h(MenuDefaultNodes)])]),\n    ])\n  }\n  const prefix = itemSlots['item-prefix']\n  const suffix = itemSlots['item-suffix']\n  const Item = meta.kind === 'checkbox' ? XhContextMenuCheckboxItem : meta.kind === 'radio' ? XhContextMenuRadioItem : XhContextMenuItem\n  return h(Item, { key: meta.value, value: meta.value, closeOnSelect: meta.closeOnSelect }, () => [\n    ...(prefix\n      ? [h(XhContextMenuItemIndicator, null, () => prefix(meta))]\n      : meta.indicator != null\n        ? [h(XhContextMenuItemIndicator, null, () => meta.indicator)]\n        : meta.kind !== 'item' ? [h(XhContextMenuItemIndicator)] : []),\n    h(XhContextMenuItemText, null, () => itemSlots.item?.(meta) ?? meta.label),\n    ...(meta.description != null ? [h(XhContextMenuItemDescription, null, () => meta.description)] : []),\n    ...(meta.shortcut != null ? [h(XhContextMenuItemShortcut, null, () => meta.shortcut)] : []),\n    ...(suffix ? [h(XhContextMenuItemSuffix, null, () => suffix(meta))] : []),\n  ])\n}\n"],"mappings":"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"}
+{"version":3,"file":"context-menu.js","names":["mergeVueProps","mergeProps"],"sources":["../../../src/components/context-menu/context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context menu 相关实现。\n\nimport type { Direction, IconRecord, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { ContextMenuAnyItemProps, ContextMenuApi, ContextMenuGroupProps, ContextMenuNode, ContextMenuNodeMeta, ContextMenuRadioValue, ContextMenuSchema, MenuApi, MenuNode, MenuSchema, StructureNode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { mergeProps } from '@xihan-ui/core'\nimport { contextMenuStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps as mergeVueProps, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { liveProps } from '../../runtime/live-props'\nimport { mergePartProps, withoutScopeClass, withoutUndefined } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { XhIcon } from '../icon/icon'\nimport { provideMenu, provideMenuItem, useMenuContext } from '../menu/context'\nimport { MenuDefaultNodes, XhMenuContent, XhMenuItemIcon, XhMenuItemText, XhMenuPositioner } from '../menu/menu'\nimport { useMenuWithParent } from '../menu/use-menu'\nimport {\n  provideContextMenu,\n  provideContextMenuGroup,\n  provideContextMenuItem,\n  provideContextMenuSub,\n  useContextMenuContext,\n  useContextMenuGroupContext,\n  useContextMenuItemContext,\n  useContextMenuSubContext,\n} from './context'\nimport { useContextMenu } from './use-context-menu'\n\ntype ContextMenuProps = ContextMenuSchema['props']\n\n/** 默认插槽的载荷：右键菜单的展开态与锚点坐标，以及开合、按坐标展开的命令。 */\nexport type ContextMenuRootSlotProps = Pick<ContextMenuApi, 'open' | 'point' | 'setOpen' | 'openAt' | 'checkboxValue' | 'radioValue' | 'setCheckboxValue' | 'setRadioValue'>\n\n/** 子菜单默认插槽的载荷：该层子菜单自己的展开态与开合命令。 */\nexport type ContextMenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\n/** 代铺条目时可逐槽接管的三个插槽；三个都不写即完全按数据铺。 */\nexport interface ContextMenuItemSlots {\n  /** 只填条目的文字槽，其余槽照旧由数据铺。 */\n  item?: (node: ContextMenuNodeMeta) => VNode[]\n  /** 只接管行首那一格，其余槽照旧由数据铺。 */\n  ['item-prefix']?: (node: ContextMenuNodeMeta) => VNode[]\n  /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺。 */\n  ['item-suffix']?: (node: ContextMenuNodeMeta) => VNode[]\n}\n\nexport const XhContextMenuRoot = defineComponent({\n  name: 'XhContextMenuRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ContextMenuNode[]> },\n    checkboxValue: { type: Array as PropType<string[]> },\n    defaultCheckboxValue: { type: Array as PropType<string[]> },\n    radioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    defaultRadioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<ContextMenuProps['translations']> },\n    dir: { type: String as PropType<Direction> },\n    longPressDelay: { type: Number },\n    /** 整张菜单禁用：不再展开，浏览器自己的右键菜单照常出现。 */\n    disabled: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<ContextMenuProps, 'onOpenChange'>) => true,\n    'item-select': (_details: PayloadOf<ContextMenuProps, 'onItemSelect'>) => true,\n    'checkbox-value-change': (_details: PayloadOf<ContextMenuProps, 'onCheckboxValueChange'>) => true,\n    'radio-value-change': (_details: PayloadOf<ContextMenuProps, 'onRadioValueChange'>) => true,\n    'update:open': (_open: PayloadOf<ContextMenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ContextMenuRootSlotProps) => VNode[]\n    'trigger'?: () => VNode[]\n    /** 只填条目的文字槽，标记位、副文本与快捷键照旧由数据铺 */\n    'item'?: (node: ContextMenuNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ContextMenuNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ContextMenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit, expose }) {\n    const notifyOpen: ContextMenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifyItemSelect: ContextMenuProps['onItemSelect'] = details => emit('item-select', details)\n    const ctx = useContextMenu(\n      withXhConfig('context-menu', props) as ContextMenuProps,\n      notifyOpen,\n      notifyItemSelect,\n      details => emit('checkbox-value-change', details),\n      details => emit('radio-value-change', details),\n    )\n    provideContextMenu(ctx)\n    // 菜单钉在坐标上，坐标只能由 openAt 交进来。默认插槽那条路从载荷里拿，\n    // 只交 collection 的那条路没有载荷，所以同一组命令也从实例上暴露一份。\n    expose({\n      openAt: (x: number, y: number) => ctx.api.value.openAt(x, y),\n      setOpen: (open: boolean) => ctx.api.value.setOpen(open),\n      get open() {\n        return ctx.api.value.open\n      },\n      get point() {\n        return ctx.api.value.point\n      },\n    })\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default({\n            open: ctx.api.value.open,\n            point: ctx.api.value.point,\n            setOpen: ctx.api.value.setOpen,\n            openAt: ctx.api.value.openAt,\n            checkboxValue: ctx.api.value.checkboxValue,\n            radioValue: ctx.api.value.radioValue,\n            setCheckboxValue: ctx.api.value.setCheckboxValue,\n            setRadioValue: ctx.api.value.setRadioValue,\n          })\n        : renderDefaultStructure(ctx.api.value, slots.trigger, { 'item': slots.item, 'item-prefix': slots['item-prefix'], 'item-suffix': slots['item-suffix'] }),\n    )\n  },\n})\n\nexport const XhContextMenuTrigger = defineComponent({\n  name: 'XhContextMenuTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useContextMenuContext()\n    // 触发区渲染为 div，语义由 connect 打上的 ARIA 属性给出\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'context-menu')\n        if (merged)\n          return merged\n      }\n      return h('div', part, children)\n    }\n  },\n})\n\nexport const XhContextMenuPositioner = defineComponent({\n  name: 'XhContextMenuPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useContextMenuContext()\n    // 条目列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    // 浮层里的条子走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeVueProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhContextMenuContent = defineComponent({\n  name: 'XhContextMenuContent',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroup = defineComponent({\n  name: 'XhContextMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuRadioGroup = defineComponent({\n  name: 'XhContextMenuRadioGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getRadioGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroupLabel = defineComponent({\n  name: 'XhContextMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { group } = useContextMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nfunction createContextMenuItemComponent(name: string, kind: 'item' | 'checkbox' | 'radio'): ReturnType<typeof defineComponent> {\n  return defineComponent({\n    name,\n    props: {\n      value: { type: String, required: true },\n      disabled: { type: Boolean, default: undefined },\n      closeOnSelect: { type: Boolean, default: undefined },\n    },\n    setup(props, { slots }) {\n      const ctx = useContextMenuContext()\n      const radioGroup = kind === 'radio' ? useContextMenuGroupContext() : null\n      const item = computed<ContextMenuAnyItemProps>(() => kind === 'radio'\n        ? { value: props.value, disabled: props.disabled, closeOnSelect: props.closeOnSelect, kind, group: radioGroup!.group.value.value }\n        : kind === 'checkbox'\n          ? { value: props.value, disabled: props.disabled, closeOnSelect: props.closeOnSelect, kind }\n          : { value: props.value, disabled: props.disabled, kind })\n      provideContextMenuItem({ item })\n      // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n      const itemEl = ref<HTMLElement | null>(null)\n      watch(() => props.value, (next, prev) => {\n        if (next === prev)\n          return\n        const { service } = ctx\n        if (service.getStatus() !== 'Started')\n          return\n        if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n          service.send({ type: 'ITEM.FOCUS', value: next })\n      })\n      onBeforeUnmount(() => {\n        const { service } = ctx\n        // 根已停机时不再送事件\n        if (service.getStatus() !== 'Started')\n          return\n        // 按「本节点当下正持有焦点」判定，不按 value 比对\n        if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n          service.send({ type: 'ITEM.LOST' })\n      })\n      return () => {\n        const declaration = item.value\n        const part = declaration.kind === 'checkbox'\n          ? ctx.api.value.getCheckboxItemProps(declaration)\n          : declaration.kind === 'radio'\n            ? ctx.api.value.getRadioItemProps(declaration)\n            : ctx.api.value.getItemProps(declaration)\n        return h('div', { ...part as Record<string, unknown>, ref: itemEl }, slots.default?.())\n      }\n    },\n  })\n}\n\nexport const XhContextMenuItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuItem', 'item')\nexport const XhContextMenuCheckboxItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuCheckboxItem', 'checkbox')\nexport const XhContextMenuRadioItem = /* @__PURE__ */ createContextMenuItemComponent('XhContextMenuRadioItem', 'radio')\n\n/**\n * 右键菜单中的子菜单：子层运行一台 submenu 模式的 menu 状态机，触发条目由\n * XhContextMenuSubTrigger 渲染为父层条目与子层触发器的双重身份。\n * 子层内部使用 XhMenu 系部件（再往深嵌套即 menu 嵌套 menu）。本身不渲染节点。\n */\nexport const XhContextMenuSub = defineComponent({\n  name: 'XhContextMenuSub',\n  // 本身不渲染节点，作为组合节点收到的 submenu 等标记无处可落\n  inheritAttrs: false,\n  props: {\n    /** 它在父右键菜单中的条目身份。 */\n    value: { type: String, required: true },\n    /** 按数据铺设时触发条目的文字；缺省取父层 collection 里这一条的 label。 */\n    label: { type: String },\n    /** 按数据铺设时触发条目的图标；缺省取父层 collection 里这一条的 icon。 */\n    icon: { type: Object as PropType<IconRecord> },\n    disabled: { type: Boolean, default: undefined },\n    /** 子层的条目数据：显示文本与禁用的事实源，按数据铺子层时由默认树代填。 */\n    collection: { type: Array as PropType<MenuNode[]> },\n    checkboxValue: { type: Array as PropType<string[]> },\n    defaultCheckboxValue: { type: Array as PropType<string[]> },\n    radioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    defaultRadioValue: { type: Object as PropType<ContextMenuRadioValue> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number },\n    /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */\n    dir: { type: String as PropType<Direction> },\n    /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */\n    tone: { type: String as PropType<Tone> },\n    /** 尺寸；默认继承父层，理由同 tone。 */\n    size: { type: String as PropType<Size> },\n    hoverCloseDelay: { type: Number },\n  },\n  emits: {\n    'checkbox-value-change': (_details: PayloadOf<MenuSchema['props'], 'onCheckboxValueChange'>) => true,\n    'radio-value-change': (_details: PayloadOf<MenuSchema['props'], 'onRadioValueChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ContextMenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const parent = useContextMenuContext()\n    const sub = useMenuWithParent(\n      // 子层的 props 按 getter 现取：宿主换数据（子层的 collection、勾选与单选值）时子机器跟着变\n      liveProps(() => ({\n        ...props,\n        submenu: true,\n        dir: props.dir ?? parent.service.prop('dir'),\n        tone: props.tone ?? parent.service.prop('tone'),\n        size: props.size ?? parent.service.prop('size'),\n      })),\n      undefined,\n      parent.tree,\n      details => emit('checkbox-value-change', details),\n      details => emit('radio-value-change', details),\n    )\n    // 子树内的 XhMenu 系部件都归子机器\n    provideMenu(sub)\n    provideContextMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        sub.api.value.setOpen(false)\n    })\n    return () => slots.default\n      ? slots.default({ open: sub.api.value.open, setOpen: sub.api.value.setOpen })\n      : renderSubLayer(props.label ?? parent.api.value.collection.find(node => node.value === props.value)?.label ?? props.value, props.icon ?? parent.api.value.collection.find(node => node.value === props.value)?.icon ?? null)\n  },\n})\n\nexport const XhContextMenuSubTrigger = defineComponent({\n  name: 'XhContextMenuSubTrigger',\n  setup(_, { slots }) {\n    const handle = useContextMenuSubContext()\n    const sub = useMenuContext()\n    // 入口里的图标与文字部件归子菜单那台机器，身份是这一条\n    provideMenuItem({ item: computed(() => ({ value: handle.value, disabled: handle.disabled })) })\n    return () => h('div', {\n      // 合并序=子先父后：父层的 data-scope/data-part 胜出，父层的方向键与选中照常认它\n      // 子层的挂载类让给父层：节点只认父层那一个 scope，两个挂载类都挂着，菜单条目的皮肤也会落到它身上\n      ...mergeProps(\n        withoutScopeClass(sub.api.value.getSubmenuTriggerProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>),\n        // 父层没给的键不盖掉子层给的：子层的 data-state、aria-expanded 等照留\n        withoutUndefined(handle.parent.api.value.getItemProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>),\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        sub.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemText = defineComponent({\n  name: 'XhContextMenuItemText',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemIndicator = defineComponent({\n  name: 'XhContextMenuItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的副文本，排在文字下一行 */\nexport const XhContextMenuItemDescription = defineComponent({\n  name: 'XhContextMenuItemDescription',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目文字之前的图标格；装饰态，读屏从条目文字取意 */\nexport const XhContextMenuItemIcon = defineComponent({\n  name: 'XhContextMenuItemIcon',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIconProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的快捷键提示，贴行尾；纯装饰，读屏从条目文字取意 */\nexport const XhContextMenuItemShortcut = defineComponent({\n  name: 'XhContextMenuItemShortcut',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemShortcutProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标、次级图标）；家族只管落位，不规定字号与颜色 */\nexport const XhContextMenuItemSuffix = defineComponent({\n  name: 'XhContextMenuItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuSeparator = defineComponent({\n  name: 'XhContextMenuSeparator',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhContextMenuArrow = defineComponent({\n  name: 'XhContextMenuArrow',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/** 子菜单不写插槽时那一层：触发条目、定位层与按本层 collection 铺的条目；子层不经根上的条目插槽。 */\nfunction renderSubLayer(label: string, icon: IconRecord | null): VNode[] {\n  return [\n    // 入口与普通条目一样：图标在 item-icon（写了才铺）、文字在 item-text\n    h(XhContextMenuSubTrigger, null, () => [\n      ...(icon ? [h(XhMenuItemIcon, null, () => [h(XhIcon, { icon })])] : []),\n      h(XhMenuItemText, null, () => [label]),\n    ]),\n    h(XhMenuPositioner, null, () => [h(XhMenuContent, null, () => [h(MenuDefaultNodes)])]),\n  ]\n}\n\n/** 按数据铺的条目：kind 取 collection 里这一条，勾选与单选条目各用自己的部件组件。 */\nconst ContextMenuStructureItem = /* @__PURE__ */ defineComponent({\n  name: 'ContextMenuStructureItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => {\n      const meta = ctx.api.value.collection.find(node => node.value === props.value)\n      const Item = meta?.kind === 'checkbox' ? XhContextMenuCheckboxItem : meta?.kind === 'radio' ? XhContextMenuRadioItem : XhContextMenuItem\n      return h(Item, { value: props.value, closeOnSelect: meta?.closeOnSelect }, slots)\n    }\n  },\n})\n\n/** 按数据铺的分组：组里有单选条目时是单选组。 */\nconst ContextMenuStructureGroup = /* @__PURE__ */ defineComponent({\n  name: 'ContextMenuStructureGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => {\n      const radio = ctx.api.value.collection.some(node => node.kind === 'radio' && node.group === props.value)\n      return h(radio ? XhContextMenuRadioGroup : XhContextMenuGroup, { value: props.value }, slots)\n    }\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst CONTEXT_MENU_PARTS = {\n  'trigger': XhContextMenuTrigger,\n  'positioner': XhContextMenuPositioner,\n  'content': XhContextMenuContent,\n  'item': ContextMenuStructureItem,\n  'item-icon': XhContextMenuItemIcon,\n  'item-text': XhContextMenuItemText,\n  'item-indicator': XhContextMenuItemIndicator,\n  'item-description': XhContextMenuItemDescription,\n  'item-shortcut': XhContextMenuItemShortcut,\n  'item-suffix': XhContextMenuItemSuffix,\n  'separator': XhContextMenuSeparator,\n  'group': ContextMenuStructureGroup,\n  'group-label': XhContextMenuGroupLabel,\n}\n\n/** 结构里组合进来的组件：带 children 的条目是嵌套的子菜单。 */\nconst CONTEXT_MENU_INSTANCES = { menu: XhContextMenuSub, icon: XhIcon }\n\n/**\n * 未写默认插槽时照 contextMenuStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。\n * 触发区的内容归作者（trigger 插槽）；条目文字、行首、行尾可由 item 系插槽逐槽接管，其余照数据铺。\n */\nfunction renderDefaultStructure(api: ContextMenuApi, trigger: (() => VNode[]) | undefined, itemSlots: ContextMenuItemSlots): VNode[] {\n  const nodes = contextMenuStructure(api, {\n    slotted: name => name === 'trigger' ? trigger != null : itemSlots[name as keyof ContextMenuItemSlots] != null,\n  })\n  return renderStructure(nodes, CONTEXT_MENU_PARTS, (node: StructureNode) => {\n    const name = node.slot?.name\n    if (name === 'trigger')\n      return trigger?.()\n    if (name !== 'item' && name !== 'item-prefix' && name !== 'item-suffix')\n      return undefined\n    const meta = (node.data as ContextMenuNodeMeta | undefined) ?? api.collection.find(item => item.value === node.slot!.key)\n    return meta ? itemSlots[name]?.(meta) : undefined\n  }, CONTEXT_MENU_INSTANCES)\n}\n"],"mappings":"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"}

package/dist/components/context-menu/context.d.ts

@@ -1,6 +1,6 @@
 import { ContextMenuContext } from "./use-context-menu.js";
-import { ComputedRef } from "vue";
 import "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/context-menu/context.d.ts
 /** 子菜单触发条目要同时访问父右键菜单与本子菜单，这里保存父层句柄与它在父层中的身份。 */
 interface ContextMenuSubHandle {

package/dist/components/context-menu/use-context-menu.d.ts

@@ -1,6 +1,6 @@
+import { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from "@xihan-ui/headless";
 //#region src/components/context-menu/use-context-menu.d.ts
 interface ContextMenuContext {
   service: Service<ContextMenuSchema>;
@@ -15,7 +15,7 @@ interface ContextMenuContext {
   /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useContextMenu(props: ContextMenuSchema['props'], onOpenChange?: ContextMenuSchema['props']['onOpenChange'], onSelect?: ContextMenuSchema['props']['onSelect'], onCheckboxValueChange?: ContextMenuSchema['props']['onCheckboxValueChange'], onRadioValueChange?: ContextMenuSchema['props']['onRadioValueChange']): ContextMenuContext;
+declare function useContextMenu(props: ContextMenuSchema['props'], onOpenChange?: ContextMenuSchema['props']['onOpenChange'], onItemSelect?: ContextMenuSchema['props']['onItemSelect'], onCheckboxValueChange?: ContextMenuSchema['props']['onCheckboxValueChange'], onRadioValueChange?: ContextMenuSchema['props']['onRadioValueChange']): ContextMenuContext;
 //#endregion
 export { ContextMenuContext, useContextMenu };
 //# sourceMappingURL=use-context-menu.d.ts.map

package/dist/components/context-menu/use-context-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,MAAM;;EAEN,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,eACd,OAAO,4BACP,eAAe,4CACf,WAAW,wCACX,wBAAwB,qDACxB,qBAAqB,mDACpB"}
+{"version":3,"file":"use-context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,MAAM;;EAEN,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,eACd,OAAO,4BACP,eAAe,4CACf,eAAe,4CACf,wBAAwB,qDACxB,qBAAqB,mDACpB"}

package/dist/components/context-menu/use-context-menu.js

@@ -3,12 +3,12 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectContextMenu, contextMenuMachine, createMenuTreeNode } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectContextMenu, contextMenuMachine, createMenuTreeNode } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/context-menu/use-context-menu.ts
-function useContextMenu(props, onOpenChange, onSelect, onCheckboxValueChange, onRadioValueChange) {
+function useContextMenu(props, onOpenChange, onItemSelect, onCheckboxValueChange, onRadioValueChange) {
 	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
@@ -21,12 +21,12 @@ function useContextMenu(props, onOpenChange, onSelect, onCheckboxValueChange, on
 		isOpen: () => service?.state.get() === "open",
 		close: () => service?.send({ type: "CLOSE" }),
 		isRoot: () => true,
-		onRootSelect: (details) => onSelect?.(details)
+		onRootSelect: (details) => onItemSelect?.(details)
 	});
 	service = useMachine(contextMenuMachine, () => ({
 		...props,
 		onOpenChange,
-		onSelect,
+		onItemSelect,
 		onCheckboxValueChange,
 		onRadioValueChange
 	}), scope);

package/dist/components/context-menu/use-context-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use context menu 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectContextMenu, contextMenuMachine, createMenuTreeNode } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onSelect?: ContextMenuSchema['props']['onSelect'],\n  onCheckboxValueChange?: ContextMenuSchema['props']['onCheckboxValueChange'],\n  onRadioValueChange?: ContextMenuSchema['props']['onRadioValueChange'],\n): ContextMenuContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  let service: Service<ContextMenuSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => positionerRef.value,\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: details => onSelect?.(details),\n  })\n  service = useMachine(contextMenuMachine, () => ({ ...props, onOpenChange, onSelect, onCheckboxValueChange, onRadioValueChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口。\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区兼作两用：收起时焦点归还它，没有光标坐标时它的起始角就是锚点\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, tree, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,eACd,OACA,cACA,UACA,uBACA,oBACoB;CACpB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAA6C;CACjD,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB,cAAc;EACnC,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAc,YAAW,WAAW,OAAO;CAC7C,CAAC;CACD,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO;EAAc;EAAU;EAAuB;CAAmB,IAAI,KAAK;CAGvI,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,mBAAmB,SAAS,YAAY,CAAC;CAEpE,MAAM,UAAU,eAAe;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EAAE;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY;EAAM;CAAa;AAC5F"}
+{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use context menu 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectContextMenu, contextMenuMachine, createMenuTreeNode } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onItemSelect?: ContextMenuSchema['props']['onItemSelect'],\n  onCheckboxValueChange?: ContextMenuSchema['props']['onCheckboxValueChange'],\n  onRadioValueChange?: ContextMenuSchema['props']['onRadioValueChange'],\n): ContextMenuContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  let service: Service<ContextMenuSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => positionerRef.value,\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: details => onItemSelect?.(details),\n  })\n  service = useMachine(contextMenuMachine, () => ({ ...props, onOpenChange, onItemSelect, onCheckboxValueChange, onRadioValueChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口。\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区兼作两用：收起时焦点归还它，没有光标坐标时它的起始角就是锚点\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, tree, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,eACd,OACA,cACA,cACA,uBACA,oBACoB;CACpB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAA6C;CACjD,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB,cAAc;EACnC,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAc,YAAW,eAAe,OAAO;CACjD,CAAC;CACD,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO;EAAc;EAAc;EAAuB;CAAmB,IAAI,KAAK;CAG3I,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,mBAAmB,SAAS,YAAY,CAAC;CAEpE,MAAM,UAAU,eAAe;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EAAE;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY;EAAM;CAAa;AAC5F"}

package/dist/components/date-field/date-field.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
 //#region src/components/date-field/date-field.d.ts
 type DateFieldProps = DateFieldSchema['props'];
 type SegmentTexts = { readonly [K in DateSegmentType]?: string; };
@@ -12,6 +12,14 @@ interface DateFieldSegmentSlotProps {
   segment: DateFieldSegmentState | undefined;
 }
 declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<string | null>;
   };
@@ -82,6 +90,14 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   'value-change': (_details: PayloadOf<DateFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<DateFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<string | null>;
   };
@@ -156,6 +172,7 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   readOnly: boolean;
 }, SlotsType<{
   default?: (props: DateFieldRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDateFieldLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/date-field/date-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KAkBK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAce;EACf,SAAS;;cAGE,+BAAe,8BAAA;;IAIC,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IA3BV,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;IAER,MAAA,SAAS;;;;;;IAFD,MAAA;;;;IAER,MAAA,SAAS;;;EAG1B,WAAC,OAAO,8BAA8B;kCAmBlD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KAoBK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAce;EACf,SAAS;;cAGE,+BAAe,8BAAA;;;;;;;;;;IAQC,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;IA3BV,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,2BAA2B;EACrC,cAAM;kCA2BhB;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;IAER,MAAA,SAAS;;;;;;IAFD,MAAA;;;;IAER,MAAA,SAAS;;;EAG1B,WAAC,OAAO,8BAA8B;kCAmBlD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/date-field/date-field.js

@@ -1,13 +1,19 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { provideDateField, useDateFieldContext } from "./context.js";
 import { useDateField } from "./use-date-field.js";
-import { defineComponent, h } from "vue";
+import { dateFieldStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/date-field/date-field.ts
 const XhDateFieldRoot = defineComponent({
 	name: "XhDateFieldRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
 		value: { type: String },
 		defaultValue: { type: String },
 		min: { type: String },
@@ -55,24 +61,31 @@ const XhDateFieldRoot = defineComponent({
 		};
 		const ctx = useDateField(withHandlers(withXhConfig("date-field", useFormControlProps(props)), { onClear: () => emit("clear") }), { onValueChange });
 		provideDateField(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			valueAsDate: ctx.api.value.valueAsDate,
-			segments: ctx.api.value.segments,
-			complete: ctx.api.value.complete,
-			empty: ctx.api.value.empty,
-			outOfRange: ctx.api.value.outOfRange,
-			focusedSegment: ctx.api.value.focusedSegment,
-			setValue: ctx.api.value.setValue,
-			clear: ctx.api.value.clear,
-			canClear: ctx.api.value.canClear
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				valueAsDate: api.valueAsDate,
+				segments: api.segments,
+				complete: api.complete,
+				empty: api.empty,
+				outOfRange: api.outOfRange,
+				focusedSegment: api.focusedSegment,
+				setValue: api.setValue,
+				clear: api.clear,
+				canClear: api.canClear
+			}) : renderDefaultStructure(api, props.label, slots.label));
+		};
 	}
 });
 const XhDateFieldLabel = defineComponent({
 	name: "XhDateFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useDateFieldContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -122,6 +135,25 @@ const XhDateFieldHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const DATE_FIELD_PARTS = {
+	"label": XhDateFieldLabel,
+	"control": XhDateFieldControl,
+	"segment-group": XhDateFieldSegmentGroup,
+	"segment": XhDateFieldSegment,
+	"clear-trigger": XhDateFieldClearTrigger,
+	"hidden-input": XhDateFieldHiddenInput
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 dateFieldStructure 渲，段按当前段序铺、段间是 locale 的分隔符，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, labelSlot) {
+	return renderStructure(dateFieldStructure(api, {
+		label,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), DATE_FIELD_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhDateFieldClearTrigger, XhDateFieldControl, XhDateFieldHiddenInput, XhDateFieldLabel, XhDateFieldRoot, XhDateFieldSegment, XhDateFieldSegmentGroup };
 

package/dist/components/date-field/date-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"date-field.js","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 date field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideDateField, useDateFieldContext } from './context'\nimport { useDateField } from './use-date-field'\n\ntype DateFieldProps = DateFieldSchema['props']\ntype SegmentTexts = { readonly [K in DateSegmentType]?: string }\n\n/** 默认插槽的载荷：整份值、逐段投影、填写状态，以及改写与清空的句柄。 */\nexport type DateFieldRootSlotProps = Pick<\n  DateFieldApi,\n  | 'value'\n  | 'valueAsDate'\n  | 'segments'\n  | 'complete'\n  | 'empty'\n  | 'outOfRange'\n  | 'focusedSegment'\n  | 'setValue'\n  | 'clear'\n  | 'canClear'\n>\n\n/** 段位默认插槽的载荷：本段的投影；下标越界时缺席。 */\nexport interface DateFieldSegmentSlotProps {\n  segment: DateFieldSegmentState | undefined\n}\n\nexport const XhDateFieldRoot = defineComponent({\n  name: 'XhDateFieldRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    timeZone: { type: String },\n    granularity: { type: String as PropType<DateGranularity> },\n    /** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */\n    hourCycle: { type: Number as PropType<DateHourCycle> },\n    // 段集：给了就以它为准，granularity 让路。段位节点仍按下标认段，段集是有序的\n    segments: { type: Array as PropType<DateSegmentSet> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */\n    placeholder: { type: [String, Object] as PropType<string | SegmentTexts> },\n    translations: { type: Object as PropType<DateFieldTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<DateFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<DateFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: DateFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useDateField(withHandlers(withXhConfig('date-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as DateFieldProps, { onValueChange })\n    provideDateField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsDate: ctx.api.value.valueAsDate,\n      segments: ctx.api.value.segments,\n      complete: ctx.api.value.complete,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      focusedSegment: ctx.api.value.focusedSegment,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      canClear: ctx.api.value.canClear,\n    }))\n  },\n})\n\nexport const XhDateFieldLabel = defineComponent({\n  name: 'XhDateFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 渲染为 span 而非 label，段位不是可被 for 标注的控件；点标题聚焦由连接层接管\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldControl = defineComponent({\n  name: 'XhDateFieldControl',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegmentGroup = defineComponent({\n  name: 'XhDateFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegment = defineComponent({\n  name: 'XhDateFieldSegment',\n  props: {\n    // 下标由作者声明，是哪一段由 locale 与段集算出；兼收字符串\n    index: { type: [Number, String] as PropType<number | string> },\n    /** 按段名声明该格。段集中没有该段时它收起；与 index 二选一，两个都写时按段名计算。 */\n    segment: { type: String as PropType<DateSegmentType> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldSegmentSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => {\n      const api = ctx.api.value\n      // 落点由连接层算：按下标还是按段名是同一条路，适配器这边不重写一份\n      const declared = props.segment != null\n        ? { segment: props.segment }\n        : { index: Math.trunc(Number(props.index)) }\n      const state = api.segmentOf(declared)\n      // 有插槽用插槽，否则渲染连接层算好的段位文本\n      return h(\n        'div',\n        api.getSegmentProps(declared) as Record<string, unknown>,\n        slots.default ? slots.default({ segment: state }) : state?.text,\n      )\n    }\n  },\n})\n\nexport const XhDateFieldClearTrigger = defineComponent({\n  name: 'XhDateFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 没有默认插槽时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldHiddenInput = defineComponent({\n  name: 'XhDateFieldHiddenInput',\n  setup() {\n    const ctx = useDateFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"date-field.js","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 date field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { dateFieldStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideDateField, useDateFieldContext } from './context'\nimport { useDateField } from './use-date-field'\n\ntype DateFieldProps = DateFieldSchema['props']\ntype SegmentTexts = { readonly [K in DateSegmentType]?: string }\n\n/** 默认插槽的载荷：整份值、逐段投影、填写状态，以及改写与清空的句柄。 */\nexport type DateFieldRootSlotProps = Pick<\n  DateFieldApi,\n  | 'value'\n  | 'valueAsDate'\n  | 'segments'\n  | 'complete'\n  | 'empty'\n  | 'outOfRange'\n  | 'focusedSegment'\n  | 'setValue'\n  | 'clear'\n  | 'canClear'\n>\n\n/** 段位默认插槽的载荷：本段的投影；下标越界时缺席。 */\nexport interface DateFieldSegmentSlotProps {\n  segment: DateFieldSegmentState | undefined\n}\n\nexport const XhDateFieldRoot = defineComponent({\n  name: 'XhDateFieldRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    timeZone: { type: String },\n    granularity: { type: String as PropType<DateGranularity> },\n    /** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */\n    hourCycle: { type: Number as PropType<DateHourCycle> },\n    // 段集：给了就以它为准，granularity 让路。段位节点仍按下标认段，段集是有序的\n    segments: { type: Array as PropType<DateSegmentSet> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */\n    placeholder: { type: [String, Object] as PropType<string | SegmentTexts> },\n    translations: { type: Object as PropType<DateFieldTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<DateFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<DateFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: DateFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useDateField(withHandlers(withXhConfig('date-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as DateFieldProps, { onValueChange })\n    provideDateField(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            valueAsDate: api.valueAsDate,\n            segments: api.segments,\n            complete: api.complete,\n            empty: api.empty,\n            outOfRange: api.outOfRange,\n            focusedSegment: api.focusedSegment,\n            setValue: api.setValue,\n            clear: api.clear,\n            canClear: api.canClear,\n          })\n        : renderDefaultStructure(api, props.label, slots.label))\n    }\n  },\n})\n\nexport const XhDateFieldLabel = defineComponent({\n  name: 'XhDateFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 渲染为 span 而非 label，段位不是可被 for 标注的控件；点标题聚焦由连接层接管\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldControl = defineComponent({\n  name: 'XhDateFieldControl',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegmentGroup = defineComponent({\n  name: 'XhDateFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegment = defineComponent({\n  name: 'XhDateFieldSegment',\n  props: {\n    // 下标由作者声明，是哪一段由 locale 与段集算出；兼收字符串\n    index: { type: [Number, String] as PropType<number | string> },\n    /** 按段名声明该格。段集中没有该段时它收起；与 index 二选一，两个都写时按段名计算。 */\n    segment: { type: String as PropType<DateSegmentType> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldSegmentSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => {\n      const api = ctx.api.value\n      // 落点由连接层算：按下标还是按段名是同一条路，适配器这边不重写一份\n      const declared = props.segment != null\n        ? { segment: props.segment }\n        : { index: Math.trunc(Number(props.index)) }\n      const state = api.segmentOf(declared)\n      // 有插槽用插槽，否则渲染连接层算好的段位文本\n      return h(\n        'div',\n        api.getSegmentProps(declared) as Record<string, unknown>,\n        slots.default ? slots.default({ segment: state }) : state?.text,\n      )\n    }\n  },\n})\n\nexport const XhDateFieldClearTrigger = defineComponent({\n  name: 'XhDateFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 没有默认插槽时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldHiddenInput = defineComponent({\n  name: 'XhDateFieldHiddenInput',\n  setup() {\n    const ctx = useDateFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst DATE_FIELD_PARTS = {\n  'label': XhDateFieldLabel,\n  'control': XhDateFieldControl,\n  'segment-group': XhDateFieldSegmentGroup,\n  'segment': XhDateFieldSegment,\n  'clear-trigger': XhDateFieldClearTrigger,\n  'hidden-input': XhDateFieldHiddenInput,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 dateFieldStructure 渲，段按当前段序铺、段间是 locale 的分隔符，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: DateFieldApi, label: string | undefined, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = dateFieldStructure(api, { label, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, DATE_FIELD_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/date-field/use-date-field.d.ts

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { DateFieldApi, DateFieldSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/date-field/use-date-field.d.ts
 interface DateFieldContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhDateFieldLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<DateFieldApi>;
 }
 declare function useDateField(props: DateFieldSchema['props'], handlers?: Pick<DateFieldSchema['props'], 'onValueChange'>): DateFieldContext;

package/dist/components/date-field/use-date-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-date-field.d.ts","names":[],"sources":["../../../src/components/date-field/use-date-field.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,WAAU,KAAK,6CACd"}
+{"version":3,"file":"use-date-field.d.ts","names":[],"sources":["../../../src/components/date-field/use-date-field.ts"],"mappings":";;;UAgBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,WAAU,KAAK,6CACd"}

package/dist/components/date-field/use-date-field.js

@@ -1,16 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectDateField, dateFieldMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/date-field/use-date-field.ts
 function useDateField(props, handlers = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(dateFieldMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
-	}), createScope(null, createVueIdGenerator()));
-	return { api: computed(() => connectDateField(service, vueNormalize)) };
+	}), scope);
+	return {
+		labelCount,
+		api: computed(() => connectDateField(service, vueNormalize))
+	};
 }
 //#endregion
 export { useDateField };

package/dist/components/date-field/use-date-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-date-field.js","names":[],"sources":["../../../src/components/date-field/use-date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use date field 相关实现。\n\nimport type { DateFieldApi, DateFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectDateField, dateFieldMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DateFieldContext {\n  api: ComputedRef<DateFieldApi>\n}\n\nexport function useDateField(\n  props: DateFieldSchema['props'],\n  handlers: Pick<DateFieldSchema['props'], 'onValueChange'> = {},\n): DateFieldContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(dateFieldMachine, () => ({ ...props, ...handlers }), scope)\n  const api = computed(() => connectDateField(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAoBA,SAAgB,aACd,OACA,WAA4D,CAAC,GAC3C;CAIlB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,GAAG;CAAS,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CAErF,OAAO,EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD,EAAE;AACf"}
+{"version":3,"file":"use-date-field.js","names":[],"sources":["../../../src/components/date-field/use-date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use date field 相关实现。\n\nimport type { DateFieldApi, DateFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectDateField, dateFieldMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DateFieldContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhDateFieldLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<DateFieldApi>\n}\n\nexport function useDateField(\n  props: DateFieldSchema['props'],\n  handlers: Pick<DateFieldSchema['props'], 'onValueChange'> = {},\n): DateFieldContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(dateFieldMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n  const api = computed(() => connectDateField(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,aACd,OACA,WAA4D,CAAC,GAC3C;CAGlB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAErH,OAAO;EAAE;EAAY,KADT,eAAe,iBAAiB,SAAS,YAAY,CAC1C;CAAE;AAC3B"}