improved phpDoc for Latte nodes

dg · dg · commit 5fcf61c34430 · 2026-01-24T16:21:38.000+01:00
diff --git a/src/Bridges/FormsLatte/Nodes/FormContainerNode.php b/src/Bridges/FormsLatte/Nodes/FormContainerNode.php
@@ -17,7 +17,8 @@
 
 
 /**
- * {formContainer ...}
+ * {formContainer name} ... {/formContainer}
+ * Enters form container context for nested controls.
  */
 class FormContainerNode extends StatementNode
 {
diff --git a/src/Bridges/FormsLatte/Nodes/FormNode.php b/src/Bridges/FormsLatte/Nodes/FormNode.php
@@ -21,8 +21,9 @@
 
 
 /**
- * {form name} ... {/form}
- * {formContext ...}
+ * {form name [, attributes]} ... {/form}
+ * {formContext name} ... {/formContext}
+ * Renders form tags and initializes form context.
  */
 class FormNode extends StatementNode
 {
diff --git a/src/Bridges/FormsLatte/Nodes/FormPrintNode.php b/src/Bridges/FormsLatte/Nodes/FormPrintNode.php
@@ -16,8 +16,9 @@
 
 
 /**
- * {formPrint [ClassName]}
- * {formClassPrint [ClassName]}
+ * {formPrint [name]}
+ * {formClassPrint [name]}
+ * Generates Latte template or data class blueprint for form.
  */
 class FormPrintNode extends StatementNode
 {
diff --git a/src/Bridges/FormsLatte/Nodes/InputErrorNode.php b/src/Bridges/FormsLatte/Nodes/InputErrorNode.php
@@ -16,7 +16,8 @@
 
 
 /**
- * {inputError ...}
+ * {inputError name}
+ * Renders form control error message.
  */
 class InputErrorNode extends StatementNode
 {
diff --git a/src/Bridges/FormsLatte/Nodes/InputNode.php b/src/Bridges/FormsLatte/Nodes/InputNode.php
@@ -18,7 +18,8 @@
 
 
 /**
- * {input ...}
+ * {input name[:part] [, attributes]}
+ * Renders form control HTML.
  */
 class InputNode extends StatementNode
 {
diff --git a/src/Bridges/FormsLatte/Nodes/LabelNode.php b/src/Bridges/FormsLatte/Nodes/LabelNode.php
@@ -21,7 +21,9 @@
 
 
 /**
- * {label ...} ... {/label}
+ * {label name[:part] [, attributes]} ... {/label}
+ * {label name /}
+ * Renders form control label.
  */
 class LabelNode extends StatementNode
 {

Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,8 @@`
`17`	`17`
`18`	`18`
`19`	`19`	`/**`
`20`		`- * {formContainer ...}`
	`20`	`+ * {formContainer name} ... {/formContainer}`
	`21`	`+ * Enters form container context for nested controls.`
`21`	`22`	`*/`
`22`	`23`	`class FormContainerNode extends StatementNode`
`23`	`24`	`{`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,8 @@`
`16`	`16`
`17`	`17`
`18`	`18`	`/**`
`19`		`- * {inputError ...}`
	`19`	`+ * {inputError name}`
	`20`	`+ * Renders form control error message.`
`20`	`21`	`*/`
`21`	`22`	`class InputErrorNode extends StatementNode`
`22`	`23`	`{`
Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,8 @@`
`18`	`18`
`19`	`19`
`20`	`20`	`/**`
`21`		`- * {input ...}`
	`21`	`+ * {input name[:part] [, attributes]}`
	`22`	`+ * Renders form control HTML.`
`22`	`23`	`*/`
`23`	`24`	`class InputNode extends StatementNode`
`24`	`25`	`{`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,9 @@`
`21`	`21`
`22`	`22`
`23`	`23`	`/**`
`24`		`- * {label ...} ... {/label}`
	`24`	`+ * {label name[:part] [, attributes]} ... {/label}`
	`25`	`+ * {label name /}`
	`26`	`+ * Renders form control label.`
`25`	`27`	`*/`
`26`	`28`	`class LabelNode extends StatementNode`
`27`	`29`	`{`