@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/kb-metadata.mjs

@@ -0,0 +1,326 @@
+// 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/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));
+
+// 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-metadata.ts
+var TYPES = ["string", "number", "time"];
+function buildRow(field, value) {
+  const row = h("tr", `kb-metadata-row${field.builtin ? " is-builtin" : ""}`);
+  row.dataset.key = field.key;
+  const keyTd = h("td", "kb-metadata-key");
+  keyTd.textContent = field.key;
+  if (field.label && field.label !== field.key) {
+    keyTd.appendChild(document.createTextNode(" "));
+    keyTd.appendChild(h("span", "kb-metadata-key-label", field.label));
+  }
+  if (field.builtin) keyTd.appendChild(h("span", "kb-metadata-builtin-flag", "\u5185\u7F6E"));
+  row.appendChild(keyTd);
+  const typeTd = h("td");
+  typeTd.appendChild(h("span", `kb-badge kb-metadata-type is-${field.type}`, field.type));
+  row.appendChild(typeTd);
+  const valueTd = h("td", "kb-metadata-value");
+  if (field.builtin) {
+    valueTd.appendChild(h("span", "kb-metadata-readonly", value != null ? String(value) : "\u2014"));
+  } else {
+    const input = h("input", "kb-input kb-metadata-bind");
+    input.type = field.type === "number" ? "number" : "text";
+    input.value = value != null ? String(value) : "";
+    input.dataset.kbMetadataBind = "";
+    input.setAttribute("aria-label", `${field.key} \u7684\u503C`);
+    valueTd.appendChild(input);
+  }
+  row.appendChild(valueTd);
+  const opsTd = h("td", "kb-metadata-ops");
+  if (!field.builtin) {
+    const rm = h("button", "kb-btn");
+    rm.type = "button";
+    rm.dataset.kbMetadataRemove = "";
+    rm.textContent = "\u79FB\u9664";
+    rm.setAttribute("aria-label", `\u79FB\u9664\u5B57\u6BB5 ${field.key}`);
+    opsTd.appendChild(rm);
+  }
+  row.appendChild(opsTd);
+  return row;
+}
+function buildNewRow() {
+  const bar = h("div", "kb-metadata-new");
+  const keyInput = h("input", "kb-input kb-input--mono kb-metadata-new-key");
+  keyInput.type = "text";
+  keyInput.placeholder = "\u5B57\u6BB5\u540D\uFF0C\u5982 department";
+  keyInput.dataset.kbMetadataNewKey = "";
+  keyInput.setAttribute("aria-label", "\u65B0\u5B57\u6BB5\u540D");
+  bar.appendChild(keyInput);
+  const pick = h("div", "kb-seg kb-metadata-type-pick");
+  pick.setAttribute("role", "radiogroup");
+  pick.setAttribute("aria-label", "\u65B0\u5B57\u6BB5\u7C7B\u578B");
+  TYPES.forEach((t, i) => {
+    const item = h("button", `kb-seg-item kb-metadata-type-item${i === 0 ? " is-active" : ""}`);
+    item.type = "button";
+    item.setAttribute("role", "radio");
+    item.setAttribute("aria-checked", String(i === 0));
+    item.dataset.value = t;
+    item.textContent = t;
+    pick.appendChild(item);
+  });
+  bar.appendChild(pick);
+  const define = h("button", "kb-btn");
+  define.type = "button";
+  define.dataset.kbMetadataDefine = "";
+  define.textContent = "\u65B0\u589E\u5B57\u6BB5";
+  bar.appendChild(define);
+  return bar;
+}
+function renderKbMetadata(el, model) {
+  if (typeof document === "undefined") return el;
+  const fields = Array.isArray(model?.fields) ? model.fields : [];
+  const values = model?.values ?? {};
+  el.textContent = "";
+  const root = h("div", "kb-metadata");
+  const table = document.createElement("table");
+  table.className = "kb-metadata-table";
+  const thead = document.createElement("thead");
+  const headRow = document.createElement("tr");
+  ["\u5B57\u6BB5", "\u7C7B\u578B", "\u503C", ""].forEach((label) => headRow.appendChild(h("th", "kb-metadata-th", label)));
+  thead.appendChild(headRow);
+  table.appendChild(thead);
+  const tbody = document.createElement("tbody");
+  if (!fields.length) {
+    const emptyRow = h("tr", "kb-metadata-empty-row");
+    const td = h("td", "kb-metadata-empty", "\u6682\u65E0\u5143\u6570\u636E\u5B57\u6BB5");
+    td.colSpan = 4;
+    emptyRow.appendChild(td);
+    tbody.appendChild(emptyRow);
+  } else {
+    fields.forEach((f) => tbody.appendChild(buildRow(f, values[f.key])));
+  }
+  table.appendChild(tbody);
+  root.appendChild(table);
+  root.appendChild(buildNewRow());
+  el.appendChild(root);
+  return el;
+}
+function appendDefinedRow(root, key, type) {
+  const tbody = root.querySelector("tbody");
+  if (!tbody) return;
+  const empty = tbody.querySelector(".kb-metadata-empty-row");
+  if (empty) empty.remove();
+  tbody.appendChild(buildRow({ key, type }, ""));
+}
+function initKbMetadata(root) {
+  if (typeof document === "undefined") return () => void 0;
+  const scope = root ?? document;
+  const marked = scope;
+  if (marked.__icenKbMetadataInit) return () => void 0;
+  marked.__icenKbMetadataInit = true;
+  const target = scope;
+  const onClick = (e) => {
+    const t = e.target instanceof Element ? e.target : null;
+    if (!t) return;
+    const rm = t.closest("[data-kb-metadata-remove]");
+    if (rm) {
+      const row = rm.closest(".kb-metadata-row[data-key]");
+      if (!row) return;
+      const key = row.dataset.key ?? "";
+      emitIcen(row, "icen:kb-metadata-change", { action: "remove", key });
+      row.remove();
+      return;
+    }
+    const define = t.closest("[data-kb-metadata-define]");
+    if (define) {
+      const root2 = define.closest(".kb-metadata");
+      const keyInput = root2?.querySelector("[data-kb-metadata-new-key]");
+      if (!root2 || !keyInput) return;
+      const key = keyInput.value.trim();
+      if (!key) {
+        keyInput.setAttribute("aria-invalid", "true");
+        return;
+      }
+      keyInput.removeAttribute("aria-invalid");
+      const active = root2.querySelector(".kb-metadata-type-item.is-active");
+      const type = TYPES.includes(active?.dataset.value ?? "") ? active?.dataset.value : "string";
+      appendDefinedRow(root2, key, type);
+      keyInput.value = "";
+      emitIcen(root2, "icen:kb-metadata-change", { action: "define", key });
+      return;
+    }
+    const typeItem = t.closest(".kb-metadata-type-item");
+    if (typeItem) {
+      const seg = typeItem.closest(".kb-metadata-type-pick");
+      if (!seg || typeItem.classList.contains("is-active")) return;
+      seg.querySelectorAll(".kb-metadata-type-item").forEach((it) => {
+        const on = it === typeItem;
+        it.classList.toggle("is-active", on);
+        it.setAttribute("aria-checked", String(on));
+      });
+    }
+  };
+  const onChange = (e) => {
+    const t = e.target;
+    if (!(t instanceof HTMLInputElement) || !t.hasAttribute("data-kb-metadata-bind")) return;
+    const row = t.closest(".kb-metadata-row[data-key]");
+    if (row) emitIcen(row, "icen:kb-metadata-change", { action: "bind", key: row.dataset.key ?? "" });
+  };
+  target.addEventListener("click", onClick);
+  target.addEventListener("change", onChange);
+  return () => {
+    target.removeEventListener("click", onClick);
+    target.removeEventListener("change", onChange);
+    marked.__icenKbMetadataInit = false;
+  };
+}
+export {
+  initKbMetadata,
+  renderKbMetadata
+};

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

@@ -0,0 +1,41 @@
+import { KbLocation, KbCitation } from './kb-core.js';
+import './ai-core.js';
+
+/** getDocument 的返回契约：原文 + 定位 + 上下文（受限来源可只给 content 空串并依赖 citedText 回落） */
+interface KbPassageDoc {
+    content: string;
+    loc?: KbLocation;
+    contextBefore?: string;
+    contextAfter?: string;
+}
+/** createKbPassage 的配置项：原文取数 / 跳转锚定容器 / 开合回调 */
+interface KbPassageOptions {
+    /** 原文取数（同步返回或 Promise；未提供 / 落空时回落 citation.citedText → snippet） */
+    getDocument?: (citation: KbCitation) => KbPassageDoc | null | undefined | Promise<KbPassageDoc | null | undefined>;
+    /** 跳转锚定容器（元素或惰性取值函数；提供后 open 时滚动定位 [data-kb-loc]） */
+    anchor?: HTMLElement | (() => HTMLElement | null | undefined);
+    /** 打开回调（与 icen:kb-passage-jump 事件双通道） */
+    onJump?: (citation: KbCitation) => void;
+    /** 关闭回调（与 icen:kb-passage-close 事件双通道） */
+    onClose?: () => void;
+}
+/** kb-passage 句柄：open/close/highlight/expand/destroy（函数名冻结，规格 §5.3） */
+interface KbPassageHandle {
+    /** 打开抽屉并渲染某条引用的原文定位 */
+    open(citation: KbCitation): void;
+    /** 关闭抽屉（派 icen:kb-passage-close，焦点还原） */
+    close(): void;
+    /** 高亮正文命中词（多词轮转 data-hit 0/1/2 分色） */
+    highlight(terms: string | string[]): void;
+    /** 展开上下文（当前仅一层；delta 预留） */
+    expand(delta?: number): void;
+    /** 销毁：解绑监听、静默关闭、清空挂载容器 */
+    destroy(): void;
+}
+/**
+ * 创建原文定位抽屉（挂载容器 el 内搭骨架，返回句柄）。
+ * 句柄方法对无效状态（未打开 / 已销毁）安全 no-op。
+ */
+declare function createKbPassage(el: HTMLElement, opts?: KbPassageOptions): KbPassageHandle;
+
+export { type KbPassageDoc, type KbPassageHandle, type KbPassageOptions, createKbPassage };