@neynar/ui 0.1.1 → 0.1.3

package/dist/components/ui/context-menu.d.ts

@@ -45,6 +45,30 @@ import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
  * </ContextMenu>
  * ```
  *
+ * @example
+ * ```tsx
+ * // With checkboxes and radio groups
+ * <ContextMenu>
+ *   <ContextMenuTrigger>Settings Menu</ContextMenuTrigger>
+ *   <ContextMenuContent>
+ *     <ContextMenuLabel>Preferences</ContextMenuLabel>
+ *     <ContextMenuSeparator />
+ *     <ContextMenuCheckboxItem checked={showToolbar} onCheckedChange={setShowToolbar}>
+ *       Show Toolbar
+ *     </ContextMenuCheckboxItem>
+ *     <ContextMenuCheckboxItem checked={showSidebar} onCheckedChange={setShowSidebar}>
+ *       Show Sidebar
+ *     </ContextMenuCheckboxItem>
+ *     <ContextMenuSeparator />
+ *     <ContextMenuRadioGroup value={theme} onValueChange={setTheme}>
+ *       <ContextMenuRadioItem value="light">Light Theme</ContextMenuRadioItem>
+ *       <ContextMenuRadioItem value="dark">Dark Theme</ContextMenuRadioItem>
+ *       <ContextMenuRadioItem value="system">System Theme</ContextMenuRadioItem>
+ *     </ContextMenuRadioGroup>
+ *   </ContextMenuContent>
+ * </ContextMenu>
+ * ```
+ *
  * @accessibility
  * - Triggered by right-click, long-press, or Shift+F10
  * - Full keyboard navigation with arrow keys
@@ -53,17 +77,23 @@ import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
  * - Tab moves focus outside the menu
  * - Proper ARIA roles and focus management
  * - Screen reader announcements for menu state changes
+ * - Supports typeahead navigation by first letter
+ * - Focus returns to trigger element when closed
  *
+ * @see {@link ContextMenuTrigger} Trigger element component
+ * @see {@link ContextMenuContent} Menu content container
+ * @see {@link ContextMenuItem} Individual menu items
  * @see {@link https://ui.shadcn.com/docs/components/context-menu} shadcn/ui docs
- * @since 1.0.0
  * @see {@link https://www.radix-ui.com/primitives/docs/components/context-menu} Radix UI docs
+ * @since 1.0.0
  */
-declare function ContextMenu({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenu(props: React.ComponentProps<typeof ContextMenuPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuTrigger - The element that triggers the context menu
  *
  * Wraps any element to make it respond to right-click or long-press events.
  * The trigger element should provide visual feedback about its interactive nature.
+ * Uses the `asChild` pattern to merge props with child elements for composition.
  *
  * @example
  * ```tsx
@@ -72,14 +102,27 @@ declare function ContextMenu({ ...props }: React.ComponentProps<typeof ContextMe
  * </ContextMenuTrigger>
  * ```
  *
- * @param children - Any React element that should trigger the context menu
+ * @example
+ * ```tsx
+ * // With asChild for direct prop merging
+ * <ContextMenuTrigger asChild>
+ *   <div className="p-4 border rounded cursor-pointer">
+ *     Right-click target area
+ *   </div>
+ * </ContextMenuTrigger>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param disabled - Prevents context menu from opening when trigger is activated
+ * @param children - The element that should respond to right-click events
  */
-declare function ContextMenuTrigger({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenuTrigger(props: React.ComponentProps<typeof ContextMenuPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuGroup - Logical grouping for menu items
  *
  * Groups related menu items together for better organization and accessibility.
- * Provides semantic structure without visual changes.
+ * Provides semantic structure without visual changes but improves screen reader
+ * navigation by grouping related actions.
  *
  * @example
  * ```tsx
@@ -89,13 +132,33 @@ declare function ContextMenuTrigger({ ...props }: React.ComponentProps<typeof Co
  *   <ContextMenuItem>Paste</ContextMenuItem>
  * </ContextMenuGroup>
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Multiple groups with separators
+ * <ContextMenuContent>
+ *   <ContextMenuGroup>
+ *     <ContextMenuItem>Undo</ContextMenuItem>
+ *     <ContextMenuItem>Redo</ContextMenuItem>
+ *   </ContextMenuGroup>
+ *   <ContextMenuSeparator />
+ *   <ContextMenuGroup>
+ *     <ContextMenuItem>Copy</ContextMenuItem>
+ *     <ContextMenuItem>Paste</ContextMenuItem>
+ *   </ContextMenuGroup>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param children - The menu items to group together logically
  */
-declare function ContextMenuGroup({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Group>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenuGroup(props: React.ComponentProps<typeof ContextMenuPrimitive.Group>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuPortal - Portal container for menu content
  *
  * Renders menu content in a portal to ensure proper layering and positioning.
- * Typically used with sub-menus to control rendering context.
+ * Useful for controlling where menu content is rendered in the DOM tree,
+ * especially important for sub-menus and complex layouts.
  *
  * @example
  * ```tsx
@@ -106,14 +169,26 @@ declare function ContextMenuGroup({ ...props }: React.ComponentProps<typeof Cont
  * </ContextMenuPortal>
  * ```
  *
- * @param container - Custom container element for the portal
+ * @example
+ * ```tsx
+ * // Portal into specific container
+ * <ContextMenuPortal container={document.getElementById('menu-container')}>
+ *   <ContextMenuContent>
+ *     <ContextMenuItem>Custom Portal Item</ContextMenuItem>
+ *   </ContextMenuContent>
+ * </ContextMenuPortal>
+ * ```
+ *
+ * @param container - Custom container element to portal content into
+ * @param children - The menu content to render in the portal
  */
-declare function ContextMenuPortal({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Portal>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenuPortal(props: React.ComponentProps<typeof ContextMenuPrimitive.Portal>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuSub - Container for sub-menu functionality
  *
  * Wraps a sub-menu trigger and its content to create nested menu structures.
- * Enables hierarchical organization of menu items.
+ * Enables hierarchical organization of menu items with proper state management
+ * for opening and closing sub-menus.
  *
  * @example
  * ```tsx
@@ -125,16 +200,38 @@ declare function ContextMenuPortal({ ...props }: React.ComponentProps<typeof Con
  *   </ContextMenuSubContent>
  * </ContextMenuSub>
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Controlled sub-menu
+ * const [subOpen, setSubOpen] = useState(false)
+ *
+ * <ContextMenuSub open={subOpen} onOpenChange={setSubOpen}>
+ *   <ContextMenuSubTrigger>More Actions</ContextMenuSubTrigger>
+ *   <ContextMenuSubContent>
+ *     <ContextMenuItem onClick={() => setSubOpen(false)}>
+ *       Archive
+ *     </ContextMenuItem>
+ *   </ContextMenuSubContent>
+ * </ContextMenuSub>
+ * ```
+ *
+ * @param open - Controlled open state of the sub-menu
+ * @param onOpenChange - Callback fired when sub-menu open state changes
+ * @param children - Sub-menu trigger and content components
  */
-declare function ContextMenuSub({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Sub>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenuSub(props: React.ComponentProps<typeof ContextMenuPrimitive.Sub>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuRadioGroup - Container for radio button items
  *
  * Groups radio items together to allow single selection from multiple options.
- * Manages the selected state and ensures only one item can be selected.
+ * Manages the selected state and ensures only one item can be selected at a time.
+ * Provides controlled state management for radio selections within menus.
  *
  * @example
  * ```tsx
+ * const [theme, setTheme] = useState("light")
+ *
  * <ContextMenuRadioGroup value={theme} onValueChange={setTheme}>
  *   <ContextMenuRadioItem value="light">Light</ContextMenuRadioItem>
  *   <ContextMenuRadioItem value="dark">Dark</ContextMenuRadioItem>
@@ -142,15 +239,31 @@ declare function ContextMenuSub({ ...props }: React.ComponentProps<typeof Contex
  * </ContextMenuRadioGroup>
  * ```
  *
- * @param value - The currently selected value
- * @param onValueChange - Callback fired when selection changes
+ * @example
+ * ```tsx
+ * // With label and separator
+ * <ContextMenuContent>
+ *   <ContextMenuLabel>Theme Selection</ContextMenuLabel>
+ *   <ContextMenuSeparator />
+ *   <ContextMenuRadioGroup value={currentTheme} onValueChange={handleThemeChange}>
+ *     <ContextMenuRadioItem value="light">Light Mode</ContextMenuRadioItem>
+ *     <ContextMenuRadioItem value="dark">Dark Mode</ContextMenuRadioItem>
+ *     <ContextMenuRadioItem value="auto">Auto</ContextMenuRadioItem>
+ *   </ContextMenuRadioGroup>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param value - The currently selected value that matches a RadioItem's value
+ * @param onValueChange - Callback fired when selection changes, receives new value
+ * @param children - ContextMenuRadioItem components to group together
  */
-declare function ContextMenuRadioGroup({ ...props }: React.ComponentProps<typeof ContextMenuPrimitive.RadioGroup>): import("react/jsx-runtime").JSX.Element;
+declare function ContextMenuRadioGroup(props: React.ComponentProps<typeof ContextMenuPrimitive.RadioGroup>): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuSubTrigger - Trigger element for opening sub-menus
  *
  * Menu item that opens a sub-menu on hover or focus. Automatically includes
- * a chevron icon to indicate the presence of a sub-menu.
+ * a chevron icon to indicate the presence of a sub-menu. Supports the same
+ * interaction patterns as regular menu items with additional sub-menu behavior.
  *
  * @example
  * ```tsx
@@ -160,18 +273,32 @@ declare function ContextMenuRadioGroup({ ...props }: React.ComponentProps<typeof
  * </ContextMenuSubTrigger>
  * ```
  *
- * @param inset - Whether to indent the trigger for proper alignment
+ * @example
+ * ```tsx
+ * // With inset alignment for icon consistency
+ * <ContextMenuContent>
+ *   <ContextMenuItem inset>Regular Item</ContextMenuItem>
+ *   <ContextMenuSubTrigger inset>
+ *     More Actions
+ *   </ContextMenuSubTrigger>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param disabled - Prevents interaction and sub-menu opening
+ * @param textValue - Custom text for typeahead navigation
+ * @param inset - Whether to indent the trigger for proper visual alignment
  * @param children - Content of the trigger (text, icons, etc.)
  */
 declare function ContextMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.SubTrigger> & {
-    /** Whether to indent the trigger for proper alignment */
     inset?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuSubContent - Container for sub-menu items
  *
  * Contains the items within a sub-menu. Automatically positioned relative
- * to its trigger with collision detection and smooth animations.
+ * to its trigger with collision detection and smooth animations. Supports
+ * all the same features as main menu content including keyboard navigation.
  *
  * @example
  * ```tsx
@@ -183,6 +310,26 @@ declare function ContextMenuSubTrigger({ className, inset, children, ...props }:
  * </ContextMenuSubContent>
  * ```
  *
+ * @example
+ * ```tsx
+ * // With portal and collision avoidance
+ * <ContextMenuSubContent
+ *   avoidCollisions={true}
+ *   sideOffset={8}
+ *   className="min-w-[200px]"
+ * >
+ *   <ContextMenuLabel>Sub Options</ContextMenuLabel>
+ *   <ContextMenuItem>Action A</ContextMenuItem>
+ *   <ContextMenuItem>Action B</ContextMenuItem>
+ * </ContextMenuSubContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param loop - Enable keyboard navigation looping from last to first item
+ * @param onCloseAutoFocus - Handle focus return when sub-menu closes
+ * @param onEscapeKeyDown - Handle escape key presses
+ * @param avoidCollisions - Prevent collisions with viewport boundaries
+ * @param sideOffset - Distance in pixels from the trigger anchor
  * @param className - Additional CSS classes for styling
  * @param children - Sub-menu items, separators, and labels
  */
@@ -191,7 +338,8 @@ declare function ContextMenuSubContent({ className, ...props }: React.ComponentP
  * ContextMenuContent - The container for context menu items
  *
  * Contains all menu items, separators, labels, and sub-menus. Automatically
- * positioned relative to the trigger point with collision detection.
+ * positioned relative to the trigger point with collision detection and smooth
+ * animations. Renders in a portal by default for proper layering.
  *
  * @example
  * ```tsx
@@ -203,8 +351,29 @@ declare function ContextMenuSubContent({ className, ...props }: React.ComponentP
  * </ContextMenuContent>
  * ```
  *
+ * @example
+ * ```tsx
+ * // With event handlers and positioning
+ * <ContextMenuContent
+ *   onCloseAutoFocus={(e) => e.preventDefault()}
+ *   onEscapeKeyDown={(e) => console.log('Escape pressed')}
+ *   avoidCollisions={true}
+ *   sideOffset={4}
+ *   loop={true}
+ * >
+ *   <ContextMenuItem>Item 1</ContextMenuItem>
+ *   <ContextMenuItem>Item 2</ContextMenuItem>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param loop - Enable keyboard navigation looping from last to first item
+ * @param onCloseAutoFocus - Handle focus return when menu closes
+ * @param onEscapeKeyDown - Handle escape key presses
+ * @param avoidCollisions - Prevent collisions with viewport boundaries
+ * @param sideOffset - Distance in pixels from the cursor/trigger point
  * @param className - Additional CSS classes for styling
- * @param children - Menu items, separators, labels, and sub-menus
+ * @param children - Menu items, labels, separators, and sub-menus to display
  */
 declare function ContextMenuContent({ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
 /**
@@ -212,10 +381,11 @@ declare function ContextMenuContent({ className, ...props }: React.ComponentProp
  *
  * Individual menu items that users can interact with. Supports different
  * variants for visual hierarchy and includes automatic icon styling.
+ * Items can be clicked, selected via keyboard, and support custom styling.
  *
  * @example
  * ```tsx
- * <ContextMenuItem>
+ * <ContextMenuItem onSelect={() => console.log('Edit selected')}>
  *   <Edit className="mr-2 h-4 w-4" />
  *   Edit
  *   <ContextMenuShortcut>⌘E</ContextMenuShortcut>
@@ -224,28 +394,43 @@ declare function ContextMenuContent({ className, ...props }: React.ComponentProp
  *
  * @example
  * ```tsx
- * <ContextMenuItem variant="destructive">
+ * <ContextMenuItem variant="destructive" onSelect={handleDelete}>
  *   <Trash2 className="mr-2 h-4 w-4" />
  *   Delete
  * </ContextMenuItem>
  * ```
  *
- * @param inset - Whether to indent the item (useful when mixing items with/without icons)
- * @param variant - Visual variant: "default" for normal actions, "destructive" for dangerous actions
- * @param disabled - Whether the item is disabled and non-interactive
- * @param onSelect - Callback fired when the item is selected
+ * @example
+ * ```tsx
+ * // With custom text value for typeahead
+ * <ContextMenuItem
+ *   textValue="Copy to clipboard"
+ *   onSelect={handleCopy}
+ * >
+ *   <Copy className="mr-2 h-4 w-4" />
+ *   Copy <span className="text-muted-foreground">to clipboard</span>
+ * </ContextMenuItem>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param disabled - Prevents interaction and dims the item visually
+ * @param onSelect - Callback fired when item is selected (via mouse or keyboard)
+ * @param textValue - Custom text for typeahead navigation when content is complex
+ * @param inset - Whether to indent the item for alignment with icon-based items
+ * @param variant - Visual variant ("default" for normal actions, "destructive" for dangerous actions)
+ * @param className - Additional CSS classes for custom styling
+ * @param children - Content of the menu item (text, icons, shortcuts, etc.)
  */
 declare function ContextMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Item> & {
-    /** Whether to indent the item for proper alignment */
     inset?: boolean;
-    /** Visual variant for the menu item */
     variant?: "default" | "destructive";
 }): import("react/jsx-runtime").JSX.Element;
 /**
  * ContextMenuCheckboxItem - A menu item with checkbox functionality
  *
  * Menu items that can be toggled on/off, useful for binary settings or options.
- * Displays a check mark when selected and supports controlled state management.
+ * Displays a check mark when selected and supports controlled state management
+ * with indeterminate state for partially selected collections.
  *
  * @example
  * ```tsx
@@ -259,9 +444,35 @@ declare function ContextMenuItem({ className, inset, variant, ...props }: React.
  * </ContextMenuCheckboxItem>
  * ```
  *
- * @param checked - Whether the checkbox is checked
+ * @example
+ * ```tsx
+ * // With indeterminate state
+ * const [selectedItems, setSelectedItems] = useState(['item1'])
+ * const allItems = ['item1', 'item2', 'item3']
+ * const checkedState = selectedItems.length === 0
+ *   ? false
+ *   : selectedItems.length === allItems.length
+ *     ? true
+ *     : "indeterminate"
+ *
+ * <ContextMenuCheckboxItem
+ *   checked={checkedState}
+ *   onCheckedChange={(checked) =>
+ *     setSelectedItems(checked ? allItems : [])
+ *   }
+ * >
+ *   Select All
+ * </ContextMenuCheckboxItem>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param checked - The checked state (true, false, or "indeterminate")
  * @param onCheckedChange - Callback fired when the checked state changes
- * @param disabled - Whether the item is disabled
+ * @param disabled - Whether the item is disabled and non-interactive
+ * @param onSelect - Callback fired when the item is selected (before onCheckedChange)
+ * @param textValue - Custom text for typeahead navigation
+ * @param className - Additional CSS classes for styling
+ * @param children - Content of the checkbox item (typically text)
  */
 declare function ContextMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.CheckboxItem>): import("react/jsx-runtime").JSX.Element;
 /**
@@ -269,18 +480,36 @@ declare function ContextMenuCheckboxItem({ className, children, checked, ...prop
  *
  * Menu items that allow single selection from a group of options.
  * Must be used within a ContextMenuRadioGroup for proper functionality.
+ * Displays a filled circle indicator when selected.
  *
  * @example
  * ```tsx
  * <ContextMenuRadioGroup value={theme} onValueChange={setTheme}>
- *   <ContextMenuRadioItem value="light">Light</ContextMenuRadioItem>
- *   <ContextMenuRadioItem value="dark">Dark</ContextMenuRadioItem>
- *   <ContextMenuRadioItem value="system">System</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="light">Light Theme</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="dark">Dark Theme</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="system">System Theme</ContextMenuRadioItem>
+ * </ContextMenuRadioGroup>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With disabled state and custom text
+ * <ContextMenuRadioGroup value={quality} onValueChange={setQuality}>
+ *   <ContextMenuRadioItem value="low">Low Quality</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="medium">Medium Quality</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="high">High Quality</ContextMenuRadioItem>
+ *   <ContextMenuRadioItem value="ultra" disabled>
+ *     Ultra Quality (Premium)
+ *   </ContextMenuRadioItem>
  * </ContextMenuRadioGroup>
  * ```
  *
- * @param value - The value of this radio item
- * @param disabled - Whether the item is disabled
+ * @param value - The unique value for this radio item (required)
+ * @param disabled - Whether the item is disabled and non-interactive
+ * @param onSelect - Callback fired when the item is selected (before parent's onValueChange)
+ * @param textValue - Custom text for typeahead navigation
+ * @param className - Additional CSS classes for styling
+ * @param children - Content of the radio item (typically text)
  */
 declare function ContextMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.RadioItem>): import("react/jsx-runtime").JSX.Element;
 /**
@@ -288,6 +517,7 @@ declare function ContextMenuRadioItem({ className, children, ...props }: React.C
  *
  * Used to group related menu items and provide context. Labels are not
  * focusable and serve as visual section headers within the menu.
+ * Helps organize menu content and improve accessibility.
  *
  * @example
  * ```tsx
@@ -297,10 +527,22 @@ declare function ContextMenuRadioItem({ className, children, ...props }: React.C
  * <ContextMenuItem>Save</ContextMenuItem>
  * ```
  *
+ * @example
+ * ```tsx
+ * // With inset alignment for consistency
+ * <ContextMenuContent>
+ *   <ContextMenuLabel inset>Edit Options</ContextMenuLabel>
+ *   <ContextMenuItem inset>Copy</ContextMenuItem>
+ *   <ContextMenuItem inset>Paste</ContextMenuItem>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
  * @param inset - Whether to indent the label to align with inset items
+ * @param className - Additional CSS classes for styling
+ * @param children - The text content of the label
  */
 declare function ContextMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Label> & {
-    /** Whether to indent the label for proper alignment */
     inset?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 /**
@@ -308,6 +550,7 @@ declare function ContextMenuLabel({ className, inset, ...props }: React.Componen
  *
  * Creates visual separation between groups of related menu items.
  * Typically used after labels or to separate different types of actions.
+ * Improves visual hierarchy and content organization in menus.
  *
  * @example
  * ```tsx
@@ -316,6 +559,23 @@ declare function ContextMenuLabel({ className, inset, ...props }: React.Componen
  * <ContextMenuSeparator />
  * <ContextMenuItem variant="destructive">Delete</ContextMenuItem>
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Organizing menu sections
+ * <ContextMenuContent>
+ *   <ContextMenuLabel>Edit</ContextMenuLabel>
+ *   <ContextMenuItem>Copy</ContextMenuItem>
+ *   <ContextMenuItem>Paste</ContextMenuItem>
+ *   <ContextMenuSeparator />
+ *   <ContextMenuLabel>View</ContextMenuLabel>
+ *   <ContextMenuItem>Zoom In</ContextMenuItem>
+ *   <ContextMenuItem>Zoom Out</ContextMenuItem>
+ * </ContextMenuContent>
+ * ```
+ *
+ * @param asChild - Merges props with child element instead of rendering wrapper
+ * @param className - Additional CSS classes for styling
  */
 declare function ContextMenuSeparator({ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Separator>): import("react/jsx-runtime").JSX.Element;
 /**
@@ -323,6 +583,7 @@ declare function ContextMenuSeparator({ className, ...props }: React.ComponentPr
  *
  * Shows keyboard shortcuts aligned to the right side of menu items.
  * Provides visual indication of available keyboard shortcuts for actions.
+ * Improves discoverability of keyboard navigation options.
  *
  * @example
  * ```tsx
@@ -332,7 +593,28 @@ declare function ContextMenuSeparator({ className, ...props }: React.ComponentPr
  * </ContextMenuItem>
  * ```
  *
- * @param children - The shortcut text (e.g., "⌘C", "Ctrl+V")
+ * @example
+ * ```tsx
+ * // Multiple shortcuts for different platforms
+ * <ContextMenuItem>
+ *   Save
+ *   <ContextMenuShortcut>
+ *     {isMac ? '⌘S' : 'Ctrl+S'}
+ *   </ContextMenuShortcut>
+ * </ContextMenuItem>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Complex shortcuts
+ * <ContextMenuItem>
+ *   Find and Replace
+ *   <ContextMenuShortcut>⌘⌥F</ContextMenuShortcut>
+ * </ContextMenuItem>
+ * ```
+ *
+ * @param className - Additional CSS classes for styling
+ * @param children - The keyboard shortcut text to display (e.g., "⌘C", "Ctrl+V")
  */
 declare function ContextMenuShortcut({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
 export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };

package/dist/components/ui/context-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../../src/components/ui/context-menu.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../../src/components/ui/context-menu.tsx"],"names":[],"mappings":"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"}