StreamTerminal

Terminal backed by PHP input/output streams. The PHP analog of pi-tui's `ProcessTerminal`. Defaults to `STDIN` / `STDOUT` and uses `stty` to toggle raw mode, so it works on any POSIX terminal the way the existing `RetainedTuiLoop::run()` does — but now behind a contract the loop can swap out. A `StreamTerminal` owns no state beyond the streams it was given and the saved `stty` settings; it is safe to construct one per loop session and discard it on {@see stop()}.

public function __construct(?string $title = null, ?mixed $input = null, ?mixed $output = null):

Parameters

public function start(callable $onInput, callable $onResize): void

Puts the terminal in raw mode and begins delivering input and resize events. Saves the previous terminal settings so {@see self::stop()} can restore them.

Parameters

public function stop(): void

Restores the terminal to how it was found: previous settings, visible cursor, default resize handling.

public function write(string $data): void

Writes raw bytes to the output stream, unmodified.

Parameters

public function columns(): int

The terminal's current width in columns.

public function rows(): int

The terminal's current height in rows.

public function moveBy(int $lines): void

Moves the cursor by the given number of lines, negative being upwards.

Parameters

public function hideCursor(): void

Hides the hardware cursor.

public function showCursor(): void

Shows the hardware cursor.

public function clearLine(): void

Clears the line the cursor is on.

public function clearFromCursor(): void

Clears from the cursor to the end of the screen.

public function clearScreen(): void

Clears the whole screen.

public function setTitle(string $title): void

Sets the terminal window title.

Parameters

public function pollInput(): string

Returns the current input byte chunk waiting on the input stream, or `''` when nothing is pending. The loop polls this on each tick; the method is intentionally non-blocking so a busy loop stays responsive.

public function atEndOfInput(): bool

True once the input stream is drained. A real terminal never reaches this: `feof()` on a TTY stays false for as long as the device is open.

public function dispatchInput(string $bytes): void

Feeds raw input bytes to the registered handler, used to drive the terminal from a test or another source instead of the real stream.

Parameters