@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/kb-visibility.mjs

@@ -0,0 +1,403 @@
+// 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/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 normalizeIdentity(raw) {
+  const r = raw;
+  return {
+    user: String(r.user ?? ""),
+    groups: Array.isArray(r.groups) ? r.groups.map(String) : [],
+    label: typeof r.label === "string" ? r.label : void 0,
+    note: typeof r.note === "string" ? r.note : void 0
+  };
+}
+function formatCount(n) {
+  if (n == null || !Number.isFinite(n)) return "\u2014";
+  if (Math.abs(n) >= 1e4) return `${(n / 1e3).toFixed(1)}k`;
+  return n.toLocaleString("en-US");
+}
+
+// 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-citation.ts
+var KB_ICON_LOCK = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="11" x="3" y="11" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>';
+
+// src/behaviors/kb-visibility.ts
+var LAYER_ORDER = ["pre", "post", "none"];
+var LAYER_LABEL = { pre: "pre \u2713", post: "post \u26A0", none: "none \u2715" };
+var LAYER_TITLE = {
+  pre: "pre-filter\uFF1AACL \u5728\u68C0\u7D22\u6267\u884C\u4F53\u5185\u751F\u6548\u2014\u2014\u5B89\u5168\u57FA\u7EBF",
+  post: "post-filter\uFF1A\u5206\u6570\u5DF2\u53EF\u89C2\u5BDF\u2014\u2014\u7F3A\u9677\u5C42\uFF0C\u4EC5\u6F14\u793A",
+  none: "none\uFF1Afail-open\uFF0C\u65E0\u8EAB\u4EFD\u8FC7\u6EE4\u8FD4\u56DE\u5168\u90E8\u2014\u2014\u5371\u9669\uFF0C\u4EC5\u6F14\u793A"
+};
+var LESSON_ITEMS = [
+  "fail-open\uFF1AKendra \u65E0\u8EAB\u4EFD\u4E0A\u4E0B\u6587\u8FD4\u56DE\u5168\u90E8\u6587\u6863\u2014\u2014\u68C0\u7D22\u5FC5\u987B\u643A\u5E26\u670D\u52A1\u7AEF\u8EAB\u4EFD",
+  "post-filter\uFF1AtopK \u88AB\u65E0\u6743\u7ED3\u679C\u5360\u7528\u4E14\u76F8\u4F3C\u5EA6\u5206\u6570\u53EF\u88AB\u89C2\u5BDF",
+  "\u8BA1\u6570\u5DEE\u5F02\u5373 volume leakage\uFF1A\u5BF9\u666E\u901A\u7528\u6237\u53EA\u53EF\u7ED9\u300C\u5DF2\u6309\u6743\u9650\u8FC7\u6EE4\u300D\u6052\u5B9A\u6587\u6848\uFF0C\u7F13\u89E3\u53EA\u6709 padding \u53D6\u6574"
+];
+var STUB_HANDLE = {
+  setFilterLayer: () => {
+  },
+  getVisibility: () => "full",
+  destroy: () => {
+  }
+};
+function normalizeHit(raw) {
+  const r = raw;
+  return {
+    id: String(r.id ?? ""),
+    title: String(r.title ?? "\u672A\u547D\u540D\u547D\u4E2D"),
+    snippet: typeof r.snippet === "string" ? r.snippet : void 0,
+    summary: typeof r.summary === "string" ? r.summary : void 0,
+    documentId: typeof r.documentId === "string" ? r.documentId : void 0
+  };
+}
+function renderKbVisibility(el, opts) {
+  if (typeof document === "undefined" || !el) return STUB_HANDLE;
+  const marked = el;
+  marked.__icenKbVisibility?.destroy();
+  const ctrl = new AbortController();
+  const listen = (target, type, fn) => {
+    target.addEventListener(type, fn, { signal: ctrl.signal });
+  };
+  const identities = (Array.isArray(opts.identities) ? opts.identities : []).map(normalizeIdentity);
+  const hits = (Array.isArray(opts.hits) ? opts.hits : []).map(normalizeHit).filter((hit) => hit.id);
+  const evalHit = typeof opts.evaluateHit === "function" ? opts.evaluateHit : () => "full";
+  let layer = opts.layer === "post" || opts.layer === "none" ? opts.layer : "pre";
+  let focusedUser = null;
+  let destroyed = false;
+  el.textContent = "";
+  el.classList.add("kb-visibility");
+  el.appendChild(
+    h("div", "kb-visibility-warn", "admin \u5BA1\u8BA1\u89C6\u56FE\u2014\u2014\u547D\u4E2D\u5DEE\u5F02\u5BF9\u7167\u5BF9\u666E\u901A\u7528\u6237\u6784\u6210\u6CC4\u9732\uFF0C\u52FF\u5D4C\u5165\u7EC8\u7AEF\u7528\u6237\u754C\u9762")
+  );
+  const bar = h("div", "kb-visibility-bar");
+  const chipMap = /* @__PURE__ */ new Map();
+  for (const identity of identities) {
+    const chip = h("button", "kb-chip kb-visibility-idn", identity.label ?? identity.user);
+    chip.type = "button";
+    chip.dataset.identityUser = identity.user;
+    chip.setAttribute("aria-pressed", "false");
+    chip.setAttribute("aria-label", `\u805A\u7126\u8EAB\u4EFD ${identity.label ?? identity.user} \u7684\u5217`);
+    bar.appendChild(chip);
+    chipMap.set(identity.user, chip);
+  }
+  bar.appendChild(h("span", "kb-meta", `\u67E5\u8BE2\uFF1A${opts.query || "\u2014"}`));
+  const layerChip = h("button", "kb-chip kb-layer-chip");
+  layerChip.type = "button";
+  bar.appendChild(layerChip);
+  function paintLayer() {
+    layerChip.dataset.layer = layer;
+    layerChip.textContent = LAYER_LABEL[layer];
+    layerChip.title = LAYER_TITLE[layer];
+    layerChip.setAttribute("aria-label", `\u8FC7\u6EE4\u5C42\uFF1A${LAYER_TITLE[layer]}`);
+  }
+  paintLayer();
+  el.appendChild(bar);
+  const grid = h("div", "kb-visibility-grid");
+  const colMap = /* @__PURE__ */ new Map();
+  function buildHitRow(hit, identity) {
+    const visibility = evalHit(hit, identity);
+    if (visibility === "hidden") return null;
+    const row = h("div", "kb-visibility-hit");
+    row.dataset.visibility = visibility;
+    row.dataset.hitId = hit.id;
+    const titleRow = h("div", "kb-visibility-hit-title");
+    if (visibility === "metadata" || visibility === "restricted") {
+      const lock = svgIcon(KB_ICON_LOCK);
+      if (lock) titleRow.appendChild(lock);
+    }
+    titleRow.appendChild(h("span", "kb-visibility-hit-title-text", hit.title));
+    row.appendChild(titleRow);
+    if (visibility === "full") {
+      if (hit.snippet) row.appendChild(h("div", "kb-visibility-snippet kb-meta", hit.snippet));
+    } else if (visibility === "summary") {
+      if (hit.summary) row.appendChild(h("div", "kb-visibility-summary", hit.summary));
+      const origOff = h("button", "kb-visibility-origoff", "\u539F\u6587\u4E0D\u53EF\u7528");
+      origOff.type = "button";
+      origOff.disabled = true;
+      origOff.setAttribute("aria-disabled", "true");
+      row.appendChild(origOff);
+    } else {
+      row.appendChild(h("div", "kb-visibility-snippet"));
+      if (visibility === "restricted") {
+        const request = h("button", "kb-visibility-request", "\u7533\u8BF7\u8BBF\u95EE");
+        request.type = "button";
+        request.setAttribute("aria-label", `\u7533\u8BF7\u8BBF\u95EE ${hit.title}`);
+        row.appendChild(request);
+      }
+    }
+    return row;
+  }
+  for (const identity of identities) {
+    const col = h("div", "kb-visibility-col");
+    col.dataset.identityUser = identity.user;
+    const head = h("header");
+    head.appendChild(h("span", "kb-visibility-idn-label", identity.label ?? identity.user));
+    if (identity.note) head.appendChild(h("span", "kb-meta", identity.note));
+    col.appendChild(head);
+    let safeCount = 0;
+    const hitsBox = h("div", "kb-visibility-hits");
+    for (const hit of hits) {
+      const row = buildHitRow(hit, identity);
+      if (row) {
+        hitsBox.appendChild(row);
+        safeCount++;
+      }
+    }
+    col.appendChild(h("div", "kb-visibility-count kb-num", `\u5B89\u5168\u8BA1\u6570 ${formatCount(safeCount)}`));
+    col.appendChild(hitsBox);
+    grid.appendChild(col);
+    colMap.set(identity.user, col);
+  }
+  el.appendChild(grid);
+  const lesson = h("div", "kb-visibility-lesson");
+  const lessonList = h("ul");
+  for (const item of LESSON_ITEMS) lessonList.appendChild(h("li", void 0, item));
+  lesson.appendChild(lessonList);
+  lesson.appendChild(h("div", "kb-meta kb-visibility-lesson-note", "\u4EE5\u4E0A\u5BF9\u7167\u4EC5\u9650 admin \u5BA1\u8BA1"));
+  el.appendChild(lesson);
+  function applyLayer(next) {
+    if (destroyed || next === layer) return;
+    layer = next;
+    paintLayer();
+    emitIcen(el, "icen:kb-visibility-layer", { layer });
+  }
+  function setFocus(user) {
+    focusedUser = user;
+    for (const [u, col] of colMap) col.classList.toggle("is-focused", u === user);
+    for (const [u, chip] of chipMap) chip.setAttribute("aria-pressed", u === user ? "true" : "false");
+  }
+  listen(bar, "click", (ev) => {
+    const target = ev.target instanceof Element ? ev.target : null;
+    const chip = target?.closest(".kb-visibility-idn");
+    if (chip) {
+      const user = chip.dataset.identityUser ?? "";
+      setFocus(focusedUser === user ? null : user);
+      const identity = identities.find((i) => i.user === user);
+      if (identity) emitIcen(el, "icen:kb-visibility-identity", { identity });
+      return;
+    }
+    const layerBtn = target?.closest(".kb-layer-chip");
+    if (layerBtn) {
+      const idx = LAYER_ORDER.indexOf(layer);
+      applyLayer(LAYER_ORDER[(idx + 1) % LAYER_ORDER.length]);
+    }
+  });
+  listen(grid, "click", (ev) => {
+    const target = ev.target instanceof Element ? ev.target : null;
+    const btn = target?.closest(".kb-visibility-request");
+    if (!btn) return;
+    const row = btn.closest(".kb-visibility-hit");
+    const col = btn.closest(".kb-visibility-col");
+    if (!row || !col) return;
+    const hit = hits.find((x) => x.id === (row.dataset.hitId ?? ""));
+    const identity = identities.find((i) => i.user === (col.dataset.identityUser ?? ""));
+    if (hit && identity) opts.onRequest?.(hit, identity);
+  });
+  const handle = {
+    setFilterLayer(l) {
+      applyLayer(l === "post" || l === "none" ? l : "pre");
+    },
+    getVisibility(identityUser, hitId) {
+      const identity = identities.find((i) => i.user === identityUser);
+      const hit = hits.find((x) => x.id === hitId);
+      if (!identity || !hit) return "hidden";
+      return evalHit(hit, identity);
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      ctrl.abort();
+      el.classList.remove("kb-visibility");
+      el.textContent = "";
+      delete marked.__icenKbVisibility;
+    }
+  };
+  marked.__icenKbVisibility = handle;
+  return handle;
+}
+export {
+  renderKbVisibility
+};

package/dist/behaviors/kb-who-can.d.mts

@@ -0,0 +1,32 @@
+import { KbAclDecision, KbIdentity, KbAclEntry } from './kb-core.js';
+import './ai-core.js';
+
+/** renderKbWhoCan 配置项 */
+interface KbWhoCanOpts {
+    /** 固定身份集（服务端验证 token 下发；select 选项即此集合，无自由输入） */
+    identities: KbIdentity[];
+    /** 被检查的 ACL 条目集（直接 + 继承 + 链接混排，via 由条目形态推导） */
+    entries: KbAclEntry[];
+    /** 求值函数（缺省 = kb-core evaluateAcl：先 deny → 并集 → 默认拒绝） */
+    evaluate?: (identity: KbIdentity, entries: KbAclEntry[]) => KbAclDecision;
+    /** 每次重算回调（与 icen:kb-whocan-check 双通道） */
+    onCheck?: (identity: KbIdentity, decision: KbAclDecision) => void;
+}
+/** renderKbWhoCan 返回的可操作句柄 */
+interface KbWhoCanHandle {
+    /** 切换检查身份并重算（固定身份集纪律：集合外 id 一律忽略） */
+    setIdentity(id: string): void;
+    /** 最近一次决策（未重算过/空身份集/SSR → null） */
+    getResult(): KbAclDecision | null;
+    /** 销毁：摘监听、清空装配内容、复位幂等标记 */
+    destroy(): void;
+}
+/**
+ * 装配有效权限检查器（view-as）：固定身份集下拉 + 检查钮 + 结论区（verdict /
+ * deny 置顶红条 / 扁平原因链 / 叠加规则行 / 最近到期 meta）。每次重算派
+ * icen:kb-whocan-check { identity, decision }（onCheck 双通道）。
+ * 同元素重复 render 幂等（先拆旧装配）；SSR 返回静态句柄。
+ */
+declare function renderKbWhoCan(el: HTMLElement, opts: KbWhoCanOpts): KbWhoCanHandle;
+
+export { type KbWhoCanHandle, type KbWhoCanOpts, renderKbWhoCan };