brustjs 0.1.0-alpha → 0.1.0-alpha.1

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# 💥 Brust
+# Brust
 
 ### **B**un + **Rust** — an SSR framework that bursts.
 
@@ -23,7 +23,23 @@ per-worker `SharedArrayBuffer`. `tokio-uring` (io_uring) on Linux, `tokio` on ma
 
 ## Quick start
 
-**Add to a project** (prebuilt native binary per platform — no Rust toolchain):
+**Scaffold a new project** (prebuilt native binary per platform — no Rust toolchain):
+
+```bash
+bun create brustjs my-app
+cd my-app
+bun install
+bun run dev          # → http://127.0.0.1:3000
+```
+
+**Or, with the CLI on your PATH:**
+
+```bash
+bun add --global brustjs@alpha
+brustjs new my-app
+```
+
+**Or add to an existing project:**
 
 ```bash
 bun add brustjs@alpha
@@ -97,8 +113,9 @@ bench/ · docs/ · architecture.md
 ## Status
 
 Alpha, solo-developed. Linux is tier-1 (io_uring; glibc + musl, 6 prebuilt platform
-binaries). Known partials: `brustjs new` scaffold install, `brustjs dev` TS reload,
-islands + `.module.css`. Deployment note: the io_uring server needs `io_uring_*`
+binaries). Known partials: `brustjs dev` TS reload, islands + `.module.css`. Tailwind
+is opt-in — the scaffold adds it as a project dependency; `@import "tailwindcss"`
+resolves from your own `node_modules`. Deployment note: the io_uring server needs `io_uring_*`
 syscalls permitted — a default-seccomp container (Docker/k8s) must allow them or run
 `--security-opt seccomp=unconfined`. Roadmap and limitations in
 [`architecture.md`](./architecture.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brustjs",
-  "version": "0.1.0-alpha",
+  "version": "0.1.0-alpha.1",
   "description": "Bun + Rust SSR framework — React on the server, Rust everywhere else (napi cdylib + per-worker SharedArrayBuffer).",
   "license": "MIT",
   "repository": {
@@ -39,12 +39,12 @@
     "smol-toml": "^1.6.1"
   },
   "optionalDependencies": {
-    "brustjs-darwin-x64": "0.1.0-alpha",
-    "brustjs-darwin-arm64": "0.1.0-alpha",
-    "brustjs-linux-x64-gnu": "0.1.0-alpha",
-    "brustjs-linux-arm64-gnu": "0.1.0-alpha",
-    "brustjs-linux-x64-musl": "0.1.0-alpha",
-    "brustjs-linux-arm64-musl": "0.1.0-alpha"
+    "brustjs-darwin-x64": "0.1.0-alpha.1",
+    "brustjs-darwin-arm64": "0.1.0-alpha.1",
+    "brustjs-linux-x64-gnu": "0.1.0-alpha.1",
+    "brustjs-linux-arm64-gnu": "0.1.0-alpha.1",
+    "brustjs-linux-x64-musl": "0.1.0-alpha.1",
+    "brustjs-linux-arm64-musl": "0.1.0-alpha.1"
   },
   "peerDependencies": {
     "react": "^19.2.6",
@@ -64,7 +64,8 @@
   "types": "./runtime/index.d.ts",
   "exports": {
     ".": "./runtime/index.ts",
-    "./routes": "./runtime/routes.ts"
+    "./routes": "./runtime/routes.ts",
+    "./create": "./runtime/create.ts"
   },
   "files": [
     "runtime",

package/runtime/cli/build.ts

@@ -1,5 +1,6 @@
 import { existsSync } from 'node:fs'
 import { copyFile, mkdir, readdir, rm } from 'node:fs/promises'
+import { createRequire } from 'node:module'
 import path, { isAbsolute, resolve } from 'node:path'
 import {
   actionsPrebuiltPlugin,
@@ -12,6 +13,52 @@ import { nativeShimPlugin } from './native-shim-plugin.ts'
  * runtime/cli/build.ts so two dirname() steps get us there. */
 const REPO_ROOT = path.resolve(import.meta.dir, '..', '..')
 
+/** Detect musl (mirrors the napi loader + native-shim) so we pick the right
+ * platform package on Linux. */
+function linuxIsMusl(): boolean {
+  try {
+    const report = process.report as { excludeNetwork?: boolean; getReport?: () => unknown }
+    if (report && typeof report.getReport === 'function') {
+      report.excludeNetwork = true
+      const r = report.getReport() as { header?: { glibcVersionRuntime?: string } }
+      return !r?.header?.glibcVersionRuntime
+    }
+  } catch {}
+  return false
+}
+
+/** The npm package that carries this platform's prebuilt binary. */
+function platformPackageName(): string {
+  const { platform, arch } = process
+  if (platform === 'linux') return `brustjs-linux-${arch}-${linuxIsMusl() ? 'musl' : 'gnu'}`
+  return `brustjs-${platform}-${arch}`
+}
+
+/** Absolute paths of every `brust.*.node` to copy into the dist. Source-tree /
+ * CI-matrix builds emit them into runtime/; an installed project carries them
+ * in the brustjs-<platform> optionalDependency package. We gather from both so
+ * a dist Just Works in either layout. */
+async function collectNativeBinaries(): Promise<string[]> {
+  const out: string[] = []
+  const isNode = (f: string) => /^brust\..+\.node$/.test(f)
+
+  // (a) runtime/ — local napi build output (single- or multi-platform CI).
+  const runtimeDir = path.join(REPO_ROOT, 'runtime')
+  try {
+    for (const f of await readdir(runtimeDir)) if (isNode(f)) out.push(path.join(runtimeDir, f))
+  } catch {}
+
+  // (b) installed platform package — resolved from the brustjs install root so
+  // it survives node_modules hoisting.
+  try {
+    const req = createRequire(path.join(REPO_ROOT, '__brust_resolve__.js'))
+    const pkgDir = path.dirname(req.resolve(`${platformPackageName()}/package.json`))
+    for (const f of await readdir(pkgDir)) if (isNode(f)) out.push(path.join(pkgDir, f))
+  } catch {}
+
+  return out
+}
+
 interface ParsedArgs {
   entry: string // absolute path to the entry file
   outDir: string // absolute path to the output dir
@@ -230,22 +277,27 @@ export async function runBuild(args: string[]): Promise<void> {
   const nativeDir = path.join(outDir, 'native')
   await mkdir(nativeDir, { recursive: true })
 
-  // napi-rs emits `runtime/brust.<platform>-<arch>[-libc].node` (binaryName
-  // "brust", from the root napi config). We copy every `brust.*.node` we find
-  // in runtime/ so a multi-platform pre-build (CI matrix) Just Works without
-  // further wiring; in single-platform local builds this is just one file.
-  const runtimeDir = path.join(REPO_ROOT, 'runtime')
-  const nodeFiles = (await readdir(runtimeDir)).filter((f) => /^brust\..+\.node$/.test(f))
-  if (nodeFiles.length === 0) {
+  // napi-rs names the binary `brust.<platform>-<arch>[-libc].node` (binaryName
+  // "brust", from the root napi config). Source/CI builds leave it in runtime/;
+  // an installed project carries it in the brustjs-<platform> package. Copy
+  // every match from both — multi-platform (CI matrix) and single-platform
+  // (local/installed) layouts both Just Work.
+  const nativeBinaries = await collectNativeBinaries()
+  if (nativeBinaries.length === 0) {
     console.error(
-      `brust build: no native binary found in ${runtimeDir}. ` +
-        `Run \`bun --filter runtime run build\` (or :debug) first.`,
+      `brust build: no native binary found. Looked in ${path.join(REPO_ROOT, 'runtime')} and ` +
+        `the ${platformPackageName()} package. From source run \`bun --filter runtime run build\` ` +
+        `(or :debug) first; in an installed project ensure the platform package is present.`,
     )
     process.exit(1)
   }
-  for (const f of nodeFiles) {
-    await copyFile(path.join(runtimeDir, f), path.join(nativeDir, f))
-    console.log(`[brust build] native:  ${f}`)
+  const seen = new Set<string>()
+  for (const src of nativeBinaries) {
+    const name = path.basename(src)
+    if (seen.has(name)) continue
+    seen.add(name)
+    await copyFile(src, path.join(nativeDir, name))
+    console.log(`[brust build] native:  ${name}`)
   }
 
   console.log(`[brust build] done.`)

package/runtime/cli/native-routes-emit.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { dirname, resolve } from 'node:path'
 import { ISLANDS_IMPORTMAP_AND_BOOTSTRAP } from '../islands/importmap.ts'
 
@@ -21,7 +21,8 @@ export interface NativeRouteEmitOpts {
   flatRoutes: { nativeTemplate?: string }[]
   /** `.brust/jinja` absolute output dir. Created if missing. */
   outDir: string
-  /** Repo root — used to resolve the `jsx-rustc` binary. */
+  /** Repo root. Retained for call-site compatibility; native compilation now
+   * goes through the napi addon's `compileJsx`, not a target/ binary. */
   repoRoot: string
 }
 
@@ -45,20 +46,23 @@ export async function emitNativeTemplates(opts: NativeRouteEmitOpts): Promise<vo
 
   const nativeRoutes = opts.flatRoutes.filter((r) => r.nativeTemplate)
 
-  // Resolve jsx-rustc binary: prefer release, fall back to debug.
-  const jsxRustcRelease = resolve(opts.repoRoot, 'target/release/jsx-rustc')
-  const jsxRustcDebug = resolve(opts.repoRoot, 'target/debug/jsx-rustc')
-  const jsxRustc = existsSync(jsxRustcRelease)
-    ? jsxRustcRelease
-    : existsSync(jsxRustcDebug)
-      ? jsxRustcDebug
-      : null
-
-  if (!jsxRustc && nativeRoutes.length > 0) {
-    throw new Error(
-      'jsx-rustc binary not found in target/{release,debug}/; ' +
-        'run `cargo build -p jsx-rust-compiler --bin jsx-rustc`',
-    )
+  // Compile through the napi addon's `compileJsx` rather than spawning the
+  // `jsx-rustc` binary. The binary only exists in the source tree's target/
+  // dir, so spawning it broke `native: true` routes in a published npm install;
+  // the addon (`.node`) ships with every platform package, so this path works
+  // for source builds and installed projects alike.
+  let compileJsx:
+    | ((source: string, path: string) => { template: string; islandsJson: string })
+    | null = null
+  if (nativeRoutes.length > 0) {
+    const native = await import('../index.js')
+    compileJsx = (native as { compileJsx?: typeof compileJsx }).compileJsx ?? null
+    if (typeof compileJsx !== 'function') {
+      throw new Error(
+        'brust: the native addon does not expose compileJsx — rebuild it with ' +
+          '`cd runtime && bun run build` (or update brustjs to a build that ships it).',
+      )
+    }
   }
 
   const importMap =
@@ -75,26 +79,27 @@ export async function emitNativeTemplates(opts: NativeRouteEmitOpts): Promise<vo
       continue
     }
     const outPath = resolve(opts.outDir, `${name}.jinja`)
-    const result = Bun.spawnSync({
-      cmd: [jsxRustc!, sourcePath, '-o', outPath],
-      stdout: 'pipe',
-      stderr: 'pipe',
-    })
-    if (result.exitCode !== 0) {
-      const stderr = result.stderr ? new TextDecoder().decode(result.stderr) : ''
-      const stdout = result.stdout ? new TextDecoder().decode(result.stdout) : ''
-      throw new Error(`jsx-rustc failed for ${sourcePath}:\n${stdout}\n${stderr}`)
+    let compiled: { template: string; islandsJson: string }
+    try {
+      compiled = compileJsx!(readFileSync(sourcePath, 'utf8'), sourcePath)
+    } catch (e) {
+      throw new Error(`native route "${name}" failed to compile (${sourcePath}):\n${String(e)}`)
     }
+    writeFileSync(outPath, compiled.template)
     built.push(name)
 
-    // Islands post-processing. jsx-rustc writes `<Name>.islands.json` ONLY when
-    // the route uses <Island>; absent file ⇒ no islands ⇒ leave the .jinja
-    // byte-identical (no-island regression).
+    // Islands post-processing. The compiler reports an island manifest ONLY
+    // when the route uses <Island>; `"[]"` ⇒ no islands ⇒ leave the .jinja
+    // byte-identical (no-island regression). Remove any stale sibling so a
+    // route that dropped its islands doesn't reconcile against an old manifest.
     const islandsJsonPath = resolve(opts.outDir, `${name}.islands.json`)
-    if (existsSync(islandsJsonPath)) {
+    if (compiled.islandsJson && compiled.islandsJson !== '[]') {
+      writeFileSync(islandsJsonPath, compiled.islandsJson)
       // Island source paths resolve from the PAGE file's own imports.
       const pageImports = scanImports(sourcePath)
       reconcileIslandManifest(outPath, islandsJsonPath, pageImports, name)
+    } else if (existsSync(islandsJsonPath)) {
+      rmSync(islandsJsonPath, { force: true })
     }
   }
 

package/runtime/cli/templates/minimal/README.md.tmpl

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-Scaffolded with `brust new`.
+Scaffolded with `brustjs new`.
 
 ## Develop
 

package/runtime/cli/templates/minimal/components/Counter.tsx

@@ -1,13 +1,15 @@
+'use client'
 import { useState } from 'react'
 
 export default function Counter({ start = 0, label = 'count' }: { start?: number; label?: string }) {
-  const [n, setN] = useState(start)
+  const [count, setCount] = useState(start)
   return (
     <button
-      onClick={() => setN(n + 1)}
-      className="px-3 py-1.5 bg-brand text-white rounded text-sm hover:opacity-90 transition-opacity"
+      type="button"
+      onClick={() => setCount((c) => c + 1)}
+      className="rounded border px-3 py-1 hover:bg-gray-50"
     >
-      {label}: {n}
+      {label}: {count}
     </button>
   )
 }

package/runtime/cli/templates/minimal/package.json.tmpl

@@ -10,7 +10,8 @@
   "dependencies": {
     "brustjs": __BRUST_DEP__,
     "react": "^19.2.6",
-    "react-dom": "^19.2.6"
+    "react-dom": "^19.2.6",
+    "tailwindcss": "^4.3.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/runtime/cli/templates/minimal/pages/Home.tsx.tmpl

@@ -1,16 +1,54 @@
 import { Island } from 'brustjs'
-import Layout from '../components/Layout'
 import Counter from '../components/Counter'
 
-export default function Home() {
+// `native: true` page — compiled to a jinja template and rendered in Rust
+// (minijinja), no React on the server. Native pages use host elements only (no
+// custom components like Layout), so the document shell is written inline here;
+// the Tailwind stylesheet is linked directly. Each island's `props` is a path
+// into the route loader's return value.
+export default function Home({
+  clientProps,
+  serverProps,
+}: {
+  clientProps: { start: number; label: string }
+  serverProps: { start: number; label: string }
+}) {
   return (
-    <Layout title="__PROJECT_NAME__">
-      <h1 className="text-3xl font-bold mb-4">Welcome to brust</h1>
-      <p className="mb-4 text-gray-700">
-        Edit <code className="bg-gray-100 px-1 rounded">pages/Home.tsx</code> and save —
-        <code className="bg-gray-100 px-1 rounded ml-1">brustjs dev</code> will reload.
-      </p>
-      <Island component={Counter} props={{ start: 0, label: 'clicks' }} hydrate="load" />
-    </Layout>
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>__PROJECT_NAME__</title>
+        <link rel="stylesheet" href="/_brust/css/app.css" />
+      </head>
+      <body className="bg-white text-gray-900 font-sans">
+        <main className="max-w-3xl mx-auto px-5 py-8">
+          <h1 className="text-3xl font-bold mb-4">Welcome to Brust</h1>
+          <p className="mb-6 text-gray-700">
+            This page is a <strong>native route</strong> — its shell is rendered in Rust
+            (minijinja), no React on the server. The counters below are{' '}
+            <strong>islands</strong>: only their subtrees boot React in the browser. Edit{' '}
+            <code className="bg-gray-100 px-1 rounded">pages/Home.tsx</code> and save —{' '}
+            <code className="bg-gray-100 px-1 rounded">brustjs dev</code> reloads.
+          </p>
+
+          <section className="mb-6">
+            <h2 className="text-xl font-semibold mb-1">Client island</h2>
+            <p className="mb-2 text-sm text-gray-600">
+              No server markup; mounts and hydrates in the browser.
+            </p>
+            <Island component={Counter} props={clientProps} hydrate="load" />
+          </section>
+
+          <section>
+            <h2 className="text-xl font-semibold mb-1">Server island (SSR + hydrate)</h2>
+            <p className="mb-2 text-sm text-gray-600">
+              Rendered on the server during the loader crossing, then hydrated — no empty flash.
+            </p>
+            <Island component={Counter} props={serverProps} ssr hydrate="load" />
+          </section>
+        </main>
+      </body>
+    </html>
   )
 }

package/runtime/cli/templates/minimal/routes.tsx

@@ -1,6 +1,17 @@
-import { defineRoutes } from 'brust/routes'
+import { defineRoutes } from 'brustjs/routes'
 import Home from './pages/Home'
 
 export const routes = defineRoutes([
-  { path: '/', Component: Home },
-])
+  // `native: true` — Home is compiled to a jinja template and rendered in Rust
+  // (no React on the server). The loader's return value is the template
+  // context; each island's `props` is a path into it.
+  {
+    path: '/',
+    Component: Home,
+    native: true,
+    loader: async () => ({
+      clientProps: { start: 0, label: 'client clicks' },
+      serverProps: { start: 100, label: 'server clicks' },
+    }),
+  },
+] as const)

package/runtime/create.ts

@@ -0,0 +1,4 @@
+// Public entry for the `create-brustjs` package (`bun create brustjs <dir>`).
+// Kept as a thin re-export so the create package never reaches into brust's
+// CLI internals and the templates stay owned by this package alone.
+export { runNew } from './cli/new.ts'

package/runtime/css/build.ts

@@ -1,16 +1,25 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises'
 import path from 'node:path'
+import { createRequire } from 'node:module'
 import { compile } from '@tailwindcss/node'
 import { Scanner } from '@tailwindcss/oxide'
 
-/** The directory that contains this file — runtime/css/. Two dirname() steps
- * reach the brust repo root where node_modules/tailwindcss is installed. */
-const BRUST_ROOT = path.resolve(import.meta.dir, '..', '..')
-
-/** Absolute path to tailwindcss/index.css inside brust's own node_modules.
- * Used by the customCssResolver so that `@import "tailwindcss"` always
- * resolves via brust's bundled copy regardless of where the entry CSS lives. */
-const TAILWINDCSS_INDEX = path.join(BRUST_ROOT, 'node_modules', 'tailwindcss', 'index.css')
+/** Resolve `tailwindcss/index.css` starting from `fromDir`. Uses package.json
+ * resolution (always present, unlike index.css in the exports map) then joins
+ * index.css. Returns undefined if tailwindcss is not installed in that context.
+ *
+ * Tailwind is an opt-in dependency of the *consumer* project (the scaffold
+ * declares it), NOT a hard dependency of brust core — so we resolve it from
+ * the entry CSS's project first, falling back to brust's own context (which
+ * covers the dev repo and unit tests where tailwindcss is hoisted). */
+function resolveTailwindIndex(fromDir: string): string | undefined {
+  try {
+    const req = createRequire(path.join(fromDir, '__brust_resolve__.js'))
+    return path.join(path.dirname(req.resolve('tailwindcss/package.json')), 'index.css')
+  } catch {
+    return undefined
+  }
+}
 
 export interface BuildCssOptions {
   /** Absolute path to the entry CSS file (typically <scanRoot>/app.css). */
@@ -33,12 +42,13 @@ export async function buildCss(opts: BuildCssOptions): Promise<CssBuildResult> {
     // the same folder the CSS lives in).
     base: path.dirname(opts.entry),
     onDependency: () => {}, // unused — no watch
-    // Redirect `@import "tailwindcss"` to brust's own bundled copy so
-    // resolution succeeds even when tailwindcss is not installed in the
-    // entry directory (e.g. a tmp dir in tests).
+    // Resolve `@import "tailwindcss"` to the consumer project's own copy
+    // (resolved from the entry CSS's directory), falling back to brust's own
+    // context — the latter covers the dev repo and unit tests where the entry
+    // lives in a tmp dir without its own tailwindcss install.
     customCssResolver: async (id: string) => {
-      if (id === 'tailwindcss') return TAILWINDCSS_INDEX
-      return undefined
+      if (id !== 'tailwindcss') return undefined
+      return resolveTailwindIndex(path.dirname(opts.entry)) ?? resolveTailwindIndex(import.meta.dir)
     },
   })
 

package/runtime/dev/tui.ts

@@ -1,14 +1,12 @@
 const ESC = '\x1b['
-const HIDE_CURSOR = ESC + '?25l'
-const SHOW_CURSOR = ESC + '?25h'
-const CLEAR_SCREEN = ESC + '2J' + ESC + 'H'
 const RESET = ESC + '0m'
 const DIM = ESC + '2m'
 const BRAND = ESC + '38;2;138;51;36m'
 const GREEN = ESC + '32m'
 const RED = ESC + '31m'
-const YELLOW = ESC + '33m'
+const BAR = BRAND + '┃' + RESET
 
+const VERSION = '0.1.0'
 const DEFAULT_CAPACITY = 10
 
 interface Status {
@@ -23,11 +21,14 @@ export interface TuiOptions {
   capacity?: number
 }
 
+/** Astro-style dev output: a clean one-time banner on ready, then event lines
+ * that scroll naturally below it. Deliberately NOT a full-screen TUI — it never
+ * hides the cursor or clears the screen, so the terminal is left exactly as it
+ * was found when the dev server exits (no more vanished cursor on Ctrl-C). */
 export class Tui {
   private events: string[] = []
-  private status: Status | null = null
   private capacity: number
-  private state: 'idle' | 'building' | 'failed' = 'idle'
+  private bannerShown = false
 
   constructor(private opts: TuiOptions) {
     this.capacity = opts.capacity ?? DEFAULT_CAPACITY
@@ -37,73 +38,66 @@ export class Tui {
     return [...this.events]
   }
 
+  /** Print the ready banner. Idempotent — only the first call emits it. */
   updateStatus(s: Status): void {
-    this.status = s
-    this.render()
-  }
+    if (this.bannerShown) return
+    this.bannerShown = true
 
-  setState(s: 'idle' | 'building' | 'failed'): void {
-    this.state = s
-    this.render()
+    if (!this.opts.isTty) {
+      this.opts.write(
+        `brust ${VERSION} · dev — http://127.0.0.1:${s.port}/ (workers: ${s.workers})\n`,
+      )
+      return
+    }
+
+    const lines = [
+      '',
+      ` ${BRAND}brust${RESET}  ${DIM}v${VERSION}${RESET}`,
+      '',
+      ` ${BAR} ${DIM}Local${RESET}      http://127.0.0.1:${s.port}/`,
+      ` ${BAR} ${DIM}Workers${RESET}    ${s.workers}`,
+      ` ${BAR} ${DIM}Watching${RESET}   ${s.watching.join(', ')}`,
+      '',
+      '',
+    ]
+    this.opts.write(lines.join('\n'))
   }
 
+  /** Append one event. Scrolls below the banner (TTY) or prints a plain line
+   * (non-TTY / CI). The in-memory ring buffer backs `eventsForTests`. */
   appendEvent(line: string): void {
     this.events.push(line)
     if (this.events.length > this.capacity) this.events.shift()
-    this.render()
-  }
 
-  stop(): void {
-    if (this.opts.isTty) this.opts.write(SHOW_CURSOR + RESET)
-  }
-
-  private render(): void {
     if (!this.opts.isTty) {
-      const latest = this.events[this.events.length - 1]
-      if (latest) this.opts.write(latest + '\n')
+      this.opts.write(line + '\n')
       return
     }
-    let out = HIDE_CURSOR + CLEAR_SCREEN
-    out += this.renderHeader()
-    out += this.renderEvents()
-    out += this.renderStatusBar()
-    this.opts.write(out)
+    this.opts.write(this.format(line) + '\n')
   }
 
-  private renderHeader(): string {
-    if (!this.status) return BRAND + 'brust 0.1.0 · dev mode' + RESET + '\n\n'
-    return (
-      BRAND +
-      'brust 0.1.0 · dev mode' +
-      RESET +
-      '\n' +
-      DIM +
-      'port:     ' +
-      RESET +
-      this.status.port +
-      '\n' +
-      DIM +
-      'workers:  ' +
-      RESET +
-      this.status.workers +
-      '\n' +
-      DIM +
-      'watching: ' +
-      RESET +
-      this.status.watching.join(', ') +
-      '\n\n'
-    )
+  /** Called on shutdown. There is nothing to restore (we never altered the
+   * terminal mode); the reset is belt-and-braces so a half-written colored
+   * line can't bleed into the user's prompt. */
+  stop(): void {
+    if (this.opts.isTty) this.opts.write(RESET)
   }
 
-  private renderEvents(): string {
-    let out = ''
-    for (const ev of this.events) out += ev + '\n'
-    return out + '\n'
+  /** Colorize an event line in TTY mode: a dim timestamp prefix, with ok/error
+   * markers tinted. The coordinator emits `  → ok (Nms)` and `  ✗ <msg>`. */
+  private format(line: string): string {
+    const ts = `${DIM}${timestamp()}${RESET} `
+    const trimmed = line.trimStart()
+    if (trimmed.startsWith('✗')) return ts + RED + line.trim() + RESET
+    if (trimmed.startsWith('→ ok') || trimmed.startsWith('ok')) {
+      return ts + GREEN + line.trim() + RESET
+    }
+    return ts + line
   }
+}
 
-  private renderStatusBar(): string {
-    if (this.state === 'building') return YELLOW + '◉ Building…' + RESET + '\n'
-    if (this.state === 'failed') return RED + '✗ Build failed' + RESET + '\n'
-    return GREEN + '◉ Serving' + RESET + '\n'
-  }
+function timestamp(): string {
+  const d = new Date()
+  const p = (n: number) => String(n).padStart(2, '0')
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`
 }

package/runtime/index.d.ts

@@ -2,6 +2,14 @@
 /* eslint-disable */
 export declare function beginServe(opts: ServeOptions): NapiResult<undefined>
 
+/**
+ * Compile a single native-route source to its jinja template + island
+ * manifest. `path` is used only in error messages. Mirrors `jsx-rustc`'s
+ * `compile_full` + `islands_to_json` so the TS emit step can write the same
+ * `<Name>.jinja` and `<Name>.islands.json` files.
+ */
+export declare function compileJsx(source: string, path: string): NapiCompiledJsx
+
 export declare function configureCache(maxEntries: number): NapiResult<undefined>
 
 export declare function configureCssDir(path: string): NapiResult<undefined>
@@ -10,6 +18,17 @@ export declare function configureIslandsDir(path: string): NapiResult<undefined>
 
 export declare function isWorker(): boolean
 
+/** Result of compiling one `pages/<Name>.tsx` source. */
+export interface NapiCompiledJsx {
+  /** The emitted jinja template. */
+  template: string
+  /**
+   * Island manifest as JSON (`"[]"` when the route uses no `<Island>`). The
+   * camelCase keys match `RawIslandEntry` in native-routes-emit.ts.
+   */
+  islandsJson: string
+}
+
 /**
  * Sub-project J — boot-time listing of registered minijinja templates.
  * JS dispatcher uses this to validate every `native: true` route's

package/runtime/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-android-arm64')
         const bindingPackageVersion = require('brustjs-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-android-arm-eabi')
         const bindingPackageVersion = require('brustjs-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-x64-gnu')
         const bindingPackageVersion = require('brustjs-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-x64-msvc')
         const bindingPackageVersion = require('brustjs-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-ia32-msvc')
         const bindingPackageVersion = require('brustjs-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-arm64-msvc')
         const bindingPackageVersion = require('brustjs-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('brustjs-darwin-universal')
       const bindingPackageVersion = require('brustjs-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-darwin-x64')
         const bindingPackageVersion = require('brustjs-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-darwin-arm64')
         const bindingPackageVersion = require('brustjs-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-freebsd-x64')
         const bindingPackageVersion = require('brustjs-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-freebsd-arm64')
         const bindingPackageVersion = require('brustjs-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-x64-musl')
           const bindingPackageVersion = require('brustjs-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-x64-gnu')
           const bindingPackageVersion = require('brustjs-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm64-musl')
           const bindingPackageVersion = require('brustjs-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm64-gnu')
           const bindingPackageVersion = require('brustjs-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm-musleabihf')
           const bindingPackageVersion = require('brustjs-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('brustjs-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-loong64-musl')
           const bindingPackageVersion = require('brustjs-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-loong64-gnu')
           const bindingPackageVersion = require('brustjs-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-riscv64-musl')
           const bindingPackageVersion = require('brustjs-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-riscv64-gnu')
           const bindingPackageVersion = require('brustjs-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-linux-ppc64-gnu')
         const bindingPackageVersion = require('brustjs-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-linux-s390x-gnu')
         const bindingPackageVersion = require('brustjs-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-arm64')
         const bindingPackageVersion = require('brustjs-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-x64')
         const bindingPackageVersion = require('brustjs-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-arm')
         const bindingPackageVersion = require('brustjs-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.0-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0-alpha.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0-alpha.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -577,6 +577,7 @@ if (!nativeBinding) {
 
 module.exports = nativeBinding
 module.exports.beginServe = nativeBinding.beginServe
+module.exports.compileJsx = nativeBinding.compileJsx
 module.exports.configureCache = nativeBinding.configureCache
 module.exports.configureCssDir = nativeBinding.configureCssDir
 module.exports.configureIslandsDir = nativeBinding.configureIslandsDir

package/runtime/index.ts

@@ -419,8 +419,8 @@ export const brust = {
           isTty: process.stdout.isTTY === true,
           write: (s: string) => process.stdout.write(s),
         })
+        // The banner's "Local" line is the ready signal — no separate event.
         tui.updateStatus({ port, workers, watching: [scanRoot] })
-        tui.appendEvent(`▶ serving on http://127.0.0.1:${port}`)
 
         const coordinator = new Coordinator({
           workers: {

package/runtime/cli/templates/minimal/components/Layout.tsx

@@ -1,16 +0,0 @@
-import type { ReactNode } from 'react'
-
-export default function Layout({ title, children }: { title: string; children: ReactNode }) {
-  return (
-    <html lang="en">
-      <head>
-        <meta charSet="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>{title}</title>
-      </head>
-      <body className="bg-white text-gray-900 font-sans">
-        <main className="max-w-3xl mx-auto px-5 py-8">{children}</main>
-      </body>
-    </html>
-  )
-}