@cube-dev/ui-kit 0.113.1 → 0.115.0

package/dist/components/actions/use-action.d.ts

@@ -0,0 +1,75 @@
+
+import { AllBaseProps, TagName } from "../../tasty/types.js";
+import "../../tasty/index.js";
+import { NavigateArg, NavigateLike, NavigateOptions, Path, RelativeRoutingType, To } from "../../providers/navigation.types.js";
+import * as react from "react";
+import { AriaButtonProps } from "react-aria";
+import * as _react_types_shared0 from "@react-types/shared";
+import { FocusableRef } from "@react-types/shared";
+
+//#region src/components/actions/use-action.d.ts
+interface CubeUseActionProps<T extends TagName = 'a' | 'button' | 'span' | 'div'> extends AllBaseProps<T>, Omit<AriaButtonProps, 'type'> {
+  to?: NavigateArg;
+  label?: string;
+  htmlType?: 'button' | 'submit' | 'reset' | undefined;
+  navigationOptions?: NavigateOptions;
+}
+/**
+ * Helper to open link.
+ * @param {String} href
+ * @param {String|Boolean} [target]
+ */
+declare function openLink(href: any, target?: any): void;
+declare function parseTo(to: NavigateArg | undefined): {
+  newTab: boolean;
+  nativeRoute: boolean;
+  cleanTo: To | undefined;
+  isHistoryNavigation: boolean;
+  historyDelta?: number;
+  isHashNavigation: boolean;
+  isExternal: boolean;
+};
+declare function performClickHandler(evt: any, {
+  navigate,
+  resolvedHref,
+  to,
+  onPress,
+  tracking,
+  navigationOptions
+}: {
+  navigate: any;
+  resolvedHref: any;
+  to: any;
+  onPress: any;
+  tracking: any;
+  navigationOptions: any;
+}): void;
+declare const useAction: ({
+  to,
+  as,
+  htmlType,
+  label,
+  mods,
+  onPress,
+  navigationOptions,
+  ...props
+}: CubeUseActionProps, ref: FocusableRef<HTMLElement>) => {
+  actionProps: {
+    ref: _react_types_shared0.RefObject<HTMLElement | null>;
+    type: "button" | "submit" | "reset";
+    rel: string | undefined;
+    as: "a" | "button" | "div" | "span" | react.ComponentType<any>;
+    isDisabled: boolean | undefined;
+    target: string | undefined;
+    href: string | undefined;
+    mods: {
+      hovered: boolean;
+      pressed: any;
+      focused: boolean;
+      disabled: boolean | undefined;
+    };
+  };
+};
+//#endregion
+export { CubeUseActionProps, openLink, parseTo, performClickHandler, useAction };
+//# sourceMappingURL=use-action.d.ts.map

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

@@ -0,0 +1,230 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { filterBaseProps } from "../../tasty/utils/filter-base-props.js";
+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";
+import { UIKitContext } from "../../provider.js";
+import { useTracking } from "../../providers/TrackingProvider.js";
+import { useContext } from "react";
+import { useButton, useHover } from "react-aria";
+import { useFocusableRef } from "@react-spectrum/utils";
+
+//#region src/components/actions/use-action.ts
+const LINK_PRESS_EVENT = "Link Press";
+const BUTTON_PRESS_EVENT = "Button Press";
+const FILTER_OPTIONS = { propNames: new Set(["onMouseEnter", "onMouseLeave"]) };
+/**
+* Helper to open link.
+* @param {String} href
+* @param {String|Boolean} [target]
+*/
+function openLink(href, target) {
+	const link = document.createElement("a");
+	link.href = href;
+	if (target) {
+		link.target = target === true ? "_blank" : target;
+		link.rel = "noopener noreferrer";
+	}
+	document.body.appendChild(link);
+	link.click();
+	document.body.removeChild(link);
+}
+/**
+* Checks if a URL is external (absolute HTTP(S), protocol-relative, or non-http protocols)
+*/
+function isExternalUrl(url) {
+	return url.startsWith("http://") || url.startsWith("https://") || url.startsWith("//") || url.includes(":") && !url.startsWith("#");
+}
+function parseTo(to) {
+	if (typeof to === "number") return {
+		newTab: false,
+		nativeRoute: false,
+		cleanTo: void 0,
+		isHistoryNavigation: true,
+		historyDelta: to,
+		isHashNavigation: false,
+		isExternal: false
+	};
+	if (to && typeof to === "object") return {
+		newTab: false,
+		nativeRoute: false,
+		cleanTo: to,
+		isHistoryNavigation: false,
+		isHashNavigation: false,
+		isExternal: false
+	};
+	if (!to || typeof to !== "string") return {
+		newTab: false,
+		nativeRoute: false,
+		cleanTo: void 0,
+		isHistoryNavigation: false,
+		isHashNavigation: false,
+		isExternal: false
+	};
+	const newTab = to.startsWith("!");
+	const nativeRoute = to.startsWith("@");
+	const isHashNavigation = to.startsWith("#");
+	const cleanTo = newTab || nativeRoute ? to.slice(1) : to;
+	return {
+		newTab,
+		nativeRoute,
+		cleanTo,
+		isHistoryNavigation: false,
+		isHashNavigation,
+		isExternal: typeof cleanTo === "string" && isExternalUrl(cleanTo)
+	};
+}
+function sanitizePressEvent(evt) {
+	const safeEvt = {
+		type: "type" in evt ? evt.type : void 0,
+		pointerType: "pointerType" in evt ? evt.pointerType : void 0,
+		shiftKey: "shiftKey" in evt ? !!evt.shiftKey : false,
+		metaKey: "metaKey" in evt ? !!evt.metaKey : false,
+		ctrlKey: "ctrlKey" in evt ? !!evt.ctrlKey : false,
+		altKey: "altKey" in evt ? !!evt.altKey : false
+	};
+	try {
+		Object.defineProperty(safeEvt, "target", {
+			value: "target" in evt ? evt.target : void 0,
+			enumerable: false,
+			configurable: true
+		});
+	} catch (e) {}
+	return safeEvt;
+}
+function performClickHandler(evt, { navigate, resolvedHref, to, onPress, tracking, navigationOptions }) {
+	const { newTab, nativeRoute, cleanTo, isHistoryNavigation, historyDelta, isHashNavigation, isExternal } = parseTo(to);
+	const element = evt.target;
+	const qa = element?.getAttribute("data-qa");
+	onPress?.(sanitizePressEvent(evt));
+	if (to == null) {
+		tracking.event(BUTTON_PRESS_EVENT, { qa }, element);
+		return;
+	}
+	if (isHistoryNavigation && typeof historyDelta === "number") {
+		tracking.event(LINK_PRESS_EVENT, {
+			qa,
+			delta: historyDelta,
+			type: "router-history"
+		}, element);
+		navigate(historyDelta);
+		return;
+	}
+	if (isHashNavigation && typeof to === "string") {
+		const id = to.slice(1);
+		const targetElement = document.getElementById(id);
+		tracking.event(LINK_PRESS_EVENT, {
+			qa,
+			href: to,
+			type: "hash",
+			target: id
+		}, element);
+		if (targetElement) targetElement.scrollIntoView({
+			behavior: "smooth",
+			block: "start",
+			inline: "nearest"
+		});
+		return;
+	}
+	if (evt.shiftKey || evt.metaKey || evt.ctrlKey || newTab) {
+		openLink(resolvedHref, true);
+		tracking.event(LINK_PRESS_EVENT, {
+			qa,
+			href: resolvedHref,
+			type: "tab"
+		}, element);
+		return;
+	}
+	if (nativeRoute) {
+		if (cleanTo === "" || cleanTo === void 0) {
+			tracking.event(LINK_PRESS_EVENT, {
+				qa,
+				type: "native"
+			}, element);
+			window.location.reload();
+		} else {
+			tracking.event(LINK_PRESS_EVENT, {
+				qa,
+				href: resolvedHref,
+				type: "native"
+			}, element);
+			window.location.assign(resolvedHref);
+		}
+		return;
+	}
+	if (isExternal && typeof cleanTo === "string") {
+		tracking.event(LINK_PRESS_EVENT, {
+			qa,
+			href: cleanTo,
+			type: "native"
+		}, element);
+		window.location.assign(cleanTo);
+		return;
+	}
+	if (cleanTo !== void 0) {
+		tracking.event(LINK_PRESS_EVENT, {
+			qa,
+			href: resolvedHref,
+			type: "router"
+		}, element);
+		navigate(cleanTo, navigationOptions);
+	}
+}
+const useAction = function useAction({ to, as, htmlType, label, mods, onPress, navigationOptions, ...props }, ref) {
+	const tracking = useTracking();
+	const navigation = useContext(UIKitContext).navigation;
+	const isDisabled = props.isDisabled;
+	const { newTab, nativeRoute, cleanTo, isHistoryNavigation, isHashNavigation, isExternal } = parseTo(to);
+	const fallbackTo = to || ".";
+	const navigate = navigation.useNavigate();
+	const resolvedHref = navigation.useHref(fallbackTo);
+	const cleanToHref = navigation.useHref(cleanTo || ".");
+	as = to && !isHistoryNavigation ? "a" : as || "button";
+	const target = newTab ? "_blank" : props.target;
+	let href;
+	if (as === "a" && cleanTo !== void 0) if (newTab || nativeRoute) href = typeof cleanTo === "string" && isExternal ? cleanTo : cleanToHref;
+	else href = resolvedHref;
+	const domRef = useFocusableRef(ref);
+	const mergedNavigationOptions = navigationOptions;
+	const customOnPress = useEvent((evt) => {
+		performClickHandler(evt, {
+			navigate,
+			resolvedHref: href || resolvedHref,
+			to,
+			onPress,
+			tracking,
+			navigationOptions: mergedNavigationOptions
+		});
+	});
+	let { buttonProps, isPressed } = useButton({
+		"aria-label": label,
+		...props,
+		onPress: customOnPress
+	}, domRef);
+	let { hoverProps, isHovered } = useHover({ isDisabled });
+	let { focusProps, isFocused } = useFocus$1({ isDisabled }, true);
+	const customProps = to && !isHistoryNavigation ? { onClick(evt) {
+		evt.preventDefault();
+	} } : {};
+	return { actionProps: {
+		mods: {
+			hovered: isHovered && !isDisabled,
+			pressed: isPressed && !isDisabled,
+			focused: isFocused && !isDisabled,
+			disabled: isDisabled,
+			...mods
+		},
+		...mergeProps$1(buttonProps, hoverProps, focusProps, customProps, filterBaseProps(props, FILTER_OPTIONS)),
+		ref: domRef,
+		type: htmlType || "button",
+		rel: as === "a" && newTab ? "noopener noreferrer" : void 0,
+		as,
+		isDisabled,
+		target,
+		href
+	} };
+};
+
+//#endregion
+export { openLink, parseTo, performClickHandler, useAction };
+//# sourceMappingURL=use-action.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-action.js","names":["useFocus","mergeProps"],"sources":["../../../src/components/actions/use-action.ts"],"sourcesContent":["import { useFocusableRef } from '@react-spectrum/utils';\nimport { FocusableRef, PressEvent } from '@react-types/shared';\nimport { useContext } from 'react';\nimport { AriaButtonProps, useButton, useHover } from 'react-aria';\n\nimport { useEvent } from '../../_internal';\nimport { UIKitContext } from '../../provider';\nimport { useTracking } from '../../providers/TrackingProvider';\nimport { AllBaseProps, filterBaseProps, TagName } from '../../tasty';\nimport { mergeProps } from '../../utils/react';\nimport { useFocus } from '../../utils/react/interactions';\n\n// Import specific types for internal usage\nimport type {\n  NavigateArg,\n  NavigateOptions,\n  Path,\n  To,\n} from '../../providers/navigation.types';\n\nconst LINK_PRESS_EVENT = 'Link Press';\nconst BUTTON_PRESS_EVENT = 'Button Press';\n\n// Re-export types for convenience\nexport type {\n  NavigateLike,\n  Path,\n  To,\n  NavigateArg,\n  NavigateOptions,\n  RelativeRoutingType,\n} from '../../providers/navigation.types';\n\nexport interface CubeUseActionProps<\n  T extends TagName = 'a' | 'button' | 'span' | 'div',\n> extends AllBaseProps<T>,\n    Omit<AriaButtonProps, 'type'> {\n  to?: NavigateArg;\n  label?: string;\n  htmlType?: 'button' | 'submit' | 'reset' | undefined;\n  navigationOptions?: NavigateOptions;\n}\n\nconst FILTER_OPTIONS = { propNames: new Set(['onMouseEnter', 'onMouseLeave']) };\n\n/**\n * Helper to open link.\n * @param {String} href\n * @param {String|Boolean} [target]\n */\nexport function openLink(href, target?) {\n  const link = document.createElement('a');\n\n  link.href = href;\n\n  if (target) {\n    link.target = target === true ? '_blank' : target;\n    // Prevent reverse tabnabbing when opening in a new tab\n    link.rel = 'noopener noreferrer';\n  }\n\n  document.body.appendChild(link);\n\n  link.click();\n\n  document.body.removeChild(link);\n}\n\n/**\n * Checks if a URL is external (absolute HTTP(S), protocol-relative, or non-http protocols)\n */\nfunction isExternalUrl(url: string): boolean {\n  return (\n    url.startsWith('http://') ||\n    url.startsWith('https://') ||\n    url.startsWith('//') ||\n    (url.includes(':') && !url.startsWith('#'))\n  );\n}\n\nexport function parseTo(to: NavigateArg | undefined): {\n  newTab: boolean;\n  nativeRoute: boolean;\n  cleanTo: To | undefined;\n  isHistoryNavigation: boolean;\n  historyDelta?: number;\n  isHashNavigation: boolean;\n  isExternal: boolean;\n} {\n  // Handle number (history navigation)\n  if (typeof to === 'number') {\n    return {\n      newTab: false,\n      nativeRoute: false,\n      cleanTo: undefined,\n      isHistoryNavigation: true,\n      historyDelta: to,\n      isHashNavigation: false,\n      isExternal: false,\n    };\n  }\n\n  // Handle object path\n  if (to && typeof to === 'object') {\n    return {\n      newTab: false,\n      nativeRoute: false,\n      cleanTo: to,\n      isHistoryNavigation: false,\n      isHashNavigation: false,\n      isExternal: false,\n    };\n  }\n\n  // Handle string\n  if (!to || typeof to !== 'string') {\n    return {\n      newTab: false,\n      nativeRoute: false,\n      cleanTo: undefined,\n      isHistoryNavigation: false,\n      isHashNavigation: false,\n      isExternal: false,\n    };\n  }\n\n  const newTab = to.startsWith('!');\n  const nativeRoute = to.startsWith('@');\n  const isHashNavigation = to.startsWith('#');\n  const cleanTo = newTab || nativeRoute ? to.slice(1) : to;\n  const isExternal = typeof cleanTo === 'string' && isExternalUrl(cleanTo);\n\n  return {\n    newTab,\n    nativeRoute,\n    cleanTo,\n    isHistoryNavigation: false,\n    isHashNavigation,\n    isExternal,\n  };\n}\n\ninterface SanitizedPressEvent {\n  type?: string;\n  pointerType?: string;\n  shiftKey: boolean;\n  metaKey: boolean;\n  ctrlKey: boolean;\n  altKey: boolean;\n  // target is defined as a non-enumerable property below\n  [key: string]: unknown; // allow non-enumerable 'target'\n}\n\nfunction sanitizePressEvent(evt: PressEvent): SanitizedPressEvent {\n  const safeEvt: SanitizedPressEvent = {\n    type: 'type' in evt ? evt.type : undefined,\n    pointerType:\n      'pointerType' in evt\n        ? (evt as { pointerType?: string }).pointerType\n        : undefined,\n    shiftKey:\n      'shiftKey' in evt ? !!(evt as { shiftKey?: boolean }).shiftKey : false,\n    metaKey:\n      'metaKey' in evt ? !!(evt as { metaKey?: boolean }).metaKey : false,\n    ctrlKey:\n      'ctrlKey' in evt ? !!(evt as { ctrlKey?: boolean }).ctrlKey : false,\n    altKey: 'altKey' in evt ? !!(evt as { altKey?: boolean }).altKey : false,\n  };\n  try {\n    Object.defineProperty(safeEvt, 'target', {\n      value: 'target' in evt ? (evt as { target?: unknown }).target : undefined,\n      enumerable: false,\n      configurable: true,\n    });\n  } catch (e) {\n    // Failed to define target property - continue without it\n  }\n  return safeEvt;\n}\n\nexport function performClickHandler(\n  evt,\n  { navigate, resolvedHref, to, onPress, tracking, navigationOptions },\n) {\n  const {\n    newTab,\n    nativeRoute,\n    cleanTo,\n    isHistoryNavigation,\n    historyDelta,\n    isHashNavigation,\n    isExternal,\n  } = parseTo(to);\n  const element = evt.target;\n  const qa = element?.getAttribute('data-qa');\n\n  onPress?.(sanitizePressEvent(evt));\n\n  if (to == null) {\n    // Allow 0 as valid navigation (go to current page)\n    tracking.event(BUTTON_PRESS_EVENT, { qa }, element);\n    return;\n  }\n\n  // Handle history navigation (back/forward)\n  if (isHistoryNavigation && typeof historyDelta === 'number') {\n    tracking.event(\n      LINK_PRESS_EVENT,\n      { qa, delta: historyDelta, type: 'router-history' },\n      element,\n    );\n    navigate(historyDelta);\n    return;\n  }\n\n  // Handle hash navigation (smooth scroll)\n  if (isHashNavigation && typeof to === 'string') {\n    const id = to.slice(1);\n    const targetElement = document.getElementById(id);\n\n    tracking.event(\n      LINK_PRESS_EVENT,\n      { qa, href: to, type: 'hash', target: id },\n      element,\n    );\n\n    if (targetElement) {\n      targetElement.scrollIntoView({\n        behavior: 'smooth',\n        block: 'start',\n        inline: 'nearest',\n      });\n    }\n    return;\n  }\n\n  // Handle new tab (via ! prefix or user modifiers)\n  if (evt.shiftKey || evt.metaKey || (evt as any).ctrlKey || newTab) {\n    openLink(resolvedHref, true);\n    tracking.event(\n      LINK_PRESS_EVENT,\n      { qa, href: resolvedHref, type: 'tab' },\n      element,\n    );\n    return;\n  }\n\n  // Handle @ prefix (native navigation)\n  if (nativeRoute) {\n    if (cleanTo === '' || cleanTo === undefined) {\n      // @'' or @ -> reload current page\n      tracking.event(LINK_PRESS_EVENT, { qa, type: 'native' }, element);\n      window.location.reload();\n    } else {\n      // @path -> navigate to resolved path natively\n      tracking.event(\n        LINK_PRESS_EVENT,\n        { qa, href: resolvedHref, type: 'native' },\n        element,\n      );\n      window.location.assign(resolvedHref);\n    }\n    return;\n  }\n\n  // Handle external URLs (always native)\n  if (isExternal && typeof cleanTo === 'string') {\n    tracking.event(\n      LINK_PRESS_EVENT,\n      { qa, href: cleanTo, type: 'native' },\n      element,\n    );\n    window.location.assign(cleanTo);\n    return;\n  }\n\n  // Handle router navigation\n  if (cleanTo !== undefined) {\n    tracking.event(\n      LINK_PRESS_EVENT,\n      { qa, href: resolvedHref, type: 'router' },\n      element,\n    );\n    navigate(cleanTo, navigationOptions);\n  }\n}\n\nexport const useAction = function useAction(\n  {\n    to,\n    as,\n    htmlType,\n    label,\n    mods,\n    onPress,\n    navigationOptions,\n    ...props\n  }: CubeUseActionProps,\n  ref: FocusableRef<HTMLElement>,\n) {\n  const tracking = useTracking();\n  const navigation = useContext(UIKitContext).navigation;\n  const isDisabled = props.isDisabled;\n\n  const {\n    newTab,\n    nativeRoute,\n    cleanTo,\n    isHistoryNavigation,\n    isHashNavigation,\n    isExternal,\n  } = parseTo(to);\n\n  // Always call navigation hooks (using fallback when to is not provided)\n  const fallbackTo = to || '.';\n  const navigate = navigation.useNavigate();\n  const resolvedHref = navigation.useHref(fallbackTo);\n  // Always resolve cleanTo href to avoid conditional hook calls\n  const cleanToHref = navigation.useHref(cleanTo || '.');\n\n  // Determine element type: 'a' for navigation, 'button' for actions\n  as = to && !isHistoryNavigation ? 'a' : as || 'button';\n\n  // Compute target (prefixes override explicit target prop per spec)\n  const target = newTab ? '_blank' : props.target;\n\n  // Compute href for anchor elements\n  let href: string | undefined;\n  if (as === 'a' && cleanTo !== undefined) {\n    if (newTab || nativeRoute) {\n      // For ! and @ prefixes, resolve the clean path\n      href =\n        typeof cleanTo === 'string' && isExternal\n          ? cleanTo // External URLs as-is\n          : cleanToHref;\n    } else {\n      // Regular navigation\n      href = resolvedHref;\n    }\n  }\n\n  const domRef = useFocusableRef(ref);\n\n  // Use navigation options directly\n  const mergedNavigationOptions = navigationOptions;\n\n  const customOnPress = useEvent((evt: PressEvent) => {\n    performClickHandler(evt, {\n      navigate,\n      resolvedHref: href || resolvedHref,\n      to,\n      onPress,\n      tracking,\n      navigationOptions: mergedNavigationOptions,\n    });\n  });\n\n  let { buttonProps, isPressed } = useButton(\n    {\n      'aria-label': label,\n      ...props,\n      onPress: customOnPress,\n    },\n    domRef,\n  );\n  let { hoverProps, isHovered } = useHover({ isDisabled });\n  let { focusProps, isFocused } = useFocus({ isDisabled }, true);\n\n  const customProps =\n    to && !isHistoryNavigation\n      ? {\n          onClick(evt) {\n            evt.preventDefault();\n          },\n        }\n      : {};\n\n  return {\n    actionProps: {\n      mods: {\n        hovered: isHovered && !isDisabled,\n        pressed: isPressed && !isDisabled,\n        focused: isFocused && !isDisabled,\n        disabled: isDisabled,\n        ...mods,\n      },\n      ...(mergeProps(\n        buttonProps,\n        hoverProps,\n        focusProps,\n        customProps,\n        filterBaseProps(props, FILTER_OPTIONS),\n      ) as object),\n      ref: domRef,\n      type: htmlType || 'button',\n      rel: as === 'a' && newTab ? 'noopener noreferrer' : undefined,\n      as,\n      isDisabled,\n      target,\n      href,\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/components/actions/use-anchored-menu.d.ts

@@ -0,0 +1,42 @@
+
+import { _MenuTrigger } from "./Menu/MenuTrigger.js";
+import "./Menu/index.js";
+import { ComponentProps, ComponentType, ReactElement, RefObject } from "react";
+
+//#region src/components/actions/use-anchored-menu.d.ts
+interface UseAnchoredMenuReturn<P, T> {
+  /** Ref to attach to the anchor element for positioning the menu. */
+  anchorRef: RefObject<HTMLElement | null>;
+  /**
+   * Programmatically opens the menu with the provided props.
+   * @param props - Props to pass to the menu component
+   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)
+   */
+  open(props?: P, triggerProps?: T): void;
+  /**
+   * Updates the props of the currently open menu.
+   * Props are merged if defaults are provided.
+   */
+  update(props: P, triggerProps?: T): void;
+  /** Closes the menu programmatically. */
+  close(): void;
+  /** Current open/closed state of the menu. */
+  isOpen: boolean;
+  /**
+   * JSX element that must be rendered in your component tree.
+   * Contains the MenuTrigger and positioning logic.
+   */
+  get rendered(): ReactElement | null;
+}
+/**
+ * Generic hook to manage an anchored menu component.
+ *
+ * @param Component - A React component that represents the menu content (Menu or CommandMenu).
+ * @param defaultTriggerProps - Default props to pass to the MenuTrigger.
+ * @param defaultMenuProps - Default props to pass to the Menu component.
+ * @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.
+ */
+declare function useAnchoredMenu<P, T = ComponentProps<typeof _MenuTrigger>>(Component: ComponentType<P>, defaultTriggerProps?: Omit<ComponentProps<typeof _MenuTrigger>, 'children' | 'isOpen' | 'onOpenChange' | 'targetRef'>, defaultMenuProps?: P): UseAnchoredMenuReturn<P, T>;
+//#endregion
+export { UseAnchoredMenuReturn, useAnchoredMenu };
+//# sourceMappingURL=use-anchored-menu.d.ts.map

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

@@ -0,0 +1,109 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { mergeProps as mergeProps$1 } from "../../utils/react/mergeProps.js";
+import { useEventBus } from "../../utils/react/useEventBus.js";
+import { useEvent } from "../../_internal/hooks/use-event.js";
+import { generateRandomId } from "../../utils/random.js";
+import { _MenuTrigger } from "./Menu/MenuTrigger.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { VisuallyHidden } from "react-aria";
+import { Pressable } from "@react-aria/interactions";
+
+//#region src/components/actions/use-anchored-menu.tsx
+/**
+* Generic hook to manage an anchored menu component.
+*
+* @param Component - A React component that represents the menu content (Menu or CommandMenu).
+* @param defaultTriggerProps - Default props to pass to the MenuTrigger.
+* @param defaultMenuProps - Default props to pass to the Menu component.
+* @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.
+*/
+function useAnchoredMenu(Component, defaultTriggerProps, defaultMenuProps) {
+	const [isOpen, setIsOpen] = useState(false);
+	const [componentProps, setComponentProps] = useState(null);
+	const [triggerProps, setTriggerProps] = useState(null);
+	const anchorRef = useRef(null);
+	const setupRef = useRef(false);
+	useEffect(() => {
+		const el = anchorRef.current;
+		if (el) {
+			el.dataset.popoverTrigger = "";
+			return () => {
+				delete el.dataset.popoverTrigger;
+			};
+		}
+	}, []);
+	const menuId = useMemo(() => generateRandomId(), []);
+	const { emit, on } = useEventBus();
+	useEffect(() => {
+		return on("popover:open", (data) => {
+			if (data.menuId !== menuId && isOpen) setIsOpen(false);
+		});
+	}, [
+		on,
+		menuId,
+		isOpen
+	]);
+	useEffect(() => {
+		if (isOpen) emit("popover:open", { menuId });
+	}, [
+		isOpen,
+		emit,
+		menuId
+	]);
+	function setupCheck() {
+		if (!setupRef.current) throw new Error("useAnchoredMenu: MenuTrigger must be rendered. Use `rendered` property to include it in your component tree.");
+	}
+	const open = useEvent((props = {}, triggerProps) => {
+		setupCheck();
+		setComponentProps(defaultMenuProps ? {
+			...defaultMenuProps,
+			...props
+		} : props);
+		setTriggerProps(triggerProps ?? null);
+		setIsOpen(true);
+	});
+	const update = useEvent((props, triggerProps) => {
+		setupCheck();
+		setComponentProps(defaultMenuProps ? {
+			...defaultMenuProps,
+			...props
+		} : props);
+		setTriggerProps(triggerProps ?? null);
+	});
+	const close = useEvent(() => {
+		setIsOpen(false);
+	});
+	const renderedMenu = useMemo(() => {
+		if (!componentProps) return null;
+		return /* @__PURE__ */ jsxs(_MenuTrigger, {
+			isDummy: true,
+			isOpen,
+			targetRef: anchorRef,
+			placement: "bottom start",
+			onOpenChange: setIsOpen,
+			...mergeProps$1(defaultTriggerProps, triggerProps || void 0),
+			children: [/* @__PURE__ */ jsx(VisuallyHidden, { children: /* @__PURE__ */ jsx(Pressable, { children: /* @__PURE__ */ jsx("button", { "aria-label": "context-menu" }) }) }), /* @__PURE__ */ jsx(Component, { ...componentProps })]
+		});
+	}, [
+		componentProps,
+		triggerProps,
+		isOpen,
+		defaultTriggerProps
+	]);
+	return {
+		anchorRef,
+		open,
+		update,
+		close,
+		isOpen,
+		get rendered() {
+			setupRef.current = true;
+			return renderedMenu;
+		}
+	};
+}
+
+//#endregion
+export { useAnchoredMenu };
+//# sourceMappingURL=use-anchored-menu.js.map

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

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

package/dist/components/actions/use-context-menu.d.ts

@@ -0,0 +1,48 @@
+
+import { _MenuTrigger } from "./Menu/MenuTrigger.js";
+import "./Menu/index.js";
+import { ComponentProps, ComponentType, MouseEvent, PointerEvent, ReactElement, RefObject } from "react";
+
+//#region src/components/actions/use-context-menu.d.ts
+type NativeMouseEvent = globalThis.MouseEvent;
+type NativePointerEvent = globalThis.PointerEvent;
+interface UseContextMenuReturn<E extends HTMLElement = HTMLElement, P extends object = {}, T = ComponentProps<typeof _MenuTrigger>> {
+  /** Container element that receives context menu events. Attach this ref to your target element. */
+  targetRef: RefObject<E | null>;
+  /**
+   * Programmatically opens the menu at the specified coordinates or element center.
+   * Runtime props are merged with defaultMenuProps (runtime props take precedence).
+   *
+   * @param props - Props to pass to the menu component (optional, defaults to defaultMenuProps)
+   * @param triggerProps - Additional props for MenuTrigger (merged with defaultTriggerProps)
+   * @param event - The pointer/mouse event containing coordinates for positioning (optional, centers on element if not provided)
+   */
+  open(props?: P, triggerProps?: T, event?: NativeMouseEvent | NativePointerEvent | MouseEvent | PointerEvent): void;
+  /**
+   * Updates the props of the currently open menu without repositioning.
+   * Props are merged with defaultMenuProps.
+   */
+  update(props: P, triggerProps?: T): void;
+  /** Closes the menu programmatically. */
+  close(): void;
+  /** Current open/closed state of the menu. */
+  isOpen: boolean;
+  /**
+   * JSX element that must be rendered in your component tree.
+   * Contains the MenuTrigger and positioning logic.
+   * IMPORTANT: Must be placed directly inside the target container (the element with targetRef).
+   */
+  get rendered(): ReactElement | null;
+}
+/**
+ * Generic hook to manage a context menu component that opens at pointer coordinates.
+ *
+ * @param Component - A React component that represents the menu content (Menu or CommandMenu).
+ * @param defaultTriggerProps - Default props to pass to the MenuTrigger.
+ * @param defaultMenuProps - Default props to pass to the Menu component.
+ * @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.
+ */
+declare function useContextMenu<E extends HTMLElement = HTMLElement, P extends object = {}, T = ComponentProps<typeof _MenuTrigger>>(Component: ComponentType<P>, defaultTriggerProps?: Omit<ComponentProps<typeof _MenuTrigger>, 'children' | 'isOpen' | 'onOpenChange' | 'targetRef'>, defaultMenuProps?: P): UseContextMenuReturn<E, P, T>;
+//#endregion
+export { UseContextMenuReturn, useContextMenu };
+//# sourceMappingURL=use-context-menu.d.ts.map