koffi 2.14.0 → 2.14.1

package/CHANGELOG.md

@@ -7,6 +7,13 @@
 
 ### Koffi 2.14
 
+#### Koffi 2.14.1
+
+*Released on 2025-09-13*
+
+- Recompile Linux (musl) ARM64 prebuild with Alpine 3.20 (instead of Alpine edge)
+- Clean up redundant code paths for handling string arguments
+
 #### Koffi 2.14.0
 
 *Released on 2025-08-17*
@@ -980,7 +987,6 @@ This entry documents changes since version 1.1.0.
 
 The following features and improvements are planned, not necessarily in that order:
 
-- Port Koffi to Loong64 ISA and ABI
 - Port Koffi to PowerPC (POWER9+) ISA and ABI
 - Optimize passing of structs and arrays (with auto-generated JS)
 - Automate Windows/AArch64 (qemu) and macOS/AArch64 (how? ... thanks Apple) tests

package/README.md

@@ -4,7 +4,7 @@ Koffi is a fast and easy-to-use C FFI module for Node.js, featuring:
 
 * Low-overhead and fast performance (see [benchmarks](https://koffi.dev/benchmarks))
 * Support for primitive and aggregate data types (structs and fixed-size arrays), both by reference (pointer) and by value
-* Javascript functions can be used as C callbacks (since 1.2.0)
+* Javascript functions can be used as C callbacks
 * Well-tested code base for popular OS/architecture combinations
 
 The following combinations of OS and architectures __are officially supported and tested__ at the moment:

package/doc/pages/index.md

@@ -1,16 +1,51 @@
-# Koffi
+# Overview
 
 Koffi is a **fast and easy-to-use C FFI module for Node.js**, featuring:
 
 * Low-overhead and fast performance (see [benchmarks](benchmarks))
 * Support for primitive and aggregate data types (structs and fixed-size arrays), both by reference (pointer) and by value
-* Javascript functions can be used as C callbacks (since 1.2.0)
-* Well-tested code base for [popular OS/architecture combinations](platforms)
+* Javascript functions can be used as C callbacks
+* Well-tested code base for popular OS/architecture combinations
 
-Koffi requires a recent [Node.js](https://nodejs.org/) version with N-API version 8 support, see [this page](platforms) for more information.
+I work on this project on my spare time, if you like this project, consider supporting me:
+
+<p style="display: flex; gap: 2em; justify-content: center;">
+     <a href="https://buymeacoffee.com/koromix" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174" style="border-radius: 12px;"></a>
+</p>
+
+Koffi requires [Node.js](https://nodejs.org/) version 16 or later. Use [NVM](https://github.com/nvm-sh/nvm) to install more recent Node versions on older Linux distributions.
+
+The following combinations of OS and architectures __are officially supported and tested__ at the moment:
+
+ISA / OS           | Windows | Linux (glibc) | Linux (musl) | macOS | FreeBSD | OpenBSD
+------------------ | ------- | ------------- | ------------ | ----- | ------- | -------
+x86 (IA32) [^2]    | ✅       | ✅             | 🟨            | ⬜️    | ✅       | ✅
+x86_64 (AMD64)     | ✅       | ✅             | ✅            | ✅    | ✅       | ✅
+ARM32 LE [^3]      | ⬜️       | ✅             | 🟨            | ⬜️    | 🟨       | 🟨
+ARM64 (AArch64) LE | ✅       | ✅             | ✅            | ✅    | ✅       | 🟨
+RISC-V 64 [^4]     | ⬜️       | ✅             | 🟨            | ⬜️    | 🟨       | 🟨
+LoongArch64        | ⬜️       | ✅             | 🟨            | ⬜️    | 🟨       | 🟨
+
+<div class="legend">✅ Yes | 🟨 Probably | ⬜️ Not applicable</div>
+
+[^2]: The following call conventions are supported for forward calls: cdecl, stdcall, MS fastcall, thiscall. Only cdecl and stdcall can be used for C to JS callbacks.
+[^3]: The prebuilt binary uses the hard float ABI and expects a VFP coprocessor. Build from source to use Koffi with a different ABI (softfp, soft).
+[^4]: The prebuilt binary uses the LP64D (double-precision float) ABI. The LP64 ABI is supported in theory if you build Koffi from source (untested), the LP64F ABI is not supported.
+
+For all fully supported platforms (green check marks), a prebuilt binary is included in the NPM package which means you can install Koffi without a C++ compiler.
+
+# Source code
 
 The source code is available here: https://github.com/Koromix/rygel/ (in the *src/koffi* subdirectory).
 
+> [!NOTE]
+> Most of my projects live in a single repository (or monorepo), which have two killer features for me:
+>
+> - Cross-project refactoring
+> - Simplified dependency management
+>
+> You can find a more detailed rationale here: https://danluu.com/monorepo/
+
 New releases are frequent, look at the [changelog](changelog) for more information.
 
 # License
@@ -18,3 +53,7 @@ New releases are frequent, look at the [changelog](changelog) for more informati
 This program is free software: you can redistribute it and/or modify it under the terms of the **MIT License**.
 
 Find more information here: https://choosealicense.com/licenses/mit/
+
+<style>
+     table td:not(:first-child) { text-align: center; }
+</style>

package/doc/pages/platforms.md

@@ -14,25 +14,14 @@ Use [NVM](https://github.com/nvm-sh/nvm) to install more recent Node versions on
 
 The following combinations of OS and architectures __are officially supported and tested__ at the moment:
 
-ISA / OS           | Windows | Linux (glibc) | Linux (musl)
------------------- | ------- | ------------- | ------------
-x86 (IA32) [^1]    | ✅      | ✅            | 🟨
-x86_64 (AMD64)     | ✅      | ✅            | ✅
-ARM32 LE [^2]      | ⬜️      | ✅            | 🟨
-ARM64 (AArch64) LE | ✅      | ✅            | ✅
-RISC-V 64 [^3]     | ⬜️      | ✅            | 🟨
-LoongArch64        | ⬜️      | ✅            | 🟨
-
-<div class="legend">✅ Yes | 🟨 Probably | ⬜️ Not applicable</div>
-
-ISA / OS           | macOS | FreeBSD     | OpenBSD
------------------- | ----- | ----------- | --------
-x86 (IA32) [^1]    | ⬜️    | ✅          | ✅
-x86_64 (AMD64)     | ✅    | ✅          | ✅
-ARM32 LE [^2]      | ⬜️    | 🟨          | 🟨
-ARM64 (AArch64) LE | ✅    | ✅          | 🟨
-RISC-V 64 [^3]     | ⬜️    | 🟨          | 🟨
-LoongArch64        | ⬜️    | 🟨          | 🟨
+ISA / OS           | Windows     | Linux (glibc) | Linux (musl) | macOS       | FreeBSD     | OpenBSD
+------------------ | ----------- | ------------- | ------------ | ----------- | ----------- | --------
+x86 (IA32) [^1]    | ✅ Yes      | ✅ Yes        | 🟨 Probably  | ⬜️ *N/A*    | ✅ Yes      | ✅ Yes
+x86_64 (AMD64)     | ✅ Yes      | ✅ Yes        | ✅ Yes       | ✅ Yes      | ✅ Yes      | ✅ Yes
+ARM32 LE [^2]      | ⬜️ *N/A*    | ✅ Yes        | 🟨 Probably  | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
+ARM64 (AArch64) LE | ✅ Yes      | ✅ Yes        | ✅ Yes       | ✅ Yes      | ✅ Yes      | 🟨 Probably
+RISC-V 64 [^3]     | ⬜️ *N/A*    | ✅ Yes        | 🟨 Probably  | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
+LoongArch64        | ⬜️ *N/A*    | ✅ Yes        | 🟨 Probably  | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
 
 <div class="legend">✅ Yes | 🟨 Probably | ⬜️ Not applicable</div>
 

package/doc/pages.ini

@@ -2,13 +2,6 @@
 Title = Koffi
 Menu = Overview
 Description = Koffi presentation and features
-ToC = Off
-Template = templates/page.html
-
-[pages/platforms.md]
-Title = Requirements | Koffi
-Menu = Documentation / Requirements
-Description = Supported systemd and architectures
 Template = templates/page.html
 
 [pages/start.md]

package/index.js

@@ -402,7 +402,7 @@ var require_package = __commonJS({
   "../../../bin/Koffi/package/src/koffi/package.json"(exports2, module2) {
     module2.exports = {
       name: "koffi",
-      version: "2.14.0",
+      version: "2.14.1",
       description: "Fast and simple C FFI (foreign function interface) for Node.js",
       keywords: [
         "foreign",
@@ -438,7 +438,8 @@ var require_package = __commonJS({
         node: 16,
         napi: 8,
         require: "./index.js"
-      }
+      },
+      funding: "https://buymeacoffee.com/koromix"
     };
   }
 });

package/indirect.js

@@ -402,7 +402,7 @@ var require_package = __commonJS({
   "../../../bin/Koffi/package/src/koffi/package.json"(exports2, module2) {
     module2.exports = {
       name: "koffi",
-      version: "2.14.0",
+      version: "2.14.1",
       description: "Fast and simple C FFI (foreign function interface) for Node.js",
       keywords: [
         "foreign",
@@ -438,7 +438,8 @@ var require_package = __commonJS({
         node: 16,
         napi: 8,
         require: "./index.js"
-      }
+      },
+      funding: "https://buymeacoffee.com/koromix"
     };
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "koffi",
-    "version": "2.14.0",
+    "version": "2.14.1",
     "description": "Fast and simple C FFI (foreign function interface) for Node.js",
     "keywords": [
         "foreign",
@@ -33,5 +33,6 @@
         "node": 16,
         "napi": 8,
         "require": "./index.js"
-    }
+    },
+    "funding": "https://buymeacoffee.com/koromix"
 }

package/src/cnoke/src/builder.js

@@ -309,8 +309,7 @@ function Builder(config = {}) {
         tools.unlink_recursive(build_dir);
     };
 
-    function find_parent_directory(dirname, basename)
-    {
+    function find_parent_directory(dirname, basename) {
         if (process.platform == 'win32')
             dirname = dirname.replace(/\\/g, '/');