@thi.ng/wasm-api 1.4.36 → 1.4.37

package/object-index.js

@@ -1,79 +1,81 @@
 import { assert } from "@thi.ng/errors/assert";
 import { IDGen } from "@thi.ng/idgen";
-export class ObjectIndex {
-    name;
-    logger;
-    idgen;
-    items = [];
-    constructor(opts) {
-        this.name = opts.name;
-        this.logger = opts.logger;
-        this.idgen = new IDGen(opts.bits || 32, 0);
+class ObjectIndex {
+  name;
+  logger;
+  idgen;
+  items = [];
+  constructor(opts) {
+    this.name = opts.name;
+    this.logger = opts.logger;
+    this.idgen = new IDGen(opts.bits || 32, 0);
+  }
+  keys() {
+    return this.idgen[Symbol.iterator]();
+  }
+  *values() {
+    for (let id of this.idgen) {
+      yield this.items[id];
     }
-    keys() {
-        return this.idgen[Symbol.iterator]();
+  }
+  /**
+   * Indexes given `item` and assigns it to the next available ID (which might
+   * be a previously freed ID) and returns it.
+   *
+   * @param item
+   */
+  add(item) {
+    const id = this.idgen.next();
+    this.logger && this.logger.debug(`adding ${this.name} ID: ${id}`);
+    this.items[id] = item;
+    return id;
+  }
+  /**
+   * Returns true if the given `id` is valid/active.
+   *
+   * @param id
+   */
+  has(id) {
+    return this.idgen.has(id);
+  }
+  /**
+   * First checks if given `id` is valid and if so frees it (for recycling)
+   * and deletes its corresponding item. If `ensure` is true (default), throws
+   * an error if the ID is invalid (otherwise returns false for invalid IDs).
+   *
+   * @param id
+   * @param ensure
+   */
+  delete(id, ensure = true) {
+    if (this.idgen.has(id)) {
+      this.logger && this.logger.debug(`deleting ${this.name} ID: ${id}`);
+      this.idgen.free(id);
+      delete this.items[id];
+      return true;
     }
-    *values() {
-        for (let id of this.idgen) {
-            yield this.items[id];
-        }
-    }
-    /**
-     * Indexes given `item` and assigns it to the next available ID (which might
-     * be a previously freed ID) and returns it.
-     *
-     * @param item
-     */
-    add(item) {
-        const id = this.idgen.next();
-        this.logger && this.logger.debug(`adding ${this.name} ID: ${id}`);
-        this.items[id] = item;
+    assert(!ensure, `can't delete missing ${this.name} ID: ${id}`);
+    return false;
+  }
+  get(id, ensure = true) {
+    ensure && assert(this.idgen.has(id), `missing ${this.name} for ID: ${id}`);
+    return this.items[id];
+  }
+  /**
+   * Applies given predicate to all active items and returns ID of first
+   * matching. If `ensure` is true (default), throws an error if the `pred`
+   * didn't match anything (otherwise returns undefined).
+   *
+   * @param pred
+   * @param ensure
+   */
+  find(pred, ensure = true) {
+    for (let id of this.idgen) {
+      if (pred(this.items[id]))
         return id;
     }
-    /**
-     * Returns true if the given `id` is valid/active.
-     *
-     * @param id
-     */
-    has(id) {
-        return this.idgen.has(id);
-    }
-    /**
-     * First checks if given `id` is valid and if so frees it (for recycling)
-     * and deletes its corresponding item. If `ensure` is true (default), throws
-     * an error if the ID is invalid (otherwise returns false for invalid IDs).
-     *
-     * @param id
-     * @param ensure
-     */
-    delete(id, ensure = true) {
-        if (this.idgen.has(id)) {
-            this.logger && this.logger.debug(`deleting ${this.name} ID: ${id}`);
-            this.idgen.free(id);
-            delete this.items[id];
-            return true;
-        }
-        assert(!ensure, `can't delete missing ${this.name} ID: ${id}`);
-        return false;
-    }
-    get(id, ensure = true) {
-        ensure &&
-            assert(this.idgen.has(id), `missing ${this.name} for ID: ${id}`);
-        return this.items[id];
-    }
-    /**
-     * Applies given predicate to all active items and returns ID of first
-     * matching. If `ensure` is true (default), throws an error if the `pred`
-     * didn't match anything (otherwise returns undefined).
-     *
-     * @param pred
-     * @param ensure
-     */
-    find(pred, ensure = true) {
-        for (let id of this.idgen) {
-            if (pred(this.items[id]))
-                return id;
-        }
-        assert(!ensure, `given predicate matched no ${this.name}`);
-    }
+    assert(!ensure, `given predicate matched no ${this.name}`);
+  }
 }
+export {
+  ObjectIndex
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/wasm-api",
-  "version": "1.4.36",
+  "version": "1.4.37",
   "description": "Generic, modular, extensible API bridge and infrastructure for hybrid JS & WebAssembly projects",
   "type": "module",
   "module": "./index.js",
@@ -24,7 +24,9 @@
   "author": "Karsten Schmidt (https://thi.ng)",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "yarn clean && tsc --declaration",
+    "build": "yarn build:esbuild && yarn build:decl",
+    "build:decl": "tsc --declaration --emitDeclarationOnly",
+    "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
@@ -34,16 +36,17 @@
     "test:build-zig": "zig build-lib -O ReleaseSmall -target wasm32-freestanding -dynamic --strip --pkg-begin wasmapi zig/lib.zig --pkg-end test/custom.zig && wasm-dis -o custom.wast custom.wasm && cp custom.wasm test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.11",
-    "@thi.ng/arrays": "^2.7.7",
-    "@thi.ng/checks": "^3.4.11",
-    "@thi.ng/errors": "^2.4.5",
-    "@thi.ng/hex": "^2.3.23",
-    "@thi.ng/idgen": "^2.2.14",
-    "@thi.ng/logger": "^2.0.1"
+    "@thi.ng/api": "^8.9.12",
+    "@thi.ng/arrays": "^2.7.8",
+    "@thi.ng/checks": "^3.4.12",
+    "@thi.ng/errors": "^2.4.6",
+    "@thi.ng/hex": "^2.3.24",
+    "@thi.ng/idgen": "^2.2.15",
+    "@thi.ng/logger": "^2.0.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
+    "esbuild": "^0.19.8",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -113,5 +116,5 @@
     "status": "alpha",
     "year": 2022
   },
-  "gitHead": "25f2ac8ff795a432a930119661b364d4d93b59a0\n"
+  "gitHead": "5e7bafedfc3d53bc131469a28de31dd8e5b4a3ff\n"
 }

package/pointer.js

@@ -1,60 +1,36 @@
-/**
- * Generic pointer facility which on {@link Pointer.deref()} calls wrapper
- * function (provided as ctor arg) to realise the pointer's target value. The
- * pointer's target address can be accessed via {@link Pointer.addr}
- * (read/write).
- *
- * @remarks
- * The pointer always behaves like `volatile`, i.e. memoization of target values
- * is purposfully avoided and the wrapper function is executed anew _each_ time
- * the pointer is deref'd.
- */
-export class Pointer {
-    mem;
-    base;
-    fn;
-    constructor(mem, base, fn) {
-        this.mem = mem;
-        this.base = base;
-        this.fn = fn;
-    }
-    get addr() {
-        return this.mem.u32[this.base >>> 2];
-    }
-    set addr(addr) {
-        this.mem.u32[this.base >>> 2] = addr;
-    }
-    deref() {
-        return this.fn(this.addr);
-    }
+class Pointer {
+  constructor(mem, base, fn) {
+    this.mem = mem;
+    this.base = base;
+    this.fn = fn;
+  }
+  get addr() {
+    return this.mem.u32[this.base >>> 2];
+  }
+  set addr(addr) {
+    this.mem.u32[this.base >>> 2] = addr;
+  }
+  deref() {
+    return this.fn(this.addr);
+  }
 }
-/**
- * Generic pointer facility for {@link WASM64} target, which on
- * {@link Pointer64.deref()} calls wrapper function (provided as ctor arg) to
- * realise the pointer's target value. The pointer's target address can be
- * accessed via {@link Pointer.addr} (read/write).
- *
- * @remarks
- * The pointer always behaves like `volatile`, i.e. memoization of target values
- * is purposfully avoided and the wrapper function is executed anew _each_ time
- * the pointer is deref'd.
- */
-export class Pointer64 {
-    mem;
-    base;
-    fn;
-    constructor(mem, base, fn) {
-        this.mem = mem;
-        this.base = base;
-        this.fn = fn;
-    }
-    get addr() {
-        return this.mem.u64[Number(this.base >> BigInt(3))];
-    }
-    set addr(addr) {
-        this.mem.u64[Number(this.base >> BigInt(3))] = addr;
-    }
-    deref() {
-        return this.fn(this.addr);
-    }
+class Pointer64 {
+  constructor(mem, base, fn) {
+    this.mem = mem;
+    this.base = base;
+    this.fn = fn;
+  }
+  get addr() {
+    return this.mem.u64[Number(this.base >> BigInt(3))];
+  }
+  set addr(addr) {
+    this.mem.u64[Number(this.base >> BigInt(3))] = addr;
+  }
+  deref() {
+    return this.fn(this.addr);
+  }
 }
+export {
+  Pointer,
+  Pointer64
+};