iter(g78): 新增 space 间距容器组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T04:40:12.953Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T04:55:25.133Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -776,6 +776,32 @@ divider({ label: '更多信息' }) / divider({ vertical: true })
 
 现场演示：apps/docs/demo.html#sec-divider
 
+### space — 间距容器 Space
+
+参数：
+
+- direction：'horizontal' | 'vertical' —— 主轴方向；缺省 horizontal 横排
+- size：'sm' | 'md' | 'lg' | number —— 子元素间距：三档走 --ua-space-* 令牌，数字按像素；缺省 md
+- align：'start' | 'center' | 'end' | 'baseline' —— 交叉轴对齐；缺省 center，按钮与文字混排不错位
+- justify：'start' | 'center' | 'end' | 'between' —— 主轴分布；缺省 start，between 两端撑开
+- wrap：boolean —— 空间不足是否换行；缺省 false
+- block：boolean —— 是否占满父容器宽度；缺省按内容收缩
+
+示例：
+
+```
+space({ size: 'lg' }, button({ label: '保存' }), button({ label: '取消', variant: 'ghost' })) / space({ direction: 'vertical', align: 'start' }, ...)
+```
+
+手把手：
+
+1. 把一排需要统一间距的元素交给 space 托管，不再各自写 margin
+2. 调间距：size 传 sm/md/lg 走令牌，需要精确像素时直接给数字
+3. 竖排用 direction: 'vertical'，配 align: 'start' 让子元素左对齐
+4. 工具栏两端撑开用 justify: 'between' + block: true；窄屏放不下时加 wrap
+
+现场演示：apps/docs/demo.html#sec-space
+
 ### pagination — 分页器 Pagination
 
 参数：
@@ -1551,6 +1577,7 @@ API 速览：
 - rate(props)：评分星标，value 信号双向绑定，hover 预览移出还原，键盘方向键调节，max 可配
 - empty(props)：空状态占位，title/description 可选，action 放操作区
 - divider(props)：分隔线，水平/垂直两种方向，可带居中文案标签，dashed 切虚线
+- space(props)：间距容器，flex gap 统一子元素间距，direction / size / align / justify / wrap / block 可调
 - modal(props, ...children)：弹窗，open 信号驱动显隐，Esc / 遮罩 / × 关闭，size 三档宽度，footer 提供底部操作区
 - drawer(props, ...children)：抽屉，open 信号驱动侧滑面板，placement 左右可配、width 可调、footer 操作区，遮罩 / × / Esc 关闭
 - form(props, items)：表单容器，布局 + 聚合校验，全部通过才触发 onSubmit