Docs: Align @param tag columns in block editor docblocks

src/wp-admin/widgets-form-blocks.php

@@ -121,7 +121,7 @@
 		 *
 		 * @since 6.4.0
 		 *
-		 * @param string $message The message being displayed.
+		 * @param string $message   The message being displayed.
 		 * @param bool   $installed Whether the Classic Widget plugin is installed.
 		 */
 		$message = apply_filters( 'block_widgets_no_javascript_message', $message, $installed );

src/wp-includes/block-supports/layout.php

@@ -1563,7 +1563,7 @@ static function ( $matches ) {
  * @access private
  *
  * @param string $block_content Rendered block content.
- * @param  array  $block        Block object.
+ * @param array  $block         Block object.
  * @return string Filtered block content.
  */
 function wp_restore_image_outer_container( $block_content, $block ) {

src/wp-includes/block-supports/settings.php

@@ -69,8 +69,8 @@ function _wp_add_block_level_presets_class( $block_content, $block ) {
  * @since 6.3.0 Updated preset styles to use Selectors API.
  * @access private
  *
- * @param string|null $pre_render   The pre-rendered content. Default null.
- * @param array       $block The block being rendered.
+ * @param string|null $pre_render The pre-rendered content. Default null.
+ * @param array       $block      The block being rendered.
  * @return null
  */
 function _wp_add_block_level_preset_styles( $pre_render, $block ) {

src/wp-includes/block-template-utils.php

@@ -1115,15 +1115,15 @@ function get_block_templates( $query = array(), $template_type = 'wp_template' )
 	 *
 	 * @param WP_Block_Template[]|null $block_templates Return an array of block templates to short-circuit the default query,
 	 *                                                  or null to allow WP to run its normal queries.
-	 * @param array  $query {
+	 * @param array                    $query {
 	 *     Arguments to retrieve templates. All arguments are optional.
 	 *
 	 *     @type string[] $slug__in  List of slugs to include.
 	 *     @type int      $wp_id     Post ID of customized template.
 	 *     @type string   $area      A 'wp_template_part_area' taxonomy value to filter by (for 'wp_template_part' template type only).
 	 *     @type string   $post_type Post type to get the templates for.
 	 * }
-	 * @param string $template_type Template type. Either 'wp_template' or 'wp_template_part'.
+	 * @param string                   $template_type   Template type. Either 'wp_template' or 'wp_template_part'.
 	 */
 	$templates = apply_filters( 'pre_get_block_templates', null, $query, $template_type );
 	if ( ! is_null( $templates ) ) {
@@ -1264,7 +1264,7 @@ function ( $template ) {
 	 *
 	 * @since 5.9.0
 	 *
-	 * @param WP_Block_Template[] $query_result Array of found block templates.
+	 * @param WP_Block_Template[] $query_result  Array of found block templates.
 	 * @param array               $query {
 	 *     Arguments to retrieve templates. All arguments are optional.
 	 *

src/wp-includes/blocks.php

@@ -1258,13 +1258,13 @@ function apply_block_hooks_to_content( $content, $context = null, $callback = 'i
  * @since 7.0.0 Added the `$ignored_hooked_blocks_at_root` parameter.
  * @access private
  *
- * @param string       $content  Serialized content.
- * @param WP_Post|null $post     A post object that the content belongs to. If set to `null`,
- *                               `get_post()` will be called to use the current post as context.
- *                               Default: `null`.
- * @param callable     $callback A function that will be called for each block to generate
- *                               the markup for a given list of blocks that are hooked to it.
- *                               Default: 'insert_hooked_blocks'.
+ * @param string       $content                       Serialized content.
+ * @param WP_Post|null $post                          A post object that the content belongs to. If set to `null`,
+ *                                                    `get_post()` will be called to use the current post as context.
+ *                                                    Default: `null`.
+ * @param callable     $callback                      A function that will be called for each block to generate
+ *                                                    the markup for a given list of blocks that are hooked to it.
+ *                                                    Default: 'insert_hooked_blocks'.
  * @param array|null   $ignored_hooked_blocks_at_root A reference to an array that will be populated
  *                               with the ignored hooked blocks at the root level.
  *                               Default: `null`.

src/wp-includes/blocks/accordion.php

@@ -5,8 +5,8 @@
  * @package WordPress
  * @since 6.9.0
  *
- * @param array $attributes The block attributes.
- * @param string $content The block content.
+ * @param array  $attributes The block attributes.
+ * @param string $content    The block content.
  *
  * @return string Returns the updated markup.
  */

src/wp-includes/blocks/heading.php

@@ -17,7 +17,7 @@
  * @since 6.2.0
  *
  * @param array  $attributes Attributes of the block being rendered.
- * @param string $content Content of the block being rendered.
+ * @param string $content    Content of the block being rendered.
  *
  * @return string The content of the block being rendered.
  */

src/wp-includes/blocks/list.php

@@ -15,7 +15,7 @@
  * @see https://github.com/WordPress/gutenberg/issues/12420
  *
  * @param array  $attributes Attributes of the block being rendered.
- * @param string $content Content of the block being rendered.
+ * @param string $content    Content of the block being rendered.
  *
  * @return string The content of the block being rendered.
  */

src/wp-includes/blocks/navigation-link.php

@@ -304,7 +304,7 @@ function render_block_core_navigation_link( $attributes, $content, $block ) {
  * @since 5.9.0
  *
  * @param WP_Taxonomy|WP_Post_Type $entity post type or taxonomy entity.
- * @param string                   $kind string of value 'taxonomy' or 'post-type'.
+ * @param string                   $kind   string of value 'taxonomy' or 'post-type'.
  *
  * @return array
  */

src/wp-includes/blocks/navigation.php

@@ -411,7 +411,7 @@ private static function disable_overlay_menu_for_nested_navigation_blocks( $bloc
 	 * @since 6.5.0
 	 *
 	 * @param string $overlay_template_part_id The overlay template part ID in format "theme//slug".
-	 * @param array  $attributes                The block attributes.
+	 * @param array  $attributes               The block attributes.
 	 * @return WP_Block_List Returns the inner blocks for the overlay template part.
 	 */
 	private static function get_overlay_blocks_from_template_part( $overlay_template_part_id, $attributes ) {
@@ -512,7 +512,7 @@ private static function get_overlay_blocks_from_template_part( $overlay_template
 	 * @since 6.5.0
 	 *
 	 * @param array    $attributes The block attributes.
-	 * @param WP_Block $block The parsed block.
+	 * @param WP_Block $block      The parsed block.
 	 * @return WP_Block_List Returns the inner blocks for the navigation block.
 	 */
 	private static function get_inner_blocks( $attributes, $block ) {
@@ -682,8 +682,8 @@ private static function get_styles( $attributes ) {
 	 * @since 7.0.0
 	 *
 	 * @param bool  $is_hidden_by_default Whether the responsive menu is hidden by default.
-	 * @param bool  $has_custom_overlay Whether a custom overlay is used.
-	 * @param array $colors The colors array.
+	 * @param bool  $has_custom_overlay   Whether a custom overlay is used.
+	 * @param array $colors               The colors array.
 	 * @return array Returns the responsive container classes.
 	 */
 	private static function get_responsive_container_classes( $is_hidden_by_default, $has_custom_overlay, $colors ) {
@@ -722,8 +722,8 @@ private static function get_overlay_inline_styles( $has_custom_overlay, $colors
 	 *
 	 * @since 6.5.0
 	 *
-	 * @param array         $attributes The block attributes.
-	 * @param WP_Block_List $inner_blocks The list of inner blocks.
+	 * @param array         $attributes        The block attributes.
+	 * @param WP_Block_List $inner_blocks      The list of inner blocks.
 	 * @param string        $inner_blocks_html The markup for the inner blocks.
 	 * @return string Returns the container markup.
 	 */
@@ -961,7 +961,7 @@ private static function handle_view_script_module_loading( $attributes, $block,
 	 *
 	 * @since 6.5.0
 	 *
-	 * @param array         $attributes The block attributes.
+	 * @param array         $attributes   The block attributes.
 	 * @param WP_Block_List $inner_blocks The list of inner blocks.
 	 * @return string Returns the navigation wrapper markup.
 	 */

src/wp-includes/blocks/page-list.php

@@ -128,14 +128,14 @@ function block_core_page_list_build_css_colors( $attributes, $context ) {
  *
  * @since 5.8.0
  *
- * @param string  $submenu_visibility The submenu visibility mode: 'hover', 'click', or 'always'.
- * @param boolean $show_submenu_icons Whether to show submenu indicator icons.
- * @param boolean $is_navigation_child If block is a child of Navigation block.
- * @param array   $nested_pages The array of nested pages.
- * @param boolean $is_nested Whether the submenu is nested or not.
+ * @param string  $submenu_visibility       The submenu visibility mode: 'hover', 'click', or 'always'.
+ * @param boolean $show_submenu_icons       Whether to show submenu indicator icons.
+ * @param boolean $is_navigation_child      If block is a child of Navigation block.
+ * @param array   $nested_pages             The array of nested pages.
+ * @param boolean $is_nested                Whether the submenu is nested or not.
  * @param array   $active_page_ancestor_ids An array of ancestor ids for active page.
- * @param array   $colors Color information for overlay styles.
- * @param integer $depth The nesting depth.
+ * @param array   $colors                   Color information for overlay styles.
+ * @param integer $depth                    The nesting depth.
  *
  * @return string List markup.
  */
@@ -227,7 +227,7 @@ function block_core_page_list_render_nested_page_list( $submenu_visibility, $sho
  * @since 5.8.0
  *
  * @param array $current_level The level being iterated through.
- * @param array $children The children grouped by parent post ID.
+ * @param array $children      The children grouped by parent post ID.
  *
  * @return array The nested array of pages.
  */

src/wp-includes/blocks/social-link.php

@@ -131,7 +131,7 @@ function block_core_social_link_get_name( $service ) {
  * @since 5.4.0
  *
  * @param string $service The service slug to extract data from.
- * @param string $field The field ('name', 'icon', etc) to extract for a service.
+ * @param string $field   The field ('name', 'icon', etc) to extract for a service.
  *
  * @return array|string
  */

src/wp-includes/blocks/widget-group.php

@@ -14,8 +14,8 @@
  * @global int|string $_sidebar_being_rendered
  *
  * @param array    $attributes The block attributes.
- * @param string   $content The block content.
- * @param WP_Block $block The block.
+ * @param string   $content    The block content.
+ * @param WP_Block $block      The block.
  *
  * @return string Rendered block.
  */

src/wp-includes/class-wp-theme-json-schema.php

@@ -37,9 +37,9 @@ class WP_Theme_JSON_Schema {
 	 * @since 5.9.0
 	 * @since 6.6.0 Migrate up to v3 and add $origin parameter.
 	 *
-	 * @param array $theme_json The structure to migrate.
-	 * @param string $origin    Optional. What source of data this object represents.
-	 *                          One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.
+	 * @param array  $theme_json The structure to migrate.
+	 * @param string $origin     Optional. What source of data this object represents.
+	 *                           One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.
 	 * @return array The structure in the last version.
 	 */
 	public static function migrate( $theme_json, $origin = 'theme' ) {
@@ -100,7 +100,7 @@ private static function migrate_v1_to_v2( $old ) {
 	 *
 	 * @since 6.6.0
 	 *
-	 * @param array $old     Data to migrate.
+	 * @param array  $old    Data to migrate.
 	 * @param string $origin What source of data this object represents.
 	 *                       One of 'blocks', 'default', 'theme', or 'custom'.
 	 * @return array Data with defaultFontSizes set to false.
@@ -213,7 +213,7 @@ private static function rename_settings( &$settings, $paths_to_rename ) {
 	 * @since 5.9.0
 	 *
 	 * @param array $settings Reference to the current settings array.
-	 * @param array $path Path to the property to be removed.
+	 * @param array $path     Path to the property to be removed.
 	 */
 	private static function unset_setting_by_path( &$settings, $path ) {
 		$tmp_settings = &$settings;

src/wp-includes/class-wp-theme-json.php

@@ -954,11 +954,11 @@ protected static function schema_in_root_and_per_origin( $schema ) {
 	/**
 	 * Processes pseudo-selectors for any node (block or variation).
 	 *
-	 * @param array  $node The node data (block or variation).
-	 * @param string $base_selector The base selector.
-	 * @param array  $settings The theme settings.
-	 * @param string $block_name The block name.
-	 * @param array|null $block_metadata Metadata about the block to get styles for.
+	 * @param array      $node            The node data (block or variation).
+	 * @param string     $base_selector   The base selector.
+	 * @param array      $settings        The theme settings.
+	 * @param string     $block_name      The block name.
+	 * @param array|null $block_metadata  Metadata about the block to get styles for.
 	 * @param array|null $style_variation Style variation metadata.
 	 * @return array Array of pseudo-selector declarations.
 	 */
@@ -2995,11 +2995,11 @@ protected static function flatten_tree( $tree, $prefix = '', $token = '--' ) {
 	 * @since 6.6.0 Pass current theme JSON settings to wp_get_typography_font_size_value(), and process background properties.
 	 * @since 6.7.0 `ref` resolution of background properties, and assigning custom default values.
 	 *
-	 * @param array   $styles Styles to process.
-	 * @param array   $settings Theme settings.
-	 * @param array   $properties Properties metadata.
-	 * @param array   $theme_json Theme JSON array.
-	 * @param string  $selector The style block selector.
+	 * @param array   $styles           Styles to process.
+	 * @param array   $settings         Theme settings.
+	 * @param array   $properties       Properties metadata.
+	 * @param array   $theme_json       Theme JSON array.
+	 * @param string  $selector         The style block selector.
 	 * @param boolean $use_root_padding Whether to add custom properties at root level.
 	 * @return array Returns the modified $declarations.
 	 */
@@ -3133,8 +3133,8 @@ protected static function compute_style_properties( $styles, $settings = array()
 	 *              so every property will be in the standard form.
 	 * @since 6.7.0 Added support for background image refs.
 	 *
-	 * @param array $styles Styles subtree.
-	 * @param array $path   Which property to process.
+	 * @param array $styles     Styles subtree.
+	 * @param array $path       Which property to process.
 	 * @param array $theme_json Theme JSON array.
 	 * @return string|array Style property value.
 	 */
@@ -4195,7 +4195,7 @@ static function ( $pseudo_selector ) use ( $selector ) {
 	 *              Updated specificity of body margin reset and first/last child selectors.
 	 * @since 7.0.0 Added `$options` parameter to control alignment styles output for classic themes.
 	 *
-	 * @param string $selector The root node selector.
+	 * @param string $selector       The root node selector.
 	 * @param array  $block_metadata The metadata for the root block.
 	 * @param array  $options        Optional. An array of options for now used for internal purposes only.
 	 * @return string The additional root rules CSS.
@@ -4598,7 +4598,7 @@ protected static function get_default_slugs( $data, $node_path ) {
 	 *
 	 * @since 5.9.0
 	 *
-	 * @param string $slug The slug we want to find a match from default presets.
+	 * @param string $slug      The slug we want to find a match from default presets.
 	 * @param array  $base_path The path to inspect. It's 'settings' by default.
 	 * @return string|null
 	 */
@@ -5911,7 +5911,7 @@ function ( $matches ) use ( $variation_class ) {
 	 *
 	 * @since 7.0.0
 	 *
-	 * @param array  $style_variation Style variation metadata.
+	 * @param array  $style_variation  Style variation metadata.
 	 * @param string $feature_selector CSS selector for the feature.
 	 * @return string Feature selector with block style variation selector added.
 	 */

src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php

@@ -125,7 +125,7 @@ public function get_all_rules() {
 	 * @since 6.1.0
 	 * @since 6.6.0 Added the $rules_group parameter.
 	 *
-	 * @param string $selector The CSS selector.
+	 * @param string $selector    The CSS selector.
 	 * @param string $rules_group A parent CSS selector in the case of nested CSS, or a CSS nested @rule,
 	 *                            such as `@media (min-width: 80rem)` or `@layer module`.
 	 * @return WP_Style_Engine_CSS_Rule|null Returns a WP_Style_Engine_CSS_Rule object,