Abilities: Support ability deprecation

Author: JasonTheAdams

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

@@ -325,6 +325,7 @@ protected function prepare_properties( array $args ): array {
 			$args['meta'] ?? array(),
 			array(
 				'annotations'  => static::$default_annotations,
+				'deprecated'   => false,
 				'show_in_rest' => self::DEFAULT_SHOW_IN_REST,
 			)
 		);
@@ -553,6 +554,13 @@ protected function do_execute( $input = null ) {
 			);
 		}
 
+		// Trigger deprecation notice if the ability is deprecated.
+		if ( $this->get_meta_item( 'deprecated', false ) === true ) {
+			$version     = $this->get_meta_item( 'deprecated_version', '' );
+			$replacement = $this->get_meta_item( 'deprecated_replacement', '' );
+			_deprecated_ability( $this->name, $version, $replacement );
+		}
+
 		return $this->invoke_callback( $this->execute_callback, $input );
 	}