feat (ArrayHelper): implement sort method. (#642)

Co-authored-by: Brent Roose <[email protected]>

Author: aarcex3

src/Tempest/Support/src/ArrayHelper.php

@@ -766,4 +766,15 @@ public function mapTo(string $to): self
     {
         return new self(map($this->array)->collection()->to($to));
     }
+
+    /**
+     * Sorts the array in ascending order.
+     */
+    public function sort(): self
+    {
+        $array = $this->array;
+        sort($array);
+
+        return new self($array);
+    }
 }

tests/Integration/Support/ArrayHelperTest.php

@@ -4,6 +4,7 @@
 
 namespace Tests\Tempest\Integration\Support;
 
+use PHPUnit\Framework\Attributes\DataProvider;
 use function Tempest\Support\arr;
 use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Support\Fixtures\TestObject;
@@ -19,4 +20,26 @@ public function test_map_to(): void
 
         $this->assertInstanceOf(TestObject::class, $array[0]);
     }
+
+    #[DataProvider('provide_sort_cases')]
+    public function test_sort(array $input, array $expected): void
+    {
+        $array = arr($input)->sort()->toArray();
+        $this->assertEquals($expected, $array);
+    }
+
+    public static function provide_sort_cases(): iterable
+    {
+        return [
+            "Regular case" => [[3, 1, 4, 1, 5, 9], [1, 1, 3, 4, 5, 9]],
+            "Empty array" => [[], []],
+            "Single element" => [[1], [1]],
+            "All elements the same" => [[2, 2, 2], [2, 2, 2]],
+            "Reverse order" => [[5, 4, 3, 2, 1], [1, 2, 3, 4, 5]],
+            "Negative numbers" => [[-1, -3, -2, 0], [-3, -2, -1, 0]],
+            "Mixed positive and negative" => [[3, -1, 4, 1, -5, 9], [-5, -1, 1, 3, 4, 9]],
+            "Strings" => [['apple', 'orange', 'banana'], ['apple', 'banana', 'orange']],
+            "Large array" => [range(1000, 1, -1), range(1, 1000)],
+        ];
+    }
 }