feat(arr): implement jsonEncode

Author: xHeaven

packages/support/src/Arr/ManipulatesArray.php

@@ -7,7 +7,9 @@
 use Closure;
 use Stringable;
 use Tempest\Support\Str\ImmutableString;
+use Tempest\Support\Str\MutableString;
 
+use function Tempest\Support\Json\encode;
 use function Tempest\Support\tap;
 
 /**
@@ -814,6 +816,16 @@ public function dd(mixed ...$dd): void
         ld($this->value, ...$dd);
     }
 
+    /**
+     * Encodes the array as JSON and returns a string helper instance.
+     */
+    public function jsonEncode(bool $pretty = false, bool $mutable = false): ImmutableString|MutableString
+    {
+        $json = encode($this->value, $pretty);
+
+        return $mutable ? new MutableString($json) : new ImmutableString($json);
+    }
+
     /**
      * Returns the underlying array of the instance.
      *

packages/support/tests/Arr/ManipulatesArrayTest.php

@@ -1806,4 +1806,50 @@ public function test_partition(): void
     {
         $this->assertSame([[true, true], [false]], arr([true, true, false])->partition(fn (bool $value) => $value === true)->toArray());
     }
+
+    public function test_json_encode(): void
+    {
+        $data = ['name' => 'tempest', 'version' => '1.0', 'tags' => ['php', 'framework']];
+        $result = arr($data)->jsonEncode();
+
+        $this->assertInstanceOf(\Tempest\Support\Str\ImmutableString::class, $result);
+        $this->assertSame('{"name":"tempest","version":"1.0","tags":["php","framework"]}', $result->toString());
+    }
+
+    public function test_json_encode_pretty(): void
+    {
+        $data = ['name' => 'tempest', 'version' => '1.0'];
+        $result = arr($data)->jsonEncode(pretty: true);
+
+        $this->assertInstanceOf(\Tempest\Support\Str\ImmutableString::class, $result);
+        $this->assertStringContainsString("{\n", $result->toString());
+        $this->assertStringContainsString('"name": "tempest"', $result->toString());
+        $this->assertStringContainsString('"version": "1.0"', $result->toString());
+    }
+
+    public function test_json_encode_mutable(): void
+    {
+        $data = ['name' => 'tempest', 'version' => '1.0'];
+        $result = arr($data)->jsonEncode(mutable: true);
+
+        $this->assertInstanceOf(\Tempest\Support\Str\MutableString::class, $result);
+        $this->assertSame('{"name":"tempest","version":"1.0"}', $result->toString());
+    }
+
+    public function test_json_encode_array(): void
+    {
+        $data = ['php', 'framework', 'tempest'];
+        $result = arr($data)->jsonEncode();
+
+        $this->assertInstanceOf(\Tempest\Support\Str\ImmutableString::class, $result);
+        $this->assertSame('["php","framework","tempest"]', $result->toString());
+    }
+
+    public function test_json_encode_empty_array(): void
+    {
+        $result = arr([])->jsonEncode();
+
+        $this->assertInstanceOf(\Tempest\Support\Str\ImmutableString::class, $result);
+        $this->assertSame('[]', $result->toString());
+    }
 }