<?php
/**
 * Admin wiring: the menu tree and the Settings API registration.
 *
 * @package PressRoost\AIVE
 */

namespace PressRoost\AIVE\Admin;

use PressRoost\AIVE\Data\AnswerDensityStore;
use PressRoost\AIVE\Data\CrawlerLogStore;
use PressRoost\AIVE\Modules\ConflictDetector;
use PressRoost\AIVE\Modules\RobotsPolicy;
use PressRoost\AIVE\Utils\Helpers;

/**
 * Registers AIVE's admin screens.
 *
 * One class owns the whole menu tree and builds it in a single `admin_menu`
 * callback. `add_submenu_page()` silently does nothing when its parent does not
 * exist yet, so splitting the parent and the children across separate callbacks
 * would make the menu depend on hook registration order - which is exactly the
 * kind of dependency that works until someone reorders the bootstrap.
 *
 * The Dashboard is the parent's own screen, consistent with the product
 * contract's requirement that the dashboard parent replace the former
 * Crawler Log parent view. Every other screen keeps its own distinct slug
 * and is registered as an ordinary submenu entry, so a bookmarked or linked
 * URL to any of them keeps rendering its established screen unchanged.
 *
 * Nothing here enqueues a stylesheet or a script. The screens are built from
 * core's own admin classes, so the plugin adds no assets to any request -
 * frontend or admin.
 *
 * @since 1.1.0
 */
final class Admin {

	/**
	 * Capability required for every AIVE admin screen.
	 *
	 * @since 1.1.0
	 * @var string
	 */
	public const CAPABILITY = 'manage_options';

	/**
	 * The Dashboard screen, and the top-level menu's parent page.
	 *
	 * @since 1.7.0
	 * @var DashboardPage
	 */
	private $dashboard_page;

	/**
	 * The Crawler Log screen.
	 *
	 * @since 1.1.0
	 * @var CrawlerLogPage
	 */
	private $crawler_log_page;

	/**
	 * The Robots Audit screen.
	 *
	 * @since 1.2.0
	 * @var RobotsAuditPage
	 */
	private $robots_audit_page;

	/**
	 * The Schema screen.
	 *
	 * @since 1.3.0
	 * @var SchemaPage
	 */
	private $schema_page;

	/**
	 * The Answer Density screen.
	 *
	 * @since 1.5.0
	 * @var AnswerDensityPage
	 */
	private $answer_density_page;

	/**
	 * The Conflict Detector screen.
	 *
	 * @since 1.6.0
	 * @var ConflictDetectorPage
	 */
	private $conflict_detector_page;

	/**
	 * The settings screen and its Settings API registration.
	 *
	 * @since 1.1.0
	 * @var Settings
	 */
	private $settings;

	/**
	 * Hook suffix WordPress assigned the Answer Density screen.
	 *
	 * Captured from add_submenu_page()'s return value so the asset enqueue can
	 * target this screen exactly, rather than guessing the generated suffix.
	 *
	 * @since 1.5.0
	 * @var string|false
	 */
	private $answer_density_hook = false;

	/**
	 * Constructor.
	 *
	 * The robots module is injected rather than rebuilt here because the audit
	 * screen has to detach that exact filter instance to read the response
	 * without AIVE's own contribution.
	 *
	 * @since 1.1.0
	 *
	 * @param CrawlerLogStore    $store          Database access for the crawler log table.
	 * @param RobotsPolicy       $robots         The robots policy module.
	 * @param AnswerDensityStore $density_store  Database access for the answer density table.
	 */
	public function __construct( CrawlerLogStore $store, RobotsPolicy $robots, AnswerDensityStore $density_store ) {
		$this->dashboard_page         = new DashboardPage( $store, $density_store );
		$this->crawler_log_page       = new CrawlerLogPage( $store );
		$this->robots_audit_page      = new RobotsAuditPage( $robots );
		$this->schema_page            = new SchemaPage();
		$this->answer_density_page    = new AnswerDensityPage( $density_store );
		$this->conflict_detector_page = new ConflictDetectorPage();
		$this->settings               = new Settings();
	}

	/**
	 * Attaches the admin hooks.
	 *
	 * Both hooks only ever fire on an admin request, so this is safe to call
	 * unconditionally from the bootstrap and keeps the composition in one place
	 * rather than behind an `is_admin()` branch that would have to be repeated.
	 *
	 * @since 1.1.0
	 *
	 * @return void
	 */
	public function register_hooks() {
		add_action( 'admin_menu', array( $this, 'register_pages' ) );
		add_action( 'admin_init', array( $this->settings, 'register_settings' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'maybe_enqueue_answer_density_assets' ) );
	}

	/**
	 * Registers the menu parent and its screens.
	 *
	 * The capability passed to each registration controls who sees the menu
	 * entry. Each page callback re-checks it, because a callback is reachable by
	 * URL whether or not its menu entry was rendered.
	 *
	 * @since 1.1.0
	 *
	 * @return void
	 */
	public function register_pages() {
		add_menu_page(
			__( 'SummitCite', 'summitcite' ),
			__( 'SummitCite', 'summitcite' ),
			self::CAPABILITY,
			DashboardPage::PAGE_SLUG,
			array( $this->dashboard_page, 'render' ),
			'dashicons-chart-line'
		);

		/*
		 * Registered against the parent's own slug so the submenu reads
		 * "Dashboard" instead of repeating the parent's title, which is what
		 * WordPress shows for a parent with no matching submenu entry.
		 */
		add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'SummitCite Dashboard', 'summitcite' ),
			__( 'Dashboard', 'summitcite' ),
			self::CAPABILITY,
			DashboardPage::PAGE_SLUG,
			array( $this->dashboard_page, 'render' )
		);

		add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'AI Crawler Log', 'summitcite' ),
			__( 'Crawler Log', 'summitcite' ),
			self::CAPABILITY,
			CrawlerLogPage::PAGE_SLUG,
			array( $this->crawler_log_page, 'render' )
		);

		add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'SummitCite Robots Audit', 'summitcite' ),
			__( 'Robots Audit', 'summitcite' ),
			self::CAPABILITY,
			RobotsAuditPage::PAGE_SLUG,
			array( $this->robots_audit_page, 'render' )
		);

		add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'SummitCite Schema', 'summitcite' ),
			__( 'Schema', 'summitcite' ),
			self::CAPABILITY,
			SchemaPage::PAGE_SLUG,
			array( $this->schema_page, 'render' )
		);

		$this->answer_density_hook = add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'SummitCite Answer Density', 'summitcite' ),
			__( 'Answer Density', 'summitcite' ),
			self::CAPABILITY,
			AnswerDensityPage::PAGE_SLUG,
			array( $this->answer_density_page, 'render' )
		);

		/*
		 * Gated on the module's own enable setting, unlike every other screen
		 * in this tree: the product contract requires that disabling the
		 * Conflict Detector removes its menu entry entirely, not merely show a
		 * "switched off" notice on an otherwise reachable screen.
		 */
		if ( Helpers::is_module_enabled( ConflictDetector::SLUG ) ) {
			add_submenu_page(
				DashboardPage::PAGE_SLUG,
				__( 'SummitCite Conflict Detector', 'summitcite' ),
				__( 'Conflict Detector', 'summitcite' ),
				self::CAPABILITY,
				ConflictDetectorPage::PAGE_SLUG,
				array( $this->conflict_detector_page, 'render' )
			);
		}

		add_submenu_page(
			DashboardPage::PAGE_SLUG,
			__( 'SummitCite Settings', 'summitcite' ),
			__( 'Settings', 'summitcite' ),
			self::CAPABILITY,
			Settings::PAGE_SLUG,
			array( $this->settings, 'render' )
		);
	}

	/**
	 * Enqueues the Answer Density screen's own script, on that screen only.
	 *
	 * The increment adds zero frontend JavaScript; this is the one admin
	 * script it adds, and the hook suffix check is what keeps it off every
	 * other admin screen.
	 *
	 * @since 1.5.0
	 *
	 * @param string|mixed $hook_suffix Current admin page's hook suffix.
	 * @return void
	 */
	public function maybe_enqueue_answer_density_assets( $hook_suffix ) {
		if ( false === $this->answer_density_hook || $hook_suffix !== $this->answer_density_hook ) {
			return;
		}

		$this->answer_density_page->enqueue_assets();
	}

	/**
	 * Returns the Dashboard screen.
	 *
	 * @since 1.7.0
	 *
	 * @return DashboardPage Dashboard screen.
	 */
	public function dashboard_page() {
		return $this->dashboard_page;
	}

	/**
	 * Returns the Crawler Log screen.
	 *
	 * @since 1.1.0
	 *
	 * @return CrawlerLogPage Crawler Log screen.
	 */
	public function crawler_log_page() {
		return $this->crawler_log_page;
	}

	/**
	 * Returns the Robots Audit screen.
	 *
	 * @since 1.2.0
	 *
	 * @return RobotsAuditPage Robots Audit screen.
	 */
	public function robots_audit_page() {
		return $this->robots_audit_page;
	}

	/**
	 * Returns the Schema screen.
	 *
	 * @since 1.3.0
	 *
	 * @return SchemaPage Schema screen.
	 */
	public function schema_page() {
		return $this->schema_page;
	}

	/**
	 * Returns the Answer Density screen.
	 *
	 * @since 1.5.0
	 *
	 * @return AnswerDensityPage Answer Density screen.
	 */
	public function answer_density_page() {
		return $this->answer_density_page;
	}

	/**
	 * Returns the Conflict Detector screen.
	 *
	 * @since 1.6.0
	 *
	 * @return ConflictDetectorPage Conflict Detector screen.
	 */
	public function conflict_detector_page() {
		return $this->conflict_detector_page;
	}

	/**
	 * Returns the settings screen.
	 *
	 * @since 1.1.0
	 *
	 * @return Settings Settings screen.
	 */
	public function settings() {
		return $this->settings;
	}
}