<?php

/**

 * WP_Duotone class

 *

 * Parts of this source were derived and modified from colord,

 * released under the MIT license.

 *

 * https://github.com/omgovich/colord

 *

 * Copyright (c) 2020 Vlad Shilov omgovich@ya.ru

 *

 * Permission is hereby granted, free of charge, to any person obtaining

 * a copy of this software and associated documentation files (the

 * "Software"), to deal in the Software without restriction, including

 * without limitation the rights to use, copy, modify, merge, publish,

 * distribute, sublicense, and/or sell copies of the Software, and to

 * permit persons to whom the Software is furnished to do so, subject to

 * the following conditions:

 *

 * The above copyright notice and this permission notice shall be

 * included in all copies or substantial portions of the Software.

 *

 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION

 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

 *

 * @package WordPress

 * @since 6.3.0

 */

/**

 * Manages duotone block supports and global styles.

 *

 * @access private

 */

class WP_Duotone {

	/**

	 * Block names from global, theme, and custom styles that use duotone presets and the slug of

	 * the preset they are using.

	 *

	 * Example:

	 *  [

	 *      'core/featured-image' => 'blue-orange',

	 *       …

	 *  ]

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @var array

	 */

	private static $global_styles_block_names;

	/**

	 * An array of duotone filter data from global, theme, and custom presets.

	 *

	 * Example:

	 *  [

	 *      'wp-duotone-blue-orange' => [

	 *          'slug'  => 'blue-orange',

	 *          'colors' => [ '#0000ff', '#ffcc00' ],

	 *      ],

	 *      'wp-duotone-red-yellow' => [

	 *          'slug'   => 'red-yellow',

	 *          'colors' => [ '#cc0000', '#ffff33' ],

	 *      ],

	 *      …

	 *  ]

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @var array

	 */

	private static $global_styles_presets;

	/**

	 * All of the duotone filter data from presets for CSS custom properties on

	 * the page.

	 *

	 * Example:

	 *  [

	 *      'wp-duotone-blue-orange' => [

	 *          'slug'   => 'blue-orange',

	 *          'colors' => [ '#0000ff', '#ffcc00' ],

	 *      ],

	 *      …

	 *  ]

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @var array

	 */

	private static $used_global_styles_presets = array();

	/**

	 * All of the duotone filter data for SVGs on the page. Includes both

	 * presets and custom filters.

	 *

	 * Example:

	 *  [

	 *      'wp-duotone-blue-orange' => [

	 *          'slug'   => 'blue-orange',

	 *          'colors' => [ '#0000ff', '#ffcc00' ],

	 *      ],

	 *      'wp-duotone-000000-ffffff-2' => [

	 *          'slug'   => '000000-ffffff-2',

	 *          'colors' => [ '#000000', '#ffffff' ],

	 *      ],

	 *      …

	 *  ]

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @var array

	 */

	private static $used_svg_filter_data = array();

	/**

	 * All of the block CSS declarations for styles on the page.

	 *

	 * Example:

	 *  [

	 *      [

	 *          'selector'     => '.wp-duotone-000000-ffffff-2.wp-block-image img',

	 *          'declarations' => [

	 *              'filter' => 'url(#wp-duotone-000000-ffffff-2)',

	 *          ],

	 *      ],

	 *      …

	 *  ]

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @var array

	 */

	private static $block_css_declarations = array();

	/**

	 * Clamps a value between an upper and lower bound.

	 *

	 * Direct port of colord's clamp function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/helpers.ts#L23 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param float $number The number to clamp.

	 * @param float $min    The minimum value.

	 * @param float $max    The maximum value.

	 * @return float The clamped value.

	 */

	private static function colord_clamp( $number, $min = 0, $max = 1 ) {

		return $number > $max ? $max : ( $number > $min ? $number : $min );

	}

	/**

	 * Processes and clamps a degree (angle) value properly.

	 *

	 * Direct port of colord's clampHue function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/helpers.ts#L32 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param float $degrees The hue to clamp.

	 * @return float The clamped hue.

	 */

	private static function colord_clamp_hue( $degrees ) {

		$degrees = is_finite( $degrees ) ? $degrees % 360 : 0;

		return $degrees > 0 ? $degrees : $degrees + 360;

	}

	/**

	 * Converts a hue value to degrees from 0 to 360 inclusive.

	 *

	 * Direct port of colord's parseHue function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/helpers.ts#L40 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param float  $value The hue value to parse.

	 * @param string $unit  The unit of the hue value.

	 * @return float The parsed hue value.

	 */

	private static function colord_parse_hue( $value, $unit = 'deg' ) {

		$angle_units = array(

			'grad' => 360 / 400,

			'turn' => 360,

			'rad'  => 360 / ( M_PI * 2 ),

		);

		$factor = isset( $angle_units[ $unit ] ) ? $angle_units[ $unit ] : 1;

		return (float) $value * $factor;

	}

	/**

	 * Parses any valid Hex3, Hex4, Hex6 or Hex8 string and converts it to an RGBA object.

	 *

	 * Direct port of colord's parseHex function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hex.ts#L8 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param string $hex The hex string to parse.

	 * @return array|null An array of RGBA values or null if the hex string is invalid.

	 */

	private static function colord_parse_hex( $hex ) {

		$is_match = preg_match(

			'/^#([0-9a-f]{3,8})$/i',

			$hex,

			$hex_match

		);

		if ( ! $is_match ) {

			return null;

		}

		$hex = $hex_match[1];

		if ( 4 >= strlen( $hex ) ) {

			return array(

				'r' => (int) base_convert( $hex[0] . $hex[0], 16, 10 ),

				'g' => (int) base_convert( $hex[1] . $hex[1], 16, 10 ),

				'b' => (int) base_convert( $hex[2] . $hex[2], 16, 10 ),

				'a' => 4 === strlen( $hex ) ? round( base_convert( $hex[3] . $hex[3], 16, 10 ) / 255, 2 ) : 1,

			);

		}

		if ( 6 === strlen( $hex ) || 8 === strlen( $hex ) ) {

			return array(

				'r' => (int) base_convert( substr( $hex, 0, 2 ), 16, 10 ),

				'g' => (int) base_convert( substr( $hex, 2, 2 ), 16, 10 ),

				'b' => (int) base_convert( substr( $hex, 4, 2 ), 16, 10 ),

				'a' => 8 === strlen( $hex ) ? round( (int) base_convert( substr( $hex, 6, 2 ), 16, 10 ) / 255, 2 ) : 1,

			);

		}

		return null;

	}

	/**

	 * Clamps an array of RGBA values.

	 *

	 * Direct port of colord's clampRgba function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/rgb.ts#L5 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param array $rgba The RGBA array to clamp.

	 * @return array The clamped RGBA array.

	 */

	private static function colord_clamp_rgba( $rgba ) {

		$rgba['r'] = self::colord_clamp( $rgba['r'], 0, 255 );

		$rgba['g'] = self::colord_clamp( $rgba['g'], 0, 255 );

		$rgba['b'] = self::colord_clamp( $rgba['b'], 0, 255 );

		$rgba['a'] = self::colord_clamp( $rgba['a'] );

		return $rgba;

	}

	/**

	 * Parses a valid RGB[A] CSS color function/string.

	 *

	 * Direct port of colord's parseRgbaString function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/rgbString.ts#L18 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param string $input The RGBA string to parse.

	 * @return array|null An array of RGBA values or null if the RGB string is invalid.

	 */

	private static function colord_parse_rgba_string( $input ) {

		// Functional syntax.

		$is_match = preg_match(

			'/^rgba?\(\s*([+-]?\d*\.?\d+)(%)?\s*,\s*([+-]?\d*\.?\d+)(%)?\s*,\s*([+-]?\d*\.?\d+)(%)?\s*(?:,\s*([+-]?\d*\.?\d+)(%)?\s*)?\)$/i',

			$input,

			$match

		);

		if ( ! $is_match ) {

			// Whitespace syntax.

			$is_match = preg_match(

				'/^rgba?\(\s*([+-]?\d*\.?\d+)(%)?\s+([+-]?\d*\.?\d+)(%)?\s+([+-]?\d*\.?\d+)(%)?\s*(?:\/\s*([+-]?\d*\.?\d+)(%)?\s*)?\)$/i',

				$input,

				$match

			);

		}

		if ( ! $is_match ) {

			return null;

		}

		/*

		 * For some reason, preg_match doesn't include empty matches at the end

		 * of the array, so we add them manually to make things easier later.

		 */

		for ( $i = 1; $i <= 8; $i++ ) {

			if ( ! isset( $match[ $i ] ) ) {

				$match[ $i ] = '';

			}

		}

		if ( $match[2] !== $match[4] || $match[4] !== $match[6] ) {

			return null;

		}

		return self::colord_clamp_rgba(

			array(

				'r' => (float) $match[1] / ( $match[2] ? 100 / 255 : 1 ),

				'g' => (float) $match[3] / ( $match[4] ? 100 / 255 : 1 ),

				'b' => (float) $match[5] / ( $match[6] ? 100 / 255 : 1 ),

				'a' => '' === $match[7] ? 1 : (float) $match[7] / ( $match[8] ? 100 : 1 ),

			)

		);

	}

	/**

	 * Clamps an array of HSLA values.

	 *

	 * Direct port of colord's clampHsla function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hsl.ts#L6 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param array $hsla The HSLA array to clamp.

	 * @return array The clamped HSLA array.

	 */

	private static function colord_clamp_hsla( $hsla ) {

		$hsla['h'] = self::colord_clamp_hue( $hsla['h'] );

		$hsla['s'] = self::colord_clamp( $hsla['s'], 0, 100 );

		$hsla['l'] = self::colord_clamp( $hsla['l'], 0, 100 );

		$hsla['a'] = self::colord_clamp( $hsla['a'] );

		return $hsla;

	}

	/**

	 * Converts an HSVA array to RGBA.

	 *

	 * Direct port of colord's hsvaToRgba function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hsv.ts#L52 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param array $hsva The HSVA array to convert.

	 * @return array The RGBA array.

	 */

	private static function colord_hsva_to_rgba( $hsva ) {

		$h = ( $hsva['h'] / 360 ) * 6;

		$s = $hsva['s'] / 100;

		$v = $hsva['v'] / 100;

		$a = $hsva['a'];

		$hh     = floor( $h );

		$b      = $v * ( 1 - $s );

		$c      = $v * ( 1 - ( $h - $hh ) * $s );

		$d      = $v * ( 1 - ( 1 - $h + $hh ) * $s );

		$module = $hh % 6;

		return array(

			'r' => array( $v, $c, $b, $b, $d, $v )[ $module ] * 255,

			'g' => array( $d, $v, $v, $c, $b, $b )[ $module ] * 255,

			'b' => array( $b, $b, $d, $v, $v, $c )[ $module ] * 255,

			'a' => $a,

		);

	}

	/**

	 * Converts an HSLA array to HSVA.

	 *

	 * Direct port of colord's hslaToHsva function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hsl.ts#L33 Sourced from colord.

	 *

	 * @internal

	 *

	 * @since 6.3.0

	 *

	 * @param array $hsla The HSLA array to convert.

	 * @return array The HSVA array.

	 */

	private static function colord_hsla_to_hsva( $hsla ) {

		$h = $hsla['h'];

		$s = $hsla['s'];

		$l = $hsla['l'];

		$a = $hsla['a'];

		$s *= ( $l < 50 ? $l : 100 - $l ) / 100;

		return array(

			'h' => $h,

			's' => $s > 0 ? ( ( 2 * $s ) / ( $l + $s ) ) * 100 : 0,

			'v' => $l + $s,

			'a' => $a,

		);

	}

	/**

	 * Converts an HSLA array to RGBA.

	 *

	 * Direct port of colord's hslaToRgba function.

	 *

	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hsl.ts#L55 Sourced from colord.

	 *

	 * @internal