Files
Netcatty/components/terminal/TerminalView.tsx
T
陈大猫andnetcatty-bot d6efb6a313 fix(terminal): keep Enter reconnect working after disconnect (#2550)
* fix(terminal): keep Enter reconnect working after disconnect

Disconnected sessions advertised "Press Enter to reconnect" but often
swallowed the key when focus left xterm (body blur or dialog controls),
and an open terminal search bar globally hid the hint and disabled the
shortcut. Give the disconnected overlay a focus sink + local Enter
handler, and stop treating search-open as a global reconnect gate while
still leaving real buttons/inputs alone.

Closes #2544
Closes #2546

* fix(terminal): stop disconnected dialog focus theft

Only claim Enter-reconnect focus when it is already lost or still inside
this session tree, and restore xterm focus when the overlay unmounts.
Avoid stealing focus from other panes/side panels on disconnect.

* fix(terminal): restore dialog focus only when overlay leaves

Split claim/restore effects so showLogs/error rerenders no longer
yank focus off dialog buttons onto xterm mid-interaction.

* fix(terminal): restore Enter-reconnect focus in popup terminals

Popup Terminal windows lack data-session-id ancestors. Walk up from
the dialog to the local xterm root so claim/restore still work there.

* fix: address Codex review on PR #2550

* fix: address Codex review on PR #2550

* fix: address Codex review on PR #2550

* fix: address Codex review on PR #2550

---------

Co-authored-by: netcatty-bot <308658023+netcatty-bot@users.noreply.github.com>
2026-07-28 00:20:02 +08:00

989 lines
44 KiB
TypeScript

/* eslint-disable @typescript-eslint/no-explicit-any */
import React, { memo, useCallback, useEffect, useRef, useState } from 'react';
import { ChevronsLeft, GripVertical, X as XIcon } from 'lucide-react';
import { shouldKeepTerminalBackgroundWorkActive } from '../../domain/terminalHibernate';
import { resolveEffectiveTerminalProtocol } from '../../domain/terminalProtocol';
import { classifyDistroId } from '../../domain/host';
import { isPluginHostProtocol } from '../../domain/pluginConnection';
import { OSC7_SETUP_TARGETS } from './osc7Setup';
import PasswordCredentialPicker from './PasswordCredentialPicker';
import { TerminalServerStats } from './TerminalServerStats';
import {
TerminalTimestampGutter,
resolveTerminalTimestampGutterColor,
resolveTerminalTimestampGutterWidth,
} from './TerminalTimestampGutter';
import {
Dialog,
DialogContent,
DialogDescription,
DialogFooter,
DialogHeader,
DialogTitle,
} from '../ui/dialog';
type TerminalViewContext = Record<string, any>;
type HostLineTimestampToggle = {
id: string;
showLineTimestamps?: boolean;
};
export function getLineTimestampToggleHostUpdate<T extends HostLineTimestampToggle>(
host: T,
): Pick<T, "id"> & { showLineTimestamps: boolean } {
return {
id: host.id,
showLineTimestamps: host.showLineTimestamps !== true,
};
}
export function shouldShowLineTimestampToolbarToggle(
lineTimestampsAvailable: boolean | undefined,
onUpdateHost: unknown,
): boolean {
return lineTimestampsAvailable !== false && Boolean(onUpdateHost);
}
export function shouldEnableYmodemAction({
isSerialConnection,
status,
handleSendYmodem,
handleReceiveYmodem,
}: {
isSerialConnection?: boolean;
status?: string;
handleSendYmodem?: () => void;
handleReceiveYmodem?: () => void;
}): boolean {
return Boolean(isSerialConnection && status === "connected" && (handleSendYmodem || handleReceiveYmodem));
}
export function shouldShowSelectionAIOverlay({
hasSelection,
selectionOverlayPosition,
onAddSelectionToAI,
showSelectionAIAction,
}: {
hasSelection: boolean;
selectionOverlayPosition?: { left: number; top: number } | null;
onAddSelectionToAI?: unknown;
showSelectionAIAction?: boolean;
}): boolean {
return Boolean(
showSelectionAIAction !== false
&& hasSelection
&& selectionOverlayPosition
&& onAddSelectionToAI,
);
}
export function shouldReconnectTerminalOnEnterKey({
key,
status,
hasRetryHandler,
isComposeBarOpen,
needsAuth,
needsHostKeyVerification,
hasBlockingOverlay,
altKey,
ctrlKey,
metaKey,
shiftKey,
isComposing,
}: {
key: string;
status?: string;
hasRetryHandler: boolean;
isComposeBarOpen: boolean;
needsAuth: boolean;
needsHostKeyVerification: boolean;
hasBlockingOverlay: boolean;
altKey?: boolean;
ctrlKey?: boolean;
metaKey?: boolean;
shiftKey?: boolean;
isComposing?: boolean;
}): boolean {
// Search-bar open state is intentionally not a global gate. While disconnected,
// find-next is less useful than reconnect; the capture handler still refuses
// Enter only when a real interactive control outside xterm owns the event
// (compose/auth/buttons). The terminal search input is allow-listed so an open
// search bar cannot hide the hint or swallow reconnect (#2544 / #2546).
return key === "Enter"
&& status === "disconnected"
&& hasRetryHandler
&& !isComposeBarOpen
&& !needsAuth
&& !needsHostKeyVerification
&& !hasBlockingOverlay
&& !altKey
&& !ctrlKey
&& !metaKey
&& !shiftKey
&& !isComposing;
}
export function shouldBlockTerminalReconnectForTarget({
isWithinXterm,
hasInteractiveAncestor,
isTerminalSearchInput = false,
}: {
isWithinXterm: boolean;
hasInteractiveAncestor: boolean;
/** Open search may keep focus; disconnected Enter reconnect must still win. */
isTerminalSearchInput?: boolean;
}): boolean {
if (isTerminalSearchInput) return false;
return !isWithinXterm && hasInteractiveAncestor;
}
function isTerminalReconnectControlTarget(target: EventTarget | null): boolean {
if (typeof HTMLElement === "undefined" || !(target instanceof HTMLElement)) return false;
return shouldBlockTerminalReconnectForTarget({
isWithinXterm: target.classList.contains("xterm-helper-textarea") || Boolean(target.closest(".xterm")),
hasInteractiveAncestor: Boolean(target.closest("button, a, input, textarea, select, [contenteditable='true'], [role='button'], [role='menuitem'], [role='textbox']")),
isTerminalSearchInput: Boolean(target.closest("[data-terminal-search-input]")),
});
}
type TerminalTitleAddressHost = {
id?: string;
protocol?: string;
username?: string;
hostname?: string;
port?: number;
};
export function formatTerminalTitleConnectionAddress(host?: TerminalTitleAddressHost): string | null {
if (!host || host.protocol === 'local' || isPluginHostProtocol(host.protocol)
|| host.id?.startsWith('local-') || !host.hostname || host.hostname === 'localhost') {
return null;
}
const isSerial = host.protocol === 'serial' || host.id?.startsWith('serial-');
const username = !isSerial && host.username ? `${host.username}@` : '';
const port = !isSerial && host.port ? `:${host.port}` : '';
return `${username}${host.hostname}${port}`;
}
export function resolveTerminalTopOffsets({
showHostInfoBar,
isSearchOpen,
terminalBodyInset = 4,
}: {
showHostInfoBar: boolean;
isSearchOpen: boolean;
terminalBodyInset?: number;
}): { toolbarOffset: number; contentTop: string } {
const toolbarOffset = isSearchOpen ? 64 : showHostInfoBar ? 30 : 0;
return {
toolbarOffset,
contentTop: `${toolbarOffset + terminalBodyInset}px`,
};
}
export function resolveTerminalRightInset({
showHostInfoBar: _showHostInfoBar,
isSearchOpen: _isSearchOpen,
terminalBodyInset = 4,
}: {
showHostInfoBar: boolean;
isSearchOpen: boolean;
terminalBodyInset?: number;
}): number {
// Compact speed-dial floats over the terminal (z-30 overlay). Do not reserve
// a right gutter for it — that pushes the xterm scrollbar left and leaves a
// dead strip next to the circular toggle.
void _showHostInfoBar;
void _isSearchOpen;
return terminalBodyInset;
}
/**
* Shallow-compare every ctx value. <Terminal> rebuilds the ctx object on every
* render, but many re-renders (layout/fit/visibility-of-other-panes, suppress
* toggles) don't actually change any value passed to the view — notably
* `paneLayoutKey`/`isResizing` are consumed by Terminal's hooks and are NOT in
* this ctx. Without this memo, every Terminal re-render re-rendered the whole
* (expensive) TerminalView. This only skips when EVERY value is referentially
* equal, so it can never render stale UI.
*/
function terminalViewCtxEqual(
prev: { ctx: TerminalViewContext },
next: { ctx: TerminalViewContext },
): boolean {
const a = prev.ctx;
const b = next.ctx;
if (a === b) return true;
const aKeys = Object.keys(a);
if (aKeys.length !== Object.keys(b).length) return false;
for (const key of aKeys) {
if (a[key] !== b[key]) return false;
}
return true;
}
function TerminalViewInner({ ctx }: { ctx: TerminalViewContext }) {
const { Activity, Button, Clock3, Copy, Maximize2, Radio, Sparkles, SquareArrowOutUpRight, TerminalAutocomplete, TerminalComposeBar, TerminalConnectionDialog, TerminalContextMenu, TerminalSearchBar, Tooltip, TooltipContent, TooltipTrigger, ZmodemOverwriteDialog, ZmodemProgressIndicator, auth, autocompleteAcceptTextRef, autocompleteCloseRef, autocompleteHostOs, autocompleteInputRef, autocompleteKeyEventRef, autocompleteRepositionRef, autocompleteSettings, chainProgress, cn, compactToolbar, lineTimestampsAvailable, containerRef, effectiveFontSize, effectiveFontWeight, effectiveTerminalProtocol, effectiveTheme, error, executeSnippet, executeSnippetCommand, handleAddSelectionToAI, handleCancelConnect, handleCloseDisconnectedSession, handleCloseSearch, handleDismissDisconnectedDialog, handleDragEnter, handleDragLeave, handleDragOver, handleDrop, handleFindNext, handleFindPrevious, handleHostKeyAddAndContinue, handleHostKeyClose, handleHostKeyContinue, handleOsc52ReadResponse, handleOsc7SetupConfirm, handleOsc7SetupOpenChange, handleReceiveYmodem, handleRetry, handleSearch, handleSendYmodem, handleTopOverlayMouseDownCapture, hasMouseTracking, hasSelection, host, hotkeyScheme, inWorkspace, isBroadcastEnabled, isCancelling, isComposeBarOpen, isConnectionAwaitingUserInput, isDraggingOver, isFocusMode, isFocusedPane, isLocalConnection, remoteDragDropUsesZmodem, isPluginTerminalProviderAvailable, isSerialConnection, isSearchOpen, isSupportedOs, isSystemSidebarEligible, isVisible, keyBindings, keys, knownCwdRef, needsHostKeyVerification, onCloseSession, onDetach, onDetachPointerDown, onExpandToFocus, onOpenSystem, onRename, onSplitHorizontal, onSplitVertical, onToggleBroadcast, onUpdateHost, osc52ReadPromptVisible, osc7SetupOpen, osc7SetupRunning, passwordPromptActiveRef, pendingHostKeyInfo, progressLogs, progressValue, renderControls, resolvedFontFamily, restoreState, scriptExecutionOverlay, searchMatchCount, searchFocusToken, selectionOverlayPosition, sessionDisplayName, sessionId, workspaceId, sessionRef, setIsComposeBarOpen, setShowLogs, shouldShowConnectionDialog, showLogs, showSelectionAIAction, snippets, status, sudoHintRef, sudoHintText, passwordPickerState, onPasswordPickerSelect, passwordPickerTitle, passwordPickerEmptyText, t, termRef, terminalContextActions, terminalCwdTracker, terminalPreviewVars, terminalSettings, timeLeft, toast, zmodem } = ctx;
const isNetworkDevice = host.deviceType === 'network'
|| classifyDistroId(host.distro) === 'network-device';
const ymodemActionEnabled = shouldEnableYmodemAction({
isSerialConnection,
status,
handleSendYmodem,
handleReceiveYmodem,
});
const terminalBodyInset = 4;
const showHostInfoBar = terminalSettings?.showHostInfoBar !== false;
const [compactActionsOpen, setCompactActionsOpen] = useState(false);
const compactActionsRef = useRef<HTMLDivElement | null>(null);
const compactActionsButtonRef = useRef<HTMLButtonElement | null>(null);
useEffect(() => {
if (!compactActionsOpen) return;
const handlePointerDown = (event: PointerEvent) => {
if (compactActionsRef.current?.contains(event.target as Node)) return;
if (
event.target instanceof Element
&& event.target.closest('[data-radix-popper-content-wrapper]')
) return;
setCompactActionsOpen(false);
};
const handleKeyDown = (event: KeyboardEvent) => {
if (event.key !== "Escape") return;
setCompactActionsOpen(false);
compactActionsButtonRef.current?.focus();
};
document.addEventListener("pointerdown", handlePointerDown);
document.addEventListener("keydown", handleKeyDown);
return () => {
document.removeEventListener("pointerdown", handlePointerDown);
document.removeEventListener("keydown", handleKeyDown);
};
}, [compactActionsOpen]);
const { toolbarOffset: terminalToolbarOffset, contentTop: terminalContentTop } = resolveTerminalTopOffsets({
showHostInfoBar,
isSearchOpen,
terminalBodyInset,
});
const terminalRightInset = resolveTerminalRightInset({
showHostInfoBar,
isSearchOpen,
terminalBodyInset,
});
const showLineTimestampGutter = lineTimestampsAvailable !== false && host.showLineTimestamps === true;
const lineTimestampColor = resolveTerminalTimestampGutterColor(effectiveTheme.colors);
const [lineTimestampGutterWidth, setLineTimestampGutterWidth] = useState(() => (
resolveTerminalTimestampGutterWidth({ fontSize: effectiveFontSize })
));
useEffect(() => {
if (showLineTimestampGutter) return;
setLineTimestampGutterWidth(resolveTerminalTimestampGutterWidth({ fontSize: effectiveFontSize }));
}, [effectiveFontSize, effectiveFontWeight, resolvedFontFamily, sessionId, showLineTimestampGutter]);
const handleLineTimestampGutterWidthChange = useCallback((width: number) => {
setLineTimestampGutterWidth((current) => (current === width ? current : width));
}, []);
const activeLineTimestampGutterWidth = showLineTimestampGutter ? lineTimestampGutterWidth : 0;
const lineTimestampToggleLabel = showLineTimestampGutter
? t("terminal.toolbar.timestampsDisable")
: t("terminal.toolbar.timestampsEnable");
const titleConnectionAddress = formatTerminalTitleConnectionAddress(host);
const hasBlockingReconnectOverlay = Boolean(osc52ReadPromptVisible || osc7SetupOpen || scriptExecutionOverlay || zmodem.active || zmodem.overwriteRequest);
const showEnterReconnectHint = shouldReconnectTerminalOnEnterKey({
key: "Enter",
status,
hasRetryHandler: Boolean(handleRetry),
isComposeBarOpen,
needsAuth: Boolean(auth.needsAuth),
needsHostKeyVerification: Boolean(needsHostKeyVerification),
hasBlockingOverlay: hasBlockingReconnectOverlay,
});
const handleTerminalKeyDownCapture = useCallback((event: React.KeyboardEvent<HTMLDivElement>) => {
if (!shouldReconnectTerminalOnEnterKey({
key: event.key,
status,
hasRetryHandler: Boolean(handleRetry),
isComposeBarOpen,
needsAuth: Boolean(auth.needsAuth),
needsHostKeyVerification: Boolean(needsHostKeyVerification),
hasBlockingOverlay: hasBlockingReconnectOverlay,
altKey: event.altKey,
ctrlKey: event.ctrlKey,
metaKey: event.metaKey,
shiftKey: event.shiftKey,
isComposing: event.nativeEvent.isComposing,
})) {
return;
}
if (isTerminalReconnectControlTarget(event.target)) return;
event.preventDefault();
event.stopPropagation();
handleRetry();
}, [
auth.needsAuth,
handleRetry,
hasBlockingReconnectOverlay,
isComposeBarOpen,
needsHostKeyVerification,
status,
]);
return (
<TerminalContextMenu
sessionId={sessionId}
workspaceId={workspaceId}
status={status}
hostId={host?.id}
hostProtocol={host?.protocol ?? 'ssh'}
hasSelection={hasSelection}
hotkeyScheme={hotkeyScheme}
keyBindings={keyBindings}
rightClickBehavior={terminalSettings?.rightClickBehavior}
isAlternateScreen={hasMouseTracking}
onCopy={terminalContextActions.onCopy}
onPaste={terminalContextActions.onPaste}
onUploadClipboardImage={status === "connected" ? terminalContextActions.onUploadClipboardImage : undefined}
onPasteSelection={terminalContextActions.onPasteSelection}
onSelectAll={terminalContextActions.onSelectAll}
onClear={terminalContextActions.onClear}
onSelectWord={terminalContextActions.onSelectWord}
onSplitHorizontal={onSplitHorizontal}
onSplitVertical={onSplitVertical}
onSendYmodem={ymodemActionEnabled ? handleSendYmodem : undefined}
onReceiveYmodem={ymodemActionEnabled ? handleReceiveYmodem : undefined}
isReconnectable={status === "disconnected"}
onReconnect={handleRetry}
onClose={inWorkspace ? () => onCloseSession?.(sessionId) : undefined}
onAddSelectionToAI={ctx.onAddSelectionToAI ? handleAddSelectionToAI : undefined}
onRename={onRename}
onDetach={inWorkspace ? onDetach : undefined}
>
<div
className={cn(
"relative h-full w-full flex min-h-0 overflow-hidden",
isComposeBarOpen && !inWorkspace && "flex-col"
)}
style={{
...terminalPreviewVars,
backgroundColor: 'var(--terminal-ui-bg)',
}}
onDragEnter={handleDragEnter}
onDragOver={handleDragOver}
onDragLeave={handleDragLeave}
onDrop={handleDrop}
onKeyDownCapture={handleTerminalKeyDownCapture}
>
{/* Drag and drop overlay */}
{isDraggingOver && (
<div className="absolute inset-0 z-50 bg-blue-600/20 backdrop-blur-sm border-4 border-dashed border-blue-400 pointer-events-none flex items-center justify-center">
<div className="bg-background/90 backdrop-blur-md rounded-lg shadow-lg p-6 border border-border">
<div className="text-center">
<div className="text-lg font-semibold mb-2">
{isLocalConnection
? t("terminal.dragDrop.localTitle")
: t("terminal.dragDrop.remoteTitle")
}
</div>
<div className="text-sm text-muted-foreground">
{isLocalConnection
? t("terminal.dragDrop.localMessage")
: remoteDragDropUsesZmodem
? t("terminal.dragDrop.remoteZmodemMessage")
: t("terminal.dragDrop.remoteSftpMessage")
}
</div>
</div>
</div>
</div>
)}
<div
ref={compactActionsRef}
className="absolute left-0 right-0 top-0 z-20 pointer-events-none"
onMouseDownCapture={handleTopOverlayMouseDownCapture}
>
{(() => {
const isCompactActionsMode = !showHostInfoBar && !isSearchOpen;
const toolbarSurfaceStyle = {
backgroundColor: 'var(--terminal-ui-bg)',
color: 'var(--terminal-ui-fg)',
borderColor: 'var(--terminal-ui-border)',
['--terminal-toolbar-fg' as never]: 'var(--terminal-ui-fg)',
['--terminal-toolbar-bg' as never]: 'var(--terminal-ui-bg)',
['--terminal-toolbar-btn' as never]: 'var(--terminal-ui-toolbar-btn)',
['--terminal-toolbar-btn-hover' as never]: 'var(--terminal-ui-toolbar-btn-hover)',
['--terminal-toolbar-btn-active' as never]: 'var(--terminal-ui-toolbar-btn-active)',
} as React.CSSProperties;
const terminalActionsBody = (
<>
<div
className={cn(
"flex items-center gap-1 text-[11px] font-semibold min-w-0 overflow-hidden shrink",
showHostInfoBar && "terminal-title-cluster",
)}
>
{!showHostInfoBar && inWorkspace && onDetachPointerDown && (
<div
role="button"
tabIndex={-1}
title={t("terminal.toolbar.dragPane")}
aria-label={t("terminal.toolbar.dragPane")}
className={cn(
"flex h-6 w-5 shrink-0 items-center justify-center rounded-md",
"cursor-grab active:cursor-grabbing",
"text-[color:var(--terminal-toolbar-fg)] opacity-45 hover:opacity-90",
"hover:bg-[color:var(--terminal-toolbar-btn-hover)] transition-colors",
)}
data-terminal-detach-drag-handle="true"
onPointerDown={onDetachPointerDown}
>
<GripVertical size={12} strokeWidth={2} aria-hidden="true" />
</div>
)}
{showHostInfoBar && <div
className={cn(
"flex items-center gap-1 min-w-0",
inWorkspace && onDetachPointerDown && "cursor-grab active:cursor-grabbing",
)}
data-terminal-detach-drag-handle={inWorkspace && onDetachPointerDown ? "true" : undefined}
onPointerDown={onDetachPointerDown}
>
<span className="whitespace-nowrap truncate min-w-0 max-w-[18rem]" title={titleConnectionAddress || sessionDisplayName || host.label}>
{titleConnectionAddress || sessionDisplayName || host.label}
</span>
</div>}
{host.protocol !== "local" && host.hostname && host.hostname !== "localhost" && (
<Tooltip>
<TooltipTrigger asChild>
<button
type="button"
className="ml-0.5 p-0.5 rounded hover:bg-[color:var(--terminal-toolbar-btn-hover)] transition-colors opacity-60 hover:opacity-100 flex-shrink-0"
onPointerDown={(event) => event.stopPropagation()}
onClick={() => {
void navigator.clipboard.writeText(host.hostname).then(() => {
toast.success(t("terminal.statusbar.copyHostname.toast", { hostname: host.hostname }));
}).catch(() => {
toast.error(t("terminal.statusbar.copyHostname.error"));
});
}}
aria-label={t("terminal.statusbar.copyHostname.label")}
>
<Copy size={10} />
</button>
</TooltipTrigger>
<TooltipContent side="bottom">{t("terminal.statusbar.copyHostname.tooltip", { hostname: host.hostname })}</TooltipContent>
</Tooltip>
)}
{shouldShowLineTimestampToolbarToggle(lineTimestampsAvailable, onUpdateHost) && (
<Tooltip>
<TooltipTrigger asChild>
<button
type="button"
className={cn(
"ml-0.5 p-0.5 rounded transition-colors flex-shrink-0",
"hover:bg-[color:var(--terminal-toolbar-btn-hover)]",
showLineTimestampGutter ? "opacity-100" : "opacity-60 hover:opacity-100",
)}
style={
showLineTimestampGutter
? {
backgroundColor: 'var(--terminal-toolbar-btn-active)',
color: lineTimestampColor,
}
: undefined
}
onClick={() => onUpdateHost(getLineTimestampToggleHostUpdate(host))}
aria-label={lineTimestampToggleLabel}
aria-pressed={showLineTimestampGutter}
>
<Clock3 size={10} />
</button>
</TooltipTrigger>
<TooltipContent side="bottom">{lineTimestampToggleLabel}</TooltipContent>
</Tooltip>
)}
{isSystemSidebarEligible && (
<Tooltip>
<TooltipTrigger asChild>
<button
type="button"
className="ml-0.5 p-0.5 rounded hover:bg-[color:var(--terminal-toolbar-btn-hover)] transition-colors opacity-60 hover:opacity-100 flex-shrink-0"
onClick={onOpenSystem}
aria-label={t("terminal.layer.system")}
>
<Activity size={10} />
</button>
</TooltipTrigger>
<TooltipContent side="bottom">{t("terminal.layer.system")}</TooltipContent>
</Tooltip>
)}
</div>
{showHostInfoBar && !compactToolbar && (
<TerminalServerStats
sessionId={sessionId}
enabled={(terminalSettings?.showServerStats ?? true) && shouldKeepTerminalBackgroundWorkActive(
terminalSettings,
host.protocol,
isVisible,
)}
refreshInterval={terminalSettings?.serverStatsRefreshInterval ?? 5}
isSupportedOs={isSupportedOs}
isConnected={status === 'connected'}
/>
)}
{showHostInfoBar && <div className="flex-1 min-w-0" />}
<div className="flex items-center gap-0.5 flex-shrink-0">
{inWorkspace && onToggleBroadcast && (
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="secondary"
size="icon"
className={cn(
"h-6 w-6 p-0 shadow-none border-none text-[color:var(--terminal-toolbar-fg)]",
"bg-transparent hover:bg-transparent",
isBroadcastEnabled && "text-green-500",
)}
onClick={onToggleBroadcast}
aria-label={
isBroadcastEnabled
? t("terminal.toolbar.broadcastDisable")
: t("terminal.toolbar.broadcastEnable")
}
>
<Radio size={12} />
</Button>
</TooltipTrigger>
<TooltipContent side="bottom">
{isBroadcastEnabled
? t("terminal.toolbar.broadcastDisable")
: t("terminal.toolbar.broadcastEnable")}
</TooltipContent>
</Tooltip>
)}
{inWorkspace && onDetach && (
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="secondary"
size="icon"
className="h-6 w-6 p-0 shadow-none border-none text-[color:var(--terminal-toolbar-fg)] bg-transparent hover:bg-transparent"
onClick={onDetach}
aria-label={t('terminal.toolbar.detach')}
>
<SquareArrowOutUpRight size={12} />
</Button>
</TooltipTrigger>
<TooltipContent side="bottom">{t('terminal.toolbar.detach')}</TooltipContent>
</Tooltip>
)}
{inWorkspace && !isFocusMode && onExpandToFocus && (
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="secondary"
size="icon"
className="h-6 w-6 p-0 shadow-none border-none text-[color:var(--terminal-toolbar-fg)] bg-transparent hover:bg-transparent"
onClick={onExpandToFocus}
aria-label={t("terminal.toolbar.focusMode")}
>
<Maximize2 size={12} />
</Button>
</TooltipTrigger>
<TooltipContent side="bottom">{t("terminal.toolbar.focusMode")}</TooltipContent>
</Tooltip>
)}
{renderControls({ showClose: inWorkspace })}
</div>
</>
);
if (isCompactActionsMode) {
// Speed-dial: circular toggle; full action strip springs out to the left.
// Do NOT use `.terminal-topbar` here — it sets container-type:inline-size,
// which size-contains the inline axis and collapses width to 0 when we
// animate max-width / rely on content sizing (buttons never appear).
// Shared h-7 keeps the toggle and the action pill the same height as the
// inner h-6 icon buttons + vertical padding.
// No box-shadow: the 0fr→1fr expand clip always slices shadows and
// looks worse than a clean border-only chrome.
const compactChromeClass =
"h-7 rounded-full border backdrop-blur-md";
return (
<div className="absolute right-1 top-1 z-30 flex flex-row-reverse items-center pointer-events-none">
<Tooltip open={compactActionsOpen ? false : undefined}>
<TooltipTrigger asChild>
<button
ref={compactActionsButtonRef}
type="button"
className={cn(
"relative z-10 flex w-7 shrink-0 items-center justify-center pointer-events-auto",
compactChromeClass,
"opacity-80 hover:opacity-100 focus-visible:opacity-100",
"transition-[transform,opacity] duration-200 ease-out",
compactActionsOpen && "opacity-100",
)}
style={{
backgroundColor: 'var(--terminal-ui-bg)',
borderColor: 'var(--terminal-ui-border)',
color: 'var(--terminal-ui-fg)',
}}
aria-label={t("terminal.toolbar.showActions")}
aria-expanded={compactActionsOpen}
aria-controls={`terminal-actions-${sessionId}`}
onClick={() => setCompactActionsOpen((open) => !open)}
>
{/* Closed: chevrons point left (expand that way). Open: close. */}
{compactActionsOpen
? <XIcon size={12} strokeWidth={2} aria-hidden="true" />
: <ChevronsLeft size={13} strokeWidth={2} aria-hidden="true" />}
</button>
</TooltipTrigger>
<TooltipContent side="bottom">{t("terminal.toolbar.showActions")}</TooltipContent>
</Tooltip>
<div
className={cn(
"grid min-w-0 transition-[grid-template-columns,opacity,margin] duration-200 ease-out",
compactActionsOpen
? "mr-1.5 grid-cols-[1fr] opacity-100 pointer-events-auto"
: "mr-0 grid-cols-[0fr] opacity-0 pointer-events-none",
)}
>
<div className="min-w-0 overflow-hidden">
<div
id={`terminal-actions-${sessionId}`}
aria-hidden={!compactActionsOpen ? true : undefined}
className={cn(
"flex w-max items-center gap-0.5 px-1.5",
compactChromeClass,
)}
data-host-info-visible="false"
style={toolbarSurfaceStyle}
>
{terminalActionsBody}
</div>
</div>
</div>
</div>
);
}
return (
<div
id={`terminal-actions-${sessionId}`}
className={cn(
"terminal-topbar flex items-center gap-1 py-0.5 backdrop-blur-md min-w-0",
showHostInfoBar
? "px-2 pointer-events-auto"
: "ml-auto w-fit rounded-bl-md px-1 pointer-events-auto",
)}
data-host-info-visible={showHostInfoBar ? "true" : "false"}
style={toolbarSurfaceStyle}
>
{terminalActionsBody}
</div>
);
})()}
{isSearchOpen && (
<div className="pointer-events-auto">
<TerminalSearchBar
isOpen={isSearchOpen}
focusToken={searchFocusToken}
onClose={handleCloseSearch}
onSearch={handleSearch}
onFindNext={handleFindNext}
onFindPrevious={handleFindPrevious}
matchCount={searchMatchCount}
/>
</div>
)}
</div>
<div
className={cn(
"flex-1 min-h-0 min-w-0 relative overflow-hidden",
showHostInfoBar && "pt-8",
)}
style={{ backgroundColor: 'var(--terminal-ui-bg)' }}
>
<div
ref={containerRef}
className="xterm-container absolute"
data-font-smoothing={terminalSettings?.fontSmoothing !== false ? "true" : "false"}
style={{
top: terminalContentTop,
left: activeLineTimestampGutterWidth + terminalBodyInset,
right: terminalRightInset,
bottom: terminalBodyInset,
paddingLeft: 6,
backgroundColor: 'var(--terminal-ui-bg)',
}}
/>
<TerminalTimestampGutter
termRef={termRef}
containerRef={containerRef}
enabled={showLineTimestampGutter}
top={terminalContentTop}
left={terminalBodyInset}
bottom={terminalBodyInset}
sessionId={sessionId}
color={lineTimestampColor}
fontFamily={resolvedFontFamily}
fontSize={effectiveFontSize}
fontWeight={effectiveFontWeight}
width={lineTimestampGutterWidth}
onWidthChange={handleLineTimestampGutterWidthChange}
/>
{shouldShowSelectionAIOverlay({
hasSelection,
selectionOverlayPosition,
onAddSelectionToAI: ctx.onAddSelectionToAI,
showSelectionAIAction,
}) && handleAddSelectionToAI && (
<div
className="absolute z-30 pointer-events-none"
style={{
left: selectionOverlayPosition.left,
top: selectionOverlayPosition.top,
transform: "translate(-100%, -100%)",
}}
>
<Tooltip>
<TooltipTrigger asChild>
<button
type="button"
className="pointer-events-auto inline-flex h-7 min-w-max items-center gap-1.5 whitespace-nowrap rounded-md border px-2 text-[11px] font-medium shadow-lg backdrop-blur-md transition-colors hover:bg-[color:var(--terminal-toolbar-btn-hover)]"
style={{
backgroundColor: 'color-mix(in srgb, var(--terminal-ui-bg) 86%, transparent)',
borderColor: 'var(--terminal-ui-border)',
color: 'var(--terminal-ui-fg)',
}}
onMouseDown={(e) => {
e.preventDefault();
e.stopPropagation();
}}
onClick={handleAddSelectionToAI}
aria-label={t("terminal.selection.addToAI")}
>
<Sparkles size={12} />
<span>{t("terminal.selection.addToAI")}</span>
</button>
</TooltipTrigger>
<TooltipContent>{t("terminal.selection.addToAIDesc")}</TooltipContent>
</Tooltip>
</div>
)}
{/* Autocomplete — owns the hook + popup in its own component so
suggestion/selection updates don't re-render Terminal. Mounted
unconditionally; it gates the popup on `visible` internally. */}
<TerminalAutocomplete
termRef={termRef}
sessionId={sessionId}
hostId={host.id}
hostOs={autocompleteHostOs}
settings={autocompleteSettings}
protocol={effectiveTerminalProtocol ?? resolveEffectiveTerminalProtocol(host)}
workspaceId={workspaceId}
status={status}
getCwd={() => terminalCwdTracker.getRendererCwd() ?? knownCwdRef.current}
onAcceptText={(text) => autocompleteAcceptTextRef.current?.(text)}
snippets={snippets}
onAcceptSnippet={(snippet) => void executeSnippet(snippet)}
themeColors={effectiveTheme.colors}
containerRef={containerRef}
searchBarOffset={terminalToolbarOffset + terminalBodyInset}
keyEventRef={autocompleteKeyEventRef}
inputRef={autocompleteInputRef}
repositionRef={autocompleteRepositionRef}
closeRef={autocompleteCloseRef}
sudoHintRef={sudoHintRef}
sudoHintText={sudoHintText}
isPluginCompletionProviderAvailable={() => (
isPluginTerminalProviderAvailable('terminal.completion')
)}
sensitiveInputActiveRef={passwordPromptActiveRef}
allowHostStyleGreaterThanPrompt={isNetworkDevice}
/>
<PasswordCredentialPicker
visible={Boolean(passwordPickerState)}
items={passwordPickerState?.items ?? []}
selectedIndex={passwordPickerState?.selectedIndex ?? 0}
onSelect={(id) => onPasswordPickerSelect?.(id)}
title={passwordPickerTitle ?? "Saved passwords"}
emptyText={passwordPickerEmptyText ?? "No saved passwords"}
themeColors={effectiveTheme.colors}
termRef={termRef}
containerRef={containerRef}
/>
{scriptExecutionOverlay}
{/* OSC-52 clipboard read prompt */}
{osc52ReadPromptVisible && (
<div
className="absolute inset-0 z-40 flex items-center justify-center bg-background/60"
onKeyDown={(e) => {
if (e.key === 'Escape') handleOsc52ReadResponse(false);
}}
>
<div className="rounded-lg border bg-card p-4 shadow-lg max-w-sm space-y-3">
<p className="text-sm font-medium">{t("terminal.osc52.readPrompt.title")}</p>
<p className="text-sm text-muted-foreground">{t("terminal.osc52.readPrompt.desc")}</p>
<div className="flex justify-end gap-2">
<Button variant="secondary" size="sm" onClick={() => handleOsc52ReadResponse(false)}>
{t("terminal.osc52.readPrompt.deny")}
</Button>
<Button size="sm" autoFocus onClick={() => handleOsc52ReadResponse(true)}>
{t("terminal.osc52.readPrompt.allow")}
</Button>
</div>
</div>
</div>
)}
<Dialog open={Boolean(osc7SetupOpen)} onOpenChange={handleOsc7SetupOpenChange}>
<DialogContent className="sm:max-w-[640px]">
<DialogHeader>
<DialogTitle>{t("terminal.osc7Setup.title")}</DialogTitle>
<DialogDescription>
{t("terminal.osc7Setup.desc")}
</DialogDescription>
</DialogHeader>
<div className="space-y-3">
<div className="rounded-md border border-border/70 bg-muted/35 p-3">
<p className="mb-2 text-xs font-medium text-muted-foreground">
{t("terminal.osc7Setup.targets")}
</p>
<div className="flex flex-wrap gap-2">
{OSC7_SETUP_TARGETS.map((target) => (
<code
key={target}
className="rounded bg-background px-2 py-1 text-[11px] text-foreground"
>
{target}
</code>
))}
</div>
</div>
</div>
<DialogFooter>
<Button variant="secondary" onClick={() => handleOsc7SetupOpenChange(false)}>
{t("common.cancel")}
</Button>
<Button onClick={handleOsc7SetupConfirm} disabled={status !== "connected" || osc7SetupRunning}>
{osc7SetupRunning ? t("terminal.osc7Setup.running") : t("terminal.osc7Setup.run")}
</Button>
</DialogFooter>
</DialogContent>
</Dialog>
{/* Connection dialog: skip for local/serial during connecting phase, but show on error */}
{shouldShowConnectionDialog && (
<TerminalConnectionDialog
host={host}
status={status}
restoreState={restoreState}
error={error}
progressValue={progressValue}
chainProgress={chainProgress}
needsAuth={auth.needsAuth}
showLogs={showLogs}
_setShowLogs={setShowLogs}
keys={keys}
onDismissDisconnected={handleDismissDisconnectedDialog}
showEnterReconnectHint={showEnterReconnectHint}
isFocusedPane={isFocusedPane}
hostKeyVerification={needsHostKeyVerification && pendingHostKeyInfo ? {
hostKeyInfo: pendingHostKeyInfo,
onClose: handleHostKeyClose,
onContinue: handleHostKeyContinue,
onAddAndContinue: handleHostKeyAddAndContinue,
} : undefined}
authProps={{
authMethod: auth.authMethod,
setAuthMethod: auth.setAuthMethod,
authUsername: auth.authUsername,
setAuthUsername: auth.setAuthUsername,
authPassword: auth.authPassword,
setAuthPassword: auth.setAuthPassword,
authKeyId: auth.authKeyId,
setAuthKeyId: auth.setAuthKeyId,
authPassphrase: auth.authPassphrase,
setAuthPassphrase: auth.setAuthPassphrase,
showAuthPassphrase: auth.showAuthPassphrase,
setShowAuthPassphrase: auth.setShowAuthPassphrase,
showAuthPassword: auth.showAuthPassword,
setShowAuthPassword: auth.setShowAuthPassword,
authRetryMessage: auth.authRetryMessage,
onSubmit: () => auth.submit(),
onSubmitWithoutSave: () => auth.submit({ saveToHost: false }),
onCancel: handleCancelConnect,
isValid: auth.isValid,
}}
progressProps={{
timeLeft,
isAwaitingUserInput: Boolean(isConnectionAwaitingUserInput),
isCancelling,
progressLogs,
onCancelConnect: handleCancelConnect,
onCloseSession: handleCloseDisconnectedSession,
onRetry: handleRetry,
}}
/>
)}
{/* ZMODEM transfer progress indicator */}
{zmodem.active && (
<div className="absolute bottom-4 right-4 z-[25] pointer-events-auto">
<ZmodemProgressIndicator
transferType={zmodem.transferType}
filename={zmodem.filename}
transferred={zmodem.transferred}
total={zmodem.total}
bytesPerSecond={zmodem.bytesPerSecond}
fileIndex={zmodem.fileIndex}
fileCount={zmodem.fileCount}
finalizing={zmodem.finalizing}
onCancel={zmodem.cancel}
/>
</div>
)}
{/* ZMODEM overwrite conflict dialog */}
{zmodem.overwriteRequest && (
<ZmodemOverwriteDialog
filename={zmodem.overwriteRequest.filename}
onRespond={zmodem.respondOverwrite}
/>
)}
</div>
{/* Compose Bar (solo sessions only; workspace uses TerminalLayer's global bar) */}
{isComposeBarOpen && !inWorkspace && (
<TerminalComposeBar
onSend={(text) => {
if (sessionRef.current) {
executeSnippetCommand(text, false);
}
}}
onSnippetClick={(snippet) => void executeSnippet(snippet)}
snippets={snippets}
onClose={() => {
setIsComposeBarOpen(false);
termRef.current?.focus();
}}
isBroadcastEnabled={isBroadcastEnabled}
themeColors={effectiveTheme.colors}
/>
)}
</div>
</TerminalContextMenu>
);
}
export const TerminalView = memo(TerminalViewInner, terminalViewCtxEqual);
TerminalView.displayName = 'TerminalView';