images removed, heap docs revised

This commit is contained in:
Revone 2023-08-31 00:50:23 +08:00
parent 60e5824524
commit bd71edc536
21 changed files with 49 additions and 28 deletions

View file

@ -1,31 +1,27 @@
# What
## Brief
Javascript & TypeScript Data Structure Library.
Javascript & TypeScript Data Structure collections.
Binary Tree, Binary Search Tree (BST), AVL Tree, Tree Multiset, Segment Tree, Binary Indexed Tree, Graph, Directed Graph, Undirected Graph, Linked List, Singly Linked List, Doubly Linked List, Queue, Object Deque, Array Deque, Stack, Hash, Coordinate Set, Coordinate Map, Heap, Priority Queue, Max Priority Queue, Min Priority Queue, Trie
## Algorithms
## Algorithms list only a few out, you can discover more in API docs
DFS, DFSIterative, BFS, morris, Bellman-Ford Algorithm, Dijkstra's Algorithm, Floyd-Warshall Algorithm, Tarjan's Algorithm
DFS, DFSIterative, BFS, morris, Bellman-Ford Algorithm, Dijkstra's Algorithm, Floyd-Warshall Algorithm, Tarjan's Algorithm. Listed only a few out, you can discover more in API docs
## Code design
By strictly adhering to object-oriented design (BinaryTree -> BST -> AVLTree -> TreeMultiset), you can seamlessly inherit the existing data structures to implement the customized ones you need. Object-oriented design stands as the optimal approach to data structure design.
# How
### npm
```bash
npm install data-structure-typed
```
## install
### yarn
```bash
yarn add data-structure-typed
```
### npm
```bash
npm install data-structure-typed
```
### Binary Search Tree (BST) snippet

View file

@ -1,6 +1,6 @@
{
"name": "data-structure-typed",
"version": "1.19.5",
"version": "1.19.7",
"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": {
@ -65,9 +65,9 @@
"typescript": "^4.9.5"
},
"dependencies": {
"avl-tree-typed": "^1.19.5",
"bst-typed": "^1.19.5",
"heap-typed": "^1.19.5",
"avl-tree-typed": "^1.19.6",
"bst-typed": "^1.19.6",
"heap-typed": "^1.19.6",
"zod": "^3.22.2"
}
}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 233 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 274 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.3 MiB

View file

@ -170,7 +170,6 @@ export abstract class AbstractGraph<V extends AbstractVertex<any>, E extends Abs
addVertex(idOrVertex: VertexId | V, val?: V['val']): boolean {
if (idOrVertex instanceof AbstractVertex) {
return this._addVertexOnly(idOrVertex);
} else {
const newVertex = this.createVertex(idOrVertex, val);
return this._addVertexOnly(newVertex);

Binary file not shown.

Before

Width:  |  Height:  |  Size: 319 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 283 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 309 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 472 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 398 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 287 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 496 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 558 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 470 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.8 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.4 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.8 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.1 MiB

View file

@ -44,9 +44,9 @@ export class HeapItem<T = number> {
}
export abstract class Heap<T = number> {
/**
* The function is a constructor for a class that initializes a priority callback function based on the
* options provided.
* The constructor function initializes a priority queue with an optional priority extractor function.
* @param [options] - An optional object that contains configuration options for the Heap.
*/
protected constructor(options?: HeapOptions<T>) {
@ -91,9 +91,16 @@ export abstract class Heap<T = number> {
peek(isItem?: undefined): T | undefined;
peek(isItem: false): T | undefined;
peek(isItem: true): HeapItem<T> | null;
/**
* The `peek` function returns the top item in the priority queue without removing it.
* @returns The `peek()` method is returning either a `HeapItem<T>` object or `null`.Returns an val with the highest priority in the queue
* The `peek` function returns the top item or value in a priority queue, depending on the value of the `isItem`
* parameter.
* @param {boolean} [isItem] - The `isItem` parameter is an optional boolean parameter that determines whether the
* method should return the entire `HeapItem` object or just the value of the item. If `isItem` is set to `true`, the
* method will return the `HeapItem` object. If `isItem`
* @returns The `peek` method returns either a `HeapItem<T>` object, `null`, `T`, or `undefined`. The specific return
* type depends on the value of the `isItem` parameter. If `isItem` is `true`, then the method returns a `HeapItem<T>`
* object or `null` if the heap is empty. If `isItem` is `false`
*/
peek(isItem?: boolean): HeapItem<T> | null | T | undefined {
isItem = isItem ?? false;
@ -104,9 +111,16 @@ export abstract class Heap<T = number> {
peekLast(isItem?: undefined): T | undefined;
peekLast(isItem: false): T | undefined;
peekLast(isItem: true): HeapItem<T> | null;
/**
* The `peekLast` function returns the last item in the heap.
* @returns The method `peekLast()` returns either a `HeapItem<T>` object or `null`.Returns an val with the lowest priority in the queue
* The `peekLast` function returns the last item in the heap, either as a `HeapItem` object or just the value depending
* on the `isItem` parameter.
* @param {boolean} [isItem] - A boolean parameter that indicates whether the method should return the HeapItem object
* or just the value of the last item in the heap. If isItem is true, the method will return the HeapItem object. If
* isItem is false or not provided, the method will return the value of the last item
* @returns The method `peekLast` returns either a `HeapItem<T>` object, `null`, `T`, or `undefined`. The specific
* return type depends on the value of the `isItem` parameter. If `isItem` is `true`, then the method returns a
* `HeapItem<T>` object or `null` if there are no items in the heap. If `isItem`
*/
peekLast(isItem?: boolean): HeapItem<T> | null | T | undefined {
isItem = isItem ?? false;
@ -133,9 +147,15 @@ export abstract class Heap<T = number> {
poll(isItem?: undefined): T | undefined;
poll(isItem: false): T | undefined;
poll(isItem: true): HeapItem<T> | null;
/**
* The `poll` function returns the top item from a priority queue or null if the queue is empty.Removes and returns an val with the highest priority in the queue
* @returns either a HeapItem<T> object or null.
* The `poll` function returns the top item from a priority queue, either as a HeapItem object or its value, depending
* on the value of the `isItem` parameter.
* @param {boolean} [isItem] - The `isItem` parameter is a boolean flag that indicates whether the returned value
* should be a `HeapItem<T>` object or just the value `T` itself. If `isItem` is `true`, the method will return the
* `HeapItem<T>` object, otherwise it will return just
* @returns The function `poll` returns either a `HeapItem<T>` object, `null`, or `T` (the value of the `val` property
* of the `HeapItem<T>` object).
*/
poll(isItem?: boolean): HeapItem<T> | null | T | undefined {
isItem = isItem ?? false;
@ -147,8 +167,8 @@ export abstract class Heap<T = number> {
}
/**
* The function checks if a given node or value exists in the priority queue.
* @param {T | HeapItem<T>} node - The parameter `node` can be of type `T` or `HeapItem<T>`.
* The `has` function checks if a given node or value exists in the priority queue.
* @param {T | HeapItem<T>} node - The `node` parameter can be of type `T` or `HeapItem<T>`.
* @returns a boolean value.
*/
has(node: T | HeapItem<T>): boolean {
@ -164,9 +184,15 @@ export abstract class Heap<T = number> {
toArray(isItem?: undefined): (T | undefined)[];
toArray(isItem: false): (T | undefined)[];
toArray(isItem: true): (HeapItem<T> | null)[];
/**
* The `toArray` function returns an array of `HeapItem<T>` objects.
* @returns An array of HeapItem<T> objects.Returns a sorted list of vals
* The `toArray` function returns an array of either HeapItem objects or their values, depending on the value of the
* `isItem` parameter.
* @param {boolean} [isItem] - isItem is an optional boolean parameter that determines whether the returned array
* should contain the HeapItem objects or just the values of the HeapItem objects. If isItem is true, the array will
* contain the HeapItem objects. If isItem is false or not provided, the array will contain only the values
* @returns The method `toArray` returns an array of `HeapItem<T>` objects, or an array of `T` values if the `isItem`
* parameter is set to `false`.
*/
toArray(isItem?: boolean): (HeapItem<T> | null | T | undefined)[] {
isItem = isItem ?? false;