Trac 64389: Refine hoisted stylesheet ordering in classic themes

src/wp-includes/plugin.php

@@ -271,17 +271,23 @@ function apply_filters_ref_array( $hook_name, $args ) {
  *
  * @global WP_Hook[] $wp_filter Stores all of the filters and actions.
  *
- * @param string                      $hook_name The name of the filter hook.
- * @param callable|string|array|false $callback  Optional. The callback to check for.
- *                                               This function can be called unconditionally to speculatively check
- *                                               a callback that may or may not exist. Default false.
- * @param int|false                   $priority  Optional. The specific priority at which to check for the callback.
- *                                               Default false.
+ * @param string         $hook_name The name of the filter hook.
+ * @param callable|false $callback  Optional. The callback to check for.
+ *                                  This function can be called unconditionally to speculatively check
+ *                                  a callback that may or may not exist. Default false.
+ * @param int|false      $priority  Optional. The specific priority at which to check for the callback.
+ *                                  Default false.
  * @return bool|int If `$callback` is omitted, returns boolean for whether the hook has
  *                  anything registered. When checking a specific function, the priority
  *                  of that hook is returned, or false if the function is not attached.
  *                  If `$callback` and `$priority` are both provided, a boolean is returned
  *                  for whether the specific function is registered at that priority.
+ *
+ * @phpstan-return (
+ *     $callback is false ? bool : (
+ *         $priority is false ? int|false : bool
+ *     )
+ * )
  */
 function has_filter( $hook_name, $callback = false, $priority = false ) {
 	global $wp_filter;
@@ -583,17 +589,23 @@ function do_action_ref_array( $hook_name, $args ) {
  *
  * @see has_filter() This function is an alias of has_filter().
  *
- * @param string                      $hook_name The name of the action hook.
- * @param callable|string|array|false $callback  Optional. The callback to check for.
- *                                               This function can be called unconditionally to speculatively check
- *                                               a callback that may or may not exist. Default false.
- * @param int|false                   $priority  Optional. The specific priority at which to check for the callback.
- *                                               Default false.
+ * @param string         $hook_name The name of the action hook.
+ * @param callable|false $callback  Optional. The callback to check for.
+ *                                  This function can be called unconditionally to speculatively check
+ *                                  a callback that may or may not exist. Default false.
+ * @param int|false      $priority  Optional. The specific priority at which to check for the callback.
+ *                                  Default false.
  * @return bool|int If `$callback` is omitted, returns boolean for whether the hook has
  *                  anything registered. When checking a specific function, the priority
  *                  of that hook is returned, or false if the function is not attached.
  *                  If `$callback` and `$priority` are both provided, a boolean is returned
  *                  for whether the specific function is registered at that priority.
+ *
+ * @phpstan-return (
+ *     $callback is false ? bool : (
+ *         $priority is false ? int|false : bool
+ *     )
+ * )
  */
 function has_action( $hook_name, $callback = false, $priority = false ) {
 	return has_filter( $hook_name, $callback, $priority );