iter(g28): 浮层 Esc 逐层关闭，阻止冒泡连带关外层

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T03:37:32.721Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T03:38:39.607Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -274,6 +274,7 @@ const city = signal(''); select({ options: [{ value: 'bj', label: '北京' }], v
 2. 创建信号并传入 value；未传时组件内部自持状态
 3. 点击触发器展开弹层，点选项写回信号并收起；点外部或按 Esc 也会收起
 4. 选中项在弹层中用淡色弱化标记，不抢视觉焦点
+5. 弹层展开时按 Esc 只收起下拉并回焦触发器；若下拉在弹窗/抽屉内，再按一次 Esc 才关外层（逐层关闭）
 
 现场演示：apps/docs/demo.html#sec-form
 
@@ -301,6 +302,7 @@ menu({ label: '操作', items: [{ value: 'edit', label: '编辑' }, { value: 'de
 4. 条目要给快捷键提示时传 shortcut（如 '⌘K'）：右侧灰字展示，组件不绑定按键，实际快捷键由调用方在全局监听
 5. 键盘：Tab 聚焦触发器，↑↓ 展开并在可用条目间环形移动，Enter / Space 选中；disabled 项自动跳过
 6. 靠右对齐避免溢出时传 align: 'end'；危险操作给条目加 danger: true
+7. 展开时按 Esc 只收起菜单并回焦触发器，不会连带关闭所在弹窗（逐层关闭）
 
 现场演示：apps/docs/demo.html#sec-menu
 
@@ -591,6 +593,7 @@ popover({ title: '筛选条件', content: h('div', null, '任意可交互内容'
 3. content 里可以放 button / checkbox 等交互元素（tooltip 只能纯文本），点击弹层内部不会误关
 4. hover 场景传 trigger: 'hover' + delay 控制多快出场；placement: 'top' 让弹层往上翻
 5. 需要感知开合做副作用（如懒加载数据）时用 onOpenChange
+6. 展开时按 Esc 只收起气泡并回焦触发器，不会连带关闭所在弹窗（逐层关闭）
 
 现场演示：apps/docs/demo.html#sec-popover