iter(e03): 新增 rate 评分组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T09:57:15.241Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T10:03:21.198Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -651,6 +651,29 @@ const step = signal(1); stepper({ steps: [{ label: '下单' }, { label: '支付'
 
 现场演示：apps/docs/demo.html#sec-stepper
 
+### rate — 评分 Rate
+
+参数：
+
+- value（必填）：Signal<number> —— 当前评分（1 基整数值）信号，双向绑定：点选/键盘写回、外部赋值同步
+- max（默认 5）：number —— 星标总数；缺省 5
+- disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
+- onChange（回调）：(value: number) => void —— 评分变化回调
+
+示例：
+
+```
+const score = signal(0); rate({ value: score, max: 5, onChange: (v) => console.log(v) })
+```
+
+手把手：
+
+1. 用 signal(0) 创建评分信号并传入 value；0 表示未评分
+2. 点击星标或聚焦后按 →/↑ 加一分、←/↓ 减一分；悬停高亮预览、移出还原
+3. max 可调整星标总数；disabled 支持布尔或信号禁用
+
+现场演示：apps/docs/demo.html#sec-rate
+
 ### pagination — 分页器 Pagination
 
 参数：
@@ -827,6 +850,7 @@ API 速览：
 - progress(props)：进度条，value 信号驱动 0-100（满格切 success 色）；不传 value 退化为不确定态无限往复
 - tabs(props)：标签页，active 信号双向绑定，滑动指示条 + 方向键环形导航，支持禁用页签
 - stepper(props)：步骤条，done/current/upcoming 三态，active 信号双向绑定，clickable 时已完成步骤可回跳
+- rate(props)：评分星标，value 信号双向绑定，hover 预览移出还原，键盘方向键调节，max 可配
 - modal(props, ...children)：弹窗，open 信号驱动显隐，Esc / 遮罩 / × 关闭，size 三档宽度，footer 提供底部操作区
 - drawer(props, ...children)：抽屉，open 信号驱动侧滑面板，placement 左右可配、width 可调、footer 操作区，遮罩 / × / Esc 关闭
 - form(props, items)：表单容器，布局 + 聚合校验，全部通过才触发 onSubmit