Remove PHPStan comments in PHPDoc

Author: gziolo

src/wp-includes/abilities-api.php

@@ -44,23 +44,6 @@
  *     @type string               $ability_class       Optional. Custom class to instantiate instead of WP_Ability.
  * }
  * @return WP_Ability|null An instance of registered ability on success, null on failure.
- *
- * @phpstan-param array{
- *   label?: string,
- *   description?: string,
- *   category?: string,
- *   execute_callback?: callable( mixed $input= ): (mixed|WP_Error),
- *   permission_callback?: callable( mixed $input= ): (bool|WP_Error),
- *   input_schema?: array<string, mixed>,
- *   output_schema?: array<string, mixed>,
- *   meta?: array{
- *     annotations?: array<string, (bool|string)>,
- *     show_in_rest?: bool,
- *     ...<string, mixed>,
- *   },
- *   ability_class?: class-string<WP_Ability>,
- *   ...<string, mixed>
- * } $args
  */
 function wp_register_ability( string $name, array $args ): ?WP_Ability {
 	if ( ! did_action( 'wp_abilities_api_init' ) ) {
@@ -138,13 +121,6 @@ function wp_get_abilities(): array {
  *     @type array<string, mixed> $meta        Optional. Additional metadata for the category.
  * }
  * @return WP_Ability_Category|null The registered category instance on success, null on failure.
- *
- * @phpstan-param array{
- *   label: string,
- *   description: string,
- *   meta?: array<string, mixed>,
- *   ...<string, mixed>
- * } $args
  */
 function wp_register_ability_category( string $slug, array $args ): ?WP_Ability_Category {
 	return WP_Abilities_Category_Registry::get_instance()->register( $slug, $args );

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

@@ -53,13 +53,6 @@ final class WP_Abilities_Category_Registry {
 	 *     @type array<string, mixed> $meta        Optional. Additional metadata for the category.
 	 * }
 	 * @return WP_Ability_Category|null The registered category instance on success, null on failure.
-	 *
-	 * @phpstan-param array{
-	 *   label: string,
-	 *   description: string,
-	 *   meta?: array<string, mixed>,
-	 *   ...<string, mixed>
-	 * } $args
 	 */
 	public function register( string $slug, array $args ): ?WP_Ability_Category {
 		if ( ! doing_action( 'wp_abilities_api_categories_init' ) ) {

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

@@ -67,23 +67,6 @@ final class WP_Abilities_Registry {
 	 *     @type string               $ability_class         Optional. Custom class to instantiate instead of WP_Ability.
 	 * }
 	 * @return WP_Ability|null The registered ability instance on success, null on failure.
-	 *
-	 * @phpstan-param array{
-	 *   label?: string,
-	 *   description?: string,
-	 *   category?: string,
-	 *   execute_callback?: callable( mixed $input= ): (mixed|WP_Error),
-	 *   permission_callback?: callable( mixed $input= ): (bool|WP_Error),
-	 *   input_schema?: array<string, mixed>,
-	 *   output_schema?: array<string, mixed>,
-	 *   meta?: array{
-	 *     annotations?: array<string, (bool|string)>,
-	 *     show_in_rest?: bool,
-	 *     ...<string, mixed>
-	 *   },
-	 *   ability_class?: class-string<WP_Ability>,
-	 *   ...<string, mixed>
-	 * } $args
 	 */
 	public function register( string $name, array $args ): ?WP_Ability {
 		if ( ! preg_match( '/^[a-z0-9-]+\/[a-z0-9-]+$/', $name ) ) {

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

@@ -123,13 +123,6 @@ public function __construct( string $slug, array $args ) {
 	 *     @type array<string, mixed> $meta        Optional. Additional metadata for the category.
 	 * }
 	 * @throws InvalidArgumentException if an argument is invalid.
-	 *
-	 * @phpstan-return array{
-	 *   label: string,
-	 *   description: string,
-	 *   meta?: array<string, mixed>,
-	 *   ...<string, mixed>,
-	 * }
 	 */
 	protected function prepare_properties( array $args ): array {
 		// Required args must be present and of the correct type.

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

@@ -231,22 +231,6 @@ public function __construct( string $name, array $args ) {
 	 *     }
 	 * }
 	 * @throws InvalidArgumentException if an argument is invalid.
-	 *
-	 * @phpstan-return array{
-	 *   label: string,
-	 *   description: string,
-	 *   category: string,
-	 *   execute_callback: callable( mixed $input= ): (mixed|WP_Error),
-	 *   permission_callback: callable( mixed $input= ): (bool|WP_Error),
-	 *   input_schema?: array<string, mixed>,
-	 *   output_schema?: array<string, mixed>,
-	 *   meta?: array{
-	 *     annotations?: array<string, (bool|string)>,
-	 *     show_in_rest?: bool,
-	 *     ...<string, mixed>
-	 *   },
-	 *   ...<string, mixed>,
-	 * } $args
 	 */
 	protected function prepare_properties( array $args ): array {
 		// Required args must be present and of the correct type.