From 481e7014c4e899c77f6ee0f1c52747fd58502620 Mon Sep 17 00:00:00 2001
From: smeech <stephen@smeech.plus.com>
Date: Mon, 17 Mar 2025 10:31:38 +0000
Subject: [PATCH] Reworking of verbose-form-template package

I liked what the package could do, but followingn an initial dialogue with the author. we were still left with various issues in the  original PR https://github.com/espanso/hub/pull/85/files#diff-e9a373201f8cc15904a47996833a6560bd9c676535441158e0cf832b61f2f309

I decided to rework it and have:
- removed the original package whose name was prefixed with 'espanso-'
- rewritten `README.md` to replace the emphasis on `choice` in favour of `list`
- removed the image from the package
- updated `_manifest.yml` with corrected `name:`, `homepage:`, `title:`, and added my name as a contributor (hope that's OK!)
- reformatted `package.yml` to make it more readable, shortened the trigger, and reformatted the form so it displays better and is easier to use.

I submitted a PR to the author's repo three months ago, but no response, so it's time to submit it directly.
---
 .../verbose-form-template/1.0.1/README.md     | 58 +++++++++++++++++++
 .../verbose-form-template/1.0.1/_manifest.yml |  9 +++
 .../verbose-form-template/1.0.1/package.yml   | 42 ++++++++++++++
 3 files changed, 109 insertions(+)
 create mode 100644 packages/verbose-form-template/1.0.1/README.md
 create mode 100644 packages/verbose-form-template/1.0.1/_manifest.yml
 create mode 100644 packages/verbose-form-template/1.0.1/package.yml

diff --git a/packages/verbose-form-template/1.0.1/README.md b/packages/verbose-form-template/1.0.1/README.md
new file mode 100644
index 0000000..d52cd12
--- /dev/null
+++ b/packages/verbose-form-template/1.0.1/README.md
@@ -0,0 +1,58 @@
+# Espanso Form Extension Shortcut
+
+> This package allows you to quickly create a new Espanso shortcut containing a list Form extension. Please see the example below. 
+
+## Usage
+
+Let's say you want to create a new Espanso shortcut that will allow you to choose between different options such as a list of colors that you frequently use in styling. Or you have a list of co-worker logins that you need to use but can't always remember off-hand. You can use the Form extension to quickly generate a shortcut template to give you a list of options to choose from.
+
+Type `:vblf` (verbose list form) in your YAML code-editor and complete the information in the popup form. Once you click `Submit` a form trigger will be pasted in its place. Further edits, such as additional options, or changing the field `type:` to `choice`, can then be inserted.
+
+Please see [![espanso-verbose-form-template](https://img.youtube.com/vi/videoid/0.jpg)](https://www.youtube.com/watch?v=VEGv4aHV1d8)
+for a short video demo of an earlier version.
+
+```yaml
+# Example usage
+
+  - triggers: ['csscolors--', 'csscol--']
+    replace: "color:  {{CSS.color_name}}"
+    vars:
+      - name: "CSS"
+        type: form
+        params:
+          layout: "color_name: [[color_name]]" 
+          fields:
+            color_name:
+              type: list
+              values:
+              - red
+              - orange
+              - black
+              - white
+              - green
+              - blue
+              - purple
+              - pink
+              - yellow
+              - brown
+              - gray
+              - cyan
+              - magenta
+              - lime
+              - teal
+              - indigo
+              - violet
+              - fuchsia
+              - aqua
+              - maroon
+              - navy
+              - olive
+              - silver
+              - limegreen
+              - skyblue
+              - tan
+```
+
+## Source 
+
+Please refer to the awesome documentation for verbose syntax forms here https://espanso.org/docs/matches/forms/#controls-with-the-verbose-syntax
diff --git a/packages/verbose-form-template/1.0.1/_manifest.yml b/packages/verbose-form-template/1.0.1/_manifest.yml
new file mode 100644
index 0000000..86b7e82
--- /dev/null
+++ b/packages/verbose-form-template/1.0.1/_manifest.yml
@@ -0,0 +1,9 @@
+name: verbose-form-template
+title: A form trigger to generate form triggers!
+version: 1.0.1
+author: Omar Elmenawi, reworked by Stephen Meech
+description: Espanso shortcode to create espanso forms with the list extension
+tags: ["shortcut", "template", "form", "yml"]
+homepage: https://github.com/menawi/hub/tree/main/packages
+
+
diff --git a/packages/verbose-form-template/1.0.1/package.yml b/packages/verbose-form-template/1.0.1/package.yml
new file mode 100644
index 0000000..04cc2a2
--- /dev/null
+++ b/packages/verbose-form-template/1.0.1/package.yml
@@ -0,0 +1,42 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/espanso/espanso/dev/schemas/match.schema.json
+
+matches:
+
+# Description:
+#   - Allows you to specify:
+#     - form name
+#     - trigger
+#     - variable
+#     - replace
+#     - three starter list options
+
+  - trigger: ':vblf'
+    label: 'Espanso: Form - Verbose'
+    replace: |2-
+        - triggers: ['{{FORM.trigger}}']
+          replace: "{{FORM.replace}} {{{{FORM.form_name}}.{{FORM.variable}}}}"
+          vars:
+            - name: {{FORM.form_name}}
+              type: form
+              params:
+                layout: "{{FORM.variable}}: [[{{FORM.variable}}]]" 
+                fields:
+                  {{FORM.variable}}:
+                    type: list
+                    values:
+                    - {{FORM.list_option_one}}
+                    - {{FORM.list_option_two}}
+                    - {{FORM.list_option_three}}
+    vars:
+      - name: FORM
+        type: form
+        params:
+          layout: |-
+            Trigger: [[trigger]] Replace text: [[replace]] 
+            Form:
+            Name: [[form_name]] Variable: [[variable]]
+            Form list:        
+            Option one: [[list_option_one]] 
+            Option two: [[list_option_two]]
+            Option three: [[list_option_three]]
+