@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/listbox/listbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"listbox.js","names":[],"sources":["../../../src/components/listbox/listbox.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// 提供 listbox 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, ListboxApi, ListboxGroupProps, ListboxItemProps, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideListbox,\n  provideListboxItem,\n  provideListboxItemGroup,\n  useListboxContext,\n  useListboxItemContext,\n  useListboxItemGroupContext,\n} from './context'\nimport { useListbox } from './use-listbox'\n\ntype ListboxProps = ListboxSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */\nexport type ListboxRootSlotProps = Pick<\n  ListboxApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle'\n>\n\nexport const XhListboxRoot = defineComponent({\n  name: 'XhListboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ListboxNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<ListboxSelectionMode> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<ListboxProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ListboxProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ListboxRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */\n    'item'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ListboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ListboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useListbox(useFormControlProps(props) as ListboxProps, notify)\n    provideListbox(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n              slots['item-prefix'],\n              slots['item-suffix'],\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhListboxLabel = defineComponent({\n  name: 'XhListboxLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxContent = defineComponent({\n  name: 'XhListboxContent',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useListboxContext()\n    const contentRef = ref<HTMLElement | null>(null)\n    // 定高小列表走自绘条：条子是 content 的兄弟、挂在 root 这个定位盒上，贴在 content 自己的盒子上\n    // （root 里还有标题与占位，贴壳边会盖到它们）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => contentRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 条目增减、占位显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getContentProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhListboxEmpty = defineComponent({\n  name: 'XhListboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 空态占位：写在 root 里、content 的兄弟，不进列表框的拥有关系。\n    // 给了 collection 时收放归连接层，条目手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoading = defineComponent({\n  name: 'XhListboxLoading',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoadMoreTrigger = defineComponent({\n  name: 'XhListboxLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 取下一页的入口：点了做什么归作者，这里只把在途与禁用两档焊成点不动\n    return () => h('button', ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroup = defineComponent({\n  name: 'XhListboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useListboxContext()\n    const group = computed<ListboxGroupProps>(() => ({ value: props.value }))\n    provideListboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroupLabel = defineComponent({\n  name: 'XhListboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { group } = useListboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItem = defineComponent({\n  name: 'XhListboxItem',\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 = useListboxContext()\n    const item = computed<ListboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideListboxItem({ 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 (service.prop('virtualizer') && service.prop('collection')?.some(node => node.value === props.value))\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      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhListboxItemText = defineComponent({\n  name: 'XhListboxItemText',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhListboxItemPrefix = defineComponent({\n  name: 'XhListboxItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhListboxItemSuffix = defineComponent({\n  name: 'XhListboxItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhListboxItemDescription = defineComponent({\n  name: 'XhListboxItemDescription',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItemIndicator = defineComponent({\n  name: 'XhListboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构（分组、条目外的节点）时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly ListboxNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: ListboxNodeMeta) => VNode[],\n  prefixSlot?: (node: ListboxNodeMeta) => VNode[],\n  suffixSlot?: (node: ListboxNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhListboxLabel, null, () => label)] : []),\n    h(XhListboxContent, null, () => collection.map(node =>\n      h(XhListboxItem, { key: node.value, value: node.value }, () => [\n        ...(prefixSlot ? [h(XhListboxItemPrefix, null, () => prefixSlot(node))] : []),\n        h(XhListboxItemText, null, () => itemSlot?.(node) ?? node.label),\n        ...(node.description != null ? [h(XhListboxItemDescription, null, () => node.description)] : []),\n        ...(suffixSlot ? [h(XhListboxItemSuffix, null, () => suffixSlot(node))] : []),\n        h(XhListboxItemIndicator),\n      ]),\n    )),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"listbox.js","names":[],"sources":["../../../src/components/listbox/listbox.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// 提供 listbox 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, ListboxApi, ListboxGroupProps, ListboxItemProps, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode, ListboxTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { listboxStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUnmounted, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideListbox,\n  provideListboxItem,\n  provideListboxItemGroup,\n  useListboxContext,\n  useListboxItemContext,\n  useListboxItemGroupContext,\n} from './context'\nimport { useListbox } from './use-listbox'\n\ntype ListboxProps = ListboxSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */\nexport type ListboxRootSlotProps = Pick<\n  ListboxApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle'\n>\n\nexport const XhListboxRoot = defineComponent({\n  name: 'XhListboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    collection: { type: Array as PropType<ListboxNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<ListboxSelectionMode> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n    translations: { type: Object as PropType<Partial<ListboxTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<ListboxProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ListboxProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ListboxRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    /** 不写默认插槽时空态占位的内容；未写时取 translations.empty。 */\n    'empty'?: () => VNode[]\n    /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */\n    'item'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ListboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ListboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useListbox(withXhConfig('listbox', useFormControlProps(props)) as ListboxProps, notify)\n    provideListbox(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n        }) ?? []\n        : renderDefaultStructure(ctx.api.value, props.label, {\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\nexport const XhListboxLabel = defineComponent({\n  name: 'XhListboxLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxContent = defineComponent({\n  name: 'XhListboxContent',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useListboxContext()\n    // 放进表单字段时，字段的标题与说明接到列表上：读屏进列表时念字段名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    const contentRef = ref<HTMLElement | null>(null)\n    // 定高小列表走自绘条：条子是 content 的兄弟、挂在 root 这个定位盒上，贴在 content 自己的盒子上\n    // （root 里还有标题与占位，贴壳边会盖到它们）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => contentRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 条目增减、占位显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getContentProps() as Record<string, unknown> }), attrs),\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhListboxEmpty = defineComponent({\n  name: 'XhListboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 空态占位：写在 root 里、content 的兄弟，不进列表框的拥有关系。\n    // 给了 collection 时收放归连接层，条目手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoading = defineComponent({\n  name: 'XhListboxLoading',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoadMoreTrigger = defineComponent({\n  name: 'XhListboxLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 取下一页的入口：点了做什么归作者，这里只把在途与禁用两档焊成点不动\n    return () => h('button', ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroup = defineComponent({\n  name: 'XhListboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useListboxContext()\n    const group = computed<ListboxGroupProps>(() => ({ value: props.value }))\n    provideListboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroupLabel = defineComponent({\n  name: 'XhListboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { group } = useListboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItem = defineComponent({\n  name: 'XhListboxItem',\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 = useListboxContext()\n    const item = computed<ListboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideListboxItem({ 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 (service.prop('virtualizer') && service.prop('collection')?.some(node => node.value === props.value))\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      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhListboxItemText = defineComponent({\n  name: 'XhListboxItemText',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhListboxItemPrefix = defineComponent({\n  name: 'XhListboxItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhListboxItemSuffix = defineComponent({\n  name: 'XhListboxItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhListboxItemDescription = defineComponent({\n  name: 'XhListboxItemDescription',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItemIndicator = defineComponent({\n  name: 'XhListboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst LISTBOX_PARTS = {\n  'label': XhListboxLabel,\n  'content': XhListboxContent,\n  'item': XhListboxItem,\n  'item-prefix': XhListboxItemPrefix,\n  'item-text': XhListboxItemText,\n  'item-description': XhListboxItemDescription,\n  'item-suffix': XhListboxItemSuffix,\n  'item-indicator': XhListboxItemIndicator,\n  'empty': XhListboxEmpty,\n  'loading': XhListboxLoading,\n}\n\ninterface ListboxStructureSlots {\n  'label'?: () => VNode[]\n  'empty'?: () => VNode[]\n  'item'?: (node: ListboxNodeMeta) => VNode[]\n  'item-prefix'?: (node: ListboxNodeMeta) => VNode[]\n  'item-suffix'?: (node: ListboxNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 listboxStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题、条目文字与行首行尾由对应插槽接管。\n */\nfunction renderDefaultStructure(api: ListboxApi, label: string | undefined, authored: ListboxStructureSlots): VNode[] {\n  const nodes = listboxStructure(api, { label, slotted: name => authored[name as keyof ListboxStructureSlots] != null })\n  return renderStructure(nodes, LISTBOX_PARTS, (node) => {\n    const meta = node.data as ListboxNodeMeta\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":";;;;;;;;;;AAoCA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAC1B,YAAY,EAAE,MAAM,MAAiC;EACrD,aAAa,EAAE,MAAM,OAA0C;;EAE/D,OAAO,EAAE,MAAM,OAAO;EACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EAC9D,cAAc,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EACrE,eAAe,EAAE,MAAM,OAAyC;EAChE,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,SAAS;EACT,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC/C,KAAK,EAAE,MAAM,OAA8B;EAC3C,aAAa,EAAE,MAAM,OAAgC;EACrD,cAAc,EAAE,MAAM,OAAiD;CACzE;CAEA,OAAO;EACL,iBAAiB,aAAuD;EACxE,iBAAiB,WAA8D;CACjF;CACA,OAAO;CAYP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAyC,YAAY;GACzD,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,WAAW,aAAa,WAAW,oBAAoB,KAAK,CAAC,GAAmB,MAAM;EAClG,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,CAC7E,GAAI,MAAM,UACN,MAAM,QAAQ;GACd,OAAO,IAAI,IAAI,MAAM;GACrB,eAAe,IAAI,IAAI,MAAM;GAC7B,cAAc,IAAI,IAAI,MAAM;GAC5B,YAAY,IAAI,IAAI,MAAM;GAC1B,UAAU,IAAI,IAAI,MAAM;GACxB,QAAQ,IAAI,IAAI,MAAM;GACtB,QAAQ,IAAI,IAAI,MAAM;EACxB,CAAC,KAAK,CAAC,IACL,uBAAuB,IAAI,IAAI,OAAO,MAAM,OAAO;GACjD,SAAS,MAAM;GACf,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,eAAe,MAAM;GACrB,eAAe,MAAM;EACvB,CAAC,CACP,CAAC;CACH;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAE9B,IAAI,WAAW;EACf,kBAAkB;GAChB,IAAI,WAAW;EACjB,CAAC;EACD,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,kBAAkB;EAE9B,MAAM,cAAc,oBAAoB;EACxC,MAAM,aAAa,oBAAoB;EACvC,MAAM,aAAa,IAAwB,IAAI;EAI/C,MAAM,OAAO,cAAc;GACzB,kBAAkB,WAAW;GAC7B,MAAM,CAAC,YAAY,YAAY;GAC/B,QAAQ;GACR,cAAc,EAAE,KAAK,IAAI,QAAQ,KAAK,KAAK,EAAE;EAC/C,CAAC;EAED,gBAAgB,KAAK,QAAQ,CAAC;EAC9B,aAAa,CACX,EAAE,OAAO;GACP,GAAG,WAAW,WAAW,MAAM;IAAE,GAAG,YAAY;IAAO,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAA6B,CAAC,GAAG,KAAK;GAC9H,MAAM,OAAgB;IAAE,WAAW,QAAQ;GAAyB;EACtE,GAAG,MAAM,UAAU,CAAC,GACpB,GAAG,KAAK,OAAO,CACjB;CACF;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAG9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,wBAAwB,GAA8B,MAAM,UAAU,CAAC;CAChH;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO,EACL,OAAO;EAAE,MAAM;EAAQ,UAAU;CAAK,EACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,QAAQ,gBAAmC,EAAE,OAAO,MAAM,MAAM,EAAE;EACxE,wBAAwB,EAAE,MAAM,CAAC;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,MAAM,KAAK,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,UAAU,2BAA2B;EAC7C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,MAAM,KAAK,GAA8B,MAAM,UAAU,CAAC;CACpH;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EAEtC,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAChD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,OAAO,gBAAkC;GAAE,OAAO,MAAM;GAAO,UAAU,MAAM;EAAS,EAAE;EAChG,mBAAmB,EAAE,KAAK,CAAC;EAE3B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GACF,IAAI,QAAQ,KAAK,aAAa,KAAK,QAAQ,KAAK,YAAY,CAAC,EAAE,MAAK,SAAQ,KAAK,UAAU,MAAM,KAAK,GACpG;GACF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EACpD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,YAAY,CAAC;EACtC,CAAC;EACD,aAAa,EACX,OACA;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK;GAA8B,KAAK;EAAO,GACpF,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,SAAS,sBAAsB;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;;AAGD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,SAAS,sBAAsB;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;;AAGD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,SAAS,sBAAsB;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;;AAGD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,SAAS,sBAAsB;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,wBAAwB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACxH;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,MAAM,EAAE,SAAS,sBAAsB;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,sBAAsB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACtH;AACF,CAAC;;AAGD,MAAM,gBAAgB;CACpB,SAAS;CACT,WAAW;CACX,QAAQ;CACR,eAAe;CACf,aAAa;CACb,oBAAoB;CACpB,eAAe;CACf,kBAAkB;CAClB,SAAS;CACT,WAAW;AACb;;;;;AAcA,SAAS,uBAAuB,KAAiB,OAA2B,UAA0C;CAEpH,OAAO,gBADO,iBAAiB,KAAK;EAAE;EAAO,UAAS,SAAQ,SAAS,SAAwC;CAAK,CACzF,GAAG,gBAAgB,SAAS;EACrD,MAAM,OAAO,KAAK;EAClB,QAAQ,KAAK,MAAM,MAAnB;GACE,KAAK,SACH,OAAO,SAAS,QAAQ;GAC1B,KAAK,SACH,OAAO,SAAS,QAAQ;GAC1B,KAAK,QACH,OAAO,SAAS,OAAO,IAAI,KAAK,KAAK;GACvC,KAAK,eACH,OAAO,SAAS,cAAc,GAAG,IAAI;GACvC,KAAK,eACH,OAAO,SAAS,cAAc,GAAG,IAAI;GACvC,SACE;EACJ;CACF,CAAC;AACH"}

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

@@ -1,8 +1,13 @@
-import { ComputedRef } from "vue";
-import { Service } from "@xihan-ui/core";
 import { ListboxApi, ListboxSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 //#region src/components/listbox/use-listbox.d.ts
 interface ListboxContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhListboxLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<ListboxApi>;
   /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */
   service: Service<ListboxSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"use-listbox.d.ts","names":[],"sources":["../../../src/components/listbox/use-listbox.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,WACd,OAAO,wBACP,gBAAgB,0CACf"}
+{"version":3,"file":"use-listbox.d.ts","names":[],"sources":["../../../src/components/listbox/use-listbox.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,WACd,OAAO,wBACP,gBAAgB,0CACf"}

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

@@ -1,16 +1,20 @@
 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 { connectListbox, listboxMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/listbox/use-listbox.ts
 function useListbox(props, onValueChange) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(listboxMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	return {
+		labelCount,
 		api: computed(() => connectListbox(service, vueNormalize)),
 		service
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"use-listbox.js","names":[],"sources":["../../../src/components/listbox/use-listbox.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 listbox 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ListboxApi, ListboxSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectListbox, listboxMachine } 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 ListboxContext {\n  api: ComputedRef<ListboxApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<ListboxSchema>\n}\n\nexport function useListbox(\n  props: ListboxSchema['props'],\n  onValueChange?: ListboxSchema['props']['onValueChange'],\n): ListboxContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const service = useMachine(listboxMachine, () => ({ ...props, onValueChange }), scope)\n  const api = computed(() => connectListbox(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,WACd,OACA,eACgB;CAIhB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAc,IAF9D,YAAY,MADZ,qBACsB,CAEgD,CAAC;CAErF,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-listbox.js","names":[],"sources":["../../../src/components/listbox/use-listbox.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 listbox 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ListboxApi, ListboxSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectListbox, listboxMachine } 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 ListboxContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhListboxLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<ListboxApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<ListboxSchema>\n}\n\nexport function useListbox(\n  props: ListboxSchema['props'],\n  onValueChange?: ListboxSchema['props']['onValueChange'],\n): ListboxContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const labelCount = ref(0)\n  const service = useMachine(listboxMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange }), scope)\n  const api = computed(() => connectListbox(service, vueNormalize))\n  return { labelCount, api, service }\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,WACd,OACA,eACgB;CAEhB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;CAAc,IAAI,KAAK;CAErH,OAAO;EAAE;EAAY,KADT,eAAe,eAAe,SAAS,YAAY,CACxC;EAAG;CAAQ;AACpC"}

package/dist/components/loading-bar/loading-bar.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { LoadingBarApi, LoadingBarSchema, LoadingBarTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Tone } from "@xihan-ui/core";
-import { LoadingBarApi, LoadingBarSchema, LoadingBarTranslations } from "@xihan-ui/headless";
 //#region src/components/loading-bar/loading-bar.d.ts
 type LoadingBarProps = LoadingBarSchema['props'];
 /** 默认插槽的载荷：进度条的阶段、进度值、是否显示与是否不确定进度。 */

package/dist/components/loading-bar/use-loading-bar.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { LoadingBarApi, LoadingBarSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/loading-bar/use-loading-bar.d.ts
 interface LoadingBarContext {
   api: ComputedRef<LoadingBarApi>;

package/dist/components/loading-bar/use-loading-bar.js

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectLoadingBar, loadingBarMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectLoadingBar, loadingBarMachine } from "@xihan-ui/headless";
 //#region src/components/loading-bar/use-loading-bar.ts
 function useLoadingBar(props, onValueChange) {
 	const service = useMachine(loadingBarMachine, () => ({

package/dist/components/log/log.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CollectionVirtualizer, LogAnsiSegment, LogApi, LogLevel, LogSchema, LogTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { CollectionVirtualizer, LogAnsiSegment, LogApi, LogLevel, LogSchema, LogTranslations } from "@xihan-ui/headless";
 //#region src/components/log/log.d.ts
 /** 默认插槽的载荷：行数与载入态、粘底状态与按钮的显示情况，以及滚动到底部的句柄。 */
 type LogRootSlotProps = Pick<LogApi, 'rows' | 'loading' | 'atBottom' | 'sticking' | 'showScrollToEndTrigger' | 'scrollToBottom'>;

package/dist/components/log/log.js

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideLog, useLogContext } from "./context.js";
 import { useLog } from "./use-log.js";
-import { defineComponent, h } from "vue";
 import { parseAnsi } from "@xihan-ui/headless";
+import { defineComponent, h } from "vue";
 //#region src/components/log/log.ts
 const XhLogRoot = defineComponent({
 	name: "XhLogRoot",

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

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { LogApi, LogProps, LogSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/log/use-log.d.ts
 interface LogContext {
   api: ComputedRef<LogApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectLog, logMachine } from "@xihan-ui/headless";
 import { computed, ref, watch } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectLog, logMachine } from "@xihan-ui/headless";
 //#region src/components/log/use-log.ts
 /** 状态机只接收 onStickChange，rows / loading / translations 是纯视图属性，直接进入 connect。 */
 function useLog(props, onStickChange) {

package/dist/components/markdown-stream/markdown-stream.d.ts

@@ -1,6 +1,6 @@
+import { MarkdownBlock, MarkdownStreamApi, MarkdownStreamTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { MarkdownBlock, MarkdownStreamApi, MarkdownStreamTranslations } from "@xihan-ui/headless";
 //#region src/components/markdown-stream/markdown-stream.d.ts
 /** 默认插槽的载荷：块列表与流式状态，以及完成后要播报的文案。 */
 type MarkdownStreamRootSlotProps = Pick<MarkdownStreamApi, 'blocks' | 'streaming' | 'announcement'>;

package/dist/components/markdown-stream/markdown-stream.js

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideMarkdownStream, useMarkdownStreamContext } from "./context.js";
 import { useMarkdownStream } from "./use-markdown-stream.js";
-import { Teleport, defineComponent, h, onMounted, onUpdated, ref, shallowRef } from "vue";
 import { markdownBlockHtml, queryMarkdownInlines, sameMarkdownInlines } from "@xihan-ui/headless";
+import { Teleport, defineComponent, h, onMounted, onUpdated, ref, shallowRef } from "vue";
 //#region src/components/markdown-stream/markdown-stream.ts
 const XhMarkdownStreamRoot = defineComponent({
 	name: "XhMarkdownStreamRoot",

package/dist/components/markdown-stream/use-markdown-stream.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { MarkdownStreamApi, MarkdownStreamProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/markdown-stream/use-markdown-stream.d.ts
 interface MarkdownStreamContext {
   api: ComputedRef<MarkdownStreamApi>;

package/dist/components/markdown-stream/use-markdown-stream.js

@@ -1,6 +1,6 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { computed } from "vue";
 import { connectMarkdownStream } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/markdown-stream/use-markdown-stream.ts
 function useMarkdownStream(props) {
 	return { api: computed(() => connectMarkdownStream(props, vueNormalize)) };

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { MarqueeApi } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/marquee/context.d.ts
 interface MarqueeContext {
   api: ComputedRef<MarqueeApi>;

package/dist/components/marquee/marquee.d.ts

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { MarqueeDirection, MarqueeSchema, MarqueeTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/marquee/marquee.d.ts
 type MarqueeProps = MarqueeSchema['props'];
 declare const XhMarqueeRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

package/dist/components/marquee/marquee.js

@@ -4,9 +4,9 @@ import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { provideMarquee, useMarqueeContext } from "./context.js";
+import { connectMarquee, marqueeMachine } from "@xihan-ui/headless";
 import { computed, defineComponent, h } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectMarquee, marqueeMachine } from "@xihan-ui/headless";
 //#region src/components/marquee/marquee.ts
 const XhMarqueeRoot = defineComponent({
 	name: "XhMarqueeRoot",

package/dist/components/masonry/masonry.d.ts

@@ -1,5 +1,5 @@
-import { PropType, VNode } from "vue";
 import { MasonryColumns, MasonryProps } from "@xihan-ui/headless";
+import { PropType, VNode } from "vue";
 //#region src/components/masonry/masonry.d.ts
 /** 断点对象形态的列数，从 MasonryProps 上取，不在这里另抄一份档位清单。 */
 type ColumnsByBreakpoint = Exclude<MasonryColumns, number>;

package/dist/components/masonry/masonry.js

@@ -1,6 +1,6 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { Comment, Fragment, Text, defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from "vue";
 import { connectMasonry, distributeMasonry, measureMasonry, resolveMasonryColumns, sameMasonryHeights } from "@xihan-ui/headless";
+import { Comment, Fragment, Text, defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from "vue";
 //#region src/components/masonry/masonry.ts
 /** 列数的档位名，base 在前，其余自窄到宽。 */
 const COLUMN_TIERS = [

package/dist/components/matrix-code/context.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { MatrixCodeApi } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/matrix-code/context.d.ts
 interface MatrixCodeContext {
   api: ComputedRef<MatrixCodeApi>;

package/dist/components/matrix-code/matrix-code.d.ts

@@ -1,5 +1,5 @@
-import { PropType, VNode } from "vue";
 import { MatrixCodeFormat, MatrixCodeLevel, MatrixCodeProps } from "@xihan-ui/headless";
+import { PropType, VNode } from "vue";
 //#region src/components/matrix-code/matrix-code.d.ts
 type ModuleShape = NonNullable<MatrixCodeProps['moduleShape']>;
 type EyeShape = NonNullable<MatrixCodeProps['eyeShape']>;

package/dist/components/matrix-code/matrix-code.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { provideMatrixCode, useMatrixCodeContext } from "./context.js";
-import { computed, defineComponent, h, shallowRef } from "vue";
 import { connectMatrixCode } from "@xihan-ui/headless";
+import { computed, defineComponent, h, shallowRef } from "vue";
 //#region src/components/matrix-code/matrix-code.ts
 /**
 * 整张码绘制为一个 `<svg>`，`format` 选择码制；QR 下数据模块与三个码眼各成一条 `<path>`，其余码制只有前一条，静区依靠 viewBox 留出。

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

@@ -1,6 +1,6 @@
 import { MentionContext } from "./use-mention.js";
-import { ComputedRef } from "vue";
 import { MentionItemProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/mention/context.d.ts
 /** 候选声明的值与禁用，供 item-text 复用同一份声明。 */
 interface MentionItemContext {

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

@@ -1,18 +1,28 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { MentionApi, MentionInputHost, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { MentionApi, MentionInputHost, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from "@xihan-ui/headless";
 //#region src/components/mention/mention.d.ts
 type MentionProps = MentionSchema['props'];
 /** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选、正文里仍然完整的提及，以及改写正文与收起浮层的句柄。 */
 type MentionRootSlotProps = Pick<MentionApi, 'open' | 'value' | 'query' | 'activePrefix' | 'highlightedValue' | 'mentions' | 'setValue' | 'close'>;
 declare const XhMentionRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   triggerPrefix: {
     type: PropType<string | string[]>;
   };
   collection: {
     type: PropType<MentionNode[]>;
   };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时输入框铺成多行的 textarea；写了默认插槽时在 XhMentionInput 上写 as="textarea"。 */
+  multiline: BooleanConstructor;
   value: {
     type: StringConstructor;
   };
@@ -69,16 +79,26 @@ declare const XhMentionRoot: import("vue").DefineComponent<import("vue").Extract
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'value-change': (_details: PayloadOf<MentionProps, "onValueChange">) => true;
   'query-change': (_details: PayloadOf<MentionProps, "onQueryChange">) => true;
-  select: (_details: PayloadOf<MentionProps, "onSelect">) => true;
+  'item-select': (_details: PayloadOf<MentionProps, "onItemSelect">) => true;
   'open-change': (_details: PayloadOf<MentionProps, "onOpenChange">) => true;
   'update:value': (_value: PayloadOf<MentionProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   triggerPrefix: {
     type: PropType<string | string[]>;
   };
   collection: {
     type: PropType<MentionNode[]>;
   };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时输入框铺成多行的 textarea；写了默认插槽时在 XhMentionInput 上写 as="textarea"。 */
+  multiline: BooleanConstructor;
   value: {
     type: StringConstructor;
   };
@@ -131,10 +151,10 @@ declare const XhMentionRoot: import("vue").DefineComponent<import("vue").Extract
     type: PropType<Size>;
   };
 }>> & Readonly<{
-  onSelect?: ((_details: import("@xihan-ui/headless").MentionSelectDetails) => any) | undefined;
   "onValue-change"?: ((_details: import("@xihan-ui/headless").MentionValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string) => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").MentionOpenChangeDetails) => any) | undefined;
+  "onItem-select"?: ((_details: import("@xihan-ui/headless").MentionItemSelectDetails) => any) | undefined;
   "onQuery-change"?: ((_details: import("@xihan-ui/headless").MentionQueryChangeDetails) => any) | undefined;
 }>, {
   invalid: boolean;
@@ -142,8 +162,10 @@ declare const XhMentionRoot: import("vue").DefineComponent<import("vue").Extract
   disabled: boolean;
   loading: boolean;
   readOnly: boolean;
+  multiline: boolean;
 }, SlotsType<{
   default?: (props: MentionRootSlotProps) => VNode[];
+  label?: () => VNode[];
   /** 铺开 collection 时每条候选的文本插槽。 */
   item?: (props: MentionNodeMeta) => VNode[];
   /** 只接管行首那一格，其余槽照旧由数据铺 */

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

@@ -1 +1 @@
-{"version":3,"file":"mention.d.ts","names":[],"sources":["../../../src/components/mention/mention.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KACjC;cAWW,6BAAa,8BAAA;;IAIoB,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EAChB,SAAA,UAAA,UAAU;EACL,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;;;IA1BO,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;EAWrB,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,oBAAoB;;EAErB,iBAAC,OAAO,oBAAoB;;EAE5B,iBAAC,OAAO,oBAAoB;;EAElC,cAAM;kCA0ClB;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;IAOD,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAcjC;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"mention.d.ts","names":[],"sources":["../../../src/components/mention/mention.ts"],"mappings":";;;;;KAsBK,eAAe;;KAGR,uBAAuB,KACjC;cAWW,6BAAa,8BAAA;;;;;;IAMoB,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;;;;;;;IA9BO,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;EAWrB,WAAC,OAAO,yBAAyB;EACnC,cAAM;;EAEP,QAAC,OAAO,oBAAoB;;EAErB,iBAAC,OAAO,oBAAoB;;EAE5B,iBAAC,OAAO,oBAAoB;;EAElC,cAAM;kCA8ClB;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAWzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;IAOD,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAcjC;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/mention/mention.js

@@ -1,3 +1,4 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
@@ -5,13 +6,20 @@ import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideMention, provideMentionItem, useMentionContext, useMentionItemContext } from "./context.js";
 import { useMention } from "./use-mention.js";
+import { mentionStructure } from "@xihan-ui/headless";
 import { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from "vue";
 //#region src/components/mention/mention.ts
 const XhMentionRoot = defineComponent({
 	name: "XhMentionRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		triggerPrefix: { type: [String, Array] },
 		collection: { type: Array },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不写默认插槽时输入框铺成多行的 textarea；写了默认插槽时在 XhMentionInput 上写 as="textarea"。 */
+		multiline: Boolean,
 		value: { type: String },
 		defaultValue: { type: String },
 		disabled: {
@@ -45,7 +53,7 @@ const XhMentionRoot = defineComponent({
 	emits: {
 		"value-change": (_details) => true,
 		"query-change": (_details) => true,
-		"select": (_details) => true,
+		"item-select": (_details) => true,
 		"open-change": (_details) => true,
 		"update:value": (_value) => true
 	},
@@ -56,12 +64,12 @@ const XhMentionRoot = defineComponent({
 			emit("update:value", details.value);
 		};
 		const notifyQuery = (details) => emit("query-change", details);
-		const notifySelect = (details) => emit("select", details);
+		const notifyItemSelect = (details) => emit("item-select", details);
 		const notifyOpen = (details) => emit("open-change", details);
 		const ctx = useMention(withXhConfig("mention", useFormControlProps(props)), {
 			onValueChange: notifyValue,
 			onQueryChange: notifyQuery,
-			onSelect: notifySelect,
+			onItemSelect: notifyItemSelect,
 			onOpenChange: notifyOpen
 		});
 		provideMention(ctx);
@@ -76,7 +84,16 @@ const XhMentionRoot = defineComponent({
 			mentions: ctx.api.value.mentions,
 			setValue: ctx.api.value.setValue,
 			close: ctx.api.value.close
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, ctx.api.value.emptyText, slots.item, slots["item-prefix"], slots["item-suffix"], slots.empty) : []);
+		}) : renderDefaultStructure(ctx.api.value, {
+			label: props.label,
+			multiline: props.multiline
+		}, {
+			"label": slots.label,
+			"empty": slots.empty,
+			"item": slots.item,
+			"item-prefix": slots["item-prefix"],
+			"item-suffix": slots["item-suffix"]
+		}));
 	}
 });
 /** 标题；必须是原生 label，getLabelProps 的 for 恒指向输入框。 */
@@ -84,6 +101,10 @@ const XhMentionLabel = defineComponent({
 	name: "XhMentionLabel",
 	setup(_, { slots }) {
 		const ctx = useMentionContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -225,22 +246,54 @@ const XhMentionItemDescription = defineComponent({
 		return () => h("span", ctx.api.value.getItemDescriptionProps(item.value), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const MENTION_PARTS = {
+	"label": XhMentionLabel,
+	"input": XhMentionInput,
+	"positioner": XhMentionPositioner,
+	"content": XhMentionContent,
+	"item": XhMentionItem,
+	"item-prefix": XhMentionItemPrefix,
+	"item-text": XhMentionItemText,
+	"item-description": XhMentionItemDescription,
+	"item-suffix": XhMentionItemSuffix,
+	"empty": XhMentionEmpty,
+	"loading": XhMentionLoading
+};
+/** 多行形态的输入框：标准结构开了 multiline 时顶替 input 部件。 */
+const MentionTextarea = defineComponent({
+	name: "XhMentionTextarea",
+	inheritAttrs: false,
+	setup(_, { attrs }) {
+		return () => h(XhMentionInput, {
+			...attrs,
+			as: "textarea"
+		});
+	}
+});
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 mentionStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题、空态、候选文字与行首行尾由对应插槽接管；开了 multiline 时输入框是 textarea。
 * 过滤仍归调用方：collection 就是当前应显示的候选。
 */
-function renderDefaultTree(collection, defaultEmpty, itemSlot, prefixSlot, suffixSlot, emptySlot) {
-	const emptyText = emptySlot?.() ?? defaultEmpty;
-	return [h(XhMentionInput), h(XhMentionPositioner, null, () => [h(XhMentionContent, null, () => collection.map((node) => h(XhMentionItem, {
-		key: node.value,
-		value: node.value
-	}, () => [
-		...prefixSlot ? [h(XhMentionItemPrefix, null, () => prefixSlot(node))] : [],
-		h(XhMentionItemText, null, () => itemSlot?.(node) ?? node.label),
-		...node.description != null ? [h(XhMentionItemDescription, null, () => node.description)] : [],
-		...suffixSlot ? [h(XhMentionItemSuffix, null, () => suffixSlot(node))] : []
-	]))), h(XhMentionEmpty, null, () => emptyText)])];
+function renderDefaultStructure(api, options, authored) {
+	return renderStructure(mentionStructure(api, {
+		...options,
+		slotted: (name) => authored[name] != null
+	}), options.multiline ? {
+		...MENTION_PARTS,
+		input: MentionTextarea
+	} : MENTION_PARTS, (node) => {
+		const meta = node.data;
+		switch (node.slot?.name) {
+			case "label": return authored.label?.();
+			case "empty": return authored.empty?.();
+			case "item": return authored.item?.(meta) ?? meta.label;
+			case "item-prefix": return authored["item-prefix"]?.(meta);
+			case "item-suffix": return authored["item-suffix"]?.(meta);
+			default: return;
+		}
+	});
 }
 //#endregion
 export { XhMentionContent, XhMentionEmpty, XhMentionInput, XhMentionItem, XhMentionItemDescription, XhMentionItemPrefix, XhMentionItemSuffix, XhMentionItemText, XhMentionLabel, XhMentionLoading, XhMentionPositioner, XhMentionRoot };