<?php
declare(strict_types=1);
// Exit if accessed directly
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Severity level constants and helpers for the activity log.
 *
 * Single source of truth for all severity values, labels, and CSS classes
 * used throughout the plugin. All other classes reference these constants
 * rather than raw strings.
 *
 * @since 1.0.7
 */
class ACTLOGPRO_Severity {

	const CRITICAL = 'critical';
	const HIGH     = 'high';
	const MEDIUM   = 'medium';
	const LOW      = 'low';
	const INFO     = 'info';

	/** Default severity applied when none is specified. */
	const LEVEL_DEFAULT = self::INFO;

	/**
	 * Returns all severity levels in descending order of importance.
	 *
	 * @return string[]
	 */
	public static function get_all(): array {
		return array(
			self::CRITICAL,
			self::HIGH,
			self::MEDIUM,
			self::LOW,
			self::INFO,
		);
	}

	/**
	 * Returns the human-readable label for a given severity slug.
	 *
	 * @param string $severity Severity slug.
	 * @return string Translated label, or the raw slug if unrecognised.
	 */
	public static function get_label( string $severity ): string {
		$labels = array(
			self::CRITICAL => __( 'Critical', 'activity-log-pro' ),
			self::HIGH     => __( 'High', 'activity-log-pro' ),
			self::MEDIUM   => __( 'Medium', 'activity-log-pro' ),
			self::LOW      => __( 'Low', 'activity-log-pro' ),
			self::INFO     => __( 'Info', 'activity-log-pro' ),
		);

		return $labels[ $severity ] ?? ucfirst( $severity );
	}

	/**
	 * Returns the CSS modifier class for a given severity slug.
	 *
	 * @param string $severity Severity slug.
	 * @return string CSS class string.
	 */
	public static function get_css_class( string $severity ): string {
		$valid = self::get_all();

		return in_array( $severity, $valid, true )
			? 'alp-severity-' . $severity
			: 'alp-severity-info';
	}

	/**
	 * Checks whether a given string is a recognised severity level.
	 *
	 * @param string $severity Value to check.
	 * @return bool
	 */
	public static function is_valid( string $severity ): bool {
		return in_array( $severity, self::get_all(), true );
	}
}