iter: d20 progress 支持不确定态

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T09:01:45.831Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T09:02:18.149Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -530,7 +530,7 @@ spinner(); spinner({ size: 26 })
 
 参数：
 
-- value（必填）：Signal<number> —— 进度 0-100 信号，变化自动平滑过渡
+- value：Signal<number> —— 当前进度 0-100 信号，变化自动平滑过渡（越界钳制）
 - showText（默认 true）：boolean —— 是否显示百分比文字；缺省 true
 
 示例：
@@ -541,10 +541,12 @@ const pct = signal(0); progress({ value: pct }); setInterval(() => pct((pct() +
 
 手把手：
 
-1. 创建数值信号 pct = signal(0)，范围 0-100（越界自动钳制）
-2. 传入 value，填充宽度与百分比文字随信号平滑过渡
-3. 进行中填充带流动条纹，到 100% 自动变 success 色并停止条纹
-4. 不需要百分比文字时传 showText: false
+1. 时长未知的加载直接 progress() 不传 value：填充块匀速往复，不显示百分比，读屏读作进行中
+2. 创建数值信号 pct = signal(0)，范围 0-100（越界自动钳制）
+3. 传入 value，填充宽度与百分比文字随信号平滑过渡
+4. 进行中填充带流动条纹，到 100% 自动变 success 色并停止条纹
+5. 不需要百分比文字时传 showText: false
+6. 定量进度用 value 信号：满格自动切 success 色并停止条纹，role=progressbar + aria-valuenow 同步
 
 现场演示：apps/docs/demo.html#sec-feedback
 
@@ -742,7 +744,7 @@ API 速览：
 - skeleton(props)：骨架屏占位，variant = text | rect | circle，text 支持 rows 多行，扫光微动画
 - pagination(props)：独立分页器，page 信号双向绑定，页码过多折叠省略号，首末页禁用翻页，键盘可达
 - spinner(props)：加载指示器，size 控制直径
-- progress(props)：进度条，轨道 + 渐变流动填充，value 信号驱动 0-100，满格切 success 色
+- progress(props)：进度条，value 信号驱动 0-100（满格切 success 色）；不传 value 退化为不确定态无限往复
 - tabs(props)：标签页，active 信号双向绑定，滑动指示条 + 方向键环形导航，支持禁用页签
 - modal(props, ...children)：弹窗，open 信号驱动显隐，Esc / 遮罩 / × 关闭，size 三档宽度，footer 提供底部操作区
 - drawer(props, ...children)：抽屉，open 信号驱动侧滑面板，placement 左右可配、width 可调、footer 操作区，遮罩 / × / Esc 关闭