Add @throws annotations and expand tests for integer assertions

- Added `@throws IntegerTypeException` annotations to methods in `BaseIntType` to document potential exceptions.
- Expanded test cases to validate `assertGreaterThan` and `assertLessThan` methods for exclusive and inclusive bounds.

Author: georgedeploy

src/BaseType/BaseIntType.php

@@ -18,6 +18,9 @@
 {
     protected int $value;
 
+    /**
+     * @throws IntegerTypeException
+     */
     public function __construct(int $value)
     {
         $this->assert($value);
@@ -43,6 +46,9 @@ public static function fromString(string $value): self
         return new static((int) $value);
     }
 
+    /**
+     * @throws IntegerTypeException
+     */
     #[Override]
     public static function fromInt(int $value): self
     {

tests/Unit/BaseType/BaseIntTypeTest.php

@@ -27,3 +27,38 @@
         expect(fn() => Integer::fromString($str))->toThrow(IntegerTypeException::class);
     }
 });
+
+it('assertGreaterThan works for exclusive and inclusive bounds', function (): void {
+    $i = new Integer(0);
+
+    // exclusive (default): value must be strictly greater than limit
+    $i->assertGreaterThan(6, 5); // pass
+    $i->assertGreaterThan(5, 4); // pass
+
+    // failing exclusive cases
+    expect(fn() => $i->assertGreaterThan(5, 5))->toThrow(IntegerTypeException::class); // equal should fail
+    expect(fn() => $i->assertGreaterThan(4, 5))->toThrow(IntegerTypeException::class); // less should fail
+
+    // inclusive: value can be equal to limit
+    $i->assertGreaterThan(5, 5, true); // pass
+
+    // failing inclusive case: value less than limit
+    expect(fn() => $i->assertGreaterThan(4, 5, true))->toThrow(IntegerTypeException::class);
+});
+
+it('assertLessThan works for exclusive and inclusive bounds', function (): void {
+    $i = new Integer(0);
+
+    // exclusive (default): value must be strictly less than limit
+    $i->assertLessThan(4, 5); // pass
+
+    // failing exclusive cases
+    expect(fn() => $i->assertLessThan(5, 5))->toThrow(IntegerTypeException::class); // equal should fail
+    expect(fn() => $i->assertLessThan(6, 5))->toThrow(IntegerTypeException::class); // greater should fail
+
+    // inclusive: value can be equal to limit
+    $i->assertLessThan(5, 5, true); // pass
+
+    // failing inclusive case: value greater than limit
+    expect(fn() => $i->assertLessThan(6, 5, true))->toThrow(IntegerTypeException::class);
+});