Changeset 62458 for trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php

Timestamp:

06/04/2026 09:10:15 AM (11 days ago)

Author:

dmsnell

Message:

Docs: Update parameter types to allow null for interactivity api functions

When [58327] added annotations for a nullable-typed argument in the Interactivity API, the PHPDoc comment wasn’t also updated. This patch adds the corresponding documentation update.

Prepared ahead of WCEU 2026, merged as part of Contributor Day.

Developed in: ​https://github.com/WordPress/wordpress-develop/pull/11470
Discussed in: https://core.trac.wordpress.org/ticket/65404

Follow-up to [58327].

Props audrasjb, mukesh27, soean.
Fixes #65404.

File:

• trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php (modified) (2 diffs)

trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php

@@ -139 +139 @@
      * @since 6.6.0 The `$store_namespace` param is optional.
      *
-     * @param string $store_namespace Optional. The unique store namespace identifier.
-     * @param array  $state           Optional. The array that will be merged with the existing state for the specified
+     * @param string|null $store_namespace Optional. The unique store namespace identifier.
+     * @param array|null  $state           Optional. The array that will be merged with the existing state for the specified
      *                                store namespace.
      * @return array The current state for the specified store namespace. This will be the updated state if a $state
@@ -312 +312 @@
      * @since 6.6.0
      *
-     * @param string $store_namespace Optional. The unique store namespace identifier.
+     * @param string|null $store_namespace Optional. The unique store namespace identifier.
      */
     public function get_context( ?string $store_namespace = null ): array {