data-structure-typed 1.44.0 → 1.45.0

package/dist/umd/data-structure-typed.js

@@ -113,9 +113,11 @@ var dataStructureTyped = (() => {
     FibonacciHeap: () => FibonacciHeap,
     FibonacciHeapNode: () => FibonacciHeapNode,
     HashMap: () => HashMap,
+    HashMapIterator: () => HashMapIterator,
     HashTable: () => HashTable,
     HashTableNode: () => HashTableNode,
     Heap: () => Heap,
+    IterateDirection: () => IterateDirection,
     IterationType: () => IterationType,
     LinkedListQueue: () => LinkedListQueue,
     MapEdge: () => MapEdge,
@@ -142,7 +144,6 @@ var dataStructureTyped = (() => {
     SkipListNode: () => SkipListNode,
     Stack: () => Stack,
     THUNK_SYMBOL: () => THUNK_SYMBOL,
-    TopologicalProperty: () => TopologicalProperty,
     TreeMap: () => TreeMap,
     TreeMultimap: () => TreeMultimap,
     TreeMultimapNode: () => TreeMultimapNode,
@@ -156,7 +157,10 @@ var dataStructureTyped = (() => {
     Vector2D: () => Vector2D,
     arrayRemove: () => arrayRemove,
     getMSB: () => getMSB,
+    isObjOrFunc: () => isObjOrFunc,
     isThunk: () => isThunk,
+    rangeCheck: () => rangeCheck,
+    throwRangeError: () => throwRangeError,
     toThunk: () => toThunk,
     trampoline: () => trampoline,
     trampolineAsync: () => trampolineAsync,
@@ -489,148 +493,561 @@ var dataStructureTyped = (() => {
   var TreeSet = class {
   };
 
+  // src/utils/utils.ts
+  var uuidV4 = function() {
+    return "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".replace(/[x]/g, function(c) {
+      const r = Math.random() * 16 | 0, v = c == "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+  };
+  var arrayRemove = function(array, predicate) {
+    let i = -1, len = array ? array.length : 0;
+    const result = [];
+    while (++i < len) {
+      const value = array[i];
+      if (predicate(value, i, array)) {
+        result.push(value);
+        Array.prototype.splice.call(array, i--, 1);
+        len--;
+      }
+    }
+    return result;
+  };
+  var THUNK_SYMBOL = Symbol("thunk");
+  var isThunk = (fnOrValue) => {
+    return typeof fnOrValue === "function" && fnOrValue.__THUNK__ === THUNK_SYMBOL;
+  };
+  var toThunk = (fn) => {
+    const thunk = () => fn();
+    thunk.__THUNK__ = THUNK_SYMBOL;
+    return thunk;
+  };
+  var trampoline = (fn) => {
+    const cont = (...args) => toThunk(() => fn(...args));
+    return Object.assign(
+      (...args) => {
+        let result = fn(...args);
+        while (isThunk(result) && typeof result === "function") {
+          result = result();
+        }
+        return result;
+      },
+      { cont }
+    );
+  };
+  var trampolineAsync = (fn) => {
+    const cont = (...args) => toThunk(() => fn(...args));
+    return Object.assign(
+      (...args) => __async(void 0, null, function* () {
+        let result = yield fn(...args);
+        while (isThunk(result) && typeof result === "function") {
+          result = yield result();
+        }
+        return result;
+      }),
+      { cont }
+    );
+  };
+  var getMSB = (value) => {
+    if (value <= 0) {
+      return 0;
+    }
+    return 1 << 31 - Math.clz32(value);
+  };
+  var rangeCheck = (index, min, max, message = "Index out of bounds.") => {
+    if (index < min || index > max)
+      throw new RangeError(message);
+  };
+  var throwRangeError = (message = "The value is off-limits.") => {
+    throw new RangeError(message);
+  };
+  var isObjOrFunc = (input) => {
+    const inputType = typeof input;
+    return inputType === "object" && input !== null || inputType === "function";
+  };
+
+  // src/types/data-structures/binary-tree/binary-tree.ts
+  var IterationType = /* @__PURE__ */ ((IterationType3) => {
+    IterationType3["ITERATIVE"] = "ITERATIVE";
+    IterationType3["RECURSIVE"] = "RECURSIVE";
+    return IterationType3;
+  })(IterationType || {});
+  var FamilyPosition = /* @__PURE__ */ ((FamilyPosition2) => {
+    FamilyPosition2["ROOT"] = "ROOT";
+    FamilyPosition2["LEFT"] = "LEFT";
+    FamilyPosition2["RIGHT"] = "RIGHT";
+    FamilyPosition2["ROOT_LEFT"] = "ROOT_LEFT";
+    FamilyPosition2["ROOT_RIGHT"] = "ROOT_RIGHT";
+    FamilyPosition2["ISOLATED"] = "ISOLATED";
+    FamilyPosition2["MAL_NODE"] = "MAL_NODE";
+    return FamilyPosition2;
+  })(FamilyPosition || {});
+
+  // src/types/data-structures/binary-tree/rb-tree.ts
+  var RBTNColor = /* @__PURE__ */ ((RBTNColor2) => {
+    RBTNColor2[RBTNColor2["RED"] = 1] = "RED";
+    RBTNColor2[RBTNColor2["BLACK"] = 0] = "BLACK";
+    return RBTNColor2;
+  })(RBTNColor || {});
+
+  // src/types/data-structures/hash/hash-map.ts
+  var IterateDirection = /* @__PURE__ */ ((IterateDirection2) => {
+    IterateDirection2[IterateDirection2["DEFAULT"] = 0] = "DEFAULT";
+    IterateDirection2[IterateDirection2["REVERSE"] = 1] = "REVERSE";
+    return IterateDirection2;
+  })(IterateDirection || {});
+
+  // src/types/helpers.ts
+  var CP = /* @__PURE__ */ ((CP2) => {
+    CP2["lt"] = "lt";
+    CP2["eq"] = "eq";
+    CP2["gt"] = "gt";
+    return CP2;
+  })(CP || {});
+
   // src/data-structures/hash/hash-map.ts
-  var HashMap = class {
+  var HashMapIterator = class {
+    /**
+     * This is a constructor function for a linked list iterator in a HashMap data structure.
+     * @param node - The `node` parameter is a reference to a `HashMapLinkedNode` object. This object
+     * represents a node in a linked list used in a hash map data structure. It contains a key-value pair
+     * and references to the previous and next nodes in the linked list.
+     * @param sentinel - The `sentinel` parameter is a reference to a special node in a linked list. It
+     * is used to mark the beginning or end of the list and is typically used in data structures like
+     * hash maps or linked lists to simplify operations and boundary checks.
+     * @param hashMap - A HashMap object that stores key-value pairs.
+     * @param {IterateDirection} iterateDirection - The `iterateDirection` parameter is an optional
+     * parameter that specifies the direction in which the iterator should iterate over the elements of
+     * the HashMap. It can take one of the following values:
+     * @returns The constructor does not return anything. It is used to initialize the properties and
+     * methods of the object being created.
+     */
+    constructor(node, sentinel, hashMap, iterateDirection = 0 /* DEFAULT */) {
+      __publicField(this, "hashMap");
+      __publicField(this, "_node");
+      __publicField(this, "iterateDirection");
+      __publicField(this, "_sentinel");
+      this._node = node;
+      this._sentinel = sentinel;
+      this.iterateDirection = iterateDirection;
+      if (this.iterateDirection === 0 /* DEFAULT */) {
+        this.prev = function() {
+          if (this._node.prev === this._sentinel) {
+            throwRangeError();
+          }
+          this._node = this._node.prev;
+          return this;
+        };
+        this.next = function() {
+          if (this._node === this._sentinel) {
+            throwRangeError();
+          }
+          this._node = this._node.next;
+          return this;
+        };
+      } else {
+        this.prev = function() {
+          if (this._node.next === this._sentinel) {
+            throwRangeError();
+          }
+          this._node = this._node.next;
+          return this;
+        };
+        this.next = function() {
+          if (this._node === this._sentinel) {
+            throwRangeError();
+          }
+          this._node = this._node.prev;
+          return this;
+        };
+      }
+      this.hashMap = hashMap;
+    }
     /**
-     * The constructor initializes the properties of a hash table, including the initial capacity, load factor, capacity
-     * multiplier, size, table array, and hash function.
-     * @param [initialCapacity=16] - The initial capacity is the initial size of the hash table. It determines the number of
-     * buckets or slots available for storing key-value pairs. The default value is 16.
-     * @param [loadFactor=0.75] - The load factor is a measure of how full the hash table can be before it is resized. It is
-     * a value between 0 and 1, where 1 means the hash table is completely full and 0 means it is completely empty. When the
-     * load factor is reached, the hash table will
-     * @param [hashFn] - The `hashFn` parameter is an optional parameter that represents the hash function used to calculate
-     * the index of a key in the hash table. If a custom hash function is not provided, a default hash function is used. The
-     * default hash function converts the key to a string, calculates the sum of the
-     */
-    constructor(initialCapacity = 16, loadFactor = 0.75, hashFn) {
-      __publicField(this, "_initialCapacity");
-      __publicField(this, "_loadFactor");
-      __publicField(this, "_capacityMultiplier");
-      __publicField(this, "_size");
-      __publicField(this, "_table");
-      __publicField(this, "_hashFn");
-      this._initialCapacity = initialCapacity;
-      this._loadFactor = loadFactor;
-      this._capacityMultiplier = 2;
-      this._size = 0;
-      this._table = new Array(initialCapacity);
-      this._hashFn = hashFn || ((key) => {
-        const strKey = String(key);
-        let hash = 0;
-        for (let i = 0; i < strKey.length; i++) {
-          hash += strKey.charCodeAt(i);
-        }
-        return hash % this.table.length;
+     * The above function returns a Proxy object that allows access to the key and value of a node in a
+     * data structure.
+     * @returns The code is returning a Proxy object.
+     */
+    get current() {
+      if (this._node === this._sentinel) {
+        throwRangeError();
+      }
+      return new Proxy([], {
+        get: (target, prop) => {
+          if (prop === "0")
+            return this._node.key;
+          else if (prop === "1")
+            return this._node.value;
+          target[0] = this._node.key;
+          target[1] = this._node.value;
+          return target[prop];
+        },
+        set: (_, prop, newValue) => {
+          if (prop !== "1") {
+            throw new TypeError(`prop should be string '1'`);
+          }
+          this._node.value = newValue;
+          return true;
+        }
       });
     }
-    get initialCapacity() {
-      return this._initialCapacity;
+    /**
+     * The function checks if a node is accessible.
+     * @returns a boolean value indicating whether the `_node` is not equal to the `_sentinel`.
+     */
+    isAccessible() {
+      return this._node !== this._sentinel;
     }
-    get loadFactor() {
-      return this._loadFactor;
+    prev() {
+      return this;
     }
-    get capacityMultiplier() {
-      return this._capacityMultiplier;
+    next() {
+      return this;
+    }
+  };
+  var HashMap = class {
+    /**
+     * The constructor initializes a HashMap object with an optional initial set of key-value pairs.
+     * @param hashMap - The `hashMap` parameter is an optional parameter of type `HashMapOptions<[K,
+     * V]>`. It is an array of key-value pairs, where each pair is represented as an array `[K, V]`. The
+     * `K` represents the type of the key and `V` represents the
+     */
+    constructor(hashMap = []) {
+      __publicField(this, "_nodes", []);
+      __publicField(this, "_orgMap", {});
+      __publicField(this, "_head");
+      __publicField(this, "_tail");
+      __publicField(this, "_sentinel");
+      __publicField(this, "OBJ_KEY_INDEX", Symbol("OBJ_KEY_INDEX"));
+      __publicField(this, "_size", 0);
+      Object.setPrototypeOf(this._orgMap, null);
+      this._sentinel = {};
+      this._sentinel.prev = this._sentinel.next = this._head = this._tail = this._sentinel;
+      hashMap.forEach((el) => {
+        this.set(el[0], el[1]);
+      });
     }
     get size() {
       return this._size;
     }
-    get table() {
-      return this._table;
-    }
-    get hashFn() {
-      return this._hashFn;
-    }
-    set(key, value) {
-      const loadFactor = this.size / this.table.length;
-      if (loadFactor >= this.loadFactor) {
-        this.resizeTable(this.table.length * this.capacityMultiplier);
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `set` function adds a new key-value pair to a data structure, either using an object key or a
+     * string key.
+     * @param {K} key - The `key` parameter is the key to be set in the data structure. It can be of any
+     * type, but typically it is a string or symbol.
+     * @param {V} [value] - The `value` parameter is an optional parameter of type `V`. It represents the
+     * value associated with the key being set in the data structure.
+     * @param {boolean} isObjectKey - A boolean flag indicating whether the key is an object key or not.
+     * @returns the size of the data structure after the key-value pair has been set.
+     */
+    set(key, value, isObjectKey = isObjOrFunc(key)) {
+      let newTail;
+      if (isObjectKey) {
+        const index = key[this.OBJ_KEY_INDEX];
+        if (index !== void 0) {
+          this._nodes[index].value = value;
+          return this._size;
+        }
+        Object.defineProperty(key, this.OBJ_KEY_INDEX, {
+          value: this._nodes.length,
+          configurable: true
+        });
+        newTail = {
+          key,
+          value,
+          prev: this._tail,
+          next: this._sentinel
+        };
+        this._nodes.push(newTail);
+      } else {
+        const node = this._orgMap[key];
+        if (node) {
+          node.value = value;
+          return this._size;
+        }
+        this._orgMap[key] = newTail = {
+          key,
+          value,
+          prev: this._tail,
+          next: this._sentinel
+        };
       }
-      const index = this._hash(key);
-      if (!this.table[index]) {
-        this.table[index] = [];
+      if (this._size === 0) {
+        this._head = newTail;
+        this._sentinel.next = newTail;
+      } else {
+        this._tail.next = newTail;
       }
-      for (let i = 0; i < this.table[index].length; i++) {
-        if (this.table[index][i][0] === key) {
-          this.table[index][i][1] = value;
-          return;
-        }
+      this._tail = newTail;
+      this._sentinel.prev = newTail;
+      return ++this._size;
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function `get` retrieves the value associated with a given key from a map, either by using the
+     * key directly or by using an index stored in the key object.
+     * @param {K} key - The `key` parameter is the key used to retrieve a value from the map. It can be
+     * of any type, but typically it is a string or symbol.
+     * @param {boolean} isObjectKey - The `isObjectKey` parameter is a boolean flag that indicates
+     * whether the `key` parameter is an object key or not. If `isObjectKey` is `true`, it means that
+     * `key` is an object key. If `isObjectKey` is `false`, it means that `key`
+     * @returns The value associated with the given key is being returned. If the key is an object key,
+     * the value is retrieved from the `_nodes` array using the index stored in the `OBJ_KEY_INDEX`
+     * property of the key. If the key is a string key, the value is retrieved from the `_orgMap` object
+     * using the key itself. If the key is not found, `undefined` is
+     */
+    get(key, isObjectKey = isObjOrFunc(key)) {
+      if (isObjectKey) {
+        const index = key[this.OBJ_KEY_INDEX];
+        return index !== void 0 ? this._nodes[index].value : void 0;
       }
-      this.table[index].push([key, value]);
-      this._size++;
+      const node = this._orgMap[key];
+      return node ? node.value : void 0;
     }
-    get(key) {
-      const index = this._hash(key);
-      if (!this.table[index]) {
-        return void 0;
+    /**
+     * Time Complexity: O(n), where n is the index.
+     * Space Complexity: O(1)
+     *
+     * The function `getAt` retrieves the key-value pair at a specified index in a linked list.
+     * @param {number} index - The index parameter is a number that represents the position of the
+     * element we want to retrieve from the data structure.
+     * @returns The method `getAt(index: number)` is returning an array containing the key-value pair at
+     * the specified index in the data structure. The key-value pair is represented as a tuple `[K, V]`,
+     * where `K` is the key and `V` is the value.
+     */
+    getAt(index) {
+      rangeCheck(index, 0, this._size - 1);
+      let node = this._head;
+      while (index--) {
+        node = node.next;
       }
-      for (const [k, v] of this.table[index]) {
-        if (k === key) {
-          return v;
+      return [node.key, node.value];
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function `getIterator` returns a new instance of `HashMapIterator` based on the provided key
+     * and whether it is an object key or not.
+     * @param {K} key - The `key` parameter is the key used to retrieve the iterator from the HashMap. It
+     * can be of any type, depending on how the HashMap is implemented.
+     * @param {boolean} [isObjectKey] - The `isObjectKey` parameter is an optional boolean parameter that
+     * indicates whether the `key` parameter is an object key. If `isObjectKey` is `true`, it means that
+     * the `key` parameter is an object and needs to be handled differently. If `isObjectKey` is `false`
+     * @returns a new instance of the `HashMapIterator` class.
+     */
+    getIterator(key, isObjectKey) {
+      let node;
+      if (isObjectKey) {
+        const index = key[this.OBJ_KEY_INDEX];
+        if (index === void 0) {
+          node = this._sentinel;
+        } else {
+          node = this._nodes[index];
         }
+      } else {
+        node = this._orgMap[key] || this._sentinel;
       }
-      return void 0;
+      return new HashMapIterator(node, this._sentinel, this);
     }
-    delete(key) {
-      const index = this._hash(key);
-      if (!this.table[index]) {
-        return;
-      }
-      for (let i = 0; i < this.table[index].length; i++) {
-        if (this.table[index][i][0] === key) {
-          this.table[index].splice(i, 1);
-          this._size--;
-          const loadFactor = this.size / this.table.length;
-          if (loadFactor < this.loadFactor / this.capacityMultiplier) {
-            this.resizeTable(this.table.length / this.capacityMultiplier);
-          }
-          return;
-        }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `delete` function removes a key-value pair from a map-like data structure.
+     * @param {K} key - The `key` parameter is the key that you want to delete from the data structure.
+     * It can be of any type, but typically it is a string or an object.
+     * @param {boolean} isObjectKey - The `isObjectKey` parameter is a boolean flag that indicates
+     * whether the `key` parameter is an object key or not. If `isObjectKey` is `true`, it means that the
+     * `key` parameter is an object key. If `isObjectKey` is `false`, it means that the
+     * @returns a boolean value. It returns `true` if the deletion was successful, and `false` if the key
+     * was not found.
+     */
+    delete(key, isObjectKey = isObjOrFunc(key)) {
+      let node;
+      if (isObjectKey) {
+        const index = key[this.OBJ_KEY_INDEX];
+        if (index === void 0)
+          return false;
+        delete key[this.OBJ_KEY_INDEX];
+        node = this._nodes[index];
+        delete this._nodes[index];
+      } else {
+        node = this._orgMap[key];
+        if (node === void 0)
+          return false;
+        delete this._orgMap[key];
       }
+      this._deleteNode(node);
+      return true;
     }
-    *entries() {
-      for (const bucket of this.table) {
-        if (bucket) {
-          for (const [key, value] of bucket) {
-            yield [key, value];
-          }
-        }
+    /**
+     * Time Complexity: O(n), where n is the index.
+     * Space Complexity: O(1)
+     *
+     * The `deleteAt` function deletes a node at a specified index in a linked list.
+     * @param {number} index - The index parameter represents the position at which the node should be
+     * deleted in the linked list.
+     * @returns The size of the list after deleting the element at the specified index.
+     */
+    deleteAt(index) {
+      rangeCheck(index, 0, this._size - 1);
+      let node = this._head;
+      while (index--) {
+        node = node.next;
       }
+      this._deleteNode(node);
+      return this._size;
     }
-    [Symbol.iterator]() {
-      return this.entries();
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function checks if a data structure is empty by comparing its size to zero.
+     * @returns The method is returning a boolean value indicating whether the size of the object is 0 or
+     * not.
+     */
+    isEmpty() {
+      return this._size === 0;
     }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `clear` function clears all the elements in a data structure and resets its properties.
+     */
     clear() {
+      this._nodes = [];
+      this._orgMap = {};
+      Object.setPrototypeOf(this._orgMap, null);
       this._size = 0;
-      this._table = new Array(this.initialCapacity);
+      this._head = this._tail = this._sentinel.prev = this._sentinel.next = this._sentinel;
     }
-    isEmpty() {
-      return this.size === 0;
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function returns a new iterator object for a HashMap.
+     * @returns A new instance of the HashMapIterator class is being returned.
+     */
+    get begin() {
+      return new HashMapIterator(this._head, this._sentinel, this);
     }
-    _hash(key) {
-      return this._hashFn(key);
-    }
-    /**
-     * The `resizeTable` function resizes the table used in a hash map by creating a new table with a specified capacity and
-     * rehashing the key-value pairs from the old table into the new table.
-     * @param {number} newCapacity - The newCapacity parameter is the desired capacity for the resized table. It represents
-     * the number of buckets that the new table should have.
-     */
-    resizeTable(newCapacity) {
-      const newTable = new Array(newCapacity);
-      for (const bucket of this._table) {
-        if (bucket) {
-          for (const [key, value] of bucket) {
-            const newIndex = this._hash(key) % newCapacity;
-            if (!newTable[newIndex]) {
-              newTable[newIndex] = [];
-            }
-            newTable[newIndex].push([key, value]);
-          }
-        }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function returns a new HashMapIterator object with the _sentinel value as both the start and
+     * end values.
+     * @returns A new instance of the HashMapIterator class is being returned.
+     */
+    get end() {
+      return new HashMapIterator(this._sentinel, this._sentinel, this);
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The reverseBegin function returns a new HashMapIterator object that iterates over the elements of
+     * a HashMap in reverse order.
+     * @returns A new instance of the HashMapIterator class is being returned.
+     */
+    get reverseBegin() {
+      return new HashMapIterator(this._tail, this._sentinel, this, 1 /* REVERSE */);
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The reverseEnd function returns a new HashMapIterator object that iterates over the elements of a
+     * HashMap in reverse order.
+     * @returns A new instance of the HashMapIterator class is being returned.
+     */
+    get reverseEnd() {
+      return new HashMapIterator(this._sentinel, this._sentinel, this, 1 /* REVERSE */);
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function returns the key-value pair at the front of a data structure.
+     * @returns The front element of the data structure, represented as a tuple with a key (K) and a
+     * value (V).
+     */
+    get front() {
+      if (this._size === 0)
+        return;
+      return [this._head.key, this._head.value];
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The function returns the key-value pair at the end of a data structure.
+     * @returns The method is returning an array containing the key-value pair of the tail element in the
+     * data structure.
+     */
+    get back() {
+      if (this._size === 0)
+        return;
+      return [this._tail.key, this._tail.value];
+    }
+    /**
+     * Time Complexity: O(n), where n is the number of elements in the HashMap.
+     * Space Complexity: O(1)
+     *
+     * The `forEach` function iterates over each element in a HashMap and executes a callback function on
+     * each element.
+     * @param callback - The callback parameter is a function that will be called for each element in the
+     * HashMap. It takes three arguments:
+     */
+    forEach(callback) {
+      let index = 0;
+      let node = this._head;
+      while (node !== this._sentinel) {
+        callback([node.key, node.value], index++, this);
+        node = node.next;
       }
-      this._table = newTable;
+    }
+    /**
+     * Time Complexity: O(n), where n is the number of elements in the HashMap.
+     * Space Complexity: O(1)
+     *
+     * The above function is an iterator that yields key-value pairs from a linked list.
+     */
+    *[Symbol.iterator]() {
+      let node = this._head;
+      while (node !== this._sentinel) {
+        yield [node.key, node.value];
+        node = node.next;
+      }
+    }
+    /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `_deleteNode` function removes a node from a doubly linked list and updates the head and tail
+     * pointers if necessary.
+     * @param node - The `node` parameter is an instance of the `HashMapLinkedNode` class, which
+     * represents a node in a linked list. It contains a key-value pair and references to the previous
+     * and next nodes in the list.
+     */
+    _deleteNode(node) {
+      const { prev, next } = node;
+      prev.next = next;
+      next.prev = prev;
+      if (node === this._head) {
+        this._head = next;
+      }
+      if (node === this._tail) {
+        this._tail = prev;
+      }
+      this._size -= 1;
     }
   };
 
@@ -3093,68 +3510,6 @@ var dataStructureTyped = (() => {
     }
   };
 
-  // src/utils/utils.ts
-  var uuidV4 = function() {
-    return "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".replace(/[x]/g, function(c) {
-      const r = Math.random() * 16 | 0, v = c == "x" ? r : r & 3 | 8;
-      return v.toString(16);
-    });
-  };
-  var arrayRemove = function(array, predicate) {
-    let i = -1, len = array ? array.length : 0;
-    const result = [];
-    while (++i < len) {
-      const value = array[i];
-      if (predicate(value, i, array)) {
-        result.push(value);
-        Array.prototype.splice.call(array, i--, 1);
-        len--;
-      }
-    }
-    return result;
-  };
-  var THUNK_SYMBOL = Symbol("thunk");
-  var isThunk = (fnOrValue) => {
-    return typeof fnOrValue === "function" && fnOrValue.__THUNK__ === THUNK_SYMBOL;
-  };
-  var toThunk = (fn) => {
-    const thunk = () => fn();
-    thunk.__THUNK__ = THUNK_SYMBOL;
-    return thunk;
-  };
-  var trampoline = (fn) => {
-    const cont = (...args) => toThunk(() => fn(...args));
-    return Object.assign(
-      (...args) => {
-        let result = fn(...args);
-        while (isThunk(result) && typeof result === "function") {
-          result = result();
-        }
-        return result;
-      },
-      { cont }
-    );
-  };
-  var trampolineAsync = (fn) => {
-    const cont = (...args) => toThunk(() => fn(...args));
-    return Object.assign(
-      (...args) => __async(void 0, null, function* () {
-        let result = yield fn(...args);
-        while (isThunk(result) && typeof result === "function") {
-          result = yield result();
-        }
-        return result;
-      }),
-      { cont }
-    );
-  };
-  var getMSB = (value) => {
-    if (value <= 0) {
-      return 0;
-    }
-    return 1 << 31 - Math.clz32(value);
-  };
-
   // src/data-structures/heap/heap.ts
   var Heap = class _Heap {
     constructor(options) {
@@ -5794,46 +6149,6 @@ var dataStructureTyped = (() => {
     }
   };
 
-  // src/types/data-structures/binary-tree/binary-tree.ts
-  var IterationType = /* @__PURE__ */ ((IterationType3) => {
-    IterationType3["ITERATIVE"] = "ITERATIVE";
-    IterationType3["RECURSIVE"] = "RECURSIVE";
-    return IterationType3;
-  })(IterationType || {});
-  var FamilyPosition = /* @__PURE__ */ ((FamilyPosition2) => {
-    FamilyPosition2["ROOT"] = "ROOT";
-    FamilyPosition2["LEFT"] = "LEFT";
-    FamilyPosition2["RIGHT"] = "RIGHT";
-    FamilyPosition2["ROOT_LEFT"] = "ROOT_LEFT";
-    FamilyPosition2["ROOT_RIGHT"] = "ROOT_RIGHT";
-    FamilyPosition2["ISOLATED"] = "ISOLATED";
-    FamilyPosition2["MAL_NODE"] = "MAL_NODE";
-    return FamilyPosition2;
-  })(FamilyPosition || {});
-
-  // src/types/data-structures/binary-tree/rb-tree.ts
-  var RBTNColor = /* @__PURE__ */ ((RBTNColor2) => {
-    RBTNColor2[RBTNColor2["RED"] = 1] = "RED";
-    RBTNColor2[RBTNColor2["BLACK"] = 0] = "BLACK";
-    return RBTNColor2;
-  })(RBTNColor || {});
-
-  // src/types/data-structures/graph/directed-graph.ts
-  var TopologicalProperty = /* @__PURE__ */ ((TopologicalProperty2) => {
-    TopologicalProperty2["VAL"] = "VAL";
-    TopologicalProperty2["NODE"] = "NODE";
-    TopologicalProperty2["ID"] = "ID";
-    return TopologicalProperty2;
-  })(TopologicalProperty || {});
-
-  // src/types/helpers.ts
-  var CP = /* @__PURE__ */ ((CP2) => {
-    CP2["lt"] = "lt";
-    CP2["eq"] = "eq";
-    CP2["gt"] = "gt";
-    return CP2;
-  })(CP || {});
-
   // src/data-structures/binary-tree/binary-tree.ts
   var BinaryTreeNode = class {
     /**