1:  2:  3:  4:  5:  6:  7:  8:  9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 

<?php

namespace SDom;

use SDom\Node as DomNode;
use SDom\SelectorMatcher\AttributeNodeTrait;
use SDom\SelectorMatcher\ClassNodeTrait;
use SDom\SelectorMatcher\CombinedSelectorNodeTrait;
use SDom\SelectorMatcher\ElementNodeTrait;
use SDom\SelectorMatcher\HashNodeTrait;
use Symfony\Component\CssSelector\Node as CssNode;

/**
 * A class for matching nodes against selector tokens.
 *
 * Class SelectorMatcher
 * @package SDom
 */
class SelectorMatcher
{
    use ElementNodeTrait;
    use AttributeNodeTrait;
    use ClassNodeTrait;
    use HashNodeTrait;
    use CombinedSelectorNodeTrait;

    /**
     * Check if the supplied word is found in the supplied sentence.
     *
     * E.g. the sentence begins with the word followed by whitespace, ends with the word preceded with whitespace,
     * contains the word surrounded by whitespace or is equal to the word.
     *
     * The word itself may not contain whitespace.
     *
     * @param string $word
     * @param string $sentence
     * @return bool
     */
    public static function containsWord(string $word, string $sentence): bool
    {
        return in_array($word, preg_split('/\s+/', $sentence) ?: []);
    }

    /**
     * Match the supplied CSS token against the supplied Element node and return TRUE if it is matched.
     *
     * The $effectiveRoot specifies an Element node part of the hierarchy that is to be considered as root of the tree.
     * Immediate child nodes will be treated as if they don't have a parent.
     *
     * @param CssNode\NodeInterface $token
     * @param DomNode\Element $node
     * @param DomNode\Element|null $effectiveRoot
     * @return bool
     */
    public function match(
        CssNode\NodeInterface $token,
        DomNode\Element $node,
        DomNode\Element $effectiveRoot = null
    ): bool {
        switch (true) {
            case $token instanceof CssNode\SelectorNode:
                return $this->match($token->getTree(), $node, $effectiveRoot);

            case $token instanceof CssNode\ElementNode:
                return $this->matchElementNode($token, $node);

            case $token instanceof CssNode\AttributeNode:
                return $this->matchAttributeNode($token, $node, $effectiveRoot);

            case $token instanceof CssNode\ClassNode:
                return $this->matchClassNode($token, $node, $effectiveRoot);

            case $token instanceof CssNode\HashNode:
                return $this->matchHashNode($token, $node, $effectiveRoot);

            case $token instanceof CssNode\CombinedSelectorNode:
                return $this->matchCombinedSelectorNode($token, $node, $effectiveRoot);

            default:
                throw new \RuntimeException(sprintf(
                    'Selector token %s is not supported yet.',
                    get_class($token)
                ));
        }
    }
}