[cowboyd]

React, Preact, Solid, and raw consumers all ultimately need the same small set of operations: create elements and literals, set properties, and insert, move, or remove children. A framework-neutral Host makes those mutations the compatibility boundary for Bombshell, allowing every reconciler to target one model while custom elements extend the same operations through middleware. This prevents the core UI from becoming React-shaped, DOM-shaped, or tied to any one rendering strategy.

The ordered Host element tree is intentionally distinct from the middleware tree. Elements and literals can be assembled while detached, then attaching or reparenting an element creates the corresponding middleware nodes in the correct context. This preserves element identity while letting framework reconcilers perform their normal move operations and gives later layout code a definitive render order.

import { createHost } from './host.ts';

const host = createHost();
const box = host.createElement('box');
const greeting = host.createLiteral('Hello, world!');

host.insertBefore(box, greeting);
host.insertBefore(host.element, box);

This PR adds Host, HostApi, HostElement, HostLiteral, and the extensible HostElements type map. It supports detached subtree construction, attachment, reparenting, same-parent reordering, removal, properties, and literal updates. Tests define the mutation and lifecycle contract framework adapters will consume.

[pkg-pr-new]

• @examples/basic

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

commit: 6fbb974

[cowboyd]

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