Add doc blocks

src/Flash.php

@@ -9,10 +9,16 @@
  */
 final class Flash implements FlashInterface
 {
+    /**
+     * @var array<string, mixed>|ArrayAccess<string, mixed>
+     */
     private array|ArrayAccess $storage;
 
     private string $storageKey;
 
+    /**
+     * @param array<string, mixed>|ArrayAccess<string, mixed> $storage
+     */
     public function __construct(array|ArrayAccess &$storage, string $storageKey = '_flash')
     {
         $this->storage = &$storage;

src/FlashInterface.php

@@ -22,7 +22,7 @@ public function add(string $key, string $message): void;
      *
      * @param string $key The key to get the message from
      *
-     * @return array The messages
+     * @return array<int, string> The messages
      */
     public function get(string $key): array;
 
@@ -55,7 +55,7 @@ public function set(string $key, array $messages): void;
     /**
      * Gets all flash messages.
      *
-     * @return array All messages. Can be an empty array.
+     * @return array<int, string> All messages. Can be an empty array.
      */
     public function all(): array;
 }

src/MemorySession.php

@@ -7,11 +7,17 @@
  */
 final class MemorySession implements SessionInterface, SessionManagerInterface
 {
+    /**
+     * @var array<string, mixed>
+     */
     private array $options = [
         'name' => 'app',
         'lifetime' => 7200,
     ];
 
+    /**
+     * @var array<string, mixed>
+     */
     private array $storage;
 
     private Flash $flash;
@@ -20,6 +26,9 @@ final class MemorySession implements SessionInterface, SessionManagerInterface
 
     private bool $started = false;
 
+    /**
+     * @param array<string, mixed> $options
+     */
     public function __construct(array $options = [])
     {
         $keys = array_keys($this->options);

src/PhpSession.php

@@ -9,10 +9,16 @@
  */
 final class PhpSession implements SessionInterface, SessionManagerInterface
 {
+    /**
+     * @var array<string, mixed>
+     */
     private array $storage;
 
     private FlashInterface $flash;
 
+    /**
+     * @var array<string, mixed>
+     */
     private array $options = [
         'id' => null,
         'name' => 'app',
@@ -26,6 +32,9 @@ final class PhpSession implements SessionInterface, SessionManagerInterface
         'cache_limiter' => 'nocache',
     ];
 
+    /**
+     * @param array<string, mixed> $options
+     */
     public function __construct(array $options = [])
     {
         // Prevent uninitialized state

src/SessionInterface.php

@@ -20,7 +20,7 @@ public function get(string $key, mixed $default = null): mixed;
     /**
      * Gets all values as array.
      *
-     * @return array The session values
+     * @return array<string, mixed> The session values
      */
     public function all(): array;
 
@@ -37,7 +37,7 @@ public function set(string $key, mixed $value): void;
     /**
      * Sets multiple attributes at once: takes a keyed array and sets each key => value pair.
      *
-     * @param array $values The new values
+     * @param array<string, mixed> $values The new values
      */
     public function setValues(array $values): void;