iter: d25 menu 条目支持快捷键提示

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T09:05:40.038Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T09:06:10.925Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -224,7 +224,7 @@ const city = signal(''); select({ options: [{ value: 'bj', label: '北京' }], v
 参数：
 
 - label（必填）：string —— 触发器文案
-- items（必填）：MenuItem[] —— 菜单条目：{ value, label, disabled?, danger?, divider? }
+- items（必填）：MenuItem[] —— 菜单条目：{ value, label, disabled?, danger?, divider?, shortcut? }
 - variant（默认 ghost）：'primary' | 'ghost' —— 触发器视觉强度；缺省 ghost
 - align（默认 start）：'start' | 'end' —— 弹层对齐方向；缺省 start（与触发器左对齐）
 - onSelect（回调）：(value: string) => void —— 选中回调，禁用项不触发
@@ -240,8 +240,9 @@ menu({ label: '操作', items: [{ value: 'edit', label: '编辑' }, { value: 'de
 1. 准备 items 数组：value 是回调标识、label 是展示文案，插一条 { divider: true } 即可分出条目组
 2. 传 label 决定触发器文案；默认 ghost 轻量样式，主操作用 variant: 'primary'
 3. 点触发器展开弹层，点条目收起并触发 onSelect；点外部或按 Esc 也会收起（Esc 后焦点回到触发器）
-4. 键盘：Tab 聚焦触发器，↑↓ 展开并在可用条目间环形移动，Enter / Space 选中；disabled 项自动跳过
-5. 靠右对齐避免溢出时传 align: 'end'；危险操作给条目加 danger: true
+4. 条目要给快捷键提示时传 shortcut（如 '⌘K'）：右侧灰字展示，组件不绑定按键，实际快捷键由调用方在全局监听
+5. 键盘：Tab 聚焦触发器，↑↓ 展开并在可用条目间环形移动，Enter / Space 选中；disabled 项自动跳过
+6. 靠右对齐避免溢出时传 align: 'end'；危险操作给条目加 danger: true
 
 现场演示：apps/docs/demo.html#sec-menu