pict-section-form 1.0.165 → 1.0.167

package/debug/PICTSection-TabularManifests.json

@@ -97,6 +97,19 @@
                 },
                 "Default": "50000"
             },
+            "Header.BoxRowCount": {
+                "Hash": "HeaderBoxRowCount",
+                "Name": "Number of Box Styles",
+                "DataAddress": "Header.BoxRowCount",
+                "DataType": "Number",
+                "PictForm": {
+                    "Row": "5",
+                    "Width": "12",
+                    "Section": "Header",
+                    "Group": "General_Info"
+                },
+                "Default": "8"
+            },
             "BookData.CurrentIDBook": {
                 "Hash": "CurrentIDBook",
                 "Name": "IDBook",
@@ -169,7 +182,7 @@
                     "Section": "Basic_Geometry",
                     "Group": "BasicGeoGrp"
                 },
-                "Default": "10.3571",
+                "Default": "5",
                 "AnotherObject": {
                     "NotPictForm": {
                         "y": 22
@@ -721,7 +734,9 @@
             {
                 "Name": "Header",
                 "Hash": "Header",
-                "Solvers": [],
+                "Solvers": [
+                    "BoxRowCountSuccess = SETTABULARROWLENGTH(\"BoxCollSec\", \"BoxCollGrp\", HeaderBoxRowCount, 1)"
+                ],
                 "Groups": [
                     {
                         "Name": "General Info",

package/debug/TabularManifestCSV.csv

@@ -7,10 +7,11 @@ MathExampleForm,,,,,,Header,,General Info,,,,,2,12,,,Header.Description,Descript
 MathExampleForm,,,,,,Header,,General Info,,,,,3,6,,,Header.Planet,Planet,Planet,,planetary,String,,Option,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,,General Info,,,,,3,6,,,Header.Universe,Universe,Universe,,planetary,String,,Option,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,15.2,17
 MathExampleForm,,,,,,Header,,General Info,,,,,4,12,,,Header.WarehouseVolume,Warehouse Volume,WarehouseVolume,,,Number,,,,,50000,,,,,,,,,,,,,,,,,,,,,,,,,,,,,t,,
+MathExampleForm,,,,,,Header,,General Info,,,,,5,12,,,Header.BoxRowCount,Number of Box Styles,HeaderBoxRowCount,,,Number,,,"BoxRowCountSuccess = SETTABULARROWLENGTH(""BoxCollSec"", ""BoxCollGrp"", HeaderBoxRowCount, 1)",,8,,,,,,,,,,,,,,,,,,,,,,,,,,,,,t,,
 MathExampleForm,,,,,,REST Request,,Book Data,,,,,1,6,,,BookData.CurrentIDBook,IDBook,CurrentIDBook,,,Number,,,,,,,,Book from REST request,Book,IDBook,LoadedBook,,,,,,,,,,,,,,,,,,,,,,,,86,
 MathExampleForm,,,,,,MatheMagic,,Math is Magic,,,,,1,1,,,HelpContent.Math,So Very Magic,MathHelpContent,,,String,,HTML,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Width,Width,RectangleWidth,,,Number,,,,,7.25,,,,,,,,,,,,,,,,,,,,,,,,,,,,,y,11,190
-MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Height,Height,RectangleHeight,,,Number,,,,,10.3571,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,22
+MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Height,Height,RectangleHeight,,,Number,,,,,5,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,22
 MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.Area,Area,RectangleArea,,unrounded,Number,,,RectangleArea = RectangleWidth * RectangleHeight,,,Area of the Rectangle.,,,,,,,,,,,,,,,,,,,,,,,,,,,This is a test for random data injection.,1,,
 MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.AreaRoundedDefault,Area Rounded,RectangleAreaRoundedDefault,,default,Number,,,RectangleAreaRoundedDefault = ROUND(RectangleWidth * RectangleHeight),,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,frog,
 MathExampleForm,,,,,,Basic Geometry,,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.AreaRoundedThree,Area Rounded 3,RectangleAreaRoundedThree,,3,Number,,,"RectangleAreaRoundedThree = ROUND((RectangleWidth * RectangleHeight), 3)",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

package/debug/data/DefaultFormManifest.json

@@ -96,6 +96,19 @@
             },
             "Default": "50000"
         },
+        "Header.BoxRowCount": {
+            "Hash": "HeaderBoxRowCount",
+            "Name": "Number of Box Styles",
+            "DataAddress": "Header.BoxRowCount",
+            "DataType": "Number",
+            "PictForm": {
+                "Row": "5",
+                "Width": "12",
+                "Section": "Header",
+                "Group": "General_Info"
+            },
+            "Default": "8"
+        },
         "BookData.CurrentIDBook": {
             "Hash": "CurrentIDBook",
             "Name": "IDBook",
@@ -169,7 +182,7 @@
                 "Section": "Basic_Geometry",
                 "Group": "BasicGeoGrp"
             },
-            "Default": "10.3571",
+            "Default": "5",
             "AnotherObject": {
                 "NotPictForm": {
                     "y": 22
@@ -870,7 +883,9 @@
         {
             "Name": "Header",
             "Hash": "Header",
-            "Solvers": [],
+            "Solvers": [
+                "BoxRowCountSuccess = SETTABULARROWLENGTH(\"BoxCollSec\", \"BoxCollGrp\", HeaderBoxRowCount, 1)"
+            ],
             "Groups": [
                 {
                     "Name": "General Info",

package/debug/data/MathExampleForm-Reconstituted.csv

@@ -1,15 +1,16 @@
 Form,Form Name,SubManifest,HideTabularEditingControls,GroupRecordSetAddress,DataOnly,Section Name,Section Hash,Group Name,Group Hash,Group Layout,Group CSS,Group Show Title,Row,Width,Minimum Row Count,Maximum Row Count,Input Address,Input Name,Input Hash,Input Extra,Units,DataType,Decimal Precision,InputType,Equation,Equation Ordinal,Default,Description,Tooltip,Input Notes,Entity,EntityColumnFilter,EntityDestination,SingleRecord,TriggerGroup,TriggerAddress,TriggerAllInputs,MarshalEmptyValues,ChartType,ChartLabelsAddress,ChartLabelsSolver,ChartDatasetsAddress,ChartDatasetsLabel,ChartDatasetsSolvers
-MathExampleForm,Math Example Form,,,,,Header,Header,General Info,General_Info,,,,1,3,,,Header.FirstName,First Name,HeaderFirstName,,,String,,,,,,,,,,,,,,,,,,,,,,
+MathExampleForm,Math Example Form,,,,,Header,Header,General Info,General_Info,,,,1,3,,,Header.FirstName,First Name,HeaderFirstName,,,String,,,"BoxRowCountSuccess = SETTABULARROWLENGTH(""BoxCollSec"", ""BoxCollGrp"", HeaderBoxRowCount, 1)",1,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,1,3,,,Header.LastName,Last Name,HeaderLastName,,,String,,,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,1,6,,,Header.JobTitle,Job Title,JobTitle,,,String,,,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,2,12,,,Header.Description,Description,Description,,,String,,,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,3,6,,,Header.Planet,Planet,Planet,,planetary,String,,Option,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,3,6,,,Header.Universe,Universe,Universe,,planetary,String,,Option,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,4,12,,,Header.WarehouseVolume,Warehouse Volume,WarehouseVolume,,,Number,,,,,50000,,,,,,,,,,,,,,,,,
+MathExampleForm,,,,,,Header,Header,General Info,General_Info,,,,5,12,,,Header.BoxRowCount,Number of Box Styles,HeaderBoxRowCount,,,Number,,,,,8,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,REST Request,REST_Request,Book Data,Book_Data,,,,1,6,,,BookData.CurrentIDBook,IDBook,CurrentIDBook,,,Number,,,,,,,,Book from REST request,Book,IDBook,LoadedBook,,,,,,,,,,,
 MathExampleForm,,,,,,MatheMagic,MatheMagic,Math is Magic,Math_is_Magic,,,,1,1,,,HelpContent.Math,So Very Magic,MathHelpContent,,,String,,HTML,,,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Width,Width,RectangleWidth,,,Number,,,RectangleArea = RectangleWidth * RectangleHeight,1,7.25,,,,,,,,,,,,,,,,,
-MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Height,Height,RectangleHeight,,,Number,,,RectangleAreaRoundedDefault = ROUND(RectangleWidth * RectangleHeight),1,10.3571,,,,,,,,,,,,,,,,,
+MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,1,6,,,Geometry.Rectangle.Height,Height,RectangleHeight,,,Number,,,RectangleAreaRoundedDefault = ROUND(RectangleWidth * RectangleHeight),1,5,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.Area,Area,RectangleArea,,unrounded,Number,,,"RectangleAreaRoundedThree = ROUND((RectangleWidth * RectangleHeight), 3)",1,,Area of the Rectangle.,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.AreaRoundedDefault,Area Rounded,RectangleAreaRoundedDefault,,default,Number,,,"RectangleAreaRoundedFive = ROUND(RectangleArea, 5)",1,,,,,,,,,,,,,,,,,,
 MathExampleForm,,,,,,Basic Geometry,Basic_Geometry,Rectangle,BasicGeoGrp,,,,2,3,,,Geometry.Rectangle.AreaRoundedThree,Area Rounded 3,RectangleAreaRoundedThree,,3,Number,,,CircleArea = PI() * CircleRadius^2,1,,,,,,,,,,,,,,,,,,

package/debug/data/MathExampleForm.json

@@ -96,6 +96,19 @@
             },
             "Default": "50000"
         },
+        "Header.BoxRowCount": {
+            "Hash": "HeaderBoxRowCount",
+            "Name": "Number of Box Styles",
+            "DataAddress": "Header.BoxRowCount",
+            "DataType": "Number",
+            "PictForm": {
+                "Row": "5",
+                "Width": "12",
+                "Section": "Header",
+                "Group": "General_Info"
+            },
+            "Default": "8"
+        },
         "BookData.CurrentIDBook": {
             "Hash": "CurrentIDBook",
             "Name": "IDBook",
@@ -169,7 +182,7 @@
                 "Section": "Basic_Geometry",
                 "Group": "BasicGeoGrp"
             },
-            "Default": "10.3571",
+            "Default": "5",
             "AnotherObject": {
                 "NotPictForm": {
                     "y": 22
@@ -870,7 +883,9 @@
         {
             "Name": "Header",
             "Hash": "Header",
-            "Solvers": [],
+            "Solvers": [
+                "BoxRowCountSuccess = SETTABULARROWLENGTH(\"BoxCollSec\", \"BoxCollGrp\", HeaderBoxRowCount, 1)"
+            ],
             "Groups": [
                 {
                     "Name": "General Info",

package/example_applications/complex_table/Complex-Tabular-Application.js

@@ -2,6 +2,62 @@ const libPictSectionForm = require('../../source/Pict-Section-Form.js');
 
 const libCustomDataProvider = require('./Complex-Tabular-CustomDataProvider.js');
 
+const SelectInputProvider = require('../../source/providers/inputs/Pict-Provider-Input-Select.js');
+
+class CustomSelectInputProvider extends SelectInputProvider
+{
+	/**
+	 * Handles events for the Pict-Provider-InputExtension.
+	 *
+	 * @param {Object} pView - The view object.
+	 * @param {Object} pInput - The input object.
+	 * @param {any} pValue - The value from AppData.
+	 * @param {string} pHTMLSelector - The HTML selector.
+	 * @param {string} pEvent - The event hash that is expected to be triggered.
+	 * @param {string} pTransactionGUID - The transaction GUID, if any.
+	 * @returns {boolean} - Returns true.
+	 */
+	onEvent(pView, pInput, pValue, pHTMLSelector, pEvent, pTransactionGUID)
+	{
+		const tmpResult = super.onEvent(pView, pInput, pValue, pHTMLSelector, pEvent, pTransactionGUID);
+		if (typeof pEvent !== "string")
+		{
+			return tmpResult;
+		}
+		const tmpEventParts = pEvent.split(':');
+		const tmpEventHash = tmpEventParts[0];
+		if (tmpEventHash !== 'GetPickList')
+		{
+			return tmpResult;
+		}
+		const tmpListHash = tmpEventParts[1];
+		if (tmpListHash !== pInput.PictForm.SelectOptionsPickList)
+		{
+			return tmpResult;
+		}
+		const tmpListDataAddress = tmpEventParts[2];
+		const tmpEventOptions = JSON.parse(tmpEventParts.slice(3).join(':'));
+		this.pict.log.info(`CustomSelectInputProvider received event: ${pEvent} for list ${tmpListHash} with options:`, { tmpEventHash, tmpListHash, tmpListDataAddress, tmpEventOptions });
+		const tmpListData = this.pict.manifest.getValueByHash(this.pict, tmpListDataAddress);
+		if (!Array.isArray(tmpListData))
+		{
+			this.pict.log.error(`CustomSelectInputProvider expected array data at address ${tmpListDataAddress} but found:`, { tmpListData });
+			return tmpResult;
+		}
+		if (tmpListData.length > 0)
+		{
+			return tmpResult;
+		}
+		for (let i = 0; i < 10; ++i)
+		{
+			const tmpRandomNumber = Math.floor(Math.random() * 1000);
+			tmpListData.push({ id: `random-${tmpRandomNumber}`, text: `${tmpRandomNumber}` });
+		}
+
+		return tmpResult;
+	}
+}
+
 class ComplexTabularApplication extends libPictSectionForm.PictFormApplication
 {
 	constructor(pFable, pOptions, pServiceHash)
@@ -16,6 +72,12 @@ class ComplexTabularApplication extends libPictSectionForm.PictFormApplication
 		this.pict.AppData.UI.StatisticsTabState = "FruitStatistics";
 		this.pict.addProvider('CustomDataProvider', libCustomDataProvider.default_configuration, libCustomDataProvider);
 	}
+
+	onInitialize()
+	{
+		this.pict.addProvider('Pict-Input-Select', CustomSelectInputProvider.default_configuration, CustomSelectInputProvider);
+		return super.onInitialize();
+	}
 }
 
 module.exports = ComplexTabularApplication;
@@ -67,7 +129,11 @@ module.exports.default_configuration.pict_configuration = {
 					IDTemplate: "{~D:Record.IDBook~}",
 					Sorted: true,
 					UpdateFrequency: "Always",
-				}
+				},
+				{
+					Hash: "RandomNumbers",
+					Dynamic: true,
+				},
 			],
 
 		Sections: [
@@ -200,6 +266,12 @@ module.exports.default_configuration.pict_configuration = {
 		],
 
 		Descriptors: {
+			RandomNumber: {
+				Name: "Pick a Random Number",
+				Hash: "PickRandomNumber",
+				DataType: "String",
+				PictForm: { Section: "Recipe", Group: "Recipe", Row: 1, InputType: "Option", SelectOptionsPickList: "RandomNumbers" },
+			},
 			RecipeName: {
 				Name: "Recipe Name",
 				Hash: "RecipeName",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pict-section-form",
-    "version": "1.0.165",
+    "version": "1.0.167",
     "description": "Pict dynamic form sections",
     "main": "source/Pict-Section-Form.js",
     "directories": {
@@ -45,7 +45,7 @@
         "chart.js": "^4.5.1",
         "fable-serviceproviderbase": "^3.0.15",
         "marked": "^15.0.12",
-        "pict-provider": "^1.0.6",
+        "pict-provider": "^1.0.7",
         "pict-section-tuigrid": "^1.0.27",
         "pict-template": "^1.0.13",
         "pict-view": "^1.0.64"

package/source/providers/Pict-Provider-DynamicFormSolverBehaviors.js

@@ -91,6 +91,8 @@ class PictDynamicFormsSolverBehaviors extends libPictProvider
 		this.addSolverFunction(pExpressionParser, 'enablesolverordinal', 'fable.providers.DynamicFormSolverBehaviors.enableSolverOrdinal', 'Enables a solver ordinal so that it can run.');
 		this.addSolverFunction(pExpressionParser, 'disablesolverordinall', 'fable.providers.DynamicFormSolverBehaviors.disableSolverOrdinal', 'Disables a solver ordinal so that it will not run.');
 
+		this.addSolverFunction(pExpressionParser, 'settabularrowlength', 'fable.providers.DynamicFormSolverBehaviors.setTabularRowLength', 'Sets the length of a tabular data set.');
+
 		return false;
 	}
 
@@ -241,6 +243,66 @@ class PictDynamicFormsSolverBehaviors extends libPictProvider
 		return true;
 	}
 
+	/**
+	 * Set the length of a tabular set
+	 * @param {string} pSectionHash - The hash of the section containing the tabular group
+	 * @param {string} pGroupHash - The hash of the tabular group
+	 * @param {number|string} pLength - The desired length of the tabular set
+	 * @param {boolean|string} pDeleteExtraRows - If true, will delete extra rows from the end if the length is less than current 
+	 * @returns 
+	 */
+	setTabularRowLength(pSectionHash, pGroupHash, pLength, pDeleteExtraRows = false)
+	{
+		let tmpGroupView = this.pict.views.PictFormMetacontroller.getSectionViewFromHash(pSectionHash)
+		if (!tmpGroupView)
+		{
+			this.log.warn(`PictDynamicFormsInformary: showGroup could not find group with section hash [${pSectionHash}] group [${pGroupHash}].`);
+			return false;
+		}
+		let tmpGroupIndex = tmpGroupView.getGroupIndexFromHash(pGroupHash);
+		if (tmpGroupIndex < 0)
+		{
+			this.log.warn(`PictDynamicFormsInformary: setTabularRowLength could not find group with section hash [${pSectionHash}] group [${pGroupHash}].`);
+			return false;
+		}
+		let tmpTabularRecordSet = tmpGroupView.getTabularRecordSet(tmpGroupIndex);
+		if (!tmpTabularRecordSet || !Array.isArray(tmpTabularRecordSet))
+		{
+			this.log.warn(`PictDynamicFormsInformary: setTabularRowLength could not find a valid tabular record set with section hash [${pSectionHash}] group [${pGroupHash}].`);
+			return false;
+		}
+
+		let tmpLength = parseInt(pLength.toString());
+		if (isNaN(tmpLength) || tmpLength < 0)
+		{
+			this.log.warn(`PictDynamicFormsInformary: setTabularRowLength was given an invalid length [${pLength}] with section hash [${pSectionHash}] group [${pGroupHash}].`);
+			return false;
+		}
+
+		// See if the length is less than what we have
+		let tmpCurrentLength = tmpTabularRecordSet.length;
+
+		let tmpDeleteExtraRows = (pDeleteExtraRows == true || pDeleteExtraRows == '1');
+
+		if (tmpLength > tmpCurrentLength)
+		{
+			// Add rows until we are at the expected length
+			for (let i = tmpCurrentLength; i < tmpLength; i++)
+			{
+				tmpGroupView.createDynamicTableRow(tmpGroupIndex);
+			}
+		}
+		else if (tmpLength < tmpCurrentLength && tmpDeleteExtraRows)
+		{
+			// Remove rows from the end until we are at the expected length
+			for (let i = tmpCurrentLength - 1; i >= tmpLength; i--)
+			{
+				tmpGroupView.deleteDynamicTableRow(tmpGroupIndex, i);
+			}
+		}
+	}
+
+
 	generateHTMLHexColor(pRed, pGreen, pBlue)
 	{
 		let tmpRed = (parseInt(pRed) || 0);

package/source/providers/Pict-Provider-MetaLists.js

@@ -30,7 +30,7 @@ class PictMetalist extends libPictProvider
 
 		/** @type {any} */
 		this.options;
-		/** @type {import('pict')} */
+		/** @type {import('pict') & { log: any, instantiateServiceProviderWithoutRegistration: (hash: String) => any, instantiateServiceProviderIfNotExists: (hash: string) => any, TransactionTracking: import('pict/types/source/services/Fable-Service-TransactionTracking') }} */
 		this.pict;
 		/** @type {import('pict')} */
 		this.fable;
@@ -44,15 +44,31 @@ class PictMetalist extends libPictProvider
 		this.computedLists = {};
 		this.listDefinitions = {};
 	}
+	/** @typedef {{ id: string, text: string }} PickListItem */
 
 	/**
 	 * Retrieves a list based on the provided view hash and list hash.
 	 *
 	 * @param {string} pListHash - The list hash.
-	 * @returns {Array} - The retrieved list.
+	 * @param {Object} [pOptions={}] - (optional) Additional options for retrieving the list. (ex. search term)
+	 *
+	 * @returns {Array<PickListItem>} - The retrieved list.
 	 */
-	getList(pListHash)
+	getList(pListHash, pOptions = {})
 	{
+		if (this.listDefinitions[pListHash].Dynamic)
+		{
+			const tmpList = [];
+			const tmpTransactionGUID = this.pict.getUUID();
+			const tmpHash = tmpTransactionGUID.substring(0, 8);
+			const tmpAddress = `AppData._MetaLists.${tmpHash}`;
+			this.pict.manifest.setValueByHash(this.pict, tmpAddress, tmpList);
+			this.pict.TransactionTracking.registerTransaction(tmpTransactionGUID);
+			this.pict.views.PictFormMetacontroller.triggerGlobalInputEvent(`GetPickList:${pListHash}:${tmpAddress}:${JSON.stringify(pOptions)}`, tmpTransactionGUID);
+			this.pict.views.PictFormMetacontroller.finalizeTransaction(tmpTransactionGUID);
+			delete this.pict.AppData._MetaLists[tmpHash];
+			return tmpList;
+		}
 		if (pListHash in this.computedLists)
 		{
 			return this.computedLists[pListHash];

package/source/views/Pict-View-DynamicForm.js

@@ -902,6 +902,43 @@ class PictViewDynamicForm extends libPictViewClass
 		this.pict.providers.MetatemplateGenerator.rebuildCustomTemplate(this);
 	}
 
+	/**
+	 * Returns the index of a group within the sectionDefinition.Groups array that matches the provided hash.
+	 *
+	 * @param {string} pGroupHash - The hash value of the group to find.
+	 * @returns {number} The index of the group if found; otherwise, -1.
+	 */
+	getGroupIndexFromHash(pGroupHash)
+	{
+		for (let i = 0; i < this.sectionDefinition.Groups.length; i++)
+		{
+			if (this.sectionDefinition.Groups[i].Hash === pGroupHash)
+			{
+				return i;
+			}
+		}
+		this.log.warn(`PICT View Metatemplate Helper getGroupIndexByHash could not find group with hash [${pGroupHash}].`);
+		return -1;
+	}
+
+	/**
+	 * Get a group by its hash
+	 * @param {string} pGroupHash - The hash of the group to retrieve.
+	 * @returns {object|boolean} - The group object if found, or false if the group hash is not found.
+	 */
+	getGroupFromHash(pGroupHash)
+	{
+		for (let i = 0; i < this.sectionDefinition.Groups.length; i++)
+		{
+			if (this.sectionDefinition.Groups[i].Hash === pGroupHash)
+			{
+				return this.sectionDefinition.Groups[i];
+			}
+		}
+		this.log.warn(`PICT View Metatemplate Helper getGroupByHash could not find group with hash [${pGroupHash}].`);
+		return false;
+	}
+
 	/**
 	 * Retrieves a group from the PICT View Metatemplate Helper based on the provided group index.
 	 *

package/types/source/providers/Pict-Provider-MetaLists.d.ts

@@ -5,19 +5,30 @@ export = PictMetalist;
 declare class PictMetalist extends libPictProvider {
     /** @type {any} */
     options: any;
-    /** @type {import('pict')} */
-    pict: import("pict");
+    /** @type {import('pict') & { log: any, instantiateServiceProviderWithoutRegistration: (hash: String) => any, instantiateServiceProviderIfNotExists: (hash: string) => any, TransactionTracking: import('pict/types/source/services/Fable-Service-TransactionTracking') }} */
+    pict: import("pict") & {
+        log: any;
+        instantiateServiceProviderWithoutRegistration: (hash: string) => any;
+        instantiateServiceProviderIfNotExists: (hash: string) => any;
+        TransactionTracking: import("pict/types/source/services/Fable-Service-TransactionTracking");
+    };
     /** @type {import('pict')} */
     fable: import("pict");
     computedLists: {};
     listDefinitions: {};
+    /** @typedef {{ id: string, text: string }} PickListItem */
     /**
      * Retrieves a list based on the provided view hash and list hash.
      *
      * @param {string} pListHash - The list hash.
-     * @returns {Array} - The retrieved list.
+     * @param {Object} [pOptions={}] - (optional) Additional options for retrieving the list. (ex. search term)
+     *
+     * @returns {Array<PickListItem>} - The retrieved list.
      */
-    getList(pListHash: string): any[];
+    getList(pListHash: string, pOptions?: any): Array<{
+        id: string;
+        text: string;
+    }>;
     /**
      * Checks if a list exists in the Pict Provider MetaLists.
      *

package/types/source/providers/Pict-Provider-MetaLists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-MetaLists.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-MetaLists.js"],"names":[],"mappings":";AAaA;;GAEG;AACH;IAcE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IACT,6BAA6B;IAC7B,OADW,OAAO,MAAM,CAAC,CACf;IAQV,kBAAuB;IACvB,oBAAyB;IAG1B;;;;;OAKG;IACH,mBAHW,MAAM,SAUhB;IAED;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,OAAO,CAKnB;IAED;;;OAGG;IACH,iDAsBC;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAQhB;IAED;;;;OAIG;IACH,qCAwGC;CACD;;;;;AA9ND,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-MetaLists.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-MetaLists.js"],"names":[],"mappings":";AAaA;;GAEG;AACH;IAcE,kBAAkB;IAClB,SADW,GAAG,CACF;IACZ,6QAA6Q;IAC7Q,MADW,OAAO,MAAM,CAAC,GAAG;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,6CAA6C,EAAE,CAAC,IAAI,QAAQ,KAAK,GAAG,CAAC;QAAC,qCAAqC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;QAAC,mBAAmB,EAAE,OAAO,8DAA8D,CAAC,CAAA;KAAE,CAChQ;IACT,6BAA6B;IAC7B,OADW,OAAO,MAAM,CAAC,CACf;IAQV,kBAAuB;IACvB,oBAAyB;IAE1B,2DAA2D;IAE3D;;;;;;;OAOG;IACH,mBALW,MAAM,mBAGJ,KAAK;YARE,MAAM;cAAQ,MAAM;MAQR,CAsB/B;IAED;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,OAAO,CAKnB;IAED;;;OAGG;IACH,iDAsBC;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAQhB;IAED;;;;OAIG;IACH,qCAwGC;CACD;;;;;AA9OD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}

package/types/source/providers/Pict-Provider-MetatemplateGenerator.d.ts

@@ -9,7 +9,7 @@ declare class PictMetatemplateGenerator extends libPictProvider {
     /** @type {libPictViewDynamicForm} */
     dynamicInputView: libPictViewDynamicForm;
     baseTemplatePrefix: string;
-    onInitializeAsync(fCallback: any): any;
+    onInitializeAsync(fCallback: any): void;
     createOnDemandMetatemplateView(): void;
     /**
      * Retrieves the metatemplate template reference in raw format.

package/types/source/providers/Pict-Provider-MetatemplateGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Provider-MetatemplateGenerator.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-MetatemplateGenerator.js"],"names":[],"mappings":";AAkDA;;;GAGG;AACH;IAcE,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAIT,qCAAqC;IACrC,kBADW,sBAAsB,CACZ;IAErB,2BAAwC;IAGzC,uCAIC;IAED,uCAYC;IAED;;;;;;;OAOG;IACH,kEAJW,MAAM,2BACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;;;;OAOG;IACH,+DAJW,MAAM,oBACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;OAQG;IACH,6DALW,MAAM,cACN,MAAM,oBACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;;;;;;;;OAUG;IACH,oEAPW,MAAM,cACN,MAAM,oBACN,MAAM,eACN,MAAM,aACN,MAAM,GACJ,MAAM,CAqDlB;IAED;;;;;;;;OAQG;IACH,qEALW,MAAM,cACN,MAAM,oBACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;;;;OAMG;IACH,qDA2BC;IAED;;;;;;OAMG;IACH,wCA8BC;CACD;;;;;;AA3VD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}
+{"version":3,"file":"Pict-Provider-MetatemplateGenerator.d.ts","sourceRoot":"","sources":["../../../source/providers/Pict-Provider-MetatemplateGenerator.js"],"names":[],"mappings":";AAkDA;;;GAGG;AACH;IAcE,6BAA6B;IAC7B,MADW,OAAO,MAAM,CAAC,CAChB;IAIT,qCAAqC;IACrC,kBADW,sBAAsB,CACZ;IAErB,2BAAwC;IAGzC,wCAIC;IAED,uCAYC;IAED;;;;;;;OAOG;IACH,kEAJW,MAAM,2BACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;;;;OAOG;IACH,+DAJW,MAAM,oBACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;OAQG;IACH,6DALW,MAAM,cACN,MAAM,oBACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;;;;;;;;OAUG;IACH,oEAPW,MAAM,cACN,MAAM,oBACN,MAAM,eACN,MAAM,aACN,MAAM,GACJ,MAAM,CAqDlB;IAED;;;;;;;;OAQG;IACH,qEALW,MAAM,cACN,MAAM,oBACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;;;;OAMG;IACH,qDA2BC;IAED;;;;;;OAMG;IACH,wCA8BC;CACD;;;;;;AA3VD,kCAAkC;AAClC,6CADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS3B"}