@cube-dev/ui-kit 0.163.0 → 0.164.0

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

@@ -1,9 +1,10 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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.163.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";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.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";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.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.163.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.163.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";

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

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

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

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

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

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

package/dist/components/content/Content.js

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

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

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

package/dist/components/content/CopySnippet/CopySnippet.d.ts

@@ -18,6 +18,16 @@ interface CubeCopySnippetProps extends CubeCardProps {
   title?: string;
   /** Whether the snippet is single-lined */
   nowrap?: boolean;
+  /**
+   * Soft-wrap long content onto multiple lines instead of scrolling it
+   * horizontally. The block grows vertically to fit (so even a single long line
+   * is fully readable rather than clamped), and unbreakable runs like URLs,
+   * tokens and identifiers wrap too. Useful for error messages and logs.
+   * Has no effect when `nowrap` is set. Note this is a different axis from
+   * `nowrap`: `nowrap` collapses real newlines into one scrolling line, while
+   * `isWrapped` breaks long lines that would otherwise scroll.
+   */
+  isWrapped?: boolean;
   /** The prefix for each line of code. Useful for bash snippets. */
   prefix?: string;
   /** The code language of the snippet */

package/dist/components/content/CopySnippet/CopySnippet.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.163.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.164.0 | Cube Dev Team */
 import { _Tooltip } from "../../overlays/Tooltip/Tooltip.js";
 import { TooltipTrigger } from "../../overlays/Tooltip/TooltipTrigger.js";
 import { useI18n } from "../../../i18n/useI18n.js";
@@ -132,7 +132,7 @@ function replaceSymbolsToHidden(str) {
 }
 function CopySnippet(allProps) {
 	const { t } = useI18n();
-	const { code = "", title = t("copySnippet.title", "Code example"), nowrap, prefix = "", language, serif, actions, showTooltip = false, hideText, ...props } = allProps;
+	const { code = "", title = t("copySnippet.title", "Code example"), nowrap, isWrapped, prefix = "", language, serif, actions, showTooltip = false, hideText, ...props } = allProps;
 	const toast = useToast();
 	const [showHidden, setShowHidden] = useState(false);
 	async function onCopy() {
@@ -141,6 +141,7 @@ function CopySnippet(allProps) {
 	}
 	const pristineCode = code.replace(/\n$/, "");
 	const multiline = pristineCode.includes("\n") && !nowrap;
+	const shouldWrap = !!isWrapped && !nowrap;
 	let formattedCode = pristineCode.replace(/\r/g, "").split(/\n/g).map((line) => `${prefix}${line}`).join("\n").trim();
 	if (!showHidden) {
 		if (hideText === true) formattedCode = replaceSymbolsToHidden(formattedCode);
@@ -152,13 +153,14 @@ function CopySnippet(allProps) {
 	const mods = useMemo(() => {
 		return {
 			nowrap,
-			multiline,
+			multiline: multiline || shouldWrap,
 			serif,
 			hidden: !!hideText
 		};
 	}, [
 		nowrap,
 		multiline,
+		shouldWrap,
 		hideText,
 		serif
 	]);
@@ -175,7 +177,8 @@ function CopySnippet(allProps) {
 						overflow: "visible"
 					},
 					code: formattedCode,
-					language: language || "javascript"
+					language: language || "javascript",
+					isWrapped: shouldWrap
 				})
 			}), /* @__PURE__ */ jsxs(ButtonContainer, {
 				mods,