dahlia-concurrency/README.md

High-level concurrency primitives and patterns for Node.js using worker_threads (queues, semaphore, mutex, worker pool, scheduler, and more)

# Dahlia Concurrency — Documentation

Lightweight concurrency and parallelism toolkit for Node.js built on `worker_threads`.

- Repository: https://github.com/hhuziuk/dahlia
- npm: https://www.npmjs.com/package/dahlia-concurrency

## What’s inside
- Primitives: `Mutex`, `RwLock`, `CountingSemaphore`, `BinarySemaphore`, `WorkerPool`
- Data structures: `ConcurrentQueue`, `ConcurrentPriorityQueue`, `ConcurrentDeque`, `ConcurrentStack`, `ConcurrentSet`
- Methods: `parallelPipeline(...)`, `parallelQuickSort(...)` and quick-sort utilities
- Task scheduler: `Scheduler`

## Install
```bash
npm install dahlia-concurrency
```

## Quick start
```js
const {
  Mutex,
  WorkerPool,
  Scheduler,
  ConcurrentQueue,
  parallelPipeline,
} = require('dahlia-concurrency');

const mutex = new Mutex();
const q = new ConcurrentQueue();
q.enqueue(1); q.enqueue(2);

const pool = new WorkerPool(2, require('node:path').resolve(__dirname, 'worker.js'));

const scheduler = new Scheduler(2, require('node:path').resolve(__dirname, 'handlers.js'));
scheduler.start();
```

## Documentation
- [Primitives](./docs/primitives.md)
- [Data structures](./docs/data-structures.md)
- [Methods](./docs/methods.md)
- [Task Scheduler](./docs/task-scheduler.md)
- [Contracts](./docs/contracts.md)
- [Testing and contributing](./docs/testing-and-contributing.md)
- [Benchmarks](./docs/benchmarks.md)