iter: d01 新增下拉菜单 menu 组件（弹层/键盘导航/reduced-motion）

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T08:10:07.974Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T08:45:45.013Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -40,7 +40,7 @@
 
 ## @ui-arch/ui（skin-dom）v0.1.0
 
-20 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
+21 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
 
 ### button — 按钮 Button
 
@@ -182,6 +182,32 @@ const city = signal(''); select({ options: [{ value: 'bj', label: '北京' }], v
 
 现场演示：apps/docs/demo.html#sec-form
 
+### menu — 下拉菜单 Menu
+
+参数：
+
+- label（必填）：string —— 触发器文案
+- items（必填）：MenuItem[] —— 菜单条目：{ value, label, disabled?, danger?, divider? }
+- variant（默认 ghost）：'primary' | 'ghost' —— 触发器视觉强度；缺省 ghost
+- align（默认 start）：'start' | 'end' —— 弹层对齐方向；缺省 start（与触发器左对齐）
+- onSelect（回调）：(value: string) => void —— 选中回调，禁用项不触发
+
+示例：
+
+```
+menu({ label: '操作', items: [{ value: 'edit', label: '编辑' }, { value: 'del', label: '删除', danger: true }], onSelect: (v) => console.log(v) })
+```
+
+手把手：
+
+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
+
+现场演示：apps/docs/demo.html#sec-menu
+
 ### radioGroup — 单选组 RadioGroup
 
 参数：
@@ -517,6 +543,7 @@ API 速览：
 - checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - select(props)：自绘下拉选择（非原生 select），value 信号双向绑定，点外部 / Esc 关闭，选项弹层带微动画
+- menu(props)：下拉菜单，触发器 + 自绘弹层，条目支持禁用 / 危险 / 分隔线，↑↓ 环形导航，点外部 / Esc 关闭
 - radioGroup(props)：单选组，options + value 信号双向绑定
 - card(props, ...children)：卡片容器
 - badge(props)：徽标，variant = default | success | warning | danger