@thi.ng/arrays 2.2.4 → 2.3.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-06-09T16:14:01Z
+- **Last updated**: 2022-07-19T15:36:12Z
 - **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.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.3.0) (2022-07-08)
+
+#### 🚀 Features
+
+- add blit1d/2d() functions ([56e8373](https://github.com/thi-ng/umbrella/commit/56e8373))
+
 ## [2.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.2.0) (2022-03-11)
 
 #### 🚀 Features

package/README.md

@@ -51,7 +51,7 @@ node --experimental-repl-await
 > const arrays = await import("@thi.ng/arrays");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 2.30 KB
+Package sizes (gzipped, pre-treeshake): ESM: 2.51 KB
 
 ## Dependencies
 
@@ -70,6 +70,7 @@ Package sizes (gzipped, pre-treeshake): ESM: 2.30 KB
 - [argSort()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/arg-sort.ts)
 - [binarySearch()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/binary-search.ts)
 - [bisect()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/bisect.ts)
+- [blit1d() / blit2d()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/blit.ts)
 - [endsWith()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/ends-with.ts)
 - [ensureArray()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/ensure-array.ts)
 - [ensureIterable()](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays/src/ensure-iterable.ts)

package/blit.d.ts

@@ -0,0 +1,46 @@
+import type { TypedArray } from "@thi.ng/api";
+/**
+ * Selectively copies all non-`mask` values from `src` into `dest` starting from
+ * destination position `dx`. Returns `dest`.
+ *
+ * @remarks
+ * Where `src` values are the same as `mask`, the corresponding `dest` values
+ * will be left unchanged. Performs region clipping, i.e. `dx` can be outside
+ * the [0..dest.length) interval.
+ *
+ * @example
+ * ```ts
+ * blit1d(
+ *    // dest array
+ *    [1, 1, 1, 1, 1, 1, 1, 1, 1],
+ *    // paste from index 2
+ *    2,
+ *    // source array
+ *    [2, 3, 2, 3, 2],
+ *    // mask value
+ *    3
+ * )
+ * //[1, 1, 2, 1, 2, 1, 2, 1, 1]
+ * ```
+ *
+ * @param dest
+ * @param src
+ * @param dx
+ * @param mask
+ */
+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[];
+/**
+ * 2D version of {@link blit1d} (also with region clipping). Positions and sizes
+ * are given as 2D vectors.
+ *
+ * @param dest
+ * @param dpos
+ * @param dsize
+ * @param src
+ * @param ssize
+ * @param mask
+ */
+export declare function blit2d<T extends TypedArray>(dest: T, dpos: ArrayLike<number>, dsize: ArrayLike<number>, src: ArrayLike<number>, ssize: ArrayLike<number>, mask: number): T;
+export declare function blit2d<T>(dest: T[], dpos: ArrayLike<number>, dsize: ArrayLike<number>, src: ArrayLike<T>, ssize: ArrayLike<number>, mask: T): T[];
+//# sourceMappingURL=blit.d.ts.map

package/blit.js

@@ -0,0 +1,36 @@
+export function blit1d(dest, x, src, mask) {
+    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 = src[sx + i];
+        val !== mask && (dest[dx + i] = val);
+    }
+    return dest;
+}
+export 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]);
+    if (sw < 1 || sh < 1 || dx >= dw || dy >= dh)
+        return dest;
+    const sstride = ssize[0];
+    const dstride = dsize[0];
+    for (let y = 0; y < sh; y++) {
+        for (let x = 0, soff = (sy + y) * sstride + sx, doff = (dy + y) * dstride + dx; x < sw; x++) {
+            const val = src[soff + x];
+            val !== mask && (dest[doff + x] = val);
+        }
+    }
+    return dest;
+}
+const __clip = (sx, sw, dx, dw) => {
+    if (dx < 0) {
+        sx -= dx;
+        sw += dx;
+        dx = 0;
+    }
+    else if (dx + sw > dw) {
+        sw = dw - dx;
+    }
+    return [sx, sw, dx, dw];
+};

package/index.d.ts

@@ -2,6 +2,7 @@ export * from "./api.js";
 export * from "./arg-sort.js";
 export * from "./binary-search.js";
 export * from "./bisect.js";
+export * from "./blit.js";
 export * from "./ends-with.js";
 export * from "./ensure-array.js";
 export * from "./ensure-iterable.js";

package/index.js

@@ -2,6 +2,7 @@ export * from "./api.js";
 export * from "./arg-sort.js";
 export * from "./binary-search.js";
 export * from "./bisect.js";
+export * from "./blit.js";
 export * from "./ends-with.js";
 export * from "./ensure-array.js";
 export * from "./ensure-iterable.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/arrays",
-  "version": "2.2.4",
+  "version": "2.3.1",
   "description": "Array / Arraylike utilities",
   "type": "module",
   "module": "./index.js",
@@ -34,20 +34,20 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.7",
-    "@thi.ng/checks": "^3.2.0",
-    "@thi.ng/compare": "^2.1.7",
-    "@thi.ng/equiv": "^2.1.7",
-    "@thi.ng/errors": "^2.1.7",
-    "@thi.ng/random": "^3.3.1"
+    "@thi.ng/api": "^8.3.8",
+    "@thi.ng/checks": "^3.2.2",
+    "@thi.ng/compare": "^2.1.8",
+    "@thi.ng/equiv": "^2.1.8",
+    "@thi.ng/errors": "^2.1.8",
+    "@thi.ng/random": "^3.3.3"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.25.0",
-    "@thi.ng/testament": "^0.2.8",
+    "@thi.ng/testament": "^0.2.9",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
     "typedoc": "^0.22.17",
-    "typescript": "^4.7.3"
+    "typescript": "^4.7.4"
   },
   "keywords": [
     "aos",
@@ -85,6 +85,9 @@
     "./bisect": {
       "default": "./bisect.js"
     },
+    "./blit": {
+      "default": "./blit.js"
+    },
     "./ends-with": {
       "default": "./ends-with.js"
     },
@@ -143,5 +146,5 @@
   "thi.ng": {
     "year": 2018
   },
-  "gitHead": "9e516d30a1a537e027a6b3d78bf9121bc5831d31\n"
+  "gitHead": "108a6357b77d457912d30681d7cc5603ae995209\n"
 }