@solidjs/compiler 2.0.0-rc.3 → 2.0.0-rc.4

package/index.js

@@ -234,7 +234,10 @@ const nativeOptionKeys = new Set([
   "omitLastClosingTag",
   "serverComponents",
   "builtIns",
-  "renderers"
+  "renderers",
+  // Patch-mode dual driver (stage 2, dormant by default): accepted so an
+  // explicit opt-in reaches the native core (napi maps to patch_driver).
+  "patchDriver"
 ]);
 
 function validateOptions(code, options) {
@@ -277,6 +280,19 @@ function validateOptions(code, options) {
       nativeOptions.validate = value;
       continue;
     }
+    if (key === "patchDriver") {
+      if (typeof value !== "string" && typeof value !== "boolean") {
+        throw new TypeError(
+          "@solidjs/compiler `patchDriver` option must be a string import name or boolean"
+        );
+      }
+      // The napi wrapper mapping collapses boolean `true` into
+      // Wrapper::Default, which patch_driver treats as disabled (dormant
+      // default). Normalize the boolean opt-in to the default import name so
+      // it survives the native mapping.
+      nativeOptions.patchDriver = value === true ? "patchDriver" : value;
+      continue;
+    }
     if (nativeOptionKeys.has(key)) {
       if (key === "renderers") validateRenderers(value);
       nativeOptions[key] = value;
@@ -343,12 +359,10 @@ function requireBinding() {
   let nativeError;
   const suffix = platformArchSuffix();
 
-  if (suffix) {
-    const next = tryPackage(`@solidjs/compiler-${suffix}`);
-    if (next.binding) return next.binding;
-    if (next.error) nativeError = next.error;
-  }
-
+  // Local builds first: the published package ships no local binary (see
+  // "files"), so a `compiler.node` next to this file can only be a
+  // development build — which must shadow the installed platform package,
+  // or the monorepo's own tests silently run against the last release.
   const localCandidates = [];
   if (suffix) localCandidates.push(`compiler.${suffix}.node`);
   localCandidates.push("compiler.node");
@@ -358,12 +372,20 @@ function requireBinding() {
       try {
         return require(full);
       } catch (error) {
-        nativeError = error;
-        break;
+        // A present-but-unloadable dev build is an error, not a fallback:
+        // degrading to the published binary would silently test stale code.
+        error.message += `\nA local development build (${file}) exists but could not be loaded. Rebuild with \`pnpm run build:debug\` or delete it to use the installed @solidjs/compiler-* package.`;
+        throw error;
       }
     }
   }
 
+  if (suffix) {
+    const next = tryPackage(`@solidjs/compiler-${suffix}`);
+    if (next.binding) return next.binding;
+    if (next.error) nativeError = next.error;
+  }
+
   const wasi = requireWasi();
   if (wasi) return wasi;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@solidjs/compiler",
   "description": "Solid's native Oxc JSX compiler",
-  "version": "2.0.0-rc.3",
+  "version": "2.0.0-rc.4",
   "author": "Ryan Carniato",
   "license": "MIT",
   "repository": {
@@ -62,11 +62,11 @@
     "emnapi": "^1.11.3"
   },
   "optionalDependencies": {
-    "@solidjs/compiler-darwin-x64": "2.0.0-rc.3",
-    "@solidjs/compiler-darwin-arm64": "2.0.0-rc.3",
-    "@solidjs/compiler-linux-x64-gnu": "2.0.0-rc.3",
-    "@solidjs/compiler-linux-arm64-gnu": "2.0.0-rc.3",
-    "@solidjs/compiler-win32-x64-msvc": "2.0.0-rc.3",
-    "@solidjs/compiler-wasm32-wasi": "2.0.0-rc.3"
+    "@solidjs/compiler-darwin-x64": "2.0.0-rc.4",
+    "@solidjs/compiler-darwin-arm64": "2.0.0-rc.4",
+    "@solidjs/compiler-linux-x64-gnu": "2.0.0-rc.4",
+    "@solidjs/compiler-linux-arm64-gnu": "2.0.0-rc.4",
+    "@solidjs/compiler-win32-x64-msvc": "2.0.0-rc.4",
+    "@solidjs/compiler-wasm32-wasi": "2.0.0-rc.4"
   }
 }

package/types.d.ts

@@ -20,6 +20,15 @@ export interface TransformOptions {
   omitNestedClosingTags?: boolean;
   omitLastClosingTag?: boolean;
   serverComponents?: boolean;
+  /**
+   * Patch-mode dual driver (dormant by default): `true` or an import name
+   * (`"patchDriver"`) opts compiled templates whose bindings are pure member
+   * reads of one subject into the store patch channel. The loader normalizes
+   * `true` to the default import name (the napi wrapper mapping treats bare
+   * booleans as "default", which this option reads as disabled).
+   * @default false
+   */
+  patchDriver?: boolean | string;
   /** Default `["For", "Show", "Switch", "Match", "Loading", "Reveal", "Portal", "Repeat", "Dynamic", "Errored"]`. */
   builtIns?: string[];
   requireImportSource?: false | string;