@xihan-ui/vue 2.1.0 → 3.1.0

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

@@ -0,0 +1,21 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { computed, ref } from "vue";
+import { connectSparkline, sparklineMachine } from "@xihan-ui/headless";
+//#region src/components/sparkline/use-sparkline.ts
+/** 量测与度量都在状态机的效应里做，DOM 取值口经 refs 交入。 */
+function useSparkline(props) {
+	const rootRef = ref(null);
+	const service = useMachine(sparklineMachine, () => ({ ...props }));
+	service.refs.set("getRootEl", () => rootRef.value);
+	service.refs.set("getViewportEl", () => rootRef.value);
+	return {
+		api: computed(() => connectSparkline(service, vueNormalize)),
+		service,
+		rootRef
+	};
+}
+//#endregion
+export { useSparkline };
+
+//# sourceMappingURL=use-sparkline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-sparkline.js","names":[],"sources":["../../../src/components/sparkline/use-sparkline.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 sparkline 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SparklineApi, SparklineSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectSparkline, sparklineMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface SparklineContext {\n  api: ComputedRef<SparklineApi>\n  service: Service<SparklineSchema>\n  /** 根 `<svg>`：尺寸观测的宿主，机器也在它上面读度量私有槽与动效令牌。 */\n  rootRef: Ref<SVGSVGElement | null>\n}\n\n/** 量测与度量都在状态机的效应里做，DOM 取值口经 refs 交入。 */\nexport function useSparkline(props: SparklineSchema['props']): SparklineContext {\n  const rootRef = ref<SVGSVGElement | null>(null)\n  // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n  const service = useMachine(sparklineMachine, () => ({ ...props }))\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('getViewportEl', () => rootRef.value)\n  const api = computed(() => connectSparkline(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;AAuBA,SAAgB,aAAa,OAAmD;CAC9E,MAAM,UAAU,IAA0B,IAAI;CAE9C,MAAM,UAAU,WAAW,yBAAyB,EAAE,GAAG,MAAM,EAAE;CACjE,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,uBAAuB,QAAQ,KAAK;CAErD,OAAO;EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD;EAAG;EAAS;CAAQ;AACjC"}

package/dist/components/spinner/spinner.d.ts

@@ -16,6 +16,10 @@ declare const XhSpinner: import("vue").DefineComponent<import("vue").ExtractProp
   tone: {
     type: PropType<Tone>;
   };
+  /** 挂载后等多少毫秒才露面，默认 0；加载在这之前结束时转圈从头到尾不出现。 */
+  delay: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<Partial<SpinnerTranslations>>;
   };
@@ -34,6 +38,10 @@ declare const XhSpinner: import("vue").DefineComponent<import("vue").ExtractProp
   tone: {
     type: PropType<Tone>;
   };
+  /** 挂载后等多少毫秒才露面，默认 0；加载在这之前结束时转圈从头到尾不出现。 */
+  delay: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<Partial<SpinnerTranslations>>;
   };

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

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","names":[],"sources":["../../../src/components/spinner/spinner.ts"],"mappings":";;;;;cAgBa,yBAAS,8BAAA;;;;;IAKM,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;IAHzB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;MAOnD,oDAAA;;cAGW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAUzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"spinner.d.ts","names":[],"sources":["../../../src/components/spinner/spinner.ts"],"mappings":";;;;;cAgBa,yBAAS,8BAAA;;;;;IAKM,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;;;;;IALzB,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;MAOnD,oDAAA;;cAGW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAUzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/spinner/spinner.js

@@ -11,6 +11,8 @@ const XhSpinner = defineComponent({
 		size: { type: String },
 		variant: { type: String },
 		tone: { type: String },
+		/** 挂载后等多少毫秒才露面，默认 0；加载在这之前结束时转圈从头到尾不出现。 */
+		delay: { type: Number },
 		translations: { type: Object }
 	},
 	setup(props, { slots }) {

package/dist/components/spinner/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","names":[],"sources":["../../../src/components/spinner/spinner.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// 提供 spinner 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { SpinnerProps, SpinnerTranslations, SpinnerVariant } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideSpinner, useSpinnerContext } from './context'\nimport { useSpinner } from './use-spinner'\n\n/** 旋转图形由皮肤绘制在 root 的伪元素上，这里不生成任何子节点。 */\nexport const XhSpinner = defineComponent({\n  name: 'XhSpinner',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    label: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<SpinnerVariant> },\n    tone: { type: String as PropType<Tone> },\n    translations: { type: Object as PropType<Partial<SpinnerTranslations>> },\n  },\n  setup(props, { slots }) {\n    const ctx = useSpinner(withXhConfig('spinner', props) as SpinnerProps)\n    provideSpinner(ctx)\n    return () => h('span', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 可见文案节点。作者未写内容时显示解析后的 label，屏幕上看到的与读屏朗读的因此是同一段文字。 */\nexport const XhSpinnerLabel = defineComponent({\n  name: 'XhSpinnerLabel',\n  setup(_, { slots }) {\n    const ctx = useSpinnerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getLabelProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.label,\n    )\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAiD;CACzE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,CAAiB;EACrE,eAAe,GAAG;EAClB,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EACX,QACA,IAAI,IAAI,MAAM,cAAc,GAC5B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,KACrC;CACF;AACF,CAAC"}
+{"version":3,"file":"spinner.js","names":[],"sources":["../../../src/components/spinner/spinner.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// 提供 spinner 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { SpinnerProps, SpinnerTranslations, SpinnerVariant } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideSpinner, useSpinnerContext } from './context'\nimport { useSpinner } from './use-spinner'\n\n/** 旋转图形由皮肤绘制在 root 的伪元素上，这里不生成任何子节点。 */\nexport const XhSpinner = defineComponent({\n  name: 'XhSpinner',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    label: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<SpinnerVariant> },\n    tone: { type: String as PropType<Tone> },\n    /** 挂载后等多少毫秒才露面，默认 0；加载在这之前结束时转圈从头到尾不出现。 */\n    delay: { type: Number },\n    translations: { type: Object as PropType<Partial<SpinnerTranslations>> },\n  },\n  setup(props, { slots }) {\n    const ctx = useSpinner(withXhConfig('spinner', props) as SpinnerProps)\n    provideSpinner(ctx)\n    return () => h('span', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 可见文案节点。作者未写内容时显示解析后的 label，屏幕上看到的与读屏朗读的因此是同一段文字。 */\nexport const XhSpinnerLabel = defineComponent({\n  name: 'XhSpinnerLabel',\n  setup(_, { slots }) {\n    const ctx = useSpinnerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getLabelProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.label,\n    )\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;;EAEvC,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAiD;CACzE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,CAAiB;EACrE,eAAe,GAAG;EAClB,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EACX,QACA,IAAI,IAAI,MAAM,cAAc,GAC5B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,KACrC;CACF;AACF,CAAC"}

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

@@ -1,9 +1,11 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
 import { computed } from "vue";
-import { connectSpinner } from "@xihan-ui/headless";
+import { connectSpinner, spinnerMachine } from "@xihan-ui/headless";
 //#region src/components/spinner/use-spinner.ts
 function useSpinner(props) {
-	return { api: computed(() => connectSpinner(props, vueNormalize)) };
+	const service = useMachine(spinnerMachine, () => ({ ...props }));
+	return { api: computed(() => connectSpinner(service, vueNormalize)) };
 }
 //#endregion
 export { useSpinner };

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

@@ -1 +1 @@
-{"version":3,"file":"use-spinner.js","names":[],"sources":["../../../src/components/spinner/use-spinner.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 spinner 相关实现。\n\nimport type { SpinnerApi, SpinnerProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectSpinner } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface SpinnerContext {\n  api: ComputedRef<SpinnerApi>\n}\n\n// Spinner 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useSpinner(props: SpinnerProps): SpinnerContext {\n  const api = computed(() => connectSpinner(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAkBA,SAAgB,WAAW,OAAqC;CAE9D,OAAO,EAAE,KADG,eAAe,eAAe,OAAO,YAAY,CAClD,EAAE;AACf"}
+{"version":3,"file":"use-spinner.js","names":[],"sources":["../../../src/components/spinner/use-spinner.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 spinner 相关实现。\n\nimport type { SpinnerApi, SpinnerProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectSpinner, spinnerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface SpinnerContext {\n  api: ComputedRef<SpinnerApi>\n}\n\n// 状态机只管露面前的等待；props 每帧现展开，改了文案与轴 computed 照常重算\nexport function useSpinner(props: SpinnerProps): SpinnerContext {\n  const service = useMachine(spinnerMachine, () => ({ ...props }))\n  const api = computed(() => connectSpinner(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAmBA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,UAAU,WAAW,uBAAuB,EAAE,GAAG,MAAM,EAAE;CAE/D,OAAO,EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD,EAAE;AACf"}

package/dist/components/steps/steps.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { StepNode, StepStatus, StepsApi, StepsSchema, StepsTranslations } from "@xihan-ui/headless";
+import { StepNode, StepStatus, StepsApi, StepsSchema, StepsTranslations, StepsVariant } from "@xihan-ui/headless";
 //#region src/components/steps/steps.d.ts
 type StepsProps = StepsSchema['props'];
 /** 默认插槽的载荷：当前步序、总步数、是否完成，以及跳步与前进后退的方法。 */
@@ -36,6 +36,11 @@ declare const XhStepsRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 只读展示：不可点、不可聚焦、不置灰，语义换成有序列表，trigger 渲染为 div。 */
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loop: {
     type: BooleanConstructor;
     default: undefined;
@@ -52,6 +57,14 @@ declare const XhStepsRoot: import("vue").DefineComponent<import("vue").ExtractPr
   size: {
     type: PropType<Size>;
   };
+  /** 标记形态：number 序号圆点（缺省）/ dot 不盛内容的小圆点。 */
+  variant: {
+    type: PropType<StepsVariant>;
+  };
+  /** 当前这一步自己的完成比例（0–100）：当前步的序号圆点外画一圈进度环。 */
+  percent: {
+    type: NumberConstructor;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -87,6 +100,11 @@ declare const XhStepsRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 只读展示：不可点、不可聚焦、不置灰，语义换成有序列表，trigger 渲染为 div。 */
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loop: {
     type: BooleanConstructor;
     default: undefined;
@@ -103,12 +121,21 @@ declare const XhStepsRoot: import("vue").DefineComponent<import("vue").ExtractPr
   size: {
     type: PropType<Size>;
   };
+  /** 标记形态：number 序号圆点（缺省）/ dot 不盛内容的小圆点。 */
+  variant: {
+    type: PropType<StepsVariant>;
+  };
+  /** 当前这一步自己的完成比例（0–100）：当前步的序号圆点外画一圈进度环。 */
+  percent: {
+    type: NumberConstructor;
+  };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").StepsValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: number) => any) | undefined;
 }>, {
   loop: boolean;
   disabled: boolean;
+  readOnly: boolean;
   linear: boolean;
 }, SlotsType<{
   default?: (props: StepsRootSlotProps) => VNode[];

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

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","names":[],"sources":["../../../src/components/steps/steps.ts"],"mappings":";;;;;KAgBK,aAAa;;KAGN,qBAAqB,KAC/B;cAIW,2BAAW,8BAAA;;;;;;;;;;;IAOS,MAAA,SAAS;;;IACV,MAAA,SAAS,eAAe;;;IAC3B,MAAA,SAAS,eAAe;;;IAClB,MAAA,SAAS;;;;;;;;;;;;;;;IAIjB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;IAfN,MAAA,SAAS;;;IACV,MAAA,SAAS,eAAe;;;IAC3B,MAAA,SAAS,eAAe;;;IAClB,MAAA,SAAS;;;;;;;;;;;;;;;IAIjB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,uBAAuB;kCAmB3C;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;IAIe,MAAA;;;;;;;;IAAA,MAAA;;;;;;qCAYrC;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BA6BzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAOvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;IAGY,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA"}
+{"version":3,"file":"steps.d.ts","names":[],"sources":["../../../src/components/steps/steps.ts"],"mappings":";;;;;KAgBK,aAAa;;KAGN,qBAAqB,KAC/B;cAIW,2BAAW,8BAAA;;;;;;;;;;;IAOS,MAAA,SAAS;;;IACV,MAAA,SAAS,eAAe;;;IAC3B,MAAA,SAAS,eAAe;;;IAClB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMjB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;;;;;;;EAMT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;IArBN,MAAA,SAAS;;;IACV,MAAA,SAAS,eAAe;;;IAC3B,MAAA,SAAS,eAAe;;;IAClB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAMjB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;;;;;;;;;;;;;EAU1B,WAAC,OAAO,uBAAuB;kCAmB3C;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;IAIe,MAAA;;;;;;;;IAAA,MAAA;;;;;;qCAYrC;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BA8BzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAOvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;IAGY,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA"}

package/dist/components/steps/steps.js

@@ -21,6 +21,11 @@ const XhStepsRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 只读展示：不可点、不可聚焦、不置灰，语义换成有序列表，trigger 渲染为 div。 */
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
 		loop: {
 			type: Boolean,
 			default: void 0
@@ -28,7 +33,11 @@ const XhStepsRoot = defineComponent({
 		dir: { type: String },
 		translations: { type: Object },
 		tone: { type: String },
-		size: { type: String }
+		size: { type: String },
+		/** 标记形态：number 序号圆点（缺省）/ dot 不盛内容的小圆点。 */
+		variant: { type: String },
+		/** 当前这一步自己的完成比例（0–100）：当前步的序号圆点外画一圈进度环。 */
+		percent: { type: Number }
 	},
 	emits: {
 		"value-change": (_details) => true,
@@ -99,7 +108,7 @@ const XhStepsTrigger = defineComponent({
 			if (ctx.service.getStatus() !== "Started") return;
 			if (itemEl.value && ctx.service.scope.getActiveElement() === itemEl.value) ctx.service.send({ type: "LIST.BLUR" });
 		});
-		return () => h("button", {
+		return () => h(ctx.api.value.readOnly ? "div" : "button", {
 			...ctx.api.value.getTriggerProps(item()),
 			ref: itemEl
 		}, slots.default?.());

package/dist/components/steps/steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"steps.js","names":[],"sources":["../../../src/components/steps/steps.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// 提供 steps 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { StepNode, StepsApi, StepsSchema, StepStatus, StepsTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideSteps, provideStepsItem, useStepsContext, useStepsItem } from './context'\nimport { useSteps } from './use-steps'\n\ntype StepsProps = StepsSchema['props']\n\n/** 默认插槽的载荷：当前步序、总步数、是否完成，以及跳步与前进后退的方法。 */\nexport type StepsRootSlotProps = Pick<\n  StepsApi,\n  'value' | 'count' | 'complete' | 'setValue' | 'goToNextStep' | 'goToPrevStep'\n>\n\nexport const XhStepsRoot = defineComponent({\n  name: 'XhStepsRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: Number },\n    defaultValue: { type: Number },\n    count: { type: Number },\n    collection: { type: Array as PropType<StepNode[]> },\n    statuses: { type: Object as PropType<Record<number, StepStatus>> },\n    tones: { type: Object as PropType<Record<number, Tone>> },\n    orientation: { type: String as PropType<Orientation> },\n    linear: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<Partial<StepsTranslations>> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸下标\n  emits: {\n    'value-change': (_details: PayloadOf<StepsProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<StepsProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: StepsRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: StepsProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSteps(withXhConfig('steps', props) as StepsProps, notify)\n    provideSteps(ctx)\n    // 经插槽暴露状态与前进/后退方法，供步骤条外的按钮使用\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      complete: ctx.api.value.complete,\n      setValue: ctx.api.value.setValue,\n      goToNextStep: ctx.api.value.goToNextStep,\n      goToPrevStep: ctx.api.value.goToPrevStep,\n    }))\n  },\n})\n\nexport const XhStepsList = defineComponent({\n  name: 'XhStepsList',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsItem = defineComponent({\n  name: 'XhStepsItem',\n  props: {\n    // 步骤下标，兼收字符串以支持模板属性字面量与 WC 侧的 DOM 属性\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    disabled: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useStepsContext()\n    provideStepsItem(() => ({ index: Number(props.value), disabled: props.disabled }))\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ index: Number(props.value), disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhStepsTrigger = defineComponent({\n  name: 'XhStepsTrigger',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    // 本节点持有焦点时，下标变更重报焦点步骤，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => item().index, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'TRIGGER.FOCUS', step: next })\n    })\n    onBeforeUnmount(() => {\n      if (ctx.service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按下标比对\n      if (itemEl.value && ctx.service.scope.getActiveElement() === itemEl.value)\n        ctx.service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'button',\n      { ...ctx.api.value.getTriggerProps(item()) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhStepsIndicator = defineComponent({\n  name: 'XhStepsIndicator',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getIndicatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsTitle = defineComponent({\n  name: 'XhStepsTitle',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getTitleProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsDescription = defineComponent({\n  name: 'XhStepsDescription',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getDescriptionProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 连接线写在 item 之内，身份从 item 上下文取\nexport const XhStepsSeparator = defineComponent({\n  name: 'XhStepsSeparator',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('div', ctx.api.value.getSeparatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 面板挂在 list 之外，自带 value 与 trigger 配对；value 等于 count 的面板即完成页 */\nexport const XhStepsContent = defineComponent({\n  name: 'XhStepsContent',\n  props: {\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useStepsContext()\n    return () => h(\n      'div',\n      ctx.api.value.getContentProps({ index: Number(props.value) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"steps.js","names":[],"sources":["../../../src/components/steps/steps.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// 提供 steps 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { StepNode, StepsApi, StepsSchema, StepStatus, StepsTranslations, StepsVariant } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideSteps, provideStepsItem, useStepsContext, useStepsItem } from './context'\nimport { useSteps } from './use-steps'\n\ntype StepsProps = StepsSchema['props']\n\n/** 默认插槽的载荷：当前步序、总步数、是否完成，以及跳步与前进后退的方法。 */\nexport type StepsRootSlotProps = Pick<\n  StepsApi,\n  'value' | 'count' | 'complete' | 'setValue' | 'goToNextStep' | 'goToPrevStep'\n>\n\nexport const XhStepsRoot = defineComponent({\n  name: 'XhStepsRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: Number },\n    defaultValue: { type: Number },\n    count: { type: Number },\n    collection: { type: Array as PropType<StepNode[]> },\n    statuses: { type: Object as PropType<Record<number, StepStatus>> },\n    tones: { type: Object as PropType<Record<number, Tone>> },\n    orientation: { type: String as PropType<Orientation> },\n    linear: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    /** 只读展示：不可点、不可聚焦、不置灰，语义换成有序列表，trigger 渲染为 div。 */\n    readOnly: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<Partial<StepsTranslations>> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    /** 标记形态：number 序号圆点（缺省）/ dot 不盛内容的小圆点。 */\n    variant: { type: String as PropType<StepsVariant> },\n    /** 当前这一步自己的完成比例（0–100）：当前步的序号圆点外画一圈进度环。 */\n    percent: { type: Number },\n  },\n  // value-change 携带 { value }，update:value 携带裸下标\n  emits: {\n    'value-change': (_details: PayloadOf<StepsProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<StepsProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: StepsRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: StepsProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSteps(withXhConfig('steps', props) as StepsProps, notify)\n    provideSteps(ctx)\n    // 经插槽暴露状态与前进/后退方法，供步骤条外的按钮使用\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      complete: ctx.api.value.complete,\n      setValue: ctx.api.value.setValue,\n      goToNextStep: ctx.api.value.goToNextStep,\n      goToPrevStep: ctx.api.value.goToPrevStep,\n    }))\n  },\n})\n\nexport const XhStepsList = defineComponent({\n  name: 'XhStepsList',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsItem = defineComponent({\n  name: 'XhStepsItem',\n  props: {\n    // 步骤下标，兼收字符串以支持模板属性字面量与 WC 侧的 DOM 属性\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    disabled: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useStepsContext()\n    provideStepsItem(() => ({ index: Number(props.value), disabled: props.disabled }))\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ index: Number(props.value), disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhStepsTrigger = defineComponent({\n  name: 'XhStepsTrigger',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    // 本节点持有焦点时，下标变更重报焦点步骤，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => item().index, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'TRIGGER.FOCUS', step: next })\n    })\n    onBeforeUnmount(() => {\n      if (ctx.service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按下标比对\n      if (itemEl.value && ctx.service.scope.getActiveElement() === itemEl.value)\n        ctx.service.send({ type: 'LIST.BLUR' })\n    })\n    // 只读展示的 trigger 只排版，不是按钮\n    return () => h(\n      ctx.api.value.readOnly ? 'div' : 'button',\n      { ...ctx.api.value.getTriggerProps(item()) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhStepsIndicator = defineComponent({\n  name: 'XhStepsIndicator',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getIndicatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsTitle = defineComponent({\n  name: 'XhStepsTitle',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getTitleProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhStepsDescription = defineComponent({\n  name: 'XhStepsDescription',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('span', ctx.api.value.getDescriptionProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 连接线写在 item 之内，身份从 item 上下文取\nexport const XhStepsSeparator = defineComponent({\n  name: 'XhStepsSeparator',\n  setup(_, { slots }) {\n    const ctx = useStepsContext()\n    const item = useStepsItem()\n    return () => h('div', ctx.api.value.getSeparatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 面板挂在 list 之外，自带 value 与 trigger 配对；value 等于 count 的面板即完成页 */\nexport const XhStepsContent = defineComponent({\n  name: 'XhStepsContent',\n  props: {\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useStepsContext()\n    return () => h(\n      'div',\n      ctx.api.value.getContentProps({ index: Number(props.value) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":"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"}

package/dist/components/switch/switch.js

@@ -1,6 +1,6 @@
+import { slotPaints } from "../../runtime/slot-content.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { slotPaints } from "../../runtime/slot-content.js";
 import { useSwitch } from "./use-switch.js";
 import { defineComponent, h, useId } from "vue";
 //#region src/components/switch/switch.ts

package/dist/components/table/context.js

@@ -4,6 +4,14 @@ const KEY = Symbol.for("xh-table");
 const SECTION_KEY = Symbol.for("xh-table-section");
 const ROW_KEY = Symbol.for("xh-table-row");
 const COLUMN_KEY = Symbol.for("xh-table-column");
+const HEADER_LEVEL_KEY = Symbol.for("xh-table-header-level");
+/** 表头行写明的层号，供行里的列头定位自己在多级表头里的哪一格。 */
+function provideTableHeaderLevel(level) {
+	provide(HEADER_LEVEL_KEY, level);
+}
+function useOptionalTableHeaderLevel() {
+	return inject(HEADER_LEVEL_KEY, null);
+}
 function provideTable(ctx) {
 	provide(KEY, ctx);
 }
@@ -44,6 +52,6 @@ function useOptionalTableColumnContext() {
 	return inject(COLUMN_KEY, null);
 }
 //#endregion
-export { provideTable, provideTableColumn, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableRowContext, useTableColumnContext, useTableContext, useTableRowContext, useTableSection };
+export { provideTable, provideTableColumn, provideTableHeaderLevel, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableHeaderLevel, useOptionalTableRowContext, useTableColumnContext, useTableContext, useTableRowContext, useTableSection };
 
 //# sourceMappingURL=context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/table/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 { TableColumnProps, TableRowProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TableContext } from './use-table'\nimport { inject, provide } from 'vue'\n\n/** 行所在的区段，决定同一个 row 部件渲染为表头行、数据行还是脚注行。 */\nexport type TableSection = 'header' | 'body' | 'footer'\n\n/** 行声明的值，供行内的操作按钮与单元格复用同一份声明。 */\nexport interface TableRowContext {\n  row: ComputedRef<TableRowProps>\n}\n\n/** 列声明的值，供列标题中的排序按钮复用同一份声明。 */\nexport interface TableColumnContext {\n  column: ComputedRef<TableColumnProps>\n}\n\nconst KEY: InjectionKey<TableContext> = Symbol.for('xh-table')\nconst SECTION_KEY: InjectionKey<TableSection> = Symbol.for('xh-table-section')\nconst ROW_KEY: InjectionKey<TableRowContext> = Symbol.for('xh-table-row')\nconst COLUMN_KEY: InjectionKey<TableColumnContext> = Symbol.for('xh-table-column')\n\nexport function provideTable(ctx: TableContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTableContext(): TableContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 部件必须用在 XhTableRoot 内')\n  return ctx\n}\n\nexport function provideTableSection(section: TableSection): void {\n  provide(SECTION_KEY, section)\n}\n\n/** 取所在区段，无区段声明时按数据行处理。 */\nexport function useTableSection(): TableSection {\n  return inject(SECTION_KEY, 'body')\n}\n\nexport function provideTableRow(ctx: TableRowContext): void {\n  provide(ROW_KEY, ctx)\n}\n\nexport function useTableRowContext(): TableRowContext {\n  const ctx = inject(ROW_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 行内部件必须用在 XhTableRow 或 XhTableExpandedRow 内')\n  return ctx\n}\n\n/** 注入行上下文，表头与脚注单元格不在行内时返回 null。 */\nexport function useOptionalTableRowContext(): TableRowContext | null {\n  return inject(ROW_KEY, null)\n}\n\nexport function provideTableColumn(ctx: TableColumnContext): void {\n  provide(COLUMN_KEY, ctx)\n}\n\nexport function useTableColumnContext(): TableColumnContext {\n  const ctx = inject(COLUMN_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 排序把手必须用在 XhTableColumnHeader 内')\n  return ctx\n}\n\n/** 注入列上下文，列设置区中的操作按钮不在列标题内时返回 null，列身份改由自己的 value 声明。 */\nexport function useOptionalTableColumnContext(): TableColumnContext | null {\n  return inject(COLUMN_KEY, null)\n}\n"],"mappings":";;AAyBA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAC7D,MAAM,cAA0C,OAAO,IAAI,kBAAkB;AAC7E,MAAM,UAAyC,OAAO,IAAI,cAAc;AACxE,MAAM,aAA+C,OAAO,IAAI,iBAAiB;AAEjF,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT;AAEA,SAAgB,oBAAoB,SAA6B;CAC/D,QAAQ,aAAa,OAAO;AAC9B;;AAGA,SAAgB,kBAAgC;CAC9C,OAAO,OAAO,aAAa,MAAM;AACnC;AAEA,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uDAAuD;CACzE,OAAO;AACT;;AAGA,SAAgB,6BAAqD;CACnE,OAAO,OAAO,SAAS,IAAI;AAC7B;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,YAAY,GAAG;AACzB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,YAAY,IAAI;CACnC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;;AAGA,SAAgB,gCAA2D;CACzE,OAAO,OAAO,YAAY,IAAI;AAChC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/table/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 { TableColumnProps, TableRowProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TableContext } from './use-table'\nimport { inject, provide } from 'vue'\n\n/** 行所在的区段，决定同一个 row 部件渲染为表头行、数据行还是脚注行。 */\nexport type TableSection = 'header' | 'body' | 'footer'\n\n/** 行声明的值，供行内的操作按钮与单元格复用同一份声明。 */\nexport interface TableRowContext {\n  row: ComputedRef<TableRowProps>\n}\n\n/** 列声明的值，供列标题中的排序按钮复用同一份声明。 */\nexport interface TableColumnContext {\n  column: ComputedRef<TableColumnProps>\n}\n\nconst KEY: InjectionKey<TableContext> = Symbol.for('xh-table')\nconst SECTION_KEY: InjectionKey<TableSection> = Symbol.for('xh-table-section')\nconst ROW_KEY: InjectionKey<TableRowContext> = Symbol.for('xh-table-row')\nconst COLUMN_KEY: InjectionKey<TableColumnContext> = Symbol.for('xh-table-column')\nconst HEADER_LEVEL_KEY: InjectionKey<ComputedRef<number | undefined>> = Symbol.for('xh-table-header-level')\n\n/** 表头行写明的层号，供行里的列头定位自己在多级表头里的哪一格。 */\nexport function provideTableHeaderLevel(level: ComputedRef<number | undefined>): void {\n  provide(HEADER_LEVEL_KEY, level)\n}\n\nexport function useOptionalTableHeaderLevel(): ComputedRef<number | undefined> | null {\n  return inject(HEADER_LEVEL_KEY, null)\n}\n\nexport function provideTable(ctx: TableContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTableContext(): TableContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 部件必须用在 XhTableRoot 内')\n  return ctx\n}\n\nexport function provideTableSection(section: TableSection): void {\n  provide(SECTION_KEY, section)\n}\n\n/** 取所在区段，无区段声明时按数据行处理。 */\nexport function useTableSection(): TableSection {\n  return inject(SECTION_KEY, 'body')\n}\n\nexport function provideTableRow(ctx: TableRowContext): void {\n  provide(ROW_KEY, ctx)\n}\n\nexport function useTableRowContext(): TableRowContext {\n  const ctx = inject(ROW_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 行内部件必须用在 XhTableRow 或 XhTableExpandedRow 内')\n  return ctx\n}\n\n/** 注入行上下文，表头与脚注单元格不在行内时返回 null。 */\nexport function useOptionalTableRowContext(): TableRowContext | null {\n  return inject(ROW_KEY, null)\n}\n\nexport function provideTableColumn(ctx: TableColumnContext): void {\n  provide(COLUMN_KEY, ctx)\n}\n\nexport function useTableColumnContext(): TableColumnContext {\n  const ctx = inject(COLUMN_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Table 排序把手必须用在 XhTableColumnHeader 内')\n  return ctx\n}\n\n/** 注入列上下文，列设置区中的操作按钮不在列标题内时返回 null，列身份改由自己的 value 声明。 */\nexport function useOptionalTableColumnContext(): TableColumnContext | null {\n  return inject(COLUMN_KEY, null)\n}\n"],"mappings":";;AAyBA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAC7D,MAAM,cAA0C,OAAO,IAAI,kBAAkB;AAC7E,MAAM,UAAyC,OAAO,IAAI,cAAc;AACxE,MAAM,aAA+C,OAAO,IAAI,iBAAiB;AACjF,MAAM,mBAAkE,OAAO,IAAI,uBAAuB;;AAG1G,SAAgB,wBAAwB,OAA8C;CACpF,QAAQ,kBAAkB,KAAK;AACjC;AAEA,SAAgB,8BAAsE;CACpF,OAAO,OAAO,kBAAkB,IAAI;AACtC;AAEA,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT;AAEA,SAAgB,oBAAoB,SAA6B;CAC/D,QAAQ,aAAa,OAAO;AAC9B;;AAGA,SAAgB,kBAAgC;CAC9C,OAAO,OAAO,aAAa,MAAM;AACnC;AAEA,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uDAAuD;CACzE,OAAO;AACT;;AAGA,SAAgB,6BAAqD;CACnE,OAAO,OAAO,SAAS,IAAI;AAC7B;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,YAAY,GAAG;AACzB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,YAAY,IAAI;CACnC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;;AAGA,SAAgB,gCAA2D;CACzE,OAAO,OAAO,YAAY,IAAI;AAChC"}

package/dist/components/table/table.d.ts

@@ -1,11 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { ControlVariant, Direction, Size } from "@xihan-ui/core";
+import { CascadeStrategy, ControlVariant, Direction, Size } from "@xihan-ui/core";
 import { TableApi, TableColumnDef, TableColumnKind, TableColumnPreference, TableRowDef, TableSchema, TableSelection, TableSelectionMode, TableSortDescriptor } from "@xihan-ui/headless";
 //#region src/components/table/table.d.ts
 type TableProps = TableSchema['props'];
 /** 默认插槽的载荷：可见行与排序、选中、展开三态，以及逐行查询与改写它们的句柄。 */
-type TableRootSlotProps = Pick<TableApi, 'columns' | 'columnPreference' | 'columnSettings' | 'setColumnSticky' | 'setColumnHidden' | 'moveColumn' | 'setColumnWidth' | 'setColumnPreference' | 'rowNumber' | 'visibleRows' | 'sort' | 'selection' | 'selectionState' | 'expandedValue' | 'focusedRow' | 'empty' | 'loading' | 'isSelected' | 'isExpanded' | 'sortDirection' | 'sortPriority' | 'toggleSort' | 'selectRow' | 'toggleSelectAll' | 'toggleExpandRow' | 'rowReorderDisabledReason'>;
+type TableRootSlotProps = Pick<TableApi, 'columns' | 'columnPreference' | 'columnSettings' | 'setColumnSticky' | 'setColumnHidden' | 'moveColumn' | 'setColumnWidth' | 'setColumnPreference' | 'rowNumber' | 'visibleRows' | 'sort' | 'selection' | 'selectionState' | 'expandedValue' | 'focusedRow' | 'empty' | 'loading' | 'isSelected' | 'isExpanded' | 'sortDirection' | 'sortPriority' | 'toggleSort' | 'selectRow' | 'toggleSelectAll' | 'toggleExpandRow' | 'rowReorderDisabledReason' | 'headerRows' | 'headerRowCount' | 'cellSpanOf'>;
 /**
  * 工具条插槽的载荷：作用于整张表的项：列设置、排序链与整表状态。
  * 逐行的内容（可见行、行号、逐行查询）不在其中：工具条放在表外，无法触及某一行。
@@ -33,6 +33,22 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   selectionMode: {
     type: PropType<TableSelectionMode>;
   };
+  /** 单元格合并：逐格询问合并区的大小，与 antd 的 spanMethod 同一种写法。 */
+  cellSpan: {
+    type: PropType<TableProps["cellSpan"]>;
+  };
+  /** 与 Virtualizer 的正式接线口：传 Virtualizer 的 collectionVirtualizer，count 等于可见数据行的条数。 */
+  virtualizer: {
+    type: PropType<TableProps["virtualizer"]>;
+  };
+  /** 树形表在 multiple 下父子级联勾选，与 Tree 的 cascade 同义。 */
+  cascade: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  checkedStrategy: {
+    type: PropType<CascadeStrategy>;
+  };
   /** 需要哪几列前缀列（序号 / 多选 / 展开），按给定顺序插入最前面并占用列号。 */
   prefixColumns: {
     type: PropType<TableColumnKind[]>;
@@ -124,6 +140,22 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   selectionMode: {
     type: PropType<TableSelectionMode>;
   };
+  /** 单元格合并：逐格询问合并区的大小，与 antd 的 spanMethod 同一种写法。 */
+  cellSpan: {
+    type: PropType<TableProps["cellSpan"]>;
+  };
+  /** 与 Virtualizer 的正式接线口：传 Virtualizer 的 collectionVirtualizer，count 等于可见数据行的条数。 */
+  virtualizer: {
+    type: PropType<TableProps["virtualizer"]>;
+  };
+  /** 树形表在 multiple 下父子级联勾选，与 Tree 的 cascade 同义。 */
+  cascade: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  checkedStrategy: {
+    type: PropType<CascadeStrategy>;
+  };
   /** 需要哪几列前缀列（序号 / 多选 / 展开），按给定顺序插入最前面并占用列号。 */
   prefixColumns: {
     type: PropType<TableColumnKind[]>;
@@ -196,8 +228,9 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   loop: boolean;
   loading: boolean;
   empty: boolean;
-  stickyHeader: boolean;
+  cascade: boolean;
   striped: boolean;
+  stickyHeader: boolean;
   ruled: boolean;
   rowReorderable: boolean;
 }, SlotsType<{
@@ -254,6 +287,10 @@ declare const XhTableRow: import("vue").DefineComponent<import("vue").ExtractPro
   value: {
     type: StringConstructor;
   };
+  /** 多级表头下写明这是第几行表头（1 起算），行里的列头据此定位；单行表头省略。 */
+  level: {
+    type: NumberConstructor;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -261,12 +298,20 @@ declare const XhTableRow: import("vue").DefineComponent<import("vue").ExtractPro
   value: {
     type: StringConstructor;
   };
+  /** 多级表头下写明这是第几行表头（1 起算），行里的列头据此定位；单行表头省略。 */
+  level: {
+    type: NumberConstructor;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTableColumnHeader: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
     required: true;
   };
+  /** 多级表头里这一格所在的表头行；省略时取所在表头行写明的层号。 */
+  level: {
+    type: NumberConstructor;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -274,6 +319,10 @@ declare const XhTableColumnHeader: import("vue").DefineComponent<import("vue").E
     type: StringConstructor;
     required: true;
   };
+  /** 多级表头里这一格所在的表头行；省略时取所在表头行写明的层号。 */
+  level: {
+    type: NumberConstructor;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
  * 列名。列头里唯一可收窄的一格：列名太长时由它出省略号，排序钮、列宽把手与列拖拽把手都写在它之外、

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","names":[],"sources":["../../../src/components/table/table.ts"],"mappings":"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"}
+{"version":3,"file":"table.d.ts","names":[],"sources":["../../../src/components/table/table.ts"],"mappings":"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"}

package/dist/components/table/table.js

@@ -1,5 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
-import { provideTable, provideTableColumn, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableRowContext, useTableColumnContext, useTableContext, useTableRowContext, useTableSection } from "./context.js";
+import { provideTable, provideTableColumn, provideTableHeaderLevel, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableHeaderLevel, useOptionalTableRowContext, useTableColumnContext, useTableContext, useTableRowContext, useTableSection } from "./context.js";
 import { useTable } from "./use-table.js";
 import { Fragment, computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
 //#region src/components/table/table.ts
@@ -30,6 +30,16 @@ const XhTableRoot = /* @__PURE__ */ defineComponent({
 		selection: { type: [Array, String] },
 		defaultSelection: { type: [Array, String] },
 		selectionMode: { type: String },
+		/** 单元格合并：逐格询问合并区的大小，与 antd 的 spanMethod 同一种写法。 */
+		cellSpan: { type: Function },
+		/** 与 Virtualizer 的正式接线口：传 Virtualizer 的 collectionVirtualizer，count 等于可见数据行的条数。 */
+		virtualizer: { type: Object },
+		/** 树形表在 multiple 下父子级联勾选，与 Tree 的 cascade 同义。 */
+		cascade: {
+			type: Boolean,
+			default: void 0
+		},
+		checkedStrategy: { type: String },
 		/** 需要哪几列前缀列（序号 / 多选 / 展开），按给定顺序插入最前面并占用列号。 */
 		prefixColumns: { type: Array },
 		/** 当前页码与每页条数：只用于计算序号，不参与切片。 */
@@ -114,7 +124,9 @@ const XhTableRoot = /* @__PURE__ */ defineComponent({
 				empty: ctx.api.value.empty,
 				loading: ctx.api.value.loading
 			}) ?? null,
-			h("div", mergeProps(ctx.api.value.getRootProps(), attrs), slots.default?.({
+			h("div", mergeProps(ctx.api.value.getRootProps(), attrs, { ref: (el) => {
+				ctx.rootRef.value = el;
+			} }), slots.default?.({
 				columns: ctx.api.value.columns,
 				columnPreference: ctx.api.value.columnPreference,
 				columnSettings: ctx.api.value.columnSettings,
@@ -125,6 +137,9 @@ const XhTableRoot = /* @__PURE__ */ defineComponent({
 				setColumnPreference: ctx.api.value.setColumnPreference,
 				rowNumber: ctx.api.value.rowNumber,
 				visibleRows: ctx.api.value.visibleRows,
+				headerRows: ctx.api.value.headerRows,
+				headerRowCount: ctx.api.value.headerRowCount,
+				cellSpanOf: ctx.api.value.cellSpanOf,
 				sort: ctx.api.value.sort,
 				selection: ctx.api.value.selection,
 				selectionState: ctx.api.value.selectionState,
@@ -215,13 +230,19 @@ const XhTableFooter = /* @__PURE__ */ defineComponent({
 });
 const XhTableRow = /* @__PURE__ */ defineComponent({
 	name: "XhTableRow",
-	props: { 
-	/** 行 id：数据行必须提供，表头行与脚注行省略。 */
-value: { type: String } },
+	props: {
+		/** 行 id：数据行必须提供，表头行与脚注行省略。 */
+		value: { type: String },
+		/** 多级表头下写明这是第几行表头（1 起算），行里的列头据此定位；单行表头省略。 */
+		level: { type: Number }
+	},
 	setup(props, { slots }) {
 		const ctx = useTableContext();
 		const section = useTableSection();
-		if (section !== "body") return () => h("div", section === "header" ? ctx.api.value.getHeaderRowProps() : ctx.api.value.getFooterRowProps(), slots.default?.());
+		if (section !== "body") {
+			if (section === "header") provideTableHeaderLevel(computed(() => props.level));
+			return () => h("div", section === "header" ? ctx.api.value.getHeaderRowProps({ level: props.level }) : ctx.api.value.getFooterRowProps(), slots.default?.());
+		}
 		const row = computed(() => ({ value: props.value ?? "" }));
 		provideTableRow({ row });
 		const el = ref(null);
@@ -234,13 +255,21 @@ value: { type: String } },
 });
 const XhTableColumnHeader = /* @__PURE__ */ defineComponent({
 	name: "XhTableColumnHeader",
-	props: { value: {
-		type: String,
-		required: true
-	} },
+	props: {
+		value: {
+			type: String,
+			required: true
+		},
+		/** 多级表头里这一格所在的表头行；省略时取所在表头行写明的层号。 */
+		level: { type: Number }
+	},
 	setup(props, { slots }) {
 		const ctx = useTableContext();
-		const column = computed(() => ({ value: props.value }));
+		const headerLevel = useOptionalTableHeaderLevel();
+		const column = computed(() => ({
+			value: props.value,
+			level: props.level ?? headerLevel?.value
+		}));
 		provideTableColumn({ column });
 		return () => h("div", ctx.api.value.getColumnHeaderProps(column.value), slots.default?.());
 	}