Files
Netcatty/components/terminal/runtime/terminalUnfocusedRepaint.ts
T
bincxzandCursor 7f90896dbc fix(terminal): flush write coalescer when window loses focus
Bypass the RAF-bound output coalescer for visible unfocused panes so flow control does not pause the PTY before unfocused repaints can run.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-28 13:06:40 +08:00

52 lines
1.7 KiB
TypeScript

import type { Terminal as XTerm } from "@xterm/xterm";
import { forceSyncRenderAfterResize } from "../terminalHelpers";
import {
isTerminalAlternateScreenActive,
refreshTerminalViewport,
} from "../terminalHibernateRuntime";
import { flushTerminalWriteCoalescer } from "./terminalWriteCoalescer";
const UNFOCUSED_REPAINT_DEBOUNCE_MS = 16;
const unfocusedRepaintTimers = new WeakMap<XTerm, ReturnType<typeof setTimeout>>();
export function isTerminalWindowUnfocusedButVisible(): boolean {
if (typeof document === "undefined") return false;
return document.visibilityState === "visible" && !document.hasFocus();
}
export function forceTerminalRepaintBypassingAnimationFrame(term: XTerm): void {
if (isTerminalAlternateScreenActive(term)) {
refreshTerminalViewport(term);
}
forceSyncRenderAfterResize(term);
}
export function scheduleTerminalRepaintWhenUnfocused(term: XTerm): void {
if (!isTerminalWindowUnfocusedButVisible()) return;
if (unfocusedRepaintTimers.has(term)) return;
const timer = setTimeout(() => {
unfocusedRepaintTimers.delete(term);
if (!isTerminalWindowUnfocusedButVisible()) return;
forceTerminalRepaintBypassingAnimationFrame(term);
}, UNFOCUSED_REPAINT_DEBOUNCE_MS);
unfocusedRepaintTimers.set(term, timer);
}
export function cancelScheduledUnfocusedRepaint(term: XTerm): void {
const timer = unfocusedRepaintTimers.get(term);
if (timer === undefined) return;
clearTimeout(timer);
unfocusedRepaintTimers.delete(term);
}
export function maybeFlushTerminalWriteCoalescerWhenUnfocused(
term: XTerm,
isPaneVisible: boolean,
): void {
if (!isPaneVisible || !isTerminalWindowUnfocusedButVisible()) return;
flushTerminalWriteCoalescer(term);
}