@xihan-ui/vue 1.1.0 → 2.0.0

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

@@ -1,80 +1,65 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Size, Tone } from "@xihan-ui/core";
 import { HeatmapApi, HeatmapAxisInput, HeatmapCellDetails, HeatmapCellMeta, HeatmapLegendBound, HeatmapMatrixCellMeta, HeatmapPalette, HeatmapSchema, HeatmapTranslations, HeatmapValue, HeatmapVariant } from "@xihan-ui/headless";
-import { Direction, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/heatmap/heatmap.d.ts
 type HeatmapProps = HeatmapSchema['props'];
 /**
- * 默认插槽的载荷：三张网格模型与锚点、当前详情，外加挪锚点的动作。
- * 三形态通用的那一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也在里面：
- * 矩阵形态下带 Date 的那一组恒为 null，自己铺矩阵时只有这一组读得出、挪得动锚点。
+ * 默认插槽的载荷：三张网格模型与锚点、当前详情，以及移动锚点的动作。
+ * 三形态通用的一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也包含在内：
+ * 矩阵形态下带 Date 的一组恒为 null，自行铺设矩阵时只有这一组能读取、移动锚点。
  */
 type HeatmapRootSlotProps = Pick<HeatmapApi, 'variant' | 'grid' | 'monthGrid' | 'matrixGrid' | 'focusedCell' | 'focusedDate' | 'anchorCell' | 'anchorDate' | 'activeCell' | 'detailOpen' | 'cellAt' | 'setFocusedCell' | 'setFocusedDate'>;
 /**
- * `cell` 插槽的载荷：日期形态给日历那一格，矩阵形态给矩阵那一格。
- * 两者的坐标不同，用 `'date' in cell` 分辨。
+ * `cell` 插槽的载荷：日期形态给日历的格子，矩阵形态给矩阵的格子。
+ * 两者的坐标不同，用 `'date' in cell` 区分。
  */
 type HeatmapCellSlotProps = HeatmapCellMeta | HeatmapMatrixCellMeta;
 declare const XhHeatmapRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   variant: {
     type: PropType<HeatmapVariant>;
-    default: undefined;
   };
   value: {
     type: PropType<HeatmapValue[]>;
-    default: undefined;
   };
   rows: {
     type: PropType<HeatmapAxisInput[]>;
-    default: undefined;
   };
   columns: {
     type: PropType<HeatmapAxisInput[]>;
-    default: undefined;
   };
   startDate: {
     type: StringConstructor;
-    default: undefined;
   };
   endDate: {
     type: StringConstructor;
-    default: undefined;
   };
   levels: {
     type: NumberConstructor;
-    default: undefined;
   };
   thresholds: {
     type: PropType<number[]>;
-    default: undefined;
   };
   firstDayOfWeek: {
     type: NumberConstructor;
-    default: undefined;
   };
   locale: {
     type: StringConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   palette: {
     type: PropType<HeatmapPalette>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<HeatmapTranslations>>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -84,95 +69,64 @@ declare const XhHeatmapRoot: import("vue").DefineComponent<import("vue").Extract
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   variant: {
     type: PropType<HeatmapVariant>;
-    default: undefined;
   };
   value: {
     type: PropType<HeatmapValue[]>;
-    default: undefined;
   };
   rows: {
     type: PropType<HeatmapAxisInput[]>;
-    default: undefined;
   };
   columns: {
     type: PropType<HeatmapAxisInput[]>;
-    default: undefined;
   };
   startDate: {
     type: StringConstructor;
-    default: undefined;
   };
   endDate: {
     type: StringConstructor;
-    default: undefined;
   };
   levels: {
     type: NumberConstructor;
-    default: undefined;
   };
   thresholds: {
     type: PropType<number[]>;
-    default: undefined;
   };
   firstDayOfWeek: {
     type: NumberConstructor;
-    default: undefined;
   };
   locale: {
     type: StringConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   palette: {
     type: PropType<HeatmapPalette>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<HeatmapTranslations>>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onCell-focus"?: ((_details: HeatmapCellDetails) => any) | undefined;
   "onCell-active"?: ((_details: HeatmapCellDetails | null) => any) | undefined;
-}>, {
-  value: HeatmapValue[];
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  translations: Partial<HeatmapTranslations>;
-  variant: HeatmapVariant;
-  locale: string;
-  levels: number;
-  columns: HeatmapAxisInput[];
-  startDate: string;
-  endDate: string;
-  rows: HeatmapAxisInput[];
-  thresholds: number[];
-  firstDayOfWeek: number;
-  palette: HeatmapPalette;
-}, SlotsType<{
+}>, {}, SlotsType<{
   default?: (props: HeatmapRootSlotProps) => VNode[];
-  /** 铺开网格时每一格的内容插槽，缺省是空格子；三种形态都铺。 */
+  /** 铺开网格时每一格的内容插槽，默认是空格子；三种形态都铺设。 */
   cell?: (props: HeatmapCellSlotProps) => VNode[];
-  /** 详情条的内容插槽；写了它才会铺出 tooltip 部件。 */
+  /** 详情条的内容插槽；写了它才会铺设 tooltip 部件。 */
   tooltip?: (props: HeatmapCellDetails | null) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** role=grid 的容器：键盘在这里收口，可及名字也长在它身上。 */
+/** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */
 declare const XhHeatmapGrid: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 月历形态里的一个自然月块，块内的行从这里取月份身份。 */
+/** 月历形态中的一个自然月块，块内的行从这里取月份身份。 */
 declare const XhHeatmapMonthBlock: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 月份身份 YYYY-MM。 */
   value: {
@@ -189,52 +143,41 @@ declare const XhHeatmapMonthBlock: import("vue").DefineComponent<import("vue").E
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
- * 一行。身份写在 value 上，怎么解释由形态决定：
- * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；不写即坐标轴那一行。
+ * 一行。身份写在 value 上，解释方式由形态决定：
+ * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；未写即坐标轴行。
  */
 declare const XhHeatmapRow: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<number | string>;
-    default: undefined;
   };
-  /** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */
+  /** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */
   month: {
     type: StringConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<number | string>;
-    default: undefined;
   };
-  /** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */
+  /** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */
   month: {
     type: StringConstructor;
-    default: undefined;
-  };
-}>> & Readonly<{}>, {
-  value: string | number;
-  month: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 行首的星期名。不给行序即坐标轴那一行行首的占位，它只负责让月份与格子对齐。 */
-declare const XhHeatmapWeekDayLabel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 行首的星期名。未提供行序即坐标轴行行首的占位，它只负责让月份与格子对齐。 */
+declare const XhHeatmapWeekDay: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<number | string>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<number | string>;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  value: string | number;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 月份名。日历形态里横跨这个月占的那几列，月历形态里是一块的标题。 */
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 月份名。日历形态中横跨该月所占的列，月历形态中是一块的标题。 */
 declare const XhHeatmapMonthLabel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -248,22 +191,18 @@ declare const XhHeatmapMonthLabel: import("vue").DefineComponent<import("vue").E
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 矩阵的行名。不写 value 即表头行行首那个角落占位。 */
+/** 矩阵的行名。未写 value 即表头行行首的角落占位。 */
 declare const XhHeatmapRowLabel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  value: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 矩阵的列名。 */
 declare const XhHeatmapColumnLabel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
@@ -279,18 +218,17 @@ declare const XhHeatmapColumnLabel: import("vue").DefineComponent<import("vue").
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
- * 一格。日期形态里 value 是 ISO 日期，矩阵形态里 value 是列身份、
- * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 回网格里查。
+ * 一格。日期形态中 value 是 ISO 日期，矩阵形态中 value 是列身份、
+ * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 查询网格。
  */
 declare const XhHeatmapCell: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
     required: true;
   };
-  /** 矩阵形态：行身份；写在行里就不必再写一遍。 */
+  /** 矩阵形态：行身份；写在行中时不必再写一遍。 */
   row: {
     type: StringConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -299,15 +237,12 @@ declare const XhHeatmapCell: import("vue").DefineComponent<import("vue").Extract
     type: StringConstructor;
     required: true;
   };
-  /** 矩阵形态：行身份；写在行里就不必再写一遍。 */
+  /** 矩阵形态：行身份；写在行中时不必再写一遍。 */
   row: {
     type: StringConstructor;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  row: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 详情条：悬停或聚焦到某一格时显示，位置由连接层量好写成内联样式。 */
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 详情条：悬停或聚焦到某一格时显示，位置由连接层测量后写为内联样式。 */
 declare const XhHeatmapTooltip: 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>;
@@ -315,7 +250,7 @@ declare const XhHeatmapTooltip: import("vue").DefineComponent<{}, () => VNode<im
 declare const XhHeatmapLegend: 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>;
-/** 对照条一端的那个字：value 写 low 或 high，文字从 api.legendText 取。 */
+/** 对照条一端的文字：value 写 low 或 high，文字从 api.legendText 取。 */
 declare const XhHeatmapLegendLabel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 挂在哪一端：low 是色阶起点，high 是终点。 */
   value: {
@@ -331,7 +266,7 @@ declare const XhHeatmapLegendLabel: import("vue").DefineComponent<import("vue").
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 对照条里的一格，与网格里同档的格子同色。 */
+/** 对照条中的一格，与网格中同档的格子同色。 */
 declare const XhHeatmapLegendItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 档位，兼收字符串。 */
   value: {
@@ -348,5 +283,5 @@ declare const XhHeatmapLegendItem: import("vue").DefineComponent<import("vue").E
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { HeatmapCellSlotProps, HeatmapRootSlotProps, XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDayLabel };
+export { HeatmapCellSlotProps, HeatmapRootSlotProps, XhHeatmapCell, XhHeatmapColumnLabel, 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":";;;;;KAgCK,eAAe;;;;;;KAOR,uBAAuB,KACjC;;;;;KAoBU,uBAAuB,kBAAkB;cAExC,6BAAa,8BAAA;;IAIK,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA;;;;;;;;;;;;IAGN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAIxB,eAAA,UAAA,UAAU;EACT,gBAAA,UAAA,UAAU;;;IAnBT,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA;;;;;;;;;;;;IAGN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EAQvC,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,yBAAyB;;EAE9B,WAAC,OAAO,8BAA8B;kCAgClD;;cAGW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;;;MAW9B,oDAAA;;;;;cAMW,4BAAY,8BAAA;;IAGc,MAAA;;;;;;;;;;;;IAAA,MAAA;;;;;;;;;;;qCAkBrC;;cAGW,qCAAqB,8BAAA;;IAGK,MAAA;;;;;;;IAAA,MAAA;;;;;qCAOrC;;cAGW,mCAAmB,8BAAA;;;;;;;;;;;;MAS9B,oDAAA;;cAGW,iCAAiB,8BAAA;;;;;;;;;;;;;;qCAS5B;;cAGW,oCAAoB,8BAAA;;;;;;;;;;;;MAS/B,oDAAA;;;;;cAMW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;qCAexB;;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;;;;;;;;IAAA,MAAA;;;MAOrC,oDAAA"}
+{"version":3,"file":"heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/heatmap.ts"],"mappings":";;;;;KAuCK,eAAe;;;;;;KAOR,uBAAuB,KACjC;;;;;KAoBU,uBAAuB,kBAAkB;cAExC,6BAAa,8BAAA;;IAIK,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;;;;;;;IAGN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIxB,eAAA,UAAA,UAAU;EACT,gBAAA,UAAA,UAAU;;;IAnBT,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;IAIN,MAAA;;;;;;;;;IAGN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAQvC,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,yBAAyB;;EAE9B,WAAC,OAAO,8BAA8B;kCAgClD;;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;;;;;;;;IAAA,MAAA;;;MAOrC,oDAAA"}

package/dist/components/heatmap/heatmap.js

@@ -2,71 +2,26 @@ 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";
+import { heatmapMatrixKey, normalizeHeatmapNumber, normalizeHeatmapString } 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
-		}
+		variant: { type: String },
+		value: { type: Array },
+		rows: { type: Array },
+		columns: { type: Array },
+		startDate: { type: String },
+		endDate: { type: String },
+		levels: { type: Number },
+		thresholds: { type: Array },
+		firstDayOfWeek: { type: Number },
+		locale: { type: String },
+		dir: { type: String },
+		tone: { type: String },
+		palette: { type: String },
+		size: { type: String },
+		translations: { type: Object }
 	},
 	emits: {
 		"cell-focus": (_details) => true,
@@ -98,7 +53,7 @@ const XhHeatmapRoot = defineComponent({
 		};
 	}
 });
-/** role=grid 的容器：键盘在这里收口，可及名字也长在它身上。 */
+/** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */
 const XhHeatmapGrid = defineComponent({
 	name: "XhHeatmapGrid",
 	setup(_, { slots }) {
@@ -106,7 +61,7 @@ const XhHeatmapGrid = defineComponent({
 		return () => h("div", ctx.api.value.getGridProps(), slots.default?.());
 	}
 });
-/** 月历形态里的一个自然月块，块内的行从这里取月份身份。 */
+/** 月历形态中的一个自然月块，块内的行从这里取月份身份。 */
 const XhHeatmapMonthBlock = defineComponent({
 	name: "XhHeatmapMonthBlock",
 	props: { 
@@ -122,52 +77,43 @@ value: {
 	}
 });
 /**
-* 一行。身份写在 value 上，怎么解释由形态决定：
-* 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；不写即坐标轴那一行。
+* 一行。身份写在 value 上，解释方式由形态决定：
+* 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；未写即坐标轴行。
 */
 const XhHeatmapRow = defineComponent({
 	name: "XhHeatmapRow",
 	props: {
-		value: {
-			type: [Number, String],
-			default: void 0
-		},
-		/** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */
-		month: {
-			type: String,
-			default: void 0
-		}
+		value: { type: [Number, String] },
+		/** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */
+		month: { type: String }
 	},
 	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 === "matrix") return { row: normalizeHeatmapString(props.value) };
 			if (variant === "month") return {
 				month: props.month ?? blockMonth?.value,
-				week: numberOf(props.value)
+				week: normalizeHeatmapNumber(props.value)
 			};
-			return { weekDay: numberOf(props.value) };
+			return { weekDay: normalizeHeatmapNumber(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
-	} },
+/** 行首的星期名。未提供行序即坐标轴行行首的占位，它只负责让月份与格子对齐。 */
+const XhHeatmapWeekDay = defineComponent({
+	name: "XhHeatmapWeekDay",
+	props: { value: { type: [Number, String] } },
 	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 weekDay = computed(() => normalizeHeatmapNumber(props.value));
+		return () => h("span", ctx.api.value.getWeekDayProps({ weekDay: weekDay.value }), slots.default?.());
 	}
 });
-/** 月份名。日历形态里横跨这个月占的那几列，月历形态里是一块的标题。 */
+/** 月份名。日历形态中横跨该月所占的列，月历形态中是一块的标题。 */
 const XhHeatmapMonthLabel = defineComponent({
 	name: "XhHeatmapMonthLabel",
 	props: { value: {
@@ -179,13 +125,10 @@ const XhHeatmapMonthLabel = defineComponent({
 		return () => h("span", ctx.api.value.getMonthLabelProps({ value: props.value }), slots.default?.());
 	}
 });
-/** 矩阵的行名。不写 value 即表头行行首那个角落占位。 */
+/** 矩阵的行名。未写 value 即表头行行首的角落占位。 */
 const XhHeatmapRowLabel = defineComponent({
 	name: "XhHeatmapRowLabel",
-	props: { value: {
-		type: String,
-		default: void 0
-	} },
+	props: { value: { type: String } },
 	setup(props, { slots }) {
 		const ctx = useHeatmapContext();
 		return () => h("span", ctx.api.value.getRowLabelProps({ value: props.value }), slots.default?.());
@@ -204,8 +147,8 @@ const XhHeatmapColumnLabel = defineComponent({
 	}
 });
 /**
-* 一格。日期形态里 value 是 ISO 日期，矩阵形态里 value 是列身份、
-* 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 回网格里查。
+* 一格。日期形态中 value 是 ISO 日期，矩阵形态中 value 是列身份、
+* 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 查询网格。
 */
 const XhHeatmapCell = defineComponent({
 	name: "XhHeatmapCell",
@@ -214,11 +157,8 @@ const XhHeatmapCell = defineComponent({
 			type: String,
 			required: true
 		},
-		/** 矩阵形态：行身份；写在行里就不必再写一遍。 */
-		row: {
-			type: String,
-			default: void 0
-		}
+		/** 矩阵形态：行身份；写在行中时不必再写一遍。 */
+		row: { type: String }
 	},
 	setup(props, { slots }) {
 		const ctx = useHeatmapContext();
@@ -230,7 +170,7 @@ const XhHeatmapCell = defineComponent({
 		return () => h("div", ctx.api.value.getCellProps(cell.value), slots.default?.());
 	}
 });
-/** 详情条：悬停或聚焦到某一格时显示，位置由连接层量好写成内联样式。 */
+/** 详情条：悬停或聚焦到某一格时显示，位置由连接层测量后写为内联样式。 */
 const XhHeatmapTooltip = defineComponent({
 	name: "XhHeatmapTooltip",
 	setup(_, { slots }) {
@@ -246,7 +186,7 @@ const XhHeatmapLegend = defineComponent({
 		return () => h("div", ctx.api.value.getLegendProps(), slots.default?.());
 	}
 });
-/** 对照条一端的那个字：value 写 low 或 high，文字从 api.legendText 取。 */
+/** 对照条一端的文字：value 写 low 或 high，文字从 api.legendText 取。 */
 const XhHeatmapLegendLabel = defineComponent({
 	name: "XhHeatmapLegendLabel",
 	props: { 
@@ -260,7 +200,7 @@ value: {
 		return () => h("span", ctx.api.value.getLegendLabelProps({ bound: props.value }), slots.default?.());
 	}
 });
-/** 对照条里的一格，与网格里同档的格子同色。 */
+/** 对照条中的一格，与网格中同档的格子同色。 */
 const XhHeatmapLegendItem = defineComponent({
 	name: "XhHeatmapLegendItem",
 	props: { 
@@ -276,9 +216,9 @@ value: {
 	}
 });
 /**
-* 没写默认插槽时按网格模型铺开的整套结构，作者只交数据。
-* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
-* 详情条只有写了 tooltip 插槽才铺，不写时整棵树与从前逐字一致。
+* 未写默认插槽时按网格模型铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 详情条只有写了 tooltip 插槽才铺设，未写时整棵树与从前逐字一致。
 */
 function renderDefaultTree(api, cellSlot, tooltipSlot) {
 	const legend = h(XhHeatmapLegend, null, () => [
@@ -300,14 +240,14 @@ function renderDefaultTree(api, cellSlot, tooltipSlot) {
 		...tooltip,
 		legend
 	];
-	const monthRow = h(XhHeatmapRow, null, () => [h(XhHeatmapWeekDayLabel), ...api.grid.months.map((month) => h(XhHeatmapMonthLabel, {
+	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(XhHeatmapWeekDayLabel, { value: row.weekDay }, () => api.grid.weekDays[row.weekDay]?.label ?? ""), ...row.cells.map((cell) => h(XhHeatmapCell, {
+	}, () => [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) ?? []))]));
@@ -318,14 +258,14 @@ function renderDefaultTree(api, cellSlot, tooltipSlot) {
 		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, {
+		h(XhHeatmapRow, null, () => grid.weekDays.map((day) => h(XhHeatmapWeekDay, {
 			key: day.weekDay,
 			value: day.weekDay
 		}, () => day.label))),
@@ -339,7 +279,7 @@ function renderMonthTree(grid, cellSlot) {
 	]));
 	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,
@@ -357,18 +297,7 @@ function renderMatrixTree(grid, cellSlot) {
 	})]));
 	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 };
+export { XhHeatmapCell, XhHeatmapColumnLabel, XhHeatmapGrid, XhHeatmapLegend, XhHeatmapLegendItem, XhHeatmapLegendLabel, XhHeatmapMonthBlock, XhHeatmapMonthLabel, XhHeatmapRoot, XhHeatmapRow, XhHeatmapRowLabel, XhHeatmapTooltip, XhHeatmapWeekDay };
 
 //# sourceMappingURL=heatmap.js.map