feat: Add TryAggregate for Option and Result

[skarllot]

This PR introduces the TryAggregate method for the Option and Result types, enabling aggregation with built-in short-circuiting for failure cases.

Key Features

• TryAggregate for Option: Aggregates a sequence, returning Some on success or None on the first failure.
• TryAggregate for Result: Aggregates a sequence, propagating the first Err or returning the accumulated Ok value.

Example Usage

Option:

var result = numbers.TryAggregate(0, (acc, item) => item > 0 ? Some(acc + item) : None);
// Returns: Some(x) or None

Result:

var result = numbers.TryAggregate(0, (acc, item) => item < 5 ? Ok(acc + item) : Err("Too large"));
// Returns: Ok(x) or Err("Too large")

Benefits

• Simplifies conditional sequence aggregation.
• Reduces boilerplate for error propagation in Option and Result.

Testing & Documentation

• Comprehensive unit tests validate various scenarios.
• Documentation added for both Option and Result.

[skarllot]

I don't think that it applies to Validation but I'm open for suggestions.

[jeffijoe]

Always wondered if there was an attribute to tell the analyzer that the function is being invoked immediately - didn't know this was it, thanks!