@xihan-ui/vue 1.0.0-alpha.2 → 1.0.0

package/dist/components/heatmap/heatmap.js

@@ -0,0 +1,374 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideHeatmap, provideHeatmapMonth, provideHeatmapRow, useHeatmapContext, useHeatmapMonth, useHeatmapRow } from "./context.js";
+import { useHeatmap } from "./use-heatmap.js";
+import { computed, defineComponent, h } from "vue";
+import { heatmapMatrixKey } from "@xihan-ui/headless";
+//#region src/components/heatmap/heatmap.ts
+const XhHeatmapRoot = defineComponent({
+	name: "XhHeatmapRoot",
+	props: {
+		variant: {
+			type: String,
+			default: void 0
+		},
+		value: {
+			type: Array,
+			default: void 0
+		},
+		rows: {
+			type: Array,
+			default: void 0
+		},
+		columns: {
+			type: Array,
+			default: void 0
+		},
+		startDate: {
+			type: String,
+			default: void 0
+		},
+		endDate: {
+			type: String,
+			default: void 0
+		},
+		levels: {
+			type: Number,
+			default: void 0
+		},
+		thresholds: {
+			type: Array,
+			default: void 0
+		},
+		firstDayOfWeek: {
+			type: Number,
+			default: void 0
+		},
+		locale: {
+			type: String,
+			default: void 0
+		},
+		dir: {
+			type: String,
+			default: void 0
+		},
+		tone: {
+			type: String,
+			default: void 0
+		},
+		palette: {
+			type: String,
+			default: void 0
+		},
+		size: {
+			type: String,
+			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
+		}
+	},
+	emits: {
+		"cell-focus": (_details) => true,
+		"cell-active": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const notifyFocus = (details) => emit("cell-focus", details);
+		const notifyActive = (details) => emit("cell-active", details);
+		const ctx = useHeatmap(withXhConfig("heatmap", props), notifyFocus, notifyActive);
+		provideHeatmap(ctx);
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				variant: api.variant,
+				grid: api.grid,
+				monthGrid: api.monthGrid,
+				matrixGrid: api.matrixGrid,
+				focusedCell: api.focusedCell,
+				focusedDate: api.focusedDate,
+				anchorCell: api.anchorCell,
+				anchorDate: api.anchorDate,
+				activeCell: api.activeCell,
+				detailOpen: api.detailOpen,
+				cellAt: api.cellAt,
+				setFocusedCell: api.setFocusedCell,
+				setFocusedDate: api.setFocusedDate
+			}) : renderDefaultTree(api, slots.cell, slots.tooltip));
+		};
+	}
+});
+/** role=grid 的容器：键盘在这里收口，可及名字也长在它身上。 */
+const XhHeatmapGrid = defineComponent({
+	name: "XhHeatmapGrid",
+	setup(_, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("div", ctx.api.value.getGridProps(), slots.default?.());
+	}
+});
+/** 月历形态里的一个自然月块，块内的行从这里取月份身份。 */
+const XhHeatmapMonthBlock = defineComponent({
+	name: "XhHeatmapMonthBlock",
+	props: { 
+	/** 月份身份 YYYY-MM。 */
+value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		provideHeatmapMonth(computed(() => props.value));
+		return () => h("div", ctx.api.value.getMonthBlockProps({ value: props.value }), slots.default?.());
+	}
+});
+/**
+* 一行。身份写在 value 上，怎么解释由形态决定：
+* 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；不写即坐标轴那一行。
+*/
+const XhHeatmapRow = defineComponent({
+	name: "XhHeatmapRow",
+	props: {
+		value: {
+			type: [Number, String],
+			default: void 0
+		},
+		/** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */
+		month: {
+			type: String,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		const blockMonth = useHeatmapMonth();
+		const row = computed(() => {
+			const variant = ctx.api.value.variant;
+			if (variant === "matrix") return { row: stringOf(props.value) };
+			if (variant === "month") return {
+				month: props.month ?? blockMonth?.value,
+				week: numberOf(props.value)
+			};
+			return { weekDay: numberOf(props.value) };
+		});
+		provideHeatmapRow(computed(() => row.value.row));
+		return () => h("div", ctx.api.value.getRowProps(row.value), slots.default?.());
+	}
+});
+/** 行首的星期名。不给行序即坐标轴那一行行首的占位，它只负责让月份与格子对齐。 */
+const XhHeatmapWeekDayLabel = defineComponent({
+	name: "XhHeatmapWeekDayLabel",
+	props: { value: {
+		type: [Number, String],
+		default: void 0
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		const weekDay = computed(() => numberOf(props.value));
+		return () => h("span", ctx.api.value.getWeekDayLabelProps({ weekDay: weekDay.value }), slots.default?.());
+	}
+});
+/** 月份名。日历形态里横跨这个月占的那几列，月历形态里是一块的标题。 */
+const XhHeatmapMonthLabel = defineComponent({
+	name: "XhHeatmapMonthLabel",
+	props: { value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("span", ctx.api.value.getMonthLabelProps({ value: props.value }), slots.default?.());
+	}
+});
+/** 矩阵的行名。不写 value 即表头行行首那个角落占位。 */
+const XhHeatmapRowLabel = defineComponent({
+	name: "XhHeatmapRowLabel",
+	props: { value: {
+		type: String,
+		default: void 0
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("span", ctx.api.value.getRowLabelProps({ value: props.value }), slots.default?.());
+	}
+});
+/** 矩阵的列名。 */
+const XhHeatmapColumnLabel = defineComponent({
+	name: "XhHeatmapColumnLabel",
+	props: { value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("span", ctx.api.value.getColumnLabelProps({ value: props.value }), slots.default?.());
+	}
+});
+/**
+* 一格。日期形态里 value 是 ISO 日期，矩阵形态里 value 是列身份、
+* 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 回网格里查。
+*/
+const XhHeatmapCell = defineComponent({
+	name: "XhHeatmapCell",
+	props: {
+		value: {
+			type: String,
+			required: true
+		},
+		/** 矩阵形态：行身份；写在行里就不必再写一遍。 */
+		row: {
+			type: String,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		const parentRow = useHeatmapRow();
+		const cell = computed(() => ctx.api.value.variant === "matrix" ? {
+			row: props.row ?? parentRow?.value,
+			column: props.value
+		} : { date: props.value });
+		return () => h("div", ctx.api.value.getCellProps(cell.value), slots.default?.());
+	}
+});
+/** 详情条：悬停或聚焦到某一格时显示，位置由连接层量好写成内联样式。 */
+const XhHeatmapTooltip = defineComponent({
+	name: "XhHeatmapTooltip",
+	setup(_, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("div", ctx.api.value.getTooltipProps(), slots.default?.());
+	}
+});
+/** 色阶对照条。 */
+const XhHeatmapLegend = defineComponent({
+	name: "XhHeatmapLegend",
+	setup(_, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("div", ctx.api.value.getLegendProps(), slots.default?.());
+	}
+});
+/** 对照条一端的那个字：value 写 low 或 high，文字从 api.legendText 取。 */
+const XhHeatmapLegendLabel = defineComponent({
+	name: "XhHeatmapLegendLabel",
+	props: { 
+	/** 挂在哪一端：low 是色阶起点，high 是终点。 */
+value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		return () => h("span", ctx.api.value.getLegendLabelProps({ bound: props.value }), slots.default?.());
+	}
+});
+/** 对照条里的一格，与网格里同档的格子同色。 */
+const XhHeatmapLegendItem = defineComponent({
+	name: "XhHeatmapLegendItem",
+	props: { 
+	/** 档位，兼收字符串。 */
+value: {
+		type: [Number, String],
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useHeatmapContext();
+		const level = computed(() => Number(props.value) || 0);
+		return () => h("span", ctx.api.value.getLegendItemProps({ level: level.value }), slots.default?.());
+	}
+});
+/**
+* 没写默认插槽时按网格模型铺开的整套结构，作者只交数据。
+* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
+* 详情条只有写了 tooltip 插槽才铺，不写时整棵树与从前逐字一致。
+*/
+function renderDefaultTree(api, cellSlot, tooltipSlot) {
+	const legend = h(XhHeatmapLegend, null, () => [
+		h(XhHeatmapLegendLabel, { value: "low" }, () => api.legendText.low),
+		...Array.from({ length: api.monthGrid?.levels ?? api.matrixGrid?.levels ?? api.grid.levels }, (_, level) => h(XhHeatmapLegendItem, {
+			key: level,
+			value: level
+		})),
+		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(XhHeatmapWeekDayLabel), ...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(XhHeatmapWeekDayLabel, { 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(XhHeatmapWeekDayLabel, {
+			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])];
+}
+/** 作者写的数字身份，兼收字符串；没写即 undefined。 */
+function numberOf(value) {
+	if (value == null || value === "") return void 0;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+/** 作者写的串身份；没写即 undefined。 */
+function stringOf(value) {
+	if (value == null || value === "") return void 0;
+	return String(value);
+}
+//#endregion
+export { XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDayLabel };
+
+//# sourceMappingURL=heatmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.js","names":[],"sources":["../../../src/components/heatmap/heatmap.ts"],"sourcesContent":["import type {\n  HeatmapApi,\n  HeatmapAxisInput,\n  HeatmapCellDetails,\n  HeatmapCellMeta,\n  HeatmapLegendBound,\n  HeatmapMatrixCellMeta,\n  HeatmapMatrixGrid,\n  HeatmapMonthGrid,\n  HeatmapPalette,\n  HeatmapRowProps,\n  HeatmapSchema,\n  HeatmapTranslations,\n  HeatmapValue,\n  HeatmapVariant,\n} from '@xihan-ui/headless'\nimport type { Direction, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { heatmapMatrixKey } 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  | '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  // 全部 default: undefined，缺省值由机器与 connect 决定\n  props: {\n    variant: { type: String as PropType<HeatmapVariant>, default: undefined },\n    value: { type: Array as PropType<HeatmapValue[]>, default: undefined },\n    rows: { type: Array as PropType<HeatmapAxisInput[]>, default: undefined },\n    columns: { type: Array as PropType<HeatmapAxisInput[]>, default: undefined },\n    startDate: { type: String, default: undefined },\n    endDate: { type: String, default: undefined },\n    levels: { type: Number, default: undefined },\n    thresholds: { type: Array as PropType<number[]>, default: undefined },\n    firstDayOfWeek: { type: Number, default: undefined },\n    locale: { type: String, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    palette: { type: String as PropType<HeatmapPalette>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<Partial<HeatmapTranslations>>, default: undefined },\n  },\n  // 只读事件，没有双向绑定：热力图不产生值，只报焦点与详情落在哪一格\n  emits: {\n    'cell-focus': (_details: PayloadOf<HeatmapProps, 'onCellFocus'>) => true,\n    'cell-active': (_details: PayloadOf<HeatmapProps, 'onCellActive'>) => 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 ctx = useHeatmap(withXhConfig('heatmap', props) as HeatmapProps, notifyFocus, notifyActive)\n    provideHeatmap(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getRootProps() as Record<string, unknown>,\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              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>, default: undefined },\n    /** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */\n    month: { type: String, default: undefined },\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: stringOf(props.value) }\n      if (variant === 'month')\n        return { month: props.month ?? blockMonth?.value, week: numberOf(props.value) }\n      return { weekDay: numberOf(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 XhHeatmapWeekDayLabel = defineComponent({\n  name: 'XhHeatmapWeekDayLabel',\n  props: {\n    value: { type: [Number, String] as PropType<number | string>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const weekDay = computed(() => numberOf(props.value))\n    return () => h('span', ctx.api.value.getWeekDayLabelProps({ 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, default: undefined },\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, default: undefined },\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  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 }) 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      ...Array.from(\n        { length: api.monthGrid?.levels ?? api.matrixGrid?.levels ?? api.grid.levels },\n        (_, level) => h(XhHeatmapLegendItem, { key: level, value: level }),\n      ),\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(XhHeatmapWeekDayLabel),\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(XhHeatmapWeekDayLabel, { 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(XhHeatmapWeekDayLabel, { 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\n/** 作者写的数字身份，兼收字符串；没写即 undefined。 */\nfunction numberOf(value: number | string | undefined): number | undefined {\n  if (value == null || value === '')\n    return undefined\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\n/** 作者写的串身份；没写即 undefined。 */\nfunction stringOf(value: number | string | undefined): string | undefined {\n  if (value == null || value === '')\n    return undefined\n  return String(value)\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import { ComputedRef } from "vue";
+import { HeatmapApi, HeatmapSchema } from "@xihan-ui/headless";
+import { Service } from "@xihan-ui/machine";
+//#region src/components/heatmap/use-heatmap.d.ts
+interface HeatmapContext {
+  api: ComputedRef<HeatmapApi>;
+  /** 机器实例，供部件上报 DOM 侧的事实。 */
+  service: Service<HeatmapSchema>;
+}
+declare function useHeatmap(props: HeatmapSchema['props'], onCellFocus?: HeatmapSchema['props']['onCellFocus'], onCellActive?: HeatmapSchema['props']['onCellActive']): HeatmapContext;
+//#endregion
+export { HeatmapContext, useHeatmap };
+//# sourceMappingURL=use-heatmap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"mappings":";;;;UAQiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,WACd,OAAO,wBACP,cAAc,uCACd,eAAe,yCACd"}

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

@@ -0,0 +1,20 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { computed } from "vue";
+import { connectHeatmap, heatmapMachine } from "@xihan-ui/headless";
+//#region src/components/heatmap/use-heatmap.ts
+function useHeatmap(props, onCellFocus, onCellActive) {
+	const service = useMachine(heatmapMachine, () => ({
+		...props,
+		onCellFocus,
+		onCellActive
+	}));
+	return {
+		api: computed(() => connectHeatmap(service, vueNormalize)),
+		service
+	};
+}
+//#endregion
+export { useHeatmap };
+
+//# sourceMappingURL=use-heatmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-heatmap.js","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"sourcesContent":["import type { HeatmapApi, HeatmapSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef } from 'vue'\nimport { connectHeatmap, heatmapMachine } from '@xihan-ui/headless'\nimport { computed } 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\n// 不建 scope：connect 不派生任何 id\nexport function useHeatmap(\n  props: HeatmapSchema['props'],\n  onCellFocus?: HeatmapSchema['props']['onCellFocus'],\n  onCellActive?: HeatmapSchema['props']['onCellActive'],\n): HeatmapContext {\n  const service = useMachine(heatmapMachine, () => ({ ...props, onCellFocus, onCellActive }))\n  const api = computed(() => connectHeatmap(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAeA,SAAgB,WACd,OACA,aACA,cACgB;CAChB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAa;CAAa,EAAE;CAE1F,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;CAAQ;AACxB"}

package/dist/components/hotkeys/hotkeys.d.ts

@@ -0,0 +1,89 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, VNode } from "vue";
+import { HotkeysPlatform, HotkeysProps, HotkeysTarget, HotkeysTranslations } from "@xihan-ui/headless";
+import { Size } from "@xihan-ui/kernel";
+//#region src/components/hotkeys/hotkeys.d.ts
+/**
+ * 把一组键铺成一排键帽，并按 target 指定的节点接住这次组合。
+ *
+ * 内容整份由 keys 与平台算出，组件不收默认插槽——键帽上写什么、连接符出不出，
+ * 两个平台的答案不一样，内容另有来源就对不上了。
+ *
+ * 注册与渲染是两件事：只要注册不要键帽就直接用 useHotkeys。
+ */
+declare const XhHotkeys: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  keys: {
+    type: PropType<string[]>;
+    default: undefined;
+  };
+  platform: {
+    type: PropType<HotkeysPlatform>;
+    default: undefined;
+  };
+  target: {
+    type: PropType<HotkeysTarget>;
+    default: undefined;
+  };
+  preventDefault: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  enabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  size: {
+    type: PropType<Size>;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<HotkeysTranslations>>;
+    default: undefined;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'hot-key': (_details: PayloadOf<HotkeysProps, "onHotKey">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  keys: {
+    type: PropType<string[]>;
+    default: undefined;
+  };
+  platform: {
+    type: PropType<HotkeysPlatform>;
+    default: undefined;
+  };
+  target: {
+    type: PropType<HotkeysTarget>;
+    default: undefined;
+  };
+  preventDefault: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  enabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  size: {
+    type: PropType<Size>;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<HotkeysTranslations>>;
+    default: undefined;
+  };
+}>> & Readonly<{
+  "onHot-key"?: ((_details: import("@xihan-ui/headless").HotkeysTriggerDetails) => any) | undefined;
+}>, {
+  keys: string[];
+  size: Size;
+  translations: Partial<HotkeysTranslations>;
+  target: HotkeysTarget;
+  platform: HotkeysPlatform;
+  preventDefault: boolean;
+  enabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { XhHotkeys };
+//# sourceMappingURL=hotkeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hotkeys.d.ts","names":[],"sources":["../../../src/components/hotkeys/hotkeys.ts"],"mappings":";;;;;;;;;;;;;cAgBa,yBAAS,8BAAA;;IAIK,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAI3B,YAAA,UAAA,UAAU;;;IAVT,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;qCAqCnD"}

package/dist/components/hotkeys/hotkeys.js

@@ -0,0 +1,83 @@
+import { withXhConfig } from "../../config/config.js";
+import { useHotkeys } from "./use-hotkeys.js";
+import { defineComponent, h, ref } from "vue";
+//#region src/components/hotkeys/hotkeys.ts
+/**
+* 把一组键铺成一排键帽，并按 target 指定的节点接住这次组合。
+*
+* 内容整份由 keys 与平台算出，组件不收默认插槽——键帽上写什么、连接符出不出，
+* 两个平台的答案不一样，内容另有来源就对不上了。
+*
+* 注册与渲染是两件事：只要注册不要键帽就直接用 useHotkeys。
+*/
+const XhHotkeys = defineComponent({
+	name: "XhHotkeys",
+	props: {
+		keys: {
+			type: Array,
+			default: void 0
+		},
+		platform: {
+			type: String,
+			default: void 0
+		},
+		target: {
+			type: String,
+			default: void 0
+		},
+		preventDefault: {
+			type: Boolean,
+			default: void 0
+		},
+		enabled: {
+			type: Boolean,
+			default: void 0
+		},
+		size: {
+			type: String,
+			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
+		}
+	},
+	emits: { "hot-key": (_details) => true },
+	setup(props, { emit }) {
+		const rootEl = ref(null);
+		const merged = withXhConfig("hotkeys", props);
+		const { api } = useHotkeys(() => ({
+			keys: props.keys,
+			platform: props.platform,
+			target: props.target,
+			preventDefault: props.preventDefault,
+			enabled: props.enabled,
+			size: props.size,
+			translations: merged.translations,
+			onHotKey: (details) => emit("hot-key", details)
+		}), rootEl);
+		return () => {
+			const current = api.value;
+			const separatorProps = current.getSeparatorProps();
+			const children = [];
+			current.segments.forEach((segment, index) => {
+				if (index > 0) children.push(h("span", {
+					...separatorProps,
+					key: `xh-hotkeys-separator-${index}`
+				}, current.separator));
+				children.push(h("kbd", {
+					...current.getKeyProps({ value: segment.source }),
+					key: `xh-hotkeys-key-${index}`
+				}, segment.label));
+			});
+			return h("span", {
+				...current.getRootProps(),
+				ref: rootEl
+			}, children);
+		};
+	}
+});
+//#endregion
+export { XhHotkeys };
+
+//# sourceMappingURL=hotkeys.js.map

package/dist/components/hotkeys/hotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotkeys.js","names":[],"sources":["../../../src/components/hotkeys/hotkeys.ts"],"sourcesContent":["import type { HotkeysPlatform, HotkeysProps, HotkeysTarget, HotkeysTranslations } from '@xihan-ui/headless'\nimport type { Size } from '@xihan-ui/kernel'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useHotkeys } from './use-hotkeys'\n\n/**\n * 把一组键铺成一排键帽，并按 target 指定的节点接住这次组合。\n *\n * 内容整份由 keys 与平台算出，组件不收默认插槽——键帽上写什么、连接符出不出，\n * 两个平台的答案不一样，内容另有来源就对不上了。\n *\n * 注册与渲染是两件事：只要注册不要键帽就直接用 useHotkeys。\n */\nexport const XhHotkeys = defineComponent({\n  name: 'XhHotkeys',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    keys: { type: Array as PropType<string[]>, default: undefined },\n    platform: { type: String as PropType<HotkeysPlatform>, default: undefined },\n    target: { type: String as PropType<HotkeysTarget>, default: undefined },\n    preventDefault: { type: Boolean, default: undefined },\n    enabled: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<Partial<HotkeysTranslations>>, default: undefined },\n  },\n  // 只读事件：组合没有可双向绑定的值\n  emits: {\n    'hot-key': (_details: PayloadOf<HotkeysProps, 'onHotKey'>) => true,\n  },\n  setup(props, { emit }) {\n    const rootEl = ref<HTMLElement | null>(null)\n    const merged = withXhConfig('hotkeys', props)\n\n    const { api } = useHotkeys(() => ({\n      keys: props.keys,\n      platform: props.platform,\n      target: props.target,\n      preventDefault: props.preventDefault,\n      enabled: props.enabled,\n      size: props.size,\n      translations: merged.translations,\n      onHotKey: details => emit('hot-key', details),\n    }), rootEl)\n\n    return () => {\n      const current = api.value\n      const separatorProps = current.getSeparatorProps() as Record<string, unknown>\n      const children: VNode[] = []\n      current.segments.forEach((segment, index) => {\n        if (index > 0)\n          children.push(h('span', { ...separatorProps, key: `xh-hotkeys-separator-${index}` }, current.separator))\n        children.push(h(\n          'kbd',\n          { ...current.getKeyProps({ value: segment.source }) as Record<string, unknown>, key: `xh-hotkeys-key-${index}` },\n          segment.label,\n        ))\n      })\n      return h('span', { ...current.getRootProps() as Record<string, unknown>, ref: rootEl }, children)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AAgBA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAA6B,SAAS,KAAA;EAAU;EAC9D,UAAU;GAAE,MAAM;GAAqC,SAAS,KAAA;EAAU;EAC1E,QAAQ;GAAE,MAAM;GAAmC,SAAS,KAAA;EAAU;EACtE,gBAAgB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACpD,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,cAAc;GAAE,MAAM;GAAkD,SAAS,KAAA;EAAU;CAC7F;CAEA,OAAO,EACL,YAAY,aAAkD,KAChE;CACA,MAAM,OAAO,EAAE,QAAQ;EACrB,MAAM,SAAS,IAAwB,IAAI;EAC3C,MAAM,SAAS,aAAa,WAAW,KAAK;EAE5C,MAAM,EAAE,QAAQ,kBAAkB;GAChC,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,QAAQ,MAAM;GACd,gBAAgB,MAAM;GACtB,SAAS,MAAM;GACf,MAAM,MAAM;GACZ,cAAc,OAAO;GACrB,WAAU,YAAW,KAAK,WAAW,OAAO;EAC9C,IAAI,MAAM;EAEV,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,iBAAiB,QAAQ,kBAAkB;GACjD,MAAM,WAAoB,CAAC;GAC3B,QAAQ,SAAS,SAAS,SAAS,UAAU;IAC3C,IAAI,QAAQ,GACV,SAAS,KAAK,EAAE,QAAQ;KAAE,GAAG;KAAgB,KAAK,wBAAwB;IAAQ,GAAG,QAAQ,SAAS,CAAC;IACzG,SAAS,KAAK,EACZ,OACA;KAAE,GAAG,QAAQ,YAAY,EAAE,OAAO,QAAQ,OAAO,CAAC;KAA8B,KAAK,kBAAkB;IAAQ,GAC/G,QAAQ,KACV,CAAC;GACH,CAAC;GACD,OAAO,EAAE,QAAQ;IAAE,GAAG,QAAQ,aAAa;IAA8B,KAAK;GAAO,GAAG,QAAQ;EAClG;CACF;AACF,CAAC"}