Refactor test structure: Add PHPUnit tests for interfaces with strong typing and mocks

- Add tests for Comparable interface
- Add tests for Countable interface
- Add tests for Indexable interface
- Add tests for Iterator interface
- Add tests for Sortable interface
- Add tests for Collection interface
- Add tests for Serializable interface
- Add tests for Heap interface
- Add tests for IterableCollection interface
- Add tests for Map interface
- Add tests for Queue interface
- Add tests for Stack interface
- Add tests for Tree interface

Organize test files into respective directories for Behavioral, DataStructure, Structural, and Structure

Author: walmir-silva

composer.lock

@@ -2,17 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Behavioral;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface Comparable.
  *
  * Defines the contract for objects that can be compared.
  *
- * @package   KaririCode\Contract\Behavioral
  * @category  Interfaces
+ *
  * @author    Walmir Silva <walmir.silva@kariricode.org>
  * @license   MIT
+ *
  * @see       https://kariricode.org/
  */
 interface Comparable
@@ -21,8 +22,9 @@ interface Comparable
      * Compares this object with the specified object for order.
      *
      * @param mixed $other The object to compare with
-     * @return int A negative integer, zero, or a positive integer as this object
-     *             is less than, equal to, or greater than the specified object.
+     *
+     * @return int a negative integer, zero, or a positive integer as this object
+     *             is less than, equal to, or greater than the specified object
      */
     public function compareTo(mixed $other): int;
 }

src/DataStructure/Behavioral/Comparable.php

@@ -2,17 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Behavioral;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface Countable.
  *
  * Defines the contract for counting elements.
  *
- * @package   KaririCode\Contract\Behavioral
  * @category  Interfaces
+ *
  * @author    Walmir Silva <walmir.silva@kariricode.org>
  * @license   MIT
+ *
  * @see       https://kariricode.org/
  */
 interface Countable

src/DataStructure/Behavioral/Countable.php

@@ -2,17 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Behavioral;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface Indexable.
  *
  * Defines the contract for indexed access to elements.
  *
- * @package   KaririCode\Contract\Behavioral
  * @category  Interfaces
+ *
  * @author    Walmir Silva <walmir.silva@kariricode.org>
  * @license   MIT
+ *
  * @see       https://kariricode.org/
  */
 interface Indexable
@@ -21,6 +22,7 @@ interface Indexable
      * Checks if an element exists at the given index.
      *
      * @param int $index The index to check
+     *
      * @return bool True if the index exists, false otherwise
      */
     public function contains(int $index): bool;
@@ -29,6 +31,7 @@ public function contains(int $index): bool;
      * Gets the element at the specified index.
      *
      * @param int $index The index of the element
+     *
      * @return mixed The element at the specified index
      */
     public function get(int $index): mixed;
@@ -38,14 +41,14 @@ public function get(int $index): mixed;
      *
      * @param int $index The index at which to set the element
      * @param mixed $element The element to set
-     * @return void
      */
     public function set(int $index, mixed $element): void;
 
     /**
      * Removes the element at the specified index.
      *
      * @param int $index The index of the element to remove
+     *
      * @return bool True if the element was removed, false otherwise
      */
     public function remove(int $index): bool;

src/DataStructure/Behavioral/Indexable.php

@@ -2,9 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\DataStructure;
-
-use KaririCode\Contract\Behavioral\Iterator;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface IterableCollection.

src/DataStructure/Behavioral/IterableCollection.php

@@ -2,17 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Behavioral;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface Iterator.
  *
  * Defines the contract for iterating over a collection of elements.
  *
- * @package   KaririCode\Contract\Behavioral
  * @category  Interfaces
+ *
  * @author    Walmir Silva <walmir.silva@kariricode.org>
  * @license   MIT
+ *
  * @see       https://kariricode.org/
  */
 interface Iterator

src/DataStructure/Behavioral/Iterator.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Behavioral;
+namespace KaririCode\Contract\DataStructure\Behavioral;
 
 /**
  * Interface Sortable.
@@ -11,18 +11,17 @@
  * Classes implementing this interface should provide an implementation
  * for the sort method to allow sorting of their elements.
  *
- * @package   KaririCode\Contract\Behavioral
  * @category  Interfaces
+ *
  * @author    Walmir Silva <walmir.silva@kariricode.org>
  * @license   MIT
+ *
  * @see       https://kariricode.org/
  */
 interface Sortable
 {
     /**
      * Sorts the elements of the class.
-     *
-     * @return void
      */
     public function sort(): void;
 }