Docs: Address review feedback on callback types.

Allow null and an empty string for the $admin_header_callback parameter of Custom_Image_Header::__construct(), since the Customizer and the theme-support defaults pass them. Also type the admin page callbacks as callable(): mixed, matching Custom_Image_Header and Custom_Background, since the page hook is fired without arguments.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015BuoHZQvJMvPEYp4Sfjgvd

Author: claude

src/wp-admin/includes/class-custom-image-header.php

@@ -59,6 +59,7 @@ class Custom_Image_Header {
 	 * @param callable $admin_image_div_callback Optional. Custom image div output callback.
 	 *                                           Default empty string.
 	 *
+	 * @phpstan-param ''|(callable(): mixed)|null $admin_header_callback
 	 * @phpstan-param ''|(callable(): mixed)|null $admin_image_div_callback
 	 */
 	public function __construct( $admin_header_callback, $admin_image_div_callback = '' ) {

src/wp-admin/includes/plugin.php

@@ -1399,7 +1399,7 @@ function uninstall_plugin( $plugin ) {
  * @param int|float $position   Optional. The position in the menu order this item should appear.
  * @return string The resulting page's hook_suffix.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $icon_url = '', $position = null ) {
 	global $menu, $admin_page_hooks, $_registered_pages, $_parent_pages;
@@ -1496,7 +1496,7 @@ function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $call
  * @param int|float $position    Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	global $submenu, $menu, $_wp_real_parent_file, $_wp_submenu_nopriv,
@@ -1611,7 +1611,7 @@ function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability,
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_management_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'tools.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1637,7 +1637,7 @@ function add_management_page( $page_title, $menu_title, $capability, $menu_slug,
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'options-general.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1663,7 +1663,7 @@ function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $c
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1689,7 +1689,7 @@ function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_plugins_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'plugins.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1715,7 +1715,7 @@ function add_plugins_page( $page_title, $menu_title, $capability, $menu_slug, $c
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	if ( current_user_can( 'edit_users' ) ) {
@@ -1746,7 +1746,7 @@ function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'index.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1772,7 +1772,7 @@ function add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug,
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'edit.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1798,7 +1798,7 @@ function add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'upload.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1824,7 +1824,7 @@ function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1850,7 +1850,7 @@ function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
@@ -1876,7 +1876,7 @@ function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $cal
  * @param int      $position   Optional. The position in the menu order this item should appear.
  * @return string|false The resulting page's hook_suffix, or false if the user does not have the capability required.
  *
- * @phpstan-param ''|callable|null $callback
+ * @phpstan-param ''|(callable(): mixed)|null $callback
  */
 function add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
 	return add_submenu_page( 'edit-comments.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );