@cube-dev/ui-kit 0.135.0 → 0.136.0

package/dist/components/actions/Menu/MenuTrigger.js

@@ -1,8 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { SlotProvider } from "../../../utils/react/Slots.js";
-import { useEventBus } from "../../../utils/react/useEventBus.js";
+import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { MenuContext } from "./context.js";
 import { generateRandomId } from "../../../utils/random.js";
+import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";
 import { _Tray } from "../../overlays/Modal/Tray.js";
 import { _Popover } from "../../overlays/Modal/Popover.js";
 import { Fragment, forwardRef, useEffect, useMemo, useRef } from "react";
@@ -20,29 +21,17 @@ function MenuTrigger(props, ref) {
 	const menuTriggerRef = props.targetRef || domRef || triggerRef;
 	const menuRef = useRef(null);
 	const wasOpenRef = useRef(false);
-	const { children, shouldFlip = true, closeOnSelect, trigger = "press", isDisabled, isDummy } = props;
+	const { children, shouldFlip = true, closeOnSelect, trigger = "press", isDisabled, isDummy, mobileType = "popover" } = props;
 	const menuId = useMemo(() => generateRandomId(), []);
-	const { emit, on } = useEventBus();
 	if (!Array.isArray(children) || children.length > 2) throw new Error("MenuTrigger must have exactly 2 children");
 	let [menuTrigger, menu] = children;
 	const state = useMenuTriggerState(props);
-	useEffect(() => {
-		return on("popover:open", (data) => {
-			if (data.menuId !== menuId && state.isOpen && !isDummy) state.close();
-		});
-	}, [
-		on,
-		menuId,
-		state
-	]);
-	useEffect(() => {
-		if (state.isOpen && !isDummy) emit("popover:open", { menuId });
-	}, [
-		state.isOpen,
-		emit,
+	usePopoverSync({
 		menuId,
-		isDummy
-	]);
+		isOpen: state.isOpen,
+		onClose: () => state.close(),
+		enabled: !isDummy
+	});
 	useEffect(() => {
 		if (!state.isOpen && wasOpenRef.current && !isDummy) {
 			wasOpenRef.current = false;
@@ -58,14 +47,15 @@ function MenuTrigger(props, ref) {
 	if (typeof menuTrigger === "function") menuTrigger = menuTrigger(state);
 	const { menuTriggerProps, menuProps } = useMenuTrigger({ isDisabled }, state, menuTriggerRef);
 	let initialPlacement = props.placement ?? "bottom start";
-	const isMobile = useIsMobileDevice();
+	const isMobileDevice = useIsMobileDevice();
+	const isTray = mobileType === "tray" && isMobileDevice;
 	const { overlayProps: positionProps, placement } = useOverlayPosition({
 		targetRef: menuTriggerRef,
 		overlayRef: menuPopoverRef,
 		scrollRef: menuRef,
 		placement: initialPlacement,
 		shouldFlip,
-		isOpen: state.isOpen && !isMobile,
+		isOpen: state.isOpen && !isTray,
 		onClose: state.close,
 		containerPadding: props.containerPadding,
 		offset: props.offset ?? 8,
@@ -77,13 +67,13 @@ function MenuTrigger(props, ref) {
 		onClose: state.close,
 		closeOnSelect,
 		autoFocus: state.focusStrategy ?? "first",
-		style: isMobile ? {
+		style: isTray ? {
 			width: "100%",
 			maxHeight: "inherit"
 		} : void 0,
 		mods: {
-			popover: !isMobile,
-			tray: isMobile
+			popover: !isTray,
+			tray: isTray
 		},
 		isClosing: !state.isOpen
 	};
@@ -92,9 +82,24 @@ function MenuTrigger(props, ref) {
 		menu,
 		/* @__PURE__ */ jsx(DismissButton, { onDismiss: state.close })
 	] });
+	const shouldCloseOnInteractOutside = useEvent((el) => {
+		if (!state.isOpen) return false;
+		const menuTriggerEl = el.closest("[data-popover-trigger]");
+		if (!menuTriggerEl) {
+			if (el.closest("[data-popover-dismiss]")) {
+				setTimeout(() => state.close(), 0);
+				return false;
+			}
+			return true;
+		}
+		if (isDummy && (menuTriggerEl === menuTriggerRef.current || menuTriggerRef.current?.contains(el))) return true;
+		if (menuTriggerEl === menuTriggerRef.current) return true;
+		return false;
+	});
 	let overlay;
-	if (isMobile) overlay = /* @__PURE__ */ jsx(_Tray, {
+	if (isTray) overlay = /* @__PURE__ */ jsx(_Tray, {
 		isOpen: state.isOpen,
+		shouldCloseOnInteractOutside,
 		onClose: state.close,
 		children: contents
 	});
@@ -105,13 +110,7 @@ function MenuTrigger(props, ref) {
 		isOpen: state.isOpen,
 		style: positionProps.style,
 		placement,
-		shouldCloseOnInteractOutside: (el) => {
-			const menuTriggerEl = el.closest("[data-popover-trigger]");
-			if (!menuTriggerEl) return true;
-			if (isDummy && (menuTriggerEl === menuTriggerRef.current || menuTriggerRef.current?.contains(el))) return true;
-			if (menuTriggerEl === menuTriggerRef.current) return true;
-			return false;
-		},
+		shouldCloseOnInteractOutside,
 		onClose: state.close,
 		children: contents
 	});

package/dist/components/actions/Menu/MenuTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuTrigger.js","names":["Tray","Popover"],"sources":["../../../../src/components/actions/Menu/MenuTrigger.tsx"],"sourcesContent":["import { PressResponder } from '@react-aria/interactions';\nimport { useDOMRef, useIsMobileDevice } from '@react-spectrum/utils';\nimport { DOMRef } from '@react-types/shared';\nimport {\n  forwardRef,\n  Fragment,\n  ReactElement,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  Placement,\n  PositionProps,\n  useMenuTrigger,\n  useOverlayPosition,\n} from 'react-aria';\nimport { MenuTriggerState, useMenuTriggerState } from 'react-stately';\n\nimport { generateRandomId } from '../../../utils/random';\nimport { SlotProvider } from '../../../utils/react';\nimport { useEventBus } from '../../../utils/react/useEventBus';\nimport { Popover, Tray } from '../../overlays/Modal';\n\nimport { MenuContext, MenuContextValue } from './context';\n\nexport type { AriaMenuTriggerProps };\n\nexport type CubeMenuTriggerProps = AriaMenuTriggerProps &\n  PositionProps & {\n    isDisabled?: boolean;\n    children: [\n      ReactElement | ((state: MenuTriggerState) => ReactElement),\n      ReactElement,\n    ];\n\n    closeOnSelect?: boolean;\n    isDummy?: boolean;\n  };\n\nfunction MenuTrigger(props: CubeMenuTriggerProps, ref: DOMRef<HTMLElement>) {\n  const menuPopoverRef = useRef<HTMLDivElement>(null);\n  const triggerRef = useRef<HTMLElement>(null);\n  const domRef = useDOMRef(ref);\n  const menuTriggerRef = props.targetRef || domRef || triggerRef;\n  const menuRef = useRef<HTMLUListElement>(null);\n  const wasOpenRef = useRef(false);\n  const {\n    children,\n    shouldFlip = true,\n    closeOnSelect,\n    trigger = 'press',\n    isDisabled,\n    isDummy,\n  } = props;\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  // Get event bus for menu synchronization\n  const { emit, on } = useEventBus();\n\n  if (!Array.isArray(children) || children.length > 2) {\n    throw new Error('MenuTrigger must have exactly 2 children');\n  }\n\n  let [menuTrigger, menu] = children;\n  const state: MenuTriggerState = useMenuTriggerState(props);\n\n  // Listen for other menus opening and close this one if needed\n  useEffect(() => {\n    const unsubscribe = on('popover:open', (data: { menuId: string }) => {\n      // If another menu is opening and this menu is open, close this one\n      if (data.menuId !== menuId && state.isOpen && !isDummy) {\n        state.close();\n      }\n    });\n\n    return unsubscribe;\n  }, [on, menuId, state]);\n\n  // Emit event when this menu opens\n  useEffect(() => {\n    if (state.isOpen && !isDummy) {\n      emit('popover:open', { menuId });\n    }\n  }, [state.isOpen, emit, menuId, isDummy]);\n\n  // Restore focus manually when the menu closes\n  useEffect(() => {\n    if (!state.isOpen && wasOpenRef.current && !isDummy) {\n      wasOpenRef.current = false;\n      // Use setTimeout to ensure focus restoration happens after any animations\n      setTimeout(() => {\n        menuTriggerRef.current?.focus();\n      }, 0);\n    } else if (state.isOpen) {\n      wasOpenRef.current = true;\n    }\n  }, [state.isOpen, menuTriggerRef, isDummy]);\n\n  if (typeof menuTrigger === 'function') {\n    menuTrigger = (menuTrigger as CubeMenuTriggerProps['children'][0])(state);\n  }\n\n  const { menuTriggerProps, menuProps } = useMenuTrigger(\n    { isDisabled },\n    state,\n    menuTriggerRef,\n  );\n\n  let initialPlacement: Placement = props.placement ?? 'bottom start';\n\n  const isMobile = useIsMobileDevice();\n  const { overlayProps: positionProps, placement } = useOverlayPosition({\n    targetRef: menuTriggerRef,\n    overlayRef: menuPopoverRef,\n    scrollRef: menuRef,\n    placement: initialPlacement,\n    shouldFlip: shouldFlip,\n    isOpen: state.isOpen && !isMobile,\n    onClose: state.close,\n    containerPadding: props.containerPadding,\n    offset: props.offset ?? 8,\n    crossOffset: props.crossOffset ?? 0,\n  });\n\n  const menuContext = {\n    ...menuProps,\n    ref: menuRef,\n    onClose: state.close,\n    closeOnSelect,\n    autoFocus: (state.focusStrategy as any) ?? 'first',\n    style: isMobile\n      ? {\n          width: '100%',\n          maxHeight: 'inherit',\n        }\n      : undefined,\n    mods: {\n      popover: !isMobile,\n      tray: isMobile,\n    },\n    isClosing: !state.isOpen,\n  } as MenuContextValue;\n\n  const contents = (\n    <>\n      <DismissButton onDismiss={state.close} />\n      {menu}\n      <DismissButton onDismiss={state.close} />\n    </>\n  );\n\n  // On small screen devices, the menu is rendered in a tray, otherwise a popover.\n  let overlay;\n  if (isMobile) {\n    overlay = (\n      <Tray isOpen={state.isOpen} onClose={state.close}>\n        {contents}\n      </Tray>\n    );\n  } else {\n    overlay = (\n      <Popover\n        ref={menuPopoverRef}\n        hideArrow\n        isNonModal\n        isOpen={state.isOpen}\n        style={positionProps.style}\n        placement={placement}\n        shouldCloseOnInteractOutside={(el) => {\n          const menuTriggerEl = el.closest('[data-popover-trigger]');\n          // If no menu trigger was clicked, allow closing\n          if (!menuTriggerEl) return true;\n          // For dummy triggers (like useAnchoredMenu), check if the clicked element\n          // is the target element or its descendant\n          if (\n            isDummy &&\n            (menuTriggerEl === menuTriggerRef.current ||\n              menuTriggerRef.current?.contains(el))\n          ) {\n            return true;\n          }\n          // If the same trigger that opened this menu was clicked, allow closing\n          if (menuTriggerEl === menuTriggerRef.current) return true;\n          // Otherwise, don't close (let event mechanism handle it)\n          return false;\n        }}\n        onClose={state.close}\n      >\n        {contents}\n      </Popover>\n    );\n  }\n\n  return (\n    <Fragment>\n      <SlotProvider\n        slots={{ actionButton: { holdAffordance: trigger === 'longPress' } }}\n      >\n        {!isDummy ? (\n          <PressResponder\n            {...menuTriggerProps}\n            ref={menuTriggerRef}\n            data-popover-trigger\n            isPressed={state.isOpen}\n          >\n            {menuTrigger}\n          </PressResponder>\n        ) : null}\n      </SlotProvider>\n      <MenuContext.Provider value={menuContext}>{overlay}</MenuContext.Provider>\n    </Fragment>\n  );\n}\n\n/**\n * The MenuTrigger serves as a wrapper around a Menu and its associated trigger,\n * linking the Menu's open state with the trigger's press state.\n */\nlet _MenuTrigger = forwardRef(MenuTrigger);\n\n_MenuTrigger.displayName = 'MenuTrigger';\n\nexport { _MenuTrigger as MenuTrigger };\n"],"mappings":"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"}
+{"version":3,"file":"MenuTrigger.js","names":["Tray","Popover"],"sources":["../../../../src/components/actions/Menu/MenuTrigger.tsx"],"sourcesContent":["import { PressResponder } from '@react-aria/interactions';\nimport { useDOMRef, useIsMobileDevice } from '@react-spectrum/utils';\nimport { DOMRef } from '@react-types/shared';\nimport {\n  forwardRef,\n  Fragment,\n  ReactElement,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  Placement,\n  PositionProps,\n  useMenuTrigger,\n  useOverlayPosition,\n} from 'react-aria';\nimport { MenuTriggerState, useMenuTriggerState } from 'react-stately';\n\nimport { useEvent } from '../../../_internal';\nimport { generateRandomId } from '../../../utils/random';\nimport { SlotProvider } from '../../../utils/react';\nimport { usePopoverSync } from '../../../utils/react/usePopoverSync';\nimport { Popover, Tray } from '../../overlays/Modal';\n\nimport { MenuContext, MenuContextValue } from './context';\n\nexport type { AriaMenuTriggerProps };\n\nexport type CubeMenuTriggerProps = AriaMenuTriggerProps &\n  PositionProps & {\n    isDisabled?: boolean;\n    children: [\n      ReactElement | ((state: MenuTriggerState) => ReactElement),\n      ReactElement,\n    ];\n\n    closeOnSelect?: boolean;\n    isDummy?: boolean;\n    /**\n     * Overlay variant to use on mobile screens. Defaults to `'popover'`, which\n     * keeps the desktop overlay even on small viewports. Pass `'tray'` to opt\n     * into the bottom-sheet `Tray` overlay on mobile (the previous implicit\n     * default). Mirrors the `mobileType` API on `DialogTrigger`.\n     */\n    mobileType?: 'popover' | 'tray';\n  };\n\nfunction MenuTrigger(props: CubeMenuTriggerProps, ref: DOMRef<HTMLElement>) {\n  const menuPopoverRef = useRef<HTMLDivElement>(null);\n  const triggerRef = useRef<HTMLElement>(null);\n  const domRef = useDOMRef(ref);\n  const menuTriggerRef = props.targetRef || domRef || triggerRef;\n  const menuRef = useRef<HTMLUListElement>(null);\n  const wasOpenRef = useRef(false);\n  const {\n    children,\n    shouldFlip = true,\n    closeOnSelect,\n    trigger = 'press',\n    isDisabled,\n    isDummy,\n    mobileType = 'popover',\n  } = props;\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  if (!Array.isArray(children) || children.length > 2) {\n    throw new Error('MenuTrigger must have exactly 2 children');\n  }\n\n  let [menuTrigger, menu] = children;\n  const state: MenuTriggerState = useMenuTriggerState(props);\n\n  usePopoverSync({\n    menuId,\n    isOpen: state.isOpen,\n    onClose: () => state.close(),\n    enabled: !isDummy,\n  });\n\n  // Restore focus manually when the menu closes\n  useEffect(() => {\n    if (!state.isOpen && wasOpenRef.current && !isDummy) {\n      wasOpenRef.current = false;\n      // Use setTimeout to ensure focus restoration happens after any animations\n      setTimeout(() => {\n        menuTriggerRef.current?.focus();\n      }, 0);\n    } else if (state.isOpen) {\n      wasOpenRef.current = true;\n    }\n  }, [state.isOpen, menuTriggerRef, isDummy]);\n\n  if (typeof menuTrigger === 'function') {\n    menuTrigger = (menuTrigger as CubeMenuTriggerProps['children'][0])(state);\n  }\n\n  const { menuTriggerProps, menuProps } = useMenuTrigger(\n    { isDisabled },\n    state,\n    menuTriggerRef,\n  );\n\n  let initialPlacement: Placement = props.placement ?? 'bottom start';\n\n  // Tray rendering is now opt-in via `mobileType=\"tray\"` (matches DialogTrigger).\n  // Without that opt-in, MenuTrigger always renders a Popover so that environments\n  // like jsdom (where `window.screen.width === 0` makes useIsMobileDevice() true)\n  // don't accidentally swap in the tray overlay.\n  const isMobileDevice = useIsMobileDevice();\n  const isTray = mobileType === 'tray' && isMobileDevice;\n  const { overlayProps: positionProps, placement } = useOverlayPosition({\n    targetRef: menuTriggerRef,\n    overlayRef: menuPopoverRef,\n    scrollRef: menuRef,\n    placement: initialPlacement,\n    shouldFlip: shouldFlip,\n    isOpen: state.isOpen && !isTray,\n    onClose: state.close,\n    containerPadding: props.containerPadding,\n    offset: props.offset ?? 8,\n    crossOffset: props.crossOffset ?? 0,\n  });\n\n  const menuContext = {\n    ...menuProps,\n    ref: menuRef,\n    onClose: state.close,\n    closeOnSelect,\n    autoFocus: (state.focusStrategy as any) ?? 'first',\n    style: isTray\n      ? {\n          width: '100%',\n          maxHeight: 'inherit',\n        }\n      : undefined,\n    mods: {\n      popover: !isTray,\n      tray: isTray,\n    },\n    isClosing: !state.isOpen,\n  } as MenuContextValue;\n\n  const contents = (\n    <>\n      <DismissButton onDismiss={state.close} />\n      {menu}\n      <DismissButton onDismiss={state.close} />\n    </>\n  );\n\n  // Shared between the Popover and Tray branches so both react-aria\n  // `useOverlay` calls see the same predicate. Without this, the Tray branch\n  // falls back to unconditional dismiss-on-outside-interaction, which\n  // `useOverlay` translates into stopPropagation/preventDefault in the\n  // capture phase — that swallows clicks on sibling triggers (see Menu\n  // rapid-open test).\n  //\n  // `useEvent` gives us a single stable callback reference for the lifetime\n  // of the component while always reading the latest closure values. This\n  // matters because `useMenuTriggerState` returns a fresh `state` object on\n  // every render, so a vanilla `useCallback([..., state])` would produce a\n  // new function every render and defeat any stability guarantees consumers\n  // rely on.\n  const shouldCloseOnInteractOutside = useEvent((el: Element) => {\n    // While `Popover` is animating out, `useInteractOutside`'s capture-phase\n    // listener is still attached (jsdom 29+ uses pointerdown/click capture).\n    // The animation lasts ~350ms; without this guard, clicks on a sibling\n    // trigger during the exit window get stopPropagation()'d and the\n    // sibling's `onClick` never runs — breaking rapid-open and \"open menu\n    // again with new props\" flows. Reading `state.isOpen` directly is safe\n    // because `useEvent` always sees the latest closure.\n    if (!state.isOpen) return false;\n\n    const menuTriggerEl = el.closest('[data-popover-trigger]');\n    if (!menuTriggerEl) {\n      // Plain interactive controls (Button, ItemButton) opt in via\n      // `data-popover-dismiss`. We schedule the close via setTimeout(0) so\n      // it lands AFTER the click event finishes — the button's onPress\n      // fires first, then the popover closes. Without this, useOverlay\n      // would stopPropagation() the click and the user would need a second\n      // click to actually press the button.\n      if (el.closest('[data-popover-dismiss]')) {\n        setTimeout(() => state.close(), 0);\n        return false;\n      }\n      return true;\n    }\n    if (\n      isDummy &&\n      (menuTriggerEl === menuTriggerRef.current ||\n        menuTriggerRef.current?.contains(el))\n    ) {\n      return true;\n    }\n    if (menuTriggerEl === menuTriggerRef.current) return true;\n    return false;\n  });\n\n  let overlay;\n  if (isTray) {\n    overlay = (\n      <Tray\n        isOpen={state.isOpen}\n        shouldCloseOnInteractOutside={shouldCloseOnInteractOutside}\n        onClose={state.close}\n      >\n        {contents}\n      </Tray>\n    );\n  } else {\n    overlay = (\n      <Popover\n        ref={menuPopoverRef}\n        hideArrow\n        isNonModal\n        isOpen={state.isOpen}\n        style={positionProps.style}\n        placement={placement}\n        shouldCloseOnInteractOutside={shouldCloseOnInteractOutside}\n        onClose={state.close}\n      >\n        {contents}\n      </Popover>\n    );\n  }\n\n  return (\n    <Fragment>\n      <SlotProvider\n        slots={{ actionButton: { holdAffordance: trigger === 'longPress' } }}\n      >\n        {!isDummy ? (\n          <PressResponder\n            {...menuTriggerProps}\n            ref={menuTriggerRef}\n            data-popover-trigger\n            isPressed={state.isOpen}\n          >\n            {menuTrigger}\n          </PressResponder>\n        ) : null}\n      </SlotProvider>\n      <MenuContext.Provider value={menuContext}>{overlay}</MenuContext.Provider>\n    </Fragment>\n  );\n}\n\n/**\n * The MenuTrigger serves as a wrapper around a Menu and its associated trigger,\n * linking the Menu's open state with the trigger's press state.\n */\nlet _MenuTrigger = forwardRef(MenuTrigger);\n\n_MenuTrigger.displayName = 'MenuTrigger';\n\nexport { _MenuTrigger as MenuTrigger };\n"],"mappings":"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"}

package/dist/components/actions/Menu/SubMenuTrigger.js

@@ -1,8 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
-import { useEventBus } from "../../../utils/react/useEventBus.js";
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { MenuContext, useMenuContext } from "./context.js";
 import { SubmenuTriggerContext } from "./SubmenuTriggerContext.js";
 import { generateRandomId } from "../../../utils/random.js";
+import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";
 import { _Popover } from "../../overlays/Modal/Popover.js";
 import React, { useEffect, useMemo, useRef } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -22,8 +22,11 @@ function InternalSubMenuTrigger(props) {
 	const { children, placement = DEFAULT_PLACEMENT, offset = DEFAULT_OFFSET, crossOffset = DEFAULT_CROSS_OFFSET, shouldFlip = true, isDisabled, autoFocus = "first", onAction, targetKey, ...overlayProps } = props;
 	const [menuTrigger, menu] = React.Children.toArray(children);
 	const state = useMenuTriggerState(props);
-	const submenuId = useMemo(() => generateRandomId(), []);
-	const { emit, on } = useEventBus();
+	usePopoverSync({
+		menuId: useMemo(() => generateRandomId(), []),
+		isOpen: state.isOpen,
+		onClose: () => state.close()
+	});
 	const domTriggerRef = useRef(null);
 	const popoverRef = useRef(null);
 	const menuRef = useRef(null);
@@ -69,22 +72,6 @@ function InternalSubMenuTrigger(props) {
 		parentContext.isClosing
 	]);
 	useSyncRef(parentContext, domTriggerRef);
-	useEffect(() => {
-		return on("popover:open", (data) => {
-			if (data.menuId !== submenuId && state.isOpen) state.close();
-		});
-	}, [
-		on,
-		submenuId,
-		state
-	]);
-	useEffect(() => {
-		if (state.isOpen) emit("popover:open", { menuId: submenuId });
-	}, [
-		state.isOpen,
-		emit,
-		submenuId
-	]);
 	useEffect(() => {
 		return () => {
 			if (hoverOpenTimerRef.current) clearTimeout(hoverOpenTimerRef.current);

package/dist/components/actions/Menu/SubMenuTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubMenuTrigger.js","names":["Popover"],"sources":["../../../../src/components/actions/Menu/SubMenuTrigger.tsx"],"sourcesContent":["import { useSyncRef } from '@react-aria/utils';\nimport React, {\n  Key,\n  ReactElement,\n  ReactNode,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  Placement,\n  useMenuTrigger,\n  useOverlayPosition,\n} from 'react-aria';\nimport { useMenuTriggerState } from 'react-stately';\n\nimport { generateRandomId } from '../../../utils/random';\nimport { useEventBus } from '../../../utils/react/useEventBus';\nimport { Popover } from '../../overlays/Modal';\n\nimport { MenuContext, MenuContextValue, useMenuContext } from './context';\nimport { SubmenuTriggerContext } from './SubmenuTriggerContext';\n\n// Default placement & offset for sub-menus (matches Spectrum / Aria)\nconst DEFAULT_PLACEMENT: Placement = 'right top';\nconst DEFAULT_OFFSET = 4;\nconst DEFAULT_CROSS_OFFSET = -5;\n\nexport interface CubeSubMenuTriggerProps extends AriaMenuTriggerProps {\n  /** The preferred placement of the sub-menu relative to the trigger */\n  placement?: Placement;\n\n  /** Distance in pixels between the trigger and sub-menu */\n  offset?: number;\n\n  /** Distance in pixels along the cross axis from the default alignment */\n  crossOffset?: number;\n\n  /** Whether the sub-menu should flip to the opposite side when it would overflow */\n  shouldFlip?: boolean;\n\n  /** Minimum padding in pixels between the sub-menu and viewport edges */\n  containerPadding?: number;\n\n  /**\n   * Sub-menu trigger and the sub-menu itself. Must be exactly two React nodes.\n   *\n   * 1) Trigger – **must render `<li role=\"menuitem\">`** (usually `Menu.Item`).\n   * 2) Sub-menu – a `<Menu>` element.\n   */\n  children: [ReactNode, ReactElement];\n\n  /** Whether the trigger is disabled and cannot be activated */\n  isDisabled?: boolean;\n\n  /**\n   * Callback fired when an action is selected from the sub-menu.\n   * Bubbles the `onAction` event from the sub-menu to parent components.\n   */\n  onAction?: (key: Key) => void;\n\n  /**\n   * Controls focus behavior when the sub-menu opens.\n   * - `true` or `'first'`: Focus the first item\n   * - `'last'`: Focus the last item\n   * - `false`: Don't auto-focus any item\n   * @default 'first'\n   */\n  autoFocus?: boolean | 'first' | 'last';\n}\n\ninterface InternalSubMenuTriggerProps extends CubeSubMenuTriggerProps {\n  targetKey?: Key;\n}\n\n/**\n * Internal SubMenuTrigger that receives the already-rendered trigger element\n * from the collection system and wraps it with submenu behavior.\n */\nfunction InternalSubMenuTrigger(props: InternalSubMenuTriggerProps) {\n  const {\n    children,\n    placement = DEFAULT_PLACEMENT,\n    offset = DEFAULT_OFFSET,\n    crossOffset = DEFAULT_CROSS_OFFSET,\n    shouldFlip = true,\n    isDisabled,\n    autoFocus = 'first',\n    onAction,\n    targetKey,\n    ...overlayProps\n  } = props;\n\n  // Children: [menuTrigger (already rendered MenuItem), menu (Menu component)]\n  const [menuTrigger, menu] = React.Children.toArray(children) as [\n    ReactElement,\n    ReactElement,\n  ];\n\n  const state = useMenuTriggerState(props as AriaMenuTriggerProps);\n\n  // Generate a unique ID for this submenu instance\n  const submenuId = useMemo(() => generateRandomId(), []);\n\n  // Get event bus for submenu synchronization\n  const { emit, on } = useEventBus();\n\n  // Refs – trigger (MenuItem <li>) and overlay (<div> from Popover)\n  const domTriggerRef = useRef<HTMLElement>(null);\n  const popoverRef = useRef<HTMLDivElement>(null);\n  const menuRef = useRef<HTMLUListElement>(null);\n\n  // Strip keyboard/press handlers that we will implement ourselves\n  const { menuTriggerProps: rawTriggerProps, menuProps } = useMenuTrigger(\n    { type: 'submenu', isDisabled },\n    state,\n    domTriggerRef,\n  );\n\n  // Get parent context to check if parent menu is closing\n  const parentContext = useMenuContext();\n\n  // Remove default onKeyDown/onPress handlers from trigger props – we implement custom ones\n  const {\n    onKeyDown: _mtOnKeyDown,\n    onPress: _mtOnPress,\n    onPressStart: _mtOnPressStart,\n    onKeyUp: _mtOnKeyUp,\n    ...menuTriggerProps\n  } = rawTriggerProps;\n\n  const { overlayProps: positionProps } = useOverlayPosition({\n    targetRef: domTriggerRef,\n    overlayRef: popoverRef,\n    scrollRef: menuRef,\n    placement,\n    offset: offset as number,\n    crossOffset: crossOffset as number,\n    shouldFlip,\n    isOpen: state.isOpen,\n    onClose: state.close,\n  });\n\n  /**\n   * Build a MenuContext for the nested menu so it behaves just like a regular\n   * popover-based Menu (selection handling, focus management, etc.).\n   */\n  const nestedMenuContext = useMemo(() => {\n    const ctx: MenuContextValue = {\n      ...menuProps,\n      ref: menuRef,\n      // Pass the parent's onClose to close the entire menu hierarchy\n      onClose: () => {\n        // Close this submenu state immediately\n        state.close();\n\n        // Then close the parent menu\n        if (parentContext.onClose) {\n          parentContext.onClose();\n        }\n      },\n      closeOnSelect: true,\n      autoFocus,\n      mods: {\n        popover: true,\n      },\n      // Propagate closing state from parent\n      isClosing: parentContext.isClosing || !state.isOpen,\n    };\n\n    return ctx;\n  }, [\n    menuProps,\n    autoFocus,\n    state,\n    parentContext.onClose,\n    parentContext.isClosing,\n  ]);\n\n  // Sync the parent selection manager focus with DOM ref (for virtual focus scenarios)\n  useSyncRef(parentContext, domTriggerRef);\n\n  // Listen for other menus opening and close this submenu if needed\n  useEffect(() => {\n    const unsubscribe = on('popover:open', (data: { menuId: string }) => {\n      // If another menu is opening and this submenu is open, close this one\n      if (data.menuId !== submenuId && state.isOpen) {\n        state.close();\n      }\n    });\n\n    return unsubscribe;\n  }, [on, submenuId, state]);\n\n  // Emit event when this submenu opens\n  useEffect(() => {\n    if (state.isOpen) {\n      emit('popover:open', { menuId: submenuId });\n    }\n  }, [state.isOpen, emit, submenuId]);\n\n  // Cleanup hover timers and reset refs on unmount\n  useEffect(() => {\n    return () => {\n      if (hoverOpenTimerRef.current) {\n        clearTimeout(hoverOpenTimerRef.current);\n      }\n      if (hoverCloseTimerRef.current) {\n        clearTimeout(hoverCloseTimerRef.current);\n      }\n      isHoveringRef.current = false;\n      isHoveringSubmenuRef.current = false;\n    };\n  }, []);\n\n  // ----- Render -----\n\n  // Handle keyboard navigation\n  const handleKeyDown = (e: React.KeyboardEvent) => {\n    if (isDisabled) return;\n\n    // Arrow right opens submenu\n    if (e.key === 'ArrowRight') {\n      e.preventDefault();\n      e.stopPropagation();\n      state.open();\n    }\n    // Enter or Space opens submenu (suppress subsequent onAction)\n    else if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      e.stopPropagation();\n      // Stop immediate propagation to prevent React Aria's handlers from running\n      e.nativeEvent.stopImmediatePropagation();\n      state.open();\n      suppressNextActionRef.current = true; // Remember it was keyboard\n    }\n    // Arrow left closes submenu if open\n    else if (e.key === 'ArrowLeft' && state.isOpen) {\n      e.preventDefault();\n      e.stopPropagation();\n      state.close();\n    }\n  };\n\n  // Use refs to store timer IDs\n  const hoverOpenTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const hoverCloseTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Track if mouse is over trigger or submenu\n  const isHoveringRef = useRef(false);\n  const isHoveringSubmenuRef = useRef(false);\n\n  // Track whether the next onAction comes from a keyboard press\n  const suppressNextActionRef = useRef(false);\n\n  const checkShouldClose = () => {\n    // Only close if mouse is not over trigger OR submenu\n    if (!isHoveringRef.current && !isHoveringSubmenuRef.current) {\n      hoverCloseTimerRef.current = setTimeout(() => {\n        // Double check before closing\n        if (!isHoveringRef.current && !isHoveringSubmenuRef.current) {\n          state.close();\n        }\n      }, 300);\n    }\n  };\n\n  // Handle mouse interactions on trigger\n  const handleMouseEnter = () => {\n    if (isDisabled) return;\n\n    isHoveringRef.current = true;\n\n    // Clear any pending close timer\n    if (hoverCloseTimerRef.current) {\n      clearTimeout(hoverCloseTimerRef.current);\n      hoverCloseTimerRef.current = null;\n    }\n\n    // Use a small delay to prevent accidental opens\n    if (!state.isOpen) {\n      hoverOpenTimerRef.current = setTimeout(() => {\n        if (isHoveringRef.current) {\n          state.open();\n        }\n      }, 200);\n    }\n  };\n\n  const handleMouseLeave = () => {\n    isHoveringRef.current = false;\n\n    // Clear open timer if it exists\n    if (hoverOpenTimerRef.current) {\n      clearTimeout(hoverOpenTimerRef.current);\n      hoverOpenTimerRef.current = null;\n    }\n\n    // Check if we should close\n    checkShouldClose();\n  };\n\n  // Handle mouse events on the submenu popover\n  const handlePopoverMouseEnter = () => {\n    isHoveringSubmenuRef.current = true;\n\n    // Clear any pending close timer when entering submenu\n    if (hoverCloseTimerRef.current) {\n      clearTimeout(hoverCloseTimerRef.current);\n      hoverCloseTimerRef.current = null;\n    }\n  };\n\n  const handlePopoverMouseLeave = () => {\n    isHoveringSubmenuRef.current = false;\n\n    // Check if we should close\n    checkShouldClose();\n  };\n\n  // Merge event handlers\n  const mergeHandler = (handler1: any, handler2: any) => {\n    return (...args: any[]) => {\n      handler1?.(...args);\n      handler2?.(...args);\n    };\n  };\n\n  // Provide context to the trigger element (already rendered MenuItem)\n  const triggerContextValue = useMemo(\n    () => ({\n      triggerRef: domTriggerRef,\n      triggerProps: menuTriggerProps,\n      isOpen: state.isOpen,\n      isDisabled,\n      onMouseEnter: handleMouseEnter,\n      onMouseLeave: handleMouseLeave,\n      onKeyDown: handleKeyDown,\n      onAction: isDisabled\n        ? undefined\n        : () => {\n            // Ignore the synthetic press generated by the same Enter/Space\n            if (suppressNextActionRef.current) {\n              suppressNextActionRef.current = false;\n              return;\n            }\n            // This is a mouse click, open the submenu\n            state.open();\n          },\n    }),\n    [\n      state,\n      isDisabled,\n      handleMouseEnter,\n      handleMouseLeave,\n      handleKeyDown,\n      menuTriggerProps,\n    ],\n  );\n\n  return (\n    <>\n      <SubmenuTriggerContext.Provider value={triggerContextValue}>\n        {menuTrigger}\n      </SubmenuTriggerContext.Provider>\n      {state.isOpen && (\n        <Popover\n          ref={popoverRef}\n          hideArrow\n          isNonModal\n          isOpen={!parentContext.isClosing}\n          style={positionProps.style}\n          placement={placement as Placement}\n          onClose={state.close}\n          // Spread any additional overlay props\n          {...overlayProps}\n        >\n          {/* Wrap content in a div to capture mouse events */}\n          <div\n            style={{ display: 'contents' }}\n            onMouseEnter={handlePopoverMouseEnter}\n            onMouseLeave={handlePopoverMouseLeave}\n          >\n            {/* Dismiss buttons for screen reader / keyboard support */}\n            <DismissButton onDismiss={state.close} />\n            {/* Provide updated menu context so nested menu behaves correctly */}\n            <MenuContext.Provider value={nestedMenuContext}>\n              {/* Clone nested menu to inject required props */}\n              {React.cloneElement(menu, {\n                ...(menu.props as any),\n                autoFocus,\n                onAction: (key: Key) => {\n                  // Call original menu onAction first\n                  (menu.props as any).onAction?.(key);\n                  onAction?.(key);\n                  // Don't close here - MenuItem will handle it via context.onClose\n                },\n                onKeyDown: (e: React.KeyboardEvent) => {\n                  // Handle keyboard navigation for closing submenu\n                  if (e.key === 'ArrowLeft' || e.key === 'Escape') {\n                    e.preventDefault();\n                    e.stopPropagation();\n                    state.close();\n                    // Return focus to trigger\n                    domTriggerRef.current?.focus();\n                  }\n                  // Call original handler if exists\n                  (menu.props as any).onKeyDown?.(e);\n                },\n                ref: menuRef,\n              })}\n            </MenuContext.Provider>\n            <DismissButton onDismiss={state.close} />\n          </div>\n        </Popover>\n      )}\n    </>\n  );\n}\n\n/**\n * Public SubMenuTrigger component that users interact with.\n * It just provides the getCollectionNode for the collection system.\n */\nexport function SubMenuTrigger(props: CubeSubMenuTriggerProps) {\n  // This component is never actually rendered directly.\n  // The collection system uses getCollectionNode to build the menu.\n  return null;\n}\n\n// Allow React Stately collection builder to treat SubMenuTrigger as an Item\n(SubMenuTrigger as any).getCollectionNode = function* (\n  props: CubeSubMenuTriggerProps,\n) {\n  const [trigger, menu] = React.Children.toArray(\n    props.children,\n  ) as ReactElement[];\n\n  // Yield a collection node that tells the Menu to wrap this item with InternalSubMenuTrigger\n  yield {\n    element: trigger,\n    wrapper: (element: ReactElement) => (\n      <InternalSubMenuTrigger\n        key={element.key || undefined}\n        targetKey={element.key || undefined}\n        {...props}\n      >\n        {element}\n        {menu}\n      </InternalSubMenuTrigger>\n    ),\n  };\n};\n\nSubMenuTrigger.displayName = 'SubMenuTrigger';\n"],"mappings":"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"}
+{"version":3,"file":"SubMenuTrigger.js","names":["Popover"],"sources":["../../../../src/components/actions/Menu/SubMenuTrigger.tsx"],"sourcesContent":["import { useSyncRef } from '@react-aria/utils';\nimport React, {\n  Key,\n  ReactElement,\n  ReactNode,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  Placement,\n  useMenuTrigger,\n  useOverlayPosition,\n} from 'react-aria';\nimport { useMenuTriggerState } from 'react-stately';\n\nimport { generateRandomId } from '../../../utils/random';\nimport { usePopoverSync } from '../../../utils/react/usePopoverSync';\nimport { Popover } from '../../overlays/Modal';\n\nimport { MenuContext, MenuContextValue, useMenuContext } from './context';\nimport { SubmenuTriggerContext } from './SubmenuTriggerContext';\n\n// Default placement & offset for sub-menus (matches Spectrum / Aria)\nconst DEFAULT_PLACEMENT: Placement = 'right top';\nconst DEFAULT_OFFSET = 4;\nconst DEFAULT_CROSS_OFFSET = -5;\n\nexport interface CubeSubMenuTriggerProps extends AriaMenuTriggerProps {\n  /** The preferred placement of the sub-menu relative to the trigger */\n  placement?: Placement;\n\n  /** Distance in pixels between the trigger and sub-menu */\n  offset?: number;\n\n  /** Distance in pixels along the cross axis from the default alignment */\n  crossOffset?: number;\n\n  /** Whether the sub-menu should flip to the opposite side when it would overflow */\n  shouldFlip?: boolean;\n\n  /** Minimum padding in pixels between the sub-menu and viewport edges */\n  containerPadding?: number;\n\n  /**\n   * Sub-menu trigger and the sub-menu itself. Must be exactly two React nodes.\n   *\n   * 1) Trigger – **must render `<li role=\"menuitem\">`** (usually `Menu.Item`).\n   * 2) Sub-menu – a `<Menu>` element.\n   */\n  children: [ReactNode, ReactElement];\n\n  /** Whether the trigger is disabled and cannot be activated */\n  isDisabled?: boolean;\n\n  /**\n   * Callback fired when an action is selected from the sub-menu.\n   * Bubbles the `onAction` event from the sub-menu to parent components.\n   */\n  onAction?: (key: Key) => void;\n\n  /**\n   * Controls focus behavior when the sub-menu opens.\n   * - `true` or `'first'`: Focus the first item\n   * - `'last'`: Focus the last item\n   * - `false`: Don't auto-focus any item\n   * @default 'first'\n   */\n  autoFocus?: boolean | 'first' | 'last';\n}\n\ninterface InternalSubMenuTriggerProps extends CubeSubMenuTriggerProps {\n  targetKey?: Key;\n}\n\n/**\n * Internal SubMenuTrigger that receives the already-rendered trigger element\n * from the collection system and wraps it with submenu behavior.\n */\nfunction InternalSubMenuTrigger(props: InternalSubMenuTriggerProps) {\n  const {\n    children,\n    placement = DEFAULT_PLACEMENT,\n    offset = DEFAULT_OFFSET,\n    crossOffset = DEFAULT_CROSS_OFFSET,\n    shouldFlip = true,\n    isDisabled,\n    autoFocus = 'first',\n    onAction,\n    targetKey,\n    ...overlayProps\n  } = props;\n\n  // Children: [menuTrigger (already rendered MenuItem), menu (Menu component)]\n  const [menuTrigger, menu] = React.Children.toArray(children) as [\n    ReactElement,\n    ReactElement,\n  ];\n\n  const state = useMenuTriggerState(props as AriaMenuTriggerProps);\n\n  // Generate a unique ID for this submenu instance\n  const submenuId = useMemo(() => generateRandomId(), []);\n\n  usePopoverSync({\n    menuId: submenuId,\n    isOpen: state.isOpen,\n    onClose: () => state.close(),\n  });\n\n  // Refs – trigger (MenuItem <li>) and overlay (<div> from Popover)\n  const domTriggerRef = useRef<HTMLElement>(null);\n  const popoverRef = useRef<HTMLDivElement>(null);\n  const menuRef = useRef<HTMLUListElement>(null);\n\n  // Strip keyboard/press handlers that we will implement ourselves\n  const { menuTriggerProps: rawTriggerProps, menuProps } = useMenuTrigger(\n    { type: 'submenu', isDisabled },\n    state,\n    domTriggerRef,\n  );\n\n  // Get parent context to check if parent menu is closing\n  const parentContext = useMenuContext();\n\n  // Remove default onKeyDown/onPress handlers from trigger props – we implement custom ones\n  const {\n    onKeyDown: _mtOnKeyDown,\n    onPress: _mtOnPress,\n    onPressStart: _mtOnPressStart,\n    onKeyUp: _mtOnKeyUp,\n    ...menuTriggerProps\n  } = rawTriggerProps;\n\n  const { overlayProps: positionProps } = useOverlayPosition({\n    targetRef: domTriggerRef,\n    overlayRef: popoverRef,\n    scrollRef: menuRef,\n    placement,\n    offset: offset as number,\n    crossOffset: crossOffset as number,\n    shouldFlip,\n    isOpen: state.isOpen,\n    onClose: state.close,\n  });\n\n  /**\n   * Build a MenuContext for the nested menu so it behaves just like a regular\n   * popover-based Menu (selection handling, focus management, etc.).\n   */\n  const nestedMenuContext = useMemo(() => {\n    const ctx: MenuContextValue = {\n      ...menuProps,\n      ref: menuRef,\n      // Pass the parent's onClose to close the entire menu hierarchy\n      onClose: () => {\n        // Close this submenu state immediately\n        state.close();\n\n        // Then close the parent menu\n        if (parentContext.onClose) {\n          parentContext.onClose();\n        }\n      },\n      closeOnSelect: true,\n      autoFocus,\n      mods: {\n        popover: true,\n      },\n      // Propagate closing state from parent\n      isClosing: parentContext.isClosing || !state.isOpen,\n    };\n\n    return ctx;\n  }, [\n    menuProps,\n    autoFocus,\n    state,\n    parentContext.onClose,\n    parentContext.isClosing,\n  ]);\n\n  // Sync the parent selection manager focus with DOM ref (for virtual focus scenarios)\n  useSyncRef(parentContext, domTriggerRef);\n\n  // Cleanup hover timers and reset refs on unmount\n  useEffect(() => {\n    return () => {\n      if (hoverOpenTimerRef.current) {\n        clearTimeout(hoverOpenTimerRef.current);\n      }\n      if (hoverCloseTimerRef.current) {\n        clearTimeout(hoverCloseTimerRef.current);\n      }\n      isHoveringRef.current = false;\n      isHoveringSubmenuRef.current = false;\n    };\n  }, []);\n\n  // ----- Render -----\n\n  // Handle keyboard navigation\n  const handleKeyDown = (e: React.KeyboardEvent) => {\n    if (isDisabled) return;\n\n    // Arrow right opens submenu\n    if (e.key === 'ArrowRight') {\n      e.preventDefault();\n      e.stopPropagation();\n      state.open();\n    }\n    // Enter or Space opens submenu (suppress subsequent onAction)\n    else if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      e.stopPropagation();\n      // Stop immediate propagation to prevent React Aria's handlers from running\n      e.nativeEvent.stopImmediatePropagation();\n      state.open();\n      suppressNextActionRef.current = true; // Remember it was keyboard\n    }\n    // Arrow left closes submenu if open\n    else if (e.key === 'ArrowLeft' && state.isOpen) {\n      e.preventDefault();\n      e.stopPropagation();\n      state.close();\n    }\n  };\n\n  // Use refs to store timer IDs\n  const hoverOpenTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const hoverCloseTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Track if mouse is over trigger or submenu\n  const isHoveringRef = useRef(false);\n  const isHoveringSubmenuRef = useRef(false);\n\n  // Track whether the next onAction comes from a keyboard press\n  const suppressNextActionRef = useRef(false);\n\n  const checkShouldClose = () => {\n    // Only close if mouse is not over trigger OR submenu\n    if (!isHoveringRef.current && !isHoveringSubmenuRef.current) {\n      hoverCloseTimerRef.current = setTimeout(() => {\n        // Double check before closing\n        if (!isHoveringRef.current && !isHoveringSubmenuRef.current) {\n          state.close();\n        }\n      }, 300);\n    }\n  };\n\n  // Handle mouse interactions on trigger\n  const handleMouseEnter = () => {\n    if (isDisabled) return;\n\n    isHoveringRef.current = true;\n\n    // Clear any pending close timer\n    if (hoverCloseTimerRef.current) {\n      clearTimeout(hoverCloseTimerRef.current);\n      hoverCloseTimerRef.current = null;\n    }\n\n    // Use a small delay to prevent accidental opens\n    if (!state.isOpen) {\n      hoverOpenTimerRef.current = setTimeout(() => {\n        if (isHoveringRef.current) {\n          state.open();\n        }\n      }, 200);\n    }\n  };\n\n  const handleMouseLeave = () => {\n    isHoveringRef.current = false;\n\n    // Clear open timer if it exists\n    if (hoverOpenTimerRef.current) {\n      clearTimeout(hoverOpenTimerRef.current);\n      hoverOpenTimerRef.current = null;\n    }\n\n    // Check if we should close\n    checkShouldClose();\n  };\n\n  // Handle mouse events on the submenu popover\n  const handlePopoverMouseEnter = () => {\n    isHoveringSubmenuRef.current = true;\n\n    // Clear any pending close timer when entering submenu\n    if (hoverCloseTimerRef.current) {\n      clearTimeout(hoverCloseTimerRef.current);\n      hoverCloseTimerRef.current = null;\n    }\n  };\n\n  const handlePopoverMouseLeave = () => {\n    isHoveringSubmenuRef.current = false;\n\n    // Check if we should close\n    checkShouldClose();\n  };\n\n  // Merge event handlers\n  const mergeHandler = (handler1: any, handler2: any) => {\n    return (...args: any[]) => {\n      handler1?.(...args);\n      handler2?.(...args);\n    };\n  };\n\n  // Provide context to the trigger element (already rendered MenuItem)\n  const triggerContextValue = useMemo(\n    () => ({\n      triggerRef: domTriggerRef,\n      triggerProps: menuTriggerProps,\n      isOpen: state.isOpen,\n      isDisabled,\n      onMouseEnter: handleMouseEnter,\n      onMouseLeave: handleMouseLeave,\n      onKeyDown: handleKeyDown,\n      onAction: isDisabled\n        ? undefined\n        : () => {\n            // Ignore the synthetic press generated by the same Enter/Space\n            if (suppressNextActionRef.current) {\n              suppressNextActionRef.current = false;\n              return;\n            }\n            // This is a mouse click, open the submenu\n            state.open();\n          },\n    }),\n    [\n      state,\n      isDisabled,\n      handleMouseEnter,\n      handleMouseLeave,\n      handleKeyDown,\n      menuTriggerProps,\n    ],\n  );\n\n  return (\n    <>\n      <SubmenuTriggerContext.Provider value={triggerContextValue}>\n        {menuTrigger}\n      </SubmenuTriggerContext.Provider>\n      {state.isOpen && (\n        <Popover\n          ref={popoverRef}\n          hideArrow\n          isNonModal\n          isOpen={!parentContext.isClosing}\n          style={positionProps.style}\n          placement={placement as Placement}\n          onClose={state.close}\n          // Spread any additional overlay props\n          {...overlayProps}\n        >\n          {/* Wrap content in a div to capture mouse events */}\n          <div\n            style={{ display: 'contents' }}\n            onMouseEnter={handlePopoverMouseEnter}\n            onMouseLeave={handlePopoverMouseLeave}\n          >\n            {/* Dismiss buttons for screen reader / keyboard support */}\n            <DismissButton onDismiss={state.close} />\n            {/* Provide updated menu context so nested menu behaves correctly */}\n            <MenuContext.Provider value={nestedMenuContext}>\n              {/* Clone nested menu to inject required props */}\n              {React.cloneElement(menu, {\n                ...(menu.props as any),\n                autoFocus,\n                onAction: (key: Key) => {\n                  // Call original menu onAction first\n                  (menu.props as any).onAction?.(key);\n                  onAction?.(key);\n                  // Don't close here - MenuItem will handle it via context.onClose\n                },\n                onKeyDown: (e: React.KeyboardEvent) => {\n                  // Handle keyboard navigation for closing submenu\n                  if (e.key === 'ArrowLeft' || e.key === 'Escape') {\n                    e.preventDefault();\n                    e.stopPropagation();\n                    state.close();\n                    // Return focus to trigger\n                    domTriggerRef.current?.focus();\n                  }\n                  // Call original handler if exists\n                  (menu.props as any).onKeyDown?.(e);\n                },\n                ref: menuRef,\n              })}\n            </MenuContext.Provider>\n            <DismissButton onDismiss={state.close} />\n          </div>\n        </Popover>\n      )}\n    </>\n  );\n}\n\n/**\n * Public SubMenuTrigger component that users interact with.\n * It just provides the getCollectionNode for the collection system.\n */\nexport function SubMenuTrigger(props: CubeSubMenuTriggerProps) {\n  // This component is never actually rendered directly.\n  // The collection system uses getCollectionNode to build the menu.\n  return null;\n}\n\n// Allow React Stately collection builder to treat SubMenuTrigger as an Item\n(SubMenuTrigger as any).getCollectionNode = function* (\n  props: CubeSubMenuTriggerProps,\n) {\n  const [trigger, menu] = React.Children.toArray(\n    props.children,\n  ) as ReactElement[];\n\n  // Yield a collection node that tells the Menu to wrap this item with InternalSubMenuTrigger\n  yield {\n    element: trigger,\n    wrapper: (element: ReactElement) => (\n      <InternalSubMenuTrigger\n        key={element.key || undefined}\n        targetKey={element.key || undefined}\n        {...props}\n      >\n        {element}\n        {menu}\n      </InternalSubMenuTrigger>\n    ),\n  };\n};\n\nSubMenuTrigger.displayName = 'SubMenuTrigger';\n"],"mappings":"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"}

package/dist/components/actions/Menu/SubmenuTriggerContext.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import React from "react";
 
 //#region src/components/actions/Menu/SubmenuTriggerContext.tsx

package/dist/components/actions/Menu/context.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import React, { useContext } from "react";
 
 //#region src/components/actions/Menu/context.ts

package/dist/components/actions/Menu/styled.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { DEFAULT_NEUTRAL_STYLES } from "../../../data/item-themes.js";
 import { Space } from "../../layout/Space.js";
 import { DEFAULT_BUTTON_STYLES } from "../Button/Button.js";

package/dist/components/actions/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { ItemActionProvider, useItemActionContext } from "./ItemActionContext.js";
 import { openLink, parseTo, performClickHandler, useAction } from "./use-action.js";
 import { ItemAction } from "./ItemAction/ItemAction.js";

package/dist/components/actions/use-action.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useFocus as useFocus$1 } from "../../utils/react/interactions.js";

package/dist/components/actions/use-anchored-menu.js

@@ -1,8 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
-import { useEventBus } from "../../utils/react/useEventBus.js";
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { generateRandomId } from "../../utils/random.js";
+import { usePopoverSync } from "../../utils/react/usePopoverSync.js";
 import { _MenuTrigger } from "./Menu/MenuTrigger.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -33,24 +33,11 @@ function useAnchoredMenu(Component, defaultTriggerProps, defaultMenuProps) {
 			};
 		}
 	}, []);
-	const menuId = useMemo(() => generateRandomId(), []);
-	const { emit, on } = useEventBus();
-	useEffect(() => {
-		return on("popover:open", (data) => {
-			if (data.menuId !== menuId && isOpen) setIsOpen(false);
-		});
-	}, [
-		on,
-		menuId,
-		isOpen
-	]);
-	useEffect(() => {
-		if (isOpen) emit("popover:open", { menuId });
-	}, [
+	usePopoverSync({
+		menuId: useMemo(() => generateRandomId(), []),
 		isOpen,
-		emit,
-		menuId
-	]);
+		onClose: () => setIsOpen(false)
+	});
 	function setupCheck() {
 		if (!setupRef.current) throw new Error("useAnchoredMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.");
 	}

package/dist/components/actions/use-anchored-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-anchored-menu.js","names":["MenuTrigger","mergeProps"],"sources":["../../../src/components/actions/use-anchored-menu.tsx"],"sourcesContent":["import { Pressable } from '@react-aria/interactions';\nimport {\n  ComponentProps,\n  ComponentType,\n  ReactElement,\n  RefObject,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { VisuallyHidden } from 'react-aria';\n\nimport { useEvent } from '../../_internal';\nimport { generateRandomId } from '../../utils/random';\nimport { mergeProps } from '../../utils/react';\nimport { useEventBus } from '../../utils/react/useEventBus';\n\nimport { MenuTrigger } from './Menu';\n\nexport interface UseAnchoredMenuReturn<P, T> {\n  /** Ref to attach to the anchor element for positioning the menu. */\n  anchorRef: RefObject<HTMLElement | null>;\n\n  /**\n   * Programmatically opens the menu with the provided props.\n   * @param props - Props to pass to the menu component\n   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)\n   */\n  open(props?: P, triggerProps?: T): void;\n\n  /**\n   * Updates the props of the currently open menu.\n   * Props are merged if defaults are provided.\n   */\n  update(props: P, triggerProps?: T): void;\n\n  /** Closes the menu programmatically. */\n  close(): void;\n\n  /** Current open/closed state of the menu. */\n  isOpen: boolean;\n\n  /**\n   * JSX element that must be rendered in your component tree.\n   * Contains the MenuTrigger and positioning logic.\n   */\n  get rendered(): ReactElement | null;\n}\n\n/**\n * Generic hook to manage an anchored menu component.\n *\n * @param Component - A React component that represents the menu content (Menu or CommandMenu).\n * @param defaultTriggerProps - Default props to pass to the MenuTrigger.\n * @param defaultMenuProps - Default props to pass to the Menu component.\n * @returns An object with `anchorRef` to position the menu, `open` function to open the menu with provided props, `close` function to close the menu, and `rendered` JSX element to include in your component tree.\n */\nexport function useAnchoredMenu<P, T = ComponentProps<typeof MenuTrigger>>(\n  Component: ComponentType<P>,\n  defaultTriggerProps?: Omit<\n    ComponentProps<typeof MenuTrigger>,\n    'children' | 'isOpen' | 'onOpenChange' | 'targetRef'\n  >,\n  defaultMenuProps?: P,\n): UseAnchoredMenuReturn<P, T> {\n  const [isOpen, setIsOpen] = useState(false);\n  const [componentProps, setComponentProps] = useState<P | null>(null);\n  const [triggerProps, setTriggerProps] = useState<T | null>(null);\n  const anchorRef = useRef<HTMLElement>(null);\n  const setupRef = useRef(false);\n\n  useEffect(() => {\n    const el = anchorRef.current;\n    if (el) {\n      el.dataset.popoverTrigger = '';\n      return () => {\n        delete el.dataset.popoverTrigger;\n      };\n    }\n  }, []);\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  // Get event bus for menu synchronization\n  const { emit, on } = useEventBus();\n\n  // Listen for other menus opening and close this one if needed\n  useEffect(() => {\n    const unsubscribe = on('popover:open', (data: { menuId: string }) => {\n      // If another menu is opening and this menu is open, close this one\n      if (data.menuId !== menuId && isOpen) {\n        setIsOpen(false);\n      }\n    });\n\n    return unsubscribe;\n  }, [on, menuId, isOpen]);\n\n  // Emit event when this menu opens\n  useEffect(() => {\n    if (isOpen) {\n      emit('popover:open', { menuId });\n    }\n  }, [isOpen, emit, menuId]);\n\n  function setupCheck() {\n    if (!setupRef.current) {\n      throw new Error(\n        'useAnchoredMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.',\n      );\n    }\n  }\n\n  // 'open' accepts props required by the Component and opens the menu\n  const open = useEvent((props: P = {} as P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps);\n    setTriggerProps(triggerProps ?? null);\n    setIsOpen(true);\n  });\n\n  const update = useEvent((props: P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps);\n    setTriggerProps(triggerProps ?? null);\n  });\n\n  const close = useEvent(() => {\n    setIsOpen(false);\n  });\n\n  // Render the menu only when componentProps is set\n  const renderedMenu = useMemo(() => {\n    if (!componentProps) return null;\n\n    return (\n      <MenuTrigger\n        isDummy\n        isOpen={isOpen}\n        targetRef={anchorRef}\n        placement=\"bottom start\"\n        onOpenChange={setIsOpen}\n        {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n      >\n        <VisuallyHidden>\n          <Pressable>\n            <button aria-label=\"context-menu\" />\n          </Pressable>\n        </VisuallyHidden>\n        <Component {...componentProps} />\n      </MenuTrigger>\n    );\n  }, [componentProps, triggerProps, isOpen, defaultTriggerProps]);\n\n  return {\n    anchorRef,\n    open,\n    update,\n    close,\n    isOpen,\n    get rendered() {\n      setupRef.current = true;\n\n      return renderedMenu;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0DA,SAAgB,gBACd,WACA,qBAIA,kBAC6B;CAC7B,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM;CAC3C,MAAM,CAAC,gBAAgB,qBAAqB,SAAmB,KAAK;CACpE,MAAM,CAAC,cAAc,mBAAmB,SAAmB,KAAK;CAChE,MAAM,YAAY,OAAoB,KAAK;CAC3C,MAAM,WAAW,OAAO,MAAM;AAE9B,iBAAgB;EACd,MAAM,KAAK,UAAU;AACrB,MAAI,IAAI;AACN,MAAG,QAAQ,iBAAiB;AAC5B,gBAAa;AACX,WAAO,GAAG,QAAQ;;;IAGrB,EAAE,CAAC;CAGN,MAAM,SAAS,cAAc,kBAAkB,EAAE,EAAE,CAAC;CAGpD,MAAM,EAAE,MAAM,OAAO,aAAa;AAGlC,iBAAgB;AAQd,SAPoB,GAAG,iBAAiB,SAA6B;AAEnE,OAAI,KAAK,WAAW,UAAU,OAC5B,WAAU,MAAM;IAElB;IAGD;EAAC;EAAI;EAAQ;EAAO,CAAC;AAGxB,iBAAgB;AACd,MAAI,OACF,MAAK,gBAAgB,EAAE,QAAQ,CAAC;IAEjC;EAAC;EAAQ;EAAM;EAAO,CAAC;CAE1B,SAAS,aAAa;AACpB,MAAI,CAAC,SAAS,QACZ,OAAM,IAAI,MACR,+GACD;;CAKL,MAAM,OAAO,UAAU,QAAW,EAAE,EAAO,iBAAqB;AAC9D,cAAY;AAOZ,oBAJmB,mBACf;GAAE,GAAG;GAAkB,GAAG;GAAO,GACjC,MAEyB;AAC7B,kBAAgB,gBAAgB,KAAK;AACrC,YAAU,KAAK;GACf;CAEF,MAAM,SAAS,UAAU,OAAU,iBAAqB;AACtD,cAAY;AAOZ,oBAJmB,mBACf;GAAE,GAAG;GAAkB,GAAG;GAAO,GACjC,MAEyB;AAC7B,kBAAgB,gBAAgB,KAAK;GACrC;CAEF,MAAM,QAAQ,eAAe;AAC3B,YAAU,MAAM;GAChB;CAGF,MAAM,eAAe,cAAc;AACjC,MAAI,CAAC,eAAgB,QAAO;AAE5B,SACE,qBAACA;GACC;GACQ;GACR,WAAW;GACX,WAAU;GACV,cAAc;GACd,GAAIC,aAAW,qBAAqB,gBAAgB,OAAU;cAE9D,oBAAC,4BACC,oBAAC,uBACC,oBAAC,YAAO,cAAW,iBAAiB,GAC1B,GACG,EACjB,oBAAC,aAAU,GAAI,iBAAkB;IACrB;IAEf;EAAC;EAAgB;EAAc;EAAQ;EAAoB,CAAC;AAE/D,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,IAAI,WAAW;AACb,YAAS,UAAU;AAEnB,UAAO;;EAEV"}
+{"version":3,"file":"use-anchored-menu.js","names":["MenuTrigger","mergeProps"],"sources":["../../../src/components/actions/use-anchored-menu.tsx"],"sourcesContent":["import { Pressable } from '@react-aria/interactions';\nimport {\n  ComponentProps,\n  ComponentType,\n  ReactElement,\n  RefObject,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { VisuallyHidden } from 'react-aria';\n\nimport { useEvent } from '../../_internal';\nimport { generateRandomId } from '../../utils/random';\nimport { mergeProps } from '../../utils/react';\nimport { usePopoverSync } from '../../utils/react/usePopoverSync';\n\nimport { MenuTrigger } from './Menu';\n\nexport interface UseAnchoredMenuReturn<P, T> {\n  /** Ref to attach to the anchor element for positioning the menu. */\n  anchorRef: RefObject<HTMLElement | null>;\n\n  /**\n   * Programmatically opens the menu with the provided props.\n   * @param props - Props to pass to the menu component\n   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)\n   */\n  open(props?: P, triggerProps?: T): void;\n\n  /**\n   * Updates the props of the currently open menu.\n   * Props are merged if defaults are provided.\n   */\n  update(props: P, triggerProps?: T): void;\n\n  /** Closes the menu programmatically. */\n  close(): void;\n\n  /** Current open/closed state of the menu. */\n  isOpen: boolean;\n\n  /**\n   * JSX element that must be rendered in your component tree.\n   * Contains the MenuTrigger and positioning logic.\n   */\n  get rendered(): ReactElement | null;\n}\n\n/**\n * Generic hook to manage an anchored menu component.\n *\n * @param Component - A React component that represents the menu content (Menu or CommandMenu).\n * @param defaultTriggerProps - Default props to pass to the MenuTrigger.\n * @param defaultMenuProps - Default props to pass to the Menu component.\n * @returns An object with `anchorRef` to position the menu, `open` function to open the menu with provided props, `close` function to close the menu, and `rendered` JSX element to include in your component tree.\n */\nexport function useAnchoredMenu<P, T = ComponentProps<typeof MenuTrigger>>(\n  Component: ComponentType<P>,\n  defaultTriggerProps?: Omit<\n    ComponentProps<typeof MenuTrigger>,\n    'children' | 'isOpen' | 'onOpenChange' | 'targetRef'\n  >,\n  defaultMenuProps?: P,\n): UseAnchoredMenuReturn<P, T> {\n  const [isOpen, setIsOpen] = useState(false);\n  const [componentProps, setComponentProps] = useState<P | null>(null);\n  const [triggerProps, setTriggerProps] = useState<T | null>(null);\n  const anchorRef = useRef<HTMLElement>(null);\n  const setupRef = useRef(false);\n\n  useEffect(() => {\n    const el = anchorRef.current;\n    if (el) {\n      el.dataset.popoverTrigger = '';\n      return () => {\n        delete el.dataset.popoverTrigger;\n      };\n    }\n  }, []);\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => setIsOpen(false),\n  });\n\n  function setupCheck() {\n    if (!setupRef.current) {\n      throw new Error(\n        'useAnchoredMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.',\n      );\n    }\n  }\n\n  // 'open' accepts props required by the Component and opens the menu\n  const open = useEvent((props: P = {} as P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps);\n    setTriggerProps(triggerProps ?? null);\n    setIsOpen(true);\n  });\n\n  const update = useEvent((props: P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps);\n    setTriggerProps(triggerProps ?? null);\n  });\n\n  const close = useEvent(() => {\n    setIsOpen(false);\n  });\n\n  // Render the menu only when componentProps is set\n  const renderedMenu = useMemo(() => {\n    if (!componentProps) return null;\n\n    return (\n      <MenuTrigger\n        isDummy\n        isOpen={isOpen}\n        targetRef={anchorRef}\n        placement=\"bottom start\"\n        onOpenChange={setIsOpen}\n        {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n      >\n        <VisuallyHidden>\n          <Pressable>\n            <button aria-label=\"context-menu\" />\n          </Pressable>\n        </VisuallyHidden>\n        <Component {...componentProps} />\n      </MenuTrigger>\n    );\n  }, [componentProps, triggerProps, isOpen, defaultTriggerProps]);\n\n  return {\n    anchorRef,\n    open,\n    update,\n    close,\n    isOpen,\n    get rendered() {\n      setupRef.current = true;\n\n      return renderedMenu;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0DA,SAAgB,gBACd,WACA,qBAIA,kBAC6B;CAC7B,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM;CAC3C,MAAM,CAAC,gBAAgB,qBAAqB,SAAmB,KAAK;CACpE,MAAM,CAAC,cAAc,mBAAmB,SAAmB,KAAK;CAChE,MAAM,YAAY,OAAoB,KAAK;CAC3C,MAAM,WAAW,OAAO,MAAM;AAE9B,iBAAgB;EACd,MAAM,KAAK,UAAU;AACrB,MAAI,IAAI;AACN,MAAG,QAAQ,iBAAiB;AAC5B,gBAAa;AACX,WAAO,GAAG,QAAQ;;;IAGrB,EAAE,CAAC;AAKN,gBAAe;EACb,QAHa,cAAc,kBAAkB,EAAE,EAAE,CAAC;EAIlD;EACA,eAAe,UAAU,MAAM;EAChC,CAAC;CAEF,SAAS,aAAa;AACpB,MAAI,CAAC,SAAS,QACZ,OAAM,IAAI,MACR,+GACD;;CAKL,MAAM,OAAO,UAAU,QAAW,EAAE,EAAO,iBAAqB;AAC9D,cAAY;AAOZ,oBAJmB,mBACf;GAAE,GAAG;GAAkB,GAAG;GAAO,GACjC,MAEyB;AAC7B,kBAAgB,gBAAgB,KAAK;AACrC,YAAU,KAAK;GACf;CAEF,MAAM,SAAS,UAAU,OAAU,iBAAqB;AACtD,cAAY;AAOZ,oBAJmB,mBACf;GAAE,GAAG;GAAkB,GAAG;GAAO,GACjC,MAEyB;AAC7B,kBAAgB,gBAAgB,KAAK;GACrC;CAEF,MAAM,QAAQ,eAAe;AAC3B,YAAU,MAAM;GAChB;CAGF,MAAM,eAAe,cAAc;AACjC,MAAI,CAAC,eAAgB,QAAO;AAE5B,SACE,qBAACA;GACC;GACQ;GACR,WAAW;GACX,WAAU;GACV,cAAc;GACd,GAAIC,aAAW,qBAAqB,gBAAgB,OAAU;cAE9D,oBAAC,4BACC,oBAAC,uBACC,oBAAC,YAAO,cAAW,iBAAiB,GAC1B,GACG,EACjB,oBAAC,aAAU,GAAI,iBAAkB;IACrB;IAEf;EAAC;EAAgB;EAAc;EAAQ;EAAoB,CAAC;AAE/D,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,IAAI,WAAW;AACb,YAAS,UAAU;AAEnB,UAAO;;EAEV"}

package/dist/components/actions/use-context-menu.js

@@ -1,8 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
-import { useEventBus } from "../../utils/react/useEventBus.js";
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { generateRandomId } from "../../utils/random.js";
+import { usePopoverSync } from "../../utils/react/usePopoverSync.js";
 import { _MenuTrigger } from "./Menu/MenuTrigger.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -26,27 +26,23 @@ function useContextMenu(Component, defaultTriggerProps, defaultMenuProps) {
 	const targetRef = useRef(null);
 	const invisibleAnchorRef = useRef(null);
 	const setupRef = useRef(false);
-	const menuId = useMemo(() => generateRandomId(), []);
-	const { emit, on } = useEventBus();
 	useEffect(() => {
-		return on("popover:open", (data) => {
-			if (data.menuId !== menuId && isOpen) {
-				setIsOpen(false);
-				setAnchorPosition(null);
-			}
-		});
-	}, [
-		on,
-		menuId,
-		isOpen
-	]);
-	useEffect(() => {
-		if (isOpen) emit("popover:open", { menuId });
-	}, [
+		const el = targetRef.current;
+		if (el) {
+			el.dataset.popoverTrigger = "";
+			return () => {
+				delete el.dataset.popoverTrigger;
+			};
+		}
+	}, []);
+	usePopoverSync({
+		menuId: useMemo(() => generateRandomId(), []),
 		isOpen,
-		emit,
-		menuId
-	]);
+		onClose: () => {
+			setIsOpen(false);
+			setAnchorPosition(null);
+		}
+	});
 	function setupCheck() {
 		if (!setupRef.current) throw new Error("useContextMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.");
 	}

package/dist/components/actions/use-context-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.js","names":["MenuTrigger","mergeProps"],"sources":["../../../src/components/actions/use-context-menu.tsx"],"sourcesContent":["import { Pressable } from '@react-aria/interactions';\nimport {\n  ComponentProps,\n  ComponentType,\n  MouseEvent,\n  PointerEvent,\n  ReactElement,\n  RefObject,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { VisuallyHidden } from 'react-aria';\n\nimport { useEvent } from '../../_internal';\nimport { generateRandomId } from '../../utils/random';\nimport { mergeProps } from '../../utils/react';\nimport { useEventBus } from '../../utils/react/useEventBus';\n\nimport { MenuTrigger } from './Menu';\n\ntype NativeMouseEvent = globalThis.MouseEvent;\ntype NativePointerEvent = globalThis.PointerEvent;\n\nexport interface UseContextMenuReturn<\n  E extends HTMLElement = HTMLElement,\n  P extends object = {},\n  T = ComponentProps<typeof MenuTrigger>,\n> {\n  /** Container element that receives context menu events. Attach this ref to your target element. */\n  targetRef: RefObject<E | null>;\n\n  /**\n   * Programmatically opens the menu at the specified coordinates or element center.\n   * Runtime props are merged with defaultMenuProps (runtime props take precedence).\n   *\n   * @param props - Props to pass to the menu component (optional, defaults to defaultMenuProps)\n   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)\n   * @param event - The pointer/mouse event containing coordinates for positioning (optional, centers on element if not provided)\n   */\n  open(\n    props?: P,\n    triggerProps?: T,\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ): void;\n\n  /**\n   * Updates the props of the currently open menu without repositioning.\n   * Props are merged with defaultMenuProps.\n   */\n  update(props: P, triggerProps?: T): void;\n\n  /** Closes the menu programmatically. */\n  close(): void;\n\n  /** Current open/closed state of the menu. */\n  isOpen: boolean;\n\n  /**\n   * JSX element that must be rendered in your component tree.\n   * Contains the MenuTrigger and positioning logic.\n   * IMPORTANT: Must be placed directly inside the target container (the element with targetRef).\n   */\n  get rendered(): ReactElement | null;\n}\n\n/**\n * Generic hook to manage a context menu component that opens at pointer coordinates.\n *\n * @param Component - A React component that represents the menu content (Menu or CommandMenu).\n * @param defaultTriggerProps - Default props to pass to the MenuTrigger.\n * @param defaultMenuProps - Default props to pass to the Menu component.\n * @returns An object with `targetRef` to attach to the container element, `open` function to open the menu at event coordinates, `close` function to close the menu, and `rendered` JSX element to include in your component tree.\n */\nexport function useContextMenu<\n  E extends HTMLElement = HTMLElement,\n  P extends object = {},\n  T = ComponentProps<typeof MenuTrigger>,\n>(\n  Component: ComponentType<P>,\n  defaultTriggerProps?: Omit<\n    ComponentProps<typeof MenuTrigger>,\n    'children' | 'isOpen' | 'onOpenChange' | 'targetRef'\n  >,\n  defaultMenuProps?: P,\n): UseContextMenuReturn<E, P, T> {\n  const [isOpen, setIsOpen] = useState(false);\n  const [componentProps, setComponentProps] = useState<P | null>(null);\n  const [triggerProps, setTriggerProps] = useState<T | null>(null);\n  const [anchorPosition, setAnchorPosition] = useState<{\n    x: number;\n    y: number;\n  } | null>(null);\n  const targetRef = useRef<E>(null);\n  const invisibleAnchorRef = useRef<HTMLSpanElement>(null);\n  const setupRef = useRef(false);\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  // Get event bus for menu synchronization\n  const { emit, on } = useEventBus();\n\n  // Listen for other menus opening and close this one if needed\n  useEffect(() => {\n    const unsubscribe = on('popover:open', (data: { menuId: string }) => {\n      // If another menu is opening and this menu is open, close this one\n      if (data.menuId !== menuId && isOpen) {\n        setIsOpen(false);\n        setAnchorPosition(null);\n      }\n    });\n\n    return unsubscribe;\n  }, [on, menuId, isOpen]);\n\n  // Emit event when this menu opens\n  useEffect(() => {\n    if (isOpen) {\n      emit('popover:open', { menuId });\n    }\n  }, [isOpen, emit, menuId]);\n\n  function setupCheck() {\n    if (!setupRef.current) {\n      throw new Error(\n        'useContextMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.',\n      );\n    }\n  }\n\n  // Helper function to calculate position relative to targetRef, taking the\n  // element's scroll offset into account. Without the scroll offset the menu\n  // would be rendered at the wrong place inside scrollable containers.\n  const calculatePosition = (\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ) => {\n    const container = targetRef.current;\n\n    // If no event is provided, position at the center of the element\n    if (!event) {\n      if (!container) {\n        return { x: 0, y: 0 };\n      }\n\n      const containerRect = container.getBoundingClientRect();\n      const scrollLeft = container.scrollLeft;\n      const scrollTop = container.scrollTop;\n\n      const computed = window.getComputedStyle(container);\n      const borderLeft = parseFloat(computed.borderLeftWidth) || 0;\n      const borderTop = parseFloat(computed.borderTopWidth) || 0;\n\n      // Position at the center of the element's content area\n      const x = container.clientWidth / 2 + scrollLeft;\n      const y = container.clientHeight / 2 + scrollTop;\n\n      // Clamp to the full scroll size\n      const clampedX = Math.max(0, Math.min(x, container.scrollWidth));\n      const clampedY = Math.max(0, Math.min(y, container.scrollHeight));\n\n      return { x: clampedX, y: clampedY };\n    }\n\n    // If the target reference is missing, fall back to viewport coordinates.\n    if (!container) {\n      const { clientX = 0, clientY = 0 } = event;\n\n      return { x: clientX, y: clientY };\n    }\n\n    const containerRect = container.getBoundingClientRect();\n\n    // Get coordinates from the event (viewport-relative)\n    const { clientX, clientY } = event;\n\n    // Take the element's scroll offset into account so that the coordinates are\n    // relative to the **content** box, not the visible viewport of the\n    // element.\n    const scrollLeft = container.scrollLeft;\n    const scrollTop = container.scrollTop;\n\n    const computed = window.getComputedStyle(container);\n    const borderLeft = parseFloat(computed.borderLeftWidth) || 0;\n    const borderTop = parseFloat(computed.borderTopWidth) || 0;\n\n    const x = clientX - containerRect.left - borderLeft + scrollLeft;\n    const y = clientY - containerRect.top - borderTop + scrollTop;\n\n    // Clamp to the full scroll size so that the invisible anchor always stays\n    // inside the element regardless of the scroll position.\n    const clampedX = Math.max(0, Math.min(x, container.scrollWidth));\n    const clampedY = Math.max(0, Math.min(y, container.scrollHeight));\n\n    return { x: clampedX, y: clampedY };\n  };\n\n  // 'open' accepts props, trigger props, and optional event for positioning, then opens the menu\n  const open = useEvent(\n    (\n      props: P = {} as P,\n      triggerProps?: T,\n      event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n    ) => {\n      setupCheck();\n\n      // Ensure the target element can serve as a positioning context for the\n      // invisible target element. If the consumer hasn't explicitly set\n      // `position: relative | absolute | fixed | sticky` we switch it to\n      // `relative` so that absolutely-positioned children are laid out correctly.\n      if (targetRef.current) {\n        const computedStyle = window.getComputedStyle(targetRef.current);\n\n        if (computedStyle.position === 'static') {\n          targetRef.current.style.position = 'relative';\n        }\n      }\n\n      // Prevent default context menu if it's a context menu event\n      if (\n        event &&\n        'preventDefault' in event &&\n        typeof event.preventDefault === 'function'\n      ) {\n        event.preventDefault();\n      }\n\n      const { x, y } = calculatePosition(event);\n      setAnchorPosition({ x, y });\n\n      // Merge defaultMenuProps with provided props\n      const finalProps = defaultMenuProps\n        ? { ...defaultMenuProps, ...props }\n        : props;\n\n      setComponentProps(finalProps);\n      setTriggerProps(triggerProps ?? null);\n      setIsOpen(true);\n    },\n  );\n\n  const update = useEvent((props: P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps as P);\n    setTriggerProps(triggerProps ?? null);\n  });\n\n  const close = useEvent(() => {\n    setIsOpen(false);\n    setAnchorPosition(null);\n  });\n\n  // Context menu event handler\n  const onContextMenu = useEvent(\n    (event: MouseEvent | PointerEvent | MouseEvent | PointerEvent) => {\n      event.preventDefault();\n      if (isOpen) {\n        const pos = calculatePosition(event);\n        setAnchorPosition(pos);\n      } else {\n        open(defaultMenuProps, undefined, event);\n      }\n    },\n  );\n\n  // Bind the onContextMenu event to targetRef\n  useEffect(() => {\n    const element = targetRef.current;\n    if (!element) return;\n\n    element.addEventListener('contextmenu', onContextMenu as any);\n\n    return () => {\n      element.removeEventListener('contextmenu', onContextMenu as any);\n    };\n  }, [onContextMenu]);\n\n  // Render the menu only when componentProps is set\n  const renderedMenu = useMemo(() => {\n    if (!componentProps || !anchorPosition) return null;\n\n    return (\n      <>\n        {/* Invisible anchor element positioned at click coordinates */}\n        <span\n          ref={invisibleAnchorRef}\n          style={{\n            position: 'absolute',\n            left: `${anchorPosition.x}px`,\n            top: `${anchorPosition.y}px`,\n            width: '0px',\n            height: '0px',\n            lineHeight: '0',\n            pointerEvents: 'none',\n            visibility: 'hidden',\n          }}\n        />\n        <MenuTrigger\n          isDummy\n          isOpen={isOpen}\n          targetRef={invisibleAnchorRef}\n          offset={0}\n          crossOffset={0}\n          placement={\n            (triggerProps as ComponentProps<typeof MenuTrigger>)?.placement ||\n            defaultTriggerProps?.placement ||\n            'bottom start'\n          }\n          onOpenChange={setIsOpen}\n          {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n        >\n          <VisuallyHidden>\n            <Pressable>\n              <button aria-label=\"Open context menu\" />\n            </Pressable>\n          </VisuallyHidden>\n          <Component {...componentProps} />\n        </MenuTrigger>\n      </>\n    );\n  }, [\n    componentProps,\n    triggerProps,\n    isOpen,\n    defaultTriggerProps,\n    anchorPosition,\n  ]);\n\n  return {\n    targetRef,\n    open,\n    update,\n    close,\n    isOpen,\n    get rendered() {\n      setupRef.current = true;\n\n      return renderedMenu;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-context-menu.js","names":["MenuTrigger","mergeProps"],"sources":["../../../src/components/actions/use-context-menu.tsx"],"sourcesContent":["import { Pressable } from '@react-aria/interactions';\nimport {\n  ComponentProps,\n  ComponentType,\n  MouseEvent,\n  PointerEvent,\n  ReactElement,\n  RefObject,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { VisuallyHidden } from 'react-aria';\n\nimport { useEvent } from '../../_internal';\nimport { generateRandomId } from '../../utils/random';\nimport { mergeProps } from '../../utils/react';\nimport { usePopoverSync } from '../../utils/react/usePopoverSync';\n\nimport { MenuTrigger } from './Menu';\n\ntype NativeMouseEvent = globalThis.MouseEvent;\ntype NativePointerEvent = globalThis.PointerEvent;\n\nexport interface UseContextMenuReturn<\n  E extends HTMLElement = HTMLElement,\n  P extends object = {},\n  T = ComponentProps<typeof MenuTrigger>,\n> {\n  /** Container element that receives context menu events. Attach this ref to your target element. */\n  targetRef: RefObject<E | null>;\n\n  /**\n   * Programmatically opens the menu at the specified coordinates or element center.\n   * Runtime props are merged with defaultMenuProps (runtime props take precedence).\n   *\n   * @param props - Props to pass to the menu component (optional, defaults to defaultMenuProps)\n   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)\n   * @param event - The pointer/mouse event containing coordinates for positioning (optional, centers on element if not provided)\n   */\n  open(\n    props?: P,\n    triggerProps?: T,\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ): void;\n\n  /**\n   * Updates the props of the currently open menu without repositioning.\n   * Props are merged with defaultMenuProps.\n   */\n  update(props: P, triggerProps?: T): void;\n\n  /** Closes the menu programmatically. */\n  close(): void;\n\n  /** Current open/closed state of the menu. */\n  isOpen: boolean;\n\n  /**\n   * JSX element that must be rendered in your component tree.\n   * Contains the MenuTrigger and positioning logic.\n   * IMPORTANT: Must be placed directly inside the target container (the element with targetRef).\n   */\n  get rendered(): ReactElement | null;\n}\n\n/**\n * Generic hook to manage a context menu component that opens at pointer coordinates.\n *\n * @param Component - A React component that represents the menu content (Menu or CommandMenu).\n * @param defaultTriggerProps - Default props to pass to the MenuTrigger.\n * @param defaultMenuProps - Default props to pass to the Menu component.\n * @returns An object with `targetRef` to attach to the container element, `open` function to open the menu at event coordinates, `close` function to close the menu, and `rendered` JSX element to include in your component tree.\n */\nexport function useContextMenu<\n  E extends HTMLElement = HTMLElement,\n  P extends object = {},\n  T = ComponentProps<typeof MenuTrigger>,\n>(\n  Component: ComponentType<P>,\n  defaultTriggerProps?: Omit<\n    ComponentProps<typeof MenuTrigger>,\n    'children' | 'isOpen' | 'onOpenChange' | 'targetRef'\n  >,\n  defaultMenuProps?: P,\n): UseContextMenuReturn<E, P, T> {\n  const [isOpen, setIsOpen] = useState(false);\n  const [componentProps, setComponentProps] = useState<P | null>(null);\n  const [triggerProps, setTriggerProps] = useState<T | null>(null);\n  const [anchorPosition, setAnchorPosition] = useState<{\n    x: number;\n    y: number;\n  } | null>(null);\n  const targetRef = useRef<E>(null);\n  const invisibleAnchorRef = useRef<HTMLSpanElement>(null);\n  const setupRef = useRef(false);\n\n  // Mark the container as a popover trigger so that other open menus' close-on-\n  // outside predicates treat clicks inside it (including programmatic\n  // open buttons rendered alongside a context-menu target) as a legitimate\n  // trigger interaction instead of a generic outside click. This mirrors the\n  // pattern in `useAnchoredMenu`.\n  useEffect(() => {\n    const el = targetRef.current;\n    if (el) {\n      el.dataset.popoverTrigger = '';\n      return () => {\n        delete el.dataset.popoverTrigger;\n      };\n    }\n  }, []);\n\n  // Generate a unique ID for this menu instance\n  const menuId = useMemo(() => generateRandomId(), []);\n\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => {\n      setIsOpen(false);\n      setAnchorPosition(null);\n    },\n  });\n\n  function setupCheck() {\n    if (!setupRef.current) {\n      throw new Error(\n        'useContextMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.',\n      );\n    }\n  }\n\n  // Helper function to calculate position relative to targetRef, taking the\n  // element's scroll offset into account. Without the scroll offset the menu\n  // would be rendered at the wrong place inside scrollable containers.\n  const calculatePosition = (\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ) => {\n    const container = targetRef.current;\n\n    // If no event is provided, position at the center of the element\n    if (!event) {\n      if (!container) {\n        return { x: 0, y: 0 };\n      }\n\n      const containerRect = container.getBoundingClientRect();\n      const scrollLeft = container.scrollLeft;\n      const scrollTop = container.scrollTop;\n\n      const computed = window.getComputedStyle(container);\n      const borderLeft = parseFloat(computed.borderLeftWidth) || 0;\n      const borderTop = parseFloat(computed.borderTopWidth) || 0;\n\n      // Position at the center of the element's content area\n      const x = container.clientWidth / 2 + scrollLeft;\n      const y = container.clientHeight / 2 + scrollTop;\n\n      // Clamp to the full scroll size\n      const clampedX = Math.max(0, Math.min(x, container.scrollWidth));\n      const clampedY = Math.max(0, Math.min(y, container.scrollHeight));\n\n      return { x: clampedX, y: clampedY };\n    }\n\n    // If the target reference is missing, fall back to viewport coordinates.\n    if (!container) {\n      const { clientX = 0, clientY = 0 } = event;\n\n      return { x: clientX, y: clientY };\n    }\n\n    const containerRect = container.getBoundingClientRect();\n\n    // Get coordinates from the event (viewport-relative)\n    const { clientX, clientY } = event;\n\n    // Take the element's scroll offset into account so that the coordinates are\n    // relative to the **content** box, not the visible viewport of the\n    // element.\n    const scrollLeft = container.scrollLeft;\n    const scrollTop = container.scrollTop;\n\n    const computed = window.getComputedStyle(container);\n    const borderLeft = parseFloat(computed.borderLeftWidth) || 0;\n    const borderTop = parseFloat(computed.borderTopWidth) || 0;\n\n    const x = clientX - containerRect.left - borderLeft + scrollLeft;\n    const y = clientY - containerRect.top - borderTop + scrollTop;\n\n    // Clamp to the full scroll size so that the invisible anchor always stays\n    // inside the element regardless of the scroll position.\n    const clampedX = Math.max(0, Math.min(x, container.scrollWidth));\n    const clampedY = Math.max(0, Math.min(y, container.scrollHeight));\n\n    return { x: clampedX, y: clampedY };\n  };\n\n  // 'open' accepts props, trigger props, and optional event for positioning, then opens the menu\n  const open = useEvent(\n    (\n      props: P = {} as P,\n      triggerProps?: T,\n      event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n    ) => {\n      setupCheck();\n\n      // Ensure the target element can serve as a positioning context for the\n      // invisible target element. If the consumer hasn't explicitly set\n      // `position: relative | absolute | fixed | sticky` we switch it to\n      // `relative` so that absolutely-positioned children are laid out correctly.\n      if (targetRef.current) {\n        const computedStyle = window.getComputedStyle(targetRef.current);\n\n        if (computedStyle.position === 'static') {\n          targetRef.current.style.position = 'relative';\n        }\n      }\n\n      // Prevent default context menu if it's a context menu event\n      if (\n        event &&\n        'preventDefault' in event &&\n        typeof event.preventDefault === 'function'\n      ) {\n        event.preventDefault();\n      }\n\n      const { x, y } = calculatePosition(event);\n      setAnchorPosition({ x, y });\n\n      // Merge defaultMenuProps with provided props\n      const finalProps = defaultMenuProps\n        ? { ...defaultMenuProps, ...props }\n        : props;\n\n      setComponentProps(finalProps);\n      setTriggerProps(triggerProps ?? null);\n      setIsOpen(true);\n    },\n  );\n\n  const update = useEvent((props: P, triggerProps?: T) => {\n    setupCheck();\n\n    // Merge defaultMenuProps with provided props\n    const finalProps = defaultMenuProps\n      ? { ...defaultMenuProps, ...props }\n      : props;\n\n    setComponentProps(finalProps as P);\n    setTriggerProps(triggerProps ?? null);\n  });\n\n  const close = useEvent(() => {\n    setIsOpen(false);\n    setAnchorPosition(null);\n  });\n\n  // Context menu event handler\n  const onContextMenu = useEvent(\n    (event: MouseEvent | PointerEvent | MouseEvent | PointerEvent) => {\n      event.preventDefault();\n      if (isOpen) {\n        const pos = calculatePosition(event);\n        setAnchorPosition(pos);\n      } else {\n        open(defaultMenuProps, undefined, event);\n      }\n    },\n  );\n\n  // Bind the onContextMenu event to targetRef\n  useEffect(() => {\n    const element = targetRef.current;\n    if (!element) return;\n\n    element.addEventListener('contextmenu', onContextMenu as any);\n\n    return () => {\n      element.removeEventListener('contextmenu', onContextMenu as any);\n    };\n  }, [onContextMenu]);\n\n  // Render the menu only when componentProps is set\n  const renderedMenu = useMemo(() => {\n    if (!componentProps || !anchorPosition) return null;\n\n    return (\n      <>\n        {/* Invisible anchor element positioned at click coordinates */}\n        <span\n          ref={invisibleAnchorRef}\n          style={{\n            position: 'absolute',\n            left: `${anchorPosition.x}px`,\n            top: `${anchorPosition.y}px`,\n            width: '0px',\n            height: '0px',\n            lineHeight: '0',\n            pointerEvents: 'none',\n            visibility: 'hidden',\n          }}\n        />\n        <MenuTrigger\n          isDummy\n          isOpen={isOpen}\n          targetRef={invisibleAnchorRef}\n          offset={0}\n          crossOffset={0}\n          placement={\n            (triggerProps as ComponentProps<typeof MenuTrigger>)?.placement ||\n            defaultTriggerProps?.placement ||\n            'bottom start'\n          }\n          onOpenChange={setIsOpen}\n          {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n        >\n          <VisuallyHidden>\n            <Pressable>\n              <button aria-label=\"Open context menu\" />\n            </Pressable>\n          </VisuallyHidden>\n          <Component {...componentProps} />\n        </MenuTrigger>\n      </>\n    );\n  }, [\n    componentProps,\n    triggerProps,\n    isOpen,\n    defaultTriggerProps,\n    anchorPosition,\n  ]);\n\n  return {\n    targetRef,\n    open,\n    update,\n    close,\n    isOpen,\n    get rendered() {\n      setupRef.current = true;\n\n      return renderedMenu;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/components/content/ActiveZone/ActiveZone.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useFocus as useFocus$1 } from "../../../utils/react/interactions.js";

package/dist/components/content/Alert/Alert.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import themes_default from "../../../data/themes.js";
 import { useAlert } from "./use-alert.js";
 import { tasty } from "@tenphi/tasty";

package/dist/components/content/Alert/use-alert.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useDeprecationWarning } from "../../../_internal/hooks/use-deprecation-warning.js";
 import { CONTAINER_STYLES, TEXT_STYLES, filterBaseProps } from "@tenphi/tasty";

package/dist/components/content/Avatar/Avatar.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { CONTAINER_STYLES, Element, filterBaseProps } from "@tenphi/tasty";
 import { forwardRef } from "react";

package/dist/components/content/Badge/Badge.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { _Item } from "../Item/Item.js";
 import themes_default from "../../../data/themes.js";
 import { tasty } from "@tenphi/tasty";

package/dist/components/content/Card/Card.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { CONTAINER_STYLES, filterBaseProps, tasty } from "@tenphi/tasty";
 import { forwardRef } from "react";

package/dist/components/content/Content.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../utils/styles.js";
 import { useSlotProps } from "../../utils/react/Slots.js";
 import { CONTAINER_STYLES, TEXT_STYLES, filterBaseProps, tasty } from "@tenphi/tasty";

package/dist/components/content/CopyPasteBlock/CopyPasteBlock.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useTimer } from "../../../_internal/hooks/use-timer/use-timer.js";
 import { CopyIcon } from "../../../icons/CopyIcon.js";