feat: Add BinaryHeap implementation and comprehensive tests and Update README files in English and Portuguese (#17)

* add size method

* feat: Normalize Interfaces

- Refined and standardized interface definitions across the project
- Applied Single Responsibility Principle (SRP) to ensure each interface has a clear, singular purpose
- Consistent naming conventions were implemented for better readability and maintainability
- Added thorough documentation for each interface, including method descriptions and expected behaviors
- Organized interfaces within appropriate namespaces to prevent naming collisions and maintain a logical structure
- Ensured parameter names in interface methods are consistent with implementing classes
- Avoided including constructors in interfaces to maintain flexibility

These changes enhance the overall clarity, maintainability, and professional quality of the codebase.

* Refactor and Normalize Collection Interface and Implementation

- Refactored `Collection` interface for consistency and adherence to best practices.
- Ensured all tests are comprehensive and validate the expected behavior.

* feat: Add BinaryHeap implementation and comprehensive tests

- Implemented BinaryHeap class with support for both min-heap and max-heap operations.
  - Methods include: add, poll, peek, size, isEmpty, heapifyUp, heapifyDown, swap, and compare.
- Created unit tests for BinaryHeap class ensuring 100% coverage.
  - Tested all key operations: add, poll, peek, heapifyUp, heapifyDown, swap, and compare.
  - Included edge case tests for min-heap and max-heap scenarios.
- Ensured compliance with type safety and PHP 8.0+ features.
- Added comprehensive documentation and examples for BinaryHeap usage.

This commit enhances the KaririCode Framework by providing a robust, type-safe, and efficient BinaryHeap data structure with extensive unit tests.

* docs: Update README files in English and Portuguese

- Enhanced the overview and key features sections for clarity and completeness.
- Added detailed descriptions for all implemented data structures:
  - TreeSet
  - ArrayDeque
  - ArrayQueue
  - TreeMap
  - LinkedList
  - BinaryHeap
  - HashMap
- Included complexity analysis and key methods for each data structure.
- Provided usage examples for each data structure to demonstrate functionality.
- Updated installation instructions and requirements.
- Updated acknowledgments and roadmap sections.

* style: Normalize code formatting and style

Author: walmir-silva

src/DataStructure/Structural/BPlusTreeCollection.php

@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\DataStructure;
+namespace KaririCode\Contract\DataStructure\Structural;
 
 use KaririCode\Contract\DataStructure\Behavioral\Sortable;
-use KaririCode\Contract\DataStructure\Structural\Collection;
+use KaririCode\Contract\DataStructure\Tree;
 
 /**
  * Interface BPlusTreeCollection.

tests/DataStructure/Structural/BPlusTreeCollectionTest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Tests\Contract\DataStructure;
+namespace KaririCode\Tests\Contract\DataStructure\Structural;
 
-use KaririCode\Contract\DataStructure\BPlusTreeCollection;
+use KaririCode\Contract\DataStructure\Structural\BPlusTreeCollection;
 use PHPUnit\Framework\TestCase;
 
 final class BPlusTreeCollectionTest extends TestCase