Dropdown Menu Glass

1/**
2 * DropdownMenuGlass - Compound Component
3 *
4 * Glass-themed dropdown menu following shadcn/ui compound component pattern.
5 * Built on Radix UI primitives with unified glass styling and full keyboard navigation.
6 *
7 * ## Features
8 * - **Compound Component API** - Root, Trigger, Content, Item, and more sub-components
9 * - **Radix UI Primitives** - Built on @radix-ui/react-dropdown-menu for robust accessibility
10 * - **Glassmorphism Styling** - Backdrop blur, glow effects, CSS variables
11 * - **Theme Support** - Works with all 3 themes (glass, light, aurora)
12 * - **shadcn/ui Compatible** - 100% API compatibility with shadcn/ui DropdownMenu
13 * - **Rich Features** - Checkboxes, radio groups, sub-menus, labels, separators, shortcuts
14 * - **Keyboard Accessible** - Full keyboard navigation (Tab, Arrow keys, Enter, Escape)
15 * - **Variant Support** - Default and destructive item variants
16 *
17 * ## Sub-Components
18 * - `DropdownMenuGlass` - Root context provider
19 * - `DropdownMenuGlassTrigger` - Opens menu when clicked (supports asChild)
20 * - `DropdownMenuGlassContent` - Main menu container with glass styling
21 * - `DropdownMenuGlassItem` - Individual menu item (supports variant prop)
22 * - `DropdownMenuGlassCheckboxItem` - Checkbox menu item with checked state
23 * - `DropdownMenuGlassRadioItem` - Radio button menu item
24 * - `DropdownMenuGlassRadioGroup` - Container for radio items
25 * - `DropdownMenuGlassLabel` - Label for menu sections
26 * - `DropdownMenuGlassSeparator` - Visual divider
27 * - `DropdownMenuGlassGroup` - Groups related items
28 * - `DropdownMenuGlassSub` - Sub-menu context
29 * - `DropdownMenuGlassSubTrigger` - Opens sub-menu
30 * - `DropdownMenuGlassSubContent` - Sub-menu content
31 * - `DropdownMenuGlassShortcut` - Keyboard shortcut display
32 *
33 * ## CSS Variables
34 * Customize styling via theme CSS variables:
35 * - `--dropdown-bg` - Menu background color
36 * - `--dropdown-border` - Menu border color
37 * - `--dropdown-glow` - Menu box shadow
38 * - `--dropdown-item-hover` - Item hover background
39 * - `--dropdown-item-danger` - Destructive item color
40 * - `--dropdown-item-danger-hover` - Destructive item hover background
41 * - `--text-primary`, `--text-secondary`, `--text-muted` - Text colors
42 * - `--blur-md` (16px) - Backdrop blur for menu
43 *
44 * @example Basic usage
45 * ```tsx
46 * import { DropdownMenuGlass, DropdownMenuGlassTrigger, DropdownMenuGlassContent, DropdownMenuGlassItem } from 'shadcn-glass-ui'
47 *
48 * <DropdownMenuGlass>
49 *   <DropdownMenuGlassTrigger asChild>
50// … truncated