📁 Captain File Manager

✏️ Editing: atomic-element-usage-calculator.php

<?php

namespace Elementor\Modules\AtomicWidgets\Usage;

use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\AtomicWidgets\Utils\Utils as Atomic_Utils;
use Elementor\Modules\Usage\Contracts\Element_Usage_Calculator;

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

class Atomic_Element_Usage_Calculator implements Element_Usage_Calculator {

const TAB_GENERAL = 'General';
	const TAB_STYLE = 'Style';
	const DEFAULT_SECTION = 'Styles';

private array $style_props_schema;

public function __construct() {
		$this->style_props_schema = Style_Schema::get_style_schema() ?? [];
	}

public function can_calculate( array $element, $element_instance ): bool {
		if ( null === $element_instance ) {
			return false;
		}

return Atomic_Utils::is_atomic( $element_instance );
	}

public function calculate( array $element, $element_instance, array $usage ): array {
		$type = $this->get_element_type( $element );
		$usage = $this->ensure_usage_entry( $usage, $type );
		$usage[ $type ]['count']++;

if ( ! $element_instance ) {
			return $usage;
		}

$settings = $element['settings'] ?? [];
		$styles = $element['styles'] ?? [];

$control_sections = $this->build_control_section_map( $element_instance->get_atomic_controls() );
		$changed_props = $this->count_props_usage( $settings, $control_sections, $usage, $type );
		$changed_styles = $this->count_styles_usage( $styles, $usage, $type );

$usage[ $type ]['control_percent'] = $this->calculate_control_percent(
			$changed_props + $changed_styles,
			$element_instance
		);

return $usage;
	}

private function get_element_type( array $element ): string {
		return $element['widgetType'] ?? $element['elType'];
	}

private function ensure_usage_entry( array $usage, string $type ): array {
		if ( ! isset( $usage[ $type ] ) ) {
			$usage[ $type ] = [
				'count' => 0,
				'control_percent' => 0,
				'controls' => [],
			];
		}

return $usage;
	}

private function build_control_section_map( array $atomic_controls ): array {
		$map = [];

foreach ( $atomic_controls as $item ) {
			if ( ! ( $item instanceof Section ) ) {
				continue;
			}

foreach ( $item->get_items() as $control ) {
				if ( $control instanceof Atomic_Control_Base ) {
					$map[ $control->get_bind() ] = $item->get_label();
				}
			}
		}

return $map;
	}

private function count_props_usage( array $settings, array $control_sections, array &$usage, string $type ): int {
		$count = 0;

foreach ( $settings as $prop_name => $value ) {
			if ( '_cssid' === $prop_name ) {
				continue;
			}

if ( 'classes' === $prop_name ) {
				$this->increment_control( $usage, $type, self::TAB_STYLE, $prop_name );
				$count++;
				continue;
			}

$section = $control_sections[ $prop_name ] ?? 'unknown';
			$this->increment_control( $usage, $type, self::TAB_GENERAL, $prop_name, $section );
			$count++;
		}

return $count;
	}

private function count_styles_usage( array $styles, array &$usage, string $type ): int {
		$count = 0;
		$style_props = $this->collect_style_props( $styles );
		$has_custom_css = $this->has_custom_css( $styles );

if ( $has_custom_css ) {
			$this->increment_control( $usage, $type, self::TAB_STYLE, 'custom_css' );
			$count++;
		}

foreach ( $style_props as $prop_name => $value ) {
			$prop_type = $this->style_props_schema[ $prop_name ] ?? null;
			$count++;

if ( $prop_type ) {
				$decomposed = $this->decompose_style_props( $prop_name, $value, $prop_type );
				foreach ( $decomposed as $control_name ) {
					$this->increment_control( $usage, $type, self::TAB_STYLE, $control_name );
				}
			} else {
				$this->increment_control( $usage, $type, self::TAB_STYLE, $prop_name );
			}
		}

return $count;
	}

private function collect_style_props( array $styles ): array {
		$props = [];

foreach ( $styles as $style_data ) {
			if ( empty( $style_data['variants'] ) ) {
				continue;
			}

foreach ( $style_data['variants'] as $variant ) {
				if ( ! empty( $variant['props'] ) ) {
					$props = array_merge( $props, $variant['props'] );
				}
			}
		}

return $props;
	}

private function has_custom_css( array $styles ): bool {
		foreach ( $styles as $style_data ) {
			if ( empty( $style_data['variants'] ) ) {
				continue;
			}

foreach ( $style_data['variants'] as $variant ) {
				if ( ! empty( $variant['custom_css'] ) ) {
					return true;
				}
			}
		}

return false;
	}

private function calculate_control_percent( int $changed_count, $instance ): int {
		$props_schema = $instance::get_props_schema();
		$style_props = Style_Schema::get();

$total = count( $props_schema ) + count( $style_props );

if ( 0 === $total ) {
			return 0;
		}

return (int) round( ( $changed_count / $total ) * 100 );
	}

private function increment_control( array &$usage, string $type, string $tab, string $control, string $section = self::DEFAULT_SECTION ): void {
		if ( ! isset( $usage[ $type ]['controls'][ $tab ] ) ) {
			$usage[ $type ]['controls'][ $tab ] = [];
		}

if ( ! isset( $usage[ $type ]['controls'][ $tab ][ $section ] ) ) {
			$usage[ $type ]['controls'][ $tab ][ $section ] = [];
		}

if ( ! isset( $usage[ $type ]['controls'][ $tab ][ $section ][ $control ] ) ) {
			$usage[ $type ]['controls'][ $tab ][ $section ][ $control ] = 0;
		}

$usage[ $type ]['controls'][ $tab ][ $section ][ $control ]++;
	}

private function decompose_style_props( string $prop_name, $value, $prop_type, string $prefix = '' ): array {
		$control_names = [];
		$control_name = $prefix ? "{$prefix}-{$prop_name}" : $prop_name;
		// phpcs:ignore
		$kind = $prop_type::$KIND;

if ( ! $value ) {
			return $control_names;
		}

switch ( $kind ) {
			case 'object':
				$prop_shape = $prop_type->get_shape();
				if ( isset( $value['value'] ) && is_array( $value['value'] ) ) {
					foreach ( $value['value'] as $key => $nested_value ) {
						if ( isset( $prop_shape[ $key ] ) ) {
							$nested = $this->decompose_style_props( $key, $nested_value, $prop_shape[ $key ], $control_name );
							$control_names = array_merge( $control_names, $nested );
						}
					}
				}
				break;

case 'array':
				$item_type = $prop_type->get_item_type();
				if ( isset( $value['value'] ) && is_array( $value['value'] ) ) {
					foreach ( $value['value'] as $item ) {
						$item_name = $item['$$type'] ?? 'item';
						// phpcs:ignore
						$item_prop_type = 'union' === $item_type::$KIND ? $item_type->get_prop_type( $item_name ) : $item_type;

if ( $item_prop_type ) {
							$nested = $this->decompose_style_props( $item_name, $item, $item_prop_type, $control_name );
							$control_names = array_merge( $control_names, $nested );
						}
					}
				}
				break;

case 'union':
				$union_prop_type = $prop_type->get_prop_type_from_value( $value );
				if ( $union_prop_type ) {
					$nested = $this->decompose_style_props( $prop_name, $value, $union_prop_type, $prefix );
					$control_names = array_merge( $control_names, $nested );
				}
				break;

default:
				$control_names[] = $control_name;
				break;
		}

return $control_names;
	}
}