@xihan-ui/vue 2.1.0 → 3.1.0

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 { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideTooltip, useTooltipContext } from './context'\nimport { useTooltip } from './use-tooltip'\n\ntype TooltipProps = TooltipSchema['props']\n\n/** 默认插槽的载荷：展开状态与开合方法。 */\nexport type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>\n\nexport const XhTooltipRoot = defineComponent({\n  name: 'XhTooltipRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    disabled: Boolean,\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 }, () => [\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":";;;;;;;AAuBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,WAAW,EAAE,MAAM,OAA8B;EACjD,QAAQ,EAAE,MAAM,OAAO;;EAEvB,KAAK,EAAE,MAAM,OAA8B;EAC3C,WAAW,EAAE,MAAM,OAAO;EAC1B,YAAY,EAAE,MAAM,OAAO;EAC3B,UAAU;EACV,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;CACzC;CAEA,OAAO;EACL,gBAAgB,aAAsD;EACtE,gBAAgB,UAA2D;CAC7E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAwC,YAAY;GACxD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,WAAW,OAAuB,MAAM;EACpD,eAAe,GAAG;EAClB,aAAa,MAAM,UAAU;GAAE,MAAM,IAAI,IAAI,MAAM;GAAM,SAAS,IAAI,IAAI,MAAM;EAAQ,CAAC;CAC3F;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,cAAc;CACd,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,kBAAkB;EAC9B,aAAa;GACX,MAAM,OAAO,eAAe;IAC1B,GAAG,IAAI,IAAI,MAAM,gBAAgB;IACjC,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE,GAAG,KAAK;GACR,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,MAAM,SAAS;IACvD,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,MAAM,QAAQ;EACnC;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,WAAW,EAAE,MAAM,OAA4B,EACjD;CAEA,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,UAAU;GAAE,IAAI,MAAM,aAAa,IAAI,aAAa;GAAO,QAAQ,IAAI;EAAW,SAAS,CACxG,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC;CACH;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}
+{"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 }, () => [\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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"}

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

@@ -1,22 +1,7 @@
-import { ComputedRef, Ref } from "vue";
-import { Service } from "@xihan-ui/core";
-import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
+import { TooltipContext } from "./context.js";
+import { TooltipSchema } from "@xihan-ui/headless";
 //#region src/components/tooltip/use-tooltip.d.ts
-interface TooltipContext {
-  service: Service<TooltipSchema>;
-  api: ComputedRef<TooltipApi>;
-  /** 定位锚点。 */
-  triggerRef: Ref<HTMLElement | null>;
-  /** 被定位的浮层。 */
-  positionerRef: Ref<HTMLElement | null>;
-  /** 浮层本体，退场动画从它上面探测。 */
-  contentRef: Ref<HTMLElement | null>;
-  /** 当前是否应当可见：退场动画播完之前仍为真。 */
-  visible: Ref<boolean>;
-  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
-  portalTarget: ComputedRef<string | Element>;
-}
 declare function useTooltip(props: TooltipSchema['props'], onOpenChange?: TooltipSchema['props']['onOpenChange']): TooltipContext;
 //#endregion
-export { TooltipContext, useTooltip };
+export { useTooltip };
 //# sourceMappingURL=use-tooltip.d.ts.map

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

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

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

@@ -3,6 +3,7 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { useTooltipGroup } from "./context.js";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectTooltip, tooltipMachine } from "@xihan-ui/headless";
@@ -38,6 +39,7 @@ function useTooltip(props, onOpenChange) {
 	}
 	service.refs.set("getAnchorEl", () => triggerRef.value);
 	service.refs.set("getFloatingEl", () => positionerRef.value);
+	service.refs.set("group", useTooltipGroup());
 	const api = computed(() => connectTooltip(service, vueNormalize));
 	return {
 		service,

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

@@ -1 +1 @@
-{"version":3,"file":"use-tooltip.js","names":[],"sources":["../../../src/components/tooltip/use-tooltip.ts"],"sourcesContent":["/*\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 tooltip 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { TooltipApi, TooltipSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectTooltip, tooltipMachine } 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 TooltipContext {\n  service: Service<TooltipSchema>\n  api: ComputedRef<TooltipApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 浮层本体，退场动画从它上面探测。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当可见：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useTooltip(\n  props: TooltipSchema['props'],\n  onOpenChange?: TooltipSchema['props']['onOpenChange'],\n): TooltipContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // onOpenChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tooltipMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按可见态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      // 提示只参与 Escape 仲裁与栈顶判定：节点就在文档流里，不陷焦点、不锁滚动、没有遮罩\n      kind: 'inline',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎经 refs 注入，展开态由机器的 effect 驱动\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n\n  const api = computed(() => connectTooltip(service, vueNormalize))\n\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, triggerRef, positionerRef, contentRef, visible, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAmCA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAGpF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAE7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CACA,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAE3D,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAYhE,OAAO;EAAE;EAAS;EAAK;EAAY;EAAe;EAAY,SAT9C,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIoE;EAAG,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}
+{"version":3,"file":"use-tooltip.js","names":[],"sources":["../../../src/components/tooltip/use-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// 提供 use tooltip 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/core'\nimport type { TooltipSchema } from '@xihan-ui/headless'\nimport type { TooltipContext } from './context'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectTooltip, tooltipMachine } 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'\nimport { useTooltipGroup } from './context'\n\nexport function useTooltip(\n  props: TooltipSchema['props'],\n  onOpenChange?: TooltipSchema['props']['onOpenChange'],\n): TooltipContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // onOpenChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(tooltipMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按可见态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      // 提示只参与 Escape 仲裁与栈顶判定：节点就在文档流里，不陷焦点、不锁滚动、没有遮罩\n      kind: 'inline',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎经 refs 注入，展开态由机器的 effect 驱动\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n  // 放在 XhTooltipProvider 里就归它那一组：共用接替窗口、同组只开一个、延时取组的缺省\n  service.refs.set('group', useTooltipGroup())\n\n  const api = computed(() => connectTooltip(service, vueNormalize))\n\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, triggerRef, positionerRef, contentRef, visible, portalTarget }\n}\n"],"mappings":";;;;;;;;;;;AAqBA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAGpF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAE7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CACA,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAE3D,QAAQ,KAAK,IAAI,SAAS,gBAAgB,CAAC;CAE3C,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAYhE,OAAO;EAAE;EAAS;EAAK;EAAY;EAAe;EAAY,SAT9C,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIoE;EAAG,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}

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

@@ -53,6 +53,10 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */
+  targetTimeout: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<TourProps["translations"]>;
   };
@@ -116,6 +120,10 @@ declare const XhTourRoot: import("vue").DefineComponent<import("vue").ExtractPro
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */
+  targetTimeout: {
+    type: NumberConstructor;
+  };
   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;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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"}

package/dist/components/tour/tour.js

@@ -39,6 +39,8 @@ const XhTourRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 目标缺席时等它出现的时长（ms），默认 3000；0 即不等。 */
+		targetTimeout: { type: Number },
 		translations: { type: Object },
 		/** 本实例三张 Tour 浮层的 Portal 容器；优先于应用级配置。 */
 		container: { type: Object }

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    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":"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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    /** 目标缺席时等它出现的时长（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 }, () => [\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":"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"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Size, Tone } from "@xihan-ui/core";
-import { TransferCheckState, TransferFilter, TransferItem, TransferSchema, TransferSide } from "@xihan-ui/headless";
+import { CollectionVirtualizer, TransferCheckState, TransferFilter, TransferItem, TransferSchema, TransferSide } from "@xihan-ui/headless";
 //#region src/components/transfer/transfer.d.ts
 type TransferProps = TransferSchema['props'];
 /** 默认插槽的载荷：目标侧的值与两侧的勾选、两侧当前可见的条目，以及勾选、写值与移动的动作。 */
@@ -25,6 +25,14 @@ interface TransferPanelSlotProps {
   items: readonly TransferItem[];
   checkState: TransferCheckState;
   query: string;
+  /** 这一侧分侧 + 搜索之后共有几条（不分页）。 */
+  total: number;
+  /** 当前页码（从 1 起）；不分页时恒为 1。 */
+  page: number;
+  /** 共有几页（至少 1 页）。 */
+  pageCount: number;
+  /** 翻到这一侧的第 page 页。 */
+  setPage: (page: number) => void;
 }
 /** 源/目标两个面板部件共用的插槽集合。 */
 interface TransferPanelSlots {
@@ -34,6 +42,9 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   collection: {
     type: PropType<TransferItem[]>;
   };
+  virtualizers: {
+    type: PropType<Partial<Record<TransferSide, CollectionVirtualizer>>>;
+  };
   value: {
     type: PropType<string[]>;
   };
@@ -56,6 +67,9 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   filter: {
     type: PropType<TransferFilter>;
   };
+  pageSize: {
+    type: NumberConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -97,6 +111,9 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   collection: {
     type: PropType<TransferItem[]>;
   };
+  virtualizers: {
+    type: PropType<Partial<Record<TransferSide, CollectionVirtualizer>>>;
+  };
   value: {
     type: PropType<string[]>;
   };
@@ -119,6 +136,9 @@ declare const XhTransferRoot: import("vue").DefineComponent<import("vue").Extrac
   filter: {
     type: PropType<TransferFilter>;
   };
+  pageSize: {
+    type: NumberConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"transfer.d.ts","names":[],"sources":["../../../src/components/transfer/transfer.ts"],"mappings":";;;;;KAoCK,gBAAgB;;UAGJ;EACf;EACA;EACA,sBAAsB;EACtB,sBAAsB;EACtB,UAAU,IAAI;EACd,aAAa,MAAM,iBAAiB;EACpC,YAAY;EACZ,WAAW;EACX,eAAe;EACf,SAAS;EACT,YAAY,MAAM;EAClB,OAAO,IAAI;;;UAII;EACf,MAAM;EACN,gBAAgB;EAChB,YAAY;EACZ;;;UAIQ;EACR,WAAW,OAAO,2BAA2B;;cAGlC,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;IACd,MAAA;;;IACO,MAAA;;;;;;;;;IAGH,MAAA;;;IACO,MAAA;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;;;;IAKb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;IAGV,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACN,qBAAA,UAAA,UAAU;EAChB,iBAAA,QAAA,UAAU;EACN,qBAAA,QAAA,UAAU;;;IAzBV,MAAA,SAAS;;;IACd,MAAA;;;IACO,MAAA;;;;;;;;;IAGH,MAAA;;;IACO,MAAA;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;;;;IAKb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;IAGV,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;;;;;;;;;;;;EAU/B,WAAC,OAAO,0BAA0B;kCAkC9C;cAkBW,qCAAqB,0BAfqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cAqB/F,qCAAqB,0BArBqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cA2B/F,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAQ/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;gCA2BzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAQrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAQ1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAQ5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;MAa1B,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAqCzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"transfer.d.ts","names":[],"sources":["../../../src/components/transfer/transfer.ts"],"mappings":";;;;;KAqCK,gBAAgB;;UAGJ;EACf;EACA;EACA,sBAAsB;EACtB,sBAAsB;EACtB,UAAU,IAAI;EACd,aAAa,MAAM,iBAAiB;EACpC,YAAY;EACZ,WAAW;EACX,eAAe;EACf,SAAS;EACT,YAAY,MAAM;EAClB,OAAO,IAAI;;;UAII;EACf,MAAM;EACN,gBAAgB;EAChB,YAAY;EACZ;;EAEA;;EAEA;;EAEA;;EAEA,UAAU;;;UAIF;EACR,WAAW,OAAO,2BAA2B;;cAGlC,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;IACN,MAAA,SAAS,QAAQ,OAAO,cAAc;;;IAC9C,MAAA;;;IACO,MAAA;;;;;;;;;IAGH,MAAA;;;IACO,MAAA;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAMb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;IAGV,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACN,qBAAA,UAAA,UAAU;EAChB,iBAAA,QAAA,UAAU;EACN,qBAAA,QAAA,UAAU;;;IA3BV,MAAA,SAAS;;;IACN,MAAA,SAAS,QAAQ,OAAO,cAAc;;;IAC9C,MAAA;;;IACO,MAAA;;;;;;;;;IAGH,MAAA;;;IACO,MAAA;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAMb,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;IAGV,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;;;;;;;;;;;;EAU/B,WAAC,OAAO,0BAA0B;kCAkC9C;cAsBW,qCAAqB,0BAnBqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cAyB/F,qCAAqB,0BAzBqE,iCAAK,qCAAA,iDAAA,aAAA,eAAA,kBAAA,UAAA,mDAAA;cA+B/F,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAQ/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;gCA4BzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAQrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAQ1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAQ5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;MAa1B,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAwCzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/transfer/transfer.js

@@ -9,6 +9,7 @@ const XhTransferRoot = defineComponent({
 	name: "XhTransferRoot",
 	props: {
 		collection: { type: Array },
+		virtualizers: { type: Object },
 		value: { type: Array },
 		defaultValue: { type: Array },
 		name: { type: String },
@@ -17,6 +18,7 @@ const XhTransferRoot = defineComponent({
 		defaultSelection: { type: Array },
 		searchable: Boolean,
 		filter: { type: Function },
+		pageSize: { type: Number },
 		disabled: {
 			type: Boolean,
 			default: void 0
@@ -90,7 +92,11 @@ function panelSetup(side) {
 			side,
 			items: ctx.api.value.visibleItems(side),
 			checkState: ctx.api.value.checkState(side),
-			query: ctx.api.value.query(side)
+			query: ctx.api.value.query(side),
+			total: ctx.api.value.filteredItems(side).length,
+			page: ctx.api.value.page(side),
+			pageCount: ctx.api.value.pageCount(side),
+			setPage: (page) => ctx.api.value.setPage(side, page)
 		}));
 	};
 }
@@ -144,7 +150,7 @@ const XhTransferList = defineComponent({
 		const { panel } = useTransferPanelContext();
 		const listRef = ref(null);
 		const bars = useScrollbars({
-			scrollable: () => listRef.value,
+			scrollable: () => ctx.service.prop("virtualizers")?.[panel.value.side]?.getViewportElement() ?? listRef.value,
 			axes: ["vertical", "horizontal"],
 			anchor: "layer",
 			props: () => ({ dir: ctx.service.prop("dir") })
@@ -226,6 +232,8 @@ const XhTransferItem = defineComponent({
 			if (next === prev) return;
 			const { service } = ctx;
 			if (service.getStatus() !== "Started") return;
+			const side = panel.value.side;
+			if (service.prop("virtualizers")?.[side] && ctx.api.value.visibleItems(side).some((item) => item.value === props.value)) return;
 			if (itemEl.value && service.scope.getActiveElement() === itemEl.value) service.send({
 				type: "ITEM.FOCUS",
 				side: panel.value.side,

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

@@ -1 +1 @@
-{"version":3,"file":"transfer.js","names":[],"sources":["../../../src/components/transfer/transfer.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// 提供 transfer 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  TransferCheckState,\n  TransferFilter,\n  TransferGroupProps,\n  TransferItem,\n  TransferItemProps,\n  TransferPanelProps,\n  TransferSchema,\n  TransferSide,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTransfer,\n  provideTransferGroup,\n  provideTransferItem,\n  provideTransferPanel,\n  useTransferContext,\n  useTransferGroupContext,\n  useTransferItemContext,\n  useTransferPanelContext,\n} from './context'\nimport { useTransfer } from './use-transfer'\n\ntype TransferProps = TransferSchema['props']\n\n/** 默认插槽的载荷：目标侧的值与两侧的勾选、两侧当前可见的条目，以及勾选、写值与移动的动作。 */\nexport interface TransferRootSlotProps {\n  value: string[]\n  selection: string[]\n  sourceItems: readonly TransferItem[]\n  targetItems: readonly TransferItem[]\n  canMove: (to: TransferSide) => boolean\n  checkState: (side: TransferSide) => TransferCheckState\n  isChecked: (value: string) => boolean\n  setValue: (next: string[]) => void\n  setSelection: (next: string[]) => void\n  toggle: (value: string) => void\n  toggleAll: (side: TransferSide) => void\n  move: (to: TransferSide) => void\n}\n\n/** 面板默认插槽的载荷：该侧的身份、当前可见的条目、该侧的全选三态与搜索词。 */\nexport interface TransferPanelSlotProps {\n  side: TransferSide\n  items: readonly TransferItem[]\n  checkState: TransferCheckState\n  query: string\n}\n\n/** 源/目标两个面板部件共用的插槽集合。 */\ninterface TransferPanelSlots {\n  default?: (props: TransferPanelSlotProps) => VNode[]\n}\n\nexport const XhTransferRoot = defineComponent({\n  name: 'XhTransferRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TransferItem[]> },\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    name: { type: String },\n    form: { type: String },\n    selection: { type: Array as PropType<string[]> },\n    defaultSelection: { type: Array as PropType<string[]> },\n    searchable: Boolean,\n    filter: { type: Function as PropType<TransferFilter> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    oneWay: Boolean,\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<TransferProps['translations']> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸集合以支持 v-model\n  emits: {\n    'value-change': (_details: PayloadOf<TransferProps, 'onValueChange'>) => true,\n    'selection-change': (_details: PayloadOf<TransferProps, 'onSelectionChange'>) => true,\n    'update:value': (_value: PayloadOf<TransferProps, 'onValueChange'>['value']) => true,\n    'update:selection': (_value: PayloadOf<TransferProps, 'onSelectionChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TransferRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: TransferProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifySelection: TransferProps['onSelectionChange'] = (details) => {\n      emit('selection-change', details)\n      emit('update:selection', details.value)\n    }\n    const ctx = useTransfer(withXhConfig('transfer', useFormControlProps(props)) as TransferProps, {\n      onValueChange: notifyValue,\n      onSelectionChange: notifySelection,\n    })\n    provideTransfer(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [slots.default?.({\n      value: ctx.api.value.value,\n      selection: ctx.api.value.selection,\n      sourceItems: ctx.api.value.visibleItems('source'),\n      targetItems: ctx.api.value.visibleItems('target'),\n      canMove: ctx.api.value.canMove,\n      checkState: ctx.api.value.checkState,\n      isChecked: ctx.api.value.isChecked,\n      setValue: ctx.api.value.setValue,\n      setSelection: ctx.api.value.setSelection,\n      toggle: ctx.api.value.toggle,\n      toggleAll: ctx.api.value.toggleAll,\n      move: ctx.api.value.move,\n    }), ...ctx.api.value.value.map(value => h('input', {\n      ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown>,\n      key: value,\n    }))])\n  },\n})\n\n/** 生成源/目标面板共用的 setup，两侧只在 side 上不同 */\nfunction panelSetup(side: TransferSide): (props: unknown, ctx: { slots: TransferPanelSlots }) => () => VNode {\n  return (_: unknown, { slots }: { slots: TransferPanelSlots }) => {\n    const ctx = useTransferContext()\n    const panel = computed<TransferPanelProps>(() => ({ side }))\n    provideTransferPanel({ panel })\n    return () => h('div', ctx.api.value.getPanelProps(panel.value) as Record<string, unknown>, slots.default?.({\n      side,\n      // 这一侧当下看得见的条目（分侧 + 搜索之后），不是数据入口：入口叫 collection，是整份全集\n      items: ctx.api.value.visibleItems(side),\n      checkState: ctx.api.value.checkState(side),\n      query: ctx.api.value.query(side),\n    }))\n  }\n}\n\nexport const XhTransferSourcePanel = defineComponent({\n  name: 'XhTransferSourcePanel',\n  slots: Object as SlotsType<TransferPanelSlots>,\n  setup: panelSetup('source'),\n})\n\nexport const XhTransferTargetPanel = defineComponent({\n  name: 'XhTransferTargetPanel',\n  slots: Object as SlotsType<TransferPanelSlots>,\n  setup: panelSetup('target'),\n})\n\nexport const XhTransferPanelHeader = defineComponent({\n  name: 'XhTransferPanelHeader',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('div', ctx.api.value.getPanelHeaderProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferPanelTitle = defineComponent({\n  name: 'XhTransferPanelTitle',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('span', ctx.api.value.getPanelTitleProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferPanelCount = defineComponent({\n  name: 'XhTransferPanelCount',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 只带 data-checked-count / data-count 属性，文案由作者或皮肤层提供\n    return () => h('span', ctx.api.value.getPanelCountProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferSearch = defineComponent({\n  name: 'XhTransferSearch',\n  setup() {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('input', ctx.api.value.getSearchProps(panel.value) as Record<string, unknown>)\n  },\n})\n\nexport const XhTransferList = defineComponent({\n  name: 'XhTransferList',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    const listRef = ref<HTMLElement | null>(null)\n    // 两侧定高小列表各走一路自绘条：条子紧跟在列表后面、贴在列表自己的盒子上，\n    // 挂在 root 这个定位盒上（面板不定位，root 才是列表的定位祖先）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => listRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 搬运、搜索筛选与空态显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getListProps(panel.value) as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { listRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhTransferSelectAllTrigger = defineComponent({\n  name: 'XhTransferSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 用原生 button，激活与禁用交给平台\n    return () => h('button', ctx.api.value.getSelectAllTriggerProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferEmpty = defineComponent({\n  name: 'XhTransferEmpty',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 空态占位：写在面板里、list 的兄弟；本侧没有可见条目时由连接层放它出面\n    return () => h('div', ctx.api.value.getEmptyProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferLoading = defineComponent({\n  name: 'XhTransferLoading',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferGroup = defineComponent({\n  name: 'XhTransferGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 两侧各挂一份同名分组，身份连 side 一起算，两边的标题 id 才不撞\n    const group = computed<TransferGroupProps>(() => ({ value: props.value, side: panel.value.side }))\n    provideTransferGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferGroupLabel = defineComponent({\n  name: 'XhTransferGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { group } = useTransferGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferItem = defineComponent({\n  name: 'XhTransferItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 条目只报值与所属面板，禁用与标签回 collection 里查；同一 value 的两侧节点靠 side 分身份\n    const item = computed<TransferItemProps>(() => ({ value: props.value, side: panel.value.side }))\n    provideTransferItem({ item })\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', side: panel.value.side, 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: 'LIST.BLUR', side: panel.value.side })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTransferItemText = defineComponent({\n  name: 'XhTransferItemText',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhTransferItemDescription = defineComponent({\n  name: 'XhTransferItemDescription',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhTransferItemSuffix = defineComponent({\n  name: 'XhTransferItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferItemCheckbox = defineComponent({\n  name: 'XhTransferItemCheckbox',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemCheckboxProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferToTargetTrigger = defineComponent({\n  name: 'XhTransferToTargetTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    // 用原生 button，激活与禁用交给平台\n    return () => h('button', ctx.api.value.getToTargetTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferToSourceTrigger = defineComponent({\n  name: 'XhTransferToSourceTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    return () => h('button', ctx.api.value.getToSourceTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"transfer.js","names":[],"sources":["../../../src/components/transfer/transfer.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// 提供 transfer 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CollectionVirtualizer,\n  TransferCheckState,\n  TransferFilter,\n  TransferGroupProps,\n  TransferItem,\n  TransferItemProps,\n  TransferPanelProps,\n  TransferSchema,\n  TransferSide,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTransfer,\n  provideTransferGroup,\n  provideTransferItem,\n  provideTransferPanel,\n  useTransferContext,\n  useTransferGroupContext,\n  useTransferItemContext,\n  useTransferPanelContext,\n} from './context'\nimport { useTransfer } from './use-transfer'\n\ntype TransferProps = TransferSchema['props']\n\n/** 默认插槽的载荷：目标侧的值与两侧的勾选、两侧当前可见的条目，以及勾选、写值与移动的动作。 */\nexport interface TransferRootSlotProps {\n  value: string[]\n  selection: string[]\n  sourceItems: readonly TransferItem[]\n  targetItems: readonly TransferItem[]\n  canMove: (to: TransferSide) => boolean\n  checkState: (side: TransferSide) => TransferCheckState\n  isChecked: (value: string) => boolean\n  setValue: (next: string[]) => void\n  setSelection: (next: string[]) => void\n  toggle: (value: string) => void\n  toggleAll: (side: TransferSide) => void\n  move: (to: TransferSide) => void\n}\n\n/** 面板默认插槽的载荷：该侧的身份、当前可见的条目、该侧的全选三态与搜索词。 */\nexport interface TransferPanelSlotProps {\n  side: TransferSide\n  items: readonly TransferItem[]\n  checkState: TransferCheckState\n  query: string\n  /** 这一侧分侧 + 搜索之后共有几条（不分页）。 */\n  total: number\n  /** 当前页码（从 1 起）；不分页时恒为 1。 */\n  page: number\n  /** 共有几页（至少 1 页）。 */\n  pageCount: number\n  /** 翻到这一侧的第 page 页。 */\n  setPage: (page: number) => void\n}\n\n/** 源/目标两个面板部件共用的插槽集合。 */\ninterface TransferPanelSlots {\n  default?: (props: TransferPanelSlotProps) => VNode[]\n}\n\nexport const XhTransferRoot = defineComponent({\n  name: 'XhTransferRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TransferItem[]> },\n    virtualizers: { type: Object as PropType<Partial<Record<TransferSide, CollectionVirtualizer>>> },\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    name: { type: String },\n    form: { type: String },\n    selection: { type: Array as PropType<string[]> },\n    defaultSelection: { type: Array as PropType<string[]> },\n    searchable: Boolean,\n    filter: { type: Function as PropType<TransferFilter> },\n    pageSize: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    oneWay: Boolean,\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<TransferProps['translations']> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸集合以支持 v-model\n  emits: {\n    'value-change': (_details: PayloadOf<TransferProps, 'onValueChange'>) => true,\n    'selection-change': (_details: PayloadOf<TransferProps, 'onSelectionChange'>) => true,\n    'update:value': (_value: PayloadOf<TransferProps, 'onValueChange'>['value']) => true,\n    'update:selection': (_value: PayloadOf<TransferProps, 'onSelectionChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TransferRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: TransferProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifySelection: TransferProps['onSelectionChange'] = (details) => {\n      emit('selection-change', details)\n      emit('update:selection', details.value)\n    }\n    const ctx = useTransfer(withXhConfig('transfer', useFormControlProps(props)) as TransferProps, {\n      onValueChange: notifyValue,\n      onSelectionChange: notifySelection,\n    })\n    provideTransfer(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [slots.default?.({\n      value: ctx.api.value.value,\n      selection: ctx.api.value.selection,\n      sourceItems: ctx.api.value.visibleItems('source'),\n      targetItems: ctx.api.value.visibleItems('target'),\n      canMove: ctx.api.value.canMove,\n      checkState: ctx.api.value.checkState,\n      isChecked: ctx.api.value.isChecked,\n      setValue: ctx.api.value.setValue,\n      setSelection: ctx.api.value.setSelection,\n      toggle: ctx.api.value.toggle,\n      toggleAll: ctx.api.value.toggleAll,\n      move: ctx.api.value.move,\n    }), ...ctx.api.value.value.map(value => h('input', {\n      ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown>,\n      key: value,\n    }))])\n  },\n})\n\n/** 生成源/目标面板共用的 setup，两侧只在 side 上不同 */\nfunction panelSetup(side: TransferSide): (props: unknown, ctx: { slots: TransferPanelSlots }) => () => VNode {\n  return (_: unknown, { slots }: { slots: TransferPanelSlots }) => {\n    const ctx = useTransferContext()\n    const panel = computed<TransferPanelProps>(() => ({ side }))\n    provideTransferPanel({ panel })\n    return () => h('div', ctx.api.value.getPanelProps(panel.value) as Record<string, unknown>, slots.default?.({\n      side,\n      // 这一侧当下看得见的条目（分侧 + 搜索之后），不是数据入口：入口叫 collection，是整份全集\n      items: ctx.api.value.visibleItems(side),\n      checkState: ctx.api.value.checkState(side),\n      query: ctx.api.value.query(side),\n      total: ctx.api.value.filteredItems(side).length,\n      page: ctx.api.value.page(side),\n      pageCount: ctx.api.value.pageCount(side),\n      setPage: (page: number) => ctx.api.value.setPage(side, page),\n    }))\n  }\n}\n\nexport const XhTransferSourcePanel = defineComponent({\n  name: 'XhTransferSourcePanel',\n  slots: Object as SlotsType<TransferPanelSlots>,\n  setup: panelSetup('source'),\n})\n\nexport const XhTransferTargetPanel = defineComponent({\n  name: 'XhTransferTargetPanel',\n  slots: Object as SlotsType<TransferPanelSlots>,\n  setup: panelSetup('target'),\n})\n\nexport const XhTransferPanelHeader = defineComponent({\n  name: 'XhTransferPanelHeader',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('div', ctx.api.value.getPanelHeaderProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferPanelTitle = defineComponent({\n  name: 'XhTransferPanelTitle',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('span', ctx.api.value.getPanelTitleProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferPanelCount = defineComponent({\n  name: 'XhTransferPanelCount',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 只带 data-checked-count / data-count 属性，文案由作者或皮肤层提供\n    return () => h('span', ctx.api.value.getPanelCountProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferSearch = defineComponent({\n  name: 'XhTransferSearch',\n  setup() {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    return () => h('input', ctx.api.value.getSearchProps(panel.value) as Record<string, unknown>)\n  },\n})\n\nexport const XhTransferList = defineComponent({\n  name: 'XhTransferList',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    const listRef = ref<HTMLElement | null>(null)\n    // 两侧定高小列表各走一路自绘条：虚拟化时滚动层改为 Virtualizer viewport，\n    // 条子仍紧跟在列表后面、贴实际滚动层自己的盒子上，\n    // 挂在 root 这个定位盒上（面板不定位，root 才是列表的定位祖先）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => ctx.service.prop('virtualizers')?.[panel.value.side]?.getViewportElement() ?? listRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 搬运、搜索筛选与空态显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getListProps(panel.value) as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { listRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhTransferSelectAllTrigger = defineComponent({\n  name: 'XhTransferSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 用原生 button，激活与禁用交给平台\n    return () => h('button', ctx.api.value.getSelectAllTriggerProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferEmpty = defineComponent({\n  name: 'XhTransferEmpty',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 空态占位：写在面板里、list 的兄弟；本侧没有可见条目时由连接层放它出面\n    return () => h('div', ctx.api.value.getEmptyProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferLoading = defineComponent({\n  name: 'XhTransferLoading',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps(panel.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferGroup = defineComponent({\n  name: 'XhTransferGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 两侧各挂一份同名分组，身份连 side 一起算，两边的标题 id 才不撞\n    const group = computed<TransferGroupProps>(() => ({ value: props.value, side: panel.value.side }))\n    provideTransferGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferGroupLabel = defineComponent({\n  name: 'XhTransferGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { group } = useTransferGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferItem = defineComponent({\n  name: 'XhTransferItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTransferContext()\n    const { panel } = useTransferPanelContext()\n    // 条目只报值与所属面板，禁用与标签回 collection 里查；同一 value 的两侧节点靠 side 分身份\n    const item = computed<TransferItemProps>(() => ({ value: props.value, side: panel.value.side }))\n    provideTransferItem({ item })\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      const side = panel.value.side\n      if (service.prop('virtualizers')?.[side] && ctx.api.value.visibleItems(side).some(item => item.value === props.value))\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', side: panel.value.side, 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: 'LIST.BLUR', side: panel.value.side })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTransferItemText = defineComponent({\n  name: 'XhTransferItemText',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhTransferItemDescription = defineComponent({\n  name: 'XhTransferItemDescription',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhTransferItemSuffix = defineComponent({\n  name: 'XhTransferItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferItemCheckbox = defineComponent({\n  name: 'XhTransferItemCheckbox',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    const { item } = useTransferItemContext()\n    return () => h('span', ctx.api.value.getItemCheckboxProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferToTargetTrigger = defineComponent({\n  name: 'XhTransferToTargetTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    // 用原生 button，激活与禁用交给平台\n    return () => h('button', ctx.api.value.getToTargetTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTransferToSourceTrigger = defineComponent({\n  name: 'XhTransferToSourceTrigger',\n  setup(_, { slots }) {\n    const ctx = useTransferContext()\n    return () => h('button', ctx.api.value.getToSourceTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

package/dist/components/tree/tree.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction } from "@xihan-ui/core";
-import { TreeApi, TreeNode, TreeSchema } from "@xihan-ui/headless";
+import { CollectionVirtualizer, TreeApi, TreeNode, TreeSchema } from "@xihan-ui/headless";
 //#region src/components/tree/tree.d.ts
 type TreeProps = TreeSchema['props'];
 /** 默认插槽的载荷：可见行序列与展开、选中、焦点状态，以及按值判定与展开、收起、选中的动作。 */
@@ -10,10 +10,17 @@ declare const XhTreeRoot: import("vue").DefineComponent<import("vue").ExtractPro
   collection: {
     type: PropType<TreeNode[]>;
   };
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */
   variant: {
     type: PropType<TreeProps["variant"]>;
   };
+  /** 尺寸：sm / md / lg，默认 md。行高、行内内衬、字号、指示符盒与层级缩进随档。 */
+  size: {
+    type: PropType<TreeProps["size"]>;
+  };
   expandedValue: {
     type: PropType<string[]>;
   };
@@ -42,6 +49,15 @@ declare const XhTreeRoot: import("vue").DefineComponent<import("vue").ExtractPro
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 正在取子节点的分支：在其中的分支报告 aria-busy，展开箭头换成转圈。 */
+  loadingValue: {
+    type: PropType<string[]>;
+  };
+  /** 连接线：父节点展开箭头的中线向下引一道竖线，每个子节点横出一段接到行首，最后一个子节点止于行中线。 */
+  lines: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   disabled: BooleanConstructor;
   loading: BooleanConstructor;
   loop: {
@@ -76,10 +92,17 @@ declare const XhTreeRoot: import("vue").DefineComponent<import("vue").ExtractPro
   collection: {
     type: PropType<TreeNode[]>;
   };
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */
   variant: {
     type: PropType<TreeProps["variant"]>;
   };
+  /** 尺寸：sm / md / lg，默认 md。行高、行内内衬、字号、指示符盒与层级缩进随档。 */
+  size: {
+    type: PropType<TreeProps["size"]>;
+  };
   expandedValue: {
     type: PropType<string[]>;
   };
@@ -108,6 +131,15 @@ declare const XhTreeRoot: import("vue").DefineComponent<import("vue").ExtractPro
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 正在取子节点的分支：在其中的分支报告 aria-busy，展开箭头换成转圈。 */
+  loadingValue: {
+    type: PropType<string[]>;
+  };
+  /** 连接线：父节点展开箭头的中线向下引一道竖线，每个子节点横出一段接到行首，最后一个子节点止于行中线。 */
+  lines: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   disabled: BooleanConstructor;
   loading: BooleanConstructor;
   loop: {
@@ -142,6 +174,7 @@ declare const XhTreeRoot: import("vue").DefineComponent<import("vue").ExtractPro
   disabled: boolean;
   loading: boolean;
   cascade: boolean;
+  lines: boolean;
   typeahead: boolean;
   nodeDraggable: boolean;
   expandOnClick: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","names":[],"sources":["../../../src/components/tree/tree.ts"],"mappings":";;;;;KAiBK,YAAY;;KAGL,oBAAoB,KAC9B;cAmCW,0BAAU,8BAAA;;IAIU,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;IACX,MAAA;;;IACO,MAAA;;;;;;;;IAGA,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;IAMrB,MAAA,SAAS;;;;;;IAID,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;EAIL,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;EACZ,qBAAA,UAAA,UAAU;EACZ,qBAAA,QAAA,UAAU;EAElB,cAAA,OAAA,UAAU;;;IA/BF,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;IACX,MAAA;;;IACO,MAAA;;;;;;;;IAGA,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;IAMrB,MAAA,SAAS;;;;;;IAID,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAY/B,WAAC,OAAO,sBAAsB;kCA6B1C;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,0BAAA,oBAAA,4BAAA;;8BAMrB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAQtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,8BAAA;;;;;;;;;;;;MAiBrB,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;;;;;;;;;;;MAkBvB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAQ9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tree.d.ts","names":[],"sources":["../../../src/components/tree/tree.ts"],"mappings":";;;;;KAiBK,YAAY;;KAGL,oBAAoB,KAC9B;cAqCW,0BAAU,8BAAA;;IAIU,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEb,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;IACD,MAAA;;;IACO,MAAA;;;IACX,MAAA;;;IACO,MAAA;;;;;;;;IAGA,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;IAGb,MAAA;;;;;;;;;;;;;;;;;;IAOR,MAAA,SAAS;;;;;;IAID,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;EAIL,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;EACZ,qBAAA,UAAA,UAAU;EACZ,qBAAA,QAAA,UAAU;EAElB,cAAA,OAAA,UAAU;;;IAtCF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEb,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;IACD,MAAA;;;IACO,MAAA;;;IACX,MAAA;;;IACO,MAAA;;;;;;;;IAGA,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;IAGb,MAAA;;;;;;;;;;;;;;;;;;IAOR,MAAA,SAAS;;;;;;IAID,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAY/B,WAAC,OAAO,sBAAsB;kCA6B1C;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,0BAAA,oBAAA,4BAAA;;8BAMrB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAQtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,8BAAA;;;;;;;;;;;;MAiBrB,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;;;;;;;;;;;MAkBvB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAQ9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/tree/tree.js

@@ -17,6 +17,7 @@ function reportNodeFocus(ctx, el, value) {
 	onBeforeUnmount(() => {
 		const { service } = ctx;
 		if (service.getStatus() !== "Started") return;
+		if (service.prop("virtualizer")) return;
 		if (el.value && service.scope.getActiveElement() === el.value) service.send({ type: "TREE.BLUR" });
 	});
 }
@@ -24,8 +25,11 @@ const XhTreeRoot = defineComponent({
 	name: "XhTreeRoot",
 	props: {
 		collection: { type: Array },
+		virtualizer: { type: Object },
 		/** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */
 		variant: { type: String },
+		/** 尺寸：sm / md / lg，默认 md。行高、行内内衬、字号、指示符盒与层级缩进随档。 */
+		size: { type: String },
 		expandedValue: { type: Array },
 		defaultExpandedValue: { type: Array },
 		selection: { type: Array },
@@ -42,6 +46,13 @@ const XhTreeRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 正在取子节点的分支：在其中的分支报告 aria-busy，展开箭头换成转圈。 */
+		loadingValue: { type: Array },
+		/** 连接线：父节点展开箭头的中线向下引一道竖线，每个子节点横出一段接到行首，最后一个子节点止于行中线。 */
+		lines: {
+			type: Boolean,
+			default: void 0
+		},
 		disabled: Boolean,
 		loading: Boolean,
 		loop: {