<?php

> 


/**
 * SCSSPHP
 *

<  * @copyright 2012-2019 Leaf Corcoran



>  * @copyright 2012-2020 Leaf Corcoran


 *
 * @license http://opensource.org/licenses/MIT MIT
 *
 * @link http://scssphp.github.io/scssphp
 */

namespace ScssPhp\ScssPhp;

use ScssPhp\ScssPhp\Base\Range;

< use ScssPhp\ScssPhp\Block;
< use ScssPhp\ScssPhp\Cache;
< use ScssPhp\ScssPhp\Colors;



> use ScssPhp\ScssPhp\Block\AtRootBlock;
> use ScssPhp\ScssPhp\Block\CallableBlock;
> use ScssPhp\ScssPhp\Block\DirectiveBlock;
> use ScssPhp\ScssPhp\Block\EachBlock;
> use ScssPhp\ScssPhp\Block\ElseBlock;
> use ScssPhp\ScssPhp\Block\ElseifBlock;
> use ScssPhp\ScssPhp\Block\ForBlock;
> use ScssPhp\ScssPhp\Block\IfBlock;
> use ScssPhp\ScssPhp\Block\MediaBlock;
> use ScssPhp\ScssPhp\Block\NestedPropertyBlock;
> use ScssPhp\ScssPhp\Block\WhileBlock;
> use ScssPhp\ScssPhp\Compiler\CachedResult;


use ScssPhp\ScssPhp\Compiler\Environment;
use ScssPhp\ScssPhp\Exception\CompilerException;

> use ScssPhp\ScssPhp\Exception\ParserException;
use ScssPhp\ScssPhp\Formatter\OutputBlock;
> use ScssPhp\ScssPhp\Exception\SassException;
use ScssPhp\ScssPhp\Node;
> use ScssPhp\ScssPhp\Exception\SassScriptException;
use ScssPhp\ScssPhp\SourceMap\SourceMapGenerator;
> use ScssPhp\ScssPhp\Formatter\Compressed;
use ScssPhp\ScssPhp\Type;
> use ScssPhp\ScssPhp\Formatter\Expanded;



< use ScssPhp\ScssPhp\Node;



> use ScssPhp\ScssPhp\Logger\LoggerInterface;
> use ScssPhp\ScssPhp\Logger\StreamLogger;
> use ScssPhp\ScssPhp\Node\Number;



< use ScssPhp\ScssPhp\Type;
< use ScssPhp\ScssPhp\Parser;
< use ScssPhp\ScssPhp\Util;



> use ScssPhp\ScssPhp\Util\Path;


 * The scss compiler and parser.
 *
 * Converting SCSS to CSS is a three stage process. The incoming file is parsed
 * by `Parser` into a syntax tree, then it is compiled into another tree
 * representing the CSS structure by `Compiler`. The CSS tree is fed into a
 * formatter, like `Formatter` which then outputs CSS as a string.
 *
 * During the first compile, all values are *reduced*, which means that their
 * types are brought to the lowest form before being dump as strings. This
 * handles math equations, variable dereferences, and the like.
 *
 * The `compile` function of `Compiler` is the entry point.
 *
 * In summary:
 *
 * The `Compiler` class creates an instance of the parser, feeds it SCSS code,
 * then transforms the resulting tree to a CSS tree. This class also holds the
 * evaluation context, such as all available mixins and variables at any given
 * time.
 *
 * The `Parser` class is only concerned with parsing its input.
 *
 * The `Formatter` takes a CSS tree, and dumps it to a formatted string,
 * handling things like indentation.
 */

/**
 * SCSS compiler
 *
 * @author Leaf Corcoran <leafot@gmail.com>

>  *
 */
>  * @final Extending the Compiler is deprecated


class Compiler
{

>     /**
    const LINE_COMMENTS = 1;
>      * @deprecated
    const DEBUG_INFO    = 2;
>      */




>     /**
    const WITH_RULE     = 1;
>      * @deprecated
    const WITH_MEDIA    = 2;
>      */


    const WITH_SUPPORTS = 4;

>     /**
    const WITH_ALL      = 7;
>      * @deprecated

>      */


    const SOURCE_MAP_NONE   = 0;

>     /**
    const SOURCE_MAP_INLINE = 1;
>      * @deprecated
    const SOURCE_MAP_FILE   = 2;
>      */




>     /**
    /**
>      * @deprecated
     * @var array
>      */


     */

>     /**
    static protected $operatorNames = [
>      * @deprecated
        '+'   => 'add',
>      */



<      * @var array



>      * @var array<string, string>



<     static protected $operatorNames = [



>     protected static $operatorNames = [


        '/'   => 'div',
        '%'   => 'mod',

        '=='  => 'eq',
        '!='  => 'neq',
        '<'   => 'lt',
        '>'   => 'gt',

        '<='  => 'lte',
        '>='  => 'gte',

<         '<=>' => 'cmp',


    ];

    /**

<      * @var array



>      * @var array<string, string>


     */

<     static protected $namespaces = [



>     protected static $namespaces = [


        'special'  => '%',
        'mixin'    => '@',
        'function' => '^',
    ];


<     static public $true         = [Type::T_KEYWORD, 'true'];
<     static public $false        = [Type::T_KEYWORD, 'false'];
<     static public $null         = [Type::T_NULL];
<     static public $nullString   = [Type::T_STRING, '', []];
<     static public $defaultValue = [Type::T_KEYWORD, ''];
<     static public $selfSelector = [Type::T_SELF];
<     static public $emptyList    = [Type::T_LIST, '', []];
<     static public $emptyMap     = [Type::T_MAP, [], []];
<     static public $emptyString  = [Type::T_STRING, '"', []];
<     static public $with         = [Type::T_KEYWORD, 'with'];
<     static public $without      = [Type::T_KEYWORD, 'without'];



>     public static $true         = [Type::T_KEYWORD, 'true'];
>     public static $false        = [Type::T_KEYWORD, 'false'];
>     /** @deprecated */
>     public static $NaN          = [Type::T_KEYWORD, 'NaN'];
>     /** @deprecated */
>     public static $Infinity     = [Type::T_KEYWORD, 'Infinity'];
>     public static $null         = [Type::T_NULL];
>     public static $nullString   = [Type::T_STRING, '', []];
>     public static $defaultValue = [Type::T_KEYWORD, ''];
>     public static $selfSelector = [Type::T_SELF];
>     public static $emptyList    = [Type::T_LIST, '', []];
>     public static $emptyMap     = [Type::T_MAP, [], []];
>     public static $emptyString  = [Type::T_STRING, '"', []];
>     public static $with         = [Type::T_KEYWORD, 'with'];
>     public static $without      = [Type::T_KEYWORD, 'without'];
>     private static $emptyArgumentList = [Type::T_LIST, '', [], []];




<     protected $importPaths = [''];



>     /**
>      * @var array<int, string|callable>
>      */
>     protected $importPaths = [];
>     /**
>      * @var array<string, Block>
>      */


    protected $importCache = [];

> 
    protected $importedFiles = [];
>     /**
    protected $userFunctions = [];
>      * @var string[]
    protected $registeredVars = [];
>      */


    protected $registeredFeatures = [

> 
        'extend-selector-pseudoclass' => false,
>     /**
        'at-error'                    => true,
>      * @var array
        'units-level-3'               => false,
>      * @phpstan-var array<string, array{0: callable, 1: string[]|null}>
        'global-variable-shadowing'   => false,
>      */


    ];

>     /**

>      * @var array<string, mixed>
    protected $encoding = null;
>      */


    protected $lineNumberStyle = null;

>     /**

>      * @var array<string, bool>
    protected $sourceMap = self::SOURCE_MAP_NONE;
>      */



<         'units-level-3'               => false,



>         'units-level-3'               => true,




>     /**
    /**
>      * @var string|null
     * @var string|\ScssPhp\ScssPhp\Formatter
>      */


     */

>     /**
    protected $formatter = 'ScssPhp\ScssPhp\Formatter\Nested';
>      * @var null

>      * @deprecated
    protected $rootEnv;
>      */


    protected $rootBlock;

>     /**

>      * @var int|SourceMapGenerator
    /**
>      * @phpstan-var self::SOURCE_MAP_*|SourceMapGenerator
     * @var \ScssPhp\ScssPhp\Compiler\Environment
>      */


     */

> 
    protected $env;
>     /**
    protected $scope;
>      * @var array
    protected $storeEnv;
>      * @phpstan-var array{sourceRoot?: string, sourceMapFilename?: string|null, sourceMapURL?: string|null, sourceMapWriteTo?: string|null, outputSourceFiles?: bool, sourceMapRootpath?: string, sourceMapBasepath?: string}
    protected $charsetSeen;
>      */



<      * @var string|\ScssPhp\ScssPhp\Formatter



>      * @var bool
>      */
>     private $charset = true;
> 
>     /**
>      * @var Formatter



<     protected $formatter = 'ScssPhp\ScssPhp\Formatter\Nested';



>     protected $formatter;


    protected $cache;

>     /**

>      * @var string
    protected $indentLevel;
>      * @phpstan-var class-string<Formatter>
    protected $extends;
>      */
    protected $extendsMap;
>     private $configuredFormatter = Expanded::class;
    protected $parsedFiles;
> 
    protected $parser;
>     /**
    protected $sourceIndex;
>      * @var Environment
    protected $sourceLine;
>      */


    protected $sourceColumn;

>     /**
    protected $stderr;
>      * @var OutputBlock|null
    protected $shouldEvaluate;
>      */


    protected $ignoreErrors;

>     /**

>      * @var OutputBlock|null
    protected $callStack = [];
>      */




>     /**
    /**
>      * @var Environment|null
     * Constructor
>      */


     *

>     /**
     * @param array|null $cacheOptions
>      * @var bool|null
     */
>      *
    public function __construct($cacheOptions = null)
>      * @deprecated
    {
>      */


        $this->parsedFiles = [];

>     /**
        $this->sourceNames = [];
>      * @var array<int, string|null>

>      */


        if ($cacheOptions) {

>     /**
            $this->cache = new Cache($cacheOptions);
>      * @var Cache|null
        }
>      */




>     /**
        $this->stderr = fopen('php://stderr', 'w');
>      * @var bool
    }
>      */

>     protected $cacheCheckImportResolutions = false;
    /**
> 
     * Get compiler options
>     /**
     *
>      * @var int
     * @return array
>      */


     */

>     /**
    public function getCompileOptions()
>      * @var array[]
    {
>      */


        $options = [

>     /**
            'importPaths'        => $this->importPaths,
>      * @var array<string, int[]>
            'registeredVars'     => $this->registeredVars,
>      */



<     protected $parsedFiles;



> 
>     /**
>      * @var array<string, int>
>      */
>     protected $parsedFiles = [];
> 
>     /**
>      * @var Parser|null
>      */


            'encoding'           => $this->encoding,

>     /**
            'sourceMap'          => serialize($this->sourceMap),
>      * @var int|null
            'sourceMapOptions'   => $this->sourceMapOptions,
>      */


            'formatter'          => $this->formatter,

>     /**
        ];
>      * @var int|null

>      */


        return $options;

>     /**
    }
>      * @var int|null

>      */



<     protected $stderr;



>     /**
>      * @var bool|null
>      */


     * Set an alternative error output stream, for testing purpose only

>     /**
     *
>      * @var null
     * @param resource $handle
>      * @deprecated
     */
>      */


    public function setErrorOuput($handle)

>     /**
    {
>      * @var bool
        $this->stderr = $handle;
>      */
    }
>     protected $ignoreCallStackMessage = false;




>     /**
    /**
>      * @var array[]
     * Compile scss
>      */


     *

>      * @var array
     * @api
>      * @phpstan-var list<array{currentDir: string|null, path: string, filePath: string}>
     *
>      */
     * @param string $code
>     private $resolvedImports = [];
     * @param string $path
> 
     *
>     /**
     * @return string
>      * The directory of the currently processed file
     */
>      *
    public function compile($code, $path = null)
>      * @var string|null
    {
>      */
        if ($this->cache) {
>     private $currentDirectory;
            $cacheKey       = ($path ? $path : "(stdin)") . ":" . md5($code);
> 
            $compileOptions = $this->getCompileOptions();
>     /**
            $cache          = $this->cache->getCache("compile", $cacheKey, $compileOptions);
>      * The directory of the input file

>      *
            if (is_array($cache) && isset($cache['dependencies']) && isset($cache['out'])) {
>      * @var string
                // check if any dependency file changed before accepting the cache
>      */
                foreach ($cache['dependencies'] as $file => $mtime) {
>     private $rootDirectory;
                    if (! is_file($file) || filemtime($file) !== $mtime) {
> 
                        unset($cache);
>     /**
                        break;
>      * @var bool
                    }
>      */
                }
>     private $legacyCwdImportPath = true;

> 
                if (isset($cache)) {
>     /**
                    return $cache['out'];
>      * @var LoggerInterface
                }
>      */
            }
>     private $logger;
        }
> 

>     /**

>      * @var array<string, bool>
        $this->indentLevel    = -1;
>      */
        $this->extends        = [];
>     private $warnedChildFunctions = [];
        $this->extendsMap     = [];
> 
        $this->sourceIndex    = null;
>     /**


        $this->sourceLine     = null;

>      * @phpstan-param array{cacheDir?: string, prefix?: string, forceRefresh?: string, checkImportResolutions?: bool}|null $cacheOptions



<         $this->parsedFiles = [];


        $this->env            = null;

>             if (!empty($cacheOptions['checkImportResolutions'])) {
        $this->scope          = null;
>                 $this->cacheCheckImportResolutions = true;
        $this->storeEnv       = null;
>             }



<         $this->stderr = fopen('php://stderr', 'w');



>         $this->logger = new StreamLogger(fopen('php://stderr', 'w'), true);



<      * @return array



>      * @return array<string, mixed>
>      *
>      * @internal



<             'formatter'          => $this->formatter,



>             'formatter'          => $this->configuredFormatter,
>             'legacyImportPath'   => $this->legacyCwdImportPath,


        $this->parser = $this->parserFactory($path);

>      * Sets an alternative logger.
        $tree         = $this->parser->parse($code);
>      *
        $this->parser = null;
>      * Changing the logger in the middle of the compilation is not

>      * supported and will result in an undefined behavior.
        $this->formatter = new $this->formatter();
>      *
        $this->rootBlock = null;
>      * @param LoggerInterface $logger
        $this->rootEnv   = $this->pushEnv($tree);
>      *

>      * @return void
        $this->injectVariables($this->registeredVars);
>      */
        $this->compileRoot($tree);
>     public function setLogger(LoggerInterface $logger)
        $this->popEnv();
>     {

>         $this->logger = $logger;
        $sourceMapGenerator = null;
>     }

> 
        if ($this->sourceMap) {
>     /**


            if (is_object($this->sourceMap) && $this->sourceMap instanceof SourceMapGenerator) {

>      *
                $sourceMapGenerator = $this->sourceMap;
>      * @return void
                $this->sourceMap = self::SOURCE_MAP_FILE;
>      *
            } elseif ($this->sourceMap !== self::SOURCE_MAP_NONE) {
>      * @deprecated Use {@see setLogger} instead



<         $this->stderr = $handle;



>         @trigger_error('The method "setErrorOuput" is deprecated. Use "setLogger" instead.', E_USER_DEPRECATED);
> 
>         $this->logger = new StreamLogger($handle);



<      * @api
<      *



<      * @param string $path



>      * @param string|null $path


        $out = $this->formatter->format($this->scope, $sourceMapGenerator);

>      *

>      * @throws SassException when the source fails to compile
        if (! empty($out) && $this->sourceMap && $this->sourceMap !== self::SOURCE_MAP_NONE) {
>      *
            $sourceMap    = $sourceMapGenerator->generateJson();
>      * @deprecated Use {@see compileString} instead.



<         if ($this->cache) {
<             $cacheKey       = ($path ? $path : "(stdin)") . ":" . md5($code);
<             $compileOptions = $this->getCompileOptions();
<             $cache          = $this->cache->getCache("compile", $cacheKey, $compileOptions);



>         @trigger_error(sprintf('The "%s" method is deprecated. Use "compileString" instead.', __METHOD__), E_USER_DEPRECATED);



<             if (is_array($cache) && isset($cache['dependencies']) && isset($cache['out'])) {
<                 // check if any dependency file changed before accepting the cache
<                 foreach ($cache['dependencies'] as $file => $mtime) {
<                     if (! is_file($file) || filemtime($file) !== $mtime) {
<                         unset($cache);
<                         break;



>         $result = $this->compileString($code, $path);
> 
>         $sourceMap = $result->getSourceMap();
> 
>         if ($sourceMap !== null) {
>             if ($this->sourceMap instanceof SourceMapGenerator) {
>                 $this->sourceMap->saveMap($sourceMap);
>             } elseif ($this->sourceMap === self::SOURCE_MAP_FILE) {
>                 $sourceMapGenerator = new SourceMapGenerator($this->sourceMapOptions);
>                 $sourceMapGenerator->saveMap($sourceMap);



<                 if (isset($cache)) {
<                     return $cache['out'];



>         return $result->getCss();


            $out .= sprintf('/*# sourceMappingURL=%s */', $sourceMapUrl);

> 
        }
>     /**

>      * Compile scss
        if ($this->cache && isset($cacheKey) && isset($compileOptions)) {
>      *
            $v = [
>      * @param string      $source
                'dependencies' => $this->getParsedFiles(),
>      * @param string|null $path
                'out' => &$out,
>      *
            ];
>      * @return CompilationResult

>      *
            $this->cache->setCache("compile", $cacheKey, $v, $compileOptions);
>      * @throws SassException when the source fails to compile
        }
>      */

>     public function compileString($source, $path = null)
        return $out;
>     {
    }
>         if ($this->cache) {

>             $cacheKey       = ($path ? $path : '(stdin)') . ':' . md5($source);
    /**
>             $compileOptions = $this->getCompileOptions();
     * Instantiate parser
>             $cachedResult = $this->cache->getCache('compile', $cacheKey, $compileOptions);
     *
> 
     * @param string $path
>             if ($cachedResult instanceof CachedResult && $this->isFreshCachedResult($cachedResult)) {
     *
>                 return $cachedResult->getResult();



< 



<         $this->charsetSeen    = null;


    protected function parserFactory($path)

>         $this->ignoreCallStackMessage = false;
    {
>         $this->parsedFiles = [];
        $parser = new Parser($path, count($this->sourceNames), $this->encoding, $this->cache);
>         $this->importedFiles = [];

>         $this->resolvedImports = [];
        $this->sourceNames[] = $path;
> 
        $this->addParsedFile($path);
>         if (!\is_null($path) && is_file($path)) {

>             $path = realpath($path) ?: $path;
        return $parser;
>             $this->currentDirectory = dirname($path);
    }
>             $this->rootDirectory = $this->currentDirectory;

>         } else {
    /**
>             $this->currentDirectory = null;
     * Is self extend?
>             $this->rootDirectory = getcwd();
     *
>         }


     * @param array $target

>         try {



<         $tree         = $this->parser->parse($code);



>             $tree         = $this->parser->parse($source);



<         $this->formatter = new $this->formatter();



>             $this->formatter = new $this->configuredFormatter();


     * @return boolean

>             $warnCallback = function ($message, $deprecation) {
     */
>                 $this->logger->warn($message, $deprecation);
    protected function isSelfExtend($target, $origin)
>             };
    {
>             $previousWarnCallback = Warn::setCallback($warnCallback);
        foreach ($origin as $sel) {
> 
            if (in_array($target, $sel)) {
>             try {


                return true;

>             } finally {
            }
>                 Warn::setCallback($previousWarnCallback);
        }
>             }



<             if (is_object($this->sourceMap) && $this->sourceMap instanceof SourceMapGenerator) {



>                 if (\is_object($this->sourceMap) && $this->sourceMap instanceof SourceMapGenerator) {


        return false;

>             assert($this->scope !== null);


    }

>             $prefix = '';

> 
    /**
>             if ($this->charset && strlen($out) !== Util::mbStrlen($out)) {
     * Push extends
>                 $prefix = '@charset "UTF-8";' . "\n";
     *
>                 $out = $prefix . $out;
     * @param array      $target
>             }
     * @param array      $origin
> 
     * @param array|null $block
>             $sourceMap = null;
     */
> 



<             $sourceMap    = $sourceMapGenerator->generateJson();



>                 assert($sourceMapGenerator !== null);
>                 $sourceMap = $sourceMapGenerator->generateJson($prefix);



<                     $sourceMapUrl = $sourceMapGenerator->saveMap($sourceMap);



>                         if (isset($this->sourceMapOptions['sourceMapURL'])) {
>                             $sourceMapUrl = $this->sourceMapOptions['sourceMapURL'];
>                         }


        if ($this->isSelfExtend($target, $origin)) {

>                 if ($sourceMapUrl !== null) {


            return;

>             }
        }
>         } catch (SassScriptException $e) {

>             throw new CompilerException($this->addLocationToMessage($e->getMessage()), 0, $e);
        $i = count($this->extends);
>         }
        $this->extends[] = [$target, $origin, $block];
> 

>         $includedFiles = [];
        foreach ($target as $part) {
> 
            if (isset($this->extendsMap[$part])) {
>         foreach ($this->resolvedImports as $resolvedImport) {
                $this->extendsMap[$part][] = $i;
>             $includedFiles[$resolvedImport['filePath']] = $resolvedImport['filePath'];
            } else {
>         }
                $this->extendsMap[$part] = [$i];
> 
            }
>         $result = new CompilationResult($out, $sourceMap, array_values($includedFiles));



<             $v = [
<                 'dependencies' => $this->getParsedFiles(),
<                 'out' => &$out,
<             ];



>             $this->cache->setCache('compile', $cacheKey, new CachedResult($result, $this->parsedFiles, $this->resolvedImports), $compileOptions);
>         }
> 
>         // Reset state to free memory
>         // TODO in 2.0, reset parsedFiles as well when the getter is removed.
>         $this->resolvedImports = [];
>         $this->importedFiles = [];



<             $this->cache->setCache("compile", $cacheKey, $v, $compileOptions);



>         return $result;



<         return $out;



>     /**
>      * @param CachedResult $result
>      *
>      * @return bool
>      */
>     private function isFreshCachedResult(CachedResult $result)
>     {
>         // check if any dependency file changed since the result was compiled
>         foreach ($result->getParsedFiles() as $file => $mtime) {
>             if (! is_file($file) || filemtime($file) !== $mtime) {
>                 return false;
>             }
>         }
> 
>         if ($this->cacheCheckImportResolutions) {
>             $resolvedImports = [];
> 
>             foreach ($result->getResolvedImports() as $import) {
>                 $currentDir = $import['currentDir'];
>                 $path = $import['path'];
>                 // store the check across all the results in memory to avoid multiple findImport() on the same path
>                 // with same context.
>                 // this is happening in a same hit with multiple compilations (especially with big frameworks)
>                 if (empty($resolvedImports[$currentDir][$path])) {
>                     $resolvedImports[$currentDir][$path] = $this->findImport($path, $currentDir);
>                 }
> 
>                 if ($resolvedImports[$currentDir][$path] !== $import['filePath']) {
>                     return false;
>                 }
>             }
>         }
> 
>         return true;



<      * @param string $path



>      * @param string|null $path



<         $parser = new Parser($path, count($this->sourceNames), $this->encoding, $this->cache);



>         // https://sass-lang.com/documentation/at-rules/import
>         // CSS files imported by Sass don’t allow any special Sass features.
>         // In order to make sure authors don’t accidentally write Sass in their CSS,
>         // all Sass features that aren’t also valid CSS will produce errors.
>         // Otherwise, the CSS will be rendered as-is. It can even be extended!
>         $cssOnly = false;
> 
>         if ($path !== null && substr($path, -4) === '.css') {
>             $cssOnly = true;
>         }
> 
>         $parser = new Parser($path, \count($this->sourceNames), $this->encoding, $this->cache, $cssOnly, $this->logger);



<      * @return boolean



>      * @return bool



<             if (in_array($target, $sel)) {



>             if (\in_array($target, $sel)) {



<      * @param array      $target



>      * @param string[]   $target


    protected function makeOutputBlock($type, $selectors = null)

>      *
    {
>      * @return void



<         if ($this->isSelfExtend($target, $origin)) {
<             return;
<         }
< 
<         $i = count($this->extends);



>         $i = \count($this->extends);



<      * @param string $type
<      * @param array  $selectors



>      * @param string|null   $type
>      * @param string[]|null $selectors



<         $out = new OutputBlock;



>         $out = new OutputBlock();


        if ($this->env->block instanceof Block) {
            $out->sourceName   = $this->env->block->sourceName;
            $out->sourceLine   = $this->env->block->sourceLine;
            $out->sourceColumn = $this->env->block->sourceColumn;
        } else {

<             $out->sourceName   = null;
<             $out->sourceLine   = null;
<             $out->sourceColumn = null;



>             $out->sourceName = isset($this->sourceNames[$this->sourceIndex]) ? $this->sourceNames[$this->sourceIndex] : '(stdin)';
>             $out->sourceLine = $this->sourceLine;
>             $out->sourceColumn = $this->sourceColumn;


        }

        return $out;
    }

    /**
     * Compile root
     *
     * @param \ScssPhp\ScssPhp\Block $rootBlock

>      *
     */
>      * @return void


    protected function compileRoot(Block $rootBlock)
    {
        $this->rootBlock = $this->scope = $this->makeOutputBlock(Type::T_ROOT);

        $this->compileChildrenNoReturn($rootBlock->children, $this->scope);

>         assert($this->scope !== null);


        $this->flattenSelectors($this->scope);
        $this->missingSelectors();
    }

    /**
     * Report missing selectors

>      *
     */
>      * @return void


    protected function missingSelectors()
    {
        foreach ($this->extends as $extend) {
            if (isset($extend[3])) {
                continue;
            }

            list($target, $origin, $block) = $extend;

            // ignore if !optional
            if ($block[2]) {
                continue;
            }

            $target = implode(' ', $target);
            $origin = $this->collapseSelectors($origin);

            $this->sourceLine = $block[Parser::SOURCE_LINE];

<             $this->throwError("\"$origin\" failed to @extend \"$target\". The selector \"$target\" was not found.");



>             throw $this->error("\"$origin\" failed to @extend \"$target\". The selector \"$target\" was not found.");


        }
    }

    /**
     * Flatten selectors
     *
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $block
     * @param string                                 $parentKey

>      *
     */
>      * @return void


    protected function flattenSelectors(OutputBlock $block, $parentKey = null)
    {
        if ($block->selectors) {
            $selectors = [];

            foreach ($block->selectors as $s) {
                $selectors[] = $s;


<                 if (! is_array($s)) {



>                 if (! \is_array($s)) {


                    continue;
                }

                // check extends
                if (! empty($this->extendsMap)) {
                    $this->matchExtends($s, $selectors);

                    // remove duplicates
                    array_walk($selectors, function (&$value) {
                        $value = serialize($value);
                    });

                    $selectors = array_unique($selectors);

                    array_walk($selectors, function (&$value) {
                        $value = unserialize($value);
                    });
                }
            }

            $block->selectors = [];
            $placeholderSelector = false;

            foreach ($selectors as $selector) {
                if ($this->hasSelectorPlaceholder($selector)) {
                    $placeholderSelector = true;
                    continue;
                }

                $block->selectors[] = $this->compileSelector($selector);
            }


<             if ($placeholderSelector && 0 === count($block->selectors) && null !== $parentKey) {



>             if ($placeholderSelector && 0 === \count($block->selectors) && null !== $parentKey) {
>                 assert($block->parent !== null);


                unset($block->parent->children[$parentKey]);

                return;
            }
        }

        foreach ($block->children as $key => $child) {
            $this->flattenSelectors($child, $key);
        }
    }

    /**

<      * Glue parts of :not( or :nth-child( ... that are in general splitted in selectors parts



>      * Glue parts of :not( or :nth-child( ... that are in general split in selectors parts


     *
     * @param array $parts
     *
     * @return array
     */
    protected function glueFunctionSelectors($parts)
    {
        $new = [];

        foreach ($parts as $part) {

<             if (is_array($part)) {



>             if (\is_array($part)) {


                $part = $this->glueFunctionSelectors($part);
                $new[] = $part;
            } else {
                // a selector part finishing with a ) is the last part of a :not( or :nth-child(
                // and need to be joined to this

<                 if (count($new) && is_string($new[count($new) - 1]) &&
<                     strlen($part) && substr($part, -1) === ')' && strpos($part, '(') === false



>                 if (
>                     \count($new) && \is_string($new[\count($new) - 1]) &&
>                     \strlen($part) && substr($part, -1) === ')' && strpos($part, '(') === false


                ) {

<                     while (count($new)>1 && substr($new[count($new) - 1], -1) !== '(') {



>                     while (\count($new) > 1 && substr($new[\count($new) - 1], -1) !== '(') {


                        $part = array_pop($new) . $part;
                    }

<                     $new[count($new) - 1] .= $part;



>                     $new[\count($new) - 1] .= $part;


                } else {
                    $new[] = $part;
                }
            }
        }

        return $new;
    }

    /**
     * Match extends
     *
     * @param array   $selector
     * @param array   $out

<      * @param integer $from
<      * @param boolean $initial



>      * @param int   $from
>      * @param bool  $initial
>      *
>      * @return void


     */
    protected function matchExtends($selector, &$out, $from = 0, $initial = true)
    {
        static $partsPile = [];
        $selector = $this->glueFunctionSelectors($selector);


<         if (count($selector) == 1 && in_array(reset($selector), $partsPile)) {



>         if (\count($selector) == 1 && \in_array(reset($selector), $partsPile)) {


            return;
        }

        $outRecurs = [];

> 


        foreach ($selector as $i => $part) {
            if ($i < $from) {
                continue;
            }

            // check that we are not building an infinite loop of extensions
            // if the new part is just including a previous part don't try to extend anymore

<             if (count($part) > 1) {



>             if (\count($part) > 1) {


                foreach ($partsPile as $previousPart) {

<                     if (! count(array_diff($previousPart, $part))) {



>                     if (! \count(array_diff($previousPart, $part))) {


                        continue 2;
                    }
                }
            }

            $partsPile[] = $part;

> 


            if ($this->matchExtendsSingle($part, $origin, $initial)) {

<                 $after       = array_slice($selector, $i + 1);
<                 $before      = array_slice($selector, 0, $i);



>                 $after       = \array_slice($selector, $i + 1);
>                 $before      = \array_slice($selector, 0, $i);


                list($before, $nonBreakableBefore) = $this->extractRelationshipFromFragment($before);

                foreach ($origin as $new) {
                    $k = 0;

                    // remove shared parts

<                     if (count($new) > 1) {



>                     if (\count($new) > 1) {


                        while ($k < $i && isset($new[$k]) && $selector[$k] === $new[$k]) {
                            $k++;
                        }
                    }

<                     if (count($nonBreakableBefore) and $k == count($new)) {



> 
>                     if (\count($nonBreakableBefore) && $k === \count($new)) {


                        $k--;
                    }

                    $replacement = [];

<                     $tempReplacement = $k > 0 ? array_slice($new, $k) : $new;



>                     $tempReplacement = $k > 0 ? \array_slice($new, $k) : $new;




<                     for ($l = count($tempReplacement) - 1; $l >= 0; $l--) {



>                     for ($l = \count($tempReplacement) - 1; $l >= 0; $l--) {


                        $slice = [];

                        foreach ($tempReplacement[$l] as $chunk) {

<                             if (! in_array($chunk, $slice)) {



>                             if (! \in_array($chunk, $slice)) {


                                $slice[] = $chunk;
                            }
                        }

                        array_unshift($replacement, $slice);

                        if (! $this->isImmediateRelationshipCombinator(end($slice))) {
                            break;
                        }
                    }


<                     $afterBefore = $l != 0 ? array_slice($tempReplacement, 0, $l) : [];



>                     $afterBefore = $l != 0 ? \array_slice($tempReplacement, 0, $l) : [];



                    // Merge shared direct relationships.
                    $mergedBefore = $this->mergeDirectRelationships($afterBefore, $nonBreakableBefore);

                    $result = array_merge(
                        $before,
                        $mergedBefore,
                        $replacement,
                        $after
                    );

                    if ($result === $selector) {
                        continue;
                    }

                    $this->pushOrMergeExtentedSelector($out, $result);

                    // recursively check for more matches

<                     $startRecurseFrom = count($before) + min(count($nonBreakableBefore), count($mergedBefore));
<                     if (count($origin) > 1) {



>                     $startRecurseFrom = \count($before) + min(\count($nonBreakableBefore), \count($mergedBefore));
> 
>                     if (\count($origin) > 1) {


                        $this->matchExtends($result, $out, $startRecurseFrom, false);
                    } else {
                        $this->matchExtends($result, $outRecurs, $startRecurseFrom, false);
                    }

                    // selector sequence merging

<                     if (! empty($before) && count($new) > 1) {
<                         $preSharedParts = $k > 0 ? array_slice($before, 0, $k) : [];
<                         $postSharedParts = $k > 0 ? array_slice($before, $k) : $before;



>                     if (! empty($before) && \count($new) > 1) {
>                         $preSharedParts = $k > 0 ? \array_slice($before, 0, $k) : [];
>                         $postSharedParts = $k > 0 ? \array_slice($before, $k) : $before;



                        list($betweenSharedParts, $nonBreakabl2) = $this->extractRelationshipFromFragment($afterBefore);

                        $result2 = array_merge(
                            $preSharedParts,
                            $betweenSharedParts,
                            $postSharedParts,
                            $nonBreakabl2,
                            $nonBreakableBefore,
                            $replacement,
                            $after
                        );

                        $this->pushOrMergeExtentedSelector($out, $result2);
                    }
                }
            }
            array_pop($partsPile);
        }

<         while (count($outRecurs)) {



> 
>         while (\count($outRecurs)) {


            $result = array_shift($outRecurs);
            $this->pushOrMergeExtentedSelector($out, $result);
        }
    }

    /**
     * Test a part for being a pseudo selector

>      *


     * @param string $part
     * @param array $matches

>      *


     * @return bool
     */
    protected function isPseudoSelector($part, &$matches)
    {

<         if (strpos($part, ":") === 0
<             && preg_match(",^::?([\w-]+)\((.+)\)$,", $part, $matches)) {



>         if (
>             strpos($part, ':') === 0 &&
>             preg_match(",^::?([\w-]+)\((.+)\)$,", $part, $matches)
>         ) {


            return true;
        }

> 


        return false;
    }

    /**
     * Push extended selector except if
     *  - this is a pseudo selector
     *  - same as previous
     *  - in a white list
     * in this case we merge the pseudo selector content

>      *


     * @param array $out
     * @param array $extended

>      *
     */
>      * @return void


    protected function pushOrMergeExtentedSelector(&$out, $extended)
    {

<         if (count($out) && count($extended) === 1 && count(reset($extended)) === 1) {



>         if (\count($out) && \count($extended) === 1 && \count(reset($extended)) === 1) {


            $single = reset($extended);
            $part = reset($single);

<             if ($this->isPseudoSelector($part, $matchesExtended)
<               && in_array($matchesExtended[1], [ 'slotted' ])) {



> 
>             if (
>                 $this->isPseudoSelector($part, $matchesExtended) &&
>                 \in_array($matchesExtended[1], [ 'slotted' ])
>             ) {


                $prev = end($out);
                $prev = $this->glueFunctionSelectors($prev);

<                 if (count($prev) === 1 && count(reset($prev)) === 1) {



> 
>                 if (\count($prev) === 1 && \count(reset($prev)) === 1) {


                    $single = reset($prev);
                    $part = reset($single);

<                     if ($this->isPseudoSelector($part, $matchesPrev)
<                       && $matchesPrev[1] === $matchesExtended[1]) {



> 
>                     if (
>                         $this->isPseudoSelector($part, $matchesPrev) &&
>                         $matchesPrev[1] === $matchesExtended[1]
>                     ) {


                        $extended = explode($matchesExtended[1] . '(', $matchesExtended[0], 2);

<                         $extended[1] = $matchesPrev[2] . ", " . $extended[1];



>                         $extended[1] = $matchesPrev[2] . ', ' . $extended[1];


                        $extended = implode($matchesExtended[1] . '(', $extended);
                        $extended = [ [ $extended ]];
                        array_pop($out);
                    }
                }
            }
        }
        $out[] = $extended;
    }

    /**
     * Match extends single
     *
     * @param array $rawSingle
     * @param array $outOrigin
     * @param bool $initial
     *

<      * @return boolean



>      * @return bool


     */
    protected function matchExtendsSingle($rawSingle, &$outOrigin, $initial = true)
    {
        $counts = [];
        $single = [];

        // simple usual cases, no need to do the whole trick

<         if (in_array($rawSingle, [['>'],['+'],['~']])) {



>         if (\in_array($rawSingle, [['>'],['+'],['~']])) {


            return false;
        }

        foreach ($rawSingle as $part) {
            // matches Number

<             if (! is_string($part)) {



>             if (! \is_string($part)) {


                return false;
            }


<             if (! preg_match('/^[\[.:#%]/', $part) && count($single)) {
<                 $single[count($single) - 1] .= $part;



>             if (! preg_match('/^[\[.:#%]/', $part) && \count($single)) {
>                 $single[\count($single) - 1] .= $part;


            } else {
                $single[] = $part;
            }
        }

        $extendingDecoratedTag = false;


<         if (count($single) > 1) {



>         if (\count($single) > 1) {


            $matches = null;
            $extendingDecoratedTag = preg_match('/^[a-z0-9]+$/i', $single[0], $matches) ? $matches[0] : false;
        }

        $outOrigin = [];
        $found = false;

        foreach ($single as $k => $part) {
            if (isset($this->extendsMap[$part])) {
                foreach ($this->extendsMap[$part] as $idx) {
                    $counts[$idx] = isset($counts[$idx]) ? $counts[$idx] + 1 : 1;
                }
            }

<             if ($initial
<                 && $this->isPseudoSelector($part, $matches)
<                 && ! in_array($matches[1], [ 'not' ])) {



> 
>             if (
>                 $initial &&
>                 $this->isPseudoSelector($part, $matches) &&
>                 ! \in_array($matches[1], [ 'not' ])
>             ) {


                $buffer    = $matches[2];
                $parser    = $this->parserFactory(__METHOD__);

<                 if ($parser->parseSelector($buffer, $subSelectors)) {



> 
>                 if ($parser->parseSelector($buffer, $subSelectors, false)) {


                    foreach ($subSelectors as $ksub => $subSelector) {
                        $subExtended = [];
                        $this->matchExtends($subSelector, $subExtended, 0, false);

> 


                        if ($subExtended) {
                            $subSelectorsExtended = $subSelectors;
                            $subSelectorsExtended[$ksub] = $subExtended;

> 


                            foreach ($subSelectorsExtended as $ksse => $sse) {
                                $subSelectorsExtended[$ksse] = $this->collapseSelectors($sse);
                            }

> 


                            $subSelectorsExtended = implode(', ', $subSelectorsExtended);
                            $singleExtended = $single;

<                             $singleExtended[$k] = str_replace("(".$buffer.")", "($subSelectorsExtended)", $part);



>                             $singleExtended[$k] = str_replace('(' . $buffer . ')', "($subSelectorsExtended)", $part);


                            $outOrigin[] = [ $singleExtended ];
                            $found = true;
                        }
                    }
                }
            }
        }

        foreach ($counts as $idx => $count) {
            list($target, $origin, /* $block */) = $this->extends[$idx];

            $origin = $this->glueFunctionSelectors($origin);

            // check count

<             if ($count !== count($target)) {



>             if ($count !== \count($target)) {


                continue;
            }

            $this->extends[$idx][3] = true;

            $rem = array_diff($single, $target);

            foreach ($origin as $j => $new) {
                // prevent infinite loop when target extends itself

<                 if ($this->isSelfExtend($single, $origin)) {



>                 if ($this->isSelfExtend($single, $origin) && ! $initial) {


                    return false;
                }

                $replacement = end($new);

                // Extending a decorated tag with another tag is not possible.

<                 if ($extendingDecoratedTag && $replacement[0] != $extendingDecoratedTag &&



>                 if (
>                     $extendingDecoratedTag && $replacement[0] != $extendingDecoratedTag &&


                    preg_match('/^[a-z0-9]+$/i', $replacement[0])
                ) {
                    unset($origin[$j]);
                    continue;
                }

                $combined = $this->combineSelectorSingle($replacement, $rem);


<                 if (count(array_diff($combined, $origin[$j][count($origin[$j]) - 1]))) {
<                     $origin[$j][count($origin[$j]) - 1] = $combined;



>                 if (\count(array_diff($combined, $origin[$j][\count($origin[$j]) - 1]))) {
>                     $origin[$j][\count($origin[$j]) - 1] = $combined;


                }
            }

            $outOrigin = array_merge($outOrigin, $origin);

            $found = true;
        }

        return $found;
    }

    /**
     * Extract a relationship from the fragment.
     *
     * When extracting the last portion of a selector we will be left with a
     * fragment which may end with a direction relationship combinator. This
     * method will extract the relationship fragment and return it along side
     * the rest.
     *
     * @param array $fragment The selector fragment maybe ending with a direction relationship combinator.
     *
     * @return array The selector without the relationship fragment if any, the relationship fragment.
     */
    protected function extractRelationshipFromFragment(array $fragment)
    {
        $parents = [];
        $children = [];


<         $j = $i = count($fragment);



>         $j = $i = \count($fragment);



        for (;;) {

<             $children = $j != $i ? array_slice($fragment, $j, $i - $j) : [];
<             $parents  = array_slice($fragment, 0, $j);



>             $children = $j != $i ? \array_slice($fragment, $j, $i - $j) : [];
>             $parents  = \array_slice($fragment, 0, $j);


            $slice    = end($parents);

            if (empty($slice) || ! $this->isImmediateRelationshipCombinator($slice[0])) {
                break;
            }

            $j -= 2;
        }

        return [$parents, $children];
    }

    /**
     * Combine selector single
     *
     * @param array $base
     * @param array $other
     *
     * @return array
     */
    protected function combineSelectorSingle($base, $other)
    {
        $tag    = [];
        $out    = [];
        $wasTag = false;

>         $pseudo = [];

> 
        foreach ([array_reverse($base), array_reverse($other)] as $single) {
>         while (\count($other) && strpos(end($other), ':') === 0) {
            foreach ($single as $part) {
>             array_unshift($pseudo, array_pop($other));
                if (preg_match('/^[\[:]/', $part)) {
>         }


                    $out[] = $part;

>             $rang = count($single);
                    $wasTag = false;
> 


                } elseif (preg_match('/^[\.#]/', $part)) {
                    array_unshift($out, $part);
                    $wasTag = false;

<                 } elseif (preg_match('/^[^_-]/', $part)) {



>                 } elseif (preg_match('/^[^_-]/', $part) && $rang === 1) {


                    $tag[] = $part;
                    $wasTag = true;
                } elseif ($wasTag) {

<                     $tag[count($tag) - 1] .= $part;



>                     $tag[\count($tag) - 1] .= $part;


                } else {

<                     $out[] = $part;



>                     array_unshift($out, $part);


                }

>                 $rang--;


            }
        }


<         if (count($tag)) {



>         if (\count($tag)) {


            array_unshift($out, $tag[0]);
        }


>         while (\count($pseudo)) {
        return $out;
>             $out[] = array_shift($pseudo);
    }
>         }

> 


    /**
     * Compile media
     *
     * @param \ScssPhp\ScssPhp\Block $media

>      *
     */
>      * @return void


    protected function compileMedia(Block $media)
    {

>         assert($media instanceof MediaBlock);


        $this->pushEnv($media);

        $mediaQueries = $this->compileMediaQuery($this->multiplyMedia($this->env));


<         if (! empty($mediaQueries) && $mediaQueries) {



>         if (! empty($mediaQueries)) {
>             assert($this->scope !== null);


            $previousScope = $this->scope;
            $parentScope = $this->mediaParent($this->scope);

            foreach ($mediaQueries as $mediaQuery) {
                $this->scope = $this->makeOutputBlock(Type::T_MEDIA, [$mediaQuery]);

                $parentScope->children[] = $this->scope;
                $parentScope = $this->scope;
            }

            // top level properties in a media cause it to be wrapped
            $needsWrap = false;

            foreach ($media->children as $child) {
                $type = $child[0];


<                 if ($type !== Type::T_BLOCK &&



>                 if (
>                     $type !== Type::T_BLOCK &&


                    $type !== Type::T_MEDIA &&
                    $type !== Type::T_DIRECTIVE &&
                    $type !== Type::T_IMPORT
                ) {
                    $needsWrap = true;
                    break;
                }
            }

            if ($needsWrap) {

<                 $wrapped = new Block;



>                 $wrapped = new Block();


                $wrapped->sourceName   = $media->sourceName;
                $wrapped->sourceIndex  = $media->sourceIndex;
                $wrapped->sourceLine   = $media->sourceLine;
                $wrapped->sourceColumn = $media->sourceColumn;
                $wrapped->selectors    = [];
                $wrapped->comments     = [];
                $wrapped->parent       = $media;
                $wrapped->children     = $media->children;

                $media->children = [[Type::T_BLOCK, $wrapped]];

< 
<                 if (isset($this->lineNumberStyle)) {
<                     $annotation = $this->makeOutputBlock(Type::T_COMMENT);
<                     $annotation->depth = 0;
< 
<                     $file = $this->sourceNames[$media->sourceIndex];
<                     $line = $media->sourceLine;
< 
<                     switch ($this->lineNumberStyle) {
<                         case static::LINE_COMMENTS:
<                             $annotation->lines[] = '/* line ' . $line
<                                                  . ($file ? ', ' . $file : '')
<                                                  . ' */';
<                             break;
< 
<                         case static::DEBUG_INFO:
<                             $annotation->lines[] = '@media -sass-debug-info{'
<                                                  . ($file ? 'filename{font-family:"' . $file . '"}' : '')
<                                                  . 'line{font-family:' . $line . '}}';
<                             break;
<                     }
< 
<                     $this->scope->children[] = $annotation;
<                 }


            }

            $this->compileChildrenNoReturn($media->children, $this->scope);

            $this->scope = $previousScope;
        }

        $this->popEnv();
    }

    /**
     * Media parent
     *
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $scope
     *
     * @return \ScssPhp\ScssPhp\Formatter\OutputBlock
     */
    protected function mediaParent(OutputBlock $scope)
    {
        while (! empty($scope->parent)) {
            if (! empty($scope->type) && $scope->type !== Type::T_MEDIA) {
                break;
            }

            $scope = $scope->parent;
        }

        return $scope;
    }

    /**
     * Compile directive
     *

<      * @param \ScssPhp\ScssPhp\Block|array $block



>      * @param DirectiveBlock|array                   $directive


     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out

>      *
     */
>      * @return void


    protected function compileDirective($directive, OutputBlock $out)
    {

<         if (is_array($directive)) {
<             $s = '@' . $directive[0];



>         if (\is_array($directive)) {
>             $directiveName = $this->compileDirectiveName($directive[0]);
>             $s = '@' . $directiveName;
> 


            if (! empty($directive[1])) {
                $s .= ' ' . $this->compileValue($directive[1]);
            }

<             $this->appendRootDirective($s . ';', $out);



>             // sass-spec compliance on newline after directives, a bit tricky :/
>             $appendNewLine = (! empty($directive[2]) || strpos($s, "\n")) ? "\n" : "";
>             if (\is_array($directive[0]) && empty($directive[1])) {
>                 $appendNewLine = "\n";
>             }
> 
>             if (empty($directive[3])) {
>                 $this->appendRootDirective($s . ';' . $appendNewLine, $out, [Type::T_COMMENT, Type::T_DIRECTIVE]);
>             } else {
>                 $this->appendOutputLine($out, Type::T_DIRECTIVE, $s . ';');
>             }


        } else {

>             $directive->name = $this->compileDirectiveName($directive->name);


            $s = '@' . $directive->name;

            if (! empty($directive->value)) {
                $s .= ' ' . $this->compileValue($directive->value);
            }

            if ($directive->name === 'keyframes' || substr($directive->name, -10) === '-keyframes') {
                $this->compileKeyframeBlock($directive, [$s]);
            } else {
                $this->compileNestedBlock($directive, [$s]);
            }
        }
    }

    /**

>      * directive names can include some interpolation
     * Compile at-root
>      *
     *
>      * @param string|array $directiveName
     * @param \ScssPhp\ScssPhp\Block $block
>      * @return string
     */
>      * @throws CompilerException
    protected function compileAtRoot(Block $block)
>      */
    {
>     protected function compileDirectiveName($directiveName)
        $env     = $this->pushEnv($block);
>     {
        $envs    = $this->compactEnv($env);
>         if (is_string($directiveName)) {
        list($with, $without) = $this->compileWith(isset($block->with) ? $block->with : null);
>             return $directiveName;

>         }
        // wrap inline selector
> 
        if ($block->selector) {
>         return $this->compileValue($directiveName);
            $wrapped = new Block;
>     }
            $wrapped->sourceName   = $block->sourceName;
> 
            $wrapped->sourceIndex  = $block->sourceIndex;
>     /**


            $wrapped->sourceLine   = $block->sourceLine;

>      *
            $wrapped->sourceColumn = $block->sourceColumn;
>      * @return void


            $wrapped->selectors    = $block->selector;

>         assert($block instanceof AtRootBlock);



<             $wrapped = new Block;



>             $wrapped = new Block();


            $wrapped->parent       = $block;
            $wrapped->children     = $block->children;
            $wrapped->selfParent   = $block->selfParent;

            $block->children = [[Type::T_BLOCK, $wrapped]];
            $block->selector = null;
        }

        $selfParent = $block->selfParent;

>         assert($selfParent !== null, 'at-root blocks must have a selfParent set.');




<         if (! $block->selfParent->selectors && isset($block->parent) && $block->parent &&



>         if (
>             ! $selfParent->selectors &&
>             isset($block->parent) &&


            isset($block->parent->selectors) && $block->parent->selectors
        ) {
            $selfParent = $block->parent;
        }

        $this->env = $this->filterWithWithout($envs, $with, $without);


>         assert($this->scope !== null);


        $saveScope   = $this->scope;
        $this->scope = $this->filterScopeWithWithout($saveScope, $with, $without);

        // propagate selfParent to the children where they still can be useful
        $this->compileChildrenNoReturn($block->children, $this->scope, $selfParent);


<         $this->scope = $this->completeScope($this->scope, $saveScope);



>         assert($this->scope !== null);
>         $this->completeScope($this->scope, $saveScope);


        $this->scope = $saveScope;
        $this->env   = $this->extractEnv($envs);

        $this->popEnv();
    }

    /**

<      * Filter at-root scope depending of with/without option



>      * Filter at-root scope depending on with/without option


     *
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $scope
     * @param array                                  $with
     * @param array                                  $without
     *

<      * @return mixed



>      * @return OutputBlock


     */
    protected function filterScopeWithWithout($scope, $with, $without)
    {
        $filteredScopes = [];
        $childStash = [];


<         if ($scope->type === TYPE::T_ROOT) {



>         if ($scope->type === Type::T_ROOT) {


            return $scope;
        }

>         assert($this->rootBlock !== null);



        // start from the root

<         while ($scope->parent && $scope->parent->type !== TYPE::T_ROOT) {



>         while ($scope->parent && $scope->parent->type !== Type::T_ROOT) {


            array_unshift($childStash, $scope);
            $scope = $scope->parent;
        }

        for (;;) {
            if (! $scope) {
                break;
            }

            if ($this->isWith($scope, $with, $without)) {
                $s = clone $scope;
                $s->children = [];
                $s->lines    = [];
                $s->parent   = null;

                if ($s->type !== Type::T_MEDIA && $s->type !== Type::T_DIRECTIVE) {
                    $s->selectors = [];
                }

                $filteredScopes[] = $s;
            }


<             if (count($childStash)) {



>             if (\count($childStash)) {


                $scope = array_shift($childStash);
            } elseif ($scope->children) {
                $scope = end($scope->children);
            } else {
                $scope = null;
            }
        }


<         if (! count($filteredScopes)) {



>         if (! \count($filteredScopes)) {


            return $this->rootBlock;
        }

        $newScope = array_shift($filteredScopes);
        $newScope->parent = $this->rootBlock;

        $this->rootBlock->children[] = $newScope;

        $p = &$newScope;


<         while (count($filteredScopes)) {



>         while (\count($filteredScopes)) {


            $s = array_shift($filteredScopes);
            $s->parent = $p;
            $p->children[] = $s;
            $newScope = &$p->children[0];
            $p = &$p->children[0];
        }

        return $newScope;
    }

    /**
     * found missing selector from a at-root compilation in the previous scope
     * (if at-root is just enclosing a property, the selector is in the parent tree)
     *
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $scope
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $previousScope
     *

<      * @return mixed



>      * @return OutputBlock


     */
    protected function completeScope($scope, $previousScope)
    {

<         if (! $scope->type && (! $scope->selectors || ! count($scope->selectors)) && count($scope->lines)) {



>         if (! $scope->type && ! $scope->selectors && \count($scope->lines)) {


            $scope->selectors = $this->findScopeSelectors($previousScope, $scope->depth);
        }

        if ($scope->children) {
            foreach ($scope->children as $k => $c) {
                $scope->children[$k] = $this->completeScope($c, $previousScope);
            }
        }

        return $scope;
    }

    /**
     * Find a selector by the depth node in the scope
     *
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $scope

<      * @param integer                                $depth



>      * @param int                                    $depth


     *
     * @return array
     */
    protected function findScopeSelectors($scope, $depth)
    {
        if ($scope->depth === $depth && $scope->selectors) {
            return $scope->selectors;
        }

        if ($scope->children) {
            foreach (array_reverse($scope->children) as $c) {
                if ($s = $this->findScopeSelectors($c, $depth)) {
                    return $s;
                }
            }
        }

        return [];
    }

    /**
     * Compile @at-root's with: inclusion / without: exclusion into 2 lists uses to filter scope/env later
     *

<      * @param array $withCondition



>      * @param array|null $withCondition


     *
     * @return array

>      *
     */
>      * @phpstan-return array{array<string, bool>, array<string, bool>}


    protected function compileWith($withCondition)
    {
        // just compile what we have in 2 lists
        $with = [];
        $without = ['rule' => true];

        if ($withCondition) {

<             if ($this->libMapHasKey([$withCondition, static::$with])) {



>             if ($withCondition[0] === Type::T_INTERPOLATE) {
>                 $w = $this->compileValue($withCondition);
> 
>                 $buffer = "($w)";
>                 $parser = $this->parserFactory(__METHOD__);
> 
>                 if ($parser->parseValue($buffer, $reParsedWith)) {
>                     $withCondition = $reParsedWith;
>                 }
>             }
> 
>             $withConfig = $this->mapGet($withCondition, static::$with);
>             if ($withConfig !== null) {


                $without = []; // cancel the default

<                 $list = $this->coerceList($this->libMapGet([$withCondition, static::$with]));



>                 $list = $this->coerceList($withConfig);



                foreach ($list[2] as $item) {
                    $keyword = $this->compileStringContent($this->coerceString($item));

                    $with[$keyword] = true;
                }
            }


<             if ($this->libMapHasKey([$withCondition, static::$without])) {



>             $withoutConfig = $this->mapGet($withCondition, static::$without);
>             if ($withoutConfig !== null) {


                $without = []; // cancel the default

<                 $list = $this->coerceList($this->libMapGet([$withCondition, static::$without]));



>                 $list = $this->coerceList($withoutConfig);



                foreach ($list[2] as $item) {
                    $keyword = $this->compileStringContent($this->coerceString($item));

                    $without[$keyword] = true;
                }
            }
        }

        return [$with, $without];
    }

    /**
     * Filter env stack
     *

<      * @param array   $envs



>      * @param Environment[] $envs


     * @param array $with
     * @param array $without
     *

<      * @return \ScssPhp\ScssPhp\Compiler\Environment



>      * @return Environment
>      *
>      * @phpstan-param  non-empty-array<Environment> $envs


     */
    protected function filterWithWithout($envs, $with, $without)
    {
        $filtered = [];

        foreach ($envs as $e) {
            if ($e->block && ! $this->isWith($e->block, $with, $without)) {
                $ec = clone $e;
                $ec->block     = null;
                $ec->selectors = [];

                $filtered[] = $ec;
            } else {
                $filtered[] = $e;
            }
        }

        return $this->extractEnv($filtered);
    }

    /**
     * Filter WITH rules
     *
     * @param \ScssPhp\ScssPhp\Block|\ScssPhp\ScssPhp\Formatter\OutputBlock $block
     * @param array                                                         $with
     * @param array                                                         $without
     *

<      * @return boolean



>      * @return bool


     */
    protected function isWith($block, $with, $without)
    {
        if (isset($block->type)) {
            if ($block->type === Type::T_MEDIA) {
                return $this->testWithWithout('media', $with, $without);
            }

            if ($block->type === Type::T_DIRECTIVE) {

>                 assert($block instanceof DirectiveBlock || $block instanceof OutputBlock);


                if (isset($block->name)) {

<                     return $this->testWithWithout($block->name, $with, $without);



>                     return $this->testWithWithout($this->compileDirectiveName($block->name), $with, $without);


                } elseif (isset($block->selectors) && preg_match(',@(\w+),ims', json_encode($block->selectors), $m)) {
                    return $this->testWithWithout($m[1], $with, $without);
                } else {
                    return $this->testWithWithout('???', $with, $without);
                }
            }
        } elseif (isset($block->selectors)) {
            // a selector starting with number is a keyframe rule

<             if (count($block->selectors)) {



>             if (\count($block->selectors)) {


                $s = reset($block->selectors);


<                 while (is_array($s)) {



>                 while (\is_array($s)) {


                    $s = reset($s);
                }


<                 if (is_object($s) && $s instanceof Node\Number) {



>                 if (\is_object($s) && $s instanceof Number) {


                    return $this->testWithWithout('keyframes', $with, $without);
                }
            }

            return $this->testWithWithout('rule', $with, $without);
        }

        return true;
    }

    /**
     * Test a single type of block against with/without lists
     *
     * @param string $what
     * @param array  $with
     * @param array  $without
     *

<      * @return boolean



>      * @return bool


     *   true if the block should be kept, false to reject
     */
    protected function testWithWithout($what, $with, $without)
    {

< 


        // if without, reject only if in the list (or 'all' is in the list)

<         if (count($without)) {



>         if (\count($without)) {


            return (isset($without[$what]) || isset($without['all'])) ? false : true;
        }

        // otherwise reject all what is not in the with list
        return (isset($with[$what]) || isset($with['all'])) ? true : false;
    }


    /**
     * Compile keyframe block
     *
     * @param \ScssPhp\ScssPhp\Block $block

<      * @param array                  $selectors



>      * @param string[]               $selectors
>      *
>      * @return void


     */
    protected function compileKeyframeBlock(Block $block, $selectors)
    {
        $env = $this->pushEnv($block);

        $envs = $this->compactEnv($env);

        $this->env = $this->extractEnv(array_filter($envs, function (Environment $e) {
            return ! isset($e->block->selectors);
        }));

        $this->scope = $this->makeOutputBlock($block->type, $selectors);
        $this->scope->depth = 1;

>         assert($this->scope->parent !== null);


        $this->scope->parent->children[] = $this->scope;

        $this->compileChildrenNoReturn($block->children, $this->scope);


>         assert($this->scope !== null);


        $this->scope = $this->scope->parent;
        $this->env   = $this->extractEnv($envs);

        $this->popEnv();
    }

    /**
     * Compile nested properties lines
     *
     * @param \ScssPhp\ScssPhp\Block $block

<      * @param OutputBlock            $out



>      * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out
>      *
>      * @return void


     */
    protected function compileNestedPropertiesBlock(Block $block, OutputBlock $out)
    {

>         assert($block instanceof NestedPropertyBlock);


        $prefix = $this->compileValue($block->prefix) . '-';

        $nested = $this->makeOutputBlock($block->type);
        $nested->parent = $out;

        if ($block->hasValue) {
            $nested->depth = $out->depth + 1;
        }

        $out->children[] = $nested;

        foreach ($block->children as $child) {
            switch ($child[0]) {
                case Type::T_ASSIGN:
                    array_unshift($child[1][2], $prefix);
                    break;

                case Type::T_NESTED_PROPERTY:

>                     assert($child[1] instanceof NestedPropertyBlock);


                    array_unshift($child[1]->prefix[2], $prefix);
                    break;
            }

            $this->compileChild($child, $nested);
        }
    }

    /**
     * Compile nested block
     *
     * @param \ScssPhp\ScssPhp\Block $block

<      * @param array                  $selectors



>      * @param string[]               $selectors
>      *
>      * @return void


     */
    protected function compileNestedBlock(Block $block, $selectors)
    {
        $this->pushEnv($block);

        $this->scope = $this->makeOutputBlock($block->type, $selectors);

>         assert($this->scope->parent !== null);


        $this->scope->parent->children[] = $this->scope;

        // wrap assign children in a block
        // except for @font-face

<         if ($block->type !== Type::T_DIRECTIVE || $block->name !== "font-face") {



>         if (!$block instanceof DirectiveBlock || $this->compileDirectiveName($block->name) !== 'font-face') {


            // need wrapping?
            $needWrapping = false;

            foreach ($block->children as $child) {
                if ($child[0] === Type::T_ASSIGN) {
                    $needWrapping = true;
                    break;
                }
            }

            if ($needWrapping) {

<                 $wrapped = new Block;



>                 $wrapped = new Block();


                $wrapped->sourceName   = $block->sourceName;
                $wrapped->sourceIndex  = $block->sourceIndex;
                $wrapped->sourceLine   = $block->sourceLine;
                $wrapped->sourceColumn = $block->sourceColumn;
                $wrapped->selectors    = [];
                $wrapped->comments     = [];
                $wrapped->parent       = $block;
                $wrapped->children     = $block->children;
                $wrapped->selfParent   = $block->selfParent;

                $block->children = [[Type::T_BLOCK, $wrapped]];
            }
        }

        $this->compileChildrenNoReturn($block->children, $this->scope);


>         assert($this->scope !== null);


        $this->scope = $this->scope->parent;

        $this->popEnv();
    }

    /**
     * Recursively compiles a block.
     *
     * A block is analogous to a CSS block in most cases. A single SCSS document
     * is encapsulated in a block when parsed, but it does not have parent tags
     * so all of its children appear on the root level when compiled.
     *
     * Blocks are made up of selectors and children.
     *
     * The children of a block are just all the blocks that are defined within.
     *
     * Compiling the block involves pushing a fresh environment on the stack,
     * and iterating through the props, compiling each one.
     *
     * @see Compiler::compileChild()
     *
     * @param \ScssPhp\ScssPhp\Block $block

>      *
     */
>      * @return void


    protected function compileBlock(Block $block)
    {
        $env = $this->pushEnv($block);

>         assert($block->selectors !== null);


        $env->selectors = $this->evalSelectors($block->selectors);

        $out = $this->makeOutputBlock(null);


<         if (isset($this->lineNumberStyle) && count($env->selectors) && count($block->children)) {
<             $annotation = $this->makeOutputBlock(Type::T_COMMENT);
<             $annotation->depth = 0;
< 
<             $file = $this->sourceNames[$block->sourceIndex];
<             $line = $block->sourceLine;
< 
<             switch ($this->lineNumberStyle) {
<                 case static::LINE_COMMENTS:
<                     $annotation->lines[] = '/* line ' . $line
<                                          . ($file ? ', ' . $file : '')
<                                          . ' */';
<                     break;
< 
<                 case static::DEBUG_INFO:
<                     $annotation->lines[] = '@media -sass-debug-info{'
<                                          . ($file ? 'filename{font-family:"' . $file . '"}' : '')
<                                          . 'line{font-family:' . $line . '}}';
<                     break;
<             }
< 
<             $this->scope->children[] = $annotation;
<         }
< 



>         assert($this->scope !== null);


        $this->scope->children[] = $out;


<         if (count($block->children)) {



>         if (\count($block->children)) {


            $out->selectors = $this->multiplySelectors($env, $block->selfParent);

            // propagate selfParent to the children where they still can be useful
            $selfParentSelectors = null;

            if (isset($block->selfParent->selectors)) {
                $selfParentSelectors = $block->selfParent->selectors;
                $block->selfParent->selectors = $out->selectors;
            }

            $this->compileChildrenNoReturn($block->children, $out, $block->selfParent);

            // and revert for the following children of the same block
            if ($selfParentSelectors) {

>                 assert($block->selfParent !== null);


                $block->selfParent->selectors = $selfParentSelectors;
            }
        }

        $this->popEnv();
    }


    /**
     * Compile the value of a comment that can have interpolation
     *
     * @param array   $value

<      * @param boolean $pushEnv



>      * @param bool  $pushEnv


     *

<      * @return array|mixed|string



>      * @return string


     */
    protected function compileCommentValue($value, $pushEnv = false)
    {
        $c = $value[1];

        if (isset($value[2])) {
            if ($pushEnv) {
                $this->pushEnv();

<                 $storeEnv = $this->storeEnv;
<                 $this->storeEnv = $this->env;


            }

            try {
                $c = $this->compileValue($value[2]);

<             } catch (\Exception $e) {



>             } catch (SassScriptException $e) {
>                 $this->logger->warn('Ignoring interpolation errors in multiline comments is deprecated and will be removed in ScssPhp 2.0. ' . $this->addLocationToMessage($e->getMessage()), true);
>                 // ignore error in comment compilation which are only interpolation
>             } catch (SassException $e) {
>                 $this->logger->warn('Ignoring interpolation errors in multiline comments is deprecated and will be removed in ScssPhp 2.0. ' . $e->getMessage(), true);


                // ignore error in comment compilation which are only interpolation
            }

            if ($pushEnv) {

<                 $this->storeEnv = $storeEnv;


                $this->popEnv();
            }
        }

        return $c;
    }

    /**
     * Compile root level comment
     *
     * @param array $block

>      *
     */
>      * @return void


    protected function compileComment($block)
    {
        $out = $this->makeOutputBlock(Type::T_COMMENT);
        $out->lines[] = $this->compileCommentValue($block, true);


>         assert($this->scope !== null);


        $this->scope->children[] = $out;
    }

    /**
     * Evaluate selectors
     *
     * @param array $selectors
     *
     * @return array
     */
    protected function evalSelectors($selectors)
    {
        $this->shouldEvaluate = false;


<         $selectors = array_map([$this, 'evalSelector'], $selectors);



>         $evaluatedSelectors = [];
>         foreach ($selectors as $selector) {
>             $evaluatedSelectors[] = $this->evalSelector($selector);
>         }
>         $selectors = $evaluatedSelectors;



        // after evaluating interpolates, we might need a second pass
        if ($this->shouldEvaluate) {

<             $selectors = $this->revertSelfSelector($selectors);



>             $selectors = $this->replaceSelfSelector($selectors, '&');


            $buffer    = $this->collapseSelectors($selectors);
            $parser    = $this->parserFactory(__METHOD__);


<             if ($parser->parseSelector($buffer, $newSelectors)) {



>             try {
>                 $isValid = $parser->parseSelector($buffer, $newSelectors, true);
>             } catch (ParserException $e) {
>                 throw $this->error($e->getMessage());
>             }
> 
>             if ($isValid) {


                $selectors = array_map([$this, 'evalSelector'], $newSelectors);
            }
        }

        return $selectors;
    }

    /**
     * Evaluate selector
     *
     * @param array $selector
     *
     * @return array

>      *
     */
>      * @phpstan-impure


    protected function evalSelector($selector)
    {
        return array_map([$this, 'evalSelectorPart'], $selector);
    }

    /**
     * Evaluate selector part; replaces all the interpolates, stripping quotes
     *
     * @param array $part
     *
     * @return array

>      *
     */
>      * @phpstan-impure


    protected function evalSelectorPart($part)
    {
        foreach ($part as &$p) {

<             if (is_array($p) && ($p[0] === Type::T_INTERPOLATE || $p[0] === Type::T_STRING)) {



>             if (\is_array($p) && ($p[0] === Type::T_INTERPOLATE || $p[0] === Type::T_STRING)) {


                $p = $this->compileValue($p);


<                 // force re-evaluation
<                 if (strpos($p, '&') !== false || strpos($p, ',') !== false) {



>                 // force re-evaluation if self char or non standard char
>                 if (preg_match(',[^\w-],', $p)) {


                    $this->shouldEvaluate = true;
                }

<             } elseif (is_string($p) && strlen($p) >= 2 &&
<                 ($first = $p[0]) && ($first === '"' || $first === "'") &&
<                 substr($p, -1) === $first



>             } elseif (
>                 \is_string($p) && \strlen($p) >= 2 &&
>                 ($p[0] === '"' || $p[0] === "'") &&
>                 substr($p, -1) === $p[0]


            ) {
                $p = substr($p, 1, -1);
            }
        }

        return $this->flattenSelectorSingle($part);
    }

    /**
     * Collapse selectors
     *
     * @param array   $selectors

<      * @param boolean $selectorFormat
<      *   if false return a collapsed string
<      *   if true return an array description of a structured selector


     *
     * @return string
     */

<     protected function collapseSelectors($selectors, $selectorFormat = false)



>     protected function collapseSelectors($selectors)
>     {
>         $parts = [];
> 
>         foreach ($selectors as $selector) {
>             $output = [];
> 
>             foreach ($selector as $node) {
>                 $compound = '';
> 
>                 array_walk_recursive(
>                     $node,
>                     function ($value, $key) use (&$compound) {
>                         $compound .= $value;
>                     }
>                 );
> 
>                 $output[] = $compound;
>             }
> 
>             $parts[] = implode(' ', $output);
>         }
> 
>         return implode(', ', $parts);
>     }
> 
>     /**
>      * Collapse selectors
>      *
>      * @param array $selectors
>      *
>      * @return array
>      */
>     private function collapseSelectorsAsList($selectors)


    {
        $parts = [];

        foreach ($selectors as $selector) {
            $output = [];
            $glueNext = false;

            foreach ($selector as $node) {
                $compound = '';

                array_walk_recursive(
                    $node,
                    function ($value, $key) use (&$compound) {
                        $compound .= $value;
                    }
                );


<                 if ($selectorFormat && $this->isImmediateRelationshipCombinator($compound)) {
<                     if (count($output)) {
<                         $output[count($output) - 1] .= ' ' . $compound;



>                 if ($this->isImmediateRelationshipCombinator($compound)) {
>                     if (\count($output)) {
>                         $output[\count($output) - 1] .= ' ' . $compound;


                    } else {
                        $output[] = $compound;
                    }

                    $glueNext = true;
                } elseif ($glueNext) {

<                     $output[count($output) - 1] .= ' ' . $compound;



>                     $output[\count($output) - 1] .= ' ' . $compound;


                    $glueNext = false;
                } else {
                    $output[] = $compound;
                }
            }


<             if ($selectorFormat) {


                foreach ($output as &$o) {
                    $o = [Type::T_STRING, '', [$o]];
                }


<                 $output = [Type::T_LIST, ' ', $output];
<             } else {
<                 $output = implode(' ', $output);
<             }
< 
<             $parts[] = $output;



>             $parts[] = [Type::T_LIST, ' ', $output];


        }


<         if ($selectorFormat) {
<             $parts = [Type::T_LIST, ',', $parts];
<         } else {
<             $parts = implode(', ', $parts);
<         }
< 
<         return $parts;



>         return [Type::T_LIST, ',', $parts];


    }

    /**
     * Parse down the selector and revert [self] to "&" before a reparsing
     *
     * @param array $selectors

>      * @param string|null $replace


     *
     * @return array
     */

<     protected function revertSelfSelector($selectors)



>     protected function replaceSelfSelector($selectors, $replace = null)


    {
        foreach ($selectors as &$part) {

<             if (is_array($part)) {



>             if (\is_array($part)) {


                if ($part === [Type::T_SELF]) {

<                     $part = '&';



>                     if (\is_null($replace)) {
>                         $replace = $this->reduce([Type::T_SELF]);
>                         $replace = $this->compileValue($replace);
>                     }
>                     $part = $replace;


                } else {

<                     $part = $this->revertSelfSelector($part);



>                     $part = $this->replaceSelfSelector($part, $replace);


                }
            }
        }

        return $selectors;
    }

    /**
     * Flatten selector single; joins together .classes and #ids
     *
     * @param array $single
     *
     * @return array
     */
    protected function flattenSelectorSingle($single)
    {
        $joined = [];

        foreach ($single as $part) {

<             if (empty($joined) ||
<                 ! is_string($part) ||



>             if (
>                 empty($joined) ||
>                 ! \is_string($part) ||


                preg_match('/[\[.:#%]/', $part)
            ) {
                $joined[] = $part;
                continue;
            }


<             if (is_array(end($joined))) {



>             if (\is_array(end($joined))) {


                $joined[] = $part;
            } else {

<                 $joined[count($joined) - 1] .= $part;



>                 $joined[\count($joined) - 1] .= $part;


            }
        }

        return $joined;
    }

    /**
     * Compile selector to string; self(&) should have been replaced by now
     *
     * @param string|array $selector
     *
     * @return string
     */
    protected function compileSelector($selector)
    {

<         if (! is_array($selector)) {



>         if (! \is_array($selector)) {


            return $selector; // media and the like
        }

        return implode(
            ' ',
            array_map(
                [$this, 'compileSelectorPart'],
                $selector
            )
        );
    }

    /**
     * Compile selector part
     *
     * @param array $piece
     *
     * @return string
     */
    protected function compileSelectorPart($piece)
    {
        foreach ($piece as &$p) {

<             if (! is_array($p)) {



>             if (! \is_array($p)) {


                continue;
            }

            switch ($p[0]) {
                case Type::T_SELF:
                    $p = '&';
                    break;

                default:
                    $p = $this->compileValue($p);
                    break;
            }
        }

        return implode($piece);
    }

    /**
     * Has selector placeholder?
     *
     * @param array $selector
     *

<      * @return boolean



>      * @return bool


     */
    protected function hasSelectorPlaceholder($selector)
    {

<         if (! is_array($selector)) {



>         if (! \is_array($selector)) {


            return false;
        }

        foreach ($selector as $parts) {
            foreach ($parts as $part) {

<                 if (strlen($part) && '%' === $part[0]) {



>                 if (\strlen($part) && '%' === $part[0]) {


                    return true;
                }
            }
        }

        return false;
    }


>     /**
    protected function pushCallStack($name = '')
>      * @param string $name
    {
>      *
        $this->callStack[] = [
>      * @return void
          'n' => $name,
>      */


          Parser::SOURCE_INDEX => $this->sourceIndex,
          Parser::SOURCE_LINE => $this->sourceLine,
          Parser::SOURCE_COLUMN => $this->sourceColumn
        ];

        // infinite calling loop

<         if (count($this->callStack) > 25000) {



>         if (\count($this->callStack) > 25000) {


            // not displayed but you can var_dump it to deep debug
            $msg = $this->callStackMessage(true, 100);

<             $msg = "Infinite calling loop";



>             $msg = 'Infinite calling loop';




<             $this->throwError($msg);



>             throw $this->error($msg);


        }
    }


>     /**
    protected function popCallStack()
>      * @return void
    {
>      */


        array_pop($this->callStack);
    }

    /**
     * Compile children and return result
     *
     * @param array                                  $stms
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out
     * @param string                                 $traceName
     *

<      * @return array|null



>      * @return array|Number|null


     */
    protected function compileChildren($stms, OutputBlock $out, $traceName = '')
    {
        $this->pushCallStack($traceName);

        foreach ($stms as $stm) {
            $ret = $this->compileChild($stm, $out);

            if (isset($ret)) {

>                 $this->popCallStack();
                return $ret;
> 


            }
        }

        $this->popCallStack();

        return null;
    }

    /**

<      * Compile children and throw exception if unexpected @return



>      * Compile children and throw exception if unexpected at-return


     *

<      * @param array                                  $stms



>      * @param array[]                                $stms


     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out
     * @param \ScssPhp\ScssPhp\Block                 $selfParent
     * @param string                                 $traceName
     *

>      * @return void
     * @throws \Exception
>      *


     */
    protected function compileChildrenNoReturn($stms, OutputBlock $out, $selfParent = null, $traceName = '')
    {
        $this->pushCallStack($traceName);

        foreach ($stms as $stm) {

<             if ($selfParent && isset($stm[1]) && is_object($stm[1]) && $stm[1] instanceof Block) {



>             if ($selfParent && isset($stm[1]) && \is_object($stm[1]) && $stm[1] instanceof Block) {
>                 $oldSelfParent = $stm[1]->selfParent;


                $stm[1]->selfParent = $selfParent;
                $ret = $this->compileChild($stm, $out);

<                 $stm[1]->selfParent = null;
<             } elseif ($selfParent && in_array($stm[0], [TYPE::T_INCLUDE, TYPE::T_EXTEND])) {



>                 $stm[1]->selfParent = $oldSelfParent;
>             } elseif ($selfParent && \in_array($stm[0], [Type::T_INCLUDE, Type::T_EXTEND])) {


                $stm['selfParent'] = $selfParent;
                $ret = $this->compileChild($stm, $out);

<                 unset($stm['selfParent']);


            } else {
                $ret = $this->compileChild($stm, $out);
            }

            if (isset($ret)) {

<                 $this->throwError('@return may only be used within a function');
< 
<                 return;



>                 throw $this->error('@return may only be used within a function');


            }
        }

        $this->popCallStack();
    }


    /**

<      * evaluate media query : compile internal value keeping the structure inchanged



>      * evaluate media query : compile internal value keeping the structure unchanged


     *
     * @param array $queryList
     *
     * @return array
     */
    protected function evaluateMediaQuery($queryList)
    {
        static $parser = null;

        $outQueryList = [];

        foreach ($queryList as $kql => $query) {
            $shouldReparse = false;

            foreach ($query as $kq => $q) {

<                 for ($i = 1; $i < count($q); $i++) {



>                 for ($i = 1; $i < \count($q); $i++) {


                    $value = $this->compileValue($q[$i]);

                    // the parser had no mean to know if media type or expression if it was an interpolation
                    // so you need to reparse if the T_MEDIA_TYPE looks like anything else a media type

<                     if ($q[0] == Type::T_MEDIA_TYPE &&



>                     if (
>                         $q[0] == Type::T_MEDIA_TYPE &&


                        (strpos($value, '(') !== false ||
                        strpos($value, ')') !== false ||
                        strpos($value, ':') !== false ||
                        strpos($value, ',') !== false)
                    ) {
                        $shouldReparse = true;
                    }

                    $queryList[$kql][$kq][$i] = [Type::T_KEYWORD, $value];
                }
            }

            if ($shouldReparse) {

<                 if (is_null($parser)) {



>                 if (\is_null($parser)) {


                    $parser = $this->parserFactory(__METHOD__);
                }

                $queryString = $this->compileMediaQuery([$queryList[$kql]]);
                $queryString = reset($queryString);


<                 if (strpos($queryString, '@media ') === 0) {



>                 if ($queryString !== false && strpos($queryString, '@media ') === 0) {


                    $queryString = substr($queryString, 7);
                    $queries = [];

                    if ($parser->parseMediaQueryList($queryString, $queries)) {
                        $queries = $this->evaluateMediaQuery($queries[2]);


<                         while (count($queries)) {



>                         while (\count($queries)) {


                            $outQueryList[] = array_shift($queries);
                        }

                        continue;
                    }
                }
            }

            $outQueryList[] = $queryList[$kql];
        }

        return $outQueryList;
    }

    /**
     * Compile media query
     *
     * @param array $queryList
     *

<      * @return array



>      * @return string[]


     */
    protected function compileMediaQuery($queryList)
    {
        $start   = '@media ';
        $default = trim($start);
        $out     = [];

<         $current = "";



>         $current = '';



        foreach ($queryList as $query) {
            $type = null;
            $parts = [];

            $mediaTypeOnly = true;

            foreach ($query as $q) {
                if ($q[0] !== Type::T_MEDIA_TYPE) {
                    $mediaTypeOnly = false;
                    break;
                }
            }

            foreach ($query as $q) {
                switch ($q[0]) {
                    case Type::T_MEDIA_TYPE:

<                         $newType = array_map([$this, 'compileValue'], array_slice($q, 1));



>                         $newType = array_map([$this, 'compileValue'], \array_slice($q, 1));



                        // combining not and anything else than media type is too risky and should be avoided
                        if (! $mediaTypeOnly) {

<                             if (in_array(Type::T_NOT, $newType) || ($type && in_array(Type::T_NOT, $type) )) {



>                             if (\in_array(Type::T_NOT, $newType) || ($type && \in_array(Type::T_NOT, $type) )) {


                                if ($type) {
                                    array_unshift($parts, implode(' ', array_filter($type)));
                                }

                                if (! empty($parts)) {

<                                     if (strlen($current)) {



>                                     if (\strlen($current)) {


                                        $current .= $this->formatter->tagSeparator;
                                    }

                                    $current .= implode(' and ', $parts);
                                }

                                if ($current) {
                                    $out[] = $start . $current;
                                }


<                                 $current = "";



>                                 $current = '';


                                $type    = null;
                                $parts   = [];
                            }
                        }

                        if ($newType === ['all'] && $default) {
                            $default = $start . 'all';
                        }

                        // all can be safely ignored and mixed with whatever else
                        if ($newType !== ['all']) {
                            if ($type) {
                                $type = $this->mergeMediaTypes($type, $newType);

                                if (empty($type)) {
                                    // merge failed : ignore this query that is not valid, skip to the next one
                                    $parts = [];
                                    $default = ''; // if everything fail, no @media at all
                                    continue 3;
                                }
                            } else {
                                $type = $newType;
                            }
                        }
                        break;

                    case Type::T_MEDIA_EXPRESSION:
                        if (isset($q[2])) {
                            $parts[] = '('
                                . $this->compileValue($q[1])
                                . $this->formatter->assignSeparator
                                . $this->compileValue($q[2])
                                . ')';
                        } else {
                            $parts[] = '('
                                . $this->compileValue($q[1])
                                . ')';
                        }
                        break;

                    case Type::T_MEDIA_VALUE:
                        $parts[] = $this->compileValue($q[1]);
                        break;
                }
            }

            if ($type) {
                array_unshift($parts, implode(' ', array_filter($type)));
            }

            if (! empty($parts)) {

<                 if (strlen($current)) {



>                 if (\strlen($current)) {


                    $current .= $this->formatter->tagSeparator;
                }

                $current .= implode(' and ', $parts);
            }
        }

        if ($current) {
            $out[] = $start . $current;
        }

        // no @media type except all, and no conflict?
        if (! $out && $default) {
            $out[] = $default;
        }

        return $out;
    }

    /**
     * Merge direct relationships between selectors
     *
     * @param array $selectors1
     * @param array $selectors2
     *
     * @return array
     */
    protected function mergeDirectRelationships($selectors1, $selectors2)
    {
        if (empty($selectors1) || empty($selectors2)) {
            return array_merge($selectors1, $selectors2);
        }

        $part1 = end($selectors1);
        $part2 = end($selectors2);

        if (! $this->isImmediateRelationshipCombinator($part1[0]) && $part1 !== $part2) {
            return array_merge($selectors1, $selectors2);
        }

        $merged = [];

        do {
            $part1 = array_pop($selectors1);
            $part2 = array_pop($selectors2);

            if (! $this->isImmediateRelationshipCombinator($part1[0]) && $part1 !== $part2) {
                if ($this->isImmediateRelationshipCombinator(reset($merged)[0])) {
                    array_unshift($merged, [$part1[0] . $part2[0]]);
                    $merged = array_merge($selectors1, $selectors2, $merged);
                } else {
                    $merged = array_merge($selectors1, [$part1], $selectors2, [$part2], $merged);
                }

                break;
            }

            array_unshift($merged, $part1);
        } while (! empty($selectors1) && ! empty($selectors2));

        return $merged;
    }

    /**
     * Merge media types
     *
     * @param array $type1
     * @param array $type2
     *
     * @return array|null
     */
    protected function mergeMediaTypes($type1, $type2)
    {
        if (empty($type1)) {
            return $type2;
        }

        if (empty($type2)) {
            return $type1;
        }


<         if (count($type1) > 1) {



>         if (\count($type1) > 1) {


            $m1 = strtolower($type1[0]);
            $t1 = strtolower($type1[1]);
        } else {
            $m1 = '';
            $t1 = strtolower($type1[0]);
        }


<         if (count($type2) > 1) {



>         if (\count($type2) > 1) {


            $m2 = strtolower($type2[0]);
            $t2 = strtolower($type2[1]);
        } else {
            $m2 = '';
            $t2 = strtolower($type2[0]);
        }

        if (($m1 === Type::T_NOT) ^ ($m2 === Type::T_NOT)) {
            if ($t1 === $t2) {
                return null;
            }

            return [
                $m1 === Type::T_NOT ? $m2 : $m1,
                $m1 === Type::T_NOT ? $t2 : $t1,
            ];
        }

        if ($m1 === Type::T_NOT && $m2 === Type::T_NOT) {
            // CSS has no way of representing "neither screen nor print"
            if ($t1 !== $t2) {
                return null;
            }

            return [Type::T_NOT, $t1];
        }

        if ($t1 !== $t2) {
            return null;
        }

        // t1 == t2, neither m1 nor m2 are "not"
        return [empty($m1)? $m2 : $m1, $t1];
    }

    /**
     * Compile import; returns true if the value was something that could be imported
     *
     * @param array                                  $rawPath
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out

<      * @param boolean                                $once



>      * @param bool                                   $once


     *

<      * @return boolean



>      * @return bool


     */
    protected function compileImport($rawPath, OutputBlock $out, $once = false)
    {
        if ($rawPath[0] === Type::T_STRING) {
            $path = $this->compileStringContent($rawPath);


<             if ($path = $this->findImport($path)) {
<                 if (! $once || ! in_array($path, $this->importedFiles)) {
<                     $this->importFile($path, $out);
<                     $this->importedFiles[] = $path;



>             if (strpos($path, 'url(') !== 0 && $filePath = $this->findImport($path, $this->currentDirectory)) {
>                 $this->registerImport($this->currentDirectory, $path, $filePath);
> 
>                 if (! $once || ! \in_array($filePath, $this->importedFiles)) {
>                     $this->importFile($filePath, $out);
>                     $this->importedFiles[] = $filePath;


                }

                return true;
            }


<             $this->appendRootDirective('@import ' . $this->compileValue($rawPath). ';', $out);



>             $this->appendRootDirective('@import ' . $this->compileImportPath($rawPath) . ';', $out);



            return false;
        }

        if ($rawPath[0] === Type::T_LIST) {
            // handle a list of strings

<             if (count($rawPath[2]) === 0) {



>             if (\count($rawPath[2]) === 0) {


                return false;
            }

            foreach ($rawPath[2] as $path) {
                if ($path[0] !== Type::T_STRING) {

<                     $this->appendRootDirective('@import ' . $this->compileValue($rawPath) . ';', $out);



>                     $this->appendRootDirective('@import ' . $this->compileImportPath($rawPath) . ';', $out);



                    return false;
                }
            }

            foreach ($rawPath[2] as $path) {
                $this->compileImport($path, $out, $once);
            }

            return true;
        }


<         $this->appendRootDirective('@import ' . $this->compileValue($rawPath) . ';', $out);



>         $this->appendRootDirective('@import ' . $this->compileImportPath($rawPath) . ';', $out);



        return false;
    }


>     /**

>      * @param array $rawPath
    /**
>      * @return string
     * Append a root directive like @import or @charset as near as the possible from the source code
>      * @throws CompilerException
     * (keeping before comments, @import and @charset coming before in the source code)
>      */
     *
>     protected function compileImportPath($rawPath)
     * @param string                                        $line
>     {
     * @param @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out
>         $path = $this->compileValue($rawPath);
     * @param array                                         $allowed
> 
     */
>         // case url() without quotes : suppress \r \n remaining in the path
    protected function appendRootDirective($line, $out, $allowed = [Type::T_COMMENT])
>         // if this is a real string there can not be CR or LF char
    {
>         if (strpos($path, 'url(') === 0) {
        $root = $out;
>             $path = str_replace(array("\r", "\n"), array('', ' '), $path);

>         } else {
        while ($root->parent) {
>             // if this is a file name in a string, spaces should be escaped
            $root = $root->parent;
>             $path = $this->reduce($rawPath);
        }
>             $path = $this->escapeImportPathString($path);

>             $path = $this->compileValue($path);
        $i = 0;
>         }

> 
        while ($i < count($root->children)) {
>         return $path;
            if (! isset($root->children[$i]->type) || ! in_array($root->children[$i]->type, $allowed)) {
>     }
                break;
> 
            }
>     /**

>      * @param array $path
            $i++;
>      * @return array
        }
>      * @throws CompilerException

>      */
        // remove incompatible children from the bottom of the list
>     protected function escapeImportPathString($path)
        $saveChildren = [];
>     {

>         switch ($path[0]) {
        while ($i < count($root->children)) {
>             case Type::T_LIST:
            $saveChildren[] = array_pop($root->children);
>                 foreach ($path[2] as $k => $v) {
        }
>                     $path[2][$k] = $this->escapeImportPathString($v);

>                 }
        // insert the directive as a comment
>                 break;
        $child = $this->makeOutputBlock(Type::T_COMMENT);
>             case Type::T_STRING:
        $child->lines[]      = $line;
>                 if ($path[1]) {
        $child->sourceName   = $this->sourceNames[$this->sourceIndex];
>                     $path = $this->compileValue($path);
        $child->sourceLine   = $this->sourceLine;
>                     $path = str_replace(' ', '\\ ', $path);
        $child->sourceColumn = $this->sourceColumn;
>                     $path = [Type::T_KEYWORD, $path];

>                 }
        $root->children[] = $child;
>                 break;

>         }
        // repush children
> 
        while (count($saveChildren)) {
>         return $path;
            $root->children[] = array_pop($saveChildren);
>     }



<      * @param @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out



>      * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out


    }

>      *

>      * @return void



<         while ($i < count($root->children)) {
<             if (! isset($root->children[$i]->type) || ! in_array($root->children[$i]->type, $allowed)) {



>         while ($i < \count($root->children)) {
>             if (! isset($root->children[$i]->type) || ! \in_array($root->children[$i]->type, $allowed)) {



<         while ($i < count($root->children)) {



>         while ($i < \count($root->children)) {



<         $child->sourceName   = $this->sourceNames[$this->sourceIndex];



>         $child->sourceName   = $this->sourceNames[$this->sourceIndex] ?: '(stdin)';



<         while (count($saveChildren)) {



>         while (\count($saveChildren)) {


     * @param string                                 $type

<      * @param string|mixed                           $line



>      * @param string                                 $line
>      *
>      * @return void


     */
    protected function appendOutputLine(OutputBlock $out, $type, $line)
    {
        $outWrite = &$out;


<         if ($type === Type::T_COMMENT) {
<             $parent = $out->parent;
< 
<             if (end($parent->children) !== $out) {
<                 $outWrite = &$parent->children[count($parent->children) - 1];
<             }
<         }
< 


        // check if it's a flat output or not

<         if (count($out->children)) {
<             $lastChild = &$out->children[count($out->children) - 1];



>         if (\count($out->children)) {
>             $lastChild = &$out->children[\count($out->children) - 1];




<             if ($lastChild->depth === $out->depth && is_null($lastChild->selectors) && ! count($lastChild->children)) {



>             if (
>                 $lastChild->depth === $out->depth &&
>                 \is_null($lastChild->selectors) &&
>                 ! \count($lastChild->children)
>             ) {


                $outWrite = $lastChild;
            } else {
                $nextLines = $this->makeOutputBlock($type);
                $nextLines->parent = $out;
                $nextLines->depth  = $out->depth;

                $out->children[] = $nextLines;
                $outWrite = &$nextLines;
            }
        }

        $outWrite->lines[] = $line;
    }

    /**
     * Compile child; returns a value to halt execution
     *
     * @param array                                  $child
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out
     *

<      * @return array



>      * @return array|Number|null


     */
    protected function compileChild($child, OutputBlock $out)
    {
        if (isset($child[Parser::SOURCE_LINE])) {
            $this->sourceIndex  = isset($child[Parser::SOURCE_INDEX]) ? $child[Parser::SOURCE_INDEX] : null;
            $this->sourceLine   = isset($child[Parser::SOURCE_LINE]) ? $child[Parser::SOURCE_LINE] : -1;
            $this->sourceColumn = isset($child[Parser::SOURCE_COLUMN]) ? $child[Parser::SOURCE_COLUMN] : -1;

<         } elseif (is_array($child) && isset($child[1]->sourceLine)) {



>         } elseif (\is_array($child) && isset($child[1]->sourceLine) && $child[1] instanceof Block) {


            $this->sourceIndex  = $child[1]->sourceIndex;
            $this->sourceLine   = $child[1]->sourceLine;
            $this->sourceColumn = $child[1]->sourceColumn;
        } elseif (! empty($out->sourceLine) && ! empty($out->sourceName)) {
            $this->sourceLine   = $out->sourceLine;

<             $this->sourceIndex  = array_search($out->sourceName, $this->sourceNames);



>             $sourceIndex  = array_search($out->sourceName, $this->sourceNames);


            $this->sourceColumn = $out->sourceColumn;


<             if ($this->sourceIndex === false) {
<                 $this->sourceIndex = null;



>             if ($sourceIndex === false) {
>                 $sourceIndex = null;


            }

>             $this->sourceIndex = $sourceIndex;


        }

        switch ($child[0]) {
            case Type::T_SCSSPHP_IMPORT_ONCE:
                $rawPath = $this->reduce($child[1]);

                $this->compileImport($rawPath, $out, true);
                break;

            case Type::T_IMPORT:
                $rawPath = $this->reduce($child[1]);

                $this->compileImport($rawPath, $out);
                break;

            case Type::T_DIRECTIVE:
                $this->compileDirective($child[1], $out);
                break;

            case Type::T_AT_ROOT:
                $this->compileAtRoot($child[1]);
                break;

            case Type::T_MEDIA:
                $this->compileMedia($child[1]);
                break;

            case Type::T_BLOCK:
                $this->compileBlock($child[1]);
                break;

            case Type::T_CHARSET:

<                 if (! $this->charsetSeen) {
<                     $this->charsetSeen = true;
<                     $this->appendRootDirective('@charset ' . $this->compileValue($child[1]) . ';', $out);



>                 break;
> 
>             case Type::T_CUSTOM_PROPERTY:
>                 list(, $name, $value) = $child;
>                 $compiledName = $this->compileValue($name);
> 
>                 // if the value reduces to null from something else then
>                 // the property should be discarded
>                 if ($value[0] !== Type::T_NULL) {
>                     $value = $this->reduce($value);
> 
>                     if ($value[0] === Type::T_NULL || $value === static::$nullString) {
>                         break;


                }

>                 }
                break;
> 

>                 $compiledValue = $this->compileValue($value);
            case Type::T_ASSIGN:
> 
                list(, $name, $value) = $child;
>                 $line = $this->formatter->customProperty(

>                     $compiledName,
                if ($name[0] === Type::T_VARIABLE) {
>                     $compiledValue
                    $flags     = isset($child[3]) ? $child[3] : [];
>                 );
                    $isDefault = in_array('!default', $flags);
> 
                    $isGlobal  = in_array('!global', $flags);
>                 $this->appendOutputLine($out, Type::T_ASSIGN, $line);



<                     $isDefault = in_array('!default', $flags);
<                     $isGlobal  = in_array('!global', $flags);



>                     $isDefault = \in_array('!default', $flags);
>                     $isGlobal  = \in_array('!global', $flags);


                        $this->set($name[1], $this->reduce($value), false, $this->rootEnv, $value);
                        break;
                    }

                    $shouldSet = $isDefault &&

<                         (is_null($result = $this->get($name[1], false)) ||



>                         (\is_null($result = $this->get($name[1], false)) ||


                        $result === static::$null);

                    if (! $isDefault || $shouldSet) {
                        $this->set($name[1], $this->reduce($value), true, null, $value);
                    }
                    break;
                }

                $compiledName = $this->compileValue($name);

                // handle shorthand syntaxes : size / line-height...

<                 if (in_array($compiledName, ['font', 'grid-row', 'grid-column', 'border-radius'])) {



>                 if (\in_array($compiledName, ['font', 'grid-row', 'grid-column', 'border-radius'])) {


                    if ($value[0] === Type::T_VARIABLE) {
                        // if the font value comes from variable, the content is already reduced
                        // (i.e., formulas were already calculated), so we need the original unreduced value
                        $value = $this->get($value[1], true, null, true);
                    }

                    $shorthandValue=&$value;

                    $shorthandDividerNeedsUnit = false;
                    $maxListElements           = null;
                    $maxShorthandDividers      = 1;

                    switch ($compiledName) {
                        case 'border-radius':
                            $maxListElements = 4;
                            $shorthandDividerNeedsUnit = true;
                            break;
                    }


<                     if ($compiledName === 'font' and $value[0] === Type::T_LIST && $value[1]==',') {



>                     if ($compiledName === 'font' && $value[0] === Type::T_LIST && $value[1] === ',') {


                        // this is the case if more than one font is given: example: "font: 400 1em/1.3 arial,helvetica"
                        // we need to handle the first list element
                        $shorthandValue=&$value[2][0];
                    }

                    if ($shorthandValue[0] === Type::T_EXPRESSION && $shorthandValue[1] === '/') {
                        $revert = true;

                        if ($shorthandDividerNeedsUnit) {
                            $divider = $shorthandValue[3];


<                             if (is_array($divider)) {



>                             if (\is_array($divider)) {


                                $divider = $this->reduce($divider, true);
                            }


<                             if (intval($divider->dimension) and !count($divider->units)) {



>                             if ($divider instanceof Number && \intval($divider->getDimension()) && $divider->unitless()) {


                                $revert = false;
                            }
                        }

                        if ($revert) {
                            $shorthandValue = $this->expToString($shorthandValue);
                        }
                    } elseif ($shorthandValue[0] === Type::T_LIST) {
                        foreach ($shorthandValue[2] as &$item) {
                            if ($item[0] === Type::T_EXPRESSION && $item[1] === '/') {
                                if ($maxShorthandDividers > 0) {
                                    $revert = true;

> 


                                    // if the list of values is too long, this has to be a shorthand,
                                    // otherwise it could be a real division

<                                     if (is_null($maxListElements) or count($shorthandValue[2]) <= $maxListElements) {



>                                     if (\is_null($maxListElements) || \count($shorthandValue[2]) <= $maxListElements) {


                                        if ($shorthandDividerNeedsUnit) {
                                            $divider = $item[3];


<                                             if (is_array($divider)) {



>                                             if (\is_array($divider)) {


                                                $divider = $this->reduce($divider, true);
                                            }


<                                             if (intval($divider->dimension) and !count($divider->units)) {



>                                             if ($divider instanceof Number && \intval($divider->getDimension()) && $divider->unitless()) {


                                                $revert = false;
                                            }
                                        }
                                    }

                                    if ($revert) {
                                        $item = $this->expToString($item);
                                        $maxShorthandDividers--;
                                    }
                                }
                            }
                        }
                    }
                }

                // if the value reduces to null from something else then
                // the property should be discarded
                if ($value[0] !== Type::T_NULL) {
                    $value = $this->reduce($value);

                    if ($value[0] === Type::T_NULL || $value === static::$nullString) {
                        break;
                    }
                }

                $compiledValue = $this->compileValue($value);


>                 // ignore empty value
                $line = $this->formatter->property(
>                 if (\strlen($compiledValue)) {


                    $compiledName,
                    $compiledValue
                );
                $this->appendOutputLine($out, Type::T_ASSIGN, $line);

>                 }


                break;

            case Type::T_COMMENT:
                if ($out->type === Type::T_ROOT) {
                    $this->compileComment($child);
                    break;
                }

                $line = $this->compileCommentValue($child, true);
                $this->appendOutputLine($out, Type::T_COMMENT, $line);
                break;

            case Type::T_MIXIN:
            case Type::T_FUNCTION:
                list(, $block) = $child;

>                 assert($block instanceof CallableBlock);


                // the block need to be able to go up to it's parent env to resolve vars
                $block->parentEnv = $this->getStoreEnv();
                $this->set(static::$namespaces[$block->type] . $block->name, $block, true);
                break;

            case Type::T_EXTEND:
                foreach ($child[1] as $sel) {

>                     $replacedSel = $this->replaceSelfSelector($sel);
                    $results = $this->evalSelectors([$sel]);
> 

>                     if ($replacedSel !== $sel) {
                    foreach ($results as $result) {
>                         throw $this->error('Parent selectors aren\'t allowed here.');
                        // only use the first one
>                     }
                        $result = current($result);
> 


                        $selectors = $out->selectors;

>                         if (\count($result) !== 1) {

>                             throw $this->error('complex selectors may not be extended.');
                        if (! $selectors && isset($child['selfParent'])) {
>                         }
                            $selectors = $this->multiplySelectors($this->env, $child['selfParent']);
> 



<                         $result = current($result);



>                         $result = $result[0];




>                         assert($selectors !== null);
                        $this->pushExtends($result, $selectors, $child);
> 
                    }
>                         if (\count($result) > 1) {
                }
>                             $replacement = implode(', ', $result);
                break;
>                             $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);

>                             $line = $this->sourceLine;
            case Type::T_IF:
> 
                list(, $if) = $child;
>                             $message = <<<EOL

> on line $line of $fname:
                if ($this->isTruthy($this->reduce($if->cond, true))) {
> Compound selectors may no longer be extended.
                    return $this->compileChildren($if->children, $out);
> Consider `@extend $replacement` instead.
                }
> See http://bit.ly/ExtendCompound for details.

> EOL;
                foreach ($if->cases as $case) {
> 
                    if ($case->type === Type::T_ELSE ||
>                             $this->logger->warn($message);
                        $case->type === Type::T_ELSEIF && $this->isTruthy($this->reduce($case->cond))
>                         }


                    ) {

>                 assert($if instanceof IfBlock);



<                     if ($case->type === Type::T_ELSE ||
<                         $case->type === Type::T_ELSEIF && $this->isTruthy($this->reduce($case->cond))



>                     if (
>                         $case instanceof ElseBlock ||
>                         $case instanceof ElseifBlock && $this->isTruthy($this->reduce($case->cond))


                }
                break;

            case Type::T_EACH:
                list(, $each) = $child;

>                 assert($each instanceof EachBlock);




<                 $list = $this->coerceList($this->reduce($each->list));



>                 $list = $this->coerceList($this->reduce($each->list), ',', true);



                $this->pushEnv();

                foreach ($list[2] as $item) {

<                     if (count($each->vars) === 1) {



>                     if (\count($each->vars) === 1) {


                        $this->set($each->vars[0], $item, true);
                    } else {
                        list(,, $values) = $this->coerceList($item);

                        foreach ($each->vars as $i => $var) {
                            $this->set($var, isset($values[$i]) ? $values[$i] : static::$null, true);
                        }
                    }

                    $ret = $this->compileChildren($each->children, $out);

                    if ($ret) {

<                         if ($ret[0] !== Type::T_CONTROL) {



>                         $store = $this->env->store;


                            $this->popEnv();

>                         $this->backPropagateEnv($store, $each->vars);



                            return $ret;
                        }

< 
<                         if ($ret[1]) {
<                             break;
<                         }


                    }

<                 }
< 



>                 $store = $this->env->store;


                $this->popEnv();

>                 $this->backPropagateEnv($store, $each->vars);
                break;
> 



            case Type::T_WHILE:
                list(, $while) = $child;

>                 assert($while instanceof WhileBlock);



                while ($this->isTruthy($this->reduce($while->cond, true))) {
                    $ret = $this->compileChildren($while->children, $out);

                    if ($ret) {

<                         if ($ret[0] !== Type::T_CONTROL) {


                            return $ret;
                        }

< 
<                         if ($ret[1]) {
<                             break;
<                         }
<                     }


                }
                break;

            case Type::T_FOR:
                list(, $for) = $child;

>                 assert($for instanceof ForBlock);




<                 $start = $this->reduce($for->start, true);
<                 $end   = $this->reduce($for->end, true);



>                 $startNumber = $this->assertNumber($this->reduce($for->start, true));
>                 $endNumber = $this->assertNumber($this->reduce($for->end, true));




<                 if (! ($start[2] == $end[2] || $end->unitless())) {
<                     $this->throwError('Incompatible units: "%s" and "%s".', $start->unitStr(), $end->unitStr());



>                 $start = $this->assertInteger($startNumber);




<                     break;
<                 }



>                 $numeratorUnits = $startNumber->getNumeratorUnits();
>                 $denominatorUnits = $startNumber->getDenominatorUnits();




<                 $unit  = $start[2];
<                 $start = $start[1];
<                 $end   = $end[1];



>                 $end = $this->assertInteger($endNumber->coerce($numeratorUnits, $denominatorUnits));



                $d = $start < $end ? 1 : -1;


>                 $this->pushEnv();
                for (;;) {
> 



<                     if ((! $for->until && $start - $d == $end) ||



>                     if (
>                         (! $for->until && $start - $d == $end) ||


                        ($for->until && $start == $end)
                    ) {
                        break;
                    }


<                     $this->set($for->var, new Node\Number($start, $unit));



>                     $this->set($for->var, new Number($start, $numeratorUnits, $denominatorUnits));


                    $start += $d;

                    $ret = $this->compileChildren($for->children, $out);

                    if ($ret) {

<                         if ($ret[0] !== Type::T_CONTROL) {
<                             return $ret;
<                         }



>                         $store = $this->env->store;
>                         $this->popEnv();
>                         $this->backPropagateEnv($store, [$for->var]);




<                         if ($ret[1]) {
<                             break;
<                         }



>                         return $ret;


                    }
                }

<                 break;




<             case Type::T_BREAK:
<                 return [Type::T_CONTROL, true];



>                 $store = $this->env->store;
>                 $this->popEnv();
>                 $this->backPropagateEnv($store, [$for->var]);




<             case Type::T_CONTINUE:
<                 return [Type::T_CONTROL, false];



>                 break;



            case Type::T_RETURN:
                return $this->reduce($child[1], true);

            case Type::T_NESTED_PROPERTY:
                $this->compileNestedPropertiesBlock($child[1], $out);
                break;

            case Type::T_INCLUDE:
                // including a mixin
                list(, $name, $argValues, $content, $argUsing) = $child;

                $mixin = $this->get(static::$namespaces['mixin'] . $name, false);

                if (! $mixin) {

<                     $this->throwError("Undefined mixin $name");
<                     break;



>                     throw $this->error("Undefined mixin $name");


                }


>                 assert($mixin instanceof CallableBlock);
                $callingScope = $this->getStoreEnv();
> 



                // push scope, apply args
                $this->pushEnv();
                $this->env->depth--;


<                 $storeEnv = $this->storeEnv;
<                 $this->storeEnv = $this->env;
< 


                // Find the parent selectors in the env to be able to know what '&' refers to in the mixin
                // and assign this fake parent to childs
                $selfParent = null;


<                 if (isset($child['selfParent']) && isset($child['selfParent']->selectors)) {



>                 if (isset($child['selfParent']) && $child['selfParent'] instanceof Block && isset($child['selfParent']->selectors)) {


                    $selfParent = $child['selfParent'];
                } else {
                    $parentSelectors = $this->multiplySelectors($this->env);

                    if ($parentSelectors) {
                        $parent = new Block();
                        $parent->selectors = $parentSelectors;

                        foreach ($mixin->children as $k => $child) {

<                             if (isset($child[1]) && is_object($child[1]) && $child[1] instanceof Block) {



>                             if (isset($child[1]) && $child[1] instanceof Block) {


                                $mixin->children[$k][1]->parent = $parent;
                            }
                        }
                    }
                }

                // clone the stored content to not have its scope spoiled by a further call to the same mixin
                // i.e., recursive @include of the same mixin
                if (isset($content)) {
                    $copyContent = clone $content;
                    $copyContent->scope = clone $callingScope;

                    $this->setRaw(static::$namespaces['special'] . 'content', $copyContent, $this->env);
                } else {
                    $this->setRaw(static::$namespaces['special'] . 'content', null, $this->env);
                }

                // save the "using" argument list for applying it to when "@content" is invoked
                if (isset($argUsing)) {
                    $this->setRaw(static::$namespaces['special'] . 'using', $argUsing, $this->env);
                } else {
                    $this->setRaw(static::$namespaces['special'] . 'using', null, $this->env);
                }

                if (isset($mixin->args)) {
                    $this->applyArguments($mixin->args, $argValues);
                }

                $this->env->marker = 'mixin';

                if (! empty($mixin->parentEnv)) {
                    $this->env->declarationScopeParent = $mixin->parentEnv;
                } else {

<                     $this->throwError("@mixin $name() without parentEnv");



>                     throw $this->error("@mixin $name() without parentEnv");


                }


<                 $this->compileChildrenNoReturn($mixin->children, $out, $selfParent, $this->env->marker . " " . $name);
< 
<                 $this->storeEnv = $storeEnv;



>                 $this->compileChildrenNoReturn($mixin->children, $out, $selfParent, $this->env->marker . ' ' . $name);



                $this->popEnv();
                break;

            case Type::T_MIXIN_CONTENT:
                $env        = isset($this->storeEnv) ? $this->storeEnv : $this->env;
                $content    = $this->get(static::$namespaces['special'] . 'content', false, $env);
                $argUsing   = $this->get(static::$namespaces['special'] . 'using', false, $env);
                $argContent = $child[1];

                if (! $content) {

<                     $content = new \stdClass();
<                     $content->scope    = new \stdClass();
<                     $content->children = $env->parent->block->children;


                    break;
                }

                $storeEnv = $this->storeEnv;
                $varsUsing = [];

                if (isset($argUsing) && isset($argContent)) {
                    // Get the arguments provided for the content with the names provided in the "using" argument list

<                     $this->storeEnv = $this->env;



>                     $this->storeEnv = null;


                    $varsUsing = $this->applyArguments($argUsing, $argContent, false);
                }

                // restore the scope from the @content
                $this->storeEnv = $content->scope;

                // append the vars from using if any
                foreach ($varsUsing as $name => $val) {
                    $this->set($name, $val, true, $this->storeEnv);
                }

                $this->compileChildrenNoReturn($content->children, $out);

                $this->storeEnv = $storeEnv;
                break;

            case Type::T_DEBUG:
                list(, $value) = $child;


<                 $fname = $this->sourceNames[$this->sourceIndex];



>                 $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);


                $line  = $this->sourceLine;

<                 $value = $this->compileValue($this->reduce($value, true));



>                 $value = $this->compileDebugValue($value);




<                 fwrite($this->stderr, "File $fname on line $line DEBUG: $value\n");



>                 $this->logger->debug("$fname:$line DEBUG: $value");


                break;

            case Type::T_WARN:
                list(, $value) = $child;


<                 $fname = $this->sourceNames[$this->sourceIndex];



>                 $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);


                $line  = $this->sourceLine;

<                 $value = $this->compileValue($this->reduce($value, true));



>                 $value = $this->compileDebugValue($value);




<                 fwrite($this->stderr, "File $fname on line $line WARN: $value\n");



>                 $this->logger->warn("$value\n         on line $line of $fname");


                break;

            case Type::T_ERROR:
                list(, $value) = $child;


<                 $fname = $this->sourceNames[$this->sourceIndex];



>                 $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);


                $line  = $this->sourceLine;
                $value = $this->compileValue($this->reduce($value, true));


<                 $this->throwError("File $fname on line $line ERROR: $value\n");
<                 break;
< 
<             case Type::T_CONTROL:
<                 $this->throwError('@break/@continue not permitted in this scope');
<                 break;



>                 throw $this->error("File $fname on line $line ERROR: $value\n");



            default:

<                 $this->throwError("unknown child type: $child[0]");



>                 throw $this->error("unknown child type: $child[0]");


        }

> 
    }
>         return null;



    /**
     * Reduce expression to string
     *
     * @param array $exp

>      * @param bool $keepParens


     *
     * @return array
     */

<     protected function expToString($exp)



>     protected function expToString($exp, $keepParens = false)


    {

<         list(, $op, $left, $right, /* $inParens */, $whiteLeft, $whiteRight) = $exp;



>         list(, $op, $left, $right, $inParens, $whiteLeft, $whiteRight) = $exp;




<         $content = [$this->reduce($left)];



>         $content = [];
> 
>         if ($keepParens && $inParens) {
>             $content[] = '(';
>         }
> 
>         $content[] = $this->reduce($left);



        if ($whiteLeft) {
            $content[] = ' ';
        }

        $content[] = $op;

        if ($whiteRight) {
            $content[] = ' ';
        }

        $content[] = $this->reduce($right);


>         if ($keepParens && $inParens) {
        return [Type::T_STRING, '', $content];
>             $content[] = ')';
    }
>         }

> 


    /**
     * Is truthy?
     *

<      * @param array $value



>      * @param array|Number $value


     *

<      * @return boolean



>      * @return bool


     */

<     protected function isTruthy($value)



>     public function isTruthy($value)


    {
        return $value !== static::$false && $value !== static::$null;
    }

    /**
     * Is the value a direct relationship combinator?
     *
     * @param string $value
     *

<      * @return boolean



>      * @return bool


     */
    protected function isImmediateRelationshipCombinator($value)
    {
        return $value === '>' || $value === '+' || $value === '~';
    }

    /**
     * Should $value cause its operand to eval
     *
     * @param array $value
     *

<      * @return boolean



>      * @return bool


     */
    protected function shouldEval($value)
    {
        switch ($value[0]) {
            case Type::T_EXPRESSION:
                if ($value[1] === '/') {
                    return $this->shouldEval($value[2]) || $this->shouldEval($value[3]);
                }

                // fall-thru
            case Type::T_VARIABLE:
            case Type::T_FUNCTION_CALL:
                return true;
        }

        return false;
    }

    /**
     * Reduce value
     *

<      * @param array   $value
<      * @param boolean $inExp



>      * @param array|Number $value
>      * @param bool         $inExp


     *

<      * @return null|string|array|\ScssPhp\ScssPhp\Node\Number



>      * @return array|Number


     */
    protected function reduce($value, $inExp = false)
    {

<         if (is_null($value)) {
<             return null;



>         if ($value instanceof Number) {
>             return $value;


        }

        switch ($value[0]) {
            case Type::T_EXPRESSION:
                list(, $op, $left, $right, $inParens) = $value;

                $opName = isset(static::$operatorNames[$op]) ? static::$operatorNames[$op] : $op;
                $inExp = $inExp || $this->shouldEval($left) || $this->shouldEval($right);

                $left = $this->reduce($left, true);

                if ($op !== 'and' && $op !== 'or') {
                    $right = $this->reduce($right, true);
                }

                // special case: looks like css shorthand

<                 if ($opName == 'div' && ! $inParens && ! $inExp && isset($right[2]) &&
<                     (($right[0] !== Type::T_NUMBER && $right[2] != '') ||



>                 if (
>                     $opName == 'div' && ! $inParens && ! $inExp &&
>                     (($right[0] !== Type::T_NUMBER && isset($right[2]) && $right[2] != '') ||


                    ($right[0] === Type::T_NUMBER && ! $right->unitless()))
                ) {
                    return $this->expToString($value);
                }

                $left  = $this->coerceForExpression($left);
                $right = $this->coerceForExpression($right);
                $ltype = $left[0];
                $rtype = $right[0];

                $ucOpName = ucfirst($opName);
                $ucLType  = ucfirst($ltype);
                $ucRType  = ucfirst($rtype);


>                 $shouldEval = $inParens || $inExp;
                // this tries:
> 


                // 1. op[op name][left type][right type]

<                 // 2. op[left type][right type] (passing the op as first arg



>                 // 2. op[left type][right type] (passing the op as first arg)


                // 3. op[op name]

<                 $fn = "op${ucOpName}${ucLType}${ucRType}";
< 
<                 if (is_callable([$this, $fn]) ||
<                     (($fn = "op${ucLType}${ucRType}") &&
<                         is_callable([$this, $fn]) &&
<                         $passOp = true) ||
<                     (($fn = "op${ucOpName}") &&
<                         is_callable([$this, $fn]) &&
<                         $genOp = true)
<                 ) {
<                     $coerceUnit = false;
< 
<                     if (! isset($genOp) &&
<                         $left[0] === Type::T_NUMBER && $right[0] === Type::T_NUMBER
<                     ) {
<                         $coerceUnit = true;
< 
<                         switch ($opName) {
<                             case 'mul':
<                                 $targetUnit = $left[2];
< 
<                                 foreach ($right[2] as $unit => $exp) {
<                                     $targetUnit[$unit] = (isset($targetUnit[$unit]) ? $targetUnit[$unit] : 0) + $exp;
<                                 }
<                                 break;
< 
<                             case 'div':
<                                 $targetUnit = $left[2];
< 
<                                 foreach ($right[2] as $unit => $exp) {
<                                     $targetUnit[$unit] = (isset($targetUnit[$unit]) ? $targetUnit[$unit] : 0) - $exp;
<                                 }
<                                 break;
< 
<                             case 'mod':
<                                 $targetUnit = $left[2];
<                                 break;
< 
<                             default:
<                                 $targetUnit = $left->unitless() ? $right[2] : $left[2];
<                         }
< 
<                         if (! $left->unitless() && ! $right->unitless()) {
<                             $left = $left->normalize();
<                             $right = $right->normalize();
<                         }
<                     }
< 
<                     $shouldEval = $inParens || $inExp;
< 
<                     if (isset($passOp)) {



>                 if (\is_callable([$this, $fn = "op{$ucOpName}{$ucLType}{$ucRType}"])) {
>                     $out = $this->$fn($left, $right, $shouldEval);
>                 } elseif (\is_callable([$this, $fn = "op{$ucLType}{$ucRType}"])) {


                        $out = $this->$fn($op, $left, $right, $shouldEval);

<                     } else {



>                 } elseif (\is_callable([$this, $fn = "op{$ucOpName}"])) {


                        $out = $this->$fn($left, $right, $shouldEval);

>                 } else {
                    }
>                     $out = null;



                    if (isset($out)) {

<                         if ($coerceUnit && $out[0] === Type::T_NUMBER) {
<                             $out = $out->coerce($targetUnit);
<                         }
< 


                        return $out;
                    }

<                 }



                return $this->expToString($value);

            case Type::T_UNARY:
                list(, $op, $exp, $inParens) = $value;

                $inExp = $inExp || $this->shouldEval($exp);
                $exp = $this->reduce($exp);


<                 if ($exp[0] === Type::T_NUMBER) {



>                 if ($exp instanceof Number) {


                    switch ($op) {
                        case '+':

<                             return new Node\Number($exp[1], $exp[2]);



>                             return $exp;



                        case '-':

<                             return new Node\Number(-$exp[1], $exp[2]);



>                             return $exp->unaryMinus();


                    }
                }

                if ($op === 'not') {
                    if ($inExp || $inParens) {
                        if ($exp === static::$false || $exp === static::$null) {
                            return static::$true;
                        }

                        return static::$false;
                    }

                    $op = $op . ' ';
                }

                return [Type::T_STRING, '', [$op, $exp]];

            case Type::T_VARIABLE:
                return $this->reduce($this->get($value[1]));

            case Type::T_LIST:
                foreach ($value[2] as &$item) {
                    $item = $this->reduce($item);
                }

>                 unset($item);

> 
                return $value;
>                 if (isset($value[3]) && \is_array($value[3])) {

>                     foreach ($value[3] as &$item) {
            case Type::T_MAP:
>                         $item = $this->reduce($item);
                foreach ($value[1] as &$item) {
>                     }
                    $item = $this->reduce($item);
>                     unset($item);
                }
>                 }



                foreach ($value[2] as &$item) {
                    $item = $this->reduce($item);
                }

                return $value;

            case Type::T_STRING:
                foreach ($value[2] as &$item) {

<                     if (is_array($item) || $item instanceof \ArrayAccess) {



>                     if (\is_array($item) || $item instanceof Number) {


                        $item = $this->reduce($item);
                    }
                }

                return $value;

            case Type::T_INTERPOLATE:
                $value[1] = $this->reduce($value[1]);

                if ($inExp) {

<                     return $value[1];



>                     return [Type::T_KEYWORD, $this->compileValue($value, false)];


                }

                return $value;

            case Type::T_FUNCTION_CALL:
                return $this->fncall($value[1], $value[2]);

            case Type::T_SELF:

<                 $selfSelector = $this->multiplySelectors($this->env);
<                 $selfSelector = $this->collapseSelectors($selfSelector, true);



>                 $selfParent = ! empty($this->env->block->selfParent) ? $this->env->block->selfParent : null;
>                 $selfSelector = $this->multiplySelectors($this->env, $selfParent);
>                 $selfSelector = $this->collapseSelectorsAsList($selfSelector);



                return $selfSelector;

            default:
                return $value;
        }
    }

    /**
     * Function caller
     *

<      * @param string $name



>      * @param string|array $functionReference


     * @param array  $argValues
     *

<      * @return array|null



>      * @return array|Number


     */

<     protected function fncall($name, $argValues)



>     protected function fncall($functionReference, $argValues)


    {

>         // a string means this is a static hard reference coming from the parsing
        // SCSS @function
>         if (is_string($functionReference)) {
        if ($this->callScssFunction($name, $argValues, $returnValue)) {
>             $name = $functionReference;
            return $returnValue;
> 
        }
>             $functionReference = $this->getFunctionReference($name);

>             if ($functionReference === static::$null || $functionReference[0] !== Type::T_FUNCTION_REFERENCE) {
        // native PHP functions
>                 $functionReference = [Type::T_FUNCTION, $name, [Type::T_LIST, ',', []]];
        if ($this->callNativeFunction($name, $argValues, $returnValue)) {
>             }
            return $returnValue;
>         }
        }
> 

>         // a function type means we just want a plain css function call
        // for CSS functions, simply flatten the arguments into a list
>         if ($functionReference[0] === Type::T_FUNCTION) {
        $listArgs = [];
>             // for CSS functions, simply flatten the arguments into a list

>             $listArgs = [];
        foreach ((array) $argValues as $arg) {
> 
            if (empty($arg[0])) {
>             foreach ((array) $argValues as $arg) {
                $listArgs[] = $this->reduce($arg[1]);
>                 if (empty($arg[0]) || count($argValues) === 1) {
            }
>                     $listArgs[] = $this->reduce($this->stringifyFncallArgs($arg[1]));
        }
>                 }

>             }
        return [Type::T_FUNCTION, $name, [Type::T_LIST, ',', $listArgs]];
> 
    }
>             return [Type::T_FUNCTION, $functionReference[1], [Type::T_LIST, ',', $listArgs]];

>         }
    /**
> 
     * Normalize name
>         if ($functionReference === static::$null || $functionReference[0] !== Type::T_FUNCTION_REFERENCE) {
     *
>             return static::$defaultValue;
     * @param string $name
>         }
     *
> 
     * @return string
> 
     */
>         switch ($functionReference[1]) {



<         if ($this->callScssFunction($name, $argValues, $returnValue)) {



>             case 'scss':
>                 return $this->callScssFunction($functionReference[3], $argValues);
> 
>             // native PHP functions
>             case 'user':
>             case 'native':
>                 list(,,$name, $fn, $prototype) = $functionReference;
> 
>                 // special cases of css valid functions min/max
>                 $name = strtolower($name);
>                 if (\in_array($name, ['min', 'max']) && count($argValues) >= 1) {
>                     $cssFunction = $this->cssValidArg(
>                         [Type::T_FUNCTION_CALL, $name, $argValues],
>                         ['min', 'max', 'calc', 'env', 'var']
>                     );
>                     if ($cssFunction !== false) {
>                         return $cssFunction;
>                     }
>                 }
>                 $returnValue = $this->callNativeFunction($name, $fn, $prototype, $argValues);
> 
>                 if (! isset($returnValue)) {
>                     return $this->fncall([Type::T_FUNCTION, $name, [Type::T_LIST, ',', []]], $argValues);
>                 }
> 


    {

> 
        return str_replace('-', '_', $name);
>             default:
    }
>                 return static::$defaultValue;

>         }
    /**
>     }
     * Normalize value
> 
     *
>     /**
     * @param array $value
>      * @param array|Number $arg
     *
>      * @param string[]     $allowed_function
     * @return array
>      * @param bool         $inFunction
     */
>      *
    public function normalizeValue($value)
>      * @return array|Number|false
    {
>      */
        $value = $this->coerceForExpression($this->reduce($value));
>     protected function cssValidArg($arg, $allowed_function = [], $inFunction = false)

>     {
        switch ($value[0]) {
>         if ($arg instanceof Number) {
            case Type::T_LIST:
>             return $this->stringifyFncallArgs($arg);
                $value = $this->extractInterpolation($value);
>         }

> 
                if ($value[0] !== Type::T_LIST) {
>         switch ($arg[0]) {
                    return [Type::T_KEYWORD, $this->compileValue($value)];
>             case Type::T_INTERPOLATE:
                }
>                 return [Type::T_KEYWORD, $this->CompileValue($arg)];

> 
                foreach ($value[2] as $key => $item) {
>             case Type::T_FUNCTION:
                    $value[2][$key] = $this->normalizeValue($item);
>                 if (! \in_array($arg[1], $allowed_function)) {
                }
>                     return false;

>                 }
                if (! empty($value['enclosing'])) {
>                 if ($arg[2][0] === Type::T_LIST) {
                    unset($value['enclosing']);
>                     foreach ($arg[2][2] as $k => $subarg) {
                }
>                         $arg[2][2][$k] = $this->cssValidArg($subarg, $allowed_function, $arg[1]);

>                         if ($arg[2][2][$k] === false) {
                return $value;
>                             return false;

>                         }
            case Type::T_STRING:
>                     }
                return [$value[0], '"', [$this->compileStringContent($value)]];
>                 }

>                 return $arg;
            case Type::T_NUMBER:
> 
                return $value->normalize();
>             case Type::T_FUNCTION_CALL:

>                 if (! \in_array($arg[1], $allowed_function)) {
            case Type::T_INTERPOLATE:
>                     return false;
                return [Type::T_KEYWORD, $this->compileValue($value)];
>                 }

>                 $cssArgs = [];
            default:
>                 foreach ($arg[2] as $argValue) {
                return $value;
>                     if ($argValue === static::$null) {
        }
>                         return false;
    }
>                     }

>                     $cssArg = $this->cssValidArg($argValue[1], $allowed_function, $arg[1]);
    /**
>                     if (empty($argValue[0]) && $cssArg !== false) {
     * Add numbers
>                         $cssArgs[] = [$argValue[0], $cssArg];
     *
>                     } else {
     * @param array $left
>                         return false;
     * @param array $right
>                     }
     *
>                 }
     * @return \ScssPhp\ScssPhp\Node\Number
> 
     */
>                 return $this->fncall([Type::T_FUNCTION, $arg[1], [Type::T_LIST, ',', []]], $cssArgs);
    protected function opAddNumberNumber($left, $right)
> 
    {
>             case Type::T_STRING:
        return new Node\Number($left[1] + $right[1], $left[2]);
>             case Type::T_KEYWORD:
    }
>                 if (!$inFunction or !\in_array($inFunction, ['calc', 'env', 'var'])) {

>                     return false;
    /**
>                 }
     * Multiply numbers
>                 return $this->stringifyFncallArgs($arg);
     *
> 
     * @param array $left
>             case Type::T_LIST:
     * @param array $right
>                 if (!$inFunction) {
     *
>                     return false;
     * @return \ScssPhp\ScssPhp\Node\Number
>                 }
     */
>                 if (empty($arg['enclosing']) and $arg[1] === '') {
    protected function opMulNumberNumber($left, $right)
>                     foreach ($arg[2] as $k => $subarg) {
    {
>                         $arg[2][$k] = $this->cssValidArg($subarg, $allowed_function, $inFunction);
        return new Node\Number($left[1] * $right[1], $left[2]);
>                         if ($arg[2][$k] === false) {
    }
>                             return false;

>                         }
    /**
>                     }
     * Subtract numbers
>                     $arg[0] = Type::T_STRING;
     *
>                     return $arg;
     * @param array $left
>                 }
     * @param array $right
>                 return false;
     *
> 
     * @return \ScssPhp\ScssPhp\Node\Number
>             case Type::T_EXPRESSION:
     */
>                 if (! \in_array($arg[1], ['+', '-', '/', '*'])) {
    protected function opSubNumberNumber($left, $right)
>                     return false;
    {
>                 }
        return new Node\Number($left[1] - $right[1], $left[2]);
>                 $arg[2] = $this->cssValidArg($arg[2], $allowed_function, $inFunction);
    }
>                 $arg[3] = $this->cssValidArg($arg[3], $allowed_function, $inFunction);

>                 if ($arg[2] === false || $arg[3] === false) {
    /**
>                     return false;
     * Divide numbers
>                 }
     *
>                 return $this->expToString($arg, true);
     * @param array $left
> 
     * @param array $right
>             case Type::T_VARIABLE:
     *
>             case Type::T_SELF:
     * @return array|\ScssPhp\ScssPhp\Node\Number
>             default:
     */
>                 return false;
    protected function opDivNumberNumber($left, $right)
>         }
    {
>     }
        if ($right[1] == 0) {
> 
            return [Type::T_STRING, '', [$left[1] . $left[2] . '/' . $right[1] . $right[2]]];
> 
        }
>     /**

>      * Reformat fncall arguments to proper css function output
        return new Node\Number($left[1] / $right[1], $left[2]);
>      *
    }
>      * @param array|Number $arg

>      *
    /**
>      * @return array|Number
     * Mod numbers
>      */
     *
>     protected function stringifyFncallArgs($arg)
     * @param array $left
>     {
     * @param array $right
>         if ($arg instanceof Number) {
     *
>             return $arg;
     * @return \ScssPhp\ScssPhp\Node\Number
>         }
     */
> 
    protected function opModNumberNumber($left, $right)
>         switch ($arg[0]) {
    {
>             case Type::T_LIST:
        return new Node\Number($left[1] % $right[1], $left[2]);
>                 foreach ($arg[2] as $k => $v) {
    }
>                     $arg[2][$k] = $this->stringifyFncallArgs($v);

>                 }
    /**
>                 break;
     * Add strings
> 
     *
>             case Type::T_EXPRESSION:
     * @param array $left
>                 if ($arg[1] === '/') {
     * @param array $right
>                     $arg[2] = $this->stringifyFncallArgs($arg[2]);
     *
>                     $arg[3] = $this->stringifyFncallArgs($arg[3]);
     * @return array|null
>                     $arg[5] = $arg[6] = false; // no space around /
     */
>                     $arg = $this->expToString($arg);
    protected function opAdd($left, $right)
>                 }
    {
>                 break;
        if ($strLeft = $this->coerceString($left)) {
> 
            if ($right[0] === Type::T_STRING) {
>             case Type::T_FUNCTION_CALL:
                $right[1] = '';
>                 $name = strtolower($arg[1]);
            }
> 

>                 if (in_array($name, ['max', 'min', 'calc'])) {
            $strLeft[2][] = $right;
>                     $args = $arg[2];

>                     $arg = $this->fncall([Type::T_FUNCTION, $name, [Type::T_LIST, ',', []]], $args);
            return $strLeft;
>                 }
        }
>                 break;

>         }
        if ($strRight = $this->coerceString($right)) {
> 
            if ($left[0] === Type::T_STRING) {
>         return $arg;
                $left[1] = '';
>     }
            }
> 

>     /**
            array_unshift($strRight[2], $left);
>      * Find a function reference

>      * @param string $name
            return $strRight;
>      * @param bool $safeCopy
        }
>      * @return array

>      */
        return null;
>     protected function getFunctionReference($name, $safeCopy = false)
    }
>     {

>         // SCSS @function
    /**
>         if ($func = $this->get(static::$namespaces['function'] . $name, false)) {
     * Boolean and
>             if ($safeCopy) {
     *
>                 $func = clone $func;
     * @param array   $left
>             }
     * @param array   $right
> 
     * @param boolean $shouldEval
>             return [Type::T_FUNCTION_REFERENCE, 'scss', $name, $func];



<         if ($this->callNativeFunction($name, $argValues, $returnValue)) {
<             return $returnValue;



> 
>         // try to find a native lib function
>         $normalizedName = $this->normalizeName($name);
> 
>         if (isset($this->userFunctions[$normalizedName])) {
>             // see if we can find a user function
>             list($f, $prototype) = $this->userFunctions[$normalizedName];
> 
>             return [Type::T_FUNCTION_REFERENCE, 'user', $name, $f, $prototype];



<         // for CSS functions, simply flatten the arguments into a list
<         $listArgs = [];



>         $lowercasedName = strtolower($normalizedName);



<         foreach ((array) $argValues as $arg) {
<             if (empty($arg[0])) {
<                 $listArgs[] = $this->reduce($arg[1]);



>         // Special functions overriding a CSS function are case-insensitive. We normalize them as lowercase
>         // to avoid the deprecation warning about the wrong case being used.
>         if ($lowercasedName === 'min' || $lowercasedName === 'max' || $lowercasedName === 'rgb' || $lowercasedName === 'rgba' || $lowercasedName === 'hsl' || $lowercasedName === 'hsla') {
>             $normalizedName = $lowercasedName;
>         }
> 
>         if (($f = $this->getBuiltinFunction($normalizedName)) && \is_callable($f)) {
>             /** @var string $libName */
>             $libName   = $f[1];
>             $prototype = isset(static::$$libName) ? static::$$libName : null;
> 
>             // All core functions have a prototype defined. Not finding the
>             // prototype can mean 2 things:
>             // - the function comes from a child class (deprecated just after)
>             // - the function was found with a different case, which relates to calling the
>             //   wrong Sass function due to our camelCase usage (`fade-in()` vs `fadein()`),
>             //   because PHP method names are case-insensitive while property names are
>             //   case-sensitive.
>             if ($prototype === null || strtolower($normalizedName) !== $normalizedName) {
>                 $r = new \ReflectionMethod($this, $libName);
>                 $actualLibName = $r->name;
> 
>                 if ($actualLibName !== $libName || strtolower($normalizedName) !== $normalizedName) {
>                     $kebabCaseName = preg_replace('~(?<=\\w)([A-Z])~', '-$1', substr($actualLibName, 3));
>                     assert($kebabCaseName !== null);
>                     $originalName = strtolower($kebabCaseName);
>                     $warning = "Calling built-in functions with a non-standard name is deprecated since Scssphp 1.8.0 and will not work anymore in 2.0 (they will be treated as CSS function calls instead).\nUse \"$originalName\" instead of \"$name\".";
>                     @trigger_error($warning, E_USER_DEPRECATED);
>                     $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);
>                     $line  = $this->sourceLine;
>                     Warn::deprecation("$warning\n         on line $line of $fname");
> 
>                     // Use the actual function definition
>                     $prototype = isset(static::$$actualLibName) ? static::$$actualLibName : null;
>                     $f[1] = $libName = $actualLibName;
>                 }
>             }
> 
>             if (\get_class($this) !== __CLASS__ && !isset($this->warnedChildFunctions[$libName])) {
>                 $r = new \ReflectionMethod($this, $libName);
>                 $declaringClass = $r->getDeclaringClass()->name;
> 
>                 $needsWarning = $this->warnedChildFunctions[$libName] = $declaringClass !== __CLASS__;
> 
>                 if ($needsWarning) {
>                     if (method_exists(__CLASS__, $libName)) {
>                         @trigger_error(sprintf('Overriding the "%s" core function by extending the Compiler is deprecated and will be unsupported in 2.0. Remove the "%s::%s" method.', $normalizedName, $declaringClass, $libName), E_USER_DEPRECATED);
>                     } else {
>                         @trigger_error(sprintf('Registering custom functions by extending the Compiler and using the lib* discovery mechanism is deprecated and will be removed in 2.0. Replace the "%s::%s" method with registering the "%s" function through "Compiler::registerFunction".', $declaringClass, $libName, $normalizedName), E_USER_DEPRECATED);
>                     }



<         return [Type::T_FUNCTION, $name, [Type::T_LIST, ',', $listArgs]];



>             return [Type::T_FUNCTION_REFERENCE, 'native', $name, $f, $prototype];




>         return static::$null;
        if (! $shouldEval) {
>     }
            if (! $truthy) {
> 
                return null;
> 



<      * @param array $value



>      * @internal



<      * @return array



>      * @param array|Number $value
>      *
>      * @return array|Number




>         if ($value instanceof Number) {
        if ($left !== static::$false && $left !== static::$null) {
>             return $value;
            return $this->reduce($right, true);
>         }
        }
> 




>                 if ($value[1] === '' && count($value[2]) > 1) {
        return $left;
>                     $value[1] = ' ';
    }
>                 }

> 



<             case Type::T_NUMBER:
<                 return $value->normalize();
< 



<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right



<      * @return \ScssPhp\ScssPhp\Node\Number



>      * @return Number



<     protected function opAddNumberNumber($left, $right)



>     protected function opAddNumberNumber(Number $left, Number $right)



<         return new Node\Number($left[1] + $right[1], $left[2]);



>         return $left->plus($right);



<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right



<      * @return \ScssPhp\ScssPhp\Node\Number



>      * @return Number



<     protected function opMulNumberNumber($left, $right)



>     protected function opMulNumberNumber(Number $left, Number $right)



<         return new Node\Number($left[1] * $right[1], $left[2]);



>         return $left->times($right);



<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right



<      * @return \ScssPhp\ScssPhp\Node\Number



>      * @return Number



<     protected function opSubNumberNumber($left, $right)



>     protected function opSubNumberNumber(Number $left, Number $right)



<         return new Node\Number($left[1] - $right[1], $left[2]);



>         return $left->minus($right);



<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right



<      * @return array|\ScssPhp\ScssPhp\Node\Number



>      * @return Number



<     protected function opDivNumberNumber($left, $right)



>     protected function opDivNumberNumber(Number $left, Number $right)



<         if ($right[1] == 0) {
<             return [Type::T_STRING, '', [$left[1] . $left[2] . '/' . $right[1] . $right[2]]];
<         }
< 
<         return new Node\Number($left[1] / $right[1], $left[2]);



>         return $left->dividedBy($right);



<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right



<      * @return \ScssPhp\ScssPhp\Node\Number



>      * @return Number



<     protected function opModNumberNumber($left, $right)



>     protected function opModNumberNumber(Number $left, Number $right)



<         return new Node\Number($left[1] % $right[1], $left[2]);



>         return $left->modulo($right);



<      * @param array   $left
<      * @param array   $right
<      * @param boolean $shouldEval



>      * @param array|Number $left
>      * @param array|Number $right
>      * @param bool         $shouldEval



<      * @return array|null



>      * @return array|Number|null



<      * @param array   $left
<      * @param array   $right
<      * @param boolean $shouldEval



>      * @param array|Number $left
>      * @param array|Number $right
>      * @param bool         $shouldEval



<      * @return array|null



>      * @return array|Number|null




>         if ($op !== '==' && $op !== '!=') {
        foreach ([1, 2, 3] as $i) {
>             $warning = "Color arithmetic is deprecated and will be an error in future versions.\n"
            $lval = isset($left[$i]) ? $left[$i] : 0;
>                 . "Consider using Sass's color functions instead.";
            $rval = isset($right[$i]) ? $right[$i] : 0;
>             $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);

>             $line  = $this->sourceLine;
            switch ($op) {
> 
                case '+':
>             Warn::deprecation("$warning\n         on line $line of $fname");
                    $out[] = $lval + $rval;
>         }
                    break;
> 



                case '-':
                    $out[] = $lval - $rval;
                    break;

                case '*':
                    $out[] = $lval * $rval;
                    break;

                case '%':

>                     if ($rval == 0) {
                    $out[] = $lval % $rval;
>                         throw $this->error("color: Can't take modulo by zero");
                    break;
>                     }

> 


                case '/':
                    if ($rval == 0) {

<                         $this->throwError("color: Can't divide by zero");
<                         break 2;



>                         throw $this->error("color: Can't divide by zero");


                    }

                    $out[] = (int) ($lval / $rval);
                    break;

                case '==':
                    return $this->opEq($left, $right);

                case '!=':
                    return $this->opNeq($left, $right);

                default:

<                     $this->throwError("color: unknown op $op");
<                     break 2;



>                     throw $this->error("color: unknown op $op");


            }
        }

        if (isset($left[4])) {
            $out[4] = $left[4];
        } elseif (isset($right[4])) {
            $out[4] = $right[4];
        }

        return $this->fixColor($out);
    }

    /**
     * Compare color and number
     *
     * @param string $op
     * @param array  $left

<      * @param array  $right



>      * @param Number  $right


     *
     * @return array
     */

<     protected function opColorNumber($op, $left, $right)



>     protected function opColorNumber($op, $left, Number $right)


    {

<         $value = $right[1];



>         if ($op === '==') {
>             return static::$false;
>         }
> 
>         if ($op === '!=') {
>             return static::$true;
>         }
> 
>         $value = $right->getDimension();



        return $this->opColorColor(
            $op,
            $left,
            [Type::T_COLOR, $value, $value, $value]
        );
    }

    /**
     * Compare number and color
     *
     * @param string $op

<      * @param array  $left



>      * @param Number  $left


     * @param array  $right
     *
     * @return array
     */

<     protected function opNumberColor($op, $left, $right)



>     protected function opNumberColor($op, Number $left, $right)


    {

<         $value = $left[1];



>         if ($op === '==') {
>             return static::$false;
>         }
> 
>         if ($op === '!=') {
>             return static::$true;
>         }
> 
>         $value = $left->getDimension();



        return $this->opColorColor(
            $op,
            [Type::T_COLOR, $value, $value, $value],
            $right
        );
    }

    /**
     * Compare number1 == number2
     *

<      * @param array $left
<      * @param array $right



>      * @param array|Number $left
>      * @param array|Number $right


     *
     * @return array
     */
    protected function opEq($left, $right)
    {
        if (($lStr = $this->coerceString($left)) && ($rStr = $this->coerceString($right))) {
            $lStr[1] = '';
            $rStr[1] = '';

            $left = $this->compileValue($lStr);
            $right = $this->compileValue($rStr);
        }

        return $this->toBool($left === $right);
    }

    /**
     * Compare number1 != number2
     *

<      * @param array $left
<      * @param array $right



>      * @param array|Number $left
>      * @param array|Number $right


     *
     * @return array
     */
    protected function opNeq($left, $right)
    {
        if (($lStr = $this->coerceString($left)) && ($rStr = $this->coerceString($right))) {
            $lStr[1] = '';
            $rStr[1] = '';

            $left = $this->compileValue($lStr);
            $right = $this->compileValue($rStr);
        }

        return $this->toBool($left !== $right);
    }

    /**

<      * Compare number1 >= number2



>      * Compare number1 == number2


     *

<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right


     *
     * @return array
     */

<     protected function opGteNumberNumber($left, $right)



>     protected function opEqNumberNumber(Number $left, Number $right)


    {

<         return $this->toBool($left[1] >= $right[1]);



>         return $this->toBool($left->equals($right));


    }

    /**

<      * Compare number1 > number2



>      * Compare number1 != number2


     *

<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right


     *
     * @return array
     */

<     protected function opGtNumberNumber($left, $right)



>     protected function opNeqNumberNumber(Number $left, Number $right)


    {

<         return $this->toBool($left[1] > $right[1]);



>         return $this->toBool(!$left->equals($right));


    }

    /**

<      * Compare number1 <= number2



>      * Compare number1 >= number2


     *

<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right


     *
     * @return array
     */

<     protected function opLteNumberNumber($left, $right)



>     protected function opGteNumberNumber(Number $left, Number $right)


    {

<         return $this->toBool($left[1] <= $right[1]);



>         return $this->toBool($left->greaterThanOrEqual($right));


    }

    /**

<      * Compare number1 < number2



>      * Compare number1 > number2


     *

<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right


     *
     * @return array
     */

<     protected function opLtNumberNumber($left, $right)



>     protected function opGtNumberNumber(Number $left, Number $right)


    {

<         return $this->toBool($left[1] < $right[1]);



>         return $this->toBool($left->greaterThan($right));


    }

    /**

<      * Three-way comparison, aka spaceship operator



>      * Compare number1 <= number2


     *

<      * @param array $left
<      * @param array $right



>      * @param Number $left
>      * @param Number $right


     *

<      * @return \ScssPhp\ScssPhp\Node\Number



>      * @return array


     */

<     protected function opCmpNumberNumber($left, $right)



>     protected function opLteNumberNumber(Number $left, Number $right)


    {

<         $n = $left[1] - $right[1];



>         return $this->toBool($left->lessThanOrEqual($right));
>     }




<         return new Node\Number($n ? $n / abs($n) : 0, '');



>     /**
>      * Compare number1 < number2
>      *
>      * @param Number $left
>      * @param Number $right
>      *
>      * @return array
>      */
>     protected function opLtNumberNumber(Number $left, Number $right)
>     {
>         return $this->toBool($left->lessThan($right));


    }

    /**
     * Cast to boolean
     *
     * @api
     *

<      * @param mixed $thing



>      * @param bool $thing


     *
     * @return array
     */
    public function toBool($thing)
    {
        return $thing ? static::$true : static::$false;
    }

    /**

>      * Escape non printable chars in strings output as in dart-sass
     * Compiles a primitive value into a CSS property value.
>      *
     *
>      * @internal
     * Values in scssphp are typed by being wrapped in arrays, their format is
>      *
     * typically:
>      * @param string $string
     *
>      * @param bool   $inKeyword
     *     array(type, contents [, additional_contents]*)
>      *
     *
>      * @return string
     * The input is expected to be reduced. This function will not work on
>      */
     * things like expressions and variables.
>     public function escapeNonPrintableChars($string, $inKeyword = false)
     *
>     {
     * @api
>         static $replacement = [];
     *
>         if (empty($replacement[$inKeyword])) {
     * @param array $value
>             for ($i = 0; $i < 32; $i++) {
     *
>                 if ($i !== 9 || $inKeyword) {
     * @return string|array
>                     $replacement[$inKeyword][chr($i)] = '\\' . dechex($i) . ($inKeyword ? ' ' : chr(0));
     */
>                 }
    public function compileValue($value)
>             }
    {
>         }
        $value = $this->reduce($value);
>         $string = str_replace(array_keys($replacement[$inKeyword]), array_values($replacement[$inKeyword]), $string);

>         // chr(0) is not a possible char from the input, so any chr(0) comes from our escaping replacement
        switch ($value[0]) {
>         if (strpos($string, chr(0)) !== false) {
            case Type::T_KEYWORD:
>             if (substr($string, -1) === chr(0)) {
                return $value[1];
>                 $string = substr($string, 0, -1);

>             }
            case Type::T_COLOR:
>             $string = str_replace(
                // [1] - red component (either number for a %)
>                 [chr(0) . '\\',chr(0) . ' '],
                // [2] - green component
>                 [ '\\', ' '],
                // [3] - blue component
>                 $string
                // [4] - optional alpha component
>             );
                list(, $r, $g, $b) = $value;
>             if (strpos($string, chr(0)) !== false) {

>                 $parts = explode(chr(0), $string);
                $r = $this->compileRGBAValue($r);
>                 $string = array_shift($parts);
                $g = $this->compileRGBAValue($g);
>                 while (count($parts)) {
                $b = $this->compileRGBAValue($b);
>                     $next = array_shift($parts);

>                     if (strpos("0123456789abcdefABCDEF" . chr(9), $next[0]) !== false) {
                if (count($value) === 5) {
>                         $string .= " ";
                    $alpha = $this->compileRGBAValue($value[4], true);
>                     }

>                     $string .= $next;
                    if (! is_numeric($alpha) || $alpha < 1) {
>                 }
                        $colorName = Colors::RGBaToColorName($r, $g, $b, $alpha);
>             }

>         }
                        if (! is_null($colorName)) {
> 
                            return $colorName;
>         return $string;
                        }
>     }

> 
                        if (is_numeric($alpha)) {
>     /**



<      * @param array $value



>      * @param array|Number $value
>      * @param bool         $quote



<      * @return string|array



>      * @return string



<     public function compileValue($value)



>     public function compileValue($value, $quote = true)


                        }

>         if ($value instanceof Number) {

>             return $value->output($this);
                        return 'rgba(' . $r . ', ' . $g . ', ' . $b . ', ' . $a . ')';
>         }
                    }
> 



<                 return $value[1];



>                 return $this->escapeNonPrintableChars($value[1], true);



<                 if (count($value) === 5) {



>                 if (\count($value) === 5) {



<                         if (! is_null($colorName)) {



>                         if (! \is_null($colorName)) {



<                             $a = new Node\Number($alpha, '');



>                             $a = new Number($alpha, '');


                }

                $colorName = Colors::RGBaToColorName($r, $g, $b);


<                 if (! is_null($colorName)) {



>                 if (! \is_null($colorName)) {


                    return $colorName;
                }

                $h = sprintf('#%02x%02x%02x', $r, $g, $b);

                // Converting hex color to short notation (e.g. #003399 to #039)
                if ($h[1] === $h[2] && $h[3] === $h[4] && $h[5] === $h[6]) {
                    $h = '#' . $h[1] . $h[3] . $h[5];
                }

                return $h;


<             case Type::T_NUMBER:
<                 return $value->output($this);
< 


            case Type::T_STRING:

<                 return $value[1] . $this->compileStringContent($value) . $value[1];



>                 $content = $this->compileStringContent($value, $quote);
> 
>                 if ($value[1] && $quote) {
>                     $content = str_replace('\\', '\\\\', $content);
> 
>                     $content = $this->escapeNonPrintableChars($content);
> 
>                     // force double quote as string quote for the output in certain cases
>                     if (
>                         $value[1] === "'" &&
>                         (strpos($content, '"') === false or strpos($content, "'") !== false)
>                     ) {
>                         $value[1] = '"';
>                     } elseif (
>                         $value[1] === '"' &&
>                         (strpos($content, '"') !== false and strpos($content, "'") === false)
>                     ) {
>                         $value[1] = "'";
>                     }
> 
>                     $content = str_replace($value[1], '\\' . $value[1], $content);
>                 }
> 
>                 return $value[1] . $content . $value[1];



            case Type::T_FUNCTION:

<                 $args = ! empty($value[2]) ? $this->compileValue($value[2]) : '';



>                 $args = ! empty($value[2]) ? $this->compileValue($value[2], $quote) : '';



                return "$value[1]($args)";


>             case Type::T_FUNCTION_REFERENCE:
            case Type::T_LIST:
>                 $name = ! empty($value[2]) ? $value[2] : '';
                $value = $this->extractInterpolation($value);
> 

>                 return "get-function(\"$name\")";
                if ($value[0] !== Type::T_LIST) {
> 



<                     return $this->compileValue($value);



>                     return $this->compileValue($value, $quote);


                }

                list(, $delim, $items) = $value;

<                 $pre = $post = "";



>                 $pre = $post = '';
> 


                if (! empty($value['enclosing'])) {
                    switch ($value['enclosing']) {
                        case 'parent':

<                             //$pre = "(";
<                             //$post = ")";



>                             //$pre = '(';
>                             //$post = ')';


                            break;
                        case 'forced_parent':

<                             $pre = "(";
<                             $post = ")";



>                             $pre = '(';
>                             $post = ')';


                            break;
                        case 'bracket':
                        case 'forced_bracket':

<                             $pre = "[";
<                             $post = "]";



>                             $pre = '[';
>                             $post = ']';


                            break;
                    }
                }


>                 $separator = $delim === '/' ? ' /' : $delim;
                $prefix_value = '';
> 


                if ($delim !== ' ') {

> 


                    $prefix_value = ' ';
                }

                $filtered = [];


>                 $same_string_quote = null;


                foreach ($items as $item) {

>                     if (\is_null($same_string_quote)) {
                    if ($item[0] === Type::T_NULL) {
>                         $same_string_quote = false;
                        continue;
>                         if ($item[0] === Type::T_STRING) {
                    }
>                             $same_string_quote = $item[1];

>                             foreach ($items as $ii) {
                    $compiled = $this->compileValue($item);
>                                 if ($ii[0] !== Type::T_STRING) {
                    if ($prefix_value && strlen($compiled)) {
>                                     $same_string_quote = false;
                        $compiled = $prefix_value . $compiled;
>                                     break;
                    }
>                                 }
                    $filtered[] = $compiled;
>                             }
                }
>                         }

>                     }


                return $pre . substr(implode("$delim", $filtered), strlen($prefix_value)) . $post;

>                     if ($same_string_quote === '"' && $item[0] === Type::T_STRING && $item[1]) {

>                         $item[1] = $same_string_quote;
            case Type::T_MAP:
>                     }
                $keys     = $value[1];
> 
                $values   = $value[2];
>                     $compiled = $this->compileValue($item, $quote);



<                     $compiled = $this->compileValue($item);
<                     if ($prefix_value && strlen($compiled)) {



>                     if ($prefix_value && \strlen($compiled)) {


                for ($i = 0, $s = count($keys); $i < $s; $i++) {

> 



<                 return $pre . substr(implode("$delim", $filtered), strlen($prefix_value)) . $post;



>                 return $pre . substr(implode($separator, $filtered), \strlen($prefix_value)) . $post;



<                 for ($i = 0, $s = count($keys); $i < $s; $i++) {
<                     $filtered[$this->compileValue($keys[$i])] = $this->compileValue($values[$i]);



>                 for ($i = 0, $s = \count($keys); $i < $s; $i++) {
>                     $filtered[$this->compileValue($keys[$i], $quote)] = $this->compileValue($values[$i], $quote);


                array_walk($filtered, function (&$value, $key) {
                    $value = $key . ': ' . $value;
                });

                return '(' . implode(', ', $filtered) . ')';

            case Type::T_INTERPOLATED:
                // node created by extractInterpolation
                list(, $interpolate, $left, $right) = $value;
                list(,, $whiteLeft, $whiteRight) = $interpolate;

                $delim = $left[1];

                if ($delim && $delim !== ' ' && ! $whiteLeft) {
                    $delim .= ' ';
                }


<                 $left = count($left[2]) > 0 ?
<                     $this->compileValue($left) . $delim . $whiteLeft: '';



>                 $left = \count($left[2]) > 0
>                     ?  $this->compileValue($left, $quote) . $delim . $whiteLeft
>                     : '';



                $delim = $right[1];

                if ($delim && $delim !== ' ') {
                    $delim .= ' ';
                }


<                 $right = count($right[2]) > 0 ?
<                     $whiteRight . $delim . $this->compileValue($right) : '';



>                 $right = \count($right[2]) > 0 ?
>                     $whiteRight . $delim . $this->compileValue($right, $quote) : '';




<                 return $left . $this->compileValue($interpolate) . $right;



>                 return $left . $this->compileValue($interpolate, $quote) . $right;



            case Type::T_INTERPOLATE:
                // strip quotes if it's a string
                $reduced = $this->reduce($value[1]);


>                 if ($reduced instanceof Number) {
                switch ($reduced[0]) {
>                     return $this->compileValue($reduced, $quote);
                    case Type::T_LIST:
>                 }
                        $reduced = $this->extractInterpolation($reduced);
> 



                        if ($reduced[0] !== Type::T_LIST) {
                            break;
                        }

                        list(, $delim, $items) = $reduced;

                        if ($delim !== ' ') {
                            $delim .= ' ';
                        }

                        $filtered = [];

                        foreach ($items as $item) {
                            if ($item[0] === Type::T_NULL) {
                                continue;
                            }


<                             $temp = $this->compileValue([Type::T_KEYWORD, $item]);
< 
<                             if ($temp[0] === Type::T_STRING) {
<                                 $filtered[] = $this->compileStringContent($temp);
<                             } elseif ($temp[0] === Type::T_KEYWORD) {
<                                 $filtered[] = $temp[1];



>                             if ($item[0] === Type::T_STRING) {
>                                 $filtered[] = $this->compileStringContent($item, $quote);
>                             } elseif ($item[0] === Type::T_KEYWORD) {
>                                 $filtered[] = $item[1];


                            } else {

<                                 $filtered[] = $this->compileValue($temp);



>                                 $filtered[] = $this->compileValue($item, $quote);


                            }
                        }

                        $reduced = [Type::T_KEYWORD, implode("$delim", $filtered)];
                        break;

                    case Type::T_STRING:

<                         $reduced = [Type::T_KEYWORD, $this->compileStringContent($reduced)];



>                         $reduced = [Type::T_STRING, '', [$this->compileStringContent($reduced)]];


                        break;

                    case Type::T_NULL:
                        $reduced = [Type::T_KEYWORD, ''];
                }


<                 return $this->compileValue($reduced);



>                 return $this->compileValue($reduced, $quote);



            case Type::T_NULL:
                return 'null';

            case Type::T_COMMENT:
                return $this->compileCommentValue($value);

            default:

<                 $this->throwError("unknown value type: ".json_encode($value));



>                 throw $this->error('unknown value type: ' . json_encode($value));
>         }
>     }
> 
>     /**
>      * @param array|Number $value
>      *
>      * @return string
>      */
>     protected function compileDebugValue($value)
>     {
>         $value = $this->reduce($value, true);
> 
>         if ($value instanceof Number) {
>             return $this->compileValue($value);
>         }
> 
>         switch ($value[0]) {
>             case Type::T_STRING:
>                 return $this->compileStringContent($value);
> 
>             default:
>                 return $this->compileValue($value);


        }
    }

    /**
     * Flatten list
     *
     * @param array $list
     *
     * @return string

>      *
     */
>      * @deprecated


    protected function flattenList($list)
    {

>         @trigger_error(sprintf('The "%s" method is deprecated.', __METHOD__), E_USER_DEPRECATED);
        return $this->compileValue($list);
> 


    }

    /**

>      * Gets the text of a Sass string
     * Compile string content
>      *
     *
>      * Calling this method on anything else than a SassString is unsupported. Use {@see assertString} first
     * @param array $string
>      * to ensure that the value is indeed a string.
     *
>      *
     * @return string
>      * @param array $value
     */
>      *
    protected function compileStringContent($string)
>      * @return string
    {
>      */
        $parts = [];
>     public function getStringText(array $value)

>     {
        foreach ($string[2] as $part) {
>         if ($value[0] !== Type::T_STRING) {
            if (is_array($part) || $part instanceof \ArrayAccess) {
>             throw new \InvalidArgumentException('The argument is not a sass string. Did you forgot to use "assertString"?');
                $parts[] = $this->compileValue($part);
>         }
            } else {
> 
                $parts[] = $part;
>         return $this->compileStringContent($value);
            }
>     }
        }
> 

>     /**


        return implode($parts);

>      * @param bool  $quote



<     protected function compileStringContent($string)



>     protected function compileStringContent($string, $quote = true)



<             if (is_array($part) || $part instanceof \ArrayAccess) {
<                 $parts[] = $this->compileValue($part);



>             if (\is_array($part) || $part instanceof Number) {
>                 $parts[] = $this->compileValue($part, $quote);


     * Extract interpolation; it doesn't need to be recursive, compileValue will handle that
     *
     * @param array $list
     *
     * @return array
     */
    protected function extractInterpolation($list)
    {
        $items = $list[2];

        foreach ($items as $i => $item) {
            if ($item[0] === Type::T_INTERPOLATE) {

<                 $before = [Type::T_LIST, $list[1], array_slice($items, 0, $i)];
<                 $after  = [Type::T_LIST, $list[1], array_slice($items, $i + 1)];



>                 $before = [Type::T_LIST, $list[1], \array_slice($items, 0, $i)];
>                 $after  = [Type::T_LIST, $list[1], \array_slice($items, $i + 1)];



                return [Type::T_INTERPOLATED, $item, $before, $after];
            }
        }

        return $list;
    }

    /**
     * Find the final set of selectors
     *
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
     * @param \ScssPhp\ScssPhp\Block                $selfParent
     *
     * @return array
     */
    protected function multiplySelectors(Environment $env, $selfParent = null)
    {
        $envs            = $this->compactEnv($env);
        $selectors       = [];
        $parentSelectors = [[]];

        $selfParentSelectors = null;


<         if (! is_null($selfParent) && $selfParent->selectors) {



>         if (! \is_null($selfParent) && $selfParent->selectors) {


            $selfParentSelectors = $this->evalSelectors($selfParent->selectors);
        }

        while ($env = array_pop($envs)) {
            if (empty($env->selectors)) {
                continue;
            }

            $selectors = $env->selectors;

            do {
                $stillHasSelf  = false;
                $prevSelectors = $selectors;
                $selectors     = [];


<                 foreach ($prevSelectors as $selector) {


                    foreach ($parentSelectors as $parent) {

>                     foreach ($prevSelectors as $selector) {


                        if ($selfParentSelectors) {
                            foreach ($selfParentSelectors as $selfParent) {
                                // if no '&' in the selector, each call will give same result, only add once
                                $s = $this->joinSelectors($parent, $selector, $stillHasSelf, $selfParent);
                                $selectors[serialize($s)] = $s;
                            }
                        } else {
                            $s = $this->joinSelectors($parent, $selector, $stillHasSelf);
                            $selectors[serialize($s)] = $s;
                        }
                    }
                }
            } while ($stillHasSelf);

            $parentSelectors = $selectors;
        }

        $selectors = array_values($selectors);


>         // case we are just starting a at-root : nothing to multiply but parentSelectors
        return $selectors;
>         if (! $selectors && $selfParentSelectors) {
    }
>             $selectors = $selfParentSelectors;

>         }
    /**
> 


     * Join selectors; looks for & to replace, or append parent before child
     *
     * @param array   $parent
     * @param array   $child

<      * @param boolean &$stillHasSelf



>      * @param bool  $stillHasSelf


     * @param array   $selfParentSelectors

     * @return array
     */
    protected function joinSelectors($parent, $child, &$stillHasSelf, $selfParentSelectors = null)
    {
        $setSelf = false;
        $out = [];

        foreach ($child as $part) {
            $newPart = [];

            foreach ($part as $p) {
                // only replace & once and should be recalled to be able to make combinations
                if ($p === static::$selfSelector && $setSelf) {
                    $stillHasSelf = true;
                }

                if ($p === static::$selfSelector && ! $setSelf) {
                    $setSelf = true;


<                     if (is_null($selfParentSelectors)) {



>                     if (\is_null($selfParentSelectors)) {


                        $selfParentSelectors = $parent;
                    }

                    foreach ($selfParentSelectors as $i => $parentPart) {
                        if ($i > 0) {
                            $out[] = $newPart;
                            $newPart = [];
                        }

                        foreach ($parentPart as $pp) {

<                             if (is_array($pp)) {



>                             if (\is_array($pp)) {


                                $flatten = [];

                                array_walk_recursive($pp, function ($a) use (&$flatten) {
                                    $flatten[] = $a;
                                });

                                $pp = implode($flatten);
                            }

                            $newPart[] = $pp;
                        }
                    }
                } else {
                    $newPart[] = $p;
                }
            }

            $out[] = $newPart;
        }

        return $setSelf ? $out : array_merge($parent, $child);
    }

    /**
     * Multiply media
     *
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
     * @param array                                 $childQueries
     *
     * @return array
     */
    protected function multiplyMedia(Environment $env = null, $childQueries = null)
    {

<         if (! isset($env) ||



>         if (
>             ! isset($env) ||


            ! empty($env->block->type) && $env->block->type !== Type::T_MEDIA
        ) {
            return $childQueries;
        }

        // plain old block, skip
        if (empty($env->block->type)) {
            return $this->multiplyMedia($env->parent, $childQueries);
        }


>         assert($env->block instanceof MediaBlock);
        $parentQueries = isset($env->block->queryList)
> 


            ? $env->block->queryList
            : [[[Type::T_MEDIA_VALUE, $env->block->value]]];

        $store = [$this->env, $this->storeEnv];

        $this->env      = $env;
        $this->storeEnv = null;
        $parentQueries  = $this->evaluateMediaQuery($parentQueries);

        list($this->env, $this->storeEnv) = $store;


<         if (is_null($childQueries)) {



>         if (\is_null($childQueries)) {


            $childQueries = $parentQueries;
        } else {
            $originalQueries = $childQueries;
            $childQueries = [];

            foreach ($parentQueries as $parentQuery) {
                foreach ($originalQueries as $childQuery) {
                    $childQueries[] = array_merge(
                        $parentQuery,
                        [[Type::T_MEDIA_TYPE, [Type::T_KEYWORD, 'all']]],
                        $childQuery
                    );
                }
            }
        }

        return $this->multiplyMedia($env->parent, $childQueries);
    }

    /**
     * Convert env linked list to stack
     *

<      * @param \ScssPhp\ScssPhp\Compiler\Environment $env



>      * @param Environment $env


     *

<      * @return array



>      * @return Environment[]
>      *
>      * @phpstan-return non-empty-array<Environment>


     */
    protected function compactEnv(Environment $env)
    {
        for ($envs = []; $env; $env = $env->parent) {
            $envs[] = $env;
        }

        return $envs;
    }

    /**
     * Convert env stack to singly linked list
     *

<      * @param array $envs



>      * @param Environment[] $envs


     *

<      * @return \ScssPhp\ScssPhp\Compiler\Environment



>      * @return Environment
>      *
>      * @phpstan-param  non-empty-array<Environment> $envs


     */
    protected function extractEnv($envs)
    {
        for ($env = null; $e = array_pop($envs);) {
            $e->parent = $env;
            $env = $e;
        }

        return $env;
    }

    /**
     * Push environment
     *
     * @param \ScssPhp\ScssPhp\Block $block
     *
     * @return \ScssPhp\ScssPhp\Compiler\Environment
     */
    protected function pushEnv(Block $block = null)
    {

<         $env = new Environment;



>         $env = new Environment();


        $env->parent = $this->env;

>         $env->parentStore = $this->storeEnv;


        $env->store  = [];
        $env->block  = $block;
        $env->depth  = isset($this->env->depth) ? $this->env->depth + 1 : 0;

        $this->env = $env;

>         $this->storeEnv = null;



        return $env;
    }

    /**
     * Pop environment

>      *
     */
>      * @return void


    protected function popEnv()
    {

>         $this->storeEnv = $this->env->parentStore;


        $this->env = $this->env->parent;
    }

    /**

>      * Propagate vars from a just poped Env (used in @each and @for)
     * Get store environment
>      *
     *
>      * @param array         $store
     * @return \ScssPhp\ScssPhp\Compiler\Environment
>      * @param null|string[] $excludedVars
     */
>      *
    protected function getStoreEnv()
>      * @return void
    {
>      */
        return isset($this->storeEnv) ? $this->storeEnv : $this->env;
>     protected function backPropagateEnv($store, $excludedVars = null)
    }
>     {

>         foreach ($store as $key => $value) {
    /**
>             if (empty($excludedVars) || ! \in_array($key, $excludedVars)) {
     * Set variable
>                 $this->set($key, $value, true);
     *
>             }
     * @param string                                $name
>         }
     * @param mixed                                 $value
>     }
     * @param boolean                               $shadow
> 
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
>     /**



<      * @param boolean                               $shadow



>      * @param bool                                  $shadow


     */

>      *
    protected function set($name, $value, $shadow = false, Environment $env = null, $valueUnreduced = null)
>      * @return void


    {
        $name = $this->normalizeName($name);

        if (! isset($env)) {
            $env = $this->getStoreEnv();
        }

        if ($shadow) {
            $this->setRaw($name, $value, $env, $valueUnreduced);
        } else {
            $this->setExisting($name, $value, $env, $valueUnreduced);
        }
    }

    /**
     * Set existing variable
     *
     * @param string                                $name
     * @param mixed                                 $value
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
     * @param mixed                                 $valueUnreduced

>      *
     */
>      * @return void


    protected function setExisting($name, $value, Environment $env, $valueUnreduced = null)
    {
        $storeEnv = $env;

>         $specialContentKey = static::$namespaces['special'] . 'content';



        $hasNamespace = $name[0] === '^' || $name[0] === '@' || $name[0] === '%';


>         $maxDepth = 10000;
        for (;;) {
> 



<             if (array_key_exists($name, $env->store)) {



>             if ($maxDepth-- <= 0) {


                break;
            }


<             if (! $hasNamespace && isset($env->marker)) {
<                 $env = $storeEnv;



>             if (\array_key_exists($name, $env->store)) {


                break;
            }


<             if (! isset($env->parent)) {



>             if (! $hasNamespace && isset($env->marker)) {
>                 if (! empty($env->store[$specialContentKey])) {
>                     $env = $env->store[$specialContentKey]->scope;
>                     continue;
>                 }
> 
>                 if (! empty($env->declarationScopeParent)) {
>                     $env = $env->declarationScopeParent;
>                     continue;
>                 } else {


                $env = $storeEnv;
                break;
            }

>             }




>             if (isset($env->parentStore)) {
            $env = $env->parent;
>                 $env = $env->parentStore;
        }
>             } elseif (isset($env->parent)) {




>             } else {
        $env->store[$name] = $value;
>                 $env = $storeEnv;

>                 break;
        if ($valueUnreduced) {
>             }


            $env->storeUnreduced[$name] = $valueUnreduced;
        }
    }

    /**
     * Set raw variable
     *
     * @param string                                $name
     * @param mixed                                 $value
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
     * @param mixed                                 $valueUnreduced

>      *
     */
>      * @return void


    protected function setRaw($name, $value, Environment $env, $valueUnreduced = null)
    {
        $env->store[$name] = $value;

        if ($valueUnreduced) {
            $env->storeUnreduced[$name] = $valueUnreduced;
        }
    }

    /**
     * Get variable
     *

<      * @api



>      * @internal


     *
     * @param string                                $name

<      * @param boolean                               $shouldThrow



>      * @param bool                                  $shouldThrow


     * @param \ScssPhp\ScssPhp\Compiler\Environment $env

<      * @param boolean                               $unreduced



>      * @param bool                                  $unreduced


     *
     * @return mixed|null
     */
    public function get($name, $shouldThrow = true, Environment $env = null, $unreduced = false)
    {
        $normalizedName = $this->normalizeName($name);
        $specialContentKey = static::$namespaces['special'] . 'content';

        if (! isset($env)) {
            $env = $this->getStoreEnv();
        }

        $hasNamespace = $normalizedName[0] === '^' || $normalizedName[0] === '@' || $normalizedName[0] === '%';

        $maxDepth = 10000;

        for (;;) {
            if ($maxDepth-- <= 0) {
                break;
            }


<             if (array_key_exists($normalizedName, $env->store)) {



>             if (\array_key_exists($normalizedName, $env->store)) {


                if ($unreduced && isset($env->storeUnreduced[$normalizedName])) {
                    return $env->storeUnreduced[$normalizedName];
                }

                return $env->store[$normalizedName];
            }

            if (! $hasNamespace && isset($env->marker)) {
                if (! empty($env->store[$specialContentKey])) {
                    $env = $env->store[$specialContentKey]->scope;
                    continue;
                }

                if (! empty($env->declarationScopeParent)) {
                    $env = $env->declarationScopeParent;
                } else {
                    $env = $this->rootEnv;
                }
                continue;
            }


<             if (! isset($env->parent)) {



>             if (isset($env->parentStore)) {
>                 $env = $env->parentStore;
>             } elseif (isset($env->parent)) {
>                 $env = $env->parent;
>             } else {


                break;
            }

< 
<             $env = $env->parent;


        }

        if ($shouldThrow) {

<             $this->throwError("Undefined variable \$$name" . ($maxDepth <= 0 ? " (infinite recursion)" : ""));



>             throw $this->error("Undefined variable \$$name" . ($maxDepth <= 0 ? ' (infinite recursion)' : ''));


        }

        // found nothing
        return null;
    }

    /**
     * Has variable?
     *
     * @param string                                $name
     * @param \ScssPhp\ScssPhp\Compiler\Environment $env
     *

<      * @return boolean



>      * @return bool


     */
    protected function has($name, Environment $env = null)
    {

<         return ! is_null($this->get($name, false, $env));



>         return ! \is_null($this->get($name, false, $env));


    }

    /**
     * Inject variables
     *
     * @param array $args

>      *
     */
>      * @return void


    protected function injectVariables(array $args)
    {
        if (empty($args)) {
            return;
        }

        $parser = $this->parserFactory(__METHOD__);

        foreach ($args as $name => $strValue) {
            if ($name[0] === '$') {
                $name = substr($name, 1);
            }


<             if (! $parser->parseValue($strValue, $value)) {



>             if (!\is_string($strValue) || ! $parser->parseValue($strValue, $value)) {


                $value = $this->coerceValue($strValue);
            }

            $this->set($name, $value);
        }
    }

    /**

>      * Replaces variables.
     * Set variables
>      *
     *
>      * @param array<string, mixed> $variables
     * @api
>      *
     *
>      * @return void
     * @param array $variables
>      */
     */
>     public function replaceVariables(array $variables)
    public function setVariables(array $variables)
>     {
    {
>         $this->registeredVars = [];
        $this->registeredVars = array_merge($this->registeredVars, $variables);
>         $this->addVariables($variables);
    }
>     }

> 
    /**
>     /**
     * Unset variable
>      * Replaces variables.
     *
>      *
     * @api
>      * @param array<string, mixed> $variables
     *
>      *
     * @param string $name
>      * @return void
     */
>      */
    public function unsetVariable($name)
>     public function addVariables(array $variables)
    {
>     {
        unset($this->registeredVars[$name]);
>         $triggerWarning = false;
    }
> 

>         foreach ($variables as $name => $value) {
    /**
>             if (!$value instanceof Number && !\is_array($value)) {
     * Returns list of variables
>                 $triggerWarning = true;
     *
>             }
     * @api
> 
     *
>             $this->registeredVars[$name] = $value;
     * @return array
>         }
     */
> 
    public function getVariables()
>         if ($triggerWarning) {
    {
>             @trigger_error('Passing raw values to as custom variables to the Compiler is deprecated. Use "\ScssPhp\ScssPhp\ValueConverter::parseValue" or "\ScssPhp\ScssPhp\ValueConverter::fromPhp" to convert them instead.', E_USER_DEPRECATED);
        return $this->registeredVars;
>         }
    }
>     }

> 
    /**
>     /**


     * Adds to list of parsed files

>      *
     *
>      * @return void
     * @api
>      *
     *
>      * @deprecated Use "addVariables" or "replaceVariables" instead.



<         $this->registeredVars = array_merge($this->registeredVars, $variables);



>         @trigger_error('The method "setVariables" of the Compiler is deprecated. Use the "addVariables" method for the equivalent behavior or "replaceVariables" if merging with previous variables was not desired.');
> 
>         $this->addVariables($variables);


     */

>      *
    public function addParsedFile($path)
>      * @return void



<      * @api



>      * @internal



<      * @param string $path



>      * @param string|null $path
>      *
>      * @return void



<         if (isset($path) && is_file($path)) {



>         if (! \is_null($path) && is_file($path)) {


        }
    }

    /**
     * Returns list of parsed files
     *

<      * @api
<      *
<      * @return array



>      * @deprecated
>      * @return array<string, int>


     */
    public function getParsedFiles()
    {

>         @trigger_error('The method "getParsedFiles" of the Compiler is deprecated. Use the "getIncludedFiles" method on the CompilationResult instance returned by compileString() instead. Be careful that the signature of the method is different.', E_USER_DEPRECATED);


        return $this->parsedFiles;
    }

    /**
     * Add import path
     *
     * @api
     *
     * @param string|callable $path

>      *
     */
>      * @return void


    public function addImportPath($path)
    {

<         if (! in_array($path, $this->importPaths)) {



>         if (! \in_array($path, $this->importPaths)) {


            $this->importPaths[] = $path;
        }
    }

    /**
     * Set import paths
     *
     * @api
     *

<      * @param string|array $path



>      * @param string|array<string|callable> $path
>      *
>      * @return void


     */
    public function setImportPaths($path)
    {

<         $this->importPaths = (array) $path;



>         $paths = (array) $path;
>         $actualImportPaths = array_filter($paths, function ($path) {
>             return $path !== '';
>         });
> 
>         $this->legacyCwdImportPath = \count($actualImportPaths) !== \count($paths);
> 
>         if ($this->legacyCwdImportPath) {
>             @trigger_error('Passing an empty string in the import paths to refer to the current working directory is deprecated. If that\'s the intended behavior, the value of "getcwd()" should be used directly instead. If this was used for resolving relative imports of the input alongside "chdir" with the source directory, the path of the input file should be passed to "compileString()" instead.', E_USER_DEPRECATED);
>         }
> 
>         $this->importPaths = $actualImportPaths;


    }

    /**
     * Set number precision
     *
     * @api
     *

<      * @param integer $numberPrecision



>      * @param int $numberPrecision
>      *
>      * @return void
>      *
>      * @deprecated The number precision is not configurable anymore. The default is enough for all browsers.


     */
    public function setNumberPrecision($numberPrecision)
    {

<         Node\Number::$precision = $numberPrecision;



>         @trigger_error('The number precision is not configurable anymore. '
>             . 'The default is enough for all browsers.', E_USER_DEPRECATED);
>     }
> 
>     /**
>      * Sets the output style.
>      *
>      * @api
>      *
>      * @param string $style One of the OutputStyle constants
>      *
>      * @return void
>      *
>      * @phpstan-param OutputStyle::* $style
>      */
>     public function setOutputStyle($style)
>     {
>         switch ($style) {
>             case OutputStyle::EXPANDED:
>                 $this->configuredFormatter = Expanded::class;
>                 break;
> 
>             case OutputStyle::COMPRESSED:
>                 $this->configuredFormatter = Compressed::class;
>                 break;
> 
>             default:
>                 throw new \InvalidArgumentException(sprintf('Invalid output style "%s".', $style));
>         }


    }

    /**
     * Set formatter
     *
     * @api
     *
     * @param string $formatterName

>      *
     */
>      * @return void
    public function setFormatter($formatterName)
>      *
    {
>      * @deprecated Use {@see setOutputStyle} instead.
        $this->formatter = $formatterName;
>      *
    }
>      * @phpstan-param class-string<Formatter> $formatterName



<         $this->formatter = $formatterName;



>         if (!\in_array($formatterName, [Expanded::class, Compressed::class], true)) {
>             @trigger_error('Formatters other than Expanded and Compressed are deprecated.', E_USER_DEPRECATED);
>         }
>         @trigger_error('The method "setFormatter" is deprecated. Use "setOutputStyle" instead.', E_USER_DEPRECATED);
> 
>         $this->configuredFormatter = $formatterName;


    /**
     * Set line number style
     *
     * @api
     *
     * @param string $lineNumberStyle

>      *
     */
>      * @return void
    public function setLineNumberStyle($lineNumberStyle)
>      *
    {
>      * @deprecated The line number output is not supported anymore. Use source maps instead.



<         $this->lineNumberStyle = $lineNumberStyle;



>         @trigger_error('The line number output is not supported anymore. '
>                        . 'Use source maps instead.', E_USER_DEPRECATED);
>     }
> 
>     /**
>      * Configures the handling of non-ASCII outputs.
>      *
>      * If $charset is `true`, this will include a `@charset` declaration or a
>      * UTF-8 [byte-order mark][] if the stylesheet contains any non-ASCII
>      * characters. Otherwise, it will never include a `@charset` declaration or a
>      * byte-order mark.
>      *
>      * [byte-order mark]: https://en.wikipedia.org/wiki/Byte_order_mark#UTF-8
>      *
>      * @param bool $charset
>      *
>      * @return void
>      */
>     public function setCharset($charset)
>     {
>         $this->charset = $charset;


    }

    /**
     * Enable/disable source maps
     *
     * @api
     *

<      * @param integer $sourceMap



>      * @param int $sourceMap
>      *
>      * @return void
>      *
>      * @phpstan-param self::SOURCE_MAP_* $sourceMap


     */
    public function setSourceMap($sourceMap)
    {
        $this->sourceMap = $sourceMap;
    }

    /**
     * Set source map options
     *
     * @api
     *
     * @param array $sourceMapOptions

>      *
     */
>      * @phpstan-param  array{sourceRoot?: string, sourceMapFilename?: string|null, sourceMapURL?: string|null, sourceMapWriteTo?: string|null, outputSourceFiles?: bool, sourceMapRootpath?: string, sourceMapBasepath?: string} $sourceMapOptions
    public function setSourceMapOptions($sourceMapOptions)
>      *
    {
>      * @return void


        $this->sourceMapOptions = $sourceMapOptions;
    }

    /**
     * Register function
     *
     * @api
     *
     * @param string   $name

<      * @param callable $func
<      * @param array    $prototype



>      * @param callable      $callback
>      * @param string[]|null $argumentDeclaration
>      *
>      * @return void


     */

<     public function registerFunction($name, $func, $prototype = null)



>     public function registerFunction($name, $callback, $argumentDeclaration = null)


    {

<         $this->userFunctions[$this->normalizeName($name)] = [$func, $prototype];



>         if (self::isNativeFunction($name)) {
>             @trigger_error(sprintf('The "%s" function is a core sass function. Overriding it with a custom implementation through "%s" is deprecated and won\'t be supported in ScssPhp 2.0 anymore.', $name, __METHOD__), E_USER_DEPRECATED);
>         }
> 
>         if ($argumentDeclaration === null) {
>             @trigger_error('Omitting the argument declaration when registering custom function is deprecated and won\'t be supported in ScssPhp 2.0 anymore.', E_USER_DEPRECATED);
>         }
> 
>         $this->userFunctions[$this->normalizeName($name)] = [$callback, $argumentDeclaration];


    }

    /**
     * Unregister function
     *
     * @api
     *
     * @param string $name

>      *
     */
>      * @return void


    public function unregisterFunction($name)
    {
        unset($this->userFunctions[$this->normalizeName($name)]);
    }

    /**
     * Add feature
     *
     * @api
     *
     * @param string $name

>      *
     */
>      * @return void
    public function addFeature($name)
>      *
    {
>      * @deprecated Registering additional features is deprecated.


        $this->registeredFeatures[$name] = true;

>         @trigger_error('Registering additional features is deprecated.', E_USER_DEPRECATED);
    }
> 



    /**
     * Import file
     *
     * @param string                                 $path
     * @param \ScssPhp\ScssPhp\Formatter\OutputBlock $out

>      *
     */
>      * @return void


    protected function importFile($path, OutputBlock $out)
    {

>         $this->pushCallStack('import ' . $this->getPrettyPath($path));


        // see if tree is cached
        $realPath = realpath($path);


>         if ($realPath === false) {
        if (isset($this->importCache[$realPath])) {
>             $realPath = $path;
            $this->handleImportLoop($realPath);
>         }

> 
            $tree = $this->importCache[$realPath];
>         if (substr($path, -5) === '.sass') {
        } else {
>             $this->sourceIndex = \count($this->sourceNames);
            $code   = file_get_contents($path);
>             $this->sourceNames[] = $path;
            $parser = $this->parserFactory($path);
>             $this->sourceLine = 1;
            $tree   = $parser->parse($code);
>             $this->sourceColumn = 1;

> 
            $this->importCache[$realPath] = $tree;
>             throw $this->error('The Sass indented syntax is not implemented.');
        }
>         }

> 



<         $pi = pathinfo($path);



>         $currentDirectory = $this->currentDirectory;
>         $this->currentDirectory = dirname($path);




<         array_unshift($this->importPaths, $pi['dirname']);


        $this->compileChildrenNoReturn($tree->children, $out);

<         array_shift($this->importPaths);



>         $this->currentDirectory = $currentDirectory;
>         $this->popCallStack();
>     }
> 
>     /**
>      * Save the imported files with their resolving path context
>      *
>      * @param string|null $currentDirectory
>      * @param string      $path
>      * @param string      $filePath
>      *
>      * @return void
>      */
>     private function registerImport($currentDirectory, $path, $filePath)
>     {
>         $this->resolvedImports[] = ['currentDir' => $currentDirectory, 'path' => $path, 'filePath' => $filePath];
>     }
> 
>     /**
>      * Detects whether the import is a CSS import.
>      *
>      * For legacy reasons, custom importers are called for those, allowing them
>      * to replace them with an actual Sass import. However this behavior is
>      * deprecated. Custom importers are expected to return null when they receive
>      * a CSS import.
>      *
>      * @param string $url
>      *
>      * @return bool
>      */
>     public static function isCssImport($url)
>     {
>         return 1 === preg_match('~\.css$|^https?://|^//~', $url);


    }

    /**
     * Return the file path for an import url if it exists
     *

<      * @api



>      * @internal


     *
     * @param string $url

>      * @param string|null $currentDir


     *
     * @return string|null
     */

<     public function findImport($url)



>     public function findImport($url, $currentDir = null)


    {

<         $urls = [];
< 
<         // for "normal" scss imports (ignore vanilla css and external requests)
<         if (! preg_match('~\.css$|^https?://~', $url)) {
<             // try both normal and the _partial filename
<             $urls = [$url, preg_replace('~[^/]+$~', '_\0', $url)];



>         // Vanilla css and external requests. These are not meant to be Sass imports.
>         // Callback importers are still called for BC.
>         if (self::isCssImport($url)) {
>             foreach ($this->importPaths as $dir) {
>                 if (\is_string($dir)) {
>                     continue;


        }


<         $hasExtension = preg_match('/[.]s?css$/', $url);



>                 if (\is_callable($dir)) {
>                     // check custom callback for import path
>                     $file = \call_user_func($dir, $url);




<         foreach ($this->importPaths as $dir) {
<             if (is_string($dir)) {
<                 // check urls for normal import paths
<                 foreach ($urls as $full) {
<                     $separator = (
<                         ! empty($dir) &&
<                         substr($dir, -1) !== '/' &&
<                         substr($full, 0, 1) !== '/'
<                     ) ? '/' : '';
<                     $full = $dir . $separator . $full;



>                     if (! \is_null($file)) {
>                         if (\is_array($dir)) {
>                             $callableDescription = (\is_object($dir[0]) ? \get_class($dir[0]) : $dir[0]).'::'.$dir[1];
>                         } elseif ($dir instanceof \Closure) {
>                             $r = new \ReflectionFunction($dir);
>                             if (false !== strpos($r->name, '{closure}')) {
>                                 $callableDescription = sprintf('closure{%s:%s}', $r->getFileName(), $r->getStartLine());
>                             } elseif ($class = $r->getClosureScopeClass()) {
>                                 $callableDescription = $class->name.'::'.$r->name;
>                             } else {
>                                 $callableDescription = $r->name;
>                             }
>                         } elseif (\is_object($dir)) {
>                             $callableDescription = \get_class($dir) . '::__invoke';
>                         } else {
>                             $callableDescription = 'callable'; // Fallback if we don't have a dedicated description
>                         }
>                         @trigger_error(sprintf('Returning a file to import for CSS or external references in custom importer callables is deprecated and will not be supported anymore in ScssPhp 2.0. This behavior is not compliant with the Sass specification. Update your "%s" importer.', $callableDescription), E_USER_DEPRECATED);




<                     if (is_file($file = $full . '.scss') ||
<                         ($hasExtension && is_file($file = $full))
<                     ) {


                        return $file;
                    }
                }

<             } elseif (is_callable($dir)) {



>             }
>             return null;
>         }
> 
>         if (!\is_null($currentDir)) {
>             $relativePath = $this->resolveImportPath($url, $currentDir);
> 
>             if (!\is_null($relativePath)) {
>                 return $relativePath;
>             }
>         }
> 
>         foreach ($this->importPaths as $dir) {
>             if (\is_string($dir)) {
>                 $path = $this->resolveImportPath($url, $dir);
> 
>                 if (!\is_null($path)) {
>                     return $path;
>                 }
>             } elseif (\is_callable($dir)) {


                // check custom callback for import path

<                 $file = call_user_func($dir, $url);



>                 $file = \call_user_func($dir, $url);




<                 if (! is_null($file)) {



>                 if (! \is_null($file)) {


                    return $file;
                }
            }
        }


>         if ($this->legacyCwdImportPath) {
        return null;
>             $path = $this->resolveImportPath($url, getcwd());
    }
> 

>             if (!\is_null($path)) {
    /**
>                 @trigger_error('Resolving imports relatively to the current working directory is deprecated. If that\'s the intended behavior, the value of "getcwd()" should be added as an import path explicitly instead. If this was used for resolving relative imports of the input alongside "chdir" with the source directory, the path of the input file should be passed to "compileString()" instead.', E_USER_DEPRECATED);
     * Set encoding
> 
     *
>                 return $path;
     * @api
>             }
     *
>         }
     * @param string $encoding
> 
     */
>         throw $this->error("`$url` file not found for @import");
    public function setEncoding($encoding)
>     }
    {
> 
        $this->encoding = $encoding;
>     /**
    }
>      * @param string $url

>      * @param string $baseDir
    /**
>      *
     * Ignore errors?
>      * @return string|null
     *
>      */
     * @api
>     private function resolveImportPath($url, $baseDir)
     *
>     {
     * @param boolean $ignoreErrors
>         $path = Path::join($baseDir, $url);
     *
> 
     * @return \ScssPhp\ScssPhp\Compiler
>         $hasExtension = preg_match('/.s[ac]ss$/', $url);
     */
> 
    public function setIgnoreErrors($ignoreErrors)
>         if ($hasExtension) {
    {
>             return $this->checkImportPathConflicts($this->tryImportPath($path));
        $this->ignoreErrors = $ignoreErrors;
>         }

> 
        return $this;
>         $result = $this->checkImportPathConflicts($this->tryImportPathWithExtensions($path));
    }
> 

>         if (!\is_null($result)) {
    /**
>             return $result;
     * Throw error (exception)
>         }
     *
> 
     * @api
>         return $this->tryImportPathAsDirectory($path);
     *
>     }
     * @param string $msg Message with optional sprintf()-style vararg parameters
> 
     *
>     /**
     * @throws \ScssPhp\ScssPhp\Exception\CompilerException
>      * @param string[] $paths
     */
>      *
    public function throwError($msg)
>      * @return string|null
    {
>      */
        if ($this->ignoreErrors) {
>     private function checkImportPathConflicts(array $paths)
            return;
>     {
        }
>         if (\count($paths) === 0) {

>             return null;
        $line   = $this->sourceLine;
>         }
        $column = $this->sourceColumn;
> 

>         if (\count($paths) === 1) {
        $loc = isset($this->sourceNames[$this->sourceIndex])
>             return $paths[0];
             ? $this->sourceNames[$this->sourceIndex] . " on line $line, at column $column"
>         }
             : "line: $line, column: $column";
> 

>         $formattedPrettyPaths = [];
        if (func_num_args() > 1) {
> 
            $msg = call_user_func_array('sprintf', func_get_args());
>         foreach ($paths as $path) {
        }
>             $formattedPrettyPaths[] = '  ' . $this->getPrettyPath($path);

>         }
        $msg = "$msg: $loc";
> 

>         throw $this->error("It's not clear which file to import. Found:\n" . implode("\n", $formattedPrettyPaths));
        $callStackMsg = $this->callStackMessage();
>     }

> 
        if ($callStackMsg) {
>     /**
            $msg .= "\nCall Stack:\n" . $callStackMsg;
>      * @param string $path
        }
>      *

>      * @return string[]
        throw new CompilerException($msg);
>      */
    }
>     private function tryImportPathWithExtensions($path)

>     {
    /**
>         $result = array_merge(
     * Beautify call stack for output
>             $this->tryImportPath($path.'.sass'),
     *
>             $this->tryImportPath($path.'.scss')
     * @param boolean $all
>         );
     * @param null    $limit
> 
     *
>         if ($result) {
     * @return string
>             return $result;
     */
>         }
    protected function callStackMessage($all = false, $limit = null)
> 
    {
>         return $this->tryImportPath($path.'.css');
        $callStackMsg = [];
>     }
        $ncall = 0;
> 

>     /**
        if ($this->callStack) {
>      * @param string $path
            foreach (array_reverse($this->callStack) as $call) {
>      *
                if ($all || (isset($call['n']) && $call['n'])) {
>      * @return string[]
                    $msg = "#" . $ncall++ . " " . $call['n'] . " ";
>      */
                    $msg .= (isset($this->sourceNames[$call[Parser::SOURCE_INDEX]])
>     private function tryImportPath($path)
                          ? $this->sourceNames[$call[Parser::SOURCE_INDEX]]
>     {
                          : '(unknown file)');
>         $partial = dirname($path).'/_'.basename($path);
                    $msg .= " on line " . $call[Parser::SOURCE_LINE];
> 

>         $candidates = [];
                    $callStackMsg[] = $msg;
> 

>         if (is_file($partial)) {
                    if (! is_null($limit) && $ncall > $limit) {
>             $candidates[] = $partial;
                        break;
>         }
                    }
> 
                }
>         if (is_file($path)) {
            }
>             $candidates[] = $path;
        }
>         }

> 
        return implode("\n", $callStackMsg);
>         return $candidates;
    }
>     }

> 
    /**
>     /**
     * Handle import loop
>      * @param string $path
     *
>      *
     * @param string $name
>      * @return string|null
     *
>      */
     * @throws \Exception
>     private function tryImportPathAsDirectory($path)
     */
>     {
    protected function handleImportLoop($name)
>         if (!is_dir($path)) {


    {

>         return $this->checkImportPathConflicts($this->tryImportPathWithExtensions($path.'/index'));
        for ($env = $this->env; $env; $env = $env->parent) {
>     }
            if (! $env->block) {
> 
                continue;
>     /**
            }
>      * @param string|null $path

>      *
            $file = $this->sourceNames[$env->block->sourceIndex];
>      * @return string

>      */
            if (realpath($file) === $name) {
>     private function getPrettyPath($path)
                $this->throwError('An @import loop has been found: %s imports %s', $file, basename($file));
>     {
                break;
>         if ($path === null) {
            }
>             return '(unknown file)';
        }
>         }
    }
> 

>         $normalizedPath = $path;
    /**
>         $normalizedRootDirectory = $this->rootDirectory.'/';
     * Call SCSS @function
> 
     *
>         if (\DIRECTORY_SEPARATOR === '\\') {
     * @param string $name
>             $normalizedRootDirectory = str_replace('\\', '/', $normalizedRootDirectory);
     * @param array  $argValues
>             $normalizedPath = str_replace('\\', '/', $path);
     * @param array  $returnValue
>         }
     *
> 
     * @return boolean Returns true if returnValue is set; otherwise, false
>         if (0 === strpos($normalizedPath, $normalizedRootDirectory)) {
     */
>             return substr($path, \strlen($normalizedRootDirectory));
    protected function callScssFunction($name, $argValues, &$returnValue)
>         }
    {
> 
        $func = $this->get(static::$namespaces['function'] . $name, false);
>         return $path;

>     }
        if (! $func) {
> 



<      * @param string $encoding



>      * @param string|null $encoding
>      *
>      * @return void
>      *
>      * @deprecated Non-compliant support for other encodings than UTF-8 is deprecated.


        }

>         if (!$encoding || strtolower($encoding) === 'utf-8') {

>             @trigger_error(sprintf('The "%s" method is deprecated.', __METHOD__), E_USER_DEPRECATED);
        $this->pushEnv();
>         } else {

>             @trigger_error(sprintf('The "%s" method is deprecated. Parsing will only support UTF-8 in ScssPhp 2.0. The non-UTF-8 parsing of ScssPhp 1.x is not spec compliant.', __METHOD__), E_USER_DEPRECATED);
        $storeEnv = $this->storeEnv;
>         }
        $this->storeEnv = $this->env;
> 



<      * @param boolean $ignoreErrors



>      * @param bool $ignoreErrors


        // set the args

>      *
        if (isset($func->args)) {
>      * @deprecated Ignoring Sass errors is not longer supported.



<         $this->ignoreErrors = $ignoreErrors;



>         @trigger_error('Ignoring Sass errors is not longer supported.', E_USER_DEPRECATED);


        }

>      * Get source position

>      *
        // throw away lines and children
>      * @api
        $tmp = new OutputBlock;
>      *
        $tmp->lines    = [];
>      * @return array
        $tmp->children = [];
>      *

>      * @deprecated
        $this->env->marker = 'function';
>      */
        if (! empty($func->parentEnv)) {
>     public function getSourcePosition()
            $this->env->declarationScopeParent = $func->parentEnv;
>     {
        } else {
>         @trigger_error(sprintf('The "%s" method is deprecated.', __METHOD__), E_USER_DEPRECATED);
            $this->throwError("@function $name() without parentEnv");
> 
        }
>         $sourceFile = isset($this->sourceNames[$this->sourceIndex]) ? $this->sourceNames[$this->sourceIndex] : '';

> 
        $ret = $this->compileChildren($func->children, $tmp, $this->env->marker . " " . $name);
>         return [$sourceFile, $this->sourceLine, $this->sourceColumn];

>     }
        $this->storeEnv = $storeEnv;
> 

>     /**


        $this->popEnv();

>      * @return never

>      *


        $returnValue = ! isset($ret) ? static::$defaultValue : $ret;

>      *

>      * @deprecated use "error" and throw the exception in the caller instead.



<         if ($this->ignoreErrors) {
<             return;



>         @trigger_error(
>             'The method "throwError" is deprecated. Use "error" and throw the exception in the caller instead',
>             E_USER_DEPRECATED
>         );
> 
>         throw $this->error(...func_get_args());




>     /**
    /**
>      * Build an error (exception)
     * Call built-in and registered (PHP) functions
>      *
     *
>      * @internal
     * @param string $name
>      *
     * @param array  $args
>      * @param string                     $msg Message with optional sprintf()-style vararg parameters
     * @param array  $returnValue
>      * @param bool|float|int|string|null ...$args
     *
>      *
     * @return boolean Returns true if returnValue is set; otherwise, false
>      * @return CompilerException
     */
>      */
    protected function callNativeFunction($name, $args, &$returnValue)
>     public function error($msg, ...$args)
    {
>     {
        // try a lib function
>         if ($args) {
        $name = $this->normalizeName($name);
>             $msg = sprintf($msg, ...$args);

>         }
        if (isset($this->userFunctions[$name])) {
> 
            // see if we can find a user function
>         if (! $this->ignoreCallStackMessage) {
            list($f, $prototype) = $this->userFunctions[$name];
>             $msg = $this->addLocationToMessage($msg);
        } elseif (($f = $this->getBuiltinFunction($name)) && is_callable($f)) {
>         }
            $libName   = $f[1];
> 
            $prototype = isset(static::$$libName) ? static::$$libName : null;
>         return new CompilerException($msg);
        } else {
>     }
            return false;
> 
        }
>     /**

>      * @param string $msg
        @list($sorted, $kwargs) = $this->sortNativeFunctionArgs($libName, $prototype, $args);
>      *

>      * @return string
        if ($name !== 'if' && $name !== 'call') {
>      */
            $inExp = true;
>     private function addLocationToMessage($msg)

>     {



<              ? $this->sourceNames[$this->sourceIndex] . " on line $line, at column $column"



>             ? $this->getPrettyPath($this->sourceNames[$this->sourceIndex]) . " on line $line, at column $column"



<         if (func_num_args() > 1) {
<             $msg = call_user_func_array('sprintf', func_get_args());
<         }
< 



<         throw new CompilerException($msg);



>         return $msg;
>     }
> 
>     /**
>      * @param string $functionName
>      * @param array $ExpectedArgs
>      * @param int $nbActual
>      * @return CompilerException
>      *
>      * @deprecated
>      */
>     public function errorArgsNumber($functionName, $ExpectedArgs, $nbActual)
>     {
>         @trigger_error(sprintf('The "%s" method is deprecated.', __METHOD__), E_USER_DEPRECATED);
> 
>         $nbExpected = \count($ExpectedArgs);
> 
>         if ($nbActual > $nbExpected) {
>             return $this->error(
>                 'Error: Only %d arguments allowed in %s(), but %d were passed.',
>                 $nbExpected,
>                 $functionName,
>                 $nbActual
>             );
>         } else {
>             $missing = [];
> 
>             while (count($ExpectedArgs) && count($ExpectedArgs) > $nbActual) {
>                 array_unshift($missing, array_pop($ExpectedArgs));
>             }
> 
>             return $this->error(
>                 'Error: %s() argument%s %s missing.',
>                 $functionName,
>                 count($missing) > 1 ? 's' : '',
>                 implode(', ', $missing)
>             );
>         }



<      * @param boolean $all
<      * @param null    $limit



>      * @param bool     $all
>      * @param int|null $limit



<                     $msg = "#" . $ncall++ . " " . $call['n'] . " ";



>                     $msg = '#' . $ncall++ . ' ' . $call['n'] . ' ';



<                           ? $this->sourceNames[$call[Parser::SOURCE_INDEX]]



>                           ? $this->getPrettyPath($this->sourceNames[$call[Parser::SOURCE_INDEX]])



<                     $msg .= " on line " . $call[Parser::SOURCE_LINE];



>                     $msg .= ' on line ' . $call[Parser::SOURCE_LINE];



<                     if (! is_null($limit) && $ncall > $limit) {



>                     if (! \is_null($limit) && $ncall > $limit) {


            return false;

>      * @return void
        }
>      *




>             if ($file === null) {
        $returnValue = $this->coerceValue($returnValue);
>                 continue;

>             }
        return true;
> 



<                 $this->throwError('An @import loop has been found: %s imports %s', $file, basename($file));
<                 break;



>                 throw $this->error('An @import loop has been found: %s imports %s', $file, basename($file));



<      * @param string $name



>      * @param CallableBlock|null $func



<      * @param array  $returnValue



<      * @return boolean Returns true if returnValue is set; otherwise, false



>      * @return array|Number



<     protected function callScssFunction($name, $argValues, &$returnValue)



>     protected function callScssFunction($func, $argValues)



<         $func = $this->get(static::$namespaces['function'] . $name, false);
< 



<             return false;



>             return static::$defaultValue;


    protected function getBuiltinFunction($name)

>         $name = $func->name;



<         $storeEnv = $this->storeEnv;
<         $this->storeEnv = $this->env;
< 



<         $tmp = new OutputBlock;



>         $tmp = new OutputBlock();


                return ucfirst($m[1]);

> 



<             $this->throwError("@function $name() without parentEnv");



>             throw $this->error("@function $name() without parentEnv");



<         $ret = $this->compileChildren($func->children, $tmp, $this->env->marker . " " . $name);
< 
<         $this->storeEnv = $storeEnv;



>         $ret = $this->compileChildren($func->children, $tmp, $this->env->marker . ' ' . $name);



<         $returnValue = ! isset($ret) ? static::$defaultValue : $ret;
< 
<         return true;



>         return ! isset($ret) ? static::$defaultValue : $ret;


    /**

>      * @param callable $function
     * Sorts keyword arguments
>      * @param array  $prototype



<      * @param array  $returnValue



<      * @return boolean Returns true if returnValue is set; otherwise, false



>      * @return array|Number|null



<     protected function callNativeFunction($name, $args, &$returnValue)



>     protected function callNativeFunction($name, $function, $prototype, $args)



<         // try a lib function
<         $name = $this->normalizeName($name);
< 
<         if (isset($this->userFunctions[$name])) {
<             // see if we can find a user function
<             list($f, $prototype) = $this->userFunctions[$name];
<         } elseif (($f = $this->getBuiltinFunction($name)) && is_callable($f)) {
<             $libName   = $f[1];
<             $prototype = isset(static::$$libName) ? static::$$libName : null;
<         } else {
<             return false;
<         }



>         $libName = (is_array($function) ? end($function) : null);
>         $sorted_kwargs = $this->sortNativeFunctionArgs($libName, $prototype, $args);



<         @list($sorted, $kwargs) = $this->sortNativeFunctionArgs($libName, $prototype, $args);
< 
<         if ($name !== 'if' && $name !== 'call') {
<             $inExp = true;
< 
<             if ($name === 'join') {
<                 $inExp = false;



>         if (\is_null($sorted_kwargs)) {
>             return null;


                    $posArgs[] = empty($arg[2]) ? $value : $arg;

>         @list($sorted, $kwargs) = $sorted_kwargs;


                } else {

>         if ($name !== 'if') {



<                 $val = $this->reduce($val, $inExp);



>                 if ($val !== null) {
>                     $val = $this->reduce($val, true);
>                 }



<         $returnValue = call_user_func($f, $sorted, $kwargs);



>         $returnValue = \call_user_func($function, $sorted, $kwargs);



<             return false;



>             return null;



<         $returnValue = $this->coerceValue($returnValue);



>         if (\is_array($returnValue) || $returnValue instanceof Number) {
>             return $returnValue;
>         }



<         return true;



>         @trigger_error(sprintf('Returning a PHP value from the "%s" custom function is deprecated. A sass value must be returned instead.', $name), E_USER_DEPRECATED);
> 
>         return $this->coerceValue($returnValue);


        }

>         $libName = self::normalizeNativeFunctionName($name);

>         return [$this, $libName];
        // specific cases ?
>     }
        if (in_array($functionName, ['libRgb', 'libRgba', 'libHsl', 'libHsla'])) {
> 
            // notation 100 127 255 / 0 is in fact a simple list of 4 values
>     /**
            foreach ($args as $k => $arg) {
>      * Normalize native function name
                if ($arg[1][0] === Type::T_LIST && count($arg[1][2]) === 3) {
>      *
                    $last = end($arg[1][2]);
>      * @internal

>      *
                    if ($last[0] === Type::T_EXPRESSION && $last[1] === '/') {
>      * @param string $name
                        array_pop($arg[1][2]);
>      *
                        $arg[1][2][] = $last[2];
>      * @return string
                        $arg[1][2][] = $last[3];
>      */
                        $args[$k] = $arg;
>     public static function normalizeNativeFunctionName($name)
                    }
>     {
                }
>         $name = str_replace("-", "_", $name);


            }

>         return $libName;
        }
>     }



<         return [$this, $libName];



>     /**
>      * Check if a function is a native built-in scss function, for css parsing
>      *
>      * @internal
>      *
>      * @param string $name
>      *
>      * @return bool
>      */
>     public static function isNativeFunction($name)
>     {
>         return method_exists(Compiler::class, self::normalizeNativeFunctionName($name));



<      * @param array  $prototypes



>      * @param array|null  $prototypes



<      * @return array



>      * @return array|null


        if (! is_array(reset($prototypes))) {

>             if (\is_array($args) && \count($args) && \end($args) === static::$null) {
            $prototypes = [$prototypes];
>                 array_pop($args);
        }
>             }

> 



<                 $key = $key[1];
< 
<                 if (empty($key)) {



>                 if (empty($key) or empty($key[1])) {



<                     $keyArgs[$key] = $value;



>                     $keyArgs[$key[1]] = $value;



<         if (in_array($functionName, ['libRgb', 'libRgba', 'libHsl', 'libHsla'])) {



>         if (\in_array($functionName, ['libRgb', 'libRgba', 'libHsl', 'libHsla'])) {



<                 if ($arg[1][0] === Type::T_LIST && count($arg[1][2]) === 3) {
<                     $last = end($arg[1][2]);
< 
<                     if ($last[0] === Type::T_EXPRESSION && $last[1] === '/') {
<                         array_pop($arg[1][2]);
<                         $arg[1][2][] = $last[2];
<                         $arg[1][2][] = $last[3];
<                         $args[$k] = $arg;



>                 if (!isset($arg[1])) {
>                     continue; // This happens when using a trailing comma




>                 if ($arg[1][0] === Type::T_LIST && \count($arg[1][2]) === 3) {
                if (count($p)) {
>                     $args[$k][1][2] = $this->extractSlashAlphaInColorFunction($arg[1][2]);



<         $finalArgs = [];



>         list($positionalArgs, $namedArgs, $names, $separator, $hasSplat) = $this->evaluateArguments($args, false);



<         if (! is_array(reset($prototypes))) {



>         if (! \is_array(reset($prototypes))) {


                    if ($p === 'null') {

>         $parsedPrototypes = array_map([$this, 'parseFunctionPrototype'], $prototypes);
                        // differentiate this null from the static::$null
>         assert(!empty($parsedPrototypes));
                        $default = [Type::T_KEYWORD, 'null'];
>         $matchedPrototype = $this->selectFunctionPrototype($parsedPrototypes, \count($positionalArgs), $names);
                    } else {
> 
                        if (is_null($parser)) {
>         $this->verifyPrototype($matchedPrototype, \count($positionalArgs), $names, $hasSplat);
                            $parser = $this->parserFactory(__METHOD__);
> 
                        }
>         $vars = $this->applyArgumentsToDeclaration($matchedPrototype, $positionalArgs, $namedArgs, $separator);

> 
                        $parser->parseValue($p, $default);
>         $finalArgs = [];



<         // trying each prototypes
<         $prototypeHasMatch = false;
<         $exceptionMessage = '';



>         foreach ($matchedPrototype['arguments'] as $argument) {
>             list($normalizedName, $originalName, $default) = $argument;



<         foreach ($prototypes as $prototype) {
<             $argDef = [];



>             if (isset($vars[$normalizedName])) {
>                 $value = $vars[$normalizedName];
>             } else {
>                 $value = $default;
>             }
> 
>             // special null value as default: translate to real null here
>             if ($value === [Type::T_KEYWORD, 'null']) {
>                 $value = null;
>             }
> 
>             $finalArgs[] = $value;
>             $keyArgs[$originalName] = $value;
>         }
> 
>         if ($matchedPrototype['rest_argument'] !== null) {
>             $value = $vars[$matchedPrototype['rest_argument']];
> 
>             $finalArgs[] = $value;
>             $keyArgs[$matchedPrototype['rest_argument']] = $value;
>         }
> 
>         return [$finalArgs, $keyArgs];
>     }
> 
>     /**
>      * Parses a function prototype to the internal representation of arguments.
>      *
>      * The input is an array of strings describing each argument, as supported
>      * in {@see registerFunction}. Argument names don't include the `$`.
>      * The output contains the list of positional argument, with their normalized
>      * name (underscores are replaced by dashes), their original name (to be used
>      * in case of error reporting) and their default value. The output also contains
>      * the normalized name of the rest argument, or null if the function prototype
>      * is not variadic.
>      *
>      * @param string[] $prototype
>      *
>      * @return array
>      * @phpstan-return array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null}
>      */
>     private function parseFunctionPrototype(array $prototype)
>     {
>         static $parser = null;
> 
>         $arguments = [];
>         $restArgument = null;
> 
>         foreach ($prototype as $p) {
>             if (null !== $restArgument) {
>                 throw new \InvalidArgumentException('The argument declaration is invalid. The rest argument must be the last one.');
>             }



<             foreach ($prototype as $i => $p) {



<                 $name    = array_shift($p);



>             $name = str_replace('_', '-', $p[0]);



<                 if (count($p)) {
<                     $p = trim(reset($p));



>             if (isset($p[1])) {
>                 $defaultSource = trim($p[1]);



<                     if ($p === 'null') {



>                 if ($defaultSource === 'null') {



<                         if (is_null($parser)) {



>                     if (\is_null($parser)) {



<                         $parser->parseValue($p, $default);



>                     $parser->parseValue($defaultSource, $default);



<                 $isVariable = false;
< 



<                     $isVariable = true;
<                     $name = substr($name, 0, -3);



>                 $restArgument = substr($name, 0, -3);
>             } else {
>                 $arguments[] = [$name, $p[0], $default];
>             }



<                 $argDef[] = [$name, $default, $isVariable];



>         return [
>             'arguments' => $arguments,
>             'rest_argument' => $restArgument,
>         ];



<             try {
<                 $vars = $this->applyArguments($argDef, $args, false, false);



>     /**
>      * Returns the function prototype for the given positional and named arguments.
>      *
>      * If no exact match is found, finds the closest approximation. Note that this
>      * doesn't guarantee that $positional and $names are valid for the returned
>      * prototype.
>      *
>      * @param array[]               $prototypes
>      * @param int                   $positional
>      * @param array<string, string> $names A set of names, as both keys and values
>      *
>      * @return array
>      *
>      * @phpstan-param non-empty-list<array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null}> $prototypes
>      * @phpstan-return array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null}
>      */
>     private function selectFunctionPrototype(array $prototypes, $positional, array $names)
>     {
>         $fuzzyMatch = null;
>         $minMismatchDistance = null;
> 
>         foreach ($prototypes as $prototype) {
>             // Ideally, find an exact match.
>             if ($this->checkPrototypeMatches($prototype, $positional, $names)) {
>                 return $prototype;
>             }



<                 // ensure all args are populated
<                 foreach ($prototype as $i => $p) {
<                     $name = explode(':', $p)[0];



>             $mismatchDistance = \count($prototype['arguments']) - $positional;



<                     if (! isset($finalArgs[$i])) {
<                         $finalArgs[$i] = null;



>             if ($minMismatchDistance !== null) {
>                 if (abs($mismatchDistance) > abs($minMismatchDistance)) {
>                     continue;
>                 }
> 
>                 // If two overloads have the same mismatch distance, favor the overload
>                 // that has more arguments.
>                 if (abs($mismatchDistance) === abs($minMismatchDistance) && $mismatchDistance < 0) {
>                     continue;




<                 // apply positional args
<                 foreach (array_values($vars) as $i => $val) {
<                     $finalArgs[$i] = $val;



>             $minMismatchDistance = $mismatchDistance;
>             $fuzzyMatch = $prototype;


                }


<                 $keyArgs = array_merge($keyArgs, $vars);
<                 $prototypeHasMatch = true;



>         return $fuzzyMatch;
>     }




<                 // overwrite positional args with keyword args
<                 foreach ($prototype as $i => $p) {
<                     $name = explode(':', $p)[0];



>     /**
>      * Checks whether the argument invocation matches the callable prototype.
>      *
>      * The rules are similar to {@see verifyPrototype}. The boolean return value
>      * avoids the overhead of building and catching exceptions when the reason of
>      * not matching the prototype does not need to be known.
>      *
>      * @param array                 $prototype
>      * @param int                   $positional
>      * @param array<string, string> $names
>      *
>      * @return bool
>      *
>      * @phpstan-param array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null} $prototype
>      */
>     private function checkPrototypeMatches(array $prototype, $positional, array $names)
>     {
>         $nameUsed = 0;




<                     if (isset($keyArgs[$name])) {
<                         $finalArgs[$i] = $keyArgs[$name];
<                     }



>         foreach ($prototype['arguments'] as $i => $argument) {
>             list ($name, $originalName, $default) = $argument;




<                     // special null value as default: translate to real null here
<                     if ($finalArgs[$i] === [Type::T_KEYWORD, 'null']) {
<                         $finalArgs[$i] = null;



>             if ($i < $positional) {
>                 if (isset($names[$name])) {
>                     return false;


                    }

>             } elseif (isset($names[$name])) {
                }
>                 $nameUsed++;
                // should we break if this prototype seems fulfilled?
>             } elseif ($default === null) {
            } catch (CompilerException $e) {
>                 return false;



<                 // should we break if this prototype seems fulfilled?
<             } catch (CompilerException $e) {
<                 $exceptionMessage = $e->getMessage();




> 
        if ($exceptionMessage && ! $prototypeHasMatch) {
>         if ($prototype['rest_argument'] !== null) {
            $this->throwError($exceptionMessage);
>             return true;



<         if ($exceptionMessage && ! $prototypeHasMatch) {
<             $this->throwError($exceptionMessage);



>         if ($positional > \count($prototype['arguments'])) {
>             return false;



<         return [$finalArgs, $keyArgs];



>         if ($nameUsed < \count($names)) {
>             return false;
>         }
> 
>         return true;


    }

    /**

<      * Apply argument values per definition



>      * Verifies that the argument invocation is valid for the callable prototype.


     *

<      * @param array   $argDef
<      * @param array   $argValues
<      * @param boolean $storeInEnv
<      * @param boolean $reduce
<      *   only used if $storeInEnv = false



>      * @param array                 $prototype
>      * @param int                   $positional
>      * @param array<string, string> $names
>      * @param bool                  $hasSplat


     *

<      * @return array



>      * @return void


     *

<      * @throws \Exception



>      * @throws SassScriptException
>      *
>      * @phpstan-param array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null} $prototype


     */

<     protected function applyArguments($argDef, $argValues, $storeInEnv = true, $reduce = true)



>     private function verifyPrototype(array $prototype, $positional, array $names, $hasSplat)


    {

<         $output = [];
<         if (is_array($argValues) && count($argValues) && end($argValues) === static::$null) {
<             array_pop($argValues);
<         }



>         $nameUsed = 0;




<         if ($storeInEnv) {
<             $storeEnv = $this->getStoreEnv();



>         foreach ($prototype['arguments'] as $i => $argument) {
>             list ($name, $originalName, $default) = $argument;




<             $env = new Environment;
<             $env->store = $storeEnv->store;



>             if ($i < $positional) {
>                 if (isset($names[$name])) {
>                     throw new SassScriptException(sprintf('Argument $%s was passed both by position and by name.', $originalName));
>                 }
>             } elseif (isset($names[$name])) {
>                 $nameUsed++;
>             } elseif ($default === null) {
>                 throw new SassScriptException(sprintf('Missing argument $%s', $originalName));
>             }


        }


<         $hasVariable = false;
<         $args = [];



>         if ($prototype['rest_argument'] !== null) {
>             return;
>         }




<         foreach ($argDef as $i => $arg) {
<             list($name, $default, $isVariable) = $argDef[$i];



>         if ($positional > \count($prototype['arguments'])) {
>             $message = sprintf(
>                 'Only %d %sargument%s allowed, but %d %s passed.',
>                 \count($prototype['arguments']),
>                 empty($names) ? '' : 'positional ',
>                 \count($prototype['arguments']) === 1 ? '' : 's',
>                 $positional,
>                 $positional === 1 ? 'was' : 'were'
>             );
>             if (!$hasSplat) {
>                 throw new SassScriptException($message);
>             }
> 
>             $message = $this->addLocationToMessage($message);
>             $message .= "\nThis will be an error in future versions of Sass.";
>             $this->logger->warn($message, true);
>         }
> 
>         if ($nameUsed < \count($names)) {
>             $unknownNames = array_values(array_diff($names, array_column($prototype['arguments'], 0)));
>             $lastName = array_pop($unknownNames);
>             $message = sprintf(
>                 'No argument%s named $%s%s.',
>                 $unknownNames ? 's' : '',
>                 $unknownNames ? implode(', $', $unknownNames) . ' or $' : '',
>                 $lastName
>             );
>             throw new SassScriptException($message);
>         }
>     }




<             $args[$name] = [$i, $name, $default, $isVariable];
<             $hasVariable |= $isVariable;



>     /**
>      * Evaluates the argument from the invocation.
>      *
>      * This returns several things about this invocation:
>      * - the list of positional arguments
>      * - the map of named arguments, indexed by normalized names
>      * - the set of names used in the arguments (that's an array using the normalized names as keys for O(1) access)
>      * - the separator used by the list using the splat operator, if any
>      * - a boolean indicator whether any splat argument (list or map) was used, to support the incomplete error reporting.
>      *
>      * @param array[] $args
>      * @param bool    $reduce Whether arguments should be reduced to their value
>      *
>      * @return array
>      *
>      * @throws SassScriptException
>      *
>      * @phpstan-return array{0: list<array|Number>, 1: array<string, array|Number>, 2: array<string, string>, 3: string|null, 4: bool}
>      */
>     private function evaluateArguments(array $args, $reduce = true)
>     {
>         // this represents trailing commas
>         if (\count($args) && end($args) === static::$null) {
>             array_pop($args);


        }

        $splatSeparator      = null;
        $keywordArgs         = [];

<         $deferredKeywordArgs = [];
<         $remaining           = [];



>         $names = [];
>         $positionalArgs = [];


        $hasKeywordArgument  = false;

>         $hasSplat = false;




<         // assign the keyword args
<         foreach ((array) $argValues as $arg) {



>         foreach ($args as $arg) {


            if (! empty($arg[0])) {
                $hasKeywordArgument = true;


<                 $name = $arg[0][1];
<                 if (! isset($args[$name])) {
<                     foreach (array_keys($args) as $an) {
<                         if (str_replace("_", "-", $an) === str_replace("_", "-", $name)) {
<                             $name = $an;
<                             break;
<                         }
<                     }
<                 }
<                 if (! isset($args[$name]) || $args[$name][3]) {
<                     if ($hasVariable) {
<                         $deferredKeywordArgs[$name] = $arg[1];
<                     } else {
<                         $this->throwError("Mixin or function doesn't have an argument named $%s.", $arg[0][1]);
<                         break;
<                     }
<                 } elseif ($args[$name][0] < count($remaining)) {
<                     $this->throwError("The argument $%s was passed both by position and by name.", $arg[0][1]);
<                     break;
<                 } else {
<                     $keywordArgs[$name] = $arg[1];



>                 assert(\is_string($arg[0][1]));
>                 $name = str_replace('_', '-', $arg[0][1]);
> 
>                 if (isset($keywordArgs[$name])) {
>                     throw new SassScriptException(sprintf('Duplicate named argument $%s.', $arg[0][1]));


                }

<             } elseif ($arg[2] === true) {



> 
>                 $keywordArgs[$name] = $this->maybeReduce($reduce, $arg[1]);
>                 $names[$name] = $name;
>             } elseif (! empty($arg[2])) {
>                 // $arg[2] means a var followed by ... in the arg ($list... )


                $val = $this->reduce($arg[1], true);

>                 $hasSplat = true;



                if ($val[0] === Type::T_LIST) {

<                     foreach ($val[2] as $name => $item) {
<                         if (! is_numeric($name)) {
<                             if (! isset($args[$name])) {
<                                 foreach (array_keys($args) as $an) {
<                                     if (str_replace("_", "-", $an) === str_replace("_", "-", $name)) {
<                                         $name = $an;
<                                         break;
<                                     }
<                                 }



>                     foreach ($val[2] as $item) {
>                         if (\is_null($splatSeparator)) {
>                             $splatSeparator = $val[1];


                            }


<                             if ($hasVariable) {
<                                 $deferredKeywordArgs[$name] = $item;
<                             } else {
<                                 $keywordArgs[$name] = $item;



>                         $positionalArgs[] = $this->maybeReduce($reduce, $item);


                            }

<                         } else {
<                             if (is_null($splatSeparator)) {
<                                 $splatSeparator = $val[1];



> 
>                     if (isset($val[3]) && \is_array($val[3])) {
>                         foreach ($val[3] as $name => $item) {
>                             assert(\is_string($name));
> 
>                             $normalizedName = str_replace('_', '-', $name);
> 
>                             if (isset($keywordArgs[$normalizedName])) {
>                                 throw new SassScriptException(sprintf('Duplicate named argument $%s.', $name));


                            }


<                             $remaining[] = $item;



>                             $keywordArgs[$normalizedName] = $this->maybeReduce($reduce, $item);
>                             $names[$normalizedName] = $normalizedName;
>                             $hasKeywordArgument = true;


                        }
                    }
                } elseif ($val[0] === Type::T_MAP) {
                    foreach ($val[1] as $i => $name) {
                        $name = $this->compileStringContent($this->coerceString($name));
                        $item = $val[2][$i];

                        if (! is_numeric($name)) {

<                             if (! isset($args[$name])) {
<                                 foreach (array_keys($args) as $an) {
<                                     if (str_replace("_", "-", $an) === str_replace("_", "-", $name)) {
<                                         $name = $an;
<                                         break;
<                                     }
<                                 }
<                             }



>                             $normalizedName = str_replace('_', '-', $name);




<                             if ($hasVariable) {
<                                 $deferredKeywordArgs[$name] = $item;
<                             } else {
<                                 $keywordArgs[$name] = $item;



>                             if (isset($keywordArgs[$normalizedName])) {
>                                 throw new SassScriptException(sprintf('Duplicate named argument $%s.', $name));


                            }

> 
                        } else {
>                             $keywordArgs[$normalizedName] = $this->maybeReduce($reduce, $item);
                            if (is_null($splatSeparator)) {
>                             $names[$normalizedName] = $normalizedName;
                                $splatSeparator = $val[1];
>                             $hasKeywordArgument = true;



<                             if (is_null($splatSeparator)) {



>                             if (\is_null($splatSeparator)) {




<                             $remaining[] = $item;



>                             $positionalArgs[] = $this->maybeReduce($reduce, $item);


                        }
                    }

<                 } else {
<                     $remaining[] = $val;



>                 } elseif ($val[0] !== Type::T_NULL) { // values other than null are treated a single-element lists, while null is the empty list
>                     $positionalArgs[] = $this->maybeReduce($reduce, $val);


                }
            } elseif ($hasKeywordArgument) {

<                 $this->throwError('Positional arguments must come before keyword arguments.');
<                 break;



>                 throw new SassScriptException('Positional arguments must come before keyword arguments.');


            } else {

<                 $remaining[] = $arg[1];



>                 $positionalArgs[] = $this->maybeReduce($reduce, $arg[1]);


            }
        }


<         foreach ($args as $arg) {
<             list($i, $name, $default, $isVariable) = $arg;



>         return [$positionalArgs, $keywordArgs, $names, $splatSeparator, $hasSplat];
>     }




<             if ($isVariable) {
<                 $val = [Type::T_LIST, is_null($splatSeparator) ? ',' : $splatSeparator , [], $isVariable];



>     /**
>      * @param bool         $reduce
>      * @param array|Number $value
>      *
>      * @return array|Number
>      */
>     private function maybeReduce($reduce, $value)
>     {
>         if ($reduce) {
>             return $this->reduce($value, true);
>         }
> 
>         return $value;
>     }




<                 for ($count = count($remaining); $i < $count; $i++) {
<                     $val[2][] = $remaining[$i];



>     /**
>      * Apply argument values per definition
>      *
>      * @param array[]    $argDef
>      * @param array|null $argValues
>      * @param bool       $storeInEnv
>      * @param bool       $reduce     only used if $storeInEnv = false
>      *
>      * @return array<string, array|Number>
>      *
>      * @phpstan-param list<array{0: string, 1: array|Number|null, 2: bool}> $argDef
>      *
>      * @throws \Exception
>      */
>     protected function applyArguments($argDef, $argValues, $storeInEnv = true, $reduce = true)
>     {
>         $output = [];
> 
>         if (\is_null($argValues)) {
>             $argValues = [];


                }


<                 foreach ($deferredKeywordArgs as $itemName => $item) {
<                     $val[2][$itemName] = $item;



>         if ($storeInEnv) {
>             $storeEnv = $this->getStoreEnv();
> 
>             $env = new Environment();
>             $env->store = $storeEnv->store;


                }

<             } elseif (isset($remaining[$i])) {
<                 $val = $remaining[$i];
<             } elseif (isset($keywordArgs[$name])) {
<                 $val = $keywordArgs[$name];
<             } elseif (! empty($default)) {



> 
>         $prototype = ['arguments' => [], 'rest_argument' => null];
>         $originalRestArgumentName = null;
> 
>         foreach ($argDef as $arg) {
>             list($name, $default, $isVariable) = $arg;
>             $normalizedName = str_replace('_', '-', $name);
> 
>             if ($isVariable) {
>                 $originalRestArgumentName = $name;
>                 $prototype['rest_argument'] = $normalizedName;
>             } else {
>                 $prototype['arguments'][] = [$normalizedName, $name, !empty($default) ? $default : null];
>             }
>         }
> 
>         list($positionalArgs, $namedArgs, $names, $splatSeparator, $hasSplat) = $this->evaluateArguments($argValues, $reduce);
> 
>         $this->verifyPrototype($prototype, \count($positionalArgs), $names, $hasSplat);
> 
>         $vars = $this->applyArgumentsToDeclaration($prototype, $positionalArgs, $namedArgs, $splatSeparator);
> 
>         foreach ($prototype['arguments'] as $argument) {
>             list($normalizedName, $name) = $argument;
> 
>             if (!isset($vars[$normalizedName])) {


                continue;

>             }
            } else {
> 
                $this->throwError("Missing argument $name");
>             $val = $vars[$normalizedName];
                break;
> 
            }
>             if ($storeInEnv) {

>                 $this->set($name, $this->reduce($val, true), true, $env);



<                 $this->throwError("Missing argument $name");
<                 break;



>                 $output[$name] = ($reduce ? $this->reduce($val, true) : $val);
>             }


            } else {

>         if ($prototype['rest_argument'] !== null) {
                $output[$name] = ($reduce ? $this->reduce($val, true) : $val);
>             assert($originalRestArgumentName !== null);
            }
>             $name = $originalRestArgumentName;
        }
>             $val = $vars[$prototype['rest_argument']];

> 


        if ($storeInEnv) {
            $storeEnv->store = $env->store;
        }


<         foreach ($args as $arg) {
<             list($i, $name, $default, $isVariable) = $arg;



>         foreach ($prototype['arguments'] as $argument) {
>             list($normalizedName, $name, $default) = $argument;




<             if ($isVariable || isset($remaining[$i]) || isset($keywordArgs[$name]) || empty($default)) {



>             if (isset($vars[$normalizedName])) {


                continue;
            }

>             assert($default !== null);



            if ($storeInEnv) {
                $this->set($name, $this->reduce($default, true), true);
            } else {
                $output[$name] = ($reduce ? $this->reduce($default, true) : $default);
            }
        }

        return $output;
    }

    /**

>      * Apply argument values per definition.
     * Coerce a php value into a scss one
>      *
     *
>      * This method assumes that the arguments are valid for the provided prototype.
     * @param mixed $value
>      * The validation with {@see verifyPrototype} must have been run before calling
     *
>      * it.
     * @return array|\ScssPhp\ScssPhp\Node\Number
>      * Arguments are returned as a map from the normalized argument names to the
     */
>      * value. Additional arguments are collected in a sass argument list available
    protected function coerceValue($value)
>      * under the name of the rest argument in the result.
    {
>      *
        if (is_array($value) || $value instanceof \ArrayAccess) {
>      * Defaults are not applied as they are resolved in a different environment.
            return $value;
>      *
        }
>      * @param array                       $prototype

>      * @param array<array|Number>         $positionalArgs
        if (is_bool($value)) {
>      * @param array<string, array|Number> $namedArgs
            return $this->toBool($value);
>      * @param string|null                 $splatSeparator
        }
>      *

>      * @return array<string, array|Number>
        if (is_null($value)) {
>      *
            return static::$null;
>      * @phpstan-param array{arguments: list<array{0: string, 1: string, 2: array|Number|null}>, rest_argument: string|null} $prototype
        }
>      */

>     private function applyArgumentsToDeclaration(array $prototype, array $positionalArgs, array $namedArgs, $splatSeparator)
        if (is_numeric($value)) {
>     {
            return new Node\Number($value, '');
>         $output = [];
        }
>         $minLength = min(\count($positionalArgs), \count($prototype['arguments']));

> 
        if ($value === '') {
>         for ($i = 0; $i < $minLength; $i++) {
            return static::$emptyString;
>             list($name) = $prototype['arguments'][$i];
        }
>             $val = $positionalArgs[$i];

> 
        $value = [Type::T_KEYWORD, $value];
>             $output[$name] = $val;
        $color = $this->coerceColor($value);
>         }

> 
        if ($color) {
>         $restNamed = $namedArgs;
            return $color;
> 
        }
>         for ($i = \count($positionalArgs); $i < \count($prototype['arguments']); $i++) {

>             $argument = $prototype['arguments'][$i];
        return $value;
>             list($name) = $argument;
    }
> 

>             if (isset($namedArgs[$name])) {
    /**
>                 $val = $namedArgs[$name];
     * Coerce something to map
>                 unset($restNamed[$name]);
     *
>             } else {
     * @param array $item
>                 continue;
     *
>             }
     * @return array
> 
     */
>             $output[$name] = $val;
    protected function coerceMap($item)
>         }
    {
> 
        if ($item[0] === Type::T_MAP) {
>         if ($prototype['rest_argument'] !== null) {
            return $item;
>             $name = $prototype['rest_argument'];
        }
>             $rest = array_values(array_slice($positionalArgs, \count($prototype['arguments'])));

> 
        if ($item[0] === static::$emptyList[0]
>             $val = [Type::T_LIST, \is_null($splatSeparator) ? ',' : $splatSeparator , $rest, $restNamed];
            && $item[1] === static::$emptyList[1]
> 
            && $item[2] === static::$emptyList[2]) {
>             $output[$name] = $val;
            return static::$emptyMap;
>         }
        }
> 

>         return $output;
        return [Type::T_MAP, [$item], [static::$null]];
>     }
    }
> 

>     /**



<      * @return array|\ScssPhp\ScssPhp\Node\Number



>      * @return array|Number



<         if (is_array($value) || $value instanceof \ArrayAccess) {



>         if (\is_array($value) || $value instanceof Number) {



<         if (is_bool($value)) {



>         if (\is_bool($value)) {



<         if (is_null($value)) {



>         if (\is_null($value)) {



<             return new Node\Number($value, '');



>             return new Number($value, '');



<      * Coerce something to map



>      * Tries to convert an item to a Sass map



<      * @param array $item



>      * @param Number|array $item



<      * @return array



>      * @return array|null



<     protected function coerceMap($item)



>     private function tryMap($item)


    {

>         if ($item instanceof Number) {
        if (isset($item) && $item[0] === Type::T_LIST) {
>             return null;
            return $item;
>         }
        }
> 



<         if ($item[0] === static::$emptyList[0]
<             && $item[1] === static::$emptyList[1]
<             && $item[2] === static::$emptyList[2]) {



>         if (
>             $item[0] === Type::T_LIST &&
>             $item[2] === []
>         ) {



<         return [Type::T_MAP, [$item], [static::$null]];



>         return null;
>     }
> 
>     /**
>      * Coerce something to map
>      *
>      * @param array|Number $item
>      *
>      * @return array|Number
>      */
>     protected function coerceMap($item)
>     {
>         $map = $this->tryMap($item);
> 
>         if ($map !== null) {
>             return $map;
>         }
> 
>         return $item;



<      * @param array  $item



>      * @param array|Number $item




>      * @param bool         $removeTrailingNull



<     protected function coerceList($item, $delim = ',')



>     protected function coerceList($item, $delim = ',', $removeTrailingNull = false)



<         if (isset($item) && $item[0] === Type::T_LIST) {



>         if ($item instanceof Number) {
>             return [Type::T_LIST, '', [$item]];
>         }
> 
>         if ($item[0] === Type::T_LIST) {
>             // remove trailing null from the list
>             if ($removeTrailingNull && end($item[2]) === static::$null) {
>                 array_pop($item[2]);
>             }
> 



<         if (isset($item) && $item[0] === Type::T_MAP) {



>         if ($item[0] === Type::T_MAP) {



<             for ($i = 0, $s = count($keys); $i < $s; $i++) {



>             for ($i = 0, $s = \count($keys); $i < $s; $i++) {



<                 switch ($key[0]) {
<                     case Type::T_LIST:
<                     case Type::T_MAP:
<                     case Type::T_STRING:
<                         break;
< 
<                     default:
<                         $key = [Type::T_KEYWORD, $this->compileStringContent($this->coerceString($key))];
<                         break;
<                 }
< 


                $list[] = [
                    Type::T_LIST,
                    '',
                    [$key, $value]
                ];
            }


<             return [Type::T_LIST, ',', $list];



>             return [Type::T_LIST, $list ? ',' : '', $list];


        }


<         return [Type::T_LIST, $delim, ! isset($item) ? []: [$item]];



>         return [Type::T_LIST, '', [$item]];


    }

    /**
     * Coerce color for expression
     *

<      * @param array $value



>      * @param array|Number $value


     *

<      * @return array|null



>      * @return array|Number


     */
    protected function coerceForExpression($value)
    {
        if ($color = $this->coerceColor($value)) {
            return $color;
        }

        return $value;
    }

    /**
     * Coerce value to color
     *

<      * @param array $value



>      * @param array|Number $value
>      * @param bool         $inRGBFunction


     *
     * @return array|null
     */
    protected function coerceColor($value, $inRGBFunction = false)
    {

>         if ($value instanceof Number) {
        switch ($value[0]) {
>             return null;
            case Type::T_COLOR:
>         }
                for ($i = 1; $i <= 3; $i++) {
> 


                    if (! is_numeric($value[$i])) {
                        $cv = $this->compileRGBAValue($value[$i]);

                        if (! is_numeric($cv)) {
                            return null;
                        }

                        $value[$i] = $cv;
                    }

                    if (isset($value[4])) {
                        if (! is_numeric($value[4])) {
                            $cv = $this->compileRGBAValue($value[4], true);

                            if (! is_numeric($cv)) {
                                return null;
                            }

                            $value[4] = $cv;
                        }
                    }
                }

                return $value;

            case Type::T_LIST:
                if ($inRGBFunction) {

<                     if (count($value[2]) == 3 || count($value[2]) == 4) {



>                     if (\count($value[2]) == 3 || \count($value[2]) == 4) {


                        $color = $value[2];
                        array_unshift($color, Type::T_COLOR);

                        return $this->coerceColor($color);
                    }
                }

                return null;

            case Type::T_KEYWORD:

<                 if (! is_string($value[1])) {



>                 if (! \is_string($value[1])) {


                    return null;
                }

                $name = strtolower($value[1]);

> 


                // hexa color?
                if (preg_match('/^#([0-9a-f]+)$/i', $name, $m)) {

<                     $nofValues = strlen($m[1]);



>                     $nofValues = \strlen($m[1]);




<                     if (in_array($nofValues, [3, 4, 6, 8])) {



>                     if (\in_array($nofValues, [3, 4, 6, 8])) {


                        $nbChannels = 3;
                        $color      = [];
                        $num        = hexdec($m[1]);

                        switch ($nofValues) {
                            case 4:
                                $nbChannels = 4;
                                // then continuing with the case 3:
                            case 3:
                                for ($i = 0; $i < $nbChannels; $i++) {
                                    $t = $num & 0xf;
                                    array_unshift($color, $t << 4 | $t);
                                    $num >>= 4;
                                }

                                break;

                            case 8:
                                $nbChannels = 4;
                                // then continuing with the case 6:
                            case 6:
                                for ($i = 0; $i < $nbChannels; $i++) {
                                    array_unshift($color, $num & 0xff);
                                    $num >>= 8;
                                }

                                break;
                        }

                        if ($nbChannels === 4) {
                            if ($color[3] === 255) {
                                $color[3] = 1; // fully opaque
                            } else {

<                                 $color[3] = round($color[3] / 255, 3);



>                                 $color[3] = round($color[3] / 255, Number::PRECISION);


                            }
                        }

                        array_unshift($color, Type::T_COLOR);

                        return $color;
                    }
                }

                if ($rgba = Colors::colorNameToRGBa($name)) {
                    return isset($rgba[3])
                        ? [Type::T_COLOR, $rgba[0], $rgba[1], $rgba[2], $rgba[3]]
                        : [Type::T_COLOR, $rgba[0], $rgba[1], $rgba[2]];
                }

                return null;
        }

        return null;
    }

    /**

<      * @param integer|\ScssPhp\ScssPhp\Node\Number $value
<      * @param boolean                              $isAlpha



>      * @param int|Number $value
>      * @param bool       $isAlpha


     *

<      * @return integer|mixed



>      * @return int|mixed


     */
    protected function compileRGBAValue($value, $isAlpha = false)
    {
        if ($isAlpha) {
            return $this->compileColorPartValue($value, 0, 1, false);
        }

        return $this->compileColorPartValue($value, 0, 255, true);
    }

    /**
     * @param mixed         $value

<      * @param integer|float $min
<      * @param integer|float $max
<      * @param boolean       $isInt
<      * @param boolean       $clamp
<      * @param boolean       $modulo



>      * @param int|float $min
>      * @param int|float $max
>      * @param bool      $isInt


     *

<      * @return integer|mixed



>      * @return int|mixed


     */

<     protected function compileColorPartValue($value, $min, $max, $isInt = true, $clamp = true, $modulo = false)



>     protected function compileColorPartValue($value, $min, $max, $isInt = true)


    {
        if (! is_numeric($value)) {

<             if (is_array($value)) {



>             if (\is_array($value)) {


                $reduced = $this->reduce($value);


<                 if (is_object($reduced) && $value->type === Type::T_NUMBER) {



>                 if ($reduced instanceof Number) {


                    $value = $reduced;
                }
            }


<             if (is_object($value) && $value->type === Type::T_NUMBER) {
<                 $num = $value->dimension;
< 
<                 if (count($value->units)) {
<                     $unit = array_keys($value->units);
<                     $unit = reset($unit);
< 
<                     switch ($unit) {
<                         case '%':
<                             $num *= $max / 100;
<                             break;
<                         default:
<                             break;
<                     }



>             if ($value instanceof Number) {
>                 if ($value->unitless()) {
>                     $num = $value->getDimension();
>                 } elseif ($value->hasUnit('%')) {
>                     $num = $max * $value->getDimension() / 100;
>                 } else {
>                     throw $this->error('Expected %s to have no units or "%%".', $value);


                }

                $value = $num;

<             } elseif (is_array($value)) {



>             } elseif (\is_array($value)) {


                $value = $this->compileValue($value);
            }
        }

        if (is_numeric($value)) {
            if ($isInt) {
                $value = round($value);
            }


<             if ($clamp) {


                $value = min($max, max($min, $value));

<             }
< 
<             if ($modulo) {
<                 $value = $value % $max;
< 
<                 // still negative?
<                 while ($value < $min) {
<                     $value += $max;
<                 }
<             }



            return $value;
        }

        return $value;
    }

    /**
     * Coerce value to string
     *

<      * @param array $value



>      * @param array|Number $value


     *

<      * @return array|null



>      * @return array


     */
    protected function coerceString($value)
    {
        if ($value[0] === Type::T_STRING) {

>             assert(\is_array($value));
            return $value;
> 


        }

        return [Type::T_STRING, '', [$this->compileValue($value)]];
    }

    /**

>      * Assert value is a string
     * Coerce value to a percentage
>      *
     *
>      * This method deals with internal implementation details of the value
     * @param array $value
>      * representation where unquoted strings can sometimes be stored under
     *
>      * other types.
     * @return integer|float
>      * The returned value is always using the T_STRING type.
     */
>      *
    protected function coercePercent($value)
>      * @api
    {
>      *
        if ($value[0] === Type::T_NUMBER) {
>      * @param array|Number $value
            if (! empty($value[2]['%'])) {
>      * @param string|null  $varName
                return $value[1] / 100;
>      *
            }
>      * @return array

>      *
            return $value[1];
>      * @throws SassScriptException
        }
>      */

>     public function assertString($value, $varName = null)
        return 0;
>     {
    }
>         // case of url(...) parsed a a function

>         if ($value[0] === Type::T_FUNCTION) {
    /**
>             $value = $this->coerceString($value);
     * Assert value is a map
>         }
     *
> 
     * @api
>         if (! \in_array($value[0], [Type::T_STRING, Type::T_KEYWORD])) {
     *
>             $value = $this->compileValue($value);
     * @param array $value
>             throw SassScriptException::forArgument("$value is not a string.", $varName);
     *
>         }
     * @return array
> 
     *
>         return $this->coerceString($value);
     * @throws \Exception
>     }
     */
> 
    public function assertMap($value)
>     /**



<      * @param array $value



>      * @param array|Number $value
>      *
>      * @return int|float



<      * @return integer|float



>      * @deprecated



<         if ($value[0] === Type::T_NUMBER) {
<             if (! empty($value[2]['%'])) {
<                 return $value[1] / 100;



>         @trigger_error(sprintf('"%s" is deprecated since 1.7.0.', __METHOD__), E_USER_DEPRECATED);
> 
>         if ($value instanceof Number) {
>             if ($value->hasUnit('%')) {
>                 return $value->getDimension() / 100;



<             return $value[1];



>             return $value->getDimension();



<      * @param array $value



>      * @param array|Number $value
>      * @param string|null  $varName



<      * @throws \Exception



>      * @throws SassScriptException



<     public function assertMap($value)



>     public function assertMap($value, $varName = null)



<         $value = $this->coerceMap($value);



>         $map = $this->tryMap($value);
> 
>         if ($map === null) {
>             $value = $this->compileValue($value);



<         if ($value[0] !== Type::T_MAP) {
<             $this->throwError('expecting map, %s received', $value[0]);



>             throw SassScriptException::forArgument("$value is not a map.", $varName);



<         return $value;



>         return $map;


     * @api
     *

<      * @param array $value



>      * @param array|Number $value


     *
     * @return array
     *
     * @throws \Exception
     */
    public function assertList($value)
    {
        if ($value[0] !== Type::T_LIST) {

<             $this->throwError('expecting list, %s received', $value[0]);



>             throw $this->error('expecting list, %s received', $value[0]);


        }

>         assert(\is_array($value));



        return $value;
    }

    /**

>      * Gets the keywords of an argument list.
     * Assert value is a color
>      *
     *
>      * Keys in the returned array are normalized names (underscores are replaced with dashes)
     * @api
>      * without the leading `$`.
     *
>      * Calling this helper with anything that an argument list received for a rest argument
     * @param array $value
>      * of the function argument declaration is not supported.
     *
>      *
     * @return array
>      * @param array|Number $value
     *
>      *
     * @throws \Exception
>      * @return array<string, array|Number>
     */
>      */
    public function assertColor($value)
>     public function getArgumentListKeywords($value)
    {
>     {
        if ($color = $this->coerceColor($value)) {
>         if ($value[0] !== Type::T_LIST || !isset($value[3]) || !\is_array($value[3])) {
            return $color;
>             throw new \InvalidArgumentException('The argument is not a sass argument list.');
        }
>         }

> 
        $this->throwError('expecting color, %s received', $value[0]);
>         return $value[3];
    }
>     }

> 
    /**
>     /**



<      * @param array $value



>      * @param array|Number $value
>      * @param string|null  $varName



<      * @throws \Exception



>      * @throws SassScriptException



<     public function assertColor($value)



>     public function assertColor($value, $varName = null)



<         $this->throwError('expecting color, %s received', $value[0]);



>         $value = $this->compileValue($value);
> 
>         throw SassScriptException::forArgument("$value is not a color.", $varName);



<      * @param array $value



>      * @param array|Number $value
>      * @param string|null  $varName


     *

<      * @return integer|float



>      * @return Number


     *

<      * @throws \Exception



>      * @throws SassScriptException


     */

<     public function assertNumber($value)



>     public function assertNumber($value, $varName = null)


    {

<         if ($value[0] !== Type::T_NUMBER) {
<             $this->throwError('expecting number, %s received', $value[0]);



>         if (!$value instanceof Number) {
>             $value = $this->compileValue($value);
>             throw SassScriptException::forArgument("$value is not a number.", $varName);
>         }
> 
>         return $value;
>     }
> 
>     /**
>      * Assert value is a integer
>      *
>      * @api
>      *
>      * @param array|Number $value
>      * @param string|null  $varName
>      *
>      * @return int
>      *
>      * @throws SassScriptException
>      */
>     public function assertInteger($value, $varName = null)
>     {
>         $value = $this->assertNumber($value, $varName)->getDimension();
>         if (round($value - \intval($value), Number::PRECISION) > 0) {
>             throw SassScriptException::forArgument("$value is not an integer.", $varName);
>         }
> 
>         return intval($value);


        }


<         return $value[1];



>     /**
>      * Extract the  ... / alpha on the last argument of channel arg
>      * in color functions
>      *
>      * @param array $args
>      * @return array
>      */
>     private function extractSlashAlphaInColorFunction($args)
>     {
>         $last = end($args);
>         if (\count($args) === 3 && $last[0] === Type::T_EXPRESSION && $last[1] === '/') {
>             array_pop($args);
>             $args[] = $last[2];
>             $args[] = $last[3];
>         }
>         return $args;


    }


> 


    /**
     * Make sure a color's components don't go out of bounds
     *
     * @param array $c
     *
     * @return array
     */
    protected function fixColor($c)
    {
        foreach ([1, 2, 3] as $i) {
            if ($c[$i] < 0) {
                $c[$i] = 0;
            }

            if ($c[$i] > 255) {
                $c[$i] = 255;
            }

> 
        }
>             if (!\is_int($c[$i])) {

>                 $c[$i] = round($c[$i]);
        return $c;
>             }


    }

    /**
     * Convert RGB to HSL
     *

<      * @api



>      * @internal


     *

<      * @param integer $red
<      * @param integer $green
<      * @param integer $blue



>      * @param int $red
>      * @param int $green
>      * @param int $blue


     *
     * @return array
     */
    public function toHSL($red, $green, $blue)
    {
        $min = min($red, $green, $blue);
        $max = max($red, $green, $blue);

        $l = $min + $max;
        $d = $max - $min;

        if ((int) $d === 0) {
            $h = $s = 0;
        } else {
            if ($l < 255) {
                $s = $d / $l;
            } else {
                $s = $d / (510 - $l);
            }

            if ($red == $max) {
                $h = 60 * ($green - $blue) / $d;
            } elseif ($green == $max) {
                $h = 60 * ($blue - $red) / $d + 120;

<             } elseif ($blue == $max) {



>             } else {


                $h = 60 * ($red - $green) / $d + 240;
            }
        }


<         return [Type::T_HSL, fmod($h, 360), $s * 100, $l / 5.1];



>         return [Type::T_HSL, fmod($h + 360, 360), $s * 100, $l / 5.1];


    }

    /**
     * Hue to RGB helper
     *
     * @param float $m1
     * @param float $m2
     * @param float $h
     *
     * @return float
     */
    protected function hueToRGB($m1, $m2, $h)
    {
        if ($h < 0) {
            $h += 1;
        } elseif ($h > 1) {
            $h -= 1;
        }

        if ($h * 6 < 1) {
            return $m1 + ($m2 - $m1) * $h * 6;
        }

        if ($h * 2 < 1) {
            return $m2;
        }

        if ($h * 3 < 2) {
            return $m1 + ($m2 - $m1) * (2/3 - $h) * 6;
        }

        return $m1;
    }

    /**
     * Convert HSL to RGB
     *

<      * @api



>      * @internal


     *

<      * @param integer $hue        H from 0 to 360
<      * @param integer $saturation S from 0 to 100
<      * @param integer $lightness  L from 0 to 100



>      * @param int|float $hue        H from 0 to 360
>      * @param int|float $saturation S from 0 to 100
>      * @param int|float $lightness  L from 0 to 100


     *
     * @return array
     */
    public function toRGB($hue, $saturation, $lightness)
    {
        if ($hue < 0) {
            $hue += 360;
        }

        $h = $hue / 360;
        $s = min(100, max(0, $saturation)) / 100;
        $l = min(100, max(0, $lightness)) / 100;

        $m2 = $l <= 0.5 ? $l * ($s + 1) : $l + $s - $l * $s;
        $m1 = $l * 2 - $m2;

        $r = $this->hueToRGB($m1, $m2, $h + 1/3) * 255;
        $g = $this->hueToRGB($m1, $m2, $h) * 255;
        $b = $this->hueToRGB($m1, $m2, $h - 1/3) * 255;

        $out = [Type::T_COLOR, $r, $g, $b];

        return $out;
    }


<     // Built in functions



>     /**
>      * Convert HWB to RGB
>      * https://www.w3.org/TR/css-color-4/#hwb-to-rgb
>      *
>      * @api
>      *
>      * @param int|float $hue        H from 0 to 360
>      * @param int|float $whiteness  W from 0 to 100
>      * @param int|float $blackness  B from 0 to 100
>      *
>      * @return array
>      */
>     private function HWBtoRGB($hue, $whiteness, $blackness)
>     {
>         $w = min(100, max(0, $whiteness)) / 100;
>         $b = min(100, max(0, $blackness)) / 100;
> 
>         $sum = $w + $b;
>         if ($sum > 1.0) {
>             $w = $w / $sum;
>             $b = $b / $sum;
>         }
>         $b = min(1.0 - $w, $b);
> 
>         $rgb = $this->toRGB($hue, 100, 50);
>         for($i = 1; $i < 4; $i++) {
>           $rgb[$i] *= (1.0 - $w - $b);
>           $rgb[$i] = round($rgb[$i] + 255 * $w + 0.0001);
>         }




<     protected static $libCall = ['name', 'args...'];
<     protected function libCall($args, $kwargs)



>         return $rgb;
>     }
> 
>     /**
>      * Convert RGB to HWB
>      *
>      * @api
>      *
>      * @param int $red
>      * @param int $green
>      * @param int $blue
>      *
>      * @return array
>      */
>     private function RGBtoHWB($red, $green, $blue)


    {

<         $name = $this->compileStringContent($this->coerceString($this->reduce(array_shift($args), true)));
<         $callArgs = [];



>         $min = min($red, $green, $blue);
>         $max = max($red, $green, $blue);
> 
>         $d = $max - $min;




<         // $kwargs['args'] is [Type::T_LIST, ',', [..]]
<         foreach ($kwargs['args'][2] as $varname => $arg) {
<             if (is_numeric($varname)) {
<                 $varname = null;



>         if ((int) $d === 0) {
>             $h = 0;


            } else {

<                 $varname = [ 'var', $varname];



> 
>             if ($red == $max) {
>                 $h = 60 * ($green - $blue) / $d;
>             } elseif ($green == $max) {
>                 $h = 60 * ($blue - $red) / $d + 120;
>             } else {
>                 $h = 60 * ($red - $green) / $d + 240;
>             }
>         }
> 
>         return [Type::T_HWB, fmod($h, 360), $min / 255 * 100, 100 - $max / 255 *100];
>     }
> 
> 
>     // Built in functions
> 
>     protected static $libCall = ['function', 'args...'];
>     protected function libCall($args)
>     {
>         $functionReference = $args[0];
> 
>         if (in_array($functionReference[0], [Type::T_STRING, Type::T_KEYWORD])) {
>             $name = $this->compileStringContent($this->coerceString($functionReference));
>             $warning = "Passing a string to call() is deprecated and will be illegal\n"
>                 . "in Sass 4.0. Use call(function-reference($name)) instead.";
>             Warn::deprecation($warning);
>             $functionReference = $this->libGetFunction([$this->assertString($functionReference, 'function')]);
>         }
> 
>         if ($functionReference === static::$null) {
>             return static::$null;
>         }
> 
>         if (! in_array($functionReference[0], [Type::T_FUNCTION_REFERENCE, Type::T_FUNCTION])) {
>             throw $this->error('Function reference expected, got ' . $functionReference[0]);
>         }
> 
>         $callArgs = [
>             [null, $args[1], true]
>         ];
> 
>         return $this->reduce([Type::T_FUNCTION_CALL, $functionReference, $callArgs]);
>     }
> 
> 
>     protected static $libGetFunction = [
>         ['name'],
>         ['name', 'css']
>     ];
>     protected function libGetFunction($args)
>     {
>         $name = $this->compileStringContent($this->assertString(array_shift($args), 'name'));
>         $isCss = false;
> 
>         if (count($args)) {
>             $isCss = array_shift($args);
>             $isCss = (($isCss === static::$true) ? true : false);


            }


<             $callArgs[] = [$varname, $arg, false];



>         if ($isCss) {
>             return [Type::T_FUNCTION, $name, [Type::T_LIST, ',', []]];


        }


<         return $this->reduce([Type::T_FUNCTION_CALL, $name, $callArgs]);



>         return $this->getFunctionReference($name, true);


    }

    protected static $libIf = ['condition', 'if-true', 'if-false:'];
    protected function libIf($args)
    {
        list($cond, $t, $f) = $args;

        if (! $this->isTruthy($this->reduce($cond, true))) {
            return $this->reduce($f, true);
        }

        return $this->reduce($t, true);
    }

    protected static $libIndex = ['list', 'value'];
    protected function libIndex($args)
    {
        list($list, $value) = $args;


<         if ($value[0] === Type::T_MAP) {
<             return static::$null;
<         }
< 
<         if ($list[0] === Type::T_MAP ||



>         if (
>             $list[0] === Type::T_MAP ||


            $list[0] === Type::T_STRING ||
            $list[0] === Type::T_KEYWORD ||
            $list[0] === Type::T_INTERPOLATE
        ) {
            $list = $this->coerceList($list, ' ');
        }

        if ($list[0] !== Type::T_LIST) {
            return static::$null;
        }


>         // Numbers are represented with value objects, for which the PHP equality operator does not
        $values = [];
>         // match the Sass rules (and we cannot overload it). As they are the only type of values

>         // represented with a value object for now, they require a special case.
        foreach ($list[2] as $item) {
>         if ($value instanceof Number) {
            $values[] = $this->normalizeValue($item);
>             $key = 0;
        }
>             foreach ($list[2] as $item) {

>                 $key++;
        $key = array_search($this->normalizeValue($value), $values);
>                 $itemValue = $this->normalizeValue($item);

> 
        return false === $key ? static::$null : $key + 1;
>                 if ($itemValue instanceof Number && $value->equals($itemValue)) {
    }
>                     return new Number($key, '');

>                 }
    protected static $libRgb = [
>             }
        ['color'],
>             return static::$null;
        ['color', 'alpha'],
>         }
        ['channels'],
> 



<         return false === $key ? static::$null : $key + 1;



>         return false === $key ? static::$null : new Number($key + 1, '');


        ['red', 'green', 'blue', 'alpha'] ];

> 
    protected function libRgb($args, $kwargs, $funcName = 'rgb')
>     /**
    {
>      * @param array $args
        switch (count($args)) {
>      * @param array $kwargs
            case 1:
>      * @param string $funcName
                if (! $color = $this->coerceColor($args[0], true)) {
>      *
                    $color = [Type::T_STRING, '', [$funcName . '(', $args[0], ')']];
>      * @return array
                }
>      */



<         switch (count($args)) {



>         switch (\count($args)) {



            case 3:
                $color = [Type::T_COLOR, $args[0], $args[1], $args[2]];

                if (! $color = $this->coerceColor($color)) {
                    $color = [Type::T_STRING, '', [$funcName .'(', $args[0], ', ', $args[1], ', ', $args[2], ')']];
                }

                return $color;

            case 2:
                if ($color = $this->coerceColor($args[0], true)) {
                    $alpha = $this->compileRGBAValue($args[1], true);

                    if (is_numeric($alpha)) {
                        $color[4] = $alpha;
                    } else {
                        $color = [Type::T_STRING, '',
                            [$funcName . '(', $color[1], ', ', $color[2], ', ', $color[3], ', ', $alpha, ')']];
                    }
                } else {

<                     $color = [Type::T_STRING, '', [$funcName . '(', $args[0], ')']];



>                     $color = [Type::T_STRING, '', [$funcName . '(', $args[0], ', ', $args[1], ')']];


                }
                break;

            case 4:
            default:
                $color = [Type::T_COLOR, $args[0], $args[1], $args[2], $args[3]];

                if (! $color = $this->coerceColor($color)) {
                    $color = [Type::T_STRING, '',
                        [$funcName . '(', $args[0], ', ', $args[1], ', ', $args[2], ', ', $args[3], ')']];
                }
                break;
        }

        return $color;
    }

    protected static $libRgba = [
        ['color'],
        ['color', 'alpha'],
        ['channels'],
        ['red', 'green', 'blue'],
        ['red', 'green', 'blue', 'alpha'] ];
    protected function libRgba($args, $kwargs)
    {
        return $this->libRgb($args, $kwargs, 'rgba');
    }


<     // helper function for adjust_color, change_color, and scale_color
<     protected function alterColor($args, $fn)



>     /**
>      * Helper function for adjust_color, change_color, and scale_color
>      *
>      * @param array<array|Number> $args
>      * @param string $operation
>      * @param callable $fn
>      *
>      * @return array
>      *
>      * @phpstan-param callable(float|int, float|int|null, float|int): (float|int) $fn
>      */
>     protected function alterColor(array $args, $operation, $fn)


    {

<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');
> 
>         if ($args[1][2]) {
>             throw new SassScriptException('Only one positional argument is allowed. All other arguments must be passed by name.');
>         }
> 
>         $kwargs = $this->getArgumentListKeywords($args[1]);




<         foreach ([1 => 1, 2 => 2, 3 => 3, 7 => 4] as $iarg => $irgba) {
<             if (isset($args[$iarg])) {
<                 $val = $this->assertNumber($args[$iarg]);



>         $scale = $operation === 'scale';
>         $change = $operation === 'change';




<                 if (! isset($color[$irgba])) {
<                     $color[$irgba] = (($irgba < 4) ? 0 : 1);



>         /** @phpstan-var callable(string, float|int, bool=, bool=): (float|int|null) $getParam */
>         $getParam = function ($name, $max, $checkPercent = false, $assertPercent = false) use (&$kwargs, $scale, $change) {
>             if (!isset($kwargs[$name])) {
>                 return null;


                }


<                 $color[$irgba] = call_user_func($fn, $color[$irgba], $val, $iarg);



>             $number = $this->assertNumber($kwargs[$name], $name);
>             unset($kwargs[$name]);
> 
>             if (!$scale && $checkPercent) {
>                 if (!$number->hasUnit('%')) {
>                     $warning = $this->error("{$name} Passing a number `$number` without unit % is deprecated.");
>                     $this->logger->warn($warning->getMessage(), true);


            }
        }


<         if (! empty($args[4]) || ! empty($args[5]) || ! empty($args[6])) {
<             $hsl = $this->toHSL($color[1], $color[2], $color[3]);



>             if ($scale || $assertPercent) {
>                 $number->assertUnit('%', $name);
>             }




<             foreach ([4 => 1, 5 => 2, 6 => 3] as $iarg => $ihsl) {
<                 if (! empty($args[$iarg])) {
<                     $val = $this->assertNumber($args[$iarg]);
<                     $hsl[$ihsl] = call_user_func($fn, $hsl[$ihsl], $val, $iarg);



>             if ($scale) {
>                 $max = 100;
>             }
> 
>             if ($scale || $assertPercent) {
>                 return $number->valueInRange($change ? 0 : -$max, $max, $name);


                }

> 
            }
>             return $number->valueInRangeWithUnit($change ? 0 : -$max, $max, $name, $checkPercent ? '%' : '');

>         };
            $rgb = $this->toRGB($hsl[1], $hsl[2], $hsl[3]);
> 

>         $alpha = $getParam('alpha', 1);
            if (isset($color[4])) {
>         $red = $getParam('red', 255);
                $rgb[4] = $color[4];
>         $green = $getParam('green', 255);
            }
>         $blue = $getParam('blue', 255);

> 
            $color = $rgb;
>         if ($scale || !isset($kwargs['hue'])) {
        }
>             $hue = null;

>         } else {
        return $color;
>             $hueNumber = $this->assertNumber($kwargs['hue'], 'hue');
    }
>             unset($kwargs['hue']);

>             $hue = $hueNumber->getDimension();
    protected static $libAdjustColor = [
>         }
        'color', 'red:null', 'green:null', 'blue:null',
>         $saturation = $getParam('saturation', 100, true);
        'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'
>         $lightness = $getParam('lightness', 100, true);
    ];
>         $whiteness = $getParam('whiteness', 100, false, true);
    protected function libAdjustColor($args)
>         $blackness = $getParam('blackness', 100, false, true);
    {
> 
        return $this->alterColor($args, function ($base, $alter, $i) {
>         if (!empty($kwargs)) {
            return $base + $alter;
>             $unknownNames = array_keys($kwargs);
        });
>             $lastName = array_pop($unknownNames);
    }
>             $message = sprintf(

>                 'No argument%s named $%s%s.',
    protected static $libChangeColor = [
>                 $unknownNames ? 's' : '',
        'color', 'red:null', 'green:null', 'blue:null',
>                 $unknownNames ? implode(', $', $unknownNames) . ' or $' : '',
        'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'
>                 $lastName
    ];
>             );
    protected function libChangeColor($args)
>             throw new SassScriptException($message);
    {
>         }
        return $this->alterColor($args, function ($base, $alter, $i) {
> 
            return $alter;
>         $hasRgb = $red !== null || $green !== null || $blue !== null;
        });
>         $hasSL = $saturation !== null || $lightness !== null;
    }
>         $hasWB = $whiteness !== null || $blackness !== null;

> 
    protected static $libScaleColor = [
>         if ($hasRgb && ($hasSL || $hasWB || $hue !== null)) {
        'color', 'red:null', 'green:null', 'blue:null',
>             throw new SassScriptException(sprintf('RGB parameters may not be passed along with %s parameters.', $hasWB ? 'HWB' : 'HSL'));


        'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'

>         if ($hasWB && $hasSL) {
    ];
>             throw new SassScriptException('HSL parameters may not be passed along with HWB parameters.');
    protected function libScaleColor($args)
>         }
    {
> 
        return $this->alterColor($args, function ($base, $scale, $i) {
>         if ($hasRgb) {
            // 1, 2, 3 - rgb
>             $color[1] = round($fn($color[1], $red, 255));
            // 4, 5, 6 - hsl
>             $color[2] = round($fn($color[2], $green, 255));
            // 7 - a
>             $color[3] = round($fn($color[3], $blue, 255));
            switch ($i) {
>         } elseif ($hasWB) {
                case 1:
>             $hwb = $this->RGBtoHWB($color[1], $color[2], $color[3]);
                case 2:
>             if ($hue !== null) {
                case 3:
>                 $hwb[1] = $change ? $hue : $hwb[1] + $hue;
                    $max = 255;
>             }
                    break;
>             $hwb[2] = $fn($hwb[2], $whiteness, 100);

>             $hwb[3] = $fn($hwb[3], $blackness, 100);
                case 4:
> 
                    $max = 360;
>             $rgb = $this->HWBtoRGB($hwb[1], $hwb[2], $hwb[3]);
                    break;
> 

>             if (isset($color[4])) {
                case 7:
>                 $rgb[4] = $color[4];
                    $max = 1;
>             }
                    break;
> 

>             $color = $rgb;
                default:
>         } elseif ($hue !== null || $hasSL) {
                    $max = 100;
>             $hsl = $this->toHSL($color[1], $color[2], $color[3]);
            }
> 

>             if ($hue !== null) {
            $scale = $scale / 100;
>                 $hsl[1] = $change ? $hue : $hsl[1] + $hue;

>             }
            if ($scale < 0) {
>             $hsl[2] = $fn($hsl[2], $saturation, 100);
                return $base * $scale + $base;
>             $hsl[3] = $fn($hsl[3], $lightness, 100);
            }
> 




>         if ($alpha !== null) {
            return ($max - $base) * $scale + $base;
>             $existingAlpha = isset($color[4]) ? $color[4] : 1;
        });
>             $color[4] = $fn($existingAlpha, $alpha, 1);
    }
>         }

> 



<     protected static $libAdjustColor = [
<         'color', 'red:null', 'green:null', 'blue:null',
<         'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'
<     ];



>     protected static $libAdjustColor = ['color', 'kwargs...'];



<         return $this->alterColor($args, function ($base, $alter, $i) {
<             return $base + $alter;



>         return $this->alterColor($args, 'adjust', function ($base, $alter, $max) {
>             if ($alter === null) {
>                 return $base;
>             }
> 
>             $new = $base + $alter;
> 
>             if ($new < 0) {
>                 return 0;
>             }
> 
>             if ($new > $max) {
>                 return $max;
>             }
> 
>             return $new;



<     protected static $libChangeColor = [
<         'color', 'red:null', 'green:null', 'blue:null',
<         'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'
<     ];



>     protected static $libChangeColor = ['color', 'kwargs...'];



<         return $this->alterColor($args, function ($base, $alter, $i) {



>         return $this->alterColor($args,'change', function ($base, $alter, $max) {
>             if ($alter === null) {
>                 return $base;
>             }
> 



<     protected static $libScaleColor = [
<         'color', 'red:null', 'green:null', 'blue:null',
<         'hue:null', 'saturation:null', 'lightness:null', 'alpha:null'
<     ];



>     protected static $libScaleColor = ['color', 'kwargs...'];



<         return $this->alterColor($args, function ($base, $scale, $i) {
<             // 1, 2, 3 - rgb
<             // 4, 5, 6 - hsl
<             // 7 - a
<             switch ($i) {
<                 case 1:
<                 case 2:
<                 case 3:
<                     $max = 255;
<                     break;
< 
<                 case 4:
<                     $max = 360;
<                     break;
< 
<                 case 7:
<                     $max = 1;
<                     break;
< 
<                 default:
<                     $max = 100;



>         return $this->alterColor($args, 'scale', function ($base, $scale, $max) {
>             if ($scale === null) {
>                 return $base;


        if ($color = $this->coerceColor($args[0])) {

> 
            return isset($color[4]) ? $color[4] : 1;
>         if (\is_null($color)) {
        }
>             throw $this->error('Error: argument `$color` of `ie-hex-str($color)` must be a color');

>         }
        // this might be the IE function, so return value unchanged
> 



<         return $color[1];



>         if (\is_null($color)) {
>             throw $this->error('Error: argument `$color` of `red($color)` must be a color');
>         }
> 
>         return new Number((int) $color[1], '');



<         return $color[2];



>         if (\is_null($color)) {
>             throw $this->error('Error: argument `$color` of `green($color)` must be a color');
>         }
> 
>         return new Number((int) $color[2], '');



<         return $color[3];



>         if (\is_null($color)) {
>             throw $this->error('Error: argument `$color` of `blue($color)` must be a color');
>         }
> 
>         return new Number((int) $color[3], '');



<             return isset($color[4]) ? $color[4] : 1;



>             return new Number(isset($color[4]) ? $color[4] : 1, '');


    protected function libOpacity($args)
    {
        $value = $args[0];


<         if ($value[0] === Type::T_NUMBER) {



>         if ($value instanceof Number) {


            return null;
        }

        return $this->libAlpha($args);
    }

    // mix two colors

<     protected static $libMix = ['color-1', 'color-2', 'weight:0.5'];



>     protected static $libMix = [
>         ['color1', 'color2', 'weight:50%'],
>         ['color-1', 'color-2', 'weight:50%']
>         ];


    protected function libMix($args)
    {
        list($first, $second, $weight) = $args;


<         $first = $this->assertColor($first);
<         $second = $this->assertColor($second);
< 
<         if (! isset($weight)) {
<             $weight = 0.5;
<         } else {
<             $weight = $this->coercePercent($weight);
<         }



>         $first = $this->assertColor($first, 'color1');
>         $second = $this->assertColor($second, 'color2');
>         $weightScale = $this->assertNumber($weight, 'weight')->valueInRange(0, 100, 'weight') / 100;



        $firstAlpha = isset($first[4]) ? $first[4] : 1;
        $secondAlpha = isset($second[4]) ? $second[4] : 1;


<         $w = $weight * 2 - 1;
<         $a = $firstAlpha - $secondAlpha;



>         $normalizedWeight = $weightScale * 2 - 1;
>         $alphaDistance = $firstAlpha - $secondAlpha;




<         $w1 = (($w * $a === -1 ? $w : ($w + $a) / (1 + $w * $a)) + 1) / 2.0;
<         $w2 = 1.0 - $w1;



>         $combinedWeight = $normalizedWeight * $alphaDistance == -1 ? $normalizedWeight : ($normalizedWeight + $alphaDistance) / (1 + $normalizedWeight * $alphaDistance);
>         $weight1 = ($combinedWeight + 1) / 2.0;
>         $weight2 = 1.0 - $weight1;



        $new = [Type::T_COLOR,

<             $w1 * $first[1] + $w2 * $second[1],
<             $w1 * $first[2] + $w2 * $second[2],
<             $w1 * $first[3] + $w2 * $second[3],



>             $weight1 * $first[1] + $weight2 * $second[1],
>             $weight1 * $first[2] + $weight2 * $second[2],
>             $weight1 * $first[3] + $weight2 * $second[3],


        ];

        if ($firstAlpha != 1.0 || $secondAlpha != 1.0) {

<             $new[] = $firstAlpha * $weight + $secondAlpha * (1 - $weight);



>             $new[] = $firstAlpha * $weightScale + $secondAlpha * (1 - $weightScale);


        }

        return $this->fixColor($new);
    }

    protected static $libHsl =[
        ['channels'],

>         ['hue', 'saturation'],


        ['hue', 'saturation', 'lightness'],
        ['hue', 'saturation', 'lightness', 'alpha'] ];

> 
    protected function libHsl($args, $kwargs, $funcName = 'hsl')
>     /**
    {
>      * @param array $args
        if (count($args) == 1) {
>      * @param array $kwargs
            if ($args[0][0] !== Type::T_LIST || count($args[0][2]) < 3 || count($args[0][2]) > 4) {
>      * @param string $funcName
                return [Type::T_STRING, '', [$funcName . '(', $args[0], ')']];
>      *
            }
>      * @return array|null

>      */



<         if (count($args) == 1) {
<             if ($args[0][0] !== Type::T_LIST || count($args[0][2]) < 3 || count($args[0][2]) > 4) {



>         $args_to_check = $args;
> 
>         if (\count($args) == 1) {
>             if ($args[0][0] !== Type::T_LIST || \count($args[0][2]) < 3 || \count($args[0][2]) > 4) {




>             $args_to_check = $kwargs['channels'][2];
        $hue = $this->compileColorPartValue($args[0], 0, 360, false, false, true);
>         }
        $saturation = $this->compileColorPartValue($args[1], 0, 100, false);
> 
        $lightness = $this->compileColorPartValue($args[2], 0, 100, false);
>         if (\count($args) === 2) {

>             // if var() is used as an argument, return as a css function
        $alpha = null;
>             foreach ($args as $arg) {

>                 if ($arg[0] === Type::T_FUNCTION && in_array($arg[1], ['var'])) {
        if (count($args) === 4) {
>                     return null;
            $alpha = $this->compileColorPartValue($args[3], 0, 100, false);
>                 }

>             }
            if (! is_numeric($hue) || ! is_numeric($saturation) || ! is_numeric($lightness) || ! is_numeric($alpha)) {
> 
                return [Type::T_STRING, '',
>             throw new SassScriptException('Missing argument $lightness.');
                    [$funcName . '(', $args[0], ', ', $args[1], ', ', $args[2], ', ', $args[3], ')']];
>         }
            }
> 
        } else {
>         foreach ($kwargs as $arg) {
            if (! is_numeric($hue) || ! is_numeric($saturation) || ! is_numeric($lightness)) {
>             if (in_array($arg[0], [Type::T_FUNCTION_CALL, Type::T_FUNCTION]) && in_array($arg[1], ['min', 'max'])) {
                return [Type::T_STRING, '', [$funcName . '(', $args[0], ', ', $args[1], ', ', $args[2], ')']];
>                 return null;
            }
>             }
        }
>         }

> 
        $color = $this->toRGB($hue, $saturation, $lightness);
>         foreach ($args_to_check as $k => $arg) {

>             if (in_array($arg[0], [Type::T_FUNCTION_CALL, Type::T_FUNCTION]) && in_array($arg[1], ['min', 'max'])) {
        if (! is_null($alpha)) {
>                 if (count($kwargs) > 1 || ($k >= 2 && count($args) === 4)) {
            $color[4] = $alpha;
>                     return null;



<         $hue = $this->compileColorPartValue($args[0], 0, 360, false, false, true);
<         $saturation = $this->compileColorPartValue($args[1], 0, 100, false);
<         $lightness = $this->compileColorPartValue($args[2], 0, 100, false);



>                 $args[$k] = $this->stringifyFncallArgs($arg);
>             }


    }

>             if (

>                 $k >= 2 && count($args) === 4 &&
    protected static $libHsla = [
>                 in_array($arg[0], [Type::T_FUNCTION_CALL, Type::T_FUNCTION]) &&
            ['channels'],
>                 in_array($arg[1], ['calc','env'])
            ['hue', 'saturation', 'lightness', 'alpha:1'] ];
>             ) {
    protected function libHsla($args, $kwargs)
>                 return null;
    {
>             }
        return $this->libHsl($args, $kwargs, 'hsla');
>         }
    }
> 

>         $hue = $this->reduce($args[0]);
    protected static $libHue = ['color'];
>         $saturation = $this->reduce($args[1]);
    protected function libHue($args)
>         $lightness = $this->reduce($args[2]);



<         if (count($args) === 4) {



>         if (\count($args) === 4) {



<             if (! is_numeric($hue) || ! is_numeric($saturation) || ! is_numeric($lightness) || ! is_numeric($alpha)) {



>             if (!$hue instanceof Number || !$saturation instanceof Number || ! $lightness instanceof Number || ! is_numeric($alpha)) {



<             if (! is_numeric($hue) || ! is_numeric($saturation) || ! is_numeric($lightness)) {



>             if (!$hue instanceof Number || !$saturation instanceof Number || ! $lightness instanceof Number) {



<         $color = $this->toRGB($hue, $saturation, $lightness);



>         $hueValue = fmod($hue->getDimension(), 360);
> 
>         while ($hueValue < 0) {
>             $hueValue += 360;
>         }
> 
>         $color = $this->toRGB($hueValue, max(0, min($saturation->getDimension(), 100)), max(0, min($lightness->getDimension(), 100)));



<         if (! is_null($alpha)) {



>         if (! \is_null($alpha)) {



<             ['hue', 'saturation', 'lightness', 'alpha:1'] ];



>             ['hue', 'saturation'],
>             ['hue', 'saturation', 'lightness'],
>             ['hue', 'saturation', 'lightness', 'alpha']];



<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');



<         return new Node\Number($hsl[1], 'deg');



>         return new Number($hsl[1], 'deg');


    protected function libSaturation($args)
    {

<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');


        $hsl = $this->toHSL($color[1], $color[2], $color[3]);


<         return new Node\Number($hsl[2], '%');



>         return new Number($hsl[2], '%');


    }

    protected static $libLightness = ['color'];
    protected function libLightness($args)
    {

<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');


        $hsl = $this->toHSL($color[1], $color[2], $color[3]);


<         return new Node\Number($hsl[3], '%');



>         return new Number($hsl[3], '%');
>     }
> 
>     /*
>      * Todo : a integrer dans le futur module color
>     protected static $libHwb = [
>         ['channels'],
>         ['hue', 'whiteness', 'blackness'],
>         ['hue', 'whiteness', 'blackness', 'alpha'] ];
>     protected function libHwb($args, $kwargs, $funcName = 'hwb')
>     {
>         $args_to_check = $args;
> 
>         if (\count($args) == 1) {
>             if ($args[0][0] !== Type::T_LIST) {
>                 throw $this->error("Missing elements \$whiteness and \$blackness");
>             }
> 
>             if (\trim($args[0][1])) {
>                 throw $this->error("\$channels must be a space-separated list.");
>             }
> 
>             if (! empty($args[0]['enclosing'])) {
>                 throw $this->error("\$channels must be an unbracketed list.");
>             }
> 
>             $args = $args[0][2];
>             if (\count($args) > 3) {
>                 throw $this->error("hwb() : Only 3 elements are allowed but ". \count($args) . "were passed");


    }


>             $args_to_check = $this->extractSlashAlphaInColorFunction($kwargs['channels'][2]);
    protected function adjustHsl($color, $idx, $amount)
>             if (\count($args_to_check) !== \count($kwargs['channels'][2])) {
    {
>                 $args = $args_to_check;
        $hsl = $this->toHSL($color[1], $color[2], $color[3]);
>             }
        $hsl[$idx] += $amount;
>         }
        $out = $this->toRGB($hsl[1], $hsl[2], $hsl[3]);
> 

>         if (\count($args_to_check) < 2) {
        if (isset($color[4])) {
>             throw $this->error("Missing elements \$whiteness and \$blackness");
            $out[4] = $color[4];
>         }
        }
>         if (\count($args_to_check) < 3) {

>             throw $this->error("Missing element \$blackness");
        return $out;
>         }
    }
>         if (\count($args_to_check) > 4) {

>             throw $this->error("hwb() : Only 4 elements are allowed but ". \count($args) . "were passed");
    protected static $libAdjustHue = ['color', 'degrees'];
>         }
    protected function libAdjustHue($args)
> 
    {
>         foreach ($kwargs as $k => $arg) {
        $color = $this->assertColor($args[0]);
>             if (in_array($arg[0], [Type::T_FUNCTION_CALL]) && in_array($arg[1], ['min', 'max'])) {
        $degrees = $this->assertNumber($args[1]);
>                 return null;

>             }
        return $this->adjustHsl($color, 1, $degrees);
>         }
    }
> 

>         foreach ($args_to_check as $k => $arg) {
    protected static $libLighten = ['color', 'amount'];
>             if (in_array($arg[0], [Type::T_FUNCTION_CALL]) && in_array($arg[1], ['min', 'max'])) {
    protected function libLighten($args)
>                 if (count($kwargs) > 1 || ($k >= 2 && count($args) === 4)) {
    {
>                     return null;
        $color = $this->assertColor($args[0]);
>                 }
        $amount = Util::checkRange('amount', new Range(0, 100), $args[1], '%');
> 

>                 $args[$k] = $this->stringifyFncallArgs($arg);
        return $this->adjustHsl($color, 3, $amount);
>             }
    }
> 

>             if (
    protected static $libDarken = ['color', 'amount'];
>                 $k >= 2 && count($args) === 4 &&
    protected function libDarken($args)
>                 in_array($arg[0], [Type::T_FUNCTION_CALL, Type::T_FUNCTION]) &&
    {
>                 in_array($arg[1], ['calc','env'])
        $color = $this->assertColor($args[0]);
>             ) {
        $amount = Util::checkRange('amount', new Range(0, 100), $args[1], '%');
>                 return null;

>             }
        return $this->adjustHsl($color, 3, -$amount);
>         }
    }
> 

>         $hue = $this->reduce($args[0]);
    protected static $libSaturate = [['color', 'amount'], ['number']];
>         $whiteness = $this->reduce($args[1]);
    protected function libSaturate($args)
>         $blackness = $this->reduce($args[2]);
    {
>         $alpha = null;
        $value = $args[0];
> 

>         if (\count($args) === 4) {
        if ($value[0] === Type::T_NUMBER) {
>             $alpha = $this->compileColorPartValue($args[3], 0, 1, false);
            return null;
> 
        }
>             if (! \is_numeric($alpha)) {

>                 $val = $this->compileValue($args[3]);
        $color = $this->assertColor($value);
>                 throw $this->error("\$alpha: $val is not a number");
        $amount = 100 * $this->coercePercent($args[1]);
>             }

>         }
        return $this->adjustHsl($color, 2, $amount);
> 
    }
>         $this->assertNumber($hue, 'hue');

>         $this->assertUnit($whiteness, ['%'], 'whiteness');
    protected static $libDesaturate = ['color', 'amount'];
>         $this->assertUnit($blackness, ['%'], 'blackness');
    protected function libDesaturate($args)
> 
    {
>         $this->assertRange($whiteness, 0, 100, "0% and 100%", "whiteness");
        $color = $this->assertColor($args[0]);
>         $this->assertRange($blackness, 0, 100, "0% and 100%", "blackness");
        $amount = 100 * $this->coercePercent($args[1]);
> 

>         $w = $whiteness->getDimension();
        return $this->adjustHsl($color, 2, -$amount);
>         $b = $blackness->getDimension();
    }
> 

>         $hueValue = $hue->getDimension() % 360;
    protected static $libGrayscale = ['color'];
> 
    protected function libGrayscale($args)
>         while ($hueValue < 0) {
    {
>             $hueValue += 360;
        $value = $args[0];
>         }

> 
        if ($value[0] === Type::T_NUMBER) {
>         $color = $this->HWBtoRGB($hueValue, $w, $b);
            return null;
> 
        }
>         if (! \is_null($alpha)) {

>             $color[4] = $alpha;
        return $this->adjustHsl($this->assertColor($value), 2, -100);
>         }
    }
> 

>         return $color;
    protected static $libComplement = ['color'];
>     }
    protected function libComplement($args)
> 
    {
>     protected static $libWhiteness = ['color'];
        return $this->adjustHsl($this->assertColor($args[0]), 1, 180);
>     protected function libWhiteness($args, $kwargs, $funcName = 'whiteness') {
    }
> 

>         $color = $this->assertColor($args[0]);
    protected static $libInvert = ['color', 'weight:1'];
>         $hwb = $this->RGBtoHWB($color[1], $color[2], $color[3]);
    protected function libInvert($args)
> 
    {
>         return new Number($hwb[2], '%');
        list($value, $weight) = $args;
>     }

> 
        if (! isset($weight)) {
>     protected static $libBlackness = ['color'];
            $weight = 1;
>     protected function libBlackness($args, $kwargs, $funcName = 'blackness') {
        } else {
> 
            $weight = $this->coercePercent($weight);
>         $color = $this->assertColor($args[0]);
        }
>         $hwb = $this->RGBtoHWB($color[1], $color[2], $color[3]);

> 
        if ($value[0] === Type::T_NUMBER) {
>         return new Number($hwb[3], '%');
            return null;
>     }
        }
>     */

> 
        $color = $this->assertColor($value);
>     /**
        $inverted = $color;
>      * @param array     $color
        $inverted[1] = 255 - $inverted[1];
>      * @param int       $idx
        $inverted[2] = 255 - $inverted[2];
>      * @param int|float $amount
        $inverted[3] = 255 - $inverted[3];
>      *

>      * @return array
        if ($weight < 1) {
>      */


            return $this->libMix([$inverted, $color, [Type::T_NUMBER, $weight]]);

> 
        }
>         if ($idx !== 1) {

>             // Clamp the saturation and lightness
        return $inverted;
>             $hsl[$idx] = min(max(0, $hsl[$idx]), 100);
    }
>         }

> 



<         $color = $this->assertColor($args[0]);
<         $degrees = $this->assertNumber($args[1]);



>         $color = $this->assertColor($args[0], 'color');
>         $degrees = $this->assertNumber($args[1], 'degrees')->getDimension();



<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');



<         $color = $this->assertColor($args[0]);



>         $color = $this->assertColor($args[0], 'color');



<     protected static $libSaturate = [['color', 'amount'], ['number']];



>     protected static $libSaturate = [['color', 'amount'], ['amount']];



<         if ($value[0] === Type::T_NUMBER) {



>         if (count($args) === 1) {
>             $this->assertNumber($args[0], 'amount');
> 



<         $color = $this->assertColor($value);
<         $amount = 100 * $this->coercePercent($args[1]);



>         $color = $this->assertColor($args[0], 'color');
>         $amount = $this->assertNumber($args[1], 'amount');



<         return $this->adjustHsl($color, 2, $amount);



>         return $this->adjustHsl($color, 2, $amount->valueInRange(0, 100, 'amount'));



<         $color = $this->assertColor($args[0]);
<         $amount = 100 * $this->coercePercent($args[1]);



>         $color = $this->assertColor($args[0], 'color');
>         $amount = $this->assertNumber($args[1], 'amount');



<         return $this->adjustHsl($color, 2, -$amount);



>         return $this->adjustHsl($color, 2, -$amount->valueInRange(0, 100, 'amount'));



<         if ($value[0] === Type::T_NUMBER) {



>         if ($value instanceof Number) {



<         return $this->adjustHsl($this->assertColor($value), 2, -100);



>         return $this->adjustHsl($this->assertColor($value, 'color'), 2, -100);



<         return $this->adjustHsl($this->assertColor($args[0]), 1, 180);



>         return $this->adjustHsl($this->assertColor($args[0], 'color'), 1, 180);



<     protected static $libInvert = ['color', 'weight:1'];



>     protected static $libInvert = ['color', 'weight:100%'];



<         list($value, $weight) = $args;



>         $value = $args[0];



<         if (! isset($weight)) {
<             $weight = 1;
<         } else {
<             $weight = $this->coercePercent($weight);



>         $weight = $this->assertNumber($args[1], 'weight');
> 
>         if ($value instanceof Number) {
>             if ($weight->getDimension() != 100 || !$weight->hasUnit('%')) {
>                 throw new SassScriptException('Only one argument may be passed to the plain-CSS invert() function.');



<         if ($value[0] === Type::T_NUMBER) {



<         $color = $this->assertColor($value);



>         $color = $this->assertColor($value, 'color');



<         if ($weight < 1) {
<             return $this->libMix([$inverted, $color, [Type::T_NUMBER, $weight]]);
<         }
< 
<         return $inverted;



>         return $this->libMix([$inverted, $color, $weight]);



<         $color = $this->assertColor($args[0]);
<         $amount = $this->coercePercent($args[1]);



>         $color = $this->assertColor($args[0], 'color');
>         $amount = $this->assertNumber($args[1], 'amount');



<         $color[4] = (isset($color[4]) ? $color[4] : 1) + $amount;



>         $color[4] = (isset($color[4]) ? $color[4] : 1) + $amount->valueInRangeWithUnit(0, 1, 'amount', '');



<         $color = $this->assertColor($args[0]);
<         $amount = $this->coercePercent($args[1]);



>         $color = $this->assertColor($args[0], 'color');
>         $amount = $this->assertNumber($args[1], 'amount');



<         $color[4] = (isset($color[4]) ? $color[4] : 1) - $amount;



>         $color[4] = (isset($color[4]) ? $color[4] : 1) - $amount->valueInRangeWithUnit(0, 1, 'amount', '');


    {
        return $this->libTransparentize($args);
    }

    protected static $libUnquote = ['string'];
    protected function libUnquote($args)
    {

<         $str = $args[0];



>         try {
>             $str = $this->assertString($args[0], 'string');
>         } catch (SassScriptException $e) {
>             $value = $this->compileValue($args[0]);
>             $fname = $this->getPrettyPath($this->sourceNames[$this->sourceIndex]);
>             $line  = $this->sourceLine;




<         if ($str[0] === Type::T_STRING) {
<             $str[1] = '';



>             $message = "Passing $value, a non-string value, to unquote()
> will be an error in future versions of Sass.\n         on line $line of $fname";
> 
>             $this->logger->warn($message, true);
> 
>             return $args[0];


        }


>         $str[1] = '';
        return $str;
> 


    }

    protected static $libQuote = ['string'];
    protected function libQuote($args)
    {

<         $value = $args[0];



>         $value = $this->assertString($args[0], 'string');




<         if ($value[0] === Type::T_STRING && ! empty($value[1])) {
<             return $value;
<         }



>         $value[1] = '"';




<         return [Type::T_STRING, '"', [$value]];



>         return $value;


    }


<     protected static $libPercentage = ['value'];



>     protected static $libPercentage = ['number'];


    protected function libPercentage($args)
    {

<         return new Node\Number($this->coercePercent($args[0]) * 100, '%');



>         $num = $this->assertNumber($args[0], 'number');
>         $num->assertNoUnits('number');
> 
>         return new Number($num->getDimension() * 100, '%');


    }


<     protected static $libRound = ['value'];



>     protected static $libRound = ['number'];


    protected function libRound($args)
    {

<         $num = $args[0];



>         $num = $this->assertNumber($args[0], 'number');




<         return new Node\Number(round($num[1]), $num[2]);



>         return new Number(round($num->getDimension()), $num->getNumeratorUnits(), $num->getDenominatorUnits());


    }


<     protected static $libFloor = ['value'];



>     protected static $libFloor = ['number'];


    protected function libFloor($args)
    {

<         $num = $args[0];



>         $num = $this->assertNumber($args[0], 'number');




<         return new Node\Number(floor($num[1]), $num[2]);



>         return new Number(floor($num->getDimension()), $num->getNumeratorUnits(), $num->getDenominatorUnits());


    }


<     protected static $libCeil = ['value'];



>     protected static $libCeil = ['number'];


    protected function libCeil($args)
    {

<         $num = $args[0];



>         $num = $this->assertNumber($args[0], 'number');




<         return new Node\Number(ceil($num[1]), $num[2]);



>         return new Number(ceil($num->getDimension()), $num->getNumeratorUnits(), $num->getDenominatorUnits());


    }


<     protected static $libAbs = ['value'];



>     protected static $libAbs = ['number'];


    protected function libAbs($args)
    {

<         $num = $args[0];



>         $num = $this->assertNumber($args[0], 'number');




<         return new Node\Number(abs($num[1]), $num[2]);



>         return new Number(abs($num->getDimension()), $num->getNumeratorUnits(), $num->getDenominatorUnits());


    }


>     protected static $libMin = ['numbers...'];


    protected function libMin($args)
    {

<         $numbers = $this->getNormalizedNumbers($args);



>         /**
>          * @var Number|null
>          */


        $min = null;


<         foreach ($numbers as $key => $number) {
<             if (is_null($min) || $number[1] <= $min[1]) {
<                 $min = [$key, $number[1]];
<             }
<         }



>         foreach ($args[0][2] as $arg) {
>             $number = $this->assertNumber($arg);




<         return $args[$min[0]];



>             if (\is_null($min) || $min->greaterThan($number)) {
>                 $min = $number;


    }

< 
<     protected function libMax($args)
<     {
<         $numbers = $this->getNormalizedNumbers($args);
<         $max = null;
< 
<         foreach ($numbers as $key => $number) {
<             if (is_null($max) || $number[1] >= $max[1]) {
<                 $max = [$key, $number[1]];


            }

> 
        }
>         if (!\is_null($min)) {

>             return $min;



<         return $args[$max[0]];



>         throw $this->error('At least one argument must be passed.');


    }


>     protected static $libMax = ['numbers...'];
    /**
>     protected function libMax($args)
     * Helper to normalize args containing numbers
>     {



<      * Helper to normalize args containing numbers
<      *
<      * @param array $args
<      *
<      * @return array



>          * @var Number|null



<     protected function getNormalizedNumbers($args)
<     {
<         $unit         = null;
<         $originalUnit = null;
<         $numbers      = [];
< 
<         foreach ($args as $key => $item) {
<             if ($item[0] !== Type::T_NUMBER) {
<                 $this->throwError('%s is not a number', $item[0]);
<                 break;
<             }



>         $max = null;




<             $number = $item->normalize();



>         foreach ($args[0][2] as $arg) {
>             $number = $this->assertNumber($arg);




<             if (is_null($unit)) {
<                 $unit = $number[2];
<                 $originalUnit = $item->unitStr();
<             } elseif ($number[1] && $unit !== $number[2]) {
<                 $this->throwError('Incompatible units: "%s" and "%s".', $originalUnit, $item->unitStr());
<                 break;



>             if (\is_null($max) || $max->lessThan($number)) {
>                 $max = $number;
>             }


            }


<             $numbers[$key] = $number;



>         if (!\is_null($max)) {
>             return $max;


        }


<         return $numbers;



>         throw $this->error('At least one argument must be passed.');


    }

    protected static $libLength = ['list'];
    protected function libLength($args)
    {

<         $list = $this->coerceList($args[0]);



>         $list = $this->coerceList($args[0], ',', true);




<         return count($list[2]);



>         return new Number(\count($list[2]), '');


    }


<     //protected static $libListSeparator = ['list...'];



>     protected static $libListSeparator = ['list'];


    protected function libListSeparator($args)
    {

<         if (count($args) > 1) {
<             return 'comma';



>         if (! \in_array($args[0][0], [Type::T_LIST, Type::T_MAP])) {
>             return [Type::T_KEYWORD, 'space'];


        }

        $list = $this->coerceList($args[0]);


<         if (count($list[2]) <= 1) {
<             return 'space';



>         if ($list[1] === '' && \count($list[2]) <= 1 && empty($list['enclosing'])) {
>             return [Type::T_KEYWORD, 'space'];


        }

        if ($list[1] === ',') {

<             return 'comma';



>             return [Type::T_KEYWORD, 'comma'];


        }


<         return 'space';



>         if ($list[1] === '/') {
>             return [Type::T_KEYWORD, 'slash'];
>         }
> 
>         return [Type::T_KEYWORD, 'space'];


    }

    protected static $libNth = ['list', 'n'];
    protected function libNth($args)
    {

<         $list = $this->coerceList($args[0]);
<         $n = $this->assertNumber($args[1]);



>         $list = $this->coerceList($args[0], ',', false);
>         $n = $this->assertInteger($args[1]);



        if ($n > 0) {
            $n--;
        } elseif ($n < 0) {

<             $n += count($list[2]);



>             $n += \count($list[2]);


        }

        return isset($list[2][$n]) ? $list[2][$n] : static::$defaultValue;
    }

    protected static $libSetNth = ['list', 'n', 'value'];
    protected function libSetNth($args)
    {
        $list = $this->coerceList($args[0]);

<         $n = $this->assertNumber($args[1]);



>         $n = $this->assertInteger($args[1]);



        if ($n > 0) {
            $n--;
        } elseif ($n < 0) {

<             $n += count($list[2]);



>             $n += \count($list[2]);


        }

        if (! isset($list[2][$n])) {

<             $this->throwError('Invalid argument for "n"');
< 
<             return null;



>             throw $this->error('Invalid argument for "n"');


        }

        $list[2][$n] = $args[2];

        return $list;
    }


<     protected static $libMapGet = ['map', 'key'];



>     protected static $libMapGet = ['map', 'key', 'keys...'];


    protected function libMapGet($args)
    {

<         $map = $this->assertMap($args[0]);
<         $key = $args[1];



>         $map = $this->assertMap($args[0], 'map');
>         if (!isset($args[2])) {
>             // BC layer for usages of the function from PHP code rather than from the Sass function
>             $args[2] = self::$emptyArgumentList;
>         }
>         $keys = array_merge([$args[1]], $args[2][2]);
>         $value = static::$null;
> 
>         foreach ($keys as $key) {
>             if (!\is_array($map) || $map[0] !== Type::T_MAP) {
>                 return static::$null;
>             }
> 
>             $map = $this->mapGet($map, $key);
> 
>             if ($map === null) {
>                 return static::$null;
>             }
> 
>             $value = $map;
>         }
> 
>         return $value;
>     }
> 
>     /**
>      * Gets the value corresponding to that key in the map
>      *
>      * @param array        $map
>      * @param Number|array $key
>      *
>      * @return Number|array|null
>      */
>     private function mapGet(array $map, $key)
>     {
>         $index = $this->mapGetEntryIndex($map, $key);
> 
>         if ($index !== null) {
>             return $map[2][$index];
>         }




<         if (! is_null($key)) {



>         return null;
>     }
> 
>     /**
>      * Gets the index corresponding to that key in the map entries
>      *
>      * @param array        $map
>      * @param Number|array $key
>      *
>      * @return int|null
>      */
>     private function mapGetEntryIndex(array $map, $key)
>     {


            $key = $this->compileStringContent($this->coerceString($key));


<             for ($i = count($map[1]) - 1; $i >= 0; $i--) {



>         for ($i = \count($map[1]) - 1; $i >= 0; $i--) {


                if ($key === $this->compileStringContent($this->coerceString($map[1][$i]))) {

<                     return $map[2][$i];
<                 }



>                 return $i;


            }
        }


<         return static::$null;



>         return null;


    }

    protected static $libMapKeys = ['map'];
    protected function libMapKeys($args)
    {

<         $map = $this->assertMap($args[0]);



>         $map = $this->assertMap($args[0], 'map');


        $keys = $map[1];

        return [Type::T_LIST, ',', $keys];
    }

    protected static $libMapValues = ['map'];
    protected function libMapValues($args)
    {

<         $map = $this->assertMap($args[0]);



>         $map = $this->assertMap($args[0], 'map');


        $values = $map[2];

        return [Type::T_LIST, ',', $values];
    }


<     protected static $libMapRemove = ['map', 'key'];



>     protected static $libMapRemove = [
>         ['map'],
>         ['map', 'key', 'keys...'],
>     ];


    protected function libMapRemove($args)
    {

<         $map = $this->assertMap($args[0]);
<         $key = $this->compileStringContent($this->coerceString($args[1]));



>         $map = $this->assertMap($args[0], 'map');




<         for ($i = count($map[1]) - 1; $i >= 0; $i--) {
<             if ($key === $this->compileStringContent($this->coerceString($map[1][$i]))) {



>         if (\count($args) === 1) {
>             return $map;
>         }
> 
>         $keys = [];
>         $keys[] = $this->compileStringContent($this->coerceString($args[1]));
> 
>         foreach ($args[2][2] as $key) {
>             $keys[] = $this->compileStringContent($this->coerceString($key));
>         }
> 
>         for ($i = \count($map[1]) - 1; $i >= 0; $i--) {
>             if (in_array($this->compileStringContent($this->coerceString($map[1][$i])), $keys)) {


                array_splice($map[1], $i, 1);
                array_splice($map[2], $i, 1);
            }
        }

        return $map;
    }


<     protected static $libMapHasKey = ['map', 'key'];



>     protected static $libMapHasKey = ['map', 'key', 'keys...'];


    protected function libMapHasKey($args)
    {

<         $map = $this->assertMap($args[0]);
<         $key = $this->compileStringContent($this->coerceString($args[1]));



>         $map = $this->assertMap($args[0], 'map');
>         if (!isset($args[2])) {
>             // BC layer for usages of the function from PHP code rather than from the Sass function
>             $args[2] = self::$emptyArgumentList;
>         }
>         $keys = array_merge([$args[1]], $args[2][2]);
>         $lastKey = array_pop($keys);
> 
>         foreach ($keys as $key) {
>             $value = $this->mapGet($map, $key);
> 
>             if ($value === null || $value instanceof Number || $value[0] !== Type::T_MAP) {
>                 return self::$false;
>             }
> 
>             $map = $value;
>         }
> 
>         return $this->toBool($this->mapHasKey($map, $lastKey));
>     }
> 
>     /**
>      * @param array|Number $keyValue
>      *
>      * @return bool
>      */
>     private function mapHasKey(array $map, $keyValue)
>     {
>         $key = $this->compileStringContent($this->coerceString($keyValue));




<         for ($i = count($map[1]) - 1; $i >= 0; $i--) {



>         for ($i = \count($map[1]) - 1; $i >= 0; $i--) {


            if ($key === $this->compileStringContent($this->coerceString($map[1][$i]))) {
                return true;
            }
        }

        return false;
    }


<     protected static $libMapMerge = ['map-1', 'map-2'];



>     protected static $libMapMerge = [
>         ['map1', 'map2'],
>         ['map-1', 'map-2'],
>         ['map1', 'args...']
>     ];


    protected function libMapMerge($args)
    {

<         $map1 = $this->assertMap($args[0]);
<         $map2 = $this->assertMap($args[1]);



>         $map1 = $this->assertMap($args[0], 'map1');
>         $map2 = $args[1];
>         $keys = [];
>         if ($map2[0] === Type::T_LIST && isset($map2[3]) && \is_array($map2[3])) {
>             // This is an argument list for the variadic signature
>             if (\count($map2[2]) === 0) {
>                 throw new SassScriptException('Expected $args to contain a key.');
>             }
>             if (\count($map2[2]) === 1) {
>                 throw new SassScriptException('Expected $args to contain a value.');
>             }
>             $keys = $map2[2];
>             $map2 = array_pop($keys);
>         }
>         $map2 = $this->assertMap($map2, 'map2');




<         foreach ($map2[1] as $i2 => $key2) {
<             $key = $this->compileStringContent($this->coerceString($key2));



>         return $this->modifyMap($map1, $keys, function ($oldValue) use ($map2) {
>             $nestedMap = $this->tryMap($oldValue);




<             foreach ($map1[1] as $i1 => $key1) {
<                 if ($key === $this->compileStringContent($this->coerceString($key1))) {
<                     $map1[2][$i1] = $map2[2][$i2];
<                     continue 2;



>             if ($nestedMap === null) {
>                 return $map2;
>             }
> 
>             return $this->mergeMaps($nestedMap, $map2);
>         });
>     }
> 
>     /**
>      * @param array    $map
>      * @param array    $keys
>      * @param callable $modify
>      * @param bool     $addNesting
>      *
>      * @return Number|array
>      *
>      * @phpstan-param array<Number|array> $keys
>      * @phpstan-param callable(Number|array): (Number|array) $modify
>      */
>     private function modifyMap(array $map, array $keys, callable $modify, $addNesting = true)
>     {
>         if ($keys === []) {
>             return $modify($map);
>         }
> 
>         return $this->modifyNestedMap($map, $keys, $modify, $addNesting);
>     }
> 
>     /**
>      * @param array    $map
>      * @param array    $keys
>      * @param callable $modify
>      * @param bool     $addNesting
>      *
>      * @return array
>      *
>      * @phpstan-param non-empty-array<Number|array> $keys
>      * @phpstan-param callable(Number|array): (Number|array) $modify
>      */
>     private function modifyNestedMap(array $map, array $keys, callable $modify, $addNesting)
>     {
>         $key = array_shift($keys);
> 
>         $nestedValueIndex = $this->mapGetEntryIndex($map, $key);
> 
>         if ($keys === []) {
>             if ($nestedValueIndex !== null) {
>                 $map[2][$nestedValueIndex] = $modify($map[2][$nestedValueIndex]);
>             } else {
>                 $map[1][] = $key;
>                 $map[2][] = $modify(self::$null);
>             }
> 
>             return $map;
>         }
> 
>         $nestedMap = $nestedValueIndex !== null ? $this->tryMap($map[2][$nestedValueIndex]) : null;
> 
>         if ($nestedMap === null && !$addNesting) {
>             return $map;
>         }
> 
>         if ($nestedMap === null) {
>             $nestedMap = self::$emptyMap;
>         }
> 
>         $newNestedMap = $this->modifyNestedMap($nestedMap, $keys, $modify, $addNesting);
> 
>         if ($nestedValueIndex !== null) {
>             $map[2][$nestedValueIndex] = $newNestedMap;
>         } else {
>             $map[1][] = $key;
>             $map[2][] = $newNestedMap;
>         }
> 
>         return $map;


                }

> 
            }
>     /**

>      * Merges 2 Sass maps together
            $map1[1][] = $map2[1][$i2];
>      *
            $map1[2][] = $map2[2][$i2];
>      * @param array $map1
        }
>      * @param array $map2

>      *
        return $map1;
>      * @return array
    }
>      */

>     private function mergeMaps(array $map1, array $map2)
    protected static $libKeywords = ['args'];
>     {
    protected function libKeywords($args)
>         foreach ($map2[1] as $i2 => $key2) {
    {
>             $map1EntryIndex = $this->mapGetEntryIndex($map1, $key2);
        $this->assertList($args[0]);
> 

>             if ($map1EntryIndex !== null) {
        $keys = [];
>                 $map1[2][$map1EntryIndex] = $map2[2][$i2];
        $values = [];
>                 continue;



<             $map1[1][] = $map2[1][$i2];



>             $map1[1][] = $key2;



<         $this->assertList($args[0]);



>         $value = $args[0];
> 
>         if ($value[0] !== Type::T_LIST || !isset($value[3]) || !\is_array($value[3])) {
>             $compiledValue = $this->compileValue($value);
> 
>             throw SassScriptException::forArgument($compiledValue . ' is not an argument list.', 'args');
>         }



<         foreach ($args[0][2] as $name => $arg) {



>         foreach ($this->getArgumentListKeywords($value) as $name => $arg) {


            $values[] = $arg;
        }

        return [Type::T_MAP, $keys, $values];
    }

    protected static $libIsBracketed = ['list'];
    protected function libIsBracketed($args)
    {
        $list = $args[0];
        $this->coerceList($list, ' ');

> 


        if (! empty($list['enclosing']) && $list['enclosing'] === 'bracket') {

<             return true;
<         }
<         return false;



>             return self::$true;


    }


>         return self::$false;

>     }


    protected function listSeparatorForJoin($list1, $sep)

>     /**
    {
>      * @param array $list1
        if (! isset($sep)) {
>      * @param array|Number|null $sep
            return $list1[1];
>      *
        }
>      * @return string

>      * @throws CompilerException
        switch ($this->compileValue($sep)) {
>      *
            case 'comma':
>      * @deprecated
                return ',';
>      */




>         @trigger_error(sprintf('The "%s" method is deprecated.', __METHOD__), E_USER_DEPRECATED);
            case 'space':
> 


                return ' ';

            default:
                return $list1[1];
        }
    }


<     protected static $libJoin = ['list1', 'list2', 'separator:null', 'bracketed:auto'];



>     protected static $libJoin = ['list1', 'list2', 'separator:auto', 'bracketed:auto'];


    protected function libJoin($args)
    {
        list($list1, $list2, $sep, $bracketed) = $args;


<         $list1 = $this->coerceList($list1, ' ');
<         $list2 = $this->coerceList($list2, ' ');
<         $sep   = $this->listSeparatorForJoin($list1, $sep);



>         $list1 = $this->coerceList($list1, ' ', true);
>         $list2 = $this->coerceList($list2, ' ', true);
> 
>         switch ($this->compileStringContent($this->assertString($sep, 'separator'))) {
>             case 'comma':
>                 $separator = ',';
>                 break;
> 
>             case 'space':
>                 $separator = ' ';
>                 break;
> 
>             case 'slash':
>                 $separator = '/';
>                 break;
> 
>             case 'auto':
>                 if ($list1[1] !== '' || count($list1[2]) > 1 || !empty($list1['enclosing']) && $list1['enclosing'] !== 'parent') {
>                     $separator = $list1[1] ?: ' ';
>                 } elseif ($list2[1] !== '' || count($list2[2]) > 1 || !empty($list2['enclosing']) && $list2['enclosing'] !== 'parent') {
>                     $separator = $list2[1] ?: ' ';
>                 } else {
>                     $separator = ' ';
>                 }
>                 break;
> 
>             default:
>                 throw SassScriptException::forArgument('Must be "space", "comma", "slash", or "auto".', 'separator');
>         }



        if ($bracketed === static::$true) {
            $bracketed = true;
        } elseif ($bracketed === static::$false) {
            $bracketed = false;
        } elseif ($bracketed === [Type::T_KEYWORD, 'auto']) {
            $bracketed = 'auto';
        } elseif ($bracketed === static::$null) {
            $bracketed = false;
        } else {
            $bracketed = $this->compileValue($bracketed);
            $bracketed = ! ! $bracketed;

> 


            if ($bracketed === true) {
                $bracketed = true;
            }
        }

        if ($bracketed === 'auto') {
            $bracketed = false;

> 


            if (! empty($list1['enclosing']) && $list1['enclosing'] === 'bracket') {
                $bracketed = true;
            }
        }


<         $res = [Type::T_LIST, $sep, array_merge($list1[2], $list2[2])];
<         if (isset($list1['enclosing'])) {
<             $res['enlcosing'] = $list1['enclosing'];
<         }



>         $res = [Type::T_LIST, $separator, array_merge($list1[2], $list2[2])];
> 


        if ($bracketed) {
            $res['enclosing'] = 'bracket';
        }

> 


        return $res;
    }


<     protected static $libAppend = ['list', 'val', 'separator:null'];



>     protected static $libAppend = ['list', 'val', 'separator:auto'];


    protected function libAppend($args)
    {
        list($list1, $value, $sep) = $args;


<         $list1 = $this->coerceList($list1, ' ');
<         $sep = $this->listSeparatorForJoin($list1, $sep);



>         $list1 = $this->coerceList($list1, ' ', true);
> 
>         switch ($this->compileStringContent($this->assertString($sep, 'separator'))) {
>             case 'comma':
>                 $separator = ',';
>                 break;
> 
>             case 'space':
>                 $separator = ' ';
>                 break;
> 
>             case 'slash':
>                 $separator = '/';
>                 break;
> 
>             case 'auto':
>                 $separator = $list1[1] === '' && \count($list1[2]) <= 1 && (empty($list1['enclosing']) || $list1['enclosing'] === 'parent') ? ' ' : $list1[1];
>                 break;
> 
>             default:
>                 throw SassScriptException::forArgument('Must be "space", "comma", "slash", or "auto".', 'separator');
>         }
> 
>         $res = [Type::T_LIST, $separator, array_merge($list1[2], [$value])];




<         $res = [Type::T_LIST, $sep, array_merge($list1[2], [$value])];


        if (isset($list1['enclosing'])) {
            $res['enclosing'] = $list1['enclosing'];
        }

> 


        return $res;
    }


>     protected static $libZip = ['lists...'];


    protected function libZip($args)
    {

<         foreach ($args as $key => $arg) {
<             $args[$key] = $this->coerceList($arg);



>         $argLists = [];
>         foreach ($args[0][2] as $arg) {
>             $argLists[] = $this->coerceList($arg);


        }

        $lists = [];

<         $firstList = array_shift($args);



>         $firstList = array_shift($argLists);




>         $result = [Type::T_LIST, ',', $lists];
        foreach ($firstList[2] as $key => $item) {
>         if (! \is_null($firstList)) {


            $list = [Type::T_LIST, '', [$item]];


<             foreach ($args as $arg) {



>                 foreach ($argLists as $arg) {


                if (isset($arg[2][$key])) {
                    $list[2][] = $arg[2][$key];
                } else {
                    break 2;
                }
            }

            $lists[] = $list;
        }


<         return [Type::T_LIST, ',', $lists];



>             $result[2] = $lists;
>         } else {
>             $result['enclosing'] = 'parent';
>         }
> 
>         return $result;


    }

    protected static $libTypeOf = ['value'];
    protected function libTypeOf($args)
    {
        $value = $args[0];


>         return [Type::T_KEYWORD, $this->getTypeOf($value)];
        switch ($value[0]) {
>     }
            case Type::T_KEYWORD:
> 
                if ($value === static::$true || $value === static::$false) {
>     /**
                    return 'bool';
>      * @param array|Number $value
                }
>      *

>      * @return string
                if ($this->coerceColor($value)) {
>      */
                    return 'color';
>     private function getTypeOf($value)
                }
>     {



                // fall-thru
            case Type::T_FUNCTION:
                return 'string';


>             case Type::T_FUNCTION_REFERENCE:
            case Type::T_LIST:
>                 return 'function';
                if (isset($value[3]) && $value[3]) {
> 



<                 if (isset($value[3]) && $value[3]) {



>                 if (isset($value[3]) && \is_array($value[3])) {


                }

                // fall-thru
            default:
                return $value[0];
        }
    }

    protected static $libUnit = ['number'];
    protected function libUnit($args)
    {

<         $num = $args[0];



>         $num = $this->assertNumber($args[0], 'number');




<         if ($num[0] === Type::T_NUMBER) {


            return [Type::T_STRING, '"', [$num->unitStr()]];
        }


<         return '';
<     }
< 


    protected static $libUnitless = ['number'];
    protected function libUnitless($args)
    {

<         $value = $args[0];



>         $value = $this->assertNumber($args[0], 'number');




<         return $value[0] === Type::T_NUMBER && $value->unitless();



>         return $this->toBool($value->unitless());


    }


<     protected static $libComparable = ['number-1', 'number-2'];



>     protected static $libComparable = [
>         ['number1', 'number2'],
>         ['number-1', 'number-2']
>     ];


    protected function libComparable($args)
    {
        list($number1, $number2) = $args;


<         if (! isset($number1[0]) || $number1[0] !== Type::T_NUMBER ||
<             ! isset($number2[0]) || $number2[0] !== Type::T_NUMBER



>         if (
>             ! $number1 instanceof Number ||
>             ! $number2 instanceof Number


        ) {

<             $this->throwError('Invalid argument(s) for "comparable"');
< 
<             return null;



>             throw $this->error('Invalid argument(s) for "comparable"');


        }


<         $number1 = $number1->normalize();
<         $number2 = $number2->normalize();
< 
<         return $number1[2] === $number2[2] || $number1->unitless() || $number2->unitless();



>         return $this->toBool($number1->isComparableTo($number2));


    }

    protected static $libStrIndex = ['string', 'substring'];
    protected function libStrIndex($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'string');


        $stringContent = $this->compileStringContent($string);


<         $substring = $this->coerceString($args[1]);



>         $substring = $this->assertString($args[1], 'substring');


        $substringContent = $this->compileStringContent($substring);


<         $result = strpos($stringContent, $substringContent);



>         if (! \strlen($substringContent)) {
>             $result = 0;
>         } else {
>             $result = Util::mbStrpos($stringContent, $substringContent);
>         }




<         return $result === false ? static::$null : new Node\Number($result + 1, '');



>         return $result === false ? static::$null : new Number($result + 1, '');


    }

    protected static $libStrInsert = ['string', 'insert', 'index'];
    protected function libStrInsert($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'string');


        $stringContent = $this->compileStringContent($string);


<         $insert = $this->coerceString($args[1]);



>         $insert = $this->assertString($args[1], 'insert');


        $insertContent = $this->compileStringContent($insert);


<         list(, $index) = $args[2];



>         $index = $this->assertInteger($args[2], 'index');
>         if ($index > 0) {
>             $index = $index - 1;
>         }
>         if ($index < 0) {
>             $index = max(Util::mbStrlen($stringContent) + 1 + $index, 0);
>         }




<         $string[2] = [substr_replace($stringContent, $insertContent, $index - 1, 0)];



>         $string[2] = [
>             Util::mbSubstr($stringContent, 0, $index),
>             $insertContent,
>             Util::mbSubstr($stringContent, $index)
>         ];



        return $string;
    }

    protected static $libStrLength = ['string'];
    protected function libStrLength($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'string');


        $stringContent = $this->compileStringContent($string);


<         return new Node\Number(strlen($stringContent), '');



>         return new Number(Util::mbStrlen($stringContent), '');


    }

    protected static $libStrSlice = ['string', 'start-at', 'end-at:-1'];
    protected function libStrSlice($args)
    {

<         if (isset($args[2]) && ! $args[2][1]) {
<             return static::$nullString;



>         $string = $this->assertString($args[0], 'string');
>         $stringContent = $this->compileStringContent($string);
> 
>         $start = $this->assertNumber($args[1], 'start-at');
>         $start->assertNoUnits('start-at');
>         $startInt = $this->assertInteger($start, 'start-at');
>         $end = $this->assertNumber($args[2], 'end-at');
>         $end->assertNoUnits('end-at');
>         $endInt = $this->assertInteger($end, 'end-at');
> 
>         if ($endInt === 0) {
>             return [Type::T_STRING, $string[1], []];


        }


<         $string = $this->coerceString($args[0]);
<         $stringContent = $this->compileStringContent($string);



>         if ($startInt > 0) {
>             $startInt--;
>         }




<         $start = (int) $args[1][1];



>         if ($endInt < 0) {
>             $endInt = Util::mbStrlen($stringContent) + $endInt;
>         } else {
>             $endInt--;
>         }




<         if ($start > 0) {
<             $start--;



>         if ($endInt < $startInt) {
>             return [Type::T_STRING, $string[1], []];


        }


<         $end    = isset($args[2]) ? (int) $args[2][1] : -1;
<         $length = $end < 0 ? $end + 1 : ($end > 0 ? $end - $start : $end);



>         $length = $endInt - $startInt + 1; // The end of the slice is inclusive




<         $string[2] = $length
<             ? [substr($stringContent, $start, $length)]
<             : [substr($stringContent, $start)];



>         $string[2] = [Util::mbSubstr($stringContent, $startInt, $length)];



        return $string;
    }

    protected static $libToLowerCase = ['string'];
    protected function libToLowerCase($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'string');


        $stringContent = $this->compileStringContent($string);


<         $string[2] = [function_exists('mb_strtolower') ? mb_strtolower($stringContent) : strtolower($stringContent)];



>         $string[2] = [$this->stringTransformAsciiOnly($stringContent, 'strtolower')];



        return $string;
    }

    protected static $libToUpperCase = ['string'];
    protected function libToUpperCase($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'string');


        $stringContent = $this->compileStringContent($string);


<         $string[2] = [function_exists('mb_strtoupper') ? mb_strtoupper($stringContent) : strtoupper($stringContent)];



>         $string[2] = [$this->stringTransformAsciiOnly($stringContent, 'strtoupper')];



        return $string;
    }


>     /**
    protected static $libFeatureExists = ['feature'];
>      * Apply a filter on a string content, only on ascii chars
    protected function libFeatureExists($args)
>      * let extended chars untouched
    {
>      *
        $string = $this->coerceString($args[0]);
>      * @param string $stringContent
        $name = $this->compileStringContent($string);
>      * @param callable $filter

>      * @return string
        return $this->toBool(
>      */
            array_key_exists($name, $this->registeredFeatures) ? $this->registeredFeatures[$name] : false
>     protected function stringTransformAsciiOnly($stringContent, $filter)
        );
>     {
    }
>         $mblength = Util::mbStrlen($stringContent);

>         if ($mblength === strlen($stringContent)) {
    protected static $libFunctionExists = ['name'];
>             return $filter($stringContent);
    protected function libFunctionExists($args)
>         }
    {
>         $filteredString = "";
        $string = $this->coerceString($args[0]);
>         for ($i = 0; $i < $mblength; $i++) {
        $name = $this->compileStringContent($string);
>             $char = Util::mbSubstr($stringContent, $i, 1);

>             if (strlen($char) > 1) {
        // user defined functions
>                 $filteredString .= $char;
        if ($this->has(static::$namespaces['function'] . $name)) {
>             } else {
            return true;
>                 $filteredString .= $filter($char);
        }
>             }

>         }
        $name = $this->normalizeName($name);
> 

>         return $filteredString;
        if (isset($this->userFunctions[$name])) {
>     }
            return true;
> 



<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'feature');



<             array_key_exists($name, $this->registeredFeatures) ? $this->registeredFeatures[$name] : false



>             \array_key_exists($name, $this->registeredFeatures) ? $this->registeredFeatures[$name] : false



<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'name');



<             return true;



>             return self::$true;



<             return true;



>             return self::$true;



<         return $this->toBool(is_callable($f));



>         return $this->toBool(\is_callable($f));


    }

    protected static $libGlobalVariableExists = ['name'];
    protected function libGlobalVariableExists($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'name');


        $name = $this->compileStringContent($string);


<         return $this->has($name, $this->rootEnv);



>         return $this->toBool($this->has($name, $this->rootEnv));


    }

    protected static $libMixinExists = ['name'];
    protected function libMixinExists($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'name');


        $name = $this->compileStringContent($string);


<         return $this->has(static::$namespaces['mixin'] . $name);



>         return $this->toBool($this->has(static::$namespaces['mixin'] . $name));


    }

    protected static $libVariableExists = ['name'];
    protected function libVariableExists($args)
    {

<         $string = $this->coerceString($args[0]);



>         $string = $this->assertString($args[0], 'name');


        $name = $this->compileStringContent($string);


<         return $this->has($name);



>         return $this->toBool($this->has($name));


    }


>     protected static $libCounter = ['args...'];


    /**
     * Workaround IE7's content counter bug.
     *
     * @param array $args
     *
     * @return array
     */
    protected function libCounter($args)
    {

<         $list = array_map([$this, 'compileValue'], $args);



>         $list = array_map([$this, 'compileValue'], $args[0][2]);



        return [Type::T_STRING, '', ['counter(' . implode(',', $list) . ')']];
    }


<     protected static $libRandom = ['limit'];



>     protected static $libRandom = ['limit:null'];


    protected function libRandom($args)
    {

<         if (isset($args[0])) {
<             $n = $this->assertNumber($args[0]);



>         if (isset($args[0]) && $args[0] !== static::$null) {
>             $limit = $this->assertNumber($args[0], 'limit');




<             if ($n < 1) {
<                 $this->throwError("limit must be greater than or equal to 1");



>             if ($limit->hasUnits()) {
>                 $unitString = $limit->unitStr();
>                 $message = <<<TXT
> random() will no longer ignore \$limit units ($limit) in a future release.




<                 return null;



> Recommendation: random(\$limit / 1$unitString) * 1$unitString
> 
> To preserve current behavior: random(\$limit / 1$unitString)
> 
> More info: https://sass-lang.com/d/random-with-units
> 
> TXT;
> 
>                 Warn::deprecation($this->addLocationToMessage($message));
>             }
> 
>             $n = $this->assertInteger($limit, 'limit');
> 
>             if ($n < 1) {
>                 throw new SassScriptException("\$limit: Must be greater than 0, was $n.");


            }


<             return new Node\Number(mt_rand(1, $n), '');



>             return new Number(mt_rand(1, $n), '');


        }


<         return new Node\Number(mt_rand(1, mt_getrandmax()), '');



>         $max = mt_getrandmax();
>         return new Number(mt_rand(0, $max - 1) / $max, '');


    }


>     protected static $libUniqueId = [];


    protected function libUniqueId()
    {
        static $id;

        if (! isset($id)) {

<             $id = mt_rand(0, pow(36, 8));



>             $id = PHP_INT_SIZE === 4
>                 ? mt_rand(0, pow(36, 5)) . str_pad(mt_rand(0, pow(36, 5)) % 10000000, 7, '0', STR_PAD_LEFT)
>                 : mt_rand(0, pow(36, 8));


        }

        $id += mt_rand(0, 10) + 1;

        return [Type::T_STRING, '', ['u' . str_pad(base_convert($id, 10, 36), 8, '0', STR_PAD_LEFT)]];
    }


>     /**
    protected function inspectFormatValue($value, $force_enclosing_display = false)
>      * @param array|Number $value
    {
>      * @param bool         $force_enclosing_display
        if ($value === static::$null) {
>      *
            $value = [Type::T_KEYWORD, 'null'];
>      * @return array
        }
>      */


        $stringValue = [$value];

> 


        if ($value[0] === Type::T_LIST) {

> 
            if (end($value[2]) === static::$null) {
>         if ($value instanceof Number) {
                array_pop($value[2]);
>             return [Type::T_STRING, '', $stringValue];
                $value[2][] = [Type::T_STRING, '', ['']];
>         }
                $force_enclosing_display = true;
> 


            }

<             if (! empty($value['enclosing'])) {
<                 if ($force_enclosing_display
<                     || ($value['enclosing'] === 'bracket' )
<                     || !count($value[2])) {



> 
>             if (
>                 ! empty($value['enclosing']) &&
>                 ($force_enclosing_display ||
>                     ($value['enclosing'] === 'bracket') ||
>                     ! \count($value[2]))
>             ) {


                    $value['enclosing'] = 'forced_'.$value['enclosing'];
                    $force_enclosing_display = true;

>             } elseif (! \count($value[2])) {
                }
>                 $value['enclosing'] = 'forced_parent';



<             }



> 


            foreach ($value[2] as $k => $listelement) {
                $value[2][$k] = $this->inspectFormatValue($listelement, $force_enclosing_display);
            }

> 


            $stringValue = [$value];
        }

        return [Type::T_STRING, '', $stringValue];
    }

    protected static $libInspect = ['value'];
    protected function libInspect($args)
    {
        $value = $args[0];

> 


        return $this->inspectFormatValue($value);
    }

    /**
     * Preprocess selector args
     *
     * @param array $arg

>      * @param string|null $varname
     *
>      * @param bool        $allowParent



<      * @return array|boolean



>      * @return array


     */

<     protected function getSelectorArg($arg)



>     protected function getSelectorArg($arg, $varname = null, $allowParent = false)


    {
        static $parser = null;


<         if (is_null($parser)) {



>         if (\is_null($parser)) {


            $parser = $this->parserFactory(__METHOD__);
        }


<         $arg = $this->libUnquote([$arg]);



>         if (! $this->checkSelectorArgType($arg)) {
>             $var_value = $this->compileValue($arg);
>             throw SassScriptException::forArgument("$var_value is not a valid selector: it must be a string, a list of strings, or a list of lists of strings", $varname);
>         }
> 
> 
>         if ($arg[0] === Type::T_STRING) {
>             $arg[1] = '';
>         }


        $arg = $this->compileValue($arg);

        $parsedSelector = [];


<         if ($parser->parseSelector($arg, $parsedSelector)) {



>         if ($parser->parseSelector($arg, $parsedSelector, true)) {


            $selector = $this->evalSelectors($parsedSelector);
            $gluedSelector = $this->glueFunctionSelectors($selector);


>             if (! $allowParent) {
            return $gluedSelector;
>                 foreach ($gluedSelector as $selector) {
        }
>                     foreach ($selector as $s) {

>                         if (in_array(static::$selfSelector, $s)) {
        return false;
>                             throw SassScriptException::forArgument("Parent selectors aren't allowed here.", $varname);
    }
>                         }

>                     }
    /**
>                 }
     * Postprocess selector to output in right format
>             }
     *
> 


     * @param array $selectors

>         throw SassScriptException::forArgument("expected more input, invalid selector.", $varname);
     *
>     }
     * @return string
> 
     */
>     /**
    protected function formatOutputSelector($selectors)
>      * Check variable type for getSelectorArg() function
    {
>      * @param array $arg
        $selectors = $this->collapseSelectors($selectors, true);
>      * @param int $maxDepth

>      * @return bool
        return $selectors;
>      */
    }
>     protected function checkSelectorArgType($arg, $maxDepth = 2)

>     {
    protected static $libIsSuperselector = ['super', 'sub'];
>         if ($arg[0] === Type::T_LIST && $maxDepth > 0) {
    protected function libIsSuperselector($args)
>             foreach ($arg[2] as $elt) {
    {
>                 if (! $this->checkSelectorArgType($elt, $maxDepth - 1)) {
        list($super, $sub) = $args;
>                     return false;

>                 }
        $super = $this->getSelectorArg($super);
>             }
        $sub = $this->getSelectorArg($sub);
>             return true;

>         }
        return $this->isSuperSelector($super, $sub);
>         if (!in_array($arg[0], [Type::T_STRING, Type::T_KEYWORD])) {


    }

>         return true;

>     }



<      * @return string



>      * @return array



<         $selectors = $this->collapseSelectors($selectors, true);



>         $selectors = $this->collapseSelectorsAsList($selectors);



<         $super = $this->getSelectorArg($super);
<         $sub = $this->getSelectorArg($sub);



>         $super = $this->getSelectorArg($super, 'super');
>         $sub = $this->getSelectorArg($sub, 'sub');



<         return $this->isSuperSelector($super, $sub);



>         return $this->toBool($this->isSuperSelector($super, $sub));


     *

<      * @return boolean



>      * @return bool


     */
    protected function isSuperSelector($super, $sub)
    {
        // one and only one selector for each arg

<         if (! $super || count($super) !== 1) {
<             $this->throwError("Invalid super selector for isSuperSelector()");



>         if (! $super) {
>             throw $this->error('Invalid super selector for isSuperSelector()');
>         }
> 
>         if (! $sub) {
>             throw $this->error('Invalid sub selector for isSuperSelector()');


        }


<         if (! $sub || count($sub) !== 1) {
<             $this->throwError("Invalid sub selector for isSuperSelector()");



>         if (count($sub) > 1) {
>             foreach ($sub as $s) {
>                 if (! $this->isSuperSelector($super, [$s])) {
>                     return false;
>                 }
>             }
>             return true;
>         }
> 
>         if (count($super) > 1) {
>             foreach ($super as $s) {
>                 if ($this->isSuperSelector([$s], $sub)) {
>                     return true;
>                 }
>             }
>             return false;


        }

        $super = reset($super);
        $sub = reset($sub);

        $i = 0;
        $nextMustMatch = false;

        foreach ($super as $node) {
            $compound = '';

            array_walk_recursive(
                $node,
                function ($value, $key) use (&$compound) {
                    $compound .= $value;
                }
            );

            if ($this->isImmediateRelationshipCombinator($compound)) {
                if ($node !== $sub[$i]) {
                    return false;
                }

                $nextMustMatch = true;
                $i++;
            } else {

<                 while ($i < count($sub) && ! $this->isSuperPart($node, $sub[$i])) {



>                 while ($i < \count($sub) && ! $this->isSuperPart($node, $sub[$i])) {


                    if ($nextMustMatch) {
                        return false;
                    }

                    $i++;
                }


<                 if ($i >= count($sub)) {



>                 if ($i >= \count($sub)) {


                    return false;
                }

                $nextMustMatch = false;
                $i++;
            }
        }

        return true;
    }

    /**
     * Test a part of super selector again a part of sub selector
     *
     * @param array $superParts
     * @param array $subParts
     *

<      * @return boolean



>      * @return bool


     */
    protected function isSuperPart($superParts, $subParts)
    {
        $i = 0;

        foreach ($superParts as $superPart) {

<             while ($i < count($subParts) && $subParts[$i] !== $superPart) {



>             while ($i < \count($subParts) && $subParts[$i] !== $superPart) {


                $i++;
            }


<             if ($i >= count($subParts)) {



>             if ($i >= \count($subParts)) {


                return false;
            }

            $i++;
        }

        return true;
    }

    protected static $libSelectorAppend = ['selector...'];
    protected function libSelectorAppend($args)
    {
        // get the selector... list
        $args = reset($args);
        $args = $args[2];


<         if (count($args) < 1) {
<             $this->throwError("selector-append() needs at least 1 argument");



>         if (\count($args) < 1) {
>             throw $this->error('selector-append() needs at least 1 argument');


        }


<         $selectors = array_map([$this, 'getSelectorArg'], $args);



>         $selectors = [];
>         foreach ($args as $arg) {
>             $selectors[] = $this->getSelectorArg($arg, 'selector');
>         }



        return $this->formatOutputSelector($this->selectorAppend($selectors));
    }

    /**
     * Append parts of the last selector in the list to the previous, recursively
     *
     * @param array $selectors
     *
     * @return array
     *
     * @throws \ScssPhp\ScssPhp\Exception\CompilerException
     */
    protected function selectorAppend($selectors)
    {
        $lastSelectors = array_pop($selectors);

        if (! $lastSelectors) {

<             $this->throwError("Invalid selector list in selector-append()");



>             throw $this->error('Invalid selector list in selector-append()');


        }


<         while (count($selectors)) {



>         while (\count($selectors)) {


            $previousSelectors = array_pop($selectors);

            if (! $previousSelectors) {

<                 $this->throwError("Invalid selector list in selector-append()");



>                 throw $this->error('Invalid selector list in selector-append()');


            }

            // do the trick, happening $lastSelector to $previousSelector
            $appended = [];


>             foreach ($previousSelectors as $previousSelector) {


            foreach ($lastSelectors as $lastSelector) {

<                 $previous = $previousSelectors;
< 



>                     $previous = $previousSelector;
>                     foreach ($previousSelector as $j => $previousSelectorParts) {


                foreach ($lastSelector as $lastSelectorParts) {
                    foreach ($lastSelectorParts as $lastSelectorPart) {

<                         foreach ($previous as $i => $previousSelector) {
<                             foreach ($previousSelector as $j => $previousSelectorParts) {
<                                 $previous[$i][$j][] = $lastSelectorPart;
<                             }



>                                 $previous[$j][] = $lastSelectorPart;


                        }
                    }
                }


<                 foreach ($previous as $ps) {
<                     $appended[] = $ps;



>                     $appended[] = $previous;


                }
            }

            $lastSelectors = $appended;
        }

        return $lastSelectors;
    }


<     protected static $libSelectorExtend = ['selectors', 'extendee', 'extender'];



>     protected static $libSelectorExtend = [
>         ['selector', 'extendee', 'extender'],
>         ['selectors', 'extendee', 'extender']
>     ];


    protected function libSelectorExtend($args)
    {
        list($selectors, $extendee, $extender) = $args;


<         $selectors = $this->getSelectorArg($selectors);
<         $extendee  = $this->getSelectorArg($extendee);
<         $extender  = $this->getSelectorArg($extender);



>         $selectors = $this->getSelectorArg($selectors, 'selector');
>         $extendee  = $this->getSelectorArg($extendee, 'extendee');
>         $extender  = $this->getSelectorArg($extender, 'extender');



        if (! $selectors || ! $extendee || ! $extender) {

<             $this->throwError("selector-extend() invalid arguments");



>             throw $this->error('selector-extend() invalid arguments');


        }

        $extended = $this->extendOrReplaceSelectors($selectors, $extendee, $extender);

        return $this->formatOutputSelector($extended);
    }


<     protected static $libSelectorReplace = ['selectors', 'original', 'replacement'];



>     protected static $libSelectorReplace = [
>         ['selector', 'original', 'replacement'],
>         ['selectors', 'original', 'replacement']
>     ];


    protected function libSelectorReplace($args)
    {
        list($selectors, $original, $replacement) = $args;


<         $selectors   = $this->getSelectorArg($selectors);
<         $original    = $this->getSelectorArg($original);
<         $replacement = $this->getSelectorArg($replacement);



>         $selectors   = $this->getSelectorArg($selectors, 'selector');
>         $original    = $this->getSelectorArg($original, 'original');
>         $replacement = $this->getSelectorArg($replacement, 'replacement');



        if (! $selectors || ! $original || ! $replacement) {

<             $this->throwError("selector-replace() invalid arguments");



>             throw $this->error('selector-replace() invalid arguments');


        }

        $replaced = $this->extendOrReplaceSelectors($selectors, $original, $replacement, true);

        return $this->formatOutputSelector($replaced);
    }

    /**
     * Extend/replace in selectors
     * used by selector-extend and selector-replace that use the same logic
     *
     * @param array   $selectors
     * @param array   $extendee
     * @param array   $extender

<      * @param boolean $replace



>      * @param bool  $replace


     *
     * @return array
     */
    protected function extendOrReplaceSelectors($selectors, $extendee, $extender, $replace = false)
    {
        $saveExtends = $this->extends;
        $saveExtendsMap = $this->extendsMap;

        $this->extends = [];
        $this->extendsMap = [];

        foreach ($extendee as $es) {

>             if (\count($es) !== 1) {
            // only use the first one
>                 throw $this->error('Can\'t extend complex selector.');
            $this->pushExtends(reset($es), $extender, null);
>             }
        }
> 



        $extended = [];

        foreach ($selectors as $selector) {
            if (! $replace) {
                $extended[] = $selector;
            }


<             $n = count($extended);



>             $n = \count($extended);



            $this->matchExtends($selector, $extended);

            // if didnt match, keep the original selector if we are in a replace operation

<             if ($replace and count($extended) === $n) {



>             if ($replace && \count($extended) === $n) {


                $extended[] = $selector;
            }
        }

        $this->extends = $saveExtends;
        $this->extendsMap = $saveExtendsMap;

        return $extended;
    }

    protected static $libSelectorNest = ['selector...'];
    protected function libSelectorNest($args)
    {
        // get the selector... list
        $args = reset($args);
        $args = $args[2];


<         if (count($args) < 1) {
<             $this->throwError("selector-nest() needs at least 1 argument");



>         if (\count($args) < 1) {
>             throw $this->error('selector-nest() needs at least 1 argument');
>         }
> 
>         $selectorsMap = [];
>         foreach ($args as $arg) {
>             $selectorsMap[] = $this->getSelectorArg($arg, 'selector', true);


        }


<         $selectorsMap = array_map([$this, 'getSelectorArg'], $args);



>         assert(!empty($selectorsMap));
> 


        $envs = [];

        foreach ($selectorsMap as $selectors) {
            $env = new Environment();
            $env->selectors = $selectors;

            $envs[] = $env;
        }

        $envs            = array_reverse($envs);
        $env             = $this->extractEnv($envs);
        $outputSelectors = $this->multiplySelectors($env);

        return $this->formatOutputSelector($outputSelectors);
    }


<     protected static $libSelectorParse = ['selectors'];



>     protected static $libSelectorParse = [
>         ['selector'],
>         ['selectors']
>     ];


    protected function libSelectorParse($args)
    {
        $selectors = reset($args);

<         $selectors = $this->getSelectorArg($selectors);



>         $selectors = $this->getSelectorArg($selectors, 'selector');



        return $this->formatOutputSelector($selectors);
    }

    protected static $libSelectorUnify = ['selectors1', 'selectors2'];
    protected function libSelectorUnify($args)
    {
        list($selectors1, $selectors2) = $args;


<         $selectors1 = $this->getSelectorArg($selectors1);
<         $selectors2 = $this->getSelectorArg($selectors2);



>         $selectors1 = $this->getSelectorArg($selectors1, 'selectors1');
>         $selectors2 = $this->getSelectorArg($selectors2, 'selectors2');



        if (! $selectors1 || ! $selectors2) {

<             $this->throwError("selector-unify() invalid arguments");



>             throw $this->error('selector-unify() invalid arguments');


        }

        // only consider the first compound of each
        $compound1 = reset($selectors1);
        $compound2 = reset($selectors2);

        // unify them and that's it
        $unified = $this->unifyCompoundSelectors($compound1, $compound2);

        return $this->formatOutputSelector($unified);
    }

    /**
     * The selector-unify magic as its best
     * (at least works as expected on test cases)
     *
     * @param array $compound1
     * @param array $compound2
     *

<      * @return array|mixed



>      * @return array


     */
    protected function unifyCompoundSelectors($compound1, $compound2)
    {

<         if (! count($compound1)) {



>         if (! \count($compound1)) {


            return $compound2;
        }


<         if (! count($compound2)) {



>         if (! \count($compound2)) {


            return $compound1;
        }

        // check that last part are compatible
        $lastPart1 = array_pop($compound1);
        $lastPart2 = array_pop($compound2);
        $last      = $this->mergeParts($lastPart1, $lastPart2);

        if (! $last) {
            return [[]];
        }

        $unifiedCompound = [$last];
        $unifiedSelectors = [$unifiedCompound];

        // do the rest

<         while (count($compound1) || count($compound2)) {



>         while (\count($compound1) || \count($compound2)) {


            $part1 = end($compound1);
            $part2 = end($compound2);

            if ($part1 && ($match2 = $this->matchPartInCompound($part1, $compound2))) {
                list($compound2, $part2, $after2) = $match2;

                if ($after2) {
                    $unifiedSelectors = $this->prependSelectors($unifiedSelectors, $after2);
                }

                $c = $this->mergeParts($part1, $part2);
                $unifiedSelectors = $this->prependSelectors($unifiedSelectors, [$c]);

                $part1 = $part2 = null;

                array_pop($compound1);
            }

            if ($part2 && ($match1 = $this->matchPartInCompound($part2, $compound1))) {
                list($compound1, $part1, $after1) = $match1;

                if ($after1) {
                    $unifiedSelectors = $this->prependSelectors($unifiedSelectors, $after1);
                }

                $c = $this->mergeParts($part2, $part1);
                $unifiedSelectors = $this->prependSelectors($unifiedSelectors, [$c]);

                $part1 = $part2 = null;

                array_pop($compound2);
            }

            $new = [];

            if ($part1 && $part2) {
                array_pop($compound1);
                array_pop($compound2);

                $s   = $this->prependSelectors($unifiedSelectors, [$part2]);
                $new = array_merge($new, $this->prependSelectors($s, [$part1]));
                $s   = $this->prependSelectors($unifiedSelectors, [$part1]);
                $new = array_merge($new, $this->prependSelectors($s, [$part2]));
            } elseif ($part1) {
                array_pop($compound1);

                $new = array_merge($new, $this->prependSelectors($unifiedSelectors, [$part1]));
            } elseif ($part2) {
                array_pop($compound2);

                $new = array_merge($new, $this->prependSelectors($unifiedSelectors, [$part2]));
            }

            if ($new) {
                $unifiedSelectors = $new;
            }
        }

        return $unifiedSelectors;
    }

    /**
     * Prepend each selector from $selectors with $parts
     *
     * @param array $selectors
     * @param array $parts
     *
     * @return array
     */
    protected function prependSelectors($selectors, $parts)
    {
        $new = [];

        foreach ($selectors as $compoundSelector) {
            array_unshift($compoundSelector, $parts);

            $new[] = $compoundSelector;
        }

        return $new;
    }

    /**
     * Try to find a matching part in a compound:
     * - with same html tag name
     * - with some class or id or something in common
     *
     * @param array $part
     * @param array $compound
     *

<      * @return array|boolean



>      * @return array|false


     */
    protected function matchPartInCompound($part, $compound)
    {
        $partTag = $this->findTagName($part);
        $before  = $compound;
        $after   = [];

        // try to find a match by tag name first

<         while (count($before)) {



>         while (\count($before)) {


            $p = array_pop($before);

            if ($partTag && $partTag !== '*' && $partTag == $this->findTagName($p)) {
                return [$before, $p, $after];
            }

            $after[] = $p;
        }

        // try again matching a non empty intersection and a compatible tagname
        $before = $compound;
        $after = [];


<         while (count($before)) {



>         while (\count($before)) {


            $p = array_pop($before);

            if ($this->checkCompatibleTags($partTag, $this->findTagName($p))) {

<                 if (count(array_intersect($part, $p))) {



>                 if (\count(array_intersect($part, $p))) {


                    return [$before, $p, $after];
                }
            }

            $after[] = $p;
        }

        return false;
    }

    /**
     * Merge two part list taking care that
     * - the html tag is coming first - if any
     * - the :something are coming last
     *
     * @param array $parts1
     * @param array $parts2
     *
     * @return array
     */
    protected function mergeParts($parts1, $parts2)
    {
        $tag1 = $this->findTagName($parts1);
        $tag2 = $this->findTagName($parts2);
        $tag  = $this->checkCompatibleTags($tag1, $tag2);

        // not compatible tags
        if ($tag === false) {
            return [];
        }

        if ($tag) {
            if ($tag1) {
                $parts1 = array_diff($parts1, [$tag1]);
            }

            if ($tag2) {
                $parts2 = array_diff($parts2, [$tag2]);
            }
        }

        $mergedParts = array_merge($parts1, $parts2);
        $mergedOrderedParts = [];

        foreach ($mergedParts as $part) {
            if (strpos($part, ':') === 0) {
                $mergedOrderedParts[] = $part;
            }
        }

        $mergedParts = array_diff($mergedParts, $mergedOrderedParts);
        $mergedParts = array_merge($mergedParts, $mergedOrderedParts);

        if ($tag) {
            array_unshift($mergedParts, $tag);
        }

        return $mergedParts;
    }

    /**
     * Check the compatibility between two tag names:
     * if both are defined they should be identical or one has to be '*'
     *
     * @param string $tag1
     * @param string $tag2
     *

<      * @return array|boolean



>      * @return array|false


     */
    protected function checkCompatibleTags($tag1, $tag2)
    {
        $tags = [$tag1, $tag2];
        $tags = array_unique($tags);
        $tags = array_filter($tags);


<         if (count($tags) > 1) {



>         if (\count($tags) > 1) {


            $tags = array_diff($tags, ['*']);
        }

        // not compatible nodes

<         if (count($tags) > 1) {



>         if (\count($tags) > 1) {


            return false;
        }

        return $tags;
    }

    /**
     * Find the html tag name in a selector parts list
     *

<      * @param array $parts



>      * @param string[] $parts


     *

<      * @return mixed|string



>      * @return string


     */
    protected function findTagName($parts)
    {
        foreach ($parts as $part) {
            if (! preg_match('/^[\[.:#%_-]/', $part)) {
                return $part;
            }
        }

        return '';
    }

    protected static $libSimpleSelectors = ['selector'];
    protected function libSimpleSelectors($args)
    {
        $selector = reset($args);

<         $selector = $this->getSelectorArg($selector);



>         $selector = $this->getSelectorArg($selector, 'selector');



        // remove selectors list layer, keeping the first one
        $selector = reset($selector);

        // remove parts list layer, keeping the first part
        $part = reset($selector);

        $listParts = [];

        foreach ($part as $p) {
            $listParts[] = [Type::T_STRING, '', [$p]];

>         }
        }
> 

>         return [Type::T_LIST, ',', $listParts];
        return [Type::T_LIST, ',', $listParts];
>     }
    }
> 
}
>     protected static $libScssphpGlob = ['pattern'];
>     protected function libScssphpGlob($args)
>     {
>         @trigger_error(sprintf('The "scssphp-glob" function is deprecated an will be removed in ScssPhp 2.0. Register your own alternative through "%s::registerFunction', __CLASS__), E_USER_DEPRECATED);
> 
>         $this->logger->warn('The "scssphp-glob" function is deprecated an will be removed in ScssPhp 2.0.', true);
> 
>         $string = $this->assertString($args[0], 'pattern');
>         $pattern = $this->compileStringContent($string);
>         $matches = glob($pattern);
>         $listParts = [];
> 
>         foreach ($matches as $match) {
>             if (! is_file($match)) {
>                 continue;
>             }
> 
>             $listParts[] = [Type::T_STRING, '"', [$match]];