brustjs 0.1.12-alpha → 0.1.13-alpha

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brustjs",
-  "version": "0.1.12-alpha",
+  "version": "0.1.13-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.12-alpha",
-    "brustjs-darwin-arm64": "0.1.12-alpha",
-    "brustjs-linux-x64-gnu": "0.1.12-alpha",
-    "brustjs-linux-arm64-gnu": "0.1.12-alpha",
-    "brustjs-linux-x64-musl": "0.1.12-alpha",
-    "brustjs-linux-arm64-musl": "0.1.12-alpha"
+    "brustjs-darwin-x64": "0.1.13-alpha",
+    "brustjs-darwin-arm64": "0.1.13-alpha",
+    "brustjs-linux-x64-gnu": "0.1.13-alpha",
+    "brustjs-linux-arm64-gnu": "0.1.13-alpha",
+    "brustjs-linux-x64-musl": "0.1.13-alpha",
+    "brustjs-linux-arm64-musl": "0.1.13-alpha"
   },
   "peerDependencies": {
     "react": "^19.2.6",

package/runtime/cli/build.ts

@@ -219,8 +219,8 @@ export async function runBuild(args: string[]): Promise<void> {
   // `import { actions } from './actions'` path, no scan and no `_actions-prebuilt`
   // file. (The old `'use server'` filesystem scanner is gone.)
 
-  // routes.tsx is the scan target for both islands (§3) and the MCP manifest
-  // (§4). Computed once here and reused below.
+  // routes.tsx is the scan target for both islands (S3) and the MCP manifest
+  // (S4). Computed once here and reused below.
   const routesFile = path.join(entryDir, 'routes.tsx')
 
   // 3. Build islands (if any <Island> usage is found in the routes graph).
@@ -279,7 +279,7 @@ export async function runBuild(args: string[]): Promise<void> {
     // deploy ships the templates. The prebuilt runtime reads them from
     // `<BRUST_DIST_DIR>/jinja` (see index.ts loadJinjaOnce / configureJinjaDir).
     const jinjaDir = path.join(outDir, 'jinja')
-    // Spec §7 Component-source resolution: scan the routes module's source for
+    // Spec S7 Component-source resolution: scan the routes module's source for
     // ImportDeclarations, NOT the app entry's. The app entry only imports the
     // routes module + brust; the page components are imported by routes.tsx.
     // If routes.tsx doesn't exist (no routes module), we still write an empty

package/runtime/cli/dev.ts

@@ -60,7 +60,7 @@ export async function runDev(args: string[]): Promise<void> {
 
   // Sub-project J — emit .brust/jinja/<Name>.jinja templates BEFORE handing
   // off to the user's entry. The runtime loads these on boot. Dev-mode HMR
-  // on .tsx edit is deferred per spec §12 (restart-to-reload for v2).
+  // on .tsx edit is deferred per spec S12 (restart-to-reload for v2).
   const entryDir = dirname(entry)
   const routesFile = path.join(entryDir, 'routes.tsx')
   let loadedRoutes: any[] = []
@@ -74,7 +74,7 @@ export async function runDev(args: string[]): Promise<void> {
       )
     }
   }
-  // Spec §7 — scan routes.tsx (where page imports live), not the app entry.
+  // Spec S7 — scan routes.tsx (where page imports live), not the app entry.
   // outDir = process.cwd() to align with the runtime's loadJinjaOnce which
   // reads from `cwd + '.brust/jinja'`. When user runs `bun run dev
   // example/hello-world/index.ts` from repo root, cwd != entryDir; writing

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

@@ -108,11 +108,11 @@ function injectDevClientIntoTemplate(template: string): string {
  * `.brust/jinja/<Name>.jinja` templates. Invoked from `brust build` and
  * `brust dev` after the user's routes are flattened.
  *
- * Limitations (spec §7 + §13.10):
+ * Limitations (spec S7 + S13.10):
  * - Regex-based import scanner — handles `import Name from './path'` only.
  *   Full swc AST + re-export chain support deferred to v2.x.
  * - Dev mode does NOT hot-reload templates on .tsx edit. Boot-only; restart
- *   required. Deferred per spec §12.
+ *   required. Deferred per spec S12.
  */
 
 export interface NativeRouteEmitOpts {
@@ -395,7 +395,7 @@ export async function emitNativeTemplates(opts: NativeRouteEmitOpts): Promise<vo
 export function scanImports(entryFile: string): Map<string, string> {
   const source = readFileSync(entryFile, 'utf8')
   const map = new Map<string, string>()
-  // Regex-based scanner; full swc AST scan deferred per spec §7 + §13.10.
+  // Regex-based scanner; full swc AST scan deferred per spec S7 + S13.10.
   const re = /^import\s+(\w+)\s+from\s+['"]([^'"]+)['"]/gm
   for (let m = re.exec(source); m !== null; m = re.exec(source)) {
     const localName = m[1]!

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

@@ -1,6 +1,6 @@
 {
   "compilerOptions": {
-    "lib": ["ESNext"],
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
     "target": "ESNext",
     "module": "Preserve",
     "moduleDetection": "force",

package/runtime/index.d.ts

@@ -104,7 +104,7 @@ export declare function napiRegisterWsPaths(paths: Array<string>): NapiResult<un
  * Worker-driven render chunk delivery. Worker calls this once per chunk
  * it wants to emit; final call uses `len = 0` to close the channel.
  *
- * Contract (spec §5.2):
+ * Contract (spec S5.2):
  * - `len > 0`: read SAB[0..len], send Bytes through render_slot.chunk_tx,
  *   await ack. Resolves after Rust writes the chunk to the socket.
  * - `len == 0`: send Final, await ack. Closes the response.
@@ -132,7 +132,7 @@ export declare function napiRenderChunkFinal(workerId: number, len: number): Pro
 /**
  * Sub-project J — render via minijinja using SAB-side-channeled loader data.
  *
- * SAB convention (spec §6 last paragraph): per-napi-call. `napi_render_jinja`
+ * SAB convention (spec S6 last paragraph): per-napi-call. `napi_render_jinja`
  * treats SAB[0..data_len] as INBOUND raw JSON written by the JS worker. It
  * renders the template Rust-side, assembles a `[meta_len: u16 BE][meta JSON]
  * [body]` payload, writes it back into the SAB, and returns its byte length —

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

package/runtime/islands/brust-page.tsx

@@ -10,8 +10,9 @@ import { createElement, type ReactNode } from 'react'
  * brust keeps full ownership of `<head>` and can add more tags later (importmap,
  * preloads) without colliding with hand-written head elements.
  *
- * All props are compile-time string literals on the native path (the shell is
- * rendered in Rust, so they can't be dynamic expressions there). This React
+ * On the native path each prop accepts a compile-time string literal OR a
+ * loader member-path (`title={data.title}`), interpolated into the Rust-rendered
+ * shell as `{{ path }}` (S8). Calls/arithmetic are still rejected. This React
  * implementation mirrors the compiled output for the rare non-native use. */
 export interface BrustPageProps {
   /** `<html lang>` — defaults to `"en"`. */

package/runtime/islands/island.tsx

@@ -53,7 +53,13 @@ export function consumeIslandUsedFlag(): boolean {
   return v
 }
 
-export function Island<P extends Record<string, unknown>>({
+// Constraint is `object`, NOT `Record<string, unknown>`: a TS `interface` has no
+// implicit index signature, so it does NOT satisfy `extends Record<string, unknown>`
+// — that made `P` fall back to the constraint and rejected any component whose
+// props are declared as an interface (`<Island component={C} props={p} />` →
+// ts(2322)). `extends object` accepts interfaces, still rejects primitives, and
+// lets `P` infer from `component`/`props` so the two stay type-tied.
+export function Island<P extends object>({
   component: Component,
   props,
   hydrate = 'load',

package/runtime/render/inject-css-link.ts

@@ -13,7 +13,7 @@ export function _resetWarnedForTests(): void {
  * before the first occurrence of `</head>` (case-insensitive). Returns the
  * original body untouched if `hrefs` is empty or if `</head>` is absent
  * (warns once in the latter case). Renderer calls this on the first chunk
- * only — see spec §"SSR <link> injection". */
+ * only — see spec S"SSR <link> injection". */
 export function injectCssLink(body: Uint8Array, hrefs: readonly string[]): Uint8Array {
   if (hrefs.length === 0) return body
   const pos = findHeadCloseTag(body)

package/runtime/routes.ts

@@ -336,7 +336,7 @@ function validateRoute(r: Route, basePath: string): void {
 
 /** Walk the nested route tree, emitting one FlatRoute per leaf or index node.
  * Composes paths, middleware, errorBoundary, and cache per the rules in
- * the design spec (§3). */
+ * the design spec (S3). */
 export function flattenRoutes(routes: Route[]): FlatRoute[] {
   const out: FlatRoute[] = []
   walkRoutes(routes, [], '', out)
@@ -593,7 +593,7 @@ export function makeRenderer(
       // path above and works for native routes. But middleware that calls
       // next() then mutates status/headers (e.g. adds Cache-Control) is NOT
       // forwarded; napi_render_jinja hardcodes status: 200 and empty headers.
-      // Spec §4 doesn't define post-next() mutation semantics for native;
+      // Spec S4 doesn't define post-next() mutation semantics for native;
       // deferred to v2.x. If your middleware needs to mutate, use a React
       // route for now.
       if (flat.nativeTemplate !== undefined) {
@@ -884,13 +884,24 @@ async function navigationBranch(
   }
 
   try {
-    const element = await buildRenderElement(call as any, flat, getWorkerId)
-    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 fullHtml = await renderToAwaitedString(element)
+    // Native (jinja) routes have no React tree, so we can't renderToString them.
+    // Render the template Rust-side (same path as a full document load) and use
+    // its HTML; React routes keep the renderToAwaitedString path below. Without
+    // this branch, a SPA navigation to a native route React-renders a component
+    // whose loader fields arrive undefined → throws → 500 → full-reload fallback
+    // on every internal link.
+    let fullHtml: string
+    if (flat.nativeTemplate !== undefined) {
+      fullHtml = await renderNativeRouteToHtml(call, flat, view, encoder, workerId)
+    } else {
+      const element = await buildRenderElement(call as any, flat, getWorkerId)
+      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.
+      fullHtml = await renderToAwaitedString(element)
+    }
 
     // Extract <main> inner content. If the page didn't render a <main>,
     // ship the full HTML — the client's no-main check will fire its
@@ -925,6 +936,65 @@ async function navigationBranch(
   }
 }
 
+/** Render a native (jinja) route to its full HTML document for a SPA navigation.
+ *
+ * Mirrors the render-branch native path: run the leaf loader, merge island /
+ * component manifest context, then call the SYNC `napiRenderJinja`, which writes
+ * a framed `[meta_len u16 BE][meta JSON][body]` response into the SAB and returns
+ * its length. Here — unlike the render branch, which returns that length so Rust
+ * streams the SAB straight to the socket — we read the body back out of the SAB
+ * and hand it to navigationBranch, which extracts `<main>` + `<title>` from it.
+ *
+ * Throws on loader failure / oversized data / non-200 render; navigationBranch's
+ * catch turns that into a 500 (→ client full-reload fallback). */
+async function renderNativeRouteToHtml(
+  call: Extract<RouteCall, { kind: 'navigation' }>,
+  flat: FlatRoute,
+  view: Uint8Array,
+  encoder: TextEncoder,
+  workerId: bigint,
+): Promise<string> {
+  const templateName = flat.nativeTemplate as string
+  const leaf = flat.chain[flat.chain.length - 1]
+
+  let data: unknown = {}
+  if (leaf.loader) {
+    data = await leaf.loader({ params: call.params, path: call.path, req: call.req } as any)
+  }
+
+  let ctx = (data ?? {}) as Record<string, unknown>
+  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>),
+    ])
+    ctx = { ...ctx, ...islandExtra, ...componentExtra }
+  }
+
+  const bytes = encoder.encode(JSON.stringify(ctx))
+  if (bytes.length > view.length) throw new Error('native loader data too large for SAB')
+  view.set(bytes, 0)
+
+  const len = (native as any).napiRenderJinja(
+    Number(workerId),
+    bytes.length,
+    templateName,
+  ) as number
+
+  // Parse the framed response the SAB now holds: [meta_len u16 BE][meta][body].
+  const metaLen = (view[0] << 8) | view[1]
+  const decoder = new TextDecoder()
+  const meta = JSON.parse(decoder.decode(view.subarray(2, 2 + metaLen))) as { status?: number }
+  if (meta.status !== 200) throw new Error(`native render returned status ${meta.status}`)
+  return decoder.decode(view.subarray(2 + metaLen, len))
+}
+
 /** Build the React element for a render or navigation call: runs loaders
  * top-down, builds the element bottom-up wrapping in OutletContext.Provider
  * so nested routes receive the deeper element via <Outlet />. The caller

package/runtime/treaty.ts

@@ -1,3 +1,5 @@
+import type { ActionsBuilder } from './define-actions.ts'
+
 const METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head'])
 
 export interface TreatyResponse<Data = unknown, Err = unknown> {
@@ -13,6 +15,29 @@ export interface ClientOptions {
   fetch?: typeof fetch
 }
 
+type FirstSegment<S extends string> = S extends `/${infer Rest}`
+  ? FirstSegment<Rest>
+  : S extends `${infer T}/${infer _U}`
+    ? T
+    : S
+
+export type PermissiveProxy = {
+  (arg?: any): PermissiveProxy
+  [key: string]: PermissiveProxy
+} & {
+  get: (options?: any) => Promise<TreatyResponse<any, any>>
+  post: (body?: any, options?: any) => Promise<TreatyResponse<any, any>>
+  put: (body?: any, options?: any) => Promise<TreatyResponse<any, any>>
+  patch: (body?: any, options?: any) => Promise<TreatyResponse<any, any>>
+  delete: (body?: any, options?: any) => Promise<TreatyResponse<any, any>>
+  head: (options?: any) => Promise<TreatyResponse<any, any>>
+}
+
+export type Treaty<App> =
+  App extends ActionsBuilder<infer Acc>
+    ? { [K in FirstSegment<keyof Acc & string>]: PermissiveProxy } & PermissiveProxy
+    : PermissiveProxy
+
 function resolvePrefix(opts?: ClientOptions): string {
   if (opts?.prefix) return opts.prefix
   const g = (globalThis as { __BRUST_ACTION_PREFIX__?: string }).__BRUST_ACTION_PREFIX__
@@ -23,7 +48,7 @@ function resolvePrefix(opts?: ClientOptions): string {
  * with an object fills the next {param}(s) positionally (in insertion order); a
  * terminal method key (.get/.post/…) performs the request. URL is composed from
  * the literal accumulated segments — never from any inferred type. */
-export function client<App = unknown>(opts?: ClientOptions): App {
+export function client<App = unknown>(opts?: ClientOptions): Treaty<App> {
   const prefix = resolvePrefix(opts)
   const doFetch = opts?.fetch ?? fetch
   function make(segments: string[]): any {
@@ -101,7 +126,7 @@ export function client<App = unknown>(opts?: ClientOptions): App {
       },
     })
   }
-  return make([]) as App
+  return make([]) as any as Treaty<App>
 }
 
 function hasFilePart(b: unknown): boolean {