@thi.ng/arrays 2.7.20 → 2.8.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-10T08:59:56Z
+- **Last updated**: 2024-02-19T15:50:26Z
 - **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.8.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.8.0) (2024-02-19)
+
+#### 🚀 Features
+
+- add blitPred1d() predicate version of blit1d() ([c13c4f9](https://github.com/thi-ng/umbrella/commit/c13c4f9))
+
 ## [2.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.7.0) (2023-10-27)
 
 #### 🚀 Features

package/README.md

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

package/blit.d.ts

@@ -1,4 +1,4 @@
-import type { TypedArray } from "@thi.ng/api";
+import type { Fn3, TypedArray } from "@thi.ng/api";
 /**
  * Selectively copies all non-`mask` values from `src` into `dest` starting from
  * destination position `dx`. Returns `dest`.
@@ -30,6 +30,19 @@ import type { TypedArray } from "@thi.ng/api";
  */
 export declare function blit1d<T extends TypedArray>(dest: T, dx: number, src: ArrayLike<number>, mask: number): T;
 export declare function blit1d<T>(dest: T[], dx: number, src: ArrayLike<T>, mask: T): T[];
+/**
+ * Similar to {@link blit1d}, but uses a predicate function to
+ * determine/transform copied values. The predicate is called with the src, and
+ * dest item values and src index. The result of that function is written to the
+ * `dest` array. If the predicate returns `undefined`, no value will be written.
+ *
+ * @param dest
+ * @param dx
+ * @param src
+ * @param pred
+ */
+export declare function blitPred1d<T extends TypedArray>(dest: T, dx: number, src: ArrayLike<number>, pred: Fn3<number, number, number, number | undefined>): T;
+export declare function blitPred1d<T>(dest: T[], dx: number, src: ArrayLike<T>, pred: Fn3<T, T, number, T | undefined>): T[];
 /**
  * 2D version of {@link blit1d} (also with region clipping). Positions and sizes
  * are given as 2D vectors.

package/blit.js

@@ -8,6 +8,16 @@ function blit1d(dest, x, src, mask) {
   }
   return dest;
 }
+function blitPred1d(dest, x, src, pred) {
+  const [sx, sw, dx, dw] = __clip(0, src.length, x, dest.length);
+  if (sw < 1 || dx >= dw)
+    return dest;
+  for (let i = 0; i < sw; i++) {
+    const val = pred(src[sx + i], dest[dx + i], sx + i);
+    val !== void 0 && (dest[dx + i] = val);
+  }
+  return dest;
+}
 function blit2d(dest, dpos, dsize, src, ssize, mask) {
   const [sx, sw, dx, dw] = __clip(0, ssize[0], dpos[0], dsize[0]);
   const [sy, sh, dy, dh] = __clip(0, ssize[1], dpos[1], dsize[1]);
@@ -35,5 +45,6 @@ const __clip = (sx, sw, dx, dw) => {
 };
 export {
   blit1d,
-  blit2d
+  blit2d,
+  blitPred1d
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/arrays",
-  "version": "2.7.20",
+  "version": "2.8.0",
   "description": "Array / Arraylike utilities",
   "type": "module",
   "module": "./index.js",
@@ -165,5 +165,5 @@
   "thi.ng": {
     "year": 2018
   },
-  "gitHead": "e5e7d5c6ed2eadee7a91d59cbd0c86ce880ab1c5\n"
+  "gitHead": "ea2ec2e4f14c572bbfac00c43953a6c4033da09e\n"
 }