/** * Terminal Context Menu * Right-click menu for terminal with split, copy/paste, and other actions */ import { ClipboardPaste, Copy, Download, RefreshCcw, Sparkles, SplitSquareHorizontal, SplitSquareVertical, Terminal as TerminalIcon, Trash2, Upload, } from 'lucide-react'; import React, { useCallback, useRef, useState } from 'react'; import { useI18n } from '../../application/i18n/I18nProvider'; import { KeyBinding, RightClickBehavior } from '../../domain/models'; import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, } from '../ui/context-menu'; import { isMiddleClickContextMenuEvent } from './runtime/middleClickBehavior'; export interface TerminalContextMenuProps { children: React.ReactNode; hasSelection?: boolean; hotkeyScheme?: 'disabled' | 'mac' | 'pc'; keyBindings?: KeyBinding[]; rightClickBehavior?: RightClickBehavior; isAlternateScreen?: boolean; onCopy?: () => void; onPaste?: () => void; onPasteSelection?: () => void; onSelectAll?: () => void; onClear?: () => void; onSplitHorizontal?: () => void; onSplitVertical?: () => void; onSendYmodem?: () => void; onReceiveYmodem?: () => void; isReconnectable?: boolean; onReconnect?: () => void; onClose?: () => void; onSelectWord?: () => void; onAddSelectionToAI?: () => void; } export const shouldShowReconnectAction = ({ isReconnectable, onReconnect, }: { isReconnectable?: boolean; onReconnect?: () => void; }): boolean => Boolean(isReconnectable && onReconnect); export const shouldSuppressMouseTrackingContextMenu = ({ isAlternateScreen, showReconnectAction, }: { isAlternateScreen?: boolean; showReconnectAction?: boolean; }): boolean => Boolean(isAlternateScreen && !showReconnectAction); export const shouldShowAddSelectionToAIContextMenuAction = ( onAddSelectionToAI?: () => void, ): boolean => Boolean(onAddSelectionToAI); export const shouldRenderTerminalContextMenuContent = ({ isAlternateScreen, showReconnectAction, allowSuppressedMenuContent, }: { isAlternateScreen?: boolean; showReconnectAction?: boolean; allowSuppressedMenuContent?: boolean; }): boolean => allowSuppressedMenuContent || !shouldSuppressMouseTrackingContextMenu({ isAlternateScreen, showReconnectAction }); export const shouldOpenTerminalContextMenu = ({ event, rightClickBehavior = 'context-menu', isAlternateScreen, showReconnectAction, }: { event: { shiftKey?: boolean; nativeEvent: MouseEvent }; rightClickBehavior?: RightClickBehavior; isAlternateScreen?: boolean; showReconnectAction?: boolean; }): boolean => { if (isMiddleClickContextMenuEvent(event.nativeEvent)) { return true; } if (shouldSuppressMouseTrackingContextMenu({ isAlternateScreen, showReconnectAction })) { return false; } return Boolean(event.shiftKey || rightClickBehavior === 'context-menu'); }; export const TerminalContextMenu: React.FC = ({ children, hasSelection = false, hotkeyScheme = 'mac', keyBindings, rightClickBehavior = 'context-menu', isAlternateScreen = false, onCopy, onPaste, onPasteSelection, onSelectAll, onClear, onSplitHorizontal, onSplitVertical, onSendYmodem, onReceiveYmodem, isReconnectable, onReconnect, onClose, onSelectWord, onAddSelectionToAI, }) => { const { t } = useI18n(); const isMac = hotkeyScheme === 'mac'; // Tracks the .workspace-pane whose context menu is currently open so we can // keep its `:focus-within`-driven opacity stable while focus is in the // menu portal (otherwise the pane dims for the menu's lifetime). const markedPaneRef = useRef(null); const [allowSuppressedMenuContent, setAllowSuppressedMenuContent] = useState(false); const handleOpenChange = useCallback((open: boolean) => { if (!open) { markedPaneRef.current?.removeAttribute('data-menu-open'); markedPaneRef.current = null; setAllowSuppressedMenuContent(false); } }, []); // Helper to get shortcut from keyBindings and format for display const getShortcut = (bindingId: string): string => { const binding = keyBindings?.find(b => b.id === bindingId); if (!binding) return ''; const key = isMac ? binding.mac : binding.pc; if (!key || key === 'Disabled') return ''; // Replace " + " with space for cleaner display (e.g., "⌘ + Shift + D" → "⌘ Shift D") return key.replace(/\s*\+\s*/g, ' ').trim(); }; const copyShortcut = getShortcut('copy'); const pasteShortcut = getShortcut('paste'); const pasteSelectionShortcut = getShortcut('paste-selection'); const selectAllShortcut = getShortcut('select-all'); const splitHShortcut = getShortcut('split-horizontal'); const splitVShortcut = getShortcut('split-vertical'); const clearShortcut = getShortcut('clear-buffer'); const showReconnectAction = shouldShowReconnectAction({ isReconnectable, onReconnect }); // Handle right-click: intercept for paste/select-word unless Shift is held // or rightClickBehavior is 'context-menu'. The ContextMenuTrigger stays always // enabled so Shift+Right-Click opens the menu on the first click. const handleRightClick = useCallback( (e: React.MouseEvent) => { // In alternate screen (tmux, vim, etc.), let the terminal application // handle right-click natively to avoid conflicting menus. Reconnect is // still available after disconnect, even if mouse tracking was left on. const shouldOpenMenu = shouldOpenTerminalContextMenu({ event: e, rightClickBehavior, isAlternateScreen, showReconnectAction, }); const isMiddleClickMenu = isMiddleClickContextMenuEvent(e.nativeEvent); if (!shouldOpenMenu && shouldSuppressMouseTrackingContextMenu({ isAlternateScreen, showReconnectAction })) { e.preventDefault(); return; } // Shift+Right-Click or context-menu mode: let Radix open the menu if (shouldOpenMenu) { const pane = (e.target as HTMLElement | null)?.closest('.workspace-pane'); if (pane) { markedPaneRef.current?.removeAttribute('data-menu-open'); pane.setAttribute('data-menu-open', ''); markedPaneRef.current = pane; } setAllowSuppressedMenuContent(isMiddleClickMenu); return; } // Paste / select-word: intercept and prevent the context menu e.preventDefault(); if (rightClickBehavior === 'paste') { onPaste?.(); } else if (rightClickBehavior === 'select-word') { onSelectWord?.(); } }, [rightClickBehavior, onPaste, onSelectWord, isAlternateScreen, showReconnectAction], ); // Always use ContextMenu wrapper to maintain consistent React tree structure // This prevents terminal from unmounting when rightClickBehavior changes return ( {children} {shouldRenderTerminalContextMenuContent({ isAlternateScreen, showReconnectAction, allowSuppressedMenuContent, }) && ( {t('terminal.menu.copy')} {copyShortcut} {t('terminal.menu.paste')} {pasteShortcut} {shouldShowAddSelectionToAIContextMenuAction(onAddSelectionToAI) && ( {t('terminal.menu.addSelectionToAI')} )} {onPasteSelection && ( {t('terminal.menu.pasteSelection')} {pasteSelectionShortcut} )} {t('terminal.menu.selectAll')} {selectAllShortcut} {showReconnectAction && ( <> {t('terminal.menu.reconnect')} )} {(onSendYmodem || onReceiveYmodem) && ( <> {onSendYmodem && ( {t('terminal.menu.sendYmodem')} )} {onReceiveYmodem && ( {t('terminal.menu.receiveYmodem')} )} )} {t('terminal.menu.splitHorizontal')} {splitVShortcut} {t('terminal.menu.splitVertical')} {splitHShortcut} {t('terminal.menu.clearBuffer')} {clearShortcut} {onClose && ( <> {t('terminal.menu.closeTerminal')} )} )} ); }; export default TerminalContextMenu;