Terminal and console

Platform spec area

Terminal and console

Back to Core library ◎ Open in platform map

Owner

Piotr Mikstacki pmikstacki@cybernomad.it

Submitter

Piotr Mikstacki pmikstacki@cybernomad.it

Current document

ADRs

No architecture decision records under adr/ for this feature yet. Standard features must publish at least one ADR or keep a ## Decisions summary on the hub.

Articles

• No directly attached article pages for this node. Nested descendants exist deeper in this subtree.

History

0 revisions (git unavailable at build; counts may be empty)

Open full history on GitHub

No commits recorded for this path.

Completeness

OKarea · 3 SpecSection(s) · 0 H2 heading(s)

Section id	Required	Found
scope	yes	yes
features	yes	yes

Full tree: run pnpm verify:platform-spec-layout (writes src/generated/platform-spec-layout-report.json).

Related spec docs

• Domain
  Core library

  Parent domain

• Feature
  Panic, IO, and syscalls

  Syscall builtins underpin stream I/O

Scope

Terminal-facing corelib splits byte stream I/O (System.Input, System.Output, System.Error via System.Syscall) from styled terminal output (corelib_console: Ansi, Console.Format, controls, capabilities). Resize and tick delivery use channels or same-fiber events—no new runtime builtins beyond existing syscall and fiber surfaces.

Authority split

Layer	Owns
Console I/O streams	Stdin/stdout/stderr routing, UTF-8 bytes, Result vs panic on write failure
ANSI escape model	ESC/CSI/OSC framing and normative sequence tables (aligned with repository ANSI.md)
Console capabilities	TTY probe, NO_COLOR / FORCE_COLOR, color-model downgrade
Console markup format	Beskid console markup → escape emission
Console controls	In-terminal layout widgets (panel, progress, live tick)
Console terminal events	Resize polling and ConsoleMessage delivery

Features

Use the tiles below for normative feature contracts and article bundles.

Features

• ANSI escape modelNormative ESC/CSI/OSC framing and sequence tables for corelib_console Ansi modules.
• Console capabilitiesTTY detection, NO_COLOR and FORCE_COLOR policy, and color-model downgrade for styled output.
• Console controlsIn-terminal layout widgets—panel, stacks, progress bar, and live tick rendering.
• Console I/O streamsNormative stdin/stdout/stderr contracts via System.Syscall and split stream modules.
• Console markup formatBeskid console markup parsing and rendering to ANSI-styled strings.
• Console terminal eventsTerminal resize detection and ConsoleMessage delivery over channels and events.