FormNode: {form scope name} as alternative to {formContext name}

The scope keyword (placed before the form name) makes {form} skip the
<form> tag emission while still pushing the form on the stack, so
{input}/{label}/{inputError} resolve against it. Semantically identical
to {formContext}, but stays with the canonical {form} tag.

Author: dg

src/Bridges/FormsLatte/Nodes/FormNode.php

@@ -18,16 +18,22 @@
 
 
 /**
- * {form name [, attributes]} ... {/form}
+ * {form [scope] name [, attributes]} ... {/form}
  * {formContext name} ... {/formContext}
  * Renders form tags and initializes form context.
+ * The `scope` keyword makes {form} skip the <form> tag emission while still pushing the
+ * form on the stack — semantically identical to {formContext}, but with the canonical
+ * {form} tag.
  */
 class FormNode extends StatementNode
 {
+	private const Modes = ['scope'];
+
 	public ExpressionNode $name;
 	public ArrayNode $attributes;
 	public AreaNode $content;
 	public bool $print;
+	public ?string $mode = null;
 
 
 	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
@@ -40,13 +46,16 @@ public static function create(Tag $tag): \Generator
 		$tag->outputMode = $tag::OutputKeepIndentation;
 		$tag->expectArguments();
 		$node = $tag->node = new static;
+		$node->mode = $tag->name === 'form' && in_array($tag->parser->stream->tryPeek()?->text, self::Modes, strict: true)
+			? $tag->parser->stream->consume()->text
+			: null;
 		$node->name = $tag->parser->parseUnquotedStringOrExpression();
 		if (!$tag->parser->stream->tryConsume(',') && !$tag->parser->isEnd()) {
 			$position = $tag->parser->stream->peek()->position;
 			trigger_error("Missing comma before arguments in {{$tag->name}} tag $position.", E_USER_DEPRECATED);
 		}
 		$node->attributes = $tag->parser->parseArguments();
-		$node->print = $tag->name === 'form';
+		$node->print = $tag->name === 'form' && $node->mode !== 'scope';
 
 		[$node->content, $endTag] = yield;
 		if ($endTag && $node->name instanceof StringNode) {

tests/Forms.Latte/expected/forms.scope.html

@@ -0,0 +1,27 @@
+
+	<label for="frm-name">Name:</label>
+	<input type="text" name="name" id="frm-name">
+	<input type="text" name="email" id="frm-email">
+
+
+
+
+	<label for="frm-name">Name:</label>
+	<input type="text" name="name" id="frm-name">
+	<input type="text" name="email" id="frm-email">
+
+
+
+
+	<input type="text" name="name" id="frm-name">
+
+
+
+<form action="" method="post" class="outer">
+	<input type="text" name="name" id="frm-name">
+
+	
+		<input type="text" name="email" id="frm-email">
+	
+</form>
+

tests/Forms.Latte/expected/forms.scope.php

@@ -0,0 +1,66 @@
+<?php %A%
+		$this->global->forms->begin($form = $this->global->uiControl['myForm']) /* pos 3:1 */;
+		echo '
+	';
+		echo ($ʟ_label = $this->global->forms->item('name')->getLabel()) /* pos 4:2 */;
+		echo '
+	';
+		echo $this->global->forms->item('name')->getControl() /* pos 5:2 */;
+		echo '
+	';
+		echo $this->global->forms->item('email')->getControl() /* pos 6:2 */;
+		echo "\n";
+		$this->global->forms->end();
+
+		echo '
+
+
+';
+		$this->global->forms->begin($form = $this->global->uiControl['myForm']) /* pos 12:1 */;
+		echo '
+	';
+		echo ($ʟ_label = $this->global->forms->item('name')->getLabel()) /* pos 13:2 */;
+		echo '
+	';
+		echo $this->global->forms->item('name')->getControl() /* pos 14:2 */;
+		echo '
+	';
+		echo $this->global->forms->item('email')->getControl() /* pos 15:2 */;
+		echo "\n";
+		$this->global->forms->end();
+
+		echo '
+
+
+';
+		$this->global->forms->begin($form = $this->global->uiControl['myForm']) /* pos 21:1 */;
+		echo '
+	';
+		echo $this->global->forms->item('name')->getControl() /* pos 22:2 */;
+		echo "\n";
+		$this->global->forms->end();
+
+		echo '
+
+
+';
+		$this->global->forms->begin($form = $this->global->uiControl['myForm']) /* pos 28:1 */;
+		echo $this->global->forms->renderFormBegin(['class' => 'outer']) /* pos 28:1 */;
+		echo '
+	';
+		echo $this->global->forms->item('name')->getControl() /* pos 29:2 */;
+		echo '
+
+	';
+		$this->global->forms->begin($form = $this->global->uiControl['myForm']) /* pos 31:2 */;
+		echo '
+		';
+		echo $this->global->forms->item('email')->getControl() /* pos 32:3 */;
+		echo '
+	';
+		$this->global->forms->end();
+
+		echo "\n";
+		echo $this->global->forms->renderFormEnd() /* pos 34:1 */;
+		$this->global->forms->end();
+%A%

tests/Forms.Latte/forms.scope.phpt

@@ -0,0 +1,26 @@
+<?php declare(strict_types=1);
+
+use Nette\Bridges\FormsLatte\FormsExtension;
+use Nette\Forms\Form;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+$form = new Form;
+$form->addText('name', 'Name:');
+$form->addText('email', 'Email:');
+
+$latte = new Latte\Engine;
+$latte->addExtension(new FormsExtension);
+$latte->addProvider('uiControl', ['myForm' => $form]);
+
+Assert::matchFile(
+	__DIR__ . '/expected/forms.scope.php',
+	$latte->compile(__DIR__ . '/templates/forms.scope.latte'),
+);
+
+Assert::matchFile(
+	__DIR__ . '/expected/forms.scope.html',
+	$latte->renderToString(__DIR__ . '/templates/forms.scope.latte'),
+);

tests/Forms.Latte/templates/forms.scope.latte

@@ -0,0 +1,34 @@
+{* {form scope name}: form context without emitting <form> tag. Equivalent to {formContext}. *}
+
+{form scope myForm}
+	{label name /}
+	{input name}
+	{input email}
+{/form}
+
+
+{* Same with {formContext} — produces identical output. *}
+
+{formContext myForm}
+	{label name /}
+	{input name}
+	{input email}
+{/formContext}
+
+
+{* Attributes are accepted but ignored in scope mode (no <form> tag to apply them to). *}
+
+{form scope myForm, class: "ignored"}
+	{input name}
+{/form}
+
+
+{* Nested use: outer {form} emits <form>, inner {form scope} only resolves inputs. *}
+
+{form myForm, class: "outer"}
+	{input name}
+
+	{form scope myForm}
+		{input email}
+	{/form}
+{/form}