19672940570

Committed 25 Nov 2025 02:27PM UTC coverage: 93.959% (+0.01%) from 93.948%

Build # 19672940570

Build Type

push

github

Committed by

Commit Message

removed comment /*readonly*/

Run Details

5273 of 5612 relevant lines covered (93.96%)

0.94 hits per line

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

97.94

/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;
use function array_keys, array_pop, end, implode, in_array, key, preg_replace, str_starts_with, strlen, substr;


/**
 * Template parser extension for HTML.
 */
final class TemplateParserHtml
{
        /** @var array<string, callable(Tag, TemplateParser): (Node|\Generator|void)> */
        private array $attrParsers;
        private ?Html\ElementNode $element = null;
        private TemplateParser $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();
                $lexer = $this->parser->getLexer();
                $lexer->pushState(TemplateLexer::StateHtmlTag);
                $closing = $stream->peek(1)?->is(Token::Slash);
                $lexer->popState();
                if (!$closing) {
                        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) {
                        if ($elem->isRawText()) {
                                $this->parser->getLexer()->pushState(TemplateLexer::StateHtmlRawText, $elem->name);
                        }
                        $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));
                        if ($elem->isRawText()) {
                                $this->parser->getLexer()->popState();
                        }

                        [$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();
                $lexer = $this->parser->getLexer();
                $openToken = $stream->consume(Token::Html_TagOpen);
                $lexer->pushState(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);
                $lexer->popState();
                return $elem;
        }


        /** @return array{string, ?Nodes\Php\ExpressionNode} */
        private function parseEndTag(): array
        {
                $stream = $this->parser->getStream();
                $lexer = $this->parser->getLexer();
                $stream->consume(Token::Html_TagOpen);
                $lexer->pushState(TemplateLexer::StateHtmlTag);
                $stream->consume(Token::Slash);
                if (isset($this->element->nAttributes['syntax'])) {  // hardcoded
                        $lexer->popSyntax();
                }
                $name = $this->parseTagName();
                $stream->tryConsume(Token::Whitespace);
                $stream->consume(Token::Html_TagClose);
                $lexer->popState();
                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 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();
                $lexer = $this->parser->getLexer();
                $openToken = $stream->consume(Token::Html_TagOpen);
                $lexer->pushState(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,
                );
                $lexer->popState();
                return $node;
        }


        private function parseBogusTag(): Html\BogusTagNode
        {
                $stream = $this->parser->getStream();
                $lexer = $this->parser->getLexer();
                $openToken = $stream->consume(Token::Html_BogusOpen);
                $lexer->pushState(TemplateLexer::StateHtmlBogus);
                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $content = $this->parser->parseFragment([$this->parser, 'inTextResolve']);
                $lexer->popState();
                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 (Latte\Runtime\HtmlHelpers::isVoidElement($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 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)) {
                        $lexer = $this->parser->getLexer();
                        $lexer->pushState(TemplateLexer::StateHtmlQuotedValue, $quoteToken->text);
                        $value = $this->parser->parseFragment([$this->parser, 'inTextResolve'])->simplify(allowsNull: false);
                        $stream->tryConsume(Token::Quote) || $stream->throwUnexpectedException([$quoteToken->text], addendum: ", end of HTML attribute started $quoteToken->position");
                        $lexer->popState();
                        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)) {
                        $lexer = $this->parser->getLexer();
                        $this->consumeIgnored();
                        if ($quoteToken = $stream->tryConsume(Token::Quote)) {
                                $lexer->pushState(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");
                                $lexer->popState();
                        } 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,
                        nAttributeNode: $node = new Nodes\TextNode(''),
                );
                return $node;
        }


        private function parseComment(): Html\CommentNode
        {
                $lexer = $this->parser->getLexer();
                $this->parser->lastIndentation = null;
                $this->parser->inHead = false;
                $lexer->pushState(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");
                $lexer->popState();
                return $node;
        }


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

nette / latte / 19672940570

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