Add ArrayDeque and ArrayQueue Implementations with Comprehensive Unit…

[walmir-silva]

… Tests

• Implemented the ArrayDeque and ArrayQueue classes in the KaririCode\DataStructure\Queue namespace.
• Added comprehensive unit tests for the ArrayDeque and ArrayQueue classes in the KaririCode\DataStructure\Tests\Queue namespace.

Classes:

• KaririCode\DataStructure\Queue\ArrayDeque
• KaririCode\DataStructure\Queue\ArrayQueue

Tests:

• KaririCode\DataStructure\Tests\Queue\ArrayDequeTest
• KaririCode\DataStructure\Tests\Queue\ArrayQueueTest

Fully covered features and tests:

ArrayDeque:

• Enqueue method: testEnqueueAddsElementToEndOfDeque
• Dequeue method: testDequeueRemovesElementFromFrontOfDeque
• Dequeue from empty deque: testDequeueFromEmptyDequeReturnsNull
• Peek method: testPeekReturnsElementFromFrontWithoutRemovingIt
• Peek from empty deque: testPeekFromEmptyDequeReturnsNull
• Add first method: testAddFirstAddsElementToFrontOfDeque
• Remove last method: testRemoveLastRemovesElementFromEndOfDeque
• Remove last from empty deque: testRemoveLastFromEmptyDequeReturnsNull
• Peek last method: testPeekLastReturnsElementFromEndWithoutRemovingIt
• Peek last from empty deque: testPeekLastFromEmptyDequeReturnsNull
• Is empty method: testIsEmptyReturnsTrueIfDequeIsEmpty
• Size method: testSizeReturnsNumberOfElementsInDeque
• Ensure capacity method: testEnsureCapacityDoublesCapacityWhenFull
• Handling null values: testHandlingNullValuesCorrectly
• Circular behavior: testCircularBehavior
• Various data types: testDequeWithVariousDataTypes
• Mixed operations: testDequeBehaviorAfterMixedOperations

ArrayQueue:

• Enqueue method: testEnqueueAddsElementToEndOfQueue
• Dequeue method: testDequeueRemovesElementFromFrontOfQueue
• Dequeue from empty queue: testDequeueFromEmptyQueueReturnsNull
• Peek method: testPeekReturnsElementFromFrontWithoutRemovingIt
• Peek from empty queue: testPeekFromEmptyQueueReturnsNull
• Is empty method: testIsEmptyReturnsTrueIfQueueIsEmpty
• Size method: testSizeReturnsNumberOfElementsInQueue
• Ensure capacity method: testEnsureCapacityDoublesCapacityWhenFull
• Handling null values: testHandlingNullValuesCorrectly
• Various data types: testQueueWithVariousDataTypes
• Mixed operations: testQueueBehaviorAfterMixedOperations