<?php
/**
 * Abstract Admin Controller.
 *
 * Provides shared functionality for admin controllers.
 *
 * @package Accessibility_Audio_TTS
 */

namespace Accessibility_Audio_TTS\Abstracts;

use Accessibility_Audio_TTS\Abstracts\Abstract_Base_Component;
if ( ! defined( 'ABSPATH' ) ) {
	exit; }

/**
 * Abstract Admin Controller.
 *
 * Base class for admin controller components.
 *
 * @package Accessibility_Audio_TTS
 * @subpackage Abstracts
 * @since 1.0.0
 */

// Prevent direct access.
/**
 * Abstract admin controller class.
 *
 * @since 1.0.0
 */
abstract class Abstract_Admin_Controller extends Abstract_Base_Component {

	/**
	 * Page slug.
	 *
	 * @since 1.0.0
	 * @var string
	 */
	protected string $page_slug = '';

	/**
	 * Page title.
	 *
	 * @since 1.0.0
	 * @var string
	 */
	protected string $page_title = '';

	/**
	 * Menu title.
	 *
	 * @since 1.0.0
	 * @var string
	 */
	protected string $menu_title = '';

	/**
	 * Required capability.
	 *
	 * @since 1.0.0
	 * @var string
	 */
	protected string $capability = 'manage_options';

	/**
	 * Setup WordPress hooks.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	protected function setup_hooks(): void {
		add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
		add_action( 'admin_init', array( $this, 'admin_init' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_scripts' ) );
	}

	/**
	 * Add admin menu.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	abstract public function add_admin_menu(): void;

	/**
	 * Initialize admin functionality.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	public function admin_init(): void {
		$this->register_settings();
		$this->setup_admin_notices();
	}

	/**
	 * Enqueue admin scripts and styles.
	 *
	 * @since 1.0.0
	 * @param string $hook_suffix Current admin page hook suffix.
	 * @return void
	 */
	public function enqueue_admin_scripts( string $hook_suffix ): void {
		if ( ! $this->is_current_page( $hook_suffix ) ) {
			return;
		}

		$this->enqueue_scripts();
		$this->enqueue_styles();
	}

	/**
	 * Render admin page.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	abstract public function render_page(): void;

	/**
	 * Register settings.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	abstract protected function register_settings(): void;

	/**
	 * Enqueue scripts.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	abstract protected function enqueue_scripts(): void;

	/**
	 * Enqueue styles.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	abstract protected function enqueue_styles(): void;

	/**
	 * Check if current page matches this controller.
	 *
	 * @since 1.0.0
	 * @param string $hook_suffix Hook suffix.
	 * @return bool True if current page.
	 */
	protected function is_current_page( string $hook_suffix ): bool {
		return false !== strpos( $hook_suffix, $this->page_slug );
	}

	/**
	 * Setup admin notices.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	protected function setup_admin_notices(): void {
		add_action( 'admin_notices', array( $this, 'display_admin_notices' ) );
	}

	/**
	 * Display admin notices.
	 *
	 * @since 1.0.0
	 * @return void
	 */
	public function display_admin_notices(): void {
		// Override in child classes if needed.
	}

	/**
	 * Get default configuration.
	 *
	 * @since 1.0.0
	 * @return array Default configuration.
	 */
	protected function get_default_config(): array {
		return array(
			'page_slug'  => $this->page_slug,
			'page_title' => $this->page_title,
			'menu_title' => $this->menu_title,
			'capability' => $this->capability,
		);
	}
}