iter(g133): 新增树形选择 treeSelect

packages/skin/ui/ua.manifest.json

@@ -78,7 +78,8 @@
       "typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮",
       "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列",
       "floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label",
-      "mentions(props)：@提及输入，textarea 内键入 @ 弹候选（名字 / 关键词过滤），↑↓ 环形移动、Enter/Tab 选中、Esc 只收本层，选中按光标替换并写回 value"
+      "mentions(props)：@提及输入，textarea 内键入 @ 弹候选（名字 / 关键词过滤），↑↓ 环形移动、Enter/Tab 选中、Esc 只收本层，选中按光标替换并写回 value",
+      "treeSelect(props)：树形选择，按钮触发弹层并复用 tree（搜索 / 多选 / 级联），单选选中即收起、多选保持展开，Esc 与点外收起"
     ],
     "keyTypes": [
       "ButtonProps",
@@ -3184,6 +3185,74 @@
           "弹层贴在输入框下沿而非跟随光标行（多行输入里更稳定，也不会被行高算错），需要跟随光标请自绘",
           "要限制可选人范围就在 items 上做过滤，组件不做远程搜索；远程场景用 onInput 拉数据后重建 items"
         ]
+      },
+      {
+        "id": "treeSelect",
+        "title": "树形选择 TreeSelect",
+        "demo": "sec-treeselect",
+        "props": [
+          {
+            "n": "nodes",
+            "t": "TreeNode[]",
+            "r": 1,
+            "d": "根节点列表，结构同 tree：key / label / children / disabled"
+          },
+          {
+            "n": "value",
+            "t": "Signal<string>",
+            "d": "单选选中 key；不传则内部维护"
+          },
+          {
+            "n": "checked",
+            "t": "Signal<string[]>",
+            "d": "多选勾选 key 集合（multi 时生效）；不传则内部维护"
+          },
+          {
+            "n": "multi",
+            "t": "boolean",
+            "df": "false",
+            "d": "多选模式：显示勾选框、父子级联、选中后弹层不收起"
+          },
+          {
+            "n": "searchable",
+            "t": "boolean",
+            "df": "false",
+            "d": "弹层内带搜索框（按标签过滤并保留父链）"
+          },
+          {
+            "n": "placeholder",
+            "t": "string",
+            "df": "请选择",
+            "d": "未选中时触发器文案"
+          },
+          {
+            "n": "disabled",
+            "t": "boolean",
+            "df": "false",
+            "d": "禁用整个触发器（不响应点击）"
+          },
+          {
+            "n": "onSelect",
+            "t": "(node: TreeNode) => void",
+            "k": 1,
+            "d": "单选选中回调（此时弹层已收起）"
+          },
+          {
+            "n": "onChange",
+            "t": "(keys: string[]) => void",
+            "k": 1,
+            "d": "多选勾选变更回调，传副本且父子已级联"
+          }
+        ],
+        "example": "const dept = signal(''); treeSelect({ nodes: [{ key: 'tech', label: '技术中心', children: [{ key: 'fe', label: '前端组' }] }], value: dept, searchable: true, onSelect: (n) => toast.info(n.label) })",
+        "steps": [
+          "表单里选层级归属（部门 / 分类 / 区域）用它，不要用 cascader——cascader 要求逐级选到叶子，treeSelect 允许选中间节点，也允许任意深度",
+          "单选默认选中即收起；要连续看结构就传 multi，勾选后弹层保持展开，触发器回显「已选 N 项」",
+          "需要在大树里找人/找分类就开 searchable：搜索按标签过滤并保留命中节点的父链，路径不会断",
+          "Esc 与其他弹层共享键盘栈（只关最上层），点外部也会收起；展开时焦点自动落到搜索框",
+          "选中值只存 key（单选 value / 多选 checked 数组），显示名由 nodes 反查——改 label 不需要迁移数据",
+          "禁用单个节点用 nodes 里的 disabled（该节点不可选，子节点仍可选）；禁用整个控件用 disabled"
+        ]
       }
     ]
   }