<?php
/**
 * Расстановка одного сохранённого фото: галерея товара и изображение товара.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Media;

defined( 'ABSPATH' ) || exit;

/**
 * Куда встаёт одно сохранённое фото (Documents/WPPlugin-HLD.md §2.5).
 *
 * Из окна фото приходит по одному, с назначением: в галерею товара или изображением товара.
 * Куда именно в галерее и что делать с прежним изображением товара — решают настройки
 * плагина (Settings), окно об этом не спрашивает.
 *
 * - add_to_gallery() — вложение встаёт в галерею на место по настройке: первым или
 *   последним. Если оно уже в галерее — переставляется на это место, второй копии нет.
 *   Если оно сейчас изображение товара — изображение не трогается, и в галерею оно
 *   не дублируется: одно фото в одном месте.
 * - set_main() — вложение становится изображением товара. Прежнее изображение — по настройке:
 *   в галерею первым или убрать из карточки. Прежнее изображение, которое уже лежало
 *   и в галерее, в обоих случаях остаётся в галерее и встаёт первым: его туда положил
 *   человек, и убирать его оттуда настройка про изображение товара не должна. Новое
 *   вложение, если оно было в галерее, из галереи уходит — одно фото в одном месте.
 *
 * Файлы в медиатеке не трогаются ни в каком случае: меняется только место в карточке.
 * Повторное сохранение того же фото в то же место дублей не плодит.
 *
 * Чистая логика без WordPress — проверяется тестами.
 */
final class Gallery_Layout {

	/** Новое фото в галерее — первым. */
	public const FIRST = 'first';

	/** Новое фото в галерее — последним. */
	public const LAST = 'last';

	/** Куда встаёт новое фото в галерее — значения настройки «gallery_position». */
	public const POSITIONS = array( self::FIRST, self::LAST );

	/** Прежнее изображение товара — перенести в галерею первым. */
	public const TO_GALLERY = 'to_gallery';

	/** Прежнее изображение товара — убрать из карточки (файл в медиатеке остаётся). */
	public const REMOVE = 'remove';

	/** Что делать с прежним изображением товара — значения настройки «old_main». */
	public const OLD_MAIN_MODES = array( self::TO_GALLERY, self::REMOVE );

	/**
	 * Вложение — в галерею товара.
	 *
	 * @param int    $attachment_id Вложение этого сохранения.
	 * @param int    $main_id       Изображение товара сейчас; 0 — его нет.
	 * @param int[]  $gallery_ids   Галерея сейчас, по порядку.
	 * @param string $position      Куда встаёт — одно из POSITIONS; незнакомое — FIRST.
	 * @return array{main: int, gallery: int[]} Изображение товара и галерея после.
	 */
	public static function add_to_gallery( int $attachment_id, int $main_id, array $gallery_ids, string $position ): array {
		$gallery = self::unique_ids( $gallery_ids );

		// Нечего класть или фото уже стоит изображением товара — товар как был:
		// изображение не трогается, в галерею не дублируется.
		if ( $attachment_id <= 0 || $attachment_id === $main_id ) {
			return array(
				'main'    => $main_id,
				'gallery' => $gallery,
			);
		}

		$others = self::without( $gallery, $attachment_id );

		return array(
			'main'    => $main_id,
			'gallery' => self::LAST === $position
				? array_merge( $others, array( $attachment_id ) )
				: array_merge( array( $attachment_id ), $others ),
		);
	}

	/**
	 * Вложение — изображением товара.
	 *
	 * @param int    $attachment_id Вложение этого сохранения.
	 * @param int    $old_main_id   Прежнее изображение товара; 0 — его не было.
	 * @param int[]  $gallery_ids   Галерея сейчас, по порядку.
	 * @param string $old_main_mode Что делать с прежним изображением — одно из OLD_MAIN_MODES;
	 *                              незнакомое — TO_GALLERY: убирать фото без ясного выбора нельзя.
	 * @return array{main: int, gallery: int[]} Изображение товара и галерея после.
	 */
	public static function set_main( int $attachment_id, int $old_main_id, array $gallery_ids, string $old_main_mode ): array {
		$gallery = self::unique_ids( $gallery_ids );

		// Нечего ставить или это фото уже изображение товара — товар как был.
		if ( $attachment_id <= 0 || $attachment_id === $old_main_id ) {
			return array(
				'main'    => $old_main_id,
				'gallery' => $gallery,
			);
		}

		// Новое изображение товара из галереи уходит: одно фото в одном месте.
		$others = self::without( $gallery, $attachment_id );

		if ( $old_main_id > 0 ) {
			$was_in_gallery = in_array( $old_main_id, $others, true );
			$others         = self::without( $others, $old_main_id );

			// Прежнее изображение встаёт первым в галерее, если так велит настройка —
			// или если оно и так лежало в галерее: его туда положил человек.
			if ( $was_in_gallery || self::REMOVE !== $old_main_mode ) {
				$others = array_merge( array( $old_main_id ), $others );
			}
		}

		return array(
			'main'    => $attachment_id,
			'gallery' => $others,
		);
	}

	/**
	 * Положительные id без повторов, в исходном порядке.
	 *
	 * @param array<int|string> $ids Id вложений.
	 * @return int[]
	 */
	private static function unique_ids( array $ids ): array {
		$result = array();

		foreach ( $ids as $id ) {
			$id = (int) $id;

			if ( $id > 0 && ! in_array( $id, $result, true ) ) {
				$result[] = $id;
			}
		}

		return $result;
	}

	/**
	 * Список без одного id, в исходном порядке.
	 *
	 * @param int[] $ids Id вложений.
	 * @param int   $id  Какой убрать.
	 * @return int[]
	 */
	private static function without( array $ids, int $id ): array {
		return array_values( array_filter( $ids, static fn ( int $item ): bool => $item !== $id ) );
	}
}