Any.php

<?php

declare(strict_types=1);

namespace Phpro\AgentRules;

/**
 * @template T
 *
 * @implements RuleInterface<T>
 */
final readonly class Any implements RuleInterface
{

    /**
     * @var list<RuleInterface<T>>
     */
    private array $rules;

    /**
     * @param string $name
     * @param array<RuleInterface<T>> $rules
     * @param list<string> $dependencies
     *
     * @throws \InvalidArgumentException
     */
    public function __construct(
        private string $name,
        array $rules,
        private array $dependencies,
    ) {
        $this->rules = RulesAnalyzer::resolve($rules);
    }

    #[\Override]
    public function name(): string
    {
        return $this->name;
    }

    /**
     * @return list<string>
     */
    #[\Override]
    public function dependencies(): array
    {
        return $this->dependencies;
    }

    /**
     * @throws \InvalidArgumentException
     */
    #[\Override]
    public function check(mixed $subject): RuleEvaluation
    {
        $firstAnswer = null;
        foreach ($this->rules as $rule) {
            $evaluation = $rule->check($subject);
            $firstAnswer ??= $evaluation;

            if ($evaluation->isPass()) {
                return $evaluation;
            }
        }

        return $firstAnswer ?? throw new \InvalidArgumentException(
            'Any rule engine must have at least one rule to evaluate.'
        );
    }
}