@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/events.mjs

@@ -0,0 +1,208 @@
+// src/behaviors/events.ts
+function onIcen(type, a, b, c) {
+  if (typeof document === "undefined") return () => {
+  };
+  const selector = typeof a === "string" ? a : null;
+  const handler = selector ? b : a;
+  const opts = selector ? c : b;
+  const within = opts?.within ?? document;
+  const once = opts?.once === true;
+  let off = () => {
+  };
+  const fn = (e) => {
+    const broadcast = !(e.target instanceof Element);
+    if (selector) {
+      if (broadcast) return;
+      const detail = e.detail;
+      const src = detail?.source instanceof Element ? detail.source : e.target;
+      if (!(src instanceof Element) || !src.closest(selector)) return;
+    }
+    handler(e);
+    if (once) off();
+  };
+  within.addEventListener(type, fn);
+  off = () => {
+    within.removeEventListener(type, fn);
+    opts?.signal?.removeEventListener("abort", off);
+  };
+  if (opts?.signal) {
+    if (opts.signal.aborted) {
+      off();
+      return () => {
+      };
+    }
+    opts.signal.addEventListener("abort", off, { once: true });
+  }
+  return off;
+}
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+var policies = /* @__PURE__ */ new Map();
+function setEventPolicy(type, policy) {
+  if (policy) policies.set(type, policy);
+  else policies.delete(type);
+}
+function getEventPolicy(type) {
+  return policies.get(type);
+}
+function resetEventPolicies() {
+  policies.clear();
+}
+var LONGPRESS_MS = 520;
+var LONGPRESS_MOVE = 12;
+var CLICK_DELAY = 220;
+var CLICK_DRAG_TOLERANCE = 5;
+function gestureHost(e, name) {
+  const t = e.target;
+  if (!(t instanceof Element)) return null;
+  return t.closest(`[data-gestures~="${name}"]`);
+}
+function pointOf(e) {
+  return e instanceof MouseEvent || typeof PointerEvent !== "undefined" && e instanceof PointerEvent ? { x: e.clientX, y: e.clientY } : { x: 0, y: 0 };
+}
+function emit(host, type, originalEvent, text) {
+  const { x, y } = pointOf(originalEvent);
+  const detail = { source: host, originalEvent, x, y };
+  if (text != null) detail.text = text;
+  const ev = new CustomEvent(type, {
+    detail,
+    bubbles: true,
+    composed: true,
+    cancelable: true
+  });
+  const delivered = host.dispatchEvent(ev);
+  if (delivered) policies.get(type)?.(ev);
+  return ev;
+}
+var gesturesInit = false;
+var gesturesTeardown = null;
+function initGestures() {
+  if (gesturesInit || typeof document === "undefined") return () => {
+  };
+  gesturesInit = true;
+  let clickTimer = null;
+  let pending = null;
+  let downPos = null;
+  let suppressTrailingClick = false;
+  const cancelPendingClick = () => {
+    if (clickTimer) clearTimeout(clickTimer);
+    clickTimer = null;
+    pending = null;
+  };
+  const onDownPos = (e) => {
+    downPos = { x: e.clientX, y: e.clientY };
+    suppressTrailingClick = false;
+  };
+  const isDragRelease = (e) => downPos != null && Math.hypot(e.clientX - downPos.x, e.clientY - downPos.y) > CLICK_DRAG_TOLERANCE;
+  const onClick = (e) => {
+    const host = gestureHost(e, "click");
+    if (!host) return;
+    if (suppressTrailingClick) {
+      suppressTrailingClick = false;
+      return;
+    }
+    if (isDragRelease(e)) return;
+    if (host.matches('[data-gestures~="dblclick"]')) {
+      if (clickTimer) clearTimeout(clickTimer);
+      pending = { host, e };
+      clickTimer = setTimeout(() => {
+        clickTimer = null;
+        const p = pending;
+        pending = null;
+        if (p) emit(p.host, "icen:click", p.e);
+      }, CLICK_DELAY);
+    } else {
+      emit(host, "icen:click", e);
+    }
+  };
+  const onDblClick = (e) => {
+    const host = gestureHost(e, "dblclick");
+    if (!host) return;
+    cancelPendingClick();
+    if (isDragRelease(e)) return;
+    emit(host, "icen:dblclick", e);
+  };
+  const onContextMenu = (e) => {
+    const host = gestureHost(e, "contextmenu");
+    if (!host) return;
+    const hasPolicy = policies.has("icen:contextmenu");
+    const ev = emit(host, "icen:contextmenu", e);
+    if (ev.defaultPrevented || hasPolicy) e.preventDefault();
+  };
+  let lp = null;
+  const clearLp = () => {
+    if (lp) clearTimeout(lp.timer);
+    lp = null;
+  };
+  const onLpDown = (e) => {
+    const host = gestureHost(e, "longpress");
+    if (!host) return;
+    clearLp();
+    lp = {
+      host,
+      e,
+      x: e.clientX,
+      y: e.clientY,
+      timer: setTimeout(() => {
+        const cur = lp;
+        lp = null;
+        if (cur) {
+          suppressTrailingClick = true;
+          emit(cur.host, "icen:longpress", cur.e);
+        }
+      }, LONGPRESS_MS)
+    };
+  };
+  const onLpMove = (e) => {
+    if (!lp) return;
+    if (Math.hypot(e.clientX - lp.x, e.clientY - lp.y) > LONGPRESS_MOVE) clearLp();
+  };
+  const onTextSelect = (e) => {
+    const host = gestureHost(e, "text-select");
+    if (!host) return;
+    const sel = window.getSelection();
+    const text = sel?.toString() ?? "";
+    if (!text.trim() || !sel || !host.contains(sel.anchorNode)) return;
+    emit(host, "icen:text-select", e, text);
+  };
+  document.addEventListener("pointerdown", onDownPos);
+  document.addEventListener("click", onClick);
+  document.addEventListener("dblclick", onDblClick);
+  document.addEventListener("contextmenu", onContextMenu);
+  document.addEventListener("pointerdown", onLpDown);
+  document.addEventListener("pointermove", onLpMove);
+  document.addEventListener("pointerup", clearLp);
+  document.addEventListener("pointercancel", clearLp);
+  document.addEventListener("mouseup", onTextSelect);
+  gesturesTeardown = () => {
+    document.removeEventListener("pointerdown", onDownPos);
+    document.removeEventListener("click", onClick);
+    document.removeEventListener("dblclick", onDblClick);
+    document.removeEventListener("contextmenu", onContextMenu);
+    document.removeEventListener("pointerdown", onLpDown);
+    document.removeEventListener("pointermove", onLpMove);
+    document.removeEventListener("pointerup", clearLp);
+    document.removeEventListener("pointercancel", clearLp);
+    document.removeEventListener("mouseup", onTextSelect);
+    cancelPendingClick();
+    clearLp();
+    gesturesInit = false;
+    gesturesTeardown = null;
+  };
+  return gesturesTeardown;
+}
+function destroyGestures() {
+  gesturesTeardown?.();
+}
+export {
+  destroyGestures,
+  emitIcen,
+  getEventPolicy,
+  initGestures,
+  onIcen,
+  resetEventPolicies,
+  setEventPolicy
+};

package/dist/behaviors/input.mjs

@@ -1,12 +1,20 @@
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/input.ts
-var isComposing = false;
-if (typeof document !== "undefined") {
-  document.addEventListener("compositionstart", () => {
-    isComposing = true;
+function trackComposing(target) {
+  let composing = false;
+  target.addEventListener("compositionstart", () => {
+    composing = true;
   });
-  document.addEventListener("compositionend", () => {
-    isComposing = false;
+  target.addEventListener("compositionend", () => {
+    composing = false;
   });
+  return () => composing;
 }
 function setupClear(wrap) {
   const btn = wrap.querySelector(".input-clear");
@@ -58,7 +66,6 @@ function setupCounter(field) {
   const maxAttr = field.getAttribute("maxlength");
   const dataCount = field.getAttribute("data-count");
   if (!maxAttr && dataCount === null) return;
-  el.__icenCounterInit = true;
   const max = maxAttr ? Number(maxAttr) : 0;
   let counter = null;
   const wrap = field.closest(".input-wrap, .textarea-wrap");
@@ -75,6 +82,8 @@ function setupCounter(field) {
   }
   const counterEl = counter;
   if (!counterEl) return;
+  el.__icenCounterInit = true;
+  const isComposing = trackComposing(field);
   function update() {
     const len = field.value.length;
     counterEl.textContent = max > 0 ? `${len} / ${max}` : `${len}`;
@@ -85,8 +94,9 @@ function setupCounter(field) {
       else if (ratio >= 0.8) counterEl.classList.add("is-warn");
     }
   }
+  ;
   field.addEventListener("input", () => {
-    if (!isComposing) update();
+    if (!isComposing()) update();
   });
   update();
 }
@@ -96,6 +106,7 @@ function setupMask(field) {
   const mask = field.getAttribute("data-mask");
   if (!mask) return;
   el.__icenMaskInit = true;
+  const isComposing = trackComposing(field);
   const maskChars = [];
   for (const ch of mask) maskChars.push(ch);
   function isInputSlot(ch) {
@@ -137,7 +148,7 @@ function setupMask(field) {
   field.value = lastFormatted;
   field.setAttribute("data-raw-value", extractRaw(lastFormatted));
   field.addEventListener("input", () => {
-    if (isComposing) return;
+    if (isComposing()) return;
     const cursorPos = field.selectionStart ?? 0;
     const oldRaw = extractRaw(lastFormatted);
     const newFull = field.value;
@@ -165,7 +176,7 @@ function setupMask(field) {
     field.setSelectionRange(targetCursor, targetCursor);
   });
   field.addEventListener("keydown", (ev) => {
-    if (isComposing) return;
+    if (isComposing()) return;
     if (ev.ctrlKey || ev.metaKey || ev.altKey) return;
     if (["Backspace", "Delete", "Tab", "Escape", "ArrowLeft", "ArrowRight", "Home", "End", "Enter"].includes(ev.key)) return;
     const currentRaw = extractRaw(field.value);
@@ -195,6 +206,7 @@ function setupOtp(group) {
   const el = group;
   if (el.__icenInputInit) return;
   el.__icenInputInit = true;
+  const isComposing = trackComposing(group);
   const cells = Array.from(group.querySelectorAll(".otp-cell"));
   const syncFilled = (cell) => {
     cell.classList.toggle("is-filled", cell.value.length > 0);
@@ -205,7 +217,7 @@ function setupOtp(group) {
     }
     syncFilled(cell);
     cell.addEventListener("input", () => {
-      if (isComposing) return;
+      if (isComposing()) return;
       const ch = cell.value.slice(-1);
       cell.value = ch;
       syncFilled(cell);
@@ -239,7 +251,8 @@ function setupOtp(group) {
   const fireComplete = () => {
     const code = cells.map((c) => c.value).join("");
     if (code.length === cells.length && cells.every((c) => c.value.length > 0)) {
-      group.dispatchEvent(new CustomEvent("icen:otp-complete", { detail: { code }, bubbles: true }));
+      group.classList.add("is-complete");
+      emitIcen(group, "icen:otp-complete", { code });
       group.dispatchEvent(new CustomEvent("otp:complete", { detail: { code }, bubbles: true }));
     }
   };

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

@@ -0,0 +1,34 @@
+import { KbAccessRequest, KbAccessState, KbRole } from './kb-core.js';
+import './ai-core.js';
+
+/** createKbAccess 入参（spec §9.3；request 宽进——素对象经 normalizeAccessRequest 归一） */
+interface KbAccessOpts {
+    /** 当前访问请求（内部持有副本，不打脏调用方数据） */
+    request: KbAccessRequest | Record<string, unknown>;
+    /** requester = 申请人视角（被拒五件套 + 表单）；approver = 审批人视角（队列卡）。缺省 requester */
+    mode?: 'requester' | 'approver';
+    /** 表单提交回调（与 icen:kb-access-request 双通道） */
+    onRequest?: (r: KbAccessRequest) => void;
+    /** 审批决定回调（与 icen:kb-access-decide 双通道；approve 时 role = 批准档位） */
+    onDecide?: (id: string, decision: 'approve' | 'deny', role?: KbRole) => void;
+    /** 被拒原因文案（缺省固定模板「此内容仅对授权者开放」——不给受限侧任何更多信息，§9.0.3） */
+    deniedHint?: string;
+    /** 切换身份回调（宿主关注：切换固定身份集重查权限；不派库事件） */
+    onSwitchIdentity?: () => void;
+}
+/** createKbAccess 句柄（函数名冻结于 spec §9.3） */
+interface KbAccessHandle {
+    /** 合并更新请求字段（Partial）或整体切状态（单字符串）；带过期时间的 granted 会即时派生 expired */
+    setState(next: Partial<KbAccessRequest> | KbAccessState): void;
+    /** 当前请求（normalize 后的副本；外部修改不影响内部） */
+    getState(): KbAccessRequest;
+    /** 清空 DOM 与标记（幂等；同一 el 重复 create 会先销毁旧实例） */
+    destroy(): void;
+}
+/**
+ * 创建访问申请流（requester：被拒五件套 + 表单 + 状态徽章族；approver：审批队列卡）。
+ * 快照渲染：setState / 表单交互后整树重建（重建前回填用户已输入的理由/时长，不打断打字）。
+ */
+declare function createKbAccess(el: HTMLElement, opts: KbAccessOpts): KbAccessHandle;
+
+export { type KbAccessHandle, type KbAccessOpts, createKbAccess };