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

packages/skin/ui/ua.manifest.json

@@ -1,7 +1,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",
@@ -19,6 +19,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",
@@ -43,6 +44,8 @@
       "SwitchProps",
       "SelectProps",
       "RadioGroupProps",
+      "MenuItem",
+      "MenuProps",
       "OptionItem",
       "CardProps",
       "BadgeProps",
@@ -69,7 +72,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'",
@@ -292,6 +295,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",