@dmop/puru 0.1.0 → 0.1.2

package/README.md

@@ -1,27 +1,27 @@
 # puru (プール)
 
-Goroutine-style concurrency for JavaScript with an **M:N scheduler** — multiplexes thousands of tasks onto a small pool of OS threads, just like Go.
+A thread pool with Go-style concurrency primitives for JavaScript — spawn tasks off the main thread with channels, WaitGroup, select, and more. No worker files, no boilerplate.
 
-Works on **Node.js** and **Bun**. No separate worker files, no manual message passing.
+Works on **Node.js** and **Bun**.
 
 *puru (プール) means "pool" in Japanese.*
 
 ## Install
 
 ```bash
-npm install puru
+npm install @dmop/puru
 ```
 
 ## Quick Start
 
 ```typescript
-import { spawn, chan, WaitGroup, select, after } from 'puru'
+import { spawn, chan, WaitGroup, select, after } from '@dmop/puru'
 
 // CPU work — runs in a dedicated worker thread
 const { result } = spawn(() => fibonacci(40))
 console.log(await result)
 
-// I/O work — many tasks share worker threads (M:N scheduling)
+// I/O work — many tasks share worker threads
 const wg = new WaitGroup()
 for (const url of urls) {
   wg.spawn(() => fetch(url).then(r => r.json()), { concurrent: true })
@@ -31,10 +31,10 @@ const results = await wg.wait()
 
 ## How It Works
 
-puru uses an **M:N scheduler** — M tasks are multiplexed onto N OS threads:
+puru manages a **thread pool** — tasks are dispatched onto a fixed set of worker threads:
 
 ```text
-              puru scheduler
+              puru thread pool
     ┌──────────────────────────────┐
     │                              │
     │   Task 1 ─┐                  │
@@ -58,7 +58,7 @@ puru uses an **M:N scheduler** — M tasks are multiplexed onto N OS threads:
 | **Exclusive** (default) | `spawn(fn)` | CPU-bound work | 1 task per thread, full core usage |
 | **Concurrent** | `spawn(fn, { concurrent: true })` | I/O-bound / async work | Many tasks share a thread's event loop |
 
-This is the same model Go uses: goroutines (M) are scheduled onto OS threads (N). CPU-bound work gets a dedicated thread. I/O-bound work shares threads efficiently.
+CPU-bound work gets a dedicated thread. I/O-bound work shares threads efficiently. The API is inspired by Go's concurrency primitives (channels, WaitGroup, select), but the underlying mechanism is a thread pool — not a green thread scheduler.
 
 ## Why puru
 
@@ -112,7 +112,7 @@ const results = await Promise.all(items.map(item => pool.run(item)))
 **puru** — one file, 4 lines:
 
 ```typescript
-import { WaitGroup } from 'puru'
+import { WaitGroup } from '@dmop/puru'
 const wg = new WaitGroup()
 for (const item of items) wg.spawn(() => heavyWork(item))
 const results = await wg.wait()
@@ -122,7 +122,7 @@ const results = await wg.wait()
 | --- | --- | --- | --- | --- |
 | Separate worker file | Required | Required | Required | **Not needed** |
 | Inline functions | No | No | No | **Yes** |
-| M:N scheduler | No | No | No | **Yes** |
+| Managed thread pool | No | No | No | **Yes** |
 | Concurrent mode (I/O) | No | No | No | **Yes** |
 | Channels (cross-thread) | No | No | No | **Yes** |
 | Cancellation | No | No | No | **Yes** |
@@ -188,7 +188,7 @@ for await (const value of ch) {
 }
 ```
 
-**Channels in workers** — pass channels to `spawn()` and use them from worker threads, just like Go:
+**Channels in workers** — pass channels to `spawn()` and use them across worker threads:
 
 ```typescript
 const ch = chan<number>(10)
@@ -375,7 +375,7 @@ npm run bench:bun      # all benchmarks (Bun)
 | Main-thread channels only | 174 ms | 1.0x |
 | **puru fan-out (4 workers)** | **51 ms** | **3.4x faster** |
 
-### M:N Concurrent Async (Node.js)
+### Concurrent Async (Node.js)
 
 100 async tasks with simulated I/O + CPU:
 
@@ -383,7 +383,7 @@ npm run bench:bun      # all benchmarks (Bun)
 | --- | --: | --: |
 | Sequential | 1,140 ms | baseline |
 | Promise.all (main thread) | 20 ms | 58x faster |
-| **puru concurrent (M:N)** | **16 ms** | **73x faster** |
+| **puru concurrent** | **16 ms** | **73x faster** |
 
 Both Promise.all and puru concurrent are fast — but puru runs everything **off the main thread**, keeping your server responsive under load.
 
@@ -401,7 +401,7 @@ Both Promise.all and puru concurrent are fast — but puru runs everything **off
 ## Testing
 
 ```typescript
-import { configure } from 'puru'
+import { configure } from '@dmop/puru'
 configure({ adapter: 'inline' }) // runs tasks in main thread, no real workers
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dmop/puru",
-  "version": "0.1.0",
-  "description": "puru (プール) — Goroutine-style concurrency for JavaScript",
+  "version": "0.1.2",
+  "description": "puru (プール) — A thread pool with Go-style concurrency primitives for JavaScript",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",