@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/side-nav/use-side-nav.js

@@ -2,9 +2,9 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSideNav, sideNavMachine } from "@xihan-ui/headless";
 import { computed, shallowRef } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectSideNav, sideNavMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/side-nav/use-side-nav.ts
 function useSideNav(props, handlers = {}) {

package/dist/components/signature-pad/signature-pad.d.ts

@@ -1,11 +1,19 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { SignaturePadApi, SignaturePadDrawingOptions, SignaturePadSchema, SignaturePadTranslations, SignaturePadValue } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/signature-pad/signature-pad.d.ts
 type SignaturePadProps = SignaturePadSchema['props'];
 /** 默认插槽的载荷：签名数据、笔迹路径与空态、落笔中标记，以及导出、清空、撤销与重做的动作。 */
 type SignaturePadRootSlotProps = Pick<SignaturePadApi, 'value' | 'paths' | 'empty' | 'drawing' | 'disabled' | 'readOnly' | 'canUndo' | 'canRedo' | 'statusText' | 'toSvg' | 'clear' | 'undo' | 'redo'>;
 declare const XhSignaturePadRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -46,6 +54,14 @@ declare const XhSignaturePadRoot: import("vue").DefineComponent<import("vue").Ex
   'value-change': (_details: PayloadOf<SignaturePadProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<SignaturePadProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -90,6 +106,7 @@ declare const XhSignaturePadRoot: import("vue").DefineComponent<import("vue").Ex
   readOnly: boolean;
 }, SlotsType<{
   default?: (props: SignaturePadRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhSignaturePadLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/signature-pad/signature-pad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signature-pad.d.ts","names":[],"sources":["../../../src/components/signature-pad/signature-pad.ts"],"mappings":";;;;KAiBK,oBAAoB;;KAGb,4BAA4B,KACtC;cAgBW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;;;;;;IAUF,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACJ,MAAA,SAAS,QAAQ;;;;;;EAK9B,OAAA,UAAA,UAAU;EACN,aAAA,UAAA,UAAU;EACN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;IAXV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACJ,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;EAWvC,WAAC,OAAO,8BAA8B;kCA2BlD;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAWhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAW/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"signature-pad.d.ts","names":[],"sources":["../../../src/components/signature-pad/signature-pad.ts"],"mappings":";;;;KAoBK,oBAAoB;;KAGb,4BAA4B,KACtC;cAgBW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcF,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACJ,MAAA,SAAS,QAAQ;;;;;;EAK9B,OAAA,UAAA,UAAU;EACN,aAAA,UAAA,UAAU;EACN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAXV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACJ,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;EAWvC,WAAC,OAAO,8BAA8B;EACxC,cAAM;kCAgChB;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAY9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAchC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAW/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/signature-pad/signature-pad.js

@@ -1,13 +1,20 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideSignaturePad, useSignaturePadContext } from "./context.js";
 import { useSignaturePad } from "./use-signature-pad.js";
-import { defineComponent, h } from "vue";
+import { signaturePadStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/signature-pad/signature-pad.ts
 const XhSignaturePadRoot = defineComponent({
 	name: "XhSignaturePadRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		disabled: {
 			type: Boolean,
 			default: void 0
@@ -51,36 +58,48 @@ const XhSignaturePadRoot = defineComponent({
 			onValueChange
 		});
 		provideSignaturePad(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			paths: ctx.api.value.paths,
-			empty: ctx.api.value.empty,
-			drawing: ctx.api.value.drawing,
-			disabled: ctx.api.value.disabled,
-			readOnly: ctx.api.value.readOnly,
-			canUndo: ctx.api.value.canUndo,
-			canRedo: ctx.api.value.canRedo,
-			statusText: ctx.api.value.statusText,
-			toSvg: ctx.api.value.toSvg,
-			clear: ctx.api.value.clear,
-			undo: ctx.api.value.undo,
-			redo: ctx.api.value.redo
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				paths: api.paths,
+				empty: api.empty,
+				drawing: api.drawing,
+				disabled: api.disabled,
+				readOnly: api.readOnly,
+				canUndo: api.canUndo,
+				canRedo: api.canRedo,
+				statusText: api.statusText,
+				toSvg: api.toSvg,
+				clear: api.clear,
+				undo: api.undo,
+				redo: api.redo
+			}) : renderDefaultStructure(api, props.label, props.name !== void 0, slots.label));
+		};
 	}
 });
 const XhSignaturePadLabel = defineComponent({
 	name: "XhSignaturePadLabel",
 	setup(_, { slots }) {
 		const ctx = useSignaturePadContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
 const XhSignaturePadControl = defineComponent({
 	name: "XhSignaturePadControl",
 	setup(_, { slots }) {
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useSignaturePadContext();
 		return () => h("svg", {
-			...ctx.api.value.getControlProps(),
+			...fieldLabel.value({
+				...fieldWiring.value,
+				...ctx.api.value.getControlProps()
+			}),
 			ref: ctx.controlRef
 		}, slots.default?.());
 	}
@@ -134,6 +153,27 @@ const XhSignaturePadHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const SIGNATURE_PAD_PARTS = {
+	"label": XhSignaturePadLabel,
+	"control": XhSignaturePadControl,
+	"guide": XhSignaturePadGuide,
+	"path": XhSignaturePadPath,
+	"clear-trigger": XhSignaturePadClearTrigger,
+	"status": XhSignaturePadStatus,
+	"hidden-input": XhSignaturePadHiddenInput
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 signaturePadStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, hiddenInput, labelSlot) {
+	return renderStructure(signaturePadStructure(api, {
+		label,
+		hiddenInput,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), SIGNATURE_PAD_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhSignaturePadClearTrigger, XhSignaturePadControl, XhSignaturePadGuide, XhSignaturePadHiddenInput, XhSignaturePadLabel, XhSignaturePadPath, XhSignaturePadRedoTrigger, XhSignaturePadRoot, XhSignaturePadStatus, XhSignaturePadUndoTrigger };
 

package/dist/components/signature-pad/signature-pad.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature-pad.js","names":[],"sources":["../../../src/components/signature-pad/signature-pad.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// 提供 signature pad 相关实现。\n\nimport type { SignaturePadApi, SignaturePadDrawingOptions, SignaturePadSchema, SignaturePadTranslations, SignaturePadValue } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideSignaturePad, useSignaturePadContext } from './context'\nimport { useSignaturePad } from './use-signature-pad'\n\ntype SignaturePadProps = SignaturePadSchema['props']\n\n/** 默认插槽的载荷：签名数据、笔迹路径与空态、落笔中标记，以及导出、清空、撤销与重做的动作。 */\nexport type SignaturePadRootSlotProps = Pick<\n  SignaturePadApi,\n  | 'value'\n  | 'paths'\n  | 'empty'\n  | 'drawing'\n  | 'disabled'\n  | 'readOnly'\n  | 'canUndo'\n  | 'canRedo'\n  | 'statusText'\n  | 'toSvg'\n  | 'clear'\n  | 'undo'\n  | 'redo'\n>\n\nexport const XhSignaturePadRoot = defineComponent({\n  name: 'XhSignaturePadRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Object as PropType<SignaturePadValue> },\n    defaultValue: { type: Object as PropType<SignaturePadValue> },\n    drawing: { type: Object as PropType<SignaturePadDrawingOptions> },\n    translations: { type: Object as PropType<Partial<SignaturePadTranslations>> },\n  },\n  // draw / draw-end 是笔迹通知；value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'clear': () => true,\n    'draw': (_details: PayloadOf<SignaturePadProps, 'onDraw'>) => true,\n    'draw-end': (_details: PayloadOf<SignaturePadProps, 'onDrawEnd'>) => true,\n    'value-change': (_details: PayloadOf<SignaturePadProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SignaturePadProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: SignaturePadRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onDraw: SignaturePadProps['onDraw'] = details => emit('draw', details)\n    const onDrawEnd: SignaturePadProps['onDrawEnd'] = details => emit('draw-end', details)\n    const onValueChange: SignaturePadProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSignaturePad(withHandlers(withXhConfig('signature-pad', useFormControlProps(props)), { onClear: () => emit('clear') }) as SignaturePadProps, { onDraw, onDrawEnd, onValueChange })\n    provideSignaturePad(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      paths: ctx.api.value.paths,\n      empty: ctx.api.value.empty,\n      drawing: ctx.api.value.drawing,\n      disabled: ctx.api.value.disabled,\n      readOnly: ctx.api.value.readOnly,\n      canUndo: ctx.api.value.canUndo,\n      canRedo: ctx.api.value.canRedo,\n      statusText: ctx.api.value.statusText,\n      toSvg: ctx.api.value.toSvg,\n      clear: ctx.api.value.clear,\n      undo: ctx.api.value.undo,\n      redo: ctx.api.value.redo,\n    }))\n  },\n})\n\nexport const XhSignaturePadLabel = defineComponent({\n  name: 'XhSignaturePadLabel',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    // 不用原生 label：画布是 svg、不是可被 label 关联的表单控件，名字经 aria-labelledby 挂过去\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadControl = defineComponent({\n  name: 'XhSignaturePadControl',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    // 画布是 svg：笔迹与基准线都是图元。viewBox 由连接层按钉住的尺寸给，\n    // 基准线与笔迹都建在这棵 svg 子树里，命名空间由它带下去\n    return () => h('svg', {\n      ...ctx.api.value.getControlProps() as Record<string, unknown>,\n      ref: ctx.controlRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadGuide = defineComponent({\n  name: 'XhSignaturePadGuide',\n  setup() {\n    const ctx = useSignaturePadContext()\n    return () => h('line', ctx.api.value.getGuideProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhSignaturePadPath = defineComponent({\n  name: 'XhSignaturePadPath',\n  setup() {\n    const ctx = useSignaturePadContext()\n    // 全部笔迹落在这一条路径上，每一笔是它的一条子路径\n    return () => h('path', ctx.api.value.getPathProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhSignaturePadClearTrigger = defineComponent({\n  name: 'XhSignaturePadClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadUndoTrigger = defineComponent({\n  name: 'XhSignaturePadUndoTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getUndoTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadRedoTrigger = defineComponent({\n  name: 'XhSignaturePadRedoTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getRedoTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadStatus = defineComponent({\n  name: 'XhSignaturePadStatus',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    // 作者不写内容就用内建那句话，读屏才有东西可念\n    return () => h(\n      'span',\n      ctx.api.value.getStatusProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.statusText,\n    )\n  },\n})\n\nexport const XhSignaturePadHiddenInput = defineComponent({\n  name: 'XhSignaturePadHiddenInput',\n  setup() {\n    const ctx = useSignaturePadContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"signature-pad.js","names":[],"sources":["../../../src/components/signature-pad/signature-pad.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// 提供 signature pad 相关实现。\n\nimport type { SignaturePadApi, SignaturePadDrawingOptions, SignaturePadSchema, SignaturePadTranslations, SignaturePadValue } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { signaturePadStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideSignaturePad, useSignaturePadContext } from './context'\nimport { useSignaturePad } from './use-signature-pad'\n\ntype SignaturePadProps = SignaturePadSchema['props']\n\n/** 默认插槽的载荷：签名数据、笔迹路径与空态、落笔中标记，以及导出、清空、撤销与重做的动作。 */\nexport type SignaturePadRootSlotProps = Pick<\n  SignaturePadApi,\n  | 'value'\n  | 'paths'\n  | 'empty'\n  | 'drawing'\n  | 'disabled'\n  | 'readOnly'\n  | 'canUndo'\n  | 'canRedo'\n  | 'statusText'\n  | 'toSvg'\n  | 'clear'\n  | 'undo'\n  | 'redo'\n>\n\nexport const XhSignaturePadRoot = defineComponent({\n  name: 'XhSignaturePadRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Object as PropType<SignaturePadValue> },\n    defaultValue: { type: Object as PropType<SignaturePadValue> },\n    drawing: { type: Object as PropType<SignaturePadDrawingOptions> },\n    translations: { type: Object as PropType<Partial<SignaturePadTranslations>> },\n  },\n  // draw / draw-end 是笔迹通知；value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'clear': () => true,\n    'draw': (_details: PayloadOf<SignaturePadProps, 'onDraw'>) => true,\n    'draw-end': (_details: PayloadOf<SignaturePadProps, 'onDrawEnd'>) => true,\n    'value-change': (_details: PayloadOf<SignaturePadProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SignaturePadProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: SignaturePadRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onDraw: SignaturePadProps['onDraw'] = details => emit('draw', details)\n    const onDrawEnd: SignaturePadProps['onDrawEnd'] = details => emit('draw-end', details)\n    const onValueChange: SignaturePadProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSignaturePad(withHandlers(withXhConfig('signature-pad', useFormControlProps(props)), { onClear: () => emit('clear') }) as SignaturePadProps, { onDraw, onDrawEnd, onValueChange })\n    provideSignaturePad(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            paths: api.paths,\n            empty: api.empty,\n            drawing: api.drawing,\n            disabled: api.disabled,\n            readOnly: api.readOnly,\n            canUndo: api.canUndo,\n            canRedo: api.canRedo,\n            statusText: api.statusText,\n            toSvg: api.toSvg,\n            clear: api.clear,\n            undo: api.undo,\n            redo: api.redo,\n          })\n        : renderDefaultStructure(api, props.label, props.name !== undefined, slots.label))\n    }\n  },\n})\n\nexport const XhSignaturePadLabel = defineComponent({\n  name: 'XhSignaturePadLabel',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 不用原生 label：画布是 svg、不是可被 label 关联的表单控件，名字经 aria-labelledby 挂过去\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadControl = defineComponent({\n  name: 'XhSignaturePadControl',\n  setup(_, { slots }) {\n    // 放进字段时字段的标题并进画布的名字，说明与错误文案进描述链；画布是 role=img，只取组类接线\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useSignaturePadContext()\n    // 画布是 svg：笔迹与基准线都是图元。viewBox 由连接层按钉住的尺寸给，\n    // 基准线与笔迹都建在这棵 svg 子树里，命名空间由它带下去\n    return () => h('svg', {\n      ...fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getControlProps() as Record<string, unknown> }),\n      ref: ctx.controlRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadGuide = defineComponent({\n  name: 'XhSignaturePadGuide',\n  setup() {\n    const ctx = useSignaturePadContext()\n    return () => h('line', ctx.api.value.getGuideProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhSignaturePadPath = defineComponent({\n  name: 'XhSignaturePadPath',\n  setup() {\n    const ctx = useSignaturePadContext()\n    // 全部笔迹落在这一条路径上，每一笔是它的一条子路径\n    return () => h('path', ctx.api.value.getPathProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhSignaturePadClearTrigger = defineComponent({\n  name: 'XhSignaturePadClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadUndoTrigger = defineComponent({\n  name: 'XhSignaturePadUndoTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getUndoTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadRedoTrigger = defineComponent({\n  name: 'XhSignaturePadRedoTrigger',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    return () => h('button', ctx.api.value.getRedoTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSignaturePadStatus = defineComponent({\n  name: 'XhSignaturePadStatus',\n  setup(_, { slots }) {\n    const ctx = useSignaturePadContext()\n    // 作者不写内容就用内建那句话，读屏才有东西可念\n    return () => h(\n      'span',\n      ctx.api.value.getStatusProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.statusText,\n    )\n  },\n})\n\nexport const XhSignaturePadHiddenInput = defineComponent({\n  name: 'XhSignaturePadHiddenInput',\n  setup() {\n    const ctx = useSignaturePadContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst SIGNATURE_PAD_PARTS = {\n  'label': XhSignaturePadLabel,\n  'control': XhSignaturePadControl,\n  'guide': XhSignaturePadGuide,\n  'path': XhSignaturePadPath,\n  'clear-trigger': XhSignaturePadClearTrigger,\n  'status': XhSignaturePadStatus,\n  'hidden-input': XhSignaturePadHiddenInput,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 signaturePadStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: SignaturePadApi, label: string | undefined, hiddenInput: boolean, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = signaturePadStructure(api, { label, hiddenInput, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, SIGNATURE_PAD_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/signature-pad/use-signature-pad.d.ts

@@ -1,8 +1,13 @@
+import { SignaturePadApi, SignaturePadSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SignaturePadApi, SignaturePadSchema } from "@xihan-ui/headless";
 //#region src/components/signature-pad/use-signature-pad.d.ts
 interface SignaturePadContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhSignaturePadLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<SignaturePadApi>;
   service: Service<SignaturePadSchema>;
   /** 画布节点，状态机在指针事件中用它把屏幕坐标换算为画布坐标。 */

package/dist/components/signature-pad/use-signature-pad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-signature-pad.d.ts","names":[],"sources":["../../../src/components/signature-pad/use-signature-pad.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,YAAY,IAAI;;iBAGF,gBACd,OAAO,6BACP,YAAW,KAAK,yEACf"}
+{"version":3,"file":"use-signature-pad.d.ts","names":[],"sources":["../../../src/components/signature-pad/use-signature-pad.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,YAAY,IAAI;;iBAGF,gBACd,OAAO,6BACP,YAAW,KAAK,yEACf"}

package/dist/components/signature-pad/use-signature-pad.js

@@ -1,18 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSignaturePad, signaturePadMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSignaturePad, signaturePadMachine } from "@xihan-ui/headless";
 //#region src/components/signature-pad/use-signature-pad.ts
 function useSignaturePad(props, callbacks = {}) {
 	const controlRef = ref(null);
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(signaturePadMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...callbacks
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	service.refs.set("getControlEl", () => controlRef.value);
 	return {
+		labelCount,
 		api: computed(() => connectSignaturePad(service, vueNormalize)),
 		service,
 		controlRef

package/dist/components/signature-pad/use-signature-pad.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-signature-pad.js","names":[],"sources":["../../../src/components/signature-pad/use-signature-pad.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 signature pad 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SignaturePadApi, SignaturePadSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectSignaturePad, signaturePadMachine } 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 SignaturePadContext {\n  api: ComputedRef<SignaturePadApi>\n  service: Service<SignaturePadSchema>\n  /** 画布节点，状态机在指针事件中用它把屏幕坐标换算为画布坐标。 */\n  controlRef: Ref<Element | null>\n}\n\nexport function useSignaturePad(\n  props: SignaturePadSchema['props'],\n  callbacks: Pick<SignaturePadSchema['props'], 'onDraw' | 'onDrawEnd' | 'onValueChange'> = {},\n): SignaturePadContext {\n  const controlRef = ref<Element | null>(null)\n\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(signaturePadMachine, () => ({ ...props, ...callbacks }), scope)\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getControlEl', () => controlRef.value)\n\n  const api = computed(() => connectSignaturePad(service, vueNormalize))\n  return { api, service, controlRef }\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,gBACd,OACA,YAAyF,CAAC,GACrE;CACrB,MAAM,aAAa,IAAoB,IAAI;CAK3C,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG;EAAO,GAAG;CAAU,IADlE,YAAY,MADZ,qBACsB,CACoD,CAAC;CAGzF,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE,KADG,eAAe,oBAAoB,SAAS,YAAY,CACzD;EAAG;EAAS;CAAW;AACpC"}
+{"version":3,"file":"use-signature-pad.js","names":[],"sources":["../../../src/components/signature-pad/use-signature-pad.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 signature pad 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SignaturePadApi, SignaturePadSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectSignaturePad, signaturePadMachine } 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 SignaturePadContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhSignaturePadLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<SignaturePadApi>\n  service: Service<SignaturePadSchema>\n  /** 画布节点，状态机在指针事件中用它把屏幕坐标换算为画布坐标。 */\n  controlRef: Ref<Element | null>\n}\n\nexport function useSignaturePad(\n  props: SignaturePadSchema['props'],\n  callbacks: Pick<SignaturePadSchema['props'], 'onDraw' | 'onDrawEnd' | 'onValueChange'> = {},\n): SignaturePadContext {\n  const controlRef = ref<Element | null>(null)\n\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(signaturePadMachine, () => ({ ...props, labelled: labelCount.value > 0, ...callbacks }), scope)\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getControlEl', () => controlRef.value)\n\n  const api = computed(() => connectSignaturePad(service, vueNormalize))\n  return { labelCount, api, service, controlRef }\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,gBACd,OACA,YAAyF,CAAC,GACrE;CACrB,MAAM,aAAa,IAAoB,IAAI;CAI3C,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAU,IAAI,KAAK;CAGzH,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE;EAAY,KADT,eAAe,oBAAoB,SAAS,YAAY,CAC7C;EAAG;EAAS;CAAW;AAChD"}

package/dist/components/skeleton/skeleton.d.ts

@@ -1,5 +1,5 @@
-import { PropType } from "vue";
 import { SkeletonAnimation, SkeletonShape } from "@xihan-ui/headless";
+import { PropType } from "vue";
 //#region src/components/skeleton/skeleton.d.ts
 /** 骨架容器：加载期间报告 aria-busy，加载结束后整块收起。 */
 declare const XhSkeletonRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

package/dist/components/skeleton/use-skeleton.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 { connectSkeleton, skeletonMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSkeleton, skeletonMachine } from "@xihan-ui/headless";
 //#region src/components/skeleton/use-skeleton.ts
 function useSkeleton(props) {
 	const service = useMachine(skeletonMachine, () => ({ ...props }), createScope(null, createVueIdGenerator()));

package/dist/components/slider/slider.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { SliderApi, SliderMark, SliderMarkMeta, SliderSchema, SliderValueTextDetails } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { SliderApi, SliderMark, SliderMarkMeta, SliderSchema, SliderValueTextDetails } from "@xihan-ui/headless";
 //#region src/components/slider/slider.d.ts
 type SliderProps = SliderSchema['props'];
 /** 默认插槽的载荷：当前值、逐个滑块的状态、已选区间与拖动标记，以及整份改值与单个滑块改值。 */
@@ -11,6 +11,14 @@ interface SliderTickGroupTickSlotProps {
   tick: SliderMarkMeta;
 }
 declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<number[]>;
   };
@@ -69,6 +77,10 @@ declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   tone: {
     type: PropType<Tone>;
   };
@@ -88,6 +100,14 @@ declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractP
   'update:value': (_value: PayloadOf<SliderProps, "onValueChange">["value"]) => true;
   'value-change-end': (_details: PayloadOf<SliderProps, "onValueChangeEnd">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<number[]>;
   };
@@ -146,6 +166,10 @@ declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   tone: {
     type: PropType<Tone>;
   };
@@ -163,6 +187,7 @@ declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onUpdate:value"?: ((_value: number[]) => any) | undefined;
   "onValue-change-end"?: ((_details: import("@xihan-ui/headless").SliderValueChangeEndDetails) => any) | undefined;
 }>, {
+  required: boolean;
   invalid: boolean;
   disabled: boolean;
   readOnly: boolean;
@@ -172,6 +197,7 @@ declare const XhSliderRoot: import("vue").DefineComponent<import("vue").ExtractP
   trackFill: boolean;
 }, SlotsType<{
   default?: (props: SliderRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhSliderLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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

@@ -1 +1 @@
-{"version":3,"file":"slider.d.ts","names":[],"sources":["../../../src/components/slider/slider.ts"],"mappings":";;;;;KAkBK,cAAc;;KAGP,sBAAsB,KAChC;;UAKe;EACf,MAAM;;cAGK,4BAAY,8BAAA;;IAIG,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;IAGb,MAAA,UAAU,SAAS;;;;;EAKZ,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACJ,qBAAA,UAAA,UAAU;;;IA5BjB,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;IAGb,MAAA,UAAU,SAAS;;;;;;;;;;;;;;;EAU7B,WAAC,OAAO,wBAAwB;kCAqB5C;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAUxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;;EAGnB,QAAC,OAAO,iCAAiC;kCAclD;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;IAIa,MAAA;;;;;;;;IAAA,MAAA;;;;;qCAWrC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"slider.d.ts","names":[],"sources":["../../../src/components/slider/slider.ts"],"mappings":";;;;;KAoBK,cAAc;;KAGP,sBAAsB,KAChC;;UAKe;EACf,MAAM;;cAGK,4BAAY,8BAAA;;;;;;;;;;IAQG,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;IAGb,MAAA,UAAU,SAAS;;;;;EAKZ,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACJ,qBAAA,UAAA,UAAU;;;;;;;;;;;IA7BjB,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAKR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;IAGb,MAAA,UAAU,SAAS;;;;;;;;;;;;;;;;EAU7B,WAAC,OAAO,wBAAwB;EAClC,cAAM;kCA0BhB;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAWxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAUxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;;EAGnB,QAAC,OAAO,iCAAiC;kCAclD;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;IAIa,MAAA;;;;;;;;IAAA,MAAA;;;;;qCAWrC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/slider/slider.js

@@ -1,13 +1,19 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideSlider, provideSliderThumb, useSliderContext, useSliderThumbContext } from "./context.js";
 import { useSlider } from "./use-slider.js";
-import { computed, defineComponent, h } from "vue";
+import { sliderStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onUnmounted } from "vue";
 import { normalizeItemIndex } from "@xihan-ui/core";
 //#region src/components/slider/slider.ts
 const XhSliderRoot = defineComponent({
 	name: "XhSliderRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		value: { type: Array },
 		defaultValue: { type: Array },
 		min: { type: Number },
@@ -46,6 +52,10 @@ const XhSliderRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		tone: { type: String },
 		size: { type: String },
 		name: { type: String },
@@ -67,20 +77,27 @@ const XhSliderRoot = defineComponent({
 		};
 		const ctx = useSlider(useFormControlProps(props), notify, notifyEnd);
 		provideSlider(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			thumbs: ctx.api.value.thumbs,
-			range: ctx.api.value.range,
-			dragging: ctx.api.value.dragging,
-			setValue: ctx.api.value.setValue,
-			setThumbValue: ctx.api.value.setThumbValue
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				thumbs: api.thumbs,
+				range: api.range,
+				dragging: api.dragging,
+				setValue: api.setValue,
+				setThumbValue: api.setThumbValue
+			}) : renderDefaultStructure(api, props.label, props.name !== void 0, slots.label));
+		};
 	}
 });
 const XhSliderLabel = defineComponent({
 	name: "XhSliderLabel",
 	setup(_, { slots }) {
 		const ctx = useSliderContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -158,6 +175,38 @@ const XhSliderHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps(index.value));
 	}
 });
+/** 标准结构里各部件对应的组件；刻度的圆点与文案由 XhSliderTickGroup 自己铺。 */
+const SLIDER_PARTS = {
+	"label": XhSliderLabel,
+	"control": XhSliderControl,
+	"track": XhSliderTrack,
+	"range": XhSliderRange,
+	"tick-group": XhSliderTickGroup,
+	"thumb": XhSliderThumb,
+	"hidden-input": XhSliderHiddenInput
+};
+/** 刻度组自己按 marks 铺圆点与文案，铺结构时去掉这两格。 */
+function withoutSelfAssembled(nodes) {
+	return nodes.flatMap((node) => {
+		if (!("part" in node)) return [node];
+		if (node.part === "tick" || node.part === "tick-label") return [];
+		return [node.children ? {
+			...node,
+			children: withoutSelfAssembled(node.children)
+		} : node];
+	});
+}
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 sliderStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, hiddenInput, labelSlot) {
+	return renderStructure(withoutSelfAssembled(sliderStructure(api, {
+		label,
+		hiddenInput,
+		slotted: (name) => name === "label" && labelSlot != null
+	})), SLIDER_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhSliderControl, XhSliderHiddenInput, XhSliderLabel, XhSliderRange, XhSliderRoot, XhSliderThumb, XhSliderTickGroup, XhSliderTrack, XhSliderValueText };
 

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

@@ -1 +1 @@
-{"version":3,"file":"slider.js","names":[],"sources":["../../../src/components/slider/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// 提供 slider 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { SliderApi, SliderMark, SliderMarkMeta, SliderSchema, SliderValueTextDetails } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { normalizeItemIndex } from '@xihan-ui/core'\nimport { computed, defineComponent, h } from 'vue'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideSlider, provideSliderThumb, useSliderContext, useSliderThumbContext } from './context'\nimport { useSlider } from './use-slider'\n\ntype SliderProps = SliderSchema['props']\n\n/** 默认插槽的载荷：当前值、逐个滑块的状态、已选区间与拖动标记，以及整份改值与单个滑块改值。 */\nexport type SliderRootSlotProps = Pick<\n  SliderApi,\n  'value' | 'thumbs' | 'range' | 'dragging' | 'setValue' | 'setThumbValue'\n>\n\n/** tick 插槽的载荷：该档刻度的呈现数据。 */\nexport interface SliderTickGroupTickSlotProps {\n  tick: SliderMarkMeta\n}\n\nexport const XhSliderRoot = defineComponent({\n  name: 'XhSliderRoot',\n  props: {\n    // 值恒是数组，单滑块即长度 1；缺席值 undefined 表示非受控\n    value: { type: Array as PropType<number[]> },\n    defaultValue: { type: Array as PropType<number[]> },\n    min: { type: Number },\n    max: { type: Number },\n    step: { type: Number },\n    largeStep: { type: Number },\n    minStepsBetweenThumbs: { type: Number },\n    marks: { type: Array as PropType<SliderMark[]> },\n    snapToMarks: { type: Boolean, default: undefined },\n    inverted: { type: Boolean, default: undefined },\n    draggableRange: { type: Boolean, default: undefined },\n    trackFill: { type: Boolean, default: undefined },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    name: { type: String },\n    getValueText: {\n      type: Function as PropType<(details: SliderValueTextDetails) => string>,\n    },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组；value-change-end 只在操作收尾时发一次\n  emits: {\n    'value-change': (_details: PayloadOf<SliderProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SliderProps, 'onValueChange'>['value']) => true,\n    'value-change-end': (_details: PayloadOf<SliderProps, 'onValueChangeEnd'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: SliderRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: SliderProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyEnd: SliderProps['onValueChangeEnd'] = (details) => {\n      emit('value-change-end', details)\n    }\n    const ctx = useSlider(useFormControlProps(props) as SliderProps, notify, notifyEnd)\n    provideSlider(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      thumbs: ctx.api.value.thumbs,\n      range: ctx.api.value.range,\n      dragging: ctx.api.value.dragging,\n      setValue: ctx.api.value.setValue,\n      setThumbValue: ctx.api.value.setThumbValue,\n    }))\n  },\n})\n\nexport const XhSliderLabel = defineComponent({\n  name: 'XhSliderLabel',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderControl = defineComponent({\n  name: 'XhSliderControl',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderTrack = defineComponent({\n  name: 'XhSliderTrack',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    // 轨道节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getTrackProps() as Record<string, unknown>,\n      ref: ctx.trackRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhSliderTickGroup = defineComponent({\n  name: 'XhSliderTickGroup',\n  slots: Object as SlotsType<{\n    tick?: (props: SliderTickGroupTickSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    // 刻度整组自动铺：圆点 + 文案（点文案跳值）；tick 插槽可换文案内容\n    return () => h('div', ctx.api.value.getTickGroupProps() as Record<string, unknown>, ctx.api.value.marks.flatMap(tick => [\n      h('span', { ...ctx.api.value.getTickProps({ value: tick.value }) as Record<string, unknown>, key: `dot-${tick.value}` }),\n      h(\n        'span',\n        { ...ctx.api.value.getTickLabelProps({ value: tick.value }) as Record<string, unknown>, key: `label-${tick.value}` },\n        slots.tick ? slots.tick({ tick }) : tick.label,\n      ),\n    ]))\n  },\n})\n\nexport const XhSliderRange = defineComponent({\n  name: 'XhSliderRange',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    return () => h('div', ctx.api.value.getRangeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderThumb = defineComponent({\n  name: 'XhSliderThumb',\n  props: {\n    /** 第几个滑块，多滑块时必须逐个写明（`:index=\"i\"`）；兼收字符串。 */\n    index: { type: [Number, String] as PropType<number | string>, default: 0 },\n  },\n  setup(props, { slots }) {\n    const ctx = useSliderContext()\n    const index = computed(() => normalizeItemIndex(props.index))\n    provideSliderThumb({ index })\n    // 放进表单字段时，字段的标题与说明接到拇指上：焦点落在拇指，读屏在这里念名字与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getThumbProps(index.value) as Record<string, unknown> }), slots.default?.())\n  },\n})\n\nexport const XhSliderValueText = defineComponent({\n  name: 'XhSliderValueText',\n  setup(_, { slots }) {\n    const { index } = useSliderThumbContext()\n    const ctx = useSliderContext()\n    // 值气泡：写在拇指里，没给内容就填这一个拇指的值文本\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps(index.value) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.valueText(index.value),\n    )\n  },\n})\n\nexport const XhSliderHiddenInput = defineComponent({\n  name: 'XhSliderHiddenInput',\n  setup() {\n    const { index } = useSliderThumbContext()\n    const ctx = useSliderContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps(index.value) as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"slider.js","names":[],"sources":["../../../src/components/slider/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// 提供 slider 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { SliderApi, SliderMark, SliderMarkMeta, SliderSchema, SliderValueTextDetails, StructureChild } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { normalizeItemIndex } from '@xihan-ui/core'\nimport { sliderStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onUnmounted } from 'vue'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideSlider, provideSliderThumb, useSliderContext, useSliderThumbContext } from './context'\nimport { useSlider } from './use-slider'\n\ntype SliderProps = SliderSchema['props']\n\n/** 默认插槽的载荷：当前值、逐个滑块的状态、已选区间与拖动标记，以及整份改值与单个滑块改值。 */\nexport type SliderRootSlotProps = Pick<\n  SliderApi,\n  'value' | 'thumbs' | 'range' | 'dragging' | 'setValue' | 'setThumbValue'\n>\n\n/** tick 插槽的载荷：该档刻度的呈现数据。 */\nexport interface SliderTickGroupTickSlotProps {\n  tick: SliderMarkMeta\n}\n\nexport const XhSliderRoot = defineComponent({\n  name: 'XhSliderRoot',\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    // 值恒是数组，单滑块即长度 1；缺席值 undefined 表示非受控\n    value: { type: Array as PropType<number[]> },\n    defaultValue: { type: Array as PropType<number[]> },\n    min: { type: Number },\n    max: { type: Number },\n    step: { type: Number },\n    largeStep: { type: Number },\n    minStepsBetweenThumbs: { type: Number },\n    marks: { type: Array as PropType<SliderMark[]> },\n    snapToMarks: { type: Boolean, default: undefined },\n    inverted: { type: Boolean, default: undefined },\n    draggableRange: { type: Boolean, default: undefined },\n    trackFill: { type: Boolean, default: undefined },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\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    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    name: { type: String },\n    getValueText: {\n      type: Function as PropType<(details: SliderValueTextDetails) => string>,\n    },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组；value-change-end 只在操作收尾时发一次\n  emits: {\n    'value-change': (_details: PayloadOf<SliderProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SliderProps, 'onValueChange'>['value']) => true,\n    'value-change-end': (_details: PayloadOf<SliderProps, 'onValueChangeEnd'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: SliderRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: SliderProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyEnd: SliderProps['onValueChangeEnd'] = (details) => {\n      emit('value-change-end', details)\n    }\n    const ctx = useSlider(useFormControlProps(props) as SliderProps, notify, notifyEnd)\n    provideSlider(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            thumbs: api.thumbs,\n            range: api.range,\n            dragging: api.dragging,\n            setValue: api.setValue,\n            setThumbValue: api.setThumbValue,\n          })\n        : renderDefaultStructure(api, props.label, props.name !== undefined, slots.label))\n    }\n  },\n})\n\nexport const XhSliderLabel = defineComponent({\n  name: 'XhSliderLabel',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderControl = defineComponent({\n  name: 'XhSliderControl',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderTrack = defineComponent({\n  name: 'XhSliderTrack',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    // 轨道节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getTrackProps() as Record<string, unknown>,\n      ref: ctx.trackRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhSliderTickGroup = defineComponent({\n  name: 'XhSliderTickGroup',\n  slots: Object as SlotsType<{\n    tick?: (props: SliderTickGroupTickSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    // 刻度整组自动铺：圆点 + 文案（点文案跳值）；tick 插槽可换文案内容\n    return () => h('div', ctx.api.value.getTickGroupProps() as Record<string, unknown>, ctx.api.value.marks.flatMap(tick => [\n      h('span', { ...ctx.api.value.getTickProps({ value: tick.value }) as Record<string, unknown>, key: `dot-${tick.value}` }),\n      h(\n        'span',\n        { ...ctx.api.value.getTickLabelProps({ value: tick.value }) as Record<string, unknown>, key: `label-${tick.value}` },\n        slots.tick ? slots.tick({ tick }) : tick.label,\n      ),\n    ]))\n  },\n})\n\nexport const XhSliderRange = defineComponent({\n  name: 'XhSliderRange',\n  setup(_, { slots }) {\n    const ctx = useSliderContext()\n    return () => h('div', ctx.api.value.getRangeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhSliderThumb = defineComponent({\n  name: 'XhSliderThumb',\n  props: {\n    /** 第几个滑块，多滑块时必须逐个写明（`:index=\"i\"`）；兼收字符串。 */\n    index: { type: [Number, String] as PropType<number | string>, default: 0 },\n  },\n  setup(props, { slots }) {\n    const ctx = useSliderContext()\n    const index = computed(() => normalizeItemIndex(props.index))\n    provideSliderThumb({ index })\n    // 放进表单字段时，字段的标题与说明接到拇指上：焦点落在拇指，读屏在这里念名字与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getThumbProps(index.value) as Record<string, unknown> }), slots.default?.())\n  },\n})\n\nexport const XhSliderValueText = defineComponent({\n  name: 'XhSliderValueText',\n  setup(_, { slots }) {\n    const { index } = useSliderThumbContext()\n    const ctx = useSliderContext()\n    // 值气泡：写在拇指里，没给内容就填这一个拇指的值文本\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps(index.value) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.valueText(index.value),\n    )\n  },\n})\n\nexport const XhSliderHiddenInput = defineComponent({\n  name: 'XhSliderHiddenInput',\n  setup() {\n    const { index } = useSliderThumbContext()\n    const ctx = useSliderContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps(index.value) as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件；刻度的圆点与文案由 XhSliderTickGroup 自己铺。 */\nconst SLIDER_PARTS = {\n  'label': XhSliderLabel,\n  'control': XhSliderControl,\n  'track': XhSliderTrack,\n  'range': XhSliderRange,\n  'tick-group': XhSliderTickGroup,\n  'thumb': XhSliderThumb,\n  'hidden-input': XhSliderHiddenInput,\n}\n\n/** 刻度组自己按 marks 铺圆点与文案，铺结构时去掉这两格。 */\nfunction withoutSelfAssembled(nodes: readonly StructureChild[]): StructureChild[] {\n  return nodes.flatMap((node): StructureChild[] => {\n    if (!('part' in node))\n      return [node]\n    if (node.part === 'tick' || node.part === 'tick-label')\n      return []\n    return [node.children ? { ...node, children: withoutSelfAssembled(node.children) } : node]\n  })\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 sliderStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: SliderApi, label: string | undefined, hiddenInput: boolean, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = sliderStructure(api, { label, hiddenInput, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(withoutSelfAssembled(nodes), SLIDER_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,13 @@
+import { SliderApi, SliderSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SliderApi, SliderSchema } from "@xihan-ui/headless";
 //#region src/components/slider/use-slider.d.ts
 interface SliderContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhSliderLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<SliderApi>;
   service: Service<SliderSchema>;
   /** 轨道节点，状态机在指针事件中读取它的矩形。 */

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

@@ -1 +1 @@
-{"version":3,"file":"use-slider.d.ts","names":[],"sources":["../../../src/components/slider/use-slider.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;iBAGA,UACd,OAAO,uBACP,gBAAgB,wCAChB,mBAAmB,4CAClB"}
+{"version":3,"file":"use-slider.d.ts","names":[],"sources":["../../../src/components/slider/use-slider.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;iBAGA,UACd,OAAO,uBACP,gBAAgB,wCAChB,mBAAmB,4CAClB"}

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

@@ -1,19 +1,23 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectSlider, sliderMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectSlider, sliderMachine } from "@xihan-ui/headless";
 //#region src/components/slider/use-slider.ts
 function useSlider(props, onValueChange, onValueChangeEnd) {
 	const trackRef = ref(null);
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(sliderMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange,
 		onValueChangeEnd
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	service.refs.set("getTrackEl", () => trackRef.value);
 	return {
+		labelCount,
 		api: computed(() => connectSlider(service, vueNormalize)),
 		service,
 		trackRef