@xihan-ui/vue 4.2.0 → 5.0.0

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

@@ -1,17 +1,23 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotIsPlainText, slotPaints } from "../../runtime/slot-content.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.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 { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideTimePicker, provideTimePickerColumn, provideTimePickerTag, useTimePickerColumnContext, useTimePickerContext, useTimePickerTagContext } from "./context.js";
 import { useTimePicker } from "./use-time-picker.js";
-import { computed, defineComponent, h, mergeProps, onUpdated, ref } from "vue";
+import { timePickerStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onUnmounted, onUpdated, ref } from "vue";
 //#region src/components/time-picker/time-picker.ts
 const XhTimePickerRoot = defineComponent({
 	name: "XhTimePickerRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
 		/** 选中的时刻，ISO 时间串数组；单选可写裸串。 */
 		value: { type: [String, Array] },
 		defaultValue: { type: [String, Array] },
@@ -55,6 +61,7 @@ const XhTimePickerRoot = defineComponent({
 			default: void 0
 		},
 		name: { type: String },
+		placeholder: { type: String },
 		variant: { type: String },
 		tone: { type: String },
 		size: { type: String },
@@ -85,7 +92,7 @@ const XhTimePickerRoot = defineComponent({
 			onOpenChange: notifyOpen
 		});
 		provideTimePicker(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", ctx.api.value.getRootProps(), !slots.default ? renderDefaultStructure(ctx.api.value, props.label, slots.label) : slots.default({
 			open: ctx.api.value.open,
 			value: ctx.api.value.value,
 			empty: ctx.api.value.empty,
@@ -105,6 +112,10 @@ const XhTimePickerLabel = defineComponent({
 	name: "XhTimePickerLabel",
 	setup(_, { slots }) {
 		const ctx = useTimePickerContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -200,7 +211,7 @@ const XhTimePickerSegment = defineComponent({
 const XhTimePickerTrigger = defineComponent({
 	name: "XhTimePickerTrigger",
 	setup(_, { slots }) {
-		const fieldWiring = useFieldStateWiring();
+		const fieldWiring = useFieldGroupWiring();
 		const fieldLabel = useFieldLabelWiring();
 		const ctx = useTimePickerContext();
 		return () => h("button", fieldLabel.value({
@@ -375,6 +386,39 @@ const XhTimePickerHiddenInput = defineComponent({
 		})) : h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 结构里的部件 → 部件组件；委派出去的部件按「组件名/部件名」查。 */
+const TIME_PICKER_PARTS = {
+	"label": XhTimePickerLabel,
+	"control": XhTimePickerControl,
+	"tag-list": XhTimePickerTagList,
+	"segment-group": XhTimePickerSegmentGroup,
+	"segment": XhTimePickerSegment,
+	"trigger": XhTimePickerTrigger,
+	"clear-trigger": XhTimePickerClearTrigger,
+	"positioner": XhTimePickerPositioner,
+	"content": XhTimePickerContent,
+	"preset-group": XhTimePickerPresetGroup,
+	"preset": XhTimePickerPreset,
+	"column": XhTimePickerColumn,
+	"item": XhTimePickerItem,
+	"footer": XhTimePickerFooter,
+	"confirm-trigger": XhTimePickerConfirmTrigger,
+	"hidden-input": XhTimePickerHiddenInput,
+	"tag/tag": XhTimePickerTag,
+	"tag/tag-label": XhTimePickerTagLabel,
+	"tag/item-delete-trigger": XhTimePickerItemDeleteTrigger,
+	"tag/overflow-tag": XhTimePickerOverflowTag
+};
+/**
+* 未写默认插槽时照 timePickerStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。
+* 标题文字由 label 给出，需要放置其他内容时由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, labelSlot) {
+	return renderStructure(timePickerStructure(api, {
+		label,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), TIME_PICKER_PARTS, (node) => node.slot?.name === "label" ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhTimePickerClearTrigger, XhTimePickerColumn, XhTimePickerConfirmTrigger, XhTimePickerContent, XhTimePickerControl, XhTimePickerFooter, XhTimePickerHiddenInput, XhTimePickerItem, XhTimePickerItemDeleteTrigger, XhTimePickerLabel, XhTimePickerOverflowTag, XhTimePickerPositioner, XhTimePickerPreset, XhTimePickerPresetGroup, XhTimePickerRoot, XhTimePickerSegment, XhTimePickerSegmentGroup, XhTimePickerTag, XhTimePickerTagLabel, XhTimePickerTagList, XhTimePickerTrigger };
 

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

@@ -1 +1 @@
-{"version":3,"file":"time-picker.js","names":[],"sources":["../../../src/components/time-picker/time-picker.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 picker 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type {\n  TimeGranularity,\n  TimeHourCycle,\n  TimePickerApi,\n  TimePickerColumn,\n  TimePickerColumnUnit,\n  TimePickerPreset,\n  TimePickerPresetState,\n  TimePickerSchema,\n  TimePickerSelectionMode,\n  TimeSegmentType,\n  TimeStep,\n  TimeUnavailablePredicate,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onUpdated, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText, slotPaints } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTimePicker,\n  provideTimePickerColumn,\n  provideTimePickerTag,\n  useTimePickerColumnContext,\n  useTimePickerContext,\n  useTimePickerTagContext,\n} from './context'\nimport { useTimePicker } from './use-time-picker'\n\ntype TimePickerProps = TimePickerSchema['props']\n\n/** 默认插槽的载荷：浮层开合与当前值、值状态标志、当前的段与列，以及开合、写值、清空的动作。 */\nexport type TimePickerRootSlotProps = Pick<\n  TimePickerApi,\n  | 'open'\n  | 'value'\n  | 'empty'\n  | 'outOfRange'\n  | 'segments'\n  | 'columns'\n  | 'canClear'\n  | 'canAdd'\n  | 'setOpen'\n  | 'setValue'\n  | 'clear'\n  | 'add'\n>\n\n/** 默认插槽的载荷：该列当前的可选值。 */\nexport interface TimePickerColumnSlotProps {\n  options: TimePickerColumn['options']\n}\n\n/** 快捷选项列默认插槽的载荷：逐条的投影，作者据此自行铺设条目。 */\nexport interface TimePickerPresetsSlotProps {\n  presets: readonly TimePickerPresetState[]\n}\n\nexport const XhTimePickerRoot = defineComponent({\n  name: 'XhTimePickerRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 选中的时刻，ISO 时间串数组；单选可写裸串。 */\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    /** 选择模式，默认 single；multiple 时列上拼草稿、按「添加」收进值，输入行里排成标签。 */\n    selectionMode: { type: String as PropType<TimePickerSelectionMode> },\n    /** multiple 下最多选几个时刻。 */\n    maxSelected: { type: Number },\n    /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */\n    maxTagCount: { type: Number },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    hourCycle: { type: Number as PropType<TimeHourCycle> },\n    granularity: { type: String as PropType<TimeGranularity> },\n    /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */\n    timeStep: { type: Object as PropType<TimeStep> },\n    /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */\n    presets: { type: Array as PropType<TimePickerPreset[]> },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TimePickerProps['translations']> },\n    /** 逐格可选性：时列按 24 小时制给值，第三个参数带已选的时与分。 */\n    isTimeUnavailable: { type: Function as PropType<TimeUnavailablePredicate> },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TimePickerProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<TimePickerProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<TimePickerProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<TimePickerProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimePickerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: TimePickerProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: TimePickerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTimePicker(withHandlers(withXhConfig('time-picker', useFormControlProps(props)), { onClear: () => emit('clear') }) as TimePickerProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n    })\n    provideTimePicker(ctx)\n\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      segments: ctx.api.value.segments,\n      columns: ctx.api.value.columns,\n      canClear: ctx.api.value.canClear,\n      canAdd: ctx.api.value.canAdd,\n      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      add: ctx.api.value.add,\n    }))\n  },\n})\n\nexport const XhTimePickerLabel = defineComponent({\n  name: 'XhTimePickerLabel',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    // 仍用原生 label 保持表单语义，点标题聚焦第一段由连接层的 click 接管\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerControl = defineComponent({\n  name: 'XhTimePickerControl',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getControlProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.controlRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）。 */\nexport const XhTimePickerTagLabel = defineComponent({\n  name: 'XhTimePickerTagLabel',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签内容：只有文字时替它包一层 label；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label。 */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhTimePickerTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhTimePickerTagLabel, null, () => content)] : content\n}\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的选中值，焦点不动。 */\nexport const XhTimePickerItemDeleteTrigger = defineComponent({\n  name: 'XhTimePickerItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    const tag = useTimePickerTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 多选时一个选中值一个标签，即库内 tag 的 root（data-scope=\"tag\"）。 */\nexport const XhTimePickerTag = defineComponent({\n  name: 'XhTimePickerTag',\n  props: {\n    /** 它代表哪个选中值。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    provideTimePickerTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhTimePickerOverflowTag = defineComponent({\n  name: 'XhTimePickerOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/**\n * 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。\n * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。\n */\nexport const XhTimePickerTagList = defineComponent({\n  name: 'XhTimePickerTagList',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : [\n          ...ctx.api.value.tags.map(tag => h(XhTimePickerTag, { key: tag.value, value: tag.value }, () => [\n            h(XhTimePickerTagLabel, null, () => tag.label),\n            h(XhTimePickerItemDeleteTrigger),\n          ])),\n          h(XhTimePickerOverflowTag),\n        ])\n  },\n})\n\nexport const XhTimePickerSegmentGroup = defineComponent({\n  name: 'XhTimePickerSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerSegment = defineComponent({\n  name: 'XhTimePickerSegment',\n  props: {\n    // 段的身份由作者声明\n    segment: { type: String as PropType<TimeSegmentType>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\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 XhTimePickerTrigger = defineComponent({\n  name: 'XhTimePickerTrigger',\n  setup(_, { slots }) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTimePickerContext()\n    return () => h('button', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      // 归还焦点要落到它身上：锚点取的是整个输入行，那一层不可聚焦\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }), slots.default?.())\n  },\n})\n\nexport const XhTimePickerClearTrigger = defineComponent({\n  name: 'XhTimePickerClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerPositioner = defineComponent({\n  name: 'XhTimePickerPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.controlRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, slots.default?.()),\n    ])\n  },\n})\n\nexport const XhTimePickerContent = defineComponent({\n  name: 'XhTimePickerContent',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhTimePickerPresetGroup = defineComponent({\n  name: 'XhTimePickerPresetGroup',\n  slots: Object as SlotsType<{\n    /** 自行铺设条目；未写时按 presets 数据自动铺设，两者产出的 DOM 一致。 */\n    default?: (props: TimePickerPresetsSlotProps) => VNode[]\n  }>,\n  // 根是片段（选项列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    const presetGroupRef = ref<HTMLElement | null>(null)\n    // 快捷选项列定高自己竖滚：条子贴在它的盒子上、紧跟在它后面（浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => presetGroupRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    onUpdated(() => bars.measure())\n    return () => {\n      const api = ctx.api.value\n      const authored = slots.default?.({ presets: api.presets })\n      return [\n        h(\n          'div',\n          {\n            ...mergeProps(api.getPresetGroupProps() as Record<string, unknown>, attrs),\n            ref: (el: unknown) => { presetGroupRef.value = el as HTMLElement },\n          },\n          slotPaints(authored)\n            ? authored\n            : api.presets.map(preset => h(\n                'div',\n                { ...api.getPresetProps({ value: preset.value }) as Record<string, unknown>, key: preset.value },\n                preset.label,\n              )),\n        ),\n        ...bars.render(),\n      ]\n    }\n  },\n})\n\nexport const XhTimePickerPreset = defineComponent({\n  name: 'XhTimePickerPreset',\n  props: {\n    /** 该条目的身份，与 presets 数据中的 value 逐字对应。 */\n    value: { type: String, required: true },\n  },\n  slots: Object as SlotsType<{\n    /** 条目内容；未写时使用数据中的 label。 */\n    default?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => {\n      const api = ctx.api.value\n      const authored = slots.default?.()\n      return h(\n        'div',\n        api.getPresetProps({ value: props.value }) as Record<string, unknown>,\n        slotPaints(authored) ? authored : api.presets.find(p => p.value === props.value)?.label,\n      )\n    }\n  },\n})\n\nexport const XhTimePickerColumn = defineComponent({\n  name: 'XhTimePickerColumn',\n  props: {\n    unit: { type: String as PropType<TimePickerColumnUnit>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimePickerColumnSlotProps) => VNode[]\n  }>,\n  // 根是片段（列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    const unit = computed(() => props.unit)\n    // 下传单位，供列内选项取到自己归哪一列\n    provideTimePickerColumn({ unit })\n    const columnRef = ref<HTMLElement | null>(null)\n    // 定高的时间列自己竖滚：条子贴在本列的盒子上、紧跟在它后面（浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => columnRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    onUpdated(() => bars.measure())\n    return () => [\n      h(\n        'div',\n        {\n          ...mergeProps(ctx.api.value.getColumnProps({ unit: props.unit }) as Record<string, unknown>, attrs),\n          ref: (el: unknown) => { columnRef.value = el as HTMLElement },\n        },\n        slots.default?.({ options: ctx.api.value.columns.find(c => c.unit === props.unit)?.options ?? [] }),\n      ),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhTimePickerItem = defineComponent({\n  name: 'XhTimePickerItem',\n  props: {\n    /** 两位补零的显示串（'09' / '30'）；上下午列写 '00' / '01'。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    const { unit } = useTimePickerColumnContext()\n    // 有插槽用插槽，否则显示这一格该显示的文字（上下午列按 locale 译成「上午 / 下午」）\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ unit: unit.value, value: props.value }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getItemText({ unit: unit.value, value: props.value }),\n    )\n  },\n})\n\n/** 「添加」：多选时把浮层里拼好的草稿收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */\nexport const XhTimePickerConfirmTrigger = defineComponent({\n  name: 'XhTimePickerConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerFooter = defineComponent({\n  name: 'XhTimePickerFooter',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    // 浮层底部的通栏操作区：写在 content 里、排在各列之后，「添加」钮通常放在这里；\n    // 不进任何集合的拥有关系，方向键走不到，里面的按钮照常进 Tab 序列，从列上按 Tab 就能走到，浮层不收\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerHiddenInput = defineComponent({\n  name: 'XhTimePickerHiddenInput',\n  setup() {\n    const ctx = useTimePickerContext()\n    // 多选时一个选中值一份同名输入，表单按原生多值收；单选仍是一份\n    return () => ctx.api.value.selectionMode === 'multiple'\n      ? ctx.api.value.value.map(value => h('input', { key: value, ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown> }))\n      : h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"time-picker.js","names":[],"sources":["../../../src/components/time-picker/time-picker.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 picker 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type {\n  TimeGranularity,\n  TimeHourCycle,\n  TimePickerApi,\n  TimePickerColumn,\n  TimePickerColumnUnit,\n  TimePickerPreset,\n  TimePickerPresetState,\n  TimePickerSchema,\n  TimePickerSelectionMode,\n  TimeSegmentType,\n  TimeStep,\n  TimeUnavailablePredicate,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { timePickerStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps, onUnmounted, onUpdated, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText, slotPaints } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTimePicker,\n  provideTimePickerColumn,\n  provideTimePickerTag,\n  useTimePickerColumnContext,\n  useTimePickerContext,\n  useTimePickerTagContext,\n} from './context'\nimport { useTimePicker } from './use-time-picker'\n\ntype TimePickerProps = TimePickerSchema['props']\n\n/** 默认插槽的载荷：浮层开合与当前值、值状态标志、当前的段与列，以及开合、写值、清空的动作。 */\nexport type TimePickerRootSlotProps = Pick<\n  TimePickerApi,\n  | 'open'\n  | 'value'\n  | 'empty'\n  | 'outOfRange'\n  | 'segments'\n  | 'columns'\n  | 'canClear'\n  | 'canAdd'\n  | 'setOpen'\n  | 'setValue'\n  | 'clear'\n  | 'add'\n>\n\n/** 默认插槽的载荷：该列当前的可选值。 */\nexport interface TimePickerColumnSlotProps {\n  options: TimePickerColumn['options']\n}\n\n/** 快捷选项列默认插槽的载荷：逐条的投影，作者据此自行铺设条目。 */\nexport interface TimePickerPresetsSlotProps {\n  presets: readonly TimePickerPresetState[]\n}\n\nexport const XhTimePickerRoot = defineComponent({\n  name: 'XhTimePickerRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 选中的时刻，ISO 时间串数组；单选可写裸串。 */\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    /** 选择模式，默认 single；multiple 时列上拼草稿、按「添加」收进值，输入行里排成标签。 */\n    selectionMode: { type: String as PropType<TimePickerSelectionMode> },\n    /** multiple 下最多选几个时刻。 */\n    maxSelected: { type: Number },\n    /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */\n    maxTagCount: { type: Number },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    hourCycle: { type: Number as PropType<TimeHourCycle> },\n    granularity: { type: String as PropType<TimeGranularity> },\n    /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */\n    timeStep: { type: Object as PropType<TimeStep> },\n    /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */\n    presets: { type: Array as PropType<TimePickerPreset[]> },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TimePickerProps['translations']> },\n    /** 逐格可选性：时列按 24 小时制给值，第三个参数带已选的时与分。 */\n    isTimeUnavailable: { type: Function as PropType<TimeUnavailablePredicate> },\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    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<TimePickerProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<TimePickerProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<TimePickerProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<TimePickerProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimePickerRootSlotProps) => VNode[]\n    /** 不写默认插槽时标题的内容，盖过 label 文字。 */\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: TimePickerProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: TimePickerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTimePicker(withHandlers(withXhConfig('time-picker', useFormControlProps(props)), { onClear: () => emit('clear') }) as TimePickerProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n    })\n    provideTimePicker(ctx)\n\n    // 没写默认插槽时照 timePickerStructure 铺整套结构\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, !slots.default\n      ? renderDefaultStructure(ctx.api.value, props.label, slots.label)\n      : slots.default({\n          open: ctx.api.value.open,\n          value: ctx.api.value.value,\n          empty: ctx.api.value.empty,\n          outOfRange: ctx.api.value.outOfRange,\n          segments: ctx.api.value.segments,\n          columns: ctx.api.value.columns,\n          canClear: ctx.api.value.canClear,\n          canAdd: ctx.api.value.canAdd,\n          setOpen: ctx.api.value.setOpen,\n          setValue: ctx.api.value.setValue,\n          clear: ctx.api.value.clear,\n          add: ctx.api.value.add,\n        }))\n  },\n})\n\nexport const XhTimePickerLabel = defineComponent({\n  name: 'XhTimePickerLabel',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\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 XhTimePickerControl = defineComponent({\n  name: 'XhTimePickerControl',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getControlProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.controlRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）。 */\nexport const XhTimePickerTagLabel = defineComponent({\n  name: 'XhTimePickerTagLabel',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签内容：只有文字时替它包一层 label；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label。 */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhTimePickerTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhTimePickerTagLabel, null, () => content)] : content\n}\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的选中值，焦点不动。 */\nexport const XhTimePickerItemDeleteTrigger = defineComponent({\n  name: 'XhTimePickerItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    const tag = useTimePickerTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 多选时一个选中值一个标签，即库内 tag 的 root（data-scope=\"tag\"）。 */\nexport const XhTimePickerTag = defineComponent({\n  name: 'XhTimePickerTag',\n  props: {\n    /** 它代表哪个选中值。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    provideTimePickerTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhTimePickerOverflowTag = defineComponent({\n  name: 'XhTimePickerOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/**\n * 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。\n * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。\n */\nexport const XhTimePickerTagList = defineComponent({\n  name: 'XhTimePickerTagList',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : [\n          ...ctx.api.value.tags.map(tag => h(XhTimePickerTag, { key: tag.value, value: tag.value }, () => [\n            h(XhTimePickerTagLabel, null, () => tag.label),\n            h(XhTimePickerItemDeleteTrigger),\n          ])),\n          h(XhTimePickerOverflowTag),\n        ])\n  },\n})\n\nexport const XhTimePickerSegmentGroup = defineComponent({\n  name: 'XhTimePickerSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerSegment = defineComponent({\n  name: 'XhTimePickerSegment',\n  props: {\n    // 段的身份由作者声明\n    segment: { type: String as PropType<TimeSegmentType>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\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 XhTimePickerTrigger = defineComponent({\n  name: 'XhTimePickerTrigger',\n  setup(_, { slots }) {\n    // 放进字段时字段的说明与错误文案接到触发钮上；按钮不收 aria-required / aria-readonly，只取描述链，\n    // 只读、必填与校验状态由各段自己按字段状态投影\n    const fieldWiring = useFieldGroupWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTimePickerContext()\n    return () => h('button', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      // 归还焦点要落到它身上：锚点取的是整个输入行，那一层不可聚焦\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }), slots.default?.())\n  },\n})\n\nexport const XhTimePickerClearTrigger = defineComponent({\n  name: 'XhTimePickerClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerPositioner = defineComponent({\n  name: 'XhTimePickerPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.controlRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, slots.default?.()),\n    ])\n  },\n})\n\nexport const XhTimePickerContent = defineComponent({\n  name: 'XhTimePickerContent',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhTimePickerPresetGroup = defineComponent({\n  name: 'XhTimePickerPresetGroup',\n  slots: Object as SlotsType<{\n    /** 自行铺设条目；未写时按 presets 数据自动铺设，两者产出的 DOM 一致。 */\n    default?: (props: TimePickerPresetsSlotProps) => VNode[]\n  }>,\n  // 根是片段（选项列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    const presetGroupRef = ref<HTMLElement | null>(null)\n    // 快捷选项列定高自己竖滚：条子贴在它的盒子上、紧跟在它后面（浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => presetGroupRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    onUpdated(() => bars.measure())\n    return () => {\n      const api = ctx.api.value\n      const authored = slots.default?.({ presets: api.presets })\n      return [\n        h(\n          'div',\n          {\n            ...mergeProps(api.getPresetGroupProps() as Record<string, unknown>, attrs),\n            ref: (el: unknown) => { presetGroupRef.value = el as HTMLElement },\n          },\n          slotPaints(authored)\n            ? authored\n            : api.presets.map(preset => h(\n                'div',\n                { ...api.getPresetProps({ value: preset.value }) as Record<string, unknown>, key: preset.value },\n                preset.label,\n              )),\n        ),\n        ...bars.render(),\n      ]\n    }\n  },\n})\n\nexport const XhTimePickerPreset = defineComponent({\n  name: 'XhTimePickerPreset',\n  props: {\n    /** 该条目的身份，与 presets 数据中的 value 逐字对应。 */\n    value: { type: String, required: true },\n  },\n  slots: Object as SlotsType<{\n    /** 条目内容；未写时使用数据中的 label。 */\n    default?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => {\n      const api = ctx.api.value\n      const authored = slots.default?.()\n      return h(\n        'div',\n        api.getPresetProps({ value: props.value }) as Record<string, unknown>,\n        slotPaints(authored) ? authored : api.presets.find(p => p.value === props.value)?.label,\n      )\n    }\n  },\n})\n\nexport const XhTimePickerColumn = defineComponent({\n  name: 'XhTimePickerColumn',\n  props: {\n    unit: { type: String as PropType<TimePickerColumnUnit>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimePickerColumnSlotProps) => VNode[]\n  }>,\n  // 根是片段（列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useTimePickerContext()\n    const unit = computed(() => props.unit)\n    // 下传单位，供列内选项取到自己归哪一列\n    provideTimePickerColumn({ unit })\n    const columnRef = ref<HTMLElement | null>(null)\n    // 定高的时间列自己竖滚：条子贴在本列的盒子上、紧跟在它后面（浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => columnRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    onUpdated(() => bars.measure())\n    return () => [\n      h(\n        'div',\n        {\n          ...mergeProps(ctx.api.value.getColumnProps({ unit: props.unit }) as Record<string, unknown>, attrs),\n          ref: (el: unknown) => { columnRef.value = el as HTMLElement },\n        },\n        slots.default?.({ options: ctx.api.value.columns.find(c => c.unit === props.unit)?.options ?? [] }),\n      ),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhTimePickerItem = defineComponent({\n  name: 'XhTimePickerItem',\n  props: {\n    /** 两位补零的显示串（'09' / '30'）；上下午列写 '00' / '01'。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimePickerContext()\n    const { unit } = useTimePickerColumnContext()\n    // 有插槽用插槽，否则显示这一格该显示的文字（上下午列按 locale 译成「上午 / 下午」）\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ unit: unit.value, value: props.value }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getItemText({ unit: unit.value, value: props.value }),\n    )\n  },\n})\n\n/** 「添加」：多选时把浮层里拼好的草稿收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */\nexport const XhTimePickerConfirmTrigger = defineComponent({\n  name: 'XhTimePickerConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerFooter = defineComponent({\n  name: 'XhTimePickerFooter',\n  setup(_, { slots }) {\n    const ctx = useTimePickerContext()\n    // 浮层底部的通栏操作区：写在 content 里、排在各列之后，「添加」钮通常放在这里；\n    // 不进任何集合的拥有关系，方向键走不到，里面的按钮照常进 Tab 序列，从列上按 Tab 就能走到，浮层不收\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimePickerHiddenInput = defineComponent({\n  name: 'XhTimePickerHiddenInput',\n  setup() {\n    const ctx = useTimePickerContext()\n    // 多选时一个选中值一份同名输入，表单按原生多值收；单选仍是一份\n    return () => ctx.api.value.selectionMode === 'multiple'\n      ? ctx.api.value.value.map(value => h('input', { key: value, ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown> }))\n      : h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 结构里的部件 → 部件组件；委派出去的部件按「组件名/部件名」查。 */\nconst TIME_PICKER_PARTS = {\n  'label': XhTimePickerLabel,\n  'control': XhTimePickerControl,\n  'tag-list': XhTimePickerTagList,\n  'segment-group': XhTimePickerSegmentGroup,\n  'segment': XhTimePickerSegment,\n  'trigger': XhTimePickerTrigger,\n  'clear-trigger': XhTimePickerClearTrigger,\n  'positioner': XhTimePickerPositioner,\n  'content': XhTimePickerContent,\n  'preset-group': XhTimePickerPresetGroup,\n  'preset': XhTimePickerPreset,\n  'column': XhTimePickerColumn,\n  'item': XhTimePickerItem,\n  'footer': XhTimePickerFooter,\n  'confirm-trigger': XhTimePickerConfirmTrigger,\n  'hidden-input': XhTimePickerHiddenInput,\n  'tag/tag': XhTimePickerTag,\n  'tag/tag-label': XhTimePickerTagLabel,\n  'tag/item-delete-trigger': XhTimePickerItemDeleteTrigger,\n  'tag/overflow-tag': XhTimePickerOverflowTag,\n}\n\n/**\n * 未写默认插槽时照 timePickerStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。\n * 标题文字由 label 给出，需要放置其他内容时由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: TimePickerApi, label: string | undefined, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = timePickerStructure(api, { label, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, TIME_PICKER_PARTS, node => node.slot?.name === 'label' ? labelSlot?.() : undefined)\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,12 @@
-import { ComputedRef, Ref } from "vue";
 import { TimePickerApi, TimePickerSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/time-picker/use-time-picker.d.ts
 interface TimePickerContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhTimePickerLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<TimePickerApi>;
   controlRef: Ref<HTMLElement | null>;
   triggerRef: Ref<HTMLElement | null>;

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

@@ -1 +1 @@
-{"version":3,"file":"use-time-picker.d.ts","names":[],"sources":["../../../src/components/time-picker/use-time-picker.ts"],"mappings":";;;UAoBiB;EACf,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,cACd,OAAO,2BACP,WAAU,KAAK,+DACd"}
+{"version":3,"file":"use-time-picker.d.ts","names":[],"sources":["../../../src/components/time-picker/use-time-picker.ts"],"mappings":";;;UAoBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,cACd,OAAO,2BACP,WAAU,KAAK,+DACd"}

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

@@ -3,9 +3,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 { connectTimePicker, timePickerMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectTimePicker, timePickerMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/time-picker/use-time-picker.ts
 function useTimePicker(props, handlers = {}) {
@@ -16,8 +16,10 @@ function useTimePicker(props, handlers = {}) {
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const labelCount = ref(0);
 	const service = useMachine(timePickerMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
 	}), scope);
 	let config = null;
@@ -43,6 +45,7 @@ function useTimePicker(props, handlers = {}) {
 	}
 	const api = computed(() => connectTimePicker(service, vueNormalize));
 	return {
+		labelCount,
 		visible: useOverlayExit({
 			config,
 			isOpen: () => api.value.open,

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

@@ -1 +1 @@
-{"version":3,"file":"use-time-picker.js","names":[],"sources":["../../../src/components/time-picker/use-time-picker.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 picker 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/core'\nimport type { TimePickerApi, TimePickerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectTimePicker, timePickerMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface TimePickerContext {\n  api: ComputedRef<TimePickerApi>\n  controlRef: Ref<HTMLElement | null>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useTimePicker(\n  props: TimePickerSchema['props'],\n  handlers: Pick<TimePickerSchema['props'], 'onValueChange' | 'onOpenChange'> = {},\n): TimePickerContext {\n  const xhConfig = useXhConfig()\n  const controlRef = ref<HTMLElement | null>(null)\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(timePickerMachine, () => ({ ...props, ...handlers }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整个输入行记为本层分支，点触发器算层内交互\n      branches: () => [controlRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点取整个输入行\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => controlRef.value)\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectTimePicker(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, api, controlRef, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAgCA,SAAgB,cACd,OACA,WAA8E,CAAC,GAC5D;CACnB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAG/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAGtF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,kBAAkB,SAAS,YAAY,CAAC;CAWnE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAK;EAAY;EAAY;EAAe;EAAY,cAFrD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpC;CAAE;AACzF"}
+{"version":3,"file":"use-time-picker.js","names":[],"sources":["../../../src/components/time-picker/use-time-picker.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 picker 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/core'\nimport type { TimePickerApi, TimePickerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectTimePicker, timePickerMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface TimePickerContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTimePickerLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TimePickerApi>\n  controlRef: Ref<HTMLElement | null>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useTimePicker(\n  props: TimePickerSchema['props'],\n  handlers: Pick<TimePickerSchema['props'], 'onValueChange' | 'onOpenChange'> = {},\n): TimePickerContext {\n  const xhConfig = useXhConfig()\n  const controlRef = ref<HTMLElement | null>(null)\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | 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(timePickerMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整个输入行记为本层分支，点触发器算层内交互\n      branches: () => [controlRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点取整个输入行\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => controlRef.value)\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectTimePicker(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { labelCount, visible, api, controlRef, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAqCA,SAAgB,cACd,OACA,WAA8E,CAAC,GAC5D;CACnB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAG/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAGtH,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,kBAAkB,SAAS,YAAY,CAAC;CAWnE,OAAO;EAAE;EAAY,SATL,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAI2B;EAAG;EAAK;EAAY;EAAY;EAAe;EAAY,cAFjE,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAExB;CAAE;AACrG"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TimeGranularity, TimeHourCycle, TimePickerColumn, TimePickerColumnUnit, TimeRangePickerApi, TimeRangePickerPreset, TimeRangePickerPresetState, TimeRangePickerSchema, 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, TimePickerColumn, TimePickerColumnUnit, TimeRangePickerApi, TimeRangePickerPreset, TimeRangePickerPresetState, TimeRangePickerSchema, TimeSegmentType, TimeStep, TimeUnavailablePredicate } from "@xihan-ui/headless";
 //#region src/components/time-range-picker/time-range-picker.d.ts
 type TimeRangePickerProps = TimeRangePickerSchema['props'];
 /** 默认插槽的载荷：浮层开合与两端、值状态标志、当前的段与两组时列，以及开合、写值、清空的动作。 */
@@ -19,6 +19,14 @@ interface TimeRangePickerPresetsSlotProps {
   presets: readonly TimeRangePickerPresetState[];
 }
 declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   /** 区间两端 [start, end]；空缺的一端用空串占位。 */
   value: {
     type: PropType<string[]>;
@@ -83,6 +91,14 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   endName: {
     type: StringConstructor;
   };
+  /** 起点那组段位的整条占位：一段都没填、焦点也不在段上时显示这句文字，焦点进到段上即换回段位。 */
+  startPlaceholder: {
+    type: StringConstructor;
+  };
+  /** 终点那组段位的整条占位，规则同 startPlaceholder。 */
+  endPlaceholder: {
+    type: StringConstructor;
+  };
   variant: {
     type: PropType<ControlVariant>;
   };
@@ -111,6 +127,14 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   'update:value': (_value: PayloadOf<TimeRangePickerProps, "onValueChange">["value"]) => true;
   'update:open': (_open: PayloadOf<TimeRangePickerProps, "onOpenChange">["open"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   /** 区间两端 [start, end]；空缺的一端用空串占位。 */
   value: {
     type: PropType<string[]>;
@@ -175,6 +199,14 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   endName: {
     type: StringConstructor;
   };
+  /** 起点那组段位的整条占位：一段都没填、焦点也不在段上时显示这句文字，焦点进到段上即换回段位。 */
+  startPlaceholder: {
+    type: StringConstructor;
+  };
+  /** 终点那组段位的整条占位，规则同 startPlaceholder。 */
+  endPlaceholder: {
+    type: StringConstructor;
+  };
   variant: {
     type: PropType<ControlVariant>;
   };
@@ -209,6 +241,8 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   readOnly: boolean;
 }, SlotsType<{
   default?: (props: TimeRangePickerRootSlotProps) => VNode[];
+  /** 不写默认插槽时标题的内容，盖过 label 文字。 */
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTimeRangePickerLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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

@@ -1 +1 @@
-{"version":3,"file":"time-range-picker.d.ts","names":[],"sources":["../../../src/components/time-range-picker/time-range-picker.ts"],"mappings":";;;;;KA2CK,uBAAuB;;KAGhB,+BAA+B,KACzC;;UAiBe;EACf,kBAAkB;;;UAIH;EACf,SAAS;;;UAIM;EACf,kBAAkB;;cAGP,qCAAqB,8BAAA;;;IAKN,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;IAMF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAOrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;EAKL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;IAtCT,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;IAMF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAOrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;EAWtB,WAAC,OAAO,iCAAiC;kCAiCrD;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BASnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,8BAAA;;IAIH,MAAA;;;;;;;IAAA,MAAA;;;;;qCASrC;cAEW,wCAAwB,8BAAA;;IAIN,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAYtC,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAU1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAenC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,8BAAA;;;IAIP,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAqBxC,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4CAA4B,0BAAA,oBAAA,4BAAA;;;;EAI3B,WAAC,OAAO,oCAAoC;kCAoCxD;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;;;;;EAQtB,gBAAM;kCAclB;cAEW,4CAA4B,8BAAA;;IAIF,MAAA;;;;;;;IAAA,MAAA;;;;;;EAGzB,WAAC,OAAO,wCAAwC;kCAa5D;cAEW,iDAAiC,0BAAA,oBAAA,4BAAA;;8BAO5C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,8BAAA;;IAGR,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;;EAGvB,WAAC,OAAO,mCAAmC;kCA8BvD;cAEW,qCAAqB,8BAAA;;;;;;;;;;;;;;MAiBhC,oDAAA;cAEW,4CAA4B,8BAAA;;IAIF,MAAA;;;;;;IAAA,MAAA;;MAUrC,oDAAA"}
+{"version":3,"file":"time-range-picker.d.ts","names":[],"sources":["../../../src/components/time-range-picker/time-range-picker.ts"],"mappings":";;;;;KA4CK,uBAAuB;;KAGhB,+BAA+B,KACzC;;UAiBe;EACf,kBAAkB;;;UAIH;EACf,SAAS;;;UAIM;EACf,kBAAkB;;cAGP,qCAAqB,8BAAA;;;;;;;;;;;IASN,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;IAMF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;EAKL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;;;;;;;;;IA1CT,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;IAMF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;EAWtB,WAAC,OAAO,iCAAiC;;EAE3C,cAAM;kCAoChB;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAYjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BASnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,8BAAA;;IAIH,MAAA;;;;;;;IAAA,MAAA;;;;;qCASrC;cAEW,wCAAwB,8BAAA;;IAIN,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAYtC,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAU1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAgBnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,8BAAA;;;IAIP,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAqBxC,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4CAA4B,0BAAA,oBAAA,4BAAA;;;;EAI3B,WAAC,OAAO,oCAAoC;kCAoCxD;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;;;;;EAQtB,gBAAM;kCAclB;cAEW,4CAA4B,8BAAA;;IAIF,MAAA;;;;;;;IAAA,MAAA;;;;;;EAGzB,WAAC,OAAO,wCAAwC;kCAa5D;cAEW,iDAAiC,0BAAA,oBAAA,4BAAA;;8BAO5C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,8BAAA;;IAGR,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;;EAGvB,WAAC,OAAO,mCAAmC;kCA8BvD;cAEW,qCAAqB,8BAAA;;;;;;;;;;;;;;MAiBhC,oDAAA;cAEW,4CAA4B,8BAAA;;IAIF,MAAA;;;;;;IAAA,MAAA;;MAUrC,oDAAA"}

package/dist/components/time-range-picker/time-range-picker.js

@@ -1,18 +1,23 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.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 { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideTimeRangePicker, provideTimeRangePickerColumn, provideTimeRangePickerEnd, useTimeRangePickerColumnContext, useTimeRangePickerContext, useTimeRangePickerEndContext } from "./context.js";
 import { useTimeRangePicker } from "./use-time-range-picker.js";
-import { computed, defineComponent, h, mergeProps, onUpdated, ref } from "vue";
-import { resolveTimeRangePickerEndIndex } from "@xihan-ui/headless";
+import { resolveTimeRangePickerEndIndex, timeRangePickerStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onUnmounted, onUpdated, ref } from "vue";
 //#region src/components/time-range-picker/time-range-picker.ts
 const XhTimeRangePickerRoot = defineComponent({
 	name: "XhTimeRangePickerRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字：不写默认插槽时铺带这段文字的 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
 		/** 区间两端 [start, end]；空缺的一端用空串占位。 */
 		value: { type: Array },
 		defaultValue: { type: Array },
@@ -51,6 +56,10 @@ const XhTimeRangePickerRoot = defineComponent({
 		},
 		name: { type: String },
 		endName: { type: String },
+		/** 起点那组段位的整条占位：一段都没填、焦点也不在段上时显示这句文字，焦点进到段上即换回段位。 */
+		startPlaceholder: { type: String },
+		/** 终点那组段位的整条占位，规则同 startPlaceholder。 */
+		endPlaceholder: { type: String },
 		variant: { type: String },
 		tone: { type: String },
 		size: { type: String },
@@ -81,7 +90,7 @@ const XhTimeRangePickerRoot = defineComponent({
 			onOpenChange: notifyOpen
 		});
 		provideTimeRangePicker(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", ctx.api.value.getRootProps(), !slots.default ? renderDefaultStructure(ctx.api.value, props.label, slots.label) : slots.default({
 			open: ctx.api.value.open,
 			value: ctx.api.value.value,
 			start: ctx.api.value.start,
@@ -102,6 +111,10 @@ const XhTimeRangePickerLabel = defineComponent({
 	name: "XhTimeRangePickerLabel",
 	setup(_, { slots }) {
 		const ctx = useTimeRangePickerContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -158,7 +171,7 @@ const XhTimeRangePickerRangeSeparator = defineComponent({
 const XhTimeRangePickerTrigger = defineComponent({
 	name: "XhTimeRangePickerTrigger",
 	setup(_, { slots }) {
-		const fieldWiring = useFieldStateWiring();
+		const fieldWiring = useFieldGroupWiring();
 		const fieldLabel = useFieldLabelWiring();
 		const ctx = useTimeRangePickerContext();
 		return () => h("button", fieldLabel.value({
@@ -356,6 +369,35 @@ const XhTimeRangePickerHiddenInput = defineComponent({
 		};
 	}
 });
+/** 结构里的部件 → 部件组件。 */
+const TIME_RANGE_PICKER_PARTS = {
+	"label": XhTimeRangePickerLabel,
+	"control": XhTimeRangePickerControl,
+	"segment-group": XhTimeRangePickerSegmentGroup,
+	"segment": XhTimeRangePickerSegment,
+	"range-separator": XhTimeRangePickerRangeSeparator,
+	"trigger": XhTimeRangePickerTrigger,
+	"clear-trigger": XhTimeRangePickerClearTrigger,
+	"positioner": XhTimeRangePickerPositioner,
+	"content": XhTimeRangePickerContent,
+	"preset-group": XhTimeRangePickerPresetGroup,
+	"preset": XhTimeRangePickerPreset,
+	"column-group": XhTimeRangePickerColumnGroup,
+	"column-group-label": XhTimeRangePickerColumnGroupLabel,
+	"column": XhTimeRangePickerColumn,
+	"item": XhTimeRangePickerItem,
+	"hidden-input": XhTimeRangePickerHiddenInput
+};
+/**
+* 未写默认插槽时照 timeRangePickerStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。
+* 标题文字由 label 给出，需要放置其他内容时由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, labelSlot) {
+	return renderStructure(timeRangePickerStructure(api, {
+		label,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), TIME_RANGE_PICKER_PARTS, (node) => node.slot?.name === "label" ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhTimeRangePickerClearTrigger, XhTimeRangePickerColumn, XhTimeRangePickerColumnGroup, XhTimeRangePickerColumnGroupLabel, XhTimeRangePickerContent, XhTimeRangePickerControl, XhTimeRangePickerHiddenInput, XhTimeRangePickerItem, XhTimeRangePickerLabel, XhTimeRangePickerPositioner, XhTimeRangePickerPreset, XhTimeRangePickerPresetGroup, XhTimeRangePickerRangeSeparator, XhTimeRangePickerRoot, XhTimeRangePickerSegment, XhTimeRangePickerSegmentGroup, XhTimeRangePickerTrigger };