ProtoPromise 2.5.0

• .NETCoreApp 2.1

  • Microsoft.Bcl.AsyncInterfaces (>= 6.0.0)

• .NETFramework 3.5

  • No dependencies.

• .NETFramework 4.0

  • No dependencies.

• .NETFramework 4.5

  • System.Threading.Tasks.Extensions (>= 4.5.4)

• .NETFramework 4.7

  • Microsoft.Bcl.AsyncInterfaces (>= 6.0.0)
  • System.Threading.Tasks.Extensions (>= 4.5.4)

• .NETStandard 2.0

  • Microsoft.Bcl.AsyncInterfaces (>= 6.0.0)
  • System.Threading.Tasks.Extensions (>= 4.5.4)

• .NETStandard 2.1

  • No dependencies.

• net5.0

  • No dependencies.

• net6.0

  • No dependencies.

Enhancements:

- Added `AsyncLazy` type.
- Added more async synchronization primitives in the `Proto.Promises.Threading` namespace:
   - `AsyncReaderWriterLock`
   - `AsyncManualResetEvent`
   - `AsyncAutoResetEvent`
   - `AsyncSemaphore`
   - `AsyncCountdownEvent`
   - `AsyncConditionVariable`
- Added `AsyncMonitor.TryEnter(Async)` accepting `CancelationToken` parameter.
- Added APIs to wait for promise result without throwing. These get the result wrapped in `Promise(<T>).ResultContainer`, instead of throwing if the promise was rejected or canceled.
   - `Promise(<T>).AwaitNoThrow()`
   - `Promise(<T>).AwaitWithProgressNoThrow()`.
   - `Promise.(Try)WaitNoThrow`
   - `Promise<T>.(Try)WaitForResultNoThrow`.
- Added `Promise(<T>).ResultContainer.RethrowIfRejectedOrCanceled`.
- Added `Promise.SwitchToForegroundAwait`, `Promise.SwitchToBackgroundAwait`, and `Promise.SwitchToContextAwait` for more efficient context switch in `async` functions.

Optimizations:

- `Promise(<T>).Canceled()` now uses a singleton reference, instead of accessing the object pool/allocating.
- Exposed `Promise.Manager.ThreadStaticSynchronizationContext` for efficient synchronous `WaitAsync`, etc calls.
- Fixed a progress performance degradation when an uncommon race condition occurs.
- Optimized the common case in progress reports.

Fixes:

- Fixed `Promise.All/Merge` progress when a promise is canceled.

Deprecated:

- deprecated `Promise.NewDeferred(CancelationToken)`. Use `Promise.NewDeferred()` and `CancelationToken.Register` to cancel the deferred directly.
- deprecated `Promise.Wait(int)`, `Promise<T>.WaitForResult(int, out T)`, `AsyncMonitor.WaitAsync(AsyncLock.Key, CancelationToken)`. Use methods with `Try`-prefixed of the same name.

Minor Changes:

- `AsyncLock.LockAsync(CancelationToken)` returns a canceled promise if the token is already canceled (and the synchronous version throws `CanceledException`).
- `Promise(<T>).ResultContainer.Rethrow...` now throws the actual exception instead of a `RethrowException`.

Misc:

- Relaxed `Promise(<T>).ResultContainer` from `readonly ref struct` to `readonly struct`.
- Exceptions from `PromiseSynchronizationContext.Send` are now wrapped in `System.Exception` and re-thrown in old runtime.
- Various xml documentation fixes.