Function createHarness

packages/pi-tui/e2e/harness.ts:40–66

(
	initialLines: string[],
	options?: { columns?: number; rows?: number; capture?: boolean },
)

/** Build a TUI driven by a single Lines component on a virtual terminal. */
export async function createHarness(
	initialLines: string[],
	options?: { columns?: number; rows?: number; capture?: boolean },
): Promise<Harness<VirtualTerminal | WriteCapturingTerminal>> {
	const columns = options?.columns ?? 60;
	const rows = options?.rows ?? 10;
	const terminal = options?.capture ? new WriteCapturingTerminal(columns, rows) : new VirtualTerminal(columns, rows);
	const tui = new TUI(terminal);
	const content = new Lines();
	tui.addChild(content);
	content.setLines(initialLines);
	tui.start();
	await terminal.waitForRender();
	return {
		terminal,
		tui,
		content,
		async frame(lines: string[], force = false): Promise<void> {
			content.setLines(lines);
			tui.requestRender(force);
			await terminal.waitForRender();
		},
		stop(): void {
			tui.stop();
		},
	};
}

/** Count buffer lines (scrollback + screen) containing the marker. */
export function countInBuffer(buffer: string[], marker: string): number {