iter(g131): 新增悬浮操作按钮 floatButton

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-26T07:19:51.268Z",
+  "generatedAt": "2026-10-26T07:21:05.139Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -205,7 +205,8 @@
           "popconfirm(props, trigger)：二次确认气泡，挂在任意触发器上，就地确认危险操作；确定后先收起再回调，取消 / 点外部 / Esc 走 onCancel，展开即聚焦「取消」",
           "calendar(props)：月历，整月网格内嵌页面（排期 / 值班 / 日程），每日可带 marker 标记文案，方向键漫游 + Enter 选中，翻月走 onMonthChange",
           "typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮",
-          "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列"
+          "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列",
+          "floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label"
         ],
         "keyTypes": [
           "ButtonProps",
@@ -3207,6 +3208,60 @@
               "子项必须是单个元素（card / div / 自定义块），grid 只负责排布且已对子项设 min-width: 0，长文本不会撑破列宽",
               "只要横向一排展示且元素不等宽，用 space 更轻；grid 面向二维对齐"
             ]
+          },
+          {
+            "id": "floatButton",
+            "title": "悬浮操作按钮 FloatButton",
+            "demo": "sec-floatbutton",
+            "props": [
+              {
+                "n": "icon",
+                "t": "string | Node",
+                "d": "图标：字符串按字符（emoji / 符号）渲染，传 DOM 原样插入"
+              },
+              {
+                "n": "label",
+                "t": "string",
+                "d": "文字标签；给了就出「图标 + 文字」胶囊，缺省为纯图标圆形"
+              },
+              {
+                "n": "badge",
+                "t": "string | number",
+                "d": "角标（数字或短文案，如 3 / '新'）；缺省不渲染"
+              },
+              {
+                "n": "tooltip",
+                "t": "string",
+                "d": "悬停提示，同时用作 aria-label；纯图标时必传，否则读屏听到默认「快捷操作」"
+              },
+              {
+                "n": "position",
+                "t": "'right-bottom' | 'left-bottom'",
+                "df": "right-bottom",
+                "d": "停靠角落；右下与 backTop 同侧，需同时出现时错开一左一右"
+              },
+              {
+                "n": "offset",
+                "t": "number",
+                "df": "24",
+                "d": "距边距离（px）；同角落堆叠多个时按倍数递增"
+              },
+              {
+                "n": "onClick",
+                "t": "() => void",
+                "k": 1,
+                "d": "点击回调"
+              }
+            ],
+            "example": "document.body.append(floatButton({ icon: '+', label: '新建工单', position: 'left-bottom', onClick: () => toast.success('已新建') })); document.body.append(floatButton({ icon: '?', tooltip: '帮助中心', badge: 3 }))",
+            "steps": [
+              "把返回节点挂到 document.body（不是页面容器内）：它是 fixed 定位，挂在容器里会被 overflow: hidden 裁剪",
+              "只有图标时务必传 tooltip：它同时是 aria-label，读屏用户靠它知道按钮干什么；有 label 时 tooltip 可省",
+              "label 存在即「图标 + 文字」胶囊，只有图标即 44px 圆形；两种形态都保证触摸目标不小于 44px",
+              "同一角落要放多个按钮时递增 offset（如 24 / 80），或把它们并进同一个 flex 容器统一排布——组件自身不做堆叠计算",
+              "右下角已被 backTop 占用，页面同时有返回顶部时用 position: 'left-bottom'",
+              "纯展示 + 单回调，没有选中态与开合状态；需要多级操作请用 menu / popover 挂在 onClick 上"
+            ]
           }
         ]
       },