@xihan-ui/vue 4.2.0 → 5.0.0

package/dist/components/diff-view/diff-view.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { DiffChange, DiffModel, DiffViewApi, DiffViewCommentRequestDetails, DiffViewLineRef, DiffViewMode, DiffViewSchema, DiffViewTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { DiffChange, DiffModel, DiffViewApi, DiffViewCommentRequestDetails, DiffViewLineRef, DiffViewMode, DiffViewSchema, DiffViewTranslations } from "@xihan-ui/headless";
 //#region src/components/diff-view/diff-view.d.ts
 type Props = DiffViewSchema['props'];
 /** 默认插槽的载荷：可见行序、增删统计与展开集合。 */

package/dist/components/diff-view/diff-view.js

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideDiffView, useDiffViewContext } from "./context.js";
 import { useDiffView } from "./use-diff-view.js";
-import { defineComponent, h, onBeforeUnmount, onMounted } from "vue";
 import { diffViewSides } from "@xihan-ui/headless";
+import { defineComponent, h, onBeforeUnmount, onMounted } from "vue";
 //#region src/components/diff-view/diff-view.ts
 const XhDiffViewRoot = defineComponent({
 	name: "XhDiffViewRoot",

package/dist/components/diff-view/use-diff-view.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { DiffViewApi, DiffViewSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/diff-view/use-diff-view.d.ts
 type Props = DiffViewSchema['props'];
 interface DiffViewContext {

package/dist/components/diff-view/use-diff-view.js

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectDiffView, diffViewMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectDiffView, diffViewMachine } from "@xihan-ui/headless";
 //#region src/components/diff-view/use-diff-view.ts
 function useDiffView(props, onExpandedValueChange, onCommentRequest) {
 	const scope = createScope(null, createVueIdGenerator());

package/dist/components/download-trigger/download-trigger.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { DownloadTriggerApi, DownloadTriggerData, DownloadTriggerSchema, DownloadTriggerTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ActionVariant, Size, Tone } from "@xihan-ui/core";
-import { DownloadTriggerApi, DownloadTriggerData, DownloadTriggerSchema, DownloadTriggerTranslations } from "@xihan-ui/headless";
 //#region src/components/download-trigger/download-trigger.d.ts
 type DownloadTriggerProps = DownloadTriggerSchema['props'];
 /** 默认插槽的载荷：下载状态与禁用、本次会写出的文件名，以及执行一次下载的句柄。 */

package/dist/components/download-trigger/use-download-trigger.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { DownloadTriggerApi, DownloadTriggerSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/download-trigger/use-download-trigger.d.ts
 interface DownloadTriggerContext {
   api: ComputedRef<DownloadTriggerApi>;

package/dist/components/download-trigger/use-download-trigger.js

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { connectDownloadTrigger, downloadTriggerMachine } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/download-trigger/use-download-trigger.ts
 function useDownloadTrigger(props, callbacks = {}) {
 	const service = useMachine(downloadTriggerMachine, () => ({

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { DrawerApi, DrawerSchema, DrawerSide } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { OverlayBackdropVariant, Size } from "@xihan-ui/core";
-import { DrawerApi, DrawerSchema, DrawerSide } from "@xihan-ui/headless";
 //#region src/components/drawer/drawer.d.ts
 type DrawerProps = DrawerSchema['props'];
 /** 默认插槽的载荷：展开状态、已解析的滑出边，与开合命令。 */

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

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAoBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAezB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;EAED,sBAAA,UAAA,UAAU;EACd,qBAAA,OAAA,UAAU;;;;;;;;;;;;IArCd,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAezB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAW/B,WAAC,OAAO,wBAAwB;kCAsB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA+B1B,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"}
+{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAqBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAezB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;EAED,sBAAA,UAAA,UAAU;EACd,qBAAA,OAAA,UAAU;;;;;;;;;;;;IArCd,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAezB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAW/B,WAAC,OAAO,wBAAwB;kCAsB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA+B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAQ9B,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,5 +1,6 @@
 import { OVERLAY_STOWED_PROPS } from "../../runtime/use-overlay-exit.js";
 import { withXhConfig } from "../../config/config.js";
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { XhPortal } from "../../runtime/portal.js";
@@ -152,6 +153,7 @@ const XhDrawerTitle = defineComponent({
 	name: "XhDrawerTitle",
 	setup(_, { slots }) {
 		const ctx = useDrawerContext();
+		useTitleDescriptionPart(ctx.presence, "title");
 		return () => h("h2", ctx.api.value.getTitleProps(), slots.default?.());
 	}
 });
@@ -159,7 +161,11 @@ const XhDrawerDescription = defineComponent({
 	name: "XhDrawerDescription",
 	setup(_, { slots }) {
 		const ctx = useDrawerContext();
-		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.());
+		const el = useDescriptionPart(ctx.presence);
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: el
+		}, slots.default?.());
 	}
 });
 const XhDrawerBody = defineComponent({

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 { OVERLAY_STOWED_PROPS } from '../../runtime/use-overlay-exit'\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    /** 收起动画播完后卸载内容，默认 true；false 时第一次打开才挂载、此后收起只隐藏，再打开不重挂。 */\n    unmountOnExit: { type: Boolean, default: undefined },\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      const api = ctx.api.value\n      // presence 判定不在场即退场动画播完；没打开过、或播完且要卸载时整棵不渲染\n      const shown = ctx.rendered.value\n      if (!api.isContentMounted(shown))\n        return null\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      // 收起后常驻（unmountOnExit 为 false）：遮罩不留，定位层以内联 display 收起，视觉桥随之断开\n      return h(XhPortal, { to: ctx.portalTarget.value, present: shown }, () => [\n        shown && !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', mergeProps(api.getPositionerProps() as Record<string, unknown>, shown ? {} : OVERLAY_STOWED_PROPS), [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !shown || 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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"}
+{"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 { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\nimport { OVERLAY_STOWED_PROPS } from '../../runtime/use-overlay-exit'\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    /** 收起动画播完后卸载内容，默认 true；false 时第一次打开才挂载、此后收起只隐藏，再打开不重挂。 */\n    unmountOnExit: { type: Boolean, default: undefined },\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      const api = ctx.api.value\n      // presence 判定不在场即退场动画播完；没打开过、或播完且要卸载时整棵不渲染\n      const shown = ctx.rendered.value\n      if (!api.isContentMounted(shown))\n        return null\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      // 收起后常驻（unmountOnExit 为 false）：遮罩不留，定位层以内联 display 收起，视觉桥随之断开\n      return h(XhPortal, { to: ctx.portalTarget.value, present: shown }, () => [\n        shown && !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', mergeProps(api.getPositionerProps() as Record<string, unknown>, shown ? {} : OVERLAY_STOWED_PROPS), [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !shown || 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    useTitleDescriptionPart(ctx.presence, 'title')\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    // 读不出一句话的说明不进描述链\n    const el = useDescriptionPart(ctx.presence)\n    return () => h('p', { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el }, 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

@@ -1,6 +1,7 @@
+import { TitleDescriptionPresence } from "../../runtime/title-description.js";
+import { DrawerApi, DrawerSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { DrawerApi, DrawerSchema } from "@xihan-ui/headless";
 //#region src/components/drawer/use-drawer.d.ts
 interface DrawerContext {
   service: Service<DrawerSchema>;
@@ -10,6 +11,8 @@ interface DrawerContext {
   backdropRef: Ref<HTMLElement | null>;
   /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */
   portalTarget: ComputedRef<string | Element>;
+  /** 标题与说明在不在场，由 XhDrawerTitle / XhDrawerDescription 登记；content 只引用在场的部件。 */
+  presence: TitleDescriptionPresence;
 }
 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

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":";;;;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"}
+{"version":3,"file":"use-drawer.d.ts","names":[],"sources":["../../../src/components/drawer/use-drawer.ts"],"mappings":";;;;;UAqBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;EAEjB,cAAc,qBAAqB;;EAEnC,UAAU;;iBAGI,UACd,OAAO,uBACP,eAAe,uCACf,2BAA2B,4BAC3B,iBAAiB,yCACjB,oBAAoB,6CACnB"}

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

@@ -3,9 +3,10 @@ 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 { useTitleDescriptionPresence } from "../../runtime/title-description.js";
+import { connectDrawer, drawerMachine } from "@xihan-ui/headless";
 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, onPanelSizeChange) {
 	const xhConfig = useXhConfig();
@@ -13,9 +14,11 @@ function useDrawer(props, onOpenChange, container, onExitComplete, onPanelSizeCh
 	const backdropRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const presence = useTitleDescriptionPresence();
 	const service = useMachine(drawerMachine, () => ({
 		...props,
 		contained: props.contained ?? container?.() != null,
+		parts: presence.parts.value,
 		onOpenChange,
 		onExitComplete,
 		onPanelSizeChange
@@ -53,7 +56,8 @@ function useDrawer(props, onOpenChange, container, onExitComplete, onPanelSizeCh
 		rendered,
 		contentRef,
 		backdropRef,
-		portalTarget: computed(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
+		portalTarget: computed(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body"),
+		presence
 	};
 }
 //#endregion

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 { 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"}
+{"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 type { TitleDescriptionPresence } from '../../runtime/title-description'\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 { useTitleDescriptionPresence } from '../../runtime/title-description'\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  /** 标题与说明在不在场，由 XhDrawerTitle / XhDrawerDescription 登记；content 只引用在场的部件。 */\n  presence: TitleDescriptionPresence\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 presence = useTitleDescriptionPresence()\n  const service = useMachine(\n    drawerMachine,\n    // 显式写了 contained 以它为准；没写则「给了容器即局部」\n    () => ({ ...props, contained: props.contained ?? container?.() != null, parts: presence.parts.value, 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, presence }\n}\n"],"mappings":";;;;;;;;;;AAiCA,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,WAAW,4BAA4B;CAC7C,MAAM,UAAU,WACd,sBAEO;EAAE,GAAG;EAAO,WAAW,MAAM,aAAa,YAAY,KAAK;EAAM,OAAO,SAAS,MAAM;EAAO;EAAc;EAAgB;CAAkB,IACrJ,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;EAAG;CAAS;AACnF"}

package/dist/components/editable/editable.d.ts

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from "@xihan-ui/headless";
 //#region src/components/editable/editable.d.ts
 type EditableProps = EditableSchema['props'];
 /** 默认插槽的载荷：当前的值与预览文字、编辑态，以及写值、进入编辑、提交、撤销的命令。 */
 type EditableRootSlotProps = Pick<EditableApi, 'value' | 'displayValue' | 'editing' | 'empty' | 'setValue' | 'edit' | 'submit' | 'cancel'>;
 declare const XhEditableRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -69,6 +73,10 @@ declare const XhEditableRoot: import("vue").DefineComponent<import("vue").Extrac
   'edit-change': (_details: PayloadOf<EditableProps, "onEditChange">) => true;
   'update:edit': (_edit: PayloadOf<EditableProps, "onEditChange">["edit"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };

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

@@ -1 +1 @@
-{"version":3,"file":"editable.d.ts","names":[],"sources":["../../../src/components/editable/editable.ts"],"mappings":";;;;;KAgBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcO,MAAA,SAAS;;;IACL,MAAA,SAAS;;;;;;;;IAGhB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACR,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAfH,MAAA,SAAS;;;IACL,MAAA,SAAS;;;;;;;;IAGhB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAYvB,WAAC,OAAO,0BAA0B;kCA2B9C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"editable.d.ts","names":[],"sources":["../../../src/components/editable/editable.ts"],"mappings":";;;;;KAgBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBO,MAAA,SAAS;;;IACL,MAAA,SAAS;;;;;;;;IAGhB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACR,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAfH,MAAA,SAAS;;;IACL,MAAA,SAAS;;;;;;;;IAGhB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAYvB,WAAC,OAAO,0BAA0B;kCA2B9C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAW1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/editable/editable.js

@@ -1,11 +1,13 @@
 import { useFormControlProps } from "../form/use-form-control.js";
 import { provideEditable, useEditableContext } from "./context.js";
 import { useEditable } from "./use-editable.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/editable/editable.ts
 const XhEditableRoot = defineComponent({
 	name: "XhEditableRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		value: { type: String },
 		defaultValue: { type: String },
 		edit: {
@@ -78,6 +80,10 @@ const XhEditableLabel = defineComponent({
 	name: "XhEditableLabel",
 	setup(_, { slots }) {
 		const ctx = useEditableContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });

package/dist/components/editable/editable.js.map

@@ -1 +1 @@
-{"version":3,"file":"editable.js","names":[],"sources":["../../../src/components/editable/editable.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// 提供 editable 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideEditable, useEditableContext } from './context'\nimport { useEditable } from './use-editable'\n\ntype EditableProps = EditableSchema['props']\n\n/** 默认插槽的载荷：当前的值与预览文字、编辑态，以及写值、进入编辑、提交、撤销的命令。 */\nexport type EditableRootSlotProps = Pick<\n  EditableApi,\n  'value' | 'displayValue' | 'editing' | 'empty' | 'setValue' | 'edit' | 'submit' | 'cancel'\n>\n\nexport const XhEditableRoot = defineComponent({\n  name: 'XhEditableRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: String },\n    defaultValue: { type: String },\n    edit: { type: Boolean, default: undefined },\n    defaultEdit: Boolean,\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    maxLength: { type: Number },\n    name: { type: String },\n    submitMode: { type: String as PropType<EditableSubmitMode> },\n    activationMode: { type: String as PropType<EditableActivationMode> },\n    selectOnFocus: { type: Boolean, default: undefined },\n    autoResize: Boolean,\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change / edit-change 携带 details，update:* 携带裸值；提交与撤销只有语义事件\n  emits: {\n    'value-change': (_details: PayloadOf<EditableProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<EditableProps, 'onValueChange'>['value']) => true,\n    'value-commit': (_details: PayloadOf<EditableProps, 'onValueCommit'>) => true,\n    'value-revert': (_details: PayloadOf<EditableProps, 'onValueRevert'>) => true,\n    'edit-change': (_details: PayloadOf<EditableProps, 'onEditChange'>) => true,\n    'update:edit': (_edit: PayloadOf<EditableProps, 'onEditChange'>['edit']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: EditableRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useEditable(useFormControlProps(props) as EditableProps, {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onValueCommit: details => emit('value-commit', details),\n      onValueRevert: details => emit('value-revert', details),\n      onEditChange: (details) => {\n        emit('edit-change', details)\n        emit('update:edit', details.edit)\n      },\n    })\n    provideEditable(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      displayValue: ctx.api.value.displayValue,\n      editing: ctx.api.value.editing,\n      empty: ctx.api.value.empty,\n      setValue: ctx.api.value.setValue,\n      edit: ctx.api.value.edit,\n      submit: ctx.api.value.submit,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhEditableLabel = defineComponent({\n  name: 'XhEditableLabel',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditablePreview = defineComponent({\n  name: 'XhEditablePreview',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    // 有插槽用插槽，否则显示当前值，值为空时显示 placeholder\n    return () => h(\n      'span',\n      { ...ctx.api.value.getPreviewProps() as Record<string, unknown>, ref: ctx.previewRef },\n      slots.default?.() ?? ctx.api.value.displayValue,\n    )\n  },\n})\n\nexport const XhEditableInput = defineComponent({\n  name: 'XhEditableInput',\n  setup() {\n    const ctx = useEditableContext()\n    return () => h('input', { ...ctx.api.value.getInputProps() as Record<string, unknown>, ref: ctx.inputRef })\n  },\n})\n\nexport const XhEditableEditTrigger = defineComponent({\n  name: 'XhEditableEditTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getEditTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableSubmitTrigger = defineComponent({\n  name: 'XhEditableSubmitTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getSubmitTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableCancelTrigger = defineComponent({\n  name: 'XhEditableCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableControl = defineComponent({\n  name: 'XhEditableControl',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"editable.js","names":[],"sources":["../../../src/components/editable/editable.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// 提供 editable 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideEditable, useEditableContext } from './context'\nimport { useEditable } from './use-editable'\n\ntype EditableProps = EditableSchema['props']\n\n/** 默认插槽的载荷：当前的值与预览文字、编辑态，以及写值、进入编辑、提交、撤销的命令。 */\nexport type EditableRootSlotProps = Pick<\n  EditableApi,\n  'value' | 'displayValue' | 'editing' | 'empty' | 'setValue' | 'edit' | 'submit' | 'cancel'\n>\n\nexport const XhEditableRoot = defineComponent({\n  name: 'XhEditableRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    value: { type: String },\n    defaultValue: { type: String },\n    edit: { type: Boolean, default: undefined },\n    defaultEdit: Boolean,\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    maxLength: { type: Number },\n    name: { type: String },\n    submitMode: { type: String as PropType<EditableSubmitMode> },\n    activationMode: { type: String as PropType<EditableActivationMode> },\n    selectOnFocus: { type: Boolean, default: undefined },\n    autoResize: Boolean,\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change / edit-change 携带 details，update:* 携带裸值；提交与撤销只有语义事件\n  emits: {\n    'value-change': (_details: PayloadOf<EditableProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<EditableProps, 'onValueChange'>['value']) => true,\n    'value-commit': (_details: PayloadOf<EditableProps, 'onValueCommit'>) => true,\n    'value-revert': (_details: PayloadOf<EditableProps, 'onValueRevert'>) => true,\n    'edit-change': (_details: PayloadOf<EditableProps, 'onEditChange'>) => true,\n    'update:edit': (_edit: PayloadOf<EditableProps, 'onEditChange'>['edit']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: EditableRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useEditable(useFormControlProps(props) as EditableProps, {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onValueCommit: details => emit('value-commit', details),\n      onValueRevert: details => emit('value-revert', details),\n      onEditChange: (details) => {\n        emit('edit-change', details)\n        emit('update:edit', details.edit)\n      },\n    })\n    provideEditable(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      displayValue: ctx.api.value.displayValue,\n      editing: ctx.api.value.editing,\n      empty: ctx.api.value.empty,\n      setValue: ctx.api.value.setValue,\n      edit: ctx.api.value.edit,\n      submit: ctx.api.value.submit,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhEditableLabel = defineComponent({\n  name: 'XhEditableLabel',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditablePreview = defineComponent({\n  name: 'XhEditablePreview',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    // 有插槽用插槽，否则显示当前值，值为空时显示 placeholder\n    return () => h(\n      'span',\n      { ...ctx.api.value.getPreviewProps() as Record<string, unknown>, ref: ctx.previewRef },\n      slots.default?.() ?? ctx.api.value.displayValue,\n    )\n  },\n})\n\nexport const XhEditableInput = defineComponent({\n  name: 'XhEditableInput',\n  setup() {\n    const ctx = useEditableContext()\n    return () => h('input', { ...ctx.api.value.getInputProps() as Record<string, unknown>, ref: ctx.inputRef })\n  },\n})\n\nexport const XhEditableEditTrigger = defineComponent({\n  name: 'XhEditableEditTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getEditTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableSubmitTrigger = defineComponent({\n  name: 'XhEditableSubmitTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getSubmitTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableCancelTrigger = defineComponent({\n  name: 'XhEditableCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableControl = defineComponent({\n  name: 'XhEditableControl',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAwBA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAC1B,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAO;EAC7B,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,aAAa,EAAE,MAAM,OAAO;EAC5B,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,WAAW,EAAE,MAAM,OAAO;EAC1B,MAAM,EAAE,MAAM,OAAO;EACrB,YAAY,EAAE,MAAM,OAAuC;EAC3D,gBAAgB,EAAE,MAAM,OAA2C;EACnE,eAAe;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACnD,YAAY;EACZ,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;CACzC;CAEA,OAAO;EACL,iBAAiB,aAAwD;EACzE,iBAAiB,WAA+D;EAChF,iBAAiB,aAAwD;EACzE,iBAAiB,aAAwD;EACzE,gBAAgB,aAAuD;EACvE,gBAAgB,UAA4D;CAC9E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,YAAY,oBAAoB,KAAK,GAAoB;GACnE,gBAAgB,YAAY;IAC1B,KAAK,gBAAgB,OAAO;IAC5B,KAAK,gBAAgB,QAAQ,KAAK;GACpC;GACA,gBAAe,YAAW,KAAK,gBAAgB,OAAO;GACtD,gBAAe,YAAW,KAAK,gBAAgB,OAAO;GACtD,eAAe,YAAY;IACzB,KAAK,eAAe,OAAO;IAC3B,KAAK,eAAe,QAAQ,IAAI;GAClC;EACF,CAAC;EACD,gBAAgB,GAAG;EACnB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,cAAc,IAAI,IAAI,MAAM;GAC5B,SAAS,IAAI,IAAI,MAAM;GACvB,OAAO,IAAI,IAAI,MAAM;GACrB,UAAU,IAAI,IAAI,MAAM;GACxB,MAAM,IAAI,IAAI,MAAM;GACpB,QAAQ,IAAI,IAAI,MAAM;GACtB,QAAQ,IAAI,IAAI,MAAM;EACxB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,IAAI,WAAW;EACf,kBAAkB;GAChB,IAAI,WAAW;EACjB,CAAC;EACD,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EACX,QACA;GAAE,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAA8B,KAAK,IAAI;EAAW,GACrF,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YACrC;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,SAAS;GAAE,GAAG,IAAI,IAAI,MAAM,cAAc;GAA8B,KAAK,IAAI;EAAS,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,sBAAsB,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,sBAAsB,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}

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

@@ -1,6 +1,6 @@
+import { EditableApi, EditableSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { EditableApi, EditableSchema } from "@xihan-ui/headless";
 //#region src/components/editable/use-editable.d.ts
 type Props = EditableSchema['props'];
 interface EditableCallbacks {
@@ -10,6 +10,11 @@ interface EditableCallbacks {
   onEditChange?: Props['onEditChange'];
 }
 interface EditableContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhEditableLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<EditableApi>;
   /** 状态机实例，供部件上报 DOM 侧的事实。 */
   service: Service<EditableSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"use-editable.d.ts","names":[],"sources":["../../../src/components/editable/use-editable.ts"],"mappings":";;;;KAiBK,QAAQ;UAEI;EACf,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,eAAe;;UAGA;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;EAEd,YAAY,IAAI;;iBAGF,YAAY,OAAO,OAAO,YAAW,oBAAyB"}
+{"version":3,"file":"use-editable.d.ts","names":[],"sources":["../../../src/components/editable/use-editable.ts"],"mappings":";;;;KAiBK,QAAQ;UAEI;EACf,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,eAAe;;UAGA;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;EAEd,YAAY,IAAI;;iBAGF,YAAY,OAAO,OAAO,YAAW,oBAAyB"}

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

@@ -1,20 +1,24 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectEditable, editableMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectEditable, editableMachine } from "@xihan-ui/headless";
 //#region src/components/editable/use-editable.ts
 function useEditable(props, callbacks = {}) {
 	const inputRef = ref(null);
 	const previewRef = ref(null);
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(editableMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...callbacks
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	service.refs.set("getInputEl", () => inputRef.value);
 	service.refs.set("getPreviewEl", () => previewRef.value);
 	return {
+		labelCount,
 		api: computed(() => connectEditable(service, vueNormalize)),
 		service,
 		inputRef,

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

@@ -1 +1 @@
-{"version":3,"file":"use-editable.js","names":[],"sources":["../../../src/components/editable/use-editable.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 editable 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { EditableApi, EditableSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectEditable, editableMachine } 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\ntype Props = EditableSchema['props']\n\nexport interface EditableCallbacks {\n  onValueChange?: Props['onValueChange']\n  onValueCommit?: Props['onValueCommit']\n  onValueRevert?: Props['onValueRevert']\n  onEditChange?: Props['onEditChange']\n}\n\nexport interface EditableContext {\n  api: ComputedRef<EditableApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<EditableSchema>\n  /** 输入框节点，进入编辑态后焦点移入它。 */\n  inputRef: Ref<HTMLElement | null>\n  /** 预览区节点，退出编辑态后焦点交还给它。 */\n  previewRef: Ref<HTMLElement | null>\n}\n\nexport function useEditable(props: Props, callbacks: EditableCallbacks = {}): EditableContext {\n  const inputRef = ref<HTMLElement | null>(null)\n  const previewRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(editableMachine, () => ({ ...props, ...callbacks }), scope)\n\n  // 传 getter 而非节点，进出编辑态时由机器现取\n  service.refs.set('getInputEl', () => inputRef.value)\n  service.refs.set('getPreviewEl', () => previewRef.value)\n\n  const api = computed(() => connectEditable(service, vueNormalize))\n  return { api, service, inputRef, previewRef }\n}\n"],"mappings":";;;;;;;AAoCA,SAAgB,YAAY,OAAc,YAA+B,CAAC,GAAoB;CAC5F,MAAM,WAAW,IAAwB,IAAI;CAC7C,MAAM,aAAa,IAAwB,IAAI;CAI/C,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAU,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CAGrF,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACnD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;EAAS;EAAU;CAAW;AAC9C"}
+{"version":3,"file":"use-editable.js","names":[],"sources":["../../../src/components/editable/use-editable.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 editable 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { EditableApi, EditableSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectEditable, editableMachine } 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\ntype Props = EditableSchema['props']\n\nexport interface EditableCallbacks {\n  onValueChange?: Props['onValueChange']\n  onValueCommit?: Props['onValueCommit']\n  onValueRevert?: Props['onValueRevert']\n  onEditChange?: Props['onEditChange']\n}\n\nexport interface EditableContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhEditableLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<EditableApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<EditableSchema>\n  /** 输入框节点，进入编辑态后焦点移入它。 */\n  inputRef: Ref<HTMLElement | null>\n  /** 预览区节点，退出编辑态后焦点交还给它。 */\n  previewRef: Ref<HTMLElement | null>\n}\n\nexport function useEditable(props: Props, callbacks: EditableCallbacks = {}): EditableContext {\n  const inputRef = ref<HTMLElement | null>(null)\n  const previewRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(editableMachine, () => ({ ...props, labelled: labelCount.value > 0, ...callbacks }), scope)\n\n  // 传 getter 而非节点，进出编辑态时由机器现取\n  service.refs.set('getInputEl', () => inputRef.value)\n  service.refs.set('getPreviewEl', () => previewRef.value)\n\n  const api = computed(() => connectEditable(service, vueNormalize))\n  return { labelCount, api, service, inputRef, previewRef }\n}\n"],"mappings":";;;;;;;AAyCA,SAAgB,YAAY,OAAc,YAA+B,CAAC,GAAoB;CAC5F,MAAM,WAAW,IAAwB,IAAI;CAC7C,MAAM,aAAa,IAAwB,IAAI;CAG/C,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAU,IAAI,KAAK;CAGrH,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACnD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE;EAAY,KADT,eAAe,gBAAgB,SAAS,YAAY,CACzC;EAAG;EAAS;EAAU;CAAW;AAC1D"}

package/dist/components/empty-state/empty-state.d.ts

@@ -1,6 +1,6 @@
+import { EmptyStateLive, EmptyStateStatus } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Tone } from "@xihan-ui/core";
-import { EmptyStateLive, EmptyStateStatus } from "@xihan-ui/headless";
 //#region src/components/empty-state/empty-state.d.ts
 /** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */
 declare const XhEmptyStateRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

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

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 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";
+import { computed, shallowRef } from "vue";
 //#region src/components/empty-state/use-empty-state.ts
 function useEmptyState(props) {
 	const rootRef = shallowRef(null);

package/dist/components/expression-input/context.d.ts

@@ -0,0 +1,7 @@
+import { ExpressionInputContext } from "./use-expression-input.js";
+//#region src/components/expression-input/context.d.ts
+declare function provideExpressionInput(ctx: ExpressionInputContext): void;
+declare function useExpressionInputContext(): ExpressionInputContext;
+//#endregion
+export { provideExpressionInput, useExpressionInputContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/expression-input/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/expression-input/context.ts"],"mappings":";;iBAagB,uBAAuB,KAAK;iBAI5B,6BAA6B"}

package/dist/components/expression-input/context.js

@@ -0,0 +1,15 @@
+import { inject, provide } from "vue";
+//#region src/components/expression-input/context.ts
+const KEY = Symbol.for("xh-expression-input");
+function provideExpressionInput(ctx) {
+	provide(KEY, ctx);
+}
+function useExpressionInputContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] ExpressionInput 部件必须用在 XhExpressionInputRoot 内");
+	return ctx;
+}
+//#endregion
+export { provideExpressionInput, useExpressionInputContext };
+
+//# sourceMappingURL=context.js.map

package/dist/components/expression-input/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/expression-input/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { ExpressionInputContext } from './use-expression-input'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ExpressionInputContext> = Symbol.for('xh-expression-input')\n\nexport function provideExpressionInput(ctx: ExpressionInputContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useExpressionInputContext(): ExpressionInputContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ExpressionInput 部件必须用在 XhExpressionInputRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAA4C,OAAO,IAAI,qBAAqB;AAElF,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,4BAAoD;CAClE,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qDAAqD;CACvE,OAAO;AACT"}