@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/tabs/tabs.js.map

@@ -1 +1 @@
-{"version":3,"file":"tabs.js","names":[],"sources":["../../../src/components/tabs/tabs.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// 提供 tabs 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TabsActivationMode, TabsNode, TabsNodeMeta, TabsSchema, TabsVariant } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { tabsOverflowMenuProps } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { XhMenuRoot } from '../menu/menu'\nimport { provideTabs, useTabsContext } from './context'\nimport { useTabs } from './use-tabs'\n\ntype TabsProps = TabsSchema['props']\n\nexport const XhTabsRoot = defineComponent({\n  name: 'XhTabsRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TabsNode[]> },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    activationMode: { type: String as PropType<TabsActivationMode> },\n    loop: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<TabsVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    /** 标签可以拖动换位。整个标签都是拖动源，不另设把手。 */\n    reorderable: Boolean,\n    /** 标签可关闭：点 close-trigger，或焦点落在标签上按 Delete / Backspace，即触发 tab-close。 */\n    closable: Boolean,\n    /** 面板内容等到对应标签第一次被选中才渲染。 */\n    lazyMount: Boolean,\n    /** 标签被选走后卸掉面板内容。 */\n    unmountOnExit: Boolean,\n    translations: { type: Object as PropType<TabsProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<TabsProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TabsProps, 'onValueChange'>['value']) => true,\n    // 换位是通知，标签序的真源在使用者的数据里，故没有配对的 update:*\n    'tab-move': (_details: PayloadOf<TabsProps, 'onTabMove'>) => true,\n    // 关闭同理：库不持有标签序，只发意图\n    'tab-close': (_details: PayloadOf<TabsProps, 'onTabClose'>) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: TabsProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    // 监听器不进 props 对象，故作为位置参数交给 useTabs，不能指望 { ...props } 带上\n    const onTabMove: TabsProps['onTabMove'] = (details) => {\n      emit('tab-move', details)\n    }\n    const onTabClose: TabsProps['onTabClose'] = (details) => {\n      emit('tab-close', details)\n    }\n    const ctx = useTabs(withXhConfig('tabs', props) as TabsProps, notify, onTabMove, onTabClose)\n    provideTabs(ctx)\n    return () => {\n      // 默认插槽里有真内容就照旧交给作者；只剩注释或空白时当没写，给了 collection 就按数据铺开整套结构\n      const authored = slots.default?.()\n      const children = slotPaints(authored)\n        ? authored\n        : (props.collection ? renderDefaultTree(ctx.api.value.collection, props.closable, slots.panel) : undefined)\n      return h('div', ctx.api.value.getRootProps() as Record<string, unknown>, children)\n    }\n  },\n})\n\nexport const XhTabsList = defineComponent({\n  name: 'XhTabsList',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('div', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.listRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 选中标签下的滑条：位置由状态机测量后写入内联样式；位于 list 中，以 list 为定位参照系 */\nexport const XhTabsIndicator = defineComponent({\n  name: 'XhTabsIndicator',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h('div', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 标签之间的细分隔线，纯装饰 */\nexport const XhTabsSeparator = defineComponent({\n  name: 'XhTabsSeparator',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 标签带的往前翻页钮：标签带放不下时露面，贴在起始端；没塞内容时由皮肤画一枚 chevron。\n * 放在 list 里、与标签平级；对读屏隐藏、不占 Tab 位——键盘用方向键在标签间移动即可。\n */\nexport const XhTabsPrevTrigger = defineComponent({\n  name: 'XhTabsPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签带的往后翻页钮：与 XhTabsPrevTrigger 成对，贴在结束端。 */\nexport const XhTabsNextTrigger = defineComponent({\n  name: 'XhTabsNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签带之后的「更多」钮：标签带放不下时露面，弹出的下拉列出此刻没有整个露在可见区里的标签，\n * 选中一项即选中那个标签并把它挪进可见区；放得下时收着。放在 root 里、紧跟 XhTabsList 之后（不放进 list：\n * tablist 只收 tab），自占一个 Tab 位。它同时是一张 Menu 的触发器——下拉的条目与落位由标签页的机器现给\n * （tabsOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖不让位。不写内容时由皮肤画一枚横排三点。\n */\nexport const XhTabsOverflowTrigger = defineComponent({\n  name: 'XhTabsOverflowTrigger',\n  // 直通属性合到钮上，而不是落到菜单的根组件上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTabsContext()\n    return () => h(XhMenuRoot, { ...tabsOverflowMenuProps(ctx.service), triggerAsChild: true }, {\n      trigger: () => [h('button', mergePartProps(ctx.api.value.getOverflowTriggerProps() as Record<string, unknown>, attrs), slots.default?.())],\n    })\n  },\n})\n\n/**\n * 拖动过程的读屏播报区，视觉上不可见。\n *\n * 放在 root 中、与 list 部件平级。它必须在拖动开始之前就在 DOM 上：\n * 读屏不播报后插入的节点，等到拖起才渲染等于没有。\n */\nexport const XhTabsLiveRegion = defineComponent({\n  name: 'XhTabsLiveRegion',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h(\n      'div',\n      ctx.api.value.getLiveRegionProps() as Record<string, unknown>,\n      ctx.service.context.get('announcement'),\n    )\n  },\n})\n\nexport const XhTabsTrigger = defineComponent({\n  name: 'XhTabsTrigger',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    // 本节点持有焦点时，value 变更重报焦点标签，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'TRIGGER.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      if (ctx.service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && ctx.service.scope.getActiveElement() === itemEl.value)\n        ctx.service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'button',\n      { ...ctx.api.value.getTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 标签的关闭钮：紧跟在所属 XhTabsTrigger 之后、与它平级，写同一个 value；没塞内容时由皮肤画一枚叉。\n * 对读屏隐藏、不占 Tab 位——键盘用标签上的 Delete / Backspace。closable 关闭时收起。\n */\nexport const XhTabsCloseTrigger = defineComponent({\n  name: 'XhTabsCloseTrigger',\n  props: {\n    /** 所属标签的 value。 */\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，与所属标签同一条来路\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    return () => h(\n      'button',\n      ctx.api.value.getCloseTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 标签拖拽把手。放在标签中，自带 touch-action: none，按下即拖动，不等待激活距离。\n * 对读屏隐藏、也不占 Tab 位；键盘换位由标签上的 Alt + 方向键承担。\n * 整个标签拖动的路径照常可用，把手是叠加的第二个入口。\n */\nexport const XhTabsTabDragTrigger = defineComponent({\n  name: 'XhTabsTabDragTrigger',\n  props: {\n    /** 所属标签的 value。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    return () => h(\n      'span',\n      ctx.api.value.getTabDragTriggerProps({ value: props.value }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTabsContent = defineComponent({\n  name: 'XhTabsContent',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    // 面板节点常在；里面的内容按 lazyMount / unmountOnExit 由 connect 判定渲不渲染\n    return () => h(\n      'div',\n      ctx.api.value.getContentProps({ value: props.value }) as Record<string, unknown>,\n      ctx.api.value.isContentMounted(props.value) ? slots.default?.() : undefined,\n    )\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 面板内容经 panel 插槽，未写时为空面板。可关闭时每个标签后面跟一枚关闭钮。\n */\nfunction renderDefaultTree(\n  collection: readonly TabsNodeMeta[],\n  closable: boolean,\n  panelSlot?: (node: TabsNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhTabsList, null, () => collection.flatMap(node => [\n      h(XhTabsTrigger, { key: node.value, value: node.value }, () => node.label),\n      ...(closable ? [h(XhTabsCloseTrigger, { key: `${node.value}:close`, value: node.value })] : []),\n    ])),\n    ...collection.map(node =>\n      h(XhTabsContent, { key: node.value, value: node.value }, () => panelSlot?.(node) ?? []),\n    ),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"tabs.js","names":[],"sources":["../../../src/components/tabs/tabs.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// 提供 tabs 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TabsActivationMode, TabsApi, TabsNode, TabsNodeMeta, TabsSchema, TabsVariant } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { tabsOverflowMenuProps, tabsStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { XhMenuRoot } from '../menu/menu'\nimport { provideTabs, useTabsContext } from './context'\nimport { useTabs } from './use-tabs'\n\ntype TabsProps = TabsSchema['props']\n\nexport const XhTabsRoot = defineComponent({\n  name: 'XhTabsRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TabsNode[]> },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    activationMode: { type: String as PropType<TabsActivationMode> },\n    loop: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<TabsVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    /** 标签可以拖动换位。整个标签都是拖动源，不另设把手。 */\n    reorderable: Boolean,\n    /** 标签可关闭：点 close-trigger，或焦点落在标签上按 Delete / Backspace，即触发 tab-close。 */\n    closable: Boolean,\n    /** 面板内容等到对应标签第一次被选中才渲染。 */\n    lazyMount: Boolean,\n    /** 标签被选走后卸掉面板内容。 */\n    unmountOnExit: Boolean,\n    translations: { type: Object as PropType<TabsProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<TabsProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TabsProps, 'onValueChange'>['value']) => true,\n    // 换位是通知，标签序的真源在使用者的数据里，故没有配对的 update:*\n    'tab-move': (_details: PayloadOf<TabsProps, 'onTabMove'>) => true,\n    // 关闭同理：库不持有标签序，只发意图\n    'tab-close': (_details: PayloadOf<TabsProps, 'onTabClose'>) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: TabsProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    // 监听器不进 props 对象，故作为位置参数交给 useTabs，不能指望 { ...props } 带上\n    const onTabMove: TabsProps['onTabMove'] = (details) => {\n      emit('tab-move', details)\n    }\n    const onTabClose: TabsProps['onTabClose'] = (details) => {\n      emit('tab-close', details)\n    }\n    const ctx = useTabs(withXhConfig('tabs', props) as TabsProps, notify, onTabMove, onTabClose)\n    provideTabs(ctx)\n    return () => {\n      // 默认插槽里有真内容就照旧交给作者；只剩注释或空白时当没写，照标准结构按数据铺开\n      const authored = slots.default?.()\n      const children = slotPaints(authored)\n        ? authored\n        : renderDefaultStructure(ctx.api.value, props.closable, slots.panel)\n      return h('div', ctx.api.value.getRootProps() as Record<string, unknown>, children)\n    }\n  },\n})\n\nexport const XhTabsList = defineComponent({\n  name: 'XhTabsList',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('div', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.listRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 选中标签下的滑条：位置由状态机测量后写入内联样式；位于 list 中，以 list 为定位参照系 */\nexport const XhTabsIndicator = defineComponent({\n  name: 'XhTabsIndicator',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h('div', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 标签之间的细分隔线，纯装饰 */\nexport const XhTabsSeparator = defineComponent({\n  name: 'XhTabsSeparator',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 标签带的往前翻页钮：标签带放不下时露面，贴在起始端；没塞内容时由皮肤画一枚 chevron。\n * 放在 list 里、与标签平级；对读屏隐藏、不占 Tab 位——键盘用方向键在标签间移动即可。\n */\nexport const XhTabsPrevTrigger = defineComponent({\n  name: 'XhTabsPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签带的往后翻页钮：与 XhTabsPrevTrigger 成对，贴在结束端。 */\nexport const XhTabsNextTrigger = defineComponent({\n  name: 'XhTabsNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useTabsContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签带之后的「更多」钮：标签带放不下时露面，弹出的下拉列出此刻没有整个露在可见区里的标签，\n * 选中一项即选中那个标签并把它挪进可见区；放得下时收着。放在 root 里、紧跟 XhTabsList 之后（不放进 list：\n * tablist 只收 tab），自占一个 Tab 位。它同时是一张 Menu 的触发器——下拉的条目与落位由标签页的机器现给\n * （tabsOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖不让位。不写内容时由皮肤画一枚横排三点。\n */\nexport const XhTabsOverflowTrigger = defineComponent({\n  name: 'XhTabsOverflowTrigger',\n  // 直通属性合到钮上，而不是落到菜单的根组件上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useTabsContext()\n    return () => h(XhMenuRoot, { ...tabsOverflowMenuProps(ctx.service), triggerAsChild: true }, {\n      trigger: () => [h('button', mergePartProps(ctx.api.value.getOverflowTriggerProps() as Record<string, unknown>, attrs), slots.default?.())],\n    })\n  },\n})\n\n/**\n * 拖动过程的读屏播报区，视觉上不可见。\n *\n * 放在 root 中、与 list 部件平级。它必须在拖动开始之前就在 DOM 上：\n * 读屏不播报后插入的节点，等到拖起才渲染等于没有。\n */\nexport const XhTabsLiveRegion = defineComponent({\n  name: 'XhTabsLiveRegion',\n  setup() {\n    const ctx = useTabsContext()\n    return () => h(\n      'div',\n      ctx.api.value.getLiveRegionProps() as Record<string, unknown>,\n      ctx.service.context.get('announcement'),\n    )\n  },\n})\n\nexport const XhTabsTrigger = defineComponent({\n  name: 'XhTabsTrigger',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    // 本节点持有焦点时，value 变更重报焦点标签，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'TRIGGER.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      if (ctx.service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && ctx.service.scope.getActiveElement() === itemEl.value)\n        ctx.service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'button',\n      { ...ctx.api.value.getTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 标签的关闭钮：紧跟在所属 XhTabsTrigger 之后、与它平级，写同一个 value；没塞内容时由皮肤画一枚叉。\n * 对读屏隐藏、不占 Tab 位——键盘用标签上的 Delete / Backspace。closable 关闭时收起。\n */\nexport const XhTabsCloseTrigger = defineComponent({\n  name: 'XhTabsCloseTrigger',\n  props: {\n    /** 所属标签的 value。 */\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，与所属标签同一条来路\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    return () => h(\n      'button',\n      ctx.api.value.getCloseTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 标签拖拽把手。放在标签中，自带 touch-action: none，按下即拖动，不等待激活距离。\n * 对读屏隐藏、也不占 Tab 位；键盘换位由标签上的 Alt + 方向键承担。\n * 整个标签拖动的路径照常可用，把手是叠加的第二个入口。\n */\nexport const XhTabsTabDragTrigger = defineComponent({\n  name: 'XhTabsTabDragTrigger',\n  props: {\n    /** 所属标签的 value。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    return () => h(\n      'span',\n      ctx.api.value.getTabDragTriggerProps({ value: props.value }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTabsContent = defineComponent({\n  name: 'XhTabsContent',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTabsContext()\n    // 面板节点常在；里面的内容按 lazyMount / unmountOnExit 由 connect 判定渲不渲染\n    return () => h(\n      'div',\n      ctx.api.value.getContentProps({ value: props.value }) as Record<string, unknown>,\n      ctx.api.value.isContentMounted(props.value) ? slots.default?.() : undefined,\n    )\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst TABS_PARTS = {\n  'list': XhTabsList,\n  'trigger': XhTabsTrigger,\n  'close-trigger': XhTabsCloseTrigger,\n  'content': XhTabsContent,\n}\n\n/**\n * 未写默认插槽时照 tabsStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。\n * 面板内容经 panel 插槽，未写时为空面板。可关闭时每个标签后面跟一枚关闭钮。\n */\nfunction renderDefaultStructure(api: TabsApi, closable: boolean, panelSlot?: (node: TabsNodeMeta) => VNode[]): VNode[] {\n  const nodes = tabsStructure(api, { closable, slotted: name => name === 'panel' && panelSlot != null })\n  return renderStructure(nodes, TABS_PARTS, node =>\n    node.slot?.name === 'panel' ? panelSlot?.(node.data as TabsNodeMeta) : undefined)\n}\n"],"mappings":"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"}

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

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

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectTabs, tabsMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectTabs, tabsMachine } from "@xihan-ui/headless";
 //#region src/components/tabs/use-tabs.ts
 function useTabs(props, onValueChange, onTabMove, onTabClose) {
 	const scope = createScope(null, createVueIdGenerator());

package/dist/components/tag/tag.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TagSchema, TagTranslations, TagVariant } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { TagSchema, TagTranslations, TagVariant } from "@xihan-ui/headless";
 //#region src/components/tag/tag.d.ts
 type TagProps = TagSchema['props'];
 declare const XhTagLabel: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { TagApi, TagSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/tag/use-tag.d.ts
 interface TagContext {
   api: ComputedRef<TagApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectStaticTag, connectTag, tagMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectStaticTag, connectTag, tagMachine } from "@xihan-ui/headless";
 //#region src/components/tag/use-tag.ts
 function useTag(props, onOpenChange) {
 	if (!props.closable) {

package/dist/components/tag-group/context.d.ts

@@ -1,6 +1,6 @@
 import { TagGroupContext } from "./use-tag-group.js";
-import { ComputedRef } from "vue";
 import { TagGroupItemProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/tag-group/context.d.ts
 /** 条目声明的值、禁用与可移除，供 cell / item-text / item-delete-trigger 复用同一份声明。 */
 interface TagGroupItemContext {

package/dist/components/tag-group/tag-group.d.ts

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TagGroupApi, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { TagGroupApi, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } from "@xihan-ui/headless";
 //#region src/components/tag-group/tag-group.d.ts
 type TagGroupProps = TagGroupSchema['props'];
 /** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换、移除的命令。 */
 type TagGroupRootSlotProps = Pick<TagGroupApi, 'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle' | 'deleteItem'>;
 declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<TagGroupNode[]>;
   };
@@ -32,6 +36,16 @@ declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 校验失败：标签列表报告 aria-invalid，根与列表带 data-invalid。 */
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 必填：根与列表带 data-required。 */
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loop: {
     type: BooleanConstructor;
     default: undefined;
@@ -65,6 +79,10 @@ declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").Extrac
   'update:value': (_value: PayloadOf<TagGroupProps, "onValueChange">["value"]) => true;
   'item-delete': (_details: PayloadOf<TagGroupProps, "onItemDelete">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<TagGroupNode[]>;
   };
@@ -90,6 +108,16 @@ declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 校验失败：标签列表报告 aria-invalid，根与列表带 data-invalid。 */
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 必填：根与列表带 data-required。 */
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loop: {
     type: BooleanConstructor;
     default: undefined;
@@ -121,6 +149,8 @@ declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").Extrac
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
   "onItem-delete"?: ((_details: import("@xihan-ui/headless").TagGroupItemDeleteDetails) => any) | undefined;
 }>, {
+  required: boolean;
+  invalid: boolean;
   loop: boolean;
   disabled: boolean;
   readOnly: boolean;
@@ -173,7 +203,7 @@ declare const XhTagGroupItem: import("vue").DefineComponent<import("vue").Extrac
 declare const XhTagGroupCell: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */
+/** 选中标记：落在格子内、文字之后与摘除钮之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */
 declare const XhTagGroupItemIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/tag-group/tag-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/tag-group.ts"],"mappings":";;;;;KAiBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;;;IAvBP,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;EAUvC,WAAC,OAAO,0BAA0B;EACpC,cAAM;EACP,QAAC,MAAM,qBAAqB;kCAiCrC;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAyCzB;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/tag-group.ts"],"mappings":";;;;;KAoBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;;;;;IAMM,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;IASnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;;;;;;;IA3BP,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;IASnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,0BAA0B;EACpC,cAAM;EACP,QAAC,MAAM,qBAAqB;kCA2BrC;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAW1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BASzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAyCzB;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,12 +1,17 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext } from "./context.js";
 import { useTagGroup } from "./use-tag-group.js";
-import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+import { tagGroupStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onBeforeUnmount, onUnmounted, ref, watch } from "vue";
 //#region src/components/tag-group/tag-group.ts
 const XhTagGroupRoot = defineComponent({
 	name: "XhTagGroupRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
 		label: { type: String },
@@ -22,6 +27,16 @@ const XhTagGroupRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 校验失败：标签列表报告 aria-invalid，根与列表带 data-invalid。 */
+		invalid: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 必填：根与列表带 data-required。 */
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		loop: {
 			type: Boolean,
 			default: void 0
@@ -62,13 +77,20 @@ const XhTagGroupRoot = defineComponent({
 			select: ctx.api.value.select,
 			toggle: ctx.api.value.toggle,
 			deleteItem: ctx.api.value.deleteItem
-		}) ?? [] : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.item) : []]);
+		}) ?? [] : renderDefaultStructure(ctx.api.value, props.label, {
+			label: slots.label,
+			item: slots.item
+		})]);
 	}
 });
 const XhTagGroupLabel = defineComponent({
 	name: "XhTagGroupLabel",
 	setup(_, { slots }) {
 		const ctx = useTagGroupContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -76,7 +98,12 @@ const XhTagGroupList = defineComponent({
 	name: "XhTagGroupList",
 	setup(_, { slots }) {
 		const ctx = useTagGroupContext();
-		return () => h("div", ctx.api.value.getListProps(), slots.default?.());
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
+		return () => h("div", fieldLabel.value({
+			...fieldWiring.value,
+			...ctx.api.value.getListProps()
+		}), slots.default?.());
 	}
 });
 /** 一个标签：渲染为 tag 的 root（data-scope="tag"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */
@@ -133,7 +160,7 @@ const XhTagGroupCell = defineComponent({
 		return () => h("span", ctx.api.value.getCellProps(item.value), slots.default?.());
 	}
 });
-/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */
+/** 选中标记：落在格子内、文字之后与摘除钮之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */
 const XhTagGroupItemIndicator = defineComponent({
 	name: "XhTagGroupItemIndicator",
 	setup(_, { slots }) {
@@ -160,19 +187,32 @@ const XhTagGroupItemDeleteTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getItemDeleteTriggerProps(item.value), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件；标签、标签文字与摘除钮委派给 tag，按「tag/部件名」找。 */
+const TAG_GROUP_PARTS = {
+	"label": XhTagGroupLabel,
+	"list": XhTagGroupList,
+	"tag/item": XhTagGroupItem,
+	"cell": XhTagGroupCell,
+	"tag/item-text": XhTagGroupItemText,
+	"item-indicator": XhTagGroupItemIndicator,
+	"tag/item-delete-trigger": XhTagGroupItemDeleteTrigger
+};
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽。
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 tagGroupStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题与标签文字由对应插槽接管。
 */
-function renderDefaultTree(collection, label, itemSlot) {
-	return [...label ? [h(XhTagGroupLabel, null, () => label)] : [], h(XhTagGroupList, null, () => collection.map((node) => h(XhTagGroupItem, {
-		key: node.value,
-		value: node.value
-	}, () => [h(XhTagGroupCell, null, () => [
-		h(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),
-		h(XhTagGroupItemIndicator),
-		h(XhTagGroupItemDeleteTrigger)
-	])])))];
+function renderDefaultStructure(api, label, authored) {
+	return renderStructure(tagGroupStructure(api, {
+		label,
+		slotted: (name) => authored[name] != null
+	}), TAG_GROUP_PARTS, (node) => {
+		const meta = node.data;
+		switch (node.slot?.name) {
+			case "label": return authored.label?.();
+			case "item": return authored.item?.(meta) ?? meta.label;
+			default: return;
+		}
+	});
 }
 //#endregion
 export { XhTagGroupCell, XhTagGroupItem, XhTagGroupItemDeleteTrigger, XhTagGroupItemIndicator, XhTagGroupItemText, XhTagGroupLabel, XhTagGroupList, XhTagGroupRoot };

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(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n          h(XhTagGroupItemIndicator),\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 { tagGroupStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onBeforeUnmount, onUnmounted, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\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    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\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    /** 校验失败：标签列表报告 aria-invalid，根与列表带 data-invalid。 */\n    invalid: { type: Boolean, default: undefined },\n    /** 必填：根与列表带 data-required。 */\n    required: { 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        : renderDefaultStructure(ctx.api.value, props.label, { label: slots.label, item: slots.item })),\n    ])\n  },\n})\n\nexport const XhTagGroupLabel = defineComponent({\n  name: 'XhTagGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\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    // 放进表单字段时，字段的标题与说明接到标签列表上：读屏进列表时念字段名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...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/** 标准结构里各部件对应的组件；标签、标签文字与摘除钮委派给 tag，按「tag/部件名」找。 */\nconst TAG_GROUP_PARTS = {\n  'label': XhTagGroupLabel,\n  'list': XhTagGroupList,\n  'tag/item': XhTagGroupItem,\n  'cell': XhTagGroupCell,\n  'tag/item-text': XhTagGroupItemText,\n  'item-indicator': XhTagGroupItemIndicator,\n  'tag/item-delete-trigger': XhTagGroupItemDeleteTrigger,\n}\n\ninterface TagGroupStructureSlots {\n  label?: () => VNode[]\n  item?: (node: TagGroupNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 tagGroupStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题与标签文字由对应插槽接管。\n */\nfunction renderDefaultStructure(api: TagGroupApi, label: string | undefined, authored: TagGroupStructureSlots): VNode[] {\n  const nodes = tagGroupStructure(api, { label, slotted: name => authored[name as keyof TagGroupStructureSlots] != null })\n  return renderStructure(nodes, TAG_GROUP_PARTS, (node) => {\n    const meta = node.data as TagGroupNodeMeta\n    switch (node.slot?.name) {\n      case 'label':\n        return authored.label?.()\n      case 'item':\n        return authored.item?.(meta) ?? meta.label\n      default:\n        return undefined\n    }\n  })\n}\n"],"mappings":"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"}

package/dist/components/tag-group/use-tag-group.d.ts

@@ -1,8 +1,13 @@
-import { ComputedRef } from "vue";
-import { Service } from "@xihan-ui/core";
 import { TagGroupApi, TagGroupSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 //#region src/components/tag-group/use-tag-group.d.ts
 interface TagGroupContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhTagGroupLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<TagGroupApi>;
   /** 状态机实例，供部件上报 DOM 侧的事实（如标签卸载带走了焦点）。 */
   service: Service<TagGroupSchema>;

package/dist/components/tag-group/use-tag-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/use-tag-group.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,YACd,OAAO,yBACP,gBAAgB,0CAChB,eAAe,0CACd"}
+{"version":3,"file":"use-tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/use-tag-group.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,YACd,OAAO,yBACP,gBAAgB,0CAChB,eAAe,0CACd"}

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

@@ -1,17 +1,21 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectTagGroup, tagGroupMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/tag-group/use-tag-group.ts
 function useTagGroup(props, onValueChange, onItemDelete) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(tagGroupMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange,
 		onItemDelete
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	return {
+		labelCount,
 		api: computed(() => connectTagGroup(service, vueNormalize)),
 		service
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"use-tag-group.js","names":[],"sources":["../../../src/components/tag-group/use-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// 提供 use tag group 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagGroup, tagGroupMachine } 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 TagGroupContext {\n  api: ComputedRef<TagGroupApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签卸载带走了焦点）。 */\n  service: Service<TagGroupSchema>\n}\n\nexport function useTagGroup(\n  props: TagGroupSchema['props'],\n  onValueChange?: TagGroupSchema['props']['onValueChange'],\n  onItemDelete?: TagGroupSchema['props']['onItemDelete'],\n): TagGroupContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const service = useMachine(tagGroupMachine, () => ({ ...props, onValueChange, onItemDelete }), scope)\n  const api = computed(() => connectTagGroup(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,YACd,OACA,eACA,cACiB;CAIjB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO;EAAe;CAAa,IAF7E,YAAY,MADZ,qBACsB,CAE+D,CAAC;CAEpG,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-tag-group.js","names":[],"sources":["../../../src/components/tag-group/use-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// 提供 use tag group 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagGroup, tagGroupMachine } 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 TagGroupContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTagGroupLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TagGroupApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签卸载带走了焦点）。 */\n  service: Service<TagGroupSchema>\n}\n\nexport function useTagGroup(\n  props: TagGroupSchema['props'],\n  onValueChange?: TagGroupSchema['props']['onValueChange'],\n  onItemDelete?: TagGroupSchema['props']['onItemDelete'],\n): TagGroupContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const labelCount = ref(0)\n  const service = useMachine(tagGroupMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange, onItemDelete }), scope)\n  const api = computed(() => connectTagGroup(service, vueNormalize))\n  return { labelCount, api, service }\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,YACd,OACA,eACA,cACiB;CAEjB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;EAAe;CAAa,IAAI,KAAK;CAEpI,OAAO;EAAE;EAAY,KADT,eAAe,gBAAgB,SAAS,YAAY,CACzC;EAAG;CAAQ;AACpC"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { TagsInputApi, TagsInputBlurBehavior, TagsInputSchema, TagsInputTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { TagsInputApi, TagsInputBlurBehavior, TagsInputSchema, TagsInputTranslations } from "@xihan-ui/headless";
 //#region src/components/tags-input/tags-input.d.ts
 type TagsInputProps = TagsInputSchema['props'];
 /** 计数部件默认插槽的载荷：当前个数、上限与已达上限、越界两个标志。 */
@@ -9,6 +9,14 @@ type TagsInputCountSlotProps = Pick<TagsInputApi, 'count' | 'max' | 'atMax' | 'o
 /** 默认插槽的载荷：标签集合与输入文本、数量与越界标志、光标与编辑锚点，以及增删改与清空的动作。 */
 type TagsInputRootSlotProps = Pick<TagsInputApi, 'value' | 'count' | 'inputValue' | 'empty' | 'atMax' | 'overflow' | 'highlightedValue' | 'editedValue' | 'canClear' | 'setValue' | 'addValue' | 'deleteValue' | 'clear' | 'setInputValue' | 'highlight' | 'edit'>;
 declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<string[]>;
   };
@@ -81,6 +89,14 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
   'update:inputValue': (_inputValue: PayloadOf<TagsInputProps, "onInputValueChange">["inputValue"]) => true;
   'tag-reject': (_details: PayloadOf<TagsInputProps, "onTagReject">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: PropType<string[]>;
   };
@@ -161,6 +177,11 @@ declare const XhTagsInputRoot: import("vue").DefineComponent<import("vue").Extra
   addOnPaste: boolean;
 }, SlotsType<{
   default?: (props: TagsInputRootSlotProps) => VNode[];
+  label?: () => VNode[];
+  /** 只填标签文本，常态部分的删除钮与就地编辑照旧由结构铺 */
+  item?: (props: {
+    value: string;
+  }) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTagsInputLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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":";;;;;KAmBK,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;;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACF,uBAAA,UAAA,UAAU;EACR,sBAAA,aAAA,UAAU;EACpB,eAAA,UAAA,UAAU;;;IA9BX,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYO,MAAA;;;IACR,MAAA,SAAS;;;;;IAGP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;EAYvC,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"}
+{"version":3,"file":"tags-input.d.ts","names":[],"sources":["../../../src/components/tags-input/tags-input.ts"],"mappings":";;;;;KAqBK,iBAAiB;;KAGV,0BAA0B,KAAK;;KAG/B,yBAAyB,KACnC;cAmBW,+BAAe,8BAAA;;;;;;;;;;IASA,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYO,MAAA;;;IACR,MAAA,SAAS;;;;;IAGP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACF,uBAAA,UAAA,UAAU;EACR,sBAAA,aAAA,UAAU;EACpB,eAAA,UAAA,UAAU;;;;;;;;;;;IA9BX,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYO,MAAA;;;IACR,MAAA,SAAS;;;;;IAGP,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;EAYvC,WAAC,OAAO,2BAA2B;EACrC,cAAM;;EAEP,QAAC;IAAS;QAAoB;kCAsCvC;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,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"}