data-structure-typed 1.47.5 → 1.47.6

package/dist/mjs/data-structures/binary-tree/tree-multimap.d.ts

@@ -6,7 +6,7 @@
  * @license MIT License
  */
 import type { BTNKey, TreeMultimapNodeNested, TreeMultimapOptions } from '../../types';
-import { BiTreeDeleteResult, BTNCallback, IterationType, TreeMultimapNested } from '../../types';
+import { BiTreeDeleteResult, BTNCallback, IterableEntriesOrKeys, IterationType, TreeMultimapNested } from '../../types';
 import { IBinaryTree } from '../../interfaces';
 import { AVLTree, AVLTreeNode } from './avl-tree';
 export declare class TreeMultimapNode<V = any, N extends TreeMultimapNode<V, N> = TreeMultimapNodeNested<V>> extends AVLTreeNode<V, N> {
@@ -27,14 +27,13 @@ export declare class TreeMultimapNode<V = any, N extends TreeMultimapNode<V, N>
  * The only distinction between a TreeMultimap and a AVLTree lies in the ability of the former to store duplicate nodes through the utilization of counters.
  */
 export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = TreeMultimapNode<V, TreeMultimapNodeNested<V>>, TREE extends TreeMultimap<V, N, TREE> = TreeMultimap<V, N, TreeMultimapNested<V, N>>> extends AVLTree<V, N, TREE> implements IBinaryTree<V, N, TREE> {
-    options: TreeMultimapOptions;
     /**
      * The constructor function for a TreeMultimap class in TypeScript, which extends another class and sets an option to
      * merge duplicated values.
      * @param {TreeMultimapOptions} [options] - An optional object that contains additional configuration options for the
      * TreeMultimap.
      */
-    constructor(options?: TreeMultimapOptions);
+    constructor(elements?: IterableEntriesOrKeys<V>, options?: Partial<TreeMultimapOptions>);
     private _count;
     get count(): number;
     /**
@@ -48,10 +47,6 @@ export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = Tr
      */
     createNode(key: BTNKey, value?: V, count?: number): N;
     createTree(options?: TreeMultimapOptions): TREE;
-    /**
-     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
-     */
     /**
      * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
      * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
@@ -68,8 +63,8 @@ export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = Tr
      */
     add(keyOrNode: BTNKey | N | null | undefined, value?: V, count?: number): N | undefined;
     /**
-     * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
-     * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.
+     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
      */
     /**
      * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
@@ -86,8 +81,8 @@ export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = Tr
      */
     addMany(keysOrNodes: (BTNKey | N | undefined)[], data?: V[]): (N | undefined)[];
     /**
-     * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
+     * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.
      */
     /**
      * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
@@ -100,10 +95,10 @@ export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = Tr
      * values:
      * @returns a boolean value.
      */
-    perfectlyBalance(iterationType?: IterationType | undefined): boolean;
+    perfectlyBalance(iterationType?: IterationType): boolean;
     /**
-     * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
-     * Space Complexity: O(n) - linear space, as it creates an array to store the sorted nodes.
+     * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
      */
     /**
      * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
@@ -126,13 +121,18 @@ export declare class TreeMultimap<V = any, N extends TreeMultimapNode<V, N> = Tr
      */
     delete<C extends BTNCallback<N>>(identifier: ReturnType<C>, callback?: C, ignoreCount?: boolean): BiTreeDeleteResult<N>[];
     /**
-     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
+     * Space Complexity: O(n) - linear space, as it creates an array to store the sorted nodes.
      */
     /**
      * The clear() function clears the contents of a data structure and sets the count to zero.
      */
     clear(): void;
+    /**
+     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     */
+    init(elements: IterableEntriesOrKeys<V>): void;
     /**
      * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
      * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.

package/dist/mjs/data-structures/binary-tree/tree-multimap.js

@@ -21,21 +21,16 @@ export class TreeMultimapNode extends AVLTreeNode {
  * The only distinction between a TreeMultimap and a AVLTree lies in the ability of the former to store duplicate nodes through the utilization of counters.
  */
 export class TreeMultimap extends AVLTree {
-    options;
     /**
      * The constructor function for a TreeMultimap class in TypeScript, which extends another class and sets an option to
      * merge duplicated values.
      * @param {TreeMultimapOptions} [options] - An optional object that contains additional configuration options for the
      * TreeMultimap.
      */
-    constructor(options = { iterationType: IterationType.ITERATIVE }) {
-        super(options);
-        if (options) {
-            this.options = { iterationType: IterationType.ITERATIVE, comparator: (a, b) => a - b, ...options };
-        }
-        else {
-            this.options = { iterationType: IterationType.ITERATIVE, comparator: (a, b) => a - b };
-        }
+    constructor(elements, options) {
+        super([], options);
+        if (elements)
+            this.init(elements);
     }
     _count = 0;
     get count() {
@@ -54,12 +49,11 @@ export class TreeMultimap extends AVLTree {
         return new TreeMultimapNode(key, value, count);
     }
     createTree(options) {
-        return new TreeMultimap({ ...this.options, ...options });
+        return new TreeMultimap([], {
+            iterationType: this.iterationType,
+            comparator: this.comparator, ...options
+        });
     }
-    /**
-     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
-     */
     /**
      * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
      * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
@@ -154,8 +148,8 @@ export class TreeMultimap extends AVLTree {
         return inserted;
     }
     /**
-     * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
-     * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.
+     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The add method of the superclass (AVLTree) has logarithmic time complexity.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
      */
     /**
      * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
@@ -187,8 +181,8 @@ export class TreeMultimap extends AVLTree {
         return inserted;
     }
     /**
-     * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
+     * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.
      */
     /**
      * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
@@ -201,7 +195,7 @@ export class TreeMultimap extends AVLTree {
      * values:
      * @returns a boolean value.
      */
-    perfectlyBalance(iterationType = this.options.iterationType) {
+    perfectlyBalance(iterationType = this.iterationType) {
         const sorted = this.dfs(node => node, 'in'), n = sorted.length;
         if (sorted.length < 1)
             return false;
@@ -238,8 +232,8 @@ export class TreeMultimap extends AVLTree {
         }
     }
     /**
-     * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
-     * Space Complexity: O(n) - linear space, as it creates an array to store the sorted nodes.
+     * Time Complexity: O(k log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree, and "k" is the number of keys to be inserted. This is because the method iterates through the keys and calls the add method for each.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
      */
     /**
      * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
@@ -318,8 +312,8 @@ export class TreeMultimap extends AVLTree {
         return deletedResult;
     }
     /**
-     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
-     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     * Time Complexity: O(n log n) - logarithmic time for each insertion, where "n" is the number of nodes in the tree. This is because the method calls the add method for each node.
+     * Space Complexity: O(n) - linear space, as it creates an array to store the sorted nodes.
      */
     /**
      * The clear() function clears the contents of a data structure and sets the count to zero.
@@ -328,6 +322,23 @@ export class TreeMultimap extends AVLTree {
         super.clear();
         this._count = 0;
     }
+    /**
+     * Time Complexity: O(log n) - logarithmic time, where "n" is the number of nodes in the tree. The delete method of the superclass (AVLTree) has logarithmic time complexity.
+     * Space Complexity: O(1) - constant space, as it doesn't use additional data structures that scale with input size.
+     */
+    init(elements) {
+        if (elements) {
+            for (const entryOrKey of elements) {
+                if (Array.isArray(entryOrKey)) {
+                    const [key, value] = entryOrKey;
+                    this.add(key, value);
+                }
+                else {
+                    this.add(entryOrKey);
+                }
+            }
+        }
+    }
     /**
      * Time Complexity: O(1) - constant time, as it performs basic pointer assignments.
      * Space Complexity: O(1) - constant space, as it only uses a constant amount of memory.

package/dist/mjs/data-structures/graph/abstract-graph.js

@@ -589,7 +589,7 @@ export class AbstractGraph {
             if (vertexOrKey instanceof AbstractVertex)
                 distMap.set(vertexOrKey, Infinity);
         }
-        const heap = new PriorityQueue({ comparator: (a, b) => a.key - b.key });
+        const heap = new PriorityQueue([], { comparator: (a, b) => a.key - b.key });
         heap.add({ key: 0, value: srcVertex });
         distMap.set(srcVertex, 0);
         preMap.set(srcVertex, null);

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

@@ -5,15 +5,12 @@
  * @license MIT License
  */
 import type { Comparator, DFSOrderPattern } from '../../types';
+import { HeapOptions } from "../../types";
 export declare class Heap<E = any> {
-    constructor(options: {
-        comparator: Comparator<E>;
-        elements?: E[];
-    });
+    options: HeapOptions<E>;
+    constructor(elements?: Iterable<E>, options?: HeapOptions<E>);
     protected _elements: E[];
     get elements(): E[];
-    protected _comparator: Comparator<E>;
-    get comparator(): Comparator<E>;
     /**
      * Get the size (number of elements) of the heap.
      */
@@ -26,10 +23,10 @@ export declare class Heap<E = any> {
     /**
      * Static method that creates a binary heap from an array of elements and a comparison function.
      * @returns A new Heap instance.
+     * @param elements
      * @param options
      */
-    static heapify<E>(options: {
-        elements: E[];
+    static heapify<E>(elements: Iterable<E>, options: {
         comparator: Comparator<E>;
     }): Heap<E>;
     /**
@@ -204,6 +201,11 @@ export declare class Heap<E = any> {
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
      */
+    print(): void;
+    /**
+     * Time Complexity: O(n)
+     * Space Complexity: O(1)
+     */
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
@@ -212,10 +214,6 @@ export declare class Heap<E = any> {
      * @param index - The index of the newly added element.
      */
     protected _bubbleUp(index: number): void;
-    /**
-     * Time Complexity: O(n)
-     * Space Complexity: O(1)
-     */
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
@@ -349,18 +347,18 @@ export declare class FibonacciHeap<E> {
      */
     merge(heapToMerge: FibonacciHeap<E>): void;
     /**
-     * Default comparator function used by the heap.
-     * @param {E} a
-     * @param {E} b
+     * Create a new node.
+     * @param element
      * @protected
      */
-    protected defaultComparator(a: E, b: E): number;
+    createNode(element: E): FibonacciHeapNode<E>;
     /**
-     * Create a new node.
-     * @param element
+     * Default comparator function used by the heap.
+     * @param {E} a
+     * @param {E} b
      * @protected
      */
-    protected createNode(element: E): FibonacciHeapNode<E>;
+    protected _defaultComparator(a: E, b: E): number;
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -399,7 +397,7 @@ export declare class FibonacciHeap<E> {
      * @param x
      * @protected
      */
-    protected link(y: FibonacciHeapNode<E>, x: FibonacciHeapNode<E>): void;
+    protected _link(y: FibonacciHeapNode<E>, x: FibonacciHeapNode<E>): void;
     /**
      * Time Complexity: O(n log n), where n is the number of elements in the heap.
      * Space Complexity: O(n)
@@ -411,5 +409,5 @@ export declare class FibonacciHeap<E> {
      * Remove and return the top element (smallest or largest element) from the heap.
      * @protected
      */
-    protected consolidate(): void;
+    protected _consolidate(): void;
 }

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

@@ -5,21 +5,35 @@
  * @license MIT License
  */
 export class Heap {
-    constructor(options) {
-        this._comparator = options.comparator;
-        if (options.elements && options.elements.length > 0) {
-            this._elements = options.elements;
-            this.fix();
+    options;
+    constructor(elements, options) {
+        const defaultComparator = (a, b) => {
+            if (!(typeof a === 'number' && typeof b === 'number')) {
+                throw new Error('The a, b params of compare function must be number');
+            }
+            else {
+                return a - b;
+            }
+        };
+        if (options) {
+            this.options = options;
+        }
+        else {
+            this.options = {
+                comparator: defaultComparator
+            };
+        }
+        if (elements) {
+            for (const el of elements) {
+                this.push(el);
+            }
+            // this.fix();
         }
     }
     _elements = [];
     get elements() {
         return this._elements;
     }
-    _comparator;
-    get comparator() {
-        return this._comparator;
-    }
     /**
      * Get the size (number of elements) of the heap.
      */
@@ -36,10 +50,11 @@ export class Heap {
     /**
      * Static method that creates a binary heap from an array of elements and a comparison function.
      * @returns A new Heap instance.
+     * @param elements
      * @param options
      */
-    static heapify(options) {
-        return new Heap(options);
+    static heapify(elements, options) {
+        return new Heap(elements, options);
     }
     /**
      * Time Complexity: O(log n), where n is the number of elements in the heap.
@@ -253,7 +268,7 @@ export class Heap {
      * @returns A new Heap instance containing the same elements.
      */
     clone() {
-        const clonedHeap = new Heap({ comparator: this.comparator });
+        const clonedHeap = new Heap([], this.options);
         clonedHeap._elements = [...this.elements];
         return clonedHeap;
     }
@@ -305,7 +320,7 @@ export class Heap {
         }
     }
     filter(predicate) {
-        const filteredHeap = new Heap({ comparator: this.comparator });
+        const filteredHeap = new Heap([], this.options);
         let index = 0;
         for (const el of this) {
             if (predicate(el, index, this)) {
@@ -316,7 +331,7 @@ export class Heap {
         return filteredHeap;
     }
     map(callback, comparator) {
-        const mappedHeap = new Heap({ comparator: comparator });
+        const mappedHeap = new Heap([], { comparator: comparator });
         let index = 0;
         for (const el of this) {
             mappedHeap.add(callback(el, index, this));
@@ -337,6 +352,13 @@ export class Heap {
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
      */
+    print() {
+        console.log([...this]);
+    }
+    /**
+     * Time Complexity: O(n)
+     * Space Complexity: O(1)
+     */
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
@@ -349,17 +371,13 @@ export class Heap {
         while (index > 0) {
             const parent = (index - 1) >> 1;
             const parentItem = this.elements[parent];
-            if (this._comparator(parentItem, element) <= 0)
+            if (this.options.comparator(parentItem, element) <= 0)
                 break;
             this.elements[index] = parentItem;
             index = parent;
         }
         this.elements[index] = element;
     }
-    /**
-     * Time Complexity: O(n)
-     * Space Complexity: O(1)
-     */
     /**
      * Time Complexity: O(log n)
      * Space Complexity: O(1)
@@ -375,11 +393,11 @@ export class Heap {
             const right = left + 1;
             let minItem = this.elements[left];
             if (right < this.elements.length &&
-                this._comparator(minItem, this.elements[right]) > 0) {
+                this.options.comparator(minItem, this.elements[right]) > 0) {
                 left = right;
                 minItem = this.elements[right];
             }
-            if (this._comparator(minItem, element) >= 0)
+            if (this.options.comparator(minItem, element) >= 0)
                 break;
             this.elements[index] = minItem;
             index = left;
@@ -404,7 +422,7 @@ export class FibonacciHeapNode {
 export class FibonacciHeap {
     constructor(comparator) {
         this.clear();
-        this._comparator = comparator || this.defaultComparator;
+        this._comparator = comparator || this._defaultComparator;
         if (typeof this.comparator !== 'function') {
             throw new Error('FibonacciHeap constructor: given comparator should be a function.');
         }
@@ -579,7 +597,7 @@ export class FibonacciHeap {
         }
         else {
             this._min = z.right;
-            this.consolidate();
+            this._consolidate();
         }
         this._size--;
         return z.element;
@@ -619,27 +637,27 @@ export class FibonacciHeap {
         // Clear the heap that was merged
         heapToMerge.clear();
     }
+    /**
+     * Create a new node.
+     * @param element
+     * @protected
+     */
+    createNode(element) {
+        return new FibonacciHeapNode(element);
+    }
     /**
      * Default comparator function used by the heap.
      * @param {E} a
      * @param {E} b
      * @protected
      */
-    defaultComparator(a, b) {
+    _defaultComparator(a, b) {
         if (a < b)
             return -1;
         if (a > b)
             return 1;
         return 0;
     }
-    /**
-     * Create a new node.
-     * @param element
-     * @protected
-     */
-    createNode(element) {
-        return new FibonacciHeapNode(element);
-    }
     /**
      * Time Complexity: O(1)
      * Space Complexity: O(1)
@@ -695,7 +713,7 @@ export class FibonacciHeap {
      * @param x
      * @protected
      */
-    link(y, x) {
+    _link(y, x) {
         this.removeFromRoot(y);
         y.left = y;
         y.right = y;
@@ -714,7 +732,7 @@ export class FibonacciHeap {
      * Remove and return the top element (smallest or largest element) from the heap.
      * @protected
      */
-    consolidate() {
+    _consolidate() {
         const A = new Array(this.size);
         const elements = this.consumeLinkedList(this.root);
         let x, y, d, t;
@@ -728,7 +746,7 @@ export class FibonacciHeap {
                     x = y;
                     y = t;
                 }
-                this.link(y, x);
+                this._link(y, x);
                 A[d] = undefined;
                 d++;
             }

package/dist/mjs/data-structures/heap/max-heap.d.ts

@@ -6,10 +6,7 @@
  * @license MIT License
  */
 import { Heap } from './heap';
-import type { Comparator } from '../../types';
+import type { HeapOptions } from '../../types';
 export declare class MaxHeap<E = any> extends Heap<E> {
-    constructor(options?: {
-        comparator: Comparator<E>;
-        nodes?: E[];
-    });
+    constructor(elements?: Iterable<E>, options?: HeapOptions<E>);
 }

package/dist/mjs/data-structures/heap/max-heap.js

@@ -7,7 +7,7 @@
  */
 import { Heap } from './heap';
 export class MaxHeap extends Heap {
-    constructor(options = {
+    constructor(elements, options = {
         comparator: (a, b) => {
             if (!(typeof a === 'number' && typeof b === 'number')) {
                 throw new Error('The a, b params of compare function must be number');
@@ -17,6 +17,6 @@ export class MaxHeap extends Heap {
             }
         }
     }) {
-        super(options);
+        super(elements, options);
     }
 }

package/dist/mjs/data-structures/heap/min-heap.d.ts

@@ -6,10 +6,7 @@
  * @license MIT License
  */
 import { Heap } from './heap';
-import type { Comparator } from '../../types';
+import type { HeapOptions } from '../../types';
 export declare class MinHeap<E = any> extends Heap<E> {
-    constructor(options?: {
-        comparator: Comparator<E>;
-        nodes?: E[];
-    });
+    constructor(elements?: Iterable<E>, options?: HeapOptions<E>);
 }

package/dist/mjs/data-structures/heap/min-heap.js

@@ -7,7 +7,7 @@
  */
 import { Heap } from './heap';
 export class MinHeap extends Heap {
-    constructor(options = {
+    constructor(elements, options = {
         comparator: (a, b) => {
             if (!(typeof a === 'number' && typeof b === 'number')) {
                 throw new Error('The a, b params of compare function must be number');
@@ -17,6 +17,6 @@ export class MinHeap extends Heap {
             }
         }
     }) {
-        super(options);
+        super(elements, options);
     }
 }

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

@@ -20,7 +20,7 @@ export declare class DoublyLinkedList<E = any> {
     /**
      * The constructor initializes the linked list with an empty head, tail, and length.
      */
-    constructor();
+    constructor(elements?: Iterable<E>);
     protected _head: DoublyLinkedListNode<E> | null;
     get head(): DoublyLinkedListNode<E> | null;
     protected _tail: DoublyLinkedListNode<E> | null;
@@ -453,4 +453,5 @@ export declare class DoublyLinkedList<E = any> {
      * elements in the linked list.
      */
     reduce<T>(callback: (accumulator: T, value: E, index: number, list: DoublyLinkedList<E>) => T, initialValue: T): T;
+    print(): void;
 }

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

@@ -24,10 +24,15 @@ export class DoublyLinkedList {
     /**
      * The constructor initializes the linked list with an empty head, tail, and length.
      */
-    constructor() {
+    constructor(elements) {
         this._head = null;
         this._tail = null;
         this._length = 0;
+        if (elements) {
+            for (const el of elements) {
+                this.push(el);
+            }
+        }
     }
     _head;
     get head() {
@@ -766,4 +771,7 @@ export class DoublyLinkedList {
         }
         return accumulator;
     }
+    print() {
+        console.log([...this]);
+    }
 }

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

@@ -19,7 +19,7 @@ export declare class SinglyLinkedList<E = any> {
     /**
      * The constructor initializes the linked list with an empty head, tail, and length.
      */
-    constructor();
+    constructor(elements?: Iterable<E>);
     protected _head: SinglyLinkedListNode<E> | null;
     get head(): SinglyLinkedListNode<E> | null;
     protected _tail: SinglyLinkedListNode<E> | null;
@@ -411,4 +411,5 @@ export declare class SinglyLinkedList<E = any> {
      * elements in the linked list.
      */
     reduce<T>(callback: (accumulator: T, value: E, index: number, list: SinglyLinkedList<E>) => T, initialValue: T): T;
+    print(): void;
 }