@xihan-ui/vue 2.1.0 → 3.1.0

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

@@ -0,0 +1,201 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { ChartDatumDetails, ChartKey, ChartPalette, ChartRow, HierarchyChartApi, HierarchyChartSchema, HierarchyChartTranslations, HierarchyColorBy, HierarchyLayout, HierarchyTile, HierarchyTooltipModel, NumberFormatSpec } from "@xihan-ui/headless";
+//#region src/components/hierarchy-chart/hierarchy-chart.d.ts
+type HierarchyChartProps = HierarchyChartSchema['props'];
+/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
+type HierarchyChartRootSlotProps = Pick<HierarchyChartApi, 'active' | 'tooltip' | 'empty' | 'path' | 'rootKey' | 'activeKey' | 'drillTo' | 'drillUp' | 'setFocusedDatum' | 'table'>;
+/** 提示框插槽的载荷：激活的节点与缺省的内容模型。 */
+interface HierarchyChartTooltipSlotProps {
+  active: ChartDatumDetails | null;
+  tooltip: HierarchyTooltipModel | null;
+}
+/** 标题：图表的可及名来源。 */
+declare const XhHierarchyChartCaption: 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 XhHierarchyChartPath: 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 XhHierarchyChartLegend: 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 XhHierarchyChartViewport: 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 XhHierarchyChartPlot: 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 XhHierarchyChartTooltip: 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: HierarchyChartTooltipSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 空态：没有可画的数据时显示，缺省文字取文案。 */
+declare const XhHierarchyChartEmpty: 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 XhHierarchyChartRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<ChartRow | readonly ChartRow[]>;
+  };
+  childrenField: {
+    type: StringConstructor;
+  };
+  idField: {
+    type: StringConstructor;
+  };
+  parentField: {
+    type: StringConstructor;
+  };
+  nameField: {
+    type: StringConstructor;
+  };
+  valueField: {
+    type: StringConstructor;
+  };
+  layout: {
+    type: PropType<HierarchyLayout>;
+  };
+  tile: {
+    type: PropType<HierarchyTile>;
+  };
+  depth: {
+    type: NumberConstructor;
+  };
+  colorBy: {
+    type: PropType<HierarchyColorBy>;
+  };
+  palette: {
+    type: PropType<ChartPalette>;
+  };
+  orientation: {
+    type: PropType<"vertical" | "horizontal">;
+  };
+  rootKey: {
+    type: PropType<string | null>;
+  };
+  defaultRootKey: {
+    type: PropType<string | null>;
+  };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  activeKey: {
+    type: PropType<ChartKey | null>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  animated: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  translations: {
+    type: PropType<Partial<HierarchyChartTranslations>>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'root-key-change': (_details: PayloadOf<HierarchyChartProps, "onRootKeyChange">) => true;
+  'update:rootKey': (_key: PayloadOf<HierarchyChartProps, "onRootKeyChange">["rootKey"]) => true;
+  'active-key-change': (_details: PayloadOf<HierarchyChartProps, "onActiveKeyChange">) => true;
+  'update:activeKey': (_key: PayloadOf<HierarchyChartProps, "onActiveKeyChange">["activeKey"]) => true;
+  'datum-active': (_details: PayloadOf<HierarchyChartProps, "onDatumActive">) => true;
+  'datum-press': (_details: PayloadOf<HierarchyChartProps, "onDatumPress">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<ChartRow | readonly ChartRow[]>;
+  };
+  childrenField: {
+    type: StringConstructor;
+  };
+  idField: {
+    type: StringConstructor;
+  };
+  parentField: {
+    type: StringConstructor;
+  };
+  nameField: {
+    type: StringConstructor;
+  };
+  valueField: {
+    type: StringConstructor;
+  };
+  layout: {
+    type: PropType<HierarchyLayout>;
+  };
+  tile: {
+    type: PropType<HierarchyTile>;
+  };
+  depth: {
+    type: NumberConstructor;
+  };
+  colorBy: {
+    type: PropType<HierarchyColorBy>;
+  };
+  palette: {
+    type: PropType<ChartPalette>;
+  };
+  orientation: {
+    type: PropType<"vertical" | "horizontal">;
+  };
+  rootKey: {
+    type: PropType<string | null>;
+  };
+  defaultRootKey: {
+    type: PropType<string | null>;
+  };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  activeKey: {
+    type: PropType<ChartKey | null>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  animated: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  translations: {
+    type: PropType<Partial<HierarchyChartTranslations>>;
+  };
+}>> & Readonly<{
+  "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;
+  "onRoot-key-change"?: ((_details: import("@xihan-ui/headless").HierarchyRootKeyChangeDetails) => any) | undefined;
+  "onUpdate:rootKey"?: ((_key: string | null) => any) | undefined;
+}>, {
+  pending: boolean;
+  animated: boolean;
+}, SlotsType<{
+  /** 自行摆放部件；不写时铺开缺省结构：下钻路径、视口（绘图区与空态）、提示框。 */
+  default?: (props: HierarchyChartRootSlotProps) => VNode[];
+  /** 缺省结构里的标题内容。 */
+  caption?: () => VNode[];
+  /** 缺省结构里的提示框内容。 */
+  tooltip?: (props: HierarchyChartTooltipSlotProps) => VNode[];
+  /** 缺省结构里的空态内容。 */
+  empty?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { HierarchyChartRootSlotProps, HierarchyChartTooltipSlotProps, XhHierarchyChartCaption, XhHierarchyChartEmpty, XhHierarchyChartLegend, XhHierarchyChartPath, XhHierarchyChartPlot, XhHierarchyChartRoot, XhHierarchyChartTooltip, XhHierarchyChartViewport };
+//# sourceMappingURL=hierarchy-chart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-chart.d.ts","names":[],"sources":["../../../src/components/hierarchy-chart/hierarchy-chart.ts"],"mappings":";;;;KA6BK,sBAAsB;;KAGf,8BAA8B,KAAK;;UAG9B;EACf,QAAQ;EACR,SAAS;;;cA2CE,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAejC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BASnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;;EAGtB,WAAC,OAAO,mCAAmC;kCAWvD;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,8BAAA;;IAII,MAAA,SAAS,oBAAoB;;;;;;;;;;;;;;;;;;IAMpC,MAAA,SAAS;;;IACX,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACL,MAAA;;;IACI,MAAA;;;IACO,MAAA;;;IACJ,MAAA,SAAS,qBAAqB;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAI5B,MAAA,SAAS,QAAQ;;;;;EAInB,oBAAA,UAAA,UAAU;EACf,mBAAA,MAAA,UAAU;EACH,sBAAA,UAAA,UAAU;EACf,qBAAA,MAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;;;IA5BH,MAAA,SAAS,oBAAoB;;;;;;;;;;;;;;;;;;IAMpC,MAAA,SAAS;;;IACX,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACL,MAAA;;;IACI,MAAA;;;IACO,MAAA;;;IACJ,MAAA,SAAS,qBAAqB;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAI5B,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;EAavC,WAAC,OAAO,gCAAgC;;EAExC,gBAAM;;EAEN,WAAC,OAAO,mCAAmC;;EAE7C,cAAM;kCAgDhB"}

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

@@ -0,0 +1,228 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideHierarchyChart, useHierarchyChartContext } from "./context.js";
+import { useHierarchyChart } from "./use-hierarchy-chart.js";
+import { defineComponent, h } from "vue";
+//#region src/components/hierarchy-chart/hierarchy-chart.ts
+/** 一个场景标记画成 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 XhHierarchyChartCaption = defineComponent({
+	name: "XhHierarchyChartCaption",
+	setup(_, { slots }) {
+		const ctx = useHierarchyChartContext();
+		return () => h("figcaption", ctx.api.value.getCaptionProps(), slots.default?.());
+	}
+});
+/** 下钻路径：从最顶层到当前的根，每一项是一个按钮；还在最顶层时收起。 */
+const XhHierarchyChartPath = defineComponent({
+	name: "XhHierarchyChartPath",
+	setup() {
+		const ctx = useHierarchyChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("nav", api.getPathProps(), api.path.map((item) => h("button", {
+				...api.getPathItemProps(item),
+				key: item.key ?? ""
+			}, item.name)));
+		};
+	}
+});
+/** 图例：按值着色时每个看得见的层一条色阶（名字、低端的值、渐变条、高端的值）；其余着色方式收起。 */
+const XhHierarchyChartLegend = defineComponent({
+	name: "XhHierarchyChartLegend",
+	setup() {
+		const ctx = useHierarchyChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getLegendProps(), api.legendScales.map((scale) => h("div", {
+				...api.getLegendScaleProps(scale),
+				key: scale.level
+			}, [
+				h("span", api.getLegendScaleNameProps(), scale.name),
+				h("span", api.getLegendScaleValueProps("min"), scale.min),
+				h("span", api.getLegendScaleBarProps()),
+				h("span", api.getLegendScaleValueProps("max"), scale.max)
+			])));
+		};
+	}
+});
+/** 视口：尺寸观测的宿主，块尺寸由组件槽决定。 */
+const XhHierarchyChartViewport = defineComponent({
+	name: "XhHierarchyChartViewport",
+	setup(_, { slots }) {
+		const ctx = useHierarchyChartContext();
+		return () => h("div", {
+			...ctx.api.value.getViewportProps(),
+			ref: (el) => {
+				ctx.viewportRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
+/** 绘图区：节点由浅到深，名字与分组标题在上，焦点环最上。 */
+const XhHierarchyChartPlot = defineComponent({
+	name: "XhHierarchyChartPlot",
+	setup() {
+		const ctx = useHierarchyChartContext();
+		return () => {
+			const api = ctx.api.value;
+			const marks = [
+				...api.scene.layers.data,
+				...api.scene.layers.front,
+				...api.overlay.over
+			];
+			return h("svg", api.getPlotProps(), marks.map((mark) => renderMark(api, mark)));
+		};
+	}
+});
+/** 提示框：缺省内容按激活的节点生成，作用域插槽可替换。 */
+const XhHierarchyChartTooltip = defineComponent({
+	name: "XhHierarchyChartTooltip",
+	slots: Object,
+	setup(_, { slots }) {
+		const ctx = useHierarchyChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getTooltipProps(), slots.default ? slots.default({
+				active: api.active,
+				tooltip: api.tooltip
+			}) : renderTooltipContent(api));
+		};
+	}
+});
+/** 空态：没有可画的数据时显示，缺省文字取文案。 */
+const XhHierarchyChartEmpty = defineComponent({
+	name: "XhHierarchyChartEmpty",
+	setup(_, { slots }) {
+		const ctx = useHierarchyChartContext();
+		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.() ?? ctx.api.value.emptyText);
+	}
+});
+/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */
+const XhHierarchyChartRoot = defineComponent({
+	name: "XhHierarchyChartRoot",
+	props: {
+		data: { type: [Object, Array] },
+		childrenField: { type: String },
+		idField: { type: String },
+		parentField: { type: String },
+		nameField: { type: String },
+		valueField: { type: String },
+		layout: { type: String },
+		tile: { type: String },
+		depth: { type: Number },
+		colorBy: { type: String },
+		palette: { type: String },
+		orientation: { type: String },
+		rootKey: { type: [String, null] },
+		defaultRootKey: { type: [String, null] },
+		format: { type: [Object, Function] },
+		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: {
+		"root-key-change": (_details) => true,
+		"update:rootKey": (_key) => 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 = useHierarchyChart(withXhConfig("hierarchy-chart", props), {
+			onRootKeyChange: (details) => {
+				emit("root-key-change", details);
+				emit("update:rootKey", details.rootKey);
+			},
+			onActiveKeyChange: (details) => {
+				emit("active-key-change", details);
+				emit("update:activeKey", details.activeKey);
+			},
+			onDatumActive: (details) => emit("datum-active", details),
+			onDatumPress: (details) => emit("datum-press", details)
+		});
+		provideHierarchyChart(ctx);
+		return () => {
+			const api = ctx.api.value;
+			const content = slots.default ? slots.default({
+				active: api.active,
+				tooltip: api.tooltip,
+				empty: api.empty,
+				table: api.table,
+				path: api.path,
+				rootKey: api.rootKey,
+				activeKey: api.activeKey,
+				drillTo: api.drillTo,
+				drillUp: api.drillUp,
+				setFocusedDatum: api.setFocusedDatum
+			}) : [
+				...slots.caption ? [h(XhHierarchyChartCaption, null, () => slots.caption?.())] : [],
+				h(XhHierarchyChartPath),
+				h(XhHierarchyChartLegend),
+				h(XhHierarchyChartViewport, null, () => [h(XhHierarchyChartPlot), h(XhHierarchyChartEmpty, null, slots.empty ? () => slots.empty?.() : void 0)]),
+				h(XhHierarchyChartTooltip, null, slots.tooltip ? { default: slots.tooltip } : void 0)
+			];
+			return h("figure", {
+				...api.getRootProps(),
+				ref: (el) => {
+					ctx.rootRef.value = el;
+				}
+			}, [...content, ...renderA11y(api)]);
+		};
+	}
+});
+//#endregion
+export { XhHierarchyChartCaption, XhHierarchyChartEmpty, XhHierarchyChartLegend, XhHierarchyChartPath, XhHierarchyChartPlot, XhHierarchyChartRoot, XhHierarchyChartTooltip, XhHierarchyChartViewport };
+
+//# sourceMappingURL=hierarchy-chart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-chart.js","names":[],"sources":["../../../src/components/hierarchy-chart/hierarchy-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// 提供 hierarchy chart 相关实现。\n\nimport type {\n  ChartDatumDetails,\n  ChartKey,\n  ChartMark,\n  ChartPalette,\n  ChartRow,\n  HierarchyChartApi,\n  HierarchyChartSchema,\n  HierarchyChartTranslations,\n  HierarchyColorBy,\n  HierarchyLayout,\n  HierarchyTile,\n  HierarchyTooltipModel,\n  NumberFormatSpec,\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 { provideHierarchyChart, useHierarchyChartContext } from './context'\nimport { useHierarchyChart } from './use-hierarchy-chart'\n\ntype HierarchyChartProps = HierarchyChartSchema['props']\n\n/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */\nexport type HierarchyChartRootSlotProps = Pick<HierarchyChartApi, 'active' | 'tooltip' | 'empty' | 'path' | 'rootKey' | 'activeKey' | 'drillTo' | 'drillUp' | 'setFocusedDatum' | 'table'>\n\n/** 提示框插槽的载荷：激活的节点与缺省的内容模型。 */\nexport interface HierarchyChartTooltipSlotProps {\n  active: ChartDatumDetails | null\n  tooltip: HierarchyTooltipModel | null\n}\n\n/** 一个场景标记画成 SVG 元素；文字标记带文字。 */\nfunction renderMark(api: HierarchyChartApi, 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: HierarchyChartApi): 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: HierarchyChartApi): 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 XhHierarchyChartCaption = defineComponent({\n  name: 'XhHierarchyChartCaption',\n  setup(_, { slots }) {\n    const ctx = useHierarchyChartContext()\n    return () => h('figcaption', ctx.api.value.getCaptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 下钻路径：从最顶层到当前的根，每一项是一个按钮；还在最顶层时收起。 */\nexport const XhHierarchyChartPath = defineComponent({\n  name: 'XhHierarchyChartPath',\n  setup() {\n    const ctx = useHierarchyChartContext()\n    return () => {\n      const api = ctx.api.value\n      return h('nav', api.getPathProps() as Record<string, unknown>, api.path.map(item =>\n        h('button', { ...api.getPathItemProps(item) as Record<string, unknown>, key: item.key ?? '' }, item.name)))\n    }\n  },\n})\n\n/** 图例：按值着色时每个看得见的层一条色阶（名字、低端的值、渐变条、高端的值）；其余着色方式收起。 */\nexport const XhHierarchyChartLegend = defineComponent({\n  name: 'XhHierarchyChartLegend',\n  setup() {\n    const ctx = useHierarchyChartContext()\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getLegendProps() as Record<string, unknown>, api.legendScales.map(scale =>\n        h('div', { ...api.getLegendScaleProps(scale) as Record<string, unknown>, key: scale.level }, [\n          h('span', api.getLegendScaleNameProps() as Record<string, unknown>, scale.name),\n          h('span', api.getLegendScaleValueProps('min') as Record<string, unknown>, scale.min),\n          h('span', api.getLegendScaleBarProps() as Record<string, unknown>),\n          h('span', api.getLegendScaleValueProps('max') as Record<string, unknown>, scale.max),\n        ])))\n    }\n  },\n})\n\n/** 视口：尺寸观测的宿主，块尺寸由组件槽决定。 */\nexport const XhHierarchyChartViewport = defineComponent({\n  name: 'XhHierarchyChartViewport',\n  setup(_, { slots }) {\n    const ctx = useHierarchyChartContext()\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 XhHierarchyChartPlot = defineComponent({\n  name: 'XhHierarchyChartPlot',\n  setup() {\n    const ctx = useHierarchyChartContext()\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>, marks.map(mark => renderMark(api, mark)))\n    }\n  },\n})\n\n/** 提示框：缺省内容按激活的节点生成，作用域插槽可替换。 */\nexport const XhHierarchyChartTooltip = defineComponent({\n  name: 'XhHierarchyChartTooltip',\n  slots: Object as SlotsType<{\n    default?: (props: HierarchyChartTooltipSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useHierarchyChartContext()\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 XhHierarchyChartEmpty = defineComponent({\n  name: 'XhHierarchyChartEmpty',\n  setup(_, { slots }) {\n    const ctx = useHierarchyChartContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.emptyText)\n  },\n})\n\n/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */\nexport const XhHierarchyChartRoot = defineComponent({\n  name: 'XhHierarchyChartRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    data: { type: [Object, Array] as PropType<ChartRow | readonly ChartRow[]> },\n    childrenField: { type: String },\n    idField: { type: String },\n    parentField: { type: String },\n    nameField: { type: String },\n    valueField: { type: String },\n    layout: { type: String as PropType<HierarchyLayout> },\n    tile: { type: String as PropType<HierarchyTile> },\n    depth: { type: Number },\n    colorBy: { type: String as PropType<HierarchyColorBy> },\n    palette: { type: String as PropType<ChartPalette> },\n    orientation: { type: String as PropType<'vertical' | 'horizontal'> },\n    rootKey: { type: [String, null] as PropType<string | null> },\n    defaultRootKey: { type: [String, null] as PropType<string | null> },\n    format: { type: [Object, Function] as PropType<NumberFormatSpec | ((value: number) => 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<HierarchyChartTranslations>> },\n  },\n  // root-key-change / active-key-change 携带 details；update:* 携带裸值，支持 v-model\n  emits: {\n    'root-key-change': (_details: PayloadOf<HierarchyChartProps, 'onRootKeyChange'>) => true,\n    'update:rootKey': (_key: PayloadOf<HierarchyChartProps, 'onRootKeyChange'>['rootKey']) => true,\n    'active-key-change': (_details: PayloadOf<HierarchyChartProps, 'onActiveKeyChange'>) => true,\n    'update:activeKey': (_key: PayloadOf<HierarchyChartProps, 'onActiveKeyChange'>['activeKey']) => true,\n    'datum-active': (_details: PayloadOf<HierarchyChartProps, 'onDatumActive'>) => true,\n    'datum-press': (_details: PayloadOf<HierarchyChartProps, 'onDatumPress'>) => true,\n  },\n  slots: Object as SlotsType<{\n    /** 自行摆放部件；不写时铺开缺省结构：下钻路径、视口（绘图区与空态）、提示框。 */\n    default?: (props: HierarchyChartRootSlotProps) => VNode[]\n    /** 缺省结构里的标题内容。 */\n    caption?: () => VNode[]\n    /** 缺省结构里的提示框内容。 */\n    tooltip?: (props: HierarchyChartTooltipSlotProps) => VNode[]\n    /** 缺省结构里的空态内容。 */\n    empty?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useHierarchyChart(withXhConfig('hierarchy-chart', props) as HierarchyChartProps, {\n      onRootKeyChange: (details) => {\n        emit('root-key-change', details)\n        emit('update:rootKey', details.rootKey)\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    provideHierarchyChart(ctx)\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default\n        ? slots.default({\n            active: api.active,\n            tooltip: api.tooltip,\n            empty: api.empty,\n            table: api.table,\n            path: api.path,\n            rootKey: api.rootKey,\n            activeKey: api.activeKey,\n            drillTo: api.drillTo,\n            drillUp: api.drillUp,\n            setFocusedDatum: api.setFocusedDatum,\n          })\n        : [\n            ...(slots.caption ? [h(XhHierarchyChartCaption, null, () => slots.caption?.())] : []),\n            h(XhHierarchyChartPath),\n            h(XhHierarchyChartLegend),\n            // 空态放进视口：叠在绘图区上，标题与路径不被盖住\n            h(XhHierarchyChartViewport, null, () => [\n              h(XhHierarchyChartPlot),\n              h(XhHierarchyChartEmpty, null, slots.empty ? () => slots.empty?.() : undefined),\n            ]),\n            h(XhHierarchyChartTooltip, 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/hierarchy-chart/use-hierarchy-chart.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-hierarchy-chart.d.ts","names":[],"sources":["../../../src/components/hierarchy-chart/use-hierarchy-chart.ts"],"mappings":";;;;;KAgBY,0BAA0B,KACpC;UAIe;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;EAEb,aAAa,IAAI;;;iBAIH,kBACd,OAAO,+BACP,SAAS,0BACR"}

package/dist/components/hierarchy-chart/use-hierarchy-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 { connectHierarchyChart, hierarchyChartMachine } from "@xihan-ui/headless";
+//#region src/components/hierarchy-chart/use-hierarchy-chart.ts
+/** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
+function useHierarchyChart(props, notify) {
+	const rootRef = ref(null);
+	const viewportRef = ref(null);
+	const service = useMachine(hierarchyChartMachine, () => ({
+		...props,
+		...notify
+	}));
+	service.refs.set("getRootEl", () => rootRef.value);
+	service.refs.set("getViewportEl", () => viewportRef.value);
+	return {
+		api: computed(() => connectHierarchyChart(service, vueNormalize)),
+		service,
+		rootRef,
+		viewportRef
+	};
+}
+//#endregion
+export { useHierarchyChart };
+
+//# sourceMappingURL=use-hierarchy-chart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-hierarchy-chart.js","names":[],"sources":["../../../src/components/hierarchy-chart/use-hierarchy-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 hierarchy chart 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { HierarchyChartApi, HierarchyChartSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectHierarchyChart, hierarchyChartMachine } 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 HierarchyChartNotifiers = Pick<\n  HierarchyChartSchema['props'],\n  'onRootKeyChange' | 'onActiveKeyChange' | 'onDatumActive' | 'onDatumPress'\n>\n\nexport interface HierarchyChartContext {\n  api: ComputedRef<HierarchyChartApi>\n  service: Service<HierarchyChartSchema>\n  /** 根：机器在它上面读度量私有槽。 */\n  rootRef: Ref<HTMLElement | null>\n  /** 视口：尺寸观测的宿主。 */\n  viewportRef: Ref<HTMLElement | null>\n}\n\n/** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */\nexport function useHierarchyChart(\n  props: HierarchyChartSchema['props'],\n  notify?: HierarchyChartNotifiers,\n): HierarchyChartContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const viewportRef = ref<HTMLElement | null>(null)\n  // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n  const service = useMachine(hierarchyChartMachine, () => ({ ...props, ...notify }))\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  const api = computed(() => connectHierarchyChart(service, vueNormalize))\n  return { api, service, rootRef, viewportRef }\n}\n"],"mappings":";;;;;;AA+BA,SAAgB,kBACd,OACA,QACuB;CACvB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,UAAU,WAAW,8BAA8B;EAAE,GAAG;EAAO,GAAG;CAAO,EAAE;CACjF,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CAEzD,OAAO;EAAE,KADG,eAAe,sBAAsB,SAAS,YAAY,CAC3D;EAAG;EAAS;EAAS;CAAY;AAC9C"}

package/dist/components/hover-card/hover-card.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 { provideHoverCard, useHoverCardContext } from "./context.js";
 import { useHoverCard } from "./use-hover-card.js";
 import { defineComponent, h, mergeProps } from "vue";

package/dist/components/icon/icon.d.ts

@@ -1,5 +1,5 @@
 import { PropType, VNode } from "vue";
-import { IconRecord, Tone } from "@xihan-ui/core";
+import { ActionVariant, IconRecord, Tone } from "@xihan-ui/core";
 import { IconFlip, IconRotate, IconSize, IconWeight } from "@xihan-ui/headless";
 //#region src/components/icon/icon.d.ts
 /**
@@ -24,6 +24,9 @@ declare const XhIcon: import("vue").DefineComponent<import("vue").ExtractPropTyp
   tone: {
     type: PropType<Tone>;
   };
+  frame: {
+    type: PropType<ActionVariant>;
+  };
   rotate: {
     type: PropType<IconRotate | string>;
   };
@@ -48,6 +51,9 @@ declare const XhIcon: import("vue").DefineComponent<import("vue").ExtractPropTyp
   tone: {
     type: PropType<Tone>;
   };
+  frame: {
+    type: PropType<ActionVariant>;
+  };
   rotate: {
     type: PropType<IconRotate | string>;
   };

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

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/components/icon/icon.ts"],"mappings":";;;;;;;;;;cA6Ba,sBAAM,8BAAA;;IAIS,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACG,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;;;IANT,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACG,MAAA,SAAS;;;IACrB,MAAA,SAAS;;MAmBnC,oDAAA"}
+{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/components/icon/icon.ts"],"mappings":";;;;;;;;;;cA6Ba,sBAAM,8BAAA;;IAIS,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;;;IAPT,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;MAmBnC,oDAAA"}

package/dist/components/icon/icon.js

@@ -24,6 +24,7 @@ const XhIcon = defineComponent({
 		size: { type: String },
 		weight: { type: String },
 		tone: { type: String },
+		frame: { type: String },
 		rotate: { type: [Number, String] },
 		flip: { type: String }
 	},

package/dist/components/icon/icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon.js","names":[],"sources":["../../../src/components/icon/icon.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// 提供 icon 相关实现。\n\nimport type { IconNode, IconRecord, Tone } from '@xihan-ui/core'\nimport type { IconFlip, IconProps, IconRotate, IconSize, IconWeight } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useIcon } from './use-icon'\n\n/**\n * 把一个图元节点建为 VNode，递归到底。\n * 标签与属性名逐字透传（连字符与大小写都保留），命名空间由 Vue 从父 `<svg>` 向下传递。\n */\nfunction renderNode(node: IconNode): VNode {\n  return h(node.tag, node.attrs as Record<string, unknown> | undefined, node.children?.map(renderNode))\n}\n\n/**\n * 根 `<svg>` 加一层 `<g>` 空壳，图元铺在空壳中。\n * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；\n * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），\n * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。\n */\nexport const XhIcon = defineComponent({\n  name: 'XhIcon',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    icon: { type: Object as PropType<IconRecord> },\n    label: { type: String },\n    size: { type: String as PropType<IconSize> },\n    weight: { type: String as PropType<IconWeight> },\n    tone: { type: String as PropType<Tone> },\n    rotate: { type: [Number, String] as PropType<IconRotate | string> },\n    flip: { type: String as PropType<IconFlip> },\n  },\n  setup(props, { slots }) {\n    const ctx = useIcon(withXhConfig('icon', props) as IconProps)\n    return () => {\n      const authored = slots.default?.()\n      return h(\n        'svg',\n        ctx.api.value.getRootProps() as Record<string, unknown>,\n        slotPaints(authored)\n          ? authored\n          : [h(\n              'g',\n              ctx.api.value.getGlyphProps() as Record<string, unknown>,\n              ctx.api.value.nodes.map(renderNode),\n            )],\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAmBA,SAAS,WAAW,MAAuB;CACzC,OAAO,EAAE,KAAK,KAAK,KAAK,OAA8C,KAAK,UAAU,IAAI,UAAU,CAAC;AACtG;;;;;;;AAQA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAA+B;EAC7C,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAA6B;EAC3C,QAAQ,EAAE,MAAM,OAA+B;EAC/C,MAAM,EAAE,MAAM,OAAyB;EACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAmC;EAClE,MAAM,EAAE,MAAM,OAA6B;CAC7C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,QAAQ,aAAa,QAAQ,KAAK,CAAc;EAC5D,aAAa;GACX,MAAM,WAAW,MAAM,UAAU;GACjC,OAAO,EACL,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,WAAW,QAAQ,IACf,WACA,CAAC,EACC,KACA,IAAI,IAAI,MAAM,cAAc,GAC5B,IAAI,IAAI,MAAM,MAAM,IAAI,UAAU,CACpC,CAAC,CACP;EACF;CACF;AACF,CAAC"}
+{"version":3,"file":"icon.js","names":[],"sources":["../../../src/components/icon/icon.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// 提供 icon 相关实现。\n\nimport type { ActionVariant, IconNode, IconRecord, Tone } from '@xihan-ui/core'\nimport type { IconFlip, IconProps, IconRotate, IconSize, IconWeight } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useIcon } from './use-icon'\n\n/**\n * 把一个图元节点建为 VNode，递归到底。\n * 标签与属性名逐字透传（连字符与大小写都保留），命名空间由 Vue 从父 `<svg>` 向下传递。\n */\nfunction renderNode(node: IconNode): VNode {\n  return h(node.tag, node.attrs as Record<string, unknown> | undefined, node.children?.map(renderNode))\n}\n\n/**\n * 根 `<svg>` 加一层 `<g>` 空壳，图元铺在空壳中。\n * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；\n * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），\n * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。\n */\nexport const XhIcon = defineComponent({\n  name: 'XhIcon',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    icon: { type: Object as PropType<IconRecord> },\n    label: { type: String },\n    size: { type: String as PropType<IconSize> },\n    weight: { type: String as PropType<IconWeight> },\n    tone: { type: String as PropType<Tone> },\n    frame: { type: String as PropType<ActionVariant> },\n    rotate: { type: [Number, String] as PropType<IconRotate | string> },\n    flip: { type: String as PropType<IconFlip> },\n  },\n  setup(props, { slots }) {\n    const ctx = useIcon(withXhConfig('icon', props) as IconProps)\n    return () => {\n      const authored = slots.default?.()\n      return h(\n        'svg',\n        ctx.api.value.getRootProps() as Record<string, unknown>,\n        slotPaints(authored)\n          ? authored\n          : [h(\n              'g',\n              ctx.api.value.getGlyphProps() as Record<string, unknown>,\n              ctx.api.value.nodes.map(renderNode),\n            )],\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAmBA,SAAS,WAAW,MAAuB;CACzC,OAAO,EAAE,KAAK,KAAK,KAAK,OAA8C,KAAK,UAAU,IAAI,UAAU,CAAC;AACtG;;;;;;;AAQA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAA+B;EAC7C,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAA6B;EAC3C,QAAQ,EAAE,MAAM,OAA+B;EAC/C,MAAM,EAAE,MAAM,OAAyB;EACvC,OAAO,EAAE,MAAM,OAAkC;EACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAmC;EAClE,MAAM,EAAE,MAAM,OAA6B;CAC7C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,QAAQ,aAAa,QAAQ,KAAK,CAAc;EAC5D,aAAa;GACX,MAAM,WAAW,MAAM,UAAU;GACjC,OAAO,EACL,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,WAAW,QAAQ,IACf,WACA,CAAC,EACC,KACA,IAAI,IAAI,MAAM,cAAc,GAC5B,IAAI,IAAI,MAAM,MAAM,IAAI,UAAU,CACpC,CAAC,CACP;EACF;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-image.d.ts","names":[],"sources":["../../../src/components/image/use-image.ts"],"mappings":";;;;UAeiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;iBAGH,SACd,OAAO,sBACP,iBAAiB,yCAChB"}
+{"version":3,"file":"use-image.d.ts","names":[],"sources":["../../../src/components/image/use-image.ts"],"mappings":";;;;UAiBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;iBAGH,SACd,OAAO,sBACP,iBAAiB,yCAChB"}

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

@@ -1,13 +1,15 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed } from "vue";
+import { createScope } from "@xihan-ui/core";
 import { connectImage, imageMachine } from "@xihan-ui/headless";
 //#region src/components/image/use-image.ts
 function useImage(props, onStatusChange) {
 	const service = useMachine(imageMachine, () => ({
 		...props,
 		onStatusChange
-	}));
+	}), createScope(null, createVueIdGenerator()));
 	return {
 		service,
 		api: computed(() => connectImage(service, vueNormalize))

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

@@ -1 +1 @@
-{"version":3,"file":"use-image.js","names":[],"sources":["../../../src/components/image/use-image.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 image 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ImageApi, ImageSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectImage, imageMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ImageContext {\n  service: Service<ImageSchema>\n  api: ComputedRef<ImageApi>\n}\n\nexport function useImage(\n  props: ImageSchema['props'],\n  onStatusChange?: ImageSchema['props']['onStatusChange'],\n): ImageContext {\n  const service = useMachine(imageMachine, () => ({ ...props, onStatusChange }))\n  const api = computed(() => connectImage(service, vueNormalize))\n  return { service, api }\n}\n"],"mappings":";;;;;AAoBA,SAAgB,SACd,OACA,gBACc;CACd,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO;CAAe,EAAE;CAE7E,OAAO;EAAE;EAAS,KADN,eAAe,aAAa,SAAS,YAAY,CACzC;CAAE;AACxB"}
+{"version":3,"file":"use-image.js","names":[],"sources":["../../../src/components/image/use-image.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 image 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ImageApi, ImageSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectImage, imageMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ImageContext {\n  service: Service<ImageSchema>\n  api: ComputedRef<ImageApi>\n}\n\nexport function useImage(\n  props: ImageSchema['props'],\n  onStatusChange?: ImageSchema['props']['onStatusChange'],\n): ImageContext {\n  // 占位层与回退节点带 scope 派生的 id：撤下时按它找到节点，等淡出播完再藏起\n  const service = useMachine(imageMachine, () => ({ ...props, onStatusChange }), createScope(null, createVueIdGenerator()))\n  const api = computed(() => connectImage(service, vueNormalize))\n  return { service, api }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,SACd,OACA,gBACc;CAEd,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO;CAAe,IAAI,YAAY,MAAM,qBAAqB,CAAC,CAAC;CAExH,OAAO;EAAE;EAAS,KADN,eAAe,aAAa,SAAS,YAAY,CACzC;CAAE;AACxB"}