<?php
/**
 * First-run welcome: redirect once on activation to a single-screen welcome that drives
 * the one action that creates the "aha": flagging a first image and seeing the badge.
 *
 * The screen renders inside the dashboard's own `.plugin-ui` shell and loads the same
 * stylesheet, so it inherits the deployer's chosen skin (Neo / classic) and light/dark
 * mode automatically rather than duplicating the palette.
 *
 * @package AIM_Transparency
 */

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

/**
 * Handles the post-activation welcome screen and its one-time redirect.
 *
 * @since 1.2.3
 */
class AICL_Welcome {

	/** Hidden admin page slug for the welcome screen. */
	const SLUG = 'aim-transparency-welcome';

	/** Transient set on activation to trigger a single redirect. */
	const REDIRECT_FLAG = 'aicl_activation_redirect';

	/** Option recording that the welcome screen has been shown once. */
	const SEEN_OPTION = 'aicl_welcomed';

	/**
	 * Registers the redirect handler, the hidden welcome page, and its assets.
	 *
	 * @since 1.2.3
	 *
	 * @return void
	 */
	public function hooks() {
		add_action( 'admin_init', array( $this, 'maybe_redirect' ) );
		add_action( 'admin_menu', array( $this, 'register_page' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'assets' ) );
	}

	/**
	 * Flags a one-time redirect. Called from the plugin activation hook.
	 *
	 * @since 1.2.3
	 *
	 * @return void
	 */
	public static function flag_redirect() {
		if ( ! get_option( self::SEEN_OPTION ) ) {
			set_transient( self::REDIRECT_FLAG, 1, 30 );
		}
	}

	/**
	 * Redirects to the welcome screen once, right after a single-plugin activation.
	 *
	 * Skips bulk activations, network activation, AJAX, and users who cannot manage
	 * options, so the redirect only fires for the person who just turned the plugin on.
	 *
	 * @since 1.2.3
	 *
	 * @return void
	 */
	public function maybe_redirect() {
		if ( ! get_transient( self::REDIRECT_FLAG ) ) {
			return;
		}

		delete_transient( self::REDIRECT_FLAG );

		if ( wp_doing_ajax() || is_network_admin() || ! current_user_can( 'manage_options' ) ) {
			return;
		}

		// A bulk plugin activation passes activate-multi; don't hijack that flow.
		if ( isset( $_GET['activate-multi'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only guard, no state change.
			return;
		}

		update_option( self::SEEN_OPTION, 1 );

		/*
		 * Activation lands on the set-up flow, not on this screen. Onboarding was split in two: this
		 * page explained what the plugin does, while the screen that actually configures the site sat
		 * behind a tab a new deployer had to go and find. Sending them straight to the flow means the
		 * first thing they meet is the one that changes something.
		 */
		wp_safe_redirect( admin_url( 'admin.php?page=' . AICL_Dashboard::SLUG ) );
		exit;
	}

	/**
	 * The welcome screen is no longer registered as a menu item.
	 *
	 * Onboarding was spread over three surfaces saying overlapping things: this screen explained what
	 * the plugin does, the report now opens with a plain verdict, and the set-up flow explains while it
	 * configures. Activation goes to the flow, so a "Getting started" entry parked in the menu forever
	 * was a fourth route to something a deployer only needs once. The page itself stays registered as a
	 * hidden route so any bookmark or old link still resolves.
	 *
	 * @since 2.0.0
	 *
	 * @return void
	 */
	public function register_page() {
		add_submenu_page(
			null,
			__( 'Getting started', 'aim-transparency' ),
			__( 'Getting started', 'aim-transparency' ),
			'manage_options',
			self::SLUG,
			array( $this, 'render' )
		);
	}

	/**
	 * Loads the dashboard stylesheet + fonts on the welcome screen so it matches the
	 * deployer's chosen theme.
	 *
	 * @since 1.2.3
	 *
	 * @param string $hook The current admin page hook suffix.
	 * @return void
	 */
	public function assets( $hook ) {
		if ( ! isset( $_GET['page'] ) || self::SLUG !== $_GET['page'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only screen check.
			return;
		}

		$ver = defined( 'AICL_VERSION' ) ? AICL_VERSION : false;

		wp_enqueue_style( 'aicl-welcome-geist', AICL_URL . 'dashboard/assets/fonts/geist.css', array(), $ver );
		wp_enqueue_style( 'aicl-welcome-family', AICL_URL . 'dashboard/assets/fonts/family.css', array(), $ver );
		wp_enqueue_style( 'aicl-welcome-app', AICL_URL . 'dashboard/assets/app.css', array(), $ver );
	}

	/**
	 * Renders the one-screen welcome: what it does, then a single primary action.
	 *
	 * @since 1.2.3
	 *
	 * @return void
	 */
	public function render() {
		$dash      = AICL_Dashboard::SLUG;
		$flag_url  = admin_url( 'admin.php?page=' . $dash . '#media' );
		$badge_url = admin_url( 'admin.php?page=' . $dash . '#badge' );
		$skip_url  = admin_url( 'admin.php?page=' . $dash );

		$art_neo     = AICL_URL . 'dashboard/assets/scenes/welcome-art-neo.webp';
		$art_classic = AICL_URL . 'dashboard/assets/scenes/welcome-art-classic.webp';

		// Skin is stored in a cookie by the dashboard; mode is corrected client-side below.
		$skin = ( isset( $_COOKIE['pui_skin'] ) && 'classic' === $_COOKIE['pui_skin'] ) ? 'classic' : 'neo'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display-only theme hint.

		$steps = array(
			array(
				'head' => __( 'Flag an image', 'aim-transparency' ),
				'body' => __( 'Pick any image and choose how it was made: AI Generated, or a human type like Camera Photo.', 'aim-transparency' ),
			),
			array(
				'head' => __( 'See the badge', 'aim-transparency' ),
				'body' => __( 'A clear "AI-generated" badge appears on the image on your site. That is the visible disclosure Article 50 asks for.', 'aim-transparency' ),
			),
			array(
				'head' => __( 'It is recorded, too', 'aim-transparency' ),
				'body' => __( 'The machine-readable IPTC/XMP mark is embedded in the file and mirrored as JSON-LD, automatically.', 'aim-transparency' ),
			),
		);
		?>
		<div class="plugin-ui aicl-w" id="aicl-w" data-skin="<?php echo esc_attr( $skin ); ?>" data-theme="light">
			<script>
				( function () {
					try {
						var w = document.getElementById( 'aicl-w' );
						var ck = document.cookie.match( /(?:^|; )pui_skin=([^;]*)/ );
						var skin = ck ? decodeURIComponent( ck[1] ) : localStorage.getItem( 'pui:skin' );
						if ( 'classic' === skin || 'neo' === skin ) { w.setAttribute( 'data-skin', skin ); }
						var mode = localStorage.getItem( 'pui:mode' );
						var sys = window.matchMedia && window.matchMedia( '(prefers-color-scheme: dark)' ).matches;
						var dark = 'dark' === mode || ( ( 'auto' === mode || ! mode ) && sys );
						w.setAttribute( 'data-theme', dark ? 'dark' : 'light' );
					} catch ( e ) {}
				} )();
			</script>
			<style>
				/* The dashboard reads as one sheet divided by hairlines; this screen is
				   the same object, so the steps are hairline rows with station discs
				   rather than a gapped list of filled chips. */
				.aicl-w { min-height: calc(100vh - 32px); margin: -10px -20px 0 -22px; padding: 48px 28px; box-sizing: border-box; background: var(--bg); color: var(--text); font-family: var(--font); }
				.aicl-w * { box-sizing: border-box; }
				.aicl-w-card { max-width: 980px; margin: 0 auto; background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius-lg); overflow: hidden; display: grid; grid-template-columns: 0.86fr 1.14fr; }
				.plugin-ui[data-skin='neo'] .aicl-w-card { border-width: 2px; box-shadow: 5px 5px 0 var(--border); }
				.aicl-w-media { position: relative; overflow: hidden; border-right: 1px solid var(--border); background: var(--sidebar); min-height: 470px; }
				.aicl-w-art { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; object-position: 50% 44%; display: none; }
				.plugin-ui[data-skin='neo'] .aicl-w-art-neo { display: block; }
				.plugin-ui[data-skin='classic'] .aicl-w-art-classic { display: block; }
				.aicl-w-chip { position: absolute; top: 20px; left: 20px; z-index: 2; display: inline-flex; align-items: center; gap: 7px; background: #0a0a0c; color: #fff; border-radius: var(--radius-pill); padding: 5px 13px 5px 5px; font-size: 12px; font-weight: 600; box-shadow: 0 4px 14px rgba(0,0,0,.22); }
				.aicl-w-chip .ai { display: inline-grid; place-items: center; width: 20px; height: 20px; border-radius: 50%; background: #fff; color: #0a0a0c; font-weight: 800; font-size: 9px; }

				.aicl-w-head { padding: 40px 42px 26px; }
				.aicl-w-eyebrow { display: inline-flex; align-items: center; gap: 8px; font-size: 10.5px; font-weight: 700; letter-spacing: .12em; text-transform: uppercase; color: var(--accent); }
				.aicl-w-head h1 { font-size: 29px; letter-spacing: -.025em; line-height: 1.1; margin: 15px 0 10px; color: var(--text); font-family: var(--font-disp, var(--font)); }
				.aicl-w-lead { font-size: 14.5px; line-height: 1.62; color: var(--muted); margin: 0; max-width: 46ch; }

				.aicl-w-steps { border-top: 1px solid var(--border); }
				.aicl-w-step { display: grid; grid-template-columns: 34px 1fr; gap: 15px; align-items: start; padding: 16px 42px; border-top: 1px solid var(--border); }
				.aicl-w-step:first-child { border-top: 0; }
				.aicl-w-step .num { display: grid; place-items: center; width: 30px; height: 30px; border-radius: 50%; border: 1.5px solid var(--border); background: transparent; color: var(--accent); font-family: var(--font-mono); font-weight: 700; font-size: 11.5px; letter-spacing: .02em; }
				.aicl-w-step .h { font-weight: 650; font-size: 14.5px; color: var(--text); margin: 5px 0 3px; }
				.aicl-w-step .b { font-size: 13.5px; line-height: 1.55; color: var(--muted); max-width: 52ch; }

				.aicl-w-actions { display: flex; align-items: center; gap: 16px; flex-wrap: wrap; padding: 24px 42px; border-top: 1px solid var(--border); }
				.aicl-w-actions .btn { font-size: 14.5px; padding: 11px 20px; }
				.plugin-ui .aicl-w-skip { font-size: 14px; color: var(--muted); text-decoration: none; }
				.plugin-ui .aicl-w-skip:hover { color: var(--text); }
				.aicl-w-links { display: flex; flex-wrap: wrap; gap: 20px; padding: 18px 42px; border-top: 1px solid var(--border); background: var(--hover); font-size: 13px; }
				.plugin-ui .aicl-w-links a { color: var(--muted); text-decoration: none; display: inline-flex; align-items: center; gap: 7px; }
				.plugin-ui .aicl-w-links a:hover { color: var(--accent); }
				@media (max-width: 820px) {
					.aicl-w { padding: 24px 12px; }
					.aicl-w-card { grid-template-columns: 1fr; }
					.aicl-w-media { min-height: 300px; border-right: 0; border-bottom: 1px solid var(--border); }
					.aicl-w-head { padding: 28px 24px 20px; }
					.aicl-w-step { padding: 14px 24px; grid-template-columns: 30px 1fr; gap: 12px; }
					.aicl-w-actions, .aicl-w-links { padding: 20px 24px; }
				}
			</style>

			<div class="aicl-w-card">
				<div class="aicl-w-media">
					<span class="aicl-w-chip"><span class="ai">AI</span> <?php esc_html_e( 'AI Generated', 'aim-transparency' ); ?></span>
					<img class="aicl-w-art aicl-w-art-neo" src="<?php echo esc_url( $art_neo ); ?>" alt="<?php esc_attr_e( 'A quiet studio scene: the AIM Transparency character labelling a framed picture', 'aim-transparency' ); ?>" />
					<img class="aicl-w-art aicl-w-art-classic" src="<?php echo esc_url( $art_classic ); ?>" alt="" aria-hidden="true" />
				</div>
				<div class="aicl-w-body">
					<div class="aicl-w-head">
					<span class="aicl-w-eyebrow">
						<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3"><path d="M20 6 9 17l-5-5"/></svg>
						<?php esc_html_e( 'Plugin activated', 'aim-transparency' ); ?>
					</span>
					<h1><?php esc_html_e( 'You are set up.', 'aim-transparency' ); ?><br><?php esc_html_e( 'Let us label your first image.', 'aim-transparency' ); ?></h1>
					<p class="aicl-w-lead"><?php esc_html_e( 'AIM Transparency helps your WordPress site meet EU AI Act Article 50 with a visible AI-content badge plus machine-readable provenance. It takes about a minute to see it work.', 'aim-transparency' ); ?></p>
					</div>

					<div class="aicl-w-steps">
						<?php
						$i = 0;
						foreach ( $steps as $step ) :
							++$i;
							?>
							<div class="aicl-w-step">
								<span class="num"><?php echo esc_html( str_pad( (string) $i, 2, '0', STR_PAD_LEFT ) ); ?></span>
								<div>
									<div class="h"><?php echo esc_html( $step['head'] ); ?></div>
									<div class="b"><?php echo esc_html( $step['body'] ); ?></div>
								</div>
							</div>
						<?php endforeach; ?>
					</div>

					<div class="aicl-w-actions">
						<a class="btn btn-primary" href="<?php echo esc_url( $flag_url ); ?>">
							<?php esc_html_e( 'Flag my first image', 'aim-transparency' ); ?>
							<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" style="margin-left:2px"><path d="M5 12h14m-6-6 6 6-6 6"/></svg>
						</a>
						<a class="aicl-w-skip" href="<?php echo esc_url( $skip_url ); ?>"><?php esc_html_e( 'Skip to the dashboard', 'aim-transparency' ); ?></a>
					</div>

					<div class="aicl-w-links">
						<a href="<?php echo esc_url( $badge_url ); ?>">
							<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M12 2 4 5v6c0 5 3.4 8.5 8 11 4.6-2.5 8-6 8-11V5z"/></svg>
							<?php esc_html_e( 'Style the badge', 'aim-transparency' ); ?>
						</a>
						<a href="https://aimtransparency.com/docs" target="_blank" rel="noopener">
							<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M4 4h11a3 3 0 0 1 3 3v13H7a3 3 0 0 0-3 3z"/><path d="M18 4h2v16"/></svg>
							<?php esc_html_e( 'Read the docs', 'aim-transparency' ); ?>
						</a>
						<a href="https://aimtransparency.com/eu-ai-act-wordpress" target="_blank" rel="noopener">
							<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M12 3a15 15 0 0 1 0 18M12 3a15 15 0 0 0 0 18M3 12h18"/><circle cx="12" cy="12" r="9"/></svg>
							<?php esc_html_e( 'The Article 50 guide', 'aim-transparency' ); ?>
						</a>
					</div>
				</div>
			</div>
		</div>
		<?php
	}
}