@xihan-ui/vue 2.1.0 → 3.0.0

package/dist/components/descriptions/descriptions.d.ts

@@ -1,4 +1,4 @@
-import { PropType } from "vue";
+import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size } from "@xihan-ui/core";
 import { DescriptionsColumns, DescriptionsPlacement } from "@xihan-ui/headless";
 //#region src/components/descriptions/descriptions.d.ts
@@ -20,7 +20,7 @@ declare const XhDescriptionsRoot: import("vue").DefineComponent<import("vue").Ex
     type: StringConstructor;
     default: string;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   columns: {
@@ -42,7 +42,14 @@ declare const XhDescriptionsRoot: import("vue").DefineComponent<import("vue").Ex
   };
 }>> & Readonly<{}>, {
   as: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+  default?: () => VNode[];
+  /**
+   * 列表之前的头部：放 XhDescriptionsHeader（内含 Title 与 Extra）。
+   * 它渲染为根的兄弟排在列表前：根常写成 dl，dl 的子节点只能是成对的 dt / dd。
+   */
+  header?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDescriptionsItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 每一格渲染为哪个标签，默认 div。 */
   as: {
@@ -53,7 +60,7 @@ declare const XhDescriptionsItem: import("vue").DefineComponent<import("vue").Ex
   span: {
     type: NumberConstructor;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /** 每一格渲染为哪个标签，默认 div。 */
@@ -74,7 +81,7 @@ declare const XhDescriptionsLabel: import("vue").DefineComponent<import("vue").E
     type: StringConstructor;
     default: string;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /** 标签渲染为哪个标签，默认 dt。 */
@@ -91,7 +98,7 @@ declare const XhDescriptionsValue: import("vue").DefineComponent<import("vue").E
     type: StringConstructor;
     default: string;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /** 取值渲染为哪个标签，默认 dd。 */
@@ -102,6 +109,30 @@ declare const XhDescriptionsValue: import("vue").DefineComponent<import("vue").E
 }>> & Readonly<{}>, {
   as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 列表之前的头部：左侧标题、右侧附加内容。写在 XhDescriptionsRoot 的 header 插槽中。 */
+declare const XhDescriptionsHeader: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhDescriptionsTitle: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题渲染为哪个标签，默认 div：组件不往文档大纲里插标题，作者按页面层级改写成 h2 / h3。 */
+  as: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题渲染为哪个标签，默认 div：组件不往文档大纲里插标题，作者按页面层级改写成 h2 / h3。 */
+  as: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  as: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhDescriptionsExtra: 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 { XhDescriptionsItem, XhDescriptionsLabel, XhDescriptionsRoot, XhDescriptionsValue };
+export { XhDescriptionsExtra, XhDescriptionsHeader, XhDescriptionsItem, XhDescriptionsLabel, XhDescriptionsRoot, XhDescriptionsTitle, XhDescriptionsValue };
 //# sourceMappingURL=descriptions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"descriptions.d.ts","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"mappings":";;;;cAgBa,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;;;;;;;;;IAHN,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;;;;;;;qCAgBnC;cAGW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;qCAgB7B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B"}
+{"version":3,"file":"descriptions.d.ts","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"mappings":";;;;cAgBa,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;;;;;;;;;IAHN,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;;;;;;;;EAKvB,gBAAM;;;;;EAKP,eAAM;kCAoBjB;cAGW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;qCAgB7B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/descriptions/descriptions.js

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { provideDescriptions, useDescriptionsContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
+import { Fragment, computed, defineComponent, h, mergeProps } from "vue";
 import { connectDescriptions } from "@xihan-ui/headless";
 //#region src/components/descriptions/descriptions.ts
 const XhDescriptionsRoot = defineComponent({
@@ -17,7 +17,9 @@ const XhDescriptionsRoot = defineComponent({
 			default: "dl"
 		}
 	},
-	setup(props, { slots }) {
+	slots: Object,
+	inheritAttrs: false,
+	setup(props, { slots, attrs }) {
 		const configured = withXhConfig("descriptions", props);
 		const api = computed(() => connectDescriptions({
 			columns: configured.columns,
@@ -26,7 +28,11 @@ const XhDescriptionsRoot = defineComponent({
 			size: configured.size
 		}, vueNormalize));
 		provideDescriptions({ api });
-		return () => h(props.as, api.value.getRootProps(), slots.default?.());
+		return () => {
+			const list = h(props.as, mergeProps(api.value.getRootProps(), attrs), slots.default?.());
+			const header = slots.header?.();
+			return header ? h(Fragment, [...header, list]) : list;
+		};
 	}
 });
 const XhDescriptionsItem = defineComponent({
@@ -71,7 +77,35 @@ as: {
 		return () => h(props.as, ctx.api.value.getValueProps(), slots.default?.());
 	}
 });
+/** 列表之前的头部：左侧标题、右侧附加内容。写在 XhDescriptionsRoot 的 header 插槽中。 */
+const XhDescriptionsHeader = defineComponent({
+	name: "XhDescriptionsHeader",
+	setup(_, { slots }) {
+		const ctx = useDescriptionsContext();
+		return () => h("div", ctx.api.value.getHeaderProps(), slots.default?.());
+	}
+});
+const XhDescriptionsTitle = defineComponent({
+	name: "XhDescriptionsTitle",
+	props: { 
+	/** 标题渲染为哪个标签，默认 div：组件不往文档大纲里插标题，作者按页面层级改写成 h2 / h3。 */
+as: {
+		type: String,
+		default: "div"
+	} },
+	setup(props, { slots }) {
+		const ctx = useDescriptionsContext();
+		return () => h(props.as, ctx.api.value.getTitleProps(), slots.default?.());
+	}
+});
+const XhDescriptionsExtra = defineComponent({
+	name: "XhDescriptionsExtra",
+	setup(_, { slots }) {
+		const ctx = useDescriptionsContext();
+		return () => h("div", ctx.api.value.getExtraProps(), slots.default?.());
+	}
+});
 //#endregion
-export { XhDescriptionsItem, XhDescriptionsLabel, XhDescriptionsRoot, XhDescriptionsValue };
+export { XhDescriptionsExtra, XhDescriptionsHeader, XhDescriptionsItem, XhDescriptionsLabel, XhDescriptionsRoot, XhDescriptionsTitle, XhDescriptionsValue };
 
 //# sourceMappingURL=descriptions.js.map

package/dist/components/descriptions/descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"descriptions.js","names":[],"sources":["../../../src/components/descriptions/descriptions.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// 提供 descriptions 相关实现。\n\nimport type { ControlVariant, Size } from '@xihan-ui/core'\nimport type { DescriptionsColumns, DescriptionsPlacement } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectDescriptions } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideDescriptions, useDescriptionsContext } from './context'\n\nexport const XhDescriptionsRoot = defineComponent({\n  name: 'XhDescriptionsRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    columns: { type: Number as PropType<DescriptionsColumns> },\n    variant: { type: String as PropType<ControlVariant> },\n    placement: { type: String as PropType<DescriptionsPlacement> },\n    size: { type: String as PropType<Size> },\n    /** 根渲染为哪个标签，默认 dl。 */\n    as: { type: String, default: 'dl' },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('descriptions', props)\n    const api = computed(() => connectDescriptions({\n      columns: configured.columns,\n      variant: configured.variant,\n      placement: configured.placement,\n      size: configured.size,\n    }, vueNormalize))\n    provideDescriptions({ api })\n    return () => h(props.as, api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 一组「标签 + 取值」包一层，让它成为网格里的一格；dl 允许 div 包裹成对的 dt/dd\nexport const XhDescriptionsItem = defineComponent({\n  name: 'XhDescriptionsItem',\n  props: {\n    /** 每一格渲染为哪个标签，默认 div。 */\n    as: { type: String, default: 'div' },\n    /** 该格横跨几列，未写即占一列；上限是根上的 columns。 */\n    span: { type: Number },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getItemProps({ span: props.span }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhDescriptionsLabel = defineComponent({\n  name: 'XhDescriptionsLabel',\n  props: {\n    /** 标签渲染为哪个标签，默认 dt。 */\n    as: { type: String, default: 'dt' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsValue = defineComponent({\n  name: 'XhDescriptionsValue',\n  props: {\n    /** 取值渲染为哪个标签，默认 dd。 */\n    as: { type: String, default: 'dd' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getValueProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,SAAS,EAAE,MAAM,OAAwC;EACzD,SAAS,EAAE,MAAM,OAAmC;EACpD,WAAW,EAAE,MAAM,OAA0C;EAC7D,MAAM,EAAE,MAAM,OAAyB;;EAEvC,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAK;CACpC;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,gBAAgB,KAAK;EACrD,MAAM,MAAM,eAAe,oBAAoB;GAC7C,SAAS,WAAW;GACpB,SAAS,WAAW;GACpB,WAAW,WAAW;GACtB,MAAM,WAAW;EACnB,GAAG,YAAY,CAAC;EAChB,oBAAoB,EAAE,IAAI,CAAC;EAC3B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;EAEL,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAM;;EAEnC,MAAM,EAAE,MAAM,OAAO;CACvB;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,aAAa,EAAE,MAAM,MAAM,KAAK,CAAC,GAC/C,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC"}
+{"version":3,"file":"descriptions.js","names":[],"sources":["../../../src/components/descriptions/descriptions.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// 提供 descriptions 相关实现。\n\nimport type { ControlVariant, Size } from '@xihan-ui/core'\nimport type { DescriptionsColumns, DescriptionsPlacement } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { connectDescriptions } from '@xihan-ui/headless'\nimport { computed, defineComponent, Fragment, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideDescriptions, useDescriptionsContext } from './context'\n\nexport const XhDescriptionsRoot = defineComponent({\n  name: 'XhDescriptionsRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    columns: { type: Number as PropType<DescriptionsColumns> },\n    variant: { type: String as PropType<ControlVariant> },\n    placement: { type: String as PropType<DescriptionsPlacement> },\n    size: { type: String as PropType<Size> },\n    /** 根渲染为哪个标签，默认 dl。 */\n    as: { type: String, default: 'dl' },\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    /**\n     * 列表之前的头部：放 XhDescriptionsHeader（内含 Title 与 Extra）。\n     * 它渲染为根的兄弟排在列表前：根常写成 dl，dl 的子节点只能是成对的 dt / dd。\n     */\n    header?: () => VNode[]\n  }>,\n  // 写了头部时根是片段，接不住自动透传：作者写在 XhDescriptionsRoot 上的 class / aria-* 自己合到列表那个节点上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('descriptions', props)\n    const api = computed(() => connectDescriptions({\n      columns: configured.columns,\n      variant: configured.variant,\n      placement: configured.placement,\n      size: configured.size,\n    }, vueNormalize))\n    provideDescriptions({ api })\n    return () => {\n      const list = h(props.as, mergeProps(api.value.getRootProps() as Record<string, unknown>, attrs), slots.default?.())\n      const header = slots.header?.()\n      return header ? h(Fragment, [...header, list]) : list\n    }\n  },\n})\n\n// 一组「标签 + 取值」包一层，让它成为网格里的一格；dl 允许 div 包裹成对的 dt/dd\nexport const XhDescriptionsItem = defineComponent({\n  name: 'XhDescriptionsItem',\n  props: {\n    /** 每一格渲染为哪个标签，默认 div。 */\n    as: { type: String, default: 'div' },\n    /** 该格横跨几列，未写即占一列；上限是根上的 columns。 */\n    span: { type: Number },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getItemProps({ span: props.span }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhDescriptionsLabel = defineComponent({\n  name: 'XhDescriptionsLabel',\n  props: {\n    /** 标签渲染为哪个标签，默认 dt。 */\n    as: { type: String, default: 'dt' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsValue = defineComponent({\n  name: 'XhDescriptionsValue',\n  props: {\n    /** 取值渲染为哪个标签，默认 dd。 */\n    as: { type: String, default: 'dd' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getValueProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 列表之前的头部：左侧标题、右侧附加内容。写在 XhDescriptionsRoot 的 header 插槽中。 */\nexport const XhDescriptionsHeader = defineComponent({\n  name: 'XhDescriptionsHeader',\n  setup(_, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsTitle = defineComponent({\n  name: 'XhDescriptionsTitle',\n  props: {\n    /** 标题渲染为哪个标签，默认 div：组件不往文档大纲里插标题，作者按页面层级改写成 h2 / h3。 */\n    as: { type: String, default: 'div' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsExtra = defineComponent({\n  name: 'XhDescriptionsExtra',\n  setup(_, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h('div', ctx.api.value.getExtraProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,SAAS,EAAE,MAAM,OAAwC;EACzD,SAAS,EAAE,MAAM,OAAmC;EACpD,WAAW,EAAE,MAAM,OAA0C;EAC7D,MAAM,EAAE,MAAM,OAAyB;;EAEvC,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAK;CACpC;CACA,OAAO;CASP,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAE7B,MAAM,aAAa,aAAa,gBAAgB,KAAK;EACrD,MAAM,MAAM,eAAe,oBAAoB;GAC7C,SAAS,WAAW;GACpB,SAAS,WAAW;GACpB,WAAW,WAAW;GACtB,MAAM,WAAW;EACnB,GAAG,YAAY,CAAC;EAChB,oBAAoB,EAAE,IAAI,CAAC;EAC3B,aAAa;GACX,MAAM,OAAO,EAAE,MAAM,IAAI,WAAW,IAAI,MAAM,aAAa,GAA8B,KAAK,GAAG,MAAM,UAAU,CAAC;GAClH,MAAM,SAAS,MAAM,SAAS;GAC9B,OAAO,SAAS,EAAE,UAAU,CAAC,GAAG,QAAQ,IAAI,CAAC,IAAI;EACnD;CACF;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;EAEL,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAM;;EAEnC,MAAM,EAAE,MAAM,OAAO;CACvB;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,aAAa,EAAE,MAAM,MAAM,KAAK,CAAC,GAC/C,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAM,EACrC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}

package/dist/components/dialog/dialog.d.ts

@@ -41,6 +41,11 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
   variant: {
     type: PropType<OverlayBackdropVariant>;
   };
+  /** 可拖动：按住标题栏或拖动把手挪走面板，方向键在把手上挪一步；面板始终夹在视口内。 */
+  draggable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<DialogProps["translations"]>;
   };
@@ -85,6 +90,11 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
   variant: {
     type: PropType<OverlayBackdropVariant>;
   };
+  /** 可拖动：按住标题栏或拖动把手挪走面板，方向键在把手上挪一步；面板始终夹在视口内。 */
+  draggable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<DialogProps["translations"]>;
   };
@@ -100,6 +110,7 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
   closeOnInteractOutside: boolean;
   restoreFocus: boolean;
   role: "dialog" | "alertdialog";
+  draggable: boolean;
 }, SlotsType<{
   default?: (props: DialogRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -130,6 +141,10 @@ declare const XhDialogContent: import("vue").DefineComponent<import("vue").Extra
 declare const XhDialogHeader: 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>;
+/** 拖动把手：键盘挪动面板的入口；放在 XhDialogHeader 里时铺满标题栏。 */
+declare const XhDialogDragTrigger: 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>;
 /** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */
 declare const XhDialogIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -150,5 +165,5 @@ declare const XhDialogCloseTrigger: import("vue").DefineComponent<{}, () => VNod
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { DialogRootSlotProps, XhDialogBody, XhDialogCloseTrigger, XhDialogContent, XhDialogDescription, XhDialogFooter, XhDialogHeader, XhDialogIndicator, XhDialogRoot, XhDialogTitle, XhDialogTrigger };
+export { DialogRootSlotProps, XhDialogBody, XhDialogCloseTrigger, XhDialogContent, XhDialogDescription, XhDialogDragTrigger, XhDialogFooter, XhDialogHeader, XhDialogIndicator, XhDialogRoot, XhDialogTitle, XhDialogTrigger };
 //# sourceMappingURL=dialog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAMG,MAAA;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;IAZT,MAAA;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;kCAW5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,8BAAA;;;IAIK,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MA4BxC,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,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":"dialog.d.ts","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAMG,MAAA;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;IAGJ,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;IAdT,MAAA;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;IAGJ,MAAA,SAAS;;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;kCAW5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,8BAAA;;;IAIK,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MA4BxC,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,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"}

package/dist/components/dialog/dialog.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 { provideDialog, useDialogContext } from "./context.js";
 import { useDialog } from "./use-dialog.js";
 import { defineComponent, h, mergeProps } from "vue";
@@ -37,6 +37,11 @@ const XhDialogRoot = /* @__PURE__ */ defineComponent({
 		initialFocus: { type: String },
 		size: { type: String },
 		variant: { type: String },
+		/** 可拖动：按住标题栏或拖动把手挪走面板，方向键在把手上挪一步；面板始终夹在视口内。 */
+		draggable: {
+			type: Boolean,
+			default: void 0
+		},
 		translations: { type: Object }
 	},
 	emits: {
@@ -111,6 +116,14 @@ const XhDialogHeader = /* @__PURE__ */ defineComponent({
 		return () => h("header", ctx.api.value.getHeaderProps(), slots.default?.());
 	}
 });
+/** 拖动把手：键盘挪动面板的入口；放在 XhDialogHeader 里时铺满标题栏。 */
+const XhDialogDragTrigger = /* @__PURE__ */ defineComponent({
+	name: "XhDialogDragTrigger",
+	setup(_, { slots }) {
+		const ctx = useDialogContext();
+		return () => h("button", ctx.api.value.getDragTriggerProps(), slots.default?.());
+	}
+});
 /** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */
 const XhDialogIndicator = /* @__PURE__ */ defineComponent({
 	name: "XhDialogIndicator",
@@ -155,6 +168,6 @@ const XhDialogCloseTrigger = /* @__PURE__ */ defineComponent({
 	}
 });
 //#endregion
-export { XhDialogBody, XhDialogCloseTrigger, XhDialogContent, XhDialogDescription, XhDialogFooter, XhDialogHeader, XhDialogIndicator, XhDialogRoot, XhDialogTitle, XhDialogTrigger };
+export { XhDialogBody, XhDialogCloseTrigger, XhDialogContent, XhDialogDescription, XhDialogDragTrigger, XhDialogFooter, XhDialogHeader, XhDialogIndicator, XhDialogRoot, XhDialogTitle, XhDialogTrigger };
 
 //# sourceMappingURL=dialog.js.map

package/dist/components/dialog/dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.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// 提供 dialog 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } 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 { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与修改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    initialFocus: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    translations: { type: Object as PropType<DialogProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify, () => emit('exit-complete'))\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\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, 'dialog')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDialogContent = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogContent',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\n    return () => {\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: props.container ?? 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 XhDialogHeader = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogHeader',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */\nexport const XhDialogIndicator = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogIndicator',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogTitle = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogBody = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogBody',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogFooter = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogFooter',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\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":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.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// 提供 dialog 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } 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 { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与修改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    initialFocus: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /** 可拖动：按住标题栏或拖动把手挪走面板，方向键在把手上挪一步；面板始终夹在视口内。 */\n    draggable: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<DialogProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify, () => emit('exit-complete'))\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\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, 'dialog')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDialogContent = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogContent',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\n    return () => {\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: props.container ?? 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 XhDialogHeader = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogHeader',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 拖动把手：键盘挪动面板的入口；放在 XhDialogHeader 里时铺满标题栏。 */\nexport const XhDialogDragTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDragTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getDragTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */\nexport const XhDialogIndicator = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogIndicator',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogTitle = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogBody = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogBody',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogFooter = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogFooter',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,uCACf,iBAAiB,0CAChB"}
+{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAmBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,uCACf,iBAAiB,0CAChB"}

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

@@ -1,9 +1,9 @@
+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 { connectDialog, dialogMachine } from "@xihan-ui/headless";
 //#region src/components/dialog/use-dialog.ts
@@ -17,7 +17,6 @@ function useDialog(props, onOpenChange, onExitComplete) {
 		onOpenChange,
 		onExitComplete
 	}), scope);
-	const rendered = ref(service.state.get() === "open");
 	const xhConfig = useXhConfig();
 	let config = null;
 	if (typeof document !== "undefined") {
@@ -33,36 +32,19 @@ function useDialog(props, onOpenChange, 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(() => connectDialog(service, vueNormalize)),

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.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 dialog 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { DialogApi, DialogSchema } 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 { connectDialog, dialogMachine } 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 DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n  onExitComplete?: DialogSchema['props']['onExitComplete'],\n): DialogContext {\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  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange, onExitComplete }), scope)\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  const xhConfig = useXhConfig()\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,\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(() => connectDialog(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,UACd,OACA,cACA,gBACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;EAAc;CAAe,IAAI,KAAK;CAInG,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,MAAM,WAAW,YAAY;CAC7B,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;GAC9C;GACA,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;CAKA,OAAO;EAAE;EAAS,KAHN,eAAe,cAAc,SAAS,YAAY,CAG1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}
+{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.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 dialog 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectDialog, dialogMachine } 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 DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n  onExitComplete?: DialogSchema['props']['onExitComplete'],\n): DialogContext {\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  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange, onExitComplete }), scope)\n\n  const xhConfig = useXhConfig()\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(() => connectDialog(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA6BA,SAAgB,UACd,OACA,cACA,gBACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;EAAc;CAAe,IAAI,KAAK;CAEnG,MAAM,WAAW,YAAY;CAC7B,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;CAKD,OAAO;EAAE;EAAS,KAHN,eAAe,cAAc,SAAS,YAAY,CAG1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { DiffChange, DiffModel, DiffViewApi, DiffViewMode, DiffViewSchema, DiffViewTranslations } from "@xihan-ui/headless";
+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'];
 /** 默认插槽的载荷：可见行序、增删统计与展开集合。 */
@@ -26,6 +26,13 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  commentable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  commentLines: {
+    type: PropType<readonly DiffViewLineRef[]>;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -37,6 +44,7 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'expanded-value-change': (_details: PayloadOf<Props, "onExpandedValueChange">) => true;
   'update:expandedValue': (_value: string[]) => true;
+  'comment-request': (_details: PayloadOf<Props, "onCommentRequest">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   model: {
     type: PropType<DiffModel>;
@@ -57,6 +65,13 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  commentable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  commentLines: {
+    type: PropType<readonly DiffViewLineRef[]>;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -66,8 +81,10 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>> & Readonly<{
   "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").DiffViewExpandedValueChangeDetails) => any) | undefined;
   "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
+  "onComment-request"?: ((_details: DiffViewCommentRequestDetails) => any) | undefined;
 }>, {
   wrap: boolean;
+  commentable: boolean;
 }, SlotsType<{
   default?: (props: DiffViewRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -101,7 +118,10 @@ declare const XhDiffViewViewport: import("vue").DefineComponent<{}, () => VNode<
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDiffViewBody: 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>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+  default?: () => VNode[];
+  comment?: (props: DiffViewCommentRequestDetails) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDiffViewEmpty: 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>;

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

@@ -1 +1 @@
-{"version":3,"file":"diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/diff-view.ts"],"mappings":";;;;;KAiBK,QAAQ;;KAGD,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAGE,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;IAEf,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGb,0BAAA,UAAA,UAAU;EACb,yBAAA;;;IAXR,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;IAEf,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAOvC,WAAC,OAAO,0BAA0B;kCAoB9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,iCAAiB,8BAAA;;IAGA,MAAA,SAAS,QAAQ;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;EAGjC,WAAC;IAAS;QAAoB;kCAc1C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAwCzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cA6BW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGnB,WAAC;IAAS;QAAoB;kCAa1C"}
+{"version":3,"file":"diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/diff-view.ts"],"mappings":";;;;;KAiBK,QAAQ;;KAGD,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAGE,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;;;;;IAGR,MAAA,kBAAkB;;;IACzB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIb,0BAAA,UAAA,UAAU;EACb,yBAAA;EACH,oBAAA,UAAA,UAAU;;;IAff,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;;;;;IAGR,MAAA,kBAAkB;;;IACzB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;EASvC,WAAC,OAAO,0BAA0B;kCAoB9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAa3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,iCAAiB,8BAAA;;IAGA,MAAA,SAAS,QAAQ;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;EAGjC,WAAC;IAAS;QAAoB;kCAc1C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;;EAIb,gBAAM;EACN,WAAC,OAAO,kCAAkC;kCAkDtD;cA6BW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGnB,WAAC;IAAS;QAAoB;kCAa1C"}

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

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideDiffView, useDiffViewContext } from "./context.js";
 import { useDiffView } from "./use-diff-view.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, onBeforeUnmount, onMounted } from "vue";
 import { diffViewSides } from "@xihan-ui/headless";
 //#region src/components/diff-view/diff-view.ts
 const XhDiffViewRoot = defineComponent({
@@ -16,19 +16,25 @@ const XhDiffViewRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		commentable: {
+			type: Boolean,
+			default: void 0
+		},
+		commentLines: { type: Array },
 		size: { type: String },
 		translations: { type: Object }
 	},
 	emits: {
 		"expanded-value-change": (_details) => true,
-		"update:expandedValue": (_value) => true
+		"update:expandedValue": (_value) => true,
+		"comment-request": (_details) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
 		const ctx = useDiffView(withXhConfig("diff-view", props), (details) => {
 			emit("expanded-value-change", details);
 			emit("update:expandedValue", details.value);
-		});
+		}, (details) => emit("comment-request", details));
 		provideDiffView(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			view: ctx.api.value.view,
@@ -47,6 +53,12 @@ const XhDiffViewHeader = defineComponent({
 	name: "XhDiffViewHeader",
 	setup(_, { slots }) {
 		const ctx = useDiffViewContext();
+		onMounted(() => {
+			ctx.headerCount.value++;
+		});
+		onBeforeUnmount(() => {
+			ctx.headerCount.value--;
+		});
 		return () => h("div", ctx.api.value.getHeaderProps(), slots.default?.());
 	}
 });
@@ -80,6 +92,7 @@ const XhDiffViewViewport = defineComponent({
 });
 const XhDiffViewBody = defineComponent({
 	name: "XhDiffViewBody",
+	slots: Object,
 	setup(_, { slots }) {
 		const ctx = useDiffViewContext();
 		return () => {
@@ -97,19 +110,29 @@ const XhDiffViewBody = defineComponent({
 				return h("div", {
 					...api.getRowProps({ rowIndex }),
 					key: `row:${rowIndex}`
-				}, sides.flatMap((side) => [h("span", {
-					...api.getLineNumberProps({
-						rowIndex,
-						side
-					}),
-					key: `n:${side}`
-				}), h("span", {
-					...api.getLineContentProps({
+				}, sides.flatMap((side) => {
+					const cell = {
 						rowIndex,
 						side
-					}),
-					key: `c:${side}`
-				}, [h("span", api.getChangeLabelProps({ change: row.line.change }), api.changeLabel(row.line.change)), ...renderCell(api, rowIndex, side)])]));
+					};
+					const ref = api.commentRefAt(cell);
+					return [h("span", {
+						...api.getLineNumberProps(cell),
+						key: `n:${side}`
+					}), h("span", {
+						...api.getLineContentProps(cell),
+						key: `c:${side}`
+					}, [
+						h("span", api.getChangeLabelProps({ change: row.line.change }), api.changeLabel(row.line.change)),
+						api.commentable && ref !== void 0 ? h("button", api.getCommentTriggerProps(cell)) : null,
+						...renderCell(api, rowIndex, side),
+						api.hasComment(cell) ? h("div", api.getCommentThreadProps(cell), slots.comment?.({
+							...ref,
+							change: row.line.change,
+							text: row.line.text
+						})) : null
+					])];
+				}));
 			}), slots.default?.() ?? []]);
 		};
 	}