koffi 3.0.0-rc.2 → 3.0.0

package/cnoke.cjs

@@ -22,16 +22,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// src/cnoke/cnoke.js
+// ../cnoke/cnoke.js
 var import_node_fs4 = __toESM(require("node:fs"), 1);
 
-// src/cnoke/src/builder.js
+// ../cnoke/src/builder.js
 var import_node_fs3 = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 var import_node_child_process = require("node:child_process");
 
-// src/cnoke/src/abi.js
+// ../cnoke/src/abi.js
 var import_node_fs = __toESM(require("node:fs"), 1);
 function determineAbi() {
   let abi = process.arch;
@@ -121,7 +121,7 @@ function decodeElfHeader(buf) {
   return header;
 }
 
-// src/cnoke/src/util.js
+// ../cnoke/src/util.js
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 function pathIsAbsolute(path2) {
   if (process.platform == "win32" && path2.match(/^[a-zA-Z]:/))
@@ -194,7 +194,7 @@ function compareVersions(ver1, ver2) {
   return cmp;
 }
 
-// src/cnoke/src/assets.js
+// ../cnoke/src/assets.js
 var FIND_CNOKE_CMAKE = `# SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2026 Niels Martign\xE8ne <niels.martignene@protonmail.com>
 
@@ -361,7 +361,7 @@ const PfnDliHook __pfnDliNotifyHook2 = self_exe_hook;
 #endif
 `;
 
-// src/cnoke/src/builder.js
+// ../cnoke/src/builder.js
 var DefaultOptions = {
   mode: "RelWithDebInfo"
 };
@@ -650,7 +650,7 @@ function Builder(config = {}) {
   }
 }
 
-// src/cnoke/cnoke.js
+// ../cnoke/cnoke.js
 var VALID_COMMANDS = ["build", "configure", "clean"];
 main();
 async function main() {

package/doc/benchmarks.md

@@ -8,6 +8,7 @@ Here is a quick overview of the execution time of Koffi calls on three benchmark
 
 <div class="benchmark chart" data-platform="linux_x64"></div>
 <div class="benchmark chart" data-platform="win32_x64"></div>
+<div class="benchmark chart" data-platform="darwin_arm64"></div>
 
 These results are detailed and explained below, and compared to node-ffi/node-ffi-napi.
 
@@ -57,6 +58,30 @@ This test is based around repeated calls to the standard C function `memset`. Al
 
 <div class="benchmark table" data-platform="win32_x64" data-benchmark="memset"></div>
 
+# macOS ARM64
+
+The results presented below were measured on an Apple Mac mini M2 hosted by Scaleway.
+
+## rand results
+
+This test is based around repeated calls to a simple standard C function `rand`, which takes no parameter and returns a 32-bit integer.
+
+<div class="benchmark table" data-platform="darwin_arm64" data-benchmark="rand"></div>
+
+Because rand is a pretty small function, the FFI overhead is clearly visible.
+
+## atoi results
+
+This test is similar to the rand one, but it is based on `atoi`, which takes a string parameter. Javascript (V8) to C string conversion is relatively slow and heavy.
+
+<div class="benchmark table" data-platform="darwin_arm64" data-benchmark="atoi"></div>
+
+## memset results
+
+This test is based around repeated calls to the standard C function `memset`. All implementations pass a Node.js Buffer for the pointer argument.
+
+<div class="benchmark table" data-platform="darwin_arm64" data-benchmark="memset"></div>
+
 # Running benchmarks
 
 Please note that all benchmark results on this page are made with Clang-built binaries.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "koffi",
-    "version": "3.0.0-rc.2",
+    "version": "3.0.0",
     "description": "Fast and simple C FFI (foreign function interface) for Node.js",
     "keywords": [
         "foreign",
@@ -33,20 +33,20 @@
     },
     "funding": "https://liberapay.com/Koromix",
     "optionalDependencies": {
-        "@koromix/koffi-linux-arm64": "3.0.0-rc.2",
-        "@koromix/koffi-linux-ia32": "3.0.0-rc.2",
-        "@koromix/koffi-linux-x64": "3.0.0-rc.2",
-        "@koromix/koffi-linux-riscv64": "3.0.0-rc.2",
-        "@koromix/koffi-freebsd-ia32": "3.0.0-rc.2",
-        "@koromix/koffi-freebsd-x64": "3.0.0-rc.2",
-        "@koromix/koffi-freebsd-arm64": "3.0.0-rc.2",
-        "@koromix/koffi-openbsd-ia32": "3.0.0-rc.2",
-        "@koromix/koffi-openbsd-x64": "3.0.0-rc.2",
-        "@koromix/koffi-win32-ia32": "3.0.0-rc.2",
-        "@koromix/koffi-win32-x64": "3.0.0-rc.2",
-        "@koromix/koffi-darwin-x64": "3.0.0-rc.2",
-        "@koromix/koffi-darwin-arm64": "3.0.0-rc.2",
-        "@koromix/koffi-linux-loong64": "3.0.0-rc.2"
+        "@koromix/koffi-linux-arm64": "3.0.0",
+        "@koromix/koffi-linux-ia32": "3.0.0",
+        "@koromix/koffi-linux-x64": "3.0.0",
+        "@koromix/koffi-linux-riscv64": "3.0.0",
+        "@koromix/koffi-freebsd-ia32": "3.0.0",
+        "@koromix/koffi-freebsd-x64": "3.0.0",
+        "@koromix/koffi-freebsd-arm64": "3.0.0",
+        "@koromix/koffi-openbsd-ia32": "3.0.0",
+        "@koromix/koffi-openbsd-x64": "3.0.0",
+        "@koromix/koffi-win32-ia32": "3.0.0",
+        "@koromix/koffi-win32-x64": "3.0.0",
+        "@koromix/koffi-darwin-x64": "3.0.0",
+        "@koromix/koffi-darwin-arm64": "3.0.0",
+        "@koromix/koffi-linux-loong64": "3.0.0"
     },
     "type": "module",
     "main": "./index.cjs",

package/src/koffi/index.cjs

@@ -32,7 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/cnoke/src/abi.js
+// ../cnoke/src/abi.js
 function determineAbi() {
   let abi = process.arch;
   if (abi == "riscv32" || abi == "riscv64") {
@@ -122,20 +122,20 @@ function decodeElfHeader(buf) {
 }
 var import_node_fs;
 var init_abi = __esm({
-  "src/cnoke/src/abi.js"() {
+  "../cnoke/src/abi.js"() {
     import_node_fs = __toESM(require("node:fs"), 1);
   }
 });
 
-// src/koffi/package.json
+// package.json
 var package_default;
 var init_package = __esm({
-  "src/koffi/package.json"() {
-    package_default = { name: "koffi", version: "3.0.0-rc.2", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
+  "package.json"() {
+    package_default = { name: "koffi", version: "3.0.0", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
   }
 });
 
-// src/koffi/src/init.js
+// src/init.js
 var init_exports = {};
 __export(init_exports, {
   detectPlatform: () => detectPlatform,
@@ -217,7 +217,7 @@ function wrapNative(native2) {
 }
 var import_node_util, import_node_fs2, import_node_module, requireNative;
 var init_init = __esm({
-  "src/koffi/src/init.js"() {
+  "src/init.js"() {
     import_node_util = __toESM(require("node:util"));
     import_node_fs2 = __toESM(require("node:fs"));
     import_node_module = require("node:module");
@@ -227,9 +227,9 @@ var init_init = __esm({
   }
 });
 
-// src/koffi/src/static.js
+// src/static.js
 var require_static = __commonJS({
-  "src/koffi/src/static.js"(exports2, module2) {
+  "src/static.js"(exports2, module2) {
     var { createRequire: createRequire2 } = require("node:module");
     var requireNative2 = createRequire2(__filename);
     var BINARY_ROOT2 = __dirname + "/../../build/koffi";
@@ -314,7 +314,7 @@ var require_static = __commonJS({
   }
 });
 
-// src/koffi/index.cjs
+// index.cjs
 var { detectPlatform: detectPlatform2, loadDynamic: loadDynamic2, wrapNative: wrapNative2 } = (init_init(), __toCommonJS(init_exports));
 var { BINARY_ROOT, loadStatic } = require_static();
 var [version, pkg, triplets] = detectPlatform2();

package/src/koffi/index.js

@@ -1,9 +1,9 @@
-// src/koffi/src/init.js
+// src/init.js
 import util from "node:util";
 import fs2 from "node:fs";
 import { createRequire } from "node:module";
 
-// src/cnoke/src/abi.js
+// ../cnoke/src/abi.js
 import fs from "node:fs";
 function determineAbi() {
   let abi = process.arch;
@@ -93,10 +93,10 @@ function decodeElfHeader(buf) {
   return header;
 }
 
-// src/koffi/package.json
-var package_default = { name: "koffi", version: "3.0.0-rc.2", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
+// package.json
+var package_default = { name: "koffi", version: "3.0.0", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
 
-// src/koffi/src/init.js
+// src/init.js
 var requireNative = createRequire(import.meta.url);
 function detectPlatform() {
   if (process.versions.napi == null || process.versions.napi < package_default.cnoke.napi) {
@@ -172,7 +172,7 @@ function wrapNative(native2) {
   };
 }
 
-// src/koffi/src/static.js
+// src/static.js
 import { createRequire as createRequire2 } from "node:module";
 var requireNative2 = createRequire2(import.meta.url);
 var BINARY_ROOT = import.meta.dirname + "/../../build/koffi";
@@ -251,7 +251,7 @@ function loadStatic(pkg2) {
   return native2;
 }
 
-// src/koffi/index.js
+// index.js
 var [version, pkg, triplets] = detectPlatform();
 var native = null;
 STATIC: native = loadStatic(pkg);

package/src/koffi/indirect.cjs

@@ -32,7 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/cnoke/src/abi.js
+// ../cnoke/src/abi.js
 function determineAbi() {
   let abi = process.arch;
   if (abi == "riscv32" || abi == "riscv64") {
@@ -122,20 +122,20 @@ function decodeElfHeader(buf) {
 }
 var import_node_fs;
 var init_abi = __esm({
-  "src/cnoke/src/abi.js"() {
+  "../cnoke/src/abi.js"() {
     import_node_fs = __toESM(require("node:fs"), 1);
   }
 });
 
-// src/koffi/package.json
+// package.json
 var package_default;
 var init_package = __esm({
-  "src/koffi/package.json"() {
-    package_default = { name: "koffi", version: "3.0.0-rc.2", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
+  "package.json"() {
+    package_default = { name: "koffi", version: "3.0.0", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
   }
 });
 
-// src/koffi/src/init.js
+// src/init.js
 var init_exports = {};
 __export(init_exports, {
   detectPlatform: () => detectPlatform,
@@ -217,7 +217,7 @@ function wrapNative(native2) {
 }
 var import_node_util, import_node_fs2, import_node_module, requireNative;
 var init_init = __esm({
-  "src/koffi/src/init.js"() {
+  "src/init.js"() {
     import_node_util = __toESM(require("node:util"));
     import_node_fs2 = __toESM(require("node:fs"));
     import_node_module = require("node:module");
@@ -227,9 +227,9 @@ var init_init = __esm({
   }
 });
 
-// src/koffi/src/static.js
+// src/static.js
 var require_static = __commonJS({
-  "src/koffi/src/static.js"(exports2, module2) {
+  "src/static.js"(exports2, module2) {
     var { createRequire: createRequire2 } = require("node:module");
     var requireNative2 = createRequire2(__filename);
     var BINARY_ROOT2 = __dirname + "/../../build/koffi";
@@ -314,7 +314,7 @@ var require_static = __commonJS({
   }
 });
 
-// src/koffi/index.cjs
+// index.cjs
 var { detectPlatform: detectPlatform2, loadDynamic: loadDynamic2, wrapNative: wrapNative2 } = (init_init(), __toCommonJS(init_exports));
 var { BINARY_ROOT, loadStatic } = require_static();
 var [version, pkg, triplets] = detectPlatform2();

package/src/koffi/indirect.js

@@ -1,9 +1,9 @@
-// src/koffi/src/init.js
+// src/init.js
 import util from "node:util";
 import fs2 from "node:fs";
 import { createRequire } from "node:module";
 
-// src/cnoke/src/abi.js
+// ../cnoke/src/abi.js
 import fs from "node:fs";
 function determineAbi() {
   let abi = process.arch;
@@ -93,10 +93,10 @@ function decodeElfHeader(buf) {
   return header;
 }
 
-// src/koffi/package.json
-var package_default = { name: "koffi", version: "3.0.0-rc.2", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
+// package.json
+var package_default = { name: "koffi", version: "3.0.0", cnoke: { api: "../../vendor/node-api-headers", output: "../../bin/Koffi/{{ toolchain }}", node: 16, napi: 8 } };
 
-// src/koffi/src/init.js
+// src/init.js
 var requireNative = createRequire(import.meta.url);
 function detectPlatform() {
   if (process.versions.napi == null || process.versions.napi < package_default.cnoke.napi) {
@@ -172,12 +172,12 @@ function wrapNative(native2) {
   };
 }
 
-// src/koffi/src/static.js
+// src/static.js
 import { createRequire as createRequire2 } from "node:module";
 var requireNative2 = createRequire2(import.meta.url);
 var BINARY_ROOT = import.meta.dirname + "/../../build/koffi";
 
-// src/koffi/index.js
+// index.js
 var [version, pkg, triplets] = detectPlatform();
 var native = null;
 if (native == null)