You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**A simple yet powerful data structures library for TypeScript and JavaScript projects.**
7
+
A robust and efficient data structures library.
8
8
9
-
Designed for production environments and scalability, **core-dslib** is a developer's versatile toolbox for projects of any size. It provides essential data structures that enhance the capabilities of TypeScript and JavaScript, filling in the gaps left by the standard libraries.
9
+
## ✨ Features
10
10
11
-
> **Note:** Currently only compatible with ESM projects.
11
+
- 🧰 **Foundational**: Growing collection of essential data structures
12
+
- 🛡️ **Reliable**: Robust stability with 100% test coverage
13
+
- ⚡ **High-Performance**: Optimized for efficiency in demanding applications
14
+
- ⛰️ **Scalable**: Adaptable for projects of any size
15
+
- 🪶 **Lightweight**: Zero dependencies, keeping your project lean
16
+
- 🔷 **TypeScript Native**: Full type safety and intelligent code completion
12
17
13
18
## Table of Contents
14
19
15
-
-[Installation](#installation)
16
-
-[Getting Started](#getting-started)
17
-
-[Data Structures](#data-structures)
18
-
-[Queue](#queue)
19
-
-[Contributing](#contributing)
20
-
-[License](#license)
20
+
-[💡 Why core-dslib?](#-why-core-dslib)
21
+
-[📦 Installation](#-installation)
22
+
-[🚀 Getting Started](#-getting-started)
23
+
-[🏗️ Data Structures](#%EF%B8%8F-data-structures)
24
+
-[🔄 Queue](#-queue)
25
+
-[🌟 Contributing](#-contributing)
26
+
-[⚖️ License](#%EF%B8%8F-license)
27
+
28
+
## 💡 Why core-dslib?
29
+
30
+
`core-dslib` is your go-to toolkit for advanced data structures in TypeScript and JavaScript. It bridges the gap left by standard libraries, empowering developers with the tools they need for efficient data management and manipulation.
31
+
32
+
Whether you're building a complex algorithm or optimizing application performance, `core-dslib` provides the building blocks you need to succeed.
33
+
34
+
> **Note:** Currently only compatible with ESM projects.
21
35
22
-
## Installation
36
+
## 📦 Installation
23
37
24
38
Install the package via npm:
25
39
26
40
```bash
27
41
npm install core-dslib
28
42
```
29
43
30
-
## Getting Started
44
+
## 🚀 Getting Started
31
45
32
46
Import using ESM syntax:
33
47
@@ -43,9 +57,9 @@ queue.enqueue(3);
43
57
console.log(queue.dequeue()); // Output: 3
44
58
```
45
59
46
-
## Data Structures
60
+
## 🏗️ Data Structures
47
61
48
-
### Queue
62
+
### 🔄 Queue
49
63
50
64
Implemented using a circular buffer to ensure efficient enqueue and dequeue operations.
51
65
@@ -54,6 +68,7 @@ Implemented using a circular buffer to ensure efficient enqueue and dequeue oper
54
68
-**Performance:** Enqueue and dequeue operations with amortized O(1) complexity.
55
69
-**Dynamic Resizing:** Automatically resizes to manage memory usage efficiently.
56
70
-**Iterable**: Implements the `Iterable` interface, allowing you to use the queue with `for...of` loops, spread (`...`) syntax and other iterable contexts.
71
+
-**Enhanced Runtime Privacy**: Leverages ES2022 private class fields (`#`) for robust encapsulation, ensuring data privacy during execution.
57
72
-**Type Safety:** Fully typed for TypeScript, ensuring type safety and IntelliSense support.
58
73
-**Versatility:** Suitable for handling numbers, strings, objects, and more.
59
74
@@ -201,7 +216,7 @@ tsx v4.19.1
201
216
node v20.17.0
202
217
```
203
218
204
-
## Contributing
219
+
## 🌟 Contributing
205
220
206
221
Contributions are welcome! If you have ideas, suggestions, or find any issues, please open an [issue](https://github.com/oliviacarlisle/core-dslib/issues) or submit a [pull request](https://github.com/oliviacarlisle/core-dslib/pulls).
207
222
@@ -226,7 +241,7 @@ Run tests:
226
241
npm test
227
242
```
228
243
229
-
## License
244
+
## ⚖️ License
230
245
231
246
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
0 commit comments