JezK

Edit File: converter-registry-factory.php

<?php

namespace Elementor\Modules\AtomicWidgets\CssConverter;

use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Background_Image_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Rejected_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Background_Layer_Field_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Background_Position_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Box_Shadow_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Border_Radius_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Color_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Dimensions_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Filter_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Flex_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Transform_Origin_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Transform_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Transition_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Noop_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Number_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Object_Field_Merge_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Object_Position_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Object_Side_Merge_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Size_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\Span_Property_Converter;
use Elementor\Modules\AtomicWidgets\CssConverter\Converters\String_Property_Converter;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Image_Overlay_Size_Scale_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Border_Radius_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Dimensions_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Border_Width_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\Variables\Services\Variables_Service;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

class Converter_Registry_Factory {
	/**
	 * Every Style_Schema property whose value is a single Size leaf (the schema prop is a Size_Prop_Type,
	 * or a Union with a Size member like `gap` — a size PropValue validates against the union). All are
	 * handled uniformly by Size_Property_Converter + Size_Value_Parser; per-property unit sets are not
	 * enforced here because Size_Prop_Type::validate accepts any all_supported_units() unit.
	 */
	const SIZE_PROPERTIES = [
		'width',
		'height',
		'min-width',
		'min-height',
		'max-width',
		'max-height',
		'inset-block-start',
		'inset-inline-end',
		'inset-block-end',
		'inset-inline-start',
		'scroll-margin-top',
		'font-size',
		'letter-spacing',
		'word-spacing',
		'column-gap',
		'line-height',
		'outline-width',
		'outline-offset',
		'opacity',
		'gap',
		'grid-auto-rows',
		'grid-auto-columns',
	];

/**
	 * Size properties that also accept a unitless number (a multiplier, e.g. `line-height: 1.1`). The
	 * value is kept verbatim as a `custom` unit so it renders without a unit; every other size property
	 * declines a unitless non-zero value to custom_css.
	 */
	const UNITLESS_SIZE_PROPERTIES = [
		'line-height',
	];

/**
	 * Every Style_Schema property backed by a Number_Prop_Type. Handled uniformly by
	 * Number_Property_Converter (strict numeric, no units/functions).
	 */
	const NUMBER_PROPERTIES = [
		'z-index',
		'column-count',
		'order',
	];

/**
	 * Every Style_Schema property backed by a plain Color_Prop_Type. Handled uniformly by
	 * Color_Property_Converter (raw passthrough; any non-empty value is a valid color).
	 */
	const COLOR_PROPERTIES = [
		'color',
		'border-color',
		'outline-color',
	];

/**
	 * Every Style_Schema property backed by a Span_Prop_Type (grid placement). Handled uniformly by
	 * Span_Property_Converter, with the validation regex sourced from the live schema.
	 */
	const SPAN_PROPERTIES = [
		'grid-column',
		'grid-row',
	];

/**
	 * Union props whose string member accepts a raw value (e.g. Union(String | Grid_Track_Size)). A
	 * free-string String_Property_Converter emits a `string` PropValue that validates against the union's
	 * String member, covering `1fr 1fr`, `repeat(3, 1fr)`, `minmax(...)`, named lines, etc. The structured
	 * member is intentionally not produced (raw passthrough, mirroring color). NOT wired via
	 * STRING_PROPERTIES because the schema entry is a Union and has no get_enum().
	 */
	const STRING_PASSTHROUGH_PROPERTIES = [
		'grid-template-columns',
		'grid-template-rows',
	];

/**
	 * Box shorthands backed by Union(Dimensions | Size). Handled uniformly by
	 * Dimensions_Property_Converter (single value -> Size; 2-4 values -> logical Dimensions).
	 */
	const DIMENSIONS_PROPERTIES = [
		'padding',
		'margin',
	];

/**
	 * Props that each own a bespoke single-property converter (no shared family). Listed here for the
	 * covered set; each is wired explicitly in real_converters() (unlike the family arrays above, the
	 * members do not share a converter class, so there is no uniform loop). Distinct from
	 * NOOP_PROPERTIES, which have no real converter yet.
	 *
	 * - border-radius: Union(Border_Radius | Size); single value -> Size, 2-4 values -> logical
	 *   Border_Radius. Elliptical "/" values decline to custom_css (no two-radii-per-corner shape).
	 * - border-width: Union(Border_Width | Size); shares the four logical sides with the Dimensions
	 *   shorthand, so it reuses Dimensions_Property_Converter with the Border_Width wrapper injected.
	 */
	const OTHER_PROPERTIES = [
		'border-radius',
		'border-width',
		'object-position',
		'flex',
		'transition',
		'transform',
		'transform-origin',
		'box-shadow',
	];

/**
	 * Scalar background longhands that each fill one field of the aggregate `background` object. Not
	 * Style_Schema properties (the schema only has the `background` aggregate); they are accumulated into
	 * it by Object_Field_Merge_Converter, wired explicitly in real_converters() so each field's leaf prop
	 * type / enum is sourced from the live schema. The overlay array (image/gradient layers) is separate.
	 */
	const BACKGROUND_FIELD_PROPERTIES = [
		'background-color',
		'background-clip',
	];

/**
	 * Background overlay longhands that are not Style_Schema properties. `background-image` creates the
	 * image layer array in the aggregate; the rest update fields on existing layers via
	 * Background_Layer_Field_Converter. Enums are hardcoded to match the background-image-overlay shape
	 * without needing to instantiate the prop type (which would require WP for image sizes).
	 */
	const BACKGROUND_LAYER_PROPERTIES = [
		'background-image',
		'background-repeat',
		'background-attachment',
		'background-size',
		'background-position',
	];

const BACKGROUND_REPEAT_ENUM = [ 'repeat', 'repeat-x', 'repeat-y', 'no-repeat' ];
	const BACKGROUND_ATTACHMENT_ENUM = [ 'fixed', 'scroll' ];
	const BACKGROUND_SIZE_ENUM = [ 'auto', 'cover', 'contain' ];

/**
	 * Logical side keys of the Border_Width / Dimensions objects, and corner keys of the Border_Radius
	 * object, in the order used to seed every side/corner from a single Size.
	 */
	const BORDER_WIDTH_SIDE_KEYS = [ 'block-start', 'inline-end', 'block-end', 'inline-start' ];
	const BORDER_RADIUS_CORNER_KEYS = [ 'start-start', 'start-end', 'end-end', 'end-start' ];

/**
	 * Physical padding/margin longhands -> [ target schema prop, logical side key ].
	 * Not Style_Schema properties themselves; accumulated into the schema aggregate by
	 * Object_Side_Merge_Converter (same pattern as border_side_specs()).
	 */
	const DIMENSIONS_SIDE_SPECS = [
		'padding-top'          => [ 'padding', 'block-start' ],
		'padding-right'        => [ 'padding', 'inline-end' ],
		'padding-bottom'       => [ 'padding', 'block-end' ],
		'padding-left'         => [ 'padding', 'inline-start' ],
		'padding-block-start'  => [ 'padding', 'block-start' ],
		'padding-block-end'    => [ 'padding', 'block-end' ],
		'padding-inline-start' => [ 'padding', 'inline-start' ],
		'padding-inline-end'   => [ 'padding', 'inline-end' ],
		'margin-top'           => [ 'margin', 'block-start' ],
		'margin-right'         => [ 'margin', 'inline-end' ],
		'margin-bottom'        => [ 'margin', 'block-end' ],
		'margin-left'          => [ 'margin', 'inline-start' ],
		'margin-block-start'   => [ 'margin', 'block-start' ],
		'margin-block-end'     => [ 'margin', 'block-end' ],
		'margin-inline-start'  => [ 'margin', 'inline-start' ],
		'margin-inline-end'    => [ 'margin', 'inline-end' ],
	];

/**
	 * Filter-function lists backed by Array(Css_Filter_Func) (filter, backdrop-filter). Handled
	 * uniformly by Filter_Property_Converter + Filter_Value_Parser; the two share inner items and
	 * differ only by the wrapping $$type, which is sourced from the live schema.
	 */
	const FILTER_PROPERTIES = [
		'filter',
		'backdrop-filter',
	];

/**
	 * Hardcoded Style_Schema properties with no real converter yet (objects, unions, shorthands). They
	 * still get a Noop_Converter so they keep routing to custom_css. Combined with the real-converter
	 * families via covered_properties() to form the exhaustive covered set. Intentionally NOT derived
	 * from Style_Schema: a coverage test diffs the live schema against the covered set so adding a schema
	 * property without coverage fails CI until it is added here.
	 */
	const NOOP_PROPERTIES = [
		// SVG-only family. The editor UI does not expose stroke controls, so there is no
		// LLM-facing use case worth converting. All stroke-* longhands are listed explicitly
		// (rather than relying on silent fallthrough) so the intent is "preserve verbatim in
		// customCss by-design", not "forgot to wire". `stroke` itself is the only top-level
		// Style_Schema entry; the longhands are not in the schema and only need coverage here.
		'stroke',
		'stroke-width',
		'stroke-opacity',
		'stroke-dasharray',
		'stroke-dashoffset',
		'stroke-linecap',
		'stroke-linejoin',
		'stroke-miterlimit',
		// Last-resort fallback for `background` values the shorthand expander cannot decompose
		// (e.g. exotic syntax). The expander handles the common forms; this entry keeps the
		// raw declaration in customCss when expansion fails.
		'background',
	];

/**
	 * Properties that are structurally incompatible with Elementor's inline style system.
	 * They are explicitly rejected (not routed to customCss) so the client can surface a
	 * hint to the LLM that these constructs are unsupported in element style definitions.
	 *
	 * `animation` and its longhands rely on @keyframes which cannot be declared inline.
	 */
	const REJECTED_PROPERTIES = [
		'animation',
		'animation-name',
		'animation-duration',
		'animation-timing-function',
		'animation-delay',
		'animation-iteration-count',
		'animation-direction',
		'animation-fill-mode',
		'animation-play-state',
	];

/**
	 * Every Style_Schema property backed by a plain String_Prop_Type. Enum-backed and free-string
	 * props are handled the same way: get_enum() returns the allowlist (enum props) or null
	 * (free-string props), so the allowlist is always sourced from the schema, never duplicated.
	 */
	const STRING_PROPERTIES = [
		'overflow',
		'aspect-ratio',
		'object-fit',
		'position',
		'font-family',
		'font-weight',
		'text-align',
		'font-style',
		'text-decoration',
		'text-transform',
		'direction',
		'all',
		'cursor',
		'border-style',
		'outline-style',
		'mix-blend-mode',
		'display',
		'flex-direction',
		'flex-wrap',
		'grid-auto-flow',
		'justify-content',
		'justify-items',
		'align-content',
		'align-items',
		'align-self',
		'content',
		'appearance',
		'clip-path',
	];

/**
	 * The exhaustive covered set: every family with a real converter plus the remaining no-ops. Single
	 * source of truth for the coverage test, with no property listed twice.
	 *
	 * @return string[]
	 */
	public static function covered_properties(): array {
		return array_merge(
			self::STRING_PROPERTIES,
			self::SIZE_PROPERTIES,
			self::NUMBER_PROPERTIES,
			self::COLOR_PROPERTIES,
			self::SPAN_PROPERTIES,
			self::STRING_PASSTHROUGH_PROPERTIES,
			self::DIMENSIONS_PROPERTIES,
			self::FILTER_PROPERTIES,
			self::OTHER_PROPERTIES,
			array_keys( self::border_side_specs() ),
			self::BACKGROUND_FIELD_PROPERTIES,
			self::BACKGROUND_LAYER_PROPERTIES,
			self::NOOP_PROPERTIES,
			self::REJECTED_PROPERTIES
		);
	}

/**
	 * Per-side/per-corner border longhands that each contribute one fragment to an aggregate object prop
	 * (border-width / border-radius), keyed by input property -> [ target prop, object key ]. These are
	 * not Style_Schema properties; they are accumulated into the schema aggregate by
	 * Object_Side_Merge_Converter. Per-side style/color have no faithful single-valued representation, so
	 * they are intentionally absent and route to custom_css.
	 *
	 * @return array<string, array{0: string, 1: string}>
	 */
	private static function border_side_specs(): array {
		return [
			'border-top-width' => [ 'border-width', 'block-start' ],
			'border-right-width' => [ 'border-width', 'inline-end' ],
			'border-bottom-width' => [ 'border-width', 'block-end' ],
			'border-left-width' => [ 'border-width', 'inline-start' ],
			'border-top-left-radius' => [ 'border-radius', 'start-start' ],
			'border-top-right-radius' => [ 'border-radius', 'start-end' ],
			'border-bottom-right-radius' => [ 'border-radius', 'end-end' ],
			'border-bottom-left-radius' => [ 'border-radius', 'end-start' ],
		];
	}

public static function create( ?Variables_Service $variables_service = null ): Converter_Registry {
		$registry = new Converter_Registry();
		$real_converters = self::real_converters( $variables_service );

foreach ( $real_converters as $converter ) {
			$registry->register( $converter );
		}

foreach ( self::REJECTED_PROPERTIES as $property ) {
			$registry->register( new Rejected_Converter( $property ) );
		}

foreach ( self::covered_properties() as $property ) {
			if ( isset( $real_converters[ $property ] ) ) {
				continue;
			}

if ( in_array( $property, self::REJECTED_PROPERTIES, true ) ) {
				continue;
			}

$registry->register( new Noop_Converter( $property ) );
		}

return $registry;
	}

/**
	 * Real converters keyed by the property they own. Every remaining covered_properties() entry
	 * falls back to a Noop_Converter, so the "exactly one converter per property" invariant holds.
	 * Enum allowlists are sourced from the live Style_Schema to avoid duplicating (and drifting from)
	 * the schema's enums.
	 *
	 * @return array<string, \Elementor\Modules\AtomicWidgets\CssConverter\Property_Converter>
	 */
	private static function real_converters( ?Variables_Service $variables_service = null ): array {
		$schema = Style_Schema::get_style_schema();
		$converters = [];

foreach ( self::STRING_PROPERTIES as $property ) {
			$converters[ $property ] = new String_Property_Converter( $property, $schema[ $property ]->get_enum() );
		}

foreach ( self::SIZE_PROPERTIES as $property ) {
			$allow_unitless = in_array( $property, self::UNITLESS_SIZE_PROPERTIES, true );
			$converters[ $property ] = new Size_Property_Converter( $property, $allow_unitless );
		}

foreach ( self::NUMBER_PROPERTIES as $property ) {
			$converters[ $property ] = new Number_Property_Converter( $property );
		}

foreach ( self::COLOR_PROPERTIES as $property ) {
			$converters[ $property ] = new Color_Property_Converter( $property );
		}

foreach ( self::SPAN_PROPERTIES as $property ) {
			$converters[ $property ] = new Span_Property_Converter( $property, $schema[ $property ]->get_regex() );
		}

foreach ( self::STRING_PASSTHROUGH_PROPERTIES as $property ) {
			$converters[ $property ] = new String_Property_Converter( $property );
		}

foreach ( self::DIMENSIONS_PROPERTIES as $property ) {
			$converters[ $property ] = new Dimensions_Property_Converter( $property );
		}

$converters['border-radius'] = new Border_Radius_Property_Converter( 'border-radius' );
		$converters['border-width'] = new Dimensions_Property_Converter( 'border-width', Border_Width_Prop_Type::class );
		$converters['object-position'] = new Object_Position_Property_Converter();
		$converters['flex'] = new Flex_Property_Converter();
		$converters['transition'] = new Transition_Property_Converter();
		$converters['transform'] = new Transform_Property_Converter();
		$converters['transform-origin'] = new Transform_Origin_Property_Converter();
		$converters['box-shadow'] = new Box_Shadow_Property_Converter();

foreach ( self::DIMENSIONS_SIDE_SPECS as $property => [ $target, $side_key ] ) {
			$converters[ $property ] = new Object_Side_Merge_Converter(
				$property,
				$target,
				Dimensions_Prop_Type::get_key(),
				$side_key,
				self::BORDER_WIDTH_SIDE_KEYS,
				Dimensions_Prop_Type::class,
				$variables_service
			);
		}

foreach ( self::border_side_specs() as $property => [ $target, $side_key ] ) {
			$is_radius = 'border-radius' === $target;
			$prop_type_class = $is_radius ? Border_Radius_Prop_Type::class : Border_Width_Prop_Type::class;

$converters[ $property ] = new Object_Side_Merge_Converter(
				$property,
				$target,
				$prop_type_class::get_key(),
				$side_key,
				$is_radius ? self::BORDER_RADIUS_CORNER_KEYS : self::BORDER_WIDTH_SIDE_KEYS,
				$prop_type_class,
				$variables_service
			);
		}

foreach ( self::FILTER_PROPERTIES as $property ) {
			$converters[ $property ] = new Filter_Property_Converter( $property, $schema[ $property ]->get_key() );
		}

$background_key = Background_Prop_Type::get_key();

$converters['background-color'] = new Object_Field_Merge_Converter(
			'background-color',
			$background_key,
			$background_key,
			'color',
			Color_Prop_Type::class,
			Background_Prop_Type::class,
			null,
			true
		);

$converters['background-clip'] = new Object_Field_Merge_Converter(
			'background-clip',
			$background_key,
			$background_key,
			'clip',
			String_Prop_Type::class,
			Background_Prop_Type::class,
			$schema[ $background_key ]->get_shape_field( 'clip' )->get_enum()
		);

$converters['background-image'] = new Background_Image_Converter();

$converters['background-repeat'] = new Background_Layer_Field_Converter(
			'background-repeat',
			'repeat',
			self::BACKGROUND_REPEAT_ENUM
		);

$converters['background-attachment'] = new Background_Layer_Field_Converter(
			'background-attachment',
			'attachment',
			self::BACKGROUND_ATTACHMENT_ENUM
		);

$converters['background-size'] = new Background_Layer_Field_Converter(
			'background-size',
			'size',
			self::BACKGROUND_SIZE_ENUM,
			Background_Image_Overlay_Size_Scale_Prop_Type::class,
			[ 'width', 'height' ]
		);

$converters['background-position'] = new Background_Position_Property_Converter();

return $converters;
	}
}