koffi 2.12.1 → 2.12.3

package/CHANGELOG.md

@@ -7,6 +7,27 @@
 
 ### Koffi 2.12
 
+#### Koffi 2.12.3
+
+*Released on 2025-07-28*
+
+- Add missing TypeScript overloads for struct redefinition
+- Add missing TypeScript member parameter in `koffi.offsetof()`
+- Add missing TypeScript declaration for `koffi.view()`
+- Add primitive type names to TypeScript
+- Simplify TypeScript module declaration
+
+#### Koffi 2.12.2
+
+*Released on 2025-07-16*
+
+- Validate identifiers against Unicode XID table
+- Skip struct and union members with placeholder name '\_'
+- Add Koffi prebuild for Linux (musl) ARM64
+
+> [!NOTE]
+> The Koffi 3 codebase has been put aside, and some of it will be progressively integrated into Koffi 2 over the following months.
+
 #### Koffi 2.12.1
 
 *Released on 2025-07-05*

package/LICENSE.txt

@@ -1,9 +1,9 @@
 MIT License
 
-Copyright 2023 Niels Martignène <niels.martignene@protonmail.com>
+Copyright (C) 2025  Niels Martignène <niels.martignene@protonmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the “Software”), to deal in 
+this software and associated documentation files (the “Software”), to deal in
 the Software without restriction, including without limitation the rights to use,
 copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
 Software, and to permit persons to whom the Software is furnished to do so,

package/README.md

@@ -9,14 +9,14 @@ Koffi is a fast and easy-to-use C FFI module for Node.js, featuring:
 
 The following combinations of OS and architectures __are officially supported and tested__ at the moment:
 
-ISA / OS           | Windows     | Linux    | macOS       | FreeBSD     | OpenBSD
------------------- | ----------- | -------- | ----------- | ----------- | --------
-x86 (IA32) [^1]    | ✅ Yes      | ✅ Yes   | ⬜️ *N/A*    | ✅ Yes      | ✅ Yes
-x86_64 (AMD64)     | ✅ Yes      | ✅ Yes   | ✅ Yes      | ✅ Yes      | ✅ Yes
-ARM32 LE [^2]      | ⬜️ *N/A*    | ✅ Yes   | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
-ARM64 (AArch64) LE | ✅ Yes      | ✅ Yes   | ✅ Yes      | ✅ Yes      | 🟨 Probably
-RISC-V 64 [^3]     | ⬜️ *N/A*    | ✅ Yes   | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
-LoongArch64        | ⬜️ *N/A*    | ✅ Yes   | ⬜️ *N/A*    | 🟨 Probably | 🟨 Probably
+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
 
 [^1]: The following call conventions are supported: cdecl, stdcall, MS fastcall, thiscall.
 [^2]: 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).

package/doc/assets.ini

@@ -1,4 +1,4 @@
-EsbuildPath = ../../vendor/esbuild/bin
+EsbuildPath = ../../vendor/esbuild/native/node_modules/@esbuild
 
 [favicon.png]
 Type = Copy
@@ -11,7 +11,7 @@ Ignore = favicon.png *.js *.css
 
 [static/site.min.js]
 Type = Bundle
-Source = flat/static.js
+Source = ../../src/web/flat/static.js
 
 [static/highlight.min.js]
 Type = Bundle
@@ -20,4 +20,4 @@ Source = static/highlight.js
 [static/site.min.css]
 Type = Bundle
 Source = static/koffi.css
-Options = --loader:.woff=file --loader:.woff2=file --loader:.png=file --loader:.webp=file
+Options = --loader:.woff2=file --loader:.png=file --loader:.webp=file

package/doc/develop.sh

@@ -3,12 +3,13 @@
 cd "$(dirname $0)"
 
 ../../bootstrap.sh
-../../felix -pFast serf hodler
+../../felix -pFast nestor hodler
 
 trap 'kill $(jobs -p) 2>/dev/null' EXIT
 trap 'kill $(jobs -p) 2>/dev/null' SIGINT
 
-../../bin/Fast/serf dist/ &
-../../bin/Fast/hodler . -O dist --loop &
+mkdir -p dist
+../../bin/Fast/nestor dist/ &
+../../bin/Fast/hodler . -O dist --loop --sourcemap &
 
 wait $(jobs -p)

package/doc/pages/platforms.md

@@ -19,7 +19,7 @@ ISA / OS           | Windows | Linux (glibc) | Linux (musl)
 x86 (IA32) [^1]    | ✅      | ✅            | 🟨
 x86_64 (AMD64)     | ✅      | ✅            | ✅
 ARM32 LE [^2]      | ⬜️      | ✅            | 🟨
-ARM64 (AArch64) LE | ✅      | ✅            | 🟨
+ARM64 (AArch64) LE | ✅      | ✅            | ✅
 RISC-V 64 [^3]     | ⬜️      | ✅            | 🟨
 LoongArch64        | ⬜️      | ✅            | 🟨
 

package/doc/static/highlight.js

@@ -1,4 +1,4 @@
-// Copyright (C) 2024  Niels Martignène <niels.martignene@protonmail.com>
+// Copyright (C) 2025  Niels Martignène <niels.martignene@protonmail.com>
 //
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by

package/doc/static/koffi.css

@@ -1,4 +1,4 @@
-/* Copyright (C) 2024  Niels Martignène <niels.martignene@protonmail.com>
+/* Copyright (C) 2025  Niels Martignène <niels.martignene@protonmail.com>
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -13,10 +13,11 @@
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>. */
 
-@import url('../flat/flat.css');
+@import url('../../../src/web/flat/flat.css');
 @import url('../../../vendor/highlight.js/styles/base16/tomorrow.css');
 
 html {
     --top_color: #ec7400;
+    --button_color: #ec7400;
     --anchor_color: #ec7400;
 }

package/doc/static/print.css

@@ -1,4 +1,4 @@
-/* Copyright (C) 2024  Niels Martignène <niels.martignene@protonmail.com>
+/* Copyright (C) 2025  Niels Martignène <niels.martignene@protonmail.com>
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by

package/doc/templates/code.html

@@ -12,8 +12,8 @@
         <meta name="theme-color" content="#6aa051">
         <link rel="stylesheet" href="{{ ASSET static/site.min.css }}">
 
-        <script type="text/javascript" src="{{ ASSET static/site.min.js }}" async></script>
-        <script type="text/javascript" src="{{ ASSET static/highlight.min.js }}" async></script>
+        <script type="text/javascript" src="{{ ASSET static/site.min.js }}"></script>
+        <script type="text/javascript" src="{{ ASSET static/highlight.min.js }}"></script>
     </head>
 
     <body>
@@ -21,7 +21,7 @@
 
         <nav id="top">
             <menu>
-                <a id="logo" href="/"><img src="{{ ASSET static/logo.webp }}" alt="Logo Koffi" /></a>
+                <a id="logo" href="/"><img src="{{ ASSET static/logo.webp }}" width="370" height="198" alt="" /></a>
 
 {{ LINKS }}
 
@@ -39,9 +39,9 @@
         </main>
 
         <footer>
-            <div>Koffi © 2024</div>
+            <div>Koffi © 2025</div>
             <div style="font-size: 0.8em;">
-                Niels Martignène (<a href="https://github.com/Koromix/" target="_blank">Koromix</a>)<br>
+                Niels Martignène (<a href="https://koromix.dev/" target="_blank">Koromix</a>)<br>
                 <a href="mailto:niels.martignene@protonmail.com" style="font-weight: bold; color: inherit;">niels.martignene@protonmail.com</a>
             </div>
         </footer>

package/doc/templates/page.html

@@ -12,7 +12,7 @@
         <meta name="theme-color" content="#6aa051">
         <link rel="stylesheet" href="{{ ASSET static/site.min.css }}">
 
-        <script type="text/javascript" src="{{ ASSET static/site.min.js }}" async></script>
+        <script type="text/javascript" src="{{ ASSET static/site.min.js }}"></script>
     </head>
 
     <body>
@@ -20,7 +20,7 @@
 
         <nav id="top">
             <menu>
-                <a id="logo" href="/"><img src="{{ ASSET static/logo.webp }}" alt="Logo Koffi" /></a>
+                <a id="logo" href="/"><img src="{{ ASSET static/logo.webp }}" width="370" height="198" alt="" /></a>
 
 {{ LINKS }}
 
@@ -38,9 +38,9 @@
         </main>
 
         <footer>
-            <div>Koffi © 2024</div>
+            <div>Koffi © 2025</div>
             <div style="font-size: 0.8em;">
-                Niels Martignène (<a href="https://github.com/Koromix/" target="_blank">Koromix</a>)<br>
+                Niels Martignène (<a href="https://koromix.dev/" target="_blank">Koromix</a>)<br>
                 <a href="mailto:niels.martignene@protonmail.com" style="font-weight: bold; color: inherit;">niels.martignene@protonmail.com</a>
             </div>
         </footer>