<?php
/**
 * Centralized user-facing strings for WPPilot.
 *
 * Every string the plugin shows to a human lives here. This makes
 * voice-polish a one-file job and keeps the rest of the codebase
 * free of scattered translatable literals.
 *
 * Usage:  Strings::admin_page_title()   — returns __( '…', 'wingpilot' )
 *         Strings::all_js()             — returns array for wp_localize_script
 *
 * @package WPPilot
 */

namespace WPPilot;

defined( 'ABSPATH' ) || exit;

class Wppilot_Strings {

	/* ---------------------------------------------------------------
	 * Admin menu & page chrome
	 * ------------------------------------------------------------- */

	public static function page_title(): string {
		return __( 'WPPilot Settings', 'wingpilot' );
	}

	public static function menu_label(): string {
		return __( 'WPPilot', 'wingpilot' );
	}

	public static function heading(): string {
		return __( 'WPPilot', 'wingpilot' );
	}

	public static function hero_tagline(): string {
		return __( 'Your site, understood. WPPilot watches, explains, and helps improve your WordPress site from the cockpit.', 'wingpilot' );
	}

	/* ---------------------------------------------------------------
	 * Dashboard sections (product page)
	 * ------------------------------------------------------------- */

	public static function briefing_heading(): string {
		return __( 'What WPPilot sees', 'wingpilot' );
	}

	public static function briefing_empty(): string {
		return __( 'No Briefing yet. Open WPPilot to generate your site’s first Briefing — a full read of what your site is, what’s working, and what needs attention.', 'wingpilot' );
	}

	public static function briefing_running(): string {
		return __( 'WPPilot is reading your site. Open WPPilot to watch your Briefing come together.', 'wingpilot' );
	}

	public static function briefing_attention_heading(): string {
		return __( 'Needs attention', 'wingpilot' );
	}

	public static function view_full_briefing(): string {
		return __( 'View full Briefing', 'wingpilot' );
	}

	public static function activity_heading(): string {
		return __( 'Recent activity', 'wingpilot' );
	}

	public static function activity_empty(): string {
		return __( 'No activity yet. Open WPPilot to get started.', 'wingpilot' );
	}

	public static function connection_details_heading(): string {
		return __( 'Connection details', 'wingpilot' );
	}

	/* ---------------------------------------------------------------
	 * Connection status card
	 * ------------------------------------------------------------- */

	public static function connection_status(): string {
		return __( 'Connection Status', 'wingpilot' );
	}

	public static function status_connected(): string {
		return __( 'Connected', 'wingpilot' );
	}

	public static function status_not_connected(): string {
		return __( 'Not Connected', 'wingpilot' );
	}

	/**
	 * The state between "this site proved it controls a WordPress install" and
	 * "a WPPilot account manages this site". Registering transport is real work
	 * and we do not pretend it did not happen — but it is not a connection to
	 * the owner's account, and saying "Connected" here is how a site ends up
	 * looking finished while no account owns it.
	 */
	public static function status_setup_incomplete(): string {
		return __( 'Setup incomplete', 'wingpilot' );
	}

	/** The pairing must be re-established before anything else works. */
	public static function status_needs_reconnect(): string {
		return __( 'Connection needs attention', 'wingpilot' );
	}

	public static function needs_reconnect_body(): string {
		return __( 'WPPilot no longer accepts this site\'s connection, so monitoring is paused and nothing is being sent. Reconnecting takes a moment and keeps your existing history.', 'wingpilot' );
	}

	/** Paired, but WPPilot did not answer just now. Not a verdict either way. */
	public static function status_unavailable(): string {
		return __( 'Status unavailable', 'wingpilot' );
	}

	public static function account_link_required(): string {
		return __(
			'This site is registered with WPPilot but is not linked to a WPPilot account yet. Finish connecting to start getting briefings and monitoring.',
			'wingpilot'
		);
	}

	public static function site_id_label(): string {
		return __( 'Site ID', 'wingpilot' );
	}

	public static function site_secret_label(): string {
		return __( 'Site Secret', 'wingpilot' );
	}

	public static function site_secret_hint(): string {
		return __( 'Copy this secret and paste it at app.getwppilot.com to connect your site.', 'wingpilot' );
	}

	public static function copy_button(): string {
		return __( 'Copy', 'wingpilot' );
	}

	public static function open_wppilot(): string {
		return __( 'Open WPPilot', 'wingpilot' );
	}

	/* ---------------------------------------------------------------
	 * Connect / disconnect
	 * ------------------------------------------------------------- */

	public static function connect_description(): string {
		return __( 'Connect this WordPress site to WPPilot for site understanding, security monitoring, and AI-powered briefings.', 'wingpilot' );
	}

	public static function connect_button(): string {
		return __( 'Connect to WPPilot', 'wingpilot' );
	}

	public static function authorize_button(): string {
		return __( 'Authorize WPPilot', 'wingpilot' );
	}

	public static function authorize_description(): string {
		return __( 'Already connected. Open WPPilot and authorize this site in one click.', 'wingpilot' );
	}

	public static function manual_connect_hint(): string {
		return __( 'Prefer to connect manually? Copy your Site Secret below and paste it at app.getwppilot.com.', 'wingpilot' );
	}

	public static function emergency_disconnect_heading(): string {
		return __( 'Emergency Disconnect', 'wingpilot' );
	}

	public static function emergency_disconnect_description(): string {
		return __( 'Disconnect this site from WPPilot and revoke active tokens.', 'wingpilot' );
	}

	public static function emergency_disconnect_button(): string {
		return __( 'Emergency Disconnect', 'wingpilot' );
	}

	/* ---------------------------------------------------------------
	 * Notices & errors
	 * ------------------------------------------------------------- */

	public static function notice_connected(): string {
		return __( 'Successfully connected to WPPilot.', 'wingpilot' );
	}

	public static function notice_disconnected(): string {
		return __( 'Disconnected from WPPilot.', 'wingpilot' );
	}

	public static function notice_reconnected(): string {
		return __( 'Reconnected. WPPilot recognises this site again and monitoring has resumed.', 'wingpilot' );
	}

	/**
	 * @param string $reason Why it failed.
	 */
	public static function notice_connect_failed( string $reason ): string {
		/* translators: %s: the reason connecting failed. */
		return sprintf( __( 'Could not connect to WPPilot. %s', 'wingpilot' ), $reason );
	}

	/**
	 * @param string $reason Why it failed.
	 */
	public static function notice_reconnect_failed( string $reason ): string {
		/* translators: %s: the reason reconnecting failed. */
		return sprintf( __( 'Reconnecting did not complete. %s The old connection was removed, so choose "Connect to WPPilot" to try again.', 'wingpilot' ), $reason );
	}

	/**
	 * @param string $reason Why it failed.
	 */
	public static function notice_open_failed( string $reason ): string {
		/* translators: %s: the reason opening WPPilot failed. */
		return sprintf( __( 'Could not open WPPilot. %s', 'wingpilot' ), $reason );
	}

	public static function no_reason_given(): string {
		return __( 'Please try again in a minute.', 'wingpilot' );
	}

	/** The label of the collapsed technical line under a failure. */
	public static function technical_detail_label(): string {
		return __( 'Technical detail for support', 'wingpilot' );
	}

	/**
	 * What an owner can do about a failed connect, reconnect or open.
	 *
	 * One sentence per Connect_Failure kind, in the owner's terms. The raw
	 * cause (an HTTP status, a cURL error) is never part of it; it is shown
	 * separately, collapsed, for support.
	 *
	 * @param string $kind A Connect_Failure constant.
	 */
	public static function connect_guidance( string $kind ): string {
		switch ( $kind ) {
			case Connect_Failure::SITE_UNREACHABLE:
				return __( 'WPPilot could not reach this site over the internet. The site must be publicly reachable: a site on localhost, on a private network, or behind a "coming soon" or maintenance page cannot be connected. If the site is public, please try again in a minute.', 'wingpilot' );
			case Connect_Failure::SITE_BLOCKED:
				return __( 'This site turned WPPilot\'s check away. A security plugin, a firewall (your host\'s, Cloudflare or similar) or password protection is probably blocking requests to /wp-json/. Allow requests to /wp-json/wppilot/v1/, then try again.', 'wingpilot' );
			case Connect_Failure::REST_UNAVAILABLE:
				return __( 'WPPilot could not find this site\'s REST API at /wp-json/. A security plugin or setting may have turned it off, or the permalinks may need refreshing: open Settings, then Permalinks, and choose Save Changes. Then try again.', 'wingpilot' );
			case Connect_Failure::SITE_ERROR:
				return __( 'This site answered WPPilot\'s check with an error. Please try again in a minute. If it keeps happening, a security plugin or firewall may be interfering with requests to /wp-json/.', 'wingpilot' );
			case Connect_Failure::RESPONSE_ALTERED:
				return __( 'Something in front of this site answered WPPilot\'s check in its place, usually a bot check, a page cache or a security plugin. Exclude /wp-json/ from caching and bot checks, then try again.', 'wingpilot' );
			case Connect_Failure::URL_MISMATCH:
				return __( 'This site\'s address does not match the address of its REST API. Check that the WordPress Address and the Site Address under Settings, General belong to this site, then try again.', 'wingpilot' );
			case Connect_Failure::BACKEND_UNREACHABLE:
				return __( 'This site could not reach WPPilot. Your host may block outgoing connections, or WPPilot may be briefly unavailable. Please try again in a minute.', 'wingpilot' );
			case Connect_Failure::PAIRING_REJECTED:
				return __( 'WPPilot no longer recognises this site\'s connection. Choose Reconnect to set it up again; your history is kept.', 'wingpilot' );
			case Connect_Failure::TIMED_OUT:
				return __( 'WPPilot took too long to answer. Please try again in a minute.', 'wingpilot' );
		}
		return __( 'WPPilot could not finish this just now. Please try again in a minute.', 'wingpilot' );
	}

	/* First-run notice (Plugins screen and Dashboard, until connected). */

	public static function first_run_notice_title(): string {
		return __( 'WPPilot is installed — connect this site to start.', 'wingpilot' );
	}

	public static function first_run_notice_body(): string {
		return __( 'Connecting takes about a minute, and your first Briefing follows a few minutes later.', 'wingpilot' );
	}

	public static function first_run_notice_button(): string {
		return __( 'Connect this site', 'wingpilot' );
	}

	public static function first_run_notice_finish_title(): string {
		return __( 'WPPilot is almost ready.', 'wingpilot' );
	}

	public static function first_run_notice_finish_body(): string {
		return __( 'Finish connecting this site to your WPPilot account to see your Briefing.', 'wingpilot' );
	}

	public static function first_run_notice_finish_button(): string {
		return __( 'Finish connecting', 'wingpilot' );
	}

	public static function first_run_notice_dismiss(): string {
		return __( 'Dismiss', 'wingpilot' );
	}

	public static function error_no_permission(): string {
		return __( 'You do not have permission to do this.', 'wingpilot' );
	}

	/* ---------------------------------------------------------------
	 * JavaScript strings (passed via wp_localize_script)
	 * ------------------------------------------------------------- */

	public static function confirm_disconnect(): string {
		return __( 'Are you sure you want to disconnect from WPPilot? This will revoke all active tokens.', 'wingpilot' );
	}

	public static function disconnect_modal_title(): string {
		return __( 'Disconnect from WPPilot?', 'wingpilot' );
	}

	public static function disconnect_modal_body(): string {
		return __( 'This immediately revokes all active sessions and stops backend communication. You can reconnect any time.', 'wingpilot' );
	}

	public static function disconnect_modal_confirm(): string {
		return __( 'Yes, disconnect', 'wingpilot' );
	}

	public static function disconnect_modal_cancel(): string {
		return __( 'Cancel', 'wingpilot' );
	}

	public static function copied_label(): string {
		return __( 'Copied!', 'wingpilot' );
	}

	public static function connecting_label(): string {
		return __( 'Connecting…', 'wingpilot' );
	}

	public static function opening_label(): string {
		return __( 'Opening WPPilot…', 'wingpilot' );
	}

	public static function handoff_error(): string {
		return __( 'Could not start authorization. Please try again, or connect manually below.', 'wingpilot' );
	}

	/**
	 * All JS-facing strings as an associative array for wp_localize_script.
	 *
	 * @return array<string, string>
	 */
	public static function all_js(): array {
		return array(
			'confirmDisconnect' => self::confirm_disconnect(),
			'disconnectTitle'   => self::disconnect_modal_title(),
			'disconnectBody'    => self::disconnect_modal_body(),
			'disconnectConfirm' => self::disconnect_modal_confirm(),
			'disconnectCancel'  => self::disconnect_modal_cancel(),
			'copyLabel'         => self::copy_button(),
			'copiedLabel'       => self::copied_label(),
			'connecting'        => self::connecting_label(),
			'opening'           => self::opening_label(),
			'handoffError'      => self::handoff_error(),
			'technicalDetail'   => self::technical_detail_label(),
		);
	}
}