@xihan-ui/vue 4.2.0 → 5.0.0

package/dist/components/toolbar/toolbar.d.ts

@@ -1,6 +1,6 @@
-import { PropType, SlotsType, VNode } from "vue";
-import { ControlVariant, Direction, Orientation, Size } from "@xihan-ui/core";
 import { ToolbarApi, ToolbarTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { ControlVariant, Direction, IconRecord, Orientation, Size } from "@xihan-ui/core";
 //#region src/components/toolbar/toolbar.d.ts
 /** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */
 type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>;
@@ -28,6 +28,9 @@ declare const XhToolbarRoot: import("vue").DefineComponent<import("vue").Extract
   translations: {
     type: PropType<Partial<ToolbarTranslations>>;
   };
+  itemIcons: {
+    type: PropType<Readonly<Record<string, IconRecord>>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -54,6 +57,9 @@ declare const XhToolbarRoot: import("vue").DefineComponent<import("vue").Extract
   translations: {
     type: PropType<Partial<ToolbarTranslations>>;
   };
+  itemIcons: {
+    type: PropType<Readonly<Record<string, IconRecord>>>;
+  };
 }>> & Readonly<{}>, {
   loop: boolean;
   disabled: boolean;
@@ -72,6 +78,8 @@ declare const XhToolbarItem: import("vue").DefineComponent<import("vue").Extract
     required: true;
   };
   disabled: BooleanConstructor;
+  /** 只放图标、没有看得见的文字：按方钮画，宽等于高；名字由 aria-label 给。 */
+  iconOnly: BooleanConstructor;
   /** 条目渲染为哪个标签，默认 button；不自动补 type="button"，表单内需自行声明。 */
   as: {
     type: StringConstructor;
@@ -85,6 +93,8 @@ declare const XhToolbarItem: import("vue").DefineComponent<import("vue").Extract
     required: true;
   };
   disabled: BooleanConstructor;
+  /** 只放图标、没有看得见的文字：按方钮画，宽等于高；名字由 aria-label 给。 */
+  iconOnly: BooleanConstructor;
   /** 条目渲染为哪个标签，默认 button；不自动补 type="button"，表单内需自行声明。 */
   as: {
     type: StringConstructor;
@@ -93,6 +103,7 @@ declare const XhToolbarItem: import("vue").DefineComponent<import("vue").Extract
 }>> & Readonly<{}>, {
   as: string;
   disabled: boolean;
+  iconOnly: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
  * 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。

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

@@ -1 +1 @@
-{"version":3,"file":"toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/toolbar.ts"],"mappings":";;;;;KAqBY,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;IAIS,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;IANlB,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAGvC,WAAC,OAAO,yBAAyB;kCAe7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCxB;;;;;;;cAQW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAUnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/toolbar.ts"],"mappings":";;;;;KAqBY,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;IAIS,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;IACpB,MAAA,SAAS,SAAS,eAAe;;;;;;IAP/B,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;IACpB,MAAA,SAAS,SAAS,eAAe;;;;;;EAGpD,WAAC,OAAO,yBAAyB;kCAe7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAsCxB;;;;;;;cAQW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAUnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/toolbar/toolbar.js

@@ -3,8 +3,8 @@ import { mergePartProps } from "../../runtime/merge-props.js";
 import { XhMenuRoot } from "../menu/menu.js";
 import { provideToolbar, useToolbarContext } from "./context.js";
 import { useToolbar } from "./use-toolbar.js";
-import { defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
 import { toolbarOverflowMenuProps } from "@xihan-ui/headless";
+import { defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
 //#region src/components/toolbar/toolbar.ts
 const XhToolbarRoot = defineComponent({
 	name: "XhToolbarRoot",
@@ -21,7 +21,8 @@ const XhToolbarRoot = defineComponent({
 		},
 		variant: { type: String },
 		size: { type: String },
-		translations: { type: Object }
+		translations: { type: Object },
+		itemIcons: { type: Object }
 	},
 	slots: Object,
 	setup(props, { slots }) {
@@ -61,6 +62,8 @@ const XhToolbarItem = defineComponent({
 			required: true
 		},
 		disabled: Boolean,
+		/** 只放图标、没有看得见的文字：按方钮画，宽等于高；名字由 aria-label 给。 */
+		iconOnly: Boolean,
 		/** 条目渲染为哪个标签，默认 button；不自动补 type="button"，表单内需自行声明。 */
 		as: {
 			type: String,
@@ -87,7 +90,8 @@ const XhToolbarItem = defineComponent({
 		return () => h(props.as, {
 			...ctx.api.value.getItemProps({
 				value: props.value,
-				disabled: props.disabled
+				disabled: props.disabled,
+				iconOnly: props.iconOnly
 			}),
 			ref: itemEl
 		}, slots.default?.());

package/dist/components/toolbar/toolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar.js","names":[],"sources":["../../../src/components/toolbar/toolbar.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// 提供 toolbar 相关实现。\n\nimport type { ControlVariant, Direction, Orientation, Size } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema, ToolbarTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { toolbarOverflowMenuProps } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhMenuRoot } from '../menu/menu'\nimport { provideToolbar, useToolbarContext } from './context'\nimport { useToolbar } from './use-toolbar'\n\ntype ToolbarProps = ToolbarSchema['props']\n\n/** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */\nexport type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>\n\nexport const XhToolbarRoot = defineComponent({\n  name: 'XhToolbarRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<ToolbarTranslations>> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ToolbarRootSlotProps) => VNode[]\n  }>,\n  // 无对外事件，条目的点击与切换由条目自行派发\n  setup(props, { slots }) {\n    const ctx = useToolbar(withXhConfig('toolbar', props) as ToolbarProps)\n    provideToolbar(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement | null },\n    }, slots.default?.({\n      focusedValue: ctx.api.value.focusedValue,\n      orientation: ctx.api.value.orientation,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\nexport const XhToolbarGroup = defineComponent({\n  name: 'XhToolbarGroup',\n  setup(_, { slots }) {\n    const ctx = useToolbarContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhToolbarSeparator = defineComponent({\n  name: 'XhToolbarSeparator',\n  setup() {\n    const ctx = useToolbarContext()\n    // 分隔线不渲染内容\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhToolbarItem = defineComponent({\n  name: 'XhToolbarItem',\n  props: {\n    value: { type: String, required: true },\n    disabled: Boolean,\n    /** 条目渲染为哪个标签，默认 button；不自动补 type=\"button\"，表单内需自行声明。 */\n    as: { type: String, default: 'button' },\n  },\n  setup(props, { slots }) {\n    const ctx = useToolbarContext()\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报工具条失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'TOOLBAR.BLUR' })\n    })\n    return () => h(\n      props.as,\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。\n * 放在 root 的最后。它同时是一张 Menu 的触发器——菜单的条目、勾选态与落位都由工具条的机器现给\n * （toolbarOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖与工具条的处理器不让位。\n * 不写内容时由皮肤画一枚横排三点。\n */\nexport const XhToolbarOverflowTrigger = defineComponent({\n  name: 'XhToolbarOverflowTrigger',\n  // 直通属性合到钮上，而不是落到菜单的根组件上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useToolbarContext()\n    return () => h(XhMenuRoot, { ...toolbarOverflowMenuProps(ctx.service), triggerAsChild: true }, {\n      trigger: () => [h('button', mergePartProps(ctx.api.value.getOverflowTriggerProps() as Record<string, unknown>, attrs), slots.default?.())],\n    })\n  },\n})\n"],"mappings":";;;;;;;;AAuBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAiD;CACzE;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,CAAiB;EACrE,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,MAAM,OAAgB;IAAE,IAAI,QAAQ,QAAQ;GAAyB;EACvE,GAAG,MAAM,UAAU;GACjB,cAAc,IAAI,IAAI,MAAM;GAC5B,aAAa,IAAI,IAAI,MAAM;GAC3B,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;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;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,kBAAkB,CAA4B;CACpF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EACtC,UAAU;;EAEV,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAS;CACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAE9B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GACF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EACpD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GAEpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,eAAe,CAAC;EACzC,CAAC;EACD,aAAa,EACX,MAAM,IACN;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;IAAE,OAAO,MAAM;IAAO,UAAU,MAAM;GAAS,CAAC;GAA8B,KAAK;EAAO,GAC1H,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;;;;;;AAQD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,YAAY;GAAE,GAAG,yBAAyB,IAAI,OAAO;GAAG,gBAAgB;EAAK,GAAG,EAC7F,eAAe,CAAC,EAAE,UAAU,eAAe,IAAI,IAAI,MAAM,wBAAwB,GAA8B,KAAK,GAAG,MAAM,UAAU,CAAC,CAAC,EAC3I,CAAC;CACH;AACF,CAAC"}
+{"version":3,"file":"toolbar.js","names":[],"sources":["../../../src/components/toolbar/toolbar.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// 提供 toolbar 相关实现。\n\nimport type { ControlVariant, Direction, IconRecord, Orientation, Size } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema, ToolbarTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { toolbarOverflowMenuProps } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhMenuRoot } from '../menu/menu'\nimport { provideToolbar, useToolbarContext } from './context'\nimport { useToolbar } from './use-toolbar'\n\ntype ToolbarProps = ToolbarSchema['props']\n\n/** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */\nexport type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>\n\nexport const XhToolbarRoot = defineComponent({\n  name: 'XhToolbarRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<ToolbarTranslations>> },\n    itemIcons: { type: Object as PropType<Readonly<Record<string, IconRecord>>> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ToolbarRootSlotProps) => VNode[]\n  }>,\n  // 无对外事件，条目的点击与切换由条目自行派发\n  setup(props, { slots }) {\n    const ctx = useToolbar(withXhConfig('toolbar', props) as ToolbarProps)\n    provideToolbar(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement | null },\n    }, slots.default?.({\n      focusedValue: ctx.api.value.focusedValue,\n      orientation: ctx.api.value.orientation,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\nexport const XhToolbarGroup = defineComponent({\n  name: 'XhToolbarGroup',\n  setup(_, { slots }) {\n    const ctx = useToolbarContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhToolbarSeparator = defineComponent({\n  name: 'XhToolbarSeparator',\n  setup() {\n    const ctx = useToolbarContext()\n    // 分隔线不渲染内容\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhToolbarItem = defineComponent({\n  name: 'XhToolbarItem',\n  props: {\n    value: { type: String, required: true },\n    disabled: Boolean,\n    /** 只放图标、没有看得见的文字：按方钮画，宽等于高；名字由 aria-label 给。 */\n    iconOnly: Boolean,\n    /** 条目渲染为哪个标签，默认 button；不自动补 type=\"button\"，表单内需自行声明。 */\n    as: { type: String, default: 'button' },\n  },\n  setup(props, { slots }) {\n    const ctx = useToolbarContext()\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报工具条失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'TOOLBAR.BLUR' })\n    })\n    return () => h(\n      props.as,\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled, iconOnly: props.iconOnly }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。\n * 放在 root 的最后。它同时是一张 Menu 的触发器——菜单的条目、勾选态与落位都由工具条的机器现给\n * （toolbarOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖与工具条的处理器不让位。\n * 不写内容时由皮肤画一枚横排三点。\n */\nexport const XhToolbarOverflowTrigger = defineComponent({\n  name: 'XhToolbarOverflowTrigger',\n  // 直通属性合到钮上，而不是落到菜单的根组件上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useToolbarContext()\n    return () => h(XhMenuRoot, { ...toolbarOverflowMenuProps(ctx.service), triggerAsChild: true }, {\n      trigger: () => [h('button', mergePartProps(ctx.api.value.getOverflowTriggerProps() as Record<string, unknown>, attrs), slots.default?.())],\n    })\n  },\n})\n"],"mappings":";;;;;;;;AAuBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAiD;EACvE,WAAW,EAAE,MAAM,OAAyD;CAC9E;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,CAAiB;EACrE,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,MAAM,OAAgB;IAAE,IAAI,QAAQ,QAAQ;GAAyB;EACvE,GAAG,MAAM,UAAU;GACjB,cAAc,IAAI,IAAI,MAAM;GAC5B,aAAa,IAAI,IAAI,MAAM;GAC3B,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;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;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,kBAAkB,CAA4B;CACpF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EACtC,UAAU;;EAEV,UAAU;;EAEV,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAS;CACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAE9B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GACF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EACpD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GAEpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,eAAe,CAAC;EACzC,CAAC;EACD,aAAa,EACX,MAAM,IACN;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;IAAE,OAAO,MAAM;IAAO,UAAU,MAAM;IAAU,UAAU,MAAM;GAAS,CAAC;GAA8B,KAAK;EAAO,GACpJ,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;;;;;;AAQD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,YAAY;GAAE,GAAG,yBAAyB,IAAI,OAAO;GAAG,gBAAgB;EAAK,GAAG,EAC7F,eAAe,CAAC,EAAE,UAAU,eAAe,IAAI,IAAI,MAAM,wBAAwB,GAA8B,KAAK,GAAG,MAAM,UAAU,CAAC,CAAC,EAC3I,CAAC;CACH;AACF,CAAC"}

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

@@ -1,6 +1,6 @@
+import { ToolbarApi, ToolbarSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ToolbarApi, ToolbarSchema } from "@xihan-ui/headless";
 //#region src/components/toolbar/use-toolbar.d.ts
 interface ToolbarContext {
   api: ComputedRef<ToolbarApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectToolbar, toolbarMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/toolbar/use-toolbar.ts
 function useToolbar(props) {
 	const rootRef = ref(null);

package/dist/components/tooltip/context.d.ts

@@ -1,6 +1,6 @@
+import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
 //#region src/components/tooltip/context.d.ts
 interface TooltipContext {
   service: Service<TooltipSchema>;

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

@@ -1,7 +1,8 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TooltipApi, TooltipSchema, TooltipTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
+import { KbdPlatform } from "@xihan-ui/core/hotkey";
 //#region src/components/tooltip/tooltip.d.ts
 type TooltipProps = TooltipSchema['props'];
 /** 默认插槽的载荷：展开状态与开合方法。 */
@@ -71,12 +72,23 @@ declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 委托模式：CSS 选择器。trigger 是容器，命中它的元素悬停或键盘聚焦时打开提示并作锚点，文字与快捷键从锚点上读。 */
+  delegate: {
+    type: StringConstructor;
+  };
+  /** 委托模式下快捷键按哪个平台的写法显示，默认 auto：指向锚点时测一次。 */
+  platform: {
+    type: PropType<KbdPlatform>;
+  };
   tone: {
     type: PropType<Tone>;
   };
   size: {
     type: PropType<Size>;
   };
+  translations: {
+    type: PropType<Partial<TooltipTranslations>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -114,12 +126,23 @@ declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 委托模式：CSS 选择器。trigger 是容器，命中它的元素悬停或键盘聚焦时打开提示并作锚点，文字与快捷键从锚点上读。 */
+  delegate: {
+    type: StringConstructor;
+  };
+  /** 委托模式下快捷键按哪个平台的写法显示，默认 auto：指向锚点时测一次。 */
+  platform: {
+    type: PropType<KbdPlatform>;
+  };
   tone: {
     type: PropType<Tone>;
   };
   size: {
     type: PropType<Size>;
   };
+  translations: {
+    type: PropType<Partial<TooltipTranslations>>;
+  };
 }>> & Readonly<{
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").TooltipOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
@@ -155,6 +178,14 @@ declare const XhTooltipPositioner: import("vue").DefineComponent<import("vue").E
     type: PropType<Element>;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 委托模式下的提示文字：缺省显示当前锚点的文字。 */
+declare const XhTooltipText: 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 XhTooltipShortcut: 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 XhTooltipContent: 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>;
@@ -162,5 +193,5 @@ declare const XhTooltipArrow: import("vue").DefineComponent<{}, () => VNode<impo
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { TooltipRootSlotProps, XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipTrigger };
+export { TooltipRootSlotProps, XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipShortcut, XhTooltipText, XhTooltipTrigger };
 //# sourceMappingURL=tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip.d.ts","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"mappings":";;;;;KAmBK,eAAe;;KAGR,uBAAuB,KAAK;;;;;cAM3B,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmB5B,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAQR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAjBJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAQR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tooltip.d.ts","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"mappings":";;;;;;KAqBK,eAAe;;KAGR,uBAAuB,KAAK;;;;;cAM3B,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmB5B,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;IAWJ,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIvB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAtBJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;IAWJ,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCA0B3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;;cAGW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/tooltip/tooltip.js

@@ -1,10 +1,11 @@
+import { withXhConfig } from "../../config/config.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { provideTooltip, provideTooltipGroup, useTooltipContext } from "./context.js";
 import { useTooltip } from "./use-tooltip.js";
-import { defineComponent, h, mergeProps } from "vue";
 import { createTooltipGroup } from "@xihan-ui/headless";
+import { defineComponent, h, mergeProps } from "vue";
 //#region src/components/tooltip/tooltip.ts
 /**
 * 提示组：子树里的提示归同一组，共用接替窗口、同一时刻只开一个，没写延时的取这里给的缺省。
@@ -51,8 +52,13 @@ const XhTooltipRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 委托模式：CSS 选择器。trigger 是容器，命中它的元素悬停或键盘聚焦时打开提示并作锚点，文字与快捷键从锚点上读。 */
+		delegate: { type: String },
+		/** 委托模式下快捷键按哪个平台的写法显示，默认 auto：指向锚点时测一次。 */
+		platform: { type: String },
 		tone: { type: String },
-		size: { type: String }
+		size: { type: String },
+		translations: { type: Object }
 	},
 	emits: {
 		"open-change": (_details) => true,
@@ -64,7 +70,7 @@ const XhTooltipRoot = defineComponent({
 			emit("open-change", details);
 			emit("update:open", details.open);
 		};
-		const ctx = useTooltip(props, notify);
+		const ctx = useTooltip(withXhConfig("tooltip", props), notify);
 		provideTooltip(ctx);
 		return () => slots.default?.({
 			open: ctx.api.value.open,
@@ -92,7 +98,7 @@ asChild: Boolean },
 				const merged = mergeIntoChild(children, part, "tooltip");
 				if (merged) return merged;
 			}
-			return h("button", part, children);
+			return h(ctx.api.value.delegated ? "div" : "button", part, children);
 		};
 	}
 });
@@ -116,17 +122,38 @@ container: { type: Object } },
 		}, slots.default?.())]);
 	}
 });
+/** 委托模式下的提示文字：缺省显示当前锚点的文字。 */
+const XhTooltipText = defineComponent({
+	name: "XhTooltipText",
+	setup(_, { slots }) {
+		const ctx = useTooltipContext();
+		return () => h("span", ctx.api.value.getTextProps(), slots.default?.() ?? ctx.api.value.text);
+	}
+});
+/** 委托模式下的快捷键：缺省显示当前锚点的快捷键，按平台的写法。 */
+const XhTooltipShortcut = defineComponent({
+	name: "XhTooltipShortcut",
+	setup(_, { slots }) {
+		const ctx = useTooltipContext();
+		return () => h("span", ctx.api.value.getShortcutProps(), slots.default?.() ?? ctx.api.value.shortcut ?? void 0);
+	}
+});
 const XhTooltipContent = defineComponent({
 	name: "XhTooltipContent",
 	setup(_, { slots }) {
 		const ctx = useTooltipContext();
+		const children = () => ctx.api.value.delegated ? [
+			...slots.default?.() ?? [],
+			h(XhTooltipText),
+			ctx.api.value.shortcut === null ? null : h(XhTooltipShortcut)
+		] : slots.default?.();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
 			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}
-		}, slots.default?.());
+		}, children());
 	}
 });
 const XhTooltipArrow = defineComponent({
@@ -137,6 +164,6 @@ const XhTooltipArrow = defineComponent({
 	}
 });
 //#endregion
-export { XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipTrigger };
+export { XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipShortcut, XhTooltipText, XhTooltipTrigger };
 
 //# sourceMappingURL=tooltip.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip.js","names":[],"sources":["../../../src/components/tooltip/tooltip.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// 提供 tooltip 相关实现。\n\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { TooltipApi, TooltipSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { createTooltipGroup } from '@xihan-ui/headless'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideTooltip, provideTooltipGroup, useTooltipContext } from './context'\nimport { useTooltip } from './use-tooltip'\n\ntype TooltipProps = TooltipSchema['props']\n\n/** 默认插槽的载荷：展开状态与开合方法。 */\nexport type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>\n\n/**\n * 提示组：子树里的提示归同一组，共用接替窗口、同一时刻只开一个，没写延时的取这里给的缺省。\n * 本身不渲染节点，也不改动子节点的排布。\n */\nexport const XhTooltipProvider = defineComponent({\n  name: 'XhTooltipProvider',\n  props: {\n    /** 组内提示悬停进入到展开的缺省等待毫秒；提示自己写了就以提示为准。 */\n    openDelay: { type: Number },\n    /** 组内提示悬停移出到收起的缺省等待毫秒。 */\n    closeDelay: { type: Number },\n    /** 组内提示的缺省接替窗口毫秒；0 表示组内不接替。 */\n    skipDelayDuration: { type: Number },\n  },\n  setup(props, { slots }) {\n    // 组在 Provider 的一生里只建一次；缺省值每次现读，改 props 下一次开合即生效\n    provideTooltipGroup(createTooltipGroup(() => ({\n      openDelay: props.openDelay,\n      closeDelay: props.closeDelay,\n      skipDelayDuration: props.skipDelayDuration,\n    })))\n    return () => slots.default?.()\n  },\n})\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> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    /** 跳过等待的窗口毫秒，默认 300：另一个提示开着或刚收起时，指向这一个直接接替、不播进场；0 不参与。 */\n    skipDelayDuration: { type: Number },\n    disabled: Boolean,\n    /** 跟随鼠标：由指针打开的提示锚在指针落点上并随移动更新；触屏与聚焦打开时锚回 trigger。 */\n    followCursor: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\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  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useTooltipContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'tooltip')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhTooltipPositioner = defineComponent({\n  name: 'XhTooltipPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTooltipContext()\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, slots.default?.()),\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":"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"}
+{"version":3,"file":"tooltip.js","names":[],"sources":["../../../src/components/tooltip/tooltip.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// 提供 tooltip 相关实现。\n\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { KbdPlatform } from '@xihan-ui/core/hotkey'\nimport type { TooltipApi, TooltipSchema, TooltipTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { createTooltipGroup } from '@xihan-ui/headless'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideTooltip, provideTooltipGroup, useTooltipContext } from './context'\nimport { useTooltip } from './use-tooltip'\n\ntype TooltipProps = TooltipSchema['props']\n\n/** 默认插槽的载荷：展开状态与开合方法。 */\nexport type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>\n\n/**\n * 提示组：子树里的提示归同一组，共用接替窗口、同一时刻只开一个，没写延时的取这里给的缺省。\n * 本身不渲染节点，也不改动子节点的排布。\n */\nexport const XhTooltipProvider = defineComponent({\n  name: 'XhTooltipProvider',\n  props: {\n    /** 组内提示悬停进入到展开的缺省等待毫秒；提示自己写了就以提示为准。 */\n    openDelay: { type: Number },\n    /** 组内提示悬停移出到收起的缺省等待毫秒。 */\n    closeDelay: { type: Number },\n    /** 组内提示的缺省接替窗口毫秒；0 表示组内不接替。 */\n    skipDelayDuration: { type: Number },\n  },\n  setup(props, { slots }) {\n    // 组在 Provider 的一生里只建一次；缺省值每次现读，改 props 下一次开合即生效\n    provideTooltipGroup(createTooltipGroup(() => ({\n      openDelay: props.openDelay,\n      closeDelay: props.closeDelay,\n      skipDelayDuration: props.skipDelayDuration,\n    })))\n    return () => slots.default?.()\n  },\n})\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> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    /** 跳过等待的窗口毫秒，默认 300：另一个提示开着或刚收起时，指向这一个直接接替、不播进场；0 不参与。 */\n    skipDelayDuration: { type: Number },\n    disabled: Boolean,\n    /** 跟随鼠标：由指针打开的提示锚在指针落点上并随移动更新；触屏与聚焦打开时锚回 trigger。 */\n    followCursor: { type: Boolean, default: undefined },\n    /** 委托模式：CSS 选择器。trigger 是容器，命中它的元素悬停或键盘聚焦时打开提示并作锚点，文字与快捷键从锚点上读。 */\n    delegate: { type: String },\n    /** 委托模式下快捷键按哪个平台的写法显示，默认 auto：指向锚点时测一次。 */\n    platform: { type: String as PropType<KbdPlatform> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<TooltipTranslations>> },\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(withXhConfig('tooltip', 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  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useTooltipContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'tooltip')\n        if (merged)\n          return merged\n      }\n      // 委托模式下 trigger 是装着一个个锚点的容器，不是按钮\n      return h(ctx.api.value.delegated ? 'div' : 'button', part, children)\n    }\n  },\n})\n\nexport const XhTooltipPositioner = defineComponent({\n  name: 'XhTooltipPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTooltipContext()\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, slots.default?.()),\n    ])\n  },\n})\n\n/** 委托模式下的提示文字：缺省显示当前锚点的文字。 */\nexport const XhTooltipText = defineComponent({\n  name: 'XhTooltipText',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('span', ctx.api.value.getTextProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.text)\n  },\n})\n\n/** 委托模式下的快捷键：缺省显示当前锚点的快捷键，按平台的写法。 */\nexport const XhTooltipShortcut = defineComponent({\n  name: 'XhTooltipShortcut',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    return () => h('span', ctx.api.value.getShortcutProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.shortcut ?? undefined)\n  },\n})\n\nexport const XhTooltipContent = defineComponent({\n  name: 'XhTooltipContent',\n  setup(_, { slots }) {\n    const ctx = useTooltipContext()\n    // 委托模式下文字与快捷键由组件铺在作者写的节点（箭头）之后，没有快捷键时不铺 shortcut\n    const children = (): unknown => ctx.api.value.delegated\n      ? [...(slots.default?.() ?? []), h(XhTooltipText), ctx.api.value.shortcut === null ? null : h(XhTooltipShortcut)]\n      : slots.default?.()\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    }, children() as VNode[] | undefined)\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":"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"}

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

@@ -4,9 +4,9 @@ import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { useTooltipGroup } from "./context.js";
+import { connectTooltip, tooltipMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectTooltip, tooltipMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/tooltip/use-tooltip.ts
 function useTooltip(props, onOpenChange) {

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TourApi, TourSchema, TourStep, TourTarget } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement } from "@xihan-ui/core";
-import { TourApi, TourSchema, TourStep } from "@xihan-ui/headless";
 //#region src/components/tour/tour.d.ts
 type TourProps = TourSchema['props'];
 /** 默认插槽的载荷：引导的开合与步序状态，以及开关、切换步骤、放弃与校准位置的动作。 */
@@ -57,6 +57,10 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   targetTimeout: {
     type: NumberConstructor;
   };
+  /** 引导只在这块区域里进行：遮罩只盖它、高亮框裁在它里面，区域外照常可用；省略即整个视口。 */
+  boundary: {
+    type: PropType<TourTarget | null>;
+  };
   translations: {
     type: PropType<TourProps["translations"]>;
   };
@@ -124,6 +128,10 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
   targetTimeout: {
     type: NumberConstructor;
   };
+  /** 引导只在这块区域里进行：遮罩只盖它、高亮框裁在它里面，区域外照常可用；省略即整个视口。 */
+  boundary: {
+    type: PropType<TourTarget | null>;
+  };
   translations: {
     type: PropType<TourProps["translations"]>;
   };

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

@@ -1 +1 @@
-{"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;;;;;;;;;;;;;;;;;;;;;;;;;;IAQA,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;;;IA3BL,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;IAQA,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"}
+{"version":3,"file":"tour.d.ts","names":[],"sources":["../../../src/components/tour/tour.ts"],"mappings":";;;;;KAkBK,YAAY;;KAGL,oBAAoB,KAC9B;cAgBW,0BAAU,8BAAA;;IAIK,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;IASgB,MAAA,SAAS;;;IACzB,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;;;IA7BL,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;IASgB,MAAA,SAAS;;;IACzB,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;;8BAWtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,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,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { provideTour, useTourContext } from "./context.js";
 import { useTour } from "./use-tour.js";
@@ -41,6 +42,12 @@ const XhTourRoot = defineComponent({
 		},
 		/** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */
 		targetTimeout: { type: Number },
+		/** 引导只在这块区域里进行：遮罩只盖它、高亮框裁在它里面，区域外照常可用；省略即整个视口。 */
+		boundary: { type: [
+			String,
+			Object,
+			Function
+		] },
 		translations: { type: Object },
 		/** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */
 		container: { type: Object }
@@ -153,6 +160,7 @@ const XhTourTitle = defineComponent({
 	name: "XhTourTitle",
 	setup(_, { slots }) {
 		const ctx = useTourContext();
+		useTitleDescriptionPart(ctx.presence, "title");
 		return () => h("h2", ctx.api.value.getTitleProps(), slots.default?.() ?? ctx.api.value.currentStep?.title);
 	}
 });
@@ -160,7 +168,11 @@ const XhTourDescription = defineComponent({
 	name: "XhTourDescription",
 	setup(_, { slots }) {
 		const ctx = useTourContext();
-		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.() ?? ctx.api.value.currentStep?.description);
+		const el = useDescriptionPart(ctx.presence);
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: el
+		}, slots.default?.() ?? ctx.api.value.currentStep?.description);
 	}
 });
 const XhTourProgressText = defineComponent({

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

@@ -1 +1 @@
-{"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    /** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */\n    targetTimeout: { type: Number },\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, present: ctx.visible.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, present: ctx.visible.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, present: ctx.visible.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":"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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, TourTarget } 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 { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\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    /** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */\n    targetTimeout: { type: Number },\n    /** 引导只在这块区域里进行：遮罩只盖它、高亮框裁在它里面，区域外照常可用；省略即整个视口。 */\n    boundary: { type: [String, Object, Function] as PropType<TourTarget | null> },\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, present: ctx.visible.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, present: ctx.visible.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, present: ctx.visible.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    useTitleDescriptionPart(ctx.presence, 'title')\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    // 读不出一句话的说明不进描述链\n    const el = useDescriptionPart(ctx.presence)\n    return () => h(\n      'p',\n      { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el },\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":"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"}

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

@@ -1,6 +1,7 @@
+import { TitleDescriptionPresence } from "../../runtime/title-description.js";
+import { TourApi, TourSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { TourApi, TourSchema } from "@xihan-ui/headless";
 //#region src/components/tour/use-tour.d.ts
 interface TourContext {
   service: Service<TourSchema>;
@@ -15,6 +16,8 @@ interface TourContext {
   showBackdrop: () => boolean;
   /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
   portalTarget: ComputedRef<string | Element>;
+  /** 标题与说明在不在场，由 XhTourTitle / XhTourDescription 登记；只引用在场的部件。 */
+  presence: TitleDescriptionPresence;
 }
 declare function useTour(props: TourSchema['props'], notify?: Pick<TourSchema['props'], 'onOpenChange' | 'onValueChange' | 'onComplete' | 'onSkip'>, container?: () => Element | null | undefined): 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":";;;;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"}
+{"version":3,"file":"use-tour.d.ts","names":[],"sources":["../../../src/components/tour/use-tour.ts"],"mappings":";;;;;UAsBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,aAAa,IAAI;EACjB,cAAc,IAAI;EAClB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET;;EAEA,cAAc,qBAAqB;;EAEnC,UAAU;;iBAGI,QACd,OAAO,qBACP,SAAQ,KAAK,kFACb,kBAAkB,6BACjB"}