# gizapp/tui

The terminal front end of an app run (host.giz): the app's pages on the terminal's whole screen, drawn by the engine as a window's are (window.giz), but on the terminal's grid. The view lays the GHTML pages out with the faces of the grid (gizlang/graphics gridFonts) at a viewport of cells (Viewport.cells, where `@media (grid)` holds), draws its scene onto a surface of cells (View.drawCells), and the terminal's driver (gizlang/terminal Screen) sends what changed. Keys, pastes, the mouse and the terminal's resizes go to the view as a window's input does. The view runs in this process: a terminal has one page, and nothing to isolate it from.

```gizlang
import * as Tui from "gizapp/tui";
```

## Functions

### `show`

```gizlang
function show(site: Site): i64
```

Shows SITE on the terminal's whole screen until the page closes it (host.giz close, or a giz:close link), Ctrl+C or
the end of input: the front end of an app run (host.giz run). The code the app gave, else 0; 1 when the terminal
cannot be taken.

Effects: fail, read, write, console, io, alloc.

