brustjs 0.1.54-alpha → 0.1.56-alpha

package/package.json

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

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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-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.54-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.54-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.56-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.56-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/runtime/index.ts

@@ -461,6 +461,17 @@ export const brust = {
     const scanRoot = opts.scanRoot ?? path.dirname(fileURLToPath(opts.entry))
 
     const dev = opts.dev === true || process.env.BRUST_DEV === '1'
+    // Unify the `dev: true` option with the BRUST_DEV env signal. The dev
+    // coordinator/watcher (which calls worker-registry spawnAll() on hot reload)
+    // keys off this `dev` variable, but serve()'s registerInitialPool — plus
+    // every other `process.env.BRUST_DEV === '1'` gate (dev-client injection,
+    // store/css `no-store`, cookie dev warnings) — keys off the env var ALONE.
+    // The `brust dev` CLI sets BRUST_DEV=1; the programmatic `run({ dev: true })`
+    // path must too, or hot reload calls spawnAll() against a pool that
+    // registerInitialPool() never recorded ("spawnAll called before
+    // registerInitialPool"). Set it here, before serve() spawns workers, so they
+    // inherit it via baseEnv.
+    if (dev) process.env.BRUST_DEV = '1'
     let routes = opts.routes
     if (dev) {
       const { createDevWsRoute } = await import('./dev/ws-channel.ts')

package/runtime/navigation/server-context.ts

@@ -0,0 +1,22 @@
+// runtime/navigation/server-context.ts
+// Server-only: imports a Node builtin (node:async_hooks), so it must NOT be
+// reachable from browser/island bundles (brustjs/client) or the React-free,
+// DOM-free navigation entry (brustjs/navigation = ./index.ts). It mirrors
+// store/server-context.ts: the server pulls this module in via routes.ts, where
+// each render is wrapped in a per-request nav scope; navigation/store.ts reaches
+// the active scope through the resolver registered below (__setServerNavResolver),
+// which stays out of the client bundle (store.ts never imports this file).
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { __setServerNavResolver, type ServerNavScope } from './store.ts'
+
+const navContext = new AsyncLocalStorage<ServerNavScope>()
+
+/** Open a per-request nav scope so SSR — React islands AND native island SSR —
+ * sees the current request path via useNav()/getNavState() instead of the idle
+ * singleton default. `search` is the raw query string INCLUDING the leading '?'
+ * (so it matches the client's `location.search`), or '' when there is none. */
+export function runInNavContext<T>(path: string, search: string, fn: () => T): T {
+  return navContext.run({ path, search }, fn)
+}
+
+__setServerNavResolver(() => navContext.getStore())

package/runtime/navigation/store.ts

@@ -101,7 +101,46 @@ export const nav: NavStore = new Proxy({} as NavStore, {
   },
 })
 
+// ─── Server-side request-scoped path (SSR seeding) ──────────────────────────
+// The `nav` singleton is shared by every concurrent request in a worker, so on
+// the server it CANNOT hold a per-request path. A server-only module
+// (navigation/server-context.ts) registers a resolver that returns the active
+// request's nav scope via AsyncLocalStorage — mirroring store/server-context.ts'
+// __setServerResolver. The resolver stays null in browser/island bundles (which
+// never import the Node module), so client behavior is byte-identical.
+export interface ServerNavScope {
+  path: string
+  search: string
+  // Per-scope memo of the built NavState: getServerSnapshot may be called more
+  // than once per render and useSyncExternalStore requires referential stability.
+  _snap?: NavState
+}
+let serverNavResolver: (() => ServerNavScope | undefined) | null = null
+export function __setServerNavResolver(fn: () => ServerNavScope | undefined): void {
+  serverNavResolver = fn
+}
+
 export function getNavState(): NavState {
+  // Server SSR: when a request-scoped nav context is active, derive path/search
+  // from it (the singleton is not per-request-safe). `phase` is always 'idle'
+  // during SSR — no navigation is in flight — and from/to/error stay null. The
+  // client then seeds the SAME path via __navInit before hydration, so
+  // getServerSnapshot (this getter) and the server HTML agree → no mismatch,
+  // active from first paint.
+  const scope = serverNavResolver?.()
+  if (scope) {
+    if (!scope._snap) {
+      scope._snap = {
+        path: canonicalPath(scope.path),
+        search: scope.search,
+        phase: 'idle',
+        error: null,
+        from: null,
+        to: null,
+      }
+    }
+    return scope._snap
+  }
   const s = store()
   // Return the memoized snapshot if no transition has happened since it was
   // built (referential stability for useSyncExternalStore).

package/runtime/render/fragment.ts

@@ -19,6 +19,7 @@ import { Buffer } from 'node:buffer'
 import { runInRequestScope } from '../request-context.ts'
 import { runInRequestCache } from '../loader-cache.ts'
 import { runInStoreContext } from '../store/server-context.ts'
+import { runInNavContext } from '../navigation/server-context.ts'
 
 /** Render a React element to a single HTML string, awaiting all Suspense
  * boundaries via onAllReady. Used by navigationBranch — renderToString
@@ -59,6 +60,13 @@ export function renderToAwaitedString(element: ReactNode): Promise<string> {
 export interface RenderFragmentOpts {
   /** Request cookies visible to cookies()/session helpers inside the tree. */
   cookies?: Record<string, string>
+  /** Seed `useNav()` / `getNavState()` for islands inside the fragment. Provide
+   * when rendering for a known URL (e.g. a server-side preview of a specific
+   * route) so active-nav resolves; omit for a context-free fragment, where
+   * `useNav()` reports the idle defaults (path ''). `search` is the raw query
+   * string including the leading '?'. */
+  path?: string
+  search?: string
 }
 
 /** Render a component to an HTML string with framework contexts scoped:
@@ -76,11 +84,16 @@ export async function renderFragment<P extends object>(
   opts?: RenderFragmentOpts,
 ): Promise<string> {
   // Composition mirrors routes.ts runInRequestContext: scope outermost, then
-  // the request-scoped loader cache, then the per-call store context.
+  // the request-scoped loader cache, then the per-call store context, then —
+  // only when the caller seeds a URL — the nav scope (innermost), so useNav()
+  // inside the fragment resolves active-nav. Without opts.path, no nav scope is
+  // opened and useNav() reports idle (the context-free default).
+  const render = () =>
+    renderToAwaitedString(createElement(Component as ComponentType, props as object))
   return runInRequestScope(opts?.cookies ?? {}, () =>
     runInRequestCache(() =>
       runInStoreContext(() =>
-        renderToAwaitedString(createElement(Component as ComponentType, props as object)),
+        opts?.path !== undefined ? runInNavContext(opts.path, opts.search ?? '', render) : render(),
       ),
     ),
   )

package/runtime/routes.ts

@@ -4,6 +4,7 @@ import * as native from './index.js'
 import { renderBranchStreaming } from './render/stream.ts'
 import { renderToAwaitedString } from './render/fragment.ts'
 import { runInStoreContext, collectSnapshot } from './store/server-context.ts'
+import { runInNavContext } from './navigation/server-context.ts'
 import { buildStoreScripts } from './render/inject-store.ts'
 import { getCssHrefsForRoute } from './css.ts'
 import { runInRequestCache } from './loader-cache.ts'
@@ -45,8 +46,34 @@ export { slugifyHeading } from './md/slug.ts'
 // store scope (per-request store instance). `reqCookies` is the parsed incoming
 // Cookie header so a loader's `cookies.get` reads it and `cookies.set` stages
 // onto this scope (flushed onto response headers via flushSetCookie).
-function runInRequestContext<T>(reqCookies: Record<string, string>, fn: () => T): T {
-  return runInRequestScope(reqCookies, () => runInRequestCache(() => runInStoreContext(fn)))
+/** Raw query string (including the leading '?') of a `path+query` URL, or ''
+ * when there is none. Mirrors the client's `location.search` so the SSR-seeded
+ * nav.search matches what the client re-seeds via __navInit at hydration. */
+function searchStringOf(url: string | undefined): string {
+  if (!url) return ''
+  const q = url.indexOf('?')
+  if (q === -1) return ''
+  // Strip any fragment so the seeded nav.search matches location.search (which
+  // never includes '#...'). HTTP request lines don't carry fragments today, but
+  // this keeps searchStringOf correct-by-construction.
+  const h = url.indexOf('#', q)
+  return h === -1 ? url.slice(q) : url.slice(q, h)
+}
+
+// `navPath`/`navSearch` (optional, trailing) open a per-request nav scope so
+// island / React SSR sees the current request path via useNav()/getNavState()
+// — active-nav at first paint with no hydration flash. They default to '' (the
+// idle nav state), so loader-only / action scopes are unchanged. Trailing args
+// keep the callback in the conventional 2nd position at the bare call sites.
+function runInRequestContext<T>(
+  reqCookies: Record<string, string>,
+  fn: () => T,
+  navPath = '',
+  navSearch = '',
+): T {
+  return runInRequestScope(reqCookies, () =>
+    runInRequestCache(() => runInStoreContext(() => runInNavContext(navPath, navSearch, fn))),
+  )
 }
 
 // Sub-project J — island ISR cache, backed by the Rust-side store (shared across
@@ -1290,20 +1317,33 @@ export function makeRenderer(
         const compManifest = loadComponentManifest(flat.nativeTemplate)
         if ((manifest && manifest.length > 0) || (compManifest && compManifest.length > 0)) {
           const rt = JSON.parse(json) as Record<string, unknown>
-          const [islandExtra, componentExtra] = await Promise.all([
-            manifest && manifest.length > 0
-              ? resolveIslandContext(manifest, rt, islandCache)
-              : Promise.resolve({} as Record<string, string>),
-            compManifest && compManifest.length > 0
-              ? resolveComponentContext(
-                  compManifest,
-                  rt,
-                  flat.nativeTemplate,
-                  undefined,
-                  islandCache,
-                )
-              : Promise.resolve({} as Record<string, string>),
-          ])
+          // Capture the (narrowed) template name in this scope: the runInNavContext
+          // closure below would otherwise lose the `flat.nativeTemplate !== undefined`
+          // narrowing (TS doesn't carry control-flow narrowing into a nested fn).
+          const nativeTemplate = flat.nativeTemplate
+          // Seed the request path so island / SSR-component renderToString sees
+          // the active route via useNav() (active-nav at first paint). The native
+          // template itself is Rust-rendered and needs no scope. The loaders ran
+          // in their own request scope above; this island SSR is outside it.
+          const [islandExtra, componentExtra] = await runInNavContext(
+            call.path,
+            searchStringOf(call.req?.url),
+            () =>
+              Promise.all([
+                manifest && manifest.length > 0
+                  ? resolveIslandContext(manifest, rt, islandCache)
+                  : Promise.resolve({} as Record<string, string>),
+                compManifest && compManifest.length > 0
+                  ? resolveComponentContext(
+                      compManifest,
+                      rt,
+                      nativeTemplate,
+                      undefined,
+                      islandCache,
+                    )
+                  : Promise.resolve({} as Record<string, string>),
+              ]),
+          )
           const ctx = { ...rt, ...islandExtra, ...componentExtra }
           const finalBytes = encoder.encode(JSON.stringify(ctx))
           // The original size check guarded the pre-island bytes; the merged
@@ -1373,59 +1413,77 @@ export function makeRenderer(
       // or render resolves the same per-request instance. Snapshot is collected
       // after loaders (buildRenderElement resolved) — that's where Spec A stores
       // are seeded — and threaded into the render for <script> injection.
-      return await runInRequestContext(call.req?.cookies ?? {}, async () => {
-        // Computed ONCE and shared by buildRenderElement (leaf swap) and
-        // renderBranchStreaming (forceIslands) so the two can never diverge.
-        let shellMode = wantsSsgFallbackShell(flat, call)
-        let element: ReactNode = null
-        // The route actually rendered + its HTTP status. Normally the matched
-        // `flat` at the verdict status (404 when the matched route IS a
-        // catch-all). A React loader that `throw`s `notFound()` swaps both to
-        // the nearest catch-all at 404 below.
-        let renderFlat = flat
-        let renderStatus = flat.notFound === true ? 404 : verdict.status
-        try {
-          element = await buildRenderElement(call, flat, opts.getWorkerId, shellMode)
-        } catch (err) {
-          if (isHttpErrorTrigger(err)) {
-            // React loader threw httpError() — short-circuit with the trigger's
-            // response. NOT the errorBoundary, NOT the 500 path below: this is
-            // a deliberate response, like a middleware short-circuit.
-            return await emitSingleChunkResponse(
-              slotView,
-              napi,
-              workerId,
-              encoder,
-              {
-                status: err.status,
-                contentType: err.contentType,
-                body: err.body,
-                headers: err.headers,
-              },
-              slot,
-            )
-          }
-          if (isNotFoundTrigger(err)) {
-            // React `notFound()` trigger: abandon the matched route and render
-            // the NEAREST catch-all (same selection as a Rust-unmatched path)
-            // at HTTP 404 — NOT the route's own Component, NOT a 500. Reuse the
-            // existing 404-render machinery by re-running buildRenderElement
-            // against the catch-all's chain.
-            // nfId is the array index, which IS the route_id (catch-alls keep
-            // their natural slot — see FlatRoute.notFound), so byRouteId resolves
-            // the same flat route the Rust tier picks for an unmatched path.
-            const nfId = selectNotFound(routes, call.path)
-            const nfFlat = nfId !== undefined ? byRouteId.get(nfId) : undefined
-            renderStatus = 404
-            if (nfFlat) {
-              renderFlat = nfFlat
-              shellMode = wantsSsgFallbackShell(nfFlat, call)
-              try {
-                element = await buildRenderElement(call, nfFlat, opts.getWorkerId, shellMode)
-              } catch (nfErr) {
-                // The catch-all's OWN loader/render setup failed — don't loop;
-                // fall back to the framework default 404 body at 404.
-                console.error(`[brust] catch-all render setup failed:`, nfErr)
+      return await runInRequestContext(
+        call.req?.cookies ?? {},
+        async () => {
+          // Computed ONCE and shared by buildRenderElement (leaf swap) and
+          // renderBranchStreaming (forceIslands) so the two can never diverge.
+          let shellMode = wantsSsgFallbackShell(flat, call)
+          let element: ReactNode = null
+          // The route actually rendered + its HTTP status. Normally the matched
+          // `flat` at the verdict status (404 when the matched route IS a
+          // catch-all). A React loader that `throw`s `notFound()` swaps both to
+          // the nearest catch-all at 404 below.
+          let renderFlat = flat
+          let renderStatus = flat.notFound === true ? 404 : verdict.status
+          try {
+            element = await buildRenderElement(call, flat, opts.getWorkerId, shellMode)
+          } catch (err) {
+            if (isHttpErrorTrigger(err)) {
+              // React loader threw httpError() — short-circuit with the trigger's
+              // response. NOT the errorBoundary, NOT the 500 path below: this is
+              // a deliberate response, like a middleware short-circuit.
+              return await emitSingleChunkResponse(
+                slotView,
+                napi,
+                workerId,
+                encoder,
+                {
+                  status: err.status,
+                  contentType: err.contentType,
+                  body: err.body,
+                  headers: err.headers,
+                },
+                slot,
+              )
+            }
+            if (isNotFoundTrigger(err)) {
+              // React `notFound()` trigger: abandon the matched route and render
+              // the NEAREST catch-all (same selection as a Rust-unmatched path)
+              // at HTTP 404 — NOT the route's own Component, NOT a 500. Reuse the
+              // existing 404-render machinery by re-running buildRenderElement
+              // against the catch-all's chain.
+              // nfId is the array index, which IS the route_id (catch-alls keep
+              // their natural slot — see FlatRoute.notFound), so byRouteId resolves
+              // the same flat route the Rust tier picks for an unmatched path.
+              const nfId = selectNotFound(routes, call.path)
+              const nfFlat = nfId !== undefined ? byRouteId.get(nfId) : undefined
+              renderStatus = 404
+              if (nfFlat) {
+                renderFlat = nfFlat
+                shellMode = wantsSsgFallbackShell(nfFlat, call)
+                try {
+                  element = await buildRenderElement(call, nfFlat, opts.getWorkerId, shellMode)
+                } catch (nfErr) {
+                  // The catch-all's OWN loader/render setup failed — don't loop;
+                  // fall back to the framework default 404 body at 404.
+                  console.error(`[brust] catch-all render setup failed:`, nfErr)
+                  return await emitSingleChunkResponse(
+                    slotView,
+                    napi,
+                    workerId,
+                    encoder,
+                    {
+                      status: 404,
+                      contentType: 'text/html; charset=utf-8',
+                      body: DEFAULT_NOT_FOUND_BODY,
+                    },
+                    slot,
+                  )
+                }
+              } else {
+                // No catch-all registered for this prefix → framework default 404
+                // body at status 404 (don't crash, don't 500).
                 return await emitSingleChunkResponse(
                   slotView,
                   napi,
@@ -1440,65 +1498,56 @@ export function makeRenderer(
                 )
               }
             } else {
-              // No catch-all registered for this prefix → framework default 404
-              // body at status 404 (don't crash, don't 500).
+              // Setup failure BEFORE renderToPipeableStream — loader throw, params
+              // bind throw. Shape matches the legacy "internal error" path so
+              // existing integration tests stay green.
+              console.error(`[brust] render setup failed:`, err)
               return await emitSingleChunkResponse(
                 slotView,
                 napi,
                 workerId,
                 encoder,
                 {
-                  status: 404,
+                  status: 500,
                   contentType: 'text/html; charset=utf-8',
-                  body: DEFAULT_NOT_FOUND_BODY,
+                  body: 'internal error',
                 },
                 slot,
               )
             }
-          } else {
-            // Setup failure BEFORE renderToPipeableStream — loader throw, params
-            // bind throw. Shape matches the legacy "internal error" path so
-            // existing integration tests stay green.
-            console.error(`[brust] render setup failed:`, err)
-            return await emitSingleChunkResponse(
-              slotView,
-              napi,
-              workerId,
-              encoder,
-              {
-                status: 500,
-                contentType: 'text/html; charset=utf-8',
-                body: 'internal error',
-              },
-              slot,
-            )
           }
-        }
-        const errorBoundary: ComponentType<{ error: Error }> =
-          renderFlat.errorBoundary ??
-          (({ error }) => createElement('div', null, `Internal Server Error: ${error.message}`))
-        const storeSnapshot = collectSnapshot()
-        await renderBranchStreaming({
-          element,
-          view: slotView,
-          slot,
-          workerId,
-          napi,
-          errorBoundary,
-          // Catch-all (`path: '*'`) leaf rendered on an unmatched path OR a
-          // React `notFound()` swap: stamp HTTP 404 (mirrors the native path).
-          status: renderStatus,
-          headers: flushSetCookie(verdict.headers),
-          routePath: renderFlat.fullPath,
-          shellId: renderFlat.shellId,
-          storeSnapshot,
-          // SSG fallback shells have zero islands on the page but the
-          // client-loader runtime still needs the importmap + bootstrap.
-          forceIslands: shellMode,
-        })
-        // renderBranchStreaming wrote via the chunk channel.
-        return 0
-      })
+          const errorBoundary: ComponentType<{ error: Error }> =
+            renderFlat.errorBoundary ??
+            (({ error }) => createElement('div', null, `Internal Server Error: ${error.message}`))
+          const storeSnapshot = collectSnapshot()
+          await renderBranchStreaming({
+            element,
+            view: slotView,
+            slot,
+            workerId,
+            napi,
+            errorBoundary,
+            // Catch-all (`path: '*'`) leaf rendered on an unmatched path OR a
+            // React `notFound()` swap: stamp HTTP 404 (mirrors the native path).
+            status: renderStatus,
+            headers: flushSetCookie(verdict.headers),
+            routePath: renderFlat.fullPath,
+            shellId: renderFlat.shellId,
+            storeSnapshot,
+            // SSG fallback shells have zero islands on the page but the
+            // client-loader runtime still needs the importmap + bootstrap.
+            forceIslands: shellMode,
+          })
+          // renderBranchStreaming wrote via the chunk channel.
+          return 0
+        },
+        // Seed nav with the REQUEST path (call.path), not renderFlat.fullPath: on
+        // a React notFound() swap the catch-all renders, but the user is still at
+        // the unmatched URL — and the client __navInit's from location.pathname
+        // (= that URL), so both sides agree. nav = where you are, not what handled it.
+        call.path,
+        searchStringOf(call.req?.url),
+      )
     }
     if (call.kind === 'navigation') {
       await navigationBranch(call, byRouteId, routes, slotView, encoder, opts.getWorkerId, slot)
@@ -1717,23 +1766,28 @@ async function navigationBranch(
       // document that already booted the bootstrap (the navigator IS the
       // bootstrap), and the takeover runtime imports its chunk itself.
       const renderFlatToHtml = (target: FlatRoute): Promise<string> =>
-        runInRequestContext(call.req?.cookies ?? {}, async () => {
-          const element = await buildRenderElement(
-            call as any,
-            target,
-            getWorkerId,
-            wantsSsgFallbackShell(target, call as any),
-          )
-          if (!element) throw new Error('render setup failed')
-          // Use renderToPipeableStream + onAllReady so pages with <Suspense> emit
-          // their RESOLVED markup, not the fallback. renderToString would only
-          // capture the shell — navigating SPA-style to a Suspense-using route
-          // would otherwise ship "loading…" and never recover.
-          const html = await renderToAwaitedString(element)
-          store = collectSnapshot()
-          navHeaders = flushSetCookie(undefined)
-          return html
-        })
+        runInRequestContext(
+          call.req?.cookies ?? {},
+          async () => {
+            const element = await buildRenderElement(
+              call as any,
+              target,
+              getWorkerId,
+              wantsSsgFallbackShell(target, call as any),
+            )
+            if (!element) throw new Error('render setup failed')
+            // Use renderToPipeableStream + onAllReady so pages with <Suspense> emit
+            // their RESOLVED markup, not the fallback. renderToString would only
+            // capture the shell — navigating SPA-style to a Suspense-using route
+            // would otherwise ship "loading…" and never recover.
+            const html = await renderToAwaitedString(element)
+            store = collectSnapshot()
+            navHeaders = flushSetCookie(undefined)
+            return html
+          },
+          call.path,
+          searchStringOf(call.req?.url),
+        )
       try {
         fullHtml = await renderFlatToHtml(flat)
       } catch (err) {
@@ -1898,14 +1952,22 @@ async function renderNativeRouteToHtml(
   const manifest = loadIslandManifest(templateName)
   const compManifest = loadComponentManifest(templateName)
   if ((manifest && manifest.length > 0) || (compManifest && compManifest.length > 0)) {
-    const [islandExtra, componentExtra] = await Promise.all([
-      manifest && manifest.length > 0
-        ? resolveIslandContext(manifest, ctx, islandCache)
-        : Promise.resolve({} as Record<string, string>),
-      compManifest && compManifest.length > 0
-        ? resolveComponentContext(compManifest, ctx, templateName, undefined, islandCache)
-        : Promise.resolve({} as Record<string, string>),
-    ])
+    // Seed the request path so island SSR sees the active route via useNav()
+    // (same as the full-document native branch — this runs outside the loader
+    // request scope opened above).
+    const [islandExtra, componentExtra] = await runInNavContext(
+      call.path,
+      searchStringOf(call.req?.url),
+      () =>
+        Promise.all([
+          manifest && manifest.length > 0
+            ? resolveIslandContext(manifest, ctx, islandCache)
+            : Promise.resolve({} as Record<string, string>),
+          compManifest && compManifest.length > 0
+            ? resolveComponentContext(compManifest, ctx, templateName, undefined, islandCache)
+            : Promise.resolve({} as Record<string, string>),
+        ]),
+    )
     ctx = { ...ctx, ...islandExtra, ...componentExtra }
   }
 

package/types/navigation/server-context.d.ts

@@ -0,0 +1,5 @@
+/** Open a per-request nav scope so SSR — React islands AND native island SSR —
+ * sees the current request path via useNav()/getNavState() instead of the idle
+ * singleton default. `search` is the raw query string INCLUDING the leading '?'
+ * (so it matches the client's `location.search`), or '' when there is none. */
+export declare function runInNavContext<T>(path: string, search: string, fn: () => T): T;

package/types/navigation/store.d.ts

@@ -26,6 +26,12 @@ type ErrorCb = (e: {
     error: Error;
 }) => void;
 export declare const nav: NavStore;
+export interface ServerNavScope {
+    path: string;
+    search: string;
+    _snap?: NavState;
+}
+export declare function __setServerNavResolver(fn: () => ServerNavScope | undefined): void;
 export declare function getNavState(): NavState;
 export declare function subscribe(cb: NavCb): () => void;
 export declare function onBeforeNavigate(cb: BeforeCb): () => void;

package/types/render/fragment.d.ts

@@ -7,6 +7,13 @@ export declare function renderToAwaitedString(element: ReactNode): Promise<strin
 export interface RenderFragmentOpts {
     /** Request cookies visible to cookies()/session helpers inside the tree. */
     cookies?: Record<string, string>;
+    /** Seed `useNav()` / `getNavState()` for islands inside the fragment. Provide
+     * when rendering for a known URL (e.g. a server-side preview of a specific
+     * route) so active-nav resolves; omit for a context-free fragment, where
+     * `useNav()` reports the idle defaults (path ''). `search` is the raw query
+     * string including the leading '?'. */
+    path?: string;
+    search?: string;
 }
 /** Render a component to an HTML string with framework contexts scoped:
  * request scope (cookies) ∘ request cache (cachedFetch/dedupe) ∘ store