* Returns layout definitions, keyed by layout type.

 *

 * Provides a common definition of slugs, classnames, base styles, and spacing styles for each layout type.

 * When making changes or additions to layout definitions, the corresponding JavaScript definitions should

 * also be updated.

 *

 * @since 6.3.0

 * @since 6.6.0 Updated specificity for compatibility with 0-1-0 global styles specificity.

 * @access private

 *

 * @return array[] Layout definitions.

 */

function wp_get_layout_definitions() {

	$layout_definitions = array(

		'default'     => array(

			'name'          => 'default',

			'slug'          => 'flow',

			'className'     => 'is-layout-flow',

			'baseStyles'    => array(

				array(

					'selector' => ' > .alignleft',

					'rules'    => array(

						'float'               => 'left',

						'margin-inline-start' => '0',

						'margin-inline-end'   => '2em',

					),

				),

				array(

					'selector' => ' > .alignright',

					'rules'    => array(

						'float'               => 'right',

						'margin-inline-start' => '2em',

						'margin-inline-end'   => '0',

					),

				),

				array(

					'selector' => ' > .aligncenter',

					'rules'    => array(

						'margin-left'  => 'auto !important',

						'margin-right' => 'auto !important',

					),

				),

			),

			'spacingStyles' => array(

				array(

					'selector' => ' > :first-child',

					'rules'    => array(

						'margin-block-start' => '0',

					),

				),

				array(

					'selector' => ' > :last-child',

					'rules'    => array(

						'margin-block-end' => '0',

					),

				),

				array(

					'selector' => ' > *',

					'rules'    => array(

						'margin-block-start' => null,

						'margin-block-end'   => '0',

					),

				),

			),

		),

		'constrained' => array(

			'name'          => 'constrained',

			'slug'          => 'constrained',

			'className'     => 'is-layout-constrained',

			'baseStyles'    => array(

				array(

					'selector' => ' > .alignleft',

					'rules'    => array(

						'float'               => 'left',

						'margin-inline-start' => '0',

						'margin-inline-end'   => '2em',

					),

				),

				array(

					'selector' => ' > .alignright',

					'rules'    => array(

						'float'               => 'right',

						'margin-inline-start' => '2em',

						'margin-inline-end'   => '0',

					),

				),

				array(

					'selector' => ' > .aligncenter',

					'rules'    => array(

						'margin-left'  => 'auto !important',

						'margin-right' => 'auto !important',

					),

				),

				array(

					'selector' => ' > :where(:not(.alignleft):not(.alignright):not(.alignfull))',

					'rules'    => array(

						'max-width'    => 'var(--wp--style--global--content-size)',

						'margin-left'  => 'auto !important',

						'margin-right' => 'auto !important',

					),

				),

				array(

					'selector' => ' > .alignwide',

					'rules'    => array(

						'max-width' => 'var(--wp--style--global--wide-size)',

					),

				),

			),

			'spacingStyles' => array(

				array(

					'selector' => ' > :first-child',

					'rules'    => array(

						'margin-block-start' => '0',

					),

				),

				array(

					'selector' => ' > :last-child',

					'rules'    => array(

						'margin-block-end' => '0',

					),

				),

				array(

					'selector' => ' > *',

					'rules'    => array(

						'margin-block-start' => null,

						'margin-block-end'   => '0',

					),

				),

			),

		),

		'flex'        => array(

			'name'          => 'flex',

			'slug'          => 'flex',

			'className'     => 'is-layout-flex',

			'displayMode'   => 'flex',

			'baseStyles'    => array(

				array(

					'selector' => '',

					'rules'    => array(

						'flex-wrap'   => 'wrap',

						'align-items' => 'center',

					),

				),

				array(

					'selector' => ' > :is(*, div)', // :is(*, div) instead of just * increases the specificity by 001.

					'rules'    => array(

						'margin' => '0',

					),

				),

			),

			'spacingStyles' => array(

				array(

					'selector' => '',

					'rules'    => array(

						'gap' => null,

					),

				),

			),

		),

		'grid'        => array(

			'name'          => 'grid',

			'slug'          => 'grid',

			'className'     => 'is-layout-grid',

			'displayMode'   => 'grid',

			'baseStyles'    => array(

				array(

					'selector' => ' > :is(*, div)', // :is(*, div) instead of just * increases the specificity by 001.

					'rules'    => array(

						'margin' => '0',

					),

				),

			),

			'spacingStyles' => array(

				array(

					'selector' => '',

					'rules'    => array(

						'gap' => null,

					),

				),

			),

		),

	);

	return $layout_definitions;

}

/**

 * @since 6.3.0 Check for layout support via the `layout` key with fallback to `__experimentalLayout`.

	$support_layout = block_has_support( $block_type, 'layout', false ) || block_has_support( $block_type, '__experimentalLayout', false );

 * @since 6.1.0 Added `$block_spacing` param, use style engine to enqueue styles.

 * @since 6.3.0 Added grid layout type.

 * @since 6.6.0 Removed duplicated selector from layout styles.

 *              Enabled negative margins for alignfull children of blocks with custom padding.

 * @param string               $selector                      CSS selector.

 * @param array                $layout                        Layout object. The one that is passed has already checked

 *                                                            the existence of default block layout.

 * @param bool                 $has_block_gap_support         Optional. Whether the theme has support for the block gap. Default false.

 * @param string|string[]|null $gap_value                     Optional. The block gap value to apply. Default null.

 * @param bool                 $should_skip_gap_serialization Optional. Whether to skip applying the user-defined value set in the editor. Default false.

 * @param string               $fallback_gap_value            Optional. The block gap value to apply. Default '0.5em'.

 * @param array|null           $block_spacing                 Optional. Custom spacing set on the block. Default null.

 * @return string CSS styles on success. Else, empty string.

function wp_get_layout_style( $selector, $layout, $has_block_gap_support = false, $gap_value = null, $should_skip_gap_serialization = false, $fallback_gap_value = '0.5em', $block_spacing = null ) {

	$layout_type   = isset( $layout['type'] ) ? $layout['type'] : 'default';

	$layout_styles = array();

	if ( 'default' === $layout_type ) {

		if ( $has_block_gap_support ) {

			if ( is_array( $gap_value ) ) {

				$gap_value = isset( $gap_value['top'] ) ? $gap_value['top'] : null;

			}

			if ( null !== $gap_value && ! $should_skip_gap_serialization ) {

				// Get spacing CSS variable from preset value if provided.

				if ( is_string( $gap_value ) && str_contains( $gap_value, 'var:preset|spacing|' ) ) {

					$index_to_splice = strrpos( $gap_value, '|' ) + 1;

					$slug            = _wp_to_kebab_case( substr( $gap_value, $index_to_splice ) );

					$gap_value       = "var(--wp--preset--spacing--$slug)";

				}

				array_push(

					$layout_styles,

					array(

						'selector'     => "$selector > *",

						'declarations' => array(

							'margin-block-start' => '0',

							'margin-block-end'   => '0',

						),

					),

					array(

						'selector'     => "$selector > * + *",

						'declarations' => array(

							'margin-block-start' => $gap_value,

							'margin-block-end'   => '0',

						),

					)

				);

			}

		}

	} elseif ( 'constrained' === $layout_type ) {

		$content_size    = isset( $layout['contentSize'] ) ? $layout['contentSize'] : '';

		$wide_size       = isset( $layout['wideSize'] ) ? $layout['wideSize'] : '';

		$justify_content = isset( $layout['justifyContent'] ) ? $layout['justifyContent'] : 'center';

		$margin_left  = 'left' === $justify_content ? '0 !important' : 'auto !important';

		$margin_right = 'right' === $justify_content ? '0 !important' : 'auto !important';

			array_push(

				$layout_styles,

				array(

					'selector'     => "$selector > :where(:not(.alignleft):not(.alignright):not(.alignfull))",

					'declarations' => array(

						'max-width'    => $all_max_width_value,

						'margin-left'  => $margin_left,

						'margin-right' => $margin_right,

					),

				),

				array(

					'selector'     => "$selector > .alignwide",

					'declarations' => array( 'max-width' => $wide_max_width_value ),

				),

				array(

					'selector'     => "$selector .alignfull",

					'declarations' => array( 'max-width' => 'none' ),

				)

			);

		if ( isset( $block_spacing ) ) {

			$block_spacing_values = wp_style_engine_get_styles(

				array(

					'spacing' => $block_spacing,

				)

			);

			/*

			 * Handle negative margins for alignfull children of blocks with custom padding set.

			 * They're added separately because padding might only be set on one side.

			 */

			if ( isset( $block_spacing_values['declarations']['padding-right'] ) ) {

				$padding_right = $block_spacing_values['declarations']['padding-right'];

				// Add unit if 0.

				if ( '0' === $padding_right ) {

					$padding_right = '0px';

				}

				$layout_styles[] = array(

					'selector'     => "$selector > .alignfull",

					'declarations' => array( 'margin-right' => "calc($padding_right * -1)" ),

				);

			}

			if ( isset( $block_spacing_values['declarations']['padding-left'] ) ) {

				$padding_left = $block_spacing_values['declarations']['padding-left'];

				// Add unit if 0.

				if ( '0' === $padding_left ) {

					$padding_left = '0px';

				}

				$layout_styles[] = array(

					'selector'     => "$selector > .alignfull",

					'declarations' => array( 'margin-left' => "calc($padding_left * -1)" ),

				);

			}

		}

		if ( 'left' === $justify_content ) {

			$layout_styles[] = array(

				'selector'     => "$selector > :where(:not(.alignleft):not(.alignright):not(.alignfull))",

				'declarations' => array( 'margin-left' => '0 !important' ),

			);

		}

		if ( 'right' === $justify_content ) {

			$layout_styles[] = array(

				'selector'     => "$selector > :where(:not(.alignleft):not(.alignright):not(.alignfull))",

				'declarations' => array( 'margin-right' => '0 !important' ),

			);

		}

			if ( null !== $gap_value && ! $should_skip_gap_serialization ) {

				// Get spacing CSS variable from preset value if provided.

				if ( is_string( $gap_value ) && str_contains( $gap_value, 'var:preset|spacing|' ) ) {

					$index_to_splice = strrpos( $gap_value, '|' ) + 1;

					$slug            = _wp_to_kebab_case( substr( $gap_value, $index_to_splice ) );

					$gap_value       = "var(--wp--preset--spacing--$slug)";

				}

				array_push(

					$layout_styles,

					array(

						'selector'     => "$selector > *",

						'declarations' => array(

							'margin-block-start' => '0',

							'margin-block-end'   => '0',

						),

					),

					array(

						'selector'     => "$selector > * + *",

						'declarations' => array(

							'margin-block-start' => $gap_value,

							'margin-block-end'   => '0',

						),

					)

				);

			}

		$vertical_alignment_options = array(

			'top'    => 'flex-start',

			'center' => 'center',

			'bottom' => 'flex-end',

		);