iter(g68): alert 增加语义图标与通栏形态

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T04:35:37.103Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T04:36:57.291Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -496,6 +496,9 @@ avatar({ name: '张三' }); avatar({ name: 'Alice', size: 40, variant: 'success'
 - variant（默认 info）：'info' | 'success' | 'warning' | 'danger' —— 语义色；缺省 info
 - closable（默认 false）：boolean —— 显示 × 关闭按钮，退场后从 DOM 移除；缺省 false
 - onClose（回调）：() => void —— 关闭回调，供调用方同步业务状态
+- banner（默认 false）：boolean —— 通栏形态：去圆角、只保留下边框、左右撑满，适合页面顶部通知
+- showIcon（默认 false）：boolean —— 显示语义图标（info ℹ / success ✓ / warning ! / danger ✕），纯装饰不进读屏
+- icon：string | HTMLElement —— 自定义图标节点，传了即覆盖语义图标
 
 示例：
 
@@ -510,6 +513,7 @@ alert({ message: '操作可能存在风险', variant: 'warning' })
 3. 需要可关闭或带操作按钮时，外层用 h() 组合 button 自行拼装，alert 只负责语义底色
 4. 需要用户可自行消除的提示传 closable: true：点 × 淡出并从 DOM 移除，配合 onClose 同步业务状态
 5. 有标题与正文两层信息时传 title（加粗首行），正文仍走 message
+6. banner: true 出通栏形态（圆角与左右边框归零），页面顶部通知直接铺满容器即可，不需要额外包裹层
 
 现场演示：apps/docs/demo.html#sec-feedback