@xihan-ui/vue 2.0.0 → 3.0.0

package/dist/components/tag-group/tag-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"tag-group.js","names":[],"sources":["../../../src/components/tag-group/tag-group.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// 提供 tag group 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupItemProps, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext } from './context'\nimport { useTagGroup } from './use-tag-group'\n\ntype TagGroupProps = TagGroupSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换、移除的命令。 */\nexport type TagGroupRootSlotProps = Pick<\n  TagGroupApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle' | 'deleteItem'\n>\n\nexport const XhTagGroupRoot = defineComponent({\n  name: 'XhTagGroupRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TagGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<TagGroupSelectionMode> },\n    deletable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n    typeahead: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<TagVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<TagGroupTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1。\n  // item-delete 只报「用户要摘这一枚」，条目的去留由宿主改自己的数据\n  emits: {\n    'value-change': (_details: PayloadOf<TagGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TagGroupProps, 'onValueChange'>['value']) => true,\n    'item-delete': (_details: PayloadOf<TagGroupProps, 'onItemDelete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TagGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (node: TagGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TagGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyDelete: TagGroupProps['onItemDelete'] = (details) => {\n      emit('item-delete', details)\n    }\n    const ctx = useTagGroup(withXhConfig('tag-group', useFormControlProps(props)) as TagGroupProps, notify, notifyDelete)\n    provideTagGroup(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n          deleteItem: ctx.api.value.deleteItem,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhTagGroupLabel = defineComponent({\n  name: 'XhTagGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagGroupList = defineComponent({\n  name: 'XhTagGroupList',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 一个标签：渲染为 tag 的 root（data-scope=\"tag\"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */\nexport const XhTagGroupItem = defineComponent({\n  name: 'XhTagGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的声明\n    disabled: { type: Boolean, default: undefined },\n    deletable: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTagGroupContext()\n    const item = computed<TagGroupItemProps>(() => ({\n      value: props.value,\n      disabled: props.disabled,\n      deletable: props.deletable,\n    }))\n    provideTagGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'span',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTagGroupCell = defineComponent({\n  name: 'XhTagGroupCell',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getCellProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */\nexport const XhTagGroupItemIndicator = defineComponent({\n  name: 'XhTagGroupItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字：渲染为 tag 的 label。 */\nexport const XhTagGroupItemText = defineComponent({\n  name: 'XhTagGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 移除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；整组未开放移除时收起。 */\nexport const XhTagGroupItemDeleteTrigger = defineComponent({\n  name: 'XhTagGroupItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly TagGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: TagGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhTagGroupLabel, null, () => label)] : []),\n    h(XhTagGroupList, null, () => collection.map(node =>\n      h(XhTagGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhTagGroupCell, null, () => [\n          h(XhTagGroupItemIndicator),\n          h(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n          h(XhTagGroupItemDeleteTrigger),\n        ]),\n      ]),\n    )),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"tag-group.js","names":[],"sources":["../../../src/components/tag-group/tag-group.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// 提供 tag group 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupItemProps, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext } from './context'\nimport { useTagGroup } from './use-tag-group'\n\ntype TagGroupProps = TagGroupSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换、移除的命令。 */\nexport type TagGroupRootSlotProps = Pick<\n  TagGroupApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle' | 'deleteItem'\n>\n\nexport const XhTagGroupRoot = defineComponent({\n  name: 'XhTagGroupRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TagGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<TagGroupSelectionMode> },\n    deletable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n    typeahead: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<TagVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<TagGroupTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1。\n  // item-delete 只报「用户要摘这一枚」，条目的去留由宿主改自己的数据\n  emits: {\n    'value-change': (_details: PayloadOf<TagGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TagGroupProps, 'onValueChange'>['value']) => true,\n    'item-delete': (_details: PayloadOf<TagGroupProps, 'onItemDelete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TagGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (node: TagGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TagGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyDelete: TagGroupProps['onItemDelete'] = (details) => {\n      emit('item-delete', details)\n    }\n    const ctx = useTagGroup(withXhConfig('tag-group', useFormControlProps(props)) as TagGroupProps, notify, notifyDelete)\n    provideTagGroup(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n          deleteItem: ctx.api.value.deleteItem,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhTagGroupLabel = defineComponent({\n  name: 'XhTagGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagGroupList = defineComponent({\n  name: 'XhTagGroupList',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 一个标签：渲染为 tag 的 root（data-scope=\"tag\"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */\nexport const XhTagGroupItem = defineComponent({\n  name: 'XhTagGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的声明\n    disabled: { type: Boolean, default: undefined },\n    deletable: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTagGroupContext()\n    const item = computed<TagGroupItemProps>(() => ({\n      value: props.value,\n      disabled: props.disabled,\n      deletable: props.deletable,\n    }))\n    provideTagGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'span',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTagGroupCell = defineComponent({\n  name: 'XhTagGroupCell',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getCellProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */\nexport const XhTagGroupItemIndicator = defineComponent({\n  name: 'XhTagGroupItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字：渲染为 tag 的 label。 */\nexport const XhTagGroupItemText = defineComponent({\n  name: 'XhTagGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 移除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；整组未开放移除时收起。 */\nexport const XhTagGroupItemDeleteTrigger = defineComponent({\n  name: 'XhTagGroupItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly TagGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: TagGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhTagGroupLabel, null, () => label)] : []),\n    h(XhTagGroupList, null, () => collection.map(node =>\n      h(XhTagGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhTagGroupCell, null, () => [\n          h(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n          h(XhTagGroupItemIndicator),\n          h(XhTagGroupItemDeleteTrigger),\n        ]),\n      ]),\n    )),\n  ]\n}\n"],"mappings":";;;;;;AAyBA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,YAAY,EAAE,MAAM,MAAkC;;EAEtD,OAAO,EAAE,MAAM,OAAO;EACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EAC9D,cAAc,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EACrE,eAAe,EAAE,MAAM,OAA0C;EACjE,WAAW;EACX,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,KAAK,EAAE,MAAM,OAA8B;EAC3C,aAAa,EAAE,MAAM,OAAgC;EACrD,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC/C,SAAS,EAAE,MAAM,OAA+B;EAChD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAkD;CAC1E;CAGA,OAAO;EACL,iBAAiB,aAAwD;EACzE,iBAAiB,WAA+D;EAChF,gBAAgB,aAAuD;CACzE;CACA,OAAO;CAKP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA0C,YAAY;GAC1D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,gBAA+C,YAAY;GAC/D,KAAK,eAAe,OAAO;EAC7B;EACA,MAAM,MAAM,YAAY,aAAa,aAAa,oBAAoB,KAAK,CAAC,GAAoB,QAAQ,YAAY;EACpH,gBAAgB,GAAG;EACnB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,CAC7E,GAAI,MAAM,UACN,MAAM,QAAQ;GACd,OAAO,IAAI,IAAI,MAAM;GACrB,eAAe,IAAI,IAAI,MAAM;GAC7B,cAAc,IAAI,IAAI,MAAM;GAC5B,YAAY,IAAI,IAAI,MAAM;GAC1B,UAAU,IAAI,IAAI,MAAM;GACxB,QAAQ,IAAI,IAAI,MAAM;GACtB,QAAQ,IAAI,IAAI,MAAM;GACtB,YAAY,IAAI,IAAI,MAAM;EAC5B,CAAC,KAAK,CAAC,IACL,MAAM,aACJ,kBACE,IAAI,IAAI,MAAM,YACd,MAAM,QAAQ,MAAM,MAAM,SAAS,OAAO,CAAC,MAAM,KAAK,IAAI,OAC1D,MAAM,IACR,IACA,CAAC,CACT,CAAC;CACH;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EAEtC,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CACjD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,OAAO,gBAAmC;GAC9C,OAAO,MAAM;GACb,UAAU,MAAM;GAChB,WAAW,MAAM;EACnB,EAAE;EACF,oBAAoB,EAAE,KAAK,CAAC;EAE5B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GACF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EACpD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,YAAY,CAAC;EACtC,CAAC;EACD,aAAa,EACX,QACA;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK;GAA8B,KAAK;EAAO,GACpF,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;;AAGD,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,sBAAsB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACtH;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;;AAGD,MAAa,8BAA8B,gBAAgB;CACzD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,EAAE,SAAS,uBAAuB;EACxC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,0BAA0B,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CAC5H;AACF,CAAC;;;;;AAMD,SAAS,kBACP,YACA,OACA,UACS;CACT,OAAO,CACL,GAAI,QAAQ,CAAC,EAAE,iBAAiB,YAAY,KAAK,CAAC,IAAI,CAAC,GACvD,EAAE,gBAAgB,YAAY,WAAW,KAAI,SAC3C,EAAE,gBAAgB;EAAE,KAAK,KAAK;EAAO,OAAO,KAAK;CAAM,SAAS,CAC9D,EAAE,gBAAgB,YAAY;EAC5B,EAAE,oBAAoB,YAAY,WAAW,IAAI,KAAK,KAAK,KAAK;EAChE,EAAE,uBAAuB;EACzB,EAAE,2BAA2B;CAC/B,CAAC,CACH,CAAC,CACH,CAAC,CACH;AACF"}

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

@@ -49,7 +49,10 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
     type: StringConstructor;
   };
   delimiter: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
+  };
+  validate: {
+    type: PropType<TagsInputProps["validate"]>;
   };
   addOnPaste: BooleanConstructor;
   editable: BooleanConstructor;
@@ -75,6 +78,7 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
   'update:value': (_value: PayloadOf<TagsInputProps, "onValueChange">["value"]) => true;
   'input-value-change': (_details: PayloadOf<TagsInputProps, "onInputValueChange">) => true;
   'update:inputValue': (_inputValue: PayloadOf<TagsInputProps, "onInputValueChange">["inputValue"]) => true;
+  'tag-reject': (_details: PayloadOf<TagsInputProps, "onTagReject">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<string[]>;
@@ -116,7 +120,10 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
     type: StringConstructor;
   };
   delimiter: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
+  };
+  validate: {
+    type: PropType<TagsInputProps["validate"]>;
   };
   addOnPaste: BooleanConstructor;
   editable: BooleanConstructor;
@@ -140,6 +147,7 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
   "onInput-value-change"?: ((_details: import("@xihan-ui/headless").TagsInputInputValueChangeDetails) => any) | undefined;
   "onUpdate:inputValue"?: ((_inputValue: string) => any) | undefined;
+  "onTag-reject"?: ((_details: import("@xihan-ui/headless").TagsInputTagRejectDetails) => any) | undefined;
 }>, {
   required: boolean;
   invalid: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"tags-input.d.ts","names":[],"sources":["../../../src/components/tags-input/tags-input.ts"],"mappings":";;;;;KAkBK,iBAAiB;;KAGV,0BAA0B,KAAK;;KAG/B,yBAAyB,KACnC;cAmBW,+BAAe,8BAAA;;IAKA,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeC,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACF,uBAAA,UAAA,UAAU;EACR,sBAAA,aAAA,UAAU;;;IA3BrB,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeC,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,2BAA2B;kCAgC/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;MAgC1B,oDAAA;;cAGW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,4CAA4B,0BAAA,oBAAA,4BAAA;;8BAOvC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,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;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tags-input.d.ts","names":[],"sources":["../../../src/components/tags-input/tags-input.ts"],"mappings":";;;;;KAkBK,iBAAiB;;KAGV,0BAA0B,KAAK;;KAG/B,yBAAyB,KACnC;cAmBW,+BAAe,8BAAA;;IAKA,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYO,MAAA;;;IACR,MAAA,SAAS;;;;;IAGP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACF,uBAAA,UAAA,UAAU;EACR,sBAAA,aAAA,UAAU;EACpB,eAAA,UAAA,UAAU;;;IA7BX,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYO,MAAA;;;IACR,MAAA,SAAS;;;;;IAGP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;EAWvC,WAAC,OAAO,2BAA2B;kCAiC/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;MAgC1B,oDAAA;;cAGW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,4CAA4B,0BAAA,oBAAA,4BAAA;;8BAOvC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,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;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -33,7 +33,8 @@ const XhTagsInputRoot = defineComponent({
 		showCount: Boolean,
 		name: { type: String },
 		placeholder: { type: String },
-		delimiter: { type: String },
+		delimiter: { type: [String, Array] },
+		validate: { type: Function },
 		addOnPaste: Boolean,
 		editable: Boolean,
 		blurBehavior: { type: String },
@@ -46,7 +47,8 @@ const XhTagsInputRoot = defineComponent({
 		"value-change": (_details) => true,
 		"update:value": (_value) => true,
 		"input-value-change": (_details) => true,
-		"update:inputValue": (_inputValue) => true
+		"update:inputValue": (_inputValue) => true,
+		"tag-reject": (_details) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -58,9 +60,11 @@ const XhTagsInputRoot = defineComponent({
 			emit("input-value-change", details);
 			emit("update:inputValue", details.inputValue);
 		};
+		const onTagReject = (details) => emit("tag-reject", details);
 		const ctx = useTagsInput(withXhConfig("tags-input", useFormControlProps(props)), {
 			onValueChange,
-			onInputValueChange
+			onInputValueChange,
+			onTagReject
 		});
 		provideTagsInput(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
@@ -94,7 +98,10 @@ const XhTagsInputControl = defineComponent({
 	name: "XhTagsInputControl",
 	setup(_, { slots }) {
 		const ctx = useTagsInputContext();
-		return () => h("div", ctx.api.value.getControlProps(), slots.default?.());
+		return () => h("div", {
+			...ctx.api.value.getControlProps(),
+			ref: ctx.controlRef
+		}, slots.default?.());
 	}
 });
 const XhTagsInputInput = defineComponent({

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

@@ -1 +1 @@
-{"version":3,"file":"tags-input.js","names":[],"sources":["../../../src/components/tags-input/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// 提供 tags input 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TagsInputApi, TagsInputBlurBehavior, TagsInputItemProps, TagsInputSchema, TagsInputTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTagsInput, provideTagsInputItem, useTagsInputContext, useTagsInputItemContext } from './context'\nimport { useTagsInput } from './use-tags-input'\n\ntype TagsInputProps = TagsInputSchema['props']\n\n/** 计数部件默认插槽的载荷：当前个数、上限与已达上限、越界两个标志。 */\nexport type TagsInputCountSlotProps = Pick<TagsInputApi, 'count' | 'max' | 'atMax' | 'overflow'>\n\n/** 默认插槽的载荷：标签集合与输入文本、数量与越界标志、光标与编辑锚点，以及增删改与清空的动作。 */\nexport type TagsInputRootSlotProps = Pick<\n  TagsInputApi,\n  | 'value'\n  | 'count'\n  | 'inputValue'\n  | 'empty'\n  | 'atMax'\n  | 'overflow'\n  | 'highlightedValue'\n  | 'editedValue'\n  | 'canClear'\n  | 'setValue'\n  | 'addValue'\n  | 'deleteValue'\n  | 'clear'\n  | 'setInputValue'\n  | 'highlight'\n  | 'edit'\n>\n\nexport const XhTagsInputRoot = defineComponent({\n  name: 'XhTagsInputRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    inputValue: { type: String },\n    defaultInputValue: { type: String },\n    max: { type: Number },\n    allowOverflow: Boolean,\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    showCount: Boolean,\n    name: { type: String },\n    placeholder: { type: String },\n    delimiter: { type: String },\n    addOnPaste: Boolean,\n    editable: Boolean,\n    blurBehavior: { type: String as PropType<TagsInputBlurBehavior | null> },\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<Partial<TagsInputTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组；输入文本走 input-value-change 一路\n  emits: {\n    'value-change': (_details: PayloadOf<TagsInputProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TagsInputProps, 'onValueChange'>['value']) => true,\n    'input-value-change': (_details: PayloadOf<TagsInputProps, 'onInputValueChange'>) => true,\n    'update:inputValue': (_inputValue: PayloadOf<TagsInputProps, 'onInputValueChange'>['inputValue']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TagsInputRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: TagsInputProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onInputValueChange: TagsInputProps['onInputValueChange'] = (details) => {\n      emit('input-value-change', details)\n      emit('update:inputValue', details.inputValue)\n    }\n    const ctx = useTagsInput(withXhConfig('tags-input', useFormControlProps(props)) as TagsInputProps, { onValueChange, onInputValueChange })\n    provideTagsInput(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      inputValue: ctx.api.value.inputValue,\n      empty: ctx.api.value.empty,\n      atMax: ctx.api.value.atMax,\n      overflow: ctx.api.value.overflow,\n      highlightedValue: ctx.api.value.highlightedValue,\n      editedValue: ctx.api.value.editedValue,\n      canClear: ctx.api.value.canClear,\n      setValue: ctx.api.value.setValue,\n      addValue: ctx.api.value.addValue,\n      deleteValue: ctx.api.value.deleteValue,\n      clear: ctx.api.value.clear,\n      setInputValue: ctx.api.value.setInputValue,\n      highlight: ctx.api.value.highlight,\n      edit: ctx.api.value.edit,\n    }))\n  },\n})\n\nexport const XhTagsInputLabel = defineComponent({\n  name: 'XhTagsInputLabel',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    // 用原生 label，getLabelProps 的 for 指向输入框\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagsInputControl = defineComponent({\n  name: 'XhTagsInputControl',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagsInputInput = defineComponent({\n  name: 'XhTagsInputInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTagsInputContext()\n    return () => h('input', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getInputProps() as Record<string, unknown> }))\n  },\n})\n\nexport const XhTagsInputItem = defineComponent({\n  name: 'XhTagsInputItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTagsInputContext()\n    const item = computed<TagsInputItemProps>(() => ({ value: props.value }))\n    provideTagsInputItem({ item })\n    // 本标签持有焦点时，value 变更或卸载都上报焦点离场以终止编辑会话\n    const itemEl = ref<HTMLElement | null>(null)\n    const holdsFocus = (): boolean => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return false\n      const active = service.scope.getActiveElement()\n      return !!itemEl.value && !!active && (itemEl.value === active || itemEl.value.contains(active))\n    }\n    watch(() => props.value, (next, prev) => {\n      if (next !== prev && holdsFocus())\n        ctx.service.send({ type: 'ITEM.FOCUS_LOST' })\n    })\n    onBeforeUnmount(() => {\n      if (holdsFocus())\n        ctx.service.send({ type: 'ITEM.FOCUS_LOST' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 标签的预览：渲染为库内 tag 的 root（data-scope=\"tag\"），就地编辑时由 tag 收起。 */\nexport const XhTagsInputItemPreview = defineComponent({\n  name: 'XhTagsInputItemPreview',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('span', ctx.api.value.getItemPreviewProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字：渲染为 tag 的 label，截断落在这一层。 */\nexport const XhTagsInputItemText = defineComponent({\n  name: 'XhTagsInputItemText',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 删除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；禁用与只读时保留位置、原生 disabled。 */\nexport const XhTagsInputItemDeleteTrigger = defineComponent({\n  name: 'XhTagsInputItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagsInputItemInput = defineComponent({\n  name: 'XhTagsInputItemInput',\n  setup() {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('input', ctx.api.value.getItemInputProps(item.value) as Record<string, unknown>)\n  },\n})\n\nexport const XhTagsInputClearTrigger = defineComponent({\n  name: 'XhTagsInputClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 计数：未写内容时渲染「已用 / 上限」，未设上限时只渲染已用。 */\nexport const XhTagsInputCount = defineComponent({\n  name: 'XhTagsInputCount',\n  slots: Object as SlotsType<{\n    default?: (props: TagsInputCountSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => {\n      const api = ctx.api.value\n      const fallback = api.max === undefined ? `${api.count}` : `${api.count} / ${api.max}`\n      return h(\n        'span',\n        api.getCountProps() as Record<string, unknown>,\n        slots.default?.({ count: api.count, max: api.max, atMax: api.atMax, overflow: api.overflow }) ?? fallback,\n      )\n    }\n  },\n})\n\nexport const XhTagsInputHiddenInput = defineComponent({\n  name: 'XhTagsInputHiddenInput',\n  setup() {\n    const ctx = useTagsInputContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"tags-input.js","names":[],"sources":["../../../src/components/tags-input/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// 提供 tags input 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { TagsInputApi, TagsInputBlurBehavior, TagsInputItemProps, TagsInputSchema, TagsInputTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTagsInput, provideTagsInputItem, useTagsInputContext, useTagsInputItemContext } from './context'\nimport { useTagsInput } from './use-tags-input'\n\ntype TagsInputProps = TagsInputSchema['props']\n\n/** 计数部件默认插槽的载荷：当前个数、上限与已达上限、越界两个标志。 */\nexport type TagsInputCountSlotProps = Pick<TagsInputApi, 'count' | 'max' | 'atMax' | 'overflow'>\n\n/** 默认插槽的载荷：标签集合与输入文本、数量与越界标志、光标与编辑锚点，以及增删改与清空的动作。 */\nexport type TagsInputRootSlotProps = Pick<\n  TagsInputApi,\n  | 'value'\n  | 'count'\n  | 'inputValue'\n  | 'empty'\n  | 'atMax'\n  | 'overflow'\n  | 'highlightedValue'\n  | 'editedValue'\n  | 'canClear'\n  | 'setValue'\n  | 'addValue'\n  | 'deleteValue'\n  | 'clear'\n  | 'setInputValue'\n  | 'highlight'\n  | 'edit'\n>\n\nexport const XhTagsInputRoot = defineComponent({\n  name: 'XhTagsInputRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    inputValue: { type: String },\n    defaultInputValue: { type: String },\n    max: { type: Number },\n    allowOverflow: Boolean,\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    showCount: Boolean,\n    name: { type: String },\n    placeholder: { type: String },\n    delimiter: { type: [String, Array] as PropType<string | string[]> },\n    validate: { type: Function as PropType<TagsInputProps['validate']> },\n    addOnPaste: Boolean,\n    editable: Boolean,\n    blurBehavior: { type: String as PropType<TagsInputBlurBehavior | null> },\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<Partial<TagsInputTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组；输入文本走 input-value-change 一路\n  emits: {\n    'value-change': (_details: PayloadOf<TagsInputProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TagsInputProps, 'onValueChange'>['value']) => true,\n    'input-value-change': (_details: PayloadOf<TagsInputProps, 'onInputValueChange'>) => true,\n    'update:inputValue': (_inputValue: PayloadOf<TagsInputProps, 'onInputValueChange'>['inputValue']) => true,\n    'tag-reject': (_details: PayloadOf<TagsInputProps, 'onTagReject'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TagsInputRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: TagsInputProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onInputValueChange: TagsInputProps['onInputValueChange'] = (details) => {\n      emit('input-value-change', details)\n      emit('update:inputValue', details.inputValue)\n    }\n    const onTagReject: TagsInputProps['onTagReject'] = details => emit('tag-reject', details)\n    const ctx = useTagsInput(withXhConfig('tags-input', useFormControlProps(props)) as TagsInputProps, { onValueChange, onInputValueChange, onTagReject })\n    provideTagsInput(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      inputValue: ctx.api.value.inputValue,\n      empty: ctx.api.value.empty,\n      atMax: ctx.api.value.atMax,\n      overflow: ctx.api.value.overflow,\n      highlightedValue: ctx.api.value.highlightedValue,\n      editedValue: ctx.api.value.editedValue,\n      canClear: ctx.api.value.canClear,\n      setValue: ctx.api.value.setValue,\n      addValue: ctx.api.value.addValue,\n      deleteValue: ctx.api.value.deleteValue,\n      clear: ctx.api.value.clear,\n      setInputValue: ctx.api.value.setInputValue,\n      highlight: ctx.api.value.highlight,\n      edit: ctx.api.value.edit,\n    }))\n  },\n})\n\nexport const XhTagsInputLabel = defineComponent({\n  name: 'XhTagsInputLabel',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    // 用原生 label，getLabelProps 的 for 指向输入框\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagsInputControl = defineComponent({\n  name: 'XhTagsInputControl',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => h('div', { ...(ctx.api.value.getControlProps() as Record<string, unknown>), ref: ctx.controlRef }, slots.default?.())\n  },\n})\n\nexport const XhTagsInputInput = defineComponent({\n  name: 'XhTagsInputInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useTagsInputContext()\n    return () => h('input', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getInputProps() as Record<string, unknown> }))\n  },\n})\n\nexport const XhTagsInputItem = defineComponent({\n  name: 'XhTagsInputItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTagsInputContext()\n    const item = computed<TagsInputItemProps>(() => ({ value: props.value }))\n    provideTagsInputItem({ item })\n    // 本标签持有焦点时，value 变更或卸载都上报焦点离场以终止编辑会话\n    const itemEl = ref<HTMLElement | null>(null)\n    const holdsFocus = (): boolean => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return false\n      const active = service.scope.getActiveElement()\n      return !!itemEl.value && !!active && (itemEl.value === active || itemEl.value.contains(active))\n    }\n    watch(() => props.value, (next, prev) => {\n      if (next !== prev && holdsFocus())\n        ctx.service.send({ type: 'ITEM.FOCUS_LOST' })\n    })\n    onBeforeUnmount(() => {\n      if (holdsFocus())\n        ctx.service.send({ type: 'ITEM.FOCUS_LOST' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 标签的预览：渲染为库内 tag 的 root（data-scope=\"tag\"），就地编辑时由 tag 收起。 */\nexport const XhTagsInputItemPreview = defineComponent({\n  name: 'XhTagsInputItemPreview',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('span', ctx.api.value.getItemPreviewProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字：渲染为 tag 的 label，截断落在这一层。 */\nexport const XhTagsInputItemText = defineComponent({\n  name: 'XhTagsInputItemText',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 删除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；禁用与只读时保留位置、原生 disabled。 */\nexport const XhTagsInputItemDeleteTrigger = defineComponent({\n  name: 'XhTagsInputItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagsInputItemInput = defineComponent({\n  name: 'XhTagsInputItemInput',\n  setup() {\n    const ctx = useTagsInputContext()\n    const { item } = useTagsInputItemContext()\n    return () => h('input', ctx.api.value.getItemInputProps(item.value) as Record<string, unknown>)\n  },\n})\n\nexport const XhTagsInputClearTrigger = defineComponent({\n  name: 'XhTagsInputClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 计数：未写内容时渲染「已用 / 上限」，未设上限时只渲染已用。 */\nexport const XhTagsInputCount = defineComponent({\n  name: 'XhTagsInputCount',\n  slots: Object as SlotsType<{\n    default?: (props: TagsInputCountSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useTagsInputContext()\n    return () => {\n      const api = ctx.api.value\n      const fallback = api.max === undefined ? `${api.count}` : `${api.count} / ${api.max}`\n      return h(\n        'span',\n        api.getCountProps() as Record<string, unknown>,\n        slots.default?.({ count: api.count, max: api.max, atMax: api.atMax, overflow: api.overflow }) ?? fallback,\n      )\n    }\n  },\n})\n\nexport const XhTagsInputHiddenInput = defineComponent({\n  name: 'XhTagsInputHiddenInput',\n  setup() {\n    const ctx = useTagsInputContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
 import { TagsInputApi, TagsInputSchema } from "@xihan-ui/headless";
 //#region src/components/tags-input/use-tags-input.d.ts
@@ -6,8 +6,10 @@ interface TagsInputContext {
   api: ComputedRef<TagsInputApi>;
   /** 状态机实例，供部件上报 DOM 侧的事实（如标签节点带着焦点离场）。 */
   service: Service<TagsInputSchema>;
+  /** 标签所在的容器：列表动效接在它上面。 */
+  controlRef: Ref<HTMLElement | null>;
 }
-declare function useTagsInput(props: TagsInputSchema['props'], handlers?: Pick<TagsInputSchema['props'], 'onValueChange' | 'onInputValueChange'>): TagsInputContext;
+declare function useTagsInput(props: TagsInputSchema['props'], handlers?: Pick<TagsInputSchema['props'], 'onValueChange' | 'onInputValueChange' | 'onTagReject'>): TagsInputContext;
 //#endregion
 export { TagsInputContext, useTagsInput };
 //# sourceMappingURL=use-tags-input.d.ts.map

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;;iBAGH,aACd,OAAO,0BACP,WAAU,KAAK,oEACd"}
+{"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"}

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

@@ -1,7 +1,7 @@
 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 { 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
@@ -10,9 +10,12 @@ function useTagsInput(props, handlers = {}) {
 		...props,
 		...handlers
 	}), createScope(null, createVueIdGenerator()));
+	const controlRef = ref(null);
+	service.refs.set("getControlEl", () => controlRef.value);
 	return {
 		api: computed(() => connectTagsInput(service, vueNormalize)),
-		service
+		service,
+		controlRef
 	};
 }
 //#endregion

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 } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagsInput, tagsInputMachine } 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 TagsInputContext {\n  api: ComputedRef<TagsInputApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签节点带着焦点离场）。 */\n  service: Service<TagsInputSchema>\n}\n\nexport function useTagsInput(\n  props: TagsInputSchema['props'],\n  handlers: Pick<TagsInputSchema['props'], 'onValueChange' | 'onInputValueChange'> = {},\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 api = computed(() => connectTagsInput(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,aACd,OACA,WAAmF,CAAC,GAClE;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;EAAG;CAAQ;AACxB"}
+{"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"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 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, TimeSegmentType } from "@xihan-ui/headless";
+import { TimeGranularity, TimeHourCycle, TimePickerApi, TimePickerColumn, TimePickerColumnUnit, TimePickerPreset, TimePickerPresetState, TimePickerSchema, TimeSegmentType, TimeStep, TimeUnavailablePredicate } from "@xihan-ui/headless";
 //#region src/components/time-picker/time-picker.d.ts
 type TimePickerProps = TimePickerSchema['props'];
 /** 默认插槽的载荷：浮层开合与当前值、值状态标志、当前的段与列，以及开合、写值、清空的动作。 */
@@ -41,8 +41,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   granularity: {
     type: PropType<TimeGranularity>;
   };
-  step: {
-    type: NumberConstructor;
+  /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+  timeStep: {
+    type: PropType<TimeStep>;
   };
   /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
   presets: {
@@ -55,8 +56,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   translations: {
     type: PropType<TimePickerProps["translations"]>;
   };
+  /** 逐格可选性：时列按 24 小时制给值，第三个参数带已选的时与分。 */
   isTimeUnavailable: {
-    type: PropType<(value: string, unit: TimePickerColumnUnit) => boolean>;
+    type: PropType<TimeUnavailablePredicate>;
   };
   readOnly: {
     type: BooleanConstructor;
@@ -126,8 +128,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   granularity: {
     type: PropType<TimeGranularity>;
   };
-  step: {
-    type: NumberConstructor;
+  /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+  timeStep: {
+    type: PropType<TimeStep>;
   };
   /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
   presets: {
@@ -140,8 +143,9 @@ declare const XhTimePickerRoot: import("vue").DefineComponent<import("vue").Extr
   translations: {
     type: PropType<TimePickerProps["translations"]>;
   };
+  /** 逐格可选性：时列按 24 小时制给值，第三个参数带已选的时与分。 */
   isTimeUnavailable: {
-    type: PropType<(value: string, unit: TimePickerColumnUnit) => boolean>;
+    type: PropType<TimeUnavailablePredicate>;
   };
   readOnly: {
     type: BooleanConstructor;

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":";;;;;KAoCK,kBAAkB;;KAGX,0BAA0B,KACpC;;UAce;EACf,SAAS;;;UAIM;EACf,kBAAkB;;cAGP,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;IAWI,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAEH,MAAA,SAAS;;;IACF,MAAA,UAAU,eAAe,MAAM;;;;;;;;;;;;;;;;;;IAK3C,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IAzBJ,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAEH,MAAA,SAAS;;;IACF,MAAA,UAAU,eAAe,MAAM;;;;;;;;;;;;;;;;;;IAK3C,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,4BAA4B;kCA8BhD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAS9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;IAID,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAWtC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAe9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,8BAAA;;;IAIF,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAY9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;;;EAItB,WAAC,OAAO,+BAA+B;kCAoCnD;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;EAQjB,gBAAM;kCAclB;cAEW,kCAAkB,8BAAA;;IAGH,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;;EAGvB,WAAC,OAAO,8BAA8B;kCA6BlD;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;MAgB3B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"time-picker.d.ts","names":[],"sources":["../../../src/components/time-picker/time-picker.ts"],"mappings":";;;;;KAsCK,kBAAkB;;KAGX,0BAA0B,KACpC;;UAce;EACf,SAAS;;;UAIM;EACf,kBAAkB;;cAGP,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;IAWI,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAEH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAKrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IA3BJ,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;IAEZ,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;;;;;IAEH,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAKrB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,4BAA4B;kCA8BhD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAS9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;IAID,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAWtC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAe9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,8BAAA;;;IAIF,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAY9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;;;EAItB,WAAC,OAAO,+BAA+B;kCAoCnD;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;EAQjB,gBAAM;kCAclB;cAEW,kCAAkB,8BAAA;;IAGH,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;;EAGvB,WAAC,OAAO,8BAA8B;kCA6BlD;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;MAgB3B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,9 +1,9 @@
 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 { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { slotPaints } from "../../runtime/slot-content.js";
 import { provideTimePicker, provideTimePickerColumn, useTimePickerColumnContext, useTimePickerContext } from "./context.js";
 import { useTimePicker } from "./use-time-picker.js";
 import { computed, defineComponent, h, mergeProps, onUpdated, ref } from "vue";
@@ -23,7 +23,8 @@ const XhTimePickerRoot = defineComponent({
 		locale: { type: String },
 		hourCycle: { type: Number },
 		granularity: { type: String },
-		step: { type: Number },
+		/** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+		timeStep: { type: Object },
 		/** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
 		presets: { type: Array },
 		disabled: {
@@ -31,6 +32,7 @@ const XhTimePickerRoot = defineComponent({
 			default: void 0
 		},
 		translations: { type: Object },
+		/** 逐格可选性：时列按 24 小时制给值，第三个参数带已选的时与分。 */
 		isTimeUnavailable: { type: Function },
 		readOnly: {
 			type: Boolean,

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  TimeSegmentType,\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 { slotPaints } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTimePicker,\n  provideTimePickerColumn,\n  useTimePickerColumnContext,\n  useTimePickerContext,\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  | 'setOpen'\n  | 'setValue'\n  | 'clear'\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    value: { type: String },\n    defaultValue: { type: String },\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    step: { type: Number },\n    /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */\n    presets: { type: Array as PropType<TimePickerPreset[]> },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<TimePickerProps['translations']> },\n    isTimeUnavailable: { type: Function as PropType<(value: string, unit: TimePickerColumnUnit) => boolean> },\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    '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(withXhConfig('time-picker', useFormControlProps(props)) 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      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\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\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 }, () => [\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\nexport const XhTimePickerHiddenInput = defineComponent({\n  name: 'XhTimePickerHiddenInput',\n  setup() {\n    const ctx = useTimePickerContext()\n    return () => 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  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 { slotPaints } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideTimePicker,\n  provideTimePickerColumn,\n  useTimePickerColumnContext,\n  useTimePickerContext,\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  | 'setOpen'\n  | 'setValue'\n  | 'clear'\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    value: { type: String },\n    defaultValue: { type: String },\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    '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(withXhConfig('time-picker', useFormControlProps(props)) 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      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\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\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 }, () => [\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\nexport const XhTimePickerHiddenInput = defineComponent({\n  name: 'XhTimePickerHiddenInput',\n  setup() {\n    const ctx = useTimePickerContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;;;;;;AAiEA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAO;EAC7B,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,KAAK,EAAE,MAAM,OAAO;EACpB,KAAK,EAAE,MAAM,OAAO;EACpB,QAAQ,EAAE,MAAM,OAAO;EACvB,WAAW,EAAE,MAAM,OAAkC;EACrD,aAAa,EAAE,MAAM,OAAoC;;EAEzD,UAAU,EAAE,MAAM,OAA6B;;EAE/C,SAAS,EAAE,MAAM,MAAsC;EACvD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,cAAc,EAAE,MAAM,OAAoD;;EAE1E,mBAAmB,EAAE,MAAM,SAA+C;EAC1E,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM,EAAE,MAAM,OAAO;EACrB,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,WAAW,EAAE,MAAM,OAA8B;EACjD,QAAQ,EAAE,MAAM,OAAO;;EAEvB,KAAK,EAAE,MAAM,OAA8B;CAC7C;CAEA,OAAO;EACL,iBAAiB,aAA0D;EAC3E,gBAAgB,aAAyD;EACzE,iBAAiB,WAAiE;EAClF,gBAAgB,UAA8D;CAChF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,eAAiD,YAAY;GACjE,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,cAA+C,YAAY;GAC/D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,cAAc,aAAa,eAAe,oBAAoB,KAAK,CAAC,GAAsB;GACpG,eAAe;GACf,cAAc;EAChB,CAAC;EACD,kBAAkB,GAAG;EAErB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,OAAO,IAAI,IAAI,MAAM;GACrB,OAAO,IAAI,IAAI,MAAM;GACrB,YAAY,IAAI,IAAI,MAAM;GAC1B,UAAU,IAAI,IAAI,MAAM;GACxB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,OAAO,IAAI,IAAI,MAAM;EACvB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC1G;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO,EAEL,SAAS;EAAE,MAAM;EAAqC,UAAU;CAAK,EACvE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,gBAAgB,EAAE,SAAS,MAAM,QAAQ,CAAC,GACxD,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,eAAe,EAAE,SAAS,MAAM,QAAQ,CAAC,CAC9E;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAElB,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EACvC,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,UAAU,WAAW,MAAM;GACxC,GAAG,YAAY;GACf,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAEjC,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,CAAC,GAAG,MAAM,UAAU,CAAC;CACvB;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,OAAO;;AAEL,WAAW,EAAE,MAAM,OAA4B,EACjD;CAEA,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,UAAU;GAAE,IAAI,MAAM,aAAa,IAAI,aAAa;GAAO,QAAQ,IAAI;EAAW,SAAS,CACxG,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC;CACH;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,OAAO;CAKP,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,qBAAqB;EACjC,MAAM,iBAAiB,IAAwB,IAAI;EAEnD,MAAM,OAAO,cAAc;GACzB,kBAAkB,eAAe;GACjC,QAAQ;GACR,cAAc;IAAE,KAAM,IAAI,IAAI,MAAM,mBAAmB,CAAC,CAAyB;IAAK,MAAM;GAAK;EACnG,CAAC;EACD,gBAAgB,KAAK,QAAQ,CAAC;EAC9B,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,WAAW,MAAM,UAAU,EAAE,SAAS,IAAI,QAAQ,CAAC;GACzD,OAAO,CACL,EACE,OACA;IACE,GAAG,WAAW,IAAI,oBAAoB,GAA8B,KAAK;IACzE,MAAM,OAAgB;KAAE,eAAe,QAAQ;IAAkB;GACnE,GACA,WAAW,QAAQ,IACf,WACA,IAAI,QAAQ,KAAI,WAAU,EACxB,OACA;IAAE,GAAG,IAAI,eAAe,EAAE,OAAO,OAAO,MAAM,CAAC;IAA8B,KAAK,OAAO;GAAM,GAC/F,OAAO,KACT,CAAC,CACP,GACA,GAAG,KAAK,OAAO,CACjB;EACF;CACF;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;AAEL,OAAO;EAAE,MAAM;EAAQ,UAAU;CAAK,EACxC;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,WAAW,MAAM,UAAU;GACjC,OAAO,EACL,OACA,IAAI,eAAe,EAAE,OAAO,MAAM,MAAM,CAAC,GACzC,WAAW,QAAQ,IAAI,WAAW,IAAI,QAAQ,MAAK,MAAK,EAAE,UAAU,MAAM,KAAK,CAAC,EAAE,KACpF;EACF;CACF;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO,EACL,MAAM;EAAE,MAAM;EAA0C,UAAU;CAAK,EACzE;CACA,OAAO;CAIP,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,qBAAqB;EAGjC,wBAAwB,EAAE,MAFb,eAAe,MAAM,IAEL,EAAE,CAAC;EAChC,MAAM,YAAY,IAAwB,IAAI;EAE9C,MAAM,OAAO,cAAc;GACzB,kBAAkB,UAAU;GAC5B,QAAQ;GACR,cAAc;IAAE,KAAM,IAAI,IAAI,MAAM,mBAAmB,CAAC,CAAyB;IAAK,MAAM;GAAK;EACnG,CAAC;EACD,gBAAgB,KAAK,QAAQ,CAAC;EAC9B,aAAa,CACX,EACE,OACA;GACE,GAAG,WAAW,IAAI,IAAI,MAAM,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC,GAA8B,KAAK;GAClG,MAAM,OAAgB;IAAE,UAAU,QAAQ;GAAkB;EAC9D,GACA,MAAM,UAAU,EAAE,SAAS,IAAI,IAAI,MAAM,QAAQ,MAAK,MAAK,EAAE,SAAS,MAAM,IAAI,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CACpG,GACA,GAAG,KAAK,OAAO,CACjB;CACF;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;;AAEL,OAAO;EAAE,MAAM;EAAQ,UAAU;CAAK,EACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,SAAS,2BAA2B;EAE5C,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa;GAAE,MAAM,KAAK;GAAO,OAAO,MAAM;EAAM,CAAC,GACnE,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YAAY;GAAE,MAAM,KAAK;GAAO,OAAO,MAAM;EAAM,CAAC,CACzF;CACF;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,CAA4B;CACxF;AACF,CAAC"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { TimeGranularity, TimeHourCycle, TimePickerColumn, TimePickerColumnUnit, TimeRangePickerApi, TimeRangePickerEndIndex, TimeRangePickerPreset, TimeRangePickerPresetState, TimeRangePickerSchema, TimeSegmentType } from "@xihan-ui/headless";
+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'];
 /** 默认插槽的载荷：浮层开合与两端、值状态标志、当前的段与两组时列，以及开合、写值、清空的动作。 */
@@ -46,8 +46,9 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   granularity: {
     type: PropType<TimeGranularity>;
   };
-  step: {
-    type: NumberConstructor;
+  /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+  timeStep: {
+    type: PropType<TimeStep>;
   };
   /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
   presets: {
@@ -60,8 +61,9 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   translations: {
     type: PropType<TimeRangePickerProps["translations"]>;
   };
+  /** 逐格可选性：时列按 24 小时制给值，第三个参数带这一端已选的时分与端号。 */
   isTimeUnavailable: {
-    type: PropType<(value: string, unit: TimePickerColumnUnit, index: TimeRangePickerEndIndex) => boolean>;
+    type: PropType<TimeUnavailablePredicate>;
   };
   readOnly: {
     type: BooleanConstructor;
@@ -135,8 +137,9 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   granularity: {
     type: PropType<TimeGranularity>;
   };
-  step: {
-    type: NumberConstructor;
+  /** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+  timeStep: {
+    type: PropType<TimeStep>;
   };
   /** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
   presets: {
@@ -149,8 +152,9 @@ declare const XhTimeRangePickerRoot: import("vue").DefineComponent<import("vue")
   translations: {
     type: PropType<TimeRangePickerProps["translations"]>;
   };
+  /** 逐格可选性：时列按 24 小时制给值，第三个参数带这一端已选的时分与端号。 */
   isTimeUnavailable: {
-    type: PropType<(value: string, unit: TimePickerColumnUnit, index: TimeRangePickerEndIndex) => boolean>;
+    type: PropType<TimeUnavailablePredicate>;
   };
   readOnly: {
     type: BooleanConstructor;

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":";;;;;KAwCK,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;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;IACF,MAAA,UAAU,eAAe,MAAM,sBAAsB,OAAO;;;;;;;;;;;;;;;;;;;;;IAOxE,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;IAnCT,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;IAMF,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGd,MAAA,SAAS;;;;;;;IAGH,MAAA,SAAS;;;IACF,MAAA,UAAU,eAAe,MAAM,sBAAsB,OAAO;;;;;;;;;;;;;;;;;;;;;IAOxE,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;EAUtB,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":";;;;;KA0CK,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;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;IArCT,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;;;;;;;;;;;;;;;EAUtB,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"}

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

@@ -1,9 +1,9 @@
 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 { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { slotPaints } from "../../runtime/slot-content.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";
@@ -25,7 +25,8 @@ const XhTimeRangePickerRoot = defineComponent({
 		locale: { type: String },
 		hourCycle: { type: Number },
 		granularity: { type: String },
-		step: { type: Number },
+		/** 按单位的步进：`{ hour?, minute?, second? }`，各单位缺省 1。 */
+		timeStep: { type: Object },
 		/** 快捷选项；提供后浮层中多出一列，时刻要在自己的 computed 中计算后再传入。 */
 		presets: { type: Array },
 		disabled: {
@@ -33,6 +34,7 @@ const XhTimeRangePickerRoot = defineComponent({
 			default: void 0
 		},
 		translations: { type: Object },
+		/** 逐格可选性：时列按 24 小时制给值，第三个参数带这一端已选的时分与端号。 */
 		isTimeUnavailable: { type: Function },
 		readOnly: {
 			type: Boolean,