natui/inproc

runEmbedded

function runEmbedded(
  element: ReactNode,
  options?: RunEmbeddedOptions,
): Promise<void>

Mounts a React element inside an embedding native host. RunEmbeddedOptions is the same window property shape used by the protocol.

The host must provide:

• globalThis.__natui_send(json) for JavaScript-to-host messages
• A ready handshake after evaluating the bundle

The module installs globalThis.__natui_recv(json) for host-to-JavaScript messages.

import { Text } from 'natui/components';
import { runEmbedded } from 'natui/inproc';

await runEmbedded(<Text>Hello</Text>, {
  title: 'embedded NatUI',
  width: 400,
  height: 240,
});

The entrypoint contains no Node built-ins and is intended for browser-platform bundling. The repository currently implements this embedding contract with JavaScriptCore on macOS.