6120418360

Committed 08 Sep 2023 10:07AM UTC coverage: 93.998% (+0.003%) from 93.995%

Build # 6120418360

Build Type

push

github

Committed by

Commit Message

Released version 3.0.9

Run Details

4933 of 5248 relevant lines covered (94.0%)

0.94 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

97.85

/src/Latte/Compiler/TemplateParserHtml.php

<?php

/**
 * This file is part of the Latte (https://latte.nette.org)
 * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
 */

declare(strict_types=1);

namespace Latte\Compiler;

use Latte;
use Latte\CompileException;
use Latte\Compiler\Nodes\AreaNode;
use Latte\Compiler\Nodes\FragmentNode;
use Latte\Compiler\Nodes\Html;
use Latte\ContentType;
use Latte\Helpers;
use Latte\SecurityViolationException;


/**
 * Template parser extension for HTML.
 */
final class TemplateParserHtml
{
        use Latte\Strict;

        /** @var array<string, callable(Tag, TemplateParser): (Node|\Generator|void)> */
        private array /*readonly*/ $attrParsers;
        private ?Html\ElementNode $element = null;
        private TemplateParser /*readonly*/ $parser;

        /** @var array{string, ?Nodes\Php\ExpressionNode} */
        private ?array $endName = null;


        public function __construct(TemplateParser $parser, array $attrParsers)
        {
                $this->parser = $parser;
                $this->attrParsers = $attrParsers;
        }


        public function getElement(): ?Html\ElementNode
        {
                return $this->element;
        }


        public function inTextResolve(): ?Node
        {
                $stream = $this->parser->getStream();
                $token = $stream->peek();
                return match ($token->type) {
                        Token::Html_TagOpen => $this->parseTag(),
                        Token::Html_CommentOpen => $this->parseComment(),
                        Token::Html_BogusOpen => $this->parseBogusTag(),
                        default => $this->parser->inTextResolve(),
                };
        }


        public function inTagResolve(): ?Node
        {
                $stream = $this->parser->getStream();
                $token = $stream->peek();
                return match ($token->type) {
                        Token::Html_Name => str_starts_with($token->text, TemplateLexer::NPrefix)
                                ? $this->parseNAttribute()
                                : $this->parseAttribute(),
                        Token::Latte_TagOpen => $this->parseAttribute(),
                        Token::Whitespace => $this->parseAttributeWhitespace(),
                        Token::Html_TagClose => null,
                        default => $this->parser->inTextResolve(),
                };
        }


        private function parseTag(): ?Node
        {
                $stream = $this->parser->getStream();
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);
                if (!$stream->peek(1)?->is(Token::Slash)) {
                        return $this->parseElement();
                }

                if ($this->element
                        && $this->parser->peekTag() === $this->element->data->tag // is directly in the element
                ) {
                        $save = $stream->getIndex();
                        $this->endName = [$endText] = $this->parseEndTag();
                        if ($this->element->is($endText) || $this->element->data->textualName === $endText) {
                                return null; // go to parseElement() one level up to close the element
                        }
                        $stream->seek($save);
                        if (!in_array($endText, $this->element->data->unclosedTags ?? [], true)) {
                                return null; // go to parseElement() one level up to collapse
                        }
                }

                if ($this->parser->strict) {
                        $stream->throwUnexpectedException(excerpt: '/');
                }
                return $this->parseBogusEndTag();
        }


        private function parseElement(): Node
        {
                $res = new FragmentNode;
                $res->append($this->extractIndentation());
                $res->append($this->parseStartTag($this->element));
                $elem = $this->element;

                $stream = $this->parser->getStream();
                $void = $this->resolveVoidness($elem);
                $attrs = $this->prepareNAttrs($elem->nAttributes, $void);
                $outerNodes = $this->openNAttrNodes($attrs[Tag::PrefixNone] ?? []);
                $tagNodes = $this->openNAttrNodes($attrs[Tag::PrefixTag] ?? []);
                $elem->tagNode = $this->finishNAttrNodes($elem->tagNode, $tagNodes);
                $elem->captureTagName = (bool) $tagNodes;

                if (!$void) {
                        $content = new FragmentNode;
                        if ($token = $stream->tryConsume(Token::Newline)) {
                                $content->append(new Nodes\TextNode($token->text, $token->position));
                        }

                        $innerNodes = $this->openNAttrNodes($attrs[Tag::PrefixInner] ?? []);
                        $elem->data->tag = $this->parser->peekTag();
                        $frag = $this->parser->parseFragment([$this, 'inTextResolve']);
                        $content->append($this->finishNAttrNodes($frag, $innerNodes));

                        [$endText, $endVariable] = $this->endName;
                        $this->endName = null;
                        if ($endText && ($this->element->is($endText) || $this->element->data->textualName === $endText)) {
                                $elem->content = $content;
                                $elem->content->append($this->extractIndentation());

                        } elseif ($outerNodes || $innerNodes || $tagNodes
                                || $this->parser->strict
                                || $elem->variableName
                                || $endVariable
                                || $elem->isRawText()
                        ) {
                                $stream->throwUnexpectedException(
                                        addendum: ", expecting </{$elem->data->textualName}> for element started $elem->position",
                                        excerpt: $endText ? "/{$endText}>" : $stream->peek(1)?->text . $stream->peek(2)?->text,
                                );
                        } else { // element collapsed to tags
                                $res->append($content);
                                $this->element = $elem->parent;
                                if ($this->element && !$stream->is(Token::Html_TagOpen)) {
                                        $this->element->data->unclosedTags[] = $elem->name;
                                }
                                return $res;
                        }
                }

                if ($token = $stream->tryConsume(Token::Newline)) {
                        $res->append(new Nodes\TextNode($token->text, $token->position));
                }

                $res = $this->finishNAttrNodes($res, $outerNodes);
                $this->element = $elem->parent;
                return $res;
        }


        private function extractIndentation(): AreaNode
        {
                if ($this->parser->lastIndentation) {
                        $dolly = clone $this->parser->lastIndentation;
                        $this->parser->lastIndentation->content = '';
                        return $dolly;
                } else {
                        return new Nodes\NopNode;
                }
        }


        private function parseStartTag(&$elem = null): Html\ElementNode
        {
                $stream = $this->parser->getStream();
                $openToken = $stream->consume(Token::Html_TagOpen);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);

                [$textual, $variable] = $this->parseTagName($this->parser->strict);
                if (($this->parser->strict || $variable)
                        && !$stream->is(Token::Whitespace, Token::Slash, Token::Html_TagClose)
                ) {
                        throw $stream->throwUnexpectedException();
                }

                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $elem = new Html\ElementNode(
                        name: $variable ? '' : $textual,
                        position: $openToken->position,
                        parent: $this->element,
                        data: (object) ['tag' => $this->parser->peekTag()],
                        contentType: $this->parser->getContentType(),
                );
                $elem->attributes = $this->parser->parseFragment([$this, 'inTagResolve']);
                $elem->selfClosing = (bool) $stream->tryConsume(Token::Slash);
                $elem->variableName = $variable;
                $elem->data->textualName = $textual;
                $stream->consume(Token::Html_TagClose);
                $state = !$elem->selfClosing && $elem->isRawText()
                        ? TemplateLexer::StateHtmlRawText
                        : TemplateLexer::StateHtmlText;
                $this->parser->getLexer()->setState($state, $elem->name);
                return $elem;
        }


        /** @return array{string, ?Nodes\Php\ExpressionNode} */
        private function parseEndTag(): array
        {
                $stream = $this->parser->getStream();
                $stream->consume(Token::Html_TagOpen);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);
                $stream->consume(Token::Slash);
                $name = $this->parseTagName();
                $stream->tryConsume(Token::Whitespace);
                $stream->consume(Token::Html_TagClose);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);
                return $name;
        }


        /** @return array{string, ?Nodes\Php\ExpressionNode} */
        private function parseTagName(bool $strict = true): array
        {
                $variable = $text = null;
                $parts = [];
                $stream = $this->parser->getStream();
                do {
                        if ($stream->is(Token::Latte_TagOpen)) {
                                $save = $stream->getIndex();
                                $statement = $this->parser->parseLatteStatement([$this, 'inTagResolve']);
                                if (!$statement instanceof Latte\Essential\Nodes\PrintNode) {
                                        if (!$parts || $strict) {
                                                throw new CompileException('Only expression can be used as a HTML tag name.', $statement->position);
                                        }
                                        $stream->seek($save);
                                        break;
                                }
                                $parts[] = $statement->expression;
                                $save -= $stream->getIndex();
                                while ($save < 0) {
                                        $text .= $stream->peek($save++)->text;
                                }
                                $variable = true;

                        } elseif ($token = $stream->tryConsume(Token::Html_Name)) {
                                $parts[] = new Latte\Compiler\Nodes\Php\Scalar\StringNode($token->text, $token->position);
                                $text .= $token->text;

                        } elseif (!$parts) {
                                throw $stream->throwUnexpectedException([Token::Html_Name, Token::Latte_TagOpen]);
                        } else {
                                break;
                        }
                } while (true);

                $variable = $variable
                        ? Latte\Compiler\Nodes\Php\Expression\BinaryOpNode::nest('.', ...$parts)
                        : null;
                return [$text, $variable];
        }


        private function parseBogusEndTag(): ?Html\BogusTagNode
        {
                $stream = $this->parser->getStream();
                $openToken = $stream->consume(Token::Html_TagOpen);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);
                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $node = new Html\BogusTagNode(
                        openDelimiter: $openToken->text . $stream->consume(Token::Slash)->text . $stream->consume(Token::Html_Name)->text,
                        content: new Nodes\TextNode($stream->tryConsume(Token::Whitespace)->text ?? ''),
                        endDelimiter: $stream->consume(Token::Html_TagClose)->text,
                        position: $openToken->position,
                );
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);
                return $node;
        }


        private function parseBogusTag(): Html\BogusTagNode
        {
                $stream = $this->parser->getStream();
                $openToken = $stream->consume(Token::Html_BogusOpen);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlBogus);
                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $content = $this->parser->parseFragment([$this->parser, 'inTextResolve']);
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);
                return new Html\BogusTagNode(
                        openDelimiter: $openToken->text,
                        content: $content,
                        endDelimiter: $stream->consume(Token::Html_TagClose)->text,
                        position: $openToken->position,
                );
        }


        private function resolveVoidness(Html\ElementNode $elem): bool
        {
                if ($elem->contentType !== ContentType::Html) {
                        return $elem->selfClosing;
                } elseif (isset(Helpers::$emptyElements[strtolower($elem->name)])) {
                        return true;
                } elseif ($elem->selfClosing) { // auto-correct
                        $elem->content = new Nodes\NopNode;
                        $elem->selfClosing = false;
                        $last = end($elem->attributes->children);
                        if ($last instanceof Nodes\TextNode && $last->isWhitespace()) {
                                array_pop($elem->attributes->children);
                        }
                        return true;
                }

                return $elem->selfClosing;
        }


        private function parseAttributeWhitespace(): Node
        {
                $stream = $this->parser->getStream();
                $token = $stream->consume(Token::Whitespace);
                return $stream->is(Token::Html_Name) && str_starts_with($stream->peek()->text, TemplateLexer::NPrefix)
                        ? new Nodes\NopNode
                        : new Nodes\TextNode($token->text, $token->position);
        }


        private function parseAttribute(): ?Node
        {
                $stream = $this->parser->getStream();
                if ($stream->is(Token::Latte_TagOpen)) {
                        $name = $this->parser->parseLatteStatement();
                        if (!$name instanceof Latte\Essential\Nodes\PrintNode) {
                                return $name; // value like '<span {if true}attr1=val{/if}>'
                        }
                } else {
                        $name = $this->parser->parseText();
                }

                [$value, $quote] = $this->parseAttributeValue();
                return new Html\AttributeNode(
                        name: $name,
                        value: $value,
                        quote: $quote,
                        position: $name->position,
                );
        }


        private function parseAttributeValue(): ?array
        {
                $stream = $this->parser->getStream();
                $save = $stream->getIndex();
                $this->consumeIgnored();
                if (!$stream->tryConsume(Token::Equals)) {
                        $stream->seek($save);
                        return null;
                }

                $this->consumeIgnored();
                if ($quoteToken = $stream->tryConsume(Token::Quote)) {
                        $this->parser->getLexer()->setState(TemplateLexer::StateHtmlQuotedValue, $quoteToken->text);
                        $value = $this->parser->parseFragment([$this->parser, 'inTextResolve']);
                        $stream->tryConsume(Token::Quote) || $stream->throwUnexpectedException([$quoteToken->text], addendum: ", end of HTML attribute started $quoteToken->position");
                        $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);
                        return [$value, $quoteToken->text];
                }

                $value = $this->parser->parseFragment(
                        fn() => match ($stream->peek()->type) {
                                Token::Html_Name => $this->parser->parseText(),
                                Token::Latte_TagOpen => $this->parser->parseLatteStatement(),
                                Token::Latte_CommentOpen => $this->parser->parseLatteComment(),
                                default => null,
                        },
                )->simplify() ?? $stream->throwUnexpectedException();
                return [$value, null];
        }


        private function parseNAttribute(): Nodes\TextNode
        {
                $stream = $this->parser->getStream();
                $nameToken = $stream->consume(Token::Html_Name);
                $save = $stream->getIndex();
                $pos = $stream->peek()->position;
                $name = substr($nameToken->text, strlen(TemplateLexer::NPrefix));
                if ($this->parser->peekTag() !== $this->element->data->tag) {
                        throw new CompileException("Attribute n:$name must not appear inside {tags}", $nameToken->position);

                } elseif (isset($this->element->nAttributes[$name])) {
                        throw new CompileException("Found multiple attributes n:$name.", $nameToken->position);
                }

                $this->consumeIgnored();
                if ($stream->tryConsume(Token::Equals)) {
                        $this->consumeIgnored();
                        if ($quoteToken = $stream->tryConsume(Token::Quote)) {
                                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlQuotedNAttrValue, $quoteToken->text);
                                $valueToken = $stream->tryConsume(Token::Text);
                                $pos = $stream->peek()->position;
                                $stream->tryConsume(Token::Quote) || $stream->throwUnexpectedException([$quoteToken->text], addendum: ", end of n:attribute started $quoteToken->position");
                                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);
                        } else {
                                $valueToken = $stream->consume(Token::Html_Name);
                        }
                        if ($valueToken) {
                                $tokens = (new TagLexer)->tokenize($valueToken->text, $valueToken->position);
                        }
                } else {
                        $stream->seek($save);
                }
                $tokens ??= [new Token(Token::End, '', $pos)];

                $this->element->nAttributes[$name] = new Tag(
                        name: preg_replace('~(inner-|tag-|)~', '', $name),
                        tokens: $tokens,
                        position: $nameToken->position,
                        prefix: $this->getPrefix($name),
                        inTag: true,
                        htmlElement: $this->element,
                        data: (object) ['node' => $node = new Nodes\TextNode('')], // TODO: better
                );
                return $node;
        }


        private function parseComment(): Html\CommentNode
        {
                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlComment);
                $stream = $this->parser->getStream();
                $openToken = $stream->consume(Token::Html_CommentOpen);
                $node = new Html\CommentNode(
                        position: $openToken->position,
                        content: $this->parser->parseFragment([$this->parser, 'inTextResolve']),
                );
                $stream->tryConsume(Token::Html_CommentClose) || $stream->throwUnexpectedException([Token::Html_CommentClose], addendum: " started $openToken->position");
                $this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);
                return $node;
        }


        private function consumeIgnored(): void
        {
                $stream = $this->parser->getStream();
                do {
                        if ($stream->tryConsume(Token::Whitespace)) {
                                continue;
                        }
                        if ($stream->tryConsume(Token::Latte_CommentOpen)) {
                                $this->parser->getLexer()->pushState(TemplateLexer::StateLatteComment);
                                $stream->consume(Token::Text);
                                $stream->consume(Token::Latte_CommentClose);
                                $this->parser->getLexer()->popState();
                                $stream->tryConsume(Token::Newline);
                                continue;
                        }
                        return;
                } while (true);
        }


        private function prepareNAttrs(array $attrs, bool $void): array
        {
                $res = [];
                foreach ($this->attrParsers as $name => $foo) {
                        if ($tag = $attrs[$name] ?? null) {
                                $prefix = $this->getPrefix($name);
                                if (!$prefix || !$void) {
                                        $res[$prefix][] = $tag;
                                        unset($attrs[$name]);
                                }
                        }
                }

                if ($attrs) {
                        $hint = Helpers::getSuggestion(array_keys($this->attrParsers), $k = key($attrs));
                        throw new CompileException('Unexpected attribute n:'
                                . ($hint ? "$k, did you mean n:$hint?" : implode(' and n:', array_keys($attrs))), $attrs[$k]->position);
                }

                return $res;
        }


        /**
         * @param  array<Tag>  $toOpen
         * @return array<array{\Generator, Tag}>
         */
        private function openNAttrNodes(array $toOpen): array
        {
                $toClose = [];
                foreach ($toOpen as $tag) {
                        $parser = $this->getAttrParser($tag->name, $tag->position);
                        $this->parser->pushTag($tag);
                        $res = $parser($tag, $this->parser);
                        if ($res instanceof \Generator && $res->valid()) {
                                $toClose[] = [$res, $tag];

                        } elseif ($res instanceof Node) {
                                $this->parser->ensureIsConsumed($tag);
                                $res->position = $tag->position;
                                $tag->replaceNAttribute($res);
                                $this->parser->popTag();

                        } elseif (!$res) {
                                $this->parser->ensureIsConsumed($tag);
                                $this->parser->popTag();

                        } else {
                                throw new CompileException("Unexpected value returned by {$tag->getNotation()} parser.", $tag->position);
                        }
                }

                return $toClose;
        }


        /** @param  array<array{\Generator, Tag}>  $toClose */
        private function finishNAttrNodes(AreaNode $node, array $toClose): AreaNode
        {
                while ([$gen, $tag] = array_pop($toClose)) {
                        $gen->send([$node, null]);
                        $node = $gen->getReturn();
                        $node->position = $tag->position;
                        $this->parser->popTag();
                        $this->parser->ensureIsConsumed($tag);
                }

                return $node;
        }


        /** @return callable(Tag, TemplateParser): (Node|\Generator|void) */
        private function getAttrParser(string $name, Position $pos): callable
        {
                if (!isset($this->attrParsers[$name])) {
                        $hint = ($t = Helpers::getSuggestion(array_keys($this->attrParsers), $name))
                                ? ", did you mean n:$t?"
                                : '';
                        throw new CompileException("Unknown n:{$name}{$hint}", $pos);
                } elseif (!$this->parser->isTagAllowed($name)) {
                        throw new SecurityViolationException("Attribute n:$name is not allowed", $pos);
                }
                return $this->attrParsers[$name];
        }


        private function getPrefix(string $name): string
        {
                return match (true) {
                        str_starts_with($name, 'inner-') => Tag::PrefixInner,
                        str_starts_with($name, 'tag-') => Tag::PrefixTag,
                        default => Tag::PrefixNone,
                };
        }
}

1	<?php
2
3	/**
4	* This file is part of the Latte (https://latte.nette.org)
5	* Copyright (c) 2008 David Grudl (https://davidgrudl.com)
6	*/
7
8	declare(strict_types=1);
9
10	namespace Latte\Compiler;
11
12	use Latte;
13	use Latte\CompileException;
14	use Latte\Compiler\Nodes\AreaNode;
15	use Latte\Compiler\Nodes\FragmentNode;
16	use Latte\Compiler\Nodes\Html;
17	use Latte\ContentType;
18	use Latte\Helpers;
19	use Latte\SecurityViolationException;
20
21
22	/**
23	* Template parser extension for HTML.
24	*/
25	final class TemplateParserHtml
26	{
27	use Latte\Strict;
28
29	/** @var array<string, callable(Tag, TemplateParser): (Node\|\Generator\|void)> */
30	private array /readonly/ $attrParsers;
31	private ?Html\ElementNode $element = null;
32	private TemplateParser /readonly/ $parser;
33
34	/** @var array{string, ?Nodes\Php\ExpressionNode} */
35	private ?array $endName = null;
36
37
38	public function __construct(TemplateParser $parser, array $attrParsers)	1✔
39	{
40	$this->parser = $parser;	1✔
41	$this->attrParsers = $attrParsers;	1✔
42	}	1✔
43
44
45	public function getElement(): ?Html\ElementNode
46	{
47	return $this->element;	1✔
48	}
49
50
51	public function inTextResolve(): ?Node
52	{
53	$stream = $this->parser->getStream();	1✔
54	$token = $stream->peek();	1✔
55	return match ($token->type) {	1✔
56	Token::Html_TagOpen => $this->parseTag(),	1✔
57	Token::Html_CommentOpen => $this->parseComment(),	1✔
58	Token::Html_BogusOpen => $this->parseBogusTag(),	1✔
59	default => $this->parser->inTextResolve(),	1✔
60	};
61	}
62
63
64	public function inTagResolve(): ?Node
65	{
66	$stream = $this->parser->getStream();	1✔
67	$token = $stream->peek();	1✔
68	return match ($token->type) {	1✔
69	Token::Html_Name => str_starts_with($token->text, TemplateLexer::NPrefix)	1✔
70	? $this->parseNAttribute()	1✔
71	: $this->parseAttribute(),	1✔
72	Token::Latte_TagOpen => $this->parseAttribute(),	1✔
73	Token::Whitespace => $this->parseAttributeWhitespace(),	1✔
74	Token::Html_TagClose => null,	1✔
75	default => $this->parser->inTextResolve(),	1✔
76	};
77	}
78
79
80	private function parseTag(): ?Node
81	{
82	$stream = $this->parser->getStream();	1✔
83	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
84	if (!$stream->peek(1)?->is(Token::Slash)) {	1✔
85	return $this->parseElement();	1✔
86	}
87
88	if ($this->element	1✔
89	&& $this->parser->peekTag() === $this->element->data->tag // is directly in the element	1✔
90	) {
91	$save = $stream->getIndex();	1✔
92	$this->endName = [$endText] = $this->parseEndTag();	1✔
93	if ($this->element->is($endText) \|\| $this->element->data->textualName === $endText) {	1✔
94	return null; // go to parseElement() one level up to close the element	1✔
95	}
96	$stream->seek($save);	1✔
97	if (!in_array($endText, $this->element->data->unclosedTags ?? [], true)) {	1✔
98	return null; // go to parseElement() one level up to collapse	1✔
99	}
100	}
101
102	if ($this->parser->strict) {	1✔
103	$stream->throwUnexpectedException(excerpt: '/');	1✔
104	}
105	return $this->parseBogusEndTag();	1✔
106	}
107
108
109	private function parseElement(): Node
110	{
111	$res = new FragmentNode;	1✔
112	$res->append($this->extractIndentation());	1✔
113	$res->append($this->parseStartTag($this->element));	1✔
114	$elem = $this->element;	1✔
115
116	$stream = $this->parser->getStream();	1✔
117	$void = $this->resolveVoidness($elem);	1✔
118	$attrs = $this->prepareNAttrs($elem->nAttributes, $void);	1✔
119	$outerNodes = $this->openNAttrNodes($attrs[Tag::PrefixNone] ?? []);	1✔
120	$tagNodes = $this->openNAttrNodes($attrs[Tag::PrefixTag] ?? []);	1✔
121	$elem->tagNode = $this->finishNAttrNodes($elem->tagNode, $tagNodes);	1✔
122	$elem->captureTagName = (bool) $tagNodes;	1✔
123
124	if (!$void) {	1✔
125	$content = new FragmentNode;	1✔
126	if ($token = $stream->tryConsume(Token::Newline)) {	1✔
127	$content->append(new Nodes\TextNode($token->text, $token->position));	1✔
128	}
129
130	$innerNodes = $this->openNAttrNodes($attrs[Tag::PrefixInner] ?? []);	1✔
131	$elem->data->tag = $this->parser->peekTag();	1✔
132	$frag = $this->parser->parseFragment([$this, 'inTextResolve']);	1✔
133	$content->append($this->finishNAttrNodes($frag, $innerNodes));	1✔
134
135	[$endText, $endVariable] = $this->endName;	1✔
136	$this->endName = null;	1✔
137	if ($endText && ($this->element->is($endText) \|\| $this->element->data->textualName === $endText)) {	1✔
138	$elem->content = $content;	1✔
139	$elem->content->append($this->extractIndentation());	1✔
140
141	} elseif ($outerNodes \|\| $innerNodes \|\| $tagNodes	1✔
142	\|\| $this->parser->strict	1✔
143	\|\| $elem->variableName	1✔
144	\|\| $endVariable	1✔
145	\|\| $elem->isRawText()	1✔
146	) {
147	$stream->throwUnexpectedException(	1✔
148	addendum: ", expecting </{$elem->data->textualName}> for element started $elem->position",	1✔
149	excerpt: $endText ? "/{$endText}>" : $stream->peek(1)?->text . $stream->peek(2)?->text,	1✔
150	);
151	} else { // element collapsed to tags
152	$res->append($content);	1✔
153	$this->element = $elem->parent;	1✔
154	if ($this->element && !$stream->is(Token::Html_TagOpen)) {	1✔
155	$this->element->data->unclosedTags[] = $elem->name;	1✔
156	}
157	return $res;	1✔
158	}
159	}
160
161	if ($token = $stream->tryConsume(Token::Newline)) {	1✔
162	$res->append(new Nodes\TextNode($token->text, $token->position));	1✔
163	}
164
165	$res = $this->finishNAttrNodes($res, $outerNodes);	1✔
166	$this->element = $elem->parent;	1✔
167	return $res;	1✔
168	}
169
170
171	private function extractIndentation(): AreaNode
172	{
173	if ($this->parser->lastIndentation) {	1✔
174	$dolly = clone $this->parser->lastIndentation;	1✔
175	$this->parser->lastIndentation->content = '';	1✔
176	return $dolly;	1✔
177	} else {
178	return new Nodes\NopNode;	1✔
179	}
180	}
181
182
183	private function parseStartTag(&$elem = null): Html\ElementNode
184	{
185	$stream = $this->parser->getStream();	1✔
186	$openToken = $stream->consume(Token::Html_TagOpen);	1✔
187	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
188
189	[$textual, $variable] = $this->parseTagName($this->parser->strict);	1✔
190	if (($this->parser->strict \|\| $variable)	1✔
191	&& !$stream->is(Token::Whitespace, Token::Slash, Token::Html_TagClose)	1✔
192	) {
193	throw $stream->throwUnexpectedException();	×
194	}
195
196	$this->parser->lastIndentation = null;	1✔
197	$this->parser->inHead = false;	1✔
198	$elem = new Html\ElementNode(	1✔
199	name: $variable ? '' : $textual,	1✔
200	position: $openToken->position,	1✔
201	parent: $this->element,	1✔
202	data: (object) ['tag' => $this->parser->peekTag()],	1✔
203	contentType: $this->parser->getContentType(),	1✔
204	);
205	$elem->attributes = $this->parser->parseFragment([$this, 'inTagResolve']);	1✔
206	$elem->selfClosing = (bool) $stream->tryConsume(Token::Slash);	1✔
207	$elem->variableName = $variable;	1✔
208	$elem->data->textualName = $textual;	1✔
209	$stream->consume(Token::Html_TagClose);	1✔
210	$state = !$elem->selfClosing && $elem->isRawText()	1✔
211	? TemplateLexer::StateHtmlRawText	1✔
212	: TemplateLexer::StateHtmlText;	1✔
213	$this->parser->getLexer()->setState($state, $elem->name);	1✔
214	return $elem;	1✔
215	}
216
217
218	/** @return array{string, ?Nodes\Php\ExpressionNode} */
219	private function parseEndTag(): array
220	{
221	$stream = $this->parser->getStream();	1✔
222	$stream->consume(Token::Html_TagOpen);	1✔
223	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
224	$stream->consume(Token::Slash);	1✔
225	$name = $this->parseTagName();	1✔
226	$stream->tryConsume(Token::Whitespace);	1✔
227	$stream->consume(Token::Html_TagClose);	1✔
228	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);	1✔
229	return $name;	1✔
230	}
231
232
233	/** @return array{string, ?Nodes\Php\ExpressionNode} */
234	private function parseTagName(bool $strict = true): array	1✔
235	{
236	$variable = $text = null;	1✔
237	$parts = [];	1✔
238	$stream = $this->parser->getStream();	1✔
239	do {
240	if ($stream->is(Token::Latte_TagOpen)) {	1✔
241	$save = $stream->getIndex();	1✔
242	$statement = $this->parser->parseLatteStatement([$this, 'inTagResolve']);	1✔
243	if (!$statement instanceof Latte\Essential\Nodes\PrintNode) {	1✔
244	if (!$parts \|\| $strict) {	1✔
245	throw new CompileException('Only expression can be used as a HTML tag name.', $statement->position);	1✔
246	}
247	$stream->seek($save);	1✔
248	break;	1✔
249	}
250	$parts[] = $statement->expression;	1✔
251	$save -= $stream->getIndex();	1✔
252	while ($save < 0) {	1✔
253	$text .= $stream->peek($save++)->text;	1✔
254	}
255	$variable = true;	1✔
256
257	} elseif ($token = $stream->tryConsume(Token::Html_Name)) {	1✔
258	$parts[] = new Latte\Compiler\Nodes\Php\Scalar\StringNode($token->text, $token->position);	1✔
259	$text .= $token->text;	1✔
260
261	} elseif (!$parts) {	1✔
262	throw $stream->throwUnexpectedException([Token::Html_Name, Token::Latte_TagOpen]);	×
263	} else {
264	break;	1✔
265	}
266	} while (true);	1✔
267
268	$variable = $variable	1✔
269	? Latte\Compiler\Nodes\Php\Expression\BinaryOpNode::nest('.', ...$parts)	1✔
270	: null;	1✔
271	return [$text, $variable];	1✔
272	}
273
274
275	private function parseBogusEndTag(): ?Html\BogusTagNode
276	{
277	$stream = $this->parser->getStream();	1✔
278	$openToken = $stream->consume(Token::Html_TagOpen);	1✔
279	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
280	$this->parser->lastIndentation = null;	1✔
281	$this->parser->inHead = false;	1✔
282	$node = new Html\BogusTagNode(	1✔
283	openDelimiter: $openToken->text . $stream->consume(Token::Slash)->text . $stream->consume(Token::Html_Name)->text,	1✔
284	content: new Nodes\TextNode($stream->tryConsume(Token::Whitespace)->text ?? ''),	1✔
285	endDelimiter: $stream->consume(Token::Html_TagClose)->text,	1✔
286	position: $openToken->position,	1✔
287	);
288	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);	1✔
289	return $node;	1✔
290	}
291
292
293	private function parseBogusTag(): Html\BogusTagNode
294	{
295	$stream = $this->parser->getStream();	1✔
296	$openToken = $stream->consume(Token::Html_BogusOpen);	1✔
297	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlBogus);	1✔
298	$this->parser->lastIndentation = null;	1✔
299	$this->parser->inHead = false;	1✔
300	$content = $this->parser->parseFragment([$this->parser, 'inTextResolve']);	1✔
301	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);	1✔
302	return new Html\BogusTagNode(	1✔
303	openDelimiter: $openToken->text,	1✔
304	content: $content,
305	endDelimiter: $stream->consume(Token::Html_TagClose)->text,	1✔
306	position: $openToken->position,	1✔
307	);
308	}
309
310
311	private function resolveVoidness(Html\ElementNode $elem): bool	1✔
312	{
313	if ($elem->contentType !== ContentType::Html) {	1✔
314	return $elem->selfClosing;	1✔
315	} elseif (isset(Helpers::$emptyElements[strtolower($elem->name)])) {	1✔
316	return true;	1✔
317	} elseif ($elem->selfClosing) { // auto-correct	1✔
318	$elem->content = new Nodes\NopNode;	1✔
319	$elem->selfClosing = false;	1✔
320	$last = end($elem->attributes->children);	1✔
321	if ($last instanceof Nodes\TextNode && $last->isWhitespace()) {	1✔
322	array_pop($elem->attributes->children);	1✔
323	}
324	return true;	1✔
325	}
326
327	return $elem->selfClosing;	1✔
328	}
329
330
331	private function parseAttributeWhitespace(): Node
332	{
333	$stream = $this->parser->getStream();	1✔
334	$token = $stream->consume(Token::Whitespace);	1✔
335	return $stream->is(Token::Html_Name) && str_starts_with($stream->peek()->text, TemplateLexer::NPrefix)	1✔
336	? new Nodes\NopNode	1✔
337	: new Nodes\TextNode($token->text, $token->position);	1✔
338	}
339
340
341	private function parseAttribute(): ?Node
342	{
343	$stream = $this->parser->getStream();	1✔
344	if ($stream->is(Token::Latte_TagOpen)) {	1✔
345	$name = $this->parser->parseLatteStatement();	1✔
346	if (!$name instanceof Latte\Essential\Nodes\PrintNode) {	1✔
347	return $name; // value like '<span {if true}attr1=val{/if}>'	1✔
348	}
349	} else {
350	$name = $this->parser->parseText();	1✔
351	}
352
353	[$value, $quote] = $this->parseAttributeValue();	1✔
354	return new Html\AttributeNode(	1✔
355	name: $name,	1✔
356	value: $value,
357	quote: $quote,
358	position: $name->position,	1✔
359	);
360	}
361
362
363	private function parseAttributeValue(): ?array
364	{
365	$stream = $this->parser->getStream();	1✔
366	$save = $stream->getIndex();	1✔
367	$this->consumeIgnored();	1✔
368	if (!$stream->tryConsume(Token::Equals)) {	1✔
369	$stream->seek($save);	1✔
370	return null;	1✔
371	}
372
373	$this->consumeIgnored();	1✔
374	if ($quoteToken = $stream->tryConsume(Token::Quote)) {	1✔
375	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlQuotedValue, $quoteToken->text);	1✔
376	$value = $this->parser->parseFragment([$this->parser, 'inTextResolve']);	1✔
377	$stream->tryConsume(Token::Quote) \|\| $stream->throwUnexpectedException([$quoteToken->text], addendum: ", end of HTML attribute started $quoteToken->position");	1✔
378	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
379	return [$value, $quoteToken->text];	1✔
380	}
381
382	$value = $this->parser->parseFragment(	1✔
383	fn() => match ($stream->peek()->type) {	1✔
384	Token::Html_Name => $this->parser->parseText(),	1✔
385	Token::Latte_TagOpen => $this->parser->parseLatteStatement(),	1✔
386	Token::Latte_CommentOpen => $this->parser->parseLatteComment(),
387	default => null,	1✔
388	},	1✔
389	)->simplify() ?? $stream->throwUnexpectedException();	1✔
390	return [$value, null];	1✔
391	}
392
393
394	private function parseNAttribute(): Nodes\TextNode
395	{
396	$stream = $this->parser->getStream();	1✔
397	$nameToken = $stream->consume(Token::Html_Name);	1✔
398	$save = $stream->getIndex();	1✔
399	$pos = $stream->peek()->position;	1✔
400	$name = substr($nameToken->text, strlen(TemplateLexer::NPrefix));	1✔
401	if ($this->parser->peekTag() !== $this->element->data->tag) {	1✔
402	throw new CompileException("Attribute n:$name must not appear inside {tags}", $nameToken->position);	1✔
403
404	} elseif (isset($this->element->nAttributes[$name])) {	1✔
405	throw new CompileException("Found multiple attributes n:$name.", $nameToken->position);	1✔
406	}
407
408	$this->consumeIgnored();	1✔
409	if ($stream->tryConsume(Token::Equals)) {	1✔
410	$this->consumeIgnored();	1✔
411	if ($quoteToken = $stream->tryConsume(Token::Quote)) {	1✔
412	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlQuotedNAttrValue, $quoteToken->text);	1✔
413	$valueToken = $stream->tryConsume(Token::Text);	1✔
414	$pos = $stream->peek()->position;	1✔
415	$stream->tryConsume(Token::Quote) \|\| $stream->throwUnexpectedException([$quoteToken->text], addendum: ", end of n:attribute started $quoteToken->position");	1✔
416	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlTag);	1✔
417	} else {
418	$valueToken = $stream->consume(Token::Html_Name);	1✔
419	}
420	if ($valueToken) {	1✔
421	$tokens = (new TagLexer)->tokenize($valueToken->text, $valueToken->position);	1✔
422	}
423	} else {
424	$stream->seek($save);	1✔
425	}
426	$tokens ??= [new Token(Token::End, '', $pos)];	1✔
427
428	$this->element->nAttributes[$name] = new Tag(	1✔
429	name: preg_replace('~(inner-\|tag-\|)~', '', $name),	1✔
430	tokens: $tokens,
431	position: $nameToken->position,	1✔
432	prefix: $this->getPrefix($name),	1✔
433	inTag: true,	1✔
434	htmlElement: $this->element,	1✔
435	data: (object) ['node' => $node = new Nodes\TextNode('')], // TODO: better	1✔
436	);
437	return $node;	1✔
438	}
439
440
441	private function parseComment(): Html\CommentNode
442	{
443	$this->parser->lastIndentation = null;	1✔
444	$this->parser->inHead = false;	1✔
445	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlComment);	1✔
446	$stream = $this->parser->getStream();	1✔
447	$openToken = $stream->consume(Token::Html_CommentOpen);	1✔
448	$node = new Html\CommentNode(	1✔
449	position: $openToken->position,	1✔
450	content: $this->parser->parseFragment([$this->parser, 'inTextResolve']),	1✔
451	);
452	$stream->tryConsume(Token::Html_CommentClose) \|\| $stream->throwUnexpectedException([Token::Html_CommentClose], addendum: " started $openToken->position");	1✔
453	$this->parser->getLexer()->setState(TemplateLexer::StateHtmlText);	1✔
454	return $node;	1✔
455	}
456
457
458	private function consumeIgnored(): void
459	{
460	$stream = $this->parser->getStream();	1✔
461	do {
462	if ($stream->tryConsume(Token::Whitespace)) {	1✔
463	continue;	1✔
464	}
465	if ($stream->tryConsume(Token::Latte_CommentOpen)) {	1✔
466	$this->parser->getLexer()->pushState(TemplateLexer::StateLatteComment);	1✔
467	$stream->consume(Token::Text);	1✔
468	$stream->consume(Token::Latte_CommentClose);	1✔
469	$this->parser->getLexer()->popState();	1✔
470	$stream->tryConsume(Token::Newline);	1✔
471	continue;	1✔
472	}
473	return;	1✔
474	} while (true);	1✔
475	}
476
477
478	private function prepareNAttrs(array $attrs, bool $void): array	1✔
479	{
480	$res = [];	1✔
481	foreach ($this->attrParsers as $name => $foo) {	1✔
482	if ($tag = $attrs[$name] ?? null) {	1✔
483	$prefix = $this->getPrefix($name);	1✔
484	if (!$prefix \|\| !$void) {	1✔
485	$res[$prefix][] = $tag;	1✔
486	unset($attrs[$name]);	1✔
487	}
488	}
489	}
490
491	if ($attrs) {	1✔
492	$hint = Helpers::getSuggestion(array_keys($this->attrParsers), $k = key($attrs));	1✔
493	throw new CompileException('Unexpected attribute n:'	1✔
494	. ($hint ? "$k, did you mean n:$hint?" : implode(' and n:', array_keys($attrs))), $attrs[$k]->position);	1✔
495	}
496
497	return $res;	1✔
498	}
499
500
501	/**
502	* @param array<Tag> $toOpen
503	* @return array<array{\Generator, Tag}>
504	*/
505	private function openNAttrNodes(array $toOpen): array	1✔
506	{
507	$toClose = [];	1✔
508	foreach ($toOpen as $tag) {	1✔
509	$parser = $this->getAttrParser($tag->name, $tag->position);	1✔
510	$this->parser->pushTag($tag);	1✔
511	$res = $parser($tag, $this->parser);	1✔
512	if ($res instanceof \Generator && $res->valid()) {	1✔
513	$toClose[] = [$res, $tag];	1✔
514
515	} elseif ($res instanceof Node) {	1✔
516	$this->parser->ensureIsConsumed($tag);	1✔
517	$res->position = $tag->position;	1✔
518	$tag->replaceNAttribute($res);	1✔
519	$this->parser->popTag();	1✔
520
521	} elseif (!$res) {	1✔
522	$this->parser->ensureIsConsumed($tag);	1✔
523	$this->parser->popTag();	1✔
524
525	} else {
526	throw new CompileException("Unexpected value returned by {$tag->getNotation()} parser.", $tag->position);	×
527	}
528	}
529
530	return $toClose;	1✔
531	}
532
533
534	/** @param array<array{\Generator, Tag}> $toClose */
535	private function finishNAttrNodes(AreaNode $node, array $toClose): AreaNode	1✔
536	{
537	while ([$gen, $tag] = array_pop($toClose)) {	1✔
538	$gen->send([$node, null]);	1✔
539	$node = $gen->getReturn();	1✔
540	$node->position = $tag->position;	1✔
541	$this->parser->popTag();	1✔
542	$this->parser->ensureIsConsumed($tag);	1✔
543	}
544
545	return $node;	1✔
546	}
547
548
549	/** @return callable(Tag, TemplateParser): (Node\|\Generator\|void) */
550	private function getAttrParser(string $name, Position $pos): callable	1✔
551	{
552	if (!isset($this->attrParsers[$name])) {	1✔
553	$hint = ($t = Helpers::getSuggestion(array_keys($this->attrParsers), $name))	×
554	? ", did you mean n:$t?"	×
555	: '';	×
556	throw new CompileException("Unknown n:{$name}{$hint}", $pos);	×
557	} elseif (!$this->parser->isTagAllowed($name)) {	1✔
558	throw new SecurityViolationException("Attribute n:$name is not allowed", $pos);	1✔
559	}
560	return $this->attrParsers[$name];	1✔
561	}
562
563
564	private function getPrefix(string $name): string	1✔
565	{
566	return match (true) {
567	str_starts_with($name, 'inner-') => Tag::PrefixInner,	1✔
568	str_starts_with($name, 'tag-') => Tag::PrefixTag,	1✔
569	default => Tag::PrefixNone,	1✔
570	};
571	}
572	}

nette / latte / 6120418360

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous