ParserTest.php

<?php

namespace Sabberworm\CSS\Tests;

use PHPUnit\Framework\TestCase;
use Sabberworm\CSS\CSSList\Document;
use Sabberworm\CSS\CSSList\KeyFrame;
use Sabberworm\CSS\OutputFormat;
use Sabberworm\CSS\Parser;
use Sabberworm\CSS\Parsing\OutputException;
use Sabberworm\CSS\Parsing\SourceException;
use Sabberworm\CSS\Parsing\UnexpectedTokenException;
use Sabberworm\CSS\Property\AtRule;
use Sabberworm\CSS\Property\Charset;
use Sabberworm\CSS\Property\CSSNamespace;
use Sabberworm\CSS\Property\Import;
use Sabberworm\CSS\Property\Selector;
use Sabberworm\CSS\RuleSet\AtRuleSet;
use Sabberworm\CSS\RuleSet\DeclarationBlock;
use Sabberworm\CSS\RuleSet\RuleSet;
use Sabberworm\CSS\Settings;
use Sabberworm\CSS\Value\Color;
use Sabberworm\CSS\Value\Size;
use Sabberworm\CSS\Value\URL;

/**
 * @covers \Sabberworm\CSS\Parser
 * @covers \Sabberworm\CSS\CSSList\Document::parse
 * @covers \Sabberworm\CSS\Rule\Rule::parse
 * @covers \Sabberworm\CSS\RuleSet\DeclarationBlock::parse
 * @covers \Sabberworm\CSS\Value\CalcFunction::parse
 * @covers \Sabberworm\CSS\Value\Color::parse
 * @covers \Sabberworm\CSS\Value\CSSString::parse
 * @covers \Sabberworm\CSS\Value\LineName::parse
 * @covers \Sabberworm\CSS\Value\Size::parse
 * @covers \Sabberworm\CSS\Value\URL::parse
 */
final class ParserTest extends TestCase
{
    /**
     * @test
     */
    public function parseForOneRuleSetReturnsDocumentWithOneRuleSet(): void
    {
        $css = '.thing { left: 10px; }';
        $parser = new Parser($css);

        $document = $parser->parse();

        self::assertInstanceOf(Document::class, $document);

        $cssList = $document->getContents();
        self::assertCount(1, $cssList);
        self::assertInstanceOf(RuleSet::class, $cssList[0]);
    }

    /**
     * @test
     */
    public function files(): void
    {
        $sDirectory = __DIR__ . '/fixtures';
        if ($rHandle = \opendir($sDirectory)) {
            /* This is the correct way to loop over the directory. */
            while (false !== ($sFileName = \readdir($rHandle))) {
                if (\strpos($sFileName, '.') === 0) {
                    continue;
                }
                if (\strrpos($sFileName, '.css') !== \strlen($sFileName) - \strlen('.css')) {
                    continue;
                }
                if (\strpos($sFileName, '-') === 0) {
                    // Either a file which SHOULD fail (at least in strict mode)
                    // or a future test of a as-of-now missing feature
                    continue;
                }
                $oParser = new Parser(\file_get_contents($sDirectory . '/' . $sFileName));
                try {
                    self::assertNotEquals('', $oParser->parse()->render());
                } catch (\Exception $e) {
                    self::fail($e);
                }
            }
            \closedir($rHandle);
        }
    }

    /**
     * @depends files
     *
     * @test
     */
    public function colorParsing(): void
    {
        $oDoc = self::parsedStructureForFile('colortest');
        foreach ($oDoc->getAllRuleSets() as $oRuleSet) {
            if (!$oRuleSet instanceof DeclarationBlock) {
                continue;
            }
            $sSelector = $oRuleSet->getSelectors();
            $sSelector = $sSelector[0]->getSelector();
            if ($sSelector === '#mine') {
                $aColorRule = $oRuleSet->getRules('color');
                $oColor = $aColorRule[0]->getValue();
                self::assertSame('red', $oColor);
                $aColorRule = $oRuleSet->getRules('background-');
                $oColor = $aColorRule[0]->getValue();
                self::assertEquals([
                    'r' => new Size(35.0, null, true, $oColor->getLineNo()),
                    'g' => new Size(35.0, null, true, $oColor->getLineNo()),
                    'b' => new Size(35.0, null, true, $oColor->getLineNo()),
                ], $oColor->getColor());
                $aColorRule = $oRuleSet->getRules('border-color');
                $oColor = $aColorRule[0]->getValue();
                self::assertEquals([
                    'r' => new Size(10.0, null, true, $oColor->getLineNo()),
                    'g' => new Size(100.0, null, true, $oColor->getLineNo()),
                    'b' => new Size(230.0, null, true, $oColor->getLineNo()),
                ], $oColor->getColor());
                $oColor = $aColorRule[1]->getValue();
                self::assertEquals([
                    'r' => new Size(10.0, null, true, $oColor->getLineNo()),
                    'g' => new Size(100.0, null, true, $oColor->getLineNo()),
                    'b' => new Size(231.0, null, true, $oColor->getLineNo()),
                    'a' => new Size('0000.3', null, true, $oColor->getLineNo()),
                ], $oColor->getColor());
                $aColorRule = $oRuleSet->getRules('outline-color');
                $oColor = $aColorRule[0]->getValue();
                self::assertEquals([
                    'r' => new Size(34.0, null, true, $oColor->getLineNo()),
                    'g' => new Size(34.0, null, true, $oColor->getLineNo()),
                    'b' => new Size(34.0, null, true, $oColor->getLineNo()),
                ], $oColor->getColor());
            } elseif ($sSelector === '#yours') {
                $aColorRule = $oRuleSet->getRules('background-color');
                $oColor = $aColorRule[0]->getValue();
                self::assertEquals([
                    'h' => new Size(220.0, null, true, $oColor->getLineNo()),
                    's' => new Size(10.0, '%', true, $oColor->getLineNo()),
                    'l' => new Size(220.0, '%', true, $oColor->getLineNo()),
                ], $oColor->getColor());
                $oColor = $aColorRule[1]->getValue();
                self::assertEquals([
                    'h' => new Size(220.0, null, true, $oColor->getLineNo()),
                    's' => new Size(10.0, '%', true, $oColor->getLineNo()),
                    'l' => new Size(220.0, '%', true, $oColor->getLineNo()),
                    'a' => new Size(0000.3, null, true, $oColor->getLineNo()),
                ], $oColor->getColor());
                $aColorRule = $oRuleSet->getRules('outline-color');
                self::assertEmpty($aColorRule);
            }
        }
        foreach ($oDoc->getAllValues('color') as $sColor) {
            self::assertSame('red', $sColor);
        }
        self::assertSame(
            '#mine {color: red;border-color: #0a64e6;border-color: rgba(10,100,231,.3);outline-color: #222;'
            . 'background-color: #232323;}'
            . "\n"
            . '#yours {background-color: hsl(220,10%,220%);background-color: hsla(220,10%,220%,.3);}'
            . "\n"
            . '#variables {background-color: rgb(var(--some-rgb));background-color: rgb(var(--r),var(--g),var(--b));'
            . 'background-color: rgb(255,var(--g),var(--b));background-color: rgb(255,255,var(--b));'
            . 'background-color: rgb(255,var(--rg));background-color: hsl(var(--some-hsl));}'
            . "\n"
            . '#variables-alpha {background-color: rgba(var(--some-rgb),.1);'
            . 'background-color: rgba(var(--some-rg),255,.1);background-color: hsla(var(--some-hsl),.1);}',
            $oDoc->render()
        );
    }

    /**
     * @test
     */
    public function unicodeParsing(): void
    {
        $oDoc = self::parsedStructureForFile('unicode');
        foreach ($oDoc->getAllDeclarationBlocks() as $oRuleSet) {
            $sSelector = $oRuleSet->getSelectors();
            $sSelector = $sSelector[0]->getSelector();
            if (\substr($sSelector, 0, \strlen('.test-')) !== '.test-') {
                continue;
            }
            $aContentRules = $oRuleSet->getRules('content');
            $sString = $aContentRules[0]->getValue()->__toString();
            if ($sSelector == '.test-1') {
                self::assertSame('" "', $sString);
            }
            if ($sSelector == '.test-2') {
                self::assertSame('"é"', $sString);
            }
            if ($sSelector == '.test-3') {
                self::assertSame('" "', $sString);
            }
            if ($sSelector == '.test-4') {
                self::assertSame('"𝄞"', $sString);
            }
            if ($sSelector == '.test-5') {
                self::assertSame('"水"', $sString);
            }
            if ($sSelector == '.test-6') {
                self::assertSame('"¥"', $sString);
            }
            if ($sSelector == '.test-7') {
                self::assertSame('"\\A"', $sString);
            }
            if ($sSelector == '.test-8') {
                self::assertSame('"\\"\\""', $sString);
            }
            if ($sSelector == '.test-9') {
                self::assertSame('"\\"\\\'"', $sString);
            }
            if ($sSelector == '.test-10') {
                self::assertSame('"\\\'\\\\"', $sString);
            }
            if ($sSelector == '.test-11') {
                self::assertSame('"test"', $sString);
            }
        }
    }

    /**
     * @test
     */
    public function unicodeRangeParsing(): void
    {
        $oDoc = self::parsedStructureForFile('unicode-range');
        $sExpected = '@font-face {unicode-range: U+0100-024F,U+0259,U+1E??-2EFF,U+202F;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function specificity(): void
    {
        $oDoc = self::parsedStructureForFile('specificity');
        $oDeclarationBlock = $oDoc->getAllDeclarationBlocks();
        $oDeclarationBlock = $oDeclarationBlock[0];
        $aSelectors = $oDeclarationBlock->getSelectors();
        foreach ($aSelectors as $oSelector) {
            switch ($oSelector->getSelector()) {
                case '#test .help':
                    self::assertSame(110, $oSelector->getSpecificity());
                    break;
                case '#file':
                    self::assertSame(100, $oSelector->getSpecificity());
                    break;
                case '.help:hover':
                    self::assertSame(20, $oSelector->getSpecificity());
                    break;
                case 'ol li::before':
                    self::assertSame(3, $oSelector->getSpecificity());
                    break;
                case 'li.green':
                    self::assertSame(11, $oSelector->getSpecificity());
                    break;
                default:
                    self::fail('specificity: untested selector ' . $oSelector->getSelector());
            }
        }
        self::assertEquals([new Selector('#test .help', true)], $oDoc->getSelectorsBySpecificity('> 100'));
        self::assertEquals(
            [new Selector('#test .help', true), new Selector('#file', true)],
            $oDoc->getSelectorsBySpecificity('>= 100')
        );
        self::assertEquals([new Selector('#file', true)], $oDoc->getSelectorsBySpecificity('=== 100'));
        self::assertEquals([new Selector('#file', true)], $oDoc->getSelectorsBySpecificity('== 100'));
        self::assertEquals([
            new Selector('#file', true),
            new Selector('.help:hover', true),
            new Selector('li.green', true),
            new Selector('ol li::before', true),
        ], $oDoc->getSelectorsBySpecificity('<= 100'));
        self::assertEquals([
            new Selector('.help:hover', true),
            new Selector('li.green', true),
            new Selector('ol li::before', true),
        ], $oDoc->getSelectorsBySpecificity('< 100'));
        self::assertEquals([new Selector('li.green', true)], $oDoc->getSelectorsBySpecificity('11'));
        self::assertEquals([new Selector('ol li::before', true)], $oDoc->getSelectorsBySpecificity(3));
    }

    /**
     * @test
     */
    public function manipulation(): void
    {
        $oDoc = self::parsedStructureForFile('atrules');
        self::assertSame(
            '@charset "utf-8";'
            . "\n"
            . '@font-face {font-family: "CrassRoots";src: url("../media/cr.ttf");}'
            . "\n"
            . 'html, body {font-size: -.6em;}'
            . "\n"
            . '@keyframes mymove {from {top: 0px;}'
            . "\n\t"
            . 'to {top: 200px;}}'
            . "\n"
            . '@-moz-keyframes some-move {from {top: 0px;}'
            . "\n\t"
            . 'to {top: 200px;}}'
            . "\n"
            . '@supports ( (perspective: 10px) or (-moz-perspective: 10px) or (-webkit-perspective: 10px) or '
            . '(-ms-perspective: 10px) or (-o-perspective: 10px) ) {body {font-family: "Helvetica";}}'
            . "\n"
            . '@page :pseudo-class {margin: 2in;}'
            . "\n"
            . '@-moz-document url(https://www.w3.org/),'
            . "\n"
            . '               url-prefix(https://www.w3.org/Style/),'
            . "\n"
            . '               domain(mozilla.org),'
            . "\n"
            . '               regexp("https:.*") {body {color: purple;background: yellow;}}'
            . "\n"
            . '@media screen and (orientation: landscape) {@-ms-viewport {width: 1024px;height: 768px;}}'
            . "\n"
            . '@region-style #intro {p {color: blue;}}',
            $oDoc->render()
        );
        foreach ($oDoc->getAllDeclarationBlocks() as $oBlock) {
            foreach ($oBlock->getSelectors() as $oSelector) {
                //Loop over all selector parts (the comma-separated strings in a selector) and prepend the id
                $oSelector->setSelector('#my_id ' . $oSelector->getSelector());
            }
        }
        self::assertSame(
            '@charset "utf-8";'
            . "\n"
            . '@font-face {font-family: "CrassRoots";src: url("../media/cr.ttf");}'
            . "\n"
            . '#my_id html, #my_id body {font-size: -.6em;}'
            . "\n"
            . '@keyframes mymove {from {top: 0px;}'
            . "\n\t"
            . 'to {top: 200px;}}'
            . "\n"
            . '@-moz-keyframes some-move {from {top: 0px;}'
            . "\n\t"
            . 'to {top: 200px;}}'
            . "\n"
            . '@supports ( (perspective: 10px) or (-moz-perspective: 10px) or (-webkit-perspective: 10px) '
            . 'or (-ms-perspective: 10px) or (-o-perspective: 10px) ) {#my_id body {font-family: "Helvetica";}}'
            . "\n"
            . '@page :pseudo-class {margin: 2in;}'
            . "\n"
            . '@-moz-document url(https://www.w3.org/),'
            . "\n"
            . '               url-prefix(https://www.w3.org/Style/),'
            . "\n"
            . '               domain(mozilla.org),'
            . "\n"
            . '               regexp("https:.*") {#my_id body {color: purple;background: yellow;}}'
            . "\n"
            . '@media screen and (orientation: landscape) {@-ms-viewport {width: 1024px;height: 768px;}}'
            . "\n"
            . '@region-style #intro {#my_id p {color: blue;}}',
            $oDoc->render(OutputFormat::create()->setRenderComments(false))
        );

        $oDoc = self::parsedStructureForFile('values');
        self::assertSame(
            '#header {margin: 10px 2em 1cm 2%;font-family: Verdana,Helvetica,"Gill Sans",sans-serif;'
            . 'font-size: 10px;color: red !important;background-color: green;'
            . 'background-color: rgba(0,128,0,.7);frequency: 30Hz;transform: rotate(1turn);}
body {color: green;font: 75% "Lucida Grande","Trebuchet MS",Verdana,sans-serif;}',
            $oDoc->render()
        );
        foreach ($oDoc->getAllRuleSets() as $oRuleSet) {
            $oRuleSet->removeRule('font-');
        }
        self::assertSame(
            '#header {margin: 10px 2em 1cm 2%;color: red !important;background-color: green;'
            . 'background-color: rgba(0,128,0,.7);frequency: 30Hz;transform: rotate(1turn);}
body {color: green;}',
            $oDoc->render()
        );
        foreach ($oDoc->getAllRuleSets() as $oRuleSet) {
            $oRuleSet->removeRule('background-');
        }
        self::assertSame(
            '#header {margin: 10px 2em 1cm 2%;color: red !important;frequency: 30Hz;transform: rotate(1turn);}
body {color: green;}',
            $oDoc->render()
        );
    }

    /**
     * @test
     */
    public function ruleGetters(): void
    {
        $oDoc = self::parsedStructureForFile('values');
        $aBlocks = $oDoc->getAllDeclarationBlocks();
        $oHeaderBlock = $aBlocks[0];
        $oBodyBlock = $aBlocks[1];
        $aHeaderRules = $oHeaderBlock->getRules('background-');
        self::assertCount(2, $aHeaderRules);
        self::assertSame('background-color', $aHeaderRules[0]->getRule());
        self::assertSame('background-color', $aHeaderRules[1]->getRule());
        $aHeaderRules = $oHeaderBlock->getRulesAssoc('background-');
        self::assertCount(1, $aHeaderRules);
        self::assertTrue($aHeaderRules['background-color']->getValue() instanceof Color);
        self::assertSame('rgba', $aHeaderRules['background-color']->getValue()->getColorDescription());
        $oHeaderBlock->removeRule($aHeaderRules['background-color']);
        $aHeaderRules = $oHeaderBlock->getRules('background-');
        self::assertCount(1, $aHeaderRules);
        self::assertSame('green', $aHeaderRules[0]->getValue());
    }

    /**
     * @test
     */
    public function slashedValues(): void
    {
        $oDoc = self::parsedStructureForFile('slashed');
        self::assertSame(
            '.test {font: 12px/1.5 Verdana,Arial,sans-serif;border-radius: 5px 10px 5px 10px/10px 5px 10px 5px;}',
            $oDoc->render()
        );
        foreach ($oDoc->getAllValues(null) as $mValue) {
            if ($mValue instanceof Size && $mValue->isSize() && !$mValue->isRelative()) {
                $mValue->setSize($mValue->getSize() * 3);
            }
        }
        foreach ($oDoc->getAllDeclarationBlocks() as $oBlock) {
            $oRule = $oBlock->getRules('font');
            $oRule = $oRule[0];
            $oSpaceList = $oRule->getValue();
            self::assertSame(' ', $oSpaceList->getListSeparator());
            $oSlashList = $oSpaceList->getListComponents();
            $oCommaList = $oSlashList[1];
            $oSlashList = $oSlashList[0];
            self::assertSame(',', $oCommaList->getListSeparator());
            self::assertSame('/', $oSlashList->getListSeparator());
            $oRule = $oBlock->getRules('border-radius');
            $oRule = $oRule[0];
            $oSlashList = $oRule->getValue();
            self::assertSame('/', $oSlashList->getListSeparator());
            $oSpaceList1 = $oSlashList->getListComponents();
            $oSpaceList2 = $oSpaceList1[1];
            $oSpaceList1 = $oSpaceList1[0];
            self::assertSame(' ', $oSpaceList1->getListSeparator());
            self::assertSame(' ', $oSpaceList2->getListSeparator());
        }
        self::assertSame(
            '.test {font: 36px/1.5 Verdana,Arial,sans-serif;border-radius: 15px 30px 15px 30px/30px 15px 30px 15px;}',
            $oDoc->render()
        );
    }

    /**
     * @test
     */
    public function functionSyntax(): void
    {
        $oDoc = self::parsedStructureForFile('functions');
        $sExpected = 'div.main {background-image: linear-gradient(#000,#fff);}'
            . "\n"
            . '.collapser::before, .collapser::-moz-before, .collapser::-webkit-before {content: "»";font-size: 1.2em;'
            . 'margin-right: .2em;-moz-transition-property: -moz-transform;-moz-transition-duration: .2s;'
            . '-moz-transform-origin: center 60%;}'
            . "\n"
            . '.collapser.expanded::before, .collapser.expanded::-moz-before,'
            . ' .collapser.expanded::-webkit-before {-moz-transform: rotate(90deg);}'
            . "\n"
            . '.collapser + * {height: 0;overflow: hidden;-moz-transition-property: height;'
            . '-moz-transition-duration: .3s;}'
            . "\n"
            . '.collapser.expanded + * {height: auto;}';
        self::assertSame($sExpected, $oDoc->render());

        foreach ($oDoc->getAllValues(null, true) as $mValue) {
            if ($mValue instanceof Size && $mValue->isSize()) {
                $mValue->setSize($mValue->getSize() * 3);
            }
        }
        $sExpected = \str_replace(['1.2em', '.2em', '60%'], ['3.6em', '.6em', '180%'], $sExpected);
        self::assertSame($sExpected, $oDoc->render());

        foreach ($oDoc->getAllValues(null, true) as $mValue) {
            if ($mValue instanceof Size && !$mValue->isRelative() && !$mValue->isColorComponent()) {
                $mValue->setSize($mValue->getSize() * 2);
            }
        }
        $sExpected = \str_replace(['.2s', '.3s', '90deg'], ['.4s', '.6s', '180deg'], $sExpected);
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function expandShorthands(): void
    {
        $oDoc = self::parsedStructureForFile('expand-shorthands');
        $sExpected = 'body {font: italic 500 14px/1.618 "Trebuchet MS",Georgia,serif;border: 2px solid #f0f;'
            . 'background: #ccc url("/images/foo.png") no-repeat left top;margin: 1em !important;'
            . 'padding: 2px 6px 3px;}';
        self::assertSame($sExpected, $oDoc->render());
        $oDoc->expandShorthands();
        $sExpected = 'body {margin-top: 1em !important;margin-right: 1em !important;margin-bottom: 1em !important;'
            . 'margin-left: 1em !important;padding-top: 2px;padding-right: 6px;padding-bottom: 3px;'
            . 'padding-left: 6px;border-top-color: #f0f;border-right-color: #f0f;border-bottom-color: #f0f;'
            . 'border-left-color: #f0f;border-top-style: solid;border-right-style: solid;'
            . 'border-bottom-style: solid;border-left-style: solid;border-top-width: 2px;'
            . 'border-right-width: 2px;border-bottom-width: 2px;border-left-width: 2px;font-style: italic;'
            . 'font-variant: normal;font-weight: 500;font-size: 14px;line-height: 1.618;'
            . 'font-family: "Trebuchet MS",Georgia,serif;background-color: #ccc;'
            . 'background-image: url("/images/foo.png");background-repeat: no-repeat;background-attachment: scroll;'
            . 'background-position: left top;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function createShorthands(): void
    {
        $oDoc = self::parsedStructureForFile('create-shorthands');
        $sExpected = 'body {font-size: 2em;font-family: Helvetica,Arial,sans-serif;font-weight: bold;'
            . 'border-width: 2px;border-color: #999;border-style: dotted;background-color: #fff;'
            . 'background-image: url("foobar.png");background-repeat: repeat-y;margin-top: 2px;margin-right: 3px;'
            . 'margin-bottom: 4px;margin-left: 5px;}';
        self::assertSame($sExpected, $oDoc->render());
        $oDoc->createShorthands();
        $sExpected = 'body {background: #fff url("foobar.png") repeat-y;margin: 2px 5px 4px 3px;'
            . 'border: 2px dotted #999;font: bold 2em Helvetica,Arial,sans-serif;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function namespaces(): void
    {
        $oDoc = self::parsedStructureForFile('namespaces');
        $sExpected = '@namespace toto "http://toto.example.org";
@namespace "http://example.com/foo";
@namespace foo url("http://www.example.com/");
@namespace foo url("http://www.example.com/");
foo|test {gaga: 1;}
|test {gaga: 2;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function innerColors(): void
    {
        $oDoc = self::parsedStructureForFile('inner-color');
        $sExpected = 'test {background: -webkit-gradient(linear,0 0,0 bottom,from(#006cad),to(hsl(202,100%,49%)));}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function prefixedGradient(): void
    {
        $oDoc = self::parsedStructureForFile('webkit');
        $sExpected = '.test {background: -webkit-linear-gradient(top right,white,black);}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function listValueRemoval(): void
    {
        $oDoc = self::parsedStructureForFile('atrules');
        foreach ($oDoc->getContents() as $oItem) {
            if ($oItem instanceof AtRule) {
                $oDoc->remove($oItem);
                continue;
            }
        }
        self::assertSame('html, body {font-size: -.6em;}', $oDoc->render());

        $oDoc = self::parsedStructureForFile('nested');
        foreach ($oDoc->getAllDeclarationBlocks() as $oBlock) {
            $oDoc->removeDeclarationBlockBySelector($oBlock, false);
            break;
        }
        self::assertSame(
            'html {some-other: -test(val1);}
@media screen {html {some: -test(val2);}}
#unrelated {other: yes;}',
            $oDoc->render()
        );

        $oDoc = self::parsedStructureForFile('nested');
        foreach ($oDoc->getAllDeclarationBlocks() as $oBlock) {
            $oDoc->removeDeclarationBlockBySelector($oBlock, true);
            break;
        }
        self::assertSame(
            '@media screen {html {some: -test(val2);}}
#unrelated {other: yes;}',
            $oDoc->render()
        );
    }

    /**
     * @test
     */
    public function selectorRemoval(): void
    {
        $this->expectException(OutputException::class);

        $oDoc = self::parsedStructureForFile('1readme');
        $aBlocks = $oDoc->getAllDeclarationBlocks();
        $oBlock1 = $aBlocks[0];
        self::assertTrue($oBlock1->removeSelector('html'));
        $sExpected = '@charset "utf-8";
@font-face {font-family: "CrassRoots";src: url("../media/cr.ttf");}
body {font-size: 1.6em;}';
        self::assertSame($sExpected, $oDoc->render());
        self::assertFalse($oBlock1->removeSelector('html'));
        self::assertTrue($oBlock1->removeSelector('body'));
        // This tries to output a declaration block without a selector and throws.
        $oDoc->render();
    }

    /**
     * @test
     */
    public function comments(): void
    {
        $oDoc = self::parsedStructureForFile('comments');
        $sExpected = <<<EXPECTED
@import url("some/url.css") screen;
.foo, #bar {background-color: #000;}
@media screen {#foo.bar {position: absolute;}}
EXPECTED;
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function urlInFile(): void
    {
        $oDoc = self::parsedStructureForFile('url', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'body {background: #fff url("https://somesite.com/images/someimage.gif") repeat top center;}
body {background-url: url("https://somesite.com/images/someimage.gif");}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function hexAlphaInFile(): void
    {
        $oDoc = self::parsedStructureForFile('hex-alpha', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'div {background: rgba(17,34,51,.27);}
div {background: rgba(17,34,51,.27);}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function calcInFile(): void
    {
        $oDoc = self::parsedStructureForFile('calc', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'div {width: calc(100% / 4);}
div {margin-top: calc(-120% - 4px);}
div {height: -webkit-calc(9 / 16 * 100%) !important;width: -moz-calc(( 50px - 50% ) * 2);}
div {width: calc(50% - ( ( 4% ) * .5 ));}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function calcNestedInFile(): void
    {
        $oDoc = self::parsedStructureForFile('calc-nested', Settings::create()->withMultibyteSupport(true));
        $sExpected = '.test {font-size: calc(( 3 * 4px ) + -2px);top: calc(200px - calc(20 * 3px));}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function invalidCalcInFile(): void
    {
        $oDoc = self::parsedStructureForFile('calc-invalid', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'div {}
div {}
div {}
div {height: -moz-calc;}
div {height: calc;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function invalidCalc(): void
    {
        $parser = new Parser('div { height: calc(100px');
        $oDoc = $parser->parse();
        self::assertSame('div {height: calc(100px);}', $oDoc->render());

        $parser = new Parser('div { height: calc(100px)');
        $oDoc = $parser->parse();
        self::assertSame('div {height: calc(100px);}', $oDoc->render());

        $parser = new Parser('div { height: calc(100px);');
        $oDoc = $parser->parse();
        self::assertSame('div {height: calc(100px);}', $oDoc->render());

        $parser = new Parser('div { height: calc(100px}');
        $oDoc = $parser->parse();
        self::assertSame('div {}', $oDoc->render());

        $parser = new Parser('div { height: calc(100px;');
        $oDoc = $parser->parse();
        self::assertSame('div {}', $oDoc->render());

        $parser = new Parser('div { height: calc(100px;}');
        $oDoc = $parser->parse();
        self::assertSame('div {}', $oDoc->render());
    }

    /**
     * @test
     */
    public function gridLineNameInFile(): void
    {
        $oDoc = self::parsedStructureForFile('grid-linename', Settings::create()->withMultibyteSupport(true));
        $sExpected = "div {grid-template-columns: [linename] 100px;}\n"
            . 'span {grid-template-columns: [linename1 linename2] 100px;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function emptyGridLineNameLenientInFile(): void
    {
        $oDoc = self::parsedStructureForFile('empty-grid-linename');
        $sExpected = '.test {grid-template-columns: [] 100px;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function invalidGridLineNameInFile(): void
    {
        $oDoc = self::parsedStructureForFile('invalid-grid-linename', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'div {}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function unmatchedBracesInFile(): void
    {
        $oDoc = self::parsedStructureForFile('unmatched_braces', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'button, input, checkbox, textarea {outline: 0;margin: 0;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function invalidSelectorsInFile(): void
    {
        $oDoc = self::parsedStructureForFile('invalid-selectors', Settings::create()->withMultibyteSupport(true));
        $sExpected = '@keyframes mymove {from {top: 0px;}}
#test {color: white;background: green;}
#test {display: block;background: white;color: black;}';
        self::assertSame($sExpected, $oDoc->render());

        $oDoc = self::parsedStructureForFile('invalid-selectors-2', Settings::create()->withMultibyteSupport(true));
        $sExpected = '@media only screen and (max-width: 1215px) {.breadcrumb {padding-left: 10px;}
	.super-menu > li:first-of-type {border-left-width: 0;}
	.super-menu > li:last-of-type {border-right-width: 0;}
	html[dir="rtl"] .super-menu > li:first-of-type {border-left-width: 1px;border-right-width: 0;}
	html[dir="rtl"] .super-menu > li:last-of-type {border-left-width: 0;}}
body {background-color: red;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function selectorEscapesInFile(): void
    {
        $oDoc = self::parsedStructureForFile('selector-escapes', Settings::create()->withMultibyteSupport(true));
        $sExpected = '#\\# {color: red;}
.col-sm-1\\/5 {width: 20%;}';
        self::assertSame($sExpected, $oDoc->render());

        $oDoc = self::parsedStructureForFile('invalid-selectors-2', Settings::create()->withMultibyteSupport(true));
        $sExpected = '@media only screen and (max-width: 1215px) {.breadcrumb {padding-left: 10px;}
	.super-menu > li:first-of-type {border-left-width: 0;}
	.super-menu > li:last-of-type {border-right-width: 0;}
	html[dir="rtl"] .super-menu > li:first-of-type {border-left-width: 1px;border-right-width: 0;}
	html[dir="rtl"] .super-menu > li:last-of-type {border-left-width: 0;}}
body {background-color: red;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function identifierEscapesInFile(): void
    {
        $oDoc = self::parsedStructureForFile('identifier-escapes', Settings::create()->withMultibyteSupport(true));
        $sExpected = 'div {font: 14px Font Awesome\\ 5 Pro;font: 14px Font Awesome\\} 5 Pro;'
            . 'font: 14px Font Awesome\\; 5 Pro;f\\;ont: 14px Font Awesome\\; 5 Pro;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function selectorIgnoresInFile(): void
    {
        $oDoc = self::parsedStructureForFile('selector-ignores', Settings::create()->withMultibyteSupport(true));
        $sExpected = '.some[selectors-may=\'contain-a-{\'] {}'
            . "\n"
            . '.this-selector  .valid {width: 100px;}'
            . "\n"
            . '@media only screen and (min-width: 200px) {.test {prop: val;}}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function keyframeSelectors(): void
    {
        $oDoc = self::parsedStructureForFile(
            'keyframe-selector-validation',
            Settings::create()->withMultibyteSupport(true)
        );
        $sExpected = '@-webkit-keyframes zoom {0% {-webkit-transform: scale(1,1);}'
            . "\n\t"
            . '50% {-webkit-transform: scale(1.2,1.2);}'
            . "\n\t"
            . '100% {-webkit-transform: scale(1,1);}}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function lineNameFailure(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        self::parsedStructureForFile('-empty-grid-linename', Settings::create()->withLenientParsing(false));
    }

    /**
     * @test
     */
    public function calcFailure(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        self::parsedStructureForFile('-calc-no-space-around-minus', Settings::create()->withLenientParsing(false));
    }

    /**
     * @test
     */
    public function urlInFileMbOff(): void
    {
        $oDoc = self::parsedStructureForFile('url', Settings::create()->withMultibyteSupport(false));
        $sExpected = 'body {background: #fff url("https://somesite.com/images/someimage.gif") repeat top center;}'
            . "\n"
            . 'body {background-url: url("https://somesite.com/images/someimage.gif");}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function emptyFile(): void
    {
        $oDoc = self::parsedStructureForFile('-empty', Settings::create()->withMultibyteSupport(true));
        $sExpected = '';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function emptyFileMbOff(): void
    {
        $oDoc = self::parsedStructureForFile('-empty', Settings::create()->withMultibyteSupport(false));
        $sExpected = '';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function charsetLenient1(): void
    {
        $oDoc = self::parsedStructureForFile('-charset-after-rule', Settings::create()->withLenientParsing(true));
        $sExpected = '#id {prop: var(--val);}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function charsetLenient2(): void
    {
        $oDoc = self::parsedStructureForFile('-charset-in-block', Settings::create()->withLenientParsing(true));
        $sExpected = '@media print {}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function trailingWhitespace(): void
    {
        $oDoc = self::parsedStructureForFile('trailing-whitespace', Settings::create()->withLenientParsing(false));
        $sExpected = 'div {width: 200px;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function charsetFailure1(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        self::parsedStructureForFile('-charset-after-rule', Settings::create()->withLenientParsing(false));
    }

    /**
     * @test
     */
    public function charsetFailure2(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        self::parsedStructureForFile('-charset-in-block', Settings::create()->withLenientParsing(false));
    }

    /**
     * @test
     */
    public function unopenedClosingBracketFailure(): void
    {
        $this->expectException(SourceException::class);

        self::parsedStructureForFile('-unopened-close-brackets', Settings::create()->withLenientParsing(false));
    }

    /**
     * Ensure that a missing property value raises an exception.
     *
     * @covers \Sabberworm\CSS\Value\Value::parseValue()
     *
     * @test
     */
    public function missingPropertyValueStrict(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        self::parsedStructureForFile('missing-property-value', Settings::create()->withLenientParsing(false));
    }

    /**
     * Ensure that a missing property value is ignored when in lenient parsing mode.
     *
     * @covers \Sabberworm\CSS\Value\Value::parseValue()
     *
     * @test
     */
    public function missingPropertyValueLenient(): void
    {
        $parsed = self::parsedStructureForFile('missing-property-value', Settings::create()->withLenientParsing(true));
        $rulesets = $parsed->getAllRuleSets();
        self::assertCount(1, $rulesets);
        $block = $rulesets[0];
        self::assertInstanceOf(DeclarationBlock::class, $block);
        self::assertEquals([new Selector('div')], $block->getSelectors());
        $rules = $block->getRules();
        self::assertCount(1, $rules);
        $rule = $rules[0];
        self::assertSame('display', $rule->getRule());
        self::assertSame('inline-block', $rule->getValue());
    }

    /**
     * Parses structure for file.
     *
     * @param string $sFileName
     * @param Settings|null $oSettings
     */
    public static function parsedStructureForFile($sFileName, $oSettings = null): Document
    {
        $sFile = __DIR__ . "/fixtures/$sFileName.css";
        $oParser = new Parser(\file_get_contents($sFile), $oSettings);
        return $oParser->parse();
    }

    /**
     * @depends files
     *
     * @test
     */
    public function lineNumbersParsing(): void
    {
        $oDoc = self::parsedStructureForFile('line-numbers');
        // array key is the expected line number
        $aExpected = [
            1 => [Charset::class],
            3 => [CSSNamespace::class],
            5 => [AtRuleSet::class],
            11 => [DeclarationBlock::class],
            // Line Numbers of the inner declaration blocks
            17 => [KeyFrame::class, 18, 20],
            23 => [Import::class],
            25 => [DeclarationBlock::class],
        ];

        $aActual = [];
        foreach ($oDoc->getContents() as $oContent) {
            $aActual[$oContent->getLineNo()] = [\get_class($oContent)];
            if ($oContent instanceof KeyFrame) {
                foreach ($oContent->getContents() as $block) {
                    $aActual[$oContent->getLineNo()][] = $block->getLineNo();
                }
            }
        }

        $aUrlExpected = [7, 26]; // expected line numbers
        $aUrlActual = [];
        foreach ($oDoc->getAllValues() as $oValue) {
            if ($oValue instanceof URL) {
                $aUrlActual[] = $oValue->getLineNo();
            }
        }

        // Checking for the multiline color rule lines 27-31
        $aExpectedColorLines = [28, 29, 30];
        $aDeclBlocks = $oDoc->getAllDeclarationBlocks();
        // Choose the 2nd one
        $oDeclBlock = $aDeclBlocks[1];
        $aRules = $oDeclBlock->getRules();
        // Choose the 2nd one
        $oColor = $aRules[1]->getValue();
        self::assertSame(27, $aRules[1]->getLineNo());

        $aActualColorLines = [];
        foreach ($oColor->getColor() as $oSize) {
            $aActualColorLines[] = $oSize->getLineNo();
        }

        self::assertSame($aExpectedColorLines, $aActualColorLines);
        self::assertSame($aUrlExpected, $aUrlActual);
        self::assertSame($aExpected, $aActual);
    }

    /**
     * @test
     */
    public function unexpectedTokenExceptionLineNo(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        $oParser = new Parser("\ntest: 1;", Settings::create()->beStrict());
        try {
            $oParser->parse();
        } catch (UnexpectedTokenException $e) {
            self::assertSame(2, $e->getLineNo());
            throw $e;
        }
    }

    /**
     * @test
     */
    public function ieHacksStrictParsing(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        // We can't strictly parse IE hacks.
        self::parsedStructureForFile('ie-hacks', Settings::create()->beStrict());
    }

    /**
     * @test
     */
    public function ieHacksParsing(): void
    {
        $oDoc = self::parsedStructureForFile('ie-hacks', Settings::create()->withLenientParsing(true));
        $sExpected = 'p {padding-right: .75rem \\9;background-image: none \\9;color: red \\9\\0;'
            . 'background-color: red \\9\\0;background-color: red \\9\\0 !important;content: "red 	\\0";content: "red઼";}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @depends files
     *
     * @test
     */
    public function commentExtracting(): void
    {
        $oDoc = self::parsedStructureForFile('comments');
        $aNodes = $oDoc->getContents();

        // Import property.
        $importComments = $aNodes[0]->getComments();
        self::assertCount(2, $importComments);
        self::assertSame("*\n * Comments\n ", $importComments[0]->getComment());
        self::assertSame(' Hell ', $importComments[1]->getComment());

        // Declaration block.
        $fooBarBlock = $aNodes[1];
        $fooBarBlockComments = $fooBarBlock->getComments();
        // TODO Support comments in selectors.
        // $this->assertCount(2, $fooBarBlockComments);
        // $this->assertSame("* Number 4 *", $fooBarBlockComments[0]->getComment());
        // $this->assertSame("* Number 5 *", $fooBarBlockComments[1]->getComment());

        // Declaration rules.
        $fooBarRules = $fooBarBlock->getRules();
        $fooBarRule = $fooBarRules[0];
        $fooBarRuleComments = $fooBarRule->getComments();
        self::assertCount(1, $fooBarRuleComments);
        self::assertSame(' Number 6 ', $fooBarRuleComments[0]->getComment());

        // Media property.
        $mediaComments = $aNodes[2]->getComments();
        self::assertCount(0, $mediaComments);

        // Media children.
        $mediaRules = $aNodes[2]->getContents();
        $fooBarComments = $mediaRules[0]->getComments();
        self::assertCount(1, $fooBarComments);
        self::assertSame('* Number 10 *', $fooBarComments[0]->getComment());

        // Media -> declaration -> rule.
        $fooBarRules = $mediaRules[0]->getRules();
        $fooBarChildComments = $fooBarRules[0]->getComments();
        self::assertCount(1, $fooBarChildComments);
        self::assertSame('* Number 10b *', $fooBarChildComments[0]->getComment());
    }

    /**
     * @test
     */
    public function flatCommentExtracting(): void
    {
        $parser = new Parser('div {/*Find Me!*/left:10px; /*Find Me Too!*/text-align:left;}');
        $doc = $parser->parse();
        $contents = $doc->getContents();
        $divRules = $contents[0]->getRules();
        $rule1Comments = $divRules[0]->getComments();
        $rule2Comments = $divRules[1]->getComments();
        self::assertCount(1, $rule1Comments);
        self::assertCount(1, $rule2Comments);
        self::assertEquals('Find Me!', $rule1Comments[0]->getComment());
        self::assertEquals('Find Me Too!', $rule2Comments[0]->getComment());
    }

    /**
     * @test
     */
    public function topLevelCommentExtracting(): void
    {
        $parser = new Parser('/*Find Me!*/div {left:10px; text-align:left;}');
        $doc = $parser->parse();
        $contents = $doc->getContents();
        $comments = $contents[0]->getComments();
        self::assertCount(1, $comments);
        self::assertSame('Find Me!', $comments[0]->getComment());
    }

    /**
     * @test
     */
    public function microsoftFilterStrictParsing(): void
    {
        $this->expectException(UnexpectedTokenException::class);

        $oDoc = self::parsedStructureForFile('ms-filter', Settings::create()->beStrict());
    }

    /**
     * @test
     */
    public function microsoftFilterParsing(): void
    {
        $oDoc = self::parsedStructureForFile('ms-filter');
        $sExpected = '.test {filter: progid:DXImageTransform.Microsoft.gradient(startColorstr="#80000000",'
            . 'endColorstr="#00000000",GradientType=1);}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function largeSizeValuesInFile(): void
    {
        $oDoc = self::parsedStructureForFile('large-z-index', Settings::create()->withMultibyteSupport(false));
        $sExpected = '.overlay {z-index: 10000000000000000000000;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function scientificNotationSizeValuesInFile(): void
    {
        $oDoc = $this->parsedStructureForFile(
            'scientific-notation-numbers',
            Settings::create()->withMultibyteSupport(false)
        );
        $sExpected = ''
            . 'body {background-color: rgba(62,174,151,3041820656523200167936);'
            . 'z-index: .030418206565232;font-size: 1em;top: 192.3478px;}';
        self::assertSame($sExpected, $oDoc->render());
    }

    /**
     * @test
     */
    public function lonelyImport(): void
    {
        $oDoc = self::parsedStructureForFile('lonely-import');
        $sExpected = '@import url("example.css") only screen and (max-width: 600px);';
        self::assertSame($sExpected, $oDoc->render());
    }

    public function escapedSpecialCaseTokens(): void
    {
        $oDoc = $this->parsedStructureForFile('escaped-tokens');
        $contents = $oDoc->getContents();
        $rules = $contents[0]->getRules();
        $urlRule = $rules[0];
        $calcRule = $rules[1];
        self::assertTrue(\is_a($urlRule->getValue(), '\\Sabberworm\\CSS\\Value\\URL'));
        self::assertTrue(\is_a($calcRule->getValue(), '\\Sabberworm\\CSS\\Value\\CalcFunction'));
    }
}