Docs: Update various class @var tags to indicate nullability.

This updates various `@var` tags on class properties to correctly indicate that the props may be `null` or unset:

* `WP_Dependencies::$all_queued_deps` is nullable by both `::enqueue()` and `::dequeue`. Also, the types of the keys and values are specified. 
* `WP_Duotone::$global_styles_presets` and `::$global_styles_block_names` start off unset and are only initialized by static classes.
* `WP_Query::init()` and `WP_Rewrite::init()` are public methods that `unset()`s many class props.
* `WP_Theme::cache_delete()` sets many props to `null`.

Developed in #8953

Props justlevine, westonruter.
See #64238, #64224.


git-svn-id: https://develop.svn.wordpress.org/trunk@61299 602fd350-edb4-49c9-b593-d223f7449a82

Author: westonruter

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

@@ -91,7 +91,7 @@ class WP_Dependencies {
 	 *
 	 * @since 5.4.0
 	 *
-	 * @var array
+	 * @var ?array<string, true>
 	 */
 	private $all_queued_deps;
 

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

@@ -52,7 +52,7 @@ class WP_Duotone {
 	 *
 	 * @since 6.3.0
 	 *
-	 * @var array
+	 * @var ?array
 	 */
 	private static $global_styles_block_names;
 
@@ -76,7 +76,7 @@ class WP_Duotone {
 	 *
 	 * @since 6.3.0
 	 *
-	 * @var array
+	 * @var ?array
 	 */
 	private static $global_styles_presets;
 

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

@@ -22,7 +22,7 @@ class WP_Query {
 	 * Query vars set by the user.
 	 *
 	 * @since 1.5.0
-	 * @var array
+	 * @var ?array
 	 */
 	public $query;
 
@@ -72,23 +72,23 @@ class WP_Query {
 	 * The ID of the queried object.
 	 *
 	 * @since 1.5.0
-	 * @var int
+	 * @var ?int
 	 */
 	public $queried_object_id;
 
 	/**
 	 * SQL for the database query.
 	 *
 	 * @since 2.0.1
-	 * @var string
+	 * @var ?string
 	 */
 	public $request;
 
 	/**
 	 * Array of post objects or post IDs.
 	 *
 	 * @since 1.5.0
-	 * @var WP_Post[]|int[]
+	 * @var WP_Post[]|int[]|null
 	 */
 	public $posts;
 
@@ -139,7 +139,7 @@ class WP_Query {
 	 * The list of comments for current post.
 	 *
 	 * @since 2.2.0
-	 * @var WP_Comment[]
+	 * @var ?WP_Comment[]
 	 */
 	public $comments;
 
@@ -163,7 +163,7 @@ class WP_Query {
 	 * Current comment object.
 	 *
 	 * @since 2.2.0
-	 * @var WP_Comment
+	 * @var ?WP_Comment
 	 */
 	public $comment;
 
@@ -466,7 +466,7 @@ class WP_Query {
 	 * Cached list of search stopwords.
 	 *
 	 * @since 3.7.0
-	 * @var array
+	 * @var ?array
 	 */
 	private $stopwords;
 

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

@@ -52,23 +52,23 @@ class WP_Rewrite {
 	 * Permalink structure for author archives.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $author_structure;
 
 	/**
 	 * Permalink structure for date archives.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $date_structure;
 
 	/**
 	 * Permalink structure for pages.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $page_structure;
 
@@ -84,7 +84,7 @@ class WP_Rewrite {
 	 * Permalink structure for searches.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $search_structure;
 
@@ -124,15 +124,15 @@ class WP_Rewrite {
 	 * Comments feed permalink structure.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $comment_feed_structure;
 
 	/**
 	 * Feed request permalink structure.
 	 *
 	 * @since 1.5.0
-	 * @var string
+	 * @var ?string
 	 */
 	public $feed_structure;
 

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

@@ -114,15 +114,15 @@ final class WP_Theme implements ArrayAccess {
 	 * Header data from the theme's style.css file after being sanitized.
 	 *
 	 * @since 3.4.0
-	 * @var array
+	 * @var ?array
 	 */
 	private $headers_sanitized;
 
 	/**
 	 * Is this theme a block theme.
 	 *
 	 * @since 6.2.0
-	 * @var bool
+	 * @var ?bool
 	 */
 	private $block_theme;
 
@@ -132,15 +132,15 @@ final class WP_Theme implements ArrayAccess {
 	 * Cached due to sorting functions running over the translated name.
 	 *
 	 * @since 3.4.0
-	 * @var string
+	 * @var ?string
 	 */
 	private $name_translated;
 
 	/**
 	 * Errors encountered when initializing the theme.
 	 *
 	 * @since 3.4.0
-	 * @var WP_Error
+	 * @var ?WP_Error
 	 */
 	private $errors;
 
@@ -162,31 +162,31 @@ final class WP_Theme implements ArrayAccess {
 	 * Otherwise, 'template' is the same as 'stylesheet'.
 	 *
 	 * @since 3.4.0
-	 * @var string
+	 * @var ?string
 	 */
 	private $template;
 
 	/**
 	 * A reference to the parent theme, in the case of a child theme.
 	 *
 	 * @since 3.4.0
-	 * @var WP_Theme
+	 * @var ?WP_Theme
 	 */
 	private $parent;
 
 	/**
 	 * URL to the theme root, usually an absolute URL to wp-content/themes
 	 *
 	 * @since 3.4.0
-	 * @var string
+	 * @var ?string
 	 */
 	private $theme_root_uri;
 
 	/**
 	 * Flag for whether the theme's textdomain is loaded.
 	 *
 	 * @since 3.4.0
-	 * @var bool
+	 * @var ?bool
 	 */
 	private $textdomain_loaded;
 
@@ -202,7 +202,7 @@ final class WP_Theme implements ArrayAccess {
 	 * Block template folders.
 	 *
 	 * @since 6.4.0
-	 * @var string[]
+	 * @var ?string[]
 	 */
 	private $block_template_folders;