🐞 Start fix PHPStan

Author: dimitriBouteille

src/Action.php

@@ -12,6 +12,15 @@
 
 readonly class Action
 {
+    /**
+     * @param string $name
+     * @param int $priority
+     * @param int $acceptedArgs
+     * @param mixed $classInstance
+     * @param string $methodName
+     * @param array<string, string[]> $dependencies
+     * @param ActionType $actionType
+     */
     public function __construct(
         public string $name,
         public int $priority,

src/Attributes/Action.php

@@ -11,11 +11,17 @@
 use Dbout\WpHook\Enums\ActionType;
 
 /**
- * - [WP add_action](https://developer.wordpress.org/reference/functions/add_action/)
+ * @see https://developer.wordpress.org/reference/functions/add_action/
  */
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_CLASS)]
 class Action implements FilterInterface
 {
+    /**
+     * @param string $name The name of the action to add the callback to.
+     * @param int $priority Used to specify the order in which the functions associated with a particular action are executed.
+     * @param int $acceptedArgs The number of arguments the function accepts.
+     * @param array<string|string[]> $dependencies List of dependencies on which the action depends.
+     */
     public function __construct(
         protected string $name,
         protected int $priority = 10,

src/Attributes/Filter.php

@@ -11,11 +11,17 @@
 use Dbout\WpHook\Enums\ActionType;
 
 /**
- * - [WP add_filter](https://developer.wordpress.org/reference/functions/add_filter/)
+ * @see https://developer.wordpress.org/reference/functions/add_filter/
  */
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_CLASS)]
 class Filter implements FilterInterface
 {
+    /**
+     * @param string $name The name of the filter to add the callback to.
+     * @param int $priority Used to specify the order in which the functions associated with a particular filter are executed.
+     * @param int $acceptedArgs The number of arguments the function accepts.
+     * @param array<string|string[]> $dependencies List of dependencies on which the action depends.
+     */
     public function __construct(
         protected string $name,
         protected int $priority = 10,

src/Attributes/FilterInterface.php

@@ -46,7 +46,7 @@ public function getActionType(): ActionType;
     /**
      * List of dependencies on which the action depends.
      *
-     * @return array
+     * @return array<string|string[]>
      */
     public function getDependencies(): array;
 }

src/HookLoader.php

@@ -20,7 +20,7 @@ class HookLoader
     private const CACHE_KEY = '_app_wp_autoloader_hooks';
 
     /**
-     * @param string|array $directory
+     * @param string|array<string> $directory
      * @param CacheItemPoolInterface|null $cache
      */
     public function __construct(
@@ -76,7 +76,7 @@ protected function findHooks(): array
 
     /**
      * @throws HookException
-     * @return array
+     * @return array<string>
      */
     protected function getDirectories(): array
     {
@@ -131,7 +131,7 @@ public function register(): void
 
     /**
      * @param Action $action
-     * @return array
+     * @return array<string, mixed>
      */
     protected function getHookArg(Action $action): array
     {