<?php
/**
 * Translation coverage of one language.
 *
 * @package MediaWorkbench\LinguaPilot
 */

declare( strict_types = 1 );

namespace MediaWorkbench\LinguaPilot\Domain\Model;

/**
 * How many originals are translated, unpublished or missing in one language.
 */
final class LanguageCoverage {

	/**
	 * Creates the coverage.
	 *
	 * @param string $language    Language code.
	 * @param int    $translated  Published translations.
	 * @param int    $unpublished Translations that exist but are not published.
	 * @param int    $missing     Originals without a translation or an open translation job.
	 * @param int    $in_progress Originals without a translation but with an open translation job.
	 * @param int    $outdated    Existing translations (translated or unpublished) marked as needing an update.
	 */
	public function __construct(
		public readonly string $language,
		public readonly int $translated,
		public readonly int $unpublished,
		public readonly int $missing,
		public readonly int $in_progress = 0,
		public readonly int $outdated = 0,
	) {}

	/**
	 * Number of originals (outdated translations are already counted as translated or unpublished).
	 */
	public function total(): int {
		return $this->translated + $this->unpublished + $this->in_progress + $this->missing;
	}

	/**
	 * Share of published translations in percent, one decimal. 100 when there is nothing to translate.
	 */
	public function coverage_pct(): float {
		return 0 === $this->total() ? 100.0 : round( $this->translated / $this->total() * 100, 1 );
	}
}