@vituum/vite-plugin-latte 0.1.8

package/vendor/latte/latte/src/Latte/Compiler/TemplateGenerator.php

@@ -0,0 +1,206 @@
+<?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\ContentType;
+
+
+/**
+ * Template code generator.
+ */
+final class TemplateGenerator
+{
+	use Latte\Strict;
+
+	/** @var array<string, ?array{body: string, arguments: string, returns: string, comment: ?string}> */
+	private array $methods = [];
+
+	/** @var array<string, mixed> */
+	private array $properties = [];
+
+	/** @var array<string, mixed> */
+	private array $constants = [];
+
+
+	/**
+	 * Compiles nodes to PHP file
+	 */
+	public function generate(
+		Nodes\TemplateNode $node,
+		string $className,
+		?string $comment = null,
+		bool $strictMode = false,
+	): string {
+		$context = new PrintContext($node->contentType);
+		$code = $node->main->print($context);
+		$code = self::buildParams($code, [], '$ʟ_args', $context);
+		$this->addMethod('main', $code, 'array $ʟ_args');
+
+		$head = (new NodeTraverser)->traverse($node->head, fn(Node $node) => $node instanceof Nodes\TextNode ? new Nodes\NopNode : $node);
+		$code = $head->print($context);
+		if ($code || $context->paramsExtraction) {
+			$code .= 'return get_defined_vars();';
+			$code = self::buildParams($code, $context->paramsExtraction, '$this->params', $context);
+			$this->addMethod('prepare', $code, '', 'array');
+		}
+
+		if ($node->contentType !== ContentType::Html) {
+			$this->addConstant('ContentType', $node->contentType);
+		}
+
+		$this->generateBlocks($context->blocks, $context);
+
+		$members = [];
+		foreach ($this->constants as $name => $value) {
+			$members[] = "\tpublic const $name = " . PhpHelpers::dump($value, true) . ';';
+		}
+
+		foreach ($this->properties as $name => $value) {
+			$members[] = "\tpublic $$name = " . PhpHelpers::dump($value, true) . ';';
+		}
+
+		foreach (array_filter($this->methods) as $name => $method) {
+			$members[] = ($method['comment'] === null ? '' : "\n\t/** " . str_replace('*/', '* /', $method['comment']) . ' */')
+				. "\n\tpublic function $name($method[arguments])"
+				. ($method['returns'] ? ': ' . $method['returns'] : '')
+				. "\n\t{\n"
+				. ($method['body'] ? "\t\t$method[body]\n" : '') . "\t}";
+		}
+
+		$code = "<?php\n\n"
+			. ($strictMode ? "declare(strict_types=1);\n\n" : '')
+			. "use Latte\\Runtime as LR;\n\n"
+			. ($comment === null ? '' : '/** ' . str_replace('*/', '* /', $comment) . " */\n")
+			. "final class $className extends Latte\\Runtime\\Template\n{\n"
+			. implode("\n\n", $members)
+			. "\n}\n";
+
+		$code = PhpHelpers::optimizeEcho($code);
+		$code = PhpHelpers::reformatCode($code);
+		return $code;
+	}
+
+
+	/** @param  Block[]  $blocks */
+	private function generateBlocks(array $blocks, PrintContext $context): void
+	{
+		$contentType = $context->getEscaper()->getContentType();
+		foreach ($blocks as $block) {
+			if (!$block->isDynamic()) {
+				$meta[$block->layer][$block->name->value] = $contentType === $block->escaping
+					? $block->method
+					: [$block->method, $block->escaping];
+			}
+
+			$body = $this->buildParams($block->content, $block->parameters, '$ʟ_args', $context);
+			if (!$block->isDynamic() && str_contains($body, '$')) {
+				$embedded = $block->tag->name === 'block' && is_int($block->layer) && $block->layer;
+				$body = 'extract(' . ($embedded ? 'end($this->varStack)' : '$this->params') . ');' . $body;
+			}
+
+			$this->addMethod(
+				$block->method,
+				$body,
+				'array $ʟ_args',
+				'void',
+				$block->tag->getNotation(true) . ' on line ' . $block->tag->position->line,
+			);
+		}
+
+		if (isset($meta)) {
+			$this->addConstant('Blocks', $meta);
+		}
+	}
+
+
+	private function buildParams(string $body, array $params, string $cont, PrintContext $context): string
+	{
+		if (!str_contains($body, '$') && !str_contains($body, 'get_defined_vars()')) {
+			return $body;
+		}
+
+		$res = [];
+		foreach ($params as $i => $param) {
+			$res[] = $context->format(
+				'%node = %raw[%dump] ?? %raw[%dump] ?? %node;',
+				$param->var,
+				$cont,
+				$i,
+				$cont,
+				$param->var->name,
+				$param->default,
+			);
+		}
+
+		$extract = $params
+			? implode('', $res) . 'unset($ʟ_args);'
+			: "extract($cont);" . (str_contains($cont, '$this') ? '' : "unset($cont);");
+		return $extract . "\n\n" . $body;
+	}
+
+
+	/**
+	 * Adds custom method to template.
+	 * @internal
+	 */
+	public function addMethod(
+		string $name,
+		string $body,
+		string $arguments = '',
+		string $returns = 'void',
+		?string $comment = null,
+	): void {
+		$body = trim($body);
+		$this->methods[$name] = compact('body', 'arguments', 'returns', 'comment');
+	}
+
+
+	/**
+	 * Returns custom methods.
+	 * @return array<string, ?array{body: string, arguments: string, returns: string, comment: ?string}>
+	 * @internal
+	 */
+	public function getMethods(): array
+	{
+		return $this->methods;
+	}
+
+
+	/**
+	 * Adds custom property to template.
+	 * @internal
+	 */
+	public function addProperty(string $name, mixed $value): void
+	{
+		$this->properties[$name] = $value;
+	}
+
+
+	/**
+	 * Returns custom properites.
+	 * @return array<string, mixed>
+	 * @internal
+	 */
+	public function getProperties(): array
+	{
+		return $this->properties;
+	}
+
+
+	/**
+	 * Adds custom constant to template.
+	 * @internal
+	 */
+	public function addConstant(string $name, mixed $value): void
+	{
+		$this->constants[$name] = $value;
+	}
+}

package/vendor/latte/latte/src/Latte/Compiler/TemplateLexer.php

@@ -0,0 +1,391 @@
+<?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\ContentType;
+use Latte\RegexpException;
+
+
+final class TemplateLexer
+{
+	use Latte\Strict;
+
+	/** HTML tag name for Latte needs (actually is [a-zA-Z][^\s/>]*) */
+	public const ReTagName = '[a-zA-Z][a-zA-Z0-9:_.-]*';
+
+	/** special HTML attribute prefix */
+	public const NPrefix = 'n:';
+
+	/** HTML attribute name/value (\p{C} means \x00-\x1F except space) */
+	private const ReHtmlName = '[^\p{C} "\'<>=`/{}]+';
+	private const ReHtmlValue = '[^\p{C} "\'<>=`{}]+';
+	private const StateEnd = 'end';
+
+	public string $openDelimiter;
+	public string $closeDelimiter;
+	private TagLexer $tagLexer;
+
+	/** @var array<array{name: string, args: mixed[]}> */
+	private array $states;
+	private string $input;
+	private Position $position;
+	private bool $xmlMode;
+
+
+	/** @return \Generator<Token> */
+	public function tokenize(string $template, string $contentType = ContentType::Html): \Generator
+	{
+		$this->position = new Position(1, 1, 0);
+		$this->input = $this->normalize($template);
+		$this->states = [];
+		$this->setContentType($contentType);
+		$this->setSyntax(null);
+		$this->tagLexer = new TagLexer;
+
+		do {
+			$state = $this->states[0];
+			yield from $this->{$state['name']}(...$state['args']);
+		} while ($this->states[0]['name'] !== self::StateEnd);
+
+		if ($this->position->offset < strlen($this->input)) {
+			throw new CompileException("Unexpected '" . substr($this->input, $this->position->offset, 10) . "'", $this->position);
+		}
+
+		yield new Token(Token::End, '', $this->position);
+	}
+
+
+	private function statePlain(): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Text>.+?)??
+			(?<Indentation>(?<=\n|^)[ \t]+)?
+			(
+				(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|      # {tag
+				(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)|      # {* comment
+				$
+			)
+		~xsiAuD');
+
+		if (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateLatteTag(): \Generator
+	{
+		$this->popState();
+		yield from $this->match('~
+			(?<Slash>/)?
+			(?<Latte_Name> = | _(?!_) | [a-z]\w*+(?:[.:-]\w+)*+(?!::|\(|\\\\))?   # name, /name, but not function( or class:: or namespace\
+		~xsiAu');
+
+		yield from $this->tagLexer->tokenizePartially($this->input, $this->position);
+
+		yield from $this->match('~
+			(?<Slash>/)?
+			(?<Latte_TagClose>' . $this->closeDelimiter . ')
+			(?<Newline>[ \t]*\R)?
+		~xsiAu');
+	}
+
+
+	private function stateLatteComment(): \Generator
+	{
+		$this->popState();
+		yield from $this->match('~
+			(?<Text>.+?)??
+			(?<Latte_CommentClose>\*' . $this->closeDelimiter . ')
+			(?<Newline>[ \t]*\R{1,2})?
+		~xsiAu');
+	}
+
+
+	private function stateHtmlText(): \Generator
+	{
+		$m = yield from $this->match('~(?J)
+			(?<Text>.+?)??
+			(
+				(?<Indentation>(?<=\n|^)[ \t]+)?(?<Html_TagOpen><)(?<Slash>/)?(?<Html_Name>' . self::ReTagName . ')|  # <tag </tag
+				(?<Html_CommentOpen><!--(?!>|->))|                                                      # <!-- comment
+				(?<Html_BogusOpen><[/?!])|                                                              # <!doctype <?xml or error
+				(?<Indentation>(?<=\n|^)[ \t]+)?(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|   # {tag
+				(?<Indentation>(?<=\n|^)[ \t]+)?(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)|   # {* comment
+				$
+			)
+		~xsiAuD');
+
+		if (isset($m['Html_TagOpen'])) {
+			$tagName = isset($m['Slash']) ? null : strtolower($m['Html_Name']);
+			$this->setState('stateHtmlTag', $tagName);
+		} elseif (isset($m['Html_CommentOpen'])) {
+			$this->setState('stateHtmlComment');
+		} elseif (isset($m['Html_BogusOpen'])) {
+			$this->setState('stateHtmlBogus');
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlTag(?string $tagName = null, ?string $attrName = null): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Whitespace>\s+)|                                        # whitespace
+			(?<Equals>=)|
+			(?<Quote>["\'])|
+			(?<Slash>/)?(?<Html_TagClose>>)(?<Newline>[ \t]*\R)?|      # > />
+			(?<Html_Name>' . self::ReHtmlName . ')|                    # HTML attribute name/value
+			(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|      # {tag
+			(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)       # {* comment
+		~xsiAu');
+
+		if (isset($m['Html_Name'])) {
+			$this->states[0]['args'][1] = $m['Html_Name'];
+		} elseif (isset($m['Equals'])) {
+			yield from $this->match('~
+				(?<Whitespace>\s+)?                                    # whitespace
+				(?<Html_Name>' . self::ReHtmlValue . ')                # HTML attribute name/value
+			~xsiAu');
+		} elseif (isset($m['Whitespace'])) {
+		} elseif (isset($m['Quote'])) {
+			$this->pushState(str_starts_with($attrName, self::NPrefix)
+				? 'stateHtmlQuotedNAttrValue'
+				: 'stateHtmlQuotedValue', $m['Quote']);
+		} elseif (
+			isset($m['Html_TagClose'])
+			&& !$this->xmlMode
+			&& !isset($m['Slash'])
+			&& in_array($tagName, ['script', 'style'], true)
+		) {
+			$this->setState('stateHtmlRCData', $tagName);
+		} elseif (isset($m['Html_TagClose'])) {
+			$this->setState('stateHtmlText');
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlQuotedValue(string $quote): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Text>.+?)??(
+				(?<Quote>' . $quote . ')|
+				(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|      # {tag
+				(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)       # {* comment
+			)
+		~xsiAu');
+
+		if (isset($m['Quote'])) {
+			$this->popState();
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlQuotedNAttrValue(string $quote): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Text>.+?)??(?<Quote>' . $quote . ')|
+		~xsiAu');
+
+		if (isset($m['Quote'])) {
+			$this->popState();
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlRCData(string $tagName): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Text>.+?)??
+			(?<Indentation>(?<=\n|^)[ \t]+)?
+			(
+				(?<Html_TagOpen><)(?<Slash>/)(?<Html_Name>' . preg_quote($tagName, '~') . ')|  # </tag
+				(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|                          # {tag
+				(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)|                          # {* comment
+				$
+			)
+		~xsiAu');
+
+		if (isset($m['Html_TagOpen'])) {
+			$this->setState('stateHtmlTag');
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlComment(): \Generator
+	{
+		$m = yield from $this->match('~(?J)
+			(?<Text>.+?)??
+			(
+				(?<Html_CommentClose>-->)|                                                              # -->
+				(?<Indentation>(?<=\n|^)[ \t]+)?(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|   # {tag
+				(?<Indentation>(?<=\n|^)[ \t]+)?(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)    # {* comment
+			)
+		~xsiAu');
+
+		if (isset($m['Html_CommentClose'])) {
+			$this->setState('stateHtmlText');
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	private function stateHtmlBogus(): \Generator
+	{
+		$m = yield from $this->match('~
+			(?<Text>.+?)??(
+				(?<Html_TagClose>>)|                                       # >
+				(?<Latte_TagOpen>' . $this->openDelimiter . '(?!\*))|      # {tag
+				(?<Latte_CommentOpen>' . $this->openDelimiter . '\*)       # {* comment
+			)
+		~xsiAu');
+
+		if (isset($m['Html_TagClose'])) {
+			$this->setState('stateHtmlText');
+		} elseif (isset($m['Latte_TagOpen'])) {
+			$this->pushState('stateLatteTag');
+		} elseif (isset($m['Latte_CommentOpen'])) {
+			$this->pushState('stateLatteComment');
+		} else {
+			$this->setState(self::StateEnd);
+		}
+	}
+
+
+	/**
+	 * Matches next token.
+	 */
+	private function match(string $re): \Generator
+	{
+		if (!preg_match($re, $this->input, $matches, PREG_UNMATCHED_AS_NULL, $this->position->offset)) {
+			if (preg_last_error()) {
+				throw new RegexpException;
+			}
+
+			return [];
+		}
+
+		foreach ($matches as $k => $v) {
+			if ($v !== null && !\is_int($k)) {
+				yield new Token(\constant(Token::class . '::' . $k), $v, $this->position);
+				$this->position = $this->position->advance($v);
+			}
+		}
+
+		return $matches;
+	}
+
+
+	public function setContentType(string $type): static
+	{
+		if ($type === ContentType::Html || $type === ContentType::Xml) {
+			$this->setState('stateHtmlText');
+			$this->xmlMode = $type === ContentType::Xml;
+		} else {
+			$this->setState('statePlain');
+		}
+
+		return $this;
+	}
+
+
+	private function setState(string $state, ...$args): void
+	{
+		$this->states[0] = ['name' => $state, 'args' => $args];
+	}
+
+
+	private function pushState(string $state, ...$args): void
+	{
+		array_unshift($this->states, null);
+		$this->setState($state, ...$args);
+	}
+
+
+	private function popState(): void
+	{
+		array_shift($this->states);
+	}
+
+
+	/**
+	 * Changes tag delimiters.
+	 */
+	public function setSyntax(?string $type, ?string $endTag = null): static
+	{
+		$left = '\{(?![\s\'"{}])';
+		$end = $endTag ? '\{/' . preg_quote($endTag, '~') . '\}' : null;
+
+		[$this->openDelimiter, $this->closeDelimiter] = match ($type) {
+			null => [$left, '\}'], // {...}
+			'off' => [$endTag ? '(?=' . $end . ')\{' : '(?!x)x', '\}'],
+			'double' => $endTag // {{...}}
+				? ['(?:\{' . $left . '|(?=' . $end . ')\{)', '\}(?:\}|(?<=' . $end . '))']
+				: ['\{' . $left, '\}\}'],
+			default => throw new \InvalidArgumentException("Unknown syntax '$type'"),
+		};
+		return $this;
+	}
+
+
+	private function normalize(string $str): string
+	{
+		if (str_starts_with($str, "\u{FEFF}")) { // BOM
+			$str = substr($str, 3);
+		}
+
+		$str = str_replace("\r\n", "\n", $str);
+
+		if (!preg_match('##u', $str)) {
+			preg_match('#(?:[\x00-\x7F]|[\xC0-\xDF][\x80-\xBF]|[\xE0-\xEF][\x80-\xBF]{2}|[\xF0-\xF7][\x80-\xBF]{3})*+#A', $str, $m);
+			throw new CompileException('Template is not valid UTF-8 stream.', $this->position->advance($m[0]));
+
+		} elseif (preg_match('#(.*?)([\x00-\x08\x0B\x0C\x0E-\x1F\x7F])#s', $str, $m)) {
+			throw new CompileException('Template contains control character \x' . dechex(ord($m[2])), $this->position->advance($m[1]));
+		}
+		return $str;
+	}
+}