refactor: replace narrowable mixed PHPDocs with specific types

Author: paulbalandan

system/Config/BaseConfig.php

@@ -166,7 +166,7 @@ protected function parseEncryptionKey(string $key): string
     /**
      * Initialization an environment-specific configuration setting
      *
-     * @param array|bool|float|int|string|null $property
+     * @param array<int|string, mixed>|bool|float|int|string|null $property
      *
      * @return void
      */

system/Database/BaseBuilder.php

@@ -2805,7 +2805,7 @@ public function getCompiledDelete(bool $reset = true): string
     /**
      * Compiles a delete string and runs the query
      *
-     * @param array|RawSql|string $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string Returns a SQL string if in test mode.
      *
@@ -3063,7 +3063,7 @@ protected function trackAliases($table)
      * Generates a query string based on which functions were used.
      * Should not be called directly.
      *
-     * @param mixed $selectOverride
+     * @param false|string $selectOverride
      */
     protected function compileSelect($selectOverride = false): string
     {

system/Database/BaseConnection.php

@@ -781,7 +781,7 @@ abstract protected function execute(string $sql);
      * Should automatically handle different connections for read/write
      * queries if needed.
      *
-     * @param array|string|null $binds
+     * @param array<int|string, mixed>|string|null $binds
      *
      * @return BaseResult<TConnection, TResult>|bool|Query
      *

system/Database/BaseUtils.php

@@ -125,7 +125,7 @@ public function optimizeTable(string $tableName)
     /**
      * Optimize Database
      *
-     * @return mixed
+     * @return array<string, mixed>|bool
      *
      * @throws DatabaseException
      */
@@ -170,7 +170,7 @@ public function optimizeDatabase()
     /**
      * Repair Table
      *
-     * @return mixed
+     * @return array<string, mixed>|bool
      *
      * @throws DatabaseException
      */

system/Database/ConnectionInterface.php

@@ -100,7 +100,7 @@ public function getVersion(): string;
      * Should automatically handle different connections for read/write
      * queries if needed.
      *
-     * @param array|string|null $binds
+     * @param array<int|string, mixed>|string|null $binds
      *
      * @return BaseResult<TConnection, TResult>|bool|Query
      */

system/Database/OCI8/Builder.php

@@ -150,7 +150,7 @@ protected function _truncate(string $table): string
     /**
      * Compiles a delete string and runs the query
      *
-     * @param mixed $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string
      *

system/Database/Postgre/Builder.php

@@ -225,7 +225,7 @@ protected function _insertBatch(string $table, array $keys, array $values): stri
     /**
      * Compiles a delete string and runs the query
      *
-     * @param mixed $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string
      *

system/Database/SQLSRV/Builder.php

@@ -538,7 +538,7 @@ protected function _delete(string $table): string
     /**
      * Compiles a delete string and runs the query
      *
-     * @param mixed $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string
      *
@@ -578,7 +578,7 @@ public function delete($where = '', ?int $limit = null, bool $resetData = true)
      *
      * Generates a query string based on which functions were used.
      *
-     * @param bool $selectOverride
+     * @param false|string $selectOverride
      */
     protected function compileSelect($selectOverride = false): string
     {

system/Database/SQLSRV/Forge.php

@@ -321,7 +321,7 @@ protected function _alterTable(string $alterType, string $table, $processedField
     /**
      * Drop index for table
      *
-     * @return mixed
+     * @return false|resource
      */
     protected function _dropIndex(string $table, object $indexData)
     {

system/Encryption/Handlers/BaseHandler.php

@@ -55,7 +55,7 @@ protected static function substr($str, $start, $length = null)
      *
      * @param string $key Property name
      *
-     * @return array|bool|int|string|null
+     * @return array<int|string, mixed>|bool|int|string|null
      */
     public function __get($key)
     {