Update PHPStan level to 7

bin/phpstan/filtered-functions.stub

@@ -29,3 +29,57 @@
  * }|null Attachment metadata. Null on failure.
  */
 function wp_get_attachment_metadata( int $attachment_id = 0, bool $unfiltered = false ): ?array {}
+
+/**
+ * Retrieves the file type from the file name.
+ *
+ * You can optionally define the mime array, if needed.
+ *
+ * @since 2.0.4
+ *
+ * @param string                     $filename File name or path.
+ * @param array<string, string>|null $mimes    Optional. Array of allowed mime types keyed by their file extension regex.
+ *                                             Defaults to the result of get_allowed_mime_types().
+ * @return array{ ext: string|false, type: string|false }
+ */
+function wp_check_filetype( $filename, $mimes = null ) {}
+
+/**
+ * Updates the attached file and image meta data when the original image was edited.
+ *
+ * @since 5.3.0
+ * @since 6.0.0 The `$filesize` value was added to the returned array.
+ * @access private
+ *
+ * @phpstan-param array{
+ *     width: int,
+ *     height: int,
+ *     path: string
+ * } $saved_data
+ * @phpstan-param array{
+ *     width: int,
+ *     height: int,
+ *     file: string,
+ *     sizes: array<string, array{ file: string, width: int, height: int, 'mime-type': string }>,
+ *     image_meta: array<string, mixed>,
+ *     filesize: int
+ * } $image_meta
+ * @phpstan-return array{
+ *     width: int,
+ *     height: int,
+ *     file: string,
+ *     sizes: array<string, array{ file: string, width: int, height: int, 'mime-type': string, sources?: array<string, array{ file: string, filesize: int }> }>,
+ *     image_meta: array<string, mixed>,
+ *     filesize: int,
+ *     sources?: array<string, array{ file: string, filesize: int }>,
+ *     has_transparency?: bool,
+ *     dominant_color?: string
+ * }
+ *
+ * @param array  $saved_data    The data returned from WP_Image_Editor after successfully saving an image.
+ * @param string $original_file Path to the original file.
+ * @param array  $image_meta    The image meta data.
+ * @param int    $attachment_id The attachment post ID.
+ * @return array The updated image meta data.
+ */
+function _wp_image_meta_replace_original( $saved_data, $original_file, $image_meta, $attachment_id ): array {}

includes/admin/plugins.php

@@ -60,6 +60,11 @@ function perflab_query_plugin_info( string $plugin_slug ) {
 
 	set_transient( 'perflab_plugin_info_' . $plugin_slug, $plugin, HOUR_IN_SECONDS );
 
+	/**
+	 * Validated (mostly) plugin data.
+	 *
+	 * @var array{name: string, slug: string, short_description: string, requires: string|false, requires_php: string|false, requires_plugins: string[], download_link: string, version: string} $plugin
+	 */
 	return $plugin;
 }
 

includes/server-timing/class-perflab-server-timing.php

@@ -25,7 +25,10 @@ class Perflab_Server_Timing {
 	 * Map of registered metric slugs and their registered data.
 	 *
 	 * @since 1.8.0
-	 * @var array<string, array{measure_callback: callable, access_cap: string}>
+	 * @var array<string, array{
+	 *          measure_callback: callable( Perflab_Server_Timing_Metric ): void,
+	 *          access_cap: string
+	 *      }>
 	 */
 	private $registered_metrics_data = array();
 
@@ -36,8 +39,13 @@ class Perflab_Server_Timing {
 	 *
 	 * @since 1.8.0
 	 *
-	 * @param string                                                $metric_slug The metric slug.
-	 * @param array{measure_callback: callable, access_cap: string} $args        {
+	 * @phpstan-param array{
+	 *     measure_callback: callable( Perflab_Server_Timing_Metric ): void,
+	 *     access_cap: string
+	 * } $args
+	 *
+	 * @param string                         $metric_slug The metric slug.
+	 * @param array<string, callable|string> $args        {
 	 *     Arguments for the metric.
 	 *
 	 *     @type callable $measure_callback The callback that initiates calculating the metric value. It will receive
@@ -94,6 +102,11 @@ public function register_metric( string $metric_slug, array $args ): void {
 			);
 			return;
 		}
+		/**
+		 * Validated args.
+		 *
+		 * @var array{measure_callback: callable( Perflab_Server_Timing_Metric ): void, access_cap: string} $args
+		 */
 
 		$this->registered_metrics[ $metric_slug ]      = new Perflab_Server_Timing_Metric( $metric_slug );
 		$this->registered_metrics_data[ $metric_slug ] = $args;

includes/server-timing/defaults.php

@@ -148,7 +148,7 @@ static function ( $passthrough = null ) {
 			perflab_server_timing_register_metric(
 				'template',
 				array(
-					'measure_callback' => static function ( $metric ): void {
+					'measure_callback' => static function ( Perflab_Server_Timing_Metric $metric ): void {
 						$metric->measure_before();
 						add_action( 'perflab_server_timing_send_header', array( $metric, 'measure_after' ), PHP_INT_MAX );
 					},

includes/server-timing/load.php

@@ -205,7 +205,7 @@ function perflab_sanitize_server_timing_setting( $value ): array {
 			array_unique(
 				array_filter(
 					array_map(
-						static function ( $hook_name ) {
+						static function ( string $hook_name ): string {
 							/*
 							 * Allow any characters except whitespace.
 							 * While most hooks use a limited set of characters, hook names in plugins are not
@@ -227,5 +227,10 @@ static function ( $hook_name ) {
 
 	$value['output_buffering'] = (bool) $value['output_buffering'];
 
+	/**
+	 * Validated value.
+	 *
+	 * @var array{benchmarking_actions: string[], benchmarking_filters: string[], output_buffering: bool} $value
+	 */
 	return $value;
 }