@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/mention/mention.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention.js","names":[],"sources":["../../../src/components/mention/mention.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// 提供 mention 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionInputHost, MentionItemProps, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideMention, provideMentionItem, useMentionContext, useMentionItemContext } from './context'\nimport { useMention } from './use-mention'\n\ntype MentionProps = MentionSchema['props']\n\n/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选、正文里仍然完整的提及，以及改写正文与收起浮层的句柄。 */\nexport type MentionRootSlotProps = Pick<\n  MentionApi,\n  | 'open'\n  | 'value'\n  | 'query'\n  | 'activePrefix'\n  | 'highlightedValue'\n  | 'mentions'\n  | 'setValue'\n  | 'close'\n>\n\nexport const XhMentionRoot = defineComponent({\n  name: 'XhMentionRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    triggerPrefix: { type: [String, Array] as PropType<string | string[]> },\n    collection: { type: Array as PropType<MentionNode[]> },\n    value: { type: String },\n    defaultValue: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    loading: Boolean,\n    name: { type: String },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    loop: { type: Boolean, default: undefined },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<MentionTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<MentionProps, 'onValueChange'>) => true,\n    'query-change': (_details: PayloadOf<MentionProps, 'onQueryChange'>) => true,\n    'select': (_details: PayloadOf<MentionProps, 'onSelect'>) => true,\n    'open-change': (_details: PayloadOf<MentionProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<MentionProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: MentionRootSlotProps) => VNode[]\n    /** 铺开 collection 时每条候选的文本插槽。 */\n    'item'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (props: MentionNodeMeta) => VNode[]\n    /** 铺开 collection 时空态中的文案；未写时取 translations.empty（缺省走英文语言包）。 */\n    'empty'?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: MentionProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyQuery: MentionProps['onQueryChange'] = details => emit('query-change', details)\n    const notifySelect: MentionProps['onSelect'] = details => emit('select', details)\n    const notifyOpen: MentionProps['onOpenChange'] = details => emit('open-change', details)\n\n    const ctx = useMention(withXhConfig('mention', useFormControlProps(props)) as MentionProps, {\n      onValueChange: notifyValue,\n      onQueryChange: notifyQuery,\n      onSelect: notifySelect,\n      onOpenChange: notifyOpen,\n    })\n    provideMention(ctx)\n\n    // 首帧结算一次候选条数，之后的增删由条目自己上报\n    onMounted(ctx.syncItems)\n    onUpdated(ctx.syncItems)\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            value: ctx.api.value.value,\n            query: ctx.api.value.query,\n            activePrefix: ctx.api.value.activePrefix,\n            highlightedValue: ctx.api.value.highlightedValue,\n            mentions: ctx.api.value.mentions,\n            setValue: ctx.api.value.setValue,\n            close: ctx.api.value.close,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, ctx.api.value.emptyText, slots.item, slots['item-prefix'], slots['item-suffix'], slots.empty)\n          : [],\n    )\n  },\n})\n\n/** 标题；必须是原生 label，getLabelProps 的 for 恒指向输入框。 */\nexport const XhMentionLabel = defineComponent({\n  name: 'XhMentionLabel',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 输入框；正文写在它上面，候选浮层贴着它落位。缺省单行，写 as=\"textarea\" 即多行。 */\nexport const XhMentionInput = defineComponent({\n  name: 'XhMentionInput',\n  props: {\n    /**\n     * 输入框渲染为哪个标签，默认 input。\n     * 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。\n     */\n    as: { type: String as PropType<MentionInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useMentionContext()\n    return () => h(props.as, fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.inputRef.value = el as MentionInputEl },\n    }))\n  },\n})\n\nexport const XhMentionPositioner = defineComponent({\n  name: 'XhMentionPositioner',\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 = useMentionContext()\n    // 候选列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner，条子走浮层 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.inputRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(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 XhMentionContent = defineComponent({\n  name: 'XhMentionContent',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\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\n/** 没有任何候选时显示的空态；与候选面板同级。 */\nexport const XhMentionEmpty = defineComponent({\n  name: 'XhMentionEmpty',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 候选仍在获取时显示的在途占位；与候选面板同级。 */\nexport const XhMentionLoading = defineComponent({\n  name: 'XhMentionLoading',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItem = defineComponent({\n  name: 'XhMentionItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useMentionContext()\n    const item = computed<MentionItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideMentionItem({ item })\n    // 候选的进出与改名由条目自己上报，机器据此结算条数并摘掉悬空高亮\n    onMounted(ctx.syncItems)\n    onUnmounted(ctx.syncItems)\n    // 节点就地复用时数量不变但身份换了，需按 value 另行上报\n    watch(() => props.value, ctx.syncItems)\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItemText = defineComponent({\n  name: 'XhMentionItemText',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhMentionItemPrefix = defineComponent({\n  name: 'XhMentionItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhMentionItemSuffix = defineComponent({\n  name: 'XhMentionItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhMentionItemDescription = defineComponent({\n  name: 'XhMentionItemDescription',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultTree(\n  collection: readonly MentionNodeMeta[],\n  defaultEmpty: string,\n  itemSlot?: (node: MentionNodeMeta) => VNode[],\n  prefixSlot?: (node: MentionNodeMeta) => VNode[],\n  suffixSlot?: (node: MentionNodeMeta) => VNode[],\n  emptySlot?: () => VNode[],\n): VNode[] {\n  const emptyText = emptySlot?.() ?? defaultEmpty\n  return [\n    h(XhMentionInput),\n    h(XhMentionPositioner, null, () => [\n      h(XhMentionContent, null, () => collection.map(node =>\n        h(XhMentionItem, { key: node.value, value: node.value }, () => [\n          ...(prefixSlot ? [h(XhMentionItemPrefix, null, () => prefixSlot(node))] : []),\n          h(XhMentionItemText, null, () => itemSlot?.(node) ?? node.label),\n          ...(node.description != null ? [h(XhMentionItemDescription, null, () => node.description)] : []),\n          ...(suffixSlot ? [h(XhMentionItemSuffix, null, () => suffixSlot(node))] : []),\n        ]),\n      )),\n      h(XhMentionEmpty, null, () => emptyText),\n    ]),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"mention.js","names":[],"sources":["../../../src/components/mention/mention.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// 提供 mention 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionInputHost, MentionItemProps, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { mentionStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideMention, provideMentionItem, useMentionContext, useMentionItemContext } from './context'\nimport { useMention } from './use-mention'\n\ntype MentionProps = MentionSchema['props']\n\n/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选、正文里仍然完整的提及，以及改写正文与收起浮层的句柄。 */\nexport type MentionRootSlotProps = Pick<\n  MentionApi,\n  | 'open'\n  | 'value'\n  | 'query'\n  | 'activePrefix'\n  | 'highlightedValue'\n  | 'mentions'\n  | 'setValue'\n  | 'close'\n>\n\nexport const XhMentionRoot = defineComponent({\n  name: 'XhMentionRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    triggerPrefix: { type: [String, Array] as PropType<string | string[]> },\n    collection: { type: Array as PropType<MentionNode[]> },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不写默认插槽时输入框铺成多行的 textarea；写了默认插槽时在 XhMentionInput 上写 as=\"textarea\"。 */\n    multiline: Boolean,\n    value: { type: String },\n    defaultValue: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    loading: Boolean,\n    name: { type: String },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    loop: { type: Boolean, default: undefined },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<MentionTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<MentionProps, 'onValueChange'>) => true,\n    'query-change': (_details: PayloadOf<MentionProps, 'onQueryChange'>) => true,\n    'item-select': (_details: PayloadOf<MentionProps, 'onItemSelect'>) => true,\n    'open-change': (_details: PayloadOf<MentionProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<MentionProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: MentionRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    /** 铺开 collection 时每条候选的文本插槽。 */\n    'item'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (props: MentionNodeMeta) => VNode[]\n    /** 铺开 collection 时空态中的文案；未写时取 translations.empty（缺省走英文语言包）。 */\n    'empty'?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: MentionProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyQuery: MentionProps['onQueryChange'] = details => emit('query-change', details)\n    const notifyItemSelect: MentionProps['onItemSelect'] = details => emit('item-select', details)\n    const notifyOpen: MentionProps['onOpenChange'] = details => emit('open-change', details)\n\n    const ctx = useMention(withXhConfig('mention', useFormControlProps(props)) as MentionProps, {\n      onValueChange: notifyValue,\n      onQueryChange: notifyQuery,\n      onItemSelect: notifyItemSelect,\n      onOpenChange: notifyOpen,\n    })\n    provideMention(ctx)\n\n    // 首帧结算一次候选条数，之后的增删由条目自己上报\n    onMounted(ctx.syncItems)\n    onUpdated(ctx.syncItems)\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            value: ctx.api.value.value,\n            query: ctx.api.value.query,\n            activePrefix: ctx.api.value.activePrefix,\n            highlightedValue: ctx.api.value.highlightedValue,\n            mentions: ctx.api.value.mentions,\n            setValue: ctx.api.value.setValue,\n            close: ctx.api.value.close,\n          })\n        : renderDefaultStructure(ctx.api.value, { label: props.label, multiline: props.multiline }, {\n            'label': slots.label,\n            'empty': slots.empty,\n            'item': slots.item,\n            'item-prefix': slots['item-prefix'],\n            'item-suffix': slots['item-suffix'],\n          }),\n    )\n  },\n})\n\n/** 标题；必须是原生 label，getLabelProps 的 for 恒指向输入框。 */\nexport const XhMentionLabel = defineComponent({\n  name: 'XhMentionLabel',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 输入框；正文写在它上面，候选浮层贴着它落位。缺省单行，写 as=\"textarea\" 即多行。 */\nexport const XhMentionInput = defineComponent({\n  name: 'XhMentionInput',\n  props: {\n    /**\n     * 输入框渲染为哪个标签，默认 input。\n     * 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。\n     */\n    as: { type: String as PropType<MentionInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useMentionContext()\n    return () => h(props.as, fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.inputRef.value = el as MentionInputEl },\n    }))\n  },\n})\n\nexport const XhMentionPositioner = defineComponent({\n  name: 'XhMentionPositioner',\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 = useMentionContext()\n    // 候选列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner，条子走浮层 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.inputRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(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 XhMentionContent = defineComponent({\n  name: 'XhMentionContent',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\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\n/** 没有任何候选时显示的空态；与候选面板同级。 */\nexport const XhMentionEmpty = defineComponent({\n  name: 'XhMentionEmpty',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 候选仍在获取时显示的在途占位；与候选面板同级。 */\nexport const XhMentionLoading = defineComponent({\n  name: 'XhMentionLoading',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItem = defineComponent({\n  name: 'XhMentionItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useMentionContext()\n    const item = computed<MentionItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideMentionItem({ item })\n    // 候选的进出与改名由条目自己上报，机器据此结算条数并摘掉悬空高亮\n    onMounted(ctx.syncItems)\n    onUnmounted(ctx.syncItems)\n    // 节点就地复用时数量不变但身份换了，需按 value 另行上报\n    watch(() => props.value, ctx.syncItems)\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItemText = defineComponent({\n  name: 'XhMentionItemText',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhMentionItemPrefix = defineComponent({\n  name: 'XhMentionItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhMentionItemSuffix = defineComponent({\n  name: 'XhMentionItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhMentionItemDescription = defineComponent({\n  name: 'XhMentionItemDescription',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst MENTION_PARTS = {\n  'label': XhMentionLabel,\n  'input': XhMentionInput,\n  'positioner': XhMentionPositioner,\n  'content': XhMentionContent,\n  'item': XhMentionItem,\n  'item-prefix': XhMentionItemPrefix,\n  'item-text': XhMentionItemText,\n  'item-description': XhMentionItemDescription,\n  'item-suffix': XhMentionItemSuffix,\n  'empty': XhMentionEmpty,\n  'loading': XhMentionLoading,\n}\n\n/** 多行形态的输入框：标准结构开了 multiline 时顶替 input 部件。 */\nconst MentionTextarea = defineComponent({\n  name: 'XhMentionTextarea',\n  inheritAttrs: false,\n  setup(_, { attrs }) {\n    return () => h(XhMentionInput, { ...attrs, as: 'textarea' })\n  },\n})\n\ninterface MentionStructureSlots {\n  'label'?: () => VNode[]\n  'empty'?: () => VNode[]\n  'item'?: (node: MentionNodeMeta) => VNode[]\n  'item-prefix'?: (node: MentionNodeMeta) => VNode[]\n  'item-suffix'?: (node: MentionNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 mentionStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题、空态、候选文字与行首行尾由对应插槽接管；开了 multiline 时输入框是 textarea。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultStructure(api: MentionApi, options: { label?: string, multiline: boolean }, authored: MentionStructureSlots): VNode[] {\n  const nodes = mentionStructure(api, { ...options, slotted: name => authored[name as keyof MentionStructureSlots] != null })\n  const parts = options.multiline ? { ...MENTION_PARTS, input: MentionTextarea } : MENTION_PARTS\n  return renderStructure(nodes, parts, (node) => {\n    const meta = node.data as MentionNodeMeta\n    switch (node.slot?.name) {\n      case 'label':\n        return authored.label?.()\n      case 'empty':\n        return authored.empty?.()\n      case 'item':\n        return authored.item?.(meta) ?? meta.label\n      case 'item-prefix':\n        return authored['item-prefix']?.(meta)\n      case 'item-suffix':\n        return authored['item-suffix']?.(meta)\n      default:\n        return undefined\n    }\n  })\n}\n"],"mappings":"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"}

package/dist/components/mention/use-mention.d.ts

@@ -1,8 +1,13 @@
+import { MentionApi, MentionInputEl, MentionSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { MentionApi, MentionInputEl, MentionSchema } from "@xihan-ui/headless";
 //#region src/components/mention/use-mention.d.ts
 interface MentionContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhMentionLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   /** 状态机实例，供部件直接上报 DOM 侧事实。 */
   service: Service<MentionSchema>;
   api: ComputedRef<MentionApi>;
@@ -17,7 +22,7 @@ interface MentionContext {
   /** 上报候选集合可能已变化；同一拍内多次调用只上报一次。 */
   syncItems: () => void;
 }
-declare function useMention(props: MentionSchema['props'], handlers?: Pick<MentionSchema['props'], 'onValueChange' | 'onQueryChange' | 'onSelect' | 'onOpenChange'>): MentionContext;
+declare function useMention(props: MentionSchema['props'], handlers?: Pick<MentionSchema['props'], 'onValueChange' | 'onQueryChange' | 'onItemSelect' | 'onOpenChange'>): MentionContext;
 //#endregion
 export { MentionContext, useMention };
 //# sourceMappingURL=use-mention.d.ts.map

package/dist/components/mention/use-mention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-mention.d.ts","names":[],"sources":["../../../src/components/mention/use-mention.ts"],"mappings":";;;;UAoBiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,UAAU,IAAI;EACd,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;EAEnC;;iBAGc,WACd,OAAO,wBACP,WAAU,KAAK,2FACd"}
+{"version":3,"file":"use-mention.d.ts","names":[],"sources":["../../../src/components/mention/use-mention.ts"],"mappings":";;;;UAoBiB;;;;;EAKf,YAAY;;EAEZ,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,UAAU,IAAI;EACd,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;EAEnC;;iBAGc,WACd,OAAO,wBACP,WAAU,KAAK,+FACd"}

package/dist/components/mention/use-mention.js

@@ -3,9 +3,9 @@ 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 { connectMention, mentionMachine } from "@xihan-ui/headless";
 import { computed, nextTick, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectMention, mentionMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/mention/use-mention.ts
 function useMention(props, handlers = {}) {
@@ -15,8 +15,10 @@ function useMention(props, handlers = {}) {
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const labelCount = ref(0);
 	const service = useMachine(mentionMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
 	}), scope);
 	let config = null;
@@ -50,6 +52,7 @@ function useMention(props, handlers = {}) {
 	};
 	const api = computed(() => connectMention(service, vueNormalize));
 	return {
+		labelCount,
 		visible: useOverlayExit({
 			config,
 			isOpen: () => api.value.open,

package/dist/components/mention/use-mention.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-mention.js","names":[],"sources":["../../../src/components/mention/use-mention.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 mention 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMention, mentionMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, nextTick, 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 MentionContext {\n  /** 状态机实例，供部件直接上报 DOM 侧事实。 */\n  service: Service<MentionSchema>\n  api: ComputedRef<MentionApi>\n  /** 单行输入框，由 XhMentionInput 渲染。 */\n  inputRef: Ref<MentionInputEl | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n  /** 上报候选集合可能已变化；同一拍内多次调用只上报一次。 */\n  syncItems: () => void\n}\n\nexport function useMention(\n  props: MentionSchema['props'],\n  handlers: Pick<MentionSchema['props'], 'onValueChange' | 'onQueryChange' | 'onSelect' | 'onOpenChange'> = {},\n): MentionContext {\n  const xhConfig = useXhConfig()\n  const inputRef = ref<MentionInputEl | 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  const service = useMachine(mentionMachine, () => ({ ...props, ...handlers }), 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      // 输入框记为本层分支：在正文里打字、点击都算层内交互，不该把浮层点没。\n      // 浮层壳一并记上：候选列表之外还浮着自绘滚动条，按住它拖动不该把列表消解掉\n      branches: () => [inputRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点就是输入框本身\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    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getInputEl', () => inputRef.value)\n  }\n\n  // 合并到下一拍统一上报，同时等待 DOM 落定\n  let syncScheduled = false\n  const syncItems = (): void => {\n    if (syncScheduled)\n      return\n    syncScheduled = true\n    void nextTick(() => {\n      syncScheduled = false\n      if (service.getStatus() === 'Started')\n        service.send({ type: 'ITEMS.SYNC' })\n    })\n  }\n\n  const api = computed(() => connectMention(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  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, inputRef, positionerRef, contentRef, portalTarget, syncItems }\n}\n"],"mappings":";;;;;;;;;;AAoCA,SAAgB,WACd,OACA,WAA0G,CAAC,GAC3F;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,WAAW,IAA2B,IAAI;CAChD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAGnF,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,SAAS,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACpE,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;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACrD;CAGA,IAAI,gBAAgB;CACpB,MAAM,kBAAwB;EAC5B,IAAI,eACF;EACF,gBAAgB;EAChB,eAAoB;GAClB,gBAAgB;GAChB,IAAI,QAAQ,UAAU,MAAM,WAC1B,QAAQ,KAAK,EAAE,MAAM,aAAa,CAAC;EACvC,CAAC;CACH;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAWhE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAU;EAAe;EAAY,cAFhD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEzC;EAAG;CAAU;AAC/F"}
+{"version":3,"file":"use-mention.js","names":[],"sources":["../../../src/components/mention/use-mention.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 mention 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMention, mentionMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, nextTick, 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 MentionContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhMentionLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  /** 状态机实例，供部件直接上报 DOM 侧事实。 */\n  service: Service<MentionSchema>\n  api: ComputedRef<MentionApi>\n  /** 单行输入框，由 XhMentionInput 渲染。 */\n  inputRef: Ref<MentionInputEl | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n  /** 上报候选集合可能已变化；同一拍内多次调用只上报一次。 */\n  syncItems: () => void\n}\n\nexport function useMention(\n  props: MentionSchema['props'],\n  handlers: Pick<MentionSchema['props'], 'onValueChange' | 'onQueryChange' | 'onItemSelect' | 'onOpenChange'> = {},\n): MentionContext {\n  const xhConfig = useXhConfig()\n  const inputRef = ref<MentionInputEl | 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  const labelCount = ref(0)\n  const service = useMachine(mentionMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), 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      // 输入框记为本层分支：在正文里打字、点击都算层内交互，不该把浮层点没。\n      // 浮层壳一并记上：候选列表之外还浮着自绘滚动条，按住它拖动不该把列表消解掉\n      branches: () => [inputRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点就是输入框本身\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    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getInputEl', () => inputRef.value)\n  }\n\n  // 合并到下一拍统一上报，同时等待 DOM 落定\n  let syncScheduled = false\n  const syncItems = (): void => {\n    if (syncScheduled)\n      return\n    syncScheduled = true\n    void nextTick(() => {\n      syncScheduled = false\n      if (service.getStatus() === 'Started')\n        service.send({ type: 'ITEMS.SYNC' })\n    })\n  }\n\n  const api = computed(() => connectMention(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  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { labelCount, visible, service, api, inputRef, positionerRef, contentRef, portalTarget, syncItems }\n}\n"],"mappings":";;;;;;;;;;AAyCA,SAAgB,WACd,OACA,WAA8G,CAAC,GAC/F;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,WAAW,IAA2B,IAAI;CAChD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAGnH,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,SAAS,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACpE,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;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACrD;CAGA,IAAI,gBAAgB;CACpB,MAAM,kBAAwB;EAC5B,IAAI,eACF;EACF,gBAAgB;EAChB,eAAoB;GAClB,gBAAgB;GAChB,IAAI,QAAQ,UAAU,MAAM,WAC1B,QAAQ,KAAK,EAAE,MAAM,aAAa,CAAC;EACvC,CAAC;CACH;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAWhE,OAAO;EAAE;EAAY,SATL,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAI2B;EAAG;EAAS;EAAK;EAAU;EAAe;EAAY,cAF5D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE7B;EAAG;CAAU;AAC3G"}

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

@@ -1,6 +1,6 @@
 import { MenuContext } from "./use-menu.js";
-import { ComputedRef } from "vue";
 import { MenuGroupProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/menu/context.d.ts
 declare function provideMenu(ctx: MenuContext): void;
 declare function useMenuContext(): MenuContext;

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
-import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
 import { MenuApi, MenuNode, MenuNodeMeta, MenuRadioValue, MenuSchema, MenuTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { Direction, IconRecord, Placement, Size, Tone } from "@xihan-ui/core";
 //#region src/components/menu/menu.d.ts
 type MenuProps = MenuSchema['props'];
 /** 默认插槽的载荷：展开态与修改展开的动作。 */
@@ -27,6 +27,10 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
+  /** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger；按数据铺设时不铺触发按钮。 */
+  anchor: {
+    type: PropType<HTMLElement | null>;
+  };
   placement: {
     type: PropType<Placement>;
   };
@@ -46,6 +50,10 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   size: {
     type: PropType<Size>;
   };
+  fitAvailableHeight: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   typeahead: {
     type: BooleanConstructor;
     default: undefined;
@@ -72,11 +80,15 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
    * 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。
    */
   triggerAsChild: BooleanConstructor;
+  /** 按数据铺设时触发按钮的文字；trigger 插槽有内容时以插槽为准。 */
+  label: {
+    type: StringConstructor;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'open-change': (_details: PayloadOf<MenuProps, "onOpenChange">) => true;
-  select: (_details: PayloadOf<MenuProps, "onSelect">) => true;
+  'item-select': (_details: PayloadOf<MenuProps, "onItemSelect">) => true;
   'checkbox-value-change': (_details: PayloadOf<MenuProps, "onCheckboxValueChange">) => true;
   'radio-value-change': (_details: PayloadOf<MenuProps, "onRadioValueChange">) => true;
   'update:open': (_open: PayloadOf<MenuProps, "onOpenChange">["open"]) => true;
@@ -101,6 +113,10 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
+  /** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger；按数据铺设时不铺触发按钮。 */
+  anchor: {
+    type: PropType<HTMLElement | null>;
+  };
   placement: {
     type: PropType<Placement>;
   };
@@ -120,6 +136,10 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   size: {
     type: PropType<Size>;
   };
+  fitAvailableHeight: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   typeahead: {
     type: BooleanConstructor;
     default: undefined;
@@ -146,10 +166,14 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
    * 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。
    */
   triggerAsChild: BooleanConstructor;
+  /** 按数据铺设时触发按钮的文字；trigger 插槽有内容时以插槽为准。 */
+  label: {
+    type: StringConstructor;
+  };
 }>> & Readonly<{
-  onSelect?: ((_details: import("@xihan-ui/headless").MenuSelectDetails) => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").MenuOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
+  "onItem-select"?: ((_details: import("@xihan-ui/headless").MenuItemSelectDetails) => any) | undefined;
   "onCheckbox-value-change"?: ((_details: import("@xihan-ui/headless").ContextMenuCheckboxValueChangeDetails) => any) | undefined;
   "onRadio-value-change"?: ((_details: import("@xihan-ui/headless").ContextMenuRadioValueChangeDetails) => any) | undefined;
 }>, {
@@ -160,6 +184,7 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   typeahead: boolean;
   openOnHover: boolean;
   triggerAsChild: boolean;
+  fitAvailableHeight: boolean;
 }, SlotsType<{
   default?: (props: MenuRootSlotProps) => VNode[];
   trigger?: () => VNode[];
@@ -205,6 +230,7 @@ type MenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>;
 /**
  * 子菜单：内部再运行一台 menu 状态机（submenu 模式），触发条目由 XhMenuSubTrigger
  * 渲染为父菜单条目与本子菜单触发器的双重身份。本身不渲染节点。
+ * 不写默认插槽时照标准结构铺自己那一层：触发条目、定位层与按 collection 铺的条目。
  */
 declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 它在父菜单中的条目身份。 */
@@ -212,6 +238,14 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
     type: StringConstructor;
     required: true;
   };
+  /** 按数据铺设时触发条目的文字；缺省取父菜单 collection 里这一条的 label。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 按数据铺设时触发条目的图标；缺省取父菜单 collection 里这一条的 icon。 */
+  icon: {
+    type: PropType<IconRecord>;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -260,12 +294,17 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   size: {
     type: PropType<Size>;
   };
+  /** 只按可用高度封顶；默认继承父层，理由同 tone。 */
+  fitAvailableHeight: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   hoverCloseDelay: {
     type: NumberConstructor;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'checkbox-value-change': (_details: PayloadOf<MenuProps, "onCheckboxValueChange">) => true;
   'radio-value-change': (_details: PayloadOf<MenuProps, "onRadioValueChange">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -274,6 +313,14 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
     type: StringConstructor;
     required: true;
   };
+  /** 按数据铺设时触发条目的文字；缺省取父菜单 collection 里这一条的 label。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 按数据铺设时触发条目的图标；缺省取父菜单 collection 里这一条的 icon。 */
+  icon: {
+    type: PropType<IconRecord>;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -322,6 +369,11 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   size: {
     type: PropType<Size>;
   };
+  /** 只按可用高度封顶；默认继承父层，理由同 tone。 */
+  fitAvailableHeight: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   hoverCloseDelay: {
     type: NumberConstructor;
   };
@@ -332,6 +384,7 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   loop: boolean;
   disabled: boolean;
   openOnHover: boolean;
+  fitAvailableHeight: boolean;
 }, SlotsType<{
   default?: (props: MenuSubSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -342,7 +395,7 @@ declare const XhMenuSubTrigger: import("vue").DefineComponent<{}, () => VNode<im
 declare const XhMenuItemText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 条目中的标记位（勾选、图标），纯装饰 */
+/** 勾选与单选条目的对号，排在条目最后，纯装饰；行首的图标写在 XhMenuItemIcon 里 */
 declare const XhMenuItemIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -350,6 +403,10 @@ declare const XhMenuItemIndicator: import("vue").DefineComponent<{}, () => VNode
 declare const XhMenuItemDescription: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 条目文字之前的图标格；装饰态，读屏从条目文字取意 */
+declare const XhMenuItemIcon: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 条目中的快捷键提示，贴行尾；纯装饰，读屏从条目文字取意 */
 declare const XhMenuItemShortcut: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -394,5 +451,5 @@ declare const XhMenuArrow: import("vue").DefineComponent<{}, () => VNode<import(
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { MenuRootSlotProps, MenuSubSlotProps, XhMenuArrow, XhMenuCheckboxItem, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuItemDescription, XhMenuItemIndicator, XhMenuItemShortcut, XhMenuItemSuffix, XhMenuItemText, XhMenuPositioner, XhMenuRadioGroup, XhMenuRadioItem, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
+export { MenuRootSlotProps, MenuSubSlotProps, XhMenuArrow, XhMenuCheckboxItem, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuItemDescription, XhMenuItemIcon, XhMenuItemIndicator, XhMenuItemShortcut, XhMenuItemSuffix, XhMenuItemText, XhMenuPositioner, XhMenuRadioGroup, XhMenuRadioItem, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/menu/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","names":[],"sources":["../../../src/components/menu/menu.ts"],"mappings":"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"}
+{"version":3,"file":"menu.d.ts","names":[],"sources":["../../../src/components/menu/menu.ts"],"mappings":"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"}