@thi.ng/wasm-api 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-11-09T15:34:31Z
+- **Last updated**: 2024-11-10T17:11:51Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ 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.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@2.2.0) (2024-11-10)
+
+#### 🚀 Features
+
+- add defType() construction helper ([947e3fc](https://github.com/thi-ng/umbrella/commit/947e3fc))
+
 ## [2.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@2.1.0) (2024-11-09)
 
 #### 🚀 Features

package/README.md

@@ -460,7 +460,7 @@ Browser ESM import:
 
 [JSDelivr documentation](https://www.jsdelivr.com/)
 
-Package sizes (brotli'd, pre-treeshake): ESM: 3.05 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 3.11 KB
 
 ## Dependencies
 

package/deftype.d.ts

@@ -0,0 +1,12 @@
+import type { Fn2 } from "@thi.ng/api";
+import type { IWasmMemoryAccess, WasmTypeBase, WasmTypeConstructor } from "./api.js";
+/**
+ * Shared construction helper for types generated by
+ * [thi.ng/wasm-api-bindgen](https://thi.ng/wasm-api-bindgen).
+ *
+ * @param align
+ * @param size
+ * @param instance
+ */
+export declare const defType: <T extends WasmTypeBase>(align: number, size: number, instance: Fn2<IWasmMemoryAccess, number, Omit<T, keyof WasmTypeBase>>) => WasmTypeConstructor<T>;
+//# sourceMappingURL=deftype.d.ts.map

package/deftype.js

@@ -0,0 +1,24 @@
+import { __instanceArray } from "./memory.js";
+const defType = (align, size, instance) => (mem) => ({
+  get align() {
+    return align;
+  },
+  get size() {
+    return size;
+  },
+  instanceArray(base, num) {
+    return __instanceArray(this, base, num);
+  },
+  instance: (base) => ({
+    get __base() {
+      return base;
+    },
+    get __bytes() {
+      return mem.u8.subarray(base, base + size);
+    },
+    ...instance(mem, base)
+  })
+});
+export {
+  defType
+};

package/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./api.js";
 export * from "./bridge.js";
+export * from "./deftype.js";
 export * from "./memory.js";
 export * from "./object-index.js";
 export * from "./pointer.js";

package/index.js

@@ -1,5 +1,6 @@
 export * from "./api.js";
 export * from "./bridge.js";
+export * from "./deftype.js";
 export * from "./memory.js";
 export * from "./object-index.js";
 export * from "./pointer.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/wasm-api",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Generic, modular, extensible API bridge and infrastructure for hybrid JS & WebAssembly projects",
   "type": "module",
   "module": "./index.js",
@@ -28,7 +28,7 @@
     "build:decl": "tsc --declaration --emitDeclarationOnly",
     "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "bun ../../tools/src/clean-package.ts",
-    "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
+    "doc": "typedoc --options ../../typedoc.json --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "bun ../../tools/src/module-stats.ts && bun ../../tools/src/readme.ts",
     "pub": "yarn npm publish --access public",
@@ -39,13 +39,13 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.11",
-    "@thi.ng/arrays": "^2.10.4",
-    "@thi.ng/checks": "^3.6.13",
-    "@thi.ng/errors": "^2.5.17",
-    "@thi.ng/hex": "^2.3.55",
-    "@thi.ng/idgen": "^2.2.51",
-    "@thi.ng/logger": "^3.0.21"
+    "@thi.ng/api": "^8.11.12",
+    "@thi.ng/arrays": "^2.10.5",
+    "@thi.ng/checks": "^3.6.14",
+    "@thi.ng/errors": "^2.5.18",
+    "@thi.ng/hex": "^2.3.56",
+    "@thi.ng/idgen": "^2.2.52",
+    "@thi.ng/logger": "^3.0.22"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.47.9",
@@ -104,6 +104,9 @@
     "./bridge": {
       "default": "./bridge.js"
     },
+    "./deftype": {
+      "default": "./deftype.js"
+    },
     "./memory": {
       "default": "./memory.js"
     },
@@ -121,5 +124,5 @@
     "status": "alpha",
     "year": 2022
   },
-  "gitHead": "c2c371069911fdae138149fdcf937c4ad7a8c71e\n"
+  "gitHead": "ef89090bb19fc5bca23be5da8cfce05b82ff4ad1\n"
 }