refactor: widen Response body and Formatter data typing to mixed

system/Format/FormatterInterface.php

@@ -21,7 +21,7 @@ interface FormatterInterface
     /**
      * Takes the given data and formats it.
      *
-     * @param array<array-key, mixed>|object|string $data
+     * @param mixed $data
      *
      * @return false|non-empty-string
      */

system/Format/JSONFormatter.php

@@ -26,7 +26,7 @@ class JSONFormatter implements FormatterInterface
     /**
      * Takes the given data and formats it.
      *
-     * @param array<array-key, mixed>|object|string $data
+     * @param mixed $data
      *
      * @return false|non-empty-string
      */

system/Format/XMLFormatter.php

@@ -27,7 +27,7 @@ class XMLFormatter implements FormatterInterface
     /**
      * Takes the given data and formats it.
      *
-     * @param array<array-key, mixed>|object|string $data
+     * @param mixed $data
      *
      * @return false|non-empty-string
      */

system/HTTP/ResponseInterface.php

@@ -200,7 +200,7 @@ public function setContentType(string $mime, string $charset = 'UTF-8');
     /**
      * Converts the $body into JSON and sets the Content Type header.
      *
-     * @param array<array-key, mixed>|object|string $body
+     * @param mixed $body
      *
      * @return $this
      */
@@ -218,7 +218,7 @@ public function getJSON();
     /**
      * Converts $body into XML, and sets the correct Content-Type.
      *
-     * @param array<array-key, mixed>|string $body
+     * @param mixed $body
      *
      * @return $this
      */

system/HTTP/ResponseTrait.php

@@ -169,7 +169,7 @@ public function setContentType(string $mime, string $charset = 'UTF-8')
     /**
      * Converts the $body into JSON and sets the Content Type header.
      *
-     * @param array<array-key, mixed>|object|string $body
+     * @param mixed $body
      *
      * @return $this
      */
@@ -201,7 +201,7 @@ public function getJSON()
     /**
      * Converts $body into XML, and sets the correct Content-Type.
      *
-     * @param array<array-key, mixed>|string $body
+     * @param mixed $body
      *
      * @return $this
      */
@@ -234,8 +234,8 @@ public function getXML()
      * Handles conversion of the data into the appropriate format,
      * and sets the correct Content-Type header for our response.
      *
-     * @param array<array-key, mixed>|object|string $body
-     * @param string                                $format Valid: json, xml
+     * @param mixed  $body
+     * @param string $format Valid: json, xml
      *
      * @return false|string
      *

tests/system/Test/TestResponseTest.php

@@ -314,7 +314,7 @@ public function testGetJSONEmptyJSON(): void
     public function testGetJSONFalseJSON(): void
     {
         $this->getTestResponse('<h1>Hello World</h1>');
-        $this->response->setJSON(false, true); // @phpstan-ignore argument.type (Needed for testing)
+        $this->response->setJSON(false, true);
 
         // this should be FALSE - json_encode(false)
         $this->assertSame('false', $this->testResponse->getJSON());
@@ -323,7 +323,7 @@ public function testGetJSONFalseJSON(): void
     public function testGetJSONTrueJSON(): void
     {
         $this->getTestResponse('<h1>Hello World</h1>');
-        $this->response->setJSON(true, true); // @phpstan-ignore argument.type (Needed for testing)
+        $this->response->setJSON(true, true);
 
         // this should be TRUE - json_encode(true)
         $this->assertSame('true', $this->testResponse->getJSON());

user_guide_src/source/changelogs/v4.7.5.rst

@@ -22,6 +22,8 @@ Message Changes
 Changes
 *******
 
+- **Response:** ``setJSON()`` and ``setXML()``, and the ``FormatterInterface::format()`` contract implemented by ``JSONFormatter`` and ``XMLFormatter``, now type their body/data parameter as ``mixed`` instead of ``array|object|string``, matching what they already accepted at runtime (e.g., scalars and ``bool``).
+
 ************
 Deprecations
 ************