data-structure-typed 1.47.7 → 1.47.8

package/dist/mjs/data-structures/linked-list/singly-linked-list.d.ts

@@ -7,9 +7,9 @@
  */
 export declare class SinglyLinkedListNode<E = any> {
     value: E;
-    next: SinglyLinkedListNode<E> | null;
+    next: SinglyLinkedListNode<E> | undefined;
     /**
-     * The constructor function initializes an instance of a class with a given value and sets the next property to null.
+     * The constructor function initializes an instance of a class with a given value and sets the next property to undefined.
      * @param {E} value - The "value" parameter is of type E, which means it can be any data type. It represents the value that
      * will be stored in the node of a linked list.
      */
@@ -20,10 +20,10 @@ export declare class SinglyLinkedList<E = any> {
      * The constructor initializes the linked list with an empty head, tail, and length.
      */
     constructor(elements?: Iterable<E>);
-    protected _head: SinglyLinkedListNode<E> | null;
-    get head(): SinglyLinkedListNode<E> | null;
-    protected _tail: SinglyLinkedListNode<E> | null;
-    get tail(): SinglyLinkedListNode<E> | null;
+    protected _head: SinglyLinkedListNode<E> | undefined;
+    get head(): SinglyLinkedListNode<E> | undefined;
+    protected _tail: SinglyLinkedListNode<E> | undefined;
+    get tail(): SinglyLinkedListNode<E> | undefined;
     protected _length: number;
     get length(): number;
     /**
@@ -77,7 +77,7 @@ export declare class SinglyLinkedList<E = any> {
      * The `pop()` function removes and returns the value of the last element in a linked list, updating the head and tail
      * pointers accordingly.
      * @returns The method `pop()` returns the value of the node that is being removed from the end of the linked list. If
-     * the linked list is empty, it returns `null`.
+     * the linked list is empty, it returns `undefined`.
      */
     pop(): E | undefined;
     /**
@@ -91,7 +91,7 @@ export declare class SinglyLinkedList<E = any> {
      * The `popLast()` function removes and returns the value of the last element in a linked list, updating the head and tail
      * pointers accordingly.
      * @returns The method `pop()` returns the value of the node that is being removed from the end of the linked list. If
-     * the linked list is empty, it returns `null`.
+     * the linked list is empty, it returns `undefined`.
      */
     popLast(): E | undefined;
     /**
@@ -152,11 +152,11 @@ export declare class SinglyLinkedList<E = any> {
      * Time Complexity: O(n) - Linear time, where n is the index, as it may need to traverse the list to find the desired node.
      * Space Complexity: O(1) - Constant space.
      *
-     * The function `getAt` returns the value at a specified index in a linked list, or null if the index is out of range.
+     * The function `getAt` returns the value at a specified index in a linked list, or undefined if the index is out of range.
      * @param {number} index - The index parameter is a number that represents the position of the element we want to
      * retrieve from the list.
-     * @returns The method `getAt(index: number): E | null` returns the value at the specified index in the linked list, or
-     * `null` if the index is out of bounds.
+     * @returns The method `getAt(index: number): E | undefined` returns the value at the specified index in the linked list, or
+     * `undefined` if the index is out of bounds.
      */
     getAt(index: number): E | undefined;
     /**
@@ -171,9 +171,9 @@ export declare class SinglyLinkedList<E = any> {
      * @param {number} index - The `index` parameter is a number that represents the position of the node we want to
      * retrieve from the linked list. It indicates the zero-based index of the node we want to access.
      * @returns The method `getNodeAt(index: number)` returns a `SinglyLinkedListNode<E>` object if the node at the
-     * specified index exists, or `null` if the index is out of bounds.
+     * specified index exists, or `undefined` if the index is out of bounds.
      */
-    getNodeAt(index: number): SinglyLinkedListNode<E> | null;
+    getNodeAt(index: number): SinglyLinkedListNode<E> | undefined;
     /**
      * Time Complexity: O(n) - Linear time, where n is the index, as it may need to traverse the list to find the desired node.
      * Space Complexity: O(1) - Constant space.
@@ -185,7 +185,7 @@ export declare class SinglyLinkedList<E = any> {
      * The `deleteAt` function removes an element at a specified index from a linked list and returns the removed element.
      * @param {number} index - The index parameter represents the position of the element that needs to be deleted in the
      * data structure. It is of type number.
-     * @returns The method `deleteAt` returns the value of the node that was deleted, or `null` if the index is out of
+     * @returns The method `deleteAt` returns the value of the node that was deleted, or `undefined` if the index is out of
      * bounds.
      */
     deleteAt(index: number): E | undefined;
@@ -203,7 +203,7 @@ export declare class SinglyLinkedList<E = any> {
      * @returns The `delete` method returns a boolean value. It returns `true` if the value or node is found and
      * successfully deleted from the linked list, and `false` if the value or node is not found in the linked list.
      */
-    delete(valueOrNode: E | SinglyLinkedListNode<E> | null | undefined): boolean;
+    delete(valueOrNode: E | SinglyLinkedListNode<E> | undefined | undefined): boolean;
     /**
      * Time Complexity: O(n) - Linear time, where n is the index, as it may need to traverse the list to find the desired node.
      * Space Complexity: O(1) - Constant space.
@@ -228,7 +228,7 @@ export declare class SinglyLinkedList<E = any> {
      */
     isEmpty(): boolean;
     /**
-     * The `clear` function resets the linked list by setting the head, tail, and length to null and 0 respectively.
+     * The `clear` function resets the linked list by setting the head, tail, and length to undefined and 0 respectively.
      */
     clear(): void;
     /**
@@ -267,9 +267,9 @@ export declare class SinglyLinkedList<E = any> {
      * @param callback - A function that takes a value of type E as its parameter and returns a boolean value. This
      * function is used to determine whether a particular value in the linked list satisfies a certain condition.
      * @returns The method `find` returns the first element in the linked list that satisfies the condition specified by
-     * the callback function. If no element satisfies the condition, it returns `null`.
+     * the callback function. If no element satisfies the condition, it returns `undefined`.
      */
-    find(callback: (value: E) => boolean): E | null;
+    find(callback: (value: E) => boolean): E | undefined;
     /**
      * Time Complexity: O(n) - Linear time, where n is the length of the list, as it needs to reverse the pointers of each node.
      * Space Complexity: O(1) - Constant space.
@@ -293,12 +293,12 @@ export declare class SinglyLinkedList<E = any> {
      * Space Complexity: O(1) - Constant space.
      *
      * The function finds a node in a singly linked list by its value and returns the node if found, otherwise returns
-     * null.
+     * undefined.
      * @param {E} value - The value parameter is the value that we want to search for in the linked list.
      * @returns a `SinglyLinkedListNode<E>` if a node with the specified value is found in the linked list. If no node with
-     * the specified value is found, the function returns `null`.
+     * the specified value is found, the function returns `undefined`.
      */
-    getNode(value: E): SinglyLinkedListNode<E> | null;
+    getNode(value: E): SinglyLinkedListNode<E> | undefined;
     /**
      * Time Complexity: O(n) - Linear time, where n is the length of the list, as it needs to reverse the pointers of each node.
      * Space Complexity: O(1) - Constant space.

package/dist/mjs/data-structures/linked-list/singly-linked-list.js

@@ -9,13 +9,13 @@ export class SinglyLinkedListNode {
     value;
     next;
     /**
-     * The constructor function initializes an instance of a class with a given value and sets the next property to null.
+     * The constructor function initializes an instance of a class with a given value and sets the next property to undefined.
      * @param {E} value - The "value" parameter is of type E, which means it can be any data type. It represents the value that
      * will be stored in the node of a linked list.
      */
     constructor(value) {
         this.value = value;
-        this.next = null;
+        this.next = undefined;
     }
 }
 export class SinglyLinkedList {
@@ -23,8 +23,8 @@ export class SinglyLinkedList {
      * The constructor initializes the linked list with an empty head, tail, and length.
      */
     constructor(elements) {
-        this._head = null;
-        this._tail = null;
+        this._head = undefined;
+        this._tail = undefined;
         this._length = 0;
         if (elements) {
             for (const el of elements)
@@ -113,15 +113,15 @@ export class SinglyLinkedList {
      * The `pop()` function removes and returns the value of the last element in a linked list, updating the head and tail
      * pointers accordingly.
      * @returns The method `pop()` returns the value of the node that is being removed from the end of the linked list. If
-     * the linked list is empty, it returns `null`.
+     * the linked list is empty, it returns `undefined`.
      */
     pop() {
         if (!this.head)
             return undefined;
         if (this.head === this.tail) {
             const value = this.head.value;
-            this._head = null;
-            this._tail = null;
+            this._head = undefined;
+            this._tail = undefined;
             this._length--;
             return value;
         }
@@ -130,7 +130,7 @@ export class SinglyLinkedList {
             current = current.next;
         }
         const value = this.tail.value;
-        current.next = null;
+        current.next = undefined;
         this._tail = current;
         this._length--;
         return value;
@@ -146,7 +146,7 @@ export class SinglyLinkedList {
      * The `popLast()` function removes and returns the value of the last element in a linked list, updating the head and tail
      * pointers accordingly.
      * @returns The method `pop()` returns the value of the node that is being removed from the end of the linked list. If
-     * the linked list is empty, it returns `null`.
+     * the linked list is empty, it returns `undefined`.
      */
     popLast() {
         return this.pop();
@@ -231,11 +231,11 @@ export class SinglyLinkedList {
      * Time Complexity: O(n) - Linear time, where n is the index, as it may need to traverse the list to find the desired node.
      * Space Complexity: O(1) - Constant space.
      *
-     * The function `getAt` returns the value at a specified index in a linked list, or null if the index is out of range.
+     * The function `getAt` returns the value at a specified index in a linked list, or undefined if the index is out of range.
      * @param {number} index - The index parameter is a number that represents the position of the element we want to
      * retrieve from the list.
-     * @returns The method `getAt(index: number): E | null` returns the value at the specified index in the linked list, or
-     * `null` if the index is out of bounds.
+     * @returns The method `getAt(index: number): E | undefined` returns the value at the specified index in the linked list, or
+     * `undefined` if the index is out of bounds.
      */
     getAt(index) {
         if (index < 0 || index >= this.length)
@@ -258,7 +258,7 @@ export class SinglyLinkedList {
      * @param {number} index - The `index` parameter is a number that represents the position of the node we want to
      * retrieve from the linked list. It indicates the zero-based index of the node we want to access.
      * @returns The method `getNodeAt(index: number)` returns a `SinglyLinkedListNode<E>` object if the node at the
-     * specified index exists, or `null` if the index is out of bounds.
+     * specified index exists, or `undefined` if the index is out of bounds.
      */
     getNodeAt(index) {
         let current = this.head;
@@ -278,7 +278,7 @@ export class SinglyLinkedList {
      * The `deleteAt` function removes an element at a specified index from a linked list and returns the removed element.
      * @param {number} index - The index parameter represents the position of the element that needs to be deleted in the
      * data structure. It is of type number.
-     * @returns The method `deleteAt` returns the value of the node that was deleted, or `null` if the index is out of
+     * @returns The method `deleteAt` returns the value of the node that was deleted, or `undefined` if the index is out of
      * bounds.
      */
     deleteAt(index) {
@@ -318,13 +318,13 @@ export class SinglyLinkedList {
         else {
             value = valueOrNode;
         }
-        let current = this.head, prev = null;
+        let current = this.head, prev = undefined;
         while (current) {
             if (current.value === value) {
-                if (prev === null) {
+                if (prev === undefined) {
                     this._head = current.next;
                     if (current === this.tail) {
-                        this._tail = null;
+                        this._tail = undefined;
                     }
                 }
                 else {
@@ -384,11 +384,11 @@ export class SinglyLinkedList {
         return this.length === 0;
     }
     /**
-     * The `clear` function resets the linked list by setting the head, tail, and length to null and 0 respectively.
+     * The `clear` function resets the linked list by setting the head, tail, and length to undefined and 0 respectively.
      */
     clear() {
-        this._head = null;
-        this._tail = null;
+        this._head = undefined;
+        this._tail = undefined;
         this._length = 0;
     }
     /**
@@ -425,9 +425,9 @@ export class SinglyLinkedList {
     reverse() {
         if (!this.head || this.head === this.tail)
             return;
-        let prev = null;
+        let prev = undefined;
         let current = this.head;
-        let next = null;
+        let next = undefined;
         while (current) {
             next = current.next;
             current.next = prev;
@@ -448,7 +448,7 @@ export class SinglyLinkedList {
      * @param callback - A function that takes a value of type E as its parameter and returns a boolean value. This
      * function is used to determine whether a particular value in the linked list satisfies a certain condition.
      * @returns The method `find` returns the first element in the linked list that satisfies the condition specified by
-     * the callback function. If no element satisfies the condition, it returns `null`.
+     * the callback function. If no element satisfies the condition, it returns `undefined`.
      */
     find(callback) {
         let current = this.head;
@@ -458,7 +458,7 @@ export class SinglyLinkedList {
             }
             current = current.next;
         }
-        return null;
+        return undefined;
     }
     /**
      * Time Complexity: O(n) - Linear time, where n is the length of the list, as it needs to reverse the pointers of each node.
@@ -494,10 +494,10 @@ export class SinglyLinkedList {
      * Space Complexity: O(1) - Constant space.
      *
      * The function finds a node in a singly linked list by its value and returns the node if found, otherwise returns
-     * null.
+     * undefined.
      * @param {E} value - The value parameter is the value that we want to search for in the linked list.
      * @returns a `SinglyLinkedListNode<E>` if a node with the specified value is found in the linked list. If no node with
-     * the specified value is found, the function returns `null`.
+     * the specified value is found, the function returns `undefined`.
      */
     getNode(value) {
         let current = this.head;
@@ -507,7 +507,7 @@ export class SinglyLinkedList {
             }
             current = current.next;
         }
-        return null;
+        return undefined;
     }
     /**
      * Time Complexity: O(n) - Linear time, where n is the length of the list, as it needs to reverse the pointers of each node.

package/dist/mjs/data-structures/linked-list/skip-linked-list.js

@@ -24,7 +24,7 @@ export class SkipList {
      * level in the skip list. It is used to determine the height of each node in the skip list.
      */
     constructor(maxLevel = 16, probability = 0.5) {
-        this._head = new SkipListNode(null, null, maxLevel);
+        this._head = new SkipListNode(undefined, undefined, maxLevel);
         this._level = 0;
         this._maxLevel = maxLevel;
         this._probability = probability;
@@ -72,7 +72,7 @@ export class SkipList {
             newNode.forward[i] = update[i].forward[i];
             update[i].forward[i] = newNode;
         }
-        if (newNode.forward[0] !== null) {
+        if (!newNode.forward[0]) {
             this._level = Math.max(this.level, newNode.forward.length);
         }
     }
@@ -143,7 +143,7 @@ export class SkipList {
                 }
                 update[i].forward[i] = current.forward[i];
             }
-            while (this.level > 0 && this.head.forward[this.level - 1] === null) {
+            while (this.level > 0 && !this.head.forward[this.level - 1]) {
                 this._level--;
             }
             return true;
@@ -221,7 +221,7 @@ export class SkipList {
      */
     lower(key) {
         let current = this.head;
-        let lastLess = null;
+        let lastLess = undefined;
         for (let i = this.level - 1; i >= 0; i--) {
             while (current.forward[i] && current.forward[i].key < key) {
                 current = current.forward[i];

package/dist/mjs/data-structures/queue/queue.d.ts

@@ -11,8 +11,8 @@ export declare class LinkedListQueue<E = any> extends SinglyLinkedList<E> {
      */
     enqueue(value: E): void;
     /**
-     * The `dequeue` function removes and returns the first element from a queue, or returns null if the queue is empty.
-     * @returns The method is returning the element at the front of the queue, or null if the queue is empty.
+     * The `dequeue` function removes and returns the first element from a queue, or returns undefined if the queue is empty.
+     * @returns The method is returning the element at the front of the queue, or undefined if the queue is empty.
      */
     dequeue(): E | undefined;
     /**
@@ -75,7 +75,7 @@ export declare class Queue<E = any> {
      *
      * The `shift` function removes and returns the first element in the queue, and adjusts the internal data structure if
      * necessary to optimize performance.
-     * @returns The function `shift()` returns either the first element in the queue or `null` if the queue is empty.
+     * @returns The function `shift()` returns either the first element in the queue or `undefined` if the queue is empty.
      */
     shift(): E | undefined;
     /**
@@ -86,9 +86,9 @@ export declare class Queue<E = any> {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `getFirst` function returns the first element of the array `_nodes` if it exists, otherwise it returns `null`.
+     * The `getFirst` function returns the first element of the array `_nodes` if it exists, otherwise it returns `undefined`.
      * @returns The `getFirst()` method returns the first element of the data structure, represented by the `_nodes` array at
-     * the `_offset` index. If the data structure is empty (size is 0), it returns `null`.
+     * the `_offset` index. If the data structure is empty (size is 0), it returns `undefined`.
      */
     getFirst(): E | undefined;
     /**
@@ -99,9 +99,9 @@ export declare class Queue<E = any> {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `peek` function returns the first element of the array `_nodes` if it exists, otherwise it returns `null`.
+     * The `peek` function returns the first element of the array `_nodes` if it exists, otherwise it returns `undefined`.
      * @returns The `peek()` method returns the first element of the data structure, represented by the `_nodes` array at
-     * the `_offset` index. If the data structure is empty (size is 0), it returns `null`.
+     * the `_offset` index. If the data structure is empty (size is 0), it returns `undefined`.
      */
     peek(): E | undefined;
     /**
@@ -112,9 +112,9 @@ export declare class Queue<E = any> {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `getLast` function returns the last element in an array-like data structure, or null if the structure is empty.
+     * The `getLast` function returns the last element in an array-like data structure, or undefined if the structure is empty.
      * @returns The method `getLast()` returns the last element of the `_nodes` array if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
     getLast(): E | undefined;
     /**
@@ -125,9 +125,9 @@ export declare class Queue<E = any> {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `peekLast` function returns the last element in an array-like data structure, or null if the structure is empty.
+     * The `peekLast` function returns the last element in an array-like data structure, or undefined if the structure is empty.
      * @returns The method `peekLast()` returns the last element of the `_nodes` array if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
     peekLast(): E | undefined;
     /**
@@ -150,8 +150,8 @@ export declare class Queue<E = any> {
      * Time Complexity: O(n) - same as shift().
      * Space Complexity: O(1) - same as shift().
      *
-     * The `dequeue` function removes and returns the first element from a queue, or returns null if the queue is empty.
-     * @returns The method is returning a value of type E or null.
+     * The `dequeue` function removes and returns the first element from a queue, or returns undefined if the queue is empty.
+     * @returns The method is returning a value of type E or undefined.
      */
     dequeue(): E | undefined;
     /**

package/dist/mjs/data-structures/queue/queue.js

@@ -13,8 +13,8 @@ export class LinkedListQueue extends SinglyLinkedList {
         this.push(value);
     }
     /**
-     * The `dequeue` function removes and returns the first element from a queue, or returns null if the queue is empty.
-     * @returns The method is returning the element at the front of the queue, or null if the queue is empty.
+     * The `dequeue` function removes and returns the first element from a queue, or returns undefined if the queue is empty.
+     * @returns The method is returning the element at the front of the queue, or undefined if the queue is empty.
      */
     dequeue() {
         return this.shift();
@@ -97,7 +97,7 @@ export class Queue {
      *
      * The `shift` function removes and returns the first element in the queue, and adjusts the internal data structure if
      * necessary to optimize performance.
-     * @returns The function `shift()` returns either the first element in the queue or `null` if the queue is empty.
+     * @returns The function `shift()` returns either the first element in the queue or `undefined` if the queue is empty.
      */
     shift() {
         if (this.size === 0)
@@ -120,9 +120,9 @@ export class Queue {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `getFirst` function returns the first element of the array `_nodes` if it exists, otherwise it returns `null`.
+     * The `getFirst` function returns the first element of the array `_nodes` if it exists, otherwise it returns `undefined`.
      * @returns The `getFirst()` method returns the first element of the data structure, represented by the `_nodes` array at
-     * the `_offset` index. If the data structure is empty (size is 0), it returns `null`.
+     * the `_offset` index. If the data structure is empty (size is 0), it returns `undefined`.
      */
     getFirst() {
         return this.size > 0 ? this.nodes[this.offset] : undefined;
@@ -135,9 +135,9 @@ export class Queue {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `peek` function returns the first element of the array `_nodes` if it exists, otherwise it returns `null`.
+     * The `peek` function returns the first element of the array `_nodes` if it exists, otherwise it returns `undefined`.
      * @returns The `peek()` method returns the first element of the data structure, represented by the `_nodes` array at
-     * the `_offset` index. If the data structure is empty (size is 0), it returns `null`.
+     * the `_offset` index. If the data structure is empty (size is 0), it returns `undefined`.
      */
     peek() {
         return this.getFirst();
@@ -150,9 +150,9 @@ export class Queue {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `getLast` function returns the last element in an array-like data structure, or null if the structure is empty.
+     * The `getLast` function returns the last element in an array-like data structure, or undefined if the structure is empty.
      * @returns The method `getLast()` returns the last element of the `_nodes` array if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
     getLast() {
         return this.size > 0 ? this.nodes[this.nodes.length - 1] : undefined;
@@ -165,9 +165,9 @@ export class Queue {
      * Time Complexity: O(1) - constant time as it retrieves the value at the current offset.
      * Space Complexity: O(1) - no additional space is used.
      *
-     * The `peekLast` function returns the last element in an array-like data structure, or null if the structure is empty.
+     * The `peekLast` function returns the last element in an array-like data structure, or undefined if the structure is empty.
      * @returns The method `peekLast()` returns the last element of the `_nodes` array if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
     peekLast() {
         return this.getLast();
@@ -194,8 +194,8 @@ export class Queue {
      * Time Complexity: O(n) - same as shift().
      * Space Complexity: O(1) - same as shift().
      *
-     * The `dequeue` function removes and returns the first element from a queue, or returns null if the queue is empty.
-     * @returns The method is returning a value of type E or null.
+     * The `dequeue` function removes and returns the first element from a queue, or returns undefined if the queue is empty.
+     * @returns The method is returning a value of type E or undefined.
      */
     dequeue() {
         return this.shift();

package/dist/mjs/data-structures/stack/stack.d.ts

@@ -45,10 +45,10 @@ export declare class Stack<E = any> {
      * Time Complexity: O(1), as it only involves accessing the last element of the array.
      * Space Complexity: O(1), as it does not use any additional space.
      *
-     * The `peek` function returns the last element of an array, or null if the array is empty.
-     * @returns The `peek()` function returns the last element of the `_elements` array, or `null` if the array is empty.
+     * The `peek` function returns the last element of an array, or undefined if the array is empty.
+     * @returns The `peek()` function returns the last element of the `_elements` array, or `undefined` if the array is empty.
      */
-    peek(): E | null;
+    peek(): E | undefined;
     /**
      * Time Complexity: O(1), as it only involves accessing the last element of the array.
      * Space Complexity: O(1), as it does not use any additional space.
@@ -70,11 +70,11 @@ export declare class Stack<E = any> {
      * Time Complexity: O(1), as it only involves accessing the last element of the array.
      * Space Complexity: O(1), as it does not use any additional space.
      *
-     * The `pop` function removes and returns the last element from an array, or returns null if the array is empty.
+     * The `pop` function removes and returns the last element from an array, or returns undefined if the array is empty.
      * @returns The `pop()` method is returning the last element of the array `_elements` if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
-    pop(): E | null;
+    pop(): E | undefined;
     /**
      * Time Complexity: O(n)
      * Space Complexity: O(n)

package/dist/mjs/data-structures/stack/stack.js

@@ -60,12 +60,12 @@ export class Stack {
      * Time Complexity: O(1), as it only involves accessing the last element of the array.
      * Space Complexity: O(1), as it does not use any additional space.
      *
-     * The `peek` function returns the last element of an array, or null if the array is empty.
-     * @returns The `peek()` function returns the last element of the `_elements` array, or `null` if the array is empty.
+     * The `peek` function returns the last element of an array, or undefined if the array is empty.
+     * @returns The `peek()` function returns the last element of the `_elements` array, or `undefined` if the array is empty.
      */
     peek() {
         if (this.isEmpty())
-            return null;
+            return undefined;
         return this.elements[this.elements.length - 1];
     }
     /**
@@ -92,14 +92,14 @@ export class Stack {
      * Time Complexity: O(1), as it only involves accessing the last element of the array.
      * Space Complexity: O(1), as it does not use any additional space.
      *
-     * The `pop` function removes and returns the last element from an array, or returns null if the array is empty.
+     * The `pop` function removes and returns the last element from an array, or returns undefined if the array is empty.
      * @returns The `pop()` method is returning the last element of the array `_elements` if the array is not empty. If the
-     * array is empty, it returns `null`.
+     * array is empty, it returns `undefined`.
      */
     pop() {
         if (this.isEmpty())
-            return null;
-        return this.elements.pop() || null;
+            return undefined;
+        return this.elements.pop() || undefined;
     }
     /**
      * Time Complexity: O(n)

package/dist/mjs/types/data-structures/graph/abstract-graph.d.ts

@@ -2,9 +2,9 @@ export type VertexKey = string | number;
 export type DijkstraResult<V> = {
     distMap: Map<V, number>;
     distPaths?: Map<V, V[]>;
-    preMap: Map<V, V | null>;
+    preMap: Map<V, V | undefined>;
     seen: Set<V>;
     paths: V[][];
     minDist: number;
     minPath: V[];
-} | null;
+} | undefined;