Changeset 61270 for trunk/src/wp-includes/class-wp-theme-json-resolver.php

Timestamp:

11/19/2025 06:15:54 AM (7 months ago)

Author:

westonruter

Message:

Docs: Add missing descriptions and fix types for some @return tags.

Props huzaifaalmesbah, sabernhardt, westonruter.
See #64224.
Fixes #64262.

File:

• trunk/src/wp-includes/class-wp-theme-json-resolver.php (modified) (4 diffs)

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

@@ -682 +682 @@
      * @since 5.9.0
      *
-     * @return integer|null
+     * @return int|null ID for a post of type `wp_global_styles`, or null if not available.
      */
     public static function get_user_global_styles_post_id() {
@@ -705 +705 @@
      * @deprecated 6.2.0 Use wp_theme_has_theme_json() instead.
      *
-     * @return bool
+     * @return bool Whether the active theme has a theme.json file.
      */
     public static function theme_has_support() {
@@ -781 +781 @@
      * @param array  $variation Theme.json shaped style variation object.
      * @param string $scope     Scope to check e.g. theme, block etc.
-     * @return boolean
+     * @return bool Whether the supplied style variation matches the provided scope.
      */
     private static function style_variation_has_scope( $variation, $scope ) {
@@ -806 +806 @@
      *
      * @param string $scope The scope or type of style variation to retrieve e.g. theme, block etc.
-     * @return array
+     * @return array The style variations defined by the theme.
      */
     public static function get_style_variations( $scope = 'theme' ) {