<?php
/**
 * Condition contract (public, stable API).
 *
 * @package Extrova
 */

declare( strict_types=1 );

namespace Extrova\Rules;

use Extrova\Core\Context;

defined( 'ABSPATH' ) || exit;

/**
 * A rule condition. Register new ones with `extrova_register_conditions`.
 *
 * @since 1.0.0
 */
interface ConditionInterface {

	/**
	 * Condition slug.
	 */
	public function slug(): string;

	/**
	 * Human label (translated at call time).
	 */
	public function label(): string;

	/**
	 * JSON Schema of the condition.
	 */
	public function config_schema(): array;

	/**
	 * Whether the condition passes. Composite conditions may call `$evaluator->passes()`.
	 *
	 * @param array         $condition Condition config.
	 * @param Context       $context   Context.
	 * @param RuleEvaluator $evaluator Evaluator.
	 */
	public function matches( array $condition, Context $context, RuleEvaluator $evaluator ): bool;

	/**
	 * Context parts the condition depends on ('subtotal', 'shipping_method', 'payment_method'...),
	 * so the frontend knows when to resync.
	 *
	 * @return string[]
	 */
	public function context_dependencies(): array;
}