@icen.ai/ui 0.9.0 → 0.11.0

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

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

package/dist/behaviors/command-palette.mjs

@@ -1,10 +1,32 @@
 // src/behaviors/popover.ts
+function revealPopoverItem(item, scrollport, opts = {}) {
+  if (typeof document === "undefined") return;
+  if (opts.focus) item.focus({ preventScroll: true });
+  const rect = item.getBoundingClientRect(), bounds = scrollport.getBoundingClientRect();
+  const style = getComputedStyle(scrollport);
+  const inset = (value, extent) => {
+    const amount = Number.parseFloat(value) || 0;
+    return value.endsWith("%") ? amount * extent / 100 : amount;
+  };
+  if (opts.axis !== "inline") {
+    const top = bounds.top + scrollport.clientTop + inset(style.scrollPaddingTop, scrollport.clientHeight);
+    const bottom = bounds.top + scrollport.clientTop + scrollport.clientHeight - inset(style.scrollPaddingBottom, scrollport.clientHeight);
+    if (rect.top < top) scrollport.scrollTop -= top - rect.top;
+    else if (rect.bottom > bottom) scrollport.scrollTop += rect.bottom - bottom;
+  }
+  if (opts.axis === "inline" || opts.axis === "both") {
+    const left = bounds.left + scrollport.clientLeft + inset(style.scrollPaddingLeft, scrollport.clientWidth);
+    const right = bounds.left + scrollport.clientLeft + scrollport.clientWidth - inset(style.scrollPaddingRight, scrollport.clientWidth);
+    if (rect.left < left) scrollport.scrollLeft -= left - rect.left;
+    else if (rect.right > right) scrollport.scrollLeft += rect.right - right;
+  }
+}
 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"
+  width: "data-icen-panel-width",
+  minWidth: "data-icen-panel-min",
+  maxWidth: "data-icen-panel-max",
+  minHeight: "data-icen-panel-min-height",
+  maxHeight: "data-icen-panel-max-height"
 };
 function readPanelSizing(el) {
   const out = {};
@@ -51,14 +73,31 @@ function emitMenuSelect(source, item) {
   emitIcen(item, "icen:menu-select", {
     source,
     item,
-    value: item.dataset.value ?? "",
+    value: item.dataset.icenValue ?? "",
     /* 优先专用 label 子元素（避开快捷键/图标文本混入），无则退整项文本 */
-    label: (item.querySelector(".menu-item-label, .command-item-label")?.textContent ?? item.textContent ?? "").trim().slice(0, 80)
+    label: (item.querySelector(".icen-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/focus.ts
+var 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';
+function isAvailableForFocus(el) {
+  if (typeof document === "undefined" || !el.isConnected || el.matches(':disabled,[disabled],[aria-disabled="true"]')) return false;
+  if (el.closest('[hidden],[inert],[aria-hidden="true"]')) return false;
+  const closed = el.closest("details:not([open])");
+  if (closed && !closed.querySelector(":scope > summary")?.contains(el)) return false;
+  if (["hidden", "collapse"].includes(getComputedStyle(el).visibility)) return false;
+  for (let ancestor = el; ancestor; ancestor = ancestor.parentElement) {
+    if (getComputedStyle(ancestor).display === "none") return false;
+  }
+  return true;
+}
+function focusableWithin(root) {
+  if (typeof document === "undefined") return [];
+  return Array.from(root.querySelectorAll(FOCUSABLE)).filter((el) => {
+    return !(el.hasAttribute("tabindex") && el.tabIndex < 0) && isAvailableForFocus(el);
+  });
+}
 
 // src/behaviors/command-palette.ts
 var openId = null;
@@ -67,54 +106,56 @@ var prevBodyOverflow = "";
 var keyHandler = null;
 var globalKeyHandler = null;
 var teardown = null;
+var closingState = null;
+var CP_EXIT_FALLBACK_MS = 240;
 var programmaticCommands = /* @__PURE__ */ new WeakMap();
 var customFilter = null;
 function buildCommandItems(panel, commands) {
-  const body = panel.querySelector(".command-palette-body");
+  const body = panel.querySelector(".icen-command-palette-body");
   if (!body) return;
-  body.querySelectorAll(".command-palette-group").forEach((g) => g.remove());
+  body.querySelectorAll(".icen-command-palette-group").forEach((g) => g.remove());
   const group = document.createElement("div");
-  group.className = "command-palette-group";
+  group.className = "icen-command-palette-group";
   for (const cmd of commands) group.appendChild(buildCommandItem(cmd));
-  const empty = body.querySelector(".command-palette-empty");
+  const empty = body.querySelector(".icen-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";
+  btn.className = "icen-command-palette-item";
   const label = document.createElement("span");
-  label.className = "command-palette-item-label";
+  label.className = "icen-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.className = "icen-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.keyword) btn.setAttribute("data-icen-command-palette-keyword", cmd.keyword);
+  if (cmd.keepOpen) btn.setAttribute("data-icen-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);
+    emitMenuSelect(btn.closest(".icen-command-palette") ?? btn, btn);
     cmd.onSelect?.();
   });
   return btn;
 }
 function findBackdrop(id) {
   return document.querySelector(
-    `.command-palette-backdrop[data-command-palette="${CSS.escape(id)}"]`
+    `.icen-command-palette-backdrop[data-icen-command-palette="${CSS.escape(id)}"]`
   );
 }
 function getVisibleItems(panel) {
   return Array.from(
     panel.querySelectorAll(
-      '.command-palette-item:not([hidden]):not([disabled]):not([aria-disabled="true"])'
+      '.icen-command-palette-item:not([hidden]):not([disabled]):not([aria-disabled="true"])'
     )
   ).filter((el) => el.offsetParent !== null || el.getClientRects().length > 0);
 }
@@ -123,38 +164,62 @@ function isDisabledItem(el) {
 }
 function setActive(panel, idx) {
   const items = getVisibleItems(panel);
-  items.forEach((el, i) => el.classList.toggle("is-active", i === idx));
+  items.forEach((el, i) => {
+    el.classList.toggle("is-active", i === idx);
+    el.setAttribute("aria-selected", String(i === idx));
+  });
   const active = items[idx];
-  if (active && typeof active.scrollIntoView === "function") {
-    active.scrollIntoView({ block: "nearest" });
+  const input = panel.querySelector(".icen-command-palette-input");
+  if (input) {
+    if (active?.id) input.setAttribute("aria-activedescendant", active.id);
+    else input.removeAttribute("aria-activedescendant");
+  }
+  if (active) revealPopoverItem(active, panel.querySelector(".icen-command-palette-body") ?? panel);
+}
+var itemSequence = 0;
+function paintComboboxSemantics(panel) {
+  const input = panel.querySelector(".icen-command-palette-input");
+  const body = panel.querySelector(".icen-command-palette-body");
+  if (body) {
+    if (!body.id) body.id = `icen-cp-body-${++itemSequence}`;
+    body.setAttribute("role", "listbox");
+  }
+  if (input) {
+    input.setAttribute("role", "combobox");
+    input.setAttribute("aria-expanded", "true");
+    if (body?.id) input.setAttribute("aria-controls", body.id);
   }
+  panel.querySelectorAll(".icen-command-palette-item").forEach((item) => {
+    item.setAttribute("role", "option");
+    if (!item.id) item.id = `icen-cp-item-${++itemSequence}`;
+  });
 }
 function filterPanel(panel, query) {
   const q = query.trim().toLowerCase();
   let visibleCount = 0;
-  panel.querySelectorAll(".command-palette-item").forEach((item) => {
+  panel.querySelectorAll(".icen-command-palette-item").forEach((item) => {
     if (isDisabledItem(item)) return;
     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();
+      const label = (item.querySelector(".icen-command-palette-item-label")?.textContent ?? "").toLowerCase();
+      const hint = (item.querySelector(".icen-command-palette-item-hint")?.textContent ?? "").toLowerCase();
+      const keyword = (item.dataset.icenCommandPaletteKeyword ?? "").toLowerCase();
       match = !q || label.includes(q) || hint.includes(q) || keyword.includes(q);
     }
     item.hidden = !match;
     item.classList.remove("is-active");
     if (match) visibleCount++;
   });
-  panel.querySelectorAll(".command-palette-group").forEach((group) => {
-    const hasVisible = Array.from(group.querySelectorAll(".command-palette-item")).some(
+  panel.querySelectorAll(".icen-command-palette-group").forEach((group) => {
+    const hasVisible = Array.from(group.querySelectorAll(".icen-command-palette-item")).some(
       (it) => !it.hidden
     );
     group.hidden = !hasVisible;
   });
-  const empty = panel.querySelector(".command-palette-empty");
+  const empty = panel.querySelector(".icen-command-palette-empty");
   if (empty) empty.hidden = visibleCount !== 0;
   if (visibleCount > 0) setActive(panel, 0);
 }
@@ -164,10 +229,10 @@ function openCommandPalette(id, opts) {
   if (openId) closeCommandPalette(openId);
   const backdrop = findBackdrop(id);
   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`);
+    console.warn(`[@icen.ai/ui] command-palette: \u672A\u627E\u5230 data-icen-command-palette="${id}" \u7684 .command-palette-backdrop\uFF0C\u5DF2\u8DF3\u8FC7\u6253\u5F00`);
     return;
   }
-  const panel = backdrop.querySelector(".command-palette");
+  const panel = backdrop.querySelector(".icen-command-palette");
   if (!panel) return;
   applyPanelSizing(panel, readPanelSizing(backdrop));
   customFilter = opts?.filter ?? null;
@@ -175,10 +240,18 @@ function openCommandPalette(id, opts) {
   if (backdrop.parentElement !== document.body) document.body.appendChild(backdrop);
   restoreFocusTo = document.activeElement instanceof HTMLElement ? document.activeElement : null;
   openId = id;
+  if (closingState) {
+    window.clearTimeout(closingState.timer);
+    closingState.backdrop.removeEventListener("transitionend", closingState.onEnd);
+    delete closingState.backdrop.dataset.icenState;
+    if (closingState.backdrop !== backdrop) closingState.backdrop.hidden = true;
+    closingState = null;
+  }
   backdrop.hidden = false;
+  paintComboboxSemantics(panel);
   prevBodyOverflow = document.body.style.overflow;
   document.body.style.overflow = "hidden";
-  const input = panel.querySelector(".command-palette-input");
+  const input = panel.querySelector(".icen-command-palette-input");
   if (input) {
     input.value = "";
     input.focus();
@@ -187,8 +260,10 @@ function openCommandPalette(id, opts) {
   }
   filterPanel(panel, "");
   keyHandler = (e) => {
+    if (e.defaultPrevented || e.isComposing || e.keyCode === 229) return;
     if (e.key === "Escape") {
       e.preventDefault();
+      e.stopPropagation();
       closeCommandPalette(id);
       return;
     }
@@ -201,43 +276,70 @@ function openCommandPalette(id, opts) {
       setActive(panel, next);
       return;
     }
+    if (e.key === "Home" || e.key === "End") {
+      e.preventDefault();
+      const items = getVisibleItems(panel);
+      if (items.length === 0) return;
+      setActive(panel, e.key === "Home" ? 0 : items.length - 1);
+      return;
+    }
     if (e.key === "Enter") {
-      const active = panel.querySelector(".command-palette-item.is-active");
+      const active = panel.querySelector(".icen-command-palette-item.is-active");
       if (active && !isDisabledItem(active)) {
         e.preventDefault();
-        if (!programmaticCommands.has(active)) emitMenuSelect(panel, active);
         active.click();
       }
       return;
     }
     if (e.key === "Tab") {
       e.preventDefault();
-      const els = Array.from(panel.querySelectorAll(FOCUSABLE)).filter(
-        (el) => !el.hidden && el.offsetParent !== null
-      );
+      const els = focusableWithin(panel);
       if (els.length === 0) return;
       const cur = els.findIndex((el) => el === document.activeElement);
       const next = e.shiftKey ? (cur - 1 + els.length) % els.length : (cur + 1) % els.length;
       els[next]?.focus();
     }
   };
-  window.addEventListener("keydown", keyHandler);
+  window.addEventListener("keydown", keyHandler, true);
   emitIcen(document, "icen:command-palette-open", {});
 }
-function closeCommandPalette(id) {
+function closeCommandPalette(id, opts) {
   if (typeof document === "undefined") return;
   const backdrop = findBackdrop(id);
-  if (backdrop) backdrop.hidden = true;
+  if (backdrop && openId !== id) {
+    backdrop.hidden = true;
+    return;
+  }
   if (openId !== id) return;
   openId = null;
   if (keyHandler) {
-    window.removeEventListener("keydown", keyHandler);
+    window.removeEventListener("keydown", keyHandler, true);
     keyHandler = null;
   }
   document.body.style.overflow = prevBodyOverflow;
   if (restoreFocusTo && restoreFocusTo.isConnected) restoreFocusTo.focus();
   restoreFocusTo = null;
   emitIcen(document, "icen:command-palette-close", {});
+  if (!backdrop) return;
+  const calm = opts?.immediate || typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+  if (calm || !backdrop.isConnected) {
+    backdrop.hidden = true;
+    return;
+  }
+  backdrop.dataset.icenState = "closing";
+  const finalize = () => {
+    if (!closingState || closingState.backdrop !== backdrop) return;
+    window.clearTimeout(closingState.timer);
+    backdrop.removeEventListener("transitionend", closingState.onEnd);
+    closingState = null;
+    delete backdrop.dataset.icenState;
+    backdrop.hidden = true;
+  };
+  const onEnd = (event) => {
+    if (event.target === backdrop && event.propertyName === "opacity") finalize();
+  };
+  backdrop.addEventListener("transitionend", onEnd);
+  closingState = { id, backdrop, timer: window.setTimeout(finalize, CP_EXIT_FALLBACK_MS), onEnd };
 }
 function initCommandPalette(root) {
   if (typeof document === "undefined") return () => {
@@ -245,38 +347,38 @@ function initCommandPalette(root) {
   if (typeof window === "undefined") return () => {
   };
   const scope = root ?? document;
-  scope.querySelectorAll("[data-command-palette-open]").forEach((el) => el.setAttribute("aria-haspopup", "dialog"));
+  scope.querySelectorAll("[data-icen-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]");
-    if (opener?.dataset.commandPaletteOpen) {
-      openCommandPalette(opener.dataset.commandPaletteOpen);
+    const opener = target.closest("[data-icen-command-palette-open]");
+    if (opener?.dataset.icenCommandPaletteOpen) {
+      openCommandPalette(opener.dataset.icenCommandPaletteOpen);
       return;
     }
-    const item = target.closest(".command-palette-item");
+    const item = target.closest(".icen-command-palette-item");
     if (item) {
-      const backdrop = item.closest("[data-command-palette]");
-      if (backdrop?.dataset.commandPalette) {
-        const panelEl = item.closest(".command-palette");
+      const backdrop = item.closest("[data-icen-command-palette]");
+      if (backdrop?.dataset.icenCommandPalette) {
+        const panelEl = item.closest(".icen-command-palette");
         if (panelEl && !programmaticCommands.has(item)) emitMenuSelect(panelEl, item);
-        if (!item.hasAttribute("data-command-palette-keep-open")) {
-          closeCommandPalette(backdrop.dataset.commandPalette);
+        if (!item.hasAttribute("data-icen-command-palette-keep-open")) {
+          closeCommandPalette(backdrop.dataset.icenCommandPalette);
         }
       }
       return;
     }
-    if (target instanceof HTMLElement && target.classList.contains("command-palette-backdrop") && target.dataset.commandPalette) {
-      closeCommandPalette(target.dataset.commandPalette);
+    if (target instanceof HTMLElement && target.classList.contains("icen-command-palette-backdrop") && target.dataset.icenCommandPalette) {
+      closeCommandPalette(target.dataset.icenCommandPalette);
     }
   };
   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 (!e.target.matches(".icen-command-palette-input")) return;
+    const backdrop = e.target.closest("[data-icen-command-palette]");
+    const panel = backdrop?.querySelector(".icen-command-palette");
     if (panel) filterPanel(panel, e.target.value);
   };
   document.addEventListener("input", onInput);
@@ -284,12 +386,12 @@ function initCommandPalette(root) {
     if (!(e.metaKey || e.ctrlKey)) return;
     const key = e.key.toLowerCase();
     const palettes = document.querySelectorAll(
-      ".command-palette-backdrop[data-command-palette]"
+      ".icen-command-palette-backdrop[data-icen-command-palette]"
     );
     for (const backdrop of Array.from(palettes)) {
-      const paletteKey = (backdrop.dataset.commandPaletteKey ?? "k").toLowerCase();
+      const paletteKey = (backdrop.dataset.icenCommandPaletteKey ?? "k").toLowerCase();
       if (paletteKey !== key) continue;
-      const id = backdrop.dataset.commandPalette;
+      const id = backdrop.dataset.icenCommandPalette;
       if (!id) continue;
       e.preventDefault();
       if (openId === id) closeCommandPalette(id);
@@ -305,7 +407,7 @@ function initCommandPalette(root) {
       window.removeEventListener("keydown", globalKeyHandler);
       globalKeyHandler = null;
     }
-    if (openId) closeCommandPalette(openId);
+    if (openId) closeCommandPalette(openId, { immediate: true });
     teardown = null;
   };
   return teardown;

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

@@ -1,10 +1,13 @@
-import { PanelSizing } from './popover.js';
+import { IconName } from './icons.mjs';
+import { PanelSizing } from './popover.mjs';
 
 interface ContextMenuEntry {
     label: string;
     subLabel?: string;
     /** 可信 svg 字符串（唯一走 innerHTML 的字段） */
     icon?: string;
+    /** Shared ICEN symbol (preferred over hand-written SVG). */
+    iconName?: IconName;
     shortcut?: string;
     danger?: boolean;
     disabled?: boolean;
@@ -27,21 +30,19 @@ interface ContextMenuOptions {
 /** 菜单选中统一事件（dropdown / context-menu / command-palette 同一契约）。
  *  本模块为唯一定义点，dropdown / command-palette 改为 import 复用（收敛三份逐字拷贝）。 */
 declare function emitMenuSelect(source: HTMLElement, item: HTMLElement): void;
-/** 注册指定 id 的右键菜单项（对应 DOM 中的 [data-context-menu="id"]）。 */
+/** 注册指定 id 的右键菜单项（对应 DOM 中的 [data-icen-context-menu="id"]）。 */
 declare function registerContextMenu(id: string, items: ContextMenuItem[]): void;
+/** Remove a registration and its retained host callbacks. */
+declare function unregisterContextMenu(id: string): void;
 /** 在 (x, y) 打开右键菜单（视口边缘自动翻转并 clamp）。
     尺寸走全库统一 PanelSizing 契约：opts.sizing 直接传入（面板无固定宿主元素，
     由调用方从其根元素 readPanelSizing 读入，如 datatable 行右键）。 */
 declare function openContextMenu(x: number, y: number, items: ContextMenuItem[], opts?: {
     sizing?: PanelSizing;
+    returnFocus?: HTMLElement;
 }): void;
 /** 关闭当前右键菜单（未打开时为 no-op）。 */
-declare function closeContextMenu(): void;
-/**
- * @deprecated 已更名 closeContextMenu（与全库浮层 close* 命名对齐）；
- * 本别名仅为兼容保留，下个大版本删除。
- */
-declare function closeMenu(): void;
+declare function closeContextMenu(restoreFocus?: boolean): void;
 /**
  * 启动全局右键菜单（重复调用安全）。
  * opts.items 提供时替换内置默认菜单。
@@ -50,4 +51,4 @@ declare function closeMenu(): void;
  */
 declare function initContextMenu(opts?: ContextMenuOptions): () => void;
 
-export { type ContextMenuEntry, type ContextMenuHeader, type ContextMenuItem, type ContextMenuOptions, type ContextMenuSeparator, closeContextMenu, closeMenu, emitMenuSelect, initContextMenu, openContextMenu, registerContextMenu };
+export { type ContextMenuEntry, type ContextMenuHeader, type ContextMenuItem, type ContextMenuOptions, type ContextMenuSeparator, closeContextMenu, emitMenuSelect, initContextMenu, openContextMenu, registerContextMenu, unregisterContextMenu };