icingaweb2/library/Icinga/Less/Visitor.php

<?php

namespace Icinga\Less;

use Less_VisitorReplacing;
use LogicException;

/**
 * Replace compiled Less colors with CSS var() function calls
 *
 * This basically works by replacing every visited Less variable with {@link ColorPropOrVariable},
 * which is later compiled to {@link ColorProp} if it is a color.
 */
class Visitor extends Less_VisitorReplacing
{
    public $isPreEvalVisitor = true;

    /**
     * Whether calling var() CSS function
     *
     * If that's the case, don't try to replace compiled Less colors with CSS var() function calls.
     *
     * @var bool|string
     */
    protected $callingVar = false;

    /**
     * Whether defining a variable
     *
     * If that's the case, don't try to replace compiled Less colors with CSS var() function calls.
     *
     * @var bool|string
     */
    protected $definingVar = false;

    public function visitCall($c)
    {
        if ($c->name === 'var') {
            if ($this->callingVar !== false) {
                throw new LogicException('Already calling var');
            }

            $this->callingVar = spl_object_hash($c);
        }

        return $c;
    }

    public function visitCallOut($c)
    {
        if ($this->callingVar !== false && $this->callingVar === spl_object_hash($c)) {
            $this->callingVar = false;
        }
    }

    public function visitDetachedRuleset($rs)
    {
        // A detached ruleset is a variable definition in the first place,
        // so just reset that we define a variable.
        $this->definingVar = false;

        return $rs;
    }

    public function visitMixinCall($c)
    {
        // Less_Tree_Mixin_Call::accept() does not visit arguments, but we have to replace them if necessary.
        foreach ($c->arguments as $a) {
            $a['value'] = $this->visitObj($a['value']);
        }

        return $c;
    }

    public function visitMixinDefinition($m)
    {
        // Less_Tree_Mixin_Definition::accept() does not visit params, but we have to replace them if necessary.
        foreach ($m->params as $p) {
            if (! isset($p['value'])) {
                continue;
            }

            $p['value'] = $this->visitObj($p['value']);
        }

        return $m;
    }

    public function visitRule($r)
    {
        if ($r->name[0] === '@' && $r->variable) {
            if ($this->definingVar !== false) {
                throw new LogicException('Already defining a variable');
            }

            $this->definingVar = spl_object_hash($r);
        }

        return $r;
    }

    public function visitRuleOut($r)
    {
        if ($this->definingVar !== false && $this->definingVar === spl_object_hash($r)) {
            $this->definingVar = false;
        }
    }

    public function visitVariable($v)
    {
        if ($this->callingVar !== false || $this->definingVar !== false) {
            return $v;
        }

        return (new ColorPropOrVariable())
            ->setVariable($v);
    }

    public function run($node)
    {
        return $this->visitObj($node);
    }
}