Context Menu

1'use client';
2 
3import * as React from 'react';
4 
5// @interlace/context-menu v1.1.0 — Interlace design system.
6// Docs, props and live preview: https://ds.interlace.tools/c/context-menu
7// What changed since: https://ds.interlace.tools/c/context-menu#history
8// Generated banner — keep it, the upgrade diff reads this version.
9 
10/**
11 * @interlace/ui — ContextMenu
12 *
13 * Right-click / long-press menu. Wraps `@base-ui/react/context-menu`
14 * (same Menu compositional API as DropdownMenu, just with a Root that
15 * handles right-click / long-press / Shift+F10 as the open gesture).
16 *
17 * For the standard click-button-to-open pattern, use `DropdownMenu`.
18 * Use ContextMenu only when consumers expect a true OS-level
19 * right-click affordance (file lists, editor canvases, image grids).
20 *
21 * ## Anatomy
22 *
23 *   ContextMenu                       (Root — Base UI manager)
24 *     ├─ ContextMenuTrigger          (the right-clickable surface)
25 *     └─ ContextMenuContent          (wraps Portal + Positioner + Popup
26 *                                     internally — do NOT nest it in
27 *                                     ContextMenuPortal, that portals twice)
28 *         ├─ ContextMenuGroup → ContextMenuLabel + ContextMenuItem
29 *         ├─ ContextMenuItem
30 *         ├─ ContextMenuSeparator
31 *         ├─ ContextMenuCheckboxItem
32 *         └─ ContextMenuRadioGroup → ContextMenuRadioItem
33 *
34 * `ContextMenuPortal` is exported only for the `container=` override (render
35 * the popup into a specific node instead of `document.body`); it is not part
36 * of the normal tree. `ContextMenuLabel` is `Menu.GroupLabel` and MUST sit
37 * inside a `ContextMenuGroup` — outside one it throws on open.
38 *
39 * ## MIN_VIEWPORT — 320
40 *
41 * Long-press support works at every viewport.
42 *
43 * | Rule | Concept                          | Where in this file                                          |
44 * | ---- | -------------------------------- | ----------------------------------------------------------- |
45 * | R4   | Extends Base UI part props       | Each wrapper extends `React.ComponentProps<typeof BaseContextMenu.X>` |
46 * | R6   | data-slot per part               | `data-slot="context-menu-*"`                                |
47 * | R7   | className merged + ...rest       | `cn(BASE, className)` + `{...props}`                        |
48 * | R13  | Ecosystem first                  | Wraps Base UI's context-menu — no bespoke right-click handling |
49// … truncated