iter: b05 文档站 props 表补齐默认值列(df 字段),manifest 驱动链路核查闭环

This commit is contained in:
HIsheR
2026-10-23 16:03:47 +08:00
parent 8c9a63b5d2
commit 83bc1e241c
6 changed files with 88 additions and 55 deletions
+2 -2
View File
@@ -38,8 +38,8 @@
"title": "文档站演示区由 manifest 驱动自动生成",
"motivation": "目前 apps/docs/index.html 手写 props 表与演示,每加组件都要人肉同步;由 manifest 单一来源驱动可消除重复维护",
"acceptance": "ua CLI 新增 docs-gen 逻辑:读取各组件 ua.manifest.json 中的 components 参数表,自动生成 props 表 HTML 片段注入文档站模板;生成结果与现有手写版信息量对齐(props 名/类型/默认值/说明);npm run check 全绿且文档站可正常打开",
"status": "open",
"notes": ""
"status": "done",
"notes": "核查确认 props 表/示例/步骤/演示 iframe 早已由 ua docs 从 manifest docs.components 单一来源驱动;真正的缺口是信息量不含默认值——本轮 CLI propsTable 新增「默认值」列(props 条目可选 df 字段,缺省渲染 —),llms-full.txt 参数行同步追加「默认 x」标注;16 处可机读默认值从描述文案提取进 df;check 全绿 + 文档站结构完整性校验通过"
}
]
}
+33 -17
View File
@@ -1,6 +1,6 @@
{
"$schema": "ui-arch-registry-index/0.1",
"generatedAt": "2026-10-23T07:59:47.390Z",
"generatedAt": "2026-10-23T08:03:18.018Z",
"repoRoot": ".",
"packages": [
{
@@ -221,7 +221,8 @@
{
"n": "variant",
"t": "'primary' | 'ghost' | 'danger'",
"d": "视觉强度;缺省 primary"
"d": "视觉强度;缺省 primary",
"df": "primary"
},
{
"n": "onClick",
@@ -279,7 +280,8 @@
{
"n": "rows",
"t": "number",
"d": "初始行数;缺省 3"
"d": "初始行数;缺省 3",
"df": "3"
},
{
"n": "placeholder",
@@ -461,7 +463,8 @@
{
"n": "variant",
"t": "'default' | 'success' | 'warning' | 'danger'",
"d": "语义色;缺省 default"
"d": "语义色;缺省 default",
"df": "default"
}
],
"example": "badge({ label: '成功', variant: 'success' })",
@@ -484,7 +487,8 @@
{
"n": "variant",
"t": "'info' | 'success' | 'warning' | 'danger'",
"d": "语义色;缺省 info"
"d": "语义色;缺省 info",
"df": "info"
}
],
"example": "alert({ message: '操作可能存在风险', variant: 'warning' })",
@@ -501,12 +505,14 @@
{
"n": "variant",
"t": "'text' | 'rect' | 'circle'",
"d": "占位形状;缺省 rect(整块矩形)"
"d": "占位形状;缺省 rect(整块矩形)",
"df": "rect"
},
{
"n": "rows",
"t": "number",
"d": "text 形状的行数;缺省 3,末行自动缩短模拟段落"
"d": "text 形状的行数;缺省 3,末行自动缩短模拟段落",
"df": "3"
}
],
"example": "skeleton({ variant: 'text', rows: 3 }); skeleton({ variant: 'circle' }); skeleton({ variant: 'rect' })",
@@ -531,12 +537,14 @@
{
"n": "duration",
"t": "number",
"d": "自动消失毫秒;缺省 3000"
"d": "自动消失毫秒;缺省 3000",
"df": "3000"
},
{
"n": "variant",
"t": "'info' | 'success' | 'warning' | 'danger'",
"d": "语义色;缺省 info(toast.error 对应 danger)"
"d": "语义色;缺省 info(toast.error 对应 danger)",
"df": "info"
}
],
"example": "toast.success('保存成功'); toast.error('网络请求失败', 5000)",
@@ -561,12 +569,14 @@
{
"n": "placement",
"t": "'top' | 'bottom'",
"d": "气泡方位;缺省 top(触发器上方)"
"d": "气泡方位;缺省 top(触发器上方)",
"df": "top"
},
{
"n": "delay",
"t": "number",
"d": "出场延迟毫秒;缺省 150,传 0 立即显示"
"d": "出场延迟毫秒;缺省 150,传 0 立即显示",
"df": "150"
},
{
"n": "trigger",
@@ -593,7 +603,8 @@
{
"n": "size",
"t": "number",
"d": "直径像素;缺省 18"
"d": "直径像素;缺省 18",
"df": "18"
}
],
"example": "spinner(); spinner({ size: 26 })",
@@ -616,7 +627,8 @@
{
"n": "showText",
"t": "boolean",
"d": "是否显示百分比文字;缺省 true"
"d": "是否显示百分比文字;缺省 true",
"df": "true"
}
],
"example": "const pct = signal(0); progress({ value: pct }); setInterval(() => pct((pct() + 5) % 105), 400)",
@@ -742,7 +754,8 @@
{
"n": "layout",
"t": "'vertical' | 'horizontal'",
"d": "布局方向;缺省 vertical(horizontal 为标签左置)"
"d": "布局方向;缺省 vertical(horizontal 为标签左置)",
"df": "vertical"
},
{
"n": "submitText",
@@ -785,7 +798,8 @@
{
"n": "(formItem)validateOn",
"t": "'input' | 'blur' | 'submit'",
"d": "校验时机;缺省 blur(输入时自动清已报错误)"
"d": "校验时机;缺省 blur(输入时自动清已报错误)",
"df": "blur"
}
],
"example": "const name = signal(''); const f = form({ onSubmit: submit }, [formItem({ label: '用户名', required: true, value: name, rules: [{ min: 2, max: 12 }] }, textField({ value: name }))])",
@@ -823,12 +837,14 @@
{
"n": "pageSize",
"t": "number",
"d": "每页行数;缺省 5"
"d": "每页行数;缺省 5",
"df": "5"
},
{
"n": "selectable",
"t": "boolean",
"d": "启用行选择列:全选三态(含半选)、行 checkbox、已选计数;缺省 false"
"d": "启用行选择列:全选三态(含半选)、行 checkbox、已选计数;缺省 false",
"df": "false"
},
{
"n": "page",
+1
View File
@@ -2,3 +2,4 @@
{"time":"2026-10-23T15:50:03+08:00","id":"b02","result":"done","summary":"新增 toast 消息提示组件:四语义工厂 + showToast,右上角堆叠,默认 3s 自动消失,微动画 + reduced-motion 兜底;manifest/docs/llms 同步,check 全绿"}
{"time":"2026-10-23T15:53:33+08:00","id":"b03","result":"done","summary":"新增 skeleton 骨架屏组件:text/rect/circle 三形状 + 扫光微动画 + reduced-motion 静态化;manifest/docs/llms/demo 同步,check 全绿"}
{"time":"2026-10-23T16:00:11+08:00","id":"b04","result":"done","summary":"新增独立 pagination 分页器(page 信号双向绑定 + 省略号折叠 + 键盘可达),dataTable 新增 page 受控桥接实现联动;demo 联动卡片,check 全绿"}
{"time":"2026-10-23T16:03:46+08:00","id":"b05","result":"done","summary":"文档站核查确认已 manifest 驱动;补齐默认值信息量缺口:CLI propsTable 新增默认值列(df 字段)+ llms-full 默认标注,16 处默认值提取;check 全绿"}