<?php
/**
 * Rank Math: a post's SEO fields, the plugin's settings and its modules.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * Rank Math keeps a post's SEO fields as `rank_math_*` post meta
 * (`Helper::get_post_meta()`), the robots directives as an array in
 * `rank_math_robots` and the advanced ones apart in
 * `rank_math_advanced_robots`; its settings are the
 * `rank-math-options-*` options and its active modules a list in
 * `rank_math_modules`. Read in Rank Math's source (seo-by-rank-math
 * master, 15 Oct 2026). Term SEO and redirections are named deferrals. The
 * machinery is {@see SeoWatch}'s.
 */
final class RankMath implements Integration {

	public const PLUGIN = 'seo-by-rank-math';

	/** Watched post meta => label. */
	public const META = array(
		'rank_math_title'                => 'SEO title',
		'rank_math_description'          => 'meta description',
		'rank_math_focus_keyword'        => 'focus keyword',
		'rank_math_canonical_url'        => 'canonical URL',
		'rank_math_robots'               => 'robots',
		'rank_math_advanced_robots'      => 'advanced robots',
		'rank_math_pillar_content'       => 'pillar content',
		'rank_math_facebook_title'       => 'social title',
		'rank_math_facebook_description' => 'social description',
		'rank_math_twitter_title'        => 'X title',
		'rank_math_twitter_description'  => 'X description',
	);

	/** Watched options => label. */
	public const OPTIONS = array(
		'rank-math-options-general'          => 'Rank Math general',
		'rank-math-options-titles'           => 'Rank Math titles and meta',
		'rank-math-options-sitemap'          => 'Rank Math sitemap',
		'rank-math-options-instant-indexing' => 'Rank Math instant indexing',
		'rank_math_modules'                  => 'Rank Math modules',
	);

	public static function is_active(): bool {
		return Integrations::enabled( self::PLUGIN, defined( 'RANK_MATH_VERSION' ) );
	}

	public static function event_types(): array {
		return Yoast::event_types();
	}

	public static function register( ?bool $active = null ): void {
		if ( ! ( $active ?? self::is_active() ) ) {
			return;
		}

		SeoWatch::watch( self::PLUGIN, self::META, self::OPTIONS );
	}

	public static function post_types(): array {
		return array();
	}

	public static function internal_post_types(): array {
		return array();
	}
}