<?php
/**
 * Time Range condition.
 *
 * @package BlockSieve
 */

namespace BlockSieve\Conditions\Definitions;

use BlockSieve\Conditions\AbstractCondition;
use BlockSieve\Conditions\Context\Context;

/**
 * Passes when the current time of day falls within a start and end time (HH:MM).
 * Supports overnight ranges (e.g. 22:00 → 06:00).
 */
final class TimeRangeCondition extends AbstractCondition {

	/**
	 * Gets the unique condition identifier.
	 *
	 * @return string
	 */
	public function id(): string {
		return 'time-range';
	}

	/**
	 * Gets the translated human label.
	 *
	 * @return string
	 */
	public function label(): string {
		return __( 'Time Range', 'blocksieve' );
	}

	/**
	 * Gets the translated description shown in the UI.
	 *
	 * @return string
	 */
	public function description(): string {
		return __( 'The current time of day falls within a start and end time (HH:MM).', 'blocksieve' );
	}

	/**
	 * Gets the category used to group this condition in the UI.
	 *
	 * @return string
	 */
	public function category(): string {
		return 'date-time';
	}

	/**
	 * Gets the list of supported operator identifiers.
	 *
	 * @return string[]
	 */
	public function operators(): array {
		return array( 'between', 'not_between' );
	}

	/**
	 * Gets the JSON-schema-like description of the value field for the UI.
	 *
	 * @return array
	 */
	public function value_schema(): array {
		return array(
			'type'       => 'object',
			'properties' => array(
				'start' => array( 'type' => 'string' ),
				'end'   => array( 'type' => 'string' ),
			),
		);
	}

	/**
	 * Gets the default value for a newly created condition of this type.
	 *
	 * @return mixed
	 */
	public function default_value() {
		return array(
			'start' => '00:00',
			'end'   => '23:59',
		);
	}

	/**
	 * Evaluates the condition against the given context.
	 *
	 * @param Context $context  Request context value object.
	 * @param string  $operator Operator identifier.
	 * @param mixed   $value    Configured value.
	 * @return bool
	 */
	public function evaluate( Context $context, string $operator, $value ): bool {
		$start = $this->to_minutes( $value['start'] ?? null );
		$end   = $this->to_minutes( $value['end'] ?? null );

		if ( null === $start || null === $end ) {
			return true; // Invalid range — fail open.
		}

		$now = ( (int) $context->datetime->format( 'H' ) ) * 60 + (int) $context->datetime->format( 'i' );

		if ( $start <= $end ) {
			$in = ( $now >= $start && $now <= $end );
		} else {
			$in = ( $now >= $start || $now <= $end ); // Overnight range.
		}

		return 'not_between' === $operator ? ! $in : $in;
	}

	/**
	 * Parses an HH:MM string into minutes since midnight.
	 *
	 * @param mixed $value Time string.
	 * @return int|null
	 */
	private function to_minutes( $value ): ?int {
		if ( ! is_string( $value ) || ! preg_match( '/^([01]?\d|2[0-3]):([0-5]\d)$/', $value, $m ) ) {
			return null;
		}

		return (int) $m[1] * 60 + (int) $m[2];
	}
}