Update DocBlocks, add ticket refs and assertion messages

src/wp-admin/includes/post.php

@@ -2178,6 +2178,7 @@ function taxonomy_meta_box_sanitize_cb_input( $taxonomy, $terms ) {
  * of a block relevant for client registration.
  *
  * @since 5.0.0
+ * @since 6.3.0 Added `selectors` and `editor_selectors` fields.
  *
  * @return array An associative array of registered block data.
  */

src/wp-includes/blocks.php

@@ -300,6 +300,7 @@ function get_block_metadata_i18n_schema() {
  * @since 5.7.0 Added support for `textdomain` field and i18n handling for all translatable fields.
  * @since 5.9.0 Added support for `variations` and `viewScript` fields.
  * @since 6.1.0 Added support for `render` field.
+ * @since 6.3.0 Added `selectors` and `editor_selectors` fields.
  *
  * @param string $file_or_folder Path to the JSON file with metadata definition for
  *                               the block or path to the folder where the `block.json` file is located.

src/wp-includes/rest-api/endpoints/class-wp-rest-block-types-controller.php

@@ -237,6 +237,7 @@ public function get_item( $request ) {
 	 *
 	 * @since 5.5.0
 	 * @since 5.9.0 Renamed `$block_type` to `$item` to match parent class for PHP 8 named parameter support.
+	 * @since 6.3.0 Added `selectors` and `editor_selectors` fields.
 	 *
 	 * @param WP_Block_Type   $item    Block type data.
 	 * @param WP_REST_Request $request Full details about the request.
@@ -381,6 +382,7 @@ protected function prepare_links( $block_type ) {
 	 * Retrieves the block type' schema, conforming to JSON Schema.
 	 *
 	 * @since 5.5.0
+	 * @since 6.3.0 Added `selectors` and `editor_selectors` fields.
 	 *
 	 * @return array Item schema data.
 	 */

tests/phpunit/tests/blocks/register.php

@@ -483,6 +483,7 @@ public function test_metadata_not_found_in_the_current_directory() {
 	 *
 	 * @ticket 50263
 	 * @ticket 50328
+	 * @ticket 57585
 	 */
 	public function test_block_registers_with_metadata_fixture() {
 		$result = register_block_type_from_metadata(
@@ -515,13 +516,17 @@ public function test_block_registers_with_metadata_fixture() {
 			$result->provides_context
 		);
 		$this->assertSameSets( array( 'groupId' ), $result->uses_context );
+		// @ticket 57585
 		$this->assertSame(
 			array( 'root' => '.editor-only.wp-block-notice' ),
-			$result->editor_selectors
+			$result->editor_selectors,
+			'Block type should contain editor selectors from metadata.'
 		);
+		// @ticket 57585
 		$this->assertSame(
 			array( 'root' => '.wp-block-notice' ),
-			$result->selectors
+			$result->selectors,
+			'Block type should contain selectors from metadata.'
 		);
 		$this->assertSame(
 			array(

tests/phpunit/tests/rest-api/rest-block-type-controller.php

@@ -196,6 +196,7 @@ public function test_get_block_invalid_name() {
 
 	/**
 	 * @ticket 47620
+	 * @ticket 57585
 	 */
 	public function test_get_item_invalid() {
 		$block_type = 'fake/invalid';
@@ -249,8 +250,8 @@ public function test_get_item_invalid() {
 		$this->assertSameSets( array( 'invalid_keywords' ), $data['keywords'] );
 		$this->assertSameSets( array( 'invalid_parent' ), $data['parent'] );
 		$this->assertSameSets( array( 'invalid_ancestor' ), $data['ancestor'] );
-		$this->assertSameSets( array(), $data['editor_selectors'] );
-		$this->assertSameSets( array(), $data['selectors'] );
+		$this->assertSameSets( array(), $data['editor_selectors'], 'invalid editor_selectors defaults to empty array' );
+		$this->assertSameSets( array(), $data['selectors'], 'invalid selectors defaults to empty array' );
 		$this->assertSameSets( array(), $data['supports'] );
 		$this->assertSameSets( array(), $data['styles'] );
 		$this->assertNull( $data['example'] );
@@ -269,6 +270,7 @@ public function test_get_item_invalid() {
 
 	/**
 	 * @ticket 47620
+	 * @ticket 57585
 	 */
 	public function test_get_item_defaults() {
 		$block_type = 'fake/false';
@@ -322,8 +324,8 @@ public function test_get_item_defaults() {
 		$this->assertSameSets( array(), $data['keywords'] );
 		$this->assertSameSets( array(), $data['parent'] );
 		$this->assertSameSets( array(), $data['ancestor'] );
-		$this->assertSameSets( array(), $data['editor_selectors'] );
-		$this->assertSameSets( array(), $data['selectors'] );
+		$this->assertSameSets( array(), $data['editor_selectors'], 'editor_selectors defaults to empty array' );
+		$this->assertSameSets( array(), $data['selectors'], 'selectors defaults to empty array' );
 		$this->assertSameSets( array(), $data['supports'] );
 		$this->assertSameSets( array(), $data['styles'] );
 		$this->assertNull( $data['example'] );
@@ -542,6 +544,7 @@ public function test_get_variation() {
 
 	/**
 	 * @ticket 47620
+	 * @ticket 57585
 	 */
 	public function test_get_item_schema() {
 		wp_set_current_user( self::$admin_id );
@@ -559,8 +562,8 @@ public function test_get_item_schema() {
 		$this->assertArrayHasKey( 'textdomain', $properties );
 		$this->assertArrayHasKey( 'name', $properties );
 		$this->assertArrayHasKey( 'attributes', $properties );
-		$this->assertArrayHasKey( 'editor_selectors', $properties );
-		$this->assertArrayHasKey( 'selectors', $properties );
+		$this->assertArrayHasKey( 'editor_selectors', $properties, 'schema must contain editor_selectors' );
+		$this->assertArrayHasKey( 'selectors', $properties, 'schema must contain selectors' );
 		$this->assertArrayHasKey( 'supports', $properties );
 		$this->assertArrayHasKey( 'category', $properties );
 		$this->assertArrayHasKey( 'is_dynamic', $properties );