@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/tags-input/use-tags-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tags-input.d.ts","names":[],"sources":["../../../src/components/tags-input/use-tags-input.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,YAAY,IAAI;;iBAGF,aACd,OAAO,0BACP,WAAU,KAAK,oFACd"}
+{"version":3,"file":"use-tags-input.d.ts","names":[],"sources":["../../../src/components/tags-input/use-tags-input.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,YAAY,IAAI;;iBAGF,aACd,OAAO,0BACP,WAAU,KAAK,oFACd"}

package/dist/components/tags-input/use-tags-input.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 { connectTagsInput, tagsInputMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectTagsInput, tagsInputMachine } from "@xihan-ui/headless";
 //#region src/components/tags-input/use-tags-input.ts
 function useTagsInput(props, handlers = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(tagsInputMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	const controlRef = ref(null);
 	service.refs.set("getControlEl", () => controlRef.value);
 	return {
+		labelCount,
 		api: computed(() => connectTagsInput(service, vueNormalize)),
 		service,
 		controlRef

package/dist/components/tags-input/use-tags-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-tags-input.js","names":[],"sources":["../../../src/components/tags-input/use-tags-input.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 tags input 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TagsInputApi, TagsInputSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagsInput, tagsInputMachine } 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 TagsInputContext {\n  api: ComputedRef<TagsInputApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签节点带着焦点离场）。 */\n  service: Service<TagsInputSchema>\n  /** 标签所在的容器：列表动效接在它上面。 */\n  controlRef: Ref<HTMLElement | null>\n}\n\nexport function useTagsInput(\n  props: TagsInputSchema['props'],\n  handlers: Pick<TagsInputSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onTagReject'> = {},\n): TagsInputContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(tagsInputMachine, () => ({ ...props, ...handlers }), scope)\n  const controlRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getControlEl', () => controlRef.value)\n  const api = computed(() => connectTagsInput(service, vueNormalize))\n  return { api, service, controlRef }\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,aACd,OACA,WAAmG,CAAC,GAClF;CAIlB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,GAAG;CAAS,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CACrF,MAAM,aAAa,IAAwB,IAAI;CAE/C,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAEvD,OAAO;EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD;EAAG;EAAS;CAAW;AACpC"}
+{"version":3,"file":"use-tags-input.js","names":[],"sources":["../../../src/components/tags-input/use-tags-input.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 tags input 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TagsInputApi, TagsInputSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagsInput, tagsInputMachine } 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 TagsInputContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTagsInputLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TagsInputApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签节点带着焦点离场）。 */\n  service: Service<TagsInputSchema>\n  /** 标签所在的容器：列表动效接在它上面。 */\n  controlRef: Ref<HTMLElement | null>\n}\n\nexport function useTagsInput(\n  props: TagsInputSchema['props'],\n  handlers: Pick<TagsInputSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onTagReject'> = {},\n): TagsInputContext {\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(tagsInputMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n  const controlRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getControlEl', () => controlRef.value)\n  const api = computed(() => connectTagsInput(service, vueNormalize))\n  return { labelCount, api, service, controlRef }\n}\n"],"mappings":";;;;;;;AA8BA,SAAgB,aACd,OACA,WAAmG,CAAC,GAClF;CAGlB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CACrH,MAAM,aAAa,IAAwB,IAAI;CAE/C,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAEvD,OAAO;EAAE;EAAY,KADT,eAAe,iBAAiB,SAAS,YAAY,CAC1C;EAAG;EAAS;CAAW;AAChD"}

package/dist/components/text-field/text-field.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TextFieldApi, TextFieldInputHost, TextFieldSchema, TextFieldType } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { TextFieldApi, TextFieldInputHost, TextFieldSchema, TextFieldType } from "@xihan-ui/headless";
 //#region src/components/text-field/text-field.d.ts
 type TextFieldProps = TextFieldSchema['props'];
 /** 默认插槽的载荷：当前值、值状态标志与写值方法。 */
@@ -9,6 +9,16 @@ type TextFieldRootSlotProps = Pick<TextFieldApi, 'value' | 'empty' | 'atLimit' |
 /** 字数部件默认插槽的载荷：当前字数、上限与已达上限的标志。 */
 type TextFieldCountSlotProps = Pick<TextFieldApi, 'count' | 'maxLength' | 'atLimit'>;
 declare const XhTextFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时输入框铺 textarea（多行，接入 autoSize 自动高度）；手写部件时由 XhTextFieldInput 的 as 决定。 */
+  multiline: BooleanConstructor;
   value: {
     type: StringConstructor;
   };
@@ -68,6 +78,16 @@ declare const XhTextFieldRoot: import("vue").DefineComponent<import("vue").Extra
   'value-change': (_details: PayloadOf<TextFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<TextFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时输入框铺 textarea（多行，接入 autoSize 自动高度）；手写部件时由 XhTextFieldInput 的 as 决定。 */
+  multiline: BooleanConstructor;
   value: {
     type: StringConstructor;
   };
@@ -130,10 +150,12 @@ declare const XhTextFieldRoot: import("vue").DefineComponent<import("vue").Extra
   disabled: boolean;
   readOnly: boolean;
   clearable: boolean;
-  showCount: boolean;
+  multiline: boolean;
   autoSize: boolean | import("@xihan-ui/headless").TextFieldAutoSize | undefined;
+  showCount: boolean;
 }, SlotsType<{
   default?: (props: TextFieldRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTextFieldLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/text-field/text-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-field.d.ts","names":[],"sources":["../../../src/components/text-field/text-field.ts"],"mappings":";;;;;KAoBK,iBAAiB;;KAGV,yBAAyB,KACnC;;KAKU,0BAA0B,KAAK;cAE9B,+BAAe,8BAAA;;;;;;;;IAMA,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWM,MAAA,SAAS;;;;IACrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;EAKd,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;IArBX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWM,MAAA,SAAS;;;;IACrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,2BAA2B;kCAmB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAIH,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAkCjC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;;EAGf,WAAC,OAAO,4BAA4B;kCAchD"}
+{"version":3,"file":"text-field.d.ts","names":[],"sources":["../../../src/components/text-field/text-field.ts"],"mappings":";;;;;KAqBK,iBAAiB;;KAGV,yBAAyB,KACnC;;KAKU,0BAA0B,KAAK;cAE9B,+BAAe,8BAAA;;;;;;;;;;;;;;;;;;IAYA,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWM,MAAA,SAAS;;;;IACrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;EAKd,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;IArBX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWM,MAAA,SAAS;;;;IACrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,2BAA2B;EACrC,cAAM;kCAwBhB;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAIH,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAkCjC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;;EAGf,WAAC,OAAO,4BAA4B;kCAchD"}

package/dist/components/text-field/text-field.js

@@ -1,15 +1,22 @@
+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 { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideTextField, useTextFieldContext } from "./context.js";
 import { useTextField } from "./use-text-field.js";
-import { defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from "vue";
-import { autoSizeTextarea } from "@xihan-ui/headless";
+import { autoSizeTextarea, textFieldStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onBeforeUnmount, onMounted, onUnmounted, onUpdated, ref } from "vue";
 //#region src/components/text-field/text-field.ts
 const XhTextFieldRoot = defineComponent({
 	name: "XhTextFieldRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不写默认插槽时输入框铺 textarea（多行，接入 autoSize 自动高度）；手写部件时由 XhTextFieldInput 的 as 决定。 */
+		multiline: Boolean,
 		value: { type: String },
 		defaultValue: { type: String },
 		type: { type: String },
@@ -56,21 +63,31 @@ const XhTextFieldRoot = defineComponent({
 		};
 		const ctx = useTextField(withHandlers(withXhConfig("text-field", useFormControlProps(props)), { onClear: () => emit("clear") }), notify);
 		provideTextField(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			empty: ctx.api.value.empty,
-			atLimit: ctx.api.value.atLimit,
-			count: ctx.api.value.count,
-			canClear: ctx.api.value.canClear,
-			setValue: ctx.api.value.setValue,
-			clear: ctx.api.value.clear
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				empty: api.empty,
+				atLimit: api.atLimit,
+				count: api.count,
+				canClear: api.canClear,
+				setValue: api.setValue,
+				clear: api.clear
+			}) : renderDefaultStructure(api, {
+				label: props.label,
+				multiline: props.multiline
+			}, slots.label));
+		};
 	}
 });
 const XhTextFieldLabel = defineComponent({
 	name: "XhTextFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useTextFieldContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -153,6 +170,38 @@ const XhTextFieldCount = defineComponent({
 		};
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const TEXT_FIELD_PARTS = {
+	"label": XhTextFieldLabel,
+	"control": XhTextFieldControl,
+	"input": XhTextFieldInput,
+	"clear-trigger": XhTextFieldClearTrigger,
+	"count": XhTextFieldCount
+};
+/** 多行时标准结构里的输入框：XhTextFieldInput 以 textarea 渲染。 */
+const XhTextFieldTextarea = defineComponent({
+	name: "XhTextFieldTextarea",
+	inheritAttrs: false,
+	setup(_, { attrs, slots }) {
+		return () => h(XhTextFieldInput, {
+			...attrs,
+			as: "textarea"
+		}, slots);
+	}
+});
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 textFieldStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, options, labelSlot) {
+	return renderStructure(textFieldStructure(api, {
+		...options,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), options.multiline ? {
+		...TEXT_FIELD_PARTS,
+		input: XhTextFieldTextarea
+	} : TEXT_FIELD_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhTextFieldClearTrigger, XhTextFieldControl, XhTextFieldCount, XhTextFieldInput, XhTextFieldLabel, XhTextFieldPrefix, XhTextFieldRoot, XhTextFieldSuffix };
 

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

@@ -1 +1 @@
-{"version":3,"file":"text-field.js","names":[],"sources":["../../../src/components/text-field/text-field.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// 提供 text field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TextFieldApi, TextFieldInputHost, TextFieldSchema, TextFieldType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { autoSizeTextarea } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTextField, useTextFieldContext } from './context'\nimport { useTextField } from './use-text-field'\n\ntype TextFieldProps = TextFieldSchema['props']\n\n/** 默认插槽的载荷：当前值、值状态标志与写值方法。 */\nexport type TextFieldRootSlotProps = Pick<\n  TextFieldApi,\n  'value' | 'empty' | 'atLimit' | 'count' | 'canClear' | 'setValue' | 'clear'\n>\n\n/** 字数部件默认插槽的载荷：当前字数、上限与已达上限的标志。 */\nexport type TextFieldCountSlotProps = Pick<TextFieldApi, 'count' | 'maxLength' | 'atLimit'>\n\nexport const XhTextFieldRoot = defineComponent({\n  name: 'XhTextFieldRoot',\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    type: { type: String as PropType<TextFieldType> },\n    placeholder: { type: String },\n    // undefined 才表示「本实例没说」，Form/Field 才能安全地下传状态；false 是显式顶掉继承。\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    maxLength: { type: Number },\n    clearable: Boolean,\n    showCount: Boolean,\n    autoSize: { type: [Boolean, Object] as PropType<TextFieldProps['autoSize']>, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<TextFieldProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TextFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TextFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TextFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TextFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useTextField(withHandlers(withXhConfig('text-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as TextFieldProps, notify)\n    provideTextField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      atLimit: ctx.api.value.atLimit,\n      count: ctx.api.value.count,\n      canClear: ctx.api.value.canClear,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n    }))\n  },\n})\n\nexport const XhTextFieldLabel = defineComponent({\n  name: 'XhTextFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldControl = defineComponent({\n  name: 'XhTextFieldControl',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    // 视觉盒：输入框与清空按钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldInput = defineComponent({\n  name: 'XhTextFieldInput',\n  props: {\n    /** 输入框渲染为哪个标签，默认 input；写 textarea 即多行宿主，接入 autoSize 自动高度。 */\n    as: { type: String as PropType<TextFieldInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTextFieldContext()\n    const el = ref<HTMLTextAreaElement | null>(null)\n    const setInputRef = (node: unknown): void => {\n      const next = props.as === 'textarea' ? node as HTMLTextAreaElement | null : null\n      if (el.value && el.value !== next)\n        autoSizeTextarea(el.value, false)\n      el.value = next\n    }\n    const syncAutoSize = (): void => {\n      if (el.value)\n        autoSizeTextarea(el.value, ctx.api.value.autoSize)\n    }\n    // 模板 ref 赋值时节点尚未接入 Document；挂载及更新提交后再量，程序化写值与配置变化也走这条。\n    onMounted(syncAutoSize)\n    onUpdated(syncAutoSize)\n    onBeforeUnmount(() => {\n      if (el.value)\n        autoSizeTextarea(el.value, false)\n      el.value = null\n    })\n    // 自己渲染宿主节点，label 的 for 指向它\n    return () => h(props.as, fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: setInputRef,\n    }))\n  },\n})\n\nexport const XhTextFieldPrefix = defineComponent({\n  name: 'XhTextFieldPrefix',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('span', ctx.api.value.getPrefixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldSuffix = defineComponent({\n  name: 'XhTextFieldSuffix',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('span', ctx.api.value.getSuffixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldClearTrigger = defineComponent({\n  name: 'XhTextFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 字数：未写内容时渲染 `已用 / 上限`，未设上限时只渲染已用。 */\nexport const XhTextFieldCount = defineComponent({\n  name: 'XhTextFieldCount',\n  slots: Object as SlotsType<{\n    default?: (props: TextFieldCountSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => {\n      const api = ctx.api.value\n      const fallback = api.maxLength === undefined ? `${api.count}` : `${api.count} / ${api.maxLength}`\n      return h(\n        'span',\n        api.getCountProps() as Record<string, unknown>,\n        slots.default?.({ count: api.count, maxLength: api.maxLength, atLimit: api.atLimit }) ?? fallback,\n      )\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"text-field.js","names":[],"sources":["../../../src/components/text-field/text-field.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// 提供 text field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TextFieldApi, TextFieldInputHost, TextFieldSchema, TextFieldType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { autoSizeTextarea, textFieldStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, onMounted, onUnmounted, onUpdated, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTextField, useTextFieldContext } from './context'\nimport { useTextField } from './use-text-field'\n\ntype TextFieldProps = TextFieldSchema['props']\n\n/** 默认插槽的载荷：当前值、值状态标志与写值方法。 */\nexport type TextFieldRootSlotProps = Pick<\n  TextFieldApi,\n  'value' | 'empty' | 'atLimit' | 'count' | 'canClear' | 'setValue' | 'clear'\n>\n\n/** 字数部件默认插槽的载荷：当前字数、上限与已达上限的标志。 */\nexport type TextFieldCountSlotProps = Pick<TextFieldApi, 'count' | 'maxLength' | 'atLimit'>\n\nexport const XhTextFieldRoot = defineComponent({\n  name: 'XhTextFieldRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不写默认插槽时输入框铺 textarea（多行，接入 autoSize 自动高度）；手写部件时由 XhTextFieldInput 的 as 决定。 */\n    multiline: Boolean,\n    // 缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    type: { type: String as PropType<TextFieldType> },\n    placeholder: { type: String },\n    // undefined 才表示「本实例没说」，Form/Field 才能安全地下传状态；false 是显式顶掉继承。\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    maxLength: { type: Number },\n    clearable: Boolean,\n    showCount: Boolean,\n    autoSize: { type: [Boolean, Object] as PropType<TextFieldProps['autoSize']>, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<TextFieldProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TextFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TextFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TextFieldRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TextFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useTextField(withHandlers(withXhConfig('text-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as TextFieldProps, notify)\n    provideTextField(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            empty: api.empty,\n            atLimit: api.atLimit,\n            count: api.count,\n            canClear: api.canClear,\n            setValue: api.setValue,\n            clear: api.clear,\n          })\n        : renderDefaultStructure(api, { label: props.label, multiline: props.multiline }, slots.label))\n    }\n  },\n})\n\nexport const XhTextFieldLabel = defineComponent({\n  name: 'XhTextFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldControl = defineComponent({\n  name: 'XhTextFieldControl',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    // 视觉盒：输入框与清空按钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldInput = defineComponent({\n  name: 'XhTextFieldInput',\n  props: {\n    /** 输入框渲染为哪个标签，默认 input；写 textarea 即多行宿主，接入 autoSize 自动高度。 */\n    as: { type: String as PropType<TextFieldInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTextFieldContext()\n    const el = ref<HTMLTextAreaElement | null>(null)\n    const setInputRef = (node: unknown): void => {\n      const next = props.as === 'textarea' ? node as HTMLTextAreaElement | null : null\n      if (el.value && el.value !== next)\n        autoSizeTextarea(el.value, false)\n      el.value = next\n    }\n    const syncAutoSize = (): void => {\n      if (el.value)\n        autoSizeTextarea(el.value, ctx.api.value.autoSize)\n    }\n    // 模板 ref 赋值时节点尚未接入 Document；挂载及更新提交后再量，程序化写值与配置变化也走这条。\n    onMounted(syncAutoSize)\n    onUpdated(syncAutoSize)\n    onBeforeUnmount(() => {\n      if (el.value)\n        autoSizeTextarea(el.value, false)\n      el.value = null\n    })\n    // 自己渲染宿主节点，label 的 for 指向它\n    return () => h(props.as, fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: setInputRef,\n    }))\n  },\n})\n\nexport const XhTextFieldPrefix = defineComponent({\n  name: 'XhTextFieldPrefix',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('span', ctx.api.value.getPrefixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldSuffix = defineComponent({\n  name: 'XhTextFieldSuffix',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('span', ctx.api.value.getSuffixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTextFieldClearTrigger = defineComponent({\n  name: 'XhTextFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 字数：未写内容时渲染 `已用 / 上限`，未设上限时只渲染已用。 */\nexport const XhTextFieldCount = defineComponent({\n  name: 'XhTextFieldCount',\n  slots: Object as SlotsType<{\n    default?: (props: TextFieldCountSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useTextFieldContext()\n    return () => {\n      const api = ctx.api.value\n      const fallback = api.maxLength === undefined ? `${api.count}` : `${api.count} / ${api.maxLength}`\n      return h(\n        'span',\n        api.getCountProps() as Record<string, unknown>,\n        slots.default?.({ count: api.count, maxLength: api.maxLength, atLimit: api.atLimit }) ?? fallback,\n      )\n    }\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst TEXT_FIELD_PARTS = {\n  'label': XhTextFieldLabel,\n  'control': XhTextFieldControl,\n  'input': XhTextFieldInput,\n  'clear-trigger': XhTextFieldClearTrigger,\n  'count': XhTextFieldCount,\n}\n\n/** 多行时标准结构里的输入框：XhTextFieldInput 以 textarea 渲染。 */\nconst XhTextFieldTextarea = defineComponent({\n  name: 'XhTextFieldTextarea',\n  inheritAttrs: false,\n  setup(_, { attrs, slots }) {\n    return () => h(XhTextFieldInput, { ...attrs, as: 'textarea' }, slots)\n  },\n})\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 textFieldStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: TextFieldApi, options: { label?: string, multiline: boolean }, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = textFieldStructure(api, { ...options, slotted: name => name === 'label' && labelSlot != null })\n  const parts = options.multiline ? { ...TEXT_FIELD_PARTS, input: XhTextFieldTextarea } : TEXT_FIELD_PARTS\n  return renderStructure(nodes, parts, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/text-field/use-text-field.d.ts

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { TextFieldApi, TextFieldSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/text-field/use-text-field.d.ts
 interface TextFieldContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhTextFieldLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<TextFieldApi>;
 }
 declare function useTextField(props: TextFieldSchema['props'], onValueChange?: TextFieldSchema['props']['onValueChange']): TextFieldContext;

package/dist/components/text-field/use-text-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-text-field.d.ts","names":[],"sources":["../../../src/components/text-field/use-text-field.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,gBAAgB,4CACf"}
+{"version":3,"file":"use-text-field.d.ts","names":[],"sources":["../../../src/components/text-field/use-text-field.ts"],"mappings":";;;UAciB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,gBAAgB,4CACf"}

package/dist/components/text-field/use-text-field.js

@@ -1,14 +1,19 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { connectTextField, textFieldMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/text-field/use-text-field.ts
 function useTextField(props, onValueChange) {
+	const labelCount = ref(0);
 	const service = useMachine(textFieldMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange
 	}));
-	return { api: computed(() => connectTextField(service, vueNormalize)) };
+	return {
+		labelCount,
+		api: computed(() => connectTextField(service, vueNormalize))
+	};
 }
 //#endregion
 export { useTextField };

package/dist/components/text-field/use-text-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-text-field.js","names":[],"sources":["../../../src/components/text-field/use-text-field.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 text field 相关实现。\n\nimport type { TextFieldApi, TextFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectTextField, textFieldMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TextFieldContext {\n  api: ComputedRef<TextFieldApi>\n}\n\nexport function useTextField(\n  props: TextFieldSchema['props'],\n  onValueChange?: TextFieldSchema['props']['onValueChange'],\n): TextFieldContext {\n  const service = useMachine(textFieldMachine, () => ({ ...props, onValueChange }))\n  const api = computed(() => connectTextField(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAkBA,SAAgB,aACd,OACA,eACkB;CAClB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO;CAAc,EAAE;CAEhF,OAAO,EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD,EAAE;AACf"}
+{"version":3,"file":"use-text-field.js","names":[],"sources":["../../../src/components/text-field/use-text-field.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 text field 相关实现。\n\nimport type { TextFieldApi, TextFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectTextField, textFieldMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TextFieldContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTextFieldLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TextFieldApi>\n}\n\nexport function useTextField(\n  props: TextFieldSchema['props'],\n  onValueChange?: TextFieldSchema['props']['onValueChange'],\n): TextFieldContext {\n  const labelCount = ref(0)\n  const service = useMachine(textFieldMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange }))\n  const api = computed(() => connectTextField(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;AAuBA,SAAgB,aACd,OACA,eACkB;CAClB,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;CAAc,EAAE;CAEhH,OAAO;EAAE;EAAY,KADT,eAAe,iBAAiB,SAAS,YAAY,CAC1C;CAAE;AAC3B"}

package/dist/components/time-field/time-field.d.ts

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TimeFieldApi, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimeSegmentType } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { TimeFieldApi, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimeSegmentType } from "@xihan-ui/headless";
 //#region src/components/time-field/time-field.d.ts
 type TimeFieldProps = TimeFieldSchema['props'];
 /** 默认插槽的载荷：当前值、值状态标志、参与显示的段与写值方法。 */
 type TimeFieldRootSlotProps = Pick<TimeFieldApi, 'value' | 'empty' | 'outOfRange' | 'canClear' | 'segments' | 'focusedSegment' | 'hourCycle' | 'granularity' | 'setValue' | 'clear'>;
 declare const XhTimeFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -69,6 +73,10 @@ declare const XhTimeFieldRoot: import("vue").DefineComponent<import("vue").Extra
   'value-change': (_details: PayloadOf<TimeFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<TimeFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };

package/dist/components/time-field/time-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-field.d.ts","names":[],"sources":["../../../src/components/time-field/time-field.ts"],"mappings":";;;;;KAkBK,iBAAiB;;KAGV,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;;;;;;;;;;;;;;;;IAUK,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAER,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;IAjBN,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAER,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAWtC,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"time-field.d.ts","names":[],"sources":["../../../src/components/time-field/time-field.ts"],"mappings":";;;;;KAkBK,iBAAiB;;KAGV,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;;;;;;;;;;;;;;;;;;;;IAYK,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAER,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;IAjBN,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAER,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAWtC,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/time-field/time-field.js

@@ -3,11 +3,13 @@ import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { provideTimeField, useTimeFieldContext } from "./context.js";
 import { useTimeField } from "./use-time-field.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/time-field/time-field.ts
 const XhTimeFieldRoot = defineComponent({
 	name: "XhTimeFieldRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		value: { type: String },
 		defaultValue: { type: String },
 		min: { type: String },
@@ -69,6 +71,10 @@ const XhTimeFieldLabel = defineComponent({
 	name: "XhTimeFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useTimeFieldContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });

package/dist/components/time-field/time-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-field.js","names":[],"sources":["../../../src/components/time-field/time-field.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// 提供 time field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TimeFieldApi, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimeSegmentType } 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 { provideTimeField, useTimeFieldContext } from './context'\nimport { useTimeField } from './use-time-field'\n\ntype TimeFieldProps = TimeFieldSchema['props']\n\n/** 默认插槽的载荷：当前值、值状态标志、参与显示的段与写值方法。 */\nexport type TimeFieldRootSlotProps = Pick<\n  TimeFieldApi,\n  'value' | 'empty' | 'outOfRange' | 'canClear' | 'segments' | 'focusedSegment' | 'hourCycle' | 'granularity' | 'setValue' | 'clear'\n>\n\nexport const XhTimeFieldRoot = defineComponent({\n  name: 'XhTimeFieldRoot',\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    hourCycle: { type: Number as PropType<TimeHourCycle> },\n    granularity: { type: String as PropType<TimeGranularity> },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TimeFieldProps['translations']> },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    placeholder: { type: String },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TimeFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TimeFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimeFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: TimeFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useTimeField(withHandlers(withXhConfig('time-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as TimeFieldProps, { onValueChange })\n    provideTimeField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      canClear: ctx.api.value.canClear,\n      segments: ctx.api.value.segments,\n      focusedSegment: ctx.api.value.focusedSegment,\n      hourCycle: ctx.api.value.hourCycle,\n      granularity: ctx.api.value.granularity,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n    }))\n  },\n})\n\nexport const XhTimeFieldLabel = defineComponent({\n  name: 'XhTimeFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 仍用原生 label 保持表单语义，点标题聚焦第一段由连接层的 click 接管\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldControl = defineComponent({\n  name: 'XhTimeFieldControl',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldSegmentGroup = defineComponent({\n  name: 'XhTimeFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldSegment = defineComponent({\n  name: 'XhTimeFieldSegment',\n  props: {\n    // 段的身份由作者声明\n    segment: { type: String as PropType<TimeSegmentType>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 有插槽用插槽，否则显示该段的文字，空段为占位串\n    return () => h(\n      'span',\n      ctx.api.value.getSegmentProps({ segment: props.segment }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getSegmentText({ segment: props.segment }),\n    )\n  },\n})\n\nexport const XhTimeFieldClearTrigger = defineComponent({\n  name: 'XhTimeFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 没写内容时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldHiddenInput = defineComponent({\n  name: 'XhTimeFieldHiddenInput',\n  setup() {\n    const ctx = useTimeFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"time-field.js","names":[],"sources":["../../../src/components/time-field/time-field.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// 提供 time field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TimeFieldApi, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimeSegmentType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTimeField, useTimeFieldContext } from './context'\nimport { useTimeField } from './use-time-field'\n\ntype TimeFieldProps = TimeFieldSchema['props']\n\n/** 默认插槽的载荷：当前值、值状态标志、参与显示的段与写值方法。 */\nexport type TimeFieldRootSlotProps = Pick<\n  TimeFieldApi,\n  'value' | 'empty' | 'outOfRange' | 'canClear' | 'segments' | 'focusedSegment' | 'hourCycle' | 'granularity' | 'setValue' | 'clear'\n>\n\nexport const XhTimeFieldRoot = defineComponent({\n  name: 'XhTimeFieldRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    hourCycle: { type: Number as PropType<TimeHourCycle> },\n    granularity: { type: String as PropType<TimeGranularity> },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TimeFieldProps['translations']> },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    placeholder: { type: String },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TimeFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TimeFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimeFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: TimeFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useTimeField(withHandlers(withXhConfig('time-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as TimeFieldProps, { onValueChange })\n    provideTimeField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      canClear: ctx.api.value.canClear,\n      segments: ctx.api.value.segments,\n      focusedSegment: ctx.api.value.focusedSegment,\n      hourCycle: ctx.api.value.hourCycle,\n      granularity: ctx.api.value.granularity,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n    }))\n  },\n})\n\nexport const XhTimeFieldLabel = defineComponent({\n  name: 'XhTimeFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 仍用原生 label 保持表单语义，点标题聚焦第一段由连接层的 click 接管\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldControl = defineComponent({\n  name: 'XhTimeFieldControl',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldSegmentGroup = defineComponent({\n  name: 'XhTimeFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldSegment = defineComponent({\n  name: 'XhTimeFieldSegment',\n  props: {\n    // 段的身份由作者声明\n    segment: { type: String as PropType<TimeSegmentType>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 有插槽用插槽，否则显示该段的文字，空段为占位串\n    return () => h(\n      'span',\n      ctx.api.value.getSegmentProps({ segment: props.segment }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getSegmentText({ segment: props.segment }),\n    )\n  },\n})\n\nexport const XhTimeFieldClearTrigger = defineComponent({\n  name: 'XhTimeFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimeFieldContext()\n    // 没写内容时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimeFieldHiddenInput = defineComponent({\n  name: 'XhTimeFieldHiddenInput',\n  setup() {\n    const ctx = useTimeFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

package/dist/components/time-field/use-time-field.d.ts

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { TimeFieldApi, TimeFieldSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/time-field/use-time-field.d.ts
 interface TimeFieldContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhTimeFieldLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<TimeFieldApi>;
 }
 declare function useTimeField(props: TimeFieldSchema['props'], handlers?: Pick<TimeFieldSchema['props'], 'onValueChange'>): TimeFieldContext;

package/dist/components/time-field/use-time-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-time-field.d.ts","names":[],"sources":["../../../src/components/time-field/use-time-field.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,WAAU,KAAK,6CACd"}
+{"version":3,"file":"use-time-field.d.ts","names":[],"sources":["../../../src/components/time-field/use-time-field.ts"],"mappings":";;;UAgBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,WAAU,KAAK,6CACd"}

package/dist/components/time-field/use-time-field.js

@@ -1,16 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectTimeField, timeFieldMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/time-field/use-time-field.ts
 function useTimeField(props, handlers = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(timeFieldMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
-	}), createScope(null, createVueIdGenerator()));
-	return { api: computed(() => connectTimeField(service, vueNormalize)) };
+	}), scope);
+	return {
+		labelCount,
+		api: computed(() => connectTimeField(service, vueNormalize))
+	};
 }
 //#endregion
 export { useTimeField };

package/dist/components/time-field/use-time-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-time-field.js","names":[],"sources":["../../../src/components/time-field/use-time-field.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 time field 相关实现。\n\nimport type { TimeFieldApi, TimeFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTimeField, timeFieldMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface TimeFieldContext {\n  api: ComputedRef<TimeFieldApi>\n}\n\nexport function useTimeField(\n  props: TimeFieldSchema['props'],\n  handlers: Pick<TimeFieldSchema['props'], 'onValueChange'> = {},\n): TimeFieldContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(timeFieldMachine, () => ({ ...props, ...handlers }), scope)\n  const api = computed(() => connectTimeField(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAoBA,SAAgB,aACd,OACA,WAA4D,CAAC,GAC3C;CAIlB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,GAAG;CAAS,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CAErF,OAAO,EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD,EAAE;AACf"}
+{"version":3,"file":"use-time-field.js","names":[],"sources":["../../../src/components/time-field/use-time-field.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 time field 相关实现。\n\nimport type { TimeFieldApi, TimeFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTimeField, timeFieldMachine } 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 TimeFieldContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTimeFieldLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TimeFieldApi>\n}\n\nexport function useTimeField(\n  props: TimeFieldSchema['props'],\n  handlers: Pick<TimeFieldSchema['props'], 'onValueChange'> = {},\n): TimeFieldContext {\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(timeFieldMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n  const api = computed(() => connectTimeField(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,aACd,OACA,WAA4D,CAAC,GAC3C;CAGlB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAErH,OAAO;EAAE;EAAY,KADT,eAAe,iBAAiB,SAAS,YAAY,CAC1C;CAAE;AAC3B"}

package/dist/components/time-picker/time-picker.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TimeGranularity, TimeHourCycle, TimePickerApi, TimePickerColumn, TimePickerColumnUnit, TimePickerPreset, TimePickerPresetState, TimePickerSchema, TimePickerSelectionMode, TimeSegmentType, TimeStep, TimeUnavailablePredicate } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { TimeGranularity, TimeHourCycle, TimePickerApi, TimePickerColumn, TimePickerColumnUnit, TimePickerPreset, TimePickerPresetState, TimePickerSchema, TimePickerSelectionMode, TimeSegmentType, TimeStep, TimeUnavailablePredicate } from "@xihan-ui/headless";
 //#region src/components/time-picker/time-picker.d.ts
 type TimePickerProps = TimePickerSchema['props'];
 /** 默认插槽的载荷：浮层开合与当前值、值状态标志、当前的段与列，以及开合、写值、清空的动作。 */
@@ -15,6 +15,14 @@ interface TimePickerPresetsSlotProps {
   presets: readonly TimePickerPresetState[];
 }
 declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   /** 选中的时刻，ISO 时间串数组；单选可写裸串。 */
   value: {
     type: PropType<string | string[]>;
@@ -88,6 +96,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   name: {
     type: StringConstructor;
   };
+  placeholder: {
+    type: StringConstructor;
+  };
   variant: {
     type: PropType<ControlVariant>;
   };
@@ -116,6 +127,14 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   'update:value': (_value: PayloadOf<TimePickerProps, "onValueChange">["value"]) => true;
   'update:open': (_open: PayloadOf<TimePickerProps, "onOpenChange">["open"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   /** 选中的时刻，ISO 时间串数组；单选可写裸串。 */
   value: {
     type: PropType<string | string[]>;
@@ -189,6 +208,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   name: {
     type: StringConstructor;
   };
+  placeholder: {
+    type: StringConstructor;
+  };
   variant: {
     type: PropType<ControlVariant>;
   };
@@ -223,6 +245,8 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   readOnly: boolean;
 }, SlotsType<{
   default?: (props: TimePickerRootSlotProps) => VNode[];
+  /** 不写默认插槽时标题的内容，盖过 label 文字。 */
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTimePickerLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/time-picker/time-picker.d.ts.map

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