iter(g273): 新增区域加载遮罩组件

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-26T14:56:09.624Z",
+  "generatedAt": "2026-10-26T14:58:51.630Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -224,7 +224,8 @@
           "jsonViewer(props)：JSON 树查看，按层折叠、分支带计数摘要、叶子按类型着色，只读不编辑",
           "diffView(props)：文本差异对比，行级 LCS 对齐 + 增删着色 + 双行号列，顶部带 +N / −N 统计",
           "codeBlock(props)：代码块，等宽多行 + 行号列 + 标题行 + 一键复制原文，只展示不高亮",
-          "signaturePad(props)：手写签名板，指针绘制 + DPR 位图，返回 handle（el / clear / toDataURL / isEmpty）"
+          "signaturePad(props)：手写签名板，指针绘制 + DPR 位图，返回 handle（el / clear / toDataURL / isEmpty）",
+          "loading(props, ...children)：区域加载遮罩，内容原地降透明度 + 转圈文案，带延迟出场避免快请求闪烁"
         ],
         "keyTypes": [
           "ButtonProps",
@@ -4347,6 +4348,46 @@
               "需要判空用 handle.isEmpty()，取图用 handle.toDataURL()；两者与信号同源，不会出现「有图但信号是空」",
               "禁用传布尔或信号：布尔直接置位，信号随状态变灰并挡住手写；移动端画布已关掉浏览器手势，不会边签边滚页"
             ]
+          },
+          {
+            "id": "loading",
+            "title": "区域加载遮罩 Loading",
+            "demo": "sec-loading",
+            "props": [
+              {
+                "n": "active",
+                "t": "boolean | Signal<boolean>",
+                "d": "是否加载中：布尔直接置位，传信号则随状态显隐"
+              },
+              {
+                "n": "text",
+                "t": "string",
+                "d": "遮罩文案；缺省只显示转圈（读屏仍报「内容加载中」）"
+              },
+              {
+                "n": "delay",
+                "t": "number",
+                "d": "出场延迟（ms）；缺省 120，快请求不闪遮罩"
+              },
+              {
+                "n": "spinnerSize",
+                "t": "number",
+                "d": "转圈直径（px）；缺省 20"
+              },
+              {
+                "n": "minHeight",
+                "t": "number",
+                "d": "最小高度（px）；内容为空时兜住遮罩高度"
+              }
+            ],
+            "example": "loading({ active: busy, text: '正在刷新订单' }, dataTable({ ... }))",
+            "steps": [
+              "把要遮挡的那块内容作为 children 交进来，active 传布尔或信号：刷新时盖上遮罩，数据回来后自动收起",
+              "内容不隐藏、只降透明度——布局与尺寸原地保留，遮罩收起时不会跳一下",
+              "默认延迟 120ms 出场：接口快于这个时间就不闪遮罩；想立刻显示传 delay: 0",
+              "遮罩文案写明在等什么（「正在刷新订单」），读屏同一句也会播报；只要转圈就省略 text",
+              "内容可能为空时给 minHeight，否则高度塌成 0 遮罩无处可盖"
+            ]
           }
         ]
       },