@icen.ai/ui 0.9.0 → 0.11.0

package/dist/behaviors/events.d.mts

@@ -1,13 +1,16 @@
-import { ChartEventDetail } from './charts.js';
-import { AiUsage } from './ai-core.js';
-import { AiDoneEventDetail } from './ai-provider.js';
-import { AiComposerRefSource } from './ai-composer.js';
-import { KbCitation, KbSegmentConfig, KbRetrievalQuery, KbFilterNode, KbCheckpointScope, KbSandboxMessage, KbChainStep, KbAclEntry, KbIdentity, KbAclDecision, KbAccessRequest, KbRole, KbAuditChannel, KbHygieneIssue } from './kb-core.js';
-import './popover.js';
-import './ai-panel.js';
+import { ChartEventDetail } from './charts.mjs';
+import { AiUsage } from './ai-core.mjs';
+import { AiDoneEventDetail } from './ai-provider.mjs';
+import { AiComposerRefSource } from './ai-composer.mjs';
+import { MentionEntity, MentionValue } from './mentions.mjs';
+import { KbCitation, KbSegmentConfig, KbRetrievalQuery, KbFilterNode, KbCheckpointScope, KbSandboxMessage, KbChainStep, KbAclEntry, KbIdentity, KbAclDecision, KbAccessRequest, KbRole, KbAuditChannel, KbHygieneIssue } from './kb-core.mjs';
+import './icons.mjs';
+import './popover.mjs';
+import './ai-panel.mjs';
+import './suggestions.mjs';
 
 interface IcenGestureDetail {
-    /** 手势命中源：最近的 [data-gestures] 宿主 */
+    /** 手势命中源：最近的 [data-icen-gestures] 宿主 */
     source: HTMLElement;
     /** 原始 DOM 事件（click / contextmenu / pointerdown / mouseup…） */
     originalEvent: Event;
@@ -20,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 校验，双侧同表。
  * 新增事件必须在此登记（模板签名兜底只留给宿主自定义事件）。
@@ -30,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;
@@ -42,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;
@@ -118,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;
@@ -142,6 +177,10 @@ interface IcenEventMap {
         value: string;
         date: Date | null;
     };
+    'icen:panel-toggle': {
+        panel: HTMLElement;
+        expanded: boolean;
+    };
     'icen:accordion-toggle': {
         item: HTMLElement;
         index: number;
@@ -199,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[];
     };
@@ -235,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;
@@ -246,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;
@@ -283,6 +389,17 @@ 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': {
@@ -491,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。
@@ -520,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 };
@@ -96,6 +99,11 @@ function initGestures() {
     downPos = { x: e.clientX, y: e.clientY };
     suppressTrailingClick = false;
   };
+  const onUpPos = (e) => {
+    if (downPos && Math.hypot(e.clientX - downPos.x, e.clientY - downPos.y) <= CLICK_DRAG_TOLERANCE) {
+      downPos = null;
+    }
+  };
   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");
@@ -104,8 +112,11 @@ function initGestures() {
       suppressTrailingClick = false;
       return;
     }
-    if (isDragRelease(e)) return;
-    if (host.matches('[data-gestures~="dblclick"]')) {
+    if (isDragRelease(e)) {
+      downPos = null;
+      return;
+    }
+    if (host.matches('[data-icen-gestures~="dblclick"]')) {
       if (clickTimer) clearTimeout(clickTimer);
       pending = { host, e };
       clickTimer = setTimeout(() => {
@@ -160,6 +171,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;
@@ -169,6 +213,7 @@ function initGestures() {
     emit(host, "icen:text-select", e, text);
   };
   document.addEventListener("pointerdown", onDownPos);
+  document.addEventListener("pointerup", onUpPos);
   document.addEventListener("click", onClick);
   document.addEventListener("dblclick", onDblClick);
   document.addEventListener("contextmenu", onContextMenu);
@@ -176,9 +221,14 @@ 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);
+    document.removeEventListener("pointerup", onUpPos);
     document.removeEventListener("click", onClick);
     document.removeEventListener("dblclick", onDblClick);
     document.removeEventListener("contextmenu", onContextMenu);
@@ -186,9 +236,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 };

package/dist/behaviors/feedback.mjs

@@ -0,0 +1,296 @@
+// src/behaviors/icons.ts
+var ICON_PATHS = {
+  file: "M6 2.5h5.5L16 7v9.5a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-12a2 2 0 0 1 2-2ZM11.5 2.5V7H16",
+  folder: "M3 5a1.5 1.5 0 0 1 1.5-1.5H8l2 2h5.5A1.5 1.5 0 0 1 17 7v8a1.5 1.5 0 0 1-1.5 1.5h-11A1.5 1.5 0 0 1 3 15Z",
+  globe: "M17.5 10a7.5 7.5 0 1 1-15 0 7.5 7.5 0 0 1 15 0ZM2.5 10h15M10 2.5c-4 4-4 11 0 15 4-4 4-11 0-15Z",
+  document: "M6 2.5h5.5L16 7v9.5a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-12a2 2 0 0 1 2-2ZM11.5 2.5V7H16M7 10.5h6M7 13.5h6",
+  agent: "M10 6V3M8 3h2M5 6h10a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2ZM1.5 10h1.5M17 10h1.5M7 10v2M13 10v2M8 14h4",
+  paperclip: "M14 7 8.3 12.7a1.6 1.6 0 0 1-2.3-2.3l6.3-6.3a3.2 3.2 0 0 1 4.5 4.5l-7 7a4.7 4.7 0 0 1-6.7-6.7l7-7",
+  stop: "M6.5 5h7A1.5 1.5 0 0 1 15 6.5v7a1.5 1.5 0 0 1-1.5 1.5h-7A1.5 1.5 0 0 1 5 13.5v-7A1.5 1.5 0 0 1 6.5 5Z",
+  terminal: "M5 3.5h10a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-9a2 2 0 0 1 2-2ZM6 7l3 3-3 3M11 13h3",
+  branch: "M6 6v8M14 6v2a4 4 0 0 1-4 4H6M8 4a2 2 0 1 1-4 0 2 2 0 0 1 4 0ZM8 16a2 2 0 1 1-4 0 2 2 0 0 1 4 0ZM16 4a2 2 0 1 1-4 0 2 2 0 0 1 4 0Z",
+  "line-numbers": "M3 5h2M3 10h2M3 15h2M8 5h9M8 10h9M8 15h9",
+  wrap: "M3 5h14M3 10h10a3 3 0 0 1 0 6h-3M12.5 13.5 10 16l2.5 2.5",
+  calendar: "M5.5 4h9A2.5 2.5 0 0 1 17 6.5v8a2.5 2.5 0 0 1-2.5 2.5h-9A2.5 2.5 0 0 1 3 14.5v-8A2.5 2.5 0 0 1 5.5 4ZM6.5 2.5v3M13.5 2.5v3M3 8h14M6.5 11h.1M10 11h.1M13.5 11h.1M6.5 14h.1M10 14h.1",
+  close: "M6 6l8 8M14 6l-8 8",
+  check: "M4.5 10.2l3.6 3.6 7.4-7.6",
+  "chevron-down": "M5.5 7.75 10 12.25l4.5-4.5",
+  "chevron-up": "M5.5 12.25 10 7.75l4.5 4.5",
+  "chevron-right": "M7.75 5.5 12.25 10l-4.5 4.5",
+  "chevron-left": "M12.25 5.5 7.75 10l4.5 4.5",
+  "arrow-right": "M3.5 10h13M11 4.5l5.5 5.5-5.5 5.5",
+  "arrow-left": "M16.5 10h-13M9 4.5 3.5 10 9 15.5",
+  "arrow-up": "M10 16.5v-13M4.5 9 10 3.5 15.5 9",
+  "arrow-down": "M10 3.5v13M4.5 11l5.5 5.5 5.5-5.5",
+  plus: "M10 4v12M4 10h12",
+  minus: "M4 10h12",
+  sort: "M6 15V4M3 7l3-3 3 3M14 5v11M11 13l3 3 3-3",
+  search: "M13.3 13.3 17 17M14.5 8.5a6 6 0 1 1-12 0 6 6 0 0 1 12 0",
+  sun: "M13.5 10a3.5 3.5 0 1 1-7 0 3.5 3.5 0 0 1 7 0M10 1.75v1.5M10 16.75v1.5M1.75 10h1.5M16.75 10h1.5M4.17 4.17l1.06 1.06M14.77 14.77l1.06 1.06M4.17 15.83l1.06-1.06M14.77 5.23l1.06-1.06",
+  moon: "M17.25 11.15A7.5 7.5 0 0 1 8.85 2.75a7.5 7.5 0 1 0 8.4 8.4Z",
+  modern: "M6.5 3h7A3.5 3.5 0 0 1 17 6.5v7a3.5 3.5 0 0 1-3.5 3.5h-7A3.5 3.5 0 0 1 3 13.5v-7A3.5 3.5 0 0 1 6.5 3ZM7 10l3-3 3 3-3 3Z",
+  pixel: "M3 3h5v5H3ZM12 3h5v5h-5ZM3 12h5v5H3ZM12 12h5v5h-5Z",
+  chinese: "M3 8c3 0 5-2 7-5 2 3 4 5 7 5M4 8h12M6 8v8m8-8v8M3 16h14M8 16v-5h4v5",
+  soviet: "M3 17h14M5 17V8h4v9m0-12h6v12M7 8V5h2m2 3h2m-2 3h2m-2 3h2M10 5V3h4v2",
+  more: "M4 9.9v.2M10 9.9v.2M16 9.9v.2",
+  copy: "M7 7h8a2 2 0 0 1 2 2v6a2 2 0 0 1-2 2H9a2 2 0 0 1-2-2V7ZM13 7V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2h2",
+  edit: "M11.5 4.5l4 4M4 12l9-9a1.4 1.4 0 0 1 2 0l2 2a1.4 1.4 0 0 1 0 2l-9 9-5 1Z",
+  link: "M8 6l2-2a4.2 4.2 0 0 1 6 6l-2 2M12 14l-2 2a4.2 4.2 0 0 1-6-6l2-2M7 13l6-6",
+  trash: "M3.5 5.5h13M7 5.5V3h6v2.5M5 5.5l.7 11.5h8.6L15 5.5M8 9v5M12 9v5",
+  spinner: "M10 3a7 7 0 1 1-7 7",
+  "circle-check": "M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0ZM6 10l2.7 2.7 5.3-5.4",
+  "circle-error": "M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0ZM7.2 7.2l5.6 5.6M12.8 7.2l-5.6 5.6",
+  "circle-info": "M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0ZM10 9v5M10 6.1v.15",
+  "triangle-alert": "M8.7 3.5a1.5 1.5 0 0 1 2.6 0l6.4 11.3a1.5 1.5 0 0 1-1.3 2.2H3.6a1.5 1.5 0 0 1-1.3-2.2ZM10 7.2v4.4M10 14v.15",
+  refresh: "M16.5 7.2A7 7 0 0 0 4.3 5.9L2.5 8M2.5 3.5V8H7M3.5 12.8a7 7 0 0 0 12.2 1.3l1.8-2.1M13 12h4.5v4.5",
+  external: "M11.5 3H17v5.5M17 3l-8 8M8 3H5a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2v-3",
+  home: "M3.5 10.25 10 4l6.5 6.25M5.75 8.75v7a.75.75 0 0 0 .75.75h7.5a.75.75 0 0 0 .75-.75v-7",
+  settings: "M3.5 5.5h13M3.5 10h13M3.5 14.5h13M7 4v3M12.5 8.5v3M8 13v3",
+  star: "M10 2.5l2.4 5.1 5.6.4-4.2 3.7 1.3 5.5-5.1-3-5.1 3 1.3-5.5L1.8 8l5.6-.4Z",
+  eye: "M2.2 10s3-5.4 7.8-5.4S17.8 10 17.8 10s-3 5.4-7.8 5.4S2.2 10 2.2 10ZM10 12.4a2.4 2.4 0 1 0 0-4.8 2.4 2.4 0 0 0 0 4.8Z",
+  "eye-off": "M2.2 10s3-5.4 7.8-5.4S17.8 10 17.8 10s-3 5.4-7.8 5.4S2.2 10 2.2 10ZM10 12.4a2.4 2.4 0 1 0 0-4.8 2.4 2.4 0 0 0 0 4.8ZM3.5 3.5l13 13",
+  inbox: "M3.5 12.25h3.7l1.5 2.5h2.6l1.5-2.5h3.7M4.7 5.5l-1.2 6.75v3.25a1.5 1.5 0 0 0 1.5 1.5h10a1.5 1.5 0 0 0 1.5-1.5v-3.25L15.3 5.5a1.3 1.3 0 0 0-1.25-1H5.95a1.3 1.3 0 0 0-1.25 1Z",
+  bell: "M10 3.5a4.5 4.5 0 0 1 4.5 4.5c0 4.5 1.8 5.7 2.5 6.5H3c.7-.8 2.5-2 2.5-6.5A4.5 4.5 0 0 1 10 3.5ZM8.5 16.5a1.6 1.6 0 0 0 3 0",
+  users: "M13.8 16.5v-1.5a3.5 3.5 0 0 0-3.5-3.5H6.3a3.5 3.5 0 0 0-3.5 3.5v1.5M8.3 8.9a2.7 2.7 0 1 0 0-5.4 2.7 2.7 0 0 0 0 5.4ZM16.5 16.5v-1.3a3.3 3.3 0 0 0-2.3-3.1M12.3 3.7a2.7 2.7 0 0 1 0 5.2",
+  activity: "M17 10h-2.6l-2 5.8L8 4.2 6 10H3",
+  "trend-up": "M3.5 14.5l4.2-4.2 2.8 2.8 5.9-5.9M12.4 7.2h4.2v4.2",
+  "trend-down": "M3.5 5.5l4.2 4.2 2.8-2.8 5.9 5.9M12.4 12.8h4.2V8.6",
+  rocket: "M10 2.5c2 1.5 3.2 4 3.2 6.8 0 1.5-.3 2.9-.8 4.2H7.6c-.5-1.3-.8-2.7-.8-4.2 0-2.8 1.2-5.3 3.2-6.8ZM10 8.6a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM7.6 12.5 5.6 15.4c-.9.3-1.6 1-2 2M12.4 12.5l2 2.9c.9.3 1.6 1 2 2M8.7 13.8c0 1.8.5 3.1 1.3 4.2.8-1.1 1.3-2.4 1.3-4.2",
+  bold: "M6.5 4h4.2a3 3 0 0 1 0 6H6.5M6.5 10h5a3 3 0 0 1 0 6H6.5M6.5 4v12",
+  italic: "M8.5 4.5h7M4.5 15.5h7M12.5 4.5l-5 11",
+  underline: "M6 4v5.5a4 4 0 0 0 8 0V4M4.5 16h11",
+  "align-left": "M3.5 4.5h13M3.5 10h8.5M3.5 15.5h11",
+  "align-center": "M3.5 4.5h13M5.75 10h8.5M4.5 15.5h11",
+  "align-right": "M3.5 4.5h13M8 10h8.5M5.5 15.5h11",
+  list: "M6.5 5h10M6.5 10h10M6.5 15h10M3.5 5h.01M3.5 10h.01M3.5 15h.01",
+  server: "M3 3h14a1.5 1.5 0 0 1 1.5 1.5v2A1.5 1.5 0 0 1 17 8H3a1.5 1.5 0 0 1-1.5-1.5v-2A1.5 1.5 0 0 1 3 3ZM3 12h14a1.5 1.5 0 0 1 1.5 1.5v2A1.5 1.5 0 0 1 17 17H3a1.5 1.5 0 0 1-1.5-1.5v-2A1.5 1.5 0 0 1 3 12ZM5 5.5h.01M5 14.5h.01",
+  sparkle: "M10 2.5l1.6 4.3 4.3 1.6-4.3 1.6L10 14.3l-1.6-4.3-4.3-1.6 4.3-1.6ZM15.5 12.5l.8 2.1 2.1.8-2.1.8-.8 2.1-.8-2.1-2.1-.8 2.1-.8Z",
+  play: "M6.5 4.8v10.4c0 .9 1 1.5 1.8 1l8.3-5.2a1.2 1.2 0 0 0 0-2L8.3 3.8a1.2 1.2 0 0 0-1.8 1Z",
+  "chart-line": "M3.5 3.5v13h13M6.5 12l2.8-2.8 2.2 2.2 4-4.4",
+  layers: "M10 3.2 3.6 6.5 10 9.8l6.4-3.3ZM4.5 10.4 10 13.2l5.5-2.8M4.5 13.6 10 16.4l5.5-2.8",
+  box: "M17 6 10 3.2 3 6v8l7 2.8 7-2.8ZM3 6l7 2.8L17 6M10 9v7.8",
+  filter: "M4 4.5h12l-4.4 5.1v5l-3.2-1.6V9.6Z",
+  columns: "M3.5 4h13v12h-13ZM8.2 4v12M12.8 4v12",
+  download: "M10 3.5v8M6.8 8.3 10 11.5l3.2-3.2M4 15v2.5a1.5 1.5 0 0 0 1.5 1.5h9a1.5 1.5 0 0 0 1.5-1.5V15"
+};
+var custom = /* @__PURE__ */ new Map();
+function iconPath(name) {
+  return Object.hasOwn(ICON_PATHS, name) ? ICON_PATHS[name] : custom.get(name) ?? null;
+}
+function iconAttributes(o = {}) {
+  const size = Number.isFinite(o.size) && o.size > 0 ? o.size : 16;
+  return { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 20 20", width: String(size), height: String(size), fill: "none", stroke: "currentColor", "stroke-width": "1.6", "stroke-linecap": "round", "stroke-linejoin": "round", focusable: "false", class: ["icen-symbol", o.className].filter(Boolean).join(" "), ...o.label ? { role: "img", "aria-label": o.label } : { "aria-hidden": "true" } };
+}
+function createIcon(name, o = {}) {
+  if (typeof document === "undefined") return null;
+  const path = iconPath(name);
+  if (!path) return null;
+  const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+  for (const [key, value] of Object.entries(iconAttributes(o))) svg.setAttribute(key, value);
+  const line = document.createElementNS(svg.namespaceURI, "path");
+  line.setAttribute("d", path);
+  svg.append(line);
+  return svg;
+}
+
+// src/behaviors/feedback.ts
+function createFeedbackClock(el, state, expire, progress, pauseOnHover = () => true) {
+  if (typeof document === "undefined") return { pause() {
+  }, resume() {
+  }, reset() {
+  }, destroy() {
+  } };
+  const reasons = /* @__PURE__ */ new Set();
+  const ac = new AbortController();
+  let destroyed = false;
+  function sync(reset = false) {
+    state.paused = state.duration > 0 && reasons.size > 0;
+    el.classList.toggle("is-paused", state.paused);
+    const fill = el.querySelector(progress);
+    if (fill) {
+      if (reset) {
+        fill.style.animationName = "none";
+        void fill.offsetWidth;
+        fill.style.animationName = "";
+        fill.style.animationDuration = `${state.duration}ms`;
+      }
+      fill.style.animationPlayState = state.paused ? "paused" : "running";
+    }
+  }
+  function stop() {
+    if (!state.timer) return;
+    window.clearTimeout(state.timer);
+    state.timer = 0;
+    state.remaining = Math.max(0, state.remaining - (Date.now() - state.startedAt));
+  }
+  function start() {
+    if (destroyed || state.duration <= 0 || reasons.size || state.timer) return;
+    if (state.remaining <= 0) {
+      expire();
+      return;
+    }
+    state.startedAt = Date.now();
+    state.timer = window.setTimeout(() => {
+      state.timer = 0;
+      state.remaining = 0;
+      if (!destroyed) expire();
+    }, state.remaining);
+  }
+  const clock = {
+    pause(reason = "manual") {
+      if (destroyed) return;
+      reasons.add(reason);
+      stop();
+      sync();
+    },
+    resume(reason = "manual") {
+      if (destroyed) return;
+      reasons.delete(reason);
+      sync();
+      start();
+    },
+    reset(ms) {
+      if (destroyed) return;
+      stop();
+      state.duration = Number.isFinite(ms) ? Math.max(0, ms) : 0;
+      state.remaining = state.duration;
+      sync(true);
+      start();
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      stop();
+      reasons.clear();
+      ac.abort();
+    }
+  };
+  el.addEventListener("mouseenter", () => {
+    if (pauseOnHover()) clock.pause("hover");
+  }, { signal: ac.signal });
+  el.addEventListener("mouseleave", () => clock.resume("hover"), { signal: ac.signal });
+  el.addEventListener("focusin", () => clock.pause("focus"), { signal: ac.signal });
+  el.addEventListener("focusout", (event) => {
+    if (!(event.relatedTarget instanceof Node) || !el.contains(event.relatedTarget)) clock.resume("focus");
+  }, { signal: ac.signal });
+  const visibility = () => document.hidden ? clock.pause("visibility") : clock.resume("visibility");
+  document.addEventListener("visibilitychange", visibility, { signal: ac.signal });
+  if (document.hidden) reasons.add("visibility");
+  if (el.contains(document.activeElement)) reasons.add("focus");
+  clock.reset(state.duration);
+  return clock;
+}
+var pending = /* @__PURE__ */ new WeakMap();
+function cancelFeedbackAction(card) {
+  pending.get(card)?.abort();
+}
+function runFeedbackAction(card, button, action, hooks) {
+  if (typeof document === "undefined") return;
+  if (pending.has(card) || card.classList.contains("is-leaving") || !card.isConnected) return;
+  const ac = new AbortController();
+  const controls = Array.from(card.querySelectorAll(".icen-toast-action,.icen-notification-action"));
+  const original = controls.map((item) => item.getAttribute("aria-disabled"));
+  let spinner = null;
+  let busy = false;
+  let signalled = false;
+  const restore = () => {
+    if (busy) {
+      busy = false;
+      controls.forEach((item, index) => original[index] == null ? item.removeAttribute("aria-disabled") : item.setAttribute("aria-disabled", original[index]));
+      button.removeAttribute("aria-busy");
+      spinner?.remove();
+    }
+    if (signalled) {
+      signalled = false;
+      hooks.busy(false);
+    }
+  };
+  const operation = { abort() {
+    ac.abort();
+    if (pending.get(card) === operation) {
+      pending.delete(card);
+      restore();
+    }
+  } };
+  pending.set(card, operation);
+  const finish = (result, error) => {
+    if (ac.signal.aborted || pending.get(card) !== operation) return;
+    pending.delete(card);
+    try {
+      if (card.isConnected && !card.classList.contains("is-leaving")) {
+        if (error !== void 0) hooks.error(error);
+        else hooks.complete(result !== false);
+      }
+    } finally {
+      restore();
+    }
+  };
+  try {
+    signalled = true;
+    hooks.busy(true);
+    const result = action(ac.signal);
+    if (result && typeof result.then === "function") {
+      busy = true;
+      controls.forEach((item) => item.setAttribute("aria-disabled", "true"));
+      button.setAttribute("aria-busy", "true");
+      let label = button.querySelector(".icen-feedback-action-label");
+      if (!label) {
+        label = document.createElement("span");
+        label.className = "icen-feedback-action-label";
+        while (button.firstChild) label.append(button.firstChild);
+        button.append(label);
+      }
+      spinner = document.createElement("span");
+      spinner.className = "icen-feedback-action-spinner";
+      spinner.setAttribute("aria-hidden", "true");
+      spinner.append(createIcon("spinner"));
+      button.append(spinner);
+      void Promise.resolve(result).then((value) => finish(value), (error) => finish(false, error ?? new Error("Action rejected")));
+    } else finish(result);
+  } catch (error) {
+    finish(false, error ?? new Error("Action failed"));
+  }
+}
+function setFeedbackError(host, message) {
+  if (typeof document === "undefined") return;
+  let error = host.querySelector(":scope > .icen-feedback-error");
+  if (!message) {
+    error?.remove();
+    return;
+  }
+  if (!error) {
+    error = document.createElement("span");
+    error.className = "icen-feedback-error";
+    error.setAttribute("role", "alert");
+    host.append(error);
+  }
+  setFeedbackText(error, message);
+}
+function setFeedbackText(host, value) {
+  if (typeof document === "undefined") return;
+  const text = document.createElement("bdi");
+  text.textContent = value;
+  host.replaceChildren(text);
+}
+var origins = /* @__PURE__ */ new WeakMap();
+function rememberFeedbackOrigin(card) {
+  if (typeof document === "undefined") return;
+  const focused = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+  const previous = focused?.closest(".icen-toast,.icen-notification");
+  const chain = [...focused ? [focused] : [], ...previous ? origins.get(previous) ?? [] : []];
+  origins.set(card, [...new Set(chain)].filter((item) => item.isConnected));
+}
+function restoreFeedbackFocus(card) {
+  if (typeof document === "undefined") return;
+  const origin = origins.get(card)?.find((item) => item.isConnected && !item.closest("[hidden],[inert],.is-leaving") && !item.matches(':disabled,[aria-disabled="true"]'));
+  if (card.contains(document.activeElement)) origin?.focus({ preventScroll: true });
+}
+export {
+  cancelFeedbackAction,
+  createFeedbackClock,
+  rememberFeedbackOrigin,
+  restoreFeedbackFocus,
+  runFeedbackAction,
+  setFeedbackError,
+  setFeedbackText
+};

package/dist/behaviors/focus.d.mts

@@ -0,0 +1,8 @@
+/** Shared native focus contract. Geometry-free visibility checks also include
+ * fixed-position controls, which offsetParent incorrectly excludes. */
+declare const FOCUSABLE = "button, [href], input:not([type=\"hidden\"]), select, textarea, icen-input, icen-select, icen-textarea, [tabindex], [contenteditable]:not([contenteditable=\"false\"]), audio[controls], video[controls], details>summary";
+/** Availability also applies to intentionally programmatic tabindex=-1 targets. */
+declare function isAvailableForFocus(el: HTMLElement): boolean;
+declare function focusableWithin(root: ParentNode): HTMLElement[];
+
+export { FOCUSABLE, focusableWithin, isAvailableForFocus };