<?php
/**
 * Value object returned by a check.
 *
 * @package AgentReadyForWooCommerce
 */

defined( 'ABSPATH' ) || exit;

/**
 * Class ARWC_Check_Result
 *
 * Immutable-ish container for a single check's outcome: a normalized score in
 * the range 0.0–1.0 and a list of issues. Severities are used by the UI to
 * colour-code and prioritize fixes.
 */
class ARWC_Check_Result {

	const SEVERITY_CRITICAL = 'critical';
	const SEVERITY_WARNING  = 'warning';
	const SEVERITY_INFO     = 'info';

	/**
	 * Normalized score, 0.0–1.0.
	 *
	 * @var float
	 */
	protected $score = 0.0;

	/**
	 * Issues found. Each issue is an array:
	 * [ 'code' => string, 'message' => string, 'severity' => string ].
	 *
	 * @var array<int,array<string,string>>
	 */
	protected $issues = array();

	/**
	 * Constructor.
	 *
	 * @param float $score  Normalized score (clamped to 0.0–1.0).
	 * @param array $issues Optional pre-built issues array.
	 */
	public function __construct( $score = 0.0, array $issues = array() ) {
		$this->set_score( $score );
		$this->issues = $issues;
	}

	/**
	 * Set (and clamp) the score.
	 *
	 * @param float $score Normalized score.
	 * @return void
	 */
	public function set_score( $score ) {
		$score       = (float) $score;
		$this->score = max( 0.0, min( 1.0, $score ) );
	}

	/**
	 * Get the normalized score.
	 *
	 * @return float
	 */
	public function get_score() {
		return $this->score;
	}

	/**
	 * Add an issue.
	 *
	 * @param string $code     Machine code, e.g. "missing_gtin".
	 * @param string $message  Human-readable, already-translated message.
	 * @param string $severity One of the SEVERITY_* constants.
	 * @return void
	 */
	public function add_issue( $code, $message, $severity = self::SEVERITY_WARNING ) {
		$this->issues[] = array(
			'code'     => (string) $code,
			'message'  => (string) $message,
			'severity' => (string) $severity,
		);
	}

	/**
	 * Get all issues.
	 *
	 * @return array<int,array<string,string>>
	 */
	public function get_issues() {
		return $this->issues;
	}
}