ProtoPromise 3.3.0

• .NETStandard 2.0

  • Microsoft.Bcl.HashCode (>= 6.0.0)
  • Microsoft.Bcl.TimeProvider (>= 8.0.1)
  • ProtoPromise.Analyzer (>= 1.0.0)
  • System.Buffers (>= 4.6.0)
  • System.Memory (>= 4.6.0)
  • System.Threading.Tasks.Extensions (>= 4.6.0)

• .NETStandard 2.1

  • Microsoft.Bcl.TimeProvider (>= 8.0.1)
  • ProtoPromise.Analyzer (>= 1.0.0)

• net6.0

  • Microsoft.Bcl.TimeProvider (>= 8.0.1)
  • ProtoPromise.Analyzer (>= 1.0.0)

• net8.0

  • ProtoPromise.Analyzer (>= 1.0.0)

Enhancements:

- Added `Proto.Timers`.
- `Timer` and `TimerFactory`
- Added `Promise.Delay` APIs.
- Added `Promise(<T>).WaitAsync` APIs with timeouts.
- Added delayed cancelation APIs to `CancelationSource`.
- `CancelationSource.New(TimeSpan, (optional) TimerFactory, (optional) linked token(s))`
- `CancelationSource.CancelAfter(TimeSpan)`
- Added `CancelationToken(bool)` constructor.
- Added `CancelationToken.RegisterWithoutImmediateInvoke` APIs.

Optimizations:

- `Promise(<T>).ConfigureAwait(ContinuationOptions)` consumes zero memory if `Promise.Config.AsyncFlowExecutionContextEnabled` is disabled (which is the default state).
- Reduced memory of `async Promise(<T>)`.
- Reduced memory of async synchronization primitives
- Reduced memory of `Promise.ParallelFor*` APIs.
- Reduced memory of `Channel`s.
- Optimized object pool contention.
- Internally avoid cost of zeroing types that contain no references.
- Split `Promise(<T>).ContinueWith` methods without a `CancelationToken` parameter to avoid the cost of the token when it's not needed.
- Reduced memory and increased speed of `AsyncLazy<T>` when the factory is invoked.
- No longer pool memory allocated from `AsyncLazy<T>`.

Deprecated:

- `Promise(<T>).{Then, Catch, CatchCancelation}` APIs accepting a `CancelationToken` parameter. (Prefer `WaitAsync` followed by the same API without the token.)
- Deprecated `CancelationSource.{IsValid, TryCancel, TryDispose}`. (Prefer `!= default` and methods without `Try` prefix.)
- Deprecated `CancelationToken.{TryRegister, TryRegisterWithoutImmediateInvoke}`. (Prefer `CanBeCanceled` and methods without `Try` prefix.)
- Deprecated `Promise(<T>).Deferred.{IsValid*, Try*}` APIs. (Prefer `!= default`.)
- Deprecated `Promise(<T>).IsValid`.

Misc:

- Changed behavior of `CancelationSource.Cancel` to not throw if it's called more than once.
- Changed behavior of `CancelationSource`, `Promise(<T>).Deferred`, `Channel(Reader/Writer)` to throw `NullReferenceException` if it's default.