@xihan-ui/vue 1.1.0 → 2.0.0

package/dist/components/gradient-text/gradient-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"gradient-text.js","names":[],"sources":["../../../src/components/gradient-text/gradient-text.ts"],"sourcesContent":["import type { GradientTextDirection, GradientTextProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGradientText } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport const XhGradientText = defineComponent({\n  name: 'XhGradientText',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    from: { type: String, default: undefined },\n    to: { type: String, default: undefined },\n    direction: { type: String as PropType<GradientTextDirection>, default: undefined },\n  },\n  setup(props, { slots }) {\n    return () => h(\n      'span',\n      connectGradientText(props as GradientTextProps, vueNormalize).getRootProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;AAMA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACzC,IAAI;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACvC,WAAW;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;CACnF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,aAAa,EACX,QACA,oBAAoB,OAA4B,YAAY,CAAC,CAAC,aAAa,GAC3E,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"gradient-text.js","names":[],"sources":["../../../src/components/gradient-text/gradient-text.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// 提供 gradient text 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { GradientTextDirection, GradientTextProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGradientText } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport const XhGradientText = defineComponent({\n  name: 'XhGradientText',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    from: { type: String },\n    to: { type: String },\n    direction: { type: String as PropType<GradientTextDirection> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    return () => h(\n      'span',\n      connectGradientText(props as GradientTextProps, vueNormalize).getRootProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;AAcA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAO;EACrB,IAAI,EAAE,MAAM,OAAO;EACnB,WAAW,EAAE,MAAM,OAA0C;EAC7D,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,aAAa,EACX,QACA,oBAAoB,OAA4B,YAAY,CAAC,CAAC,aAAa,GAC3E,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/grid/context.ts"],"mappings":";;;UAIiB;EACf,KAAK,YAAY;;iBAKH,YAAY,KAAK;iBAIjB,kBAAkB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/grid/context.ts"],"mappings":";;;UAWiB;EACf,KAAK,YAAY;;iBAKH,YAAY,KAAK;iBAIjB,kBAAkB"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/grid/context.ts"],"sourcesContent":["import type { GridApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface GridContext {\n  api: ComputedRef<GridApi>\n}\n\nconst KEY: InjectionKey<GridContext> = Symbol.for('xh-grid')\n\nexport function provideGrid(ctx: GridContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useGridContext(): GridContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Grid 部件必须用在 XhGridRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/grid/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { GridApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface GridContext {\n  api: ComputedRef<GridApi>\n}\n\nconst KEY: InjectionKey<GridContext> = Symbol.for('xh-grid')\n\nexport function provideGrid(ctx: GridContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useGridContext(): GridContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Grid 部件必须用在 XhGridRoot 内')\n  return ctx\n}\n"],"mappings":";;AAeA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}

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

@@ -1,74 +1,81 @@
 import { PropType } from "vue";
-import { GridProps } from "@xihan-ui/headless";
+import { GridColumnCount, GridColumnOffset, GridItemProps, GridProps, GridRowCount } from "@xihan-ui/headless";
 //#region src/components/grid/grid.d.ts
 /** 断点对象形态的列数，从 GridProps 上取，不在这里另抄一份档位清单。 */
-type ColsByBreakpoint = Exclude<GridProps['cols'], number | undefined>;
+type ColsByBreakpoint = Exclude<GridProps['cols'], GridColumnCount | undefined>;
+/** 断点对象形态的跨列与错列，同样从类型上取。 */
+type SpanByBreakpoint = Exclude<GridItemProps['span'], GridColumnCount | undefined>;
+type OffsetByBreakpoint = Exclude<GridItemProps['offset'], GridColumnOffset | undefined>;
 declare const XhGridRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   cols: {
-    type: PropType<number | string | ColsByBreakpoint>;
-    default: undefined;
+    type: PropType<GridColumnCount | string | ColsByBreakpoint>;
+  };
+  rows: {
+    type: PropType<GridRowCount | string>;
+  };
+  minColWidth: {
+    type: PropType<GridProps["minColWidth"]>;
   };
   gap: {
     type: PropType<GridProps["gap"]>;
-    default: undefined;
+  };
+  rowGap: {
+    type: PropType<GridProps["rowGap"]>;
+  };
+  columnGap: {
+    type: PropType<GridProps["columnGap"]>;
   };
   align: {
     type: PropType<GridProps["align"]>;
-    default: undefined;
   };
-  justify: {
-    type: PropType<GridProps["justify"]>;
-    default: undefined;
+  justifyItems: {
+    type: PropType<GridProps["justifyItems"]>;
   };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   cols: {
-    type: PropType<number | string | ColsByBreakpoint>;
-    default: undefined;
+    type: PropType<GridColumnCount | string | ColsByBreakpoint>;
+  };
+  rows: {
+    type: PropType<GridRowCount | string>;
+  };
+  minColWidth: {
+    type: PropType<GridProps["minColWidth"]>;
   };
   gap: {
     type: PropType<GridProps["gap"]>;
-    default: undefined;
+  };
+  rowGap: {
+    type: PropType<GridProps["rowGap"]>;
+  };
+  columnGap: {
+    type: PropType<GridProps["columnGap"]>;
   };
   align: {
     type: PropType<GridProps["align"]>;
-    default: undefined;
-  };
-  justify: {
-    type: PropType<GridProps["justify"]>;
-    default: undefined;
-  };
-}>> & Readonly<{}>, {
-  align: import("@xihan-ui/headless").GridAlign | undefined;
-  justify: import("@xihan-ui/headless").GridJustify | undefined;
-  gap: import("@xihan-ui/headless").GridGap | undefined;
-  cols: string | number | import("@xihan-ui/headless").GridColsByBreakpoint;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+  };
+  justifyItems: {
+    type: PropType<GridProps["justifyItems"]>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhGridItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   span: {
-    type: PropType<number | string>;
-    default: undefined;
+    type: PropType<GridColumnCount | string | SpanByBreakpoint>;
   };
   offset: {
-    type: PropType<number | string>;
-    default: undefined;
+    type: PropType<GridColumnOffset | string | OffsetByBreakpoint>;
   };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   span: {
-    type: PropType<number | string>;
-    default: undefined;
+    type: PropType<GridColumnCount | string | SpanByBreakpoint>;
   };
   offset: {
-    type: PropType<number | string>;
-    default: undefined;
+    type: PropType<GridColumnOffset | string | OffsetByBreakpoint>;
   };
-}>> & Readonly<{}>, {
-  span: string | number;
-  offset: string | number;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhGridItem, XhGridRoot };
 //# sourceMappingURL=grid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","names":[],"sources":["../../../src/components/grid/grid.ts"],"mappings":";;;;KAQK,mBAAmB,QAAQ;cAuBnB,0BAAU,8BAAA;;IAMiB,MAAA,2BAA2B;;;;IAGxC,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;;;;IALA,MAAA,2BAA2B;;;;IAGxC,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;;;;;qCAYtC;cAEW,0BAAU,8BAAA;;IAIe,MAAA;;;;IACE,MAAA;;;;;;;IADF,MAAA;;;;IACE,MAAA;;;;;;qCAatC"}
+{"version":3,"file":"grid.d.ts","names":[],"sources":["../../../src/components/grid/grid.ts"],"mappings":";;;;KAeK,mBAAmB,QAAQ,mBAAmB;;KAE9C,mBAAmB,QAAQ,uBAAuB;KAClD,qBAAqB,QAAQ,yBAAyB;cAE9C,0BAAU,8BAAA;;IAMiB,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;IARL,MAAA,SAAS,2BAA2B;;;IAEtC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACF,MAAA,SAAS;;MAgB3C,oDAAA;cAEW,0BAAU,8BAAA;;IAKiB,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;;;;;IAHrC,MAAA,SAAS,2BAA2B;;;IAGpC,MAAA,SAAS,4BAA4B;;MAc3E,oDAAA"}

package/dist/components/grid/grid.js

@@ -1,60 +1,34 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { provideGrid, useGridContext } from "./context.js";
 import { computed, defineComponent, h } from "vue";
-import { connectGrid } from "@xihan-ui/headless";
+import { connectGrid, normalizeGridCount, normalizeGridTier } from "@xihan-ui/headless";
 //#region src/components/grid/grid.ts
-/** 列数的档位名，base 在前，其余自窄到宽。 */
-const COLS_TIERS = [
-	"base",
-	"sm",
-	"md",
-	"lg",
-	"xl"
-];
-/** 模板里写 cols="3" 拿到的是字符串，交给 connect 前统一转成数字。 */
-function count(value) {
-	return value == null ? void 0 : Number(value);
-}
-/** 列数：整数与字符串按单个数走；断点对象逐档转数字，没写的档不带进去。 */
-function colsOf(value) {
-	if (value == null || typeof value !== "object") return count(value);
-	const out = {};
-	for (const name of COLS_TIERS) {
-		const raw = value[name];
-		if (raw != null) out[name] = Number(raw);
-	}
-	return out;
-}
 const XhGridRoot = defineComponent({
 	name: "XhGridRoot",
 	props: {
-		cols: {
-			type: [
-				Number,
-				String,
-				Object
-			],
-			default: void 0
-		},
-		gap: {
-			type: String,
-			default: void 0
-		},
-		align: {
-			type: String,
-			default: void 0
-		},
-		justify: {
-			type: String,
-			default: void 0
-		}
+		cols: { type: [
+			Number,
+			String,
+			Object
+		] },
+		rows: { type: [Number, String] },
+		minColWidth: { type: String },
+		gap: { type: String },
+		rowGap: { type: String },
+		columnGap: { type: String },
+		align: { type: String },
+		justifyItems: { type: String }
 	},
 	setup(props, { slots }) {
 		const api = computed(() => connectGrid({
-			cols: colsOf(props.cols),
+			cols: normalizeGridTier(props.cols),
+			rows: normalizeGridCount(props.rows),
+			minColWidth: props.minColWidth,
 			gap: props.gap,
+			rowGap: props.rowGap,
+			columnGap: props.columnGap,
 			align: props.align,
-			justify: props.justify
+			justifyItems: props.justifyItems
 		}, vueNormalize));
 		provideGrid({ api });
 		return () => h("div", api.value.getRootProps(), slots.default?.());
@@ -63,20 +37,22 @@ const XhGridRoot = defineComponent({
 const XhGridItem = defineComponent({
 	name: "XhGridItem",
 	props: {
-		span: {
-			type: [Number, String],
-			default: void 0
-		},
-		offset: {
-			type: [Number, String],
-			default: void 0
-		}
+		span: { type: [
+			Number,
+			String,
+			Object
+		] },
+		offset: { type: [
+			Number,
+			String,
+			Object
+		] }
 	},
 	setup(props, { slots }) {
 		const ctx = useGridContext();
 		return () => h("div", ctx.api.value.getItemProps({
-			span: count(props.span),
-			offset: count(props.offset)
+			span: normalizeGridTier(props.span),
+			offset: normalizeGridTier(props.offset)
 		}), slots.default?.());
 	}
 });

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

@@ -1 +1 @@
-{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/grid/grid.ts"],"sourcesContent":["import type { GridProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGrid } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideGrid, useGridContext } from './context'\n\n/** 断点对象形态的列数，从 GridProps 上取，不在这里另抄一份档位清单。 */\ntype ColsByBreakpoint = Exclude<GridProps['cols'], number | undefined>\n\n/** 列数的档位名，base 在前，其余自窄到宽。 */\nconst COLS_TIERS = ['base', 'sm', 'md', 'lg', 'xl'] as const\n\n/** 模板里写 cols=\"3\" 拿到的是字符串，交给 connect 前统一转成数字。 */\nfunction count(value: number | string | undefined): number | undefined {\n  return value == null ? undefined : Number(value)\n}\n\n/** 列数：整数与字符串按单个数走；断点对象逐档转数字，没写的档不带进去。 */\nfunction colsOf(value: number | string | ColsByBreakpoint | undefined): GridProps['cols'] {\n  if (value == null || typeof value !== 'object')\n    return count(value)\n  const out: ColsByBreakpoint = {}\n  for (const name of COLS_TIERS) {\n    const raw = value[name]\n    if (raw != null)\n      out[name] = Number(raw)\n  }\n  return out\n}\n\nexport const XhGridRoot = defineComponent({\n  name: 'XhGridRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    // 列数由作者声明：兼收字符串以支持模板里写 cols=\"3\"，收对象则是逐档的列数\n    cols: {\n      type: [Number, String, Object] as PropType<number | string | ColsByBreakpoint>,\n      default: undefined,\n    },\n    gap: { type: String as PropType<GridProps['gap']>, default: undefined },\n    align: { type: String as PropType<GridProps['align']>, default: undefined },\n    justify: { type: String as PropType<GridProps['justify']>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectGrid({\n      cols: colsOf(props.cols),\n      gap: props.gap,\n      align: props.align,\n      justify: props.justify,\n    }, vueNormalize))\n    provideGrid({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhGridItem = defineComponent({\n  name: 'XhGridItem',\n  props: {\n    // 跨列与错列由每一格自报，同样兼收字符串\n    span: { type: [Number, String] as PropType<number | string>, default: undefined },\n    offset: { type: [Number, String] as PropType<number | string>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useGridContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({\n        span: count(props.span),\n        offset: count(props.offset),\n      }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;;AAWA,MAAM,aAAa;CAAC;CAAQ;CAAM;CAAM;CAAM;AAAI;;AAGlD,SAAS,MAAM,OAAwD;CACrE,OAAO,SAAS,OAAO,KAAA,IAAY,OAAO,KAAK;AACjD;;AAGA,SAAS,OAAO,OAA0E;CACxF,IAAI,SAAS,QAAQ,OAAO,UAAU,UACpC,OAAO,MAAM,KAAK;CACpB,MAAM,MAAwB,CAAC;CAC/B,KAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,MAAM,MAAM;EAClB,IAAI,OAAO,MACT,IAAI,QAAQ,OAAO,GAAG;CAC1B;CACA,OAAO;AACT;AAEA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EAEL,MAAM;GACJ,MAAM;IAAC;IAAQ;IAAQ;GAAM;GAC7B,SAAS,KAAA;EACX;EACA,KAAK;GAAE,MAAM;GAAsC,SAAS,KAAA;EAAU;EACtE,OAAO;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;EAC1E,SAAS;GAAE,MAAM;GAA0C,SAAS,KAAA;EAAU;CAChF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY;GACrC,MAAM,OAAO,MAAM,IAAI;GACvB,KAAK,MAAM;GACX,OAAO,MAAM;GACb,SAAS,MAAM;EACjB,GAAG,YAAY,CAAC;EAChB,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EAEL,MAAM;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAgC,SAAS,KAAA;EAAU;EAChF,QAAQ;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAgC,SAAS,KAAA;EAAU;CACpF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa;GACzB,MAAM,MAAM,MAAM,IAAI;GACtB,QAAQ,MAAM,MAAM,MAAM;EAC5B,CAAC,GACD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/grid/grid.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 grid 相关实现。\n\nimport type { GridColumnCount, GridColumnOffset, GridItemProps, GridProps, GridRowCount } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectGrid, normalizeGridCount, normalizeGridTier } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideGrid, useGridContext } from './context'\n\n/** 断点对象形态的列数，从 GridProps 上取，不在这里另抄一份档位清单。 */\ntype ColsByBreakpoint = Exclude<GridProps['cols'], GridColumnCount | undefined>\n/** 断点对象形态的跨列与错列，同样从类型上取。 */\ntype SpanByBreakpoint = Exclude<GridItemProps['span'], GridColumnCount | undefined>\ntype OffsetByBreakpoint = Exclude<GridItemProps['offset'], GridColumnOffset | undefined>\n\nexport const XhGridRoot = defineComponent({\n  name: 'XhGridRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 列数由作者声明：兼收字符串以支持模板里写 cols=\"3\"，收对象则是逐档的列数\n    cols: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | ColsByBreakpoint>,\n    },\n    rows: { type: [Number, String] as PropType<GridRowCount | string> },\n    minColWidth: { type: String as PropType<GridProps['minColWidth']> },\n    gap: { type: String as PropType<GridProps['gap']> },\n    rowGap: { type: String as PropType<GridProps['rowGap']> },\n    columnGap: { type: String as PropType<GridProps['columnGap']> },\n    align: { type: String as PropType<GridProps['align']> },\n    justifyItems: { type: String as PropType<GridProps['justifyItems']> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectGrid({\n      cols: normalizeGridTier(props.cols) as GridProps['cols'],\n      rows: normalizeGridCount(props.rows) as GridRowCount | undefined,\n      minColWidth: props.minColWidth,\n      gap: props.gap,\n      rowGap: props.rowGap,\n      columnGap: props.columnGap,\n      align: props.align,\n      justifyItems: props.justifyItems,\n    }, vueNormalize))\n    provideGrid({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhGridItem = defineComponent({\n  name: 'XhGridItem',\n  props: {\n    // 跨列与错列由每一格自报，同样兼收字符串；收对象则是逐档的跨列 / 错列\n    span: {\n      type: [Number, String, Object] as PropType<GridColumnCount | string | SpanByBreakpoint>,\n    },\n    offset: {\n      type: [Number, String, Object] as PropType<GridColumnOffset | string | OffsetByBreakpoint>,\n    },\n  },\n  setup(props, { slots }) {\n    const ctx = useGridContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({\n        span: normalizeGridTier(props.span) as GridItemProps['span'],\n        offset: normalizeGridTier(props.offset) as GridItemProps['offset'],\n      }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAoBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,MAAM,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAqC;EAClE,aAAa,EAAE,MAAM,OAA6C;EAClE,KAAK,EAAE,MAAM,OAAqC;EAClD,QAAQ,EAAE,MAAM,OAAwC;EACxD,WAAW,EAAE,MAAM,OAA2C;EAC9D,OAAO,EAAE,MAAM,OAAuC;EACtD,cAAc,EAAE,MAAM,OAA8C;CACtE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY;GACrC,MAAM,kBAAkB,MAAM,IAAI;GAClC,MAAM,mBAAmB,MAAM,IAAI;GACnC,aAAa,MAAM;GACnB,KAAK,MAAM;GACX,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,OAAO,MAAM;GACb,cAAc,MAAM;EACtB,GAAG,YAAY,CAAC;EAChB,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EAEL,MAAM,EACJ,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;EACA,QAAQ,EACN,MAAM;GAAC;GAAQ;GAAQ;EAAM,EAC/B;CACF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe;EAC3B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa;GACzB,MAAM,kBAAkB,MAAM,IAAI;GAClC,QAAQ,kBAAkB,MAAM,MAAM;EACxC,CAAC,GACD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/heatmap/context.ts"],"mappings":";;;iBAgBgB,qBAAqB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/heatmap/context.ts"],"mappings":";;;iBAuBgB,qBAAqB"}

package/dist/components/heatmap/context.js

@@ -1,9 +1,9 @@
 import { inject, provide } from "vue";
 //#region src/components/heatmap/context.ts
 const KEY = Symbol.for("xh-heatmap");
-/** 月块把自己的月份身份传给块内的行：一行由「哪个月 + 月内第几周」定位。 */
+/** 月块把自己的月份身份传给块内的行：一行由所属月份与月内周序定位。 */
 const MONTH_KEY = Symbol.for("xh-heatmap-month");
-/** 行把自己的行身份传给行里的格子：矩阵的一格由「哪一行 + 哪一列」定位。 */
+/** 行把自己的行身份传给行内的格子：矩阵的一格由行与列定位。 */
 const ROW_KEY = Symbol.for("xh-heatmap-row");
 function provideHeatmap(ctx) {
 	provide(KEY, ctx);
@@ -16,7 +16,7 @@ function useHeatmapContext() {
 function provideHeatmapMonth(month) {
 	provide(MONTH_KEY, month);
 }
-/** 没写在月块里就没有月份身份，行自己再从 props 上找。 */
+/** 未写在月块中时没有月份身份，行自行从 props 上查找。 */
 function useHeatmapMonth() {
 	return inject(MONTH_KEY, null);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/heatmap/context.ts"],"sourcesContent":["import type { ComputedRef, InjectionKey } from 'vue'\nimport type { HeatmapContext } from './use-heatmap'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HeatmapContext> = Symbol.for('xh-heatmap')\n\n/** 月块把自己的月份身份传给块内的行：一行由「哪个月 + 月内第几周」定位。 */\nconst MONTH_KEY: InjectionKey<ComputedRef<string>> = Symbol.for('xh-heatmap-month')\n\n/** 行把自己的行身份传给行里的格子：矩阵的一格由「哪一行 + 哪一列」定位。 */\nconst ROW_KEY: InjectionKey<ComputedRef<string | undefined>> = Symbol.for('xh-heatmap-row')\n\nexport function provideHeatmap(ctx: HeatmapContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHeatmapContext(): HeatmapContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Heatmap 部件必须用在 XhHeatmapRoot 内')\n  return ctx\n}\n\nexport function provideHeatmapMonth(month: ComputedRef<string>): void {\n  provide(MONTH_KEY, month)\n}\n\n/** 没写在月块里就没有月份身份，行自己再从 props 上找。 */\nexport function useHeatmapMonth(): ComputedRef<string> | null {\n  return inject(MONTH_KEY, null)\n}\n\nexport function provideHeatmapRow(row: ComputedRef<string | undefined>): void {\n  provide(ROW_KEY, row)\n}\n\nexport function useHeatmapRow(): ComputedRef<string | undefined> | null {\n  return inject(ROW_KEY, null)\n}\n"],"mappings":";;AAIA,MAAM,MAAoC,OAAO,IAAI,YAAY;;AAGjE,MAAM,YAA+C,OAAO,IAAI,kBAAkB;;AAGlF,MAAM,UAAyD,OAAO,IAAI,gBAAgB;AAE1F,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,oBAAoB,OAAkC;CACpE,QAAQ,WAAW,KAAK;AAC1B;;AAGA,SAAgB,kBAA8C;CAC5D,OAAO,OAAO,WAAW,IAAI;AAC/B;AAEA,SAAgB,kBAAkB,KAA4C;CAC5E,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,gBAAwD;CACtE,OAAO,OAAO,SAAS,IAAI;AAC7B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/heatmap/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { HeatmapContext } from './use-heatmap'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HeatmapContext> = Symbol.for('xh-heatmap')\n\n/** 月块把自己的月份身份传给块内的行：一行由所属月份与月内周序定位。 */\nconst MONTH_KEY: InjectionKey<ComputedRef<string>> = Symbol.for('xh-heatmap-month')\n\n/** 行把自己的行身份传给行内的格子：矩阵的一格由行与列定位。 */\nconst ROW_KEY: InjectionKey<ComputedRef<string | undefined>> = Symbol.for('xh-heatmap-row')\n\nexport function provideHeatmap(ctx: HeatmapContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHeatmapContext(): HeatmapContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Heatmap 部件必须用在 XhHeatmapRoot 内')\n  return ctx\n}\n\nexport function provideHeatmapMonth(month: ComputedRef<string>): void {\n  provide(MONTH_KEY, month)\n}\n\n/** 未写在月块中时没有月份身份，行自行从 props 上查找。 */\nexport function useHeatmapMonth(): ComputedRef<string> | null {\n  return inject(MONTH_KEY, null)\n}\n\nexport function provideHeatmapRow(row: ComputedRef<string | undefined>): void {\n  provide(ROW_KEY, row)\n}\n\nexport function useHeatmapRow(): ComputedRef<string | undefined> | null {\n  return inject(ROW_KEY, null)\n}\n"],"mappings":";;AAWA,MAAM,MAAoC,OAAO,IAAI,YAAY;;AAGjE,MAAM,YAA+C,OAAO,IAAI,kBAAkB;;AAGlF,MAAM,UAAyD,OAAO,IAAI,gBAAgB;AAE1F,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,oBAAoB,OAAkC;CACpE,QAAQ,WAAW,KAAK;AAC1B;;AAGA,SAAgB,kBAA8C;CAC5D,OAAO,OAAO,WAAW,IAAI;AAC/B;AAEA,SAAgB,kBAAkB,KAA4C;CAC5E,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,gBAAwD;CACtE,OAAO,OAAO,SAAS,IAAI;AAC7B"}