iter(g169): 表单字段支持跨列

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-26T08:13:59.371Z",
+  "generatedAt": "2026-10-26T08:15:48.744Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -1898,6 +1898,11 @@
                 "t": "string",
                 "d": "控件下方辅助说明（格式提示等）；报错时让位给错误文案"
               },
+              {
+                "n": "（formItem）span",
+                "t": "number",
+                "d": "多列表单里本字段占几列（如整宽的多行备注）；单列布局或窄屏下自动退回整行"
+              },
               {
                 "n": "onReset",
                 "t": "() => void",
@@ -1929,7 +1934,8 @@
               "rules.validator 返回 Promise 即为异步规则（如「邀请码是否已被使用」远程校验）：提交时逐项 await，校验期间提交按钮禁用，结论按轮次取舍避免乱序覆盖",
               "formItem 返回 { el, validate, validateAsync } 句柄：validate 只跑同步规则（供 blur/input 即时反馈），validateAsync 逐条 await 供 form 聚合提交",
               "需要给字段加格式说明就传 hint：平时显示在控件下方，校验失败时自动让位给错误文案，同一位置不堆两行",
-              "字段多的编辑页传 columns: 2 或 3 走多列栅格：列间距与窄屏堆叠沿用 grid，按钮区始终整行；单列表单不要传（默认 1）"
+              "字段多的编辑页传 columns: 2 或 3 走多列栅格：列间距与窄屏堆叠沿用 grid，按钮区始终整行；单列表单不要传（默认 1）",
+              "多列表单里想整宽就传 span：formItem({ span: 2 }, textarea(...)) 会占满两列，窄屏单列时自动忽略跨列（否则会撑出横向滚动）"
             ]
           },
           {