happy-rusty 1.9.1 → 1.10.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.10.0] - 2026-06-30
+
+### Added
+- **New Sync Primitive**: `Semaphore` - Counting semaphore for limiting async concurrency, with `acquire`/`tryAcquire`/`withPermit`/`availablePermits`. Inspired by tokio's `Semaphore` (Rust std does not include one). Useful for fetch rate limiting, connection pools, and task queues.
+- **New Method**: `RwLockWriteGuard.downgrade()` - Atomically converts a write guard to a read guard, releasing waiting readers while keeping pending writers waiting. Equivalent to Rust 1.92's `RwLockWriteGuard::downgrade`
+
+### Chores
+- Upgraded devDependencies: vite, vitest, @vitest/coverage-v8, @vitest/ui, eslint, rollup, typescript-eslint
+
+## [1.9.2] - 2026-04-12
+
+### Changed
+- **Performance**: Added `/*#__PURE__*/` annotations to all top-level function call expressions for better tree-shaking support in consumer bundlers
+
+### Fixed
+- **Build**: Migrated `treeshake` config from deprecated `'smallest'` string to object form for Vite 8 (Rolldown) compatibility
+- **Build**: Added `topLevelVar: false` to output options to preserve `const` declarations in bundled output
+
+### Chores
+- Upgraded devDependencies: vite, vitest, eslint, typedoc, typescript-eslint
+
 ## [1.9.1] - 2026-01-16
 
 ### Changed
@@ -282,6 +303,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Full TypeScript support
 - Comprehensive API matching Rust's Option and Result
 
+[1.10.0]: https://github.com/JiangJie/happy-rusty/compare/v1.9.2...v1.10.0
+[1.9.2]: https://github.com/JiangJie/happy-rusty/compare/v1.9.1...v1.9.2
 [1.9.1]: https://github.com/JiangJie/happy-rusty/compare/v1.9.0...v1.9.1
 [1.9.0]: https://github.com/JiangJie/happy-rusty/compare/v1.8.0...v1.9.0
 [1.8.0]: https://github.com/JiangJie/happy-rusty/compare/v1.7.1...v1.8.0

package/README.md

@@ -20,7 +20,7 @@ Rust's `Option`, `Result`, and sync primitives for JavaScript/TypeScript - Bette
 
 - **Option<T>** - Represents an optional value: every `Option` is either `Some(T)` or `None`
 - **Result<T, E>** - Represents either success (`Ok(T)`) or failure (`Err(E)`)
-- **Sync Primitives** - Rust-inspired `Once<T>`, `OnceAsync<T>`, `Lazy<T>`, `LazyAsync<T>`, `Mutex<T>`, `RwLock<T>`, and `Channel<T>`
+- **Sync Primitives** - Rust-inspired `Once<T>`, `OnceAsync<T>`, `Lazy<T>`, `LazyAsync<T>`, `Mutex<T>`, `RwLock<T>`, `Semaphore`, and `Channel<T>`
 - **Control Flow** - `ControlFlow<B, C>` with `Break` and `Continue` for short-circuiting operations
 - **FnOnce** - One-time callable function wrappers (`FnOnce` and `FnOnceAsync`)
 - **Full TypeScript support** with strict type inference
@@ -137,7 +137,7 @@ const response = await tryAsyncResult(fetch, '/api/data');
 ### Sync Primitives
 
 ```ts
-import { Lazy, LazyAsync, Mutex, Channel } from 'happy-rusty';
+import { Lazy, LazyAsync, Mutex, Semaphore, Channel } from 'happy-rusty';
 
 // Lazy - compute once on first access
 const expensive = Lazy(() => computeExpensiveValue());
@@ -151,6 +151,10 @@ await db.force();  // Only one connection, concurrent calls wait
 const state = Mutex({ count: 0 });
 await state.withLock(async (s) => { s.count += 1; });
 
+// Semaphore - limit async concurrency (e.g. fetch rate limiting)
+const sem = Semaphore(10);
+await sem.withPermit(() => fetch(url));
+
 // Channel - MPMC async message passing
 const ch = Channel<string>(10);  // bounded capacity
 await ch.send('hello');
@@ -165,6 +169,7 @@ for await (const msg of ch) { console.log(msg); }
 - [Lazy](examples/std/sync/lazy.ts) / [LazyAsync](examples/std/sync/lazy_async.ts)
 - [Mutex](examples/std/sync/mutex.ts)
 - [RwLock](examples/std/sync/rwlock.ts)
+- [Semaphore](examples/std/sync/semaphore.ts)
 - [Channel](examples/std/sync/channel.ts)
 - [ControlFlow](examples/std/ops/control_flow.ts)
 - [FnOnce](examples/std/ops/fn_once.ts) / [FnOnceAsync](examples/std/ops/fn_once_async.ts)
@@ -173,7 +178,7 @@ for await (const msg of ch) { console.log(msg); }
 
 ### Immutability
 
-All types (`Option`, `Result`, `ControlFlow`, `Lazy`, `LazyAsync`, `Once`, `OnceAsync`, `Mutex`, `MutexGuard`, `RwLock`, `Channel`, `Sender`, `Receiver`, `FnOnce`, `FnOnceAsync`) are **immutable at runtime** via `Object.freeze()`. This prevents accidental modification of methods or properties:
+All types (`Option`, `Result`, `ControlFlow`, `Lazy`, `LazyAsync`, `Once`, `OnceAsync`, `Mutex`, `MutexGuard`, `RwLock`, `Semaphore`, `SemaphorePermit`, `Channel`, `Sender`, `Receiver`, `FnOnce`, `FnOnceAsync`) are **immutable at runtime** via `Object.freeze()`. This prevents accidental modification of methods or properties:
 
 ```ts
 const some = Some(42);