@neut/ui 0.0.16 → 0.0.18

package/dist/components/context-menu/ContextMenuTrigger/useContextMenuTrigger.js

@@ -1,47 +1,50 @@
 import { useContextMenuContext as e } from "../ContextMenu/ContextMenu.context.js";
-import { onCleanup as t } from "solid-js";
+import { createLongPress as t } from "./context-menu.long-press.js";
+import { isContextMenuKey as n, isLongPressPointer as r, menuAnchorFromRect as i } from "./context-menu.trigger.utils.js";
+import { onCleanup as a } from "solid-js";
 //#region src/components/context-menu/ContextMenuTrigger/useContextMenuTrigger.ts
-var n = 500, r = 10;
-function i() {
-	let i = e("ContextMenuTrigger");
+function o() {
+	let o = e("ContextMenuTrigger");
 	return {
-		ctx: i,
+		ctx: o,
 		attachListeners: (e) => {
-			let a, o, s = () => {
-				a !== void 0 && (window.clearTimeout(a), a = void 0);
-			}, c = (t) => {
-				if (i.disabled()) return;
+			let s, c = t({
+				delayMs: 500,
+				tolerancePx: 10,
+				onTrigger: () => {
+					s && o.openAt(s.x, s.y, e, s.event, "trigger-press");
+				}
+			}), l = (t) => {
+				if (o.disabled()) return;
 				let n = t;
-				n.preventDefault(), i.openAt(n.clientX, n.clientY, e, n, "trigger-press");
-			}, l = (t) => {
-				let r = t;
-				r.pointerType === "mouse" || i.disabled() || (o = {
-					x: r.clientX,
-					y: r.clientY
-				}, s(), a = window.setTimeout(() => {
-					a = void 0, i.openAt(r.clientX, r.clientY, e, r, "trigger-press");
-				}, n));
+				n.preventDefault(), o.openAt(n.clientX, n.clientY, e, n, "trigger-press");
 			}, u = (e) => {
-				if (!o || a === void 0) return;
-				let t = e, n = t.clientX - o.x, i = t.clientY - o.y;
-				Math.hypot(n, i) > r && s();
-			}, d = () => {
-				o = void 0, s();
-			}, f = (t) => {
-				if (i.disabled()) return;
-				let n = t;
-				if (!(n.key === "ContextMenu" || n.shiftKey && n.key === "F10")) return;
-				n.preventDefault();
-				let r = e.getBoundingClientRect();
-				i.openAt(r.left + r.width / 2, r.top + r.height / 2, e, n, "trigger-press");
+				let t = e;
+				r(t) && !o.disabled() && (s = {
+					x: t.clientX,
+					y: t.clientY,
+					event: t
+				}, c.start(t.clientX, t.clientY));
+			}, d = (e) => {
+				let t = e;
+				c.move(t.clientX, t.clientY);
+			}, f = () => {
+				s = void 0, c.cancel();
+			}, p = (t) => {
+				if (o.disabled()) return;
+				let r = t;
+				if (!n(r)) return;
+				r.preventDefault();
+				let a = i(e.getBoundingClientRect());
+				o.openAt(a.x, a.y, e, r, "trigger-press");
 			};
-			e.addEventListener("contextmenu", c), e.addEventListener("pointerdown", l), e.addEventListener("pointermove", u), e.addEventListener("pointerup", d), e.addEventListener("pointercancel", d), e.addEventListener("keydown", f), t(() => {
-				s(), e.removeEventListener("contextmenu", c), e.removeEventListener("pointerdown", l), e.removeEventListener("pointermove", u), e.removeEventListener("pointerup", d), e.removeEventListener("pointercancel", d), e.removeEventListener("keydown", f);
+			e.addEventListener("contextmenu", l), e.addEventListener("pointerdown", u), e.addEventListener("pointermove", d), e.addEventListener("pointerup", f), e.addEventListener("pointercancel", f), e.addEventListener("keydown", p), a(() => {
+				c.cancel(), e.removeEventListener("contextmenu", l), e.removeEventListener("pointerdown", u), e.removeEventListener("pointermove", d), e.removeEventListener("pointerup", f), e.removeEventListener("pointercancel", f), e.removeEventListener("keydown", p);
 			});
 		}
 	};
 }
 //#endregion
-export { i as useContextMenuTrigger };
+export { o as useContextMenuTrigger };
 
 //# sourceMappingURL=useContextMenuTrigger.js.map

package/dist/components/context-menu/ContextMenuTrigger/useContextMenuTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContextMenuTrigger.js","names":["LONG_PRESS_DELAY","LONG_PRESS_MOVE_TOLERANCE","useContextMenuTrigger","ctx","useContextMenuContext","longPressTimer","pressOrigin","clearLongPress","onContextMenu","e","event","el","onPointerDown","onPointerMove","dx","dy","onPointerEnd","onKeyDown","rect","onCleanup"],"sources":["../../../../src/components/context-menu/ContextMenuTrigger/useContextMenuTrigger.ts"],"sourcesContent":["import { onCleanup } from \"solid-js\";\nimport { useContextMenuContext } from \"../ContextMenu/ContextMenu.context\";\n\n/** 触摸长按唤起菜单的时间阈值(毫秒),与 Base UI 保持一致 */\nconst LONG_PRESS_DELAY = 500;\n/** 长按期间允许的手指抖动距离(像素),超过即取消 */\nconst LONG_PRESS_MOVE_TOLERANCE = 10;\n\nexport interface UseContextMenuTriggerResult {\n  ctx: ReturnType<typeof useContextMenuContext>;\n  /**\n   * 把右键 / 长按 / 键盘唤起菜单的原生事件绑定到真正的 DOM 元素上(通过 ref 调用)。\n   * 用 addEventListener 而不是 JSX 的 onXxx prop,是为了不占用这些 prop 名——\n   * 调用方可以在触发器上自由传自己的 `onClick` / `onContextMenu`,两者互不覆盖。\n   * 这与 TooltipTrigger 是同一套约定。\n   */\n  attachListeners: (el: Element) => void;\n}\n\n/**\n * 封装 ContextMenuTrigger 需要绑定的所有事件逻辑:\n * - contextmenu(右键):锚定到鼠标坐标\n * - pointerdown(触摸/手写笔)后持续 500ms 视为长按,锚定到按下坐标;抖动超过\n *   阈值、抬起或取消都会撤销\n * - keydown(Shift+F10 / 菜单键):锚定到触发器中心,满足键盘可达性\n *\n * 事件直接绑在 `el` 上,不依赖具体标签类型,因此触发器可以多态渲染成\n * div / button / 任意组件。回调参数统一声明为 `Event` 再在内部收窄,\n * 这是为了兼容 `Element.addEventListener` 的重载(与 TooltipTrigger 一致)。\n */\nexport function useContextMenuTrigger(): UseContextMenuTriggerResult {\n  const ctx = useContextMenuContext(\"ContextMenuTrigger\");\n\n  const attachListeners = (el: Element) => {\n    let longPressTimer: number | undefined;\n    let pressOrigin: { x: number; y: number } | undefined;\n\n    const clearLongPress = () => {\n      if (longPressTimer !== undefined) {\n        window.clearTimeout(longPressTimer);\n        longPressTimer = undefined;\n      }\n    };\n\n    const onContextMenu = (event: Event) => {\n      if (ctx.disabled()) return;\n      const e = event as MouseEvent;\n      e.preventDefault();\n      ctx.openAt(e.clientX, e.clientY, el, e, \"trigger-press\");\n    };\n\n    const onPointerDown = (event: Event) => {\n      const e = event as PointerEvent;\n      // 鼠标右键由 contextmenu 处理,这里只负责触摸/手写笔长按\n      if (e.pointerType === \"mouse\" || ctx.disabled()) return;\n      pressOrigin = { x: e.clientX, y: e.clientY };\n      clearLongPress();\n      longPressTimer = window.setTimeout(() => {\n        longPressTimer = undefined;\n        ctx.openAt(e.clientX, e.clientY, el, e, \"trigger-press\");\n      }, LONG_PRESS_DELAY);\n    };\n\n    const onPointerMove = (event: Event) => {\n      if (!pressOrigin || longPressTimer === undefined) return;\n      const e = event as PointerEvent;\n      const dx = e.clientX - pressOrigin.x;\n      const dy = e.clientY - pressOrigin.y;\n      if (Math.hypot(dx, dy) > LONG_PRESS_MOVE_TOLERANCE) clearLongPress();\n    };\n\n    const onPointerEnd = () => {\n      pressOrigin = undefined;\n      clearLongPress();\n    };\n\n    const onKeyDown = (event: Event) => {\n      if (ctx.disabled()) return;\n      const e = event as KeyboardEvent;\n      const isMenuKey =\n        e.key === \"ContextMenu\" || (e.shiftKey && e.key === \"F10\");\n      if (!isMenuKey) return;\n      e.preventDefault();\n      const rect = el.getBoundingClientRect();\n      ctx.openAt(\n        rect.left + rect.width / 2,\n        rect.top + rect.height / 2,\n        el,\n        e,\n        \"trigger-press\",\n      );\n    };\n\n    el.addEventListener(\"contextmenu\", onContextMenu);\n    el.addEventListener(\"pointerdown\", onPointerDown);\n    el.addEventListener(\"pointermove\", onPointerMove);\n    el.addEventListener(\"pointerup\", onPointerEnd);\n    el.addEventListener(\"pointercancel\", onPointerEnd);\n    el.addEventListener(\"keydown\", onKeyDown);\n\n    onCleanup(() => {\n      clearLongPress();\n      el.removeEventListener(\"contextmenu\", onContextMenu);\n      el.removeEventListener(\"pointerdown\", onPointerDown);\n      el.removeEventListener(\"pointermove\", onPointerMove);\n      el.removeEventListener(\"pointerup\", onPointerEnd);\n      el.removeEventListener(\"pointercancel\", onPointerEnd);\n      el.removeEventListener(\"keydown\", onKeyDown);\n    });\n  };\n\n  return { ctx, attachListeners };\n}\n"],"mappings":";;;AAIA,IAAMA,IAAmB,KAEnBC,IAA4B;AAwBlC,SAAgBC,IAAqD;CACnE,IAAMC,IAAMC,EAAsB,oBAAoB;CAgFtD,OAAO;EAAE;EAAK,kBA9EW,MAAgB;GACvC,IAAIC,GACAC,GAEEC,UAAuB;IAC3B,AAAIF,MAAmB,KAAA,MACrB,OAAO,aAAaA,CAAc,GAClC,IAAiB,KAAA;GAErB,GAEMG,KAAiB,MAAiB;IACtC,IAAIL,EAAI,SAAS,GAAG;IACpB,IAAMM,IAAIC;IAEV,AADAD,EAAE,eAAe,GACjBN,EAAI,OAAOM,EAAE,SAASA,EAAE,SAASE,GAAIF,GAAG,eAAe;GACzD,GAEMG,KAAiB,MAAiB;IACtC,IAAMH,IAAIC;IAEV,AAAID,EAAE,gBAAgB,WAAWN,EAAI,SAAS,MAC9C,IAAc;KAAE,GAAGM,EAAE;KAAS,GAAGA,EAAE;IAAQ,GAC3CF,EAAe,GACf,IAAiB,OAAO,iBAAiB;KAEvC,AADA,IAAiB,KAAA,GACjBJ,EAAI,OAAOM,EAAE,SAASA,EAAE,SAASE,GAAIF,GAAG,eAAe;IACzD,GAAGT,CAAgB;GACrB,GAEMa,KAAiB,MAAiB;IACtC,IAAI,CAACP,KAAeD,MAAmB,KAAA,GAAW;IAClD,IAAMI,IAAIC,GACJI,IAAKL,EAAE,UAAUH,EAAY,GAC7BS,IAAKN,EAAE,UAAUH,EAAY;IACnC,AAAI,KAAK,MAAMQ,GAAIC,CAAE,IAAId,KAA2BM,EAAe;GACrE,GAEMS,UAAqB;IAEzB,AADA,IAAc,KAAA,GACdT,EAAe;GACjB,GAEMU,KAAa,MAAiB;IAClC,IAAId,EAAI,SAAS,GAAG;IACpB,IAAMM,IAAIC;IAGV,IAAI,EADFD,EAAE,QAAQ,iBAAkBA,EAAE,YAAYA,EAAE,QAAQ,QACtC;IAChB,EAAE,eAAe;IACjB,IAAMS,IAAOP,EAAG,sBAAsB;IACtC,EAAI,OACFO,EAAK,OAAOA,EAAK,QAAQ,GACzBA,EAAK,MAAMA,EAAK,SAAS,GACzBP,GACAF,GACA,eACF;GACF;GASA,AAPAE,EAAG,iBAAiB,eAAeH,CAAa,GAChDG,EAAG,iBAAiB,eAAeC,CAAa,GAChDD,EAAG,iBAAiB,eAAeE,CAAa,GAChDF,EAAG,iBAAiB,aAAaK,CAAY,GAC7CL,EAAG,iBAAiB,iBAAiBK,CAAY,GACjDL,EAAG,iBAAiB,WAAWM,CAAS,GAExCE,QAAgB;IAOd,AANAZ,EAAe,GACfI,EAAG,oBAAoB,eAAeH,CAAa,GACnDG,EAAG,oBAAoB,eAAeC,CAAa,GACnDD,EAAG,oBAAoB,eAAeE,CAAa,GACnDF,EAAG,oBAAoB,aAAaK,CAAY,GAChDL,EAAG,oBAAoB,iBAAiBK,CAAY,GACpDL,EAAG,oBAAoB,WAAWM,CAAS;GAC7C,CAAC;EACH;CAE8B;AAChC"}
+{"version":3,"file":"useContextMenuTrigger.js","names":["useContextMenuTrigger","ctx","useContextMenuContext","press","longPress","createLongPress","el","onContextMenu","e","event","onPointerDown","isLongPressPointer","onPointerMove","onPointerEnd","onKeyDown","isContextMenuKey","anchor","menuAnchorFromRect","onCleanup"],"sources":["../../../../src/components/context-menu/ContextMenuTrigger/useContextMenuTrigger.ts"],"sourcesContent":["import { onCleanup } from \"solid-js\";\nimport { useContextMenuContext } from \"../ContextMenu/ContextMenu.context\";\nimport { createLongPress } from \"./context-menu.long-press\";\nimport {\n  LONG_PRESS_DELAY,\n  LONG_PRESS_MOVE_TOLERANCE,\n  isContextMenuKey,\n  isLongPressPointer,\n  menuAnchorFromRect,\n} from \"./context-menu.trigger.utils\";\n\nexport interface UseContextMenuTriggerResult {\n  ctx: ReturnType<typeof useContextMenuContext>;\n  /**\n   * 把右键 / 长按 / 键盘唤起菜单的原生事件绑定到真正的 DOM 元素上（通过 ref 调用）。\n   * 用 addEventListener 而不是 JSX 的 onXxx prop，是为了不占用这些 prop 名——\n   * 调用方可以在触发器上自由传自己的 `onClick` / `onContextMenu`，两者互不覆盖。\n   * 这与 TooltipTrigger 是同一套约定。\n   */\n  attachListeners: (el: Element) => void;\n}\n\n/**\n * ContextMenuTrigger 的事件接线：\n * - contextmenu（右键）：锚定到鼠标坐标；\n * - pointerdown（触摸/手写笔）长按 500ms：锚定到按下坐标（手势本身在\n *   `context-menu.long-press`）；\n * - keydown（Shift+F10 / 菜单键）：锚定到触发器中心，满足键盘可达性。\n *\n * 判定与锚点计算都在 `context-menu.trigger.utils`，本 hook 只做绑定与清理。\n */\nexport function useContextMenuTrigger(): UseContextMenuTriggerResult {\n  const ctx = useContextMenuContext(\"ContextMenuTrigger\");\n\n  const attachListeners = (el: Element) => {\n    // 长按到点时要\"回到按下时的坐标与事件\"，因此在闭包里记住这一次按下\n    let press: { x: number; y: number; event: PointerEvent } | undefined;\n\n    const longPress = createLongPress({\n      delayMs: LONG_PRESS_DELAY,\n      tolerancePx: LONG_PRESS_MOVE_TOLERANCE,\n      onTrigger: () => {\n        if (!press) return;\n        ctx.openAt(press.x, press.y, el, press.event, \"trigger-press\");\n      },\n    });\n\n    const onContextMenu = (event: Event) => {\n      if (ctx.disabled()) return;\n      const e = event as MouseEvent;\n      e.preventDefault();\n      ctx.openAt(e.clientX, e.clientY, el, e, \"trigger-press\");\n    };\n\n    const onPointerDown = (event: Event) => {\n      const e = event as PointerEvent;\n      // 鼠标右键由 contextmenu 处理，这里只负责触摸/手写笔长按\n      if (!isLongPressPointer(e) || ctx.disabled()) return;\n      press = { x: e.clientX, y: e.clientY, event: e };\n      longPress.start(e.clientX, e.clientY);\n    };\n\n    const onPointerMove = (event: Event) => {\n      const e = event as PointerEvent;\n      longPress.move(e.clientX, e.clientY);\n    };\n\n    const onPointerEnd = () => {\n      press = undefined;\n      longPress.cancel();\n    };\n\n    const onKeyDown = (event: Event) => {\n      if (ctx.disabled()) return;\n      const e = event as KeyboardEvent;\n      if (!isContextMenuKey(e)) return;\n      e.preventDefault();\n      const anchor = menuAnchorFromRect(el.getBoundingClientRect());\n      ctx.openAt(anchor.x, anchor.y, el, e, \"trigger-press\");\n    };\n\n    el.addEventListener(\"contextmenu\", onContextMenu);\n    el.addEventListener(\"pointerdown\", onPointerDown);\n    el.addEventListener(\"pointermove\", onPointerMove);\n    el.addEventListener(\"pointerup\", onPointerEnd);\n    el.addEventListener(\"pointercancel\", onPointerEnd);\n    el.addEventListener(\"keydown\", onKeyDown);\n\n    onCleanup(() => {\n      longPress.cancel();\n      el.removeEventListener(\"contextmenu\", onContextMenu);\n      el.removeEventListener(\"pointerdown\", onPointerDown);\n      el.removeEventListener(\"pointermove\", onPointerMove);\n      el.removeEventListener(\"pointerup\", onPointerEnd);\n      el.removeEventListener(\"pointercancel\", onPointerEnd);\n      el.removeEventListener(\"keydown\", onKeyDown);\n    });\n  };\n\n  return { ctx, attachListeners };\n}\n"],"mappings":";;;;;AA+BA,SAAgBA,IAAqD;CACnE,IAAMC,IAAMC,EAAsB,oBAAoB;CAmEtD,OAAO;EAAE;EAAK,kBAjEW,MAAgB;GAEvC,IAAIC,GAEEC,IAAYC,EAAgB;IAChC,SAAA;IACA,aAAA;IACA,iBAAiB;KACf,AAAKF,KACLF,EAAI,OAAOE,EAAM,GAAGA,EAAM,GAAGG,GAAIH,EAAM,OAAO,eAAe;IAC/D;GACF,CAAC,GAEKI,KAAiB,MAAiB;IACtC,IAAIN,EAAI,SAAS,GAAG;IACpB,IAAMO,IAAIC;IAEV,AADAD,EAAE,eAAe,GACjBP,EAAI,OAAOO,EAAE,SAASA,EAAE,SAASF,GAAIE,GAAG,eAAe;GACzD,GAEME,KAAiB,MAAiB;IACtC,IAAMF,IAAIC;IAEV,AAAKE,EAAmBH,CAAC,KAAK,GAAI,SAAS,MAC3C,IAAQ;KAAE,GAAGA,EAAE;KAAS,GAAGA,EAAE;KAAS,OAAOA;IAAE,GAC/CJ,EAAU,MAAMI,EAAE,SAASA,EAAE,OAAO;GACtC,GAEMI,KAAiB,MAAiB;IACtC,IAAMJ,IAAIC;IACV,EAAU,KAAKD,EAAE,SAASA,EAAE,OAAO;GACrC,GAEMK,UAAqB;IAEzB,AADA,IAAQ,KAAA,GACRT,EAAU,OAAO;GACnB,GAEMU,KAAa,MAAiB;IAClC,IAAIb,EAAI,SAAS,GAAG;IACpB,IAAMO,IAAIC;IACV,IAAI,CAACM,EAAiBP,CAAC,GAAG;IAC1B,EAAE,eAAe;IACjB,IAAMQ,IAASC,EAAmBX,EAAG,sBAAsB,CAAC;IAC5D,EAAI,OAAOU,EAAO,GAAGA,EAAO,GAAGV,GAAIE,GAAG,eAAe;GACvD;GASA,AAPAF,EAAG,iBAAiB,eAAeC,CAAa,GAChDD,EAAG,iBAAiB,eAAeI,CAAa,GAChDJ,EAAG,iBAAiB,eAAeM,CAAa,GAChDN,EAAG,iBAAiB,aAAaO,CAAY,GAC7CP,EAAG,iBAAiB,iBAAiBO,CAAY,GACjDP,EAAG,iBAAiB,WAAWQ,CAAS,GAExCI,QAAgB;IAOd,AANAd,EAAU,OAAO,GACjBE,EAAG,oBAAoB,eAAeC,CAAa,GACnDD,EAAG,oBAAoB,eAAeI,CAAa,GACnDJ,EAAG,oBAAoB,eAAeM,CAAa,GACnDN,EAAG,oBAAoB,aAAaO,CAAY,GAChDP,EAAG,oBAAoB,iBAAiBO,CAAY,GACpDP,EAAG,oBAAoB,WAAWQ,CAAS;GAC7C,CAAC;EACH;CAE8B;AAChC"}

package/dist/components/context-menu/context-menu.keyboard.d.ts

@@ -0,0 +1,29 @@
+import { ContextMenuChangeEventReason, ContextMenuItemEntry, ContextMenuSubmenuContextValue } from './context-menu.types';
+/** 键盘处理需要的能力（全部以函数注入，便于脱离 Solid 单独测试） */
+export interface MenuKeyboardContext {
+    /** 横向菜单：左右方向键用于移动高亮，而不是进入/退出子菜单 */
+    horizontal: boolean;
+    /** 当前高亮项 */
+    activeEntry: () => ContextMenuItemEntry | undefined;
+    moveActive: (delta: 1 | -1) => void;
+    focusFirst: () => void;
+    focusLast: () => void;
+    /** 字符导航（前缀匹配） */
+    typeahead: (char: string) => void;
+    /** 子菜单场景：ArrowLeft / Escape 只关当前子菜单 */
+    submenu?: ContextMenuSubmenuContextValue;
+    closeAll: (reason: ContextMenuChangeEventReason, event: Event) => void;
+}
+/**
+ * 菜单的按键映射：一个纯派发器——只把按键翻译成"菜单动作"，
+ * 不持有状态、不读 DOM（高亮项与子菜单关系都由 `ctx` 提供）。
+ *
+ * 分工：
+ * - 上下方向键 / Home / End → 移动或跳转高亮；
+ * - 左右方向键 → 横向菜单移动高亮，纵向菜单进入子菜单 / 退回父菜单；
+ * - Enter / Space → 激活高亮项（禁用项忽略）；
+ * - Escape → 关闭当前子菜单或整个菜单（子菜单可用 `closeParentOnEsc` 覆盖）；
+ * - Tab → 关闭菜单并把焦点交还触发器（浏览器随后继续 Tab）；
+ * - 其它可打印字符 → 交给 typeahead（带修饰键的组合键不参与）。
+ */
+export declare function handleMenuKeyDown(event: KeyboardEvent, ctx: MenuKeyboardContext): void;

package/dist/components/context-menu/context-menu.keyboard.js

@@ -0,0 +1,52 @@
+//#region src/components/context-menu/context-menu.keyboard.ts
+function e(e, t) {
+	let { submenu: n, horizontal: r } = t;
+	switch (e.key) {
+		case "ArrowDown":
+			e.preventDefault(), t.moveActive(1);
+			break;
+		case "ArrowUp":
+			e.preventDefault(), t.moveActive(-1);
+			break;
+		case "ArrowRight": {
+			if (r) {
+				e.preventDefault(), t.moveActive(1);
+				break;
+			}
+			let n = t.activeEntry();
+			n?.hasPopup() && (e.preventDefault(), n.openPopup?.("list-navigation", e));
+			break;
+		}
+		case "ArrowLeft":
+			if (r) {
+				e.preventDefault(), t.moveActive(-1);
+				break;
+			}
+			n && (e.preventDefault(), e.stopPropagation(), n.closeSubmenu("list-navigation", e, !0));
+			break;
+		case "Home":
+			e.preventDefault(), t.focusFirst();
+			break;
+		case "End":
+			e.preventDefault(), t.focusLast();
+			break;
+		case "Enter":
+		case " ": {
+			e.preventDefault();
+			let n = t.activeEntry();
+			n && !n.disabled() && n.activate();
+			break;
+		}
+		case "Escape":
+			e.preventDefault(), e.stopPropagation(), n && !n.closeParentOnEsc() ? n.closeSubmenu("escape-key", e, !0) : t.closeAll("escape-key", e);
+			break;
+		case "Tab":
+			e.preventDefault(), t.closeAll("focus-out", e);
+			break;
+		default: e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey && t.typeahead(e.key);
+	}
+}
+//#endregion
+export { e as handleMenuKeyDown };
+
+//# sourceMappingURL=context-menu.keyboard.js.map

package/dist/components/context-menu/context-menu.keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.keyboard.js","names":["handleMenuKeyDown","ctx","event","horizontal","entry","submenu"],"sources":["../../../src/components/context-menu/context-menu.keyboard.ts"],"sourcesContent":["import type {\n  ContextMenuChangeEventReason,\n  ContextMenuItemEntry,\n  ContextMenuSubmenuContextValue,\n} from \"./context-menu.types\";\n\n/** 键盘处理需要的能力（全部以函数注入，便于脱离 Solid 单独测试） */\nexport interface MenuKeyboardContext {\n  /** 横向菜单：左右方向键用于移动高亮，而不是进入/退出子菜单 */\n  horizontal: boolean;\n  /** 当前高亮项 */\n  activeEntry: () => ContextMenuItemEntry | undefined;\n  moveActive: (delta: 1 | -1) => void;\n  focusFirst: () => void;\n  focusLast: () => void;\n  /** 字符导航（前缀匹配） */\n  typeahead: (char: string) => void;\n  /** 子菜单场景：ArrowLeft / Escape 只关当前子菜单 */\n  submenu?: ContextMenuSubmenuContextValue;\n  closeAll: (reason: ContextMenuChangeEventReason, event: Event) => void;\n}\n\n/**\n * 菜单的按键映射：一个纯派发器——只把按键翻译成\"菜单动作\"，\n * 不持有状态、不读 DOM（高亮项与子菜单关系都由 `ctx` 提供）。\n *\n * 分工：\n * - 上下方向键 / Home / End → 移动或跳转高亮；\n * - 左右方向键 → 横向菜单移动高亮，纵向菜单进入子菜单 / 退回父菜单；\n * - Enter / Space → 激活高亮项（禁用项忽略）；\n * - Escape → 关闭当前子菜单或整个菜单（子菜单可用 `closeParentOnEsc` 覆盖）；\n * - Tab → 关闭菜单并把焦点交还触发器（浏览器随后继续 Tab）；\n * - 其它可打印字符 → 交给 typeahead（带修饰键的组合键不参与）。\n */\nexport function handleMenuKeyDown(\n  event: KeyboardEvent,\n  ctx: MenuKeyboardContext,\n): void {\n  const { submenu, horizontal } = ctx;\n\n  switch (event.key) {\n    case \"ArrowDown\":\n      event.preventDefault();\n      ctx.moveActive(1);\n      break;\n    case \"ArrowUp\":\n      event.preventDefault();\n      ctx.moveActive(-1);\n      break;\n    case \"ArrowRight\": {\n      if (horizontal) {\n        event.preventDefault();\n        ctx.moveActive(1);\n        break;\n      }\n      const entry = ctx.activeEntry();\n      if (entry?.hasPopup()) {\n        event.preventDefault();\n        entry.openPopup?.(\"list-navigation\", event);\n      }\n      break;\n    }\n    case \"ArrowLeft\": {\n      if (horizontal) {\n        event.preventDefault();\n        ctx.moveActive(-1);\n        break;\n      }\n      if (submenu) {\n        event.preventDefault();\n        // 阻止冒泡，避免父级浮层也处理这次按键\n        event.stopPropagation();\n        submenu.closeSubmenu(\"list-navigation\", event, true);\n      }\n      break;\n    }\n    case \"Home\":\n      event.preventDefault();\n      ctx.focusFirst();\n      break;\n    case \"End\":\n      event.preventDefault();\n      ctx.focusLast();\n      break;\n    case \"Enter\":\n    case \" \": {\n      event.preventDefault();\n      const entry = ctx.activeEntry();\n      if (entry && !entry.disabled()) entry.activate();\n      break;\n    }\n    case \"Escape\": {\n      event.preventDefault();\n      event.stopPropagation();\n      if (submenu && !submenu.closeParentOnEsc()) {\n        submenu.closeSubmenu(\"escape-key\", event, true);\n      } else {\n        ctx.closeAll(\"escape-key\", event);\n      }\n      break;\n    }\n    case \"Tab\": {\n      // 关闭菜单并把焦点交还触发器，浏览器随后的 Tab 会从触发器之后继续\n      event.preventDefault();\n      ctx.closeAll(\"focus-out\", event);\n      break;\n    }\n    default: {\n      if (\n        event.key.length === 1 &&\n        !event.ctrlKey &&\n        !event.metaKey &&\n        !event.altKey\n      ) {\n        ctx.typeahead(event.key);\n      }\n    }\n  }\n}\n"],"mappings":";AAkCA,SAAgBA,EACd,GACA,GACM;CACN,IAAM,EAAE,YAAS,kBAAeC;CAEhC,QAAQC,EAAM,KAAd;EACE,KAAK;GAEH,AADAA,EAAM,eAAe,GACrBD,EAAI,WAAW,CAAC;GAChB;EACF,KAAK;GAEH,AADAC,EAAM,eAAe,GACrBD,EAAI,WAAW,EAAE;GACjB;EACF,KAAK,cAAc;GACjB,IAAIE,GAAY;IAEd,AADAD,EAAM,eAAe,GACrBD,EAAI,WAAW,CAAC;IAChB;GACF;GACA,IAAMG,IAAQH,EAAI,YAAY;GAC9B,AAAIG,GAAO,SAAS,MAClBF,EAAM,eAAe,GACrBE,EAAM,YAAY,mBAAmBF,CAAK;GAE5C;EACF;EACA,KAAK;GACH,IAAIC,GAAY;IAEd,AADAD,EAAM,eAAe,GACrBD,EAAI,WAAW,EAAE;IACjB;GACF;GACA,AAAII,MACFH,EAAM,eAAe,GAErBA,EAAM,gBAAgB,GACtBG,EAAQ,aAAa,mBAAmBH,GAAO,EAAI;GAErD;EAEF,KAAK;GAEH,AADAA,EAAM,eAAe,GACrBD,EAAI,WAAW;GACf;EACF,KAAK;GAEH,AADAC,EAAM,eAAe,GACrBD,EAAI,UAAU;GACd;EACF,KAAK;EACL,KAAK,KAAK;GACR,EAAM,eAAe;GACrB,IAAMG,IAAQH,EAAI,YAAY;GAC9B,AAAIG,KAAS,CAACA,EAAM,SAAS,KAAGA,EAAM,SAAS;GAC/C;EACF;EACA,KAAK;GAGH,AAFAF,EAAM,eAAe,GACrBA,EAAM,gBAAgB,GAClBG,KAAW,CAACA,EAAQ,iBAAiB,IACvCA,EAAQ,aAAa,cAAcH,GAAO,EAAI,IAE9CD,EAAI,SAAS,cAAcC,CAAK;GAElC;EAEF,KAAK;GAGH,AADAA,EAAM,eAAe,GACrBD,EAAI,SAAS,aAAaC,CAAK;GAC/B;EAEF,SACE,AACEA,EAAM,IAAI,WAAW,KACrB,CAACA,EAAM,WACP,CAACA,EAAM,WACP,CAACA,EAAM,UAEPD,EAAI,UAAUC,EAAM,GAAG;CAG7B;AACF"}

package/dist/components/context-menu/context-menu.typeahead.d.ts

@@ -0,0 +1,27 @@
+/** 键盘字符导航的缓冲窗口（毫秒） */
+export declare const TYPEAHEAD_TIMEOUT = 500;
+export interface TypeaheadCandidate {
+    id: string;
+    label: string;
+}
+export interface CreateTypeaheadOptions {
+    /** 参与匹配的候选：按 DOM 顺序、已过滤 disabled */
+    candidates: () => TypeaheadCandidate[];
+    /** 命中后的高亮回调 */
+    onMatch: (id: string) => void;
+    /** 缓冲窗口，默认 500ms */
+    timeoutMs?: number;
+}
+export interface Typeahead {
+    /** 处理一个可打印字符 */
+    handle: (char: string) => void;
+    /** 清理未到期的定时器（组件卸载时调用） */
+    dispose: () => void;
+}
+/**
+ * 菜单的"输入即跳转"：把连续输入攒成前缀，在窗口内匹配第一个以该前缀开头的候选。
+ *
+ * 行为对齐 Base UI：大小写不敏感；窗口到期后缓冲清空、重新开始；
+ * 命中后缓冲**不**清空（继续输入会匹配更长的前缀）。
+ */
+export declare function createTypeahead(options: CreateTypeaheadOptions): Typeahead;

package/dist/components/context-menu/context-menu.typeahead.js

@@ -0,0 +1,19 @@
+function e(e) {
+	let t = e.timeoutMs ?? 500, n = "", r, i = () => {
+		r !== void 0 && (window.clearTimeout(r), r = void 0);
+	};
+	return {
+		handle(a) {
+			n += a.toLowerCase(), i(), r = window.setTimeout(() => {
+				n = "", r = void 0;
+			}, t);
+			let o = e.candidates().find((e) => e.label.toLowerCase().startsWith(n));
+			o && e.onMatch(o.id);
+		},
+		dispose: i
+	};
+}
+//#endregion
+export { e as createTypeahead };
+
+//# sourceMappingURL=context-menu.typeahead.js.map

package/dist/components/context-menu/context-menu.typeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.typeahead.js","names":["createTypeahead","timeoutMs","options","buffer","timer","clearTimer","char","match","candidate"],"sources":["../../../src/components/context-menu/context-menu.typeahead.ts"],"sourcesContent":["/** 键盘字符导航的缓冲窗口（毫秒） */\nexport const TYPEAHEAD_TIMEOUT = 500;\n\nexport interface TypeaheadCandidate {\n  id: string;\n  label: string;\n}\n\nexport interface CreateTypeaheadOptions {\n  /** 参与匹配的候选：按 DOM 顺序、已过滤 disabled */\n  candidates: () => TypeaheadCandidate[];\n  /** 命中后的高亮回调 */\n  onMatch: (id: string) => void;\n  /** 缓冲窗口，默认 500ms */\n  timeoutMs?: number;\n}\n\nexport interface Typeahead {\n  /** 处理一个可打印字符 */\n  handle: (char: string) => void;\n  /** 清理未到期的定时器（组件卸载时调用） */\n  dispose: () => void;\n}\n\n/**\n * 菜单的\"输入即跳转\"：把连续输入攒成前缀，在窗口内匹配第一个以该前缀开头的候选。\n *\n * 行为对齐 Base UI：大小写不敏感；窗口到期后缓冲清空、重新开始；\n * 命中后缓冲**不**清空（继续输入会匹配更长的前缀）。\n */\nexport function createTypeahead(options: CreateTypeaheadOptions): Typeahead {\n  const timeoutMs = options.timeoutMs ?? TYPEAHEAD_TIMEOUT;\n  let buffer = \"\";\n  let timer: number | undefined;\n\n  const clearTimer = () => {\n    if (timer !== undefined) {\n      window.clearTimeout(timer);\n      timer = undefined;\n    }\n  };\n\n  return {\n    handle(char) {\n      buffer += char.toLowerCase();\n      clearTimer();\n      timer = window.setTimeout(() => {\n        buffer = \"\";\n        timer = undefined;\n      }, timeoutMs);\n\n      const match = options\n        .candidates()\n        .find((candidate) => candidate.label.toLowerCase().startsWith(buffer));\n      if (match) options.onMatch(match.id);\n    },\n    dispose: clearTimer,\n  };\n}\n"],"mappings":"AA8BA,SAAgBA,EAAgB,GAA4C;CAC1E,IAAMC,IAAYC,EAAQ,aAAA,KACtBC,IAAS,IACTC,GAEEC,UAAmB;EACvB,AAAID,MAAU,KAAA,MACZ,OAAO,aAAaA,CAAK,GACzB,IAAQ,KAAA;CAEZ;CAEA,OAAO;EACL,OAAO,GAAM;GAGX,AAFA,KAAUE,EAAK,YAAY,GAC3BD,EAAW,GACX,IAAQ,OAAO,iBAAiB;IAE9B,AADA,IAAS,IACT,IAAQ,KAAA;GACV,GAAGJ,CAAS;GAEZ,IAAMM,IAAQL,EACX,WAAW,CAAC,CACZ,MAAM,MAAcM,EAAU,MAAM,YAAY,CAAC,CAAC,WAAWL,CAAM,CAAC;GACvE,AAAII,KAAOL,EAAQ,QAAQK,EAAM,EAAE;EACrC;EACA,SAASF;CACX;AACF"}

package/dist/components/context-menu/context-menu.utils.d.ts

@@ -4,11 +4,14 @@ type Dir = "ltr" | "rtl" | "auto" | undefined;
 /**
  * 把 Base UI 风格的 `side` + `align` 拆成核心定位库统一的 `Placement`。
  * `align="center"` 时不带后缀(即居中)。
+ *
+ * 换算本身复用 `~/lib/positioner` 的 `toPlacement`,此处只做 ContextMenu 侧
+ * 类型(`ContextMenuAlign`)到通用 `Alignment` 的收窄。
  */
 export declare function toContextMenuPlacement(side: ContextMenuSide, align: ContextMenuAlign, dir: Dir): Placement;
 /**
  * 根据最终生效的 placement 计算动画缩放原点(贴在锚点上的那个角)。
- * 逻辑与 Popover/Tooltip 保持一致。
+ * 实现统一由 `~/lib/positioner` 提供(Popover/Tooltip/HoverCard 同一份)。
  */
 export declare function getContextMenuTransformOrigin(placement: Placement): string;
 /**
@@ -16,7 +19,7 @@ export declare function getContextMenuTransformOrigin(placement: Placement): str
  * 依旧回写逻辑值,这样 shadcn 的 `data-[side=inline-end]:...` 样式才能命中。
  */
 export declare function resolveContextMenuDataSide(requested: ContextMenuSide, placement: Placement, dir: Dir): ContextMenuSide;
-/** 生成对齐 Base UI 的 ChangeEventDetails */
+/** 生成对齐 Base UI 的 ChangeEventDetails(实现复用 `~/utils`) */
 export declare function createChangeEventDetails<R extends string = ContextMenuChangeEventReason>(reason: R, event?: Event, trigger?: Element): ContextMenuChangeEventDetails<R>;
 /**
  * 沿父链取消所有祖先子菜单已排期的关闭。

package/dist/components/context-menu/context-menu.utils.js

@@ -1,51 +1,29 @@
-import { getAlignment as e, getSide as t } from "../../lib/positioner/core/placement.js";
+import { createChangeEventDetails as e } from "../../utils/create-change-event-details.js";
+import { getSide as t } from "../../lib/positioner/core/placement.js";
+import { getTransformOrigin as n, toPlacement as r } from "../../lib/positioner/utils/floating.js";
 //#region src/components/context-menu/context-menu.utils.ts
-function n(e, t) {
-	let n = t === "rtl";
-	return e === "inline-start" ? n ? "right" : "left" : e === "inline-end" ? n ? "left" : "right" : e;
+function i(e, n) {
+	let i = r(e, "center", n);
+	return t(i);
 }
-function r(e, t, r) {
-	let i = n(e, r);
-	return t === "center" ? i : `${i}-${t}`;
+function a(e, t, n) {
+	return r(e, t === "center" ? "center" : t, n);
 }
-function i(n) {
-	let r = t(n), i = e(n), a = i === "start" ? "0%" : i === "end" ? "100%" : "50%";
-	switch (r) {
-		case "top": return `${a} 100%`;
-		case "bottom": return `${a} 0%`;
-		case "left": return `100% ${a}`;
-		case "right": return `0% ${a}`;
-	}
+function o(e) {
+	return n(e);
 }
-function a(e, r, i) {
-	let a = t(r);
-	return (e === "inline-start" || e === "inline-end") && n(e, i) === a ? e : a;
+function s(e, n, r) {
+	let a = t(n);
+	return (e === "inline-start" || e === "inline-end") && i(e, r) === a ? e : a;
 }
-function o(e, t, n) {
-	let r = !1, i = !1;
-	return {
-		reason: e,
-		event: t,
-		trigger: n,
-		cancel: () => {
-			r = !0;
-		},
-		allowPropagation: () => {
-			i = !0;
-		},
-		get isCanceled() {
-			return r;
-		},
-		get isPropagationAllowed() {
-			return i;
-		}
-	};
+function c(t, n, r) {
+	return e(t, n, r);
 }
-function s(e) {
+function l(e) {
 	let t = e;
 	for (; t;) t.cancelClose(), t = t.parentPopup.submenu;
 }
 //#endregion
-export { s as cancelSubmenuCloseChain, o as createChangeEventDetails, i as getContextMenuTransformOrigin, a as resolveContextMenuDataSide, r as toContextMenuPlacement };
+export { l as cancelSubmenuCloseChain, c as createChangeEventDetails, o as getContextMenuTransformOrigin, s as resolveContextMenuDataSide, a as toContextMenuPlacement };
 
 //# sourceMappingURL=context-menu.utils.js.map

package/dist/components/context-menu/context-menu.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.utils.js","names":["resolveLogicalSide","rtl","dir","side","toContextMenuPlacement","physical","align","getContextMenuTransformOrigin","getSide","placement","getAlignment","crossAxisOrigin","resolveContextMenuDataSide","actual","requested","createChangeEventDetails","canceled","propagationAllowed","cancelSubmenuCloseChain","current","submenu"],"sources":["../../../src/components/context-menu/context-menu.utils.ts"],"sourcesContent":["import { getAlignment, getSide, type Placement, type Side } from \"~/lib\";\nimport type {\n  ContextMenuAlign,\n  ContextMenuChangeEventDetails,\n  ContextMenuChangeEventReason,\n  ContextMenuSide,\n  ContextMenuSubmenuContextValue,\n} from \"./context-menu.types\";\n\ntype Dir = \"ltr\" | \"rtl\" | \"auto\" | undefined;\n\n/** 逻辑方向 -> 物理方向(LTR 下 inline-start=left,inline-end=right;RTL 相反) */\nfunction resolveLogicalSide(side: ContextMenuSide, dir: Dir): Side {\n  const rtl = dir === \"rtl\";\n  if (side === \"inline-start\") return rtl ? \"right\" : \"left\";\n  if (side === \"inline-end\") return rtl ? \"left\" : \"right\";\n  return side;\n}\n\n/**\n * 把 Base UI 风格的 `side` + `align` 拆成核心定位库统一的 `Placement`。\n * `align=\"center\"` 时不带后缀(即居中)。\n */\nexport function toContextMenuPlacement(\n  side: ContextMenuSide,\n  align: ContextMenuAlign,\n  dir: Dir,\n): Placement {\n  const physical = resolveLogicalSide(side, dir);\n  return align === \"center\" ? physical : (`${physical}-${align}` as Placement);\n}\n\n/**\n * 根据最终生效的 placement 计算动画缩放原点(贴在锚点上的那个角)。\n * 逻辑与 Popover/Tooltip 保持一致。\n */\nexport function getContextMenuTransformOrigin(placement: Placement): string {\n  const side = getSide(placement);\n  const align = getAlignment(placement);\n  const crossAxisOrigin =\n    align === \"start\" ? \"0%\" : align === \"end\" ? \"100%\" : \"50%\";\n\n  switch (side) {\n    case \"top\":\n      return `${crossAxisOrigin} 100%`;\n    case \"bottom\":\n      return `${crossAxisOrigin} 0%`;\n    case \"left\":\n      return `100% ${crossAxisOrigin}`;\n    case \"right\":\n      return `0% ${crossAxisOrigin}`;\n  }\n}\n\n/**\n * 计算写回 DOM 的 `data-side`。若用户传入的是逻辑方向且最终没有翻转到另一侧,\n * 依旧回写逻辑值,这样 shadcn 的 `data-[side=inline-end]:...` 样式才能命中。\n */\nexport function resolveContextMenuDataSide(\n  requested: ContextMenuSide,\n  placement: Placement,\n  dir: Dir,\n): ContextMenuSide {\n  const actual = getSide(placement);\n  if (requested === \"inline-start\" || requested === \"inline-end\") {\n    const expected = resolveLogicalSide(requested, dir);\n    if (expected === actual) return requested;\n  }\n  return actual;\n}\n\n/** 生成对齐 Base UI 的 ChangeEventDetails */\nexport function createChangeEventDetails<\n  R extends string = ContextMenuChangeEventReason,\n>(\n  reason: R,\n  event?: Event,\n  trigger?: Element,\n): ContextMenuChangeEventDetails<R> {\n  let canceled = false;\n  let propagationAllowed = false;\n\n  return {\n    reason,\n    event,\n    trigger,\n    cancel: () => {\n      canceled = true;\n    },\n    allowPropagation: () => {\n      propagationAllowed = true;\n    },\n    get isCanceled() {\n      return canceled;\n    },\n    get isPropagationAllowed() {\n      return propagationAllowed;\n    },\n  };\n}\n\n/**\n * 沿父链取消所有祖先子菜单已排期的关闭。\n * 多级菜单里,鼠标从父级内容移到子级内容时,父级内容的 pointerleave 会给父级\n * 排一个延迟关闭;子级内容的 pointerenter 必须把祖先的定时器一并取消,\n * 否则父级会在 grace 后关闭,连带整棵菜单树消失。\n */\nexport function cancelSubmenuCloseChain(\n  submenu: ContextMenuSubmenuContextValue | undefined,\n): void {\n  let current = submenu;\n  while (current) {\n    current.cancelClose();\n    current = current.parentPopup.submenu;\n  }\n}\n"],"mappings":";;AAYA,SAASA,EAAmB,GAAuB,GAAgB;CACjE,IAAMC,IAAMC,MAAQ;CAGpB,OAFIC,MAAS,iBAAuBF,IAAM,UAAU,SAChDE,MAAS,eAAqBF,IAAM,SAAS,UAC1CE;AACT;AAMA,SAAgBC,EACd,GACA,GACA,GACW;CACX,IAAMC,IAAWL,EAAmBG,GAAMD,CAAG;CAC7C,OAAOI,MAAU,WAAWD,IAAY,GAAGA,EAAS,GAAGC;AACzD;AAMA,SAAgBC,EAA8B,GAA8B;CAC1E,IAAMJ,IAAOK,EAAQC,CAAS,GACxBH,IAAQI,EAAaD,CAAS,GAC9BE,IACJL,MAAU,UAAU,OAAOA,MAAU,QAAQ,SAAS;CAExD,QAAQH,GAAR;EACE,KAAK,OACH,OAAO,GAAGQ,EAAgB;EAC5B,KAAK,UACH,OAAO,GAAGA,EAAgB;EAC5B,KAAK,QACH,OAAO,QAAQA;EACjB,KAAK,SACH,OAAO,MAAMA;CACjB;AACF;AAMA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,IAAMC,IAASL,EAAQC,CAAS;CAKhC,QAJIK,MAAc,kBAAkBA,MAAc,iBAC/Bd,EAAmBc,GAAWZ,CAC3C,MAAaW,IAAeC,IAE3BD;AACT;AAGA,SAAgBE,EAGd,GACA,GACA,GACkC;CAClC,IAAIC,IAAW,IACXC,IAAqB;CAEzB,OAAO;EACL;EACA;EACA;EACA,cAAc;GACZ,IAAW;EACb;EACA,wBAAwB;GACtB,IAAqB;EACvB;EACA,IAAI,aAAa;GACf,OAAOD;EACT;EACA,IAAI,uBAAuB;GACzB,OAAOC;EACT;CACF;AACF;AAQA,SAAgBC,EACd,GACM;CACN,IAAIC,IAAUC;CACd,OAAOD,IAEL,AADAA,EAAQ,YAAY,GACpB,IAAUA,EAAQ,YAAY;AAElC"}
+{"version":3,"file":"context-menu.utils.js","names":["createSharedChangeEventDetails","createChangeEventDetails$1","resolveLogicalSide","physical","toPlacement","side","dir","getSide","toContextMenuPlacement","align","getContextMenuTransformOrigin","getTransformOrigin","placement","resolveContextMenuDataSide","actual","requested","createChangeEventDetails","reason","event","trigger","cancelSubmenuCloseChain","current","submenu"],"sources":["../../../src/components/context-menu/context-menu.utils.ts"],"sourcesContent":["import {\n  getSide,\n  getTransformOrigin,\n  toPlacement,\n  type Placement,\n  type Side,\n} from \"~/lib\";\nimport { createChangeEventDetails as createSharedChangeEventDetails } from \"~/utils\";\nimport type {\n  ContextMenuAlign,\n  ContextMenuChangeEventDetails,\n  ContextMenuChangeEventReason,\n  ContextMenuSide,\n  ContextMenuSubmenuContextValue,\n} from \"./context-menu.types\";\n\ntype Dir = \"ltr\" | \"rtl\" | \"auto\" | undefined;\n\n/** 逻辑方向 -> 物理方向(LTR 下 inline-start=left,inline-end=right;RTL 相反) */\nfunction resolveLogicalSide(side: ContextMenuSide, dir: Dir): Side {\n  const physical = toPlacement(side, \"center\", dir);\n  return getSide(physical);\n}\n\n/**\n * 把 Base UI 风格的 `side` + `align` 拆成核心定位库统一的 `Placement`。\n * `align=\"center\"` 时不带后缀(即居中)。\n *\n * 换算本身复用 `~/lib/positioner` 的 `toPlacement`,此处只做 ContextMenu 侧\n * 类型(`ContextMenuAlign`)到通用 `Alignment` 的收窄。\n */\nexport function toContextMenuPlacement(\n  side: ContextMenuSide,\n  align: ContextMenuAlign,\n  dir: Dir,\n): Placement {\n  return toPlacement(side, align === \"center\" ? \"center\" : align, dir);\n}\n\n/**\n * 根据最终生效的 placement 计算动画缩放原点(贴在锚点上的那个角)。\n * 实现统一由 `~/lib/positioner` 提供(Popover/Tooltip/HoverCard 同一份)。\n */\nexport function getContextMenuTransformOrigin(placement: Placement): string {\n  return getTransformOrigin(placement);\n}\n\n/**\n * 计算写回 DOM 的 `data-side`。若用户传入的是逻辑方向且最终没有翻转到另一侧,\n * 依旧回写逻辑值,这样 shadcn 的 `data-[side=inline-end]:...` 样式才能命中。\n */\nexport function resolveContextMenuDataSide(\n  requested: ContextMenuSide,\n  placement: Placement,\n  dir: Dir,\n): ContextMenuSide {\n  const actual = getSide(placement);\n  if (requested === \"inline-start\" || requested === \"inline-end\") {\n    const expected = resolveLogicalSide(requested, dir);\n    if (expected === actual) return requested;\n  }\n  return actual;\n}\n\n/** 生成对齐 Base UI 的 ChangeEventDetails(实现复用 `~/utils`) */\nexport function createChangeEventDetails<\n  R extends string = ContextMenuChangeEventReason,\n>(\n  reason: R,\n  event?: Event,\n  trigger?: Element,\n): ContextMenuChangeEventDetails<R> {\n  return createSharedChangeEventDetails(reason, event, trigger);\n}\n\n/**\n * 沿父链取消所有祖先子菜单已排期的关闭。\n * 多级菜单里,鼠标从父级内容移到子级内容时,父级内容的 pointerleave 会给父级\n * 排一个延迟关闭;子级内容的 pointerenter 必须把祖先的定时器一并取消,\n * 否则父级会在 grace 后关闭,连带整棵菜单树消失。\n */\nexport function cancelSubmenuCloseChain(\n  submenu: ContextMenuSubmenuContextValue | undefined,\n): void {\n  let current = submenu;\n  while (current) {\n    current.cancelClose();\n    current = current.parentPopup.submenu;\n  }\n}\n"],"mappings":";;;;AAmBA,SAASE,EAAmB,GAAuB,GAAgB;CACjE,IAAMC,IAAWC,EAAYC,GAAM,UAAUC,CAAG;CAChD,OAAOC,EAAQJ,CAAQ;AACzB;AASA,SAAgBK,EACd,GACA,GACA,GACW;CACX,OAAOJ,EAAYC,GAAMI,MAAU,WAAW,WAAWA,GAAOH,CAAG;AACrE;AAMA,SAAgBI,EAA8B,GAA8B;CAC1E,OAAOC,EAAmBC,CAAS;AACrC;AAMA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,IAAMC,IAASP,EAAQK,CAAS;CAKhC,QAJIG,MAAc,kBAAkBA,MAAc,iBAC/Bb,EAAmBa,GAAWT,CAC3C,MAAaQ,IAAeC,IAE3BD;AACT;AAGA,SAAgBE,EAGd,GACA,GACA,GACkC;CAClC,OAAOhB,EAA+BiB,GAAQC,GAAOC,CAAO;AAC9D;AAQA,SAAgBC,EACd,GACM;CACN,IAAIC,IAAUC;CACd,OAAOD,IAEL,AADAA,EAAQ,YAAY,GACpB,IAAUA,EAAQ,YAAY;AAElC"}

package/dist/components/date-picker/DatePicker/DatePicker.js

@@ -66,6 +66,12 @@ function g(c) {
 				get class() {
 					return e("w-53 justify-between text-left font-normal", "data-[empty=true]:text-muted-foreground", _.class);
 				},
+				get classList() {
+					return _.classList;
+				},
+				get style() {
+					return _.style;
+				},
 				get children() {
 					return [(() => {
 						var e = m();

package/dist/components/date-picker/DatePicker/DatePicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.js","names":["createMemo","createSignal","mergeProps","splitProps","JSX","ChevronDown","Calendar","Popover","PopoverContent","PopoverTrigger","clsx","DatePickerProps","defaultFormatDate","date","Date","locale","Intl","DateTimeFormat","year","month","day","format","DatePicker","props","Element","merged","placeholder","align","const","side","local","rest","internalValue","setInternalValue","defaultValue","open","setOpen","value","undefined","setValue","onValueChange","localeCode","code","displayText","formatDate","_$createComponent","onOpenChange","children","variant","disabled","data-empty","class","_el$","_tmpl$","_$insert","sideOffset","contentClass","_$mergeProps","mode","selected","onSelect","defaultMonth","min","max","showOutsideDays","weekStartsOn","captionLayout","buttonVariant","classNames","calendarClass","mergeProps","_$createComponent","_$mergeProps","mergeProps$1","_tmpl$","defaultFormatDate","locale","date","DatePicker","merged","props","local","rest","splitProps","internalValue","setInternalValue","createSignal","open","setOpen","value","createMemo","setValue","localeCode","displayText","createComponent","Popover","PopoverTrigger","\"class\"","clsx","_el$","insert","ChevronDown","PopoverContent","Calendar","mergeProps"],"sources":["../../../../src/components/date-picker/DatePicker/DatePicker.tsx"],"sourcesContent":["import {\n  createMemo,\n  createSignal,\n  mergeProps,\n  splitProps,\n  type JSX,\n} from \"solid-js\";\nimport { ChevronDown } from \"lucide-solid\";\nimport { Calendar } from \"~/components/calendar\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"~/components/popover\";\nimport { clsx } from \"~/utils\";\nimport type { DatePickerProps } from \"./DatePicker.types\";\n\nfunction defaultFormatDate(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n  }).format(date);\n}\n\n/**\n * Date Picker：shadcn Base UI 版本 Date Picker 的 SolidJS 移植。\n *\n * shadcn 的 Base UI Date Picker 本身不是单个 Root 组件，而是由 Popover + Calendar\n * 组合而成。这里把它封装成一个开箱即用的 <DatePicker>，底层仍使用本仓库的\n * <Popover> 和 <Calendar>；如果你想完全复刻 shadcn 的「组合式」用法，也可以直接\n * 绕过这个封装，自己写 Popover + Calendar。\n */\nexport function DatePicker(props: DatePickerProps): JSX.Element {\n  const merged = mergeProps(\n    {\n      placeholder: \"Pick a date\",\n      align: \"start\" as const,\n      side: \"bottom\" as const,\n    },\n    props,\n  );\n\n  const [local, rest] = splitProps(merged, [\n    \"value\",\n    \"defaultValue\",\n    \"onValueChange\",\n    \"placeholder\",\n    \"disabled\",\n    \"min\",\n    \"max\",\n    \"locale\",\n    \"formatDate\",\n    \"showOutsideDays\",\n    \"weekStartsOn\",\n    \"captionLayout\",\n    \"buttonVariant\",\n    \"classNames\",\n    \"side\",\n    \"align\",\n    \"sideOffset\",\n    \"contentClass\",\n    \"calendarClass\",\n    \"class\",\n    \"classList\",\n    \"style\",\n  ]);\n\n  const [internalValue, setInternalValue] = createSignal<Date | undefined>(\n    local.defaultValue,\n  );\n  const [open, setOpen] = createSignal(false);\n  const value = createMemo(() =>\n    local.value !== undefined ? local.value : internalValue(),\n  );\n\n  const setValue = (date: Date | undefined) => {\n    if (local.value === undefined) setInternalValue(date);\n    local.onValueChange?.(date);\n  };\n\n  const localeCode = createMemo(() =>\n    typeof local.locale === \"string\" ? local.locale : local.locale?.code,\n  );\n\n  const displayText = createMemo(() => {\n    const date = value();\n    if (!date) return local.placeholder;\n    return (local.formatDate ?? defaultFormatDate)(date, localeCode());\n  });\n\n  return (\n    <Popover open={open()} onOpenChange={setOpen}>\n      <PopoverTrigger\n        variant=\"outline\"\n        disabled={local.disabled}\n        data-empty={value() === undefined ? \"true\" : undefined}\n        class={clsx(\n          \"w-53 justify-between text-left font-normal\",\n          \"data-[empty=true]:text-muted-foreground\",\n          local.class,\n        )}\n      >\n        <span class=\"truncate\">{displayText()}</span>\n        <ChevronDown data-icon=\"inline-end\" />\n      </PopoverTrigger>\n      <PopoverContent\n        side={local.side}\n        align={local.align}\n        sideOffset={local.sideOffset}\n        class={clsx(\"w-auto p-0\", local.contentClass)}\n      >\n        <Calendar\n          mode=\"single\"\n          selected={value()}\n          onSelect={(date) => {\n            setValue(date as Date | undefined);\n            // 选完日期后关闭浮层，交互上和常见 DatePicker 一致。\n            // shadcn 原始示例由 Popover 自己保持打开，用户可按需改写。\n            setOpen(false);\n          }}\n          defaultMonth={value()}\n          min={local.min}\n          max={local.max}\n          showOutsideDays={local.showOutsideDays}\n          weekStartsOn={local.weekStartsOn}\n          captionLayout={local.captionLayout}\n          buttonVariant={local.buttonVariant}\n          locale={local.locale}\n          classNames={local.classNames}\n          class={local.calendarClass}\n          {...rest}\n        />\n      </PopoverContent>\n    </Popover>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"DatePicker.js","names":["createMemo","createSignal","mergeProps","splitProps","JSX","ChevronDown","Calendar","Popover","PopoverContent","PopoverTrigger","clsx","DatePickerProps","defaultFormatDate","date","Date","locale","Intl","DateTimeFormat","year","month","day","format","DatePicker","props","Element","merged","placeholder","align","const","side","local","rest","internalValue","setInternalValue","defaultValue","open","setOpen","value","undefined","setValue","onValueChange","localeCode","code","displayText","formatDate","_$createComponent","onOpenChange","children","variant","disabled","data-empty","class","classList","style","_el$","_tmpl$","_$insert","sideOffset","contentClass","_$mergeProps","mode","selected","onSelect","defaultMonth","min","max","showOutsideDays","weekStartsOn","captionLayout","buttonVariant","classNames","calendarClass","mergeProps","_$createComponent","_$mergeProps","mergeProps$1","_tmpl$","defaultFormatDate","locale","date","DatePicker","merged","props","local","rest","splitProps","internalValue","setInternalValue","createSignal","open","setOpen","value","createMemo","setValue","localeCode","displayText","createComponent","Popover","PopoverTrigger","\"class\"","clsx","_el$","insert","ChevronDown","PopoverContent","Calendar","mergeProps"],"sources":["../../../../src/components/date-picker/DatePicker/DatePicker.tsx"],"sourcesContent":["import {\n  createMemo,\n  createSignal,\n  mergeProps,\n  splitProps,\n  type JSX,\n} from \"solid-js\";\nimport { ChevronDown } from \"lucide-solid\";\nimport { Calendar } from \"~/components/calendar\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"~/components/popover\";\nimport { clsx } from \"~/utils\";\nimport type { DatePickerProps } from \"./DatePicker.types\";\n\nfunction defaultFormatDate(date: Date, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n  }).format(date);\n}\n\n/**\n * Date Picker：shadcn Base UI 版本 Date Picker 的 SolidJS 移植。\n *\n * shadcn 的 Base UI Date Picker 本身不是单个 Root 组件，而是由 Popover + Calendar\n * 组合而成。这里把它封装成一个开箱即用的 <DatePicker>，底层仍使用本仓库的\n * <Popover> 和 <Calendar>；如果你想完全复刻 shadcn 的「组合式」用法，也可以直接\n * 绕过这个封装，自己写 Popover + Calendar。\n */\nexport function DatePicker(props: DatePickerProps): JSX.Element {\n  const merged = mergeProps(\n    {\n      placeholder: \"Pick a date\",\n      align: \"start\" as const,\n      side: \"bottom\" as const,\n    },\n    props,\n  );\n\n  const [local, rest] = splitProps(merged, [\n    \"value\",\n    \"defaultValue\",\n    \"onValueChange\",\n    \"placeholder\",\n    \"disabled\",\n    \"min\",\n    \"max\",\n    \"locale\",\n    \"formatDate\",\n    \"showOutsideDays\",\n    \"weekStartsOn\",\n    \"captionLayout\",\n    \"buttonVariant\",\n    \"classNames\",\n    \"side\",\n    \"align\",\n    \"sideOffset\",\n    \"contentClass\",\n    \"calendarClass\",\n    \"class\",\n    \"classList\",\n    \"style\",\n  ]);\n\n  const [internalValue, setInternalValue] = createSignal<Date | undefined>(\n    local.defaultValue,\n  );\n  const [open, setOpen] = createSignal(false);\n  const value = createMemo(() =>\n    local.value !== undefined ? local.value : internalValue(),\n  );\n\n  const setValue = (date: Date | undefined) => {\n    if (local.value === undefined) setInternalValue(date);\n    local.onValueChange?.(date);\n  };\n\n  const localeCode = createMemo(() =>\n    typeof local.locale === \"string\" ? local.locale : local.locale?.code,\n  );\n\n  const displayText = createMemo(() => {\n    const date = value();\n    if (!date) return local.placeholder;\n    return (local.formatDate ?? defaultFormatDate)(date, localeCode());\n  });\n\n  return (\n    <Popover open={open()} onOpenChange={setOpen}>\n      <PopoverTrigger\n        variant=\"outline\"\n        disabled={local.disabled}\n        data-empty={value() === undefined ? \"true\" : undefined}\n        class={clsx(\n          \"w-53 justify-between text-left font-normal\",\n          \"data-[empty=true]:text-muted-foreground\",\n          local.class,\n        )}\n        classList={local.classList}\n        // style 是 BaseProps 的公开 prop：class / classList 都落在 trigger 上，\n        // style 也必须一起应用，否则会被静默丢弃\n        style={local.style}\n      >\n        <span class=\"truncate\">{displayText()}</span>\n        <ChevronDown data-icon=\"inline-end\" />\n      </PopoverTrigger>\n      <PopoverContent\n        side={local.side}\n        align={local.align}\n        sideOffset={local.sideOffset}\n        class={clsx(\"w-auto p-0\", local.contentClass)}\n      >\n        <Calendar\n          mode=\"single\"\n          selected={value()}\n          onSelect={(date) => {\n            setValue(date as Date | undefined);\n            // 选完日期后关闭浮层，交互上和常见 DatePicker 一致。\n            // shadcn 原始示例由 Popover 自己保持打开，用户可按需改写。\n            setOpen(false);\n          }}\n          defaultMonth={value()}\n          min={local.min}\n          max={local.max}\n          showOutsideDays={local.showOutsideDays}\n          weekStartsOn={local.weekStartsOn}\n          captionLayout={local.captionLayout}\n          buttonVariant={local.buttonVariant}\n          locale={local.locale}\n          classNames={local.classNames}\n          class={local.calendarClass}\n          {...rest}\n        />\n      </PopoverContent>\n    </Popover>\n  );\n}\n"],"mappings":"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"}

package/dist/components/dialog/Dialog/Dialog.context.js

@@ -2,7 +2,7 @@ import { createContext as e, useContext as t } from "solid-js";
 //#region src/components/dialog/Dialog/Dialog.context.ts
 var n = e(), r = () => {
 	let e = t(n);
-	if (!e) throw Error("useDialogContext must be used within a DialogProvider");
+	if (!e) throw Error("useDialogContext 必须用在 <Dialog> 内部");
 	return e;
 };
 //#endregion

package/dist/components/dialog/Dialog/Dialog.context.js.map

@@ -1 +1 @@
-{"version":3,"file":"Dialog.context.js","names":["DialogContext","createContext","useDialogContext","context","useContext"],"sources":["../../../../src/components/dialog/Dialog/Dialog.context.ts"],"sourcesContent":["import {\n  type Accessor,\n  createContext,\n  type Setter,\n  useContext,\n} from \"solid-js\";\n\ninterface DialogContextValue {\n  show: Accessor<boolean>;\n  setShow: Setter<boolean>;\n  open: Accessor<boolean>;\n  /** 打开/关闭 Dialog；内部会同时处理受控与非受控模式 */\n  setOpen: (open: boolean) => void;\n}\n\nexport const DialogContext = createContext<DialogContextValue>();\n\nexport const useDialogContext = () => {\n  const context = useContext(DialogContext);\n  if (!context) {\n    throw new Error(\"useDialogContext must be used within a DialogProvider\");\n  }\n  return context;\n};\n"],"mappings":";;AAeA,IAAaA,IAAgBC,EAAkC,GAElDC,UAAyB;CACpC,IAAMC,IAAUC,EAAWJ,CAAa;CACxC,IAAI,CAACG,GACH,MAAU,MAAM,uDAAuD;CAEzE,OAAOA;AACT"}
+{"version":3,"file":"Dialog.context.js","names":["DialogContext","createContext","useDialogContext","context","useContext"],"sources":["../../../../src/components/dialog/Dialog/Dialog.context.ts"],"sourcesContent":["import {\n  type Accessor,\n  createContext,\n  type Setter,\n  useContext,\n} from \"solid-js\";\n\ninterface DialogContextValue {\n  show: Accessor<boolean>;\n  setShow: Setter<boolean>;\n  open: Accessor<boolean>;\n  /** 打开/关闭 Dialog；内部会同时处理受控与非受控模式 */\n  setOpen: (open: boolean) => void;\n}\n\nexport const DialogContext = createContext<DialogContextValue>();\n\nexport const useDialogContext = () => {\n  const context = useContext(DialogContext);\n  if (!context) {\n    throw new Error(\"useDialogContext 必须用在 <Dialog> 内部\");\n  }\n  return context;\n};\n"],"mappings":";;AAeA,IAAaA,IAAgBC,EAAkC,GAElDC,UAAyB;CACpC,IAAMC,IAAUC,EAAWJ,CAAa;CACxC,IAAI,CAACG,GACH,MAAU,MAAM,mCAAmC;CAErD,OAAOA;AACT"}

package/dist/components/dialog/Dialog/Dialog.js

@@ -1,34 +1,43 @@
 import { useScrollLock as e } from "../../../hooks/useScrollLock.js";
 import { DialogContext as t } from "./Dialog.context.js";
 import { createComponent as n, insert as r, spread as i, template as a } from "solid-js/web";
-import { createEffect as o, createMemo as s, createSignal as c, splitProps as l } from "solid-js";
+import { createEffect as o, createMemo as s, createSignal as c, onCleanup as l, splitProps as u } from "solid-js";
 //#region src/components/dialog/Dialog/Dialog.tsx
-var u = /*#__PURE__*/ a("<div data-slot=dialog>"), d = (a) => {
-	let [d, f] = l(a, [
+var d = /*#__PURE__*/ a("<div data-slot=dialog>"), f = (a) => {
+	let [f, p] = u(a, [
 		"open",
 		"defaultOpen",
 		"onOpenChange",
 		"lockScroll",
+		"dismissOnEscape",
 		"children"
-	]), p = d.open ?? d.defaultOpen ?? !1, [m, h] = c(p), [g, _] = c(d.defaultOpen ?? !1), v = s(() => d.open === void 0 ? g() : d.open), y = s(() => a.lockScroll ?? !0);
-	return e(() => v() && y(), { allowedSelector: "[data-dialog-surface]" }), o(() => {
-		v() && h(!0);
+	]), m = f.open ?? f.defaultOpen ?? !1, [h, g] = c(m), [_, v] = c(f.defaultOpen ?? !1), y = s(() => f.open === void 0 ? _() : f.open), b = s(() => a.lockScroll ?? !0);
+	e(() => y() && b(), { allowedSelector: "[data-dialog-surface]" });
+	let x = (e) => {
+		f.open === void 0 && v(e), f.onOpenChange?.(e);
+	};
+	return o(() => {
+		if (!y() || f.dismissOnEscape === !1) return;
+		let e = (e) => {
+			e.key !== "Escape" || e.defaultPrevented || (e.preventDefault(), x(!1));
+		};
+		document.addEventListener("keydown", e), l(() => document.removeEventListener("keydown", e));
+	}), o(() => {
+		y() && g(!0);
 	}), n(t.Provider, {
 		value: {
-			show: m,
-			setShow: h,
-			open: v,
-			setOpen: (e) => {
-				d.open === void 0 && _(e), d.onOpenChange?.(e);
-			}
+			show: h,
+			setShow: g,
+			open: y,
+			setOpen: x
 		},
 		get children() {
-			var e = u();
-			return i(e, f, !1, !0), r(e, () => d.children), e;
+			var e = d();
+			return i(e, p, !1, !0), r(e, () => f.children), e;
 		}
 	});
 };
 //#endregion
-export { d as Dialog };
+export { f as Dialog };
 
 //# sourceMappingURL=Dialog.js.map

package/dist/components/dialog/Dialog/Dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"Dialog.js","names":["createEffect","createMemo","createSignal","splitProps","useScrollLock","DialogProps","DialogContext","Dialog","props","local","others","initialOpen","open","defaultOpen","show","setShow","internalOpen","setInternalOpen","undefined","lockScroll","allowedSelector","setOpen","next","onOpenChange","_$createComponent","Provider","value","children","_el$","_tmpl$","_$spread","_$insert","_$createComponent","_tmpl$","Dialog","local","others","splitProps","props","initialOpen","show","setShow","createSignal","internalOpen","setInternalOpen","open","createMemo","lockScroll","useScrollLock","createEffect","createComponent","DialogContext","next","_el$","spread","insert"],"sources":["../../../../src/components/dialog/Dialog/Dialog.tsx"],"sourcesContent":["import { createEffect, createMemo, createSignal, splitProps } from \"solid-js\";\nimport { useScrollLock } from \"~/hooks\";\nimport type { DialogProps } from \"./Dialog.types\";\nimport { DialogContext } from \"./Dialog.context\";\n\nexport const Dialog = (props: DialogProps) => {\n  const [local, others] = splitProps(props, [\n    \"open\",\n    \"defaultOpen\",\n    \"onOpenChange\",\n    \"lockScroll\",\n    \"children\",\n  ]);\n\n  const initialOpen = local.open ?? local.defaultOpen ?? false;\n\n  // 实际显示或卸载信号\n  const [show, setShow] = createSignal(initialOpen);\n  // 内部动画控制信号（非受控模式）\n  const [internalOpen, setInternalOpen] = createSignal(\n    local.defaultOpen ?? false,\n  );\n  // 实际动画控制状态：优先取受控 open，否则取内部状态\n  const open = createMemo(() =>\n    local.open === undefined ? internalOpen() : local.open,\n  );\n  const lockScroll = createMemo(() => props.lockScroll ?? true);\n\n  // 打开期间默认锁定页面滚动：锁住文档滚动并拦截浮层之外的滚轮/触摸，\n  // 内容区自身仍可滚动。传 lockScroll={false} 可关闭该行为。\n  useScrollLock(() => open() && lockScroll(), {\n    allowedSelector: \"[data-dialog-surface]\",\n  });\n\n  const setOpen = (next: boolean) => {\n    if (local.open === undefined) {\n      setInternalOpen(next);\n    }\n    local.onOpenChange?.(next);\n  };\n\n  // 打开时立刻挂载；关闭时保留挂载直到动画结束，由 Content/Overlay 的\n  // onAnimationEnd 负责卸载，保证退场动画能完整播放。\n  createEffect(() => {\n    if (open()) {\n      setShow(true);\n    }\n  });\n\n  return (\n    <DialogContext.Provider\n      value={{\n        show,\n        setShow,\n        open,\n        setOpen,\n      }}\n    >\n      <div data-slot=\"dialog\" {...others}>\n        {local.children}\n      </div>\n    </DialogContext.Provider>\n  );\n};\n"],"mappings":";;;;;mDAKaO,KAAUC,MAAuB;CAC5C,IAAM,CAACC,GAAOC,KAAUP,EAAWK,GAAO;EACxC;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKG,IAAcF,EAAMG,QAAQH,EAAMI,eAAe,IAGjD,CAACC,GAAMC,KAAWb,EAAaS,CAAW,GAE1C,CAACK,GAAcC,KAAmBf,EACtCO,EAAMI,eAAe,EACvB,GAEMD,IAAOX,QACXQ,EAAMG,SAASM,KAAAA,IAAYF,EAAa,IAAIP,EAAMG,IACpD,GACMO,IAAalB,QAAiBO,EAAMW,cAAc,EAAI;CAuB5D,OAnBAf,QAAoBQ,EAAK,KAAKO,EAAW,GAAG,EAC1CC,iBAAiB,wBACnB,CAAC,GAWDpB,QAAmB;EACjB,AAAIY,EAAK,KACPG,EAAQ,EAAI;CAEhB,CAAC,GAEDS,EACGlB,EAAcmB,UAAQ;EACrBC,OAAO;GACLZ;GACAC;GACAH;GACAS,UArBWC,MAAkB;IAIjCb,AAHIA,EAAMG,SAASM,KAAAA,KACjBD,EAAgBK,CAAI,GAEtBb,EAAMc,eAAeD,CAAI;GAC3B;EAiBI;EAAC,IAAAK,WAAA;GAAA,IAAAC,IAAAC,EAAA;GAGgB,OAHhBC,EAAAF,GAE2BlB,GAAM,IAAA,EAAA,GAAAqB,EAAAH,SAC/BnB,EAAMkB,QAAQ,GAAAC;EAAA;CAAA,CAAA;AAIvB"}
+{"version":3,"file":"Dialog.js","names":["createEffect","createMemo","createSignal","onCleanup","splitProps","useScrollLock","DialogProps","DialogContext","Dialog","props","local","others","initialOpen","open","defaultOpen","show","setShow","internalOpen","setInternalOpen","undefined","lockScroll","allowedSelector","setOpen","next","onOpenChange","dismissOnEscape","handleKeyDown","event","KeyboardEvent","key","defaultPrevented","preventDefault","document","addEventListener","removeEventListener","_$createComponent","Provider","value","children","_el$","_tmpl$","_$spread","_$insert","_$createComponent","_tmpl$","Dialog","local","others","splitProps","props","initialOpen","show","setShow","createSignal","internalOpen","setInternalOpen","open","createMemo","lockScroll","setOpen","next","createEffect","handleKeyDown","event","onCleanup","createComponent","DialogContext","_el$","spread","insert"],"sources":["../../../../src/components/dialog/Dialog/Dialog.tsx"],"sourcesContent":["import {\n  createEffect,\n  createMemo,\n  createSignal,\n  onCleanup,\n  splitProps,\n} from \"solid-js\";\nimport { useScrollLock } from \"~/hooks\";\nimport type { DialogProps } from \"./Dialog.types\";\nimport { DialogContext } from \"./Dialog.context\";\n\nexport const Dialog = (props: DialogProps) => {\n  const [local, others] = splitProps(props, [\n    \"open\",\n    \"defaultOpen\",\n    \"onOpenChange\",\n    \"lockScroll\",\n    \"dismissOnEscape\",\n    \"children\",\n  ]);\n\n  const initialOpen = local.open ?? local.defaultOpen ?? false;\n\n  // 实际显示或卸载信号\n  const [show, setShow] = createSignal(initialOpen);\n  // 内部动画控制信号（非受控模式）\n  const [internalOpen, setInternalOpen] = createSignal(\n    local.defaultOpen ?? false,\n  );\n  // 实际动画控制状态：优先取受控 open，否则取内部状态\n  const open = createMemo(() =>\n    local.open === undefined ? internalOpen() : local.open,\n  );\n  const lockScroll = createMemo(() => props.lockScroll ?? true);\n\n  // 打开期间默认锁定页面滚动：锁住文档滚动并拦截浮层之外的滚轮/触摸，\n  // 内容区自身仍可滚动。传 lockScroll={false} 可关闭该行为。\n  useScrollLock(() => open() && lockScroll(), {\n    allowedSelector: \"[data-dialog-surface]\",\n  });\n\n  const setOpen = (next: boolean) => {\n    if (local.open === undefined) {\n      setInternalOpen(next);\n    }\n    local.onOpenChange?.(next);\n  };\n\n  // 打开期间按 Escape 关闭（与 Drawer 一致）\n  createEffect(() => {\n    if (!open() || local.dismissOnEscape === false) return;\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== \"Escape\" || event.defaultPrevented) return;\n      event.preventDefault();\n      setOpen(false);\n    };\n    document.addEventListener(\"keydown\", handleKeyDown);\n    onCleanup(() => document.removeEventListener(\"keydown\", handleKeyDown));\n  });\n\n  // 打开时立刻挂载；关闭时保留挂载直到动画结束，由 Content/Overlay 的\n  // onAnimationEnd 负责卸载，保证退场动画能完整播放。\n  createEffect(() => {\n    if (open()) {\n      setShow(true);\n    }\n  });\n\n  return (\n    <DialogContext.Provider\n      value={{\n        show,\n        setShow,\n        open,\n        setOpen,\n      }}\n    >\n      <div data-slot=\"dialog\" {...others}>\n        {local.children}\n      </div>\n    </DialogContext.Provider>\n  );\n};\n"],"mappings":";;;;;mDAWaQ,KAAUC,MAAuB;CAC5C,IAAM,CAACC,GAAOC,KAAUP,EAAWK,GAAO;EACxC;EACA;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKG,IAAcF,EAAMG,QAAQH,EAAMI,eAAe,IAGjD,CAACC,GAAMC,KAAWd,EAAaU,CAAW,GAE1C,CAACK,GAAcC,KAAmBhB,EACtCQ,EAAMI,eAAe,EACvB,GAEMD,IAAOZ,QACXS,EAAMG,SAASM,KAAAA,IAAYF,EAAa,IAAIP,EAAMG,IACpD,GACMO,IAAanB,QAAiBQ,EAAMW,cAAc,EAAI;CAI5Df,QAAoBQ,EAAK,KAAKO,EAAW,GAAG,EAC1CC,iBAAiB,wBACnB,CAAC;CAED,IAAMC,KAAWC,MAAkB;EAIjCb,AAHIA,EAAMG,SAASM,KAAAA,KACjBD,EAAgBK,CAAI,GAEtBb,EAAMc,eAAeD,CAAI;CAC3B;CAsBA,OAnBAvB,QAAmB;EACjB,IAAI,CAACa,EAAK,KAAKH,EAAMe,oBAAoB,IAAO;EAChD,IAAMC,KAAiBC,MAAyB;GAC9C,AAAIA,EAAME,QAAQ,YAAYF,EAAMG,qBACpCH,EAAMI,eAAe,GACrBT,EAAQ,EAAK;EACf;EAEAnB,AADA6B,SAASC,iBAAiB,WAAWP,CAAa,GAClDvB,QAAgB6B,SAASE,oBAAoB,WAAWR,CAAa,CAAC;CACxE,CAAC,GAID1B,QAAmB;EACjB,AAAIa,EAAK,KACPG,EAAQ,EAAI;CAEhB,CAAC,GAEDmB,EACG5B,EAAc6B,UAAQ;EACrBC,OAAO;GACLtB;GACAC;GACAH;GACAS;EACF;EAAC,IAAAgB,WAAA;GAAA,IAAAC,IAAAC,EAAA;GAGgB,OAHhBC,EAAAF,GAE2B5B,GAAM,IAAA,EAAA,GAAA+B,EAAAH,SAC/B7B,EAAM4B,QAAQ,GAAAC;EAAA;CAAA,CAAA;AAIvB"}

package/dist/components/dialog/Dialog/Dialog.types.d.ts

@@ -9,6 +9,11 @@ interface BaseDialogProps {
     defaultOpen?: boolean;
     /** 打开状态变化时回调 */
     onOpenChange?: (open: boolean) => void;
+    /**
+     * 按 Escape 是否关闭，默认 true。
+     * AlertDialog 需要"必须显式选择"，因此传 false（对齐 Base UI 的 alert dialog 语义）。
+     */
+    dismissOnEscape?: boolean;
     /**
      * 打开时是否锁定页面滚动，默认 true：锁住文档滚动并拦截浮层之外的
      * 滚轮/触摸滚动，内容区自身仍可滚动。