@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/kb-chunks.mjs

@@ -0,0 +1,475 @@
+// 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(svg3) {
+  if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
+  let parsed;
+  try {
+    parsed = new DOMParser().parseFromString(svg3, "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/kb-core.ts
+var ic = (label, d) => ({ label, icon: `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${d}</svg>` });
+var BUILTIN_SOURCE_TYPES = {
+  doc: ic("\u6587\u6863", '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/>'),
+  web: ic("\u7F51\u9875", '<circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15 15 0 0 1 0 20 15 15 0 0 1 0-20z"/>'),
+  wiki: ic("\u77E5\u8BC6\u5E93", '<path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"/><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"/>'),
+  sheet: ic("\u8868\u683C", '<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18M15 3v18"/>'),
+  db: ic("\u6570\u636E\u5E93", '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.7 4 3 9 3s9-1.3 9-3V5"/><path d="M3 12c0 1.7 4 3 9 3s9-1.3 9-3"/>'),
+  ticket: ic("\u5DE5\u5355", '<path d="M3 9V7a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v2a2 2 0 0 0 0 6v2a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-2a2 2 0 0 0 0-6z"/><path d="M13 5v14"/>'),
+  code: ic("\u4EE3\u7801", '<path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/>'),
+  api: ic("\u63A5\u53E3", '<path d="M4 7a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v3a2 2 0 0 0 0 4v3a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-3a2 2 0 0 0 0-4z"/>'),
+  image: ic("\u56FE\u7247", '<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-4.6-4.6a2 2 0 0 0-2.8 0L3 21"/>'),
+  mail: ic("\u90AE\u4EF6", '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="m22 7-10 7L2 7"/>')
+};
+var sourceTypeRegistry = new Map(Object.entries(BUILTIN_SOURCE_TYPES));
+function normalizeChunk(raw) {
+  const kw = Array.isArray(raw.keywords) ? raw.keywords.map(String) : void 0;
+  return {
+    id: String(raw.id ?? ""),
+    documentId: String(raw.documentId ?? ""),
+    content: String(raw.content ?? ""),
+    keywords: kw && kw.length ? kw : void 0,
+    available: raw.available !== false,
+    page: typeof raw.page === "number" ? raw.page : void 0,
+    start: typeof raw.start === "number" ? raw.start : void 0,
+    end: typeof raw.end === "number" ? raw.end : void 0,
+    imageId: typeof raw.imageId === "string" ? raw.imageId : void 0,
+    meta: raw.meta && typeof raw.meta === "object" ? raw.meta : void 0,
+    edited: raw.edited === 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/kb-chunks.ts
+var svg2 = (d) => `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${d}</svg>`;
+var ICON_PLUS = svg2('<path d="M5 12h14"/><path d="M12 5v14"/>');
+function icon(parent, svgStr) {
+  const node = svgIcon(svgStr);
+  if (node) parent.appendChild(node);
+}
+var MODE_LABELS = { text: "\u5168\u6587", vector: "\u8BED\u4E49" };
+function buildSearchBar(opts) {
+  const bar = h("div", "kb-chunks-bar");
+  const mode = opts.searchMode === "vector" ? "vector" : "text";
+  const seg = h("div", "kb-seg kb-chunks-mode");
+  seg.setAttribute("role", "radiogroup");
+  seg.setAttribute("aria-label", "\u641C\u7D22\u6A21\u5F0F");
+  ["text", "vector"].forEach((m) => {
+    const item = h("button", `kb-seg-item kb-chunks-mode-item${m === mode ? " is-active" : ""}`);
+    item.type = "button";
+    item.setAttribute("role", "radio");
+    item.setAttribute("aria-checked", String(m === mode));
+    item.dataset.value = m;
+    item.textContent = MODE_LABELS[m];
+    seg.appendChild(item);
+  });
+  bar.appendChild(seg);
+  const input = h("input", "kb-input kb-chunks-search");
+  input.type = "search";
+  input.placeholder = opts.placeholder ?? (mode === "text" ? "\u5168\u6587\u641C\u7D22 chunk\u2026" : "\u8BED\u4E49\u641C\u7D22 chunk\u2026");
+  input.value = opts.query ?? "";
+  input.dataset.kbChunkSearch = "";
+  input.setAttribute("aria-label", "\u641C\u7D22 chunk");
+  bar.appendChild(input);
+  const add = h("button", "kb-btn kb-chunks-add");
+  add.type = "button";
+  add.dataset.kbChunkAdd = "";
+  icon(add, ICON_PLUS);
+  add.appendChild(document.createTextNode("\u65B0\u589E"));
+  bar.appendChild(add);
+  return bar;
+}
+function buildKeywordChip(word) {
+  const chip = h("span", "kb-chip kb-chunk-keyword");
+  chip.appendChild(document.createTextNode(word));
+  const x = h("button", "kb-chunk-keyword-x");
+  x.type = "button";
+  x.dataset.kbChunkKeywordRemove = "";
+  x.setAttribute("aria-label", `\u79FB\u9664\u5173\u952E\u8BCD ${word}`);
+  x.textContent = "\xD7";
+  chip.appendChild(x);
+  return chip;
+}
+function buildChunkRow(chunk, index) {
+  const row = h("div", `kb-chunk${chunk.available ? "" : " is-off"}${chunk.edited ? " is-edited" : ""}`);
+  row.dataset.chunkId = chunk.id;
+  const sw = h("label", "kb-chunk-switch");
+  sw.title = "\u5173\u95ED\u540E\u4E0D\u5220\u9664\uFF0C\u4EC5\u6392\u9664\u51FA\u68C0\u7D22";
+  const cb = document.createElement("input");
+  cb.type = "checkbox";
+  cb.checked = chunk.available;
+  cb.dataset.kbChunkToggle = "";
+  cb.setAttribute("aria-label", `chunk ${index + 1} \u542F\u7528`);
+  sw.appendChild(cb);
+  sw.appendChild(h("i", "kb-chunk-switch-track", "")).appendChild(h("i", "kb-chunk-switch-thumb"));
+  sw.appendChild(h("span", "kb-chunk-switch-label", "\u542F\u7528"));
+  row.appendChild(sw);
+  const main = h("div", "kb-chunk-main");
+  const content = h("div", "kb-chunk-content", chunk.content);
+  content.contentEditable = "true";
+  content.dataset.kbChunkContent = "";
+  content.dataset.original = chunk.content;
+  content.setAttribute("role", "textbox");
+  content.setAttribute("aria-multiline", "true");
+  content.setAttribute("aria-label", `chunk ${index + 1} \u5185\u5BB9`);
+  main.appendChild(content);
+  const kw = h("div", "kb-chunk-keywords");
+  kw.dataset.kbChunkKeywords = "";
+  (chunk.keywords ?? []).forEach((word) => kw.appendChild(buildKeywordChip(word)));
+  const kwInput = h("input", "kb-chunk-keyword-input");
+  kwInput.type = "text";
+  kwInput.placeholder = "+ \u5173\u952E\u8BCD";
+  kwInput.dataset.kbChunkKeywordInput = "";
+  kwInput.setAttribute("aria-label", `chunk ${index + 1} \u65B0\u589E\u5173\u952E\u8BCD`);
+  kw.appendChild(kwInput);
+  main.appendChild(kw);
+  const metaBits = [`#${index + 1}`];
+  if (typeof chunk.page === "number") metaBits.push(`\u7B2C ${chunk.page} \u9875`);
+  if (chunk.edited) metaBits.push("\u5DF2\u7F16\u8F91");
+  main.appendChild(h("div", "kb-chunk-meta kb-meta", metaBits.join(" \xB7 ")));
+  row.appendChild(main);
+  const remove = h("button", "kb-btn kb-chunk-remove");
+  remove.type = "button";
+  remove.dataset.kbChunkRemove = "";
+  remove.textContent = "\u5220\u9664";
+  remove.setAttribute("aria-label", `\u5220\u9664 chunk ${index + 1}`);
+  row.appendChild(remove);
+  return row;
+}
+function renderKbChunks(el, chunks, opts) {
+  if (typeof document === "undefined") return el;
+  const o = opts ?? {};
+  const list = (Array.isArray(chunks) ? chunks : []).map(
+    (c) => normalizeChunk(c)
+  );
+  el.textContent = "";
+  const root = h("div", "kb-chunks");
+  root.dataset.documentId = o.documentId ?? list[0]?.documentId ?? "";
+  root.appendChild(buildSearchBar(o));
+  const listBox = h("div", "kb-chunk-list");
+  if (!list.length) {
+    listBox.appendChild(h("div", "kb-empty", o.emptyText ?? "\u6682\u65E0 chunk"));
+  } else {
+    list.forEach((c, i) => listBox.appendChild(buildChunkRow(c, i)));
+  }
+  root.appendChild(listBox);
+  el.appendChild(root);
+  return el;
+}
+var searchTimers = /* @__PURE__ */ new WeakMap();
+function filterRowsLocally(root, query) {
+  const q = query.trim().toLowerCase();
+  root.querySelectorAll(".kb-chunk[data-chunk-id]").forEach((row) => {
+    if (!q) {
+      row.style.removeProperty("display");
+      return;
+    }
+    const content = row.querySelector("[data-kb-chunk-content]")?.textContent ?? "";
+    const keywords = Array.from(row.querySelectorAll(".kb-chunk-keyword")).map((k) => k.firstChild?.textContent ?? "").join("\n");
+    const hit = `${content}
+${keywords}`.toLowerCase().includes(q);
+    row.style.display = hit ? "" : "none";
+  });
+}
+function currentSearchMode(root) {
+  const active = root.querySelector(".kb-chunks-mode-item.is-active");
+  return active?.dataset.value === "vector" ? "vector" : "text";
+}
+function markEdited(row) {
+  row.classList.add("is-edited");
+  const meta = row.querySelector(".kb-chunk-meta");
+  if (meta && !meta.querySelector(".kb-chunk-edited-flag")) {
+    meta.appendChild(document.createTextNode(" \xB7 "));
+    meta.appendChild(h("span", "kb-chunk-edited-flag", "\u5DF2\u7F16\u8F91"));
+  }
+}
+function emitEdit(row) {
+  markEdited(row);
+  emitIcen(row, "icen:kb-chunk-edit", { chunkId: row.dataset.chunkId ?? "" });
+}
+function initKbChunks(root) {
+  if (typeof document === "undefined") return () => void 0;
+  const scope = root ?? document;
+  const marked = scope;
+  if (marked.__icenKbChunksInit) return () => void 0;
+  marked.__icenKbChunksInit = true;
+  const target = scope;
+  const chunkRootOf = (node) => node.closest(".kb-chunks");
+  const rowOf = (node) => node.closest(".kb-chunk[data-chunk-id]");
+  const onClick = (e) => {
+    const t = e.target instanceof Element ? e.target : null;
+    if (!t) return;
+    const el = t instanceof HTMLElement ? t : null;
+    if (!el) return;
+    const addBtn = el.closest("[data-kb-chunk-add]");
+    if (addBtn) {
+      const wrap = chunkRootOf(addBtn);
+      emitIcen(addBtn, "icen:kb-chunk-add", { documentId: wrap?.dataset.documentId ?? "" });
+      return;
+    }
+    const rmBtn = el.closest("[data-kb-chunk-remove]");
+    if (rmBtn) {
+      const row = rowOf(rmBtn);
+      if (row) emitIcen(row, "icen:kb-chunk-remove", { chunkId: row.dataset.chunkId ?? "" });
+      return;
+    }
+    const kwX = el.closest("[data-kb-chunk-keyword-remove]");
+    if (kwX) {
+      const row = rowOf(kwX);
+      const chip = kwX.closest(".kb-chunk-keyword");
+      if (chip) chip.remove();
+      if (row) emitEdit(row);
+      return;
+    }
+    const modeItem = el.closest(".kb-chunks-mode-item");
+    if (modeItem) {
+      const seg = modeItem.closest(".kb-chunks-mode");
+      if (!seg || modeItem.classList.contains("is-active")) return;
+      seg.querySelectorAll(".kb-chunks-mode-item").forEach((it) => {
+        const on = it === modeItem;
+        it.classList.toggle("is-active", on);
+        it.setAttribute("aria-checked", String(on));
+      });
+      const wrap = chunkRootOf(modeItem);
+      const search = wrap?.querySelector("[data-kb-chunk-search]") ?? null;
+      const mode = currentSearchMode(wrap ?? seg);
+      if (search) search.placeholder = mode === "text" ? "\u5168\u6587\u641C\u7D22 chunk\u2026" : "\u8BED\u4E49\u641C\u7D22 chunk\u2026";
+      if (wrap) {
+        if (mode === "text") filterRowsLocally(wrap, search?.value ?? "");
+        else wrap.querySelectorAll(".kb-chunk[data-chunk-id]").forEach((r) => r.style.removeProperty("display"));
+        emitIcen(wrap, "icen:kb-chunk-search", { mode, query: search?.value ?? "" });
+      }
+    }
+  };
+  const onChange = (e) => {
+    const t = e.target;
+    if (!(t instanceof HTMLInputElement)) return;
+    if (t.hasAttribute("data-kb-chunk-toggle")) {
+      const row = rowOf(t);
+      if (!row) return;
+      row.classList.toggle("is-off", !t.checked);
+      emitIcen(row, "icen:kb-chunk-toggle", { chunkId: row.dataset.chunkId ?? "", available: t.checked });
+    }
+  };
+  const onKeydown = (e) => {
+    const ke = e;
+    if (ke.key !== "Enter") return;
+    const t = ke.target;
+    if (!(t instanceof HTMLInputElement)) return;
+    if (t.hasAttribute("data-kb-chunk-keyword-input")) {
+      ke.preventDefault();
+      const word = t.value.trim();
+      const row = rowOf(t);
+      if (!word || !row) return;
+      const kw = t.closest("[data-kb-chunk-keywords]");
+      if (kw) kw.insertBefore(buildKeywordChip(word), t);
+      t.value = "";
+      emitEdit(row);
+    }
+  };
+  const onFocusOut = (e) => {
+    const t = e.target;
+    if (!(t instanceof HTMLElement)) return;
+    if (!t.hasAttribute("data-kb-chunk-content")) return;
+    const row = rowOf(t);
+    if (!row) return;
+    const next = t.textContent ?? "";
+    if (next === (t.dataset.original ?? "")) return;
+    t.dataset.original = next;
+    emitEdit(row);
+  };
+  const onInput = (e) => {
+    const t = e.target;
+    if (!(t instanceof HTMLInputElement) || !t.hasAttribute("data-kb-chunk-search")) return;
+    const wrap = chunkRootOf(t);
+    if (!wrap) return;
+    const prev = searchTimers.get(t);
+    if (prev) clearTimeout(prev);
+    const timer = setTimeout(() => {
+      searchTimers.delete(t);
+      const mode = currentSearchMode(wrap);
+      if (mode === "text") filterRowsLocally(wrap, t.value);
+      emitIcen(wrap, "icen:kb-chunk-search", { mode, query: t.value });
+    }, 200);
+    searchTimers.set(t, timer);
+  };
+  target.addEventListener("click", onClick);
+  target.addEventListener("change", onChange);
+  target.addEventListener("keydown", onKeydown);
+  target.addEventListener("focusout", onFocusOut);
+  target.addEventListener("input", onInput);
+  return () => {
+    target.removeEventListener("click", onClick);
+    target.removeEventListener("change", onChange);
+    target.removeEventListener("keydown", onKeydown);
+    target.removeEventListener("focusout", onFocusOut);
+    target.removeEventListener("input", onInput);
+    marked.__icenKbChunksInit = false;
+  };
+}
+export {
+  initKbChunks,
+  renderKbChunks
+};

package/dist/behaviors/kb-citation.d.mts

@@ -0,0 +1,38 @@
+import { KbCitation } from './kb-core.js';
+import './ai-core.js';
+
+/** 来源新鲜度阈值：date 距今超过 90 天视为 stale（来源列表/引用卡/冲突组共用） */
+declare const KB_STALE_DAYS = 90;
+/** 受限权限徽标的锁形线性图标（24 viewBox，stroke 1.5，经 svgIcon 消毒后插入） */
+declare const KB_ICON_LOCK: string;
+/** 判断引用是否过期（date 缺失或不可解析时返回 false —— 无证据不告警的诚实纪律） */
+declare function isKbCitationStale(citation: KbCitation, now?: Date): boolean;
+/** 取来源 URL 的域名（无 URL / 非法 URL 返回空串；引用卡与来源列表共用） */
+declare function kbDomainOf(url: string | undefined): string;
+/** 覆盖来源注册表（renderCitationText 传 sources 时自动调用；宿主也可手动喂数据） */
+declare function setKbCitationSources(sources: KbCitation[]): void;
+/** 读取来源注册表当前快照（调试 / 测试 / 二次渲染用） */
+declare function getKbCitationSources(): KbCitation[];
+/** 造一枚行内引用角标 `<button class="kb-citation" data-cite="{n}">`（有效性由渲染端对照来源数降级）；SSR 无元素可造，返回 null */
+declare function renderCitationMark(n: number): HTMLButtonElement | null;
+/**
+ * 把含 [3] 的文本渲染成「文本节点 + 角标」混合流（流式安全：增量文本整体重渲该 el）。
+ * sources 提供时写入来源注册表（hover 卡数据源）并对超界编号渲染 .is-dead。
+ */
+declare function renderCitationText(el: HTMLElement, text: string, sources?: KbCitation[]): HTMLElement;
+/** initKbCitation 的配置项：来源表 / hover 卡数据源 / 浮卡防抖时长 */
+interface KbCitationInitOptions {
+    /** 来源表（按编号解析角标；提供后超界编号在渲染端落 .is-dead） */
+    sources?: KbCitation[];
+    /** hover 卡数据源：入参为注册表查得（或合成）的 citation，返回增强数据；返回 null/undefined 落回注册表结果 */
+    getCard?: (citation: KbCitation) => KbCitation | null | undefined;
+    /** hover 浮卡防抖（默认 300ms） */
+    hoverDelay?: number;
+}
+/**
+ * 初始化引用角标交互（root 级委托；幂等 WeakSet 标记，返回销毁函数，销毁后可重新 init）。
+ * click → icen:kb-citation-open { citation }；hover ≥300ms 且有数据 → openPopover 浮引用卡。
+ */
+declare function initKbCitation(root?: ParentNode, opts?: KbCitationInitOptions): () => void;
+
+export { KB_ICON_LOCK, KB_STALE_DAYS, type KbCitationInitOptions, getKbCitationSources, initKbCitation, isKbCitationStale, kbDomainOf, renderCitationMark, renderCitationText, setKbCitationSources };