iter(g09): 新增 descriptions 描述列表组件

packages/skin/ui/ua.manifest.json

@@ -49,7 +49,8 @@
       "dataTable(props)：数据表格，粘性表头 / 行选择（全选三态）/ 排序 / 筛选 / 分页 / 空状态；loading 为真时数据行换骨架行且筛选/翻页禁用，内核为 table-core",
       "image(props)：图片，缩略图点击 / 回车开遮罩大图预览（Esc 或点击遮罩关闭），width 控制缩略宽",
       "timeline(props)：时间线，items 按序渲染纵向事件流（标题 / 时间 / 正文 + 语义色节点），mode 控制轴线左右，pending 追加进行中节点",
-      "segmented(props)：分段控制器，胶囊分段 + 滑动滑块，value 信号双向绑定，←→ 环形导航，整组或单项可禁用"
+      "segmented(props)：分段控制器，胶囊分段 + 滑动滑块，value 信号双向绑定，←→ 环形导航，整组或单项可禁用",
+      "descriptions(props)：描述列表，items(label/value/span) 铺进 column 列网格，bordered 切表格形态，窄屏自动单列"
     ],
     "keyTypes": [
       "ButtonProps",
@@ -89,7 +90,9 @@
       "AvatarProps",
       "TimelineItem",
       "TimelineProps",
-      "SegmentedProps"
+      "SegmentedProps",
+      "DescriptionItem",
+      "DescriptionsProps"
     ]
   },
   "usage": "const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')",
@@ -1534,6 +1537,51 @@
           "滑块几何由组件测量按钮位置得到，不要在外部改按钮宽度 / 内边距，否则需自行重渲染",
           "需要带图标或更复杂布局的分段，改用 radioGroup + 自定义样式"
         ]
+      },
+      {
+        "id": "descriptions",
+        "title": "描述列表 Descriptions",
+        "demo": "sec-descriptions",
+        "props": [
+          {
+            "n": "items",
+            "t": "DescriptionItem[]",
+            "r": 1,
+            "d": "描述项列表：每项含 label（字段名）、value（字符串 / DOM / 响应式函数）、span（跨列数）"
+          },
+          {
+            "n": "column",
+            "t": "1 | 2 | 3 | 4",
+            "d": "桌面列数；缺省 3，窄屏（≤640px）由样式表降为单列",
+            "df": "3"
+          },
+          {
+            "n": "bordered",
+            "t": "boolean",
+            "d": "表格形态（带分隔线与字段名底纹）；缺省 false 纯网格",
+            "df": "false"
+          },
+          {
+            "n": "size",
+            "t": "'sm' | 'md'",
+            "d": "尺寸档位；缺省 md",
+            "df": "md"
+          },
+          {
+            "n": "title",
+            "t": "string",
+            "d": "分组标题；缺省不渲染标题行"
+          }
+        ],
+        "example": "descriptions({ title: '订单信息', column: 2, bordered: true, items: [{ label: '订单号', value: 'RB-2048' }, { label: '金额', value: '¥1,280.00' }, { label: '备注', value: '加急', span: 2 }] })",
+        "steps": [
+          "详情页 / 抽屉里展示只读字段用它，不要用 form（form 承载输入与校验）",
+          "column 按信息密度定：字段多且短用 3-4 列，字段长（地址、备注）用 2 列并配 span 占整行",
+          "value 支持任意 DOM：放 tag、badge、button 都可以；要给值做响应式更新就传函数 () => 内容",
+          "bordered: true 是表格形态（适合打印与密集信息），纯网格形态更轻，适合卡片内嵌",
+          "窄屏自动降为单列，无需在调用方写媒体查询",
+          "纯展示组件，无状态无回调：值变了由调用方重新渲染或传函数式 value"
+        ]
       }
     ]
   }