[cowboyd]

The Host describes what the UI contains, but it should not dictate how every element becomes terminal output. Treating layout as a middleware-extensible function allows each element type to interpret its own properties and yield @bomb.sh/tty operations while recursively composing its children. This avoids maintaining separate layout state and gives third-party elements the same extension point as built-ins, regardless of which framework created them.

box and text provide the first concrete proof of that model. Boxes establish layout containers, text elements establish text styling scopes, and adjacent literals are collected into terminal text runs rather than manufacturing extra layout containers.

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

renderer.render(...layout(host.root));

This PR adds LayoutApi, root layout behavior, and middleware implementations for typed box and text elements. It converts ordered Host trees into @bomb.sh/tty operations and updates the basic example to construct and lay out those elements manually. Tests cover nested box and text layout independently.

[pkg-pr-new]

• @examples/basic

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

commit: e57af45

[cowboyd]

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