Skip to content

Commit 968ed41

Browse files
Merge pull request #20 from oliviacarlisle/dev
Update README
2 parents d86245f + 919626c commit 968ed41

File tree

2 files changed

+34
-16
lines changed

2 files changed

+34
-16
lines changed

README.md

Lines changed: 30 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,30 +4,44 @@
44
[![Build Status](https://github.com/oliviacarlisle/core-dslib/actions/workflows/ci.yml/badge.svg)](https://github.com/oliviacarlisle/core-dslib/actions)
55
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
66

7-
**A simple yet powerful data structures library for TypeScript and JavaScript projects.**
7+
A robust and efficient data structures library.
88

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
1010

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
1217

1318
## Table of Contents
1419

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.
2135
22-
## Installation
36+
## 📦 Installation
2337

2438
Install the package via npm:
2539

2640
```bash
2741
npm install core-dslib
2842
```
2943

30-
## Getting Started
44+
## 🚀 Getting Started
3145

3246
Import using ESM syntax:
3347

@@ -43,9 +57,9 @@ queue.enqueue(3);
4357
console.log(queue.dequeue()); // Output: 3
4458
```
4559

46-
## Data Structures
60+
## 🏗️ Data Structures
4761

48-
### Queue
62+
### 🔄 Queue
4963

5064
Implemented using a circular buffer to ensure efficient enqueue and dequeue operations.
5165

@@ -54,6 +68,7 @@ Implemented using a circular buffer to ensure efficient enqueue and dequeue oper
5468
- **Performance:** Enqueue and dequeue operations with amortized O(1) complexity.
5569
- **Dynamic Resizing:** Automatically resizes to manage memory usage efficiently.
5670
- **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.
5772
- **Type Safety:** Fully typed for TypeScript, ensuring type safety and IntelliSense support.
5873
- **Versatility:** Suitable for handling numbers, strings, objects, and more.
5974

@@ -201,7 +216,7 @@ tsx v4.19.1
201216
node v20.17.0
202217
```
203218

204-
## Contributing
219+
## 🌟 Contributing
205220

206221
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).
207222

@@ -226,7 +241,7 @@ Run tests:
226241
npm test
227242
```
228243

229-
## License
244+
## ⚖️ License
230245

231246
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
232247

package.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "core-dslib",
33
"version": "1.0.0",
4-
"description": "A simple yet powerful data structures library for TypeScript and JavaScript projects.",
4+
"description": "A robust and efficient data structures library.",
55
"type": "module",
66
"scripts": {
77
"test": "jest",
@@ -21,6 +21,9 @@
2121
"enqueue",
2222
"dequeue"
2323
],
24+
"engines": {
25+
"node": ">=20.0.0"
26+
},
2427
"author": "Olivia Carlisle",
2528
"license": "MIT",
2629
"exports": {

0 commit comments

Comments
 (0)