[cowboyd]

The lower layers are deliberately modular, but users should not have to install every middleware subsystem and write a terminal loop before they can display an interface. createUI() becomes the composition root that owns the Host, built-in elements, focus and input routing, layout, render scheduling, terminal output, and terminal-mode lifecycle. Raw users receive a useful runtime immediately, while framework adapters remain responsible only for reconciliation.

Exposing the Host keeps the result composable: framework roots can mount at the UI root or any attached element, and multiple rendering approaches can coexist within one terminal session. Fullscreen and inline rendering remain internal policies, as do raw-mode input scanning and cleanup through explicit resource management. The initial renderer intentionally redraws the complete frame for every request, leaving coalescing and incremental rendering as future middleware improvements rather than requirements for the public API.

import { createUI } from '@clack/ui';

await using ui = await createUI({
	input: process.stdin,
	output: process.stdout,
});

const text = ui.host.createElement('text');
ui.host.insertBefore(text, ui.host.createLiteral('Hello!'));
ui.host.insertBefore(ui.host.element, text);

await ui.main();

This PR adds createUI(), the UI resource, the asynchronous input loop, and main(). It composes all Host subsystems with fullscreen or relative inline rendering and restores terminal settings when disposed. It also replaces the previous one-shot root/component helpers and updates the basic example to use the composed UI.

[pkg-pr-new]

• @examples/basic

  npm i https://pkg.pr.new/bombshell-dev/ui/@clack/ui@29
  

commit: f1d5f64

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	vitest@​4.1.9 ⏵ 4.1.11	+1	+2	+1
	@​types/​node@​22.20.0 ⏵ 22.20.4	+1		+1
	tsx@​4.23.15

View full report

[cowboyd]

closing out in favor of a DOM based substrate. See #37