@xihan-ui/vue 2.1.0 → 3.0.0

package/dist/components/pie-chart/pie-chart.d.ts

@@ -0,0 +1,203 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { ChartDatumDetails, ChartKey, ChartRow, NumberFormatSpec, PieChartApi, PieChartSchema, PieChartTranslations, PieLabelContent, PieLabelDetails, PieLabels, PieSort, PieSweep, PieTooltipModel, PieVariant } from "@xihan-ui/headless";
+//#region src/components/pie-chart/pie-chart.d.ts
+type PieChartProps = PieChartSchema['props'];
+/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
+type PieChartRootSlotProps = Pick<PieChartApi, 'legendItems' | 'active' | 'tooltip' | 'center' | 'empty' | 'hiddenSeries' | 'activeKey' | 'toggleSeries' | 'setFocusedDatum' | 'table'>;
+/** 提示框插槽的载荷：激活的扇区与缺省的内容模型。 */
+interface PieChartTooltipSlotProps {
+  active: ChartDatumDetails | null;
+  tooltip: PieTooltipModel | null;
+}
+/** 环形中心插槽的载荷：可见扇区的合计与说明文字，以及激活的扇区。 */
+interface PieChartCenterSlotProps {
+  center: PieChartApi['center'];
+  active: ChartDatumDetails | null;
+}
+/** 标题：图表的可及名来源。 */
+declare const XhPieChartCaption: 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 XhPieChartLegend: 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 XhPieChartViewport: 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 XhPieChartPlot: 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 XhPieChartCenter: 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<{}>, {}, SlotsType<{
+  default?: (props: PieChartCenterSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 提示框：缺省内容按激活的扇区生成，作用域插槽可替换。 */
+declare const XhPieChartTooltip: 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<{}>, {}, SlotsType<{
+  default?: (props: PieChartTooltipSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 空态：没有可画的扇区时显示，缺省文字取文案。 */
+declare const XhPieChartEmpty: 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 XhPieChartRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<readonly ChartRow[]>;
+  };
+  nameField: {
+    type: StringConstructor;
+  };
+  valueField: {
+    type: StringConstructor;
+  };
+  variant: {
+    type: PropType<PieVariant>;
+  };
+  rose: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  sweep: {
+    type: PropType<PieSweep>;
+  };
+  sort: {
+    type: PropType<PieSort>;
+  };
+  maxSlices: {
+    type: NumberConstructor;
+  };
+  labels: {
+    type: PropType<PieLabels>;
+  };
+  /** 扇区标签写什么：内建写法之一，或自己拼的函数。 */
+  labelContent: {
+    type: PropType<PieLabelContent | ((details: PieLabelDetails) => string)>;
+  };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  hiddenSeries: {
+    type: PropType<string[]>;
+  };
+  defaultHiddenSeries: {
+    type: PropType<string[]>;
+  };
+  activeKey: {
+    type: PropType<ChartKey | null>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  animated: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  translations: {
+    type: PropType<Partial<PieChartTranslations>>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'hidden-series-change': (_details: PayloadOf<PieChartProps, "onHiddenSeriesChange">) => true;
+  'update:hiddenSeries': (_hidden: PayloadOf<PieChartProps, "onHiddenSeriesChange">["hiddenSeries"]) => true;
+  'active-key-change': (_details: PayloadOf<PieChartProps, "onActiveKeyChange">) => true;
+  'update:activeKey': (_key: PayloadOf<PieChartProps, "onActiveKeyChange">["activeKey"]) => true;
+  'datum-active': (_details: PayloadOf<PieChartProps, "onDatumActive">) => true;
+  'datum-press': (_details: PayloadOf<PieChartProps, "onDatumPress">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<readonly ChartRow[]>;
+  };
+  nameField: {
+    type: StringConstructor;
+  };
+  valueField: {
+    type: StringConstructor;
+  };
+  variant: {
+    type: PropType<PieVariant>;
+  };
+  rose: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  sweep: {
+    type: PropType<PieSweep>;
+  };
+  sort: {
+    type: PropType<PieSort>;
+  };
+  maxSlices: {
+    type: NumberConstructor;
+  };
+  labels: {
+    type: PropType<PieLabels>;
+  };
+  /** 扇区标签写什么：内建写法之一，或自己拼的函数。 */
+  labelContent: {
+    type: PropType<PieLabelContent | ((details: PieLabelDetails) => string)>;
+  };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  hiddenSeries: {
+    type: PropType<string[]>;
+  };
+  defaultHiddenSeries: {
+    type: PropType<string[]>;
+  };
+  activeKey: {
+    type: PropType<ChartKey | null>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  animated: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  translations: {
+    type: PropType<Partial<PieChartTranslations>>;
+  };
+}>> & Readonly<{
+  "onHidden-series-change"?: ((_details: import("@xihan-ui/headless").ChartHiddenSeriesChangeDetails) => any) | undefined;
+  "onUpdate:hiddenSeries"?: ((_hidden: string[]) => any) | undefined;
+  "onActive-key-change"?: ((_details: import("@xihan-ui/headless").ChartActiveKeyChangeDetails) => any) | undefined;
+  "onUpdate:activeKey"?: ((_key: ChartKey | null) => any) | undefined;
+  "onDatum-active"?: ((_details: ChartDatumDetails | null) => any) | undefined;
+  "onDatum-press"?: ((_details: ChartDatumDetails) => any) | undefined;
+}>, {
+  pending: boolean;
+  animated: boolean;
+  rose: boolean;
+}, SlotsType<{
+  /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区、环形中心与空态）、提示框。 */
+  default?: (props: PieChartRootSlotProps) => VNode[];
+  /** 缺省结构里的标题内容。 */
+  caption?: () => VNode[];
+  /** 缺省结构里的环形中心内容。 */
+  center?: (props: PieChartCenterSlotProps) => VNode[];
+  /** 缺省结构里的提示框内容。 */
+  tooltip?: (props: PieChartTooltipSlotProps) => VNode[];
+  /** 缺省结构里的空态内容。 */
+  empty?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { PieChartCenterSlotProps, PieChartRootSlotProps, PieChartTooltipSlotProps, XhPieChartCaption, XhPieChartCenter, XhPieChartEmpty, XhPieChartLegend, XhPieChartPlot, XhPieChartRoot, XhPieChartTooltip, XhPieChartViewport };
+//# sourceMappingURL=pie-chart.d.ts.map

package/dist/components/pie-chart/pie-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pie-chart.d.ts","names":[],"sources":["../../../src/components/pie-chart/pie-chart.ts"],"mappings":";;;;KA+BK,gBAAgB;;KAGT,wBAAwB,KAAK;;UAGxB;EACf,QAAQ;EACR,SAAS;;;UAIM;EACf,QAAQ;EACR,QAAQ;;;cAmDG,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAa3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAS7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAUzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;;EAGf,WAAC,OAAO,4BAA4B;kCAchD;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;;EAGhB,WAAC,OAAO,6BAA6B;kCAWjD;;cAGW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;IAIA,MAAA,kBAAkB;;;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAEX,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAEP,MAAA,SAAS;;;;IAES,MAAA,SAAS,oBAAoB,SAAS;;;IAC5C,MAAA,SAAS,qBAAqB;;;IACrC,MAAA;;;IACO,MAAA;;;IACa,MAAA,SAAS;;;;;;;;;;;;;;IAI5B,MAAA,SAAS,QAAQ;;;;;EAId,yBAAA,UAAA,UAAU;EACZ,wBAAA,SAAA,UAAU;EACX,sBAAA,UAAA,UAAU;EACf,qBAAA,MAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;;;IA3Bb,MAAA,kBAAkB;;;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAEX,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAEP,MAAA,SAAS;;;;IAES,MAAA,SAAS,oBAAoB,SAAS;;;IAC5C,MAAA,SAAS,qBAAqB;;;IACrC,MAAA;;;IACO,MAAA;;;IACa,MAAA,SAAS;;;;;;;;;;;;;;IAI5B,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAavC,WAAC,OAAO,0BAA0B;;EAElC,gBAAM;;EAEP,UAAC,OAAO,4BAA4B;;EAEnC,WAAC,OAAO,6BAA6B;;EAEvC,cAAM;kCAgDhB"}

package/dist/components/pie-chart/pie-chart.js

@@ -0,0 +1,236 @@
+import { withXhConfig } from "../../config/config.js";
+import { providePieChart, usePieChartContext } from "./context.js";
+import { usePieChart } from "./use-pie-chart.js";
+import { defineComponent, h } from "vue";
+//#region src/components/pie-chart/pie-chart.ts
+/** 纹理定义：绘图区的第一个子节点，每种纹理一个 pattern、里面一条线。 */
+function renderDefs(api) {
+	return h("defs", api.getDefsProps(), api.patterns.map((pattern) => h("pattern", {
+		...api.getPatternProps(pattern),
+		key: pattern.id
+	}, [h("path", api.getPatternLineProps(pattern))])));
+}
+/** 一个场景标记画成 SVG 元素；文字标记带文字。 */
+function renderMark(api, mark) {
+	const props = {
+		...api.getMarkProps(mark),
+		key: mark.key
+	};
+	if (mark.kind === "group") return h("g", props, mark.children.map((child) => renderMark(api, child)));
+	if (mark.kind === "text") return h("text", props, mark.text);
+	return h("path", props);
+}
+/** 缺省的提示框内容：头部是扇区名，下面是数值与占比；「其他」另列出被合并的各项。 */
+function renderTooltipContent(api) {
+	const tooltip = api.tooltip;
+	if (!tooltip) return [];
+	return [h("div", api.getTooltipHeaderProps(), tooltip.header), ...tooltip.rows.map((row) => h("div", {
+		...api.getTooltipRowProps(row),
+		key: row.key
+	}, [
+		h("span", api.getTooltipSwatchProps(row)),
+		h("span", api.getTooltipValueProps(row), row.value),
+		h("span", api.getTooltipNameProps(row), row.name)
+	]))];
+}
+/** 摘要与数据表：由根自动生成、视觉隐藏，保证无障碍等价物始终存在。 */
+function renderA11y(api) {
+	const { columns, rows } = api.table;
+	return [h("p", api.getSummaryProps(), api.summary), h("table", api.getTableProps(), [
+		h("caption", api.tableCaption),
+		h("thead", [h("tr", columns.map((column) => h("th", {
+			key: column.id,
+			scope: "col"
+		}, column.label)))]),
+		h("tbody", rows.map((row, i) => h("tr", { key: i }, row.cells.map((cell, c) => c === 0 ? h("th", {
+			key: c,
+			scope: "row"
+		}, cell.text) : h("td", { key: c }, cell.text)))))
+	])];
+}
+/** 标题：图表的可及名来源。 */
+const XhPieChartCaption = defineComponent({
+	name: "XhPieChartCaption",
+	setup(_, { slots }) {
+		const ctx = usePieChartContext();
+		return () => h("figcaption", ctx.api.value.getCaptionProps(), slots.default?.());
+	}
+});
+/** 图例：项由组件按扇区生成；只有一个扇区时整条收起。 */
+const XhPieChartLegend = defineComponent({
+	name: "XhPieChartLegend",
+	setup() {
+		const ctx = usePieChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getLegendProps(), api.legendItems.map((item) => h("button", {
+				...api.getLegendItemProps(item),
+				key: item.id
+			}, [h("span", api.getLegendSwatchProps(item)), h("span", api.getLegendLabelProps(item), item.name)])));
+		};
+	}
+});
+/** 视口：尺寸观测的宿主，块尺寸由组件槽决定。 */
+const XhPieChartViewport = defineComponent({
+	name: "XhPieChartViewport",
+	setup(_, { slots }) {
+		const ctx = usePieChartContext();
+		return () => h("div", {
+			...ctx.api.value.getViewportProps(),
+			ref: (el) => {
+				ctx.viewportRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
+/** 绘图区：扇区在下，引导线与标签在上，焦点环最上。 */
+const XhPieChartPlot = defineComponent({
+	name: "XhPieChartPlot",
+	setup() {
+		const ctx = usePieChartContext();
+		return () => {
+			const api = ctx.api.value;
+			const marks = [
+				...api.scene.layers.data,
+				...api.scene.layers.front,
+				...api.overlay.over
+			];
+			return h("svg", api.getPlotProps(), [renderDefs(api), ...marks.map((mark) => renderMark(api, mark))]);
+		};
+	}
+});
+/** 环形中心：缺省显示可见扇区的合计，作用域插槽可替换。 */
+const XhPieChartCenter = defineComponent({
+	name: "XhPieChartCenter",
+	slots: Object,
+	setup(_, { slots }) {
+		const ctx = usePieChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getCenterProps(), slots.default ? slots.default({
+				center: api.center,
+				active: api.active
+			}) : [h("span", api.getCenterValueProps(), api.center.value), h("span", api.getCenterLabelProps(), api.center.label)]);
+		};
+	}
+});
+/** 提示框：缺省内容按激活的扇区生成，作用域插槽可替换。 */
+const XhPieChartTooltip = defineComponent({
+	name: "XhPieChartTooltip",
+	slots: Object,
+	setup(_, { slots }) {
+		const ctx = usePieChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getTooltipProps(), slots.default ? slots.default({
+				active: api.active,
+				tooltip: api.tooltip
+			}) : renderTooltipContent(api));
+		};
+	}
+});
+/** 空态：没有可画的扇区时显示，缺省文字取文案。 */
+const XhPieChartEmpty = defineComponent({
+	name: "XhPieChartEmpty",
+	setup(_, { slots }) {
+		const ctx = usePieChartContext();
+		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.() ?? ctx.api.value.emptyText);
+	}
+});
+/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */
+const XhPieChartRoot = defineComponent({
+	name: "XhPieChartRoot",
+	props: {
+		data: { type: Array },
+		nameField: { type: String },
+		valueField: { type: String },
+		variant: { type: String },
+		rose: {
+			type: Boolean,
+			default: void 0
+		},
+		sweep: { type: String },
+		sort: { type: String },
+		maxSlices: { type: Number },
+		labels: { type: String },
+		/** 扇区标签写什么：内建写法之一，或自己拼的函数。 */
+		labelContent: { type: [String, Function] },
+		format: { type: [Object, Function] },
+		hiddenSeries: { type: Array },
+		defaultHiddenSeries: { type: Array },
+		activeKey: { type: [
+			String,
+			Number,
+			Date,
+			null
+		] },
+		pending: {
+			type: Boolean,
+			default: void 0
+		},
+		animated: {
+			type: Boolean,
+			default: void 0
+		},
+		locale: { type: String },
+		translations: { type: Object }
+	},
+	emits: {
+		"hidden-series-change": (_details) => true,
+		"update:hiddenSeries": (_hidden) => true,
+		"active-key-change": (_details) => true,
+		"update:activeKey": (_key) => true,
+		"datum-active": (_details) => true,
+		"datum-press": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const ctx = usePieChart(withXhConfig("pie-chart", props), {
+			onHiddenSeriesChange: (details) => {
+				emit("hidden-series-change", details);
+				emit("update:hiddenSeries", details.hiddenSeries);
+			},
+			onActiveKeyChange: (details) => {
+				emit("active-key-change", details);
+				emit("update:activeKey", details.activeKey);
+			},
+			onDatumActive: (details) => emit("datum-active", details),
+			onDatumPress: (details) => emit("datum-press", details)
+		});
+		providePieChart(ctx);
+		return () => {
+			const api = ctx.api.value;
+			const content = slots.default ? slots.default({
+				legendItems: api.legendItems,
+				active: api.active,
+				tooltip: api.tooltip,
+				center: api.center,
+				empty: api.empty,
+				table: api.table,
+				hiddenSeries: api.hiddenSeries,
+				activeKey: api.activeKey,
+				toggleSeries: api.toggleSeries,
+				setFocusedDatum: api.setFocusedDatum
+			}) : [
+				...slots.caption ? [h(XhPieChartCaption, null, () => slots.caption?.())] : [],
+				h(XhPieChartLegend),
+				h(XhPieChartViewport, null, () => [
+					h(XhPieChartPlot),
+					h(XhPieChartCenter, null, slots.center ? { default: slots.center } : void 0),
+					h(XhPieChartEmpty, null, slots.empty ? () => slots.empty?.() : void 0)
+				]),
+				h(XhPieChartTooltip, null, slots.tooltip ? { default: slots.tooltip } : void 0)
+			];
+			return h("figure", {
+				...api.getRootProps(),
+				ref: (el) => {
+					ctx.rootRef.value = el;
+				}
+			}, [...content, ...renderA11y(api)]);
+		};
+	}
+});
+//#endregion
+export { XhPieChartCaption, XhPieChartCenter, XhPieChartEmpty, XhPieChartLegend, XhPieChartPlot, XhPieChartRoot, XhPieChartTooltip, XhPieChartViewport };
+
+//# sourceMappingURL=pie-chart.js.map

package/dist/components/pie-chart/pie-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pie-chart.js","names":[],"sources":["../../../src/components/pie-chart/pie-chart.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// 提供 pie chart 相关实现。\n\nimport type {\n  ChartDatumDetails,\n  ChartKey,\n  ChartMark,\n  ChartRow,\n  NumberFormatSpec,\n  PieChartApi,\n  PieChartSchema,\n  PieChartTranslations,\n  PieLabelContent,\n  PieLabelDetails,\n  PieLabels,\n  PieSort,\n  PieSweep,\n  PieTooltipModel,\n  PieVariant,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { providePieChart, usePieChartContext } from './context'\nimport { usePieChart } from './use-pie-chart'\n\ntype PieChartProps = PieChartSchema['props']\n\n/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */\nexport type PieChartRootSlotProps = Pick<PieChartApi, 'legendItems' | 'active' | 'tooltip' | 'center' | 'empty' | 'hiddenSeries' | 'activeKey' | 'toggleSeries' | 'setFocusedDatum' | 'table'>\n\n/** 提示框插槽的载荷：激活的扇区与缺省的内容模型。 */\nexport interface PieChartTooltipSlotProps {\n  active: ChartDatumDetails | null\n  tooltip: PieTooltipModel | null\n}\n\n/** 环形中心插槽的载荷：可见扇区的合计与说明文字，以及激活的扇区。 */\nexport interface PieChartCenterSlotProps {\n  center: PieChartApi['center']\n  active: ChartDatumDetails | null\n}\n\n/** 纹理定义：绘图区的第一个子节点，每种纹理一个 pattern、里面一条线。 */\nfunction renderDefs(api: PieChartApi): VNode {\n  return h('defs', api.getDefsProps() as Record<string, unknown>, api.patterns.map(pattern =>\n    h('pattern', { ...api.getPatternProps(pattern) as Record<string, unknown>, key: pattern.id }, [\n      h('path', api.getPatternLineProps(pattern) as Record<string, unknown>),\n    ])))\n}\n\n/** 一个场景标记画成 SVG 元素；文字标记带文字。 */\nfunction renderMark(api: PieChartApi, mark: ChartMark): VNode {\n  const props = { ...api.getMarkProps(mark) as Record<string, unknown>, key: mark.key }\n  if (mark.kind === 'group')\n    return h('g', props, mark.children.map(child => renderMark(api, child)))\n  if (mark.kind === 'text')\n    return h('text', props, mark.text)\n  return h('path', props)\n}\n\n/** 缺省的提示框内容：头部是扇区名，下面是数值与占比；「其他」另列出被合并的各项。 */\nfunction renderTooltipContent(api: PieChartApi): VNode[] {\n  const tooltip = api.tooltip\n  if (!tooltip)\n    return []\n  return [\n    h('div', api.getTooltipHeaderProps() as Record<string, unknown>, tooltip.header),\n    ...tooltip.rows.map(row => h('div', { ...api.getTooltipRowProps(row) as Record<string, unknown>, key: row.key }, [\n      h('span', api.getTooltipSwatchProps(row) as Record<string, unknown>),\n      h('span', api.getTooltipValueProps(row) as Record<string, unknown>, row.value),\n      h('span', api.getTooltipNameProps(row) as Record<string, unknown>, row.name),\n    ])),\n  ]\n}\n\n/** 摘要与数据表：由根自动生成、视觉隐藏，保证无障碍等价物始终存在。 */\nfunction renderA11y(api: PieChartApi): VNode[] {\n  const { columns, rows } = api.table\n  return [\n    h('p', api.getSummaryProps() as Record<string, unknown>, api.summary),\n    h('table', api.getTableProps() as Record<string, unknown>, [\n      h('caption', api.tableCaption),\n      h('thead', [h('tr', columns.map(column => h('th', { key: column.id, scope: 'col' }, column.label)))]),\n      h('tbody', rows.map((row, i) => h('tr', { key: i }, row.cells.map((cell, c) =>\n        c === 0 ? h('th', { key: c, scope: 'row' }, cell.text) : h('td', { key: c }, cell.text))))),\n    ]),\n  ]\n}\n\n/** 标题：图表的可及名来源。 */\nexport const XhPieChartCaption = defineComponent({\n  name: 'XhPieChartCaption',\n  setup(_, { slots }) {\n    const ctx = usePieChartContext()\n    return () => h('figcaption', ctx.api.value.getCaptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 图例：项由组件按扇区生成；只有一个扇区时整条收起。 */\nexport const XhPieChartLegend = defineComponent({\n  name: 'XhPieChartLegend',\n  setup() {\n    const ctx = usePieChartContext()\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getLegendProps() as Record<string, unknown>, api.legendItems.map(item =>\n        h('button', { ...api.getLegendItemProps(item) as Record<string, unknown>, key: item.id }, [\n          h('span', api.getLegendSwatchProps(item) as Record<string, unknown>),\n          h('span', api.getLegendLabelProps(item) as Record<string, unknown>, item.name),\n        ])))\n    }\n  },\n})\n\n/** 视口：尺寸观测的宿主，块尺寸由组件槽决定。 */\nexport const XhPieChartViewport = defineComponent({\n  name: 'XhPieChartViewport',\n  setup(_, { slots }) {\n    const ctx = usePieChartContext()\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.viewportRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 绘图区：扇区在下，引导线与标签在上，焦点环最上。 */\nexport const XhPieChartPlot = defineComponent({\n  name: 'XhPieChartPlot',\n  setup() {\n    const ctx = usePieChartContext()\n    return () => {\n      const api = ctx.api.value\n      const marks = [...api.scene.layers.data, ...api.scene.layers.front, ...api.overlay.over]\n      return h('svg', api.getPlotProps() as Record<string, unknown>, [renderDefs(api), ...marks.map(mark => renderMark(api, mark))])\n    }\n  },\n})\n\n/** 环形中心：缺省显示可见扇区的合计，作用域插槽可替换。 */\nexport const XhPieChartCenter = defineComponent({\n  name: 'XhPieChartCenter',\n  slots: Object as SlotsType<{\n    default?: (props: PieChartCenterSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePieChartContext()\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getCenterProps() as Record<string, unknown>, slots.default\n        ? slots.default({ center: api.center, active: api.active })\n        : [\n            h('span', api.getCenterValueProps() as Record<string, unknown>, api.center.value),\n            h('span', api.getCenterLabelProps() as Record<string, unknown>, api.center.label),\n          ])\n    }\n  },\n})\n\n/** 提示框：缺省内容按激活的扇区生成，作用域插槽可替换。 */\nexport const XhPieChartTooltip = defineComponent({\n  name: 'XhPieChartTooltip',\n  slots: Object as SlotsType<{\n    default?: (props: PieChartTooltipSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePieChartContext()\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getTooltipProps() as Record<string, unknown>, slots.default\n        ? slots.default({ active: api.active, tooltip: api.tooltip })\n        : renderTooltipContent(api))\n    }\n  },\n})\n\n/** 空态：没有可画的扇区时显示，缺省文字取文案。 */\nexport const XhPieChartEmpty = defineComponent({\n  name: 'XhPieChartEmpty',\n  setup(_, { slots }) {\n    const ctx = usePieChartContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.emptyText)\n  },\n})\n\n/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */\nexport const XhPieChartRoot = defineComponent({\n  name: 'XhPieChartRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    data: { type: Array as PropType<readonly ChartRow[]> },\n    nameField: { type: String },\n    valueField: { type: String },\n    variant: { type: String as PropType<PieVariant> },\n    rose: { type: Boolean, default: undefined },\n    sweep: { type: String as PropType<PieSweep> },\n    sort: { type: String as PropType<PieSort> },\n    maxSlices: { type: Number },\n    labels: { type: String as PropType<PieLabels> },\n    /** 扇区标签写什么：内建写法之一，或自己拼的函数。 */\n    labelContent: { type: [String, Function] as PropType<PieLabelContent | ((details: PieLabelDetails) => string)> },\n    format: { type: [Object, Function] as PropType<NumberFormatSpec | ((value: number) => string)> },\n    hiddenSeries: { type: Array as PropType<string[]> },\n    defaultHiddenSeries: { type: Array as PropType<string[]> },\n    activeKey: { type: [String, Number, Date, null] as PropType<ChartKey | null> },\n    pending: { type: Boolean, default: undefined },\n    animated: { type: Boolean, default: undefined },\n    locale: { type: String },\n    translations: { type: Object as PropType<Partial<PieChartTranslations>> },\n  },\n  // hidden-series-change / active-key-change 携带 details；update:* 携带裸值，支持 v-model\n  emits: {\n    'hidden-series-change': (_details: PayloadOf<PieChartProps, 'onHiddenSeriesChange'>) => true,\n    'update:hiddenSeries': (_hidden: PayloadOf<PieChartProps, 'onHiddenSeriesChange'>['hiddenSeries']) => true,\n    'active-key-change': (_details: PayloadOf<PieChartProps, 'onActiveKeyChange'>) => true,\n    'update:activeKey': (_key: PayloadOf<PieChartProps, 'onActiveKeyChange'>['activeKey']) => true,\n    'datum-active': (_details: PayloadOf<PieChartProps, 'onDatumActive'>) => true,\n    'datum-press': (_details: PayloadOf<PieChartProps, 'onDatumPress'>) => true,\n  },\n  slots: Object as SlotsType<{\n    /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区、环形中心与空态）、提示框。 */\n    default?: (props: PieChartRootSlotProps) => VNode[]\n    /** 缺省结构里的标题内容。 */\n    caption?: () => VNode[]\n    /** 缺省结构里的环形中心内容。 */\n    center?: (props: PieChartCenterSlotProps) => VNode[]\n    /** 缺省结构里的提示框内容。 */\n    tooltip?: (props: PieChartTooltipSlotProps) => VNode[]\n    /** 缺省结构里的空态内容。 */\n    empty?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = usePieChart(withXhConfig('pie-chart', props) as PieChartProps, {\n      onHiddenSeriesChange: (details) => {\n        emit('hidden-series-change', details)\n        emit('update:hiddenSeries', details.hiddenSeries)\n      },\n      onActiveKeyChange: (details) => {\n        emit('active-key-change', details)\n        emit('update:activeKey', details.activeKey)\n      },\n      onDatumActive: details => emit('datum-active', details),\n      onDatumPress: details => emit('datum-press', details),\n    })\n    providePieChart(ctx)\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default\n        ? slots.default({\n            legendItems: api.legendItems,\n            active: api.active,\n            tooltip: api.tooltip,\n            center: api.center,\n            empty: api.empty,\n            table: api.table,\n            hiddenSeries: api.hiddenSeries,\n            activeKey: api.activeKey,\n            toggleSeries: api.toggleSeries,\n            setFocusedDatum: api.setFocusedDatum,\n          })\n        : [\n            ...(slots.caption ? [h(XhPieChartCaption, null, () => slots.caption?.())] : []),\n            h(XhPieChartLegend),\n            // 环形中心与空态放进视口：叠在绘图区上，标题与图例不被盖住\n            h(XhPieChartViewport, null, () => [\n              h(XhPieChartPlot),\n              h(XhPieChartCenter, null, slots.center ? { default: slots.center } : undefined),\n              h(XhPieChartEmpty, null, slots.empty ? () => slots.empty?.() : undefined),\n            ]),\n            h(XhPieChartTooltip, null, slots.tooltip ? { default: slots.tooltip } : undefined),\n          ]\n      return h('figure', {\n        ...api.getRootProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n      }, [...content, ...renderA11y(api)])\n    }\n  },\n})\n"],"mappings":"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"}

package/dist/components/pie-chart/use-pie-chart.d.ts

@@ -0,0 +1,19 @@
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+import { PieChartApi, PieChartSchema } from "@xihan-ui/headless";
+//#region src/components/pie-chart/use-pie-chart.d.ts
+/** 对外的回调：由外壳（emit）或组合式调用方提供，随 props 一并喂给机器。 */
+type PieChartNotifiers = Pick<PieChartSchema['props'], 'onHiddenSeriesChange' | 'onActiveKeyChange' | 'onDatumActive' | 'onDatumPress'>;
+interface PieChartContext {
+  api: ComputedRef<PieChartApi>;
+  service: Service<PieChartSchema>;
+  /** 根：机器在它上面读度量私有槽。 */
+  rootRef: Ref<HTMLElement | null>;
+  /** 视口：尺寸观测的宿主。 */
+  viewportRef: Ref<HTMLElement | null>;
+}
+/** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
+declare function usePieChart(props: PieChartSchema['props'], notify?: PieChartNotifiers): PieChartContext;
+//#endregion
+export { PieChartContext, PieChartNotifiers, usePieChart };
+//# sourceMappingURL=use-pie-chart.d.ts.map

package/dist/components/pie-chart/use-pie-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pie-chart.d.ts","names":[],"sources":["../../../src/components/pie-chart/use-pie-chart.ts"],"mappings":";;;;;KAgBY,oBAAoB,KAC9B;UAIe;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;EAEb,aAAa,IAAI;;;iBAIH,YACd,OAAO,yBACP,SAAS,oBACR"}

package/dist/components/pie-chart/use-pie-chart.js

@@ -0,0 +1,26 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { computed, ref } from "vue";
+import { connectPieChart, pieChartMachine } from "@xihan-ui/headless";
+//#region src/components/pie-chart/use-pie-chart.ts
+/** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
+function usePieChart(props, notify) {
+	const rootRef = ref(null);
+	const viewportRef = ref(null);
+	const service = useMachine(pieChartMachine, () => ({
+		...props,
+		...notify
+	}));
+	service.refs.set("getRootEl", () => rootRef.value);
+	service.refs.set("getViewportEl", () => viewportRef.value);
+	return {
+		api: computed(() => connectPieChart(service, vueNormalize)),
+		service,
+		rootRef,
+		viewportRef
+	};
+}
+//#endregion
+export { usePieChart };
+
+//# sourceMappingURL=use-pie-chart.js.map

package/dist/components/pie-chart/use-pie-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pie-chart.js","names":[],"sources":["../../../src/components/pie-chart/use-pie-chart.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 pie chart 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { PieChartApi, PieChartSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectPieChart, pieChartMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\n/** 对外的回调：由外壳（emit）或组合式调用方提供，随 props 一并喂给机器。 */\nexport type PieChartNotifiers = Pick<\n  PieChartSchema['props'],\n  'onHiddenSeriesChange' | 'onActiveKeyChange' | 'onDatumActive' | 'onDatumPress'\n>\n\nexport interface PieChartContext {\n  api: ComputedRef<PieChartApi>\n  service: Service<PieChartSchema>\n  /** 根：机器在它上面读度量私有槽。 */\n  rootRef: Ref<HTMLElement | null>\n  /** 视口：尺寸观测的宿主。 */\n  viewportRef: Ref<HTMLElement | null>\n}\n\n/** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */\nexport function usePieChart(\n  props: PieChartSchema['props'],\n  notify?: PieChartNotifiers,\n): PieChartContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const viewportRef = ref<HTMLElement | null>(null)\n  // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n  const service = useMachine(pieChartMachine, () => ({ ...props, ...notify }))\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  const api = computed(() => connectPieChart(service, vueNormalize))\n  return { api, service, rootRef, viewportRef }\n}\n"],"mappings":";;;;;;AA+BA,SAAgB,YACd,OACA,QACiB;CACjB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAO,EAAE;CAC3E,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CAEzD,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;EAAS;EAAS;CAAY;AAC9C"}

package/dist/components/popconfirm/popconfirm.js

@@ -1,7 +1,7 @@
-import { XhPortal } from "../../runtime/portal.js";
-import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
+import { XhPortal } from "../../runtime/portal.js";
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { providePopconfirm, usePopconfirmContext } from "./context.js";
 import { usePopconfirm } from "./use-popconfirm.js";
 import { defineComponent, h, mergeProps } from "vue";

package/dist/components/popover/popover.d.ts

@@ -34,6 +34,11 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: boolean;
   };
+  /** 浮层不可打开：触发器转原生 disabled。 */
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<PopoverProps["translations"]>;
   };
@@ -73,6 +78,11 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: boolean;
   };
+  /** 浮层不可打开：触发器转原生 disabled。 */
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<PopoverProps["translations"]>;
   };
@@ -83,6 +93,7 @@ declare const XhPopoverRoot: import("vue").DefineComponent<import("vue").Extract
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").PopoverOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
+  disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
   modal: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAbJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,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;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"popover.d.ts","names":[],"sources":["../../../src/components/popover/popover.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAfJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMA,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,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;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/popover/popover.js

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
-import { XhPortal } from "../../runtime/portal.js";
-import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
+import { XhPortal } from "../../runtime/portal.js";
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { providePopover, usePopoverContext } from "./context.js";
 import { usePopover } from "./use-popover.js";
 import { defineComponent, h, mergeProps } from "vue";
@@ -31,6 +31,11 @@ const XhPopoverRoot = defineComponent({
 			type: Boolean,
 			default: true
 		},
+		/** 浮层不可打开：触发器转原生 disabled。 */
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
 		translations: { type: Object },
 		size: { type: String }
 	},