import type { IBufferCell, Terminal } from "@xterm/headless"; export interface TerminalView { lines: string[]; truncated: boolean; cursor?: { x: number; y: number; text: string; width: number; style: string; inverse: boolean; }; } const RESET = "\x1b[0m"; const MAX_VIEW_BYTES = 1024 * 1024; const MAX_CELL_CHARS = 128; const CELL_CONTROLS = /[\x00-\x1f\x7f-\x9f]/g; function colorStyle( channel: 38 | 48, rgb: boolean, palette: boolean, color: number, ): string { if (rgb) return `;${channel};2;${(color >>> 16) & 255};${(color >>> 8) & 255};${color & 255}`; return palette ? `;${channel};5;${color}` : ""; } type StyleCache = { flags: number; fgMode: number; bgMode: number; fg: number; bg: number; style: string; }; function cellStyle(cell: IBufferCell, cache: StyleCache): string { const flags = Number(Boolean(cell.isBold())) | (Number(Boolean(cell.isDim())) << 1) | (Number(Boolean(cell.isItalic())) << 2) | (Number(Boolean(cell.isUnderline())) << 3) | (Number(Boolean(cell.isInverse())) << 4) | (Number(Boolean(cell.isInvisible())) << 5) | (Number(Boolean(cell.isStrikethrough())) << 6); const fgMode = cell.getFgColorMode(); const bgMode = cell.getBgColorMode(); const fg = cell.getFgColor(); const bg = cell.getBgColor(); // Uniform styled regions dominate human views; reuse SGR without private xterm fields. if ( cache.flags === flags && cache.fgMode === fgMode && cache.bgMode === bgMode && cache.fg === fg && cache.bg === bg ) return cache.style; let style = "\x1b[0"; if (flags & 1) style += ";1"; if (flags & 2) style += ";2"; if (flags & 4) style += ";3"; if (flags & 8) style += ";4"; if (flags & 16) style += ";7"; if (flags & 32) style += ";8"; if (flags & 64) style += ";9"; cache.flags = flags; cache.fgMode = fgMode; cache.bgMode = bgMode; cache.fg = fg; cache.bg = bg; cache.style = style + colorStyle(38, cell.isFgRGB(), cell.isFgPalette(), fg) + colorStyle(48, cell.isBgRGB(), cell.isBgPalette(), bg) + "m"; return cache.style; } /** Human-only projection: generated SGR, never replayed child terminal controls. */ export function terminalView( terminal: Terminal, cursorVisible: boolean, ): TerminalView { const buffer = terminal.buffer.active; const cell = buffer.getNullCell(); const view: TerminalView = { lines: [], truncated: false }; const styleCache: StyleCache = { flags: -1, fgMode: -1, bgMode: -1, fg: -1, bg: -1, style: "", }; const cursorX = Math.min(buffer.cursorX, terminal.cols - 1); const contentBudget = MAX_VIEW_BYTES - terminal.rows * RESET.length; let bytes = 0; for (let y = 0; y < terminal.rows; y++) { const source = buffer.getLine(buffer.baseY + y); let line = ""; let previousStyle = ""; for (let x = 0; source && x < terminal.cols; x++) { if (!source.getCell(x, cell)) continue; const width = cell.getWidth(); if (width === 0) continue; const chars = cell.getChars(); if (chars.length > MAX_CELL_CHARS) view.truncated = true; const text = chars.slice(0, MAX_CELL_CHARS).replace(CELL_CONTROLS, "") || " "; const style = cell.isAttributeDefault() ? RESET : cellStyle(cell, styleCache); const segment = (style === previousStyle ? "" : style) + text; bytes += Buffer.byteLength(segment); if (bytes > contentBudget) { view.truncated = true; break; } line += segment; previousStyle = style; if ( cursorVisible && y === buffer.cursorY && x <= cursorX && x + width > cursorX ) { view.cursor = { x, y, text, width, style, inverse: Boolean(cell.isInverse()), }; } } view.lines.push(line + RESET); if (bytes > contentBudget) break; } if (view.truncated) view.cursor = undefined; return view; }