vite-plus 0.2.6 → 0.2.8

package/AGENTS.md

@@ -6,6 +6,10 @@ This project is using Vite+, a unified toolchain built on top of Vite, Rolldown,
 
 Docs are local at `node_modules/vite-plus/docs` or online at https://viteplus.dev/guide/.
 
+## Built-in Commands vs Scripts
+
+`vp <name>` runs a built-in command. `vp run <name>` runs a `package.json` script or a `vite.config.ts` task. Scripts cannot overwrite built-ins, so `vp dev` and `vp run dev` may do different things. Check `package.json` and `vite.config.ts` first, and run `vp run <name>` when the project defines a script or task with that name.
+
 ## Review Checklist
 
 - [ ] Run `vp install` after pulling remote changes and before getting started.

package/LICENSE

@@ -494,11 +494,15 @@ Repository: https://github.com/listr2/listr2
 
 ---------------------------------------
 
-## lru-cache
+## lru-cache, path-scurry
 License: BlueOak-1.0.0
 By: Isaac Z. Schlueter <i@izs.me>
 Repository: https://github.com/isaacs/node-lru-cache
 
+License: BlueOak-1.0.0
+By: Isaac Z. Schlueter <i@izs.me> (https://blog.izs.me)
+Repository: https://github.com/isaacs/path-scurry
+
 > # Blue Oak Model License
 > 
 > Version 1.0.0

package/README.md

@@ -15,7 +15,7 @@ Vite+ is the unified entry point for local web development. It combines [Vite](h
 - **`vp check`:** Run formatting, linting, and type checks in one command
 - **`vp test`:** Run tests through bundled Vitest
 - **`vp build`:** Build applications for production with Vite + Rolldown
-- **`vp run`:** Execute monorepo tasks with caching and dependency-aware scheduling
+- **`vp run`:** Run `package.json` scripts and monorepo tasks with caching and dependency-aware scheduling
 - **`vp pack`:** Build libraries for npm publishing or standalone app binaries
 - **`vp create` / `vp migrate`:** Scaffold new projects and migrate existing ones
 

package/bin/vpr

@@ -4,6 +4,7 @@ import module from 'node:module';
 if (module.enableCompileCache) {
   module.enableCompileCache();
 }
-
-process.argv.splice(2, 0, 'run');
+// Dynamic import so it runs AFTER enableCompileCache above (a static
+// import is hoisted and would load the CLI bundle uncached). The argv
+// rewrite to `run` lives in bin.ts (keyed on argv0).
 await import('../dist/bin.js');

package/binding/index.cjs

@@ -81,12 +81,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-android-arm64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -104,12 +104,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-android-arm-eabi/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -139,12 +139,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-win32-x64-gnu/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -162,12 +162,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-win32-x64-msvc/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -186,12 +186,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-win32-ia32-msvc/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -209,12 +209,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-win32-arm64-msvc/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -235,12 +235,12 @@ function requireNative() {
       const bindingPackageVersion =
         require('@voidzero-dev/vite-plus-darwin-universal/package.json').version;
       if (
-        bindingPackageVersion !== '0.2.6' &&
+        bindingPackageVersion !== '0.2.8' &&
         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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
         );
       }
       return binding;
@@ -258,12 +258,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-darwin-x64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -281,12 +281,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-darwin-arm64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -308,12 +308,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-freebsd-x64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -331,12 +331,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-freebsd-arm64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -359,12 +359,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-x64-musl/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -382,12 +382,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-x64-gnu/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -407,12 +407,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-arm64-musl/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -430,12 +430,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-arm64-gnu/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -455,12 +455,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-arm-musleabihf/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -478,12 +478,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-arm-gnueabihf/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -503,12 +503,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-loong64-musl/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -526,12 +526,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-loong64-gnu/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -551,12 +551,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-riscv64-musl/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -574,12 +574,12 @@ function requireNative() {
           const bindingPackageVersion =
             require('@voidzero-dev/vite-plus-linux-riscv64-gnu/package.json').version;
           if (
-            bindingPackageVersion !== '0.2.6' &&
+            bindingPackageVersion !== '0.2.8' &&
             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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             );
           }
           return binding;
@@ -598,12 +598,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-linux-ppc64-gnu/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -621,12 +621,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-linux-s390x-gnu/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -648,12 +648,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-openharmony-arm64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -671,12 +671,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-openharmony-x64/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -694,12 +694,12 @@ function requireNative() {
         const bindingPackageVersion =
           require('@voidzero-dev/vite-plus-openharmony-arm/package.json').version;
         if (
-          bindingPackageVersion !== '0.2.6' &&
+          bindingPackageVersion !== '0.2.8' &&
           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.2.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           );
         }
         return binding;
@@ -716,47 +716,163 @@ function requireNative() {
   }
 }
 
-nativeBinding = requireNative();
+function createLoadErrorChain(errors) {
+  return errors.reduce((previous, current) => {
+    let message;
+    try {
+      message = current && typeof current.message === 'string' ? current.message : String(current);
+    } catch {
+      message = 'Unknown error';
+    }
+    const error = new Error(message);
+    error.cause = previous;
+    return error;
+  }, null);
+}
 
 // NAPI_RS_FORCE_WASI is a tri-state flag:
 //   unset / any other value → native binding preferred, WASI is only a fallback
-//   'true'                   → force WASI fallback even if native loaded
-//   'error'                  → force WASI and throw if no WASI binding is found
+//   'true'                   → prefer WASI, but retain native as a lazy fallback
+//   'error'                  → require WASI without initializing a native fallback
 // Treating any non-empty string as truthy (the historical behavior) meant
 // NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
 // the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+//
+// NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
+// WASI loading. It never crosses into another flavor or falls back to native.
+const __napiWasiFlavors = ['wasm32-wasi'];
+const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR;
+const __napiWasiFlavorRequested =
+  typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0;
+if (__napiWasiFlavorRequested && __napiWasiFlavors.indexOf(__napiWasiFlavor) === -1) {
+  throw new Error(
+    'Unsupported WASI flavor "' +
+      __napiWasiFlavor +
+      '". Available flavors: ' +
+      __napiWasiFlavors.join(', '),
+  );
+}
+const forceWasiError = process.env.NAPI_RS_FORCE_WASI === 'error';
 const forceWasi =
-  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error';
+  process.env.NAPI_RS_FORCE_WASI === 'true' || forceWasiError || __napiWasiFlavorRequested;
+
+if (!forceWasi) {
+  nativeBinding = requireNative();
+}
 
 if (!nativeBinding || forceWasi) {
   let wasiBinding = null;
-  let wasiBindingError = null;
-  try {
-    wasiBinding = require('./vite-plus.wasi.cjs');
-    nativeBinding = wasiBinding;
-  } catch (err) {
-    if (forceWasi) {
-      wasiBindingError = err;
+  let wasiBindingLoaded = false;
+  const wasiBindingErrors = [];
+  const __napiWasiResolveCandidate = (specifier, isPackage, localArtifacts) => {
+    try {
+      require.resolve(specifier);
+    } catch (resolveError) {
+      if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+        throw resolveError;
+      }
+      if (isPackage) {
+        try {
+          require.resolve(specifier + '/package.json');
+        } catch (packageError) {
+          if (packageError && packageError.code === 'MODULE_NOT_FOUND') {
+            return resolveError;
+          }
+          // An exports restriction proves the package exists even when its
+          // package.json is not public. Preserve the root resolution failure.
+          throw resolveError;
+        }
+        // The package exists but its main/export target is broken.
+        throw resolveError;
+      }
+      return resolveError;
     }
-  }
-  if (!nativeBinding || forceWasi) {
+    if (localArtifacts) {
+      let artifactError = null;
+      for (let i = 0; i < localArtifacts.length; i++) {
+        try {
+          require.resolve(localArtifacts[i]);
+          return null;
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+            throw resolveError;
+          }
+          artifactError = resolveError;
+        }
+      }
+      return artifactError;
+    }
+    return null;
+  };
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
+    let candidateError = null;
+    let candidateFailed = false;
     try {
-      wasiBinding = require('@voidzero-dev/vite-plus-wasm32-wasi');
-      nativeBinding = wasiBinding;
+      candidateError = __napiWasiResolveCandidate('./vite-plus.wasi.cjs', false, [
+        './vite-plus.wasm32-wasi.debug.wasm',
+        './vite-plus.wasm32-wasi.wasm',
+      ]);
+      candidateFailed = candidateError !== null;
+      if (!candidateFailed) {
+        wasiBinding = require('./vite-plus.wasi.cjs');
+        nativeBinding = wasiBinding;
+        wasiBindingLoaded = true;
+      }
     } catch (err) {
-      if (forceWasi) {
-        if (!wasiBindingError) {
-          wasiBindingError = err;
-        } else {
-          wasiBindingError.cause = err;
+      candidateError = err;
+      candidateFailed = true;
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError);
+      loadErrors.push(candidateError);
+    }
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
+    let candidateError = null;
+    let candidateFailed = false;
+    try {
+      candidateError = __napiWasiResolveCandidate(
+        '@voidzero-dev/vite-plus-wasm32-wasi',
+        true,
+        undefined,
+      );
+      candidateFailed = candidateError !== null;
+      if (!candidateFailed) {
+        if (
+          process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
+          process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
+        ) {
+          const bindingPackageVersion =
+            require('@voidzero-dev/vite-plus-wasm32-wasi/package.json').version;
+          if (bindingPackageVersion !== '0.2.8') {
+            throw new Error(
+              `WASI binding package version mismatch, expected 0.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
+          }
         }
-        loadErrors.push(err);
+        wasiBinding = require('@voidzero-dev/vite-plus-wasm32-wasi');
+        nativeBinding = wasiBinding;
+        wasiBindingLoaded = true;
       }
+    } catch (err) {
+      candidateError = err;
+      candidateFailed = true;
     }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError);
+      loadErrors.push(candidateError);
+    }
+  }
+  if (!wasiBindingLoaded && forceWasi && !forceWasiError && !__napiWasiFlavorRequested) {
+    nativeBinding = requireNative();
   }
-  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
-    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error');
-    error.cause = wasiBindingError;
+  if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
+    const error = new Error(
+      __napiWasiFlavorRequested
+        ? 'WASI binding for flavor "' + __napiWasiFlavor + '" not found'
+        : 'WASI binding not found and NAPI_RS_FORCE_WASI is set to error',
+    );
+    error.cause = createLoadErrorChain(wasiBindingErrors);
     throw error;
   }
 }
@@ -770,10 +886,7 @@ if (!nativeBinding) {
     );
     // assign instead of the `new Error(message, { cause })` options form,
     // which Node < 16.9 silently ignores
-    error.cause = loadErrors.reduce((err, cur) => {
-      cur.cause = err;
-      return cur;
-    });
+    error.cause = createLoadErrorChain(loadErrors);
     throw error;
   }
   throw new Error(`Failed to load native binding`);