15809643126

Committed 22 Jun 2025 06:35PM UTC coverage: 93.67% (+0.09%) from 93.583%

Build Type

push

github

Committed by

Commit Message

added {include?} {import?} {embed?} {sandbox?}

Coverage Stats

34 of 36 new or added lines in 7 files covered. (94.44%)

164 existing lines in 43 files now uncovered.

5164 of 5513 relevant lines covered (93.67%)

0.94 hits per line

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

97.87

/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, strtolower, substr;


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

nette / latte / 15809643126

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