@xen-orchestra/web-core 0.55.0 → 0.56.0

package/lib/locales/zh-Hans.json

@@ -15,11 +15,14 @@
   "action:add-network-in-xo-5": "在XO5中添加网络",
   "action:add-sort": "添加排序条件",
   "action:add-vifs-in-xo-5": "在XO5中添加虚拟网卡",
+  "action:attach": "挂载",
+  "action:attach-vdi": "@:attach-vdi",
   "action:boot-vm": "启动虚拟机",
   "action:change-state": "修改状态",
   "action:close": "关闭",
   "action:connect": "连接",
   "action:connect-another-pool": "连接其他资源池",
+  "action:connect-n-vbds": "连接1个VBD | 连接{n}个VBD",
   "action:connect-n-vifs": "连接1个虚拟网卡 | 连接{n}个虚拟网卡",
   "action:connect-pool": "连接资源池",
   "action:copy": "复制",
@@ -31,6 +34,8 @@
   "action:create-bonded-network": "创建聚合网络",
   "action:create-internal-network": "创建内网",
   "action:create-network": "创建网络",
+  "action:create-traffic-rule": "创建流量规则",
+  "action:create-vdi": "创建VDI",
   "action:delete": "删除",
   "action:delete-filter": "删除筛选条件",
   "action:delete-group": "删除分组",
@@ -42,6 +47,7 @@
   "action:deploy": "部署",
   "action:deploy-xoa": "部署XOA",
   "action:disconnect": "断开连接",
+  "action:disconnect-n-vbds": "断开1个VBD | 断开{n}个VBD",
   "action:disconnect-n-vifs": "断开1个虚拟网卡 | 断开{n}个虚拟网卡",
   "action:download-bugtools-archive": "下载故障排查工具包",
   "action:duplicate": "克隆",
@@ -78,6 +84,8 @@
   "action:reboot": "重启",
   "action:reformat": "重新格式化",
   "action:resume": "恢复运行",
+  "action:revert-to-snapshot": "回滚至快照",
+  "action:revert-vm-here": "在此主机还原虚拟机快照",
   "action:save": "保存",
   "action:search": "搜索",
   "action:search-treeview": "树形列表搜索",
@@ -130,6 +138,7 @@
   "all-done!": "全部完成！",
   "all-good!": "一切正常！",
   "all-quiet-launchpad": "系统运行平稳",
+  "allocated-space": "已分配容量",
   "allow": "允许",
   "allow-self-signed-ssl": "请在浏览器中允许自签名SSL证书",
   "and": "并且",
@@ -140,6 +149,9 @@
   "appearance": "外观设置",
   "aria:breadcrumb:label": "面包屑导航",
   "ascending": "升序",
+  "attach-vdi": "挂载已有VDI",
+  "attach-vdi:error-message": "挂载VDI时发生错误。请检查存储库、VDI、读写模式配置，确认虚拟机状态后重试。",
+  "attaching-vdi": "正在挂载VDI",
   "auto-generated": "自动生成",
   "auto-power": "自动启停",
   "available": "可用",
@@ -183,7 +195,6 @@
   "backups:vms-protection:active-protected": "已加入有效任务并受保护",
   "backups:vms-protection:active-unprotected": "已加入有效任务但未受保护",
   "backups:vms-protection:no-active-job": "未加入任何有效任务",
-  "backups:vms-protection:no-job": "未加入任何备份任务",
   "backups:vms-protection:protected": "已加入任务并受保护",
   "backups:vms-protection:tooltip": "虚拟机加入启用定时的备份任务且最近执行成功即为受保护",
   "backups:vms-protection:unprotected": "已加入任务但未受保护",
@@ -194,6 +205,7 @@
   "bond-mode": "聚合模式",
   "bond-status": "聚合状态",
   "boot-firmware": "启动固件",
+  "bootable": "可引导启动",
   "build-number": "编译版本号",
   "by": "依据",
   "bytes:gi": "吉字节",
@@ -202,10 +214,12 @@
   "cancel": "取消",
   "cbt-destroy-snapshot-data": "使用变更块追踪时清理快照数据",
   "change-block-tracking": "变更块追踪（CBT）",
-  "character-limit": "已输入 {count}/{max} 个字符",
+  "character-limit": "{count}/{max}个字符 | {count}/{max}个字符",
   "check-errors:": "查看错误信息:",
   "check-summing": "发送端校验和",
   "checkpoint-snapshot": "检查点快照",
+  "choose-network": "选择网络",
+  "choose-vif": "选择VIF",
   "click-to-display-alarms:": "点击查看告警:",
   "click-to-return-default-pool": "点击返回默认资源池",
   "cloud-config": "云端配置",
@@ -221,6 +235,7 @@
   "configure-in-xo-5": "前往XO5配置",
   "confirm-cancel?": "确定取消当前操作吗？",
   "confirm-delete": "即将删除{0}",
+  "confirm-vm-revert": "确认还原虚拟机快照",
   "connect": "连接",
   "connected": "已连接",
   "connected-to-ip": "已连接至 {ip}",
@@ -250,9 +265,12 @@
   "cpu-weight": "CPU权重",
   "cpus": "处理器数量",
   "crash-dump-storage-repository": "故障转储存储仓库",
+  "create-new-vdi": "新建VDI",
   "created-by": "创建人",
   "created-on": "创建时间",
   "creating-new-network": "正在创建新网络",
+  "creating-new-traffic-rule": "正在创建流量规则",
+  "creating-new-vdi": "正在创建VDI",
   "creation-date": "创建日期",
   "cron-pattern": "定时表达式",
   "current": "当前",
@@ -281,6 +299,13 @@
   "device-config": "设备配置",
   "dhcp": "自动获取IP",
   "direction": "传输方向",
+  "direction-and": "并且",
+  "direction-between": "双向",
+  "direction-from": "源地址",
+  "direction-from-and-to": "双向收发",
+  "direction-from-to": "源至目标单向",
+  "direction-on": "绑定端口",
+  "direction-to": "目标地址",
   "disabled": "已禁用",
   "disconnect-vifs-in-xo-5-to-delete-network": "删除网络前需断开所有关联虚拟网卡，可在{xo-5}中管理。",
   "disconnected": "已断开",
@@ -296,6 +321,7 @@
   "done": "完成",
   "drop": "丢弃",
   "duration": "时长",
+  "empty": "空",
   "enabled": "已启用",
   "end-date": "结束日期",
   "end-of-life": "生命周期终止",
@@ -316,16 +342,23 @@
   "fast-clone": "快速克隆",
   "fetching-fresh-data": "正在获取实时数据",
   "field:exceeds-max-characters": "输入内容不可超过{max}个字符。",
+  "file": "文件",
   "filter-actions": "筛选操作",
   "following-hosts-unreachable": "以下主机无法连通",
   "for-backup": "用于备份",
   "for-replication": "用于数据复制",
   "force-reboot-blocked": "禁止强制重启",
   "force-shutdown-blocked": "禁止强制关机",
+  "form:error:field-required": "{field}为必填项",
+  "form:error:integer": "必须填写整数",
+  "form:error:required": "此字段不能为空",
+  "form:warning:out-of-range": "数值范围应在{min}至{max}之间",
   "format": "格式化",
   "free-space": "剩余空间",
+  "from-vm": "来源虚拟机",
   "fullscreen": "全屏模式",
   "gateway": "网关",
+  "general": "常规",
   "general-information": "基本信息",
   "gpu": "显卡",
   "gpus": "显卡列表",
@@ -357,6 +390,7 @@
   "in-progress": "进行中",
   "included": "已包含",
   "info": "信息",
+  "info:vdi-attached-rw": "该VDI已以读写模式挂载至其他虚拟机。",
   "infos": "详情信息",
   "install-settings": "安装配置",
   "installed": "已安装",
@@ -365,6 +399,9 @@
   "interrupted": "任务中断",
   "invalid-field": "输入内容无效",
   "ip-address": "IP地址",
+  "ip-address-info": "规则支持单IP或CIDR子网格式。示例：192.168.1.10、10.20.0.0/16",
+  "ip-address-invalid": "IP地址格式错误。",
+  "ip-address-required": "IP地址为必填项。",
   "ip-addresses": "多组IP地址",
   "ip-mode": "IP获取方式",
   "ip-port-placeholder": "地址[:端口]",
@@ -378,18 +415,28 @@
   "iso-dvd": "ISO镜像/光驱",
   "job": "后台任务",
   "job-name": "任务名称",
+  "job:arg:allocated-space-required": "必须填写分配容量",
   "job:arg:bond-mode-required": "请选择聚合模式",
+  "job:arg:direction-required": "流量方向为必填项",
+  "job:arg:file-required": "文件路径为必填项",
   "job:arg:host-required": "请选择目标主机",
+  "job:arg:ip-range-required": "IP地址段为必填项",
   "job:arg:missing-payload": "缺少任务配置参数",
   "job:arg:name-required": "请填写名称",
   "job:arg:password-required": "请输入密码",
   "job:arg:pif-id-required": "请选择物理网卡",
   "job:arg:pif-ids-required": "至少选择一张物理网卡",
   "job:arg:pool-id-required": "请选择资源池",
+  "job:arg:port-required-for-tcp-udp": "TCP/UDP协议必须填写端口",
+  "job:arg:protocol-required": "通信协议为必填项",
+  "job:arg:sr-id-required": "存储库SR ID为必填项",
   "job:arg:sr-vdi-required": "请选择存储仓库与虚拟磁盘",
+  "job:arg:target-id-required": "目标对象ID为必填项",
   "job:arg:template-uuid-required": "请选择虚拟机模板",
   "job:arg:username-required": "请输入用户名",
+  "job:arg:vdi-id-required": "VDI ID为必填项",
   "job:arg:vlan-required": "请填写VLAN编号",
+  "job:arg:vm-id-required": "虚拟机ID为必填项",
   "job:connect:in-progress": "正在连接.…",
   "job:create:in-progress": "正在创建.…",
   "job:delete:in-progress": "正在删除.…",
@@ -450,6 +497,8 @@
   "job:vm-shutdown:blocked-operation": "禁止关闭虚拟机",
   "job:vm-shutdown:in-progress": "正在关闭虚拟机.…",
   "job:vm-shutdown:missing-vm": "暂无虚拟机可关机",
+  "job:vm-snapshot-revert:in-progress": "快照回滚执行中…",
+  "job:vm-snapshot-revert:missing-snapshot": "无可用快照用于回滚",
   "job:vm-snapshot:in-progress": "正在创建快照.…",
   "job:vm-snapshot:missing-vm": "暂无虚拟机可创建快照",
   "job:vm-start-on:bad-power-state": "虚拟机必须处于关机状态",
@@ -538,7 +587,7 @@
   "n-gb-left": "剩余{n}GB空间",
   "n-gb-required": "需要{n}GB存储空间",
   "n-hosts": "1台主机 | {n}台主机",
-  "n-hosts-awaiting-patch": "{n}台主机等待安装该补丁",
+  "n-hosts-awaiting-patch": "{n}台主机等待安装此补丁 | {n}台主机等待安装此补丁",
   "n-internal-networks": "1个内网 | {n}个内网",
   "n-missing": "缺失{n}项",
   "n-networks": "1个网络 | {n}个网络",
@@ -559,8 +608,10 @@
   "network-config": "网络配置",
   "network-create:warning:mtu-out-of-range": "MTU取值范围：{min}-{max}",
   "network-create:warning:vlan-out-of-range": "VLAN取值范围：0-{max}",
+  "network-default": "默认网络",
   "network-download": "下载速率",
   "network-information": "网络详情",
+  "network-required": "必须选择网络。",
   "network-throughput": "网络吞吐量",
   "network-upload": "上传速率",
   "networking": "网络管理",
@@ -573,6 +624,11 @@
   "new-network:creation-in-progress-message": "网络创建任务已后台运行，可前往{tasksPageLink}查看。",
   "new-network:error-message": "网络创建失败，请核对配置并确认主机状态后重试。",
   "new-network:select-interface": "选择物理网卡",
+  "new-traffic-rule:add": "新建流量防火墙规则",
+  "new-traffic-rule:error-message": "创建流量规则失败，请核对配置参数后重试。",
+  "new-vdi:accepted-formats": "支持磁盘格式：{formats}",
+  "new-vdi:add": "新建虚拟磁盘VDI",
+  "new-vdi:error-message": "创建VDI失败，请核对磁盘名称、存储库、分配容量后重试。",
   "new-vif": "新增虚拟网卡",
   "new-vm": "新建虚拟机",
   "new-vm:add": "创建虚拟机",
@@ -660,7 +716,7 @@
   "other-settings": "其他配置",
   "page-not-found": "页面不存在.…",
   "page-please-wait": "页面正在初始化，请稍候！",
-  "pagination:all": "全部",
+  "pagination:all": "@:all",
   "partially-connected": "部分已连接",
   "password": "密码",
   "password-invalid": "密码格式错误",
@@ -703,6 +759,8 @@
   "popup-first-connection-introduction": "欢迎使用Xen Orchestra 6正式版。",
   "popup-first-connection-upcoming-release": "后续版本将补齐用户管理、备份、批量操作等全部功能！",
   "port": "端口",
+  "port-invalid": "端口格式填写错误。",
+  "port-required": "端口为必填项。",
   "power-on-host-for-console": "开启主机后即可访问控制台",
   "power-on-mode": "开机模式",
   "power-on-vm-for-console": "开启虚拟机后即可访问控制台",
@@ -724,6 +782,7 @@
   "public-key": "公钥",
   "public-key-already-exists": "公钥已存在",
   "public-key-mandatory": "必须填写公钥",
+  "pv-vms-only": "仅半虚拟化(PV)虚拟机可用。",
   "pxe": "网络引导启动",
   "query-builder": "查询编辑器",
   "query-builder:label": "智能搜索器",
@@ -754,6 +813,7 @@
   "ram": "运行内存",
   "ram-provisioning": "内存资源分配",
   "ram-usage": "内存使用率",
+  "rate-limit": "速率限制",
   "read": "读取",
   "read-only": "只读模式",
   "reboot-blocked": "禁止重启",
@@ -782,6 +842,7 @@
   "rest-api": "后端接口",
   "retry": "重试",
   "root-by-default": "默认账号root。",
+  "rule-type": "规则类型",
   "run": "执行",
   "running-vm": "运行中虚拟机",
   "runs": "执行记录",
@@ -813,10 +874,13 @@
   "snapshot-created-on": "快照创建时间",
   "snapshot-delete-warning": "删除 1 个快照将造成不可逆数据丢失，该操作永久生效且无法撤销。| 批量删除 {n} 个快照将造成不可逆数据丢失，该操作永久生效且无法撤销。",
   "snapshot-mode": "快照存储模式",
+  "snapshot-revert-snapshot-before": "回滚前先对虚拟机创建快照",
+  "snapshot-revert-warning": "此操作会将虚拟机恢复至所选快照状态，快照之后所有的数据、配置与磁盘变更都会丢失，且该操作无法撤销。",
   "snapshots": "快照管理",
   "sockets-with-cores-per-socket": "{nSockets}插槽 × {nCores}核心/插槽",
   "software": "软件服务",
   "software-tooling": "软件与运维工具",
+  "source": "源",
   "source-backup-repository": "源端备份仓库",
   "space": "存储空间",
   "speed": "传输速率",
@@ -922,12 +986,15 @@
   "translation-tool": "词条翻译工具",
   "trigger": "触发条件",
   "type": "资源类型",
+  "unable-to-attach-vdi": "无法挂载虚拟磁盘(VDI)",
   "unable-to-connect-to": "无法连接至 {ip}",
   "unable-to-connect-to-the-pool": "资源池连接失败",
   "unable-to-connect-to-xo-server": "无法连接XO服务端。",
   "unable-to-create-new-bonded-network": "聚合网络创建失败",
   "unable-to-create-new-internal-network": "内网创建失败",
   "unable-to-create-new-network": "网络创建失败",
+  "unable-to-create-new-traffic-rule": "无法新建流量规则",
+  "unable-to-create-new-vdi": "无法新建虚拟磁盘（VDI）",
   "unable-to-delete-network": "网络删除失败",
   "unknown": "未知",
   "unlocked": "已解锁",
@@ -937,6 +1004,7 @@
   "untitled": "无标题",
   "untranslated-text-helper": "未完成翻译的内容默认显示英文。",
   "up-to-date": "已是最新版本",
+  "url": "地址链接 (URL)",
   "used": "已使用",
   "used-for-backup": "用于备份存储",
   "used-space": "已用空间",
@@ -949,6 +1017,9 @@
   "vcpus-assigned": "已分配虚拟CPU数量",
   "vdi": "虚拟磁盘",
   "vdi-delete-warning": "此操作将永久删除磁盘及全部数据，无法恢复。",
+  "vdi-description": "虚拟磁盘描述（VDI描述）",
+  "vdi-in-use": "虚拟磁盘正在占用（VDI已被使用）",
+  "vdi-name": "虚拟磁盘名称（VDI名称）",
   "vdi-throughput": "虚拟磁盘读写吞吐量",
   "vdis": "虚拟磁盘列表",
   "version": "版本",
@@ -961,6 +1032,7 @@
   "vif-disconnect-info": "虚拟机断开网络访问，网卡配置保留，可重新连接。",
   "vif-disconnect-title": "即将断开1个虚拟网卡 | 即将断开{n}个虚拟网卡",
   "vif-network-info": "虚拟网卡网络信息",
+  "vif-required": "必须配置虚拟网卡（VIF）。",
   "vif-status": "虚拟网卡状态",
   "vifs": "虚拟网卡列表",
   "viridian": "Windows虚拟化兼容模式",
@@ -985,6 +1057,7 @@
   "vm-protected-reboot": "该虚拟机禁止重启。",
   "vm-protected-shutdown": "该虚拟机禁止关机。",
   "vm-protected-suspend": "该虚拟机禁止休眠。",
+  "vm-required": "虚拟机为必填项。",
   "vm-running": "虚拟机运行中",
   "vm-shutdown": "虚拟机已关机",
   "vm-tools-missing": "未安装虚拟机配套工具",
@@ -1001,6 +1074,8 @@
   "vms-treeview": "虚拟机树形列表",
   "vtpm": "可信虚拟芯片",
   "warning": "警告",
+  "warning:vdi-already-attached": "所选虚拟磁盘已挂载至该虚拟机。",
+  "warning:vdi-sr": "此存储库(SR)与其他虚拟磁盘所属存储库不兼容，该存储库需为共享存储，或与其他虚拟磁盘存储库部署在同一主机。",
   "warnings": "警告提示",
   "weblate": "在线翻译平台",
   "welcome-to-xo6!": "欢迎使用XO6新版管理平台！",

package/lib/packages/remote-resource/define-remote-resource.ts

@@ -14,19 +14,19 @@ import {
   computed,
   type ComputedRef,
   type EffectScope,
+  effectScope,
   getCurrentScope,
+  type MaybeRef,
   type MaybeRefOrGetter,
   onScopeDispose,
   reactive,
   type Ref,
   ref,
   shallowRef,
-  triggerRef,
   toRef,
   toValue,
+  triggerRef,
   watch,
-  effectScope,
-  type MaybeRef,
 } from 'vue'
 
 const DEFAULT_CACHE_EXPIRATION_MS = 10_000
@@ -41,7 +41,12 @@ export function defineRemoteResource<
   url: string | ((...args: TArgs) => string)
   initialData: () => TData
   state?: (data: Ref<NoInfer<TData>>, context: ResourceContext<TArgs>) => TState
-  onDataReceived?: (data: Ref<NoInfer<TData>>, receivedData: any) => void
+  onDataReceived?: (
+    data: Ref<NoInfer<TData>>,
+    receivedData: any,
+    calledFrom: 'execute' | 'update',
+    context?: ResourceContext<TArgs>
+  ) => void
   cacheExpirationMs?: number | false
   pollingIntervalMs?: number | false
   stream?: boolean
@@ -50,7 +55,12 @@ export function defineRemoteResource<
 export function defineRemoteResource<TData, TState extends object, TArgs extends any[] = []>(config: {
   url: string | ((...args: TArgs) => string)
   state?: (data: Ref<TData | undefined>, context: ResourceContext<TArgs>) => TState
-  onDataReceived?: (data: Ref<TData | undefined>, receivedData: any) => void
+  onDataReceived?: (
+    data: Ref<TData | undefined>,
+    receivedData: any,
+    calledFrom: 'execute' | 'update',
+    context?: ResourceContext<TArgs>
+  ) => void
   cacheExpirationMs?: number | false
   pollingIntervalMs?: number | false
   stream?: boolean
@@ -64,7 +74,12 @@ export function defineRemoteResource<
   url: string | ((...args: TArgs) => string)
   initialData: () => TData
   state?: (data: Ref<NoInfer<TData>>, context: ResourceContext<TArgs>) => TState
-  onDataReceived?: (data: Ref<NoInfer<TData>>, receivedData: any) => void
+  onDataReceived?: (
+    data: Ref<NoInfer<TData>>,
+    receivedData: any,
+    calledFrom: 'execute' | 'update',
+    context?: ResourceContext<TArgs>
+  ) => void
   onDataRemoved?: (data: Ref<NoInfer<TData>>, receivedData: any) => void
   stream?: boolean
   initWatchCollection: () => {
@@ -86,7 +101,12 @@ export function defineRemoteResource<
   url: string | ((...args: TArgs) => string)
   initialData?: () => TData
   state?: (data: Ref<TData>, context: ResourceContext<TArgs>) => TState
-  onDataReceived?: (data: Ref<NoInfer<TData>>, receivedData: any) => void
+  onDataReceived?: (
+    data: Ref<NoInfer<TData>>,
+    receivedData: any,
+    calledFrom: 'execute' | 'update',
+    context?: ResourceContext<TArgs>
+  ) => void
   onDataRemoved?: (data: Ref<NoInfer<TData>>, receivedData: any) => void
   cacheExpirationMs?: number | false
   pollingIntervalMs?: number | false
@@ -161,33 +181,38 @@ export function defineRemoteResource<
 
   const onDataReceived =
     config.onDataReceived ??
-    ((data: Ref<TData>, receivedData: any, context?: ResourceContext<TArgs>) => {
+    ((data: Ref<TData>, receivedData: any, calledFrom: 'execute' | 'update', context?: ResourceContext<TArgs>) => {
       // allow to ignore some update (like for sub collection. E.g. vms/:id/vdis)
       if (watchCollection?.predicate?.(receivedData, context) === false) {
         return
       }
 
-      if (data.value === undefined || (Array.isArray(data.value) && Array.isArray(receivedData))) {
-        data.value = receivedData
-
-        if (watchCollection !== undefined && Array.isArray(data.value)) {
-          handleBuffer(data as Ref<TData[]>)
-          isBufferEventsProcessed = true
+      if (!Array.isArray(data.value)) {
+        if (data.value === undefined) {
+          data.value = receivedData
+        } else {
+          merge(data.value, receivedData)
         }
+
         return
       }
 
-      if (Array.isArray(data.value)) {
-        if (!isBufferEventsProcessed) {
-          bufferedEvents.push(['update', receivedData])
-        } else {
-          removeData(data.value, receivedData)
-          data.value.push(receivedData)
-        }
+      const store = data.value as TData[]
+
+      if (Array.isArray(receivedData)) {
+        data.value = receivedData as TData
+
         return
       }
 
-      merge(data.value, receivedData)
+      if (calledFrom === 'execute') {
+        store.push(receivedData)
+      } else if (!isBufferEventsProcessed) {
+        bufferedEvents.push(['update', receivedData])
+      } else {
+        removeData(store, receivedData)
+        store.push(receivedData)
+      }
     })
 
   const onDataRemoved =
@@ -292,13 +317,23 @@ export function defineRemoteResource<
         }
 
         if (config.stream) {
+          if (Array.isArray(data.value)) {
+            data.value = [] as TData
+          }
+
           for await (const event of readNDJSONStream(response.body)) {
-            onDataReceived(data, event)
-            flushData()
+            onDataReceived(data, event, 'execute', context)
+            void flushData()
+          }
+
+          if (watchCollection !== undefined && Array.isArray(data.value)) {
+            handleBuffer(data as Ref<TData[]>)
+            isBufferEventsProcessed = true
+            void flushData()
           }
         } else {
-          onDataReceived(data, await response.json())
-          flushData()
+          onDataReceived(data, await response.json(), 'execute', context)
+          void flushData()
         }
 
         isReady.value = true
@@ -324,12 +359,12 @@ export function defineRemoteResource<
           handlePost,
           resource,
           onDataReceived: receivedData => {
-            onDataReceived(data, receivedData, context)
-            flushData()
+            onDataReceived(data, receivedData, 'update', context)
+            void flushData()
           },
           onDataRemoved: receivedData => {
             onDataRemoved(data, receivedData, context)
-            flushData()
+            void flushData()
           },
         })
         await execute()

package/lib/packages/tree/types.ts

@@ -24,6 +24,12 @@ export type TreeNode<
   TDiscriminator = any,
 > = Leaf<TData, TDiscriminator> | Branch<TData, TChildNode, TDiscriminator>
 
+export type FlatTreeNode<TNode extends TreeNode = TreeNode> = {
+  id: TreeNodeId
+  node: TNode
+  depth: number
+}
+
 export type BaseTreeNodeOptions<TData extends object, TDiscriminator> = {
   discriminator?: TDiscriminator
   predicate?: (node: TreeNodeBase<TData, TDiscriminator>) => boolean | undefined

package/lib/packages/tree/use-tree.ts

@@ -1,14 +1,14 @@
 import { buildNodes } from '@core/packages/tree/build-nodes'
 import type {
   DefinitionToTreeNode,
+  FlatTreeNode,
   TreeContext,
   TreeNode,
   TreeNodeDefinition,
   TreeNodeId,
   UseTreeOptions,
 } from '@core/packages/tree/types'
-import { useTimeoutFn } from '@vueuse/core'
-import { computed, type MaybeRefOrGetter, nextTick, reactive, ref, toValue } from 'vue'
+import { computed, type MaybeRefOrGetter, reactive, ref, toValue } from 'vue'
 
 export function useTree<
   TDefinition extends TreeNodeDefinition,
@@ -53,6 +53,32 @@ export function useTree<
 
   const visibleNodes = computed(() => nodes.value.filter(node => !node.isExcluded))
 
+  const flatNodes = computed<FlatTreeNode[]>(() => {
+    const result: FlatTreeNode[] = []
+
+    const flatten = (list: TreeNode[]) => {
+      for (const node of list) {
+        result.push({ id: node.id, node, depth: node.depth })
+        if (node.isBranch && !node.isCollapsed) {
+          flatten(node.children)
+        }
+      }
+    }
+
+    flatten(visibleNodes.value)
+
+    return result
+  })
+
+  const flatNodeIndexById = computed(() => {
+    const index = new Map<TreeNodeId, number>()
+    const list = flatNodes.value
+    for (let i = 0; i < list.length; i++) {
+      index.set(list[i].id, i)
+    }
+    return index
+  })
+
   const getNode = (id: TreeNodeId | undefined) => (id !== undefined ? nodesMap.value.get(id) : undefined)
   const getNodes = (ids: TreeNodeId[]) => ids.map(getNode).filter(node => node !== undefined) as TreeNode[]
 
@@ -80,46 +106,19 @@ export function useTree<
     return undefined
   }
 
-  const scrollToNodeElement = async (id: string | number, options?: ScrollIntoViewOptions) => {
-    const node = findNodeByObjectId(nodes.value, id)
+  const expandToNode = (objectId: string | number): TreeNode | undefined => {
+    const node = findNodeByObjectId(nodes.value, objectId)
     if (!node) {
-      if (id) {
-        useTimeoutFn(async () => {
-          await nextTick()
-          await scrollToNodeElement(id, options)
-        }, 200)
-      }
-      return
+      return undefined
     }
 
-    getHierarchy(node).forEach(node => {
-      if (node.isBranch) {
-        node.toggleCollapse(false)
+    getHierarchy(node).forEach(ancestor => {
+      if (ancestor.isBranch) {
+        ancestor.toggleCollapse(false)
       }
     })
 
-    const nodeElement = document.querySelector<HTMLElement>(`[data-node-id="${id}"]`)
-
-    if (!nodeElement) {
-      useTimeoutFn(async () => {
-        await nextTick()
-        await scrollToNodeElement(id, options)
-      }, 200)
-      return
-    }
-
-    const hasChildren = node.isBranch && node.hasChildren
-    const cfg: ScrollIntoViewOptions = options ?? { block: hasChildren ? 'start' : 'center', behavior: 'smooth' }
-
-    if (hasChildren) {
-      nodeElement.style.scrollMarginTop = '0.8rem'
-
-      useTimeoutFn(async () => {
-        nodeElement.style.scrollMarginTop = ''
-      }, 1000)
-    }
-
-    nodeElement.scrollIntoView(cfg)
+    return node
   }
 
   const selectedNodes = computed(() => getNodes(Array.from(selectedIds.value.values())))
@@ -140,6 +139,8 @@ export function useTree<
 
   return {
     nodes: visibleNodes,
+    flatNodes,
+    flatNodeIndexById,
     activeId,
     activeNode,
     selectedIds,
@@ -148,6 +149,6 @@ export function useTree<
     collapsedIds,
     expandedIds,
     options,
-    scrollToNodeElement,
+    expandToNode,
   }
 }