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

package/dist/components/tooltip/tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.js","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"sourcesContent":["import type { TooltipApi, TooltipSchema } from '@xihan-ui/headless'\nimport type { Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { provideTooltip, useTooltipContext } from './context'\nimport { useTooltip } from './use-tooltip'\n\ntype TooltipProps = TooltipSchema['props']\n\n/** 默认插槽的载荷：展开状态与开合方法。 */\nexport type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>\n\nexport const XhTooltipRoot = defineComponent({\n  name: 'XhTooltipRoot',\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    openDelay: { type: Number, default: undefined },\n    closeDelay: { type: Number, default: undefined },\n    disabled: Boolean,\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }；update:open 携带裸布尔，支持 v-model:open\n  emits: {\n    'open-change': (_details: PayloadOf<TooltipProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TooltipProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TooltipRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TooltipProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTooltip(props as TooltipProps, notify)\n    provideTooltip(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhTooltipTrigger = defineComponent({\n  name: 'XhTooltipTrigger',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\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 XhTooltipPositioner = defineComponent({\n  name: 'XhTooltipPositioner',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\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 XhTooltipContent = defineComponent({\n  name: 'XhTooltipContent',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTooltipArrow = defineComponent({\n  name: 'XhTooltipArrow',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;AAaA,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,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,YAAY;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC/C,UAAU;EACV,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,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,OAAuB,MAAM;EACpD,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,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}
+{"version":3,"file":"tooltip.js","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"sourcesContent":["import type { TooltipApi, TooltipSchema } from '@xihan-ui/headless'\nimport type { Placement, Size, Tone } 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 { mergeIntoChild } from '../../runtime/as-child'\nimport { provideTooltip, useTooltipContext } from './context'\nimport { useTooltip } from './use-tooltip'\n\ntype TooltipProps = TooltipSchema['props']\n\n/** 默认插槽的载荷：展开状态与开合方法。 */\nexport type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>\n\nexport const XhTooltipRoot = defineComponent({\n  name: 'XhTooltipRoot',\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    openDelay: { type: Number, default: undefined },\n    closeDelay: { type: Number, default: undefined },\n    disabled: Boolean,\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }；update:open 携带裸布尔，支持 v-model:open\n  emits: {\n    'open-change': (_details: PayloadOf<TooltipProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TooltipProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TooltipRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TooltipProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTooltip(props as TooltipProps, notify)\n    provideTooltip(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhTooltipTrigger = defineComponent({\n  name: 'XhTooltipTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useTooltipContext()\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, 'tooltip')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\nexport const XhTooltipPositioner = defineComponent({\n  name: 'XhTooltipPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTooltipContext()\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?.()),\n    ])\n  },\n})\n\nexport const XhTooltipContent = defineComponent({\n  name: 'XhTooltipContent',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤给 content 声明了 display 来盖掉 UA 的 [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 XhTooltipArrow = defineComponent({\n  name: 'XhTooltipArrow',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>, slots.default?.())\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,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,YAAY;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC/C,UAAU;EACV,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,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,OAAuB,MAAM;EACpD,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,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAC9B,aAAa;GACX,MAAM,QAAQ;IACZ,GAAG,IAAI,IAAI,MAAM,gBAAgB;IACjC,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE;GACA,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,OAAO,SAAS;IACxD,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,OAAO,QAAQ;EACpC;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,GAAG,CACvD,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC;CACH;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;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}

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

@@ -9,6 +9,12 @@ interface TooltipContext {
   triggerRef: Ref<HTMLElement | null>;
   /** 被定位的浮层。 */
   positionerRef: Ref<HTMLElement | null>;
+  /** 浮层本体，退场动画从它身上探测。 */
+  contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该可见：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 declare function useTooltip(props: TooltipSchema['props'], onOpenChange?: TooltipSchema['props']['onOpenChange']): TooltipContext;
 //#endregion

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

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

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

@@ -1,26 +1,57 @@
+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";
 import { connectTooltip, tooltipMachine } from "@xihan-ui/headless";
-import { createScope } from "@xihan-ui/kernel";
+import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/tooltip/use-tooltip.ts
 function useTooltip(props, onOpenChange) {
+	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
+	const contentRef = ref(null);
+	const idGen = createVueIdGenerator();
+	const scope = createScope(null, idGen);
 	const service = useMachine(tooltipMachine, () => ({
 		...props,
 		onOpenChange
-	}), createScope(null, createVueIdGenerator()));
-	if (typeof document !== "undefined") service.refs.set("position", createPositionEngine());
+	}), scope);
+	let config = null;
+	if (typeof document !== "undefined") {
+		config = createRuntimeConfig({
+			scope,
+			idGenerator: idGen
+		});
+		const registerLayer = () => config.layerRegistry.register({
+			kind: "inline",
+			node: () => contentRef.value,
+			branches: () => [triggerRef.value].filter(Boolean),
+			isModal: () => false,
+			setModal: () => {},
+			surfaces: () => []
+		});
+		service.refs.set("config", config);
+		service.refs.set("registerLayer", registerLayer);
+		service.refs.set("position", createPositionEngine());
+	}
 	service.refs.set("getAnchorEl", () => triggerRef.value);
 	service.refs.set("getFloatingEl", () => positionerRef.value);
+	const api = computed(() => connectTooltip(service, vueNormalize));
 	return {
 		service,
-		api: computed(() => connectTooltip(service, vueNormalize)),
+		api,
 		triggerRef,
-		positionerRef
+		positionerRef,
+		contentRef,
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-tooltip.js","names":[],"sources":["../../../src/components/tooltip/use-tooltip.ts"],"sourcesContent":["import type { TooltipApi, TooltipSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectTooltip, tooltipMachine } from '@xihan-ui/headless'\nimport { 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 TooltipContext {\n  service: Service<TooltipSchema>\n  api: ComputedRef<TooltipApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n}\n\nexport function useTooltip(\n  props: TooltipSchema['props'],\n  onOpenChange?: TooltipSchema['props']['onOpenChange'],\n): TooltipContext {\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // onOpenChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tooltipMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 定位引擎经 refs 注入，展开态由机器的 effect 驱动；无 DOM 环境（SSR）不建引擎\n  if (typeof document !== 'undefined')\n    service.refs.set('position', createPositionEngine())\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n\n  const api = computed(() => connectTooltip(service, vueNormalize))\n  return { service, api, triggerRef, positionerRef }\n}\n"],"mappings":";;;;;;;;AAoBA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAKlD,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,IAF7D,YAAY,MADZ,qBACsB,CAE+C,CAAC;CAGpF,IAAI,OAAO,aAAa,aACtB,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAG3D,OAAO;EAAE;EAAS,KADN,eAAe,eAAe,SAAS,YAAY,CAC3C;EAAG;EAAY;CAAc;AACnD"}
+{"version":3,"file":"use-tooltip.js","names":[],"sources":["../../../src/components/tooltip/use-tooltip.ts"],"sourcesContent":["import type { TooltipApi, TooltipSchema } 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 { connectTooltip, tooltipMachine } 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 TooltipContext {\n  service: Service<TooltipSchema>\n  api: ComputedRef<TooltipApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 浮层本体，退场动画从它身上探测。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该可见：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useTooltip(\n  props: TooltipSchema['props'],\n  onOpenChange?: TooltipSchema['props']['onOpenChange'],\n): TooltipContext {\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  // onOpenChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tooltipMachine, () => ({ ...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      // 提示只参与 Escape 仲裁与栈顶判定：节点就在文档流里，不陷焦点、不锁滚动、没有遮罩\n      kind: 'inline',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎经 refs 注入，展开态由机器的 effect 驱动\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n\n  const api = computed(() => connectTooltip(service, vueNormalize))\n\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, triggerRef, positionerRef, contentRef, visible, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA6BA,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;CAErC,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;GAE7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CACA,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAE3D,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAWhE,OAAO;EAAE;EAAS;EAAK;EAAY;EAAe;EAAY,SAR9C,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;EACF,CAIoE;EAAG,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}

package/dist/components/tour/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tour/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { TourContext } from './use-tour'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<TourContext> = Symbol('xh-tour')\n\nexport function provideTour(ctx: TourContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTourContext(): TourContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Tour 部件必须用在 XhTourRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAiC,OAAO,SAAS;AAEvD,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tour/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { TourContext } from './use-tour'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<TourContext> = Symbol.for('xh-tour')\n\nexport function provideTour(ctx: TourContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTourContext(): TourContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Tour 部件必须用在 XhTourRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}

package/dist/components/tour/tour.d.ts

@@ -129,16 +129,16 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   "onUpdate:step"?: ((_step: number) => any) | undefined;
   onSkip?: ((_details: import("@xihan-ui/headless").TourSkipDetails) => any) | undefined;
 }>, {
+  offset: number;
+  translations: Partial<import("@xihan-ui/headless").TourTranslations> | undefined;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").TourTranslations> | undefined;
-  offset: number;
+  steps: TourStep[];
   placement: Placement;
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
   step: number;
   defaultStep: number;
-  steps: TourStep[];
   showBackdrop: boolean;
   spotlightPadding: number;
   autoScroll: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"tour.d.ts","names":[],"sources":["../../../src/components/tour/tour.ts"],"mappings":";;;;;KASK,YAAY;;KAGL,oBAAoB,KAC9B;cAgBW,0BAAU,8BAAA;;IAIK,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAON,MAAA,SAAS;;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACV,WAAA,UAAA,UAAU;EACd,OAAA,UAAA,UAAU;;;IArBL,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAON,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,WAAC,OAAO,sBAAsB;kCAiC1C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BASzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAS3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BASxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAUtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAU7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tour.d.ts","names":[],"sources":["../../../src/components/tour/tour.ts"],"mappings":";;;;;KASK,YAAY;;KAGL,oBAAoB,KAC9B;cAgBW,0BAAU,8BAAA;;IAIK,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAON,MAAA,SAAS;;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACV,WAAA,UAAA,UAAU;EACd,OAAA,UAAA,UAAU;;;IArBL,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAON,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,WAAC,OAAO,sBAAsB;kCAiC1C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAgBzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAe1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAYxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAUtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAU7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/tour/tour.js

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideTour, useTourContext } from "./context.js";
 import { useTour } from "./use-tour.js";
-import { defineComponent, h } from "vue";
+import { Teleport, defineComponent, h, mergeProps } from "vue";
 //#region src/components/tour/tour.ts
 const XhTourRoot = defineComponent({
 	name: "XhTourRoot",
@@ -101,33 +101,41 @@ const XhTourRoot = defineComponent({
 });
 const XhTourBackdrop = defineComponent({
 	name: "XhTourBackdrop",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useTourContext();
-		return () => h("div", {
-			...ctx.api.value.getBackdropProps(),
+		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+			...mergeProps(ctx.api.value.getBackdropProps(), attrs),
+			hidden: !ctx.visible.value || !ctx.showBackdrop() || void 0,
 			ref: (el) => {
 				ctx.backdropRef.value = el;
 			}
-		}, slots.default?.());
+		}, slots.default?.())]);
 	}
 });
 const XhTourSpotlight = defineComponent({
 	name: "XhTourSpotlight",
-	setup() {
+	inheritAttrs: false,
+	setup(_, { attrs }) {
 		const ctx = useTourContext();
-		return () => h("div", ctx.api.value.getSpotlightProps());
+		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+			...mergeProps(ctx.api.value.getSpotlightProps(), attrs),
+			hidden: !ctx.visible.value || !ctx.api.value.anchored || void 0
+		})]);
 	}
 });
 const XhTourPositioner = defineComponent({
 	name: "XhTourPositioner",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useTourContext();
-		return () => h("div", {
-			...ctx.api.value.getPositionerProps(),
+		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
+			hidden: !ctx.visible.value || void 0,
 			ref: (el) => {
 				ctx.positionerRef.value = el;
 			}
-		}, slots.default?.());
+		}, slots.default?.())]);
 	}
 });
 const XhTourContent = defineComponent({
@@ -136,6 +144,7 @@ const XhTourContent = defineComponent({
 		const ctx = useTourContext();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
+			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}

package/dist/components/tour/tour.js.map

@@ -1 +1 @@
-{"version":3,"file":"tour.js","names":[],"sources":["../../../src/components/tour/tour.ts"],"sourcesContent":["import type { TourApi, TourSchema, TourStep } from '@xihan-ui/headless'\nimport type { Placement } 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 { provideTour, useTourContext } from './context'\nimport { useTour } from './use-tour'\n\ntype TourProps = TourSchema['props']\n\n/** 默认插槽的载荷：引导的开合与步序状态，以及开关、走步、放弃与校准位置的动作。 */\nexport type TourRootSlotProps = Pick<\n  TourApi,\n  | 'open'\n  | 'step'\n  | 'count'\n  | 'currentStep'\n  | 'firstStep'\n  | 'lastStep'\n  | 'progressText'\n  | 'setOpen'\n  | 'setStep'\n  | 'goToNextStep'\n  | 'goToPrevStep'\n  | 'skip'\n  | 'remeasure'\n>\n\nexport const XhTourRoot = defineComponent({\n  name: 'XhTourRoot',\n  // 全部 default: undefined —— 缺省值的唯一事实源在 machine 与 connect\n  props: {\n    steps: { type: Array as PropType<TourStep[]>, default: undefined },\n    step: { type: Number, default: undefined },\n    defaultStep: { type: Number, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: { type: Boolean, default: undefined },\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    showBackdrop: { type: Boolean, default: undefined },\n    spotlightPadding: { type: Number, default: undefined },\n    autoScroll: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TourProps['translations']>, default: undefined },\n  },\n  // open-change / step-change 携带对象；update:* 携带裸值，支持 v-model:open 与 v-model:step\n  emits: {\n    'open-change': (_details: PayloadOf<TourProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TourProps, 'onOpenChange'>['open']) => true,\n    'step-change': (_details: PayloadOf<TourProps, 'onStepChange'>) => true,\n    'update:step': (_step: PayloadOf<TourProps, 'onStepChange'>['step']) => true,\n    'complete': (_details: PayloadOf<TourProps, 'onComplete'>) => true,\n    'skip': (_details: PayloadOf<TourProps, 'onSkip'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TourRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useTour(withXhConfig('tour', props) as TourProps, {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onStepChange: (details) => {\n        emit('step-change', details)\n        emit('update:step', details.step)\n      },\n      onComplete: details => emit('complete', details),\n      onSkip: details => emit('skip', details),\n    })\n    provideTour(ctx)\n    // 经插槽暴露状态与走步、放弃等命令，供浮层外的按钮使用\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      step: ctx.api.value.step,\n      count: ctx.api.value.count,\n      currentStep: ctx.api.value.currentStep,\n      firstStep: ctx.api.value.firstStep,\n      lastStep: ctx.api.value.lastStep,\n      progressText: ctx.api.value.progressText,\n      setOpen: ctx.api.value.setOpen,\n      setStep: ctx.api.value.setStep,\n      goToNextStep: ctx.api.value.goToNextStep,\n      goToPrevStep: ctx.api.value.goToPrevStep,\n      skip: ctx.api.value.skip,\n      remeasure: ctx.api.value.remeasure,\n    }))\n  },\n})\n\nexport const XhTourBackdrop = defineComponent({\n  name: 'XhTourBackdrop',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('div', {\n      ...ctx.api.value.getBackdropProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhTourSpotlight = defineComponent({\n  name: 'XhTourSpotlight',\n  setup() {\n    const ctx = useTourContext()\n    return () => h('div', ctx.api.value.getSpotlightProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhTourPositioner = defineComponent({\n  name: 'XhTourPositioner',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\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 XhTourContent = defineComponent({\n  name: 'XhTourContent',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\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\n// 标题与描述的文字取自步骤声明，有插槽则用插槽\nexport const XhTourTitle = defineComponent({\n  name: 'XhTourTitle',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'h2',\n      ctx.api.value.getTitleProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.currentStep?.title,\n    )\n  },\n})\n\nexport const XhTourDescription = defineComponent({\n  name: 'XhTourDescription',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'p',\n      ctx.api.value.getDescriptionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.currentStep?.description,\n    )\n  },\n})\n\nexport const XhTourProgressText = defineComponent({\n  name: 'XhTourProgressText',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'span',\n      ctx.api.value.getProgressTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.progressText,\n    )\n  },\n})\n\nexport const XhTourPrevTrigger = defineComponent({\n  name: 'XhTourPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourNextTrigger = defineComponent({\n  name: 'XhTourNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourSkipTrigger = defineComponent({\n  name: 'XhTourSkipTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getSkipTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourCloseTrigger = defineComponent({\n  name: 'XhTourCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourArrow = defineComponent({\n  name: 'XhTourArrow',\n  setup() {\n    const ctx = useTourContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"tour.js","names":[],"sources":["../../../src/components/tour/tour.ts"],"sourcesContent":["import type { TourApi, TourSchema, TourStep } from '@xihan-ui/headless'\nimport type { Placement } 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 { provideTour, useTourContext } from './context'\nimport { useTour } from './use-tour'\n\ntype TourProps = TourSchema['props']\n\n/** 默认插槽的载荷：引导的开合与步序状态，以及开关、走步、放弃与校准位置的动作。 */\nexport type TourRootSlotProps = Pick<\n  TourApi,\n  | 'open'\n  | 'step'\n  | 'count'\n  | 'currentStep'\n  | 'firstStep'\n  | 'lastStep'\n  | 'progressText'\n  | 'setOpen'\n  | 'setStep'\n  | 'goToNextStep'\n  | 'goToPrevStep'\n  | 'skip'\n  | 'remeasure'\n>\n\nexport const XhTourRoot = defineComponent({\n  name: 'XhTourRoot',\n  // 全部 default: undefined —— 缺省值的唯一事实源在 machine 与 connect\n  props: {\n    steps: { type: Array as PropType<TourStep[]>, default: undefined },\n    step: { type: Number, default: undefined },\n    defaultStep: { type: Number, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: { type: Boolean, default: undefined },\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    showBackdrop: { type: Boolean, default: undefined },\n    spotlightPadding: { type: Number, default: undefined },\n    autoScroll: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TourProps['translations']>, default: undefined },\n  },\n  // open-change / step-change 携带对象；update:* 携带裸值，支持 v-model:open 与 v-model:step\n  emits: {\n    'open-change': (_details: PayloadOf<TourProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TourProps, 'onOpenChange'>['open']) => true,\n    'step-change': (_details: PayloadOf<TourProps, 'onStepChange'>) => true,\n    'update:step': (_step: PayloadOf<TourProps, 'onStepChange'>['step']) => true,\n    'complete': (_details: PayloadOf<TourProps, 'onComplete'>) => true,\n    'skip': (_details: PayloadOf<TourProps, 'onSkip'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TourRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useTour(withXhConfig('tour', props) as TourProps, {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onStepChange: (details) => {\n        emit('step-change', details)\n        emit('update:step', details.step)\n      },\n      onComplete: details => emit('complete', details),\n      onSkip: details => emit('skip', details),\n    })\n    provideTour(ctx)\n    // 经插槽暴露状态与走步、放弃等命令，供浮层外的按钮使用\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      step: ctx.api.value.step,\n      count: ctx.api.value.count,\n      currentStep: ctx.api.value.currentStep,\n      firstStep: ctx.api.value.firstStep,\n      lastStep: ctx.api.value.lastStep,\n      progressText: ctx.api.value.progressText,\n      setOpen: ctx.api.value.setOpen,\n      setStep: ctx.api.value.setStep,\n      goToNextStep: ctx.api.value.goToNextStep,\n      goToPrevStep: ctx.api.value.goToPrevStep,\n      skip: ctx.api.value.skip,\n      remeasure: ctx.api.value.remeasure,\n    }))\n  },\n})\n\nexport const XhTourBackdrop = defineComponent({\n  name: 'XhTourBackdrop',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到遮罩上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTourContext()\n    // 与浮层同去一个落点：遮罩留在原地就会被面板甩下，两层不再叠在一起\n    return () => h(Teleport, { to: ctx.portalTarget.value }, [\n      h('div', {\n        ...mergeProps(ctx.api.value.getBackdropProps() as Record<string, unknown>, attrs),\n        // 收起跟着退场闸门走：遮罩的淡出与气泡的退场并行播\n        hidden: (!ctx.visible.value || !ctx.showBackdrop()) || undefined,\n        ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n      }, slots.default?.()),\n    ])\n  },\n})\n\nexport const XhTourSpotlight = defineComponent({\n  name: 'XhTourSpotlight',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到高亮框上\n  inheritAttrs: false,\n  setup(_, { attrs }) {\n    const ctx = useTourContext()\n    // 高亮框与遮罩是同一层暗幕的两半，必须一起搬\n    return () => h(Teleport, { to: ctx.portalTarget.value }, [\n      h('div', {\n        ...mergeProps(ctx.api.value.getSpotlightProps() as Record<string, unknown>, attrs),\n        // 收起跟着退场闸门走：高亮框的退场与气泡并行播；居中步照常不画\n        hidden: (!ctx.visible.value || !ctx.api.value.anchored) || undefined,\n      }),\n    ])\n  },\n})\n\nexport const XhTourPositioner = defineComponent({\n  name: 'XhTourPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTourContext()\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        // 定位层收起跟着退场闸门走：它先 display:none 的话，里面气泡的退场一帧都播不出来\n        hidden: !ctx.visible.value || undefined,\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, slots.default?.()),\n    ])\n  },\n})\n\nexport const XhTourContent = defineComponent({\n  name: 'XhTourContent',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\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\n// 标题与描述的文字取自步骤声明，有插槽则用插槽\nexport const XhTourTitle = defineComponent({\n  name: 'XhTourTitle',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'h2',\n      ctx.api.value.getTitleProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.currentStep?.title,\n    )\n  },\n})\n\nexport const XhTourDescription = defineComponent({\n  name: 'XhTourDescription',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'p',\n      ctx.api.value.getDescriptionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.currentStep?.description,\n    )\n  },\n})\n\nexport const XhTourProgressText = defineComponent({\n  name: 'XhTourProgressText',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h(\n      'span',\n      ctx.api.value.getProgressTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.progressText,\n    )\n  },\n})\n\nexport const XhTourPrevTrigger = defineComponent({\n  name: 'XhTourPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourNextTrigger = defineComponent({\n  name: 'XhTourNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourSkipTrigger = defineComponent({\n  name: 'XhTourSkipTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getSkipTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourCloseTrigger = defineComponent({\n  name: 'XhTourCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTourArrow = defineComponent({\n  name: 'XhTourArrow',\n  setup() {\n    const ctx = useTourContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -8,6 +8,12 @@ interface TourContext {
   backdropRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该可见：收起那一帧押后到退场动画播完；遮罩、高亮框与定位层跟它一起收。 */
+  visible: Ref<boolean>;
+  /** 作者是否要画遮罩。 */
+  showBackdrop: () => boolean;
+  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 declare function useTour(props: TourSchema['props'], notify?: Pick<TourSchema['props'], 'onOpenChange' | 'onStepChange' | 'onComplete' | 'onSkip'>): TourContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-tour.d.ts","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"mappings":";;;;UAYiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,aAAa,IAAI;EACjB,eAAe,IAAI;EACnB,YAAY,IAAI;;iBAGF,QACd,OAAO,qBACP,SAAQ,KAAK,kFACZ"}
+{"version":3,"file":"use-tour.d.ts","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"mappings":";;;;UAciB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,aAAa,IAAI;EACjB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET;;EAEA,cAAc,qBAAqB;;iBAGrB,QACd,OAAO,qBACP,SAAQ,KAAK,kFACZ"}

package/dist/components/tour/use-tour.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/tour/use-tour.ts
 function useTour(props, notify = {}) {
+	const xhConfig = useXhConfig();
 	const backdropRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
@@ -16,8 +19,9 @@ function useTour(props, notify = {}) {
 		...props,
 		...notify
 	}), scope);
+	let config = null;
 	if (typeof document !== "undefined") {
-		const config = createRuntimeConfig({
+		config = createRuntimeConfig({
 			scope,
 			idGenerator: idGen
 		});
@@ -35,12 +39,23 @@ function useTour(props, notify = {}) {
 		service.refs.set("getFloatingEl", () => positionerRef.value);
 		service.refs.set("getContentEl", () => contentRef.value);
 	}
+	const api = computed(() => connectTour(service, vueNormalize));
+	const visible = useOverlayExit({
+		config,
+		isOpen: () => api.value.open,
+		contentRef
+	});
+	const portalTarget = computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
+	const showBackdrop = () => props.showBackdrop ?? true;
 	return {
 		service,
-		api: computed(() => connectTour(service, vueNormalize)),
+		api,
 		backdropRef,
 		positionerRef,
-		contentRef
+		contentRef,
+		visible,
+		showBackdrop,
+		portalTarget
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-tour.js","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"sourcesContent":["import type { TourApi, TourSchema } 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 { connectTour, tourMachine } 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 TourContext {\n  service: Service<TourSchema>\n  api: ComputedRef<TourApi>\n  backdropRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n}\n\nexport function useTour(\n  props: TourSchema['props'],\n  notify: Pick<TourSchema['props'], 'onOpenChange' | 'onStepChange' | 'onComplete' | 'onSkip'> = {},\n): TourContext {\n  const backdropRef = 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  // 四个回调由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tourMachine, () => ({ ...props, ...notify }), 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      // 引导是模态的：遮罩盖住整页，焦点陷在浮层里\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => true,\n      setModal: () => {},\n      // 遮罩登记为可点关闭的表面，是否真关由 closeOnInteractOutside 决定\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点由机器按每步 target 自行解析\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectTour(service, vueNormalize))\n  return { service, api, backdropRef, positionerRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAoBA,SAAgB,QACd,OACA,SAA+F,CAAC,GACnF;CACb,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,oBAAoB;EAAE,GAAG;EAAO,GAAG;CAAO,IAAI,KAAK;CAE9E,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAE5F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe;GACf,gBAAgB,CAAC;GAEjB,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,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,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAGA,OAAO;EAAE;EAAS,KADN,eAAe,YAAY,SAAS,YAAY,CACxC;EAAG;EAAa;EAAe;CAAW;AAChE"}
+{"version":3,"file":"use-tour.js","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"sourcesContent":["import type { TourApi, TourSchema } 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 { connectTour, tourMachine } 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 TourContext {\n  service: Service<TourSchema>\n  api: ComputedRef<TourApi>\n  backdropRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该可见：收起那一帧押后到退场动画播完；遮罩、高亮框与定位层跟它一起收。 */\n  visible: Ref<boolean>\n  /** 作者是否要画遮罩。 */\n  showBackdrop: () => boolean\n  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useTour(\n  props: TourSchema['props'],\n  notify: Pick<TourSchema['props'], 'onOpenChange' | 'onStepChange' | 'onComplete' | 'onSkip'> = {},\n): TourContext {\n  const xhConfig = useXhConfig()\n  const backdropRef = 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  // 四个回调由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tourMachine, () => ({ ...props, ...notify }), scope)\n\n  // 服务端没有 DOM、也就没有落点：config 为 null 时浮层退回 body\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      // 引导是模态的：遮罩盖住整页，焦点陷在浮层里\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => true,\n      setModal: () => {},\n      // 遮罩登记为可点关闭的表面，是否真关由 closeOnInteractOutside 决定\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点由机器按每步 target 自行解析\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectTour(service, vueNormalize))\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  const showBackdrop = (): boolean => props.showBackdrop ?? true\n\n  return { service, api, backdropRef, positionerRef, contentRef, visible, showBackdrop, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,QACd,OACA,SAA+F,CAAC,GACnF;CACb,MAAM,WAAW,YAAY;CAC7B,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,oBAAoB;EAAE,GAAG;EAAO,GAAG;CAAO,IAAI,KAAK;CAG9E,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAE7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe;GACf,gBAAgB,CAAC;GAEjB,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,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,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,YAAY,SAAS,YAAY,CAAC;CAC7D,MAAM,UAAU,eAAe;EAAE;EAAQ,cAAc,IAAI,MAAM;EAAM;CAAW,CAAC;CAEnF,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,MAAM,qBAA8B,MAAM,gBAAgB;CAE1D,OAAO;EAAE;EAAS;EAAK;EAAa;EAAe;EAAY;EAAS;EAAc;CAAa;AACrG"}

package/dist/components/transfer/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/transfer/context.ts"],"sourcesContent":["import type { TransferItemProps, TransferPanelProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TransferContext } from './use-transfer'\nimport { inject, provide } from 'vue'\n\n/** 面板自报的身份，供面板内两侧共用的角色节点区分自己归哪一侧。 */\nexport interface TransferPanelContext {\n  panel: ComputedRef<TransferPanelProps>\n}\n\n/** 条目自报的值与所属面板，供 item-text / item-checkbox 复用同一份声明。 */\nexport interface TransferItemContext {\n  item: ComputedRef<TransferItemProps>\n}\n\nconst KEY: InjectionKey<TransferContext> = Symbol('xh-transfer')\nconst PANEL_KEY: InjectionKey<TransferPanelContext> = Symbol('xh-transfer-panel')\nconst ITEM_KEY: InjectionKey<TransferItemContext> = Symbol('xh-transfer-item')\n\nexport function provideTransfer(ctx: TransferContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTransferContext(): TransferContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 部件必须用在 XhTransferRoot 内')\n  return ctx\n}\n\nexport function provideTransferPanel(ctx: TransferPanelContext): void {\n  provide(PANEL_KEY, ctx)\n}\n\nexport function useTransferPanelContext(): TransferPanelContext {\n  const ctx = inject(PANEL_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 面板子部件必须用在 XhTransferSourcePanel / XhTransferTargetPanel 内')\n  return ctx\n}\n\nexport function provideTransferItem(ctx: TransferItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useTransferItemContext(): TransferItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 条目子部件必须用在 XhTransferItem 内')\n  return ctx\n}\n"],"mappings":";;AAeA,MAAM,MAAqC,OAAO,aAAa;AAC/D,MAAM,YAAgD,OAAO,mBAAmB;AAChF,MAAM,WAA8C,OAAO,kBAAkB;AAE7E,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yEAAyE;CAC3F,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/transfer/context.ts"],"sourcesContent":["import type { TransferItemProps, TransferPanelProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TransferContext } from './use-transfer'\nimport { inject, provide } from 'vue'\n\n/** 面板自报的身份，供面板内两侧共用的角色节点区分自己归哪一侧。 */\nexport interface TransferPanelContext {\n  panel: ComputedRef<TransferPanelProps>\n}\n\n/** 条目自报的值与所属面板，供 item-text / item-checkbox 复用同一份声明。 */\nexport interface TransferItemContext {\n  item: ComputedRef<TransferItemProps>\n}\n\nconst KEY: InjectionKey<TransferContext> = Symbol.for('xh-transfer')\nconst PANEL_KEY: InjectionKey<TransferPanelContext> = Symbol.for('xh-transfer-panel')\nconst ITEM_KEY: InjectionKey<TransferItemContext> = Symbol.for('xh-transfer-item')\n\nexport function provideTransfer(ctx: TransferContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTransferContext(): TransferContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 部件必须用在 XhTransferRoot 内')\n  return ctx\n}\n\nexport function provideTransferPanel(ctx: TransferPanelContext): void {\n  provide(PANEL_KEY, ctx)\n}\n\nexport function useTransferPanelContext(): TransferPanelContext {\n  const ctx = inject(PANEL_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 面板子部件必须用在 XhTransferSourcePanel / XhTransferTargetPanel 内')\n  return ctx\n}\n\nexport function provideTransferItem(ctx: TransferItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useTransferItemContext(): TransferItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 条目子部件必须用在 XhTransferItem 内')\n  return ctx\n}\n"],"mappings":";;AAeA,MAAM,MAAqC,OAAO,IAAI,aAAa;AACnE,MAAM,YAAgD,OAAO,IAAI,mBAAmB;AACpF,MAAM,WAA8C,OAAO,IAAI,kBAAkB;AAEjF,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yEAAyE;CAC3F,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT"}

package/dist/components/transfer/transfer.d.ts

@@ -7,14 +7,14 @@ type TransferProps = TransferSchema['props'];
 /** 默认插槽的载荷：目标侧的值与两侧的勾选、两侧当下可见的条目，以及勾选、写值与搬运的动作。 */
 interface TransferRootSlotProps {
   value: string[];
-  selected: string[];
+  selection: string[];
   sourceItems: readonly TransferItem[];
   targetItems: readonly TransferItem[];
   canMove: (to: TransferSide) => boolean;
   checkState: (side: TransferSide) => TransferCheckState;
   isChecked: (value: string) => boolean;
   setValue: (next: string[]) => void;
-  setSelected: (next: string[]) => void;
+  setSelection: (next: string[]) => void;
   toggle: (value: string) => void;
   toggleAll: (side: TransferSide) => void;
   move: (to: TransferSide) => void;
@@ -43,11 +43,11 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
     type: PropType<string[]>;
     default: undefined;
   };
-  selected: {
+  selection: {
     type: PropType<string[]>;
     default: undefined;
   };
-  defaultSelected: {
+  defaultSelection: {
     type: PropType<string[]>;
     default: undefined;
   };
@@ -72,7 +72,7 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   'value-change': (_details: PayloadOf<TransferProps, "onValueChange">) => true;
   'selection-change': (_details: PayloadOf<TransferProps, "onSelectionChange">) => true;
   'update:value': (_value: PayloadOf<TransferProps, "onValueChange">["value"]) => true;
-  'update:selected': (_selected: PayloadOf<TransferProps, "onSelectionChange">["selected"]) => true;
+  'update:selection': (_value: PayloadOf<TransferProps, "onSelectionChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<TransferItem[]>;
@@ -86,11 +86,11 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
     type: PropType<string[]>;
     default: undefined;
   };
-  selected: {
+  selection: {
     type: PropType<string[]>;
     default: undefined;
   };
-  defaultSelected: {
+  defaultSelection: {
     type: PropType<string[]>;
     default: undefined;
   };
@@ -113,7 +113,7 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   "onValue-change"?: ((_details: import("@xihan-ui/headless").TransferValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
   "onSelection-change"?: ((_details: import("@xihan-ui/headless").TransferSelectionChangeDetails) => any) | undefined;
-  "onUpdate:selected"?: ((_selected: string[]) => any) | undefined;
+  "onUpdate:selection"?: ((_value: string[]) => any) | undefined;
 }>, {
   filter: TransferFilter;
   value: string[];
@@ -123,9 +123,9 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   disabled: boolean;
   loop: boolean;
   searchable: boolean;
-  selected: string[];
+  selection: string[];
+  defaultSelection: string[];
   oneWay: boolean;
-  defaultSelected: string[];
 }, SlotsType<{
   default?: (props: TransferRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"transfer.d.ts","names":[],"sources":["../../../src/components/transfer/transfer.ts"],"mappings":";;;;;KAuBK,gBAAgB;;UAGJ;EACf;EACA;EACA,sBAAsB;EACtB,sBAAsB;EACtB,UAAU,IAAI;EACd,aAAa,MAAM,iBAAiB;EACpC,YAAY;EACZ,WAAW;EACX,cAAc;EACd,SAAS;EACT,YAAY,MAAM;EAClB,OAAO,IAAI;;;UAII;EACf,MAAM;EACN,gBAAgB;EAChB,YAAY;EACZ;;;UAIQ;EACR,WAAW,OAAO,2BAA2B;;cAGlC,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;IACd,MAAA;;;;IACO,MAAA;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;IAEN,MAAA,SAAS;;;;;;;;;;IAId,MAAA,SAAS;;;;;;EAIL,iBAAA,UAAA,UAAU;EACN,qBAAA,UAAA,UAAU;EAChB,iBAAA,QAAA,UAAU;EACJ,oBAAA,WAAA,UAAU;;;IAjBZ,MAAA,SAAS;;;;IACd,MAAA;;;;IACO,MAAA;;;;IACJ,MAAA;;;;IACO,MAAA;;;;;IAEN,MAAA,SAAS;;;;;;;;;;IAId,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,0BAA0B;kCA+B9C;cAkBW,qCAAqB,0BAfqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cAqB/F,qCAAqB,0BArBqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cA2B/F,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAQ/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAQrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAqCzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"transfer.d.ts","names":[],"sources":["../../../src/components/transfer/transfer.ts"],"mappings":";;;;;KAuBK,gBAAgB;;UAGJ;EACf;EACA;EACA,sBAAsB;EACtB,sBAAsB;EACtB,UAAU,IAAI;EACd,aAAa,MAAM,iBAAiB;EACpC,YAAY;EACZ,WAAW;EACX,eAAe;EACf,SAAS;EACT,YAAY,MAAM;EAClB,OAAO,IAAI;;;UAII;EACf,MAAM;EACN,gBAAgB;EAChB,YAAY;EACZ;;;UAIQ;EACR,WAAW,OAAO,2BAA2B;;cAGlC,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;IACd,MAAA;;;;IACO,MAAA;;;;IACH,MAAA;;;;IACO,MAAA;;;;;IAEP,MAAA,SAAS;;;;;;;;;;IAId,MAAA,SAAS;;;;;;EAIL,iBAAA,UAAA,UAAU;EACN,qBAAA,UAAA,UAAU;EAChB,iBAAA,QAAA,UAAU;EACN,qBAAA,QAAA,UAAU;;;IAjBV,MAAA,SAAS;;;;IACd,MAAA;;;;IACO,MAAA;;;;IACH,MAAA;;;;IACO,MAAA;;;;;IAEP,MAAA,SAAS;;;;;;;;;;IAId,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,0BAA0B;kCA+B9C;cAkBW,qCAAqB,0BAfqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cAqB/F,qCAAqB,0BArBqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cA2B/F,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAQ/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAQrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAqCzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/transfer/transfer.js

@@ -17,11 +17,11 @@ const XhTransferRoot = defineComponent({
 			type: Array,
 			default: void 0
 		},
-		selected: {
+		selection: {
 			type: Array,
 			default: void 0
 		},
-		defaultSelected: {
+		defaultSelection: {
 			type: Array,
 			default: void 0
 		},
@@ -45,7 +45,7 @@ const XhTransferRoot = defineComponent({
 		"value-change": (_details) => true,
 		"selection-change": (_details) => true,
 		"update:value": (_value) => true,
-		"update:selected": (_selected) => true
+		"update:selection": (_value) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -53,25 +53,25 @@ const XhTransferRoot = defineComponent({
 			emit("value-change", details);
 			emit("update:value", details.value);
 		};
-		const notifySelected = (details) => {
+		const notifySelection = (details) => {
 			emit("selection-change", details);
-			emit("update:selected", details.selected);
+			emit("update:selection", details.value);
 		};
 		const ctx = useTransfer(props, {
 			onValueChange: notifyValue,
-			onSelectionChange: notifySelected
+			onSelectionChange: notifySelection
 		});
 		provideTransfer(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			value: ctx.api.value.value,
-			selected: ctx.api.value.selected,
+			selection: ctx.api.value.selection,
 			sourceItems: ctx.api.value.visibleItems("source"),
 			targetItems: ctx.api.value.visibleItems("target"),
 			canMove: ctx.api.value.canMove,
 			checkState: ctx.api.value.checkState,
 			isChecked: ctx.api.value.isChecked,
 			setValue: ctx.api.value.setValue,
-			setSelected: ctx.api.value.setSelected,
+			setSelection: ctx.api.value.setSelection,
 			toggle: ctx.api.value.toggle,
 			toggleAll: ctx.api.value.toggleAll,
 			move: ctx.api.value.move