@icen.ai/ui 0.8.1 → 0.10.0

package/dist/behaviors/events.d.mts

@@ -2,11 +2,15 @@ import { ChartEventDetail } from './charts.js';
 import { AiUsage } from './ai-core.js';
 import { AiDoneEventDetail } from './ai-provider.js';
 import { AiComposerRefSource } from './ai-composer.js';
+import { MentionEntity, MentionValue } from './mentions.js';
+import { KbCitation, KbSegmentConfig, KbRetrievalQuery, KbFilterNode, KbCheckpointScope, KbSandboxMessage, KbChainStep, KbAclEntry, KbIdentity, KbAclDecision, KbAccessRequest, KbRole, KbAuditChannel, KbHygieneIssue } from './kb-core.js';
+import './icons.js';
 import './popover.js';
 import './ai-panel.js';
+import './suggestions.js';
 
 interface IcenGestureDetail {
-    /** 手势命中源：最近的 [data-gestures] 宿主 */
+    /** 手势命中源：最近的 [data-icen-gestures] 宿主 */
     source: HTMLElement;
     /** 原始 DOM 事件（click / contextmenu / pointerdown / mouseup…） */
     originalEvent: Event;
@@ -19,6 +23,8 @@ interface IcenGestureDetail {
 type IcenPolicy = (e: CustomEvent<IcenGestureDetail>) => void;
 /** 手势层事件名（策略层只认这五种，编译期收死）。 */
 type IcenGestureEvent = 'icen:click' | 'icen:dblclick' | 'icen:contextmenu' | 'icen:longpress' | 'icen:text-select';
+/** 滑动手势事件名（策略层不收——swipe 只有事件语义，无全站默认行为需求）。 */
+type IcenSwipeEvent = 'icen:swipe-left' | 'icen:swipe-right' | 'icen:swipe-up' | 'icen:swipe-down';
 /**
  * 全库事件注册表：事件名 → detail 契约。onIcen 推断、emitIcen 校验，双侧同表。
  * 新增事件必须在此登记（模板签名兜底只留给宿主自定义事件）。
@@ -29,6 +35,25 @@ interface IcenEventMap {
     'icen:contextmenu': IcenGestureDetail;
     'icen:longpress': IcenGestureDetail;
     'icen:text-select': IcenGestureDetail;
+    'icen:swipe-left': IcenGestureDetail & {
+        dx: number;
+        dy: number;
+    };
+    'icen:swipe-right': IcenGestureDetail & {
+        dx: number;
+        dy: number;
+    };
+    'icen:swipe-up': IcenGestureDetail & {
+        dx: number;
+        dy: number;
+    };
+    'icen:swipe-down': IcenGestureDetail & {
+        dx: number;
+        dy: number;
+    };
+    'icen:locale-change': {
+        changed: string[];
+    };
     'icen:chart-hover': ChartEventDetail;
     'icen:chart-click': ChartEventDetail;
     'icen:chart-dblclick': ChartEventDetail;
@@ -41,6 +66,12 @@ interface IcenEventMap {
     'icen:chart-legend-visibility': {
         visible: boolean;
     };
+    /** 缩放/刷选（renderChart spec.zoom）：类目索引区间 [from, to]（含端点） */
+    'icen:chart-zoom': {
+        chart: string;
+        from: number;
+        to: number;
+    };
     'icen:tab-change': {
         tab: HTMLElement | null;
         panel: HTMLElement | null;
@@ -117,6 +148,11 @@ interface IcenEventMap {
         text: string;
         reason: string;
     };
+    'icen:code-block-toggle': {
+        el: HTMLElement;
+        action: 'num' | 'wrap' | 'fold';
+        value: boolean;
+    };
     'icen:back-top': Record<string, never>;
     'icen:modal-open': {
         id: string;
@@ -141,6 +177,10 @@ interface IcenEventMap {
         value: string;
         date: Date | null;
     };
+    'icen:panel-toggle': {
+        panel: HTMLElement;
+        expanded: boolean;
+    };
     'icen:accordion-toggle': {
         item: HTMLElement;
         index: number;
@@ -198,6 +238,65 @@ interface IcenEventMap {
     'icen:table-export': {
         count: number;
     };
+    /** 单元格编辑提交（editable 列；宿主应用数据后调 handle.updateCell 或 setData） */
+    'icen:table-cell-edit': {
+        rowKey: string;
+        field: string;
+        value: unknown;
+        row: unknown;
+    };
+    /** 列拖拽重排完成 */
+    'icen:table-column-reorder': {
+        key: string;
+        fromIndex: number;
+        toIndex: number;
+    };
+    /** 分组行展开/折叠 */
+    'icen:table-group-toggle': {
+        key: string;
+        collapsed: boolean;
+    };
+    /** 列宽拖拽完成（拖动过程中不派发，防事件洪泛） */
+    'icen:table-column-resize': {
+        key: string;
+        width: string;
+    };
+    'icen:form-field-validate': {
+        name: string;
+        valid: boolean;
+        message?: string;
+    };
+    'icen:form-valid': {
+        names: string[];
+    };
+    'icen:form-invalid': {
+        errors: Record<string, string>;
+        first: string | null;
+    };
+    'icen:cascader-change': {
+        value: string[];
+        path: string[];
+    };
+    'icen:tree-select-change': {
+        value: string[];
+        labels: string[];
+    };
+    'icen:mention-select': {
+        item: MentionEntity<unknown>;
+        query: string;
+    };
+    'icen:mention-change': {
+        value: MentionValue<unknown>[];
+        text: string;
+        mentions: MentionEntity<unknown>[];
+    };
+    'icen:autocomplete-select': {
+        value: string;
+        label: string;
+    };
+    'icen:autocomplete-change': {
+        value: string;
+    };
     'icen:upload': {
         files: File[];
     };
@@ -234,10 +333,14 @@ interface IcenEventMap {
     };
     'icen:ai-send': {
         text: string;
+        refs?: AiComposerRefSource[];
+        files?: File[];
     };
     'icen:ai-stop': Record<string, never>;
     'icen:ai-queue': {
         text: string;
+        refs?: AiComposerRefSource[];
+        files?: File[];
     };
     'icen:ai-dequeue': {
         index: number;
@@ -245,6 +348,10 @@ interface IcenEventMap {
     'icen:ai-attach': {
         files: File[];
     };
+    'icen:ai-attachment-remove': {
+        file: File;
+        files: File[];
+    };
     'icen:ai-model-change': {
         provider: string;
         model: string;
@@ -282,8 +389,211 @@ interface IcenEventMap {
         name: string;
         el: HTMLElement;
     };
+    /** 工具审批（requiresApproval 的工具在挂载卡上等待宿主裁决；approve 才执行 run） */
+    'icen:ai-tool-approve': {
+        name: string;
+        input: Record<string, unknown>;
+        el: HTMLElement;
+    };
+    'icen:ai-tool-reject': {
+        name: string;
+        input: Record<string, unknown>;
+        el: HTMLElement;
+    };
     'icen:ai-usage': AiUsage;
     'icen:ai-done': AiDoneEventDetail;
+    'icen:ai-thread-select': {
+        key: string;
+    };
+    'icen:ai-thread-action': {
+        action: 'rename' | 'pin' | 'archive' | 'delete' | 'move';
+        key: string;
+    };
+    'icen:ai-feedback': {
+        value: 1 | -1 | 0;
+        reason?: string;
+        el?: HTMLElement;
+    };
+    'icen:ai-branch-change': {
+        index: number;
+        count: number;
+    };
+    'icen:kb-citation-open': {
+        citation: KbCitation;
+    };
+    'icen:kb-source-open': {
+        source: KbCitation;
+    };
+    'icen:kb-passage-jump': {
+        citation: KbCitation;
+    };
+    'icen:kb-passage-close': Record<string, never>;
+    'icen:kb-pipeline-toggle': {
+        el: HTMLElement;
+        open: boolean;
+    };
+    'icen:kb-pipeline-rerun': {
+        documentId: string;
+    };
+    'icen:kb-chunk-toggle': {
+        chunkId: string;
+        available: boolean;
+    };
+    'icen:kb-chunk-edit': {
+        chunkId: string;
+    };
+    'icen:kb-chunk-remove': {
+        chunkId: string;
+    };
+    'icen:kb-chunk-add': {
+        documentId: string;
+    };
+    'icen:kb-chunk-search': {
+        mode: 'text' | 'vector';
+        query: string;
+    };
+    'icen:kb-segment-change': {
+        config: KbSegmentConfig;
+    };
+    'icen:kb-connector-sync': {
+        connectorId: string;
+    };
+    'icen:kb-connector-reauth': {
+        connectorId: string;
+    };
+    'icen:kb-connector-schedule': {
+        connectorId: string;
+        schedule: string;
+    };
+    'icen:kb-metadata-change': {
+        action: 'define' | 'bind' | 'remove';
+        key: string;
+    };
+    'icen:kb-qa-change': {
+        op: 'add' | 'edit' | 'remove';
+        index: number;
+    };
+    'icen:kb-qa-import': {
+        source: string;
+    };
+    'icen:kb-retrieval-run': {
+        query: KbRetrievalQuery;
+    };
+    'icen:kb-filter-change': {
+        node: KbFilterNode | null;
+        valid: boolean;
+    };
+    'icen:kb-rerank-toggle': {
+        enabled: boolean;
+        model?: string;
+    };
+    'icen:kb-hittest-add': {
+        question: string;
+    };
+    'icen:kb-hittest-run': Record<string, never>;
+    'icen:kb-sql-edit': {
+        sql: string;
+    };
+    'icen:kb-sql-rerun': {
+        sql: string;
+    };
+    'icen:kb-clarify-answer': {
+        id?: string;
+        value: string;
+        label: string;
+    };
+    'icen:kb-verified-open': {
+        assetId: string;
+    };
+    'icen:kb-explain-toggle': {
+        el: HTMLElement;
+        open: boolean;
+    };
+    'icen:kb-trace-select': {
+        spanId: string;
+    };
+    'icen:kb-trace-toggle': {
+        spanId: string;
+        open: boolean;
+    };
+    'icen:kb-review-assign': {
+        taskId: string;
+        assignee: string;
+    };
+    'icen:kb-review-score': {
+        taskId: string;
+        name: string;
+        value: string | number;
+    };
+    'icen:kb-review-submit': {
+        taskId: string;
+    };
+    'icen:kb-gap-action': {
+        query: string;
+        action: 'create-doc' | 'add-synonym';
+    };
+    'icen:kb-eval-compare': {
+        runA: string;
+        runB: string;
+    };
+    'icen:kb-canvas-ai': {
+        instruction: string;
+        selection?: {
+            text: string;
+        };
+    };
+    'icen:kb-canvas-version': {
+        versionId: string;
+    };
+    'icen:kb-checkpoint-restore': {
+        checkpointId: string;
+        scope: KbCheckpointScope;
+    };
+    'icen:kb-sandbox-message': {
+        channel: 'in' | 'out';
+        payload: KbSandboxMessage;
+    };
+    'icen:kb-chain-step': {
+        index: number;
+        step: KbChainStep;
+    };
+    'icen:kb-acl-grant': {};
+    'icen:kb-acl-remove': {
+        subject: KbAclEntry['subject'];
+    };
+    'icen:kb-acl-inherit': {
+        action: 'break' | 'restore';
+    };
+    'icen:kb-whocan-check': {
+        identity: KbIdentity;
+        decision: KbAclDecision;
+    };
+    'icen:kb-access-request': {
+        request: KbAccessRequest;
+    };
+    'icen:kb-access-decide': {
+        id: string;
+        decision: 'approve' | 'deny';
+        role?: KbRole;
+    };
+    'icen:kb-access-expire': {
+        id: string;
+    };
+    'icen:kb-audit-filter': {
+        channel: KbAuditChannel | 'all';
+    };
+    'icen:kb-audit-export': {
+        channel: KbAuditChannel | 'all';
+    };
+    'icen:kb-hygiene-action': {
+        issue: KbHygieneIssue;
+    };
+    'icen:kb-visibility-identity': {
+        identity: KbIdentity;
+    };
+    'icen:kb-visibility-layer': {
+        layer: 'pre' | 'post' | 'none';
+    };
     [key: `icen:${string}`]: unknown;
 }
 interface IcenListenOptions {
@@ -298,7 +608,7 @@ interface IcenListenOptions {
 /**
  * 统一绑定器（全库事件一个入口）：
  *   onIcen('icen:tab-change', (e) => e.detail.index)                       全局
- *   onIcen('icen:chart-click', '.chart', (e) => …)                          选择器委托
+ *   onIcen('icen:chart-click', '.icen-chart', (e) => …)                          选择器委托
  *   onIcen('icen:upload', (e) => …, { within: formEl })                     子树限定
  *   onIcen('icen:ai-done', (e) => …, { signal: ctrl.signal })               广播 + 信号解绑
  * 返回解绑函数 —— React useEffect / Vue onUnmounted 直接 return。
@@ -327,4 +637,4 @@ declare function initGestures(): () => void;
 /** 摘除手势层委托（等同 initGestures 返回的销毁函数；未启动时为 no-op）。 */
 declare function destroyGestures(): void;
 
-export { type IcenEventMap, type IcenGestureDetail, type IcenGestureEvent, type IcenListenOptions, type IcenPolicy, destroyGestures, emitIcen, getEventPolicy, initGestures, onIcen, resetEventPolicies, setEventPolicy };
+export { type IcenEventMap, type IcenGestureDetail, type IcenGestureEvent, type IcenListenOptions, type IcenPolicy, type IcenSwipeEvent, destroyGestures, emitIcen, getEventPolicy, initGestures, onIcen, resetEventPolicies, setEventPolicy };

package/dist/behaviors/events.mjs

@@ -55,10 +55,13 @@ var LONGPRESS_MS = 520;
 var LONGPRESS_MOVE = 12;
 var CLICK_DELAY = 220;
 var CLICK_DRAG_TOLERANCE = 5;
+var SWIPE_MIN = 48;
+var SWIPE_AXIS_RATIO = 2;
+var SWIPE_SCROLL_HINT = 12;
 function gestureHost(e, name) {
   const t = e.target;
   if (!(t instanceof Element)) return null;
-  return t.closest(`[data-gestures~="${name}"]`);
+  return t.closest(`[data-icen-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 };
@@ -105,7 +108,7 @@ function initGestures() {
       return;
     }
     if (isDragRelease(e)) return;
-    if (host.matches('[data-gestures~="dblclick"]')) {
+    if (host.matches('[data-icen-gestures~="dblclick"]')) {
       if (clickTimer) clearTimeout(clickTimer);
       pending = { host, e };
       clickTimer = setTimeout(() => {
@@ -160,6 +163,39 @@ function initGestures() {
     if (!lp) return;
     if (Math.hypot(e.clientX - lp.x, e.clientY - lp.y) > LONGPRESS_MOVE) clearLp();
   };
+  let sw = null;
+  const clearSwipe = () => {
+    sw = null;
+  };
+  const onSwipeDown = (e) => {
+    const host = gestureHost(e, "swipe");
+    if (!host) return;
+    sw = { host, x: e.clientX, y: e.clientY, scroll: false };
+  };
+  const onSwipeMove = (e) => {
+    if (!sw) return;
+    const adx = Math.abs(e.clientX - sw.x);
+    const ady = Math.abs(e.clientY - sw.y);
+    if (ady > adx && ady >= SWIPE_SCROLL_HINT) sw.scroll = true;
+  };
+  const onSwipeUp = (e) => {
+    const cur = sw;
+    sw = null;
+    if (!cur) return;
+    const dx = e.clientX - cur.x;
+    const dy = e.clientY - cur.y;
+    const adx = Math.abs(dx);
+    const ady = Math.abs(dy);
+    const main = Math.max(adx, ady);
+    if (main < SWIPE_MIN) return;
+    if (Math.min(adx, ady) * SWIPE_AXIS_RATIO >= main) return;
+    let dir;
+    if (adx >= ady) dir = dx < 0 ? "left" : "right";
+    else dir = dy < 0 ? "up" : "down";
+    if (cur.scroll && (dir === "left" || dir === "right")) return;
+    const { x, y } = pointOf(e);
+    emitIcen(cur.host, `icen:swipe-${dir}`, { source: cur.host, originalEvent: e, x, y, dx, dy });
+  };
   const onTextSelect = (e) => {
     const host = gestureHost(e, "text-select");
     if (!host) return;
@@ -176,6 +212,10 @@ function initGestures() {
   document.addEventListener("pointermove", onLpMove);
   document.addEventListener("pointerup", clearLp);
   document.addEventListener("pointercancel", clearLp);
+  document.addEventListener("pointerdown", onSwipeDown);
+  document.addEventListener("pointermove", onSwipeMove);
+  document.addEventListener("pointerup", onSwipeUp);
+  document.addEventListener("pointercancel", clearSwipe);
   document.addEventListener("mouseup", onTextSelect);
   gesturesTeardown = () => {
     document.removeEventListener("pointerdown", onDownPos);
@@ -186,9 +226,14 @@ function initGestures() {
     document.removeEventListener("pointermove", onLpMove);
     document.removeEventListener("pointerup", clearLp);
     document.removeEventListener("pointercancel", clearLp);
+    document.removeEventListener("pointerdown", onSwipeDown);
+    document.removeEventListener("pointermove", onSwipeMove);
+    document.removeEventListener("pointerup", onSwipeUp);
+    document.removeEventListener("pointercancel", clearSwipe);
     document.removeEventListener("mouseup", onTextSelect);
     cancelPendingClick();
     clearLp();
+    clearSwipe();
     gesturesInit = false;
     gesturesTeardown = null;
   };

package/dist/behaviors/feedback.d.mts

@@ -0,0 +1,30 @@
+interface CountdownState {
+    duration: number;
+    remaining: number;
+    paused: boolean;
+    timer: number;
+    startedAt: number;
+}
+interface FeedbackClock {
+    pause(reason?: string): void;
+    resume(reason?: string): void;
+    reset(ms: number): void;
+    destroy(): void;
+}
+declare function createFeedbackClock(el: HTMLElement, state: CountdownState, expire: () => void, progress: string, pauseOnHover?: () => boolean): FeedbackClock;
+type FeedbackAction = (signal: AbortSignal) => void | boolean | Promise<void | boolean>;
+/** Cancel the UI continuation and signal cooperative work; stale promises never
+ * dismiss a replaced card or resurrect controls after the owner was destroyed. */
+declare function cancelFeedbackAction(card: HTMLElement): void;
+declare function runFeedbackAction(card: HTMLElement, button: HTMLButtonElement, action: FeedbackAction, hooks: {
+    busy(value: boolean): void;
+    complete(accepted: boolean): void;
+    error(error: unknown): void;
+}): void;
+declare function setFeedbackError(host: HTMLElement, message?: string): void;
+/** Isolate caller text from the layout direction (CJK/Latin in an RTL shell). */
+declare function setFeedbackText(host: HTMLElement, value: string): void;
+declare function rememberFeedbackOrigin(card: HTMLElement): void;
+declare function restoreFeedbackFocus(card: HTMLElement): void;
+
+export { type CountdownState, type FeedbackAction, type FeedbackClock, cancelFeedbackAction, createFeedbackClock, rememberFeedbackOrigin, restoreFeedbackFocus, runFeedbackAction, setFeedbackError, setFeedbackText };