@xihan-ui/vue 4.2.0 → 5.0.0

package/dist/components/cascader/cascader.js.map

@@ -1 +1 @@
-{"version":3,"file":"cascader.js","names":[],"sources":["../../../src/components/cascader/cascader.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// 提供 cascader 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CascaderApi,\n  CascaderExpandTrigger,\n  CascaderGroupProps,\n  CascaderItemProps,\n  CascaderNode,\n  CascaderSchema,\n  CascaderSearchResult,\n  CascaderTranslations,\n  CascaderValue,\n} from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { CascaderContext } from './use-cascader'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideCascader, provideCascaderContent, provideCascaderGroup, provideCascaderItem, provideCascaderTag, useCascaderContentContext, useCascaderContext, useCascaderGroupContext, useCascaderItemContext, useCascaderTagContext } from './context'\nimport { useCascader } from './use-cascader'\n\ntype CascaderProps = CascaderSchema['props']\n\n/** 本条目持有焦点时，value 变更重新报告焦点条目，卸载时上报焦点丢失 */\nfunction reportItemFocus(\n  ctx: CascaderContext,\n  el: Ref<HTMLElement | null>,\n  value: () => string,\n): void {\n  watch(value, (next, prev) => {\n    if (next === prev)\n      return\n    const { service, api } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (!el.value || service.scope.getActiveElement() !== el.value)\n      return\n    // 层号回 collection 里查，条目只自报值\n    const meta = api.value.levels.flatMap(level => level.items).find(item => item.value === next)\n    if (meta)\n      service.send({ type: 'ITEM.FOCUS', level: meta.level, value: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    // 按「本条目当下正持有焦点」判定，不按 value 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'ITEM.LOST' })\n  })\n}\n\n/** 默认插槽的载荷：级联的展开态、选中态与列数据、多选的可见标签与折起的个数，以及修改它们的方法。 */\nexport type CascaderRootSlotProps = Pick<\n  CascaderApi,\n  | 'open'\n  | 'levels'\n  | 'columns'\n  | 'value'\n  | 'valuePath'\n  | 'activePath'\n  | 'focusedPath'\n  | 'displayText'\n  | 'canClear'\n  | 'tags'\n  | 'overflowCount'\n  | 'overflowText'\n  | 'isSelected'\n  | 'isIndeterminate'\n  | 'isActive'\n  | 'isVisible'\n  | 'setOpen'\n  | 'setValue'\n  | 'setActivePath'\n  | 'select'\n  | 'clear'\n  | 'deselect'\n>\n\nexport const XhCascaderRoot = defineComponent({\n  name: 'XhCascaderRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<CascaderNode[]> },\n    /** 取回懒分支（hasChildren 且没给 children）的直接子项；展开路径走到它时自动调用。 */\n    loadChildren: { type: Function as PropType<CascaderProps['loadChildren']> },\n    value: { type: Array as PropType<CascaderValue> },\n    defaultValue: { type: Array as PropType<CascaderValue> },\n    name: { type: String },\n    form: { type: String },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    expandTrigger: { type: String as PropType<CascaderExpandTrigger> },\n    changeOnSelect: Boolean,\n    multiple: Boolean,\n    /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */\n    maxTagCount: { type: Number },\n    searchable: { type: Boolean, default: undefined },\n    /** 自定义搜索匹配；缺省为整条路径的显示名连缀后大小写不敏感包含。 */\n    filter: { type: Function as PropType<CascaderProps['filter']> },\n    cascade: Boolean,\n    checkedStrategy: { type: String as PropType<CascaderProps['checkedStrategy']> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    translations: { type: Object as PropType<Partial<CascaderTranslations>> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    placeholder: { type: String },\n    separator: { type: String },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值；选中值恒为路径数组，单选时长度 ≤ 1\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<CascaderProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<CascaderProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<CascaderProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<CascaderProps, 'onOpenChange'>['open']) => true,\n    'branch-load-start': (_details: PayloadOf<CascaderProps, 'onBranchLoadStart'>) => true,\n    'branch-load': (_details: PayloadOf<CascaderProps, 'onBranchLoad'>) => true,\n    'branch-load-error': (_details: PayloadOf<CascaderProps, 'onBranchLoadError'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CascaderRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: CascaderProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: CascaderProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCascader(withHandlers(withXhConfig('cascader', useFormControlProps(props)), { onClear: () => emit('clear') }) as CascaderProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n      onBranchLoadStart: details => emit('branch-load-start', details),\n      onBranchLoad: details => emit('branch-load', details),\n      onBranchLoadError: details => emit('branch-load-error', details),\n    })\n    provideCascader(ctx)\n\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [slots.default?.({\n      open: ctx.api.value.open,\n      // levels 每层一列、层内节点各一条目，供作者渲染；columns 只读当前展开的列\n      levels: ctx.api.value.levels,\n      columns: ctx.api.value.columns,\n      value: ctx.api.value.value,\n      valuePath: ctx.api.value.valuePath,\n      activePath: ctx.api.value.activePath,\n      focusedPath: ctx.api.value.focusedPath,\n      displayText: ctx.api.value.displayText,\n      canClear: ctx.api.value.canClear,\n      tags: ctx.api.value.tags,\n      overflowCount: ctx.api.value.overflowCount,\n      overflowText: ctx.api.value.overflowText,\n      isSelected: ctx.api.value.isSelected,\n      isIndeterminate: ctx.api.value.isIndeterminate,\n      isActive: ctx.api.value.isActive,\n      isVisible: ctx.api.value.isVisible,\n      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      setActivePath: ctx.api.value.setActivePath,\n      select: ctx.api.value.select,\n      clear: ctx.api.value.clear,\n      deselect: ctx.api.value.deselect,\n    }), ...ctx.api.value.value.map(path => h('input', {\n      ...ctx.api.value.getHiddenInputProps({ path }) as Record<string, unknown>,\n      key: JSON.stringify(path),\n    }))])\n  },\n})\n\nexport const XhCascaderLabel = defineComponent({\n  name: 'XhCascaderLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderControl = defineComponent({\n  name: 'XhCascaderControl',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 描边、底色与聚焦环所在的那一层，触发按钮与尾部动作钮在里面并排\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 XhCascaderTrigger = defineComponent({\n  name: 'XhCascaderTrigger',\n  setup(_, { slots }) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useCascaderContext()\n    return () => h('button', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }), slots.default?.())\n  },\n})\n\nexport const XhCascaderValueText = defineComponent({\n  name: 'XhCascaderValueText',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 有插槽用插槽，否则显示整条路径或 placeholder\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.displayText,\n    )\n  },\n})\n\nexport const XhCascaderTagList = defineComponent({\n  name: 'XhCascaderTagList',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 标签行：可见标签与 +N 那一枚在里面并排；无选中时连接层给 hidden，value-text 回来显示占位文字\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */\nexport const XhCascaderTagLabel = defineComponent({\n  name: 'XhCascaderTagLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把\n * 删除按钮挤出；作者自己写了节点则原样放行。与 XhTagRoot 同一规则。\n * 库自身填入的文字（+N，没有折叠时是空串）恒包 label，三个适配器渲染出同一棵树。\n */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhCascaderTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhCascaderTagLabel, null, () => content)] : content\n}\n\n/** 一条选中路径一个标签，即库内 tag 的 root（data-scope=\"tag\"）：语气、尺寸与禁用从级联传下，形态按控件的面派生；触发器内纯展示，触发器外配合 XhCascaderItemDeleteTrigger 可删除。 */\nexport const XhCascaderTag = defineComponent({\n  name: 'XhCascaderTag',\n  props: {\n    /** 它代表哪条选中路径：写路径的比较键，即 tags 里的 key。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    provideCascaderTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhCascaderOverflowTag = defineComponent({\n  name: 'XhCascaderOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope=\"tag\"），可及名使用 translations.deleteItem；点按移除所在标签的选中路径。 */\nexport const XhCascaderItemDeleteTrigger = defineComponent({\n  name: 'XhCascaderItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const tag = useCascaderTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderIndicator = defineComponent({\n  name: 'XhCascaderIndicator',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderClearTrigger = defineComponent({\n  name: 'XhCascaderClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderPositioner = defineComponent({\n  name: 'XhCascaderPositioner',\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 = useCascaderContext()\n    // 列区的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner。\n    // 只摆横的：列多到放不下时整体横向滚动，纵向溢出归每一列自己。\n    // 横条的正负按排版方向算，而组件不读计算样式，把 positioner 上那份显式交过去\n    const bars = useScrollbars({\n      scrollable: () => ctx.contentRef.value,\n      axes: ['horizontal'],\n      // 条子走浮层 4px 档\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhCascaderLoading = defineComponent({\n  name: 'XhCascaderLoading',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const content = useCascaderContentContext()\n    const unregister = content.registerLoading()\n    onBeforeUnmount(unregister)\n    // 在途占位：作者没写内容时使用 Cascader 自己的翻译合同。\n    return () => h(\n      'div',\n      ctx.api.value.getLoadingProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.translations.loading,\n    )\n  },\n})\n\n/** 放在作者插槽之后挂载；隔着普通元素或业务组件的 Loading 已在 setup 阶段登记。 */\nconst XhCascaderAutoLoading = defineComponent({\n  name: 'XhCascaderAutoLoading',\n  setup() {\n    const ctx = useCascaderContext()\n    const content = useCascaderContentContext()\n    return () => content.authoredLoadingCount.value > 0\n      ? null\n      : h('div', {\n          ...ctx.api.value.getLoadingProps() as Record<string, unknown>,\n          'data-xh-cascader-auto-loading': '',\n        }, ctx.api.value.translations.loading)\n  },\n})\n\nexport const XhCascaderContent = defineComponent({\n  name: 'XhCascaderContent',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const authoredLoadingCount = ref(0)\n    const registerLoading = (): (() => void) => {\n      authoredLoadingCount.value += 1\n      let active = true\n      return () => {\n        if (!active)\n          return\n        active = false\n        authoredLoadingCount.value -= 1\n      }\n    }\n    provideCascaderContent({ authoredLoadingCount, registerLoading })\n    // 收起时只隐藏不卸载；跨列的键盘导航也在这一层处理\n    return () => {\n      const api = ctx.api.value\n      const children = slots.default?.() ?? []\n      return h('div', {\n        ...api.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      }, [\n        children,\n        // 空态占位常挂在列后，露不露面归连接层；empty 插槽可换内容，缺省文案按视图取无匹配或无数据\n        h(\n          'div',\n          api.getEmptyProps() as Record<string, unknown>,\n          slots.empty ? slots.empty() : (api.searching ? api.translations.noMatch : api.translations.empty),\n        ),\n        h(XhCascaderAutoLoading),\n      ])\n    }\n  },\n})\n\nexport const XhCascaderInput = defineComponent({\n  name: 'XhCascaderInput',\n  setup() {\n    const ctx = useCascaderContext()\n    // 搜索框放在 content 顶部；没开 searchable 时连接层给 hidden\n    return () => h('input', ctx.api.value.getInputProps() as Record<string, unknown>)\n  },\n})\n\n/** item 插槽的载荷：一条搜索候选。 */\nexport interface CascaderSearchListItemSlotProps {\n  result: CascaderSearchResult\n}\n\nexport const XhCascaderSearchList = defineComponent({\n  name: 'XhCascaderSearchList',\n  slots: Object as SlotsType<{\n    item?: (props: CascaderSearchListItemSlotProps) => VNode[]\n  }>,\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useCascaderContext()\n    const searchListRef = ref<HTMLElement | null>(null)\n    // 候选列表自己竖滚，条子贴在它的盒子上、紧跟在它后面（与列同一形态：浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => searchListRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    // 候选换代、列表显隐都会挪动它在壳内的位置：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    // 候选整组自动铺：整条路径连缀成一行；item 插槽可换内容\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getSearchListProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { searchListRef.value = el as HTMLElement },\n      }, ctx.api.value.searchResults.map(result =>\n        h(\n          'div',\n          { ...ctx.api.value.getSearchItemProps({ path: result.path }) as Record<string, unknown>, key: result.key },\n          slots.item ? slots.item({ result }) : result.labels.join(' / '),\n        ),\n      )),\n      ...bars.render(),\n    ]\n  },\n})\n\n/**\n * 懒分支那一列里的三块状态：在途、失败提示与重试钮。只在这一列属于懒分支时铺，露哪一块归连接层；\n * 文案走 translations.loading / branchError / retry。\n */\nfunction renderBranchFeedback(ctx: CascaderContext, level: number): VNode[] {\n  const api = ctx.api.value\n  if (api.columnLoadState(level) == null)\n    return []\n  return [\n    h('div', { ...api.getBranchLoadingProps({ level }) as Record<string, unknown>, key: 'branch-loading' }, api.translations.loading),\n    h('div', { ...api.getBranchErrorProps({ level }) as Record<string, unknown>, key: 'branch-error' }, api.translations.branchError),\n    h('button', { ...api.getBranchRetryTriggerProps({ level }) as Record<string, unknown>, key: 'branch-retry-trigger' }, api.translations.retry),\n  ]\n}\n\nexport const XhCascaderColumn = defineComponent({\n  name: 'XhCascaderColumn',\n  props: {\n    // 层号，兼收字符串以支持模板里写 level=\"0\"\n    level: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  // 根是片段（列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useCascaderContext()\n    const columnRef = ref<HTMLElement | null>(null)\n    // 每列自己竖滚：条子贴在本列的盒子上、紧跟在它后面；content 那条横的归浮层壳\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    // 展开路径一变，左边的列换内容、本列在壳内的位置跟着挪：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    // 展开路径变短时本列收起，节点常挂不卸载\n    return () => [\n      h(\n        'div',\n        {\n          ...mergeProps(ctx.api.value.getColumnProps({ level: Number(props.level) }) as Record<string, unknown>, attrs),\n          ref: (el: unknown) => { columnRef.value = el as HTMLElement },\n        },\n        [...(slots.default?.() ?? []), ...renderBranchFeedback(ctx, Number(props.level))],\n      ),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhCascaderGroup = defineComponent({\n  name: 'XhCascaderGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    const group = computed<CascaderGroupProps>(() => ({ value: props.value }))\n    provideCascaderGroup({ group })\n    // 分组容器：写在列里，条目照常挂在它下面\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderGroupLabel = defineComponent({\n  name: 'XhCascaderGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { group } = useCascaderGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderItem = defineComponent({\n  name: 'XhCascaderItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    const item = computed<CascaderItemProps>(() => ({ value: props.value }))\n    provideCascaderItem({ item })\n    const el = ref<HTMLElement | null>(null)\n    reportItemFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCascaderItemText = defineComponent({\n  name: 'XhCascaderItemText',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhCascaderItemDescription = defineComponent({\n  name: 'XhCascaderItemDescription',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhCascaderItemSuffix = defineComponent({\n  name: 'XhCascaderItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderItemIndicator = defineComponent({\n  name: 'XhCascaderItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderFooter = defineComponent({\n  name: 'XhCascaderFooter',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 浮层底部的操作区：写在 content 里、与列并列，横跨全部列；\n    // 列表框语义在每一列上，放在这里的按钮既不进列的拥有关系，也走不到方向键\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"cascader.js","names":[],"sources":["../../../src/components/cascader/cascader.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// 提供 cascader 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CascaderApi,\n  CascaderExpandTrigger,\n  CascaderGroupProps,\n  CascaderItemProps,\n  CascaderNode,\n  CascaderSchema,\n  CascaderSearchResult,\n  CascaderTranslations,\n  CascaderValue,\n  StructureChild,\n} from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { CascaderContext } from './use-cascader'\nimport { cascaderStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUnmounted, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideCascader, provideCascaderContent, provideCascaderGroup, provideCascaderItem, provideCascaderTag, useCascaderContentContext, useCascaderContext, useCascaderGroupContext, useCascaderItemContext, useCascaderTagContext } from './context'\nimport { useCascader } from './use-cascader'\n\ntype CascaderProps = CascaderSchema['props']\n\n/** 本条目持有焦点时，value 变更重新报告焦点条目，卸载时上报焦点丢失 */\nfunction reportItemFocus(\n  ctx: CascaderContext,\n  el: Ref<HTMLElement | null>,\n  value: () => string,\n): void {\n  watch(value, (next, prev) => {\n    if (next === prev)\n      return\n    const { service, api } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (!el.value || service.scope.getActiveElement() !== el.value)\n      return\n    // 层号回 collection 里查，条目只自报值\n    const meta = api.value.levels.flatMap(level => level.items).find(item => item.value === next)\n    if (meta)\n      service.send({ type: 'ITEM.FOCUS', level: meta.level, value: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    // 按「本条目当下正持有焦点」判定，不按 value 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'ITEM.LOST' })\n  })\n}\n\n/** 默认插槽的载荷：级联的展开态、选中态与列数据、多选的可见标签与折起的个数，以及修改它们的方法。 */\nexport type CascaderRootSlotProps = Pick<\n  CascaderApi,\n  | 'open'\n  | 'levels'\n  | 'columns'\n  | 'value'\n  | 'valuePath'\n  | 'activePath'\n  | 'focusedPath'\n  | 'displayText'\n  | 'canClear'\n  | 'tags'\n  | 'overflowCount'\n  | 'overflowText'\n  | 'isSelected'\n  | 'isIndeterminate'\n  | 'isActive'\n  | 'isVisible'\n  | 'setOpen'\n  | 'setValue'\n  | 'setActivePath'\n  | 'select'\n  | 'clear'\n  | 'deselect'\n>\n\nexport const XhCascaderRoot = defineComponent({\n  name: 'XhCascaderRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不写默认插槽时盒里带清空按钮；写了插槽时放 clear-trigger 部件即可清空。 */\n    clearable: Boolean,\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    collection: { type: Array as PropType<CascaderNode[]> },\n    /** 取回懒分支（hasChildren 且没给 children）的直接子项；展开路径走到它时自动调用。 */\n    loadChildren: { type: Function as PropType<CascaderProps['loadChildren']> },\n    value: { type: Array as PropType<CascaderValue> },\n    defaultValue: { type: Array as PropType<CascaderValue> },\n    name: { type: String },\n    form: { type: String },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    expandTrigger: { type: String as PropType<CascaderExpandTrigger> },\n    changeOnSelect: Boolean,\n    multiple: Boolean,\n    /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */\n    maxTagCount: { type: Number },\n    searchable: { type: Boolean, default: undefined },\n    /** 自定义搜索匹配；缺省为整条路径的显示名连缀后大小写不敏感包含。 */\n    filter: { type: Function as PropType<CascaderProps['filter']> },\n    cascade: Boolean,\n    checkedStrategy: { type: String as PropType<CascaderProps['checkedStrategy']> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    loading: Boolean,\n    translations: { type: Object as PropType<Partial<CascaderTranslations>> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    placeholder: { type: String },\n    separator: { type: String },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值；选中值恒为路径数组，单选时长度 ≤ 1\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<CascaderProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<CascaderProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<CascaderProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<CascaderProps, 'onOpenChange'>['open']) => true,\n    'branch-load-start': (_details: PayloadOf<CascaderProps, 'onBranchLoadStart'>) => true,\n    'branch-load': (_details: PayloadOf<CascaderProps, 'onBranchLoad'>) => true,\n    'branch-load-error': (_details: PayloadOf<CascaderProps, 'onBranchLoadError'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CascaderRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: CascaderProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: CascaderProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCascader(withHandlers(withXhConfig('cascader', useFormControlProps(props)), { onClear: () => emit('clear') }) as CascaderProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n      onBranchLoadStart: details => emit('branch-load-start', details),\n      onBranchLoad: details => emit('branch-load', details),\n      onBranchLoadError: details => emit('branch-load-error', details),\n    })\n    provideCascader(ctx)\n\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [!slots.default\n      ? renderDefaultStructure(ctx.api.value, { label: props.label, clearable: props.clearable, searchable: props.searchable }, slots.label)\n      : slots.default({\n          open: ctx.api.value.open,\n          // levels 每层一列、层内节点各一条目，供作者渲染；columns 只读当前展开的列\n          levels: ctx.api.value.levels,\n          columns: ctx.api.value.columns,\n          value: ctx.api.value.value,\n          valuePath: ctx.api.value.valuePath,\n          activePath: ctx.api.value.activePath,\n          focusedPath: ctx.api.value.focusedPath,\n          displayText: ctx.api.value.displayText,\n          canClear: ctx.api.value.canClear,\n          tags: ctx.api.value.tags,\n          overflowCount: ctx.api.value.overflowCount,\n          overflowText: ctx.api.value.overflowText,\n          isSelected: ctx.api.value.isSelected,\n          isIndeterminate: ctx.api.value.isIndeterminate,\n          isActive: ctx.api.value.isActive,\n          isVisible: ctx.api.value.isVisible,\n          setOpen: ctx.api.value.setOpen,\n          setValue: ctx.api.value.setValue,\n          setActivePath: ctx.api.value.setActivePath,\n          select: ctx.api.value.select,\n          clear: ctx.api.value.clear,\n          deselect: ctx.api.value.deselect,\n        }), ...ctx.api.value.value.map(path => h('input', {\n      ...ctx.api.value.getHiddenInputProps({ path }) as Record<string, unknown>,\n      key: JSON.stringify(path),\n    })), ...(ctx.api.value.value.length === 0 && ctx.api.value.required\n      // 必填且没选值：补一份空值占位，原生 required 才拦得住空表单\n      ? [h('input', { ...ctx.api.value.getHiddenInputProps() as Record<string, unknown>, key: 'required' })]\n      : [])])\n  },\n})\n\nexport const XhCascaderLabel = defineComponent({\n  name: 'XhCascaderLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\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 XhCascaderControl = defineComponent({\n  name: 'XhCascaderControl',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 描边、底色与聚焦环所在的那一层，触发按钮与尾部动作钮在里面并排\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 XhCascaderTrigger = defineComponent({\n  name: 'XhCascaderTrigger',\n  setup(_, { slots }) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useCascaderContext()\n    return () => h('button', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }), slots.default?.())\n  },\n})\n\nexport const XhCascaderValueText = defineComponent({\n  name: 'XhCascaderValueText',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 有插槽用插槽，否则显示整条路径或 placeholder\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.displayText,\n    )\n  },\n})\n\nexport const XhCascaderTagList = defineComponent({\n  name: 'XhCascaderTagList',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 标签行：可见标签与 +N 那一枚在里面并排；无选中时连接层给 hidden，value-text 回来显示占位文字\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */\nexport const XhCascaderTagLabel = defineComponent({\n  name: 'XhCascaderTagLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把\n * 删除按钮挤出；作者自己写了节点则原样放行。与 XhTagRoot 同一规则。\n * 库自身填入的文字（+N，没有折叠时是空串）恒包 label，三个适配器渲染出同一棵树。\n */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhCascaderTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhCascaderTagLabel, null, () => content)] : content\n}\n\n/** 一条选中路径一个标签，即库内 tag 的 root（data-scope=\"tag\"）：语气、尺寸与禁用从级联传下，形态按控件的面派生；触发器内纯展示，触发器外配合 XhCascaderItemDeleteTrigger 可删除。 */\nexport const XhCascaderTag = defineComponent({\n  name: 'XhCascaderTag',\n  props: {\n    /** 它代表哪条选中路径：写路径的比较键，即 tags 里的 key。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    provideCascaderTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhCascaderOverflowTag = defineComponent({\n  name: 'XhCascaderOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope=\"tag\"），可及名使用 translations.deleteItem；点按移除所在标签的选中路径。 */\nexport const XhCascaderItemDeleteTrigger = defineComponent({\n  name: 'XhCascaderItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const tag = useCascaderTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderIndicator = defineComponent({\n  name: 'XhCascaderIndicator',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderClearTrigger = defineComponent({\n  name: 'XhCascaderClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderPositioner = defineComponent({\n  name: 'XhCascaderPositioner',\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 = useCascaderContext()\n    // 列区的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner。\n    // 只摆横的：列多到放不下时整体横向滚动，纵向溢出归每一列自己。\n    // 横条的正负按排版方向算，而组件不读计算样式，把 positioner 上那份显式交过去\n    const bars = useScrollbars({\n      scrollable: () => ctx.contentRef.value,\n      axes: ['horizontal'],\n      // 条子走浮层 4px 档\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhCascaderLoading = defineComponent({\n  name: 'XhCascaderLoading',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const content = useCascaderContentContext()\n    const unregister = content.registerLoading()\n    onBeforeUnmount(unregister)\n    // 在途占位：作者没写内容时使用 Cascader 自己的翻译合同。\n    return () => h(\n      'div',\n      ctx.api.value.getLoadingProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.translations.loading,\n    )\n  },\n})\n\n/** 放在作者插槽之后挂载；隔着普通元素或业务组件的 Loading 已在 setup 阶段登记。 */\nconst XhCascaderAutoLoading = defineComponent({\n  name: 'XhCascaderAutoLoading',\n  setup() {\n    const ctx = useCascaderContext()\n    const content = useCascaderContentContext()\n    return () => content.authoredLoadingCount.value > 0\n      ? null\n      : h('div', {\n          ...ctx.api.value.getLoadingProps() as Record<string, unknown>,\n          'data-xh-cascader-auto-loading': '',\n        }, ctx.api.value.translations.loading)\n  },\n})\n\nexport const XhCascaderContent = defineComponent({\n  name: 'XhCascaderContent',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const authoredLoadingCount = ref(0)\n    const registerLoading = (): (() => void) => {\n      authoredLoadingCount.value += 1\n      let active = true\n      return () => {\n        if (!active)\n          return\n        active = false\n        authoredLoadingCount.value -= 1\n      }\n    }\n    provideCascaderContent({ authoredLoadingCount, registerLoading })\n    // 收起时只隐藏不卸载；跨列的键盘导航也在这一层处理\n    return () => {\n      const api = ctx.api.value\n      const children = slots.default?.() ?? []\n      return h('div', {\n        ...api.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      }, [\n        children,\n        // 空态占位常挂在列后，露不露面归连接层；empty 插槽可换内容，缺省文案按视图取无匹配或无数据\n        h(\n          'div',\n          api.getEmptyProps() as Record<string, unknown>,\n          slots.empty ? slots.empty() : (api.searching ? api.translations.noMatch : api.translations.empty),\n        ),\n        h(XhCascaderAutoLoading),\n      ])\n    }\n  },\n})\n\nexport const XhCascaderInput = defineComponent({\n  name: 'XhCascaderInput',\n  setup() {\n    const ctx = useCascaderContext()\n    // 搜索框放在 content 顶部；没开 searchable 时连接层给 hidden\n    return () => h('input', ctx.api.value.getInputProps() as Record<string, unknown>)\n  },\n})\n\n/** item 插槽的载荷：一条搜索候选。 */\nexport interface CascaderSearchListItemSlotProps {\n  result: CascaderSearchResult\n}\n\nexport const XhCascaderSearchList = defineComponent({\n  name: 'XhCascaderSearchList',\n  slots: Object as SlotsType<{\n    item?: (props: CascaderSearchListItemSlotProps) => VNode[]\n  }>,\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useCascaderContext()\n    const searchListRef = ref<HTMLElement | null>(null)\n    // 候选列表自己竖滚，条子贴在它的盒子上、紧跟在它后面（与列同一形态：浮层 4px 档）\n    const bars = useScrollbars({\n      scrollable: () => searchListRef.value,\n      anchor: 'layer',\n      props: () => ({ dir: (ctx.api.value.getPositionerProps() as { dir?: Direction }).dir, size: 'sm' }),\n    })\n    // 候选换代、列表显隐都会挪动它在壳内的位置：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    // 候选整组自动铺：整条路径连缀成一行；item 插槽可换内容\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getSearchListProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { searchListRef.value = el as HTMLElement },\n      }, ctx.api.value.searchResults.map(result =>\n        h(\n          'div',\n          { ...ctx.api.value.getSearchItemProps({ path: result.path }) as Record<string, unknown>, key: result.key },\n          slots.item ? slots.item({ result }) : result.labels.join(' / '),\n        ),\n      )),\n      ...bars.render(),\n    ]\n  },\n})\n\n/**\n * 懒分支那一列里的三块状态：在途、失败提示与重试钮。只在这一列属于懒分支时铺，露哪一块归连接层；\n * 文案走 translations.loading / branchError / retry。\n */\nfunction renderBranchFeedback(ctx: CascaderContext, level: number): VNode[] {\n  const api = ctx.api.value\n  if (api.columnLoadState(level) == null)\n    return []\n  return [\n    h('div', { ...api.getBranchLoadingProps({ level }) as Record<string, unknown>, key: 'branch-loading' }, api.translations.loading),\n    h('div', { ...api.getBranchErrorProps({ level }) as Record<string, unknown>, key: 'branch-error' }, api.translations.branchError),\n    h('button', { ...api.getBranchRetryTriggerProps({ level }) as Record<string, unknown>, key: 'branch-retry-trigger' }, api.translations.retry),\n  ]\n}\n\nexport const XhCascaderColumn = defineComponent({\n  name: 'XhCascaderColumn',\n  props: {\n    // 层号，兼收字符串以支持模板里写 level=\"0\"\n    level: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  // 根是片段（列节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列节点上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useCascaderContext()\n    const columnRef = ref<HTMLElement | null>(null)\n    // 每列自己竖滚：条子贴在本列的盒子上、紧跟在它后面；content 那条横的归浮层壳\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    // 展开路径一变，左边的列换内容、本列在壳内的位置跟着挪：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    // 展开路径变短时本列收起，节点常挂不卸载\n    return () => [\n      h(\n        'div',\n        {\n          ...mergeProps(ctx.api.value.getColumnProps({ level: Number(props.level) }) as Record<string, unknown>, attrs),\n          ref: (el: unknown) => { columnRef.value = el as HTMLElement },\n        },\n        [...(slots.default?.() ?? []), ...renderBranchFeedback(ctx, Number(props.level))],\n      ),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhCascaderGroup = defineComponent({\n  name: 'XhCascaderGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    const group = computed<CascaderGroupProps>(() => ({ value: props.value }))\n    provideCascaderGroup({ group })\n    // 分组容器：写在列里，条目照常挂在它下面\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderGroupLabel = defineComponent({\n  name: 'XhCascaderGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { group } = useCascaderGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderItem = defineComponent({\n  name: 'XhCascaderItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCascaderContext()\n    const item = computed<CascaderItemProps>(() => ({ value: props.value }))\n    provideCascaderItem({ item })\n    const el = ref<HTMLElement | null>(null)\n    reportItemFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCascaderItemText = defineComponent({\n  name: 'XhCascaderItemText',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhCascaderItemDescription = defineComponent({\n  name: 'XhCascaderItemDescription',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhCascaderItemSuffix = defineComponent({\n  name: 'XhCascaderItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderItemIndicator = defineComponent({\n  name: 'XhCascaderItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    const { item } = useCascaderItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCascaderFooter = defineComponent({\n  name: 'XhCascaderFooter',\n  setup(_, { slots }) {\n    const ctx = useCascaderContext()\n    // 浮层底部的操作区：写在 content 里、与列并列，横跨全部列；\n    // 列表框语义在每一列上，放在这里的按钮既不进列的拥有关系，也走不到方向键\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件；委派部件按「组件名/部件名」查。 */\nconst CASCADER_PARTS = {\n  'label': XhCascaderLabel,\n  'control': XhCascaderControl,\n  'trigger': XhCascaderTrigger,\n  'value-text': XhCascaderValueText,\n  'tag-list': XhCascaderTagList,\n  'indicator': XhCascaderIndicator,\n  'clear-trigger': XhCascaderClearTrigger,\n  'positioner': XhCascaderPositioner,\n  'content': XhCascaderContent,\n  'input': XhCascaderInput,\n  'search-list': XhCascaderSearchList,\n  'column': XhCascaderColumn,\n  'item': XhCascaderItem,\n  'item-text': XhCascaderItemText,\n  'item-description': XhCascaderItemDescription,\n  'item-indicator': XhCascaderItemIndicator,\n  'tag/tag': XhCascaderTag,\n  'tag/overflow-tag': XhCascaderOverflowTag,\n}\n\n/** 浮层自己铺空态与在途，候选列表自己铺每条候选，列自己铺懒分支的三块状态：铺结构时去掉这些格子。 */\nconst SELF_ASSEMBLED: ReadonlySet<string> = new Set(['empty', 'loading', 'search-item', 'branch-loading', 'branch-error', 'branch-retry-trigger'])\n\nfunction withoutSelfAssembled(nodes: readonly StructureChild[]): StructureChild[] {\n  return nodes.flatMap((node): StructureChild[] => {\n    if (!('part' in node))\n      return [node]\n    if (SELF_ASSEMBLED.has(node.part))\n      return []\n    return [node.children ? { ...node, children: withoutSelfAssembled(node.children) } : node]\n  })\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 cascaderStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管；表单影子仍由根按选中路径装配在后面。\n */\nfunction renderDefaultStructure(api: CascaderApi, options: { label?: string, clearable?: boolean, searchable?: boolean }, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = cascaderStructure(api, { ...options, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(withoutSelfAssembled(nodes), CASCADER_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-cascader.d.ts","names":[],"sources":["../../../src/components/cascader/use-cascader.ts"],"mappings":";;;;UAoBiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,0HACd"}
+{"version":3,"file":"use-cascader.d.ts","names":[],"sources":["../../../src/components/cascader/use-cascader.ts"],"mappings":";;;;UAoBiB;;;;;EAKf,YAAY;;EAEZ,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,0HACd"}

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

@@ -3,9 +3,9 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { cascaderMachine, connectCascader } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { cascaderMachine, connectCascader } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/cascader/use-cascader.ts
 function useCascader(props, handlers = {}) {
@@ -16,8 +16,10 @@ function useCascader(props, handlers = {}) {
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const labelCount = ref(0);
 	const service = useMachine(cascaderMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
 	}), scope);
 	let config = null;
@@ -43,6 +45,7 @@ function useCascader(props, handlers = {}) {
 	}
 	const api = computed(() => connectCascader(service, vueNormalize));
 	return {
+		labelCount,
 		visible: useOverlayExit({
 			config,
 			isOpen: () => api.value.open,

package/dist/components/cascader/use-cascader.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-cascader.js","names":[],"sources":["../../../src/components/cascader/use-cascader.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 cascader 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { CascaderApi, CascaderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { cascaderMachine, connectCascader } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface CascaderContext {\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<CascaderSchema>\n  api: ComputedRef<CascaderApi>\n  triggerRef: Ref<HTMLElement | null>\n  controlRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCascader(\n  props: CascaderSchema['props'],\n  handlers: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange' | 'onBranchLoadStart' | 'onBranchLoad' | 'onBranchLoadError'> = {},\n): CascaderContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const controlRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(cascaderMachine, () => ({ ...props, ...handlers }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：content 之外还浮着自绘滚动条，按住它拖动不该把浮层消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    // 锚点是字段盒：面板起始缘与盒对齐；作者没写 control 时退回触发器\n    service.refs.set('getAnchorEl', () => controlRef.value ?? triggerRef.value)\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectCascader(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, controlRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,YACd,OACA,WAAyI,CAAC,GACzH;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAGpF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EAEnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,SAAS,WAAW,KAAK;EAC1E,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,gBAAgB,SAAS,YAAY,CAAC;CAWjE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAY;EAAe;EAAY,cAF9D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE3B;CAAE;AAClG"}
+{"version":3,"file":"use-cascader.js","names":[],"sources":["../../../src/components/cascader/use-cascader.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 cascader 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { CascaderApi, CascaderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { cascaderMachine, connectCascader } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface CascaderContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhCascaderLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<CascaderSchema>\n  api: ComputedRef<CascaderApi>\n  triggerRef: Ref<HTMLElement | null>\n  controlRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCascader(\n  props: CascaderSchema['props'],\n  handlers: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange' | 'onBranchLoadStart' | 'onBranchLoad' | 'onBranchLoadError'> = {},\n): CascaderContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const controlRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(cascaderMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：content 之外还浮着自绘滚动条，按住它拖动不该把浮层消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    // 锚点是字段盒：面板起始缘与盒对齐；作者没写 control 时退回触发器\n    service.refs.set('getAnchorEl', () => controlRef.value ?? triggerRef.value)\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectCascader(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { labelCount, visible, service, api, triggerRef, controlRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAuCA,SAAgB,YACd,OACA,WAAyI,CAAC,GACzH;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAGpH,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EAEnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,SAAS,WAAW,KAAK;EAC1E,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,gBAAgB,SAAS,YAAY,CAAC;CAWjE,OAAO;EAAE;EAAY,SATL,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAI2B;EAAG;EAAS;EAAK;EAAY;EAAY;EAAe;EAAY,cAF1E,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEf;CAAE;AAC9G"}

package/dist/components/checkbox/checkbox.d.ts

@@ -1,10 +1,14 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CheckboxCheckedState, CheckboxSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { CheckboxCheckedState, CheckboxSchema } from "@xihan-ui/headless";
 //#region src/components/checkbox/checkbox.d.ts
 type CheckboxProps = CheckboxSchema['props'];
 declare const XhCheckbox: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   checked: {
     type: PropType<CheckboxCheckedState>;
     default: undefined;
@@ -44,6 +48,10 @@ declare const XhCheckbox: import("vue").DefineComponent<import("vue").ExtractPro
   'checked-change': (_details: PayloadOf<CheckboxProps, "onCheckedChange">) => true;
   'update:checked': (_checked: PayloadOf<CheckboxProps, "onCheckedChange">["checked"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   checked: {
     type: PropType<CheckboxCheckedState>;
     default: undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"checkbox.d.ts","names":[],"sources":["../../../src/components/checkbox/checkbox.ts"],"mappings":";;;;;KAiBK,gBAAgB;cAER,0BAAU,8BAAA;;IAImB,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,MAAA,SAAS;EACT,MAAA,SAAS;;;;EAUI,mBAAA,UAAA,UAAU;EACV,mBAAA,UAAA,UAAU;;;IArBD,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;;EAIf,gBAAM;;EAEJ,kBAAM;kCA0CpB"}
+{"version":3,"file":"checkbox.d.ts","names":[],"sources":["../../../src/components/checkbox/checkbox.ts"],"mappings":";;;;;KAmBK,gBAAgB;cAmCR,0BAAU,8BAAA;;;;;;IAMmB,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,MAAA,SAAS;EACT,MAAA,SAAS;;;;EAUI,mBAAA,UAAA,UAAU;EACV,mBAAA,UAAA,UAAU;;;;;;;IArBD,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;;EAIf,gBAAM;;EAEJ,kBAAM;kCA4CpB"}

package/dist/components/checkbox/checkbox.js

@@ -1,12 +1,39 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { useCheckbox } from "./use-checkbox.js";
-import { defineComponent, h, useId } from "vue";
+import { checkboxStructure } from "@xihan-ui/headless";
+import { defineComponent, h, inject, provide, useId } from "vue";
 //#region src/components/checkbox/checkbox.ts
+const CHECKBOX_API = Symbol("XhCheckboxApi");
+function useCheckboxApi() {
+	const api = inject(CHECKBOX_API);
+	if (!api) throw new Error("[xh] 复选框的部件只能渲在 XhCheckbox 里");
+	return api;
+}
+/** 标准结构里各部件对应的组件。 */
+const CHECKBOX_PARTS = {
+	"indicator": defineComponent({
+		name: "XhCheckboxIndicator",
+		setup(_, { slots }) {
+			const api = useCheckboxApi();
+			return () => h("span", api.value.getIndicatorProps(), slots.default?.());
+		}
+	}),
+	"hidden-input": defineComponent({
+		name: "XhCheckboxHiddenInput",
+		setup() {
+			const api = useCheckboxApi();
+			return () => h("input", api.value.getHiddenInputProps());
+		}
+	})
+};
 const XhCheckbox = defineComponent({
 	name: "XhCheckbox",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		checked: {
 			type: [Boolean, String],
 			default: void 0
@@ -48,6 +75,7 @@ const XhCheckbox = defineComponent({
 			emit("update:checked", details.checked);
 		};
 		const { api } = useCheckbox(useFormControlProps(props), notify);
+		provide(CHECKBOX_API, api);
 		const fieldWiring = useFieldStateWiring();
 		const fieldLabel = useFieldLabelWiring();
 		const textId = useId();
@@ -58,7 +86,10 @@ const XhCheckbox = defineComponent({
 				...fieldWiring.value,
 				...api.value.getRootProps(),
 				...labelled ? { "aria-labelledby": textId } : null
-			}), [h("span", api.value.getIndicatorProps(), slots.indicator?.()), props.name === void 0 ? null : h("input", api.value.getHiddenInputProps())]);
+			}), renderStructure(checkboxStructure({
+				hiddenInput: props.name !== void 0,
+				slotted: (name) => name === "indicator" && slots.indicator !== void 0
+			}), CHECKBOX_PARTS, (node) => node.slot?.name === "indicator" ? slots.indicator?.() : void 0));
 			if (!labelled) return box;
 			return h("label", api.value.getLabelProps(), [box, h("span", {
 				...api.value.getTextProps(),

package/dist/components/checkbox/checkbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkbox.js","names":[],"sources":["../../../src/components/checkbox/checkbox.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// 提供 checkbox 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { CheckboxCheckedState, CheckboxSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, useId } from 'vue'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { useCheckbox } from './use-checkbox'\n\ntype CheckboxProps = CheckboxSchema['props']\n\nexport const XhCheckbox = defineComponent({\n  name: 'XhCheckbox',\n  props: {\n    // 三态：true / false / 'indeterminate'。半选只能由外部给，点击不会切进去\n    checked: { type: [Boolean, String] as PropType<CheckboxCheckedState>, default: undefined },\n    defaultChecked: { type: [Boolean, String] as PropType<CheckboxCheckedState>, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    value: { type: String },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  slots: Object as SlotsType<{\n    /** 方框旁的文字；未写时只有一个方框。 */\n    default?: () => VNode[]\n    /** 方框中的图形；未写时由皮肤绘制勾选标记。 */\n    indicator?: () => VNode[]\n  }>,\n  // checked-change 携带 { checked }，update:checked 携带裸布尔\n  emits: {\n    'checked-change': (_details: PayloadOf<CheckboxProps, 'onCheckedChange'>) => true,\n    'update:checked': (_checked: PayloadOf<CheckboxProps, 'onCheckedChange'>['checked']) => true,\n  },\n  setup(props, { emit, slots }) {\n    const notify: CheckboxProps['onCheckedChange'] = (details) => {\n      emit('checked-change', details)\n      emit('update:checked', details.checked)\n    }\n    const { api } = useCheckbox(useFormControlProps(props) as CheckboxProps, notify)\n    // 字段的说明与校验状态要落在焦点所在的那颗按钮上：给了文字时封装根是外面那个 <label>，\n    // XhFieldControl 把整份接线合在它身上，而读屏只念焦点所在节点的描述\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链，否则按钮的名字里只剩组件自己那段文字\n    const fieldLabel = useFieldLabelWiring()\n    // 文字那段的 id：按钮按它取名，字段的标签再排到它前面\n    const textId = useId()\n    // 表单影子由组件自己渲染，给了 name 才有这个节点——type=hidden 不是交互内容，放进 button 里是合法的\n    return () => {\n      // 默认插槽是方框旁的文字：<label> 包住两者，点文字即切换。没给文字就只有方框\n      const text = slots.default?.()\n      const labelled = slotPaints(text)\n      const box = h('button', fieldLabel.value({\n        ...fieldWiring.value,\n        ...api.value.getRootProps() as Record<string, unknown>,\n        // 有文字时名字改由它承担；没文字时不写，作者写在组件上的 aria-label 照旧生效\n        ...(labelled ? { 'aria-labelledby': textId } : null),\n      }), [\n        h('span', api.value.getIndicatorProps() as Record<string, unknown>, slots.indicator?.()),\n        props.name === undefined ? null : h('input', api.value.getHiddenInputProps() as Record<string, unknown>),\n      ])\n      if (!labelled)\n        return box\n      return h('label', api.value.getLabelProps() as Record<string, unknown>, [\n        box,\n        h('span', { ...api.value.getTextProps() as Record<string, unknown>, id: textId }, text),\n      ])\n    }\n  },\n})\n"],"mappings":";;;;;;AAmBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EAEL,SAAS;GAAE,MAAM,CAAC,SAAS,MAAM;GAAqC,SAAS,KAAA;EAAU;EACzF,gBAAgB;GAAE,MAAM,CAAC,SAAS,MAAM;GAAqC,SAAS,KAAA;EAAU;EAChG,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE9C,MAAM,EAAE,MAAM,OAAO;EACrB,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM;EACN,MAAM;CACR;CACA,OAAO;CAOP,OAAO;EACL,mBAAmB,aAA0D;EAC7E,mBAAmB,aAAqE;CAC1F;CACA,MAAM,OAAO,EAAE,MAAM,SAAS;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,kBAAkB,OAAO;GAC9B,KAAK,kBAAkB,QAAQ,OAAO;EACxC;EACA,MAAM,EAAE,QAAQ,YAAY,oBAAoB,KAAK,GAAoB,MAAM;EAG/E,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EAEvC,MAAM,SAAS,MAAM;EAErB,aAAa;GAEX,MAAM,OAAO,MAAM,UAAU;GAC7B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,MAAM,EAAE,UAAU,WAAW,MAAM;IACvC,GAAG,YAAY;IACf,GAAG,IAAI,MAAM,aAAa;IAE1B,GAAI,WAAW,EAAE,mBAAmB,OAAO,IAAI;GACjD,CAAC,GAAG,CACF,EAAE,QAAQ,IAAI,MAAM,kBAAkB,GAA8B,MAAM,YAAY,CAAC,GACvF,MAAM,SAAS,KAAA,IAAY,OAAO,EAAE,SAAS,IAAI,MAAM,oBAAoB,CAA4B,CACzG,CAAC;GACD,IAAI,CAAC,UACH,OAAO;GACT,OAAO,EAAE,SAAS,IAAI,MAAM,cAAc,GAA8B,CACtE,KACA,EAAE,QAAQ;IAAE,GAAG,IAAI,MAAM,aAAa;IAA8B,IAAI;GAAO,GAAG,IAAI,CACxF,CAAC;EACH;CACF;AACF,CAAC"}
+{"version":3,"file":"checkbox.js","names":[],"sources":["../../../src/components/checkbox/checkbox.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// 提供 checkbox 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { CheckboxApi, CheckboxCheckedState, CheckboxSchema } from '@xihan-ui/headless'\nimport type { InjectionKey, PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { checkboxStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, inject, provide, useId } from 'vue'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { useCheckbox } from './use-checkbox'\n\ntype CheckboxProps = CheckboxSchema['props']\n\nconst CHECKBOX_API: InjectionKey<Readonly<Ref<CheckboxApi>>> = Symbol('XhCheckboxApi')\n\nfunction useCheckboxApi(): Readonly<Ref<CheckboxApi>> {\n  const api = inject(CHECKBOX_API)\n  if (!api)\n    throw new Error('[xh] 复选框的部件只能渲在 XhCheckbox 里')\n  return api\n}\n\n/** 勾选标记：作者给了 indicator 插槽时装它的内容，没给时由皮肤画勾。 */\nconst CheckboxIndicator = defineComponent({\n  name: 'XhCheckboxIndicator',\n  setup(_, { slots }) {\n    const api = useCheckboxApi()\n    return () => h('span', api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 表单影子：单体控件的方框里没有子部件插槽，作者递不进来，由组件自己渲。 */\nconst CheckboxHiddenInput = defineComponent({\n  name: 'XhCheckboxHiddenInput',\n  setup() {\n    const api = useCheckboxApi()\n    return () => h('input', api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst CHECKBOX_PARTS = {\n  'indicator': CheckboxIndicator,\n  'hidden-input': CheckboxHiddenInput,\n}\n\nexport const XhCheckbox = defineComponent({\n  name: 'XhCheckbox',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    // 三态：true / false / 'indeterminate'。半选只能由外部给，点击不会切进去\n    checked: { type: [Boolean, String] as PropType<CheckboxCheckedState>, default: undefined },\n    defaultChecked: { type: [Boolean, String] as PropType<CheckboxCheckedState>, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    /** 表单字段名；提供后 hidden-input 才带 name 并参与提交 */\n    name: { type: String },\n    value: { type: String },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  slots: Object as SlotsType<{\n    /** 方框旁的文字；未写时只有一个方框。 */\n    default?: () => VNode[]\n    /** 方框中的图形；未写时由皮肤绘制勾选标记。 */\n    indicator?: () => VNode[]\n  }>,\n  // checked-change 携带 { checked }，update:checked 携带裸布尔\n  emits: {\n    'checked-change': (_details: PayloadOf<CheckboxProps, 'onCheckedChange'>) => true,\n    'update:checked': (_checked: PayloadOf<CheckboxProps, 'onCheckedChange'>['checked']) => true,\n  },\n  setup(props, { emit, slots }) {\n    const notify: CheckboxProps['onCheckedChange'] = (details) => {\n      emit('checked-change', details)\n      emit('update:checked', details.checked)\n    }\n    const { api } = useCheckbox(useFormControlProps(props) as CheckboxProps, notify)\n    provide(CHECKBOX_API, api)\n    // 字段的说明与校验状态要落在焦点所在的那颗按钮上：给了文字时封装根是外面那个 <label>，\n    // XhFieldControl 把整份接线合在它身上，而读屏只念焦点所在节点的描述\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链，否则按钮的名字里只剩组件自己那段文字\n    const fieldLabel = useFieldLabelWiring()\n    // 文字那段的 id：按钮按它取名，字段的标签再排到它前面\n    const textId = useId()\n    // 表单影子由组件自己渲染，给了 name 才有这个节点——type=hidden 不是交互内容，放进 button 里是合法的\n    return () => {\n      // 默认插槽是方框旁的文字：<label> 包住两者，点文字即切换。没给文字就只有方框\n      const text = slots.default?.()\n      const labelled = slotPaints(text)\n      const box = h('button', fieldLabel.value({\n        ...fieldWiring.value,\n        ...api.value.getRootProps() as Record<string, unknown>,\n        // 有文字时名字改由它承担；没文字时不写，作者写在组件上的 aria-label 照旧生效\n        ...(labelled ? { 'aria-labelledby': textId } : null),\n      }), renderStructure(\n        checkboxStructure({ hiddenInput: props.name !== undefined, slotted: name => name === 'indicator' && slots.indicator !== undefined }),\n        CHECKBOX_PARTS,\n        node => (node.slot?.name === 'indicator' ? slots.indicator?.() : undefined),\n      ))\n      if (!labelled)\n        return box\n      return h('label', api.value.getLabelProps() as Record<string, unknown>, [\n        box,\n        h('span', { ...api.value.getTextProps() as Record<string, unknown>, id: textId }, text),\n      ])\n    }\n  },\n})\n"],"mappings":";;;;;;;;AAqBA,MAAM,eAAyD,OAAO,eAAe;AAErF,SAAS,iBAA6C;CACpD,MAAM,MAAM,OAAO,YAAY;CAC/B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8BAA8B;CAChD,OAAO;AACT;;AAqBA,MAAM,iBAAiB;CACrB,aAnBwB,gBAAgB;EACxC,MAAM;EACN,MAAM,GAAG,EAAE,SAAS;GAClB,MAAM,MAAM,eAAe;GAC3B,aAAa,EAAE,QAAQ,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;EACpG;CACF,CAa+B;CAC7B,gBAX0B,gBAAgB;EAC1C,MAAM;EACN,QAAQ;GACN,MAAM,MAAM,eAAe;GAC3B,aAAa,EAAE,SAAS,IAAI,MAAM,oBAAoB,CAA4B;EACpF;CACF,CAKoC;AACpC;AAEA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAE1B,SAAS;GAAE,MAAM,CAAC,SAAS,MAAM;GAAqC,SAAS,KAAA;EAAU;EACzF,gBAAgB;GAAE,MAAM,CAAC,SAAS,MAAM;GAAqC,SAAS,KAAA;EAAU;EAChG,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE9C,MAAM,EAAE,MAAM,OAAO;EACrB,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM;EACN,MAAM;CACR;CACA,OAAO;CAOP,OAAO;EACL,mBAAmB,aAA0D;EAC7E,mBAAmB,aAAqE;CAC1F;CACA,MAAM,OAAO,EAAE,MAAM,SAAS;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,kBAAkB,OAAO;GAC9B,KAAK,kBAAkB,QAAQ,OAAO;EACxC;EACA,MAAM,EAAE,QAAQ,YAAY,oBAAoB,KAAK,GAAoB,MAAM;EAC/E,QAAQ,cAAc,GAAG;EAGzB,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EAEvC,MAAM,SAAS,MAAM;EAErB,aAAa;GAEX,MAAM,OAAO,MAAM,UAAU;GAC7B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,MAAM,EAAE,UAAU,WAAW,MAAM;IACvC,GAAG,YAAY;IACf,GAAG,IAAI,MAAM,aAAa;IAE1B,GAAI,WAAW,EAAE,mBAAmB,OAAO,IAAI;GACjD,CAAC,GAAG,gBACF,kBAAkB;IAAE,aAAa,MAAM,SAAS,KAAA;IAAW,UAAS,SAAQ,SAAS,eAAe,MAAM,cAAc,KAAA;GAAU,CAAC,GACnI,iBACA,SAAS,KAAK,MAAM,SAAS,cAAc,MAAM,YAAY,IAAI,KAAA,CACnE,CAAC;GACD,IAAI,CAAC,UACH,OAAO;GACT,OAAO,EAAE,SAAS,IAAI,MAAM,cAAc,GAA8B,CACtE,KACA,EAAE,QAAQ;IAAE,GAAG,IAAI,MAAM,aAAa;IAA8B,IAAI;GAAO,GAAG,IAAI,CACxF,CAAC;EACH;CACF;AACF,CAAC"}

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { CheckboxApi, CheckboxSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/checkbox/use-checkbox.d.ts
 interface CheckboxContext {
   api: ComputedRef<CheckboxApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { checkboxMachine, connectCheckbox } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/checkbox/use-checkbox.ts
 function useCheckbox(props, onCheckedChange) {
 	const service = useMachine(checkboxMachine, () => ({

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

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CheckboxGroupApi, CheckboxGroupNode, CheckboxGroupNodeMeta, CheckboxGroupSchema, CheckboxGroupVariant } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Orientation, Size, Tone } from "@xihan-ui/core";
-import { CheckboxGroupApi, CheckboxGroupNode, CheckboxGroupNodeMeta, CheckboxGroupSchema, CheckboxGroupVariant } from "@xihan-ui/headless";
 //#region src/components/checkbox-group/checkbox-group.d.ts
 type CheckboxGroupProps = CheckboxGroupSchema['props'];
 /** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */
 type CheckboxGroupRootSlotProps = Pick<CheckboxGroupApi, 'value' | 'checkedState' | 'atMax' | 'atMin' | 'isChecked' | 'setValue' | 'toggleValue'>;
 declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<CheckboxGroupNode[]>;
   };
@@ -41,6 +45,10 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -62,6 +70,10 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   'value-change': (_details: PayloadOf<CheckboxGroupProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<CheckboxGroupProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<CheckboxGroupNode[]>;
   };
@@ -96,6 +108,10 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -115,6 +131,7 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   "onValue-change"?: ((_details: import("@xihan-ui/headless").CheckboxGroupValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
 }>, {
+  required: boolean;
   invalid: boolean;
   disabled: boolean;
   readOnly: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"mappings":";;;;;KA6BK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;IAGC,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;IAOE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;EAIT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IArBN,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;IAOE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;EAQ1B,WAAC,OAAO,+BAA+B;EACzC,cAAM;EACP,QAAC,OAAO,0BAA0B;kCA8B3C;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAa/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAiB9B;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAQnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAOzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"mappings":";;;;;KAgCK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;;;;;IAKC,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;EAIT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;IAtBN,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;EAQ1B,WAAC,OAAO,+BAA+B;EACzC,cAAM;EACP,QAAC,OAAO,0BAA0B;kCA4B3C;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAW/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAiB9B;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAQnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAOzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,12 +1,16 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideCheckboxGroup, provideCheckboxGroupItem, useCheckboxGroupContext, useCheckboxGroupItemContext } from "./context.js";
 import { useCheckboxGroup } from "./use-checkbox-group.js";
-import { computed, defineComponent, h, onBeforeUnmount, onMounted } from "vue";
+import { checkboxGroupStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onUnmounted } from "vue";
 //#region src/components/checkbox-group/checkbox-group.ts
 const XhCheckboxGroupRoot = defineComponent({
 	name: "XhCheckboxGroupRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
 		label: { type: String },
@@ -27,6 +31,10 @@ const XhCheckboxGroupRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		name: { type: String },
 		orientation: { type: String },
 		tone: { type: String },
@@ -60,7 +68,10 @@ const XhCheckboxGroupRoot = defineComponent({
 				isChecked: ctx.api.value.isChecked,
 				setValue: ctx.api.value.setValue,
 				toggleValue: ctx.api.value.toggleValue
-			})] : props.collection ? renderDefaultTree(ctx.api.value.collection, title, slots.item) : renderLabel(title));
+			})] : renderDefaultStructure(ctx.api.value, props.label, {
+				label: slots.label,
+				item: slots.item
+			}));
 		};
 	}
 });
@@ -68,10 +79,8 @@ const XhCheckboxGroupLabel = defineComponent({
 	name: "XhCheckboxGroupLabel",
 	setup(_, { slots }) {
 		const ctx = useCheckboxGroupContext();
-		onMounted(() => {
-			ctx.labelCount.value++;
-		});
-		onBeforeUnmount(() => {
+		ctx.labelCount.value++;
+		onUnmounted(() => {
 			ctx.labelCount.value--;
 		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
@@ -130,20 +139,39 @@ const XhCheckboxGroupSelectAllTrigger = defineComponent({
 		return () => h("div", ctx.api.value.getSelectAllTriggerProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件；条目里的表单影子由 XhCheckboxGroupItem 自行装配，铺结构时去掉这一格。 */
+const CHECKBOX_GROUP_PARTS = {
+	"label": XhCheckboxGroupLabel,
+	"item": XhCheckboxGroupItem,
+	"indicator": XhCheckboxGroupIndicator,
+	"item-text": XhCheckboxGroupItemText,
+	"item-description": XhCheckboxGroupItemDescription
+};
+function withoutSelfAssembled(nodes) {
+	return nodes.flatMap((node) => {
+		if (!("part" in node)) return [node];
+		if (node.part === "hidden-input") return [];
+		return [node.children ? {
+			...node,
+			children: withoutSelfAssembled(node.children)
+		} : node];
+	});
+}
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
-* 全选控件不在其中：它是可选部件，需要时写默认插槽。
+* 未写默认插槽时铺开的整套结构：照 headless 的 checkboxGroupStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题与条目文字由对应插槽接管；全选控件要用时写默认插槽。
 */
-function renderDefaultTree(collection, label, itemSlot) {
-	return [...renderLabel(label), ...collection.map((node) => h(XhCheckboxGroupItem, {
-		key: node.value,
-		value: node.value
-	}, () => [
-		h(XhCheckboxGroupIndicator),
-		h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label),
-		...node.description != null ? [h(XhCheckboxGroupItemDescription, null, () => node.description)] : []
-	]))];
+function renderDefaultStructure(api, label, content) {
+	return renderStructure(withoutSelfAssembled(checkboxGroupStructure(api, {
+		label,
+		slotted: (name) => content[name] != null
+	})), CHECKBOX_GROUP_PARTS, (node) => {
+		switch (node.slot?.name) {
+			case "label": return content.label?.();
+			case "item": return content.item?.(node.data) ?? node.data.label;
+			default: return;
+		}
+	});
 }
 /** 组标题：给了文字或 label 插槽才铺 label 部件。 */
 function renderLabel(title) {