Mark private and new deprecated methods as internal

src/wp-includes/class-wp-duotone.php

@@ -48,6 +48,8 @@ class WP_Duotone {
 	 *       …
 	 *  ]
 	 *
+	 * @internal
+	 *
 	 * @var array
 	 */
 	private static $global_styles_block_names = array();
@@ -68,6 +70,8 @@ class WP_Duotone {
 	 *      …
 	 *  ]
 	 *
+	 * @internal
+	 *
 	 * @var array
 	 */
 	private static $global_styles_presets = array();
@@ -85,6 +89,8 @@ class WP_Duotone {
 	 *      …
 	 *  ]
 	 *
+	 * @internal
+	 *
 	 * @var array
 	 */
 	private static $used_global_styles_presets = array();
@@ -106,6 +112,8 @@ class WP_Duotone {
 	 *      …
 	 *  ]
 	 *
+	 * @internal
+	 *
 	 * @var array
 	 */
 	private static $used_svg_filter_data = array();
@@ -124,15 +132,21 @@ class WP_Duotone {
 	 *      …
 	 *  ]
 	 *
+	 * @internal
+	 *
 	 * @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
+	 *
 	 * @param float $number The number to clamp.
 	 * @param float $min    The minimum value.
 	 * @param float $max    The maximum value.
@@ -145,8 +159,12 @@ private static function colord_clamp( $number, $min = 0, $max = 1 ) {
 	/**
 	 * 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
+	 *
 	 * @param float $degrees The hue to clamp.
 	 * @return float The clamped hue.
 	 */
@@ -158,8 +176,12 @@ private static function colord_clamp_hue( $degrees ) {
 	/**
 	 * 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
+	 *
 	 * @param float  $value The hue value to parse.
 	 * @param string $unit  The unit of the hue value.
 	 * @return float The parsed hue value.
@@ -182,8 +204,12 @@ private static function colord_parse_hue( $value, $unit = 'deg' ) {
 	/**
 	 * 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
+	 *
 	 * @param string $hex The hex string to parse.
 	 * @return array|null An array of RGBA values or null if the hex string is invalid.
 	 */
@@ -224,8 +250,12 @@ private static function colord_parse_hex( $hex ) {
 	/**
 	 * 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
+	 *
 	 * @param array $rgba The RGBA array to clamp.
 	 * @return array The clamped RGBA array.
 	 */
@@ -241,8 +271,12 @@ private static function colord_clamp_rgba( $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
+	 *
 	 * @param string $input The RGBA string to parse.
 	 * @return array|null An array of RGBA values or null if the RGB string is invalid.
 	 */
@@ -294,8 +328,12 @@ private static function colord_parse_rgba_string( $input ) {
 	/**
 	 * 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
+	 *
 	 * @param array $hsla The HSLA array to clamp.
 	 * @return array The clamped HSLA array.
 	 */
@@ -311,8 +349,12 @@ private static function colord_clamp_hsla( $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
+	 *
 	 * @param array $hsva The HSVA array to convert.
 	 * @return array The RGBA array.
 	 */
@@ -339,8 +381,12 @@ private static function colord_hsva_to_rgba( $hsva ) {
 	/**
 	 * 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
+	 *
 	 * @param array $hsla The HSLA array to convert.
 	 * @return array The HSVA array.
 	 */
@@ -363,8 +409,12 @@ private static function colord_hsla_to_hsva( $hsla ) {
 	/**
 	 * 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
+	 *
 	 * @param array $hsla The HSLA array to convert.
 	 * @return array The RGBA array.
 	 */
@@ -375,8 +425,12 @@ private static function colord_hsla_to_rgba( $hsla ) {
 	/**
 	 * Parses a valid HSL[A] CSS color function/string.
 	 *
+	 * Direct port of colord's parseHslaString function.
+	 *
 	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/colorModels/hslString.ts#L17 Sourced from colord.
 	 *
+	 * @internal
+	 *
 	 * @param string $input The HSLA string to parse.
 	 * @return array|null An array of RGBA values or null if the RGB string is invalid.
 	 */
@@ -426,8 +480,13 @@ private static function colord_parse_hsla_string( $input ) {
 	/**
 	 * Tries to convert an incoming string into RGBA values.
 	 *
+	 * Direct port of colord's parse function simplified for our use case. This
+	 * version only supports string parsing and only returns RGBA values.
+	 *
 	 * @link https://github.com/omgovich/colord/blob/3f859e03b0ca622eb15480f611371a0f15c9427f/src/parse.ts#L37 Sourced from colord.
 	 *
+	 * @internal
+	 *
 	 * @param string $input The string to parse.
 	 * @return array|null An array of RGBA values or null if the string is invalid.
 	 */
@@ -452,6 +511,8 @@ private static function colord_parse( $input ) {
 	 * var:preset|duotone|blue-orange
 	 * var(--wp--preset--duotone--blue-orange)
 	 *
+	 * @internal
+	 *
 	 * @param string $duotone_attr The duotone attribute from a block.
 	 * @return string The slug of the duotone preset or an empty string if no slug is found.
 	 */
@@ -465,6 +526,8 @@ private static function get_slug_from_attribute( $duotone_attr ) {
 	/**
 	 * Checks if we have a valid duotone preset.
 	 *
+	 * @internal
+	 *
 	 * @param string $duotone_attr The duotone attribute from a block.
 	 * @return bool True if the duotone preset present and valid.
 	 */
@@ -478,6 +541,8 @@ private static function is_preset( $duotone_attr ) {
 	/**
 	 * Gets the CSS variable name for a duotone preset.
 	 *
+	 * @internal
+	 *
 	 * @param string $slug The slug of the duotone preset.
 	 * @return string The CSS variable name.
 	 */
@@ -488,6 +553,8 @@ private static function get_css_custom_property_name( $slug ) {
 	/**
 	 * Get the ID of the duotone filter.
 	 *
+	 * @internal
+	 *
 	 * @param string $slug The slug of the duotone preset.
 	 * @return string The ID of the duotone filter.
 	 */
@@ -498,6 +565,8 @@ private static function get_filter_id( $slug ) {
 	/**
 	 * Get the CSS variable for a duotone preset.
 	 *
+	 * @internal
+	 *
 	 * @param string $slug The slug of the duotone preset.
 	 * @return string The CSS variable.
 	 */
@@ -509,6 +578,8 @@ private static function get_css_var( $slug ) {
 	/**
 	 * Get the URL for a duotone filter.
 	 *
+	 * @internal
+	 *
 	 * @param string $filter_id The ID of the filter.
 	 * @return string The URL for the duotone filter.
 	 */
@@ -519,6 +590,8 @@ private static function get_filter_url( $filter_id ) {
 	/**
 	 * Gets the SVG for the duotone filter definition.
 	 *
+	 * @internal
+	 *
 	 * @param string $filter_id The ID of the filter.
 	 * @param array  $colors    An array of color strings.
 	 * @return string An SVG with a duotone filter definition.
@@ -604,6 +677,8 @@ private static function get_filter_svg( $filter_id, $colors ) {
 	 *
 	 * Exported for the deprecated function wp_get_duotone_filter_id().
 	 *
+	 * @internal
+	 *
 	 * @since 6.3.0
 	 * @deprecated 6.3.0
 	 *
@@ -625,6 +700,8 @@ public static function get_filter_id_from_preset( $preset ) {
 	 *
 	 * Exported for the deprecated function wp_get_duotone_filter_property().
 	 *
+	 * @internal
+	 *
 	 * @since 6.3.0
 	 * @deprecated 6.3.0
 	 *
@@ -644,6 +721,8 @@ public static function get_filter_svg_from_preset( $preset ) {
 	 * Example output:
 	 *  <svg><defs><filter id="wp-duotone-blue-orange">…</filter></defs></svg><svg>…</svg>
 	 *
+	 * @internal
+	 *
 	 * @param array $sources The duotone presets.
 	 * @return string The SVGs for the duotone filters.
 	 */
@@ -662,6 +741,8 @@ private static function get_svg_definitions( $sources ) {
 	 * Example output:
 	 *  body{--wp--preset--duotone--blue-orange:url('#wp-duotone-blue-orange');}
 	 *
+	 * @internal
+	 *
 	 * @param array $sources The duotone presets.
 	 * @return string The CSS for global styles.
 	 */
@@ -681,6 +762,8 @@ private static function get_global_styles_presets( $sources ) {
 	/**
 	 * Enqueue a block CSS declaration for the page.
 	 *
+	 * @internal
+	 *
 	 * @param string $filter_id        The filter ID. e.g. 'wp-duotone-000000-ffffff-2'.
 	 * @param string $duotone_selector The block's duotone selector. e.g. '.wp-block-image img'.
 	 * @param string $filter_value     The filter CSS value. e.g. 'url(#wp-duotone-000000-ffffff-2)' or 'unset'.
@@ -714,6 +797,8 @@ private static function enqueue_block_css( $filter_id, $duotone_selector, $filte
 	 *
 	 * Includes an SVG filter and block CSS declaration.
 	 *
+	 * @internal
+	 *
 	 * @param string $filter_id        The filter ID. e.g. 'wp-duotone-000000-ffffff-2'.
 	 * @param string $duotone_selector The block's duotone selector. e.g. '.wp-block-image img'.
 	 * @param string $filter_value     The filter CSS value. e.g. 'url(#wp-duotone-000000-ffffff-2)' or 'unset'.
@@ -729,6 +814,8 @@ private static function enqueue_custom_filter( $filter_id, $duotone_selector, $f
 	 *
 	 * Includes a CSS custom property, SVG filter, and block CSS declaration.
 	 *
+	 * @internal
+	 *
 	 * @param string $filter_id        The filter ID. e.g. 'wp-duotone-blue-orange'.
 	 * @param string $duotone_selector The block's duotone selector. e.g. '.wp-block-image img'.
 	 * @param string $filter_value     The filter CSS value. e.g. 'url(#wp-duotone-blue-orange)' or 'unset'.
@@ -782,6 +869,8 @@ public static function register_duotone_support( $block_type ) {
 	 *
 	 * @param string $block_name The block name.
 	 *
+	 * @internal
+	 *
 	 * @return string The CSS selector or null if there is no support.
 	 */
 	private static function get_selector( $block_name ) {
@@ -1066,6 +1155,8 @@ public static function migrate_experimental_duotone_support_flag( $settings, $me
 	 *
 	 * Exported for the deprecated function wp_get_duotone_filter_id().
 	 *
+	 * @internal
+	 *
 	 * @since 6.3.0
 	 * @deprecated 6.3.0
 	 *