@brust/core 2.0.0-alpha.10 → 2.0.0-alpha.12

package/native/index.js

@@ -89,8 +89,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-android-arm64')
         const bindingPackageVersion = require('@brust/native-android-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -105,8 +105,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-android-arm-eabi')
         const bindingPackageVersion = require('@brust/native-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -126,8 +126,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-win32-x64-gnu')
           const bindingPackageVersion = require('@brust/native-win32-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -142,8 +142,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-win32-x64-msvc')
           const bindingPackageVersion = require('@brust/native-win32-x64-msvc/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -159,8 +159,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-win32-ia32-msvc')
         const bindingPackageVersion = require('@brust/native-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -175,8 +175,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-win32-arm64-msvc')
         const bindingPackageVersion = require('@brust/native-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -194,8 +194,8 @@ function requireNative() {
     try {
       const binding = require('@brust/native-darwin-universal')
       const bindingPackageVersion = require('@brust/native-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -210,8 +210,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-darwin-x64')
         const bindingPackageVersion = require('@brust/native-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -226,8 +226,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-darwin-arm64')
         const bindingPackageVersion = require('@brust/native-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -246,8 +246,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-freebsd-x64')
         const bindingPackageVersion = require('@brust/native-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -262,8 +262,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-freebsd-arm64')
         const bindingPackageVersion = require('@brust/native-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -283,8 +283,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-x64-musl')
           const bindingPackageVersion = require('@brust/native-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -299,8 +299,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-x64-gnu')
           const bindingPackageVersion = require('@brust/native-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -317,8 +317,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-arm64-musl')
           const bindingPackageVersion = require('@brust/native-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -333,8 +333,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-arm64-gnu')
           const bindingPackageVersion = require('@brust/native-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -351,8 +351,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-arm-musleabihf')
           const bindingPackageVersion = require('@brust/native-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -367,8 +367,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@brust/native-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -385,8 +385,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-loong64-musl')
           const bindingPackageVersion = require('@brust/native-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -401,8 +401,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-loong64-gnu')
           const bindingPackageVersion = require('@brust/native-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -419,8 +419,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-riscv64-musl')
           const bindingPackageVersion = require('@brust/native-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -435,8 +435,8 @@ function requireNative() {
         try {
           const binding = require('@brust/native-linux-riscv64-gnu')
           const bindingPackageVersion = require('@brust/native-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -452,8 +452,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-linux-ppc64-gnu')
         const bindingPackageVersion = require('@brust/native-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -468,8 +468,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-linux-s390x-gnu')
         const bindingPackageVersion = require('@brust/native-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -488,8 +488,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-openharmony-arm64')
         const bindingPackageVersion = require('@brust/native-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -504,8 +504,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-openharmony-x64')
         const bindingPackageVersion = require('@brust/native-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -520,8 +520,8 @@ function requireNative() {
       try {
         const binding = require('@brust/native-openharmony-arm')
         const bindingPackageVersion = require('@brust/native-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.12' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -661,8 +661,8 @@ if (!nativeBinding || forceWasi) {
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
           const bindingPackageVersion = require('@brust/native-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.10') {
-            throw new Error(`WASI binding package version mismatch, expected 2.0.0-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.12') {
+            throw new Error(`WASI binding package version mismatch, expected 2.0.0-alpha.12 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@brust/native-wasm32-wasi')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brust/core",
-  "version": "2.0.0-alpha.10",
+  "version": "2.0.0-alpha.12",
   "description": "brust v2 — React components compiled to Rust-rendered templates",
   "license": "MIT",
   "homepage": "https://brust.dev",
@@ -55,7 +55,7 @@
     ]
   },
   "dependencies": {
-    "@brust/runtime-dom": "2.0.0-alpha.10"
+    "@brust/runtime-dom": "2.0.0-alpha.12"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -93,12 +93,12 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@brust/native-darwin-x64": "2.0.0-alpha.10",
-    "@brust/native-darwin-arm64": "2.0.0-alpha.10",
-    "@brust/native-linux-x64-gnu": "2.0.0-alpha.10",
-    "@brust/native-linux-arm64-gnu": "2.0.0-alpha.10",
-    "@brust/native-linux-x64-musl": "2.0.0-alpha.10",
-    "@brust/native-linux-arm64-musl": "2.0.0-alpha.10",
-    "@brust/core-cf": "2.0.0-alpha.10"
+    "@brust/native-darwin-x64": "2.0.0-alpha.12",
+    "@brust/native-darwin-arm64": "2.0.0-alpha.12",
+    "@brust/native-linux-x64-gnu": "2.0.0-alpha.12",
+    "@brust/native-linux-arm64-gnu": "2.0.0-alpha.12",
+    "@brust/native-linux-x64-musl": "2.0.0-alpha.12",
+    "@brust/native-linux-arm64-musl": "2.0.0-alpha.12",
+    "@brust/core-cf": "2.0.0-alpha.12"
   }
 }

package/src/build/build-eval.ts

@@ -12,7 +12,7 @@
 import { realpathSync } from 'node:fs'
 import { join } from 'node:path'
 import type { BunPlugin } from 'bun'
-import { type SourceOf, PRODUCTION, sourceDirPlugin, stage, write } from './bundle'
+import { jobImportPlugin, type SourceOf, PRODUCTION, sourceDirPlugin, stage, write } from './bundle'
 import type { Compiled } from './compile'
 import { BuildError } from './errors'
 import { serverOnlyEmptyPlugin } from './server-only'
@@ -247,27 +247,38 @@ async function evaluateInstances(
   const modules = new Map<string, string>()
   const stubs = new Map<string, Map<string, string>>()
   const imports: string[] = []
+  /** Component id -> its staged job module; written once, with the stubs its own imports are served by. */
+  const staged = new Map<string, string>()
+  const stageJob = (c: Compiled, served: { source: string; code: string }[]) => {
+    if (staged.has(c.id)) return
+    const file = join(dist, '.stage', 'eval', `${c.id}.job.ts`)
+    write(file, c.serverTs!)
+    stage(sourceOf, file, c)
+    const map = new Map<string, string>()
+    for (const [i, st] of served.entries()) {
+      const stub = join(dist, '.stage', 'eval', 'stubs', c.id, `${i}.ts`)
+      write(stub, st.code)
+      stage(sourceOf, stub, c)
+      map.set(st.source, stub)
+    }
+    if (map.size > 0) {
+      stubs.set(file, map)
+      stubs.set(realpathSync(file), map)
+    }
+    staged.set(c.id, file)
+  }
   for (const c of compiled.values()) {
     for (const inst of c.ir.build_eval_instances ?? []) {
       const child = compiled.get(inst.child_id)
       if (child?.serverTs === undefined) continue
+      // R34.96 (A1): the job modules fused into this child's job, which it imports through `brust-job:<id>`.
+      const fused = (inst.fused ?? []).map((f) => ({ f, c: compiled.get(f.child_id) }))
+      if (fused.some(({ c }) => c?.serverTs === undefined)) continue
+      for (const { f, c } of fused) stageJob(c!, f.stubs ?? [])
       if (!modules.has(child.id)) {
-        const file = join(dist, '.stage', 'eval', `${child.id}.job.ts`)
-        write(file, child.serverTs)
-        stage(sourceOf, file, child)
-        const served = new Map<string, string>()
-        for (const [i, st] of (inst.stubs ?? []).entries()) {
-          const stub = join(dist, '.stage', 'eval', 'stubs', child.id, `${i}.ts`)
-          write(stub, st.code)
-          stage(sourceOf, stub, child)
-          served.set(st.source, stub)
-        }
-        if (served.size > 0) {
-          stubs.set(file, served)
-          stubs.set(realpathSync(file), served)
-        }
+        stageJob(child, inst.stubs ?? [])
         modules.set(child.id, `j${modules.size}`)
-        imports.push(`import { precompute as ${modules.get(child.id)} } from ${JSON.stringify(file)}`)
+        imports.push(`import { precompute as ${modules.get(child.id)} } from ${JSON.stringify(staged.get(child.id))}`)
       }
       const id = `${inst.child_id}\0${JSON.stringify(inst.inputs)}`
       const where = `${c.file.slice(appRoot.length + 1)}:${inst.line}:${inst.col}`
@@ -285,7 +296,7 @@ async function evaluateInstances(
     target: 'bun',
     format: 'esm',
     define: PRODUCTION,
-    plugins: [stubPlugin(stubs), sourceDirPlugin(sourceOf, appRoot)],
+    plugins: [jobImportPlugin((id) => staged.get(id)), stubPlugin(stubs), sourceDirPlugin(sourceOf, appRoot)],
   })
   if (!res.success) {
     log(`warning build-eval the instance jobs could not be bundled for build evaluation, they stay per-request jobs: ${res.logs.map(String).join(' | ').split('\n')[0]}`)

package/src/build/bundle.ts

@@ -76,6 +76,9 @@ export function sourceDirPlugin(sourceOf: SourceOf, appRoot: string, external: s
         return src === undefined ? undefined : { path: Bun.resolveSync(a.path, dirname(src)) }
       })
       b.onResolve({ filter: /^[^./]/ }, (a) => {
+        // A package source imported as itself (a React component revived from it): its bare imports are the package's.
+        const own = sourceOf.has(a.importer) ? undefined : packageDirOf(a.importer)
+        if (own !== undefined && !matchesExternal(a.path, external)) return { path: Bun.resolveSync(a.path, own) }
         if (!sourceOf.has(a.importer) || matchesExternal(a.path, external)) return undefined
         // F153c: an artifact compiled from a package's source imports what that package sees.
         const pkg = packageDirOf(sourceOf.get(a.importer)!)
@@ -383,9 +386,31 @@ export function nestedOf(compiled: Map<string, Compiled>, id: string, routeRoots
       }
     }
   }
+  // F148a (R34.121): a wrapper whose island renders `{children}` (a `$c` hole) is handed a tree by each call site; the
+  // components those trees name are revived by the island inside the wrapper, so its chunk and job import them.
+  for (const w of compiled.values()) {
+    if (!(w.ir.children ?? []).some((r) => r.id === id && (r.holes ?? []).some((h) => h.startsWith('$c')))) continue
+    for (const c of compiled.values()) {
+      for (const ref of c.ir.children ?? []) {
+        if (ref.id === w.id && ref.nested) {
+          out ??= new Set()
+          for (const n of ref.nested) out.add(n)
+        }
+      }
+    }
+  }
   return out && [...out].sort()
 }
 
+/** F148a (R34.120): the island props the compiler wrote for the values its children read from props (`$p<N>`: a
+ * primitive, `$c<N>`: a tree a wrapper's call site bound), at any call site of the island `id`. The only `$` keys,
+ * besides `$x`, its revive accepts. */
+export function holesOf(compiled: Map<string, Compiled>, id: string): string[] {
+  const out = new Set<string>()
+  for (const c of compiled.values()) for (const ref of c.ir.children ?? []) if (ref.id === id) for (const k of ref.holes ?? []) out.add(k)
+  return [...out].sort()
+}
+
 /** F158 (R34.71): the element-prop names (`$x`) the compiler wrote at any call site of the island `id`: the only names
  * its revive may revive. */
 export function xOf(compiled: Map<string, Compiled>, id: string): string[] {
@@ -409,25 +434,43 @@ export const reviveSource = (reg: string): string =>
   `const __own = Object.prototype.hasOwnProperty\n` +
   // The tree is compiler output, but props travel in page markup: read it as untrusted. A tag must be a plain element
   // name, a component must be in this island's registry (own keys only), and the raw-HTML prop is never revived.
-  `const __props = (p: any): any => { const o: any = {}; if (p && typeof p === 'object') for (const k of Object.keys(p)) if (k !== '__proto__' && k !== 'dangerouslySetInnerHTML' && k !== 'children' && k !== 'ref' && k !== 'key') o[k] = p[k]; return o }\n` +
+  // `hv` holds the island's hole values (F148a, R34.116): the props the compiler declared (`$p<N>` primitives, `$c<N>`
+  // trees). A value node reads one and renders it only when it is a string or a finite number (an attribute: also a boolean; text: also an array of them);
+  // anything else renders nothing, and is never walked, so request data can fill a leaf but never shape the tree.
+  `const __hole = (hv: any, k: any): any => hv == null || typeof k !== 'string' || !/^[$]p[0-9]+$/.test(k) || !__own.call(hv, k) ? undefined : hv[k]\n` +
+  `const __prim = (hv: any, k: any, bool: boolean): any => { const x = __hole(hv, k); return typeof x === 'string' || (typeof x === 'number' && Number.isFinite(x)) || (bool && typeof x === 'boolean') ? x : undefined }\n` +
+  `const __props = (p: any, hv: any): any => { const o: any = {}; if (p && typeof p === 'object') for (const k of Object.keys(p)) if (k !== '__proto__' && k !== 'dangerouslySetInnerHTML' && k !== 'children' && k !== 'ref' && k !== 'key') { const v = p[k]; if (v !== null && typeof v === 'object' && v.$brust === 'v') { const x = __prim(hv, v.k, true); if (x !== undefined) o[k] = x } else o[k] = v } return o }\n` +
   // `x` (on a component node) and `$x` (on the island's props) are the compiler's list of props that hold an element
   // tree. Only those names are revived, and only when the prop is an own key of the copy; data is never revived.
-  `const __xs = (o: any, x: any): any => { if (Array.isArray(x)) for (const k of x) if (typeof k === 'string' && k.charAt(0) !== '$' && __own.call(o, k)) o[k] = __rv(o[k]); return o }\n` +
-  `const __rv = (n: any): any => {\n` +
+  `const __xs = (o: any, x: any, hv: any): any => { if (Array.isArray(x)) for (const k of x) if (typeof k === 'string' && k.charAt(0) !== '$' && __own.call(o, k)) o[k] = __rv(o[k], hv); return o }\n` +
+  `const __kids = (c: any, hv: any): any[] => Array.isArray(c) ? c.map((k: any) => __rv(k, hv)) : []\n` +
+  `const __rv = (n: any, hv: any): any => {\n` +
   `  if (n === null || typeof n !== 'object') return n\n` +
-  `  const kids = Array.isArray(n.c) ? n.c.map(__rv) : []\n` +
+  // A text leaf is a string or a finite number; an array of them (React renders each) keeps those items. Anything else
+  // renders nothing and is never walked.
+  `  if (n.$brust === 'v') { const x = __hole(hv, n.k); if (Array.isArray(x)) return createElement(Fragment, null, ...x.filter((e: any) => typeof e === 'string' || (typeof e === 'number' && Number.isFinite(e)))); const p = __prim(hv, n.k, false); return p === undefined ? null : p }\n` +
+  // A condition is the truthiness of the declared own hole, as in React, without reading into the value. `a` is the
+  // `cond && <X/>` form: React renders a falsy number there (0) as text.
+  `  if (n.$brust === 'if') { const x = __hole(hv, n.k); return createElement(Fragment, null, ...(!x && n.a === true && typeof x === 'number' ? [x] : __kids(x ? n.c : n.e, hv))) }\n` +
+  // The caller's tree: compile-time, bound by the wrapper's call site. It holds no hole of its own, so it is revived
+  // with none (a tree that named one would render nothing, and cannot recurse).
+  `  if (n.$brust === 'slot') return typeof n.k === 'string' && /^[$]c[0-9]+$/.test(n.k) && hv != null && __own.call(hv, n.k) ? __rv(hv[n.k], null) : null\n` +
+  `  const kids = __kids(n.c, hv)\n` +
   `  if (n.$brust === 'fr') return createElement(Fragment, null, ...kids)\n` +
-  `  if (n.$brust === 'el') { if (typeof n.t !== 'string' || !/^[a-zA-Z][a-zA-Z0-9-]*$/.test(n.t)) throw new Error('brust: island children hold an invalid element name'); return createElement(n.t, __props(n.p), ...kids) }\n` +
-  `  if (n.$brust === 'cmp') { if (typeof n.id !== 'string' || !__own.call(__reg, n.id)) throw new Error('brust: island children name the component ' + String(n.id) + ', which this island does not import'); return createElement(__reg[n.id], __xs(__props(n.p), n.x), ...kids) }\n` +
+  `  if (n.$brust === 'el') { if (typeof n.t !== 'string' || !/^[a-zA-Z][a-zA-Z0-9-]*$/.test(n.t)) throw new Error('brust: island children hold an invalid element name'); return createElement(n.t, __props(n.p, hv), ...kids) }\n` +
+  `  if (n.$brust === 'cmp') { if (typeof n.id !== 'string' || !__own.call(__reg, n.id)) throw new Error('brust: island children name the component ' + String(n.id) + ', which this island does not import'); return createElement(__reg[n.id], __xs(__props(n.p, hv), n.x, hv), ...kids) }\n` +
   `  throw new Error('brust: island children hold an unknown node')\n` +
   `}\n` +
   // `X` is the host's compiler-declared element-prop names (R34.71): a `$x` from the props can only select among them.
-  // A `$`-key other than `$x` is never the compiler's (R34.72): it throws instead of rendering (a 500, not a revive).
-  `const __mk = (C: any, props: any, X: string[] = []) => {\n` +
-  `  for (const k of Object.keys(props)) if (k.charAt(0) === '$' && k !== '$x') throw new Error('brust: island props hold the reserved key ' + k)\n` +
+  // `H` is its declared hole names (R34.120). A `$`-key that is neither `$x` nor in `H` is never the compiler's (R34.72):
+  // it throws instead of rendering (a 500, not a revive). Hole props are the revive's, not the component's.
+  `const __mk = (C: any, props: any, X: string[] = [], H: string[] = []) => {\n` +
+  `  for (const k of Object.keys(props)) if (k.charAt(0) === '$' && k !== '$x' && !H.includes(k)) throw new Error('brust: island props hold the reserved key ' + k)\n` +
   `  const { children, $x, ...rest } = props\n` +
-  `  __xs(rest, Array.isArray($x) ? $x.filter((k: any) => X.includes(k)) : undefined)\n` +
-  `  return createElement(C, rest, ...(children === undefined ? [] : Array.isArray(children) ? children : [children]).map(__rv))\n` +
+  `  const hv: any = Object.create(null)\n` +
+  `  for (const k of H) if (__own.call(rest, k)) { hv[k] = rest[k]; delete rest[k] }\n` +
+  `  __xs(rest, Array.isArray($x) ? $x.filter((k: any) => X.includes(k)) : undefined, hv)\n` +
+  `  return createElement(C, rest, ...(children === undefined ? [] : Array.isArray(children) ? children : [children]).map((k: any) => __rv(k, hv)))\n` +
   `}\n`
 
 /** A helper component its module does not export (`ir.unexported`: `function SheetOverlay() {…}` rendered by an exported
@@ -459,7 +502,7 @@ export function exposePlugin(compiled: Map<string, Compiled>): BunPlugin {
 export function islandShim(c: Compiled, compiled?: Map<string, Compiled>, routeRoots?: ReadonlySet<string>): string {
   const clientOnly = c.ir.tier?.React?.client_only === true
   const nested = compiled && nestedOf(compiled, c.id, routeRoots)
-  const element = nested ? `__mk(Comp, props, ${JSON.stringify(xOf(compiled!, c.id))})` : 'createElement(Comp, props)'
+  const element = nested ? `__mk(Comp, props, ${JSON.stringify(xOf(compiled!, c.id))}, ${JSON.stringify(holesOf(compiled!, c.id))})` : 'createElement(Comp, props)'
   const [api, mount] = clientOnly
     ? ['createRoot', `createRoot(host, { identifierPrefix: ${JSON.stringify(c.id)} }).render(${element})`]
     : ['hydrateRoot', `hydrateRoot(host, ${element}, { identifierPrefix: ${JSON.stringify(c.id)} })`]
@@ -559,6 +602,22 @@ export async function buildCacheAdapter(dist: string, entry: string, cssMaps: Ma
   return 'cache-adapter.js'
 }
 
+/** R34.96: a parent's job calls the job of each child fused into it through `brust-job:<component id>`, resolved here to
+ * that child's staged job module (`fileOf`). Only a compiled component's id resolves: anything else fails the bundle. */
+export function jobImportPlugin(fileOf: (id: string) => string | undefined): BunPlugin {
+  return {
+    name: 'brust-job-import',
+    setup(b) {
+      b.onResolve({ filter: /^brust-job:/ }, (a) => {
+        const id = a.path.slice('brust-job:'.length)
+        const file = /^[A-Za-z0-9_$-]+$/.test(id) ? fileOf(id) : undefined
+        if (file === undefined) throw new BuildError('bundle', `${a.importer}: no job module for ${JSON.stringify(id)}`)
+        return { path: file }
+      })
+    },
+  }
+}
+
 /** `dist/jobs.js` (`target: 'bun'`, React and `@brust/core` external): default export
  * `{ [componentId]: { precompute?, ssr? } }`; `ssr` only for react-tier, non-client_only components. */
 export async function buildJobs(
@@ -569,6 +628,8 @@ export async function buildJobs(
   stores: string[] = [],
   cssMaps: Map<string, Record<string, string>> = new Map(),
   routeRoots?: ReadonlySet<string>,
+  /** F183 (`reachedJobs`): only these entries are written; every one when absent. */
+  reached?: { planned: ReadonlySet<string>; ssr: ReadonlySet<string> },
 ): Promise<void> {
   const imports: string[] = ["import { createElement } from 'react'", "import { renderToString } from 'react-dom/server'"]
   const entries: string[] = []
@@ -592,17 +653,20 @@ export async function buildJobs(
   for (const c of compiled.values()) {
     const fns: string[] = []
     if (c.serverTs !== undefined) {
+      // Staged even when unreached: a parent's fused job imports it (`brust-job:<id>`, R34.96).
       const file = join(dist, 'jobs', `${c.id}.server.ts`)
       write(file, c.serverTs)
       stage(sourceOf, file, c)
-      imports.push(`import * as j${n} from ${JSON.stringify(file)}`)
-      fns.push(`precompute: j${n}.precompute`)
+      if (reached === undefined || reached.planned.has(c.id)) {
+        imports.push(`import * as j${n} from ${JSON.stringify(file)}`)
+        fns.push(`precompute: j${n}.precompute`)
+      }
     }
-    if (isReact(c) && !c.ir.tier.React.client_only) {
+    if (isReact(c) && !c.ir.tier.React.client_only && (reached === undefined || reached.ssr.has(c.id))) {
       imports.push(componentImport(c, `C${n}`))
       // Ruling 2bf3775a (R1): the island's component id prefixes React's useId on BOTH sides
       // (the shim's hydrateRoot passes the same prefix), so ids differ across islands.
-      fns.push(`ssr: (props: any) => renderToString(${hosts.has(c.id) ? `__mk(C${n}, props, ${JSON.stringify(xOf(compiled, c.id))})` : `createElement(C${n}, props)`}, { identifierPrefix: ${JSON.stringify(c.id)} })`)
+      fns.push(`ssr: (props: any) => renderToString(${hosts.has(c.id) ? `__mk(C${n}, props, ${JSON.stringify(xOf(compiled, c.id))}, ${JSON.stringify(holesOf(compiled, c.id))})` : `createElement(C${n}, props)`}, { identifierPrefix: ${JSON.stringify(c.id)} })`)
     }
     if (fns.length > 0) entries.push(`  ${JSON.stringify(c.id)}: { ${fns.join(', ')} },`)
     n++
@@ -615,7 +679,14 @@ export async function buildJobs(
     format: 'esm',
     define: PRODUCTION,
     external: JOBS_EXTERNALS,
-    plugins: [serverOnlyEmptyPlugin(), cssPlugin(cssMaps), workerStorePlugin, sourceDirPlugin(sourceOf, appRoot, JOBS_EXTERNALS), exposePlugin(compiled)],
+    plugins: [
+      jobImportPlugin((id) => (compiled.get(id)?.serverTs !== undefined ? join(dist, 'jobs', `${id}.server.ts`) : undefined)),
+      serverOnlyEmptyPlugin(),
+      cssPlugin(cssMaps),
+      workerStorePlugin,
+      sourceDirPlugin(sourceOf, appRoot, JOBS_EXTERNALS),
+      exposePlugin(compiled),
+    ],
   })
   if (!res.success) throw new BuildError('bundle', `jobs: ${res.logs.map(String).join('\n')}`)
   write(join(dist, 'jobs.js'), await res.outputs[0]!.text())

package/src/build/compile.ts

@@ -38,6 +38,8 @@ export type ComponentIR = Record<string, any> & {
     inputs: Record<string, unknown>
     outputs: string[]
     stubs?: { source: string; code: string }[]
+    /** R34.96: the job modules fused into the child's job, which it imports (`FusedEvalJob`). */
+    fused?: { child_id: string; stubs?: { source: string; code: string }[] }[]
     line: number
     col: number
   }[]
@@ -52,7 +54,7 @@ export type ComponentIR = Record<string, any> & {
   /** The binding a React island imports this component by from `source` (absent: the default export). */
   export?: string
   /** Child components; `nested` is set when this file passes lowered JSX children to that child, an island (shadcn S1). */
-  children?: { id: string | null; nested?: string[]; x?: string[]; [field: string]: unknown }[]
+  children?: { id: string | null; nested?: string[]; x?: string[]; holes?: string[]; [field: string]: unknown }[]
 }
 
 export interface Compiled {

package/src/build/index.ts

@@ -19,7 +19,7 @@ import { buildCss, CssGraph, directCss, resolveGlobals, routeCssSources } from '
 import { type ActionsBuildConfig, type CacheBuildConfig, loadBuildConfig } from './config'
 import { BuildError } from './errors'
 import { importsStore } from './features'
-import { type CacheRecord, type ManifestJson, tierOf, writeManifest } from './manifest'
+import { type CacheRecord, type ManifestJson, needsWorkers, reachedJobs, tierOf, writeManifest } from './manifest'
 import { scanRoutes } from './scan'
 import { type ExprReads, prepareStatic, writeStatic } from './static'
 import { writeStaticWorker } from './static-worker'
@@ -289,13 +289,14 @@ async function buildInto(
     const files = [...new Set((routeCss.get(r.id) ?? []).flatMap((s) => (css.file.has(s) ? [css.file.get(s)!] : [])))]
     if (files.length > 0) r.css = files
   }
-  await buildJobs(out, compiled, ctx.sourceOf, appRoot, storeModules(manifest), css.maps, routeRoots)
+  await buildJobs(out, compiled, ctx.sourceOf, appRoot, storeModules(manifest), css.maps, routeRoots, reachedJobs(manifest))
   manifest.actions =
     o.actions && o.actionsEntry
       ? { entry: await buildActions(out, o.actionsEntry, css.maps), prefix: o.actions.prefix, maxBodyBytes: o.actions.maxBodyBytes, maxResponseBytes: o.actions.maxResponseBytes, crossSite: o.actions.crossSite }
       : null
   if (o.actionsRemote !== null) manifest.actions_remote = { prefix: o.actionsRemote }
   if (o.cache) manifest.cache = await cacheRecord(out, manifest, o.cache, o.cacheModule, css.maps)
+  manifest.needs_workers = needsWorkers(manifest)
   writeFileSync(join(out, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`)
   if (o.dev) writeFileSync(join(out, 'dev.json'), `${JSON.stringify(devJson(appRoot, compiled), null, 2)}\n`)
   writeFileSync(join(out, MARKER), 'generated by `brust build`: this directory is replaced on every build\n')

package/src/build/manifest.ts

@@ -88,6 +88,33 @@ export interface ManifestJson {
   actions_remote?: { prefix: string }
   /** `[cache]` (cache adapters); absent without one (the manifest is then byte-identical). */
   cache?: CacheRecord
+  /** F165 (R40.1): `brust start` spawns its worker pool (`needsWorkers`). Read by `run.ts` only; an
+   * absent value (an older or actions-only manifest) means the pool is needed. */
+  needs_workers?: boolean
+}
+
+/** F165 (R40.1): whether any request can call a worker. Workers answer four kinds of call
+ * (worker.ts): `loader`, `jobs` (precompute and SSR), `fetch` (the local actions app) and `cache`
+ * (the adapter). Only the jobs a request can plan count (`reachedJobs`, F183). */
+export function needsWorkers(m: Pick<ManifestJson, 'routes' | 'components' | 'actions' | 'cache'>): boolean {
+  const planned = [...reachedJobs(m).planned].some((id) => (m.components[id]?.jobs.length ?? 0) > 0)
+  return planned || m.routes.some((r) => r.loaders.length > 0) || m.actions !== null || m.cache !== undefined
+}
+
+/** F183: the jobs a request can call, as brust-core plans them (`collect_jobs`, pipeline.rs): every job of each
+ * route chain component and of each of its direct `children[]` records (`planned`; nothing deeper has a job,
+ * `linkNativeChunks`), and the `ssr` of each component one of those jobs targets (`ssr`; the worker runs the
+ * target's, handlers.ts). `jobs.js` leaves out every other entry: no request reaches it. */
+export function reachedJobs(m: Pick<ManifestJson, 'routes' | 'components'>): { planned: Set<string>; ssr: Set<string> } {
+  const planned = new Set<string>()
+  for (const r of m.routes)
+    for (const id of r.chain) {
+      planned.add(id)
+      for (const ch of m.components[id]?.children ?? []) planned.add(ch.id)
+    }
+  const ssr = new Set<string>()
+  for (const id of planned) for (const j of m.components[id]?.jobs ?? []) if (j.kind === 'ssr' && j.target !== undefined) ssr.add(j.target)
+  return { planned, ssr }
 }
 
 /** `manifest.cache` / `CONFIG.cache`: the adapter the runtime loads (`cache-adapter/load.ts`). */
@@ -346,6 +373,8 @@ function linkNativeChunks(routes: RouteRecord[], compiled: Map<string, Compiled>
   const chainIds = new Set(routes.flatMap((r) => r.chain))
   for (const root of chainIds) {
     const rec = components[root]!
+    // A React root renders its whole subtree itself: whatever native chunks its IR lists are not served.
+    if (rec.tier === 'react') continue
     const linked = new Set(rec.children.map((ch) => ch.id))
     const seen = new Set([root])
     const walk = (id: string) => {

package/src/cli.ts

@@ -6,12 +6,14 @@ import { BuildError, runBuild } from './build'
 import { runBunDev } from './dev/bun'
 import { runDev } from './dev'
 import { run } from './run'
+import { shadcnInit, spawnRunner } from './shadcn/init'
 
 const USAGE = `usage:
   brust build [entry=routes.tsx] [--out-dir dist] [--force] [--target bun|cloudflare|static] [--actions-only] [--strict] [--wasm-from-source] [--dev]
   brust dev [entry=routes.tsx] [--port N] [--workers N]    (Bun target: proxy + hot reload + inline TUI)
   brust dev [entry=routes.tsx] --target cloudflare [--out-dir dist] [--port N] [--wasm-from-source] [-- <wrangler args>]
   brust start [--port N] [--workers N] [--dist-dir dist] [--entry routes.tsx]
+  brust shadcn init [component ...] [--force] [--css <file>] [--base-color <name>] [--shadcn-version <x.y.z>]
 
 Config precedence for start: env (BRUST_ADDR, BRUST_PORT, BRUST_WORKERS, BRUST_RENDER_SLOTS,
 BRUST_DRAIN_TIMEOUT_MS, BRUST_BOOT_TIMEOUT_MS, BRUST_DIST_DIR, BRUST_APP_ENTRY) > flags
@@ -53,6 +55,9 @@ export async function main(argv: string[]): Promise<void> {
         port: { type: 'string' },
         workers: { type: 'string' },
         force: { type: 'boolean' },
+        css: { type: 'string' },
+        'base-color': { type: 'string' },
+        'shadcn-version': { type: 'string' },
         strict: { type: 'boolean' },
         target: { type: 'string' },
         'wasm-from-source': { type: 'boolean' },
@@ -127,6 +132,21 @@ export async function main(argv: string[]): Promise<void> {
       process.exit(1)
     }
   }
+  if (cmd === 'shadcn') {
+    const [sub, ...components] = positionals
+    if (sub !== 'init') usage(`shadcn takes a subcommand: init (got ${sub === undefined ? 'none' : JSON.stringify(sub)})`)
+    const code = await shadcnInit({
+      root: process.cwd(),
+      components,
+      force: values.force === true,
+      ...(str('css') !== undefined && { css: str('css') }),
+      ...(str('base-color') !== undefined && { baseColor: str('base-color') }),
+      ...(str('shadcn-version') !== undefined && { shadcnVersion: str('shadcn-version') }),
+      run: spawnRunner,
+      out: (s) => console.log(s),
+    })
+    process.exit(code)
+  }
   if (cmd === 'start') {
     if (positionals.length > 0) usage(`start takes no positional arguments (got ${positionals.join(' ')})`)
     const port = intFlag('port', str('port'), 0)

package/src/run.ts

@@ -4,6 +4,8 @@
 // once (130 / 143); a signal before every worker registered exits 0 at once (nothing is being
 // served yet, and the server's drain only starts once it accepts). A worker that dies (error,
 // process.exit, OOM) → drain → exit 1: M2 does not respawn, the supervisor restarts the process.
+// F165: a build whose manifest says `needs_workers: false` (no loader, job, actions app or cache
+// adapter) spawns none; the server then serves at once and a stray worker call answers 503.
 // Nothing here returns on its own: a started server keeps the process alive and a drained one
 // does not end it, so every exit is an explicit `process.exit`.
 import { existsSync, readFileSync } from 'node:fs'
@@ -32,6 +34,13 @@ export interface RunManifest {
   actions_remote?: { prefix: string } | null
   /** `[cache]`: the server's L2 settings (the workers load the adapter itself). */
   cache?: { adapter: string; getTimeoutMs: number; maxBodyBytes: number; namespace: string; buildId: string } | null
+  /** F165: `false` = no route can call a worker; absent (older manifests) = the pool is needed. */
+  needs_workers?: boolean
+}
+
+/** F165 (R40.1): the pool size `run` spawns: none only when the build said no request needs one. */
+export function workerCount(cfg: BrustConfig, m: RunManifest): number {
+  return m.needs_workers === false ? 0 : cfg.workers
 }
 
 /** Pure: the napi `StartOptions`. No actions/cors/cache → exactly the pre-actions keys. */
@@ -40,7 +49,7 @@ export function startOptions(cfg: BrustConfig, distDir: string, m: RunManifest,
     host: cfg.host,
     port: cfg.port,
     distDir,
-    workers: cfg.workers,
+    workers: workerCount(cfg, m),
     callTimeoutMs: cfg.callTimeoutMs,
     ...(cfg.maxLoaderResponseBytes !== undefined && cfg.maxLoaderResponseBytes !== DEFAULT_MAX_LOADER_RESPONSE_BYTES ? { maxLoaderResponseBytes: cfg.maxLoaderResponseBytes } : {}),
     workerThreads: cfg.ioThreads,
@@ -134,8 +143,9 @@ export async function run(opts: RunOptions = {}): Promise<void> {
       .finally(() => exit(failed ? 1 : code))
   }
 
+  const workers = workerCount(cfg, m)
   const url = new URL('./worker.ts', import.meta.url)
-  for (let i = 0; i < cfg.workers; i++) {
+  for (let i = 0; i < workers; i++) {
     // The response buffer is owned HERE, for the process lifetime: the Rust dispatcher keeps a raw
     // pointer into it, so it must not be freed with the worker (crates/brust-napi dispatch.rs).
     const sab = new SharedArrayBuffer(cfg.slotBytes * cfg.renderSlots)
@@ -180,7 +190,7 @@ export async function run(opts: RunOptions = {}): Promise<void> {
     fail(`workers not ready: ${String((e as Error).message ?? e)} (BRUST_BOOT_TIMEOUT_MS=${cfg.bootTimeoutMs})`)
   }
   ready = true
-  console.log(`[brust] ready (${cfg.workers} worker${cfg.workers === 1 ? '' : 's'})`)
+  console.log(`[brust] ready (${workers} worker${workers === 1 ? '' : 's'})`)
   if (opts.onReady) {
     let code = 1
     try {

package/src/shadcn/init.ts

@@ -0,0 +1,254 @@
+// `brust shadcn init [component ...]`: sets a brust project up for shadcn/ui and adds components (F175, R41.1-R41.10).
+// shadcn's own `init` does not detect brust, so this writes what `add` needs (components.json, the `@/*` path),
+// installs the four packages the components import, and runs ONE pinned shadcn CLI for the theme and the components.
+// Every child process is spawned from an argv array, never through a shell; the runner is injected for tests.
+import { existsSync, lstatSync, readFileSync, writeFileSync } from 'node:fs'
+import { isAbsolute, join, relative, resolve } from 'node:path'
+import { type ObjectNode, raw, readObject } from './jsonc'
+
+/** The shadcn CLI version this command runs (R41.6). A release that moves it re-runs the transcript. */
+export const SHADCN_VERSION = '4.21.4'
+
+/**
+ * The packages the components import (R41.5), each pinned to the exact version the transcript ran
+ * (`docs/transcripts/shadcn-init-guide.md`, F181). They move together with `SHADCN_VERSION`: a release that moves one
+ * re-runs the transcript. A package the project already depends on, at any version, is left alone.
+ */
+export const SHADCN_DEP_PINS = {
+  'radix-ui': '1.8.1',
+  'lucide-react': '1.57.0',
+  'class-variance-authority': '0.7.1',
+  'tw-animate-css': '1.4.0',
+} as const
+export const SHADCN_DEPS = Object.keys(SHADCN_DEP_PINS) as (keyof typeof SHADCN_DEP_PINS)[]
+
+/** Runs `argv` in `cwd` with the terminal attached; resolves to the exit code. Never a shell string. */
+export type Runner = (argv: string[], cwd: string) => Promise<number>
+
+export interface InitOptions {
+  /** Project root (cwd). */
+  root: string
+  components: string[]
+  force?: boolean
+  css?: string
+  baseColor?: string
+  shadcnVersion?: string
+  run: Runner
+  out: (line: string) => void
+}
+
+const COMPONENT = /^[a-z0-9][a-z0-9-]*$/
+const REGISTRY_URL = /^https:\/\/[^\s]+$/
+const VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/
+const COLOR = /^[a-z]+$/
+
+/** True for a symlink, also a dangling one (`existsSync` follows links and says false for those). */
+function isLink(path: string): boolean {
+  try {
+    return lstatSync(path).isSymbolicLink()
+  } catch {
+    return false
+  }
+}
+
+/** The name a registry URL installs: its last path segment without `.json`; undefined when it is not a plain name. */
+function urlItemName(url: string): string | undefined {
+  try {
+    const seg = new URL(url).pathname.split('/').filter(Boolean).pop()?.replace(/\.json$/, '')
+    return seg !== undefined && COMPONENT.test(seg) ? seg : undefined
+  } catch {
+    return undefined
+  }
+}
+
+/** The `components.json` of the tested fixture (`tests/fixtures/shadcn/components.json`), for `css` and `baseColor` (R41.2). */
+export function componentsJson(css: string, baseColor: string): string {
+  return `{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": { "config": "", "css": ${JSON.stringify(css)}, "baseColor": ${JSON.stringify(baseColor)}, "cssVariables": true, "prefix": "" },
+  "iconLibrary": "lucide",
+  "aliases": { "components": "@/components", "utils": "@/lib/utils", "ui": "@/components/ui", "lib": "@/lib", "hooks": "@/hooks" }
+}
+`
+}
+
+export type PathEdit =
+  | { kind: 'added'; text: string }
+  | { kind: 'present' }
+  | { kind: 'other'; target: string }
+  | { kind: 'unparseable'; why: string }
+
+const ENTRY = '"@/*": ["./*"]'
+
+/** The separator before a non-empty object's first member, so the new entry takes the same line and indent. */
+function lead(text: string, o: ObjectNode): string {
+  const first = o.members[0]
+  if (!first) return ' '
+  const nl = text.lastIndexOf('\n', first.keyStart)
+  const indent = nl > o.open ? text.slice(nl + 1, first.keyStart) : ''
+  if (nl > o.open && /^\s*$/.test(indent)) return `\n${indent}`
+  const same = text.slice(o.open + 1, first.keyStart)
+  return /^\s*$/.test(same) ? same : ' '
+}
+
+/** Adds `"@/*": ["./*"]` to `compilerOptions.paths` as a text splice (R41.4): comments and layout are kept. */
+export function addAliasPath(text: string): PathEdit {
+  let top: ObjectNode
+  try {
+    top = readObject(text)
+  } catch (e) {
+    return { kind: 'unparseable', why: (e as Error).message }
+  }
+  const co = top.members.find((m) => m.key === 'compilerOptions')?.object
+  if (!co) return { kind: 'unparseable', why: 'no compilerOptions object' }
+  const pathsMember = co.members.find((m) => m.key === 'paths')
+  if (!pathsMember) {
+    const ws = lead(text, co)
+    const body = co.members.length > 0 ? `${ws}"paths": { ${ENTRY} },` : ` "paths": { ${ENTRY} } `
+    return { kind: 'added', text: text.slice(0, co.open + 1) + body + text.slice(co.open + 1) }
+  }
+  const paths = pathsMember.object
+  if (!paths) return { kind: 'unparseable', why: 'compilerOptions.paths is not an object' }
+  const existing = paths.members.find((m) => m.key === '@/*')
+  if (existing) {
+    const target = raw(text, existing)
+    return target.replace(/\s+/g, '') === '["./*"]' ? { kind: 'present' } : { kind: 'other', target }
+  }
+  const ws = lead(text, paths)
+  const body = paths.members.length > 0 ? `${ws}${ENTRY},` : ` ${ENTRY} `
+  return { kind: 'added', text: text.slice(0, paths.open + 1) + body + text.slice(paths.open + 1) }
+}
+
+/** The Tailwind entry CSS: `--css`, else the one top-level `*.css` that imports `tailwindcss` (R41.3). */
+function tailwindEntry(root: string, css: string | undefined): { css: string } | { error: string } {
+  if (css !== undefined) {
+    const abs = resolve(root, css)
+    const rel = relative(root, abs)
+    if (css.startsWith('-') || isAbsolute(css) || rel.startsWith('..') || !existsSync(abs)) {
+      return { error: `--css ${JSON.stringify(css)} must be an existing CSS file inside the project` }
+    }
+    return { css: rel.split('\\').join('/') }
+  }
+  const hit = ['app.css', 'styles.css', 'global.css', 'globals.css', 'index.css'].filter((f) => {
+    const p = join(root, f)
+    return existsSync(p) && /@import\s+["']tailwindcss["']/.test(readFileSync(p, 'utf8'))
+  })
+  if (hit.length === 1) return { css: hit[0]! }
+  return { error: hit.length === 0 ? 'cannot tell which CSS file is the Tailwind entry; pass --css <file>' : `more than one Tailwind entry (${hit.join(', ')}); pass --css <file>` }
+}
+
+type Step = 'done' | 'skipped' | 'failed'
+
+/** Returns the process exit code: 0 ok, 2 usage / not a brust project, else the failing child's code. */
+export async function shadcnInit(o: InitOptions): Promise<number> {
+  const { root, out } = o
+  const fail2 = (msg: string): number => {
+    out(`error shadcn-init ${msg}`)
+    return 2
+  }
+  // R41.1: a brust project root.
+  const pkgPath = join(root, 'package.json')
+  if (!existsSync(pkgPath)) return fail2('no package.json here: run it in the root of a brust project')
+  let pkg: { dependencies?: Record<string, string>; devDependencies?: Record<string, string> }
+  try {
+    pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+  } catch {
+    return fail2('package.json is not valid JSON')
+  }
+  if (!pkg.dependencies?.['@brust/core'] && !pkg.devDependencies?.['@brust/core']) {
+    return fail2('package.json does not depend on @brust/core: run it in the root of a brust project')
+  }
+  // R41.8: validate everything that reaches an argv before anything is written.
+  for (const c of o.components) {
+    if (!COMPONENT.test(c) && !REGISTRY_URL.test(c)) return fail2(`component ${JSON.stringify(c)} must match ^[a-z0-9][a-z0-9-]*$ or be an https:// registry URL`)
+  }
+  const version = o.shadcnVersion ?? SHADCN_VERSION
+  if (!VERSION.test(version)) return fail2(`--shadcn-version ${JSON.stringify(version)} must be an exact version like ${SHADCN_VERSION}`)
+  const baseColor = o.baseColor ?? 'neutral'
+  if (!COLOR.test(baseColor)) return fail2(`--base-color ${JSON.stringify(baseColor)} must be a lowercase colour name`)
+  const entry = tailwindEntry(root, o.css)
+  if ('error' in entry) return fail2(entry.error)
+  // F181: never write through a symlink (the target may be outside the project, e.g. a shared tsconfig). Fail-safe:
+  // refuse before the first write, even with --force; the reader edits the real file by hand.
+  const cj = join(root, 'components.json')
+  const tsPath = join(root, 'tsconfig.json')
+  if (isLink(tsPath)) return fail2('tsconfig.json is a symbolic link; refusing to write through it. Add "@/*": ["./*"] to compilerOptions.paths of the real file yourself, then run again')
+  if (isLink(cj) && (!existsSync(cj) || o.force)) return fail2('components.json is a symbolic link; refusing to write through it. Replace it with a real file or remove the link, then run again')
+
+  const report = (name: string, step: Step, why = ''): void => out(`${step === 'done' ? '✓' : step === 'skipped' ? '-' : '✗'} ${name}: ${step}${why ? ` (${why})` : ''}`)
+  const stop = (name: string, code: number): number => {
+    report(name, 'failed', `exit ${code}`)
+    out(`error shadcn-init ${name} failed with exit code ${code}; fix it and run the command again (finished steps are skipped)`)
+    return code
+  }
+
+  // R41.2: components.json.
+  if (!existsSync(cj) || o.force) {
+    writeFileSync(cj, componentsJson(entry.css, baseColor))
+    report('components.json', 'done', entry.css)
+  } else report('components.json', 'skipped', 'exists; --force replaces it')
+
+  // R41.4: the `@/*` path.
+  if (!existsSync(tsPath)) {
+    report('tsconfig.json', 'skipped', `no tsconfig.json; add ${JSON.stringify({ compilerOptions: { paths: { '@/*': ['./*'] } } })}`)
+  } else {
+    const edit = addAliasPath(readFileSync(tsPath, 'utf8'))
+    if (edit.kind === 'added') {
+      writeFileSync(tsPath, edit.text)
+      report('tsconfig.json', 'done', 'added "@/*": ["./*"] under compilerOptions.paths')
+    } else if (edit.kind === 'present') report('tsconfig.json', 'skipped', '"@/*" is already there')
+    else if (edit.kind === 'other') report('tsconfig.json', 'skipped', `warning: "@/*" already points at ${edit.target}; shadcn's imports need ["./*"]`)
+    else report('tsconfig.json', 'skipped', `not edited (${edit.why}); add this line to compilerOptions.paths yourself: ${ENTRY}`)
+  }
+
+  // R41.5: dependencies.
+  const have = { ...pkg.devDependencies, ...pkg.dependencies }
+  const missing = SHADCN_DEPS.filter((d) => !have[d])
+  if (missing.length === 0) report('dependencies', 'skipped', 'all four are installed')
+  else {
+    const specs = missing.map((d) => `${d}@${SHADCN_DEP_PINS[d]}`)
+    const code = await o.run(['bun', 'add', ...specs], root)
+    if (code !== 0) return stop('bun add', code)
+    report('dependencies', 'done', specs.join(' '))
+  }
+
+  // R41.6 / R41.7: the pinned shadcn CLI. `bun x` is `bunx`; argv only.
+  const shadcn = (...args: string[]): string[] => ['bun', 'x', `shadcn@${version}`, ...args]
+  const cssText = readFileSync(join(root, entry.css), 'utf8')
+  if (cssText.includes('shadcn/tailwind.css') && !o.force) report('theme', 'skipped', `${entry.css} already has the shadcn theme; --force runs it again`)
+  else {
+    const code = await o.run(shadcn('add', 'index', '-y'), root)
+    if (code !== 0) return stop('shadcn add index', code)
+    report('theme', 'done', `shadcn@${version} add index`)
+  }
+  // A component whose file is already in components/ui is not added again (idempotent). A registry URL is judged by
+  // the item name in its path (`.../acme-card.json` → `acme-card`), looked up in components/ui and components.
+  const present = (c: string): boolean => {
+    const name = REGISTRY_URL.test(c) ? urlItemName(c) : c
+    if (name === undefined) return false
+    return existsSync(join(root, 'components/ui', `${name}.tsx`)) || (name !== c && existsSync(join(root, 'components', `${name}.tsx`)))
+  }
+  const todo = o.components.filter((c) => o.force || !present(c))
+  for (const c of o.components) if (!todo.includes(c)) report(c, 'skipped', REGISTRY_URL.test(c) ? 'its item is already in components; --force adds it again' : 'components/ui already has it')
+  for (const c of todo) if (REGISTRY_URL.test(c)) out(`warning shadcn-init ${c} is third-party code: it is written into your project and runs in your build and in the browser. Read it before you ship`)
+  if (todo.length > 0) {
+    const code = await o.run(shadcn('add', ...todo, '-y'), root)
+    if (code !== 0) return stop(`shadcn add ${todo.join(' ')}`, code)
+    for (const c of todo) report(c, 'done')
+  }
+
+  out('')
+  out('next:')
+  out("  import the components from './components/ui/<name>' in a page and add the route to routes.tsx")
+  out('  bun run build')
+  return 0
+}
+
+/** The real runner: argv spawn with the terminal attached, no shell. */
+export const spawnRunner: Runner = async (argv, cwd) => {
+  const p = Bun.spawn(argv, { cwd, stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' })
+  return await p.exited
+}

package/src/shadcn/jsonc.ts

@@ -0,0 +1,129 @@
+// A minimal JSONC reader that keeps byte offsets, so a file can be edited with a text splice (comments, trailing
+// commas and formatting survive). It does not build values; it finds object members. Anything it cannot read throws.
+
+export interface Member {
+  key: string
+  /** Offset of the member's key (its opening quote). */
+  keyStart: number
+  /** Offset of the member's value (the `{` of an object value). */
+  value: number
+  /** Offset just past the value. */
+  end: number
+  /** Parsed object when the value is an object, else `undefined`. */
+  object?: ObjectNode
+}
+
+export interface ObjectNode {
+  /** Offset of `{`. */
+  open: number
+  /** Offset of `}`. */
+  close: number
+  members: Member[]
+}
+
+class Reader {
+  i = 0
+  constructor(readonly s: string) {}
+
+  ws(): void {
+    const { s } = this
+    for (;;) {
+      const c = s[this.i]
+      if (c === ' ' || c === '\t' || c === '\n' || c === '\r' || c === '') this.i++
+      else if (c === '/' && s[this.i + 1] === '/') {
+        while (this.i < s.length && s[this.i] !== '\n') this.i++
+      } else if (c === '/' && s[this.i + 1] === '*') {
+        const e = s.indexOf('*/', this.i + 2)
+        if (e < 0) throw new Error('unterminated comment')
+        this.i = e + 2
+      } else return
+    }
+  }
+
+  string(): string {
+    const { s } = this
+    if (s[this.i] !== '"') throw new Error(`expected a string at ${this.i}`)
+    let j = this.i + 1
+    let out = ''
+    while (j < s.length && s[j] !== '"') {
+      if (s[j] === '\\') {
+        out += s[j + 1] ?? ''
+        j += 2
+      } else if (s[j] === '\n') throw new Error('newline in a string')
+      else out += s[j++]
+    }
+    if (s[j] !== '"') throw new Error('unterminated string')
+    this.i = j + 1
+    return out
+  }
+
+  /** Skips one value; returns its object node when it is an object. */
+  value(): ObjectNode | undefined {
+    this.ws()
+    const c = this.s[this.i]
+    if (c === '{') return this.object()
+    if (c === '[') {
+      this.i++
+      for (;;) {
+        this.ws()
+        if (this.s[this.i] === ']') {
+          this.i++
+          return undefined
+        }
+        this.value()
+        this.ws()
+        if (this.s[this.i] === ',') this.i++
+        else if (this.s[this.i] !== ']') throw new Error(`expected , or ] at ${this.i}`)
+      }
+    }
+    if (c === '"') {
+      this.string()
+      return undefined
+    }
+    const m = /^(?:-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?|true|false|null)/.exec(this.s.slice(this.i, this.i + 40))
+    if (!m) throw new Error(`unexpected character at ${this.i}`)
+    this.i += m[0].length
+    return undefined
+  }
+
+  object(): ObjectNode {
+    const open = this.i
+    this.i++
+    const members: Member[] = []
+    for (;;) {
+      this.ws()
+      if (this.s[this.i] === '}') {
+        this.i++
+        return { open, close: this.i - 1, members }
+      }
+      const keyStart = this.i
+      const key = this.string()
+      this.ws()
+      if (this.s[this.i] !== ':') throw new Error(`expected : at ${this.i}`)
+      this.i++
+      this.ws()
+      const value = this.i
+      const object = this.value()
+      members.push({ key, keyStart, value, end: this.i, ...(object && { object }) })
+      this.ws()
+      if (this.s[this.i] === ',') this.i++
+      else if (this.s[this.i] !== '}') throw new Error(`expected , or } at ${this.i}`)
+    }
+  }
+}
+
+/** The top-level object of a JSONC text. Throws on anything that is not JSONC. */
+export function readObject(text: string): ObjectNode {
+  const r = new Reader(text)
+  r.ws()
+  if (text[r.i] !== '{') throw new Error('not an object')
+  const o = r.object()
+  r.ws()
+  if (r.i !== text.length) throw new Error('trailing content')
+  return o
+}
+
+/** The raw text of a member's value. */
+export function raw(text: string, m: Member): string {
+  return text.slice(m.value, m.end)
+}