@cube-dev/ui-kit 0.162.0 → 0.164.0

package/dist/components/actions/ItemButton/ItemButton.js

@@ -1,9 +1,10 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { mergeRefs } from "../../../utils/react/useCombinedRefs.js";
 import { useDismissParentPopover } from "../../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { DisplayTransition } from "../../helpers/DisplayTransition/DisplayTransition.js";
+import { ITEM_RESTING_COLOR_VARIANTS, resolveItemVariant } from "../../../data/item-themes.js";
 import { ItemActionProvider } from "../ItemActionContext.js";
 import { useAction } from "../use-action.js";
 import { ItemAction } from "../ItemAction/ItemAction.js";
@@ -24,49 +25,52 @@ const StyledItem = tasty(_Item, {
 		placeContent: "center stretch"
 	}
 });
-const ActionsWrapper = tasty({ styles: {
-	display: "grid",
-	position: "relative",
-	placeContent: "stretch",
-	placeItems: "stretch",
-	$size: {
-		"": "$size-md",
-		"size=xsmall": "$size-xs",
-		"size=small": "$size-sm",
-		"size=medium": "$size-md",
-		"size=large": "$size-lg",
-		"size=xlarge": "$size-xl"
-	},
-	Actions: {
-		$: ">",
-		position: "absolute",
-		inset: {
-			"": "1bw 1bw auto auto",
-			"type=card": "(1bw + .5x) (1bw + .5x) auto auto"
-		},
-		display: "flex",
-		gap: "1bw",
-		placeItems: "center",
-		placeContent: "center end",
-		pointerEvents: {
-			"": "auto",
-			"!actions-shown": "none"
-		},
-		padding: "0 $side-padding",
-		height: "min ($size - 2bw)",
-		opacity: {
-			"": 1,
-			"!actions-shown": 0
-		},
-		translate: {
-			"": "0 0",
-			"!actions-shown": ".5x 0"
+const ActionsWrapper = tasty({
+	variants: ITEM_RESTING_COLOR_VARIANTS,
+	styles: {
+		display: "grid",
+		position: "relative",
+		placeContent: "stretch",
+		placeItems: "stretch",
+		$size: {
+			"": "$size-md",
+			"size=xsmall": "$size-xs",
+			"size=small": "$size-sm",
+			"size=medium": "$size-md",
+			"size=large": "$size-lg",
+			"size=xlarge": "$size-xl"
 		},
-		transition: "theme, translate",
-		"$action-size": "min(max((2x + 2bw), ($size - 1x - 2bw)), (3x - 2bw))",
-		"$side-padding": "(($size - $action-size - 2bw) / 2)"
+		Actions: {
+			$: ">",
+			position: "absolute",
+			inset: {
+				"": "1bw 1bw auto auto",
+				"type=card": "(1bw + .5x) (1bw + .5x) auto auto"
+			},
+			display: "flex",
+			gap: "1bw",
+			placeItems: "center",
+			placeContent: "center end",
+			pointerEvents: {
+				"": "auto",
+				"!actions-shown": "none"
+			},
+			padding: "0 $side-padding",
+			height: "min ($size - 2bw)",
+			opacity: {
+				"": 1,
+				"!actions-shown": 0
+			},
+			translate: {
+				"": "0 0",
+				"!actions-shown": ".5x 0"
+			},
+			transition: "theme, translate",
+			"$action-size": "min(max((2x + 2bw), ($size - 1x - 2bw)), (3x - 2bw))",
+			"$side-padding": "(($size - $action-size - 2bw) / 2)"
+		}
 	}
-} });
+});
 const ItemButton = forwardRef(function ItemButton(allProps, ref) {
 	const { mods, to, htmlType, as, type = "item", theme = "default", onPress, onPressStart: _onPressStart, onPressEnd: _onPressEnd, onPressChange: _onPressChange, onPressUp: _onPressUp, actions, size = "medium", wrapperStyles, autoHideActions = false, disableActionsFocus = false, isDisabled, isLoading = false, ...rest } = allProps;
 	const finalIsDisabled = isDisabled === true || isLoading && isDisabled !== false;
@@ -120,11 +124,16 @@ const ItemButton = forwardRef(function ItemButton(allProps, ref) {
 		onPress: wrappedOnPress
 	}, ref);
 	const finalMods = useMemo(() => {
-		return shouldShowActions ? {
+		return {
 			...mods,
-			"actions-shown": true
-		} : mods;
-	}, [mods, shouldShowActions]);
+			...shouldShowActions ? { "actions-shown": true } : null,
+			disabled: finalIsDisabled
+		};
+	}, [
+		mods,
+		shouldShowActions,
+		finalIsDisabled
+	]);
 	const combinedRef = useMemo(() => mergeRefs(actionProps.ref, buttonElementRef), [actionProps.ref]);
 	const button = /* @__PURE__ */ jsx(StyledItem, {
 		insideWrapper: !!actions,
@@ -142,6 +151,7 @@ const ItemButton = forwardRef(function ItemButton(allProps, ref) {
 	});
 	if (actions) return /* @__PURE__ */ jsxs(ActionsWrapper, {
 		...hoverProps,
+		variant: resolveItemVariant(theme, type),
 		"data-size": size,
 		"data-type": type,
 		"data-theme": theme,

package/dist/components/actions/ItemButton/ItemButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"ItemButton.js","names":["Item","mergeProps"],"sources":["../../../../src/components/actions/ItemButton/ItemButton.tsx"],"sourcesContent":["import { FocusableRef, PressEvent } from '@react-types/shared';\nimport { Styles, tasty } from '@tenphi/tasty';\nimport {\n  CSSProperties,\n  forwardRef,\n  ReactNode,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useFocusWithin, useHover } from 'react-aria';\n\nimport { useEvent } from '../../../_internal';\nimport {\n  mergeProps,\n  mergeRefs,\n  useDismissParentPopover,\n} from '../../../utils/react';\nimport { CubeItemProps, Item } from '../../content/Item';\nimport { ItemBadge } from '../../content/ItemBadge';\nimport { DisplayTransition } from '../../helpers';\nimport { CubeItemActionProps, ItemAction } from '../ItemAction';\nimport { ItemActionProvider } from '../ItemActionContext';\nimport { CubeUseActionProps, useAction } from '../use-action';\n\nexport interface CubeItemButtonProps\n  extends Omit<CubeItemProps, 'size'>,\n    Omit<CubeUseActionProps, 'as'> {\n  actions?: ReactNode;\n  size?: Omit<CubeItemProps['size'], 'inline'>;\n  wrapperStyles?: Styles;\n}\n\nconst StyledItem = tasty(Item, {\n  as: 'button',\n  type: 'item',\n  theme: 'default',\n  styles: {\n    recipe: 'reset button',\n    placeContent: 'center stretch',\n  },\n});\n\nconst ActionsWrapper = tasty({\n  styles: {\n    display: 'grid',\n    position: 'relative',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n\n    $size: {\n      '': '$size-md',\n      'size=xsmall': '$size-xs',\n      'size=small': '$size-sm',\n      'size=medium': '$size-md',\n      'size=large': '$size-lg',\n      'size=xlarge': '$size-xl',\n    },\n\n    Actions: {\n      $: '>',\n      position: 'absolute',\n      inset: {\n        '': '1bw 1bw auto auto',\n        'type=card': '(1bw + .5x) (1bw + .5x) auto auto',\n      },\n      display: 'flex',\n      gap: '1bw',\n      placeItems: 'center',\n      placeContent: 'center end',\n      pointerEvents: {\n        '': 'auto',\n        '!actions-shown': 'none',\n      },\n      padding: '0 $side-padding',\n      height: 'min ($size - 2bw)',\n      opacity: {\n        '': 1,\n        '!actions-shown': 0,\n      },\n      translate: {\n        '': '0 0',\n        '!actions-shown': '.5x 0',\n      },\n      transition: 'theme, translate',\n\n      // Size for the action buttons\n      '$action-size': 'min(max((2x + 2bw), ($size - 1x - 2bw)), (3x - 2bw))',\n      // Side padding for the button\n      '$side-padding': '(($size - $action-size - 2bw) / 2)',\n    },\n  },\n});\n\nconst ItemButton = forwardRef(function ItemButton(\n  allProps: CubeItemButtonProps,\n  ref: FocusableRef<HTMLElement>,\n) {\n  const {\n    mods,\n    to,\n    htmlType,\n    as,\n    type = 'item',\n    theme = 'default',\n    onPress,\n    // Extract react-aria press callbacks to prevent them from leaking to DOM via rest.\n    // These are handled by useButton inside useAction.\n    onPressStart: _onPressStart,\n    onPressEnd: _onPressEnd,\n    onPressChange: _onPressChange,\n    onPressUp: _onPressUp,\n    actions,\n    size = 'medium',\n    wrapperStyles,\n    autoHideActions = false,\n    disableActionsFocus = false,\n    isDisabled,\n    isLoading = false,\n    ...rest\n  } = allProps as CubeItemButtonProps & {\n    as?: 'a' | 'button' | 'div' | 'span';\n  };\n\n  // Loading state makes the component disabled (same logic as Item)\n  const finalIsDisabled =\n    isDisabled === true || (isLoading && isDisabled !== false);\n\n  const actionsRef = useRef<HTMLDivElement>(null);\n  const [actionsWidth, setActionsWidth] = useState(0);\n  const [areActionsVisible, setAreActionsVisible] = useState(false);\n  const [areActionsShown, setAreActionsShown] = useState(false);\n\n  useLayoutEffect(() => {\n    if (actions && actionsRef.current) {\n      const width = Math.round(actionsRef.current.offsetWidth);\n      if (width !== actionsWidth) {\n        setActionsWidth(width);\n      }\n    }\n  }, [actions, areActionsVisible]);\n\n  const [isFocusWithin, setIsFocusWithin] = useState(false);\n  const [hasPressed, setHasPressed] = useState(false);\n  const { hoverProps, isHovered } = useHover({});\n  const { focusWithinProps } = useFocusWithin({\n    onFocusWithinChange: setIsFocusWithin,\n  });\n\n  // Watch for data-pressed attribute on any descendant element\n  useLayoutEffect(() => {\n    const actionsEl = actionsRef.current;\n\n    if (!actionsEl || !autoHideActions) return;\n\n    const checkPressed = () => {\n      setHasPressed(actionsEl.querySelector('[data-pressed]') !== null);\n    };\n\n    const observer = new MutationObserver(checkPressed);\n\n    observer.observe(actionsEl, {\n      attributes: true,\n      attributeFilter: ['data-pressed'],\n      subtree: true,\n    });\n\n    checkPressed();\n\n    return () => observer.disconnect();\n  }, [areActionsVisible, autoHideActions]);\n\n  const shouldShowActions =\n    isHovered || isFocusWithin || hasPressed || !autoHideActions;\n\n  // Default: pressing an ItemButton inside an open popover closes that\n  // popover. Opt-outs: `data-popover-trigger` on self (applied by\n  // FilterPicker / Picker / Select / MenuTrigger for their own triggers) and\n  // `data-popover-keep` on self or any ancestor. Modals don't subscribe.\n  const dismissParentPopover = useDismissParentPopover();\n  const buttonElementRef = useRef<HTMLElement | null>(null);\n\n  const wrappedOnPress = useEvent((e: PressEvent) => {\n    onPress?.(e);\n    const el = buttonElementRef.current;\n    if (!el) return;\n    if (el.hasAttribute('data-popover-trigger')) return;\n    if (el.closest('[data-popover-keep]')) return;\n    dismissParentPopover(el);\n  });\n\n  const { actionProps } = useAction(\n    {\n      ...(allProps as any),\n      htmlType,\n      to,\n      as,\n      mods,\n      isDisabled: finalIsDisabled,\n      onPress: wrappedOnPress,\n    },\n    ref,\n  );\n\n  const finalMods = useMemo(() => {\n    return shouldShowActions ? { ...mods, 'actions-shown': true } : mods;\n  }, [mods, shouldShowActions]);\n\n  // Merge the useAction-supplied ref with our internal ref so the dismiss\n  // wrapper can read the rendered DOM node at press time.\n  const combinedRef = useMemo(\n    () => mergeRefs(actionProps.ref as any, buttonElementRef),\n    [actionProps.ref],\n  );\n\n  const button = (\n    <StyledItem\n      insideWrapper={!!actions}\n      showActions={shouldShowActions}\n      actions={actions ? true : undefined}\n      {...(mergeProps(rest, actionProps) as any)}\n      ref={combinedRef}\n      data-popover-dismiss=\"\"\n      htmlType={actionProps.type}\n      type={type}\n      theme={theme}\n      size={size}\n      isLoading={isLoading}\n      isDisabled={isDisabled}\n    />\n  );\n\n  if (actions) {\n    return (\n      <ActionsWrapper\n        {...hoverProps}\n        data-size={size}\n        data-type={type}\n        data-theme={theme}\n        mods={finalMods}\n        styles={wrapperStyles}\n        style={\n          {\n            '--actions-width':\n              areActionsVisible || !autoHideActions\n                ? `${actionsWidth}px`\n                : '0px',\n            ...(typeof size === 'number' && { '--size': `${size}px` }),\n          } as CSSProperties\n        }\n      >\n        {button}\n        <ItemActionProvider\n          type={type}\n          theme={theme}\n          disableActionsFocus={disableActionsFocus}\n          isDisabled={finalIsDisabled}\n        >\n          {autoHideActions ? (\n            <DisplayTransition\n              exposeUnmounted\n              isShown={shouldShowActions}\n              onPhaseChange={(phase) => {\n                setAreActionsVisible(phase !== 'unmounted');\n              }}\n              onToggle={(isShown) => {\n                setAreActionsShown(isShown);\n              }}\n            >\n              {({ ref: transitionRef }) => {\n                return (\n                  <div\n                    {...focusWithinProps}\n                    ref={(node: any) => {\n                      actionsRef.current = node;\n                      transitionRef(node);\n                    }}\n                    data-element=\"Actions\"\n                  >\n                    {actions}\n                  </div>\n                );\n              }}\n            </DisplayTransition>\n          ) : (\n            <div ref={actionsRef} data-element=\"Actions\">\n              {actions}\n            </div>\n          )}\n        </ItemActionProvider>\n      </ActionsWrapper>\n    );\n  }\n\n  return button;\n});\n\nconst _ItemButton = Object.assign(ItemButton, {\n  Action: ItemAction,\n  Badge: ItemBadge,\n});\n\nexport { _ItemButton as ItemButton };\nexport type {\n  CubeItemButtonProps as ItemButtonProps,\n  CubeItemActionProps as ItemActionProps,\n};\n"],"mappings":"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"}
+{"version":3,"file":"ItemButton.js","names":["Item","mergeProps"],"sources":["../../../../src/components/actions/ItemButton/ItemButton.tsx"],"sourcesContent":["import { FocusableRef, PressEvent } from '@react-types/shared';\nimport { Styles, tasty } from '@tenphi/tasty';\nimport {\n  CSSProperties,\n  forwardRef,\n  ReactNode,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useFocusWithin, useHover } from 'react-aria';\n\nimport { useEvent } from '../../../_internal';\nimport {\n  ITEM_RESTING_COLOR_VARIANTS,\n  resolveItemVariant,\n} from '../../../data/item-themes';\nimport {\n  mergeProps,\n  mergeRefs,\n  useDismissParentPopover,\n} from '../../../utils/react';\nimport { CubeItemProps, Item } from '../../content/Item';\nimport { ItemBadge } from '../../content/ItemBadge';\nimport { DisplayTransition } from '../../helpers';\nimport { CubeItemActionProps, ItemAction } from '../ItemAction';\nimport { ItemActionProvider } from '../ItemActionContext';\nimport { CubeUseActionProps, useAction } from '../use-action';\n\nexport interface CubeItemButtonProps\n  extends Omit<CubeItemProps, 'size'>,\n    Omit<CubeUseActionProps, 'as'> {\n  actions?: ReactNode;\n  size?: Omit<CubeItemProps['size'], 'inline'>;\n  wrapperStyles?: Styles;\n}\n\nconst StyledItem = tasty(Item, {\n  as: 'button',\n  type: 'item',\n  theme: 'default',\n  styles: {\n    recipe: 'reset button',\n    placeContent: 'center stretch',\n  },\n});\n\nconst ActionsWrapper = tasty({\n  // Actions default to the `current` type, which paints from the inherited\n  // `currentcolor` — but they are rendered as a SIBLING of the button here, not\n  // inside it, so without this they would inherit the page color instead of the\n  // row's. Harmless on the default theme (the two match) and plainly wrong on\n  // any other: a `special` row would hand its actions the page's dark text to\n  // tint with, on a dark purple surface. The variant carries the row's resting\n  // color down so `currentcolor` means the same thing it does inside an `Item`.\n  variants: ITEM_RESTING_COLOR_VARIANTS,\n  styles: {\n    display: 'grid',\n    position: 'relative',\n    placeContent: 'stretch',\n    placeItems: 'stretch',\n\n    $size: {\n      '': '$size-md',\n      'size=xsmall': '$size-xs',\n      'size=small': '$size-sm',\n      'size=medium': '$size-md',\n      'size=large': '$size-lg',\n      'size=xlarge': '$size-xl',\n    },\n\n    Actions: {\n      $: '>',\n      position: 'absolute',\n      inset: {\n        '': '1bw 1bw auto auto',\n        'type=card': '(1bw + .5x) (1bw + .5x) auto auto',\n      },\n      display: 'flex',\n      gap: '1bw',\n      placeItems: 'center',\n      placeContent: 'center end',\n      pointerEvents: {\n        '': 'auto',\n        '!actions-shown': 'none',\n      },\n      padding: '0 $side-padding',\n      height: 'min ($size - 2bw)',\n      opacity: {\n        '': 1,\n        '!actions-shown': 0,\n      },\n      translate: {\n        '': '0 0',\n        '!actions-shown': '.5x 0',\n      },\n      transition: 'theme, translate',\n\n      // Size for the action buttons\n      '$action-size': 'min(max((2x + 2bw), ($size - 1x - 2bw)), (3x - 2bw))',\n      // Side padding for the button\n      '$side-padding': '(($size - $action-size - 2bw) / 2)',\n    },\n  },\n});\n\nconst ItemButton = forwardRef(function ItemButton(\n  allProps: CubeItemButtonProps,\n  ref: FocusableRef<HTMLElement>,\n) {\n  const {\n    mods,\n    to,\n    htmlType,\n    as,\n    type = 'item',\n    theme = 'default',\n    onPress,\n    // Extract react-aria press callbacks to prevent them from leaking to DOM via rest.\n    // These are handled by useButton inside useAction.\n    onPressStart: _onPressStart,\n    onPressEnd: _onPressEnd,\n    onPressChange: _onPressChange,\n    onPressUp: _onPressUp,\n    actions,\n    size = 'medium',\n    wrapperStyles,\n    autoHideActions = false,\n    disableActionsFocus = false,\n    isDisabled,\n    isLoading = false,\n    ...rest\n  } = allProps as CubeItemButtonProps & {\n    as?: 'a' | 'button' | 'div' | 'span';\n  };\n\n  // Loading state makes the component disabled (same logic as Item)\n  const finalIsDisabled =\n    isDisabled === true || (isLoading && isDisabled !== false);\n\n  const actionsRef = useRef<HTMLDivElement>(null);\n  const [actionsWidth, setActionsWidth] = useState(0);\n  const [areActionsVisible, setAreActionsVisible] = useState(false);\n  const [areActionsShown, setAreActionsShown] = useState(false);\n\n  useLayoutEffect(() => {\n    if (actions && actionsRef.current) {\n      const width = Math.round(actionsRef.current.offsetWidth);\n      if (width !== actionsWidth) {\n        setActionsWidth(width);\n      }\n    }\n  }, [actions, areActionsVisible]);\n\n  const [isFocusWithin, setIsFocusWithin] = useState(false);\n  const [hasPressed, setHasPressed] = useState(false);\n  const { hoverProps, isHovered } = useHover({});\n  const { focusWithinProps } = useFocusWithin({\n    onFocusWithinChange: setIsFocusWithin,\n  });\n\n  // Watch for data-pressed attribute on any descendant element\n  useLayoutEffect(() => {\n    const actionsEl = actionsRef.current;\n\n    if (!actionsEl || !autoHideActions) return;\n\n    const checkPressed = () => {\n      setHasPressed(actionsEl.querySelector('[data-pressed]') !== null);\n    };\n\n    const observer = new MutationObserver(checkPressed);\n\n    observer.observe(actionsEl, {\n      attributes: true,\n      attributeFilter: ['data-pressed'],\n      subtree: true,\n    });\n\n    checkPressed();\n\n    return () => observer.disconnect();\n  }, [areActionsVisible, autoHideActions]);\n\n  const shouldShowActions =\n    isHovered || isFocusWithin || hasPressed || !autoHideActions;\n\n  // Default: pressing an ItemButton inside an open popover closes that\n  // popover. Opt-outs: `data-popover-trigger` on self (applied by\n  // FilterPicker / Picker / Select / MenuTrigger for their own triggers) and\n  // `data-popover-keep` on self or any ancestor. Modals don't subscribe.\n  const dismissParentPopover = useDismissParentPopover();\n  const buttonElementRef = useRef<HTMLElement | null>(null);\n\n  const wrappedOnPress = useEvent((e: PressEvent) => {\n    onPress?.(e);\n    const el = buttonElementRef.current;\n    if (!el) return;\n    if (el.hasAttribute('data-popover-trigger')) return;\n    if (el.closest('[data-popover-keep]')) return;\n    dismissParentPopover(el);\n  });\n\n  const { actionProps } = useAction(\n    {\n      ...(allProps as any),\n      htmlType,\n      to,\n      as,\n      mods,\n      isDisabled: finalIsDisabled,\n      onPress: wrappedOnPress,\n    },\n    ref,\n  );\n\n  // `disabled` is on the wrapper so its variant can paint the row's DISABLED\n  // label color, not just the resting one. Actions default to the `current` type\n  // and suppress their own fade when the disabled state is inherited — on the\n  // grounds that the host already faded the color they paint from — so without\n  // this the wrapper would hand them a full-strength color and a disabled button\n  // would sit next to full-strength actions. See `ITEM_RESTING_COLOR_VARIANTS`.\n  const finalMods = useMemo(() => {\n    return {\n      ...mods,\n      ...(shouldShowActions ? { 'actions-shown': true } : null),\n      disabled: finalIsDisabled,\n    };\n  }, [mods, shouldShowActions, finalIsDisabled]);\n\n  // Merge the useAction-supplied ref with our internal ref so the dismiss\n  // wrapper can read the rendered DOM node at press time.\n  const combinedRef = useMemo(\n    () => mergeRefs(actionProps.ref as any, buttonElementRef),\n    [actionProps.ref],\n  );\n\n  const button = (\n    <StyledItem\n      insideWrapper={!!actions}\n      showActions={shouldShowActions}\n      actions={actions ? true : undefined}\n      {...(mergeProps(rest, actionProps) as any)}\n      ref={combinedRef}\n      data-popover-dismiss=\"\"\n      htmlType={actionProps.type}\n      type={type}\n      theme={theme}\n      size={size}\n      isLoading={isLoading}\n      isDisabled={isDisabled}\n    />\n  );\n\n  if (actions) {\n    return (\n      <ActionsWrapper\n        {...hoverProps}\n        // The same resolver `Item` uses, so the wrapper cannot land on a\n        // different variant than the row it wraps.\n        variant={resolveItemVariant(theme, type)}\n        data-size={size}\n        data-type={type}\n        data-theme={theme}\n        mods={finalMods}\n        styles={wrapperStyles}\n        style={\n          {\n            '--actions-width':\n              areActionsVisible || !autoHideActions\n                ? `${actionsWidth}px`\n                : '0px',\n            ...(typeof size === 'number' && { '--size': `${size}px` }),\n          } as CSSProperties\n        }\n      >\n        {button}\n        <ItemActionProvider\n          type={type}\n          theme={theme}\n          disableActionsFocus={disableActionsFocus}\n          isDisabled={finalIsDisabled}\n        >\n          {autoHideActions ? (\n            <DisplayTransition\n              exposeUnmounted\n              isShown={shouldShowActions}\n              onPhaseChange={(phase) => {\n                setAreActionsVisible(phase !== 'unmounted');\n              }}\n              onToggle={(isShown) => {\n                setAreActionsShown(isShown);\n              }}\n            >\n              {({ ref: transitionRef }) => {\n                return (\n                  <div\n                    {...focusWithinProps}\n                    ref={(node: any) => {\n                      actionsRef.current = node;\n                      transitionRef(node);\n                    }}\n                    data-element=\"Actions\"\n                  >\n                    {actions}\n                  </div>\n                );\n              }}\n            </DisplayTransition>\n          ) : (\n            <div ref={actionsRef} data-element=\"Actions\">\n              {actions}\n            </div>\n          )}\n        </ItemActionProvider>\n      </ActionsWrapper>\n    );\n  }\n\n  return button;\n});\n\nconst _ItemButton = Object.assign(ItemButton, {\n  Action: ItemAction,\n  Badge: ItemBadge,\n});\n\nexport { _ItemButton as ItemButton };\nexport type {\n  CubeItemButtonProps as ItemButtonProps,\n  CubeItemActionProps as ItemActionProps,\n};\n"],"mappings":"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"}

package/dist/components/actions/Link/Link.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { Button } from "../Button/Button.js";
 import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";

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

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

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { filterCollectionItemProps } from "../../CollectionItem.js";
 import { _Item } from "../../content/Item/Item.js";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { TooltipProvider } from "../../overlays/Tooltip/TooltipProvider.js";
 import { MenuItem } from "./MenuItem.js";
 import { StyledMenu, StyledSection, StyledSectionHeading } from "./styled.js";

package/dist/components/actions/Menu/MenuTrigger.d.ts

@@ -10,6 +10,19 @@ type CubeMenuTriggerProps = AriaMenuTriggerProps$1 & PositionProps & {
   children: [ReactElement | ((state: MenuTriggerState) => ReactElement), ReactElement];
   closeOnSelect?: boolean;
   isDummy?: boolean;
+  /**
+   * Whether focus returns to the trigger when the menu closes. Defaults to
+   * `true`.
+   *
+   * The restore is skipped automatically whenever the action that closed the
+   * menu has already moved focus somewhere else, so an item that opens a
+   * panel/dialog/inline editor and focuses it needs nothing here. Pass
+   * `false` for the remaining case: a surface that claims focus *later* than
+   * the menu's own restore (after an async load, an entry animation, or a
+   * `requestAnimationFrame`), where the trigger would otherwise take focus
+   * first and produce a visible flash.
+   */
+  shouldRestoreFocus?: boolean;
   /**
    * External ref to the popover container element. When provided, it is
    * aliased to the internal `menuPopoverRef`, letting consumers (e.g.

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { SlotProvider } from "../../../utils/react/Slots.js";
 import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
@@ -18,12 +18,13 @@ import { PressResponder } from "@react-aria/interactions";
 function MenuTrigger(props, ref) {
 	const internalPopoverRef = useRef(null);
 	const menuPopoverRef = props.popoverRef ?? internalPopoverRef;
+	const trayRef = useRef(null);
 	const triggerRef = useRef(null);
 	const domRef = useObjectRef(ref);
 	const menuTriggerRef = props.targetRef || domRef || triggerRef;
 	const menuRef = useRef(null);
 	const wasOpenRef = useRef(false);
-	const { children, shouldFlip = true, closeOnSelect, trigger = "press", isDisabled, isDummy, mobileType = "popover" } = props;
+	const { children, shouldFlip = true, closeOnSelect, trigger = "press", isDisabled, isDummy, mobileType = "popover", shouldRestoreFocus = true } = props;
 	const menuId = useMemo(() => generateRandomId(), []);
 	if (!Array.isArray(children) || children.length > 2) throw new Error("MenuTrigger must have exactly 2 children");
 	let [menuTrigger, menu] = children;
@@ -36,18 +37,6 @@ function MenuTrigger(props, ref) {
 		triggerRef: menuTriggerRef,
 		containerRef: menuPopoverRef
 	});
-	useEffect(() => {
-		if (!state.isOpen && wasOpenRef.current && !isDummy) {
-			wasOpenRef.current = false;
-			setTimeout(() => {
-				menuTriggerRef.current?.focus();
-			}, 0);
-		} else if (state.isOpen) wasOpenRef.current = true;
-	}, [
-		state.isOpen,
-		menuTriggerRef,
-		isDummy
-	]);
 	if (typeof menuTrigger === "function") menuTrigger = menuTrigger(state);
 	const { menuTriggerProps, menuProps } = useMenuTrigger({ isDisabled }, state, menuTriggerRef);
 	let initialPlacement = props.placement ?? "bottom start";
@@ -65,6 +54,28 @@ function MenuTrigger(props, ref) {
 		offset: props.offset ?? 8,
 		crossOffset: props.crossOffset ?? 0
 	});
+	const hasFocusMovedOutsideMenu = useEvent(() => {
+		const activeElement = document.activeElement;
+		if (!activeElement || activeElement === document.body) return false;
+		if (!activeElement.isConnected) return false;
+		return !((isTray ? trayRef.current : menuPopoverRef.current)?.contains(activeElement) || menuRef.current?.contains(activeElement) || menuTriggerRef.current?.contains(activeElement));
+	});
+	useEffect(() => {
+		if (!state.isOpen && wasOpenRef.current && !isDummy) {
+			wasOpenRef.current = false;
+			if (!shouldRestoreFocus) return;
+			setTimeout(() => {
+				if (hasFocusMovedOutsideMenu()) return;
+				menuTriggerRef.current?.focus();
+			}, 0);
+		} else if (state.isOpen) wasOpenRef.current = true;
+	}, [
+		state.isOpen,
+		menuTriggerRef,
+		isDummy,
+		shouldRestoreFocus,
+		hasFocusMovedOutsideMenu
+	]);
 	const menuContext = {
 		...menuProps,
 		ref: menuRef,
@@ -82,7 +93,7 @@ function MenuTrigger(props, ref) {
 		isClosing: !state.isOpen
 	};
 	const contents = /* @__PURE__ */ jsxs(FocusScope, {
-		restoreFocus: true,
+		restoreFocus: shouldRestoreFocus,
 		children: [
 			/* @__PURE__ */ jsx(DismissButton, { onDismiss: state.close }),
 			menu,
@@ -106,6 +117,7 @@ function MenuTrigger(props, ref) {
 	});
 	let overlay;
 	if (isTray) overlay = /* @__PURE__ */ jsx(_Tray, {
+		ref: trayRef,
 		isOpen: state.isOpen,
 		shouldCloseOnInteractOutside,
 		onClose: state.close,

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 { useObjectRef } from '@react-aria/utils';\nimport { useIsMobileDevice } from '@react-spectrum/utils';\nimport {\n  forwardRef,\n  Fragment,\n  MutableRefObject,\n  ReactElement,\n  Ref,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  FocusScope,\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     * External ref to the popover container element. When provided, it is\n     * aliased to the internal `menuPopoverRef`, letting consumers (e.g.\n     * `useAnchoredMenu` / `useContextMenu`) feed the popover container into\n     * their own `usePopoverSync` so the nested-popover guard can recognize\n     * submenus opened inside this menu. Optional.\n     */\n    popoverRef?: MutableRefObject<HTMLDivElement | null>;\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: Ref<HTMLElement>) {\n  const internalPopoverRef = useRef<HTMLDivElement>(null);\n  const menuPopoverRef = props.popoverRef ?? internalPopoverRef;\n  const triggerRef = useRef<HTMLElement>(null);\n  const domRef = useObjectRef(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    triggerRef: menuTriggerRef,\n    containerRef: menuPopoverRef,\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  // Wrap in a FocusScope so the menu popover registers as a child of any\n  // outer contained FocusScope (e.g. a parent Dialog/Popover). Without this,\n  // when the menu opens inside an outer contained FocusScope, the outer\n  // scope rejects focus moving into the menu items (which live in a portal\n  // and would otherwise belong to no scope) and yanks focus back to the\n  // menu trigger.\n  const contents = (\n    <FocusScope restoreFocus>\n      <DismissButton onDismiss={state.close} />\n      {menu}\n      <DismissButton onDismiss={state.close} />\n    </FocusScope>\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      if (el.closest('[data-popover-keep]')) return false;\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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"}
+{"version":3,"file":"MenuTrigger.js","names":["Tray","Popover"],"sources":["../../../../src/components/actions/Menu/MenuTrigger.tsx"],"sourcesContent":["import { PressResponder } from '@react-aria/interactions';\nimport { useObjectRef } from '@react-aria/utils';\nimport { useIsMobileDevice } from '@react-spectrum/utils';\nimport {\n  forwardRef,\n  Fragment,\n  MutableRefObject,\n  ReactElement,\n  Ref,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport {\n  AriaMenuTriggerProps,\n  DismissButton,\n  FocusScope,\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     * Whether focus returns to the trigger when the menu closes. Defaults to\n     * `true`.\n     *\n     * The restore is skipped automatically whenever the action that closed the\n     * menu has already moved focus somewhere else, so an item that opens a\n     * panel/dialog/inline editor and focuses it needs nothing here. Pass\n     * `false` for the remaining case: a surface that claims focus *later* than\n     * the menu's own restore (after an async load, an entry animation, or a\n     * `requestAnimationFrame`), where the trigger would otherwise take focus\n     * first and produce a visible flash.\n     */\n    shouldRestoreFocus?: boolean;\n    /**\n     * External ref to the popover container element. When provided, it is\n     * aliased to the internal `menuPopoverRef`, letting consumers (e.g.\n     * `useAnchoredMenu` / `useContextMenu`) feed the popover container into\n     * their own `usePopoverSync` so the nested-popover guard can recognize\n     * submenus opened inside this menu. Optional.\n     */\n    popoverRef?: MutableRefObject<HTMLDivElement | null>;\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: Ref<HTMLElement>) {\n  const internalPopoverRef = useRef<HTMLDivElement>(null);\n  const menuPopoverRef = props.popoverRef ?? internalPopoverRef;\n  const trayRef = useRef<HTMLElement>(null);\n  const triggerRef = useRef<HTMLElement>(null);\n  const domRef = useObjectRef(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    shouldRestoreFocus = true,\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    triggerRef: menuTriggerRef,\n    containerRef: menuPopoverRef,\n  });\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  // Whether focus has been claimed by something outside the closing menu —\n  // the signal that a menu action handed focus off and the trigger must not\n  // take it back.\n  //\n  // Focus still inside the menu overlay means nobody claimed it: the pressed\n  // item keeps focus while the popover plays its ~350ms exit animation. Focus\n  // on `<body>` (or on a detached element) means the focused node went away\n  // with the menu. Both are cases where the trigger is where focus belongs.\n  const hasFocusMovedOutsideMenu = useEvent(() => {\n    const activeElement = document.activeElement;\n\n    if (!activeElement || activeElement === document.body) return false;\n    if (!activeElement.isConnected) return false;\n\n    // `menuPopoverRef` is only wired to the `Popover` branch, so the overlay\n    // container is `trayRef` when `mobileType=\"tray\"` is in effect.\n    const overlay = isTray ? trayRef.current : menuPopoverRef.current;\n\n    return !(\n      overlay?.contains(activeElement) ||\n      menuRef.current?.contains(activeElement) ||\n      menuTriggerRef.current?.contains(activeElement)\n    );\n  });\n\n  // Restore focus manually when the menu closes\n  useEffect(() => {\n    if (!state.isOpen && wasOpenRef.current && !isDummy) {\n      wasOpenRef.current = false;\n\n      if (!shouldRestoreFocus) return;\n\n      // Use setTimeout to ensure focus restoration happens after any animations\n      setTimeout(() => {\n        // An action that opened a panel, a dialog or an inline editor has\n        // already focused it by now — taking focus back to the trigger would\n        // undo the hand-off, which consumers previously had to out-race by\n        // re-focusing on every animation frame (CUB-3962).\n        if (hasFocusMovedOutsideMenu()) return;\n\n        menuTriggerRef.current?.focus();\n      }, 0);\n    } else if (state.isOpen) {\n      wasOpenRef.current = true;\n    }\n  }, [\n    state.isOpen,\n    menuTriggerRef,\n    isDummy,\n    shouldRestoreFocus,\n    hasFocusMovedOutsideMenu,\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  // Wrap in a FocusScope so the menu popover registers as a child of any\n  // outer contained FocusScope (e.g. a parent Dialog/Popover). Without this,\n  // when the menu opens inside an outer contained FocusScope, the outer\n  // scope rejects focus moving into the menu items (which live in a portal\n  // and would otherwise belong to no scope) and yanks focus back to the\n  // menu trigger.\n  //\n  // `restoreFocus` follows `shouldRestoreFocus`, so opting out silences the\n  // scope's own unmount restore too. Scope registration (and therefore the\n  // guarantee above) is unaffected — `FocusScope` joins the tree and tracks\n  // the active scope regardless of `restoreFocus`.\n  const contents = (\n    <FocusScope restoreFocus={shouldRestoreFocus}>\n      <DismissButton onDismiss={state.close} />\n      {menu}\n      <DismissButton onDismiss={state.close} />\n    </FocusScope>\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      if (el.closest('[data-popover-keep]')) return false;\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        ref={trayRef}\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,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { usePopoverSync } from "../../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { MenuContext, useMenuContext } from "./context.js";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { DEFAULT_CLEAR_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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
 import { usePopoverSync } from "../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../_internal/hooks/use-event.js";
@@ -69,7 +69,6 @@ function useAnchoredMenu(Component, defaultTriggerProps, defaultMenuProps) {
 	const renderedMenu = useMemo(() => {
 		if (!componentProps) return null;
 		return /* @__PURE__ */ jsxs(_MenuTrigger, {
-			placement: "bottom start",
 			...mergeProps$1(defaultTriggerProps, triggerProps || void 0),
 			isDummy: true,
 			isOpen,

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 { useI18n } from '../../i18n';\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 { t } = useI18n();\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 popoverRef = useRef<HTMLDivElement>(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  // Feed both the anchor (`triggerRef`) and the popover container\n  // (`containerRef`) into the sync. The container ref is shared with the\n  // rendered `MenuTrigger` via its `popoverRef` prop — the dummy `MenuTrigger`\n  // opts out of `usePopoverSync` (`enabled: !isDummy`), so without this the\n  // nested-popover guard would have no container to match against and a\n  // `SubMenuTrigger` opened inside this menu would close the whole menu.\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => setIsOpen(false),\n    triggerRef: anchorRef,\n    containerRef: popoverRef,\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        placement=\"bottom start\"\n        {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n        isDummy\n        isOpen={isOpen}\n        targetRef={anchorRef}\n        popoverRef={popoverRef}\n        onOpenChange={setIsOpen}\n      >\n        <VisuallyHidden>\n          <Pressable>\n            <button aria-label={t('contextMenu.contextMenu', 'context-menu')} />\n          </Pressable>\n        </VisuallyHidden>\n        <Component {...componentProps} />\n      </MenuTrigger>\n    );\n  }, [componentProps, triggerProps, isOpen, defaultTriggerProps, t]);\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":";;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,gBACd,WACA,qBAIA,kBAC6B;CAC7B,MAAM,EAAE,MAAM,SAAS;CACvB,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,aAAa,OAAuB,KAAK;CAC/C,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;AAWN,gBAAe;EACb,QATa,cAAc,kBAAkB,EAAE,EAAE,CAAC;EAUlD;EACA,eAAe,UAAU,MAAM;EAC/B,YAAY;EACZ,cAAc;EACf,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,WAAU;GACV,GAAIC,aAAW,qBAAqB,gBAAgB,OAAU;GAC9D;GACQ;GACR,WAAW;GACC;GACZ,cAAc;cAEd,oBAAC,4BACC,oBAAC,uBACC,oBAAC,YAAO,cAAY,EAAE,2BAA2B,eAAe,GAAI,GAC1D,GACG,EACjB,oBAAC,aAAU,GAAI,iBAAkB;IACrB;IAEf;EAAC;EAAgB;EAAc;EAAQ;EAAqB;EAAE,CAAC;AAElE,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 { useI18n } from '../../i18n';\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 { t } = useI18n();\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 popoverRef = useRef<HTMLDivElement>(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  // Feed both the anchor (`triggerRef`) and the popover container\n  // (`containerRef`) into the sync. The container ref is shared with the\n  // rendered `MenuTrigger` via its `popoverRef` prop — the dummy `MenuTrigger`\n  // opts out of `usePopoverSync` (`enabled: !isDummy`), so without this the\n  // nested-popover guard would have no container to match against and a\n  // `SubMenuTrigger` opened inside this menu would close the whole menu.\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => setIsOpen(false),\n    triggerRef: anchorRef,\n    containerRef: popoverRef,\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        {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n        isDummy\n        isOpen={isOpen}\n        targetRef={anchorRef}\n        popoverRef={popoverRef}\n        onOpenChange={setIsOpen}\n      >\n        <VisuallyHidden>\n          <Pressable>\n            <button aria-label={t('contextMenu.contextMenu', 'context-menu')} />\n          </Pressable>\n        </VisuallyHidden>\n        <Component {...componentProps} />\n      </MenuTrigger>\n    );\n  }, [componentProps, triggerProps, isOpen, defaultTriggerProps, t]);\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":";;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,gBACd,WACA,qBAIA,kBAC6B;CAC7B,MAAM,EAAE,MAAM,SAAS;CACvB,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,aAAa,OAAuB,KAAK;CAC/C,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;AAWN,gBAAe;EACb,QATa,cAAc,kBAAkB,EAAE,EAAE,CAAC;EAUlD;EACA,eAAe,UAAU,MAAM;EAC/B,YAAY;EACZ,cAAc;EACf,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,GAAIC,aAAW,qBAAqB,gBAAgB,OAAU;GAC9D;GACQ;GACR,WAAW;GACC;GACZ,cAAc;cAEd,oBAAC,4BACC,oBAAC,uBACC,oBAAC,YAAO,cAAY,EAAE,2BAA2B,eAAe,GAAI,GAC1D,GACG,EACjB,oBAAC,aAAU,GAAI,iBAAkB;IACrB;IAEf;EAAC;EAAgB;EAAc;EAAQ;EAAqB;EAAE,CAAC;AAElE,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,IAAI,WAAW;AACb,YAAS,UAAU;AAEnB,UAAO;;EAEV"}

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
 import { usePopoverSync } from "../../utils/react/usePopoverSync.js";
 import { useEvent } from "../../_internal/hooks/use-event.js";
@@ -149,7 +149,6 @@ function useContextMenu(Component, defaultTriggerProps, defaultMenuProps) {
 			})
 		}), document.body), /* @__PURE__ */ jsxs(_MenuTrigger, {
 			offset: 0,
-			crossOffset: 0,
 			placement: triggerProps?.placement || defaultTriggerProps?.placement || "bottom start",
 			...mergeProps$1(defaultTriggerProps, triggerProps || void 0),
 			isDummy: true,

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';\nimport { createPortal } from 'react-dom';\n\nimport { useEvent } from '../../_internal';\nimport { useI18n } from '../../i18n';\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 { t } = useI18n();\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 popoverRef = useRef<HTMLDivElement>(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  // Feed both the context-menu target (`triggerRef`) and the popover\n  // container (`containerRef`) into the sync. The container ref is shared with\n  // the rendered `MenuTrigger` via its `popoverRef` prop — the dummy\n  // `MenuTrigger` opts out of `usePopoverSync` (`enabled: !isDummy`), so\n  // without this the nested-popover guard would have no container to match\n  // against and a `SubMenuTrigger` opened inside this menu would close the\n  // whole menu.\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => {\n      setIsOpen(false);\n      setAnchorPosition(null);\n    },\n    triggerRef: targetRef as RefObject<HTMLElement | null>,\n    containerRef: popoverRef,\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  /**\n   * Where to put the invisible anchor, in **viewport** coordinates.\n   *\n   * Viewport rather than container-relative on purpose. The anchor is rendered\n   * into a fixed-position host pinned to the viewport origin (see\n   * `renderedMenu`), so the two agree by construction. Computing coordinates\n   * against the target element while the anchor's containing block was\n   * whichever positioned ancestor happened to enclose `rendered` is what used\n   * to open the menu one ancestor-origin away from the pointer.\n   */\n  const calculatePosition = (\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ) => {\n    if (event) {\n      const { clientX = 0, clientY = 0 } = event;\n\n      return { x: clientX, y: clientY };\n    }\n\n    // No event — a keyboard opening, which has no coordinates. Anchor on the\n    // target element's centre instead.\n    const container = targetRef.current;\n\n    if (!container) return { x: 0, y: 0 };\n\n    const rect = container.getBoundingClientRect();\n\n    return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 };\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        {/*\n          Invisible anchor at the click coordinates.\n\n          Two things make those coordinates mean what they say:\n\n          1. A `fixed` host, so the containing block's origin is the viewport\n             rather than whichever positioned ancestor encloses `rendered` — the\n             table root, the tree row — which is what used to open the menu one\n             ancestor-origin away from the pointer.\n          2. A portal to `body`, because `position: fixed` is captured by any\n             ancestor carrying a transform, filter or `will-change`. A\n             virtualized row is usually translated, so the `fixed` host alone\n             would still be anchored to the row.\n        */}\n        {createPortal(\n          <div\n            style={{\n              position: 'fixed',\n              left: 0,\n              top: 0,\n              width: 0,\n              height: 0,\n            }}\n          >\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          </div>,\n          document.body,\n        )}\n        <MenuTrigger\n          offset={0}\n          crossOffset={0}\n          placement={\n            (triggerProps as ComponentProps<typeof MenuTrigger>)?.placement ||\n            defaultTriggerProps?.placement ||\n            'bottom start'\n          }\n          {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n          isDummy\n          isOpen={isOpen}\n          targetRef={invisibleAnchorRef}\n          popoverRef={popoverRef}\n          onOpenChange={setIsOpen}\n        >\n          <VisuallyHidden>\n            <Pressable>\n              <button\n                aria-label={t(\n                  'contextMenu.openContextMenu',\n                  'Open context menu',\n                )}\n              />\n            </Pressable>\n          </VisuallyHidden>\n          <Component {...componentProps} />\n        </MenuTrigger>\n      </>\n    );\n  }, [\n    componentProps,\n    triggerProps,\n    isOpen,\n    defaultTriggerProps,\n    anchorPosition,\n    t,\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';\nimport { createPortal } from 'react-dom';\n\nimport { useEvent } from '../../_internal';\nimport { useI18n } from '../../i18n';\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 { t } = useI18n();\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 popoverRef = useRef<HTMLDivElement>(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  // Feed both the context-menu target (`triggerRef`) and the popover\n  // container (`containerRef`) into the sync. The container ref is shared with\n  // the rendered `MenuTrigger` via its `popoverRef` prop — the dummy\n  // `MenuTrigger` opts out of `usePopoverSync` (`enabled: !isDummy`), so\n  // without this the nested-popover guard would have no container to match\n  // against and a `SubMenuTrigger` opened inside this menu would close the\n  // whole menu.\n  usePopoverSync({\n    menuId,\n    isOpen,\n    onClose: () => {\n      setIsOpen(false);\n      setAnchorPosition(null);\n    },\n    triggerRef: targetRef as RefObject<HTMLElement | null>,\n    containerRef: popoverRef,\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  /**\n   * Where to put the invisible anchor, in **viewport** coordinates.\n   *\n   * Viewport rather than container-relative on purpose. The anchor is rendered\n   * into a fixed-position host pinned to the viewport origin (see\n   * `renderedMenu`), so the two agree by construction. Computing coordinates\n   * against the target element while the anchor's containing block was\n   * whichever positioned ancestor happened to enclose `rendered` is what used\n   * to open the menu one ancestor-origin away from the pointer.\n   */\n  const calculatePosition = (\n    event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent,\n  ) => {\n    if (event) {\n      const { clientX = 0, clientY = 0 } = event;\n\n      return { x: clientX, y: clientY };\n    }\n\n    // No event — a keyboard opening, which has no coordinates. Anchor on the\n    // target element's centre instead.\n    const container = targetRef.current;\n\n    if (!container) return { x: 0, y: 0 };\n\n    const rect = container.getBoundingClientRect();\n\n    return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 };\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        {/*\n          Invisible anchor at the click coordinates.\n\n          Two things make those coordinates mean what they say:\n\n          1. A `fixed` host, so the containing block's origin is the viewport\n             rather than whichever positioned ancestor encloses `rendered` — the\n             table root, the tree row — which is what used to open the menu one\n             ancestor-origin away from the pointer.\n          2. A portal to `body`, because `position: fixed` is captured by any\n             ancestor carrying a transform, filter or `will-change`. A\n             virtualized row is usually translated, so the `fixed` host alone\n             would still be anchored to the row.\n        */}\n        {createPortal(\n          <div\n            style={{\n              position: 'fixed',\n              left: 0,\n              top: 0,\n              width: 0,\n              height: 0,\n            }}\n          >\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          </div>,\n          document.body,\n        )}\n        <MenuTrigger\n          offset={0}\n          placement={\n            (triggerProps as ComponentProps<typeof MenuTrigger>)?.placement ||\n            defaultTriggerProps?.placement ||\n            'bottom start'\n          }\n          {...mergeProps(defaultTriggerProps, triggerProps || undefined)}\n          isDummy\n          isOpen={isOpen}\n          targetRef={invisibleAnchorRef}\n          popoverRef={popoverRef}\n          onOpenChange={setIsOpen}\n        >\n          <VisuallyHidden>\n            <Pressable>\n              <button\n                aria-label={t(\n                  'contextMenu.openContextMenu',\n                  'Open context menu',\n                )}\n              />\n            </Pressable>\n          </VisuallyHidden>\n          <Component {...componentProps} />\n        </MenuTrigger>\n      </>\n    );\n  }, [\n    componentProps,\n    triggerProps,\n    isOpen,\n    defaultTriggerProps,\n    anchorPosition,\n    t,\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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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.162.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.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";