Add FloatCombinableArbitrary

[kail-is]

Summary

Add FloatCombinableArbitrary for customizable Float value generation following existing CombinableArbitrary pattern with Float-specific enhancements including precision control and special value handling.

Description

Implemented FloatCombinableArbitrary to provide easy customization of Float value generation, addressing the lack of float-specific constraints in current API with enhanced domain-specific methods and comprehensive special value support.

Added components:

• FloatCombinableArbitrary interface with standard constraint methods and domain-specific extensions
• FloatCombinableArbitraryDelegator for filter/null injection operations
• JqwikFloatCombinableArbitrary implementation
• KotestFloatCombinableArbitrary implementation for Kotest integration
• Factory method CombinableArbitrary.floats()

Key features:

• Standard numeric constraints: .positive(), .negative(), .nonZero(), .withRange(float, float)
• Float-specific precision control: .withPrecision(int) method for decimal place specification
• Float-specific value type methods: .finite(), .infinite(), .nan() for handling special floating-point values
• Domain-specific methods:
  • .percentage() - generates values 0-100 for percentage representation
  • .score() - generates values 0-100 for scoring systems
  • .normalized() - generates values 0.0-1.0 for probability and ratio calculations
• Critical special value injection methods:
  • .withSpecialValue(float) - injects custom edge case values for comprehensive testing coverage
  • .withStandardSpecialValues() - automatically injects Float.NaN, Float.MIN_VALUE, Float.POSITIVE_INFINITY, Float.NEGATIVE_INFINITY for robust floating-point edge case testing
• Last-method-wins behavior for constraint precedence (domain-specific methods override previous constraints)
• Full integration with existing filter/map/unique operations

Usage example:

Float nonZeroFloat = CombinableArbitrary.floats().nonZero().combined();
Float precisionFloat = CombinableArbitrary.floats().withPrecision(2).combined();
Float positiveFloat = CombinableArbitrary.floats().withRange(1.0f, 1000.0f).positive().combined();
Float normalizedFloat = CombinableArbitrary.floats().normalized().combined();
Float percentageFloat = CombinableArbitrary.floats().percentage().combined();
Float edgeCaseFloat = CombinableArbitrary.floats().withStandardSpecialValues().combined();

How Has This Been Tested?

Added comprehensive test suite in FloatCombinableArbitraryTest:

• Basic constraint validation (positive, negative, nonZero, finite, infinite, nan)
• Range constraint testing with various boundaries and precision specifications
• Domain-specific constraint testing (percentage, score, normalized)
• Precision control validation for decimal place accuracy
• Special value injection testing for edge case coverage
• Method chaining and last-method-wins precedence verification
• Integration with filter, map, injectNull, unique operations
• Complex constraint combinations and floating-point operation safety
• Domain boundary validation (ensuring normalized values are 0.0-1.0, percentage values are 0-100, etc.)
• Cross-platform compatibility testing with both Jqwik and Kotest implementations

Is the Document updated?

Documentation will be updated to include FloatCombinableArbitrary usage examples alongside existing numeric arbitrary types, with special emphasis on precision control, special value handling, and domain-specific constraint methods for common Float use cases in scientific and business applications.

[kail-is]

Closing in favor of #1261

• combined all numeric CombinableArbitrary types (Float, Double, BigInteger, BigDecimal) into a single PR for cleaner review.