iter: d23 alert 标题行 + 可关闭 + role=alert

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T09:03:43.931Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T09:04:21.317Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -413,7 +413,10 @@ avatar({ name: '张三' }); avatar({ name: 'Alice', size: 40, variant: 'success'
 参数：
 
 - message（必填）：string —— 提示内容
+- title：string —— 加粗标题行；缺省只渲染正文
 - variant（默认 info）：'info' | 'success' | 'warning' | 'danger' —— 语义色；缺省 info
+- closable（默认 false）：boolean —— 显示 × 关闭按钮，退场后从 DOM 移除；缺省 false
+- onClose（回调）：() => void —— 关闭回调，供调用方同步业务状态
 
 示例：
 
@@ -426,6 +429,8 @@ alert({ message: '操作可能存在风险', variant: 'warning' })
 1. 按信息级别选 variant：info 提示、success 成功、warning 警告、danger 错误
 2. 传入 message 即可，入场自带下滑动画
 3. 需要可关闭或带操作按钮时，外层用 h() 组合 button 自行拼装，alert 只负责语义底色
+4. 需要用户可自行消除的提示传 closable: true：点 × 淡出并从 DOM 移除，配合 onClose 同步业务状态
+5. 有标题与正文两层信息时传 title（加粗首行），正文仍走 message
 
 现场演示：apps/docs/demo.html#sec-feedback
 
@@ -762,7 +767,7 @@ API 速览：
 - badge(props)：徽标，variant = default | success | warning | danger
 - tag(props)：可关闭标签，variant 五档语义色，closable + onClose 支持从数据源移除（纯展示请用 badge）
 - avatar(props)：头像，有 src 渲染图片（alt 用名称）、无 src 用首字占位，size 可调 + 四档语义底色
-- alert(props)：提示条，variant = info | success | warning | danger
+- alert(props)：提示条，variant 四档语义色 + 可选 title 与 closable 关闭按钮，role=alert 读屏可播报
 - toast.info/success/warning/error(message, duration?)：消息提示工厂，右上角堆叠，默认 3s 自动消失，出入场微动画；showToast(props) 为完整入参版本（closable 显示关闭按钮，同屏最多 4 条）
 - tooltip(props, trigger)：悬浮提示，包裹触发器，hover / focus 延迟 150ms 出场，移出 / 失焦 / Esc 收起
 - popover(props, trigger)：可交互气泡卡片，包裹触发器，默认点击开合 + 点外部 / Esc 收起，content 可放按钮等交互元素