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

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-23T08:10:07.974Z",
+  "generatedAt": "2026-10-23T08:45:45.013Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -130,7 +130,7 @@
     {
       "name": "@ui-arch/ui",
       "type": "skin-dom",
-      "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / radioGroup / card / badge / alert / toast / tooltip / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
+      "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / menu / radioGroup / card / badge / alert / toast / tooltip / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
       "tags": [
         "components",
         "dom",
@@ -148,6 +148,7 @@
           "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",
@@ -172,6 +173,8 @@
           "SwitchProps",
           "SelectProps",
           "RadioGroupProps",
+          "MenuItem",
+          "MenuProps",
           "OptionItem",
           "CardProps",
           "BadgeProps",
@@ -198,7 +201,7 @@
         "语义色 variant 四档：default|info / success / warning / danger，一律来自令牌，禁止硬编码颜色"
       ],
       "docs": {
-        "intro": "20 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
+        "intro": "21 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
         "steps": [
           "安装依赖：pnpm add @ui-arch/ui @ui-arch/frame（workspace 内自动链接）",
           "引入样式：在应用入口 import '@ui-arch/ui/ui.css'，暗色主题在根元素设 data-theme='dark'",
@@ -421,6 +424,51 @@
               "选中项在弹层中用淡色弱化标记，不抢视觉焦点"
             ]
           },
+          {
+            "id": "menu",
+            "title": "下拉菜单 Menu",
+            "demo": "sec-menu",
+            "props": [
+              {
+                "n": "label",
+                "t": "string",
+                "r": 1,
+                "d": "触发器文案"
+              },
+              {
+                "n": "items",
+                "t": "MenuItem[]",
+                "r": 1,
+                "d": "菜单条目：{ value, label, disabled?, danger?, divider? }"
+              },
+              {
+                "n": "variant",
+                "t": "'primary' | 'ghost'",
+                "d": "触发器视觉强度；缺省 ghost",
+                "df": "ghost"
+              },
+              {
+                "n": "align",
+                "t": "'start' | 'end'",
+                "d": "弹层对齐方向；缺省 start（与触发器左对齐）",
+                "df": "start"
+              },
+              {
+                "n": "onSelect",
+                "t": "(value: string) => void",
+                "k": 1,
+                "d": "选中回调，禁用项不触发"
+              }
+            ],
+            "example": "menu({ label: '操作', items: [{ value: 'edit', label: '编辑' }, { value: 'del', label: '删除', danger: true }], onSelect: (v) => console.log(v) })",
+            "steps": [
+              "准备 items 数组：value 是回调标识、label 是展示文案，插一条 { divider: true } 即可分出条目组",
+              "传 label 决定触发器文案；默认 ghost 轻量样式，主操作用 variant: 'primary'",
+              "点触发器展开弹层，点条目收起并触发 onSelect；点外部或按 Esc 也会收起（Esc 后焦点回到触发器）",
+              "键盘：Tab 聚焦触发器，↑↓ 展开并在可用条目间环形移动，Enter / Space 选中；disabled 项自动跳过",
+              "靠右对齐避免溢出时传 align: 'end'；危险操作给条目加 danger: true"
+            ]
+          },
           {
             "id": "radioGroup",
             "title": "单选组 RadioGroup",