@thi.ng/arrays 2.11.2 → 2.12.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-06-09T17:24:08Z
+- **Last updated**: 2025-06-14T20:56:27Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,16 @@ 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.12.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.12.0) (2025-06-14)
+
+#### 🚀 Features
+
+- add lookup() / lookupUnsafe() fns ([deb2b37](https://github.com/thi-ng/umbrella/commit/deb2b37))
+
+#### ♻️ Refactoring
+
+- minor update swizzle() ([84d3aba](https://github.com/thi-ng/umbrella/commit/84d3aba))
+
 ## [2.11.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/arrays@2.11.0) (2025-04-30)
 
 #### 🚀 Features

package/README.md

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

package/index.d.ts

@@ -17,6 +17,7 @@ export * from "./insert.js";
 export * from "./into.js";
 export * from "./iterator.js";
 export * from "./levenshtein.js";
+export * from "./lookup.js";
 export * from "./peek.js";
 export * from "./permutation.js";
 export * from "./quicksort.js";

package/index.js

@@ -17,6 +17,7 @@ export * from "./insert.js";
 export * from "./into.js";
 export * from "./iterator.js";
 export * from "./levenshtein.js";
+export * from "./lookup.js";
 export * from "./peek.js";
 export * from "./permutation.js";
 export * from "./quicksort.js";

package/lookup.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Similar to {@link swizzle}, but immediate and bounds-checked. Takes an array
+ * of `table` values and an array of indices `ids`. Returns an array of
+ * looked-up values for given IDs, ensuring each index is valid (otherwise
+ * throws an error).
+ *
+ * @example
+ * ```ts tangle:../export/lookup.ts
+ * import { lookup } from "@thi.ng/arrays";
+ *
+ * console.log(lookup([10,20,30], [2,2,0,1,1]));
+ * // [30, 30, 10, 20, 20]
+ *
+ * console.log(lookup([10,20,30], [3]));
+ * // error: index out of bounds: 3
+ * ```
+ *
+ * @param table
+ * @param ids
+ */
+export declare const lookup: <T>(table: ArrayLike<T>, ids: number[]) => T[];
+/**
+ * Non-bounds-checked version of {@link lookup}.
+ *
+ * @param table
+ * @param ids
+ */
+export declare const lookupUnsafe: <T>(table: ArrayLike<T>, ids: number[]) => T[];
+//# sourceMappingURL=lookup.d.ts.map

package/lookup.js

@@ -0,0 +1,7 @@
+import { ensureIndex } from "@thi.ng/errors/out-of-bounds";
+const lookup = (table, ids) => ids.map((i) => (ensureIndex(i, 0, table.length), table[i]));
+const lookupUnsafe = (table, ids) => ids.map((i) => table[i]);
+export {
+  lookup,
+  lookupUnsafe
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/arrays",
-  "version": "2.11.2",
+  "version": "2.12.0",
   "description": "Array / Arraylike utilities",
   "type": "module",
   "module": "./index.js",
@@ -136,6 +136,9 @@
     "./levenshtein": {
       "default": "./levenshtein.js"
     },
+    "./lookup": {
+      "default": "./lookup.js"
+    },
     "./peek": {
       "default": "./peek.js"
     },
@@ -174,5 +177,5 @@
     "tag": "array",
     "year": 2018
   },
-  "gitHead": "93cdcd8db4d4669561a7f0ebc47697bdbfd04214\n"
+  "gitHead": "14e994e531d32053e948768998324d443436a542\n"
 }

package/swizzle.js

@@ -21,10 +21,9 @@ const swizzle = (order) => {
       return (x) => [x[a], x[b], x[c], x[d], x[e], x[f], x[g], x[h]];
     default:
       return (x) => {
-        const res = [];
-        for (let i = order.length; i-- > 0; ) {
-          res[i] = x[order[i]];
-        }
+        let n = order.length;
+        const res = new Array(n);
+        for (; n-- > 0; ) res[n] = x[order[n]];
         return res;
       };
   }