@thi.ng/bidir-index 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-05-28T12:02:39Z
+- **Last updated**: 2025-06-09T17:24:08Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,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.
 
+## [1.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/bidir-index@1.3.0) (2025-06-09)
+
+#### 🚀 Features
+
+- add `.addAllUnique()` & `.getAllUnique()` ([175e3dc](https://github.com/thi-ng/umbrella/commit/175e3dc))
+
 ## [1.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/bidir-index@1.2.0) (2025-04-30)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 208 standalone projects, maintained as part
+> This is one of 209 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -67,7 +67,7 @@ For Node.js REPL:
 const bi = await import("@thi.ng/bidir-index");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 854 bytes
+Package sizes (brotli'd, pre-treeshake): ESM: 884 bytes
 
 ## Dependencies
 

package/bidir-index.d.ts

@@ -64,6 +64,13 @@ export declare class BidirIndex<T> {
      * @param keys
      */
     addAll(keys: Iterable<T>): number[];
+    /**
+     * Similar to {@link BidirIndex.addAll}, but returns indexed key IDs as ES6
+     * Set, thereby removing any duplicates present in `keys`.
+     *
+     * @param keys
+     */
+    addAllUnique(keys: Iterable<T>): Set<number>;
     /**
      * Removes bi-directional mapping for given `key` from the index. Returns
      * true if successful.
@@ -99,6 +106,14 @@ export declare class BidirIndex<T> {
      * @param fail
      */
     getAll(keys: Iterable<T>, fail?: boolean): number[];
+    /**
+     * Similar to {@link BidirIndex.getAll}, but returns result as ES6 Set,
+     * thereby removing any duplicates in `keys`.
+     *
+     * @param keys
+     * @param fail
+     */
+    getAllUnique(keys: Iterable<T>, fail?: boolean): Set<number>;
     /**
      * Returns array of matching keys for all given IDs. If `fail` is true
      * (default: false), throws error if any of the given IDs is

package/bidir-index.js

@@ -97,6 +97,19 @@ class BidirIndex {
     }
     return res;
   }
+  /**
+   * Similar to {@link BidirIndex.addAll}, but returns indexed key IDs as ES6
+   * Set, thereby removing any duplicates present in `keys`.
+   *
+   * @param keys
+   */
+  addAllUnique(keys) {
+    const res = /* @__PURE__ */ new Set();
+    for (let k of keys) {
+      res.add(this.add(k));
+    }
+    return res;
+  }
   /**
    * Removes bi-directional mapping for given `key` from the index. Returns
    * true if successful.
@@ -142,6 +155,16 @@ class BidirIndex {
   getAll(keys, fail = false) {
     return __iterate(this.fwd, keys, fail);
   }
+  /**
+   * Similar to {@link BidirIndex.getAll}, but returns result as ES6 Set,
+   * thereby removing any duplicates in `keys`.
+   *
+   * @param keys
+   * @param fail
+   */
+  getAllUnique(keys, fail = false) {
+    return new Set(__iterate(this.fwd, keys, fail));
+  }
   /**
    * Returns array of matching keys for all given IDs. If `fail` is true
    * (default: false), throws error if any of the given IDs is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/bidir-index",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Bi-directional index mapping arbitrary keys to numeric IDs & vice versa",
   "type": "module",
   "module": "./index.js",
@@ -89,5 +89,5 @@
     ],
     "year": 2022
   },
-  "gitHead": "61c3833b7ef7d044621454b5ea4af885d39f065e\n"
+  "gitHead": "93cdcd8db4d4669561a7f0ebc47697bdbfd04214\n"
 }