@icen.ai/ui 0.8.0 → 0.9.0

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-feedback.d.mts

@@ -0,0 +1,26 @@
+/** 反馈事件 detail（与 IcenEventMap['icen:ai-feedback'] 同构；el 为 .ai-feedback 根） */
+interface AiFeedbackDetail {
+    value: 1 | -1 | 0;
+    reason?: string;
+    el?: HTMLElement;
+}
+interface AiFeedbackOpts {
+    /** 踩因枚举（默认五项） */
+    reasons?: string[];
+    /** 反馈回调（与 icen:ai-feedback 事件双通道） */
+    onFeedback?: (detail: AiFeedbackDetail) => void;
+}
+/**
+ * 渲染 👍/👎 双钮 + 踩因 chips + 提交/已提交态（快照渲染，全 textContent）。
+ * 交互由 initAiFeedback 委托驱动；opts.onFeedback 与 icen:ai-feedback 事件双通道。
+ * 返回挂载容器 el（render* 返回挂载元素约定，SSR 下原样返回）。
+ */
+declare function renderAiFeedback(el: HTMLElement, opts?: AiFeedbackOpts): HTMLElement;
+/**
+ * 反馈委托初始化：vote 切换/取消、chip 单选、提交进入 .is-done 终态。
+ * 幂等（scope 挂 __icenAiFeedbackInit）；返回销毁函数（解绑监听 + 复位标记，可重新 init）。
+ * SSR 下为 no-op。按钮为原生 button，键盘 Enter/Space 走原生 click，无需键盘委托。
+ */
+declare function initAiFeedback(root?: ParentNode): () => void;
+
+export { type AiFeedbackDetail, type AiFeedbackOpts, initAiFeedback, renderAiFeedback };