daxle 2.2.0

A lightweight Dart utility package offering common abstractions and missing features to write safer, more expressive code.

2.2.0 - 2026-07-11

• NEW FEATURES:

  • Re-exported key utilities from package:async to simplify asynchronous control flow and stream manipulation. These include:
    • FutureGroup, AsyncCache, and AsyncMemoizer for advanced future handling.
    • StreamZip, StreamQueue, StreamGroup, and StreamSplitter for streamlined stream consumption and combination.

• DOCUMENTATION & REFACTORING:

  • Updated library documentation in lib/daxle.dart and README.md to document the new async utilities.
  • Completed the incomplete documentation example for Unit inside lib/daxle.dart.
  • Removed outdated record extensions references from lib/daxle.dart and README.md.

2.1.0 - 2026-07-01

• NEW FEATURES:

  • Re-introduced Result<T, E> with Ok and Err variants for representing operations that can succeed or fail.

• BREAKING CHANGES:

  • Removed all record extensions (zipped(), map(), flatMap(), and filter() on Dart tuples/records) to keep the library lean and focus on a single explicit way of doing things.
  • Removed all function extension methods (.result(), .either(), and .option()).

• DOCUMENTATION & REFACTORING:

  • Reorganized internal folder structure inside lib/src/ into logical subfolders (types/).
  • Added comprehensive {@template} and {@macro} documentation to all core data types and classes to maximize readability and reduce doc comments redundancy.
  • Added example/example.md to showcase the primary library features on pub.dev.
  • Formatted the codebase to ensure a 160/160 pub points quality score.

2.0.0 - 2026-06-27

• BREAKING CHANGES / API REWRITE:

  • Removed Lazy<T> type. Use deferred pipelines or standard closures.
  • Redesigned Option<T> and Either<L, R> as sealed classes with direct subclasses (Some/None, Left/Right) for full compile-time exhaustive pattern matching.
  • Changed Option.getOrElse to take an eager default value T instead of a resolver callback.
  • Changed Either.getOrElse to take a resolver callback R Function(L left) instead of an eager default value.

• NEW FEATURES:

  • Added TaskEither<L, R> type to represent lazy, asynchronous computations that can fail (Future<Either<L, R>>), supporting monadic chaining (map, flatMap, orElse, fold).
  • Added Pipeline<T> and AsyncPipeline<T> classes to build deferred, type-safe operation chains.
    • Supports observational side-effects (tap).
    • Supports recovery from errors (recover and recoverWith).
    • Supports error mapping (mapError).
    • Supports cleanup logic (finalize / finally equivalent).
    • Supports folding success and failure states.
    • Supports concurrent combination of asynchronous pipelines (zip).
  • Added Unit type and unit constant to represent the absence of a meaningful value.
  • Added zipped(), map(), flatMap(), and filter() extension methods on Dart 3 Record tuples of size 2, 3, 4, and 5 containing Option, Either, or TaskEither values (runs TaskEither tasks concurrently).
  • Added Option.fromPredicate and Either.cond factory constructors, and Option.filter method for clean, explicit conditional evaluation.

---

1.1.0

• Introduced Lazy type for lazy evaluation and memoization of values.
• Supported transforming Lazy to Result, Option, and Either.

1.0.0

• Initial version. (2026-01-10)
  • Implemented Either type for representing success or failure.
  • Implemented Option type for representing the presence or absence of a value.
  • Implemented Result type for representing a result of an operation that can either succeed or fail.