<?php
/**
 * AIFORYA Shell — coquille admin partagée par toutes les extensions AIFORYA.
 *
 * Architecture v35 doctrine 27/04 (la "doctrine frames" de ) :
 * Au lieu que chaque plugin génère son propre header / nav / page-template / CSS,
 * un SEUL shell est injecté dans toutes les extensions. Chaque plugin appelle
 * simplement AIFORYA_FAQ_Shell::render_admin_page([...]) avec ses tabs et callbacks.
 *
 * Le LLM ne génère QUE :
 *   1. Un main file ~30 lignes qui appelle AIFORYA_FAQ_Shell::render_admin_page()
 *   2. Des classes Tab avec une méthode render() retournant du HTML métier
 *
 * Plus aucune génération de :
 *   - balise de style inline, wp_enqueue_style, admin.css plugin-spécifique
 *   - Header / nav-tabs / page-template (admin/views/index.php)
 *   - register_plugin_page custom complexe
 *   - page-support.php / page-avis.php
 *
 * @package Aiforya_Shell
 * @since   1.0.0 (27/04/2026)
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( class_exists( 'AIFORYA_FAQ_Shell', false ) ) {
	return; // Idempotent : le shell est inclus par chaque plugin via require_once.
}

class AIFORYA_FAQ_Shell {

	const VERSION = '1.2.1'; // Bumped 29/04 ~12h — widget activation footer universel (license partial + tier + activated_at + site_domain + bouton Désactiver) + handler AJAX aiforya_deactivate

	/**
	 * Hook l'enqueue des assets shell sur toutes les pages admin AIFORYA.
	 * Appelé une seule fois (idempotent) au plugins_loaded.
	 */
	public static function init(): void {
		if ( did_action( 'aiforya_shell_init' ) ) {
			return;
		}
		add_action( 'admin_enqueue_scripts', [ __CLASS__, 'maybe_enqueue_assets' ] );
		do_action( 'aiforya_shell_init' );
	}

	/**
	 * Charge le CSS+JS shell sur les pages plugin AIFORYA et sur le Hub.
	 * Détecté par le hook WP : 'aiforya_page_*' (sous-pages Hub) ou 'toplevel_page_aiforya-hub'.
	 *
	 * @param string $hook Le hook WP de la page admin courante.
	 */
	public static function maybe_enqueue_assets( string $hook ): void {
		// Match large : tous les hooks qui contiennent "aiforya" (Hub + sous-pages,
		// quelle que soit la convention WP utilisée — `aiforya_page_*`, `aiforya-hub_page_*`,
		// `toplevel_page_aiforya-hub`, etc.).
		if ( strpos( $hook, 'aiforya' ) === false ) {
			return;
		}

		$base_url = self::get_assets_base_url();

		wp_enqueue_style(
			'aiforya-shell',
			$base_url . 'assets/aiforya-shell.css',
			[],
			self::VERSION
		);

		// JS shell optionnel.
		if ( file_exists( self::get_assets_dir() . 'aiforya-shell.js' ) ) {
			wp_enqueue_script(
				'aiforya-shell',
				$base_url . 'assets/aiforya-shell.js',
				[ 'jquery' ],
				self::VERSION,
				true
			);
		}

		// Modules shared Support + Avis (chargés sur toutes les pages plugin pour AJAX).

		// v1.2.1 : activation.js enqueue partout pour le bouton Désactiver
		// du widget activation footer. activation.js est aussi enqueue par
		// Aiforya_Activation::render_page() mais on sécurise via wp_script_is.
		if ( file_exists( self::get_assets_dir() . 'activation.js' ) && ! wp_script_is( 'aiforya-activation', 'enqueued' ) ) {
			wp_enqueue_script(
				'aiforya-activation',
				$base_url . 'assets/activation.js',
				[ 'jquery' ],
				self::VERSION,
				true
			);
		}
	}

	/**
	 * Dossier physique des assets shell : vendor-aiforya/assets/.
	 */
	private static function get_assets_dir(): string {
		return __DIR__ . '/assets/';
	}

	/**
	 * URL des assets shell — utilise plugin_dir_url(__FILE__) qui retourne
	 * directement l'URL du dossier vendor-aiforya/ contenant ce fichier.
	 */
	private static function get_assets_base_url(): string {
		return plugin_dir_url( __FILE__ ); // = .../wp-content/plugins/{plugin}/vendor-aiforya/
	}

	/**
	 * Méthode principale : rend une page admin complète (header + nav + container + footer).
	 *
	 * @param array $args {
	 *   @type string $slug              Slug de la page admin (ex: 'aiforya-cart-recovery-ai').
	 *   @type string $title             Titre du plugin affiché dans le header.
	 *   @type string $description       Sous-titre affiché sous le titre (optionnel).
	 *   @type array  $tabs              Tableau associatif [tab_slug => ['label' => ..., 'callback' => callable]].
	 *   @type bool   $support_module    Si true, ajoute auto un onglet 'support' avec Support+Avis 2 colonnes.
	 *   @type string $logo_url          URL du logo AIFORYA (défaut : auto depuis assets/).
	 *   @type string $plugin_basename   Basename du plugin (ex: 'aiforya-cart-recovery-ai/aiforya-cart-recovery-ai.php')
	 *                                   utilisé pour Support form.
	 * }
	 */
	public static function render_admin_page( array $args ): void {
		$defaults = [
			'slug'            => '',
			'title'           => '',
			'description'     => '',
			'tabs'            => [],
			'support_module'  => false,
			'logo_url'        => self::get_assets_base_url() . 'assets/aiforya-logo.svg',
			'plugin_basename' => '',
		];
		$args = array_merge( $defaults, $args );

		// Onglet actif : depuis $_GET['tab'] ou premier tab.
		$first_tab  = $args['tabs'] ? array_key_first( $args['tabs'] ) : '';
		// Read-only tab navigation: the value is sanitized with sanitize_key() and then
		// validated against the whitelist of declared tabs below. Nothing is written, and a
		// nonce here would break every admin tab link and bookmark.
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only tab navigation, sanitized with sanitize_key() and validated against the declared tabs; no state change.
		$active_tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : $first_tab;
		if ( ! isset( $args['tabs'][ $active_tab ] ) ) {
			$active_tab = $first_tab;
		}

		?>
		<div class="wrap aiforya-admin-wrap aiforya-ui-page aiforya-shell">

			<header class="aiforya-shell__header">
				<div class="aiforya-shell__header-left">
					<h1 class="aiforya-shell__title"><?php echo esc_html( $args['title'] ); ?></h1>
					<?php if ( ! empty( $args['description'] ) ) : ?>
						<p class="aiforya-shell__description"><?php echo esc_html( $args['description'] ); ?></p>
					<?php endif; ?>
				</div>
				<div class="aiforya-shell__header-right">
					<img src="<?php echo esc_url( $args['logo_url'] ); ?>"
					     alt="AIFORYA"
					     class="aiforya-shell__logo"
					     onerror="this.style.display='none';">
				</div>
			</header>

			<?php if ( count( $args['tabs'] ) > 0 ) : ?>
				<?php /* Mobile nav : <select> natif synchronisé avec la nav desktop.
				         Visible uniquement < 782px (cf aiforya-shell.css §13b). */ ?>
				<select class="aiforya-shell__mobile-nav" aria-label="<?php esc_attr_e( 'Tab navigation', 'aiforya-faq-generator' ); ?>" onchange="if(this.value)window.location.href=this.value">
					<?php foreach ( $args['tabs'] as $tab_slug => $tab_def ) :
						$mn_url    = add_query_arg(
							[ 'page' => $args['slug'], 'tab' => $tab_slug ],
							admin_url( 'admin.php' )
						);
						$mn_label  = $tab_def['label'] ?? $tab_def['title'] ?? $tab_slug;
						$mn_active = ( $tab_slug === $active_tab );
						?>
						<option value="<?php echo esc_url( $mn_url ); ?>" <?php echo $mn_active ? 'selected' : ''; ?>>
							<?php echo esc_html( $mn_label ); ?>
						</option>
					<?php endforeach; ?>
				</select>

				<nav class="aiforya-shell__tabs" role="tablist">
					<?php foreach ( $args['tabs'] as $tab_slug => $tab_def ) :
						$url       = add_query_arg(
							[ 'page' => $args['slug'], 'tab' => $tab_slug ],
							admin_url( 'admin.php' )
						);
						$is_active = ( $tab_slug === $active_tab );
						?>
						<a href="<?php echo esc_url( $url ); ?>"
						   role="tab"
						   aria-selected="<?php echo $is_active ? 'true' : 'false'; ?>"
						   class="aiforya-shell__tab<?php echo $is_active ? ' is-active' : ''; ?>">
							<?php
							// Doctrine v36 : accepter `label` (canonique) ou `title` (variante LLM).
							$tab_label = $tab_def['label'] ?? $tab_def['title'] ?? $tab_slug;
							echo esc_html( $tab_label );
							?>
						</a>
					<?php endforeach; ?>
				</nav>
			<?php endif; ?>

			<main class="aiforya-shell__content" role="tabpanel">
				<?php
				$tab_def  = $args['tabs'][ $active_tab ] ?? null;
				// Doctrine v36 : accepter `callback` (canonique) ou `render_callback` (variante LLM).
				$callback = $tab_def['callback'] ?? $tab_def['render_callback'] ?? null;
				if ( is_callable( $callback ) ) {
					call_user_func( $callback, $args );
				} elseif ( $tab_def ) {
					printf(
						'<div class="aiforya-card"><p>%s</p></div>',
						esc_html__( 'This tab has no valid render callback.', 'aiforya-faq-generator' )
					);
				} else {
					printf(
						'<div class="aiforya-card"><p>%s</p></div>',
						esc_html__( 'No tab configured for this plugin.', 'aiforya-faq-generator' )
					);
				}
				?>
			</main>

			<?php
			?>

			<footer class="aiforya-shell__footer">
				<span class="aiforya-shell__footer-text">
					<?php echo esc_html__( 'AIFORYA', 'aiforya-faq-generator' ); ?>
					<span class="aiforya-shell__footer-sep">·</span>
					<?php echo esc_html__( 'AI-Driven Software Factory', 'aiforya-faq-generator' ); ?>
				</span>
			</footer>

		</div>
		<?php
	}

	/**
	 * Helper utilitaire pour les classes Tab : enregistre une page Hub
	 * (raccourci pour AIFORYA_Hub::register_plugin_page).
	 *
	 * Le main file plugin doit appeler ceci dans plugins_loaded prio 20.
	 */
	public static function register_with_hub( array $args ): void {
		if ( ! class_exists( 'AIFORYA_Hub' ) || ! is_admin() ) {
			return;
		}
		AIFORYA_Hub::register_plugin_page( [
			'slug'         => $args['slug'],
			'page_title'   => $args['title'],
			'menu_title'   => $args['title'],
			'plugin_name'  => $args['title'],
			'plugin_image' => $args['plugin_image'] ?? '',
			'category'     => $args['category'] ?? '',
			'description'  => $args['description'] ?? '',
			'capability'   => $args['capability'] ?? 'manage_options',
			'callback'     => function () use ( $args ) {
				AIFORYA_FAQ_Shell::render_admin_page( $args );
			},
			'icon'         => $args['icon'] ?? 'dashicons-admin-generic',
			'position'     => $args['position'] ?? 20,
		] );
	}
}

// Auto-init au plugins_loaded — idempotent grâce à did_action.
add_action( 'plugins_loaded', [ 'AIFORYA_FAQ_Shell', 'init' ], 5 );