data-structure-typed 1.40.0-rc → 1.41.0

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

@@ -0,0 +1,525 @@
+"use strict";
+/**
+ * data-structure-typed
+ * @author Kirk Qi
+ * @copyright Copyright (c) 2022 Kirk Qi <qilinaus@gmail.com>
+ * @license MIT License
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FibonacciHeap = exports.FibonacciHeapNode = exports.Heap = void 0;
+class Heap {
+    constructor(options) {
+        this._comparator = options.comparator;
+        if (options.nodes && options.nodes.length > 0) {
+            this._nodes = options.nodes;
+            this.fix();
+        }
+    }
+    _nodes = [];
+    get nodes() {
+        return this._nodes;
+    }
+    _comparator;
+    get comparator() {
+        return this._comparator;
+    }
+    /**
+     * Get the size (number of elements) of the heap.
+     */
+    get size() {
+        return this.nodes.length;
+    }
+    /**
+     * Get the last element in the heap, which is not necessarily a leaf node.
+     * @returns The last element or undefined if the heap is empty.
+     */
+    get leaf() {
+        return this.nodes[this.size - 1] ?? undefined;
+    }
+    /**
+     * Static method that creates a binary heap from an array of nodes and a comparison function.
+     * @returns A new Heap instance.
+     * @param options
+     */
+    static heapify(options) {
+        return new Heap(options);
+    }
+    /**
+     * Insert an element into the heap and maintain the heap properties.
+     * @param element - The element to be inserted.
+     */
+    add(element) {
+        return this.push(element);
+    }
+    /**
+     * Insert an element into the heap and maintain the heap properties.
+     * @param element - The element to be inserted.
+     */
+    push(element) {
+        this.nodes.push(element);
+        this.bubbleUp(this.nodes.length - 1);
+        return this;
+    }
+    /**
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @returns The top element or undefined if the heap is empty.
+     */
+    poll() {
+        if (this.nodes.length === 0) {
+            return undefined;
+        }
+        if (this.nodes.length === 1) {
+            return this.nodes.pop();
+        }
+        const topValue = this.nodes[0];
+        this.nodes[0] = this.nodes.pop();
+        this.sinkDown(0);
+        return topValue;
+    }
+    /**
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @returns The top element or undefined if the heap is empty.
+     */
+    pop() {
+        return this.poll();
+    }
+    /**
+     * Peek at the top element of the heap without removing it.
+     * @returns The top element or undefined if the heap is empty.
+     */
+    peek() {
+        if (this.nodes.length === 0) {
+            return undefined;
+        }
+        return this.nodes[0];
+    }
+    /**
+     * Check if the heap is empty.
+     * @returns True if the heap is empty, otherwise false.
+     */
+    isEmpty() {
+        return this.size === 0;
+    }
+    /**
+     * Reset the nodes of the heap. Make the nodes empty.
+     */
+    clear() {
+        this._nodes = [];
+    }
+    /**
+     * Clear and add nodes of the heap
+     * @param nodes
+     */
+    refill(nodes) {
+        this._nodes = nodes;
+        this.fix();
+    }
+    /**
+     * Use a comparison function to check whether a binary heap contains a specific element.
+     * @param element - the element to check.
+     * @returns Returns true if the specified element is contained; otherwise, returns false.
+     */
+    has(element) {
+        return this.nodes.includes(element);
+    }
+    /**
+     * Depth-first search (DFS) method, different traversal orders can be selected。
+     * @param order - Traverse order parameter: 'in' (in-order), 'pre' (pre-order) or 'post' (post-order).
+     * @returns An array containing elements traversed in the specified order.
+     */
+    dfs(order) {
+        const result = [];
+        // Auxiliary recursive function, traverses the binary heap according to the traversal order
+        const dfsHelper = (index) => {
+            if (index < this.size) {
+                if (order === 'in') {
+                    dfsHelper(2 * index + 1);
+                    result.push(this.nodes[index]);
+                    dfsHelper(2 * index + 2);
+                }
+                else if (order === 'pre') {
+                    result.push(this.nodes[index]);
+                    dfsHelper(2 * index + 1);
+                    dfsHelper(2 * index + 2);
+                }
+                else if (order === 'post') {
+                    dfsHelper(2 * index + 1);
+                    dfsHelper(2 * index + 2);
+                    result.push(this.nodes[index]);
+                }
+            }
+        };
+        dfsHelper(0); // Traverse starting from the root node
+        return result;
+    }
+    /**
+     * Convert the heap to an array.
+     * @returns An array containing the elements of the heap.
+     */
+    toArray() {
+        return [...this.nodes];
+    }
+    getNodes() {
+        return this.nodes;
+    }
+    /**
+     * Clone the heap, creating a new heap with the same elements.
+     * @returns A new Heap instance containing the same elements.
+     */
+    clone() {
+        const clonedHeap = new Heap({ comparator: this.comparator });
+        clonedHeap._nodes = [...this.nodes];
+        return clonedHeap;
+    }
+    /**
+     * Sort the elements in the heap and return them as an array.
+     * @returns An array containing the elements sorted in ascending order.
+     */
+    sort() {
+        const visitedNode = [];
+        const cloned = this.clone();
+        while (cloned.size !== 0) {
+            const top = cloned.poll();
+            if (top)
+                visitedNode.push(top);
+        }
+        return visitedNode;
+    }
+    /**
+     * Float operation to maintain heap properties after adding an element.
+     * @param index - The index of the newly added element.
+     */
+    bubbleUp(index) {
+        const element = this.nodes[index];
+        while (index > 0) {
+            const parentIndex = Math.floor((index - 1) / 2);
+            const parent = this.nodes[parentIndex];
+            if (this.comparator(element, parent) < 0) {
+                this.nodes[index] = parent;
+                this.nodes[parentIndex] = element;
+                index = parentIndex;
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /**
+     * Sinking operation to maintain heap properties after removing the top element.
+     * @param index - The index from which to start sinking.
+     */
+    sinkDown(index) {
+        const leftChildIndex = 2 * index + 1;
+        const rightChildIndex = 2 * index + 2;
+        const length = this.nodes.length;
+        let targetIndex = index;
+        if (leftChildIndex < length && this.comparator(this.nodes[leftChildIndex], this.nodes[targetIndex]) < 0) {
+            targetIndex = leftChildIndex;
+        }
+        if (rightChildIndex < length && this.comparator(this.nodes[rightChildIndex], this.nodes[targetIndex]) < 0) {
+            targetIndex = rightChildIndex;
+        }
+        if (targetIndex !== index) {
+            const temp = this.nodes[index];
+            this.nodes[index] = this.nodes[targetIndex];
+            this.nodes[targetIndex] = temp;
+            this.sinkDown(targetIndex);
+        }
+    }
+    /**
+     * Fix the entire heap to maintain heap properties.
+     */
+    fix() {
+        for (let i = Math.floor(this.size / 2); i >= 0; i--)
+            this.sinkDown(i);
+    }
+}
+exports.Heap = Heap;
+class FibonacciHeapNode {
+    element;
+    degree;
+    left;
+    right;
+    child;
+    parent;
+    marked;
+    constructor(element, degree = 0) {
+        this.element = element;
+        this.degree = degree;
+        this.marked = false;
+    }
+}
+exports.FibonacciHeapNode = FibonacciHeapNode;
+class FibonacciHeap {
+    constructor(comparator) {
+        this.clear();
+        this._comparator = comparator || this.defaultComparator;
+        if (typeof this.comparator !== 'function') {
+            throw new Error('FibonacciHeap constructor: given comparator should be a function.');
+        }
+    }
+    _root;
+    get root() {
+        return this._root;
+    }
+    _size = 0;
+    get size() {
+        return this._size;
+    }
+    _min;
+    get min() {
+        return this._min;
+    }
+    _comparator;
+    get comparator() {
+        return this._comparator;
+    }
+    /**
+     * Get the size (number of elements) of the heap.
+     * @returns {number} The size of the heap.  Returns 0 if the heap is empty. Returns -1 if the heap is invalid.
+     */
+    clear() {
+        this._root = undefined;
+        this._min = undefined;
+        this._size = 0;
+    }
+    /**
+     * O(1) time operation.
+     * Insert an element into the heap and maintain the heap properties.
+     * @param element
+     * @returns {FibonacciHeap<E>} FibonacciHeap<E> - The heap itself.
+     */
+    add(element) {
+        return this.push(element);
+    }
+    /**
+     * O(1) time operation.
+     * Insert an element into the heap and maintain the heap properties.
+     * @param element
+     * @returns {FibonacciHeap<E>} FibonacciHeap<E> - The heap itself.
+     */
+    push(element) {
+        const node = this.createNode(element);
+        node.left = node;
+        node.right = node;
+        this.mergeWithRoot(node);
+        if (!this.min || this.comparator(node.element, this.min.element) <= 0) {
+            this._min = node;
+        }
+        this._size++;
+        return this;
+    }
+    /**
+     * O(1) time operation.
+     * Peek at the top element of the heap without removing it.
+     * @returns The top element or undefined if the heap is empty.
+     * @protected
+     */
+    peek() {
+        return this.min ? this.min.element : undefined;
+    }
+    /**
+     * O(1) time operation.
+     * Get the size (number of elements) of the heap.
+     * @param {FibonacciHeapNode<E>} head - The head of the linked list.
+     * @protected
+     * @returns FibonacciHeapNode<E>[] - An array containing the nodes of the linked list.
+     */
+    consumeLinkedList(head) {
+        const nodes = [];
+        if (!head)
+            return nodes;
+        let node = head;
+        let flag = false;
+        while (true) {
+            if (node === head && flag)
+                break;
+            else if (node === head)
+                flag = true;
+            if (node) {
+                nodes.push(node);
+                node = node.right;
+            }
+        }
+        return nodes;
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @param parent
+     * @param node
+     */
+    mergeWithChild(parent, node) {
+        if (!parent.child) {
+            parent.child = node;
+        }
+        else {
+            node.right = parent.child.right;
+            node.left = parent.child;
+            parent.child.right.left = node;
+            parent.child.right = node;
+        }
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @returns The top element or undefined if the heap is empty.
+     */
+    poll() {
+        return this.pop();
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @returns The top element or undefined if the heap is empty.
+     */
+    pop() {
+        if (this.size === 0)
+            return undefined;
+        const z = this.min;
+        if (z.child) {
+            const nodes = this.consumeLinkedList(z.child);
+            for (const node of nodes) {
+                this.mergeWithRoot(node);
+                node.parent = undefined;
+            }
+        }
+        this.removeFromRoot(z);
+        if (z === z.right) {
+            this._min = undefined;
+            this._root = undefined;
+        }
+        else {
+            this._min = z.right;
+            this.consolidate();
+        }
+        this._size--;
+        return z.element;
+    }
+    /**
+     * O(log n) time operation.
+     * merge two heaps. The heap that is merged will be cleared. The heap that is merged into will remain.
+     * @param heapToMerge
+     */
+    merge(heapToMerge) {
+        if (heapToMerge.size === 0) {
+            return; // Nothing to merge
+        }
+        // Merge the root lists of the two heaps
+        if (this.root && heapToMerge.root) {
+            const thisRoot = this.root;
+            const otherRoot = heapToMerge.root;
+            const thisRootRight = thisRoot.right;
+            const otherRootLeft = otherRoot.left;
+            thisRoot.right = otherRoot;
+            otherRoot.left = thisRoot;
+            thisRootRight.left = otherRootLeft;
+            otherRootLeft.right = thisRootRight;
+        }
+        // Update the minimum node
+        if (!this.min || (heapToMerge.min && this.comparator(heapToMerge.min.element, this.min.element) < 0)) {
+            this._min = heapToMerge.min;
+        }
+        // Update the size
+        this._size += heapToMerge.size;
+        // Clear the heap that was merged
+        heapToMerge.clear();
+    }
+    /**
+     * Default comparator function used by the heap.
+     * @param {E} a
+     * @param {E} b
+     * @protected
+     */
+    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);
+    }
+    /**
+     * Merge the given node with the root list.
+     * @param node - The node to be merged.
+     */
+    mergeWithRoot(node) {
+        if (!this.root) {
+            this._root = node;
+        }
+        else {
+            node.right = this.root.right;
+            node.left = this.root;
+            this.root.right.left = node;
+            this.root.right = node;
+        }
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @param node - The node to be removed.
+     * @protected
+     */
+    removeFromRoot(node) {
+        if (this.root === node)
+            this._root = node.right;
+        if (node.left)
+            node.left.right = node.right;
+        if (node.right)
+            node.right.left = node.left;
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @param y
+     * @param x
+     * @protected
+     */
+    link(y, x) {
+        this.removeFromRoot(y);
+        y.left = y;
+        y.right = y;
+        this.mergeWithChild(x, y);
+        x.degree++;
+        y.parent = x;
+    }
+    /**
+     * O(log n) time operation.
+     * Remove and return the top element (smallest or largest element) from the heap.
+     * @protected
+     */
+    consolidate() {
+        const A = new Array(this.size);
+        const nodes = this.consumeLinkedList(this.root);
+        let x, y, d, t;
+        for (const node of nodes) {
+            x = node;
+            d = x.degree;
+            while (A[d]) {
+                y = A[d];
+                if (this.comparator(x.element, y.element) > 0) {
+                    t = x;
+                    x = y;
+                    y = t;
+                }
+                this.link(y, x);
+                A[d] = undefined;
+                d++;
+            }
+            A[d] = x;
+        }
+        for (let i = 0; i < this.size; i++) {
+            if (A[i] && this.comparator(A[i].element, this.min.element) <= 0) {
+                this._min = A[i];
+            }
+        }
+    }
+}
+exports.FibonacciHeap = FibonacciHeap;

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

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./max-heap"), exports);
+__exportStar(require("./min-heap"), exports);
+__exportStar(require("./heap"), exports);

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

@@ -0,0 +1,15 @@
+/**
+ * data-structure-typed
+ *
+ * @author Kirk Qi
+ * @copyright Copyright (c) 2022 Kirk Qi <qilinaus@gmail.com>
+ * @license MIT License
+ */
+import { Heap } from './heap';
+import type { Comparator } from '../../types';
+export declare class MaxHeap<E = any> extends Heap<E> {
+    constructor(options?: {
+        comparator: Comparator<E>;
+        nodes?: E[];
+    });
+}

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

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * data-structure-typed
+ *
+ * @author Kirk Qi
+ * @copyright Copyright (c) 2022 Kirk Qi <qilinaus@gmail.com>
+ * @license MIT License
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxHeap = void 0;
+const heap_1 = require("./heap");
+class MaxHeap extends heap_1.Heap {
+    constructor(options = {
+        comparator: (a, b) => {
+            if (!(typeof a === 'number' && typeof b === 'number')) {
+                throw new Error('The a, b params of compare function must be number');
+            }
+            else {
+                return b - a;
+            }
+        }
+    }) {
+        super(options);
+    }
+}
+exports.MaxHeap = MaxHeap;

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

@@ -0,0 +1,15 @@
+/**
+ * data-structure-typed
+ *
+ * @author Kirk Qi
+ * @copyright Copyright (c) 2022 Kirk Qi <qilinaus@gmail.com>
+ * @license MIT License
+ */
+import { Heap } from './heap';
+import type { Comparator } from '../../types';
+export declare class MinHeap<E = any> extends Heap<E> {
+    constructor(options?: {
+        comparator: Comparator<E>;
+        nodes?: E[];
+    });
+}

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

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * data-structure-typed
+ *
+ * @author Kirk Qi
+ * @copyright Copyright (c) 2022 Kirk Qi <qilinaus@gmail.com>
+ * @license MIT License
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinHeap = void 0;
+const heap_1 = require("./heap");
+class MinHeap extends heap_1.Heap {
+    constructor(options = {
+        comparator: (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;
+            }
+        }
+    }) {
+        super(options);
+    }
+}
+exports.MinHeap = MinHeap;

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

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./hash"), exports);
+__exportStar(require("./linked-list"), exports);
+__exportStar(require("./stack"), exports);
+__exportStar(require("./queue"), exports);
+__exportStar(require("./graph"), exports);
+__exportStar(require("./binary-tree"), exports);
+__exportStar(require("./tree"), exports);
+__exportStar(require("./heap"), exports);
+__exportStar(require("./priority-queue"), exports);
+__exportStar(require("./matrix"), exports);
+__exportStar(require("./trie"), exports);