@thi.ng/wasm-api 0.6.0 → 0.9.0

package/include/wasmapi.h

@@ -7,9 +7,13 @@ extern "C" {
 #include <stddef.h>
 #include <stdint.h>
 
+// Declares an imported symbol from named import module
+// The prefix is only used for the C side, NOT for exported name
 #define WASM_IMPORT(MODULE, TYPE, NAME, PREFIX)                     \
   extern __attribute__((import_module(MODULE), import_name(#NAME))) \
   TYPE PREFIX##NAME
+
+// Same as EMSCRIPTEN_KEEP_ALIVE, ensures symbol will be exported
 #define WASM_KEEP __attribute__((used))
 
 // Generate stubs only if explicitly disabled by defining this symbol
@@ -53,6 +57,8 @@ WASM_IMPORT("wasmapi", void, _printF64Array, wasm)(void* addr, size_t len);
 WASM_IMPORT("wasmapi", void, _printStr0, wasm)(void* addr);
 WASM_IMPORT("wasmapi", void, _printStr, wasm)(void* addr, size_t len);
 
+WASM_IMPORT("wasmapi", void, debug, wasm_)(void);
+
 void wasm_printPtr(void* ptr) { wasm_printU32Hex((size_t)ptr); }
 
 #ifdef __cplusplus

package/include/wasmapi.zig

@@ -165,6 +165,9 @@ pub fn printStr(msg: []const u8) void {
     _printStr(@ptrToInt(msg.ptr), msg.len);
 }
 
+/// Calls std.fmt.allocPrint to format given string, then calls `printStr()`
+/// to output it via JS, then frees string's memory again
+/// (Only available if the allocator used by `_wasm_allocate()` hasn't been disabled.)
 pub fn printFmt(comptime fmt: []const u8, args: anytype) void {
     if (allocator) |alloc| {
         const res = std.fmt.allocPrint(alloc, fmt, args) catch return;
@@ -172,3 +175,6 @@ pub fn printFmt(comptime fmt: []const u8, args: anytype) void {
         printStr(res);
     }
 }
+
+/// Triggers the JS/browser debugger
+pub extern "wasmapi" fn debug() void;

package/index.d.ts

@@ -1,8 +1,8 @@
 export * from "./api.js";
 export * from "./bridge.js";
 export * from "./codegen.js";
-export * from "./object-index.js";
 export * from "./codegen/typescript.js";
-export * from "./codegen/zig.js";
 export * from "./codegen/utils.js";
+export * from "./codegen/zig.js";
+export * from "./object-index.js";
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,7 +1,7 @@
 export * from "./api.js";
 export * from "./bridge.js";
 export * from "./codegen.js";
-export * from "./object-index.js";
 export * from "./codegen/typescript.js";
-export * from "./codegen/zig.js";
 export * from "./codegen/utils.js";
+export * from "./codegen/zig.js";
+export * from "./object-index.js";

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@thi.ng/wasm-api",
-  "version": "0.6.0",
+  "version": "0.9.0",
   "description": "Generic, modular, extensible API bridge, glue code and bindings code generator for hybrid JS & WebAssembly projects",
   "type": "module",
   "module": "./index.js",
   "typings": "./index.d.ts",
+  "bin": "bin/wasm-api",
   "sideEffects": false,
   "repository": {
     "type": "git",
@@ -35,19 +36,21 @@
     "test:build-zig": "zig build-lib -O ReleaseSmall -target wasm32-freestanding -dynamic --strip --pkg-begin wasmapi include/wasmapi.zig --pkg-end test/custom.zig && wasm-dis -o custom.wast custom.wasm && cp custom.wasm test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.4.0",
-    "@thi.ng/binary": "^3.3.3",
+    "@thi.ng/api": "^8.4.1",
+    "@thi.ng/args": "^2.2.1",
+    "@thi.ng/binary": "^3.3.4",
     "@thi.ng/checks": "^3.2.4",
-    "@thi.ng/compare": "^2.1.10",
-    "@thi.ng/defmulti": "^2.1.12",
+    "@thi.ng/compare": "^2.1.11",
+    "@thi.ng/defmulti": "^2.1.13",
     "@thi.ng/errors": "^2.1.10",
+    "@thi.ng/file-io": "^0.3.10",
     "@thi.ng/hex": "^2.1.9",
-    "@thi.ng/idgen": "^2.1.11",
-    "@thi.ng/logger": "^1.2.0"
+    "@thi.ng/idgen": "^2.1.12",
+    "@thi.ng/logger": "^1.2.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.25.0",
-    "@thi.ng/testament": "^0.2.11",
+    "@thi.ng/testament": "^0.2.12",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
     "typedoc": "^0.22.17",
@@ -80,8 +83,9 @@
   "files": [
     "*.js",
     "*.d.ts",
-    "codegen",
-    "include"
+    "bin",
+    "include",
+    "codegen"
   ],
   "exports": {
     ".": {
@@ -113,5 +117,5 @@
     "status": "alpha",
     "year": 2022
   },
-  "gitHead": "295e76c6f68ef34ba2117ff77612848e09f5c587\n"
+  "gitHead": "be8423e2019e95c14a096260a93b9762dde0c768\n"
 }