Extend issue template yaml engine

docs/content/usage/issue-pull-request-templates.en-us.md

@@ -135,6 +135,13 @@ body:
     attributes:
       value: |
         Thanks for taking the time to fill out this bug report!
+# some markdown witch will be visible only in the created issue
+  - type: markdown
+    attributes:
+      value: |
+        This issue git created by an issue **template** :)
+    hide: true
+    submit: true
   - type: input
     id: contact
     attributes:
@@ -186,18 +193,27 @@ body:
       options:
         - label: I agree to follow this project's Code of Conduct
           required: true
+        - label: I also have read the CONTRIBUTION.MD
+          required: true
+          submit: false
+        - label: This is a TODO only visible after issue creation
+          hide: true
 ```
 
 ### Markdown
 
-You can use a `markdown` element to display Markdown in your form that provides extra context to the user, but is not submitted.
+You can use a `markdown` element to display Markdown in your form that provides extra context to the user, but is not submitted by default.
 
 Attributes:
 
 | Key   | Description                                                  | Required | Type   | Default | Valid values |
 |-------|--------------------------------------------------------------|----------|--------|---------|--------------|
 | value | The text that is rendered. Markdown formatting is supported. | Required | String | -       | -            |
 
+Submit: Default is **false**
+
+Hide: Default is **false**
+
 ### Textarea
 
 You can use a `textarea` element to add a multi-line text field to your form. Contributors can also attach files in `textarea` fields.
@@ -218,6 +234,10 @@ Validations:
 |----------|------------------------------------------------------|----------|---------|---------|--------------|
 | required | Prevents form submission until element is completed. | Optional | Boolean | false   | -            |
 
+Submit: Default is **true**
+
+Hide: Default is **false**
+
 ### Input
 
 You can use an `input` element to add a single-line text field to your form.
@@ -239,6 +259,10 @@ Validations:
 | is_number | Prevents form submission until element is filled with a number.                                  | Optional | Boolean | false   | -                                                                        |
 | regex     | Prevents form submission until element is filled with a value that match the regular expression. | Optional | String  | -       | a [regular expression](https://en.wikipedia.org/wiki/Regular_expression) |
 
+Submit: Default is **true**
+
+Hide: Default is **false**
+
 ### Dropdown
 
 You can use a `dropdown` element to add a dropdown menu in your form.
@@ -258,6 +282,10 @@ Validations:
 |----------|------------------------------------------------------|----------|---------|---------|--------------|
 | required | Prevents form submission until element is completed. | Optional | Boolean | false   | -            |
 
+Submit: Default is **true**
+
+Hide: Default is **false**
+
 ### Checkboxes
 
 You can use the `checkboxes` element to add a set of checkboxes to your form.
@@ -276,6 +304,12 @@ For each value in the options array, you can set the following keys.
 |----------|------------------------------------------------------------------------------------------------------------------------------------------|----------|---------|---------|---------|
 | label    | The identifier for the option, which is displayed in the form. Markdown is supported for bold or italic text formatting, and hyperlinks. | Required | String  | -       | -       |
 | required | Prevents form submission until element is completed.                                                                                     | Optional | Boolean | false   | -       |
+| submit   | The specific checkbox that is rendered, will be submitted.                                                                               | Optional | Boolean | true    | -       |
+| hide     | Do not render in the from.                                                                                                               | Optional | Boolean | false   | -       |
+
+Submit: Default is **true**
+
+Hide: Default is **false**
 
 ## Syntax for issue config
 
@@ -291,15 +325,15 @@ contact_links:
 
 ### Possible Options
 
-| Key                  | Description                                                                                           | Type               | Default        |
-|----------------------|-------------------------------------------------------------------------------------------------------|--------------------|----------------|
-| blank_issues_enabled | If set to false, the User is forced to use a Template                                                 | Boolean            | true           |
-| contact_links        | Custom Links to show in the Choose Box                                                                | Contact Link Array | Empty Array    |
+| Key                  | Description                                           | Type               | Default     |
+|----------------------|-------------------------------------------------------|--------------------|-------------|
+| blank_issues_enabled | If set to false, the User is forced to use a Template | Boolean            | true        |
+| contact_links        | Custom Links to show in the Choose Box                | Contact Link Array | Empty Array |
 
 ### Contact Link
 
-| Key                  | Description                                                                                           | Type    | Required |
-|----------------------|-------------------------------------------------------------------------------------------------------|---------|----------|
-| name  | the name of your link                                                                                                | String  | true     |
-| url   | The URL of your Link                                                                                                 | String  | true     |
-| about | A short description of your Link                                                                                     | String  | true     |
+| Key   | Description                      | Type   | Required |
+|-------|----------------------------------|--------|----------|
+| name  | the name of your link            | String | true     |
+| url   | The URL of your Link             | String | true     |
+| about | A short description of your Link | String | true     |

modules/issue/template/template.go

@@ -177,6 +177,18 @@ func validateOptions(field *api.IssueFormField, idx int) error {
 					return position.Errorf("'required' should be a bool")
 				}
 			}
+
+			if submit, ok := opt["submit"]; ok {
+				if _, ok := submit.(bool); !ok {
+					return position.Errorf("'submit' should be a bool")
+				}
+			}
+
+			if hide, ok := opt["hide"]; ok {
+				if _, ok := hide.(bool); !ok {
+					return position.Errorf("'hide' should be a bool")
+				}
+			}
 		}
 	}
 	return nil
@@ -238,7 +250,7 @@ func RenderToMarkdown(template *api.IssueTemplate, values url.Values) string {
 			IssueFormField: field,
 			Values:         values,
 		}
-		if f.ID == "" {
+		if f.ID == "" || f.NoSubmit() {
 			continue
 		}
 		f.WriteTo(builder)
@@ -253,11 +265,6 @@ type valuedField struct {
 }
 
 func (f *valuedField) WriteTo(builder *strings.Builder) {
-	if f.Type == api.IssueFormFieldTypeMarkdown {
-		// markdown blocks do not appear in output
-		return
-	}
-
 	// write label
 	if !f.HideLabel() {
 		_, _ = fmt.Fprintf(builder, "### %s\n\n", f.Label())
@@ -269,6 +276,9 @@ func (f *valuedField) WriteTo(builder *strings.Builder) {
 	switch f.Type {
 	case api.IssueFormFieldTypeCheckboxes:
 		for _, option := range f.Options() {
+			if !option.Submit() {
+				continue
+			}
 			checked := " "
 			if option.IsChecked() {
 				checked = "x"
@@ -302,6 +312,10 @@ func (f *valuedField) WriteTo(builder *strings.Builder) {
 		} else {
 			_, _ = fmt.Fprintf(builder, "%s\n", value)
 		}
+	case api.IssueFormFieldTypeMarkdown:
+		if v, ok := f.Attributes["value"].(string); ok {
+			_, _ = fmt.Fprint(builder, v)
+		}
 	}
 	_, _ = fmt.Fprintln(builder)
 }
@@ -313,7 +327,19 @@ func (f *valuedField) Label() string {
 	return ""
 }
 
+func (f *valuedField) NoSubmit() bool {
+	// handle default case
+	if f.Submit == nil {
+		// markdown blocks do not appear in output by default
+		return f.Type == api.IssueFormFieldTypeMarkdown
+	}
+	return !*f.Submit
+}
+
 func (f *valuedField) HideLabel() bool {
+	if f.Type == api.IssueFormFieldTypeMarkdown {
+		return true
+	}
 	if label, ok := f.Attributes["hide_label"].(bool); ok {
 		return label
 	}
@@ -385,6 +411,17 @@ func (o *valuedOption) IsChecked() bool {
 	return false
 }
 
+func (o *valuedOption) Submit() bool {
+	if o.field.Type == api.IssueFormFieldTypeCheckboxes {
+		if vs, ok := o.data.(map[string]any); ok {
+			if v, ok := vs["submit"].(bool); ok {
+				return v
+			}
+		}
+	}
+	return true
+}
+
 var minQuotesRegex = regexp.MustCompilePOSIX("^`{3,}")
 
 // minQuotes return 3 or more back-quotes.