@vizejs/fresco-native 0.717.0 → 0.718.0

package/index.js

@@ -1,368 +1,1075 @@
-/* tslint:disable */
 /* eslint-disable */
-/* prettier-ignore */
-
+// @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { existsSync } = require('fs')
-const { spawnSync } = require("child_process");
-const { join } = require("path");
+const { readFileSync } = require("fs");
+let nativeBinding = null;
+// Which artifact actually loaded. The WASI fallback chain overwrites it with
+// the flavor it resolved; the late native retry below leaves it alone because
+// it only runs while no WASI candidate has been loaded. The take-over check
+// after the load-failure block can also set it.
+let __napiLoadedBindingTarget = "native";
+// What this loader's own `requireNative()` calls returned. The check after
+// the load-failure block compares it with `nativeBinding` to tell a binding
+// this loader loaded from one that code outside it put in its place.
+let __napiRequiredNativeBinding = null;
+const loadErrors = [];
 
-const { platform, arch } = process;
+const isMusl = () => {
+  let musl = false;
+  if (process.platform === "linux") {
+    musl = isMuslFromFilesystem();
+    if (musl === null) {
+      musl = isMuslFromReport();
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess();
+    }
+  }
+  return musl;
+};
 
-let nativeBinding = null;
-let localFileExisted = false;
-let loadError = null;
+const isFileMusl = (f) => f.includes("libc.musl-") || f.includes("ld-musl-");
 
-function isMusl() {
-  // For Node 10
-  if (!process.report || typeof process.report.getReport !== "function") {
-    const result = spawnSync("ldd", ["--version"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-    if (result.error) {
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync("/usr/bin/ldd", "utf-8").includes("musl");
+  } catch {
+    return null;
+  }
+};
+
+const isMuslFromReport = () => {
+  let report = null;
+  if (process.report && typeof process.report.getReport === "function") {
+    process.report.excludeNetwork = true;
+    report = process.report.getReport();
+  }
+  if (!report) {
+    return null;
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false;
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
       return true;
     }
-    return `${result.stdout || ""}\n${result.stderr || ""}`.includes("musl");
-  } else {
-    const { glibcVersionRuntime } = process.report.getReport().header;
-    return !glibcVersionRuntime;
   }
-}
+  return false;
+};
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require("child_process")
+      .execSync("ldd --version", { encoding: "utf8" })
+      .includes("musl");
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false;
+  }
+};
 
-switch (platform) {
-  case "android":
-    switch (arch) {
-      case "arm64":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.android-arm64.node"));
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      const overrideBinding = require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+      // The override may be a generated WASI loader, which already reports its
+      // own flavor. Adopt it: `module.exports` aliases this object, so claiming
+      // 'native' would both misreport the artifact and overwrite the loader's
+      // marker through the alias.
+      __napiLoadedBindingTarget =
+        overrideBinding && typeof overrideBinding.__napiBindingTarget === "string"
+          ? overrideBinding.__napiBindingTarget
+          : "native";
+      return overrideBinding;
+    } catch (err) {
+      loadErrors.push(err);
+    }
+  } else if (process.platform === "android") {
+    if (process.arch === "arm64") {
+      try {
+        return require("./vize-fresco.android-arm64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-android-arm64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-android-arm64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "arm") {
+      try {
+        return require("./vize-fresco.android-arm-eabi.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-android-arm-eabi");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-android-arm-eabi/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`));
+    }
+  } else if (process.platform === "win32") {
+    if (process.arch === "x64") {
+      if (
+        (process.config &&
+          process.config.variables &&
+          process.config.variables.shlib_suffix === "dll.a") ||
+        (process.config &&
+          process.config.variables &&
+          process.config.variables.node_target_type === "shared_library")
+      ) {
+        try {
+          return require("./vize-fresco.win32-x64-gnu.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.android-arm64.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-android-arm64");
+          const binding = require("@vizejs/fresco-native-win32-x64-gnu");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-win32-x64-gnu/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      } else {
+        try {
+          return require("./vize-fresco.win32-x64-msvc.node");
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      case "arm":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.android-arm-eabi.node"));
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.android-arm-eabi.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-android-arm-eabi");
+          const binding = require("@vizejs/fresco-native-win32-x64-msvc");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-win32-x64-msvc/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
+        }
+      }
+    } else if (process.arch === "ia32") {
+      try {
+        return require("./vize-fresco.win32-ia32-msvc.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-win32-ia32-msvc");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-win32-ia32-msvc/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "arm64") {
+      try {
+        return require("./vize-fresco.win32-arm64-msvc.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-win32-arm64-msvc");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-win32-arm64-msvc/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`));
+    }
+  } else if (process.platform === "darwin") {
+    try {
+      return require("./vize-fresco.darwin-universal.node");
+    } catch (e) {
+      loadErrors.push(e);
+    }
+    try {
+      const binding = require("@vizejs/fresco-native-darwin-universal");
+      const bindingPackageVersion =
+        require("@vizejs/fresco-native-darwin-universal/package.json").version;
+      if (
+        bindingPackageVersion !== "0.474.0" &&
+        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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+        );
+      }
+      return binding;
+    } catch (e) {
+      loadErrors.push(e);
+    }
+    if (process.arch === "x64") {
+      try {
+        return require("./vize-fresco.darwin-x64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-darwin-x64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-darwin-x64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "arm64") {
+      try {
+        return require("./vize-fresco.darwin-arm64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-darwin-arm64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-darwin-arm64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
         }
-        break;
-      default:
-        throw new Error(`Unsupported architecture on Android ${arch}`);
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`));
     }
-    break;
-  case "win32":
-    switch (arch) {
-      case "x64":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.win32-x64-msvc.node"));
+  } else if (process.platform === "freebsd") {
+    if (process.arch === "x64") {
+      try {
+        return require("./vize-fresco.freebsd-x64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-freebsd-x64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-freebsd-x64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "arm64") {
+      try {
+        return require("./vize-fresco.freebsd-arm64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-freebsd-arm64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-freebsd-arm64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "ppc64") {
+      try {
+        return require("./vize-fresco.freebsd-ppc64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-freebsd-ppc64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-freebsd-ppc64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`));
+    }
+  } else if (process.platform === "linux") {
+    if (process.arch === "x64") {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.win32-x64-msvc.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-win32-x64-msvc");
-          }
+          return require("./vize-fresco.linux-x64-musl.node");
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      case "ia32":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.win32-ia32-msvc.node"));
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.win32-ia32-msvc.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-win32-ia32-msvc");
+          const binding = require("@vizejs/fresco-native-linux-x64-musl");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-x64-musl/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      case "arm64":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.win32-arm64-msvc.node"));
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.win32-arm64-msvc.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-win32-arm64-msvc");
+          return require("./vize-fresco.linux-x64-gnu.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-x64-gnu");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-x64-gnu/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`);
-    }
-    break;
-  case "darwin":
-    localFileExisted = existsSync(join(__dirname, "vize-fresco.darwin-universal.node"));
-    try {
-      if (localFileExisted) {
-        nativeBinding = require("./vize-fresco.darwin-universal.node");
-      } else {
-        nativeBinding = require("@vizejs/fresco-native-darwin-universal");
       }
-      break;
-    } catch {}
-    switch (arch) {
-      case "x64":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.darwin-x64.node"));
+    } else if (process.arch === "arm64") {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.darwin-x64.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-darwin-x64");
-          }
+          return require("./vize-fresco.linux-arm64-musl.node");
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      case "arm64":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.darwin-arm64.node"));
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.darwin-arm64.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-darwin-arm64");
+          const binding = require("@vizejs/fresco-native-linux-arm64-musl");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-arm64-musl/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
         } catch (e) {
-          loadError = e;
+          loadErrors.push(e);
         }
-        break;
-      default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`);
-    }
-    break;
-  case "freebsd":
-    if (arch !== "x64") {
-      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`);
-    }
-    localFileExisted = existsSync(join(__dirname, "vize-fresco.freebsd-x64.node"));
-    try {
-      if (localFileExisted) {
-        nativeBinding = require("./vize-fresco.freebsd-x64.node");
       } else {
-        nativeBinding = require("@vizejs/fresco-native-freebsd-x64");
-      }
-    } catch (e) {
-      loadError = e;
-    }
-    break;
-  case "linux":
-    switch (arch) {
-      case "x64":
-        if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-x64-musl.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-x64-musl.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-x64-musl");
-            }
-          } catch (e) {
-            loadError = e;
+        try {
+          return require("./vize-fresco.linux-arm64-gnu.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-arm64-gnu");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-arm64-gnu/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
-        } else {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-x64-gnu.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-x64-gnu.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-x64-gnu");
-            }
-          } catch (e) {
-            loadError = e;
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      }
+    } else if (process.arch === "arm") {
+      if (isMusl()) {
+        try {
+          return require("./vize-fresco.linux-arm-musleabihf.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-arm-musleabihf");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-arm-musleabihf/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
         }
-        break;
-      case "arm64":
-        if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-arm64-musl.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-arm64-musl.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-arm64-musl");
-            }
-          } catch (e) {
-            loadError = e;
+      } else {
+        try {
+          return require("./vize-fresco.linux-arm-gnueabihf.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-arm-gnueabihf");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-arm-gnueabihf/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
-        } else {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-arm64-gnu.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-arm64-gnu.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-arm64-gnu");
-            }
-          } catch (e) {
-            loadError = e;
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      }
+    } else if (process.arch === "loong64") {
+      if (isMusl()) {
+        try {
+          return require("./vize-fresco.linux-loong64-musl.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-loong64-musl");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-loong64-musl/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
         }
-        break;
-      case "arm":
-        if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-arm-musleabihf.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-arm-musleabihf.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-arm-musleabihf");
-            }
-          } catch (e) {
-            loadError = e;
+      } else {
+        try {
+          return require("./vize-fresco.linux-loong64-gnu.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-loong64-gnu");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-loong64-gnu/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
-        } else {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-arm-gnueabihf.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-arm-gnueabihf.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-arm-gnueabihf");
-            }
-          } catch (e) {
-            loadError = e;
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      }
+    } else if (process.arch === "riscv64") {
+      if (isMusl()) {
+        try {
+          return require("./vize-fresco.linux-riscv64-musl.node");
+        } catch (e) {
+          loadErrors.push(e);
+        }
+        try {
+          const binding = require("@vizejs/fresco-native-linux-riscv64-musl");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-riscv64-musl/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      } else {
+        try {
+          return require("./vize-fresco.linux-riscv64-gnu.node");
+        } catch (e) {
+          loadErrors.push(e);
         }
-        break;
-      case "riscv64":
-        if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-riscv64-musl.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-riscv64-musl.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-riscv64-musl");
-            }
-          } catch (e) {
-            loadError = e;
+        try {
+          const binding = require("@vizejs/fresco-native-linux-riscv64-gnu");
+          const bindingPackageVersion =
+            require("@vizejs/fresco-native-linux-riscv64-gnu/package.json").version;
+          if (
+            bindingPackageVersion !== "0.474.0" &&
+            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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
           }
-        } else {
-          localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-riscv64-gnu.node"));
-          try {
-            if (localFileExisted) {
-              nativeBinding = require("./vize-fresco.linux-riscv64-gnu.node");
-            } else {
-              nativeBinding = require("@vizejs/fresco-native-linux-riscv64-gnu");
-            }
-          } catch (e) {
-            loadError = e;
+          return binding;
+        } catch (e) {
+          loadErrors.push(e);
+        }
+      }
+    } else if (process.arch === "ppc64") {
+      try {
+        return require("./vize-fresco.linux-ppc64-gnu.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-linux-ppc64-gnu");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-linux-ppc64-gnu/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "s390x") {
+      try {
+        return require("./vize-fresco.linux-s390x-gnu.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-linux-s390x-gnu");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-linux-s390x-gnu/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`));
+    }
+  } else if (process.platform === "openharmony") {
+    if (process.arch === "arm64") {
+      try {
+        return require("./vize-fresco.openharmony-arm64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-openharmony-arm64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-openharmony-arm64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "x64") {
+      try {
+        return require("./vize-fresco.openharmony-x64.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-openharmony-x64");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-openharmony-x64/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else if (process.arch === "arm") {
+      try {
+        return require("./vize-fresco.openharmony-arm.node");
+      } catch (e) {
+        loadErrors.push(e);
+      }
+      try {
+        const binding = require("@vizejs/fresco-native-openharmony-arm");
+        const bindingPackageVersion =
+          require("@vizejs/fresco-native-openharmony-arm/package.json").version;
+        if (
+          bindingPackageVersion !== "0.474.0" &&
+          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.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          );
+        }
+        return binding;
+      } catch (e) {
+        loadErrors.push(e);
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`));
+    }
+  } else {
+    loadErrors.push(
+      new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`),
+    );
+  }
+}
+
+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'                   → 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" || forceWasiError || __napiWasiFlavorRequested;
+
+if (!forceWasi) {
+  nativeBinding = requireNative();
+  __napiRequiredNativeBinding = nativeBinding;
+}
+
+if (!nativeBinding || forceWasi) {
+  let wasiBinding = null;
+  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;
         }
-        break;
-      case "s390x":
-        localFileExisted = existsSync(join(__dirname, "vize-fresco.linux-s390x-gnu.node"));
+        // The package exists but its main/export target is broken.
+        throw resolveError;
+      }
+      return resolveError;
+    }
+    if (localArtifacts) {
+      let artifactError = null;
+      for (let i = 0; i < localArtifacts.length; i++) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require("./vize-fresco.linux-s390x-gnu.node");
-          } else {
-            nativeBinding = require("@vizejs/fresco-native-linux-s390x-gnu");
+          require.resolve(localArtifacts[i]);
+          return null;
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== "MODULE_NOT_FOUND") {
+            throw resolveError;
           }
-        } catch (e) {
-          loadError = e;
+          artifactError = resolveError;
         }
-        break;
-      default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`);
+      }
+      return artifactError;
     }
-    break;
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`);
+    return null;
+  };
+  {
+    // The local artifact is always the first WASI candidate. Keep this scope
+    // separate because the package fallback below reuses the candidate names.
+    let candidateError = null;
+    let candidateFailed = false;
+    try {
+      candidateError = __napiWasiResolveCandidate("./vize-fresco.wasi.cjs", false, [
+        "./vize-fresco.wasm32-wasi.debug.wasm",
+        "./vize-fresco.wasm32-wasi.wasm",
+      ]);
+      candidateFailed = candidateError !== null;
+      if (!candidateFailed) {
+        wasiBinding = require("./vize-fresco.wasi.cjs");
+        nativeBinding = wasiBinding;
+        __napiLoadedBindingTarget = "wasm32-wasi";
+        wasiBindingLoaded = true;
+      }
+    } catch (err) {
+      candidateError = err;
+      candidateFailed = true;
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError);
+      loadErrors.push(candidateError);
+    }
+  }
+  if (!wasiBindingLoaded) {
+    let candidateError = null;
+    let candidateFailed = false;
+    try {
+      candidateError = __napiWasiResolveCandidate(
+        "@vizejs/fresco-native-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("@vizejs/fresco-native-wasm32-wasi/package.json").version;
+          if (bindingPackageVersion !== "0.474.0") {
+            throw new Error(
+              `WASI binding package version mismatch, expected 0.474.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            );
+          }
+        }
+        wasiBinding = require("@vizejs/fresco-native-wasm32-wasi");
+        nativeBinding = wasiBinding;
+        __napiLoadedBindingTarget = "wasm32-wasi";
+        wasiBindingLoaded = true;
+      }
+    } catch (err) {
+      candidateError = err;
+      candidateFailed = true;
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError);
+      loadErrors.push(candidateError);
+    }
+  }
+  if (!wasiBindingLoaded && forceWasi && !forceWasiError && !__napiWasiFlavorRequested) {
+    nativeBinding = requireNative();
+    __napiRequiredNativeBinding = nativeBinding;
+  }
+  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;
+  }
 }
 
 if (!nativeBinding) {
-  if (loadError) {
-    throw loadError;
+  if (loadErrors.length > 0) {
+    const error = new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        "Please try `npm i` again after removing both package-lock.json and node_modules directory.",
+    );
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = createLoadErrorChain(loadErrors);
+    throw error;
   }
   throw new Error(`Failed to load native binding`);
 }
 
-const {
-  pollEvent,
-  pollEventNonBlocking,
-  readEvent,
-  getImeState,
-  enableIme,
-  disableIme,
-  setImeMode,
-  initLayout,
-  createLayoutNode,
-  createLayoutLeaf,
-  setLayoutRoot,
-  addLayoutChild,
-  removeLayoutChild,
-  setLayoutStyle,
-  removeLayoutNode,
-  computeLayout,
-  getLayout,
-  getAllLayouts,
-  clearLayout,
-  renderText,
-  renderBox,
-  fillRect,
-  clearRect,
-  setCursor,
-  showCursor,
-  hideCursor,
-  setCursorShape,
-  renderTree,
-  getLastRenderLayouts,
-  initTerminal,
-  initTerminalWithMouse,
-  initTerminalWithOptions,
-  restoreTerminal,
-  getTerminalInfo,
-  clearScreen,
-  flushTerminal,
-  flushTerminalMeasured,
-  syncTerminalSize,
-} = nativeBinding;
+// A package can patch its own fallback in front of the load-failure check
+// above, e.g. a WebContainer download through `napi-postinstall/fallback`.
+// That fallback swaps `nativeBinding` for a generated WASI loader, which has
+// already stamped its own flavor, while the target above still says 'native'.
+// Take that flavor over, or the CommonJS stamp throws a conflict and the ESM
+// export reports the wrong artifact. Three limits keep the conflict check:
+// - only a binding this loader did not load itself, so a native addon whose
+//   `#[napi(module_exports)]` hook claims the name is still rejected;
+// - only an own data property, read through its descriptor, so no addon
+//   getter runs here, and it must read back the same, as the stamp reads it;
+// - only a flavor in `__napiWasiFlavors`, the ones this loader's own WASI
+//   chain can report ('wasm32-wasi' for a package without a WASI target).
+// This is metadata and never fails a load: a throwing Proxy trap keeps 'native'.
+if (__napiLoadedBindingTarget === "native" && nativeBinding !== __napiRequiredNativeBinding) {
+  try {
+    const __napiBindingTargetDescriptor = Object.getOwnPropertyDescriptor(
+      nativeBinding,
+      "__napiBindingTarget",
+    );
+    if (
+      __napiBindingTargetDescriptor &&
+      __napiWasiFlavors.indexOf(__napiBindingTargetDescriptor.value) !== -1 &&
+      nativeBinding.__napiBindingTarget === __napiBindingTargetDescriptor.value
+    ) {
+      __napiLoadedBindingTarget = __napiBindingTargetDescriptor.value;
+    }
+  } catch {
+    // keep 'native'
+  }
+}
 
-module.exports.pollEvent = pollEvent;
-module.exports.pollEventNonBlocking = pollEventNonBlocking;
-module.exports.readEvent = readEvent;
-module.exports.getImeState = getImeState;
-module.exports.enableIme = enableIme;
-module.exports.disableIme = disableIme;
-module.exports.setImeMode = setImeMode;
-module.exports.initLayout = initLayout;
-module.exports.createLayoutNode = createLayoutNode;
-module.exports.createLayoutLeaf = createLayoutLeaf;
-module.exports.setLayoutRoot = setLayoutRoot;
-module.exports.addLayoutChild = addLayoutChild;
-module.exports.removeLayoutChild = removeLayoutChild;
-module.exports.setLayoutStyle = setLayoutStyle;
-module.exports.removeLayoutNode = removeLayoutNode;
-module.exports.computeLayout = computeLayout;
-module.exports.getLayout = getLayout;
-module.exports.getAllLayouts = getAllLayouts;
-module.exports.clearLayout = clearLayout;
-module.exports.renderText = renderText;
-module.exports.renderBox = renderBox;
-module.exports.fillRect = fillRect;
-module.exports.clearRect = clearRect;
-module.exports.setCursor = setCursor;
-module.exports.showCursor = showCursor;
-module.exports.hideCursor = hideCursor;
-module.exports.setCursorShape = setCursorShape;
-module.exports.renderTree = renderTree;
-module.exports.getLastRenderLayouts = getLastRenderLayouts;
-module.exports.initTerminal = initTerminal;
-module.exports.initTerminalWithMouse = initTerminalWithMouse;
-module.exports.initTerminalWithOptions = initTerminalWithOptions;
-module.exports.restoreTerminal = restoreTerminal;
-module.exports.getTerminalInfo = getTerminalInfo;
-module.exports.clearScreen = clearScreen;
-module.exports.flushTerminal = flushTerminal;
-module.exports.flushTerminalMeasured = flushTerminalMeasured;
-module.exports.syncTerminalSize = syncTerminalSize;
+function __napiStampBindingTarget(exportsObject, target) {
+  if (Object.prototype.hasOwnProperty.call(exportsObject, "__napiBindingTarget")) {
+    if (exportsObject.__napiBindingTarget === target) {
+      // Already ours: the root entry aliases the object it loaded, so a WASI
+      // fallback candidate — or a `NAPI_RS_NATIVE_LIBRARY_PATH` override that
+      // is a generated loader — arrives already stamped with this same value.
+      return target;
+    }
+    const error = new Error(
+      '`__napiBindingTarget` is reserved by the generated binding loader, but the loaded binding already exports it. Rename the export, e.g. #[napi(js_name = "...")].',
+    );
+    error.code = "ERR_NAPI_BINDING_TARGET_CONFLICT";
+    throw error;
+  }
+  if (!Object.isExtensible(exportsObject)) {
+    // A `#[napi(module_exports)]` hook may seal or freeze this object
+    // (`Object::seal` / `Object::freeze`). Reporting the artifact is metadata,
+    // never a reason to fail an otherwise successful load, so the stamp is
+    // skipped. What a consumer still sees then follows the entry point: the
+    // browser and deferred loaders declare `__napiBindingTarget` at module
+    // level and go on reporting it, while the CommonJS entries hand back this
+    // very object as `module.exports`, so there the value is absent.
+    return target;
+  }
+  try {
+    // [[Define]], not [[Set]]: an ordinary assignment walks the prototype
+    // chain, so an inherited accessor could swallow the value or throw and
+    // fail an otherwise successful load. The descriptor is what a successful
+    // assignment would have produced.
+    Object.defineProperty(exportsObject, "__napiBindingTarget", {
+      configurable: true,
+      enumerable: true,
+      value: target,
+      writable: true,
+    });
+  } catch {
+    // Same rule as the non-extensible skip above: reporting the artifact is
+    // metadata, never a reason to fail an otherwise successful load. An exotic
+    // object (a Proxy whose defineProperty trap refuses) is skipped, not
+    // thrown over.
+  }
+  // The CommonJS loaders assign this return value so `cjs-module-lexer` — and
+  // therefore Node's CJS -> ESM named export detection — can see
+  // `__napiBindingTarget` statically.
+  return target;
+}
+// Stamp before the alias, not after. The guard only reads `nativeBinding`
+// (`hasOwnProperty` plus a comparison), which is safe against any addon
+// accessor; an assignment is not, because a `#[napi(module_exports)]` hook can
+// expose a getter reporting this very value and a setter that throws. So the
+// assignment lands on the loader's own `module.exports`, still the original
+// object here, and the alias below replaces it.
+//
+// The assignment is what keeps the marker a statically visible CommonJS export:
+// `cjs-module-lexer` is Node's CJS -> ESM named export detection, it cannot see
+// a bare call, and the later `module.exports = nativeBinding` does not undo the
+// detection. The assignment itself always succeeds — its target is this
+// loader's own, still extensible `module.exports` — and the alias below then
+// discards the value it wrote. What a consumer reads is whatever the guard put
+// on `nativeBinding`, so on a frozen binding, where the guard skips, the
+// linked import resolves to `undefined`.
+module.exports.__napiBindingTarget = __napiStampBindingTarget(
+  nativeBinding,
+  __napiLoadedBindingTarget,
+);
+module.exports = nativeBinding;
+module.exports.addLayoutChild = nativeBinding.addLayoutChild;
+module.exports.clearLayout = nativeBinding.clearLayout;
+module.exports.clearRect = nativeBinding.clearRect;
+module.exports.clearScreen = nativeBinding.clearScreen;
+module.exports.computeLayout = nativeBinding.computeLayout;
+module.exports.createLayoutLeaf = nativeBinding.createLayoutLeaf;
+module.exports.createLayoutNode = nativeBinding.createLayoutNode;
+module.exports.disableIme = nativeBinding.disableIme;
+module.exports.enableIme = nativeBinding.enableIme;
+module.exports.fillRect = nativeBinding.fillRect;
+module.exports.flushTerminal = nativeBinding.flushTerminal;
+module.exports.flushTerminalMeasured = nativeBinding.flushTerminalMeasured;
+module.exports.getAllLayouts = nativeBinding.getAllLayouts;
+module.exports.getImeState = nativeBinding.getImeState;
+module.exports.getLastRenderLayouts = nativeBinding.getLastRenderLayouts;
+module.exports.getLayout = nativeBinding.getLayout;
+module.exports.getTerminalInfo = nativeBinding.getTerminalInfo;
+module.exports.hideCursor = nativeBinding.hideCursor;
+module.exports.initLayout = nativeBinding.initLayout;
+module.exports.initTerminal = nativeBinding.initTerminal;
+module.exports.initTerminalWithMouse = nativeBinding.initTerminalWithMouse;
+module.exports.initTerminalWithOptions = nativeBinding.initTerminalWithOptions;
+module.exports.pollEvent = nativeBinding.pollEvent;
+module.exports.pollEventNonBlocking = nativeBinding.pollEventNonBlocking;
+module.exports.readEvent = nativeBinding.readEvent;
+module.exports.removeLayoutChild = nativeBinding.removeLayoutChild;
+module.exports.removeLayoutNode = nativeBinding.removeLayoutNode;
+module.exports.renderBox = nativeBinding.renderBox;
+module.exports.renderText = nativeBinding.renderText;
+module.exports.renderTree = nativeBinding.renderTree;
+module.exports.restoreTerminal = nativeBinding.restoreTerminal;
+module.exports.setCursor = nativeBinding.setCursor;
+module.exports.setCursorShape = nativeBinding.setCursorShape;
+module.exports.setImeMode = nativeBinding.setImeMode;
+module.exports.setLayoutRoot = nativeBinding.setLayoutRoot;
+module.exports.setLayoutStyle = nativeBinding.setLayoutStyle;
+module.exports.showCursor = nativeBinding.showCursor;
+module.exports.syncTerminalSize = nativeBinding.syncTerminalSize;