@icen.ai/ui 0.8.1 → 0.10.0

package/dist/behaviors/ai-chat.d.mts

@@ -1,24 +1,26 @@
 import { AiContent, AiContentPart } from './ai-core.js';
 
 /**
- * 初始化 root 下的全部 .ai-chat（root 自身匹配时包含自身）。
+ * 初始化 root 下的全部 .icen-ai-chat（root 自身匹配时包含自身）。
  * 幂等；返回销毁函数：移除监听、断开观察器并复位幂等标记（可重新 init）。
  */
 declare function initAiChat(root?: ParentNode): () => void;
 interface AiStreamHandle {
     /** textContent 级追加一段文本（不解析 HTML） */
     append(text: string): void;
-    /** 流正常结束：移除 .is-streaming / aria-busy；reasoning 自动折叠 + 回填耗时 */
+    /** 流正常结束：移除 .is-streaming / aria-busy；reasoning 回填「思考 Ns」并延迟 1s 自动收起一次（§5.27） */
     done(): void;
-    /** 流被取消：同 done，但不折叠 reasoning、不计耗时 */
+    /** 流被取消：保留已生成内容，补「继续生成」槽；不折叠 reasoning、不计耗时（aborted ≠ error） */
     cancel(): void;
-    /** 流失败：终止追加并给宿主挂 .is-error（错误文本展示由消费方/renderAiMessage.setError 负责） */
+    /** 流失败：终止追加并挂 .is-error（错误文本展示由消费方/renderAiMessage.setError 负责）；reasoning 同 done 收起 + 补「继续生成」槽 */
     fail(): void;
 }
 /**
- * 创建流式追加句柄：追加期间宿主挂 .is-streaming（aria-busy=true），
- * 完成/取消移除。宿主在 .ai-reasoning 内时同步驱动 reasoning 状态：
- * 流式中根挂 .is-streaming（CSS shimmer），done() 自动折叠并显示耗时。
+ * 创建流式追加句柄：追加期间宿主挂 .is-streaming（aria-busy=true），完成/取消移除。
+ * 宿主在 .icen-ai-reasoning 内时同步驱动 reasoning 折叠契约（§5.27）：流式态默认展开；
+ * done/fail 移除 .is-streaming、回填「思考 Ns」（自折叠头 data-icen-reasoning-start 起算）并
+ * 延迟 1s 自动收起一次（用户手动 toggle 过则永不自动收）；fail/cancel 保留已生成内容
+ * 并在消息尾补 .icen-ai-msg-continue「继续生成」槽（cancel 不显示错误——aborted ≠ error）。
  */
 declare function createAiStream(el: HTMLElement): AiStreamHandle;
 interface AiMessageModel {
@@ -29,15 +31,15 @@ interface AiMessageModel {
     meta?: string;
     /** assistant 消息的模型名标签 */
     model?: string;
-    /** 错误态：消息挂 .ai-msg--error + 错误文本行 */
+    /** 错误态：消息挂 .icen-ai-msg--error + 错误文本行 */
     error?: string;
     /** 初始即流式态（正文末文本 span 挂 .is-streaming） */
     streaming?: boolean;
 }
 interface AiMessageHandle {
-    /** 消息行元素（.ai-msg） */
+    /** 消息行元素（.icen-ai-msg） */
     el: HTMLElement;
-    /** 正文容器（.ai-msg-body）：消费方追加自定义内容的挂载点 */
+    /** 正文容器（.icen-ai-msg-body）：消费方追加自定义内容的挂载点 */
     body: HTMLElement;
     setMeta(meta: string): void;
     setError(message: string): void;