Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 139 insertions, 0 deletions

diff --git a/wp-includes/style-engine/class-wp-style-engine-css-rule.php b/wp-includes/style-engine/class-wp-style-engine-css-rule.php
new file mode 100644
index 0000000..2b31cff
--- /dev/null
+++ b/wp-includes/style-engine/class-wp-style-engine-css-rule.php
@@ -0,0 +1,139 @@
+<?php
+/**
+ * Style Engine: WP_Style_Engine_CSS_Rule class
+ *
+ * @package WordPress
+ * @subpackage StyleEngine
+ * @since 6.1.0
+ */
+
+/**
+ * Core class used for style engine CSS rules.
+ *
+ * Holds, sanitizes, processes, and prints CSS declarations for the style engine.
+ *
+ * @since 6.1.0
+ */
+#[AllowDynamicProperties]
+class WP_Style_Engine_CSS_Rule {
+
+	/**
+	 * The selector.
+	 *
+	 * @since 6.1.0
+	 * @var string
+	 */
+	protected $selector;
+
+	/**
+	 * The selector declarations.
+	 *
+	 * Contains a WP_Style_Engine_CSS_Declarations object.
+	 *
+	 * @since 6.1.0
+	 * @var WP_Style_Engine_CSS_Declarations
+	 */
+	protected $declarations;
+
+	/**
+	 * Constructor.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @param string                                    $selector     Optional. The CSS selector. Default empty string.
+	 * @param string[]|WP_Style_Engine_CSS_Declarations $declarations Optional. An associative array of CSS definitions,
+	 *                                                                e.g. `array( "$property" => "$value", "$property" => "$value" )`,
+	 *                                                                or a WP_Style_Engine_CSS_Declarations object.
+	 *                                                                Default empty array.
+	 */
+	public function __construct( $selector = '', $declarations = array() ) {
+		$this->set_selector( $selector );
+		$this->add_declarations( $declarations );
+	}
+
+	/**
+	 * Sets the selector.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @param string $selector The CSS selector.
+	 * @return WP_Style_Engine_CSS_Rule Returns the object to allow chaining of methods.
+	 */
+	public function set_selector( $selector ) {
+		$this->selector = $selector;
+		return $this;
+	}
+
+	/**
+	 * Sets the declarations.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @param string[]|WP_Style_Engine_CSS_Declarations $declarations An array of declarations (property => value pairs),
+	 *                                                                or a WP_Style_Engine_CSS_Declarations object.
+	 * @return WP_Style_Engine_CSS_Rule Returns the object to allow chaining of methods.
+	 */
+	public function add_declarations( $declarations ) {
+		$is_declarations_object = ! is_array( $declarations );
+		$declarations_array     = $is_declarations_object ? $declarations->get_declarations() : $declarations;
+
+		if ( null === $this->declarations ) {
+			if ( $is_declarations_object ) {
+				$this->declarations = $declarations;
+				return $this;
+			}
+			$this->declarations = new WP_Style_Engine_CSS_Declarations( $declarations_array );
+		}
+		$this->declarations->add_declarations( $declarations_array );
+
+		return $this;
+	}
+
+	/**
+	 * Gets the declarations object.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @return WP_Style_Engine_CSS_Declarations The declarations object.
+	 */
+	public function get_declarations() {
+		return $this->declarations;
+	}
+
+	/**
+	 * Gets the full selector.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @return string
+	 */
+	public function get_selector() {
+		return $this->selector;
+	}
+
+	/**
+	 * Gets the CSS.
+	 *
+	 * @since 6.1.0
+	 *
+	 * @param bool $should_prettify Optional. Whether to add spacing, new lines and indents.
+	 *                              Default false.
+	 * @param int  $indent_count    Optional. The number of tab indents to apply to the rule.
+	 *                              Applies if `prettify` is `true`. Default 0.
+	 * @return string
+	 */
+	public function get_css( $should_prettify = false, $indent_count = 0 ) {
+		$rule_indent         = $should_prettify ? str_repeat( "\t", $indent_count ) : '';
+		$declarations_indent = $should_prettify ? $indent_count + 1 : 0;
+		$suffix              = $should_prettify ? "\n" : '';
+		$spacer              = $should_prettify ? ' ' : '';
+		$selector            = $should_prettify ? str_replace( ',', ",\n", $this->get_selector() ) : $this->get_selector();
+		$css_declarations    = $this->declarations->get_declarations_string( $should_prettify, $declarations_indent );
+
+		if ( empty( $css_declarations ) ) {
+			return '';
+		}
+
+		return "{$rule_indent}{$selector}{$spacer}{{$suffix}{$css_declarations}{$suffix}{$rule_indent}}";
+	}
+}