@xihan-ui/vue 4.2.0 → 5.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-grid-list.js","names":[],"sources":["../../../src/components/grid-list/use-grid-list.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 grid list 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { GridListApi, GridListSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectGridList, gridListMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface GridListContext {\n  api: ComputedRef<GridListApi>\n  service: Service<GridListSchema>\n}\n\nexport function useGridList(\n  props: GridListSchema['props'],\n  onValueChange?: GridListSchema['props']['onValueChange'],\n  onAction?: GridListSchema['props']['onAction'],\n): GridListContext {\n  const service = useMachine(gridListMachine, () => ({ ...props, onValueChange, onAction }))\n  return { api: computed(() => connectGridList(service, vueNormalize)), service }\n}\n"],"mappings":";;;;;AAoBA,SAAgB,YACd,OACA,eACA,UACiB;CACjB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO;EAAe;CAAS,EAAE;CACzF,OAAO;EAAE,KAAK,eAAe,gBAAgB,SAAS,YAAY,CAAC;EAAG;CAAQ;AAChF"}
+{"version":3,"file":"use-grid-list.js","names":[],"sources":["../../../src/components/grid-list/use-grid-list.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 grid list 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { GridListApi, GridListSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectGridList, gridListMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface GridListContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhGridListLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<GridListApi>\n  service: Service<GridListSchema>\n}\n\nexport function useGridList(\n  props: GridListSchema['props'],\n  onValueChange?: GridListSchema['props']['onValueChange'],\n  onAction?: GridListSchema['props']['onAction'],\n): GridListContext {\n  const labelCount = ref(0)\n  const service = useMachine(gridListMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange, onAction }))\n  return { labelCount, api: computed(() => connectGridList(service, vueNormalize)), service }\n}\n"],"mappings":";;;;;AAyBA,SAAgB,YACd,OACA,eACA,UACiB;CACjB,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;EAAe;CAAS,EAAE;CACzH,OAAO;EAAE;EAAY,KAAK,eAAe,gBAAgB,SAAS,YAAY,CAAC;EAAG;CAAQ;AAC5F"}

package/dist/components/heatmap/heatmap.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { HeatmapApi, HeatmapAxisInput, HeatmapCellMeta, HeatmapDatumDetails, HeatmapLegendBound, HeatmapMatrixCellMeta, HeatmapPalette, HeatmapPolarity, HeatmapScaleMode, HeatmapSchema, HeatmapTranslations, HeatmapValue, HeatmapVariant, NumberFormatSpec } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Size, Tone } from "@xihan-ui/core";
-import { HeatmapApi, HeatmapAxisInput, HeatmapCellDetails, HeatmapCellMeta, HeatmapLegendBound, HeatmapMatrixCellMeta, HeatmapPalette, HeatmapPolarity, HeatmapScaleMode, HeatmapSchema, HeatmapTranslations, HeatmapValue, HeatmapVariant } from "@xihan-ui/headless";
 //#region src/components/heatmap/heatmap.d.ts
 type HeatmapProps = HeatmapSchema['props'];
 /**
@@ -9,7 +9,7 @@ type HeatmapProps = HeatmapSchema['props'];
  * 三形态通用的一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也包含在内：
  * 矩阵形态下带 Date 的一组恒为 null，自行铺设矩阵时只有这一组能读取、移动锚点。
  */
-type HeatmapRootSlotProps = Pick<HeatmapApi, 'variant' | 'grid' | 'monthGrid' | 'matrixGrid' | 'focusedCell' | 'focusedDate' | 'anchorCell' | 'anchorDate' | 'activeCell' | 'detailOpen' | 'scaleMode' | 'legendItems' | 'cellAt' | 'setFocusedCell' | 'setFocusedDate'>;
+type HeatmapRootSlotProps = Pick<HeatmapApi, 'variant' | 'grid' | 'monthGrid' | 'matrixGrid' | 'focusedCell' | 'focusedDate' | 'anchorCell' | 'anchorDate' | 'activeCell' | 'activeKey' | 'empty' | 'detailOpen' | 'scaleMode' | 'legendItems' | 'cellAt' | 'setFocusedCell' | 'setFocusedDate'>;
 /**
  * `cell` 插槽的载荷：日期形态给日历的格子，矩阵形态给矩阵的格子。
  * 两者的坐标不同，用 `'date' in cell` 区分。
@@ -72,15 +72,26 @@ declare const XhHeatmapRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: undefined;
   };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  activeKey: {
+    type: PropType<string | null>;
+  };
   translations: {
     type: PropType<Partial<HeatmapTranslations>>;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  'cell-focus': (_details: PayloadOf<HeatmapProps, "onCellFocus">) => true;
-  'cell-active': (_details: PayloadOf<HeatmapProps, "onCellActive">) => true;
-  'cell-press': (_details: PayloadOf<HeatmapProps, "onCellPress">) => true;
+  'datum-active': (_details: PayloadOf<HeatmapProps, "onDatumActive">) => true;
+  'datum-press': (_details: PayloadOf<HeatmapProps, "onDatumPress">) => true;
+  'active-key-change': (_details: PayloadOf<HeatmapProps, "onActiveKeyChange">) => true;
+  'update:activeKey': (_key: PayloadOf<HeatmapProps, "onActiveKeyChange">["activeKey"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   variant: {
     type: PropType<HeatmapVariant>;
@@ -138,22 +149,36 @@ declare const XhHeatmapRoot: import("vue").DefineComponent<import("vue").Extract
     type: BooleanConstructor;
     default: undefined;
   };
+  format: {
+    type: PropType<NumberFormatSpec | ((value: number) => string)>;
+  };
+  pending: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  activeKey: {
+    type: PropType<string | null>;
+  };
   translations: {
     type: PropType<Partial<HeatmapTranslations>>;
   };
 }>> & Readonly<{
-  "onCell-focus"?: ((_details: HeatmapCellDetails) => any) | undefined;
-  "onCell-active"?: ((_details: HeatmapCellDetails | null) => any) | undefined;
-  "onCell-press"?: ((_details: HeatmapCellDetails) => any) | undefined;
+  "onDatum-active"?: ((_details: HeatmapDatumDetails | null) => any) | undefined;
+  "onDatum-press"?: ((_details: HeatmapDatumDetails) => any) | undefined;
+  "onActive-key-change"?: ((_details: import("@xihan-ui/headless").HeatmapActiveKeyChangeDetails) => any) | undefined;
+  "onUpdate:activeKey"?: ((_key: string | null) => any) | undefined;
 }>, {
-  animated: boolean;
   continuous: boolean;
+  animated: boolean;
+  pending: boolean;
 }, SlotsType<{
   default?: (props: HeatmapRootSlotProps) => VNode[];
   /** 铺开网格时每一格的内容插槽，默认是空格子；三种形态都铺设。 */
   cell?: (props: HeatmapCellSlotProps) => VNode[];
   /** 详情条的内容插槽；写了它才会铺设 tooltip 部件。 */
-  tooltip?: (props: HeatmapCellDetails | null) => VNode[];
+  tooltip?: (props: HeatmapDatumDetails | null) => VNode[];
+  /** 缺省结构里的空态内容；未写时是空态文案。 */
+  empty?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */
 declare const XhHeatmapGrid: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -323,6 +348,10 @@ declare const XhHeatmapLegendItem: import("vue").DefineComponent<import("vue").E
     type: PropType<HeatmapPolarity>;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 空态：网格里一条数据都没有时叠在网格上，取数中改写加载文案。 */
+declare const XhHeatmapEmpty: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { HeatmapCellSlotProps, HeatmapRootSlotProps, XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDay };
+export { HeatmapCellSlotProps, HeatmapRootSlotProps, XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapEmpty, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDay };
 //# sourceMappingURL=heatmap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/heatmap.ts"],"mappings":";;;;;KAyCK,eAAe;;;;;;KAOR,uBAAuB,KACjC;;;;;KAsBU,uBAAuB,kBAAkB;cAExC,6BAAa,8BAAA;;IAIK,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;IAKX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAED,MAAA,SAAS,QAAQ;;;;;EAIxB,eAAA,UAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACX,eAAA,UAAA,UAAU;;;IAxBR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;IAKX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAED,MAAA,SAAS,QAAQ;;;;;;;;;;EASvC,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,yBAAyB;;EAE9B,WAAC,OAAO,8BAA8B;kCAsClD;;cAGW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;;;MAW9B,oDAAA;;;;;cAMW,4BAAY,8BAAA;;IAGc,MAAA;;;;;;;;;;IAAA,MAAA;;;;;;MAkBrC,oDAAA;;cAGW,gCAAgB,8BAAA;;IAGU,MAAA;;;;;;IAAA,MAAA;;MAOrC,oDAAA;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;MAS9B,oDAAA;;cAGW,iCAAiB,8BAAA;;;;;;;;;;MAS5B,oDAAA;;cAGW,oCAAoB,8BAAA;;;;;;;;;;;;MAS/B,oDAAA;;;;;cAMW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;MAexB,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,8BAAA;;;IAIJ,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAMpC,oDAAA;;cAGW,mCAAmB,8BAAA;;;IAIO,MAAA;;;;;IAEP,MAAA,SAAS;;;;;;;IAFF,MAAA;;;;;IAEP,MAAA,SAAS;;MAOvC,oDAAA"}
+{"version":3,"file":"heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/heatmap.ts"],"mappings":";;;;;KAyCK,eAAe;;;;;;KAOR,uBAAuB,KACjC;;;;;KAwBU,uBAAuB,kBAAkB;cAExC,6BAAa,8BAAA;;IAIK,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;IAKX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAEK,MAAA,SAAS,qBAAqB;;;;;;;IAE/B,MAAA;;;IACL,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACJ,sBAAA,UAAA,UAAU;EACf,qBAAA,MAAA,UAAU;;;IA5BV,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;IACJ,MAAA,SAAS;;;;;;;;;;;;;;;;IAKX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAEK,MAAA,SAAS,qBAAqB;;;;;;;IAE/B,MAAA;;;IACL,MAAA,SAAS,QAAQ;;;;;;;;;;;;EAUvC,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,yBAAyB;;EAE9B,WAAC,OAAO,+BAA+B;;EAEzC,cAAM;kCA4ChB;;cAGW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;;;MAW9B,oDAAA;;;;;cAMW,4BAAY,8BAAA;;IAGc,MAAA;;;;;;;;;;IAAA,MAAA;;;;;;MAkBrC,oDAAA;;cAGW,gCAAgB,8BAAA;;IAGU,MAAA;;;;;;IAAA,MAAA;;MAOrC,oDAAA;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;MAS9B,oDAAA;;cAGW,iCAAiB,8BAAA;;;;;;;;;;MAS5B,oDAAA;;cAGW,oCAAoB,8BAAA;;;;;;;;;;;;MAS/B,oDAAA;;;;;cAMW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;MAexB,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,8BAAA;;;IAIJ,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAMpC,oDAAA;;cAGW,mCAAmB,8BAAA;;;IAIO,MAAA;;;;;IAEP,MAAA,SAAS;;;;;;;IAFF,MAAA;;;;;IAEP,MAAA,SAAS;;MAOvC,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/heatmap/heatmap.js

@@ -1,8 +1,9 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { provideHeatmap, provideHeatmapMonth, provideHeatmapRow, useHeatmapContext, useHeatmapMonth, useHeatmapRow } from "./context.js";
 import { useHeatmap } from "./use-heatmap.js";
+import { heatmapStructure, normalizeHeatmapNumber, normalizeHeatmapString } from "@xihan-ui/headless";
 import { computed, defineComponent, h } from "vue";
-import { heatmapMatrixKey, normalizeHeatmapNumber, normalizeHeatmapString } from "@xihan-ui/headless";
 //#region src/components/heatmap/heatmap.ts
 const XhHeatmapRoot = defineComponent({
 	name: "XhHeatmapRoot",
@@ -31,19 +32,30 @@ const XhHeatmapRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		format: { type: [Object, Function] },
+		pending: {
+			type: Boolean,
+			default: void 0
+		},
+		activeKey: { type: [String, null] },
 		translations: { type: Object }
 	},
 	emits: {
-		"cell-focus": (_details) => true,
-		"cell-active": (_details) => true,
-		"cell-press": (_details) => true
+		"datum-active": (_details) => true,
+		"datum-press": (_details) => true,
+		"active-key-change": (_details) => true,
+		"update:activeKey": (_key) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
-		const notifyFocus = (details) => emit("cell-focus", details);
-		const notifyActive = (details) => emit("cell-active", details);
-		const notifyPress = (details) => emit("cell-press", details);
-		const ctx = useHeatmap(withXhConfig("heatmap", props), notifyFocus, notifyActive, notifyPress);
+		const ctx = useHeatmap(withXhConfig("heatmap", props), {
+			onDatumActive: (details) => emit("datum-active", details),
+			onDatumPress: (details) => emit("datum-press", details),
+			onActiveKeyChange: (details) => {
+				emit("active-key-change", details);
+				emit("update:activeKey", details.activeKey);
+			}
+		});
 		provideHeatmap(ctx);
 		return () => {
 			const api = ctx.api.value;
@@ -62,13 +74,15 @@ const XhHeatmapRoot = defineComponent({
 				anchorCell: api.anchorCell,
 				anchorDate: api.anchorDate,
 				activeCell: api.activeCell,
+				activeKey: api.activeKey,
+				empty: api.empty,
 				detailOpen: api.detailOpen,
 				scaleMode: api.scaleMode,
 				legendItems: api.legendItems,
 				cellAt: api.cellAt,
 				setFocusedCell: api.setFocusedCell,
 				setFocusedDate: api.setFocusedDate
-			}) : renderDefaultTree(api, slots.cell, slots.tooltip));
+			}) : renderDefaultStructure(api, slots.cell, slots.tooltip, slots.empty));
 		};
 	}
 });
@@ -240,90 +254,42 @@ const XhHeatmapLegendItem = defineComponent({
 		}), slots.default?.());
 	}
 });
+/** 空态：网格里一条数据都没有时叠在网格上，取数中改写加载文案。 */
+const XhHeatmapEmpty = defineComponent({
+	name: "XhHeatmapEmpty",
+	setup(_, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.());
+	}
+});
+/** 标准结构里各部件对应的组件。 */
+const HEATMAP_PARTS = {
+	"grid": XhHeatmapGrid,
+	"month-block": XhHeatmapMonthBlock,
+	"row": XhHeatmapRow,
+	"week-day": XhHeatmapWeekDay,
+	"month-label": XhHeatmapMonthLabel,
+	"row-label": XhHeatmapRowLabel,
+	"column-label": XhHeatmapColumnLabel,
+	"cell": XhHeatmapCell,
+	"tooltip": XhHeatmapTooltip,
+	"legend": XhHeatmapLegend,
+	"legend-label": XhHeatmapLegendLabel,
+	"legend-item": XhHeatmapLegendItem,
+	"empty": XhHeatmapEmpty
+};
 /**
-* 未写默认插槽时按网格模型铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
-* 详情条只有写了 tooltip 插槽才铺设，未写时整棵树与从前逐字一致。
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 heatmapStructure 渲，
+* 与 Web Components 只写 root 时元素生成的节点出自同一份。格子、详情条与空态的内容由对应插槽接管。
 */
-function renderDefaultTree(api, cellSlot, tooltipSlot) {
-	const legend = h(XhHeatmapLegend, null, () => [
-		h(XhHeatmapLegendLabel, { value: "low" }, () => api.legendText.low),
-		...api.legendItems.map((item) => h(XhHeatmapLegendItem, {
-			key: `${item.polarity ?? "center"}-${item.level}`,
-			value: item.level,
-			polarity: item.polarity ?? void 0
-		})),
-		h(XhHeatmapLegendLabel, { value: "high" }, () => api.legendText.high)
-	]);
-	const tooltip = tooltipSlot ? [h(XhHeatmapTooltip, null, () => tooltipSlot(api.activeCell))] : [];
-	if (api.matrixGrid) return [
-		...renderMatrixTree(api.matrixGrid, cellSlot),
-		...tooltip,
-		legend
-	];
-	if (api.monthGrid) return [
-		...renderMonthTree(api.monthGrid, cellSlot),
-		...tooltip,
-		legend
-	];
-	const monthRow = h(XhHeatmapRow, null, () => [h(XhHeatmapWeekDay), ...api.grid.months.map((month) => h(XhHeatmapMonthLabel, {
-		key: month.value,
-		value: month.value
-	}, () => month.label))]);
-	const weekRows = api.grid.rows.map((row) => h(XhHeatmapRow, {
-		key: row.weekDay,
-		value: row.weekDay
-	}, () => [h(XhHeatmapWeekDay, { value: row.weekDay }, () => api.grid.weekDays[row.weekDay]?.label ?? ""), ...row.cells.map((cell) => h(XhHeatmapCell, {
-		key: cell.date,
-		value: cell.date
-	}, () => cellSlot?.(cell) ?? []))]));
-	return [
-		monthRow,
-		h(XhHeatmapGrid, null, () => weekRows),
-		...tooltip,
-		legend
-	];
-}
-/** 月历形态：网格中一个自然月一块，块内先一条星期名坐标轴，再逐周一行。 */
-function renderMonthTree(grid, cellSlot) {
-	const blocks = grid.blocks.map((block) => h(XhHeatmapMonthBlock, {
-		key: block.value,
-		value: block.value
-	}, () => [
-		h(XhHeatmapMonthLabel, { value: block.value }, () => block.label),
-		h(XhHeatmapRow, null, () => grid.weekDays.map((day) => h(XhHeatmapWeekDay, {
-			key: day.weekDay,
-			value: day.weekDay
-		}, () => day.label))),
-		...block.weeks.map((row) => h(XhHeatmapRow, {
-			key: row.week,
-			value: row.week
-		}, () => row.cells.map((cell) => h(XhHeatmapCell, {
-			key: cell.date,
-			value: cell.date
-		}, () => cellSlot?.(cell) ?? []))))
-	]));
-	return [h(XhHeatmapGrid, null, () => blocks)];
-}
-/** 矩阵形态：首行是列名，其余每行行首一个行名、其后逐列一格。 */
-function renderMatrixTree(grid, cellSlot) {
-	const header = h(XhHeatmapRow, null, () => [h(XhHeatmapRowLabel), ...grid.columns.map((column) => h(XhHeatmapColumnLabel, {
-		key: column.value,
-		value: column.value
-	}, () => column.label))]);
-	const rows = grid.rows.map((row) => h(XhHeatmapRow, {
-		key: row.value,
-		value: row.value
-	}, () => [h(XhHeatmapRowLabel, { value: row.value }, () => row.label), ...grid.columns.map((column) => {
-		const meta = grid.cells.get(heatmapMatrixKey(row.value, column.value));
-		return h(XhHeatmapCell, {
-			key: column.value,
-			value: column.value
-		}, () => meta == null ? [] : cellSlot?.(meta) ?? []);
-	})]));
-	return [h(XhHeatmapGrid, null, () => [header, ...rows])];
+function renderDefaultStructure(api, cellSlot, tooltipSlot, emptySlot) {
+	return renderStructure(heatmapStructure(api, { tooltip: !!tooltipSlot }), HEATMAP_PARTS, (node) => {
+		if (node.part === "cell") return node.data == null ? [] : cellSlot?.(node.data) ?? [];
+		if (node.part === "tooltip") return tooltipSlot?.(api.activeCell);
+		if (node.part === "empty") return emptySlot?.() ?? api.emptyText;
+	});
 }
 //#endregion
-export { XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDay };
+export { XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapEmpty, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDay };
 
 //# sourceMappingURL=heatmap.js.map

package/dist/components/heatmap/heatmap.js.map

@@ -1 +1 @@
-{"version":3,"file":"heatmap.js","names":[],"sources":["../../../src/components/heatmap/heatmap.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// 提供 heatmap 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  HeatmapApi,\n  HeatmapAxisInput,\n  HeatmapCellDetails,\n  HeatmapCellMeta,\n  HeatmapLegendBound,\n  HeatmapMatrixCellMeta,\n  HeatmapMatrixGrid,\n  HeatmapMonthGrid,\n  HeatmapPalette,\n  HeatmapPolarity,\n  HeatmapRowProps,\n  HeatmapScaleMode,\n  HeatmapSchema,\n  HeatmapTranslations,\n  HeatmapValue,\n  HeatmapVariant,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { heatmapMatrixKey, normalizeHeatmapNumber, normalizeHeatmapString } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideHeatmap,\n  provideHeatmapMonth,\n  provideHeatmapRow,\n  useHeatmapContext,\n  useHeatmapMonth,\n  useHeatmapRow,\n} from './context'\nimport { useHeatmap } from './use-heatmap'\n\ntype HeatmapProps = HeatmapSchema['props']\n\n/**\n * 默认插槽的载荷：三张网格模型与锚点、当前详情，以及移动锚点的动作。\n * 三形态通用的一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也包含在内：\n * 矩阵形态下带 Date 的一组恒为 null，自行铺设矩阵时只有这一组能读取、移动锚点。\n */\nexport type HeatmapRootSlotProps = Pick<\n  HeatmapApi,\n  | 'variant'\n  | 'grid'\n  | 'monthGrid'\n  | 'matrixGrid'\n  | 'focusedCell'\n  | 'focusedDate'\n  | 'anchorCell'\n  | 'anchorDate'\n  | 'activeCell'\n  | 'detailOpen'\n  | 'scaleMode'\n  | 'legendItems'\n  | 'cellAt'\n  | 'setFocusedCell'\n  | 'setFocusedDate'\n>\n\n/**\n * `cell` 插槽的载荷：日期形态给日历的格子，矩阵形态给矩阵的格子。\n * 两者的坐标不同，用 `'date' in cell` 区分。\n */\nexport type HeatmapCellSlotProps = HeatmapCellMeta | HeatmapMatrixCellMeta\n\nexport const XhHeatmapRoot = defineComponent({\n  name: 'XhHeatmapRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    variant: { type: String as PropType<HeatmapVariant> },\n    value: { type: Array as PropType<HeatmapValue[]> },\n    rows: { type: Array as PropType<HeatmapAxisInput[]> },\n    columns: { type: Array as PropType<HeatmapAxisInput[]> },\n    startDate: { type: String },\n    endDate: { type: String },\n    levels: { type: Number },\n    thresholds: { type: Array as PropType<number[]> },\n    scale: { type: String as PropType<HeatmapScaleMode> },\n    midpoint: { type: Number },\n    continuous: { type: Boolean, default: undefined },\n    firstDayOfWeek: { type: Number },\n    locale: { type: String },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    palette: { type: String as PropType<HeatmapPalette> },\n    size: { type: String as PropType<Size> },\n    animated: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<HeatmapTranslations>> },\n  },\n  // 只读事件，没有双向绑定：热力图不产生值，只报焦点、详情与按下落在哪一格\n  emits: {\n    'cell-focus': (_details: PayloadOf<HeatmapProps, 'onCellFocus'>) => true,\n    'cell-active': (_details: PayloadOf<HeatmapProps, 'onCellActive'>) => true,\n    'cell-press': (_details: PayloadOf<HeatmapProps, 'onCellPress'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HeatmapRootSlotProps) => VNode[]\n    /** 铺开网格时每一格的内容插槽，默认是空格子；三种形态都铺设。 */\n    cell?: (props: HeatmapCellSlotProps) => VNode[]\n    /** 详情条的内容插槽；写了它才会铺设 tooltip 部件。 */\n    tooltip?: (props: HeatmapCellDetails | null) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyFocus: HeatmapProps['onCellFocus'] = details => emit('cell-focus', details)\n    const notifyActive: HeatmapProps['onCellActive'] = details => emit('cell-active', details)\n    const notifyPress: HeatmapProps['onCellPress'] = details => emit('cell-press', details)\n    const ctx = useHeatmap(withXhConfig('heatmap', props) as HeatmapProps, notifyFocus, notifyActive, notifyPress)\n    provideHeatmap(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        {\n          ...api.getRootProps() as Record<string, unknown>,\n          ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n        },\n        slots.default\n          ? slots.default({\n              variant: api.variant,\n              grid: api.grid,\n              monthGrid: api.monthGrid,\n              matrixGrid: api.matrixGrid,\n              focusedCell: api.focusedCell,\n              focusedDate: api.focusedDate,\n              anchorCell: api.anchorCell,\n              anchorDate: api.anchorDate,\n              activeCell: api.activeCell,\n              detailOpen: api.detailOpen,\n              scaleMode: api.scaleMode,\n              legendItems: api.legendItems,\n              cellAt: api.cellAt,\n              setFocusedCell: api.setFocusedCell,\n              setFocusedDate: api.setFocusedDate,\n            })\n          : renderDefaultTree(api, slots.cell, slots.tooltip),\n      )\n    }\n  },\n})\n\n/** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */\nexport const XhHeatmapGrid = defineComponent({\n  name: 'XhHeatmapGrid',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月历形态中的一个自然月块，块内的行从这里取月份身份。 */\nexport const XhHeatmapMonthBlock = defineComponent({\n  name: 'XhHeatmapMonthBlock',\n  props: {\n    /** 月份身份 YYYY-MM。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    provideHeatmapMonth(computed(() => props.value))\n    return () => h('div', ctx.api.value.getMonthBlockProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一行。身份写在 value 上，解释方式由形态决定：\n * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；未写即坐标轴行。\n */\nexport const XhHeatmapRow = defineComponent({\n  name: 'XhHeatmapRow',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n    /** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */\n    month: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const blockMonth = useHeatmapMonth()\n    const row = computed<HeatmapRowProps>(() => {\n      const variant = ctx.api.value.variant\n      if (variant === 'matrix')\n        return { row: normalizeHeatmapString(props.value) }\n      if (variant === 'month')\n        return { month: props.month ?? blockMonth?.value, week: normalizeHeatmapNumber(props.value) }\n      return { weekDay: normalizeHeatmapNumber(props.value) }\n    })\n    provideHeatmapRow(computed(() => row.value.row))\n    return () => h('div', ctx.api.value.getRowProps(row.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行首的星期名。未提供行序即坐标轴行行首的占位，它只负责让月份与格子对齐。 */\nexport const XhHeatmapWeekDay = defineComponent({\n  name: 'XhHeatmapWeekDay',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const weekDay = computed(() => normalizeHeatmapNumber(props.value))\n    return () => h('span', ctx.api.value.getWeekDayProps({ weekDay: weekDay.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月份名。日历形态中横跨该月所占的列，月历形态中是一块的标题。 */\nexport const XhHeatmapMonthLabel = defineComponent({\n  name: 'XhHeatmapMonthLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getMonthLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的行名。未写 value 即表头行行首的角落占位。 */\nexport const XhHeatmapRowLabel = defineComponent({\n  name: 'XhHeatmapRowLabel',\n  props: {\n    value: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getRowLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的列名。 */\nexport const XhHeatmapColumnLabel = defineComponent({\n  name: 'XhHeatmapColumnLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getColumnLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一格。日期形态中 value 是 ISO 日期，矩阵形态中 value 是列身份、\n * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 查询网格。\n */\nexport const XhHeatmapCell = defineComponent({\n  name: 'XhHeatmapCell',\n  props: {\n    value: { type: String, required: true },\n    /** 矩阵形态：行身份；写在行中时不必再写一遍。 */\n    row: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const parentRow = useHeatmapRow()\n    const cell = computed(() => ctx.api.value.variant === 'matrix'\n      ? { row: props.row ?? parentRow?.value, column: props.value }\n      : { date: props.value })\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 详情条：悬停或聚焦到某一格时显示，位置由连接层测量后写为内联样式。 */\nexport const XhHeatmapTooltip = defineComponent({\n  name: 'XhHeatmapTooltip',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getTooltipProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 色阶对照条。 */\nexport const XhHeatmapLegend = defineComponent({\n  name: 'XhHeatmapLegend',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条一端的文字：value 写 low 或 high，文字从 api.legendText 取。 */\nexport const XhHeatmapLegendLabel = defineComponent({\n  name: 'XhHeatmapLegendLabel',\n  props: {\n    /** 挂在哪一端：low 是色阶起点，high 是终点。 */\n    value: { type: String as PropType<HeatmapLegendBound>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getLegendLabelProps({ bound: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条中的一格，与网格中同档（发散色阶下同侧同档）的格子同色。 */\nexport const XhHeatmapLegendItem = defineComponent({\n  name: 'XhHeatmapLegendItem',\n  props: {\n    /** 档位，兼收字符串。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    /** 发散色阶下这一格在中点的哪一侧；顺序色阶与中点那一格不写。 */\n    polarity: { type: String as PropType<HeatmapPolarity> },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const level = computed(() => Number(props.value) || 0)\n    return () => h('span', ctx.api.value.getLegendItemProps({ level: level.value, polarity: props.polarity ?? null }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按网格模型铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 详情条只有写了 tooltip 插槽才铺设，未写时整棵树与从前逐字一致。\n */\nfunction renderDefaultTree(\n  api: HeatmapApi,\n  cellSlot?: (node: HeatmapCellSlotProps) => VNode[],\n  tooltipSlot?: (details: HeatmapCellDetails | null) => VNode[],\n): VNode[] {\n  // 两端各一个字：一排色块自己说不出哪头是多\n  const legend = h(\n    XhHeatmapLegend,\n    null,\n    () => [\n      h(XhHeatmapLegendLabel, { value: 'low' }, () => api.legendText.low),\n      ...api.legendItems.map(item => h(XhHeatmapLegendItem, { key: `${item.polarity ?? 'center'}-${item.level}`, value: item.level, polarity: item.polarity ?? undefined })),\n      h(XhHeatmapLegendLabel, { value: 'high' }, () => api.legendText.high),\n    ],\n  )\n  const tooltip = tooltipSlot\n    ? [h(XhHeatmapTooltip, null, () => tooltipSlot(api.activeCell))]\n    : []\n\n  if (api.matrixGrid)\n    return [...renderMatrixTree(api.matrixGrid, cellSlot), ...tooltip, legend]\n  if (api.monthGrid)\n    return [...renderMonthTree(api.monthGrid, cellSlot), ...tooltip, legend]\n\n  // 月份行排在网格之外：它只是一条对齐用的坐标轴，进了网格就得冒充表格行\n  const monthRow = h(XhHeatmapRow, null, () => [\n    // 行首占位：与下面各行的星期名同宽，月份才对得上列\n    h(XhHeatmapWeekDay),\n    ...api.grid.months.map(month => h(XhHeatmapMonthLabel, { key: month.value, value: month.value }, () => month.label)),\n  ])\n  const weekRows = api.grid.rows.map(row => h(XhHeatmapRow, { key: row.weekDay, value: row.weekDay }, () => [\n    h(XhHeatmapWeekDay, { value: row.weekDay }, () => api.grid.weekDays[row.weekDay]?.label ?? ''),\n    ...row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])),\n  ]))\n  return [monthRow, h(XhHeatmapGrid, null, () => weekRows), ...tooltip, legend]\n}\n\n/** 月历形态：网格中一个自然月一块，块内先一条星期名坐标轴，再逐周一行。 */\nfunction renderMonthTree(grid: HeatmapMonthGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const blocks = grid.blocks.map(block => h(XhHeatmapMonthBlock, { key: block.value, value: block.value }, () => [\n    h(XhHeatmapMonthLabel, { value: block.value }, () => block.label),\n    h(XhHeatmapRow, null, () => grid.weekDays.map(day =>\n      h(XhHeatmapWeekDay, { key: day.weekDay, value: day.weekDay }, () => day.label))),\n    ...block.weeks.map(row => h(XhHeatmapRow, { key: row.week, value: row.week }, () =>\n      row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])))),\n  ]))\n  return [h(XhHeatmapGrid, null, () => blocks)]\n}\n\n/** 矩阵形态：首行是列名，其余每行行首一个行名、其后逐列一格。 */\nfunction renderMatrixTree(grid: HeatmapMatrixGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const header = h(XhHeatmapRow, null, () => [\n    // 角落占位：与下面各行的行名同宽，列名才对得上列\n    h(XhHeatmapRowLabel),\n    ...grid.columns.map(column => h(XhHeatmapColumnLabel, { key: column.value, value: column.value }, () => column.label)),\n  ])\n  const rows = grid.rows.map(row => h(XhHeatmapRow, { key: row.value, value: row.value }, () => [\n    h(XhHeatmapRowLabel, { value: row.value }, () => row.label),\n    ...grid.columns.map((column) => {\n      const meta = grid.cells.get(heatmapMatrixKey(row.value, column.value))\n      return h(\n        XhHeatmapCell,\n        { key: column.value, value: column.value },\n        () => (meta == null ? [] : cellSlot?.(meta) ?? []),\n      )\n    }),\n  ]))\n  return [h(XhHeatmapGrid, null, () => [header, ...rows])]\n}\n"],"mappings":"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"}
+{"version":3,"file":"heatmap.js","names":[],"sources":["../../../src/components/heatmap/heatmap.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// 提供 heatmap 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  HeatmapApi,\n  HeatmapAxisInput,\n  HeatmapCellMeta,\n  HeatmapDatumDetails,\n  HeatmapLegendBound,\n  HeatmapMatrixCellMeta,\n  HeatmapPalette,\n  HeatmapPolarity,\n  HeatmapRowProps,\n  HeatmapScaleMode,\n  HeatmapSchema,\n  HeatmapTranslations,\n  HeatmapValue,\n  HeatmapVariant,\n  NumberFormatSpec,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { heatmapStructure, normalizeHeatmapNumber, normalizeHeatmapString } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport {\n  provideHeatmap,\n  provideHeatmapMonth,\n  provideHeatmapRow,\n  useHeatmapContext,\n  useHeatmapMonth,\n  useHeatmapRow,\n} from './context'\nimport { useHeatmap } from './use-heatmap'\n\ntype HeatmapProps = HeatmapSchema['props']\n\n/**\n * 默认插槽的载荷：三张网格模型与锚点、当前详情，以及移动锚点的动作。\n * 三形态通用的一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也包含在内：\n * 矩阵形态下带 Date 的一组恒为 null，自行铺设矩阵时只有这一组能读取、移动锚点。\n */\nexport type HeatmapRootSlotProps = Pick<\n  HeatmapApi,\n  | 'variant'\n  | 'grid'\n  | 'monthGrid'\n  | 'matrixGrid'\n  | 'focusedCell'\n  | 'focusedDate'\n  | 'anchorCell'\n  | 'anchorDate'\n  | 'activeCell'\n  | 'activeKey'\n  | 'empty'\n  | 'detailOpen'\n  | 'scaleMode'\n  | 'legendItems'\n  | 'cellAt'\n  | 'setFocusedCell'\n  | 'setFocusedDate'\n>\n\n/**\n * `cell` 插槽的载荷：日期形态给日历的格子，矩阵形态给矩阵的格子。\n * 两者的坐标不同，用 `'date' in cell` 区分。\n */\nexport type HeatmapCellSlotProps = HeatmapCellMeta | HeatmapMatrixCellMeta\n\nexport const XhHeatmapRoot = defineComponent({\n  name: 'XhHeatmapRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    variant: { type: String as PropType<HeatmapVariant> },\n    value: { type: Array as PropType<HeatmapValue[]> },\n    rows: { type: Array as PropType<HeatmapAxisInput[]> },\n    columns: { type: Array as PropType<HeatmapAxisInput[]> },\n    startDate: { type: String },\n    endDate: { type: String },\n    levels: { type: Number },\n    thresholds: { type: Array as PropType<number[]> },\n    scale: { type: String as PropType<HeatmapScaleMode> },\n    midpoint: { type: Number },\n    continuous: { type: Boolean, default: undefined },\n    firstDayOfWeek: { type: Number },\n    locale: { type: String },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    palette: { type: String as PropType<HeatmapPalette> },\n    size: { type: String as PropType<Size> },\n    animated: { type: Boolean, default: undefined },\n    format: { type: [Object, Function] as PropType<NumberFormatSpec | ((value: number) => string)> },\n    pending: { type: Boolean, default: undefined },\n    activeKey: { type: [String, null] as PropType<string | null> },\n    translations: { type: Object as PropType<Partial<HeatmapTranslations>> },\n  },\n  // 热力图不产生值：报详情、按下与激活的键落在哪一格，激活的键可双向绑定\n  emits: {\n    'datum-active': (_details: PayloadOf<HeatmapProps, 'onDatumActive'>) => true,\n    'datum-press': (_details: PayloadOf<HeatmapProps, 'onDatumPress'>) => true,\n    'active-key-change': (_details: PayloadOf<HeatmapProps, 'onActiveKeyChange'>) => true,\n    'update:activeKey': (_key: PayloadOf<HeatmapProps, 'onActiveKeyChange'>['activeKey']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HeatmapRootSlotProps) => VNode[]\n    /** 铺开网格时每一格的内容插槽，默认是空格子；三种形态都铺设。 */\n    cell?: (props: HeatmapCellSlotProps) => VNode[]\n    /** 详情条的内容插槽；写了它才会铺设 tooltip 部件。 */\n    tooltip?: (props: HeatmapDatumDetails | null) => VNode[]\n    /** 缺省结构里的空态内容；未写时是空态文案。 */\n    empty?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useHeatmap(withXhConfig('heatmap', props) as HeatmapProps, {\n      onDatumActive: details => emit('datum-active', details),\n      onDatumPress: details => emit('datum-press', details),\n      onActiveKeyChange: (details) => {\n        emit('active-key-change', details)\n        emit('update:activeKey', details.activeKey)\n      },\n    })\n    provideHeatmap(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        {\n          ...api.getRootProps() as Record<string, unknown>,\n          ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n        },\n        slots.default\n          ? slots.default({\n              variant: api.variant,\n              grid: api.grid,\n              monthGrid: api.monthGrid,\n              matrixGrid: api.matrixGrid,\n              focusedCell: api.focusedCell,\n              focusedDate: api.focusedDate,\n              anchorCell: api.anchorCell,\n              anchorDate: api.anchorDate,\n              activeCell: api.activeCell,\n              activeKey: api.activeKey,\n              empty: api.empty,\n              detailOpen: api.detailOpen,\n              scaleMode: api.scaleMode,\n              legendItems: api.legendItems,\n              cellAt: api.cellAt,\n              setFocusedCell: api.setFocusedCell,\n              setFocusedDate: api.setFocusedDate,\n            })\n          : renderDefaultStructure(api, slots.cell, slots.tooltip, slots.empty),\n      )\n    }\n  },\n})\n\n/** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */\nexport const XhHeatmapGrid = defineComponent({\n  name: 'XhHeatmapGrid',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月历形态中的一个自然月块，块内的行从这里取月份身份。 */\nexport const XhHeatmapMonthBlock = defineComponent({\n  name: 'XhHeatmapMonthBlock',\n  props: {\n    /** 月份身份 YYYY-MM。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    provideHeatmapMonth(computed(() => props.value))\n    return () => h('div', ctx.api.value.getMonthBlockProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一行。身份写在 value 上，解释方式由形态决定：\n * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；未写即坐标轴行。\n */\nexport const XhHeatmapRow = defineComponent({\n  name: 'XhHeatmapRow',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n    /** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */\n    month: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const blockMonth = useHeatmapMonth()\n    const row = computed<HeatmapRowProps>(() => {\n      const variant = ctx.api.value.variant\n      if (variant === 'matrix')\n        return { row: normalizeHeatmapString(props.value) }\n      if (variant === 'month')\n        return { month: props.month ?? blockMonth?.value, week: normalizeHeatmapNumber(props.value) }\n      return { weekDay: normalizeHeatmapNumber(props.value) }\n    })\n    provideHeatmapRow(computed(() => row.value.row))\n    return () => h('div', ctx.api.value.getRowProps(row.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行首的星期名。未提供行序即坐标轴行行首的占位，它只负责让月份与格子对齐。 */\nexport const XhHeatmapWeekDay = defineComponent({\n  name: 'XhHeatmapWeekDay',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const weekDay = computed(() => normalizeHeatmapNumber(props.value))\n    return () => h('span', ctx.api.value.getWeekDayProps({ weekDay: weekDay.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月份名。日历形态中横跨该月所占的列，月历形态中是一块的标题。 */\nexport const XhHeatmapMonthLabel = defineComponent({\n  name: 'XhHeatmapMonthLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getMonthLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的行名。未写 value 即表头行行首的角落占位。 */\nexport const XhHeatmapRowLabel = defineComponent({\n  name: 'XhHeatmapRowLabel',\n  props: {\n    value: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getRowLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的列名。 */\nexport const XhHeatmapColumnLabel = defineComponent({\n  name: 'XhHeatmapColumnLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getColumnLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一格。日期形态中 value 是 ISO 日期，矩阵形态中 value 是列身份、\n * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 查询网格。\n */\nexport const XhHeatmapCell = defineComponent({\n  name: 'XhHeatmapCell',\n  props: {\n    value: { type: String, required: true },\n    /** 矩阵形态：行身份；写在行中时不必再写一遍。 */\n    row: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const parentRow = useHeatmapRow()\n    const cell = computed(() => ctx.api.value.variant === 'matrix'\n      ? { row: props.row ?? parentRow?.value, column: props.value }\n      : { date: props.value })\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 详情条：悬停或聚焦到某一格时显示，位置由连接层测量后写为内联样式。 */\nexport const XhHeatmapTooltip = defineComponent({\n  name: 'XhHeatmapTooltip',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getTooltipProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 色阶对照条。 */\nexport const XhHeatmapLegend = defineComponent({\n  name: 'XhHeatmapLegend',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条一端的文字：value 写 low 或 high，文字从 api.legendText 取。 */\nexport const XhHeatmapLegendLabel = defineComponent({\n  name: 'XhHeatmapLegendLabel',\n  props: {\n    /** 挂在哪一端：low 是色阶起点，high 是终点。 */\n    value: { type: String as PropType<HeatmapLegendBound>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getLegendLabelProps({ bound: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条中的一格，与网格中同档（发散色阶下同侧同档）的格子同色。 */\nexport const XhHeatmapLegendItem = defineComponent({\n  name: 'XhHeatmapLegendItem',\n  props: {\n    /** 档位，兼收字符串。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    /** 发散色阶下这一格在中点的哪一侧；顺序色阶与中点那一格不写。 */\n    polarity: { type: String as PropType<HeatmapPolarity> },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const level = computed(() => Number(props.value) || 0)\n    return () => h('span', ctx.api.value.getLegendItemProps({ level: level.value, polarity: props.polarity ?? null }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 空态：网格里一条数据都没有时叠在网格上，取数中改写加载文案。 */\nexport const XhHeatmapEmpty = defineComponent({\n  name: 'XhHeatmapEmpty',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst HEATMAP_PARTS = {\n  'grid': XhHeatmapGrid,\n  'month-block': XhHeatmapMonthBlock,\n  'row': XhHeatmapRow,\n  'week-day': XhHeatmapWeekDay,\n  'month-label': XhHeatmapMonthLabel,\n  'row-label': XhHeatmapRowLabel,\n  'column-label': XhHeatmapColumnLabel,\n  'cell': XhHeatmapCell,\n  'tooltip': XhHeatmapTooltip,\n  'legend': XhHeatmapLegend,\n  'legend-label': XhHeatmapLegendLabel,\n  'legend-item': XhHeatmapLegendItem,\n  'empty': XhHeatmapEmpty,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 heatmapStructure 渲，\n * 与 Web Components 只写 root 时元素生成的节点出自同一份。格子、详情条与空态的内容由对应插槽接管。\n */\nfunction renderDefaultStructure(\n  api: HeatmapApi,\n  cellSlot?: (node: HeatmapCellSlotProps) => VNode[],\n  tooltipSlot?: (details: HeatmapDatumDetails | null) => VNode[],\n  emptySlot?: () => VNode[],\n): VNode[] {\n  return renderStructure(heatmapStructure(api, { tooltip: !!tooltipSlot }), HEATMAP_PARTS, (node) => {\n    if (node.part === 'cell')\n      return node.data == null ? [] : cellSlot?.(node.data as HeatmapCellSlotProps) ?? []\n    if (node.part === 'tooltip')\n      return tooltipSlot?.(api.activeCell)\n    if (node.part === 'empty')\n      return emptySlot?.() ?? api.emptyText\n    return undefined\n  })\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
+import { HeatmapApi, HeatmapSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { HeatmapApi, HeatmapSchema } from "@xihan-ui/headless";
 //#region src/components/heatmap/use-heatmap.d.ts
 interface HeatmapContext {
   api: ComputedRef<HeatmapApi>;
@@ -9,7 +9,7 @@ interface HeatmapContext {
   /** 根：过渡的时长与减弱动效从它读。 */
   rootRef: Ref<HTMLElement | null>;
 }
-declare function useHeatmap(props: HeatmapSchema['props'], onCellFocus?: HeatmapSchema['props']['onCellFocus'], onCellActive?: HeatmapSchema['props']['onCellActive'], onCellPress?: HeatmapSchema['props']['onCellPress']): HeatmapContext;
+declare function useHeatmap(props: HeatmapSchema['props'], callbacks?: Pick<HeatmapSchema['props'], 'onDatumActive' | 'onDatumPress' | 'onActiveKeyChange'>): HeatmapContext;
 //#endregion
 export { HeatmapContext, useHeatmap };
 //# sourceMappingURL=use-heatmap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAIC,WACd,OAAO,wBACP,cAAc,uCACd,eAAe,wCACf,cAAc,wCACb"}
+{"version":3,"file":"use-heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAIC,WACd,OAAO,wBACP,YAAW,KAAK,kFACf"}

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

@@ -1,15 +1,13 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectHeatmap, heatmapMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/heatmap/use-heatmap.ts
-function useHeatmap(props, onCellFocus, onCellActive, onCellPress) {
+function useHeatmap(props, callbacks = {}) {
 	const rootRef = ref(null);
 	const service = useMachine(heatmapMachine, () => ({
 		...props,
-		onCellFocus,
-		onCellActive,
-		onCellPress
+		...callbacks
 	}));
 	service.refs.set("getRootEl", () => rootRef.value);
 	return {

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

@@ -1 +1 @@
-{"version":3,"file":"use-heatmap.js","names":[],"sources":["../../../src/components/heatmap/use-heatmap.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 heatmap 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { HeatmapApi, HeatmapSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectHeatmap, heatmapMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface HeatmapContext {\n  api: ComputedRef<HeatmapApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<HeatmapSchema>\n  /** 根：过渡的时长与减弱动效从它读。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useHeatmap(\n  props: HeatmapSchema['props'],\n  onCellFocus?: HeatmapSchema['props']['onCellFocus'],\n  onCellActive?: HeatmapSchema['props']['onCellActive'],\n  onCellPress?: HeatmapSchema['props']['onCellPress'],\n): HeatmapContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const service = useMachine(heatmapMachine, () => ({ ...props, onCellFocus, onCellActive, onCellPress }))\n  service.refs.set('getRootEl', () => rootRef.value)\n  const api = computed(() => connectHeatmap(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;AAwBA,SAAgB,WACd,OACA,aACA,cACA,aACgB;CAChB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAa;EAAc;CAAY,EAAE;CACvG,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;EAAS;CAAQ;AACjC"}
+{"version":3,"file":"use-heatmap.js","names":[],"sources":["../../../src/components/heatmap/use-heatmap.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 heatmap 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { HeatmapApi, HeatmapSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectHeatmap, heatmapMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface HeatmapContext {\n  api: ComputedRef<HeatmapApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<HeatmapSchema>\n  /** 根：过渡的时长与减弱动效从它读。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useHeatmap(\n  props: HeatmapSchema['props'],\n  callbacks: Pick<HeatmapSchema['props'], 'onDatumActive' | 'onDatumPress' | 'onActiveKeyChange'> = {},\n): HeatmapContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const service = useMachine(heatmapMachine, () => ({ ...props, ...callbacks }))\n  service.refs.set('getRootEl', () => rootRef.value)\n  const api = computed(() => connectHeatmap(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;AAwBA,SAAgB,WACd,OACA,YAAkG,CAAC,GACnF;CAChB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,GAAG;CAAU,EAAE;CAC7E,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;EAAS;CAAQ;AACjC"}

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

@@ -1,6 +1,6 @@
 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";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/hierarchy-chart/hierarchy-chart.d.ts
 type HierarchyChartProps = HierarchyChartSchema['props'];
 /** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
@@ -177,15 +177,15 @@ declare const XhHierarchyChartRoot: import("vue").DefineComponent<import("vue").
     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;
+  "onActive-key-change"?: ((_details: import("@xihan-ui/headless").ChartActiveKeyChangeDetails) => any) | undefined;
+  "onUpdate:activeKey"?: ((_key: ChartKey | null) => any) | undefined;
   "onRoot-key-change"?: ((_details: import("@xihan-ui/headless").HierarchyRootKeyChangeDetails) => any) | undefined;
   "onUpdate:rootKey"?: ((_key: string | null) => any) | undefined;
 }>, {
-  pending: boolean;
   animated: boolean;
+  pending: boolean;
 }, SlotsType<{
   /** 自行摆放部件；不写时铺开缺省结构：下钻路径、视口（绘图区与空态）、提示框。 */
   default?: (props: HierarchyChartRootSlotProps) => VNode[];

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

@@ -1,6 +1,6 @@
+import { HierarchyChartApi, HierarchyChartSchema } from "@xihan-ui/headless";
 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'>;

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

@@ -1,7 +1,7 @@
 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";
+import { computed, ref } from "vue";
 //#region src/components/hierarchy-chart/use-hierarchy-chart.ts
 /** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
 function useHierarchyChart(props, notify) {

package/dist/components/highlight/highlight.js

@@ -1,6 +1,6 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { computed, defineComponent, h } from "vue";
 import { connectHighlight } from "@xihan-ui/headless";
+import { computed, defineComponent, h } from "vue";
 //#region src/components/highlight/highlight.ts
 /**
 * 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染为 `<mark>`，其余是纯文本节点。

package/dist/components/hover-card/hover-card.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement, Size } from "@xihan-ui/core";
-import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
 //#region src/components/hover-card/hover-card.d.ts
 type HoverCardProps = HoverCardSchema['props'];
 /** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */

package/dist/components/hover-card/hover-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"mappings":";;;;;KAmBK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;IAMK,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAc/C;cAEW,kCAAkB,8BAAA;;;;;;;;;;qCAyB7B;cAEW,qCAAqB,8BAAA;;;IAID,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAY7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAS3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BASjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"mappings":";;;;;KAoBK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;IAMK,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAc/C;cAEW,kCAAkB,8BAAA;;;;;;;;;;qCAyB7B;cAEW,qCAAqB,8BAAA;;;IAID,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAY7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAQjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/hover-card/hover-card.js

@@ -1,3 +1,4 @@
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { XhPortal } from "../../runtime/portal.js";
@@ -105,23 +106,18 @@ const XhHoverCardTitle = defineComponent({
 	name: "XhHoverCardTitle",
 	setup(_, { slots }) {
 		const ctx = useHoverCardContext();
-		return () => h("h2", {
-			...ctx.api.value.getTitleProps(),
-			ref: (el) => {
-				ctx.titleRef.value = el;
-			}
-		}, slots.default?.());
+		useTitleDescriptionPart(ctx.presence, "title");
+		return () => h("h2", ctx.api.value.getTitleProps(), slots.default?.());
 	}
 });
 const XhHoverCardDescription = defineComponent({
 	name: "XhHoverCardDescription",
 	setup(_, { slots }) {
 		const ctx = useHoverCardContext();
+		const el = useDescriptionPart(ctx.presence);
 		return () => h("p", {
 			...ctx.api.value.getDescriptionProps(),
-			ref: (el) => {
-				ctx.descriptionRef.value = el;
-			}
+			ref: el
 		}, slots.default?.());
 	}
 });