Context menu widget for displaying floating menus at cursor position.

Context menu appears at a specific position (usually on right-click) and displays a list of actions. It automatically closes on selection, escape, or clicking outside.

Usage

ContextMenu.new(
  items: [
    ContextMenu.action(:cut, "Cut", shortcut: "Ctrl+X"),
    ContextMenu.action(:copy, "Copy", shortcut: "Ctrl+C"),
    ContextMenu.action(:paste, "Paste", shortcut: "Ctrl+V"),
    ContextMenu.separator(),
    ContextMenu.action(:select_all, "Select All", shortcut: "Ctrl+A")
  ],
  position: {x, y},
  on_select: fn id -> handle_action(id) end,
  on_close: fn -> handle_close() end
)

Features

• Floating overlay at specified position
• Keyboard navigation (Up/Down/Enter/Escape)
• Closes on selection or escape
• Closes on click outside menu bounds
• Z-order above other content

Callback Error Handling

The on_select and on_close callbacks are executed synchronously by the caller. Callback exceptions are rescued and logged by the shared behaviour; they do not crash the widget state machine.

Best Practices:

• Callbacks should not raise exceptions
• Return quickly to avoid blocking the UI
• Dispatch long-running work to separate processes

Example:

on_select: fn id ->
  try do
    handle_menu_action(id)
  rescue
    e -> Logger.error("Menu action failed: #{inspect(e)}")
  end
end