@icen.ai/ui 0.8.1 → 0.9.0

package/dist/behaviors/ai-panel.mjs

@@ -474,10 +474,16 @@ function buildTodoHead(done, total) {
   head.appendChild(bar);
   return head;
 }
+var ICON_TODO_CHECK = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="m3.5 12.5 5 5L20.5 6" pathLength="1"/></svg>';
 function buildTodoItem(item, index) {
   const row = h("div", `ai-todo-item is-${item.status}`);
   row.dataset.index = String(index);
   row.appendChild(h("span", "ai-item-status"));
+  const check = h("span", "ai-todo-check is-anim");
+  check.setAttribute("aria-hidden", "true");
+  const checkSvg = svgIcon(ICON_TODO_CHECK);
+  if (checkSvg) check.appendChild(checkSvg);
+  row.appendChild(check);
   row.appendChild(h("span", "ai-todo-text", item.content));
   row.appendChild(h("span", "ai-todo-active", item.activeForm ?? item.content));
   return row;
@@ -581,6 +587,18 @@ function initAiTodo(root) {
     marked.__icenAiTodoInit = false;
   };
 }
+function metricField(src, key) {
+  return typeof src === "object" && src !== null ? src[key] : void 0;
+}
+function metricNum(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
+function metricStr(v) {
+  return typeof v === "string" && v ? v : void 0;
+}
+function trimNum(v) {
+  return String(Math.round(v * 10) / 10);
+}
 function renderAiUsage(el, usage, opts = {}) {
   if (typeof document === "undefined") return el;
   const u = normalizeUsage(usage);
@@ -621,6 +639,14 @@ function renderAiUsage(el, usage, opts = {}) {
     }
     root.appendChild(legend);
   }
+  const ttft = metricNum(opts.metrics?.ttftMs) ?? metricNum(metricField(usage, "ttftMs"));
+  const tps = metricNum(opts.metrics?.tokensPerSec) ?? metricNum(metricField(usage, "tokensPerSec"));
+  const finish = metricStr(opts.metrics?.finishReason) ?? metricStr(metricField(usage, "finishReason"));
+  const metricBits = [];
+  if (ttft != null) metricBits.push(`TTFT ${formatDuration(ttft)}`);
+  if (tps != null && tps > 0) metricBits.push(`${trimNum(tps)} tok/s`);
+  if (finish) metricBits.push(`finish: ${finish}`);
+  if (metricBits.length > 0) root.appendChild(h("div", "ai-usage-metrics", metricBits.join(" \xB7 ")));
   const totalParts = [formatTokens(total)];
   if (typeof opts.total === "number" && opts.total > 0) {
     const pct = Math.min(100, Math.round(total / opts.total * 100));

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

@@ -0,0 +1,38 @@
+interface AiThreadItem {
+    /** 稳定标识（事件 detail 的 key） */
+    key: string;
+    /** 会话标题 */
+    label: string;
+    /** 分组名（如「今天」/「昨天」/「更早」）；groups 模式下生效 */
+    group?: string;
+    /** 内联 SVG 字符串（lucide 风格 24×24 stroke）；渲染时经 svgIcon() 消毒 */
+    icon?: string;
+    /** 已归档：.is-archived 降透明并沉底（分组模式收进「已归档」组） */
+    archived?: boolean;
+}
+interface AiThreadsModel {
+    items: AiThreadItem[];
+    /** 当前激活会话 key（路由同步） */
+    activeKey?: string;
+    /** 分组模式：true 时按 group 字段分组（组头可折叠）；缺省/false 平铺 */
+    groups?: boolean;
+}
+/**
+ * 快照渲染会话列表：平铺或分组（model.groups）、activeKey 高亮、archived 沉底
+ * （分组模式收进「已归档」组，组头可折叠）。返回挂载容器 el（SSR 原样返回）。
+ */
+declare function renderAiThreads(el: HTMLElement, model: AiThreadsModel): HTMLElement;
+/**
+ * 外部路由同步激活态：el 范围内 data-key === key 的 .ai-thread 挂 .is-active
+ * （+aria-current），其余摘除；key 为空串/null/undefined 时清空全部激活。
+ * 对静态手写 DOM 与 renderAiThreads 产物一视同仁。返回 el。
+ */
+declare function setAiThreadsActive(el: HTMLElement, key: string | null | undefined): HTMLElement;
+/**
+ * 会话列表委托初始化：选择 / 动作挂载点 / 组头折叠。
+ * 幂等（scope 挂 __icenAiThreadsInit）；返回销毁函数（解绑监听 + 复位标记，可重新 init）。
+ * SSR 下为 no-op。
+ */
+declare function initAiThreads(root?: ParentNode): () => void;
+
+export { type AiThreadItem, type AiThreadsModel, initAiThreads, renderAiThreads, setAiThreadsActive };

package/dist/behaviors/ai-threads.mjs

@@ -0,0 +1,319 @@
+// 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;
+}
+function svgIcon(svg2) {
+  if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
+  let parsed;
+  try {
+    parsed = new DOMParser().parseFromString(svg2, "image/svg+xml");
+  } catch {
+    return null;
+  }
+  const root = parsed.documentElement;
+  if (!root || root.tagName.toLowerCase() !== "svg" || parsed.querySelector("parsererror")) {
+    return null;
+  }
+  const sanitize = (el) => {
+    for (const attr of Array.from(el.attributes)) {
+      const name = attr.name.toLowerCase();
+      if (name.startsWith("on")) el.removeAttribute(attr.name);
+      if ((name === "href" || name === "xlink:href") && attr.value.trim().toLowerCase().startsWith("javascript:")) {
+        el.removeAttribute(attr.name);
+      }
+    }
+    for (const child of Array.from(el.children)) {
+      const tag = child.tagName.toLowerCase();
+      if (tag === "script" || tag === "foreignobject") {
+        child.remove();
+        continue;
+      }
+      sanitize(child);
+    }
+  };
+  sanitize(root);
+  return document.importNode(root, true);
+}
+
+// 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-threads.ts
+var ARCHIVED_GROUP = "\u5DF2\u5F52\u6863";
+function dispatch(node, name, detail) {
+  emitIcen(node, name, detail);
+}
+function buildThread(item, activeKey) {
+  const row = h("div", "ai-thread");
+  if (item.key) row.dataset.key = item.key;
+  if (item.archived) row.classList.add("is-archived");
+  if (activeKey != null && item.key === activeKey) {
+    row.classList.add("is-active");
+    row.setAttribute("aria-current", "true");
+  }
+  row.setAttribute("role", "button");
+  row.tabIndex = 0;
+  if (item.icon) {
+    const iconWrap = h("span", "ai-thread-icon");
+    const svg2 = svgIcon(item.icon);
+    if (svg2) iconWrap.appendChild(svg2);
+    row.appendChild(iconWrap);
+  }
+  row.appendChild(h("span", "ai-thread-label", item.label));
+  const action = h("button", "ai-thread-action", "\xB7\xB7\xB7");
+  action.type = "button";
+  action.setAttribute("aria-label", "\u4F1A\u8BDD\u64CD\u4F5C");
+  action.setAttribute("data-thread-action", "rename");
+  row.appendChild(action);
+  return row;
+}
+function renderAiThreads(el, model) {
+  if (typeof document === "undefined") return el;
+  el.textContent = "";
+  const root = h("div", "ai-threads");
+  const items = Array.isArray(model.items) ? model.items : [];
+  const active = items.filter((it) => !it.archived);
+  const archived = items.filter((it) => it.archived);
+  if (model.groups) {
+    const ungrouped = active.filter((it) => !(it.group ?? "").trim());
+    for (const it of ungrouped) root.appendChild(buildThread(it, model.activeKey));
+    const groups = /* @__PURE__ */ new Map();
+    for (const it of active) {
+      const label = (it.group ?? "").trim();
+      if (!label) continue;
+      const list = groups.get(label) ?? [];
+      list.push(it);
+      groups.set(label, list);
+    }
+    for (const [label, list] of groups) {
+      const group = h("div", "ai-threads-group");
+      group.dataset.group = label;
+      const head = h("button", "ai-threads-group-head", label);
+      head.type = "button";
+      head.setAttribute("aria-expanded", "true");
+      group.appendChild(head);
+      const listEl = h("div", "ai-threads-group-list");
+      for (const it of list) listEl.appendChild(buildThread(it, model.activeKey));
+      group.appendChild(listEl);
+      root.appendChild(group);
+    }
+    if (archived.length > 0) {
+      const group = h("div", "ai-threads-group");
+      group.dataset.group = ARCHIVED_GROUP;
+      const head = h("button", "ai-threads-group-head", ARCHIVED_GROUP);
+      head.type = "button";
+      head.setAttribute("aria-expanded", "true");
+      group.appendChild(head);
+      const listEl = h("div", "ai-threads-group-list");
+      for (const it of archived) listEl.appendChild(buildThread(it, model.activeKey));
+      group.appendChild(listEl);
+      root.appendChild(group);
+    }
+  } else {
+    for (const it of active) root.appendChild(buildThread(it, model.activeKey));
+    for (const it of archived) root.appendChild(buildThread(it, model.activeKey));
+  }
+  el.appendChild(root);
+  return el;
+}
+function setAiThreadsActive(el, key) {
+  const threads = Array.from(el.querySelectorAll(".ai-thread"));
+  if (el instanceof HTMLElement && el.classList.contains("ai-thread")) threads.unshift(el);
+  for (const t of threads) {
+    const hit = key != null && key !== "" && t.dataset.key === key;
+    t.classList.toggle("is-active", hit);
+    if (hit) t.setAttribute("aria-current", "true");
+    else t.removeAttribute("aria-current");
+  }
+  return el;
+}
+function initAiThreads(root) {
+  if (typeof document === "undefined") return () => void 0;
+  const scope = root ?? document;
+  const marked = scope;
+  if (marked.__icenAiThreadsInit) return () => void 0;
+  marked.__icenAiThreadsInit = true;
+  const target = scope;
+  const selectThread = (thread) => {
+    const key = thread.dataset.key ?? "";
+    dispatch(thread, "icen:ai-thread-select", { key });
+  };
+  const toggleGroup = (head) => {
+    const group = head.closest(".ai-threads-group");
+    if (!group) return;
+    const open = head.getAttribute("aria-expanded") !== "true";
+    head.setAttribute("aria-expanded", String(open));
+    group.classList.toggle("is-collapsed", !open);
+  };
+  const onClick = (e) => {
+    const t = e.target instanceof Element ? e.target : null;
+    if (!t) return;
+    const action = t.closest(".ai-thread-action");
+    if (action) {
+      const thread2 = action.closest(".ai-thread");
+      if (!thread2) return;
+      dispatch(thread2, "icen:ai-thread-action", { action: "rename", key: thread2.dataset.key ?? "" });
+      return;
+    }
+    const head = t.closest(".ai-threads-group-head");
+    if (head) {
+      toggleGroup(head);
+      return;
+    }
+    const thread = t.closest(".ai-thread");
+    if (thread) selectThread(thread);
+  };
+  const onKeydown = (e) => {
+    const ke = e;
+    if (ke.key !== "Enter" && ke.key !== " ") return;
+    const t = ke.target instanceof Element ? ke.target : null;
+    const thread = t?.closest(".ai-thread");
+    if (!thread || thread.getAttribute("role") !== "button") return;
+    ke.preventDefault();
+    selectThread(thread);
+  };
+  target.addEventListener("click", onClick);
+  target.addEventListener("keydown", onKeydown);
+  return () => {
+    target.removeEventListener("click", onClick);
+    target.removeEventListener("keydown", onKeydown);
+    marked.__icenAiThreadsInit = false;
+  };
+}
+export {
+  initAiThreads,
+  renderAiThreads,
+  setAiThreadsActive
+};

package/dist/behaviors/ai-tool.mjs

@@ -1829,6 +1829,11 @@ function renderChart(el, raw) {
     }
   };
 }
+var GRAPH_W = 360;
+var GRAPH_H = 260;
+var GRAPH_PAD = 28;
+var GRAPH_LW = GRAPH_W - GRAPH_PAD * 2;
+var GRAPH_LH = GRAPH_H - GRAPH_PAD * 2;
 
 // src/behaviors/ai-tool.ts
 function setStatusClass(item, status) {

package/dist/behaviors/ai-tools.mjs

@@ -1448,6 +1448,11 @@ function renderChart(el, raw) {
     }
   };
 }
+var GRAPH_W = 360;
+var GRAPH_H = 260;
+var GRAPH_PAD = 28;
+var GRAPH_LW = GRAPH_W - GRAPH_PAD * 2;
+var GRAPH_LH = GRAPH_H - GRAPH_PAD * 2;
 
 // src/behaviors/ai-tools.ts
 var toolRegistry = /* @__PURE__ */ new Map();

package/dist/behaviors/charts.d.mts

@@ -292,5 +292,107 @@ declare function bindChartEvents(root: HTMLElement): () => void;
  * spec.title 有值时渲染 .chart-title。返回 { el, spec, update, on, destroy }。
  */
 declare function renderChart(el: HTMLElement, raw: ChartSpec | unknown): ChartHandle;
+/** 图谱节点（GraphRAG 实体）。weight 缺省以度中心性（邻边数）参与定尺寸 */
+interface GraphNodeSpec {
+    id: string;
+    label?: string;
+    /** 簇 key（社区/Leiden id 等）：配色按簇索引走既有调色盘 */
+    cluster?: string;
+    /** 节点权重（映射半径 6–18px）；缺省用度数 */
+    weight?: number;
+    /** 原始元数据：事件 datum 原样回传（实体卡数据源） */
+    meta?: Record<string, unknown>;
+}
+/** 图谱边（默认无向；directed 时带箭头）。weight 映射线宽 0.6–2.5px */
+interface GraphEdgeSpec {
+    source: string;
+    target: string;
+    weight?: number;
+}
+interface GraphSpec extends ChartSpec {
+    type: 'graph';
+    nodes: GraphNodeSpec[];
+    edges: GraphEdgeSpec[];
+    /** 有向图：边带箭头（默认无向） */
+    directed?: boolean;
+    /** 簇 key → 显示名（图例 / tooltip） */
+    clusterLabels?: Record<string, string>;
+}
+/** 嵌入地图点：x/y 为预投影 2D 坐标（UMAP/t-SNE 产物；本组件只做视口缩放，不算投影） */
+interface MapPointSpec {
+    id: string;
+    x: number;
+    y: number;
+    cluster?: string;
+    label?: string;
+    meta?: Record<string, unknown>;
+}
+interface MapSpec extends ChartSpec {
+    type: 'map';
+    points: MapPointSpec[];
+    /** 簇 key → 显示名（图例） */
+    clusters?: Record<string, string>;
+}
+/** icen:chart-* 的 datum 负载：graph 命中节点 / map 命中点（meta 原样回传） */
+interface ChartDatum {
+    id: string;
+    label: string;
+    cluster?: string;
+    meta?: Record<string, unknown>;
+}
+/** graph / map 的事件 detail：既有 ChartEventDetail + datum */
+interface ChartDatumDetail extends ChartEventDetail {
+    datum?: ChartDatum;
+}
+/** graph / map 句柄（对齐 ChartHandle 形状；事件 detail 换 ChartDatumDetail） */
+interface DatumChartHandle<S extends GraphSpec | MapSpec = GraphSpec | MapSpec> {
+    el: HTMLElement;
+    /** 归一后的当前规格 */
+    spec: S;
+    /** 原地重渲染（graph 重新布局；保留事件委托与句柄） */
+    update(next: S | unknown): void;
+    /** icen:chart-<name> 监听糖（hover/click/dblclick/contextmenu）；返回解绑函数 */
+    on(name: ChartEventName, listener: (detail: ChartDatumDetail, event: Event) => void): () => void;
+    /** 清空渲染并解绑委托（destroy 后可重新渲染） */
+    destroy(): void;
+}
+interface GraphLayoutOptions {
+    /** 布局域宽（默认 320） */
+    width?: number;
+    /** 布局域高（默认 200） */
+    height?: number;
+    /** 松弛轮数（默认 300） */
+    iterations?: number;
+    /** 初始环相位偏移（度，默认 0）。无随机源——同输入 + 同 seed 必同布局 */
+    seed?: number;
+}
+/** 确定性力导向布局（纯函数，导出便于测试）：环初始化 → 松弛 → fit → id → {x, y} */
+declare function layoutGraph(nodes: Array<{
+    id: unknown;
+}>, edges: Array<{
+    source: unknown;
+    target: unknown;
+}>, opts?: GraphLayoutOptions): Map<string, {
+    x: number;
+    y: number;
+}>;
+/**
+ * 力导向知识图谱（GraphRAG 实体关系）。确定性布局（同数据同布局，无随机源）；
+ * 节点半径 6–18px（weight 归一，缺省用度中心性）、边宽 0.6–2.5px（line-soft）、
+ * 簇着色走既有调色盘（无 cluster 单色 tone）；节点拖拽 = pointer + 局部松弛
+ * 20 轮（rAF 批处理）；hover 显示节点 label（≤8 字截断）+ 内置 tooltip；
+ * 事件走既有通道 icen:chart-hover/click/dblclick/contextmenu，detail.datum =
+ * {id, label, cluster?, meta?}（点击节点回实体卡数据）。图例可点击隐藏簇
+ * （icen:chart-legend-toggle；边随任一端簇隐藏淡化）。
+ */
+declare function renderGraph(el: HTMLElement, raw: GraphSpec | unknown): DatumChartHandle<GraphSpec>;
+/**
+ * embedding 2D 散点地图：坐标为预投影值（UMAP/t-SNE 产物，本函数只做视口
+ * min-max 缩放，不算投影）；无轴刻度只留细虚线网格；点 4px 半透明
+ * （fill-opacity .7，高密度层叠可辨）；簇着色走既有调色盘 + 可点击图例。
+ * 点击点 → icen:chart-click（detail.datum = {id, label, cluster?, meta?}，
+ * 点选回 chunk）。TODO: lasso 框选（icen:chart-select + 命中列表），暂不做。
+ */
+declare function renderMap(el: HTMLElement, raw: MapSpec | unknown): DatumChartHandle<MapSpec>;
 
-export { type ChartCalendarOptions, type ChartChromeOptions, type ChartDims, type ChartEventDetail, type ChartEventName, type ChartGaugeOptions, type ChartHandle, type ChartHeatmapOptions, type ChartI18nLabels, type ChartLineOptions, type ChartMarkData, type ChartPointSpec, type ChartRadarOptions, type ChartScatterOptions, type ChartSegment, type ChartSegmentsOptions, type ChartSeriesOptions, type ChartSeriesSpec, type ChartSpec, type ChartTone, type ChartType, type ChartVBarOptions, type ChartValueFormat, type HeatmapDatum, type RadarSeries, bindChartEvents, chartFormatValue, inferChartType, normalizeChartSpec, registerChartTone, renderArea, renderCalendar, renderChart, renderDonut, renderGauge, renderHBar, renderHeatmap, renderLine, renderRadar, renderScatter, renderSparkline, renderStack, renderVBar };
+export { type ChartCalendarOptions, type ChartChromeOptions, type ChartDatum, type ChartDatumDetail, type ChartDims, type ChartEventDetail, type ChartEventName, type ChartGaugeOptions, type ChartHandle, type ChartHeatmapOptions, type ChartI18nLabels, type ChartLineOptions, type ChartMarkData, type ChartPointSpec, type ChartRadarOptions, type ChartScatterOptions, type ChartSegment, type ChartSegmentsOptions, type ChartSeriesOptions, type ChartSeriesSpec, type ChartSpec, type ChartTone, type ChartType, type ChartVBarOptions, type ChartValueFormat, type DatumChartHandle, type GraphEdgeSpec, type GraphLayoutOptions, type GraphNodeSpec, type GraphSpec, type HeatmapDatum, type MapPointSpec, type MapSpec, type RadarSeries, bindChartEvents, chartFormatValue, inferChartType, layoutGraph, normalizeChartSpec, registerChartTone, renderArea, renderCalendar, renderChart, renderDonut, renderGauge, renderGraph, renderHBar, renderHeatmap, renderLine, renderMap, renderRadar, renderScatter, renderSparkline, renderStack, renderVBar };