feat: Allow custom controls to add one or more Option based attributes

docs/formBuilder/demos/customOptions.md

@@ -0,0 +1,28 @@
+# Custom Options
+
+ControlTypes 'select', 'checkbox-group', 'checkbox', 'radio-group', 'autocomplete' all have the ability to have KeyValue option pairs defined.
+
+Custom controls can add Options using the `type: 'options'` when defining custom attributes.
+
+For example:
+```javascript
+{
+    defaultAttrs: {
+      questions: {
+        label: 'Questions',
+        type: 'options',
+        values: [
+          {
+            "label": "Default Column",
+            "value": "col1",
+            "selected": false
+          }
+        ],
+        noSelect: true
+      }
+}
+```
+
+The ability to pre-select any option can be enabled/disabled using the `noSelect` option flag.
+
+Multiple Option type attributes can be added to a control.

docs/formBuilder/options/onAddOption.md

@@ -4,11 +4,27 @@ transform the optionTemplate by return a modified template using the `onAddOptio
 
 ## Usage
 
+```javascript
+/**
+ * Callback
+ * @param optionTemplate Template for new option, expect to be modified if required and returned
+ * @param {string} optionTemplate.label Option label
+ * @param {string} optionTemplate.value Option value
+ * @param {bool} optionTemplate.selected Mark option as selected
+ * @param optionInfo Details about the option field
+ * @param {string} optionInfo.type Control type
+ * @param {string} optionInfo.index Index of new option 
+ * @param {bool} optionTemplate.isMultiple Does the attribute have multiple selections allowed
+ * @param {bool} optionTemplate.fieldName Name of the field these options are associated with.
+ */
+onAddOption: (optionTemplate, optionInfo)
+```
+
 ```javascript
 const options = {
-  onAddOption: (optionTemplate, optionIndex) => {
-    optionTemplate.label = `Option ${optionIndex + 1}`
-    optionTemplate.value = `option-${optionIndex + 1}`
+  onAddOption: (optionTemplate, optionInfo) => {
+    optionTemplate.label = `Option ${optionInfo.index + 1}`
+    optionTemplate.value = `option-${optionInfo.index + 1}`
     return optionTemplate
   },
 }
@@ -19,10 +35,10 @@ To add additional data with specific options, for example, to use with business
 
 ```javascript
 const options = {
-   onAddOption: (optionTemplate, optionIndex) => {
-      optionTemplate.label = `Option ${optionIndex.index + 1}`
-      optionTemplate.value = `option-${optionIndex.index + 1}`
-      optionTemplate.minLevel = `min-level-${optionIndex.index + 1}`
+   onAddOption: (optionTemplate, optionInfo) => {
+      optionTemplate.label = `Option ${optionInfo.index + 1}`
+      optionTemplate.value = `option-${optionInfo.index + 1}`
+      optionTemplate.minLevel = `min-level-${optionInfo.index + 1}`
 
       return optionTemplate
     }