docs: add @phpstan-return

Author: kenjis

system/Database/BaseConnection.php

@@ -1235,6 +1235,7 @@ abstract public function affectedRows(): int;
      * @param array|bool|float|int|object|string|null $str
      *
      * @return array|float|int|string
+     * @phpstan-return ($str is array ? array : float|int|string)
      */
     public function escape($str)
     {

system/Database/ConnectionInterface.php

@@ -134,6 +134,7 @@ public function getLastQuery();
      * @param array|bool|float|int|object|string|null $str
      *
      * @return array|float|int|string
+     * @phpstan-return ($str is array ? array : float|int|string)
      */
     public function escape($str);
 

system/Database/Postgre/Connection.php

@@ -172,6 +172,7 @@ public function affectedRows(): int
      * @param array|bool|float|int|object|string|null $str
      *
      * @return array|float|int|string
+     * @phpstan-return ($str is array ? array : float|int|string)
      */
     public function escape($str)
     {