@xihan-ui/vue 1.0.0-alpha.2 → 1.0.0

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

@@ -59,6 +59,12 @@ declare const XhComboboxRoot: import("vue").DefineComponent<import("vue").Extrac
     type: StringConstructor;
     default: undefined;
   };
+  /** 自动铺开时是否渲染清空钮；手写部件模式不看它，写了节点即可清 */
+  clearable: BooleanConstructor;
+  translations: {
+    type: PropType<ComboboxProps["translations"]>;
+    default: undefined;
+  };
   allowCustomValue: BooleanConstructor;
   openOnClick: BooleanConstructor;
   inputBehavior: {
@@ -147,6 +153,12 @@ declare const XhComboboxRoot: import("vue").DefineComponent<import("vue").Extrac
     type: StringConstructor;
     default: undefined;
   };
+  /** 自动铺开时是否渲染清空钮；手写部件模式不看它，写了节点即可清 */
+  clearable: BooleanConstructor;
+  translations: {
+    type: PropType<ComboboxProps["translations"]>;
+    default: undefined;
+  };
   allowCustomValue: BooleanConstructor;
   openOnClick: BooleanConstructor;
   inputBehavior: {
@@ -191,9 +203,10 @@ declare const XhComboboxRoot: import("vue").DefineComponent<import("vue").Extrac
   tone: Tone;
   size: Size;
   disabled: boolean;
+  offset: number;
+  translations: Partial<import("@xihan-ui/headless").ComboboxTranslations> | undefined;
   open: boolean;
   defaultOpen: boolean;
-  offset: number;
   variant: ControlVariant;
   readOnly: boolean;
   loop: boolean;
@@ -201,6 +214,7 @@ declare const XhComboboxRoot: import("vue").DefineComponent<import("vue").Extrac
   placeholder: string;
   placement: Placement;
   inputValue: string;
+  clearable: boolean;
   allowCustomValue: boolean;
   openOnClick: boolean;
   defaultInputValue: string;

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

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","names":[],"sources":["../../../src/components/combobox/combobox.ts"],"mappings":";;;;;KAeK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;;;;;;;;;;;IAKJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeR,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;IAEX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACJ,uBAAA,UAAA,UAAU;EACjB,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACA,sBAAA,aAAA,UAAU;EACtB,gBAAA,OAAA,UAAU;;;IAnCJ,MAAA,SAAS;;;;;;;;;;;;;;IAKJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeR,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;IAEX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,WAAC,OAAO,0BAA0B;EACpC,cAAM;EACN,cAAM;EACP,QAAC,MAAM,qBAAqB;kCAoDrC;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAS5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;IAOF,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;qCASjC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAS5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;MAW9B,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBzB;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"combobox.d.ts","names":[],"sources":["../../../src/components/combobox/combobox.ts"],"mappings":";;;;;KAiBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;;;;;;;;;;;IAKJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeT,MAAA,SAAS;;;;;;IAGR,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;IAEX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACJ,uBAAA,UAAA,UAAU;EACjB,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACA,sBAAA,aAAA,UAAU;EACtB,gBAAA,OAAA,UAAU;;;IAtCJ,MAAA,SAAS;;;;;;;;;;;;;;IAKJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeT,MAAA,SAAS;;;;;;IAGR,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;IAEX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,WAAC,OAAO,0BAA0B;EACpC,cAAM;EACN,cAAM;EACP,QAAC,MAAM,qBAAqB;kCAqDrC;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAS5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;IAOF,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAcjC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAgB/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;MAW9B,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBzB;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/combobox/combobox.js

@@ -1,6 +1,8 @@
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideCombobox, provideComboboxItem, provideComboboxItemGroup, useComboboxContext, useComboboxItemContext, useComboboxItemGroupContext } from "./context.js";
 import { useCombobox } from "./use-combobox.js";
-import { computed, defineComponent, h, onMounted, onUnmounted, onUpdated, watch } from "vue";
+import { Teleport, computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from "vue";
 //#region src/components/combobox/combobox.ts
 const XhComboboxRoot = defineComponent({
 	name: "XhComboboxRoot",
@@ -57,6 +59,12 @@ const XhComboboxRoot = defineComponent({
 			type: String,
 			default: void 0
 		},
+		/** 自动铺开时是否渲染清空钮；手写部件模式不看它，写了节点即可清 */
+		clearable: Boolean,
+		translations: {
+			type: Object,
+			default: void 0
+		},
 		allowCustomValue: Boolean,
 		openOnClick: Boolean,
 		inputBehavior: {
@@ -125,7 +133,7 @@ const XhComboboxRoot = defineComponent({
 			setValue: ctx.api.value.setValue,
 			setInputValue: ctx.api.value.setInputValue,
 			clear: ctx.api.value.clear
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.empty?.() ?? (props.empty != null ? [props.empty] : null), slots.item) : []);
+		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.empty?.() ?? (props.empty != null ? [props.empty] : null), slots.item, props.clearable) : []);
 	}
 });
 const XhComboboxLabel = defineComponent({
@@ -159,13 +167,16 @@ as: {
 		default: "input"
 	} },
 	setup(props) {
+		const fieldWiring = useFieldStateWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useComboboxContext();
-		return () => h(props.as, {
+		return () => h(props.as, fieldLabel.value({
 			...ctx.api.value.getInputProps({ as: props.as }),
 			ref: (el) => {
 				ctx.inputRef.value = el;
-			}
-		});
+			},
+			...fieldWiring.value
+		}));
 	}
 });
 const XhComboboxTrigger = defineComponent({
@@ -184,14 +195,16 @@ const XhComboboxClearTrigger = defineComponent({
 });
 const XhComboboxPositioner = defineComponent({
 	name: "XhComboboxPositioner",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useComboboxContext();
-		return () => h("div", {
-			...ctx.api.value.getPositionerProps(),
+		const bars = useScrollbars({ scrollable: () => ctx.contentRef.value });
+		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
 			}
-		}, slots.default?.());
+		}, [...slots.default?.() ?? [], ...bars.render()])]);
 	}
 });
 const XhComboboxContent = defineComponent({
@@ -200,6 +213,7 @@ const XhComboboxContent = defineComponent({
 		const ctx = useComboboxContext();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
+			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}
@@ -287,13 +301,13 @@ const XhComboboxEmpty = defineComponent({
 * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
 * 过滤仍归调用方：collection 就是此刻该显示的那几条候选。
 */
-function renderDefaultTree(collection, label, empty, itemSlot) {
+function renderDefaultTree(collection, label, empty, itemSlot, clearable) {
 	return [
 		...label ? [h(XhComboboxLabel, null, () => label)] : [],
 		h(XhComboboxControl, null, () => [
 			h(XhComboboxInput),
-			h(XhComboboxTrigger),
-			h(XhComboboxClearTrigger)
+			...clearable ? [h(XhComboboxClearTrigger)] : [],
+			h(XhComboboxTrigger)
 		]),
 		h(XhComboboxPositioner, null, () => [h(XhComboboxContent, null, () => collection.map((node) => h(XhComboboxItem, {
 			key: node.value,

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

@@ -1 +1 @@
-{"version":3,"file":"combobox.js","names":[],"sources":["../../../src/components/combobox/combobox.ts"],"sourcesContent":["import type { ComboboxApi, ComboboxInputBehavior, ComboboxInputEl, ComboboxInputHost, ComboboxItemGroupProps, ComboboxItemProps, ComboboxNode, ComboboxNodeMeta, ComboboxSchema } from '@xihan-ui/headless'\nimport type { ControlVariant, Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onMounted, onUnmounted, onUpdated, watch } from 'vue'\nimport {\n  provideCombobox,\n  provideComboboxItem,\n  provideComboboxItemGroup,\n  useComboboxContext,\n  useComboboxItemContext,\n  useComboboxItemGroupContext,\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' | 'isSelected' | 'setOpen' | 'setValue' | 'setInputValue' | 'clear'\n>\n\nexport const XhComboboxRoot = defineComponent({\n  name: 'XhComboboxRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<ComboboxNode[]>, default: undefined },\n    /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */\n    label: { type: String, default: undefined },\n    /** 无匹配时的提示语。给了它就不必再写 empty 部件；要放别的内容改用 empty 插槽。 */\n    empty: { type: String, default: undefined },\n    value: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    defaultValue: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    inputValue: { type: String, default: undefined },\n    defaultInputValue: { type: String, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    /** 表单字段名；给了 hidden-input 才带 name 并参与提交 */\n    name: { type: String, default: undefined },\n    multiple: Boolean,\n    disabled: Boolean,\n    readOnly: Boolean,\n    invalid: Boolean,\n    loop: { type: Boolean, default: undefined },\n    placeholder: { type: String, default: undefined },\n    allowCustomValue: Boolean,\n    openOnClick: Boolean,\n    inputBehavior: { type: String as PropType<ComboboxInputBehavior>, default: undefined },\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    variant: { type: String as PropType<ControlVariant>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\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    item?: (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(props 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            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          })\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.empty?.() ?? (props.empty != null ? [props.empty] : null),\n              slots.item,\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 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    const ctx = useComboboxContext()\n    return () => h(props.as, {\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  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    return () => h('div', {\n      ...ctx.api.value.getPositionerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n    }, slots.default?.())\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      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhComboboxItemGroup = defineComponent({\n  name: 'XhComboboxItemGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    const group = computed<ComboboxItemGroupProps>(() => ({ value: props.value }))\n    provideComboboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getItemGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItemGroupLabel = defineComponent({\n  name: 'XhComboboxItemGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { group } = useComboboxItemGroupContext()\n    return () => h('span', ctx.api.value.getItemGroupLabelProps(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\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  setup() {\n    const ctx = useComboboxContext()\n    // 表单出口，不写这个部件即不参与表单提交\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\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\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是此刻该显示的那几条候选。\n */\nfunction renderDefaultTree(\n  collection: readonly ComboboxNodeMeta[],\n  label: (VNode | string)[] | null,\n  empty: (VNode | string)[] | null,\n  itemSlot?: (node: ComboboxNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhComboboxLabel, null, () => label)] : []),\n    h(XhComboboxControl, null, () => [\n      h(XhComboboxInput),\n      h(XhComboboxTrigger),\n      h(XhComboboxClearTrigger),\n    ]),\n    h(XhComboboxPositioner, null, () => [\n      h(XhComboboxContent, null, () => collection.map(node =>\n        h(XhComboboxItem, { key: node.value, value: node.value }, () => [\n          h(XhComboboxItemText, null, () => itemSlot?.(node) ?? node.label),\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":["import type { ComboboxApi, ComboboxInputBehavior, ComboboxInputEl, ComboboxInputHost, ComboboxItemGroupProps, ComboboxItemProps, ComboboxNode, ComboboxNodeMeta, ComboboxSchema } from '@xihan-ui/headless'\nimport type { ControlVariant, Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, Teleport, watch } from 'vue'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport {\n  provideCombobox,\n  provideComboboxItem,\n  provideComboboxItemGroup,\n  useComboboxContext,\n  useComboboxItemContext,\n  useComboboxItemGroupContext,\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' | 'isSelected' | 'setOpen' | 'setValue' | 'setInputValue' | 'clear'\n>\n\nexport const XhComboboxRoot = defineComponent({\n  name: 'XhComboboxRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<ComboboxNode[]>, default: undefined },\n    /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */\n    label: { type: String, default: undefined },\n    /** 无匹配时的提示语。给了它就不必再写 empty 部件；要放别的内容改用 empty 插槽。 */\n    empty: { type: String, default: undefined },\n    value: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    defaultValue: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    inputValue: { type: String, default: undefined },\n    defaultInputValue: { type: String, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    /** 表单字段名；给了 hidden-input 才带 name 并参与提交 */\n    name: { type: String, default: undefined },\n    multiple: Boolean,\n    disabled: Boolean,\n    readOnly: Boolean,\n    invalid: Boolean,\n    loop: { type: Boolean, default: undefined },\n    placeholder: { type: String, default: undefined },\n    /** 自动铺开时是否渲染清空钮；手写部件模式不看它，写了节点即可清 */\n    clearable: Boolean,\n    translations: { type: Object as PropType<ComboboxProps['translations']>, default: undefined },\n    allowCustomValue: Boolean,\n    openOnClick: Boolean,\n    inputBehavior: { type: String as PropType<ComboboxInputBehavior>, default: undefined },\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    variant: { type: String as PropType<ControlVariant>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\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    item?: (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(props 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            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          })\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\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            )\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 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      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.inputRef.value = el as ComboboxInputEl },\n      ...fieldWiring.value,\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  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useComboboxContext()\n    // 候选列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(Teleport, { to: ctx.portalTarget.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 XhComboboxItemGroup = defineComponent({\n  name: 'XhComboboxItemGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useComboboxContext()\n    const group = computed<ComboboxItemGroupProps>(() => ({ value: props.value }))\n    provideComboboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getItemGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhComboboxItemGroupLabel = defineComponent({\n  name: 'XhComboboxItemGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useComboboxContext()\n    const { group } = useComboboxItemGroupContext()\n    return () => h('span', ctx.api.value.getItemGroupLabelProps(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\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  setup() {\n    const ctx = useComboboxContext()\n    // 表单出口，不写这个部件即不参与表单提交\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\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\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是此刻该显示的那几条候选。\n */\nfunction renderDefaultTree(\n  collection: readonly ComboboxNodeMeta[],\n  label: (VNode | string)[] | null,\n  empty: (VNode | string)[] | null,\n  itemSlot: ((node: ComboboxNodeMeta) => VNode[]) | undefined,\n  clearable: boolean,\n): VNode[] {\n  return [\n    ...(label ? [h(XhComboboxLabel, null, () => label)] : []),\n    h(XhComboboxControl, null, () => [\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          h(XhComboboxItemText, null, () => itemSlot?.(node) ?? node.label),\n          h(XhComboboxItemIndicator),\n        ]),\n      )),\n      // 空态节点是 content 的兄弟，不进 role=listbox\n      h(XhComboboxEmpty, null, () => empty ?? []),\n    ]),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/combobox/context.js

@@ -1,8 +1,8 @@
 import { inject, provide } from "vue";
 //#region src/components/combobox/context.ts
-const KEY = Symbol("xh-combobox");
-const ITEM_KEY = Symbol("xh-combobox-item");
-const GROUP_KEY = Symbol("xh-combobox-item-group");
+const KEY = Symbol.for("xh-combobox");
+const ITEM_KEY = Symbol.for("xh-combobox-item");
+const GROUP_KEY = Symbol.for("xh-combobox-item-group");
 function provideCombobox(ctx) {
 	provide(KEY, ctx);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/combobox/context.ts"],"sourcesContent":["import type { ComboboxItemGroupProps, ComboboxItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ComboboxContext } from './use-combobox'\nimport { inject, provide } from 'vue'\n\n/** 候选自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface ComboboxItemContext {\n  item: ComputedRef<ComboboxItemProps>\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface ComboboxItemGroupContext {\n  group: ComputedRef<ComboboxItemGroupProps>\n}\n\nconst KEY: InjectionKey<ComboboxContext> = Symbol('xh-combobox')\nconst ITEM_KEY: InjectionKey<ComboboxItemContext> = Symbol('xh-combobox-item')\nconst GROUP_KEY: InjectionKey<ComboboxItemGroupContext> = Symbol('xh-combobox-item-group')\n\nexport function provideCombobox(ctx: ComboboxContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useComboboxContext(): ComboboxContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 部件必须用在 XhComboboxRoot 内')\n  return ctx\n}\n\nexport function provideComboboxItem(ctx: ComboboxItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useComboboxItemContext(): ComboboxItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 候选子部件必须用在 XhComboboxItem 内')\n  return ctx\n}\n\nexport function provideComboboxItemGroup(ctx: ComboboxItemGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useComboboxItemGroupContext(): ComboboxItemGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 分组标题必须用在 XhComboboxItemGroup 内')\n  return ctx\n}\n"],"mappings":";;AAeA,MAAM,MAAqC,OAAO,aAAa;AAC/D,MAAM,WAA8C,OAAO,kBAAkB;AAC7E,MAAM,YAAoD,OAAO,wBAAwB;AAEzF,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT;AAEA,SAAgB,yBAAyB,KAAqC;CAC5E,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,8BAAwD;CACtE,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/combobox/context.ts"],"sourcesContent":["import type { ComboboxItemGroupProps, ComboboxItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ComboboxContext } from './use-combobox'\nimport { inject, provide } from 'vue'\n\n/** 候选自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface ComboboxItemContext {\n  item: ComputedRef<ComboboxItemProps>\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface ComboboxItemGroupContext {\n  group: ComputedRef<ComboboxItemGroupProps>\n}\n\nconst KEY: InjectionKey<ComboboxContext> = Symbol.for('xh-combobox')\nconst ITEM_KEY: InjectionKey<ComboboxItemContext> = Symbol.for('xh-combobox-item')\nconst GROUP_KEY: InjectionKey<ComboboxItemGroupContext> = Symbol.for('xh-combobox-item-group')\n\nexport function provideCombobox(ctx: ComboboxContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useComboboxContext(): ComboboxContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 部件必须用在 XhComboboxRoot 内')\n  return ctx\n}\n\nexport function provideComboboxItem(ctx: ComboboxItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useComboboxItemContext(): ComboboxItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 候选子部件必须用在 XhComboboxItem 内')\n  return ctx\n}\n\nexport function provideComboboxItemGroup(ctx: ComboboxItemGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useComboboxItemGroupContext(): ComboboxItemGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Combobox 分组标题必须用在 XhComboboxItemGroup 内')\n  return ctx\n}\n"],"mappings":";;AAeA,MAAM,MAAqC,OAAO,IAAI,aAAa;AACnE,MAAM,WAA8C,OAAO,IAAI,kBAAkB;AACjF,MAAM,YAAoD,OAAO,IAAI,wBAAwB;AAE7F,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT;AAEA,SAAgB,yBAAyB,KAAqC;CAC5E,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,8BAAwD;CACtE,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}

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

@@ -11,8 +11,12 @@ interface ComboboxContext {
   inputRef: Ref<ComboboxInputEl | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
   /** 上报候选集合可能变了；同一拍里多次调用只上报一次。 */
   syncItems: () => void;
+  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 declare function useCombobox(props: ComboboxSchema['props'], handlers?: Pick<ComboboxSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onOpenChange'>): ComboboxContext;
 //#endregion

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":";;;;UAYiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;;EAEhB,UAAU,IAAI;EACd,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB;;iBAGc,YACd,OAAO,yBACP,WAAU,KAAK,oFACd"}
+{"version":3,"file":"use-combobox.d.ts","names":[],"sources":["../../../src/components/combobox/use-combobox.ts"],"mappings":";;;;UAciB;;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"}

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

@@ -1,4 +1,6 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 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 { computed, nextTick, ref } from "vue";
@@ -7,6 +9,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/combobox/use-combobox.ts
 function useCombobox(props, handlers = {}) {
+	const xhConfig = useXhConfig();
 	const controlRef = ref(null);
 	const inputRef = ref(null);
 	const positionerRef = ref(null);
@@ -17,15 +20,16 @@ function useCombobox(props, handlers = {}) {
 		...props,
 		...handlers
 	}), scope);
+	let config = null;
 	if (typeof document !== "undefined") {
-		const config = createRuntimeConfig({
+		config = createRuntimeConfig({
 			scope,
 			idGenerator: idGen
 		});
 		const registerLayer = () => config.layerRegistry.register({
 			kind: "popover",
 			node: () => contentRef.value,
-			branches: () => [controlRef.value].filter(Boolean),
+			branches: () => [controlRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => false,
 			setModal: () => {},
 			surfaces: () => []
@@ -47,14 +51,21 @@ function useCombobox(props, handlers = {}) {
 			if (service.getStatus() === "Started") service.send({ type: "ITEMS.SYNC" });
 		});
 	};
+	const api = computed(() => connectCombobox(service, vueNormalize));
 	return {
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
 		service,
-		api: computed(() => connectCombobox(service, vueNormalize)),
+		api,
 		controlRef,
 		inputRef,
 		positionerRef,
 		contentRef,
-		syncItems
+		syncItems,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

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":["import type { ComboboxApi, ComboboxInputEl, ComboboxSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { comboboxMachine, connectCombobox } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, nextTick, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\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  syncItems: () => void\n}\n\nexport function useCombobox(\n  props: ComboboxSchema['props'],\n  handlers: Pick<ComboboxSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onOpenChange'> = {},\n): ComboboxContext {\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  if (typeof document !== 'undefined') {\n    const config: RuntimeConfig = 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      branches: () => [controlRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\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  return { service, api, controlRef, inputRef, positionerRef, contentRef, syncItems }\n}\n"],"mappings":";;;;;;;;AAyBA,SAAgB,YACd,OACA,WAAmG,CAAC,GACnF;CACjB,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;CAEpF,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAC5F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,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;CAGA,OAAO;EAAE;EAAS,KADN,eAAe,gBAAgB,SAAS,YAAY,CAC5C;EAAG;EAAY;EAAU;EAAe;EAAY;CAAU;AACpF"}
+{"version":3,"file":"use-combobox.js","names":[],"sources":["../../../src/components/combobox/use-combobox.ts"],"sourcesContent":["import type { ComboboxApi, ComboboxInputEl, ComboboxSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { comboboxMachine, connectCombobox } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\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      setModal: () => {},\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({ config, isOpen: () => api.value.open, contentRef })\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":";;;;;;;;;;AA+BA,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;GACjB,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;CAMjE,OAAO;EAAE,SAJO,eAAe;GAAE;GAAQ,cAAc,IAAI,MAAM;GAAM;EAAW,CAInE;EAAG;EAAS;EAAK;EAAY;EAAU;EAAe;EAAY;EAAW,cAFvE,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAElB;CAAE;AAC3G"}

package/dist/components/composer/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/composer/context.ts
-const KEY = Symbol("xh-composer");
+const KEY = Symbol.for("xh-composer");
 function provideComposer(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/composer/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/composer/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { ComposerContext } from './use-composer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ComposerContext> = Symbol('xh-composer')\n\nexport function provideComposer(ctx: ComposerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useComposerContext(): ComposerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Composer 部件必须用在 XhComposerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAqC,OAAO,aAAa;AAE/D,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/composer/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { ComposerContext } from './use-composer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ComposerContext> = Symbol.for('xh-composer')\n\nexport function provideComposer(ctx: ComposerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useComposerContext(): ComposerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Composer 部件必须用在 XhComposerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAqC,OAAO,IAAI,aAAa;AAEnE,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT"}

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

@@ -115,10 +115,10 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   dir: Direction;
   tone: Tone;
   size: Size;
+  offset: number;
+  translations: Partial<import("@xihan-ui/headless").ContextMenuTranslations> | undefined;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").ContextMenuTranslations> | undefined;
-  offset: number;
   loop: boolean;
   placement: Placement;
   typeahead: boolean;
@@ -128,9 +128,17 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   trigger?: () => VNode[];
   item?: (node: ContextMenuNodeMeta) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhContextMenuTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhContextMenuTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhContextMenuPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -211,6 +219,21 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
     type: NumberConstructor;
     default: undefined;
   };
+  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  dir: {
+    type: PropType<Direction>;
+    default: undefined;
+  };
+  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  tone: {
+    type: PropType<Tone>;
+    default: undefined;
+  };
+  /** 尺寸；缺省继承父层，理由同 tone。 */
+  size: {
+    type: PropType<Size>;
+    default: undefined;
+  };
   hoverCloseDelay: {
     type: NumberConstructor;
     default: undefined;
@@ -247,11 +270,29 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
     type: NumberConstructor;
     default: undefined;
   };
+  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  dir: {
+    type: PropType<Direction>;
+    default: undefined;
+  };
+  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  tone: {
+    type: PropType<Tone>;
+    default: undefined;
+  };
+  /** 尺寸；缺省继承父层，理由同 tone。 */
+  size: {
+    type: PropType<Size>;
+    default: undefined;
+  };
   hoverCloseDelay: {
     type: NumberConstructor;
     default: undefined;
   };
 }>> & Readonly<{}>, {
+  dir: Direction;
+  tone: Tone;
+  size: Size;
   disabled: boolean;
   offset: number;
   loop: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/context-menu.ts"],"mappings":";;;;;KAsBK,mBAAmB;;KAGZ,2BAA2B,KAAK;;KAGhC,0BAA0B,KAAK;cAE9B,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAjBJ,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EASvB,WAAC,OAAO,6BAA6B;EACrC,gBAAM;EACT,QAAC,MAAM,wBAAwB;kCAgCxC;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BASlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAW7B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC5B;;;;;;cAOW,gCAAgB,8BAAA;;;;;;;;;;;IAMI,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,WAAC,OAAO,4BAA4B;kCAoBhD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAiBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAOrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/context-menu.ts"],"mappings":";;;;;KAyBK,mBAAmB;;KAGZ,2BAA2B,KAAK;;KAGhC,0BAA0B,KAAK;cAE9B,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAjBJ,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EASvB,WAAC,OAAO,6BAA6B;EACrC,gBAAM;EACT,QAAC,MAAM,wBAAwB;kCA4CxC;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAwB/B;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAgBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAW7B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC5B;;;;;;cAOW,gCAAgB,8BAAA;;;;;;;;;;;IAMI,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAVJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAIvB,WAAC,OAAO,4BAA4B;kCA6BhD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAiBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAOrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}