From 8ecd5dbef8cc951719a1a8227f411e75439b90de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Sz=C3=A9pe?= <viktor@szepe.net>
Date: Wed, 12 Feb 2025 10:44:51 +0100
Subject: [PATCH 1/9] Upgrade PHPStan to v2 (#274)

---
 composer.json                        |  2 +-
 phpstan.neon.dist                    | 11 ++++++++---
 tests/Faker.php                      |  4 +++-
 tests/data/Faker.php                 |  6 +++---
 tests/data/_wp_json_sanity_check.php |  2 +-
 tests/data/stripslashes.php          |  4 ++--
 tests/data/wpdb.php                  |  4 ++--
 tests/phpstan.neon                   |  2 --
 8 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/composer.json b/composer.json
index fb8ebe88..8cd42f5d 100644
--- a/composer.json
+++ b/composer.json
@@ -14,7 +14,7 @@
         "nikic/php-parser": "^4.13",
         "php-stubs/generator": "^0.8.3",
         "phpdocumentor/reflection-docblock": "^5.4.1",
-        "phpstan/phpstan": "^1.11",
+        "phpstan/phpstan": "^2.1",
         "phpunit/phpunit": "^9.5",
         "szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset": "^1.1.1",
         "wp-coding-standards/wpcs": "3.1.0 as 2.3.0"
diff --git a/phpstan.neon.dist b/phpstan.neon.dist
index 92981a87..c9c6402c 100644
--- a/phpstan.neon.dist
+++ b/phpstan.neon.dist
@@ -7,7 +7,12 @@ parameters:
         - tests/
     excludePaths:
         - tests/data/
+    phpVersion:
+        min: 80000
+        max: 80300
     level: 9
-    featureToggles:
-        alwaysTrueAlwaysReported: true
-        listType: true
+    ignoreErrors:
+        -
+            path: tests/Faker.php
+            identifier: class.notFound
+            count: 8
diff --git a/tests/Faker.php b/tests/Faker.php
index cecbb79c..d47e632f 100644
--- a/tests/Faker.php
+++ b/tests/Faker.php
@@ -88,8 +88,10 @@ public static function list($type = null): array
      * @template T
      * @param T ...$types
      * @return T
+     *
+     * @phpcs:disable NeutronStandard.Functions.TypeHint
      */
-    public static function union(...$types): mixed
+    public static function union(...$types)
     {
         return $types[0];
     }
diff --git a/tests/data/Faker.php b/tests/data/Faker.php
index 7f5182e5..042b993f 100644
--- a/tests/data/Faker.php
+++ b/tests/data/Faker.php
@@ -26,7 +26,7 @@
 assertType('non-empty-string', Faker::nonEmptyString());
 
 // Arrays with default values
-assertType('array', Faker::array());
+assertType('array<mixed>', Faker::array());
 assertType('array<int, mixed>', Faker::intArray());
 assertType('array<string, mixed>', Faker::strArray());
 assertType('list<mixed>', Faker::list());
@@ -44,8 +44,8 @@
 assertType('array<int, int>|bool|int|string', Faker::union(Faker::bool(), Faker::int(), Faker::string(), Faker::intArray(Faker::int())));
 assertType('array<int|string, int|string>', Faker::union(Faker::intArray(Faker::int()), Faker::strArray(Faker::string())));
 assertType('array<int|string>', Faker::union(Faker::array(Faker::int()), Faker::strArray(Faker::string())));
-assertType('array', Faker::union(Faker::array(), Faker::strArray()));
-assertType('array', Faker::union(Faker::array(), Faker::intArray()));
+assertType('array<mixed>', Faker::union(Faker::array(), Faker::strArray()));
+assertType('array<mixed>', Faker::union(Faker::array(), Faker::intArray()));
 assertType('string|null', Faker::union(Faker::string(), null));
 
 // Other
diff --git a/tests/data/_wp_json_sanity_check.php b/tests/data/_wp_json_sanity_check.php
index ceab47f9..28fdc1bd 100644
--- a/tests/data/_wp_json_sanity_check.php
+++ b/tests/data/_wp_json_sanity_check.php
@@ -11,6 +11,6 @@
 assertType('bool', _wp_json_sanity_check(Faker::bool(), 1));
 assertType('int', _wp_json_sanity_check(Faker::int(), 1));
 assertType('string', _wp_json_sanity_check(Faker::string(), 1));
-assertType('array', _wp_json_sanity_check(Faker::array(), 1));
+assertType('array<mixed>', _wp_json_sanity_check(Faker::array(), 1));
 assertType('stdClass', _wp_json_sanity_check(Faker::stdClass(), 1));
 assertType('mixed', _wp_json_sanity_check(Faker::mixed(), 1));
diff --git a/tests/data/stripslashes.php b/tests/data/stripslashes.php
index 3d3e8a7f..1d937372 100644
--- a/tests/data/stripslashes.php
+++ b/tests/data/stripslashes.php
@@ -13,7 +13,7 @@
 assertType('int', stripslashes_deep(Faker::int()));
 assertType('float', stripslashes_deep(Faker::float()));
 assertType('string', stripslashes_deep(Faker::string()));
-assertType('array', stripslashes_deep(Faker::array()));
+assertType('array<mixed>', stripslashes_deep(Faker::array()));
 assertType('resource', stripslashes_deep(Faker::resource()));
 assertType('object', stripslashes_deep(Faker::object()));
 
@@ -22,6 +22,6 @@
 assertType('int', stripslashes_from_strings_only(Faker::int()));
 assertType('float', stripslashes_from_strings_only(Faker::float()));
 assertType('string', stripslashes_from_strings_only(Faker::string()));
-assertType('array', stripslashes_from_strings_only(Faker::array()));
+assertType('array<mixed>', stripslashes_from_strings_only(Faker::array()));
 assertType('resource', stripslashes_from_strings_only(Faker::resource()));
 assertType('object', stripslashes_from_strings_only(Faker::object()));
diff --git a/tests/data/wpdb.php b/tests/data/wpdb.php
index 551a0298..6244536f 100644
--- a/tests/data/wpdb.php
+++ b/tests/data/wpdb.php
@@ -10,11 +10,11 @@
 // wpdb::get_row()
 assertType('stdClass|null', wpdb::get_row());
 assertType('stdClass|null', wpdb::get_row(null, 'OBJECT'));
-assertType('array|null', wpdb::get_row(null, 'ARRAY_A'));
+assertType('array<mixed>|null', wpdb::get_row(null, 'ARRAY_A'));
 assertType('list<mixed>|null', wpdb::get_row(null, 'ARRAY_N'));
 
 // wpdb::get_results()
-assertType('list<array>|null', wpdb::get_results(null, 'ARRAY_A'));
+assertType('list<array<mixed>>|null', wpdb::get_results(null, 'ARRAY_A'));
 assertType('list<array<int, mixed>>|null', wpdb::get_results(null, 'ARRAY_N'));
 assertType('list<stdClass>|null', wpdb::get_results());
 assertType('list<stdClass>|null', wpdb::get_results(null, 'OBJECT'));
diff --git a/tests/phpstan.neon b/tests/phpstan.neon
index 098f5a1d..1673aee1 100644
--- a/tests/phpstan.neon
+++ b/tests/phpstan.neon
@@ -1,5 +1,3 @@
 parameters:
     bootstrapFiles:
         - ../wordpress-stubs.php
-    featureToggles:
-        listType: true

From 99dabe49f5b153da0eca2f113475c410a66d342a Mon Sep 17 00:00:00 2001
From: IanDelMar <42134098+IanDelMar@users.noreply.github.com>
Date: Thu, 13 Feb 2025 09:05:34 +0100
Subject: [PATCH 2/9] Narrow return type for get_current_blog_id (#275)

---
 functionMap.php     | 1 +
 wordpress-stubs.php | 1 +
 2 files changed, 2 insertions(+)

diff --git a/functionMap.php b/functionMap.php
index 8e857253..8fd0de88 100644
--- a/functionMap.php
+++ b/functionMap.php
@@ -219,4 +219,5 @@
     'wp_nonce_url' => [null, 'action' => '-1|string'],
     'wp_nonce_field' => [null, 'action' => '-1|string'],
     'did_action' => ['int<0, max>'],
+    'get_current_blog_id' => ['int<0, max>'],
 ];
diff --git a/wordpress-stubs.php b/wordpress-stubs.php
index 361bbbfd..fa6b6000 100644
--- a/wordpress-stubs.php
+++ b/wordpress-stubs.php
@@ -121165,6 +121165,7 @@ function absint($maybeint)
      * @global int $blog_id
      *
      * @return int Site ID.
+     * @phpstan-return int<0, max>
      */
     function get_current_blog_id()
     {

From 5389907fafc42cf1012af9334372c30a4d05dbd0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Sz=C3=A9pe?= <viktor@szepe.net>
Date: Wed, 16 Apr 2025 14:01:06 +0000
Subject: [PATCH 3/9] Generate stubs for WordPress 6.8.0

---
 source/composer.json |    2 +-
 wordpress-stubs.php  | 1603 ++++++++++++++++++++++++++++++------------
 2 files changed, 1139 insertions(+), 466 deletions(-)

diff --git a/source/composer.json b/source/composer.json
index d1b80e15..58482730 100644
--- a/source/composer.json
+++ b/source/composer.json
@@ -7,7 +7,7 @@
         "ext-mbstring": "*",
         "ext-openssl": "*",
         "ext-sodium": "*",
-        "johnpbloch/wordpress": "6.7.2"
+        "johnpbloch/wordpress": "6.8.0"
     },
     "minimum-stability": "stable",
     "config": {
diff --git a/wordpress-stubs.php b/wordpress-stubs.php
index fa6b6000..cb6cc4ed 100644
--- a/wordpress-stubs.php
+++ b/wordpress-stubs.php
@@ -732,7 +732,7 @@ public function clear_destination($remote_destination)
          * @since 6.2.0 Use move_dir() instead of copy_dir() when possible.
          *
          * @global WP_Filesystem_Base $wp_filesystem        WordPress filesystem subclass.
-         * @global array              $wp_theme_directories
+         * @global string[]           $wp_theme_directories
          *
          * @param array|string $args {
          *     Optional. Array or string of arguments for installing a package. Default empty array.
@@ -3179,6 +3179,14 @@ class Walker_Nav_Menu extends \Walker
          * @see Walker::$db_fields
          */
         public $db_fields = array('parent' => 'menu_item_parent', 'id' => 'db_id');
+        /**
+         * Constructor.
+         *
+         * @since 6.8.0
+         */
+        public function __construct()
+        {
+        }
         /**
          * Starts the list before the elements are added.
          *
@@ -7330,7 +7338,7 @@ public function cmpr_strlen($a, $b)
          * @param bool   $head
          * @return array
          */
-        public function get_page($url, $username = '', $password = '', $head = \false)
+        public function get_page($url, $username = '', #[\SensitiveParameter] $password = '', $head = \false)
         {
         }
         /**
@@ -7801,6 +7809,7 @@ public function column_title($post)
          * Handles the author column output.
          *
          * @since 4.3.0
+         * @since 6.8.0 Added fallback text when author's name is unknown.
          *
          * @param WP_Post $post The current WP_Post object.
          */
@@ -9218,6 +9227,7 @@ public function column_comments($post)
          * Handles the post author column output.
          *
          * @since 4.3.0
+         * @since 6.8.0 Added fallback text when author's name is unknown.
          *
          * @param WP_Post $post The current WP_Post object.
          */
@@ -9418,7 +9428,8 @@ public function column_cb($item)
          * @since 4.9.6
          *
          * @param WP_User_Request $item Item being shown.
-         * @return string Status column markup.
+         * @return string|void Status column markup. Returns a string if no status is found,
+         *                     otherwise it displays the markup.
          */
         public function column_status($item)
         {
@@ -10234,7 +10245,8 @@ public function run_tests()
          * @param string $constant         The name of the constant to check.
          * @param bool|string|array $value The value that the constant should be, if set,
          *                                 or an array of acceptable values.
-         * @return array The test results.
+         * @return array|null The test results if there are any constants set incorrectly,
+         *                    or null if the test passed.
          */
         public function test_constants($constant, $value)
         {
@@ -10244,7 +10256,8 @@ public function test_constants($constant, $value)
          *
          * @since 5.2.0
          *
-         * @return array The test results.
+         * @return array|null The test results if wp_version_check() is disabled,
+         *                    or null if the test passed.
          */
         public function test_wp_version_check_attached()
         {
@@ -10254,7 +10267,8 @@ public function test_wp_version_check_attached()
          *
          * @since 5.2.0
          *
-         * @return array The test results.
+         * @return array|null The test results if the {@see 'automatic_updater_disabled'} filter is set,
+         *                    or null if the test passed.
          */
         public function test_filters_automatic_updater_disabled()
         {
@@ -10264,7 +10278,7 @@ public function test_filters_automatic_updater_disabled()
          *
          * @since 5.3.0
          *
-         * @return array|false The test results. False if auto-updates are enabled.
+         * @return array|false The test results if auto-updates are disabled, false otherwise.
          */
         public function test_wp_automatic_updates_disabled()
         {
@@ -10274,7 +10288,7 @@ public function test_wp_automatic_updates_disabled()
          *
          * @since 5.2.0
          *
-         * @return array|false The test results. False if the auto-updates failed.
+         * @return array|false The test results if auto-updates previously failed, false otherwise.
          */
         public function test_if_failed_update()
         {
@@ -10306,7 +10320,9 @@ public function test_check_wp_filesystem_method()
          *
          * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
          *
-         * @return array|false The test results. False if they're not writeable.
+         * @return array|false The test results if at least some of WordPress core files are writeable,
+         *                     or if a list of the checksums could not be retrieved from WordPress.org.
+         *                     False if the core files are not writeable.
          */
         public function test_all_files_writable()
         {
@@ -10316,7 +10332,8 @@ public function test_all_files_writable()
          *
          * @since 5.2.0
          *
-         * @return array|false The test results. False if it isn't a development version.
+         * @return array|false|null The test results if development updates are blocked.
+         *                          False if it isn't a development version. Null if the test passed.
          */
         public function test_accepts_dev_updates()
         {
@@ -10326,7 +10343,8 @@ public function test_accepts_dev_updates()
          *
          * @since 5.2.0
          *
-         * @return array The test results.
+         * @return array|null The test results if minor updates are blocked,
+         *                    or null if the test passed.
          */
         public function test_accepts_minor_updates()
         {
@@ -15458,7 +15476,7 @@ class PHPMailer
          * You can set your own, but it must be in the format "<id@domain>",
          * as defined in RFC5322 section 3.6.4 or it will be ignored.
          *
-         * @see https://tools.ietf.org/html/rfc5322#section-3.6.4
+         * @see https://www.rfc-editor.org/rfc/rfc5322#section-3.6.4
          *
          * @var string
          */
@@ -15577,7 +15595,7 @@ class PHPMailer
          * 'DELAY'   will notify you if there is an unusual delay in delivery, but the actual
          *           delivery's outcome (success or failure) is not yet decided.
          *
-         * @see https://tools.ietf.org/html/rfc3461 See section 4.1 for more information about NOTIFY
+         * @see https://www.rfc-editor.org/rfc/rfc3461.html#section-4.1 for more information about NOTIFY
          */
         public $dsn = '';
         /**
@@ -15906,7 +15924,7 @@ class PHPMailer
          *
          * @var string
          */
-        const VERSION = '6.9.2';
+        const VERSION = '6.9.3';
         /**
          * Error severity: message only, continue processing.
          *
@@ -17181,7 +17199,7 @@ public function DKIM_Sign($signHeader)
          * Uses the 'relaxed' algorithm from RFC6376 section 3.4.2.
          * Canonicalized headers should *always* use CRLF, regardless of mailer setting.
          *
-         * @see https://tools.ietf.org/html/rfc6376#section-3.4.2
+         * @see https://www.rfc-editor.org/rfc/rfc6376#section-3.4.2
          *
          * @param string $signHeader Header
          *
@@ -17195,7 +17213,7 @@ public function DKIM_HeaderC($signHeader)
          * Uses the 'simple' algorithm from RFC6376 section 3.4.3.
          * Canonicalized bodies should *always* use CRLF, regardless of mailer setting.
          *
-         * @see https://tools.ietf.org/html/rfc6376#section-3.4.3
+         * @see https://www.rfc-editor.org/rfc/rfc6376#section-3.4.3
          *
          * @param string $body Message Body
          *
@@ -17331,7 +17349,7 @@ class SMTP
          *
          * @var string
          */
-        const VERSION = '6.9.2';
+        const VERSION = '6.9.3';
         /**
          * SMTP line break constant.
          *
@@ -17354,7 +17372,7 @@ class SMTP
          * The maximum line length allowed by RFC 5321 section 4.5.3.1.6,
          * *excluding* a trailing CRLF break.
          *
-         * @see https://tools.ietf.org/html/rfc5321#section-4.5.3.1.6
+         * @see https://www.rfc-editor.org/rfc/rfc5321#section-4.5.3.1.6
          *
          * @var int
          */
@@ -17363,7 +17381,7 @@ class SMTP
          * The maximum line length allowed for replies in RFC 5321 section 4.5.3.1.5,
          * *including* a trailing CRLF line break.
          *
-         * @see https://tools.ietf.org/html/rfc5321#section-4.5.3.1.5
+         * @see https://www.rfc-editor.org/rfc/rfc5321#section-4.5.3.1.5
          *
          * @var int
          */
@@ -29774,6 +29792,7 @@ public static function is_in_use()
          *
          * @since 5.6.0
          * @since 5.7.0 Returns WP_Error if application name already exists.
+         * @since 6.8.0 The hashed password value now uses wp_fast_hash() instead of phpass.
          *
          * @param int   $user_id  User ID.
          * @param array $args     {
@@ -29897,6 +29916,7 @@ public static function application_name_exists_for_user($user_id, $name)
          * Updates an application password.
          *
          * @since 5.6.0
+         * @since 6.8.0 The actual password should now be hashed using wp_fast_hash().
          *
          * @param int    $user_id User ID.
          * @param string $uuid    The password's UUID.
@@ -30003,7 +30023,30 @@ protected static function set_user_application_passwords($user_id, $passwords)
          * @param string $raw_password The raw application password.
          * @return string The chunked password.
          */
-        public static function chunk_password($raw_password)
+        public static function chunk_password(#[\SensitiveParameter] $raw_password)
+        {
+        }
+        /**
+         * Hashes a plaintext application password.
+         *
+         * @since 6.8.0
+         *
+         * @param string $password Plaintext password.
+         * @return string Hashed password.
+         */
+        public static function hash_password(#[\SensitiveParameter] string $password) : string
+        {
+        }
+        /**
+         * Checks a plaintext application password against a hashed password.
+         *
+         * @since 6.8.0
+         *
+         * @param string $password Plaintext password.
+         * @param string $hash     Hash of the password to check against.
+         * @return bool Whether the password matches the hashed password.
+         */
+        public static function check_password(#[\SensitiveParameter] string $password, string $hash) : bool
         {
         }
     }
@@ -30488,6 +30531,23 @@ public static function register_collection($path, $manifest)
         public static function get_metadata($file_or_folder)
         {
         }
+        /**
+         * Gets the list of absolute paths to all block metadata files that are part of the given collection.
+         *
+         * For instance, if a block metadata collection is registered with path `WP_PLUGIN_DIR . '/my-plugin/blocks/'`,
+         * and the manifest file includes metadata for two blocks `'block-a'` and `'block-b'`, the result of this method
+         * will be an array containing:
+         * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-a/block.json'`
+         * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-b/block.json'`
+         *
+         * @since 6.8.0
+         *
+         * @param string $path The absolute base path for a previously registered collection.
+         * @return string[] List of block metadata file paths, or an empty array if the given `$path` is invalid.
+         */
+        public static function get_collection_block_metadata_files($path)
+        {
+        }
         /**
          * Checks if metadata exists for a given block name in a specific collection.
          *
@@ -32033,7 +32093,7 @@ class WP_Block
          * @var array
          * @access protected
          */
-        protected $available_context;
+        protected $available_context = array();
         /**
          * Block type registry.
          *
@@ -32108,6 +32168,35 @@ class WP_Block
         public function __construct($block, $available_context = array(), $registry = \null)
         {
         }
+        /**
+         * Updates the context for the current block and its inner blocks.
+         *
+         * The method updates the context of inner blocks, if any, by passing down
+         * any context values the block provides (`provides_context`).
+         *
+         * If the block has inner blocks, the method recursively processes them by creating new instances of `WP_Block`
+         * for each inner block and updating their context based on the block's `provides_context` property.
+         *
+         * @since 6.8.0
+         */
+        public function refresh_context_dependents()
+        {
+        }
+        /**
+         * Updates the parsed block content for the current block and its inner blocks.
+         *
+         * This method sets the `inner_html` and `inner_content` properties of the block based on the parsed
+         * block content provided during initialization. It ensures that the block instance reflects the
+         * most up-to-date content for both the inner HTML and any string fragments around inner blocks.
+         *
+         * If the block has inner blocks, this method initializes a new `WP_Block_List` for them, ensuring the
+         * correct content and context are updated for each nested block.
+         *
+         * @since 6.8.0
+         */
+        public function refresh_parsed_block_dependents()
+        {
+        }
         /**
          * Returns a value from an inaccessible property.
          *
@@ -32638,7 +32727,7 @@ final class WP_Comment
          * @since 4.4.0
          * @var string
          */
-        public $comment_post_ID = 0;
+        public $comment_post_ID = '0';
         /**
          * Comment author name.
          *
@@ -32696,7 +32785,7 @@ final class WP_Comment
          * @since 4.4.0
          * @var string
          */
-        public $comment_karma = 0;
+        public $comment_karma = '0';
         /**
          * Comment approval status.
          *
@@ -32727,7 +32816,7 @@ final class WP_Comment
          * @since 4.4.0
          * @var string
          */
-        public $comment_parent = 0;
+        public $comment_parent = '0';
         /**
          * Comment author ID.
          *
@@ -32736,7 +32825,7 @@ final class WP_Comment
          * @since 4.4.0
          * @var string
          */
-        public $user_id = 0;
+        public $user_id = '0';
         /**
          * Retrieves a WP_Comment instance.
          *
@@ -32860,8 +32949,8 @@ public function populated_children($set)
          *
          * @since 4.4.0
          *
-         * @param string $name Property name.
-         * @return bool
+         * @param string $name Property to check if set.
+         * @return bool Whether the property is set.
          */
         public function __isset($name)
         {
@@ -33086,7 +33175,7 @@ public function __construct($manager, $id, $args = array())
         {
         }
         /**
-         * Enqueue control related scripts/styles.
+         * Enqueues control related scripts/styles.
          *
          * @since 3.4.0
          */
@@ -33094,7 +33183,7 @@ public function enqueue()
         {
         }
         /**
-         * Check whether control is active to current Customizer preview.
+         * Checks whether control is active to current Customizer preview.
          *
          * @since 4.0.0
          *
@@ -33117,7 +33206,7 @@ public function active_callback()
         {
         }
         /**
-         * Fetch a setting's value.
+         * Fetches a setting's value.
          * Grabs the main setting by default.
          *
          * @since 3.4.0
@@ -33129,7 +33218,7 @@ public final function value($setting_key = 'default')
         {
         }
         /**
-         * Refresh the parameters passed to the JavaScript via JSON.
+         * Refreshes the parameters passed to the JavaScript via JSON.
          *
          * @since 3.4.0
          */
@@ -33137,7 +33226,7 @@ public function to_json()
         {
         }
         /**
-         * Get the data to export to the client via JSON.
+         * Gets the data to export to the client via JSON.
          *
          * @since 4.1.0
          *
@@ -33162,7 +33251,7 @@ public final function check_capabilities()
         {
         }
         /**
-         * Get the control's content for insertion into the Customizer pane.
+         * Gets the control's content for insertion into the Customizer pane.
          *
          * @since 4.1.0
          *
@@ -33172,7 +33261,7 @@ public final function get_content()
         {
         }
         /**
-         * Check capabilities and render the control.
+         * Checks capabilities and render the control.
          *
          * @since 3.4.0
          * @uses WP_Customize_Control::render()
@@ -33190,31 +33279,32 @@ protected function render()
         {
         }
         /**
-         * Get the data link attribute for a setting.
+         * Gets the data link attribute for a setting.
          *
          * @since 3.4.0
          * @since 4.9.0 Return a `data-customize-setting-key-link` attribute if a setting is not registered for the supplied setting key.
          *
          * @param string $setting_key
-         * @return string Data link parameter, a `data-customize-setting-link` attribute if the `$setting_key` refers to a pre-registered setting,
-         *                and a `data-customize-setting-key-link` attribute if the setting is not yet registered.
+         * @return string Data link parameter, a `data-customize-setting-link` attribute if the `$setting_key` refers
+         *                to a pre-registered setting, and a `data-customize-setting-key-link` attribute if the setting
+         *                is not yet registered.
          */
         public function get_link($setting_key = 'default')
         {
         }
         /**
-         * Render the data link attribute for the control's input element.
+         * Renders the data link attribute for the control's input element.
          *
          * @since 3.4.0
          * @uses WP_Customize_Control::get_link()
          *
-         * @param string $setting_key
+         * @param string $setting_key Default 'default'.
          */
         public function link($setting_key = 'default')
         {
         }
         /**
-         * Render the custom attributes for the control's input element.
+         * Renders the custom attributes for the control's input element.
          *
          * @since 4.0.0
          */
@@ -33222,7 +33312,7 @@ public function input_attrs()
         {
         }
         /**
-         * Render the control's content.
+         * Renders the control's content.
          *
          * Allows the content to be overridden without having to rewrite the wrapper in `$this::render()`.
          *
@@ -33238,7 +33328,7 @@ protected function render_content()
         {
         }
         /**
-         * Render the control's JS template.
+         * Renders the control's JS template.
          *
          * This function is only run for control types that have been registered with
          * WP_Customize_Manager::register_control_type().
@@ -37839,7 +37929,7 @@ final class _WP_Editors
          *     @type string|int $tabindex          Tabindex value to use. Default empty.
          *     @type string     $tabfocus_elements The previous and next element ID to move the focus to
          *                                         when pressing the Tab key in TinyMCE. Default ':prev,:next'.
-         *     @type string     $editor_css        Intended for extra styles for both Visual and Text editors.
+         *     @type string     $editor_css        Intended for extra styles for both Visual and Code editors.
          *                                         Should include `<style>` tags, and can use "scoped". Default empty.
          *     @type string     $editor_class      Extra classes to add to the editor textarea element. Default empty.
          *     @type bool       $teeny             Whether to output the minimal editor config. Examples include
@@ -40378,7 +40468,7 @@ public abstract function save($destfilename = \null, $mime_type = \null);
          *     If true, image will be cropped to the specified dimensions using center positions.
          *     If an array, the image will be cropped using the array to specify the crop location:
          *
-         *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+         *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
          *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
          * }
          * @return true|WP_Error
@@ -40503,11 +40593,13 @@ public function get_quality()
          * Sets Image Compression quality on a 1-100% scale.
          *
          * @since 3.5.0
+         * @since 6.8.0 The `$dims` parameter was added.
          *
-         * @param int $quality Compression Quality. Range: [1,100]
+         * @param int   $quality Compression Quality. Range: [1,100]
+         * @param array $dims    Optional. Image dimensions array with 'width' and 'height' keys.
          * @return true|WP_Error True if set successfully; WP_Error on failure.
          */
-        public function set_quality($quality = \null)
+        public function set_quality($quality = \null, $dims = array())
         {
         }
         /**
@@ -40542,6 +40634,7 @@ protected function get_output_format($filename = \null, $mime_type = \null)
          * Builds an output filename based on current file, and adding proper suffix
          *
          * @since 3.5.0
+         * @since 6.8.0 Passing an empty string as $suffix will now omit the suffix from the generated filename.
          *
          * @param string $suffix
          * @param string $dest_path
@@ -40689,7 +40782,7 @@ protected function update_size($width = \false, $height = \false)
          *     If true, image will be cropped to the specified dimensions using center positions.
          *     If an array, the image will be cropped using the array to specify the crop location:
          *
-         *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+         *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
          *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
          * }
          * @return true|WP_Error
@@ -40709,7 +40802,7 @@ public function resize($max_w, $max_h, $crop = \false)
          *     If true, image will be cropped to the specified dimensions using center positions.
          *     If an array, the image will be cropped using the array to specify the crop location:
          *
-         *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+         *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
          *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
          * }
          * @return resource|GdImage|WP_Error
@@ -40888,11 +40981,13 @@ protected function _save($image, $filename = \null, $mime_type = \null)
          * Sets Image Compression quality on a 1-100% scale. Handles WebP lossless images.
          *
          * @since 6.7.0
+         * @since 6.8.0 The `$dims` parameter was added.
          *
-         * @param int $quality Compression Quality. Range: [1,100]
+         * @param int   $quality Compression Quality. Range: [1,100]
+         * @param array $dims    Optional. Image dimensions array with 'width' and 'height' keys.
          * @return true|WP_Error True if set successfully; WP_Error on failure.
          */
-        public function set_quality($quality = \null)
+        public function set_quality($quality = \null, $dims = array())
         {
         }
         /**
@@ -40977,11 +41072,13 @@ public function load()
          * Sets Image Compression quality on a 1-100% scale.
          *
          * @since 3.5.0
+         * @since 6.8.0 The `$dims` parameter was added.
          *
-         * @param int $quality Compression Quality. Range: [1,100]
+         * @param int   $quality Compression Quality. Range: [1,100]
+         * @param array $dims    Optional. Image dimensions array with 'width' and 'height' keys.
          * @return true|WP_Error True if set successfully; WP_Error on failure.
          */
-        public function set_quality($quality = \null)
+        public function set_quality($quality = \null, $dims = array())
         {
         }
         /**
@@ -41042,7 +41139,7 @@ public static function set_imagick_time_limit()
          *     If true, image will be cropped to the specified dimensions using center positions.
          *     If an array, the image will be cropped using the array to specify the crop location:
          *
-         *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+         *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
          *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
          * }
          * @return true|WP_Error
@@ -41700,7 +41797,7 @@ public function get_weekday_abbrev($weekday_name)
          * @since 2.1.0
          *
          * @param string|int $month_number '01' through '12'.
-         * @return string Translated full month name.
+         * @return string Translated full month name. If the month number is not found, an empty string is returned.
          */
         public function get_month($month_number)
         {
@@ -41719,6 +41816,25 @@ public function get_month($month_number)
         public function get_month_abbrev($month_name)
         {
         }
+        /**
+         * Retrieves translated version of month genitive string.
+         *
+         * The $month_number parameter has to be a string
+         * because it must have the '0' in front of any number
+         * that is less than 10. Starts from '01' and ends at
+         * '12'.
+         *
+         * You can use an integer instead and it will add the
+         * '0' before the numbers less than 10 for you.
+         *
+         * @since 6.8.0
+         *
+         * @param string|int $month_number '01' through '12'.
+         * @return string Translated genitive month name.
+         */
+        public function get_month_genitive($month_number)
+        {
+        }
         /**
          * Retrieves translated version of meridiem string.
          *
@@ -43456,6 +43572,36 @@ protected function get_option_name()
         {
         }
     }
+    /**
+     * WordPress PHPMailer class.
+     *
+     * Overrides the internationalization method in order to use WordPress' instead.
+     *
+     * @since 6.8.0
+     */
+    class WP_PHPMailer extends \PHPMailer\PHPMailer\PHPMailer
+    {
+        /**
+         * Constructor.
+         *
+         * @since 6.8.0
+         *
+         * @param bool $exceptions Optional. Whether to throw exceptions for errors. Default false.
+         */
+        public function __construct($exceptions = \false)
+        {
+        }
+        /**
+         * Defines the error messages using WordPress' internationalization method.
+         *
+         * @since 6.8.0
+         *
+         * @return true Always returns true.
+         */
+        public function SetLanguage($langcode = 'en', $lang_path = '')
+        {
+        }
+    }
     /**
      * Core class for installing plugin dependencies.
      *
@@ -43904,6 +44050,15 @@ final class WP_Post_Type
          * @var bool $publicly_queryable
          */
         public $publicly_queryable = \null;
+        /**
+         * Whether this post type is embeddable.
+         *
+         * Default is the value of $public.
+         *
+         * @since 6.8.0
+         * @var bool $embeddable
+         */
+        public $embeddable = \null;
         /**
          * Whether to generate and allow a UI for managing this post type in the admin.
          *
@@ -44455,7 +44610,7 @@ final class WP_Post
          * @since 3.5.0
          * @var string
          */
-        public $post_author = 0;
+        public $post_author = '0';
         /**
          * The post's local publication time.
          *
@@ -44604,7 +44759,7 @@ final class WP_Post
          * @since 3.5.0
          * @var string
          */
-        public $comment_count = 0;
+        public $comment_count = '0';
         /**
          * Stores the post object's sanitization level.
          *
@@ -46261,8 +46416,7 @@ public function generate_recovery_mode_token()
          * Creates a recovery mode key.
          *
          * @since 5.2.0
-         *
-         * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
+         * @since 6.8.0 The stored key is now hashed using wp_fast_hash() instead of phpass.
          *
          * @param string $token A token generated by {@see generate_recovery_mode_token()}.
          * @return string Recovery mode key.
@@ -46277,10 +46431,8 @@ public function generate_and_store_recovery_mode_key($token)
          *
          * @since 5.2.0
          *
-         * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
-         *
          * @param string $token The token used when generating the given key.
-         * @param string $key   The unhashed key.
+         * @param string $key   The plain text key.
          * @param int    $ttl   Time in seconds for the key to be valid for.
          * @return true|WP_Error True on success, error object on failure.
          */
@@ -46413,9 +46565,9 @@ public function is_initialized()
          * @since 5.2.0
          *
          * @param array $error Error details from `error_get_last()`.
-         * @return true|WP_Error True if the error was handled and headers have already been sent.
-         *                       Or the request will exit to try and catch multiple errors at once.
-         *                       WP_Error if an error occurred preventing it from being handled.
+         * @return true|WP_Error|void True if the error was handled and headers have already been sent.
+         *                            Or the request will exit to try and catch multiple errors at once.
+         *                            WP_Error if an error occurred preventing it from being handled.
          */
         public function handle_error(array $error)
         {
@@ -46482,7 +46634,7 @@ protected function get_link_ttl()
          *
          * @since 5.2.0
          *
-         * @global array $wp_theme_directories
+         * @global string[] $wp_theme_directories
          *
          * @param array $error Error details from `error_get_last()`.
          * @return array|false {
@@ -49107,6 +49259,86 @@ public function __set($key, $value)
         {
         }
     }
+    /**
+     * Class representing a set of speculation rules.
+     *
+     * @since 6.8.0
+     * @access private
+     */
+    final class WP_Speculation_Rules implements \JsonSerializable
+    {
+        /**
+         * Adds a speculation rule to the speculation rules to consider.
+         *
+         * @since 6.8.0
+         *
+         * @param string               $mode Speculative loading mode. Either 'prefetch' or 'prerender'.
+         * @param string               $id   Unique string identifier for the speculation rule.
+         * @param array<string, mixed> $rule Associative array of rule arguments.
+         * @return bool True on success, false if invalid parameters are provided.
+         * @phpstan-param 'prefetch'|'prerender' $mode
+         */
+        public function add_rule(string $mode, string $id, array $rule) : bool
+        {
+        }
+        /**
+         * Checks whether a speculation rule for the given mode and ID already exists.
+         *
+         * @since 6.8.0
+         *
+         * @param string $mode Speculative loading mode. Either 'prefetch' or 'prerender'.
+         * @param string $id   Unique string identifier for the speculation rule.
+         * @return bool True if the rule already exists, false otherwise.
+         * @phpstan-param 'prefetch'|'prerender' $mode
+         */
+        public function has_rule(string $mode, string $id) : bool
+        {
+        }
+        /**
+         * Returns the speculation rules data ready to be JSON-encoded.
+         *
+         * @since 6.8.0
+         *
+         * @return array<string, array<string, mixed>> Speculation rules data.
+         */
+        #[\ReturnTypeWillChange]
+        public function jsonSerialize()
+        {
+        }
+        /**
+         * Checks whether the given speculation rules mode is valid.
+         *
+         * @since 6.8.0
+         *
+         * @param string $mode Speculation rules mode.
+         * @return bool True if valid, false otherwise.
+         */
+        public static function is_valid_mode(string $mode) : bool
+        {
+        }
+        /**
+         * Checks whether the given speculation rules eagerness is valid.
+         *
+         * @since 6.8.0
+         *
+         * @param string $eagerness Speculation rules eagerness.
+         * @return bool True if valid, false otherwise.
+         */
+        public static function is_valid_eagerness(string $eagerness) : bool
+        {
+        }
+        /**
+         * Checks whether the given speculation rules source is valid.
+         *
+         * @since 6.8.0
+         *
+         * @param string $source Speculation rules source.
+         * @return bool True if valid, false otherwise.
+         */
+        public static function is_valid_source(string $source) : bool
+        {
+        }
+    }
     /**
      * Core class used to register styles.
      *
@@ -51539,7 +51771,6 @@ class WP_Theme_JSON
          * @since 6.5.0 Added `aspect-ratio` property.
          * @since 6.6.0 Added `background-[image|position|repeat|size]` properties.
          * @since 6.7.0 Added `background-attachment` property.
-         *
          * @var array
          */
         const PROPERTIES_METADATA = array('aspect-ratio' => array('dimensions', 'aspectRatio'), 'background' => array('color', 'gradient'), 'background-color' => array('color', 'background'), 'background-image' => array('background', 'backgroundImage'), 'background-position' => array('background', 'backgroundPosition'), 'background-repeat' => array('background', 'backgroundRepeat'), 'background-size' => array('background', 'backgroundSize'), 'background-attachment' => array('background', 'backgroundAttachment'), 'border-radius' => array('border', 'radius'), 'border-top-left-radius' => array('border', 'radius', 'topLeft'), 'border-top-right-radius' => array('border', 'radius', 'topRight'), 'border-bottom-left-radius' => array('border', 'radius', 'bottomLeft'), 'border-bottom-right-radius' => array('border', 'radius', 'bottomRight'), 'border-color' => array('border', 'color'), 'border-width' => array('border', 'width'), 'border-style' => array('border', 'style'), 'border-top-color' => array('border', 'top', 'color'), 'border-top-width' => array('border', 'top', 'width'), 'border-top-style' => array('border', 'top', 'style'), 'border-right-color' => array('border', 'right', 'color'), 'border-right-width' => array('border', 'right', 'width'), 'border-right-style' => array('border', 'right', 'style'), 'border-bottom-color' => array('border', 'bottom', 'color'), 'border-bottom-width' => array('border', 'bottom', 'width'), 'border-bottom-style' => array('border', 'bottom', 'style'), 'border-left-color' => array('border', 'left', 'color'), 'border-left-width' => array('border', 'left', 'width'), 'border-left-style' => array('border', 'left', 'style'), 'color' => array('color', 'text'), 'text-align' => array('typography', 'textAlign'), 'column-count' => array('typography', 'textColumns'), 'font-family' => array('typography', 'fontFamily'), 'font-size' => array('typography', 'fontSize'), 'font-style' => array('typography', 'fontStyle'), 'font-weight' => array('typography', 'fontWeight'), 'letter-spacing' => array('typography', 'letterSpacing'), 'line-height' => array('typography', 'lineHeight'), 'margin' => array('spacing', 'margin'), 'margin-top' => array('spacing', 'margin', 'top'), 'margin-right' => array('spacing', 'margin', 'right'), 'margin-bottom' => array('spacing', 'margin', 'bottom'), 'margin-left' => array('spacing', 'margin', 'left'), 'min-height' => array('dimensions', 'minHeight'), 'outline-color' => array('outline', 'color'), 'outline-offset' => array('outline', 'offset'), 'outline-style' => array('outline', 'style'), 'outline-width' => array('outline', 'width'), 'padding' => array('spacing', 'padding'), 'padding-top' => array('spacing', 'padding', 'top'), 'padding-right' => array('spacing', 'padding', 'right'), 'padding-bottom' => array('spacing', 'padding', 'bottom'), 'padding-left' => array('spacing', 'padding', 'left'), '--wp--style--root--padding' => array('spacing', 'padding'), '--wp--style--root--padding-top' => array('spacing', 'padding', 'top'), '--wp--style--root--padding-right' => array('spacing', 'padding', 'right'), '--wp--style--root--padding-bottom' => array('spacing', 'padding', 'bottom'), '--wp--style--root--padding-left' => array('spacing', 'padding', 'left'), 'text-decoration' => array('typography', 'textDecoration'), 'text-transform' => array('typography', 'textTransform'), 'filter' => array('filter', 'duotone'), 'box-shadow' => array('shadow'), 'writing-mode' => array('typography', 'writingMode'));
@@ -51555,7 +51786,6 @@ class WP_Theme_JSON
          *
          * @since 6.2.0
          * @since 6.6.0 Added background-image properties.
-         *
          * @var array
          */
         const INDIRECT_PROPERTIES_METADATA = array('gap' => array(array('spacing', 'blockGap')), 'column-gap' => array(array('spacing', 'blockGap', 'left')), 'row-gap' => array(array('spacing', 'blockGap', 'top')), 'max-width' => array(array('layout', 'contentSize'), array('layout', 'wideSize')), 'background-image' => array(array('background', 'backgroundImage', 'url')));
@@ -51569,6 +51799,7 @@ class WP_Theme_JSON
          * setting key.
          *
          * @since 5.9.0
+         * @var array
          */
         const PROTECTED_PROPERTIES = array('spacing.blockGap' => array('spacing', 'blockGap'));
         /**
@@ -51603,11 +51834,10 @@ class WP_Theme_JSON
          * @var array
          */
         const VALID_SETTINGS = array('appearanceTools' => \null, 'useRootPaddingAwareAlignments' => \null, 'background' => array('backgroundImage' => \null, 'backgroundSize' => \null), 'border' => array('color' => \null, 'radius' => \null, 'style' => \null, 'width' => \null), 'color' => array('background' => \null, 'custom' => \null, 'customDuotone' => \null, 'customGradient' => \null, 'defaultDuotone' => \null, 'defaultGradients' => \null, 'defaultPalette' => \null, 'duotone' => \null, 'gradients' => \null, 'link' => \null, 'heading' => \null, 'button' => \null, 'caption' => \null, 'palette' => \null, 'text' => \null), 'custom' => \null, 'dimensions' => array('aspectRatio' => \null, 'aspectRatios' => \null, 'defaultAspectRatios' => \null, 'minHeight' => \null), 'layout' => array('contentSize' => \null, 'wideSize' => \null, 'allowEditing' => \null, 'allowCustomContentAndWideSize' => \null), 'lightbox' => array('enabled' => \null, 'allowEditing' => \null), 'position' => array('fixed' => \null, 'sticky' => \null), 'spacing' => array('customSpacingSize' => \null, 'defaultSpacingSizes' => \null, 'spacingSizes' => \null, 'spacingScale' => \null, 'blockGap' => \null, 'margin' => \null, 'padding' => \null, 'units' => \null), 'shadow' => array('presets' => \null, 'defaultPresets' => \null), 'typography' => array('fluid' => \null, 'customFontSize' => \null, 'defaultFontSizes' => \null, 'dropCap' => \null, 'fontFamilies' => \null, 'fontSizes' => \null, 'fontStyle' => \null, 'fontWeight' => \null, 'letterSpacing' => \null, 'lineHeight' => \null, 'textAlign' => \null, 'textColumns' => \null, 'textDecoration' => \null, 'textTransform' => \null, 'writingMode' => \null));
-        /*
+        /**
          * The valid properties for fontFamilies under settings key.
          *
          * @since 6.5.0
-         *
          * @var array
          */
         const FONT_FAMILY_SCHEMA = array(array('fontFamily' => \null, 'name' => \null, 'slug' => \null, 'fontFace' => array(array('ascentOverride' => \null, 'descentOverride' => \null, 'fontDisplay' => \null, 'fontFamily' => \null, 'fontFeatureSettings' => \null, 'fontStyle' => \null, 'fontStretch' => \null, 'fontVariationSettings' => \null, 'fontWeight' => \null, 'lineGapOverride' => \null, 'sizeAdjust' => \null, 'src' => \null, 'unicodeRange' => \null))));
@@ -51625,14 +51855,13 @@ class WP_Theme_JSON
          * @since 6.3.0 Added support for `typography.textColumns`.
          * @since 6.5.0 Added support for `dimensions.aspectRatio`.
          * @since 6.6.0 Added `background` sub properties to top-level only.
-         *
          * @var array
          */
         const VALID_STYLES = array('background' => array('backgroundImage' => \null, 'backgroundPosition' => \null, 'backgroundRepeat' => \null, 'backgroundSize' => \null, 'backgroundAttachment' => \null), 'border' => array('color' => \null, 'radius' => \null, 'style' => \null, 'width' => \null, 'top' => \null, 'right' => \null, 'bottom' => \null, 'left' => \null), 'color' => array('background' => \null, 'gradient' => \null, 'text' => \null), 'dimensions' => array('aspectRatio' => \null, 'minHeight' => \null), 'filter' => array('duotone' => \null), 'outline' => array('color' => \null, 'offset' => \null, 'style' => \null, 'width' => \null), 'shadow' => \null, 'spacing' => array('margin' => \null, 'padding' => \null, 'blockGap' => \null), 'typography' => array('fontFamily' => \null, 'fontSize' => \null, 'fontStyle' => \null, 'fontWeight' => \null, 'letterSpacing' => \null, 'lineHeight' => \null, 'textAlign' => \null, 'textColumns' => \null, 'textDecoration' => \null, 'textTransform' => \null, 'writingMode' => \null), 'css' => \null);
         /**
          * Defines which pseudo selectors are enabled for which elements.
          *
-         * The order of the selectors should be: link, any-link, visited, hover, focus, active.
+         * The order of the selectors should be: link, any-link, visited, hover, focus, focus-visible, active.
          * This is to ensure the user action (hover, focus and active) styles have a higher
          * specificity than the visited styles, which in turn have a higher specificity than
          * the unvisited styles.
@@ -51642,8 +51871,10 @@ class WP_Theme_JSON
          *
          * @since 6.1.0
          * @since 6.2.0 Added support for ':link' and ':any-link'.
+         * @since 6.8.0 Added support for ':focus-visible'.
+         * @var array
          */
-        const VALID_ELEMENT_PSEUDO_SELECTORS = array('link' => array(':link', ':any-link', ':visited', ':hover', ':focus', ':active'), 'button' => array(':link', ':any-link', ':visited', ':hover', ':focus', ':active'));
+        const VALID_ELEMENT_PSEUDO_SELECTORS = array('link' => array(':link', ':any-link', ':visited', ':hover', ':focus', ':focus-visible', ':active'), 'button' => array(':link', ':any-link', ':visited', ':hover', ':focus', ':focus-visible', ':active'));
         /**
          * The valid elements that can be found under styles.
          *
@@ -51922,6 +52153,8 @@ public function get_settings()
          *                          - `variables`: only the CSS Custom Properties for presets & custom ones.
          *                          - `styles`: only the styles section in theme.json.
          *                          - `presets`: only the classes for the presets.
+         *                          - `base-layout-styles`: only the base layout styles.
+         *                          - `custom-css`: only the custom CSS.
          * @param string[] $origins A list of origins to include. By default it includes VALID_ORIGINS.
          * @param array    $options {
          *     Optional. An array of options for now used for internal purposes only (may change without notice).
@@ -52312,7 +52545,7 @@ protected static function flatten_tree($tree, $prefix = '', $token = '--')
          * @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.
+         * @return array Returns the modified $declarations.
          */
         protected static function compute_style_properties($styles, $settings = array(), $properties = \null, $theme_json = \null, $selector = \null, $use_root_padding = \null)
         {
@@ -52417,7 +52650,6 @@ public function get_styles_block_nodes()
          *              Fixed custom CSS output in block style variations.
          *
          * @param array $block_metadata Metadata about the block to get styles for.
-         *
          * @return string Styles for the block.
          */
         public function get_styles_for_block($block_metadata)
@@ -52554,14 +52786,36 @@ protected static function filter_slugs($node, $slugs)
          * @since 6.6.0 Updated to allow variation element styles and $origin parameter.
          *
          * @param array  $theme_json Structure to sanitize.
-         * @param string $origin    Optional. What source of data this object represents.
-         *                          One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.
+         * @param string $origin     Optional. What source of data this object represents.
+         *                           One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.
          * @return array Sanitized structure.
          * @phpstan-param 'blocks'|'default'|'theme'|'custom' $origin
          */
         public static function remove_insecure_properties($theme_json, $origin = 'theme')
         {
         }
+        /**
+         * Remove insecure element styles within a variation or block.
+         *
+         * @since 6.8.0
+         *
+         * @param array $elements The elements to process.
+         * @return array The sanitized elements styles.
+         */
+        protected static function remove_insecure_element_styles($elements)
+        {
+        }
+        /**
+         * Remove insecure styles from inner blocks and their elements.
+         *
+         * @since 6.8.0
+         *
+         * @param array $blocks The block styles to process.
+         * @return array Sanitized block type styles.
+         */
+        protected static function remove_insecure_inner_block_styles($blocks)
+        {
+        }
         /**
          * Processes a setting node and returns the same node
          * without the insecure settings.
@@ -52664,7 +52918,6 @@ public function set_spacing_sizes()
          *
          * @param object $block_type    The block type.
          * @param string $root_selector The block's root selector.
-         *
          * @return array The custom selectors set by the block.
          */
         protected static function get_block_selectors($block_type, $root_selector)
@@ -52690,9 +52943,8 @@ protected static function get_block_element_selectors($root_selector)
          *
          * @param object $metadata The related block metadata containing selectors.
          * @param object $node     A merged theme.json node for block or variation.
-         *
          * @return array The style declarations for the node's features with custom
-         * selectors.
+         *               selectors.
          */
         protected function get_feature_declarations_for_node($metadata, &$node)
         {
@@ -52701,8 +52953,8 @@ protected function get_feature_declarations_for_node($metadata, &$node)
          * Resolves the values of CSS variables in the given styles.
          *
          * @since 6.3.0
-         * @param WP_Theme_JSON $theme_json The theme json resolver.
          *
+         * @param WP_Theme_JSON $theme_json The theme json resolver.
          * @return WP_Theme_JSON The $theme_json with resolved variables.
          */
         public static function resolve_variables($theme_json)
@@ -52724,10 +52976,12 @@ protected static function get_block_style_variation_selector($variation_name, $b
          * Collects valid block style variations keyed by block type.
          *
          * @since 6.6.0
+         * @since 6.8.0 Added the `$blocks_metadata` parameter.
          *
+         * @param array $blocks_metadata Optional. List of metadata per block. Default is the metadata for all blocks.
          * @return array Valid block style variations by block type.
          */
-        protected static function get_valid_block_style_variations()
+        protected static function get_valid_block_style_variations($blocks_metadata = array())
         {
         }
     }
@@ -52770,7 +53024,7 @@ final class WP_Theme implements \ArrayAccess
          *
          * @since 3.4.0
          *
-         * @global array $wp_theme_directories
+         * @global string[] $wp_theme_directories
          *
          * @param string        $theme_dir  Directory of the theme within the theme_root.
          * @param string        $theme_root Theme root.
@@ -53624,6 +53878,56 @@ public function precomputed_php_source_table(string $indent = "\t") : string
         {
         }
     }
+    /**
+     * Class for prefixing URL patterns.
+     *
+     * This class is intended primarily for use as part of the speculative loading feature.
+     *
+     * @since 6.8.0
+     * @access private
+     */
+    class WP_URL_Pattern_Prefixer
+    {
+        /**
+         * Constructor.
+         *
+         * @since 6.8.0
+         *
+         * @param array<string, string> $contexts Optional. Map of `$context_string => $base_path` pairs. Default is the
+         *                                        contexts returned by the
+         *                                        {@see WP_URL_Pattern_Prefixer::get_default_contexts()} method.
+         */
+        public function __construct(array $contexts = array())
+        {
+        }
+        /**
+         * Prefixes the given URL path pattern with the base path for the given context.
+         *
+         * This ensures that these path patterns work correctly on WordPress subdirectory sites, for example in a multisite
+         * network, or when WordPress itself is installed in a subdirectory of the hostname.
+         *
+         * The given URL path pattern is only prefixed if it does not already include the expected prefix.
+         *
+         * @since 6.8.0
+         *
+         * @param string $path_pattern URL pattern starting with the path segment.
+         * @param string $context      Optional. Context to use for prefixing the path pattern. Default 'home'.
+         * @return string URL pattern, prefixed as necessary.
+         */
+        public function prefix_path_pattern(string $path_pattern, string $context = 'home') : string
+        {
+        }
+        /**
+         * Returns the default contexts used by the class.
+         *
+         * @since 6.8.0
+         *
+         * @return array<string, string> Map of `$context_string => $base_path` pairs.
+         */
+        public static function get_default_contexts() : array
+        {
+        }
+    }
     /**
      * Meta-based user sessions token manager.
      *
@@ -53881,7 +54185,7 @@ public static function fill_query_vars($args)
          *                                                - 'login__in'
          *                                                - 'user_nicename' (or 'nicename')
          *                                                - 'nicename__in'
-         *                                                - 'user_email (or 'email')
+         *                                                - 'user_email' (or 'email')
          *                                                - 'user_url' (or 'url')
          *                                                - 'user_registered' (or 'registered')
          *                                                - 'post_count'
@@ -54233,6 +54537,8 @@ final class WP_User_Request
          * Key used to confirm this request.
          *
          * @since 4.9.6
+         * @since 6.8.0 The key is now hashed using wp_fast_hash() instead of phpass.
+         *
          * @var string
          */
         public $confirm_key = '';
@@ -54251,6 +54557,8 @@ public function __construct($post)
      * Core class used to implement the WP_User object.
      *
      * @since 2.0.0
+     * @since 6.8.0 The `user_pass` property is now hashed using bcrypt by default instead of phpass.
+     *              Existing passwords may still be hashed using phpass.
      *
      * @property string $nickname
      * @property string $description
@@ -54912,7 +55220,7 @@ public function update($new_instance, $old_instance)
          * @since 2.8.0
          *
          * @param array $instance The settings for the particular instance of the widget.
-         * @return string Default return is 'noform'.
+         * @return string|void Default return is 'noform'.
          * @phpstan-param T $instance
          */
         public function form($instance)
@@ -55268,7 +55576,7 @@ public function addTwoNumbers($args)
          * @param string $password User's password.
          * @return WP_User|false WP_User object if authentication passed, false otherwise.
          */
-        public function login($username, $password)
+        public function login($username, #[\SensitiveParameter] $password)
         {
         }
         /**
@@ -55282,7 +55590,7 @@ public function login($username, $password)
          * @param string $password User's password.
          * @return bool Whether authentication passed.
          */
-        public function login_pass_ok($username, $password)
+        public function login_pass_ok($username, #[\SensitiveParameter] $password)
         {
         }
         /**
@@ -58294,7 +58602,7 @@ class wpdb
          * @param string $dbhost     Database host.
          * @phpstan-return void
          */
-        public function __construct($dbuser, $dbpassword, $dbname, $dbhost)
+        public function __construct($dbuser, #[\SensitiveParameter] $dbpassword, $dbname, $dbhost)
         {
         }
         /**
@@ -64082,10 +64390,9 @@ class WP_HTML_Processor_State
          * Context node initializing fragment parser, if created as a fragment parser.
          *
          * @since 6.4.0
+         * @deprecated 6.8.0 WP_HTML_Processor tracks the context_node internally.
          *
-         * @see https://html.spec.whatwg.org/#concept-frag-parse-context
-         *
-         * @var [string, array]|null
+         * @var null
          */
         public $context_node = \null;
         /**
@@ -65853,9 +66160,9 @@ public static function create_fragment($html, $context = '<body>', $encoding = '
          * entire HTML document from start to finish. Consider a fragment parser with
          * a context node of `<body>`.
          *
-         * Since UTF-8 is the only currently-accepted charset, if working with a
-         * document that isn't UTF-8, it's important to convert the document before
-         * creating the processor: pass in the converted HTML.
+         * UTF-8 is the only allowed encoding. If working with a document that
+         * isn't UTF-8, first convert the document to UTF-8, then pass in the
+         * converted HTML.
          *
          * @param string      $html                    Input HTML document to process.
          * @param string|null $known_definite_encoding Optional. If provided, specifies the charset used
@@ -66061,11 +66368,7 @@ public function step($node_to_process = self::PROCESS_NEXT_NODE) : bool
          * Breadcrumbs start at the outermost parent and descend toward the matched element.
          * They always include the entire path from the root HTML node to the matched element.
          *
-         * @todo It could be more efficient to expose a generator-based version of this function
-         *       to avoid creating the array copy on tag iteration. If this is done, it would likely
-         *       be more useful to walk up the stack when yielding instead of starting at the top.
-         *
-         * Example
+         * Example:
          *
          *     $processor = WP_HTML_Processor::create_fragment( '<p><strong><em><img></em></strong></p>' );
          *     $processor->next_tag( 'IMG' );
@@ -66073,9 +66376,9 @@ public function step($node_to_process = self::PROCESS_NEXT_NODE) : bool
          *
          * @since 6.4.0
          *
-         * @return string[]|null Array of tag names representing path to matched node, if matched, otherwise NULL.
+         * @return string[] Array of tag names representing path to matched node.
          */
-        public function get_breadcrumbs() : ?array
+        public function get_breadcrumbs() : array
         {
         }
         /**
@@ -66595,6 +66898,11 @@ public function seek($bookmark_name) : bool
          * reaching for it, as inappropriate use could lead to broken
          * HTML structure or unwanted processing overhead.
          *
+         * Bookmarks cannot be set on tokens that do no appear in the original
+         * HTML text. For example, the HTML `<table><td>` stops at tags `TABLE`,
+         * `TBODY`, `TR`, and `TD`. The `TBODY` and `TR` tags do not appear in
+         * the original HTML and cannot be used as bookmarks.
+         *
          * @since 6.4.0
          *
          * @param string $bookmark_name Identifies this particular bookmark.
@@ -69110,6 +69418,17 @@ public function set_method($method)
         public function get_headers()
         {
         }
+        /**
+         * Determines if the request is the given method.
+         *
+         * @since 6.8.0
+         *
+         * @param string $method HTTP method.
+         * @return bool Whether the request is of the given method.
+         */
+        public function is_method($method)
+        {
+        }
         /**
          * Canonicalizes the header name.
          *
@@ -72817,7 +73136,7 @@ protected function normalize_query_param($query_param)
          *
          * @since 4.7.0
          *
-         * @param string|int $comment_approved comment status.
+         * @param string $comment_approved Comment status.
          * @return string Comment status.
          */
         protected function prepare_status_response($comment_approved)
@@ -74114,6 +74433,17 @@ public function get_item_permissions_check($request)
         public function get_item($request)
         {
         }
+        /**
+         * Checks whether the current user has read permission for the endpoint.
+         *
+         * @since 6.8.0
+         *
+         * @param WP_REST_Request $request Full details about the request.
+         * @return true|WP_Error True if the current user has permission, WP_Error object otherwise.
+         */
+        protected function check_has_read_only_access($request)
+        {
+        }
         /**
          * Prepares a menu location object for serialization.
          *
@@ -74249,6 +74579,7 @@ public function get_items_permissions_check($request)
          * Retrieves terms associated with a taxonomy.
          *
          * @since 4.7.0
+         * @since 6.8.0 Respect default query arguments set for the taxonomy upon registration.
          *
          * @param WP_REST_Request $request Full details about the request.
          * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -76737,6 +77068,7 @@ public function get_items_permissions_check($request)
          * Retrieves all users.
          *
          * @since 4.7.0
+         * @since 6.8.0 Added support for the search_columns query param.
          *
          * @param WP_REST_Request $request Full details about the request.
          * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -76975,7 +77307,7 @@ public function check_username($value, $request, $param)
          * @param string          $param   The parameter name.
          * @return string|WP_Error The sanitized password, if valid, otherwise an error.
          */
-        public function check_user_password($value, $request, $param)
+        public function check_user_password(#[\SensitiveParameter] $value, $request, $param)
         {
         }
         /**
@@ -84272,8 +84604,8 @@ function _image_get_preview_ratio($w, $h)
      * @see WP_Image_Editor::rotate()
      *
      * @ignore
-     * @param resource|GdImage  $img   Image resource.
-     * @param float|int         $angle Image rotation angle, in degrees.
+     * @param resource|GdImage $img   Image resource.
+     * @param float|int        $angle Image rotation angle, in degrees.
      * @return resource|GdImage|false GD image resource or GdImage instance, false otherwise.
      */
     function _rotate_image_resource($img, $angle)
@@ -85847,7 +86179,7 @@ function show_message($message)
      * @since 2.8.0
      *
      * @param string $content
-     * @return array
+     * @return string[] Array of function names.
      */
     function wp_doc_link_parse($content)
     {
@@ -86046,14 +86378,6 @@ function heartbeat_autosave($response, $data)
     function wp_admin_canonical_url()
     {
     }
-    /**
-     * Sends a referrer policy header so referrers are not sent externally from administration screens.
-     *
-     * @since 4.9.0
-     */
-    function wp_admin_headers()
-    {
-    }
     /**
      * Outputs JS that reloads the page if the user navigated to it with the Back or Forward button.
      *
@@ -86484,6 +86808,16 @@ function get_site_screen_help_tab_args()
     function get_site_screen_help_sidebar_content()
     {
     }
+    /**
+     * Stop execution if the role can not be assigned by the current user.
+     *
+     * @since 6.8.0
+     *
+     * @param string $role Role the user is attempting to assign.
+     */
+    function wp_ensure_editable_role($role)
+    {
+    }
     /**
      * Prints the appropriate response to a menu quick search.
      *
@@ -88180,7 +88514,18 @@ function edit_post($post_data = \null)
      *
      * @param array|null $post_data Optional. The array of post data to process.
      *                              Defaults to the `$_POST` superglobal.
-     * @return array
+     * @return array {
+     *     An array of updated, skipped, and locked post IDs.
+     *
+     *     @type int[] $updated An array of updated post IDs.
+     *     @type int[] $skipped An array of skipped post IDs.
+     *     @type int[] $locked  An array of locked post IDs.
+     * }
+     * @phpstan-return array{
+     *   updated: int[],
+     *   skipped: int[],
+     *   locked: int[],
+     * }
      */
     function bulk_edit_posts($post_data = \null)
     {
@@ -88356,7 +88701,7 @@ function get_available_post_statuses($type = 'post')
      *
      * @param array|false $q Optional. Array of query variables to use to build the query.
      *                       Defaults to the `$_GET` superglobal.
-     * @return array
+     * @return string[] An array of all the statuses for the queried post type.
      */
     function wp_edit_posts_query($q = \false)
     {
@@ -88381,7 +88726,16 @@ function wp_edit_attachments_query_vars($q = \false)
      *
      * @param array|false $q Optional. Array of query variables to use to build the query.
      *                       Defaults to the `$_GET` superglobal.
-     * @return array
+     * @return array {
+     *     Array containing the post mime types and available post mime types.
+     *
+     *     @type array[]  $post_mime_types       Post mime types.
+     *     @type string[] $avail_post_mime_types Available post mime types.
+     * }
+     * @phpstan-return array{
+     *   post_mime_types: array[],
+     *   avail_post_mime_types: string[],
+     * }
      */
     function wp_edit_attachments_query($q = \false)
     {
@@ -90592,13 +90946,14 @@ function wp_can_install_language_pack()
      *
      * The steps for the upgrader for after the new release is downloaded and
      * unzipped is:
+     *
      *   1. Test unzipped location for select files to ensure that unzipped worked.
      *   2. Create the .maintenance file in current WordPress base.
      *   3. Copy new WordPress directory over old WordPress files.
      *   4. Upgrade WordPress to new version.
-     *     4.1. Copy all files/folders other than wp-content
-     *     4.2. Copy any language files to WP_LANG_DIR (which may differ from WP_CONTENT_DIR
-     *     4.3. Copy any new bundled themes/plugins to their respective locations
+     *      1. Copy all files/folders other than wp-content
+     *      2. Copy any language files to `WP_LANG_DIR` (which may differ from `WP_CONTENT_DIR`
+     *      3. Copy any new bundled themes/plugins to their respective locations
      *   5. Delete new WordPress directory path.
      *   6. Delete .maintenance file.
      *   7. Remove old files.
@@ -90620,13 +90975,10 @@ function wp_can_install_language_pack()
      * @since 2.7.0
      *
      * @global WP_Filesystem_Base $wp_filesystem          WordPress filesystem subclass.
-     * @global array              $_old_files
-     * @global array              $_old_requests_files
-     * @global array              $_new_bundled_files
+     * @global string[]           $_old_files
+     * @global string[]           $_old_requests_files
+     * @global string[]           $_new_bundled_files
      * @global wpdb               $wpdb                   WordPress database abstraction object.
-     * @global string             $wp_version
-     * @global string             $required_php_version
-     * @global string             $required_mysql_version
      *
      * @param string $from New release unzipped path.
      * @param string $to   Path to old WordPress installation.
@@ -90649,7 +91001,7 @@ function update_core($from, $to)
      *
      * @since 6.2.0
      *
-     * @global array              $_old_requests_files Requests files to be preloaded.
+     * @global string[]           $_old_requests_files Requests files to be preloaded.
      * @global WP_Filesystem_Base $wp_filesystem       WordPress filesystem subclass.
      * @global string             $wp_version          The WordPress version string.
      *
@@ -90681,7 +91033,7 @@ function _redirect_to_about_wordpress($new_version)
      *
      * @since 4.2.2
      *
-     * @global array              $wp_theme_directories
+     * @global string[]           $wp_theme_directories
      * @global WP_Filesystem_Base $wp_filesystem
      */
     function _upgrade_422_remove_genericons()
@@ -90694,7 +91046,7 @@ function _upgrade_422_remove_genericons()
      * @since 4.2.2
      *
      * @param string $directory Directory path. Expects trailingslashed.
-     * @return array
+     * @return string[]
      */
     function _upgrade_422_find_genericons_files_in_folder($directory)
     {
@@ -90834,7 +91186,7 @@ function update_right_now_message()
      *
      * @since 2.9.0
      *
-     * @return array
+     * @return object[]
      */
     function get_plugin_updates()
     {
@@ -90865,7 +91217,7 @@ function wp_plugin_update_row($file, $plugin_data)
      *
      * @since 2.9.0
      *
-     * @return array
+     * @return WP_Theme[]
      */
     function get_theme_updates()
     {
@@ -91028,7 +91380,7 @@ function wp_get_auto_update_message()
      *   password_message: string,
      * }
      */
-    function wp_install($blog_title, $user_name, $user_email, $is_public, $deprecated = '', $user_password = '', $language = '')
+    function wp_install($blog_title, $user_name, $user_email, $is_public, $deprecated = '', #[\SensitiveParameter] $user_password = '', $language = '')
     {
     }
     /**
@@ -91076,7 +91428,7 @@ function wp_install_maybe_enable_pretty_permalinks()
      * @param string $password   Administrator's password. Note that a placeholder message is
      *                           usually passed instead of the actual password.
      */
-    function wp_new_blog_notification($blog_title, $blog_url, $user_id, $password)
+    function wp_new_blog_notification($blog_title, $blog_url, $user_id, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -91136,6 +91488,7 @@ function upgrade_101()
      *
      * @ignore
      * @since 1.2.0
+     * @since 6.8.0 User passwords are no longer hashed with md5.
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      */
@@ -91719,7 +92072,7 @@ function deslash($content)
      *                                 semicolons. Default empty string.
      * @param bool            $execute Optional. Whether or not to execute the query right away.
      *                                 Default true.
-     * @return array Strings containing the results of the various update queries.
+     * @return string[] Strings containing the results of the various update queries.
      */
     function dbDelta($queries = '', $execute = \true)
     {
@@ -92244,6 +92597,8 @@ function _add_plugin_file_editor_to_tools()
     /**
      * @global int $_wp_nav_menu_max_depth
      *
+     * @since 3.0.0
+     *
      * @param string $classes
      * @return string
      */
@@ -92264,6 +92619,19 @@ function wp_load_press_this()
     function setup_config_display_header($body_classes = array())
     {
     }
+    /**
+     * Maps old site editor urls to the new updated ones.
+     *
+     * @since 6.8.0
+     * @access private
+     *
+     * @global string $pagenow The filename of the current screen.
+     *
+     * @return string|false The new URL to redirect to, or false if no redirection is needed.
+     */
+    function _wp_get_site_editor_redirection_url()
+    {
+    }
     /**
      * Returns the JavaScript template used to display the auto-update setting for a theme.
      *
@@ -92476,13 +92844,12 @@ function wp_admin_bar_site_menu($wp_admin_bar)
     {
     }
     /**
-     * Adds the "Edit site" link to the Toolbar.
+     * Adds the "Edit Site" link to the Toolbar.
      *
      * @since 5.9.0
      * @since 6.3.0 Added `$_wp_current_template_id` global for editing of current template directly from the admin bar.
      * @since 6.6.0 Added the `canvas` query arg to the Site Editor link.
-     *
-     * @global string $_wp_current_template_id
+     * @since 6.8.0 Removed the query args to ensure that the link opens the starting screen of the Site Editor.
      *
      * @param WP_Admin_Bar $wp_admin_bar The WP_Admin_Bar instance.
      * @phpstan-return void
@@ -93299,6 +93666,16 @@ function get_block_editor_theme_styles()
     function get_classic_theme_supports_block_editor_settings()
     {
     }
+    /**
+     * Initialize site preview.
+     *
+     * This function sets IFRAME_REQUEST to true if the site preview parameter is set.
+     *
+     * @since 6.8.0
+     */
+    function wp_initialize_site_preview_hooks()
+    {
+    }
     /**
      * Registers the core block patterns and categories.
      *
@@ -93403,6 +93780,32 @@ function wp_register_alignment_support($block_type)
     function wp_apply_alignment_support($block_type, $block_attributes)
     {
     }
+    /**
+     * Registers the aria-label block attribute for block types that support it.
+     *
+     * @since 6.8.0
+     * @access private
+     *
+     * @param WP_Block_Type $block_type Block Type.
+     * @phpstan-return void
+     */
+    function wp_register_aria_label_support($block_type)
+    {
+    }
+    /**
+     * Add the aria-label to the output.
+     *
+     * @since 6.8.0
+     * @access private
+     *
+     * @param WP_Block_Type $block_type       Block Type.
+     * @param array         $block_attributes Block attributes.
+     *
+     * @return array Block aria-label.
+     */
+    function wp_apply_aria_label_support($block_type, $block_attributes)
+    {
+    }
     /**
      * Registers the style block attribute for block types that support it.
      *
@@ -93459,7 +93862,7 @@ function wp_resolve_block_style_variation_ref_values(&$variation_data, $theme_js
     {
     }
     /**
-     * Render the block style variation's styles.
+     * Renders the block style variation's styles.
      *
      * In the case of nested blocks with variations applied, we want the parent
      * variation's styles to be rendered before their descendants. This solves the
@@ -93479,15 +93882,15 @@ function wp_render_block_style_variation_support_styles($parsed_block)
     {
     }
     /**
-     * Ensure the variation block support class name generated and added to
+     * Ensures the variation block support class name generated and added to
      * block attributes in the `render_block_data` filter gets applied to the
      * block's markup.
      *
-     * @see wp_render_block_style_variation_support_styles
-     *
      * @since 6.6.0
      * @access private
      *
+     * @see wp_render_block_style_variation_support_styles
+     *
      * @param  string $block_content Rendered block content.
      * @param  array  $block         Block object.
      *
@@ -94601,6 +95004,17 @@ function inject_ignored_hooked_blocks_metadata_attributes($changes, $deprecated
     function _add_template_loader_filters()
     {
     }
+    /**
+     * Renders a warning screen for empty block templates.
+     *
+     * @since 6.8.0
+     *
+     * @param WP_Block_Template $block_template The block template object.
+     * @return string The warning screen HTML.
+     */
+    function wp_render_empty_block_template_warning($block_template)
+    {
+    }
     /**
      * Finds a block template with equal or higher specificity than a given PHP template file.
      *
@@ -94858,6 +95272,24 @@ function register_block_style_handle($metadata, $field_name, $index = 0)
     function get_block_metadata_i18n_schema()
     {
     }
+    /**
+     * Registers all block types from a block metadata collection.
+     *
+     * This can either reference a previously registered metadata collection or, if the `$manifest` parameter is provided,
+     * register the metadata collection directly within the same function call.
+     *
+     * @since 6.8.0
+     * @see wp_register_block_metadata_collection()
+     * @see register_block_type_from_metadata()
+     *
+     * @param string $path     The absolute base path for the collection ( e.g., WP_PLUGIN_DIR . '/my-plugin/blocks/' ).
+     * @param string $manifest Optional. The absolute path to the manifest file containing the metadata collection, in
+     *                         order to register the collection. If this parameter is not provided, the `$path` parameter
+     *                         must reference a previously registered block metadata collection.
+     */
+    function wp_register_block_types_from_metadata_collection($path, $manifest = '')
+    {
+    }
     /**
      * Registers a block metadata collection.
      *
@@ -95086,17 +95518,43 @@ function set_ignored_hooked_blocks_metadata(&$parsed_anchor_block, $relative_pos
      *
      * @since 6.6.0
      * @since 6.7.0 Injects the `theme` attribute into Template Part blocks, even if no hooked blocks are registered.
+     * @since 6.8.0 Have the `$context` parameter default to `null`, in which case `get_post()` will be called to use the current post as context.
+     * @access private
+     *
+     * @param string                               $content  Serialized content.
+     * @param WP_Block_Template|WP_Post|array|null $context  A block template, template part, post object, or pattern
+     *                                                       that the blocks belong 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'.
+     * @return string The serialized markup.
+     */
+    function apply_block_hooks_to_content($content, $context = \null, $callback = 'insert_hooked_blocks')
+    {
+    }
+    /**
+     * Run the Block Hooks algorithm on a post object's content.
+     *
+     * This function is different from `apply_block_hooks_to_content` in that
+     * it takes ignored hooked block information from the post's metadata into
+     * account. This ensures that any blocks hooked as first or last child
+     * of the block that corresponds to the post type are handled correctly.
+     *
+     * @since 6.8.0
      * @access private
      *
-     * @param string                          $content  Serialized content.
-     * @param WP_Block_Template|WP_Post|array $context  A block template, template part, `wp_navigation` post object,
-     *                                                  or pattern that the blocks belong to.
-     * @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'.
      * @return string The serialized markup.
      */
-    function apply_block_hooks_to_content($content, $context, $callback = 'insert_hooked_blocks')
+    function apply_block_hooks_to_content_from_post_object($content, $post = \null, $callback = 'insert_hooked_blocks')
     {
     }
     /**
@@ -95126,10 +95584,11 @@ function extract_serialized_parent_block($serialized_block)
     {
     }
     /**
-     * Updates the wp_postmeta with the list of ignored hooked blocks where the inner blocks are stored as post content.
-     * Currently only supports `wp_navigation` post types.
+     * Updates the wp_postmeta with the list of ignored hooked blocks
+     * where the inner blocks are stored as post content.
      *
      * @since 6.6.0
+     * @since 6.8.0 Support non-`wp_navigation` post types.
      * @access private
      *
      * @param stdClass $post Post object.
@@ -95159,9 +95618,10 @@ function insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata(&$parsed_an
     {
     }
     /**
-     * Hooks into the REST API response for the core/navigation block and adds the first and last inner blocks.
+     * Hooks into the REST API response for the Posts endpoint and adds the first and last inner blocks.
      *
      * @since 6.6.0
+     * @since 6.8.0 Support non-`wp_navigation` post types.
      *
      * @param WP_REST_Response $response The response object.
      * @param WP_Post          $post     Post object.
@@ -95184,7 +95644,7 @@ function insert_hooked_blocks_into_rest_response($response, $post)
      * @access private
      *
      * @param array                           $hooked_blocks An array of blocks hooked to another given block.
-     * @param WP_Block_Template|WP_Post|array $context       A block template, template part, `wp_navigation` post object,
+     * @param WP_Block_Template|WP_Post|array $context       A block template, template part, post object,
      *                                                       or pattern that the blocks belong to.
      * @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.
@@ -95209,7 +95669,7 @@ function make_before_block_visitor($hooked_blocks, $context, $callback = 'insert
      * @access private
      *
      * @param array                           $hooked_blocks An array of blocks hooked to another block.
-     * @param WP_Block_Template|WP_Post|array $context       A block template, template part, `wp_navigation` post object,
+     * @param WP_Block_Template|WP_Post|array $context       A block template, template part, post object,
      *                                                       or pattern that the blocks belong to.
      * @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.
@@ -97269,91 +97729,6 @@ function block_core_navigation_maybe_use_classic_menu_fallback()
     function block_core_navigation_get_most_recently_published_navigation()
     {
     }
-    /**
-     * Accepts the serialized markup of a block and its inner blocks, and returns serialized markup of the inner blocks.
-     *
-     * @since 6.5.0
-     *
-     * @param string $serialized_block The serialized markup of a block and its inner blocks.
-     * @return string
-     */
-    function block_core_navigation_remove_serialized_parent_block($serialized_block)
-    {
-    }
-    /**
-     * Mock a parsed block for the Navigation block given its inner blocks and the `wp_navigation` post object.
-     * The `wp_navigation` post's `_wp_ignored_hooked_blocks` meta is queried to add the `metadata.ignoredHookedBlocks` attribute.
-     *
-     * @since 6.5.0
-     *
-     * @param array   $inner_blocks Parsed inner blocks of a Navigation block.
-     * @param WP_Post $post         `wp_navigation` post object corresponding to the block.
-     *
-     * @return array the normalized parsed blocks.
-     */
-    function block_core_navigation_mock_parsed_block($inner_blocks, $post)
-    {
-    }
-    /**
-     * Insert hooked blocks into a Navigation block.
-     *
-     * Given a Navigation block's inner blocks and its corresponding `wp_navigation` post object,
-     * this function inserts hooked blocks into it, and returns the serialized inner blocks in a
-     * mock Navigation block wrapper.
-     *
-     * If there are any hooked blocks that need to be inserted as the Navigation block's first or last
-     * children, the `wp_navigation` post's `_wp_ignored_hooked_blocks` meta is checked to see if any
-     * of those hooked blocks should be exempted from insertion.
-     *
-     * @since 6.5.0
-     *
-     * @param array   $inner_blocks Parsed inner blocks of a Navigation block.
-     * @param WP_Post $post         `wp_navigation` post object corresponding to the block.
-     * @return string Serialized inner blocks in mock Navigation block wrapper, with hooked blocks inserted, if any.
-     */
-    function block_core_navigation_insert_hooked_blocks($inner_blocks, $post)
-    {
-    }
-    /**
-     * Insert ignoredHookedBlocks meta into the Navigation block and its inner blocks.
-     *
-     * Given a Navigation block's inner blocks and its corresponding `wp_navigation` post object,
-     * this function inserts ignoredHookedBlocks meta into it, and returns the serialized inner blocks in a
-     * mock Navigation block wrapper.
-     *
-     * @since 6.5.0
-     *
-     * @param array   $inner_blocks Parsed inner blocks of a Navigation block.
-     * @param WP_Post $post         `wp_navigation` post object corresponding to the block.
-     * @return string Serialized inner blocks in mock Navigation block wrapper, with hooked blocks inserted, if any.
-     */
-    function block_core_navigation_set_ignored_hooked_blocks_metadata($inner_blocks, $post)
-    {
-    }
-    /**
-     * Updates the post meta with the list of ignored hooked blocks when the navigation is created or updated via the REST API.
-     *
-     * @access private
-     * @since 6.5.0
-     *
-     * @param stdClass $post Post object.
-     * @return stdClass The updated post object.
-     */
-    function block_core_navigation_update_ignore_hooked_blocks_meta($post)
-    {
-    }
-    /**
-     * Hooks into the REST API response for the core/navigation block and adds the first and last inner blocks.
-     *
-     * @since 6.5.0
-     *
-     * @param WP_REST_Response $response The response object.
-     * @param WP_Post          $post     Post object.
-     * @return WP_REST_Response The response object.
-     */
-    function block_core_navigation_insert_hooked_blocks_into_rest_response($response, $post)
-    {
-    }
     /**
      * Registers the `core/page-list-item` block on server.
      *
@@ -97914,6 +98289,30 @@ function render_block_core_query_title($attributes)
     function register_block_core_query_title()
     {
     }
+    /**
+     * Renders the `query-total` block on the server.
+     *
+     * @since 6.8.0
+     *
+     * @global WP_Query $wp_query WordPress Query object.
+     *
+     * @param array    $attributes Block attributes.
+     * @param string   $content    Block default content.
+     * @param WP_Block $block      Block instance.
+     *
+     * @return string The rendered block content.
+     */
+    function render_block_core_query_total($attributes, $content, $block)
+    {
+    }
+    /**
+     * Registers the `query-total` block.
+     *
+     * @since 6.8.0
+     */
+    function register_block_core_query_total()
+    {
+    }
     /**
      * Modifies the static `core/query` block on the server.
      *
@@ -97945,7 +98344,7 @@ function register_block_core_query()
      * @since 6.4.0
      *
      * @param array $parsed_block The block being rendered.
-     * @return string Returns the parsed block, unmodified.
+     * @return array Returns the parsed block, unmodified.
      */
     function block_core_query_disable_enhanced_pagination($parsed_block)
     {
@@ -100289,8 +100688,9 @@ function get_categories($args = '')
      *                             correspond to a WP_Term object, an associative array, or a numeric array,
      *                             respectively. Default OBJECT.
      * @param string     $filter   Optional. How to sanitize category fields. Default 'raw'.
-     * @return object|array|WP_Error|null Category data in type defined by $output parameter.
-     *                                    WP_Error if $category is empty, null if it does not exist.
+     * @return WP_Term|array|WP_Error|null Category data in type defined by $output parameter.
+     *                                     Returns a WP_Term object with backwards compatible property aliases filled in.
+     *                                     WP_Error if $category is empty, null if it does not exist.
      * @phpstan-param 'OBJECT'|'ARRAY_A'|'ARRAY_N' $output
      * @phpstan-return ($category is object ? array<array-key, mixed>|\WP_Term : array<array-key, mixed>|\WP_Term|\WP_Error|null) & ($output is 'ARRAY_A' ? array<string, mixed>|\WP_Error|null : ($output is 'ARRAY_N' ? array<int, mixed>|\WP_Error|null : \WP_Term|\WP_Error|null))
      */
@@ -101870,7 +102270,13 @@ function get_comment_count($post_id = 0)
      *
      * @param int    $comment_id Comment ID.
      * @param string $meta_key   Metadata name.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the same key should not be added.
      *                           Default false.
      * @return int|false Meta ID on success, false on failure.
@@ -101917,6 +102323,11 @@ function delete_comment_meta($comment_id, $meta_key, $meta_value = '')
      *               False for an invalid `$comment_id` (non-numeric, zero, or negative value).
      *               An empty array if a valid but non-existing comment ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing comment ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_comment_meta($comment_id, $key = '', $single = \false)
     {
@@ -102130,7 +102541,7 @@ function wp_check_comment_data_max_lengths($comment_data)
      *
      * @param array $comment_data Array of arguments for inserting a comment.
      * @return int|string|WP_Error The approval status on success (0|1|'spam'|'trash'),
-     *                            WP_Error otherwise.
+     *                             WP_Error otherwise.
      */
     function wp_check_comment_data($comment_data)
     {
@@ -102140,13 +102551,13 @@ function wp_check_comment_data($comment_data)
      *
      * @since 5.5.0
      *
-     * @param string $author The author of the comment
-     * @param string $email The email of the comment
-     * @param string $url The url used in the comment
-     * @param string $comment The comment content
-     * @param string $user_ip The comment author's IP address
-     * @param string $user_agent The author's browser user agent
-     * @return bool True if comment contains disallowed content, false if comment does not
+     * @param string $author     The author of the comment.
+     * @param string $email      The email of the comment.
+     * @param string $url        The url used in the comment.
+     * @param string $comment    The comment content.
+     * @param string $user_ip    The comment author's IP address.
+     * @param string $user_agent The author's browser user agent.
+     * @return bool True if the comment contains disallowed content, false otherwise.
      */
     function wp_check_comment_disallowed_list($author, $email, $url, $comment, $user_ip, $user_agent)
     {
@@ -102688,10 +103099,11 @@ function generic_ping($post_id = 0)
      *
      * @since 0.71
      * @since 4.7.0 `$post` can be a WP_Post object.
+     * @since 6.8.0 Returns an array of pingback statuses indexed by link.
      *
      * @param string      $content Post content to check for links. If empty will retrieve from post.
      * @param int|WP_Post $post    Post ID or object.
-     * @phpstan-return void
+     * @return array<string, bool> An array of pingback statuses indexed by link.
      */
     function pingback($content, $post)
     {
@@ -103041,7 +103453,7 @@ function wp_schedule_event($timestamp, $recurrence, $hook, $args = array(), $wp_
     /**
      * Reschedules a recurring event.
      *
-     * Mainly for internal use, this takes the UTC timestamp of a previously run
+     * Mainly for internal use, this takes the Unix timestamp (UTC) of a previously run
      * recurring event and reschedules it for its next run.
      *
      * To change upcoming scheduled events, use wp_schedule_event() to
@@ -103181,7 +103593,7 @@ function wp_get_scheduled_event($hook, $args = array(), $timestamp = \null)
     {
     }
     /**
-     * Retrieves the next timestamp for an event.
+     * Retrieves the timestamp of the next scheduled event for the given hook.
      *
      * @since 2.1.0
      *
@@ -103190,7 +103602,7 @@ function wp_get_scheduled_event($hook, $args = array(), $timestamp = \null)
      *                     Although not passed to a callback, these arguments are used to uniquely identify the
      *                     event, so they should be the same as those used when originally scheduling the event.
      *                     Default empty array.
-     * @return int|false The Unix timestamp of the next time the event will occur. False if the event doesn't exist.
+     * @return int|false The Unix timestamp (UTC) of the next time the event will occur. False if the event doesn't exist.
      * @phpstan-param list<mixed> $args
      */
     function wp_next_scheduled($hook, $args = array())
@@ -106620,7 +107032,7 @@ function wp_get_duotone_filter_property($preset)
      * Returns the duotone filter SVG string for the preset.
      *
      * @since 5.9.1
-     * @deprecated 6.3.0
+     * @deprecated 6.3.0 Use WP_Duotone::get_filter_svg_from_preset() instead.
      *
      * @access private
      *
@@ -106913,7 +107325,7 @@ function wp_interactivity_process_directives_of_interactive_blocks(array $parsed
      * Gets the global styles custom CSS from theme.json.
      *
      * @since 6.2.0
-     * @deprecated 6.7.0 Use {@see 'wp_get_global_stylesheet'} instead.
+     * @deprecated 6.7.0 Use {@see 'wp_get_global_stylesheet'} instead for top-level custom CSS, or {@see 'WP_Theme_JSON::get_styles_for_block'} for block-level custom CSS.
      *
      * @return string The global styles custom CSS.
      */
@@ -106963,6 +107375,21 @@ function wp_create_block_style_variation_instance_name($block, $variation)
     function current_user_can_for_blog($blog_id, $capability, ...$args)
     {
     }
+    /**
+     * Loads classic theme styles on classic themes in the editor.
+     *
+     * This is used for backwards compatibility for Button and File blocks specifically.
+     *
+     * @since 6.1.0
+     * @since 6.2.0 Added File block styles.
+     * @deprecated 6.8.0 Styles are enqueued, not printed in the body element.
+     *
+     * @param array $editor_settings The array of editor settings.
+     * @return array A filtered array of editor settings.
+     */
+    function wp_add_editor_classic_theme_styles($editor_settings)
+    {
+    }
     /**
      * Registers an embed handler.
      *
@@ -107162,6 +107589,7 @@ function wp_oembed_register_route()
      * Adds oEmbed discovery links in the head element of the website.
      *
      * @since 4.4.0
+     * @since 6.8.0 Output was adjusted to only embed if the post supports it.
      */
     function wp_oembed_add_discovery_links()
     {
@@ -107244,11 +107672,12 @@ function get_post_embed_html($width, $height, $post = \null)
      * Retrieves the oEmbed response data for a given post.
      *
      * @since 4.4.0
+     * @since 6.8.0 Output was adjusted to only embed if the post type supports it.
      *
      * @param WP_Post|int $post  Post ID or post object.
      * @param int         $width The requested width.
-     * @return array|false Response data on success, false if post doesn't exist
-     *                     or is not publicly viewable.
+     * @return array|false Response data on success, false if post doesn't exist,
+     *                     is not publicly viewable or post type is not embeddable.
      */
     function get_oembed_response_data($post, $width)
     {
@@ -108211,7 +108640,7 @@ function wp_html_split($input)
      *
      * @since 4.4.0
      *
-     * @return string The regular expression
+     * @return string The regular expression.
      */
     function get_html_split_regex()
     {
@@ -108225,7 +108654,7 @@ function get_html_split_regex()
      * @since 4.4.0
      *
      * @param string $shortcode_regex Optional. The result from _get_wptexturize_shortcode_regex().
-     * @return string The regular expression
+     * @return string The regular expression.
      */
     function _get_wptexturize_split_regex($shortcode_regex = '')
     {
@@ -108238,7 +108667,7 @@ function _get_wptexturize_split_regex($shortcode_regex = '')
      * @since 4.4.0
      *
      * @param string[] $tagnames Array of shortcodes to find.
-     * @return string The regular expression
+     * @return string The regular expression.
      */
     function _get_wptexturize_shortcode_regex($tagnames)
     {
@@ -108291,7 +108720,7 @@ function shortcode_unautop($text)
      * @author bmorel at ssi dot fr (modified)
      * @since 1.2.1
      *
-     * @param string $str The string to be checked
+     * @param string $str The string to be checked.
      * @return bool True if $str fits a UTF-8 model, false otherwise.
      */
     function seems_utf8($str)
@@ -108367,7 +108796,7 @@ function wp_check_invalid_utf8($text, $strip = \false)
      * @since 5.8.3 Added the `encode_ascii_characters` parameter.
      *
      * @param string $utf8_string             String to encode.
-     * @param int    $length                  Max length of the string
+     * @param int    $length                  Max length of the string.
      * @param bool   $encode_ascii_characters Whether to encode ascii characters such as < " '
      * @return string String with Unicode encoded for URI.
      */
@@ -108946,9 +109375,9 @@ function convert_invalid_entities($content)
      *
      * @since 0.71
      *
-     * @param string $text  Text to be balanced
+     * @param string $text  Text to be balanced.
      * @param bool   $force If true, forces balancing, ignoring the value of the option. Default false.
-     * @return string Balanced text
+     * @return string Balanced text.
      */
     function balanceTags($text, $force = \false)
     {
@@ -109050,7 +109479,7 @@ function trailingslashit($value)
      *
      * @since 2.2.0
      *
-     * @param string $text Value from which trailing slashes will be removed.
+     * @param string $value Value from which trailing slashes will be removed.
      * @return string String without the trailing slashes.
      */
     function untrailingslashit($value)
@@ -110846,11 +111275,13 @@ function status_header($code, $description = '')
      * Gets the HTTP header information to prevent caching.
      *
      * The several different headers cover the different ways cache prevention
-     * is handled by different browsers.
+     * is handled by different browsers or intermediate caches such as proxy servers.
      *
      * @since 2.8.0
      * @since 6.3.0 The `Cache-Control` header for logged in users now includes the
      *              `no-store` and `private` directives.
+     * @since 6.8.0 The `Cache-Control` header now includes the `no-store` and `private`
+     *              directives regardless of whether a user is logged in.
      *
      * @return array The associative array of header names and field values.
      */
@@ -111497,6 +111928,7 @@ function wp_get_image_mime($file)
      * @since 4.2.0 Support was added for GIMP (.xcf) files.
      * @since 4.9.2 Support was added for Flac (.flac) files.
      * @since 4.9.6 Support was added for AAC (.aac) files.
+     * @since 6.8.0 Support was added for `audio/x-wav`.
      *
      * @return string[] Array of mime types keyed by the file extension regex corresponding to those types.
      */
@@ -112595,7 +113027,7 @@ function validate_file($file, $allowed_files = array())
      *
      * @since 2.6.0
      *
-     * @param string|bool $force Optional. Whether to force SSL in admin screens. Default null.
+     * @param string|bool|null $force Optional. Whether to force SSL in admin screens. Default null.
      * @return bool True if forced, false if not forced.
      */
     function force_ssl_admin($force = \null)
@@ -112955,6 +113387,15 @@ function wp_find_hierarchy_loop_tortoise_hare($callback, $start, $override = arr
     function send_frame_options_header()
     {
     }
+    /**
+     * Sends a referrer policy header so referrers are not sent externally from administration screens.
+     *
+     * @since 4.9.0
+     * @since 6.8.0 This function was moved from `wp-admin/includes/misc.php` to `wp-includes/functions.php`.
+     */
+    function wp_admin_headers()
+    {
+    }
     /**
      * Retrieves a list of protocols to allow in HTML attributes.
      *
@@ -113767,6 +114208,67 @@ function wp_admin_notice($message, $args = array())
     function wp_is_heic_image_mime_type($mime_type)
     {
     }
+    /**
+     * Returns a cryptographically secure hash of a message using a fast generic hash function.
+     *
+     * Use the wp_verify_fast_hash() function to verify the hash.
+     *
+     * This function does not salt the value prior to being hashed, therefore input to this function must originate from
+     * a random generator with sufficiently high entropy, preferably greater than 128 bits. This function is used internally
+     * in WordPress to hash security keys and application passwords which are generated with high entropy.
+     *
+     * Important:
+     *
+     *  - This function must not be used for hashing user-generated passwords. Use wp_hash_password() for that.
+     *  - This function must not be used for hashing other low-entropy input. Use wp_hash() for that.
+     *
+     * The BLAKE2b algorithm is used by Sodium to hash the message.
+     *
+     * @since 6.8.0
+     *
+     * @throws TypeError Thrown by Sodium if the message is not a string.
+     *
+     * @param string $message The message to hash.
+     * @return string The hash of the message.
+     */
+    function wp_fast_hash(#[\SensitiveParameter] string $message) : string
+    {
+    }
+    /**
+     * Checks whether a plaintext message matches the hashed value. Used to verify values hashed via wp_fast_hash().
+     *
+     * The function uses Sodium to hash the message and compare it to the hashed value. If the hash is not a generic hash,
+     * the hash is treated as a phpass portable hash in order to provide backward compatibility for passwords and security
+     * keys which were hashed using phpass prior to WordPress 6.8.0.
+     *
+     * @since 6.8.0
+     *
+     * @throws TypeError Thrown by Sodium if the message is not a string.
+     *
+     * @param string $message The plaintext message.
+     * @param string $hash    Hash of the message to check against.
+     * @return bool Whether the message matches the hashed message.
+     */
+    function wp_verify_fast_hash(#[\SensitiveParameter] string $message, string $hash) : bool
+    {
+    }
+    /**
+     * Generates a unique ID based on the structure and values of a given array.
+     *
+     * This function serializes the array into a JSON string and generates a hash
+     * that serves as a unique identifier. Optionally, a prefix can be added to
+     * the generated ID for context or categorization.
+     *
+     * @since 6.8.0
+     *
+     * @param array  $data   The input array to generate an ID from.
+     * @param string $prefix Optional. A prefix to prepend to the generated ID. Default ''.
+     *
+     * @return string The generated unique ID for the array.
+     */
+    function wp_unique_id_from_values(array $data, string $prefix = '') : string
+    {
+    }
     /**
      * Initializes $wp_scripts if it has not been set.
      *
@@ -114202,9 +114704,9 @@ function wp_style_add_data($handle, $key, $value)
      * @since 5.5.0 A return value was added.
      * @since 5.5.0 The `$args` parameter was added.
      *
-     * @param string $name The name of the specialized header.
-     * @param array  $args Optional. Additional arguments passed to the header template.
-     *                     Default empty array.
+     * @param string|null $name The name of the specialized header. Default null.
+     * @param array       $args Optional. Additional arguments passed to the header template.
+     *                          Default empty array.
      * @return void|false Void on success, false if the template does not exist.
      */
     function get_header($name = \null, $args = array())
@@ -114223,9 +114725,9 @@ function get_header($name = \null, $args = array())
      * @since 5.5.0 A return value was added.
      * @since 5.5.0 The `$args` parameter was added.
      *
-     * @param string $name The name of the specialized footer.
-     * @param array  $args Optional. Additional arguments passed to the footer template.
-     *                     Default empty array.
+     * @param string|null $name The name of the specialized footer. Default null.
+     * @param array       $args Optional. Additional arguments passed to the footer template.
+     *                          Default empty array.
      * @return void|false Void on success, false if the template does not exist.
      */
     function get_footer($name = \null, $args = array())
@@ -114244,9 +114746,9 @@ function get_footer($name = \null, $args = array())
      * @since 5.5.0 A return value was added.
      * @since 5.5.0 The `$args` parameter was added.
      *
-     * @param string $name The name of the specialized sidebar.
-     * @param array  $args Optional. Additional arguments passed to the sidebar template.
-     *                     Default empty array.
+     * @param string|null $name The name of the specialized sidebar. Default null.
+     * @param array       $args Optional. Additional arguments passed to the sidebar template.
+     *                          Default empty array.
      * @return void|false Void on success, false if the template does not exist.
      */
     function get_sidebar($name = \null, $args = array())
@@ -114273,7 +114775,7 @@ function get_sidebar($name = \null, $args = array())
      * @since 5.5.0 The `$args` parameter was added.
      *
      * @param string      $slug The slug name for the generic template.
-     * @param string|null $name Optional. The name of the specialized template.
+     * @param string|null $name Optional. The name of the specialized template. Default null.
      * @param array       $args Optional. Additional arguments passed to the template.
      *                          Default empty array.
      * @return void|false Void on success, false if the template does not exist.
@@ -114856,7 +115358,7 @@ function get_the_post_type_description()
      * @param string $format   Optional. Can be 'link', 'option', 'html', or custom. Default 'html'.
      * @param string $before   Optional. Content to prepend to the description. Default empty.
      * @param string $after    Optional. Content to append to the description. Default empty.
-     * @param bool   $selected Optional. Set to true if the current page is the selected archive page.
+     * @param bool   $selected Optional. Set to true if the current page is the selected archive page. Default false.
      * @return string HTML link content for archive.
      */
     function get_archives_link($url, $text, $format = 'html', $before = '', $after = '', $selected = \false)
@@ -114939,6 +115441,8 @@ function calendar_week_mod($num)
      * no posts for the month, then it will not be displayed.
      *
      * @since 1.0.0
+     * @since 6.8.0 Added the `$args` parameter, with backward compatibility
+     *              for the replaced `$initial` and `$display` parameters.
      *
      * @global wpdb      $wpdb      WordPress database abstraction object.
      * @global int       $m
@@ -114947,12 +115451,22 @@ function calendar_week_mod($num)
      * @global WP_Locale $wp_locale WordPress date and time locale object.
      * @global array     $posts
      *
-     * @param bool $initial Optional. Whether to use initial calendar names. Default true.
-     * @param bool $display Optional. Whether to display the calendar output. Default true.
+     * @param array $args {
+     *     Optional. Arguments for the `get_calendar` function.
+     *
+     *     @type bool   $initial   Whether to use initial calendar names. Default true.
+     *     @type bool   $display   Whether to display the calendar output. Default true.
+     *     @type string $post_type Optional. Post type. Default 'post'.
+     * }
      * @return void|string Void if `$display` argument is true, calendar HTML if `$display` is false.
+     * @phpstan-param array{
+     *   initial?: bool,
+     *   display?: bool,
+     *   post_type?: string,
+     * } $args
      * @phpstan-return ($display is true ? void : string)
      */
-    function get_calendar($initial = \true, $display = \true)
+    function get_calendar($args = array())
     {
     }
     /**
@@ -114989,7 +115503,7 @@ function the_date_xml()
     {
     }
     /**
-     * Displays or retrieves the date the current post was written (once per date)
+     * Displays or retrieves the date of the post (once per date).
      *
      * Will only output the date if the current post's date is different from the
      * previous one output.
@@ -114997,8 +115511,8 @@ function the_date_xml()
      * i.e. Only one date listing will show per day worth of posts shown in the loop, even if the
      * function is called several times for each post.
      *
-     * HTML output can be filtered with 'the_date'.
-     * Date string output can be filtered with 'get_the_date'.
+     * HTML output can be filtered with {@see 'the_date'}.
+     * Date string output can be filtered with {@see 'get_the_date'}.
      *
      * @since 0.71
      *
@@ -115016,7 +115530,7 @@ function the_date($format = '', $before = '', $after = '', $display = \true)
     {
     }
     /**
-     * Retrieves the date on which the post was written.
+     * Retrieves the date of the post.
      *
      * Unlike the_date() this function will always return the date.
      * Modify output with the {@see 'get_the_date'} filter.
@@ -115059,7 +115573,7 @@ function get_the_modified_date($format = '', $post = \null)
     {
     }
     /**
-     * Displays the time at which the post was written.
+     * Displays the time of the post.
      *
      * @since 0.71
      *
@@ -115071,7 +115585,7 @@ function the_time($format = '')
     {
     }
     /**
-     * Retrieves the time at which the post was written.
+     * Retrieves the time of the post.
      *
      * @since 1.5.0
      *
@@ -115086,7 +115600,7 @@ function get_the_time($format = '', $post = \null)
     {
     }
     /**
-     * Retrieves the time at which the post was written.
+     * Retrieves the localized time of the post.
      *
      * @since 2.0.0
      *
@@ -115186,7 +115700,7 @@ function get_post_modified_time($format = 'U', $gmt = \false, $post = \null, $tr
     {
     }
     /**
-     * Displays the weekday on which the post was written.
+     * Displays the localized weekday for the post.
      *
      * @since 0.71
      *
@@ -115197,7 +115711,7 @@ function the_weekday()
     {
     }
     /**
-     * Displays the weekday on which the post was written.
+     * Displays the localized weekday for the post.
      *
      * Will only output the weekday if the current post's weekday is different from
      * the previous one output.
@@ -115373,7 +115887,7 @@ function user_can_richedit()
      * Finds out which editor should be displayed by default.
      *
      * Works out which of the editors to display as the current editor for a
-     * user. The 'html' setting is for the "Text" editor tab.
+     * user. The 'html' setting is for the "Code" editor tab.
      *
      * @since 2.5.0
      *
@@ -115980,7 +116494,7 @@ function wp_get_global_styles($path = array(), $context = array())
      * @since 6.6.0 Resolves relative paths in theme.json styles to theme absolute paths.
      *
      * @param array $types Optional. Types of styles to load.
-     *                     It accepts as values 'variables', 'presets', 'styles', 'base-layout-styles'.
+     *                     See {@see 'WP_Theme_JSON::get_stylesheet'} for all valid types.
      *                     If empty, it'll load the following:
      *                     - for themes without theme.json: 'variables', 'presets', 'base-layout-styles'.
      *                     - for themes with theme.json: 'variables', 'presets', 'styles'.
@@ -116742,6 +117256,11 @@ function wp_is_site_url_using_https()
     /**
      * Checks whether HTTPS is supported for the server and domain.
      *
+     * This function makes an HTTP request through `wp_get_https_detection_errors()`
+     * to check for HTTPS support. As this process can be resource-intensive,
+     * it should be used cautiously, especially in performance-sensitive environments,
+     * to avoid potential latency issues.
+     *
      * @since 5.7.0
      *
      * @return bool True if HTTPS is supported, false otherwise.
@@ -116752,10 +117271,14 @@ function wp_is_https_supported()
     /**
      * Runs a remote HTTPS request to detect whether HTTPS supported, and stores potential errors.
      *
-     * This internal function is called by a regular Cron hook to ensure HTTPS support is detected and maintained.
+     * This function checks for HTTPS support by making an HTTP request. As this process can be resource-intensive,
+     * it should be used cautiously, especially in performance-sensitive environments.
+     * It is called when HTTPS support needs to be validated.
      *
      * @since 6.4.0
      * @access private
+     *
+     * @return array An array containing potential detection errors related to HTTPS, or an empty array if no errors are found.
      */
     function wp_get_https_detection_errors()
     {
@@ -117726,7 +118249,8 @@ function get_user_locale($user = 0)
      *
      * @since 5.0.0
      *
-     * @global string $pagenow The filename of the current screen.
+     * @global string $pagenow          The filename of the current screen.
+     * @global string $wp_local_package Locale code of the package.
      *
      * @return string The determined locale.
      */
@@ -120332,11 +120856,12 @@ function wp_shortlink_header()
      * Call like the_shortlink( __( 'Shortlinkage FTW' ) )
      *
      * @since 3.0.0
+     * @since 6.8.0 Removed title attribute.
      *
-     * @param string $text   Optional The link text or HTML to be displayed. Defaults to 'This is the short link.'
-     * @param string $title  Optional The tooltip for the link. Must be sanitized. Defaults to the sanitized post title.
-     * @param string $before Optional HTML to display before the link. Default empty.
-     * @param string $after  Optional HTML to display after the link. Default empty.
+     * @param string $text   Optional. The link text or HTML to be displayed. Defaults to 'This is the short link.'
+     * @param string $title  Unused.
+     * @param string $before Optional. HTML to display before the link. Default empty.
+     * @param string $after  Optional. HTML to display after the link. Default empty.
      */
     function the_shortlink($text = '', $title = '', $before = '', $after = '')
     {
@@ -120346,7 +120871,7 @@ function the_shortlink($text = '', $title = '', $before = '', $after = '')
      *
      * @since 4.2.0
      *
-     * @param mixed $id_or_email The avatar to retrieve a URL for. Accepts a user ID, Gravatar MD5 hash,
+     * @param mixed $id_or_email The avatar to retrieve a URL for. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
      *                           user email, WP_User object, WP_Post object, or WP_Comment object.
      * @param array $args {
      *     Optional. Arguments to use instead of the default arguments.
@@ -120406,8 +120931,9 @@ function is_avatar_comment_type($comment_type)
      *
      * @since 4.2.0
      * @since 6.7.0 Gravatar URLs always use HTTPS.
+     * @since 6.8.0 Gravatar URLs use the SHA-256 hashing algorithm.
      *
-     * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+     * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
      *                           user email, WP_User object, WP_Post object, or WP_Comment object.
      * @param array $args {
      *     Optional. Arguments to use instead of the default arguments.
@@ -120633,8 +121159,9 @@ function wp_populate_basic_auth_from_authorization_header()
      * @since 3.0.0
      * @access private
      *
-     * @global string $required_php_version The required PHP version string.
-     * @global string $wp_version           The WordPress version string.
+     * @global string   $required_php_version    The required PHP version string.
+     * @global string[] $required_php_extensions The names of required PHP extensions.
+     * @global string   $wp_version              The WordPress version string.
      */
     function wp_check_php_mysql_versions()
     {
@@ -121540,7 +122067,7 @@ function image_downsize($id, $size = 'medium')
      *     If true, image will be cropped to the specified dimensions using center positions.
      *     If an array, the image will be cropped using the array to specify the crop location:
      *
-     *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+     *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
      *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
      * }
      * @phpstan-param bool|array{
@@ -121589,7 +122116,7 @@ function remove_image_size($name)
      *     If true, image will be cropped to the specified dimensions using center positions.
      *     If an array, the image will be cropped using the array to specify the crop location:
      *
-     *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+     *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
      *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
      * }
      * @phpstan-param bool|array{
@@ -121668,7 +122195,7 @@ function wp_constrain_dimensions($current_width, $current_height, $max_width = 0
      *     If true, image will be cropped to the specified dimensions using center positions.
      *     If an array, the image will be cropped using the array to specify the crop location:
      *
-     *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+     *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
      *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
      * }
      * @return array|false Returned array matches parameters for `imagecopyresampled()`. False on failure.
@@ -121697,7 +122224,7 @@ function image_resize_dimensions($orig_w, $orig_h, $dest_w, $dest_h, $crop = \fa
      *     If true, image will be cropped to the specified dimensions using center positions.
      *     If an array, the image will be cropped using the array to specify the crop location:
      *
-     *     @type string $0 The x crop position. Accepts 'left' 'center', or 'right'.
+     *     @type string $0 The x crop position. Accepts 'left', 'center', or 'right'.
      *     @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'.
      * }
      * @return array|false Metadata array on success. False if no image was created.
@@ -122465,6 +122992,7 @@ function wp_get_attachment_id3_keys($attachment, $context = 'display')
      * WordPress mp3s in a post.
      *
      * @since 3.6.0
+     * @since 6.8.0 Added the 'muted' attribute.
      *
      * @param array  $attr {
      *     Attributes of the audio shortcode.
@@ -122472,6 +123000,7 @@ function wp_get_attachment_id3_keys($attachment, $context = 'display')
      *     @type string $src      URL to the source of the audio file. Default empty.
      *     @type string $loop     The 'loop' attribute for the `<audio>` element. Default empty.
      *     @type string $autoplay The 'autoplay' attribute for the `<audio>` element. Default empty.
+     *     @type string $muted    The 'muted' attribute for the `<audio>` element. Default 'false'.
      *     @type string $preload  The 'preload' attribute for the `<audio>` element. Default 'none'.
      *     @type string $class    The 'class' attribute for the `<audio>` element. Default 'wp-audio-shortcode'.
      *     @type string $style    The 'style' attribute for the `<audio>` element. Default 'width: 100%;'.
@@ -122482,6 +123011,7 @@ function wp_get_attachment_id3_keys($attachment, $context = 'display')
      *   src?: string,
      *   loop?: string,
      *   autoplay?: string,
+     *   muted?: string,
      *   preload?: string,
      *   class?: string,
      *   style?: string,
@@ -122822,7 +123352,6 @@ function wp_plupload_default_settings()
      *     @type string $url                   Direct URL to the attachment file (from wp-content).
      *     @type int    $width                 If the attachment is an image, represents the width of the image in pixels.
      * }
-     *
      * @phpstan-return void|array{
      *   alt: string,
      *   author: string,
@@ -123218,7 +123747,13 @@ function wp_get_image_editor_output_format($filename, $mime_type)
      *                           or any other object type with an associated meta table.
      * @param int    $object_id  ID of the object metadata is for.
      * @param string $meta_key   Metadata key.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the specified metadata key should be unique for the object.
      *                           If true, and the object already has a value for the specified metadata key,
      *                           no change will be made. Default false.
@@ -123305,6 +123840,11 @@ function delete_metadata($meta_type, $object_id, $meta_key, $meta_value = '', $d
      *               or if `$meta_type` is not specified.
      *               An empty array if a valid but non-existing object ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing object ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers (both integer and float) are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_metadata($meta_type, $object_id, $meta_key = '', $single = \false)
     {
@@ -124783,7 +125323,7 @@ function wpmu_signup_user($user, $user_email, $meta = array())
      * @param array  $meta       Optional. Signup meta data. By default, contains the requested privacy setting and lang_id.
      * @return bool
      */
-    function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $user_email, $key, $meta = array())
+    function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $user_email, #[\SensitiveParameter] $key, $meta = array())
     {
     }
     /**
@@ -124808,7 +125348,7 @@ function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $use
      * @param array  $meta       Optional. Signup meta data. Default empty array.
      * @return bool
      */
-    function wpmu_signup_user_notification($user_login, $user_email, $key, $meta = array())
+    function wpmu_signup_user_notification($user_login, $user_email, #[\SensitiveParameter] $key, $meta = array())
     {
     }
     /**
@@ -124826,7 +125366,7 @@ function wpmu_signup_user_notification($user_login, $user_email, $key, $meta = a
      * @param string $key The activation key provided to the user.
      * @return array|WP_Error An array containing information about the activated user and/or blog.
      */
-    function wpmu_activate_signup($key)
+    function wpmu_activate_signup(#[\SensitiveParameter] $key)
     {
     }
     /**
@@ -124858,7 +125398,7 @@ function wp_delete_signup_on_user_delete($id, $reassign, $user)
      * @param string $email     The new user's email address.
      * @return int|false Returns false on failure, or int $user_id on success.
      */
-    function wpmu_create_user($user_name, $password, $email)
+    function wpmu_create_user($user_name, #[\SensitiveParameter] $password, $email)
     {
     }
     /**
@@ -124958,7 +125498,7 @@ function domain_exists($domain, $path, $network_id = 1)
      * @param array  $meta     Optional. Signup meta data. By default, contains the requested privacy setting and lang_id.
      * @return bool Whether the email notification was sent.
      */
-    function wpmu_welcome_notification($blog_id, $user_id, $password, $title, $meta = array())
+    function wpmu_welcome_notification($blog_id, $user_id, #[\SensitiveParameter] $password, $title, $meta = array())
     {
     }
     /**
@@ -124992,7 +125532,7 @@ function wpmu_new_site_admin_notification($site_id, $user_id)
      * @param array  $meta     Optional. Signup meta data. Default empty array.
      * @return bool
      */
-    function wpmu_welcome_user_notification($user_id, $password, $meta = array())
+    function wpmu_welcome_user_notification($user_id, #[\SensitiveParameter] $password, $meta = array())
     {
     }
     /**
@@ -125181,7 +125721,7 @@ function add_existing_user_to_blog($details = \false)
      * @param string $password User password. Ignored.
      * @param array  $meta     Signup meta data.
      */
-    function add_new_user_to_blog($user_id, $password, $meta)
+    function add_new_user_to_blog($user_id, #[\SensitiveParameter] $password, $meta)
     {
     }
     /**
@@ -125189,7 +125729,7 @@ function add_new_user_to_blog($user_id, $password, $meta)
      *
      * @since MU (3.0.0)
      *
-     * @param PHPMailer $phpmailer The PHPMailer instance (passed by reference).
+     * @param PHPMailer\PHPMailer\PHPMailer $phpmailer The PHPMailer instance (passed by reference).
      */
     function fix_phpmailer_messageid($phpmailer)
     {
@@ -126092,7 +126632,13 @@ function clean_blog_cache($blog)
      *
      * @param int    $site_id    Site ID.
      * @param string $meta_key   Metadata name.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the same key should not be added.
      *                           Default false.
      * @return int|false Meta ID on success, false on failure.
@@ -126135,6 +126681,11 @@ function delete_site_meta($site_id, $meta_key, $meta_value = '')
      *               False for an invalid `$site_id` (non-numeric, zero, or negative value).
      *               An empty array if a valid but non-existing site ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing site ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers (both integer and float) are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_site_meta($site_id, $key = '', $single = \false)
     {
@@ -127000,7 +127551,7 @@ function wp_prime_site_option_caches(array $options)
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
-     * @param int      $network_id ID of the network. Can be null to default to the current network ID.
+     * @param int|null $network_id ID of the network. Can be null to default to the current network ID.
      * @param string[] $options    An array of option names to be loaded.
      * @phpstan-return void
      */
@@ -127121,15 +127672,15 @@ function delete_option($option)
      * @since 6.6.0
      * @access private
      *
-     * @param string $option          The name of the option.
-     * @param mixed $value            The value of the option to check its autoload value.
-     * @param mixed $serialized_value The serialized value of the option to check its autoload value.
-     * @param bool|null $autoload     The autoload value to check.
-     *                                Accepts 'on'|true to enable or 'off'|false to disable, or
-     *                                'auto-on', 'auto-off', or 'auto' for internal purposes.
-     *                                Any other autoload value will be forced to either 'auto-on',
-     *                                'auto-off', or 'auto'.
-     *                                'yes' and 'no' are supported for backward compatibility.
+     * @param string    $option           The name of the option.
+     * @param mixed     $value            The value of the option to check its autoload value.
+     * @param mixed     $serialized_value The serialized value of the option to check its autoload value.
+     * @param bool|null $autoload         The autoload value to check.
+     *                                    Accepts 'on'|true to enable or 'off'|false to disable, or
+     *                                    'auto-on', 'auto-off', or 'auto' for internal purposes.
+     *                                    Any other autoload value will be forced to either 'auto-on',
+     *                                    'auto-off', or 'auto'.
+     *                                    'yes' and 'no' are supported for backward compatibility.
      * @return string Returns the original $autoload value if explicit, or 'auto-on', 'auto-off',
      *                or 'auto' depending on default heuristics.
      */
@@ -127378,9 +127929,9 @@ function update_site_option($option, $value)
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
-     * @param int    $network_id    ID of the network. Can be null to default to the current network ID.
-     * @param string $option        Name of the option to retrieve. Expected to not be SQL-escaped.
-     * @param mixed  $default_value Optional. Value to return if the option doesn't exist. Default false.
+     * @param int|null $network_id    ID of the network. Can be null to default to the current network ID.
+     * @param string   $option        Name of the option to retrieve. Expected to not be SQL-escaped.
+     * @param mixed    $default_value Optional. Value to return if the option doesn't exist. Default false.
      * @return mixed Value set for the option.
      */
     function get_network_option($network_id, $option, $default_value = \false)
@@ -127397,9 +127948,9 @@ function get_network_option($network_id, $option, $default_value = \false)
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
-     * @param int    $network_id ID of the network. Can be null to default to the current network ID.
-     * @param string $option     Name of the option to add. Expected to not be SQL-escaped.
-     * @param mixed  $value      Option value, can be anything. Expected to not be SQL-escaped.
+     * @param int|null $network_id ID of the network. Can be null to default to the current network ID.
+     * @param string   $option     Name of the option to add. Expected to not be SQL-escaped.
+     * @param mixed    $value      Option value, can be anything. Expected to not be SQL-escaped.
      * @return bool True if the option was added, false otherwise.
      */
     function add_network_option($network_id, $option, $value)
@@ -127414,8 +127965,8 @@ function add_network_option($network_id, $option, $value)
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
-     * @param int    $network_id ID of the network. Can be null to default to the current network ID.
-     * @param string $option     Name of the option to delete. Expected to not be SQL-escaped.
+     * @param int|null $network_id ID of the network. Can be null to default to the current network ID.
+     * @param string   $option     Name of the option to delete. Expected to not be SQL-escaped.
      * @return bool True if the option was deleted, false otherwise.
      */
     function delete_network_option($network_id, $option)
@@ -127430,9 +127981,9 @@ function delete_network_option($network_id, $option)
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
-     * @param int    $network_id ID of the network. Can be null to default to the current network ID.
-     * @param string $option     Name of the option. Expected to not be SQL-escaped.
-     * @param mixed  $value      Option value. Expected to not be SQL-escaped.
+     * @param int|null $network_id ID of the network. Can be null to default to the current network ID.
+     * @param string   $option     Name of the option. Expected to not be SQL-escaped.
+     * @param mixed    $value      Option value. Expected to not be SQL-escaped.
      * @return bool True if the value was updated, false otherwise.
      */
     function update_network_option($network_id, $option, $value)
@@ -127663,7 +128214,7 @@ function get_user_by_email($email)
      * @param string $siteurl Optional. Will be used instead of SITECOOKIEPATH if set
      * @param bool $remember Optional. Remember that the user is logged in
      */
-    function wp_setcookie($username, $password = '', $already_md5 = \false, $home = '', $siteurl = '', $remember = \false)
+    function wp_setcookie($username, #[\SensitiveParameter] $password = '', $already_md5 = \false, $home = '', $siteurl = '', $remember = \false)
     {
     }
     /**
@@ -127711,7 +128262,7 @@ function wp_get_cookie_login()
      * @param string $deprecated Not used
      * @return bool True on successful check, false on login failure.
      */
-    function wp_login($username, $password, $deprecated = '')
+    function wp_login($username, #[\SensitiveParameter] $password, $deprecated = '')
     {
     }
     /**
@@ -127832,7 +128383,7 @@ function wp_mail($to, $subject, $message, $headers = '', $attachments = array())
      * @return WP_User|WP_Error WP_User object if the credentials are valid,
      *                          otherwise WP_Error.
      */
-    function wp_authenticate($username, $password)
+    function wp_authenticate($username, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -127858,6 +128409,7 @@ function wp_logout()
      *
      * @param string $cookie Optional. If used, will validate contents instead of cookie's.
      * @param string $scheme Optional. The cookie scheme to use: 'auth', 'secure_auth', or 'logged_in'.
+     *                       Note: This does *not* default to 'auth' like other cookie functions.
      * @return int|false User ID if valid cookie, false if invalid.
      * @phpstan-param 'auth'|'secure_auth'|'logged_in' $scheme
      */
@@ -128197,7 +128749,7 @@ function wp_nonce_tick($action = -1)
     /**
      * Verifies that a correct security nonce was used with time limit.
      *
-     * A nonce is valid for 24 hours (by default).
+     * A nonce is valid for between 12 and 24 hours (by default).
      *
      * @since 2.0.3
      *
@@ -128262,15 +128814,23 @@ function wp_salt($scheme = 'auth')
     {
     }
     /**
-     * Gets hash of given string.
+     * Gets the hash of the given string.
+     *
+     * The default algorithm is md5 but can be changed to any algorithm supported by
+     * `hash_hmac()`. Use the `hash_hmac_algos()` function to check the supported
+     * algorithms.
      *
      * @since 2.0.3
+     * @since 6.8.0 The `$algo` parameter was added.
+     *
+     * @throws InvalidArgumentException if the hashing algorithm is not supported.
      *
      * @param string $data   Plain text to hash.
      * @param string $scheme Authentication scheme (auth, secure_auth, logged_in, nonce).
+     * @param string $algo   Hashing algorithm to use. Default: 'md5'.
      * @return string Hash of $data.
      */
-    function wp_hash($data, $scheme = 'auth')
+    function wp_hash($data, $scheme = 'auth', $algo = 'md5')
     {
     }
     /**
@@ -128280,38 +128840,62 @@ function wp_hash($data, $scheme = 'auth')
      * instead use the other package password hashing algorithm.
      *
      * @since 2.5.0
+     * @since 6.8.0 The password is now hashed using bcrypt by default instead of phpass.
      *
-     * @global PasswordHash $wp_hasher PHPass object.
+     * @global PasswordHash $wp_hasher phpass object.
      *
      * @param string $password Plain text user password to hash.
      * @return string The hash string of the password.
      */
-    function wp_hash_password($password)
+    function wp_hash_password(#[\SensitiveParameter] $password)
     {
     }
     /**
      * Checks a plaintext password against a hashed password.
      *
-     * Maintains compatibility between old version and the new cookie authentication
-     * protocol using PHPass library. The $hash parameter is the encrypted password
-     * and the function compares the plain text password when encrypted similarly
-     * against the already encrypted password to see if they match.
+     * Note that this function may be used to check a value that is not a user password.
+     * A plugin may use this function to check a password of a different type, and there
+     * may not always be a user ID associated with the password.
      *
      * For integration with other applications, this function can be overwritten to
      * instead use the other package password hashing algorithm.
      *
      * @since 2.5.0
+     * @since 6.8.0 Passwords in WordPress are now hashed with bcrypt by default. A
+     *              password that wasn't hashed with bcrypt will be checked with phpass.
      *
-     * @global PasswordHash $wp_hasher PHPass object used for checking the password
-     *                                 against the $hash + $password.
-     * @uses PasswordHash::CheckPassword
+     * @global PasswordHash $wp_hasher phpass object. Used as a fallback for verifying
+     *                                 passwords that were hashed with phpass.
      *
-     * @param string     $password Plaintext user's password.
-     * @param string     $hash     Hash of the user's password to check against.
-     * @param string|int $user_id  Optional. User ID.
+     * @param string     $password Plaintext password.
+     * @param string     $hash     Hash of the password to check against.
+     * @param string|int $user_id  Optional. ID of a user associated with the password.
      * @return bool False, if the $password does not match the hashed password.
      */
-    function wp_check_password($password, $hash, $user_id = '')
+    function wp_check_password(#[\SensitiveParameter] $password, $hash, $user_id = '')
+    {
+    }
+    /**
+     * Checks whether a password hash needs to be rehashed.
+     *
+     * Passwords are hashed with bcrypt using the default cost. A password hashed in a prior version
+     * of WordPress may still be hashed with phpass and will need to be rehashed. If the default cost
+     * or algorithm is changed in PHP or WordPress then a password hashed in a previous version will
+     * need to be rehashed.
+     *
+     * Note that, just like wp_check_password(), this function may be used to check a value that is
+     * not a user password. A plugin may use this function to check a password of a different type,
+     * and there may not always be a user ID associated with the password.
+     *
+     * @since 6.8.0
+     *
+     * @global PasswordHash $wp_hasher phpass object.
+     *
+     * @param string     $hash    Hash of a password to check.
+     * @param string|int $user_id Optional. ID of a user associated with the password.
+     * @return bool Whether the hash needs to be rehashed.
+     */
+    function wp_password_needs_rehash($hash, $user_id = '')
     {
     }
     /**
@@ -128361,13 +128945,14 @@ function wp_rand($min = \null, $max = \null)
      * of password resets if precautions are not taken to ensure it does not execute on every page load.
      *
      * @since 2.5.0
+     * @since 6.8.0 The password is now hashed using bcrypt by default instead of phpass.
      *
      * @global wpdb $wpdb WordPress database abstraction object.
      *
      * @param string $password The plaintext new user password.
      * @param int    $user_id  User ID.
      */
-    function wp_set_password($password, $user_id)
+    function wp_set_password(#[\SensitiveParameter] $password, $user_id)
     {
     }
     /**
@@ -130026,7 +130611,7 @@ function has_post_parent($post = \null)
      * @since 2.9.0
      * @since 4.4.0 `$post` can be a post ID or WP_Post object.
      *
-     * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
      * @return bool Whether the post has an image attached.
      */
     function has_post_thumbnail($post = \null)
@@ -130040,7 +130625,7 @@ function has_post_thumbnail($post = \null)
      * @since 5.5.0 The return value for a non-existing post
      *              was changed to false instead of an empty string.
      *
-     * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
      * @return int|false Post thumbnail ID (which can be 0 if the thumbnail is not set),
      *                   or false if the post does not exist.
      */
@@ -130075,7 +130660,7 @@ function the_post_thumbnail($size = 'post-thumbnail', $attr = '')
      *
      * @global WP_Query $wp_query WordPress Query object.
      *
-     * @param WP_Query $wp_query Optional. A WP_Query instance. Defaults to the $wp_query global.
+     * @param WP_Query|null $wp_query Optional. A WP_Query instance. Defaults to the $wp_query global.
      * @phpstan-return void
      */
     function update_post_thumbnail_cache($wp_query = \null)
@@ -130094,10 +130679,10 @@ function update_post_thumbnail_cache($wp_query = \null)
      * @since 2.9.0
      * @since 4.4.0 `$post` can be a post ID or WP_Post object.
      *
-     * @param int|WP_Post  $post Optional. Post ID or WP_Post object.  Default is global `$post`.
-     * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of
-     *                           width and height values in pixels (in that order). Default 'post-thumbnail'.
-     * @param string|array $attr Optional. Query string or array of attributes. Default empty.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object.  Default is global `$post`.
+     * @param string|int[]     $size Optional. Image size. Accepts any registered image size name, or an array of
+     *                               width and height values in pixels (in that order). Default 'post-thumbnail'.
+     * @param string|array     $attr Optional. Query string or array of attributes. Default empty.
      * @return string The post thumbnail image tag.
      */
     function get_the_post_thumbnail($post = \null, $size = 'post-thumbnail', $attr = '')
@@ -130108,9 +130693,9 @@ function get_the_post_thumbnail($post = \null, $size = 'post-thumbnail', $attr =
      *
      * @since 4.4.0
      *
-     * @param int|WP_Post  $post Optional. Post ID or WP_Post object.  Default is global `$post`.
-     * @param string|int[] $size Optional. Registered image size to retrieve the source for or a flat array
-     *                           of height and width dimensions. Default 'post-thumbnail'.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object.  Default is global `$post`.
+     * @param string|int[]     $size Optional. Registered image size to retrieve the source for or a flat array
+     *                               of height and width dimensions. Default 'post-thumbnail'.
      * @return string|false Post thumbnail URL or false if no image is available. If `$size` does not match
      *                      any registered image size, the original image URL will be returned.
      */
@@ -130134,7 +130719,7 @@ function the_post_thumbnail_url($size = 'post-thumbnail')
      *
      * @since 4.6.0
      *
-     * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
      * @return string Post thumbnail caption.
      */
     function get_the_post_thumbnail_caption($post = \null)
@@ -130145,7 +130730,7 @@ function get_the_post_thumbnail_caption($post = \null)
      *
      * @since 4.6.0
      *
-     * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`.
+     * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
      */
     function the_post_thumbnail_caption($post = \null)
     {
@@ -130184,13 +130769,15 @@ function get_attached_file($attachment_id, $unfiltered = \false)
      * Updates attachment file path based on attachment ID.
      *
      * Used to update the file path of the attachment, which uses post meta name
-     * '_wp_attached_file' to store the path of the attachment.
+     * `_wp_attached_file` to store the path of the attachment.
      *
      * @since 2.1.0
      *
      * @param int    $attachment_id Attachment ID.
      * @param string $file          File path for the attachment.
-     * @return bool True on success, false on failure.
+     * @return int|bool Meta ID if the `_wp_attached_file` key didn't exist for the attachment.
+     *                  True on successful update, false on failure or if the `$file` value passed
+     *                  to the function is the same as the one that is already in the database.
      */
     function update_attached_file($attachment_id, $file)
     {
@@ -130908,8 +131495,8 @@ function _post_type_meta_capabilities($capabilities = \null)
      * - `name` - General name for the post type, usually plural. The same and overridden
      *          by `$post_type_object->label`. Default is 'Posts' / 'Pages'.
      * - `singular_name` - Name for one object of this post type. Default is 'Post' / 'Page'.
-     * - `add_new` - Label for adding a new item. Default is 'Add New' / 'Add New'.
-     * - `add_new_item` - Label for adding a new singular item. Default is 'Add New Post' / 'Add New Page'.
+     * - `add_new` - Label for adding a new item. Default is 'Add Post' / 'Add Page'.
+     * - `add_new_item` - Label for adding a new singular item. Default is 'Add Post' / 'Add Page'.
      * - `edit_item` - Label for editing a singular item. Default is 'Edit Post' / 'Edit Page'.
      * - `new_item` - Label for the new item page title. Default is 'New Post' / 'New Page'.
      * - `view_item` - Label for viewing a singular item. Default is 'View Post' / 'View Page'.
@@ -131165,6 +131752,17 @@ function is_post_status_viewable($post_status)
     function is_post_publicly_viewable($post = \null)
     {
     }
+    /**
+     * Determines whether a post is embeddable.
+     *
+     * @since 6.8.0
+     *
+     * @param int|WP_Post|null $post Optional. Post ID or `WP_Post` object. Defaults to global $post.
+     * @return bool Whether the post should be considered embeddable.
+     */
+    function is_post_embeddable($post = \null)
+    {
+    }
     /**
      * Retrieves an array of the latest posts, or posts matching the given criteria.
      *
@@ -131291,7 +131889,13 @@ function get_posts($args = \null)
      *
      * @param int    $post_id    Post ID.
      * @param string $meta_key   Metadata name.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the same key should not be added.
      *                           Default false.
      * @return int|false Meta ID on success, false on failure.
@@ -131334,6 +131938,11 @@ function delete_post_meta($post_id, $meta_key, $meta_value = '')
      *               False for an invalid `$post_id` (non-numeric, zero, or negative value).
      *               An empty array if a valid but non-existing post ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing post ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers (both integer and float) are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_post_meta($post_id, $key = '', $single = \false)
     {
@@ -135217,8 +135826,6 @@ function wp_save_post_revision($post_id)
      *
      * @since 2.6.0
      *
-     * @global wpdb $wpdb WordPress database abstraction object.
-     *
      * @param int $post_id The post ID.
      * @param int $user_id Optional. The post author ID. Default 0.
      * @return WP_Post|false The autosaved data or false on failure or when no autosave exists.
@@ -136119,7 +136726,7 @@ function wp_style_loader_src($src, $handle)
      *
      * @global bool $concatenate_scripts
      *
-     * @return array
+     * @return string[] Handles of the scripts that were printed.
      */
     function print_head_scripts()
     {
@@ -136132,7 +136739,7 @@ function print_head_scripts()
      * @global WP_Scripts $wp_scripts
      * @global bool       $concatenate_scripts
      *
-     * @return array
+     * @return string[] Handles of the scripts that were printed.
      */
     function print_footer_scripts()
     {
@@ -136158,7 +136765,7 @@ function _print_scripts()
      *
      * @global WP_Scripts $wp_scripts
      *
-     * @return array
+     * @return string[] Handles of the scripts that were printed.
      */
     function wp_print_head_scripts()
     {
@@ -136197,7 +136804,7 @@ function wp_enqueue_scripts()
      *
      * @global bool $concatenate_scripts
      *
-     * @return array
+     * @return string[] Handles of the styles that were printed.
      */
     function print_admin_styles()
     {
@@ -136288,29 +136895,45 @@ function wp_should_load_block_editor_scripts_and_styles()
     {
     }
     /**
-     * Checks whether separate styles should be loaded for core blocks on-render.
+     * Checks whether separate styles should be loaded for core blocks.
      *
-     * When this function returns true, other functions ensure that core blocks
-     * only load their assets on-render, and each block loads its own, individual
-     * assets. Third-party blocks only load their assets when rendered.
+     * When this function returns true, other functions ensure that core blocks use their own separate stylesheets.
+     * When this function returns false, all core blocks will use the single combined 'wp-block-library' stylesheet.
      *
-     * When this function returns false, all core block assets are loaded regardless
-     * of whether they are rendered in a page or not, because they are all part of
-     * the `block-library/style.css` file. Assets for third-party blocks are always
-     * enqueued regardless of whether they are rendered or not.
+     * As a side effect, the return value will by default result in block assets to be loaded on demand, via the
+     * {@see wp_should_load_block_assets_on_demand()} function. This behavior can be separately altered via that function.
      *
      * This only affects front end and not the block editor screens.
      *
+     * @since 5.8.0
+     * @see @see wp_should_load_block_assets_on_demand()
      * @see wp_enqueue_registered_block_scripts_and_styles()
      * @see register_block_style_handle()
      *
-     * @since 5.8.0
-     *
-     * @return bool Whether separate assets will be loaded.
+     * @return bool Whether separate core block assets will be loaded.
      */
     function wp_should_load_separate_core_block_assets()
     {
     }
+    /**
+     * Checks whether block styles should be loaded only on-render.
+     *
+     * When this function returns true, other functions ensure that blocks only load their assets on-render.
+     * When this function returns false, all block assets are loaded regardless of whether they are rendered in a page.
+     *
+     * The default return value depends on the result of {@see wp_should_load_separate_core_block_assets()}, which controls
+     * whether Core block stylesheets should be loaded separately or via a combined 'wp-block-library' stylesheet.
+     *
+     * This only affects front end and not the block editor screens.
+     *
+     * @since 6.8.0
+     * @see wp_should_load_separate_core_block_assets()
+     *
+     * @return bool Whether to load block assets only when they are rendered.
+     */
+    function wp_should_load_block_assets_on_demand()
+    {
+    }
     /**
      * Enqueues registered block scripts and styles, depending on current rendered
      * context (only enqueuing editor scripts while in context of the editor).
@@ -136510,7 +137133,7 @@ function wp_enqueue_stored_styles($options = array())
     /**
      * Enqueues a stylesheet for a specific block.
      *
-     * If the theme has opted-in to separate-styles loading,
+     * If the theme has opted-in to load block styles on demand,
      * then the stylesheet will be enqueued on-render,
      * otherwise when the block inits.
      *
@@ -136542,26 +137165,15 @@ function wp_enqueue_block_style($block_name, $args)
     /**
      * Loads classic theme styles on classic themes in the frontend.
      *
-     * This is needed for backwards compatibility for button blocks specifically.
+     * This is used for backwards compatibility for Button and File blocks specifically.
      *
      * @since 6.1.0
+     * @since 6.2.0 Added File block styles.
+     * @since 6.8.0 Moved stylesheet registration outside of this function.
      */
     function wp_enqueue_classic_theme_styles()
     {
     }
-    /**
-     * Loads classic theme styles on classic themes in the editor.
-     *
-     * This is needed for backwards compatibility for button blocks specifically.
-     *
-     * @since 6.1.0
-     *
-     * @param array $editor_settings The array of editor settings.
-     * @return array A filtered array of editor settings.
-     */
-    function wp_add_editor_classic_theme_styles($editor_settings)
-    {
-    }
     /**
      * Removes leading and trailing _empty_ script tags.
      *
@@ -137078,6 +137690,47 @@ function wp_sitemaps_get_max_urls($object_type)
     function get_sitemap_url($name, $subtype_name = '', $page = 1)
     {
     }
+    /**
+     * Returns the speculation rules configuration.
+     *
+     * @since 6.8.0
+     *
+     * @return array<string, string>|null Associative array with 'mode' and 'eagerness' keys, or null if speculative
+     *                                    loading is disabled.
+     */
+    function wp_get_speculation_rules_configuration() : ?array
+    {
+    }
+    /**
+     * Returns the full speculation rules data based on the configuration.
+     *
+     * Plugins with features that rely on frontend URLs to exclude from prefetching or prerendering should use the
+     * {@see 'wp_speculation_rules_href_exclude_paths'} filter to ensure those URL patterns are excluded.
+     *
+     * Additional speculation rules other than the default rule from WordPress Core can be provided by using the
+     * {@see 'wp_load_speculation_rules'} action and amending the passed WP_Speculation_Rules object.
+     *
+     * @since 6.8.0
+     * @access private
+     *
+     * @return WP_Speculation_Rules|null Object representing the speculation rules to use, or null if speculative loading
+     *                                   is disabled in the current context.
+     */
+    function wp_get_speculation_rules() : ?\WP_Speculation_Rules
+    {
+    }
+    /**
+     * Prints the speculation rules.
+     *
+     * For browsers that do not support speculation rules yet, the `script[type="speculationrules"]` tag will be ignored.
+     *
+     * @since 6.8.0
+     * @access private
+     * @phpstan-return void
+     */
+    function wp_print_speculation_rules() : void
+    {
+    }
     /**
      * Global public interface method to generate styles from a single style object,
      * e.g. the value of a block's attributes.style object or the top level styles in theme.json.
@@ -137557,7 +138210,7 @@ function unregister_taxonomy($taxonomy)
      *     @type string $edit_item                  Default 'Edit Tag'/'Edit Category'.
      *     @type string $view_item                  Default 'View Tag'/'View Category'.
      *     @type string $update_item                Default 'Update Tag'/'Update Category'.
-     *     @type string $add_new_item               Default 'Add New Tag'/'Add New Category'.
+     *     @type string $add_new_item               Default 'Add Tag'/'Add Category'.
      *     @type string $new_item_name              Default 'New Tag Name'/'New Category Name'.
      *     @type string $template_name              Default 'Tag Archives'/'Category Archives'.
      *     @type string $separate_items_with_commas This label is only used for non-hierarchical taxonomies. Default
@@ -137935,7 +138588,13 @@ function get_terms($args = array(), $deprecated = '')
      *
      * @param int    $term_id    Term ID.
      * @param string $meta_key   Metadata name.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the same key should not be added.
      *                           Default false.
      * @return int|false|WP_Error Meta ID on success, false on failure.
@@ -137975,6 +138634,11 @@ function delete_term_meta($term_id, $meta_key, $meta_value = '')
      *               False for an invalid `$term_id` (non-numeric, zero, or negative value).
      *               An empty array if a valid but non-existing term ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing term ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_term_meta($term_id, $key = '', $single = \false)
     {
@@ -139683,7 +140347,7 @@ function wp_enable_block_templates()
      *
      * @since 3.4.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param array $args {
      *     Optional. The search arguments.
@@ -139714,7 +140378,7 @@ function wp_get_themes($args = array())
      *
      * @since 3.4.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param string $stylesheet Optional. Directory name for the theme. Defaults to active theme.
      * @param string $theme_root Optional. Absolute path of the theme root to look in.
@@ -139860,7 +140524,7 @@ function get_template_directory_uri()
      *
      * @since 2.9.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @return array|string An array of theme roots keyed by template/stylesheet
      *                      or a single theme root if all themes have the same root.
@@ -139873,7 +140537,7 @@ function get_theme_roots()
      *
      * @since 2.9.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param string $directory Either the full filesystem path to a theme folder
      *                          or a folder within WP_CONTENT_DIR.
@@ -139888,7 +140552,7 @@ function register_theme_directory($directory)
      *
      * @since 2.9.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param bool $force Optional. Whether to force a new directory scan. Default false.
      * @return array|false Valid themes found on success, false on failure.
@@ -139903,7 +140567,7 @@ function search_theme_directories($force = \false)
      *
      * @since 1.5.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param string $stylesheet_or_template Optional. The stylesheet or template name of the theme.
      *                                       Default is to leverage the main theme root.
@@ -139919,7 +140583,7 @@ function get_theme_root($stylesheet_or_template = '')
      *
      * @since 1.5.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param string $stylesheet_or_template Optional. The stylesheet or template name of the theme.
      *                                       Default is to leverage the main theme root.
@@ -139935,7 +140599,7 @@ function get_theme_root_uri($stylesheet_or_template = '', $theme_root = '')
      *
      * @since 3.1.0
      *
-     * @global array $wp_theme_directories
+     * @global string[] $wp_theme_directories
      *
      * @param string $stylesheet_or_template The stylesheet or template name of the theme.
      * @param bool   $skip_cache             Optional. Whether to skip the cache.
@@ -139962,7 +140626,7 @@ function locale_stylesheet()
      *
      * @since 2.5.0
      *
-     * @global array                $wp_theme_directories
+     * @global string[]             $wp_theme_directories
      * @global WP_Customize_Manager $wp_customize
      * @global array                $sidebars_widgets
      * @global array                $wp_registered_sidebars
@@ -140985,7 +141649,7 @@ function _add_default_theme_supports()
     /**
      * Checks WordPress version against the newest version.
      *
-     * The WordPress version, PHP version, and locale is sent.
+     * The WordPress version, PHP version, and locale is sent to api.wordpress.org.
      *
      * Checks against the WordPress server at api.wordpress.org. Will only check
      * if WordPress isn't installing.
@@ -141009,7 +141673,7 @@ function wp_version_check($extra_stats = array(), $force_check = \false)
      *
      * Despite its name this function does not actually perform any updates, it only checks for available updates.
      *
-     * A list of all plugins installed is sent to WP, along with the site locale.
+     * A list of all plugins installed is sent to api.wordpress.org, along with the site locale.
      *
      * Checks against the WordPress server at api.wordpress.org. Will only check
      * if WordPress isn't installing.
@@ -141028,7 +141692,7 @@ function wp_update_plugins($extra_stats = array())
      *
      * Despite its name this function does not actually perform any updates, it only checks for available updates.
      *
-     * A list of all themes installed is sent to WP, along with the site locale.
+     * A list of all themes installed is sent to api.wordpress.org, along with the site locale.
      *
      * Checks against the WordPress server at api.wordpress.org. Will only check
      * if WordPress isn't installing.
@@ -141068,7 +141732,16 @@ function wp_get_translation_updates()
      *
      * @since 3.3.0
      *
-     * @return array
+     * @return array {
+     *     Fetched update data.
+     *
+     *     @type int[]   $counts       An array of counts for available plugin, theme, and WordPress updates.
+     *     @type string  $update_title Titles of available updates.
+     * }
+     * @phpstan-return array{
+     *   counts: int[],
+     *   update_title: string,
+     * }
      */
     function wp_get_update_data()
     {
@@ -141077,8 +141750,6 @@ function wp_get_update_data()
      * Determines whether core should be updated.
      *
      * @since 2.8.0
-     *
-     * @global string $wp_version The WordPress version string.
      * @phpstan-return void
      */
     function _maybe_update_core()
@@ -141199,7 +141870,7 @@ function wp_signon($credentials = array(), $secure_cookie = '')
      * @param string                $password Password for authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_username_password($user, $username, $password)
+    function wp_authenticate_username_password($user, $username, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -141213,7 +141884,7 @@ function wp_authenticate_username_password($user, $username, $password)
      * @param string                $password Password for authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_email_password($user, $email, $password)
+    function wp_authenticate_email_password($user, $email, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -141228,7 +141899,7 @@ function wp_authenticate_email_password($user, $email, $password)
      * @param string                $password Password. If not empty, cancels the cookie authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_cookie($user, $username, $password)
+    function wp_authenticate_cookie($user, $username, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -141243,7 +141914,7 @@ function wp_authenticate_cookie($user, $username, $password)
      * @return WP_User|WP_Error|null WP_User on success, WP_Error on failure, null if
      *                               null is passed in and this isn't an API request.
      */
-    function wp_authenticate_application_password($input_user, $username, $password)
+    function wp_authenticate_application_password($input_user, $username, #[\SensitiveParameter] $password)
     {
     }
     /**
@@ -141544,7 +142215,13 @@ function is_user_member_of_blog($user_id = 0, $blog_id = 0)
      *
      * @param int    $user_id    User ID.
      * @param string $meta_key   Metadata name.
-     * @param mixed  $meta_value Metadata value. Must be serializable if non-scalar.
+     * @param mixed  $meta_value Metadata value. Arrays and objects are stored as serialized data and
+     *                           will be returned as the same type when retrieved. Other data types will
+     *                           be stored as strings in the database:
+     *                           - false is stored and retrieved as an empty string ('')
+     *                           - true is stored and retrieved as '1'
+     *                           - numbers (both integer and float) are stored and retrieved as strings
+     *                           Must be serializable if non-scalar.
      * @param bool   $unique     Optional. Whether the same key should not be added.
      *                           Default false.
      * @return int|false Meta ID on success, false on failure.
@@ -141591,6 +142268,11 @@ function delete_user_meta($user_id, $meta_key, $meta_value = '')
      *               False for an invalid `$user_id` (non-numeric, zero, or negative value).
      *               An empty array if a valid but non-existing user ID is passed and `$single` is false.
      *               An empty string if a valid but non-existing user ID is passed and `$single` is true.
+     *               Note: Non-serialized values are returned as strings:
+     *               - false values are returned as empty strings ('')
+     *               - true values are returned as '1'
+     *               - numbers (both integer and float) are returned as strings
+     *               Arrays and objects retain their original type.
      */
     function get_user_meta($user_id, $key = '', $single = \false)
     {
@@ -142088,7 +142770,7 @@ function wp_update_user($userdata)
      * @return int|WP_Error The newly created user's ID or a WP_Error object if the user could not
      *                      be created.
      */
-    function wp_create_user($username, $password, $email = '')
+    function wp_create_user($username, #[\SensitiveParameter] $password, $email = '')
     {
     }
     /**
@@ -142148,8 +142830,6 @@ function wp_get_password_hint()
      *
      * @since 4.4.0
      *
-     * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
-     *
      * @param WP_User $user User to retrieve password reset key for.
      * @return string|WP_Error Password reset key on success. WP_Error on error.
      */
@@ -142166,13 +142846,11 @@ function get_password_reset_key($user)
      *
      * @since 3.1.0
      *
-     * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
-     *
-     * @param string $key       Hash to validate sending user's password.
+     * @param string $key       The password reset key.
      * @param string $login     The user login.
      * @return WP_User|WP_Error WP_User object on success, WP_Error object for invalid or expired keys.
      */
-    function check_password_reset_key($key, $login)
+    function check_password_reset_key(#[\SensitiveParameter] $key, $login)
     {
     }
     /**
@@ -142181,14 +142859,13 @@ function check_password_reset_key($key, $login)
      * @since 2.5.0
      * @since 5.7.0 Added `$user_login` parameter.
      *
-     * @global wpdb         $wpdb      WordPress database abstraction object.
-     * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
+     * @global wpdb $wpdb WordPress database abstraction object.
      *
      * @param string $user_login Optional. Username to send a password retrieval email for.
      *                           Defaults to `$_POST['user_login']` if not set.
      * @return true|WP_Error True when finished, WP_Error object on error.
      */
-    function retrieve_password($user_login = \null)
+    function retrieve_password($user_login = '')
     {
     }
     /**
@@ -142199,7 +142876,7 @@ function retrieve_password($user_login = \null)
      * @param WP_User $user     The user
      * @param string  $new_pass New password for the user in plaintext
      */
-    function reset_password($user, $new_pass)
+    function reset_password($user, #[\SensitiveParameter] $new_pass)
     {
     }
     /**
@@ -142479,8 +143156,6 @@ function wp_send_user_request($request_id)
      *
      * @since 4.9.6
      *
-     * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
-     *
      * @param int $request_id Request ID.
      * @return string Confirmation key.
      */
@@ -142492,13 +143167,11 @@ function wp_generate_user_request_key($request_id)
      *
      * @since 4.9.6
      *
-     * @global PasswordHash $wp_hasher Portable PHP password hashing framework instance.
-     *
      * @param string $request_id ID of the request being confirmed.
      * @param string $key        Provided key to validate.
      * @return true|WP_Error True on success, WP_Error on failure.
      */
-    function wp_validate_user_request_key($request_id, $key)
+    function wp_validate_user_request_key($request_id, #[\SensitiveParameter] $key)
     {
     }
     /**
@@ -142598,7 +143271,7 @@ function wp_is_mobile()
     {
     }
     /**
-     * Register a widget
+     * Registers a widget.
      *
      * Registers a WP_Widget widget
      *
@@ -142680,7 +143353,7 @@ function register_sidebars($number = 1, $args = array())
      * on what other plugins and themes are installed.
      *
      * If theme support for 'widgets' has not yet been added when this function is
-     * called, it will be automatically enabled through the use of add_theme_support()
+     * called, it will be automatically enabled through the use of add_theme_support().
      *
      * @since 2.2.0
      * @since 5.6.0 Added the `before_sidebar` and `after_sidebar` arguments.
@@ -142762,7 +143435,7 @@ function is_registered_sidebar($sidebar_id)
     {
     }
     /**
-     * Register an instance of a widget.
+     * Registers an instance of a widget.
      *
      * The default widget option is 'classname' that can be overridden.
      *
@@ -142804,7 +143477,7 @@ function wp_register_sidebar_widget($id, $name, $output_callback, $options = arr
     {
     }
     /**
-     * Retrieve description for widget.
+     * Retrieves description for widget.
      *
      * When registering widgets, the options can also include 'description' that
      * describes the widget for display on the widget administration panel or
@@ -142821,7 +143494,7 @@ function wp_widget_description($id)
     {
     }
     /**
-     * Retrieve description for a sidebar.
+     * Retrieves description for a sidebar.
      *
      * When registering sidebars a 'description' parameter can be included that
      * describes the sidebar for display on the widget administration panel.
@@ -142931,7 +143604,7 @@ function _register_widget_form_callback($id, $name, $form_callback, $options = a
     {
     }
     /**
-     * Remove control callback for widget.
+     * Removes control callback for widget.
      *
      * @since 2.2.0
      *
@@ -142941,7 +143614,7 @@ function wp_unregister_widget_control($id)
     {
     }
     /**
-     * Display dynamic sidebar.
+     * Displays dynamic sidebar.
      *
      * By default this displays the default sidebar or 'sidebar-1'. If your theme specifies the 'id' or
      * 'name' parameter for its registered sidebars you can pass an ID or name as the $index parameter.
@@ -142961,8 +143634,8 @@ function dynamic_sidebar($index = 1)
     /**
      * Determines whether a given widget is displayed on the front end.
      *
-     * Either $callback or $id_base can be used
-     * $id_base is the first argument when extending WP_Widget class
+     * Either $callback or $id_base can be used.
+     * $id_base is the first argument when extending WP_Widget class.
      * Without the optional $widget_id parameter, returns the ID of the first sidebar
      * in which the first instance of the widget with the given callback or $id_base is found.
      * With the $widget_id parameter, returns the ID of the sidebar where
@@ -143025,7 +143698,7 @@ function is_active_sidebar($index)
     {
     }
     /**
-     * Retrieve full list of sidebars and their widget instance IDs.
+     * Retrieves the full list of sidebars and their widget instance IDs.
      *
      * Will upgrade sidebar widget list, if needed. Will also save updated list, if
      * needed.
@@ -143056,7 +143729,7 @@ function wp_get_sidebar($id)
     {
     }
     /**
-     * Set the sidebar widget option to update sidebars.
+     * Sets the sidebar widget option to update sidebars.
      *
      * @since 2.2.0
      * @access private
@@ -143068,7 +143741,7 @@ function wp_set_sidebars_widgets($sidebars_widgets)
     {
     }
     /**
-     * Retrieve default registered sidebars list.
+     * Retrieves default registered sidebars list.
      *
      * @since 2.2.0
      * @access private
@@ -143096,7 +143769,7 @@ function wp_convert_widget_settings($base_name, $option_name, $settings)
     {
     }
     /**
-     * Output an arbitrary widget as a template tag.
+     * Outputs an arbitrary widget as a template tag.
      *
      * @since 2.8.0
      *
@@ -143139,7 +143812,7 @@ function _get_widget_id_base($id)
     {
     }
     /**
-     * Handle sidebars config after theme change
+     * Handles sidebars config after theme change.
      *
      * @access private
      * @since 3.3.0
@@ -143204,7 +143877,7 @@ function _wp_remove_unregistered_widgets($sidebars_widgets, $allowed_widget_ids
     {
     }
     /**
-     * Display the RSS entries in a list.
+     * Displays the RSS entries in a list.
      *
      * @since 2.5.0
      *
@@ -143216,7 +143889,7 @@ function wp_widget_rss_output($rss, $args = array())
     {
     }
     /**
-     * Display RSS widget options form.
+     * Displays RSS widget options form.
      *
      * The options for what fields are displayed for the RSS form are all booleans
      * and are as follows: 'url', 'title', 'items', 'show_summary', 'show_author',
@@ -143234,7 +143907,7 @@ function wp_widget_rss_form($args, $inputs = \null)
     {
     }
     /**
-     * Process RSS feed widget data and optionally retrieve feed items.
+     * Processes RSS feed widget data and optionally retrieve feed items.
      *
      * The feed widget can not have more than 20 items or it will reset back to the
      * default, which is 10.
@@ -143275,9 +143948,9 @@ function wp_setup_widgets_block_editor()
     {
     }
     /**
-     * Whether or not to use the block editor to manage widgets. Defaults to true
-     * unless a theme has removed support for widgets-block-editor or a plugin has
-     * filtered the return value of this function.
+     * Determines whether or not to use the block editor to manage widgets.
+     * Defaults to true unless a theme has removed support for widgets-block-editor
+     * or a plugin has filtered the return value of this function.
      *
      * @since 5.8.0
      *

From 8a25ff3b39f56c2723bcfb1429be1f9937e90a3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Sz=C3=A9pe?= <viktor@szepe.net>
Date: Wed, 16 Apr 2025 14:28:36 +0000
Subject: [PATCH 4/9] Remove parameter attributes

---
 src/Visitor.php     |  4 +++
 wordpress-stubs.php | 66 ++++++++++++++++++++++-----------------------
 2 files changed, 37 insertions(+), 33 deletions(-)

diff --git a/src/Visitor.php b/src/Visitor.php
index ac701538..968a8cd4 100644
--- a/src/Visitor.php
+++ b/src/Visitor.php
@@ -69,6 +69,10 @@ public function enterNode(Node $node)
 
         parent::enterNode($node);
 
+        if ($node instanceof Node\Param && property_exists($node, 'attrGroups')) {
+            $node->attrGroups = [];
+        }
+
         if (! ($node instanceof Function_) && ! ($node instanceof ClassMethod) && ! ($node instanceof Property) && ! ($node instanceof Class_)) {
             return null;
         }
diff --git a/wordpress-stubs.php b/wordpress-stubs.php
index cb6cc4ed..d6cb8f22 100644
--- a/wordpress-stubs.php
+++ b/wordpress-stubs.php
@@ -7338,7 +7338,7 @@ public function cmpr_strlen($a, $b)
          * @param bool   $head
          * @return array
          */
-        public function get_page($url, $username = '', #[\SensitiveParameter] $password = '', $head = \false)
+        public function get_page($url, $username = '', $password = '', $head = \false)
         {
         }
         /**
@@ -30023,7 +30023,7 @@ protected static function set_user_application_passwords($user_id, $passwords)
          * @param string $raw_password The raw application password.
          * @return string The chunked password.
          */
-        public static function chunk_password(#[\SensitiveParameter] $raw_password)
+        public static function chunk_password($raw_password)
         {
         }
         /**
@@ -30034,7 +30034,7 @@ public static function chunk_password(#[\SensitiveParameter] $raw_password)
          * @param string $password Plaintext password.
          * @return string Hashed password.
          */
-        public static function hash_password(#[\SensitiveParameter] string $password) : string
+        public static function hash_password(string $password) : string
         {
         }
         /**
@@ -30046,7 +30046,7 @@ public static function hash_password(#[\SensitiveParameter] string $password) :
          * @param string $hash     Hash of the password to check against.
          * @return bool Whether the password matches the hashed password.
          */
-        public static function check_password(#[\SensitiveParameter] string $password, string $hash) : bool
+        public static function check_password(string $password, string $hash) : bool
         {
         }
     }
@@ -55576,7 +55576,7 @@ public function addTwoNumbers($args)
          * @param string $password User's password.
          * @return WP_User|false WP_User object if authentication passed, false otherwise.
          */
-        public function login($username, #[\SensitiveParameter] $password)
+        public function login($username, $password)
         {
         }
         /**
@@ -55590,7 +55590,7 @@ public function login($username, #[\SensitiveParameter] $password)
          * @param string $password User's password.
          * @return bool Whether authentication passed.
          */
-        public function login_pass_ok($username, #[\SensitiveParameter] $password)
+        public function login_pass_ok($username, $password)
         {
         }
         /**
@@ -58602,7 +58602,7 @@ class wpdb
          * @param string $dbhost     Database host.
          * @phpstan-return void
          */
-        public function __construct($dbuser, #[\SensitiveParameter] $dbpassword, $dbname, $dbhost)
+        public function __construct($dbuser, $dbpassword, $dbname, $dbhost)
         {
         }
         /**
@@ -77307,7 +77307,7 @@ public function check_username($value, $request, $param)
          * @param string          $param   The parameter name.
          * @return string|WP_Error The sanitized password, if valid, otherwise an error.
          */
-        public function check_user_password(#[\SensitiveParameter] $value, $request, $param)
+        public function check_user_password($value, $request, $param)
         {
         }
         /**
@@ -91380,7 +91380,7 @@ function wp_get_auto_update_message()
      *   password_message: string,
      * }
      */
-    function wp_install($blog_title, $user_name, $user_email, $is_public, $deprecated = '', #[\SensitiveParameter] $user_password = '', $language = '')
+    function wp_install($blog_title, $user_name, $user_email, $is_public, $deprecated = '', $user_password = '', $language = '')
     {
     }
     /**
@@ -91428,7 +91428,7 @@ function wp_install_maybe_enable_pretty_permalinks()
      * @param string $password   Administrator's password. Note that a placeholder message is
      *                           usually passed instead of the actual password.
      */
-    function wp_new_blog_notification($blog_title, $blog_url, $user_id, #[\SensitiveParameter] $password)
+    function wp_new_blog_notification($blog_title, $blog_url, $user_id, $password)
     {
     }
     /**
@@ -114231,7 +114231,7 @@ function wp_is_heic_image_mime_type($mime_type)
      * @param string $message The message to hash.
      * @return string The hash of the message.
      */
-    function wp_fast_hash(#[\SensitiveParameter] string $message) : string
+    function wp_fast_hash(string $message) : string
     {
     }
     /**
@@ -114249,7 +114249,7 @@ function wp_fast_hash(#[\SensitiveParameter] string $message) : string
      * @param string $hash    Hash of the message to check against.
      * @return bool Whether the message matches the hashed message.
      */
-    function wp_verify_fast_hash(#[\SensitiveParameter] string $message, string $hash) : bool
+    function wp_verify_fast_hash(string $message, string $hash) : bool
     {
     }
     /**
@@ -125323,7 +125323,7 @@ function wpmu_signup_user($user, $user_email, $meta = array())
      * @param array  $meta       Optional. Signup meta data. By default, contains the requested privacy setting and lang_id.
      * @return bool
      */
-    function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $user_email, #[\SensitiveParameter] $key, $meta = array())
+    function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $user_email, $key, $meta = array())
     {
     }
     /**
@@ -125348,7 +125348,7 @@ function wpmu_signup_blog_notification($domain, $path, $title, $user_login, $use
      * @param array  $meta       Optional. Signup meta data. Default empty array.
      * @return bool
      */
-    function wpmu_signup_user_notification($user_login, $user_email, #[\SensitiveParameter] $key, $meta = array())
+    function wpmu_signup_user_notification($user_login, $user_email, $key, $meta = array())
     {
     }
     /**
@@ -125366,7 +125366,7 @@ function wpmu_signup_user_notification($user_login, $user_email, #[\SensitivePar
      * @param string $key The activation key provided to the user.
      * @return array|WP_Error An array containing information about the activated user and/or blog.
      */
-    function wpmu_activate_signup(#[\SensitiveParameter] $key)
+    function wpmu_activate_signup($key)
     {
     }
     /**
@@ -125398,7 +125398,7 @@ function wp_delete_signup_on_user_delete($id, $reassign, $user)
      * @param string $email     The new user's email address.
      * @return int|false Returns false on failure, or int $user_id on success.
      */
-    function wpmu_create_user($user_name, #[\SensitiveParameter] $password, $email)
+    function wpmu_create_user($user_name, $password, $email)
     {
     }
     /**
@@ -125498,7 +125498,7 @@ function domain_exists($domain, $path, $network_id = 1)
      * @param array  $meta     Optional. Signup meta data. By default, contains the requested privacy setting and lang_id.
      * @return bool Whether the email notification was sent.
      */
-    function wpmu_welcome_notification($blog_id, $user_id, #[\SensitiveParameter] $password, $title, $meta = array())
+    function wpmu_welcome_notification($blog_id, $user_id, $password, $title, $meta = array())
     {
     }
     /**
@@ -125532,7 +125532,7 @@ function wpmu_new_site_admin_notification($site_id, $user_id)
      * @param array  $meta     Optional. Signup meta data. Default empty array.
      * @return bool
      */
-    function wpmu_welcome_user_notification($user_id, #[\SensitiveParameter] $password, $meta = array())
+    function wpmu_welcome_user_notification($user_id, $password, $meta = array())
     {
     }
     /**
@@ -125721,7 +125721,7 @@ function add_existing_user_to_blog($details = \false)
      * @param string $password User password. Ignored.
      * @param array  $meta     Signup meta data.
      */
-    function add_new_user_to_blog($user_id, #[\SensitiveParameter] $password, $meta)
+    function add_new_user_to_blog($user_id, $password, $meta)
     {
     }
     /**
@@ -128214,7 +128214,7 @@ function get_user_by_email($email)
      * @param string $siteurl Optional. Will be used instead of SITECOOKIEPATH if set
      * @param bool $remember Optional. Remember that the user is logged in
      */
-    function wp_setcookie($username, #[\SensitiveParameter] $password = '', $already_md5 = \false, $home = '', $siteurl = '', $remember = \false)
+    function wp_setcookie($username, $password = '', $already_md5 = \false, $home = '', $siteurl = '', $remember = \false)
     {
     }
     /**
@@ -128262,7 +128262,7 @@ function wp_get_cookie_login()
      * @param string $deprecated Not used
      * @return bool True on successful check, false on login failure.
      */
-    function wp_login($username, #[\SensitiveParameter] $password, $deprecated = '')
+    function wp_login($username, $password, $deprecated = '')
     {
     }
     /**
@@ -128383,7 +128383,7 @@ function wp_mail($to, $subject, $message, $headers = '', $attachments = array())
      * @return WP_User|WP_Error WP_User object if the credentials are valid,
      *                          otherwise WP_Error.
      */
-    function wp_authenticate($username, #[\SensitiveParameter] $password)
+    function wp_authenticate($username, $password)
     {
     }
     /**
@@ -128847,7 +128847,7 @@ function wp_hash($data, $scheme = 'auth', $algo = 'md5')
      * @param string $password Plain text user password to hash.
      * @return string The hash string of the password.
      */
-    function wp_hash_password(#[\SensitiveParameter] $password)
+    function wp_hash_password($password)
     {
     }
     /**
@@ -128872,7 +128872,7 @@ function wp_hash_password(#[\SensitiveParameter] $password)
      * @param string|int $user_id  Optional. ID of a user associated with the password.
      * @return bool False, if the $password does not match the hashed password.
      */
-    function wp_check_password(#[\SensitiveParameter] $password, $hash, $user_id = '')
+    function wp_check_password($password, $hash, $user_id = '')
     {
     }
     /**
@@ -128952,7 +128952,7 @@ function wp_rand($min = \null, $max = \null)
      * @param string $password The plaintext new user password.
      * @param int    $user_id  User ID.
      */
-    function wp_set_password(#[\SensitiveParameter] $password, $user_id)
+    function wp_set_password($password, $user_id)
     {
     }
     /**
@@ -141870,7 +141870,7 @@ function wp_signon($credentials = array(), $secure_cookie = '')
      * @param string                $password Password for authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_username_password($user, $username, #[\SensitiveParameter] $password)
+    function wp_authenticate_username_password($user, $username, $password)
     {
     }
     /**
@@ -141884,7 +141884,7 @@ function wp_authenticate_username_password($user, $username, #[\SensitiveParamet
      * @param string                $password Password for authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_email_password($user, $email, #[\SensitiveParameter] $password)
+    function wp_authenticate_email_password($user, $email, $password)
     {
     }
     /**
@@ -141899,7 +141899,7 @@ function wp_authenticate_email_password($user, $email, #[\SensitiveParameter] $p
      * @param string                $password Password. If not empty, cancels the cookie authentication.
      * @return WP_User|WP_Error WP_User on success, WP_Error on failure.
      */
-    function wp_authenticate_cookie($user, $username, #[\SensitiveParameter] $password)
+    function wp_authenticate_cookie($user, $username, $password)
     {
     }
     /**
@@ -141914,7 +141914,7 @@ function wp_authenticate_cookie($user, $username, #[\SensitiveParameter] $passwo
      * @return WP_User|WP_Error|null WP_User on success, WP_Error on failure, null if
      *                               null is passed in and this isn't an API request.
      */
-    function wp_authenticate_application_password($input_user, $username, #[\SensitiveParameter] $password)
+    function wp_authenticate_application_password($input_user, $username, $password)
     {
     }
     /**
@@ -142770,7 +142770,7 @@ function wp_update_user($userdata)
      * @return int|WP_Error The newly created user's ID or a WP_Error object if the user could not
      *                      be created.
      */
-    function wp_create_user($username, #[\SensitiveParameter] $password, $email = '')
+    function wp_create_user($username, $password, $email = '')
     {
     }
     /**
@@ -142850,7 +142850,7 @@ function get_password_reset_key($user)
      * @param string $login     The user login.
      * @return WP_User|WP_Error WP_User object on success, WP_Error object for invalid or expired keys.
      */
-    function check_password_reset_key(#[\SensitiveParameter] $key, $login)
+    function check_password_reset_key($key, $login)
     {
     }
     /**
@@ -142876,7 +142876,7 @@ function retrieve_password($user_login = '')
      * @param WP_User $user     The user
      * @param string  $new_pass New password for the user in plaintext
      */
-    function reset_password($user, #[\SensitiveParameter] $new_pass)
+    function reset_password($user, $new_pass)
     {
     }
     /**
@@ -143171,7 +143171,7 @@ function wp_generate_user_request_key($request_id)
      * @param string $key        Provided key to validate.
      * @return true|WP_Error True on success, WP_Error on failure.
      */
-    function wp_validate_user_request_key($request_id, #[\SensitiveParameter] $key)
+    function wp_validate_user_request_key($request_id, $key)
     {
     }
     /**

From b34b3d4ae7036afcef31c0da6f2848698437f79e Mon Sep 17 00:00:00 2001
From: IanDelMar <42134098+IanDelMar@users.noreply.github.com>
Date: Thu, 17 Apr 2025 00:48:28 +0200
Subject: [PATCH 5/9] Update for get_calendar() function signature change
 (#279)

The `get_calendar()` function has been updated to accept a single
array parameter `$args`, replacing the previous boolean parameters
`$initial` and `$display`.
---
 functionMap.php               | 2 +-
 tests/data/echo_parameter.php | 6 +++---
 wordpress-stubs.php           | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/functionMap.php b/functionMap.php
index 8fd0de88..0648467e 100644
--- a/functionMap.php
+++ b/functionMap.php
@@ -157,7 +157,7 @@
     'wp_set_comment_status' => ['($wp_error is false ? bool : true|\WP_Error)'],
     'comment_class' => ['($display is true ? void : string)'],
     'edit_term_link' => ['($display is true ? void : string|void)'],
-    'get_calendar' => ['($display is true ? void : string)'],
+    'get_calendar' => ['($args is array{display: false}&array ? string : void)'],
     'next_posts' => ['($display is true ? void : string)'],
     'post_type_archive_title' => ['($display is true ? void : string|void)'],
     'previous_posts' => ['($display is true ? void : string)'],
diff --git a/tests/data/echo_parameter.php b/tests/data/echo_parameter.php
index 881f2fc6..5dc1238e 100644
--- a/tests/data/echo_parameter.php
+++ b/tests/data/echo_parameter.php
@@ -47,7 +47,7 @@
 $value = true;
 assertType('null', comment_class('', null, null, $value));
 assertType('null', edit_term_link('', '', '', null, $value));
-assertType('null', get_calendar(true, $value));
+assertType('null', get_calendar(['initial' => true, 'display' => $value]));
 assertType('null', next_posts(0, $value));
 assertType('null', post_type_archive_title('', $value));
 assertType('null', previous_posts($value));
@@ -67,7 +67,7 @@
 $value = false;
 assertType('string', comment_class('', null, null, $value));
 assertType('string|null', edit_term_link('', '', '', null, $value));
-assertType('string', get_calendar(true, $value));
+assertType('string', get_calendar(['initial' => true, 'display' => $value]));
 assertType('string', next_posts(0, $value));
 assertType('string|null', post_type_archive_title('', $value));
 assertType('string', previous_posts(false));
@@ -87,7 +87,7 @@
 $value = Faker::bool();
 assertType('string|null', comment_class('', null, null, $value));
 assertType('string|null', edit_term_link('', '', '', null, $value));
-assertType('string|null', get_calendar(true, $value));
+assertType('string|null', get_calendar(['initial' => true, 'display' => $value]));
 assertType('string|null', next_posts(0, $value));
 assertType('string|null', post_type_archive_title('', $value));
 assertType('string|null', previous_posts($value));
diff --git a/wordpress-stubs.php b/wordpress-stubs.php
index d6cb8f22..2a8837d6 100644
--- a/wordpress-stubs.php
+++ b/wordpress-stubs.php
@@ -115464,7 +115464,7 @@ function calendar_week_mod($num)
      *   display?: bool,
      *   post_type?: string,
      * } $args
-     * @phpstan-return ($display is true ? void : string)
+     * @phpstan-return ($args is array{display: false}&array ? string : void)
      */
     function get_calendar($args = array())
     {

From 31f32a22de875102b48789508ed2d523f0785af6 Mon Sep 17 00:00:00 2001
From: IanDelMar <42134098+IanDelMar@users.noreply.github.com>
Date: Thu, 17 Apr 2025 00:49:35 +0200
Subject: [PATCH 6/9] Add conflict for phpdocumentor/reflection-docblock v5.6.1
 in composer.json (#278)

See https://github.com/phpDocumentor/ReflectionDocBlock/issues/408
---
 composer.json | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/composer.json b/composer.json
index 8cd42f5d..8597b869 100644
--- a/composer.json
+++ b/composer.json
@@ -19,6 +19,9 @@
         "szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset": "^1.1.1",
         "wp-coding-standards/wpcs": "3.1.0 as 2.3.0"
     },
+    "conflict": {
+        "phpdocumentor/reflection-docblock": "5.6.1"
+    },
     "suggest": {
         "paragonie/sodium_compat": "Pure PHP implementation of libsodium",
         "symfony/polyfill-php80": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions",

From eb59a1040f4ab12813d378fd78ff0fdcce262dd0 Mon Sep 17 00:00:00 2001
From: IanDelMar <42134098+IanDelMar@users.noreply.github.com>
Date: Thu, 17 Apr 2025 00:50:24 +0200
Subject: [PATCH 7/9] Leverage node mutability in getCleanCommentsNode (#280)

---
 src/Visitor.php | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/Visitor.php b/src/Visitor.php
index 968a8cd4..f4c608a2 100644
--- a/src/Visitor.php
+++ b/src/Visitor.php
@@ -77,7 +77,7 @@ public function enterNode(Node $node)
             return null;
         }
 
-        $node = $this->getCleanCommentsNode($node);
+        $this->cleanComments($node);
 
         $docComment = $node->getDocComment();
 
@@ -879,10 +879,10 @@ static function (Node $node): bool {
         return null;
     }
 
-    private function getCleanCommentsNode(Node $node): Node
+    private function cleanComments(Node $node): void
     {
         if (count($node->getComments()) === 0) {
-            return $node;
+            return;
         }
 
         $comments = [];
@@ -908,7 +908,5 @@ private function getCleanCommentsNode(Node $node): Node
         }
 
         $node->setAttribute('comments', $comments);
-
-        return $node;
     }
 }

From 18da586e680f783a6923ecc37e3aba5ae5faab90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Sz=C3=A9pe?= <viktor@szepe.net>
Date: Thu, 17 Apr 2025 00:52:08 +0200
Subject: [PATCH 8/9] Fix Visitor.php

---
 src/Visitor.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Visitor.php b/src/Visitor.php
index f4c608a2..3a07bb10 100644
--- a/src/Visitor.php
+++ b/src/Visitor.php
@@ -69,7 +69,7 @@ public function enterNode(Node $node)
 
         parent::enterNode($node);
 
-        if ($node instanceof Node\Param && property_exists($node, 'attrGroups')) {
+        if ($node instanceof Node\Param) {
             $node->attrGroups = [];
         }
 

From 1824db4d1d00d32c0119175d2369d9425dbc4953 Mon Sep 17 00:00:00 2001
From: Pascal Birchler <pascalb@google.com>
Date: Thu, 17 Apr 2025 17:13:53 +0200
Subject: [PATCH 9/9] Fix reported PHPCS errors (#281)

---
 finder.php                  |  4 +++-
 src/Visitor.php             | 15 +++++++++------
 tests/TypeInferenceTest.php |  4 +++-
 visitor.php                 |  4 +++-
 4 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/finder.php b/finder.php
index 0eeebc61..111886b3 100644
--- a/finder.php
+++ b/finder.php
@@ -2,9 +2,11 @@
 
 declare(strict_types=1);
 
+use StubsGenerator\Finder;
+
 // phpcs:disable Squiz.PHP.CommentedOutCode
 
-return \StubsGenerator\Finder::create()
+return Finder::create()
     ->in('source/wordpress')
     // Shim for load-styles.php and load-scripts.php.
     ->notPath('wp-admin/includes/noop.php')
diff --git a/src/Visitor.php b/src/Visitor.php
index 3a07bb10..386000e9 100644
--- a/src/Visitor.php
+++ b/src/Visitor.php
@@ -30,6 +30,9 @@
 use PhpParser\Node\Stmt\Property;
 use PhpParser\Node\Stmt\Return_ as Stmt_Return;
 use StubsGenerator\NodeVisitor;
+use phpDocumentor\Reflection\DocBlockFactoryInterface;
+use phpDocumentor\Reflection\DocBlockFactory;
+use function assert;
 
 // phpcs:disable SlevomatCodingStandard.Functions.FunctionLength.FunctionLength,NeutronStandard.Functions.TypeHint.NoReturnType
 
@@ -40,7 +43,7 @@ class Visitor extends NodeVisitor
      */
     private const WP_INDENT_SIZE = 4;
 
-    private \phpDocumentor\Reflection\DocBlockFactoryInterface $docBlockFactory;
+    private DocBlockFactoryInterface $docBlockFactory;
 
     /** @var array<string,array<int|string,string>> */
     private array $functionMap;
@@ -51,11 +54,11 @@ class Visitor extends NodeVisitor
     /** @var array<string, list<string>> */
     private array $additionalTagStrings = [];
 
-    private \PhpParser\NodeFinder $nodeFinder;
+    private NodeFinder $nodeFinder;
 
     public function __construct()
     {
-        $this->docBlockFactory = \phpDocumentor\Reflection\DocBlockFactory::createInstance();
+        $this->docBlockFactory = DocBlockFactory::createInstance();
         $this->nodeFinder = new NodeFinder();
         $this->functionMap = require sprintf('%s/functionMap.php', dirname(__DIR__));
     }
@@ -124,15 +127,15 @@ private function getSymbolName(Node $node): string
             $name = $node->props[0]->name->name;
         }
 
-        \assert(isset($name), 'Node does not have a name');
+        assert(isset($name), 'Node does not have a name');
 
         if ($node instanceof Function_ || $node instanceof Class_) {
             return $name;
         }
 
         $parent = $this->stack[count($this->stack) - 2];
-        \assert($parent instanceof \PhpParser\Node\Stmt\ClassLike);
-        \assert($parent->name instanceof \PhpParser\Node\Identifier);
+        assert($parent instanceof ClassLike);
+        assert($parent->name instanceof Identifier);
 
         return sprintf(
             '%1$s::%2$s%3$s',
diff --git a/tests/TypeInferenceTest.php b/tests/TypeInferenceTest.php
index 42067a55..1b82760a 100644
--- a/tests/TypeInferenceTest.php
+++ b/tests/TypeInferenceTest.php
@@ -4,7 +4,9 @@
 
 namespace PhpStubs\WordPress\Core\Tests;
 
-class TypeInferenceTest extends \PHPStan\Testing\TypeInferenceTestCase
+use PHPStan\Testing\TypeInferenceTestCase;
+
+class TypeInferenceTest extends TypeInferenceTestCase
 {
     /** @return iterable<mixed> */
     public function dataFileAsserts(): iterable
diff --git a/visitor.php b/visitor.php
index 8e41764a..355ef144 100644
--- a/visitor.php
+++ b/visitor.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+use PhpStubs\WordPress\Core\Visitor;
+
 require sprintf('%s/vendor/autoload.php', __DIR__);
 
-return new PhpStubs\WordPress\Core\Visitor();
+return new Visitor();