@wordpress/style-engine 0.14.0 → 0.14.1-next.d6164808d3.0

package/build-types/styles/color/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/color/index.ts"],"names":[],"mappings":";;;;;;;;AAOA,wBAA8C"}

package/build-types/styles/color/text.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internal dependencies
+ */
+import type { Style, StyleOptions } from '../../types';
+declare const text: {
+    name: string;
+    generate: (style: Style, options: StyleOptions) => {
+        selector: string | undefined;
+        key: string;
+        value: string;
+    }[];
+};
+export default text;
+//# sourceMappingURL=text.d.ts.map

package/build-types/styles/color/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/styles/color/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvD,QAAA,MAAM,IAAI;;sBAEU,KAAK,WAAW,YAAY;;;;;CAG/C,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build-types/styles/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const VARIABLE_REFERENCE_PREFIX = "var:";
+export declare const VARIABLE_PATH_SEPARATOR_TOKEN_ATTRIBUTE = "|";
+export declare const VARIABLE_PATH_SEPARATOR_TOKEN_STYLE = "--";
+//# sourceMappingURL=constants.d.ts.map

package/build-types/styles/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/styles/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAC3D,eAAO,MAAM,mCAAmC,OAAO,CAAC"}

package/build-types/styles/index.d.ts

@@ -0,0 +1,5 @@
+export declare const styleDefinitions: (import("../types").StyleDefinition | {
+    name: string;
+    generate: (style: import("../types").Style, options: import("../types").StyleOptions) => import("../types").GeneratedCSSRule[];
+})[];
+//# sourceMappingURL=index.d.ts.map

package/build-types/styles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styles/index.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB;;;IAK5B,CAAC"}

package/build-types/styles/spacing/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    name: string;
+    generate: (style: import("../../types").Style, options: import("../../types").StyleOptions) => import("../../types").GeneratedCSSRule[];
+}[];
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/build-types/styles/spacing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/spacing/index.ts"],"names":[],"mappings":";;;;AAMA,wBAAmC"}

package/build-types/styles/spacing/margin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal dependencies
+ */
+import type { Style, StyleOptions } from '../../types';
+declare const margin: {
+    name: string;
+    generate: (style: Style, options: StyleOptions) => import("../../types").GeneratedCSSRule[];
+};
+export default margin;
+//# sourceMappingURL=margin.d.ts.map

package/build-types/styles/spacing/margin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"margin.d.ts","sourceRoot":"","sources":["../../../src/styles/spacing/margin.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvD,QAAA,MAAM,MAAM;;sBAEQ,KAAK,WAAW,YAAY;CAM/C,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/build-types/styles/spacing/padding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal dependencies
+ */
+import type { Style, StyleOptions } from '../../types';
+declare const padding: {
+    name: string;
+    generate: (style: Style, options: StyleOptions) => import("../../types").GeneratedCSSRule[];
+};
+export default padding;
+//# sourceMappingURL=padding.d.ts.map

package/build-types/styles/spacing/padding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding.d.ts","sourceRoot":"","sources":["../../../src/styles/spacing/padding.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvD,QAAA,MAAM,OAAO;;sBAEO,KAAK,WAAW,YAAY;CAM/C,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/build-types/styles/typography/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internal dependencies
+ */
+import type { Style, StyleOptions } from '../../types';
+declare const _default: {
+    name: string;
+    generate: (style: Style, options: StyleOptions) => {
+        selector: string | undefined;
+        key: string;
+        value: string;
+    }[];
+}[];
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/build-types/styles/typography/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/typography/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;;;;;;;;;AAmGvD,wBASE"}

package/build-types/styles/utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Internal dependencies
+ */
+import type { CssRulesKeys, GeneratedCSSRule, Style, StyleOptions } from '../types';
+/**
+ * Returns a JSON representation of the generated CSS rules.
+ *
+ * @param  style   Style object.
+ * @param  options Options object with settings to adjust how the styles are generated.
+ * @param  path    An array of strings representing the path to the style value in the style object.
+ * @param  ruleKey A CSS property key.
+ *
+ * @return GeneratedCSSRule[] CSS rules.
+ */
+export declare function generateRule(style: Style, options: StyleOptions, path: string[], ruleKey: string): {
+    selector: string | undefined;
+    key: string;
+    value: string;
+}[];
+/**
+ * Returns a JSON representation of the generated CSS rules taking into account box model properties, top, right, bottom, left.
+ *
+ * @param  style                Style object.
+ * @param  options              Options object with settings to adjust how the styles are generated.
+ * @param  path                 An array of strings representing the path to the style value in the style object.
+ * @param  ruleKeys             An array of CSS property keys and patterns.
+ * @param  individualProperties The "sides" or individual properties for which to generate rules.
+ *
+ * @return GeneratedCSSRule[]  CSS rules.
+ */
+export declare function generateBoxRules(style: Style, options: StyleOptions, path: string[], ruleKeys: CssRulesKeys, individualProperties?: string[]): GeneratedCSSRule[];
+/**
+ * Returns a CSS var value from incoming style value following the pattern `var:description|context|slug`.
+ *
+ * @param  styleValue A raw style value.
+ *
+ * @return string A CSS var value.
+ */
+export declare function getCSSVarFromStyleValue(styleValue: string): string;
+/**
+ * Capitalizes the first letter in a string.
+ *
+ * @param {string} str The string whose first letter the function will capitalize.
+ *
+ * @return string A CSS var value.
+ */
+export declare function upperFirst([firstLetter, ...rest]: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/build-types/styles/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/styles/utils.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAChB,KAAK,EAEL,YAAY,EACZ,MAAM,UAAU,CAAC;AAOlB;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM;;;;IAaf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,YAAY,EACtB,oBAAoB,GAAE,MAAM,EAAyC,GACnE,gBAAgB,EAAE,CAqCpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAE,UAAU,EAAE,MAAM,GAAI,MAAM,CAYpE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAE,CAAE,WAAW,EAAE,GAAG,IAAI,CAAE,EAAE,MAAM,UAE3D"}

package/build-types/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * External dependencies
+ */
+import type { CSSProperties } from 'react';
+declare type BoxVariants = 'margin' | 'padding' | undefined;
+export declare type Box<T extends BoxVariants = undefined> = {
+    top?: CSSProperties[T extends undefined ? 'top' : `${T}Top`];
+    right?: CSSProperties[T extends undefined ? 'right' : `${T}Right`];
+    bottom?: CSSProperties[T extends undefined ? 'bottom' : `${T}Bottom`];
+    left?: CSSProperties[T extends undefined ? 'left' : `${T}Left`];
+};
+export declare type BorderIndividualProperty = 'top' | 'right' | 'bottom' | 'left';
+export declare type BorderIndividualStyles<T extends BorderIndividualProperty> = {
+    color?: CSSProperties[`border${Capitalize<string & T>}Color`];
+    style?: CSSProperties[`border${Capitalize<string & T>}Style`];
+    width?: CSSProperties[`border${Capitalize<string & T>}Width`];
+};
+export interface Style {
+    border?: {
+        color?: CSSProperties['borderColor'];
+        radius?: CSSProperties['borderRadius'] | {
+            topLeft?: CSSProperties['borderTopLeftRadius'];
+            topRight?: CSSProperties['borderTopRightRadius'];
+            bottomLeft?: CSSProperties['borderBottomLeftRadius'];
+            bottomRight?: CSSProperties['borderBottomLeftRadius'];
+        };
+        style?: CSSProperties['borderStyle'];
+        width?: CSSProperties['borderWidth'];
+        top?: BorderIndividualStyles<'top'>;
+        right?: BorderIndividualStyles<'right'>;
+        bottom?: BorderIndividualStyles<'bottom'>;
+        left?: BorderIndividualStyles<'left'>;
+    };
+    spacing?: {
+        margin?: CSSProperties['margin'] | Box<'margin'>;
+        padding?: CSSProperties['padding'] | Box<'padding'>;
+    };
+    typography?: {
+        fontSize?: CSSProperties['fontSize'];
+        fontFamily?: CSSProperties['fontFamily'];
+        fontWeight?: CSSProperties['fontWeight'];
+        fontStyle?: CSSProperties['fontStyle'];
+        letterSpacing?: CSSProperties['letterSpacing'];
+        lineHeight?: CSSProperties['lineHeight'];
+        textDecoration?: CSSProperties['textDecoration'];
+        textTransform?: CSSProperties['textTransform'];
+    };
+    color?: {
+        text?: CSSProperties['color'];
+        background?: CSSProperties['backgroundColor'];
+        gradient?: CSSProperties['background'];
+    };
+    elements?: {
+        link?: {
+            color?: {
+                text?: CSSProperties['color'];
+            };
+        };
+    };
+}
+export declare type CssRulesKeys = {
+    default: string;
+    individual: string;
+};
+export declare type StyleOptions = {
+    /**
+     * CSS selector for the generated style.
+     */
+    selector?: string;
+};
+export declare type GeneratedCSSRule = {
+    selector?: string;
+    value: string;
+    /**
+     * The CSS key in JS style attribute format, compatible with React.
+     * E.g. `paddingTop` instead of `padding-top`.
+     */
+    key: string;
+};
+export interface StyleDefinition {
+    name: string;
+    generate?: (style: Style, options: StyleOptions | {}, path?: string[], ruleKey?: string) => GeneratedCSSRule[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/build-types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/class-wp-style-engine-css-declarations.php

@@ -34,9 +34,6 @@ class WP_Style_Engine_CSS_Declarations {
 	 * @param array $declarations An array of declarations (property => value pairs).
 	 */
 	public function __construct( $declarations = array() ) {
-		if ( empty( $declarations ) ) {
-			return;
-		}
 		$this->add_declarations( $declarations );
 	}
 
@@ -46,7 +43,7 @@ class WP_Style_Engine_CSS_Declarations {
 	 * @param string $property The CSS property.
 	 * @param string $value    The CSS value.
 	 *
-	 * @return void
+	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.
 	 */
 	public function add_declaration( $property, $value ) {
 
@@ -54,17 +51,19 @@ class WP_Style_Engine_CSS_Declarations {
 		$property = $this->sanitize_property( $property );
 		// Bail early if the property is empty.
 		if ( empty( $property ) ) {
-			return;
+			return $this;
 		}
 
 		// Trim the value. If empty, bail early.
 		$value = trim( $value );
 		if ( '' === $value ) {
-			return;
+			return $this;
 		}
 
 		// Add the declaration property/value pair.
 		$this->declarations[ $property ] = $value;
+
+		return $this;
 	}
 
 	/**
@@ -72,10 +71,11 @@ class WP_Style_Engine_CSS_Declarations {
 	 *
 	 * @param string $property The CSS property.
 	 *
-	 * @return void
+	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.
 	 */
 	public function remove_declaration( $property ) {
 		unset( $this->declarations[ $property ] );
+		return $this;
 	}
 
 	/**
@@ -83,25 +83,27 @@ class WP_Style_Engine_CSS_Declarations {
 	 *
 	 * @param array $declarations An array of declarations.
 	 *
-	 * @return void
+	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.
 	 */
 	public function add_declarations( $declarations ) {
 		foreach ( $declarations as $property => $value ) {
 			$this->add_declaration( $property, $value );
 		}
+		return $this;
 	}
 
 	/**
 	 * Remove multiple declarations.
 	 *
-	 * @param array $declarations An array of properties.
+	 * @param array $properties An array of properties.
 	 *
-	 * @return void
+	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.
 	 */
-	public function remove_declarations( $declarations = array() ) {
-		foreach ( $declarations as $property ) {
+	public function remove_declarations( $properties = array() ) {
+		foreach ( $properties as $property ) {
 			$this->remove_declaration( $property );
 		}
+		return $this;
 	}
 
 	/**
@@ -123,8 +125,9 @@ class WP_Style_Engine_CSS_Declarations {
 	 * @return string The filtered declaration as a single string.
 	 */
 	protected static function filter_declaration( $property, $value, $spacer = '' ) {
-		if ( isset( $property ) && isset( $value ) ) {
-			return safecss_filter_attr( "{$property}:{$spacer}{$value}" );
+		$filtered_value = wp_strip_all_tags( $value, true );
+		if ( '' !== $filtered_value ) {
+			return safecss_filter_attr( "{$property}:{$spacer}{$filtered_value}" );
 		}
 		return '';
 	}
@@ -143,9 +146,9 @@ class WP_Style_Engine_CSS_Declarations {
 		$indent              = $should_prettify ? str_repeat( "\t", $indent_count ) : '';
 		$suffix              = $should_prettify ? ' ' : '';
 		$suffix              = $should_prettify && $indent_count > 0 ? "\n" : $suffix;
+		$spacer              = $should_prettify ? ' ' : '';
 
 		foreach ( $declarations_array as $property => $value ) {
-			$spacer               = $should_prettify ? ' ' : '';
 			$filtered_declaration = static::filter_declaration( $property, $value, $spacer );
 			if ( $filtered_declaration ) {
 				$declarations_output .= "{$indent}{$filtered_declaration};$suffix";

package/class-wp-style-engine-css-rule.php

@@ -51,14 +51,10 @@ class WP_Style_Engine_CSS_Rule {
 	 *
 	 * @param string $selector The CSS selector.
 	 *
-	 * @return WP_Style_Engine_CSS_Rule|void Returns the object to allow chaining of methods.
+	 * @return WP_Style_Engine_CSS_Rule Returns the object to allow chaining of methods.
 	 */
 	public function set_selector( $selector ) {
-		if ( empty( $selector ) ) {
-			return;
-		}
 		$this->selector = $selector;
-
 		return $this;
 	}
 
@@ -74,11 +70,11 @@ class WP_Style_Engine_CSS_Rule {
 		$is_declarations_object = ! is_array( $declarations );
 		$declarations_array     = $is_declarations_object ? $declarations->get_declarations() : $declarations;
 
-		if ( null === $this->declarations && $is_declarations_object ) {
-			$this->declarations = $declarations;
-			return $this;
-		}
 		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 );

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

@@ -27,7 +27,6 @@ class WP_Style_Engine_CSS_Rules_Store {
 	 */
 	protected static $stores = array();
 
-
 	/**
 	 * The store name.
 	 *
@@ -47,9 +46,12 @@ class WP_Style_Engine_CSS_Rules_Store {
 	 *
 	 * @param string $store_name The name of the store.
 	 *
-	 * @return WP_Style_Engine_CSS_Rules_Store
+	 * @return WP_Style_Engine_CSS_Rules_Store|void
 	 */
 	public static function get_store( $store_name = 'default' ) {
+		if ( ! is_string( $store_name ) || empty( $store_name ) ) {
+			return;
+		}
 		if ( ! isset( static::$stores[ $store_name ] ) ) {
 			static::$stores[ $store_name ] = new static();
 			// Set the store name.
@@ -111,10 +113,9 @@ class WP_Style_Engine_CSS_Rules_Store {
 	 *
 	 * @param string $selector The CSS selector.
 	 *
-	 * @return WP_Style_Engine_CSS_Rule|null Returns a WP_Style_Engine_CSS_Rule object, or null if the selector is empty.
+	 * @return WP_Style_Engine_CSS_Rule|void Returns a WP_Style_Engine_CSS_Rule object, or null if the selector is empty.
 	 */
 	public function add_rule( $selector ) {
-
 		$selector = trim( $selector );
 
 		// Bail early if there is no selector.

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

@@ -36,15 +36,21 @@ class WP_Style_Engine_Processor {
 	 * Add a store to the processor.
 	 *
 	 * @param WP_Style_Engine_CSS_Rules_Store $store The store to add.
+	 *
+	 * @return WP_Style_Engine_Processor Returns the object to allow chaining methods.
 	 */
 	public function add_store( WP_Style_Engine_CSS_Rules_Store $store ) {
 		$this->stores[ $store->get_name() ] = $store;
+
+		return $this;
 	}
 
 	/**
 	 * Adds rules to be processed.
 	 *
 	 * @param WP_Style_Engine_CSS_Rule|WP_Style_Engine_CSS_Rule[] $css_rules A single, or an array of, WP_Style_Engine_CSS_Rule objects from a store or otherwise.
+	 *
+	 * @return WP_Style_Engine_Processor Returns the object to allow chaining methods.
 	 */
 	public function add_rules( $css_rules ) {
 		if ( ! is_array( $css_rules ) ) {
@@ -58,6 +64,8 @@ class WP_Style_Engine_Processor {
 			}
 			$this->css_rules[ $rule->get_selector() ] = $rule;
 		}
+
+		return $this;
 	}
 
 	/**
@@ -73,7 +81,7 @@ class WP_Style_Engine_Processor {
 	public function get_css( $options = array() ) {
 		$defaults = array(
 			'optimize' => true,
-			'prettify' => false,
+			'prettify' => defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG,
 		);
 		$options  = wp_parse_args( $options, $defaults );