iter(g166): 下拉选项支持分组标题

packages/skin/ui/ua.manifest.json

@@ -574,7 +574,7 @@
             "n": "options",
             "t": "OptionItem[]",
             "r": 1,
-            "d": "选项列表，每项 { value, label }"
+            "d": "选项列表，每项 { value, label }；每项可加 group 指定分组小标题"
           },
           {
             "n": "value",
@@ -616,7 +616,8 @@
           "选中项在弹层中用淡色弱化标记，不抢视觉焦点",
           "弹层展开时按 Esc 只收起下拉并回焦触发器；若下拉在弹窗/抽屉内，再按一次 Esc 才关外层（逐层关闭）",
           "searchable: true 时打开即聚焦搜索框，输入实时过滤；↑↓/Home/End 只在可见项间移动，无命中显示「无匹配选项」",
-          "需要允许「不选」的筛选项就开 clearable：有值时右缘出现 ×，点它把值写成空串并回调 onChange('')，键盘在收起态按 Delete / Backspace 等价"
+          "需要允许「不选」的筛选项就开 clearable：有值时右缘出现 ×，点它把值写成空串并回调 onChange('')，键盘在收起态按 Delete / Backspace 等价",
+          "候选多时给选项加 group：相邻同组合成一段、组首插灰色小标题（段间有分隔线），过滤后整组无命中时标题一起隐藏——搜索路径与键盘 ↑↓ 仍只走真实选项"
         ]
       },
       {
@@ -2885,7 +2886,7 @@
             "n": "options",
             "t": "CheckOption[]",
             "r": 1,
-            "d": "选项集合：value / label / 可选 disabled"
+            "d": "选项集合：value / label / 可选 disabled；每项可加 group 指定分组小标题"
           },
           {
             "n": "value",
@@ -2930,7 +2931,8 @@
           "点选项只切换该项、弹层不收起，适合连续多选；到 max 后未选项置灰不可点",
           "↑↓ 环形移动高亮、Enter 切换当前项、Esc 收起（与其它弹层共用一个 Esc 栈）",
           "value 传数组信号即受控，外部写入会同步标签区",
-          "选中项多时传 maxTagCount: 2 折叠：前 2 枚标签照常逐个删除，其余折成虚线「+N」，悬停 title 给出被折叠的项名，点它直接展开弹层；受控数组一变折叠数就重算"
+          "选中项多时传 maxTagCount: 2 折叠：前 2 枚标签照常逐个删除，其余折成虚线「+N」，悬停 title 给出被折叠的项名，点它直接展开弹层；受控数组一变折叠数就重算",
+          "候选分组同样用 group 字段：小标题是不可点击的 li（不占键盘高亮下标），选中后的标签顺序仍按点击顺序而非分组顺序"
         ]
       },
       {