<?php
/**
 * Style engine: Public functions
 *
 * This file contains a variety of public functions developers can use to interact with
 * the Style Engine API.
 *
 * @package WordPress
 * @subpackage StyleEngine
 * @since 6.1.0
 */

/**
 * Global public interface method to generate styles from a single style object,
 * e.g. the value of a block's attributes.style object or the top level styles in theme.json.
 *
 * Example usage:
 *
 *     $styles = wp_style_engine_get_styles(
 *         array(
 *             'color' => array( 'text' => '#cccccc' ),
 *         )
 *     );
 *
 * Returns:
 *
 *     array(
 *         'css'          => 'color: #cccccc',
 *         'declarations' => array( 'color' => '#cccccc' ),
 *         'classnames'   => 'has-color',
 *     )
 *
 * @since 6.1.0
 *
 * @see https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/#styles
 * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/
 *
 * @param array $block_styles The style object.
 * @param array $options {
 *     Optional. An array of options. Default empty array.
 *
 *     @type string|null $context                    An identifier describing the origin of the style object,
 *                                                   e.g. 'block-supports' or 'global-styles'. Default null.
 *                                                   When set, the style engine will attempt to store the CSS rules,
 *                                                   where a selector is also passed.
 *     @type bool        $convert_vars_to_classnames Whether to skip converting incoming CSS var patterns,
 *                                                   e.g. `var:preset|<PRESET_TYPE>|<PRESET_SLUG>`,
 *                                                   to `var( --wp--preset--* )` values. Default false.
 *     @type string      $selector                   Optional. When a selector is passed,
 *                                                   the value of `$css` in the return value will comprise
 *                                                   a full CSS rule `$selector { ...$css_declarations }`,
 *                                                   otherwise, the value will be a concatenated string
 *                                                   of CSS declarations.
 * }
 * @return array {
 *     @type string   $css          A CSS ruleset or declarations block
 *                                  formatted to be placed in an HTML `style` attribute or tag.
 *     @type string[] $declarations An associative array of CSS definitions,
 *                                  e.g. `array( "$property" => "$value", "$property" => "$value" )`.
 *     @type string   $classnames   Classnames separated by a space.
 * }
 */
function wp_style_engine_get_styles( $block_styles, $options = array() ) {
	$options = wp_parse_args(
		$options,
		array(
			'selector'                   => null,
			'context'                    => null,
			'convert_vars_to_classnames' => false,
		)
	);

$parsed_styles = WP_Style_Engine::parse_block_styles( $block_styles, $options );

// Output.
	$styles_output = array();

if ( ! empty( $parsed_styles['declarations'] ) ) {
		$styles_output['css']          = WP_Style_Engine::compile_css( $parsed_styles['declarations'], $options['selector'] );
		$styles_output['declarations'] = $parsed_styles['declarations'];
		if ( ! empty( $options['context'] ) ) {
			WP_Style_Engine::store_css_rule( $options['context'], $options['selector'], $parsed_styles['declarations'] );
		}
	}

if ( ! empty( $parsed_styles['classnames'] ) ) {
		$styles_output['classnames'] = implode( ' ', array_unique( $parsed_styles['classnames'] ) );
	}

return array_filter( $styles_output );
}

/**
 * Returns compiled CSS from a collection of selectors and declarations.
 * Useful for returning a compiled stylesheet from any collection of CSS selector + declarations.
 *
 * Example usage:
 *
 *     $css_rules = array(
 *         array(
 *             'selector'     => '.elephant-are-cool',
 *             'declarations' => array(
 *                 'color' => 'gray',
 *                 'width' => '3em',
 *             ),
 *         ),
 *     );
 *
 *     $css = wp_style_engine_get_stylesheet_from_css_rules( $css_rules );
 *
 * Returns:
 *
 *     .elephant-are-cool{color:gray;width:3em}
 *
 * @since 6.1.0
 * @since 6.6.0 Added support for `$rules_group` in the `$css_rules` array.
 *
 * @param array $css_rules {
 *     Required. A collection of CSS rules.
 *
 *     @type array ...$0 {
 *         @type string   $rules_group  A parent CSS selector in the case of nested CSS,
 *                                      or a CSS nested @rule, such as `@media (min-width: 80rem)` or `@layer module`.
 *         @type string   $selector     A CSS selector.
 *         @type string[] $declarations An associative array of CSS definitions,
 *                                      e.g. `array( "$property" => "$value", "$property" => "$value" )`.
 *     }
 * }
 * @param array $options {
 *     Optional. An array of options. Default empty array.
 *
 *     @type string|null $context  An identifier describing the origin of the style object,
 *                                 e.g. 'block-supports' or 'global-styles'. Default 'block-supports'.
 *                                 When set, the style engine will attempt to store the CSS rules.
 *     @type bool        $optimize Whether to optimize the CSS output, e.g. combine rules.
 *                                 Default false.
 *     @type bool        $prettify Whether to add new lines and indents to output.
 *                                 Defaults to whether the `SCRIPT_DEBUG` constant is defined.
 * }
 * @return string A string of compiled CSS declarations, or empty string.
 */
function wp_style_engine_get_stylesheet_from_css_rules( $css_rules, $options = array() ) {
	if ( empty( $css_rules ) ) {
		return '';
	}

$options = wp_parse_args(
		$options,
		array(
			'context' => null,
		)
	);

$css_rule_objects = array();
	foreach ( $css_rules as $css_rule ) {
		if ( empty( $css_rule['selector'] ) || empty( $css_rule['declarations'] ) || ! is_array( $css_rule['declarations'] ) ) {
			continue;
		}

$rules_group = $css_rule['rules_group'] ?? null;
		if ( ! empty( $options['context'] ) ) {
			WP_Style_Engine::store_css_rule( $options['context'], $css_rule['selector'], $css_rule['declarations'], $rules_group );
		}

$css_rule_objects[] = new WP_Style_Engine_CSS_Rule( $css_rule['selector'], $css_rule['declarations'], $rules_group );
	}

if ( empty( $css_rule_objects ) ) {
		return '';
	}

return WP_Style_Engine::compile_stylesheet_from_css_rules( $css_rule_objects, $options );
}

/**
 * Returns compiled CSS from a store, if found.
 *
 * @since 6.1.0
 *
 * @param string $context A valid context name, corresponding to an existing store key.
 * @param array  $options {
 *     Optional. An array of options. Default empty array.
 *
 *     @type bool $optimize Whether to optimize the CSS output, e.g. combine rules.
 *                          Default false.
 *     @type bool $prettify Whether to add new lines and indents to output.
 *                          Defaults to whether the `SCRIPT_DEBUG` constant is defined.
 * }
 * @return string A compiled CSS string.
 */
function wp_style_engine_get_stylesheet_from_context( $context, $options = array() ) {
	return WP_Style_Engine::compile_stylesheet_from_css_rules( WP_Style_Engine::get_store( $context )->get_all_rules(), $options );
}

Nama File / Folder	Size	Action
ID3	--	NONE
IXR	--	NONE
PHPMailer	--	NONE
Requests	--	NONE
SimplePie	--	NONE
Text	--	NONE
abilities-api	--	NONE
assets	--	NONE
block-bindings	--	NONE
block-patterns	--	NONE
block-supports	--	NONE
blocks	--	NONE
certificates	--	NONE
css	--	NONE
customize	--	NONE
fonts	--	NONE
html-api	--	NONE
images	--	NONE
interactivity-api	--	NONE
js	--	NONE
l10n	--	NONE
php-compat	--	NONE
pomo	--	NONE
rest-api	--	NONE
sitemaps	--	NONE
sodium_compat	--	NONE
style-engine	--	NONE
theme-compat	--	NONE
widgets	--	NONE
adminfuns.php	5.954KB	Hapus Edit Rename
block-editor.php	28.596KB	Hapus Edit Rename
block-template.php	14.999KB	Hapus Edit Rename
bookmark-template.php	12.469KB	Hapus Edit Rename
class-avif-info.php	28.921KB	Hapus Edit Rename
class-feed.php	0.526KB	Hapus Edit Rename
class-simplepie.php	0.442KB	Hapus Edit Rename
class-snoopy.php	36.831KB	Hapus Edit Rename
class-walker-category-dropdown.php	2.411KB	Hapus Edit Rename
class-walker-nav-menu.php	11.762KB	Hapus Edit Rename
class-walker-page-dropdown.php	2.646KB	Hapus Edit Rename
class-wp-application-passwords.php	16.698KB	Hapus Edit Rename
class-wp-block-bindings-registry.php	8.283KB	Hapus Edit Rename
class-wp-block-bindings-source.php	2.922KB	Hapus Edit Rename
class-wp-block-editor-context.php	1.318KB	Hapus Edit Rename
class-wp-block-metadata-registry.php	11.616KB	Hapus Edit Rename
class-wp-block-parser-block.php	2.495KB	Hapus Edit Rename
class-wp-block-parser-frame.php	1.97KB	Hapus Edit Rename
class-wp-block-parser.php	11.246KB	Hapus Edit Rename
class-wp-block-pattern-categories-registry.php	5.322KB	Hapus Edit Rename
class-wp-block-patterns-registry.php	10.989KB	Hapus Edit Rename
class-wp-block-styles-registry.php	6.345KB	Hapus Edit Rename
class-wp-block-template.php	1.985KB	Hapus Edit Rename
class-wp-block-templates-registry.php	7.024KB	Hapus Edit Rename
class-wp-block-type-registry.php	4.912KB	Hapus Edit Rename
class-wp-classic-to-block-menu-converter.php	3.975KB	Hapus Edit Rename
class-wp-comment-query.php	47.66KB	Hapus Edit Rename
class-wp-customize-control.php	25.507KB	Hapus Edit Rename
class-wp-customize-manager.php	198.378KB	Hapus Edit Rename
class-wp-customize-nav-menus.php	56.653KB	Hapus Edit Rename
class-wp-customize-panel.php	10.459KB	Hapus Edit Rename
class-wp-customize-section.php	10.946KB	Hapus Edit Rename
class-wp-customize-setting.php	29.26KB	Hapus Edit Rename
class-wp-customize-widgets.php	70.905KB	Hapus Edit Rename
class-wp-fatal-error-handler.php	7.959KB	Hapus Edit Rename
class-wp-feed-cache-transient.php	3.227KB	Hapus Edit Rename
class-wp-feed-cache.php	0.946KB	Hapus Edit Rename
class-wp-http-curl.php	12.95KB	Hapus Edit Rename
class-wp-http-encoding.php	6.532KB	Hapus Edit Rename
class-wp-http-ixr-client.php	3.424KB	Hapus Edit Rename
class-wp-http-proxy.php	5.84KB	Hapus Edit Rename
class-wp-http-requests-hooks.php	1.975KB	Hapus Edit Rename
class-wp-http-requests-response.php	4.297KB	Hapus Edit Rename
class-wp-http-response.php	2.907KB	Hapus Edit Rename
class-wp-http-streams.php	16.464KB	Hapus Edit Rename
class-wp-image-editor-gd.php	20.22KB	Hapus Edit Rename
class-wp-image-editor-imagick.php	36.11KB	Hapus Edit Rename
class-wp-image-editor.php	17.007KB	Hapus Edit Rename
class-wp-list-util.php	7.269KB	Hapus Edit Rename
class-wp-metadata-lazyloader.php	6.673KB	Hapus Edit Rename
class-wp-navigation-fallback.php	8.978KB	Hapus Edit Rename
class-wp-network-query.php	19.421KB	Hapus Edit Rename
class-wp-network.php	12.008KB	Hapus Edit Rename
class-wp-oembed-controller.php	6.743KB	Hapus Edit Rename
class-wp-oembed.php	30.928KB	Hapus Edit Rename
class-wp-paused-extensions-storage.php	4.991KB	Hapus Edit Rename
class-wp-plugin-dependencies.php	24.722KB	Hapus Edit Rename
class-wp-recovery-mode-cookie-service.php	6.716KB	Hapus Edit Rename
class-wp-recovery-mode-email-service.php	10.921KB	Hapus Edit Rename
class-wp-recovery-mode-key-service.php	4.77KB	Hapus Edit Rename
class-wp-recovery-mode-link-service.php	3.382KB	Hapus Edit Rename
class-wp-session-tokens.php	7.147KB	Hapus Edit Rename
class-wp-simplepie-file.php	3.469KB	Hapus Edit Rename
class-wp-simplepie-sanitize-kses.php	1.865KB	Hapus Edit Rename
class-wp-site-query.php	30.913KB	Hapus Edit Rename
class-wp-speculation-rules.php	7.351KB	Hapus Edit Rename
class-wp-taxonomy.php	18.124KB	Hapus Edit Rename
class-wp-term-query.php	39.993KB	Hapus Edit Rename
class-wp-text-diff-renderer-inline.php	0.956KB	Hapus Edit Rename
class-wp-text-diff-renderer-table.php	18.438KB	Hapus Edit Rename
class-wp-textdomain-registry.php	10.235KB	Hapus Edit Rename
class-wp-theme-json-data.php	1.767KB	Hapus Edit Rename
class-wp-theme-json-resolver.php	34.9KB	Hapus Edit Rename
class-wp-theme-json-schema.php	7.194KB	Hapus Edit Rename
class-wp-theme-json.php	160.495KB	Hapus Edit Rename
class-wp-token-map.php	27.947KB	Hapus Edit Rename
class-wp-url-pattern-prefixer.php	4.689KB	Hapus Edit Rename
class-wp-user-meta-session-tokens.php	2.94KB	Hapus Edit Rename
class-wp-user-request.php	2.251KB	Hapus Edit Rename
class-wp-widget-factory.php	3.269KB	Hapus Edit Rename
class-wpdb.php	115.847KB	Hapus Edit Rename
comment.php	130.927KB	Hapus Edit Rename
default-filters.php	37.021KB	Hapus Edit Rename
feed-atom-comments.php	5.375KB	Hapus Edit Rename
feed-rss.php	1.161KB	Hapus Edit Rename
formatting.php	346.427KB	Hapus Edit Rename
functions.php	281.836KB	Hapus Edit Rename
global-styles-and-settings.php	20.707KB	Hapus Edit Rename
l10n.php	67.185KB	Hapus Edit Rename
load.php	55.186KB	Hapus Edit Rename
media.php	216.062KB	Hapus Edit Rename
ms-default-filters.php	6.48KB	Hapus Edit Rename
post-thumbnail-template.php	10.624KB	Hapus Edit Rename
query.php	36.226KB	Hapus Edit Rename
registration-functions.php	0.195KB	Hapus Edit Rename
rest-api.php	98.295KB	Hapus Edit Rename
rewrite.php	19.033KB	Hapus Edit Rename
style-engine.php	7.386KB	Hapus Edit Rename
theme.php	131.844KB	Hapus Edit Rename
update.php	37.454KB	Hapus Edit Rename
utf8.php	7.09KB	Hapus Edit Rename
widgets.php	69.462KB	Hapus Edit Rename