@wordpress/style-engine 1.2.0 → 1.4.0

package/phpunit/class-wp-style-engine-css-rules-store-test.php

@@ -1,188 +0,0 @@
-<?php
-/**
- * Tests the Style Engine CSS Rules Store class.
- *
- * @package    Gutenberg
- * @subpackage style-engine
- */
-
-// Check for the existence of Style Engine classes and methods.
-// Once the Style Engine has been migrated to Core we can remove the if statements and require imports.
-// Testing new features from the Gutenberg package may require
-// testing against `gutenberg_` and `_Gutenberg` functions and methods in the future.
-if ( ! class_exists( 'WP_Style_Engine_CSS_Declarations' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-declarations.php';
-}
-
-if ( ! class_exists( 'WP_Style_Engine_CSS_Rule' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-rule.php';
-}
-
-if ( ! class_exists( 'WP_Style_Engine_CSS_Rules_Store' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-rules-store.php';
-}
-
-/**
- * Tests for registering, storing and retrieving a collection of CSS Rules (a store).
- *
- * @coversDefaultClass WP_Style_Engine_CSS_Rules_Store
- */
-class WP_Style_Engine_CSS_Rules_Store_Test extends WP_UnitTestCase {
-	/**
-	 * Cleans up stores after each test.
-	 */
-	public function tear_down() {
-		WP_Style_Engine_CSS_Rules_Store::remove_all_stores();
-		parent::tear_down();
-	}
-
-	/**
-	 * Tests creating a new store on instantiation.
-	 *
-	 * @covers ::__construct
-	 */
-	public function test_should_create_new_store_on_instantiation() {
-		$new_pancakes_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'pancakes-with-strawberries' );
-
-		$this->assertInstanceOf( 'WP_Style_Engine_CSS_Rules_Store', $new_pancakes_store );
-	}
-
-	/**
-	 * Tests that a `$store_name` argument is required and no store will be created without one.
-	 *
-	 * @covers ::get_store
-	 */
-	public function test_should_not_create_store_without_a_store_name() {
-		$not_a_store = WP_Style_Engine_CSS_Rules_Store::get_store( '' );
-
-		$this->assertEmpty( $not_a_store, 'get_store() did not return an empty value with empty string as argument.' );
-
-		$also_not_a_store = WP_Style_Engine_CSS_Rules_Store::get_store( 123 );
-
-		$this->assertEmpty( $also_not_a_store, 'get_store() did not return an empty value with number as argument.' );
-
-		$definitely_not_a_store = WP_Style_Engine_CSS_Rules_Store::get_store( null );
-
-		$this->assertEmpty( $definitely_not_a_store, 'get_store() did not return an empty value with `null` as argument.' );
-	}
-
-	/**
-	 * Tests returning a previously created store when the same selector key is passed.
-	 *
-	 * @covers ::get_store
-	 */
-	public function test_should_return_existing_store() {
-		$new_fish_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'fish-n-chips' );
-		$selector       = '.haddock';
-
-		$new_fish_store->add_rule( $selector );
-
-		$this->assertSame( $selector, $new_fish_store->add_rule( $selector )->get_selector(), 'Selector string of store rule does not match expected value' );
-
-		$the_same_fish_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'fish-n-chips' );
-
-		$this->assertSame( $selector, $the_same_fish_store->add_rule( $selector )->get_selector(), 'Selector string of existing store rule does not match expected value' );
-	}
-
-	/**
-	 * Tests returning all previously created stores.
-	 *
-	 * @covers ::get_stores
-	 */
-	public function test_should_get_all_existing_stores() {
-		$burrito_store    = WP_Style_Engine_CSS_Rules_Store::get_store( 'burrito' );
-		$quesadilla_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'quesadilla' );
-
-		$this->assertEquals(
-			array(
-				'burrito'    => $burrito_store,
-				'quesadilla' => $quesadilla_store,
-			),
-			WP_Style_Engine_CSS_Rules_Store::get_stores()
-		);
-	}
-
-	/**
-	 * Tests that all previously created stores are deleted.
-	 *
-	 * @covers ::remove_all_stores
-	 */
-	public function test_should_remove_all_stores() {
-		$dolmades_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'dolmades' );
-		$tzatziki_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'tzatziki' );
-
-		$this->assertEquals(
-			array(
-				'dolmades' => $dolmades_store,
-				'tzatziki' => $tzatziki_store,
-			),
-			WP_Style_Engine_CSS_Rules_Store::get_stores(),
-			'Return value of get_stores() does not match expectation'
-		);
-		WP_Style_Engine_CSS_Rules_Store::remove_all_stores();
-
-		$this->assertEquals(
-			array(),
-			WP_Style_Engine_CSS_Rules_Store::get_stores(),
-			'Return value of get_stores() is not an empty array after remove_all_stores() called.'
-		);
-	}
-
-	/**
-	 * Tests adding rules to an existing store.
-	 *
-	 * @covers ::add_rule
-	 */
-	public function test_should_add_rule_to_existing_store() {
-		$new_pie_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'meat-pie' );
-		$selector      = '.wp-block-sauce a:hover';
-		$store_rule    = $new_pie_store->add_rule( $selector );
-		$expected      = '';
-
-		$this->assertSame( $expected, $store_rule->get_css(), 'Return value of get_css() is not a empty string where a rule has no CSS declarations.' );
-
-		$pie_declarations = array(
-			'color'         => 'brown',
-			'border-color'  => 'yellow',
-			'border-radius' => '10rem',
-		);
-		$css_declarations = new WP_Style_Engine_CSS_Declarations( $pie_declarations );
-		$store_rule->add_declarations( $css_declarations );
-
-		$store_rule = $new_pie_store->add_rule( $selector );
-		$expected   = "$selector{{$css_declarations->get_declarations_string()}}";
-
-		$this->assertSame( $expected, $store_rule->get_css(), 'Return value of get_css() does not match expected CSS from existing store rules.' );
-	}
-
-	/**
-	 * Tests that all stored rule objects are returned.
-	 *
-	 * @covers ::get_all_rules
-	 */
-	public function test_should_get_all_rule_objects_for_a_store() {
-		$new_pizza_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'pizza-with-mozzarella' );
-		$selector        = '.wp-block-anchovies a:hover';
-		$store_rule      = $new_pizza_store->add_rule( $selector );
-		$expected        = array(
-			$selector => $store_rule,
-		);
-
-		$this->assertSame( $expected, $new_pizza_store->get_all_rules(), 'Return value for get_all_rules() does not match expectations.' );
-
-		$new_selector             = '.wp-block-mushroom a:hover';
-		$newer_pizza_declarations = array(
-			'padding' => '100px',
-		);
-		$new_store_rule           = $new_pizza_store->add_rule( $new_selector );
-		$css_declarations         = new WP_Style_Engine_CSS_Declarations( $newer_pizza_declarations );
-		$new_store_rule->add_declarations( array( $css_declarations ) );
-
-		$expected = array(
-			$selector     => $store_rule,
-			$new_selector => $new_store_rule,
-		);
-
-		$this->assertSame( $expected, $new_pizza_store->get_all_rules(), 'Return value for get_all_rules() does not match expectations after adding new rules to store.' );
-	}
-}

package/phpunit/class-wp-style-engine-processor-test.php

@@ -1,314 +0,0 @@
-<?php
-/**
- * Tests the Style Engine Processor class.
- *
- * @package    Gutenberg
- * @subpackage style-engine
- */
-
-// Check for the existence of Style Engine classes and methods.
-// Once the Style Engine has been migrated to Core we can remove the if statements and require imports.
-// Testing new features from the Gutenberg package may require
-// testing against `gutenberg_` and `_Gutenberg` functions and methods in the future.
-if ( ! class_exists( 'WP_Style_Engine_Processor' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-processor.php';
-}
-
-if ( ! class_exists( 'WP_Style_Engine_CSS_Declarations' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-declarations.php';
-}
-
-if ( ! class_exists( 'WP_Style_Engine_CSS_Rule' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-rule.php';
-}
-
-if ( ! class_exists( 'WP_Style_Engine_CSS_Rules_Store' ) ) {
-	require __DIR__ . '/../class-wp-style-engine-css-rules-store.php';
-}
-
-/**
- * Tests for compiling and rendering styles from a store of CSS rules.
- *
- * @coversDefaultClass WP_Style_Engine_Processor
- */
-class WP_Style_Engine_Processor_Test extends WP_UnitTestCase {
-	/**
-	 * Tests adding rules and returning compiled CSS rules.
-	 *
-	 * @covers ::add_rules
-	 * @covers ::get_css
-	 */
-	public function test_should_return_rules_as_compiled_css() {
-		$a_nice_css_rule = new WP_Style_Engine_CSS_Rule( '.a-nice-rule' );
-		$a_nice_css_rule->add_declarations(
-			array(
-				'color'            => 'var(--nice-color)',
-				'background-color' => 'purple',
-			)
-		);
-		$a_nicer_css_rule = new WP_Style_Engine_CSS_Rule( '.a-nicer-rule' );
-		$a_nicer_css_rule->add_declarations(
-			array(
-				'font-family'      => 'Nice sans',
-				'font-size'        => '1em',
-				'background-color' => 'purple',
-			)
-		);
-		$a_nice_processor = new WP_Style_Engine_Processor();
-		$a_nice_processor->add_rules( array( $a_nice_css_rule, $a_nicer_css_rule ) );
-
-		$this->assertSame(
-			'.a-nice-rule{color:var(--nice-color);background-color:purple;}.a-nicer-rule{font-family:Nice sans;font-size:1em;background-color:purple;}',
-			$a_nice_processor->get_css( array( 'prettify' => false ) )
-		);
-	}
-
-	/**
-	 * Tests compiling CSS rules and formatting them with new lines and indents.
-	 *
-	 * @covers ::get_css
-	 */
-	public function test_should_return_prettified_css_rules() {
-		$a_wonderful_css_rule = new WP_Style_Engine_CSS_Rule( '.a-wonderful-rule' );
-		$a_wonderful_css_rule->add_declarations(
-			array(
-				'color'            => 'var(--wonderful-color)',
-				'background-color' => 'orange',
-			)
-		);
-		$a_very_wonderful_css_rule = new WP_Style_Engine_CSS_Rule( '.a-very_wonderful-rule' );
-		$a_very_wonderful_css_rule->add_declarations(
-			array(
-				'color'            => 'var(--wonderful-color)',
-				'background-color' => 'orange',
-			)
-		);
-		$a_more_wonderful_css_rule = new WP_Style_Engine_CSS_Rule( '.a-more-wonderful-rule' );
-		$a_more_wonderful_css_rule->add_declarations(
-			array(
-				'font-family'      => 'Wonderful sans',
-				'font-size'        => '1em',
-				'background-color' => 'orange',
-			)
-		);
-		$a_wonderful_processor = new WP_Style_Engine_Processor();
-		$a_wonderful_processor->add_rules( array( $a_wonderful_css_rule, $a_very_wonderful_css_rule, $a_more_wonderful_css_rule ) );
-
-		$expected = '.a-more-wonderful-rule {
-	font-family: Wonderful sans;
-	font-size: 1em;
-	background-color: orange;
-}
-.a-wonderful-rule,
-.a-very_wonderful-rule {
-	color: var(--wonderful-color);
-	background-color: orange;
-}
-';
-		$this->assertSame(
-			$expected,
-			$a_wonderful_processor->get_css( array( 'prettify' => true ) )
-		);
-	}
-
-	/**
-	 * Tests adding a store and compiling CSS rules from that store.
-	 *
-	 * @covers ::add_store
-	 */
-	public function test_should_return_store_rules_as_css() {
-		$a_nice_store = WP_Style_Engine_CSS_Rules_Store::get_store( 'nice' );
-		$a_nice_store->add_rule( '.a-nice-rule' )->add_declarations(
-			array(
-				'color'            => 'var(--nice-color)',
-				'background-color' => 'purple',
-			)
-		);
-		$a_nice_store->add_rule( '.a-nicer-rule' )->add_declarations(
-			array(
-				'font-family'      => 'Nice sans',
-				'font-size'        => '1em',
-				'background-color' => 'purple',
-			)
-		);
-		$a_nice_renderer = new WP_Style_Engine_Processor();
-		$a_nice_renderer->add_store( $a_nice_store );
-		$this->assertSame(
-			'.a-nice-rule{color:var(--nice-color);background-color:purple;}.a-nicer-rule{font-family:Nice sans;font-size:1em;background-color:purple;}',
-			$a_nice_renderer->get_css( array( 'prettify' => false ) )
-		);
-	}
-
-	/**
-	 * Tests that CSS declarations are merged and deduped in the final CSS rules output.
-	 *
-	 * @covers ::add_rules
-	 * @covers ::get_css
-	 */
-	public function test_should_dedupe_and_merge_css_declarations() {
-		$an_excellent_rule      = new WP_Style_Engine_CSS_Rule( '.an-excellent-rule' );
-		$an_excellent_processor = new WP_Style_Engine_Processor();
-		$an_excellent_rule->add_declarations(
-			array(
-				'color'        => 'var(--excellent-color)',
-				'border-style' => 'dotted',
-			)
-		);
-		$an_excellent_processor->add_rules( $an_excellent_rule );
-
-		$another_excellent_rule = new WP_Style_Engine_CSS_Rule( '.an-excellent-rule' );
-		$another_excellent_rule->add_declarations(
-			array(
-				'color'        => 'var(--excellent-color)',
-				'border-style' => 'dotted',
-				'border-color' => 'brown',
-			)
-		);
-		$an_excellent_processor->add_rules( $another_excellent_rule );
-		$this->assertSame(
-			'.an-excellent-rule{color:var(--excellent-color);border-style:dotted;border-color:brown;}',
-			$an_excellent_processor->get_css( array( 'prettify' => false ) ),
-			'Return value of get_css() does not match expectations with new, deduped and merged declarations.'
-		);
-
-		$yet_another_excellent_rule = new WP_Style_Engine_CSS_Rule( '.an-excellent-rule' );
-		$yet_another_excellent_rule->add_declarations(
-			array(
-				'color'        => 'var(--excellent-color)',
-				'border-style' => 'dashed',
-				'border-width' => '2px',
-			)
-		);
-		$an_excellent_processor->add_rules( $yet_another_excellent_rule );
-		$this->assertSame(
-			'.an-excellent-rule{color:var(--excellent-color);border-style:dashed;border-color:brown;border-width:2px;}',
-			$an_excellent_processor->get_css( array( 'prettify' => false ) ),
-			'Return value of get_css() does not match expectations with deduped and merged declarations.'
-		);
-	}
-
-	/**
-	 * Tests printing out 'unoptimized' CSS, that is, uncombined selectors and duplicate CSS rules.
-	 *
-	 * @covers ::get_css
-	 */
-	public function test_should_not_optimize_css_output() {
-		$a_sweet_rule = new WP_Style_Engine_CSS_Rule(
-			'.a-sweet-rule',
-			array(
-				'color'            => 'var(--sweet-color)',
-				'background-color' => 'purple',
-			)
-		);
-
-		$a_sweeter_rule = new WP_Style_Engine_CSS_Rule(
-			'#an-even-sweeter-rule > marquee',
-			array(
-				'color'            => 'var(--sweet-color)',
-				'background-color' => 'purple',
-			)
-		);
-
-		$the_sweetest_rule = new WP_Style_Engine_CSS_Rule(
-			'.the-sweetest-rule-of-all a',
-			array(
-				'color'            => 'var(--sweet-color)',
-				'background-color' => 'purple',
-			)
-		);
-
-		$a_sweet_processor = new WP_Style_Engine_Processor();
-		$a_sweet_processor->add_rules( array( $a_sweet_rule, $a_sweeter_rule, $the_sweetest_rule ) );
-
-		$this->assertSame(
-			'.a-sweet-rule{color:var(--sweet-color);background-color:purple;}#an-even-sweeter-rule > marquee{color:var(--sweet-color);background-color:purple;}.the-sweetest-rule-of-all a{color:var(--sweet-color);background-color:purple;}',
-			$a_sweet_processor->get_css(
-				array(
-					'optimize' => false,
-					'prettify' => false,
-				)
-			)
-		);
-	}
-
-	/**
-	 * Tests that 'optimized' CSS is output, that is, that duplicate CSS rules are combined under their corresponding selectors.
-	 *
-	 * @covers ::get_css
-	 */
-	public function test_should_optimize_css_output_by_default() {
-		$a_sweet_rule = new WP_Style_Engine_CSS_Rule(
-			'.a-sweet-rule',
-			array(
-				'color'            => 'var(--sweet-color)',
-				'background-color' => 'purple',
-			)
-		);
-
-		$a_sweeter_rule = new WP_Style_Engine_CSS_Rule(
-			'#an-even-sweeter-rule > marquee',
-			array(
-				'color'            => 'var(--sweet-color)',
-				'background-color' => 'purple',
-			)
-		);
-
-		$a_sweet_processor = new WP_Style_Engine_Processor();
-		$a_sweet_processor->add_rules( array( $a_sweet_rule, $a_sweeter_rule ) );
-
-		$this->assertSame(
-			'.a-sweet-rule,#an-even-sweeter-rule > marquee{color:var(--sweet-color);background-color:purple;}',
-			$a_sweet_processor->get_css( array( 'prettify' => false ) )
-		);
-	}
-
-	/**
-	 * Tests that incoming CSS rules are merged with existing CSS rules.
-	 *
-	 * @covers ::add_rules
-	 */
-	public function test_should_combine_previously_added_css_rules() {
-		$a_lovely_processor = new WP_Style_Engine_Processor();
-		$a_lovely_rule      = new WP_Style_Engine_CSS_Rule(
-			'.a-lovely-rule',
-			array(
-				'border-color' => 'purple',
-			)
-		);
-		$a_lovely_processor->add_rules( $a_lovely_rule );
-		$a_lovelier_rule = new WP_Style_Engine_CSS_Rule(
-			'.a-lovelier-rule',
-			array(
-				'border-color' => 'purple',
-			)
-		);
-		$a_lovely_processor->add_rules( $a_lovelier_rule );
-		$this->assertSame(
-			'.a-lovely-rule,.a-lovelier-rule{border-color:purple;}',
-			$a_lovely_processor->get_css( array( 'prettify' => false ) ),
-			'Return value of get_css() does not match expectations when combining 2 CSS rules'
-		);
-
-		$a_most_lovely_rule = new WP_Style_Engine_CSS_Rule(
-			'.a-most-lovely-rule',
-			array(
-				'border-color' => 'purple',
-			)
-		);
-		$a_lovely_processor->add_rules( $a_most_lovely_rule );
-
-		$a_perfectly_lovely_rule = new WP_Style_Engine_CSS_Rule(
-			'.a-perfectly-lovely-rule',
-			array(
-				'border-color' => 'purple',
-			)
-		);
-		$a_lovely_processor->add_rules( $a_perfectly_lovely_rule );
-
-		$this->assertSame(
-			'.a-lovely-rule,.a-lovelier-rule,.a-most-lovely-rule,.a-perfectly-lovely-rule{border-color:purple;}',
-			$a_lovely_processor->get_css( array( 'prettify' => false ) ),
-			'Return value of get_css() does not match expectations when combining 4 CSS rules'
-		);
-	}
-}