iter(g286): 新增 noticeBar 单行通知条组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T15:13:43.474Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T15:15:56.703Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -2454,6 +2454,33 @@ progressRing({ value: pct, size: 96 })
 
 现场演示：apps/docs/demo.html#sec-ring
 
+### noticeBar — 通知条 NoticeBar
+
+参数：
+
+- text：string —— 通知正文；单行不换行，超宽需配合 scroll
+- variant：'info' | 'success' | 'warning' | 'danger' —— 语义色；缺省 info
+- icon：string —— 左侧符号；缺省按 variant 取（ℹ / ✓ / ! / ×）
+- scroll：boolean —— 正文超宽时跑马灯滚动；缺省 false（静态，超出裁切）
+- closable：boolean —— 是否显示关闭按钮；缺省 true
+- onClose：() => void —— 关闭回调
+
+示例：
+
+```
+noticeBar({ text: '系统将于今晚 23:00 维护 10 分钟', scroll: true })
+```
+
+手把手：
+
+1. 和 alert 的分工：alert 可多行带标题、占块；通知条只占一行，适合页顶常驻播报（维护公告、试用期提醒）
+2. 文案比容器宽就传 scroll: true：正文从右向左匀速走，悬停自动暂停，读得完不用追
+3. 只想播报不需要关闭就传 closable: false：右侧不再留 × 位，横条更紧凑
+4. 颜色只是第二线索：左侧符号按 variant 自动配（ℹ / ✓ / ! / ×），色弱或灰度打印也能分辨
+5. 跑马灯在减少动效偏好下自动停成静态首屏——完整原文始终在 title 里，不必为可访问性另写一份
+
+现场演示：apps/docs/demo.html#sec-notice
+
 API 速览：
 
 - button(props)：按钮，variant 三档视觉强度，disabled / loading 支持布尔或信号动态同步（loading 转圈并禁点），onClick 点击回调
@@ -2544,6 +2571,7 @@ API 速览：
 - sparkline(props)：迷你趋势线，把数值序列压成折线（可填充 + 末点标记），无坐标轴无交互
 - heatmap(props)：日历热力图，按周列 × 星期行铺格子、四档浓度表示当天数量，悬停看明细
 - progressRing(props)：环形进度，SVG 双圆靠 dasharray 画弧 + 中心百分比，value 可传信号自动重绘
+- noticeBar(props)：单行通知条，语义色 + 左侧符号 + 可选跑马灯与关闭，适合页顶常驻播报
 
 一行用法：