<?php
/**
 * Evaluatable contract.
 *
 * @package FormPilot
 * @since   1.0.0
 */

declare( strict_types = 1 );

namespace FormPilot\Conditions;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Something that answers true or false for a set of submitted values.
 *
 * Implemented by both {@see Condition} and {@see ConditionGroup}, which is what
 * lets a group hold either without caring which it has.
 *
 * @since 1.0.0
 */
interface Evaluatable {

	/**
	 * Determines whether this holds for the submitted values.
	 *
	 * @param array<string, mixed> $values Submitted values keyed by field key.
	 *
	 * @return bool True when it holds.
	 */
	public function evaluate( array $values ): bool;

	/**
	 * Returns the storable form.
	 *
	 * @return array<string, mixed> The payload.
	 */
	public function to_array(): array;
}