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

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

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KASK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKN,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKN,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAS3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAS9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAS3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KAWK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKN,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKN,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAuB3B;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAgB9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/popover/popover.js

@@ -1,7 +1,9 @@
 import { withXhConfig } from "../../config/config.js";
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { providePopover, usePopoverContext } from "./context.js";
 import { usePopover } from "./use-popover.js";
-import { defineComponent, h } from "vue";
+import { Teleport, defineComponent, h, mergeProps } from "vue";
 //#region src/components/popover/popover.ts
 const XhPopoverRoot = defineComponent({
 	name: "XhPopoverRoot",
@@ -60,26 +62,39 @@ const XhPopoverRoot = defineComponent({
 });
 const XhPopoverTrigger = defineComponent({
 	name: "XhPopoverTrigger",
-	setup(_, { slots }) {
+	props: { 
+	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+asChild: Boolean },
+	setup(props, { slots }) {
 		const ctx = usePopoverContext();
-		return () => h("button", {
-			...ctx.api.value.getTriggerProps(),
-			ref: (el) => {
-				ctx.triggerRef.value = el;
+		return () => {
+			const attrs = {
+				...ctx.api.value.getTriggerProps(),
+				ref: (el) => {
+					ctx.triggerRef.value = el;
+				}
+			};
+			const children = slots.default?.();
+			if (props.asChild) {
+				const merged = mergeIntoChild(children, attrs, "popover");
+				if (merged) return merged;
 			}
-		}, slots.default?.());
+			return h("button", attrs, children);
+		};
 	}
 });
 const XhPopoverPositioner = defineComponent({
 	name: "XhPopoverPositioner",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = usePopoverContext();
-		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 XhPopoverContent = defineComponent({
@@ -88,6 +103,7 @@ const XhPopoverContent = defineComponent({
 		const ctx = usePopoverContext();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
+			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}

package/dist/components/popover/popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"popover.js","names":[],"sources":["../../../src/components/popover/popover.ts"],"sourcesContent":["import type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { Placement, Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { providePopover, usePopoverContext } from './context'\nimport { usePopover } from './use-popover'\n\ntype PopoverProps = PopoverSchema['props']\n\n/** 默认插槽的载荷：浮层的展开态与开合命令。 */\nexport type PopoverRootSlotProps = Pick<PopoverApi, 'open' | 'setOpen'>\n\nexport const XhPopoverRoot = defineComponent({\n  name: 'XhPopoverRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    modal: { type: Boolean, default: false },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    translations: { type: Object as PropType<PopoverProps['translations']>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<PopoverProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<PopoverProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopoverRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopoverProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = usePopover(withXhConfig('popover', props) as PopoverProps, notify)\n    providePopover(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhPopoverTrigger = defineComponent({\n  name: 'XhPopoverTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('button', {\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhPopoverPositioner = defineComponent({\n  name: 'XhPopoverPositioner',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\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 XhPopoverContent = defineComponent({\n  name: 'XhPopoverContent',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\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 XhPopoverTitle = defineComponent({\n  name: 'XhPopoverTitle',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverDescription = defineComponent({\n  name: 'XhPopoverDescription',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverCloseTrigger = defineComponent({\n  name: 'XhPopoverCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverArrow = defineComponent({\n  name: 'XhPopoverArrow',\n  setup() {\n    const ctx = usePopoverContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;AAcA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,WAAW;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;EACrE,QAAQ;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC3C,OAAO;GAAE,MAAM;GAAS,SAAS;EAAM;EACvC,eAAe;GAAE,MAAM;GAAS,SAAS;EAAK;EAC9C,wBAAwB;GAAE,MAAM;GAAS,SAAS;EAAK;EACvD,cAAc;GAAE,MAAM;GAAkD,SAAS,KAAA;EAAU;EAC3F,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;CAC7D;CAEA,OAAO;EACL,gBAAgB,aAAsD;EACtE,gBAAgB,UAA2D;CAC7E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAwC,YAAY;GACxD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,GAAmB,MAAM;EAC7E,eAAe,GAAG;EAClB,aAAa,MAAM,UAAU;GAAE,MAAM,IAAI,IAAI,MAAM;GAAM,SAAS,IAAI,IAAI,MAAM;EAAQ,CAAC;CAC3F;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,UAAU;GACvB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,mBAAmB;GACpC,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,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,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,CAA4B;CAChF;AACF,CAAC"}
+{"version":3,"file":"popover.js","names":[],"sources":["../../../src/components/popover/popover.ts"],"sourcesContent":["import type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { Placement, Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps, Teleport } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePopover, usePopoverContext } from './context'\nimport { usePopover } from './use-popover'\n\ntype PopoverProps = PopoverSchema['props']\n\n/** 默认插槽的载荷：浮层的展开态与开合命令。 */\nexport type PopoverRootSlotProps = Pick<PopoverApi, 'open' | 'setOpen'>\n\nexport const XhPopoverRoot = defineComponent({\n  name: 'XhPopoverRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    modal: { type: Boolean, default: false },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    translations: { type: Object as PropType<PopoverProps['translations']>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<PopoverProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<PopoverProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopoverRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopoverProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = usePopover(withXhConfig('popover', props) as PopoverProps, notify)\n    providePopover(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhPopoverTrigger = defineComponent({\n  name: 'XhPopoverTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = usePopoverContext()\n    return () => {\n      const attrs = {\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, attrs, 'popover')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\nexport const XhPopoverPositioner = defineComponent({\n  name: 'XhPopoverPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = usePopoverContext()\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 XhPopoverContent = defineComponent({\n  name: 'XhPopoverContent',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\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 XhPopoverTitle = defineComponent({\n  name: 'XhPopoverTitle',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverDescription = defineComponent({\n  name: 'XhPopoverDescription',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverCloseTrigger = defineComponent({\n  name: 'XhPopoverCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopoverContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopoverArrow = defineComponent({\n  name: 'XhPopoverArrow',\n  setup() {\n    const ctx = usePopoverContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -8,6 +8,10 @@ interface PopoverContext {
   triggerRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 declare function usePopover(props: PopoverSchema['props'], onOpenChange?: PopoverSchema['props']['onOpenChange']): PopoverContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-popover.d.ts","names":[],"sources":["../../../src/components/popover/use-popover.ts"],"mappings":";;;;UAYiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;iBAGF,WACd,OAAO,wBACP,eAAe,yCACd"}
+{"version":3,"file":"use-popover.d.ts","names":[],"sources":["../../../src/components/popover/use-popover.ts"],"mappings":";;;;UAciB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,WACd,OAAO,wBACP,eAAe,yCACd"}

package/dist/components/popover/use-popover.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, ref } from "vue";
@@ -7,6 +9,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/popover/use-popover.ts
 function usePopover(props, onOpenChange) {
+	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
@@ -16,15 +19,16 @@ function usePopover(props, onOpenChange) {
 		...props,
 		onOpenChange
 	}), 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: () => [triggerRef.value].filter(Boolean),
+			branches: () => [triggerRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => props.modal ?? false,
 			setModal: () => {},
 			surfaces: () => []
@@ -36,12 +40,19 @@ function usePopover(props, onOpenChange) {
 		service.refs.set("getFloatingEl", () => positionerRef.value);
 		service.refs.set("getContentEl", () => contentRef.value);
 	}
+	const api = computed(() => connectPopover(service, vueNormalize));
 	return {
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
 		service,
-		api: computed(() => connectPopover(service, vueNormalize)),
+		api,
 		triggerRef,
 		positionerRef,
-		contentRef
+		contentRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-popover.js","names":[],"sources":["../../../src/components/popover/use-popover.ts"],"sourcesContent":["import type { PopoverApi, PopoverSchema } 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 { connectPopover, popoverMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PopoverContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopoverApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n}\n\nexport function usePopover(\n  props: PopoverSchema['props'],\n  onOpenChange?: PopoverSchema['props']['onOpenChange'],\n): PopoverContext {\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(popoverMachine, () => ({ ...props, onOpenChange }), 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      // trigger 记为本层分支，点它算层内交互\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => props.modal ?? 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', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectPopover(service, vueNormalize))\n  return { service, api, triggerRef, positionerRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAoBA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,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,MAAM,SAAS;GAC9B,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;CACzD;CAGA,OAAO;EAAE;EAAS,KADN,eAAe,eAAe,SAAS,YAAY,CAC3C;EAAG;EAAY;EAAe;CAAW;AAC/D"}
+{"version":3,"file":"use-popover.js","names":[],"sources":["../../../src/components/popover/use-popover.ts"],"sourcesContent":["import type { PopoverApi, PopoverSchema } 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 { connectPopover, popoverMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PopoverContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopoverApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function usePopover(\n  props: PopoverSchema['props'],\n  onOpenChange?: PopoverSchema['props']['onOpenChange'],\n): PopoverContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(popoverMachine, () => ({ ...props, onOpenChange }), 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      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：面板之外还浮着自绘滚动条，按住它拖动不该把面板消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => props.modal ?? 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', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectPopover(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({ config, isOpen: () => api.value.open, contentRef })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,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,MAAM,SAAS;GAC9B,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;CACzD;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAMhE,OAAO;EAAE,SAJO,eAAe;GAAE;GAAQ,cAAc,IAAI,MAAM;GAAM;EAAW,CAInE;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}

package/dist/components/popselect/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/popselect/context.ts"],"sourcesContent":["import type { PopselectItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { PopselectContext } from './use-popselect'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface PopselectItemContext {\n  item: ComputedRef<PopselectItemProps>\n}\n\nconst KEY: InjectionKey<PopselectContext> = Symbol('xh-popselect')\nconst ITEM_KEY: InjectionKey<PopselectItemContext> = Symbol('xh-popselect-item')\n\nexport function providePopselect(ctx: PopselectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePopselectContext(): PopselectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Popselect 部件必须用在 XhPopselectRoot 内')\n  return ctx\n}\n\nexport function providePopselectItem(ctx: PopselectItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function usePopselectItemContext(): PopselectItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Popselect 条目子部件必须用在 XhPopselectItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAsC,OAAO,cAAc;AACjE,MAAM,WAA+C,OAAO,mBAAmB;AAE/E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/popselect/context.ts"],"sourcesContent":["import type { PopselectItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { PopselectContext } from './use-popselect'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface PopselectItemContext {\n  item: ComputedRef<PopselectItemProps>\n}\n\nconst KEY: InjectionKey<PopselectContext> = Symbol.for('xh-popselect')\nconst ITEM_KEY: InjectionKey<PopselectItemContext> = Symbol.for('xh-popselect-item')\n\nexport function providePopselect(ctx: PopselectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePopselectContext(): PopselectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Popselect 部件必须用在 XhPopselectRoot 内')\n  return ctx\n}\n\nexport function providePopselectItem(ctx: PopselectItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function usePopselectItemContext(): PopselectItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Popselect 条目子部件必须用在 XhPopselectItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAsC,OAAO,IAAI,cAAc;AACrE,MAAM,WAA+C,OAAO,IAAI,mBAAmB;AAEnF,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}

package/dist/components/popselect/popselect.d.ts

@@ -1,11 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PopselectNotifiers } from "./use-popselect.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { PopselectApi, PopselectNode } from "@xihan-ui/headless";
+import { PopselectApi, PopselectNode, PopselectTranslations } from "@xihan-ui/headless";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/popselect/popselect.d.ts
 /** 默认插槽的载荷：浮层开合、选中集合与条目数据，以及改动它们的方法。 */
-type PopselectRootSlotProps = Pick<PopselectApi, 'open' | 'value' | 'collection' | 'focusedValue' | 'isSelected' | 'setOpen' | 'setValue' | 'select'>;
+type PopselectRootSlotProps = Pick<PopselectApi, 'open' | 'value' | 'collection' | 'focusedValue' | 'canClear' | 'isSelected' | 'setOpen' | 'setValue' | 'select' | 'clear'>;
 declare const XhPopselectRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<PopselectNode[]>;
@@ -66,6 +66,10 @@ declare const XhPopselectRoot: import("vue").DefineComponent<import("vue").Extra
     type: PropType<Size>;
     default: undefined;
   };
+  translations: {
+    type: PropType<Partial<PopselectTranslations>>;
+    default: undefined;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -133,6 +137,10 @@ declare const XhPopselectRoot: import("vue").DefineComponent<import("vue").Extra
     type: PropType<Size>;
     default: undefined;
   };
+  translations: {
+    type: PropType<Partial<PopselectTranslations>>;
+    default: undefined;
+  };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").ListboxValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
@@ -147,9 +155,10 @@ declare const XhPopselectRoot: import("vue").DefineComponent<import("vue").Extra
   tone: Tone;
   size: Size;
   disabled: boolean;
+  offset: number;
+  translations: Partial<PopselectTranslations>;
   open: boolean;
   defaultOpen: boolean;
-  offset: number;
   variant: ControlVariant;
   loop: boolean;
   placement: Placement;
@@ -159,7 +168,23 @@ declare const XhPopselectRoot: import("vue").DefineComponent<import("vue").Extra
 }, SlotsType<{
   default?: (props: PopselectRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhPopselectTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 盒：触发器与清空按钮在里面并排，描边、底色与聚焦环都长在它上面。 */
+declare const XhPopselectControl: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhPopselectTrigger: 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<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 清空钮：盒里 trigger 的兄弟节点，有选中值才显出；没写内容时由皮肤画叉。 */
+declare const XhPopselectClearTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhPopselectPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -198,5 +223,5 @@ declare const XhPopselectItemIndicator: import("vue").DefineComponent<{}, () =>
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { PopselectRootSlotProps, XhPopselectContent, XhPopselectItem, XhPopselectItemIndicator, XhPopselectItemText, XhPopselectPositioner, XhPopselectRoot, XhPopselectTrigger };
+export { PopselectRootSlotProps, XhPopselectClearTrigger, XhPopselectContent, XhPopselectControl, XhPopselectItem, XhPopselectItemIndicator, XhPopselectItemText, XhPopselectPositioner, XhPopselectRoot, XhPopselectTrigger };
 //# sourceMappingURL=popselect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"popselect.d.ts","names":[],"sources":["../../../src/components/popselect/popselect.ts"],"mappings":";;;;;;;KAUY,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;IAIK,MAAA,SAAS;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;IAvBJ,MAAA,SAAS;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvB,WAAC,OAAO,2BAA2B;kCA0B/C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAS7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAShC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAS7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAoC1B;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"popselect.d.ts","names":[],"sources":["../../../src/components/popselect/popselect.ts"],"mappings":";;;;;;;KAYY,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;IAIK,MAAA,SAAS;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAItB,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;IAxBJ,MAAA,SAAS;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,2BAA2B;kCA4B/C;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;qCAuB7B;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAgBhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAY7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAoC1B;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/popselect/popselect.js

@@ -1,6 +1,8 @@
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { providePopselect, providePopselectItem, usePopselectContext, usePopselectItemContext } from "./context.js";
 import { usePopselect } from "./use-popselect.js";
-import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+import { Teleport, computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
 //#region src/components/popselect/popselect.ts
 const XhPopselectRoot = defineComponent({
 	name: "XhPopselectRoot",
@@ -63,6 +65,10 @@ const XhPopselectRoot = defineComponent({
 		size: {
 			type: String,
 			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
 		}
 	},
 	emits: {
@@ -89,35 +95,66 @@ const XhPopselectRoot = defineComponent({
 			value: ctx.api.value.value,
 			collection: ctx.api.value.collection,
 			focusedValue: ctx.api.value.focusedValue,
+			canClear: ctx.api.value.canClear,
 			isSelected: ctx.api.value.isSelected,
 			setOpen: ctx.api.value.setOpen,
 			setValue: ctx.api.value.setValue,
-			select: ctx.api.value.select
+			select: ctx.api.value.select,
+			clear: ctx.api.value.clear
 		}));
 	}
 });
+/** 盒：触发器与清空按钮在里面并排，描边、底色与聚焦环都长在它上面。 */
+const XhPopselectControl = defineComponent({
+	name: "XhPopselectControl",
+	setup(_, { slots }) {
+		const ctx = usePopselectContext();
+		return () => h("div", ctx.api.value.getControlProps(), slots.default?.());
+	}
+});
 const XhPopselectTrigger = defineComponent({
 	name: "XhPopselectTrigger",
-	setup(_, { slots }) {
+	props: { 
+	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+asChild: Boolean },
+	setup(props, { slots }) {
 		const ctx = usePopselectContext();
-		return () => h("button", {
-			...ctx.api.value.getTriggerProps(),
-			ref: (el) => {
-				ctx.triggerRef.value = el;
+		return () => {
+			const attrs = {
+				...ctx.api.value.getTriggerProps(),
+				ref: (el) => {
+					ctx.triggerRef.value = el;
+				}
+			};
+			const children = slots.default?.();
+			if (props.asChild) {
+				const merged = mergeIntoChild(children, attrs, "popselect");
+				if (merged) return merged;
 			}
-		}, slots.default?.());
+			return h("button", attrs, children);
+		};
+	}
+});
+/** 清空钮：盒里 trigger 的兄弟节点，有选中值才显出；没写内容时由皮肤画叉。 */
+const XhPopselectClearTrigger = defineComponent({
+	name: "XhPopselectClearTrigger",
+	setup(_, { slots }) {
+		const ctx = usePopselectContext();
+		return () => h("button", ctx.api.value.getClearTriggerProps(), slots.default?.());
 	}
 });
 const XhPopselectPositioner = defineComponent({
 	name: "XhPopselectPositioner",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = usePopselectContext();
-		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 XhPopselectContent = defineComponent({
@@ -126,6 +163,7 @@ const XhPopselectContent = defineComponent({
 		const ctx = usePopselectContext();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
+			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}
@@ -199,6 +237,6 @@ function renderItems(collection, itemSlot) {
 	}, () => [h(XhPopselectItemText, null, () => itemSlot?.(node) ?? node.label), h(XhPopselectItemIndicator)]));
 }
 //#endregion
-export { XhPopselectContent, XhPopselectItem, XhPopselectItemIndicator, XhPopselectItemText, XhPopselectPositioner, XhPopselectRoot, XhPopselectTrigger };
+export { XhPopselectClearTrigger, XhPopselectContent, XhPopselectControl, XhPopselectItem, XhPopselectItemIndicator, XhPopselectItemText, XhPopselectPositioner, XhPopselectRoot, XhPopselectTrigger };
 
 //# sourceMappingURL=popselect.js.map

package/dist/components/popselect/popselect.js.map

@@ -1 +1 @@
-{"version":3,"file":"popselect.js","names":[],"sources":["../../../src/components/popselect/popselect.ts"],"sourcesContent":["import type { PopselectApi, PopselectItemProps, PopselectNode, PopselectNodeMeta } from '@xihan-ui/headless'\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { PopselectNotifiers, PopselectRootProps } from './use-popselect'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { providePopselect, providePopselectItem, usePopselectContext, usePopselectItemContext } from './context'\nimport { usePopselect } from './use-popselect'\n\n/** 默认插槽的载荷：浮层开合、选中集合与条目数据，以及改动它们的方法。 */\nexport type PopselectRootSlotProps = Pick<\n  PopselectApi,\n  'open' | 'value' | 'collection' | 'focusedValue' | 'isSelected' | 'setOpen' | 'setValue' | 'select'\n>\n\nexport const XhPopselectRoot = defineComponent({\n  name: 'XhPopselectRoot',\n  // 有 connect 或机器兜底的 prop 一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<PopselectNode[]>, 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    multiple: Boolean,\n    disabled: Boolean,\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, 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:* 携带裸值；回传的选中值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<PopselectNotifiers, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<PopselectNotifiers, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<PopselectNotifiers, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<PopselectNotifiers, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopselectRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopselectNotifiers = {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n    }\n    const ctx = usePopselect(props as PopselectRootProps, notify)\n    providePopselect(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      value: ctx.api.value.value,\n      collection: ctx.api.value.collection,\n      focusedValue: ctx.api.value.focusedValue,\n      isSelected: ctx.api.value.isSelected,\n      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      select: ctx.api.value.select,\n    }))\n  },\n})\n\nexport const XhPopselectTrigger = defineComponent({\n  name: 'XhPopselectTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    return () => h('button', {\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhPopselectPositioner = defineComponent({\n  name: 'XhPopselectPositioner',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\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 XhPopselectContent = defineComponent({\n  name: 'XhPopselectContent',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\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?.() ?? renderItems(ctx.api.value.collection, slots.item))\n  },\n})\n\nexport const XhPopselectItem = defineComponent({\n  name: 'XhPopselectItem',\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 = usePopselectContext()\n    const item = computed<PopselectItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    providePopselectItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { listbox } = ctx\n      if (listbox.getStatus() !== 'Started')\n        return\n      if (itemEl.value && listbox.scope.getActiveElement() === itemEl.value)\n        listbox.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { listbox } = ctx\n      if (listbox.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && listbox.scope.getActiveElement() === itemEl.value)\n        listbox.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhPopselectItemText = defineComponent({\n  name: 'XhPopselectItemText',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    const { item } = usePopselectItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopselectItemIndicator = defineComponent({\n  name: 'XhPopselectItemIndicator',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    const { item } = usePopselectItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 浮层里没写默认插槽时按 collection 铺开的条目，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要在条目之外放别的节点就写默认插槽。\n */\nfunction renderItems(\n  collection: readonly PopselectNodeMeta[],\n  itemSlot?: (node: PopselectNodeMeta) => VNode[],\n): VNode[] {\n  return collection.map(node =>\n    h(XhPopselectItem, { key: node.value, value: node.value }, () => [\n      h(XhPopselectItemText, null, () => itemSlot?.(node) ?? node.label),\n      h(XhPopselectItemIndicator),\n    ]),\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"popselect.js","names":[],"sources":["../../../src/components/popselect/popselect.ts"],"sourcesContent":["import type { PopselectApi, PopselectItemProps, PopselectNode, PopselectNodeMeta, PopselectTranslations } from '@xihan-ui/headless'\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { PopselectNotifiers, PopselectRootProps } from './use-popselect'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, Teleport, watch } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePopselect, providePopselectItem, usePopselectContext, usePopselectItemContext } from './context'\nimport { usePopselect } from './use-popselect'\n\n/** 默认插槽的载荷：浮层开合、选中集合与条目数据，以及改动它们的方法。 */\nexport type PopselectRootSlotProps = Pick<\n  PopselectApi,\n  'open' | 'value' | 'collection' | 'focusedValue' | 'canClear' | 'isSelected' | 'setOpen' | 'setValue' | 'select' | 'clear'\n>\n\nexport const XhPopselectRoot = defineComponent({\n  name: 'XhPopselectRoot',\n  // 有 connect 或机器兜底的 prop 一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<PopselectNode[]>, 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    multiple: Boolean,\n    disabled: Boolean,\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, 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    translations: { type: Object as PropType<Partial<PopselectTranslations>>, default: undefined },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值；回传的选中值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<PopselectNotifiers, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<PopselectNotifiers, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<PopselectNotifiers, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<PopselectNotifiers, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopselectRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopselectNotifiers = {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n    }\n    const ctx = usePopselect(props as PopselectRootProps, notify)\n    providePopselect(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      value: ctx.api.value.value,\n      collection: ctx.api.value.collection,\n      focusedValue: ctx.api.value.focusedValue,\n      canClear: ctx.api.value.canClear,\n      isSelected: ctx.api.value.isSelected,\n      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      select: ctx.api.value.select,\n      clear: ctx.api.value.clear,\n    }))\n  },\n})\n\n/** 盒：触发器与清空按钮在里面并排，描边、底色与聚焦环都长在它上面。 */\nexport const XhPopselectControl = defineComponent({\n  name: 'XhPopselectControl',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopselectTrigger = defineComponent({\n  name: 'XhPopselectTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = usePopselectContext()\n    return () => {\n      const attrs = {\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, attrs, 'popselect')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\n/** 清空钮：盒里 trigger 的兄弟节点，有选中值才显出；没写内容时由皮肤画叉。 */\nexport const XhPopselectClearTrigger = defineComponent({\n  name: 'XhPopselectClearTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopselectPositioner = defineComponent({\n  name: 'XhPopselectPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = usePopselectContext()\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 XhPopselectContent = defineComponent({\n  name: 'XhPopselectContent',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\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?.() ?? renderItems(ctx.api.value.collection, slots.item))\n  },\n})\n\nexport const XhPopselectItem = defineComponent({\n  name: 'XhPopselectItem',\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 = usePopselectContext()\n    const item = computed<PopselectItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    providePopselectItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { listbox } = ctx\n      if (listbox.getStatus() !== 'Started')\n        return\n      if (itemEl.value && listbox.scope.getActiveElement() === itemEl.value)\n        listbox.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { listbox } = ctx\n      if (listbox.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && listbox.scope.getActiveElement() === itemEl.value)\n        listbox.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhPopselectItemText = defineComponent({\n  name: 'XhPopselectItemText',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    const { item } = usePopselectItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopselectItemIndicator = defineComponent({\n  name: 'XhPopselectItemIndicator',\n  setup(_, { slots }) {\n    const ctx = usePopselectContext()\n    const { item } = usePopselectItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 浮层里没写默认插槽时按 collection 铺开的条目，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要在条目之外放别的节点就写默认插槽。\n */\nfunction renderItems(\n  collection: readonly PopselectNodeMeta[],\n  itemSlot?: (node: PopselectNodeMeta) => VNode[],\n): VNode[] {\n  return collection.map(node =>\n    h(XhPopselectItem, { key: node.value, value: node.value }, () => [\n      h(XhPopselectItemText, null, () => itemSlot?.(node) ?? node.label),\n      h(XhPopselectItemIndicator),\n    ]),\n  )\n}\n"],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref } from "vue";
-import { ListboxSchema, PopoverSchema, PopselectApi, PopselectNode } from "@xihan-ui/headless";
+import { ListboxSchema, PopoverSchema, PopselectApi, PopselectNode, PopselectTranslations } from "@xihan-ui/headless";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
 import { Service } from "@xihan-ui/machine";
 //#region src/components/popselect/use-popselect.d.ts
@@ -22,6 +22,7 @@ interface PopselectRootProps {
   variant?: ControlVariant;
   tone?: Tone;
   size?: Size;
+  translations?: Partial<PopselectTranslations>;
 }
 interface PopselectContext {
   /** 浮层机器，供部件读开合状态。 */
@@ -32,6 +33,10 @@ interface PopselectContext {
   triggerRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 interface PopselectNotifiers {
   onValueChange?: ListboxSchema['props']['onValueChange'];

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

@@ -1 +1 @@
-{"version":3,"file":"use-popselect.d.ts","names":[],"sources":["../../../src/components/popselect/use-popselect.ts"],"mappings":";;;;;;UAkBiB;EACf,aAAa;EACb;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,YAAY;EACZ;EACA;EACA;EACA,UAAU;EACV,OAAO;EACP,OAAO;;UAGQ;;EAEf,SAAS,QAAQ;;EAEjB,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;UAGD;EACf,gBAAgB;EAChB,eAAe;;iBAGD,aAAa,OAAO,oBAAoB,SAAQ,qBAA0B"}
+{"version":3,"file":"use-popselect.d.ts","names":[],"sources":["../../../src/components/popselect/use-popselect.ts"],"mappings":";;;;;;UAqBiB;EACf,aAAa;EACb;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,YAAY;EACZ;EACA;EACA;EACA,UAAU;EACV,OAAO;EACP,OAAO;EACP,eAAe,QAAQ;;UAGR;;EAEf,SAAS,QAAQ;;EAEjB,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;UAGpB;EACf,gBAAgB;EAChB,eAAe;;iBAGD,aAAa,OAAO,oBAAoB,SAAQ,qBAA0B"}

package/dist/components/popselect/use-popselect.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, ref } from "vue";
@@ -7,6 +9,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/popselect/use-popselect.ts
 function usePopselect(props, notify = {}) {
+	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
@@ -33,15 +36,16 @@ function usePopselect(props, notify = {}) {
 		dir: props.dir,
 		onValueChange: notify.onValueChange
 	}), 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: () => [triggerRef.value].filter(Boolean),
+			branches: () => [triggerRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => false,
 			setModal: () => {},
 			surfaces: () => []
@@ -54,21 +58,29 @@ function usePopselect(props, notify = {}) {
 		popover.refs.set("getContentEl", () => contentRef.value);
 		popover.refs.set("getInitialFocusEl", () => popselectInitialFocus(listbox, contentRef.value));
 	}
+	const api = computed(() => connectPopselect({
+		popover,
+		listbox,
+		props: {
+			variant: props.variant,
+			tone: props.tone,
+			size: props.size,
+			translations: props.translations
+		}
+	}, vueNormalize));
 	return {
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
 		popover,
 		listbox,
-		api: computed(() => connectPopselect({
-			popover,
-			listbox,
-			props: {
-				variant: props.variant,
-				tone: props.tone,
-				size: props.size
-			}
-		}, vueNormalize)),
+		api,
 		triggerRef,
 		positionerRef,
-		contentRef
+		contentRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion