@icen.ai/ui 0.8.1 → 0.10.0

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

@@ -9,23 +9,37 @@ interface AiTodoItem {
 }
 /**
  * 渲染 todo 列表（DOM API，全 textContent）。全部完成时容器加 .is-complete。
+ * 每项附 .icen-ai-todo-check 描边勾（§5.27：done 时 CSS 显隐 + 480ms 描边动画，一次不循环）。
  * 返回挂载容器 el（render* 返回挂载元素约定，SSR 下原样返回）。
  */
 declare function renderAiTodo(el: HTMLElement, items: AiTodoItem[]): HTMLElement;
 /**
- * todo 委托初始化：仅 data-ai-todo-interactive 容器可点击循环状态（pending→running→done），
+ * todo 委托初始化：仅 data-icen-ai-todo-interactive 容器可点击循环状态（pending→running→done），
  * 只读列表不挂交互。重复调用安全；返回销毁函数。
  */
 declare function initAiTodo(root?: ParentNode): () => void;
+/** 用量派生指标（§5.27）：opts.metrics 给出，或直接挂在 usage 对象同级字段上 */
+interface AiUsageMetrics {
+    /** 首 token 延迟（毫秒） */
+    ttftMs?: number;
+    /** 生成吞吐（tokens/秒） */
+    tokensPerSec?: number;
+    /** finish reason（stop / length / tool_calls…） */
+    finishReason?: string;
+}
 interface AiUsageRenderOpts {
     /** 上下文上限（如 200k）：给出时 total 行显示 82k / 200k · 41% */
     total?: number;
     /** 成本（USD）：给出时追加到 total 行 */
     cost?: number;
+    /** 派生指标（§5.27）：任一字段给出时图例下补一行 mono 明细（TTFT 0.8s · 42 tok/s · finish: stop） */
+    metrics?: AiUsageMetrics;
 }
 /**
  * 渲染用量分段条 + 图例 + 占比。返回挂载容器 el（render* 返回挂载元素约定）。
  * 配色契约：input=accent / output=success / cacheRead=info / cacheWrite=warning / reasoning=faint。
+ * opts.metrics（或 usage 同级 ttftMs/tokensPerSec/finishReason）存在时图例下补一行
+ * .icen-ai-usage-metrics mono 明细（§5.27）。
  */
 declare function renderAiUsage(el: HTMLElement, usage: AiUsage, opts?: AiUsageRenderOpts): HTMLElement;
 interface AiUsageRingOpts extends AiUsageRenderOpts {
@@ -37,7 +51,7 @@ interface AiUsageRingOpts extends AiUsageRenderOpts {
  * 点击弹出完整分段分解（复用 popover 浮层 + renderAiUsage）。
  * opts.total 给上下文窗口上限（如 200000）——环填充比 = 已用 / total；
  * 缺省 total 时环不填充、中心显示已用量。
- * 状态档：<60% is-ok（accent）/ 60–85% is-warn / >85% is-hot（error）。
+ * 状态档：<60% is-ok（icen-accent）/ 60–85% is-warn / >85% is-hot（error）。
  * 重复调用重渲染；打开中的弹层会被关闭重建。返回挂载容器 el。
  */
 declare function renderAiUsageRing(el: HTMLElement, usage: AiUsage, opts?: AiUsageRingOpts): HTMLElement;
@@ -68,18 +82,18 @@ interface AiContextModel {
 }
 /**
  * 组合渲染上下文抽屉：usage → renderAiUsage；files → ai-file-chip；
- * mcpServers / skills → .ai-item 行。aside 默认 hidden，由 initAiContext 开合。
+ * mcpServers / skills → .icen-ai-item 行。aside 默认 hidden，由 initAiContext 开合。
  * 返回挂载容器 el（render* 返回挂载元素约定）。
  */
 declare function renderAiContext(el: HTMLElement, model: AiContextModel): HTMLElement;
 /**
- * 触发器 [data-ai-context-open] 委托开合：
+ * 触发器 [data-icen-ai-context-open] 委托开合：
  *   - 属性值为 #id / 选择器时定位对应抽屉，空值取 scope 内第一个非 inline 抽屉
  *   - 打开：去 hidden → reflow → .is-open 滑入（CSS transition），焦点移入 close 钮
- *   - 关闭：[data-ai-context-close] / Esc / 外点；.is-open 移除 → transition 结束（或兜底计时）
+ *   - 关闭：[data-icen-ai-context-close] / Esc / 外点；.is-open 移除 → transition 结束（或兜底计时）
  *     后恢复 hidden，焦点还原触发器；Tab/Shift+Tab 焦点圈禁
  *   - 开/合从抽屉根元素派 icen:ai-context-open {} / icen:ai-context-close {}（bubbles）
- *   - .ai-context--inline 为页面流内嵌变体：不参与开合、不做 fixed
+ *   - .icen-ai-context--inline 为页面流内嵌变体：不参与开合、不做 fixed
  */
 declare function initAiContext(root?: ParentNode): () => void;
 interface AiAuditRenderOpts {
@@ -98,4 +112,4 @@ interface AiAuditRenderOpts {
  */
 declare function renderAiAudit(el: HTMLElement, source: AiAuditor | AiAuditEntry[], opts?: AiAuditRenderOpts): HTMLElement;
 
-export { type AiAuditRenderOpts, type AiContextFile, type AiContextMcpServer, type AiContextModel, type AiContextSkill, type AiTodoItem, type AiUsageRenderOpts, type AiUsageRingOpts, initAiContext, initAiTodo, renderAiAudit, renderAiContext, renderAiTodo, renderAiUsage, renderAiUsageRing };
+export { type AiAuditRenderOpts, type AiContextFile, type AiContextMcpServer, type AiContextModel, type AiContextSkill, type AiTodoItem, type AiUsageMetrics, type AiUsageRenderOpts, type AiUsageRingOpts, initAiContext, initAiTodo, renderAiAudit, renderAiContext, renderAiTodo, renderAiUsage, renderAiUsageRing };