Adjust types to hint possible WP_Error usage in callbacks

Author: gziolo

includes/abilities-api.php

@@ -36,7 +36,7 @@
  *   input_schema?: array<string,mixed>,
  *   output_schema?: array<string,mixed>,
  *   execute_callback?: callable( array<string,mixed> $input): (mixed|\WP_Error),
- *   permission_callback?: callable( ?array<string,mixed> $input ): bool,
+ *   permission_callback?: callable( array<string,mixed> $input ): (bool|\WP_Error),
  *   meta?: array<string,mixed>,
  *   ...<string, mixed>
  * } $properties

includes/abilities-api/class-wp-abilities-registry.php

@@ -57,7 +57,7 @@ final class WP_Abilities_Registry {
 	 *   input_schema?: array<string,mixed>,
 	 *   output_schema?: array<string,mixed>,
 	 *   execute_callback?: callable( array<string,mixed> $input): (mixed|\WP_Error),
-	 *   permission_callback?: ?callable( ?array<string,mixed> $input ): bool,
+	 *   permission_callback?: ?callable( array<string,mixed> $input ): (bool|\WP_Error),
 	 *   meta?: array<string,mixed>,
 	 *   ...<string, mixed>
 	 * } $properties

includes/abilities-api/class-wp-ability.php

@@ -66,15 +66,15 @@ class WP_Ability {
 	 * The ability execute callback.
 	 *
 	 * @since 0.1.0
-	 * @var callable
+	 * @var callable( array<string,mixed> $input): (mixed|\WP_Error)
 	 */
 	protected $execute_callback;
 
 	/**
 	 * The optional ability permission callback.
 	 *
 	 * @since 0.1.0
-	 * @var ?callable
+	 * @var ?callable( array<string,mixed> $input ): (bool|\WP_Error)
 	 */
 	protected $permission_callback = null;
 
@@ -106,7 +106,7 @@ class WP_Ability {
 	 *   input_schema?: array<string,mixed>,
 	 *   output_schema?: array<string,mixed>,
 	 *   execute_callback: callable( array<string,mixed> $input): (mixed|\WP_Error),
-	 *   permission_callback?: ?callable( ?array<string,mixed> $input ): bool,
+	 *   permission_callback?: ?callable( array<string,mixed> $input ): (bool|\WP_Error),
 	 *   meta?: array<string,mixed>,
 	 * } $properties
 	 */
@@ -262,7 +262,7 @@ public function has_permission( array $input = array() ) {
 		 *
 		 * @since 0.1.0
 		 *
-		 * @param bool                $permission_result The current permission result.
+		 * @param bool|\WP_Error      $permission_result The current permission result.
 		 * @param string              $ability_name      The ability name.
 		 * @param array<string,mixed> $input             The input for the ability.
 		 * @return bool|\WP_Error The filtered permission result.