@xen-orchestra/web-core 0.54.0 → 0.56.0

package/lib/locales/zh-Hans.json

@@ -15,12 +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个虚拟块设备 | 连接{n}个虚拟块设备",
+  "action:connect-n-vbds": "连接1个VBD | 连接{n}个VBD",
   "action:connect-n-vifs": "连接1个虚拟网卡 | 连接{n}个虚拟网卡",
   "action:connect-pool": "连接资源池",
   "action:copy": "复制",
@@ -32,20 +34,20 @@
   "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": "删除分组",
   "action:delete-n-networks": "删除1个网络 | 删除{n}个网络",
   "action:delete-n-snapshots": "删除1个快照 | 删除{n}个快照",
-  "action:delete-n-vbds": "删除1个虚拟块设备 | 删除{n}个虚拟块设备",
   "action:delete-n-vdis": "删除1个虚拟磁盘 | 删除{n}个虚拟磁盘",
   "action:delete-n-vifs": "删除1个虚拟网卡 | 删除{n}个虚拟网卡",
   "action:delete-n-vms": "删除1台虚拟机 | 删除{n}台虚拟机",
-  "action:delete-vbd": "删除虚拟块设备",
   "action:deploy": "部署",
   "action:deploy-xoa": "部署XOA",
   "action:disconnect": "断开连接",
-  "action:disconnect-n-vbds": "断开1个虚拟块设备 | 断开{n}个虚拟块设备",
+  "action:disconnect-n-vbds": "断开1个VBD | 断开{n}个VBD",
   "action:disconnect-n-vifs": "断开1个虚拟网卡 | 断开{n}个虚拟网卡",
   "action:download-bugtools-archive": "下载故障排查工具包",
   "action:duplicate": "克隆",
@@ -82,6 +84,8 @@
   "action:reboot": "重启",
   "action:reformat": "重新格式化",
   "action:resume": "恢复运行",
+  "action:revert-to-snapshot": "回滚至快照",
+  "action:revert-vm-here": "在此主机还原虚拟机快照",
   "action:save": "保存",
   "action:search": "搜索",
   "action:search-treeview": "树形列表搜索",
@@ -134,6 +138,7 @@
   "all-done!": "全部完成！",
   "all-good!": "一切正常！",
   "all-quiet-launchpad": "系统运行平稳",
+  "allocated-space": "已分配容量",
   "allow": "允许",
   "allow-self-signed-ssl": "请在浏览器中允许自签名SSL证书",
   "and": "并且",
@@ -144,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": "可用",
@@ -187,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": "已加入任务但未受保护",
@@ -198,6 +205,7 @@
   "bond-mode": "聚合模式",
   "bond-status": "聚合状态",
   "boot-firmware": "启动固件",
+  "bootable": "可引导启动",
   "build-number": "编译版本号",
   "by": "依据",
   "bytes:gi": "吉字节",
@@ -206,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": "云端配置",
@@ -225,6 +235,7 @@
   "configure-in-xo-5": "前往XO5配置",
   "confirm-cancel?": "确定取消当前操作吗？",
   "confirm-delete": "即将删除{0}",
+  "confirm-vm-revert": "确认还原虚拟机快照",
   "connect": "连接",
   "connected": "已连接",
   "connected-to-ip": "已连接至 {ip}",
@@ -254,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": "当前",
@@ -285,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": "已断开",
@@ -300,6 +321,7 @@
   "done": "完成",
   "drop": "丢弃",
   "duration": "时长",
+  "empty": "空",
   "enabled": "已启用",
   "end-date": "结束日期",
   "end-of-life": "生命周期终止",
@@ -320,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": "显卡列表",
@@ -361,6 +390,7 @@
   "in-progress": "进行中",
   "included": "已包含",
   "info": "信息",
+  "info:vdi-attached-rw": "该VDI已以读写模式挂载至其他虚拟机。",
   "infos": "详情信息",
   "install-settings": "安装配置",
   "installed": "已安装",
@@ -369,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": "地址[:端口]",
@@ -382,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": "正在删除.…",
@@ -454,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": "虚拟机必须处于关机状态",
@@ -507,7 +552,6 @@
   "manual": "手动模式",
   "manufacturer-info": "设备厂商信息",
   "master": "主控主机",
-  "maximum-cpu-limit": "CPU最大上限",
   "maximum-dynamic-memory": "动态内存最大值",
   "maximum-static-memory": "静态内存最大值",
   "memory": "内存",
@@ -515,7 +559,6 @@
   "merge-backups-synchronously": "同步合并备份文件",
   "message": "消息提示",
   "migration-compression": "虚拟机迁移压缩策略",
-  "minimum-cpu-limit": "CPU最小预留值",
   "minimum-dynamic-memory": "动态内存最小值",
   "minimum-static-memory": "静态内存最小值",
   "missing-patches": "缺失系统补丁",
@@ -540,12 +583,11 @@
   "multi-creation": "批量创建",
   "multi-pathing": "多路径存储",
   "n-bonded-networks": "1个聚合网络 | {n}个聚合网络",
-  "n-cpus": "1颗处理器 | {n}颗处理器",
   "n-gb": "{n}GB",
   "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}个网络",
@@ -566,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": "网络管理",
@@ -580,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": "创建虚拟机",
@@ -667,7 +716,7 @@
   "other-settings": "其他配置",
   "page-not-found": "页面不存在.…",
   "page-please-wait": "页面正在初始化，请稍候！",
-  "pagination:all": "全部",
+  "pagination:all": "@:all",
   "partially-connected": "部分已连接",
   "password": "密码",
   "password-invalid": "密码格式错误",
@@ -710,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": "开启虚拟机后即可访问控制台",
@@ -731,6 +782,7 @@
   "public-key": "公钥",
   "public-key-already-exists": "公钥已存在",
   "public-key-mandatory": "必须填写公钥",
+  "pv-vms-only": "仅半虚拟化(PV)虚拟机可用。",
   "pxe": "网络引导启动",
   "query-builder": "查询编辑器",
   "query-builder:label": "智能搜索器",
@@ -761,6 +813,7 @@
   "ram": "运行内存",
   "ram-provisioning": "内存资源分配",
   "ram-usage": "内存使用率",
+  "rate-limit": "速率限制",
   "read": "读取",
   "read-only": "只读模式",
   "reboot-blocked": "禁止重启",
@@ -789,6 +842,7 @@
   "rest-api": "后端接口",
   "retry": "重试",
   "root-by-default": "默认账号root。",
+  "rule-type": "规则类型",
   "run": "执行",
   "running-vm": "运行中虚拟机",
   "runs": "执行记录",
@@ -820,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": "传输速率",
@@ -929,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": "已解锁",
@@ -944,6 +1004,7 @@
   "untitled": "无标题",
   "untranslated-text-helper": "未完成翻译的内容默认显示英文。",
   "up-to-date": "已是最新版本",
+  "url": "地址链接 (URL)",
   "used": "已使用",
   "used-for-backup": "用于备份存储",
   "used-space": "已用空间",
@@ -951,16 +1012,14 @@
   "user-config": "用户自定义配置",
   "username": "用户名",
   "uuid": "唯一识别码",
-  "vbd-connect-title": "即将连接1个虚拟块设备 | 即将连接{n}个虚拟块设备",
-  "vbd-delete-info": "仅解除磁盘与虚拟机挂载关系，不会删除磁盘数据，可重新挂载。",
-  "vbd-delete-title": "即将删除1个虚拟块设备 | 即将删除{n}个虚拟块设备",
-  "vbd-disconnect-info": "虚拟机暂时无法访问该磁盘，磁盘保留挂载状态可随时重连。",
-  "vbd-disconnect-title": "即将断开1个虚拟块设备 | 即将断开{n}个虚拟块设备",
   "vcpu": "虚拟处理器",
   "vcpus": "虚拟CPU",
   "vcpus-assigned": "已分配虚拟CPU数量",
   "vdi": "虚拟磁盘",
   "vdi-delete-warning": "此操作将永久删除磁盘及全部数据，无法恢复。",
+  "vdi-description": "虚拟磁盘描述（VDI描述）",
+  "vdi-in-use": "虚拟磁盘正在占用（VDI已被使用）",
+  "vdi-name": "虚拟磁盘名称（VDI名称）",
   "vdi-throughput": "虚拟磁盘读写吞吐量",
   "vdis": "虚拟磁盘列表",
   "version": "版本",
@@ -973,6 +1032,7 @@
   "vif-disconnect-info": "虚拟机断开网络访问，网卡配置保留，可重新连接。",
   "vif-disconnect-title": "即将断开1个虚拟网卡 | 即将断开{n}个虚拟网卡",
   "vif-network-info": "虚拟网卡网络信息",
+  "vif-required": "必须配置虚拟网卡（VIF）。",
   "vif-status": "虚拟网卡状态",
   "vifs": "虚拟网卡列表",
   "viridian": "Windows虚拟化兼容模式",
@@ -997,6 +1057,7 @@
   "vm-protected-reboot": "该虚拟机禁止重启。",
   "vm-protected-shutdown": "该虚拟机禁止关机。",
   "vm-protected-suspend": "该虚拟机禁止休眠。",
+  "vm-required": "虚拟机为必填项。",
   "vm-running": "虚拟机运行中",
   "vm-shutdown": "虚拟机已关机",
   "vm-tools-missing": "未安装虚拟机配套工具",
@@ -1013,6 +1074,8 @@
   "vms-treeview": "虚拟机树形列表",
   "vtpm": "可信虚拟芯片",
   "warning": "警告",
+  "warning:vdi-already-attached": "所选虚拟磁盘已挂载至该虚拟机。",
+  "warning:vdi-sr": "此存储库(SR)与其他虚拟磁盘所属存储库不兼容，该存储库需为共享存储，或与其他虚拟磁盘存储库部署在同一主机。",
   "warnings": "警告提示",
   "weblate": "在线翻译平台",
   "welcome-to-xo6!": "欢迎使用XO6新版管理平台！",

package/lib/packages/drawer/DrawerProvider.vue

@@ -0,0 +1,17 @@
+<template>
+  <slot />
+</template>
+
+<script lang="ts" setup>
+import { IK_DRAWER, type RegisteredDrawer } from '@core/packages/drawer/types.ts'
+import { computed, provide } from 'vue'
+
+const { drawer } = defineProps<{
+  drawer: RegisteredDrawer
+}>()
+
+provide(
+  IK_DRAWER,
+  computed(() => drawer)
+)
+</script>

package/lib/packages/drawer/README.md

@@ -0,0 +1,189 @@
+# Drawer System
+
+### Drawers list component
+
+Add `VtsDrawerList` once in your app layout. It renders all active drawers from the store.
+
+```vue
+<!-- App.vue -->
+<template>
+  ...
+  <VtsDrawerList />
+</template>
+
+<script lang="ts" setup>
+import VtsDrawerList from '@core/components/drawer/VtsDrawerList.vue'
+</script>
+```
+
+### Opening a drawer (`useDrawer` composable)
+
+```ts
+const openMyDrawer = useDrawer({
+  component: import('path/to/MyDrawer.vue'),
+  props: {
+    foo: 'Foo',
+  },
+  onConfirm: () => console.log('Confirmed!'),
+  onCancel: () => console.log('Cancelled!'),
+})
+```
+
+```html
+<button @click="openMyDrawer()">Open drawer</button>
+```
+
+| Property              | Type                                                              | Required | Default     | Description                                |
+| --------------------- | ----------------------------------------------------------------- | :------: | ----------- | ------------------------------------------ |
+| component             | `Promise<Component>`                                              |    ✓     |             | `import('path/to/drawer.vue')`             |
+| props                 | `Record<string, MaybeRef<any>>`                                   |          | `{}`        | Props passed to the drawer component       |
+| onConfirm             | `(...args: any[]) => TConfirmPayload \| Promise<TConfirmPayload>` |          | `undefined` | Called when the drawer is confirmed        |
+| onCancel              | `(...args: any[]) => TCancelPayload \| Promise<TCancelPayload>`   |          | `undefined` | Called when the drawer is cancelled        |
+| keepOpenOnRouteChange | `boolean`                                                         |          | `false`     | By default the drawer closes on navigation |
+
+`useDrawer()` with no arguments returns the raw `openDrawer(id, config)` function for advanced use cases where you manage the drawer ID yourself.
+
+### Drawer component
+
+A drawer component uses `VtsDrawer` and its sub-components:
+
+```vue
+<!-- MyDrawer.vue -->
+<template>
+  <VtsDrawer :dismissible>
+    <template #title>My Drawer</template>
+    <template #content>
+      <!-- your content here -->
+    </template>
+    <template #buttons>
+      <VtsDrawerCancelButton />
+      <VtsDrawerConfirmButton>Save</VtsDrawerConfirmButton>
+    </template>
+  </VtsDrawer>
+</template>
+
+<script lang="ts" setup>
+import VtsDrawer from '@core/components/drawer/VtsDrawer.vue'
+import VtsDrawerCancelButton from '@core/components/drawer/VtsDrawerCancelButton.vue'
+import VtsDrawerConfirmButton from '@core/components/drawer/VtsDrawerConfirmButton.vue'
+
+defineProps<{
+  dismissible?: boolean
+  // Injected by VtsDrawerList: true when this drawer is the topmost in the stack.
+  // Pass it through to VtsDrawer so only the current drawer reacts to Escape.
+  current?: boolean
+}>()
+</script>
+```
+
+`VtsDrawer` props:
+
+| Prop          | Type      | Default     | Description                                               |
+| ------------- | --------- | ----------- | --------------------------------------------------------- |
+| `dismissible` | `boolean` | `false`     | Allows closing via backdrop click, X button, and Escape   |
+| `isOpen`      | `boolean` | `undefined` | Controls visibility externally (uncontrolled by default)  |
+| `current`     | `boolean` | `undefined` | Pass through from parent props — controls Escape handling |
+
+When `isOpen` is omitted, `VtsDrawer` manages its own visibility internally (uncontrolled mode). In controlled mode (`:is-open` provided), the `dismiss` event is emitted instead of closing automatically.
+
+`VtsDrawerCancelButton` and `VtsDrawerConfirmButton` accept an optional `onClick` prop. When provided, the button emits a `click` event instead of triggering `onCancel`/`onConfirm`:
+
+```vue
+<VtsDrawerCancelButton :on-click="handleCustomCancel" />
+```
+
+### Opening with arguments
+
+```ts
+const openMyDrawer = useDrawer((name: string) => ({
+  component: import('path/to/MyDrawer.vue'),
+  props: { name },
+}))
+
+openMyDrawer('John')
+```
+
+### Payload and response
+
+Payloads are fully typed based on the return type of `onConfirm` and `onCancel`:
+
+```ts
+const openMyDrawer = useDrawer({
+  component: import('path/to/MyDrawer.vue'),
+  onConfirm: () => 'saved',
+  onCancel: () => 'aborted',
+})
+
+const result = await openMyDrawer()
+
+if (result.confirmed) {
+  result.payload // string
+} else {
+  result.payload // string
+}
+```
+
+If `onConfirm` or `onCancel` throws, the promise rejects with the thrown error.
+
+### `onConfirm` and `onCancel` event args
+
+If your drawer component defines args for `confirm` and `cancel` events, you'll get them as arguments of the `onConfirm` and `onCancel` callbacks:
+
+```vue
+<!-- MyDrawer.vue -->
+<script lang="ts" setup>
+defineEmits<{
+  confirm: [value: string]
+  cancel: []
+}>()
+</script>
+```
+
+```ts
+const openMyDrawer = useDrawer({
+  component: import('path/to/MyDrawer.vue'),
+  onConfirm: (value: string) => console.log('Confirmed with', value),
+})
+```
+
+### Busy state
+
+If `onConfirm` or `onCancel` returns a `Promise`, the buttons show a busy indicator while the promise is pending.
+
+**Important asymmetry:**
+
+- `onConfirm` closes the drawer **optimistically** before the async work runs. The drawer is gone before `await` settles.
+- `onCancel` waits for the async work to complete **before** closing the drawer.
+
+```ts
+const openMyDrawer = useDrawer({
+  component: import('path/to/MyDrawer.vue'),
+  onConfirm: async () => {
+    await saveToServer() // drawer is already closed while this runs
+  },
+  onCancel: async () => {
+    await cleanup() // drawer stays open while this runs, then closes
+  },
+})
+```
+
+### Aborting close
+
+Return `ABORT_DRAWER` from `onCancel` to keep the drawer open (e.g. to show a confirmation prompt):
+
+```ts
+const openMyDrawer = useDrawer({
+  component: import('path/to/MyDrawer.vue'),
+  onCancel: async () => {
+    if (!hasUnsavedChanges()) {
+      return
+    }
+    const confirmed = await confirmDiscard()
+    if (!confirmed) {
+      return ABORT_DRAWER // drawer stays open
+    }
+  },
+})
+```
+
+> **Note:** Returning `ABORT_DRAWER` from `onConfirm` does **not** keep the drawer open. The drawer is closed optimistically before `onConfirm` runs. Returning `ABORT_DRAWER` permanently prevents the promise from resolving — avoid it in `onConfirm`.