Implement configurable conversion conflict resolution strategies

[konard]

Summary

• Implements configurable mechanism for resolving conversion conflicts when source values exceed target type limits
• Addresses issue Think of a mechanism for different resolution of conversion conflicts #15 by providing multiple strategies to handle overflow scenarios
• Adds ConfigurableConverter<TSource, TTarget> with runtime strategy selection

Features Added

• ConversionConflictResolutionStrategy enum with 8 different resolution strategies
• ConfigurableConverter<TSource, TTarget> for runtime strategy configuration
• IConfigurableConverter interface for type-safe converter creation
• ConversionHelper internal class for numeric type clamping logic

Available Strategies

• ThrowException: Throw overflow exceptions (default behavior)
• ResetToDefault: Always return target type's default value
• ClampToMax: Use target type's MaxValue (reproduces old To.cs behavior from issue)
• ClampToMin: Use target type's MinValue
• ClampToNearest: Clamp to nearest valid bound based on source value
• AllowOverflow: Use unchecked arithmetic allowing wraparound
• SystemConvert: Use System.Convert logic with IConvertible
• UseIConvertible: Use explicit IConvertible interface implementations

Example Usage

// Create converter with clamping to max value (old To.cs behavior)
var clampConverter = ConfigurableConverter<ulong, int>.Create(ConversionConflictResolutionStrategy.ClampToMax);
var result = clampConverter.Convert((ulong)int.MaxValue + 1000); // Returns int.MaxValue

// Create converter that allows overflow
var overflowConverter = ConfigurableConverter<ulong, int>.Create(ConversionConflictResolutionStrategy.AllowOverflow);
var wrappedResult = overflowConverter.Convert((ulong)int.MaxValue + 1000); // Returns wrapped value

// Switch strategies at runtime
var throwConverter = ConfigurableConverter<ulong, int>.Default; // ThrowException by default
var newConverter = throwConverter.WithStrategy(ConversionConflictResolutionStrategy.ClampToMax);

Test Plan

• All existing tests pass
• Comprehensive unit tests for all 8 strategies
• Performance benchmarks comparing with existing converters
• Edge cases tested (same-type conversion, non-numeric types)
• Version updated to 0.5.0 for release

🤖 Generated with Claude Code

---

Resolves #15