<?php
/**
 * Скрипт и стили плагина — в админке и на витрине.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Admin;

defined( 'ABSPATH' ) || exit;

/**
 * Подключает скрипты и стили плагина (Documents/WPPlugin-HLD.md §4.3) и передаёт скрипту
 * данные страницы.
 *
 * Скрипт страницы один на все страницы — редактор товара, страницу настроек и страницу
 * товара витрины; какая открыта, он узнаёт из данных. На страницах товара (редактор
 * и витрина) перед ним подключается второй, маленький: логика состояния окошка «Упорядочить
 * фото» (aimodelka-photos-state.js) — чистые функции без страницы, их проверяет тест на Node,
 * поэтому они лежат отдельным файлом.
 * Стилей три файла: админский (блок в редакторе, колонка в списке товаров, страница
 * настроек), для витрины (ряд кнопок под галереей — в тему витрины админские стили
 * не подключаются) и окошка «Упорядочить фото» (aimodelka-photos.css) — окошко одно
 * на редактор и витрину, и подключается на обеих. В списке товаров и на странице настроек
 * нужен только админский css.
 *
 * Тексты для скрипта переводит PHP и передаёт вместе с данными: так все строки плагина
 * переводятся в одном месте, как строки PHP, и скрипту не нужны свои файлы переводов.
 *
 * Запросы к своим адресам REST скрипт делает через штатный wp.apiFetch: он сам прикладывает
 * одноразовый ключ REST (nonce), обновляет его, когда тот устарел за долгий день работы
 * со страницей, и просит ответ на языке текущего пользователя. WordPress подключает это
 * к wp-api-fetch на любой странице, не только в админке.
 */
final class Assets {

	/** Имя скрипта и админских стилей в WordPress. */
	private const HANDLE = 'aimodelka-admin';

	/** Имя стилей витрины в WordPress. */
	private const STOREFRONT_STYLE = 'aimodelka-storefront';

	/** Имя стилей окошка «Упорядочить фото» в WordPress. */
	private const PHOTOS_STYLE = 'aimodelka-photos';

	/** Имя скрипта логики окошка «Упорядочить фото» в WordPress. */
	private const PHOTOS_STATE_HANDLE = 'aimodelka-photos-state';

	/**
	 * Страница настроек: подключает скрипт и админские стили и передаёт скрипту данные.
	 *
	 * @param array<string, mixed> $data Данные страницы; скрипт читает их из window.aimodelkaAdmin.
	 * @return void
	 */
	public static function enqueue( array $data ): void {
		self::enqueue_style();
		self::enqueue_script( $data, array() );
	}

	/**
	 * Редактор товара: админские стили, окошко «Упорядочить фото» (стили и логика) и скрипт
	 * страницы с данными.
	 *
	 * @param array<string, mixed> $data Данные страницы; скрипт читает их из window.aimodelkaAdmin.
	 * @return void
	 */
	public static function enqueue_editor( array $data ): void {
		self::enqueue_style();
		self::enqueue_photos();
		self::enqueue_script( $data, array( self::PHOTOS_STATE_HANDLE ) );
	}

	/**
	 * Витрина: стили витрины, окошко «Упорядочить фото» (стили и логика) и скрипт страницы
	 * с данными.
	 *
	 * @param array<string, mixed> $data Данные страницы; скрипт читает их из window.aimodelkaAdmin.
	 * @return void
	 */
	public static function enqueue_storefront( array $data ): void {
		wp_enqueue_style( self::STOREFRONT_STYLE, AIMODELKA_PLUGIN_URL . 'assets/aimodelka-storefront.css', array(), AIMODELKA_VERSION );
		self::enqueue_photos();
		self::enqueue_script( $data, array( self::PHOTOS_STATE_HANDLE ) );
	}

	/**
	 * Подключает стили и логику окошка «Упорядочить фото» — одни на редактор и витрину.
	 *
	 * @return void
	 */
	private static function enqueue_photos(): void {
		wp_enqueue_style( self::PHOTOS_STYLE, AIMODELKA_PLUGIN_URL . 'assets/aimodelka-photos.css', array(), AIMODELKA_VERSION );
		wp_enqueue_script( self::PHOTOS_STATE_HANDLE, AIMODELKA_PLUGIN_URL . 'assets/aimodelka-photos-state.js', array(), AIMODELKA_VERSION, true );
	}

	/**
	 * Подключает только админские стили — для страниц, где скрипту делать нечего (список товаров).
	 *
	 * @return void
	 */
	public static function enqueue_style(): void {
		wp_enqueue_style( self::HANDLE, AIMODELKA_PLUGIN_URL . 'assets/aimodelka-admin.css', array(), AIMODELKA_VERSION );
	}

	/**
	 * Подключает скрипт страницы и кладёт перед ним данные страницы.
	 *
	 * @param array<string, mixed> $data         Данные страницы.
	 * @param string[]             $dependencies Свои скрипты, которые должны загрузиться раньше.
	 * @return void
	 */
	private static function enqueue_script( array $data, array $dependencies ): void {
		wp_enqueue_script( self::HANDLE, AIMODELKA_PLUGIN_URL . 'assets/aimodelka-admin.js', array_merge( array( 'wp-api-fetch' ), $dependencies ), AIMODELKA_VERSION, true );
		// JSON_HEX_TAG и JSON_HEX_AMP: строка внутри <script> не может закрыть тег раньше времени.
		wp_add_inline_script( self::HANDLE, 'window.aimodelkaAdmin = ' . wp_json_encode( $data, JSON_HEX_TAG | JSON_HEX_AMP ) . ';', 'before' );
	}
}