@thi.ng/wasm-api 2.2.7 → 2.3.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-04T21:07:38Z
+- **Last updated**: 2025-01-14T12:23:33Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,18 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [2.3.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@2.3.1) (2025-01-14)
+
+#### ♻️ Refactoring
+
+- use optional chaining & nullish coalescing ([c5a0a13](https://github.com/thi-ng/umbrella/commit/c5a0a13))
+
+## [2.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@2.3.0) (2025-01-10)
+
+#### 🚀 Features
+
+- add WasmTypeKeys helper type ([7e293ce](https://github.com/thi-ng/umbrella/commit/7e293ce))
+
 ### [2.2.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@2.2.1) (2024-11-10)
 
 #### 🩹 Bug fixes

package/README.md

@@ -27,6 +27,7 @@
 - [Naming & structural conventions](#naming--structural-conventions)
 - [Status](#status)
 - [Support packages](#support-packages)
+  - [Third party modules](#third-party-modules)
 - [Installation](#installation)
 - [Dependencies](#dependencies)
 - [Usage examples](#usage-examples)
@@ -440,6 +441,10 @@ please also consult the information in
 - [@thi.ng/wasm-api-schedule](https://github.com/thi-ng/umbrella/tree/develop/packages/wasm-api-schedule) - Delayed & scheduled function execution (via setTimeout() etc.) for hybrid WASM apps
 - [@thi.ng/wasm-api-webgl](https://github.com/thi-ng/umbrella/tree/develop/packages/wasm-api-webgl) - WebGL bridge API for hybrid TypeScript & WASM (Zig) applications
 
+### Third party modules
+
+- [@genart-api/wasm](https://github.com/thi-ng/genart-api/tree/main/packages/wasm) — WASM/Zig bindings for [GenArtAPI](https://thi.ng/genart-api)
+
 ## Installation
 
 ```bash

package/api.d.ts

@@ -1,4 +1,4 @@
-import type { BigTypedArray, EVENT_ALL, Fn, IDeref, ILength, TypedArray, Values } from "@thi.ng/api";
+import type { BigTypedArray, EVENT_ALL, Fn, IDeref, ILength, Keys, TypedArray, Values } from "@thi.ng/api";
 import type { WasmBridge } from "./bridge.js";
 export declare const EVENT_MEMORY_CHANGED = "memory-changed";
 export declare const EVENT_PANIC = "panic";
@@ -17,6 +17,11 @@ export interface WasmTypeBase {
      */
     readonly __bytes: Uint8Array;
 }
+/**
+ * Helper type to extract field names of structs/unions based on
+ * {@link WasmTypeBase} (e.g. those generated by thi.ng/wasm-api-bindgen).
+ */
+export type WasmTypeKeys<T extends WasmTypeBase> = Keys<Omit<T, Keys<WasmTypeBase>>>;
 export interface WasmType<T> {
     /**
      * Type alignment (in bytes)

package/bridge.d.ts

@@ -120,8 +120,8 @@ export declare class WasmBridge<T extends WasmExports = WasmExports> implements
      * @remarks
      * Each API module's imports will be in their own WASM import object/table,
      * named using the same key which is defined by the JS side of the module
-     * via {@link IWasmAPI.id}. The bridge's core API is named `wasmapi` and is
-     * reserved.
+     * via {@link WasmModuleSpec.id}. The bridge's core API is named `wasmapi`
+     * and is reserved.
      *
      * @example
      * The following creates a bridge with a fictional `custom` API module:

package/bridge.js

@@ -180,7 +180,7 @@ let WasmBridge = class {
    */
   ensureMemory(notify = true) {
     const buf = this.exports.memory.buffer;
-    if (this.u8 && this.u8.buffer === buf) return;
+    if (this.u8?.buffer === buf) return;
     this.i8 = new Int8Array(buf);
     this.u8 = new Uint8Array(buf);
     this.i16 = new Int16Array(buf);
@@ -204,8 +204,8 @@ let WasmBridge = class {
    * @remarks
    * Each API module's imports will be in their own WASM import object/table,
    * named using the same key which is defined by the JS side of the module
-   * via {@link IWasmAPI.id}. The bridge's core API is named `wasmapi` and is
-   * reserved.
+   * via {@link WasmModuleSpec.id}. The bridge's core API is named `wasmapi`
+   * and is reserved.
    *
    * @example
    * The following creates a bridge with a fictional `custom` API module:

package/object-index.js

@@ -27,7 +27,7 @@ class ObjectIndex {
    */
   add(item) {
     const id = this.idgen.next();
-    this.logger && this.logger.debug(`adding ${this.name} ID: ${id}`);
+    this.logger?.debug(`adding ${this.name} ID: ${id}`);
     this.items[id] = item;
     return id;
   }
@@ -65,7 +65,7 @@ class ObjectIndex {
    */
   delete(id, ensure = true) {
     if (this.idgen.has(id)) {
-      this.logger && this.logger.debug(`deleting ${this.name} ID: ${id}`);
+      this.logger?.debug(`deleting ${this.name} ID: ${id}`);
       this.idgen.free(id);
       delete this.items[id];
       return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/wasm-api",
-  "version": "2.2.7",
+  "version": "2.3.1",
   "description": "Generic, modular, extensible API bridge and infrastructure for hybrid JS & WebAssembly projects",
   "type": "module",
   "module": "./index.js",
@@ -44,12 +44,12 @@
   },
   "dependencies": {
     "@thi.ng/api": "^8.11.16",
-    "@thi.ng/arrays": "^2.10.9",
-    "@thi.ng/checks": "^3.6.18",
+    "@thi.ng/arrays": "^2.10.10",
+    "@thi.ng/checks": "^3.6.19",
     "@thi.ng/errors": "^2.5.22",
     "@thi.ng/hex": "^2.3.60",
     "@thi.ng/idgen": "^2.2.56",
-    "@thi.ng/logger": "^3.0.26"
+    "@thi.ng/logger": "^3.0.27"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.48.1",
@@ -128,5 +128,5 @@
     "status": "alpha",
     "year": 2022
   },
-  "gitHead": "56c1d57a96565bbcc8c06c73779a619bba0db368\n"
+  "gitHead": "6542b842120bef47cc18d45a1b1db68307a7f04b\n"
 }