@xihan-ui/vue 2.1.0 → 3.0.0

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

@@ -0,0 +1,194 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { ChartDatumDetails, ChartKey, GraphChartApi, GraphChartSchema, GraphChartTranslations, GraphLayout, GraphLinkDatum, GraphNodeDatum, GraphTooltipModel, GraphView, NumberFormatSpec } from "@xihan-ui/headless";
+//#region src/components/graph-chart/graph-chart.d.ts
+type GraphChartProps = GraphChartSchema['props'];
+/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
+type GraphChartRootSlotProps = Pick<GraphChartApi, 'legendItems' | 'active' | 'tooltip' | 'empty' | 'hiddenSeries' | 'activeKey' | 'view' | 'toggleSeries' | 'zoomBy' | 'resetView' | 'setFocusedDatum' | 'table'>;
+/** 提示框插槽的载荷：激活的节点与缺省的内容模型。 */
+interface GraphChartTooltipSlotProps {
+  active: ChartDatumDetails | null;
+  tooltip: GraphTooltipModel | null;
+}
+/** 标题：图表的可及名来源。 */
+declare const XhGraphChartCaption: 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 XhGraphChartLegend: 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 XhGraphChartViewport: 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 XhGraphChartPlot: 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 XhGraphChartTooltip: 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: GraphChartTooltipSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 空态：没有可画的数据时显示，缺省文字取文案。 */
+declare const XhGraphChartEmpty: 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 XhGraphChartRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  nodes: {
+    type: PropType<readonly GraphNodeDatum[]>;
+  };
+  links: {
+    type: PropType<readonly GraphLinkDatum[]>;
+  };
+  layout: {
+    type: PropType<GraphLayout>;
+  };
+  root: {
+    type: StringConstructor;
+  };
+  directed: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  draggableNodes: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  zoom: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 画布视图：给了即受控，配合 v-model:view。 */
+  view: {
+    type: PropType<GraphView>;
+  };
+  defaultView: {
+    type: PropType<GraphView>;
+  };
+  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<GraphChartTranslations>>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'hidden-series-change': (_details: PayloadOf<GraphChartProps, "onHiddenSeriesChange">) => true;
+  'update:hiddenSeries': (_hidden: PayloadOf<GraphChartProps, "onHiddenSeriesChange">["hiddenSeries"]) => true;
+  'active-key-change': (_details: PayloadOf<GraphChartProps, "onActiveKeyChange">) => true;
+  'update:activeKey': (_key: PayloadOf<GraphChartProps, "onActiveKeyChange">["activeKey"]) => true;
+  'datum-active': (_details: PayloadOf<GraphChartProps, "onDatumActive">) => true;
+  'datum-press': (_details: PayloadOf<GraphChartProps, "onDatumPress">) => true;
+  'view-change': (_details: PayloadOf<GraphChartProps, "onViewChange">) => true;
+  'update:view': (_view: PayloadOf<GraphChartProps, "onViewChange">["view"]) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  nodes: {
+    type: PropType<readonly GraphNodeDatum[]>;
+  };
+  links: {
+    type: PropType<readonly GraphLinkDatum[]>;
+  };
+  layout: {
+    type: PropType<GraphLayout>;
+  };
+  root: {
+    type: StringConstructor;
+  };
+  directed: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  draggableNodes: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  zoom: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 画布视图：给了即受控，配合 v-model:view。 */
+  view: {
+    type: PropType<GraphView>;
+  };
+  defaultView: {
+    type: PropType<GraphView>;
+  };
+  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<GraphChartTranslations>>;
+  };
+}>> & 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;
+  "onView-change"?: ((_details: import("@xihan-ui/headless").GraphViewChangeDetails) => any) | undefined;
+  "onUpdate:view"?: ((_view: GraphView) => any) | undefined;
+}>, {
+  pending: boolean;
+  zoom: boolean;
+  animated: boolean;
+  directed: boolean;
+  draggableNodes: boolean;
+}, SlotsType<{
+  /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区与空态）、提示框。 */
+  default?: (props: GraphChartRootSlotProps) => VNode[];
+  /** 缺省结构里的标题内容。 */
+  caption?: () => VNode[];
+  /** 缺省结构里的提示框内容。 */
+  tooltip?: (props: GraphChartTooltipSlotProps) => VNode[];
+  /** 缺省结构里的空态内容。 */
+  empty?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { GraphChartRootSlotProps, GraphChartTooltipSlotProps, XhGraphChartCaption, XhGraphChartEmpty, XhGraphChartLegend, XhGraphChartPlot, XhGraphChartRoot, XhGraphChartTooltip, XhGraphChartViewport };
+//# sourceMappingURL=graph-chart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-chart.d.ts","names":[],"sources":["../../../src/components/graph-chart/graph-chart.ts"],"mappings":";;;;KA4BK,kBAAkB;;KAGX,0BAA0B,KAAK;;UAG1B;EACf,QAAQ;EACR,SAAS;;;cA0CE,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAa7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;;EAGlB,WAAC,OAAO,+BAA+B;kCAWnD;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,8BAAA;;IAID,MAAA,kBAAkB;;;IAClB,MAAA,kBAAkB;;;IAChB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAMX,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACF,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;EACV,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;IA5BT,MAAA,kBAAkB;;;IAClB,MAAA,kBAAkB;;;IAChB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAMX,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACF,MAAA,SAAS,qBAAqB;;;IACrC,MAAA;;;IACO,MAAA;;;IACa,MAAA,SAAS;;;;;;;;;;;;;;IAI5B,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;EAevC,WAAC,OAAO,4BAA4B;;EAEpC,gBAAM;;EAEN,WAAC,OAAO,+BAA+B;;EAEzC,cAAM;kCAqDhB"}

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

@@ -0,0 +1,219 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideGraphChart, useGraphChartContext } from "./context.js";
+import { useGraphChart } from "./use-graph-chart.js";
+import { defineComponent, h } from "vue";
+//#region src/components/graph-chart/graph-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.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 XhGraphChartCaption = defineComponent({
+	name: "XhGraphChartCaption",
+	setup(_, { slots }) {
+		const ctx = useGraphChartContext();
+		return () => h("figcaption", ctx.api.value.getCaptionProps(), slots.default?.());
+	}
+});
+/** 图例：项由组件按分组生成；不到两组时整条收起。 */
+const XhGraphChartLegend = defineComponent({
+	name: "XhGraphChartLegend",
+	setup() {
+		const ctx = useGraphChartContext();
+		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 XhGraphChartViewport = defineComponent({
+	name: "XhGraphChartViewport",
+	setup(_, { slots }) {
+		const ctx = useGraphChartContext();
+		return () => h("div", {
+			...ctx.api.value.getViewportProps(),
+			ref: (el) => {
+				ctx.viewportRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
+/** 绘图区：连线在下，箭头其上，节点再上，节点名与焦点环最上。 */
+const XhGraphChartPlot = defineComponent({
+	name: "XhGraphChartPlot",
+	setup() {
+		const ctx = useGraphChartContext();
+		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 XhGraphChartTooltip = defineComponent({
+	name: "XhGraphChartTooltip",
+	slots: Object,
+	setup(_, { slots }) {
+		const ctx = useGraphChartContext();
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getTooltipProps(), slots.default ? slots.default({
+				active: api.active,
+				tooltip: api.tooltip
+			}) : renderTooltipContent(api));
+		};
+	}
+});
+/** 空态：没有可画的数据时显示，缺省文字取文案。 */
+const XhGraphChartEmpty = defineComponent({
+	name: "XhGraphChartEmpty",
+	setup(_, { slots }) {
+		const ctx = useGraphChartContext();
+		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.() ?? ctx.api.value.emptyText);
+	}
+});
+/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */
+const XhGraphChartRoot = defineComponent({
+	name: "XhGraphChartRoot",
+	props: {
+		nodes: { type: Array },
+		links: { type: Array },
+		layout: { type: String },
+		root: { type: String },
+		directed: {
+			type: Boolean,
+			default: void 0
+		},
+		draggableNodes: {
+			type: Boolean,
+			default: void 0
+		},
+		zoom: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 画布视图：给了即受控，配合 v-model:view。 */
+		view: { type: Object },
+		defaultView: { type: Object },
+		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,
+		"view-change": (_details) => true,
+		"update:view": (_view) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const ctx = useGraphChart(withXhConfig("graph-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),
+			onViewChange: (details) => {
+				emit("view-change", details);
+				emit("update:view", details.view);
+			}
+		});
+		provideGraphChart(ctx);
+		return () => {
+			const api = ctx.api.value;
+			const content = slots.default ? slots.default({
+				legendItems: api.legendItems,
+				active: api.active,
+				tooltip: api.tooltip,
+				empty: api.empty,
+				table: api.table,
+				hiddenSeries: api.hiddenSeries,
+				activeKey: api.activeKey,
+				view: api.view,
+				toggleSeries: api.toggleSeries,
+				zoomBy: api.zoomBy,
+				resetView: api.resetView,
+				setFocusedDatum: api.setFocusedDatum
+			}) : [
+				...slots.caption ? [h(XhGraphChartCaption, null, () => slots.caption?.())] : [],
+				h(XhGraphChartLegend),
+				h(XhGraphChartViewport, null, () => [h(XhGraphChartPlot), h(XhGraphChartEmpty, null, slots.empty ? () => slots.empty?.() : void 0)]),
+				h(XhGraphChartTooltip, null, slots.tooltip ? { default: slots.tooltip } : void 0)
+			];
+			return h("figure", {
+				...api.getRootProps(),
+				ref: (el) => {
+					ctx.rootRef.value = el;
+				}
+			}, [...content, ...renderA11y(api)]);
+		};
+	}
+});
+//#endregion
+export { XhGraphChartCaption, XhGraphChartEmpty, XhGraphChartLegend, XhGraphChartPlot, XhGraphChartRoot, XhGraphChartTooltip, XhGraphChartViewport };
+
+//# sourceMappingURL=graph-chart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-chart.js","names":[],"sources":["../../../src/components/graph-chart/graph-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// 提供 graph chart 相关实现。\n\nimport type {\n  ChartDatumDetails,\n  ChartKey,\n  ChartMark,\n  GraphChartApi,\n  GraphChartSchema,\n  GraphChartTranslations,\n  GraphLayout,\n  GraphLinkDatum,\n  GraphNodeDatum,\n  GraphTooltipModel,\n  GraphView,\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 { provideGraphChart, useGraphChartContext } from './context'\nimport { useGraphChart } from './use-graph-chart'\n\ntype GraphChartProps = GraphChartSchema['props']\n\n/** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */\nexport type GraphChartRootSlotProps = Pick<GraphChartApi, 'legendItems' | 'active' | 'tooltip' | 'empty' | 'hiddenSeries' | 'activeKey' | 'view' | 'toggleSeries' | 'zoomBy' | 'resetView' | 'setFocusedDatum' | 'table'>\n\n/** 提示框插槽的载荷：激活的节点与缺省的内容模型。 */\nexport interface GraphChartTooltipSlotProps {\n  active: ChartDatumDetails | null\n  tooltip: GraphTooltipModel | null\n}\n\n/** 一个场景标记画成 SVG 元素；文字标记带文字。 */\nfunction renderMark(api: GraphChartApi, 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: GraphChartApi): 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.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: GraphChartApi): 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 XhGraphChartCaption = defineComponent({\n  name: 'XhGraphChartCaption',\n  setup(_, { slots }) {\n    const ctx = useGraphChartContext()\n    return () => h('figcaption', ctx.api.value.getCaptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 图例：项由组件按分组生成；不到两组时整条收起。 */\nexport const XhGraphChartLegend = defineComponent({\n  name: 'XhGraphChartLegend',\n  setup() {\n    const ctx = useGraphChartContext()\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 XhGraphChartViewport = defineComponent({\n  name: 'XhGraphChartViewport',\n  setup(_, { slots }) {\n    const ctx = useGraphChartContext()\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 XhGraphChartPlot = defineComponent({\n  name: 'XhGraphChartPlot',\n  setup() {\n    const ctx = useGraphChartContext()\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 XhGraphChartTooltip = defineComponent({\n  name: 'XhGraphChartTooltip',\n  slots: Object as SlotsType<{\n    default?: (props: GraphChartTooltipSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useGraphChartContext()\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 XhGraphChartEmpty = defineComponent({\n  name: 'XhGraphChartEmpty',\n  setup(_, { slots }) {\n    const ctx = useGraphChartContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.() ?? ctx.api.value.emptyText)\n  },\n})\n\n/** 根：铺开缺省结构或交给默认插槽，并在末尾追加摘要与数据表。 */\nexport const XhGraphChartRoot = defineComponent({\n  name: 'XhGraphChartRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    nodes: { type: Array as PropType<readonly GraphNodeDatum[]> },\n    links: { type: Array as PropType<readonly GraphLinkDatum[]> },\n    layout: { type: String as PropType<GraphLayout> },\n    root: { type: String },\n    directed: { type: Boolean, default: undefined },\n    draggableNodes: { type: Boolean, default: undefined },\n    zoom: { type: Boolean, default: undefined },\n    /** 画布视图：给了即受控，配合 v-model:view。 */\n    view: { type: Object as PropType<GraphView> },\n    defaultView: { type: Object as PropType<GraphView> },\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<GraphChartTranslations>> },\n  },\n  // hidden-series-change / active-key-change 携带 details；update:* 携带裸值，支持 v-model\n  emits: {\n    'hidden-series-change': (_details: PayloadOf<GraphChartProps, 'onHiddenSeriesChange'>) => true,\n    'update:hiddenSeries': (_hidden: PayloadOf<GraphChartProps, 'onHiddenSeriesChange'>['hiddenSeries']) => true,\n    'active-key-change': (_details: PayloadOf<GraphChartProps, 'onActiveKeyChange'>) => true,\n    'update:activeKey': (_key: PayloadOf<GraphChartProps, 'onActiveKeyChange'>['activeKey']) => true,\n    'datum-active': (_details: PayloadOf<GraphChartProps, 'onDatumActive'>) => true,\n    'datum-press': (_details: PayloadOf<GraphChartProps, 'onDatumPress'>) => true,\n    'view-change': (_details: PayloadOf<GraphChartProps, 'onViewChange'>) => true,\n    'update:view': (_view: PayloadOf<GraphChartProps, 'onViewChange'>['view']) => true,\n  },\n  slots: Object as SlotsType<{\n    /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区与空态）、提示框。 */\n    default?: (props: GraphChartRootSlotProps) => VNode[]\n    /** 缺省结构里的标题内容。 */\n    caption?: () => VNode[]\n    /** 缺省结构里的提示框内容。 */\n    tooltip?: (props: GraphChartTooltipSlotProps) => VNode[]\n    /** 缺省结构里的空态内容。 */\n    empty?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useGraphChart(withXhConfig('graph-chart', props) as GraphChartProps, {\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      onViewChange: (details) => {\n        emit('view-change', details)\n        emit('update:view', details.view)\n      },\n    })\n    provideGraphChart(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            empty: api.empty,\n            table: api.table,\n            hiddenSeries: api.hiddenSeries,\n            activeKey: api.activeKey,\n            view: api.view,\n            toggleSeries: api.toggleSeries,\n            zoomBy: api.zoomBy,\n            resetView: api.resetView,\n            setFocusedDatum: api.setFocusedDatum,\n          })\n        : [\n            ...(slots.caption ? [h(XhGraphChartCaption, null, () => slots.caption?.())] : []),\n            h(XhGraphChartLegend),\n            // 空态放进视口：叠在绘图区上，标题与图例不被盖住\n            h(XhGraphChartViewport, null, () => [\n              h(XhGraphChartPlot),\n              h(XhGraphChartEmpty, null, slots.empty ? () => slots.empty?.() : undefined),\n            ]),\n            h(XhGraphChartTooltip, 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/graph-chart/use-graph-chart.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-graph-chart.d.ts","names":[],"sources":["../../../src/components/graph-chart/use-graph-chart.ts"],"mappings":";;;;;KAgBY,sBAAsB,KAChC;UAIe;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;EAEb,aAAa,IAAI;;;iBAIH,cACd,OAAO,2BACP,SAAS,sBACR"}

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

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

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

package/dist/components/grid/grid.d.ts

@@ -6,6 +6,7 @@ type ColsByBreakpoint = Exclude<GridProps['cols'], GridColumnCount | undefined>;
 /** 断点对象形态的跨列与错列，同样从类型上取。 */
 type SpanByBreakpoint = Exclude<GridItemProps['span'], GridColumnCount | undefined>;
 type OffsetByBreakpoint = Exclude<GridItemProps['offset'], GridColumnOffset | undefined>;
+type RowSpanByBreakpoint = Exclude<GridItemProps['rowSpan'], GridRowCount | undefined>;
 declare const XhGridRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   cols: {
     type: PropType<GridColumnCount | string | ColsByBreakpoint>;
@@ -66,6 +67,9 @@ declare const XhGridItem: import("vue").DefineComponent<import("vue").ExtractPro
   offset: {
     type: PropType<GridColumnOffset | string | OffsetByBreakpoint>;
   };
+  rowSpan: {
+    type: PropType<GridRowCount | string | RowSpanByBreakpoint>;
+  };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -75,6 +79,9 @@ declare const XhGridItem: import("vue").DefineComponent<import("vue").ExtractPro
   offset: {
     type: PropType<GridColumnOffset | string | OffsetByBreakpoint>;
   };
+  rowSpan: {
+    type: PropType<GridRowCount | string | RowSpanByBreakpoint>;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhGridItem, XhGridRoot };

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

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","names":[],"sources":["../../../src/components/grid/grid.ts"],"mappings":";;;;KAeK,mBAAmB,QAAQ,mBAAmB;;KAE9C,mBAAmB,QAAQ,uBAAuB;KAClD,qBAAqB,QAAQ,yBAAyB;cAE9C,0BAAU,8BAAA;;IAMiB,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;IARL,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;MAgB3C,oDAAA;cAEW,0BAAU,8BAAA;;IAKiB,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;;;;;IAHrC,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;MAc3E,oDAAA"}
+{"version":3,"file":"grid.d.ts","names":[],"sources":["../../../src/components/grid/grid.ts"],"mappings":";;;;KAeK,mBAAmB,QAAQ,mBAAmB;;KAE9C,mBAAmB,QAAQ,uBAAuB;KAClD,qBAAqB,QAAQ,yBAAyB;KACtD,sBAAsB,QAAQ,0BAA0B;cAEhD,0BAAU,8BAAA;;IAMiB,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;IARL,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;MAgB3C,oDAAA;cAEW,0BAAU,8BAAA;;IAKiB,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;;IAGrC,MAAA,SAAS,wBAAwB;;;;;;IANjC,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;;IAGrC,MAAA,SAAS,wBAAwB;;MAevE,oDAAA"}

package/dist/components/grid/grid.js

@@ -46,13 +46,19 @@ const XhGridItem = defineComponent({
 			Number,
 			String,
 			Object
+		] },
+		rowSpan: { type: [
+			Number,
+			String,
+			Object
 		] }
 	},
 	setup(props, { slots }) {
 		const ctx = useGridContext();
 		return () => h("div", ctx.api.value.getItemProps({
 			span: normalizeGridTier(props.span),
-			offset: normalizeGridTier(props.offset)
+			offset: normalizeGridTier(props.offset),
+			rowSpan: normalizeGridTier(props.rowSpan)
 		}), slots.default?.());
 	}
 });

package/dist/components/grid/grid.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/grid/grid.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// 提供 grid 相关实现。\n\nimport type { GridColumnCount, GridColumnOffset, GridItemProps, GridProps, GridRowCount } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGrid, normalizeGridCount, normalizeGridTier } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideGrid, useGridContext } from './context'\n\n/** 断点对象形态的列数，从 GridProps 上取，不在这里另抄一份档位清单。 */\ntype ColsByBreakpoint = Exclude<GridProps['cols'], GridColumnCount | undefined>\n/** 断点对象形态的跨列与错列，同样从类型上取。 */\ntype SpanByBreakpoint = Exclude<GridItemProps['span'], GridColumnCount | undefined>\ntype OffsetByBreakpoint = Exclude<GridItemProps['offset'], GridColumnOffset | undefined>\n\nexport const XhGridRoot = defineComponent({\n  name: 'XhGridRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 列数由作者声明：兼收字符串以支持模板里写 cols=\"3\"，收对象则是逐档的列数\n    cols: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | ColsByBreakpoint>,\n    },\n    rows: { type: [Number, String] as PropType<GridRowCount | string> },\n    minColWidth: { type: String as PropType<GridProps['minColWidth']> },\n    gap: { type: String as PropType<GridProps['gap']> },\n    rowGap: { type: String as PropType<GridProps['rowGap']> },\n    columnGap: { type: String as PropType<GridProps['columnGap']> },\n    align: { type: String as PropType<GridProps['align']> },\n    justifyItems: { type: String as PropType<GridProps['justifyItems']> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectGrid({\n      cols: normalizeGridTier(props.cols) as GridProps['cols'],\n      rows: normalizeGridCount(props.rows) as GridRowCount | undefined,\n      minColWidth: props.minColWidth,\n      gap: props.gap,\n      rowGap: props.rowGap,\n      columnGap: props.columnGap,\n      align: props.align,\n      justifyItems: props.justifyItems,\n    }, vueNormalize))\n    provideGrid({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhGridItem = defineComponent({\n  name: 'XhGridItem',\n  props: {\n    // 跨列与错列由每一格自报，同样兼收字符串；收对象则是逐档的跨列 / 错列\n    span: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | SpanByBreakpoint>,\n    },\n    offset: {\n      type: [Number, String, Object] as PropType<GridColumnOffset | string | OffsetByBreakpoint>,\n    },\n  },\n  setup(props, { slots }) {\n    const ctx = useGridContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({\n        span: normalizeGridTier(props.span) as GridItemProps['span'],\n        offset: normalizeGridTier(props.offset) as GridItemProps['offset'],\n      }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAoBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,MAAM,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAqC;EAClE,aAAa,EAAE,MAAM,OAA6C;EAClE,KAAK,EAAE,MAAM,OAAqC;EAClD,QAAQ,EAAE,MAAM,OAAwC;EACxD,WAAW,EAAE,MAAM,OAA2C;EAC9D,OAAO,EAAE,MAAM,OAAuC;EACtD,cAAc,EAAE,MAAM,OAA8C;CACtE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY;GACrC,MAAM,kBAAkB,MAAM,IAAI;GAClC,MAAM,mBAAmB,MAAM,IAAI;GACnC,aAAa,MAAM;GACnB,KAAK,MAAM;GACX,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb,cAAc,MAAM;EACtB,GAAG,YAAY,CAAC;EAChB,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,QAAQ,EACN,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;CACF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa;GACzB,MAAM,kBAAkB,MAAM,IAAI;GAClC,QAAQ,kBAAkB,MAAM,MAAM;EACxC,CAAC,GACD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/grid/grid.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// 提供 grid 相关实现。\n\nimport type { GridColumnCount, GridColumnOffset, GridItemProps, GridProps, GridRowCount } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGrid, normalizeGridCount, normalizeGridTier } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideGrid, useGridContext } from './context'\n\n/** 断点对象形态的列数，从 GridProps 上取，不在这里另抄一份档位清单。 */\ntype ColsByBreakpoint = Exclude<GridProps['cols'], GridColumnCount | undefined>\n/** 断点对象形态的跨列与错列，同样从类型上取。 */\ntype SpanByBreakpoint = Exclude<GridItemProps['span'], GridColumnCount | undefined>\ntype OffsetByBreakpoint = Exclude<GridItemProps['offset'], GridColumnOffset | undefined>\ntype RowSpanByBreakpoint = Exclude<GridItemProps['rowSpan'], GridRowCount | undefined>\n\nexport const XhGridRoot = defineComponent({\n  name: 'XhGridRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 列数由作者声明：兼收字符串以支持模板里写 cols=\"3\"，收对象则是逐档的列数\n    cols: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | ColsByBreakpoint>,\n    },\n    rows: { type: [Number, String] as PropType<GridRowCount | string> },\n    minColWidth: { type: String as PropType<GridProps['minColWidth']> },\n    gap: { type: String as PropType<GridProps['gap']> },\n    rowGap: { type: String as PropType<GridProps['rowGap']> },\n    columnGap: { type: String as PropType<GridProps['columnGap']> },\n    align: { type: String as PropType<GridProps['align']> },\n    justifyItems: { type: String as PropType<GridProps['justifyItems']> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectGrid({\n      cols: normalizeGridTier(props.cols) as GridProps['cols'],\n      rows: normalizeGridCount(props.rows) as GridRowCount | undefined,\n      minColWidth: props.minColWidth,\n      gap: props.gap,\n      rowGap: props.rowGap,\n      columnGap: props.columnGap,\n      align: props.align,\n      justifyItems: props.justifyItems,\n    }, vueNormalize))\n    provideGrid({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhGridItem = defineComponent({\n  name: 'XhGridItem',\n  props: {\n    // 跨列与错列由每一格自报，同样兼收字符串；收对象则是逐档的跨列 / 错列\n    span: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | SpanByBreakpoint>,\n    },\n    offset: {\n      type: [Number, String, Object] as PropType<GridColumnOffset | string | OffsetByBreakpoint>,\n    },\n    rowSpan: {\n      type: [Number, String, Object] as PropType<GridRowCount | string | RowSpanByBreakpoint>,\n    },\n  },\n  setup(props, { slots }) {\n    const ctx = useGridContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({\n        span: normalizeGridTier(props.span) as GridItemProps['span'],\n        offset: normalizeGridTier(props.offset) as GridItemProps['offset'],\n        rowSpan: normalizeGridTier(props.rowSpan) as GridItemProps['rowSpan'],\n      }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAqBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,MAAM,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAqC;EAClE,aAAa,EAAE,MAAM,OAA6C;EAClE,KAAK,EAAE,MAAM,OAAqC;EAClD,QAAQ,EAAE,MAAM,OAAwC;EACxD,WAAW,EAAE,MAAM,OAA2C;EAC9D,OAAO,EAAE,MAAM,OAAuC;EACtD,cAAc,EAAE,MAAM,OAA8C;CACtE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY;GACrC,MAAM,kBAAkB,MAAM,IAAI;GAClC,MAAM,mBAAmB,MAAM,IAAI;GACnC,aAAa,MAAM;GACnB,KAAK,MAAM;GACX,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb,cAAc,MAAM;EACtB,GAAG,YAAY,CAAC;EAChB,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,QAAQ,EACN,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,SAAS,EACP,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;CACF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa;GACzB,MAAM,kBAAkB,MAAM,IAAI;GAClC,QAAQ,kBAAkB,MAAM,MAAM;GACtC,SAAS,kBAAkB,MAAM,OAAO;EAC1C,CAAC,GACD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

package/dist/components/grid-list/context.d.ts

@@ -0,0 +1,9 @@
+import { GridListContext } from "./use-grid-list.js";
+import { ComputedRef } from "vue";
+import { GridListRowProps } from "@xihan-ui/headless";
+//#region src/components/grid-list/context.d.ts
+declare function useGridListContext(): GridListContext;
+declare function useGridListRow(): ComputedRef<GridListRowProps>;
+//#endregion
+export { useGridListContext, useGridListRow };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/grid-list/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/grid-list/context.ts"],"mappings":";;;;iBAmBgB,sBAAsB;iBAWtB,kBAAkB,YAAY"}

package/dist/components/grid-list/context.js

@@ -0,0 +1,24 @@
+import { inject, provide } from "vue";
+//#region src/components/grid-list/context.ts
+const KEY = Symbol.for("xh-grid-list");
+const ROW_KEY = Symbol.for("xh-grid-list-row");
+function provideGridList(context) {
+	provide(KEY, context);
+}
+function useGridListContext() {
+	const context = inject(KEY, null);
+	if (!context) throw new Error("[xh] GridList 部件必须用在 XhGridListRoot 内");
+	return context;
+}
+function provideGridListRow(row) {
+	provide(ROW_KEY, row);
+}
+function useGridListRow() {
+	const row = inject(ROW_KEY, null);
+	if (!row) throw new Error("[xh] GridList 行子部件必须用在 XhGridListRow 内");
+	return row;
+}
+//#endregion
+export { provideGridList, provideGridListRow, useGridListContext, useGridListRow };
+
+//# sourceMappingURL=context.js.map

package/dist/components/grid-list/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/grid-list/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { GridListRowProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { GridListContext } from './use-grid-list'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<GridListContext> = Symbol.for('xh-grid-list')\nconst ROW_KEY: InjectionKey<ComputedRef<GridListRowProps>> = Symbol.for('xh-grid-list-row')\n\nexport function provideGridList(context: GridListContext): void {\n  provide(KEY, context)\n}\n\nexport function useGridListContext(): GridListContext {\n  const context = inject(KEY, null)\n  if (!context)\n    throw new Error('[xh] GridList 部件必须用在 XhGridListRoot 内')\n  return context\n}\n\nexport function provideGridListRow(row: ComputedRef<GridListRowProps>): void {\n  provide(ROW_KEY, row)\n}\n\nexport function useGridListRow(): ComputedRef<GridListRowProps> {\n  const row = inject(ROW_KEY, null)\n  if (!row)\n    throw new Error('[xh] GridList 行子部件必须用在 XhGridListRow 内')\n  return row\n}\n"],"mappings":";;AAYA,MAAM,MAAqC,OAAO,IAAI,cAAc;AACpE,MAAM,UAAuD,OAAO,IAAI,kBAAkB;AAE1F,SAAgB,gBAAgB,SAAgC;CAC9D,QAAQ,KAAK,OAAO;AACtB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,UAAU,OAAO,KAAK,IAAI;CAChC,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,mBAAmB,KAA0C;CAC3E,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,iBAAgD;CAC9D,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,wCAAwC;CAC1D,OAAO;AACT"}