@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/pin-input/pin-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pin-input.d.ts","names":[],"sources":["../../../src/components/pin-input/pin-input.ts"],"mappings":";;;;;KAkBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAIC,MAAA;;;IACO,MAAA;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACR,mBAAA,UAAA,UAAU;EACd,iBAAA,QAAA,UAAU;;;IAxBX,MAAA;;;IACO,MAAA;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EASvC,WAAC,OAAO,0BAA0B;kCAuB9C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;IAIW,MAAA;;;;;;;IAAA,MAAA;;;MAMrC,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"pin-input.d.ts","names":[],"sources":["../../../src/components/pin-input/pin-input.ts"],"mappings":";;;;;KAoBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;;;;;;;;;IAQC,MAAA;;;IACO,MAAA;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACR,mBAAA,UAAA,UAAU;EACd,iBAAA,QAAA,UAAU;;;;;;;;;;;IAxBX,MAAA;;;IACO,MAAA;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EASvC,WAAC,OAAO,0BAA0B;;EAEpC,cAAM;kCAyBhB;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAY1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;IAIW,MAAA;;;;;;;IAAA,MAAA;;;MAMrC,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/pin-input/pin-input.js

@@ -1,13 +1,19 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { providePinInput, usePinInputContext } from "./context.js";
 import { usePinInput } from "./use-pin-input.js";
-import { defineComponent, h } from "vue";
+import { pinInputStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/pin-input/pin-input.ts
 const XhPinInputRoot = defineComponent({
 	name: "XhPinInputRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
 		value: { type: Array },
 		defaultValue: { type: Array },
 		length: { type: Number },
@@ -61,7 +67,7 @@ const XhPinInputRoot = defineComponent({
 		return () => h("div", fieldLabel.value({
 			...fieldWiring.value,
 			...ctx.api.value.getRootProps()
-		}), slots.default?.({
+		}), slots.default ? slots.default({
 			value: ctx.api.value.value,
 			valueAsString: ctx.api.value.valueAsString,
 			complete: ctx.api.value.complete,
@@ -69,13 +75,20 @@ const XhPinInputRoot = defineComponent({
 			focusedIndex: ctx.api.value.focusedIndex,
 			setValue: ctx.api.value.setValue,
 			clear: ctx.api.value.clear
-		}));
+		}) : renderDefaultStructure(ctx.api.value, {
+			label: props.label,
+			hiddenInput: props.name !== void 0
+		}, slots.label));
 	}
 });
 const XhPinInputLabel = defineComponent({
 	name: "XhPinInputLabel",
 	setup(_, { slots }) {
 		const ctx = usePinInputContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -113,6 +126,23 @@ const XhPinInputHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const PIN_INPUT_PARTS = {
+	"label": XhPinInputLabel,
+	"group": XhPinInputGroup,
+	"input": XhPinInputInput,
+	"hidden-input": XhPinInputHiddenInput
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 pinInputStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, options, labelSlot) {
+	return renderStructure(pinInputStructure(api, {
+		...options,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), PIN_INPUT_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhPinInputGroup, XhPinInputHiddenInput, XhPinInputInput, XhPinInputLabel, XhPinInputRoot, XhPinInputSeparator };
 

package/dist/components/pin-input/pin-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"pin-input.js","names":[],"sources":["../../../src/components/pin-input/pin-input.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 pin input 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { PinInputApi, PinInputSchema, PinInputTranslations, PinInputType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { providePinInput, usePinInputContext } from './context'\nimport { usePinInput } from './use-pin-input'\n\ntype PinInputProps = PinInputSchema['props']\n\n/** 默认插槽的载荷：逐格的值与拼接后的串、是否填满、格数与焦点所在格，以及修改值、清空的命令。 */\nexport type PinInputRootSlotProps = Pick<\n  PinInputApi,\n  'value' | 'valueAsString' | 'complete' | 'length' | 'focusedIndex' | 'setValue' | 'clear'\n>\n\nexport const XhPinInputRoot = defineComponent({\n  name: 'XhPinInputRoot',\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    length: { type: Number },\n    type: { type: String as PropType<PinInputType> },\n    pattern: { type: String },\n    mask: Boolean,\n    otp: Boolean,\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    blurOnComplete: Boolean,\n    name: { type: String },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<PinInputTranslations>> },\n  },\n  // value-change 携带 { value, valueAsString }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<PinInputProps, 'onValueChange'>) => true,\n    'value-complete': (_details: PayloadOf<PinInputProps, 'onValueComplete'>) => true,\n    'update:value': (_value: PayloadOf<PinInputProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PinInputRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: PinInputProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onValueComplete: PinInputProps['onValueComplete'] = details => emit('value-complete', details)\n    const ctx = usePinInput(withXhConfig('pin-input', useFormControlProps(props)) as PinInputProps, { onValueChange, onValueComplete })\n    providePinInput(ctx)\n    // 放进表单字段时，字段的标题与说明接到整组上：读屏进组时念组名与说明，每格的名字仍是「第几格」\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), slots.default?.({\n      value: ctx.api.value.value,\n      valueAsString: ctx.api.value.valueAsString,\n      complete: ctx.api.value.complete,\n      length: ctx.api.value.length,\n      focusedIndex: ctx.api.value.focusedIndex,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n    }))\n  },\n})\n\nexport const XhPinInputLabel = defineComponent({\n  name: 'XhPinInputLabel',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    // 必须是原生 label，getLabelProps 的 for 恒写向首格\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 分段：相邻的几格圈为一段（123-456 这种分段写法）。 */\nexport const XhPinInputGroup = defineComponent({\n  name: 'XhPinInputGroup',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 段与段之间的分隔；对读屏隐藏。 */\nexport const XhPinInputSeparator = defineComponent({\n  name: 'XhPinInputSeparator',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    return () => h('span', ctx.api.value.getSeparatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPinInputInput = defineComponent({\n  name: 'XhPinInputInput',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props) {\n    const ctx = usePinInputContext()\n    return () => h('input', ctx.api.value.getInputProps({ index: Math.trunc(Number(props.index)) }) as Record<string, unknown>)\n  },\n})\n\nexport const XhPinInputHiddenInput = defineComponent({\n  name: 'XhPinInputHiddenInput',\n  setup() {\n    const ctx = usePinInputContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"pin-input.js","names":[],"sources":["../../../src/components/pin-input/pin-input.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 pin input 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { PinInputApi, PinInputSchema, PinInputTranslations, PinInputType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { pinInputStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { providePinInput, usePinInputContext } from './context'\nimport { usePinInput } from './use-pin-input'\n\ntype PinInputProps = PinInputSchema['props']\n\n/** 默认插槽的载荷：逐格的值与拼接后的串、是否填满、格数与焦点所在格，以及修改值、清空的命令。 */\nexport type PinInputRootSlotProps = Pick<\n  PinInputApi,\n  'value' | 'valueAsString' | 'complete' | 'length' | 'focusedIndex' | 'setValue' | 'clear'\n>\n\nexport const XhPinInputRoot = defineComponent({\n  name: 'XhPinInputRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    length: { type: Number },\n    type: { type: String as PropType<PinInputType> },\n    pattern: { type: String },\n    mask: Boolean,\n    otp: Boolean,\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    blurOnComplete: Boolean,\n    name: { type: String },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<PinInputTranslations>> },\n  },\n  // value-change 携带 { value, valueAsString }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<PinInputProps, 'onValueChange'>) => true,\n    'value-complete': (_details: PayloadOf<PinInputProps, 'onValueComplete'>) => true,\n    'update:value': (_value: PayloadOf<PinInputProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PinInputRootSlotProps) => VNode[]\n    /** 不写默认插槽时标题的内容，代替 label 文字。 */\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: PinInputProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onValueComplete: PinInputProps['onValueComplete'] = details => emit('value-complete', details)\n    const ctx = usePinInput(withXhConfig('pin-input', useFormControlProps(props)) as PinInputProps, { onValueChange, onValueComplete })\n    providePinInput(ctx)\n    // 放进表单字段时，字段的标题与说明接到整组上：读屏进组时念组名与说明，每格的名字仍是「第几格」\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), slots.default\n      ? slots.default({\n          value: ctx.api.value.value,\n          valueAsString: ctx.api.value.valueAsString,\n          complete: ctx.api.value.complete,\n          length: ctx.api.value.length,\n          focusedIndex: ctx.api.value.focusedIndex,\n          setValue: ctx.api.value.setValue,\n          clear: ctx.api.value.clear,\n        })\n      : renderDefaultStructure(ctx.api.value, { label: props.label, hiddenInput: props.name !== undefined }, slots.label))\n  },\n})\n\nexport const XhPinInputLabel = defineComponent({\n  name: 'XhPinInputLabel',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 必须是原生 label，getLabelProps 的 for 恒写向首格\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 分段：相邻的几格圈为一段（123-456 这种分段写法）。 */\nexport const XhPinInputGroup = defineComponent({\n  name: 'XhPinInputGroup',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 段与段之间的分隔；对读屏隐藏。 */\nexport const XhPinInputSeparator = defineComponent({\n  name: 'XhPinInputSeparator',\n  setup(_, { slots }) {\n    const ctx = usePinInputContext()\n    return () => h('span', ctx.api.value.getSeparatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPinInputInput = defineComponent({\n  name: 'XhPinInputInput',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props) {\n    const ctx = usePinInputContext()\n    return () => h('input', ctx.api.value.getInputProps({ index: Math.trunc(Number(props.index)) }) as Record<string, unknown>)\n  },\n})\n\nexport const XhPinInputHiddenInput = defineComponent({\n  name: 'XhPinInputHiddenInput',\n  setup() {\n    const ctx = usePinInputContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst PIN_INPUT_PARTS = {\n  'label': XhPinInputLabel,\n  'group': XhPinInputGroup,\n  'input': XhPinInputInput,\n  'hidden-input': XhPinInputHiddenInput,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 pinInputStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: PinInputApi, options: { label?: string, hiddenInput: boolean }, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = pinInputStructure(api, { ...options, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, PIN_INPUT_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/pin-input/use-pin-input.d.ts

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { PinInputApi, PinInputSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/pin-input/use-pin-input.d.ts
 interface PinInputContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhPinInputLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<PinInputApi>;
 }
 declare function usePinInput(props: PinInputSchema['props'], handlers?: Pick<PinInputSchema['props'], 'onValueChange' | 'onValueComplete'>): PinInputContext;

package/dist/components/pin-input/use-pin-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-pin-input.d.ts","names":[],"sources":["../../../src/components/pin-input/use-pin-input.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;iBAGH,YACd,OAAO,yBACP,WAAU,KAAK,gEACd"}
+{"version":3,"file":"use-pin-input.d.ts","names":[],"sources":["../../../src/components/pin-input/use-pin-input.ts"],"mappings":";;;UAgBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,YACd,OAAO,yBACP,WAAU,KAAK,gEACd"}

package/dist/components/pin-input/use-pin-input.js

@@ -1,16 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectPinInput, pinInputMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/pin-input/use-pin-input.ts
 function usePinInput(props, handlers = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(pinInputMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
-	}), createScope(null, createVueIdGenerator()));
-	return { api: computed(() => connectPinInput(service, vueNormalize)) };
+	}), scope);
+	return {
+		labelCount,
+		api: computed(() => connectPinInput(service, vueNormalize))
+	};
 }
 //#endregion
 export { usePinInput };

package/dist/components/pin-input/use-pin-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-pin-input.js","names":[],"sources":["../../../src/components/pin-input/use-pin-input.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use pin input 相关实现。\n\nimport type { PinInputApi, PinInputSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectPinInput, pinInputMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PinInputContext {\n  api: ComputedRef<PinInputApi>\n}\n\nexport function usePinInput(\n  props: PinInputSchema['props'],\n  handlers: Pick<PinInputSchema['props'], 'onValueChange' | 'onValueComplete'> = {},\n): PinInputContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(pinInputMachine, () => ({ ...props, ...handlers }), scope)\n  const api = computed(() => connectPinInput(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAoBA,SAAgB,YACd,OACA,WAA+E,CAAC,GAC/D;CAIjB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAS,IAD7D,YAAY,MADZ,qBACsB,CAC+C,CAAC;CAEpF,OAAO,EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-pin-input.js","names":[],"sources":["../../../src/components/pin-input/use-pin-input.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use pin input 相关实现。\n\nimport type { PinInputApi, PinInputSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectPinInput, pinInputMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PinInputContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhPinInputLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<PinInputApi>\n}\n\nexport function usePinInput(\n  props: PinInputSchema['props'],\n  handlers: Pick<PinInputSchema['props'], 'onValueChange' | 'onValueComplete'> = {},\n): PinInputContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(pinInputMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n  const api = computed(() => connectPinInput(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,YACd,OACA,WAA+E,CAAC,GAC/D;CAGjB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAEpH,OAAO;EAAE;EAAY,KADT,eAAe,gBAAgB,SAAS,YAAY,CACzC;CAAE;AAC3B"}

package/dist/components/popconfirm/popconfirm.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmNotifiers, PopconfirmProps } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement, Size } from "@xihan-ui/core";
-import { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmNotifiers, PopconfirmProps } from "@xihan-ui/headless";
 //#region src/components/popconfirm/popconfirm.d.ts
 /** 默认插槽的载荷：开合、确认事务状态与三个动作。 */
 type PopconfirmRootSlotProps = Pick<PopconfirmApi, 'open' | 'pending' | 'actionError' | 'setOpen' | 'confirm' | 'cancel'>;
@@ -51,7 +51,7 @@ declare const XhPopconfirmRoot: import("vue").DefineComponent<import("vue").Extr
   'open-change': (_details: PayloadOf<PopconfirmProps, "onOpenChange">) => true;
   'update:open': (_open: PayloadOf<PopconfirmProps, "onOpenChange">["open"]) => true;
   'confirm-error': (_details: PopconfirmConfirmErrorDetails) => true;
-  cancel: () => true;
+  'cancel-press': () => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   open: {
     type: BooleanConstructor;
@@ -93,10 +93,10 @@ declare const XhPopconfirmRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<PopconfirmNotifiers["onConfirm"]>;
   };
 }>> & Readonly<{
-  onCancel?: (() => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").PopoverOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onConfirm-error"?: ((_details: PopconfirmConfirmErrorDetails) => any) | undefined;
+  "onCancel-press"?: (() => any) | undefined;
 }>, {
   disabled: boolean;
   open: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"popconfirm.d.ts","names":[],"sources":["../../../src/components/popconfirm/popconfirm.ts"],"mappings":";;;;;;KAoBY,0BAA0B,KACpC;cAIW,gCAAgB,8BAAA;;;;;;;IAKI,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;EAId,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACL,kBAAA,UAAA;;;;;;;;;IApBC,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;;;;;;;;;;EAU9B,WAAC,OAAO,4BAA4B;kCAuBhD;cAEW,mCAAmB,8BAAA;;;;;;;;;;qCAyB9B;cAEW,sCAAsB,8BAAA;;;IAIF,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAY9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"popconfirm.d.ts","names":[],"sources":["../../../src/components/popconfirm/popconfirm.ts"],"mappings":";;;;;;KAqBY,0BAA0B,KACpC;cAIW,gCAAgB,8BAAA;;;;;;;IAKI,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;EAId,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACL,kBAAA,UAAA;;;;;;;;;IApBC,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;;;;;;;;;;EAU9B,WAAC,OAAO,4BAA4B;kCAuBhD;cAEW,mCAAmB,8BAAA;;;;;;;;;;qCAyB9B;cAEW,sCAAsB,8BAAA;;;IAIF,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAY9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAQlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/popconfirm/popconfirm.js

@@ -1,3 +1,4 @@
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { XhPortal } from "../../runtime/portal.js";
@@ -43,7 +44,7 @@ const XhPopconfirmRoot = defineComponent({
 		"open-change": (_details) => true,
 		"update:open": (_open) => true,
 		"confirm-error": (_details) => true,
-		"cancel": () => true
+		"cancel-press": () => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -54,8 +55,8 @@ const XhPopconfirmRoot = defineComponent({
 			},
 			onConfirm: () => props.onConfirm?.(),
 			onConfirmError: (details) => emit("confirm-error", details),
-			onCancel: () => {
-				emit("cancel");
+			onCancelPress: () => {
+				emit("cancel-press");
 			}
 		});
 		providePopconfirm(ctx);
@@ -134,6 +135,7 @@ const XhPopconfirmTitle = defineComponent({
 	name: "XhPopconfirmTitle",
 	setup(_, { slots }) {
 		const ctx = usePopconfirmContext();
+		useTitleDescriptionPart(ctx.presence, "title");
 		return () => h("h2", ctx.api.value.getTitleProps(), slots.default?.());
 	}
 });
@@ -141,7 +143,11 @@ const XhPopconfirmDescription = defineComponent({
 	name: "XhPopconfirmDescription",
 	setup(_, { slots }) {
 		const ctx = usePopconfirmContext();
-		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.());
+		const el = useDescriptionPart(ctx.presence);
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: el
+		}, slots.default?.());
 	}
 });
 const XhPopconfirmConfirmTrigger = defineComponent({

package/dist/components/popconfirm/popconfirm.js.map

@@ -1 +1 @@
-{"version":3,"file":"popconfirm.js","names":[],"sources":["../../../src/components/popconfirm/popconfirm.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 popconfirm 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmNotifiers, PopconfirmOverlayProps, PopconfirmProps } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePopconfirm, usePopconfirmContext } from './context'\nimport { usePopconfirm } from './use-popconfirm'\n\n/** 默认插槽的载荷：开合、确认事务状态与三个动作。 */\nexport type PopconfirmRootSlotProps = Pick<\n  PopconfirmApi,\n  'open' | 'pending' | 'actionError' | 'setOpen' | 'confirm' | 'cancel'\n>\n\nexport const XhPopconfirmRoot = defineComponent({\n  name: 'XhPopconfirmRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    /** 不可打开：触发器转原生 disabled，展开途中转为禁用即收起。 */\n    disabled: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    /**\n     * 确认回调使用函数 prop 而非 emit：emit 无法获取监听函数的返回值，而异步门正需要它：\n     * 返回 thenable 即挂起（浮层等待兑现后再收起、确认按钮显示加载），拒绝则保持打开并触发 confirm-error。\n     * 模板中照常写 @confirm，Vue 会把它落到该 prop 上。\n     */\n    onConfirm: { type: Function as PropType<PopconfirmNotifiers['onConfirm']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔；cancel 不带载荷\n  emits: {\n    'open-change': (_details: PayloadOf<PopconfirmProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<PopconfirmProps, 'onOpenChange'>['open']) => true,\n    'confirm-error': (_details: PopconfirmConfirmErrorDetails) => true,\n    'cancel': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopconfirmRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopconfirmNotifiers = {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onConfirm: () => props.onConfirm?.(),\n      onConfirmError: details => emit('confirm-error', details),\n      onCancel: () => { emit('cancel') },\n    }\n    const ctx = usePopconfirm(props as PopconfirmOverlayProps, notify)\n    providePopconfirm(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      pending: ctx.api.value.pending,\n      actionError: ctx.api.value.actionError,\n      setOpen: ctx.api.value.setOpen,\n      confirm: ctx.api.value.confirm,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhPopconfirmTrigger = defineComponent({\n  name: 'XhPopconfirmTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = usePopconfirmContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'popconfirm')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhPopconfirmPositioner = defineComponent({\n  name: 'XhPopconfirmPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = usePopconfirmContext()\n    // 面板内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhPopconfirmContent = defineComponent({\n  name: 'XhPopconfirmContent',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\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 XhPopconfirmTitle = defineComponent({\n  name: 'XhPopconfirmTitle',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmDescription = defineComponent({\n  name: 'XhPopconfirmDescription',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmConfirmTrigger = defineComponent({\n  name: 'XhPopconfirmConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmCancelTrigger = defineComponent({\n  name: 'XhPopconfirmCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmArrow = defineComponent({\n  name: 'XhPopconfirmArrow',\n  setup() {\n    const ctx = usePopconfirmContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"popconfirm.js","names":[],"sources":["../../../src/components/popconfirm/popconfirm.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 popconfirm 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmNotifiers, PopconfirmOverlayProps, PopconfirmProps } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePopconfirm, usePopconfirmContext } from './context'\nimport { usePopconfirm } from './use-popconfirm'\n\n/** 默认插槽的载荷：开合、确认事务状态与三个动作。 */\nexport type PopconfirmRootSlotProps = Pick<\n  PopconfirmApi,\n  'open' | 'pending' | 'actionError' | 'setOpen' | 'confirm' | 'cancel'\n>\n\nexport const XhPopconfirmRoot = defineComponent({\n  name: 'XhPopconfirmRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    /** 不可打开：触发器转原生 disabled，展开途中转为禁用即收起。 */\n    disabled: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    /**\n     * 确认回调使用函数 prop 而非 emit：emit 无法获取监听函数的返回值，而异步门正需要它：\n     * 返回 thenable 即挂起（浮层等待兑现后再收起、确认按钮显示加载），拒绝则保持打开并触发 confirm-error。\n     * 模板中照常写 @confirm，Vue 会把它落到该 prop 上。\n     */\n    onConfirm: { type: Function as PropType<PopconfirmNotifiers['onConfirm']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔；cancel-press 不带载荷\n  emits: {\n    'open-change': (_details: PayloadOf<PopconfirmProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<PopconfirmProps, 'onOpenChange'>['open']) => true,\n    'confirm-error': (_details: PopconfirmConfirmErrorDetails) => true,\n    'cancel-press': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PopconfirmRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PopconfirmNotifiers = {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onConfirm: () => props.onConfirm?.(),\n      onConfirmError: details => emit('confirm-error', details),\n      onCancelPress: () => { emit('cancel-press') },\n    }\n    const ctx = usePopconfirm(props as PopconfirmOverlayProps, notify)\n    providePopconfirm(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      pending: ctx.api.value.pending,\n      actionError: ctx.api.value.actionError,\n      setOpen: ctx.api.value.setOpen,\n      confirm: ctx.api.value.confirm,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhPopconfirmTrigger = defineComponent({\n  name: 'XhPopconfirmTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = usePopconfirmContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'popconfirm')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhPopconfirmPositioner = defineComponent({\n  name: 'XhPopconfirmPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = usePopconfirmContext()\n    // 面板内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhPopconfirmContent = defineComponent({\n  name: 'XhPopconfirmContent',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\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 XhPopconfirmTitle = defineComponent({\n  name: 'XhPopconfirmTitle',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    useTitleDescriptionPart(ctx.presence, 'title')\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmDescription = defineComponent({\n  name: 'XhPopconfirmDescription',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    // 读不出一句话的说明不进描述链\n    const el = useDescriptionPart(ctx.presence)\n    return () => h('p', { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el }, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmConfirmTrigger = defineComponent({\n  name: 'XhPopconfirmConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmCancelTrigger = defineComponent({\n  name: 'XhPopconfirmCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = usePopconfirmContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPopconfirmArrow = defineComponent({\n  name: 'XhPopconfirmArrow',\n  setup() {\n    const ctx = usePopconfirmContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
+import { TitleDescriptionPresence } from "../../runtime/title-description.js";
+import { PopconfirmApi, PopconfirmNotifiers, PopconfirmOverlayProps, PopoverSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { PopconfirmApi, PopconfirmNotifiers, PopconfirmOverlayProps, PopoverSchema } from "@xihan-ui/headless";
 //#region src/components/popconfirm/use-popconfirm.d.ts
 interface PopconfirmContext {
   service: Service<PopoverSchema>;
@@ -12,6 +13,8 @@ interface PopconfirmContext {
   visible: Ref<boolean>;
   /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
   portalTarget: ComputedRef<string | Element>;
+  /** 标题与说明在不在场，由 XhPopconfirmTitle / XhPopconfirmDescription 登记；content 只引用在场的部件。 */
+  presence: TitleDescriptionPresence;
 }
 declare function usePopconfirm(props: PopconfirmOverlayProps, notify?: PopconfirmNotifiers): PopconfirmContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-popconfirm.d.ts","names":[],"sources":["../../../src/components/popconfirm/use-popconfirm.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,cACd,OAAO,wBACP,SAAS,sBACR"}
+{"version":3,"file":"use-popconfirm.d.ts","names":[],"sources":["../../../src/components/popconfirm/use-popconfirm.ts"],"mappings":";;;;;UAsBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;EAEnC,UAAU;;iBAGI,cACd,OAAO,wBACP,SAAS,sBACR"}

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

@@ -3,9 +3,10 @@ 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 { useTitleDescriptionPresence } from "../../runtime/title-description.js";
+import { connectPopconfirm, popoverMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectPopconfirm, popoverMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/popconfirm/use-popconfirm.ts
 function usePopconfirm(props, notify) {
@@ -17,6 +18,7 @@ function usePopconfirm(props, notify) {
 	const scope = createScope(null, idGen);
 	const pending = ref(false);
 	const actionError = ref(null);
+	const presence = useTitleDescriptionPresence();
 	const service = useMachine(popoverMachine, () => ({
 		open: props.open,
 		defaultOpen: props.defaultOpen,
@@ -27,6 +29,7 @@ function usePopconfirm(props, notify) {
 		closeOnEscape: pending.value ? false : props.closeOnEscape,
 		closeOnInteractOutside: pending.value ? false : props.closeOnInteractOutside,
 		size: props.size,
+		parts: presence.parts.value,
 		onOpenChange: notify?.onOpenChange
 	}), scope);
 	let config = null;
@@ -52,8 +55,8 @@ function usePopconfirm(props, notify) {
 	const intents = {
 		onConfirm: () => notify?.onConfirm?.(),
 		onConfirmError: (details) => notify?.onConfirmError?.(details),
-		onCancel: () => {
-			notify?.onCancel?.();
+		onCancelPress: () => {
+			notify?.onCancelPress?.();
 		},
 		get pending() {
 			return pending.value;
@@ -81,7 +84,8 @@ function usePopconfirm(props, notify) {
 		triggerRef,
 		positionerRef,
 		contentRef,
-		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body"),
+		presence
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-popconfirm.js","names":[],"sources":["../../../src/components/popconfirm/use-popconfirm.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use popconfirm 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmIntents, PopconfirmNotifiers, PopconfirmOverlayProps, PopoverSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectPopconfirm, popoverMachine } from '@xihan-ui/headless'\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 PopconfirmContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopconfirmApi>\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 usePopconfirm(\n  props: PopconfirmOverlayProps,\n  notify?: PopconfirmNotifiers,\n): PopconfirmContext {\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  // ref 同步写入：thenable 被识别的同一拍里，机器就要开始拒绝 Escape 与层外交互关闭。\n  const pending = ref(false)\n  const actionError = ref<PopconfirmConfirmErrorDetails | null>(null)\n\n  // 开合、定位、消解层与焦点域全交给 popover 机器；气泡确认只多出确认/取消两个意图，\n  // 它们不改开合以外的状态，走 connect 不进机器。\n  // modal 与 translations 不往下传：不陷焦点，按钮文案由作者写在节点里。\n  const service = useMachine(popoverMachine, (): PopoverSchema['props'] => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    placement: props.placement,\n    offset: props.offset,\n    dir: props.dir,\n    disabled: props.disabled,\n    closeOnEscape: pending.value ? false : props.closeOnEscape,\n    closeOnInteractOutside: pending.value ? false : props.closeOnInteractOutside,\n    size: props.size,\n    onOpenChange: notify?.onOpenChange,\n  }), 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: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  // 每次点击现读 notify，宿主换回调也立刻生效；onConfirm 的返回值原样透传，异步门靠它\n  const intents: PopconfirmIntents = {\n    onConfirm: () => notify?.onConfirm?.(),\n    onConfirmError: details => notify?.onConfirmError?.(details),\n    onCancel: () => { notify?.onCancel?.() },\n    get pending() {\n      return pending.value\n    },\n    onPendingChange: (next) => {\n      pending.value = next\n    },\n    get actionError() {\n      return actionError.value\n    },\n    onActionErrorChange: (next) => {\n      actionError.value = next\n    },\n  }\n\n  const api = computed(() => connectPopconfirm(service, intents, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAgCA,SAAgB,cACd,OACA,QACmB;CACnB,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;CAErC,MAAM,UAAU,IAAI,KAAK;CACzB,MAAM,cAAc,IAA0C,IAAI;CAKlE,MAAM,UAAU,WAAW,uBAA+C;EACxE,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,KAAK,MAAM;EACX,UAAU,MAAM;EAChB,eAAe,QAAQ,QAAQ,QAAQ,MAAM;EAC7C,wBAAwB,QAAQ,QAAQ,QAAQ,MAAM;EACtD,MAAM,MAAM;EACZ,cAAc,QAAQ;CACxB,IAAI,KAAK;CAGT,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAGA,MAAM,UAA6B;EACjC,iBAAiB,QAAQ,YAAY;EACrC,iBAAgB,YAAW,QAAQ,iBAAiB,OAAO;EAC3D,gBAAgB;GAAE,QAAQ,WAAW;EAAE;EACvC,IAAI,UAAU;GACZ,OAAO,QAAQ;EACjB;EACA,kBAAkB,SAAS;GACzB,QAAQ,QAAQ;EAClB;EACA,IAAI,cAAc;GAChB,OAAO,YAAY;EACrB;EACA,sBAAsB,SAAS;GAC7B,YAAY,QAAQ;EACtB;CACF;CAEA,MAAM,MAAM,eAAe,kBAAkB,SAAS,SAAS,YAAY,CAAC;CAW5E,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}
+{"version":3,"file":"use-popconfirm.js","names":[],"sources":["../../../src/components/popconfirm/use-popconfirm.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use popconfirm 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PopconfirmApi, PopconfirmConfirmErrorDetails, PopconfirmIntents, PopconfirmNotifiers, PopconfirmOverlayProps, PopoverSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport type { TitleDescriptionPresence } from '../../runtime/title-description'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectPopconfirm, popoverMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useTitleDescriptionPresence } from '../../runtime/title-description'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PopconfirmContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopconfirmApi>\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  /** 标题与说明在不在场，由 XhPopconfirmTitle / XhPopconfirmDescription 登记；content 只引用在场的部件。 */\n  presence: TitleDescriptionPresence\n}\n\nexport function usePopconfirm(\n  props: PopconfirmOverlayProps,\n  notify?: PopconfirmNotifiers,\n): PopconfirmContext {\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  // ref 同步写入：thenable 被识别的同一拍里，机器就要开始拒绝 Escape 与层外交互关闭。\n  const pending = ref(false)\n  const actionError = ref<PopconfirmConfirmErrorDetails | null>(null)\n\n  // 开合、定位、消解层与焦点域全交给 popover 机器；气泡确认只多出确认/取消两个意图，\n  // 它们不改开合以外的状态，走 connect 不进机器。\n  // modal 与 translations 不往下传：不陷焦点，按钮文案由作者写在节点里。\n  const presence = useTitleDescriptionPresence()\n  const service = useMachine(popoverMachine, (): PopoverSchema['props'] => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    placement: props.placement,\n    offset: props.offset,\n    dir: props.dir,\n    disabled: props.disabled,\n    closeOnEscape: pending.value ? false : props.closeOnEscape,\n    closeOnInteractOutside: pending.value ? false : props.closeOnInteractOutside,\n    size: props.size,\n    parts: presence.parts.value,\n    onOpenChange: notify?.onOpenChange,\n  }), 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: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  // 每次点击现读 notify，宿主换回调也立刻生效；onConfirm 的返回值原样透传，异步门靠它\n  const intents: PopconfirmIntents = {\n    onConfirm: () => notify?.onConfirm?.(),\n    onConfirmError: details => notify?.onConfirmError?.(details),\n    onCancelPress: () => { notify?.onCancelPress?.() },\n    get pending() {\n      return pending.value\n    },\n    onPendingChange: (next) => {\n      pending.value = next\n    },\n    get actionError() {\n      return actionError.value\n    },\n    onActionErrorChange: (next) => {\n      actionError.value = next\n    },\n  }\n\n  const api = computed(() => connectPopconfirm(service, intents, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget, presence }\n}\n"],"mappings":";;;;;;;;;;;AAoCA,SAAgB,cACd,OACA,QACmB;CACnB,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;CAErC,MAAM,UAAU,IAAI,KAAK;CACzB,MAAM,cAAc,IAA0C,IAAI;CAKlE,MAAM,WAAW,4BAA4B;CAC7C,MAAM,UAAU,WAAW,uBAA+C;EACxE,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,KAAK,MAAM;EACX,UAAU,MAAM;EAChB,eAAe,QAAQ,QAAQ,QAAQ,MAAM;EAC7C,wBAAwB,QAAQ,QAAQ,QAAQ,MAAM;EACtD,MAAM,MAAM;EACZ,OAAO,SAAS,MAAM;EACtB,cAAc,QAAQ;CACxB,IAAI,KAAK;CAGT,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAGA,MAAM,UAA6B;EACjC,iBAAiB,QAAQ,YAAY;EACrC,iBAAgB,YAAW,QAAQ,iBAAiB,OAAO;EAC3D,qBAAqB;GAAE,QAAQ,gBAAgB;EAAE;EACjD,IAAI,UAAU;GACZ,OAAO,QAAQ;EACjB;EACA,kBAAkB,SAAS;GACzB,QAAQ,QAAQ;EAClB;EACA,IAAI,cAAc;GAChB,OAAO,YAAY;EACrB;EACA,sBAAsB,SAAS;GAC7B,YAAY,QAAQ;EACtB;CACF;CAEA,MAAM,MAAM,eAAe,kBAAkB,SAAS,SAAS,YAAY,CAAC;CAW5E,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;EAAG;CAAS;AAChG"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { PopoverApi, PopoverSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement, Size } from "@xihan-ui/core";
-import { PopoverApi, PopoverSchema } from "@xihan-ui/headless";
 //#region src/components/popover/popover.d.ts
 type PopoverProps = PopoverSchema['props'];
 /** 默认插槽的载荷：浮层的展开态与开合命令。 */
@@ -12,6 +12,10 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
+  /** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger。 */
+  anchor: {
+    type: PropType<HTMLElement | null>;
+  };
   placement: {
     type: PropType<Placement>;
   };
@@ -56,6 +60,10 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
+  /** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger。 */
+  anchor: {
+    type: PropType<HTMLElement | null>;
+  };
   placement: {
     type: PropType<Placement>;
   };
@@ -96,9 +104,9 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
+  modal: boolean;
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
-  modal: boolean;
 }, SlotsType<{
   default?: (props: PopoverRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAfJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,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"}
+{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KAqBK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;;IAMI,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;IAhBP,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAQ/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,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { XhPortal } from "../../runtime/portal.js";
@@ -15,6 +16,8 @@ const XhPopoverRoot = defineComponent({
 			default: void 0
 		},
 		defaultOpen: Boolean,
+		/** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger。 */
+		anchor: { type: Object },
 		placement: { type: String },
 		offset: { type: Number },
 		/** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */
@@ -95,7 +98,7 @@ container: { type: Object } },
 		});
 		return () => h(XhPortal, {
 			to: props.container ?? ctx.portalTarget.value,
-			source: ctx.triggerRef,
+			source: ctx.portalSource.value,
 			present: ctx.visible.value
 		}, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
@@ -122,6 +125,7 @@ const XhPopoverTitle = defineComponent({
 	name: "XhPopoverTitle",
 	setup(_, { slots }) {
 		const ctx = usePopoverContext();
+		useTitleDescriptionPart(ctx.presence, "title");
 		return () => h("h2", ctx.api.value.getTitleProps(), slots.default?.());
 	}
 });
@@ -129,7 +133,11 @@ const XhPopoverDescription = defineComponent({
 	name: "XhPopoverDescription",
 	setup(_, { slots }) {
 		const ctx = usePopoverContext();
-		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.());
+		const el = useDescriptionPart(ctx.presence);
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: el
+		}, slots.default?.());
 	}
 });
 const XhPopoverCloseTrigger = defineComponent({

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

@@ -1 +1 @@
-{"version":3,"file":"popover.js","names":[],"sources":["../../../src/components/popover/popover.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 popover 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\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> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    modal: { type: Boolean, default: false },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    /** 浮层不可打开：触发器转原生 disabled。 */\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<PopoverProps['translations']> },\n    size: { type: String as PropType<Size> },\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  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = usePopoverContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'popover')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhPopoverPositioner = defineComponent({\n  name: 'XhPopoverPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = usePopoverContext()\n    // 面板内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const 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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"}
+{"version":3,"file":"popover.js","names":[],"sources":["../../../src/components/popover/popover.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 popover 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\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    /** 外部锚点：给了就锚在它上面、收起时焦点归还到它，不再取 trigger。 */\n    anchor: { type: Object as PropType<HTMLElement | null> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    modal: { type: Boolean, default: false },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: true },\n    /** 浮层不可打开：触发器转原生 disabled。 */\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<PopoverProps['translations']> },\n    size: { type: String as PropType<Size> },\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  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = usePopoverContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'popover')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhPopoverPositioner = defineComponent({\n  name: 'XhPopoverPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = usePopoverContext()\n    // 面板内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.portalSource.value, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const 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    useTitleDescriptionPart(ctx.presence, 'title')\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    // 读不出一句话的说明不进描述链\n    const el = useDescriptionPart(ctx.presence)\n    return () => h('p', { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el }, 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

@@ -1,6 +1,7 @@
+import { TitleDescriptionPresence } from "../../runtime/title-description.js";
+import { PopoverApi, PopoverSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { PopoverApi, PopoverSchema } from "@xihan-ui/headless";
 //#region src/components/popover/use-popover.d.ts
 interface PopoverContext {
   service: Service<PopoverSchema>;
@@ -12,6 +13,12 @@ interface PopoverContext {
   visible: Ref<boolean>;
   /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
   portalTarget: ComputedRef<string | Element>;
+  /**
+   * 落点的视觉环境从哪取：缺省取 trigger；写了 anchor（哪怕暂时是 null）时为空，由 Portal 在 positioner 原位放来源标记。
+   */
+  portalSource: ComputedRef<Ref<HTMLElement | null> | undefined>;
+  /** 标题与说明在不在场，由 XhPopoverTitle / XhPopoverDescription 登记；content 只引用在场的部件。 */
+  presence: TitleDescriptionPresence;
 }
 declare function usePopover(props: PopoverSchema['props'], onOpenChange?: PopoverSchema['props']['onOpenChange']): PopoverContext;
 //#endregion