@xihan-ui/vue 4.2.0 → 5.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-slider.js","names":[],"sources":["../../../src/components/slider/use-slider.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 slider 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SliderApi, SliderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectSlider, sliderMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface SliderContext {\n  api: ComputedRef<SliderApi>\n  service: Service<SliderSchema>\n  /** 轨道节点，状态机在指针事件中读取它的矩形。 */\n  trackRef: Ref<HTMLElement | null>\n}\n\nexport function useSlider(\n  props: SliderSchema['props'],\n  onValueChange?: SliderSchema['props']['onValueChange'],\n  onValueChangeEnd?: SliderSchema['props']['onValueChangeEnd'],\n): SliderContext {\n  const trackRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(sliderMachine, () => ({ ...props, onValueChange, onValueChangeEnd }), scope)\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getTrackEl', () => trackRef.value)\n\n  const api = computed(() => connectSlider(service, vueNormalize))\n  return { api, service, trackRef }\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,UACd,OACA,eACA,kBACe;CACf,MAAM,WAAW,IAAwB,IAAI;CAI7C,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;EAAe;CAAiB,IAD/E,YAAY,MADZ,qBACsB,CACiE,CAAC;CAGtG,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CAGnD,OAAO;EAAE,KADG,eAAe,cAAc,SAAS,YAAY,CACnD;EAAG;EAAS;CAAS;AAClC"}
+{"version":3,"file":"use-slider.js","names":[],"sources":["../../../src/components/slider/use-slider.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 slider 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SliderApi, SliderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectSlider, sliderMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface SliderContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhSliderLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<SliderApi>\n  service: Service<SliderSchema>\n  /** 轨道节点，状态机在指针事件中读取它的矩形。 */\n  trackRef: Ref<HTMLElement | null>\n}\n\nexport function useSlider(\n  props: SliderSchema['props'],\n  onValueChange?: SliderSchema['props']['onValueChange'],\n  onValueChangeEnd?: SliderSchema['props']['onValueChangeEnd'],\n): SliderContext {\n  const trackRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(sliderMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange, onValueChangeEnd }), scope)\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getTrackEl', () => trackRef.value)\n\n  const api = computed(() => connectSlider(service, vueNormalize))\n  return { labelCount, api, service, trackRef }\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,UACd,OACA,eACA,kBACe;CACf,MAAM,WAAW,IAAwB,IAAI;CAG7C,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;EAAe;CAAiB,IAAI,KAAK;CAGtI,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CAGnD,OAAO;EAAE;EAAY,KADT,eAAe,cAAc,SAAS,YAAY,CACvC;EAAG;EAAS;CAAS;AAC9C"}

package/dist/components/sortable/sortable.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { SortableItemState, SortableMode, SortableSchema, SortableTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction } from "@xihan-ui/core";
-import { SortableItemState, SortableMode, SortableSchema, SortableTranslations } from "@xihan-ui/headless";
 import { SortableAxis } from "@xihan-ui/pointer";
 //#region src/components/sortable/sortable.d.ts
 type SortableProps = SortableSchema['props'];

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

@@ -1,6 +1,6 @@
+import { SortableApi, SortableSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SortableApi, SortableSchema } from "@xihan-ui/headless";
 //#region src/components/sortable/use-sortable.d.ts
 interface SortableContext {
   api: ComputedRef<SortableApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSortable, sortableMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSortable, sortableMachine } from "@xihan-ui/headless";
 //#region src/components/sortable/use-sortable.ts
 function useSortable(props, onSort, onTransfer, onDragStart, onDragEnd) {
 	const rootRef = ref(null);

package/dist/components/sparkline/sparkline.d.ts

@@ -1,6 +1,6 @@
+import { NumberFormatSpec, SparklineCurve, SparklineMarkers, SparklineReference, SparklineSchema, SparklineTranslations, SparklineVariant } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Tone } from "@xihan-ui/core";
-import { NumberFormatSpec, SparklineCurve, SparklineMarkers, SparklineReference, SparklineSchema, SparklineTranslations, SparklineVariant } from "@xihan-ui/headless";
 //#region src/components/sparkline/sparkline.d.ts
 type SparklineProps = SparklineSchema['props'];
 /**

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

@@ -1,6 +1,6 @@
+import { SparklineApi, SparklineSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SparklineApi, SparklineSchema } from "@xihan-ui/headless";
 //#region src/components/sparkline/use-sparkline.d.ts
 interface SparklineContext {
   api: ComputedRef<SparklineApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectSparkline, sparklineMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/sparkline/use-sparkline.ts
 /** 量测与度量都在状态机的效应里做，DOM 取值口经 refs 交入。 */
 function useSparkline(props) {

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

@@ -1,6 +1,6 @@
+import { SpinnerTranslations, SpinnerVariant } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Orientation, Size, Tone } from "@xihan-ui/core";
-import { SpinnerTranslations, SpinnerVariant } from "@xihan-ui/headless";
 //#region src/components/spinner/spinner.d.ts
 /** 旋转图形由皮肤绘制在 root 的伪元素上，这里不生成任何子节点。 */
 declare const XhSpinner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

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

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

package/dist/components/splitter/splitter.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { SplitterApi, SplitterPanelProps, SplitterPanelState, SplitterSchema, SplitterTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation } from "@xihan-ui/core";
-import { SplitterApi, SplitterPanelProps, SplitterPanelState, SplitterSchema, SplitterTranslations } from "@xihan-ui/headless";
 //#region src/components/splitter/splitter.d.ts
 type SplitterProps = SplitterSchema['props'];
 /** 默认插槽的载荷：各面板的百分比与逐块状态、拖拽态，以及整份赋值、单块调整、折叠展开的命令。 */

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

@@ -1,6 +1,6 @@
+import { SplitterApi, SplitterSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SplitterApi, SplitterSchema } from "@xihan-ui/headless";
 //#region src/components/splitter/use-splitter.d.ts
 interface SplitterContext {
   api: ComputedRef<SplitterApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSplitter, splitterMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSplitter, splitterMachine } from "@xihan-ui/headless";
 //#region src/components/splitter/use-splitter.ts
 function useSplitter(props, onSizesChange, onSizesChangeEnd) {
 	const rootRef = ref(null);

package/dist/components/statistic/context.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { StatisticApi } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/statistic/context.d.ts
 interface StatisticContext {
   api: ComputedRef<StatisticApi>;

package/dist/components/statistic/statistic.d.ts

@@ -1,6 +1,6 @@
+import { StatisticTrend } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { StatisticTrend } from "@xihan-ui/headless";
 //#region src/components/statistic/statistic.d.ts
 declare const XhStatisticRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   size: {

package/dist/components/statistic/statistic.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { provideStatistic, useStatisticContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
 import { connectStatistic } from "@xihan-ui/headless";
+import { computed, defineComponent, h } from "vue";
 //#region src/components/statistic/statistic.ts
 const XhStatisticRoot = defineComponent({
 	name: "XhStatisticRoot",

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { StepNode, StepStatus, StepsApi, StepsSchema, StepsTranslations, StepsVariant } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { StepNode, StepStatus, StepsApi, StepsSchema, StepsTranslations, StepsVariant } from "@xihan-ui/headless";
 //#region src/components/steps/steps.d.ts
 type StepsProps = StepsSchema['props'];
 /** 默认插槽的载荷：当前步序、总步数、是否完成，以及跳步与前进后退的方法。 */

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

@@ -1,6 +1,6 @@
+import { StepsApi, StepsSchema } from "@xihan-ui/headless";
 import { ComputedRef } from "vue";
 import { Service } from "@xihan-ui/core";
-import { StepsApi, StepsSchema } from "@xihan-ui/headless";
 //#region src/components/steps/use-steps.d.ts
 interface StepsContext {
   api: ComputedRef<StepsApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSteps, stepsMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSteps, stepsMachine } from "@xihan-ui/headless";
 //#region src/components/steps/use-steps.ts
 function useSteps(props, onValueChange) {
 	const service = useMachine(stepsMachine, () => ({

package/dist/components/switch/switch.d.ts

@@ -1,10 +1,14 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { SwitchSchema } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { SwitchSchema } from "@xihan-ui/headless";
 //#region src/components/switch/switch.d.ts
 type SwitchProps = SwitchSchema['props'];
 declare const XhSwitch: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   checked: {
     type: BooleanConstructor;
     default: undefined;
@@ -45,6 +49,10 @@ declare const XhSwitch: import("vue").DefineComponent<import("vue").ExtractPropT
   'checked-change': (_details: PayloadOf<SwitchProps, "onCheckedChange">) => true;
   'update:checked': (_checked: PayloadOf<SwitchProps, "onCheckedChange">["checked"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   checked: {
     type: BooleanConstructor;
     default: undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"switch.d.ts","names":[],"sources":["../../../src/components/switch/switch.ts"],"mappings":";;;;;KAiBK,cAAc;cAEN,wBAAQ,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaD,MAAA,SAAS;EACT,MAAA,SAAS;;;;EAII,mBAAA,UAAA,UAAU;EACV,mBAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EANvB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;qCA2C3B"}
+{"version":3,"file":"switch.d.ts","names":[],"sources":["../../../src/components/switch/switch.ts"],"mappings":";;;;;KAmBK,cAAc;cAmCN,wBAAQ,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeD,MAAA,SAAS;EACT,MAAA,SAAS;;;;EAII,mBAAA,UAAA,UAAU;EACV,mBAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EANvB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;qCAyC3B"}

package/dist/components/switch/switch.js

@@ -1,12 +1,39 @@
+import { renderStructure } from "../../runtime/structure.js";
 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 { useSwitch } from "./use-switch.js";
-import { defineComponent, h, useId } from "vue";
+import { switchStructure } from "@xihan-ui/headless";
+import { defineComponent, h, inject, provide, useId } from "vue";
 //#region src/components/switch/switch.ts
+const SWITCH_API = Symbol("XhSwitchApi");
+function useSwitchApi() {
+	const api = inject(SWITCH_API);
+	if (!api) throw new Error("[xh] 开关的部件只能渲在 XhSwitch 里");
+	return api;
+}
+/** 标准结构里各部件对应的组件。 */
+const SWITCH_PARTS = {
+	"thumb": defineComponent({
+		name: "XhSwitchThumb",
+		setup() {
+			const api = useSwitchApi();
+			return () => h("span", api.value.getThumbProps());
+		}
+	}),
+	"hidden-input": defineComponent({
+		name: "XhSwitchHiddenInput",
+		setup() {
+			const api = useSwitchApi();
+			return () => h("input", api.value.getHiddenInputProps());
+		}
+	})
+};
 const XhSwitch = defineComponent({
 	name: "XhSwitch",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		checked: {
 			type: Boolean,
 			default: void 0
@@ -48,6 +75,7 @@ const XhSwitch = defineComponent({
 			emit("update:checked", details.checked);
 		};
 		const { api } = useSwitch(useFormControlProps(props), notify);
+		provide(SWITCH_API, api);
 		const fieldWiring = useFieldStateWiring();
 		const fieldLabel = useFieldLabelWiring();
 		const textId = useId();
@@ -58,7 +86,7 @@ const XhSwitch = defineComponent({
 				...fieldWiring.value,
 				...api.value.getRootProps(),
 				...labelled ? { "aria-labelledby": textId } : null
-			}), [h("span", api.value.getThumbProps()), props.name === void 0 ? null : h("input", api.value.getHiddenInputProps())]);
+			}), renderStructure(switchStructure({ hiddenInput: props.name !== void 0 }), SWITCH_PARTS));
 			if (!labelled) return track;
 			return h("label", api.value.getLabelProps(), [track, h("span", {
 				...api.value.getTextProps(),

package/dist/components/switch/switch.js.map

@@ -1 +1 @@
-{"version":3,"file":"switch.js","names":[],"sources":["../../../src/components/switch/switch.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// 提供 switch 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { SwitchSchema } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, useId } from 'vue'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { useSwitch } from './use-switch'\n\ntype SwitchProps = SwitchSchema['props']\n\nexport const XhSwitch = defineComponent({\n  name: 'XhSwitch',\n  props: {\n    checked: { type: Boolean, default: undefined },\n    defaultChecked: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    loading: { type: Boolean, default: undefined },\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    value: { type: String },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  // checked-change 携带 { checked }，update:checked 携带裸布尔\n  emits: {\n    'checked-change': (_details: PayloadOf<SwitchProps, 'onCheckedChange'>) => true,\n    'update:checked': (_checked: PayloadOf<SwitchProps, 'onCheckedChange'>['checked']) => true,\n  },\n  setup(props, { emit, slots }) {\n    const notify: SwitchProps['onCheckedChange'] = (details) => {\n      emit('checked-change', details)\n      emit('update:checked', details.checked)\n    }\n    const { api } = useSwitch(useFormControlProps(props) as SwitchProps, notify)\n    // 字段的说明与校验状态要落在焦点所在的那颗按钮上：给了文字时封装根是外面那个 <label>，\n    // XhFieldControl 把整份接线合在它身上，而读屏只念焦点所在节点的描述\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链，否则按钮的名字里只剩组件自己那段文字\n    const fieldLabel = useFieldLabelWiring()\n    // 文字那段的 id：按钮按它取名，字段的标签再排到它前面\n    const textId = useId()\n    // 表单影子由组件自己渲染：单体控件的轨道里没有子部件插槽，作者递不进来。\n    // 给了 name 才有这个节点——type=hidden 不是交互内容，放进 button 里是合法的\n    return () => {\n      // 默认插槽是轨道旁的文字：<label> 包住两者，点文字即切换。没给文字就只有轨道\n      const text = slots.default?.()\n      const labelled = slotPaints(text)\n      const track = h('button', fieldLabel.value({\n        ...fieldWiring.value,\n        ...api.value.getRootProps() as Record<string, unknown>,\n        // 有文字时名字改由它承担；没文字时不写，作者写在组件上的 aria-label 照旧生效\n        ...(labelled ? { 'aria-labelledby': textId } : null),\n      }), [\n        h('span', api.value.getThumbProps() as Record<string, unknown>),\n        props.name === undefined ? null : h('input', api.value.getHiddenInputProps() as Record<string, unknown>),\n      ])\n      if (!labelled)\n        return track\n      return h('label', api.value.getLabelProps() as Record<string, unknown>, [\n        track,\n        h('span', { ...api.value.getTextProps() as Record<string, unknown>, id: textId }, text),\n      ])\n    }\n  },\n})\n"],"mappings":";;;;;;AAmBA,MAAa,WAAW,gBAAgB;CACtC,MAAM;CACN,OAAO;EACL,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,gBAAgB;EAChB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE7C,MAAM,EAAE,MAAM,OAAO;EACrB,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM;EACN,MAAM;CACR;CAEA,OAAO;EACL,mBAAmB,aAAwD;EAC3E,mBAAmB,aAAmE;CACxF;CACA,MAAM,OAAO,EAAE,MAAM,SAAS;EAC5B,MAAM,UAA0C,YAAY;GAC1D,KAAK,kBAAkB,OAAO;GAC9B,KAAK,kBAAkB,QAAQ,OAAO;EACxC;EACA,MAAM,EAAE,QAAQ,UAAU,oBAAoB,KAAK,GAAkB,MAAM;EAG3E,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EAEvC,MAAM,SAAS,MAAM;EAGrB,aAAa;GAEX,MAAM,OAAO,MAAM,UAAU;GAC7B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,QAAQ,EAAE,UAAU,WAAW,MAAM;IACzC,GAAG,YAAY;IACf,GAAG,IAAI,MAAM,aAAa;IAE1B,GAAI,WAAW,EAAE,mBAAmB,OAAO,IAAI;GACjD,CAAC,GAAG,CACF,EAAE,QAAQ,IAAI,MAAM,cAAc,CAA4B,GAC9D,MAAM,SAAS,KAAA,IAAY,OAAO,EAAE,SAAS,IAAI,MAAM,oBAAoB,CAA4B,CACzG,CAAC;GACD,IAAI,CAAC,UACH,OAAO;GACT,OAAO,EAAE,SAAS,IAAI,MAAM,cAAc,GAA8B,CACtE,OACA,EAAE,QAAQ;IAAE,GAAG,IAAI,MAAM,aAAa;IAA8B,IAAI;GAAO,GAAG,IAAI,CACxF,CAAC;EACH;CACF;AACF,CAAC"}
+{"version":3,"file":"switch.js","names":[],"sources":["../../../src/components/switch/switch.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// 提供 switch 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { SwitchApi, SwitchSchema } from '@xihan-ui/headless'\nimport type { InjectionKey, PropType, Ref } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { switchStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, inject, provide, useId } from 'vue'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { useSwitch } from './use-switch'\n\ntype SwitchProps = SwitchSchema['props']\n\nconst SWITCH_API: InjectionKey<Readonly<Ref<SwitchApi>>> = Symbol('XhSwitchApi')\n\nfunction useSwitchApi(): Readonly<Ref<SwitchApi>> {\n  const api = inject(SWITCH_API)\n  if (!api)\n    throw new Error('[xh] 开关的部件只能渲在 XhSwitch 里')\n  return api\n}\n\n/** 滑块。 */\nconst SwitchThumb = defineComponent({\n  name: 'XhSwitchThumb',\n  setup() {\n    const api = useSwitchApi()\n    return () => h('span', api.value.getThumbProps() as Record<string, unknown>)\n  },\n})\n\n/** 表单影子：单体控件的轨道里没有子部件插槽，作者递不进来，由组件自己渲。 */\nconst SwitchHiddenInput = defineComponent({\n  name: 'XhSwitchHiddenInput',\n  setup() {\n    const api = useSwitchApi()\n    return () => h('input', api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst SWITCH_PARTS = {\n  'thumb': SwitchThumb,\n  'hidden-input': SwitchHiddenInput,\n}\n\nexport const XhSwitch = defineComponent({\n  name: 'XhSwitch',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    checked: { type: Boolean, default: undefined },\n    defaultChecked: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    loading: { type: Boolean, default: undefined },\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    value: { type: String },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  // checked-change 携带 { checked }，update:checked 携带裸布尔\n  emits: {\n    'checked-change': (_details: PayloadOf<SwitchProps, 'onCheckedChange'>) => true,\n    'update:checked': (_checked: PayloadOf<SwitchProps, 'onCheckedChange'>['checked']) => true,\n  },\n  setup(props, { emit, slots }) {\n    const notify: SwitchProps['onCheckedChange'] = (details) => {\n      emit('checked-change', details)\n      emit('update:checked', details.checked)\n    }\n    const { api } = useSwitch(useFormControlProps(props) as SwitchProps, notify)\n    provide(SWITCH_API, api)\n    // 字段的说明与校验状态要落在焦点所在的那颗按钮上：给了文字时封装根是外面那个 <label>，\n    // XhFieldControl 把整份接线合在它身上，而读屏只念焦点所在节点的描述\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链，否则按钮的名字里只剩组件自己那段文字\n    const fieldLabel = useFieldLabelWiring()\n    // 文字那段的 id：按钮按它取名，字段的标签再排到它前面\n    const textId = useId()\n    // 表单影子由组件自己渲染：单体控件的轨道里没有子部件插槽，作者递不进来。\n    // 给了 name 才有这个节点——type=hidden 不是交互内容，放进 button 里是合法的\n    return () => {\n      // 默认插槽是轨道旁的文字：<label> 包住两者，点文字即切换。没给文字就只有轨道\n      const text = slots.default?.()\n      const labelled = slotPaints(text)\n      const track = h('button', fieldLabel.value({\n        ...fieldWiring.value,\n        ...api.value.getRootProps() as Record<string, unknown>,\n        // 有文字时名字改由它承担；没文字时不写，作者写在组件上的 aria-label 照旧生效\n        ...(labelled ? { 'aria-labelledby': textId } : null),\n      }), renderStructure(switchStructure({ hiddenInput: props.name !== undefined }), SWITCH_PARTS))\n      if (!labelled)\n        return track\n      return h('label', api.value.getLabelProps() as Record<string, unknown>, [\n        track,\n        h('span', { ...api.value.getTextProps() as Record<string, unknown>, id: textId }, text),\n      ])\n    }\n  },\n})\n"],"mappings":";;;;;;;;AAqBA,MAAM,aAAqD,OAAO,aAAa;AAE/E,SAAS,eAAyC;CAChD,MAAM,MAAM,OAAO,UAAU;CAC7B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2BAA2B;CAC7C,OAAO;AACT;;AAqBA,MAAM,eAAe;CACnB,SAnBkB,gBAAgB;EAClC,MAAM;EACN,QAAQ;GACN,MAAM,MAAM,aAAa;GACzB,aAAa,EAAE,QAAQ,IAAI,MAAM,cAAc,CAA4B;EAC7E;CACF,CAaqB;CACnB,gBAXwB,gBAAgB;EACxC,MAAM;EACN,QAAQ;GACN,MAAM,MAAM,aAAa;GACzB,aAAa,EAAE,SAAS,IAAI,MAAM,oBAAoB,CAA4B;EACpF;CACF,CAKkC;AAClC;AAEA,MAAa,WAAW,gBAAgB;CACtC,MAAM;CACN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAC1B,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,gBAAgB;EAChB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE7C,MAAM,EAAE,MAAM,OAAO;EACrB,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM;EACN,MAAM;CACR;CAEA,OAAO;EACL,mBAAmB,aAAwD;EAC3E,mBAAmB,aAAmE;CACxF;CACA,MAAM,OAAO,EAAE,MAAM,SAAS;EAC5B,MAAM,UAA0C,YAAY;GAC1D,KAAK,kBAAkB,OAAO;GAC9B,KAAK,kBAAkB,QAAQ,OAAO;EACxC;EACA,MAAM,EAAE,QAAQ,UAAU,oBAAoB,KAAK,GAAkB,MAAM;EAC3E,QAAQ,YAAY,GAAG;EAGvB,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EAEvC,MAAM,SAAS,MAAM;EAGrB,aAAa;GAEX,MAAM,OAAO,MAAM,UAAU;GAC7B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,QAAQ,EAAE,UAAU,WAAW,MAAM;IACzC,GAAG,YAAY;IACf,GAAG,IAAI,MAAM,aAAa;IAE1B,GAAI,WAAW,EAAE,mBAAmB,OAAO,IAAI;GACjD,CAAC,GAAG,gBAAgB,gBAAgB,EAAE,aAAa,MAAM,SAAS,KAAA,EAAU,CAAC,GAAG,YAAY,CAAC;GAC7F,IAAI,CAAC,UACH,OAAO;GACT,OAAO,EAAE,SAAS,IAAI,MAAM,cAAc,GAA8B,CACtE,OACA,EAAE,QAAQ;IAAE,GAAG,IAAI,MAAM,aAAa;IAA8B,IAAI;GAAO,GAAG,IAAI,CACxF,CAAC;EACH;CACF;AACF,CAAC"}

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { SwitchApi, SwitchSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/switch/use-switch.d.ts
 interface SwitchContext {
   api: ComputedRef<SwitchApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { connectSwitch, switchMachine } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/switch/use-switch.ts
 function useSwitch(props, onCheckedChange) {
 	const service = useMachine(switchMachine, () => ({

package/dist/components/table/context.js

@@ -5,6 +5,7 @@ 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");
+const FOOTER_LEVEL_KEY = Symbol.for("xh-table-footer-level");
 /** 表头行写明的层号，供行里的列头定位自己在多级表头里的哪一格。 */
 function provideTableHeaderLevel(level) {
 	provide(HEADER_LEVEL_KEY, level);
@@ -12,6 +13,13 @@ function provideTableHeaderLevel(level) {
 function useOptionalTableHeaderLevel() {
 	return inject(HEADER_LEVEL_KEY, null);
 }
+/** 表尾行写明的层号，供行里的格子按 footerCellSpan 定位自己在第几行表尾。 */
+function provideTableFooterLevel(level) {
+	provide(FOOTER_LEVEL_KEY, level);
+}
+function useOptionalTableFooterLevel() {
+	return inject(FOOTER_LEVEL_KEY, null);
+}
 function provideTable(ctx) {
 	provide(KEY, ctx);
 }
@@ -52,6 +60,6 @@ function useOptionalTableColumnContext() {
 	return inject(COLUMN_KEY, null);
 }
 //#endregion
-export { provideTable, provideTableColumn, provideTableHeaderLevel, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableHeaderLevel, useOptionalTableRowContext, useTableColumnContext, useTableContext, useTableRowContext, useTableSection };
+export { provideTable, provideTableColumn, provideTableFooterLevel, provideTableHeaderLevel, provideTableRow, provideTableSection, useOptionalTableColumnContext, useOptionalTableFooterLevel, 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')\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"}
+{"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')\nconst FOOTER_LEVEL_KEY: InjectionKey<ComputedRef<number | undefined>> = Symbol.for('xh-table-footer-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\n/** 表尾行写明的层号，供行里的格子按 footerCellSpan 定位自己在第几行表尾。 */\nexport function provideTableFooterLevel(level: ComputedRef<number | undefined>): void {\n  provide(FOOTER_LEVEL_KEY, level)\n}\n\nexport function useOptionalTableFooterLevel(): ComputedRef<number | undefined> | null {\n  return inject(FOOTER_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;AAC1G,MAAM,mBAAkE,OAAO,IAAI,uBAAuB;;AAG1G,SAAgB,wBAAwB,OAA8C;CACpF,QAAQ,kBAAkB,KAAK;AACjC;AAEA,SAAgB,8BAAsE;CACpF,OAAO,OAAO,kBAAkB,IAAI;AACtC;;AAGA,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,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TableApi, TableColumnDef, TableColumnKind, TableColumnPreference, TableNavigation, TableRowDef, TableSchema, TableSelection, TableSelectionMode, TableSortDescriptor } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 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'];
 /** 默认插槽的载荷：可见行与排序、选中、展开三态，以及逐行查询与改写它们的句柄。 */
@@ -37,6 +37,10 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   cellSpan: {
     type: PropType<TableProps["cellSpan"]>;
   };
+  /** 表尾单元格合并：与 cellSpan 同一种写法，逐格询问第几行表尾的哪一格。 */
+  footerCellSpan: {
+    type: PropType<TableProps["footerCellSpan"]>;
+  };
   /** 与 Virtualizer 的正式接线口：传 Virtualizer 的 collectionVirtualizer，count 等于可见数据行的条数。 */
   virtualizer: {
     type: PropType<TableProps["virtualizer"]>;
@@ -84,9 +88,16 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: PropType<ControlVariant>;
   };
   ruled: BooleanConstructor;
-  footer: BooleanConstructor;
+  /** 表尾行数：行号空间的最后几行留给表尾，每一行表尾写明 level。 */
+  footerRows: {
+    type: NumberConstructor;
+  };
+  /** 表尾吸底，与 stickyHeader 对称。 */
+  stickyFooter: BooleanConstructor;
   /** 行可以拖动换位。整行都是拖动源，不另设把手。 */
   rowReorderable: BooleanConstructor;
+  /** 声明这是一棵树：一行 parentId 都没有时也报 treegrid、Alt + 左右键改层级、任何行都能接受「放进去」。 */
+  tree: BooleanConstructor;
   /** 本次移动是否允许。收到的是折算后的落点（移动到哪个父节点下的第几位）。未提供时全部允许。 */
   allowRowDrop: {
     type: PropType<TableProps["allowRowDrop"]>;
@@ -95,6 +106,10 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 表体的键盘导航粒度：row（缺省）只落在行上；cell 时格子也是焦点落点（treegrid），Enter / F2 进格内编辑。 */
+  navigation: {
+    type: PropType<TableNavigation>;
+  };
   dir: {
     type: PropType<Direction>;
   };
@@ -118,6 +133,7 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   'expanded-value-change': (_details: PayloadOf<TableProps, "onExpandedValueChange">) => true;
   'update:expandedValue': (_value: PayloadOf<TableProps, "onExpandedValueChange">["value"]) => true;
   'row-move': (_details: PayloadOf<TableProps, "onRowMove">) => true;
+  action: (_details: PayloadOf<TableProps, "onAction">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   columns: {
     type: PropType<TableColumnDef[]>;
@@ -144,6 +160,10 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
   cellSpan: {
     type: PropType<TableProps["cellSpan"]>;
   };
+  /** 表尾单元格合并：与 cellSpan 同一种写法，逐格询问第几行表尾的哪一格。 */
+  footerCellSpan: {
+    type: PropType<TableProps["footerCellSpan"]>;
+  };
   /** 与 Virtualizer 的正式接线口：传 Virtualizer 的 collectionVirtualizer，count 等于可见数据行的条数。 */
   virtualizer: {
     type: PropType<TableProps["virtualizer"]>;
@@ -191,9 +211,16 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: PropType<ControlVariant>;
   };
   ruled: BooleanConstructor;
-  footer: BooleanConstructor;
+  /** 表尾行数：行号空间的最后几行留给表尾，每一行表尾写明 level。 */
+  footerRows: {
+    type: NumberConstructor;
+  };
+  /** 表尾吸底，与 stickyHeader 对称。 */
+  stickyFooter: BooleanConstructor;
   /** 行可以拖动换位。整行都是拖动源，不另设把手。 */
   rowReorderable: BooleanConstructor;
+  /** 声明这是一棵树：一行 parentId 都没有时也报 treegrid、Alt + 左右键改层级、任何行都能接受「放进去」。 */
+  tree: BooleanConstructor;
   /** 本次移动是否允许。收到的是折算后的落点（移动到哪个父节点下的第几位）。未提供时全部允许。 */
   allowRowDrop: {
     type: PropType<TableProps["allowRowDrop"]>;
@@ -202,6 +229,10 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 表体的键盘导航粒度：row（缺省）只落在行上；cell 时格子也是焦点落点（treegrid），Enter / F2 进格内编辑。 */
+  navigation: {
+    type: PropType<TableNavigation>;
+  };
   dir: {
     type: PropType<Direction>;
   };
@@ -214,24 +245,26 @@ declare const XhTableRoot: import("vue").DefineComponent<import("vue").ExtractPr
 }>> & Readonly<{
   "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").TableExpandedValueChangeDetails) => any) | undefined;
   "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
-  "onSelection-change"?: ((_details: import("@xihan-ui/headless").TableSelectionChangeDetails) => any) | undefined;
-  "onUpdate:selection"?: ((_selection: TableSelection) => any) | undefined;
+  onAction?: ((_details: import("@xihan-ui/headless").TableActionDetails) => any) | undefined;
   "onColumn-preference-change"?: ((_details: {
     value: TableColumnPreference;
   }) => any) | undefined;
   "onUpdate:columnPreference"?: ((_value: TableColumnPreference) => any) | undefined;
   "onSort-change"?: ((_details: import("@xihan-ui/headless").TableSortChangeDetails) => any) | undefined;
   "onUpdate:sort"?: ((_sort: TableSortDescriptor[]) => any) | undefined;
+  "onSelection-change"?: ((_details: import("@xihan-ui/headless").TableSelectionChangeDetails) => any) | undefined;
+  "onUpdate:selection"?: ((_selection: TableSelection) => any) | undefined;
   "onRow-move"?: ((_details: import("@xihan-ui/headless").TableRowMoveDetails) => any) | undefined;
 }>, {
-  footer: boolean;
   loop: boolean;
-  loading: boolean;
   empty: boolean;
+  loading: boolean;
+  tree: boolean;
   cascade: boolean;
-  striped: boolean;
-  stickyHeader: boolean;
   ruled: boolean;
+  stickyHeader: boolean;
+  striped: boolean;
+  stickyFooter: boolean;
   rowReorderable: boolean;
 }, SlotsType<{
   default?: (props: TableRootSlotProps) => VNode[];
@@ -287,7 +320,7 @@ declare const XhTableRow: import("vue").DefineComponent<import("vue").ExtractPro
   value: {
     type: StringConstructor;
   };
-  /** 多级表头下写明这是第几行表头（1 起算），行里的列头据此定位；单行表头省略。 */
+  /** 多级表头写明这是第几行表头、多行表尾写明这是第几行表尾（1 起算）；只有一行时省略。 */
   level: {
     type: NumberConstructor;
   };
@@ -298,7 +331,7 @@ declare const XhTableRow: import("vue").DefineComponent<import("vue").ExtractPro
   value: {
     type: StringConstructor;
   };
-  /** 多级表头下写明这是第几行表头（1 起算），行里的列头据此定位；单行表头省略。 */
+  /** 多级表头写明这是第几行表头、多行表尾写明这是第几行表尾（1 起算）；只有一行时省略。 */
   level: {
     type: NumberConstructor;
   };

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","names":[],"sources":["../../../src/components/table/table.ts"],"mappings":";;;;;KA0CK,aAAa;;KAyBN,qBAAqB,KAC/B;;;;;KAoCU,wBAAwB,KAClC;cAiBW,2BAAW,8BAAA;;IAIM,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACD,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;;;;IAGL,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;;IAGL,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;IAGpB,MAAA;;;IACO,MAAA;;;;;;;;;;IAKZ,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;;;IAEpB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAIF,6BAAA;IAAE,OAAO;;EACZ,4BAAA,QAAA;EACV,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACF,qBAAA,UAAA,UAAU;EACR,qBAAA,YAAA,UAAU;EACP,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;EAEpB,aAAA,UAAA,UAAU;;;IAnDP,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACD,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;;;;IAGL,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;;IAGL,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;IAGpB,MAAA;;;IACO,MAAA;;;;;;;;;;IAKZ,MAAA,SAAS;;;;;;;;IAMF,MAAA,SAAS;;;;;;;IAEpB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;IAIO,OAAA;;;;;;;;;;;;;;;;;EAYtC,WAAC,OAAO,uBAAuB;;;;;EAK/B,WAAC,OAAO,0BAA0B;kCAwF9C;;;;;;cAOW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;cAMW,8CAA8B,8BAAA;;;;;;;;;;;;MAkBzC,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAQtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,8BAAA;;;;;;;;;;;;;;;;;;;;MAiCrB,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;MAkB9B,oDAAA;;;;;;cAOW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;;;;;;;IAMiB,MAAA;;;;;;;;;;;;IAAA,MAAA;;MAgBvC,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAUlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAWlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;cAMW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAW7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAWrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAWnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAWhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAW/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;;;MAgB7B,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"table.d.ts","names":[],"sources":["../../../src/components/table/table.ts"],"mappings":"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"}