data-structure-typed 1.53.8 → 1.53.9

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

@@ -231,7 +231,7 @@ var dataStructureTyped = (() => {
     every(predicate, thisArg) {
       let index = 0;
       for (const item of this) {
-        if (!predicate.call(thisArg, item[1], item[0], index++, this)) {
+        if (!predicate.call(thisArg, item[0], item[1], index++, this)) {
           return false;
         }
       }
@@ -255,7 +255,7 @@ var dataStructureTyped = (() => {
     some(predicate, thisArg) {
       let index = 0;
       for (const item of this) {
-        if (predicate.call(thisArg, item[1], item[0], index++, this)) {
+        if (predicate.call(thisArg, item[0], item[1], index++, this)) {
           return true;
         }
       }
@@ -278,7 +278,7 @@ var dataStructureTyped = (() => {
       let index = 0;
       for (const item of this) {
         const [key, value] = item;
-        callbackfn.call(thisArg, value, key, index++, this);
+        callbackfn.call(thisArg, key, value, index++, this);
       }
     }
     /**
@@ -302,7 +302,7 @@ var dataStructureTyped = (() => {
       let index = 0;
       for (const item of this) {
         const [key, value] = item;
-        if (callbackfn.call(thisArg, value, key, index++, this)) return item;
+        if (callbackfn.call(thisArg, key, value, index++, this)) return item;
       }
       return;
     }
@@ -951,7 +951,7 @@ var dataStructureTyped = (() => {
       const resultMap = new _HashMap();
       let index = 0;
       for (const [key, value] of this) {
-        resultMap.set(key, callbackfn.call(thisArg, value, key, index++, this));
+        resultMap.set(key, callbackfn.call(thisArg, key, value, index++, this));
       }
       return resultMap;
     }
@@ -975,7 +975,7 @@ var dataStructureTyped = (() => {
       const filteredMap = new _HashMap();
       let index = 0;
       for (const [key, value] of this) {
-        if (predicate.call(thisArg, value, key, index++, this)) {
+        if (predicate.call(thisArg, key, value, index++, this)) {
           filteredMap.set(key, value);
         }
       }
@@ -1420,7 +1420,7 @@ var dataStructureTyped = (() => {
       const filteredMap = new _LinkedHashMap();
       let index = 0;
       for (const [key, value] of this) {
-        if (predicate.call(thisArg, value, key, index, this)) {
+        if (predicate.call(thisArg, key, value, index, this)) {
           filteredMap.set(key, value);
         }
         index++;
@@ -1448,8 +1448,8 @@ var dataStructureTyped = (() => {
       const mappedMap = new _LinkedHashMap();
       let index = 0;
       for (const [key, value] of this) {
-        const newValue = callback.call(thisArg, value, key, index, this);
-        mappedMap.set(key, newValue);
+        const [newKey, newValue] = callback.call(thisArg, key, value, index, this);
+        mappedMap.set(newKey, newValue);
         index++;
       }
       return mappedMap;
@@ -1585,6 +1585,22 @@ var dataStructureTyped = (() => {
     get size() {
       return this._size;
     }
+    /**
+     * Time Complexity: O(n)
+     * Space Complexity: O(n)
+     *
+     * The `fromArray` function creates a new SinglyLinkedList instance and populates it with the elements from the given
+     * array.
+     * @param {E[]} data - The `data` parameter is an array of elements of type `E`.
+     * @returns The `fromArray` function returns a `SinglyLinkedList` object.
+     */
+    static fromArray(data) {
+      const singlyLinkedList = new _SinglyLinkedList();
+      for (const item of data) {
+        singlyLinkedList.push(item);
+      }
+      return singlyLinkedList;
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -2170,22 +2186,6 @@ var dataStructureTyped = (() => {
         current = current.next;
       }
     }
-    /**
-     * Time Complexity: O(n)
-     * Space Complexity: O(n)
-     *
-     * The `fromArray` function creates a new SinglyLinkedList instance and populates it with the elements from the given
-     * array.
-     * @param {E[]} data - The `data` parameter is an array of elements of type `E`.
-     * @returns The `fromArray` function returns a `SinglyLinkedList` object.
-     */
-    static fromArray(data) {
-      const singlyLinkedList = new _SinglyLinkedList();
-      for (const item of data) {
-        singlyLinkedList.push(item);
-      }
-      return singlyLinkedList;
-    }
     /**
      * The _isPredicate function in TypeScript checks if the input is a function that takes a
      * SinglyLinkedListNode as an argument and returns a boolean.
@@ -2356,6 +2356,18 @@ var dataStructureTyped = (() => {
       var _a;
       return (_a = this.tail) == null ? void 0 : _a.value;
     }
+    /**
+     * Time Complexity: O(n)
+     * Space Complexity: O(n)
+     *
+     * The `fromArray` function creates a new instance of a DoublyLinkedList and populates it with the elements from the
+     * given array.
+     * @param {E[]} data - The `data` parameter is an array of elements of type `E`.
+     * @returns The `fromArray` function returns a DoublyLinkedList object.
+     */
+    static fromArray(data) {
+      return new _DoublyLinkedList(data);
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -2962,18 +2974,6 @@ var dataStructureTyped = (() => {
       }
       return count;
     }
-    /**
-     * Time Complexity: O(n)
-     * Space Complexity: O(n)
-     *
-     * The `fromArray` function creates a new instance of a DoublyLinkedList and populates it with the elements from the
-     * given array.
-     * @param {E[]} data - The `data` parameter is an array of elements of type `E`.
-     * @returns The `fromArray` function returns a DoublyLinkedList object.
-     */
-    static fromArray(data) {
-      return new _DoublyLinkedList(data);
-    }
     /**
      * The function returns an iterator that iterates over the values of a linked list.
      */
@@ -6192,7 +6192,7 @@ var dataStructureTyped = (() => {
       const filtered = [];
       let index = 0;
       for (const [key, value] of this) {
-        if (predicate.call(thisArg, value, key, index, this)) {
+        if (predicate.call(thisArg, key, value, index, this)) {
           filtered.push([key, value]);
         }
         index++;
@@ -6216,7 +6216,7 @@ var dataStructureTyped = (() => {
       const mapped = [];
       let index = 0;
       for (const [key, value] of this) {
-        mapped.push(callback.call(thisArg, value, key, index, this));
+        mapped.push(callback.call(thisArg, key, value, index, this));
         index++;
       }
       return mapped;
@@ -7471,6 +7471,9 @@ var dataStructureTyped = (() => {
       return this._toEntryFn;
     }
     /**
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
      * The function creates a new binary tree node with a specified key and optional value.
      * @param {K} key - The `key` parameter is the key of the node being created in the binary tree.
      * @param {V} [value] - The `value` parameter in the `createNode` function is optional, meaning it is
@@ -7483,12 +7486,18 @@ var dataStructureTyped = (() => {
       return new BinaryTreeNode(key, this._isMapMode ? void 0 : value);
     }
     /**
-     * The function creates a binary tree with the specified options.
-     * @param [options] - The `options` parameter in the `createTree` function is an optional parameter
-     * that allows you to provide partial configuration options for creating a binary tree. It is of type
-     * `Partial<BinaryTreeOptions<K, V, R>>`, which means you can pass in an object containing a subset
-     * of properties
-     * @returns A new instance of a binary tree with the specified options is being returned.
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `createTree` function creates a new binary tree based on the provided options.
+     * @param [options] - The `options` parameter in the `createTree` method is of type
+     * `BinaryTreeOptions<K, V, R>`. This type likely contains configuration options for creating a
+     * binary tree, such as the iteration type, whether the tree is in map mode, and functions for
+     * converting entries.
+     * @returns The `createTree` method is returning an instance of the `BinaryTree` class with the
+     * provided options. The method is creating a new `BinaryTree` object with an empty array as the
+     * initial data, and then setting various options such as `iterationType`, `isMapMode`, and
+     * `toEntryFn` based on the current object's properties and the provided `options`. Finally, it
      */
     createTree(options) {
       return new _BinaryTree([], __spreadValues({
@@ -7497,40 +7506,6 @@ var dataStructureTyped = (() => {
         toEntryFn: this._toEntryFn
       }, options));
     }
-    /**
-     * The function `keyValueNodeEntryRawToNodeAndValue` converts various input types into a node object
-     * or returns null.
-     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The
-     * `keyValueNodeEntryRawToNodeAndValue` function takes in a parameter `keyNodeEntryOrRaw`, which
-     * can be of type `BTNRep<K, V, NODE>` or `R`. This parameter represents either a key, a
-     * node, an entry
-     * @param {V} [value] - The `value` parameter in the `keyValueNodeEntryRawToNodeAndValue` function is
-     * an optional parameter of type `V`. It represents the value associated with the key in the node
-     * being created. If a `value` is provided, it will be used when creating the node. If
-     * @returns The `keyValueNodeEntryRawToNodeAndValue` function returns an optional node
-     * (`OptNodeOrNull<NODE>`) based on the input parameters provided. The function checks the type of the
-     * input parameter (`keyNodeEntryOrRaw`) and processes it accordingly to return a node or null
-     * value.
-     */
-    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value) {
-      if (keyNodeEntryOrRaw === void 0) return [void 0, void 0];
-      if (keyNodeEntryOrRaw === null) return [null, void 0];
-      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
-      if (this.isEntry(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = keyNodeEntryOrRaw;
-        if (key === void 0) return [void 0, void 0];
-        else if (key === null) return [null, void 0];
-        const finalValue = value != null ? value : entryValue;
-        return [this.createNode(key, finalValue), finalValue];
-      }
-      if (this.isRaw(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
-        const finalValue = value != null ? value : entryValue;
-        if (this.isKey(key)) return [this.createNode(key, finalValue), finalValue];
-      }
-      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value), value];
-      return [void 0, void 0];
-    }
     /**
      * Time Complexity: O(n)
      * Space Complexity: O(log n)
@@ -8733,7 +8708,7 @@ var dataStructureTyped = (() => {
       const newTree = this.createTree();
       let index = 0;
       for (const [key, value] of this) {
-        if (predicate.call(thisArg, value, key, index++, this)) {
+        if (predicate.call(thisArg, key, value, index++, this)) {
           newTree.add([key, value]);
         }
       }
@@ -8743,34 +8718,29 @@ var dataStructureTyped = (() => {
      * Time Complexity: O(n)
      * Space Complexity: O(n)
      *
-     * The `map` function iterates over key-value pairs in a tree data structure, applies a callback
-     * function to each value, and returns a new tree with the updated values.
-     * @param callback - The `callback` parameter in the `map` method is a function that will be called
-     * on each entry in the tree. It takes four arguments:
-     * @param {any} [thisArg] - The `thisArg` parameter in the `map` function is an optional parameter
-     * that specifies the value to be passed as `this` when executing the callback function. If provided,
-     * the `thisArg` value will be used as the `this` value within the callback function. If `thisArg
-     * @returns The `map` method is returning a new tree with the entries modified by the provided
-     * callback function. Each entry in the original tree is passed to the callback function, and the
-     * result of the callback function is added to the new tree.
-     */
-    map(callback, thisArg) {
-      const newTree = this.createTree();
+     * The `map` function in TypeScript creates a new BinaryTree by applying a callback function to each
+     * entry in the original BinaryTree.
+     * @param callback - A function that will be called for each entry in the current binary tree. It
+     * takes the key, value (which can be undefined), and an array containing the mapped key and value as
+     * arguments.
+     * @param [options] - The `options` parameter in the `map` method is of type `BinaryTreeOptions<MK,
+     * MV, MR>`. It is an optional parameter that allows you to specify additional options for the binary
+     * tree being created during the mapping process. These options could include things like custom
+     * comparators, initial
+     * @param {any} [thisArg] - The `thisArg` parameter in the `map` method is used to specify the value
+     * of `this` when executing the `callback` function. It allows you to set the context (value of
+     * `this`) within the callback function. If `thisArg` is provided, it will be passed
+     * @returns The `map` function is returning a new `BinaryTree` instance filled with entries that are
+     * the result of applying the provided `callback` function to each entry in the original tree.
+     */
+    map(callback, options, thisArg) {
+      const newTree = new _BinaryTree([], options);
       let index = 0;
       for (const [key, value] of this) {
-        newTree.add([key, callback.call(thisArg, value, key, index++, this)]);
+        newTree.add(callback.call(thisArg, key, value, index++, this));
       }
       return newTree;
     }
-    // // TODO Type error, need to return a TREE<NV> that is a value type only for callback function.
-    // // map<NV>(callback: (entry: [K, V | undefined], tree: this) => NV) {
-    // //   const newTree = this.createTree();
-    // //   for (const [key, value] of this) {
-    // //     newTree.add(key, callback([key, value], this));
-    // //   }
-    // //   return newTree;
-    // // }
-    //
     /**
      * Time Complexity: O(n)
      * Space Complexity: O(n)
@@ -8801,7 +8771,7 @@ var dataStructureTyped = (() => {
       if (opts.isShowRedBlackNIL) output += `S for Sentinel Node(NIL)
 `;
       const display = (root) => {
-        const [lines, , ,] = this._displayAux(root, opts);
+        const [lines, ,] = this._displayAux(root, opts);
         let paragraph = "";
         for (const line of lines) {
           paragraph += line + "\n";
@@ -8829,6 +8799,40 @@ var dataStructureTyped = (() => {
     print(options, startNode = this._root) {
       console.log(this.toVisual(startNode, options));
     }
+    /**
+     * The function `keyValueNodeEntryRawToNodeAndValue` converts various input types into a node object
+     * or returns null.
+     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The
+     * `keyValueNodeEntryRawToNodeAndValue` function takes in a parameter `keyNodeEntryOrRaw`, which
+     * can be of type `BTNRep<K, V, NODE>` or `R`. This parameter represents either a key, a
+     * node, an entry
+     * @param {V} [value] - The `value` parameter in the `keyValueNodeEntryRawToNodeAndValue` function is
+     * an optional parameter of type `V`. It represents the value associated with the key in the node
+     * being created. If a `value` is provided, it will be used when creating the node. If
+     * @returns The `keyValueNodeEntryRawToNodeAndValue` function returns an optional node
+     * (`OptNodeOrNull<NODE>`) based on the input parameters provided. The function checks the type of the
+     * input parameter (`keyNodeEntryOrRaw`) and processes it accordingly to return a node or null
+     * value.
+     */
+    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value) {
+      if (keyNodeEntryOrRaw === void 0) return [void 0, void 0];
+      if (keyNodeEntryOrRaw === null) return [null, void 0];
+      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
+      if (this.isEntry(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = keyNodeEntryOrRaw;
+        if (key === void 0) return [void 0, void 0];
+        else if (key === null) return [null, void 0];
+        const finalValue = value != null ? value : entryValue;
+        return [this.createNode(key, finalValue), finalValue];
+      }
+      if (this.isRaw(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
+        const finalValue = value != null ? value : entryValue;
+        if (this.isKey(key)) return [this.createNode(key, finalValue), finalValue];
+      }
+      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value), value];
+      return [void 0, void 0];
+    }
     /**
      * Time complexity: O(n)
      * Space complexity: O(n)
@@ -9301,22 +9305,22 @@ var dataStructureTyped = (() => {
           if (a < b) return -1;
           return 0;
         }
-        if (this._extractComparable) {
-          if (this._extractComparable(a) > this._extractComparable(b)) return 1;
-          if (this._extractComparable(a) < this._extractComparable(b)) return -1;
+        if (this._specifyComparable) {
+          if (this._specifyComparable(a) > this._specifyComparable(b)) return 1;
+          if (this._specifyComparable(a) < this._specifyComparable(b)) return -1;
           return 0;
         }
         if (typeof a === "object" || typeof b === "object") {
           throw TypeError(
-            `When comparing object types, a custom extractComparable must be defined in the constructor's options parameter.`
+            `When comparing object types, a custom specifyComparable must be defined in the constructor's options parameter.`
           );
         }
         return 0;
       });
-      __publicField(this, "_extractComparable");
+      __publicField(this, "_specifyComparable");
       if (options) {
-        const { extractComparable, isReverse } = options;
-        if (typeof extractComparable === "function") this._extractComparable = extractComparable;
+        const { specifyComparable, isReverse } = options;
+        if (typeof specifyComparable === "function") this._specifyComparable = specifyComparable;
         if (isReverse !== void 0) this._isReverse = isReverse;
       }
       if (keysNodesEntriesOrRaws) this.addMany(keysNodesEntriesOrRaws);
@@ -9336,6 +9340,21 @@ var dataStructureTyped = (() => {
     get isReverse() {
       return this._isReverse;
     }
+    /**
+     * The function returns the value of the _comparator property.
+     * @returns The `_comparator` property is being returned.
+     */
+    get comparator() {
+      return this._comparator;
+    }
+    /**
+     * This function returns the value of the `_specifyComparable` property.
+     * @returns The method `specifyComparable()` is being returned, which is a getter method for the
+     * `_specifyComparable` property.
+     */
+    get specifyComparable() {
+      return this._specifyComparable;
+    }
     /**
      * The function creates a new BSTNode with the given key and value and returns it.
      * @param {K} key - The key parameter is of type K, which represents the type of the key for the node
@@ -9348,35 +9367,26 @@ var dataStructureTyped = (() => {
       return new BSTNode(key, this._isMapMode ? void 0 : value);
     }
     /**
-     * The function creates a new binary search tree with the specified options.
-     * @param [options] - The `options` parameter is an optional object that allows you to customize the
-     * behavior of the `createTree` method. It accepts a partial `BSTOptions` object, which has the
-     * following properties:
-     * @returns a new instance of the BST class with the provided options.
+     * Time Complexity: O(1)
+     * Space Complexity: O(1)
+     *
+     * The `createTree` function in TypeScript overrides the default options with the provided options to
+     * create a new Binary Search Tree.
+     * @param [options] - The `options` parameter in the `createTree` method is an optional object that
+     * can contain the following properties:
+     * @returns A new instance of a Binary Search Tree (BST) is being returned with the specified options
+     * and properties inherited from the current instance.
      */
+    // @ts-ignore
     createTree(options) {
       return new _BST([], __spreadValues({
         iterationType: this.iterationType,
         isMapMode: this._isMapMode,
-        extractComparable: this._extractComparable,
+        specifyComparable: this._specifyComparable,
         toEntryFn: this._toEntryFn,
         isReverse: this._isReverse
       }, options));
     }
-    /**
-     * The function overrides a method and converts a key, value pair or entry or raw element to a node.
-     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - A variable that can be of
-     * type R or BTNRep<K, V, NODE>. It represents either a key, a node, an entry, or a raw
-     * element.
-     * @param {V} [value] - The `value` parameter is an optional value of type `V`. It represents the
-     * value associated with a key in a key-value pair.
-     * @returns either a NODE object or undefined.
-     */
-    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value) {
-      const [node, entryValue] = super._keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value);
-      if (node === null) return [void 0, void 0];
-      return [node, value != null ? value : entryValue];
-    }
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(log n)
@@ -9415,7 +9425,7 @@ var dataStructureTyped = (() => {
      * this._DEFAULT_COMPARATOR`.
      */
     isKey(key) {
-      return isComparable(key, this._extractComparable !== void 0);
+      return isComparable(key, this._specifyComparable !== void 0);
     }
     /**
      * Time Complexity: O(log n)
@@ -9934,20 +9944,28 @@ var dataStructureTyped = (() => {
       }
       return balanced;
     }
-    /**
-     * The function returns the value of the _comparator property.
-     * @returns The `_comparator` property is being returned.
-     */
-    get comparator() {
-      return this._comparator;
+    // @ts-ignore
+    map(callback, options, thisArg) {
+      const newTree = new _BST([], options);
+      let index = 0;
+      for (const [key, value] of this) {
+        newTree.add(callback.call(thisArg, key, value, index++, this));
+      }
+      return newTree;
     }
     /**
-     * This function returns the value of the `_extractComparable` property.
-     * @returns The method `extractComparable()` is being returned, which is a getter method for the
-     * `_extractComparable` property.
+     * The function overrides a method and converts a key, value pair or entry or raw element to a node.
+     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - A variable that can be of
+     * type R or BTNRep<K, V, NODE>. It represents either a key, a node, an entry, or a raw
+     * element.
+     * @param {V} [value] - The `value` parameter is an optional value of type `V`. It represents the
+     * value associated with a key in a key-value pair.
+     * @returns either a NODE object or undefined.
      */
-    get extractComparable() {
-      return this._extractComparable;
+    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value) {
+      const [node, entryValue] = super._keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value);
+      if (node === null) return [void 0, void 0];
+      return [node, value != null ? value : entryValue];
     }
     /**
      * The function sets the root of a tree-like structure and updates the parent property of the new
@@ -10588,17 +10606,21 @@ var dataStructureTyped = (() => {
       return new AVLTreeNode(key, this._isMapMode ? void 0 : value);
     }
     /**
-     * The function creates a new AVL tree with the specified options and returns it.
-     * @param {AVLTreeOptions} [options] - The `options` parameter is an optional object that can be
-     * passed to the `createTree` function. It is used to customize the behavior of the AVL tree that is
-     * being created.
-     * @returns a new AVLTree object.
-     */
+     * The function `createTree` in TypeScript overrides the default AVLTree creation with the provided
+     * options.
+     * @param [options] - The `options` parameter in the `createTree` function is an object that contains
+     * configuration options for creating an AVL tree. These options can include properties such as
+     * `iterationType`, `isMapMode`, `specifyComparable`, `toEntryFn`, and `isReverse`. The function
+     * creates a
+     * @returns An AVLTree object is being returned with the specified options and properties inherited
+     * from the current object.
+     */
+    // @ts-ignore
     createTree(options) {
       return new _AVLTree([], __spreadValues({
         iterationType: this.iterationType,
         isMapMode: this._isMapMode,
-        extractComparable: this._extractComparable,
+        specifyComparable: this._specifyComparable,
         toEntryFn: this._toEntryFn,
         isReverse: this._isReverse
       }, options));
@@ -10654,6 +10676,15 @@ var dataStructureTyped = (() => {
       }
       return deletedResults;
     }
+    // @ts-ignore
+    map(callback, options, thisArg) {
+      const newTree = new _AVLTree([], options);
+      let index = 0;
+      for (const [key, value] of this) {
+        newTree.add(callback.call(thisArg, key, value, index++, this));
+      }
+      return newTree;
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -10970,9 +11001,9 @@ var dataStructureTyped = (() => {
      * This is the constructor function for a Red-Black Tree data structure in TypeScript.
      * @param keysNodesEntriesOrRaws - The `keysNodesEntriesOrRaws` parameter is an
      * iterable object that can contain either keys, nodes, entries, or raw elements. It is used to
-     * initialize the RBTree with the provided elements.
+     * initialize the RedBlackTree with the provided elements.
      * @param [options] - The `options` parameter is an optional object that can be passed to the
-     * constructor. It is of type `RBTreeOptions<K, V, R>`. This object can contain various options for
+     * constructor. It is of type `RedBlackTreeOptions<K, V, R>`. This object can contain various options for
      * configuring the behavior of the Red-Black Tree. The specific properties and their meanings would
      * depend on the implementation
      */
@@ -11009,16 +11040,20 @@ var dataStructureTyped = (() => {
       return new RedBlackTreeNode(key, this._isMapMode ? void 0 : value, color);
     }
     /**
-     * The function creates a new Red-Black Tree with the specified options.
-     * @param [options] - The `options` parameter is an optional object that contains additional
-     * configuration options for creating the Red-Black Tree. It has the following properties:
-     * @returns a new instance of a RedBlackTree object.
+     * The function `createTree` overrides the default implementation to create a Red-Black Tree with
+     * specified options in TypeScript.
+     * @param [options] - The `options` parameter in the `createTree` method is of type `RedBlackTreeOptions<K,
+     * V, R>`, which is a generic type with three type parameters `K`, `V`, and `R`. This parameter
+     * allows you to pass additional configuration options when creating a new Red-
+     * @returns A new instance of a RedBlackTree with the specified options and properties from the
+     * current object is being returned.
      */
+    // @ts-ignore
     createTree(options) {
       return new _RedBlackTree([], __spreadValues({
         iterationType: this.iterationType,
         isMapMode: this._isMapMode,
-        extractComparable: this._extractComparable,
+        specifyComparable: this._specifyComparable,
         toEntryFn: this._toEntryFn
       }, options));
     }
@@ -11035,41 +11070,6 @@ var dataStructureTyped = (() => {
     isNode(keyNodeEntryOrRaw) {
       return keyNodeEntryOrRaw instanceof RedBlackTreeNode;
     }
-    // /**
-    //  * Time Complexity: O(1)
-    //  * Space Complexity: O(1)
-    //  */
-    //
-    // /**
-    //  * Time Complexity: O(1)
-    //  * Space Complexity: O(1)
-    //  *
-    //  * The function `keyValueNodeEntryRawToNodeAndValue` takes a key, value, or entry and returns a node if it is
-    //  * valid, otherwise it returns undefined.
-    //  * @param {BTNRep<K, V, NODE>} keyNodeEntryOrRaw - The key, value, or entry to convert.
-    //  * @param {V} [value] - The value associated with the key (if `keyNodeEntryOrRaw` is a key).
-    //  * @returns {NODE | undefined} - The corresponding Red-Black Tree node, or `undefined` if conversion fails.
-    //  */
-    // override keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw: BTNRep<K, V, NODE> | R, value?: V): NODE | undefined {
-    //
-    //   if (keyNodeEntryOrRaw === null || keyNodeEntryOrRaw === undefined) return;
-    //   if (this.isNode(keyNodeEntryOrRaw)) return keyNodeEntryOrRaw;
-    //
-    //   if (this._toEntryFn) {
-    //     const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw as R);
-    //     if (this.isKey(key)) return this.createNode(key, value ?? entryValue, 'RED');
-    //   }
-    //
-    //   if (this.isEntry(keyNodeEntryOrRaw)) {
-    //     const [key, value] = keyNodeEntryOrRaw;
-    //     if (key === undefined || key === null) return;
-    //     else return  this.createNode(key, value, 'RED');
-    //   }
-    //
-    //   if (this.isKey(keyNodeEntryOrRaw)) return this.createNode(keyNodeEntryOrRaw, value, 'RED');
-    //
-    //   return ;
-    // }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -11179,6 +11179,35 @@ var dataStructureTyped = (() => {
       results.push({ deleted: nodeToDelete, needBalanced: void 0 });
       return results;
     }
+    /**
+     * Time Complexity: O(n)
+     * Space Complexity: O(n)
+     *
+     * The `map` function in TypeScript overrides the default behavior to create a new Red-Black Tree by
+     * applying a callback to each entry in the original tree.
+     * @param callback - A function that will be called for each entry in the tree, with parameters
+     * representing the key, value, index, and the tree itself. It should return an entry for the new
+     * tree.
+     * @param [options] - The `options` parameter in the `map` method is of type `RedBlackTreeOptions<MK, MV,
+     * MR>`. This parameter allows you to specify additional options or configurations for the Red-Black
+     * Tree that will be created during the mapping process. These options could include things like
+     * custom comparators
+     * @param {any} [thisArg] - The `thisArg` parameter in the `override map` function is used to specify
+     * the value of `this` when executing the `callback` function. It allows you to set the context
+     * (value of `this`) for the callback function. This can be useful when you want to access properties
+     * or
+     * @returns A new Red-Black Tree is being returned, where each entry has been transformed using the
+     * provided callback function.
+     */
+    // @ts-ignore
+    map(callback, options, thisArg) {
+      const newTree = new _RedBlackTree([], options);
+      let index = 0;
+      for (const [key, value] of this) {
+        newTree.add(callback.call(thisArg, key, value, index++, this));
+      }
+      return newTree;
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -11240,7 +11269,7 @@ var dataStructureTyped = (() => {
       node.parent = parent;
       if (!parent) {
         this._setRoot(node);
-      } else if (node.key < parent.key) {
+      } else if (this._compare(node.key, parent.key) < 0) {
         parent.left = node;
       } else {
         parent.right = node;
@@ -11538,11 +11567,12 @@ var dataStructureTyped = (() => {
      * @returns a new instance of the AVLTreeMultiMap class, with the specified options, as a TREE
      * object.
      */
+    // @ts-ignore
     createTree(options) {
       return new _AVLTreeMultiMap([], __spreadValues({
         iterationType: this.iterationType,
         isMapMode: this._isMapMode,
-        extractComparable: this._extractComparable,
+        specifyComparable: this._specifyComparable,
         toEntryFn: this._toEntryFn,
         isReverse: this._isReverse
       }, options));
@@ -11557,35 +11587,6 @@ var dataStructureTyped = (() => {
     isNode(keyNodeEntryOrRaw) {
       return keyNodeEntryOrRaw instanceof AVLTreeMultiMapNode;
     }
-    /**
-     * The function `keyValueNodeEntryRawToNodeAndValue` converts a key, value, entry, or raw element into
-     * a node object.
-     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The
-     * `keyNodeEntryOrRaw` parameter can be of type `R` or `BTNRep<K, V, NODE>`.
-     * @param {V} [value] - The `value` parameter is an optional value that can be passed to the
-     * `override` function. It represents the value associated with the key in the data structure. If no
-     * value is provided, it will default to `undefined`.
-     * @param [count=1] - The `count` parameter is an optional parameter that specifies the number of
-     * times the key-value pair should be added to the data structure. If not provided, it defaults to 1.
-     * @returns either a NODE object or undefined.
-     */
-    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value, count = 1) {
-      if (keyNodeEntryOrRaw === void 0 || keyNodeEntryOrRaw === null) return [void 0, void 0];
-      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
-      if (this.isEntry(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = keyNodeEntryOrRaw;
-        if (key === void 0 || key === null) return [void 0, void 0];
-        const finalValue = value != null ? value : entryValue;
-        return [this.createNode(key, finalValue, count), finalValue];
-      }
-      if (this.isRaw(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
-        const finalValue = value != null ? value : entryValue;
-        if (this.isKey(key)) return [this.createNode(key, finalValue, count), finalValue];
-      }
-      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value, count), value];
-      return [void 0, void 0];
-    }
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
@@ -11745,6 +11746,7 @@ var dataStructureTyped = (() => {
      * The function overrides the clone method to create a deep copy of a tree object.
      * @returns The `clone()` method is returning a cloned instance of the `TREE` object.
      */
+    // @ts-ignore
     clone() {
       const cloned = this.createTree();
       if (this._isMapMode) this.bfs((node) => cloned.add(node.key, void 0, node.count));
@@ -11752,6 +11754,62 @@ var dataStructureTyped = (() => {
       if (this._isMapMode) cloned._store = this._store;
       return cloned;
     }
+    /**
+     * The `map` function in TypeScript overrides the default behavior to create a new AVLTreeMultiMap
+     * with modified entries based on a provided callback.
+     * @param callback - The `callback` parameter is a function that will be called for each entry in the
+     * AVLTreeMultiMap. It takes four arguments:
+     * @param [options] - The `options` parameter in the `override map` function is of type
+     * `AVLTreeMultiMapOptions<MK, MV, MR>`. This parameter allows you to provide additional
+     * configuration options when creating a new `AVLTreeMultiMap` instance within the `map` function.
+     * These options
+     * @param {any} [thisArg] - The `thisArg` parameter in the `override map` function is used to specify
+     * the value of `this` when executing the `callback` function. It allows you to set the context
+     * (value of `this`) for the callback function. This can be useful when you want to access properties
+     * or
+     * @returns The `map` method is returning a new `AVLTreeMultiMap` instance with the entries
+     * transformed by the provided `callback` function. Each entry in the original tree is passed to the
+     * `callback` function along with the index and the original tree itself. The transformed entries are
+     * then added to the new `AVLTreeMultiMap` instance, which is returned at the end.
+     */
+    // @ts-ignore
+    map(callback, options, thisArg) {
+      const newTree = new _AVLTreeMultiMap([], options);
+      let index = 0;
+      for (const [key, value] of this) {
+        newTree.add(callback.call(thisArg, key, value, index++, this));
+      }
+      return newTree;
+    }
+    /**
+     * The function `keyValueNodeEntryRawToNodeAndValue` converts a key, value, entry, or raw element into
+     * a node object.
+     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The
+     * `keyNodeEntryOrRaw` parameter can be of type `R` or `BTNRep<K, V, NODE>`.
+     * @param {V} [value] - The `value` parameter is an optional value that can be passed to the
+     * `override` function. It represents the value associated with the key in the data structure. If no
+     * value is provided, it will default to `undefined`.
+     * @param [count=1] - The `count` parameter is an optional parameter that specifies the number of
+     * times the key-value pair should be added to the data structure. If not provided, it defaults to 1.
+     * @returns either a NODE object or undefined.
+     */
+    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value, count = 1) {
+      if (keyNodeEntryOrRaw === void 0 || keyNodeEntryOrRaw === null) return [void 0, void 0];
+      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
+      if (this.isEntry(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = keyNodeEntryOrRaw;
+        if (key === void 0 || key === null) return [void 0, void 0];
+        const finalValue = value != null ? value : entryValue;
+        return [this.createNode(key, finalValue, count), finalValue];
+      }
+      if (this.isRaw(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
+        const finalValue = value != null ? value : entryValue;
+        if (this.isKey(key)) return [this.createNode(key, finalValue, count), finalValue];
+      }
+      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value, count), value];
+      return [void 0, void 0];
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -11898,43 +11956,15 @@ var dataStructureTyped = (() => {
      * @returns a new instance of the `TreeMultiMap` class, with the provided options merged with the
      * existing `iterationType` property. The returned value is casted as `TREE`.
      */
+    // @ts-ignore
     createTree(options) {
       return new _TreeMultiMap([], __spreadValues({
         iterationType: this.iterationType,
         isMapMode: this._isMapMode,
-        extractComparable: this._extractComparable,
+        specifyComparable: this._specifyComparable,
         toEntryFn: this._toEntryFn
       }, options));
     }
-    /**
-     * The function `keyValueNodeEntryRawToNodeAndValue` takes in a key, value, and count and returns a
-     * node based on the input.
-     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The parameter
-     * `keyNodeEntryOrRaw` can be of type `R` or `BTNRep<K, V, NODE>`.
-     * @param {V} [value] - The `value` parameter is an optional value that represents the value
-     * associated with the key in the node. It is used when creating a new node or updating the value of
-     * an existing node.
-     * @param [count=1] - The `count` parameter is an optional parameter that specifies the number of
-     * times the key-value pair should be added to the data structure. If not provided, it defaults to 1.
-     * @returns either a NODE object or undefined.
-     */
-    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value, count = 1) {
-      if (keyNodeEntryOrRaw === void 0 || keyNodeEntryOrRaw === null) return [void 0, void 0];
-      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
-      if (this.isEntry(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = keyNodeEntryOrRaw;
-        if (key === void 0 || key === null) return [void 0, void 0];
-        const finalValue = value != null ? value : entryValue;
-        if (this.isKey(key)) return [this.createNode(key, finalValue, "BLACK", count), finalValue];
-      }
-      if (this.isRaw(keyNodeEntryOrRaw)) {
-        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
-        const finalValue = value != null ? value : entryValue;
-        if (this.isKey(key)) return [this.createNode(key, finalValue, "BLACK", count), finalValue];
-      }
-      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value, "BLACK", count), value];
-      return [void 0, void 0];
-    }
     /**
      * The function checks if the input is an instance of the TreeMultiMapNode class.
      * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The parameter
@@ -12133,12 +12163,66 @@ var dataStructureTyped = (() => {
      * The function overrides the clone method to create a deep copy of a tree object.
      * @returns The `clone()` method is returning a cloned instance of the `TREE` object.
      */
+    // @ts-ignore
     clone() {
       const cloned = this.createTree();
       this.bfs((node) => cloned.add(node.key, void 0, node.count));
       if (this._isMapMode) cloned._store = this._store;
       return cloned;
     }
+    /**
+     * The `map` function in TypeScript overrides the default behavior to create a new TreeMultiMap with
+     * modified entries based on a provided callback.
+     * @param callback - The `callback` parameter is a function that will be called for each entry in the
+     * map. It takes four arguments:
+     * @param [options] - The `options` parameter in the `override map` function is of type
+     * `TreeMultiMapOptions<MK, MV, MR>`. This parameter allows you to provide additional configuration
+     * options when creating a new `TreeMultiMap` instance within the `map` function. These options could
+     * include things like
+     * @param {any} [thisArg] - The `thisArg` parameter in the `override map` function is used to specify
+     * the value of `this` when executing the `callback` function. It allows you to set the context
+     * (value of `this`) for the callback function when it is called within the `map` function. This
+     * @returns A new TreeMultiMap instance is being returned, which is populated with entries generated
+     * by the provided callback function.
+     */
+    // @ts-ignore
+    map(callback, options, thisArg) {
+      const newTree = new _TreeMultiMap([], options);
+      let index = 0;
+      for (const [key, value] of this) {
+        newTree.add(callback.call(thisArg, key, value, index++, this));
+      }
+      return newTree;
+    }
+    /**
+     * The function `keyValueNodeEntryRawToNodeAndValue` takes in a key, value, and count and returns a
+     * node based on the input.
+     * @param {BTNRep<K, V, NODE> | R} keyNodeEntryOrRaw - The parameter
+     * `keyNodeEntryOrRaw` can be of type `R` or `BTNRep<K, V, NODE>`.
+     * @param {V} [value] - The `value` parameter is an optional value that represents the value
+     * associated with the key in the node. It is used when creating a new node or updating the value of
+     * an existing node.
+     * @param [count=1] - The `count` parameter is an optional parameter that specifies the number of
+     * times the key-value pair should be added to the data structure. If not provided, it defaults to 1.
+     * @returns either a NODE object or undefined.
+     */
+    _keyValueNodeEntryRawToNodeAndValue(keyNodeEntryOrRaw, value, count = 1) {
+      if (keyNodeEntryOrRaw === void 0 || keyNodeEntryOrRaw === null) return [void 0, void 0];
+      if (this.isNode(keyNodeEntryOrRaw)) return [keyNodeEntryOrRaw, value];
+      if (this.isEntry(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = keyNodeEntryOrRaw;
+        if (key === void 0 || key === null) return [void 0, void 0];
+        const finalValue = value != null ? value : entryValue;
+        if (this.isKey(key)) return [this.createNode(key, finalValue, "BLACK", count), finalValue];
+      }
+      if (this.isRaw(keyNodeEntryOrRaw)) {
+        const [key, entryValue] = this._toEntryFn(keyNodeEntryOrRaw);
+        const finalValue = value != null ? value : entryValue;
+        if (this.isKey(key)) return [this.createNode(key, finalValue, "BLACK", count), finalValue];
+      }
+      if (this.isKey(keyNodeEntryOrRaw)) return [this.createNode(keyNodeEntryOrRaw, value, "BLACK", count), value];
+      return [void 0, void 0];
+    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)