@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/command-palette.d.mts

@@ -1,8 +1,42 @@
-/** 打开指定 id 的命令面板。 */
-declare function openCommandPalette(id: string): void;
-/** 关闭指定 id 的命令面板（backdrop 已被外部移除时也照常复位状态/监听/滚动锁）。 */
+/** 编程命令条目（openCommandPalette 的 opts.items 元素类型）。 */
+interface CommandPaletteCommand {
+    /** 条目名（.command-palette-item-label，textContent 渲染） */
+    label: string;
+    /** 副标题（.command-palette-item-hint） */
+    hint?: string;
+    /** 额外搜索关键字（data-command-palette-keyword） */
+    keyword?: string;
+    /** 选中回调：先派 icen:menu-select，再执行本回调 */
+    onSelect?: () => void;
+    /** 选中后保持面板打开（data-command-palette-keep-open） */
+    keepOpen?: boolean;
+    /** 附加到条目元素的自定义属性（如 data-*） */
+    attrs?: Record<string, string>;
+}
+interface CommandPaletteOpenOptions {
+    /** 编程条目：传入时重建面板条目 DOM（替换面板内全部 .command-palette-group） */
+    items?: CommandPaletteCommand[];
+    /** 覆盖默认 includes 过滤（query 为原始输入；空 query 仍视为匹配全部）。只作用于编程条目 */
+    filter?: (query: string, item: CommandPaletteCommand) => boolean;
+}
+/**
+ * 打开指定 id 的命令面板。打开成功后从 document 广播 icen:command-palette-open。
+ * opts.items 传入时重建面板条目 DOM（编程条目，onSelect 选中时调用）；
+ * opts.filter 覆盖默认 includes 过滤（仅编程条目生效）；幂等不变（同 id 重复打开 no-op）。
+ */
+declare function openCommandPalette(id: string, opts?: CommandPaletteOpenOptions): void;
+/**
+ * 关闭指定 id 的命令面板（backdrop 已被外部移除时也照常复位状态/监听/滚动锁）。
+ * 关闭已打开的面板后从 document 广播 icen:command-palette-close；
+ * 关闭未被接管打开的面板（幂等空操作路径）不派发。
+ */
 declare function closeCommandPalette(id: string): void;
-/** 初始化：委托监听触发器 / 搜索 / 外点 / 全局快捷键。 */
-declare function initCommandPalette(root?: ParentNode): void;
+/**
+ * 初始化：委托监听触发器 / 搜索 / 外点 / 全局快捷键。
+ * 返回销毁函数：摘除全部委托监听并复位幂等标记（销毁后可重新 init）；
+ * 销毁时若有面板开着会顺带关闭（复位滚动锁/监听/焦点）。
+ * 重复调用安全：已初始化时返回既有销毁函数（同一份，共享）。SSR 下返回 no-op。
+ */
+declare function initCommandPalette(root?: ParentNode): () => void;
 
-export { closeCommandPalette, initCommandPalette, openCommandPalette };
+export { type CommandPaletteCommand, type CommandPaletteOpenOptions, closeCommandPalette, initCommandPalette, openCommandPalette };

package/dist/behaviors/command-palette.mjs

@@ -1,11 +1,111 @@
+// src/behaviors/popover.ts
+var PANEL_SIZING_ATTRS = {
+  width: "data-panel-width",
+  minWidth: "data-panel-min",
+  maxWidth: "data-panel-max",
+  minHeight: "data-panel-min-height",
+  maxHeight: "data-panel-max-height"
+};
+function readPanelSizing(el) {
+  const out = {};
+  if (!el) return out;
+  for (const key of Object.keys(PANEL_SIZING_ATTRS)) {
+    const raw = el.getAttribute(PANEL_SIZING_ATTRS[key]);
+    if (raw == null) continue;
+    const n = Number(raw);
+    if (Number.isFinite(n) && n > 0) out[key] = n;
+  }
+  return out;
+}
+function applyPanelSizing(panel, sizing) {
+  if (sizing == null) {
+    panel.style.width = "";
+    panel.style.minWidth = "";
+    panel.style.maxWidth = "";
+    panel.style.minHeight = "";
+    panel.style.maxHeight = "";
+    return;
+  }
+  const vw = typeof document === "undefined" ? Number.POSITIVE_INFINITY : document.documentElement.clientWidth;
+  const fitW = (n) => Math.min(n, Math.max(80, vw - 24));
+  if (sizing.width != null) {
+    const w = fitW(sizing.width);
+    panel.style.width = `${w}px`;
+    panel.style.maxWidth = `${w}px`;
+  }
+  if (sizing.minWidth != null) panel.style.minWidth = `${fitW(sizing.minWidth)}px`;
+  if (sizing.maxWidth != null && sizing.width == null) panel.style.maxWidth = `${fitW(sizing.maxWidth)}px`;
+  if (sizing.minHeight != null) panel.style.minHeight = `${sizing.minHeight}px`;
+  if (sizing.maxHeight != null) panel.style.maxHeight = `${sizing.maxHeight}px`;
+}
+
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
+// src/behaviors/context-menu.ts
+function emitMenuSelect(source, item) {
+  emitIcen(item, "icen:menu-select", {
+    source,
+    item,
+    value: item.dataset.value ?? "",
+    /* 优先专用 label 子元素（避开快捷键/图标文本混入），无则退整项文本 */
+    label: (item.querySelector(".menu-item-label, .command-item-label")?.textContent ?? item.textContent ?? "").trim().slice(0, 80)
+  });
+}
+
+// src/behaviors/modal.ts
+var FOCUSABLE = 'button:not([disabled]), [href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"]), [contenteditable]:not([contenteditable="false"]), audio, video, details>summary';
+
 // src/behaviors/command-palette.ts
-var FOCUSABLE = 'button:not([disabled]), [href], input:not([disabled]), [tabindex]:not([tabindex="-1"])';
 var openId = null;
 var restoreFocusTo = null;
 var prevBodyOverflow = "";
 var keyHandler = null;
 var globalKeyHandler = null;
-var initialized = false;
+var teardown = null;
+var programmaticCommands = /* @__PURE__ */ new WeakMap();
+var customFilter = null;
+function buildCommandItems(panel, commands) {
+  const body = panel.querySelector(".command-palette-body");
+  if (!body) return;
+  body.querySelectorAll(".command-palette-group").forEach((g) => g.remove());
+  const group = document.createElement("div");
+  group.className = "command-palette-group";
+  for (const cmd of commands) group.appendChild(buildCommandItem(cmd));
+  const empty = body.querySelector(".command-palette-empty");
+  if (empty) body.insertBefore(group, empty);
+  else body.appendChild(group);
+}
+function buildCommandItem(cmd) {
+  const btn = document.createElement("button");
+  btn.type = "button";
+  btn.className = "command-palette-item";
+  const label = document.createElement("span");
+  label.className = "command-palette-item-label";
+  label.textContent = cmd.label;
+  btn.appendChild(label);
+  if (cmd.hint) {
+    const hint = document.createElement("span");
+    hint.className = "command-palette-item-hint";
+    hint.textContent = cmd.hint;
+    btn.appendChild(hint);
+  }
+  if (cmd.keyword) btn.setAttribute("data-command-palette-keyword", cmd.keyword);
+  if (cmd.keepOpen) btn.setAttribute("data-command-palette-keep-open", "");
+  if (cmd.attrs) {
+    for (const [name, value] of Object.entries(cmd.attrs)) btn.setAttribute(name, value);
+  }
+  programmaticCommands.set(btn, cmd);
+  btn.addEventListener("click", () => {
+    emitMenuSelect(btn.closest(".command-palette") ?? btn, btn);
+    cmd.onSelect?.();
+  });
+  return btn;
+}
 function findBackdrop(id) {
   return document.querySelector(
     `.command-palette-backdrop[data-command-palette="${CSS.escape(id)}"]`
@@ -34,10 +134,16 @@ function filterPanel(panel, query) {
   let visibleCount = 0;
   panel.querySelectorAll(".command-palette-item").forEach((item) => {
     if (isDisabledItem(item)) return;
-    const label = (item.querySelector(".command-palette-item-label")?.textContent ?? "").toLowerCase();
-    const hint = (item.querySelector(".command-palette-item-hint")?.textContent ?? "").toLowerCase();
-    const keyword = (item.dataset.commandPaletteKeyword ?? "").toLowerCase();
-    const match = !q || label.includes(q) || hint.includes(q) || keyword.includes(q);
+    const def = programmaticCommands.get(item);
+    let match;
+    if (def && customFilter) {
+      match = !q || customFilter(query, def);
+    } else {
+      const label = (item.querySelector(".command-palette-item-label")?.textContent ?? "").toLowerCase();
+      const hint = (item.querySelector(".command-palette-item-hint")?.textContent ?? "").toLowerCase();
+      const keyword = (item.dataset.commandPaletteKeyword ?? "").toLowerCase();
+      match = !q || label.includes(q) || hint.includes(q) || keyword.includes(q);
+    }
     item.hidden = !match;
     item.classList.remove("is-active");
     if (match) visibleCount++;
@@ -52,7 +158,7 @@ function filterPanel(panel, query) {
   if (empty) empty.hidden = visibleCount !== 0;
   if (visibleCount > 0) setActive(panel, 0);
 }
-function openCommandPalette(id) {
+function openCommandPalette(id, opts) {
   if (typeof document === "undefined") return;
   if (openId === id) return;
   if (openId) closeCommandPalette(openId);
@@ -63,6 +169,9 @@ function openCommandPalette(id) {
   }
   const panel = backdrop.querySelector(".command-palette");
   if (!panel) return;
+  applyPanelSizing(panel, readPanelSizing(backdrop));
+  customFilter = opts?.filter ?? null;
+  if (opts?.items) buildCommandItems(panel, opts.items);
   if (backdrop.parentElement !== document.body) document.body.appendChild(backdrop);
   restoreFocusTo = document.activeElement instanceof HTMLElement ? document.activeElement : null;
   openId = id;
@@ -96,6 +205,7 @@ function openCommandPalette(id) {
       const active = panel.querySelector(".command-palette-item.is-active");
       if (active && !isDisabledItem(active)) {
         e.preventDefault();
+        if (!programmaticCommands.has(active)) emitMenuSelect(panel, active);
         active.click();
       }
       return;
@@ -112,6 +222,7 @@ function openCommandPalette(id) {
     }
   };
   window.addEventListener("keydown", keyHandler);
+  emitIcen(document, "icen:command-palette-open", {});
 }
 function closeCommandPalette(id) {
   if (typeof document === "undefined") return;
@@ -126,15 +237,17 @@ function closeCommandPalette(id) {
   document.body.style.overflow = prevBodyOverflow;
   if (restoreFocusTo && restoreFocusTo.isConnected) restoreFocusTo.focus();
   restoreFocusTo = null;
+  emitIcen(document, "icen:command-palette-close", {});
 }
 function initCommandPalette(root) {
-  if (typeof document === "undefined") return;
-  if (typeof window === "undefined") return;
+  if (typeof document === "undefined") return () => {
+  };
+  if (typeof window === "undefined") return () => {
+  };
   const scope = root ?? document;
   scope.querySelectorAll("[data-command-palette-open]").forEach((el) => el.setAttribute("aria-haspopup", "dialog"));
-  if (initialized) return;
-  initialized = true;
-  document.addEventListener("click", (e) => {
+  if (teardown) return teardown;
+  const onClick = (e) => {
     const target = e.target instanceof Element ? e.target : null;
     if (!target) return;
     const opener = target.closest("[data-command-palette-open]");
@@ -146,6 +259,8 @@ function initCommandPalette(root) {
     if (item) {
       const backdrop = item.closest("[data-command-palette]");
       if (backdrop?.dataset.commandPalette) {
+        const panelEl = item.closest(".command-palette");
+        if (panelEl && !programmaticCommands.has(item)) emitMenuSelect(panelEl, item);
         if (!item.hasAttribute("data-command-palette-keep-open")) {
           closeCommandPalette(backdrop.dataset.commandPalette);
         }
@@ -155,14 +270,16 @@ function initCommandPalette(root) {
     if (target instanceof HTMLElement && target.classList.contains("command-palette-backdrop") && target.dataset.commandPalette) {
       closeCommandPalette(target.dataset.commandPalette);
     }
-  });
-  document.addEventListener("input", (e) => {
+  };
+  document.addEventListener("click", onClick);
+  const onInput = (e) => {
     if (!(e.target instanceof HTMLElement)) return;
     if (!e.target.matches(".command-palette-input")) return;
     const backdrop = e.target.closest("[data-command-palette]");
     const panel = backdrop?.querySelector(".command-palette");
     if (panel) filterPanel(panel, e.target.value);
-  });
+  };
+  document.addEventListener("input", onInput);
   globalKeyHandler = (e) => {
     if (!(e.metaKey || e.ctrlKey)) return;
     const key = e.key.toLowerCase();
@@ -181,6 +298,17 @@ function initCommandPalette(root) {
     }
   };
   window.addEventListener("keydown", globalKeyHandler);
+  teardown = () => {
+    document.removeEventListener("click", onClick);
+    document.removeEventListener("input", onInput);
+    if (globalKeyHandler) {
+      window.removeEventListener("keydown", globalKeyHandler);
+      globalKeyHandler = null;
+    }
+    if (openId) closeCommandPalette(openId);
+    teardown = null;
+  };
+  return teardown;
 }
 export {
   closeCommandPalette,

package/dist/behaviors/context-menu.d.mts

@@ -1,3 +1,5 @@
+import { PanelSizing } from './popover.js';
+
 interface ContextMenuEntry {
     label: string;
     subLabel?: string;
@@ -21,16 +23,31 @@ interface ContextMenuOptions {
     /** 替换内置默认菜单（未命中任何注册 id 时使用） */
     items?: ContextMenuItem[];
 }
+
+/** 菜单选中统一事件（dropdown / context-menu / command-palette 同一契约）。
+ *  本模块为唯一定义点，dropdown / command-palette 改为 import 复用（收敛三份逐字拷贝）。 */
+declare function emitMenuSelect(source: HTMLElement, item: HTMLElement): void;
 /** 注册指定 id 的右键菜单项（对应 DOM 中的 [data-context-menu="id"]）。 */
 declare function registerContextMenu(id: string, items: ContextMenuItem[]): void;
-/** 在 (x, y) 打开右键菜单（视口边缘自动翻转并 clamp）。 */
-declare function openContextMenu(x: number, y: number, items: ContextMenuItem[]): void;
+/** 在 (x, y) 打开右键菜单（视口边缘自动翻转并 clamp）。
+    尺寸走全库统一 PanelSizing 契约：opts.sizing 直接传入（面板无固定宿主元素，
+    由调用方从其根元素 readPanelSizing 读入，如 datatable 行右键）。 */
+declare function openContextMenu(x: number, y: number, items: ContextMenuItem[], opts?: {
+    sizing?: PanelSizing;
+}): void;
 /** 关闭当前右键菜单（未打开时为 no-op）。 */
+declare function closeContextMenu(): void;
+/**
+ * @deprecated 已更名 closeContextMenu（与全库浮层 close* 命名对齐）；
+ * 本别名仅为兼容保留，下个大版本删除。
+ */
 declare function closeMenu(): void;
 /**
  * 启动全局右键菜单（重复调用安全）。
  * opts.items 提供时替换内置默认菜单。
+ * 返回销毁函数：摘除 init 注册的全部 document 监听并复位幂等标记（销毁后可重新
+ * init）；销毁时若有菜单开着会顺带关闭（摘净 openContextMenu 挂的浮层监听）。
  */
-declare function initContextMenu(opts?: ContextMenuOptions): void;
+declare function initContextMenu(opts?: ContextMenuOptions): () => void;
 
-export { type ContextMenuEntry, type ContextMenuHeader, type ContextMenuItem, type ContextMenuOptions, type ContextMenuSeparator, closeMenu, initContextMenu, openContextMenu, registerContextMenu };
+export { type ContextMenuEntry, type ContextMenuHeader, type ContextMenuItem, type ContextMenuOptions, type ContextMenuSeparator, closeContextMenu, closeMenu, emitMenuSelect, initContextMenu, openContextMenu, registerContextMenu };

package/dist/behaviors/context-menu.mjs

@@ -1,8 +1,65 @@
+// src/behaviors/popover.ts
+var PANEL_SIZING_ATTRS = {
+  width: "data-panel-width",
+  minWidth: "data-panel-min",
+  maxWidth: "data-panel-max",
+  minHeight: "data-panel-min-height",
+  maxHeight: "data-panel-max-height"
+};
+function readPanelSizing(el) {
+  const out = {};
+  if (!el) return out;
+  for (const key of Object.keys(PANEL_SIZING_ATTRS)) {
+    const raw = el.getAttribute(PANEL_SIZING_ATTRS[key]);
+    if (raw == null) continue;
+    const n = Number(raw);
+    if (Number.isFinite(n) && n > 0) out[key] = n;
+  }
+  return out;
+}
+function applyPanelSizing(panel2, sizing) {
+  if (sizing == null) {
+    panel2.style.width = "";
+    panel2.style.minWidth = "";
+    panel2.style.maxWidth = "";
+    panel2.style.minHeight = "";
+    panel2.style.maxHeight = "";
+    return;
+  }
+  const vw = typeof document === "undefined" ? Number.POSITIVE_INFINITY : document.documentElement.clientWidth;
+  const fitW = (n) => Math.min(n, Math.max(80, vw - 24));
+  if (sizing.width != null) {
+    const w = fitW(sizing.width);
+    panel2.style.width = `${w}px`;
+    panel2.style.maxWidth = `${w}px`;
+  }
+  if (sizing.minWidth != null) panel2.style.minWidth = `${fitW(sizing.minWidth)}px`;
+  if (sizing.maxWidth != null && sizing.width == null) panel2.style.maxWidth = `${fitW(sizing.maxWidth)}px`;
+  if (sizing.minHeight != null) panel2.style.minHeight = `${sizing.minHeight}px`;
+  if (sizing.maxHeight != null) panel2.style.maxHeight = `${sizing.maxHeight}px`;
+}
+
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/context-menu.ts
 var LONG_PRESS_DELAY = 520;
 var LONG_PRESS_MOVE_LIMIT = 12;
 var FLIP_MARGIN = 10;
 var CLAMP_MARGIN = 8;
+function emitMenuSelect(source, item) {
+  emitIcen(item, "icen:menu-select", {
+    source,
+    item,
+    value: item.dataset.value ?? "",
+    /* 优先专用 label 子元素（避开快捷键/图标文本混入），无则退整项文本 */
+    label: (item.querySelector(".menu-item-label, .command-item-label")?.textContent ?? item.textContent ?? "").trim().slice(0, 80)
+  });
+}
 var registry = /* @__PURE__ */ new Map();
 var fallbackItems = null;
 var initialized = false;
@@ -44,7 +101,7 @@ function resolveItems(target) {
 function isEditable(target) {
   return Boolean(target?.closest('input, textarea, [contenteditable="true"]'));
 }
-function buildItem(item) {
+function buildItem(item, menuPanel) {
   if ("type" in item && item.type === "separator") {
     const sep = document.createElement("div");
     sep.className = "menu-separator";
@@ -94,19 +151,21 @@ function buildItem(item) {
     btn.appendChild(shortcut);
   }
   btn.addEventListener("click", () => {
+    emitMenuSelect(menuPanel, btn);
     entry.onClick?.();
-    closeMenu();
+    closeContextMenu();
   });
   return btn;
 }
-function openContextMenu(x, y, items) {
+function openContextMenu(x, y, items, opts) {
   if (typeof document === "undefined") return;
-  closeMenu();
+  closeContextMenu();
   panel = document.createElement("div");
   panel.className = "menu menu--context";
   panel.setAttribute("role", "menu");
   panel.style.visibility = "hidden";
-  for (const item of items) panel.appendChild(buildItem(item));
+  applyPanelSizing(panel, opts?.sizing ?? {});
+  for (const item of items) panel.appendChild(buildItem(item, panel));
   document.body.appendChild(panel);
   const rect = panel.getBoundingClientRect();
   const vw = window.innerWidth;
@@ -117,6 +176,7 @@ function openContextMenu(x, y, items) {
   if (y + rect.height > vh - FLIP_MARGIN) ny = y - rect.height;
   if (nx < CLAMP_MARGIN) nx = CLAMP_MARGIN;
   if (ny < CLAMP_MARGIN) ny = CLAMP_MARGIN;
+  panel.dataset.side = ny < y ? "top" : "bottom";
   panel.style.left = `${nx}px`;
   panel.style.top = `${ny}px`;
   panel.style.visibility = "";
@@ -131,7 +191,7 @@ function openContextMenu(x, y, items) {
   window.addEventListener("resize", onCloseSignal);
   window.addEventListener("keydown", onKeyDown);
 }
-function closeMenu() {
+function closeContextMenu() {
   if (!panel) return;
   panel.remove();
   panel = null;
@@ -142,6 +202,9 @@ function closeMenu() {
   window.removeEventListener("resize", onCloseSignal);
   window.removeEventListener("keydown", onKeyDown);
 }
+function closeMenu() {
+  closeContextMenu();
+}
 function setFocused(next) {
   if (!panel || focusableItems.length === 0) return;
   focusedIndex = (next % focusableItems.length + focusableItems.length) % focusableItems.length;
@@ -150,20 +213,20 @@ function setFocused(next) {
 function onOutsidePointerDown(e) {
   if (!panel) return;
   const target = e.target;
-  if (!(target instanceof Node) || !panel.contains(target)) closeMenu();
+  if (!(target instanceof Node) || !panel.contains(target)) closeContextMenu();
 }
 function onScrollSignal(e) {
   if (panel && e.target instanceof Node && panel.contains(e.target)) return;
-  closeMenu();
+  closeContextMenu();
 }
 function onCloseSignal() {
-  closeMenu();
+  closeContextMenu();
 }
 function onKeyDown(e) {
   if (!panel) return;
   if (e.key === "Escape") {
     e.preventDefault();
-    closeMenu();
+    closeContextMenu();
     return;
   }
   if (focusableItems.length === 0) return;
@@ -184,43 +247,64 @@ function clearLongPress() {
   longPress = null;
 }
 function openForTarget(target, x, y) {
-  openContextMenu(x, y, resolveItems(target));
+  openContextMenu(
+    x,
+    y,
+    resolveItems(target),
+    { sizing: readPanelSizing(target instanceof Element ? target.closest("[data-context-menu]") ?? target : target) }
+  );
+}
+function onContextMenu(e) {
+  const target = e.target instanceof Element ? e.target : null;
+  if (isEditable(target)) return;
+  e.preventDefault();
+  openForTarget(target, e.clientX, e.clientY);
+}
+function onLongPressStart(e) {
+  if (e.pointerType !== "touch") return;
+  const target = e.target instanceof Element ? e.target : null;
+  if (!target || isEditable(target)) return;
+  clearLongPress();
+  const startX = e.clientX;
+  const startY = e.clientY;
+  const timer = window.setTimeout(() => {
+    longPress = null;
+    openForTarget(target, startX, startY);
+  }, LONG_PRESS_DELAY);
+  longPress = { timer, x: startX, y: startY, target };
+}
+function onLongPressMove(e) {
+  if (!longPress) return;
+  if (Math.hypot(e.clientX - longPress.x, e.clientY - longPress.y) > LONG_PRESS_MOVE_LIMIT) {
+    clearLongPress();
+  }
 }
 function initContextMenu(opts = {}) {
-  if (typeof document === "undefined") return;
+  if (typeof document === "undefined") return () => {
+  };
   if (opts.items) fallbackItems = opts.items;
-  if (initialized) return;
+  if (initialized) return () => {
+  };
   initialized = true;
-  document.addEventListener("contextmenu", (e) => {
-    const target = e.target instanceof Element ? e.target : null;
-    if (isEditable(target)) return;
-    e.preventDefault();
-    openForTarget(target, e.clientX, e.clientY);
-  });
-  document.addEventListener("pointerdown", (e) => {
-    if (e.pointerType !== "touch") return;
-    const target = e.target instanceof Element ? e.target : null;
-    if (!target || isEditable(target)) return;
-    clearLongPress();
-    const startX = e.clientX;
-    const startY = e.clientY;
-    const timer = window.setTimeout(() => {
-      longPress = null;
-      openForTarget(target, startX, startY);
-    }, LONG_PRESS_DELAY);
-    longPress = { timer, x: startX, y: startY, target };
-  });
-  document.addEventListener("pointermove", (e) => {
-    if (!longPress) return;
-    if (Math.hypot(e.clientX - longPress.x, e.clientY - longPress.y) > LONG_PRESS_MOVE_LIMIT) {
-      clearLongPress();
-    }
-  });
+  document.addEventListener("contextmenu", onContextMenu);
+  document.addEventListener("pointerdown", onLongPressStart);
+  document.addEventListener("pointermove", onLongPressMove);
   document.addEventListener("pointerup", clearLongPress);
   document.addEventListener("pointercancel", clearLongPress);
+  return () => {
+    document.removeEventListener("contextmenu", onContextMenu);
+    document.removeEventListener("pointerdown", onLongPressStart);
+    document.removeEventListener("pointermove", onLongPressMove);
+    document.removeEventListener("pointerup", clearLongPress);
+    document.removeEventListener("pointercancel", clearLongPress);
+    closeContextMenu();
+    initialized = false;
+  };
 }
 export {
+  closeContextMenu,
   closeMenu,
+  emitMenuSelect,
   initContextMenu,
   openContextMenu,
   registerContextMenu

package/dist/behaviors/controls.d.mts

@@ -0,0 +1,59 @@
+export { initInput } from './input.js';
+
+/**
+ * 接线开关 / 勾选框 / 单选（document 级委托，页面级一次即可，重复调用幂等）。
+ * 点击 / Space / Enter 驱动 aria-checked（checkbox 三态循环含初始半选例外；
+ * radio 组内互斥），派 icen:switch-change / icen:check-change。
+ * 返回销毁函数：摘除委托并复位幂等标记，销毁后可重新 initSwitch。SSR 下返回 no-op。
+ */
+declare const initSwitch: () => void;
+/**
+ * 接线数字步进器（document 级委托，重复调用幂等）。
+ * .stepper 内 .stepper-btn[data-step] 点击 → .stepper-input 数值 ±step 并 clamp 到
+ * min/max，派 icen:stepper-change { el: .stepper 根, value, delta }（触界 delta 为 0）。
+ * 返回销毁函数：摘除委托并复位幂等标记，销毁后可重新 initStepper。SSR 下返回 no-op。
+ */
+declare const initStepper: () => void;
+/**
+ * 接线分段控件（document 级委托，重复调用幂等）。
+ * .segmented 内 .segmented-item 点击 → 组内 .is-active 互斥 + role="radio" 项同步
+ * aria-checked，派 icen:segmented-change { el: 容器, value: data-value ?? String(index), index }。
+ * 返回销毁函数：摘除委托并复位幂等标记，销毁后可重新 initSegmented。SSR 下返回 no-op。
+ */
+declare const initSegmented: () => void;
+/**
+ * 接线可点击步骤条（document 级委托，重复调用幂等）。
+ * .steps 内 .step[role="button"] 点击（或聚焦后 Space / Enter）→ 激活点位移
+ * （目标 step--process + .is-active，之前 finish、之后 wait），派
+ * icen:step-change { step, index }。返回销毁函数：摘除委托并复位幂等标记，
+ * 销毁后可重新 initSteps。SSR 下返回 no-op。
+ */
+declare const initSteps: () => void;
+/**
+ * 接线星级评分（document 级委托，重复调用幂等）。
+ * .rating 内 .rating-star 点击 → 该星及之前 .is-filled（重建选中态，清除残留
+ * is-half），.rating-value 存在时回写数值（textContent），派
+ * icen:rating-change { el: 容器, value }（1 起算）；.rating--readonly 不接线。
+ * 返回销毁函数：摘除委托并复位幂等标记，销毁后可重新 initRating。SSR 下返回 no-op。
+ */
+declare const initRating: () => void;
+/**
+ * 接线分页（document 级委托，重复调用幂等）。
+ * .pagination 内 .page-btn 点击 → .is-active / aria-current 位移并派
+ * icen:page-change { page }；页码取 data-page > 按钮文本数字 > 序号，上下页按钮按
+ * aria-label / data-dir 推断方向（当前页 ±1，目标钮被省略号折叠时只派事件）。
+ * 总页数与省略号折叠策略归消费方。返回销毁函数：摘除委托并复位幂等标记，
+ * 销毁后可重新 initPagination。SSR 下返回 no-op。
+ */
+declare const initPagination: () => void;
+/**
+ * 接线静态表排序（document 级委托，重复调用幂等）。
+ * th[data-sort] 点击 → asc→desc→无 循环（data-sort 属性即方向载体，列 key 首次
+ * 交互转存 data-sort-key，中性态还原；同表其他表头复位），派
+ * icen:sort-change { th, key, dir }。行数据重排归消费方（ datatable 场景用
+ * behaviors/datatable 的 icen:table-sort-change）。返回销毁函数：摘除委托并
+ * 复位幂等标记，销毁后可重新 initTableSort。SSR 下返回 no-op。
+ */
+declare const initTableSort: () => void;
+
+export { initPagination, initRating, initSegmented, initStepper, initSteps, initSwitch, initTableSort };