docs: add/fix PHPDoc types

Author: kenjis

system/Cookie/Cookie.php

@@ -37,6 +37,8 @@
  * $cookie2 = $cookie->withName('prod_cookie');
  * $cookie2->getName(); // prod_cookie
  * ```
+ *
+ * @template-implements ArrayAccess<string, bool|int|string>
  */
 class Cookie implements ArrayAccess, CloneableCookieInterface
 {
@@ -564,7 +566,7 @@ public function withRaw(bool $raw = true)
     /**
      * Whether an offset exists.
      *
-     * @param mixed $offset
+     * @param string $offset
      */
     public function offsetExists($offset): bool
     {
@@ -574,9 +576,9 @@ public function offsetExists($offset): bool
     /**
      * Offset to retrieve.
      *
-     * @param mixed $offset
+     * @param string $offset
      *
-     * @return mixed
+     * @return bool|int|string
      *
      * @throws InvalidArgumentException
      */
@@ -593,8 +595,8 @@ public function offsetGet($offset)
     /**
      * Offset to set.
      *
-     * @param mixed $offset
-     * @param mixed $value
+     * @param string $offset
+     * @param mixed  $value
      *
      * @throws LogicException
      */
@@ -606,7 +608,7 @@ public function offsetSet($offset, $value): void
     /**
      * Offset to unset.
      *
-     * @param mixed $offset
+     * @param string $offset
      *
      * @throws LogicException
      */

system/Files/FileCollection.php

@@ -23,6 +23,8 @@
  *
  * Representation for a group of files, with utilities for locating,
  * filtering, and ordering them.
+ *
+ * @template-implements IteratorAggregate<int, File>
  */
 class FileCollection implements Countable, IteratorAggregate
 {

system/Test/Mock/MockConnection.php

@@ -16,6 +16,9 @@
 use CodeIgniter\Database\BaseResult;
 use CodeIgniter\Database\Query;
 
+/**
+ * @extends BaseConnection<object|resource, object|resource>
+ */
 class MockConnection extends BaseConnection
 {
     protected $returnValues = [];

system/Test/Mock/MockResult.php

@@ -13,6 +13,9 @@
 
 use CodeIgniter\Database\BaseResult;
 
+/**
+ * @extends BaseResult<object|resource, object|resource>
+ */
 class MockResult extends BaseResult
 {
     /**