@icen.ai/ui 0.5.0 → 0.8.1

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

@@ -0,0 +1,42 @@
+/** 编程命令条目（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;
+/**
+ * 初始化：委托监听触发器 / 搜索 / 外点 / 全局快捷键。
+ * 返回销毁函数：摘除全部委托监听并复位幂等标记（销毁后可重新 init）；
+ * 销毁时若有面板开着会顺带关闭（复位滚动锁/监听/焦点）。
+ * 重复调用安全：已初始化时返回既有销毁函数（同一份，共享）。SSR 下返回 no-op。
+ */
+declare function initCommandPalette(root?: ParentNode): () => void;
+
+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)}"]`
@@ -13,7 +113,9 @@ function findBackdrop(id) {
 }
 function getVisibleItems(panel) {
   return Array.from(
-    panel.querySelectorAll(".command-palette-item:not([hidden]):not([disabled])")
+    panel.querySelectorAll(
+      '.command-palette-item:not([hidden]):not([disabled]):not([aria-disabled="true"])'
+    )
   ).filter((el) => el.offsetParent !== null || el.getClientRects().length > 0);
 }
 function isDisabledItem(el) {
@@ -32,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++;
@@ -50,14 +158,20 @@ 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);
   const backdrop = findBackdrop(id);
-  if (!backdrop) return;
+  if (!backdrop) {
+    console.warn(`[@icen.ai/ui] command-palette: \u672A\u627E\u5230 data-command-palette="${id}" \u7684 .command-palette-backdrop\uFF0C\u5DF2\u8DF3\u8FC7\u6253\u5F00`);
+    return;
+  }
   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;
@@ -91,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;
@@ -107,12 +222,12 @@ function openCommandPalette(id) {
     }
   };
   window.addEventListener("keydown", keyHandler);
+  emitIcen(document, "icen:command-palette-open", {});
 }
 function closeCommandPalette(id) {
   if (typeof document === "undefined") return;
   const backdrop = findBackdrop(id);
-  if (!backdrop) return;
-  backdrop.hidden = true;
+  if (backdrop) backdrop.hidden = true;
   if (openId !== id) return;
   openId = null;
   if (keyHandler) {
@@ -122,14 +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 = document) {
-  if (typeof document === "undefined") return;
-  if (typeof window === "undefined") return;
-  root.querySelectorAll("[data-command-palette-open]").forEach((el) => el.setAttribute("aria-haspopup", "dialog"));
-  if (initialized) return;
-  initialized = true;
-  document.addEventListener("click", (e) => {
+function initCommandPalette(root) {
+  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 (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]");
@@ -141,6 +259,8 @@ function initCommandPalette(root = document) {
     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);
         }
@@ -150,25 +270,45 @@ function initCommandPalette(root = document) {
     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) && (e.key === "k" || e.key === "K")) {
+    if (!(e.metaKey || e.ctrlKey)) return;
+    const key = e.key.toLowerCase();
+    const palettes = document.querySelectorAll(
+      ".command-palette-backdrop[data-command-palette]"
+    );
+    for (const backdrop of Array.from(palettes)) {
+      const paletteKey = (backdrop.dataset.commandPaletteKey ?? "k").toLowerCase();
+      if (paletteKey !== key) continue;
+      const id = backdrop.dataset.commandPalette;
+      if (!id) continue;
       e.preventDefault();
-      const first = document.querySelector(".command-palette-backdrop[data-command-palette]");
-      if (first?.dataset.commandPalette) {
-        if (openId === first.dataset.commandPalette) closeCommandPalette(openId);
-        else openCommandPalette(first.dataset.commandPalette);
-      }
+      if (openId === id) closeCommandPalette(id);
+      else openCommandPalette(id);
+      return;
     }
   };
   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

@@ -0,0 +1,53 @@
+import { PanelSizing } from './popover.js';
+
+interface ContextMenuEntry {
+    label: string;
+    subLabel?: string;
+    /** 可信 svg 字符串（唯一走 innerHTML 的字段） */
+    icon?: string;
+    shortcut?: string;
+    danger?: boolean;
+    disabled?: boolean;
+    onClick?: () => void;
+}
+interface ContextMenuSeparator {
+    type: 'separator';
+}
+interface ContextMenuHeader {
+    type: 'header';
+    label: string;
+    description?: string;
+}
+type ContextMenuItem = ContextMenuEntry | ContextMenuSeparator | ContextMenuHeader;
+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）。
+    尺寸走全库统一 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;
+
+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 = "";
@@ -127,21 +187,24 @@ function openContextMenu(x, y, items) {
     setFocused(0);
   });
   document.addEventListener("pointerdown", onOutsidePointerDown, true);
-  document.addEventListener("scroll", onCloseSignal, true);
+  document.addEventListener("scroll", onScrollSignal, true);
   window.addEventListener("resize", onCloseSignal);
   window.addEventListener("keydown", onKeyDown);
 }
-function closeMenu() {
+function closeContextMenu() {
   if (!panel) return;
   panel.remove();
   panel = null;
   focusableItems = [];
   focusedIndex = -1;
   document.removeEventListener("pointerdown", onOutsidePointerDown, true);
-  document.removeEventListener("scroll", onCloseSignal, true);
+  document.removeEventListener("scroll", onScrollSignal, true);
   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,16 +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;
+  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;
@@ -180,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