// Pin viewport-only reveal reads; normal-buffer scrollback in serialize() can masquerade as a live alt frame (STA-5208). import '../../../src/main/daemon/emulation/xterm-env-polyfill' import { describe, expect, it } from 'vitest' import { Terminal } from '@xterm/headless' import { SerializeAddon } from '@xterm/addon-serialize' import type { Page } from '@stablyai/playwright-test' import { readActiveScreen, readRenderedAltScreenFrame } from './alt-screen-frame' const MARKER = 'DUPLICATE_PTY_REVEAL_TEST' const TAB_ID = 'tab-under-test' type Harness = { page: Page; terminal: Terminal; serialize: () => string } // Matches the streaming TUI fixture in terminal-duplicate-pty-renderer-reveal.spec.ts. function frameLine(frame: number): string { return `${MARKER} frame ${String(frame).padStart(6, '0')}` } function write(terminal: Terminal, data: string): Promise { return new Promise((resolve) => terminal.write(data, () => resolve())) } // Run the real serialized browser closure against a headless terminal, not a copied implementation. function createHarness(rows: number): Harness { const terminal = new Terminal({ cols: 80, rows, scrollback: 100, allowProposedApi: true }) const serializeAddon = new SerializeAddon() terminal.loadAddon(serializeAddon) const pane = { terminal, serializeAddon } ;(globalThis as Record).__paneManagers = new Map([ [TAB_ID, { getPanes: () => [pane] }] ]) const page = { evaluate: (fn: (arg: Arg) => Result, arg: Arg): Promise => Promise.resolve(fn(arg)) } as unknown as Page return { page, terminal, serialize: () => serializeAddon.serialize() } } // The oracle this replaces: a positional scan over every buffer serialize() emits. function parseSerializedFrame(content: string, pick: 'first' | 'last'): number | null { const prefix = `${MARKER} frame ` const start = pick === 'first' ? content.indexOf(prefix) : content.lastIndexOf(prefix) if (start < 0) { return null } const digits = content.slice(start + prefix.length).match(/^\d+/)?.[0] return digits ? Number(digits) : null } describe('readRenderedAltScreenFrame', () => { it('reads the live alt frame, not the stale copy left in the normal buffer', async () => { const harness = createHarness(8) await write(harness.terminal, `${frameLine(390)}\r\n`) await write(harness.terminal, `\x1b[?1049h\x1b[H${frameLine(400)}\x1b[J`) const serialized = harness.serialize() expect(parseSerializedFrame(serialized, 'first')).toBe(390) expect(parseSerializedFrame(serialized, 'last')).toBe(400) await expect(readActiveScreen(harness.page, TAB_ID)).resolves.toMatchObject({ bufferType: 'alternate' }) await expect(readRenderedAltScreenFrame(harness.page, TAB_ID, MARKER)).resolves.toBe(400) }) it('reports no frame when the freshest marker scrolled off the visible rows', async () => { const harness = createHarness(8) await write(harness.terminal, `${frameLine(400)}\r\n`) for (let row = 0; row < 12; row += 1) { await write(harness.terminal, `filler row ${row}\r\n`) } // serialize() still sees off-screen history; only the viewport proves the marker is absent. expect(parseSerializedFrame(harness.serialize(), 'last')).toBe(400) await expect(readActiveScreen(harness.page, TAB_ID)).resolves.toMatchObject({ bufferType: 'normal' }) await expect(readRenderedAltScreenFrame(harness.page, TAB_ID, MARKER)).resolves.toBeNull() }) })