@xihan-ui/vue 2.0.0 → 3.0.0

package/dist/components/drawer/drawer.d.ts

@@ -58,6 +58,24 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+  resizable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+  panelSize: {
+    type: NumberConstructor;
+  };
+  defaultPanelSize: {
+    type: NumberConstructor;
+  };
+  minPanelSize: {
+    type: NumberConstructor;
+  };
+  maxPanelSize: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<DrawerProps["translations"]>;
   };
@@ -67,6 +85,8 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
   'open-change': (_details: PayloadOf<DrawerProps, "onOpenChange">) => true;
   'update:open': (_open: PayloadOf<DrawerProps, "onOpenChange">["open"]) => true;
   'exit-complete': () => true;
+  'panel-size-change': (_details: PayloadOf<DrawerProps, "onPanelSizeChange">) => true;
+  'update:panelSize': (_size: PayloadOf<DrawerProps, "onPanelSizeChange">["panelSize"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   open: {
     type: BooleanConstructor;
@@ -119,6 +139,24 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+  resizable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+  panelSize: {
+    type: NumberConstructor;
+  };
+  defaultPanelSize: {
+    type: NumberConstructor;
+  };
+  minPanelSize: {
+    type: NumberConstructor;
+  };
+  maxPanelSize: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<DrawerProps["translations"]>;
   };
@@ -126,9 +164,12 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").DrawerOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onExit-complete"?: (() => any) | undefined;
+  "onPanel-size-change"?: ((_details: import("@xihan-ui/headless").DrawerPanelSizeChangeDetails) => any) | undefined;
+  "onUpdate:panelSize"?: ((_size: number) => any) | undefined;
 }>, {
   open: boolean;
   defaultOpen: boolean;
+  resizable: boolean;
   modal: boolean;
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
@@ -169,6 +210,10 @@ declare const XhDrawerFooter: import("vue").DefineComponent<{}, () => VNode<impo
 declare const XhDrawerCloseTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */
+declare const XhDrawerResizeTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { DrawerRootSlotProps, XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
+export { DrawerRootSlotProps, XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerResizeTrigger, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
 //# sourceMappingURL=drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;IAMzB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;IAzBT,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;IAMzB,MAAA,SAAS;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;kCAkB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA6B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAazB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;EAED,sBAAA,UAAA,UAAU;EACd,qBAAA,OAAA,UAAU;;;;;;;;;;;;IAnCd,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAazB,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAW/B,WAAC,OAAO,wBAAwB;kCAsB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA6B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/drawer/drawer.js

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
-import { XhPortal } from "../../runtime/portal.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { provideDrawer, useDrawerContext } from "./context.js";
 import { useDrawer } from "./use-drawer.js";
 import { defineComponent, h, mergeProps } from "vue";
@@ -50,12 +50,24 @@ const XhDrawerRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+		resizable: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+		panelSize: { type: Number },
+		defaultPanelSize: { type: Number },
+		minPanelSize: { type: Number },
+		maxPanelSize: { type: Number },
 		translations: { type: Object }
 	},
 	emits: {
 		"open-change": (_details) => true,
 		"update:open": (_open) => true,
-		"exit-complete": () => true
+		"exit-complete": () => true,
+		"panel-size-change": (_details) => true,
+		"update:panelSize": (_size) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -63,7 +75,11 @@ const XhDrawerRoot = defineComponent({
 			emit("open-change", details);
 			emit("update:open", details.open);
 		};
-		const ctx = useDrawer(withXhConfig("drawer", props), notify, () => props.container, () => emit("exit-complete"));
+		const notifySize = (details) => {
+			emit("panel-size-change", details);
+			emit("update:panelSize", details.panelSize);
+		};
+		const ctx = useDrawer(withXhConfig("drawer", props), notify, () => props.container, () => emit("exit-complete"), notifySize);
 		provideDrawer(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			open: ctx.api.value.open,
@@ -157,7 +173,15 @@ const XhDrawerCloseTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getCloseTriggerProps(), slots.default?.());
 	}
 });
+/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */
+const XhDrawerResizeTrigger = defineComponent({
+	name: "XhDrawerResizeTrigger",
+	setup() {
+		const ctx = useDrawerContext();
+		return () => h("div", ctx.api.value.getResizeTriggerProps());
+	}
+});
 //#endregion
-export { XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
+export { XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerResizeTrigger, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
 
 //# sourceMappingURL=drawer.js.map

package/dist/components/drawer/drawer.js.map

@@ -1 +1 @@
-{"version":3,"file":"drawer.js","names":[],"sources":["../../../src/components/drawer/drawer.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// 提供 drawer 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema, DrawerSide } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideDrawer, useDrawerContext } from './context'\nimport { useDrawer } from './use-drawer'\n\ntype DrawerProps = DrawerSchema['props']\n\n/** 默认插槽的载荷：展开状态、已解析的滑出边，与开合命令。 */\nexport type DrawerRootSlotProps = Pick<DrawerApi, 'open' | 'side' | 'setOpen'>\n\nexport const XhDrawerRoot = defineComponent({\n  name: 'XhDrawerRoot',\n  props: {\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: undefined },\n    side: { type: String as PropType<DrawerSide> },\n    role: { type: String as PropType<'dialog' | 'alertdialog'> },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /**\n     * 挂载的容器（CSS 选择器或元素）。提供后即为局部抽屉：\n     * 浮层迁移进该容器，遮罩与定位层从 fixed 换为 absolute，只覆盖它而不是整屏。\n     *\n     * 该容器要自带 position（relative 等），否则 absolute 会向上找到其他定位祖先。\n     * 未提供时查询全局配置的 portalContainer，再没有才落到 body。\n     */\n    container: { type: [String, Object] as PropType<string | Element> },\n    /**\n     * 只把绘制方式改为局部（遮罩与定位层从 fixed 换为 absolute），不改变迁移位置。\n     * 提供 container 后默认为真，不必再写一遍；两个都未提供即铺满视口。\n     */\n    contained: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<DrawerProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DrawerProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DrawerProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DrawerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DrawerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    // 容器一处给定，两件事都从它派生：contained 交给机器（皮肤据此把遮罩与定位层\n    // 从 fixed 换成 absolute），同一个值又是 Teleport 的落点，两边不会各说各话\n    const ctx = useDrawer(withXhConfig('drawer', props) as DrawerProps, notify, () => props.container, () => emit('exit-complete'))\n    provideDrawer(ctx)\n    // root 是真实节点，content 会被 portal 到 body，data-side 挂在这里供页面内的部分读取\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      side: ctx.api.value.side,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhDrawerTrigger = defineComponent({\n  name: 'XhDrawerTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'drawer')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDrawerContent = defineComponent({\n  name: 'XhDrawerContent',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      // presence 判定不在场则整棵不渲染，退场动画播完才翻假\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      return h(XhPortal, { to: ctx.portalTarget.value }, () => [\n        !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !ctx.rendered.value || undefined,\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDrawerHeader = defineComponent({\n  name: 'XhDrawerHeader',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerTitle = defineComponent({\n  name: 'XhDrawerTitle',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerDescription = defineComponent({\n  name: 'XhDrawerDescription',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerBody = defineComponent({\n  name: 'XhDrawerBody',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerFooter = defineComponent({\n  name: 'XhDrawerFooter',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerCloseTrigger = defineComponent({\n  name: 'XhDrawerCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"drawer.js","names":[],"sources":["../../../src/components/drawer/drawer.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// 提供 drawer 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema, DrawerSide } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideDrawer, useDrawerContext } from './context'\nimport { useDrawer } from './use-drawer'\n\ntype DrawerProps = DrawerSchema['props']\n\n/** 默认插槽的载荷：展开状态、已解析的滑出边，与开合命令。 */\nexport type DrawerRootSlotProps = Pick<DrawerApi, 'open' | 'side' | 'setOpen'>\n\nexport const XhDrawerRoot = defineComponent({\n  name: 'XhDrawerRoot',\n  props: {\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: undefined },\n    side: { type: String as PropType<DrawerSide> },\n    role: { type: String as PropType<'dialog' | 'alertdialog'> },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /**\n     * 挂载的容器（CSS 选择器或元素）。提供后即为局部抽屉：\n     * 浮层迁移进该容器，遮罩与定位层从 fixed 换为 absolute，只覆盖它而不是整屏。\n     *\n     * 该容器要自带 position（relative 等），否则 absolute 会向上找到其他定位祖先。\n     * 未提供时查询全局配置的 portalContainer，再没有才落到 body。\n     */\n    container: { type: [String, Object] as PropType<string | Element> },\n    /**\n     * 只把绘制方式改为局部（遮罩与定位层从 fixed 换为 absolute），不改变迁移位置。\n     * 提供 container 后默认为真，不必再写一遍；两个都未提供即铺满视口。\n     */\n    contained: { type: Boolean, default: undefined },\n    /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */\n    resizable: { type: Boolean, default: undefined },\n    /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */\n    panelSize: { type: Number },\n    defaultPanelSize: { type: Number },\n    minPanelSize: { type: Number },\n    maxPanelSize: { type: Number },\n    translations: { type: Object as PropType<DrawerProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔；panel-size-change 携带 { panelSize }\n  emits: {\n    'open-change': (_details: PayloadOf<DrawerProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DrawerProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n    'panel-size-change': (_details: PayloadOf<DrawerProps, 'onPanelSizeChange'>) => true,\n    'update:panelSize': (_size: PayloadOf<DrawerProps, 'onPanelSizeChange'>['panelSize']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DrawerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DrawerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    // 容器一处给定，两件事都从它派生：contained 交给机器（皮肤据此把遮罩与定位层\n    // 从 fixed 换成 absolute），同一个值又是 Teleport 的落点，两边不会各说各话\n    const notifySize: DrawerProps['onPanelSizeChange'] = (details) => {\n      emit('panel-size-change', details)\n      emit('update:panelSize', details.panelSize)\n    }\n    const ctx = useDrawer(withXhConfig('drawer', props) as DrawerProps, notify, () => props.container, () => emit('exit-complete'), notifySize)\n    provideDrawer(ctx)\n    // root 是真实节点，content 会被 portal 到 body，data-side 挂在这里供页面内的部分读取\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      side: ctx.api.value.side,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhDrawerTrigger = defineComponent({\n  name: 'XhDrawerTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'drawer')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDrawerContent = defineComponent({\n  name: 'XhDrawerContent',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      // presence 判定不在场则整棵不渲染，退场动画播完才翻假\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      return h(XhPortal, { to: ctx.portalTarget.value }, () => [\n        !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !ctx.rendered.value || undefined,\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDrawerHeader = defineComponent({\n  name: 'XhDrawerHeader',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerTitle = defineComponent({\n  name: 'XhDrawerTitle',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerDescription = defineComponent({\n  name: 'XhDrawerDescription',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerBody = defineComponent({\n  name: 'XhDrawerBody',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerFooter = defineComponent({\n  name: 'XhDrawerFooter',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerCloseTrigger = defineComponent({\n  name: 'XhDrawerCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */\nexport const XhDrawerResizeTrigger = defineComponent({\n  name: 'XhDrawerResizeTrigger',\n  setup() {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getResizeTriggerProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -11,7 +11,7 @@ interface DrawerContext {
   /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useDrawer(props: DrawerSchema['props'], onOpenChange?: DrawerSchema['props']['onOpenChange'], container?: () => string | Element | null | undefined, onExitComplete?: DrawerSchema['props']['onExitComplete']): DrawerContext;
+declare function useDrawer(props: DrawerSchema['props'], onOpenChange?: DrawerSchema['props']['onOpenChange'], container?: () => string | Element | null | undefined, onExitComplete?: DrawerSchema['props']['onExitComplete'], onPanelSizeChange?: DrawerSchema['props']['onPanelSizeChange']): DrawerContext;
 //#endregion
 export { DrawerContext, useDrawer };
 //# sourceMappingURL=use-drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-drawer.d.ts","names":[],"sources":["../../../src/components/drawer/use-drawer.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;EAEjB,cAAc,qBAAqB;;iBAGrB,UACd,OAAO,uBACP,eAAe,uCACf,2BAA2B,4BAC3B,iBAAiB,0CAChB"}
+{"version":3,"file":"use-drawer.d.ts","names":[],"sources":["../../../src/components/drawer/use-drawer.ts"],"mappings":";;;;UAmBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;EAEjB,cAAc,qBAAqB;;iBAGrB,UACd,OAAO,uBACP,eAAe,uCACf,2BAA2B,4BAC3B,iBAAiB,yCACjB,oBAAoB,6CACnB"}

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

@@ -1,13 +1,13 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed, onBeforeUnmount, ref, watch } from "vue";
-import { attachCssExit, createPresence } from "@xihan-ui/core/presence";
+import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectDrawer, drawerMachine } from "@xihan-ui/headless";
 //#region src/components/drawer/use-drawer.ts
-function useDrawer(props, onOpenChange, container, onExitComplete) {
+function useDrawer(props, onOpenChange, container, onExitComplete, onPanelSizeChange) {
 	const xhConfig = useXhConfig();
 	const contentRef = ref(null);
 	const backdropRef = ref(null);
@@ -17,9 +17,9 @@ function useDrawer(props, onOpenChange, container, onExitComplete) {
 		...props,
 		contained: props.contained ?? container?.() != null,
 		onOpenChange,
-		onExitComplete
+		onExitComplete,
+		onPanelSizeChange
 	}), scope);
-	const rendered = ref(service.state.get() === "open");
 	let config = null;
 	if (typeof document !== "undefined") {
 		config = createRuntimeConfig({
@@ -34,36 +34,19 @@ function useDrawer(props, onOpenChange, container, onExitComplete) {
 			isModal: () => props.modal ?? true,
 			surfaces: () => [backdropRef.value].filter(Boolean)
 		});
-		const presence = createPresence({
-			config,
-			open: service.state.get() === "open",
-			onRenderedChange: (r) => {
-				rendered.value = r;
-			}
-		});
-		rendered.value = presence.rendered;
 		service.refs.set("config", config);
 		service.refs.set("registerLayer", registerLayer);
-		service.refs.set("presence", presence);
 		service.refs.set("getContentEl", () => contentRef.value);
 		service.refs.set("getTriggerEl", () => null);
 		service.refs.set("branches", () => []);
-		watch(() => service.state.get() === "open", (open) => presence.update(open), { flush: "post" });
-		const tracked = /* @__PURE__ */ new Map();
-		watch([contentRef, backdropRef], (nodes) => {
-			const next = new Set(nodes.filter((node) => node !== null));
-			for (const node of next) if (!tracked.has(node)) tracked.set(node, attachCssExit(node, presence));
-			for (const [node, detach] of tracked) if (!next.has(node)) {
-				tracked.delete(node);
-				detach();
-			}
-		}, { flush: "post" });
-		onBeforeUnmount(() => {
-			presence.dispose();
-			for (const detach of tracked.values()) detach();
-			tracked.clear();
-		});
 	}
+	const rendered = useOverlayExit({
+		config,
+		isOpen: () => service.state.get() === "open",
+		contentRef,
+		additionalExitRefs: [backdropRef],
+		onPresence: (presence) => service.refs.set("presence", presence)
+	});
 	return {
 		service,
 		api: computed(() => connectDrawer(service, vueNormalize)),

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

@@ -1 +1 @@
-{"version":3,"file":"use-drawer.js","names":[],"sources":["../../../src/components/drawer/use-drawer.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 drawer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { DrawerApi, DrawerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { attachCssExit, createPresence } from '@xihan-ui/core/presence'\nimport { connectDrawer, drawerMachine } from '@xihan-ui/headless'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DrawerContext {\n  service: Service<DrawerSchema>\n  api: ComputedRef<DrawerApi>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n  /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useDrawer(\n  props: DrawerSchema['props'],\n  onOpenChange?: DrawerSchema['props']['onOpenChange'],\n  container?: () => string | Element | null | undefined,\n  onExitComplete?: DrawerSchema['props']['onExitComplete'],\n): DrawerContext {\n  // 应用级默认挂载点：core 的 RuntimeConfig 一直留着这个字段，这里把它真正接上\n  const xhConfig = useXhConfig()\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // contained 由 container 派生,在 getter 里算:在 setup 期展开 props 会把响应式冻住,\n  // 之后改 side / open 这些都推不动了\n  const service = useMachine(\n    drawerMachine,\n    // 显式写了 contained 以它为准；没写则「给了容器即局部」\n    () => ({ ...props, contained: props.contained ?? container?.() != null, onOpenChange, onExitComplete }),\n    scope,\n  )\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    const presence: PresenceHandle = createPresence({\n      config: config!,\n      open: service.state.get() === 'open',\n      onRenderedChange: (r) => {\n        rendered.value = r\n      },\n    })\n    rendered.value = presence.rendered\n\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('presence', presence)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // content 就位后把它的 CSS 退场动画接到 presence 退出租约，无动画时关闭即卸载\n    const tracked = new Map<HTMLElement, Cleanup>()\n    watch([contentRef, backdropRef], (nodes) => {\n      const next = new Set(nodes.filter((node): node is HTMLElement => node !== null))\n      for (const node of next) {\n        if (!tracked.has(node))\n          tracked.set(node, attachCssExit(node, presence))\n      }\n      for (const [node, detach] of tracked) {\n        if (!next.has(node)) {\n          tracked.delete(node)\n          detach()\n        }\n      }\n    }, { flush: 'post' })\n\n    onBeforeUnmount(() => {\n      presence.dispose()\n      for (const detach of tracked.values()) detach()\n      tracked.clear()\n    })\n  }\n\n  const api = computed(() => connectDrawer(service, vueNormalize))\n  // 实例给的容器优先；没给就问全局配置；都没有才落单一落点\n  const portalTarget = computed<string | Element>(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,UACd,OACA,cACA,WACA,gBACe;CAEf,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,UAAU,WACd,sBAEO;EAAE,GAAG;EAAO,WAAW,MAAM,aAAa,YAAY,KAAK;EAAM;EAAc;CAAe,IACrG,KACF;CAIA,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,MAAM,WAA2B,eAAe;GACtC;GACR,MAAM,QAAQ,MAAM,IAAI,MAAM;GAC9B,mBAAmB,MAAM;IACvB,SAAS,QAAQ;GACnB;EACF,CAAC;EACD,SAAS,QAAQ,SAAS;EAE1B,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,QAAQ;EACrC,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;EAGrC,YAAY,QAAQ,MAAM,IAAI,MAAM,SAAQ,SAAQ,SAAS,OAAO,IAAI,GAAG,EAAE,OAAO,OAAO,CAAC;EAG5F,MAAM,0BAAU,IAAI,IAA0B;EAC9C,MAAM,CAAC,YAAY,WAAW,IAAI,UAAU;GAC1C,MAAM,OAAO,IAAI,IAAI,MAAM,QAAQ,SAA8B,SAAS,IAAI,CAAC;GAC/E,KAAK,MAAM,QAAQ,MACjB,IAAI,CAAC,QAAQ,IAAI,IAAI,GACnB,QAAQ,IAAI,MAAM,cAAc,MAAM,QAAQ,CAAC;GAEnD,KAAK,MAAM,CAAC,MAAM,WAAW,SAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG;IACnB,QAAQ,OAAO,IAAI;IACnB,OAAO;GACT;EAEJ,GAAG,EAAE,OAAO,OAAO,CAAC;EAEpB,sBAAsB;GACpB,SAAS,QAAQ;GACjB,KAAK,MAAM,UAAU,QAAQ,OAAO,GAAG,OAAO;GAC9C,QAAQ,MAAM;EAChB,CAAC;CACH;CAMA,OAAO;EAAE;EAAS,KAJN,eAAe,cAAc,SAAS,YAAY,CAI1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,YAAY,KAAK,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAErE;CAAE;AACzE"}
+{"version":3,"file":"use-drawer.js","names":[],"sources":["../../../src/components/drawer/use-drawer.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 drawer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectDrawer, drawerMachine } from '@xihan-ui/headless'\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 DrawerContext {\n  service: Service<DrawerSchema>\n  api: ComputedRef<DrawerApi>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n  /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useDrawer(\n  props: DrawerSchema['props'],\n  onOpenChange?: DrawerSchema['props']['onOpenChange'],\n  container?: () => string | Element | null | undefined,\n  onExitComplete?: DrawerSchema['props']['onExitComplete'],\n  onPanelSizeChange?: DrawerSchema['props']['onPanelSizeChange'],\n): DrawerContext {\n  // 应用级默认挂载点：core 的 RuntimeConfig 一直留着这个字段，这里把它真正接上\n  const xhConfig = useXhConfig()\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // contained 由 container 派生,在 getter 里算:在 setup 期展开 props 会把响应式冻住,\n  // 之后改 side / open 这些都推不动了\n  const service = useMachine(\n    drawerMachine,\n    // 显式写了 contained 以它为准；没写则「给了容器即局部」\n    () => ({ ...props, contained: props.contained ?? container?.() != null, onOpenChange, onExitComplete, onPanelSizeChange }),\n    scope,\n  )\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n  }\n\n  // 内容与遮罩的退场动画共同决定何时收起；服务端没有 DOM，可见与否跟着展开态走\n  const rendered = useOverlayExit({\n    config,\n    isOpen: () => service.state.get() === 'open',\n    contentRef,\n    additionalExitRefs: [backdropRef],\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n\n  const api = computed(() => connectDrawer(service, vueNormalize))\n  // 实例给的容器优先；没给就问全局配置；都没有才落单一落点\n  const portalTarget = computed<string | Element>(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA6BA,SAAgB,UACd,OACA,cACA,WACA,gBACA,mBACe;CAEf,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,UAAU,WACd,sBAEO;EAAE,GAAG;EAAO,WAAW,MAAM,aAAa,YAAY,KAAK;EAAM;EAAc;EAAgB;CAAkB,IACxH,KACF;CAEA,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;CACvC;CAGA,MAAM,WAAW,eAAe;EAC9B;EACA,cAAc,QAAQ,MAAM,IAAI,MAAM;EACtC;EACA,oBAAoB,CAAC,WAAW;EAChC,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAMD,OAAO;EAAE;EAAS,KAJN,eAAe,cAAc,SAAS,YAAY,CAI1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,YAAY,KAAK,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAErE;CAAE;AACzE"}

package/dist/components/empty-state/empty-state.js

@@ -15,7 +15,10 @@ const XhEmptyStateRoot = defineComponent({
 	setup(props, { slots }) {
 		const ctx = useEmptyState(withXhConfig("empty-state", props));
 		provideEmptyState(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.());
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.());
 	}
 });
 const XhEmptyStateMedia = defineComponent({

package/dist/components/empty-state/empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.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// 提供 empty state 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { EmptyStateLive, EmptyStateProps, EmptyStateStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'> },\n    live: { type: String as PropType<EmptyStateLive> },\n    status: { type: String as PropType<EmptyStateStatus> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 插画槽，内容由作者塞（img、内联 svg 都行）；与图标槽二选一\nexport const XhEmptyStateMedia = defineComponent({\n  name: 'XhEmptyStateMedia',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getMediaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIndicator = defineComponent({\n  name: 'XhEmptyStateIndicator',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAuC;EACrD,MAAM,EAAE,MAAM,OAAmC;EACjD,QAAQ,EAAE,MAAM,OAAqC;EACrD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.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// 提供 empty state 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { EmptyStateLive, EmptyStateProps, EmptyStateStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'> },\n    live: { type: String as PropType<EmptyStateLive> },\n    status: { type: String as PropType<EmptyStateStatus> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.())\n  },\n})\n\n// 插画槽，内容由作者塞（img、内联 svg 都行）；与图标槽二选一\nexport const XhEmptyStateMedia = defineComponent({\n  name: 'XhEmptyStateMedia',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getMediaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIndicator = defineComponent({\n  name: 'XhEmptyStateIndicator',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAuC;EACrD,MAAM,EAAE,MAAM,OAAmC;EACjD,QAAQ,EAAE,MAAM,OAAqC;EACrD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;GAA8B,KAAK,IAAI;EAAQ,GAAG,MAAM,UAAU,CAAC;CAC3H;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}

package/dist/components/empty-state/use-empty-state.js

@@ -1,9 +1,18 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { computed } from "vue";
-import { connectEmptyState } from "@xihan-ui/headless";
+import { useMachine } from "../../runtime/use-machine.js";
+import { isHydratingSetup } from "../../runtime/hydration.js";
+import { computed, shallowRef } from "vue";
+import { connectEmptyState, emptyStateMachine } from "@xihan-ui/headless";
 //#region src/components/empty-state/use-empty-state.ts
 function useEmptyState(props) {
-	return { api: computed(() => connectEmptyState(props, vueNormalize)) };
+	const rootRef = shallowRef(null);
+	const service = useMachine(emptyStateMachine, () => props);
+	service.refs.set("getRootEl", () => rootRef.value);
+	service.refs.set("adopted", isHydratingSetup());
+	return {
+		api: computed(() => connectEmptyState(service, vueNormalize)),
+		rootRef
+	};
 }
 //#endregion
 export { useEmptyState };

package/dist/components/empty-state/use-empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.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 empty state 相关实现。\n\nimport type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectEmptyState } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n}\n\n// EmptyState 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const api = computed(() => connectEmptyState(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAkBA,SAAgB,cAAc,OAA2C;CAEvE,OAAO,EAAE,KADG,eAAe,kBAAkB,OAAO,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.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 empty state 相关实现。\n\nimport type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef, ShallowRef } from 'vue'\nimport { connectEmptyState, emptyStateMachine } from '@xihan-ui/headless'\nimport { computed, shallowRef } from 'vue'\nimport { isHydratingSetup } from '../../runtime/hydration'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n  /** 根节点：开幕播不播按它出现与否判断。 */\n  rootRef: ShallowRef<HTMLElement | null>\n}\n\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const rootRef = shallowRef<HTMLElement | null>(null)\n  const service = useMachine(emptyStateMachine, () => props)\n  // 机器在挂载时起跑，出现追踪那时才取根节点\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('adopted', isHydratingSetup())\n  const api = computed(() => connectEmptyState(service, vueNormalize))\n  return { api, rootRef }\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,cAAc,OAA2C;CACvE,MAAM,UAAU,WAA+B,IAAI;CACnD,MAAM,UAAU,WAAW,yBAAyB,KAAK;CAEzD,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,WAAW,iBAAiB,CAAC;CAE9C,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}

package/dist/components/field/field.js

@@ -1,5 +1,5 @@
-import { provideField, useFieldContext } from "./context.js";
 import { isRoleMarker, mergeIntoChild } from "../../runtime/as-child.js";
+import { provideField, useFieldContext } from "./context.js";
 import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useField } from "./use-field.js";

package/dist/components/field-array/field-array.d.ts

@@ -4,7 +4,7 @@ import { FieldArrayApi, FieldArraySchema, FieldArrayTranslations, FormPath } fro
 //#region src/components/field-array/field-array.d.ts
 type FieldArrayProps = FieldArraySchema['props'];
 /** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */
-type FieldArrayRootSlotProps = Pick<FieldArrayApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
+type FieldArrayRootSlotProps = Pick<FieldArrayApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'insert' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
 declare const XhFieldArrayRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown[]>;

package/dist/components/field-array/field-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-array.d.ts","names":[],"sources":["../../../src/components/field-array/field-array.ts"],"mappings":";;;;KAiBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAgBW,gCAAgB,8BAAA;;IAKD,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,4BAA4B;kCA2BhD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAQrC,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAOxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"field-array.d.ts","names":[],"sources":["../../../src/components/field-array/field-array.ts"],"mappings":";;;;KAiBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAiBW,gCAAgB,8BAAA;;IAKD,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,4BAA4B;kCA4BhD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAQrC,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAOxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field-array/field-array.js

@@ -42,7 +42,10 @@ const XhFieldArrayRoot = defineComponent({
 		};
 		const ctx = useFieldArray(withXhConfig("field-array", useFormControlProps(props)), { onValueChange }, form?.service);
 		provideFieldArray(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.({
 			items: ctx.api.value.items,
 			value: ctx.api.value.value,
 			count: ctx.api.value.count,
@@ -52,6 +55,7 @@ const XhFieldArrayRoot = defineComponent({
 			canAdd: ctx.api.value.canAdd,
 			setValue: ctx.api.value.setValue,
 			add: ctx.api.value.add,
+			insert: ctx.api.value.insert,
 			remove: ctx.api.value.remove,
 			move: ctx.api.value.move,
 			moveUp: ctx.api.value.moveUp,

package/dist/components/field-array/field-array.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-array.js","names":[],"sources":["../../../src/components/field-array/field-array.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// 提供 field array 相关实现。\n\nimport type { FieldArrayApi, FieldArrayItemProps, FieldArraySchema, FieldArrayTranslations, FormPath } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useOptionalFormContext } from '../form/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext } from './context'\nimport { useFieldArray } from './use-field-array'\n\ntype FieldArrayProps = FieldArraySchema['props']\n\n/** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */\nexport type FieldArrayRootSlotProps = Pick<\n  FieldArrayApi,\n  | 'items'\n  | 'value'\n  | 'count'\n  | 'empty'\n  | 'atMin'\n  | 'atMax'\n  | 'canAdd'\n  | 'setValue'\n  | 'add'\n  | 'remove'\n  | 'move'\n  | 'moveUp'\n  | 'moveDown'\n>\n\nexport const XhFieldArrayRoot = defineComponent({\n  name: 'XhFieldArrayRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<unknown[]> },\n    defaultValue: { type: Array as PropType<unknown[]> },\n    min: { type: Number },\n    max: { type: Number },\n    createItem: { type: Function as PropType<() => unknown> },\n    movable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: [String, Array] as PropType<FormPath> },\n    translations: { type: Object as PropType<Partial<FieldArrayTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<FieldArrayProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<FieldArrayProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FieldArrayRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const form = useOptionalFormContext()\n    const onValueChange: FieldArrayProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useFieldArray(withXhConfig('field-array', useFormControlProps(props)) as FieldArrayProps, { onValueChange }, form?.service)\n    provideFieldArray(ctx)\n    // items 里每一项都带 key，作者铺行时直接 :key=\"row.key\"\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      items: ctx.api.value.items,\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      empty: ctx.api.value.empty,\n      atMin: ctx.api.value.atMin,\n      atMax: ctx.api.value.atMax,\n      canAdd: ctx.api.value.canAdd,\n      setValue: ctx.api.value.setValue,\n      add: ctx.api.value.add,\n      remove: ctx.api.value.remove,\n      move: ctx.api.value.move,\n      moveUp: ctx.api.value.moveUp,\n      moveDown: ctx.api.value.moveDown,\n    }))\n  },\n})\n\nexport const XhFieldArrayItem = defineComponent({\n  name: 'XhFieldArrayItem',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useFieldArrayContext()\n    const item = computed<FieldArrayItemProps>(() => ({ index: Math.trunc(Number(props.index)) }))\n    provideFieldArrayItem({ item })\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行前的行号或名目；纯标注，不与行内的控件建立 for 关联。 */\nexport const XhFieldArrayItemLabel = defineComponent({\n  name: 'XhFieldArrayItemLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('span', ctx.api.value.getItemLabelProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemContent = defineComponent({\n  name: 'XhFieldArrayItemContent',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemContentProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemAction = defineComponent({\n  name: 'XhFieldArrayItemAction',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemActionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayAddTrigger = defineComponent({\n  name: 'XhFieldArrayAddTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    return () => h('button', ctx.api.value.getAddTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemDeleteTrigger = defineComponent({\n  name: 'XhFieldArrayItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveUpTrigger = defineComponent({\n  name: 'XhFieldArrayMoveUpTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveUpTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveDownTrigger = defineComponent({\n  name: 'XhFieldArrayMoveDownTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveDownTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"field-array.js","names":[],"sources":["../../../src/components/field-array/field-array.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// 提供 field array 相关实现。\n\nimport type { FieldArrayApi, FieldArrayItemProps, FieldArraySchema, FieldArrayTranslations, FormPath } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useOptionalFormContext } from '../form/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext } from './context'\nimport { useFieldArray } from './use-field-array'\n\ntype FieldArrayProps = FieldArraySchema['props']\n\n/** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */\nexport type FieldArrayRootSlotProps = Pick<\n  FieldArrayApi,\n  | 'items'\n  | 'value'\n  | 'count'\n  | 'empty'\n  | 'atMin'\n  | 'atMax'\n  | 'canAdd'\n  | 'setValue'\n  | 'add'\n  | 'insert'\n  | 'remove'\n  | 'move'\n  | 'moveUp'\n  | 'moveDown'\n>\n\nexport const XhFieldArrayRoot = defineComponent({\n  name: 'XhFieldArrayRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<unknown[]> },\n    defaultValue: { type: Array as PropType<unknown[]> },\n    min: { type: Number },\n    max: { type: Number },\n    createItem: { type: Function as PropType<() => unknown> },\n    movable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: [String, Array] as PropType<FormPath> },\n    translations: { type: Object as PropType<Partial<FieldArrayTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<FieldArrayProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<FieldArrayProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FieldArrayRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const form = useOptionalFormContext()\n    const onValueChange: FieldArrayProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useFieldArray(withXhConfig('field-array', useFormControlProps(props)) as FieldArrayProps, { onValueChange }, form?.service)\n    provideFieldArray(ctx)\n    // items 里每一项都带 key，作者铺行时直接 :key=\"row.key\"\n    return () => h('div', { ...(ctx.api.value.getRootProps() as Record<string, unknown>), ref: ctx.rootRef }, slots.default?.({\n      items: ctx.api.value.items,\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      empty: ctx.api.value.empty,\n      atMin: ctx.api.value.atMin,\n      atMax: ctx.api.value.atMax,\n      canAdd: ctx.api.value.canAdd,\n      setValue: ctx.api.value.setValue,\n      add: ctx.api.value.add,\n      insert: ctx.api.value.insert,\n      remove: ctx.api.value.remove,\n      move: ctx.api.value.move,\n      moveUp: ctx.api.value.moveUp,\n      moveDown: ctx.api.value.moveDown,\n    }))\n  },\n})\n\nexport const XhFieldArrayItem = defineComponent({\n  name: 'XhFieldArrayItem',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useFieldArrayContext()\n    const item = computed<FieldArrayItemProps>(() => ({ index: Math.trunc(Number(props.index)) }))\n    provideFieldArrayItem({ item })\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行前的行号或名目；纯标注，不与行内的控件建立 for 关联。 */\nexport const XhFieldArrayItemLabel = defineComponent({\n  name: 'XhFieldArrayItemLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('span', ctx.api.value.getItemLabelProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemContent = defineComponent({\n  name: 'XhFieldArrayItemContent',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemContentProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemAction = defineComponent({\n  name: 'XhFieldArrayItemAction',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemActionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayAddTrigger = defineComponent({\n  name: 'XhFieldArrayAddTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    return () => h('button', ctx.api.value.getAddTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemDeleteTrigger = defineComponent({\n  name: 'XhFieldArrayItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveUpTrigger = defineComponent({\n  name: 'XhFieldArrayMoveUpTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveUpTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveDownTrigger = defineComponent({\n  name: 'XhFieldArrayMoveDownTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveDownTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

package/dist/components/field-array/use-field-array.d.ts

@@ -1,10 +1,12 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
 import { FieldArrayApi, FieldArraySchema, FormSchema } from "@xihan-ui/headless";
 //#region src/components/field-array/use-field-array.d.ts
 interface FieldArrayContext {
   api: ComputedRef<FieldArrayApi>;
   service: Service<FieldArraySchema>;
+  /** 行所在的根节点：列表动效接在它上面。 */
+  rootRef: Ref<HTMLElement | null>;
 }
 declare function useFieldArray(props: FieldArraySchema['props'], handlers?: Pick<FieldArraySchema['props'], 'onValueChange'>, form?: Service<FormSchema> | null): FieldArrayContext;
 //#endregion

package/dist/components/field-array/use-field-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-array.d.ts","names":[],"sources":["../../../src/components/field-array/use-field-array.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;iBAGH,cACd,OAAO,2BACP,WAAU,KAAK,6CACf,OAAO,QAAQ,qBACd"}
+{"version":3,"file":"use-field-array.d.ts","names":[],"sources":["../../../src/components/field-array/use-field-array.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAGC,cACd,OAAO,2BACP,WAAU,KAAK,6CACf,OAAO,QAAQ,qBACd"}

package/dist/components/field-array/use-field-array.js

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
+import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
 import { connectFieldArray, fieldArrayMachine } from "@xihan-ui/headless";
 //#region src/components/field-array/use-field-array.ts
@@ -11,9 +11,12 @@ function useFieldArray(props, handlers = {}, form) {
 		...handlers
 	}), createScope(null, createVueIdGenerator()));
 	service.refs.set("form", form ?? null);
+	const rootRef = ref(null);
+	service.refs.set("getRootEl", () => rootRef.value);
 	return {
 		api: computed(() => connectFieldArray(service, vueNormalize)),
-		service
+		service,
+		rootRef
 	};
 }
 //#endregion

package/dist/components/field-array/use-field-array.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-array.js","names":[],"sources":["../../../src/components/field-array/use-field-array.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 field array 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { FieldArrayApi, FieldArraySchema, FormSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldArray, fieldArrayMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldArrayContext {\n  api: ComputedRef<FieldArrayApi>\n  service: Service<FieldArraySchema>\n}\n\nexport function useFieldArray(\n  props: FieldArraySchema['props'],\n  handlers: Pick<FieldArraySchema['props'], 'onValueChange'> = {},\n  form?: Service<FormSchema> | null,\n): FieldArrayContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fieldArrayMachine, () => ({ ...props, ...handlers }), scope)\n  service.refs.set('form', form ?? null)\n  const api = computed(() => connectFieldArray(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,cACd,OACA,WAA6D,CAAC,GAC9D,MACmB;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CACtF,QAAQ,KAAK,IAAI,QAAQ,QAAQ,IAAI;CAErC,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-field-array.js","names":[],"sources":["../../../src/components/field-array/use-field-array.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 field array 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { FieldArrayApi, FieldArraySchema, FormSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldArray, fieldArrayMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldArrayContext {\n  api: ComputedRef<FieldArrayApi>\n  service: Service<FieldArraySchema>\n  /** 行所在的根节点：列表动效接在它上面。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\nexport function useFieldArray(\n  props: FieldArraySchema['props'],\n  handlers: Pick<FieldArraySchema['props'], 'onValueChange'> = {},\n  form?: Service<FormSchema> | null,\n): FieldArrayContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fieldArrayMachine, () => ({ ...props, ...handlers }), scope)\n  service.refs.set('form', form ?? null)\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n  const api = computed(() => connectFieldArray(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,cACd,OACA,WAA6D,CAAC,GAC9D,MACmB;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CACtF,QAAQ,KAAK,IAAI,QAAQ,QAAQ,IAAI;CACrC,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;EAAS;CAAQ;AACjC"}