<?php
/**
 * Old year in the copyright notice (F-CONTENT-02).
 *
 * @package ForensixDigital
 */

declare(strict_types=1);

namespace ForensixDigital\Apps\Content;

defined( 'ABSPATH' ) || exit;

use ForensixDigital\Services\Findings\Observation;
use ForensixDigital\Services\Findings\Priority;
use ForensixDigital\Services\Scan\Check;
use ForensixDigital\Services\Scan\ParsedPage;
use ForensixDigital\Services\Sources\Source;

/**
 * A footer that says "© 2019" in 2026 looks abandoned. The parser finds the newest year in a
 * copyright notice; this check reports it when it is before the current year. The notice is
 * part of the theme, so it is one finding for the whole site.
 */
final class CopyrightCheck implements Check {

	public const ID = 'content.old_copyright';

	/**
	 * Creates the check.
	 *
	 * @param int $year The current year.
	 */
	public function __construct( private int $year ) {}

	/**
	 * Check id.
	 */
	public function id(): string {
		return self::ID;
	}

	/**
	 * The check looks only at the page itself.
	 *
	 * @param ParsedPage $page Parsed page.
	 * @return string[]
	 */
	public function targets( ParsedPage $page ): array {
		return array();
	}

	/**
	 * The old year on this page, if any.
	 *
	 * @param ParsedPage $page    Parsed page.
	 * @param array      $results Not used.
	 * @phpstan-param array<string, \ForensixDigital\Services\Scan\TargetResult> $results
	 * @return array<int, array{observation: Observation, context: string}>
	 */
	public function inspect( ParsedPage $page, array $results ): array {
		$hits = array();
		foreach ( $page->facts->content as $fact ) {
			if ( 'copyright_year' !== $fact[0] || (int) $fact[1] >= $this->year ) {
				continue;
			}
			$hits[] = array(
				'observation' => new Observation(
					self::ID,
					Priority::LOW,
					Priority::SUGGESTION,
					__( 'The copyright notice shows an old year', 'forensix-digital' ),
					'old_copyright',
					Source::TEMPLATE,
					'',
					'',
					array( 'year' => (int) $fact[1] )
				),
				'context'     => '© ' . $fact[1],
			);
		}
		return $hits;
	}
}