<?php
/**
 * Какие вариации товара подходят под выбор человека в вопросе о вариации.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Media;

defined( 'ABSPATH' ) || exit;

/**
 * Подбор вариаций под выбор «код атрибута → код значения» из окна
 * (Documents/WPPlugin-HLD.md §2.5).
 *
 * Правило — то же, что у самого WooCommerce при подборе вариации к выбору покупателя:
 * вариация подходит, если по каждому выбранному атрибуту её значение равно выбранному
 * **или пусто** («любой» у вариации). Атрибуты, которых в выборе нет, не проверяются:
 * выбор «Цвет: Блакитний» без размера ставит изображение всем размерам этого цвета.
 *
 * Пустой выбор не подходит ни одной вариации: это «товар целиком», и окно его сюда
 * не присылает.
 *
 * Чистая логика без WordPress — проверяется тестами.
 */
final class Variation_Matcher {

	/**
	 * Id вариаций, которые подходят под выбор, в порядке списка.
	 *
	 * @param array<int, array{id: int, attributes: array<string, string>}> $variations Вариации товара:
	 *                                                                                   id и значения атрибутов
	 *                                                                                   (код атрибута → код значения,
	 *                                                                                   пустая строка — «любой»).
	 * @param array<string, string>                                         $choice     Выбор: код атрибута → код значения.
	 * @return int[]
	 */
	public static function matching( array $variations, array $choice ): array {
		$chosen = array();

		foreach ( $choice as $code => $value ) {
			$code  = (string) $code;
			$value = (string) $value;

			if ( '' !== $code && '' !== $value ) {
				$chosen[ $code ] = $value;
			}
		}

		if ( array() === $chosen ) {
			return array();
		}

		$result = array();

		foreach ( $variations as $variation ) {
			$attributes = is_array( $variation['attributes'] ?? null ) ? $variation['attributes'] : array();

			if ( self::fits( $attributes, $chosen ) ) {
				$result[] = (int) ( $variation['id'] ?? 0 );
			}
		}

		return array_values( array_filter( $result, static fn ( int $id ): bool => $id > 0 ) );
	}

	/**
	 * Подходит ли вариация под выбор.
	 *
	 * @param array<string, string> $attributes Значения атрибутов вариации; нет ключа или пусто — «любой».
	 * @param array<string, string> $chosen     Выбор без пустых значений.
	 * @return bool
	 */
	private static function fits( array $attributes, array $chosen ): bool {
		foreach ( $chosen as $code => $value ) {
			$own = (string) ( $attributes[ $code ] ?? '' );

			if ( '' !== $own && $own !== $value ) {
				return false;
			}
		}

		return true;
	}
}