@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/tree/tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.js","names":[],"sources":["../../../src/components/tree/tree.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// 提供 tree 相关实现。\n\nimport type { Direction } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, TreeApi, TreeNode, TreeNodeProps, TreeSchema } from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { TreeContext } from './use-tree'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideTree, provideTreeNode, useTreeContext, useTreeNodeContext } from './context'\nimport { useTree } from './use-tree'\n\ntype TreeProps = TreeSchema['props']\n\n/** 默认插槽的载荷：可见行序列与展开、选中、焦点状态，以及按值判定与展开、收起、选中的动作。 */\nexport type TreeRootSlotProps = Pick<\n  TreeApi,\n  | 'visibleNodes'\n  | 'expandedValue'\n  | 'selection'\n  | 'focusedValue'\n  | 'isExpanded'\n  | 'isSelected'\n  | 'isIndeterminate'\n  | 'expand'\n  | 'collapse'\n  | 'select'\n>\n\n/** 本节点持有焦点时，value 变更重新报告焦点节点，卸载时上报整树失焦 */\nfunction reportNodeFocus(ctx: TreeContext, el: Ref<HTMLElement | null>, value: () => string): void {\n  watch(value, (next, prev) => {\n    if (next === prev)\n      return\n    const { service } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'NODE.FOCUS', value: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    if (service.prop('virtualizer'))\n      return\n    // 按「本节点当下正持有焦点」判定，不按 value 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'TREE.BLUR' })\n  })\n}\n\nexport const XhTreeRoot = defineComponent({\n  name: 'XhTreeRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TreeNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */\n    variant: { type: String as PropType<TreeProps['variant']> },\n    /** 尺寸：sm / md / lg，默认 md。行高、行内内衬、字号、指示符盒与层级缩进随档。 */\n    size: { type: String as PropType<TreeProps['size']> },\n    expandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedValue: { type: Array as PropType<string[]> },\n    selection: { type: Array as PropType<string[]> },\n    defaultSelection: { type: Array as PropType<string[]> },\n    multiple: { type: Boolean, default: undefined },\n    /** 末端层的排布方式，默认 vertical；horizontal 使子节点全为叶子的层并排铺开。 */\n    leafOrientation: { type: String as PropType<TreeProps['leafOrientation']> },\n    cascade: Boolean,\n    checkedStrategy: { type: String as PropType<TreeProps['checkedStrategy']> },\n    expandOnClick: { type: Boolean, default: undefined },\n    /** 正在取子节点的分支：在其中的分支报告 aria-busy，展开箭头换成转圈。 */\n    loadingValue: { type: Array as PropType<string[]> },\n    /** 连接线：父节点展开箭头的中线向下引一道竖线，每个子节点横出一段接到行首，最后一个子节点止于行中线。 */\n    lines: { type: Boolean, default: undefined },\n    disabled: Boolean,\n    loading: Boolean,\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    /** 节点可以拖动移动。整个节点都是拖动源，不另设把手。 */\n    nodeDraggable: Boolean,\n    /** 本次移动是否允许。收到的是折算后的落点（移动到哪个父节点下的第几位）。未提供时全部允许。 */\n    allowDrop: { type: Function as PropType<TreeProps['allowDrop']> },\n    translations: { type: Object as PropType<TreeProps['translations']> },\n  },\n  // *-change 携带 { value }，update:* 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<TreeProps, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: PayloadOf<TreeProps, 'onExpandedValueChange'>['value']) => true,\n    'selection-change': (_details: PayloadOf<TreeProps, 'onSelectionChange'>) => true,\n    'update:selection': (_value: PayloadOf<TreeProps, 'onSelectionChange'>['value']) => true,\n    // 搬家是通知，节点顺序的真源在使用者的数据里，故没有配对的 update:*\n    'node-move': (_move: PayloadOf<TreeProps, 'onNodeMove'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TreeRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onExpandedValueChange: TreeProps['onExpandedValueChange'] = (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    }\n    const onSelectionChange: TreeProps['onSelectionChange'] = (details) => {\n      emit('selection-change', details)\n      emit('update:selection', details.value)\n    }\n    const onNodeMove: TreeProps['onNodeMove'] = (move) => {\n      emit('node-move', move)\n    }\n    const ctx = useTree(withXhConfig('tree', props) as TreeProps, onExpandedValueChange, onSelectionChange, onNodeMove)\n    provideTree(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      visibleNodes: ctx.api.value.visibleNodes,\n      expandedValue: ctx.api.value.expandedValue,\n      selection: ctx.api.value.selection,\n      focusedValue: ctx.api.value.focusedValue,\n      isExpanded: ctx.api.value.isExpanded,\n      isSelected: ctx.api.value.isSelected,\n      isIndeterminate: ctx.api.value.isIndeterminate,\n      expand: ctx.api.value.expand,\n      collapse: ctx.api.value.collapse,\n      select: ctx.api.value.select,\n    }))\n  },\n})\n\nexport const XhTreeLabel = defineComponent({\n  name: 'XhTreeLabel',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeTree = defineComponent({\n  name: 'XhTreeTree',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    return () => h('div', ctx.api.value.getTreeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeEmpty = defineComponent({\n  name: 'XhTreeEmpty',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    // 空态占位：写在 root 里、tree 的兄弟，不进 role=tree 的拥有关系。\n    // 给了 collection 时收放归连接层，节点手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeLoading = defineComponent({\n  name: 'XhTreeLoading',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 拖动过程的读屏播报区，视觉上不可见。\n *\n * 放在 root 中、与 tree 部件平级。它必须在拖动开始之前就在 DOM 上：\n * 读屏不播报后插入的节点，等到拾起才渲染等于没有。\n */\nexport const XhTreeLiveRegion = defineComponent({\n  name: 'XhTreeLiveRegion',\n  setup() {\n    const ctx = useTreeContext()\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 XhTreeItem = defineComponent({\n  name: 'XhTreeItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTreeContext()\n    const node = computed<TreeNodeProps>(() => ({ value: props.value }))\n    provideTreeNode({ node })\n    const el = ref<HTMLElement | null>(null)\n    reportNodeFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(node.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTreeItemText = defineComponent({\n  name: 'XhTreeItemText',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemTextProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhTreeItemDescription = defineComponent({\n  name: 'XhTreeItemDescription',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhTreeItemSuffix = defineComponent({\n  name: 'XhTreeItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 节点拖拽把手。放在节点中，自带 touch-action: none，按下即拖动，不等待激活距离。\n * 对读屏隐藏、也不占 Tab 位；键盘移动由树上的 Alt + 方向键承担。\n * 整个节点拖动的路径照常可用，把手是叠加的第二个入口。\n */\nexport const XhTreeNodeDragTrigger = defineComponent({\n  name: 'XhTreeNodeDragTrigger',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getNodeDragTriggerProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeItemIndicator = defineComponent({\n  name: 'XhTreeItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranch = defineComponent({\n  name: 'XhTreeBranch',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTreeContext()\n    const node = computed<TreeNodeProps>(() => ({ value: props.value }))\n    // 分支自身也是 treeitem，供其子部件读取；子节点各自再 provide 一层\n    provideTreeNode({ node })\n    const el = ref<HTMLElement | null>(null)\n    reportNodeFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getBranchProps(node.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTreeBranchControl = defineComponent({\n  name: 'XhTreeBranchControl',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('div', ctx.api.value.getBranchControlProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchTrigger = defineComponent({\n  name: 'XhTreeBranchTrigger',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchTriggerProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchIndicator = defineComponent({\n  name: 'XhTreeBranchIndicator',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchIndicatorProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchText = defineComponent({\n  name: 'XhTreeBranchText',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchTextProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchContent = defineComponent({\n  name: 'XhTreeBranchContent',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    // 收起只加 hidden，不卸载子树节点\n    return () => h('div', ctx.api.value.getBranchContentProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"tree.js","names":[],"sources":["../../../src/components/tree/tree.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// 提供 tree 相关实现。\n\nimport type { Direction } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, TreeApi, TreeNode, TreeNodeProps, TreeSchema } from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { TreeContext } from './use-tree'\nimport { computed, defineComponent, h, onBeforeUnmount, onUnmounted, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideTree, provideTreeNode, useTreeContext, useTreeNodeContext } from './context'\nimport { useTree } from './use-tree'\n\ntype TreeProps = TreeSchema['props']\n\n/** 默认插槽的载荷：可见行序列与展开、选中、焦点状态，以及按值判定与展开、收起、选中的动作。 */\nexport type TreeRootSlotProps = Pick<\n  TreeApi,\n  | 'visibleNodes'\n  | 'expandedValue'\n  | 'selection'\n  | 'focusedValue'\n  | 'isExpanded'\n  | 'isSelected'\n  | 'isIndeterminate'\n  | 'expand'\n  | 'collapse'\n  | 'select'\n>\n\n/** 本节点持有焦点时，value 变更重新报告焦点节点，卸载时上报整树失焦 */\nfunction reportNodeFocus(ctx: TreeContext, el: Ref<HTMLElement | null>, value: () => string): void {\n  watch(value, (next, prev) => {\n    if (next === prev)\n      return\n    const { service } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'NODE.FOCUS', value: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    if (service.prop('virtualizer'))\n      return\n    // 按「本节点当下正持有焦点」判定，不按 value 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'TREE.BLUR' })\n  })\n}\n\nexport const XhTreeRoot = defineComponent({\n  name: 'XhTreeRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TreeNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */\n    variant: { type: String as PropType<TreeProps['variant']> },\n    /** 尺寸：sm / md / lg，默认 md。行高、行内内衬、字号、指示符盒与层级缩进随档。 */\n    size: { type: String as PropType<TreeProps['size']> },\n    expandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedValue: { type: Array as PropType<string[]> },\n    selection: { type: Array as PropType<string[]> },\n    defaultSelection: { type: Array as PropType<string[]> },\n    /** 选择模式，默认 single：multiple 点击切换；extended 点击换选、Ctrl/Cmd 点击加选、Shift 点击连选。 */\n    selectionMode: { type: String as PropType<TreeProps['selectionMode']> },\n    /** 末端层的排布方式，默认 vertical；horizontal 使子节点全为叶子的层并排铺开。 */\n    leafOrientation: { type: String as PropType<TreeProps['leafOrientation']> },\n    cascade: Boolean,\n    checkedStrategy: { type: String as PropType<TreeProps['checkedStrategy']> },\n    expandOnClick: { type: Boolean, default: undefined },\n    /** 正在取子节点的分支：在其中的分支报告 aria-busy，展开箭头换成转圈。 */\n    loadingValue: { type: Array as PropType<string[]> },\n    /** 连接线：父节点展开箭头的中线向下引一道竖线，每个子节点横出一段接到行首，最后一个子节点止于行中线。 */\n    lines: { type: Boolean, default: undefined },\n    disabled: Boolean,\n    loading: Boolean,\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    /** 节点可以拖动移动。整个节点都是拖动源，不另设把手。 */\n    nodeDraggable: Boolean,\n    /** 本次移动是否允许。收到的是折算后的落点（移动到哪个父节点下的第几位）。未提供时全部允许。 */\n    allowDrop: { type: Function as PropType<TreeProps['allowDrop']> },\n    translations: { type: Object as PropType<TreeProps['translations']> },\n  },\n  // *-change 携带 { value }，update:* 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<TreeProps, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: PayloadOf<TreeProps, 'onExpandedValueChange'>['value']) => true,\n    'selection-change': (_details: PayloadOf<TreeProps, 'onSelectionChange'>) => true,\n    'update:selection': (_value: PayloadOf<TreeProps, 'onSelectionChange'>['value']) => true,\n    // 搬家是通知，节点顺序的真源在使用者的数据里，故没有配对的 update:*\n    'node-move': (_move: PayloadOf<TreeProps, 'onNodeMove'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TreeRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onExpandedValueChange: TreeProps['onExpandedValueChange'] = (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    }\n    const onSelectionChange: TreeProps['onSelectionChange'] = (details) => {\n      emit('selection-change', details)\n      emit('update:selection', details.value)\n    }\n    const onNodeMove: TreeProps['onNodeMove'] = (move) => {\n      emit('node-move', move)\n    }\n    const ctx = useTree(withXhConfig('tree', props) as TreeProps, onExpandedValueChange, onSelectionChange, onNodeMove)\n    provideTree(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      visibleNodes: ctx.api.value.visibleNodes,\n      expandedValue: ctx.api.value.expandedValue,\n      selection: ctx.api.value.selection,\n      focusedValue: ctx.api.value.focusedValue,\n      isExpanded: ctx.api.value.isExpanded,\n      isSelected: ctx.api.value.isSelected,\n      isIndeterminate: ctx.api.value.isIndeterminate,\n      expand: ctx.api.value.expand,\n      collapse: ctx.api.value.collapse,\n      select: ctx.api.value.select,\n    }))\n  },\n})\n\nexport const XhTreeLabel = defineComponent({\n  name: 'XhTreeLabel',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\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 XhTreeTree = defineComponent({\n  name: 'XhTreeTree',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    return () => h('div', ctx.api.value.getTreeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeEmpty = defineComponent({\n  name: 'XhTreeEmpty',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    // 空态占位：写在 root 里、tree 的兄弟，不进 role=tree 的拥有关系。\n    // 给了 collection 时收放归连接层，节点手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeLoading = defineComponent({\n  name: 'XhTreeLoading',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 拖动过程的读屏播报区，视觉上不可见。\n *\n * 放在 root 中、与 tree 部件平级。它必须在拖动开始之前就在 DOM 上：\n * 读屏不播报后插入的节点，等到拾起才渲染等于没有。\n */\nexport const XhTreeLiveRegion = defineComponent({\n  name: 'XhTreeLiveRegion',\n  setup() {\n    const ctx = useTreeContext()\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 XhTreeItem = defineComponent({\n  name: 'XhTreeItem',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTreeContext()\n    const node = computed<TreeNodeProps>(() => ({ value: props.value }))\n    provideTreeNode({ node })\n    const el = ref<HTMLElement | null>(null)\n    reportNodeFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(node.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTreeItemText = defineComponent({\n  name: 'XhTreeItemText',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemTextProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhTreeItemDescription = defineComponent({\n  name: 'XhTreeItemDescription',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhTreeItemSuffix = defineComponent({\n  name: 'XhTreeItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 节点拖拽把手。放在节点中，自带 touch-action: none，按下即拖动，不等待激活距离。\n * 对读屏隐藏、也不占 Tab 位；键盘移动由树上的 Alt + 方向键承担。\n * 整个节点拖动的路径照常可用，把手是叠加的第二个入口。\n */\nexport const XhTreeNodeDragTrigger = defineComponent({\n  name: 'XhTreeNodeDragTrigger',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getNodeDragTriggerProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeItemIndicator = defineComponent({\n  name: 'XhTreeItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranch = defineComponent({\n  name: 'XhTreeBranch',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useTreeContext()\n    const node = computed<TreeNodeProps>(() => ({ value: props.value }))\n    // 分支自身也是 treeitem，供其子部件读取；子节点各自再 provide 一层\n    provideTreeNode({ node })\n    const el = ref<HTMLElement | null>(null)\n    reportNodeFocus(ctx, el, () => props.value)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getBranchProps(node.value) as Record<string, unknown>, ref: el },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTreeBranchControl = defineComponent({\n  name: 'XhTreeBranchControl',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('div', ctx.api.value.getBranchControlProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchTrigger = defineComponent({\n  name: 'XhTreeBranchTrigger',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchTriggerProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchIndicator = defineComponent({\n  name: 'XhTreeBranchIndicator',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchIndicatorProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchText = defineComponent({\n  name: 'XhTreeBranchText',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchTextProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 分支行的第 2 行副文本，与叶子的说明同一档 */\nexport const XhTreeBranchDescription = defineComponent({\n  name: 'XhTreeBranchDescription',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    return () => h('span', ctx.api.value.getBranchDescriptionProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTreeBranchContent = defineComponent({\n  name: 'XhTreeBranchContent',\n  setup(_, { slots }) {\n    const ctx = useTreeContext()\n    const { node } = useTreeNodeContext()\n    // 收起只加 hidden，不卸载子树节点\n    return () => h('div', ctx.api.value.getBranchContentProps(node.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-tree.d.ts","names":[],"sources":["../../../src/components/tree/use-tree.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,QACd,OAAO,qBACP,wBAAwB,8CACxB,oBAAoB,0CACpB,aAAa,oCACZ"}
+{"version":3,"file":"use-tree.d.ts","names":[],"sources":["../../../src/components/tree/use-tree.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,QACd,OAAO,qBACP,wBAAwB,8CACxB,oBAAoB,0CACpB,aAAa,oCACZ"}

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

@@ -1,18 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectTree, treeMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/tree/use-tree.ts
 function useTree(props, onExpandedValueChange, onSelectionChange, onNodeMove) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(treeMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onExpandedValueChange,
 		onSelectionChange,
 		onNodeMove
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	return {
+		labelCount,
 		api: computed(() => connectTree(service, vueNormalize)),
 		service
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"use-tree.js","names":[],"sources":["../../../src/components/tree/use-tree.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 tree 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TreeApi, TreeSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTree, treeMachine } 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 TreeContext {\n  api: ComputedRef<TreeApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如节点卸载带走了焦点）。 */\n  service: Service<TreeSchema>\n}\n\nexport function useTree(\n  props: TreeSchema['props'],\n  onExpandedValueChange?: TreeSchema['props']['onExpandedValueChange'],\n  onSelectionChange?: TreeSchema['props']['onSelectionChange'],\n  onNodeMove?: TreeSchema['props']['onNodeMove'],\n): TreeContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const service = useMachine(\n    treeMachine,\n    () => ({ ...props, onExpandedValueChange, onSelectionChange, onNodeMove }),\n    scope,\n  )\n  const api = computed(() => connectTree(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,QACd,OACA,uBACA,mBACA,YACa;CAIb,MAAM,UAAU,WACd,oBACO;EAAE,GAAG;EAAO;EAAuB;EAAmB;CAAW,IAJ5D,YAAY,MADZ,qBACsB,CAK9B,CACN;CAEA,OAAO;EAAE,KADG,eAAe,YAAY,SAAS,YAAY,CACjD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-tree.js","names":[],"sources":["../../../src/components/tree/use-tree.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 tree 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TreeApi, TreeSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTree, treeMachine } 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 TreeContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhTreeLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<TreeApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如节点卸载带走了焦点）。 */\n  service: Service<TreeSchema>\n}\n\nexport function useTree(\n  props: TreeSchema['props'],\n  onExpandedValueChange?: TreeSchema['props']['onExpandedValueChange'],\n  onSelectionChange?: TreeSchema['props']['onSelectionChange'],\n  onNodeMove?: TreeSchema['props']['onNodeMove'],\n): TreeContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const service = useMachine(\n    treeMachine,\n    () => ({ ...props, labelled: labelCount.value > 0, onExpandedValueChange, onSelectionChange, onNodeMove }),\n    scope,\n  )\n  const api = computed(() => connectTree(service, vueNormalize))\n  return { labelCount, api, service }\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,QACd,OACA,uBACA,mBACA,YACa;CAEb,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CAExB,MAAM,UAAU,WACd,oBACO;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;EAAuB;EAAmB;CAAW,IACxG,KACF;CAEA,OAAO;EAAE;EAAY,KADT,eAAe,YAAY,SAAS,YAAY,CACrC;EAAG;CAAQ;AACpC"}

package/dist/components/tree-select/tree-select.d.ts

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CollectionVirtualizer, TreeSelectApi, TreeSelectNode, TreeSelectSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { CollectionVirtualizer, TreeSelectApi, TreeSelectNode, TreeSelectSchema } from "@xihan-ui/headless";
 //#region src/components/tree-select/tree-select.d.ts
 type TreeSelectProps = TreeSelectSchema['props'];
 /** 默认插槽的载荷：展开与选中状态、可见行序列、搜索视图、多选的可见标签与折起的个数、节点状态判定与写值方法。 */
 type TreeSelectRootSlotProps = Pick<TreeSelectApi, 'open' | 'searching' | 'inputValue' | 'value' | 'expandedValue' | 'visibleNodes' | 'focusedValue' | 'empty' | 'loading' | 'displayText' | 'canClear' | 'tags' | 'overflowCount' | 'overflowText' | 'isSelected' | 'isIndeterminate' | 'isExpanded' | 'branchLoadState' | 'setOpen' | 'setValue' | 'setExpandedValue' | 'setInputValue' | 'expand' | 'collapse' | 'retryBranch' | 'select' | 'clear' | 'deselect'>;
 declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<TreeSelectNode[]>;
   };
@@ -67,6 +71,10 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loading: BooleanConstructor;
   variant: {
     type: PropType<ControlVariant>;
@@ -116,6 +124,10 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   'update:expandedValue': (_value: PayloadOf<TreeSelectProps, "onExpandedValueChange">["value"]) => true;
   'update:open': (_open: PayloadOf<TreeSelectProps, "onOpenChange">["open"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<TreeSelectNode[]>;
   };
@@ -176,6 +188,10 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loading: BooleanConstructor;
   variant: {
     type: PropType<ControlVariant>;
@@ -223,6 +239,7 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").TreeSelectExpandedValueChangeDetails) => any) | undefined;
   "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
 }>, {
+  required: boolean;
   invalid: boolean;
   multiple: boolean;
   loop: boolean;
@@ -231,9 +248,9 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   defaultOpen: boolean;
   loading: boolean;
   readOnly: boolean;
+  clearable: boolean;
   cascade: boolean;
   searchable: boolean;
-  clearable: boolean;
 }, SlotsType<{
   default?: (props: TreeSelectRootSlotProps) => VNode[];
   label?: () => VNode[];

package/dist/components/tree-select/tree-select.d.ts.map

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

package/dist/components/tree-select/tree-select.js

@@ -1,3 +1,4 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotIsPlainText } from "../../runtime/slot-content.js";
@@ -7,7 +8,8 @@ import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideTreeSelect, provideTreeSelectContent, provideTreeSelectNode, provideTreeSelectTag, useTreeSelectContentContext, useTreeSelectContext, useTreeSelectNodeContext, useTreeSelectTagContext } from "./context.js";
 import { useTreeSelect } from "./use-tree-select.js";
-import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onMounted, ref, watch } from "vue";
+import { treeSelectStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onMounted, onUnmounted, ref, watch } from "vue";
 //#region src/components/tree-select/tree-select.ts
 /** 本节点持有焦点时，value 变更重新报告焦点节点，卸载时上报焦点丢失 */
 function reportNodeFocus(ctx, el, value) {
@@ -53,6 +55,8 @@ function reportNodeFocus(ctx, el, value) {
 const XhTreeSelectRoot = defineComponent({
 	name: "XhTreeSelectRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		/** 完整 collection 与 Virtualizer 的焦点桥；count 必须等于当前 visibleNodes.length。 */
 		virtualizer: { type: Object },
@@ -91,6 +95,10 @@ const XhTreeSelectRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		loading: Boolean,
 		variant: { type: String },
 		tone: { type: String },
@@ -174,13 +182,17 @@ const XhTreeSelectRoot = defineComponent({
 			select: ctx.api.value.select,
 			clear: ctx.api.value.clear,
 			deselect: ctx.api.value.deselect
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, props.multiple ? ctx.api.value.tags : null, props.searchable, slots.label?.() ?? (props.label != null ? [props.label] : null), props.clearable) : []);
+		}) : renderDefaultStructure(ctx.api.value, props.label, props.clearable, props.searchable, slots.label));
 	}
 });
 const XhTreeSelectLabel = defineComponent({
 	name: "XhTreeSelectLabel",
 	setup(_, { slots }) {
 		const ctx = useTreeSelectContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -571,43 +583,50 @@ const XhTreeSelectHiddenInput = defineComponent({
 	inheritAttrs: false,
 	setup(_, { attrs }) {
 		const ctx = useTreeSelectContext();
-		return () => ctx.api.value.value.map((value) => h("input", {
+		return () => [...ctx.api.value.value.map((value) => h("input", {
 			...mergeProps(ctx.api.value.getHiddenInputProps({ value }), attrs),
 			key: value
-		}));
-	}
-});
-/** 按 collection 递归铺设节点：带 children 的渲染为 branch，其余渲染为 item。 */
-function renderNodes(nodes) {
-	return nodes.map((node) => node.children || node.hasChildren ? h(XhTreeSelectBranch, {
-		key: node.value,
-		value: node.value
-	}, () => [h(XhTreeSelectBranchControl, null, () => [
-		h(XhTreeSelectBranchTrigger),
-		h(XhTreeSelectBranchText, null, () => node.label ?? node.value),
-		h(XhTreeSelectItemIndicator)
-	]), h(XhTreeSelectBranchContent, null, () => renderNodes(node.children ?? []))]) : h(XhTreeSelectItem, {
-		key: node.value,
-		value: node.value
-	}, () => [h(XhTreeSelectItemIndicator), h(XhTreeSelectItemText, null, () => node.label ?? node.value)]));
-}
+		})), ...ctx.api.value.value.length === 0 && ctx.api.value.required ? [h("input", {
+			...mergeProps(ctx.api.value.getHiddenInputProps(), attrs),
+			key: "required"
+		})] : []];
+	}
+});
+/** 标准结构里各部件对应的组件。 */
+const TREE_SELECT_PARTS = {
+	"label": XhTreeSelectLabel,
+	"control": XhTreeSelectControl,
+	"trigger": XhTreeSelectTrigger,
+	"value-text": XhTreeSelectValueText,
+	"tag-list": XhTreeSelectTagList,
+	"tag/tag": XhTreeSelectTag,
+	"tag/overflow-tag": XhTreeSelectOverflowTag,
+	"indicator": XhTreeSelectIndicator,
+	"clear-trigger": XhTreeSelectClearTrigger,
+	"positioner": XhTreeSelectPositioner,
+	"content": XhTreeSelectContent,
+	"input": XhTreeSelectInput,
+	"tree": XhTreeSelectTree,
+	"item": XhTreeSelectItem,
+	"item-text": XhTreeSelectItemText,
+	"item-indicator": XhTreeSelectItemIndicator,
+	"branch": XhTreeSelectBranch,
+	"branch-control": XhTreeSelectBranchControl,
+	"branch-trigger": XhTreeSelectBranchTrigger,
+	"branch-text": XhTreeSelectBranchText,
+	"branch-content": XhTreeSelectBranchContent
+};
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 未写默认插槽时照 treeSelectStructure 铺开的整套结构，与 Web Components 不写部件时元素生成的节点出自同一份。
+* 标题文字由 label 给出，需要放置其他内容时由 label 插槽接管。
 */
-function renderDefaultTree(collection, tags, searchable, label, clearable) {
-	return [
-		...label ? [h(XhTreeSelectLabel, null, () => label)] : [],
-		h(XhTreeSelectControl, null, () => [h(XhTreeSelectTrigger, null, () => [
-			h(XhTreeSelectValueText),
-			...tags ? [h(XhTreeSelectTagList, null, () => [...tags.map((tag) => h(XhTreeSelectTag, {
-				key: tag.value,
-				value: tag.value
-			}, () => tag.label)), h(XhTreeSelectOverflowTag)])] : [],
-			h(XhTreeSelectIndicator)
-		]), ...clearable ? [h(XhTreeSelectClearTrigger)] : []]),
-		h(XhTreeSelectPositioner, null, () => [h(XhTreeSelectContent, null, () => [...searchable ? [h(XhTreeSelectInput)] : [], h(XhTreeSelectTree, null, () => renderNodes(collection))])])
-	];
+function renderDefaultStructure(api, label, clearable, searchable, labelSlot) {
+	return renderStructure(treeSelectStructure(api, {
+		label,
+		clearable,
+		searchable,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), TREE_SELECT_PARTS, (node) => node.slot?.name === "label" ? labelSlot?.() : void 0);
 }
 //#endregion
 export { XhTreeSelectBranch, XhTreeSelectBranchContent, XhTreeSelectBranchControl, XhTreeSelectBranchEmpty, XhTreeSelectBranchError, XhTreeSelectBranchIndicator, XhTreeSelectBranchLoading, XhTreeSelectBranchRetryTrigger, XhTreeSelectBranchText, XhTreeSelectBranchTrigger, XhTreeSelectClearTrigger, XhTreeSelectContent, XhTreeSelectControl, XhTreeSelectEmpty, XhTreeSelectFooter, XhTreeSelectHiddenInput, XhTreeSelectIndicator, XhTreeSelectInput, XhTreeSelectItem, XhTreeSelectItemDeleteTrigger, XhTreeSelectItemDescription, XhTreeSelectItemIndicator, XhTreeSelectItemSuffix, XhTreeSelectItemText, XhTreeSelectLabel, XhTreeSelectLoading, XhTreeSelectOverflowTag, XhTreeSelectPositioner, XhTreeSelectRoot, XhTreeSelectTag, XhTreeSelectTagLabel, XhTreeSelectTagList, XhTreeSelectTree, XhTreeSelectTrigger, XhTreeSelectValueText };