@thi.ng/api 8.7.5 → 8.8.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-03-27T19:05:48Z
+- **Last updated**: 2023-04-19T09:28:07Z
 - **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.
 
+## [8.8.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.8.0) (2023-04-19)
+
+#### 🚀 Features
+
+- add typedArrayOfVec() ([39307bf](https://github.com/thi-ng/umbrella/commit/39307bf))
+
 ## [8.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.7.0) (2023-02-05)
 
 #### 🚀 Features

package/README.md

@@ -55,7 +55,7 @@ For Node.js REPL:
 const api = await import("@thi.ng/api");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.30 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.36 KB
 
 ## Dependencies
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.7.5",
+  "version": "8.8.0",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -38,11 +38,11 @@
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.34.4",
-    "@thi.ng/testament": "^0.3.14",
+    "@thi.ng/testament": "^0.3.15",
     "rimraf": "^4.4.1",
     "tools": "^0.0.1",
     "typedoc": "^0.23.28",
-    "typescript": "^5.0.2"
+    "typescript": "^5.0.4"
   },
   "keywords": [
     "assert",
@@ -225,5 +225,5 @@
       "default": "./watch.js"
     }
   },
-  "gitHead": "83b15b34326d480cbca0472b20390d4d3bbb792a\n"
+  "gitHead": "3a56bc490f1e68754762a503d06327b5b34ff7eb\n"
 }

package/typedarray.d.ts

@@ -158,6 +158,32 @@ export declare function typedArray<T extends Type | GLType>(type: T, buf: ArrayB
 export declare function typedArray<T extends BigType>(type: T, length: number): BigTypedArrayTypeMap[T];
 export declare function typedArray<T extends BigType>(type: T, src: ArrayLike<bigint> | ArrayBufferLike): BigTypedArrayTypeMap[T];
 export declare function typedArray<T extends BigType>(type: T, buf: ArrayBufferLike, byteOffset: number, length?: number): BigTypedArrayTypeMap[T];
+/**
+ * Constructs a typed array for given `type` and populates it with given vector
+ * values.
+ *
+ * @remarks
+ * The size of the array will be `data.length * stride`, where `stride` is the
+ * number of elements per item and defaulting to the size of the first data
+ * item/vector given.
+ *
+ * @example
+ * ```ts
+ * // inferred stride=2 (2d vectors)
+ * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]]);
+ * // Float32Array(6) [ 1, 2, 3, 4, -10, 20 ]
+ *
+ * // with custom stride=4
+ * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]], 4);
+ * // Float32Array(12) [ 1, 2, 0, 0, 3,4, 0, 0, -10, 20, 0, 0 ]
+ * ```
+ *
+ * @param type
+ * @param data
+ * @param stride
+ */
+export declare function typedArrayOfVec<T extends Type | GLType>(type: T, data: Iterable<ArrayLike<number>>, stride?: number): TypedArrayTypeMap[T];
+export declare function typedArrayOfVec<T extends BigType>(type: T, data: Iterable<ArrayLike<bigint>>, stride?: number): BigTypedArrayTypeMap[T];
 /**
  * Takes an {@link NumericArray} and returns its corresponding {@link Type} ID.
  * Standard JS arrays will default to {@link "f64"}.

package/typedarray.js

@@ -149,6 +149,17 @@ export function typedArray(type, ...xs) {
     const ctor = BIGINT_ARRAY_CTORS[type];
     return new (ctor || TYPEDARRAY_CTORS[asNativeType(type)])(...xs);
 }
+export function typedArrayOfVec(type, data, stride) {
+    const $data = Array.isArray(data) ? data : [...data];
+    if (stride === undefined)
+        stride = $data[0].length;
+    const num = $data.length;
+    const res = typedArray(type, num * stride);
+    for (let i = 0, j = 0; i < num; i++, j += stride) {
+        res.set($data[i], j);
+    }
+    return res;
+}
 /**
  * Takes an {@link NumericArray} and returns its corresponding {@link Type} ID.
  * Standard JS arrays will default to {@link "f64"}.