@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/combobox/combobox.js

@@ -1,3 +1,4 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotIsPlainText } from "../../runtime/slot-content.js";
@@ -7,11 +8,14 @@ import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideCombobox, provideComboboxItem, provideComboboxItemGroup, provideComboboxTag, useComboboxContext, useComboboxItemContext, useComboboxItemGroupContext, useComboboxTagContext } from "./context.js";
 import { useCombobox } from "./use-combobox.js";
+import { comboboxStructure } from "@xihan-ui/headless";
 import { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from "vue";
 //#region src/components/combobox/combobox.ts
 const XhComboboxRoot = defineComponent({
 	name: "XhComboboxRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		virtualizer: { type: Object },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
@@ -45,6 +49,10 @@ const XhComboboxRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		loading: Boolean,
 		loop: {
 			type: Boolean,
@@ -111,13 +119,23 @@ const XhComboboxRoot = defineComponent({
 			setInputValue: ctx.api.value.setInputValue,
 			clear: ctx.api.value.clear,
 			deselect: ctx.api.value.deselect
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, props.multiple ? ctx.api.value.tags : null, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.empty?.() ?? (props.empty != null ? [props.empty] : null), slots.item, props.clearable, slots["item-prefix"], slots["item-suffix"]) : []);
+		}) : renderDefaultStructure(ctx.api.value, props, {
+			"label": slots.label,
+			"empty": slots.empty,
+			"item": slots.item,
+			"item-prefix": slots["item-prefix"],
+			"item-suffix": slots["item-suffix"]
+		}));
 	}
 });
 const XhComboboxLabel = defineComponent({
 	name: "XhComboboxLabel",
 	setup(_, { slots }) {
 		const ctx = useComboboxContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -358,10 +376,13 @@ const XhComboboxHiddenInput = defineComponent({
 	inheritAttrs: false,
 	setup(_, { attrs }) {
 		const ctx = useComboboxContext();
-		return () => ctx.api.value.value.map((value) => h("input", {
+		return () => [...ctx.api.value.value.map((value) => h("input", {
 			...mergeProps(ctx.api.value.getHiddenInputProps({ value }), attrs),
 			key: value
-		}));
+		})), ...ctx.api.value.value.length === 0 && ctx.api.value.required ? [h("input", {
+			...mergeProps(ctx.api.value.getHiddenInputProps(), attrs),
+			key: "required"
+		})] : []];
 	}
 });
 const XhComboboxEmpty = defineComponent({
@@ -375,37 +396,55 @@ const XhComboboxLoading = defineComponent({
 	name: "XhComboboxLoading",
 	setup(_, { slots }) {
 		const ctx = useComboboxContext();
-		return () => h("div", ctx.api.value.getLoadingProps(), slots.default?.());
+		return () => h("div", ctx.api.value.getLoadingProps(), slots.default?.() ?? ctx.api.value.translations.loading);
 	}
 });
+/** 标准结构里各部件对应的组件；标签、标签文字、删除钮与 +N 委派给 tag，按「tag/部件名」找。 */
+const COMBOBOX_PARTS = {
+	"label": XhComboboxLabel,
+	"control": XhComboboxControl,
+	"tag-list": XhComboboxTagList,
+	"tag/tag": XhComboboxTag,
+	"tag/tag-label": XhComboboxTagLabel,
+	"tag/item-delete-trigger": XhComboboxItemDeleteTrigger,
+	"tag/overflow-tag": XhComboboxOverflowTag,
+	"input": XhComboboxInput,
+	"clear-trigger": XhComboboxClearTrigger,
+	"trigger": XhComboboxTrigger,
+	"positioner": XhComboboxPositioner,
+	"content": XhComboboxContent,
+	"item": XhComboboxItem,
+	"item-prefix": XhComboboxItemPrefix,
+	"item-text": XhComboboxItemText,
+	"item-description": XhComboboxItemDescription,
+	"item-suffix": XhComboboxItemSuffix,
+	"item-indicator": XhComboboxItemIndicator,
+	"empty": XhComboboxEmpty,
+	"loading": XhComboboxLoading,
+	"hidden-input": XhComboboxHiddenInput
+};
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 comboboxStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题、空态、条目文字与行首行尾由对应插槽接管。
 * 过滤仍归调用方：collection 就是当前应显示的候选。
 */
-function renderDefaultTree(collection, tags, label, empty, itemSlot, clearable, prefixSlot, suffixSlot) {
-	return [
-		...label ? [h(XhComboboxLabel, null, () => label)] : [],
-		h(XhComboboxControl, null, () => [
-			...tags ? [h(XhComboboxTagList, null, () => [...tags.map((tag) => h(XhComboboxTag, {
-				key: tag.value,
-				value: tag.value
-			}, () => [h(XhComboboxTagLabel, null, () => tag.label), h(XhComboboxItemDeleteTrigger)])), h(XhComboboxOverflowTag)])] : [],
-			h(XhComboboxInput),
-			...clearable ? [h(XhComboboxClearTrigger)] : [],
-			h(XhComboboxTrigger)
-		]),
-		h(XhComboboxPositioner, null, () => [h(XhComboboxContent, null, () => collection.map((node) => h(XhComboboxItem, {
-			key: node.value,
-			value: node.value
-		}, () => [
-			...prefixSlot ? [h(XhComboboxItemPrefix, null, () => prefixSlot(node))] : [],
-			h(XhComboboxItemText, null, () => itemSlot?.(node) ?? node.label),
-			...node.description != null ? [h(XhComboboxItemDescription, null, () => node.description)] : [],
-			...suffixSlot ? [h(XhComboboxItemSuffix, null, () => suffixSlot(node))] : [],
-			h(XhComboboxItemIndicator)
-		]))), h(XhComboboxEmpty, null, () => empty ?? [])])
-	];
+function renderDefaultStructure(api, props, content) {
+	return renderStructure(comboboxStructure(api, {
+		label: props.label,
+		empty: props.empty,
+		clearable: props.clearable,
+		slotted: (name) => content[name] != null
+	}), COMBOBOX_PARTS, (node) => {
+		const meta = node.data;
+		switch (node.slot?.name) {
+			case "label": return content.label?.();
+			case "empty": return content.empty?.();
+			case "item": return content.item?.(meta) ?? meta.label;
+			case "item-prefix": return content["item-prefix"]?.(meta);
+			case "item-suffix": return content["item-suffix"]?.(meta);
+			default: return;
+		}
+	});
 }
 //#endregion
 export { XhComboboxClearTrigger, XhComboboxContent, XhComboboxControl, XhComboboxEmpty, XhComboboxGroup, XhComboboxGroupLabel, XhComboboxHiddenInput, XhComboboxInput, XhComboboxItem, XhComboboxItemDeleteTrigger, XhComboboxItemDescription, XhComboboxItemIndicator, XhComboboxItemPrefix, XhComboboxItemSuffix, XhComboboxItemText, XhComboboxLabel, XhComboboxLoading, XhComboboxOverflowTag, XhComboboxPositioner, XhComboboxRoot, XhComboboxTag, XhComboboxTagLabel, XhComboboxTagList, XhComboboxTrigger };

package/dist/components/combobox/combobox.js.map

@@ -1 +1 @@
-{"version":3,"file":"combobox.js","names":[],"sources":["../../../src/components/combobox/combobox.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// 提供 combobox 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, ComboboxApi, ComboboxGroupProps, ComboboxInputBehavior, ComboboxInputEl, ComboboxInputHost, ComboboxItemProps, ComboboxNode, ComboboxNodeMeta, ComboboxSchema, ComboboxTagMeta } 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 { slotIsPlainText } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCombobox,\n  provideComboboxItem,\n  provideComboboxItemGroup,\n  provideComboboxTag,\n  useComboboxContext,\n  useComboboxItemContext,\n  useComboboxItemGroupContext,\n  useComboboxTagContext,\n} from './context'\nimport { useCombobox } from './use-combobox'\n\ntype ComboboxProps = ComboboxSchema['props']\n\n/** 默认插槽的载荷：展开状态、选中值、输入串、高亮候选、空态、多选的可见标签与折起的个数，以及修改它们的命令。 */\nexport type ComboboxRootSlotProps = Pick<\n  ComboboxApi,\n  'open' | 'value' | 'inputValue' | 'highlightedValue' | 'empty' | 'tags' | 'overflowCount' | 'overflowText' | 'isSelected' | 'setOpen' | 'setValue' | 'setInputValue' | 'clear' | 'deselect'\n>\n\nexport const XhComboboxRoot = defineComponent({\n  name: 'XhComboboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ComboboxNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 无匹配时的提示语。提供后不必再写 empty 部件；需要放置其他内容时改用 empty 插槽。 */\n    empty: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    inputValue: { type: String },\n    defaultInputValue: { type: String },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    form: { type: String },\n    multiple: Boolean,\n    /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */\n    maxTagCount: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    loop: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    /** 自动铺开时是否渲染清空按钮；手写部件模式不使用它，写了节点即可清空 */\n    clearable: Boolean,\n    translations: { type: Object as PropType<ComboboxProps['translations']> },\n    allowCustomValue: Boolean,\n    openOnClick: Boolean,\n    inputBehavior: { type: String as PropType<ComboboxInputBehavior> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\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    'clear': () => true,\n    'value-change': (_details: PayloadOf<ComboboxProps, 'onValueChange'>) => true,\n    'input-value-change': (_details: PayloadOf<ComboboxProps, 'onInputValueChange'>) => true,\n    'open-change': (_details: PayloadOf<ComboboxProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<ComboboxProps, 'onValueChange'>['value']) => true,\n    'update:inputValue': (_inputValue: PayloadOf<ComboboxProps, 'onInputValueChange'>['inputValue']) => true,\n    'update:open': (_open: PayloadOf<ComboboxProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ComboboxRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    'empty'?: () => VNode[]\n    /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */\n    'item'?: (node: ComboboxNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ComboboxNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ComboboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: ComboboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyInputValue: ComboboxProps['onInputValueChange'] = (details) => {\n      emit('input-value-change', details)\n      emit('update:inputValue', details.inputValue)\n    }\n    const notifyOpen: ComboboxProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCombobox(withHandlers(withXhConfig('combobox', useFormControlProps(props)), { onClear: () => emit('clear') }) as ComboboxProps, {\n      onValueChange: notifyValue,\n      onInputValueChange: notifyInputValue,\n      onOpenChange: notifyOpen,\n    })\n    provideCombobox(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            inputValue: ctx.api.value.inputValue,\n            highlightedValue: ctx.api.value.highlightedValue,\n            empty: ctx.api.value.empty,\n            tags: ctx.api.value.tags,\n            overflowCount: ctx.api.value.overflowCount,\n            overflowText: ctx.api.value.overflowText,\n            isSelected: ctx.api.value.isSelected,\n            setOpen: ctx.api.value.setOpen,\n            setValue: ctx.api.value.setValue,\n            setInputValue: ctx.api.value.setInputValue,\n            clear: ctx.api.value.clear,\n            deselect: ctx.api.value.deselect,\n          })\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              props.multiple ? ctx.api.value.tags : null,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.empty?.() ?? (props.empty != null ? [props.empty] : null),\n              slots.item,\n              props.clearable,\n              slots['item-prefix'],\n              slots['item-suffix'],\n            )\n          : [],\n    )\n  },\n})\n\nexport const XhComboboxLabel = defineComponent({\n  name: 'XhComboboxLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 用原生 label，connect 给的 for 指向输入框\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxControl = defineComponent({\n  name: 'XhComboboxControl',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('div', {\n      ...ctx.api.value.getControlProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.controlRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhComboboxTagList = defineComponent({\n  name: 'XhComboboxTagList',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 标签行：盒里、输入框之前，可见标签与 +N 那一枚在里面并排；单选或无选中时连接层给 hidden\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */\nexport const XhComboboxTagLabel = defineComponent({\n  name: 'XhComboboxTagLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把\n * 删除按钮挤出；作者自己写了节点则原样放行。与 XhTagRoot 同一规则。\n * 库自身填入的文字（+N，没有折叠时是空串）恒包 label，三个适配器渲染出同一棵树。\n */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhComboboxTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhComboboxTagLabel, null, () => content)] : content\n}\n\n/** 一个选中值一个标签，即库内 tag 的 root（data-scope=\"tag\"）：语气、尺寸与禁用从组合框传下，形态按盒的面派生；配合 XhComboboxItemDeleteTrigger 可删除。 */\nexport const XhComboboxTag = defineComponent({\n  name: 'XhComboboxTag',\n  props: {\n    /** 它代表哪个选中值。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    provideComboboxTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhComboboxOverflowTag = defineComponent({\n  name: 'XhComboboxOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope=\"tag\"），可及名使用 translations.deleteItem；点按移除所在标签的选中值，焦点留在输入框。 */\nexport const XhComboboxItemDeleteTrigger = defineComponent({\n  name: 'XhComboboxItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const tag = useComboboxTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxInput = defineComponent({\n  name: 'XhComboboxInput',\n  props: {\n    /**\n     * 输入框渲染为哪个标签，默认 input。\n     * 写 textarea 即多行宿主：connect 随之撤销 type、role 与 aria-expanded。\n     */\n    as: { type: String as PropType<ComboboxInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useComboboxContext()\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 ComboboxInputEl },\n    }))\n  },\n})\n\nexport const XhComboboxTrigger = defineComponent({\n  name: 'XhComboboxTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxClearTrigger = defineComponent({\n  name: 'XhComboboxClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxPositioner = defineComponent({\n  name: 'XhComboboxPositioner',\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 = useComboboxContext()\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.controlRef, 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 XhComboboxContent = defineComponent({\n  name: 'XhComboboxContent',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhComboboxGroup = defineComponent({\n  name: 'XhComboboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    const group = computed<ComboboxGroupProps>(() => ({ value: props.value }))\n    provideComboboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxGroupLabel = defineComponent({\n  name: 'XhComboboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { group } = useComboboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItem = defineComponent({\n  name: 'XhComboboxItem',\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 = useComboboxContext()\n    const item = computed<ComboboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideComboboxItem({ 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 XhComboboxItemText = defineComponent({\n  name: 'XhComboboxItemText',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhComboboxItemPrefix = defineComponent({\n  name: 'XhComboboxItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhComboboxItemSuffix = defineComponent({\n  name: 'XhComboboxItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhComboboxItemDescription = defineComponent({\n  name: 'XhComboboxItemDescription',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItemIndicator = defineComponent({\n  name: 'XhComboboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxHiddenInput = defineComponent({\n  name: 'XhComboboxHiddenInput',\n  inheritAttrs: false,\n  setup(_, { attrs }) {\n    const ctx = useComboboxContext()\n    // 表单出口，不写这个部件即不参与表单提交\n    // 合并而不是展开：作者的 class 与部件的挂载类拼起来，不互相覆盖\n    return () => ctx.api.value.value.map(value => h('input', {\n      ...mergeProps(ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown>, attrs),\n      key: value,\n    }))\n  },\n})\n\nexport const XhComboboxEmpty = defineComponent({\n  name: 'XhComboboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 放在 positioner 里作 content 的兄弟节点，不进 role=listbox\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxLoading = defineComponent({\n  name: 'XhComboboxLoading',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultTree(\n  collection: readonly ComboboxNodeMeta[],\n  tags: readonly ComboboxTagMeta[] | null,\n  label: (VNode | string)[] | null,\n  empty: (VNode | string)[] | null,\n  itemSlot: ((node: ComboboxNodeMeta) => VNode[]) | undefined,\n  clearable: boolean,\n  prefixSlot?: (node: ComboboxNodeMeta) => VNode[],\n  suffixSlot?: (node: ComboboxNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhComboboxLabel, null, () => label)] : []),\n    h(XhComboboxControl, null, () => [\n      // 多选的已选项排在输入框之前：一枚一个带删除钮的标签，摆不下的折进 +N\n      ...(tags\n        ? [h(XhComboboxTagList, null, () => [\n            ...tags.map(tag => h(XhComboboxTag, { key: tag.value, value: tag.value }, () => [\n              h(XhComboboxTagLabel, null, () => tag.label),\n              h(XhComboboxItemDeleteTrigger),\n            ])),\n            h(XhComboboxOverflowTag),\n          ])]\n        : []),\n      h(XhComboboxInput),\n      ...(clearable ? [h(XhComboboxClearTrigger)] : []),\n      h(XhComboboxTrigger),\n    ]),\n    h(XhComboboxPositioner, null, () => [\n      h(XhComboboxContent, null, () => collection.map(node =>\n        h(XhComboboxItem, { key: node.value, value: node.value }, () => [\n          ...(prefixSlot ? [h(XhComboboxItemPrefix, null, () => prefixSlot(node))] : []),\n          h(XhComboboxItemText, null, () => itemSlot?.(node) ?? node.label),\n          ...(node.description != null ? [h(XhComboboxItemDescription, null, () => node.description)] : []),\n          ...(suffixSlot ? [h(XhComboboxItemSuffix, null, () => suffixSlot(node))] : []),\n          h(XhComboboxItemIndicator),\n        ]),\n      )),\n      // 空态节点是 content 的兄弟，不进 role=listbox\n      h(XhComboboxEmpty, null, () => empty ?? []),\n    ]),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"combobox.js","names":[],"sources":["../../../src/components/combobox/combobox.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// 提供 combobox 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, ComboboxApi, ComboboxGroupProps, ComboboxInputBehavior, ComboboxInputEl, ComboboxInputHost, ComboboxItemProps, ComboboxNode, ComboboxNodeMeta, ComboboxSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { comboboxStructure } 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 { slotIsPlainText } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCombobox,\n  provideComboboxItem,\n  provideComboboxItemGroup,\n  provideComboboxTag,\n  useComboboxContext,\n  useComboboxItemContext,\n  useComboboxItemGroupContext,\n  useComboboxTagContext,\n} from './context'\nimport { useCombobox } from './use-combobox'\n\ntype ComboboxProps = ComboboxSchema['props']\n\n/** 默认插槽的载荷：展开状态、选中值、输入串、高亮候选、空态、多选的可见标签与折起的个数，以及修改它们的命令。 */\nexport type ComboboxRootSlotProps = Pick<\n  ComboboxApi,\n  'open' | 'value' | 'inputValue' | 'highlightedValue' | 'empty' | 'tags' | 'overflowCount' | 'overflowText' | 'isSelected' | 'setOpen' | 'setValue' | 'setInputValue' | 'clear' | 'deselect'\n>\n\nexport const XhComboboxRoot = defineComponent({\n  name: 'XhComboboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    collection: { type: Array as PropType<ComboboxNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 无匹配时的提示语。提供后不必再写 empty 部件；需要放置其他内容时改用 empty 插槽。 */\n    empty: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    inputValue: { type: String },\n    defaultInputValue: { type: String },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    form: { type: String },\n    multiple: Boolean,\n    /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */\n    maxTagCount: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    loading: Boolean,\n    loop: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    /** 自动铺开时是否渲染清空按钮；手写部件模式不使用它，写了节点即可清空 */\n    clearable: Boolean,\n    translations: { type: Object as PropType<ComboboxProps['translations']> },\n    allowCustomValue: Boolean,\n    openOnClick: Boolean,\n    inputBehavior: { type: String as PropType<ComboboxInputBehavior> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\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    'clear': () => true,\n    'value-change': (_details: PayloadOf<ComboboxProps, 'onValueChange'>) => true,\n    'input-value-change': (_details: PayloadOf<ComboboxProps, 'onInputValueChange'>) => true,\n    'open-change': (_details: PayloadOf<ComboboxProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<ComboboxProps, 'onValueChange'>['value']) => true,\n    'update:inputValue': (_inputValue: PayloadOf<ComboboxProps, 'onInputValueChange'>['inputValue']) => true,\n    'update:open': (_open: PayloadOf<ComboboxProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ComboboxRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    'empty'?: () => VNode[]\n    /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */\n    'item'?: (node: ComboboxNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ComboboxNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ComboboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: ComboboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyInputValue: ComboboxProps['onInputValueChange'] = (details) => {\n      emit('input-value-change', details)\n      emit('update:inputValue', details.inputValue)\n    }\n    const notifyOpen: ComboboxProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCombobox(withHandlers(withXhConfig('combobox', useFormControlProps(props)), { onClear: () => emit('clear') }) as ComboboxProps, {\n      onValueChange: notifyValue,\n      onInputValueChange: notifyInputValue,\n      onOpenChange: notifyOpen,\n    })\n    provideCombobox(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            inputValue: ctx.api.value.inputValue,\n            highlightedValue: ctx.api.value.highlightedValue,\n            empty: ctx.api.value.empty,\n            tags: ctx.api.value.tags,\n            overflowCount: ctx.api.value.overflowCount,\n            overflowText: ctx.api.value.overflowText,\n            isSelected: ctx.api.value.isSelected,\n            setOpen: ctx.api.value.setOpen,\n            setValue: ctx.api.value.setValue,\n            setInputValue: ctx.api.value.setInputValue,\n            clear: ctx.api.value.clear,\n            deselect: ctx.api.value.deselect,\n          })\n        : renderDefaultStructure(ctx.api.value, props, {\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 XhComboboxLabel = defineComponent({\n  name: 'XhComboboxLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 用原生 label，connect 给的 for 指向输入框\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxControl = defineComponent({\n  name: 'XhComboboxControl',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('div', {\n      ...ctx.api.value.getControlProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.controlRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhComboboxTagList = defineComponent({\n  name: 'XhComboboxTagList',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 标签行：盒里、输入框之前，可见标签与 +N 那一枚在里面并排；单选或无选中时连接层给 hidden\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */\nexport const XhComboboxTagLabel = defineComponent({\n  name: 'XhComboboxTagLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把\n * 删除按钮挤出；作者自己写了节点则原样放行。与 XhTagRoot 同一规则。\n * 库自身填入的文字（+N，没有折叠时是空串）恒包 label，三个适配器渲染出同一棵树。\n */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhComboboxTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhComboboxTagLabel, null, () => content)] : content\n}\n\n/** 一个选中值一个标签，即库内 tag 的 root（data-scope=\"tag\"）：语气、尺寸与禁用从组合框传下，形态按盒的面派生；配合 XhComboboxItemDeleteTrigger 可删除。 */\nexport const XhComboboxTag = defineComponent({\n  name: 'XhComboboxTag',\n  props: {\n    /** 它代表哪个选中值。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    provideComboboxTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhComboboxOverflowTag = defineComponent({\n  name: 'XhComboboxOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope=\"tag\"），可及名使用 translations.deleteItem；点按移除所在标签的选中值，焦点留在输入框。 */\nexport const XhComboboxItemDeleteTrigger = defineComponent({\n  name: 'XhComboboxItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const tag = useComboboxTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxInput = defineComponent({\n  name: 'XhComboboxInput',\n  props: {\n    /**\n     * 输入框渲染为哪个标签，默认 input。\n     * 写 textarea 即多行宿主：connect 随之撤销 type、role 与 aria-expanded。\n     */\n    as: { type: String as PropType<ComboboxInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useComboboxContext()\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 ComboboxInputEl },\n    }))\n  },\n})\n\nexport const XhComboboxTrigger = defineComponent({\n  name: 'XhComboboxTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxClearTrigger = defineComponent({\n  name: 'XhComboboxClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxPositioner = defineComponent({\n  name: 'XhComboboxPositioner',\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 = useComboboxContext()\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.controlRef, 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 XhComboboxContent = defineComponent({\n  name: 'XhComboboxContent',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhComboboxGroup = defineComponent({\n  name: 'XhComboboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    const group = computed<ComboboxGroupProps>(() => ({ value: props.value }))\n    provideComboboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxGroupLabel = defineComponent({\n  name: 'XhComboboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { group } = useComboboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItem = defineComponent({\n  name: 'XhComboboxItem',\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 = useComboboxContext()\n    const item = computed<ComboboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideComboboxItem({ 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 XhComboboxItemText = defineComponent({\n  name: 'XhComboboxItemText',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhComboboxItemPrefix = defineComponent({\n  name: 'XhComboboxItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhComboboxItemSuffix = defineComponent({\n  name: 'XhComboboxItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhComboboxItemDescription = defineComponent({\n  name: 'XhComboboxItemDescription',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItemIndicator = defineComponent({\n  name: 'XhComboboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { item } = useComboboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxHiddenInput = defineComponent({\n  name: 'XhComboboxHiddenInput',\n  inheritAttrs: false,\n  setup(_, { attrs }) {\n    const ctx = useComboboxContext()\n    // 表单出口，不写这个部件即不参与表单提交\n    // 合并而不是展开：作者的 class 与部件的挂载类拼起来，不互相覆盖\n    return () => [\n      ...ctx.api.value.value.map(value => h('input', {\n        ...mergeProps(ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown>, attrs),\n        key: value,\n      })),\n      // 必填且没选值：补一份空值占位，原生 required 才拦得住空表单\n      ...(ctx.api.value.value.length === 0 && ctx.api.value.required\n        ? [h('input', { ...mergeProps(ctx.api.value.getHiddenInputProps() as Record<string, unknown>, attrs), key: 'required' })]\n        : []),\n    ]\n  },\n})\n\nexport const XhComboboxEmpty = defineComponent({\n  name: 'XhComboboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 放在 positioner 里作 content 的兄弟节点，不进 role=listbox\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxLoading = defineComponent({\n  name: 'XhComboboxLoading',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来；没写内容时显示 translations.loading\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.translations.loading)\n  },\n})\n\n/** 标准结构里各部件对应的组件；标签、标签文字、删除钮与 +N 委派给 tag，按「tag/部件名」找。 */\nconst COMBOBOX_PARTS = {\n  'label': XhComboboxLabel,\n  'control': XhComboboxControl,\n  'tag-list': XhComboboxTagList,\n  'tag/tag': XhComboboxTag,\n  'tag/tag-label': XhComboboxTagLabel,\n  'tag/item-delete-trigger': XhComboboxItemDeleteTrigger,\n  'tag/overflow-tag': XhComboboxOverflowTag,\n  'input': XhComboboxInput,\n  'clear-trigger': XhComboboxClearTrigger,\n  'trigger': XhComboboxTrigger,\n  'positioner': XhComboboxPositioner,\n  'content': XhComboboxContent,\n  'item': XhComboboxItem,\n  'item-prefix': XhComboboxItemPrefix,\n  'item-text': XhComboboxItemText,\n  'item-description': XhComboboxItemDescription,\n  'item-suffix': XhComboboxItemSuffix,\n  'item-indicator': XhComboboxItemIndicator,\n  'empty': XhComboboxEmpty,\n  'loading': XhComboboxLoading,\n  'hidden-input': XhComboboxHiddenInput,\n}\n\ninterface ComboboxStructureContent {\n  'label'?: () => VNode[]\n  'empty'?: () => VNode[]\n  'item'?: (node: ComboboxNodeMeta) => VNode[]\n  'item-prefix'?: (node: ComboboxNodeMeta) => VNode[]\n  'item-suffix'?: (node: ComboboxNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 comboboxStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题、空态、条目文字与行首行尾由对应插槽接管。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultStructure(\n  api: ComboboxApi,\n  props: { label?: string, empty?: string, clearable: boolean },\n  content: ComboboxStructureContent,\n): VNode[] {\n  const nodes = comboboxStructure(api, {\n    label: props.label,\n    empty: props.empty,\n    clearable: props.clearable,\n    slotted: name => content[name as keyof ComboboxStructureContent] != null,\n  })\n  return renderStructure(nodes, COMBOBOX_PARTS, (node) => {\n    const meta = node.data as ComboboxNodeMeta\n    switch (node.slot?.name) {\n      case 'label':\n        return content.label?.()\n      case 'empty':\n        return content.empty?.()\n      case 'item':\n        return content.item?.(meta) ?? meta.label\n      case 'item-prefix':\n        return content['item-prefix']?.(meta)\n      case 'item-suffix':\n        return content['item-suffix']?.(meta)\n      default:\n        return undefined\n    }\n  })\n}\n"],"mappings":";;;;;;;;;;;;;AAyCA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAC1B,YAAY,EAAE,MAAM,MAAkC;EACtD,aAAa,EAAE,MAAM,OAA0C;;EAE/D,OAAO,EAAE,MAAM,OAAO;;EAEtB,OAAO,EAAE,MAAM,OAAO;EACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EAC9D,cAAc,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EACrE,YAAY,EAAE,MAAM,OAAO;EAC3B,mBAAmB,EAAE,MAAM,OAAO;EAClC,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;;EAEb,MAAM,EAAE,MAAM,OAAO;EACrB,MAAM,EAAE,MAAM,OAAO;EACrB,UAAU;;EAEV,aAAa,EAAE,MAAM,OAAO;EAC5B,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;EACT,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa,EAAE,MAAM,OAAO;;EAE5B,WAAW;EACX,cAAc,EAAE,MAAM,OAAkD;EACxE,kBAAkB;EAClB,aAAa;EACb,eAAe,EAAE,MAAM,OAA0C;EACjE,WAAW,EAAE,MAAM,OAA8B;EACjD,QAAQ,EAAE,MAAM,OAAO;;EAEvB,KAAK,EAAE,MAAM,OAA8B;EAC3C,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;CACzC;CAEA,OAAO;EACL,eAAe;EACf,iBAAiB,aAAwD;EACzE,uBAAuB,aAA6D;EACpF,gBAAgB,aAAuD;EACvE,iBAAiB,WAA+D;EAChF,sBAAsB,gBAA8E;EACpG,gBAAgB,UAA4D;CAC9E;CACA,OAAO;CAWP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,eAA+C,YAAY;GAC/D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,oBAAyD,YAAY;GACzE,KAAK,sBAAsB,OAAO;GAClC,KAAK,qBAAqB,QAAQ,UAAU;EAC9C;EACA,MAAM,cAA6C,YAAY;GAC7D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,YAAY,aAAa,aAAa,YAAY,oBAAoB,KAAK,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,EAAE,CAAC,GAAoB;GAC7I,eAAe;GACf,oBAAoB;GACpB,cAAc;EAChB,CAAC;EACD,gBAAgB,GAAG;EAGnB,UAAU,IAAI,SAAS;EACvB,UAAU,IAAI,SAAS;EAEvB,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,MAAM,UACF,MAAM,QAAQ;GACZ,MAAM,IAAI,IAAI,MAAM;GACpB,OAAO,IAAI,IAAI,MAAM;GACrB,YAAY,IAAI,IAAI,MAAM;GAC1B,kBAAkB,IAAI,IAAI,MAAM;GAChC,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;GACpB,eAAe,IAAI,IAAI,MAAM;GAC7B,cAAc,IAAI,IAAI,MAAM;GAC5B,YAAY,IAAI,IAAI,MAAM;GAC1B,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,eAAe,IAAI,IAAI,MAAM;GAC7B,OAAO,IAAI,IAAI,MAAM;GACrB,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,IACD,uBAAuB,IAAI,IAAI,OAAO,OAAO;GAC3C,SAAS,MAAM;GACf,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,eAAe,MAAM;GACrB,eAAe,MAAM;EACvB,CAAC,CACP;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,IAAI,WAAW;EACf,kBAAkB;GAChB,IAAI,WAAW;EACjB,CAAC;EAED,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;;;;;;AAOD,SAAS,YAAY,SAAqE;CACxF,IAAI,OAAO,YAAY,UACrB,OAAO,CAAC,EAAE,oBAAoB,YAAY,OAAO,CAAC;CACpD,OAAO,gBAAgB,OAAO,IAAI,CAAC,EAAE,oBAAoB,YAAY,OAAO,CAAC,IAAI;AACnF;;AAGA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;;AAEL,OAAO;EAAE,MAAM;EAAQ,UAAU;CAAK,EACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAC/B,mBAAmB,EAAE,aAAa,MAAM,MAAM,CAAC;EAC/C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,YAAY,EAAE,OAAO,MAAM,MAAM,CAAC,GAA8B,YAAY,MAAM,UAAU,CAAC,CAAC;CACrI;AACF,CAAC;;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EACX,QACA,IAAI,IAAI,MAAM,oBAAoB,GAClC,YAAY,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YAAY,CAC7D;CACF;AACF,CAAC;;AAGD,MAAa,8BAA8B,gBAAgB;CACzD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,0BAA0B,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC,GAA8B,MAAM,UAAU,CAAC;CACxI;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;;;;;AAKL,IAAI;EAAE,MAAM;EAAuC,SAAS;CAAQ,EACtE;CACA,MAAM,OAAO;EAEX,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EACvC,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,MAAM,IAAI,WAAW,MAAM;GACxC,GAAG,YAAY;GACf,GAAG,IAAI,IAAI,MAAM,cAAc,EAAE,IAAI,MAAM,GAAG,CAAC;GAC/C,MAAM,OAAgB;IAAE,IAAI,SAAS,QAAQ;GAAsB;EACrE,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,OAAO;;AAEL,WAAW,EAAE,MAAM,OAA4B,EACjD;CAEA,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,mBAAmB;EAE/B,MAAM,OAAO,cAAc;GAAE,kBAAkB,IAAI,WAAW;GAAO,OAAO,EAAE,MAAM,KAAK;EAAE,CAAC;EAE5F,aAAa,EAAE,UAAU;GAAE,IAAI,MAAM,aAAa,IAAI,aAAa;GAAO,QAAQ,IAAI;GAAY,SAAS,IAAI,QAAQ;EAAM,SAAS,CACpI,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,CAAC,GAAI,MAAM,UAAU,KAAK,CAAC,GAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CACrD,CAAC;CACH;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO,EACL,OAAO;EAAE,MAAM;EAAQ,UAAU;CAAK,EACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,QAAQ,gBAAoC,EAAE,OAAO,MAAM,MAAM,EAAE;EACzE,yBAAyB,EAAE,MAAM,CAAC;EAClC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,MAAM,KAAK,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,UAAU,4BAA4B;EAC9C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,MAAM,KAAK,GAA8B,MAAM,UAAU,CAAC;CACpH;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,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,mBAAmB;EAC/B,MAAM,OAAO,gBAAmC;GAAE,OAAO,MAAM;GAAO,UAAU,MAAM;EAAS,EAAE;EACjG,oBAAoB,EAAE,KAAK,CAAC;EAE5B,UAAU,IAAI,SAAS;EACvB,YAAY,IAAI,SAAS;EAEzB,YAAY,MAAM,OAAO,IAAI,SAAS;EACtC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,mBAAmB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;;AAGD,MAAa,4BAA4B,gBAAgB;CACvD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,wBAAwB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACxH;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,sBAAsB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACtH;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,cAAc;CACd,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAG/B,aAAa,CACX,GAAG,IAAI,IAAI,MAAM,MAAM,KAAI,UAAS,EAAE,SAAS;GAC7C,GAAG,WAAW,IAAI,IAAI,MAAM,oBAAoB,EAAE,MAAM,CAAC,GAA8B,KAAK;GAC5F,KAAK;EACP,CAAC,CAAC,GAEF,GAAI,IAAI,IAAI,MAAM,MAAM,WAAW,KAAK,IAAI,IAAI,MAAM,WAClD,CAAC,EAAE,SAAS;GAAE,GAAG,WAAW,IAAI,IAAI,MAAM,oBAAoB,GAA8B,KAAK;GAAG,KAAK;EAAW,CAAC,CAAC,IACtH,CAAC,CACP;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,aAAa,OAAO;CAC3I;AACF,CAAC;;AAGD,MAAM,iBAAiB;CACrB,SAAS;CACT,WAAW;CACX,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,2BAA2B;CAC3B,oBAAoB;CACpB,SAAS;CACT,iBAAiB;CACjB,WAAW;CACX,cAAc;CACd,WAAW;CACX,QAAQ;CACR,eAAe;CACf,aAAa;CACb,oBAAoB;CACpB,eAAe;CACf,kBAAkB;CAClB,SAAS;CACT,WAAW;CACX,gBAAgB;AAClB;;;;;;AAeA,SAAS,uBACP,KACA,OACA,SACS;CAOT,OAAO,gBANO,kBAAkB,KAAK;EACnC,OAAO,MAAM;EACb,OAAO,MAAM;EACb,WAAW,MAAM;EACjB,UAAS,SAAQ,QAAQ,SAA2C;CACtE,CAC2B,GAAG,iBAAiB,SAAS;EACtD,MAAM,OAAO,KAAK;EAClB,QAAQ,KAAK,MAAM,MAAnB;GACE,KAAK,SACH,OAAO,QAAQ,QAAQ;GACzB,KAAK,SACH,OAAO,QAAQ,QAAQ;GACzB,KAAK,QACH,OAAO,QAAQ,OAAO,IAAI,KAAK,KAAK;GACtC,KAAK,eACH,OAAO,QAAQ,cAAc,GAAG,IAAI;GACtC,KAAK,eACH,OAAO,QAAQ,cAAc,GAAG,IAAI;GACtC,SACE;EACJ;CACF,CAAC;AACH"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-combobox.d.ts","names":[],"sources":["../../../src/components/combobox/use-combobox.ts"],"mappings":";;;;UAoBiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;;EAEhB,UAAU,IAAI;EACd,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET;;EAEA,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,oFACd"}
+{"version":3,"file":"use-combobox.d.ts","names":[],"sources":["../../../src/components/combobox/use-combobox.ts"],"mappings":";;;;UAoBiB;;;;;EAKf,YAAY;;EAEZ,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;;EAEhB,UAAU,IAAI;EACd,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET;;EAEA,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,oFACd"}

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-combobox.js","names":[],"sources":["../../../src/components/combobox/use-combobox.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 combobox 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ComboboxApi, ComboboxInputEl, ComboboxSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { comboboxMachine, connectCombobox } 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 ComboboxContext {\n  /** 状态机实例，供部件直接上报 DOM 侧事实。 */\n  service: Service<ComboboxSchema>\n  api: ComputedRef<ComboboxApi>\n  controlRef: Ref<HTMLElement | null>\n  /** 输入宿主，input 或 textarea；由 XhComboboxInput 的 as 决定渲染为哪个。 */\n  inputRef: Ref<ComboboxInputEl | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 上报候选集合可能已变化；同一拍内多次调用只上报一次。 */\n  syncItems: () => void\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCombobox(\n  props: ComboboxSchema['props'],\n  handlers: Pick<ComboboxSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onOpenChange'> = {},\n): ComboboxContext {\n  const xhConfig = useXhConfig()\n  const controlRef = ref<HTMLElement | null>(null)\n  const inputRef = ref<ComboboxInputEl | 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(comboboxMachine, () => ({ ...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: () => [controlRef.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('getAnchorEl', () => controlRef.value)\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(() => connectCombobox(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, controlRef, inputRef, positionerRef, contentRef, syncItems, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAqCA,SAAgB,YACd,OACA,WAAmG,CAAC,GACnF;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,WAAW,IAA4B,IAAI;CACjD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAGpF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,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,gBAAgB,SAAS,YAAY,CAAC;CAWjE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAU;EAAe;EAAY;EAAW,cAFvE,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAElB;CAAE;AAC3G"}
+{"version":3,"file":"use-combobox.js","names":[],"sources":["../../../src/components/combobox/use-combobox.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 combobox 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ComboboxApi, ComboboxInputEl, ComboboxSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { comboboxMachine, connectCombobox } 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 ComboboxContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhComboboxLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  /** 状态机实例，供部件直接上报 DOM 侧事实。 */\n  service: Service<ComboboxSchema>\n  api: ComputedRef<ComboboxApi>\n  controlRef: Ref<HTMLElement | null>\n  /** 输入宿主，input 或 textarea；由 XhComboboxInput 的 as 决定渲染为哪个。 */\n  inputRef: Ref<ComboboxInputEl | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 上报候选集合可能已变化；同一拍内多次调用只上报一次。 */\n  syncItems: () => void\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCombobox(\n  props: ComboboxSchema['props'],\n  handlers: Pick<ComboboxSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onOpenChange'> = {},\n): ComboboxContext {\n  const xhConfig = useXhConfig()\n  const controlRef = ref<HTMLElement | null>(null)\n  const inputRef = ref<ComboboxInputEl | 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(comboboxMachine, () => ({ ...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: () => [controlRef.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('getAnchorEl', () => controlRef.value)\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(() => connectCombobox(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { labelCount, visible, service, api, controlRef, inputRef, positionerRef, contentRef, syncItems, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA0CA,SAAgB,YACd,OACA,WAAmG,CAAC,GACnF;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,WAAW,IAA4B,IAAI;CACjD,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,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAGpH,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,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,gBAAgB,SAAS,YAAY,CAAC;CAWjE,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;EAAY;EAAU;EAAe;EAAY;EAAW,cAFnF,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEN;CAAE;AACvH"}

package/dist/components/command/command.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CommandApi, CommandGroup, CommandNode, CommandNodeMeta, CommandSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, OverlayBackdropVariant, Size } from "@xihan-ui/core";
-import { CommandApi, CommandGroup, CommandNode, CommandNodeMeta, CommandSchema } from "@xihan-ui/headless";
 //#region src/components/command/command.d.ts
 type CommandProps = CommandSchema['props'];
 /** 默认插槽的载荷：开合、检索串、结果与锚点，以及修改它们的命令。 */
@@ -80,7 +80,7 @@ declare const XhCommandRoot: import("vue").DefineComponent<import("vue").Extract
 }>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'open-change': (_details: PayloadOf<CommandProps, "onOpenChange">) => true;
   'input-value-change': (_details: PayloadOf<CommandProps, "onInputValueChange">) => true;
-  select: (_details: PayloadOf<CommandProps, "onSelect">) => true;
+  'item-select': (_details: PayloadOf<CommandProps, "onItemSelect">) => true;
   'update:open': (_open: PayloadOf<CommandProps, "onOpenChange">["open"]) => true;
   'update:inputValue': (_inputValue: PayloadOf<CommandProps, "onInputValueChange">["inputValue"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -153,23 +153,23 @@ declare const XhCommandRoot: import("vue").DefineComponent<import("vue").Extract
     type: PropType<CommandProps["translations"]>;
   };
 }>> & Readonly<{
-  onSelect?: ((_details: import("@xihan-ui/headless").CommandSelectDetails) => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").CommandOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onInput-value-change"?: ((_details: import("@xihan-ui/headless").CommandInputValueChangeDetails) => any) | undefined;
   "onUpdate:inputValue"?: ((_inputValue: string) => any) | undefined;
+  "onItem-select"?: ((_details: import("@xihan-ui/headless").CommandItemSelectDetails) => any) | undefined;
 }>, {
   filter: boolean;
   loop: boolean;
   open: boolean;
   defaultOpen: boolean;
   loading: boolean;
-  closeOnEscape: boolean;
-  closeOnInteractOutside: boolean;
-  restoreFocus: boolean;
   caseSensitive: boolean;
   closeOnSelect: boolean;
   modal: boolean;
+  closeOnEscape: boolean;
+  closeOnInteractOutside: boolean;
+  restoreFocus: boolean;
 }, SlotsType<{
   default?: (props: CommandRootSlotProps) => VNode[];
   /** 铺开时的触发按钮内容；未提供时不渲染触发器（面板改由快捷键或 v-model:open 唤起）。 */

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","names":[],"sources":["../../../src/components/command/command.ts"],"mappings":";;;;;KA4BK,eAAe;;KAGR,uBAAuB,KACjC;cAIW,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACH,uBAAA,UAAA,UAAU;EACtB,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;EACE,sBAAA,aAAA,UAAU;;;IA/BhB,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EAW7B,WAAC,OAAO,yBAAyB;;EAEjC,gBAAM;;EAET,QAAC,MAAM,oBAAoB;;EAEpB,iBAAC,MAAM,oBAAoB;;EAE3B,iBAAC,MAAM,oBAAoB;EACjC,cAAM;EACL,eAAM;kCAuDnB;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAsB3B;cAEW,gCAAgB,8BAAA;;;IAII,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MA+BxC,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BASzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BASxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAaxB;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;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"command.d.ts","names":[],"sources":["../../../src/components/command/command.ts"],"mappings":";;;;;KA6BK,eAAe;;KAGR,uBAAuB,KACjC;cAIW,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACH,uBAAA,UAAA,UAAU;EACjB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACE,sBAAA,aAAA,UAAU;;;IA/BhB,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EAW7B,WAAC,OAAO,yBAAyB;;EAEjC,gBAAM;;EAET,QAAC,MAAM,oBAAoB;;EAEpB,iBAAC,MAAM,oBAAoB;;EAE3B,iBAAC,MAAM,oBAAoB;EACjC,cAAM;EACL,eAAM;kCAsDnB;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAsB3B;cAEW,gCAAgB,8BAAA;;;IAII,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MA+BxC,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BASzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BASxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAaxB;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;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/command/command.js

@@ -1,3 +1,4 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
@@ -5,8 +6,8 @@ import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { provideCommand, provideCommandItem, provideCommandItemGroup, useCommandContext, useCommandItemContext, useCommandItemGroupContext } from "./context.js";
 import { useCommand } from "./use-command.js";
+import { commandStructure, resolveCommandGroups } from "@xihan-ui/headless";
 import { computed, defineComponent, h, mergeProps } from "vue";
-import { COMMAND_UNGROUPED, resolveCommandGroups } from "@xihan-ui/headless";
 //#region src/components/command/command.ts
 const XhCommandRoot = defineComponent({
 	name: "XhCommandRoot",
@@ -63,7 +64,7 @@ const XhCommandRoot = defineComponent({
 	emits: {
 		"open-change": (_details) => true,
 		"input-value-change": (_details) => true,
-		"select": (_details) => true,
+		"item-select": (_details) => true,
 		"update:open": (_open) => true,
 		"update:inputValue": (_inputValue) => true
 	},
@@ -77,11 +78,11 @@ const XhCommandRoot = defineComponent({
 			emit("input-value-change", details);
 			emit("update:inputValue", details.inputValue);
 		};
-		const notifySelect = (details) => emit("select", details);
+		const notifyItemSelect = (details) => emit("item-select", details);
 		const ctx = useCommand(withXhConfig("command", props), {
 			onOpenChange: notifyOpen,
 			onInputValueChange: notifyInputValue,
-			onSelect: notifySelect
+			onItemSelect: notifyItemSelect
 		});
 		provideCommand(ctx);
 		const fullTree = computed(() => resolveCommandGroups(props.collection ?? [], props.groups ?? [], "", {
@@ -101,7 +102,14 @@ const XhCommandRoot = defineComponent({
 				setInputValue: api.setInputValue,
 				select: api.select
 			});
-			return renderDefaultTree(fullTree.value, slots.trigger, slots.item, slots.empty?.() ?? (props.empty != null ? [props.empty] : null), slots.footer?.(), slots["item-prefix"], slots["item-suffix"]);
+			return renderDefaultStructure(fullTree.value, props.empty, {
+				"trigger": slots.trigger,
+				"empty": slots.empty,
+				"footer": slots.footer,
+				"item": slots.item,
+				"item-prefix": slots["item-prefix"],
+				"item-suffix": slots["item-suffix"]
+			});
 		};
 	}
 });
@@ -286,31 +294,52 @@ const XhCommandFooter = defineComponent({
 		return () => h("footer", ctx.api.value.getFooterProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const COMMAND_PARTS = {
+	"trigger": XhCommandTrigger,
+	"backdrop": /* @__PURE__ */ defineComponent({
+		name: "CommandStructureBackdrop",
+		setup() {
+			return () => null;
+		}
+	}),
+	"positioner": /* @__PURE__ */ defineComponent({
+		name: "CommandStructurePositioner",
+		setup(_, { slots }) {
+			return () => slots.default?.();
+		}
+	}),
+	"content": XhCommandContent,
+	"input": XhCommandInput,
+	"list": XhCommandList,
+	"group": XhCommandGroup,
+	"group-label": XhCommandGroupLabel,
+	"item": XhCommandItem,
+	"item-prefix": XhCommandItemPrefix,
+	"item-text": XhCommandItemText,
+	"item-description": XhCommandItemDescription,
+	"item-shortcut": XhCommandItemShortcut,
+	"item-suffix": XhCommandItemSuffix,
+	"empty": XhCommandEmpty,
+	"loading": XhCommandLoading,
+	"footer": XhCommandFooter
+};
 /**
-* 未写默认插槽时按清单铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 未写默认插槽时照 commandStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。
+* 铺的是整份清单分好的组，不是过滤后那几条：此刻该不该露面由 connect 打在条目上的 hidden 说了算。
+* 触发按钮、空态与页脚的内容归作者（同名插槽），空态没给插槽时取 empty 文字；条目文字、行首、行尾可由 item 系插槽逐槽接管。
 */
-function renderDefaultTree(tree, triggerSlot, itemSlot, empty, footer, prefixSlot, suffixSlot) {
-	const renderItem = (node) => h(XhCommandItem, {
-		key: node.value,
-		value: node.value
-	}, () => [
-		...prefixSlot ? [h(XhCommandItemPrefix, null, () => prefixSlot(node))] : [],
-		h(XhCommandItemText, null, () => itemSlot?.(node) ?? node.label),
-		...node.description != null ? [h(XhCommandItemDescription, null, () => node.description)] : [],
-		...node.shortcut != null ? [h(XhCommandItemShortcut, null, () => node.shortcut)] : [],
-		...suffixSlot ? [h(XhCommandItemSuffix, null, () => suffixSlot(node))] : []
-	]);
-	return [...triggerSlot ? [h(XhCommandTrigger, null, triggerSlot)] : [], h(XhCommandContent, null, () => [
-		h(XhCommandInput),
-		h(XhCommandList, null, () => tree.map((group) => group.value === COMMAND_UNGROUPED ? group.items.map(renderItem) : h(XhCommandGroup, {
-			key: group.value,
-			value: group.value
-		}, () => [h(XhCommandGroupLabel, null, () => group.label), ...group.items.map(renderItem)]))),
-		h(XhCommandEmpty, null, () => empty ?? []),
-		h(XhCommandLoading),
-		...footer ? [h(XhCommandFooter, null, () => footer)] : []
-	])];
+function renderDefaultStructure(tree, empty, content) {
+	return renderStructure(commandStructure(tree, {
+		...empty === void 0 ? {} : { empty },
+		slotted: (name) => content[name] != null
+	}), COMMAND_PARTS, (node) => {
+		const name = node.slot?.name;
+		if (name === "trigger" || name === "empty" || name === "footer") return content[name]?.();
+		if (name !== "item" && name !== "item-prefix" && name !== "item-suffix") return void 0;
+		const meta = node.data;
+		return meta ? content[name]?.(meta) : void 0;
+	});
 }
 //#endregion
 export { XhCommandContent, XhCommandEmpty, XhCommandFooter, XhCommandGroup, XhCommandGroupLabel, XhCommandInput, XhCommandItem, XhCommandItemDescription, XhCommandItemPrefix, XhCommandItemShortcut, XhCommandItemSuffix, XhCommandItemText, XhCommandList, XhCommandLoading, XhCommandRoot, XhCommandTrigger };