WIP: emscripten API bindings for zig

This repository contains zigified version of: https://github.com/emscripten-core/emscripten/tree/main/system/include
As well as some utilites for integration with zig std library, such as allocator wrapper etc. Most emscripten headers can be @cImported without issues, however zig bindings purpose is to allow nicer integration as well as providing better type-safety.

Header status src/emscripten/*:

matching version: emcc (Emscripten gcc/clang-like replacement + linker emulating GNU ld) 3.1.26 (8eaf19f1c6a9a1b0cd0f9a91657366829e34ae5c)

header	rewritten	notes
atomic.h	-
bind.h	-
console.h	✔️
dom_pk_codes.h	-
emmalloc.h	✔️
emscripten.h	🛠️	some functions skipped.
em_asm.h	-
em_js.h	-
em_macros.h	✖	c macros can't be done in zig.
em_math.h	-
em_types.h	✔️
eventloop.h	✔️
exports.h	-
fetch.h	🛠️
fiber.h	-
heap.h	✔️
html5.h	✔️	could have bugs. missing shortcuts functions.
html5_webgl.h	-
html5_webgpu.h	✖	Nothing useful in this header
key_codes.h	-
posix_socket.h	-
proxying.h	-
stack.h	-
threading.h	-
trace.h	-
val.h	-
wasmfs.h	-
wasm_worker	-
websocket.h	-
wget.h	-
wire.h	-

Zig specific bindings

• Allocators src/allocator.zig:
  • ✔️ BuiltinAllocator (doesn't have realloc)
  • ✔️ EmMalloc allocator
• Timer src/time.zig

Usage

Add package to your project in build.zig;

    const emscripten_pkg = std.build.Pkg{
        .name = "emscripten",
        .source = .{ .path = sdkPath("path to emscripten.zig")},
        .dependencies = &.{},
    };
    ...
    my_lib_or_exe.addPackage(emscripten_pkg);

Usage:

const ems = @import("emscripten");

ems.console.log("hello world");

var gpa : ems.allocator.EmmalocAllocator = .{};
var allocator : std.mem.Allocator = gpa.allocator();