data-structure-typed 1.19.8 → 1.20.0

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

@@ -73,6 +73,9 @@ export declare abstract class Heap<T = number> {
     toArray(isItem?: undefined): (T | undefined)[];
     toArray(isItem: false): (T | undefined)[];
     toArray(isItem: true): (HeapItem<T> | null)[];
+    sort(isItem?: undefined): (T | undefined)[];
+    sort(isItem: false): (T | undefined)[];
+    sort(isItem: true): (HeapItem<T> | null)[];
     /**
      * The clear function clears the priority queue.
      */

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

@@ -134,6 +134,19 @@ class Heap {
         const itemArray = this._pq.toArray();
         return isItem ? itemArray : itemArray.map(item => item.val);
     }
+    /**
+     * The function sorts the elements in the priority queue and returns either the sorted items or their values depending
+     * on the value of the isItem parameter.
+     * @param {boolean} [isItem] - The `isItem` parameter is a boolean flag that indicates whether the sorted result should
+     * be an array of `HeapItem<T>` objects or an array of the values (`T`) of those objects. If `isItem` is `true`, the
+     * sorted result will be an array of `HeapItem
+     * @returns an array of either `HeapItem<T>`, `null`, `T`, or `undefined` values.
+     */
+    sort(isItem) {
+        isItem = isItem !== null && isItem !== void 0 ? isItem : false;
+        const sorted = this._pq.sort();
+        return isItem ? sorted : sorted.map(item => item.val);
+    }
     /**
      * The clear function clears the priority queue.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-structure-typed",
-  "version": "1.19.8",
+  "version": "1.20.0",
   "description": "Javascript & TypeScript Data Structure Library, meticulously crafted to empower developers with a versatile set of essential data structures. Our library includes a wide range of data structures, such as Binary Tree, AVL Tree, Binary Search Tree (BST), Tree Multiset, Segment Tree, Binary Indexed Tree, Graph, Directed Graph, Undirected Graph, Singly Linked List, Hash, CoordinateSet, CoordinateMap, Heap, Doubly Linked List, Priority Queue, Max Priority Queue, Min Priority Queue, Queue, ObjectDeque, ArrayDeque, Stack, and Trie. Each data structure is thoughtfully designed and implemented using TypeScript to provide efficient, reliable, and easy-to-use solutions for your programming needs. Whether you're optimizing algorithms, managing data, or enhancing performance, our TypeScript Data Structure Library is your go-to resource. Elevate your coding experience with these fundamental building blocks for software development.",
   "main": "dist/index.js",
   "scripts": {

package/src/data-structures/heap/heap.ts

@@ -174,6 +174,23 @@ export abstract class Heap<T = number> {
         return isItem ? itemArray : itemArray.map(item => item.val);
     }
 
+    sort(isItem?: undefined): (T | undefined)[];
+    sort(isItem: false): (T | undefined)[];
+    sort(isItem: true): (HeapItem<T> | null)[];
+    /**
+     * The function sorts the elements in the priority queue and returns either the sorted items or their values depending
+     * on the value of the isItem parameter.
+     * @param {boolean} [isItem] - The `isItem` parameter is a boolean flag that indicates whether the sorted result should
+     * be an array of `HeapItem<T>` objects or an array of the values (`T`) of those objects. If `isItem` is `true`, the
+     * sorted result will be an array of `HeapItem
+     * @returns an array of either `HeapItem<T>`, `null`, `T`, or `undefined` values.
+     */
+    sort(isItem?: boolean): (HeapItem<T> | null | T | undefined)[] {
+        isItem = isItem ?? false;
+        const sorted = this._pq.sort();
+        return isItem ? sorted : sorted.map(item => item.val);
+    }
+
     /**
      * The clear function clears the priority queue.
      */