@icen.ai/ui 0.8.0 → 0.8.1

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

@@ -1,4 +1,6 @@
 type AiStatus = 'pending' | 'running' | 'streaming' | 'approval' | 'done' | 'error' | 'cancelled';
+/** 状态机七态（规格 §1 的唯一语言）——集群共享（切 is-* 类 / 校验 wire status 用） */
+declare const AI_STATUSES: readonly AiStatus[];
 /** 中文状态标签：等待/执行中/流式中/待确认/完成/失败/已取消 */
 declare function aiStatusLabel(s: AiStatus): string;
 interface AiUsage {
@@ -9,6 +11,8 @@ interface AiUsage {
     reasoning?: number;
     total?: number;
 }
+/** 六键用量求和（非破坏性：不动入参，返回新对象）；语义对齐 ai-provider 的同名私有实现，集群共用 */
+declare function addUsage(sum: AiUsage, u: AiUsage): AiUsage;
 type AiKindTint = 'accent' | 'success' | 'warning' | 'error' | 'info' | 'muted';
 interface AiKindDef {
     /** 一行中文名（tool-call 卡片的标题区展示） */
@@ -39,7 +43,7 @@ interface AiToolCallModel {
 }
 /** 注册（或覆盖）一个 kind；name 大小写不敏感。第三方扩展入口。 */
 declare function registerAiKind(name: string, def: AiKindDef): void;
-/** 取 kind 定义；未注册回退 'note'。 */
+/** 取 kind 定义；未注册回退内置 'note'。 */
 declare function getAiKind(name: string): AiKindDef;
 /** 从 tool 名推断 kind：Bash/Shell→shell、Read→read、mcp__*→mcp 等。 */
 declare function inferKind(toolName: string): string;
@@ -114,9 +118,8 @@ interface AiResourceLinkPart {
 type AiContentPart = AiTextPart | AiMediaPart | AiResourceLinkPart;
 /** 消息与工具回执的内容：字符串（纯文本捷径）或部件数组（多模态） */
 type AiContent = string | AiContentPart[];
+/** 单部件守卫：type 合法且槽位类型正确（text 看 text、resource-link 看 uri、媒体看 url 或 data+mimeType） */
 declare function isAiContentPart(v: unknown): v is AiContentPart;
-/** 数组且至少一项像内容部件 → 视为部件数组（tool output 多模态探测用） */
-declare function isAiContentPartArray(v: unknown): v is AiContentPart[];
 /** 渲染地址归一：url 直取；data + mimeType 拼 data URI（base64） */
 declare function aiContentUrl(part: AiContentPart): string | undefined;
 /**
@@ -140,6 +143,8 @@ declare function estimateTokens(content: AiContent | AiUsage): number;
  * 本次输出会成为下轮输入的一部分。与 auditor.summary()（累计计费）语义不同。
  */
 declare function contextEstimate(usage: AiUsage): number;
+/** 极简 DOM 构件：createElement + 可选 className + 可选 textContent —— 集群共用，免四处 createElement 三连 */
+declare function h<K extends keyof HTMLElementTagNameMap>(tag: K, className?: string, text?: string): HTMLElementTagNameMap[K];
 /**
  * 把内联 SVG 字符串解析为消毒后的 SVGElement：
  *   - 剥全部 on* 事件属性；剔除 script / foreignObject 子树
@@ -148,4 +153,4 @@ declare function contextEstimate(usage: AiUsage): number;
  */
 declare function svgIcon(svg: string): SVGElement | null;
 
-export { type AiAudioPart, type AiContent, type AiContentPart, type AiFilePart, type AiImagePart, type AiKindDef, type AiKindTint, type AiMediaPart, type AiResourceLinkPart, type AiStatus, type AiTextPart, type AiToolCallModel, type AiUsage, type AiVideoPart, aiContentUrl, aiStatusLabel, contentToText, contextEstimate, estimateTokens, formatDuration, formatTokens, getAiKind, inferKind, isAiContentPart, isAiContentPartArray, normalizeContentParts, normalizeMcpContent, normalizeToolCall, normalizeUsage, registerAiKind, svgIcon };
+export { AI_STATUSES, type AiAudioPart, type AiContent, type AiContentPart, type AiFilePart, type AiImagePart, type AiKindDef, type AiKindTint, type AiMediaPart, type AiResourceLinkPart, type AiStatus, type AiTextPart, type AiToolCallModel, type AiUsage, type AiVideoPart, addUsage, aiContentUrl, aiStatusLabel, contentToText, contextEstimate, estimateTokens, formatDuration, formatTokens, getAiKind, h, inferKind, isAiContentPart, normalizeContentParts, normalizeMcpContent, normalizeToolCall, normalizeUsage, registerAiKind, svgIcon };

package/dist/behaviors/ai-core.mjs

@@ -23,6 +23,15 @@ function aiStatusLabel(s) {
   };
   return labels[s] ?? s;
 }
+var USAGE_KEYS = ["input", "output", "cacheRead", "cacheWrite", "reasoning", "total"];
+function addUsage(sum2, u) {
+  const out = { ...sum2 };
+  for (const k of USAGE_KEYS) {
+    const v = u[k];
+    if (typeof v === "number" && Number.isFinite(v)) out[k] = (out[k] ?? 0) + v;
+  }
+  return out;
+}
 var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
 var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
 var ICON_FILE = svg(
@@ -147,14 +156,13 @@ var BUILTIN_KINDS = {
   note: { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" },
   chart: { label: "\u56FE\u8868", icon: ICON_CHART, tint: "info", summarize: sum((i) => pickStr(i, ["title", "name"])) }
 };
-var FALLBACK_KIND = { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" };
 var kindRegistry = new Map(Object.entries(BUILTIN_KINDS));
 function registerAiKind(name, def) {
   const key = name.trim().toLowerCase();
   if (key) kindRegistry.set(key, def);
 }
 function getAiKind(name) {
-  return kindRegistry.get(name.trim().toLowerCase()) ?? kindRegistry.get("note") ?? FALLBACK_KIND;
+  return kindRegistry.get(name.trim().toLowerCase()) ?? BUILTIN_KINDS.note;
 }
 var KIND_RULES = [
   [/^mcp__/, "mcp"],
@@ -280,9 +288,9 @@ function formatDuration(ms) {
   const m = Math.floor(ms / 6e4);
   const s = Math.round(ms % 6e4 / 1e3);
   if (ms < 36e5) return s > 0 ? `${m}m${s}s` : `${m}m`;
-  const h = Math.floor(ms / 36e5);
+  const h2 = Math.floor(ms / 36e5);
   const rm = Math.round(ms % 36e5 / 6e4);
-  return rm > 0 ? `${h}h${rm}m` : `${h}h`;
+  return rm > 0 ? `${h2}h${rm}m` : `${h2}h`;
 }
 var PART_TYPES = /* @__PURE__ */ new Set(["text", "image", "audio", "video", "file", "resource-link"]);
 function isAiContentPart(v) {
@@ -293,9 +301,6 @@ function isAiContentPart(v) {
   if (t === "resource-link") return typeof v.uri === "string";
   return typeof v.url === "string" || typeof v.data === "string" && typeof v.mimeType === "string";
 }
-function isAiContentPartArray(v) {
-  return Array.isArray(v) && v.length > 0 && v.every(isAiContentPart);
-}
 function aiContentUrl(part) {
   if (part.type === "text" || part.type === "resource-link") return void 0;
   if (typeof part.url === "string" && part.url) return part.url;
@@ -438,6 +443,12 @@ function contextEstimate(usage) {
   const u = normalizeUsage(usage);
   return (u.input ?? 0) + (u.cacheRead ?? 0) + (u.cacheWrite ?? 0) + (u.output ?? 0) + (u.reasoning ?? 0);
 }
+function h(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text != null) node.textContent = text;
+  return node;
+}
 function svgIcon(svg2) {
   if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
   let parsed;
@@ -471,6 +482,8 @@ function svgIcon(svg2) {
   return document.importNode(root, true);
 }
 export {
+  AI_STATUSES,
+  addUsage,
   aiContentUrl,
   aiStatusLabel,
   contentToText,
@@ -479,9 +492,9 @@ export {
   formatDuration,
   formatTokens,
   getAiKind,
+  h,
   inferKind,
   isAiContentPart,
-  isAiContentPartArray,
   normalizeContentParts,
   normalizeMcpContent,
   normalizeToolCall,

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

@@ -40,10 +40,10 @@ interface AiDiffModel {
  */
 declare function parseUnifiedDiff(text: string): AiDiffFile[];
 /**
- * 渲染 diff 审阅卡（DOM API，全 textContent）。
+ * 渲染 diff 审阅卡（DOM API，全 textContent），返回挂载元素 el（render* 约定）。
  * 接受 parseUnifiedDiff 的产物；重复调用会替换 el 内容。
  */
-declare function renderAiDiff(elm: HTMLElement, model: AiDiffModel): void;
+declare function renderAiDiff(el: HTMLElement, model: AiDiffModel): HTMLElement;
 /**
  * 委托初始化：展开/折叠 + 接受/拒绝。重复调用安全；
  * 返回销毁函数（移除监听并复位标记，可重新 init）。

package/dist/behaviors/ai-diff.mjs

@@ -1,3 +1,143 @@
+// src/behaviors/ai-core.ts
+var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
+var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
+var ICON_FILE = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>'
+);
+var ICON_FILE_PEN = svg(
+  '<path d="M12.5 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8l5 5v3.5"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M19 6.5 16.5 4"/><path d="M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z"/>'
+);
+var ICON_FILE_PLUS = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M9 15h6"/><path d="M12 12v6"/>'
+);
+var ICON_TRASH = svg(
+  '<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>'
+);
+var ICON_SEARCH = svg('<circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/>');
+var ICON_FOLDER_SEARCH = svg(
+  '<path d="M11 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v4"/><circle cx="17" cy="17" r="3"/><path d="m21 21-1.9-1.9"/>'
+);
+var ICON_SCAN_SEARCH = svg(
+  '<path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/>'
+);
+var ICON_GLOBE = svg(
+  '<circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/>'
+);
+var ICON_DOWNLOAD = svg(
+  '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>'
+);
+var ICON_BLOCKS = svg(
+  '<rect width="7" height="7" x="4" y="4" rx="1"/><rect width="7" height="7" x="13" y="4" rx="1"/><rect width="7" height="7" x="4" y="13" rx="1"/><rect width="7" height="7" x="13" y="13" rx="1"/>'
+);
+var ICON_ZAP = svg(
+  '<path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/>'
+);
+var ICON_LIST = svg(
+  '<path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/>'
+);
+var ICON_LIST_CHECKS = svg(
+  '<path d="m3 17 2 2 4-4"/><path d="m3 7 2 2 4-4"/><path d="M13 6h8"/><path d="M13 12h8"/><path d="M13 18h8"/>'
+);
+var ICON_BOT = svg(
+  '<path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/>'
+);
+var ICON_CHART = svg(
+  '<path d="M3 3v18h18"/><path d="M7 15l4-6 3 4 5-8"/>'
+);
+var ICON_FILE_TEXT = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/>'
+);
+function isObj(v) {
+  return typeof v === "object" && v !== null;
+}
+function pickStr(input, keys) {
+  if (!isObj(input)) return void 0;
+  for (const k of keys) {
+    const v = input[k];
+    if (typeof v === "string" && v) return v;
+  }
+  return void 0;
+}
+function pickNum(src, keys) {
+  if (!isObj(src)) return void 0;
+  for (const k of keys) {
+    const v = src[k];
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+  }
+  return void 0;
+}
+function firstLine(s, max = 80) {
+  const line = s.split("\n", 1)[0]?.trim() ?? "";
+  return line.length > max ? `${line.slice(0, max)}\u2026` : line;
+}
+function filePathOf(input) {
+  return pickStr(input, ["file_path", "path", "file", "filename"]);
+}
+var summarizePath = (input) => filePathOf(input);
+function summarizeRead(input) {
+  const p = filePathOf(input);
+  if (!p) return void 0;
+  const offset = pickNum(input, ["offset", "start_line"]);
+  if (offset == null) return p;
+  const limit = pickNum(input, ["limit", "end_line"]);
+  return limit != null ? `${p}:${offset}-${offset + limit}` : `${p}:${offset}`;
+}
+function summarizeShell(input) {
+  const cmd = typeof input === "string" ? input : pickStr(input, ["command", "cmd", "script"]);
+  return cmd ? firstLine(cmd) : void 0;
+}
+function summarizeGrep(input) {
+  const pattern = pickStr(input, ["pattern", "regex", "query"]);
+  const p = filePathOf(input);
+  if (pattern) return p ? `${firstLine(pattern, 40)} \xB7 ${p}` : firstLine(pattern);
+  return p;
+}
+var sum = (fn) => {
+  return (input) => fn(input) ?? "";
+};
+var BUILTIN_KINDS = {
+  shell: { label: "\u547D\u4EE4", icon: ICON_TERMINAL, tint: "accent", summarize: sum(summarizeShell) },
+  read: { label: "\u8BFB\u53D6", icon: ICON_FILE, tint: "info", summarize: sum(summarizeRead) },
+  edit: { label: "\u7F16\u8F91", icon: ICON_FILE_PEN, tint: "warning", summarize: sum(summarizePath) },
+  write: { label: "\u5199\u5165", icon: ICON_FILE_PLUS, tint: "warning", summarize: sum(summarizePath) },
+  rm: { label: "\u5220\u9664", icon: ICON_TRASH, tint: "error", summarize: sum(summarizePath) },
+  grep: { label: "\u641C\u7D22", icon: ICON_SEARCH, tint: "info", summarize: sum(summarizeGrep) },
+  glob: { label: "\u5339\u914D", icon: ICON_FOLDER_SEARCH, tint: "info", summarize: sum((i) => pickStr(i, ["pattern", "glob", "path"])) },
+  browser: { label: "\u6D4F\u89C8", icon: ICON_GLOBE, tint: "accent", summarize: sum((i) => pickStr(i, ["url", "uri", "target"])) },
+  search: { label: "\u68C0\u7D22", icon: ICON_SCAN_SEARCH, tint: "accent", summarize: sum((i) => pickStr(i, ["query", "q", "pattern"])) },
+  fetch: { label: "\u8BF7\u6C42", icon: ICON_DOWNLOAD, tint: "info", summarize: sum((i) => pickStr(i, ["url", "uri", "endpoint"])) },
+  mcp: { label: "MCP", icon: ICON_BLOCKS, tint: "muted", summarize: sum((i) => pickStr(i, ["tool", "method", "name"])) },
+  skill: { label: "\u6280\u80FD", icon: ICON_ZAP, tint: "accent", summarize: sum((i) => pickStr(i, ["skill", "name", "command"])) },
+  todo: {
+    label: "\u5F85\u529E",
+    icon: ICON_LIST,
+    tint: "info",
+    summarize: sum((input) => {
+      const items = input && typeof input === "object" && Array.isArray(input.items) ? input.items : Array.isArray(input) ? input : [];
+      const done = items.filter((it) => it?.status === "done").length;
+      return items.length > 0 ? `${done}/${items.length} \u5B8C\u6210` : "";
+    })
+  },
+  plan: { label: "\u8BA1\u5212", icon: ICON_LIST_CHECKS, tint: "info" },
+  subagent: { label: "\u5B50\u4EE3\u7406", icon: ICON_BOT, tint: "accent", summarize: sum((i) => pickStr(i, ["task", "description", "prompt", "message", "subagent_type"])) },
+  note: { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" },
+  chart: { label: "\u56FE\u8868", icon: ICON_CHART, tint: "info", summarize: sum((i) => pickStr(i, ["title", "name"])) }
+};
+var kindRegistry = new Map(Object.entries(BUILTIN_KINDS));
+function h(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text != null) node.textContent = text;
+  return node;
+}
+
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/ai-diff.ts
 var RE_HUNK = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
 var RE_OLD_FILE = /^--- (.*)$/;
@@ -114,60 +254,54 @@ function parseUnifiedDiff(text) {
   }
   return files;
 }
-function el(tag, className, text) {
-  const node = document.createElement(tag);
-  if (className) node.className = className;
-  if (text !== void 0) node.textContent = text;
-  return node;
-}
 function renderLineRow(line) {
   const tr = document.createElement("tr");
   tr.className = `ai-diff-line--${line.type}`;
   if (line.type === "hunk") {
-    const td = el("td", "", line.text);
+    const td = h("td", "", line.text);
     td.colSpan = 3;
     tr.appendChild(td);
     return tr;
   }
-  const oldTd = el("td", "ai-diff-ln", line.oldNo === null ? "" : String(line.oldNo));
+  const oldTd = h("td", "ai-diff-ln", line.oldNo === null ? "" : String(line.oldNo));
   oldTd.setAttribute("aria-hidden", "true");
-  const newTd = el("td", "ai-diff-ln", line.newNo === null ? "" : String(line.newNo));
+  const newTd = h("td", "ai-diff-ln", line.newNo === null ? "" : String(line.newNo));
   newTd.setAttribute("aria-hidden", "true");
   tr.appendChild(oldTd);
   tr.appendChild(newTd);
-  tr.appendChild(el("td", "ai-diff-code", line.text));
+  tr.appendChild(h("td", "ai-diff-code", line.text));
   return tr;
 }
 function renderFile(file) {
-  const root = el("div", `ai-diff-file is-${file.status}`);
+  const root = h("div", `ai-diff-file is-${file.status}`);
   root.dataset.path = file.path;
-  const head = el("div", "ai-diff-head");
+  const head = h("div", "ai-diff-head");
   head.setAttribute("role", "button");
   head.tabIndex = 0;
   head.setAttribute("aria-expanded", "false");
   const pathText = file.status === "renamed" && file.oldPath ? `${file.oldPath} \u2192 ${file.path}` : file.path;
-  head.appendChild(el("span", "ai-diff-path", pathText));
-  const stat = el("span", "ai-diff-stat");
-  if (file.addCount > 0) stat.appendChild(el("b", "ai-diff-add", `+${file.addCount}`));
-  if (file.delCount > 0) stat.appendChild(el("b", "ai-diff-del", `\u2212${file.delCount}`));
+  head.appendChild(h("span", "ai-diff-path", pathText));
+  const stat = h("span", "ai-diff-stat");
+  if (file.addCount > 0) stat.appendChild(h("b", "ai-diff-add", `+${file.addCount}`));
+  if (file.delCount > 0) stat.appendChild(h("b", "ai-diff-del", `\u2212${file.delCount}`));
   if (stat.children.length > 0) head.appendChild(stat);
-  const actions = el("span", "ai-diff-actions");
-  actions.appendChild(el("button", "", "\u63A5\u53D7")).setAttribute("data-ai-diff-accept", "");
-  const rejectBtn = el("button", "", "\u62D2\u7EDD");
+  const actions = h("span", "ai-diff-actions");
+  actions.appendChild(h("button", "", "\u63A5\u53D7")).setAttribute("data-ai-diff-accept", "");
+  const rejectBtn = h("button", "", "\u62D2\u7EDD");
   rejectBtn.setAttribute("data-ai-diff-reject", "");
   actions.appendChild(rejectBtn);
   head.appendChild(actions);
-  const verdict = el("span", "ai-diff-verdict");
+  const verdict = h("span", "ai-diff-verdict");
   verdict.hidden = true;
   head.appendChild(verdict);
   root.appendChild(head);
-  const body = el("div", "ai-diff-body");
+  const body = h("div", "ai-diff-body");
   body.hidden = true;
-  const table = el("table", "ai-diff-table");
+  const table = h("table", "ai-diff-table");
   if (file.hunks.length === 0) {
     const tr = document.createElement("tr");
     tr.className = "ai-diff-line--ctx";
-    const td = el("td", "", file.binary ? "\u4E8C\u8FDB\u5236\u6587\u4EF6\uFF0C\u65E0\u6CD5\u663E\u793A\u6587\u672C\u5DEE\u5F02" : "\u65E0\u5DEE\u5F02\u5185\u5BB9");
+    const td = h("td", "", file.binary ? "\u4E8C\u8FDB\u5236\u6587\u4EF6\uFF0C\u65E0\u6CD5\u663E\u793A\u6587\u672C\u5DEE\u5F02" : "\u65E0\u5DEE\u5F02\u5185\u5BB9");
     td.colSpan = 3;
     tr.appendChild(td);
     table.appendChild(tr);
@@ -181,13 +315,14 @@ function renderFile(file) {
   root.appendChild(body);
   return root;
 }
-function renderAiDiff(elm, model) {
-  if (typeof document === "undefined") return;
-  elm.textContent = "";
-  const root = el("div", "ai-diff");
+function renderAiDiff(el, model) {
+  if (typeof document === "undefined") return el;
+  el.textContent = "";
+  const root = h("div", "ai-diff");
   const files = Array.isArray(model?.files) ? model.files : [];
   for (const file of files) root.appendChild(renderFile(file));
-  elm.appendChild(root);
+  el.appendChild(root);
+  return el;
 }
 var noopDestroy = () => void 0;
 function closestFile(node) {
@@ -206,10 +341,7 @@ function toggleFile(head) {
   const open = body.hidden;
   body.hidden = !open;
   head.setAttribute("aria-expanded", String(open));
-  file.dispatchEvent(new CustomEvent("icen:ai-toggle", {
-    bubbles: true,
-    detail: { el: file, open }
-  }));
+  emitIcen(file, "icen:ai-toggle", { el: file, open });
 }
 function decide(btn, accepted) {
   const file = closestFile(btn);
@@ -218,7 +350,7 @@ function decide(btn, accepted) {
   file.classList.add(accepted ? "is-accepted" : "is-rejected");
   let verdict = file.querySelector(".ai-diff-verdict");
   if (!verdict) {
-    verdict = el("span", "ai-diff-verdict");
+    verdict = h("span", "ai-diff-verdict");
     file.querySelector(".ai-diff-head")?.appendChild(verdict);
   }
   verdict.textContent = accepted ? "\u5DF2\u63A5\u53D7" : "\u5DF2\u62D2\u7EDD";
@@ -229,10 +361,7 @@ function decide(btn, accepted) {
     b.hidden = true;
     b.disabled = true;
   });
-  file.dispatchEvent(new CustomEvent(accepted ? "icen:ai-diff-accept" : "icen:ai-diff-reject", {
-    bubbles: true,
-    detail: { path: filePath(file) }
-  }));
+  emitIcen(file, accepted ? "icen:ai-diff-accept" : "icen:ai-diff-reject", { path: filePath(file) });
 }
 function initAiDiff(root) {
   if (typeof document === "undefined") return noopDestroy;
@@ -244,14 +373,16 @@ function initAiDiff(root) {
   const onClick = (e) => {
     const t = e.target instanceof Element ? e.target : null;
     if (!t) return;
-    if (t.closest("[data-ai-diff-accept]")) {
+    const acceptBtn = t.closest("[data-ai-diff-accept]");
+    if (acceptBtn) {
       e.stopPropagation();
-      decide(t.closest("[data-ai-diff-accept]"), true);
+      decide(acceptBtn, true);
       return;
     }
-    if (t.closest("[data-ai-diff-reject]")) {
+    const rejectBtn = t.closest("[data-ai-diff-reject]");
+    if (rejectBtn) {
       e.stopPropagation();
-      decide(t.closest("[data-ai-diff-reject]"), false);
+      decide(rejectBtn, false);
       return;
     }
     const head = t.closest(".ai-diff-head");

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

@@ -9,8 +9,9 @@ interface AiTodoItem {
 }
 /**
  * 渲染 todo 列表（DOM API，全 textContent）。全部完成时容器加 .is-complete。
+ * 返回挂载容器 el（render* 返回挂载元素约定，SSR 下原样返回）。
  */
-declare function renderAiTodo(elm: HTMLElement, items: AiTodoItem[]): void;
+declare function renderAiTodo(el: HTMLElement, items: AiTodoItem[]): HTMLElement;
 /**
  * todo 委托初始化：仅 data-ai-todo-interactive 容器可点击循环状态（pending→running→done），
  * 只读列表不挂交互。重复调用安全；返回销毁函数。
@@ -23,10 +24,10 @@ interface AiUsageRenderOpts {
     cost?: number;
 }
 /**
- * 渲染用量分段条 + 图例 + 占比。
+ * 渲染用量分段条 + 图例 + 占比。返回挂载容器 el（render* 返回挂载元素约定）。
  * 配色契约：input=accent / output=success / cacheRead=info / cacheWrite=warning / reasoning=faint。
  */
-declare function renderAiUsage(elm: HTMLElement, usage: AiUsage, opts?: AiUsageRenderOpts): void;
+declare function renderAiUsage(el: HTMLElement, usage: AiUsage, opts?: AiUsageRenderOpts): HTMLElement;
 interface AiUsageRingOpts extends AiUsageRenderOpts {
     /** 弹层标题（默认「上下文窗口」） */
     title?: string;
@@ -37,9 +38,9 @@ interface AiUsageRingOpts extends AiUsageRenderOpts {
  * opts.total 给上下文窗口上限（如 200000）——环填充比 = 已用 / total；
  * 缺省 total 时环不填充、中心显示已用量。
  * 状态档：<60% is-ok（accent）/ 60–85% is-warn / >85% is-hot（error）。
- * 重复调用重渲染；打开中的弹层会被关闭重建。
+ * 重复调用重渲染；打开中的弹层会被关闭重建。返回挂载容器 el。
  */
-declare function renderAiUsageRing(elm: HTMLElement, usage: AiUsage, opts?: AiUsageRingOpts): void;
+declare function renderAiUsageRing(el: HTMLElement, usage: AiUsage, opts?: AiUsageRingOpts): HTMLElement;
 interface AiContextFile {
     path: string;
     status?: 'added' | 'modified' | 'deleted';
@@ -68,14 +69,16 @@ interface AiContextModel {
 /**
  * 组合渲染上下文抽屉：usage → renderAiUsage；files → ai-file-chip；
  * mcpServers / skills → .ai-item 行。aside 默认 hidden，由 initAiContext 开合。
+ * 返回挂载容器 el（render* 返回挂载元素约定）。
  */
-declare function renderAiContext(elm: HTMLElement, model: AiContextModel): void;
+declare function renderAiContext(el: HTMLElement, model: AiContextModel): HTMLElement;
 /**
  * 触发器 [data-ai-context-open] 委托开合：
  *   - 属性值为 #id / 选择器时定位对应抽屉，空值取 scope 内第一个非 inline 抽屉
  *   - 打开：去 hidden → reflow → .is-open 滑入（CSS transition），焦点移入 close 钮
  *   - 关闭：[data-ai-context-close] / Esc / 外点；.is-open 移除 → transition 结束（或兜底计时）
  *     后恢复 hidden，焦点还原触发器；Tab/Shift+Tab 焦点圈禁
+ *   - 开/合从抽屉根元素派 icen:ai-context-open {} / icen:ai-context-close {}（bubbles）
  *   - .ai-context--inline 为页面流内嵌变体：不参与开合、不做 fixed
  */
 declare function initAiContext(root?: ParentNode): () => void;
@@ -91,8 +94,8 @@ interface AiAuditRenderOpts {
  * 渲染审计面板：totals（请求数/失败/累计 tokens/累计成本/平均 TTFT）+ byModel 分组 +
  * 最近请求条目（默认 10 条，最新在前）。source 为 auditor 实例或条目数组（快照渲染，
  * 数据更新后重调）。清除钮派 icen:ai-audit-clear { }（消费方调 auditor.clear() 后重渲染），
- * opts.onClear 给了则走回调。
+ * opts.onClear 给了则走回调。返回挂载容器 el（render* 返回挂载元素约定）。
  */
-declare function renderAiAudit(elm: HTMLElement, source: AiAuditor | AiAuditEntry[], opts?: AiAuditRenderOpts): void;
+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 };