brustjs 0.1.2-alpha → 0.1.4-alpha

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brustjs",
-  "version": "0.1.2-alpha",
+  "version": "0.1.4-alpha",
   "description": "Bun + Rust SSR framework — React on the server, Rust everywhere else (napi cdylib + per-worker SharedArrayBuffer).",
   "license": "MIT",
   "repository": {
@@ -40,12 +40,12 @@
     "typescript": "^6.0.3"
   },
   "optionalDependencies": {
-    "brustjs-darwin-x64": "0.1.2-alpha",
-    "brustjs-darwin-arm64": "0.1.2-alpha",
-    "brustjs-linux-x64-gnu": "0.1.2-alpha",
-    "brustjs-linux-arm64-gnu": "0.1.2-alpha",
-    "brustjs-linux-x64-musl": "0.1.2-alpha",
-    "brustjs-linux-arm64-musl": "0.1.2-alpha"
+    "brustjs-darwin-x64": "0.1.4-alpha",
+    "brustjs-darwin-arm64": "0.1.4-alpha",
+    "brustjs-linux-x64-gnu": "0.1.4-alpha",
+    "brustjs-linux-arm64-gnu": "0.1.4-alpha",
+    "brustjs-linux-x64-musl": "0.1.4-alpha",
+    "brustjs-linux-arm64-musl": "0.1.4-alpha"
   },
   "peerDependencies": {
     "react": "^19.2.6",

package/runtime/cli/dev.ts

@@ -79,11 +79,29 @@ export async function runDev(args: string[]): Promise<void> {
   // reads from `cwd + '.brust/jinja'`. When user runs `bun run dev
   // example/hello-world/index.ts` from repo root, cwd != entryDir; writing
   // to entryDir would put templates somewhere the runtime never looks.
-  await emitNativeTemplates({
+  const jinjaDir = path.join(process.cwd(), '.brust/jinja')
+  const emitOpts = {
     entryFile: existsSync(routesFile) ? routesFile : entry,
     flatRoutes: loadedRoutes as { nativeTemplate?: string }[],
-    outDir: path.join(process.cwd(), '.brust/jinja'),
+    outDir: jinjaDir,
     repoRoot: REPO_ROOT,
+  }
+  await emitNativeTemplates(emitOpts)
+
+  // Native-route HMR: on a ts/html/islands hot reload the dev coordinator calls
+  // this to recompile the .jinja templates from the (edited) source and reload
+  // them into the minijinja env — so `native: true` routes pick up edits without
+  // a dev-server restart. The runtime (loaded by the entry import below) holds
+  // napiLoadJinjaTemplates via the napi loader at `../index.js`; the Rust env is
+  // a reloadable RwLock. Adding/removing routes still needs a restart (the route
+  // structure is captured here at startup).
+  const { registerJinjaReEmit } = await import('../dev/jinja-reload.ts')
+  registerJinjaReEmit(async () => {
+    await emitNativeTemplates(emitOpts)
+    const native = await import('../index.js')
+    ;(native as { napiLoadJinjaTemplates: (dir: string) => unknown }).napiLoadJinjaTemplates(
+      jinjaDir,
+    )
   })
 
   // Hand off to the user's entry. It calls brust.run() which, with

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

@@ -1,7 +1,29 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { dirname, resolve } from 'node:path'
+import { buildDevClientTag } from '../dev/client.ts'
 import { ISLANDS_IMPORTMAP_AND_BOOTSTRAP } from '../islands/importmap.ts'
 
+/** Dev-only: splice the /_brust/dev WS client `<script>` into a compiled native
+ * template so `native: true` (jinja) routes auto-reload like React-SSR routes.
+ *
+ * Native routes render Rust-side on the fast lane, bypassing the React renderer
+ * that injects the dev client (runtime/render/stream.ts) — so without this the
+ * browser on a native page never opens the dev WS and can never auto-reload.
+ *
+ * Inserted before the first `</head>` when the page has one (a `<BrustPage>`
+ * shell); otherwise appended (bare-fragment pages like a plain `<div>`). The
+ * browser executes the module script in either position. Gated on `BRUST_DEV`
+ * so `brust build` never bakes it into production templates. */
+function injectDevClientIntoTemplate(template: string): string {
+  const tag = buildDevClientTag()
+  if (template.includes(tag)) return template // idempotent across re-emits
+  const headClose = template.indexOf('</head>')
+  if (headClose !== -1) {
+    return template.slice(0, headClose) + tag + template.slice(headClose)
+  }
+  return template + tag
+}
+
 /** Sub-project J — build pass that turns user's `pages/<Name>.tsx` files into
  * `.brust/jinja/<Name>.jinja` templates. Invoked from `brust build` and
  * `brust dev` after the user's routes are flattened.
@@ -85,7 +107,14 @@ export async function emitNativeTemplates(opts: NativeRouteEmitOpts): Promise<vo
     } catch (e) {
       throw new Error(`native route "${name}" failed to compile (${sourcePath}):\n${String(e)}`)
     }
-    writeFileSync(outPath, compiled.template)
+    // Dev-only: native routes don't pass through the React renderer's dev-client
+    // injection, so splice the /_brust/dev WS script in here. reEmitJinja() runs
+    // this on every hot reload, so the script is always present in dev.
+    const template =
+      process.env.BRUST_DEV === '1'
+        ? injectDevClientIntoTemplate(compiled.template)
+        : compiled.template
+    writeFileSync(outPath, template)
     built.push(name)
 
     // Islands post-processing. The compiler reports an island manifest ONLY

package/runtime/dev/coordinator.ts

@@ -8,6 +8,9 @@ export interface CoordinatorDeps {
   }
   buildCss: () => Promise<void>
   buildIslands: () => Promise<void>
+  /** Recompile native-route `.jinja` templates from source and reload them into
+   * the minijinja env, so `native: true` routes pick up .tsx edits on reload. */
+  reEmitJinja: () => Promise<void>
   buildComponentCss?: () => Promise<void>
   snapshotComponentCss?: () => Promise<import('../css/manifest.ts').ComponentCssManifest | null>
   broadcast: (msg: DevMessage) => Promise<void> | void
@@ -33,12 +36,16 @@ export class Coordinator {
         case 'html':
           await this.deps.workers.terminateAll()
           await this.deps.workers.spawnAll()
+          // Reload native-route templates (process-global minijinja env — does
+          // not depend on the workers) just before telling the browser to reload.
+          await this.deps.reEmitJinja()
           await this.deps.broadcast({ type: 'reload' })
           break
         case 'islands':
           await this.deps.buildIslands()
           await this.deps.workers.terminateAll()
           await this.deps.workers.spawnAll()
+          await this.deps.reEmitJinja()
           await this.deps.broadcast({ type: 'reload' })
           break
         case 'css':

package/runtime/dev/jinja-reload.ts

@@ -0,0 +1,31 @@
+// Dev-only bridge for hot-reloading native-route `.jinja` templates.
+//
+// `brust dev` (cli/dev.ts) emits the native-route templates once at startup,
+// then registers a callback here that re-emits them from the (now edited)
+// source and reloads them into the minijinja env in the napi addon. The dev
+// coordinator calls `reEmitJinja()` on every ts/html/islands hot reload so
+// `native: true` routes pick up source edits instead of serving the stale
+// template until the dev server is restarted. (The Rust side supports reload —
+// see crates/brust/src/jinja.rs, RwLock not OnceLock.)
+//
+// A registry singleton (like worker-registry) rather than a direct import,
+// because the producer (cli/dev.ts) and the consumer (the coordinator, wired in
+// index.ts) live in different layers and only meet at runtime in `brust dev`.
+
+let _reEmit: (() => Promise<void>) | null = null
+
+/** Called once by `brust dev` after the initial native-template emit. */
+export function registerJinjaReEmit(fn: () => Promise<void>): void {
+  _reEmit = fn
+}
+
+/** Called by the dev coordinator on a ts/html/islands hot reload. No-op when no
+ * callback is registered (e.g. unit tests, or an app with no native routes). */
+export async function reEmitJinja(): Promise<void> {
+  if (_reEmit) await _reEmit()
+}
+
+/** Test helper. */
+export function _resetForTests(): void {
+  _reEmit = null
+}

package/runtime/dev/ws-channel.ts

@@ -81,19 +81,18 @@ export function installWorkerBroadcastListener(): void {
   }
 }
 
-/** Main-side: relay the message to every worker via postMessage. Each
- * worker's installed message listener forwards to its local clients.
- * Per-worker postMessage failures are swallowed (worker may be already
- * terminating). */
+/** Main-side: push the message to every `/_brust/dev` client through the napi
+ * addon. The dev WS is a Rust-owned control channel (see the `/_brust/dev`
+ * branch in crates/brust/src/server.rs), so the frame is delivered straight
+ * through each connection's Rust-owned send_tx and SURVIVES a hot reload's
+ * worker restart.
+ *
+ * The previous implementation relayed main→worker→worker-local-clients, which
+ * lost the `reload` frame: the coordinator broadcasts it AFTER terminateAll(),
+ * by which point the connection's worker-side registration had died with the
+ * old worker. */
 export async function broadcast(msg: DevMessage): Promise<void> {
   const json = JSON.stringify(msg)
-  const { _workersForTests } = await import('./worker-registry.ts')
-  const workers = _workersForTests()
-  for (const w of workers) {
-    try {
-      w.postMessage({ type: 'dev-broadcast', json })
-    } catch {
-      /* worker already terminated; drop */
-    }
-  }
+  const native = await import('../index.js')
+  ;(native as { napiDevBroadcast?: (json: string) => void }).napiDevBroadcast?.(json)
 }

package/runtime/index.d.ts

@@ -29,6 +29,18 @@ export interface NapiCompiledJsx {
   islandsJson: string
 }
 
+/**
+ * Dev-mode: broadcast one JSON control frame (building / reload / css-update /
+ * error / ok) to every connected `/_brust/dev` client. Called from the main
+ * thread by the dev coordinator. A no-op when no dev client is connected.
+ *
+ * Delivery goes straight through each connection's Rust-owned `send_tx`, so it
+ * survives a hot reload's worker restart — unlike the old worker-relay path,
+ * which lost the `reload` frame because the terminated worker took the client
+ * registration with it.
+ */
+export declare function napiDevBroadcast(json: string): void
+
 /**
  * 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha 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.2-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.2-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.4-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.4-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -582,6 +582,7 @@ module.exports.configureCache = nativeBinding.configureCache
 module.exports.configureCssDir = nativeBinding.configureCssDir
 module.exports.configureIslandsDir = nativeBinding.configureIslandsDir
 module.exports.isWorker = nativeBinding.isWorker
+module.exports.napiDevBroadcast = nativeBinding.napiDevBroadcast
 module.exports.napiListNativeTemplates = nativeBinding.napiListNativeTemplates
 module.exports.napiLoadJinjaTemplates = nativeBinding.napiLoadJinjaTemplates
 module.exports.napiRegisterSsePaths = nativeBinding.napiRegisterSsePaths

package/runtime/index.ts

@@ -42,10 +42,12 @@ export function workerId(): number | null {
   return (native as any).workerId()
 }
 
-// Sub-project J — boot-time jinja loader. Idempotent: Rust holds the loaded
-// templates in a OnceLock, so a second `set()` would panic. The flag guards
-// repeated calls in both main and worker branches of `run()`, and from any
-// future test/embedded entrypoint that calls `registerRoutes` directly.
+// Sub-project J — boot-time jinja loader. The flag guards repeated calls across
+// the main and worker branches of `run()` (and any embedded entrypoint that
+// calls `registerRoutes` directly) so the env loads once at startup. Dev hot
+// reload does NOT go through here — it reloads via reEmitJinja, which calls
+// napiLoadJinjaTemplates directly (the Rust env is a reloadable RwLock now, not
+// a load-once OnceLock).
 let _jinjaLoaded = false
 function loadJinjaOnce(dir: string): void {
   if (_jinjaLoaded) return
@@ -380,7 +382,7 @@ export const brust = {
 
       // Sub-project J — load .brust/jinja/*.jinja into the minijinja env so
       // the startup-validation warning in registerRoutes can compare against
-      // a populated registry. Idempotent (Rust uses OnceLock).
+      // a populated registry. Loads once at startup; dev hot reload reloads it.
       loadJinjaOnce(path.resolve(process.cwd(), '.brust/jinja'))
 
       this.registerRoutes(routes)
@@ -412,6 +414,7 @@ export const brust = {
         const { terminateAll: termWorkers, spawnAll: spawnWorkers } = await import(
           './dev/worker-registry.ts'
         )
+        const { reEmitJinja } = await import('./dev/jinja-reload.ts')
         const fsModule = await import('node:fs')
         const pathModule = await import('node:path')
 
@@ -445,6 +448,7 @@ export const brust = {
               await spawnWorkers()
             },
           },
+          reEmitJinja,
           buildCss: async () => {
             const appCss = pathModule.join(scanRoot, 'app.css')
             if (fsModule.existsSync(appCss)) {