Merge branch 'trunk' into backport/78404-site-preview-dip

Author: adamsilverstein

src/js/_enqueues/lib/admin-bar.js

@@ -417,7 +417,7 @@
 				};
 		}
 
-		// Get the closest matching elent.
+		// Get the closest matching element.
 		for ( ; el && el !== document; el = el.parentNode ) {
 			if ( el.matches( selector ) ) {
 				return el;

src/js/_enqueues/wp/api.js

@@ -983,7 +983,7 @@
 			},
 
 			/**
-			 * Extend Backbone.Collection.sync to add nince and pagination support.
+			 * Extend Backbone.Collection.sync to add nonce and pagination support.
 			 *
 			 * Set nonce header before every Backbone sync.
 			 *
@@ -1288,7 +1288,7 @@
 					parentName = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), false ),
 					routeEnd   = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), true );
 
-				// Clear the parent part of the rouite if its actually the version string.
+				// Clear the parent part of the route if it's actually the version string.
 				if ( parentName === routeModel.get( 'versionString' ) ) {
 					parentName = '';
 				}

src/js/_enqueues/wp/customize/controls.js

@@ -590,7 +590,7 @@
 			return deferred.reject( { code: 'illegal_status_in_changeset_update' } ).promise();
 		}
 
-		// Dates not beung allowed for revisions are is a technical limitation of post revisions.
+		// Dates not being allowed for revisions is a technical limitation of post revisions.
 		if ( submittedArgs.date && submittedArgs.autosave ) {
 			return deferred.reject( { code: 'illegal_autosave_with_date_gmt' } ).promise();
 		}

src/js/_enqueues/wp/customize/nav-menus.js

@@ -3539,7 +3539,7 @@
 
 	/**
 	 * Apply sanitize_text_field()-like logic to the supplied name, returning a
-	 * "unnammed" fallback string if the name is then empty.
+	 * "unnamed" fallback string if the name is then empty.
 	 *
 	 * @alias wp.customize.Menus~displayNavMenuName
 	 *

src/wp-content/themes/twentysixteen/css/editor-blocks.css

@@ -349,6 +349,11 @@ figure[class*="wp-block-"] > figcaption {
 	font-style: normal;
 }
 
+.wp-block-quote__citation em,
+.wp-block-quote__citation i {
+	font-style: italic;
+}
+
 .wp-block-quote strong,
 .wp-block-quote b {
 	font-weight: 400;

src/wp-content/themes/twentysixteen/style.css

@@ -385,6 +385,11 @@ blockquote cite {
 	font-style: normal;
 }
 
+blockquote :where(cite) em,
+blockquote :where(cite) i {
+	font-style: italic;
+}
+
 blockquote strong,
 blockquote b {
 	font-weight: 400;

src/wp-content/themes/twentyten/functions.php

@@ -72,6 +72,8 @@
 	 * @uses set_post_thumbnail_size()  To set a custom post thumbnail size.
 	 *
 	 * @since Twenty Ten 1.0
+	 *
+	 * @global string $wp_version The WordPress version string.
 	 */
 	function twentyten_setup() {
 
@@ -436,7 +438,12 @@ function twentyten_custom_excerpt_more( $output ) {
 function twentyten_remove_gallery_css( $css ) {
 	return preg_replace( "#<style type='text/css'>(.*?)</style>#s", '', $css );
 }
-// Backward compatibility with WordPress 3.0.
+
+/**
+ * Backward compatibility with WordPress 3.0.
+ *
+ * @global string $wp_version The WordPress version string.
+ */
 if ( version_compare( $GLOBALS['wp_version'], '3.1', '<' ) ) {
 	add_filter( 'gallery_style', 'twentyten_remove_gallery_css' );
 }
@@ -452,8 +459,10 @@ function twentyten_remove_gallery_css( $css ) {
 	 *
 	 * @since Twenty Ten 1.0
 	 *
+	 * @global WP_Comment $comment Global comment object.
+	 *
 	 * @param WP_Comment $comment The comment object.
-	 * @param array      $args    An array of arguments. @see get_comment_reply_link()
+	 * @param array      $args    An array of comment arguments. @see get_comment_reply_link()
 	 * @param int        $depth   The depth of the comment.
 	 */
 	function twentyten_comment( $comment, $args, $depth ) {

src/wp-content/themes/twentyten/header.php

@@ -8,17 +8,20 @@
  * @subpackage Twenty_Ten
  * @since Twenty Ten 1.0
  */
+
+/**
+ * @global int $page  WordPress paginated post page count.
+ * @global int $paged WordPress archive pagination page count.
+ */
+global $page, $paged;
+
 ?><!DOCTYPE html>
 <html <?php language_attributes(); ?>>
 <head>
 <meta charset="<?php bloginfo( 'charset' ); ?>" />
 <title>
 <?php
-	/*
-	 * Print the <title> tag based on what is being viewed.
-	 */
-	global $page, $paged;
-
+	// Print the <title> tag based on what is being viewed.
 	wp_title( '|', true, 'right' );
 
 	// Add the site name.

src/wp-includes/class-wp-icons-registry.php

@@ -16,14 +16,15 @@ class WP_Icons_Registry {
 	/**
 	 * Registered icons array.
 	 *
+	 * @since 7.0.0
 	 * @var array[]
 	 */
 	protected $registered_icons = array();
 
-
 	/**
 	 * Container for the main instance of the class.
 	 *
+	 * @since 7.0.0
 	 * @var WP_Icons_Registry|null
 	 */
 	protected static $instance = null;
@@ -39,6 +40,8 @@ class WP_Icons_Registry {
 	 * These icons are defined in @wordpress/packages (Gutenberg repository) as
 	 * SVG files and as entries in a single manifest file. On init, the
 	 * registry is loaded with those icons listed in the manifest.
+	 *
+	 * @since 7.0.0
 	 */
 	protected function __construct() {
 		$icons_directory = __DIR__ . '/images/icon-library/';
@@ -88,6 +91,8 @@ protected function __construct() {
 	/**
 	 * Registers an icon.
 	 *
+	 * @since 7.0.0
+	 *
 	 * @param string $icon_name       Icon name including namespace.
 	 * @param array  $icon_properties {
 	 *     List of properties for the icon.
@@ -184,6 +189,8 @@ protected function register( $icon_name, $icon_properties ) {
 	 * Logic borrowed from twentytwenty.
 	 * @see twentytwenty_get_theme_svg
 	 *
+	 * @since 7.0.0
+	 *
 	 * @param string $icon_content The icon SVG content to sanitize.
 	 * @return string The sanitized icon SVG content.
 	 */
@@ -219,6 +226,8 @@ protected function sanitize_icon_content( $icon_content ) {
 	/**
 	 * Retrieves the content of a registered icon.
 	 *
+	 * @since 7.0.0
+	 *
 	 * @param string $icon_name Icon name including namespace.
 	 * @return string|null The content of the icon, if found.
 	 */
@@ -245,6 +254,7 @@ protected function get_content( $icon_name ) {
 	/**
 	 * Retrieves an array containing the properties of a registered icon.
 	 *
+	 * @since 7.0.0
 	 *
 	 * @param string $icon_name Icon name including namespace.
 	 * @return array|null Registered icon properties or `null` if the icon is not registered.
@@ -263,6 +273,8 @@ public function get_registered_icon( $icon_name ) {
 	/**
 	 * Retrieves all registered icons.
 	 *
+	 * @since 7.0.0
+	 *
 	 * @param string $search Optional. Search term by which to filter the icons.
 	 * @return array[] Array of arrays containing the registered icon properties.
 	 */
@@ -284,6 +296,7 @@ public function get_registered_icons( $search = '' ) {
 	/**
 	 * Checks if an icon is registered.
 	 *
+	 * @since 7.0.0
 	 *
 	 * @param string $icon_name Icon name including namespace.
 	 * @return bool True if the icon is registered, false otherwise.
@@ -297,6 +310,7 @@ public function is_registered( $icon_name ) {
 	 *
 	 * The instance will be created if it does not exist yet.
 	 *
+	 * @since 7.0.0
 	 *
 	 * @return WP_Icons_Registry The main instance.
 	 */

src/wp-includes/class-wp-post.php

@@ -36,6 +36,7 @@ final class WP_Post {
 	 *
 	 * @since 3.5.0
 	 * @var string
+	 * @phpstan-var numeric-string
 	 */
 	public $post_author = '0';
 
@@ -206,6 +207,7 @@ final class WP_Post {
 	 *
 	 * @since 3.5.0
 	 * @var string
+	 * @phpstan-var numeric-string
 	 */
 	public $comment_count = '0';