@xsolla/xui-context-menu 0.74.0 → 0.76.0

package/native/index.js.flow

@@ -0,0 +1,578 @@
+/**
+ * Flowtype definitions for index
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+
+import React$1, { Node, RefObject } from "react";
+
+/**
+ * Size variants for the context menu
+ */
+declare type ContextMenuSize = "sm" | "md" | "lg" | "xl";
+/**
+ * Item variant types for data-driven API
+ */
+declare type ContextMenuItemVariant = "default" | "checkbox" | "radio";
+/**
+ * Trailing element types
+ */
+declare type ContextMenuTrailingType =
+  | "none"
+  | "shortcut"
+  | "badge"
+  | "switch"
+  | "arrow";
+/**
+ * Position configuration for context menu
+ */
+declare interface ContextMenuPosition {
+  x: number;
+  y: number;
+}
+/**
+ * Individual menu item data structure for data-driven API
+ */
+declare interface ContextMenuItemData {
+  id: string;
+  label: string;
+  description?: string;
+  icon?: Node;
+  trailing?: {
+    type: ContextMenuTrailingType,
+    content?: Node | string,
+    ...
+  };
+  variant?: ContextMenuItemVariant;
+  checked?: boolean;
+
+  /**
+   * Whether this item is selected (shows trailing checkmark) - for Select/Dropdown usage
+   */
+  selected?: boolean;
+  disabled?: boolean;
+  onPress?: () => void;
+  children?: ContextMenuItemData[];
+  groupId?: string;
+}
+/**
+ * Menu group with optional header
+ */
+declare interface ContextMenuGroupData {
+  id: string;
+  label?: string;
+  description?: string;
+  items: ContextMenuItemData[];
+}
+/**
+ * Main ContextMenu Container Props
+ */
+declare interface ContextMenuProps {
+  /**
+   * Menu items - data-driven API (alternative to children)
+   */
+  list?: ContextMenuItemData[];
+
+  /**
+   * Grouped menu items with optional headers
+   */
+  groups?: ContextMenuGroupData[];
+
+  /**
+   * Render function for custom children (alternative to list/groups)
+   */
+  children?: Node;
+
+  /**
+   * Size of the context menu
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Controlled open state
+   */
+  isOpen?: boolean;
+
+  /**
+   * Callback when open state changes
+   */
+  onOpenChange?: (open: boolean) => void;
+
+  /**
+   * Position for right-click context menu mode
+   */
+  position?: ContextMenuPosition;
+
+  /**
+   * Trigger element (button, etc.) for dropdown mode
+   */
+  trigger?: Node;
+
+  /**
+   * Width of the menu
+   */
+  width?: number | string;
+
+  /**
+   * Maximum height before scrolling
+   */
+  maxHeight?: number;
+
+  /**
+   * Callback when an item is selected
+   */
+  onSelect?: (item: ContextMenuItemData) => void;
+
+  /**
+   * Callback when checkbox/radio values change
+   */
+  onCheckedChange?: (itemId: string, checked: boolean) => void;
+
+  /**
+   * Close menu on item select (default: true for non-checkbox items)
+   */
+  closeOnSelect?: boolean;
+
+  /**
+   * Loading state - shows spinner
+   */
+  isLoading?: boolean;
+
+  /**
+   * ARIA label for the menu
+   */
+  "aria-label"?: string;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuItem Component Props - for default menu items
+ */
+declare interface ContextMenuItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Leading icon
+   */
+  icon?: Node;
+
+  /**
+   * Trailing element
+   */
+  trailing?: Node;
+
+  /**
+   * Keyboard shortcut display text
+   */
+  shortcut?: string;
+
+  /**
+   * Whether this item is selected (cyan background) - for Select/Dropdown usage
+   */
+  selected?: boolean;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Whether item is currently active/focused (for keyboard navigation)
+   */
+  active?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Whether this item has a submenu
+   */
+  hasSubmenu?: boolean;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuCheckboxItem Component Props
+ */
+declare interface ContextMenuCheckboxItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Content placed after checkbox but before label (e.g., Status indicator)
+   */
+  leadingContent?: Node;
+
+  /**
+   * Trailing element
+   */
+  trailing?: Node;
+
+  /**
+   * Checked state
+   */
+  checked?: boolean;
+
+  /**
+   * Indeterminate state - shows minus icon instead of check (for "select all" partially selected)
+   */
+  indeterminate?: boolean;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Checked change handler
+   */
+  onCheckedChange?: (checked: boolean) => void;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuRadioGroup Component Props
+ */
+declare interface ContextMenuRadioGroupProps {
+  /**
+   * Radio items
+   */
+  children: Node;
+
+  /**
+   * Current selected value
+   */
+  value: string;
+
+  /**
+   * Value change handler
+   */
+  onValueChange: (value: string) => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuRadioItem Component Props
+ */
+declare interface ContextMenuRadioItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Value for this radio item
+   */
+  value: string;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuGroup Component Props
+ */
+declare interface ContextMenuGroupProps {
+  /**
+   * Group heading text
+   */
+  label?: string;
+
+  /**
+   * Group description
+   */
+  description?: string;
+
+  /**
+   * Group items
+   */
+  children: Node;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuSeparator Component Props
+ */
+declare interface ContextMenuSeparatorProps {
+  /**
+   * Size for consistent spacing
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuSearch Component Props
+ */
+declare interface ContextMenuSearchProps {
+  /**
+   * Current search value
+   */
+  value?: string;
+
+  /**
+   * Change handler (event-based)
+   */
+  onChange?: (e: React$ChangeEvent<HTMLInputElement>) => void;
+
+  /**
+   * Change handler (value-based)
+   */
+  onValueChange?: (value: string) => void;
+
+  /**
+   * Placeholder text
+   */
+  placeholder?: string;
+
+  /**
+   * Whether to auto-focus the input when mounted
+   */
+  autoFocus?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * Context for passing state to children
+ */
+declare interface ContextMenuContextValue {
+  size: ContextMenuSize;
+  closeMenu: () => void;
+  onItemSelect: (item: ContextMenuItemData) => void;
+  activeIndex: number;
+  setActiveIndex: (index: number) => void;
+  registerItem: (id: string) => number;
+  unregisterItem: (id: string) => void;
+}
+/**
+ * Sizing configuration returned by theme.sizing.contextMenu
+ */
+declare interface ContextMenuSizing {
+  paddingVertical: number;
+  itemPaddingHorizontal: number;
+  itemPaddingVertical: number;
+  fontSize: number;
+  descriptionFontSize: number;
+  iconSize: number;
+  gap: number;
+  minWidth: number;
+}
+declare var ContextMenu: {
+  ...React$1.ForwardRefExoticComponent<{
+    ...ContextMenuProps,
+    ...React$1.RefAttributes<any>,
+  }>,
+  ...{
+    Item: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    CheckboxItem: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuCheckboxItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    RadioGroup: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuRadioGroupProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    RadioItem: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuRadioItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    Group: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuGroupProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    Separator: React$1.FC<ContextMenuSeparatorProps>,
+    Search: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuSearchProps,
+      ...React$1.RefAttributes<HTMLInputElement>,
+    }>,
+    ...
+  },
+};
+declare var ContextMenuItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuCheckboxItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuCheckboxItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare interface RadioGroupContextValue {
+  value: string;
+  onValueChange: (value: string) => void;
+}
+declare var useRadioGroup: () => RadioGroupContextValue | null;
+declare var ContextMenuRadioGroup: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuRadioGroupProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuRadioItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuRadioItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuGroup: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuGroupProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuSeparator: React$1.FC<ContextMenuSeparatorProps>;
+declare var ContextMenuSearch: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuSearchProps,
+  ...React$1.RefAttributes<HTMLInputElement>,
+}>;
+declare var useContextMenu: () => ContextMenuContextValue | void;
+declare var useContextMenuRequired: () => ContextMenuContextValue;
+declare interface UseContextMenuPositionOptions {
+  position?: ContextMenuPosition;
+  menuRef: RefObject<HTMLElement>;
+  isOpen: boolean;
+  offset?: number;
+}
+declare type AdjustedPosition = {
+  transformOrigin: string,
+  ...
+} & ContextMenuPosition;
+
+/**
+ * Hook to calculate smart positioning for context menus
+ * Adjusts position to avoid viewport overflow
+ */
+declare var useContextMenuPosition: (
+  x: UseContextMenuPositionOptions
+) => AdjustedPosition | void;
+declare interface UseKeyboardNavigationOptions {
+  isOpen: boolean;
+  itemCount: number;
+  activeIndex: number;
+  setActiveIndex: (index: number) => void;
+  onSelect: (index: number) => void;
+  onClose: () => void;
+  loop?: boolean;
+}
+/**
+ * Hook to handle keyboard navigation in context menus
+ * Supports arrow keys, home/end, enter/space, and escape
+ */
+declare var useKeyboardNavigation: (x: UseKeyboardNavigationOptions) => {
+  handleKeyDown: (event: React$KeyboardEvent<>) => void,
+  ...
+};
+export type {
+  ContextMenuCheckboxItemProps,
+  ContextMenuContextValue,
+  ContextMenuGroupData,
+  ContextMenuGroupProps,
+  ContextMenuItemData,
+  ContextMenuItemProps,
+  ContextMenuItemVariant,
+  ContextMenuPosition,
+  ContextMenuProps,
+  ContextMenuRadioGroupProps,
+  ContextMenuRadioItemProps,
+  ContextMenuSearchProps,
+  ContextMenuSeparatorProps,
+  ContextMenuSize,
+  ContextMenuSizing,
+  ContextMenuTrailingType,
+};
+declare export {
+  ContextMenu,
+  ContextMenuCheckboxItem,
+  ContextMenuGroup,
+  ContextMenuItem,
+  ContextMenuRadioGroup,
+  ContextMenuRadioItem,
+  ContextMenuSearch,
+  ContextMenuSeparator,
+  useContextMenu,
+  useContextMenuPosition,
+  useContextMenuRequired,
+  useKeyboardNavigation,
+  useRadioGroup,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xsolla/xui-context-menu",
-  "version": "0.74.0",
+  "version": "0.76.0",
   "main": "./web/index.js",
   "module": "./web/index.mjs",
   "types": "./web/index.d.ts",
@@ -13,13 +13,13 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@xsolla/xui-checkbox": "0.74.0",
-    "@xsolla/xui-core": "0.74.0",
-    "@xsolla/xui-divider": "0.74.0",
-    "@xsolla/xui-icons": "0.74.0",
-    "@xsolla/xui-primitives-core": "0.74.0",
-    "@xsolla/xui-radio": "0.74.0",
-    "@xsolla/xui-spinner": "0.74.0"
+    "@xsolla/xui-checkbox": "0.76.0",
+    "@xsolla/xui-core": "0.76.0",
+    "@xsolla/xui-divider": "0.76.0",
+    "@xsolla/xui-icons": "0.76.0",
+    "@xsolla/xui-primitives-core": "0.76.0",
+    "@xsolla/xui-radio": "0.76.0",
+    "@xsolla/xui-spinner": "0.76.0"
   },
   "peerDependencies": {
     "react": ">=16.8.0",

package/web/index.js.flow

@@ -0,0 +1,578 @@
+/**
+ * Flowtype definitions for index
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+
+import React$1, { Node, RefObject } from "react";
+
+/**
+ * Size variants for the context menu
+ */
+declare type ContextMenuSize = "sm" | "md" | "lg" | "xl";
+/**
+ * Item variant types for data-driven API
+ */
+declare type ContextMenuItemVariant = "default" | "checkbox" | "radio";
+/**
+ * Trailing element types
+ */
+declare type ContextMenuTrailingType =
+  | "none"
+  | "shortcut"
+  | "badge"
+  | "switch"
+  | "arrow";
+/**
+ * Position configuration for context menu
+ */
+declare interface ContextMenuPosition {
+  x: number;
+  y: number;
+}
+/**
+ * Individual menu item data structure for data-driven API
+ */
+declare interface ContextMenuItemData {
+  id: string;
+  label: string;
+  description?: string;
+  icon?: Node;
+  trailing?: {
+    type: ContextMenuTrailingType,
+    content?: Node | string,
+    ...
+  };
+  variant?: ContextMenuItemVariant;
+  checked?: boolean;
+
+  /**
+   * Whether this item is selected (shows trailing checkmark) - for Select/Dropdown usage
+   */
+  selected?: boolean;
+  disabled?: boolean;
+  onPress?: () => void;
+  children?: ContextMenuItemData[];
+  groupId?: string;
+}
+/**
+ * Menu group with optional header
+ */
+declare interface ContextMenuGroupData {
+  id: string;
+  label?: string;
+  description?: string;
+  items: ContextMenuItemData[];
+}
+/**
+ * Main ContextMenu Container Props
+ */
+declare interface ContextMenuProps {
+  /**
+   * Menu items - data-driven API (alternative to children)
+   */
+  list?: ContextMenuItemData[];
+
+  /**
+   * Grouped menu items with optional headers
+   */
+  groups?: ContextMenuGroupData[];
+
+  /**
+   * Render function for custom children (alternative to list/groups)
+   */
+  children?: Node;
+
+  /**
+   * Size of the context menu
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Controlled open state
+   */
+  isOpen?: boolean;
+
+  /**
+   * Callback when open state changes
+   */
+  onOpenChange?: (open: boolean) => void;
+
+  /**
+   * Position for right-click context menu mode
+   */
+  position?: ContextMenuPosition;
+
+  /**
+   * Trigger element (button, etc.) for dropdown mode
+   */
+  trigger?: Node;
+
+  /**
+   * Width of the menu
+   */
+  width?: number | string;
+
+  /**
+   * Maximum height before scrolling
+   */
+  maxHeight?: number;
+
+  /**
+   * Callback when an item is selected
+   */
+  onSelect?: (item: ContextMenuItemData) => void;
+
+  /**
+   * Callback when checkbox/radio values change
+   */
+  onCheckedChange?: (itemId: string, checked: boolean) => void;
+
+  /**
+   * Close menu on item select (default: true for non-checkbox items)
+   */
+  closeOnSelect?: boolean;
+
+  /**
+   * Loading state - shows spinner
+   */
+  isLoading?: boolean;
+
+  /**
+   * ARIA label for the menu
+   */
+  "aria-label"?: string;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuItem Component Props - for default menu items
+ */
+declare interface ContextMenuItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Leading icon
+   */
+  icon?: Node;
+
+  /**
+   * Trailing element
+   */
+  trailing?: Node;
+
+  /**
+   * Keyboard shortcut display text
+   */
+  shortcut?: string;
+
+  /**
+   * Whether this item is selected (cyan background) - for Select/Dropdown usage
+   */
+  selected?: boolean;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Whether item is currently active/focused (for keyboard navigation)
+   */
+  active?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Whether this item has a submenu
+   */
+  hasSubmenu?: boolean;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuCheckboxItem Component Props
+ */
+declare interface ContextMenuCheckboxItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Content placed after checkbox but before label (e.g., Status indicator)
+   */
+  leadingContent?: Node;
+
+  /**
+   * Trailing element
+   */
+  trailing?: Node;
+
+  /**
+   * Checked state
+   */
+  checked?: boolean;
+
+  /**
+   * Indeterminate state - shows minus icon instead of check (for "select all" partially selected)
+   */
+  indeterminate?: boolean;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Checked change handler
+   */
+  onCheckedChange?: (checked: boolean) => void;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuRadioGroup Component Props
+ */
+declare interface ContextMenuRadioGroupProps {
+  /**
+   * Radio items
+   */
+  children: Node;
+
+  /**
+   * Current selected value
+   */
+  value: string;
+
+  /**
+   * Value change handler
+   */
+  onValueChange: (value: string) => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuRadioItem Component Props
+ */
+declare interface ContextMenuRadioItemProps {
+  /**
+   * Item label text
+   */
+  children: Node;
+
+  /**
+   * Description text below label
+   */
+  description?: string;
+
+  /**
+   * Value for this radio item
+   */
+  value: string;
+
+  /**
+   * Whether item is disabled
+   */
+  disabled?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Press handler
+   */
+  onPress?: () => void;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuGroup Component Props
+ */
+declare interface ContextMenuGroupProps {
+  /**
+   * Group heading text
+   */
+  label?: string;
+
+  /**
+   * Group description
+   */
+  description?: string;
+
+  /**
+   * Group items
+   */
+  children: Node;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuSeparator Component Props
+ */
+declare interface ContextMenuSeparatorProps {
+  /**
+   * Size for consistent spacing
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * ContextMenuSearch Component Props
+ */
+declare interface ContextMenuSearchProps {
+  /**
+   * Current search value
+   */
+  value?: string;
+
+  /**
+   * Change handler (event-based)
+   */
+  onChange?: (e: React$ChangeEvent<HTMLInputElement>) => void;
+
+  /**
+   * Change handler (value-based)
+   */
+  onValueChange?: (value: string) => void;
+
+  /**
+   * Placeholder text
+   */
+  placeholder?: string;
+
+  /**
+   * Whether to auto-focus the input when mounted
+   */
+  autoFocus?: boolean;
+
+  /**
+   * Size inherited from parent
+   */
+  size?: ContextMenuSize;
+
+  /**
+   * Test ID
+   */
+  "data-testid"?: string;
+}
+/**
+ * Context for passing state to children
+ */
+declare interface ContextMenuContextValue {
+  size: ContextMenuSize;
+  closeMenu: () => void;
+  onItemSelect: (item: ContextMenuItemData) => void;
+  activeIndex: number;
+  setActiveIndex: (index: number) => void;
+  registerItem: (id: string) => number;
+  unregisterItem: (id: string) => void;
+}
+/**
+ * Sizing configuration returned by theme.sizing.contextMenu
+ */
+declare interface ContextMenuSizing {
+  paddingVertical: number;
+  itemPaddingHorizontal: number;
+  itemPaddingVertical: number;
+  fontSize: number;
+  descriptionFontSize: number;
+  iconSize: number;
+  gap: number;
+  minWidth: number;
+}
+declare var ContextMenu: {
+  ...React$1.ForwardRefExoticComponent<{
+    ...ContextMenuProps,
+    ...React$1.RefAttributes<any>,
+  }>,
+  ...{
+    Item: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    CheckboxItem: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuCheckboxItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    RadioGroup: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuRadioGroupProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    RadioItem: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuRadioItemProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    Group: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuGroupProps,
+      ...React$1.RefAttributes<any>,
+    }>,
+    Separator: React$1.FC<ContextMenuSeparatorProps>,
+    Search: React$1.ForwardRefExoticComponent<{
+      ...ContextMenuSearchProps,
+      ...React$1.RefAttributes<HTMLInputElement>,
+    }>,
+    ...
+  },
+};
+declare var ContextMenuItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuCheckboxItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuCheckboxItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare interface RadioGroupContextValue {
+  value: string;
+  onValueChange: (value: string) => void;
+}
+declare var useRadioGroup: () => RadioGroupContextValue | null;
+declare var ContextMenuRadioGroup: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuRadioGroupProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuRadioItem: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuRadioItemProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuGroup: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuGroupProps,
+  ...React$1.RefAttributes<any>,
+}>;
+declare var ContextMenuSeparator: React$1.FC<ContextMenuSeparatorProps>;
+declare var ContextMenuSearch: React$1.ForwardRefExoticComponent<{
+  ...ContextMenuSearchProps,
+  ...React$1.RefAttributes<HTMLInputElement>,
+}>;
+declare var useContextMenu: () => ContextMenuContextValue | void;
+declare var useContextMenuRequired: () => ContextMenuContextValue;
+declare interface UseContextMenuPositionOptions {
+  position?: ContextMenuPosition;
+  menuRef: RefObject<HTMLElement>;
+  isOpen: boolean;
+  offset?: number;
+}
+declare type AdjustedPosition = {
+  transformOrigin: string,
+  ...
+} & ContextMenuPosition;
+
+/**
+ * Hook to calculate smart positioning for context menus
+ * Adjusts position to avoid viewport overflow
+ */
+declare var useContextMenuPosition: (
+  x: UseContextMenuPositionOptions
+) => AdjustedPosition | void;
+declare interface UseKeyboardNavigationOptions {
+  isOpen: boolean;
+  itemCount: number;
+  activeIndex: number;
+  setActiveIndex: (index: number) => void;
+  onSelect: (index: number) => void;
+  onClose: () => void;
+  loop?: boolean;
+}
+/**
+ * Hook to handle keyboard navigation in context menus
+ * Supports arrow keys, home/end, enter/space, and escape
+ */
+declare var useKeyboardNavigation: (x: UseKeyboardNavigationOptions) => {
+  handleKeyDown: (event: React$KeyboardEvent<>) => void,
+  ...
+};
+export type {
+  ContextMenuCheckboxItemProps,
+  ContextMenuContextValue,
+  ContextMenuGroupData,
+  ContextMenuGroupProps,
+  ContextMenuItemData,
+  ContextMenuItemProps,
+  ContextMenuItemVariant,
+  ContextMenuPosition,
+  ContextMenuProps,
+  ContextMenuRadioGroupProps,
+  ContextMenuRadioItemProps,
+  ContextMenuSearchProps,
+  ContextMenuSeparatorProps,
+  ContextMenuSize,
+  ContextMenuSizing,
+  ContextMenuTrailingType,
+};
+declare export {
+  ContextMenu,
+  ContextMenuCheckboxItem,
+  ContextMenuGroup,
+  ContextMenuItem,
+  ContextMenuRadioGroup,
+  ContextMenuRadioItem,
+  ContextMenuSearch,
+  ContextMenuSeparator,
+  useContextMenu,
+  useContextMenuPosition,
+  useContextMenuRequired,
+  useKeyboardNavigation,
+  useRadioGroup,
+};