@seanhogg/builderforce-webcontainers-core 2026.10.5 → 2026.10.6

package/dist/vfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"vfs.js","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vfs.js","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanhogg/builderforce-webcontainers-core",
-  "version": "2026.10.5",
+  "version": "2026.10.6",
   "description": "BuilderForce WebContainers — core. A runtime-agnostic in-browser dev server: virtual file system, module resolution, import rewriting to a package CDN, CSS/JSON/asset modules and project detection. No COOP/COEP required.",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/build.ts

@@ -1,4 +1,4 @@
-import { VirtualFileSystem, type FileSystemTree, type FlatFiles } from './vfs.js';
+import { VirtualFileSystem, type FileTree } from './vfs.js';
 import type { Bundler, BundleOutput } from './bundler.js';
 import type { PackageCdnFactory } from './packageCdn.js';
 import { esmShCdnFactory } from './packageCdn.js';
@@ -18,8 +18,8 @@ import { findHtmlEntries, rewriteBuiltHtml } from './buildHtml.js';
  * content hash in its name and can be cached forever.
  */
 export interface BuildOptions {
-  /** The project: a file system, or files as `mount()` takes them. */
-  files: VirtualFileSystem | FlatFiles | FileSystemTree;
+  /** The project: a file system, or files as `writeTree()` takes them. */
+  files: VirtualFileSystem | FileTree;
   bundler: Bundler;
   /** Package CDN factory (called with `dev: false`). Default: esm.sh. */
   cdn?: PackageCdnFactory;
@@ -50,7 +50,7 @@ const encoder = new TextEncoder();
 function toFileSystem(files: BuildOptions['files']): VirtualFileSystem {
   if (files instanceof VirtualFileSystem) return files;
   const fs = new VirtualFileSystem();
-  fs.mount(files);
+  fs.writeTree(files);
   return fs;
 }
 

package/src/check/typecheck.ts

@@ -1,5 +1,5 @@
 import type * as TS from 'typescript';
-import { VirtualFileSystem, type FileSystemTree, type FlatFiles } from '../vfs.js';
+import { VirtualFileSystem, type FileTree } from '../vfs.js';
 import { readProjectConfig } from '../projectConfig.js';
 import { isBareSpecifier, resolveAlias, splitPackageSpecifier } from '../resolve.js';
 import { acquireExtendedConfigs, acquireTypes, type FetchLike } from './acquire.js';
@@ -46,10 +46,10 @@ interface Reach {
   libFiles: Set<string>;
 }
 
-function toFileSystem(files: VirtualFileSystem | FlatFiles | FileSystemTree): VirtualFileSystem {
+function toFileSystem(files: VirtualFileSystem | FileTree): VirtualFileSystem {
   if (files instanceof VirtualFileSystem) return files;
   const fs = new VirtualFileSystem();
-  fs.mount(files);
+  fs.writeTree(files);
   return fs;
 }
 
@@ -78,7 +78,7 @@ function collectReach(ts: typeof TS, fs: VirtualFileSystem, projects: CheckProje
 
 export async function typecheckProject(
   ts: typeof TS,
-  files: VirtualFileSystem | FlatFiles | FileSystemTree,
+  files: VirtualFileSystem | FileTree,
   options: TypecheckOptions,
 ): Promise<TypecheckResult> {
   const fs = toFileSystem(files);

package/src/index.ts

@@ -1,5 +1,5 @@
 export { VirtualFileSystem } from './vfs.js';
-export type { FileContent, FileSystemTree, FlatFiles, FsChange } from './vfs.js';
+export type { FileContent, FileTree, FlatFiles, FsChange } from './vfs.js';
 export { normalizePath, dirname, basename, join, extname } from './paths.js';
 export { DevServer } from './devServer.js';
 export type { DevServerOptions, ServedFile } from './devServer.js';

package/src/node/childProcess.ts

@@ -68,7 +68,7 @@ class ChildProcess extends EventEmitterBase {
 
     const env: Record<string, string> = {};
     for (const [k, v] of Object.entries(options.env ?? deps.env())) if (v !== undefined) env[k] = String(v);
-    const [file, argv] = options.shell ? ['jsh', ['-c', [command, ...args].join(' ')]] : [command, args];
+    const [file, argv] = options.shell ? ['bfsh', ['-c', [command, ...args].join(' ')]] : [command, args];
     const release = deps.loop.hold();
     try {
       this.handle = deps.system.spawn(file, argv, { cwd: options.cwd ?? deps.cwd(), env });

package/src/node/misc.ts

@@ -27,7 +27,7 @@ export function createOsModule(env: () => Record<string, string | undefined>): R
     hostname: () => 'localhost',
     homedir: () => env().HOME ?? '/home/user',
     tmpdir: () => env().TMPDIR ?? '/tmp',
-    userInfo: () => ({ uid: 1000, gid: 1000, username: env().USER ?? 'user', homedir: env().HOME ?? '/home/user', shell: '/bin/jsh' }),
+    userInfo: () => ({ uid: 1000, gid: 1000, username: env().USER ?? 'user', homedir: env().HOME ?? '/home/user', shell: '/bin/bfsh' }),
     cpus: () => cpus,
     availableParallelism: () => cpus.length,
     totalmem: () => 4 * 1024 ** 3,

package/src/shell/builtins.ts

@@ -31,9 +31,9 @@ export const COREUTILS: Record<string, Command> = {
 };
 
 /** Programs the runtime provides besides coreutils (reported by `which`/`type`). */
-export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'jsh', 'sh', 'bash'];
+export const SYSTEM_PROGRAMS = ['node', 'npm', 'npx', 'bfsh', 'sh', 'bash'];
 
-const HELP = `jsh — BuilderForce WebContainers shell
+const HELP = `bfsh — BuilderForce WebContainers shell
 
   Builtins:  cd, pwd, export, unset, exit, source, history, type, which, help
   Files:     ls [-la], cat, mkdir [-p], rm [-rf], cp [-r], mv, touch

package/src/shell/devHandoff.ts

@@ -3,7 +3,7 @@
  * dev` / `npm start` usually run) cannot run here as-is — Vite itself needs
  * esbuild's native binary — but the runtime already IS a Vite-style dev server:
  * the in-browser DevServer serving the preview. So these commands announce that
- * preview as their server (`server-ready`) and stay "running" until Ctrl-C,
+ * preview as their server (a listening announcement) and stay "running" until Ctrl-C,
  * which is exactly what a host waiting on `npm run dev` expects.
  */
 import type { CommandContext } from './context.js';

package/src/shell/exec.ts

@@ -73,7 +73,7 @@ export class Shell implements ShellState {
       script = parse(source);
     } catch (error) {
       if (!(error instanceof ShellSyntaxError)) throw error;
-      io.stderr(`jsh: ${error.message}\n`);
+      io.stderr(`bfsh: ${error.message}\n`);
       this.lastStatus = 2;
       return 2;
     }
@@ -176,7 +176,7 @@ export class Shell implements ShellState {
       if (redirect.op === '<') {
         const text = this.system.fs.readText(path);
         if (text === undefined) {
-          io.stderr(`jsh: ${target}: No such file or directory\n`);
+          io.stderr(`bfsh: ${target}: No such file or directory\n`);
           return 1;
         }
         const queue = new InputQueue();
@@ -186,7 +186,7 @@ export class Shell implements ShellState {
         continue;
       }
       if (this.system.fs.isDirectory(path)) {
-        io.stderr(`jsh: ${target}: Is a directory\n`);
+        io.stderr(`bfsh: ${target}: Is a directory\n`);
         return 1;
       }
       const append = redirect.op === '>>' || redirect.op === '2>>';
@@ -240,7 +240,7 @@ export class Shell implements ShellState {
       child = this.system.spawn(name, args, { cwd: this.cwd, env, terminal: size });
     } catch (error) {
       if ((error as { code?: string }).code !== 'ENOENT') throw error;
-      io.stderr(`jsh: command not found: ${name}\n`);
+      io.stderr(`bfsh: command not found: ${name}\n`);
       return 127;
     }
     child.onStdout(io.stdout);

package/src/shell/expand.ts

@@ -29,7 +29,7 @@ async function paramValue(seg: Extract<Segment, { kind: 'var' }>, ctx: ExpandCon
     case '@':
     case '*': value = ctx.positional.join(' '); break;
     case '!': value = ''; break;
-    case '0': value = 'jsh'; break;
+    case '0': value = 'bfsh'; break;
     default: value = /^\d$/.test(seg.name) ? ctx.positional[Number(seg.name) - 1] : ctx.get(seg.name);
   }
   if (!seg.op) return value ?? '';

package/src/shell/program.ts

@@ -1,5 +1,5 @@
 /**
- * The `jsh` program: `jsh -c "…"`, `jsh script.sh`, a script on stdin, or —
+ * The `bfsh` program: `bfsh -c "…"`, `bfsh script.sh`, a script on stdin, or —
  * attached to a terminal — the interactive shell. Interactively the shell owns
  * the keyboard (raw mode) while it edits a line, and hands it to the running
  * job otherwise: straight through to a terminal-attached child (which has its
@@ -22,7 +22,7 @@ function createShell(ctx: ProgramContext, positional: string[] = []): Shell {
   return new Shell({
     system: ctx.system,
     cwd: ctx.cwd,
-    env: { ...ctx.env, SHELL: '/bin/jsh' },
+    env: { ...ctx.env, SHELL: '/bin/bfsh' },
     positional,
     terminalSize: () => (ctx.io.terminal ? { cols: ctx.io.terminal.cols, rows: ctx.io.terminal.rows } : undefined),
     commands: SHELL_COMMANDS,
@@ -131,7 +131,7 @@ async function interactive(ctx: ProgramContext): Promise<number> {
     try {
       await shell.exec(line, io, current.input, controller.signal);
     } catch (error) {
-      ctx.io.stderr(`jsh: ${error instanceof Error ? error.message : String(error)}\n`);
+      ctx.io.stderr(`bfsh: ${error instanceof Error ? error.message : String(error)}\n`);
     }
     job = undefined;
     if (shell.exitRequested !== undefined) return finish(shell.exitRequested);
@@ -206,7 +206,7 @@ export const shellProgram: Program = async (ctx) => {
     const path = args[0].startsWith('/') ? args[0] : join(ctx.cwd, args[0]);
     const source = ctx.system.fs.readText(path);
     if (source === undefined) {
-      ctx.io.stderr(`jsh: ${args[0]}: No such file or directory\n`);
+      ctx.io.stderr(`bfsh: ${args[0]}: No such file or directory\n`);
       return 127;
     }
     return runOnce(ctx, createShell(ctx, args.slice(1)), source.replace(/^#!.*\n/, ''));

package/src/system/commands.ts

@@ -1,8 +1,8 @@
 /**
  * Command lookup, shared by the kernel, the browser host and the shell:
- * registered programs first (node, npm, jsh, coreutils), then a path or a
+ * registered programs first (node, npm, bfsh, coreutils), then a path or a
  * `PATH`/`node_modules/.bin` lookup. A found file runs under `node` (a `.bin`
- * shim runs its target directly) or, with a shell shebang, under `jsh`.
+ * shim runs its target directly) or, with a shell shebang, under `bfsh`.
  */
 import type { VirtualFileSystem } from '../vfs.js';
 import { dirname, extname, join, normalizePath } from '../paths.js';
@@ -10,7 +10,7 @@ import { readBinLink } from '../installer/bins.js';
 import type { Program } from './types.js';
 
 export interface ResolvedCommand {
-  /** The registered program that will run (`node`, `jsh`, `ls`…). */
+  /** The registered program that will run (`node`, `bfsh`, `ls`…). */
   name: string;
   program: Program;
   args: string[];
@@ -40,12 +40,12 @@ export function findExecutable(fs: VirtualFileSystem, command: string, cwd: stri
 }
 
 /** How to run a script file: its interpreter and arguments. */
-export function interpreterFor(fs: VirtualFileSystem, path: string): { name: 'node' | 'jsh'; args: string[] } {
+export function interpreterFor(fs: VirtualFileSystem, path: string): { name: 'node' | 'bfsh'; args: string[] } {
   const target = readBinLink(fs, path);
   if (target) return { name: 'node', args: [target] };
   const firstLine = (fs.readText(path) ?? '').split('\n', 1)[0] ?? '';
-  if (/^#!.*\b(?:sh|bash|jsh|zsh|dash)\b/.test(firstLine)) return { name: 'jsh', args: [path] };
-  if (['.sh', '.bash'].includes(extname(path))) return { name: 'jsh', args: [path] };
+  if (/^#!.*\b(?:sh|bash|bfsh|zsh|dash)\b/.test(firstLine)) return { name: 'bfsh', args: [path] };
+  if (['.sh', '.bash'].includes(extname(path))) return { name: 'bfsh', args: [path] };
   return { name: 'node', args: [path] };
 }
 

package/src/system/index.ts

@@ -1,10 +1,12 @@
 export { Kernel, DEFAULT_ENV } from './kernel.js';
-export type { KernelOptions, KernelSpawnOptions } from './kernel.js';
-export type { System, Program, ProgramContext, ProgramIO, TerminalPort, SpawnOptions, ChildHandle, HttpRequestData, HttpResponseData, HttpHandler } from './types.js';
+export type { KernelOptions } from './kernel.js';
+export type { System, Program, ProgramContext, ProgramIO, TerminalPort, ProcessOptions, ChildHandle, HttpRequestData, HttpResponseData, HttpHandler } from './types.js';
 export { PortRegistry, parsePortPath } from './ports.js';
 export type { PortEvent } from './ports.js';
-export { runProgram, toWebContainerProcess, allocatePid } from './process.js';
-export type { WebContainerProcess, RunProgramOptions } from './process.js';
+export { runProgram, runArguments, toRuntimeProcess, allocatePid } from './process.js';
+export type { RuntimeProcess, RunProgramOptions } from './process.js';
+export { ServerEvents } from './serverEvents.js';
+export type { ServerAddress, PortChange } from './serverEvents.js';
 export { resolveCommand, findExecutable, binDirectories, interpreterFor, commandNotFound } from './commands.js';
 export type { ResolvedCommand } from './commands.js';
 export { InputQueue, LineDiscipline, toTerminal } from './terminal.js';

package/src/system/kernel.ts

@@ -7,10 +7,11 @@
  */
 import { VirtualFileSystem } from '../vfs.js';
 import type { PackageCache } from '../installer/registry.js';
-import type { ChildHandle, HttpRequestData, HttpResponseData, Program, SpawnOptions, System } from './types.js';
+import type { ChildHandle, HttpRequestData, HttpResponseData, Program, ProcessOptions, System } from './types.js';
 import { PortRegistry } from './ports.js';
+import { ServerEvents } from './serverEvents.js';
 import { commandNotFound, resolveCommand } from './commands.js';
-import { runProgram, toWebContainerProcess, type WebContainerProcess } from './process.js';
+import { runArguments, runProgram, toRuntimeProcess, type RuntimeProcess } from './process.js';
 
 export interface KernelOptions {
   fs?: VirtualFileSystem;
@@ -26,19 +27,11 @@ export interface KernelOptions {
   packageCache?: PackageCache;
 }
 
-export interface KernelSpawnOptions extends SpawnOptions {
-  /** Kept for `@webcontainer/api` parity; output is always delivered. */
-  output?: boolean;
-}
-
-type ServerReadyListener = (port: number, url: string) => void;
-type PortListener = (port: number, type: 'open' | 'close', url: string) => void;
-
 export const DEFAULT_ENV: Record<string, string> = {
   PATH: '/usr/local/bin:/usr/bin:/bin',
   HOME: '/home/user',
   USER: 'user',
-  SHELL: '/bin/jsh',
+  SHELL: '/bin/bfsh',
   TERM: 'xterm-256color',
   COLORTERM: 'truecolor',
   LANG: 'en_US.UTF-8',
@@ -48,20 +41,16 @@ export const DEFAULT_ENV: Record<string, string> = {
 export class Kernel {
   readonly fs: VirtualFileSystem;
   readonly ports = new PortRegistry();
+  /** Servers listening, ports opening and closing. */
+  readonly servers = new ServerEvents();
   readonly env: Record<string, string>;
-  private readonly serverReady = new Set<ServerReadyListener>();
-  private readonly portListeners = new Set<PortListener>();
   private readonly system: System;
 
   constructor(private readonly options: KernelOptions) {
     this.fs = options.fs ?? new VirtualFileSystem();
     this.env = { ...DEFAULT_ENV, ...options.env };
     const serverUrl = (port: number) => options.serverUrl?.(port) ?? `http://localhost:${port}/`;
-    this.ports.watch(({ type, port }) => {
-      const url = serverUrl(port);
-      for (const l of this.portListeners) l(port, type, url);
-      if (type === 'open') for (const l of this.serverReady) l(port, url);
-    });
+    this.ports.watch(({ type, port }) => this.servers.portChanged({ type, port, url: serverUrl(port) }));
     this.system = {
       fs: this.fs,
       fetch: options.fetch ?? ((input, init) => globalThis.fetch(input, init)),
@@ -69,21 +58,23 @@ export class Kernel {
       listen: (port, handler) => this.ports.listen(port, handler),
       loopback: (port, request) => this.ports.request(port, request),
       serverUrl,
-      announceServer: (port, url) => this.serverReady.forEach((l) => l(port, url)),
+      announceServer: (port, url) => this.servers.announce({ port, url }),
       previewUrl: options.previewUrl,
       registry: options.registry,
       packageCache: options.packageCache,
     };
   }
 
-  /** Same shape as `WebContainer#spawn`. */
-  spawn(command: string, args: string[] | KernelSpawnOptions = [], options: KernelSpawnOptions = {}): WebContainerProcess {
-    if (!Array.isArray(args)) [options, args] = [args, []];
-    return toWebContainerProcess(this.spawnChild(command, args, options), !!options.terminal);
+  /** Start a command — `run('npm', ['install'])`, `run('bfsh', { terminal })` — as a stream-based {@link RuntimeProcess}. */
+  run(command: string, args?: string[], options?: ProcessOptions): RuntimeProcess;
+  run(command: string, options?: ProcessOptions): RuntimeProcess;
+  run(command: string, argsOrOptions?: string[] | ProcessOptions, maybeOptions?: ProcessOptions): RuntimeProcess {
+    const [args, options] = runArguments(argsOrOptions, maybeOptions);
+    return toRuntimeProcess(this.spawnChild(command, args, options), !!options.terminal);
   }
 
   /** A child as a program's parent sees it — what `System.spawn` returns. */
-  spawnChild(command: string, args: string[] = [], options: SpawnOptions = {}): ChildHandle {
+  spawnChild(command: string, args: string[] = [], options: ProcessOptions = {}): ChildHandle {
     const cwd = options.cwd ?? '/';
     const env = { ...this.env, ...options.env };
     const resolved = resolveCommand(this.fs, this.options.programs, command, args, cwd, env);
@@ -95,12 +86,4 @@ export class Kernel {
   request(port: number, request: Partial<HttpRequestData> & { url: string }): Promise<HttpResponseData | undefined> {
     return this.ports.request(port, { method: 'GET', headers: {}, body: null, ...request });
   }
-
-  on(event: 'server-ready', listener: ServerReadyListener): () => void;
-  on(event: 'port', listener: PortListener): () => void;
-  on(event: 'server-ready' | 'port', listener: ServerReadyListener | PortListener): () => void {
-    const set = (event === 'server-ready' ? this.serverReady : this.portListeners) as Set<typeof listener>;
-    set.add(listener);
-    return () => set.delete(listener);
-  }
 }

package/src/system/process.ts

@@ -2,10 +2,10 @@
  * Running one program in-process: its stdin queue, TTY line discipline,
  * output listeners and kill signal, packaged as a {@link ChildHandle}. The core
  * kernel uses it for every process; the browser worker uses it for the one
- * program it hosts. Also the WebContainer-shaped wrapper (`output`/`input`
- * streams) that public `spawn` returns.
+ * program it hosts. Also {@link RuntimeProcess}, the stream-based handle the
+ * public `run()` returns.
  */
-import type { ChildHandle, Program, ProgramIO, SpawnOptions, System } from './types.js';
+import type { ChildHandle, Program, ProgramIO, ProcessOptions, System } from './types.js';
 import { InputQueue, LineDiscipline, toTerminal } from './terminal.js';
 
 let nextPid = 1000;
@@ -14,7 +14,7 @@ export function allocatePid(): number {
   return nextPid++;
 }
 
-export interface RunProgramOptions extends SpawnOptions {
+export interface RunProgramOptions extends ProcessOptions {
   program: Program;
   args: string[];
   system: System;
@@ -122,18 +122,28 @@ export function runProgram(options: RunProgramOptions): ChildHandle {
   };
 }
 
-/** The public process shape, deliberately the same as `@webcontainer/api`'s `WebContainerProcess`. */
-export interface WebContainerProcess {
+/** A running process as a host page sees it: streams for xterm.js or a log, and its exit code. */
+export interface RuntimeProcess {
+  readonly pid: number;
   /** stdout and stderr, interleaved as written (`\r\n` line endings when attached to a terminal). */
-  readonly output: ReadableStream<string>;
-  readonly input: WritableStream<string>;
-  readonly exit: Promise<number>;
+  readonly combinedOutput: ReadableStream<string>;
+  /** Keystrokes or piped input; closing it is end-of-file. */
+  readonly stdin: WritableStream<string>;
+  /** Resolves with the exit code (128 + signal number when killed). */
+  wait(): Promise<number>;
+  /** Default `SIGTERM`; `SIGKILL` cannot be caught. */
   kill(signal?: string): void;
-  resize(dimensions: { cols: number; rows: number } | number, rows?: number): void;
+  /** Resize the attached terminal. A no-op for a process started without one. */
+  resizeTerminal(cols: number, rows: number): void;
 }
 
-export function toWebContainerProcess(child: ChildHandle, terminal: boolean): WebContainerProcess {
-  const output = new ReadableStream<string>({
+/** `run(command, args?, options?)` and `run(command, options)` — the same call either way. */
+export function runArguments(args: string[] | ProcessOptions = [], options: ProcessOptions = {}): [string[], ProcessOptions] {
+  return Array.isArray(args) ? [args, options] : [[], args];
+}
+
+export function toRuntimeProcess(child: ChildHandle, terminal: boolean): RuntimeProcess {
+  const combinedOutput = new ReadableStream<string>({
     start(controller) {
       const push = (chunk: string) => controller.enqueue(terminal ? toTerminal(chunk) : chunk);
       child.onStdout(push);
@@ -141,18 +151,16 @@ export function toWebContainerProcess(child: ChildHandle, terminal: boolean): We
       void child.exit.then(() => controller.close());
     },
   });
-  const input = new WritableStream<string>({
+  const stdin = new WritableStream<string>({
     write: (chunk) => child.write(chunk),
     close: () => child.closeStdin(),
   });
   return {
-    output,
-    input,
-    exit: child.exit,
+    pid: child.pid,
+    combinedOutput,
+    stdin,
+    wait: () => child.exit,
     kill: (signal) => child.kill(signal),
-    resize(dimensions, rows) {
-      const size = typeof dimensions === 'number' ? { cols: dimensions, rows: rows ?? 24 } : dimensions;
-      child.resize?.(size.cols, size.rows);
-    },
+    resizeTerminal: (cols, rows) => child.resize?.(cols, rows),
   };
 }

package/src/system/programs.ts

@@ -20,7 +20,7 @@ function viaShell(command: string): Program {
 export function defaultPrograms(): Record<string, Program> {
   const programs: Record<string, Program> = {
     node: nodeProgram,
-    jsh: shellProgram,
+    bfsh: shellProgram,
     sh: shellProgram,
     bash: shellProgram,
     npm: viaShell('npm'),

package/src/system/serverEvents.ts

@@ -0,0 +1,44 @@
+/**
+ * Who hears about servers in a runtime: a port opening or closing, and a
+ * server becoming reachable (which a dev-server handoff announces without
+ * opening a port). One instance per runtime — the core `Kernel` and the
+ * browser's process host both own one, so the listener contract is the same.
+ */
+
+export interface ServerAddress {
+  port: number;
+  /** Where a browser reaches it (the preview URL for that port). */
+  url: string;
+}
+
+export interface PortChange extends ServerAddress {
+  type: 'open' | 'close';
+}
+
+export class ServerEvents {
+  private readonly listening = new Set<(server: ServerAddress) => void>();
+  private readonly changes = new Set<(change: PortChange) => void>();
+
+  /** A server started listening (or a dev script handed off to the preview); `url` loads it in an iframe. */
+  onListening(listener: (server: ServerAddress) => void): () => void {
+    this.listening.add(listener);
+    return () => this.listening.delete(listener);
+  }
+
+  /** A virtual server opened or closed its port. */
+  onPortChange(listener: (change: PortChange) => void): () => void {
+    this.changes.add(listener);
+    return () => this.changes.delete(listener);
+  }
+
+  /** Report a port table change; an opened port is also a server listening. */
+  portChanged(change: PortChange): void {
+    for (const listener of this.changes) listener(change);
+    if (change.type === 'open') this.announce({ port: change.port, url: change.url });
+  }
+
+  /** Report a reachable server that did not open a port of its own. */
+  announce(server: ServerAddress): void {
+    for (const listener of this.listening) listener(server);
+  }
+}

package/src/system/types.ts

@@ -24,14 +24,14 @@ export interface ProgramIO {
   terminal?: TerminalPort;
 }
 
-export interface SpawnOptions {
+export interface ProcessOptions {
   cwd?: string;
   env?: Record<string, string>;
   /** Attach to a terminal of this size (`isTTY`, line discipline, `\r\n` output). */
   terminal?: { cols: number; rows: number };
 }
 
-/** A child as its parent sees it (separate stdout/stderr, unlike the public API). */
+/** A child as its parent sees it (separate stdout/stderr listeners, unlike the streams of the public `RuntimeProcess`). */
 export interface ChildHandle {
   readonly pid: number;
   onStdout(listener: (chunk: string) => void): () => void;
@@ -64,14 +64,14 @@ export interface System {
   fs: VirtualFileSystem;
   /** Outbound network (registry, `http.request`, `fetch`). */
   fetch(input: string, init?: RequestInit): Promise<Response>;
-  spawn(command: string, args: string[], options?: SpawnOptions): ChildHandle;
+  spawn(command: string, args: string[], options?: ProcessOptions): ChildHandle;
   /** Register a virtual server; throws `EADDRINUSE`. Port 0 picks a free one. Returns the port and an unlisten. */
   listen(port: number, handler: HttpHandler): { port: number; close(): void };
   /** Send a request to a virtual server in this runtime (`http.get('http://localhost:3000')`); undefined when nothing listens. */
   loopback(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined>;
   /** Where a browser reaches a server on `port` (the preview URL), if known. */
   serverUrl(port: number): string | undefined;
-  /** Tell the host a server is ready (`server-ready`); used by the dev-server handoff. */
+  /** Tell the host a server is reachable without opening a port; used by the dev-server handoff. */
   announceServer(port: number, url: string): void;
   /** The in-browser dev server's preview URL, for `vite`/`react-scripts start` handoff. */
   previewUrl?: string;

package/src/vfs.ts

@@ -2,14 +2,18 @@ import { normalizePath, join, dirname } from './paths.js';
 
 export type FileContent = string | Uint8Array;
 
-/** The nested tree shape `@webcontainer/api`'s `mount()` takes — accepted as-is. */
-export interface FileSystemTree {
-  [name: string]: { file: { contents: FileContent } } | { directory: FileSystemTree };
-}
-
-/** A flat `{ 'src/main.tsx': '...' }` map, the other shape callers commonly hold. */
+/** A flat `{ 'src/main.tsx': '...' }` map: path → contents. */
 export type FlatFiles = Record<string, FileContent>;
 
+/**
+ * Files to write: a name maps to contents (a file) or to another tree (a
+ * directory). Names may hold slashes, so a {@link FlatFiles} map is a tree too,
+ * and the two styles mix freely: `{ src: { 'main.tsx': '…' }, 'public/a.svg': '…' }`.
+ */
+export interface FileTree {
+  [name: string]: FileContent | FileTree;
+}
+
 export interface FsChange {
   /** `mkdir` is an explicitly created (possibly empty) directory. */
   type: 'write' | 'remove' | 'mkdir';
@@ -129,18 +133,14 @@ export class VirtualFileSystem {
     return this.mtimes.get(normalizePath(path));
   }
 
-  /**
-   * Write many files at once. Takes either the nested WebContainer tree or a flat
-   * path→contents map — or a mix, since each entry is judged on its own.
-   */
-  mount(files: FileSystemTree | FlatFiles, at = '/'): void {
+  /** Write many files at once, under `at` (default `/`). A nested object is a directory, created even when empty. */
+  writeTree(files: FileTree, at = '/'): void {
     for (const [name, entry] of Object.entries(files)) {
       const path = join(at, name);
       if (typeof entry === 'string' || entry instanceof Uint8Array) this.writeFile(path, entry);
-      else if ('file' in entry) this.writeFile(path, entry.file.contents);
       else {
         this.mkdir(path);
-        this.mount(entry.directory, path);
+        this.writeTree(entry, path);
       }
     }
   }