@xihan-ui/vue 2.1.0 → 3.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 { 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    // 按「本节点当下正持有焦点」判定，不按 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    /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留行。 */\n    variant: { type: String as PropType<TreeProps['variant']> },\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    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, 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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"}

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

@@ -22,12 +22,21 @@ function useTreeSelectNodeContext() {
 function provideTreeSelectContent(ctx) {
 	provide(CONTENT_KEY, ctx);
 }
+const TAG_KEY = Symbol.for("xh-tree-select-tag");
+function provideTreeSelectTag(ctx) {
+	provide(TAG_KEY, ctx);
+}
+function useTreeSelectTagContext() {
+	const ctx = inject(TAG_KEY, null);
+	if (!ctx) throw new Error("[xh] TreeSelect 标签子部件必须用在 XhTreeSelectTag 内");
+	return ctx;
+}
 function useTreeSelectContentContext() {
 	const ctx = inject(CONTENT_KEY, null);
 	if (!ctx) throw new Error("[xh] TreeSelect Empty / Loading 必须用在 XhTreeSelectContent 内");
 	return ctx;
 }
 //#endregion
-export { provideTreeSelect, provideTreeSelectContent, provideTreeSelectNode, useTreeSelectContentContext, useTreeSelectContext, useTreeSelectNodeContext };
+export { provideTreeSelect, provideTreeSelectContent, provideTreeSelectNode, provideTreeSelectTag, useTreeSelectContentContext, useTreeSelectContext, useTreeSelectNodeContext, useTreeSelectTagContext };
 
 //# sourceMappingURL=context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tree-select/context.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// 提供 context 相关实现。\n\nimport type { TreeSelectNodeProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, Ref } from 'vue'\nimport type { TreeSelectContext } from './use-tree-select'\nimport { inject, provide } from 'vue'\n\n/** 节点声明的值，供 item / branch 的子部件复用同一份声明；层级、禁用与标签查询 collection。 */\nexport interface TreeSelectNodeContext {\n  node: ComputedRef<TreeSelectNodeProps>\n}\n\nexport interface TreeSelectContentContext {\n  authoredEmptyCount: Ref<number>\n  authoredLoadingCount: Ref<number>\n  registerEmpty: () => () => void\n  registerLoading: () => () => void\n}\n\nconst KEY: InjectionKey<TreeSelectContext> = Symbol.for('xh-tree-select')\nconst NODE_KEY: InjectionKey<TreeSelectNodeContext> = Symbol.for('xh-tree-select-node')\nconst CONTENT_KEY: InjectionKey<TreeSelectContentContext> = Symbol.for('xh-tree-select-content')\n\nexport function provideTreeSelect(ctx: TreeSelectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTreeSelectContext(): TreeSelectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect 部件必须用在 XhTreeSelectRoot 内')\n  return ctx\n}\n\nexport function provideTreeSelectNode(ctx: TreeSelectNodeContext): void {\n  provide(NODE_KEY, ctx)\n}\n\nexport function useTreeSelectNodeContext(): TreeSelectNodeContext {\n  const ctx = inject(NODE_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect 节点子部件必须用在 XhTreeSelectItem 或 XhTreeSelectBranch 内')\n  return ctx\n}\n\nexport function provideTreeSelectContent(ctx: TreeSelectContentContext): void {\n  provide(CONTENT_KEY, ctx)\n}\n\nexport function useTreeSelectContentContext(): TreeSelectContentContext {\n  const ctx = inject(CONTENT_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect Empty / Loading 必须用在 XhTreeSelectContent 内')\n  return ctx\n}\n"],"mappings":";;AAwBA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AACtF,MAAM,cAAsD,OAAO,IAAI,wBAAwB;AAE/F,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mEAAmE;CACrF,OAAO;AACT;AAEA,SAAgB,yBAAyB,KAAqC;CAC5E,QAAQ,aAAa,GAAG;AAC1B;AAEA,SAAgB,8BAAwD;CACtE,MAAM,MAAM,OAAO,aAAa,IAAI;CACpC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4DAA4D;CAC9E,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tree-select/context.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// 提供 context 相关实现。\n\nimport type { TreeSelectNodeProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, Ref } from 'vue'\nimport type { TreeSelectContext } from './use-tree-select'\nimport { inject, provide } from 'vue'\n\n/** 节点声明的值，供 item / branch 的子部件复用同一份声明；层级、禁用与标签查询 collection。 */\nexport interface TreeSelectNodeContext {\n  node: ComputedRef<TreeSelectNodeProps>\n}\n\nexport interface TreeSelectContentContext {\n  authoredEmptyCount: Ref<number>\n  authoredLoadingCount: Ref<number>\n  registerEmpty: () => () => void\n  registerLoading: () => () => void\n}\n\nconst KEY: InjectionKey<TreeSelectContext> = Symbol.for('xh-tree-select')\nconst NODE_KEY: InjectionKey<TreeSelectNodeContext> = Symbol.for('xh-tree-select-node')\nconst CONTENT_KEY: InjectionKey<TreeSelectContentContext> = Symbol.for('xh-tree-select-content')\n\nexport function provideTreeSelect(ctx: TreeSelectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTreeSelectContext(): TreeSelectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect 部件必须用在 XhTreeSelectRoot 内')\n  return ctx\n}\n\nexport function provideTreeSelectNode(ctx: TreeSelectNodeContext): void {\n  provide(NODE_KEY, ctx)\n}\n\nexport function useTreeSelectNodeContext(): TreeSelectNodeContext {\n  const ctx = inject(NODE_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect 节点子部件必须用在 XhTreeSelectItem 或 XhTreeSelectBranch 内')\n  return ctx\n}\n\nexport function provideTreeSelectContent(ctx: TreeSelectContentContext): void {\n  provide(CONTENT_KEY, ctx)\n}\n\n/** 标签声明的值，供标签中的删除按钮复用同一份声明。 */\nexport interface TreeSelectTagContext {\n  value: () => string\n}\n\nconst TAG_KEY: InjectionKey<TreeSelectTagContext> = Symbol.for('xh-tree-select-tag')\n\nexport function provideTreeSelectTag(ctx: TreeSelectTagContext): void {\n  provide(TAG_KEY, ctx)\n}\n\nexport function useTreeSelectTagContext(): TreeSelectTagContext {\n  const ctx = inject(TAG_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect 标签子部件必须用在 XhTreeSelectTag 内')\n  return ctx\n}\n\nexport function useTreeSelectContentContext(): TreeSelectContentContext {\n  const ctx = inject(CONTENT_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TreeSelect Empty / Loading 必须用在 XhTreeSelectContent 内')\n  return ctx\n}\n"],"mappings":";;AAwBA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AACtF,MAAM,cAAsD,OAAO,IAAI,wBAAwB;AAE/F,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mEAAmE;CACrF,OAAO;AACT;AAEA,SAAgB,yBAAyB,KAAqC;CAC5E,QAAQ,aAAa,GAAG;AAC1B;AAOA,MAAM,UAA8C,OAAO,IAAI,oBAAoB;AAEnF,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT;AAEA,SAAgB,8BAAwD;CACtE,MAAM,MAAM,OAAO,aAAa,IAAI;CACpC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4DAA4D;CAC9E,OAAO;AACT"}

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

@@ -1,15 +1,19 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { TreeSelectApi, TreeSelectNode, TreeSelectSchema } from "@xihan-ui/headless";
+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' | 'value' | 'expandedValue' | 'visibleNodes' | 'focusedValue' | 'empty' | 'loading' | 'displayText' | 'canClear' | 'isSelected' | 'isIndeterminate' | 'isExpanded' | 'branchLoadState' | 'setOpen' | 'setValue' | 'setExpandedValue' | 'expand' | 'collapse' | 'retryBranch' | 'select' | 'clear'>;
+/** 默认插槽的载荷：展开与选中状态、可见行序列、搜索视图、多选的可见标签与折起的个数、节点状态判定与写值方法。 */
+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<{
   collection: {
     type: PropType<TreeSelectNode[]>;
   };
+  /** 完整 collection 与 Virtualizer 的焦点桥；count 必须等于当前 visibleNodes.length。 */
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   loadChildren: {
     type: PropType<TreeSelectProps["loadChildren"]>;
   };
@@ -37,6 +41,16 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   };
   defaultOpen: BooleanConstructor;
   multiple: BooleanConstructor;
+  /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
+  };
+  /** 浮层内搜索：展开时焦点先落在搜索框上，输入即把树裁到只剩命中的那几枝。 */
+  searchable: BooleanConstructor;
+  /** 自定义匹配规则；缺省为标签大小写不敏感包含。 */
+  filter: {
+    type: PropType<TreeSelectProps["filter"]>;
+  };
   cascade: BooleanConstructor;
   checkedStrategy: {
     type: PropType<TreeSelectProps["checkedStrategy"]>;
@@ -91,6 +105,7 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  clear: () => true;
   'value-change': (_details: PayloadOf<TreeSelectProps, "onValueChange">) => true;
   'expanded-value-change': (_details: PayloadOf<TreeSelectProps, "onExpandedValueChange">) => true;
   'open-change': (_details: PayloadOf<TreeSelectProps, "onOpenChange">) => true;
@@ -104,6 +119,10 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   collection: {
     type: PropType<TreeSelectNode[]>;
   };
+  /** 完整 collection 与 Virtualizer 的焦点桥；count 必须等于当前 visibleNodes.length。 */
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   loadChildren: {
     type: PropType<TreeSelectProps["loadChildren"]>;
   };
@@ -131,6 +150,16 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   };
   defaultOpen: BooleanConstructor;
   multiple: BooleanConstructor;
+  /** 多选标签最多显示的数量，其余折进 +N；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
+  };
+  /** 浮层内搜索：展开时焦点先落在搜索框上，输入即把树裁到只剩命中的那几枝。 */
+  searchable: BooleanConstructor;
+  /** 自定义匹配规则；缺省为标签大小写不敏感包含。 */
+  filter: {
+    type: PropType<TreeSelectProps["filter"]>;
+  };
   cascade: BooleanConstructor;
   checkedStrategy: {
     type: PropType<TreeSelectProps["checkedStrategy"]>;
@@ -185,13 +214,14 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").TreeSelectValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
+  onClear?: (() => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").TreeSelectOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
-  "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").TreeSelectExpandedValueChangeDetails) => any) | undefined;
-  "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
   "onBranch-load-start"?: ((_details: import("@xihan-ui/headless").TreeSelectBranchLoadStartDetails) => any) | undefined;
   "onBranch-load"?: ((_details: import("@xihan-ui/headless").TreeSelectBranchLoadDetails) => any) | undefined;
   "onBranch-load-error"?: ((_details: import("@xihan-ui/headless").TreeSelectBranchLoadErrorDetails) => any) | undefined;
+  "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").TreeSelectExpandedValueChangeDetails) => any) | undefined;
+  "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
 }>, {
   invalid: boolean;
   multiple: boolean;
@@ -202,6 +232,7 @@ declare const XhTreeSelectRoot: import("vue").DefineComponent<import("vue").Extr
   loading: boolean;
   readOnly: boolean;
   cascade: boolean;
+  searchable: boolean;
   clearable: boolean;
 }, SlotsType<{
   default?: (props: TreeSelectRootSlotProps) => VNode[];
@@ -219,6 +250,37 @@ declare const XhTreeSelectTrigger: import("vue").DefineComponent<{}, () => VNode
 declare const XhTreeSelectValueText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhTreeSelectTagList: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */
+declare const XhTreeSelectTagLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 一个选中值一个标签，即库内 tag 的 root（data-scope="tag"）：语气、尺寸与禁用从树选择传下，形态按控件的面派生；触发器内纯展示，触发器外配合 XhTreeSelectItemDeleteTrigger 可删除。 */
+declare const XhTreeSelectTag: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 它代表哪个选中值。 */
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 它代表哪个选中值。 */
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+declare const XhTreeSelectOverflowTag: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope="tag"），可及名使用 translations.deleteItem；点按移除所在标签的选中值。 */
+declare const XhTreeSelectItemDeleteTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTreeSelectIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -241,6 +303,10 @@ declare const XhTreeSelectPositioner: import("vue").DefineComponent<import("vue"
 declare const XhTreeSelectContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 浮层内搜索框：放在 content 中、tree 之前；没开 searchable 时带 hidden。 */
+declare const XhTreeSelectInput: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTreeSelectTree: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -324,5 +390,5 @@ declare const XhTreeSelectHiddenInput: import("vue").DefineComponent<{}, () => V
   [key: string]: any;
 }>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { TreeSelectRootSlotProps, XhTreeSelectBranch, XhTreeSelectBranchContent, XhTreeSelectBranchControl, XhTreeSelectBranchEmpty, XhTreeSelectBranchError, XhTreeSelectBranchIndicator, XhTreeSelectBranchLoading, XhTreeSelectBranchRetryTrigger, XhTreeSelectBranchText, XhTreeSelectBranchTrigger, XhTreeSelectClearTrigger, XhTreeSelectContent, XhTreeSelectControl, XhTreeSelectEmpty, XhTreeSelectFooter, XhTreeSelectHiddenInput, XhTreeSelectIndicator, XhTreeSelectItem, XhTreeSelectItemDescription, XhTreeSelectItemIndicator, XhTreeSelectItemSuffix, XhTreeSelectItemText, XhTreeSelectLabel, XhTreeSelectLoading, XhTreeSelectPositioner, XhTreeSelectRoot, XhTreeSelectTree, XhTreeSelectTrigger, XhTreeSelectValueText };
+export { TreeSelectRootSlotProps, 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 };
 //# sourceMappingURL=tree-select.d.ts.map

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,9 +1,11 @@
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
+import { slotIsPlainText } from "../../runtime/slot-content.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { provideTreeSelect, provideTreeSelectContent, provideTreeSelectNode, useTreeSelectContentContext, useTreeSelectContext, useTreeSelectNodeContext } from "./context.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";
 //#region src/components/tree-select/tree-select.ts
@@ -52,6 +54,8 @@ const XhTreeSelectRoot = defineComponent({
 	name: "XhTreeSelectRoot",
 	props: {
 		collection: { type: Array },
+		/** 完整 collection 与 Virtualizer 的焦点桥；count 必须等于当前 visibleNodes.length。 */
+		virtualizer: { type: Object },
 		loadChildren: { type: Function },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
 		label: { type: String },
@@ -67,6 +71,12 @@ const XhTreeSelectRoot = defineComponent({
 		},
 		defaultOpen: Boolean,
 		multiple: Boolean,
+		/** 多选标签最多显示的数量，其余折进 +N；默认 3。 */
+		maxTagCount: { type: Number },
+		/** 浮层内搜索：展开时焦点先落在搜索框上，输入即把树裁到只剩命中的那几枝。 */
+		searchable: Boolean,
+		/** 自定义匹配规则；缺省为标签大小写不敏感包含。 */
+		filter: { type: Function },
 		cascade: Boolean,
 		checkedStrategy: { type: String },
 		disabled: {
@@ -98,6 +108,7 @@ const XhTreeSelectRoot = defineComponent({
 		form: { type: String }
 	},
 	emits: {
+		"clear": () => true,
 		"value-change": (_details) => true,
 		"expanded-value-change": (_details) => true,
 		"open-change": (_details) => true,
@@ -125,7 +136,7 @@ const XhTreeSelectRoot = defineComponent({
 		const notifyBranchLoadStart = (details) => emit("branch-load-start", details);
 		const notifyBranchLoad = (details) => emit("branch-load", details);
 		const notifyBranchLoadError = (details) => emit("branch-load-error", details);
-		const ctx = useTreeSelect(withXhConfig("tree-select", useFormControlProps(props)), {
+		const ctx = useTreeSelect(withHandlers(withXhConfig("tree-select", useFormControlProps(props)), { onClear: () => emit("clear") }), {
 			onValueChange: notifyValue,
 			onExpandedValueChange: notifyExpanded,
 			onOpenChange: notifyOpen,
@@ -136,6 +147,8 @@ const XhTreeSelectRoot = defineComponent({
 		provideTreeSelect(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default ? slots.default({
 			open: ctx.api.value.open,
+			searching: ctx.api.value.searching,
+			inputValue: ctx.api.value.inputValue,
 			value: ctx.api.value.value,
 			expandedValue: ctx.api.value.expandedValue,
 			visibleNodes: ctx.api.value.visibleNodes,
@@ -144,6 +157,9 @@ const XhTreeSelectRoot = defineComponent({
 			loading: ctx.api.value.loading,
 			displayText: ctx.api.value.displayText,
 			canClear: ctx.api.value.canClear,
+			tags: ctx.api.value.tags,
+			overflowCount: ctx.api.value.overflowCount,
+			overflowText: ctx.api.value.overflowText,
 			isSelected: ctx.api.value.isSelected,
 			isIndeterminate: ctx.api.value.isIndeterminate,
 			isExpanded: ctx.api.value.isExpanded,
@@ -151,12 +167,14 @@ const XhTreeSelectRoot = defineComponent({
 			setOpen: ctx.api.value.setOpen,
 			setValue: ctx.api.value.setValue,
 			setExpandedValue: ctx.api.value.setExpandedValue,
+			setInputValue: ctx.api.value.setInputValue,
 			expand: ctx.api.value.expand,
 			collapse: ctx.api.value.collapse,
 			retryBranch: ctx.api.value.retryBranch,
 			select: ctx.api.value.select,
-			clear: ctx.api.value.clear
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), props.clearable) : []);
+			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) : []);
 	}
 });
 const XhTreeSelectLabel = defineComponent({
@@ -170,7 +188,12 @@ const XhTreeSelectControl = defineComponent({
 	name: "XhTreeSelectControl",
 	setup(_, { slots }) {
 		const ctx = useTreeSelectContext();
-		return () => h("div", ctx.api.value.getControlProps(), slots.default?.());
+		return () => h("div", {
+			...ctx.api.value.getControlProps(),
+			ref: (el) => {
+				ctx.controlRef.value = el;
+			}
+		}, slots.default?.());
 	}
 });
 const XhTreeSelectTrigger = defineComponent({
@@ -195,6 +218,62 @@ const XhTreeSelectValueText = defineComponent({
 		return () => h("span", ctx.api.value.getValueTextProps(), slots.default?.() ?? ctx.api.value.displayText);
 	}
 });
+const XhTreeSelectTagList = defineComponent({
+	name: "XhTreeSelectTagList",
+	setup(_, { slots }) {
+		const ctx = useTreeSelectContext();
+		return () => h("span", ctx.api.value.getTagListProps(), slots.default?.());
+	}
+});
+/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */
+const XhTreeSelectTagLabel = defineComponent({
+	name: "XhTreeSelectTagLabel",
+	setup(_, { slots }) {
+		const ctx = useTreeSelectContext();
+		return () => h("span", ctx.api.value.getTagLabelProps(), slots.default?.());
+	}
+});
+/**
+* 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把
+* 删除按钮挤出；作者自己写了节点则原样放行。与 XhTagRoot 同一规则。
+* 库自身填入的文字（+N，没有折叠时是空串）恒包 label，三个适配器渲染出同一棵树。
+*/
+function tagChildren(content) {
+	if (typeof content === "string") return [h(XhTreeSelectTagLabel, null, () => content)];
+	return slotIsPlainText(content) ? [h(XhTreeSelectTagLabel, null, () => content)] : content;
+}
+/** 一个选中值一个标签，即库内 tag 的 root（data-scope="tag"）：语气、尺寸与禁用从树选择传下，形态按控件的面派生；触发器内纯展示，触发器外配合 XhTreeSelectItemDeleteTrigger 可删除。 */
+const XhTreeSelectTag = defineComponent({
+	name: "XhTreeSelectTag",
+	props: { 
+	/** 它代表哪个选中值。 */
+value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useTreeSelectContext();
+		provideTreeSelectTag({ value: () => props.value });
+		return () => h("span", ctx.api.value.getTagProps({ value: props.value }), tagChildren(slots.default?.()));
+	}
+});
+/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+const XhTreeSelectOverflowTag = defineComponent({
+	name: "XhTreeSelectOverflowTag",
+	setup(_, { slots }) {
+		const ctx = useTreeSelectContext();
+		return () => h("span", ctx.api.value.getOverflowTagProps(), tagChildren(slots.default?.() ?? ctx.api.value.overflowText));
+	}
+});
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope="tag"），可及名使用 translations.deleteItem；点按移除所在标签的选中值。 */
+const XhTreeSelectItemDeleteTrigger = defineComponent({
+	name: "XhTreeSelectItemDeleteTrigger",
+	setup(_, { slots }) {
+		const ctx = useTreeSelectContext();
+		const tag = useTreeSelectTagContext();
+		return () => h("button", ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }), slots.default?.());
+	}
+});
 const XhTreeSelectIndicator = defineComponent({
 	name: "XhTreeSelectIndicator",
 	setup(_, { slots }) {
@@ -218,7 +297,7 @@ container: { type: Object } },
 	setup(props, { slots, attrs }) {
 		const ctx = useTreeSelectContext();
 		const bars = useScrollbars({
-			scrollable: () => ctx.contentRef.value,
+			scrollable: () => ctx.service.prop("virtualizer")?.getViewportElement() ?? ctx.treeRef.value,
 			axes: ["vertical", "horizontal"],
 			props: () => ({
 				dir: ctx.api.value.getPositionerProps().dir,
@@ -244,7 +323,7 @@ const XhTreeSelectAutoEmpty = defineComponent({
 		return () => content.authoredEmptyCount.value > 0 ? null : h("div", {
 			...ctx.api.value.getEmptyProps(),
 			"data-xh-tree-select-auto-empty": ""
-		}, ctx.api.value.translations.empty);
+		}, ctx.api.value.searching ? ctx.api.value.translations.noMatch : ctx.api.value.translations.empty);
 	}
 });
 const XhTreeSelectAutoLoading = defineComponent({
@@ -292,11 +371,24 @@ const XhTreeSelectContent = defineComponent({
 		]);
 	}
 });
+/** 浮层内搜索框：放在 content 中、tree 之前；没开 searchable 时带 hidden。 */
+const XhTreeSelectInput = defineComponent({
+	name: "XhTreeSelectInput",
+	setup() {
+		const ctx = useTreeSelectContext();
+		return () => h("input", ctx.api.value.getInputProps());
+	}
+});
 const XhTreeSelectTree = defineComponent({
 	name: "XhTreeSelectTree",
 	setup(_, { slots }) {
 		const ctx = useTreeSelectContext();
-		return () => h("div", ctx.api.value.getTreeProps(), slots.default?.());
+		return () => h("div", {
+			...ctx.api.value.getTreeProps(),
+			ref: (el) => {
+				ctx.treeRef.value = el;
+			}
+		}, slots.default?.());
 	}
 });
 const XhTreeSelectItem = defineComponent({
@@ -455,7 +547,7 @@ const XhTreeSelectEmpty = defineComponent({
 	setup(_, { slots }) {
 		const ctx = useTreeSelectContext();
 		onBeforeUnmount(useTreeSelectContentContext().registerEmpty());
-		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.() ?? ctx.api.value.translations.empty);
+		return () => h("div", ctx.api.value.getEmptyProps(), slots.default?.() ?? (ctx.api.value.searching ? ctx.api.value.translations.noMatch : ctx.api.value.translations.empty));
 	}
 });
 const XhTreeSelectLoading = defineComponent({
@@ -503,14 +595,21 @@ function renderNodes(nodes) {
 * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
 * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
 */
-function renderDefaultTree(collection, label, clearable) {
+function renderDefaultTree(collection, tags, searchable, label, clearable) {
 	return [
 		...label ? [h(XhTreeSelectLabel, null, () => label)] : [],
-		h(XhTreeSelectControl, null, () => [h(XhTreeSelectTrigger, null, () => [h(XhTreeSelectValueText), h(XhTreeSelectIndicator)]), ...clearable ? [h(XhTreeSelectClearTrigger)] : []]),
-		h(XhTreeSelectPositioner, null, () => [h(XhTreeSelectContent, null, () => h(XhTreeSelectTree, null, () => renderNodes(collection)))])
+		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))])])
 	];
 }
 //#endregion
-export { XhTreeSelectBranch, XhTreeSelectBranchContent, XhTreeSelectBranchControl, XhTreeSelectBranchEmpty, XhTreeSelectBranchError, XhTreeSelectBranchIndicator, XhTreeSelectBranchLoading, XhTreeSelectBranchRetryTrigger, XhTreeSelectBranchText, XhTreeSelectBranchTrigger, XhTreeSelectClearTrigger, XhTreeSelectContent, XhTreeSelectControl, XhTreeSelectEmpty, XhTreeSelectFooter, XhTreeSelectHiddenInput, XhTreeSelectIndicator, XhTreeSelectItem, XhTreeSelectItemDescription, XhTreeSelectItemIndicator, XhTreeSelectItemSuffix, XhTreeSelectItemText, XhTreeSelectLabel, XhTreeSelectLoading, XhTreeSelectPositioner, XhTreeSelectRoot, XhTreeSelectTree, XhTreeSelectTrigger, XhTreeSelectValueText };
+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 };
 
 //# sourceMappingURL=tree-select.js.map