<?php
/**
 * Hook callbacks used for Modern Image Formats.
 *
 * @package webp-uploads
 *
 * @since 1.0.0
 */

// @codeCoverageIgnoreStart
if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}
// @codeCoverageIgnoreEnd

/**
 * Hook called by `wp_generate_attachment_metadata` to create the `sources` property for every image
 * size, the sources' property would create a new image size with all the mime types specified in
 * `webp_uploads_get_upload_image_mime_transforms`. If the original image is one of the mimes from
 * `webp_uploads_get_upload_image_mime_transforms` the image is just added to the `sources` property and not
 * created again. If the uploaded attachment is not a supported mime by this function, the hook does not alter the
 * metadata of the attachment. In addition to every single size the `sources` property is added at the
 * top level of the image metadata to store the references for all the mime types for the `full` size image of the
 * attachment.
 *
 * @since 1.0.0
 *
 * @see   wp_generate_attachment_metadata()
 * @see   webp_uploads_get_upload_image_mime_transforms()
 *
 * @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
 *  } $metadata
 *
 * @param array<string, mixed> $metadata      An array with the metadata from this attachment.
 * @param int                  $attachment_id The ID of the attachment where the hook was dispatched.
 *
 * @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
 *     }>
 * } An array with the updated structure for the metadata before is stored in the database.
 */
function webp_uploads_create_sources_property( array $metadata, int $attachment_id ): array {
	$file = get_attached_file( $attachment_id, true );
	// File does not exist.
	if ( false === $file || ! file_exists( $file ) ) {
		return $metadata;
	}

	$mime_type = webp_uploads_get_attachment_file_mime_type( $attachment_id, $file );
	if ( '' === $mime_type ) {
		return $metadata;
	}

	$valid_mime_transforms = webp_uploads_get_upload_image_mime_transforms();

	// Not a supported mime type to create the sources property.
	if ( ! isset( $valid_mime_transforms[ $mime_type ] ) ) {
		return $metadata;
	}

	// Make sure the top level `sources` key is a valid array.
	if ( ! isset( $metadata['sources'] ) || ! is_array( $metadata['sources'] ) ) {
		$metadata['sources'] = array();
	}

	if ( ! isset( $metadata['sources'][ $mime_type ]['file'] ) ) {
		$metadata['sources'][ $mime_type ] = array(
			'file'     => wp_basename( $file ),
			'filesize' => wp_filesize( $file ),
		);
		wp_update_attachment_metadata( $attachment_id, $metadata );
	}

	$original_size_data = array(
		'width'  => isset( $metadata['width'] ) ? (int) $metadata['width'] : 0,
		'height' => isset( $metadata['height'] ) ? (int) $metadata['height'] : 0,
		'crop'   => false,
	);

	$original_directory = pathinfo( $file, PATHINFO_DIRNAME );
	$filename           = pathinfo( $file, PATHINFO_FILENAME );
	$ext                = pathinfo( $file, PATHINFO_EXTENSION );
	$allowed_mimes      = array_flip( wp_get_mime_types() );

	// Create the sources for the full sized image.
	foreach ( $valid_mime_transforms[ $mime_type ] as $targeted_mime ) {
		// If this property exists no need to create the image again.
		if ( isset( $metadata['sources'][ $targeted_mime ]['file'] ) ) {
			continue;
		}

		// The targeted mime is not allowed in the current installation.
		if ( ! isset( $allowed_mimes[ $targeted_mime ] ) ) {
			continue;
		}

		$extension   = explode( '|', $allowed_mimes[ $targeted_mime ] );
		$destination = trailingslashit( $original_directory ) . "{$filename}-{$ext}.{$extension[0]}";
		$image       = webp_uploads_generate_additional_image_source( $attachment_id, 'full', $original_size_data, $targeted_mime, $destination );

		if ( is_wp_error( $image ) ) {
			continue;
		}

		if ( webp_uploads_should_discard_additional_image_file( $metadata, $image ) ) {
			wp_delete_file_from_directory( $destination, $original_directory );
			continue;
		}

		$metadata['sources'][ $targeted_mime ] = $image;
		wp_update_attachment_metadata( $attachment_id, $metadata );
	}

	// If the original MIME type should not be generated/used, override the main image
	// with the first MIME type image that actually should be generated. In that case,
	// the original should be backed up.
	if (
		! in_array( $mime_type, $valid_mime_transforms[ $mime_type ], true ) &&
		isset( $valid_mime_transforms[ $mime_type ][0] ) &&
		isset( $allowed_mimes[ $mime_type ] ) &&
		array_key_exists( 'file', $metadata ) &&
		is_string( $metadata['file'] )
	) {
		$valid_mime_type = $valid_mime_transforms[ $mime_type ][0];

		// Only do the replacement if the attachment file is still set to the original MIME type one,
		// and if there is a possible replacement source.
		$file_data = wp_check_filetype( $metadata['file'], array( $allowed_mimes[ $mime_type ] => $mime_type ) );
		if ( $file_data['type'] === $mime_type && isset( $metadata['sources'][ $valid_mime_type ] ) ) {
			$saved_data = array(
				'path'   => trailingslashit( $original_directory ) . $metadata['sources'][ $valid_mime_type ]['file'],
				'width'  => $metadata['width'],
				'height' => $metadata['height'],
			);

			$original_image = wp_get_original_image_path( $attachment_id );

			// If WordPress already modified the original itself, keep the original and discard WordPress's generated version.
			if ( isset( $metadata['original_image'] ) && is_string( $metadata['original_image'] ) && '' !== $metadata['original_image'] ) {
				$uploadpath    = wp_get_upload_dir();
				$attached_file = get_attached_file( $attachment_id );
				if ( false !== $attached_file ) {
					wp_delete_file_from_directory( $attached_file, $uploadpath['basedir'] );
				}
			}

			// Replace the attached file with the custom MIME type version.
			if ( false !== $original_image ) {
				$metadata = _wp_image_meta_replace_original( $saved_data, $original_image, $metadata, $attachment_id );
			}

			// Unset sources entry for the original MIME type, then save (to avoid inconsistent data
			// in case of an error after this logic).
			unset( $metadata['sources'][ $mime_type ] );
			wp_update_attachment_metadata( $attachment_id, $metadata );
		}
	}

	// Make sure we have some sizes to work with, otherwise avoid any work.
	if (
		! isset( $metadata['sizes'] ) ||
		! is_array( $metadata['sizes'] ) ||
		0 === count( $metadata['sizes'] )
	) {
		return $metadata;
	}

	$sizes_with_mime_type_support = webp_uploads_get_image_sizes_additional_mime_type_support();

	foreach ( $metadata['sizes'] as $size_name => $properties ) {
		// Do nothing if this image size is not an array or is not allowed to have additional mime types.
		if (
			! is_array( $properties ) ||
			! isset( $sizes_with_mime_type_support[ $size_name ] ) ||
			false === $sizes_with_mime_type_support[ $size_name ]
		) {
			continue;
		}

		// Try to find the mime type of the image size.
		$current_mime = '';
		if ( isset( $properties['mime-type'] ) ) {
			$current_mime = $properties['mime-type'];
		} elseif ( isset( $properties['file'] ) ) {
			$current_mime = wp_check_filetype( $properties['file'] )['type'];
		}

		// The mime type can't be determined.
		if ( ! is_string( $current_mime ) || '' === $current_mime ) {
			continue;
		}

		// Ensure a `sources` property exists on the existing size.
		if ( ! isset( $properties['sources'] ) || ! is_array( $properties['sources'] ) ) {
			$properties['sources'] = array();
		}

		if ( ! isset( $properties['sources'][ $current_mime ]['file'] ) && isset( $properties['file'] ) ) {
			$properties['sources'][ $current_mime ] = array(
				'file'     => $properties['file'],
				'filesize' => 0,
			);
			// Set the filesize from the current mime image.
			$file_location = path_join( $original_directory, $properties['file'] );
			if ( file_exists( $file_location ) ) {
				$properties['sources'][ $current_mime ]['filesize'] = wp_filesize( $file_location );
			}
			$metadata['sizes'][ $size_name ] = $properties;
			wp_update_attachment_metadata( $attachment_id, $metadata );
		}

		foreach ( $valid_mime_transforms[ $mime_type ] as $mime ) {
			// If this property exists no need to create the image again.
			if ( isset( $properties['sources'][ $mime ]['file'] ) ) {
				continue;
			}

			$source = webp_uploads_generate_image_size( $attachment_id, $size_name, $mime );
			if ( is_wp_error( $source ) ) {
				continue;
			}

			if ( webp_uploads_should_discard_additional_image_file( $properties, $source ) ) {
				$destination = path_join( $original_directory, $source['file'] );
				wp_delete_file_from_directory( $destination, $original_directory );
				continue;
			}

			$properties['sources'][ $mime ]  = $source;
			$metadata['sizes'][ $size_name ] = $properties;
			wp_update_attachment_metadata( $attachment_id, $metadata );
		}

		$metadata['sizes'][ $size_name ] = $properties;
	}

	return $metadata;
}
add_filter( 'wp_generate_attachment_metadata', 'webp_uploads_create_sources_property', 10, 2 );

/**
 * Filter on `wp_get_missing_image_subsizes` acting as an action for the logic of the plugin
 * to determine if additional mime types still need to be created.
 *
 * This function only exists to work around a missing filter in WordPress core, to call the above
 * `webp_uploads_create_sources_property()` function correctly.
 *
 * @since 1.0.0
 *
 * @see wp_get_missing_image_subsizes()
 *
 * @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
 *
 * @param array|mixed          $missing_sizes Associative array of arrays of image sub-sizes.
 * @param array<string, mixed> $image_meta    The metadata from the image.
 * @param int                  $attachment_id The ID of the attachment.
 * @return array<string, array{ width: int, height: int, crop: bool }> Associative array of arrays of image sub-sizes.
 */
function webp_uploads_wp_get_missing_image_subsizes( $missing_sizes, array $image_meta, int $attachment_id ): array {
	if ( ! is_array( $missing_sizes ) ) {
		$missing_sizes = array();
	}

	// Only setup the trace array if we no longer have more sizes.
	if ( count( $missing_sizes ) > 0 ) {
		return $missing_sizes;
	}

	/**
	 * The usage of `debug_backtrace` in this particular case is mainly to ensure the call to
	 * `wp_get_missing_image_subsizes()` originated from `wp_update_image_subsizes()`, since only then the
	 * additional image sizes should be generated. `wp_get_missing_image_subsizes()` could also be called
	 * from other places in which case the custom logic should not trigger. In an ideal world an action
	 * would exist in `wp_update_image_subsizes` that runs any time, but the current
	 * `wp_generate_attachment_metadata` filter is skipped when all core sub-sizes have been generated.
	 * An eventual core implementation will not require this workaround. The limit of 10 is used to allow
	 * for some flexibility. While by default the function would be on index 5, other custom code may
	 * cause the index to be slightly higher.
	 *
	 * @see wp_update_image_subsizes()
	 * @see wp_get_missing_image_subsizes()
	 */
	// PHPCS ignore reason: Only the way to generate missing image subsize if all core sub-sizes have been generated.
	// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_debug_backtrace
	$trace = debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS, 10 );

	foreach ( $trace as $element ) {
		if ( 'wp_update_image_subsizes' === $element['function'] ) {
			webp_uploads_create_sources_property( $image_meta, $attachment_id );
			break;
		}
	}

	return array();
}
add_filter( 'wp_get_missing_image_subsizes', 'webp_uploads_wp_get_missing_image_subsizes', 10, 3 );

/**
 * Filter the image editor default output format mapping to select the most appropriate
 * output format depending on desired output formats and supported mime types by the image
 * editor.
 *
 * @since 1.0.0
 *
 * @param array<string, string>|mixed $output_format An array of mime type mappings. Maps a source mime type to a new destination mime type. Default empty array.
 * @param string|null                 $filename      Path to the image.
 * @param string|null                 $mime_type     The source image mime type.
 * @return array<string, string> The new output format mapping.
 */
function webp_uploads_filter_image_editor_output_format( $output_format, ?string $filename, ?string $mime_type ): array {
	if ( ! is_array( $output_format ) ) {
		$output_format = array();
	}

	// Use the original mime type if this type is allowed.
	$valid_mime_transforms = webp_uploads_get_upload_image_mime_transforms();
	if (
		! isset( $valid_mime_transforms[ $mime_type ] ) ||
		in_array( $mime_type, $valid_mime_transforms[ $mime_type ], true )
	) {
		return $output_format;
	}

	// Find the first supported mime type by the image editor to use it as the default one.
	foreach ( $valid_mime_transforms[ $mime_type ] as $target_mime ) {
		if ( wp_image_editor_supports( array( 'mime_type' => $target_mime ) ) ) {
			$output_format[ $mime_type ] = $target_mime;
			break;
		}
	}

	return $output_format;
}
add_filter( 'image_editor_output_format', 'webp_uploads_filter_image_editor_output_format', 10, 3 );

/**
 * Hook fired when an attachment is deleted, this hook is in charge of removing any
 * additional mime types created by this plugin besides the original image. Any source
 * with the same as the main image would not be removed by this hook due this file would
 * be removed by WordPress when the attachment is deleted, usually this happens after this
 * hook is executed.
 *
 * @since 1.0.0
 *
 * @see wp_delete_attachment()
 *
 * @param int $attachment_id The ID of the attachment the sources are going to be deleted.
 */
function webp_uploads_remove_sources_files( int $attachment_id ): void {
	$file = get_attached_file( $attachment_id );

	if ( false === (bool) $file ) {
		return;
	}

	$metadata = wp_get_attachment_metadata( $attachment_id );
	// Make sure $sizes is always defined to allow the removal of original images after the first foreach loop.
	$sizes = ! isset( $metadata['sizes'] ) || ! is_array( $metadata['sizes'] ) ? array() : $metadata['sizes'];

	$upload_path = wp_get_upload_dir();
	if (
		! isset( $upload_path['basedir'] ) ||
		! is_string( $upload_path['basedir'] ) ||
		'' === $upload_path['basedir']
	) {
		return;
	}

	$intermediate_dir = path_join( $upload_path['basedir'], dirname( $file ) );
	$basename         = wp_basename( $file );

	foreach ( $sizes as $size ) {
		if ( ! isset( $size['sources'] ) || ! is_array( $size['sources'] ) ) {
			continue;
		}

		$original_size_mime = isset( $size['mime-type'] ) && is_string( $size['mime-type'] ) ? $size['mime-type'] : '';

		foreach ( $size['sources'] as $mime => $properties ) {
			/**
			 * When we face the same mime type as the original image, we ignore this file as this file
			 * would be removed when the size is removed by WordPress itself. The meta information as well
			 * would be deleted as soon as the image is removed.
			 *
			 * @see wp_delete_attachment
			 */
			if ( $original_size_mime === $mime ) {
				continue;
			}

			if (
				! isset( $properties['file'] ) ||
				! is_string( $properties['file'] ) ||
				'' === $properties['file']
			) {
				continue;
			}

			$intermediate_file = str_replace( $basename, $properties['file'], $file );
			if ( '' === $intermediate_file ) {
				continue;
			}

			$intermediate_file = path_join( $upload_path['basedir'], $intermediate_file );
			if ( ! file_exists( $intermediate_file ) ) {
				continue;
			}

			wp_delete_file_from_directory( $intermediate_file, $intermediate_dir );
		}
	}

	if ( ! isset( $metadata['sources'] ) || ! is_array( $metadata['sources'] ) ) {
		return;
	}

	$original_mime_from_post = get_post_mime_type( $attachment_id );
	$original_mime_from_file = wp_check_filetype( $file )['type'];

	// Delete full sizes mime types.
	foreach ( $metadata['sources'] as $mime => $properties ) {
		// Don't remove the image with the same mime type as the original image as this would be removed by WordPress.
		if ( $mime === $original_mime_from_post || $mime === $original_mime_from_file ) {
			continue;
		}

		if (
			! isset( $properties['file'] ) ||
			! is_string( $properties['file'] ) ||
			'' === $properties['file']
		) {
			continue;
		}

		$full_size = str_replace( $basename, $properties['file'], $file );
		if ( '' === $full_size ) {
			continue;
		}

		$full_size_file = path_join( $upload_path['basedir'], $full_size );
		if ( ! file_exists( $full_size_file ) ) {
			continue;
		}
		wp_delete_file_from_directory( $full_size_file, $intermediate_dir );
	}

	$backup_sizes = get_post_meta( $attachment_id, '_wp_attachment_backup_sizes', true );
	$backup_sizes = is_array( $backup_sizes ) ? $backup_sizes : array();

	foreach ( $backup_sizes as $backup_size ) {
		if ( ! isset( $backup_size['sources'] ) || ! is_array( $backup_size['sources'] ) ) {
			continue;
		}

		$original_backup_size_mime = isset( $backup_size['mime-type'] ) && is_string( $backup_size['mime-type'] ) ? $backup_size['mime-type'] : '';

		foreach ( $backup_size['sources'] as $backup_mime => $backup_properties ) {
			/**
			 * When we face the same mime type as the original image, we ignore this file as this file
			 * would be removed when the size is removed by WordPress itself. The meta information as well
			 * would be deleted as soon as the image is removed.
			 *
			 * @see wp_delete_attachment
			 */
			if ( $original_backup_size_mime === $backup_mime ) {
				continue;
			}

			if (
				! isset( $backup_properties['file'] ) ||
				! is_string( $backup_properties['file'] ) ||
				'' === $backup_properties['file']
			) {
				continue;
			}

			$backup_intermediate_file = str_replace( $basename, $backup_properties['file'], $file );
			if ( '' === $backup_intermediate_file ) {
				continue;
			}

			$backup_intermediate_file = path_join( $upload_path['basedir'], $backup_intermediate_file );
			if ( ! file_exists( $backup_intermediate_file ) ) {
				continue;
			}

			wp_delete_file_from_directory( $backup_intermediate_file, $intermediate_dir );
		}
	}

	$backup_sources = get_post_meta( $attachment_id, '_wp_attachment_backup_sources', true );
	$backup_sources = is_array( $backup_sources ) ? $backup_sources : array();

	// Delete full sizes backup mime types.
	foreach ( $backup_sources as $backup_mimes ) {

		foreach ( $backup_mimes as $backup_mime_properties ) {
			if (
				! isset( $backup_mime_properties['file'] ) ||
				! is_string( $backup_mime_properties['file'] ) ||
				'' === $backup_mime_properties['file']
			) {
				continue;
			}

			$full_size = str_replace( $basename, $backup_mime_properties['file'], $file );
			if ( '' === $full_size ) {
				continue;
			}

			$full_size_file = path_join( $upload_path['basedir'], $full_size );
			if ( ! file_exists( $full_size_file ) ) {
				continue;
			}
			wp_delete_file_from_directory( $full_size_file, $intermediate_dir );
		}
	}
}
add_action( 'delete_attachment', 'webp_uploads_remove_sources_files' );

/**
 * Filters `wp_content_img_tag` to update images so that they use the preferred MIME type where possible.
 *
 * @since 2.5.0
 *
 * @param string $filtered_image Full img tag with attributes that will replace the source img tag.
 * @param string $context        Additional context, like the current filter name or the function name from where this was called.
 * @param int    $attachment_id  The image attachment ID. May be 0 in case the image is not an attachment.
 * @return string The updated IMG tag with references to the new MIME type if available.
 */
function webp_uploads_filter_image_tag( string $filtered_image, string $context, int $attachment_id ): string {
	// Bail early if request is not for the frontend.
	if ( ! webp_uploads_in_frontend_body() ) {
		return $filtered_image;
	}

	$filtered_image = str_replace( $filtered_image, webp_uploads_img_tag_update_mime_type( $filtered_image, 'the_content', $attachment_id ), $filtered_image );

	return $filtered_image;
}

/**
 * Finds all the urls with *.jpg and *.jpeg extension and updates with *.webp version for the provided image
 * for the specified image sizes, the *.webp references are stored inside of each size.
 *
 * @since 1.0.0
 *
 * @param string $original_image An <img> tag where the urls would be updated.
 * @param string $context        The context where this is function is being used.
 * @param int    $attachment_id  The ID of the attachment being modified.
 * @return string The updated img tag.
 */
function webp_uploads_img_tag_update_mime_type( string $original_image, string $context, int $attachment_id ): string {
	$image    = $original_image;
	$metadata = wp_get_attachment_metadata( $attachment_id );

	if ( ! isset( $metadata['file'] ) || ! is_string( $metadata['file'] ) || '' === $metadata['file'] ) {
		return $image;
	}

	$original_mime = get_post_mime_type( $attachment_id );
	$target_mimes  = webp_uploads_get_content_image_mimes( $attachment_id, $context );

	foreach ( $target_mimes as $target_mime ) {
		if ( $target_mime === $original_mime ) {
			continue;
		}

		if ( ! isset( $metadata['sources'][ $target_mime ]['file'] ) ) {
			continue;
		}

		/**
		 * Filter to replace additional image source file, by locating the original
		 * mime types of the file and return correct file path in the end.
		 *
		 * Altering the $image tag through this filter effectively short-circuits the default replacement logic using the preferred MIME type.
		 *
		 * @since 1.1.0
		 *
		 * @param string $image         An <img> tag where the urls would be updated.
		 * @param int    $attachment_id The ID of the attachment being modified.
		 * @param string $size          The size name that would be used to create this image, out of the registered subsizes.
		 * @param string $target_mime   The target mime in which the image should be created.
		 * @param string $context       The context where this is function is being used.
		 */
		$filtered_image = (string) apply_filters( 'webp_uploads_pre_replace_additional_image_source', $image, $attachment_id, 'full', $target_mime, $context );

		// If filtered image is same as the image, run our own replacement logic, otherwise rely on the filtered image.
		if ( $filtered_image === $image ) {
			$basename = wp_basename( $metadata['file'] );
			$image    = str_replace(
				$basename,
				$metadata['sources'][ $target_mime ]['file'],
				$image
			);
		} else {
			$image = $filtered_image;
		}
	}

	if ( isset( $metadata['sizes'] ) && is_array( $metadata['sizes'] ) ) {
		// Replace sub sizes for the image if present.
		foreach ( $metadata['sizes'] as $size => $size_data ) {

			if ( ! isset( $size_data['file'] ) || ! is_string( $size_data['file'] ) || '' === $size_data['file'] ) {
				continue;
			}

			foreach ( $target_mimes as $target_mime ) {
				if ( $target_mime === $original_mime ) {
					continue;
				}

				if ( ! isset( $size_data['sources'][ $target_mime ]['file'] ) ) {
					continue;
				}

				if ( $size_data['file'] === $size_data['sources'][ $target_mime ]['file'] ) {
					continue;
				}

				/** This filter is documented in plugins/webp-uploads/load.php */
				$filtered_image = (string) apply_filters( 'webp_uploads_pre_replace_additional_image_source', $image, $attachment_id, $size, $target_mime, $context );

				// If filtered image is same as the image, run our own replacement logic, otherwise rely on the filtered image.
				if ( $filtered_image === $image ) {
					$image = str_replace(
						$size_data['file'],
						$size_data['sources'][ $target_mime ]['file'],
						$image
					);
				} else {
					$image = $filtered_image;
				}
			}
		}
	}

	return $image;
}

/**
 * Updates the references of the featured image to the new image format if available, in the same way it
 * occurs in the_content of a post.
 *
 * @since 1.0.0
 *
 * @param string $html          The current HTML markup of the featured image.
 * @param int    $post_id       The current post ID where the featured image is requested.
 * @param int    $attachment_id The ID of the attachment image.
 * @return string The updated HTML markup.
 */
function webp_uploads_update_featured_image( string $html, int $post_id, int $attachment_id ): string {
	return webp_uploads_img_tag_update_mime_type( $html, 'post_thumbnail_html', $attachment_id );
}
add_filter( 'post_thumbnail_html', 'webp_uploads_update_featured_image', 10, 3 );

/**
 * Returns an array of image size names that have secondary mime type output enabled. Core sizes and
 * core theme sizes are enabled by default.
 *
 * Developers can control the generation of additional mime images for all sizes using the
 * webp_uploads_image_sizes_with_additional_mime_type_support filter.
 *
 * @since 1.0.0
 *
 * @return array<string, bool> An array of image sizes that can have additional mime types.
 */
function webp_uploads_get_image_sizes_additional_mime_type_support(): array {
	$additional_sizes = wp_get_additional_image_sizes();
	$allowed_sizes    = array(
		'thumbnail'      => true,
		'medium'         => true,
		'medium_large'   => true,
		'large'          => true,
		'post-thumbnail' => true,
	);

	foreach ( $additional_sizes as $size => $size_details ) {
		$allowed_sizes[ $size ] = isset( $size_details['provide_additional_mime_types'] ) && true === (bool) $size_details['provide_additional_mime_types'];
	}

	/**
	 * Filters whether additional mime types are allowed for image sizes.
	 *
	 * @since 1.0.0
	 *
	 * @param array<string, bool> $allowed_sizes A map of image size names and whether they are allowed to have additional mime types.
	 */
	$allowed_sizes = (array) apply_filters( 'webp_uploads_image_sizes_with_additional_mime_type_support', $allowed_sizes );

	return $allowed_sizes;
}

/**
 * Updates the quality of WebP image sizes generated by WordPress to 82.
 *
 * @since 1.0.0
 *
 * @param int    $quality   Quality level between 1 (low) and 100 (high).
 * @param string $mime_type Image mime type.
 * @return int The updated quality for mime types.
 */
function webp_uploads_modify_webp_quality( int $quality, string $mime_type ): int {
	// For WebP images, always return 82 (other MIME types were already using 82 by default anyway).
	if ( 'image/webp' === $mime_type ) {
		return 82;
	}

	// Return default quality for non-WebP images in WP.
	return $quality;
}
add_filter( 'wp_editor_set_quality', 'webp_uploads_modify_webp_quality', 10, 2 );

/**
 * Displays the HTML generator tag for the Modern Image Formats plugin.
 *
 * See {@see 'wp_head'}.
 *
 * @since 1.0.0
 */
function webp_uploads_render_generator(): void {
	// Use the plugin slug as it is immutable.
	echo '<meta name="generator" content="webp-uploads ' . esc_attr( WEBP_UPLOADS_VERSION ) . '">' . "\n";
}
add_action( 'wp_head', 'webp_uploads_render_generator' );

/**
 * Process a block's content to handle background images for specific block types.
 *
 * This function targets blocks like Cover and Group that may use background images,
 * converting them to modern image formats when appropriate.
 *
 * @since 2.6.0
 *
 * @phpstan-param array{
 *                    blockName: string|null,
 *                    attrs: array{
 *                        id?: positive-int,
 *                        url?: string,
 *                        style?: array{
 *                            background?: array{
 *                                backgroundImage?: string
 *                            }
 *                        }
 *                    }
 *                } $block
 *
 * @param string|mixed         $block_content The block content.
 * @param array<string, mixed> $block         The block.
 * @return string The filtered block content.
 */
function webp_uploads_filter_block_background_images( $block_content, array $block ): string {
	// Because plugins can do bad things.
	if ( ! is_string( $block_content ) ) {
		$block_content = '';
	}

	// Only run on frontend.
	if ( ! webp_uploads_in_frontend_body() || '' === $block_content ) {
		return $block_content;
	}

	$attachment_id = null;
	$image_url     = null;

	if ( 'core/cover' === $block['blockName'] ) {
		if ( isset( $block['attrs']['id'], $block['attrs']['url'] ) ) {
			$attachment_id = $block['attrs']['id'];
			$image_url     = $block['attrs']['url'];
		}
	} elseif ( 'core/group' === $block['blockName'] ) {
		if ( isset( $block['attrs']['style']['background']['backgroundImage']['id'], $block['attrs']['style']['background']['backgroundImage']['url'] ) ) {
			$attachment_id = $block['attrs']['style']['background']['backgroundImage']['id'];
			$image_url     = $block['attrs']['style']['background']['backgroundImage']['url'];
		}
	}

	// Abort if there is no associated background image.
	if (
		! isset( $attachment_id, $image_url ) ||
		$attachment_id <= 0 ||
		'' === $image_url ||
		! is_array( wp_get_attachment_metadata( $attachment_id ) )
	) {
		return $block_content;
	}

	$original_mime = get_post_mime_type( $attachment_id );
	if ( ! is_string( $original_mime ) ) {
		return $block_content;
	}

	$target_mimes = webp_uploads_get_content_image_mimes( $attachment_id, 'background_image' );

	foreach ( $target_mimes as $target_mime ) {
		if ( $target_mime === $original_mime ) {
			continue;
		}

		$new_url = webp_uploads_get_mime_type_image( $attachment_id, $image_url, $target_mime );
		if ( ! is_string( $new_url ) ) {
			continue;
		}

		$processor = new WP_HTML_Tag_Processor( $block_content );
		while ( $processor->next_tag() ) {
			$style = $processor->get_attribute( 'style' );
			if ( is_string( $style ) && str_contains( $style, 'background-image:' ) && str_contains( $style, $image_url ) ) {
				$updated_style = str_replace( $image_url, $new_url, $style );
				$processor->set_attribute( 'style', $updated_style );
				$block_content = $processor->get_updated_html();
				break 2;
			}
		}
	}

	return $block_content;
}

/**
 * Initializes custom functionality for handling image uploads and content filters.
 *
 * @since 2.1.0
 */
function webp_uploads_init(): void {
	// Filter regular image tags.
	add_filter( 'wp_content_img_tag', webp_uploads_is_picture_element_enabled() ? 'webp_uploads_wrap_image_in_picture' : 'webp_uploads_filter_image_tag', 10, 3 );

	// Filter blocks that may contain background images.
	add_filter( 'render_block_core/cover', 'webp_uploads_filter_block_background_images', 10, 2 );
	add_filter( 'render_block_core/group', 'webp_uploads_filter_block_background_images', 10, 2 );
}
add_action( 'init', 'webp_uploads_init' );

/**
 * Automatically opt into extra image sizes when generating fallback images.
 *
 * @since 2.4.0
 *
 * @global array $_wp_additional_image_sizes Associative array of additional image sizes.
 */
function webp_uploads_opt_in_extra_image_sizes(): void {
	if ( ! webp_uploads_is_fallback_enabled() ) {
		return;
	}

	global $_wp_additional_image_sizes;

	// Modify global to mimic the "hypothetical" WP core API behavior via an additional `add_image_size()` parameter.

	if ( isset( $_wp_additional_image_sizes['1536x1536'] ) && ! isset( $_wp_additional_image_sizes['1536x1536']['provide_additional_mime_types'] ) ) {
		$_wp_additional_image_sizes['1536x1536']['provide_additional_mime_types'] = true; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
	}

	if ( isset( $_wp_additional_image_sizes['2048x2048'] ) && ! isset( $_wp_additional_image_sizes['2048x2048']['provide_additional_mime_types'] ) ) {
		$_wp_additional_image_sizes['2048x2048']['provide_additional_mime_types'] = true; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
	}
}
add_action( 'plugins_loaded', 'webp_uploads_opt_in_extra_image_sizes' );

/**
 * Enables additional MIME type support for all image sizes based on the generate all fallback sizes settings.
 *
 * @since 2.4.0
 *
 * @param array<string, bool> $allowed_sizes A map of image size names and whether they are allowed to have additional MIME types.
 * @return array<string, bool> Modified map of image sizes with additional MIME type support.
 */
function webp_uploads_enable_additional_mime_type_support_for_all_sizes( array $allowed_sizes ): array {
	if ( ! webp_uploads_should_generate_all_fallback_sizes() ) {
		return $allowed_sizes;
	}

	foreach ( array_keys( $allowed_sizes ) as $size ) {
		$allowed_sizes[ $size ] = true;
	}

	return $allowed_sizes;
}
add_filter( 'webp_uploads_image_sizes_with_additional_mime_type_support', 'webp_uploads_enable_additional_mime_type_support_for_all_sizes' );

/**
 * Converts palette PNG images to truecolor PNG images.
 *
 * GD cannot convert palette-based PNG to WebP/AVIF formats, causing conversion failures.
 * This function detects and converts palette PNG to truecolor during upload.
 *
 * @since 2.6.0
 *
 * @param array<string, mixed>|mixed $file The uploaded file data.
 * @return array<string, mixed> The modified file data.
 */
function webp_uploads_convert_palette_png_to_truecolor( $file ): array {
	// Because plugins do bad things.
	if ( ! is_array( $file ) ) {
		$file = array();
	}
	if ( ! isset( $file['tmp_name'], $file['name'] ) ) {
		return $file;
	}
	if ( isset( $file['type'] ) && is_string( $file['type'] ) ) {
		if ( 'image/png' !== strtolower( $file['type'] ) ) {
			return $file;
		}
	} elseif ( 'image/png' !== wp_check_filetype_and_ext( $file['tmp_name'], $file['name'] )['type'] ) {
		return $file;
	}

	$editor = wp_get_image_editor( $file['tmp_name'] );

	if ( is_wp_error( $editor ) || ! $editor instanceof WP_Image_Editor_GD ) {
		return $file;
	}

	$image = imagecreatefrompng( $file['tmp_name'] );

	// Check if the image was created successfully.
	if ( false === $image ) {
		return $file;
	}

	// Check if the image is already truecolor.
	if ( imageistruecolor( $image ) ) {
		imagedestroy( $image );
		return $file;
	}

	// Preserve transparency.
	imagealphablending( $image, false );
	imagesavealpha( $image, true );

	// Convert the palette to truecolor.
	if ( imagepalettetotruecolor( $image ) ) {
		// Overwrite the upload with the new truecolor PNG.
		imagepng( $image, $file['tmp_name'] );
	}
	imagedestroy( $image );

	return $file;
}
add_filter( 'wp_handle_upload_prefilter', 'webp_uploads_convert_palette_png_to_truecolor' );
add_filter( 'wp_handle_sideload_prefilter', 'webp_uploads_convert_palette_png_to_truecolor' );