@xihan-ui/vue 1.1.0 → 2.0.0

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

@@ -1,23 +1,20 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Placement } from "@xihan-ui/core";
 import { TourApi, TourSchema, TourStep } from "@xihan-ui/headless";
-import { Placement } from "@xihan-ui/kernel";
 //#region src/components/tour/tour.d.ts
 type TourProps = TourSchema['props'];
-/** 默认插槽的载荷：引导的开合与步序状态，以及开关、走步、放弃与校准位置的动作。 */
-type TourRootSlotProps = Pick<TourApi, 'open' | 'step' | 'count' | 'currentStep' | 'firstStep' | 'lastStep' | 'progressText' | 'setOpen' | 'setStep' | 'goToNextStep' | 'goToPrevStep' | 'skip' | 'remeasure'>;
+/** 默认插槽的载荷：引导的开合与步序状态，以及开关、切换步骤、放弃与校准位置的动作。 */
+type TourRootSlotProps = Pick<TourApi, 'open' | 'value' | 'count' | 'currentStep' | 'firstStep' | 'lastStep' | 'progressText' | 'setOpen' | 'setValue' | 'goToNextStep' | 'goToPrevStep' | 'skip' | 'remeasure'>;
 declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   steps: {
     type: PropType<TourStep[]>;
-    default: undefined;
   };
-  step: {
+  value: {
     type: NumberConstructor;
-    default: undefined;
   };
-  defaultStep: {
+  defaultValue: {
     type: NumberConstructor;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -29,11 +26,13 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
+  };
+  /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */
+  dir: {
+    type: PropType<Direction>;
   };
   closeOnEscape: {
     type: BooleanConstructor;
@@ -49,7 +48,6 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   spotlightPadding: {
     type: NumberConstructor;
-    default: undefined;
   };
   autoScroll: {
     type: BooleanConstructor;
@@ -57,29 +55,29 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   translations: {
     type: PropType<TourProps["translations"]>;
-    default: undefined;
+  };
+  /** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'open-change': (_details: PayloadOf<TourProps, "onOpenChange">) => true;
   'update:open': (_open: PayloadOf<TourProps, "onOpenChange">["open"]) => true;
-  'step-change': (_details: PayloadOf<TourProps, "onStepChange">) => true;
-  'update:step': (_step: PayloadOf<TourProps, "onStepChange">["step"]) => true;
+  'value-change': (_details: PayloadOf<TourProps, "onValueChange">) => true;
+  'update:value': (_value: PayloadOf<TourProps, "onValueChange">["value"]) => true;
   complete: (_details: PayloadOf<TourProps, "onComplete">) => true;
   skip: (_details: PayloadOf<TourProps, "onSkip">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   steps: {
     type: PropType<TourStep[]>;
-    default: undefined;
   };
-  step: {
+  value: {
     type: NumberConstructor;
-    default: undefined;
   };
-  defaultStep: {
+  defaultValue: {
     type: NumberConstructor;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -91,11 +89,13 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
+  };
+  /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */
+  dir: {
+    type: PropType<Direction>;
   };
   closeOnEscape: {
     type: BooleanConstructor;
@@ -111,7 +111,6 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   spotlightPadding: {
     type: NumberConstructor;
-    default: undefined;
   };
   autoScroll: {
     type: BooleanConstructor;
@@ -119,29 +118,25 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   translations: {
     type: PropType<TourProps["translations"]>;
-    default: undefined;
+  };
+  /** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
   };
 }>> & Readonly<{
+  "onValue-change"?: ((_details: import("@xihan-ui/headless").TourValueChangeDetails) => any) | undefined;
+  "onUpdate:value"?: ((_value: number) => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").TourOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   onComplete?: ((_details: import("@xihan-ui/headless").TourCompleteDetails) => any) | undefined;
-  "onStep-change"?: ((_details: import("@xihan-ui/headless").TourStepChangeDetails) => any) | undefined;
-  "onUpdate:step"?: ((_step: number) => any) | undefined;
   onSkip?: ((_details: import("@xihan-ui/headless").TourSkipDetails) => any) | undefined;
 }>, {
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").TourTranslations> | undefined;
-  offset: number;
-  placement: Placement;
-  steps: TourStep[];
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
-  step: number;
   autoScroll: boolean;
-  defaultStep: number;
   showBackdrop: boolean;
-  spotlightPadding: number;
 }, SlotsType<{
   default?: (props: TourRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -166,6 +161,23 @@ declare const XhTourDescription: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhTourProgressText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 圆点组：未提供默认插槽时按步数铺设圆点，作者提供后按作者的内容。 */
+declare const XhTourProgressIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhTourProgressDot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  index: {
+    type: PropType<number | string>;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  index: {
+    type: PropType<number | string>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTourPrevTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -182,5 +194,5 @@ declare const XhTourArrow: import("vue").DefineComponent<{}, () => VNode<import(
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { TourRootSlotProps, XhTourArrow, XhTourBackdrop, XhTourCloseTrigger, XhTourContent, XhTourDescription, XhTourNextTrigger, XhTourPositioner, XhTourPrevTrigger, XhTourProgressText, XhTourRoot, XhTourSkipTrigger, XhTourSpotlight, XhTourTitle };
+export { TourRootSlotProps, XhTourArrow, XhTourBackdrop, XhTourCloseTrigger, XhTourContent, XhTourDescription, XhTourNextTrigger, XhTourPositioner, XhTourPrevTrigger, XhTourProgressDot, XhTourProgressIndicator, XhTourProgressText, XhTourRoot, XhTourSkipTrigger, XhTourSpotlight, XhTourTitle };
 //# sourceMappingURL=tour.d.ts.map

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;;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"}
+{"version":3,"file":"tour.d.ts","names":[],"sources":["../../../src/components/tour/tour.ts"],"mappings":";;;;;KAiBK,YAAY;;KAGL,oBAAoB,KAC9B;cAgBW,0BAAU,8BAAA;;IAIK,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;;EAIZ,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACZ,WAAA,UAAA,UAAU;EACd,OAAA,UAAA,UAAU;;;IAzBL,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;;;;;;;;;;;;;;EAY5B,WAAC,OAAO,sBAAsB;kCAiC1C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAgBzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAgB1B,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;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAelC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;IAIS,MAAA;;;;;;;IAAA,MAAA;;;MAMrC,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,23 +1,15 @@
 import { withXhConfig } from "../../config/config.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { provideTour, useTourContext } from "./context.js";
 import { useTour } from "./use-tour.js";
-import { Teleport, defineComponent, h, mergeProps } from "vue";
+import { defineComponent, h, mergeProps } from "vue";
 //#region src/components/tour/tour.ts
 const XhTourRoot = defineComponent({
 	name: "XhTourRoot",
 	props: {
-		steps: {
-			type: Array,
-			default: void 0
-		},
-		step: {
-			type: Number,
-			default: void 0
-		},
-		defaultStep: {
-			type: Number,
-			default: void 0
-		},
+		steps: { type: Array },
+		value: { type: Number },
+		defaultValue: { type: Number },
 		open: {
 			type: Boolean,
 			default: void 0
@@ -26,14 +18,10 @@ const XhTourRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		placement: {
-			type: String,
-			default: void 0
-		},
-		offset: {
-			type: Number,
-			default: void 0
-		},
+		placement: { type: String },
+		offset: { type: Number },
+		/** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */
+		dir: { type: String },
 		closeOnEscape: {
 			type: Boolean,
 			default: void 0
@@ -46,24 +34,20 @@ const XhTourRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		spotlightPadding: {
-			type: Number,
-			default: void 0
-		},
+		spotlightPadding: { type: Number },
 		autoScroll: {
 			type: Boolean,
 			default: void 0
 		},
-		translations: {
-			type: Object,
-			default: void 0
-		}
+		translations: { type: Object },
+		/** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */
+		container: { type: Object }
 	},
 	emits: {
 		"open-change": (_details) => true,
 		"update:open": (_open) => true,
-		"step-change": (_details) => true,
-		"update:step": (_step) => true,
+		"value-change": (_details) => true,
+		"update:value": (_value) => true,
 		"complete": (_details) => true,
 		"skip": (_details) => true
 	},
@@ -74,24 +58,24 @@ const XhTourRoot = defineComponent({
 				emit("open-change", details);
 				emit("update:open", details.open);
 			},
-			onStepChange: (details) => {
-				emit("step-change", details);
-				emit("update:step", details.step);
+			onValueChange: (details) => {
+				emit("value-change", details);
+				emit("update:value", details.value);
 			},
 			onComplete: (details) => emit("complete", details),
 			onSkip: (details) => emit("skip", details)
-		});
+		}, () => props.container);
 		provideTour(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			open: ctx.api.value.open,
-			step: ctx.api.value.step,
+			value: ctx.api.value.value,
 			count: ctx.api.value.count,
 			currentStep: ctx.api.value.currentStep,
 			firstStep: ctx.api.value.firstStep,
 			lastStep: ctx.api.value.lastStep,
 			progressText: ctx.api.value.progressText,
 			setOpen: ctx.api.value.setOpen,
-			setStep: ctx.api.value.setStep,
+			setValue: ctx.api.value.setValue,
 			goToNextStep: ctx.api.value.goToNextStep,
 			goToPrevStep: ctx.api.value.goToPrevStep,
 			skip: ctx.api.value.skip,
@@ -104,7 +88,7 @@ const XhTourBackdrop = defineComponent({
 	inheritAttrs: false,
 	setup(_, { slots, attrs }) {
 		const ctx = useTourContext();
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		return () => h(XhPortal, { to: ctx.portalTarget.value }, () => [h("div", {
 			...mergeProps(ctx.api.value.getBackdropProps(), attrs),
 			hidden: !ctx.visible.value || !ctx.showBackdrop() || void 0,
 			ref: (el) => {
@@ -118,9 +102,12 @@ const XhTourSpotlight = defineComponent({
 	inheritAttrs: false,
 	setup(_, { attrs }) {
 		const ctx = useTourContext();
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		return () => h(XhPortal, { to: ctx.portalTarget.value }, () => [h("div", {
 			...mergeProps(ctx.api.value.getSpotlightProps(), attrs),
-			hidden: !ctx.visible.value || !ctx.api.value.anchored || void 0
+			hidden: !ctx.visible.value || !ctx.api.value.anchored || void 0,
+			ref: (el) => {
+				ctx.spotlightRef.value = el;
+			}
 		})]);
 	}
 });
@@ -129,7 +116,7 @@ const XhTourPositioner = defineComponent({
 	inheritAttrs: false,
 	setup(_, { slots, attrs }) {
 		const ctx = useTourContext();
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		return () => h(XhPortal, { to: ctx.portalTarget.value }, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			hidden: !ctx.visible.value || void 0,
 			ref: (el) => {
@@ -172,6 +159,29 @@ const XhTourProgressText = defineComponent({
 		return () => h("span", ctx.api.value.getProgressTextProps(), slots.default?.() ?? ctx.api.value.progressText);
 	}
 });
+/** 圆点组：未提供默认插槽时按步数铺设圆点，作者提供后按作者的内容。 */
+const XhTourProgressIndicator = defineComponent({
+	name: "XhTourProgressIndicator",
+	setup(_, { slots }) {
+		const ctx = useTourContext();
+		return () => {
+			const api = ctx.api.value;
+			const dots = Array.from({ length: api.count }, (_, index) => h("div", api.getProgressDotProps({ index })));
+			return h("div", api.getProgressIndicatorProps(), slots.default?.() ?? dots);
+		};
+	}
+});
+const XhTourProgressDot = defineComponent({
+	name: "XhTourProgressDot",
+	props: { index: {
+		type: [Number, String],
+		required: true
+	} },
+	setup(props) {
+		const ctx = useTourContext();
+		return () => h("div", ctx.api.value.getProgressDotProps({ index: Number(props.index) }));
+	}
+});
 const XhTourPrevTrigger = defineComponent({
 	name: "XhTourPrevTrigger",
 	setup(_, { slots }) {
@@ -208,6 +218,6 @@ const XhTourArrow = defineComponent({
 	}
 });
 //#endregion
-export { XhTourArrow, XhTourBackdrop, XhTourCloseTrigger, XhTourContent, XhTourDescription, XhTourNextTrigger, XhTourPositioner, XhTourPrevTrigger, XhTourProgressText, XhTourRoot, XhTourSkipTrigger, XhTourSpotlight, XhTourTitle };
+export { XhTourArrow, XhTourBackdrop, XhTourCloseTrigger, XhTourContent, XhTourDescription, XhTourNextTrigger, XhTourPositioner, XhTourPrevTrigger, XhTourProgressDot, XhTourProgressIndicator, XhTourProgressText, XhTourRoot, XhTourSkipTrigger, XhTourSpotlight, XhTourTitle };
 
 //# sourceMappingURL=tour.js.map

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, 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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"}
+{"version":3,"file":"tour.js","names":[],"sources":["../../../src/components/tour/tour.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// 提供 tour 相关实现。\n\nimport type { Direction, Placement } from '@xihan-ui/core'\nimport type { TourApi, TourSchema, TourStep } 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 { XhPortal } from '../../runtime/portal'\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  | 'value'\n  | 'count'\n  | 'currentStep'\n  | 'firstStep'\n  | 'lastStep'\n  | 'progressText'\n  | 'setOpen'\n  | 'setValue'\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[]> },\n    value: { type: Number },\n    defaultValue: { type: Number },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: { type: Boolean, default: undefined },\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: undefined },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    showBackdrop: { type: Boolean, default: undefined },\n    spotlightPadding: { type: Number },\n    autoScroll: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TourProps['translations']> },\n    /** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // open-change / value-change 携带对象；update:* 携带裸值，支持 v-model:open 与 v-model:value\n  emits: {\n    'open-change': (_details: PayloadOf<TourProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TourProps, 'onOpenChange'>['open']) => true,\n    'value-change': (_details: PayloadOf<TourProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TourProps, 'onValueChange'>['value']) => 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      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onComplete: details => emit('complete', details),\n      onSkip: details => emit('skip', details),\n    }, () => props.container)\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      value: ctx.api.value.value,\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      setValue: ctx.api.value.setValue,\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(XhPortal, { 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(XhPortal, { 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        ref: (el: unknown) => { ctx.spotlightRef.value = el as HTMLElement },\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(XhPortal, { 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\n/** 圆点组：未提供默认插槽时按步数铺设圆点，作者提供后按作者的内容。 */\nexport const XhTourProgressIndicator = defineComponent({\n  name: 'XhTourProgressIndicator',\n  setup(_, { slots }) {\n    const ctx = useTourContext()\n    return () => {\n      const api = ctx.api.value\n      const dots = Array.from({ length: api.count }, (_, index) =>\n        h('div', api.getProgressDotProps({ index }) as Record<string, unknown>))\n      return h(\n        'div',\n        api.getProgressIndicatorProps() as Record<string, unknown>,\n        slots.default?.() ?? dots,\n      )\n    }\n  },\n})\n\nexport const XhTourProgressDot = defineComponent({\n  name: 'XhTourProgressDot',\n  props: {\n    // 圆点对应的步序，0 基；兼收字符串\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props) {\n    const ctx = useTourContext()\n    return () => h('div', ctx.api.value.getProgressDotProps({ index: Number(props.index) }) as Record<string, unknown>)\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":";;;;;;AAqCA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,MAA8B;EAC7C,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAO;EAC7B,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACjD,WAAW,EAAE,MAAM,OAA8B;EACjD,QAAQ,EAAE,MAAM,OAAO;;EAEvB,KAAK,EAAE,MAAM,OAA8B;EAC3C,eAAe;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACnD,wBAAwB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5D,cAAc;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAClD,kBAAkB,EAAE,MAAM,OAAO;EACjC,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAChD,cAAc,EAAE,MAAM,OAA8C;;EAEpE,WAAW,EAAE,MAAM,OAA4B;CACjD;CAEA,OAAO;EACL,gBAAgB,aAAmD;EACnE,gBAAgB,UAAwD;EACxE,iBAAiB,aAAoD;EACrE,iBAAiB,WAA2D;EAC5E,aAAa,aAAiD;EAC9D,SAAS,aAA6C;CACxD;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,QAAQ,aAAa,QAAQ,KAAK,GAAgB;GAC5D,eAAe,YAAY;IACzB,KAAK,eAAe,OAAO;IAC3B,KAAK,eAAe,QAAQ,IAAI;GAClC;GACA,gBAAgB,YAAY;IAC1B,KAAK,gBAAgB,OAAO;IAC5B,KAAK,gBAAgB,QAAQ,KAAK;GACpC;GACA,aAAY,YAAW,KAAK,YAAY,OAAO;GAC/C,SAAQ,YAAW,KAAK,QAAQ,OAAO;EACzC,SAAS,MAAM,SAAS;EACxB,YAAY,GAAG;EAEf,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,OAAO,IAAI,IAAI,MAAM;GACrB,OAAO,IAAI,IAAI,MAAM;GACrB,aAAa,IAAI,IAAI,MAAM;GAC3B,WAAW,IAAI,IAAI,MAAM;GACzB,UAAU,IAAI,IAAI,MAAM;GACxB,cAAc,IAAI,IAAI,MAAM;GAC5B,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,cAAc,IAAI,IAAI,MAAM;GAC5B,cAAc,IAAI,IAAI,MAAM;GAC5B,MAAM,IAAI,IAAI,MAAM;GACpB,WAAW,IAAI,IAAI,MAAM;EAC3B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,eAAe;EAE3B,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,SAAS,CAC7D,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,iBAAiB,GAA8B,KAAK;GAEhF,QAAS,CAAC,IAAI,QAAQ,SAAS,CAAC,IAAI,aAAa,KAAM,KAAA;GACvD,MAAM,OAAgB;IAAE,IAAI,YAAY,QAAQ;GAAkB;EACpE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC;CACH;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAE3B,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,SAAS,CAC7D,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,kBAAkB,GAA8B,KAAK;GAEjF,QAAS,CAAC,IAAI,QAAQ,SAAS,CAAC,IAAI,IAAI,MAAM,YAAa,KAAA;GAC3D,MAAM,OAAgB;IAAE,IAAI,aAAa,QAAQ;GAAkB;EACrE,CAAC,CACH,CAAC;CACH;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,eAAe;EAE3B,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,SAAS,CAC7D,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAElF,QAAQ,CAAC,IAAI,QAAQ,SAAS,KAAA;GAC9B,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC;CACH;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,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;AAGD,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,MACA,IAAI,IAAI,MAAM,cAAc,GAC5B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,aAAa,KAClD;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,KACA,IAAI,IAAI,MAAM,oBAAoB,GAClC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,aAAa,WAClD;CACF;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,QACA,IAAI,IAAI,MAAM,qBAAqB,GACnC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YACrC;CACF;AACF,CAAC;;AAGD,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,OAAO,MAAM,KAAK,EAAE,QAAQ,IAAI,MAAM,IAAI,GAAG,UACjD,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,CAAC,CAA4B,CAAC;GACzE,OAAO,EACL,OACA,IAAI,0BAA0B,GAC9B,MAAM,UAAU,KAAK,IACvB;EACF;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO,EAEL,OAAO;EAAE,MAAM,CAAC,QAAQ,MAAM;EAAgC,UAAU;CAAK,EAC/E;CACA,MAAM,OAAO;EACX,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,oBAAoB,EAAE,OAAO,OAAO,MAAM,KAAK,EAAE,CAAC,CAA4B;CACpH;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,CAA4B;CAChF;AACF,CAAC"}

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

@@ -1,21 +1,22 @@
 import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 import { TourApi, TourSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/tour/use-tour.d.ts
 interface TourContext {
   service: Service<TourSchema>;
   api: ComputedRef<TourApi>;
   backdropRef: Ref<HTMLElement | null>;
+  spotlightRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
-  /** 此刻该不该可见：收起那一帧押后到退场动画播完；遮罩、高亮框与定位层跟它一起收。 */
+  /** 当前是否应当可见：收起的一帧推迟到退场动画播完；遮罩、高亮框与定位层与它一起收起。 */
   visible: Ref<boolean>;
-  /** 作者是否要画遮罩。 */
+  /** 作者是否要绘制遮罩。 */
   showBackdrop: () => boolean;
-  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useTour(props: TourSchema['props'], notify?: Pick<TourSchema['props'], 'onOpenChange' | 'onStepChange' | 'onComplete' | 'onSkip'>): TourContext;
+declare function useTour(props: TourSchema['props'], notify?: Pick<TourSchema['props'], 'onOpenChange' | 'onValueChange' | 'onComplete' | 'onSkip'>, container?: () => Element | null | undefined): TourContext;
 //#endregion
 export { TourContext, useTour };
 //# sourceMappingURL=use-tour.d.ts.map

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":";;;;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"}
+{"version":3,"file":"use-tour.d.ts","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,aAAa,IAAI;EACjB,cAAc,IAAI;EAClB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET;;EAEA,cAAc,qBAAqB;;iBAGrB,QACd,OAAO,qBACP,SAAQ,KAAK,kFACb,kBAAkB,6BACjB"}

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

@@ -4,13 +4,14 @@ 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 { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectTour, tourMachine } from "@xihan-ui/headless";
-import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/tour/use-tour.ts
-function useTour(props, notify = {}) {
+function useTour(props, notify = {}, container) {
 	const xhConfig = useXhConfig();
 	const backdropRef = ref(null);
+	const spotlightRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
@@ -30,7 +31,6 @@ function useTour(props, notify = {}) {
 			node: () => contentRef.value,
 			branches: () => [],
 			isModal: () => true,
-			setModal: () => {},
 			surfaces: () => [backdropRef.value].filter(Boolean)
 		});
 		service.refs.set("config", config);
@@ -43,14 +43,17 @@ function useTour(props, notify = {}) {
 	const visible = useOverlayExit({
 		config,
 		isOpen: () => api.value.open,
-		contentRef
+		contentRef,
+		additionalExitRefs: [backdropRef, spotlightRef],
+		onPresence: (presence) => service.refs.set("presence", presence)
 	});
-	const portalTarget = computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
+	const portalTarget = computed(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
 	const showBackdrop = () => props.showBackdrop ?? true;
 	return {
 		service,
 		api,
 		backdropRef,
+		spotlightRef,
 		positionerRef,
 		contentRef,
 		visible,

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 { 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"}
+{"version":3,"file":"use-tour.js","names":[],"sources":["../../../src/components/tour/use-tour.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 tour 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { TourApi, TourSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectTour, tourMachine } 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 TourContext {\n  service: Service<TourSchema>\n  api: ComputedRef<TourApi>\n  backdropRef: Ref<HTMLElement | null>\n  spotlightRef: 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' | 'onValueChange' | 'onComplete' | 'onSkip'> = {},\n  container?: () => Element | null | undefined,\n): TourContext {\n  const xhConfig = useXhConfig()\n  const backdropRef = ref<HTMLElement | null>(null)\n  const spotlightRef = 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      // 遮罩登记为可点关闭的表面，是否真关由 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({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    additionalExitRefs: [backdropRef, spotlightRef],\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  const showBackdrop = (): boolean => props.showBackdrop ?? true\n\n  return { service, api, backdropRef, spotlightRef, positionerRef, contentRef, visible, showBackdrop, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAmCA,SAAgB,QACd,OACA,SAAgG,CAAC,GACjG,WACa;CACb,MAAM,WAAW,YAAY;CAC7B,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,eAAe,IAAwB,IAAI;CACjD,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;GAEf,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;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,oBAAoB,CAAC,aAAa,YAAY;EAC9C,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,YAAY,KAAK,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAEhJ,MAAM,qBAA8B,MAAM,gBAAgB;CAE1D,OAAO;EAAE;EAAS;EAAK;EAAa;EAAc;EAAe;EAAY;EAAS;EAAc;CAAa;AACnH"}

package/dist/components/transfer/context.js

@@ -2,6 +2,7 @@ import { inject, provide } from "vue";
 //#region src/components/transfer/context.ts
 const KEY = Symbol.for("xh-transfer");
 const PANEL_KEY = Symbol.for("xh-transfer-panel");
+const GROUP_KEY = Symbol.for("xh-transfer-group");
 const ITEM_KEY = Symbol.for("xh-transfer-item");
 function provideTransfer(ctx) {
 	provide(KEY, ctx);
@@ -19,6 +20,14 @@ function useTransferPanelContext() {
 	if (!ctx) throw new Error("[xh] Transfer 面板子部件必须用在 XhTransferSourcePanel / XhTransferTargetPanel 内");
 	return ctx;
 }
+function provideTransferGroup(ctx) {
+	provide(GROUP_KEY, ctx);
+}
+function useTransferGroupContext() {
+	const ctx = inject(GROUP_KEY, null);
+	if (!ctx) throw new Error("[xh] Transfer 分组标题必须用在 XhTransferGroup 内");
+	return ctx;
+}
 function provideTransferItem(ctx) {
 	provide(ITEM_KEY, ctx);
 }
@@ -28,6 +37,6 @@ function useTransferItemContext() {
 	return ctx;
 }
 //#endregion
-export { provideTransfer, provideTransferItem, provideTransferPanel, useTransferContext, useTransferItemContext, useTransferPanelContext };
+export { provideTransfer, provideTransferGroup, provideTransferItem, provideTransferPanel, useTransferContext, useTransferGroupContext, useTransferItemContext, useTransferPanelContext };
 
 //# sourceMappingURL=context.js.map

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.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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/transfer/context.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// 提供 context 相关实现。\n\nimport type { TransferGroupProps, 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/** 分组声明的值与所属面板，供分组标题取到同一份身份（标题的 id 由它派生）。 */\nexport interface TransferGroupContext {\n  group: ComputedRef<TransferGroupProps>\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 GROUP_KEY: InjectionKey<TransferGroupContext> = Symbol.for('xh-transfer-group')\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 provideTransferGroup(ctx: TransferGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useTransferGroupContext(): TransferGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Transfer 分组标题必须用在 XhTransferGroup 内')\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":";;AA2BA,MAAM,MAAqC,OAAO,IAAI,aAAa;AACnE,MAAM,YAAgD,OAAO,IAAI,mBAAmB;AACpF,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,qBAAqB,KAAiC;CACpE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,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"}